From 79a54b27b63ccba413879ae7bb44f901c7e497c8 Mon Sep 17 00:00:00 2001
From: Eguzki Astiz Lezaun <eastizle@redhat.com>
Date: Mon, 7 Oct 2024 10:02:11 +0100
Subject: [PATCH] Removed 0.10.0 with mike 2.1.0

---
 0.10.0/404.html                               | 3326 --------
 0.10.0/CNAME                                  |    1 -
 0.10.0/api-quickstart/images/geosight.png     |  Bin 198806 -> 0 bytes
 0.10.0/api-quickstart/index.html              | 4367 -----------
 .../architectural-overview-v1/index.html      | 3938 ----------
 .../design/architectural-overview/index.html  | 3826 ----------
 .../docs/design/images/1000m-overview.png     |  Bin 146275 -> 0 bytes
 .../design/images/arch_observability_1.jpg    |  Bin 283941 -> 0 bytes
 .../design/images/arch_observability_2.jpg    |  Bin 285786 -> 0 bytes
 .../design/images/control-plane-overview.jpg  |  Bin 109055 -> 0 bytes
 .../design/images/data-plane-overview.jpg     |  Bin 245070 -> 0 bytes
 .../docs/design/images/gateway-placement.png  |  Bin 216658 -> 0 bytes
 .../images/high-level-multi-cluster.png       |  Bin 364810 -> 0 bytes
 .../docs/design/images/highest-level.jpg      |  Bin 72314 -> 0 bytes
 .../design/images/multi-cluster-layout.jpg    |  Bin 399046 -> 0 bytes
 .../docs/design/images/observability.png      |  Bin 53788 -> 0 bytes
 .../docs/design/images/ocm-integration.png    |  Bin 114401 -> 0 bytes
 .../docs/design/images/request-flow.png       |  Bin 374884 -> 0 bytes
 .../design/images/single-cluster-layout.jpg   |  Bin 376787 -> 0 bytes
 .../design/modular_installation/index.html    | 3456 ---------
 .../architecture/rfcs/0001-rlp-v2/index.html  | 5274 -------------
 .../0002-well-known-attributes/index.html     | 4059 ----------
 .../DNSRecordStructure/index.html             | 3595 ---------
 .../rfcs/0003-dns-policy/index.html           | 3570 ---------
 .../policy_status_1.png                       |  Bin 18956 -> 0 bytes
 .../policy_status_2.png                       |  Bin 27708 -> 0 bytes
 .../policy_status_3.png                       |  Bin 67663 -> 0 bytes
 .../policy_status_4.png                       |  Bin 76260 -> 0 bytes
 .../policy_status_5.png                       |  Bin 81655 -> 0 bytes
 .../rfcs/0004-policy-status/index.html        | 3596 ---------
 .../0005-single-cluster-dnspolicy/index.html  | 3624 ---------
 .../index.html                                | 3580 ---------
 .../rfcs/0007-policy-sync-v1/index.html       | 3526 ---------
 .../0008-kuadrant-release-process/index.html  | 3647 ---------
 .../example-a1.png                            |  Bin 270738 -> 0 bytes
 .../example-b1.png                            |  Bin 275553 -> 0 bytes
 .../example-b2.png                            |  Bin 272439 -> 0 bytes
 .../example-c1.png                            |  Bin 274404 -> 0 bytes
 .../example-d1.png                            |  Bin 276316 -> 0 bytes
 .../example-d2.png                            |  Bin 290482 -> 0 bytes
 .../example-e1.png                            |  Bin 287541 -> 0 bytes
 .../example-e2.png                            |  Bin 287550 -> 0 bytes
 .../example-e3.png                            |  Bin 334115 -> 0 bytes
 .../example-f1.png                            |  Bin 272470 -> 0 bytes
 .../example-f2.png                            |  Bin 276483 -> 0 bytes
 .../0009-defaults-and-overrides/index.html    | 4297 -----------
 .../index.html                                | 3532 ---------
 .../rfcs/0011-policy-machinery/index.html     | 3555 ---------
 .../rfcs/dns-policy-api-changes/index.html    | 3464 ---------
 .../images/architecture-multi-cluster.png     |  Bin 150505 -> 0 bytes
 .../images/architecture-single-cluster.png    |  Bin 76590 -> 0 bytes
 0.10.0/assets/images/cncf-color.png           |  Bin 24146 -> 0 bytes
 0.10.0/assets/images/deploy.png               |  Bin 91193 -> 0 bytes
 0.10.0/assets/images/favicon.png              |  Bin 658 -> 0 bytes
 0.10.0/assets/images/logo.png                 |  Bin 5690 -> 0 bytes
 .../assets/javascripts/bundle.bd41221c.min.js |   29 -
 .../javascripts/bundle.bd41221c.min.js.map    |    7 -
 .../javascripts/lunr/min/lunr.ar.min.js       |    1 -
 .../javascripts/lunr/min/lunr.da.min.js       |   18 -
 .../javascripts/lunr/min/lunr.de.min.js       |   18 -
 .../javascripts/lunr/min/lunr.du.min.js       |   18 -
 .../javascripts/lunr/min/lunr.el.min.js       |    1 -
 .../javascripts/lunr/min/lunr.es.min.js       |   18 -
 .../javascripts/lunr/min/lunr.fi.min.js       |   18 -
 .../javascripts/lunr/min/lunr.fr.min.js       |   18 -
 .../javascripts/lunr/min/lunr.he.min.js       |    1 -
 .../javascripts/lunr/min/lunr.hi.min.js       |    1 -
 .../javascripts/lunr/min/lunr.hu.min.js       |   18 -
 .../javascripts/lunr/min/lunr.hy.min.js       |    1 -
 .../javascripts/lunr/min/lunr.it.min.js       |   18 -
 .../javascripts/lunr/min/lunr.ja.min.js       |    1 -
 .../javascripts/lunr/min/lunr.jp.min.js       |    1 -
 .../javascripts/lunr/min/lunr.kn.min.js       |    1 -
 .../javascripts/lunr/min/lunr.ko.min.js       |    1 -
 .../javascripts/lunr/min/lunr.multi.min.js    |    1 -
 .../javascripts/lunr/min/lunr.nl.min.js       |   18 -
 .../javascripts/lunr/min/lunr.no.min.js       |   18 -
 .../javascripts/lunr/min/lunr.pt.min.js       |   18 -
 .../javascripts/lunr/min/lunr.ro.min.js       |   18 -
 .../javascripts/lunr/min/lunr.ru.min.js       |   18 -
 .../javascripts/lunr/min/lunr.sa.min.js       |    1 -
 .../lunr/min/lunr.stemmer.support.min.js      |    1 -
 .../javascripts/lunr/min/lunr.sv.min.js       |   18 -
 .../javascripts/lunr/min/lunr.ta.min.js       |    1 -
 .../javascripts/lunr/min/lunr.te.min.js       |    1 -
 .../javascripts/lunr/min/lunr.th.min.js       |    1 -
 .../javascripts/lunr/min/lunr.tr.min.js       |   18 -
 .../javascripts/lunr/min/lunr.vi.min.js       |    1 -
 .../javascripts/lunr/min/lunr.zh.min.js       |    1 -
 0.10.0/assets/javascripts/lunr/tinyseg.js     |  206 -
 0.10.0/assets/javascripts/lunr/wordcut.js     | 6708 -----------------
 .../workers/search.b8dbb3d2.min.js            |   42 -
 .../workers/search.b8dbb3d2.min.js.map        |    7 -
 0.10.0/assets/stylesheets/extra.css           |   32 -
 .../assets/stylesheets/main.10ba22f1.min.css  |    1 -
 .../stylesheets/main.10ba22f1.min.css.map     |    1 -
 .../stylesheets/palette.06af60db.min.css      |    1 -
 .../stylesheets/palette.06af60db.min.css.map  |    1 -
 0.10.0/authorino-operator/index.html          | 4439 -----------
 0.10.0/authorino/docs/architecture.gif        |  Bin 439345 -> 0 bytes
 0.10.0/authorino/docs/architecture/index.html | 4203 -----------
 0.10.0/authorino/docs/auth-pipeline.gif       |  Bin 568634 -> 0 bytes
 .../authorino/docs/code_of_conduct/index.html | 3377 ---------
 0.10.0/authorino/docs/contributing/index.html | 3913 ----------
 0.10.0/authorino/docs/features/index.html     | 5241 -------------
 .../authorino/docs/getting-started/index.html | 4034 ----------
 0.10.0/authorino/docs/index.html              | 3426 ---------
 0.10.0/authorino/docs/terminology/index.html  | 3478 ---------
 .../user-guides/anonymous-access/index.html   | 3692 ---------
 .../api-key-authentication/index.html         | 3757 ---------
 .../index.html                                | 3793 ----------
 .../docs/user-guides/authzed/index.html       | 3930 ----------
 .../docs/user-guides/caching/index.html       | 3769 ---------
 .../deny-with-redirect-to-login/index.html    | 3913 ----------
 .../index.html                                | 4061 ----------
 .../envoy-jwt-authn-and-authorino/index.html  | 4040 ----------
 .../user-guides/external-metadata/index.html  | 3773 ---------
 .../docs/user-guides/hello-world/index.html   | 3788 ----------
 .../docs/user-guides/host-override/index.html | 3574 ---------
 .../http-basic-authentication/index.html      | 3802 ----------
 .../keycloak-authorization-services-1.png     |  Bin 265966 -> 0 bytes
 .../keycloak-authorization-services-2.png     |  Bin 257670 -> 0 bytes
 .../keycloak-authorization-services-3.png     |  Bin 278584 -> 0 bytes
 0.10.0/authorino/docs/user-guides/index.html  | 3476 ---------
 .../user-guides/injecting-data/index.html     | 3762 ---------
 .../index.html                                | 3796 ----------
 .../index.html                                | 3784 ----------
 .../kubernetes-subjectaccessreview/index.html | 3884 ----------
 .../kubernetes-tokenreview/index.html         | 3824 ----------
 .../mtls-authentication/index.html            | 4007 ----------
 .../oauth2-token-introspection/index.html     | 3867 ----------
 .../docs/user-guides/observability/index.html | 5440 -------------
 .../oidc-jwt-authentication/index.html        | 3730 ---------
 .../docs/user-guides/oidc-rbac/index.html     | 3857 ----------
 .../user-guides/oidc-user-info/index.html     | 3743 ---------
 .../user-guides/opa-authorization/index.html  | 3768 ---------
 .../passing-credentials/index.html            | 3811 ----------
 .../index.html                                | 3880 ----------
 .../docs/user-guides/sharding/index.html      | 3789 ----------
 .../token-normalization/index.html            | 3851 ----------
 .../user-guides/validating-webhook/index.html | 4161 ----------
 0.10.0/authorino/index.html                   | 3969 ----------
 .../authorino.kuadrant.io_authconfigs.yaml    | 4488 -----------
 .../authorino/install/crd/kustomization.yaml  |   18 -
 .../crd/patches/oneof_in_authconfigs.yaml     |  415 -
 .../crd/patches/webhook_in_authconfigs.yaml   |   20 -
 .../kuadrant.io_v1alpha1_dnsrecord.yaml       |   20 -
 .../config/samples/kustomization.yaml         |    4 -
 0.10.0/dns-operator/docs/RELEASE/index.html   | 3517 ---------
 .../dnsrecord-lifecycle/index.html            | 3389 ---------
 0.10.0/dns-operator/docs/provider/index.html  | 3617 ---------
 .../docs/reference/dnsrecord/index.html       | 3674 ---------
 0.10.0/dns-operator/index.html                | 3697 ---------
 .../getting-started-multi-cluster/index.html  | 3571 ---------
 .../getting-started-single-cluster/index.html | 3742 ---------
 0.10.0/index.html                             | 3432 ---------
 .../samples/kuadrant_v1alpha1_dnspolicy.yaml  |   13 -
 .../samples/kuadrant_v1alpha1_tlspolicy.yaml  |   14 -
 .../samples/kuadrant_v1beta1_kuadrant.yaml    |    6 -
 .../samples/kuadrant_v1beta2_authpolicy.yaml  |   18 -
 .../kuadrant_v1beta2_ratelimitpolicy.yaml     |   16 -
 .../config/samples/kustomization.yaml         |    8 -
 0.10.0/kuadrant-operator/doc/auth/index.html  | 4210 -----------
 .../doc/development/index.html                | 4060 ----------
 0.10.0/kuadrant-operator/doc/dns/index.html   | 3940 ----------
 .../doc/dnshealthchecks/index.html            | 3580 ---------
 .../doc/images/kuadrant-architecture.svg      |    1 -
 .../doc/install/install-kubernetes/index.html | 3703 ---------
 .../doc/install/install-openshift/index.html  | 3980 ----------
 .../kuadrant-operator/doc/logging/index.html  | 3391 ---------
 .../doc/observability/examples/index.html     | 3551 ---------
 .../doc/observability/grafana_trace.png       |  Bin 222423 -> 0 bytes
 .../observability/grafana_tracing_loki.png    |  Bin 131715 -> 0 bytes
 .../doc/observability/metrics/index.html      | 3622 ---------
 .../doc/observability/tracing/index.html      | 3629 ---------
 .../images/authpolicy-control-structure.png   |  Bin 60035 -> 0 bytes
 .../rlp-target-gateway-resource/index.html    | 3793 ----------
 .../doc/rate-limiting/index.html              | 4255 -----------
 .../doc/reference/authpolicy/index.html       | 4343 -----------
 .../doc/reference/dnspolicy/index.html        | 3913 ----------
 .../doc/reference/kuadrant/index.html         | 3442 ---------
 .../doc/reference/ratelimitpolicy/index.html  | 3859 ----------
 .../doc/reference/route-selectors/index.html  | 3473 ---------
 .../doc/reference/tlspolicy/index.html        | 3582 ---------
 0.10.0/kuadrant-operator/doc/tls/index.html   | 3637 ---------
 .../index.html                                | 3803 ----------
 .../index.html                                | 3749 ---------
 .../index.html                                | 4054 ----------
 .../doc/user-guides/gateway-dns/index.html    | 3721 ---------
 .../index.html                                | 3715 ---------
 .../doc/user-guides/gateway-tls/index.html    | 3762 ---------
 .../index.html                                | 4602 -----------
 .../secure-protect-connect/index.html         | 3968 ----------
 .../simple-rl-for-app-developers/index.html   | 3541 ---------
 .../examples/alerts/index.html                | 3492 ---------
 .../examples/alerts/kustomization.yaml        |    7 -
 .../prometheusrules_policies_missing.yaml     |   57 -
 .../examples/alerts/slo-availability.yaml     |  212 -
 .../examples/alerts/slo-latency.yaml          |  212 -
 .../alerts/sloth/slo-availability.yaml        |   31 -
 .../examples/alerts/sloth/slo-latency.yaml    |   34 -
 .../alerts/tests/slo-availability-test.yaml   |   47 -
 .../alerts/tests/slo-latency-test.yaml        |   47 -
 .../examples/dashboards/app_developer.json    | 1693 -----
 .../examples/dashboards/business_user.json    |  768 --
 .../controller-resources-metrics.json         |  339 -
 .../controller-runtime-metrics.json           |  776 --
 .../examples/dashboards/kustomization.yaml    |   28 -
 .../dashboards/platform_engineer.json         | 2616 -------
 .../examples/dnspolicy/application.yaml       |   50 -
 .../dnspolicy/aws-dns-provider-secret.yaml    |   10 -
 .../dnspolicy/dnspolicy-bad-strategy.yaml     |   13 -
 .../dnspolicy/dnspolicy-healthchecks.yaml     |   23 -
 .../examples/dnspolicy/dnspolicy.yaml         |   18 -
 .../examples/dnspolicy/gateway.yaml           |   20 -
 .../examples/dnspolicy/script.sh              |   27 -
 .../kuadrant-operator/examples/metal-lb.yaml  |   14 -
 .../examples/oas-apikey.yaml                  |   48 -
 .../kuadrant-operator/examples/oas-oidc.yaml  |   55 -
 .../examples/toystore/admin-key-secret.yaml   |   15 -
 .../toystore/alice-api-key-secret.yaml        |   14 -
 .../examples/toystore/authpolicy.yaml         |   56 -
 .../toystore/authpolicy_jwt-k8s-authnz.yaml   |   44 -
 .../examples/toystore/bob-api-key-secret.yaml |   14 -
 .../examples/toystore/httproute.yaml          |   29 -
 .../examples/toystore/kuadrant.yaml           |    6 -
 .../toystore/ratelimitpolicy_gateway.yaml     |   30 -
 .../toystore/ratelimitpolicy_httproute.yaml   |   50 -
 .../examples/toystore/toystore.yaml           |   39 -
 0.10.0/kuadrant-operator/index.html           | 3977 ----------
 0.10.0/kuadrantctl/doc/RELEASE/index.html     | 3452 ---------
 0.10.0/kuadrantctl/doc/development/index.html | 3415 ---------
 .../generate-gateway-api-httproute/index.html | 3509 ---------
 .../generate-kuadrant-auth-policy/index.html  | 3997 ----------
 .../index.html                                | 3686 ---------
 .../apicurio-security-scheme-apikey.png       |  Bin 9423 -> 0 bytes
 ...io-vendor-extension-backend-rate-limit.png |  Bin 40320 -> 0 bytes
 .../doc/kuadrantctl-ci-cd/index.html          | 3775 ----------
 .../doc/openapi-apicurio/index.html           | 3645 ---------
 .../openapi-kuadrant-extensions/index.html    | 3460 ---------
 .../openapi-openshift-dev-spaces/index.html   | 4085 ----------
 0.10.0/kuadrantctl/index.html                 | 4049 ----------
 .../doc/development/index.html                | 3945 ----------
 .../limitador-operator/doc/logging/index.html | 3393 ---------
 .../doc/rate-limit-headers/index.html         | 3395 ---------
 .../doc/resource-requirements/index.html      | 3464 ---------
 .../limitador-operator/doc/storage/index.html | 3770 ---------
 .../limitador-operator/doc/tracing/index.html | 3383 ---------
 0.10.0/limitador-operator/index.html          | 3583 ---------
 0.10.0/limitador/LICENSE                      |  201 -
 0.10.0/limitador/doc/how-it-works/index.html  | 3502 ---------
 .../doc/migrations/conditions/index.html      | 3447 ---------
 .../doc/server/configuration/index.html       | 3916 ----------
 0.10.0/limitador/doc/topologies/index.html    | 3571 ---------
 0.10.0/limitador/index.html                   | 3643 ---------
 .../docs/http_server_spec.json                |  305 -
 0.10.0/limitador/limitador-server/index.html  | 3501 ---------
 .../kubernetes/centos-pod.yaml                |   15 -
 .../limitador-server/kubernetes/index.html    | 3830 ----------
 .../kubernetes/kuard-deployment.yaml          |   42 -
 .../kuard-envoy-config-configmap.yaml         |   84 -
 ...y-sidecar-metrics-dashboard-screenshot.png |  Bin 80203 -> 0 bytes
 .../kubernetes/kuard-podmonitor.yaml          |   15 -
 .../kubernetes/kuard-service.yaml             |   16 -
 .../limitador-config-configmap.yaml           |   16 -
 .../kubernetes/limitador-deployment.yaml      |   62 -
 .../limitador-grafanadashboard.json           | 2154 ------
 ...limitador-metrics-dashboard-screenshot.png |  Bin 70285 -> 0 bytes
 .../kubernetes/limitador-podmonitor.yaml      |   15 -
 .../kubernetes/limitador-service.yaml         |   20 -
 .../limitador-server/kubernetes/ratelimit.svg |    1 -
 .../kubernetes/redis-service.yaml             |   13 -
 .../kubernetes/redis-statefulset.yaml         |   55 -
 .../limitador-server/sandbox/Makefile         |  126 -
 .../sandbox/docker-compose-envoy-3-node.yaml  |   74 -
 .../sandbox/docker-compose-envoy.yaml         |   28 -
 .../docker-compose-limitador-disk.yaml        |   31 -
 ...-compose-limitador-distributed-3-node.yaml |   58 -
 .../docker-compose-limitador-distributed.yaml |   24 -
 .../docker-compose-limitador-memory.yaml      |   30 -
 ...docker-compose-limitador-redis-cached.yaml |   43 -
 .../docker-compose-limitador-redis-otel.yaml  |   47 -
 .../docker-compose-limitador-redis-tls.yaml   |   45 -
 .../docker-compose-limitador-redis.yaml       |   35 -
 .../limitador-server/sandbox/envoy.yaml       |   84 -
 .../limitador-server/sandbox/envoy2.yaml      |   84 -
 .../limitador-server/sandbox/envoy3.yaml      |   84 -
 .../limitador-server/sandbox/index.html       | 3801 ----------
 .../limitador-server/sandbox/limits.yaml      |   22 -
 .../limitador-server/sandbox/load-test.json   |   18 -
 .../sandbox/loadtest/Cargo.lock               | 1874 -----
 .../sandbox/loadtest/Cargo.toml               |   10 -
 .../sandbox/loadtest/src/main.rs              |   26 -
 .../sandbox/redis-otel/index.html             | 3437 ---------
 .../sandbox/redis-tls/index.html              | 3381 ---------
 .../sandbox/redis-tls/redis-config.conf       |    7 -
 0.10.0/limitador/limitador/index.html         | 3443 ---------
 0.10.0/search/search_index.json               |    1 -
 0.10.0/sitemap.xml                            |  613 --
 0.10.0/sitemap.xml.gz                         |  Bin 1525 -> 0 bytes
 versions.json                                 |    5 -
 301 files changed, 491287 deletions(-)
 delete mode 100644 0.10.0/404.html
 delete mode 100644 0.10.0/CNAME
 delete mode 100644 0.10.0/api-quickstart/images/geosight.png
 delete mode 100644 0.10.0/api-quickstart/index.html
 delete mode 100644 0.10.0/architecture/docs/design/architectural-overview-v1/index.html
 delete mode 100644 0.10.0/architecture/docs/design/architectural-overview/index.html
 delete mode 100644 0.10.0/architecture/docs/design/images/1000m-overview.png
 delete mode 100644 0.10.0/architecture/docs/design/images/arch_observability_1.jpg
 delete mode 100644 0.10.0/architecture/docs/design/images/arch_observability_2.jpg
 delete mode 100644 0.10.0/architecture/docs/design/images/control-plane-overview.jpg
 delete mode 100644 0.10.0/architecture/docs/design/images/data-plane-overview.jpg
 delete mode 100644 0.10.0/architecture/docs/design/images/gateway-placement.png
 delete mode 100644 0.10.0/architecture/docs/design/images/high-level-multi-cluster.png
 delete mode 100644 0.10.0/architecture/docs/design/images/highest-level.jpg
 delete mode 100644 0.10.0/architecture/docs/design/images/multi-cluster-layout.jpg
 delete mode 100644 0.10.0/architecture/docs/design/images/observability.png
 delete mode 100644 0.10.0/architecture/docs/design/images/ocm-integration.png
 delete mode 100644 0.10.0/architecture/docs/design/images/request-flow.png
 delete mode 100644 0.10.0/architecture/docs/design/images/single-cluster-layout.jpg
 delete mode 100644 0.10.0/architecture/docs/design/modular_installation/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0001-rlp-v2/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0002-well-known-attributes/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0003-dns-policy/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_1.png
 delete mode 100644 0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_2.png
 delete mode 100644 0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_3.png
 delete mode 100644 0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_4.png
 delete mode 100644 0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_5.png
 delete mode 100644 0.10.0/architecture/rfcs/0004-policy-status/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0005-single-cluster-dnspolicy/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0006-kuadrant_sub_components_configurations/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0007-policy-sync-v1/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0008-kuadrant-release-process/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-a1.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-b1.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-b2.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-c1.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-d1.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-d2.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e1.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e2.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e3.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-f1.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-f2.png
 delete mode 100644 0.10.0/architecture/rfcs/0009-defaults-and-overrides/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0010-gateway-api-metrics-exporter/index.html
 delete mode 100644 0.10.0/architecture/rfcs/0011-policy-machinery/index.html
 delete mode 100644 0.10.0/architecture/rfcs/dns-policy-api-changes/index.html
 delete mode 100644 0.10.0/assets/images/architecture-multi-cluster.png
 delete mode 100644 0.10.0/assets/images/architecture-single-cluster.png
 delete mode 100644 0.10.0/assets/images/cncf-color.png
 delete mode 100644 0.10.0/assets/images/deploy.png
 delete mode 100644 0.10.0/assets/images/favicon.png
 delete mode 100644 0.10.0/assets/images/logo.png
 delete mode 100644 0.10.0/assets/javascripts/bundle.bd41221c.min.js
 delete mode 100644 0.10.0/assets/javascripts/bundle.bd41221c.min.js.map
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.ar.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.da.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.de.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.du.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.el.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.es.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.fi.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.fr.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.he.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.hi.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.hu.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.hy.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.it.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.ja.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.jp.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.kn.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.ko.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.multi.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.nl.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.no.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.pt.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.ro.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.ru.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.sa.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.stemmer.support.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.sv.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.ta.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.te.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.th.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.tr.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.vi.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/min/lunr.zh.min.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/tinyseg.js
 delete mode 100644 0.10.0/assets/javascripts/lunr/wordcut.js
 delete mode 100644 0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js
 delete mode 100644 0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js.map
 delete mode 100644 0.10.0/assets/stylesheets/extra.css
 delete mode 100644 0.10.0/assets/stylesheets/main.10ba22f1.min.css
 delete mode 100644 0.10.0/assets/stylesheets/main.10ba22f1.min.css.map
 delete mode 100644 0.10.0/assets/stylesheets/palette.06af60db.min.css
 delete mode 100644 0.10.0/assets/stylesheets/palette.06af60db.min.css.map
 delete mode 100644 0.10.0/authorino-operator/index.html
 delete mode 100644 0.10.0/authorino/docs/architecture.gif
 delete mode 100644 0.10.0/authorino/docs/architecture/index.html
 delete mode 100644 0.10.0/authorino/docs/auth-pipeline.gif
 delete mode 100644 0.10.0/authorino/docs/code_of_conduct/index.html
 delete mode 100644 0.10.0/authorino/docs/contributing/index.html
 delete mode 100644 0.10.0/authorino/docs/features/index.html
 delete mode 100644 0.10.0/authorino/docs/getting-started/index.html
 delete mode 100644 0.10.0/authorino/docs/index.html
 delete mode 100644 0.10.0/authorino/docs/terminology/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/anonymous-access/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/api-key-authentication/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/authzed/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/caching/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/deny-with-redirect-to-login/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/envoy-jwt-authn-and-authorino/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/external-metadata/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/hello-world/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/host-override/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/http-basic-authentication/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-1.png
 delete mode 100644 0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-2.png
 delete mode 100644 0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-3.png
 delete mode 100644 0.10.0/authorino/docs/user-guides/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/injecting-data/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/json-pattern-matching-authorization/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/keycloak-authorization-services/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/kubernetes-subjectaccessreview/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/kubernetes-tokenreview/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/mtls-authentication/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/oauth2-token-introspection/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/observability/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/oidc-jwt-authentication/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/oidc-rbac/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/oidc-user-info/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/opa-authorization/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/passing-credentials/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/resource-level-authorization-uma/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/sharding/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/token-normalization/index.html
 delete mode 100644 0.10.0/authorino/docs/user-guides/validating-webhook/index.html
 delete mode 100644 0.10.0/authorino/index.html
 delete mode 100644 0.10.0/authorino/install/crd/authorino.kuadrant.io_authconfigs.yaml
 delete mode 100644 0.10.0/authorino/install/crd/kustomization.yaml
 delete mode 100644 0.10.0/authorino/install/crd/patches/oneof_in_authconfigs.yaml
 delete mode 100644 0.10.0/authorino/install/crd/patches/webhook_in_authconfigs.yaml
 delete mode 100644 0.10.0/dns-operator/config/samples/kuadrant.io_v1alpha1_dnsrecord.yaml
 delete mode 100644 0.10.0/dns-operator/config/samples/kustomization.yaml
 delete mode 100644 0.10.0/dns-operator/docs/RELEASE/index.html
 delete mode 100644 0.10.0/dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/index.html
 delete mode 100644 0.10.0/dns-operator/docs/provider/index.html
 delete mode 100644 0.10.0/dns-operator/docs/reference/dnsrecord/index.html
 delete mode 100644 0.10.0/dns-operator/index.html
 delete mode 100644 0.10.0/getting-started-multi-cluster/index.html
 delete mode 100644 0.10.0/getting-started-single-cluster/index.html
 delete mode 100644 0.10.0/index.html
 delete mode 100644 0.10.0/kuadrant-operator/config/samples/kuadrant_v1alpha1_dnspolicy.yaml
 delete mode 100644 0.10.0/kuadrant-operator/config/samples/kuadrant_v1alpha1_tlspolicy.yaml
 delete mode 100644 0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta1_kuadrant.yaml
 delete mode 100644 0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta2_authpolicy.yaml
 delete mode 100644 0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta2_ratelimitpolicy.yaml
 delete mode 100644 0.10.0/kuadrant-operator/config/samples/kustomization.yaml
 delete mode 100644 0.10.0/kuadrant-operator/doc/auth/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/development/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/dns/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/dnshealthchecks/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/images/kuadrant-architecture.svg
 delete mode 100644 0.10.0/kuadrant-operator/doc/install/install-kubernetes/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/install/install-openshift/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/logging/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/observability/examples/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/observability/grafana_trace.png
 delete mode 100644 0.10.0/kuadrant-operator/doc/observability/grafana_tracing_loki.png
 delete mode 100644 0.10.0/kuadrant-operator/doc/observability/metrics/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/observability/tracing/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/proposals/images/authpolicy-control-structure.png
 delete mode 100644 0.10.0/kuadrant-operator/doc/proposals/rlp-target-gateway-resource/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/rate-limiting/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/reference/authpolicy/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/reference/dnspolicy/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/reference/kuadrant/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/reference/ratelimitpolicy/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/reference/route-selectors/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/reference/tlspolicy/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/tls/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/gateway-dns/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/gateway-tls/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect/index.html
 delete mode 100644 0.10.0/kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/index.html
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/index.html
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/kustomization.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/prometheusrules_policies_missing.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/slo-availability.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/slo-latency.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/sloth/slo-availability.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/sloth/slo-latency.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/tests/slo-availability-test.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/alerts/tests/slo-latency-test.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/dashboards/app_developer.json
 delete mode 100644 0.10.0/kuadrant-operator/examples/dashboards/business_user.json
 delete mode 100644 0.10.0/kuadrant-operator/examples/dashboards/controller-resources-metrics.json
 delete mode 100644 0.10.0/kuadrant-operator/examples/dashboards/controller-runtime-metrics.json
 delete mode 100644 0.10.0/kuadrant-operator/examples/dashboards/kustomization.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/dashboards/platform_engineer.json
 delete mode 100644 0.10.0/kuadrant-operator/examples/dnspolicy/application.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/dnspolicy/aws-dns-provider-secret.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy-bad-strategy.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy-healthchecks.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/dnspolicy/gateway.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/dnspolicy/script.sh
 delete mode 100644 0.10.0/kuadrant-operator/examples/metal-lb.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/oas-apikey.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/oas-oidc.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/admin-key-secret.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/alice-api-key-secret.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/authpolicy.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/authpolicy_jwt-k8s-authnz.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/bob-api-key-secret.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/httproute.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/kuadrant.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/ratelimitpolicy_gateway.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/ratelimitpolicy_httproute.yaml
 delete mode 100644 0.10.0/kuadrant-operator/examples/toystore/toystore.yaml
 delete mode 100644 0.10.0/kuadrant-operator/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/RELEASE/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/development/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/generate-gateway-api-httproute/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/generate-kuadrant-auth-policy/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/generate-kuadrant-rate-limit-policy/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/images/apicurio-security-scheme-apikey.png
 delete mode 100644 0.10.0/kuadrantctl/doc/images/apicurio-vendor-extension-backend-rate-limit.png
 delete mode 100644 0.10.0/kuadrantctl/doc/kuadrantctl-ci-cd/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/openapi-apicurio/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/openapi-kuadrant-extensions/index.html
 delete mode 100644 0.10.0/kuadrantctl/doc/openapi-openshift-dev-spaces/index.html
 delete mode 100644 0.10.0/kuadrantctl/index.html
 delete mode 100644 0.10.0/limitador-operator/doc/development/index.html
 delete mode 100644 0.10.0/limitador-operator/doc/logging/index.html
 delete mode 100644 0.10.0/limitador-operator/doc/rate-limit-headers/index.html
 delete mode 100644 0.10.0/limitador-operator/doc/resource-requirements/index.html
 delete mode 100644 0.10.0/limitador-operator/doc/storage/index.html
 delete mode 100644 0.10.0/limitador-operator/doc/tracing/index.html
 delete mode 100644 0.10.0/limitador-operator/index.html
 delete mode 100644 0.10.0/limitador/LICENSE
 delete mode 100644 0.10.0/limitador/doc/how-it-works/index.html
 delete mode 100644 0.10.0/limitador/doc/migrations/conditions/index.html
 delete mode 100644 0.10.0/limitador/doc/server/configuration/index.html
 delete mode 100644 0.10.0/limitador/doc/topologies/index.html
 delete mode 100644 0.10.0/limitador/index.html
 delete mode 100644 0.10.0/limitador/limitador-server/docs/http_server_spec.json
 delete mode 100644 0.10.0/limitador/limitador-server/index.html
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/centos-pod.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/index.html
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/kuard-deployment.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/kuard-envoy-config-configmap.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/kuard-envoyproxy-sidecar-metrics-dashboard-screenshot.png
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/kuard-podmonitor.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/kuard-service.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/limitador-config-configmap.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/limitador-deployment.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/limitador-grafanadashboard.json
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/limitador-metrics-dashboard-screenshot.png
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/limitador-podmonitor.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/limitador-service.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/ratelimit.svg
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/redis-service.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/kubernetes/redis-statefulset.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/Makefile
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-envoy-3-node.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-envoy.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-disk.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-distributed-3-node.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-distributed.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-memory.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-cached.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-otel.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-tls.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/envoy.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/envoy2.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/envoy3.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/index.html
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/limits.yaml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/load-test.json
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/loadtest/Cargo.lock
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/loadtest/Cargo.toml
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/loadtest/src/main.rs
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/redis-otel/index.html
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/redis-tls/index.html
 delete mode 100644 0.10.0/limitador/limitador-server/sandbox/redis-tls/redis-config.conf
 delete mode 100644 0.10.0/limitador/limitador/index.html
 delete mode 100644 0.10.0/search/search_index.json
 delete mode 100644 0.10.0/sitemap.xml
 delete mode 100644 0.10.0/sitemap.xml.gz

diff --git a/0.10.0/404.html b/0.10.0/404.html
deleted file mode 100644
index e81035406..000000000
--- a/0.10.0/404.html
+++ /dev/null
@@ -1,3326 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-      
-      
-      
-      <link rel="icon" href="/0.10.0/assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="/0.10.0/assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="/0.10.0/assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("/0.10.0",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="..//0.10.0"> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="/0.10.0/." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="/0.10.0/assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="/0.10.0/." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="/0.10.0/assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/0.10.0/kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-  <h1>404 - Not found</h1>
-
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="/0.10.0/assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "/0.10.0", "features": ["content.action.edit", "content.code.copy"], "search": "/0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="/0.10.0/assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/CNAME b/0.10.0/CNAME
deleted file mode 100644
index bdec7cbae..000000000
--- a/0.10.0/CNAME
+++ /dev/null
@@ -1 +0,0 @@
-docs.kuadrant.io
\ No newline at end of file
diff --git a/0.10.0/api-quickstart/images/geosight.png b/0.10.0/api-quickstart/images/geosight.png
deleted file mode 100644
index b069b4fe419aefd1f7679069388fac0b033242b1..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 198806
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%0DUh(HcEnkC0I8eMxWM6Z$ER)2@Egvtk^k
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

diff --git a/0.10.0/api-quickstart/index.html b/0.10.0/api-quickstart/index.html
deleted file mode 100644
index 4dfcaad1f..000000000
--- a/0.10.0/api-quickstart/index.html
+++ /dev/null
@@ -1,4367 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/api-quickstart/">
-      
-      
-        <link rel="prev" href="../authorino/docs/user-guides/observability/">
-      
-      
-        <link rel="next" href="../architecture/rfcs/0001-rlp-v2/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>API Quickstart - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#api-quickstart" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              API Quickstart
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#introduction" class="md-nav__link">
-    <span class="md-ellipsis">
-      Introduction
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#pre-requisities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pre-requisities
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#platform-engineer-platform-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Platform engineer) Platform Setup
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="(Platform engineer) Platform Setup">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#verify-the-gateway-and-configuration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Verify the Gateway and configuration
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#guard-rails-constraint-warnings-about-missing-policies-dns-tls" class="md-nav__link">
-    <span class="md-ellipsis">
-      Guard Rails: Constraint warnings about missing policies ( DNS, TLS)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#grafana-dashboard-view" class="md-nav__link">
-    <span class="md-ellipsis">
-      Grafana dashboard view
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-the-missing-dnspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create the missing DNSPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#platform-overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Platform Overview
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#application-developer-app-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Application developer) App setup
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="(Application developer) App setup">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-design" class="md-nav__link">
-    <span class="md-ellipsis">
-      API Design
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="API Design">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#route-53-dns-zone" class="md-nav__link">
-    <span class="md-ellipsis">
-      Route 53 DNS Zone
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#configuring-the-region-label" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configuring the region label
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#exploring-the-open-api-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      Exploring the Open API Specification
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#application-developer-api-security" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Application developer) API security
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="(Application developer) API security">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrantctl" class="md-nav__link">
-    <span class="md-ellipsis">
-      kuadrantctl
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#installing-kuadrantctl" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing kuadrantctl
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generating-kuadrant-resources-with-kuadrantctl" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generating Kuadrant resources with kuadrantctl
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#check-our-applied-policies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Check our applied policies
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Check our applied policies">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#policy-adjustments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Policy Adjustments
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#application-developer-scaling-the-application" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Application developer) Scaling the application
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#platform-engineer-scaling-the-gateway-and-traffic-management" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Platform engineer) Scaling the gateway and traffic management
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#api-consumer-accessing-the-api-from-multiple-regions" class="md-nav__link">
-    <span class="md-ellipsis">
-      (API consumer) Accessing the API from multiple regions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="(API consumer) Accessing the API from multiple regions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#pre-requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pre-requisites
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#app-developer-api-traffic-monitoring" class="md-nav__link">
-    <span class="md-ellipsis">
-      (App developer) API traffic monitoring
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#platform-engineer-apis-summary-view" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Platform Engineer) APIs summary view
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#summary" class="md-nav__link">
-    <span class="md-ellipsis">
-      Summary
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#introduction" class="md-nav__link">
-    <span class="md-ellipsis">
-      Introduction
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#pre-requisities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pre-requisities
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#platform-engineer-platform-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Platform engineer) Platform Setup
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="(Platform engineer) Platform Setup">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#verify-the-gateway-and-configuration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Verify the Gateway and configuration
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#guard-rails-constraint-warnings-about-missing-policies-dns-tls" class="md-nav__link">
-    <span class="md-ellipsis">
-      Guard Rails: Constraint warnings about missing policies ( DNS, TLS)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#grafana-dashboard-view" class="md-nav__link">
-    <span class="md-ellipsis">
-      Grafana dashboard view
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-the-missing-dnspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create the missing DNSPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#platform-overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Platform Overview
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#application-developer-app-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Application developer) App setup
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="(Application developer) App setup">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-design" class="md-nav__link">
-    <span class="md-ellipsis">
-      API Design
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="API Design">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#route-53-dns-zone" class="md-nav__link">
-    <span class="md-ellipsis">
-      Route 53 DNS Zone
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#configuring-the-region-label" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configuring the region label
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#exploring-the-open-api-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      Exploring the Open API Specification
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#application-developer-api-security" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Application developer) API security
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="(Application developer) API security">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrantctl" class="md-nav__link">
-    <span class="md-ellipsis">
-      kuadrantctl
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#installing-kuadrantctl" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing kuadrantctl
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generating-kuadrant-resources-with-kuadrantctl" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generating Kuadrant resources with kuadrantctl
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#check-our-applied-policies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Check our applied policies
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Check our applied policies">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#policy-adjustments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Policy Adjustments
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#application-developer-scaling-the-application" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Application developer) Scaling the application
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#platform-engineer-scaling-the-gateway-and-traffic-management" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Platform engineer) Scaling the gateway and traffic management
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#api-consumer-accessing-the-api-from-multiple-regions" class="md-nav__link">
-    <span class="md-ellipsis">
-      (API consumer) Accessing the API from multiple regions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="(API consumer) Accessing the API from multiple regions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#pre-requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pre-requisites
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#app-developer-api-traffic-monitoring" class="md-nav__link">
-    <span class="md-ellipsis">
-      (App developer) API traffic monitoring
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#platform-engineer-apis-summary-view" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Platform Engineer) APIs summary view
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#summary" class="md-nav__link">
-    <span class="md-ellipsis">
-      Summary
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/api-quickstart/blob/main/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="api-quickstart">API Quickstart<a class="headerlink" href="#api-quickstart" title="Permanent link">&para;</a></h1>
-<h2 id="introduction">Introduction<a class="headerlink" href="#introduction" title="Permanent link">&para;</a></h2>
-<p>This document details how to setup a local reference architecture, and design and deploy an API. This will show the following API management features in a kube native environment using Kuadrant and other open source tools:</p>
-<ul>
-<li>API design</li>
-<li>API security and access control</li>
-<li>API monitoring</li>
-<li>Traffic management and scalability</li>
-</ul>
-<p>The sections in this document are grouped by the persona that is typically associated with the steps in that section. The 3 personas are:</p>
-<ul>
-<li>The <em>platform engineer</em>, who provides and maintains a platform for application developers,</li>
-<li>the <em>application developer</em>, who designs, builds and maintains applications and APIs,</li>
-<li>and the <em>api consumer</em>, who makes API calls to the API</li>
-</ul>
-<iframe width="100%" height="400" src="https://www.youtube.com/embed/vbWM8st5PjM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
-
-<h2 id="pre-requisities">Pre-requisities<a class="headerlink" href="#pre-requisities" title="Permanent link">&para;</a></h2>
-<ul>
-<li><code>docker</code>: https://www.docker.com/products/docker-desktop/</li>
-<li><code>kind</code>: https://kind.sigs.k8s.io/</li>
-<li><code>kubectl</code>: https://kubernetes.io/docs/reference/kubectl/</li>
-<li><code>kustomize</code>: https://kustomize.io/</li>
-<li><code>helm</code>: https://helm.sh/docs/intro/install/</li>
-<li><code>operator-sdk</code>: https://sdk.operatorframework.io/docs/installation/</li>
-<li>An <a href="https://aws.amazon.com/">AWS account</a> with a Secret Access Key and Access Key ID. You will also need to a <a href="https://docs.aws.amazon.com/route53/">Route 53</a> zone.</li>
-</ul>
-<h2 id="platform-engineer-platform-setup">(Platform engineer) Platform Setup<a class="headerlink" href="#platform-engineer-platform-setup" title="Permanent link">&para;</a></h2>
-<p>Export the following env vars:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">KUADRANT_AWS_ACCESS_KEY_ID</span><span class="o">=</span>&lt;key_id&gt;
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">KUADRANT_AWS_SECRET_ACCESS_KEY</span><span class="o">=</span>&lt;secret&gt;
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">KUADRANT_AWS_REGION</span><span class="o">=</span>&lt;region&gt;
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="nb">export</span><span class="w"> </span><span class="nv">KUADRANT_AWS_DNS_PUBLIC_ZONE_ID</span><span class="o">=</span>&lt;zone&gt;
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nb">export</span><span class="w"> </span><span class="nv">KUADRANT_ZONE_ROOT_DOMAIN</span><span class="o">=</span>&lt;domain&gt;
-</span></code></pre></div>
-<p>Clone the api-quickstart repo and run the quickstart script:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>git<span class="w"> </span>clone<span class="w"> </span>git@github.com:Kuadrant/api-quickstart.git<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>api-quickstart
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>./quickstart.sh
-</span></code></pre></div>
-<p>This will take several minutes as 3 local kind clusters are started and configured in a hub and spoke architecture.
-The following components will be installed on the clusters:</p>
-<ul>
-<li>Hub</li>
-<li><a href="https://open-cluster-management.io/">Open Cluster Management</a>, as a 'hub' cluster</li>
-<li><a href="https://docs.kuadrant.io/multicluster-gateway-controller/">Kuadrant Multi Cluster Gateway Controller</a>, for managing a Gateway in multiple clusters centrally</li>
-<li><a href="https://github.com/open-policy-agent/gatekeeper">Gatekeeper</a>, for constraints on Gateway Policy requirements</li>
-<li><a href="https://github.com/thanos-io/thanos">Thanos</a>, for receiving metrics centrally</li>
-<li><a href="https://github.com/grafana/grafana">Grafana</a>, for visualising API &amp; Gateway metrics</li>
-<li>Spoke x2</li>
-<li><a href="https://open-cluster-management.io/">Open Cluster Management</a>, as a 'spoke' cluster</li>
-<li><a href="https://docs.kuadrant.io/kuadrant-operator/">Kuadrant Operator</a>, for auth and rate limiting policies attached to a HTTPRoute</li>
-<li><a href="https://istio.io/latest/docs/">Istio</a>, with the Gateway API CRDs as the Gateway for ingress trafic</li>
-<li><a href="https://metallb.universe.tf/">MetalLB</a>, for exposing the Gateway service on the local network</li>
-<li><a href="https://prometheus.io/">Prometheus</a>, for scraping and federating metrics to the hub</li>
-</ul>
-<h3 id="verify-the-gateway-and-configuration">Verify the Gateway and configuration<a class="headerlink" href="#verify-the-gateway-and-configuration" title="Permanent link">&para;</a></h3>
-<p>View the ManagedZone, Gateway and TLSPolicy. The ManagedZone and TLSPolicy should have a Ready status of true. The Gateway should have a Programmed status of True.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-control-plane<span class="w"> </span>get<span class="w"> </span>managedzone,tlspolicy,gateway<span class="w"> </span>-n<span class="w"> </span>multi-cluster-gateways
-</span></code></pre></div>
-<h3 id="guard-rails-constraint-warnings-about-missing-policies-dns-tls">Guard Rails: Constraint warnings about missing policies ( DNS, TLS)<a class="headerlink" href="#guard-rails-constraint-warnings-about-missing-policies-dns-tls" title="Permanent link">&para;</a></h3>
-<p>Running the quick start script above will bring up <a href="https://open-policy-agent.github.io/gatekeeper/website/docs">Gatekeeper</a> and the following constraints: </p>
-<ul>
-<li>Gateways must have a TLSPolicy targeting them</li>
-<li>Gateways must have a DNSPolicy targeting them</li>
-</ul>
-<p>To view the above constraints in kubernetes, run this command:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-control-plane<span class="w"> </span>get<span class="w"> </span>constraints
-</span></code></pre></div></p>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>Since a gateway has been created automatically, along with a <code>TLSPolicy</code>, the violation for a missing <code>DNSPolicy</code> will be active until one is created.</p>
-</div>
-<h3 id="grafana-dashboard-view">Grafana dashboard view<a class="headerlink" href="#grafana-dashboard-view" title="Permanent link">&para;</a></h3>
-<p>To get a top level view of the constraints in violation, the <code>Stitch: Platform Engineer Dashboard</code> can be used. This can be accessed by at <a href="https://grafana.172.31.0.2.nip.io">https://grafana.172.31.0.2.nip.io</a></p>
-<p>Grafana has a default username and password of <code>admin</code>.
-You can find the <code>Stitch: Platform Engineer Dashboard</code> dashboard in the <code>Default</code> folder.</p>
-<h3 id="create-the-missing-dnspolicy">Create the missing DNSPolicy<a class="headerlink" href="#create-the-missing-dnspolicy" title="Permanent link">&para;</a></h3>
-<p>Create a DNSPolicy that targets the Gateway with the following command:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-control-plane<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: kuadrant.io/v1alpha1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: DNSPolicy</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: prod-web</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">  namespace: multi-cluster-gateways</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">spec:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">  targetRef:</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">    name: prod-web</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">  loadBalancing:</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">    geo:</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="s">      defaultGeo: EU</span>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="platform-overview">Platform Overview<a class="headerlink" href="#platform-overview" title="Permanent link">&para;</a></h3>
-<p>Since we have created all the policies that Gatekeeper had the guardrails around, you should no longer see any constraints in violation. This can be seen back in the <code>Stitch: Platform Engineer Dashboard</code> in Grafana at <a href="https://grafana.172.31.0.2.nip.io">https://grafana.172.31.0.2.nip.io</a></p>
-<h2 id="application-developer-app-setup">(Application developer) App setup<a class="headerlink" href="#application-developer-app-setup" title="Permanent link">&para;</a></h2>
-<h3 id="api-design">API Design<a class="headerlink" href="#api-design" title="Permanent link">&para;</a></h3>
-<p><a href="https://github.com/Kuadrant/api-petstore/fork">Fork</a> and/or clone the Petstore App at https://github.com/Kuadrant/api-petstore</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>git<span class="w"> </span>clone<span class="w"> </span>git@github.com:kuadrant/api-petstore<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>api-petstore
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="c1"># Or if you forked the repository:</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="c1"># git clone git@github.com:&lt;your_github_username&gt;/api-petstore &amp;&amp; cd api-petstore</span>
-</span></code></pre></div>
-<p>Then deploy it to the first workload cluster:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kustomize<span class="w"> </span>build<span class="w"> </span>./resources/<span class="w"> </span><span class="p">|</span><span class="w"> </span>envsubst<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-1<span class="w"> </span>apply<span class="w"> </span>-f-
-</span></code></pre></div>
-<p>This will deploy:</p>
-<ul>
-<li>A <code>petstore</code> Namespace</li>
-<li>A <code>Secret</code>, containing a static API key that we'll use later for auth</li>
-<li>A <code>Service</code> and <code>Deployment</code> for our petstore app</li>
-<li>A Gateway API <code>HTTPRoute</code> for our petstore app</li>
-</ul>
-<h4 id="route-53-dns-zone">Route 53 DNS Zone<a class="headerlink" href="#route-53-dns-zone" title="Permanent link">&para;</a></h4>
-<p>When the DNS Policy has been created, and the previously created <code>HTTPRoute</code> has been attached, a DNS record custom resource will also be created in the cluster resulting in records being created in your AWS Route53. Navigate to Route53 and you should see some new records in the zone.</p>
-<h3 id="configuring-the-region-label">Configuring the region label<a class="headerlink" href="#configuring-the-region-label" title="Permanent link">&para;</a></h3>
-<p>Configure the app <code>REGION</code> to be <code>eu</code>:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-1<span class="w"> </span>apply<span class="w"> </span>-k<span class="w"> </span>./resources/eu-cluster/
-</span></code></pre></div>
-<h3 id="exploring-the-open-api-specification">Exploring the Open API Specification<a class="headerlink" href="#exploring-the-open-api-specification" title="Permanent link">&para;</a></h3>
-<p>The raw Open API spec can be found in the root of the repo:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>cat<span class="w"> </span>openapi.yaml
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># ---</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="c1"># openapi: 3.0.2</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="c1"># info:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="c1">#   title: Stitch API Petstore</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="c1">#   version: 1.0.18</span>
-</span></code></pre></div>
-<h2 id="application-developer-api-security">(Application developer) API security<a class="headerlink" href="#application-developer-api-security" title="Permanent link">&para;</a></h2>
-<p>We've included a number of sample <code>x-kuadrant</code> extensions in the OAS spec already:</p>
-<ul>
-<li>At the top-level of our spec, we've defined an <code>x-kuadrant</code> extension to detail the Gateway API Gateway associated with our app:</li>
-</ul>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="w">  </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">    </span><span class="nt">route</span><span class="p">:</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">      </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w">      </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w">        </span><span class="nt">deployment</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w">        </span><span class="nt">owner</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cferreir</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w">      </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore.$KUADRANT_ZONE_ROOT_DOMAIN</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="w">      </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-multi-cluster-gateways</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="w">        </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span></code></pre></div>
-<ul>
-<li>In <code>/user/login</code>, we have a Gateway API <code>backendRef</code> set and a <code>rate_limit</code> set. The rate limit policy for this endpoint restricts usage of this endpoint to 2 requests in a 10 second window:
-    <div class="language-yaml highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">  </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="w">    </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="w">  </span><span class="nt">rate_limit</span><span class="p">:</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="w">  </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="w">    </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="w">    </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span></code></pre></div></li>
-<li>In <code>/store/inventory</code>, we have also have a Gateway API <code>backendRef</code>set and a <code>rate_limit</code> set. The rate limit policy for the endpoint restricts usage of this endpoint to 10 requests in a 10 second window:
-    <div class="language-yaml highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="w">  </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="w">    </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="w">  </span><span class="nt">rate_limit</span><span class="p">:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="w">    </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="w">      </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="w">      </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span></code></pre></div></li>
-<li>Finally, we have a <code>securityScheme</code> setup for apiKey auth, powered by Authorino. We'll show this in more detail a little later:
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="nt">securitySchemes</span><span class="p">:</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="w">  </span><span class="nt">api_key</span><span class="p">:</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiKey</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="w">    </span><span class="nt">in</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">header</span>
-</span></code></pre></div></li>
-</ul>
-<p>These extensions allow us to automatically generate Kuadrant Kubernetes resources, including <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth/">AuthPolicies</a>, <a href="https://docs.kuadrant.io/kuadrant-operator/doc/rate-limiting/">RateLimitPolicies</a> and <a href="https://gateway-api.sigs.k8s.io/reference/spec/">Gateway API resources</a> such as HTTPRoutes.</p>
-<h3 id="kuadrantctl">kuadrantctl<a class="headerlink" href="#kuadrantctl" title="Permanent link">&para;</a></h3>
-<p><code>kuadrantctl</code> is a cli that supports the generation of various Kubernetes resources via OAS specs.
-Let's run some commands to generate some of these resources.
-If you forked the api-pestore repo, you can check them in also.
-Let's apply these to our running workload to implement rate limiting and auth.</p>
-<h3 id="installing-kuadrantctl">Installing <code>kuadrantctl</code><a class="headerlink" href="#installing-kuadrantctl" title="Permanent link">&para;</a></h3>
-<p>Download <code>kuadrantctl</code> from the <code>v0.2.0</code> release artifacts:</p>
-<p>https://github.com/Kuadrant/kuadrantctl/releases/tag/v0.2.0</p>
-<p>Drop the <code>kuadrantctl</code> binary somewhere into your $PATH (e.g. <code>/usr/local/bin/</code>).</p>
-<p>For this next part of the tutorial, we recommend installing <a href="https://github.com/mikefarah/yq"><code>yq</code></a> to pretty-print YAML resources.</p>
-<h3 id="generating-kuadrant-resources-with-kuadrantctl">Generating Kuadrant resources with <code>kuadrantctl</code><a class="headerlink" href="#generating-kuadrant-resources-with-kuadrantctl" title="Permanent link">&para;</a></h3>
-<p>We'll generate an <code>AuthPolicy</code> to implement API key auth, per the <code>securityScheme</code> in our OAS spec:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="c1"># Generate this resource and save:</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>yq<span class="w"> </span>-P<span class="w"> </span><span class="p">|</span><span class="w"> </span>tee<span class="w"> </span>resources/authpolicy.yaml
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="c1"># Apply this resource to our cluster:</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-1<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>./resources/authpolicy.yaml
-</span></code></pre></div>
-<p>Next we'll generate a <code>RateLimitPolicy</code>, to protect our APIs with the limits we have setup in our OAS spec:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="c1"># Generate this resource and save:</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>ratelimitpolicy<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>yq<span class="w"> </span>-P<span class="w"> </span><span class="p">|</span><span class="w"> </span>tee<span class="w"> </span>resources/ratelimitpolicy.yaml
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="c1"># Apply this resource to our cluster:</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-1<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>./resources/ratelimitpolicy.yaml
-</span></code></pre></div>
-<p>Lastly, we'll generate a Gateway API <code>HTTPRoute</code> to service our APIs:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="c1"># Generate this resource and save:</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>gatewayapi<span class="w"> </span>httproute<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>yq<span class="w"> </span>-P<span class="w"> </span><span class="p">|</span><span class="w"> </span>tee<span class="w"> </span>resources/httproute.yaml
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="c1"># Apply this resource to our cluster, setting the hostname in via the KUADRANT_ZONE_ROOT_DOMAIN env var:</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a>kustomize<span class="w"> </span>build<span class="w"> </span>./resources/<span class="w"> </span><span class="p">|</span><span class="w"> </span>envsubst<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-1<span class="w"> </span>apply<span class="w"> </span>-f-
-</span></code></pre></div>
-<h3 id="check-our-applied-policies">Check our applied policies<a class="headerlink" href="#check-our-applied-policies" title="Permanent link">&para;</a></h3>
-<p>Navigate to your app's Swagger UI:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nb">echo</span><span class="w"> </span>https://petstore.<span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span>/docs/
-</span></code></pre></div>
-<h4 id="ratelimitpolicy">RateLimitPolicy<a class="headerlink" href="#ratelimitpolicy" title="Permanent link">&para;</a></h4>
-<p>Let's check that our <code>RateLimitPolicy</code> for the <code>/store/inventory</code> has been applied and works correctly. Recall, our OAS spec had the following limits applied:</p>
-<p><div class="language-yaml highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="w">  </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="w">  </span><span class="l l-Scalar l-Scalar-Plain">rate_limit</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="w">    </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a>
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="w">      </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a><span class="w">      </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span></code></pre></div>
-Navigate to the <code>/store/inventory</code> API, click <code>Try it out</code>, and <code>Execute</code>.</p>
-<p>You'll see a response similar to:</p>
-<div class="language-json highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="p">{</span>
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="w">  </span><span class="nt">&quot;available&quot;</span><span class="p">:</span><span class="w"> </span><span class="mi">10</span><span class="p">,</span>
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="w">  </span><span class="nt">&quot;pending&quot;</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span>
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="w">  </span><span class="nt">&quot;sold&quot;</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span>
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="p">}</span>
-</span></code></pre></div>
-<p>This API has a rate limit applied, so if you send more than 10 requests in a 10 second window, you will see a <code>429</code> HTTP Status code from responses, and a "Too Many Requests" message in the response body. Click <code>Execute</code> quickly in succession to see your <code>RateLimitPolicy</code> in action.</p>
-<h4 id="authpolicy">AuthPolicy<a class="headerlink" href="#authpolicy" title="Permanent link">&para;</a></h4>
-<p>Let's check that our <code>AuthPolicy</code> for the <code>/store/admin</code> endpoint has been applied and works correctly. Recall, our OAS spec had the following securitySchemes applied:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a><span class="w">  </span><span class="nt">securitySchemes</span><span class="p">:</span>
-</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="w">    </span><span class="nt">api_key</span><span class="p">:</span>
-</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a><span class="w">      </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiKey</span>
-</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
-</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a><span class="w">      </span><span class="nt">in</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">header</span>
-</span></code></pre></div>
-<p>Navigate to the <code>/store/admin</code> API, click <code>Try it out</code>, and <code>Execute</code>.
-You'll get a 401 response.</p>
-<p>You can set a value for the <code>api_key</code> header by clicking <code>Authorize</code> at the top of the page. Set a value of <code>secret</code>.
-This api key value is stored in the <code>petstore-api-key</code> Secret in the <code>petstore</code> namespace.
-Try the <code>/store/admin</code> endpoint again and you should get a 200 response with the following:</p>
-<div class="language-json highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="p">{</span><span class="nt">&quot;message&quot;</span><span class="p">:</span><span class="s2">&quot;You are an admin!&quot;</span><span class="p">}</span>
-</span></code></pre></div>
-<h3 id="policy-adjustments">Policy Adjustments<a class="headerlink" href="#policy-adjustments" title="Permanent link">&para;</a></h3>
-<p>Run the Swagger UI editor to explore the OAS spec and make some tweaks:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>docker<span class="w"> </span>run<span class="w"> </span>-p<span class="w"> </span><span class="m">8080</span>:8080<span class="w"> </span>-v<span class="w"> </span><span class="k">$(</span><span class="nb">pwd</span><span class="k">)</span>:/tmp<span class="w"> </span>-e<span class="w"> </span><span class="nv">SWAGGER_FILE</span><span class="o">=</span>/tmp/openapi.yaml<span class="w"> </span>swaggerapi/swagger-editor
-</span></code></pre></div>
-<p>You should be able to access the Swagger Editor at <a href="http://localhost:8080">http://localhost:8080</a>.
-Our <code>/store/inventory</code> API needs some additonal rate limiting. This is one of our slowest, most expensive services, so we'd like to rate limit it further.</p>
-<p>In your <code>openapi.yaml</code>, navigate to the <code>/store/inventory</code> endpoint in the <code>paths</code> block. Modify the rate_limit block to further restrict the amount of requests this endpoint can serve to 2 requests per 10 seconds:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-22-2"><a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a><span class="w">  </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-22-3"><a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a><span class="w">  </span><span class="l l-Scalar l-Scalar-Plain">rate_limit</span><span class="p p-Indicator">:</span>
-</span><span id="__span-22-4"><a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a><span class="w">    </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-22-5"><a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a>
-</span><span id="__span-22-6"><a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-22-7"><a id="__codelineno-22-7" name="__codelineno-22-7" href="#__codelineno-22-7"></a><span class="w">      </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-22-8"><a id="__codelineno-22-8" name="__codelineno-22-8" href="#__codelineno-22-8"></a><span class="w">      </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span></code></pre></div>
-<p>Save your updated spec - <code>File</code> &gt; <code>Save as YAML</code> &gt; and update your existing <code>openapi.yaml</code>. You may need to copy the file from your Downloads folder to the location of the petstore repository.</p>
-<p>Next we'll re-generate our <code>RateLimitPolicy</code> with <code>kuadrantctl</code>:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a><span class="c1"># Generate this resource and save:</span>
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>ratelimitpolicy<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>yq<span class="w"> </span>-P<span class="w"> </span><span class="p">|</span><span class="w"> </span>tee<span class="w"> </span>resources/ratelimitpolicy.yaml
-</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a>
-</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a><span class="c1"># Apply this resource to our cluster:</span>
-</span><span id="__span-23-5"><a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-1<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>./resources/ratelimitpolicy.yaml
-</span></code></pre></div>
-<p>At this stage you can optionally check in all the changes to the repo if you forked it.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a><span class="c1"># Optionally add, commit &amp; push the changes to your fork</span>
-</span><span id="__span-24-2"><a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a>git<span class="w"> </span>add<span class="w"> </span>resources
-</span><span id="__span-24-3"><a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a>git<span class="w"> </span>commit<span class="w"> </span>-am<span class="w"> </span><span class="s2">&quot;Generated AuthPolicy,RateLimitPolicy &amp; HTTPRoute&quot;</span>
-</span><span id="__span-24-4"><a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a>git<span class="w"> </span>push<span class="w"> </span><span class="c1"># You may need to set an upstream as well</span>
-</span></code></pre></div>
-<p>In your app's Swagger UI:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-25-1"><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a><span class="nb">echo</span><span class="w"> </span>https://petstore.<span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span>/docs/
-</span></code></pre></div>
-<p>Navigate to the <code>/store/inventory</code> API one more, click <code>Try it out</code>, and <code>Execute</code>.</p>
-<p>You'll see the effects of our new <code>RateLimitPolicy</code> applied. If you now send more than 2 requests in a 10 second window, you'll be rate-limited.</p>
-<p><strong>Note:</strong> <img alt="❗" class="twemoji" src="https://cdn.jsdelivr.net/gh/jdecked/twemoji@15.0.3/assets/svg/2757.svg" title=":exclamation:" /> It may take a few minutes for the updated RateLimitPolicy to be configured with the modified rate limit.</p>
-<h2 id="application-developer-scaling-the-application">(Application developer) Scaling the application<a class="headerlink" href="#application-developer-scaling-the-application" title="Permanent link">&para;</a></h2>
-<p>Deploy the petstore to the 2nd cluster:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-26-1"><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a>kustomize<span class="w"> </span>build<span class="w"> </span>./resources/<span class="w"> </span><span class="p">|</span><span class="w"> </span>envsubst<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-2<span class="w"> </span>apply<span class="w"> </span>-f-
-</span><span id="__span-26-2"><a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-2<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>./resources/authpolicy.yaml
-</span><span id="__span-26-3"><a id="__codelineno-26-3" name="__codelineno-26-3" href="#__codelineno-26-3"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-2<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>./resources/ratelimitpolicy.yaml
-</span></code></pre></div>
-<p>Configure the app <code>REGION</code> to be <code>us</code>:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-27-1"><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-workload-2<span class="w"> </span>apply<span class="w"> </span>-k<span class="w"> </span>./resources/us-cluster/
-</span></code></pre></div>
-<h2 id="platform-engineer-scaling-the-gateway-and-traffic-management">(Platform engineer) Scaling the gateway and traffic management<a class="headerlink" href="#platform-engineer-scaling-the-gateway-and-traffic-management" title="Permanent link">&para;</a></h2>
-<p>Deploy the Gateway to the 2nd cluster:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-28-1"><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-control-plane<span class="w"> </span>patch<span class="w"> </span>placement<span class="w"> </span>http-gateway<span class="w"> </span>--namespace<span class="w"> </span>multi-cluster-gateways<span class="w"> </span>--type<span class="o">=</span><span class="s1">&#39;json&#39;</span><span class="w"> </span>-p<span class="o">=</span><span class="s1">&#39;[{&quot;op&quot;: &quot;replace&quot;, &quot;path&quot;: &quot;/spec/numberOfClusters&quot;, &quot;value&quot;:2}]&#39;</span>
-</span></code></pre></div>
-<p>Label the 1st cluster as being in the 'EU' region,
-and the 2nd cluster as being in the 'US' region.
-These labels are used by the DNSPolicy for configuring geo DNS.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-29-1"><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-control-plane<span class="w"> </span>label<span class="w"> </span>managedcluster<span class="w"> </span>kind-api-workload-1<span class="w"> </span>kuadrant.io/lb-attribute-geo-code<span class="o">=</span>EU<span class="w"> </span>--overwrite
-</span><span id="__span-29-2"><a id="__codelineno-29-2" name="__codelineno-29-2" href="#__codelineno-29-2"></a>kubectl<span class="w"> </span>--context<span class="w"> </span>kind-api-control-plane<span class="w"> </span>label<span class="w"> </span>managedcluster<span class="w"> </span>kind-api-workload-2<span class="w"> </span>kuadrant.io/lb-attribute-geo-code<span class="o">=</span>US<span class="w"> </span>--overwrite
-</span></code></pre></div>
-<h2 id="api-consumer-accessing-the-api-from-multiple-regions">(API consumer) Accessing the API from multiple regions<a class="headerlink" href="#api-consumer-accessing-the-api-from-multiple-regions" title="Permanent link">&para;</a></h2>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>This section is <strong>optional</strong>. If you'd rather skip this part, you can skip forward to the "(App developer) API traffic monitoring" section.</p>
-</div>
-<p><img alt="Geosight Image" src="images/geosight.png" /></p>
-<h3 id="pre-requisites">Pre-requisites<a class="headerlink" href="#pre-requisites" title="Permanent link">&para;</a></h3>
-<ul>
-<li><code>python3</code> and <code>pip3</code>: these are required for this part of the walkthrough</li>
-</ul>
-<p>To demonstrate traffic management by geographical region, we'll use a tool called 'geosight'. This tool resolves hostnames from different regions, fetches a website from the resulting DNS record address and takes a screenshot. The petstore app has been configured to serve a flag image based on which region it is running in. In the 1st cluster, the EU flag is used. In the 2nd cluster, the US flag is used.</p>
-<p>To install 'geosight', run the following commands:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-30-1"><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a>git<span class="w"> </span>clone<span class="w"> </span>git@github.com:jasonmadigan/geosight.git<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>geosight
-</span><span id="__span-30-2"><a id="__codelineno-30-2" name="__codelineno-30-2" href="#__codelineno-30-2"></a>pip3<span class="w"> </span>install<span class="w"> </span>-r<span class="w"> </span>requirements.txt
-</span><span id="__span-30-3"><a id="__codelineno-30-3" name="__codelineno-30-3" href="#__codelineno-30-3"></a>playwright<span class="w"> </span>install
-</span></code></pre></div>
-<p>Then run it using:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-31-1"><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a>python3<span class="w"> </span>app.py
-</span></code></pre></div>
-<p>Access the webapp at <a href="http://127.0.0.1:5001/">http://127.0.0.1:5001/</a>.
-In the input box, type the address from below and click the <code>Fetch</code> button:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-32-1"><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a><span class="nb">echo</span><span class="w"> </span>https://petstore.<span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span>/server/details
-</span></code></pre></div>
-<p>After a moment you should see dns results for different regions, and a corresponding screenshot.</p>
-<p>If you want to experiment with other regions, check out the <a href="https://github.com/jasonmadigan/geosight?tab=readme-ov-file#configuration">Configuration section</a> for geosight and the <a href="https://docs.kuadrant.io/multicluster-gateway-controller/docs/how-to/multicluster-loadbalanced-dnspolicy/#configuring-cluster-geo-locations">Kuadrant docs</a> for geo loadbalancing.</p>
-<h2 id="app-developer-api-traffic-monitoring">(App developer) API traffic monitoring<a class="headerlink" href="#app-developer-api-traffic-monitoring" title="Permanent link">&para;</a></h2>
-<p>To view the App developer dashboard, the same Grafana will be used from the platform engineer steps above:
-<code>https://grafana.172.31.0.2.nip.io</code></p>
-<p>The most relevant for a app developer is <code>Stitch: App Developer Dashboard</code>
-You should see panels about API's including:</p>
-<ul>
-<li>Request and error rates</li>
-<li>API summaries</li>
-<li>API request summaries</li>
-<li>API duration</li>
-</ul>
-<p>All corresponding to our HTTPRoute coming from our OAS spec</p>
-<h2 id="platform-engineer-apis-summary-view">(Platform Engineer) APIs summary view<a class="headerlink" href="#platform-engineer-apis-summary-view" title="Permanent link">&para;</a></h2>
-<p>Now that the app developer has deployed their app, new metrics and data is now available in the platform engineer dashboard seen in the previous step <code>https://grafana.172.31.0.2.nip.io</code>:</p>
-<ul>
-<li>Gateways, routes and policies</li>
-<li>Constraints &amp; Violations (there should be no violations present)</li>
-<li>APIs Summary</li>
-</ul>
-<h2 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h2>
-<p>You now have a local environment with a reference architecture to design and deploy an API in a kube native way, using Kuadrant and other open source tools.</p>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>To destroy the previously created <code>kind</code> clusters, run:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-33-1"><a id="__codelineno-33-1" name="__codelineno-33-1" href="#__codelineno-33-1"></a>./cleanup.sh
-</span></code></pre></div>
-<div class="admonition info">
-<p class="admonition-title">Info</p>
-<p>DNS records in AWS will remain after cleanup - you can remove these from your zone manually.</p>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/docs/design/architectural-overview-v1/index.html b/0.10.0/architecture/docs/design/architectural-overview-v1/index.html
deleted file mode 100644
index 66c7dfac0..000000000
--- a/0.10.0/architecture/docs/design/architectural-overview-v1/index.html
+++ /dev/null
@@ -1,3938 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/docs/design/architectural-overview-v1/">
-      
-      
-        <link rel="prev" href="../../../../getting-started-multi-cluster/">
-      
-      
-        <link rel="next" href="../../../../kuadrant-operator/doc/install/install-kubernetes/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Architecture - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-architectural-overview" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Architecture
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#key-architectural-areas" class="md-nav__link">
-    <span class="md-ellipsis">
-      Key Architectural Areas
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#10000m-architecture" class="md-nav__link">
-    <span class="md-ellipsis">
-      10000m Architecture
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="10000m Architecture">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#control-plane-components-and-responsibilities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Control Plane Components and Responsibilities
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Control Plane Components and Responsibilities">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitador-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador Operator:
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authorino-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authorino Operator:
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#cert-manager" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cert-Manager:
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#dns-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNS Operator
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#data-plane-components-and-responsibilities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Data Plane Components and Responsibilities
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Data Plane Components and Responsibilities">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitador" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authorino
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#wasm-shim" class="md-nav__link">
-    <span class="md-ellipsis">
-      WASM Shim
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#single-cluster-layout" class="md-nav__link">
-    <span class="md-ellipsis">
-      Single Cluster Layout
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#multi-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Multi-Cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#observability" class="md-nav__link">
-    <span class="md-ellipsis">
-      Observability
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#dependencies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Dependencies
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Dependencies">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#istio-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Istio: Required
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#gateway-api-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Gateway API: Required
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#integrations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Integrations
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#open-cluster-manager-optional" class="md-nav__link">
-    <span class="md-ellipsis">
-      Open Cluster Manager: Optional
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#key-architectural-areas" class="md-nav__link">
-    <span class="md-ellipsis">
-      Key Architectural Areas
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#10000m-architecture" class="md-nav__link">
-    <span class="md-ellipsis">
-      10000m Architecture
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="10000m Architecture">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#control-plane-components-and-responsibilities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Control Plane Components and Responsibilities
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Control Plane Components and Responsibilities">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitador-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador Operator:
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authorino-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authorino Operator:
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#cert-manager" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cert-Manager:
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#dns-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNS Operator
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#data-plane-components-and-responsibilities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Data Plane Components and Responsibilities
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Data Plane Components and Responsibilities">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitador" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authorino
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#wasm-shim" class="md-nav__link">
-    <span class="md-ellipsis">
-      WASM Shim
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#single-cluster-layout" class="md-nav__link">
-    <span class="md-ellipsis">
-      Single Cluster Layout
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#multi-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Multi-Cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#observability" class="md-nav__link">
-    <span class="md-ellipsis">
-      Observability
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#dependencies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Dependencies
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Dependencies">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#istio-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Istio: Required
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#gateway-api-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Gateway API: Required
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#integrations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Integrations
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#open-cluster-manager-optional" class="md-nav__link">
-    <span class="md-ellipsis">
-      Open Cluster Manager: Optional
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/docs/design/architectural-overview-v1.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrant-architectural-overview">Kuadrant Architectural Overview<a class="headerlink" href="#kuadrant-architectural-overview" title="Permanent link">&para;</a></h1>
-<!--- variables for repeated links --->
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>Kuadrant provides connectivity, security and service protection capabilities in both a single and multi-cluster environment. It exposes these capabilities in the form of Kubernetes CRDs that implement the <a href="https://gateway-api.sigs.k8s.io">Gateway API</a> concept of <a href="https://gateway-api.sigs.k8s.io/reference/policy-attachment/">policy attachment</a>. These policy APIs can target specific Gateway API resources such as <code>Gateways</code> and <code>HTTPRoutes</code> to extend their capabilities and configuration. They enable platform engineers to secure, protect and connect their infrastructure and allow application developers to self service and refine policies to their specific needs in order to protect exposed endpoints.  </p>
-<h2 id="key-architectural-areas">Key Architectural Areas<a class="headerlink" href="#key-architectural-areas" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kuadrant architecture is defined and implemented with both control plane and data plane components.</li>
-<li>The control plane is where policies are exposed and expressed as Kubernetes APIs and reconciled by a policy controller. </li>
-<li>The data plane is where Kuadrant's "policy enforcement" components exist. These components are configured by the  control plane and integrate either directly with the Gateway provider or via external integrations.</li>
-</ul>
-<h2 id="10000m-architecture">10000m Architecture<a class="headerlink" href="#10000m-architecture" title="Permanent link">&para;</a></h2>
-<p><img alt="" src="../images/highest-level.jpg" /></p>
-<h3 id="control-plane-components-and-responsibilities">Control Plane Components and Responsibilities<a class="headerlink" href="#control-plane-components-and-responsibilities" title="Permanent link">&para;</a></h3>
-<p>The control plane is a set of controllers and operators that are responsible for for installation and configuration of other components such as the data plane enforcement components and configuration of the Gateway to enable the data plane components to interact with incoming requests. The control plane also owns and reconciles the policy CRD APIs into more complex and specific configuration objects that the policy enforcement components consume in order to know the rules to apply to incoming requests or the configuration to apply to external integrations such as DNS and ACME providers. </p>
-<p><img alt="" src="../images/control-plane-overview.jpg" /></p>
-<h4 id="kuadrant-operator"><a href="https://github.com/Kuadrant/Kuadrant-operator">Kuadrant Operator</a><a class="headerlink" href="#kuadrant-operator" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Installation and configuration of other control plane components</li>
-<li>Installation of data plane policy enforcement components via their respective control plane operators</li>
-<li>Configures the Gateway via WASM plugin and other APIs to leverage the data plane components for auth and rate limiting on incoming requests.</li>
-<li>Exposes <a href="https://docs.kuadrant.io/kuadrant-operator/doc/rate-limiting/"><code>RateLimitPolicy</code></a> , <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth/"><code>AuthPolicy</code></a>, <a href="https://docs.kuadrant.io/kuadrant-operator/doc/dns/"><code>DNSPolicy</code></a> and <a href="https://docs.kuadrant.io/kuadrant-operator/doc/tls/"><code>TLSPolicy</code></a> and reconciles these into enforceable configuration for the data plane.</li>
-<li>Exposes <a href="https://github.com/Kuadrant/kuadrant-operator/blob/main/doc/reference/kuadrant.md"><code>Kuadrant</code></a> and reconciles this to configure and trigger installation of the required data plane components and other control plane components.</li>
-</ul>
-<h4 id="limitador-operator"><a href="https://github.com/Kuadrant/limitador-operator">Limitador Operator:</a><a class="headerlink" href="#limitador-operator" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Installs and configures the Limitador data plane component based on the Limitador CR. Limits specified in the limitador CR are mountd via configmap into the limitador component.</li>
-</ul>
-<h4 id="authorino-operator"><a href="https://github.com/Kuadrant/authorino-operator">Authorino Operator:</a><a class="headerlink" href="#authorino-operator" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Installs and configures the Authorino data plane component based on the Authorino CR.</li>
-</ul>
-<h4 id="cert-manager"><a href="https://cert-manager.io/">Cert-Manager:</a><a class="headerlink" href="#cert-manager" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Manages TLS certificates for our components and for the Gateways. Consumes Certificate resources created by Kuadrant operator in response to the TLSPolicy.</li>
-</ul>
-<h4 id="dns-operator"><a href="https://github.com/Kuadrant/dns-operator">DNS Operator</a><a class="headerlink" href="#dns-operator" title="Permanent link">&para;</a></h4>
-<ul>
-<li>DNS operator consumes DNSRecord resources that are configured via the DNSPolicy api and applies them into the targeted cloud DNS provider
-AWS, Azure and Google DNS are our main targets</li>
-</ul>
-<h3 id="data-plane-components-and-responsibilities">Data Plane Components and Responsibilities<a class="headerlink" href="#data-plane-components-and-responsibilities" title="Permanent link">&para;</a></h3>
-<p><img alt="" src="../images/data-plane-overview.jpg" /></p>
-<p>The data plane components sit in the request flow and are responsible for enforcing configuration defined by policy and providing service protection capabilities based on configuration managed and created by the control plane.</p>
-<h4 id="limitador"><a href="https://github.com/Kuadrant/limitador">Limitador</a><a class="headerlink" href="#limitador" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Complies with the with Envoy rate limiting API to provide rate limiting to the gateway. Consumes limits from a configmap created based on the RateLimitPolicy API.</li>
-</ul>
-<h4 id="authorino"><a href="https://github.com/Kuadrant/authorino">Authorino</a><a class="headerlink" href="#authorino" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Complies with the Envoy external auth API to provide auth integration to the gateway. It provides both Authn and Authz. Consumes AuthConfigs created by the kuadrant operator based on the defined <code>AuthPolicy</code> API.</li>
-</ul>
-<h4 id="wasm-shim"><a href="https://github.com/Kuadrant/wasm-shim">WASM Shim</a><a class="headerlink" href="#wasm-shim" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Uses the <a href="https://github.com/proxy-wasm/spec">Proxy WASM ABI Spec</a> to integrate with Envoy and provide filtering and connectivity to Limitador for request time enforcement of and rate limiting.</li>
-</ul>
-<h3 id="single-cluster-layout">Single Cluster Layout<a class="headerlink" href="#single-cluster-layout" title="Permanent link">&para;</a></h3>
-<p>In a single cluster, you have the Kuadrant control plane and data plane sitting together. It is configured to integrate with Gateways on the same cluster and configure a DNS zone via a DNS provider secret (configured alongside a DNSPolicy). Storage of rate limit counters is possible but not required as they are not being shared.</p>
-<p><img alt="" src="../images/single-cluster-layout.jpg" /></p>
-<h3 id="multi-cluster">Multi-Cluster<a class="headerlink" href="#multi-cluster" title="Permanent link">&para;</a></h3>
-<p>In the default multi-cluster setup. Each individual cluster has Kuadrant installed. Each of these clusters are unaware of the other. They are effectively operating as single clusters. The multi-cluster aspect is created by sharing access with the DNS zone, using a shared host across the clusters and leveraging shared counter storage. 
-The zone is operated on independently by each of DNS operator on both clusters to form a single cohesive record set. More details on this can be found in the following RFC document: TODO add link.
-The rate limit counters can also be shared and used by different clusters in order to provide global rate limiting. This is achieved by connecting each instance of Limitador to a shared data store that uses the Redis protocol. There is another option available for achieving multi-cluster connectivity (see intgrations below) that requires the use of a "hub" cluster and integration with OCM (open cluster management).</p>
-<p><img alt="" src="../images/multi-cluster-layout.jpg" /></p>
-<p>Shown above is a multi-cluster multi ingress gateway topology. This might be used to support a geographically distributed system for example. However, it is also possible to leverage overlay networking tools such as <a href="https://skupper.io">Skupper</a> that integrate at the Kubernetes service level to have a single gateway cluster that then integrates with multiple backends (on different clusters or in custom infrastructure).</p>
-<h3 id="observability">Observability<a class="headerlink" href="#observability" title="Permanent link">&para;</a></h3>
-<p>The Kuadrant architecture is intended to work with some popular monitoring tools for tracing, metrics and log aggregation.
-Those tools are:</p>
-<ul>
-<li><a href="https://prometheus.io/">Prometheus</a> for scraping metrics - and optionally <a href="https://github.com/thanos-io/thanos">Thanos</a> for high availability &amp; federation</li>
-<li><a href="https://github.com/grafana/loki">Loki</a> for log aggregation - via log collectors like <a href="https://github.com/vectordotdev/vector">vector</a></li>
-<li><a href="https://github.com/grafana/tempo">Tempo</a> for trace collecting</li>
-<li><a href="https://github.com/grafana/grafana">Grafana</a> for visualing the above</li>
-</ul>
-<p>Depending on the number of clusters in your configuration, you may decide to have a monitoring system on the same cluster as workloads,
-or in a separate cluster completely.
-Below are 2 example architectures based on the single cluster and multi cluster layouts.
-In the single cluster architecture, the collector components (Prometheus, Vector and Tempo) are in the same cluster as the log aggregation (Loki) and visualisation component (Grafana).</p>
-<p><img alt="" src="../images/arch_observability_1.jpg" /></p>
-<p>In the multi cluster architecture, the collectors that scrape metrics or logs (Prometheus &amp; Vector) are deployed alongside the workloads in each cluster.
-However, as traces are sent to a collector (Tempo) from each component, it can be centralised in a separate cluster.
-Thanos is used in this architecutre so that each prometheus can federate metrics back to a central location.
-The log collector (vector) can forward logs to a central loki instance.
-Finally, the visualisation component (Grafana) is centralised as well, with data sources configured for each of the 3 components on the same cluster.</p>
-<p><img alt="" src="../images/arch_observability_2.jpg" /></p>
-<h3 id="dependencies">Dependencies<a class="headerlink" href="#dependencies" title="Permanent link">&para;</a></h3>
-<h4 id="istio-required"><a href="https://istio.io">Istio</a>: <strong>Required</strong><a class="headerlink" href="#istio-required" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Gateway API provider that Kuadrant integrates with via WASM and Istio APIS to provide service protection capabilities. Kuadrant configures Envoy via the Istio control plane in order to enforce the applied policies and register components such as Authorino and Limitador. </li>
-<li>Used by <a href="https://docs.kuadrant.io/kuadrant-operator/doc/rate-limiting/"><code>RateLimitPolicy</code></a> and <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth/"><code>AuthPolicy</code></a></li>
-</ul>
-<h4 id="gateway-api-required"><a href="https://github.com/kubernetes-sigs/gateway-api">Gateway API</a>: <strong>Required</strong><a class="headerlink" href="#gateway-api-required" title="Permanent link">&para;</a></h4>
-<ul>
-<li>New standard for Ingress from the Kubernetes community</li>
-<li>Gateway API is the core API that Kuadrant integrates with.</li>
-</ul>
-<h4 id="integrations">Integrations<a class="headerlink" href="#integrations" title="Permanent link">&para;</a></h4>
-<h4 id="open-cluster-manager-optional"><a href="https://open-cluster-management.io/">Open Cluster Manager</a>: <strong>Optional</strong><a class="headerlink" href="#open-cluster-manager-optional" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Provides a multi-cluster control plane to enable the defining and distributing of Gateways across multiple clusters.</li>
-</ul>
-<p>While the default setup is to leverage a distributed configuration for DNS and rate limiting. There is also a component that offers experimental integration with Open Cluster Management. </p>
-<p>In this setup, the OCM integration controller is installed into the HUB alongside the DNS Operator and the cert-manager. This integration allows you to define gateways in the Hub and distribute them to "spoke" clusters. The addresses of these gateways are gathered from the spokes and aggregated back to the hub. The Kuadrant operator and DNS operator then act on this information as though it were a single cluster gateway with multiple addresses. The DNS zone in the configured DNS provider is managed centrally by one DNS operator instance.</p>
-<p><img alt="" src="../images/high-level-multi-cluster.png" /></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/docs/design/architectural-overview/index.html b/0.10.0/architecture/docs/design/architectural-overview/index.html
deleted file mode 100644
index bfec8a79e..000000000
--- a/0.10.0/architecture/docs/design/architectural-overview/index.html
+++ /dev/null
@@ -1,3826 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/docs/design/architectural-overview/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Kuadrant Architectural Overview [Draft] - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-architectural-overview-draft" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Kuadrant Architectural Overview [Draft]
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#key-architectural-areas" class="md-nav__link">
-    <span class="md-ellipsis">
-      Key Architectural Areas
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#1000m-architecture" class="md-nav__link">
-    <span class="md-ellipsis">
-      1000m Architecture
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="1000m Architecture">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#control-plane-components-and-responsibilities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Control Plane Components and Responsibilities
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Control Plane Components and Responsibilities">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#multi-cluster-gateway-controller" class="md-nav__link">
-    <span class="md-ellipsis">
-      Multi-Cluster Gateway Controller
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-add-on-manager" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant-add-on-manager
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitador-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador Operator:
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authorino-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authorino Operator:
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#data-plane-components-and-responsibilities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Data Plane Components and Responsibilities
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Data Plane Components and Responsibilities">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitador" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authorino
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#wasm-shim" class="md-nav__link">
-    <span class="md-ellipsis">
-      WASM Shim
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#dependencies-and-integrations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Dependencies and integrations
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Dependencies and integrations">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#cert-manager-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cert-Manager: Required
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#open-cluster-manager-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Open Cluster Manager: Required
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#istio-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Istio: Required
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#gateway-api-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Gateway API: Required
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#thanosprometheusgrafana-optional" class="md-nav__link">
-    <span class="md-ellipsis">
-      Thanos/Prometheus/Grafana: Optional
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#high-level-multi-cluster-architecture" class="md-nav__link">
-    <span class="md-ellipsis">
-      High Level Multi-Cluster Architecture
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#single-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Single cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#how-does-kuadrant-leverage-open-cluster-management" class="md-nav__link">
-    <span class="md-ellipsis">
-      How does Kuadrant leverage Open Cluster Management?
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How does Kuadrant leverage Open Cluster Management?">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#gateway-deployment-and-distribution" class="md-nav__link">
-    <span class="md-ellipsis">
-      Gateway Deployment and Distribution
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#how-does-kuadrant-integrate-with-gateway-providers" class="md-nav__link">
-    <span class="md-ellipsis">
-      How does Kuadrant integrate with Gateway Providers?
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How does Kuadrant integrate with Gateway Providers?">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#data-flows" class="md-nav__link">
-    <span class="md-ellipsis">
-      Data Flows
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Data Flows">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#control-plane-configuration-and-status-reporting" class="md-nav__link">
-    <span class="md-ellipsis">
-      Control plane configuration and status reporting
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#third-party-enforcement-and-integration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Third party enforcement and Integration
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#request-flow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Request Flow
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      Auth
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Auth">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#observability" class="md-nav__link">
-    <span class="md-ellipsis">
-      Observability
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#some-notes-on-future-direction" class="md-nav__link">
-    <span class="md-ellipsis">
-      Some notes on future direction
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/docs/design/architectural-overview.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrant-architectural-overview-draft">Kuadrant Architectural Overview [Draft]<a class="headerlink" href="#kuadrant-architectural-overview-draft" title="Permanent link">&para;</a></h1>
-<!--- variables for repeated links --->
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>It is important to note that Kuadrant is not in itself a gateway provider. Kuadrant provides a set of valuable policy APIs that enhance <a href="https://github.com/kubernetes-sigs/gateway-api">Gateway API</a> via its defined <a href="https://gateway-api.sigs.k8s.io/references/policy-attachment/">policy attachment</a> extension point. The policy APIs are reconciled by a set of policy controllers and enforced via integration at different points to configure, enhance and secure the application connectivity provided via Gateway API and the underlying gateway provider. 
-These policy extensions are focused around areas such as DNS management supporting global load balancing and health checks, alongside service protection specific APIs such as rate limiting and auth. Kuadrant also integrates with <a href="https://open-cluster-management.io/">Open Cluster Management</a> as a multi-cluster control plane to enable defining and distributing Gateways across multiple clusters, providing load balancing and tls management for these distributed gateways. These integrations and features can be managed centrally in a declarative way from the Open Cluster Management Hub using Kubernetes resources.</p>
-<h2 id="key-architectural-areas">Key Architectural Areas<a class="headerlink" href="#key-architectural-areas" title="Permanent link">&para;</a></h2>
-<ul>
-<li>The Kuadrant architecture is spread across a control plane and also a data plane. Kuadrant can work in both a single and multi-cluster context. 
-Currently in order for all APIs to work in a single or multi-cluster context you need to have Open Cluster Management installed.  While this may change in the future, this approach allows us to start with a single cluster and seamlessly scale as more clusters are added.</li>
-<li>The control plane is where policies are exposed and expressed as kubernetes APIs and reconciled by the Kuadrant policy controllers. </li>
-<li>The data plane is where Kuadrant's service protection components, configured by the  control plane policies, are enforced within the gateway instance as part of the request flow. </li>
-</ul>
-<h2 id="1000m-architecture">1000m Architecture<a class="headerlink" href="#1000m-architecture" title="Permanent link">&para;</a></h2>
-<p><img alt="" src="../images/1000m-overview.png" /></p>
-<h3 id="control-plane-components-and-responsibilities">Control Plane Components and Responsibilities<a class="headerlink" href="#control-plane-components-and-responsibilities" title="Permanent link">&para;</a></h3>
-<p>A control plane component is something responsible for accepting instruction via a CRD based API and ensuring that configuration is manifested into state that can be acted on.</p>
-<h4 id="kuadrant-operator"><a href="https://github.com/Kuadrant/Kuadrant-operator">Kuadrant Operator</a><a class="headerlink" href="#kuadrant-operator" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Installation of data plane service protection components via their respective operators</li>
-<li>Exposes <a href="https://docs.kuadrant.io/kuadrant-operator/doc/rate-limiting/"><code>RateLimitPolicy</code></a> and <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth/"><code>AuthPolicy</code></a> and is currently the policy controller for these APIs</li>
-<li>Configures the Gateway to be able to leverage the data plane service protection components</li>
-</ul>
-<h4 id="multi-cluster-gateway-controller"><a href="https://github.com/Kuadrant/multicluster-gateway-controller">Multi-Cluster Gateway Controller</a><a class="headerlink" href="#multi-cluster-gateway-controller" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Exposes <a href="https://docs.kuadrant.io/kuadrant-operator/doc/dns/"><code>DNSPolicy</code></a> and <a href="https://docs.kuadrant.io/kuadrant-operator/doc/tls/"><code>TLSPolicy</code></a></li>
-<li>Configures DNS providers (e.g AWS Route 53) and TLS providers</li>
-<li>Focused around use cases involving distributed gateways (for example across clouds or geographic regions)</li>
-<li>Integrates with Open Cluster Management as the multi-cluster management hub to distribute and observe gateway status based on the clusters they are deployed to. Works directly with Open Cluster Management APIs such <a href="https://open-cluster-management.io/concepts/placement/#placementdecisions"><code>PlacementDecision</code></a> and <a href="https://open-cluster-management.io/concepts/manifestwork/"><code>ManifestWork</code></a>.</li>
-</ul>
-<h4 id="kuadrant-add-on-manager"><a href="https://github.com/Kuadrant/multicluster-gateway-controller/tree/main/cmd/ocm">Kuadrant-add-on-manager</a><a class="headerlink" href="#kuadrant-add-on-manager" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Sub component in the gateway controller repository</li>
-<li>Follows the <a href="https://open-cluster-management.io/concepts/addon/">add-on pattern</a> from Open Cluster Management</li>
-<li>Responsible for configuring and installing Kuadrant into a target spoke cluster</li>
-</ul>
-<h4 id="limitador-operator"><a href="https://github.com/Kuadrant/limitador-operator">Limitador Operator:</a><a class="headerlink" href="#limitador-operator" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Installs and configures Limitador</li>
-</ul>
-<h4 id="authorino-operator"><a href="https://github.com/Kuadrant/authorino-operator">Authorino Operator:</a><a class="headerlink" href="#authorino-operator" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Installs and configures Authorino</li>
-</ul>
-<h3 id="data-plane-components-and-responsibilities">Data Plane Components and Responsibilities<a class="headerlink" href="#data-plane-components-and-responsibilities" title="Permanent link">&para;</a></h3>
-<p>A data plane component sits in the request flow and is responsible for enforcing policy and providing service protection capabilities based on configuration managed and created by the control plane.</p>
-<h4 id="limitador"><a href="https://github.com/Kuadrant/limitador">Limitador</a><a class="headerlink" href="#limitador" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Complies with the with Envoy rate limiting API to provide rate limiting to the gateway</li>
-</ul>
-<h4 id="authorino"><a href="https://github.com/Kuadrant/authorino">Authorino</a><a class="headerlink" href="#authorino" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Complies with the Envoy external auth API to provide auth integration to the gateway</li>
-</ul>
-<h4 id="wasm-shim"><a href="https://github.com/Kuadrant/wasm-shim">WASM Shim</a><a class="headerlink" href="#wasm-shim" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Uses the <a href="https://github.com/proxy-wasm/spec">Proxy WASM ABI Spec</a> to integrate with Envoy and provide filtering and connectivity to Limitador for request time enforcement of and rate limiting</li>
-</ul>
-<h3 id="dependencies-and-integrations">Dependencies and integrations<a class="headerlink" href="#dependencies-and-integrations" title="Permanent link">&para;</a></h3>
-<p>In order to provide its full suite of functionality, Kuadrant has several dependencies. Some of these are optional depending on the functionality needed.</p>
-<h4 id="cert-manager-required"><a href="https://cert-manager.io/">Cert-Manager</a>: <strong>Required</strong><a class="headerlink" href="#cert-manager-required" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Provides TLS integration</li>
-<li>Used by <a href="https://docs.kuadrant.io/kuadrant-operator/doc/tls/"><code>TLSPolicy</code></a> and <a href="https://github.com/Kuadrant/authorino">Authorino</a>.</li>
-</ul>
-<h4 id="open-cluster-manager-required"><a href="https://open-cluster-management.io/">Open Cluster Manager</a>: <strong>Required</strong><a class="headerlink" href="#open-cluster-manager-required" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Provides a multi-cluster control plane to enable the defining and distributing of Gateways across multiple clusters.</li>
-</ul>
-<h4 id="istio-required"><a href="https://istio.io">Istio</a>: <strong>Required</strong><a class="headerlink" href="#istio-required" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Gateway API provider that Kuadrant integrates with via WASM and Istio APIS to provide service protection capabilities.</li>
-<li>Used by <a href="https://docs.kuadrant.io/kuadrant-operator/doc/rate-limiting/"><code>RateLimitPolicy</code></a> and <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth/"><code>AuthPolicy</code></a></li>
-</ul>
-<h4 id="gateway-api-required"><a href="https://github.com/kubernetes-sigs/gateway-api">Gateway API</a>: <strong>Required</strong><a class="headerlink" href="#gateway-api-required" title="Permanent link">&para;</a></h4>
-<ul>
-<li>New standard for Ingress from the Kubernetes community</li>
-<li>Gateway API is the core API that Kuadrant integrates with.</li>
-</ul>
-<h4 id="thanosprometheusgrafana-optional"><a href="https://thanos.io">Thanos/Prometheus/Grafana</a>: <strong>Optional</strong><a class="headerlink" href="#thanosprometheusgrafana-optional" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Provides observability integration</li>
-<li>Rather than providing any Kuadrant specific observability tooling, we instead look to leverage existing tools and technologies to provide observability capabilities for ingress. </li>
-</ul>
-<h2 id="high-level-multi-cluster-architecture">High Level Multi-Cluster Architecture<a class="headerlink" href="#high-level-multi-cluster-architecture" title="Permanent link">&para;</a></h2>
-<p><img alt="" src="../images/high-level-multi-cluster.png" /></p>
-<p>Kuadrant has a multi-cluster gateway controller that is intended to run in a Open Cluster Management provided "Hub" cluster. This cluster is effectively a central management cluster where policy and gateways along with all that Open Cluster Management offers can be defined and distributed to the managed "spoke" clusters. </p>
-<h2 id="single-cluster">Single cluster<a class="headerlink" href="#single-cluster" title="Permanent link">&para;</a></h2>
-<p>In a single cluster context, the overall architecture remains the same as above, the key difference is that the Hub and Spoke cluster are now a single cluster rather than multiple clusters. This is how we are initially supporting single cluster.</p>
-<h2 id="how-does-kuadrant-leverage-open-cluster-management">How does Kuadrant leverage Open Cluster Management?<a class="headerlink" href="#how-does-kuadrant-leverage-open-cluster-management" title="Permanent link">&para;</a></h2>
-<p>Kuadrant deploys a multi-cluster gateway controller into the Open Cluster Management hub (a control plane that manages a set of "spoke" clusters where workloads are executed). This controller offers its own APIs but also integrates with hub CRD based APIs (such as the placement API) along with the Gateway API CRD based APIs in order to provide multi-cluster Gateway capabilities to the hub and distribute actual gateway instances to the spokes. See the Open Cluster Management <a href="https://open-cluster-management.io/concepts/architecture/#hub-spoke-architecture">docs</a> for further details on the hub spoke architecture.</p>
-<p>As part of installing Kuadrant, the Gateway API CRDs are also installed into the hub cluster and Kuadrant defines a standard Gateway API <a href="https://gateway-api.sigs.k8s.io/api-types/gatewayclass/"><code>GatewayClass</code></a> resource that the multi-cluster gateway controller is the chosen controller for. </p>
-<p>Once installed, an Open Cluster Management user can then (with the correct RBAC in place) define in the standard way a <a href="https://gateway-api.sigs.k8s.io/api-types/gateway/">Gateway resource</a> that inherits from the Kuadrant configured <code>GatewayClass</code> in the hub. There is nothing unique about this Gateway definition, the difference is what it represents and how it is used. This Gateway is used to represent a "multi-cluster" distributed gateway. As such there are no pods running behind this Gateway instance in the hub cluster, instead it serves as a template that the Kuadrant multi-cluster gateway controller reconciles and distributes to targeted spoke clusters.  It leverages the Open Cluster Management APIs to distribute these gateways (more info below) and aggregates the status information from each spoke cluster instance of this gateway back to this central definition, in doing this it can represent the status of the gateway across multiple clusters but also use that information to integrate with DNS providers etc.</p>
-<p><img alt="" src="../images/ocm-integration.png" /></p>
-<h3 id="gateway-deployment-and-distribution">Gateway Deployment and Distribution<a class="headerlink" href="#gateway-deployment-and-distribution" title="Permanent link">&para;</a></h3>
-<p>In order for a multi-cluster gateway to be truly useful, it needs to be distributed or "placed" on a specific set of hub managed spoke clusters.  Open Cluster Management is responsible for a set of placement and replication APIs. Kuadrant is aware of these APIs, and so when a given gateway is chosen to be placed on a set of managed clusters, Kuadrant multi-cluster gateway controller will ensure the right resources (<a href="https://open-cluster-management.io/concepts/manifestwork/"><code>ManifestWork</code></a>) are created in the correct namespaces in the hub. Open Cluster Management then is responsible for syncing these to the actual spoke cluster and reporting back the status of these resources to the Hub. A user would indicate which clusters they want a gateway placed on by using a <a href="https://open-cluster-management.io/concepts/placement/"><code>Placement</code></a> and then labeling the gateway using the <code>cluster.open-cluster-management.io/placement</code> label.</p>
-<p>In order for the Gateway to be instantiated, we need to know what underlying gateway provider is being used on the spoke clusters. Admins can then set this provider in the hub via the GatewayClass params. In the hub, Kuadrant will then apply a transformation to the gateway to ensure when synced it references this spoke gateway provider (Istio for example). </p>
-<p>It is the Open Cluster Management workagent that is responsible for syncing down and applying the resources into the managed spoke cluster. It is also responsible for syncing status information back to the hub. It is the multi-cluster gateway controller that is responsible for aggregating this status.</p>
-<p>The status information reported back to the Hub is used by the multi-cluster gateway controller to know what LB hosts / IPAddresses to use for DNSRecords that it creates and manages.</p>
-<p><img alt="" src="../images/gateway-placement.png" /></p>
-<p>More info on the Open Cluster Management hub and spoke architecture can be found <a href="https://open-cluster-management.io/concepts/architecture/">here</a></p>
-<h2 id="how-does-kuadrant-integrate-with-gateway-providers">How does Kuadrant integrate with Gateway Providers?<a class="headerlink" href="#how-does-kuadrant-integrate-with-gateway-providers" title="Permanent link">&para;</a></h2>
-<p>Currently the Kuadrant data plane only integrates with an Istio based gateway provider:</p>
-<ul>
-<li>It registers Authorino with the <a href="https://istio.io/latest/docs/reference/config/istio.operator.v1alpha1/#IstioOperatorSpec"><code>IstioOperator</code></a> as an auth provider so that Authorino can be used as an external auth provider.</li>
-<li>It leverages an <a href="https://istio.io/latest/docs/reference/config/networking/envoy-filter/"><code>EnvoyFilter</code></a> to register the rate limiting service as an upstream service.</li>
-<li>Based on the Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth/"><code>AuthPolicy</code></a>, it leverages Istio's <a href="https://istio.io/latest/docs/reference/config/security/authorization-policy/"><code>AuthorizationPolicy</code></a> resource to configure when a request should trigger Authorino to be called for a given host, path and method etc. </li>
-<li>It provides a WebAssembly (WASM) Plugin that conforms to the <a href="https://github.com/proxy-wasm/spec">Proxy WASM ABI</a> (application binary interface). This WASM Plugin is loaded into the underlying Envoy based gateway provider and configured via the Kuadrant Operator based on defined <a href="https://docs.kuadrant.io/kuadrant-operator/doc/rate-limiting/"><code>RateLimitPolicy</code></a> resources. This binary is executed in response to a HTTP request being accepted by the gateway via the underlying Envoy instance that provides the proxy layer for the Gateway (IE Envoy). This plugin is configured with the correct upstream rate limit service name and when it sees a request, based on the provided configuration, it will trigger a call to the installed Limitador that is providing the rate limit capabilities and either allow the request to continue or trigger a response to the client with a 429 (too many requests) HTTP code.</li>
-</ul>
-<h3 id="data-flows">Data Flows<a class="headerlink" href="#data-flows" title="Permanent link">&para;</a></h3>
-<p>There are several different data flows when using Kuadrant. </p>
-<h4 id="control-plane-configuration-and-status-reporting">Control plane configuration and status reporting<a class="headerlink" href="#control-plane-configuration-and-status-reporting" title="Permanent link">&para;</a></h4>
-<p>The initial creation of these APIs (gateways, policies etc) is done by the relevant persona in the control plane just as they would any other k8s resource. We use the term cluster admin or gateway admin as the operations type persona configuring, and placing gateways. 
-As shown above, in a multi-cluster configuration. API definitions are pulled from the Hub and "manifested" into the spokes. The Status of those synced resources are reported back to the Hub. The same happens for a single cluster, the only difference being the work agent hub controllers are all installed on one cluster.</p>
-<h4 id="third-party-enforcement-and-integration">Third party enforcement and Integration<a class="headerlink" href="#third-party-enforcement-and-integration" title="Permanent link">&para;</a></h4>
-<p>In order to enforce the policy configuration, components in the control plane and data plane can reach out to configured 3rd parties such as cloud based DNS provider, TLS providers and Auth providers.</p>
-<h4 id="request-flow">Request Flow<a class="headerlink" href="#request-flow" title="Permanent link">&para;</a></h4>
-<p>Requests coming through the gateway instance can be sent to Limitador based on configuration of the WASM plugin installed into the Envoy based gateway provider or to Authorino based configuration provided by the Istio <a href="https://istio.io/latest/docs/reference/config/security/authorization-policy/"><code>AuthorizationPolicy</code></a>. 
-Each of these components have the capability to see the request and need to in order to make the required decision. Each of these components can also prevent the request from reaching its intended backend destination based on user configuration. </p>
-<p><img alt="" src="../images/request-flow.png" /></p>
-<h2 id="auth">Auth<a class="headerlink" href="#auth" title="Permanent link">&para;</a></h2>
-<p>As all of the APIs are CRDs, auth around creating these resources is handled in the standard way IE by the kubernetes cluster and RBAC. There is no relationship by default between the Auth features provided by Authorino to application developers and the auth requirements of the cluster API server.</p>
-<p>For Auth between Spoke and Hub see Open Cluster Management <a href="https://open-cluster-management.io/concepts/architecture/">docs</a></p>
-<h3 id="observability">Observability<a class="headerlink" href="#observability" title="Permanent link">&para;</a></h3>
-<p>Kuadrant doesn't provide any specific observability components, but rather provides a reference setup using well known and established components along with some useful dashboards to help observe key things around the Gateways. The focus of this setup, is in the context of a multi-cluster setup where Open Cluster Management is installed and gateways are being defined and distributed from that hub.</p>
-<p><img alt="" src="../images/observability.png" /></p>
-<h2 id="some-notes-on-future-direction">Some notes on future direction<a class="headerlink" href="#some-notes-on-future-direction" title="Permanent link">&para;</a></h2>
-<p>This section is here to provide some insight into architectural changes that may be seen in the near future:</p>
-<p>What is in this doc represents the architecture at point our MVP release. Below are some areas that we have identified that are likely to change in the coming releases. As these happen, this doc will also evolve.</p>
-<ul>
-<li>We want to separate out the ocm integration into its own controller so that policies can evolve without a coupling to any one multi-cluster management solution</li>
-<li>We want to separate the policies into their own controller that is capable of supporting both single (without Open Cluster Management) and multi-cluster (with Open Cluster Management enabled) contexts, so that the barrier to entry is reduced for those starting with a single cluster</li>
-<li>We want to allow for an on cluster DNS Provider such as CoreDNS so that we can provide an implementation that is disconnected from any cloud provider and provides more flexible DNS setups.</li>
-<li>We will look to reduce our integration with Istio and want to provide integration with additional gateway providers such as EnvoyGateway</li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/docs/design/images/1000m-overview.png b/0.10.0/architecture/docs/design/images/1000m-overview.png
deleted file mode 100644
index 5ef2397b2fc90189f7bfbb0da6c9c2405d2c0955..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 146275
zcmeFZXINBOw=Im)LfZ;R+lpjF5d{Ge5RfbgA`(=BWE6n{B<BoGt0fX_kRXzjsAS36
zKv0mJgCHO|Nrr-=zPYN(^Pc<M@7`bc=b;}TZLQjS?X_kYbIdXK6Ad*bnm?HSprD|j
zQNE^di-O{JVfdx=I~DxRhq0zK_>IH#+AUQI3ePhX6#oBEP~hON{HG}>TrN;h%$iV8
zT#lijV6cxXzbOg-Ky^<=Nr8fZ{!6M#kAS~9Xn#%DiGqUv6#BK#JypgP{*u~RS@kOQ
z)b9s>7dviI^z9Q|kwRHPPSbs09`E6-wO%E&S2OUlOtdTDAMF5bu73vK-q`>8^<Rud
zJl9jlH1e-U>SfoB@`RohD?VOTeCx4i0H;<~(Ce-@L5Deecn;7Xuu(ZIcBCs@VL^2f
z@94X`_x((?{C>u3@6^K^OtW+9hNt3ujJ&v4X2<Z}H6z9Y@64K_U{%DQ&m6{T<-h*N
zf8ii(2kD1VDQO@1kDtZ%(~$otTThQ6|B>Qis4OM<&(9owV<P|2KloJJuTR`(2|yc*
zemKU_PLqEA=hFYPA!Jkd9}9tv_<!#*1E&osWUV!|wb{5*Q}buDMd<05H)7qAQwoKz
zU%zhJzanbo65{LQrKF}-fyJI^BeY?$)3J#R3xiXNi-ZJf{~IZE`_T~<EvNG77e7!g
z|J^_8ffLWMxt=O^>qCE-&Sd7+?H+jg@`qQ&<kZ!~K+mh2l$&7*QnbNptP-d3XDKib
z*W}OzlByvxFv&S6TV{Do<u3n><8~G6EcCIpU0dkn^>mfFurXvB*5|YN?X}9VZ)EON
zp*4fepn1BFIovGKd&P2MnLBasR8Wv~Xsa|qQoE`ut^P$e9=8!n-@syKLhY}ZN?It5
zT++Uzfaj5s4dJP|^^`S!!ac|TN~`LT78QL&%XUXx#W}aC`nb)zcTCw)W8ocrg>T%`
z3+@h1P1a{Du`vWz`zSa!x2oWl_qBbU2}BE*l|PE1=)1}sbg6!c-G_7XYkah8^}XZM
zC-J!ZwMN6o3d{&%es?1S;)CSkO~csC>v<?#UX#`mauwE+aOp3bV6XIViI>iHh{y=E
zh%Nj$A(rG9Y4%R2dEoDlcXn5J1vkG~+`H}IFd!8tYWsl2^V*1FywoAt)im;DRN*qA
zK`PhBqign52Pj&8z6u<xbg&Q^)Qz{RF1pO-HTI^^%PR3D^LQ&egZ$&e!by~}Ts}w8
z>M=YJvWp7EBZIgnrH;DYs47_*5;twA-BjN*s&BoLo&E0JiaV~1VQi0@EhjG9N|xIH
zcOMP*-{7nMY20lT8i(q*QXSgObQ)l-*uHXst;lG@z6Tbsd+x)*96HYb<jv*{73Q|G
zZCqxuPMEE7G_~x}PU>~ynP2-`ma;7go<D1M)$8Hh_)~$svd+!Tc?Xk;#La;@Yew<a
z<?ZdKV>taZh1#AE!I@_a{!&_#IX&|(c5SbOwQZ)i#O+3cyT^~oLX~o1|KMc0Vo4ka
zdaToslrkb<?Pt&Ng=pDjKcSPxo$bjca18Sr=!lyZoGff@4ypF>ygG&7c;ZvNw@x<d
zGZ*bInD)%aNUwgt_FeX0US-a;5p1&Rz3S2wtX}SUg+<ESz9V&?@HyCntR&+0%Z|hO
zyJE;T&#Rpiq-B@;WP*1%D=z*{#Hc)VH_mJJ;t^r*>7?m?{QGGqjn?TQj}gU}U&>+E
znf+Y7z8dF=aTYJq`)<5Q7j1MC;f5_0+)gvDeK%o;o;!QcuIl6|i@zx6dEmA~3DUo#
zM^sfw+IOv>IO&3RmccQVsA|3Ku=T;r81c(Vgje*-eobbgwbBE}gp7HkW_-PxEAsD6
zyp&*>Mq756rA_7$jrh9{<~g=%sbd|yIhmCNuf@1~HS-G(YIe7>X54f=nKAThaz1&N
zNZyHI+E3HgXrq>TZ#~v+yzZgOy_O*lEh9UyDS2wT;7_zO%!Vr)Di8dYn%`)8uY5^g
zHX6lkt<E)>et6BLW&Xvrx%KJ4r$YND<l=3jdoN)NOp(8oF&OA=JN?Y^pS;GNb)7wn
zm1L7liL#W1w@~yL?)1xY{b|0I@vq>6&+q%(67BA<J@^D}d1tl7czje`UGv4&!Cbo~
zF^l<_Y1i+2E==whvA0Fd%qAQribP}U4hc)(OxD*vl($nOjFRMVP*|4t7DPLBnawLh
zg!i8;3oawq*0qRZ@}Zq&G+bQ`=PwxEEWS7KmM8G?vCT_kG0CrO2Iu3AOl{=u#)&Wf
zjm4JU-}Mmm>^i7CqFrEO>6ld3M!o)_{+BV(WBj#E<lF1F@X4^chn_8cf`Ze7O2UI5
zUb6PL`*;6xt|H3IFK@p&;nJv^|E5$-F^q{ZI+)<lQPQ6EKqf}WVk4NUUxh8{<a8jx
ztp;Z@-bQ|a--Trl6~Drm4oNKR#nhNMOqAtpdpPvhF?4wxoSmF)F41nVsj1|Jn5J0U
z^WrVp;crwBB+~ZIKx|@IaB?zTJhfR8WYO7H%=*<5POu<tB(hzlh>|Z+I)m;KIWRCK
zz#+(X(|kY7e)((*vzvBiJYOl^U#)kyGRArRALK9S2&X$+L$O%h&P6K+A(xjOlbSp&
zd&>{=!7Op>3#>Ke3zI1-`}I!x<nj3ASxyrJW?SBGOi2gM@$!bDs8^igYR&$>e|UA3
zp{~m-O^g47lxNpx<hI*~jyIr4hI<mtZFsLh$KV!IgWu8`7K`pL=DGD9UHPC-o;hq!
zCuw^|(e~tlTOBwQokF8=;(dQU*yD{VFTKdBt_8Pm_6dnKXLD-It}7@=u5Ue1v84<F
zvt#zjTPDTwwhQmhs3%B@&v5$V1~m!=>j^uNf^Ne?H?@t}z&6HYmT+NWqoqr=Y!yoh
z&K`_2O~!kUEWUSYPDt9zo;O-aKg%l+)}E|bfAbR+m!aO%b_nRh21S>p2Q>a-_gk?%
zEbb`V!L^U?x%3^k|E&7%omcx}^KC2$MG%yhr@{)d99Xr!-jcE#(rqucaqXBWJUh7f
z#kNPF?Zny#!*se!Y$QK%jX%be#K^;cE`*nR_ynEQio1fs+T5Uo@9Ny(xIdo2H`5Ut
zAEf)1utX?QE`NU9BJ7)6*!q&+i33a7PYELgI~BBaw2Qy{<c&@ThA5HZx}n8GDvUXp
zP<`FeGun&v(lfIM&6C6Pi{s<Vw;p=5pW)@53HLWwV^0w$`ISkpxA@F{{{b)Gz1Lz+
zLkEyWmrqXB-41KLgq2sE>&lmhr1=z!?KLt^a2A&pN~h}>A{j%TH5kK-7(r{-3F*;K
zk7<J#Ys!Qiod&oJk9T2yU`;tW$HG<_&KUmD7CaLutV4?KT@WDdm%_;o39gF@`b-AW
z(>s8lIpAxX_;ha+2!8)5e~R<o-rse~(fftvaU9L@q>#DZdj^)tIv97oE>*{Xp((0{
zo}PYlNSw=aeLBinSA#qLvTMe!lY{ab#%|f{nZUx|e%<dF6Nfxw?JF)6J{1%m3}_n6
zwIU4h=ygawc;jEu&(HWALW#{%nG`TH*m;FzAC)g#lrY!6s{6b>(w_kVE!o=F2z^b7
zIp`k56Yq`fsr=am5eSy$cl0&x%vo>1@i{sU{3k8-kH7zH*~>pr+^mLk4WLS*>j)=p
zoQBMPnr8v#Ut<l+THndB=!H}J5->NaEc71m<lql?v%WboJ!G^qG<4#!y9tZywGpwO
z{&u<p%&{kZo<&_JopbqiM-+gz(}utO^qc&OmxtXP2Jdog`XTn3a8fz?w~Bdk_DzYO
z1AjMMxvbQ>NL`=cHBT?)#d3n4zQ4a;g4O#RSm4Ua3Kr|0YwzP-`06a6uQO4(?gaz;
zUPE*e-1@u^g+K)e9VzSwG$>&O*GMbCL9{&l4uVAsi<_K+LY$E6jX0ml8MrmgSfq||
zm`scD2}&G06Y{;e_{*0X!}}m;-YHqc-^q8>I<JefitNus5v|KD?CH%@N-_C=FkWL%
zN$nto1K;1^*wB8Tvj~2wT306sIk?n!Yyz&|JPe^qJJ&<h$e{Ez!fYFQHPuz)arvg_
z&FC1fu>bQYotWL*h9G4;DxH33eGkC!YrvyleSYj=A|fN5mD^rx9-fulsJ$)d_hGDY
z6|G};d;H$?vw*#dz~5#9+e%5c5PK?s>NCaQVx}a7^=WX14lcQ;+W##JMec;?9G)g(
ziwU{RWV$PzqzAz8!vow!0Bd&>@B#9}J$lC2Hdy-c^9Fz3UV5P|p4163hQDHKzly#5
z(RS*S;v|!Op_a7o&r34^A^?3S8;=YxXAat`m9t<X-!iu`N;_*9c+5N`MHjiJX>?as
zNK3sKDNA{J8g2bS9re)PRUXKnISYaMF`JKMTC4X3&SL%=pYDI2j$!v6pEhJFyoTer
zf1DVM{BJ-tf3P1sE8})c5bU+Xm#x)%YZ*tw`44UxqfBw^s2#TGz(e}GQ9Qy_K1VJ_
z6Ma%PZOgIafUI?q$!K_=rU46V;&|=94P1t_c_C0C)CP|XL1L5<;N+YXxWkejCz#`C
zLfz*A_vI(w_axl65AF-e<EldK)@sAmmswd5)QUSHPAP_6J~{a{fgYU=0BDrJ-62S&
zs05m;v;XszbjHsP!Zz<4Y`M;Q`MycV1cgNV8`H-zJD>5$ULfD^MV%7_PzX2SGGr3g
z$8iX=lQvly_sf9_FLB2?D?Z@i4^`Gt$0k3fgRM@A`cJk&VcE83ol2<b72BE|CV^}i
zu@JzYWb>U3h7F^qH&4AH<h1tlgF|b)KDA>MpWi9|s<F#Lny*6PE7iZgB1<Wp@1af*
z<m7B&l&BBBgn0zf>o|&H15=YsUjsbbs9$-I@*(CrptgS+8yigltwD^OZ~qj|Po0r&
zBvoDqAdm5Dz~v6=S7sz^fhvKve-N0Yrw4y~eY=5HIhu0*@1ZzXDyJm01aa~b0JRIh
zdORfw!P6qn)v+U$f`&sh-EhdQcY!|NMPT`jo4QK*>CYG(N8x$WMuk9y68jm<7CjUv
zC+$ox_l%=IRR`>I=~T-(dU`>N#mX3=O*-&QMrHPYqLhj8AxRLN@2GCo<Tt1+zPj3~
zRirfSW75cF`*yFR`zWM_&^Md)FYU6`;BI1YHv{tBpsb3$R+rWFL5cQS`Cm!&$g@yv
zQBW`tnu$8ge@+#?a2CGsfcyoh31dGGaVI{(V&z7pIcIM9D>_cb+(v$ba@m=YwWldf
z0l}~7t~8OuLK~#5gDAA5jg4WkTb}8muvx<4mvnUnJ;o+r8!nam)ZXRwIig2RveQRr
z+9*_$Qk>_)E5I0&0aK!9xe3pN0xmpX*cK!cc>X7y)UVdbM{*60<TvfAqBESFxQ&@e
z=X0`0QD`RF<<_>1+ZjXJ(`xMh^jszF*DJt3N8JJK!;V53fYRT;PyKM?aQPn_fUv-=
zPG5(QlM;Q>N%Zlv1|`y*oRF@$Ajv8~>a9!3<W^9qMgF9#>jAOq9-O@o>Fk-%*$0?4
zjbO3ZT<=sHID1tL1Uv+EE*)cNkPnlF1pn*=JU2J#xedACxzDB>R-~v<#A<+Rmd=kI
z;^e%C`%2xcmf8&u>p}t%eOmCapP`E7B@7W!4~1$L6pWEg^DpDCTc^-nnIo0EdAzXo
z|3*gJ#XmtsJDk-&G4KKSN77-gqZ_8!B^oJ5Q=Gm(*#8D<qgYte@31BT(wcC8VkrF2
z*bkTH!#=GiSi(M0sH%~+P#Rs`XJtkvoPXbEipOjnqMV%Q$%tmgg1Ly}IP!{^8BhX-
z^#)0+mH);;S@@+f$f-UQ42Xe&Um4=;|N23SHU-5H7H}A+$(E-8Tp-HGMv#JhM&>1D
z1`57*ay~-EIs*3a2}VxvDg>M$Z0375SF~p;m87WrtqAw;Chb`UZvYiW7RsIFH79{u
zJe?%V%b=&ct#0t02sKIRnHB%T7aVH^9U8j4P|<eyN88wRpsXtCEN915fU)ThccyO}
ziUdoBvt#SDkiO%Q16eK@x9A{f^#l94*)rPsiR>eAnvn4tH%|qH^S*bD;AyXypYAim
zacDp|MAfLv-G@|t2T*d(vsX6oYkJ=3gp&5Vrvg}8>cu5?OaKp<)>Qx`D9R&t2>uyz
z!>lU%Z?hykk_6c<Dd89F<bPu*=x;h>kaPwWnBq=TbwQDt@Bj~H0%d(jXuYc^I)a}f
z_9YnzI!u-xLM#a??a!6m2!*2LB9^kN@$Tcb5G<BU#aOlcuM8odBYj$=B^Q}Jq{;|f
zut*MN6S-JVxF5$=6mVG_U=pMesJu@b{?YYB`gh^qNH#O@C&pjT6LLqR)JIe@3ZxI+
ze`1hi1W%>4=K%#DIkAVV$tAraLA0(YKJFwc*pnFNP5~Zjhevd*e>t(2jd0NBsi5kJ
zo<7kV7nY(D5Z^%^KrSFPnD^7<9fj|dt_95@2n%5wGASy8^!1qg%sk>Z0Y|@n9TvfV
zz!gvw(^FC!wfSB6J+0>9G0ph}uh#h6q|AE=bF!Sh)DO<gXT1pSV+DI>O13(h0IH1o
z;y^K!8G8yVUK6>Q1BDy_>|&e`<^gJM>m%8Tm3-2^;@f6NEO3S!2dSA<>u&8mI|omB
zj&ut1!LpPOECwfvEL3ZFiOBuWw*6)n7TkvWHC5Pui~ajQ3%mqyHNIG<RE{Mn|H00t
z3JNb1vI=05on(84Rc#p~&WeaOIMaqM_8X1LMw~mxr&|778+AY}X=mrLvXlx6z!jo+
zj>V$#pA1<kR27MSOu=y!a)-i=>KO(U!O?bGgo=yII8r1jlh#dfpEH0;uWD*a;O&rr
z_eyP3vZ}T=6lby#q_t3d*4$51Xoa{0Jl}1ISSaOyL&8V0KSNy_&L5x+F(aHrfNC6t
zixnZ9M2w|%?VqT*4QbmN5w|n*CuU+zjzgJbb|RJ$&ikG{r@6{(3Ni51y}2yS&kAth
zTR$SyGviuYS}sK}^>N`iUYLVXS+%;&_MM#RKrZJ0&+o!*R^OoThj89ygV1!-UFHZ|
z+|_LJ`E^p^Q0Kq*xPGx>={Pmp&ul}cAGwQOiJsoBRXJr)r36dk=Nrd?k*ZriDv-Nw
zk?6BmcW14m14@t5&P`gV^Q(otuK~SiyfZ9n3fNvbT9!A3?h;+m!jp9oz^;Yw-*1eR
z;OA)GWMxSv_%1%Y^KPyCPVsI?e02$=N<n*B!U>13H`|M|YlQTfNPfdgk4e%R&?wAb
zVV`RS8lhuCL;YAF`yg#4ifq6MJ&~qffADNyx$z!Ow1}2-{w=U}rEUXw1PS!~%)tc^
zyvF>8z5MF|=22F$-0e<kWyCj-k??VdeAeqPP-;TIB+`bNla)e(^JT=EN8<UgiCkz4
zB~~U<4*8#!+}V8!DO&rjS+IT-1Xp5w{OZ6^oAT0^9^iI`a}^>Vcyp_Vr(GDLpVveE
zFnBlSm5=SBn#D~!KzVa^FaC@+axi?LmdaFR<Z4Jvlx;yXfv3%Y2t@yaVj$}yM&$Fr
zLJyCMAo9f`!RZ74rh7Pvi`HP)#w2wE5t2J3wEMMF9nyx?C{!T#5_A2eTt|FLro&5&
zvplU;C#>zDQqj)xE*QvW<k1#D43xvz=keJp#}BP(yF8Q9j(*A6-iY{k%3o35_`YTO
z<|)%YNXw8hcoI>4#=ubh*J^?<|H5!I30IbHb=!!FUe6Ye3-8FLbbv4r!T(TOk^O;@
z+U4af#Pl<bY`$M&SDm9iR#k9Dd?D7=d^d}lJ?C8&D&)lMhWe~Z)CT}~TjvUd0UG>w
zqYT0RNpXhSQ*<{94qO%b^_1X7mk}?D%_g|pw*H(P?Mr@~+RQP$(W*qp&O%QR{qC?-
z_(JO=4bab`(mT7WVmn_u=hpFXqNcOoI>*A7Wo)1Cyj=hONz1Al;9@rwBM(r%Pur8#
zut$~H7;Y~mL>0gL1TnjI;O{FnBaDj?>IBHOK09mI%m312^vUy>=}sP0+mU;inp+*!
zqf)#S|H1_7Z?l-RkBE<ZVXF4+E+!BBpQWAf3`LUV#?0J?e=@mss*53duz9X6dv3b@
z*Rd7HC3Tm%4Sa>j1KW_I@@k*fVfU}Gt~x_bQ_p#F)f2Z(zQ%}D^z=g29DT{u9?&;p
z36i_2ZSmBW4N%YIY6t2Z+w}Re#oho%)!EV-i@%oKb^X&h9-J6wtgox^G+5HkPa{;5
z&I_sMuK#fj5#JCG#TSMEsOERy`tRGz14bK3h#8(rN>GlLKZTx_R-UHYM)hVqzeoJ|
z+k*_L@fG*RXhJSxE`l=^j^C9J%~};vli03pl-Zmc9Q-aT^z(xf`&9)6XwRs_rqTO6
zJ6#39yKo%(Ct6e1Xk!}R--VN(9!%Fk46pJC(>jUt)L@1U(eiK@RRO1Z-|O4Nr++nL
zboUT<N_?Wo&cCSQE-J65$J0H5PLj@Ie-#w`;I+5Pn(JEbTl6k&W@cqo&RP)Gjpw{;
zfP%qptIJGomNUM&^TKrVo0|%GIg!t!(pcT*OWmq+RzFjA?(P*+kP|sz54}i8@Q~(j
zD<#G_pA!y%5=Ton))S&f_oLrk@2|LyK1MzZ`y}GaFPiSkd%Do(rJ)(!4utGVqfKl3
zbPu>)GW3>|qp$G3rVCGL*;$Bi^&S*hdfV%=RuLsff`^xWW5S4BO1~8;v_L2MT_1M)
zsQB8mYONM2{LrDIJ#WDC$U7~ke7EODgfSt3VJy#FC4r(U`a`wN+h%8V0oDH#ZP(#|
zZQ4r0u1Of_Yn;ff#Cdj@{Y&v*P$Q`uksJ``M;vV|T03`(0A2#Gm=>?Uz7c!b5S7TO
z*{?6aSyHk3_xt*DbB=v=;=k~@^Y1FchsSUX{eBo89Eb88bQ*Z3&KO9EBZ3E_RXBgx
z8FI$b2ft(jQtA}v>sGm{aQ=s9dhqY@ZZoUU{6fjDqXqw<F_-DV&s3)=pUmCBJt%cz
z?AL!FG6b<RCHLeHt@hSr!>$K<x`5Hdwn_Nmy$po5qhchMX3i2436?8Mz0}Hjfckkd
z*{&)ef=O(rfuTOG%nu6*FoHkg4B3SAZNdS{HFoG2KgAld52bC-0P|Hij@l@zB8W>w
z5e-$b`6Big))y@S6tOQk`oL1hHuUYVD!HXOj^bN?0Ht@+BL`TvHSr7`XBm3};;G{$
zmYCs#;T{?D;U4NT4D|HW-g7VEoR8v`2zyJ!6bNasbRpWU!T%H8)8VS}hJ%opAO>f*
z*BG;(J{rvCas`ofh-<W*>IG($_4ZN-$}y;xgIc4#U?*TX+s-w_XLI|J)>S<yfKbK;
z(3sSnaiVtE*ZyUX1z^)EX}96hf_u;uiA+osax;o^U3o(DZqo_;r9SZ++bYBPoDC_|
z`GDy3^~H|g6ngaUr>JZ5mFNnnU4V$zu5P}ujlBHtsJ)ri{55sI&<bCnQ?v`cqM^I4
zgcH)v_Q?;K*W@nN^;;ycc`fEEp*~0V#t+1QA>a4yBegnDe0p>^7~F)*=g|Cq(sIl5
zCVtCStdogZD(dY8gD`&!WooI_$E%i8IWg|?fi_Zz`^`yo_xS3E%SWgS(z5=z1;XrW
zFX)KP0A*49$6Mc;-;eYhhu+nN>x0DrBjg{s+w`vxH(2nL`je*IvXhf7UYDf_V~I34
zR=_&<fhoENZHb2G`e&3N$S{r6K-@(sbIMrkBw`0ES7zsEdi*T){!?%0J+z_r;A?Nq
zK@qzh+CYsq9B3(jKU5i;9t~ukmjK!{w4hZ|szrKr4e?kt*?icVJsX=WPcPN;#><nm
zIx!hB&7J_5zZx~02=E*HNl%YF*7@B1jG#znp5j!o-Mm0Ij|nQDXE(aw*+ZxOuAxwf
z2&ZzFCDio1gPXNR1a715?w~&S^3j|GmZ@OYqZWxCo*gA}tmIndp)6(gbsKYvjun7v
zUeVGrKobD1w`WH&0qxCN=oSk%?hQjrTM6h5gvL>eiJm?ma(cJ*a0tRQW$MzmxxU-)
zJv@335c_VmMaF@r#k4;T<2L9+_6z|+y59x<eZDO)*~eC`qeM;W0kiG&w@f8iaGThM
z#HU&O>e}Z17jGfYA?yXztmVlMsJ4V|SIp*`lh%G(sQ*sTpX_S;Dr`oIciRPE5+C1|
z^e8AOL|3+e)9mN*-8<&!D(L>~WhXyBqo2`08G>%At}@_bXyFdf#%y3`^GdqTM^De7
z9@BS!UBe4(nwRn{c;evMk(+xmgriPVQmnl<s<{+{alS*&bAGiu?A|eJ*_{-_?yK3Q
zJJpO1AC*nVve-kysQn0cfLVLfZLuyFn~4Zz*cn0V0Yl))ZohrdAPi1<)8JOD^NX%q
zw@D?7-f^JH>%5?E-4RN?CgU8P>j7}7!~Ak9z;Ppw^>u|sJFvL11c~&N_(4sB2maiY
ze7@U}AaRhgx*y2DL)c~@1ozX)9FI13l0PhAt~s>PRAJh#qJnzVFV^@vukBSACk>BM
zVR8`rR*<G+7%;tV#v9HbqGy#ws(6}!h$zHB{gD4)o7r;8b3@ENI(HC^=!~J%$%P>V
z+#r!W8M1%_e|z{Rl07`>`WV{mv+@Ggaq0ede&e}SfjvgFQ)n41LMzWp=R}3>%_Q!{
zt?`BX+kB$2h{H#0tyguLLamU}^ta-_a3)mj;v5S@5J^?a&s)7Yxx;~wZ?^nPK)z{R
zM}$@_jS!wG9N#D_LqsQ4*+!39o)X05RnB{JZ+{0gbsV)KIX5o@ac{Zvl(4-%;h;c}
z|MShmx5b9$6@vjgy>m=2gH*=)WvWlK)|8%wz2KP9zutwqAtvoj`M7wual#Ja61SmR
zwl{7jJ!Fq{=~&Lw%|CkU<ijM{2t6V)C{~FrN_^rq?xnUoNaeGGMLqY%afG{}I#GwE
zw;drxr5@<zWAah{8t_+AsD)nbK+=fAuP{oGm4QM5L=#7?S!4U4XNTyrVWU;s`HI$F
zQ#j;V!zO8Cg69Bqb@;e1D*HtD55uPtw#Rqxl)771>Xh=&3|<?`%*AuDC9En`7C-Rl
zNWEWKlM9goewD2zJlT7^rc%zLSN5y#9AC4?hqMGaRkIzQcH%!Ha|=~*t{K#Wpa!I%
z&|rtW%ERuxcC&-4O<~yE+6AROo+%|3C(S@#b%=)!z@Xpz*d4*!YACq;C`M!<N3Yv`
z@8Qg#cCgrF24?V5g;9|tzzNF+sfs0B50h{(FdSy3=0C7YU0Zt}A?$RvRv*d5n_bN`
ze)8(dHepxYKxDbTkmFO0OLN$$d}y#AKH5*Yyi(7@4v&l3>~d0FF=UlkWX02oi=l!9
zwYpndjsI$umVxX>k4oI#O*M51w~i+bDE!R2RDotfSz_3?iR+@eA<2R?k3b=(Te26J
zqLOq_li@E?AJ+5n0oO_B1}FehMRFl9q3}kyw&wU0atuh1ygF`xW3JXiIx-r!D1kPv
z-ZuVN_3#_hz!Bc{)qy#E>QT@JE!cmzscY0iDaw6)y++|?dxLUx+)ZhGLt5!tqjKbE
zDBCw$Y~t?LyjX_CW{OH?L}cc$ZI>+ZndRvgkDdyZ;#s-8q`%;`CKuiY3?gED2i_`|
z;8$|Cn!5()hN4B&Z!M#eMxu8r$w+yGQzQe}Cpa?yS<oEv)k83k0lbRXx5!?!Pf(r=
zVMe4NQd<_N=R(^!TUvB)*THfr9&Gi__T-?$PPS;5r}!jThS+M{p^g^R!A13K;ZCaU
zV*Di`AnCz03s<ik7TH;2e>s*OZNRwX_w(+2egm7s<P3MiOnSm|XI;i*6{D#W7csId
zoAIMX!?RT3_Q2J5?5BaSIsROz9<lXT0b1%Anv%=QEWWchB<$+_CI@el9w8RU0iKwH
zJ(X2DrPTwg0H)1Q7e1;Qrw5tNeBe6u;4CyR4ZONjL-b6^Ftyv(DPIT#LBZ*XUMFo_
z9-=HG2URm-GC`|U{7J46<%g{aoenB2&yY91JLDbH0hf~Eq&&x;HsAgC@~1&I2LC*k
z-Mv(+#C}XfnWnWWk7L+pb4ghy2#E3dr>*190(WYMy?nB@DStvbxWi~(y4iA0!oVX*
zWV<A1+hHy5gTuVrBj5((^n4WAQ>tCN0<FX2<KvHOB2Fz*iwW_s%Oes}=uEid-MyV9
z><Lz%yaCKFk9~|LN|QR~l){*1HYGmUjF5VNKqg|2Rj))ALk{(>LugOxMyaP`m5dka
z6a%?$T{Z9_N6g`egW%H4)Z4Et-(CQDj}EjJdc!(qP1qSB_AHjI8FJ%Op%xTMt~gdy
zybbS!cm6bQ_C3v6ymweBRQl8&R4`wxF<)(HXU9tl*x<pxxs6Csu{qoc7PoPB{xX=`
zxMMD}dj~}uPELN@moPn-n7i*sAJ>gOW@QPaqRnu@-UTLgU2B9*lH8=UoZ>0g9FWF}
zf=4uVM?!N)aYVYR!)UPIEtv47G=-gBBx5=dkjAM82f>DA;}3!X{3sl}EN`zQv}Ngm
zHft(GB2ziq#4aN8SVT_35sT1@q?W`Ad=K;36OYz;`-hKhEJPQt0p2QIPn$b0kthef
zB3|lo+p3xJEr7;}?rY23FTI~W!PoSQRBsgJa^b}~vJBQ;y_f44mgiRm>I+(HPBgGd
zo#)@#OjO*c*;SeFVvCo6Zk^}mEPaEo#hnf=(XxGy*^gIwxr7~6WI5_JUp>fgsKS2w
zHfr=D&{k^R!PmVfZOg+yY>7R2&w6?k%GElk7L_5Uekk_&*_W(8GBS=r>-=RP*&f<h
z1lpV(z`QRxzyy8FA0PyL%-SJJ3)NWBa9G7F7l1ZMf)Phx#b#%th77<3#FpIq@R3Wa
z_*LHv^sjj*DcwpnMZb7Vw>JO>w`5T_B5{;|+fv~HzGC`?OiNg_k*^5K@i*s6r_*IZ
z13g{UaSoaw2I&;E-Z-_q+>l6oct8Ceqg`BRVgo2bjvr#EVPW^%wNy~JQMob_!C$0I
z^mBWt4|12}9Oea;QXfjVMoM2h0~Nad?r1*s7!vH5s!M8_`oFq@iv6y3ZbeW@#?Fk~
z(Cj5!a&;l-u=$i3_Nk7(ZpwLroD`|G#C>B!poki;`nV3qLAW6?QqT|p)(#?zqxU{*
zKvWm>u2qH(2S6o>Z{t1y5!~mWq>ruFRJNZTeN^GM{xtZoux5-eAy9C9uOGg-Bt3$C
z(do-dC%JWPcf*aY4&{>_f|FGT*Ci~3+t5UV=heRvfL~+_q-JBQ@>&m0ene;6MMzke
zyQm9vY$X(*TH3kDXN<S64}x+*4g2cF8=!$vlx5AoLYb{-G=)d4^s!t&eQS=#=E=}!
zG#9>f`&hv($O7GB*iOJCTQeS0(1J=E3wPfL6Q~Cw?zmm$wl=7vPPd3#-#84Yy!6M4
z^*EkRI+)$q-qO3sM@>P2#nV19rODdfYd&9z#kcQ+!}JFqW~tgdJ^=4g0E~c~-v0JL
zZkEJ=n<!PsIqz%Jq?Jgq1BM*51klXlGXN&<2Jkn~Ds){w;DUPqQR#%!fU-lcfL+Mc
zq|~3$hPx3b?6>YJkK9U@_^wX?g!pb<7w=;uSGm($L{Hzo@ZJujKY{%qR;z7}$PJxJ
z*!8)Aq=P&0cU8+j20=?9(vVaX<ni$Wqs!v{zDF(}ooe%&=VrJ7#e#*bF2ff#l?{s(
zbs7Jjy4UrYei`9Wz(#fNCU_AHji|0u6ujS7G7eN)9dbgD@4~&SeQZ0-L}E6|#F6OY
ziBAo>*`rya?8*d4k`QR-woALsz3+qK1@Y5=vwE%NVX?pfpMX@u{3G_*=%bh1#;gKR
zBZ8=a+hI3fsgBKS{@=BQOBqdj_;kL-go_W+RqIJie4!dbJE%p2#UA6;K|RF3U4XKN
z-ZV5V`4cV(0>-8B#LxR}N1qUJR4@=39dn;urZycrMqoqqU&T_jS4YV($ENGnU7*Yr
zp8{*B`YNA{S|3Bz)R=b?+Tn|S-$zqa_UV-hHN-KYrUg{fl7dSw6n7F(+=c{#`j)lq
zQ&KFV>eZJ+*`!N#a~<u$1S0rf)j@+LtwWQ9C!<u80<=>B#R8a28@tyuvOffsM6j~g
z(CjyztwLN~g!d9EyU`_`)c2%)eHvQPUSF+{+Pr~t==uWnn&zIknYLXZx^%cEsai7o
z5-aJk@+0M`f7;4~fS-8vTB<-@kf`=mZS9v}v%oF=R%o)bxEgYYu=n`p&*5@thW#lY
z%F>oHG6H5Vwleq_DXml3uf}^%@Y<Nx;|or4j=jg%Fn*)$lbH$EJM41=b6t6psGg0L
z0qdDX)gQ5cF1fS4KV%VPztFw{%}28u*C}YM+$I@&-!VkOqP9M8BVg@!N>4)r{&)^J
zA6eu8j5~C&q3e@EDxq9a!P>!?9uHkh5So~~^0ZC!@6Ciku$=D#Q1HKecvc0r)Drc9
z!EPX1zl{GwxEyQ^sj^T2+Bo&UfBX&Xd9aM1fkF&?I0VEy3javeemM*)=py$g<>8{%
z(7;vy>U9RK7I-_u3AV8szqKdOJBOXPMdAY1PqxWsc0*xhTfH|+IzscHeZTes>YCTk
zu9$H|O_-!N<Z>KzF4=kjb$Kj;@Vmtl5&YDc(aSFLM_`LUS1>bWbgi5P`b}rZ9JUT@
zpC<!htpTDWRCCL_yI0|f3hko}y+OBx7#8Ru(?ercl@#kxFB7v40jG{@90}imd%X9>
zCh4XNAQvnawLrn$;HI!5ayzOE_FJKL`X)C*(s1ZQhxkKKqZrhJn!ul-x)k+Zw<AG_
zfQ6N%C6l_)4Et$**7*947m>HV0nkgdv$*V`OOCZ}q&_<hON1bL^j}>`S<2nqVw-~T
z=-aly$?srWV?-oC(0BYT*am8zVzDlB!|LTMSZJAJE|WP{C}sx{nTCWWoW(6CgkmU#
zqi&8!@pGOpQ8jOe1(8JU#0F+OQkbA8|2<G#cAO-d`wDd}^dN=dfdBeWWAQC9J0ml>
zdx09m@{M*#hS+acf@}i4L1-dj$Rdp*5c){i1Gm8Zbsv)|Y)NDPn_L0?f1SlOP(V6E
zX55Zo{Nqvoz!bIX?#-FBT#YtF{nV7E{d(8{N*p--p!G0n1xNkoTL7MAX&_{XEtWZf
zHuSvyo?`Iji7Zr3&b;$Kp42KQ1%g6g?ckIpfIbZ&>n+agr_nf6<>~xXyud<%+}lo8
zmytliANZpAB8b*Nhl~Hz)Yu58O>Ec(lGp)NXm&>-i-V4^48m&k^t~e&xq#{l(0wag
zRb=y$m1K*_G|1E>zz}Ij)k+e&D>Y(1p((7h$PFOnf?}etE3_O26UJn#oWIPm(CZVV
z18#s;h5Q{83%DH{dcsK={GEyO-2iTbZ>Gl`gHr8&nL&~o)tZbjC#Uq*bTXWgUMF?H
zBhqo^3Bk?OftEs5c^I_RgMffR9aW^FJ<RTK3*FV9R)ZJfxW0lymOeqQBULsYB9A;t
z!_vnXK-G5@9tCk$h;Y$d+=uvZgiQpIJ`IEw#fL@n<Uv0Ujsk@54LBPHXwx4fS)Rn|
zugMaOGO?NlCg$xtr6j0?fg~~UF0l3mDnH)&1&9=Y;u}4s2Jk!eP=Z={T(F?YGze9;
zHV+Z?5GQ9GGbnwIWE>)yN<4@U6>ov67!fQ^iQZ=*aHUrPHz9x+l#Oj%Z?Z)g<tYgX
z31V0K;<IN#AG|2V2}((?wqb(?$dQ#EBpCa_n@v&mN-QPrd>e-Ta7U;*G}5L4=yjA(
z2)_;rh(kt_9?BZd&wc85VI+;p6Cyui2k26hM38%-jRMjFMXbHzVvaprNzpHbXyJ!=
zKmh4JuCfGqnjf-<dZk568V|c-KyhkfK@QpqAY{4&6a#Afp<4&Dt@{;(K2^D%Tv=JU
zvNdeEsl(W{PcIEdAGVj`wdL7=D<%n=@=l@gK9fuY5FisZ5@@FVFyIM9;Q*z-BI#2U
zc~bw!LA{GzfD5CX4^klY4?^n{pnB9GooaY^2jp(1e#lD^{QEA3O8=hynCJ%YL&5VN
z=|c+{<U#)A?mk6!H0XOXsy1+X9bBLSA}Y}+80G&<xMbo5+SgYD_svMk3nZjc&YxI&
z1>A5UEqO~pj>wn=LKe6}NLFPfsVxui<UR}NfTaIp0f&1^)N=s=t@p&DB`VkXjeyRT
z`~T;Im(XAZaXbpN7nsw~J@){;^}MeM7<_#@^{WYz=nfhDXA?xX(9=Jh>wzn^T?0X^
zi}@_*X8(0Q_sjw0RNLh9QcT)+v9Ef^8$@wP8i#~us6huqR{fv8YWBgX2Z-{~xX1ez
z*eI%|W=oyzDPre@8e@W*etwI@eiCs3W~2pVJVEMcX!8RQ0OA&OEN$<5Dpz~qqCfzk
z#e(Q>f-D0ees&+84uU@Fje^3AatFpXAlgB757CZM1=M)toCa~{*(lQP!LW)zrFi6Z
z&^YdEeu2t897~tb%q<R65WPB*Gc1_mMFZd&Q0JbWKC`#-C1fQ^T|k=jNREl5&=BC!
zTFl660r3ZhO3`Pt6qLjcqv7Z{K95BkgQn_LAT>z9?@Pkbk+kpr0}$uUO`w5>#b!6H
z=-D#I)<CvIIR<g3wX(Eb3b1f;m@bCk#|YkKQD%dYL!w{sbR`JaMCXJxfC$ZuEI{Fd
zHJssz8uW!qDV+a6-&G<bPHz$K0Of&f!7ESzlI35}K5M%X%p}f9lBU98K$!08L>wp}
z1VBA7Is$6TSQ=O~=w0Cq{map!k%k1#RKVAu1p>InvmCG&d>-n4;Ql0L9FzJ%!bw(T
zW*mYADWaA<kZ3oSK<@zGxD0v<L8OPJr-urk7kvZlk1YBmYQhu|`9{hgQ0bpGq}5OY
zeJiQ=C|dvuWAf~n1^}D3uc*`koe`+Sl8H#kUr$e81Eb9&3=PRxvW^dj)@}}Hj7|#Y
z4&t;Tq&7e;RaiqXtEn~*Y9ht5lO7ZYVkvVBDFd^Ok+<eMtOOeLACW<jv^Yuqu=5_|
zofm)yeT3Rw5IX_4tf<xi1T*1=>9AnbXrrgsQ7t_SKF?+Nr?A(5G`JO4AmqIviX5>>
zib9n4Htl<h8YfNyrI6H!OdgsV3s0(RqdvJxvd?)QxL+DXb}jxg9}xJQFQZ|cMm;!C
z9YFuY77=A|pnOoTy-+8jdlMZ{6bZS4Ko`*#a2!82&~b$O6GYI+7_f#43cHSts!@H9
z6qD$#Op>e`^E=vMRhUvk&<a&~M0qR=2Pf)75C_eO11(^l(I6?mHxu~GgA^Q?f<SBO
zR3^SKHaV9ILpDeQ2bFLFeClo0cF!#8#ges8#9^4fkE?>DnUuEMo`K09K=w`2y&~$X
z621fSLG2mDIczhiL1si+AmC-uC3&U;pD~he91EjAM^OK2LV67K-$0ZZ!GBOM(uUdr
z38{LGTr5ErnhA2)cjRvb!Z$cdMm*&wOj=${8JJw4j{O|0Tfj^0fC@oSK0hK#=5^a<
z;WkjjAaAJWY@^`2hJf6MIA~6S$oO9vFdIV@2SO*<>_9PCL%AHwHLUdSzi@RvoWUWa
z>_(8+GEjWu&&Q8SkhTfn8ajUB{K9>&hw@b5L*#)Y;RA5g0ceEc<ttC<o*kZ)r9?_~
z*4utZ5n3ZhgBT$%Mbz6%QK8%eaXNV#Cg~iyW6{F9K`?aK3nXE4)@{o|CxE86kW7ix
zHj-R<Uq}=IrtTXAcN`_znXm}l`~%o+U9N3~IH@c~;x_*B`B=a!>g9#OsNRgT?_fl~
zccd0#kXjz0R-_6bw(Qee5b#0bbuq%ngOLR{EmSLb`56i0#CWmd&)P-}`qxVkX<%O|
zW~YAXI%UVbCc1k~q16CAeq_^7;%Zk3{{*v5h}pbBn)g7cqaf{Dq_Zwx&x>(>q|uLT
zK+>tZ@>Gf?FsuvZwQ{shHiXwKXse(`ScjDiQrtOxeZ#2lrt-gmEX=;O56(Cf@(@E3
zOkpG)>xYPiddL$p*Xbbm<y5YH)D|tU-I>z3+sGH8zy4j@wBPkeJ|u<6DQSp=NPr}k
zVw_0SpO!&;@4uroodk6Mt-UWJ)-Hsq(^r#_dQzLf0yZ21kOmnS?kLRRneQ;Zpr=R7
zCve;kmW398-W*35XmQ6tP<|6yd5j2i1GQQ|q_k+a-1_Pq8gcA8XHkc=4&*U2R0SlE
zrE)M7h`5L8?*YFC5{3KUx1cUCjOl7wp&470Dxi;ZmQqah1}y9~-E5#LNzU$X2%sdp
zYokC2n65fA2IC`8I;fNvQk6igf{8UGxz=hC9&*)QEDoeW!%%bFMhVVe`09}^4YUEn
zqZ~w*t@^=L)E`25rrQXK)EzW(7aiW0R5K#DH9tS^N%s>BXDmWpIz(L>uY~HEEbr9?
zs~RNJLq$1b)nD!^+-<U^FpB#jjikYNpMz!>7h&Y5gGx-V!(YvXQVhXS2;+z~81NE>
zP~4uL$VwkIWP5gyKVOP8&hklZqy`=UYQ`{Nfa+kZdePn_{R+yjAQc)YBcY35Q`sxt
z%F31@z1FllFG>JV2p{vY=Y{DrlC$K^{l?_~-v&<dRt$ig78@^&Fa<c$Z2M$1s4B6f
zDiK<jg3ySOFudj6G9;tPFDDHgrxul0Mip2u(g8yaAHIx4BkRo1P`eMte%aY=&i)$B
zy)oEYQC%Fr;Q4*uNF!FNNg1{Rn39qXYG%Nu$cbn`^qQgh&0npyhtcblk~eoU^(A1k
zmIvmV(A;TCvusu~MN2XAVia~zPJ=PZ3HGhISEVV!Es|4zqaq*8pBsO3bqe%T0$%a?
z^Qd}1ypC=pz9F;ozqneVxxyDmFdPSQNz#2sNZ}L%@6nJwb}W!{Q|;x8jj$ic<j{l@
znoYRuHY~dAcSHb69kknt#>Q-*DOd5b*=mz>fc{;t$Csbrss^5QE>uplmOFBBXnJ^g
z<Y+8+02PQ;X9L$soQCWtP{F%efzSl83NbrBgtVf>7Rlqm2+yGwU9!LzL-0M+vf5p@
zvxb4(R;?HR_CbxL7%FxKhKL=bsf>$RgD=F~_DW!;QBDfD@rn+&Q&}u2igpp>4iA#O
z@IZt6-kj`p&<~)gg#4YwimTC;cur0<V^Xvi8pQSd6enuiqVn?&bQoC|84U&9g<y<t
zZcR$0-&bP{sEWqv)cS~GsC9u<Z0De*QG|P?&`pXgAGMPvZyO8TtqNxG>SNvZnEc{u
z>>mf7m*{|G4fA(?Km2m-4YN0Vhc^nS*Js(#(b%~*+jaHl0X{+F)|!h~(S(%)B>0dG
zpXP2fk-A=T;|VrfCh^Nr0a5HH{-YR<&Y3_>@-Xf)bPZ`xrG~~kp#rpyQ`KWW7APfE
z!G6McsY|f@#{z@b!g|q}k;k6UwiDf(-yorcV6xyGpJzH(@WOMmu+eAmF;D=ISl?L4
z2STH@tesk)grz9ZG<4f(NWoCTd8aRZX=!QcV+?Vc+&j4#<7ubxPio02AIk+SR;50X
zAz6vhISqzj+d8HL`AEue3RSS=q^M%{N{|K-r@lhUhuqT8_-*2duf@a-!$3V@kV|})
z1Op@umM=8HKth`V(ukCW4Y8wKfW@N5{7-uBI<zYY_N*{<qcj3U$D=T@b2k0U@KL)X
z)Jc&r4NascF;?0bij2poLlN{u6ahb&sF!ylPss6EEzN_OA|f(vSSZ_3(U#nWBF!Bs
z9WsAN_4&bnEeQs6Oc)S=K^h`0+G*0PAPbP!=2C4aZz4%AQfEaH6;uBeTP5}OLHdP}
zD`bsmoQOi$f0oJ_p_uegX+bda0^NB5BbdcQ0#!8AL{yLsQ_v~{-kl`X4-`xQZ)7Pw
zSF^j9`;Mw>E#?}&x~DPqp0fHFpfea4zeRp)g%*_^32s7@vT`5GpTJl(N02sE_;di3
zzoG_t=<h2?Qwsav((7AzZh%k?&1arr?|XBibQ_J#*ENb}X4}B<>%Ce*C6TB7g@p!y
zAuCBCQda&5h5~aRY<3y<?iiZ;(0qZ{eFbs--(HWJY2WXA?fK)w`Mtf>OyUaz-PRXU
z!9cHHR~bi|*sE9B8-V=^`RFp|hWmCZRGbHubIIn-9p!*>$dwHRnxJX>2cliR?YA8y
z4ni_-R@$5gxsV2cU8?-lI|8p!FpHWAMRRRbwA1WJQSeJ<=X+iQxXi*Eq(WQ+2ug~B
zFif5AczlK^@5^|%>Fz_SfPi%>bS$<;q)4@4#xXc5Dbi7yD8bu6F5ano*FU)Pqtma}
z$au#pa&_G>f%#&HEG2mYN7fq6^HTKX1DTo08YB4WFaI7{Qu^;9+AunF`1!w(7NieQ
z{LhPv&_?_}f8A1{a=CxhJqUeJ{WBxmBZ`t(C@}O1o|6wj=Ov;Xjo!-u!u-h297Ckn
z{Pl(xL_(#gSkeFLeYVFTz>R2u7?4dur;haVY##z|F!Wj1c9N1fz%d~Vh533RgaiW+
z*Py9t4}MW@?ogS<Y0{J)HAVA4cF71MJ^iQ0Y>d>KGx5&i#EWSphh6%s4rFL2ct^Y?
zAmBoR0wEo!9z=+fS54MYzcI~@lB=f-$-NIV>9x?O4graE1V0Uh-an>_38*9|Y|U>i
zVoibYC0^HxFY<bwia^buo2rRgj1SPj;}x3qpD>Alu`Q+%IxOudE4lo6>E2gM?n6T4
z=Q^Sbee3&e@7=$bY@&X!qCzcHY}fShi39YQj6fKXXuKc~e_s!8TVWwiY8)VaQ})r9
z#>SwRXN-@INcqlPuLZ%y2_pM#r45V!{z{2G44ZxT5quzm{MZx}_w%x{vcxvy3OHe-
zpcrZZnZH_jiuu)~S5atq6pg7sL&B*g2tEgswWK?7d@?gLtE=S|fSL=GiEz2*AX#}n
zK4_#WD1hWap!|mmOu>>LDE0~E2EiOg=V5pP)G{eemY}4zvV_+I0ZVm`J03*a<WCBp
zf@fd;HXa7og{g(-aNS3;@~jgs!vZsZl0Snnr(GPB00u=0Z_tq{%)FnbNSH{QVFruQ
zOd{#0?dyEWk~DN|05r_pilqs7bQxYM17l#QLO?&UFG5*2)XM)cPgm_YAS?>^g_%K+
zQV2bV*Qr6gyy+3wY1{g_rA4j$yz6UtCsJb*p<=~7H`k}=1HmxqTs0-S2+ZKYZy9nP
z9v%v{{0ELmZ?CZnZYVKmvKc$fJVd9MVi&@S-e|GfV0^reiwhdHAk=s0{9(<s>jjsT
zSl9#ww$!+Vs8RIV0$fv85n?<PF*Yf;-fT4mMS`eK<)$7^H|tIr&%*jpT%1^j&gQi1
z`#pyr?@w_OXDibJQg6K}T`xA)dc^4H<Tw`8#BcRH^5|vPK8c*twU4Fi8xp|j5h?07
z7N$Rz8_wWQz%4i&h;M8=qHpm-20y>LT+tskzvcsLBno>#+~ct6BZS_#gl30LL4`cX
zlk~9E4u`jti_*7^>C5;Kc`}fyUSesFFTs1ZADVBV+-w)AQE^^!mF);art;@HSUP%|
zlq%5H#cc#Sh&*C^y9)1zL7x?LSZTg_OD}dU`}EjU3I1XzqlY619e<>#^qU=G5O{O=
zIFKqoh6<2CN|7+^)GE#kuu8|nyR+3UcW4%!q#iFXdShIh73@HaV?!6xbMxeCJ>YZb
zJ4vksaszmQOL6`lo^C9WuxlYH121FBK8xm@r^0H^+m_wE7jf9%B78Q%*a;nb^-KXz
zSOp+A(36!bS4;2$)!;cC25-s94Z&vf2JEi%ZX&OXTQh~w<zGvDTV0!#7K8cc<}Xhq
z(uP=ACFTt$@W-Ye9cDUlm02bfoFnqm%bL=Z(>c|PX~?6CV;8vfI^O=JF0<nea8;9y
zuvW<~0%~rr5=vwVyq_*UHPT};^|SXZs(Ff@jj7KO_R?S5a&(MK>*Hb2C?BEQ-5A!R
z;c%PJbBps^>|YLq0U`-wgIj;1t9F$1-k09Bhc^ufW8u{dXs06^P;t2UjTW<VnIAXf
zVc8($Cn_<cglzZ;C^O)<Y_<0Ku<@S3r5h5PaJeUf>G1|r)*<2xKepxzT06C^h`QXh
zpC|tXb=F$;qNcK?<@0EQTjZ*j&q8LA5e(IQ@TxFS;)x7GWhW?Fzco5}Efwhil(c?k
zamUDr%@4Oamp^D*QRlm}czXdawNcC75$XpUJiE)vm72KFQ4rk6^qkTAhks*U^XurS
z`Zvi+Mdda(V09e8^r1b#z<5t8>(u0rT1#%f+~MAx(HH4DR7|L30rGfj%Madn(!G5d
zZGFB>dD6;OkcvPsSm~v$sm7)z&}W&aKfF*Z3IYkDfg}!BAr~s_J<e}*i|fd((U^Z{
zUOfY;hu*@@tv8yI$SvAVg{9l9=2h`~?9`=L=VUl^2QOI1ZYR23ZJ_mPs7y~#)%UnN
z*jt=E;a0$|ywfs})1m<n8z!~<xDf0VIrsFa{9B)>ZgH2jjKXetwge&3oXYtzy>7Jc
ze89q^?Y|BoBr;$ZjJ!atV7eqaKAu&Gu$uGPvc!Tj^J11CAy99`OEqxm*zu~uLPrh!
zM&d|c(x3pUE3-@RJYdsW<6Z#G*iHSM<%aCPX*pnOs$Fmi51&SB9u(4?igzPKxq5>q
zGq369+$npzVr0E~zT$^VD0(iCw?S{eb!;p#A$pnD7uG|3vl+l<Ee}AxmJMa%;toGb
z!ulrWdJ6xRHN{QI5Ogy)4IQ^dA_IR6GQp9dkhDCi#5|T7P0%!}`$r|W^3r12YH_0t
z-NvwW?g{t^7F!tk8&6J=5E2Au=2pBJ&|*X<H&8TKFfeE2_NjHYkngk1UcTky%xe#p
zQlpKPC8QlqnrrB4cGs)4tcEspefL0ow!)jM?J*o}<YAM2g$5L8l6=9-llqx+EYq-X
z|4DfJ1u_-053i#;Lg{9^eWJB3F#JaP#g&cUJzXg0rV_nei+IltiQ@OR`a^or+><S}
zrmyXe96q*KajVX6NSEuYh9N6*K?A?lY)cV>?Z&D03Y}KH?BmPt<q0K@AL-O&xE|3k
zYI;-x*pA(R#q8alNOW>?v>G}-w$Qz#S++E*{S3rIU%G9Vmgl?(La-Mb@xDr}Y~MOU
z3Ga5H-vNu&ix=QFgx@Jn&*aI|LN+oi2LI^ZN~i%*(ZI4>n2hV=5B_nk3->xiqLpmb
z)F#TH@V}~TIm6$*y)o-%b?hy0(PMQ|Zo_Ok2A+2Zwq+z&4YI2<IfDgPWtM`#iHRX;
zyT*p{JnXv4p*t+w3!khjHyRSX!(Ao84<rsV-?y-6D4U8q1~FoAQlhtkBzD|cs8AnR
zE`EjLH-;~(4Sti&e7DkE0-Bl+HZog=@tZPR7Z%)soEVweDJUoy4?QQ^5bHJ^Qnfk2
zTaD}9$OjSA(yjQK>P?x>P`lE_w@f<vAapfBuZi&$^_mMhgd*J(e)_RU&g&!jE@qEn
zi}#;1h-S+ZGa=aZxPNmS#_JC(Lljt8!y{l&z?}Q^m|Z1f#X_+@O7H)!*63T$&kI2X
zqRaRd#?+sLcXa4|L-a%8Ur>P}`|bCw2&AM#0-D%b)NEVW3P0G}RXTPBdG9kh%4CSU
zZ?hg~=zxk!OWPu2;rJg=!Ce_x?rfDd&TZAQ*s;F?dBke>t7!G`xrMFSIor3(x|5(h
zl&7Kzmfu+q0UQwuyc<(Z`Zw2Ck5^U*Io&?s(y}U00>V$W?2?gGC+fqF?Jh@O1viiI
zCTs*QLmbzbYqgcxs=-?w?f%mI<&735X|15OBNT894AyvVOh>sIET4CCQ3+kJsbOt|
zt+i>JLsw3Nx6XlyA8wDK>_LqlfNl#04$8^~;E(zC%i(7Swj3gc^+B%`{5pia7w0#q
z2YHdHX6dsXyHRF&@yOpPX?#2|to*|zXG1qZX73#c#S73N%eB;7Avj6!pCl0sj4H!j
z+MXj9Md8Jx67r~(2=?0$On5i&iQWia6{tMFunXpb@<x^<8~FGM7#t8QZI!DitW!`$
zu)uxgjRo@pj(VQZtXE~X!*|VUF5yi{-S)VE%8oazdB|rZxN$tlq93}};9vPw-&_Z?
z+Y{*E*22_8fKte_FtG5#b+^@TPY6!&22e>b{ZUfq1mg#vE`XOuY3KO=L^%ssYmsZ;
z$6Ip=Tr-1q8c+iR&u@#8uvVtUHiDI=p=`&Y#oLRM*cfz6EF5o@A#lzNf-Cx;F>69n
zTD?eH>iI<1p$@76>kh75Ct`Z7Jyr9RIj4dL&_~Iq%{_<)2;<di^$wdHdT8bRD+{j;
zjWp2o8Xg04Ec>)6z1>ydu=g+;(%SCNWE$m>i|CQgk?_jfwfT0w1^0=Uc91Zwx)zQx
z>4SmC%S1rff4nirjDAf_OrWqfF3>cR;aU`c7(aN)q+~t3b|tXeyDpWX9?bWsk1Y)s
z;FJa39C(!s2v@m`Jh#=giVM+8l5UilS{Zos*NGUp?Ic>;l(fSN{G&epfnL;G$TKJ~
zjv#|T)ovrdaS61^bILa!xqGcksQRiy^LnXciuWT83YL<hOYNm&9fvY2ry#{4AM^BU
z*x)s-TwNTA-4z#k2-ZJ6yx=cJ7%CWlrAuHGHE`34+&u4TY5AAUZfU*s!ffj?xMi#a
zDd<H)DY3P<+>jPuVTa2y9KJOQdAR{z@jwJxU{r<LlszJE7F<uzu+pM{vHN}P_S-nZ
z+(=K)PAsd0>oo~}{Cojbc3CxX-lY`u4RX1DknffwoLX}neVZkg&iKs19iJ@|Upb6%
zLExZp+|V#}6oPY#P4`cuyLj^+_R?=WR7LBP`gWpQLQD{>5jMA++S}N~Q8N`AGa|L6
zo47*9iR;&yr7?mlTc(-+V62X6Z)4<d4lECQEkw?LLb>J)yx#>y$Ikpu!&>H(Bc40)
z$PF(W&%xb5Qf~Cpb&)zf@lS*fr>rLm2Za{gzu`8m*YP3;&H_En0BH9~;>bo*>FfZr
zRh3IE<A_YE_R?TasJ7U2-`yoN3qDXb@aP)iauRmTYpt82M7RF<<1wqF{lGGAQzj!n
zD#*eEjI9T!%jUF}S2*tKwWvF8F--XWsc<~kx5y`OSOS)KA4Jsfn_lWuKTo3{lRr}8
zE1)<Se`{@*(VgT0(2ax^;9rRN%18t}J-vGk@Va}h{Wmph7&jv5j=LP{%?{JIs}TYy
zB8<Rv$?!%dla3Mu4+nte>Jq(>D|wa%_ZVSHF?Z=_Y&2o#p=ARqflWC$pdbe4f6ATc
zc`2u2)WTuxoD8-^r{;F<lzu$;KHoxV24-AsgfRM;nI~}q1sCG-3U(nezi?gj$JgkZ
z+VGCtF!nGd7GsOd@I<kc<Oc&&jB%ex)oRIwddb&)am)SZW>`J!mlD8RUh1sdZ#2Os
z#fFXWYH`b-R>yh<JE`A5-X4RX1WHZqs=3R1rOBP4e#`7`+7i>oxAd4Sc7ImF<NHKv
zeAo!x-JsW6T;2?muI{|>!KZU6Y%Dyy&}n2#G2JT1XUjG5Wzna7dq4_wYS*KDgsMIO
zqd6ORNH3_~v2-Dp$8Hiy!>w*!BRKQk!twY67deZm=!@y%Z^U`8(k`6@5u!z6?z<pG
z)xoC#@Y24yLAk%!v4osRSP4zbQkZzPHhT#}QH<d#caz|-C2WUiY3rg}jx_tGsP(@6
zT?o|iB`PBE&SM8HNAPfjVt%`3s98jmdbdjNNTNs)8TbwHcT)*Y+HroPW)hX=unDN>
z8eiNo*G$;?Hm@{>oE{aPpiphtx8o;-C~rG>%^OMz6HGE<_~%wj3*SM&{sq9Wm+L9T
zcx{hg@rgIAVek7InwN=Ohqo!z_OTltLA3~o1c}!g_Sm$u+$>!XN^ovIR<Y(?5)EV!
z*q^3vF9Zb6$m<IiB%eh_9*Z_`_cZ{7$kUn)2V1{4{db|o_V$!<?JNL}s{(x48@fG(
zTwja{#g`Vgetx30Y}-LmeNvVL2D2f{k8RexJifU%WtYk7ofERe=J#Ot=hsfqczH$7
z0kfX-r!;Keo8n@4)KYkP&FjkD8tcl%&yY28whiCX*hxY_w|w=_0v@6fB5ZVakchNn
z|2~l!@X@UWpWEZOmwx{qkLxS1s>iYRv}*+XJImrX)NXk)9FWYQnofXNq47v5eoC}n
zRi;L2p&AhQ4ojEQ<5ov~KixgW0S7>bOuN+(QaC!%OV(A>l1yyQ>%KePlRHw*;2yRp
zH8xVcoju)OVDbF<^V+UAHP^iePq=*rJU8Zb6La_bU;YB`3q-Yr7?c|Bi`xut{~vo_
z9TwHvzB?w0A}S)%ZUsS*P)b0;KsF#<(h5pS$I!4rzycIRlul^}r5RvEM5H8#8er&#
zp=*fqEc843JLkI2f9KENx-Q&qnOW<NC+_=x-uGQ%=gV_gW4z^KzznEPKkCwwS${y@
zw`5HP%2Ui*GV5I>tc&Un1~%#201E!zuv^9rr{Y})jc$YC_7Q|@axkGAlql8^fQKY*
zARC!I5zH>jAL9F54X)^yvCTzGTBSK7F=I`6!w}Bf`rBV>oDz;K5ael|Z>`6)7w5<z
z_qHWPGa#%;SE3%aNxc%N@R83ctmow8QzkPv0DlIrVI1v8Iv?(30h=E5!g!NJ&+$9m
zxpRL%BWmhmftzEDXWay6e||=t)$JgvmsXhAGct_A-`8+HmOWOT_sWC=simMgvClm9
zg|Ii%G;#O*&PJ2Z$5^R(-|dUyWTWXaHR(V6bktr6D`CZyz{kfI8rIs>I@RTYDIa1a
zPH2phUkZEcr&*<`Ww?&_;i>^C!#Woq?`^&on<fc3TNAg3KVcWS!L(B-?b=$X&yyFS
zQX7wgoabiptoq&H6lF*av_{*OWQHQst{olxDE*V^tz&$_unAI|MGEx3spSm_dEu*9
zE?zhxJ~H4gQ4fLlJ1CPnZd;JTLf+J{>P<HR)O%eLLSN#Huh?7D_|~)%Qnz$6cGOHn
zo6!{Id#?i$P65k3OfY0rF(W=$t|(?|);Z<qT<!vHjOZ{<p*h@#kJAh0-kigj1eJ4R
zbmE&jw5#(nG4XM0$@#O_;mj%Of*yvXTel_ZHMnSzAng_t9gb|NEA8)uCisrcAT=RW
z{u5-Z{pgIcR|~ebwkBH2Wn0<zqY&~0yMwp6LVZNYZ#eldeOfG3lL&VsR3N(HD?~SB
zMc^D80z9OXx%9Q~kLnZssY3|1xQny;HA=C@gGrHLymTn@>PrTWGOxB<4n@>B8>Bwe
zj);uZ)`=Yi*!t#=<O0W~qRcgnJQrjl9LwFAVgDQorHLRgL`of9Ael;?hIni9h2%5y
zTq-5!mtAcD<P{`IYc;~-U;p(&_z5h2+2tZ**4KwahZFqWWdUzbd&Y)^g>~gmvZ|`6
zoIG`kS<LBGIqZ6x=*m#fk<>HPdgo$8ZlXPtom1ulZfJ}tUwx4+thvi4Q@!oEJ{Y8F
zNN^05;4*5mAqYD-I9vc*g>y1EEJ#+7;dyOluY1ZwJ93QZ4jnp#R6uL?Q81ko6%~!Z
zL`Fo&ObYw&$M-4AFw=5PWy~&h@9dygV?kg2>@dm*n|qAzczb(~jHCMo%W18<PQtNK
z7EgNbYYgWdMlt+yliGZURQKy1RIZ2+8E_TDbipiFAX^!10ZNUiK^z#cWc2bdOn~p5
z|I4rLAjl4u+QEsumoGo(i1)k@=ehWN&%vg>s3oue2$2wn&{EPiog!=-67cfuk4BL`
zI4+2aS@;Ssc4m<|@SsiE!sh+?p_dlpXL;Q(t3`{{9H5p|v5qa7CDinx`_$Pv`5(={
zDR4jh|8&^Q9&-8Ci=&^n_<S;8F&}w#Av|9HWK|F=tvYE-^Ty7)iRPS{nX^{AI$?aN
z`8IW0A9-toPh&&$ivF@%!CH|QPex<3Nq-r~@Go(nf~s-++JOIXj}^x(Kk%2CQe@-t
z2A!dn+ZKZVmzpH7EfpA$bAPe==sbRg$eW6%lVETXCYc2sraJ-^=x)S1U2gQ_;Xs}L
zD@!Zqg(^qLs}HzXRqOYET`=A-+Br=Zf;&Hl^BFsVQO|#PJH}(Kn4#+UsZ+-cJ+J<F
zwc%a1ITb&pG0h`|bqjJnYuj^%xVw{~sU>E91?E)zxPV5x<C3Dtk4()hP?b~UEHmXS
zm&S_6qOx2z<G=>5ul3rCQwhLcG+4?$^I7#vAJ<8gbk$^7rzj%k)(s=T3FN9)PGST|
zmK_A|h(i4LCYv&)_h98HL?=6ab#0+$=-UEa`{uTQk9cyA%58YWdhMZcZJT|c%X?R6
zvtqdW^DloYU3{TSadNE5C$TQ`Abz9CVoj(v56HFA41Ysz&aoP!liXU_=3!Bm4saC9
z?7W%AV5<+VxM%G+%>UxjQrj<D=w7lC6a8a?wa-43U<{%MBhm;0%aNa*txcmOK<AY>
zM1ML9JWgjrqG)&P2Xe0MBmrt9zONq8n4-*$+1c6gzrK+?<}0rbeyKM>{0nc@@jXSZ
z^JC64{-q*;p||QviUi)Fe<)bfU5-5inM7i72|MR>%-`x$3D?J__c|u!wA@n566*uS
z1Ag&8!q^pz$860s+=vjeUM&p6NnezS#^M1}g%7&CqXT=mxVZ@ri-)3~cm8-?d3$K(
zF{Xyk+urJoZBKqx1YeYHbs-&M!_>dlZ+gyGQdnfkHpK7Vir~Ku-q?#K=Kr*8GYx85
zC^3tFu1XZYJV`j<d)5k2fygF$FYY25coFgr8Twj?JI&ueD&;Wno+DS~4X+YN&q89w
zWVE7%Tk_1B)@zkBKMl<H<~3>Tl%%Aj^gO71MK5qs3TJia&Z7bgn&b+!+Kr_d)~tp_
zK2FYOnps--%rWt_e%d0Uw=Bek;JjZ9jE?c|wMX4gog(3Oy^|%e)+F35XeaVDllA%J
z3t5WM6U5zl*X1{&3+2ZdCy;Son7HU@+`gvtVu8*ORv(CGEEd2ze(u?Fq}#K*3-wTC
zy7PU0P_|l#2BYXfB(ba;v=;p?H3h@kWjN7MPEM|X`*@5)U54f_D*792fhQQ>t>PqB
zd-E1o9@iUU7C(HJx`A~Fcxqi>O%V2WnhVW}G0L~Q87#C0(}cj7o{|^<mJZDWT%^9@
z&*`f1MBo*gqrI@j@^zu5%=eD-HP41aZQFIHrog3B51rvUW8J0lnEkn=*QN&9aR!o5
zkNv_&MOBqt;YmHnR$x(g9|Ds%zcu>!vF5MQ@o{bX*P&fvoVeL5JF{L$sQyL8blon9
zBsJiBAS;I8Lhxsv#7`$!Ho@5KX#Vor={5^q8gSV|T9!@P*=lc&Lcg@Er5~Cho}xwK
z=H&dD?y)xzzJaig5v4eRtJ}${D=FhOm~zfpneNmSU5h9*>K-I#F{&6ra1^Ifgw^7+
z9(D!eOJd{j+YW+lb^6`jsl-w|&nj#eb~nP9R|Ve9a@GrC_5OasD9Z-_{19Ko{n_%p
zf}6CJ@m`l8eNegN&~j@D$~A)OZiSC0T4642>_oLYkNUICRFLO_U1p`WCnHj9k%Wsv
zF$B;upc0P4D2Q|wlsZkGu8tOFcj1foS&%U%_Nnv;sh&$J#b0r`BqfFG;6^V`^e4;B
zAz=g<6)Xfr2_`DVR`fsUtecLZtKVIW)WzW-o!6CAP_V)w*tVFmsA-|X#Hv8e?iY#K
z*;jf%xEd{oaBNj(=p0YzuA>Y7Om)ZkugLy#^7r*)e3tX1z5e))eSb#-%M9T2j9_hP
zv4n2aX1ll#tw_JCSA*Bq=l4>(0mx5X=ZTq)oH{bPaQiES(KW8|s45pKp^UkT3m3F7
zI_j8dh(H?F=aP`o%h=_%#;J|=ev>)IIEvltM1m;1iOBbo@T2+H`NKns(L;FcU5!z%
zrE%QJP^q2!S6mmWi{Who)sWWCQ8#+$F0Pzl7Sq~jP*>i57(~RH5BhP9pOD&mmcl9<
zt5H<`t>J?}=E0Lt7d0Mhpf4yjb>?O(tC(5g8sAypVr3kSTkWyJaE-qZvCedn32q;2
zyy~-aOcjy@80|@jaKUOcd(C>ZAK0q7F(h312uE!LHyPdZzW_1xdaW5~_M^8JI3N<3
zHN|Nj9zI4%ITVvuqot$x0H3M30Ei_uw%(d3dHDFci+{hK2?bl=ab~U2-bLINyOQK%
zCnQFV`tH8JO2n+VFqM0(WjM@ba$}y6N%8bBFUc@Y#S1^CO~!1k=w7F1WeZyy&rpM8
zvQtR#RvjI8g*d-A7)Z`q*e1m@Ky>dm=a$`Twsb4<${19>FtfPx3z8Qpg=?RG)~B)y
zn=GDoBO@bw*l@7~(#!CBlTZb5^ireLOOnrSd%hzW?%v%H5Ku)ebzx^YO*^x^U)kH?
zW<ErQ$r@D-fI}^ixwD?q!tlL_wk^GCQ!)92t0~*H?PIK=<NWJHP4Ba(PC-7qXsBDp
zNl8h`)ug%BM>Pm}AsB%!IUV3J=a4K6?s`_DbnRJWWQG1H7W2W?+G(aeV}a%RUN6{w
zA~?|3UP?^Ffl!2T@P?eOX1#v?!VqZhnA6e-<SWP{Uo1TFjOf`Gj5oxPDk*9p4zh2b
zn;L~Eq)DDBM31*)la%8ng(@(m5xiVa7)|#=d)MrKcB)h;IofZph-i^@tKVHD1kqQl
zm4`>oHl5siJaVEY>NK2DK|rGMRj00824Zx4JZqcTmM|nVE%K(0S#a>AfVW=O%^hSc
z&7^QbHn{DOyCs+=DRQ<wtNs&!#y?(t5HBOX@R)%hnuBqJp(ac&O+#3>|M6acVWk3K
z8$Gqe^8AS^T0-X%Agbo{l|PgCM06kOXsu=2rBCH9YB8=uYeOU-vQ^p2s@`Yg>KB0i
zE+YddI_qEzgI>V!zNv}C5Gr|%<1DZ4IacrWhuKEBPY#a*!R?`t=Nw||Im~$V!Pg>m
zY2zJ$#+fno{gvcALSc^P`Q+O{A)5W#eL`7S!=Mw)S>>imN=ks}XjIkIPLs;=E(ya)
zDNdW4ox{EdPP~FlP`74{6RQsSwjZ%D3RX`}7PpbXI<rU^pBh%5TTI^Try>Yq%hTw;
zgV)pu<UUpAwLTFZBob_hf1Yi+nr5IB<GFab@WWnL6ExTVoY8&9k$-PDn5zv0I5_aP
z{T8ULOz0VO>n{Y$A_D<$c0s<>EYA!TXxI}}Ixv}{U~v|ydk8Xu>kK0ZfzHVDl$91H
zB&;>8%NF;`zC*_(s|-C_CxWmS<mx&ElC^Z613p4qL$qjjhb#-5eYII4-@er#SI{VL
z!M2yZB!wzq+q<!jbq`1)am<KW&u(dI8=l(O*l59`<6Vb?X@QEUjOHOe6DQ#T?-<y7
zf;11J3^dl!oBVnPsiqpx%{_4=_@wpgzb+&pri#}#2zQ$N{b6RLMBOM4P{V$<Abe=P
zD)d>9sZ?>*$=i4C{1?=YaO(c^`MsOBB3U1PWNudWa02F_mfGU)z!=dXP6gRr0I(l|
zPg)=EMRU~3USF&>HVh8^9)*NMn{crE-W}nOC(2;)zpww-S}P?upa=%9KU`S~HhWY-
zVFfuu0}gCOF5iPlCqSYiHl%MYp=Ft1Gtu5Jr1vAH{QLT!cZ4A$_5bCyddOrXY+QyK
z66~LAmPgLM+dP4cvh=anvD=t8AkeiwZf-atsFDoJ3t%M|9^O%vhO94vJu}kWivu&V
z!<F5kmkbc88CFxXL3!%L6kbB<`rLb@OpsFlSJhF$+}lWz-e`NX-}3fx;Ka%^OTlpN
z@&y!6d%WScBP=88x5ce*c8bHf<$L$R4){|`y;=iN=fVY8pk)l&JfhDd$2KmsEqSwb
zeLZnhP$kDrS%MKw6iHrmC3>wrhs|R$yHzKiORV(@OfI6#2jQT5e+n=05J^j9BNK8p
zqa?{Qd3#5m++SR5b$v1y4wbM?IC#iv7!mDFl*C0R7k^6cr_xv$Ah8C6zRCv2*pqzj
zzY;fl@@RJ&cgf)F-kng*uQcz)?DVITe%RMA(=<UT_J;6UZQW<N#KVQK$~?-t>Nw5L
z_RvHhRvY$qBj1_dH6t}8Cuc5h@9wTl4-wdM*fIoP^9SAec+&XU@l#Kqo>Td7s?_4<
zKgaU#1%HzPW#XjjQNbg0GJJNYj=u0azJK=QsXI>&9(=@d(C^;SW(}_VOT7v?O(g2l
zO!W+PIZZXWfRT;+S)GeB0<&II8guyV%(cU)1iz!{x|*SDlc~A6{N)8B2IaWTi$bM*
z^47Z5WULjZtoJbKM8ek3LS5#Efv{cll<DvOA%Ci5_7o{J52PKI4;$n2)Pr*7&fMv`
zQ~Rmxx)zK0*!px#hZZEuxB8g>{Yu2ws#>{BZOo@D-QAlPwyk{76r)G}IsA7Rm=6=4
zUM!7`j76#we=e@0;k7AJ+lldPlO!T(1&vk-f%Uj-lMUU+<<!dEo$)F57vUEF`8Z0N
zy)|ElMy~ZAR_eT&gG{hjGR$eEM@UZ1sqN#=974f<U%v8}5-c^V1w-GlF^f4g5c_V5
z!qVcflzQ!J>~gBAZ~o8EPW-d}E-b~GfLlOot0?U?;9IpqSc-@Dnz#@8e+M^sdV9i6
zFCX;2(c}LdzMi3;R*3tJJ@+1(aGFvmdb{t?TLI0jzP%Zju69~%xA6K<(fC<nqL$;#
znKL6Kn|-u*D@pgq-#!wu=>19TTdeabUkPbjHM$!*kB;2C5i(%NUm|psltOI!HjQdr
z%+qx)h1X_Tjr5hKMvIEX_GD^pTc^gC;k>t5H_3A(W`cx=Q`T}*%8g=|*;0q4MW?}U
zGN3_B#_w*)K!3wh+*hVDO&b{~({=I0zNZwF-Zi>E`bgo@RRva^R0KYQ(rhE|ZB2aE
zZvUvZx{##?Uq|`knh`>I;IczFAOwZfLI*sB5{>1tvBm{UV_psp*>IznOIboSEoYgS
zQaX)dCrODB;&i<F8r$y9+kL_Emq{Hw+w)cXyh<Nu@#+^(xPOiO6@9fad8O;3K|9Rk
zH>!x{;-ld&yyh;(s-GcT2>d<Q12n&1ADZxf(WcLV(KO-oK1xRzN(0;uwVWE+<!Guq
zhOc5vo>U$`h8L9$VQG7lT*D^kAJ34^8_T-d<j-{gFs7L2$glg1BBhwFh{JX@<3=Ch
zn7uakzM~@WVl?7(rpR8`x_-aE)Ymw-`$-h;!KsIb&(!ahtyLte-Lg2u0FQ5l&CE=d
z2QRKn;WhijoSl}&6pL!g*Sw>YVt3?{?;gjzrfCZbWopw?=#O9vX4w$@=P>K$R=v|~
ze_qhuqArxL@t-%K8h(Li2%sz44)Q-d>{@4<N6$wdxP4b4@$X$j`6Q*-o<N#4Xt(_C
zlvR!%t|eoegvE6>MvDkdmMqZnw%ZL1gzn7UDv2y~D0zr&G;IrJJS*2q^-{*@qphRv
zH`%c44yHzLlTU`R8x8>;=)LZxl0<gq_WstZctju}WrpT!YPD&e#VVtt!MEdZa&l|R
z_z!Mg-VSS8zl4PI68&kBT02cX+#lWY+bS-~hFYwxd2EyC<tslA*KGF%VBgg~QVV9l
zYbM`y2K)WnhhE|q7()xpUQ7tqZqPWu^Urfb_m(=LT%YkD@EmNPjF(^8w8-kbuIYQ^
z#EI7Y4894795;3X%4#1WEx<lyXq8-75suE8Vb#4{i*>GNU;ig8Lp8bdu!N8_^`(4g
zOJx`;AN1aPXYJ^WYmovzYTlRc+i?nNmR3I8&QzBTk+(8=$;GRPU_l69`ecCp6ib|I
z9p(PO%RVqm6CA4^hJ+JLeAQr;tn<YDDQ0o|Z&&SEz;d4oTfcqVuDUXfUs-o|E3%mk
zVm)!a5KKoIJRuTBdXBWlHS16PxL_>Zu)H*Cam&#rzQ8NvDZ~@!nRWX#xvBSKEty(5
zQ8mNm;DG9|ag0Kj3qp{rPm#^`Jr3nq7k4_Ad*)dQmiTt8Ho8i33^$ghSNLvy$$5Mv
zqYW{bw8DRsw`!-GbV_L~&q>*22X4E)RVOQ({W|Mb?oUBIIaOdK=Df)f*^~@Tuxy*!
z=j@tZPLMw}7pJ^3g+uoec6hzXeZ<%~Rg9qlK1V&RxryN22vj|7)vsQ;izr)*CS`7m
z0U8b@HbHZzx(5GZ&$sr{=4;{i>^hnDStmyn3{;Z7t%;7;lDumB)^X|MAh8IVyxf&+
zaKjx(Nv<I5hK%i2P*6}@F4Ymhf1>?lD1r45Vj+u9&tVt-9zRoE_)PWX*+$Y-6ALmy
zp1)VTq0UrtHk_9W=a3lJd>m+tBV*e}qSI(PZF$@}EwH&u4i0nK+VQ(|n}@o|^J{&?
zEa)MF#G*y$ts^iS7CU}2yiGSt1#~txA}5idTA6KAfRr}c(q%K&>%>5uc%#fM*gmsZ
z#;0GLu2;0vIqDhR_z_AhQ`a&+#BYnmg{*-I#%u~&PaU&tEq<dECzkUe&yaih!(4x!
zY*PsH@U=IF^HCdaOB-iL$@?E~`}_O9Z7y{FjG<F0$b?t2r26bE(Sfj4`t$s42+C)1
z+n)x-jnNQf4T|klr#o!hAxmZ|j0YVnH{BUudT>h*@ec6isI4Kvswv9V>0Ph2wJAbc
z<X}o3wrL0)8|@x>H`KG|>Se=Lv}P&IbvMVBp<7wEm_*(0K|oXQp<uQAk)Oe$SQja~
zsv_+zVsl?!ki~YV!fWSoDPl=Cl_gath?9QA#zRYEoC$X|y}o!ScjOQ!9Ln%f!^Jgm
zUQ%Zm3~Na}1=H?sW7)T)Jjg^9u3cnSzT!TQ?5&MH^KkfMBQH&U+sBFlO?JO858_97
zo_xV19HZl%S`l@O2v>LQ-j0c3+8%doq7zfK23x-CWz2tSA|oGfb)z&?!d&hC`%3dN
zzOw5%KNrT(+nZ99R01Pr1!Lx8*`06E(^{WvjPzj&>9x!_C;7@*No@-LaSSSt-VcJ&
zBV!XPDUMz1S8lViZCIId>wY4P1Ta|znQT3rD)!jZ8=ke%Xy;LKmXKqI6$_vJL%4JA
zQ@PEddW?L|Zfedz7`w=ocg99p*L{dP6=V-ZZ~Lgu`jnYXn<6;JAL)m?)3yO|wgZw(
z+2#xf?z$rQBJb)F!e)G5_<=kCm&%c3qsbnh&qn=MyvYV>NAm^-&Zn}W)t1IuESnQ5
z_GfD0Axk<>wmweXasFrcde+J>%#@Mqj%ZP*Vae2i$lBscWh#xfkBS;;E<D@BSwgA%
zN|aK}^$etEr7MiIOf%b<mw8{l#9SJkt(W;*4WEf~7V9v-Rsu&#D-Ac+*0yx#(YvF&
z9nyCApaqKVHf6Hm+h)IFG{FqSHes#FZOh&XNzG%KA0hiYLmqG^Z40J37TRn#WXM+^
zpw4gib8}>q8@_bUL9C<SP>mxb-pPVn&iSw{AcoP?>qyZ3%CVF3BX~~TJiU9A`Lnpg
z^80tZdWpDKEUF`3yoRMIu<v~OTfj@o6DQP2aT4wM7Bu*5o!cUgHe4cn%9tj5I6%#7
zKCyn0YSpY_iC~~aBmrE^sJcDNOu+kPmdw5sAx%M?EPblTG8vNu@?e&h>w7;xKPJ*t
zVwG%6h!-?j$Xo@dztebGzLI2?-mO1lMVtLob$+R6*NgkUeWhiiYR{Aq!*V++bS`{1
z)|EdohsAO&;ljm>Y;s_Fn4Q&bI;Hqfd{lBDk>sqWGYUq;OM7#M7!2r!i~qcInEp;k
zSCuNJTr96QU>up+ge!mEPcAa|k^gpojvjA#(1G~%@On1AKWVId+vu3!6yGq@EP^8t
zG*n+XJ~C3Qag%eM>E5OAsm`pdO$0mzGstgG?+^6}jxpLS#IW~$U}BMUdPZ1W7LIOw
z?B}}tGtJ-!<C!xl#l`o_cc$*89c_X9ISKiPMe$4zX$gWO72pmF;~U_s&XZfYCJinS
zI5avxg^Jb9QE233`Z8!zVMtl*hdvo%$MUxy+#;OTHk)tn$cY!Vt`Q9FShqKceaHNB
zH$>1}g?JgYfCS22*3GjUR{&b29}9aZ=S^NR$bS&`BP4oYJv*m^iCNN9!`}WgZ_|w{
zR~jZaA3l7@;=|HkmbEJVDz@dzl~uG5FR#{Gzei{rF>cq5<OS_+P}`W1f2oQO{<i-@
zz{bWmnMfSRT?K5{ZiOah$0KbG!BBX}V4?5qa;4Dd`o!bzmcHMrs$#xTSg?9d2sh75
zk;+N=vo@m70g7qeB6RR76sF|t<TmHhBNL+GbmcdZKMWJ%Ke9Q!H87BH%O{o<My}$}
zB@N}+o!a@XWlV)j56f2j*IV(o_4TvCpwzPMyEu4iLK*cYzAr*jbeHIVJEEjy-T(Fz
z2IvOBgs;}p=b<|*lus{0R=Cn3z{!h_H?pV)Ffod~1`tZ=VW3}>piN54#dsG>!p1Cb
zC`r_$N24gb?NYd0xyP!VrMT1jv!<HaNo*;ZT&@(p5bC64e^lVivMac0y^ubHdMS^E
zigy&OUirT)#IIjZZ$>BalUKI~@(nPCeYbWGBbfei$;&5v`?UaDT{|w&1@Pc?TOmHm
zq<H3gt$JGQ&adKQ0$m`IP6mv}J8qIKsH69w^<#LM8LF%0u0O;jl-!-08ZcIr{FDOU
z1w&W$-X{)xk9qU4G0MEMOf*V(<q+V^{7cI2pMDyR7g?_Ow!spBcZ2q;Mo9#>FRyN@
zsnr;VqQM|v#;iYq0M<F&h<oenWOn(e@^;NY+KU^PL@&2k5RCR6z`nCzi>&pc)G~8T
zaeN^g@fVA0LTcM8#4IWwyiv3NQR|o4Nh)?Tk-SE{5uZI4Kb_6~H86=D{w!O1-P)G8
zqnPokvJ(Nx9MdAD8Y=Yb-{W6+HNFiJw?G=Y9zQJTKGGJ&KlkB6(_~krsMCO=@8!`!
zrGPnVAf<b-4r^aE<e*<UbsPZ)su9m%NjRphP~;&iVl3(Ad)qEh(vk|17`vkaf1|zG
z$<J?MMIc^jWG`iEa+luokj7_b0#HO|c6Ijj4PE)l3Kwi20{dz}sV>geBh^0D2R=f}
zq`z!`mjU>I#*gW1h0#A~&rH$l*N5}hgJLk8Kg)Yw4R*!%k?KYy5xmy3>hw(#5L{&L
zFML+#iyIh6d51SOXY_j#1{|(bsI_C=XM3C@Nug;Z%SVr%wz*XLO1qg*Upr1-;*7*4
z%4n)wmRC`EZP}jw2?9caZR9}9m-B~kHF1aE8%N1{EQ@?fP>9sOEpX`e86m5V`3c=a
z2WY0{*L^&Yeh=7aRTKAEweMm|?(-(+X%Vh34{ujjSD&5k>EF6lT*i6-qXZzZ(57IU
zj(a}D?efmG<wsw>2+|&RcUAkV>Y1u^$_1|V*o8~_t&lvF#*K>YKL1?0-8gmuqt}~C
zRi@dF)wK&FM3X{WQrsadJ{B(A+L_KlA18z|OU<3>;x{%jtqjj(uF#nGnBo1Z@j5NS
z6^5>9l0-nTc0TSw!JDuvB@c0NQj&X3o)_6$z>9it9;m~QP{yoKN!{_~`iXWNZ!^IC
zb?c3z%3V){`-&g7WVA`awq%&mM`yY3pO5f5l6-w|pHWEX-?2Rf^~?0@@|8zBS_f)R
zpQ;!meSI0rL9(oDN^r@s!|Wm3G}1t0Of+S>>S}mT^|qwM`(`cwIM1Z}wA8)88x*uL
zhHU}I=$ywIbVhs2Cfi6J_wT=#t${qF*4)U{i3-3zc=pDmCKRjR#2PPw4E8$XZ@SHy
z0NHp7pNEB@4|`oP3Xy!`+b^~nWnQjqW(jzS$&GVM85O5@jyLcuYPVI7);gSYxyf=R
zLiIIAz10XBtf5gaH&?@-4)}Jei?tEg`pbm_6h0bzbX7T7ju6KAQj+|lh?F_9@u<WA
zxa3@E9WO#FqqV5hA&+{oNQ%17zwS3EENkDX*ifsSV$!k-QTC@pTB)M5w^t11>v?Hs
z{CXNYJG2rR=3UP@w;Hx6$ceRlN^MDpmg>r0m5K{TEAFwaaQ-kKgVkse+q0$L1K%Wh
zN5mMp7Nf(9`a{;TtO+aqWQ$a>e(ZCRctwkh@oEQ}VvkoW8%~Mj*_&z2DvlXjiVZNN
z3XwUSf+tThF^%M>$lBvb{Z9)i)z8wZA<as-cK)|Su+g3|Tv{d#&gj04|G=;kX&)k-
zB_s=H7IXr?i+rh4MIc>q{xFjT!FtDJUL65egFVxopA0$?Y*yODhua!j_?)J+t6@3Z
zS8S1oK-qRgR!9q?(gY8CxbkY~)tZf(-Gx<z7K2{GiTBVt=I}|)u1J%{*KEr`2zD@P
z8}#QS?Nl(|a81`g^nMDTmBrFmdX~K9M-)Pun||eYK=GvjV1lrLDA8#lSpujBZwuXn
zA&DetkPI|FEXFW(s*NFXLQr@(C6(UD*eI<V$q!d71q2Low_Qd^5huXflBe{Gd^Bo?
zXUuAY!}z&KKA=%R3P}InxdWLKpJ7lxy1}5x7Wow8&1__NW^3os<Hv5!I|!GSIEWK>
zo61*s{}74O$93KoQ66=kZeQ@=-$UkecR`HW)4c|4T7b1ud0QsHq8QLH!uN+yS0K>(
zO%0Re&?fgt(zoMbX1I^k$B%Hj5N-R*bhw&Ewl?AodP-fq@_#P4pB|V`O;7)MtvsGh
zqE)oog6z}pf&1Rs0I2gAm`s;FP5v~t515}4*(6GqoV`2xu=_Yz?{<kNdt27hY<+K+
zX3nOb4|PTZqQ9igLc&&~I^3Ik-_wCP`Ni-3oTNW6i_Zy=4bYS6cEF~0V{bT@{&YOH
zqe})BA`|DhG9`o|uLBYa<)US}zHS2XG)8)5nQj=yGD5dx&5tGq#36~yGr6`z>eSZw
z#gWgl*z491yi|eZbF~Q30r5%^51$6&sEru-EJiEgbaj*A74e0}U$(J@$Gm0dToMya
z)2!j`T}brLr{_skYoXl|j|l6nO<t1h`%-X!jeC8qTKy2Q&o91wL`Qm$0t~?0?GOWT
zwP=4f$cvMY7o9G+aDWn-kxj$6d*9+k9Xl+<Z`{cK=?KEYTnk^|F{K3E98s1-S6^jv
zzI{hAq<7ZsRm(NnIIeZi`aA}qOzgev3ha}T!I5GPNgZ4Z`}@Tjsa5A58+tUZtuU?f
zRC2RIW0cU=Vz2zm+D8tXH$c1zJ-~{^5vTJFayRcjrtQvs_@?F@kGg6PrPeU#dbdI=
zwG`9*x_jJKEFwwz*7^Qva_ysQ77giXz%p)h?=Cjz1Sm1l#jNvW-ttQepFb2S+*Rl$
z`(`|Q!!=eR8fz4~HrrNjLAH(eQk^KU7S_w)t+H<-d5`CpKWs~riCb!s{WQFif6!Cu
zGEeNoaYdN}%J<H#y+R;NvZ@dLxN~Zta)+&x+b%+0QyG37puSEa-&*7~`{hc&8^3TY
zz@EkQ*1Ps+vNMO20F^Y6wpsn-9eVmJwi!czaj#48-uFuWl5W7=Ye8-vycob@o7a6j
zQulHWyB($ad>*3mgjO&@0!ApCpk1>{j;Bw7EUhmxISEOB^vLRyfEMZ7K8h89W)Zdh
zL%)bd3z04@JgPn__q{vc1h&2W0ps2t>4)22VK<mWcpw8w&V4qx1W`*3_R~XP9dygl
zl^Dq122CMADK|C8P~Ea#@o%+Qu>yn5S>7`bSV`b+*jL(%O+bjX*1DD_&&C_#?gmdG
z%0%QUlGy6jwCQwm{=;P>`ETD_GDlLqgD1p6r9`^l0g%sWXcd@>yHzb#$=U!bIn_2k
z@Z4|kJ!JJwPaR)!(uLUm@+RCpKEZjDyzXTq+wx(JhXa*Q3jx-+e~^k_Jb$I3WT*jJ
zL$`@us<se7#N9{|8KTw=N}6@G@E^f36{I*%5m=2V2s~M7__uvzzrcwj!-hg<fjwFc
z`GlxX8PQ$uLD&M2J*!s7;m6lL#Dv&_A_9?e`h9x7uH$lilLW@BCPX#8J3CX;C+mq-
z2*PBkq9r510)DGpx{3IMQ|+HpfhOzZ?8c?X0g+#s>%M)|T5q~YGiz!JZ>7{3f#|^*
z-L?(RQP=x&?eoII#JJe5|NPv02e4S|CQqM^aWW)a%l;d>1>dTiraN}0K%-d(H-<t4
zJSX+^lOt3@*jH<a5E0fZcbOX93P3Fxa6|Dc^kT~R+rrJ;X_7f$*06nQOt8OoRoYV_
zO>zr_7KAMKIW|dzA%vHEVZ<47Fs$ToILht`>WPV;AYc>(FG5LVd$FDmk<|>!oN9A5
zb^-AUS$?-GTAS`!QBCt;1~rBcjuV3<BK9L3J^gN2!V_WMOA2{nw;uvA)$aikJ(&Jc
zt$dRN>SFTgzAEs>0U93%N;^cu*xefEvm_K2SOx@L=H&bvNq1B)tL;97?)Xeh&suZ8
z@}rezvw*w>N4RO%R4k4AbhISbFp(bE*}XROasGIB`*BR08>5J|Ru+H+5bz(bR#35u
z-9ecC69SIWXY;lcK0{p(bV_XyrhdgWHh06z=_+Qe(w127nd=RqPa+mDXZlA_KR7gG
zj4x8=i>&PpjuxI?*smb;H(LJn`0h#$ern6AcMD0Ga!tXVkga+0seu?NQ!`GT$<77K
z0JOkMQ{w_+Q36QCG9uPfg8#(&d=s}Gb&w^$9glAtp-U4DIMP9XMec#ff>h09q>&F#
zgtR|Myd!c=lL7GC;G*1}d(oSI2&ujl%vkdD=*+`6Tf;nxicqz-sNWSuh>fy$@GdZ}
zQXr;%6$gNoFHI~>BGMT)#t8gMm)|zTFiy07Ap{6nODd)R8(FcmbnT`&b{1RvgNF{4
zJT+Ow(Nsj;13maAZfo&no7tOP?3faaXdH`heyf(*>$x($WLe4CWnS7<o9?RPH*enL
zP2?gIpHa~COz|blzLndZtt>)E@}M_uMs_`BmF_J~-15JJ45SKu?r-VrZS$~~d&!lH
zxsc{&L2j!5tjHj8P5(qf0(ga@+m2`?7xmot>S}i<gUMeb6<%R3aIzJzm&oZePG(`v
z=G}pQh^z?IATpKTGsF9j-nkj>Q&#TovSwbEiu{|Bg5cYaK%+ap?0V|~U0T`fg(g}8
zw~`5@pFy~V%&{@IEl-du5iql-oDi3WxU#?1!ic*qvqWe_{-T~1qQ>2Bjjf$Q9J08$
zOO2%G)>&cTcUVd&_vf%5eAlhjF~pMF<gVMQNK!tqjHwlEGxwFEH1N;B2xN;eD&fn<
z?lx|B4PF+36So&JkMC6sTkifCy4@F{wy@cIsAs2<m*+jacx89-07^yjIFq18nBaQG
zz9~Q)#J+thl>h~FJ2AUepSQmr;CZR}q8Ew~P+KtQq3J0Uj(J@Qs(FWJnUaWYztfiA
z_3PLFZfT5~Omv~nlzBN8vP8N1*$aEHX!|F?QN1GXkD$B9Ua|)R&jJF=xLRYHH#t9;
zEC%%5!KVK$Tfr+Vab6NY#pL&ea4~p^!s-mUQnl|dxb0Ev9?r`d$y2-BKVO4Cd#?}r
z4(lhUo}pwJwtl|*?S~##s~CV&`{<G&gYEF$wG0q-724CRIzLTAc%o#s^+rg5V!Vz0
zm8FwyH*}pXJ3CB5T`ouX@a6fq1f5`QNv)4G$P~B%yyPZ6^D-CLmoB3JmI)L`l1?yf
zwOG&}Baff%&P|LGwi;@YpginP>9PCL!w{TT_(|`KEAJ}F7>a{6W=5^(f`M^6sBXrJ
zZHEt+=Kye?>c~h&7<-TSc*c<AQfoyg=v6C4O%---KF7#p)7@U=5iRd_9eL&iuDHgf
z5$VaqB|jn+S-kVw+|FqqME>=~cEh)XY`(FvJ3qnHHU%%C(el;F61(T+dJ3#x;;;_d
z=bH!qLg?IE=HH|aG5n2_=F&I!w41t|-m)7|1x4%vxz^=qeW2<yzzWeVk}d68hP2yK
zOHF+GCMkpI>0&Bq`IN_xsF<gJaL$46_&QvHqF`S`Ne1KDmu-s%C>2#98>e_S)#r@T
z0mzbOuA`vc$N!4KLm)%~8Kih9I}f}mdRI10;zb3xr#Q-I<e-sNk6*=qm-*gTbZ_K@
zFiDJ&=1{)GgHWAdFA0ZP)Yzw)wF&iRl_wDX5>9um^x0I&4W@KF-<e}T^*U#Z<cQe~
zC76&w(^>%-;0}W0VTp~Wzzw$gWZ?b@t+jw8hKh*JN3Y(Ixtsp*&H*2IaNYNkS4(1!
z!nea7fgatr8LV66os76M6hqW4PJcB(sva5-4(&efXL_U+8e)L2cq}fIO*2TE+xOL=
z5sY=b;n?OtUTD4->BKhVD>0X?Vvuu`kOCBX4Ib<(pFBV<s#{%?;e+e9gvmX0`0zT`
z1En(N;JD<p*`U*CkbB?kmnrgaF`yAYUb#oH8l#G*w|*eH!P^rsgun+KpVD8Vj!hSG
z)S9fFJ8(n*<xBnk-X&;B;^nGKlgaIP%Wgp>fI^0@_EFvyb}hs{1O#&hY&{IrTCnfg
zs<kW^UDGU3FjsuPPdb(M+_{9V_vShJrT4ibd9?r_AO%8*ufRs$;jk1aLu3~;?Q5u)
z!D0MREBndxs6#d*E28&OEwOLEFC}-1Zmwx)Y{omqVKzBT(+BS8#xW>}!y{>XKpTU+
z54(D&8cQ&BOs8ky7t$rCY3UOq>gS#^06OL|DEvk=*pI>h5%#4thv4BnGI8~Te}nsY
zYBgoX4_w0mX$yf5_o5_RJ~rG$?;NQ7p$PSOc4QvE0ljf|Y%!KYe>;Agf(og$C-hzm
zIyl`|y~HMm=qFGTnkDh>^Q{4bD1GSdYGqJZ%Bk%@Sg`JU?a{Rl%bR(5Y;vI2rpO~h
zq#}QURgw$fU7~5;VX7Gt*qwBVHusHt!!;pq*^o*M4toH_g4BI!8<4IkD6&a5S3)H8
zl}~#Zdjwh?mI5{oD<0r(zLb+yp`G$!KSCHjaa{^WzKRYA5_f*fhTsnfV;f+@1F-G_
zrBcZx;eIbnaNzUKwFSOq)Bv4?m`enk*Y39A?}ZBKc8D4W0tmZYZS4A03Y061Wp?_{
zBXX_JhdH)ksm46Ax*+`luTkw=Hhd<_9O)C(^$`P=YXyW!#&Sc0qyroU#y_%MZh!Jo
z>;TF&!>mY_U5@CzhDIK8W6w$7gNC9IHr1I)`hA03rKiL37@$Tl6mZejr7A?S%PsJj
zZ1>TEUFQ4b2E!T;EN%_0jrw{KaYw(;x=^y%r+HutK9SzO7{q{las3zQOI&i4M^CK6
zCkH-N5tUGAIQR#pax*|<c=zfdl#itf_MhJiFEq>>qlFgGbnrQvb3dsEQN0G4>o9tM
zu7SB#nN63*_pwv0JBx3hPlbhzwDwDuL=QT5d@}r`JNR&i1=bsJa{Sf=kT0nOo?sUJ
z*wBz=7~6K?;|I13fcu%o*ET$k%!dn@2{?^C2@GM8%6O86Z(%vjls(oM#d)Lb;}kyU
zqT{o1ydLI}>E!&I;p(Z-?egQ$gU!g@yF`Bj>{`0ak||}TR%3<)eB4rFSAryk(zx{-
zlOfOLyge=aL~FB<xmr@H{fSmQ6mYpDl^_N3SL#(7)HbvdE7s+wMQrc@9%t>XI(NzO
z>R~kaA~d@C#~nJi?JC(2My<|y#3x5mPFNDe46Su*=r#;X$t<pmeG{E&X+4D@+Vy0;
z+^73d8g~CaxcDXTc-Zb0^)Bacb@(>jCCMz8qdD7sJa7F9rls&(G74pqd|reTskVef
zl{_8HulGZ$xrr$@_pj(;y~8^`5mUgpBt&fPW%PA=v&vc0vZk5c-PKWjb1GHxE=s!l
z&(a6z<5z>J!0M#u>L0n;MOFFA`3FB`bj-uF1kV0d8OIl)@<!)NPL!lo$m*=r{iJDV
zmf+Nf=kl=<<@av$A)&5afJVrB=I@p1wqy-bf$i>1DhA2BmusIhtVNzO<SE*R;@tgr
zBJCm-h=sR#qC~h?YE6tLVdhD^Z}mz_+!zF(+)J!iaJ3qGJINsYC?W6!gUUyf4><GZ
zy8XnYdzl<vS!!kF`~~;8K;No6{977Crl{_pw<C87l+A}*y_eVJ9_!`w_zb8dhW9Sf
z@u-q12<cGl!Ug#mms;mpEGl5mY>E<y;V?7-fl;utjYF<yWlh4}7SB*L&a3z4V@>Ie
znFaDGh;AIa%R#q7yBE77WwhR$6S2>fG$^VYHhX}xefi!rEX9#tY8qL?BO4m;bVWe*
zJ)KcpPDK4#^$f_9aN;!5FywlBV3wxmoEC3xQD0%V)6BZupZsvnaJVW|#C)sklp&EU
zZ~AV}pwW$AXlYxLir$q{9eEnnsQX&1KB1>F_Bq+x%RL?4^hx(a;oW+z6nev9TO-d=
z`-s56Q&caqQ(D;B<zN8C=7%4azuWxy@cj@>C-(;(7K+Q1{hi*1k#E_8nI-gVLgL%C
zjYv+6HpLG=n>XiP-89FmLHcrC*>ZGTdTU)EUz)e|ylDIY%Ja_}5u^j?e<1J~n<N!%
z#RkaF^tR2vf3+k<=N3y4j$WPV!!)(w5bp@Afh^3KVdAke*`1@|J-M@(EgCpGymRf_
zFgaE<I#E$i68)je25itK)J1Dri>J?U`sMO$Pk~3M0v4+xcN5z0?$v**%1hv*5?6;n
zZDXUOxEv8&tu0N7Yq4A7>IXrmX4JOpMEXO1<L(!Nu!Xh8OH7p&G9P$_kW0HAL=#Kb
zhJxwcdAZS(Wb}FAOS%$RiKLrVHRo8+RmLq8tUhXwT&s2r?tgI#AiREEZhR+b_2@w+
z)K}{NvQD}T<7*j4@o|CSM45<PT-b-y@w8t~;%-)Gh%mom8k@h+S};htq`0rmOtsZf
z&H0_V7)1T9e8^Yas?$ezqLq@o%Ib6@2$FQv+K+pY6+uCrf-_Y+2ZC-;3No!P<PL6Z
zZ!TY1)JGS3uBH;a!s9)DWId>z#+0Q<Ns9JP(g#E}$}3GJJjp81xHKl7uWX0q6IjZG
z@%M7afzg(i^J^x@eK0Tffia+B=pxQ~=(T%1LK=55y#=GJ3=<v0bqT^HvU(7izrBmJ
zJhS?Y;01%sYh7e5+-S5MvPpGL_YqX$H(tIopLk}*RIj#PZyl}JB)OI}#;2<`!j|7x
zu}vZ5^j+Y~BfZ!j6O$xbOJOXNPnGe)#74Fbwla5nP>K14M8%p`&ebQjw5;RK&i-G&
z!hzzkso;;Pzv4bM#%Fh=O>0?zkxOR09hi%Qm=H+jHLTF*T6-1zykq_I#lAUW9vb(M
zjK;3HudsCI7~te+;^Ix$nGXO|`qztkAA4`CXcv)Rd3)imSqBqFkKeF|F2}J5+=TAn
zUUi09YsO2R;Qg{c09!%LApGO;Y4`c?ZK_bI`QgD^n8@g8v#wB;ypk@>BcC3bmc;6_
z!i!5jf1(FBr&s65Ft|0XrX&1)qNF&hOtr{mRt;;5lax3^OaHK#w6u&d=s_m_`{lMi
zL%#MWE{qMY=bk>g`zlt&a(Ex=`hUmKu`CSQ-E$_Q;R=u58`ENpre{pQ;rmQvAVT;=
zEM})hZG0BI!59M-^|r6|Pv(uCQ(6y-YIOH_nAuvC-8QDIW!3fi9~*8y&-n!oCF?$x
z*(a_Ta31b_zPbI>Uhd93tLvW(c7q6Bkb>6dZoW&3#X?Q3^TJ1+jD9Sj0V+b%;~2CB
zA%E1d$|Q)2KAqXfrWKilAMJ8I3!|411Iig1)(??z6s{uCDgb}{QzrmJ`D!py*f>_$
z<JZDhZxoMhp6~i&$B@hF0j)qJ0J#L*g9T~upeRIGd!35Jd}Jl3_2WPYf85}8|NOHL
z0G!oC!agLxRGCEP{Oy>@KWOv(DI{u2X4pA>X>)l-Yv!t{si89#^P+a7zD9=&N$;Ah
z-ZL&ff7?xJJu}~Zz*yyyJbL@Ymg~>d92iIh%`InVy}$PYOlM>~?rPa;5UVXG{^~x|
zT>8*|8GDoGn+k)M{f1L6KIDVr&-=c8Lt$`>VT9U6z{mwJLIrN1;gCs7u*%2R`XP*s
z@!o$@Y`fL<CQ#w>!NZ5s5${h7wKgJYK;W!#A@=uCMasdEL$>W0W$H*5biE?Py0>*-
zPTa-stCM#rENJFBh}((EIv~Z;;gQu*Y`}ZFbV-z+$A5_L?q3uNE`@|)tAL=%*?^3?
zhO()2LDl5DE7%L>`%$!TH0~b<g(L=G<Xqu+Z&^l_Z0NN954Wn?`&h{9wXtH?3rda&
z<i7~zb_gp0))6>vOQ^_e*iQwl4lO?RZmr19qd$J9S+83wi=iEpRa#&r-cwa&CB{t0
zNRy+I*ZugGciX$B;|Hkb-bJ4i_53^Il~l@^Tc_iCigpu_Fpy*g$!4lAZ(YIOH4|`^
z%^Cn3wVZkW8W)X6PwT~<!PU-|7id7F6W%iX{^JhJa%p?bK9n6&8vlLyI-CbAQf0X>
z&fWRPnMk8x+g;Ph!Ovj8`Xej7hYkZQfjFX&dg10x7^`U)Be*lc3-m=nlPR{)xvT57
zJ5iA8)uX+-pZl3?-PpFm#A!b6;FA2*%yqs3)^<wu%^f>pcY+flS$h3AkDOJfZEMd;
zwBVDU(n8j~e>X-6^M<3DP%3b8_kYH;cNCn@a{ZVC8c#Kox^zta{-Gc^VMi`is(bp=
zZa@Hi8Gg3qS0GLAp~%=`>pc3yN}DT_I+hAtkIeKGMoUuxWp@m4kh383J}$gc6}#4Q
zzf#2y+eEN|;F~u48+E|SF5T01D3sKC@E=hZdHf3wu4}ifwD~Yjqw|b+1?Rg9_8&O#
zHY{eMwZfv_Oo=ewWW;}CcW{5b=b0d^?{h5s?Yb<uU(W7?1OlTPpmO9iyD4=;Qkb7#
z8r~DXyuQ9{EiP!{l36MxDeWH^dfBO)4&_Tyg`N1nFJJ86fD$FkOSu*jT_kffR6eZC
z_VuN1-l}}e;o?b-t#<=Pr2LKTP^1heb<%~4%OmkS4~j_>3*iV{RPcZ#&LHZU3;rEp
zVbpg>s@F>j5Lg1>p=`*2%UlU|U<HS%Sd$k_WW_W|fNWU)9qG3RR$Eu+@}F6Jd_6Fr
zrq`cv1JMYfUjO-O3#`3%t}?c_Bw|Uvr73K3VI8);Qx1lJq`e$`9RJQ8+-9F_eq&O7
zLXk<#;a+gkg_kS81YemCob$K|wr@^YjSbxP@}9Z}?6!-eshS1?epS<55UmT*9)@6~
zJU(WLe~^f<zS8$tNNDNy$?5Xi^oLMe|FCoX86OlUMGr^5D!6pfZWb-eSRQ{B1~<0p
zQOsg-P8HWMCj=JAYpo|qRttMnTgaf)zc$(3Xtt)Tbj`5Tc+PJq-~f^Y(#<Y$rRo`#
z->?cn0v1FM<xSn{N3B@`AB)RLbdv<HRs9!VAVm$DU6g}3`+`Xp`?MqKs&kl&H6bZN
zfzArzj7%Jd9Iy)BysP`AAOBv!jWp7ivaav@3@o6hbDM(<QbYzB(eTnXy2z;#@WYE6
zYcNWsVIM}<<Jk$i6AR#4Gp&VywnxXtCfA><^Fq1eB2&HU`nRgsR|lv7m`}hL3=O6W
z8$a69q=^-_70n{;&un6)AYXZM5@G{b8~`rUw6hy!UV{L~bPF#u+8KcvO_(Z{l^TMJ
zf<q*Vj8|kLS)?xYWuJFYSq2>N$0_;m+-s;X_i&smwC!2cc{9E<`x0}UkbL2yM)f1E
zysPIFIf=RV5pqUwoWUQ3U^BIDv{pl5-aLQRrs?SM<NPrRkfI-Y;m|k*^3TEBo?^e?
z*=H<;8Rw$04?b(}`$xu>M<`p@uF6=|)m1Tm#jV%qZgHQ8R|iwPWV|0TC9k?OY}Tl~
zzxX`wZ-WE{gCIx>{$S(J`1n*0)Z#*Z*W!=?rquvCaIP?3G+NdCP$0}5SfXVy2C`<o
z)A73zG;9`wdb_hOM*|??@@Wytt8;U$g{HHItqB!vspX^FJkUCL0*C=N#U$7W;q2on
z{U(CJhVW$bf)^GT*P~)7aC@+M$>}^%w)-GC2=*4i40#oKV3gxq0A2-!Ftz11mESkN
z&ffk+*wYr!$RxJUqrhc5&E2hoX=Q?(GREhg*6g8m^+UU4<+{fiSmvr+LxHl>{Il)^
z=?E${8Ay#<7!6hZu#|+UpBAs)%$FzM;Qo8y>DVshjdBkcp0=xO=&1x5TdWpS7sUF&
z5ZAl5zhY+v18>WQl*Bgs6sy<VBGLX%5|f4qauxjq*^l!0an6X(pEl=BitrqFB?MH#
zklPcz{1`-DsFjyGBTf2}qZM1fuA}ho6KB3dHN1IYqpS&@h==@lu7VGfT9FZ|#j`S{
z6I*|sbf$1)rBfea0WTx@um*-n3EF1&u9l65rIJcK=@6n?m@|y$O)MBJfT8RG!o@p_
zu+&AsuQ7kB*U;yL{n0lD>8qrxU|qd`V6Z9#5axQZ7%{KA(S@F4E^1qNdi6S|lB1Kv
zh-0tb(Om}>5I)w@rCQ~T(88GAZhqhMeLAH{4_vE$LRh!jNn#IRS+Ywzkt*CFGX6^o
z?6O$Gl(^$>Q*-}4=v|pwuJ<#RH{iAi-{mDk3PUJL<9o5%;c28h-UkBDVx=HDJLv@&
zH~UI4c+(jwc&P(Q)9mXhz=KSYyxnQ!STLWnE9}`X$4nq^>Fh`8|96*;9Y5Y&uYQT)
z@P351gZm{LRiv?TY&w<fw{?<}bI>ap2&^`~UbuCu(X`RS<fH7`)T;UTtpikvrj8ks
z6c9eOcnz|_y&1G5I78aI+xoQ5&j$d`DT;uT4`x*Wyws2Mxw+NdafZ8L5%WaQ-+szf
z(m!c%PlT?u*Bn5-{%^YA+lmK9nUR;q-Ts8PV*|{%U4if3{Pekg9YJNl@P_epmcmw}
zU#eNO-yH#4S(fy2kJt%ggh|sadGZ-NP~IsPOwg9^9uJ=1zi;GdQ*qzgP<@^=!IZne
zLssUl`Dkl(02E5b%CD-!_+42opCN^F;3ZKgcG-U+g?xg+Ei12l%M9&AUjU-ISoac$
zN2+5Aif7IM?*rsMIeM8!LedN%GXga+9Px<Hx)|wfUn3f33<BaZq+o<zmfv`s)Zw#i
z_(2n&tG)lK0|0O!*_+GWkP_jJ8AWs-El1Uws#rDeU7}(ZOt|0V47Yqrk4kv;XFWFJ
zbdS?*NpqI*%|BAhW$xvv;ff^A@H?zOK>Pq!Oij(V42wnD8$#So2ef+YmLERJO`xC*
z7f?e}!DAdnuVjj4497kvy&g#7c!5n}%W%$mR|*HzT@%1qcFswFXz`lua>e89KM*eK
zHu)fs^E1<;_$<AeTnVmgNevu%K*I_gCXGRm5%V5;TS3Gc0qFaZmxDk#=xBA(E6u;{
za-&47lIG{5Uf6VeA4a{vHt~YC)#;@;*PhtC4e3)B*Xu=1=}0PH1Kr%~(7}Um*ByWE
z>f<&y8JQ*Bdl&A_&J4!Os)=PNPP^iQ++iuvpXxpgf;2tAZ{9qkMyxuBs(|0v<bcr5
zPp;e;tZhXFTn##i5QVPy6Q_;pe{L%39Vf`1U>#cWa1$5<p6*rQ`LrnB;9=(bd$8Vh
zbkO5`pW7$o`?a904|x1pfQk(EJm0$~SqM^SWw8{_f`%aSzOOvI*8uq~a{10(dCm`c
zpfC5n{%SC@Pz*b)%HcHmuX}K%^0gKzgn>Qg4--g;mPRlM7k8dVLxm*W>0i?CD{t{*
zMk6%D!{Z?r9@fInA9xq@`x)@3-7we~#K>8a4XBWp|8-szKR<|G;8u%h5m>*Je;+v@
z`uC+F53T@Zh^kcUk@>$Y+r;7?UxM4hn>_#Xi3By>5~t5>wZK~q4dWouD?Qr>1(>J*
zb}zlX;jhXtzwJKwj>=ctKO5KneBama-`2xF`8vRBn*Vca_%A2=e}4Tx!}7lk;(yFx
zZzy~n(*CpVX7B%-061SJSUOuCJ96Z;C|eiN-~j4t+P|LTi|qgyzQV|#|8p3y7VV$1
z0;EtXhIVz@@Qm+kh!aD2DJ%U2&|e7HnTbbdArDI*8MNJruc1ME$afg277~(UBYHFZ
zJBJUT63Tv`Nxatxt}@_tY`|uBu{i*}+>6yIkir4E6kxgKhWIfBo*S>DqtmD*ckY1l
z>*lltq8uWzgW8!1Oe_<$nABE25W$htO#WOdmk}Ke2(lU=`2P1oiV&vDDt>&(qwmSJ
zu*x_{0Wd3StCbr`8tNVZ_t)Qjwp77=^2^k0`(=PN2ziqNBx>SYbv=W)`*l22f6(mz
z6}rB`TYnLCexTijT|gnsiFep6_PVp~pCZWTT|mY#Xzla*$_+;Occ{@*oB&glYrah6
zr1IVjfLzN}sza0JdkZ8sCxU6)#uA;=Kus0G{!NI$=+7|e=iDFOkNQeProz|3f)F?B
z?&X%LKpsh?K`NH1<@G;p0y{U1<yx#%ejjD?BH3oPhu3<w?ih5n9iSvaT><1;AVmGE
zua{2H(7heycp+KaUtV~#;h&9-ZSbU+o*$vilP+$re$xif`w~G+X)b=Q&YT#$!dPV4
z{B=je0tNMGq$Mi*m^LQgf9fxu!i%=NX=IZd#Fz7>9@!gnyP}sMN|lM2T7Fw<)4xRp
z7_0X%#i9q`uEzIX;}rCOt=mE4%mhFazsv_l*Aw#Ml?o}&KtfCe49Y)#hLqk8B&Q{=
zob1&B`J|2#nNKcXMR8#(az9j`i2oL>@zfX&8Vj$zC#xI<Y5e$YDo4629YD}t-jFI$
zr^o^54gmEpId`5FMFc>B_#od~1hpt}>rf`i?^%?`fIVjS6nw+;Cso|?^Y>~6nq1fO
zJIf6CykmN)Wuw&gO#6rV*JJ(#<MU9%+}qZPO1Rf`n+lR!NFiu>On(I={qi#D5Ug1R
zOs?>*Vm#b?loZP56}MBMJx&2q8gv&=Nqw;ag(|k%lPa!%9=R{*yx_!Mpwzx}`%<qE
zo&oCM6R>&!xqPu2wBd3fGqr%&%4`j|{u9{v88;iC`5=p^gGq<6A+`;|{?O^a=e7I~
zuf*)}+Mk2|n%ps?xA&nUDB!dulyBm!2ikl|L=W<3D0`9I|Kje=!>Qckx6#$0c8azX
zMJN$Tl+1Hd5}D_)l+0u1%nhg%rI0d~d7jBKR6@pO%uJ??%RDb@t@raR+IyehU+4UD
z-uIm6x@uo`%X*&YJA9`5{@h=_Eppoe%9jJcq;D1;P*q@#5p!9#hkAPu?nItC5}K;|
zKwNTDUdhSQ!@Xgz*X#2B!C*>2nXmdGQ;`kqgq!9q)d_^}pWoCGlQgBG#n}{ss&E^D
zo!qLubT&r~qei93?~&XE1Ktkc1x))}C$o*elr=9!EPwlM#&nDsNm-%#+mWRld}PG}
zvIZ`wn~?_)+3_6#ENPIBb`ZY`YFI;0jyVDdCVx4imwzc;%?KEo)|*3J-WPhaWyX0-
z07H6{C1~zM`dELS?(G8!g%FKOeL|*g;dUURVSD=Y*DA>(n1lp24$<9zLAkc2GD@^g
z|B==8Yu6_rJZ4yVv846^!SEm%LUtfq3dF9n!8VzRFBwyG+p5`1U}20MAg{$spa>v%
zL2vrugqwt5V$#s1Zc;wo1167)tX|m8o^scKp-UG&RHyV44&1cvP(9t@N#gCu3vaw+
z9m8iGQqw8ydhRNQ+A}F?zl#WkxSrrk^}zs-v}+@Dl<5pcZnK3Fy#@GrW~i^mg*<Yw
z8?zv$`mr-_M>U+~uZ+e?ruW$|*QZhbg`i3)AHOZ@Ixhe2(*_C<LVYkO(`WH6y#gzQ
zPaMhNg6fWhKp7!TIV;nB_;B#~ix<CCitR$F5XoeHz6iys{*)v^PuwPNRqxs?r<07t
zl6#n;w?|?x<zbioN+;VN((W&CYdms`Syc7eVW)YEv3;&rD3!mV7%PYxX{5qx+#=&@
zxq|CAs=S&er%8{-=J)<y>kFf&gLhK}C^HF)SGXocUyI(Bi@7N$?dy661!mANnokwx
z`DO_%|GMp(ArLqWK6<xP9&Q6HgddU#TwlR$Kor}d3WP{4RF2q@)52R|`vFFI&2G2}
zbL+FQU23cg2s-R!kHJE_dSO|?ZzihuqWM2AUcHjVtK2csjTH_{n5PH2$vAy!a+OtB
zG1cXxPQSiixuwg0t6M1Qy!Q7#`U{S)y2spL5s&GdnJ(`!>N4ya-(EbP=X<BN=H{z(
zOHPA9xpwWka3LCUTR@N`C(%YmNF@)!br1)L02e(S^(%lFBe<<hV<ySwF03agig-jw
z%0aI&Icnz&QDyf#Of0O<{`fel$)K(|&++VWfA%_=)mv%%N-uV)KKROr3_MsJ&b6>5
zpBKmHb$lvETxal!&C_E8b(d!XM1G{d!+#_!dT#Hs7rA+XL{%A8*tPEeu|nEh1gb-a
zRKR9HaNgQ{WzX_ti6-)(;D<$+guqMpT0&{ztr@bnK+@s^i;KIb_3st#jJ`;~Y)smO
z2`is9yxx}R`P?p*pDWGRd0cXsU;Jl?am#PJ!cCLXtP3BEbwa-ahbH|}Tfsu3v!006
z=Y7sB6NQW4N_eI2TTZuT<_(n<dgFEDyhJ>wvhR2R)rhbN8yc?U7r+$C2Nz!Ba?{~%
zPL?L*QH0Gcj}x^8(?X%Tv8TWvEDgL%0aZ(qM?;WZ#rZe*J*Zy_<fpY3{LpK8P(H(e
zH0A{x#J{G{njxv%*o^CUxw)UlK|}<gQk2F$7mq^Tq0*5qOLtgpGB%$HTvu=1A>?Ij
z^zyZgI#7Pvhuhxt?>DbHuRs+{SpJZqbnNWzw0*}VvmC?uC=Fb`^*hk^(_%s=9my5u
zSU$1&PfLfXp@w>{Wu-cZc{YFVcPPD;7+eqK0#F9oWMTz2Bvb8(K1LLZtWP1$?mC)e
z%pie3QG}<}%fBx&U~t@MGdcWFc+#tQn8=P?i^!pJQn!kz3H?iGLAtPMlrvO*i6F-n
z|9-mX-RvVua75n1g@Y*>W_MjHtuVLAPenB?dwdlkQUfPt0BT-PgtE7^>Q6O!mZ`g4
ziWM%zlC7+Xb_ySCe2d9v;H~PoRUpO6(ja$lNKbZqxhcoto6zL<?PE5k<~zUekXp%R
zfB%ych;cIN@Rh;0tql$MzgZLW?n-GP$i1z-{Mq#LtV=`A%iF~gcIH`ML*id~JnqQ9
zLo0`$+dX$*ln15(7(_hvy4Hl%%PUjum189c=<?I!Muhmb8Xy-23Xf;Sr5Y{dp8~93
zcT#PUg#p1-fO|37>v97GUGzQz#Yn@=tx*P>ckgzA>)<Y2PnjJ4@X1!Wv@kAsp*Od8
zqg3J$OBTDk7YuLVT)*nf658GUxk8m+)czOsw34lvj;}kdPPTMq_lFp(&SsRd?x88S
zm%y{wt|5Fk7qr{T#akx?Yd?7$a!ap3mPxxQ+U28Bhu^XUn$hsnwbMh}qAkA|S1(pV
z(8**2#ggmPEHil?iqZ3+adb+)&8)EnfVgwZk!5&l^XeHN-oejfdA#7-4nG(HAdxSV
z%a+Ru9@UUsMY*`#Ij(lh5uFc+|I|JRp`MqT-cjJxvD2%+r>||NFJR5f-S8`e$Mzc&
z05YKZ;s5Z>K$Lr!d@<Pz_||a?2`R&YHdu>RG{VT5ZL|Cfuts+XvT9c030H<{7%3%^
zpl*@`J~@nB{qA=)>0wC1L4Ygi=?;6I3W;OC$ip5%_AGRwvswXX37dILM?hLWgVvy@
z$QvKgwu+6QKZKprF^brpvtNu*j6mxB8-W9=H;c-ZpjM1H$`G*);$S`0a?Ww_eak6x
zAtcHKABKuv_US!QJxJlSUOO|49W&43rvnU{iU}q_g@3n8&hnb%^?_e4{~iKTgwnrH
z<+(e}q^@4*-N;wFV)FBH4n|?c4|ZW>*v~HKUt-})4Of2Oq(4jEhhM@?8<aXS`#mCi
znoJ@)A*T0>UfZTnX;=~vGl<0ABP08%W_ab5zCJNI--;AIkQ4+dC~2l80*j!g3t=B9
zR2{%~L6IT4j}F3YvW-5bqc$zeo^L+l;^TDhGKB^er_;Ho&wmemL9m=lYuD;e-V0-|
z8E*GpZ@*Ju(V`c!JSlYBplP}#C#`~o2COM|WxBu70v|{Hj6vv5h<YzHzc1sI#-%5E
zsBUldI|IU;YBc8e4FJ@Mm%42l=f%@C@bI@HQbbLO{G|lpAFu#lv4uMV*~t93J|`z&
zaF5z`l{!vC4EbSu$t#$*T(7kWsT(!?T;xEI&<}3U(nJs(;NIz#nm$wSEy)s0z7_bh
zuH3@;fY=SSwePmkhGf+X)KP>=1t3`}%-+Wj0;-V3Db9+S8~J1m7HbM|(*<Ksh?@IG
zuUC$2{u)shmqdbd2sTp(Brsv!T~Jw}BAa1tun=t!AsF-=juO=$bvPE$nb$X)b|(|?
zn!{PPTULQA%FJAgeK3hfbp)DonDj4n<#;}M&4Uxg>}8;a<Ky~nKM)PQUpKby@65`j
zS#XGK&OGA)eMQQgay4Q3l#hkh_|(9lA)CI}a%HOY%NG<>C#7M4RBUadm10EFfDgx0
z1J0R~zrA7c2p~vsPAU|dZesAX0QcUmASjlJu5d2*E%&2O6c$-CaHyXk>V4sSd#5&M
zqA%f4QQQl7LjK{<OFTHRsuNM+bd1ro+gqW)E6XvWzA}m0YA}buQ*(G)BEBISmY}q*
zd-BzfZ7y#T8@GVMDNO;7$h9)Y>iHlGo)0RPZzr}OAcG_}ycWce=Q+qb?mU=GKwdC!
z;~J)QZO@+qYwxw$s8#8On^op)yHtG8gnMJXLcn82vC_UObI;%j!?fwE!F29f(a-t~
zc2hxY68oZl+#twi=yx{+D1Er<Tkn84Mjo|UneC3eFZ~HX;DpSAzi(|O@<3hrq#j=j
zklE`#TI7xvXD*mi^QC#zWSWTj&oW`^PTq5|kOGeJb*y)_$ssv!(ZtXXZHKZ#yHbtg
z)}DXn?HMzKXvFCOU76Slx6{Ty3RYZ<T#yW+vR?Wuo(NCf(;8*Mc)gVGI<P%8_1lEy
zTO$sd<*)Q&oo3bihYAec-ET(l2%VOPc8xQeRGriH>ISRb;bF&H?245l#Zs2Ey#>>M
zBd7#xyk3iy8uhj<R-3rQ#4@3hh(%JOP+;v!Wujdz4^mQVNlW`e2vCl9Nm7at1rFqg
zWar+!6nl&J?OR%0d}~}VHTrA>SO)0|^t@9KwQMvht~~knt&$3R?nQ@X2k5Xx_S_xO
z;}Y(|6r^RDnoL%|^qJ`CNZY(K$PA6|X{sY<QwLAUJbd^t^#q;P=*EU7)nE2gkKtD%
z+LD$VgR(l}EiU`{`ArkU77PibyP!MPgD2P~6`sBIA+*@8N^?G<BjvWXs_ILPB0~Zz
zp4>3GL;lO6(4uOF44!JwuI=>F@pj9p3dpIRf5u8pOPrN#zG5Xw>bhtSYx8)}1u4f@
zx)50}PZ%2XIP>r~8&UJ&aiBP8U$jxPGR+`yH(9+mZ-gVY|0)yz-7X^&Gg2C5E8S#<
zYZ&GU?dn`_T6bO|Mt`k0ibQR->T@@i*z6<y+N-<5E~|9_9k(=o`Oun>`QLF5m8n!c
z(|-CH)>sxG-5a8C^8Iwv1ro6)K$OjL^qpDXJ|0TRaO4M2HxZ3_9p|^C9<^z~Vt3=I
zZr<QK?a@)vvyqzo-;eo6B#G0ak4eVGqHJd$bQBFE#Adq<HJkq2THK}RAS&qv9Y=@d
zk+@1rl95bAKs)Rul?UXW70$3xLHYOMP9KL_siKd!`NT)F@O`x-2t_FBU9^bSBc_Es
z5o)+%TDH`BH<<Lv0D`xodZ!y|!F+}edq68?0%PY&6l*a00&5*!!5_pFetN!293v5e
zkZ{rJ0%^{b-{YrK(VczrqCS#W^UQ8_)>vs_BuvMHa14TOzP+*1-h;D!pg3|eleQ-K
z!InN~!Y$V=r`X~nqHJ0wXs!ZLa@-}IB}+FWg;$X~Ke)S_u1rL#pgCu=t|OiM<#EB{
z=8IQ}IS-afQEsz!p^9ZovwSZ%>+{@QCmp<&a6CmmLh!o2!(<%c`GwE7LbOVA^P6io
zA0dXcPPe`zP5p2M={ZNXrSHJ;wN#`gupk0qcl&egF!%g+S#Jqi4A7h;az3DAz{0s=
zfEGB_xZ$U*y*Zqhp`>{{UaaDm4;UuqsaMIb{vLnz`{#uZ%e6fMJe@fp?ImFRe(0Y2
z<9#$dov&y2vboH5&9-_=o~g8{c)7{e9}yq3`AxQH*ORTFlald5rWI=D&6TrlFJq1u
zV&7l7WhH5!QF`piT^F&Rt%n4_a@~61{iyyO1OHQd&oGKxUUxp$htQ)u$HURy9YJ>G
z&QBNz^q0fRx2CKJb0lI`1qP}IzLdTQ6CoMpe%3`>CQy(E2l3BM!oWk#J^UtJY*aV_
z9VzsNu6Cx`)I|5lCghR24&0VH95PgvLMlr?OrP8I$$*7+bLyY?Vd{TnkE`+G*|#bx
z4j<U6gsf5mb;F%jsx@(vrE*A7LcXLzK7A^nLlgJDVC5I#0A>1A|N9=7j;r2wT?0S|
z?;L`v)h}+J;#d;xo@300w?mE|^&BTv{~jB&==Q<zkly-;JOZN31>Mr-bIbD^gN0KI
z-h?QbcY|J-wrsVp*;2t8;c}R|dwi3g*Zt4FU>wOO!I4C%E{C1%_3L33#$9=Ln&dza
zz3%WE>T?9FTKIu2_CR{N&-bpn6jt3IKz1$|E-ykyxIgx8<9-XCdh1AG?*{vHLd@|A
zH=gm!e8~D!BHUiO^1j}2>DZ^6CokL`;a?ex2*R&S;^o36ab3hvx%#Il&Iq*khNj2r
zY#Wr$@`uaTIuf1FUy~D3zZ<Z+iL>*WhSm;vTOL`!6@4jBL4Ypb;*Gls;jf=|#pTn@
zu<&9Gv9u6R+;pmVW%-pvNhce=u6MoF)yJeuGJWmun8AZUBj9BFp8mj&N6S9jN~Jk@
z^UK?mHYV6llz;t&$mB)trh+X&a5JhHzFiRJ#9=f)K;m}({IirIu;Uc#x19b{tTM=(
zX>^|w>-`98H`O9fj3m_?ynhwLy{Cm$u*sse{~lk;)w>}*675&c_*1#Ok0rT`Q&YJ)
zWVaoE!4IZNd+=S7udi5KLruww3MN3*vdgHm)+?=J%FP=F+Hvq5&Y>Z_Q;o?uJJ@;N
z=a6d(|3ZI}SjXv0wL&bmk`ysMV6m{u4{Fbex4_e2C8VyYqt{)374ToBL-n2M1E1y_
zLf)S$b-8wWD@b71(|E;H;%_EsqJYZD=|jZeA%A%15~qca3b&mU4^|rA{$4Gj$-Zt{
z(-|aP2`|IQ<NQjh!Km|7=Sa{^n(O7=3k3?dNgVqan602w<A<?<L72DjgJHMV5B=Zr
z1dDz<<ns0FS0tXOKXS60E^y=oab(juJjegZyD0cK9P`w#R;^E_w>I8)SUOLtD+cO>
zFUYH9^f>GHEC#5f-j;0*`O{sx^!%Ac;%K}qVb--`$+Z(+L?ws}({Wydfq`WGj6%?K
zPY3wlaqUNtGd^vJFX?|>8KB>@>Rr+MY1(joqjV(3XJd>$oX}`|mkJAb0B63;L%64f
zReSNX-jUvXoAD#&KN?E)?~xd<Uq4aUnR2@`0XM#MBFMhF>Yx;6CfMSRxRwX|vsRb$
zyx43nFs#f`cFP;P=7XW=Ix+wH%;vAk;A1TGNnQBc$%Mx?2cX1@`a(gj*|YQ%nqk<^
ziRMPYnoEEvq>uT-y7d0TSrBtPSJSzX{VQve{WJILUrJw1PE&GmKT&zNrFlyH#8o4s
zScMO&W6vJ3GF)dUl)EOtwJiRr*5}jTvbv%VhKm(?i^N=uHQw9Tyg~itn_EQsbp<Eo
zrgDD3BgP)dsPxIDu=%*oa1TL|Maa!knqUnCi?^R{!Ih`!>av%YH=4eI9??m44zJch
zaiP$CrJ)t>PsFa*U%H{z@4ix2j=rN{-bW>Vz!&h^ZwR=_`4kC2rB8eSZ+3S!kY~dW
zetK=`?{}h5O3eFXP3L+A2`?3)m?+k9yzp(Q@~q6hfmH2^hsv48qtPC-=L)RwYJpwC
z>{5N*pNy^A)6YTuicyH0ndxw>eRp?vf;$1GeBa7+O8?`-saFGBD5)tI*P0Pm>Q4r4
z-o_#21Mn{um|f64a|EomuFFR-HCc}-Rv2a1)0L?hWQ)1Y?quz~!zLuu2|{H@{=Poq
zG(PMXbFkk|<LgiisdO@LfnE;cTm2qr!9+IDh?PFZ#Q-{c7pH|$ZgX2$dMD!e!A+w^
zxzuCKnb+5@ZD16Tmq)s1pxg!BRgfh;V2y)tbj4@%u=_l5FNM}hBQGDApz*tU-=}(`
z#3Flg`7R^IA#J)nLmLZv<=SWlrDSwtT`OarnW(0!d24<I^Yl;X51pc<*h7`19Hr4_
zTCEwm>Pd=Hxc!y=)Qjp#Xvx`9oACZrM>mP~{5|304H239!o~q5V=79@pUqOi^HUpi
z38`05V{pe(N=^-si;!=HR%)*vp;*3LJxAzBSm48;LGPfQHSzP^_d=Z{!XRn#gPrRJ
z9`ZR<?4g}S0-b8|A$(bbx>;hydKXWFOWR5}V&5abx#8)5C-x4hyez2J+v6GvKUxl=
z2`TCJ>&;i9u=Zs?r!?m#w>AzX885AkKt!tlZGVhSzx8o*$nQ6|?7+sn<f2<g=A22=
zsX51s=;^O?QtEeWjk1vUFyGJ2e)r8%DKHZLnw;rcX)qrK(cP|tvq)9_Majz4c}`)S
zD<m#W5=d@^Pv!0T#TXYCXL*7?ZGUf}YM$vWCLE@`7dMv)D<t*>`BgY6hB_*5dc({8
zqLpx$$P{3S7b$>XMl&KJyaTaY2^{bMi4Z=DF$v9J&qSpj*?KT~9C7n)muRbBwjef^
zmY|)Nd+0oSzC~}-0v7C4>>AN5rEPQzcHG1_?D)#~YvYrh5CI~QM?D+yD$^0FG|u(b
z<V#rd<)?8<HtOhi$!0amP8tct??cBHt=T7snu6cnjM+!3v4@B0NU`~rXUxCJi{&cU
zw36!u^%#B0$0l<bNCMER#lzb%zE6XWLn#^##V(&+n$`jZuzr?anW!UT$#*LKiOgqJ
zct-y(=w|Ud?Y*d9v!JyLvx)!<yLRoGB7K(*f3^lAU;!?8swX2Uh*@MbcdsnWMmRg&
zd%-}L6#Y~E5feg|Sf7k7O+<9<I%!Nd996ZkbmBe4OcL#<RYUrCPA{-jdSN0TzkYw`
z4r0v}SOy|vQf<&)lM6atwVZ#2KomKn+tv|#<;nY+?^759F@xQw@(dN6Q-)EoTcA7_
z4fP3-z4@7{p5#)?`}8IbI${uJ^5Vf`*;c)DMQd)`45q~mVaYAG$Avb7NRMhS0?Q(;
zR@Z><0vH~)h6?3d@rR+|`f?B?htijr=Q`2hJcj&-{<4NpJmCU3@)TYye<@kUVyOEP
z&zs+Vx8@lQ&cjGM<9@cy6K5YCQtMV~BGt^(l*}(Z2+t0{<j}45d42@}fmOyO{;`b%
zJlKj~x%4jJ)6I+D?njXTK8=RmqdneKo2uGSfs?)lBvQ+-K4qT(-W3;>{I^fbSdMD#
zK{isw|I;`y%aC}NxY!I|4k?CvtR`bP`$0;}=2J3lrcEv$S-*Z6mF3MyRGLsxA``YU
zu~OV?MMYTpOQLUsri{-kwSKSHmBY?A+I<eOs3wN)gFPZJo^^0#U@^h}>p{Efsq+Gr
z-<Ht|VV1SSe#{c28vF`x-Z(|9{jCrDs`bVAj<~C06#FTllTrHf8-SXxR8|*j-1|%5
z!?8g=E$GuyZ)*I2G?4?KIONm-Kp)^2Q^RBR3{WVk2-poZAM(C}MdccbEa{$1)x5--
zahDs4YSV=v?$FSV9lyL>SuPReb?d#LdgTw!VDCn|!#55=XrmM@oY~M&k3<w~DN6k%
zl!vo2e%jC;{rhi~(E<ips7RR1O%D4VM63*w@J60Y`=q=!aQhbWO^w;vGFeOJowLZ8
z1xH^+EOxXp{M{GiJP{+8?13F9aT_v=5^?OA&T(Iic+f`j^+nYz@pdJ}#u^D&_I)22
zKOE~+Ra13tl}HC!+3oEJ!d2x!d$Otlu(x@a-&J@mgob6Tuc>JOA1)2(QWdLsAk^0K
zmJJ^@g+VGf<s1eKfXE;w7!ITbc;jZGpv{Ip0QzE1#oLv)bAtX;vXH1f+#%@{r#anF
z<Z9V~Eok{SP24^j8uoH6cpKKo`=T#KD6-G0x0$vu^Jb_-diP?V*>&_xmp|Y;YqvQU
zD7lMM!bY!1O+(`<I|uubyV4P9(5|HAHbfH21O!~Em+H(E{R1Tn3^eUS0d1mv6+lOj
z6Lx_*>GS6=ngL~62Err5N<&5E;~mJDAPS|iZHNY?@_eVRBJCGa=<uMHcQ<N2#bb6O
zN>AeNEPpCSuAHkLgw>*o71wZIOw-Vrny5mg+mYvM-WNk_#eCq>O#+M!bYDO@?HT>S
z#@dq4jEBYX)&pb`ItE>R<`5zkF=5J%Bvs&X@yZ1~er^1ITIl43a?-C%mxV=>B;1uf
z#EFiLtI?ZpknYIJr<;h5T<Uz(UX;e)WFHGr#b-GvFV%&^Q(1z>4&c18-^_c8U$+$&
z9ixM)CbPEFzqjWEHHJo2(3K>(_*f|g4H)KXfHL%JHi2ZcGA+l8@a~htb8<*bgjx?b
zy~QYI!|U#m5+ddt+qxTC&B+_}R0_g6z@fRjhg%D6ur6ig;vESRDb61g4}BP&i$f_r
zdi)6F8hoa}cUpits3>WPqHMG0WZC*RHW?%|La8XdyZQ*4sHXj^SmjIZ<Rk+T+v>^`
zcNP~YV5zhqyXY4hkk85al*&!BS>7Hmx8Sz&%{$JT7*m^Ta)Rnqj?O>#QP_7*uB&)x
z5^OXtY-JTWv0sK0+SVLyMK8w?XUP)yztDzJm##sV*hE)3(&#sT3F-aZ>AN$bKCtQv
z$vCGvGLE4G(Ul$rvuRXFx4m4=hsO<5P|DqO@z#gLbgSPBHLuevn9*M3%A3)ftqMcd
z^6X7gd%pZg2>LkrmF@!B8R-R5PrecY3oh9Ue^`{fBx1b{pw&kGQ}PXpeT#!hK)$Aj
zU{^XJ)T=GEGpunz_=k~MZI1caZ+<}C5}^#_?)~G*P3@dGQap!AZH{o^%P<p=tB@eN
z@d7zK29ZI{DzxE%wr#k^Zopzgh_9h(QflPx!>(TFGJ3-XXg-6OWiia0O6bki!DP7Y
z;5MmY>kiOJHb=hiG7LCDiGbCK-0u@-K4>B0S&^8xLq|<f_G@sIRu~&}{r7LKbfS@#
zY`CN)f$o41_yv7(^>~#dl7Tc2x3LYbfUyPI;L65`(YBKP{vGxZSJX?iPikj)(&mi&
z4xp*=UZoPMnj4sdsGFRyhiar^h?6gnc5=8b8c`q6g1!VG7R$$E-cDG)FrDwR;((A=
zkqzar1vVFE^F}fxVR1;oC{|5mvF*|Y!@Tb}B9xEY<4im{GIei5Md7Ia1)ZNCv<$Gs
z06|<=I?m&z0s#sM?$e)KkurnN;hc7)><SVQ(g%=ztO-K8qVCJ@nqn$q@y55;$zd$Y
zmlfKeIHB<bA=3a87zn`405mW_53H>Y(cqRNH2j8^n?wQ0VXNN+g}V6y)Ovkyp1~(-
zW|fNd;)sCSOl6!qxN>i8*G=0u@$*x60OOB^|3F<;Pu>4kD`*dxQ1kID6oJfwi6M5e
z1Pz%Q)X)(U14xZ4MqdNO>aONn&c?B`up>ez^zoNV8M_A`hKN7@cyxTJiDVmQI{1ra
z=#BupJPBVxnucC?<a!QBjLfu@yD~6vB6|*Rxoxw$IFe!EB=ZZ-bq%}lc`r6UgU8Ys
z6_81#m~NC`;y0gCsU%EdDp~;$J?c&cIY;B5b%(3e>`$oiQw3Xq76a6&Rl;4Oj_DLk
z@Dr-Dq&iyiY7Baov|s!vjZRR8@-!9N&f&9mApZUIvzpENdwj>-aZBM?#sQzzToI+-
zPb6WP(;bi4`%|9hSk#yndDWL&bWCNih^|=ud^c&?_OYOM!PF3|wmF-Xzx0JC3iI}k
z8~9Jzg#5|){U1lDYQ~gdc$Nu65~A*_#opo%evFk_!((}|%;HoB12<<bXPH@SRIf#*
z2Bt?A=tGFB-vos(QSaG!I<M?5oTClYk_=ef+ech!$Fwu%^+MvI%`6o?I6$1GMg}hS
z9iZs%xB4zm3H=%*l}+Kx@Ic9TK9EU?lHNeh?^QVmm9Kvg@?h{Oa1;JS(v9$h^9WvA
z;E{UFeHP4#z#Ks+Fx|l(s0K{J_f>!^aUD``-drC!EVGb4b){rVndOpY(MZvt)%ZgL
zcjG>5xxeF*t;V(ONzI0j6MPKDr(UM{k4s72dt^)8RDS7Z@}hoe9qgh1T28<f%G-i$
zJ~04z#=*+xH*V*zJg}Af+k%9Pk*`m@?|!F?EgZ{M@l6uH18gv_;C?9AEZ1T30zHMW
zz&aQfP{;>f#|{DME#?c<!r%(M1$+U743xluM3+E2TF2Z5uXUVkwdO$`$97Gk!z;G4
zbGjoXfXARLJ=P=jT&6|jdjV^;iFn)D4Dm*ELG}+L=_^p)Hbh6KVk_{uKc3mR25mVt
zz_FE5_|dhg&Vlo94oq2vO~0?OjH^-50m}pFcT!2lNtLb#j}xgo-Vx7qlo@MR+$uL4
z%%9qzP%oV#!5S0*hz1eUF!WjdT(ro)(U`)_<N?_FCiXLJ8FSlenV1uC@j>OOZ5V03
z0d^~*f`W0GYXLzN;6B`cmSu5R5GkMI$=nfX-5Y~T1$R6E2!%aaqSJY@-{(p6jHEPx
zeDosnhLLc@B4WFi4ko&J4SZHO;Xc;i&CFs4CcEaaSYW@hUHlxe4i~~m0n7}9DCWjw
z`onJFJ-dmZ;F$qn_H&ESAu|V?_kr^O{h-&Rs?KO%!V8(oLjZS%=yA}wmnUhSA`iW9
z8uZ(A0+-+>2m}0STS8Zc*f>*Oif7|+_X6)(cLqUSxG1J?rQPx93}C*n;=zJY8ZKT%
zW<3=zeXS#~-7am*XH#V95pfka-ZQ^)HryDQa9ENZiGJhLEK1&vsqk2U&)@WneXMt_
zX1Z=g(Q9o46v-dC{^W7i8@{{DBG;!YBhwn2a+M0J3kY$W3zg#vD}EKKVG_(WTbc*^
zXBnYD-&1J*iQ)HD$;Pyl^QGyKfx$>q;c}SBsjqli0Q|m;c;LSQp{d{h#J~fK9EP9I
zUO6Q_ue7TFUAzo%d<&37TENt}c`7T1jlGJ$nncZ5xHj9a4*SIQi8ECHuSl60Hirb0
zdb521nbMlE|C>Bgq1{NECxn*x3W~DzMe8z*TePL02eiKc4Fb^k`<7Nf<E#jvK=~>o
z;e-a|?Af`re)SBEIjg+xKCK(a+r46=0b^2k4nVd~3F$A2e)UHCh^G(cDkeKZ{$9O!
z^(*^9cju`%%@5j)1C>A>0CvvEI@CqgXzC9<(O#QDXCEA>k^G&b{Nn!mLs<07Q^1?*
zmHvT_QE(RJ1sNHzsaC695$|)&-w%xwr5Fd=CWt0Q{_%ifiCKj+%p#ScGYv*_B*qcL
z4ltz72iQEpC55k5(E@wSV(Sf7*y}n7cQ0TE3B|o*k?@?6&<zRkVLOzr6NBC5%c619
z4oyN*GsuZoa7kYR0+sqrhmWmA{Tp*EfZ_rKu7S8}Y8>s+;}gVy69C^QV&8v4qLUtI
zlR(4+2ol^7_CA7;JXS63gkGKoSpv)7gw%NDw+u&84D5v%@4SvNeTATFA1b<24Wr!M
z`T{y*qQ;JzW_t|h5dGI)#Y5r!5OzTTuqwM-x)X~h7qwN~HgFOC<J41<&A7cKP(1q~
zwbgBZ?g_YuR^Ln?t~U$vvx5)8L5gaA`;n!9Y2taf5AINdjaug7Z-zHS;E$oDoXeD6
z_b@5uto<9-$Pxm+lnNm7@~&JCZjAZl*N*-8?vj`$BxCN*P0&J=s&F&J7@t6YmQ$>E
z>ZoEiIu9W35{Vw&kfY3o>Jbszp>SvfWG0HR!;1Aiu1uxNT!mHDcWb-z=a(|T1L)LF
zWwKcSx>8^yiWwnbxqL#mV}KnariuE2g%Y(~O{PB{Sg?Aj*s4sUW4;Ji@3TQ_oL9Yz
zpCJY+UPZ=Iq4!f2t2yNHK{z36yPoW4y^aX8Xw|DNsL`<BqdM8*8gm<Pe-u8j*L)Px
zYH&<_`x*_F=ufPW#eAK7j4sOe2uQqG3@}~}h0fVrP_=#>)chS<7%d_0YDDLMXK(l$
zIJ*UD;pc&WF<7|^^~H?L)P3G}AylRPUMX9FO-prlfB)i%>wOe-GsB0@=CM!y<`t?R
z-6&2|F>?L=O}7Z&=XY#zdb9bHKMsnK33tG}QT5JImCAv??IUJg!R_N2FZPIek#Ef~
z-lBF29Ij1QIfN}M?uA)eHij7z0c&)61>04XxB9?e00E0upu-73V{$Oo3L<al%0k35
zQjg6Na$~`zm?14H$?chDq{>h7gTqh=vt0vllzX8-VnfptFq?z@bD1(#5MY$){ro7b
zS8_mobUah-3CH+NHSn@03e8A)GiS$NhJAPypAwivKkW`aAu?>#KIuxvCbK~nP%8aq
z(Vs;cEyN%_0qUr#)4e=3{49CZr~pS$xf!01sTY(9*QT~WfKn_9ee(3z+3;`a$Cwl2
z9`7@U)_rK!b{-mLH!&?C3Wd;JYCL-6<Tk_LC3(l(u#7TapI#NC1vy9uEI2gVwT_GQ
z1l~G7CdWpH{!g`|@8bj%OsvcQ2Id3r_y7(Ry_hK&C~vp2R(wg_g@B!g=-F<)7$9HT
zdxnFBZ0_Qy=KNjWx<O4IOBDu$vwU=S@?E}AUG}{|orIk3`OBffGNAa<DkvdhSg$-@
za(t<`wD5Z*o|5^i_R_Wc+7IKzZ`kL>U)M#bm_COq+WQ&Zf@^Bd7Rk2)$|#{%eWn5e
zgXI`U4$F?;9Ykgx@}M9*s*f^=B``n6l!Zic7K58OvnoTq(`#DMP5Q#O)6q#Dxz^IF
zjk&k!;&ML&zE**Wz0$v*?lap{8s#+g_BH$30~m;K-L2|m2=>+$t4zIi>t6TGAi)u^
zZN34dJD&aksG5?mWDR7Qa`{!$yac@l@KLX0f{vYkd(o#u#%2(6b%zi%`>g+Hh+XdI
zZ1&UQx`L<Xw4!^xqPc}sUq@AV4h$M_=Dd9pP~Sgp4wf<TniWFF`GgNv0Ujfhn1?>*
z@Z2T+T=ohRMy)^P8AxuA?hKseSKInYUZC4`cJ?~DWf?!}1g})rXn`b13=4I~$9^AV
zefPM*e;kb^%DrB*cYT4e(vqE(%!9$Zm)HGVoCF+bf80vtR9N?Mi2g2HW6MHsn|g6(
z!Vn<a7*R0`WWSy7@YA7aM8x%6<zW9dV-K9tMRMj@ojq{%5c%a(8`C7pmB7y=@<h+N
zkPt5(<l|D5{}oI;_oC!%kUY5S8m|kMt$o^WrlOx5eE!MXO`-@NggJ12bnXqtgm$=3
z5eflxYXU;ngU-J&eAAD!o&dcO@i4Kod#KjTAjNQ{-`=B;5+XWV(g_RFPNlt5`_2m`
zO>R)|(urJ(*-lOGV|-?4jltiX>;=%7k-2DS`j%4Y$rrODwtVHE=pXuj^cI*)LwC?0
z<Kg51N;KrI{&>i?^d~-x_3f1bpdMlo?oc9w#b9pK9emQD^@U|G535G8_hr^Wg5HFb
zLR@#IjYlEAloFx7uAUr7L-NJ$`rpZr`wC!Qt@UQQH1_!8c3tECv`xkZSVoAvVyNJL
z;nC5<F65x_m)}=+_+A7);>$9tHO)H*zWCGgN)`_4W+ZXJ+Chc@0i9SuRUbXBP?oe@
zguWEn+ytoy60vy(w>FFCM%=;hhU4bjC!~TdS`R{E+*`+huwfvYVVGqEp33fe`{6RM
z>y;}0V6M*vCY~tY)4OWj>7ONJ0i6j5;|d9Pk$kr_wemO9ZG_(s$*C-C?N{&{2oWE0
zZ(A(nBS=X@0RuE%2q;We_5Ya>G+C$6H}@#81A$1Jj8JjbZaZ+ha-H$S^*aL$S$5Gn
zWT<>WS@P2r^?;Im7RW3<nMr-3zR)WcCN1nX94kpMO@rvJsFUkp$83se*T71g975m@
zUqv?j)+733kQ>8-<zgSY1Kigoc{CEKD3V_LuNiz6xfS3enkv`htOZUM**+XiQBJq}
zKO%ghB6+SiX72_eHz@$KAMSz|YbL#x65gx;wtA&8JlYCwt5_Ky8Zw_f<T|u6mLht8
zHvYY!^~Z_bLtz_fbPWFPrMi@VRzGSxFcVc4|A`Li^Jgf9Ja`&-R~Uk`J7Cf)v+Zs6
zAq3!NK?*peibhz)d9S4JR|(nzXOk#D+aq9w&(G=?bLp6>$hdUK{iN{yW}A)|k4#^@
z*D}R&RUrEhZ1Zsqpxam42t3;Y3et1zd4;1tdF>uafMwa|L{Og;7vHf&(g{_-LG-;@
z16V!?5kfxq;|TgZxDBm}Rm0Z_t8&YXnYC9r=<t$n0+iYzW_`Pn$CV7j0#USyHyW1X
zu`F%@{gSV3-W5Pksn{n2<uHvI*V!y=LRgR586??<Eg0zKt@?1Afd@B!9*Fpm)+tD&
z1j|2X>b&_3)XM@e6+lP@rc}z0ky~fqg!HnJbr3hQ#@NNnu+>7H$382{{3t7rQXGI)
z)a#Xo_D}|H*777loCYXs$en<WT}G+-Vp2*C!m(tC9P3K46u`p0dfx29S}`xgmy<Bm
z;d<}B&ce$sHz@>`xeKwU08<}&eRr+|e}t$Jss}6^iEb}nBwF@vDvgC0eHxe<A@M-$
z3xQP)N{L9ZrSZ&%lpcwWql4)tIUM#^p`P&aeij#OL+|p%yi9#;J9u%XwOs8}H-NJU
z1sd^8&iVDqGK4Z5z6w+hzi4`<?uKj!S?C|I#a@a~WPm(O6u3~phjpfu;t#e??5e(S
z)KH@IhsV(lA=jRK^9&eq&EG4Eut4JKwRxw<(*u!u7TBHsK{l<^Yx~kPol5oiZHE^4
zs0K8eIh!2w4rVbYx*F=uxb0VplFF!*V(I|%5H(Oxc%jE_d1Fm+Ci4lMjegJLGEX^1
z@Wfy@HNi5u%;2jRBz{z!yhdDGg2cwNeD5CzhT1?-7HQYBlkj;J2;E>V<x&QDOWofY
z=l0OA)%%p?3M;o(r0$cY*OmClwq}nodq$RWKk!+r0ZqGI*i+&xUI5<4;Nx_c)PD4V
z6uNYXu!RTeLnO8TOvUp+WGeo-q(394HvfCQ75h)GuL?Dy9s*%5yZq3Qz%j-VjLBJr
zDS(lvSww*CLzbBXWwu=i8*%3v`%*&nA++2kfbAT+NRB=Q1AH_ST7j5)5eH@Rr&<r6
z4%NYr+8V~tLa+&nYweP8FZI6jt3$!S=Wr$Oq7(*7f`}>rqJbGJ^PlFvQiq*VxCZT0
zsJ<gI3G7|3e9rAn-M1d&)%{|z@ZLTE<q&Gh&h_>Or0!EfM#<2bmICzfx07X30C<5&
z0^8*5Vg819qA7h^4<_JsT9%kr8f4|i>}n68zVz>$=7xOBD>kSc-hKV%Cv<u<iFvDm
z(uj+OdG-hB?&*>0N>n^A06Ju^q?nH#0#Y(@79RQ0PCv=^Gt4qW7d+56tw1sA=3uT8
zH2f>!K@BRqVbcNH_2Bu4-fZjPBOFRdIn$TYfBUE|<d<W0AZX(^|H2Z*B{0+L(>$_t
zp<8QgY-|!#5JH_--ZNZp*9HI+sm@3F;Cfb$tdIapK@@y@R(z7LuMDQ`s5*}6Za(r7
zKmGM9B1N(2=5d@24v|~9%-irxJxRf-oZ$6JBT-Wl3c*NGdFN8GhC(fX9QLVijcN-^
zqE1zS;2(B?pohr4O;G}S9Z~TdRbo1{XCLkj=0tRO1(F%SC|z*3N<n0%=85nPpy`_K
zFTTPNqqyiXGN$Wza_H60^jeU1nmpTxK;aj(?nwphEipg&zLz5);ju!1TY-{JJz)?O
zzkmT-Sw2=##D?oBycPmQdIiG1L(U=y4ww{M58=0g3?=l^AS7dio;@T1tfmx124j&(
z$4mji;jzR2c{5gof((>);ljDCx&eVh_An1m#*>ceRt<sDA1v8|30wjqy?}j0q0N`K
zy!`F};0whPzoCT)5vs81b)5n|)jFF5-x+JGIBc6_5Qz9qgP!ZnkgzO$oS^tAd8jZa
z|7j@gS%VkUO3XNy&l{5OLO6@G+=1Z4XCkD`3IAy|=X{NffK9+&#{GZ4I6H_yL9jR2
z&W-=RWz(}5@yX#El&+DwgyN5JDY+0Jth=V>8rg-%gE)cGcqBX-sPhRI0D&11@Re5!
z{N1=bkSY+Ajc9zpfL+M9d?<zM^-($B_ER`Ii6CNF>ZuETrp_;nAs0kMSH6MF)$YA8
zZByMiRe6V$nTtLxM?mquV<bUn_wL;%u@XMl{6UHW<W8f4@_JWSl#(t!Cg|Wj>_HO*
z(RCTi>)NWF;>&suRAt_OjYDh~cehsft4A%1D2m{N0P_()t?8d_@&MJpqn?PCN_lUY
zHtvX?SWpgcm5Tj|Cyx~PN5e_NWSPweb`4G?KG580z_q^=$~0ajwxJa)d2ztSKU8xG
z$mUc`3op*hy!M%)*uwzo2lgp_*|_N_|9a=+pr0TX?Lm~j>RGQ-6jPIWSjuH9uf?Nz
zy9#f=;n``|^AS?Cb$reqR9*8nwz0hd?AP=vECSnHpskiF7!Pt~k%cv&RHH)?`@9wu
z{~y$*;J&A{u}_V}ovDfB5;^XNnptB8&=PQz8FS2?9Hd{uWKFv4Z;<(83Mkus)f*5`
zMy(HSNN11DTu)h2`=)hmp{N(#K{d0_8T&wWvNmPPzr#JReUk#k8H1GAcdpV9z>yI-
zw2*}Jk!O?GCzX9BY}}fl_b~PTCr%Sn!%#MM*QsBtn*d7!HZ`8yYEK*wWS^Srqaaap
z79ZR-N)M)%+^7KRr;fU-AH^ry>ItoXzht~7Vgq`4AgM4g-}U7S3aQw#GsD8-Es$i9
zx?g7@Ha#T(>#10R2&Iq-_~TXzUMu$Qf2=Ybk4$L<iW{J0tF>f$i%p)M7wvN3=qOt6
zR0XmFKw4)=ay#MlKeqeDlP7z{`m?gf*q(<-InfOA{rptB5FdnN8b7A5_Nmk@y}lB1
z-()y}4F>|RenDa&;W6TP;kepD0vSnEj^yh%Iq_oaFFus?*uP>=s2e4hU)#hq7-9x6
zj_PL0+8`5ERg%Ttn+n9sq{12NH0A2IAErI~R}a{Tiy}gT$VgbDYa1LGf6j*^$C&hM
zXJ@VYJ{JRw-jPvbfgK)MUEnWy0C!~(>`1T3@|<J&Dd<4lK}=zCq;o(<PMzdkhS(Xf
zt@9I+u+#tOc!HE&dm0O<JwB#^vJz5c@sZ$*Sxj`lg7hM-?bl4xG9`GsE{G#7CMk`?
z2t+onEiDbm8*u0-EmUZw|0Camx)I_}bwX!?Zy$zOE{8}3TDzLZ{L<9)2We7wZ#d7+
zpfxrYWK_eu%j)tTDX6R?9u?8BJ~+5(7cN~7HUMdRgcfeO;y7ijt%fZGs?T>Yba<Ip
zY#kW}m}Zk>pv9RAC1l6FN08pB)x(7g=I8uD`U9hJJzH6)GsEC^2(X(Xj0dM3={Muu
zE6dgfM&6h?@{Ei-6peoG=LX0K`ocBA9wXvIN^_wGMEgqU;Sm7EQ6E=Elu9+3TeiKp
zgQ4GgxjNlKsh&by$~iHtA}_l+VHY6(P^J9W$Mi+h4}U_B(x)pTLb`~)aZS?GEu<?L
znxmkV`6^T-gJOge=GJCAkxulW+l8#RoUJ;4=k4*m`TNhwz{nkoJ&^WLcp9c&q))dp
zF~cu9&#}`s35T??DBM(wJN*<{Et`yg|NW~biNX#*W<*R00*E+35}^lH42Oo+DB>(D
zP@w*hW8jMoPw;0~wB1_*Az|=O^|%EQAv;l<B9Iwe-bC6wb!}xzF3U#`wv2Gpuigoz
z1@w1qz3b7H-9DiC(~Jom7b!q|OJ5%-&VvZ_HvevWjIxk1ntE|g$tDYHFtNH`DHp}j
z#(3=-ojU=948A83UV@w6T7nlBe}5F)*qE08W*jWE!pbIiFQ<tgIjq4T(Uu5>v#6fj
zjPjJeU8rKQf6EvsL+G~Gf`YHH$Br8q$^n&KVH*|@SnZwG%gsQPloAMqjav6&`ZS-p
z+4dbz!aY(jI^J&u3c#Eo;06lC)wtqc10bxX-vg$;KzTM1<eV%4*(~rJn_|scda&84
z)C&>Fwdg&lWZ{1ofbZQ1kfBOKdd5v^T?iCjAWN2n6R;9GzV9gF6#7|MPSrYhKVBN=
zEk5Z38au)^yt<pwccehNCn^;pxTsW+Z*~^T1Yt90?gxmBY1?OeUY{>x{#C<jeqTXg
zJ-_b<sLc9lSqeLiz5^8}duuRx$ZlP`xC>N>{wrcJtF+SrhiGY=e*lr@fk=F6+kH?6
zMLMTo3$;dBQhO1Fbr4mmv~^*`oAy?8CqP3an>=(~X$)V*@tdz#oIj5|8Q3*M-Wovt
zka)y;^>dI$ix6PCb^!|o^$Djkh(gTAGyA8SC9i-nJ_p*gF1UdahnFx{5|sS$cD+Lm
zwyHqOirRE5vT7-fXuIsTFxDM3c7AhpHWQ*EiOZW<rI<=YM-Sw*9n|(qfGP&tWc%c0
zQP1V#`X$dh!+AvJ|FKl7euDo4X}(s~mM`VYvWP6_B?wYMYIcnOwHK%+z;N-@D;#3v
zQ`u>bQvYjsC-zyALObncK#GU3=JuXu8&|nX%$5dW3`A)h(e^!A0lm0#6)%zB29J)%
z(+mngpnRQdu|U1<WQ-jCiD1yp6Ch{R5y*>m@hk+0VMk%Z!NW%KASyZXKjJ@ce~gan
zhew0PgrjBNe#%8&kynVMUU-sXd-E07ut;S0)R_eKGustGRrngSF``aiKd74wl4B*@
z7OL4<a3kmCgj|vE`{g?0pr3$rS0D5$Y>i@<meecA{{bg1t5@9x39Zo8JVfE{-vC_W
zE~e1t+=2k8I6iQS0v&aC$Jw+xP`iLb7ZE@Z0;SFVx!uSi;h;zm86*Tk`w#_AZAanf
z*@SgqIVsh^_C49zP^jk&5|kRBHs_#4xgq=Twm25jerB(~24d=n#A7??M?jo)kNN;l
zo>}<di<CE%29G`h6rnzL5WSj}Y~|rT2amDo)X#;8rGw()%@E5@O4p4(u!SdMDnVey
z07E<sA%XLZ9Zg$98W!3`Fa5_#nLxj*^mbrBKd}xZzg}M%qSZbS#(EIh;#?-OKYHPJ
zM32-Syc#PC)%72>F0e%ZKi0kZub4i{e(rzfxhiM>HCU*(#$dV;d^N}h0$krZ1oPUt
zlCwbyW@@SCE2Im;J>agBk=PPr1*zO$e~!5$fAnU3&Iku^@<Z~yN3=l6e5+qTz7+z=
zWsvbFvtJB$!MP3p39`7-KOdyS<byaDB6{xQdMgCUbCBLuNV<`e2T*nY9$^AmGYDHE
zHtA$95I0VeO5w8=m?R`N0TvrsdCT@ci{cofx?i_|h0iWGOh}0puHmFO6$(4D2ng{F
zJ$D!-{or36Ih2MlBzZ|(hd`&26MQ{*=}$I<#0%cI5n!-+@hN$*Kffv$v>_1>^lV<u
zozwluukC3A38YdlqG2P?uyxM|Kqp!95P<YHT2nERHLDX&Ef|SGgRFyrS_q{C5mYqa
zUlQxcDFfPSrByc~&W|ua%WD9kg)GLLP@RFKW-}l_O;)(43uZw1s*x2&w&z4;h+DVh
z8~NQ}SA{Ll89iqEXA}!`3?JA;LnL_l(B&JgVD;QrKhuMB$&#x!P`U)kor&bH@ujRP
z-}~4AB0VOOHPDN8EPrd%GZM&o>Ln5s<dxpC;iT+;(A?Ojdj7nx2%fBHoEQDMN44=Z
zbfY8OPn7~oQTMHQs6UJf+k&(0SzT#jO_K+{n&E%vqYjjq?R#t?D!1?e<veHxfqrZg
zNEWz+-}-@0pL~d6v_K7w;#0d5)8@Q&@Zg{dTj0=rH_6)-G#Xwd5#!BbJ`Dfm#O>~J
z4ieul2LCDjNc+A1@L^md!3e$?@IVnJ+Wz!sZL1(Ix7BZxg~;37`KuB{=RmN3KUqix
zf{3kt0~E<;bylLGuB4BJ#I%R+(_X9V4<q(|-F1vcR^;9IsF90`dY_(Ym|m|zNnXFQ
ztL{zPs|vR&FxFN!3RSJ#x5Qm8?z*LV?%K6ij{|6qig4vMx18{c8)TW$%`we*c*4}*
ztg&I**+9S3T@pL#9ZjL*IpFByi~FOL=fn^!A<1Ed|2`rW<*2y!@#Fg9i6oQ4x$?E(
zoSbsW$<`0Jdb3D6cJ``Uvn(Qa2h(u{cIBZ?wWw@^op9Y(Y2@eNK*WZ)%kr*UJnRcO
zm4_QW4YduJ4$@zcFIhIlkJfP5I{OTkV@zza^a{>ShU_xJ{Mq(V-_C0)jD)5pMBpx9
zF7gY;JJ=seIT_hqe!s`YMz21s)7C0Q(yOqfV&MoQs#)~_R2+~i>YJC3+r_2N>G}Nr
za~P~vFzMU4Qj@3mX2keM(X#SJ%kBr`Aub+G85e|JV;7H|@5!J;nJf3d*@4kw3oNas
zhu2&O!@GGd;Ar!hy{*&6`J*Q)@a0n9b<ta%16Hp0>J4v4J01AXds5FG_VMPl!o$<v
zpFHf{{?V$>YmQ|kFv&~Mtk!>dGtAZYU4@ZqYZjaFZ3PXKbX@NCL0_omp?-(yIX$nJ
z&K(^&_AMci3(psc@=}IrGes{Ggix_6lRGJ?lR1`G=lFDL+T~u7!|=j|_uomASnmiC
zQnf`<m2zfzX@`J-VbgAuxyVk@CH5+2I(mO@VZ~-B?=^Y(`*~P&`Q2-M!nnexPu;c$
zL-MA&SE2h>A-9LkgVrnxl&Cm@tsxhamW_=;!@HHvhSm53ELN)TPO}cbVTpNH;I-!E
z^Ft&N26ySf?K^(e0@q|Uk~%pEsi@e>Kf6gZU21D1E*<wqNw~18GnsRa<to>Hvwzmj
z^t+b*voRau#y`=Ht9FyCVoBpKIyyRR3j9yx5g7^!ZcFV$l`#DC7Cky>mZH8*OoNNA
zg~g22-E|j(=`^&+nWYB?&d%KW`D|9COK+;pY)DgugJWe)w<<PonQlC{IgwxEn~tj<
zI)s{-D&a8LeyuO7I>qMl>1mlw);^O5WBO;UnD}j-ey+Z3vki>V_j>S?nA_UgK(LK;
zx!vGF^jlx%2nu@obnLv=_cOtg%vl;2Uc$exx6(^8k_c@vb}P}waxAZoc^8lU9IV=+
zr@JQm{Rd(7rH{x$aXk7GitXl3QFP)JgR9ItVd4*5xfZgG!fAtp2M4{-va;fY21nH>
zLzaXT$p`|P)T2Gz%Cg1j*wls<r&pF*(r+rTEuMY<^r_80hE)c&h+`o-uz4<<5(M(l
zvAcXTn-K8@xTFKrqYPt?ojoqL>8rSI<iSLmG|q(qpF6DE%M#<Hu{G1fat(&B>9a{f
z!ot{Pr9d=cu>@vjFdZNI_GnF(Z7Gkx2DQ>}_TADC+jjK0C+uN)3@_;Vm=pX8FUC8}
z3ub*LJsrAFGAOF9(@YyFTeC!V=Ox>jhaz{L!?JBm&EoIi@Ls8(hK(lqGo!aJB`!Uk
zf7%^+1W(Ua)eG)nh2BD_S9^CR*O$(6;#;#;|1r3cUjLolC{e~g3lN2(_}BY!{ws(s
z{q@f(gA>gE)kRkM_tY8RM}L|UP^hCPckTqiz^^}c<^QFxF7bW2vLYXjYG&Oj$vFuJ
zV>din*-=iyR-NS$U_UPGSX$|ToL*bZb=mKiv63-P=TJ;d9&;V=<LUiA{F7>^_d62x
zzSPDOuj-yYMb<#aBz*Ut=D1R|0{+P(D7~HfyD#;p<Ydku5qC9N*#^(`miYQz6Dqa@
zToet>{a?F2h44_s>h9R)36)hA5mr{#S$t*88~Fc~Zr)$NDF*moGNx86Iq7S<GtRMB
zPZZ8c(&T)0-b9;<hd7C#DC~^AyteI#@Z@)_?0syseE8mG?mw@|Sta37ErOO1V`b$b
zd=0)kmf8XTuF~8@T3s8SG>Z;=`c&C#iWYf%>p#CE9Khsm|DwyzO;&cRejNLJoSs{;
zgw6L6ENhl<eHYEM4fADz6`#c5jd!N8`Lx&cBRf+WDzw;~)JRBuW^2Z-Q-Zv;j%``q
zv^7dZPsDmX?K)}NWj0q9!b25%?H?;(9sChC;ZKUe7cqo6-jP}npFqU&Als@sNb;0g
zisb#Sulv~zSievgcvd|x#t%qUmrPAHbUh{b*JwA1p4nXOzc9Io(o@{t-@epoFz7@=
zq)#9=+EZ<766^D9Kg;{q78wKc>a{3?mP>NV&x5_4A~O$32b|p@d<AqC&DkzgwMnrg
zMLMXZ>*fg>`glDk#m{0Eh81`@3>dypJHm|J{q<#64qlGyBiv!q0i}0q=ax#Jip{WH
z#=m@#KTn^oueZ>?;W>cv#kF6U`~$e77-#|E+P?nBUfEK7LI6Y_B`<qLW9Jk9bKm$X
zrIv$}KY}XBH#r~14!96p<mYde&&cq;O#T<`K^+Df8VL_*X4^ihnJGkik2J^SyA?w;
zG&$Lps;vnqC*6X%P7}$s*?uv21LP8Ad$`Y6>Gzu&PjOaOX3yccc!gaPxmsnPxmZ~@
zmuXDNAL=rM#Sztz?X~vo=~FX$sqhurZ>SmJBGLw!Wa0JL$FP`@55`s=F-J|@d+xFN
z;^ChCva;XbEd6FPpq37Q<89_8zSxdF1FkD(-K}+u{IyOx$k#UCk0ENv%Ie>53uYxW
zZ6e!*Z)$paBtXdU7!6GToO3wQ>sl1AKz`|oY}hiQah22(!q;bn;E}!EMl@xpP+~tq
z+cKZQqtVmQ#7Jz!!?z%}m}o{mp5j>H;<7y1CKhe5rN7nN?r7ZcAq}P|woPy4_tbh(
z%D8FR`}KjU!ImiUZ^ed^e`}!3qvlw+kJRS!BvXf-b`3qR<auxV5zR+bD4Y0ILdiOQ
zD`~h_s+_ajZ9#Woic#UrUB`EKV#?NTmXPsqU+OH6Rti+JH-ijSMajyln?uv!@arVv
z`;EyV30Ibrk0tpyCy(qBjbE8d$8uk2`St3t6a#u=@q}t$o>}V{`B9uGks;Eb8z>tY
z#BLO=&(v~M8RxMCV`j^RSXm9dj4ggAJ=@hKxo1E1(*tr|+|<O0;)#BY>z@(kf?qd~
zg`lo#lvaxNjq;XaDPgsDfrw}M&S;nZ)OFB<ce3?V&5BgT>7|Xxtmr5wkypmB&Req3
z=zelf2CC;ZEF=2%dG+sJ_}MV0bFVtX9{M8_u(N`E_c|$*zyeNG{5<h39%)>K>&TzL
z^?$G7NBw`&UHw0QYUwbDS;4_=Urtx-N^@8zk8obxO?B_VQe#mF&kiCy@o2znuI%a4
zi8fdw2`Z=dGCY0yG&qQnmWC!+Qcw&W9QpF)nF!TRWo5nFCF#L#KuIAJ`w;f|yf5Jl
z>)o#h4}O{@ti9pczx~;XyL3E;CuwL1o2$1<j#7f;G!4z`sWy()lcjR9vfPIGY&+`&
z<;!yq*CRBt(itu%`~6kjSNZU(5C1klH3GrxQ5u?xvZXco@Ev>Ubh-kwlnJ)9At&a=
z@bGYaeVp`P{I3=k<VV1Sz&F&4C^yKLoZNnd*n>KY!wL(dkrfd2J&O?$oOIwk1+RXT
zp1!6CE5*yonn~KA${DQ+4*|POz9znhm9DFKl5$zVw@=1MvDe|(6iV1Aq2FA$+Gpme
zuzmXvxINKC>P1b=JK7Z_eAwaKII+S{3u$Q5Sz1%!sUMZY`PisPC*7m(X65Onhd$3#
z@H`(J5RvdEd=MMnj2Zm9sGry?jBCeM4R}z!EcbF%*tQN}E%&5)kO(@Z=JMiFK3Bxo
zn_o1nn*|Z>MH0q%*$tQ}Zp1!3dF|S@`#s}ILBSetYp8^XT&Zo7#l&%;d#h_;&LF3<
zYc<*3OwlJm7?@~Fa&0w{PRhSKhQuWWmd;z)719R?65w)js2_AYgLt){Iu=~Vq}GX5
zIpe>s$cM{4+-#O2E(H6q8OX}ncRf*tsfn4xT%J^ON#5Mte21SYE#A;Bs!CHpEBrIu
zdwLz`nHOq<m7kvp7Uoy;+GI0mqF#G8BE*}vu%0f(W^gkg_UfM7ni?8M_rGLfLjKUu
zI6FJPHYB;Un(S(>jatYWhjDi;Uuo<z%Zh{WBdQf`+VFgEYc}(^+GjJxjV22CpYY()
z^eXy&c?$l=yS#T(<=?n}|NdKgdJcnqVALRne!Dgo?sTI0+zN3%0G4J_l>53P8Nfdp
zZ!1qvo@n^1`Q1Mis{aFH)BjtWog6Po8}AQdI3c#ucW!f;Xb;|;d>uf7L&~PZN#48=
z1|XO36WxEb<2i*zAr}{u6^#lCFl&6VpSf5nH5GRD$NY3|CDOOa`@^Ge?sn9L-k(Z|
zX%rp*7?|`uUS5vFK$QGVuTT)P$Mz?*O$skO8F8#m>&ytG;N^Zw%MtU|=^6PW(hrd$
zX>;b3knM{lQU&Qo$#&C7?Bf>5UCgy1JrC2pdsl(>tkMe_{L80t9ynMGUTP`D6T|0p
zYaq^)Z5`V#Ad=stM^pWd|2cJ@T88uI&OMWV^S{`8@1Q8UsC^K#yaI}-NLEx(5s;jN
zf}$c|1Q7uR2@*xJzyJnvP*8Fd6(tHtkf@SWavCxtIWrC!W|-M?2l4yu{<T$GwV`UK
zYU+J$x~Fe<-+RJyp7V5&df^@Fi4qhMDBjV}AT`vu;bs1dVSrK*jb{2CmR)+c_E;Aa
z&KECsWnWmhSXuCt!S8AkgHK3E$aJZ?vT};X$wdx%*^_*HhK-z0-+XXsp{&F!xMR}v
zN=}+v)MU`6YGwrR#=CMKDE@SaTU?M<Xu@O5o9ssy>T`{2osM&J$GOh>#<=+(5U6#X
z!IjCL4`OG@&CMk&59Z_qv1Q?Wj%R-Op<`}oX<1B~ts%^+3K~yHt&Rm(f4WCJfAaOO
z$6RW14Po};8OdMpqo2wd8dihy92!>UMyutPE(iPg$Soe+r@z|F;*7t3bK%mBn>Q=p
zJl}PsL_XG;S!t<D23}X%^#-?|VN&rG#U~@R&cYa*a>|Hq*uB;HB5s4ZSvuTW{W%?a
z?zb)D5z-6IPR27mq#Yz&?xmVv0~4v4KiL$0d<sV6#)ZsBYSXgd<_6hGbC|^1pTCi*
z6P}yd-!WHDJRc*u@;1#aTwgr*=i_9JGQR6A&wQB-hkm@wl8>#ILQ`ajUeqEruF0^f
z;-(h)IEGNeHY?wNov`?Tu5Gc~J$(P^TYtVki7{7?va_p=AY7?;8dNODmR9rQU8XfM
z&9l!_pXk^rM7W~;fGZHP`eJn3b@aRSD7}cq18i+1A>Eo{(u&27^eULthuRF#R!eXg
zcbr`)v?mPb)CYXLE@*i*eU#!(dCA1t(VW{(K04A6U#8Tjd$WztxtvbtF<g1ULY|J}
z1-ZJH>dAwvlbPKULUW@H){9F{eeDf(<EPd=Vl3jHAN{>Up;-2Puj}=CCnF=H%Mp@7
zCZxzOwu1xyWziyWaJ&pNM#iKV)(p?(n24p@jL}MaZAWA~({5*$kqa%o1RxG2;o9$8
zO7xUvXA6&Zz`eP@7z}gUzpr;VT+LFr_S5j3deO@J7_0v-c4{7aiy5pc7z#Pz98X<x
z&ZBNe@GiG<9~m_VQ|%YcbQQn}pPtsmD=6TViRkY^3S^P1ttBpZ9)8OoKm%K7S#79|
zWrKNJd;3X$vclTMdV5yEtAtE_DH(k8E-hVqqaNpKe174pa}^`QhtV8}v8@jzs00QZ
zW%B#i2u4RSJ^GN6@+-yq*DF<S?pcA{Kk>}2eE4g7yR*%Pe--!pq07i{{<aP0mzr6c
za`!tOJ)Xy4&e68(f&LFxe;;&*Z8z_RrCnQG?&G7xASEhLI3}Y#Dz_ZI!!|6P`jkED
z&jL}s;~T4^FgVoy{aRJNp&GxQ?Yea7(m;Sn{V%DRZ)LI(D|cYl*S~dppsjs5^3g@j
z3yH;VxFMoE%A+BFVzOhxesZ8+h0{v2F2C2o<uXjGefD_H*RPcZyx1@-N!0;ArL4xY
z-%YR1<hhc!!@qsaGgk1I72mvldldbOwbs+4v5tKb25_ZlQQy#HK(-~wr>>WU)p7De
zT3P@eGx{biYu3+ixjl!%Z*I|5Cn5G_-+H)UXD2P%c=&C5W^iF4L_SXsoW$e6+9v!K
zZM%23r^80d@Q6xKfWH8FRCwzeF<b@L>ri7cT2w!-FIn=_g-Z-`_HsN%3)>N@A^$S+
zmh~@KP)RT{^Ry2xOUpyN3a{JFfJuJ;{=F^^XP(Jl!$L$GmpTYcJXJ8c@9Tv3P@muO
zphBo4t}EBvwu(XW_t)ZB5ij~~36rVeaQ&c{M^t#$e5kj)abzp&aY=Bv1k#h|gyx#e
ziYLqmDs$#Wcy;%tUx~U@`O=$fui<&FJuY~$qg403cV7%VYtb)L<=F4rk&R=K8G4}<
zEsGgzOq4Plw|gADAZA}jUaPUK>T?<lba2yJnMhAdt97wB`MPUl0gS&z`(w5M1vA%B
z9Kj_QKO7*p)RQA*Kk=@vaB-q7bpz*k1q0hjf7q)C@0ReBM(N~hGwjg5pE`wh4@PY5
zr8$=5|0EYIc`85{7x#3@N2JW@c7W8w8~gU}Kc;(f>Y+K#Rm8-?g<_?esgXanT%~(}
zn>)Guth^e?L^7~Ph=gT6J*)Fe%lcfUN*?j?O5u^u-frHztsm)^s<Yj^dDFRi&Uth?
z-|>eC^)7u4;%QWTqnWP9B*H~DC#_02-VaQ^_OZh}vm_}k?bPF?8IH=z%8TKbcCp)3
zyo40`LCgDFWf(W`7}9#~YYPx!85I}K=PvgxxgTU?Om-)~k{o|F=vroXB2_EXEXTYq
zO3K!|wb=G&y>s=hWB0=ZKU_7Pwa+o-L%xbvUH-(l3RTh2L!7r!k$YldVxXEbH|I3e
zR4roo@y5yX!JHgLGlkK#GwN@2@~y7kzRmjX-8&(Rj!zw*?kSzpCqF)Q>(im;aXU2h
zicEJ~l^F8M^#NO64Q!UDz`Y90k*=xRur_<{C3?Ani~LfK*S@WJpluSH+qtm1INkkb
zFgizBrH?q3r{f>QC1-rubv88K44XC061Ki_kJ5^MQfg~&uTIK|_u<R@A}%8C^yl|M
zA%pv`!oqlTLGoWEm@{iM?ltvm3~vza#*N&6Lcg0t__jRaJX&$a5JCx_&#7VR3D$L-
zE_A<GTrw9+c!C=wSQPFJRJ_%{=+Ex-+f(W=_@UT*9c4?)Y4J?0R=Fkj|KR3{pp|P<
z45reUzp3fk%2@%pD?Dn_g?0G#P@Lmp{@Yy%lOIx3{rxGEvzH?dzrIxI%c~xABuMgF
zMB=WA_Dp?t#~y-Btx&uVWDy_KGlTJN6mOf#HiaOFZr|2Cb+`^D^@gUVaUeP&%;Q?A
zJUC&5?8>u)?yWC{oM&m#EJokRwIY0}OTARE+~Td!CB0&&tM#`asu<U5Hd~3~<2L9k
z9?c_0t$gQ#kSDJkUQSyN!qxD(a(pXm$KmG5_UcFzii@m_H3sD+{oY)h)f|ql^Al}+
z<INXfVyz9l4J99|3Y39hgVTAQu>3tzKX85(5|8cEBR_&UUW+(PTIP>%nBUS%eB4_Y
zA!cigRdy+jpDKgGdDPV9hoiBMLji#@V+rDJd5a7e*xlx<ZL2a0Cw_fMd3?;=f=pVm
zX}hT<J{g7VB})+;m3@{6Vi+5pIQ$3xS6Vle!TQ!al^&CWNp(5)@q-?@wTuX%!9?_(
z*4w@wrTrJHxMh0g`E&n4+hq4+DJ_#p1qG5pGBe8^whh0q`Vs0$Fj>(om0au?BxmX<
zNtZ4z%ni1^lbK0Qyr&{P{HkFjKn+~s@_4So&&zMLZkFtAu_`?=S^(DZ*xVPe`zAkq
zkiowmFUx}hgOS?{Y!X%c`Il?71rou%GRQB#fJ;P6yWLU3YN{Y63+-NG63cQuS&tRG
zd@uwEfpeu8D;~ORej;AsqzN+Tm7ON;$KcXXL=xlB^>MmOtRFmL9f!=4xsYL%k~VIz
z^<#KdTBOKem%001h=9a0z`c)k=9m<<t<SiN6Md_yiY<D#3MA{x9$r#beig1&Q32Lm
zM?#8qmXDu5kV#!qh|_uKC9)2#)5W_6qWIodVamOa>9T(Q2*D@{du>*XuIE&t*y_DT
zS?bTZ^T8~kB8l$cXMf2w$xn|&5A?a<eZhi?@cwB0JzL`*F`sIh^=78maCRtkwlrB=
z#KgG7zd1YmxZ1lnDJf>D?Xn|-)kE~bC~WlQWskQn0WXi6aQs{X%SGCXQfH~1s|g_<
zEx+i3oSu7c1Ng<aZhFwb4WFa6wZhZqBRr>@l2n2tBy9}fngF_6VOIBLJ|Li8c*@jv
zFqk#IMfaXLiXpOVFniAR=H&PsJ9f+lqPd!)`)437Q}bdGD0I36v*_p=YhI1iXiT(Y
zq)!!o@_qFC%HMD;BMY<kg+E4haH|eQ4haP#lr_nde6}(N#TMiohValj3ZJO*DdFj}
z5uVsFY<l#SEwOr6mu7^FejOu}^JVmmWSPV`YxX#FPpgrSl7GBBGMLwGWsQAH0&hAv
z<1*t94&5qz^zmSzMAuSf<%pwW+iL~CpAc-&(!2_LT{#5MnVN)}|BaLT$L$KW+etHy
z0%o&oui;N9zCyEVtSwcmNKWhIYd<!tWuwb+uFaakeEfX={sM8$R=C5|G4Au*y*9{2
zSypL2XSdZ`ZP^ZB@|9AVP=R;9X+;_}#Vxz`iI~&}0J-tJ@-560_0+sPacpu+*6-)r
zvP}EG`}lM?F8>*W41yZcAKL~KGEHYm6CRzBZYs=f2Z2uKXoaSD_2i_CJaO|hYh0;R
z>|t(hlwjqWw;KoU4}YZ$2?f!$yU@6Fa^d2;ycH6CdxImMpu!QEEBClIqF^M7Vl{jF
z=FQCeeZ3x=wivW-+M#ST{30FOv8)|MEUt5YUscBYcwu7yU{#QLQ*OeErJg14<rTr?
z%F^=1AWG@P>^gqxA<)lM9S`76aKoxn^E<npWU(0WW3`GpW@D|5d(0#$-%p&Sx4Q&0
z;p(+(dx!V$PbYsQ!u<t1eUi`HqCNN8#~aE?R}`=N6*^jDL!gDMU9;WXBAHWeHZD9<
zM#+q=K~r1mekwjgN=$soIodWbZ&_|VFz0w3Y1|cXddu{;S*EXHX6ELG6RoP$FX^gE
z)pAl$Ku!bsQmb`OgzZ$OyS?hVEmomEBATe579y4~j~0)%(uf|1JkliIP29LHCXyvJ
zCB;w2x=5_$Wg<KmltRH0<QpX++cW;}=m3#)p4zWLhu~<*(HL9XDwG?<IDIDwkv|+6
zM0Tmvwm;uCND5zUZP6ZbfO=L%;acgIli%s4E}W%TR7PoZ_3q4q>~o`c><F(UZDucC
z3}>M3_}L@UBrp2(mWzALXt=r2yen8+#8tAG#O1aP)=SQ%QU6Iz!-c5_G@gZ$xJS^%
z2+yNp&sdG?V^~r((*x!NWA?V+5fWQulRq`y?7{H?ENAKbJCT81$!>?S8M<tYj404J
zvIzgf=tf)&d^1B%ULS$o4da9dLie`+=c!Jw_!JCF5*+)B@1#NV+a!_r=j+W&35FuO
z)ckjfT)FTJ`d82=VNRGyEr(X*iqF3-w!&;`Ik3-<e_Q5+j?{_6N?_axGDPU3IBK97
zmA=<F;RvIdNBv+B4#$C}+lAzo4Y==UMXjhB+F>v3(Enb4jR!-nc|cfY<AY)t^*1i~
zbUv6xdoY<%|4ri&)IcXD^^9eV?%#<GMO4)e+}keAl(?Qk(To+;-UvNht7rnVVEw}p
z+G)lO^P*l2#BZn{X-*OBPLalA{{~xafGzZAGEU%Q{CB4ET6<=mT1Bn@`I)DklLD6_
zJToqD{LFvxEK>p(A~yXSOk-r_jKMRO-|_#pJdFG~bM_g_q3|nz=~DZ6ayoUNo!%n)
zZ!rG_vrG#pMr_LapDq5{)9UIGo1!%Soyj|LTK#gwrrYZOwmj{eR=)&C#c%xb(FQt4
z-lMfN>AV{k{!_T7_vcO##qNJsH54&Eqx_5|VVZX1F$vc?IPU#U*NE8|^4)5Y!CqQ8
ziumuYbJV0c?%=JZkqO#3*Oa7jsm$qn+dByVbJ%HO?-^PV#YY=k64oL&;XUBmouN`g
z{WO-=K5;z#o$iX{|LhY%i&umJ{rUGOh^N{5&cNyW_ij9jJd^XqTlN@xeE)Z0mNjWk
zo=nCbK}s99qbn$qu$iZph9h`mh@a_m2DiZtk`~yQ89*By+6IqHTK?Y_j+~)wAQK?H
z8*TAeysD$aCSol6Y6a$>;%KYf_~vEad)vocp_KF2x>q3wX`T_mN~GrsvwHxS#et2d
z%vTpIcE#V%;|0Gv9s(OpcNo{~f~Rb!Cyj3O=X3<YQGvRSO|=osH1MM&>OJT>4;UR_
zb8l;4x4Sz&4Jm(zyD|BR1UW+E0b~H(q&ZZ>`2(Y(qW-!MRxrG3ao5Xi4AXRr)?LNb
zR<}6?dITG2W}@;L^4u)er()Hs3+=6qHgALMwEC;(mLsn(<&LrZ#m!!bX=-b;?BCDz
zU{(rkVr1M+9{$F&B!<aYOo8`Yd2lEt96kdxV*wt`mE(P`=DNzt^D}GxP%2D_Oi9u6
zRgnFoh%(&1HI#bWHmoguNMjGlv7YYAr2>nrMG*CX?IhUDo}lc748*8PWl92BoJTWm
z-?ojKaI|;iDwGHSsP?7JBtm5L=W-=IrKpWz7jpSAkA9ihKA{hsv^K*{=ToeTCMXC-
z__l+q`MWhdACJZRi?WAdeD>Oy%^qhzE%hluk>EKqNn&Thk%Hl{2M9B=5U$<BNT}`k
zLIscjcatC%?pB!nqshAh9Y6u`dc@G>S#1-mg#sTR6gl=hs`;EQU+ySCS`-iWk8qe%
zv*~(}e15GeFdbvf|B(WSkW1<UEagvwk!LhKPHzEcq1e3GX+Ecc#}*T<()4n8pzzV*
zH`hQhzKoC`0t9Tu)$vOUwubdFy!p<(5`9ibP=J}vIrrzt?os-y2zWvOlL(3d4XOgX
zA61RkI%oehIS9#Fy%R#eo^t8+O*pn|qBFms%Ndi2IK8D&@xvyMqYL<U!N=3ts>;ee
z6z?56&SErOH32NUD@ANaM*=jU7LLH6!C?2tr!h{Iuce6Y03BM*b)nF^CHL<43SXP1
z%IgO3->W2dRXM=kssOmElfqX;TLl3g>x;fc_%DKhpyn*%$kE-8>c7m@%RH*8m%+0M
zxvk3C)QM3z+R5{UF&-#}P6Gd$v-amma8-G*Y}ArA>!KX#M^fZ44@$DwItmt(+l|_A
zl2>fj7TR+!I_`v7f4kxGDg)RpQ69LLA@T%5okHa5XjyH*Zu#Xya5GKsn={SoE8y7>
z4)*HRs|uI`AuW~(DJdsm7CykbS(U9hqIgm0L30!O@5@W?xVZ;{WH8~jQ|Fj9e1H8q
z961f~3B|Uz;n7UVa5nR}owW7wL4>QU$UYkSLG|`Q+Fu@3I+T^6IKd>+7h$3S>{7z1
z<kSq(Rjd$9-^%aj{PT#VXgzb}jLZ1IGuQ`qBjnM<iO|9FlE>%jitttE!atX$OVC(O
zeoT)475O3);F72p)_)K@mlN<E1+B$%rA=urC_K2V^0Z3N#ZtSzV>zj6G~o5CS3`CW
zoQC?fBO4%=N_~2^JQKWhPW?CpsP(xJ#N-jzhEpj_@uVB|w;)KC(q*0bVzTOhgQAB=
zUQ5YB_+6c6EFP8*c8b-;NQr2s-)0%rmpqp7#lUPz!u3}3yG@P0)7dowHnmMmh+xM&
zr+@39qk5U3dK{30j5hsoH#0MPR24*m*JuUvXMXU3r~iN;H@j^gYc1r-CQ}HE!`in@
zwsgxHL;1jR{{5`WVyB616{owaLr%T!>O|`FZIu7k9cgT=&!ZEeV-r7B6~Mw*OEYu~
zp6=e#M<e5?B4<e6wQI2IL0OPdX2}5@X|<iou4twyEOzVz%++G4*U>s>GCb_{u-!#a
zcC|6=BLH&Qm1f=m<KVrE>~tBalAh3G+mM$sch**H#;Pe~)lnI}&d?${a>3!VQN%sa
z-xRXy0TcFB6PbvkcQE7UgdQPYgb*;_24k#ACbD8notk?4J+QX{xppWad+y-u7%GK;
zJ8!%Muw|~~SO+sOaqSGWy8vC+)KB_&1r<PLf*9zh-`YgnqpYbM)7{&6W~`OwYfxT`
zx=dv-#_2)NV<Lym<g{Z|cDr8iiE#3v)ul-`Agb+ox?`I0>5ko(3NL#I82z5vFJw^0
z=p63W!MOVNnsYVp<(Q5sb6A7tK|(O?_7~xL;_4SEA|Dhl{=~Ud9rk7irU$@u0pl%r
zv(VM+mRBe;Vqy?5O&6WoPQ%e6??Uez>(F&#T$m<7b&sj(j_-7e=HTdGJQIw0e2HDu
z>hhhr!AXNo^UUfAG4nyhmmJTg0ZBy6aKORB_CDX<GJq%X%Z_EXS3_%Vh#u2V_Ju^s
z&$eDlV)FJ%Scj=O^PNBGJn{VT4Q>Se?h+mv>Gw~o1AQ5Z(`>w$kz1;Zn-pcT$!FM@
zjA^?3hIwf&eD728uAq<`DE{UY+<vHOl8-TPO7JkSiwUDs$Dk!n1@THDNh+>x2m6DP
zarA}E-=9T<(+`Yxeu@|1ltTfQ4cGQ*$ge2ZcZ}<kuBo5q*8h_zcG%ms_n>CRou(AW
z%{25QvSJb#scG!;6muzieji2!C=rUu@066-_QIH=)ahxC8sQU_4B#6guqB}e<#_-j
z2zR$6<Mt=J6I7*CPu_7`xG7b0J;r84Tj<fyqIdK5-K^{Yx<`xUK{|I;@9In2sTe5@
z<9gqY;``^6c%Qk}7|&02ikO_j+583h9z^GgpR&$+cO(8ry$yhnSG6OFxO`OiDZ*oi
zS}CK%nVy-Y9g3q11Ax;iiEsv~aJtF%ef;RFV_hZ^7e%xnjqM1(?YEhxD}sUEQaNIi
zsUV6Z6x;2g7&8(OYma5g0<^w%G37PioY$rx$pIhDUgA)w20%RI)k)+=-T<Oidkab<
zgxFnW9Jnukx{+57ysoikL0ZvpubpaWAMYnro0!NqK;Tg7ie+&&hwxm=@b&B0QicGa
z6~$y_k|sOrQruCg5Y<mo6mSbP3E$8|{i45i=`yjBQqk{?5#{EFy80thwL3;ae);#)
zw>4Wl)ZdMjktfT@eB<2GPok|>)RZmsv<e{mNGNd|Q{wVNI0s5s#9#)8v+S<+Oj-=a
zpfb6rDRX{b=?ZVZy!->#d3?JBA`<KsF%3Q=<g#dZRaZBbB{elYuxMu0t(d%OZi91M
zs-lqQyJ8Ta!W2*J`4~A3!BW9w2F`>d$Hd6Ub;?jh%o(r8MSfU3x7eL!+Vm#PMPYF)
z$%e9JsXC)*h83y{=A@x&N~|s3np7<z(k&>U9bzBo<5SJ)CJLZ$?s6M{%Ya1L7ydcd
zcSc56wREDTtcHKRZc28<Bb*3uQNXU>udV_TN)EFxL4_7({X2Vu<yYH}^L2}@F5$W4
z9?$#ihAT%VYb4zrlHq}+vNDkja??$zg?I`@cTaEOiqs*RJS(s{en)mIhypjkpLaxd
zKM)NG`N<<yO-#XlK%0Y`o1iF0A})oO+1;jQ=keNn@7gmPp0RA-&3USp=5usaEUQ4#
zz{G`2{dhZVm^3mcC;H?NPSfX>V_aXWy_eg-_W17<KKE9hCCaa|xY+z7sK|x@DqCqK
zgqj$IuN^W!rJwBWwF+)WxElpzcOH+o#tdeZEb^jYs@5V{`nN~%0&)zHW3vGG{VO0I
zVz%fs3gBoV`D7G2yqVE_uq|PQM@{miz;bY%?&}mi-2-KXYROzQrhJ>})3503bKxRq
z*L-}A3ugM1Gswt}hj^%4)m%}sf9&QuJ;|)>=H>>TiH2tS0~Bz2+#1}R!>vp$P~g&{
z*3xBhwiHa3RY8BaO;x0c<y;3uTLr5V=BNT>UR?a<&Ce_6pNiDW@}U&j0LmK9TXqKG
zssZ^)I=3J(x{P+8Z~h1oL)TF6rpDaMQ4eph+l+l<WF-7n${FZ&#Hke?r5W2NKOgK)
z8sxgj+{DN(-roX$h80{Jur}odsND|oJ}4R3e5d6F@Ln!NfN6{h>ywFi|H8sTDp}<F
zF7lD_kOVcif#pz$QdJa4n1CK@9Ku_U??gD~bq$66d|GKfsLl>R-+3rV()HOk9E1|H
zB-CV3rjGxzQF*RfT@nn2%8xja43SJ6X7%H(&kyg(Lha@1&71pC&E3Z*DVXdOz$Rmr
zddBZ2pH>x=!5C2*VKP!5h-|ve4vu|E=Q&>Ne`4xX56dNO4&^TRh33hYtob&re-6j6
zI;e*2(hn`ln2;ei;Oxi=L3WWTvV|sn76P$~2PPz);_KI$^d%RDidAoIQ7kWWSCF6F
zeKEZG@J><D>rettRSmCfuP-{p%^f7SSa6)5U#(C%!T%!|yCQrXCnMuOI3pyXZk=1o
z(R8!@4qFa+_129UspA=xpTKh3qPS_VsVR%9x`j7@_yrRb1a*{q(Sxtq+XS=kpu|i9
z)VZhp%ulU@NwjS4t$=}CU6>H2=<T4fR7|)BBI-n6C;M^pt9S0O?_hs;7rcXR2f(hV
z=5rO&B`)%O_y!1OIlqZ$A}@G{WPp5#H*aI(S)c&fln3SmPTG-W2)HRH&}!}O^%mOu
z2fIyufU}dmqTiMxkm1l7;P7PC)XN~&iXH1_dj9#bDPF|N_Vf2QY)k+e)RsMKs|yI1
zWQ?W+Q5jGnA_f(uh|d-4rKq&4*QQ+#Sidq#`Br*dR}P*JfN~RsBm?jBKp$yoky-xv
ziRO0TYkl?b1W@HgQ=`yG+q+C)?SvoGU59*VK1V5*I~)|ZxHUi4bOZte;X?b#18~=X
z0?a!?lG`9@CA4j2%`0zA1m4$X#UL*M`keTP(7%LInnttD^xcUX@$xXV7lvRg{e9|c
z)S)h_vB3>8-S6pj;3TYItKMSqgg<tZSpHu%d=P{ON@()@8;W1#$^lkMxar4eL_fMy
zFtCa)wWV&rK{V;yaED>u!&w^N?si`;hvM5qLI|Xr)C=~|WHdERgn29ld3023K7NFO
zzDCbQZiBs+aC0l-h-!tGh5@mg`e_6nB>!8bEmwY!IMxv*MU%sDlHNjRBgOt%$9?O&
z#XgUOcb`)~|F?70|4;FN;KJ5F|3`-K-_8FIk9s`LZj&7cIC6Mk4%5&p;Y3;6{l=sr
z)*xK>aU~>*>~cU2=9GJURF~)Ph_@*wcsk_XEBA65eyug|E?h6bPP(LSu%?F3VEK<*
zl71Qa`-a4hF7UXf4O-r-2|3QRWH}KA4#ei0wf#bs7G>qX`2|~V;juE|U!dY{urk|z
zg!_#(4ufpMU-~dGf?Kz;n%bgR0~ixRP;`xweGdgJZiCe7Q+mac&EpF;6^ttPgEW54
z4rf+Rb>@JP{!_l2d4s)eY63j8k7DN7il@8DQYNl{et*kqkS~Ap`Ln3W3178n@yclH
zQkI%9{<`t8PcXUy3Yj?Yj7j~n9j)JRO*pTE_1_1WaePIOY{v>!dLXQLb77oNl^JNa
zWyOilta=O2K|#=<r{F2@vowB=S6$K4Vs4OIvUt;wXV#XY3@wS&Ph;Co(MBFrbJ#66
zAD)&4HUv0Km!`g$80BPM2h)a1jOrim5e6!+UcVmtBgYbI$Em7@e{X){;wh;!(YHR`
z#XwGzmPHuk9ootim2|lEA!TjJ=*iaM;r#@#iRUu)N}}u$@N}!x)fuoR9&T~RTgL?i
zg5Z2^tMk6Pj=f?hPs;D@Efk9#cV1{qfhP~u$m}XMP^QhdE=$MW1jjJho;(=qXl4L)
zw=BEyX5{Aw2I88MHR2CSJ`4tL&}$6uoMzhdz_lKV7WrT9tEj1|jksA(e!-?`Ga<-(
zVX|FC`M%tBT<O{yDABLNzlTcDAMvF+Eom;f!!8@JE`#Uxu8NRjs@ZueAk#lUJHZdg
zIe=(MV7zqbIW0aG7D^j8U{3MgVa#$K_v5ej2V*?dk)@{otRYTL2EW|=PStR{8T#GI
zcPq%^bF8{PpFpWCHj5sTY3QP}?kh$Y0F`ELYnuDto@~>$-_0uOl!{Nv$Ph?ggri)e
znaEIrsVH`y6Yl1Xlav~b(9%!;^)Z<sA|`7MHKt(9{O{s#FjeJ$q+}Hra|g+<j+tiE
z;cORIfVI8;e81d!^h8q!-aJzuLPwmDDQ;`$huhxV+-&U4f-Zcw>_hjypNp=nJY;4;
zy`B;L+xPEzW(p^lU{bB5-Od%BDWjBr$jGSglrU{fNSpS`*s10`nJ!^l#p?L_he>C)
zQDg&nJgLKh5`DKgb4(hn7Kv)fErj1s-Gg9~4^5?hSiVp{XWj8Bu@k=pGWIoHobs+X
z<9N^kK_5FhV8)oC>E6XDX4WbmE@5hph$nD-J*(=wYeI0=4*PapxbML6Pt%VNGKq8M
zF~3Ism`vu}vYqZn<W~jKpK@T%AG}+0_xtZ}PYu6%Y>J#Nb<2_2)7siv(d($u@X-bq
z0x~1u;ZRJxpHK7t^Am_L;kjcb*f3a5z?|04bIa0?iI`7N)k+t*nq^Sw7nAi)HN1*Z
zg}rk~icQ?&$75bdxa+(0b#*y%jO%`}^1<UHuMy8VJD-~>o~vIsSx&3t$vK+^+}9?L
zpfJvOEe=YNIsvR=Cnvw?IS;=E2ihTCHVNx|*lz0s_804Sfks;1bNg+}wv?OD;{{w)
zM<@Cf>BFuAO!2j}nyA7Liz6gwUqw!Xe5go&+3?=&I-D|hzj~w#SpS*IX&4INu&w2N
z6sFhVwzMe=Us^uc?`>lAoEA+`R9UZeh?jTEu6F^XEMJ;XW|R(?kS$7Wc)~Y5=wUH{
zAVRwvy}AkO00h~~F_J>bF6Uv*qHuul<4ExRumr@BIOl($icAdtC7ow;We_Z_g=Rv3
zodmA-zsqoaDV@51Mf^O1%1<3i$2!qI(RCQlbz?Sr9<KLT$lS$Tmm7r)gH;@_#IQZ@
z4(GjtsWy6h1z2IIlo(H*&(daEfiM)HqwI;^Y{RokR}RHP+*^C!9cDY@k@NQ#L15+m
z&pB3o+Zu*F(c+fBw8N;2&THr6`7y?%^G4pxv;3im>GJVL%Fj`&OM^j&faI0u%pju<
zwxHH&IrC!pnH~8?rXTfjx*HVq3qB0=pTBqw?{IkAl%!I<gUfXfV{|ywS#kY3a;0G0
zAp*(fnU%2UXq<Q_e1QLUM6Mj5K~S+~Mezw@Ql&M1eRFPC&RJ&2c(u>?zAxl2Ucg32
zHay)<|LZn`;mYi=nnT#FJPYj+TbM5OE)l2iogG;#T^WhinZClvDAmx@8p3?!e1H$+
zfF^mVDSAK0hd#Zl>i4^Gvh995twRi~r7Gxb4BX~_pjyW|-M_CyfjzX!{nU8&*jK&B
z!)>*r<nCpe^)O_t7+lnAdN%Q)fQ6|}TkrNP;>;G|_<XU>zJvnFqWUGAds&;OS5=KQ
z-NDld+M^2)&_Ti%L(7jm7+>S3$&4Z+jxun-#Y`&zIYc&q9oOy;d4F~rS_c!^LJ#4J
z*C1H!&R8lMo>R6U`%VHq<~*L4sHYlss?%(JUUc<kZ`me;jRJ%yS%G-&lr!O-6ESwG
zp0!tgKJjf$(o>z{`*Xq)F7%dtI0@=PP#itlsF>Q?-aZ<zfB$|lBB`3w<@32EHVDXL
zE)vc*JFNtU*`)$gT?4xqrh5<qU?@ZwW#De)Kj+`F71&Kp={oso>ibrtWuOa7+Pvt?
z;efEN0vp5nTaZr~fbWXT*ahY#3%Eu+MYl!utlrohda~Ho=-a=tBB*R1XQZ5v4$Wp4
zARg#(TiOU1_o7h^?P4wl%1fQz_PaH-%OjG1zBbiKXTTH&2Up^>)Jyek*is<)<%C6<
z^66x(^!>47)%a>%w`zHL57_qOOr}5DEfe35K(|2rrFX);JP5CH?sJXh&`i7a^5$G#
zX%X`O@N>-ni>uQnwv5}Ue=;=pV(8^FXYn<v2^*mog`uO%NuT-fEss{{Q<5COkGB@P
zCZRX*yNNt>;jG`!Cn#812}|s_+UI2GEK8_hlInlLk!Z8y39PFK2&NqLt=CrVGz;$j
z{wfCyB<INKs@?;6bO-2QymMdNDdfloxS19#Cp)189+hSS(Gy|7Ul6j)wGuU)&VvUJ
zG?#oU{h6yHgbWdJN4pw`V%+8~V~r(UpBcyx03xik#<+y<*&@>e^d~kgy|qw8Vd&_~
zT53EDNe^|LN1;_glTFs?A@;44v@Qoc$U1pP^C)5q8To<^!{A)i(dQ$#%P`&cc@?le
zU*z^WUG%H+^oDnwBFaxOH{Ll=My9o`&FHy8o~*ShiqHO(=iF{}PCN$b&ddGeTVEcX
zn<{l#Y-ZlYEbz-!KtRB15ib;Ff(9s<+<Rbdq%L^(Ub<sVxof{uC_zz<I6!SE%S)LX
zS;vdhV4~9@9Mtyoa_n<X?i>}@6Hm+nm)vC>{uEYQ1!NR2MdB{KgLp642ZB^(hy-lI
zc%7!QRCJ1mDzWq9p}(N(mhlLX3*Csuf<=umTOkPe@l0GZZF%%9<-J;T_IGw2^+gGJ
z>zaB7>yiayteiu)Wqu5@i32l5&|SToQ&tkLhy|fQD1}K*`o6Y=YoDU2fS4yIk6GZ(
ztNo@hGnBA%f$U!>4rN;8i$0!bvmVz)6%0(oSG=hdgwBa=6dNnLF2lQg=%tSEv9p7y
zv@1*%-f?wGJNqb{AX4O8uO8Lb=|ULDMeMkWV$11bgKlsIHQIfNxxhaOiR{n^?qvX*
z;}vkuI0J2u8z)~g^+7mxccd7w@B5qS`7}wkEZ(!Te#N*><i2uaFTFD$Ez@fE9-e)0
zQNkPUQ^luy<pvO8f(M0w7kL^mCeVVCV{DHlD0!JGm6ZTt>bTXHh5Rh1pQ>l+j%GkN
zBYFOJ0BY8*0^}O<zvtIAf-W)zT`Cl%UQhxJ1h!^@;b+m$!IH^axsSOX#;+5WThbs;
z6y>XJ)T`mOSmErt4P?*k4BYAQvd0SwyrdoUtgmeQ!V*Iv);1}P=9jraXK9eWTBUmm
z5Sfy?)8&f?rR_2=CnWZlQgh#_VIE{UnL6%HqA`+}!t*OqYr-laD(hauEWmOuabLdP
z9IUp<W#yfgL3tIl#MIhG9#YEGb?{XcAUmvsH|r&R)clkV;X?jF&_b_`mJk$KoNv*n
zh6n5Tqr!IZ?)R^rE*5h!FxNgiCmhBdrNCLb<~e{4r~-bQ=M({}V_h{<wA-g$-(Al3
zGV(OeI$r8w0=ld!>^Ap#_B7qC`K0{RH8B9QwpyLnO2Tb5QU%Bn^%uAb3YN?ppe)Gb
zi?7=v3)UE)lS9Nh3SNB6qyz#2q$zjnORI!&#q(UB+)3?~xFBkQ;2QOAdu+}&#BNP!
z=?0gn-Hp~PDyOU#;*00h{Tm+i2yw?()!g{}y6WB&Ej{OVougK!BX8&AiBq8~BpCDX
z<>m0Ou#uP+WWBr4R8P<EtF@5WdW^NZKxip>C7P+xwD|Hl+rWcD+;dW~>MC#wAh0%k
zIuF-91vIX1`{|6a7f*Nl={oZJBXCq^zLc_Dtq_8-la7$kObbvkQFv*$&P!4BY)bSL
z2TvayBS7!ZEEr_>*bQ<gMrYode4tSCK%>UbG~d;c$8&WO`GrHuy1KfWvGmwX4GHrT
z&(oiustV#@Lt(SA3z;-(2#Q)kR=s&~94Ro-WbnmDfU<;)C-9d<wN>E}yeGr-GupNv
zwugE?g@DnhZxk5V19cJ<7Sj&lqgn6b<XlG5?agr}5Teuz@2?ZP`}J$uG(1Co^NTOt
zpeh!P4{?_!ENfKzR=Z1cbCVaBzSs=%mjw-5rv-q=$enak=rIppp3bzsyh=FnP_UGA
zsfR!;GF)VG_iuy1p-rJwAkKMlWf{9N3OqvUBfD~_maf?tE%cVeyKO12Z6IT-WV1eH
zjTJ-bV1t5!;7qB@WA%tc2!QZgi4a-m<c0I=bPX+-!vg|HvZlzo(r<rVip|fEV`}O<
z;RzbIU57L?SV7(;mFWix&stxpCmVuS$#QjW!JF4GY=h`7?38v)C#R_CmC#YkmEKeO
zrLuf>FRUZ|d`P_q^A2djs#ha{Kx1tYRR6`gUGtHlyH`&B@|K#8g>CP2!Mo)-)6Wve
z&KM4OO=8&Hi$@)8>h|M;*Hq|&V;#PRoNjzo;?3aeFIapCLrm4Lh}fb6pn6)F`~h6)
zSlJuY2|fFF+CrO|<$G{jC}*!w+P!wnd~YG-Ul1Pbhpa{j*vcK2`Mun)PX;181<Q>)
zHX~>WM>&KD+&nVEf9acZWIGJxl-WF;kVGMjqSj8T<MV^-Y5HaIz@y;MkXu-)UGUnC
zlYn1-EoBXfAqvxzOd8@K<ON^g=z{DNv%ag)cDjRm7#X1hw_)Pe!{44sITPAoVO!fu
zxBx&6)GK*xl%Wf`Fo@LpZrgPLP0o>JFqa(=HRP|x0qh}+Pm%ie%xCJ|aaQlWd3gcl
z>(<rXi)W<4U7lNf$3;I#Rl#^cLeGSP{*eMePb#g7rVl{+Rv(jp_uG@P?tFce)96fR
zpSBy*i=4Dr(SsoPcF*`z(jr@_^__*Ms(@<%iFY7O$DPeTym%j%sBI^csVZa^0%h|9
z1q+KZ1K4hSfb*Qb4<2J}cE@?eePik&Pug_@R<7%6OLbLkq=@ZzT3FE9OoMeLeE^3d
zP*Y9)39PI>LNoM1JwHBD7tIU~8u^8^iv%xobx2WAc_?NT%~54#cFb}=;*c{!4HV-v
z@v+S0JF1Q%9=C8#CcJjjW*IUfwGq&z5zg6n4$NIju8k#N8zk}Yn_$o{^!=$0OMG4h
zS;WhwJ~*;(Vhx4$lwC%xMt#@I=SE%1AO;pPuI)e!eyo#pY&{V(C#O_8$-q@=-ME-X
zCvnPUI(K>ab2s&_fSyLEK%l_LuH?AA_V)N{Jib(Lq|W^?=knlFo2lfWi-jOv3!g)0
z!eSEY>>-Ol$-Cr8ga%MEyJjX)!l*9UUx7H$>FNd6rMT+3K0f`3#KWhrfICh)A84k@
zU(G(}d!VfpuG?nzXYx?`$B(C>Bf@VGG(WX<ccPSWiNx7`>+B(1$UewRbmWo&XC`C;
z6Ffh|^`4iPI_d|g!;}R=px~Yp7nvt!8Z2ipu~f>`;!aFmZWGK54(7m^zFHg)wbQmc
ztS>b;4}seVgIEj3t>_&u^#T(7TM|7TS|Bu#oGBPg0#pR%du+?OL<A*4_Jh)DA9=S`
ziyYN&VXV?h#mfW!&iIxa$=+*AT>GIt!949&7IzMv61*vRDqGb-%L`mnWmYvO^R5H6
z4YxCZkw1LuVpGBU*L+$PkhpV$HcEc#cQmIV#LVl`J&eoU0S;IU`)O+xmX5tZMSb)c
zz)6<TqX6y*qI-Djv+2E4I(er?*WO?IxICt^I|#FujXPIPOb0F}r1;2(^euIFfSVQO
zIL$5Yt#f;p=!u<d&$M<0x-nEh{tw9)R2HSb>=Il)?>f#mdLB_V;yGgyRo8vE-93n;
ziU42%JSq?tmQfY>Gic6nS(>SvxX{RsAbzxY=KA&PEoqbZQlbaS+7Z2=+m$+Dp#u8@
z0=RPVqQj!Ctq<4u<4gGCTxyI2qEh==^57B5830+J5;AeWjdTGlPS1#osS`P@#}RT(
z?QTeVZ!ct+#`2fbLnv%B_*uuW@5ysOHGXO8u{=UlA5=U?CGNO5V%p#KRy6dZZ(y~g
zmtA<WWU3x<_@{}rH4NB1e-v4>+IWhqvCQjB_I{37ZG=jc67c#EC8N?i#-Ut|u#_C{
zn~%K-f)}wrd_X)$N~122`2eUxt>>kO&TOVvJmXBLWJVZQ4jA^ax2kVwWu`x0=jj1*
zRZTQzf3Tboue=lG>08yLr)&}qcBDsL=>*8#AtzM1di84av2}os7SuQYI}b)fcA*s~
z(has6qEpJ-nm3W9kFd;xd?s!}<HBQGw@(Y5o?CgX6<*b+#4oe{fOJ8Q;6(wtbN+&*
z5&MmyF@3&KNhh~>M<byma}bd-ARg9+p>iXD4D#6^m?Y3hh@1gDsf*!%YXV0>r{zKg
zRN+Ngj8R=AfJH<c<QS;Odu#;>t8I{+RzkRM&>;7Zh)Qz-K<F1fo3?DPf<}{i3rBpP
z9N6Pffxmdz@jd9o2+e@ov(XDnlb~piBofv?9##J@NAdr^qU!U1sbb=F00KVM!mS=W
zZLO_G*A-QO&P5C5D+D+|Wy<3EgOjiScLk(*fC`{2_EkKv%e`!)2YJ031ug&;%tC?4
z5c=;Jo~^96f80NO<wuyHK2$fkI3#%f*BaGrQ-~v|H7;ltfCvY;_Zv%%2G!A~uK>jX
zeoP9G&Nr~)xVfn!1%E{ksCyu|69)35sqxInha<aH|E^RTQ!zOF4>(^QRK;7Fi-!*5
zLHPyW4MfC4lgYG$0irorBB2mhvzTMkd;wB8uD0NNk2v-EFaAI+`0?AVj%tAJ%Q4jh
zyt@A>R^iCvyimYhYZbbB<HoE1-JbK~8W>q_@ywh0P;7v|Ae;t>BminO(^mgaB@*4_
zOAF&nDjd$YKzEBcB?2{2I~x>n+L=hM%_S>?N#8IPiqU&us3y?c=F`#h?jF2a9_@Tj
zuyok~iWV^7zoIQP9_r_yt_zX?%%~L)dQB(wxllm{(XzIIs97ao9&+5=rOtg)h3g%F
zG>sp3idrN$#L7y6>J_@h2;xVT;95xK2NJ!>dl?x~&pjv@#M)h4U%rj+p+I^aY}p;x
z{%xpu;5!;0A8vP1ky#kZQjza?O5MImglwo|bj2tt@gd5cE5!u|H_>@+q!Iu%(4iRH
z9OsVFLx>${GnM{%a$y17^u{@$f%EowLRQk?d_z2p0W7ph;`RhxISQ#bLc-csCBi!1
zU60D-`)g1Yi-6{}CE0Ceh^kxxodsPDVfVaR6x=TbP&yblfEt?V^9hN8cNX=TfekkO
z-X@}-DqgX1+KjENT^FuieR*X|qrk>1Ove0R;|th={kJ6rwnV@d&3{{d!4^;0a{K#w
z_dkuD{bu@U<qw-W^ftB}YHZAS#_ACU>?`WWqYjRVgk$b(?D0oqGrf$*l`Wt6H@3V`
zOSrcKIE=0%9UAAKUD@(S<KJIY;V&mop7hI%b<;$BkKAWJY}&K&)9-hR9{mkhcB++T
z=if*DRTH+sfC|O$ZC@WihqR~HR$4K|_M^4y8)&+D8eg1F+&*@D<GK=@x3c~RBeJ94
zIB%otX8LV#Drt$0pD|_e^xDkbN)sD;dfh?Me1>Q4iFzH*t-p4Th9)mqQE3xuZaDLA
zOFZlYTY}U!w%k@pNc4c=RR0@JI&b5Z-_KYR4F9Sy0kaco)|+<1K8H4jYzap_-DBqQ
z9T@NHA4}DQ#4T|4@Be<sQUmruTV^LxZ~nUwhOMm9hZ46Rr$b90U~3g1sjvUS=Uh-S
z`MUTZLUL`vdd6o57s-|#>JxAD%P=5<qFV*?ci`I&3OgfEt~oLD<#^Bx0mk8m?K*T=
zTGZ~Yw3wnW@YmM@f!uQN3$8Q^D3Kr~Lp{TbJshmklCi9JtM?jvjHE*U{{ey9`x<0L
zBpiUl1?n`wa%Fe@1MuSdqq3vfOdku6Vd@~9(G_U<`%rHlzSNt`S#%>6WcUgq(a(l?
z6WpNlVD9G4lIHt=?`*;sxKhT%?WSCCv@r9XhZr#K)K9F(F<xnw8V$v67)MyDUcP|I
z6rwu=P59rb55dKpg^THiwu3Mo=+Ljf^*}rF@2zSyfWKaYzfM9ANfY8suR?+>pu_rf
z2Ypbf8}a<rB`n3H6zF$=?PdeWyaXCzp1?7>?TY&Ft(yo)bpn(+fphQX*v$`w_^u%-
zbTiPu{8TUHt+4BC7m2cUz5cgNEVT~^`S7v33AY5+pamCny!fpKvJI9JX9CSL*Dm(0
zL9Spkl~rAd`s|C`s{*_SW^3LX2lir!_&2~FLQPL`t3;e3h(=^D0<*TVO-nzt#pWJr
zumbG`XS|5ps;+js^YTlTIqV~%wUs}#CGf-#w>HEd2<74E9U_|EDF^<tAvDt)0F`|(
zB{ie=)bpm(eYc>60TNl>nUbZr7$XtZzF|VOyK(fHmxy>2oKbo*E>cDUPo`z!t!ghL
z)Az4G-j406>UNL9;yuC`jT4fP3POzAqE-~0h_W(jXhiA`s14LVL(ZK{TCRVNtEWYO
z%G6=jm!GUf-2&pyNXTL|o>Esp%KnH7J8{Es%~dO-?jmsGax!&+IIJ0wc)}5yz0_s<
zml2=eIoQ%EoHu?}P_3^Fo=}0ysxG2Mf>y&GMkJ6SIhiK%CS~HaxU)C)mN#nCirQ^D
zOW!E_oz89_>YIhVd(CL>sv-{kd-amf+SLNOd7=Ve?*9@GE}BT;OM;)(RH)WAiOp*J
zNvT2?UoSlwVBAYY;u6?yt6sB+MA!#ub);`s%DYiwr5gi$PG=>0Xia$NpD_pYx_#@-
zFCOW8OvkvNvEH48rl$*#t2s&;qGk)U1~@T8O$Ed_qQQKGkT%f-ICwC+?&3vgUU1-{
zc?f(s)Liy@sQ|UfA~w1O)HiWH-PROc(jPxQ+aS5Y+MEF-+_BR3JG`vmFt5cG=oFXe
zv$G`;G<H`((}e(4_@Xbr&%r#WukCZR^)J`B(>4aEW8s?Hwa6?Oh9v$P3u2rpkjK9v
zcK>ke6}X-r7rdOdA&f_=#t}r`h%J-CIMq@|TOE=3b#qh5?dc@|hIy6=+Pk#j;bV`w
zDJui}=Z^hwuy8j35*c4c%52ZluRPha0xg->s6z@bwS)9c)ntesYCQ<@o{WR`Lm{We
z-!X&8h#)l<l9^LbmFjK8VnltPu&V!dDWcW@n?W@R73g=yW}&ACZ7-c~Mk9rXLn7e2
zyy}eeLDCSYJ0oV$9r`8EA?RqN^ML4#zkdCSAzHKS`MG4(fchVxcc69=Sa5sMO~VS+
z(MM6|3^a{3Hdcbg2CpL>1(d!Ypx-l>d=63e2feu*oUjgq8JpFl*8KJTpgFkK0rG#;
zJ`*zt-2j~q3f0h;_|gR@7{dwo!K4_7kFFykyrPr3qMGo4pf%A7J16S2{L<T2S~-AI
zga<Vf#u#d>kseUARE^%Zl>d6oCrspmYBn_Fg04$(LvsgeQkupDug~d7d+W7hW2US;
zFeN~*3Ym2TON>G1e6!Iv2HsjlmHGN^>(PJ($QP~ipX^?miOto8=ZeHxVtcG%o`gx<
zxT2Y7Uf%)bfui1qmx2Kge;oD}cP2sU{bfreFu(dbM%<9tkaIbwS}aa-Yx7;`Gc<&6
zbg>51C$SFjv_m<LBGxV<S1$<6K3}(T38_q`V{e|Zj!nR%|1i646KcDRb|bIaJx=xX
z0t?z86DK&-SWt9E^_1H}TTGU`^Gws-(U4f%s;HL3sO?qsiy&@gKiA3y|M+9E>Z1X0
zy2_8q7>6R<I)mo!PhWw$StdL1i+1-{p3v|U^rl^Oddu*C`qgHlVTMP`sSE~fXUu9#
zIA;^*RyV%qrQpsiF|hAegq+qkY~F+}@LqFnj#4MHq6zTJnUk+?(G5Jkg`*eRo@;5h
zpyy(}<GE{}+fs=!hnDH=^X-?S3AHd?eOq<lDemBOy34&pHHDy+lCUXpdm$anmZyj@
z-oauLvmfT1#gdCe@{zN)f$&?%jF>}5mxN3NW0q7;6RS7-BhzR*6#)IL`v|B}W6hsR
zBJ>cb4PjCSp9mdhEMuo;`Du|X(aZ}MtxTPE<Mv<7cW&j+r1J#p7g{{12SLsApHsZh
zyv{;0Ncb$s4v_NEoH+;wfQAlmsXn+^$$tjvfe)6$*VZ9{#x`2f7l&IFO`s{*q#1Zt
zF<EGmyI5FSTB5!M5klXsQrb0+;TK8_bu7g4ExSdXNz^)<CgEi;oX^j%XO7G1HyMcl
znUIi(%^gf<Yi%ZK!IG7ojPK<@&GEMNFpp>ZB!HKRSnhr6N&Ygg=l1NKVvU{Pd^>^R
zDgf>2*;R;wj5_y3&R__YI4a3~qjMM9=b5q#w@=;4wl!$5>A2@T8lVPUYpB&LrhYr<
z1~h2LAz`elK#uklRuHH`?NHi=FlVTGMA)J`V4nKkov6}S9{pkxW20G5p3ES|Baf9d
zS+<uq?xAbU;|UX(*|gL~;hAyA+@;C&C(CdV)ZCz1`T$I{^XGbts!@l$2nLAOgHt(W
zdy!}X>Tv+!f;!qw(03pP)~4Aw_w)O5CFlV`Jwh>r2NJk_s1F4R7}Q42-A4nL#7}-{
zAf{Wp$>6W;=C?;00xT||ek4hp%B(>BUm6e-#MsWXKMG=jE;4L33rwe4XD%cilpMF(
ziF^;zhnR`OXo0lQid4H4dAZ^9>Use>LBwqBGEMBY@(Mf>7?EB69X}XhC=X(P3#uRt
zfUH^$($P^^8xNN9d=7C!aVUk6aWr-*5IO*x-`j%&&z&Hll}cnsjZ;VrX|@;z0AMVe
zc^a;OO+|a7uE`-;o$F#7oO2Tr(jp6QkQOm<ML~&-Ec(l<6XBmP{tdpQk8rS>hN#oq
z-GE!VO-pwrNfO$zMJGGZuS4u}sc?uLZgl>b6kvkeK}+PV+9YbjMq&aM*enz!0daiR
zp%6y8*AZu{pChA%nC)o->!v|bTw(7I&GA-6l_Svni(1Z*1wCm0brY&+SDJ%P&-muk
z&hUfdhQXHEB1$$FFCu?vp5{)O<-vC@cjOfqm)o*G`jJTZt<PEO90VM5pdD-h!qWE2
z6UnX)sj9}He^%j8*6?(<{Lz`x(b57W<&oC^jEScj1P<~a#{vo~(etOqX<|Hi;A0s@
zF3x49Gfn*f8vIaoP}fKf)r`|Ha;;V)8NavwV>=n5|BOTSJLl%eqkD<liZ~rhn8fuk
zGQu+b263*BopkRB%tRTq=Q&I?9cdaq*fpVxweC5{WzliyEBZOzieurrjP68Y&vMi5
zGOi;_-Kg{8`002_%p9q0Fo*oY?gYn^W4xvZYBa8lJ!83>Q@;mbIOwy#C|bLx$pN4J
z!Nu`!dep(NnO+p69G*k}?fOuqxu6cO{K50=k&TQcHdJv7KToS-;=lZ@UNymUn!8o8
z`ClSt%Vc`Dh*s>yzKyhNj0Dt({fXNhME`AJg)L&R<$v~(hAm8I=|BHV*2Zqb77^GI
z&R<Rk@B?&Du8+!Y6TrSF61R7CLDsxQB`|<O8fix=zSK|0CO8a25L5y6sv%FlIezlw
zrN1Qr=+)h0nxG4I2$J8%T*T`iM4}1MQMVz)t9TX;mk3m%M^(A;kg-F0Zn^*NM_~bE
zTZ*F&NafMTN1rkh1R1_wG0;X)xnc~f7Uo4lNI`9Mz7*+E>r3xScg)=6zcg+et!U$n
zI<e;`p<l0LV3p0v53xB?Zl<Cl{W|kC$ph3_4sVE(C@Z6MS=e)3+?6I_lF{_8w<Nhk
zqv{7^`Ct()nze1*4#+d}h(?dfQugL(yeEwt;$k~XNBll!;r`tFCx&_S$7Nxe+PJ4X
zD(fUj8tnE%_n?;FdfgoaYN0D<)$FDP5GTiHFMLHwBPu#RV?n~8&@W`aaS0v_^i#J0
z0k-MiMq#W5HENsA{q4%21_kA;pyYUr^!cD31ur_5y;MZ?a#s_S@esLpa6CCa2rw&{
zd4O8wl#$*Yq+}fl`MY{)5E6S7w2#XNu+i?E!Sxt!s{%q8k^lm;=Ynu&L*VXS)z)T#
zDuxc!;CXdVS|&jK7%Iip-=F&%Kv6Z4(0n6aa`Ad~#YJBB(W3Qqg(e%6NF$*C2Ayu;
zNBQo+FAeqnplEd{E>=PT73)>Q1p<BQI5>XQ)F8eop?|kKfIJSJ@3c@+?qawGC)CFD
zph;LwS-BWEWLLGc!dC?HKac*F8+a9}?t^-M{QUev1l9$FXpSqwrDTBWGy|)QH2NYj
zp`>6rMh)`xM<<6q5)W_1xKohy?5E|i0wE9=C#s}q#Q&8*264z3#Vy;8wIyq?yHD{B
zE*mPaAOX{^$r{7)Y}7PR`RgWObrvwIm&QmJmaf|*v%@G{*C5z)%bQ{Zbp91(l|JaX
z{Xb1WzNVy{uAuLR1SJU7{r~tj7>fUg1@T)zrC{tJNM{=oLc#}{IyEX*^Kt6XnNjG|
zjd4+VyE=c7D$eO)?6NYP;`0a3O0z=8{>jDl?Hk$Eg=x0(#ZErzwDaA}+xS&;ZEf7d
z01N%w@V<pO=m4=h(@>}LVjbM>t}HXBvCsu6Srhjaf19Cx@BhRbK}me}Ql>r^;)tPH
zS=#|h0|N<Jh6ZJ8UMe8h+I(ztqwiYv3eL~RCo`VdcJP{Z<T`#_x9HDi9RzYivoNT@
zVnUUl(^ARO0EiG9)Z-|eV3F=P*X2UTO_^W(+Ps;r<qz->?1HE6u%ou-oV9l?8vaie
zqy<2<Ef%yG?1Ug)qAJ4+Bl{g?3CghNpSicwn5OmPE0A`zI+0{zSdWYI>$aj;-T=aL
zZl?YoW_>3N6;w64cDL}DF3s~}B^b9m4wb-9g8tloLJnoc#+5YYyJ5K$qrngOp`XL7
z4w@TOV9JvK071Ge;|r5eKi+(#QSm&qtx?<8z@UK?3n#Adck~lFs#l>=EJDXy>;9>O
z?yf)3G&DOAe^htxw(|*|i15M)myJ}*OYOf&pjQb{^(5d(5A`(oSN&R7C)nDl;uXU8
z?;umByonLCl!J<90A+4bUyIrBY@d|oLG4{#njpfMwc`CL5#B?Lh*}F#sQU?!`9CWE
zgUmNR58#mDf%g!&{nogu4?TlY`{3pFU?Q3Zj=`=!zHzm!E2P7_u@V;#N*+Se=+KEA
zUJP}B^<4*m;SUGkOT2jgqJ1=t+ti{?%Y%Zd3kLH~box1^J@H<+uEPduNRzN@0$1h^
z2C<YB_*RuF_iO}0<fsXX`msAx__O8K5(vJ1dbJOXH5jF@;_13X<KpG!n#k#rC016d
zKDl<|2|02_OxiS6qC5nS9pk1J+{Pa2xsDH0)syoYRwg<((>JQ;k#Y`D-!k<zi2A0A
zMs@P&DkYG2l*FI2HfWw<MtDn{FTz8QX{m(y6zHQ{o_)zNL*N}5x@;jajP%;MJ{}JS
zQV<f=Fjxw{p^S>0!Hpkd7Ate2+$`edOAMDwiRa;!G?HF)ALnCXIF0wHt!?{0Kn*`s
zodg<3IyaZdL_&QxURn7lHrJr$kj7Ib2C^wTX6&$#1<vgayk0;V*A$lLs&8cUF7{D~
z``Ri<@5jo{HxLYi;`Z?ZJWkboKL+<i5lQva&}{qg@pL&zzK7a9*jJ$6C&@43?AD!W
zb*V5W09{;M%v?SajE-@b82yhYLd0<<C$gTYyXD-wBQAduS)k=n#Lf)@wuHOXSNZIV
z7>#q$1BtM_hfQxd9>s&We+5$Qr(>5qbji;js3eu)dJw%h;@l+AO@=qSTusxbIAEP8
z+sioGDI~7~%5Ha%*d#uwDB2=R>?u~p<238xAwa4PB`hT04FXxurHDwVn=k_<`Rd@f
zh<QV}62$|a;CF$c24VpNDinORw&8a=QLSDgest^3t{RVC$A*=UWd0&H(aS+)plvT?
zI8rWkIJRA1pOaZ{zNBDa7SGFS)^T;yi$!b?!!9*9u6)vJ9*CJ=)lE@Cy<pEXbwH&b
zggiP!nDzbe`itdhLie`cHt5W54-q)50@C}2v%c}Z`n@E7v`o|7&^4i-{s8LT%4Xd!
zH@!I9^vA7d*+2eVynN@G5L~ab7FE7q@c;)RYyGEaUQTCSw&nmq-HyoV?CfS(_GSd<
zy0!7Cd>lq*M6jc$5CZ^97QCMW4Gh-jlAcnu8^sly;U<D^C^Sc<jJ27EgYb(x@Z~bH
z8v0yv$E3lJXIbgm8xzZcP7bg7IA1a1J5}i)2375n@Q=>s4SkvoMY&O|6Hzitojx7K
z`@Z*q2Dz?7r%~!cTL}dNUC=UML(V1*Z$)P^FA~G4ngesYGGAcX_>TR8y9vL`C(K$m
zDEuZ@mc`Fm*A=RRJu4<%x(RWMPUO=3OTXD#d?>tdMrV5Y)3D>8DmK3CMX|m<EU{~L
z>1w$!8$GTQmIl-gO0{v;hfmCOiqw;5wY53!p($wWzPk<uB7ZgE`7&=n8T7^B*Qi~x
zdZx(z?KyXx#Wen-7ZHhWnwj+l9#%RTz2I`s91RzHQ>z-9tzIvf*!+Dn$6liCR+_Jr
zhQ8Qpm8-)<iu?b@-kZ2X{eJPoBSk5#R1{h$Wi4CTC6!%>>{0futXT%7C@uQfm+bpG
zWM3z#l%2s~FbP=)*@j_w&Rczc-_P}2&wudz=DH{|?|CoxeU{gGopYbtH^XD!%Uj}a
zXg(d@ef{~)r!;$Z9;AJ7;?#?uf=_Ap3qHNf%^;_sEqmRZ<rqK1{)aTX#KIKn81=57
z-1%(xx8xnB^r1;OIn~QDluKBda%-*0DK*PU?eiW|90xce#qYRIX?5>%4_TabMrn)v
zN$P(z8@nV_-zi4y#FnB*`h2WcUi;DQeHCA3H<@f^OT9N{Q}5^U<P)`*bcofPoDkl5
z>FSRs*rg>Y<0gA1i?W*&NtaS+_lv%lnd|C(bVQPH;B}?Ck$8sHG@h_DRgGtCkQSVh
z#*N<@B2VX}S8sUp-7W8Jx9qTWQJTzLzxj54YK!3L?lq|X<P$z*hp)iXFS?n-CWP9K
zcV4qA600+|Sv!T|G{tQ`&wHuX?^KZS{}fc~TN{u6edK(}ulf?>1l_tCChiuZe^6Ld
zZ(|OhfDBgU^u97eo;`7<J<t~K@o67j!q#R(RMc0>bUT)5-Mw-GtEId}PWaGgC+_nz
z)i{n^Np@v0x<6q;=M^EdCv~OUR{Ao!A;_nPYZ981Ks!uNr0X-hj%KSgsdyJSm87eA
zwYogSa!2yq#I$-DsY{9|IFv~w)>5CdFi_r$ldiH+h8r}A@^z@pZn8lXfz<O#pyd+V
zNr4&U$)XBJlm>h=FYFd!GMc?dJ$3>e9~$axZ5<^0Y2U6kn^od0{!tOl@@4U*`e4tE
zml;9S>Qo}})usCldZoDmG8U&_J?)cLswcVGe$74BB2RY?iqo>PaPhcKv53eC@$oi^
z@X*kdhJ?r2z0<rN_w{6{<D;Wia4fA)Lqv6<%GTo4hSC=K5b{XZ*o3yrm;Dqj3l&v=
z+6P0eV-+<#nx#d<M(!IoiQ2#9sx&#F=Q#}3q1|OwZYOr2&a1ueniAnytI5bSaa^1t
zI0S1b1@5;A?bXL_uEg%=kWRKIlzClagmXnq`6MJ<;z=B7wz*hN%)wM@E>HDzW3be8
zfimwgS8P)RHs!Q03)4f@=axJ#URvkwCt>aYRpUB4aMhl;mS_60XRNWK)X^<dd7Mez
zK)Z`Me!Ot&BTa?j)d0`EIeLr1X`T*aEfz&tmcg?D(0R4~29C@rAY&3N^*e01mO&=x
zS4)h?&_C)jCXQErt+5m>1?veMw>X&z-;_?!oz~ftZB$j-HtxEyMfc;C&EQ2je5vj9
zVhuDGVGY025iOQV+~RNeA`;1oBU5l~_#A_>>2A*SN3!^<u2aRvCaddqmv^;cVS!zL
z+-4kpoH98+?K;gTw)Q@bQ%I=ErRVLZIr)0J4t=a?N)pl6e*FfN%eU9xZ+JG-c?KDO
zjlRFND|<&rM<*t;aQp1@47esX|2dn>-_n&W!ogZ9k>(=I_P%EF>xm_p5UcMenk4P#
zFot>YVlHAvY9B!i`V1V85!@qNFR)5lC0c$Ie&^V5Y<alfHNNhf#5!3EV_e3aYoR&@
z7YJ6MJ1b*Y)mp%I1b4ShMxr}My@-o9=!7Jn9h{_Ttnr^g_N0b$ugR?KBz##go@upd
z$dgd;Ozu?<W<jNIO9s;_CK;>2E<5Mpf2sY4(-=2A<#YvlZA{nLGyuOj&V?ao!Bh<n
zVS-O@z~>XthCpnm3hWdm*_Jl3$a-nU7@I)&F!t5Go9K1hWluOVCV1Cb=<X@1Bjb6X
zNbju8%`Scg^~g<C9##wPyP9d4KIrv{lC{12+BT61oO&M_RP{QQ7)fUh({<#lj9rv<
zGF%cK&uZ2db7E?3HMGr}?#+<L92z596z$Z!DLuRHgRR|I;E6~;`Pqz4bfh$HwQY@)
zk6V^%g}7|2{x(~;J&d~x*e<%eY!^!Q+uyBVm~-z@Hj;_^1jGe(53!2bXwQU^8r0t}
zv1+hC#>YtqW05(j50+t};~~!y9K{RPaKmSf+v;>PQ|@K$C~|y4pZr4_$IfDVT$^89
z5R`mmS>@{+bh{-M4CLdM{jh37W*3tccR6`HA<l+%wV=;#3Pyc6c9>uHZEJ!%U6(Jn
zP?d?$2~m4dJ7OO;q0Ra1nKMi6Q5^w#Oe-9cclnopjg5QNxcjnEjwLjl=PK!lqpq{i
zVSQVhd5M8{ZxDT|2swGhLX39n7J;VQirVl1ci&z#7PegcBpCV>Bl}8VbF&314%>go
z`Sy&cOO9EuFD)*oKM81V=EeAhVa$E);OGgWx)EkNIU_@Dv8&dmC9pE-W*Ng4`2_0T
z8xan4E=j_T&SfS96(JS#dq5b0bF07UbG8f2{H8whHXl5K>kSc<PyAH>sp~>oig=of
zHmKfISZ86cT*C>k6+ycM3HR2e@&iG<(+_WM`S>Kr*ZG-QmpFuL%!rLHE^cZ4TqpIA
zJnL76>u>JJ|4u}q>!ipt9fR#FFofY0mS-VRXM{9Ie~o#t;gYB&@on{BltAuRNkxz=
z{_e0v^*DO0cTbn^!lLWq8!4%h&!2@?nqLnqx1G2~c5Z@xvdz3_j69Di=NJ!G23QKM
z&dMBHcdwZ6LJv*uTlMs(Uz@`!s@%tro9u1`B^L>;G6*s0lsSa4vkLVWkwDBd4sXQK
zqqH6N?D;*`qYHM*rYke4yKE;)_SXG?Z5Af;)UN5;V{xP(pI?SjCg=Y#qraJ_S>~Yq
zGLk=Y<l*sB^@OXoo`xNc)nfMjslBzB*S5w}UVAwA-Hut$)5YYQu6Ir1Xc7ztP&J(0
z7!zUviRYANA5+}vQ8=G*lSA0Kk0A#+99MhLinVKV&{OSM8`s{AIIZ4ITKYy(U$~Bi
zMFgS}ICFy?9>>s%N;X<Q$Ap7w@p^h&`zMHX;2(|WUPdR+;h(?X%aCLH{z>wL^X?@U
zrk$1yn^Ic<1Ee-5RyAd0P_kqH^q0IkD&Ub~NU2O$P3|tE1(o@`Z60&#y+L;&fwt&r
z=e{S|7r{CprshiG<SYms%)2n#J3cl42@03=`GX46{NF>4KN)b&JA*s8&hX+?F*Bo3
z__kB2@^z=US3Vqm+U71q`lm3>*x^iX|2d=ktLsBBy=hY!6PkiouYN_QnY%-X`{erz
zEtjvr&c2h->LjI~i_2Qq(=&Q~D!#vaia>)pHTtiSl>{t;E_aI?C)D%f)6%#%FHJvx
z$EMBOOmdsv@W^PDh-+-5lx0u{DxAg9zjFBv%Qb#VpAfTQTB>Y1eEfTJ^MVI9t@}dS
zec6UPky$TNlJj>@l)ry}(!9#4IwG_ed_ZbY+@89bnpIeM%;W9xGP&ty*k`R!_5+Rk
zE_tl2RlakU%TSB!0T1}gTE=_zg%h}g?^+p3-Hsj6Y)U*bTQUKpsIPBop6YBeQQi3g
z&1i0{GorYwj`CqHIwzjKIK=?9!Oc?!|9dJwh6jMc3iphFV=6psaDJljeEfp9Edd-S
zppK4bzYnY%ofuNFw&3Bu@D~?-C>!FBbc{(5XI}lVPr(S?9nMudE?ZCg+@9(gd;0Oy
zg*(EJHC(bnJ^?5wzSr^d-Re1SPYQbtbtp)QY79uQvS!Y{5_&Z?x*n7UZ#&(CPA2Q-
z@7E_?qTv-g^dfnSjszz6>)Tk3sm<nyViZbSRjM*=DzA*lqs751MuU>Q_orKm>@LKL
z9|&d}VUc|OqMXU$F#sOPh8g&_aV%EW*Y{p(_ZaH~3k&NNWlY#K%3;{iE>b&BzvQVW
z_UhHEG3)))avYM5y{E)8sezZv2qfm$S>W5#8_<QOp#XN8r$P`gl;&7_=QK@n$i>|=
z?<HLu=gGq7(hDtDLIW6+yQ}qtU>$gS!O}GkMRj5d9&q(kCu;~3`%xW!YS<X@6iRj(
z;*ZF1kG_{`Y!Y|Tz;S9b`~lC2PhTH*!{Eh|Vm}M(^q;*ivdAIe(Z5+jIw4|rFi(O)
zE~<P0g*g}Y;&l^Ub9NdLm&Fw$EmXK?y0UQT<JxrKO@yDRFn~4cv9Ixp9-8yW(9+6~
z(*0>0j_+Cv?@$j6K3+;%*^S|n8*nI#e{2(^`!4;S+Y|i~n+xy+c$B-Kg%fv+*Xb-3
z;;O)&9C;08;@x~eJ9FJWVCR^R;SEdptD0>m!}v_>8K+eCbD5Xj<UTE3+ch4$%L#?L
zqZ?~`SeeZ#6D-Wn5d(cR*zA9w?W38ZqP>gdmQTQw8kk(29GyLKdidIcWZRF&#@wow
zDW4PqO8>&@unN(lI-)E|ZHwQkZM541LqFzYx`h7cqnr}`oZ|%ta6h_H!>yatE{r1w
zw&_DxzERb{G#_PKmK;|FxwuMxd%Pu(_BR&o6^V}412Ca>flXvSUxM1Y^N`Jx_-Ct+
zoBU6MhNs9cl;~HFzR`^HGB<qR4IA-jSZ~x#{ULlcv9;)~$~#Y!?5B#yT_itpvCpi$
z@O#UXUG7+zAddcOOIdw%pCk8!|2lFF+6jnN1gyyG(-^Eix+&t@_wOAP#uJS8_J<9;
z*ve+|%3!MsVy~9_(%iUM^Qo+X$Y+9H0*J|XjFJlh{~WPiv{yla_J*6+v(3$q-x7Ik
zZy!~V*G5Ks3TT}0D5*2oRAWDfO%05$;Ps89;Vn9Z8bG0T(}>2Z0(O~UR(b66m3M5E
z3CoVQPFFmTYEqQ7Nz0PD?*ZNO{zG3KJLY5_p8C<R9xs09=Q`u(EUk>1*)m0y5i_Xa
z;2r$9d_ZPXJA3iWQ$boeh3|0x_thoMcQ=BDDyi6wx!QFIsy4j+{$<7FcF`F_7JPN@
zeWi6{ZBYf{{h~h6X77qI9_4BN%AGen=uJTwOvcsXl)TmQ^dqz6FC#a)<L};~*PgXl
z;1=7|pd*E0zOp~I?s%${6KBfj@uiuLn%?^$nmT!F1-&DmY<h(4stm8vJm+<Ca;koM
zbZiVy^x^qURqEV|aH<^c4BC57P>Lz~ISZ%t{GjhjjBDMD(QeM`1*BNEF=O`*nsu1<
zS8-g|vRBDxw09ns1dDsoE#SC`)8ay7np)9A@M1a-IrgIxl_q-&(J$LBs2*fN`Axn4
zv!3ADyB9BZO9@*PC$)g_d#xuxVH7D=t^8WR_DyVy=;NsHa#{lL+86dBxSla>PpyS^
z`P$d`0Fvyrqjkp%_%&P@C?p9i<3#jMo_n`-p6tASF$iL}0lYEUQ_ReamFLR?l;oLD
zUM%51BPJeJ4H`FT-+FSuZ$0Mr>GW^BY)_icnU$(2$i2BUSa`qTmDH~|@(|fZ!hP0I
zmKr%uECVbqWaqo_-I69Q5^U1Aaa7s?o%|k%WOKfZGoa>m#4akmIU#bf<0`42OV0>;
z-G?*$6_-nV`L#+Qt!?e4bL&+7nqOxV#;+?Fnf7izB#C43t22uNJ6M@`#otxI$Bj*G
zWRHy`4xg@^MPss!%%h*FlO77#?^MuOANt_~)cF*!jJaKHrB@U(65-<qh0E2Fmid#l
z8oQ6=ZkeTYb8&-F=g2k8I}J59lVS_!rNxKF?dTPVGQOq}5W}}bEhp>VyB4yaUGjma
z8pJmN_9j9XuOHQ8_zDC6NXFOqZNil-K#M|y?o&(APF|%+u$xo9u$^OXao^l;IJ13a
zwfrfX<b|FbJYN6_43>%A!zKu2D0_>F;SoH25xntPOO8>W26fG#Vf3S=b>^Mv%dV4Q
zX0G4CMqT`4e^2dnoqYdO#H((dM|ZlY4J#<M*;xK7AnhU&5~n%xk|{k8>wYYRh(&yN
z2%cvZ<YyJ<7JtX12#a89@%PYbYHy|QR_KGpJwMr57XNAmJ?}?Obb?^#vXNQJMDZNB
zY$bK#$RyE0Q`aL?t6{jibg89mV+hj}o`Qr{fMNsgugvlcx=_q-yWCr&hUZ8nWD!U!
zCvIHGf@R;^;SqM^yqXQrA;n8?#yn?UW(aRMlBeOwn$|MH*`==3231Ql?sx4U(oDU&
zV-C1Z1adIWm4MtKGkA7{qq}yF+yr+|sahoE52jPgE-pmJU3t_g7-ckH0UH)Ru5q@N
zHngS0`>d=T^W4~q=(Ylv3c)w)+uzLjnaxw(dA7aMzkTOqJIH)OLdtD5f=!FkOpFf9
z$4)T>6vT*#ED88C+QT4Zv`KG$nkK3PN&xhaO!Dc2zicB8fdgz`rts5n5H|bWX!s0(
zd-Tz*|7&x9L5Imqtqk=OwcWL&Z_I7_i(l#+qQi&p#<rx_xo`CeN_@&lz~JHM-*9_{
z<I26&6^i`*8`H6lZpZ0<@sAp6+#QUGCxQAhQk(A8=k9*KZr@dqRBBIjm>~Z;;WhPk
zle*L-fMun`uLVbPD#FuE%^i5XR7@1}j<SSZkGllj26na;o>z~%yo3V}kZ+F{<rWg@
zwG)*B$XD;YfiHDj!q^kJ!D}AYFI}o6_T(K#oKc?f;y=Sho~}dF$Pa`hx8-Lm2y-9N
z9@c#yp6e3kv4eAKi?k`TT9K_|i+LZ>#5uCJ8W%If&qp}eOlE{CYD_rLlr_(`QjiH?
zVL~B-4%^RGz3Bs1*mJWltFdh>c(@wAhyQW9o(aB(L~Cut1Sr^lY*chg_$&*tJ9*A}
zn4J75<wpA4Bmg#Bf|$g<qC-I5L?eU^FalOfRPvo~UWe?!CnFvXzb;@zA)gxmv<t(+
z(#g(}1M#!|N)I6bt4`iR=gzF`9vmWz4!VpmGHY%zN>xr0jH+rj^Y~WZvx?YFEax+?
ze9T-w{(gs_O|FA>Sd8e)j>3`iK~g<4zBxd3ZAJar#rs+q*nMCt9;1c4!J}5!vhXWj
zU<<9W*z=B`@z*BYW`JBh{f)tlqq-((<>kM=^gNOec934DLI`Q>zYaBLVVthhZZ+1v
z3iP6(A^j6sioxrWrSqo>VUYHWaOe<HZJ(|TRJo{Ksv#aZuNE^j2T$Jwbj~>ApsMBD
zRhYG~gsp_cZiBlup02942bjUvvLAO%i1&4~k)>UO9(hV$4{~*@VC)gpBl1ylEK3oR
zbsBNv`x6pOb$YN;1XB@P&z8g=%9@%dFwq<g6kbaFQ6B+7%2Bn))@z9-rgI7k$I)Bp
zbn+U|H#M8BNT?kW(tj(&Va_WSe-(mppVi+P3^{`qMU%g8Hh8skouY2ez1NGXa|mv?
z-C7KZVTyi3hti-HJ9J-69J%YT1LYU;Hy}FA3)G9$){Hi01&N+xTHz$tpH>510a!_|
zzXHlD<D8Unvg72jeJhBlCMZiW?bANC@28SxXw+9vlCLp?m0t}6v6INyNtJ3T-GsAs
zF|3_i8VP=@3z$>c1$*dFqy>G!WsQS6Md{~W`(F7WN4Yl*q6}(c1GMIJTAvWYn<z=j
zUxz`c5%vloj(Y+=T<)A<$u<yE>YVdE=1^N`S=bc1L4ER%&sHmw=%|1{Vw;qgjh{7I
z9_EFSj#=!S@!O<Uq_kfW8+_~^AG1`BKP;kCj<6tbBG8?VIj<ui;0OimY#d|6Wzma5
zg&9pP<C(ow0!LSxCm>S1uz}s$BxAQqDql1vDhCgRq^kE+Te@D5`@NAHSv=X47hr;-
zLEQ_llMhe~iTD0_sl@J4NjG#cOdEBpa^0-f8jn*mH>Vn0y7Y$GI+#1Mt_<R@xT{{R
zILF6#qo%qZtx|W{%SnA<(>(>o4uY)+PJs6sC1-7TaxGfS+V%$giPv0ye*T^~=qSkK
zLqB!pWJHgq@dA(or^lbdT%T7^FiH~Ne^YkuhFWWyo=A|_mXJ`<4j<z*4*`aJ)3J5K
z+YFogw<rY1N=h~lS5_}kjLEw;X~Anx5joGIMdq*>3Kiu!@sDu5iiX0V#F9Ye?|@ky
zSjKl+0Pg92gQ`Z^bk#)R@B4ZD=eZpwy&^fSrvplKA~i2`75rIsC%abEXNOFU>-3E*
znEh~DB24nrLtK+(iSe?`UF-}Dvt^vP#>gcf|D<^djXTe}bF&I6MU=hOpTO?bqaNYE
zYPid9xN5|>V}2|$GN+-5C{#C2#QyN|mjG31a)ukp%=INWQl-D#HiAku=;FlP<|_mW
zU2Unb!D?~kbrk9%*T0>;-~jW397JGnyF~`wNhS7qP`Ki!^y=?gPWV`sg{#!TyniT7
z>t+rtPEG9m-<HZKjT;tCYQ@S*olvJ?;c5+6hQcP~qT8>=Z+3kzMe&^aMzAwUIO`wO
zgM8xW^blaaX%(P;9cbMmn|32{n~Fz1OFYS0wk7qky;$+}%%Ma7A0NBis?{m6F*>I>
zHINkwB81YI{7VENU*|r*=Qp%ye9J~KK=Quf#*EvH)%=*u)>?2k7jg(l@2x5~MRDg}
zxl=b3^tKOUhnvd`0C-#MPV~uXLIo{<YWAIYa+|DYM0alrP)-<UcV3e~CVbgXV+7(P
z-~<s;p*t;+mEueB&DLs20^Yo+l1W=0A_bK<tRmViF}~1i>=`2E(Qt=;Ha}NihKfI)
ze<y0!p9^+T-)R5A0^RW%2iHA*CSU>Sh*Zlo7nKMgzPH<0CiVm7!`IOU7F*82(&shL
zoF*FNzd6dXBFFxEoRV_N#T;cCKTX6i-7z%wsXfYTm<#ml*Y=@O^AK^9(B%FS8v~;=
z0IrVt)FjRYpL{p{RJrOvI?%!$fF$w28uWnEUfiy(`M6_p(rXD2rBj8Iq`m9O{mT<Q
zck+H3+%;lHX}<`~P@nGo9V#C4NF^}%!30oLF_0Dc0%7jwo3K|Lt)J3M5F2gNK%dpy
z2wAjdy16oocBPgWF%xrl5zo;1U7o;GMHM5{3kNqyM_Wt^Wz`~)$T$P>HvDl~x%^1_
zBJ(JO9>5cPTvT{l{;P0`uzqx~o$7h@3`r-F9u@Jur3GgI`}RG56*&pFfMBns-e<pU
z4&!>KI#G$&H}AR9p!|LyabK5p+xM}?+eJ4D^~LS~VLyIFGY_MJtXUfS4BqHwpo9MA
zz+uKoA!tNzu6g%7Gjj3cki8h$BP1zl5q7l2SAmv7gzY$FOOCO#r<=;tSyTJT-L*y`
zhWRHEB-_~B`~f<}a32D7(%3aNHa-nBO^A!N^-JCJwaF8i6rIRjs5>yDI4Lw8%QZ$I
zH_T^{%lOG8pf{gOQ@v|ACrflKY-G0x+WrEMP=0ccA4geW1@DjuT#6wU*rgyCi*9oo
z*^j`i$TAl@44#jVW=Ri@ZhXBDr6D&vDRj%;;GAMeMD1Dxq6;7dIv@lHz6cR^raUOI
zj=Sfoh&uSerq|AMGy43UhT-;?kYs~U2~jPYZLxU`uoR%Sa>&;KsTio&&@NE^A_`kL
z`k@rB%V`JBd1!=eqbva#;uO#eD8Gx7fZ9Shzla3i84r5^V(Iq|8J|n!;CGw|5r>HU
zpBpZ6pCgB)TD&pqrYO}y)d4e~cy?`!NKiN@o8-f9f6rzO0GUg1q~UETtQ*Y~u5?rU
zhZC@HNZMr@Z78NhB?k2sxhHUD;a$t_g0^ZK?AoI9-I%o0+1{pG8wT~NQw2ZcXRgm>
z1)w>Z!k_BvyI_(y3ukuvDfuHZdFkpg{#zkG&3@*>PCnUrT`PFykQFr6#G#Dv_a?Z2
zr3>Nb6T9u7CQ6fdoo;`*QOFWNbL1j4NNvWQW=N%;RSXKM{xqeDO6(8HwI^?^0l)Zn
z+#4Zk=Tx*gO6Wp9?zBEixZas2V2YA8mj&yV&Fz&`2UGaPmT>v|)Zy(>%(D*tssnW;
z;cA1Gw~_yFX>Q~1x<kf7&2UVj{@J?-v9MEjB!DrGpQb>?!6E*G5x>Zb{JE03<ZV2U
zSt%$Gyn1F$ucY#R7CS1O@jq7fU}S7;#vqZ@Ey1H>J)ZA^p>m)L4By_W0s>I@Ub`TM
zD&>`G)0nzPhX|M9f|`H0*!D}iy#D6p;<X%%>&&VmslVnXxaYQ7P)2w>?U#8!U6=1X
zvcZYhO*!$6HM?1Vo9_s))YdjOj_0(v2Tp+Re@;O5dHIB!ZT(k1&qWg1W%X7-+sJ;7
z@9o29Ss;5>1nYnUy*9lgVajhme!Q%2vkXu59cQu12+Jik?)=BD%enuWxhf@YolQLD
zF96oZs&OegBo%KQt(RwEcelhMZu0OExHA2JuB?%FcP+{Iy$}W%?X5atDbQ%TC2Y$S
zA^V_hkB?dZ5Qqr-iLFG|>v*wZeBOyP=B8sFY#c{*YAj0ORE+;QRl9eM{mqZ20SJ0f
z=3!dWWxK{$Yf&t?SLl`|V{A(?8*o^#W&7XJL+uWN;R_Re^r4LkdTjl}kI>Cq`f{r0
z4IHc*;?hCt*`y5=o=&Tfre897FQi`MSaExJxZC*`&9%KieE9wEOx*4j6&|dyqTk0i
zX{hTq&9rAFPX~MgWroq0Q$E(bTxIwLF@|88b{U2W5z?xwCD~f8<eT`c-Feh<-?h(t
zIH;K5fAlqX`L7`~eORx!bSD1dT;+k28*-5*#>%cK`GPyu!0f^1kpJGjYz2WjXq?b=
zQ&Q@Zs@U?(Q4JZeg6Vt)W!pl8=F!FA-qq1k_ZN@<`ei-zl&inM`W11E_h(GQRJ;t4
zS;HtHkC=J^XX#mjxm)`U+Oou>*U_zlx54%lX`Rbfo!*H-TeimI{N(C`@{#~8rsG#!
zecITwVlG=hB}yLv`RE**v!MpGq>GT}@J)-=$Xo9YrBJ0|h#RL4=xk^3x9>MQ-ed34
z*i!tXD?9cJF-1vQKLy+uARR!IxZ9={JwdL<l#$vKW?7P$dGH`rw<75lGgK0?PM^Io
z-Q4GFUP*52aqOfXNMAGLAF0M=t#hd0lGB=+T;djrttOoqSuXVpH*07te)`fRJll~0
zQ@7&b2ms=|#lMYs!I@0KnWX8f8wO;OKU2X?d0PJxj$6N~^_ve9akg`oygD!-DYY^x
zlwKsxG(P{&KE~t1DhGmD(rBoTJl!?1EkpM#hJTvd5c$8mqz42c*X1*;=1sisKC6Tm
zYHQJn4BH>kvk#TY{x^U_9y~0kW_|za06xVFuer>Em(+>V3V8+3*IB(wIfzlH*fDa{
zee0F;ukgp|0eM^f`Rg}=c{;8Z8OIo8kKZ;1733CeK8Tm>5tRQ*VT=_SFWD8*!}$Nc
z#QVL+R0xDJWe{7wOuV%7%6pw$!;wWw=y_GaXJ-&S?k!eKSJsr2nP#q$obL0(P=CJn
z04w_P(yz@!N_K1llbRpzx7zMi!8`)hZ+$P7LD#X&rO22(Z41yio@(T|BwC|0e817G
zrC%LAd%|b#-XI#!#&F<3DCgB8qZmp10Jm8s0k=J{6rz##Pf-K%^nOkyWUoaQ)-$wG
zMoGEx3Cls&>wcSPk@e?U#zK;xMS{CKpF1-O9c1dQ;4w0BB-~D(1_>#488#g3DvAY#
z*M)3VWtOEFpV5TZIXYh<{heB1TifOv=Dp}`d*8{$3;MfQPX_l1sPMVD0e#-M_kVU(
z<Md&JFZ3l_pyS^BBA0AFYa|rOUpYgXB4Q#ZYe5_%GXolM?3ay>)*rIQ!wF;K7pYI=
z<<R`KGn)>WHncm@HPG4%OaU$ZfP-QUXnf%RG(Pj-p%PpA5?>SAC9oYV7Oa9eEM~29
zKiE8OF)@K3to_EJ6V4`6u5qe_BBT67>0_YlW4gGNpYf4cubrqw$^Tf*J5Mob{GLRo
z`-S7;8@z#stbQbxpOVF;UrHxcxy@yLYZ!gBuw;#VSNHMb<4s@)F7Eu#gXYJGTHE!r
z&!jQGwK%y~6Wc&5&flrdeJ!MoO8~NJ$P=BE@cGa+e$*WUB1!+hpd!&w#G$vnSgKc<
z=cIIqX+Jw&QZ#YVYvq=RJ-I|!{x<j!e@|a#F7e8E1eBjbfaBj6w`DEeXMYj@YmfM=
zc&o4FAGuvs%0;F}$=><PTO-GX<>dT~i7n-j4oMQSYzxnBdj*j3y%2GncVCEh!?2(|
zv1(3M7IyRU3btM!i^Mbh#4$)&wr$$E!cvM`|A}B4^#E|SnX~`myQ`TkJziZY%cGOu
z0k%fu!DlPPfjBuY?rSKvC8VpkCb)~M5@NrI?%9+tlGTg&HqX2X@ydV4du$dApm~3-
zPyMgMZJiH6=0RcZ_xe0)m0X@dXVear*5ihX74PE~u`&-cdu^{28A+2B`bo@`8E7HE
zb-Bl9p@O*hzK=g)7?JoR|Cx(f@R7eO=4v}ecI+1!1;cCC&xu0=M0dUAFy80jv3w`J
zA@6R*jbnojSp1sVNTf985Ig%(jl3_r&IjcrB`e&-3)vGZcm{1(UVZYG;(^nj`0wcf
zGYM}D)upe)#Ig!nMVY$of*t1Kao;YDc(>9Cf<9-P7I~CPaF%JY1=cV1GM*?~t!`B)
zGXP)ubCLB)qg%zsY#T89^+))8_x$Gbp7omfZmB|hd{+^aPih>pxoh<A45Kn*0`{?I
zs+u@-0}e=E$DLD);9Q>hC;PL`ZwS4wP#2mo6xd6=WF@q%#96npt#%})A^RpdKcJLV
zG?rc6>l@C|R4ctr+r>o+0k~G~7FEI?{rhmNE%}G`f!6GzvRZ(TWCe2qmbBTH*lINC
z`KzL@a&bkv64vnoh9V8R%Q_ny+*8a0_4|+X?GA!V7{`kkp=XbelFOG*h}wc5q9GfA
z^J*$eKVf0X-F}rz4}7aCEdyC5DjkVX+|b7qy7KeDL#{EZg4b+WVjbhV+{wOVyBgwY
zWQmjYAKh}!8hN<-{wgiXZ{br2K$SnQQ&uPcamxcQIj(t-3jya~x5nm=?09V2uO&@p
z1Mx<}oG(`wHv(8ZS8m-gT)dmZZt(o2E&H^y^+6M3FZ1;N68rnElMr712R7`^20L2<
z<_<<xKi!9JX)ec|X!t{{S>s_%u=HKy?CI`DSCIHXHCniC{8C59a^v#aOn*&=;W|$i
zV2R1$ODQ|VSKxPb1PRph?p>!pxj4A%opEP7^Dl&+v+8=0<hfpRN59ZX_2c+{tb4&M
zv@v@g7#P0lDMp^jAGfGI*}kxwmO}2%JS6|BMr|;Yr*XOO*{4oM1WuIVIc*koO>A+I
z1~m~g6MbjzxDO2lLiCY%?LP*LIbF^L4ahB(on1&15k~+qoQgz_E2(yo%Br!#I)IFs
z*^JZy$7rMu8YiEUzYUIXd3fEiF`A?afOKV6BJpqB8enV0jF<c|-Srphl>|P29zG@M
ztK{izZ5ztZCvyngXnnxGP7rFyBr@#XD-?I=tOVgsGO#z?jQ=xk9}j~A%YhqH>{OMi
z+O@17NjFA{pAJ`GjLp-ghW)AzVK?dTSL$yAu}dcb*Au?hk3un>f*|7WOGA~p+3=C@
zNI7D<+f-QYZ%KE$SkNgNH{E8^skbPiL_oX&CGY<p?`LDPP|T8E#P`6mYH1<YvZi04
zau9)q#h7?0&AeJRhz%G2*5+(~$4>+hP;W6BP=C!8%i5J00tPH3*s@|vqR$(zr3-Oj
z%i37h$^YmOA@LSu`lp-)`L3VM#nZLV0Y#;seh#3?>Pw>t&GO=W)NScVpg$6e{{uo2
zW56a@k5wr{w56G~{@BwjW*cEc9fP*q{{ST_yAYHLiE0tl0~q?_IE0Sfox7Y}wb~qX
zh&$j0%)WzR{`2y)$p_>I;0Q-Tds%Nik@xiNzS-F7hM>>-M-Z}PL)<h)EE7{!L7|?$
z{h#MRaT+m*7F)+9isl_b;yhHu`+v`g{G0S2FAIO}zWSd#1e)vHb^-qX`NB15-T#07
zK%ovg{V8qu`<CB3`Ts>r@ZPhN{}T`R^VBFb7W>cZ^#8r|{~hpcdHDaUm}Qv)D~Cc^
zI4v%YR{mJ9DZ`iYR9i&puJ`3Sr&F)r>@K6|{85<3FMsTBJZYQR0MZYNH`}-M>GY%t
z(H^(>%EGfmMwC}oO5A19hU2nzl(kGki-GNO-k%eMy@EU^<ME~SIazR--C>Gg3?Qsd
zMD$yhxxjNIkh1yh$>F%rkY2fvuy#pfQ;~Wmy;xzH?XPEw$H$A-7YqVQV?1#gy3{w`
z!JT^p><gR$!Hu%a^VEN6`-|^8zihqW=?&cCl<OehR8;R1^FI-^Y+5PU*gWD7YE{T4
z+DkW!i<MQ(&I$pZJG(h@`Qa+h0#Y(A3zOqKSmEZ4(U!Fc$@jN|R#+p%nkod{{5>sc
z7i0{uiV!2|M6%bo0{;O_8|u^pL3zN+^B-(RSnW66ULBPwk{uSQ&*eXVN;!k?L*<`N
z=m&QIh$Ib!J5)N3O}VmOew+w+NGH;I9s&`BX_CEVhFJW2jnN}ruN-U5Tv=#dz0G!{
z{ONa*X&lu0X&y{|ybNI85}BR#v{hKbedH0IaUzj#BEyMJ%L32zfgjzqTi<9DJ4<T_
zCDsiV3FD6ag?ebM^~~jPV3q!~S&}W}uN>5`@QkyR$oI&FXe0%YdK<3v;qS{3H0tFj
zFMk6{7m%P%B$SYCgL7Hto&sZeoE`&1zo*MYx+yha%3naoy8Ek0Iy$#+<MzuPjFv_G
zd5e!XnjcX^)^iTWG$@Bmi6=kUTR3@=wj#LkuEh3ac6S5O;xaV3WJe~UUm*}T(bpvJ
zuE(T1hlG0?EY}J-+v(t15t53tY>hB50qksUVKG@obaDmge%PQP$6+w@oq-vEHdzFe
zB*wrXVd&}JcKvcJ`xZU2)IV4G<6>#>%wB#z6LM*r#`Pzqe4#GmjAc3UW=<8v2GtbL
z*iv6nM|;_EOOuDzi>(4BvpMQ6OWIIXO{gMwFXP?rco!W_9}W<c(a%rg;1iOXd-CKg
zZRKV{C!I%$#F>+xmS1DXHmm=LX3$Z7(M>xadGa)uBHD{Mvq$(=WJKC=(FYo`==iH%
zYP58Wi*{rH(g4rGR;x44r%$HG52}!vb&Ann78Gm_l6>`A00)TL4J2R1@Coh|XFy_Q
z+z}iTUb3{B1DY+!E&qWLNyDYnUeTp<(owVIYN(i+RJZmAUV&*z#CrCDs>v1kKAN3e
z7q2<^#IvI(_fRj`zx!1y)F#|~N-;+?zvFCCr|`t@r1X+lKGN-n#-~K*Had$3@#B9$
z<ZFZoh^y+9A^=wRurPgL%bp{?KhToc*gXvlOKIh(lMs+C!sZkeoS;7^f`Spgrf4}f
zm!BEscX-=Tb1EA3yRB5T*)P!gtn7-sAuXieCJ>|d)7Bm&&{ye1Dq4nAwiMrH5r?Z$
zf6Faed^<|0A?u&E*DKjle>i9nsRrF!$px+^XtVxV9_~Nn=WFTBnZ5NZA8E=?lm-q7
zwJ(k@s%1cJ!vojvV`d$lV*#gb0tN?IZL|9!Q`BX2Iy{T+(;*sE!S?#FQ;Lm}36stV
zeTVmAY9)wsvNdNvC4o$AKtY0@bz@6g(Wp;wd}I4N#d?*<zIO;SKK9~a)U5NbE6d+<
zh2vT-Z|=CaN+QRwV_nI3AKUM>KQ5yqT3Eka6mQ%LgYq+Y{pbwYs}LDG@ou2CU~oO+
z1S3Hq7<20{r_x_(ng>=-WX7P-`yWeU52G!WU+falJMrsLSJ59teQR$3ZHO4fB>>4&
zDF-5Q&{drER~L`+7S6y%aoiUWAR`;Hw0SH?h0sE`Or{o_#JWMnh0m>oI#2gsPBlU!
zsx^WudT2@aH|cNUXBI03YS)yW6LTPoa9=?E@*o}(PeXAPhKmXBbH>{EI%K}KX_t*^
z<L=9FFEr<?T3LDy1e)Y88U$mY>HUzm?sJ(x>&q{uK*c#rX&_K{B0=7AXC)<@1<SDz
z|Gn=^D&(}VX6C(AXts97RZVfF((-1iQIScMjg<kg$WG3AYfr&8acvU>-0M%9#y{-E
z7hB!$b*mcm{Ixup-mo8%Jme*o)NlQ6>ai^rT7jP*@WqvWTY9f5A?nrQa?maoJ7^{@
z<PWnoc|YBAs;tk>25tV7y~h2$wG2q~rDj3XqCVl&wtJY7_gB@hMS83H4#_x?3(OS5
zKf0L<41!&6?ee)ru9Ja8+l>nJSPW!0jV<cu*k;_11_A=cqb;j0y1#?sMl|Bi5?PyC
z+HkQPe0WgyHOX{G8;<&wvUT@0!}Q@<1A5BLd5}|wxgop@F}a&rtlJcn?HA_my-LSX
zzeDLwwyO*mZ*^Ll_&W5?Mw@N!Jz~<NhTN2aQ}!p@fIGd;+X9{VK^$m1pz7xB%77De
z_LBi{Z|Vh3p>o2_0KM1TiEQM~<fQ^}6eGcl%vMlo2Ni;U@({A~)r*r}{iW_zlhP*2
zH<)^IZ|CZpMBlR_RQN_t7M8is*|O4c&rocuY!J&_qH<C?>012D>8DMWr&5f(4HCu&
zJx17U?#^`{*xJ)FB1JM)xJKV`d$}9VqkC((UI0HCFFjOu$fQY?iSdtYqntT>SDu?z
zP1x;x&fKh106s!7GQzIc_s6^bVl@qO;C3_~Uom+B{JaqY-!nhGjc=T<>Utvcc6Xrh
z@#&i4&tRIP*oo3fMuq6FUxdjO0w50s+6o0HWt<1brG4=SFf8fpY?ZrQ-VB!!a}=G=
zpXg_Zh_mY9?rGm#b|+M~x?jJ-M9h7@J*|Gez`w^oeClHDhn?Wvr!eS=V+?RU%5R(=
zX(<JWBTT8P)LzMTsK=hL9m_->K*<(v2g{EiUB9xl@T@PLcB9rp%&Id{v5-nJxOQ4V
z26Jte6ggm`N+6V~Tr9ISoIX2n+okX2z=k9VtgY*SJ)V5gt#o^x1?rT2pUp<H?3PcB
zc1l!2)(K!P!ThwXKxFA;QT5b#noPex+$#a-w5B1@fYYy8U{L((-bwqrlJjVD2K_2)
zPFe=S5)@YO*AYI&uwMmSs{Z`jsCc5#7+ns>pB6^ppJE-cmc4Ej{1aehgQVIHu~_#S
zS6Ji)FtR-GoN>gCMJVU><u4piy$(gbv*;bDgGxv|q|tKq%t@u1(wuy3Y0gixnDsaX
znkUoIPX4-yb<rcjym`OVzAvzCo3HFzq^uWS2Nw|H7~Fk8>7Vd2gk0jZEY8Rx+3w;N
zn2d)*n76~FJH7B2R38FXeE)lVjur-}K(;$3aI&e1tbOw9zv4`?O~?dJ#NqrFcl^=f
zu15vAfLA6+Dz$ikB0lG01K}f*sIoONo6auFl~1kNu*lwtIu*5@B}Sck%-Um{33*!S
zEgp5fzAgTh<7EW<<+Ha(C~q##=+`@9@j3Q`x(T;JS}o#)q%uI^BP9PMA1;Ohs}F=*
z`V1TMhljsEd~nyiWufyM%TuV7vwCzJW65rZ%3-&__<>XE%aNkqs|5Y|K^_>fR9_v?
zy<Mch#7oxbN@t5*o~RjlAQY{yS;_RZ*YLs17vLC}jfDm*N%(Wci#8IT7v=ko8TR{*
z`r&IGzGv~SZ7a7ds?=`KqIVX^6RmTq+_yOZz$|a!G$6R=Qv4U-eDJmqxZ<^9nZp6B
zQ#d<9qWc|IRGhijzd0N^4ci`%V45?Y+7T{iU7Je+<6*u2Bqh*0-ucJGX(_B#`Y;xJ
zW)EP*pNl7<`0q5D&a1?6Xf3UjG&tKmBvzvST>6g;UCcosg&onu>$`7yzG+dGFV;Aq
zG~Bi)!r+aq%-TRqAk+ylZzma{{$jN>oz!|VqjYX?c(EGrQ(nK7H1lYj*nn{oxxGl<
z9k*g>oRAM6;Lx_BzS`OSRmG&4?ovQc)fN>G5e<Dk$-X@Z+^vvak}A4*OOq{7-d_KF
zST+V=_lZ*7eB+E)3K7kA2kqZSKf=#SeOd7W3=N>zI6KB?oloq?ef4;0qikCcW4-P0
zg6pszA-{w6X7p^Vu=|G<YB4cKYW=D5*#s7QPc=e>;?%n+L%6%sm-IjgJxe5<-?OeY
zTh&XI4?5JWbvWV7ML940p1O|3+ki2d*1xH4{+P|3uw3KK@BRl|_>ea*jzsPc7!oSz
zLPMe`2xz=MX+%nC=2%X?Vs{4AN%R@#yL<Q{<3DaAhmR>oVo%IhG`vmVU9JJQ!Sd%e
zd&VioPS>xfkfkp3sKVXlA>gt5giKe8fK-x98e@o1gSF>IJz3J~yVUCng5<s7=0{Ti
zKVoVh2GFUM-z<AOo3o8I-N2<YU|4i!N)SI>*s!EhQ5Q14twXZrA&@*?KJnT_ygX@r
z*?h{m>xCC1Vec`oE%rphve7;QrkbLDwW!9@qk6(^I_bCi<L(LdhEcZw5^$zSZcWa^
z2duQH$ach|Ee)mdZ8E|w<GFibT%ua9X>?6INnv8UgY6x8ngr3pRK)u!=U=-_NW1z=
zRXPXD=vEltso_&s2Z`V<%-gmH(68|U>3qV8Qb<Vwa5ruo;-A#u)F{}72>kL`B(HLM
z0{JswA4eYhU}g55jWjOKG6%x!p37a2t}M-jy@X6~u^EPgxL|`Ry?I{sPEl`qNGkBo
ztnFK+LEcar@@(IBYA>x5E*qg{@SxH~{?W-p`>FRgRF<b5NC!ra1gg(hcn8Qp-GwzJ
zDvL(o5Txr>z!^?E`<@cIvORhz>+i91#}Oz~-i+=k=&PpafiZ>MekCFCcWHC~Fr*q0
z;|EFX7{HLGIsy3cR-M?MJv2tdL)N-%fsf8LBN=#~dW$?_fu0vu=HLeXUX<*M?Wj$|
z2ArtK*7u730(5A+iLg+jbHEZyZj~e3@rTDx^-^51s`mM6T>!=wDtK=^0aGIKYqkUM
z%suQo?wOuxho0;=wh$GF`GY~u95RlPs?V{XDc=)73dZ|n%G1B`XY*ydr0M3>S6j${
zlI89za>TYu_-^&pysb}qwiU~kl&guEwu^dV`fqH>M4^81+bqj6^|wk>eLqu_0IWEx
zj9W45^+>yOU&H74JIZe+bb`}jUKFH3WpZx&j$M-T8UL{MIA-cr)wq4x*ii)qIa3`;
zu^$A=M?ql0$g@d$-s;1accuE=7s<tIfYxOzx~P1V3jo2enk-hJA%^x9J^^jhnQMNm
zRk7wF9_!kph2<=<>$$c()up99$}FdM^e-X`_re0^np(AaMb^BlK+71opM753p<PNI
zsfF{qIGSDlOTTb~oUm2@>C?U^{vRMJv7I2m`rGf63I8$ihx7DEUZTI!zUmCgtt7}X
zX=1|Dxacxd9zOCfyV>wI4)JT^9+YB;_%q@2AnSo|&W2FkK||KNi|4-(uy|&TxEt#0
zo+7N}9oYx=RoZgH&woz6$hFr+sDzFrgJ=q(lF3gt7j~a`hTo?JZ;xsE-sbRK&a(C*
zc1e$UvTe&)cJ}<d;PXKGIc1tBt=T_b6z4cAec(g_zQ#25NzKgD5NtzAo+6c=S|oF;
z&esk2ho(RLLt-{KlzNwnmmnI-CEmc4{&{uNY^PXvb^s~kIWwl1z77>Z{Zk7N5O5Wk
zb?fISZy)#Z@HTVW*s=6nh{>bEh%dIJT_T}214s>(VCU;sqW*2pf<nn`v!-Dw0JBXf
z^*4wOSI(S_*%~#>QQn36*wi-OI@w-FYtwPr_>f!Gr%#_Y*kLmyZ1~z@8}gp+b%pO1
zMd6gn=iNCb3$96A7X$><ukuH##b4o9v^j}ORdHn=bE+slk1mT5esd?a{xq!K$d+DM
zT#zJ;>6uuAU8YL#G%Ys&%&)A}CT~Bctl+i{&AbQ3NcEo*7H+Un)d_8JINGy;EdA`B
zS5%F(s;oO?#%%}tMT|+$D-8LO%G#A#MKKcA8h4j!-(^+uTEORMGE`dFZ~Szw*&31n
za@vzL*Ik97EY;NXKJ<r32ybHF(In8i<n_Lf%CrK7v=o~ri?$V4BP|iAX&)OKo2>8V
zup;0MTxaeE48Q*@s_5zRGt|eQ<N2H`)iUAn^6iHhv4O`$F<-yN#LN6x88WsvHwrMr
zx3YOI`x=X)S9XaEu4Tv^aX|gR`ED+97*#*My}i^q4W=lOVcowQd0g#dpffg`q0R{8
z?uL)<J)HmOBOg`Q9MKXh>^*TR!IVx>+>KX0lwBRyU@ODB;t4fPYJ3~xk_og^(>>q~
z&jwEZctVw4Ut1fvs`_}e&a8f4$kM_qA(7dn4&x%Z)t^okoQeV}zBlHoOPYmW6u7Hb
zZc5uc14fJJMP1K4q`%tck&b2>m@Y3&DX|@Y>u1CB3Wg3D)O7XOnZ-UY8&9j^@vA7=
z+c)1@OgN@&=J#zqR!HzIybWzsVz+6rM278*t;So3hI9u*w4?}t_7RhphC7NhC4ZLc
z=<a}*8DBGDKyH@iIUNHpJc4~+^>-Jd*BmcCwE?$d*0yuRI-QmZJH&Y28x>4AO(WFs
z*4*l6%1D^5)pvRmm|{E(!P1Ez?^0*%GNjiZ#7)-n#fn+O*L?hGpQ|Q_R`d$q(rbxb
z4>CO$^mEpJwO#HRD{8fbN6H9V4-M}T^DbUFQsLx;(2bzoJCz}yjtWZwz9@`S^`vwi
z)P<quHE|EDpMCNtsK$Q1n69X$s5$7l%xR?GS;srC@pw-lB8q!)8LXdnDQ~(z5jVl#
z5shuZtt?hJdyeOs8>6{O6+5XZ9NH}ff@o@YBr>`IRLo{ulYYUfsyv~(0`qtoS8Scj
z?tMk|&3&__xm;d8U+0(jA85ByEsp$6S$D>h+B1t6GgIzec%$Bfe!xn17tT>xLbeYm
zg^LR@J`uKO&AEAAI&F8=pv(6+WTMwivBA!!`2na#9dGsM=3tp@pNSmzjELy{;1Q}j
zm;kIo;`lC9RVNM^3CEg6C>wZr8&;ilmDpPLojsGw4~zmToat{qCHv)5Ia{G4=T&v8
zR=yjPh@_!0k-gV2Lue_G#cW+{t;NO&Gh=lTCWB9ckj3G9B{kyrp7_#Z>FUc<zN^F=
zET2$iE48ZF4X3(;-rri?reMb7Yn$nQ#frY^e(hWRbI*>h91|0$$8Jyb3b29s-Iw&l
zeMmpO%RwyDm`d?U(0!09Kf)0=QQ^?Ex^u8ICwOw-5&p=gdGAPU#pfmCy@AZ$gVXL+
z?$JI+&CORf8f3&fG~DrB4$#do0+Cr*Oh4jUdH>_b#Amz^hXOonhjkXa#o#FuRsN=l
zG+K=CBHiOCN@T2<XUX!USCuaC4mi+%Mmc|E+;^Xj;ydsN$5*4$?>XJ|Jv5*+<>r1b
z3dL>Q4dd)N<nn6L&#MM{W-R8_R9ggGahaDbd=k*}(th8QePG;^CeTWq(YOrBI#gtn
zxp=5N`Gmt#_U}?3_s4_N70#B-`#^)tVmUGEp{eCL`J#68LJw#XJ-JyOtOm2g9jXfh
zw@aT9#`@aHe<!9wj=XQVqHWA6x^&BX_Pwsb^=FUhUSLY?dU_v4Mwp6w{4B@+#=EMD
zFrMxuxwUy%>}Qkw(d}lxzF#_cuD!5GH*vUuV?T>UwBSfi+flxenjL$iWwvJa(2tIf
zdBlbGo>MeEr|k3W`SZ0J{DRqv$C|Cc6f_`V^n8QL4t)BszCT#z_Q;JlU6(3qDvgQH
zA0pwR%HL#gV$7nLR^5=)q_O>h*C%y;+D0+H5VIL5*Iu3_R5j#~7-VQohlhua?XO<t
zXU<S)dW>74ET>T8EsvJZmkr!h0E&6phER20>POq<cc|T{ur64j?Xu8yp$2PHg2?N-
z8)<t6KmMCW@4ovW^=u}!%8)<7f32f~QMudFtrVBjVwX<u%h1L?{0ftJb0q2<SAL)F
zmE`1;VtTVFoICdTp=9-#ng?Xd5y1NV&&@xbAda`?sIlFAN#Bo3OfFWl)B5S0KOJKO
z<#|2D)^_cbe2^?%0@SILF8Q?B1ig0Ixv>`MCJIZ$-y{zQ@L*o!TEtegQ*NZ~{RHPt
zT=-MKva>^|P1+Gy`5%SQ*5_~nqW5o^*W9*DZocOIeVAeFs=OQ`18IUAEjvxmr7Pl`
zax%D!SWdRaOR*JChnJ><JO#z2C1=*jE7cCbpeV?d55HoJWny-Ho^KtR>FGMXUAvFE
z`0WpHfM<HfU-V>4C__EGJb_0geIIfD%XoT2B}72vRwu;ZE)w(OBqY~cp6=bWK_o_(
zP(qT}Ns5l<yHiM-&Xb;79x36VRO1&8n=Ulh_J6o))dpGIq#pA~J*1Z!>f-T#%e)er
zBUrC^juz;DJ^#1_reSP+47#-4<E|cf+hVa8Lo%I<cfmz7*KXRp8uGA>P9jz2XW8JT
z^*Yl8uXWU|VzB*Y`k_#dY!R*-+jn^16LCa`8kph~e)bmbqap&{J3NgkwHlTg_lPri
zh#BMJ<!uI*y7{O~g2Z{nY?h-sKl`pgfe);&NLeBEXH72~X_L1;Ju<)!S-9%Ky=I<5
zfY5F^K%P!U4=;#k`}9fB-ph)#Xwv}9XFj(Z#p?tbUh`?!9G3hxMkH8h=Wav($gfhu
z`h9(B>IN`5Qc}x$Z7V;p138npb0;XQ<aVnTACG*?c1gfG0@y3KoVNy^%fC0SR@@Id
zbCxZ@HqW5yMu_l)fIOo=d9J2tz}6$^+pWNSYXW~}oBfYL|C)S>-yM%Uofd>e-n<ES
zv33jK+N%0EJwTugv4_P3Y}tqDKK|)@tQil+k@e|O15w8X%D!|dF)hB4BT6N9d;GE|
ze<X1{Ev=5xdqI<_2B{k;a$m56T8Zz6SSo4if%P!2GK?qPsxlfLHZ`9(gz_UIVt(rS
z=&y0>xdUFyz#JE^->bxLx?A$=J|MMIhoRzKTh*<~h<1+MZnww-O9_$5-@+o`W(afT
z%3#Rlre)SY9~6A?+GV2Sr8+AGX0gvUA^^N_zyY?@Vc!#J^7IELKL5UNEOPyZxJ!38
zpCrN5)RdKiKV<Abi@=o15?fe+nc}iGR<cZLC8alAeC_L!Y`XH|o)t^N4-sW~@O~p-
z---^{4qNIx#O%pC;;)HQEnDhbpR2iF{!7<DbUKGGwmZk&gsa3pV`;ETa`@d2xZN4&
zmAxo#0a8dvSMrzcss56p?L{fHccBS}@_*AUca0*{4N4twVUyUcxetFcF9;COP(T2u
zHUrQ%p38%4a+6iS^On?h_M5a@KuTy-C}phq5k>NxfQ<UKR`WhIz)CDlHcVI35rf&9
z1mjfYLejB<1ea)kdJZ)lps1SuSFI;CdJ!MI>mY&<PSmar*dBfMlTw*)YxA73l_*1z
zQ}uRvk9S_wC5DD(tQoQ==R(65_SJQH<Dv(*uz_+xN_L^C5_J1=-;M7|q$t`A>f?<G
zI!5BIUE3>puHNYcQe}BFJ6Orv*evHUQr*-ffJs}8&<$LgLFwohF36Lpo8+|2ubXJj
zHU=ojM3(SqTo@f2x5m9~F`xT(UCE4Iv1b=60Ks^JEA@_1G?^C}BD5}O;14k`Iey!L
zYUJnTRard7-w~p)SB1XjRm>IZ52kzkKLO&k84ekXp>$oZS7A(V0I%+UAj2afg}WIR
z*>&QymX~!6yaO&WyaI7~f|W^iBZczJR6vMeQe+aJ1Ij1JXv~!7xRG*1s_FJlWk4C8
zuA66S1kpByZ8DcTlL|-9&2Qz<gyro2P6~f_5Ce?n5_GNZm~zUlF0%CPp)hi7p_MwE
zp#%mg=|rlUA`Wvum?P8gYqNo(r;zRFH6HnWuQ0gQ(6aLLP7P-2TsD_}$#3$L0sy6m
zDPZy330?+q_yj)vuk<eQ;QkA+Z?wm!E2k#@sRwK1XL>adfWMMew^G@1RZ1@l-Hclm
zf_?zm9i^_;pGIRHgDoG{K-lp`*g6~Rzy-H+yMTnt&l>DHmz7t$Ii<`d{#bT>W%hUT
z3ypR>SXyqd6U53L==~wuWyVsN@w@Olfh;~bnMH9R^QX-XnU~|iUg)1M?SP{*7hR3e
zbo4>SJna-)N;%PUd3xP@a~HlUO_#&S)paj)7;Vhe$!qF@CBinaa<<Y%X_y$UGzIhp
z)TLQN)$-}W_aC8Py5!;Sw6OvmUXxV1jyu!ijbI(r)m0YlZr;T6$UD|W_KFW_IGWiK
zx2kNuz3344=9CX9cCCki658wRK#XWXZzV?hlD#A0vf=^a;wk@{%*!A-r-6_u_}cr(
z+`zZO-1{kbf{C7?vhXa-Q^9Kh$joccR}JPHcoEa#M`ub}$;qcqi2Hj@scnMcRNv_x
z9<5w8TMOQsC=F;X5_#dYv@xu~KV-K15|r;jMSfNr^&hvY4@Qv|-HRec^<k5d7B@az
z?wTKrpW~}?Q`mjrK#`=dCQ|H0&vdb3!p#eY1GO^<3Eht(0d#SkAZ>OG?ac#!JeS|8
zENHlq|N51d)4FZ<={5bFrY8p=oXYp3Z%pv^eh*p1RAkhUGNxK6kH1*xT5T?LmMM=u
zTps%PAa$@8Pa|A}k|S^%=Hf(S31Pe_XR}}SuO>%W`GR;yKc|0vGc+yXmaa|f9!vax
z*n7{Yrnc^H6h&;Hcx;FY=n)$TqJRiUQB;hGpn`}PiU>$os+16HaBQGKX#zo%E?q!s
zP*g;EF9D)bLJOe>2ubc-0iW}{AMO};+;Km=_ul^=!!yn~?(DtxTC>mJoHL>+y{$3M
z^`3Fm)O*PKPvx0EH{$>dT+ZTRo28G$GXTgMvTo|0<z{!F+HN-t9E74dLzPh??o(_b
zq#e|p)FD4(k!Ejjrz$<u{o3k9g{Gip0KvNc@zJX`kiV#nx&#@hwZx+_3Ew3*UY0%g
zV)sh_jmL7A_UaSKw99d_T4gocTP%KMZ`|Z@N>?o?%aFQsgfv=!B5C0#%U*g6HhpGD
zVzjr)?H{xHE8!j^Ihx&{(C<r>tk8x}<I%6sH~2Qti?95UFQB&$5`17~TyFnT9+mS}
zxa@4B|3Y;GYuYFk5(v7G2En=+endqT&(_b|dCPU*$?HHM?(;-NqqwUQ_wVtX*^y-p
zNZI}5-uk+y-AN{CsZdDz{VziwlF1BPeYUdW%F)K_O$VR>$zv{>Ys0o2$NGsUh4@2R
zF71EUlrW2l)3(({&e|bQA>usQgWCXAO!VwmD5new+{Y=u;w}{7j0+NIUhe%Yz$Y+1
zxsY&OT}5fjr{<j1?{}U`JBR^yRsQzOvOKVmrpA=7&ea_*W!LnjOp&SZ^dUId(6x4u
z=g+6j84uRyWI=6|R8BF<YSkJM3zH#k!aNpdUm^Z1f5`FcG`7Qv4)wASn#ax3HY4~4
zBqK2w7eOdC&aN>n@(@0o94wg79<qhF*rgGC(#g94a1<YIPOZne-wdSAS+dp^&Pq@9
z*QT@<S9X=DQ(Q6OM?5o?#P_V|a5p=}0BB80YdErBucW>IWv8cVpN5gM1E@7L+=c{$
zJtad6vc=P0-f#rZ#FVc>%sq5O4YG{O1rBp&GjB2<_dfAn>x3_|_gBS|E(|Hmuvy2U
zx?`*S^@Ld7-c$5kt3bW9HkrqwvH&>VdgR7)Y8XDtJOs)jV<xI8c*j~O%mK7>9l-yD
z?`=b<PoQRR)sV1;y(q@zJ!{9>qa6la+%HB&h4vY?zw0mloIfeU9<d%;K0%SBwdI=V
z98>AMb@1Vueu{xe5IK=1|7f*fZlBg^C=BGnfcDR9os|B$5Ee(NF({-<Sf&zk4v++(
zt=_io(73C=t>q@9H7!KtqDa?|KPt8-(c@Vto2<Hm!XMRE9~f*spjpu<rKlg+rJUMo
z@;t9|#MibBCxb;Hc}OE9LU!sbj=q6<%wnz(CH*_x`!IxG&Nan9>xuQ=BwpaHo8RA=
z&6UlB#VrYqVKD1LhK{w2Q6ch)GB4*j-dEizO6gxnb{&xTiFrF{OVME>m;kBle7Le9
zgq)LK@SYyk;&M+yOy%;&k$@bh{6ui*8#6bF_iG;_>;%-bT!N#L3g?{7t0CNi>Z1q)
zA%J!M#^ci$0?c`>$GwwJwLhz2L3t;khoOopPas;WbbI^*0^Zig)(imfeBS50^@hD(
zOE+w?t|?}PPt|u^FO>zj{8-0?ZCd4|@Kb<&p2u@*oh4oa$pL10wGj|JjcJY79c(Rj
z_h-L6vhSyih8Z9=5ESFG!<*e=XPr6;4}>o}&g%wNo}Jicxz7d+i14G-{iG=iFpz4y
zHM9z!euBLls0s`YnJJFdIv%VZ#en@EfQ<saQpvq_S{<i$Sh9-F0!KtehV{w!v%o3a
zFn9)>$$E+-I#myxr+Qgx`^VFe>A(0Jl0I-rq`_ndh>=41W$|F!t|nUwgm1$q2Jbng
z98yrwDLt*)uTY7o(ZC4g(A5tgTu5pOD=n7<LDA6R4lAY`Ca%T<@Ucjr0cWJuK*LHs
zfVNI4S%GTwixs^`gLJA3=e{+xJ_3Xb0%jB)#Gq<4C@nC1*tCjgr79OswXC?U09&Ev
z6MvFg>0z7Nr>2;DZRk4?%DcQEmS_VYDh{6)n-CU13W-2~TRh&gmKd!rqKrF7$7e|V
z>^1=m8KvYn$N|-mL#;r9=2lN9W`~V&?!^N|kfP0xJGBi%fW*9<Z~Ek03!5uxW{)fr
zuaIc`X}gci&(0+4G$k09uID??p6Wb8lt+?Em8hTFL&5)}VAOma<Qgj06%^Pmd`k+I
z5mPr;@4K+hg8i5elE0E!U<pBpc$1!s4B4)>pyY?VZP8}|fSKq+rHNmgP~5rj=uMJp
zjZd6?1nFr|qoCkIx0wmXK@Cn+?@BJ*PVOFQ_a5<q6o%^P){P3U?SDc7$<w7?uQY>S
z=-?&T=vTkDaiC;n>==>)+k#C(p;T<M6gKtY6FjHr8<Zj0biGf6(uJh%Tm7+N4FbeO
zP#6B+bmWc&=2DD$!`gQ0LMdCHq0is7yY~PNx-d9#OD!qw^s_BCE1k}T$sI>xhD=X6
zyi75;a5kVNb1RheajW2W>yFayXg<)`wc@GniHSQ<y-X#NuHPN_Nw2#k3<-zxbr(W>
zJ_Z0Vtfr5}<|QM{mvQpwp;JY3Bi;>e@JpR8g$rX<SMMx;<vcMl$)<{huKk8^a;0-?
zrW!9t#PANH%!YMo96|b_$YaqV$;#2zbh(-mcTl(JKpLp-fEYvhNZb7gIe2cx$nJr1
z=ANwq6yPaK(paVeWy0XVz6;TBMkk=Y6!Ugu?lt6v8mzuY_ZPWqo!5u7flo-+s6JBQ
zH8Q8_cFXxqZA<dEd^(Z;4RS$~Eo6U*LQ7Ly%;u<7*C$IZ0G#nS^w6xl-9X)sy?Ugl
zq)sD>YBGamWS^_3w|=tJhl5U>r#URw^pRPCq1`27S?aZ->U0$l=&HQy5WXL3#{}-v
zOzb)?O7FY}PNN2iFFRB!vUW#)F{-QHcEsV3KwOQdb!xEmKFYzQWg5qQzqAne5&j<9
z$a*ea4JD^Kp=JZ0^Nh3Xp}NY`quFIDubW|&eZ4n){fez;yC=i4{Aj>c-;T+AmWxIY
zhJQODTozyp7FJCW=qbr}Ap%QymLZ6Ebp315pD)>#qB9L=PBrI*^lyiQ0fdt6(Sv}p
zY5$trM69oDSr39%J#S6>2-BK0U<%{U2^%4|$C%913u%j<X-LzS8WUL0cXutG@{N&w
zpbYQ{Ywk}2`m*t@hC);FB^@NelzgiC0t=U}DV`Hmx%ILoLu7qW_DmSxAfq<Y&&?{J
zLGHkX2$V&Sq9$)Jsnaw`m2?ySr_3+bW5i=jmVfg1>$FfGKS+&(`P(9k8>=!n$1E!H
zGSLV<o<Auqjdyq?8p@6~X#Jg)rp8bzKFZmm)-d`MDF+Di%a4cE#l7(>-McnqCX5TV
zI}rkW@YS)<K6KM@f}g-#P)+xfd}gZhyzyH+rOWT<@oyR3y%(8KLu%SOy~%Q)ZmDGh
z6g3R=3^YV}BA`ZC7InUQ>0c5cyQa1+8-QZ`QoAjL$vf>Dsv&D{pKOPcie?!tjZ?>-
z#K_tli<*8;Y1<4~({QN7G@c{Q4if6Qg{Dvoxz^?xSXv8Z3eoS6&|0qza-ciMS?{9T
zc#rRL%l?AwJ8aDBDCg1sH%<i<MaM9IL5G6k5X!A@kqY6Q@t+{?iCF?Ohn-4Rg85Qq
z6>0_w5jQ=M9MEjA=lfs3Mr|k`%(F5N&a*3?gZ??kbbv%W)f9K9N+#Prtf#5iazb-=
zKHd85UNGeeH?rCuuUUC+n@XEx$r#`-yhVuvm51%9ebm{AXV($NiUvt*EZJ?$=HP(S
zevLVSBWw1aY|dd8PPb6(CF|t5Jn)7JCCe(zX_Nv_s1dm@&@ihNvb-8s^$}8XL!}H#
zBVh2d!Pmh}esU^3yrj5#|NEb>r!Dkd-24Eiu)@W-j^`T)9*Gdod$ejY6B6F($3GYt
z`S-Z_)Ql-?&`duGm0Nad3KJF$(dW#ddK-z;*Pd>dp!A-&a}9LvEERwN`%B&5O^;L=
zuGZu>m(34`P3AeZn-Tz1L_B^sYQMsaO0KCc9^`l$&daAY8S;L-NpB3_UWqj(H_;Cj
z-&+b2XbwC6bJjl&X;nna7hV|LX}4u(#8GRQf!k$N7~#p}nUur{`TfR>V!-;Uc+!s&
zKRt~})t2GxBmr=w#!yyC+*8N#W>#AdU>d7$>AD;V%rdmHK=v!ib#L~$aZjO0#q*`(
zd%q3@4KjsPXurwfIj@UM&_?>!$^hQ8)M<4rD#J17h|Xm4US4xRNQ5V?`_{5+T2Q8E
zW_fST>m0rB7x^t-t)qOVvn?~U1;|hkG8Z|kPJp7!ZI;wlsQat6y7>{Ryv&&3rtU1&
zd@cP9a?W#HuYD<G?Po=vJFXWoZ)bPDQR#KUweV3s{iD7-(Q(B4?SStDLv!u2!i}Fw
zUei|}1-~(E$YHF2WcarA`u$DhX$J-S8ur&%z{AcSqc_&XYm;Ro4VS1C03=71t~~BE
zAr{BtQ%kk3`$nzge>l53{f5c+X)jVdu7f@%TgJOqZszsa+jm;oT*{FkEtYgY7FovV
z<(BhPtoF>)a<A#!jD}46#Cfa4Ir*RvtB6-wSn`qGN+b}pI`+MW1~RWEovqv7-OeaO
zaI9a93v#-DvqWvSICEC+&UMsEhjs&~BL&Y(-=fgt*Gzc3EGb_Ot})5l5GvKQ?m&ot
zi^No3wk;ps|K~l6lV>Grm-v{x;ltRpy?^+jPP0I8|09vJ`i^%&(@f6C5b();fL7yG
zs<wL+5aV5Sn2W?nP(o%CKteWA#s}96{*5ZZ0h(b8L6Q%)jHuOXmT#{*>d<No=uES?
zy9B@>UaPg*v+oI1D`|P3=e9E-$A?&Hw><y#b`8DKBfdel^bFv4RPtT*0YozRyd$-7
z=QbYoe$=2MVN&&VZqDb_rX-KTrd->>@XdE|7173#o^dolrZ#{1wPEStTg?4EUq!oZ
zqq|zBQa1MUkVv;q$jpXYzxl9MROKDu{Wf`ByZuX~oN-`-LvBH1)*bE<+_Rb~y6-xq
z%?^1VfmGQ~%3s2Xkn#WOO6wi6SDx&s43T=>`7^|1DbqvjO*xeFLVaHL%(GljLR-^V
zprQZ)_AM*zXXo19+EqN!E(=8VDZ(uJ@5a@n%K9PAQ^safyAoWSe2R2aSr(k%5?*_`
z<bF2scB$XjwKJ+mMvj--tp>Cf0yw)sLDUlLE-*d=Rc4<;?K7jj1?<nichSz;ZK7wt
zJpM_6es?Jd0c4iHJuT1_oI;-LBh!V0-|VvkoAc_&J7MT#*b!||L@n9&6)=HZD@MO0
zqoHi6(g-kj!?b#^(7s1NvvHJ;nyQ*L?Xp`I(EPf;CzggiDmhymoON>{5M%m?$)7Ad
zFV-Knkkgk)1JJ><Jp6;5rifi#X@vE)JH|kJ{M=-TYWQGDQ`_QJx<#9TN$q*3^7~KK
zW6Mqf?>Y>&p<V)eta7wgtYt^*v^dIPPxL@BJSvP2XMNTSeghy3E-d2J8L(sHXvOzd
z-<6;rXTAKg78+LrF?x4t7$O)*-GwHrtH-_U3wjybZa(K0Y3b&5KwUSgp4}NbIzMax
zp^vc&eQBuu<eDVN$85@dXD1}PIoSV8bF*~W-~wDiDPDZ2ysQirnIWUR^bj0_Ei(Wc
zdsTvuXPxIFNbnY9n`>}wLXSD0yvbd(IGXmLf^>@#?%`&jtsX`pAkAC+Xs-o0A}X)U
zKIWnYQ={0kE_q!V38Pa7uuHtVK3#6!0SpOYau;ps^~P6#FHkWsU9sAZPSn4YHgs(`
z8?4eFMQlLM_|b;#hVTKWXQ8?-5xON*ML;;5qM+<%2yJ+xBTzg!dfDS`&)o|;j~Dp>
zhNMQf6wr`!Dhdi}H7?D|FlQyGyZ6StjnO6>*k9{r2p5gj9sU=~Cn&6TCtyszgah!u
zA5)?y9;R94LA>5+qJkr&y2+mNf)}9|;gb0U8VqVc1?+38yxSaSb{wqvm=;j_YtsRl
ziDoacmtL$j+qU4Ny7DAd_I+A)B@KLYRCQRJ!z@riRXh9kqR8I9yP%BXXF*UNPcy4c
z;ngO$;HDl?(o2}c*BqykzkcaL1w`*vb5PQ*TIc0E8J~Z*#kr!`IH;=z=k;mlC+G7p
zE>Eo!08-jGT~tike;D^mpi?d>7lHm8gsN)+hw=f+dY1U>dRIC8Wyg-{B^8tVCJGTI
z4$N`epAWo_F_?Xt6};i)Z~ra=Q1jv!j{cf1E)ux=05JYhMAq3n<8Bbc(8H1RPPcg!
zwc_!dmSG<&f;wbg5bE{4?SO=mUOrnPDf0tLR#1q%ZBE<Mvt0mMl}SfWpipsXP6M<y
z0sHvnLhC88bnGa4eX2^>pqSBcv*XDb_KMZMwE*F}${tg8>N~oIhT;IfBjV+7m3nP<
zM@ozT)Pm3)J4{5!m5PrE3@J3aoc;%bK^3l_V#^t710H>lPeABHVomC(74&_T1B937
zjmzOJ89{yLn-S!GNOA+zLNi828=b&=FiU*k)9EP5@H)t!mF|~jH9H>@mShkg)xwIZ
zQi{)`R|dK4@4s-%0a!1ethr-PtF&O6MZ3?U-!UZ0C5Yx^v#f!EN7h>p|7H-|S{z&7
zzxHx706QeDd#L%@VLK=mLWMImhFc+R1b*~V0HPL6v+m6N)BZu4ZS^%!jd=nL{KK6J
z&@>^1GRmxJ(CYHmRB#~~gGi&OmZ{9W1ew?J`D=(z$YCf?ZeXt2UEpR=EW8RTSm{&3
zRt499Pbqk6mMufHh}pOFp+A#T)Cu7sumkd4v*)Iv9mfN%x$osuS9zF`;nE%xy?pC%
zHqC<G!$FNBJt!v|masZkG`J4+7X#=p3D{NX&gAnW_=2yJ^SaSs$S8>~r>+<WR51Lt
zjnX<2Fvkea>B04FN2U}dHSS(;XH_Mq0AvxtJlCDuHwqCMFfZR#x4i2In_#L_(Cb`a
z(7P3Exx@Py#+$)C&?ffMI+<LMJcA6;(EJ?Q-<bAHujCr0h%=)<`hmgH3wMIoWO+T8
zuG)OKzxnP?A+DPB9XtRaE>yj}NfOTqo6HM4_<HT(mh?7&!OJY$7%Yu9&{0)AFaLP{
z*kGmGz?-oRX!{{=ft+EaJcd!hzg+F}R*9~47q5VBKor`rgbvl=O<9^r)EOXrgq1|-
zL-59p%S>DfvR&Gg{ghDh0}4zA1K(V+eDnObHvsTKgr|JAv4b`xqjpwBat7ew%WrQ0
zw+j@`AV~5W99Ncu;a{`k2e=Ia^my^?#|J5GXO{3ZbE9s%8|Qv3LzcL#Kss2E4LgpT
z1+3JpT`?(EOg)Z*lh)Cnp{h#w!@kkLF<EV^1JB=qV>FNvvNvoxgK6rSar_bfDKYW8
zlR)?~vWcVEplrlNm*!QnV46$U9au>b8Rt|55TvoFe-d3;66?9QSj}lMpZ_5A!Y)6X
z(m1K8;}h`JP^}T;Uv`IMY*xwI1(im06IDYH%FRI2zZh#TS0ty^e}Yb}$Q51wez!Ha
zq3s#Yxn}8Jpk$TY=HG#}naq$<@LbAopEkC(GH|=>`Ks%$C6vjrUAY}Mx4aXBV5b|c
z%RB*B5^V;pT`<^!cL@NGj8t{L40%G?Yot+D<I2&BC6GjvY?`1gK)6>{`%^V@lCOtY
z^tbQ+I{Fm#z0v3<>fU&V)szhwcxbJY2xaGKhR5M>4T#Fi_XBz4V=1Sgj%pyp#HR@@
z+1;y{G1mcSlBDSlu_fOmu2S9Oy(T8)^6mSjv16ZGt+LISaTlv}>mYau*%nh>t5|6L
zdHtY|<=s7`>2n!N?#G-K+}`WXQw%Ob72YWo#YDg0UQ22HB{40g7~Q{*?)V6>i4Eh_
z;F}Nxij$R}k%iir&IT*pN7Z={Y$7qWHY}gjB7WM<e!n0(_yq+Ux~&EG+yB0yLw@|q
zwlSAcWn6*zqqkdjIDZ;nbE;_i$2kB-pLL)#+q(JRlQ|i3UgX$aKj`RQ6rk)aUb^9V
zKd$1L9~%lGkSQh)T_4hfcT_Hga3BATwkNu}Wxw`~DPk`w>D_#0X|^$|W(Vw0uykm0
zhIP<6H7gVP#ZS(6JentcHTHqW!Qj@q?bsNm%{1Bkwd$nqRVXQK7!08p<n}cB20$T*
z9H4B&k9wb|EfwH{s+xg^88tQ#A6X)z2A`YaGt2TVjuivHRp^^)GLR}?ZI+7{qZqo)
zUHI-N{21i&WJ$>j6kXr`*H=yqLZYJ3-WM}JQ)?(Mf-0%P4qgqkLB2nSA_(uJRGyOX
zTV5Z*plG7G6}Mu3jN|2d@A%NY5?|=M5X(>9tSlo2&DP-GJo)y|g9knZ4FR5{B$hw}
zob2nfF=sbeK7Z$CPkvbxwBrd>)<KUfVcnU(x%&{248*-Qfeuj<(9~Dx#d#&v`i*GB
z0*3|NJ6UN>r}UOX!D+BKF0)T1S!>l}s#VcD)Tl!%%PPU4b01Wo>Mp<Ue=WRyB+J7#
zMLPBx1Yj+cvhFqGv6?UK9ummKsX~{5`xF{jP1e&XUKogwrJgJka;J4$1q^{Bk!??R
z!(2T3JN5(a#Kg?{se$Cwn3|+_khO3b@7T}sW?R{l3$Q8SWyx+S?FiaiccIQ=^;G~D
z4A?arf`#?Q-YYj5!}<n6%r~H<V!tGB;2l&}P}7kP>fJbxn=Y=-XaOJH(z<%gowOoQ
zl)!}pgVR&rlwq(!?#T&jifiH|-J#BX>T{aVMxhPy-=?<dCt0XJmIbo{3N^wwI6gR$
zms!xzu>rM6g!)JUE&dWCNG_Qf-aS*$Dcf+|V{$JBIy=nHAMu9&?Q_igq}u$QD*)7v
zj?><n45t0#fK;l&fm^8J09uVehYdZ2!PO16*IWu*hg(;nxIDC_;NA#l1oZu+s0<Qy
z`(=kHN>Hp}-<i{SsRaN*7s<Bkd3{b-+l7pekN=ogeE9I8@bX{K{Q;pe@<^k&jqc~_
ztS*0~sCW6t5cArsF4QyL|13fUA2n7e?Mf|xl1kKX>=@C&3>c$-yuvn7!%5lFV&C0+
zhte#xgrEcF&)xs$9ZZwt12!B${X`Qs+8r@^v|=XZqp@|hWExZAquX&jFpT6S{3p+@
z7uht9!p%tCzO7FHzZ?e<2Ed%!B{J6nnEAKvsZ)^~o-(B>C@J+(29sE{zdXw{@7%c(
zwp74^b`Ws!kVQ%WTX#*r$^5yeeB2gIH#usu0G>y+sV8OSH_}MjLk|u=ye`eR@`qZe
zNvWmeG@E~9*A~|1&EKtzgBgF<=JN;a{j!XwNsx=YMDIY?|MY4=yYN39Dqs`-r!NO0
zh5zYB0-NwZ?O$LM{x|7H0^u>~Yw6Is0{+E$;yv`*IE$RPg)6$gjmcU9r6;~;_mX=F
z;%zkO3cc8qb>WT#IT+)iMF88~&UHT^TW(mgj0i7bZWjF4IvBsc_#of2Z(-V3jlvVK
zs=0k)^`I$uy7>MWH+$4V*_T@w!o62dLdDA^MBJV|Xp8>lEQ$*3b}Zh7fpLiK&@Xle
z7x%gF*jHy^gbv}|tK^n}7_z;qB7oqA)oz`E&>$=n=CxSB|N37R(F?OIGReE3D@7yZ
z;jduV@;o>OQ87R)U<q<Cq6`}48)Db<Ec>q=xR}vq=V|x(4yGOq=Sc`Tpx(VZhhSBZ
z;he0jzQyg^y^3e)zkRfI2jrj&JxsF*64wq>z4Rnl+G=(c&%W!BxF6)izd;#mXgLiH
z_me)`G=IoHz_aqoLZ@u*S4GQ>%#hSep((H}3MxYHj&B`mCsgv?_1DB*TA`~Ay&31A
z#oX1b=?!4X?8HRLXmC4SFHwK=U%Pk}X6(ezO%0(@hC>jG2h5WVRJ;-1K@@m525gZl
z*gZVUn#vpEQJYz4TiUnk(8iBhc(th^vgVO{#tU$$g>Cjdn*!qip*?mp%#G|X%^reI
z?-)!y^sZdP5#mXD0)ro1hN=`2Exh@ILwR%)7h&V@V?9rl#Zih!!zRI4jf9b=Fpmia
zq~$>8<^&n&IIo{(j6EU1lO*sjsYrZ<2GL;eHbJj27=wTg5h7W!YX8;54*rMw1r*@=
z&-H(Yo03qD1`)Rntw6&Ik^aIZArFhuJr!A{WD5Xq-4sRV2*SJezp_(MUn}m#?cuKb
zwZq$72U8y<Hhq=b8X3YuQEL88@2$BjMmOs2hrRHXh%+y{fvE?OT?T5hoO3=(c{k?q
zBWuJl3zx1n_r5+LPr^G0w+c|!E$7jTP;{(%CGL6?pMuJVxR-h?>a&ov1%QaK>*AP-
zmLe|Q(;^^}1V0qV6nS=D|M&e1&%HSst)@k|4Dm=|Jzkz=CV<Hh4L@|AfM!vxPBv^n
zvz55lLW6mIT^N**4|9A7@5+p$xXnEB#d#7S#WFG3@mUz+W-#+A0R~E>NJHH__gdVt
zHKKC5Fk1uKvot~*k`HFgJ#gyD6-#|3%3u^t>9lq}qx`RSz(_38KTNS)s8B%<k;vYP
zn#-<S3m*rgESh25kPU^woPuasI3)c~uif(ILEl*BLi3^~i=_+m3l{NMDeWJ>HHa?E
z5YY+!bCN%nKz&8R=hY|Hkc->iSU46*#aAR!g{tJXHy~i#5jz{#L^!06(jO6O+Moc2
zXuyOOLzu{6k=6EI`cJFCq-BU8zCwTyhU3J%3@C3eV0huCrbr(aCZ}@G40V>_uF4!X
z2ZpEGP}o=H(IF%9MVD?b@TafMXUnYp`xBqRIE*{(&<q-I$}*@dt%hg<wV)v24lWE<
z(1uR<3zx6NGZ4sn=HT)G*irXD*QLe3;7N*KU<%)ZI;vx#e>&{L-#+<Q5}<qk$LN4f
z_<z#qFwN^I1j(WP4}{k4i}}nibQMQi4VRt<%=7(_zwE)5rE8vxf0c6($0)&I!vF9v
z+>+qu!<sU{TrBGWKb~(VM2TPm&n2ZZ1T>%LKT-j1OxkG~qzRI42WoDv7x4WI%;{CC
z){{o>S-2#0q31lBkB7PFT>-rh?yox@y+pLdqy<Cx;7rY3=+nM%YxLGxsG=3eK(K6I
zzK=?B#qocjFJj<O+Ry<Enhyp2mkdEA{<(Z@cI@4&ncVEX4>QM1Ai-aqfVPNtKAgRo
z=+NT+LcGdnU=y_6Hv)zE=kk?6b01M3{)$(-G;h4Sy8FY2eDMch2gqz;GA=lsJUxiU
z2Hco``=h)(1BA+dE`42q;i7STdn-rVBMdKxJXi;~(B)8R;AvldK=JQgy)YA$O$uyU
zA!#6M^v6B{2lKFVK_{B)JV!L3+Cm|<5)9|sTe;3U*9a?m;vDEz_5Md6$W!o4&-wC1
zn4fSBjrv97_u^j$JWjwG-M(F=Ka^R~m~cS@RmSSwZfk4f&K3Z`G51mzj!<&_&m?9T
zisRVYLYtG`3LgZ0Dzoy>J&5KoC};%BWuXhgE(3K&gvs)7#(U}56F3qlnr+pk<_hg5
z|CjS$y8XqA!G@tdowX|ZbyGuz*z*tbW9eAJyOeFsSFvYfO9a-8ChMQjf|#5glzb?;
z4nFm%u5A3Iq4widkU32I@RhKG?wz|an3fNgj}I-bG~sWhJtoPmaoUXlux^TtChVy7
z^*z~6gEr(%XQi4{vXfE2{G^Zf)JuP=aWK%iBt?1!_qX#LS|>gt*fsJXyJa~=CEci^
z!};*1OG<0w?N6zTyJ#QYSnhLW<LSId$?xx+57vDDHg0y8JYFv*@M55~h)dnBoZ!b9
z?SdLF1$y`GT>ber^Kd}3l7?HTS++<qGt^^-b>A}B%hGp=WnaEk->mmB&o8c>EjTQF
zDBrOaH|fzySKv`!(sj}0kKE>oT*bw;p|x$&1dX?FB^>>am7xChUn@i6-#(POxBp`m
z_&#177zDr7`%`BJ*}LB;PrPvbzx2^ock1|fcwD9%V$}{T_MD40Rr;^5@&~22&H(Fb
z5rTudWRE(Fg$>+@8h}WA8P^n}W$G+$>XszfFkiVNayMA~LqX!*f+EB^^KTom^}Y@D
z^@LZF__hoc^KUDjENc4Ya!8@BYY0>;PPaYyk)8j3wkeGu9&*hyOuf{2W<bX$;<ZD5
zhPlz=<EOc*>z|l!S|0$x`9QeUOHgGp@YF(%ljr^qqsJi1_BA`#q)6pISdx~Pr|9bH
zdJ1~cq3izRwV-x)Zr!#ue|YHF+#C2?^3|(KIhs$mhb1K?1<-Pun+xZERERtoLhEKt
zlMj~qg>Z=T!NI|H_73L>^P~Q1`@CpG&MdLQrmbn_(KkQ8!f7VOYNGF(IL6-I{@YW<
z9lJCGhR1O31``1-9U0ATk@Um~=eCRyc*gr{vlRhzHnwFWlg7=Y^kO^8$Vfa(kv05+
zNE@FR9+7R$n3ghPJC?ENBu;<f5SA{%yvAL+>Av-#>Q|4o)kJkzP|O24F?P(p*N&BF
z>szCI=Ew4eGb<W8IwCl(Es-8S?=lM_-s)i^=^akChG$HBf0*=zC#MbO1f0U-H8-<Z
zBFZT{F~L&I+4B^NPnGh>l@ArCX5r&Iie^SKZD}{z^UktE?{r*^h8QHgV;jrGN1EoE
zc6Cax*s1OzHmW7ya*C$}XTpopY2p7c5AS|jbs{XNVA-~OW@WxtigOX>qCxI{DiLoS
zo@3WGpjga)=Gd3;whN3gxVAig8o}ec#BTO&U|dSJJR+-HGe2?b_RQTx)^NG?K;tJ<
zM>z!rYT-ojhYA@Dro0u-$+9`csD(CUpOP{={!nOGuJXCKLZ^%QNTG9`aZ7u1d-zZ)
zvrjrOZ=(9t?2l7IBW~Be#E?k4ocp|wz;BrI0_3Yk&J)@SmR-X5TzDwKyElfPF(Axc
zQHlB<K&J3^bUvY1hnui$a?7OVi4-!l4e*|LhE3H^O09-bUNt?8;@pa{i5kTM@`bG`
zDIRqc$_u(THMl6rb)a61c339ers-1Wa*4A|O`Tm@4Z%`*(?c!86SCgJV`ceki09PU
zGw6>4@l&RS8ihK<#q^b^oA)f^5x7NrG7e0j>f9F*zBlSl4Ef>Q3ek^hCNrPggpYXN
zv8<diMSl?KKGpu%Q(tiyn5du--<j`<{igIXDLL!T7(@B=q4!3)(vUndG<^QkUv2()
zbr{~E%+1Kw)@SnVih`mLXvR=g8AkkGkyaRCn_4UZ%uztQo-T{_Qu7(!Ymm}sVvJY8
zkLBdPg0GmeikwW0?5Y4VtD2?a^SXV=Ww*Dx53k6NNG`Y_0z2EeT+ShXHuzkq%ub9`
zwIa1IDLM53zqdD4Ik)Gdd0<8QFSdySca#0rifrXET{pvK(5s*>EvmgeLy<L^Hw*u*
z4V)9wZR|zME-L<(OLEl+!BO&hn*+YG#KUCFPNc$Q_>Zs~0G<Ep_iS6igN?AmhT}i$
zE0qQ=q1^$F>YG;HY{6c8{GX!R^%&w0LHsQfOIUk^&s;}9`Uz)e=UkD$Evx5GwiS8*
z;<s{FjC=E|sVJ2?^3~lvj{&<vTPZ7!(bv}pD!P|x4rE&nZ(<Cf!cZQb5_Kf`c{>mh
z^dB<+G5t(bc8~lDv5wx>se|t+Lqm;CO|R@*nw#D790*T^oz+8dH7dC|-8HWj6x=*m
zqosm6@aPbh82h^>BfsmStE;Bw<7$vN<E`DK{&8Y;S@BegV<*kIbwgU=xKrTB?bgv>
z*l)(iW`6Q|;TBr0Z~13ZYPs){5gc9FGoGm&_)n|Rvo&ivM@({tsVbiM(qv9o)6c~C
zsNpe{r`r_|XJ==7ZTfqLe2L>0s3|u*tm;*fRijF_p!|468m{viGVx5*vE^DlzGoLc
zZbqZby?|8kVnb14YN~Y0HJpB60G9K4F5tGH*Hzo9Pb=J4$qnbiy!xU(GW+*IH?MPA
zT3VagHFOJFyA>mG;)IT?sKSePWi{z)gNqMFHITg5+|9)ZJvFD<hG|%HlhgW>U!t1Z
zgR1$J`8_`v<vL)cN%NTw8q0AYjXj7pb<OShWmqn%ipMm1ob(SbPeBuQ#Y5P$wQBRD
zF<N9v`0Oxzbz5hb6<XBOlGcxA8lrc8vZ2Kp>~bzMUJUOYSTi=a&2f10829{ST9Jz8
zKIgum>QSV^h$aQ>*bq-vM5k-S(Sdh5z5FIe3*Pg79^#B2#QET<L{2YkV`fd-f@R2C
z#Z@e=3Q|&1IG<;r8PY0><w<i*#*r|)<5NJC=OBzPwRdnhkHuosC_3&fOmf3{`r+y~
z1wTuRA8gMb`c_*zYLiA0<1R>GIoKUCCHD3XBTW-HPSjWI^qOs|$6^NurJ37+#Z}5c
zLe%8D4%N5TJ_jB1Av?#dFo(l_Td<u|tHBBFJI{cP3P-{oH(nX6Hg_`w$N8l;?=LFS
zg8lwRxsy*j>9oFUTW(g#H+V`W$R!atmwS@jx9eg+MVqeNrmx>*VFK&TJ^t{Z_pf1T
zrgUD9q#+zhTk&qe4kD5dAncTpP@WyO(y0cHP&O8G|GpFZ`7aP0VN>N{NZwl8+E=0F
z#;eIH3m&_LCw4HnlCl^n`!TBPP_spsuyX;<(OF>$p}oCbn&~ro->YC)d4e?GBF!wG
zh&0NyYpba^A+~t3NPxQ?D;=p`FeUG|jpEe!cw}^+EzmVKf7vysa)XP`qn|JY=W0a-
zICaI5*6wkZ*X9rrBLjnwS!zUNIUVQNr8dQy1?A@^eCiN`Uj6;Sstrmx{%gddbi98D
z8BQ|XT@tN8h}T)*6Z4g{jdCUjaV^{R8e*%_r|YOp-53Nm85UJG!B?gEyh3|Yx<~u0
zJ*`!|yi9d^tiz?@nFW<u7bsdO3G!5Ywr8)-4|vC6r=IVXtOD5|BN^5e!PlIp^k=Kx
z9m*+DbGe4VP|}e*_mCJximug(MRN;2L3I59u!=?pda5*YaBwhlzD_d>{h<ZEUF!!c
z){-uIPp;cw>ob*%UW+}kG>F3NLgG!jjHpCybSMyaIf7^BDbA0Uda<I^SOYaK1$a=g
z!4HM|*qy?8<3Ez~x4SniXuy^XT<bdwHUM;PY`3sOS4V3GN0z9VM-EsE+t3sD+F^LT
z<vx7_YG#FWP5LjVgaxXVLR9+&H?vEu3Pd5jE+aeJ9O)geji(b*QmUE^Ovp6bQa`~O
zSIV{Yh6&J0vaqBu*ZTOmo+!;g;UM@5yO1)pH%@Z{&J#q=1b*a*Z|!VeB@yosn5qIB
z=S}zG_j2)u12Hi6&`-)2Uc*(BJoh_^g|lGtY{q_3mvNnYgdq^6S!Q*yJThmbjHV}~
znMgghO#`+6@SzdKFU1$DAwz7uYtin?#4VblE?zAC<ftDtc=j2>JCFf~t?Pd&-st!U
zYVCHX+lqu_^2_}E{9{v%K_1g>Rzc$aVm^0(nR;8h<3gT=wZ4Mq$;lOl!##x{w5v>5
zO*<|4XSl|3Dqo-q`$>_Hw6cxe&F_Nvnfr~TYeWze`sYDYDgOSx%emDo=tmbBc-QK(
zT98859rF;P4s$j<_eeY}1(CD|g&9!&a=)g_wzD@K9I6MKYHk3+*05l@4U~+<xEJL$
z=#4@;PLn>_#+6MnGPpZ^@j>E}A!^rL_VeCT*AN6>NBvNM@-#1Y+I8)M8DFBlqc+`Y
zzDJO!-#z)V$}4#Fu5Ai-XC|8akg1jLDBWNGEIQTUQV1hBDfx-?f}H9{Q()9dOd^Hp
z095&7x)TgUu1=-FHbmgr9@sAC!-El6msu`_sH>qk(OjpMPFN7|P?8-58DVO3b@vfn
zBKs6=MhK&+xw#Ll1Ic`E?$4sdkbGu2e0wU`hivPtemZ?0nexFx3yHQ|df0pyqYp@t
zemHo67`8-keY=uc7a${NrU;%0>`s>sl+-t{0^8NOQ$gq*Y*T+G*Le2z`Mo!QN8JpW
z34Ys(U-k9%y*Fl^BlLi}tOT`3wa1SMwc$B+$k?c}Sa<~=`jXWK`ueYgWmQAPMK}wY
z2Lb!j=ecW!fBawY_Nqr?_<4Bx?K=6l1&Px=7_IXIM7DJuIL+wdtA!!H2}gyzdz15i
zN}5zXA$94wEQD~?{~fvT|6RZHe<MeHx;Dq2{P<7A-gily$53;O)|Ok#wodC#G~@R#
zy2U&^%R}wSY?3&}H4%=A*AKX@DpXYpGd?Lxl7L|R!nHiqz-NLiUfxr>cQf{f@6Os<
z4KWB55qkCp9+3R6yS{y^!VvDS^|q>u6@cKLipz}I27>s(CernsKY?(S=H}*LI_KwI
z@$#4DL64=aO4i-%fAeCOri*um&)AosQy~i$3Qq~o*b@`gu(-ZHy^ynEM}4l<^`d8b
znRaz3VhD6^dVrh*8~ca!cyxb-=Q>m|97vL2w^M5l<VP$y6>TPXZo8VaY@Ci3!F%AI
z*3+oP?=g)>H&bgA)wHXs!VY^}j1vQ-%I-D$;Q9SA6MgaddS@>=JFDWWXFU?xy)oSR
zqww44&&P6pKbo(iM715V`R(WEBUS3ZMl%2X5(|hp2*`ne{w_FT9Qs7MKq9&2eHE2T
zB;L1OTZva5BHggF*FODp%LSK5i)+~UGj=Xyq9-YSqBc+r18*bT_|b#O`(1yKUv~JR
zn#V+y0_8ydKX((dQ>5IbiWPDXUhU}3MvptbqByyK{Swm>&v_xqAn~BJ+lWaQ-acN8
zRJkRy@Z_$#ULlj`8!WdQxmfcCtCy<UShvBhkKR2nTNjuWo0!<|w786YXIv9s8WLx2
z#+{3LdE38G)4&fWURzrMa{=~Zno}rOfPrO9u^zO0;^macxwh?hekwot^C}oCtw9hs
zKTS7r*?%AP9?-oVcV6ufW;}9RT7}t$wNl(!v9NDEj{EZ$U&!NI{r`gy)c;1JU~%97
z7qJ`h>y!|Wy1|-fuia<oLhG19Foc(TP42(D+}EeMK2xg7DA%%c?%6CYIjyhPz~^;e
zUy5OoCCxa}5h!_Ws^UJVr|7NK=nATPOL@WSVv9Xoz+v-jsfF{MyQ0zE_uhzfNYX$h
zQocr&D5b4k<jK}{oodrFAd2TXVrFg4ZEc-EKuok~o~!;Ozhd=b9!SO%wC7}Ib54$3
z>&$gg-0-6V`1wZ;yaF`rrZ`d88-yENs$<d^(*j~g-j}u5h-r^qWJ!8-KU3>@`0QXD
zyVpP|U*&_p$cRzqhi;WDtEx&9u|tafVn=oYhwhuZy%0T9&t>-jk9lYH|IM@fKCH}e
zZnWmdXI`4+Ibv|4rbyVTZo#(h+Rt5xcT60UD%4n>mzs;x4^;%G^*dFzwue_98!J_0
ze-wPDC!f@>xl-i+g!aMaU`7KMSBQE2?anC`RQ{%l<n0326><8Xrljo8uUz|jaByPS
zd1(C04}B5r_V#BfDdmP%)m1Mv&y9qX@C|cYd%zh%Mj~CP{l0(#B|qKn-IrlQS=os%
zg8F*@m|0!Dn$z1xZSL)2iXPxs_~3s?l{paf^j)+JtN>krHZBqM^kMm3bDGT-Iqo-j
zaX;0YU3pGzBy<V6Ejrf1NR&NL<4o;j1oO$EUC63Fro!d!M*@fbeTKTAyu4#oE~m^r
z%Wn3u`2AhqYa^*Gj^9~=s*Sga<<q96r>Ipe8FzjD#Fx=|s#8-1Ci<$&t)0({>K*s1
z2KhqGdFUR@x6SV}?vn5yk#Ki;w1J!)3QZ1?a&BD0;zC*sQa$s#YgUNNR2NS8^8PRu
zQ<)QKqtiHtFqsq|$Fxws2_Th@`N)TPj^*`St>RQSJK^8B($DW()$F$^1&gWhY)p=O
z+|2a7WZ9gYxc>SrU;gWTWoX-){Jz;GCD-t8GdVZWoMJ)hqT65EqjOfjDdC*T;CDEo
z@+Ib{8AIRi!@DBfe;Fum9{2ZjzgLZwu&fCWb1uHs_Z%lWDYe+G4u<NsCc@hdbA8M&
z!}2vhJ<Q0KSNzx)EskkQxS%-soH0DD!Wo|%GGu&)NUQTibHHdxY9(miOMyy<H+&PT
zw~Abk))iBcI+#Fhe!cm|@0r^;r<A+zoXZ}=v+~B~Y%e8k)pxNLIQ;L))V@jdusy;i
z;(ycxtK>BBXn5T;8@!<D_ViK0R{10Y<-H$rvU{^zd?<&Ce*>rVwNaz!ZZA(|7F{YC
zD-#I<@gHxH&xdY$3bj{p`JUaI+^)kR6yNz2E7G}jnQFiNzb_NGtzBg_(Qi)rUhj`@
zw>LE{b6AO(@<bW`hZQ1jP4d^jO<K=3?p4ca`Q;~4b`I2d-q5s>i&*QUxW1IU--AO+
z`B$#_jPWU&eako%@^uGybOw;=O1YACjUa(^-d}rF!1?75_y;(PACJV?ro;f}er;fs
ztluFzePbr?4-|v|5of86)m4Uj{1)X~U+g;JuKaC(hkK0(?{DFaiT^6k2=Ool_w&_9
zX)j|cuCM!(|6R7#bS08V1tYV^L#mh4uxq+ha&inbH79dnk%pO*zmUdMKE3k;g<@zG
zRZPD1IVd@*oKMK)#g~;2Rb0!k43`I6i(RS>!&HX4PlbHp*$bX8y5K8zKqNOfo@f|E
z-YhLK1Vw4%?;?&dgB0h}SMe%+NtdljqdaGdc_$nw%t$uXxHQr1J^YRq$#>v8JyJwt
z&C;F2lK;}v@<gD#1Nh-b9o|EqGadL4FKM1X>ht~S#hW)fBFLM&+IF|zs`HqrxVN1e
zg~wb@Gkm>2Xm9U-jFibG)@8c)Ux*C<nHCB}y8Ml1u!`~K8wt{{kkM3m=u+U;mz`TY
zV?Y!X-!9d*_~ch{uz1Jb%A-fnT5D=ZJ22z5ybP|ub6W9!kr}c)tJ>jo4ae^*Kh$WI
z{4Wyu8#IjbuUM0zEmC!&H$r_n4sCwLNtlog2b(KA{B>4hsw(;r;rPglE{}MPZH<g9
zaeb3^);2#tu1&-`s~Wgq1l0fQflH;N$WG+X%FYx*tO!$@G_&-$ANJ0Tw(h*~c0LPc
zu!=Y5InA_=e59#~`a!nl{PoFYUVn7)9W6);G5gB(YkFkkquTzm3_XOq3ctXg554_f
zrc^pYrn~jnWQhtg2njd9%=|1+bQ6>v;&5>!NH+aR{_@r$KWO?qtT%OTZjE7%_bCF6
z|2w5{F4<=lX~kLnw@%$tEj=$R0;!>inwzlI(az0b@zmnoT4<||k$g1v1c<?>El`TU
z4kft~o)54WS*p&SnxVh6s1dJ}i@kzmN{y9(H}YjC?}CAhR)istg`}hxtty`7TkbC3
zVk&AledoOL#4zmIS<os4o4W{YS*i|&%QjgzS8fOr2TN32t0E@`<};zol;^LTzDr^d
zV|2Lcq!zjzC)@x=MTfT_98Ke4{Yu4ef&KJd7Im_~4#-gRAi+?`Pin8r!NXee#_JCb
z{V4Ih)g0yw?z({rcG1`4L3iu^YA+Q)uO@VOHr$K2-M;@+2%n1Et*W~if<=YFMgRnH
zFJ2f;t(OkGCSr#45u?*tle;&D>6+i3c9FVkfP((mo4!k~qs(5Xt-Wmp%qyx6j*D9q
zDi@I`G)y-@N(-LelTG1JGJQ3yfLiJcU56ZM4CHO}P6uqiFloQA3$^~swni__4h&mo
zX_{_rH;?@$G9FbpKkk?b$8gZj`w%jJs<LXVv@SImM>@j>DfXAR_eHMQ{v1hi)5@D>
z3(-8^<G@D}=e$DS;3^-;@ZLY(lt82Wl1#%shd=4$?qsdlbE@9gLs;MiMSzh3G%96M
z*ZUDYWt#VrEXagHFS``q1+S-sN4%D2Q(x*=h9y#31l!cYE1`Ff|3Y>aGkBiq1_wM)
zCK{w6=%Ld!*Q{0pcGJk%mPgZL8`D^9PF%*AyJ6noK)`uHBqZTez-s`(2LydSidDYd
zr*+vcZcQrWtA6Wrd4rGfM0#oK2x5tQPtwkC&k9_o)P6#=0U}fOK+9`nqs@7Xp9C73
z_q>Eff~5?fk*THW5AwwV2tnBWyVqgw*7O*$HOhy$p)7jG9qiiIw{HIN&LH^UySlEi
zP+m-V;H7wZNVTG5mKCnBpJ1wc)20i>j$ZrY=OzM1_Lfge|AoZ4_jJSFfp*=y|LW-k
zo)mj~#ct;b^jSzBJZmwz<T0s5;o(taV@@8|bHT{$Lxu?<R?w<E&?f>cP7x-xDsoq=
zuG!*ad~-Kqd7dL%0m*zIH_FGs%$SP1$CLHsC9ERc&a%hY1<pg-{D*UL_F$ZtF<--O
z|BiP8A^#2};-65;y1UEwT?6yBBlm_ip@+<$I?aE(fA5B}zzQtCV|j{#)c2<Y4TO2G
z^j{zV;<Hmyz**zcx*sHm_q9F@@sYwDHlO<tVDf~QWd(X2aS}E4VXn)(NFj)^u&J;H
z_{ie^@dXy~I{-hc-Blq<-y(k-Bs{Q#-v?v^*#45roBz#!5i4P#b?Fk40p3G>^ugwZ
zpXu_z&(45|awv8+BlJYn5Um@R>HPyv;p^RMA7#NTK1V>GfFv%MT+)CzM3?VQK+vtu
zoX^;s8JoBt+3262n!_twKaHA|j)O=J0SQxImtr=(-wH`MA?yOou;e-DZ@$(H<<eP`
zV+H+AzL8sujDpackRe65=0RJ!Yv01k=3u7nM$@tp0oXIi{OzVfeuCSAx22Kxm?%--
zi<32Vk%jee5xqDUs?Iwp+bL{n8V(vZZz_%tLuj&X?gI-&2UKQE#bOBU128nv9z2E|
zIr-Rpz52){%R?V^m-W6`F@lV3U_C|quC^14fLk2&nVV~)J=we$V~P9y_EgBy;fEKS
z5;|O&Qi;;9;L9-y3uhJ`xKd7C%?79xUb+WkS#>M}zO6{Sap6;H8Sq-LNLvpQ#L;&q
z+UNn%GouT1HMlZ&adC3!E-BnhJcbZth0pB2=xbc7*m$eX!XOsWN9MxAmh;_R-oF=Q
z77{`j#CPD-_wS~?@e>Ev%ie)q{rOKQV#`MKxyP6t`Qqi^i9l{A29{;4m$dbjk>l0p
z;9!;4cjWen{lO)emTb7`>oZOQV?;d6<G244X}*45M6xJOAU@k%l^gr!wsYO$oIin^
zOV`xu1go)6uJ7JsDx(ZaC=7HZp@$TOGrmf0f4qoxFfCaRPpt)8%_uyaAihFmG8NR!
zT&;zP;=!iai*ORXee?qd7WI|y5-r&DPswYZVF*CJ!m4&xV6SjDXVT4P!88vNXGj@_
z!#SM-05Q5`cC3P}ziCo?Y(D)FoY3Tb_!TnZ2t7}PuGvg3+*M)>!o?@usi^@&Kw=R>
z=&YU(ihJFkM%}qJ5co%Tn3jOr^QrA9l*b%4o8O5Z7xb&tuUAqi;`PG!BM$%b{SXMM
z6$D9V<g!YANr39$Kj*@Z?Z=F>#8h?vs6<|H$R^*iroFuCcJr`?V<xD3F%Bjlj%wqF
zn-@;KWCYePW_z=vV~h%~0_&l+26UR*LOhCz_s;zjg;_3u4jy<7B6j<}gPj>Aj%*5W
z0REU9CBESIv3h=n-{;-}F1r;(iy#gLF`Yk}eaku!bJ1dzuc1M3W{;*CGEe?UV7+7T
z26NCs7vYQeLLr=%q!o+otcIHR`~RHJW3XLu!_O4hx^UCOqpZdtIFl}hDQqeCT6hQv
zH`NrQ1vr_pGTaVKCKxmyKG*>pb8qo|e59~{si_QNnB7`p)dVrtQJ@W=<AimwNf(4c
zB)|!KOy{{O&L!;nLr2lqVW$q-EZDJOpuk_!h;YuTPM^n4g{;u?4cqH;l#)N2)8R$A
zzi15d6u^cQMFY_m-)3ne_9!bBZiw%_M4Z2ZbU6wQ^sm3W`u6;7vG2JK#Zt%?u{C;)
zU&sXTxB=E@`Z%(=(Luc5Rf-Hw1tR+fvO4<5eODt^0u2F+A0MwEAtw97dkJSyG;7O0
zzz9wh0=}~Byi)A0N*R#o2fSw3-UAUet7Lf!<c2ngX%i5K#%L{wl7uTu*QEO+#}|25
zXib>Ip#G7sf;50t&-cIJYXx|?^6~%(3m{VNrs`%qjqp_&{hnFo+?&l$5C_&OcKVdJ
zu!H<tOu=P2f<ZC^G$fa+7ReZ)y87?_w|7h~)4Jx;<t-xYTa?*N5=kqX_A<9wINW@*
zo@K+QL1=N^+s^_Ziw|_~_Qf56?-DQ9no9d)vZ<e{f3w65d79^6ySpt&+aK}<#t|TG
zH(@u+tlaMMQ#nXH?TFmwMI&$F7ctJEzf#GLFcZPEN?GtIkj}`%XaD)c7a-5Jbv_gZ
z+w-wB|CW<`o~nss>N^Uv`!6o6PlE7bLoJ3XQ%Vr)2;;KTW|=c7##uT2>;K%ac1=3h
zKlfsPwTKjcAnaSLD}T0S0j1-M1^ySgHZ`>kHmWOhRdfxcUt_v!K-&I^oFe2~iI_^}
z@Yn&P;=eKDG(H1<SsvCx=zQTF2w?a89S|MYZtfX>a`5|q5eCne`ej?Uj3c@LpGS*;
z{CV)5a{37izvl4+F7zv05yCzS=Gi5zL@&geh5k4dV3(Wz1JWYGvD4d#(1QdMSp6HZ
z>t!B*^hx~BXEuZH;rn-I&S*8LO6~2qMxYv5Q?%?%dvoRGA;t6FL=)1^XU|AOLC%89
zfbOLhqy4^*ch{CY&jvz)5Y`z&glpdb{4^Q`cQa{cufBAEKv!RiQN^_Wv#qh)%0&As
zY8dPlVuLeYtz_zg-DqmM;il<#8<TgDz@La!Oj14C!>p_zNYGZy9Lal2Nmbi;&1cHh
zg1<-Q5Ky<C{<9wsGz80k`D=5x%JKfrIGe@<5Fp$OZKwbSY<%T=d_>kHhUHTw!s>aU
z>HN()ek1El{!K9TZPQq)<v-~+YrCdNDl0F*woP8rsorblBgc)tAM^A5G|zyv6kMi`
zMX~)$qgUoi70Q-Rj|i}`pU()Yd8d<E$Pfljh!MjG0o5}rRePVJKgTkh^aCjdScy&8
zIaP9f<4d&p)iWLQa`KLyj16mVp)};Qn5RE|Gxr50sROWu4UL7_-61n#ioa%j@+^U8
zkR4Sv4Wy9iutrBMYmcUw>&d#nxXS#gZHz%&kRb7j%Yen^YhI@yaGFkTF;2qob}St8
z7ccMRjFw7^$Z_3O4=by3!I8$qyT-Zp<Q#~rEnCoVwL(BuP7nwc!Vr+jUD?lK_J&6)
zZ;#-7&6=2<6>_no<lMUOm2WGGHTAFe{EEDSN$0NHoK>;`RTD!BJ#&tfi<|9Q;rj|U
zQ;c4iAK%i7)`01K=*#^q9*Ku9HV7!Xci|ifwC+7~6=+=nY6c6Lm$oT|rlxpgAHXMt
zTM-ZDKk!kwJ^!&Ido);@@(f(k^IT)c{JAxKtyAq?`hmrqkniJn8oU}m;_~N^b4qxs
z+@r#Bs}jMFsj*tk33g)cx52~~VdBTXzx8V5`w7-$h&>U!a1|d)e;xh%m$B}ATnbBZ
zH?~0j+!p+qzyc#MRI7i)M^)zwv2hQ+Hogt0L^poa=(_ac?e_Dpot=W``^zk9q9NUd
zY@*?h5STn;-c47^ai1560=8hN&FB)|0R<vCO`G&w@DObw(-BH3p0hFb>CF{M1NwhO
zQoZi9b~c%GF43m(JaH^w*9qisQMv=fBIy=oHFtDKwjgdjXxS7i2$Or5bw9E0%9k&n
ze#nF~dWEA-Uj`Qez?7WV-@Z{?XMKEbe!Gn#KUmeYsAC1@aiUFQ#Ug5@;(7grvnonf
zIz{PYU&YHoFh;jj=P8rfG|G76B^~NVYdSsGcI24|?@7*p@1Z~Gv5hCA@9spw-rX1o
zPqaDm4`_+84cn$GH>kb5!Tg9UB@r`!IGJh)xQ^V$8W<Nu+ZDv$^%J2efI!du+FMPv
z%Z2bQh`JbaCJ3@t`{*|i6tMDk@G%TEFPqqnR9?p&R<<%W;ouLj{SVKMKC)mGI<US;
zGrT$X1z(9cgJ;kH#vf6cS}4sZ%2F>yv__~%lj7HLaf1jA{#Y3|E`~KugZN{GRqk)9
zme)Mi#@<$P+g*aVpvo<sG9sg=0OcEmux|Qbagk|5h*d%Jx_A0i7~@7D$msmFsf9K<
zUrxf4`l=$c$j@tmuPR39#a<)dITP_5o$7+oWNhkfh_NtiqTjH4X}k8G4)oDXi_B6^
zBaQhVFk;`ioaP}N$hmGoxY0ZA&zuZr4(7QYbeW%}aWe83%`o44TNFP%hmap}4~9MW
zPdUq}C^*<&<Vjum^z98`oGIn#uwLtgh;SxlZ6EubEJ869Dt4yHp;SP*9sJ3LzDVrt
z?jwX$a~^i@REw7j1-_}tfnLCBb?lt)^!8!%6$r=<_Zultf}Lwf?<!`Vps)_uaTd%Y
z^J6U>mActhI5;nnBQuqWRwIY)p4-vcx7!P|K;F0pR&(a()*v6IKm}ibPBxEfLI9Db
zl3$H|LZ^+%PoHAScTH7u8i%MptY>OB%Ip0ndbNs!1#9NdrE;d-l|Bpbe%c^OJWG(K
z*mBw4^k&_gyF1^4<y&@Q0wi>Qh^^{;0}+_eXRzFYTy{<+$&Q)x@X7QYJ$1+Y`QJ2B
zy$OUDGOKyPhOGeZ8*Yt~VL!)4QIparwHa5)?5=5tjVP{-JPOzC1>iv<QEXs5*ZX;-
zKv_8ecZNW^Lnga1qd*IOEaU%WfMfY(T1D8I6slMbUO)^oo29lb%yme?ZT0|)HPl3S
zS|Yc+qRVT1SSJ|EtSgJ^AG_(VDdq*B;rFuCk+BINC=?Kq=C?w*VxQqdvqQV~P=AK=
zPC#C0R*f?`6mVNKzDij+_F~Pw4G_w#jeT-5vxxlTjq=mLJf@h>mCgH*35i_c`JW>X
zRR&W>;g=R~P3L|D?2PIf)CG@FQEj&Etq1rShRpdnRg!=4WDmz@4<sST9P>XGGT(a8
zjx$qn`Ql_euIsgZw|j4O0bPo$I#w!nfGn!$bP{oE-B&ZvmtY9e-6Av`tw$#LXGJtu
z4S)Pcbt++(*RlE-7OwNzrknKhho*3vmf&Z<ETTT)(405Pd&W#;c?=nGymRT+oWio^
z=APFEc-MHMImjAmGry5<yPgUcp?Id9>Qs5)E2%z5F!6yYU-E4Z7;bd!fe55?wNP~j
zt@RO5PNwwV<z0L}N9?>awBjGpJDoJzWVgtAa*$0CCO`2dU{r(37#?QgS-Fk_nRLiP
zxU8~A*&-B&&OEdp*~XBqQkh$8a%*f8CI|0F#g7e(`k$C?)S4ofX@mV^PpodJ{iukf
zZq#g3`#cFhuiy}E1WYzR;!e`ZWYGbs50{LKF!0`(4yo&<IEsrgdp+TpbaSpKgS2wE
zzp)Gw^lj5Rq8=Y8Q5ch)Ci-^E);jQl+zk`FEvK?rZj=IePhLe9Bw0$N%e0SvD7^F)
z;)5u2BSI;%4tetuLga=yo!C$_P2~4Nm}Vcj#p5m>yw5NdTg$fMsHc(r-j(16FeFAB
z@{&K@vrTIqklhFN3pSThAJnj?jqRQ|u_bWivjDB;*8}0QzJ<_2V+N<sNNA*v<<02Z
zHg^D!+#D*=C-U8pd%|91>`yBTQ71W0=Pij&r;9oFS1i{K{WYb)eh%w-B`&Nsk~SyR
zv9Jkxd%!$=>Uz-b9AUo6q`1H&)g8%Md;DOK*wFMxu&-Z96?PThybTuSYR|Jp=F{)P
z3TQc_FE#`m1ci~Dwi)Y2pgs92WIUIhi35q1kG(>35cmoK8LtrRU*X}oZUfb~+9QIp
zlwk{o`ft6kqxbzE?Vb5o)7RF<L0fILY6le+1*=hR9RNi^2$NEaDOG5zwJMVWqE$d4
zfQ+HoinR(hs5mewTAWc-rU+3{K@buJWC(*5kSP$Ehd_9roe<jlu66%_ckmb2(uD7D
z&e>=0=lSeIJEDq94tsJATVuhCn8F;ksiifNpVm)R%BvbrKoikcJsQ(AyZXm{t<!ju
z)K6Ufsvc5O`R%Iek_%c8;6qI%Z#w#Pen8CZsB!}8HiT*^)MF?ju=xZ(U;KSx?i}B0
zy<KZQYE2mu@$30PO&9LBKgEg9zZaUNj%3Cmp&zc$b-t@J&$rh~T8-V{#@-kHd)*4O
z)f`=+&bWw>Q~epASj^lR+jrh1SdgDIm?Au@j+fhUEs3tt_;S+gL7mvD+D@_i`AjdZ
zBjtB?w)rgil84GMZ7<L3aJ<*5x0w9CGsByV-7jQpthjdbJ@sLMnRj|(Y$NLc86Hsr
zC*SSA`4ll@_+GiYT*J@!7i*XuG=Xe+uQnDXmQP}i397jzeXoXduk#H}yku?Hjr$_Z
zSV%7h?xtLz)Z~n7(Czsb_si7yLY?6s6q@cyH;C5eoU;AjrkZU%Z6=SezV?UP_ClS{
z-`Yc|TZ9^pY=yxnX%B!p{KsOQA<v{zvN`k+5O`wFNOFOCXnokvK5$H$+UE^JWb_Gm
zJ~8Gi<H7DvA_D?-zOV6hhX3U@M^yEzIjLGMHJ2u-J5=r-ipg2ep8Tq-7}AT2C`_Xx
zRwL8Hc1rl3;iDDnQCj49Ptw$1f~qp7F$!KiU(|~*8dM!~-b958RP9m%O*)?^#TFFt
z{q>WwD$)!RHErxUwNv`5A2B;0ybOzEcm#+<9qE3Yb6fPRmyAe>@nb$%q06}6Qz4Od
z`%`XN-UAcwwRVIK78U3pqv<7z#IiFaMzf}L;-i2a<sH-PzB2AAR!YP<IlgMqjn_NJ
z3}p>Y$mD&T3(qTSiSS*cleKt-Q0Q0rxLSK&YJ}JB-dCwIzliG6$ik^mIbOQdkY2jq
z?b6H3;pP@njwBE4Qd@~$*=NJjh&exEa5rKRb#%g^X>z#n?E7KqX1}5CQbcxE$3ZEl
zSf{l73<v)**m-S|ORuqi7t=Gllz-~%!Rk%B+~g6<9Nnsp>&hb?d?h!KWd3X0su)OQ
z5!3sup|mG!tD5=My^z};#(xIAjMRSr<X%`w8<0SdCDhH*O-T1^$%=DUBSnaki?3!;
z5mDIx=#1T?vB*mEo~}pmVnI+$Di)qg7*l<qc8ZG#)m+tXgJab;E3f*-KD>F?tT)cM
zV^@}M&TyWl>|I!pacwNG{gk9zy3%)NSEFy;d`)B1#KQh>z5=K>eWcQ~0gE@|Q)Ild
zi5*w%x8ABciC?K2N0?T0eo~fus-)$<FbIjcp<CfIlYwbWrU52_U2q%t3(Bg<AQkYe
z#Q8e{t(iW=K)57)k)h6P2fUD%A~5oDkE`yjZZ^K)<j{JvlVzRbBEHcRPa5nt_xsvr
z{Y?UxU|xQhQqr!BnDs$54!tei8Fy+#*SsDFOcC7HJiS#34gLyw(Y_c9Fh3M~>OlC~
z=O*1qzC63WwVWEXZEVHb27x5?#T@wM$s#A8*-MiXA(?eIrhR5M_%PYr!q-WwEmQI^
zxix#rIiZeVm-Vq(-6_efNU_L@&or$${K=DW3&K9Q3^E;#_7#~GTtB0=6D#vhYmICv
z-E1eve$e}e!Hz5UWdrI#TXVci1MdkN<WoRJ_!+9#FM_Hz1S8i9=nhO>YReGn=8CPN
zj=#NOqP}^VXWilC*Izc={)`56%`|B4m5GH@V}|Wff)0!Je9raN*k@kegVgJJRAIku
zQZ$c$FXf*1(Q~JJWC{89d!`sLp1nUj6g?PNUW>FN<9c8HRoq9*+9*XEstp=W51q)`
zt5pN1d4bu${_-rH7_T2>Z}7`%5<1B$rot;Zlb7ALwN3)xJ$C6~we83_*G36-7S8rx
zM`qORp`_u8<kE&&+qT^)DkY;RS@<a2Ny{kW+$vd`Q%_UuWRp4*D9U^f1AW;|E6c;x
zFN<s}7gW5<X`fkg>7}+AkCfE;nntFY{lfP2*ZkBE6+JR47N;PRauI~YAIxKj)XupI
z2KqGO8qkxIx!3jqw(}L_x+E2+xmXot#a)aLTQ!7!{UUPTnuZYccia%wzv&4_p?Ybr
z^j-GCwyv`I5vOfaG9fvJAAcBLyAT@Y(U$snfrmrTJ<FVK=c!f=%QOn6&CV;2L3%ik
z@^+IFyR^TetZ(EsuM{*KGZ^q$qS$NAUl4LDjI-~n)ww8r1SbGlulL)^Od|n-22q_U
z7ze|fo%0T$w5^H_c%l<0z9aQW1v4QXoOSXikLit3$dxtXI5~6IB)5dmhZd2K<bjzY
z;)Ss_43<IuYn`$7cB&CaO>_83o<?SpR!vS}tvsg%8Y123@d+j?hPp5J!yHM8VMX?&
zQrrD34SP>(?aX)l21+p80?OVW(Ou#x+B9AB>4sL4KmE7JoBZRFD}+tX<iEp`01Lmb
zV6}?~#BFMRXUg5ZEuUsIUO9O!wypg()8|V3wPgvtIuljyMocS@DO~*v$}1%IKSfE(
z_n&x-GzsjBWV!ne54BQXws5s%k*Ip(X1=I>Vb!r+O@+CC%wO)&7M&bKAx)#C8wtZ1
zqoK#7@*o}7Gnp{db&~8mhA3MzbJ?0dO)B^GKT)eoG#d!B^?LH;k-~C$5Dy$EGrn_7
z3#C|1n<X)7`#iR#UCsw|V3fR93Zbc@sh_knxFX$s12LTaeAK6^{nz@w_Liv$v_-Nc
z*SOSt6?5OX8pAj<J+NG5_1-Xxfq-0bq5)dc(jh$edrJ)e&Su*nyVRJq6_N(>t83ro
zyP5@kSKfnBZh+S*?l7UM@>zW;a=M|+*KZbg{AA%2RZ9iFj;O6E?Wl=2AgF~+1LeJ^
zoXm7L$$w!YI{nxbIE_;KCF@c8+Zkyh_*qEVg~ZM5{XB!`(C#bqmL=CO_UtbyJvlTX
z6Ilf*J0$luuiV392bY~G<fmD4k@}s%9GEk_U9ui->yi~@wNZTnS&;XO3T2IS-<O!#
zU2`&Y#Cg}P1Mk)ftb)60lRKja4C31E1)QY-k+K;DQm6LdPvs`}IGQ2}xYg!QW1BYk
z+Rf5V>pN1pztqGobS`ELI8#^8wtls!_ZPw<f7N=Abf~>jaDAdZf{RtC5S-y4(sB|#
zIeol3*(vR>Lmq)k;|BXIJs+qhAo3^zUZx_K+1e@Y%nU9pteyMx)vK;ufB0-B2ahPy
zEjDkoB8<=KZD3w<;syQTo8v?Y4HSJwc@~bb4|T^j;9={%h3JwwIpXF4h~0~}4OX{T
zvXVXfvomE&!nkk(_3<)zwR#m0tcnUNWi3O9*<Wnh<UJFr(eUh~^o}<gzA9(%3Yb~*
zW0>>A?#@qQVK)}lOVcPg1T+r@eM9E?Dk?lM1d^V?!~#P@9e#%>S@Igwz}MCTo<4KP
zJ^}@T+OVj>ztz5XW56-m27;O^lMTX+Ix-ELb9)!EVuRf6=pk}`7)-w9s*v(;X|b^!
z%RKn0TIE^sygT}R0oOWL9j+cIkz)Ti<yM0vJ*vX`oL9#No;KUwI1AvD5A%YfWen#N
zYsn&{KTxsDTN_eg^NMt{kqdd2wx$x}Ws+4`I7T1kwJ1SiVND4HbEujvGYxKvzOx*f
z+s0$FN)o)LAYY@RdP!Q(5qF20EvG4_r`PffE^REi)56xMPfo%l@(nx{W9izJitX?C
z#H_BGj@t3V=Y>X!q4fVcY}}z==5VGBRqWvlP)haY`E3Jn28+oPp=6HKzh$!omJJn0
zXH#VXRzpz^vi0R}x*!F~>6WYo!>36tO>H1gj!;9R=}B6%EAF(bQ-NhMr7{vKM_Rs4
zBU9&*0Ht7r#N+YdPh2D|yX|;I{l@dZ>T0_%6iz8cxyezDp>VYQNgH}GQ#<asMAU<h
z<{7t)?A3uJp20BcxmtLqF#25F(tzuGYj!6F{+T1Gi4^o6E!yzRVW^(hi7&c<+VK5w
zITe1uCtK5^Y9p9`ikVqFK}%yocrM)*jH$Mlx3^mo84AJduE_n17=Bp5z|6Knw}}$*
zfkT;d<|@W{hIo__jW?r!N4A`M=I)0YLyv;y?j8}RS>J&!Nz#tjU+Lk%Zfnx1DrYi-
z4-pF&tof}FE!ipF?@b?Q4n_gCQ<UNs<bN#l1&ZQ3)`s(0o;4=EU0aVUXc))KLegV0
z?+t-9EsCGCf?O=Y^!4x09I$i<KD2fQ1cW%>g=Mm;>-QxM;Z-xo6}c+DDRhu;XAa@0
z&KXEXILM*EpP?jnn*9`pqW!3C$u%Eq@syVXFB|J3kxb8em4jup6|(>mG!-gl$E_%Y
zy5%5d{=f*ZxWHfG@Hu{b4ypj-88!@K*bSq;<8gfUyYQh0#f)bNbFh|YJSGGRn*f6a
z_~86aUBwR#SPjwAr9v99fm^AlVqv|^cuep;;s`|`3JXe!Q};Ehhl`X0BW5tlA&=sM
z<8D)`0nuY6D;c|koLf+wk`bc17C+tfm6qvQM*8r>up_vQI!dnPpo8s!rc$NP<7f`2
zC6@#as5HymZkh;73ynIv7|)Pm67-_<OsU=ABf}BblF=`lqWLepgX8KL1jvw)jC7d@
zJc%L^dw`~h2gljir{vFeTYHjuoK&1>{q+T_5wa(iHt@5nf}`<Y{F(R}1P!v-yA`jd
z5#05mC3dqyWb8L#W~aZ58o_j8Nl>b|ZIx}{o(5<?WVJh7LWKv84Rg_`>#BvT_Y_>?
zpOqWO7+Kg#y14~s{dRC$hu_LylhUAFh>z;;?2^&K=GNuyQM*V80ykv!bwDt3Z+Z|0
zjM6uczkt%bE(TT+aS^bN(2D@yI%IVlIjvl0kTy%cRHRh5CgOehQ4<8YfsFK^7jNXR
zbAjr?GD!I&m<p*)O5b}C(nDwInA-d4UUWu6up3s$bQoTT3kDurMlvEyd%jdEYa0Q<
z^d%I%jgBS@1XJZ^+JMoG*FT$fLjABNkmU+TA!^F4T^UgY)J%ab5vkuEuj*eN?g>BW
z`VD!I0Kzt7nUBI-b;LRFj^i=N{nbki7%Wm8uVrBl;HHaFiky91rs!M=iGhDej+a?#
z^<8+En0&Oof>rovO;I(6&2{dtRa(<k_^3N!RP&4XQ61GgXmvDB#eb7D_cuUEyLVOE
zDpw=5T>0$CvB@5}#c4mO_?Hkp#Atct@wbbD%!x<5$kT?miSS)<Ud6%3P+z~{UbpRL
zkG>(ey=BM#9eL?5V<pxh<C#jnELkXAXM{&Jr7w#!LP9i1;i9e;yw?RRN*f3wnzdS0
z97%8k7t1oTO-C_HW5B{pfp0p`z@D>SK7YB=Q%ef23!-ms8+)r1Nx-X5P7D-y45yEd
zFenM}dGLs_poWP0D94sQQ9ElMF{;?2Ko9Avl+0#3axa2i8+C(mqK~7_h<5iyltUmG
zMeuNEg7Rjj4>q^FrygSB+4#AH#l25aL20i8+PD=(i3lN1VH#;#^2tmF$NaKe#8Z9x
zv#KMCVg?J{KTAg~stzrWEOcV7RZ~5<ny4-qt8!Ds0b!@e+QcwNv-fAHUeoO6+5C(<
zc7+~`d7{lp8-2z@C~}fVaA68;<uW`dQ8r#ccs!9$lYMeTd)j3cl!41@A6qX_p3PGB
z2fq3Tq*!WoXyd#)pL}ytD|O<WJvjOK`LO%Mgmk!a^q0#i{Bm<ud5b|ZY?NPP6hk6g
z2c~8<Y7}Dgl+6+-`kG%zk<QtA)jyH<PNk}Jo$oQv4(hG^yiDOLzO&5!U0dZ)C|MB5
zJLppw(T10x^!WX)W{D#x;R*wf0?J+QdtlAYQs)2>IcV#BrMNa;aroB*8^XRYhrWhV
zLCH8Z9rbJldV=#0di$Tvk9ga&_V?elr!|g;4O-T^OM!KToEI-e3(5&~KtQypB*w2p
z7|-%HS*s~eOETwwhK@zWpZ|7%P5he7?i(C?Kq_Xt-K)2<6)RNUzqqIv-seIVYQ}Ux
zR;DS)2LEX_+x#UDjbnt?@?I?E7jcr(qGEX)%ow3SP9P|@|M(ps0#t<9MH@d2F~zI7
zH|oM;8{K$IzBh7)N>5=94&<Wajyou=@m1V&3V^E#K9~TJ3}p4hTg}Is{)Ri-*2`ve
z$xi)w++{}+<QUJ;dVmEVA2FEUlBC6=+Wg-?)w;AXE~u?vex=VAZ(hKfJVP&I6pp|$
z+jy(F`8zJGFVs-j>Kexq@xq<mv6-_)3Fb}%+PCOO4AfOCk;Nn({@^)mss39q>%+~W
zXo@Q~GxN2G3lj{;qh$z8Q*RQkmIB|8@eH8}`>Ol_iIy<`RSKg;ixvB0`c?Ud<P;Wq
zXa2q-0^Fj?&pF*ua%%5S+G@b5y@XsrMFA`PwC4fkeoMH@<$cQic4Wi%XGv=sP_E*i
zm5BkJVdSWC8tV&q67qYzr_4IILhHECv2EZ@EADUJhZwtkz<<_pv7YB)>EW%ES>kU{
zJC|78-4ZjU^QW>1!}*a4Gd$)1$Ru1xoS^l?O&HcUZZ!4r6!ojQAz<sd6*(I!A=u)Q
z(#AGUAGpe5e*fPg7@O3Lxf=%Gjh7EPITCo<%q~>S^0p^KSX`q|aT`w&LK&T$FHd*-
zD~2w7sf8b8C8y6RM;LuI^n=Z1Z;Rr-`RBt}FnwJ6kY)Ux2jJkBvAIe*jJ-SL=XJiy
zOak*!^{pIJLtoSi1y<ci4FETpBPogoNIKP>zzg(<`N>%E!2AV_Su`5yvM8Br9LWuZ
zV+jVQlt7Mhvj^X(U$!Ni4}K7Vvqea_m9cT$d${qC(KIZuJ=ChG;?)mq)`Jbk>CI<I
z^5nKw%|z73zbO_DTE54AWYZA%*K?@Qv|SLgz&12DKyvW5Wup5xTq4{M7?t#xBU(s9
zRDYrk|83sykqq*WQC(we7E{|5X#t>=Tu>pAqB%+z#?#u?M@dDP4y(gKV5%dZBOmr9
zPzFGm0E03J^_3$vACPg!5T1B(gZI(cw8rFXm`>}64R(fT&EgVv3AaQEiBYSqV+e(}
zEZ_V|3S>2$*Y-sQW5&z2w3b-fC%DcJ?`@{wJ9<wb9v{rrMRK+UZi^iDFNBV*gD-J?
zKGLJ-mXjq)Oc6kt?mD?!C#NEj%hmOFtK+>KI#Ia&5EbD{^l02&Wk=};@x9`-%l?3z
z@AAS-UtuBA(^7%^<;by+@u}3if?+yE(gMAQFE6VOd<Rx8T3;e>GvK1`oZz%jF<$<^
z{qdP@E-IBJ27#S><joUxot-+m!D9v<;N}Iu;}&3MApNTc<NSf1;#*zw=FD>ZShRoe
z7yUjVlZN)lwWOBDP%<0>Yp>?x(22v!+<C@EyvyUFWyRD%Q~9nS$pvG*HfqzisI0ae
z-I+?FQR$lirp$D~v%mXZ71uckY)m&d26eRJm4f2k`O0;JHDca{{Hrq}mIN5<Z5TXp
zdv=f*udburI_501EkjElvRxyn;{jBPE54yKal8qdL+ICR)1RPqVdG}ZBc+CzSj?{l
zEJ}#_>z+qUE_a`VnbdJi-8~Otket^$HTb&lbE)ybci0%oWe%6vQ*?QT@-zC1gsIry
zf2;ZjHkp>tgYCs|_;*)A!~q7%FRR;#8S*iOPa3tHc{1d(ft}4sKZrv;9Y~Gq9|%=v
zPQQY-10(^<P2(e|QUiP)I^v8I7@S-x>eb{_E<^u*#hM%r@Xh=rgOYj$>h;pT7V272
zuOcSIYtr?K{Z?}zmk_G*t2U!I46AFju})?pr0&afsAvkJL%x4{3kmFxh+%&%pX7BY
zy$MA}^1qC-`lx*t$wOYF4G=9c!&d}m5%{raw?0Xf=bV~jK9Gj;P#LhD<xj5iFSIXy
z^eu&N7-RX<PXO(Y6a)`kT&=cuqyuV8&+k&|SE2yq^!PFH5j5N+jr?`aLC^n!nzDnX
z-PYs2?5ul)Uw?f~9Vi-?rfjnUlz;Aml?Z(VFm@J>olL;mV0qlJ=fTp<pa|1Mq<G~i
zZrg~Q0^PV1halu<eb!o$vwb$Fa{Mpb6t_769UK<a9zZ2$-gNGGt6S%JbF&LGz7?0T
zsCnJ6_U`vbv^fuWwKoH(#en5s-G3pdj!J;e%1#}2)9G7!h;Agp*!3j&_4J2tVDOgX
zw!T@__3`H;(R>2VB4V%zXe#AMPbE7NzDj+dE-;y1)VH>0%Ja}2eb}%)fyKBYsQV6N
zX>B$sTIT--M*a-FTT|%UadDj0T#n|-+o=_nYwr4PTKCe;_19SRgAwf`Z+S_AtxKl5
zU9i^3IN&rvn?HGu+2*?*@=*{j4(@lBQ&;?43G4WFOQz4XkAEs-G7rrh$Plf?i_n;3
zu;cOJBSUS9ic4sMCeLjoN`lPO1@pZ%g>O=+3)EryKz<K$VR;*lvcYenBTd}y-y+(&
z%Z?H?lfXM@la2oS=kj21U}&W>cs@{BAXE{5hg6uLTbe{J^JiBS#IDq%1dEEF9+9M#
z_}I9T_LlYD{fQ19c^PW@K1@$X80l!_bz0tr#?0^MK-@KyJW86dQhXj^R6VQzo~hJS
z@$kBRIE=*Pm4<s?c`^<`o5~O|S5Zbc+2~!2UxVs+YV((g1z#<Erag8FMCLn0@)12-
z2dw(Ints-40G7V~H+nWuPh&;H#}=+J7L%yLA!uW@byf#~oU~pU%1F~S`R8$tNp9#)
z#RR2-@0GDM5CNyVsT-<E9gLB;NfD=`Eo99)=m;%IET#6SO%D9?^KF(vwvX0taGu!B
zB#;uAP=TW50c}$GS)Q@3ic;W#DN=2JY7$%FQFRvR%|aGPLL*kkcSHHeTWS)#2!G$i
z`Dl^685UBVxVLAxEU|WpPXqR}rXO!<g6oECn<B`bI+md7Xdt+A;##qKJqhHrQ^1od
z2XSt=`4kcbw9^MG!nLPb1ikkpd_MU&qm_z_Vz<>jOkKk^_*u65A-e(2L7p&+cmssZ
zFEZ{1QyUObZ3&Cz^68UH4zF%2CRm6)ij-Sn)E7ssFP5o?2n@fjXH6=nn%&koRN&Mw
zNuW8Sy!zx{;28`r@-`|)SeOcmzGn?y233NTpyXsdoUylYw(~ml)$M#sKL?J;5$!4R
z&xfr3CSKK1lb!n745<(CFGM*iDD1Y|Bb6QKtEF=i7H}WVEK^)0-V@WPE3_?i5?pt(
z>PgF%x8Hs0y9aC#{KjYU#?z;}8KEOP&Qw$>@oM)Fth3FA{MznItCMZaQKM2n7-^h4
zj12Dj?l{ne#+|`-t&HM;fh$@KkEd{iyGF{K38>VBmMDN+5$*DWtWNp(xna7Ja7W`S
z@o(Tz5f@hq+)Q2rx}xSLpEmy~>+U(IMMPhyzW8?JEk9h3`-!-R9kM=(6FH3^=$W`W
zRNiZL_3BqHXgglWl0)3fvG_IK*BB8$S=`b2Re<Gz`pmtiNaH&BonEMvuO2S^MDdD_
z)A;iM;Pu1$y>5R;Utlu)XhZh6Ad<Qb_r5t#nFhS*SF1)IkHjSN_jhTIe^J)Q8|*3B
z+}W|1U*+QZtKDu%*FI3G&xtxuu;eGyJl(3ehPej{@fmZ81b_%GN#^i}s@*p#7KO^e
zf1aB9|7Wk_js4pZ5-8RbFY$lFiLuHSVVpb-AbsSy{x2V)`#<P~3=aR2AaHbX?{vVp
zEnu(xk?p*l?PBEQ>4Lvhmg_FpTdKQisjlHh-Bm^_^^KM<U#zQZq^tXB;lq-D`+}PX
wdLjM(^B0^V{dVIE{~Emld$*g57kj(gzW@B46^DLIq1nV*yWz{5YaB!W3wC6s8UO$Q

diff --git a/0.10.0/architecture/docs/design/images/arch_observability_1.jpg b/0.10.0/architecture/docs/design/images/arch_observability_1.jpg
deleted file mode 100644
index 30f716cbee91ee6e6944b1e4f39e7abf8272bbde..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 283941
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

diff --git a/0.10.0/architecture/docs/design/images/arch_observability_2.jpg b/0.10.0/architecture/docs/design/images/arch_observability_2.jpg
deleted file mode 100644
index 37a52e9881a281fc78dfcc98f57f3cc5430addcd..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 285786
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%0A+1OA<^ep8*jQ>eaHZ{@N3~)jgSG7O72<o3jf)F7
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
Px0TXH^KS>_|K9`vV~B0{

diff --git a/0.10.0/architecture/docs/design/images/control-plane-overview.jpg b/0.10.0/architecture/docs/design/images/control-plane-overview.jpg
deleted file mode 100644
index 70b7f9c1269b5b76a0e2842e8680c4cdd381ad43..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 109055
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
D6JD5V

diff --git a/0.10.0/architecture/docs/design/images/data-plane-overview.jpg b/0.10.0/architecture/docs/design/images/data-plane-overview.jpg
deleted file mode 100644
index 5cb74c92f88005384b7961b98d211c1ad17db65f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 245070
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
Fe+AB3Z+-v(

diff --git a/0.10.0/architecture/docs/design/images/gateway-placement.png b/0.10.0/architecture/docs/design/images/gateway-placement.png
deleted file mode 100644
index 0113b621a87abff52bc1ba254df814e73a1609ef..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 216658
zcmeEvcT|&E_b$%p=;$b-A}9h1BNhZiq?b5Kaa2G>M5H;Opi&~egd~<x>8L13je>&I
z2uLpxrHBX-5ke0VAxH~7goNbo*M#}z``y3pU-z!N%&b|Em*mYk`|Pv#exCiD7<|&i
zXzl8)tA&Jw*8X`^|Fn?My7fXrtDRQ;0#|sS3Qxk1?G8sz8w&{q$O#Eu|653C0WMu1
z5)$&>FC;X4K}bmJv5=71wS>}BI`D^I?2jAi3-OTuo>Zho!IfXH9kuin5>k{!{$J+z
z9OVNSS9<+vY_O8PdhO~Bs@8;Sui=hDf9n5n#;<d9(b@CN-PoZqs@s}^zfF!FJ-q$+
z_2q`kf0GmM`Zbs4$Bl6IIc;V}4rS@Er%&k4em-;6DQyF#UBxk>U1PcDfj8%V`hCsc
z5knUxFL(09io3MDiq3D}Q66Yxp8g<UR*N_;b{5yI6v*uHrLKU1{O56Rclwy#f1V=0
zU6}rL)v|wI+J0j>7~o%zdxw5H{I91%LPxhR+wor)e!q7e4EnFfhNFj8{p%?h==bf*
z|9#>5@(t^M`uBxHKm8cSf9&zY8vn6{kkAin{IG_=0zcx$zg^*nHGWuQ$pSwz?2;vr
zpFgbe!x{n${HR6$?Fv7v@xvMd3;aKe+Fsa~2@A%E+c!8k=-^_X*Oxb#TKghBy?6YG
z07$;u$VZT`J-5d<)^a%gA(T(wBu}0Cf*N=`ebL4KfL__P=Y4tVCM209?3pCbwOjf9
z&M(()-W+3pZOC?p%9Tq^bvj;IRPcPy*5RuuDHRHFzUpqwr*8|lND#t^?3Jq(CB(Pd
zPGZbU51fyWKU;p*!eV2As&<N_llK`5^Wa7PP_I`njYq}HX~J!$x4gjZU~%`mA^os0
zlj=t9jTgr(44G9CLwfC7%)h-K)06Z|9jr{W+qimj{>$Q5<Cx4(kD8l%H%pGWHh*qk
zpMK_QnW+f>))&kK*tl=Y<M{YUGO2j0Y|2K{g2dZ3&x_l-#3%vm<opT+Th!uvPibA7
z@<3g;oVcw_G;e|HBfYu$P5<fcQR#PeC1~DML3``TqMo}eP{)K*9s8A}7rkqoNf?G}
zlpdc0D2x>#`NETG@!^$Sx7;T^7^!H?h07Y7qoeyR&<P<SA@pe!%PGG@b#l8-B$yGo
zjp{mI@7j8rQ4)K<Sd#h?<~W)upa@Q0Ck1{-`mZ;add=2GSKrcv!B65*8e(fgk9T1+
zRv4c!ab@m!eFp{^bld{%!u;!XqzN^<YD`bC(yRUSc$)U#ZE^H^{G#vsq)JNXr%h|U
z3lK|*M7}Mnsd+BGCH|cHI_q=RAxesNk?Q1x?r}3)hijMp%7mAxjXLrUZR_Tp9=-aa
zYy8L!>Dw#KRLHLH)_uR{gxM~>gIrhGucl|&_O%LpX2Tf9Dka%|0G~&t<|@g^<aN0G
zwr*|R^Gx+)wOf8Z@^<n)*)}3BZg@;@w%kR{%IDCp@n5Li*~Obgu*_qEU06_1*R3PX
zzRuTr+P~$miJ>j}lHHhlsv_TftYCLx1?<SC9fD6bj;_Dh|JIX!yfW=+r5X-9cjC-*
z`Qw#JkB-%FBd~~H@aSZo&4GXg0+~BmU1cU06<kwuS42cvO?iu|c4kUx#@>v~mixz^
zCtZ%;7-bgkZ@ET_@%9Ab+sPhv5if|D;X!^mGVilri8A-4pH4r+EzxN6+#ONbEqV)P
z({WqgfD#**6kbxoa+=an*r!;N@*#yY-F?zdOndL%r25Jjl#x{~sk@|6X<v1B(RA08
zWuxR<LuRZM8n)Wj;gRIR)BxkrMF*0ar{}aX>E(K1X~*QsoVj2UYQb%-UKEYbL|vdQ
z=d(*M>)qD=_Q<-oqjxirfV*_$zTw_SA=FBY8h0WsGNjV!YJeK}R$KT6&jYb1y5|>s
ztVhPIm=$#arL=cXf8I%pg^|wFR!YYdFz~!c6wyDseWp0UMNNW28jeJd_eQ3F>qur~
z{<G;UXU;#=YNJ*#=SnA=2q@08A>~(v2WzyQ$PcaYf4Qd*RRl7#DJlNG4po<8PsqXG
zYGx%CM@&9yceidaiu8&JlsYD9q+d<qOrzi9l4N8QZ7XfPhQFq7)O9a*#&>je9xK`J
z>oeZ<fXsV)!m%OZFE=;6%Hgt#@rO+rUYEA%eiH3jsg<PlTjRw8%35k$)EC_9AUITE
zy`@Kk<|;7u7Dsx_#^|+_B1+;+`$;<qo0Ya9w-U!L-Sxj+sVyUgVx*aDYvge+T$Kxe
z8QysMMU^q;f(}iJDGN!WReWil=k&MUtV_}!+=Y#9s8B1x<n}V%G%2YN8G3a*JsOoa
zVdfylxKGXB=ltG%SZ|SYy2`oi{8L7UN2LRQ_qXc^n7;Ol6!c7tHMcX}!F1D4=FjD6
zJw>*5%02tVVn?rZNE(N)z2vG6QJ1yG;(Z9pBWHH5rl7Y{qpd~K$ZkAfaO1etiN@+W
z{35%w*}9sxd;C1wZl-5zm|Z3JYLz&#RLjO|F*msWf%|c}s6AWuM}(Q^tHmq$hszy5
z;k0j)>Og<JhdntVe(`7beEgG(9Lq;JVQtZ=H<c~*tNT7y<Q++e9e3c)$YrY4TrNs}
z48wd_o@&;jVk-JcH1B2cCIWZybhESV(4v?UvlbQ+nexzObk_tO{g?Zm%Hlw54>@o=
zKdMabxqX}cu^Qh@V`K6ld8~+$)N?Ycw6mYdZg9+>oTMr~EU$#UuDt)?HpK7Fk)Mh-
zw5_3e)amGPFTC9`Z<y0K#mG&oP-_SeH_g%B;S0Bitg~}`ZKT`$Hoi^$xbx2ZZ03@j
zI|*}smzy-6m-eUVr}8r8UX8_L+eW@cP`QIKlS({JJhCSt{X|O&<2XfYBtllkltF-(
z=8e5+vwL@`4l_A5JKtc0SCB8YbVEK&$5*emb{A#e@#m+TJ3pPdR)Kk&va?7V{A(mO
zDOSEDu>X%Q*Iz!Z^l6;FU*;qc%)cLxHR*J}(Q%C;s&em>^EtdZ^-Bz=Wc^JYou6J^
zS@zknv-PCKRIwwyvgh+65(@0}IL}7?uFaMbY>GF;<n*?G3~-=DO~weL{FBL?yYwa^
z+y7nt#RHSy=rR4>X*|DV@-XtAJ|}P4_wbpRZO3tmyv3%zo;+g9>yOtGNY@5pt>aOg
zZz*Y&Y9a$Qw=&6-w|EO(W(=|KA^G~)&ZWRO;~o5~i-?HPI!V7_>?osMtS(@ktKWf6
zLt31@q2aE6M_yu@UZe-y^7+>@WgdZk<D8JAyXhC4Fkhx6<gwU0Mzw7{^dY}*u7RFR
zTot8kUHPlQf)Tq})U0lNT#~}pBvn<lP2ocjC>z!#{c`+o3!_qDoz_Y8^R~g%<c8>I
zDYs4>gdonqTT``d_p*J!B}X4aLP?yT=w_vL(o0NvrzWQJts!6XIP>|t)<wx4TS*$&
zx@~Lkgwp_c{=R*R13x#0i;HiKfSBb?Wxk@w$s{dwe$8PRg5$XzE9Yl}*K__;_<r&4
z1~`{;=J%;rEh`Cai}xoVxEn+5Q7Y_HeIsJ-aZ;>;X81_|KyQ0dn(Ec78PmjybCdR7
zg+-6N6{1PR$KYh%MY%=UJ9!vJqm{C%uGK^ZR0#ctjMyPGSGTMC=6kJAoY|Klu}^mS
z)>8EicgyC)tfLzpL#3P=#vdtn-Aa#r5Vg{inT2H}y@Ob#anSl;ad`)7{Yob3m7I<-
zcpCO)$`J0CyW^s|F$457duO^^N-;gog*K^<j-iUqS6$j)Eg})S{vHvMS?Rj+P3*Z>
zwe8gxySIw(UGQHVVJY?FE0|~N8BvhU`(Y{%>b#0GRjxYw8uG@_A$n0Fkth`AypPfJ
z_!~lO)zdEzMx@7wt=$!rY${I8oQE|I<e*5rw6%DPb-%5RDUW#$(Pj76*&KRiWtaPK
zb#rn9<F{U{VoqaA@wIOae!QN1dE2fEj0KmT9@~*jZ-?r^{E<BAxLuatWO@X@B)lFj
zA}A>3z?FB#P})Yj+h}FYzGXvs5PkgUqp=)@s%k4@TBwCW3{Utnh+$tdK0TTojE!PZ
zj~mE0P%S>(K5iGS(@QZWZAd?}mv`O>V>QzwwQsAj4Qnb>lx-umF-J{X+hYIr4>h+(
zwroiZIw5Dae+JpBrM6g`#t<sHhm|^nkr;NS=<7C?Nu=a?7&VJev?Zcf*P8UK)DF#Q
z!L#GNe|{5OpPt+RRaZ{2DLD#ma$r28!?NN=_M<jm=a)ly4!S+=S@e&>?CkW2h`GY~
zJ`(rr#5_{1Ree6u{6s0L{$bckVR*aWx^=!|kw`MlVE8nzpBdraxQT>6gET8copo3X
zlqXcA?%#&Pli8({vty!^6zdY_R>)6jrrdoHs%oLUM6AE1U(xO?1nQ`|NPU>}#rzKO
zQuWgw2fje*o4o8x0425H`L|e`_->}V^KrBCfbw0#BUfdhzCp@U=`Hg95oRs<%IfN*
ze(mXN6fTGPCb6o_fP$JHo_s(p_`WHGTq@|(ME>s+vagEgUw)mk-^fV14R!E?mX(oW
zzn<<5%=Q~nhv?i8QS|w94kTXAaJZRs@~bm@MZwYQtkB%@z5s~n&N5{CsP&A<2r(S?
zqD!N5wu14BqUj4)Q~T6XQ`eAsArkf{w8aloJm)V|Q6ek5&Ak%u=e{8yLQsHJ+-gOL
z9X9H5`&1uI_HkqS{U0_u(imdIM}el^=B=rt&Mtv@UsZKJHdhW7z(<3vvWB#x%vua$
z9%&K5n>746@8T%VS2Ji|CuI$Gp}~#CbnZgEZ9vY3Jp-luu_{k(@BYi>r!H7l)1D~B
zH@eMh(dSsb+N5`N5da{*S8uakF$G*SRab(oJ!b&*6Fl0XTs27?+Edch-5pp(p_Hki
zdHpjg6>2cU$vGvHx|}<u9A6}$%=wOn`ceZbzLvI_YV`22#`UqKT9|O%DAve*Sl<*P
zizvs=%;8AYEcp7)Tglm<Fw<w7FCl2+X4Im`+^ccLQWq~5j~WK1>-=gGIxw$qgn7q^
zQr-rjs?R6HAn11C{jMgD4wu5Ox>k$agfn~15B#!kv$Uj=a;pnqu!pDjd1W25sD+XF
zC4u7<tN5vN$pl{6R~4u~%dSMV?A^P!|D36B72B^kGk*wo%%;qK83X25Kdsg4`C>@_
z9oQH)M@UYWuk#pIQT5w|1)5X-b*5f7yAeztch&Mek({)rm@IpDT~^uncQ0V}1Z>ox
zi)~(A$t|~uSGUu)^di893;m^4L}a6Ik_$oLbEJ?oDj$fPjPMFD>R?oK;OW7;I28f?
zLvgE8Q&Y8I1KFwnz2{j$N&4k`59==;s|_@jiK^d}s3$IR%Fe>fW6}DM#pV8faA<jZ
zlD*juBg0)X@r^mLtIiE+y&823kzA2erS8k9%l+w;ZLV_(n*4tI%jD$#V1}jnrAy71
zrl&(!+$u<|y#o+(bHZaaFZ8n^_f7Gy#6{d^j!s?)vU>XQ_u{*;Cvd~GPjBxwLwtBZ
zwlGQmhL<SFd^#R{`2A@@Hq?uL(;qs2eQGz`qgc{tpL?z8{*jgTj*f0M&fmN)Rn3MN
z_cmB6z5cM`{q3X@2)Ue1RUQR}2SwK=$?x5p{Is(0YlV`iv@bZr;%F0An>2V1e}W?C
zgs-birk~rFfwa<vg!))Z?&I|A^Q-jM+B#{S$-hY!xH%8~g^q-l{{FYd!mFH)|E&%l
zoR{O!FkX9e*_Yv=j5F2wTCd`5Ma>63Q(8Caq(bqodgIbl@fQgW{+m5o=uly1TdEz<
zI(2ZfWT`J{NKLzwsn_C(008uRAJ~v;+b-)W8P>{$C_1}dInSInJ9X;R{uBEy2Bi9h
zSzL|l@qj3{V%Is7#w=<79G_?GL-hk|y=#7c^VTMDC$X`&Fglr94^Ha<^Pw+vZX0#6
zW9lk2)(}{SscC#i;ApJkH_9(WWvT!5vi)n(*n>t#2OLhhR!+(^I__~oNX<_-tkSn%
zk^h=n^Suz|ai#INj4|T6FA%6Vhk4b?$ysz0n<on>PoXN8mK2RUId|czqd}0Grl$GC
z<M(SrWTZ^h;*(;-pWhW$UrYjMuupuwp?+9|an9r3$1M=q``8V!eselkU9W@`;oSoo
znE4CSzGy!$vqGz@Z)_XnjP4&7mfmcmw*MffTEwe5YK8NxcY$d+X;w~!+fFpjy^`7B
z>hl{P_`aU5vb*tpau=dF=lVk-jL!E@&8DqBhx>5W)Y!$@RZ)C>PSRd*xQmUL=#}2L
z<sSA(OWKL7H__R>ZT;re)6rIdw@1_$R!h+xGXQEqWUo5(&5$~#T37P2_>5OZe?UuL
zl2PKA>*R27ibUMz(o+cU5Sm%hb)Y%B(2<_%hE6`ZzRWVjxFYbhx3{W6jQRL($?Gv2
z`xMl*nPZW|oqXfpv*u>-H(~q>@Wr9!FTcfhxDpQeq5TdvVHYA@b??xP9q!jVG^EX6
z%I~;YMVWf>;^c*y#vV4321BT8I$AodXXc?;rV;6+-CKuU3u(G{``<QCI}_`Ms^czS
zfk4zeHhQIJ@kE5L3ZQRV43ShSGuQ3X;i9(SCR|(7P|@X+G-BW(QBYh%{yN<5t2=@v
zMX%mXa18ishl+|PD#JO->`_jjBUP0@XdQ_qIHmvH*E-M*grfx*X3m2Kqgpw&P5uz;
zH1J>EoB9m*c?he-ijpjz%dat10bYc4!L9V@Z?AOT@7XkT0>DWTQm*Sslq?dVQloup
zm5A5#zBbDuwta3tc~EAnWW2TV?Ux_V)CL8CLtAOppj8fjrqmv1&*`&!b#pVHx*ca0
z@R8A{!V{9#ZuzpB4~%s9b?3c*P@g`e5z+9O9O_Wy_|KA;Zkr=1^GnX6K@5I@^?Ys3
zb->nk%tgRLDTR(spGUJIhBGoaBLuv=ch}prggXnJLz;mT>4mu|uRrHN)p7G_FI1D4
zdwaxFXwGC(enoblb0*Q#O`=AoI^w6U;2`mBTW!^)0v}-1RCUb`JVsCq_NDCi&F+)J
z@X_1;;o<=Uru#MC@qz9TV`l9)i(`spn=~igU%e{)UhcI)fVsgygk<wcyQ2Ori%2xM
zY)AH3eYNz^d?`mGX)Zs`1U+6|?NndDM`L~d|1d6}+uKiibwKrj@H#-UkY^r4nO`No
zFAd?+w7vK3-MgCCabZ$3?kK>avYixSc0tL7EOkv)Nk|h8ft;$iOAWgw74WX!hy3tf
zI!G<_dFDhjmKYtcckTpig#`auzh?2Qj6A>cGZEvr5?2sn?>7f?^lMg{-6p5)wJ90c
zxESK!M#%Q~(AXIBy&OY0G&NUyhx9!!U>~~;m#99Puk6Yo4@cg1{`tFCy`HxB<Zk%&
z`|tYIG{20D>aXd&@kL22<;JE)!0fQm3}{tBySK`^K8j1M+4aoz;&8v=rZuR$<Kdfn
z(4J-vmP9N-A$|RB2`L2(6|zh2Nty1zSwGYIKRwnQHx<L4eJ-C;@I1XQuQ|6q$ZwnB
zW{;Vp6tgkyD-ghrE25w*Y4*GJ<=6h6o-$uio5GGIInV@0<py5}q}I_aYXjUNy6O^?
zb?#`tSA8?3*{5BmZ1nYyU|s9`l%wi(@@XF|(E&DU@jb7uxN4S6czVB7g%H2LA419I
z-{x0WfLBNW7h_o4X7W_tXHh!Gv*)-?3V?r)ew&gA=C%-FBQnt+!IkY@Z4ZQHEr1eW
ze`cFJ=qN#lDgtq18PL;F@}Pk}I7rd)R49uNsU!i|1-^z?TF1GI!ft}C*4)us*gp$1
zsi|t33%q8%`*Gu*nR4F4Vl}}oRywhSMSWi8SA3oFByeTj=BWPtW0B#eZs)ImI%#3$
z!3rm$(F?P|e%ne!k=%3OYB}nFl+{xQ^L>vz7Y*$?7~w&x&F0m#k#oEC1Fuk%Zg!nh
zTG)5#T2$&mH2|RH!cdgvLd?8&;1ak_J%(v^P{mB=r>yKAOOGC4q1DPs3#D<%4S-WA
ziC5==2I3__QWxcw;ZpE5uRaYAdo_;%)U1IW=NCQL7F$?qzIw$Ma#w->gDcVTe+3M7
zn7kBla0(ljGMV|AGu6OH0E=ufql?fbA1m(9w@Rd)U9R~&EZnpf(9GuFijqD9XfMYt
zJi57Y5r|MI_q!iBA4HMPT{~~r1RmR;zs6#<A_A4ZF0TU$PMSlZPEq!V%{*^;giy3d
zSg|Gov+lNeRpIK2wzf`dFCJX1d7TkNZ1?VN$t&v{QPmE$i|^KddzfqtP#QeiUgg>8
zbfC*mO=xl<E!`a1_D%2Q9#~zk;3s*X^<M*KQ6-<!1TM3lK``av_VjXVz9pOKd`D1)
zWx_r#m+gwi12+P1rchdOLT)3EdCL<_ya{TL%dT$k?eYuT2A#Chy>Wj%{p$P4P!~-Z
zJT-VqzjOvuD03iTajq+kD&T2NYnJmRaP2<<!FAquLl;nY9I9{=&|XAZ)#nc(-z*_b
zK(7Lxoao+CF2S3vr%!$<nZ8tWOX+NRaX<6ULg@nr;c>$G=}w3_90H2REd8T?tm<iU
z!?8qs`mBspU0_X{G$2Cf3Og|y=7Pnde2$r0Kqug*a{==&hXTsB9<xgu*eW5R_A0C0
zdtV_Lg6{*ibg6pYU;)eyA&E-K?|=!+Bj>X(I8{+XZ@Xg7`>vE%edKpG#CUn&e$|b@
z{G^SzVPM96BS5L_E^UH|So1PSeR%-ISO1c)IfkK_eArh&1omwwDicrgQ^0d!m&og7
zk~_PL;!zdXGINa6f%Tf)J$<>Q$bZq0S7?ml=jJ};CC6F=OE;fZL=8jXCfw_p2#Ev)
z;e(dd4d#Fmfd?Fpo5;z?m}yTJCMQNV%@q#$m&gy&#q9g5&VYMai(nxGuQA+?5EnrA
zu1Nb*pr$Umwh>_(KYXy>Har{#vj;9DJbJK}<AeCXp1(_GnE+{OYw!3y^xxE?lCP|D
z;Os#?q%L9Jh}fN)oGh~yVD;Jw1jf+bbx+ME$3n_VZrMeN|9cJ?a0pWe*Lmx%<BUf}
z5KEkDe*0~0ojeLtl6A%TyUSb&f$;53#UL2uOc^2Xbj$CuG6-FbV3Svjo{iJfYjzU8
zv?^LJ9O%W+#hi061_lP@?hB6|5C{k*y%B}cjF!?11ML1dE>^*x05E^eFT@dJYlRt0
z$@s@%RzDvxU{X%nu}`E4yFJP-RjWyT;TH2=QaeNuskC_9uhWoW_s7L=b-?|#BO^0I
z&ASscr^w^Epht8e^z-L4b!F%ZDd{9_(f}K#UkeD)YQGC`;W-ku1F2S`9$9JHKx}Oe
zkK>Yf(*zL_h=H5YNt&_vikzI(ugb(;I-?hZF*r$q#zTcVT2y!Zbe;7(B|E%#&+D=0
zSWMg6Rob0hZ9Nu7n66ThbCeq~#}w_9x~&*V=4Z!)LSry%6v?-<GZ~gU>M-kS?xu{O
z-XiSLI0hH;KGwx@uM7^jcG{cgN^A6DAU{m<xL<As1^Llt<mKPwLE%vBHEY=X!V7u;
zNO70f^b}G(Ne`1cG?k*{`{=iG>I;^Otr95e&?TJP;wJFN;4G0yLcxIYh(sEcr+j6p
z&JpgGbKh;#ei$+~&6iPO<6+;^q6IWH3D2YKWKPz8+h|%o=Ae5wIlI9B?TD17S6_OQ
zJdhHA7K6bz(kcxZm9qf{8E)20ED%yec9KVqfhOZhN6#4#Ry;A$+E?QC*YS>kE+q>y
zhqt9<w0UV>*2(d--Rf&6{`{KM6*D*1F;NOkP%n4DIew~V+7wN)^w2H|&Wz6`0{GTF
z<=$cXr4yVzB|q%t*6*XeKDJb&D4aDjljMz56oG>=Q{9;0X5V=)!2Xwe>LDNutCjPt
zgEosaf9fv&B7}H2jva5OXRZNtXc)7XWssoNJYC(jTV3jdP1<ahx@%@P^D|N9X)Y8W
zU#4wwWZ+=bcAh`R=k&f}BBZ_r3@`rPf%Kd@^KzefvOK#geQC@7s;1FdOa^Zun3e-(
znIA*rEYH3|Mu!;Ey*P6^nAl>dmx+=?-FBXau7L!uRzQEN?JZ<~pO#Qx+7lRH#O$^Z
zK;hMpFO8tdckY~Z=Y$WyBSR}^&sPW44Gn5)xhlNeq$9a$mwY+19I>5D8$PX64Wp8e
z;K4Ao6m2R*)Y&WF_tJqgn73n8h$4aNmpgX|L!Hl0r)zW<pw9cK*EoqO)_tCFiKTZ*
zLa=N9=$-N6MG&&(*_U4s73AL|-62@8A#XRpjOq(vL3w0tU$R#8ZF^WT9FI$+K@@h+
zE@A}dU`?1+O%J+;pujlO#oL3hfe1|j135J{4Leo>ouHR1<Ji-BQj9l6CIut;2<U0G
zS5%-TU~6pwZUjk_@6RI*J`)0`<Ib(`%#g{pa7aT)^Cqv7=0SF2_qMIYr@5xyS;$U&
z5?iJQxOD`#5{0IuZW9$1WjU31(|_Z;i4*NMqmn&dHm1kVQuBMxLyV}ePlt4|A6gJO
zmbUy(wQRq8_vt3Dau2{8j{&BZpy?K)zRYo(Q)Qk`fOu>UxFOL6_#S0l6$z+24Ub@L
zMqj)*=X<OJNETco#H*m7%U4~3pa-8PmyliQmQTe=&}hPK)<g(SNxNTKV{y03frjod
zTU2w_7KvnZ%zUs0;8I=v^~^q;w6yLw-OLV4$yRgoQ#Of;@)wa@gl7#ASHu9vfHdKB
znhSbgKo$!P6%JLTzVmz~T6fQcagJHi0Br@p$c=O~+Uht!4qNrkcxZwL1wjKT$dA)=
z()^L)i2r+CqZHakc|GltMT_xv5x~5cP+}vNFe|pKgR(Z$^}~k`19oKWS!bWKMzB-w
z%stZP9d6SeKh1Qj@XqgW`9N0MY<;!~OC2gm@6L7TA<sJ6#(NZ=8mBu$pT*IMZa?0|
z;;_bCogprizQ|6;jXNCWufwyYfOGN_R0E+V+XF`$33WgzjOpp~Jzr?G-vVB16aVGa
z?=K#JzVOSwJYXlm`V~EQ1y#l&ktL!1>i5upLJ@4j0FvKqFqJ}WNPmb@=kF*X9pXP*
zO306kRB5ffM2CxB$wL^e&aOiCe!=T@{~-|JAL4v5l{RqpG}G5V(f9#Cic39{pw;ZK
zu$@1=*PbRzuS5z+sP!xvu0SxnwP6>r?+Na9?k;}wX8sKFkTvTfX~4(@e>}8B(A5=s
zxKm6x^)$DdUl0gQIGoJw;q&W4ucyZ#fNdMP9QnO(&NqjUkXqk=yRlFq1)NUj!$te6
z0dl<a2)g^!EiNj`H9p24?saL|CBVVIAoTmmtN$oQ1ee+amuxAx@PF&jf@l|(KLVW!
zq)+`_7cn6_#TRGr6V=3TkN?k)OH@q2=?-jB&q~1(2&U<xC@8@M&xQWKKF)FGALr7c
zau-qDZ6YEF*985TF06)Ce+yX&@n(H}P8X??)N^;*8j0CRhgK$OQMKMNUl~ObZ*Bc{
z^f`{hlNtoK<4oR)l$GfZZy_StrVD$N91dF$sVAZH)0M~LM<`lNh*-*A8<zfvk^Y%8
zIvoTXPddSb(LSN(L5SL=iyZ!e2X5=qrf|uGn+%nyt_PM#`GA@TLhxMTqmYo&(l`x|
zq1PMlo_DDPRm$X~9WRMwH*hBvI;`$rKE*%-udII-LWP&~X!{gfM_pYSDBK7r&z<M+
zGe<4Fq=$BI$?27l3jcCH7x<JW0tNu~D>e0+szs$5NRQrR9`tkqUzG>)c123>+49)&
zKx{E|a$r2g{hklB@3ic~Z-)A)Xta~>N)t4iQWk#-E}?+tKp(>T^X_e=jd>)~xdLmY
zRwd}8>-sQyk+uqYxUf!6PJPj@$m~C=p*s}zJX*{i;!@ufOdk;{VT*pDLF2D2TL15c
zwD8TH`0<1g-JdA|qzJgJvn>JiCqVobL$493x~hVR3DdmMH;-O)=gQ6%7HqQS0%Sik
z(+v=q23nbox(b4T6fTfn2~B(e@(<~C722=10T>NDZe(0y>nR&^(djj7l!3ZA!Ze&}
zZgmpNsRl~ik1dvV+$6Z`1tiVDbHHQ#^#BQgX?W6^gE!>|fM#ROdbIq~#T*X~3VMnG
zR(TfbpyBn(#2E>?`RR4IY~~0@SFwNxC2vX!77cZrMHW7vXQC(N@`4zS)cb(fWMule
z@6K752FN1shLO{XNUVXlKmTr^RY5f}q&0CG=>mXnF^%e`**vHPRF_=>g%2rk{!cEm
z+v#~py7Hjd=KiY;3d>a(PzfX#g<oCy%QZi_lz%2Z*zht?(!xOB&_1NooKtgJKc9gf
zYAsR^jsMo$Xu5YB;7cI)jn_VtlRDwb-044_opc@H)%trUE;k3`8ZLozbfE6>u-@B?
zGM_50^LkY$jhfexk)qO0$mL%#Tcr~FA*BAs?Kvv;r3xMgGLf3}jYbwOw1sdkq~mh#
z!f34MjW0+6+5P!3imQ|}m$PcS*yfnC)lrO!=}^&SE-;|>mOO1lyMWjO6fcOff-?nV
z6I6pCLFZKddI?>XUQLV~&@A<)C(Bj$FC8D-E+g1e6Hy1%)d@V-Uve8oavjf~RR;K-
z>NJSt3^}>9<n-Jf0FqKtQ%n0Wbh?<Vj7(zhePJI&Oc>y(c0NvmvivaYLS=1jF;8k!
z9e`$FkTxJfs=`9YM*WwElYACWcVQp;zZ$gm09x=vQzM;t+;yz!vdar43<>t8GILCr
z`5dHGHz~V*h5K4mTa&QN(NfA~?<cbWCYz!8H8g9<9W~IwHDzXea-NGSBc{-zBJp<T
z-{bXG_t3k2VAD8&V(3Lyx5y)HAAO+a&RC>1B!xT%F&M%lNJ~PUqpMKX5O5a8uuoAh
z42qsSLVmZF$bD4p0NJ_ZspU8e4XGO1SBR>xSY79QTWN|z6pIi!>m^o>hNuPHXuR-o
zC;DIm*Y-Ra*dY%2Zkg7aanfF!SSqidncF)x>$!{?YgV_$b_6mrqT&JA-M0MRts~4S
zhPFTFXche#7!+VL!k$13laKBhDof<CPFgrsd5&JD#tW|^Ts-_cKW5ZFEGKF3xk>}r
zjm2DZUWlJO{c~^<xFPB5Lgub}3ckgep2p%TDAHr$N<;&LP{}|9kd=5n7&LK}f3)ex
z_m+A+qe#7gEy=tP7}e;Q!kFvZNVI$3K7Wy048WOI;fu?4WZ9AN_l3jWm#8&RDxlXN
zc(C9+#6M0;7y9?Tzn4!9SbR4{jHFK+>;)%`6*tM2H8mKw#~lFU?MR-_(+m2uZSg2O
z<!=+A4HOF<Sx_g+Cv^<C_kgM9=ZScw00gE}PNd2|`{<d(K2gbT8)+^t%k2vo86&lO
zLUZJIRK+BKOG%4L&ea;t7>V_jPzeL_+6aO#HO`i+SKPutcjlw76Cobz57b{W;dUBu
z@`@xL^b?zz2(!`616d%8AR!?Ul0yRE!?lfwFdifnM9fv>qD`Iar%eH(b#`w;I@hW0
zNkA-f>4$TD^z{cKLISVPAIv={F#dxC(m}rQcV<UqKw~WVX^z@2ckehr6{~1F9{v;~
z%c{4}G=@456gn4cN<$$Rt^Wr4$bE{6HSta+gA_~2Ve8_VOU*R)%=B^j<Wyj1kj(+A
zLY6~0L~&|&g*1bN@o8LWAZG(G&u%nEG!cL}YTvc%;})AI>k)XAN9>yV&d~#KcQnu`
z(E0^Bb0Hb;>nLbeL2O)XxLt+&RfAQ)WI7t01m)2tP+U4(`Suqg(*fjwl&KuDlbE{K
z2Xff}lLai0#Cc|cS>4o#@Vd3cUspj)0p%&~LFA}bSC>p;P8g&_5fS(C7JSyKF-S}W
z{f|A!Ci?n~P11+6K^BGl<trZ9EYXZ3Bp9SP#6n0n^KS`yA;|hPzZ+?LeUhu$DA@(`
z&^ylteUIvW2mNa3+p<>eFXDL+@&}L>o;5EVI<YwtTf~6r&2?KI&kh@$E3j-?+0cWp
zra5KY>(+k_3A<i{SXd~>o36f<&cQ-|+i(*@PPTvY**kk?YWwu7g?3Le76ie@WrBKv
zQ@kYe-L*ZczM8k#XN^113fxV6<OP#Njkw4tMDGMs-hd!X%lvTbzE=T<J2Q7h4Bq<Q
z-yQp$8~7q$r@g+$G&8N#Kxf^z=#|zDk!a{?g5Kb$-ueVcupkc-t=m6`eJwhvkre<5
zaQZ$K0oMKXKyImyh#_KR87XU=b;(Gnj+71r0}xzg7poznIvfeo=h+1IRJvm(aRe~B
z{CEQx=aOj%CJ7P;hYT76iKMJ^rzYP%ENG3Ik2W0wh+WH|^1Qj4$PjRcFDbslfO8-j
z3EJjl6dt@sUZy>$ZgPw+MjXT|9o#u_9@5<W*!vi}><&ZVC#&O}4%%OO5x{C7o?ZSo
z#CZVS_jwf`J)`5Fog31$8V6XN4C?JB5S3)@9<y8kvY12e5_t`xyg@>G>oWSgb|zJc
zTKBwW9}oA=;O+p(o*wZ0{maisKu(j{?@BGBZ?V<n@1P{7^re3PM0uI&{)fU2IMza@
zv)tt|5TC7`EfAU1h{NnxHM^#bPQYC<)<6hNm9z+AyM;0mSML~uNG^fLBJ|=s8z+H`
zK<M--5;5swF^Box<sUz?;x$rmt4ed`a24aK4aRv5iL_zA{W3@@oJJ8NN<Bs@Jm*f}
zDu4t(yN^+(DlQ@dAH3pL?V=>R9|9>tlr^6u`M0zeA}w|49Mek!8(kgzt5uPlSi;QY
zay+@fG?nyg9!02~C$e}Y@SU^OVb4KoLq;><9ygi8kaaJ+`UhG=P?3*tE;vlS45@ht
zG^Igxx#Lr_F{aV-a|spxgBQ6f<vMEnzWR}$x<;;40XZ%Z-0EybbsE7ggtzc@I<UF}
z2t*KI5Ln6sslsZXDTZ}Sri_z!R;j25RTxV0kzblX7VHkfc<YfxEkt|Dq1O=xVkAet
z^?v>q&Nn@$I97mzP|KjOpyL%cM<ap!D=i1Q8&%9#3|EEufaBA`xefF4w~%bo$3APM
zsaf*v4w%Q_Z7RrLF1ucNZ@L58hR}l%f!+}bmmchcl-f{^!Di>YdSef%6qjMIzbR~`
ztc+pZu4$CCrq`39Il#_RrWI_x-(WSSD8yM@h1_qULCKV<x~ot!@TQ0Npa+gAm5B+H
zB89*PdWYoawjs+qR^~)Q+6MX^EyAEWYvgr9>K|f9cuBuQSvhQsS`qp5vq~w+!H&Bv
znutgH&D_O4^lP&1EZPNiEQIANHJ*jm2yOT+-pbW|@=HjtKkz4A#NK&UVRblSwS4?`
z85!JcEt#@B$;#Cw@BmMD4mh?E65igUadyN7ZKb@7UkMBSr#!m1<_jcj1KI;H%7ZU|
zB272%Y4-WOI_a6`ieClhQKsrWZbN-cUU?okmz3mW`x^Z+&>QchpkHJ*8figwv?Ap-
zl>fZxjv9`81!TPyR51~jLptnea5~YtJZq?jIAq}%;|k1x)7|N2pg$_loevNP$_mok
z_%4xU3c7*wGZL)cDQ7A)$!4&y5J6s=R{L^sBC`#1R-@g=bW>&xBDBRs2b=QSJ<nQ}
z$nvH+Zw^<jC$cZpMG-igL1q=sV~t9?_d6-oCAIaC_w|>l>uja#EgI?TB<*Kq{ah>1
z5JL5doqk4Ggr?ZhG<h1RvIKoQq3ud6ygy%{GS#+b=GY$5O9~b)rFOYkdTNz{{y|l>
zhghAG^=SWlMM)K|3M}yvSkJ0^qcoDuJHipD8Je%SLfGL=BaIsXhz(kI(!a$9c0=?R
zL3F{O@q}h79I;q=8v>yFGxlqhwdqN>2ku*^UwQO=pJJ#<W=30YH6T4>-NAunb|pzO
z-5yY-+CyMgCC0E58nN1T6CK&v9hPkiR@qSda>wkbkwJ9?0sxcZW?yY2@Pn>42vRYq
zc<L2&@4&)9GoFm+BIQ$+bLAs83jgI8mlXiSdPCB>62#xmLEm$F<FB679q0<y^sb}{
ze%JU=o<PWQUHUnTbsJ8Eh=F)IzO-jx*;hczps}^sUu_w14p)5cJ;ZqTCn>sa!s`rx
ztmS-ti!`uv5mxz(a_983(uKQy#P(P3XT!o4uSKplUf!K^R57u464u;S@xcd|?e`XQ
zkp=|dmCG(JL5ScNmZ<{+nMxtPI=0c#qWaB94F=powB<CR4Y4nC7XjgH0ZGxu>?-G~
z&3*=z+_c$76oT4i6!EM_f)gs&gVqc5nx=;pasHn!IH#}!P6K-xz1Z9Rd)Z*>l$?)&
z{)Z;4RT~>I(h~kc?1*R4sacxD0aB5GeVp{CK-UDBZ5I8c&f~b?=E-2tFFuHjM~Wuc
z7FL_hbdNWr?LoBaa#0;0{UP54zH2?ndwcNhz+^7~2;;=x5gr)Y86%Zw_sP3-^~FsD
z=xRV`*+4(5SPeqdB)80oaJB4_wwjVhw+qZ#!#jBw@&Q3X(D||2(4+|H6UwsR0T;cG
zV4jbUw}*o_Kx-d2F|?N2vU$xs(qTlQxCco*I4UuhUa9VhsQ8d(DfCK^cmjtGq&Ev_
zrItql3-FyL$b(!4YUZGGnl|W^Xj81blik31z58x~oImQBIbuRNMS+fviagKUEAHRP
zYb4Ep`XvrOMnbW4pyNB~JiUqHU0}1;8#(Jxz8Kol+&T5Opd4rf<E}a%=(Mw{=>?oc
zrLnFkp1(Zp{hd<j!!@VLRUU9uV1=EMXuY1bn(H<Hp_tHy_rc;6Gt#Ja(sL+95IzQw
zse=DnVV^=eew?(}m?~WdmAB|*AJVmI`$~ds!y!MH6EQI{8Ne%Ua*hDP6M>{)Bgp#c
zS$_NBAOhGQxfRHJj#n~g>IsW4iNT*3{C0O=+7c0pT2^w!Q6%!`xWh=XO5)WKXh0DS
zP*osp+EqgH{a}J6w=x{sA*}0;6-OuI%b3$Bx}38D;bki@wqF+-itP4jG)NvtFf~+0
zaP%k}PAp~lqajFGQl6aIZ|+h7d_O6Gc82Q*y-M9lRa`F|{Q#^4L85-Ua|tjZ9B-%|
zYnx-r&h8`kAO|^;DI6$yCJ{XX0f$Q;T~v&$lZ#$qpV?D^dcZ4be?~fes(WZ&ziKwd
zsKj(3!L<nV07x?d`QQH9<>DcBG#;hu;xVcL><~h$v)GmQ>+xe4e31FB<2pb4{=yi<
z_ku{fCJ$_m=+<Euauj)iL^`q?$com%NE`M;-p5xTy_?cIt}HRb0uFWl&vSaMBcR$^
z@$<t5JDjLUq-@#3rK-;!K<KQl#9^-O=1o7n)H3kC71TR2QY-C2Nw=ob349TCV{9S=
z`}HvC^axc#s`2iT5+;#8)L_$mlBZ!`+JSm0v+g`L2hk*oUqh%HV2t{O@e8}*a7_~4
zRI!}{k{+VA`9AwgS@RASk8-Ttg}<K<>Mcruk{&VHL*61tXzw4(=9p2Y*zSv&TveuQ
zRQ=amH6ZoAIobBEy*h4oofl_<Whr%8A*RuB+WmrgsfV#nv<gV$_y1&F2}+pbo(@&h
zr2rNs0-BP<pj9)4vMUWp8Je^iTP*F<f_zK`a`3xKXDEcl3C&~?sMwL&JX%FiUDO|*
z41}_|$(Dxmf;SkncOb!%Pa;Ev#_RG7xXdCv>wJfqidp&@%a)^1IpBCAA_WDiBd&sW
zAK|(fkICawd6+U`{?2Vb5B(=cM_@A?)!>X^<cM8QNM~FkXh}CBY8sehF&q2Zd!dzJ
zK+9Qx#_9b2jZlw$EmF~%)9`ZcG?#|=BPZ6V(xD{$<RyKbb!jHhL{KW9IE+i|t}X`F
z$uIrra>}bry&Sx^yo}5*l_g@vWm}WsOe0PkR*#0)V;fzR(hUg;@@=Xtlxf;ifEyPl
zLo=4crUp#Y<=c3J<BN~u{I~6r8qs`+U%V}58x%8FFmNjo5GIl`_R33}-t8*M*QzYR
zpf-!e*xP&TT|nbEnwx)v!)U=`wthR1VAddkg%bwbVvQpEuUR;8JKKN>$PHcz>`EY<
z76?hTS$oRnQIj-<b_HWcPm|*gHxlSf_CBPw1X2}M%EkPH>SH1BnYr`W&zcjB72=YF
zFwnvV#w;pUvK8&2bb}g?2EL1!jZ=!Kpob@uRJ*KkD8o9r6p#afStWq^ae%WjoJAm9
znPW6R29G%xFQ4P&R`DUl=)MWG2`_2oQL$p8qDqFB1|m50UCabfszSFil!ckCXN9u9
z{oQ~%l1aSu{fJU~OXoJ2C}^i}v%TeT!j4HI_4YJ_?q#AJ4oOUtEnSVhK_a0_hE{6@
zFlFbi@sxZS_<s6jDDPmv4oL5VG{Afb8p#llP^lmV6??=y3g4>|DP;hsBxI(CnrVNA
zDwVG<`lT{h-mW+7esdieIi%W@pjFvlcJbO}4Lvw5NQ09qVDLtC**2&pCu<({ath<O
zO0;bo8Rm^akIy~(v{I`5Jog;3+LQI^M=j18dYfxSOF7yP^)Ak{Yn)k(7Zh9FXc9?8
z<Snx<nb)Mwq8F9!t$4avG<GFe`<Acl^w6oW2;E9y#J`|#7=)&aB{SwOz?qz#Bp#eZ
z$VHo9=hq&uO<UGbvGB!IU0A+Q>~$N`dPKUV(nFh01C*kYcq4(;YDggC^wEO+be5t2
zx^l&!FDia0W_sL;i13-B#6>oqqe<cdU$MD|35*cZD3&j@yey4WI;v6i9wT@-2oyKH
zhc1o+uz~ZSkQPVS&V^Wzct~&0sWgQ0c9Kd6Od>>_`v3wc)g8S^@d0Oi&Tex!f*p%<
z&GsEDM2;YQKN?A_cYNoV-|UOo57}A)lc){{L=jPwjUJ2>(bPDPvpsI-(4qe~o$LIR
zDZ0Sf6i^AgME`6HF>BSC7`q0uT><^Tk#Yhui%ucatONoDTC#+Eh!)6^6;YxBl?SQ|
zZ8*|H7{V#=5*|9U@`3k4)SmA7?>5yT`bq$kC_B%D2C_p1{X)UONOa~$z16zAGDR06
zN;>dPN67w97sVDTcR%~6!fz_RHnphnk>(cx6N0KLL2>KEw(;RG3!G2!Wv@ICqz>tQ
z6oGSH2sNzQ+|oq~bUm`M>Z~&eHxW)V<ft=C52&R6Mv6(!ubI(A9&%JIc?87ZHNZY>
zwjn))vKdqWDsFSa$Z=z2;iaRIV}roai693uE3Iy=xRnR5YCd&g!G64SZBH4`Z*~97
zXvm=~fbQ#j3XP!gy{j^ZoDcaEk)2lRX1fnG5T#7#<=4N1hNHm|8&}Ar72}JU>FE*3
zK~a#Y%Fic2BNO4-+RAY=138alW97HL8_+{xi&joA>l>b!t|r?miWeys0g2}IiV=>S
z4ZdMcNI?o|C_-Pnc(J>f2SSOOkVPenVNHxJY)TE#H-2s#51X7^>6|nBC8tTFnD;zw
zL28d9aJ9xAO;9DCvdUM16QbF{x!PS_$@GDon{_BXZeKbxG4wbI&KDYdNVM{S<_zE~
zrFo9P`Yo4!+VTBYjy|G?g7dXOLA&CPMq8m0dvkYI9dl!YQfywo8A&zz)f<VtX9ChU
zDBO+$*`!6qQv^9rke|J=I;m#)8+*0sUfnTI+YeK0Ynwz|Kjx7(CESg6B`Kf&C$wQ$
zteQNMkw?oRb*&rM<Rf+M+2enVYx>1G@i*S}i_>J&@9E~X=^2O`G8Nbn^z2-b{80Lf
z7k>Ru4m>*MT0c`D9p6~)Yc-po*NE*6^X$o5L>HaeTkzER8pw0?^+&I`!hwA1L@xUF
zGaW&j*F}=|+fKohyOGTekO9y)Hr334->~Sb`+zdyhXWxUCbZU(!|PDS!pUs@3$9DA
zU25=7bR$lPbf?(+`S<KI+F7vFQRZI}5^|{&Lxd2FLiYBhOW%K9Z(K6@(&hhWzw_Y7
z7v?Q35&Zn|B_;nd#t&=!+Zg{BtufEb_hnT1h|WB%!zV<2lz4OG!H)G?4}6g{yc)FJ
zzb0AdrpBH>TqUcL&9i7HCqxWgy)V0N86D7iy87MzS10#v)h-B0FA2Cc|9bt+pA20R
z|2}j??&!MT)&JNaRdh&$8QDtfzz_>eo9Z2io;db&Y<+@fTZa>aYKzI`x>s`lZG`K8
zFDVNISMU9AU%<IRAc7RU;Lzd!DTn#r0?z;Z{>>drF<5Ym-<Nu@g6BU5Aut4dVeF6P
z;M?MdC4TtCk2ta913xVB!xBHTsK5ud|FFalOZ=!Y1wQcW4@>;8#Qzli|L}<)KJovl
zPkbyc70|=tQMNc``-VF~m8v3EZALBuI{mk^MIw7Fm=`~4)-{Dc*4ShJURfl{N&iIR
z7G?i{>PmL2?iRjdtQTR=Fquq>F8_4V>laK;bkHv8V85B(AUnnI_R5m+;0rTaefNUY
zKSXM9vw~zD4MtILk^lB5@=H6c(;s)dT9z6-|E=G?W&2C#)TS_v*#|+E`0aB1TVG$d
zM4%k(oV;2sdt4S5n16Zw+?{k4*<KI->MWK>1#LKqFDeo`y>$LSU%#AVUtLjT*p0>Z
zL>*#2F52IpC2TZWX4ixKGcoWubWA|RJSqEi<x||@!~Dzb@&XFskT3Fi!srd_-dsL_
z{;RsfLVqSA6SIN;vZG5%1}{P@Dr~-Xmuw+A2eaWx>$1E0oMtf@6OFR*Klv}c@L_3C
zJv5erNGLJPZ?v*>*D{~M_7ahpZt+~+S9tdQwbzx83*64@E&;FIKO&utS$*M|V&#th
zaIschzKTL9>`%eSw--qg4LQ?wvbagKx9Lx#8BvO1eq=G(fVx&)0j(dlXX&*>dXc_0
zO39u*h<r8$#<{Ot+n!esZ{&~D;f_Gh^X^;lN?A9YMUR;frgMNArZM%fRPfb1*Oi~9
zjq}GUG*>L@8?<sqW<1rLqt5>x8==vMYybX!w?m3lo_%!>g`&ISWl^J*xO;EiNRr@#
z3{@rg-+FLer~1}M-SNuGd9)ON440SY|8=|6-{Z0}0w35RaF^@3raG&7j_V7K>AC)M
z*;r>)kl-KBdGbIo4e_$G-8-a~ulBXG>)yz}{dH<*8VMfbJNVBHNB@~=O5^{S>8Yg^
z4%4+Fgw1!U!1%?px%LLt&t!*}rgD{H#^m2hNH&kw8WgXX0Sk7p>|1ibt-wq+OGo;`
z6pAXon?Fs+Fn=sQ6eCzpFHHfzx8EnLShhcx4R;q`BUMH$cH-aqkXYA$joRnxNR$X3
z;|S~H&}f$x^w>)ue*OM9q~NlhZ!<#@_(r$8CGw(X$rw>4zu6=-w8TGNn8EaAieR0Q
zPYYdW+w`9o{MXh#Wc8ofkNl6>YrX%4ziTddmC^D_cL^Q1ro^B1lQm0A(>y|_Mhsb*
zF*hCh1?wDwLH_M0czB5{O<HTrPu2dLs<-K~i+M9~{k;Mwu{kW*31KFv@;!*xrU@PB
zs4OWi;@{v<O#6QsB@Wr|PEKvQEAF)xILplS5XblMUwMI;FZeDLaqM_S!T7J&KXg0r
z|1`8gO~B5kgpS=hw5$Cv-?I*hy<B>Wjms}TYgJY7<I8o$3qSK+XMaGu-YTyL3Vd%D
z`rYY2*H``G^#CK-5B2|;;jg+(5qU-yX7!W!tn&O~f!7>5E!dtHyw0(sg2v*($%f>*
z)Ww*B4RQ3?k{Q-f*#vJ>AurjbKW$hFE3;h-7xk%eV4%`d)VO{rz5@s?Rkqg`bUBT%
zIHj=|fe-w-G^&N{@_ev|+o0e*{|x7et*MT9F4hygr^kgo*l#PiXZ@03F+jI6dHh$Q
z?ohrVkNznb=4a=DL>OhC;0^x?vU*r&86-rmzTR*9xhVCY#fe-B@3WT7Lp>XXe)AB-
zqwQM+9&(aEP|U&nbp4N|fcm?vz{iItr$YH2eBmTayjL*DKmQq|&TJ-3e77f>?^N5D
zobF^~oyBL}Wrt!hg1`{`&s#Wb-;pGtCm$;K0ra~5QaYf6pC+S?!6FZ5v-gaj;!phE
zbwRWlDyJ_D!y9#(yZL{4Aa1d=$YSSt*LpUFN#2zN^=y|+>b8xOZ=!?NX38XC_u4NW
z5z(y>VX*9{X%y5Zcb>&?($?C-Sz)6STFL)dsc31%nz~+Q<P&`-UIlI0Wpu*NraDZs
zCijLo`VciPh!^m*U1zQ{qLh46nf|;;f1Ad0PT8f<kdqTn(na#c4)WYuXx^s1nk!91
zHNGTNkq^q)_dg2~E8I+{Kc{Zm(VkDr!JMv*gK_oxomz@0uicj1EV1ZYZc}CN3WDNY
zpCgt9zxUIrA>gzD_HTltI_qwUKoKEk=agX0?IGejSpM4SY3lZEoFJA(5eg;JNMPm}
zh%kG%PQE{$Nbu$S9kjShj7s9zi>M!1@LrG-#6nE)Kjy3(9~m8y4CsC*g~I$XiS9}b
zdQRE&$6skPGlu)h%dp#ueEcVsWb7A4rx=7kx9Lgx1XkCm>u<xodB+{+WQO2FiKC-V
zTSVMzidNEX3U~J>DS6M$cBm#+8u3HaYulx7qt_Z?DI{Vml6vp2bozN+!Up&HaHx8`
z6ghDoCp4wH3-|Od_z#SEAJ?<sjQpZ9sL$yr@?mHymMHgkq{+0QK9|Hw5G!sp-Va+#
zMsMks5@cS7hf7n*im@AosT?c_bfFCgNmIK6U7E^dBQTz`o(XvK$%2g{Up~hUILI^h
z)!pj3_`>fRyvkc%RxK;!9Pe5+<3yOoq^n4p-T8`|$xl`?Il8L-1(F#2xUY2=XL{kT
zHh#R_TZtt8&yn?7HNnRDXqg!C!ZE>Guh8vMb;i!dy0Z$w;;0?{)&4c9rDy4OqV9}r
z5n}nPY0Bs~1+`yI61OxL$w5K*Wzj~z`d4~%B*YDnjcj$Yfnj)JWg|ywO@kimU?((_
zs0TRAGL?<H3L;m=C}c!v5pb_G^ro{#VzAFyzAH_FAFGl$EaBOtt=Tqu<&Qn*ZcYt0
zd~u_~=e(h8*(D~iQJpB!v+P^-pCT)_oz}D9xigc>)(yYpehK>1=<`yYGrCzYk$YV;
z9Rm&$XU$P_k77bzj&`JFq!gI-O2THz;Q4?Ld!n|wfBrUb&E>U?g#~YM3nS96PIZj>
z)@fXtgPVL*6P7Rb@JL-(uXOI9QKJfWT&ywj3Wx1uCDwJ@KYU%%=1I16h~Hbzura<%
z&4ANaJ4bge-puiy^`x@y2h9qvT`Y3O9h|q7Xe4R%-+$iv^lMd%jN-f(3k~y=noK0^
zIb36CUS*#`R@dQ9JL&7NN2&;z0NJKWnSN$(FL$AYF&D(JHcMhZkcg+-6g-<xuqudW
zM71>31q8_EV3JwqM!c0BOx(xDN39hq^R^v2YeV{(;;3zoZyB!;Bt-abn5A0dP)tW&
zB}4(3vV(Tl&0_9TnObM>;hn9KsL}bL+rCC07B8^p<&%S!^Jbh45?U|UCVU|gZggb6
zdFLeM%w^q6$so|WBSm+dHP;b8<zl5nTWoIoP_+3Jty}mk?BtqBUu(1SwwyTSG%XXW
zfW{_T)w1K<jCrl~d01{(kn`Y~x?6NymY>~`749N6{$;~#1DE#8of3C=y<2Hjx6%v(
z=hABYrH2<{*;PRe-1NZ3-zY2aw%GDnto|metyZdTZ*-Ur1{bvxJPRhqWgK14%u+A3
zs_H&TD_VuJS{qo2Ig-XO=ZDdkVoRa9sdL7UZkw4_r1dTU*U-e9t2cUImyt9Q#uQVw
zEW4M}>W+?p>Nh@eY~P!!GuC#K1$)C>!am8!tixkj%AUP8e_z%1G^sgTl++uvf*=vl
zV4Im(6Lcg!q`lB}Z{f;ylr>hNYcY6UFRxdTH8Nb+XnPWCtCpk4HD^V2#o_g)jNisz
z8JntNthE1d-x?LO*z%4%5T<#gE;t*2$TT^eJ|4y_LRoaFJ&KgpcwVk~txwDCpt}d#
z-_hKq)VlCRdB-)=;ja~f3TW<uySLyU*LX?Uh6D!)aTd0nEb6*lC$#*|=UyVVA|W#{
zeID2UY^spdu|}qHGQCPu4{ta*`_=c++pHQ3HMFxtdje(aEmgxSKWC^(s5QA$$3!H~
zik|vwMD5MbX`2{C<>Gi%Qu|HHa06po_bR{k$(rbz+V+tIdD(I4KfE-a3>QS(npNmt
z^EG!ZvMST*FJy`m)!k3${z;s~O5zSz&;NRhKqKKw=L4$J8cq$lGNilLv!+68D3cpA
z96r>JI6*8&vF;9%>BZ_|)4y4#j7WF-{~ge~>keLVopxm)c5x!L-`NyBt4j6Das05S
zaHHDQib~tAQ_Js$6Ft2QHfc}9WfRDS#<x@i6|-x{5(sL;=ZtncO9qUNS8y|S4mi+u
z{f5KCFi7Yyl1#|EkwWGpX=d5lu4RNp?@9D~<$*egH}mWpj~RVe2I_Pt^QUrs{%Gr$
zm(}wOtbRZiWlS=tUATtc>ls1v$(mAOL4FI(P_tjfeYjy3(&zenMz2HlyF%f0l<Gfg
zyqo9!)qes1rl0d38>PNfB~GebEtuPNizK~@*R*hr<(^F;%PX1V^}_$?Jx=OimAC|Q
z@(hlkxTErM_}=2ud23l2xou|>(w;V%(`G+v8KrnD(DQpX*Jg~}!pQ&b`net>%J=cn
zol9kCVgc5ZZtL7B@xJaXH6KIPeCaw4Q^`hmsj1f4{R~#)<S5^aQzdOXZ@vO=9={&8
zw8BU{UJCV8>s={hZg~Gxow`{3hOYFG;x<KML`{ZFDXrIfv2^T%MhW6!Pg8QYc*?Bf
z_9UX1`KGGm#W!s-8DZj_QtgbK(6*8~)7|L!u*)QKMr=W2*Mf<L?>s$U)eF8UV349W
z^s<WV!uflO<BRnnCuGtWV45#8IFD-^LquA?4A-{GmPPxR@A_xw#w_jJ@`yk));Vh2
z7aq23Elxy)#CtlG`@h(G&#<PNE^IVbtYB=QR6*rYx+pz>ilU-oqgO#hrArAl;A0_5
z34+ogC<00qkQzupBS;O>YoZ{%gisP734D`+?^n+E_naT+<+^A)vuCeavu2fht(m=M
z-h*%_wxN`Gy!S~euVGIvIq+XLc>a1))OposZeaq)obl|a)mMR!xl^JW8fuf5Oz1R>
z@|2@QzYqEW@k>{;g;5D9(#Y-?toVf|blAAyQJYOie?|qy-*I{l`83^-Am6$>e3R+Z
zD!Y)a65S*$jwGxhn&a+dUg<EJdBs7e$G7RC4nPFlwT%ztBABTdFImof{3m*;$h0Z=
z?R;QzTv%<)VK+qL)s3u^r?Te0MvtIrdEQvB--ZSPJ>>&V6OD7WnS=Qo4D$cX?^aZD
z#tFKv8g!T~P@iqj6I@*ukWU1=3T-A|%;i(|iHB?EAQe&mZL`S^ed%-g=fh8mX7&22
z+FoB|pvwaPjAow13%Yg&Cj?shjJ6OwuQwQ0i;~O(a<3=yEBMsR5)2G>^#RiN_nqN+
z-w1>$D|){ImvVXO^>9DKE1~6ZNy2VB;2`DK1UZ$yvsM>0JhP@T^k>diX*F}j#q4QL
zSXM*dK&H|TP3-%X<xHD8WOcVI<Jo{;9#o=_App%MP1e_1u3V$nqVDY*R78QhZLj0g
zO75VazPsaeP=m4f&5w*Jzv-&&5M*k{cs5ey-VymOZ|#tKJfXVy8Wbh%glKFmxoA#(
z3sWRJsK0V3QMjJu`s)|XppOSf`81&J!eMxe-MW{3Jy^s{)39hu&J}$Zybt;xQ7c;2
zFEZ^*rnMW`7LcEL!`b4(53ez|VO#y8?R)v+)fUP!d&5<3tu222A%e3DSnmFFXj*j5
z+zLNR_(yc@+hl$9aMcS85@`I8SbFuus5!=8zEpjobPlY;Fr-1kmXbS;8bUM0crVjU
z?I$IhfqC@n+KnI`p1JTQZ&|dzTPWS~u`S)z%YHO-pkmTcNy}?xYOpt}SJS(zV_NwE
z*E+xbJAgLg4Nb!X{syY_R}(UU2_kaXyd5**;+m=fU8Asx1uzCDH-o$P91=U)%y>(c
za-Bu344kwaHH@Zh8owLOtk4JI7WraOOk$tJ%<`?pA*;ThLR)zsFon8gfiuH+HsL+n
zK$f<Wis?7j%-D4HVQOYo?qWqr-&ko@7okBe8dbE_ThK@ujkfRP#iI8$%QWjvmif+F
zZN+JMn=blgsTrY-4H4!Yqla!{y(CxR*}dffuE6y0V9OmwxzJ#_vHk#O?>c1a!0qr8
zqJ2wQNoxaBTcD#>2AZpjC|+mVtR2N(x(2gd0_A5icS)EHW@lFAKhpahlsO$7=GMQ~
zhqWh>T{UoN{!_F2GL;!cif*@-yZ31cGFHdh>Ty=ZABFH?=o`X>-J8?SS6X&-HVDfZ
z5inT^GG^!7QuR?PGqi+F6&OwR1@}b6!)1-rFHn++w^tJ|xw7c2mr?ayk99ozSwlc+
zR{GL^DQosr?9RXKRnfcL#R&t0VC#idf9@RchtWLf;0SD)LE!czjF=9<{qSul-c|FW
zL-Oy{AnM+xlte|6sc`ItJ3N75@61vqNOve$px|<Q|LHCt&-wZ0)$XTeO1lDxnawUb
z&?T8Aa|)u*saG)E$ns=ybJ0qn%Yi&tVt1}*s-+G-dhsa<M@bqcX)&6>e769H{&7n&
z8SxDqsWAN!;bPELy|n%NqN3kf`ea7OliR?ToUcZgI34z-kKiv4KcEuL5&{v-iaAow
z>e=P)Y^{GpvtIqf^X0{Rp6e%EMEgtCY?@FnXhhl<qT6Bxcj-?ZS>=~wFDEgy*E@ru
zgI|EEp`y+4UM^)7z7D23P^$o1`5XnT`9MVnglhE4x5-x#PGY5frRClCy9JIKZVAM#
z+AV72+%z}%q2zP%yI)`?b2-zuxn|mZy0{huSo8F;@vzc`Xz|r}di7v;?=TeZ|8aTw
z#bh&Tf3<a%p0l)OVduPxeA`PGDW!=s7awdotV|U4HD9LT6!Vuy<6Od)Qsv%=(im&P
zM85}cnbpzy$IpDeszUkvi<ajZscQxr&L1Z;t_&5GEyTYQ?OR#SGrhG6bZ}#hJ6J8|
zYoq3>74xU8#r8WfvQ10)h;BVUlDQH5lFWLrKscgnAiDPT#cLRFDlXs+58#*{Zg_Rm
zuh})9r#*xD&3>6md<$H2R$YzP#4s2H4MVVAQ(=Y0{@Fl&M?5>o6ku{~*H#DS@(uLr
ztNRQ{a^Y*U>B!XUApo0x{H25;>Lnu*`cLu50Gw_e+C4VA?^T!Rry8fQNyBI@bQV@L
z-|;5Y)i40D2?Tj=Gs%;JyH-t0#&>JXu%wR<9q`C?->(V3`q6peuKlC4xrB=h)FyEv
z<K5#@T4V2ox9jxW#1B@)s~c^I?(;G`iZg;X7SkCqGOxV-zgw%A4v)1pjAq_+xZ1O%
zkrn-g&zR#m1tqP6Da%5uD+7VybZ693^O=t7+dBCtX4>`YpY+_g+t)jM!Le)NBM3e+
z-+#)Kf4m4Awlz4?v(qfgUTvWp$m?`4Y3UC1-=d2)VSN-+8MFN$YRWgmx?gic^gj3h
zR`lpHwB`&V8AUV`mP`&bSPr<Vn$FPFau1{|Mzw|H8T2h2M!QhnKHcy;^B5HP-K*KW
zTJL-(ZFJn20Ibdm?3$Uk@UdS!!)SHs#a-+uGCH8aTTxOoU$j(@1p12S3AzmDJ%bA*
z&!W}em(FlZM36=2diVqJ>kn1Mtd<BG=}N1~+0>1)(1-72=gLxVhO1-Wez!h)J)x(~
zEPM#KK#1^6`2v?~^8^FIEk-gAwYollpvj<*&&uahcTK5N+bq!qWBmAoWgnE1R>FU`
z*VPKMSQ)q)I!HGAR(eM3QD82QwAp?)LX0?KHHS(deLNW<*s@|GgMECji!dk^j6I&!
z?>G5FWQ~c-(p>$~nnWmfyy>R7RlLq{TD-P%{?xDBEO>w)w+?>~bluZCRMdCB^AU*j
z?K=;W^01ON%x@iiUA;bc9iSym@uCWA6LTYFNO6X#?=^g2zlCrh3qP28i8jDl8VHox
zoo5fIZ;Qor@_ZR~qBb}1pTXYSAmV&qk(NhEM34h7W;5%4*p_$!pYhp4lysQNG%6&H
z50=X`{A!^0V$Fw0#UjTGLkO<cg1>>S#+jQ|5MLO4&p)H}YH3bgg6QTnKUtjImmw-6
z0w+q=_iZV0ab8^p8KOWq!mX0mlL_KvB+r`NABBN{64aCnuw;QbyPhSs*(>8poDyEi
z1g}v7U(rOMAW9c6c1D)|A|wzDI*J>;Sm74uO>__l#tyv-zRH6+vt0h8D;K%+9oGT-
zPHZdPFk6O&@&63F2&-(`@aNKC1I!Kt`vJ5NZ$!h4OO~M45s<(5<|jHNImKAqn(T74
ztJ=5>L2WOa7!O<OhBqjT#gJ4zmU_2KS_n{xu+JB`y5iA24qChT1$G_+34&bKIeQ0E
zm3&86$0(-Dt9=b&)ose?+h^(XaEWZMl0SGU*+qL`)V&n+yz(@wf$}T!*kbKd4#g4A
z{=z&jqX2UF(F`~)4+Di1XiuAJOPpRU)nrU0=l-(f09@J|x&B#7VLBn)n1TYZw?{94
zL3XZ|F9E|S!JBvs(U>H9i0D;&JysI~AXfI5^*R6u392NQD(f~{wye^u5cc?$;E7~z
zO6u15CqGW>lm_7K16)__OW#<DQ`=Z5&p;OElS@@x#6G2vg^+_LjtFs^j>r*PTA<y+
z^QW8o*Be^@uk+F<nb8H?P}PF{{O&(AEw;lr-L^bWZ_Wk~Eww+D`<!+3-h+6Pb)&Z5
zI$(N~d!#Bv&1Gc@fU^$>Fit=mbadT?8oiceLfZ_PF5@C~|6y@OT^kFW{SU^<-FOa3
zDj_43{5Pbwwa0zu_6OO!{^6p^#KQjt1|A}00<urhj&sP~yMBPzqKb_n0HfcOagTb8
zKyqjKW9@2`1Z%K6g3jKyKe&G5rS<W)kJ5;ifcU5VQCv=3Tt~)7@g*IAg<`a$oKGVE
zJ}mC>)&C3fO>~3WBT@hi{L1epx%6)q4z`{ZXm{vjfT6j{aRKgQ>zH}ocp>0aRV62%
z5%gxAx0SxN7aGlsK{iG?q2zNZKgV!rpIR47gd{fS|2ZRo0K;8_s5LP;K4K7_+hx_*
zY;*&7*4V`vt~4AyF2-@eE(Y%#1w(EL>*osQrK^9l8T1)`1(&<5{K7r3;g87mHveWO
zehy{x0l8_p*6+^c<KHxz2)Na)^*L+hJdKk5!ri_YwD6an$JH4udbZAR-~QmSfy)*7
z@~diJ51z9otBrphwB$bWKPj5p`|{Q<k5L?!r0A_juRrZup`2L=3T<WtO>-B%M_9lL
zolc(=;jljC&oIA)rh4Jbi6F;Zi+%ZI1R#(@y71lg<dE7l#tNX+0O5?N`>u@S;WQXK
zxt;`Ch(DuclPUA8N<`lCz8m-cAlY@G`eGi@t$5EyznbsL`)S-$JIBP=Z}vz~QygsM
z1D(r9CoOO2yUOkT%KwtjtBUZdIP5n43EHRJ1=}v)Ddc(yZy)$*eZQ7P-FixIVN#f%
zl3|qv@|n^rZFw)(i8Wn+o@1<<q7CsY5XzcJpPeCo+}Oe6#5%XV5(6&a^W9l_)1Bc-
zX8npBcBF)?Co}R>;pX^b$`=6*AS<8Rvmtmt?G@4OZ$`Rk-JP**0IN>6G7T{I=TxiN
ztN$}~N)__C!r`p^VGIBBZYa*PAnQUQuvil!J|Y9wt@Y_RAo$AM&!Ow;sHR|EQ-mW{
zp<5*_jQ^7|{!2ukA6CF^svit^!egp`(30E5>GgGNYep^waOY*6Z37eCW#3^baP#$I
zgQ}0~Ijb5?=n)S|iWukSUF&(XKVss~X2iK^xS*u}HBC+ZNDfpOoS6ii>^2*b2~{D3
zJPud5Qj@uw>BqzG!cfv`10aw3C1myZV58Qj^=zxaJ}w`$S$RFTQC)T_Zm%_57|cE^
zQ{;2yFQu{T9C_>qN;3d<1~SnzmxC-kr}~k4&Y|6bkN?wjT`=eRK&iwgtFR@iRVNUt
zTl~yxEF1V!J$F54XWh8YrGZqJYxpiLQ~xa&OF#{WEcV?J7ZIJ>%axoK3rC4(KM9>@
zIZW!7Sf?KD3rLE@y<&R^+vR_K*eL;Edi*Ldyc~@KxwWqJ2b@5XoP@c4X`3fl?Z};)
z!V2TazjYROxIIFk=gxh6>dMWFQcrRT&`yo93N58|BHzL<I+Dz3ry~fUUIN6ScoWg^
zZaA(ygTwux_Vs?IH7M4s;uJ%M?LbsjH++Og{C*RPRXHKaZJN8zSAlR)a5E`_T<REL
zSKFMHUlCSU9$cIk4_A}1nP~jmdG7i?AAwIGm#@*qpAYgQF^GNntM6D|<Le_H34npT
zFj<?LMCA6okXX0J__Md!)gRn49S<0HKvl%gi*@CaV~6cmf9oRX%vXV6F}an0W0f*+
z#aLkLS_$_}TYgWgGDVuzIUiKH{5A8CsqIpTCETP4SN5#$tWPSpkN<9N;xYpAUrzj&
z6MNS!$A4GHe>uUGf&c%>M5u|NvU9c{*FFc`T(9uc-Vva$b(_X5<%6WY;`%Y`dgCvr
z<nQO0mB?E9E#f9bI6nKTmLE;j{z3pLWUW&6G{*4t0fk?3uGKowP_fvLH&Zt*f1<!2
zWLg$2-|ZE=W*fDTK5me3x(St6_R{A|e0&!1fy-_~+jjgmsNC81(rxK?<lU+-+}Qs4
z-_k96#r)S|MQDkN?p_4horQkXWq%E7buuAtxzX?bby(DN#mH_5GZJ!yL*=H<x#0%e
zu3Rl09ejwB+^_{N=ejmdoEzv=1r^<^i(L8^J`IIZ7%rASFhZOrL5K_70S9e(SQ{=(
zS!mO*&DEMhB9T^1y1P#dmtie=+qfla@?x;X_S@h^^Ina=q0syXl)`+^$>NFzZU$mZ
zc{8^HQXpcL4B#km1nciD{P@z5e9-!jk>0%QPR^rKNPEOMy<1oL48JuR9M3?9Ba!aS
zs*<vCp5Xk%{yC=lob2xZv-NUqAfpzXazyqc35JD*xlNoPgL8=vNc9bN6ycgM8tX$l
z`*&!=lv+`gu87Z3aq-oOyw#K9;@}u=o0Yf>@B(*!>;l{;hARLqa(~BZ?bu(cfMpEJ
zfi{v_%XJSPJ@TEe#9^ru$V=sWG%0uVh-utG|GED6Nq1RHR1Tb1{z)W?4Ar7gQn{t?
z|1iNzh?W}ktqwq;YqL#ce9g7IQHxU?I<<4xIW|V~n(BrcSp|4%Fc;bsZ1Bj^<&gy2
z9}!1B4L8F^Hz|15Qz*SPVQx)U0SaDI{c-SdP8X0eD3_HfR(+*zLkYjDk;uG2=H$=z
z_BUly5i2XDt9oeEri6H#@Abu{)SYX$kz8j};LG2qmmsKx=<lJ26p2$BOI4fr@PKKg
zVYO@D_>iIua$qRy_Me0HL-qQW!g;w&CnAPB{Ldf-)m!9XM7+QqQNEF-&oNDU58<MN
zgM*GvqW9oS3N3Jrc0ir)eoyK6V(AoNRot?#Q~^xKT$|DNvQdAr7wui6mD~Uw;`e-A
zwwX1B1WiF&zq`K1+z$zt@PJ_{tCzG&azJIg%Veh$rAW}_6`GJB3WW~E*Vc65=Co`V
zK9-DBasecWU*dXCWj*<}x?hTlzAF+m_LU5HnSCh%$F39oNOa;-YYcWjkR(iHl4SCu
zmw`(oaN^WO6&AbgW7ZyCRT-I9+shs789nw~2c5MCGo9}|P+rjh2|D|5pxiUxYr5CC
z($`bkq~K^WVr4v%rW+~%1qWN*HTVAg985)fMxQMCqVX)d&!orxLT7SW$HCA2eJx19
zMNZ%G#h#O$ON)7d!noDNJlj>q@~4Q6kO&-9;vyc*kIl-$xPsdtUf|TdA0h+9&YZqM
zNv#CIwb5KrY|rb@*5>owDvzgPRfa7jFY4fdpY0~3N<~)iK_M-CVIqs26?*J>8jI$z
z=FE7HJvt1%#u#-22Qk6R`dKWg(AyGpHsjN$6UVP73Zz~Pd!=Aov*43aoxDU_Gd>t{
zP)l%)%)iqXh*JgMZiswUsDp?gS#|o2%8HZj_doEftxfC~myf|Y;`Q-FPEHObO)lVs
zshJr`NKgympXk|X;?}58tK;tOF7)`v5ucdtkcIPRCC(v6mKK6ihQ;4Ul!?eRf(!w3
z6q17O`7*v}{AH=<6<J?vexdYNKi_w^eUg7HPO`?Lt;1QiHzbOk2M${;*BcGK2Fu-j
z3LF`F&wuu*=zal~s#)m=3$J$Kj9jgYr7@I`@yGtyKxpk5R2Xih(P|rKhRgP`my&gr
zA4?~_lFCI=sZ`{pf1k#fKfZigNomA_bxfQ5CCB~+U&h!IG#-Uuw0S!X)gUja?Ok0g
zGSaoRJx?5F$0kqTa5%iFmnFoa^zK@5aj>ePZuIGrNfnmL`E#Eo#Cf!S{xy1dAb6_)
zSY(6fHA;;DY$C@ehF$Nw>)gg?pebaR@%P`=`}8#woXf}4!Q5XW+OeL(QYN)_fmD7M
zFNuofbe9@7TiEBn%KzZ7MPAGa=(78bu~6t&7H*`y_QiIznWYC556U2v#GkQMc2K1Y
zx`M5ogNREBxa9=o9ySuNl6Pcr(QT+}O*Z|yswT)GdoGUJ0J42z*l6-DaV~i(D6Lg*
zmgWLBhPB!`kHQ&<h%<V_l!q<Y0I@uhOHzvCK=~Q2dL7lIl>zly4<;G{36kCYDG!BP
z&B_8V-WZ)9sokev^oM)%rS+TrS!w`Gi~tZMbJyxEJ~1qteB<rURN~>l<?$@=iUm>Z
za#DA>ry21WXD))cb5YZoV>Se&12EeqVA4$C-j9e1J=Ws>*vryGH9#D?l$=A&uxo*H
zvTQU-U^7RE1>{EvXqKh{YW+N~>QVAza2Le)-lc#5bJ};p1syz&Ikv%q!%P^*CIoF5
z3Rj;2=5%cp9Oy?(W8JY(53Hd=u8*URj<oU89pW(SBIL~a4e!8VfMAt?(OZyxjX0k!
z^d2je1x5}tgOw!TVl@vsEXg+RRY9|jiUeT!vrP(ZfT`ecqQxO2IZ{LDAy}W@p3^S#
zoPm72%blui^P>dRHuk$>f}Z5%=O2;PASWV`#w(%?|69`qKXtDuWCj|cCN3Thqjpy`
zu(;XnR4X!11vf0UxB0}dHDkN{hI1^sRw{w+0<1tnCEf$|!Qqit--nmAfJVY-69L19
z3{zfgXFC)v<O3U@-Ojk)#J(J)so>jgMq)78hMeuAq+DEYm}7xa5<f>f3m%e^eii6X
z9UaG>f-~#vIL2iMOEYpb+?e9GV9`BLD9|Ot7Ho9qM(Vn?gFwW1qQYUv$!w`yXC`X^
z5LJQVwN;-O_TTL)oKdm=Vg2}cmczoo7j8WLPnYbADO))N|81eYdoR~Ib1wxQKFamW
z*4v!9#C0InFFcA^H(T5*?PC8W<j6XA*uVeFk^job|3|Cl^ieWf=Lz&D2T*%TN0a@^
z&4D4$aqD-h{hp}mZd3j577JOwiBB0dbRrE~0q2H1K<U6a>f_HN9FrOXT$B%l5zN^8
zkU8S9b>R*|+~t~KYgd+^6e^(bo-mT2;$}m{aN;G<ay?Fo!0eQ(_^dw?cgDeR*P&BK
z$pdU-$Led0zyBJ`Kx@x5s|<xM0Xj<h=C7hPVPp$d8zcy4zyJGO-xJfX=g^7AZ`ZA5
z{Z2%$;a)W)`PO6J1G7LLV2^WaO1TBbYq}o8j*?>4JSUt9l=j>D<7_qd$GNsS$!#Un
zeZ>)rUi)LoQB)~L)H)1{4hRw%d&Z&DIZuxLe(?pK^AnRpU*}hjYpdk?WY3DRnzT4@
z*s`#*EkmE+$$CRt5Z0sfPzJS5W7K~(z=zCM-||6RTOfBeQAMF^ku{E$R^ad8pIp0!
zff0b;S?_1W>M&@-RgNo-xC?Bef<tGvWsW-d$#$FAWZf97;0v@a85QW#P$Cbo?tyGw
zH(_DpZ5iZ_Mb<Uyhc;5coO4d#Z=caWmF#(}f^aOaHjZU#D$7}Wq^gon1A8vi-QGUA
zNK$pWLgWm6m+SdCPGQuJ7rPGaExh0K3PZ+XCOq#q#UD8TVo8x-`<frK1E~x)zFH>0
zk5y@VjeS7A+YO~tHSrrDl@yZf@+C$dnb?};iBeqwE*Bq*s9mlz*{q34v5M0S@I`HW
z#^M_09%Q9g)Jvyg$wQ}M0Gf4h*kbpM5F#@l`I3xMvGyRog~)G9^sISUxnoZ_@YX?G
z_XFe4>drcd<MXCi`Oy1F#MEKQ>xr@Ox+xiO<Tryp*ZPOl`Fz|iJirD2J4#~pqXPNS
z6XFuH6B!*C=FOn{7;S7Xuf?GmLW&ZD3t5}DZ|F{qe<8Yu6_34o>jX0;!!nX0;p0<I
zIMU&K&)fDq)G!C}UZc0NiZ)mAeb-R}s<Pxqtf>?b<CxMhBM=o0;rHo>0>7iY&(5C1
ztbImJANTJu*DP64-O&&pcUZy65dT{8;?$7h#!X*eNs5cCKEelLqX8GK3;dnu6q$uk
zN%L6v8A$tQcg-cN2>gf!b3k&`LMb5UmbUA+dgP*1CVG@Y)@4whK%)p<2CQ^Nkn{f>
z%WCJ>iUw+E&c_ivF#R;#8dGI;X=q+H=F#E>?avuCSHo0BUmyb#=7@eNQafGRJoo${
zVYCjq)xY&I+MpfQ3%t*(YrnR@Ozl_ud2E22NK9+n7jR(D)ThEcRII!rxsv5yrl9A>
zoWO6$O47dTD(^CfLC6&g|FpkBLaaN<AVl05b9xZ$O$KZt4Q;x&Ph|5-NG(qEr~FmP
za}X*LAPcc-!%M8tC^H(37#aWilzG!~L-mY?cK}|Ba3OJd92wBh%ZenlPXsEk#fJ3I
z(J_=2NwC7yR}GEvXQW>2qKxKLW@>HSoJB$BU0}?{BlY|DQFOz6j5h5zqdc1xYr!!X
zX3!!1mmFET@l^Bi?=l0PZ6tMOXhnl?;);Xz=fi~leLp=)gO9L=6EVmu#rnOHhC(c)
zT5R2xp^r|6zbqQ&Q;$p-Lg0>-9dVu<Ir>kjoo(xPmlQgoOB_KhLb^Nu!0b)=MKhCF
zoz9!f-6%FqB<PwWFd(nLP*z8dy|Y+QE5rndQ_eLrC6E_8nE(4blH_^Rf?n+S%6mNS
zj|<PHBrXNjYhA1*8-y5tw(t7b9P{Nq$q|des#}vAsvk+C1r>(>MScr!!0Z(hfA4vg
zcmQ(G3@1MLJwu`<DG`1Q(jLoVE?_BT-e(?T?hNAU2Zs^b#9`j6MIw8$Ybw#G(z)h}
zEY=`XL^%*liq#`7Zwq(+X1nBj0((y$5i?E#bEYtv4qC5%mas`)Guyn9zpT7-&&JQX
z=B_ir<-7M_N59;jlPz4^yJw2Ha-fdz!woDg(6zSKZ&?l_b6AXw+wc{rr%{VuqNG^2
zvZ2hC@E+_n(DG?th(4x_e~i?b=h_6R5>faaTLQ;4wx6gSwYZPiyqR8;CxVP!jRB&`
z?(_&-d28c5r}As>hwB4{N^V_A4*ErG>)fkw_dd~}>KAoTZax>1;+J~}(!B`)G_}u1
zllHAqQ+ZCx-oEz3wQBF4e)Z%sU5=(z=IUnfj<GY}mncK2MMaBE`7|u85`<U~MqzZ2
z_1e$!8v>9yYU^Ny6l5&fVJn0hQP`|fWE12%@n*=DwLp$hlR-PmN*0tSv>C(J`YTU1
zcxSNpC_Jt68BO9RF-DY0{>)VxPKz8_z(hFUJFi{7<T~GrWb2jf+o-w?qZbq1&$EV5
zjJN>i)q`+m6U6VwGh3nvkJ4@wi0`gc(yD1qKQI-!m8*~D$PIc?foA;2*LG~9YRSnR
z5Mvoy@NPMFC^t5Gzd6xlub9T~XZz+(d|>I0D`#2gM#>|WDFbFiew8M?7U}EK+g`VP
z(CCC%slPMUlf`97<#8^TJKNj$v*O0i&Q28yeqU;Sz8k^ulD4bsGEk&iz30)#ASqs@
z_aWANsz6C)Y<$L}bml_a>?Z2ei!GaZP+<;pxvc(z5a+mdja)I`9O8nQPoVrnA->R}
zwr#uRIC=aopo%?R=UH(q3rr{q6C??#lfQ{}Ghc4meBy!CTR6)rfGq6enp{6c`{qzq
zM{ZxYOWv`(q|HJG1+<&#vpiSI_gn{Y77d(}!1e=RoVZ0B*9AsXC|fRnI1qQ@J#)*3
zv)~r%Ds^%qU-af}sKZ^-Vr)-gL6zeRtOUylf|ChCx@T?hWVKrxstJs{MtB*%KNc*n
zN1M#JtBV($lmIHhhWYBjE94sa4>CMFJXXQi4}Z;m#Nr5O1z8WYy4CA9{hO!3pKo^?
zuSd{fj5-YDYTiSaSFrcFrW6zeSvw9SdhG2lP_XHE-)L~XS4*5qz__ydNQveOsj`<M
zo5Ys9MR5+T5y~7|GbPynx1VAU3bG!}MeNzbl8HxgL1L_q<hOA;+I4W_zu;eOnSJb!
zA(uE>;Nt<7>6GI1^q%Ar)?I#?%~wbY4@aoBzB;EpJDgUB%h?$f7(-~noC4hh4H#|P
zhRxTsS(oJtj>d7Dw{BoPaZG_tU(o6~c1IuW*bjz4{F2y_Vil1yj&-_&5S(S1lDCaL
zcSTn@&$q7PQW(u1$c={0o7vqz3TJntt%Dc!I;vcIfqU1(h8pB_AGgg`D4PUp*MBx|
z4*Z|hH$L-%j}gn1eWvf&P`z93A|qE~@a?ELM<FBE{AI`!tT8}-JYhfOh9JAgAX7;W
z@3r|j+}!k(L)0Yqfn&C88P#4B<8V@qGba%0DK;TuqAZWX_cGocr6Y|_0G1wn1-LL@
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
Kn0vwG-v0o$P0RHF

diff --git a/0.10.0/architecture/docs/design/images/high-level-multi-cluster.png b/0.10.0/architecture/docs/design/images/high-level-multi-cluster.png
deleted file mode 100644
index 34cb12621c0d3f8450eb01780d381e1ebcbd8f7d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 364810
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%0D*R6rp+ucirE;x$lWdNiS3c
z!d`9!OvprtpR7D8cy=r!`sV71kQXD&=br0W6$`;0g6w{cSH(U*sOHaZ`#6Xn9sc$F
zwdFS^MKteo0+=Vv2_-Bp72mYS?9gNOak{;6Nr#)VK8BAq$E&LsAQSA_x?E507A#q8
zxjwV_-lKeVfFb?C*S#~J>B%qd(eHcCZr^@vY*zfKmcAZad=#ln^j>%4OcXiasA=ea
zGP;N>!ne(I=<ONEjOvMNCQ%kv_dKE6(Xsd7b#0A9Ym<71ac@a;hi$%SiTCKjE9oA%
z^gOo3#~uvu(K2w6+L%#$D7i5hg_qgD%NRC%+BU^Wieh=4jJ0)tq#TYJuu1u9KR++D
z*Qgio@gl-u!=o{A#7a4|`5fr}%r{#fyb?%^I%%Z?+umt6?cX62@YnX$l^%Fc!!U*m
zncIwNIYt>~k>1BT^74~6{@hQNnn-9jC6>n4T>ZxL@mBY2jRgK*?-2$0awhKpU*7k6
z;TUc0vEW;0)kMc6#&T1Y<ij0H^Ona)%M4}7CG3lSjqvJp*NPgOt_X*!un84z!->8+
zC)21Y)i!t?-S-Lj?r`stEHWWXOzHK#&uj=9p;Z(O&nmyAsabJRr2A;SWbSEh?o(01
z$4;ppje=Kx%*Z(FFFMRNHUoNOQ);7B^+k?xs(~yO4L^8&PLDaa+u3wg`td?>yP%Tq
z)dF-VCF2d<G590Uu2<LK0L!(1UT-i?^F;o^Unem#&(HES!Hqqkw%FF*+a3EZGhtuq
z6ilD#`ba?(n$T?8zm2#)mKZJ>fw9MUFstdKD=bZnP8w_dPNo$zc>k%#9s+1W7y6L=
zw`5vf?b|z%u=Lu@z}sw&?C9a0$MVL~s%U7@akSrQq1UG;E}Cl}r`>H=r}l=!k3U6^
zw(^NkpDak6k%=>y*V2m*%>y-V(5Gs1(yhX|UYP6*{)`Ov3FDF1n1@|@1Q9(g2g4+H
z*?UpNdyVP{A}*)@WkBlQo@(tDww&}&GycaDuej~bj54e85%k^(eOR|24WHAiM%J=w
z<mA!b+$+;rXw5?FUY%RQ>dpT6PjAO)FotxVbulGtFOh+tlzAlE6ldu`d}ZZto`Mt8
zcXiT`UoSj}w{++|h_=RG)b+luAYmZ3=G$3x)4?kB7g((KRMf$!i5^~LKO_t9Dof@*
zQjTy*M^YZ6c=W(=Mk!HyvM$j+pS+@c_K>-OM@;YA#g4*1>cmM|hovn(xXi;Sve+n^
z&Xw3QRho-N*|=lGWT=ccBt&DTtB))g6Qf%@<pck+X*v^+d>h5uKO9(&RjJ!Ub9p`j
zsV}yB@AD5!A!|oiqV4C^N_~D(B{YunR0088rc@bCTCHNirKwNmOqd>*5lF3I%yb0{
z>q4}AJ`m)WKIO5&oM_;b+&dS!Dc%{gL}a5q7c~m^_90!!R3odorZ}X=s+ij@^!Oxq
zxTTwXAt0Cb=D6ZXy~mp19bOz%TU9GE(9EfQWCD`u6d-fRIz`~)lBlJVKn@6QHSgJX
zdH0Rh?J8>0A20AOL@t#dtgOg0+Tca&GFAgtNS5UU#fIK5R=@Gl(du(hp5buPe1XND
z1FcJG)qly+SH-bJ7>x9XBeQVkX1tPodAEeA%k6&|kVCh@^W}o>uFLfHJrMako~w>q
zo=vdaxn|Z0;^?)nL&m7*7(GJ(7Mn|+320B7A<VDN&c4_gpp`k-@44Yt+>aUsdkQbW
ze%TUTxbXVM!aH_P6tcLK_aDdqO^nhWDf!V{f9_geuvN92+z|(O9R)ieEYeR;d^o>h
zVr;CjPN-d&8K_A#>>r5h`t5hkE-)~s&vx@l)z#PdkXD!cumwwoJ}SZ&9E-+X(m_tz
z-5lY)2Y9I7gLOfwn_?(h$Kord@5xE%y%~>as+}2Zu5bNE-RSd|w~X4~ip_KAweIwX
zXth;#jHo}yVzq_ht3J~+m^a$=p6LmnV$QpV@0yvd)@rggv-W#y-PDVpb91HGq%0rg
z+Gw&}JoV|{Cq@86#D{#6k?7bGJ^nC~R?TNwd*b7M068f8GpDii9=4`Fh21Y#xN~2Z
z93_HP>vgeKNpf0Pz;LAvJ9HkoNUU%NEp<b$z?`OHB50K!_y;$_IKa?(^71Ac4vk-&
z`6L%`AM@5+O{oI5IBz<rMk=rAD#*$6=kZZ&OgbJC07I<jY+r?F$!ln6tP{za!mIX^
zSnQ?kYfAF>E4sRoV2-Yj?>(UDU?Op^TabPAnHJKQ<(nS<Aafx$)+u63hVZ(9*qdqr
zOEuL4Fh#tVdFmvl|EqsAAUJo&UTvF!-Bmd&VhO~GlH8%F>vvYIo^-hn3rQ$l?~i2a
z*GDb3Bc4z!YJ;%`*y*6SngJ2qnp@>|t`^2LU&;9&?dGXc2Rx!<l8U(X4VGl=E<a(?
z=`)kGSy!&zC-oYvRQcBt=SOkRbkT_~x(5a0fAmV>oVdVYtEBdUOdNLj_7Ys7mjjkd
zQ`<=)$<fAGa^ri{M7K|bYv)r@vu|2qdhssLlWz)1<`q*A99@T+C#nGE%8`CLJ^A;^
znTE2taaVgJoq<ohs-piQ8Rhoa_e?Q5+@jyvMyl^aB4{UGuOV~G_S;JXbB&QtZy8f2
zGac@AV@Tijkt&J)14x9_-Nl=?Q%2cv4H?bF1rhOY#qA&`N;Y3BZ!gJs_;_==aUbtK
z%wz-h)n@j2RaM~jo!R617Pb4sU0$e;6u_p)cI~G)*$@8?Z$DShr+Z`Mub0^5Z6)tY
ziwDr~Or<kze?K(E%G8)7qOPT>so<obfVQ_1{N@0`WBoXs1DA*dY+l^ODT;Y?)c(t*
znU==mofihRgyi!8(<7<he{Z{F8iJd2mNDsn+$(Q&dGySMz`C|TWGi-A^6jxFSqu&j
z3r}#Ez>?n5(1?TmU0h|mu7ADpM{&E6|N0&D+~hqBt(t4S1M?4A3R${5<D;|>Ykdnp
z#57d_kCrv3;^YfIK<(0pTiT4qGKP>YjWhgiRRhNGngC0v#fN6)v}5%9*pJdr;tY<$
zcwIsKyXG&2beehXI?ioX?4${f<&(XHf$2p+;5KbNOA1e^;4(V7_-29F>kVV4Bqzdx
zrPo?c+;DOG>+UM{ECVv~mPoR4CZup8ZK35mZoZE*7+vhkOnKq9$lq->GU2-krvKR&
zg3PrjF}%5l@>~5hsq6p1tGYU2xk@6ARd0LPn(S3oG|H6~C)S?d!kWLP@r~Gx84C?m
zgld7Q9Be*SUcQ^h<@9k~MEKKPxeUuzw6OU8G@n~;W6EEu*V)fY4o3HnS$QdU`|ts5
z<<z}!kyM%=r516($p3K5lpRLic<7KIDPf{%$<Sj{u}<lsmP{CDiXEV{9EFASvkHz1
z&DE3GlXHt8B0&Th)OBeYdM+v7e7z{mLP1w*;yp(8dl^D9bPa--MVEA;l#*lYSV;(F
z-bfP$PJgLaDab09Bz-GIJ^_nu2b=D0U-5kl)_W#V@wcp3=fC*~5L<i9O|Z{i3L^}`
z`vIXX#d7{&dXI1*UFV(J2Ho;jf0wEN32{njnPoqxHa47hzcXaa-?#J?8pR?7n$UfS
z0pFF9-#?7;v;xd8N}O!QPd9oSFZ^`VQw3`!^93o(4XEmju0guGn%8huqpbpYW^78c
zTPi%kst~*@pd%^<r$G58xS4BW7bPl7Q$;qA*QD+$jwGh@<mti=`T&GGrb$A@W0VH=
z?Nj=<bGTC??QVjPWoBYRNP|W1kyY!C-MMxGizq0z>UkVYf&Upn6w^h=@SmXqX}X#Q
zCv$Nt3u>f4K}f>z4mgh!c)qrd)w|Tur&~_wPdccHiTR7onn$eaPx7Xw_{m6~mqEJe
z-1A@1Kn>&qJd;jQJeO?n_oeBp^5w`&Be?>PDxsiN3c`3h1Eak@?0{2u(DdDZl(GTh
zUY0#RQZr9&K*hc7-nyiN5Y0^fT><bg{`^$Mo_$CW*A7q&N^}RpSd=In-0JyO8e|n5
z^t{AAZrKiBO&_QTK@K1#ci7r(&XF+@?E@WqHGuka1~ZSl?MHf8w-sSMym#Z$>U-J8
z^(SHGMq>uA+jcW3%3qVVynOWHa3WRxC8*J1bVbg>&M|B<J4w+`^aP607MES4Kn%@u
z3&6)7tvJbsPvzD3A7SSI>ZsyS-kS29C(6;)doQIC5Z(8YO{ZO179f3{NUGbu*e3u_
z$?Mtv41vgtsU;jLp?m?MS|u5^F6m|7420kH4uTowVxyX$hEoZB=Zf!-Wr*u-B(U2o
ze`z<budf<$=#xTdX`_!k!CXklG56s(`VpeU*%vPyt!rdrvgUgn2@4|c?w3{WtS1>L
z`TB2=O4?KIDWdi8%$Xlv4Z5B0tXeE!pV<0($*`uH_gzB5*%vCpmAH+C>*w@xB;oHC
zbKNL%D3P@Iz=A-!Ed4R+4u_$D6jz)tjWBYO`%t!}*Q(hjzA+DrYFpYlVJQYYh2R6+
z2HKtUHhmYzLd2j!Tw>PiqnGD6CM@Tc%?|c*P-OaD_HeI{6qpym2Y1QKx<q|t1H_F)
zGgCk@U1tSsQghEQq5L`=OiX~pKWJ2SgVrM?H#;|Lh}&>8LV-c3-X6?hic}TEBG^bQ
z=DV(&A&A0BWMEGVq&}Ec>CLGqz6}o_Euw1m6<vU8ue5G`*Cvk|saM)macG#5tO^MU
zF<fvLovaYV83=$>7QA4T#v%{Vx4xPu-c`tgepN<9pT9B-x{t1>U`R37DxY-%S>@io
z4QaKF;oZH4@GC075bVt9HLoq|y91*^D;DknJvS)&*}l*IN&&is?n8ZNTOSsSHDx)c
zR)Eq9pic{JhXhbG`3|7P*bQ`vAWL!lp8Li+cBlYj)QeX?sfP**>111-!Kg6x8(YCY
z0+Xqe8+`<$X<|%voTIG$r^OlA_xX&_e6*SNn_5+-y|&86ia#Wfa*fLRcqU~&UU)k{
z3vWLE%QN(Bd#Xo?E_1T~9OOHLS0{;$1);anWvCHSp7=z19Hac(Q+U$^c+UcMMkJ3>
z53+rr`>`r0T}b!k2tYJD@qN<kqX(5k(Giy{LFz7xzsgR<T_>)Fz;B|^qZm5b*5$6S
ziHRf^TvC$S2g;GB?#+4q8L5{R+q=LhIe(=o4kkmVd;6a$SRXoN`AfIx?)!mJ(VJi2
zs~n0#ysTrJZ}3G@fdW(aMKB=mz!;AmKwqZID7D=?!MMK{5q!#LLoiNoO_q&`3kg$n
z*=<-K2KN$JlUNmsc#X~@#Ro>na&E42ss+K22yd#PWv|TK`})H2N>rqFAm%yz0Djcl
zgga+F{on2^1)~JfO3}_-r{R1B%6mUjzt9OF^T_%-FcA3^Dbv2Zx$E}`6V_Q{_LRH6
zqwoZ9c|s$ho8tB-H{G5$f`pa@?3BCgE?zwB2$<uf9_qf-uya%ByEor`%5n{`;{f3J
zu^`Gyh{wIha3=MpptX4nS3EVTQo?1U>V~&d$wejdbaxX02EO~+m7-gG>VI=rHpsAY
z!F_b6r&>J7E<j!L*+t4`okUWQObza22RPj4XG|=~FoYm}bgCC9PVJe2YPdw(pA5<v
zsN%<U9l1sT@;X_Z=w>?ATujHT32_b#zFL6=`ud^G`F(#kV(_4iM7gWr9olwS;@Vzo
zioS@$<%T^}OmbqpUn%P6oeXTfW{vLXH9$(n)}Yzmxk6q1@}m5b6KE!lC5Q_I<p_#I
zI}e<18n7gHiinwenR)c2(ZerqKK%Vf#-yx@4RjZsUPWnzicS%+s4D7efh$~yezrN-
zZ{QhTj&9y{3Ct0^DYjw_2mjZg6f%9KN+K82=KSy2`J!+J9E-9#QX#r%IUO+Oi2;bN
z35rBA-|)-k5Z)zo2y3r~4sG4JHt`}<$ITZ3`7uN?((!G|4R`1Gy<ikL&EG<o>BO_V
zIU?J}jS$L!7b`m>36d4s^h#4GNQ8yR?nnoe6BLOIHl3{Z_t*d86zXw-^BDN2r^%*?
z>B(M@JH@N7`_DWARPgB7oZt3SOn^FC;s@`^%fKJYs8R?>x(|dgQ|8J;LZ%h!@oLX0
z#MV*tEzhL+=EM{qM58kH$nZ$F6>2pNp&wXYqrZ&)-1>ak+<>hMftzc+b%ARybsk$6
zWSOaB-MZj;jw+>F7wEL9lJN6FMj%z`x31jZv@}~6{%0Wnvm*Z^Bgl3C{QQsB{Qql5
z8a!NA$Ks<-=^>o+^$f)M01JKNYF@)HQ<3#*0{U^h(@yY_EN--iW_;=H$6ZWK_Nxu+
z^N}l=9ilS)(PeDFVT?8wyZm;fUB<r4vW=3_LzwXh#jG~$pm87HT-HB2+PW!IO*!0v
z5ik7x_i{*{aCiquUke1`8BL>j%7Q@T$nW<aMEtIC5+^VukPsam&F`|B>8PIy!u&%A
ziP2D83bu<_BvB_x%37`t^**Ub31?+B3l_9+{y2UQK@&YUW5j?5^V5qbRaaM^?no1q
zUY|Bdx9?#~UkzykxGhOqNfxPpL89MxrQjNP9&!6?6qw#w1;9zy@#_#Gb^(8X$I1<~
z#{~GgyW#eW^?L2b$gVg^HIcgtwd!N3{h+^G?Ro3~X#!xRl3daou)u=B_qy9-xI?a1
zsPJl4rH=Hnpcry;E`Api01Eb|eUy;m)1sD;<n6#HPA&ZneBS)Ky@t4LBx=eO7U}I7
z9v&VqPSFeQHh4Qhv+`q1Og4)vH&H5_0(t{4A=DDR_l?a0!&u#u+}_7-zsWp$&~%c5
z@(?E@2ASP41(tFfqW~D*-uLS#AXcCxFu7FGce!d1-6>Sh2R~&?`G;x6X)`4bZx7U{
zd$S$^F)*T4ji%ffPoPDXeTz(;?CUiGk$jkmNp9ca-`5yMLos6T4fN55A@jV~bG|1p
zFG+#_fCU370Yl&rVotDF(V;G$&3FbL)H>d_v=?^NU0b^dh_bQA@C<GW6ox#>dcchW
zR91pM7BXluXid2dA(rQ%3`U;9r(kx&FkWGHQ*Wfxwl4pd9+CwV5C&0}Czb*&znGcp
zyGe0#&(1oZpoUZE^=p%+4nU~``$oAaOMBw>)dkf8N+5tR380YrSQU8wmo%d$gvQcH
zcEpW;D3_wy<3M5|9&g647je7{3k$<&+W{M?;8a1+UQ(A5yJ*cL;t>C(zDA`0G0pJV
zgq!fUjBhSF8?5ne#P0d!ARu)bk29(iB>ndB*4dQh4m-%4yv1VC7U)>#msD&k9si*d
z^j9v#|5&UVXI|kLOKu!46pQWaaWRdLLj7uCN?Io=@jLu2RK$8C7zzB?jCS9emCyE@
zsmXdQ0a7!!oF$_T`VNaMeu#~4@9(y0lVUxV{g0NK`Rql3)DPH@ME&Qu6vs2n{Q3p8
zgcp03eB~IWPwynkoL*fZT^<}9%+e-7v`o=Lbe|?}_Rg!2(6$bfFWa6N{%|LuOdW9R
z`l{0Qggztra*inC!Gk3WwVEyASK|y@{c^u+8_X?51_vLMA$_fw=@F_^sUMr1<9`8R
zcaCteJ7pqtS&Y<>4vJ@svL|}K?0OerKfa7*7S?rHDqb3Y+WG4)A->yLCpaR=_nlqq
zScBjGp2pj=Zq@BZBr$mHG(XGVaTqCG?;5A?-|Oq5MziIIZAL#Q?<ozjau?xn$G9t!
zx-wvi5lOPT-X}daVe{>}(Ge*R7<9JvQ4b3ri3^JINiKNn1&-WBqLhe;h>5-!U!64h
z9qbCPK)}Oh4`!|UyrPN`1jj+0SS3#AQ3p@gVD}2%l2Y71JP)U8<X~(?L<d|zbBTjh
zaM_dWkdV--Y)A*kyDlZ2hC%!Ir{8T15+%5d2%nL>-M8Z5R29Cw!6@Jlo6Q_S7Vyw(
zd`C)Xne^>=gE)4O74-nE6#av9cmA-ZzA-3nJ7^~QG+0@!R#>v)_m+5QKIw|T@$rov
zo^N3%{odI*qsc}i!|9DDC~tp~oBJ#;Zw#<Ux0fpWAUR;*0|`RbHQ36khkX(vR(U3h
zlOoXu!Ddz;yxx^c8Ik{5Q^1uNU`vY^eXV*5DrCqj?nP_8E;B%3v~<Knx-Z<VS3!`_
zv^UIk!;EpG|K(w+*)(RorG$h86K?^fqt1^cm%Wvm+NMJtz9GzSrNJUk9dc(V4ME-i
zr>(8{C1&@6vn8Pb?ToYQ_;T<Oh8WV+l1GxrvOR3{z?+y#c{Me)h<XsttMmj&HV#yU
z>S^;_aqN!^tsqVn3jt?zB)PC;`Yxn+Y!-ZLp!KCgYGk^>ybq|DPiDzd&oW`V$CuGN
zw>9-SwDfG{)`#12TXZ~BcdV>HeGUhcPMP=6p+l+(`8lsK0^h!VeNK#8D9)R1s%e_o
znEqlU*ss%Pv4{#Q;B%#tYR=K$F$}mof)*<t$<LE6NFHEaP?k;alDj(;Xe<a?O<wo&
zB7zy3n;l>g(PydhlS-&Fl_{C5z7ltXVM+#6)~@skTs@1dzUrRYp^>4A4%2HdZdOIT
zN-qJo#o;kKrnn??mrQ#1;Zgm3-kG)UBcEj?gY-GTS)L;1_IbLqj^LIy=wpiBy;Go&
zLLd_x)Ib!3bQ|dI^@5e2c^SVQ9d`;1RAHV-_~vE6JmmJs-P_B|_jU9aM_A}11Zl^f
zdh5EwEQ2Fe*6waPkke^NvK<*5EJs69;g^&#azkmO_4U17-Klx^<<@8Y#aJim#Efo)
zyH&=Xdd6b@b~@R*b+_OK{NTEVM$2ePUxetfVoCDzVftMvBDgRcLe){h0_`;qauU(l
z*LtlbHB65}BLO&R7aZF(|IxgwH3nMc*&^!_Tn<aACQ3woDYhOWV}RuA#*oyHYYG+&
zL3%Tp=0c_SFCK!y=Blqc`zFTg7??|uzWwcMV{|O1tu-a_<_K#rkFZ3ZRx?(P(O+Wf
zEt~Ps(3l-fR-JP_#>Y%2bfb*?k2DX=c{mI#J7PA1q3{a4ugzqmQl-bnh=*`NAJlfm
zhSpTq;Ip$Qkk5YW+6#n8^&2^|yIYusgB?rhIME0aayFlr>dh|DQP?{=*;#633V0N?
z!Q@<#><2i|?&bbhQ5Hgyhtn^HFV;v5m%BmYF|1WrL*o!+_LT#a{6u3Lr#p<)B|`-H
z!4oifb95(&KYsk!urrRuB#D=5<i?Zp#V56rv$s`tcX#KlX=UPH(i8nu1PZto*&0%n
zt7>X%Ye)6l|7<Joyz%jt;*a?*9=BqJY|e|rSYI20>}e#q084_mv@oAhW?gH2IfGY7
zoalGN=E_lU7ARdM-qq(qej=Ev>6mg6G4++p0F5j#(8V#-#8-!{H&L@kHTC_)>~Wv=
z&SM$xb9ViqC_g{dlBp1}W)`{DxT3CjHpHyST_9OE!YRD$j<9#<n$*g?P;v=MBEiSP
zL*f+8gr>QXKxmlKFaGL)Pl{529T$>TkGo-0rMGk+)4evtZfp3BDMsga`$R(iGasQ!
zNRqVwSOjUdYh_?9@(9xlh^ajKvg8yKlX+V)6W$E7?1NnfX5@V3@qMJLVZR>MNigUW
zkO$2a|8=#gx<zpP)4zUGOVcrP%{2<oTom2)^<QZgcTLWXj0_ov<G{XwThIPVq)MkJ
zL5apljB=0fWmJ?0&sfeHjJp}n*3Y|u88%P3bvC3?HH}LK*VxeUUX}P=J2Wb^&7|#L
zm!<mqzUB@RN$OxuA7swuB4g$&<$TRqSLkpaAJRu~OY_Sg1eLN9yqLV*Pa3TQsVkql
z332?IDb=B{TxR)z0TlH01DFYg_wYJh**V)ttHNidHM_)2uO)~`-cA;mcU)XyiEAS{
zPr0d%KW+<L%2^jOa{aWicCnzokXRfl$bYswQ#C~|yR`U-j6T7<Xs%8o_aOrx%EwZC
zCl&xf+l9_;(=$9#b%z7Q3^9pyeW^s2^98p`!1{wtRawoTY#v<$9nEEbh%;%+@qcf>
zRP_GHg-5b6U6c7$BSMwnkJ%VLUNph$SeyFdBqvpBr7QJarWyz4+TwL`t!jJY7qgWw
z!%oM5X*&(F&BUZGlgU--CuJ7aRqrv-x2^OT{cmP1ONW^naRz<9GX`2kzsD$Xyq-6v
zg5KzDKV2|Jf$SKc)l;Vd02}u6Vu2nk^KW8z|Ew&SeZhFgZYn@}^|VnpllV$Y+w*kH
zT%mGk%LyJg{PO&4Fub*vps!QNUtL|(jK5jpb|bMqBCPOcW!}3G9EI?wqsx(DN7ae&
ziGB^EdQnuw!Pn_fR+-zxK5%5VwJWUCQW|B9gL5s%igJe_fmD6i;i;PY!m}L{dk@*m
z8?4Nx%|8b7i2y)xwt)M_v-!s$jq?+0&orYXWCR3^x?f7zQ7vFv2u(M?&pshWwG7C1
z{H>re(8*?{=Dde52g;!C`-+q-*bnp<FtGKRE!pmai7Lvb9M|>6V!<dJzBmwgJJ0bU
z;PS$|*RL(NiU{Q>$K9A2UFT`Wrz-_K4-XHIRiRM7;39r5VuQ`(Mt(0V9@gqZk2#9N
zSn=;M7z=-J(~YCT*%E@MY}j*#zzSRwfDIZGkHTd=wyRuDj8QtJcb+O1yQ$nJ*u8UF
zg^72SmLQV5VG1oED(oftJ}`NI*9MqD-ON|>#>x{A5{wOH%+5Lj1n{lr1f=Gi5Av|D
zQH=6CWavEaQ}d{Rad~F@y~$>a($>YrAHQ~O;3Jx1<8NF4uxx(s&^fuBUFK=Pu^1=b
z1t-h6jEW%cgNW>;+e2<{ZU|G<*gbAI7cE2eTMf8Gs>&4}<T;_ozd39gTj;3<M^i*{
zCT7gN860|@M&yUJ3weJCSgmP<{knWr1jn|QMWFU}8%{I#GZrhgwCq}$2Y&kahqfCC
zCgW>TlA13*(m8up`hx=r3U|~6WW>o|=d+!LTC!QY2nM{nsCq5iMlD~4x3hn$%<Z*m
zvPYF#9aX()Gs(<t8WLC9bX{Ca)GL>x$gVi$HFlTzm#lceY?cRp6t4BI2~~oWw|32>
z*@xn=Sa5D#<NNU*<bfOnqjVj|j3IhtQ5+j~VCyb15&8VBVCe<Gx@LT+W{N-5xN$~A
z={ukROGG5Mr7h_WA-_$MQYiADj^V_QnzE8tf*YeT0Y`e`i{5dAeuTNDz#vfB#i;$q
zTM23oB@hTDza5#1nuri|2dw@!tIvJ=ssf01WkKuC<?#vW<(}sUbMi@AN&(*v=jQC~
zhclmbq8^|M%$&U317P=JL(#U!-uUSIssE)>NoNASZL#;Yhl%e}r)_|+6k_1vW2sKz
z?cr|+8f<fW&Q~IZZ*)Tli8;!8CaCg>b#@^a^P#DZ@qPBsT#W7E;I3q1grJilWrs?j
z4QANyUP%P-;sf3{-EWw>8ytE3NqA|jC(+awyk2F2xpkh{aIHs%!U%4?I#H-K!nQKj
zxsX%11xn%KLji#YGg+NG+bsk@)NCew;%1@Cpr^ZA*ZeYNd~{h-G=q5M6O<gQR4zj_
zVv$y;54(VjtHsQU``Qmqw%>Xoh|I%7_qA3xz(Lv0kvn#*u;QUow)pFsKZn!p2s#5;
zo#ob#@l~)^R!xH7#=Dma`>LLW>TAZk;9G?F13-g!F5!NxnYN5QT}DtMK%nqEVDGn>
zjU7I(%i+$~PI|L*ctFot<DJ99!<A6j6Ia#N`^eTg-^8IbXLfjXz}JS@Tim%$A>$#f
z#<w+oS&CKuBU7R;YfL6lL_Tl5A{3uRj9_EBZW{IeEQCXu^@R_@j+IKlub0$>h2a3u
zsDvEcg5=!X?D=0D0na@A<Ft0yE6zwQVz>Zqc6@opSgR7|<KI+EY+We=6D$b$cZS5N
zuWLO$>t${t4?Z|%q`tP+?_sF^ZBtTpi}^sIX*f%6uOJWexjP5q!unL}6CtZj(L!dv
z=Qm4SG!@fQS37&1YZm;xSi%NgSx4O>uD<Qr-BoR{QNV4qULi2qJUl|(pJ+?M8w}Nk
z(=}+Ir8maBM|qa;*`CY+PtuZ45r@>ffhUZpx@xRm9V`Yihjza_^b;HLRi=c%;2q0z
z)ug0QpiH8lVj-=%AKNGxi1W3*wYI2iU>)qKBVUe{!yO2y^EfZnyWHA!{Z^h<@M0|l
z6$agode_1>GJQRb78VkUQv@OWKmn8y!jwhzpfwc?ZQrnoDf!1@eC}yGIZ1-$@Xf#Y
z9?W5$bLEig9sywmw`29l{eY1d7IV+ObykDtZl@;d5elEXYmGFla3BLB1C*&}odBgp
z=oA@$p}*Y_iG#v(=7@MeCgtiLk8KJL-UV?(*w==@AkxOhAqlfZv5Tc}Js{9<LHB!*
zl_Nw!2(P6|R@Qyozk*7R%n?`Cs*_@^>6q4u2A`a(%Lx^-O#^dL;v2Ec6@G2m52yLT
z_WCC-=vgN6-pfXAWO5D#*{sM7J<Qx>lF~?9HvaFFNE@ecP`sVFVs`7wHZAi}S>uxV
z`S~^zd~I#J&$ZqH2QQ*46r)=9gvqXOuom2q3FmQmi(-J}Irq7VE)*|YKjO$9!9XlI
zFlA8d570PTqrZ5)s0h(+luP(Zj+WRzjKE5vcR3Dzb}=f=E$J}PV>cIn{7p-!a>4GT
zMRElsz67P0qx&u0DV!tJ7xn%pq1sgiRinO8+e3+t&;WqbdTado-AS~PYYvC$8jLsD
zq4b&LTzpJ`G_W}vq}58RLie0nIa7rG9yUwNOt}yh<mLPIT`Hl19BnQ^7`NuWw3Y{v
zT{9loy2f{Eo)<T{C!rK=z;BDbfB(HMOjy*40)0|6Ha30*XVmp`0nk-Ny0}Wu&N*AO
znRn`gNf=lTR#OcCLI9s@>k)#{22Foyo<b%fgwRb&>}aHrn|~!e8qBj+lrL`@;ZR2f
z3!Xm%GS6i8UtC6pb85C10&Dm(DwJhSVd59p+8IB5K<%#m8v{8870Duf4GBiWgM;#5
zI}W;i$zSaT4|P(rY;n<BiKFJQdf|L&tO^z1L_eohNkE9YHU!4$BVPS#0MyP_nwz(s
z)MNHLo%-R+E_aGCuX{<A?krB4d5YF^od`1s0G?-lnI)HW7R+OlaieFK`@)3p%u@ZT
zK8+P^_>G!01?*7x1vF6Tl=?NwTLwl9t`wZh`4@~(`lFd93TuO*oOlCr`aUgs_Ousr
z9=wONXlw@YH?UjEp$dFd!Y+Hv21(CCF_Bsn2ZOBLN-$<6Mr{nD(l+&gdTHW2i1y)&
z44GC%C!q@GeU(sZI5UNQr6hZ|a<K3S!dW1mtil&E=Mk!SuS(YD^}nL?R)qW&?Uu9a
z*JmS$Y@=3Mz_j*GZkaUMwr1GKy#BYWGwlb}<Jt~|TI|22avM-dlHQUc@^ElAVrE5J
z5a#sr`&(Jl=k3<AIP_m^O|%yZEJ0O*_&38J;S4zn6-wO+%Kv}5<IRiz|D=H$Xf-?_
z=>ebsr&E`?gaIzQ&NnJ4hsqr!K-iN$!Vv`p<Gsbsr>OY^sO!MeQ1|_h@GVC`Y%@(Y
zi8QiIIaHnv0c$u^A)o-E|BgLWU-DopX?*|XEvVo~)@5gu5tjk4cyna#Z;l-{vVElE
z+yl{<%7Xbr70>BpN){JAs(6=7E_8f&PPga+H#c%7!6i1Xu0u6t0Lb7#1@+0JcWIKy
zwHM4t1t*8oxnY?Z43Kv5Z7d6Cd}A1;&M%S&qDPC(iK98ef!d~zm#43f4Sft2@NeP^
zGa{_E8R^Zi&3yUW2^CHuf)Y4+Fsn#$51pV=-qh>>+C=em7{5=H$1!$pi0F+UtzYM<
z`m$X~-hHVkRwb5Up*LG=9{xKj?RqQRX<%%osWTLxqBP|{pnB4VNMfukUXnQ+?=N!(
z+)JtwgkMcVRCN#hgQmHou^|8Db}~3I_*1dG)#}NJ+gkVGJfdf;N(?)Ssi!ZM87@cP
zn;GwGtK`E)MC?0I2NwQ~(@+*FwI4fAU70IeYmT`*H!Q=7D>71(w;+f*4nL2t>Mv6Q
z6SA8Xo|;F>=%75xSHeV5+etgzZ9|~|C1v1)vH6d{2LnoNRcxdtF6p>FYGbqHEAfo}
zIX3xH=~`+Dk3XjrKR5SOG5PZwVUj5jTOk-qp#^kfp_Xr<wR;Y0*ZiJ*4l&g7^19*=
zuZG*s{?lj~-wjjS{uQi`t(vruyL)5O>Cx-^(LoMkq>Vlls%;iWf$m?U0bKFF#;1P(
z{DH%TBP_K|c7Zz?x*cS@-8&}HcY(#SS#)CAO`C@x&B!%;ZuyOoc^<0zO?x=EFR=$=
zv@yS|^vpfoj9d$T?!zZDZ+dH-h5eudRNtNxXF7J7vL>D>DqCYX-G8a`#r|WI>#}WI
zrj0#tn#)oZOHBbsPi#ed`xG4m2@169=0C5?!}Xu{Q!9VKyX?E{7`VtSk4~roV|j54
z0MK(uUU50dO_j|r?zFiD{?UIah<1Bm&z53bDt&T-_H-^6nl+QX{FHv|G;Q7)TU6Hx
zS;s(s#mzx-t!=$j;vh$C%mLa<`Drh0@Q25YZarqRBn+&|!Tw9)dueO7S*HclAi(46
zXpfJcqt=_kTnX3U`c>N6*#5kJ1+J^nuFq|SpafVmi(|C45u?rOlRd0W4%6l^M_p-)
z5bd{{F({cfOmP;Pwmpz5eR5xdHq1IX+SYbrr@8c=(YAJkS}p{`w}j!RYz-g3HB8L|
z9I=VC)fsKydhH=to$;;L@^8KNSpTK=t=SrF&5C(H$J1*djsqKs#OKFIJNMEAc>mUV
zUn_m`Ck{fJH%`4Fm!BfZfOzyN%`9JdGR<}28g04oTcUL80LRn!Tg!5IYka$((*Ns3
z8($Fh7!Ewp561DDcKemrTThpD+<!-jCL3b3F{Lq-K4}o%ddg<OtasLwAMT{yFLVtR
zyBRNc(H7@{2lZ>1D~C8;10hQ(%W_I`SC=<!tv3swK_remrN6hf^)(sV+onBW%x;vt
zF^u$QR%}=Qr3cou73qqijae^pn(Ktz=9uqpJw00GAji}DGy`F=^>mCj%tes)bPG<}
zTQSOTJ)L&_XB=B_wExoR8`|7Ex0Xup#WWYjf;JpWrA@)|<d<{YFHTPrxE$(Qq2wf&
z<gN%G+9FKQ<T-EwCTqL32odbTn`8`K4p0AQ4;QPI(ma#8r1|A0<(mW3{V{j!zWw8%
z$Ff)J+|_^){fj)##7^F^k2z!EktKwgSe5an1i7a-t@9-{Q*;iQMmb#XhOqEuRNF<e
zKh<lzrD=d?QcL*s-LcoT>Gq@vyVhLcyDUuUuC*_gwT6^fCw5Nu;F{?PL9egI4a8*&
zR7vPu#b+<1Dphy`Rojzrdi>^L7ea~FpvNhJ)k6z@|B}2h9Ssk1_HXLt1M1;!*uIP#
zwi1jfdSqushZ3`7hA0hp-9ybL>ZzF<Fri;}>3qP{3_F^1WC}WLxGlKr7kxbOLL|h3
z{apL1jDp)9{HR=juOPh#UjgA&*!=Ggw$avgxa-(frX=~Ih-7=<iVugi2A_v^@wu^@
zMs6Wu0e@w<-8Emai8niQ*+d>&AaAr9RYYhX6M!NG>)}4mgYl}JCXSDE;DzOr^j1F2
z{1T+T{!;$;Fr;~h)$ZA6aQ>FN<ya}`sS<>uDA@<3&r1|Npbz`&eVgieKP2Zj;KL<z
zmY<6nPcAbP$)BR!qvlUOeEE!*`QpREzt;9)vD><eBWD?T2gVCid_pEPTh>+r-JcjW
zl&nF27YBf0b`{p;UJk;o9VL@bGDK}F^KHgr&)5K#=_;P`zmJz-3+De<b(CfhF*Lco
z@0YWWQPF}S{E+q8=kKJS)%NDX_|-ZHDey<E%9lS^Y&62f@ZG1^qR$zT;FWmq_;Ai*
z2ZDxa)cB*jE8d3$JsR<L;>`L&rkeBJaU<j%T!mibj_KT3l?OsJ`Bu%`0>8344<@F6
zz=N7=)TPPL4Hy59aeb>xk$=i@y9AZE8-k=(R><g$M7nC~x_qu5XJBl7)h8vO#wsC=
zJimBUZJv<{5M7Xpw`yG{Wy5Q3{vQ_k1x?Q*dKX6}9mm^uj}0j?e>1mlI0yS^<P&uz
zfIRUd^`zTBZ<AmEYlL9N@@hLcNznsPLDXtKy;i*LlN)_GA+)ycw$|b$?Q_l#m78u_
z<lH*jGRglE_`5ngi;u7|@6fi(gm7wQcXXeXNx90IyIxjV=1E%thOVEvxr;eUj(>2!
z^SBNi?gVTbJpY0dxy`5V%jjE?EOOu}g2-ITgkk>+g|V6L#Ni8_#;GMFq@X6XOZh{4
z@o&X4$4M67w5uR1!ciEvAgnM{rGYenb>ftN#C{Nb9ZV7IrJz~+7fi9-DuaJy;k-p-
z`W@%uutEdSS;3J;m-CAs$CexM1E03Z88xubE96Ezo^aJ)D@?Sn4cBJvTZ#*QUk)&^
zrO*-{KI1Jz7DTIU>9yZ`p6zJg^7xFPYeSl1>ZRJZiVSS5H+c+>0{(Mf8{E#?=dfVv
z_i-PSTJg~A?R+Z@B>0GWP;%FwAWKn&zoCO>!5SV~rcU22Z~e2WJpEwPU+-N;`dHfZ
zr!!9xJ*@q>Ze5Qm6;4d#U8xy2wrh36n;TfS2zoeHuh=w1_s@iE-<KfrD7V;hxytL5
zW!vpXX`RRS4p+c`3gxYjhRzsO<vuK~2)jDa6!zZu>Ai_eusvu**N#dYD{=e&^<{8y
z^PnvV6J|Lzj%K6BbAQUJibehO-E29pqv87c@V#5^x-GFJ*xl+~a;nlBS+N3I@$*Pm
z1tUf6FDJ@*^w?MXm3aqTJ%RF*fo*S41Tm1Myx>KjSa`bCbZUKVKxB?+oq2~-Z~8V;
zD@CYnFn{A*Go-qq^BnsIxBOi58GWLL_b#-`n<y0>1`N|foeRL})m@=w(ZnMbcOlI+
zKeTY>ns>=YhO;&bD`M89NTpFil}}1UKYSheM!wedEe1pr;+xb{)*dLf$@c@R_HCtm
z(J}1%_oG9cn%{SKvD-9gbrt)cSf6j@1zsFX=Zj2%fSx_}st$``;wuBEdosi#wHGZ4
zR7}cS>H6AVR>hJz5^#khuLXR~hreC5b^vR`u<=?Y*TTPpvHNv;O0?1?-MJ@;?>?yC
zbJhb9vcX$h)$Ni<(ak+;wO(5*Xg6D-`j$vimk!iNi#OS8yM)D#=Bw137)V5HqV4lz
zwA!5bCjI`;W=fpS_nq_Ym5MAsvSN=kSwG4w=m{aKRAphY3C`l}1kE(_CgbcomjeFY
zDFc~LyT60A!rh!uz$Ff;y`_}mfmi8xJV^cd)_Q~QtDi=~m53j2E+O4UOGy|Ng;CAS
z`Is1gvjpwCzHtwa8v+}w&_Qo37~A*5asItbIY?D}SrWts4evVbHXYWo2o1T3`z?Y!
zmG>1}HXj>;sP1}!u`Sd!fN{-WtZu^JtWvwO_|EQzPBmHERF6QXXNrN?mTi5#ID?NB
zf4xjmxKnxd+d=gJyi$M<`cH*N^*P92cft`^+Pcxx?XPgz$RC99mmD+Fv;EswMsjG~
zWQQf&@lDhIGw~I1`9S|?IHc9;HP05#A(J`Tu`}0Wc16b6ca3F1b<o+)o>)S*s>~a9
z2&{c<{%n*v<@WEX8*Y|Q)=(5F#uLRl67Fh(WGaIHuUd^Y5$TN&!C~{ctuAf)$h6Em
zf;>Zl=wgAv&C5Z2G_Xy>!m>Ppw;a>%)bjrwz~^ol)`eVmz_~Y}9O|HbyamH{zd8|?
z-FVL6T=ajRKmFzQQp`mBg(KV+Dr_RS2*F;m&y%-B#7j@SOd<7q%c5G^Qh5`kjgJ4i
zDIcQ^L9p2O?U~N4MO%d3OSwqSJZ0qiCGbfX`R_)4;dP@jdx^#L<Nhg`Q%Y^>&ylds
zGUj?LTQ0Dr-uHDOb{1AtbuQOcD(14LIgknBoSXO{n)j!*zN;gC+3^oUb2?-#n|gMz
z;IdBaoRWyHv-faZd^!IZ3>3hbcB_k19TRf|cfGd*Ex1%aC!b-Fhh0D-s0p-{*k{XG
zD)aW<%INVY5n|N*Px6Mgid9{-H37mBWcBb$Tp2RMc$Mv5IZmN9ASmZ6t4KfC_@rBL
zXJyPVVZDWmX3eV;H`%$v!BijwCAwDRgP7xh^`ex<jsq0iFj}y+E`j1#fl<Ehy`d#8
zyA0HY4FvV3zvfoUBw+zN#8vT-+eEsuOZ>w6)F$B&anDkp9|dZ3z1>!7C1F>yoMiuj
zFKh_JAe-fz?^@Kd-l~Y!+8xP^yZWn{&y9G>ndsfJRsVJ*H1_{-X4A#VYGwU2oR;i-
zU;?v`>%;u!mjMErx|WPqRIuVxk3RY{LaY%}cxdvDsh+TRmst%lk_8Exq;oUpK!R<&
zNPF#L5G+Hmn>NF~wmNQp3DPN7oyWU0?68ln;69^rBLq!fX<;Jz4pC;_urNw96y8lt
zWlvfvIqe>QbN`Wp#V(g+1|UYHDN1T){pQ#ZsF)(SI-y0kR11}+A)a?5{8C2W(_Ys0
z3IG9)G^Md+hENM#gsuNA#&n$#@nSr}Tt?5}gRs|7n^tAU#hMAi_-#O%b>TKv-5v{4
ztUZD{=2IHBcZ#g_>DNmzn>L}~z?Mz$^*_qti#_c01B>x|G*qB*9Y7U&Hrfxc5o3f(
zzoT7K*&3LJDOWHo`zgl7jZykXv@cyhP&n+l2Ev6c7mHVyvS)B1oW{S(cB#01#=WnG
zrSoRwJcRxW4Y$8%an6mGzxd&uS8jj4?tKq9a2dfF<OWBNF4(z$n~2on+27Sci)!>L
ze%4{NOyx~PqQs}Xyf+kQSTH<d7!whda$kKW1GS;=SXkoQ4$Yr_U~@O+qS;PDMnxz+
zL;Yc7*0jhaIT}?->v?BQx&?*a*G6)f)`{k}R3&QmKBY4S!*6MC3FSA)4<LUq?wWId
zs7aGOH^={onq~6%{(DG)ARESMU~i0I9qK{^p9eQ-2o<xd#=upK$_cHnztd*tm%L42
zGmw%lUN4_hhlARC6GP+L{A9)l?NdLV>CdkF0EQmDuChSKy{ll~Q=I!?B&Mna7Mf4G
z_rty8LX{e-yXaqAow1xVzx6%-j}&nS=gI>3aq=GC*2u2Th16W99(Dy_-vEGqLv#_8
zVHkDJN1dd$r=pV$qXpz#Hb7|Gtb}O68s+mug<PS>y<cte{C8|<+~4tHA=yvzk$j@R
z$Dhe5E~>k&YYpZdn?j8X#fV)aCcZupHwbX%6)QvxxC@at9PfWF^0h<$%4fVYvki(r
zz(;h9O5@zdKU2IJ@+9XBGPyYbIs_LU-^Y0&Nv&ZPPbT7bF0D+*Fy^jwFqJ8p`f@He
z6T@8f^hs--jtfL{2@M|H`jpd{nm;1UAhEgGWD90NBbc~s+Vnkc%FF)-JMPcsX3;cs
z;WWxQ0cR%_X;bxWeiq=mPLEi+{r*XHf%W{)gc=as{5fJ*imjDdprs39AH~^cIJEx|
zsQbssJy=5E{f&>ywd-pWy79<~A^UY*uW+eb%BW~L&P&cTPDi+^^pMXHsj2dZ!G@ia
zV}fgcbqydJ4Ty=YX9Ss0q!>0}KE!cl^_VU(BUf@TqlM6*mP8;@zSpVRjj`hH7}Bfd
z#)X^E=f0}qTVaZMW47vL5U4y%(<>}CZ_z6(CLv*n{U|kf72ndx0}Gv<o8`jGGlM?C
z{PD_)u47PL0*-!c2%PkTg>-Na5=KQ}Yc0KUuL7(QG7ax~RVG{mYavvbyKZkE78N7L
zFGeT@2?<P3alEM<e!<vPvfxMh>E2rhLO9zPT#?JG=QB8r_gIe*@Ba*eVAVf7k-Y<N
zy%srx1l?iBEqC%6z(&0hwY(uOAK~=<6=Vnxnv=ZTAN4$2s7t<cHl%u2x}yBi1_!cu
zms|R@4=Wzr!@$CTNRCr?X9Q<_ZDj9VY}$I+3vs*eQ|~((*}+|li>~zH^7tsl;h;*L
z<y&OFY+DFK<O$|haH`f;T{^L)XRWga!Vlzze5dcq%ah-gBum?afixOu-_810?!(OZ
zDo`0bQ15u59(#X>oL7~gZxs+CaT}WR6mv*8SZAs|rRRL~=W06?fjWn-FR61A$t6*?
zYT}uCxI|#05QA*9px0*n{SXuE^S5X%yWCQ*0unMXCXo)tfHt!7-h+%HP~khbKDv6w
z1{mZ<BH5ju(|!J4<<bS4$*1jkD}<fq5(CkxCawX-oUbZuWR?|w2L`{)>*xXR-^4_@
zbKH4qTF(VAklX(paablCS5L_8?L<cDxP@r8qNl@;lI@1zKUmvbkiY?)6J7RvVi+a0
z2nFpL6VS#aL`6uPOVa=k2;OXFLACmjsR0K>`7fYYukvBMe*h)ZLG`t=i8SIf@C~Fm
z5utp&A%?5cUsQbT@!O$xCMDBfi$Q@>H2%tZTQZZKS_Przmt9_by6GQ!e`wqB6e|eu
zJ<QB^b846t|6KI;QigJs8_&ClvPfX}42PYxDzhE>8t&4i{#(zTvr{7gv@-1bg|R&1
zcd<Sc-kkeTNI?4nc-ClGukE7aH_)*ch_nXlD}rAW01<@1=Lo~|4KSHw{Lb0zGS1zt
zs~hSd;j9bl$t~M3=q=V!u3Y$V-nQg~g9Ay);?W(fC`GX<-UCJ9=qSXNu}GW@q$U0_
zdJf$eMYy@^BxmM@_x5FnrXLUZdYIF0)B_Ga77|{ufwz(XPul&%KE}(>cg)nFb+|1B
zp>JT~&6<sJo*{Y?f{HgTE#a8>&+n0mJy@lNRkB`{3xn_{wHcybB$7bAT(r2a`?&KN
zGzjbKC9z3aK_Vs3r7}VgBtkJjZ|<mV>f3|hF4Jl)(QriF=kre0BTtU_0xMwWgU8X+
zL)G3kjZgV2udQkY09OJVst7?9?RZUA_5VF1J@j^hECCh%<9+w&0xM9Z8-LM!2730A
zft&ikUoq7IiSGu=JiMO)rIy&}1{T9=b`e72Uf!-CjuE?hA1jF=;evV<a|3@54fo%X
zq++q_^@9qycO`;%i5sjVNqS_f9fhs=@3V6sCV9d01_VIU;85z})MO8-eMc@xI!`qT
ztpaxEEChxBu$q_fdCp1z-XZ+D<Phw(Atb7<Z=`zE6F^;|3*V<+QkdRNg4o5O!k$+6
zEjHx9FR6{m>G`-!NVKG~;FuCylV1P^^v5RaF)J~!<=5I?cwZ3KUoar@uBxubXeqL=
zZAGdj9>T}=8yoeGbIBrz#WVeu380DXH-T1ZHC5FW9dm0$m!aqZWv)&^Vp%zKJ6)Qd
zMxReHl-9;TAvs*o?*C$=L-zRJ<;F+fGRu%J%gY~?7#J;wngpG~jf>2qiOFK0<3UnP
z=;KiNE@ZUeJP*XL$tk#e+sT}pR;xu_<K3aa4ZUOS&(1-X6XMnwaQrcC@nUZ!;&V14
z%{W~^>(7@u0YA~5u#!FhmX?A04YEOr;$rsYpYB@X75x$Xtyt%YWagq~O~kX=gEpB|
z&y;v5n4#j2qYx&;5h*S?u#-$o2#EqTfF7F^$P!&a!`}}a(5Yl>azul;oXGiTbCkM5
zeh`agdCjL@KrI&XWTs^YqI;5^jRANa6&?(XRoV8T4J*J7O-xct7M+{oD37MgqIR%@
ze-NftSY89_`QiQ~n14sKeiX5VhnpKxr3XO}XeR%TJdIDb*Mh7iH}_(P5fMFF3-o7x
z77o$;Lpy@RM=PR}Ej$Z#mCpHHYWc8TX{tzfu~<Lr;t0$c>L7mJ%Du<=_Y-=*$Ua$|
zTv!2+4drb?{M1Z*w8GXZK<lXx*fR)l(MT^L|If{hPL(N#QbAq=Hx1-vB?d77L%A(l
zyEVn-_!!m5(rrzH`hK8;x005dSN@-!F8+@Mc>@!oiG639bEWi6!~Q$H-XxLywr#yT
zxc&uRk(1gQ6-KYEK+7fF;Q}TS@qmRy92>F=FBo|ZQIr7Kbg|Pd74ppw8m13-dR(ET
z8g)k>0p)xj%7Gs^(yBD>v(sXY2VM}U7;e0)!lzfL%Y(7ElLlW9v`<mPA%PcYcSNBe
za)Odoji+NT<wY@bQt)xgg35N$WYY7L^JebAgs260%S7gp4vMIjR}?Z0L8pQutL=q=
zrG(>UxZ<@co0tIAf}`STESdr;0-Q3=x-{E*|K!%l<TqI$HHY7ml0i+6PFIj(46Z|m
zkK0=7iWZKhMoGH433WL#1@2c7Lx)WG*h9<EiCc3=cJI&N18&uL-R-F8-K`^g|M76y
zvmr0`rWF2xmL^F6CJHA10N8_xNn5ZPP!xY+0dbhabvOb196(o}9+#=eUVfcdR%hVg
zn)q{(zB^HZ8;1QX!Ti+fQZ8P?md9&&*|X6QfzFu(aIoOQoo$QzKfi^X0$aQ<J11jZ
zfefg_cQGrNpR#(YYD<Y)8egIrhVvW@1KfGg))Q%T7G2jgqz6z<0qX=JwGn<cVdnuR
z1SP0NA675V7a*9&=&@lGe%{_SI3O5c8={CNkatlX(S-o=mh0`tcX$Dv%pz5@4`TJ*
z5s$-;^7E3@xD(8to)62kcIoKty9Z?N*bvZoeqcyXwJr3MHxheN+5n4O5#R)CV=u--
z-FL06<n#hm+SshgIhZ6N-<t`+^lafs1q3&TGCA}3xO43P7h7Kf4rTYhuT>jfm4whj
zSwdwi+1iMR?7PZ~K`4xUYtu%`8nR^HC;M(nMb^R0nCwZm8EXvLf1hX2+xPnapX+^H
z%`o$v=bX>^Ecbn%bBrmKj&llg2(_eFXyKOW-5(0%KxU6EQZH0<FJ~!yGDVVJQbR;2
zm)u#(%2%jT!8aYK$mg;18E$gNA(@h0>2E*xhj#0cL(6g*$^mkw&q84hzTT`!>Ue+Y
z^=Qv~6=*G=wq}?7zUY9QTm{9l$ma|Dt6QFMv6(3z>i&7k*w6zi9J8MI`J6s(4)R#5
z9(?ml&U;Rt02Buz0oOINqqh&qCMJwMu1qBdA!L|;zpjstp;u>Hw)tJ`#};fVY(!}R
zFzCNaP21-<y5JNATA!@1gM@$kx>uMiDMX*@PVBG5r<)-+xO~|kO1p$xSR_nW_jVcC
zpT!gcukZrWx@Wu9mM`pq@~oDs<z>W@wmKJqAiSM>zF)aB7IyYtM`AI#Yot-i`w~1&
z+s^ki+me#CyN0xHCfTZUk9J#^-Rzd4FG!{x2$3tBb7#humjR7wP}09Szgp>fXKG*P
z9&3r8NS(xOESJ<WhEyo$0(<b^?bA!c5c_@_hVHu4uo|+YR_zKot{uLAO^7sU|DR^V
z>GJe}M%=+bc8T2fkJ%j%W`7j7)JU-32C!;xim|hM#Rbedk03><m*snblmkf3sxNNr
zF~`8x_YuT7;HKX9*g_$~g^(X)cCAjExr)|$j+LAvNDX@Y3B3=Lw+JHzFgRoxY?sI*
zs3HWzg0~Q5Nuknm06*9*t#lmPKQ$3I_)A<6<eXu@e5yfpB2n56uMs?mx{?ferO|{q
zEKGr_FH&1gQ##M{LUjoTWo?@bI{ErPbF2W+1gQ%d_S|k7Wznm^nVhM*w@qf(k4SDK
z7LVDUWAL=#yvRRaBtSCt20J|ER8;&lt9wVF)C{(eZFA-b4C`A)CKL4d%x~}uqE!J@
zbm8Ks*wuqD>tngpz&uspf3O7b{xb^zEG3g9lc5akGBjgE(pm5@us4&8%Sc3yEzCo<
z>40zS7Z>~Zhe$hJ+r~BYfJ|xtE=&4uw|!x!i|$xBQ;$i?ryoFr+#daEb|!lYp8AKM
zhkf1eN~Cuo)5Rx#ApZytOPmt|&w^lh_}GEvUN;~lo^y;>q_x-p-+J3@#Bl28v`^g*
z+3Qg<GBIyuM3y^kvLby9p-5|XUSy;hH(m3F%$4j4Kv*=o+nL-ZJmd}2N%Vmw(oM7V
z7K%_wOKr-A%Isd<w<#p$_NO9n#PMhwBs{@f8w3g&05Y8v(H{s&h7*Yl&B=Cl#bgmO
z2N0+o7-xiaMgqo}!l>zC8Mc0;2yU3p&Xl~P3-Jv}(E<IviV*|^x6I|p$?n{e>vU)+
zK9O6Zv!?*M`!UYu(l#P6Ut`H_)moDN&|5e9ybSWeg;J#2EzL6pS{c1L4UenLY!a`B
zTnlU#K|Dz#SAT=Rs`F<Dfl+&W^~(iYm%cS5Aa#Srri;8;^uV}tKpH9NtAFQ;Cb#X3
zCOX5t**NK0A*BVRLUP2@GRD>YVe~lU-i<quS&S-@F>)m{v1cYZpTYps(I7ohxBYzo
zfD7)0jrU#H7^{O+oJC|jr}KoqC<ziOgzaEEQiTwYztCLZSHV5piHf!Nv^1;!4RF8O
zliieHWPR@n)*Yenkl<A|mTMSg6s5ajsajpkAH6QyLY?~)PapVQw6;xx<Xnog16pR=
zTKR<G9FJKSfzjFY-1j(zAuq_hMBB6>P7FFiNc?tlhw#xKz_wcW2Z9R=t_+8MVmtB`
zfEHCoJqcY1U+7XM??nLl^C!U71)p94)=j7bQ@Bd99rB+VW9nub2=IJ@RH!g*@ZE<y
z1%~G?2Am^~Z_K{`(gy=;mpe9?I6R<fmi~cI2-kl6g79dkd(>?hscg^%52J@84J-{)
zIejy6kyvco_qQAlqfZlx77raI`w0U7)%A1Yz4P1`bDOXt6t)A&VEykwLW6+991P5b
z1>ky-G-+fCV6P&|{MyKt9^L4lRP!QZ=lX;8zzsT|n}C|;O!ac)H!s+A71!ed%<1-m
zLUTx6BuBo{Gq6{753PKusBDH6Izt2xQV+0uK&#^puJ(8P+zEFhFvc==xL^-(+W>PQ
zR;sF5m4#4!V9S=78H~)80L%iWOLQ(dP*5@7w%|X-x*PjVcxWvn9<E#8DFJ5QFsgKn
zAY^7#o|b6bWVnI}b9rQA9bOh$I?+{OJV@N{;cbVrn7{{(KO;)md3%&K^qT_S>pui(
z3#2ZXD>VWTYFlh0*~gavx9V?T8?rc*hXB3c4v!v1P*0?YIM`)>cSeNV8Q-gErbFD}
ziwN3a7XOi8|KZi>3Vssz-4R%QKhRehCIBXqzO0$1^)S{axwC0ZHf2maygGl@Ktg*=
zIEeEKQhEcFgO*~}LE?ks(CX@Fx0ex-y1Y7dg6rx(%#6>tL^RZ|UHSOp^V@9oV?_k9
z@C?j1l0l(<M4@n|MHp+SjlRu@QDG9+;hAZ4qgX-X$)wiMNWM1)nir;j&<$=1mGApH
z!Bk`EdDiHVu$+<fcu`bQ^xUGS>;#UoESul#`ODy4jY-72-@RQ4E|NTi-=rn_Si3VO
zz0UZn8G&n+8+3A<(gp{G__~mPn!8MAb)4}=Jzu1ElXs-HEf4t=tB)^gk1XgKE(s1F
zcTGEtHK6FuovhG~77i*9;^EW7E>d3@R2;sbIpO}H-=_R2<?Xe4$;{?x(H~R-cTAeI
zt7hrm4?;c5@9o(x(Dn~R?nFm8X_|p-fwz8<6J)y+3T$=bPs`q&i93|l*+v#UUoeJZ
z=a%y-H^A-TPYS;6rF|o76U){;f(}bF_pZ%~Tg_bl!cf{CWEsv2%`kh?ot*Q@E_hm{
zv{I!#jdQV5z4cuM7wI@>M@Gbp7(AR#@^4;y`ci{EzEV7(%mn|1Y_@TCI@I0`j0$-x
z>EM3x=KY5~9UBdwSFBW9KThSTbvtfM|B~w@I&0RpBdVI!!7)?T&z(2^Qn7|wvi3+%
zsZ_m*v3q2t9S_lcGG7WFfc;ig*9$l0d5J4|2XLp2gPl;AN~!mXTM}-kFTL%ipFN0K
zqz)VYSs)9yEyp*I*NQ!)5xxt<ieB3zs<R!1dA+In1#M1c-I2@H(iQo4?*H&{43upz
zQMD`Tbj7NoIPlaV$0m=8LU?woJND+7Nv@32Uv8Q{R#HV1Mk5||XZWmdW{n=>JM~pe
zHpV+%Cq|QFbL67UO)Y<uH&QkI6+bq8NO$$2xc5`P?_IsK<{h93akCquH>5$z%wQZv
zOdMvB9?&t#A56`&mhOhOT)?55k|asx=I&VZS7P#1GH$hx+QIwD*Q-=f*Huls?AI0N
z5&Z$t)R)(7&xe%_{aSLYQB1y9``$v8-%Vn%QYpKQ<j=BQ;R~vD_*rrZ`H|(d?J^0N
z7rE{)kh{_@)$JRe3SP$Tkt>^b#(#s`!nkUVe<@eS6xdPd4JvOvwi=&W^|~w()p+np
zyJ3_ReR7P7X50K7Oq<U{|D0-n@%>LHWy<b|P_q3iWfq_@xj#)BG{H=gOR`B$X`x=>
zOM8rmjHKQy1d!0)xsFk!*b>PuyP~(2t<>5kTX&aB4@kxw6U76T$vKp_8Fk{G5xID=
zm&5;<n9+7xqcv83{%>0{zngEDk>(<EGxC~LzV4i?2ew7&{ZYFj!`RWT<S!XvZw8-K
zf3}8^uxhf%gKB0`)p2Lk3Z}~P-)Nk~wx6R}qouOB*d)tvupiPbaeM0c0jpiHykOMJ
zPnfh^dp)?9yTxL}+~Z+DNp+RB5>YYBL=}8jeCP|o(Tl^*W#U5tL)6yXZKaM1<>T(Z
z>@e8sy5JG11f{%j{I&W6sChpY_n!kb6}vvz3Ag0jL#f;ewfUAa@q%4{4XQz&DRe_~
zhrHmc8IDp&H+|OR0;Z|z=AGWt{VEO`6Vh?IY0TMXwQq|%YQ+gL(~*j&jD7CIP5eo+
zBCvb1D(7fVZ>h<I-BrFk*`Ww0<g-@e?WT=lXo*b0FO;xEb4pLzl%-14%^r#wrh!lL
z^6zoKt$|H}yk!((e$a&)La-H!bGFfZpFp7Sv*<%4t+E4(l)_{KqamZn>FVi$?d*9?
zmL6M8JkTThNke7bcKFK7asRa<6<Xd*_-(MU0vukd$F|>*XpEIm6J?bdVxC0ohySe(
z!PvGl`|}wRg_M99REyHJ_<%{>eQT<@?-zsMjDD+g_c!~e3$w!+AAAoe%S0rLXgIq|
z3xXeTcX^TjGxIjG38lTUz5lhg+2&}?{d@NtWm(RQA4v0-S%{Q<fq3M1r*p`}q?CBf
z3ytgJOj5tPna94(J+85wo$(U2&RV=#JG7t4`2afGzhXs!`gAz^tFR3E`|w8%xl2m!
zBd=MlPi{3Z5GuOPnE+pDeK+>P^GadmAb(7nS1(W0cu`TVpz{Y+ZTH!a1bdZ!N);v}
zddr`Ilu!HHG+Fp|F=xXRR+KFJQMa2>S$DIaTKA&s<B#wAwmeA(w<0rJx5rGF`fnuo
zxX{I=cxu*}!?{>~dA(mM;~XA=T8(t?c#!_H&vvUnmZ{e=k3EHc2{V~ctAE*P2Pq0C
z+=j>Cf*>HYhK~C{w}{vZt@iZF<$NHBzdvq0zr1g^im6&_=;2$nzUE30cPi#be+baa
z%^fi8?Wr>vqgw~lV5|gEB8Y1#0=%H3W4PaFf$vV}FL1x`z>ZrYS!3=xyUY!WiI1A-
z3AqupZb?t~QRH{J7tVMHmVuK?(V&q0?%z1=evACpz~?1=`jU(4)Pnx9`wWr1Z72Ew
z*U7ytM~rr2y=sP4^k2gm8LU+08jKv)pP_0+V7fb>1f=P>st3tl>#!@Y97}#JUP(L2
zg4UXlzzumKyp-pCv~?ThU0E^;CNsKgJ{mf2M5~&gQ%&xc5kBLZ+O}=m`N3WeWpVC8
zjhhZw!b9ISkH)n<n+dKv8}$whiXDd{b-cSiCdJ>-(~<H0d*H&J)?ch)Z2dPy9^T@e
z*qv7-Jlz2ggG5~q#^Y>5;NRmq9u=PMo&%f9cH)`2-S{h}z^zu{94?Xad!&D1_8T?;
zcT1fhf5mABMvGMT!{g*Nb4p?Royc?ZN;2+qPUf+=w)+Y6Xg(^3x$)PqnO;mNH<j%t
zk))(8cWDG`T81rN=1TI6iigO>N4Z#-i?b9QBb=s=aAmy;`$%SP>87~X1$&%Ui|%yM
z8JdmeRRS$tcAGn`e~=%k(i`|C(nl=c?nppW=F%_SL_glTZS}-f)-*6W9k*!T!4>UY
zkF{qjU&VdjMcK1+S6F&Wd-hqF<_`IGhGUEmU$)s+bQo%rg{3aRn_-@QyrhE%Su`n}
zY+E3t4gNe~LuEtmS2;TBs1uId8ul`{A^IoTP<Fi3Kn+Tq9um>p*sF<7%s^>TBU5-S
z@DctXt*POgw`}26;<oF#jovWDW<GOsOAgE@15;b{+Iqsc1Bh4gt)~1MxL6`$s&lK)
z+_+BUJpx@v=3B@%{v2`{==3qnv#@S!s38YI)6|_Nt}1C*cie-o6687i4SADx#od^n
z$>R)4d?(59y3rzU9sO3{4YM}&bhrqsz{C$;<2sz~_3<kM``EYA#r5Qh+aw<lip-eT
z_O|YuP>cJAPF-YvaWTU*mXCMrT1!goSo52fB7=1{9!_2nfTuaC#4bB?JmcEh^A;o`
zQw#O`m#~S(;9R?ux4<Q~UQ2$85o6y4Iy&;Xxq*5qpCh`KO)>Z>O*RLM(h!%apk2Fn
zX9>e*1;O{s6t9*33fF@uNgP;z4EcmU6`VRepOOYVX~x=4W^@IhtoIe*KY5bynA?Hc
zou+b5)VQv;F%Q`_Se?O*Rirjzq&3Yyudd9smh3=Bck1%o%Mcl!%V}0M1yi3Ib$}>Y
zy8<3`j<t2M`kYW=cgOz&PiwgTc&WUVI;?bYeI+5W7$9EC$!CUpmjv1)#Wkk~y=lGQ
zx`_^zD{N9nGIx2`6)qCa@lOLz<drC%cXd!Vt&w<SX_15O<~bi99~r6T3o?=uMGN@Y
z@HCt79n|Nex6tcqWV+_K<=)<vY(jp2?vqEuBqq6=e@p>%0^bX&sxC%1%3`Kj9qP-g
zaX8(N7lfQbV=+sfUIYD?hLO}R&in-({w(%G*3#1E=(5R6Y4@wjUxYigx+&Oxx(I(8
zOB~oj7g-Dk4{eNOznWZz8*W))3;j&d#%5o1sJqbZ2g(btcFJ}OD=iRzDy=UojC*}d
ze#ZwvyE*e{<yDjM`tWOBa*5h;n+>;q#gQz~X>erRZtqHo`S}jQ(YTVX@p`G)>4&*Z
z18=hLnO0_Mj#v)t$g9WBYwLvXp+o&Jc{A<5Qa;0()j9btCTh;`$|ILnk>jca>hi)@
zi~hOz^>I;;DKD3{?a9>^)Lk{s&OE8qnjs>CF?lVMiC79;gfrj+1Q7Fi8<DNiyW5&A
zuKD|6DF#^A;M;zuaer%i60~sGgLE$N<)bDQ)*~0`d<X7GL~$(<y~xd#(JM1U=E|z)
zvxf$kb%ORY_b5f5H%_pTa#mk-X3V&Tgooy<=kTIVlg*Mk;b7d~3oi988MY5KS(*MK
zDWKGYMvokcq|WrOZ-a+A3iFDOl(e*@@#&$rccrx>dIu*QDu%ke<Z0{hs2x3C#UvGl
z?wN@Z#V0YoY+EYhrn^~kI>Da!wD{HnDZFfED5-v+t`3>WNy(f=rDDiK26R<m-&&)Q
zq=UE@+Q=j~d5t>kopncI1wM~ls@ou&H81rnQ6GuW=bAo}wVCD6{;MRIZ0u<|LWaWv
za;AaYM_)~Og>@9|9Pj{p8CY6g7C$+w!0@8thJJf{U42<<e{Zz<_3JN*$oADD%j3ky
zh_BP0CG_L75I^?8=KlTrWG7X{$6JenuvqNI+}sTry?QzrsJUk>FU;)Z`ByskcUciz
z$-lrY3r*X5haS4+toihm99DkF(Sew5zB>bU=l}4}-a{w1U3*z*n~88&T6<w=7#ii;
zRvXECY0rfG5XeFtNouTv!!$C+Rxc+H!^6Jtna<cxIP*cwMS@cPYj>9pZBy+(AA)~;
z*bOw8E8oeJA%c_#R!v}b$N-@pTzvTOUmJ@R+e_7R`Z~1DzW?7(eU*(p29Htwtt~U6
z!-(@XGDkmbmX(#Y<~VRWvK}WgIjptk?~lR1<5pm)$cM!D@70Gyent+C9uXpDMg-D&
z@`cgBP)c0brsR^K-v8qJ`sY)9z+O(3xbpWVEZ)57izOl(!@MZ4W<#+L{Tv(t_n)z@
z$olVw>WoO4tBwsBJr129FDr{o(73ee>4I8t4D<8bs=Jun+^pM=#<6Ft)qaFMNNOC3
zjy=uAzAqypICiGk?(>!ef%3JD;E=CIsUQuht!)$yc(~b65AlAfCq_X5)4zBUHcDHe
zUk|lncbh~<q@bQYEgS1-V#>;KP2+0)O~@(j{5u~N-k`k70K?0Kh^u1{PqKc=pF_U<
zCu^~)8N{sI_DFr?6pqvro0l+W0;Z>TJIy=1ixf{VJWcz11|nn)NO{3xT3j$Q0{K4s
ze1EI}q@cTY?kaRYzwxb5J_6A2;Z>~ZP4*&GOBWLI<Yj*J_a6h#%MW4AEc=6TTt?))
z{@Uj4bnmZ{YsG|23NF9U6>1@raWzBHQD>2-Z>$p$Q)%xvRSNm(Mr1*5VvW#xe%I#b
zlkZJu>_9?A-hoYxs++*C&X?8&P9Qk}^xVm#Qjanm7n_nQT}BC~lVVf^r+c6ZL)BD@
zi1~DsyK@{pBzrfN$V>Zc+7C3cEaH-PWv7^(HxV2nKqusgjHL$b<6_s-rq)(yZQ7s3
zC3jJSV?9`M9b=S8x#$U0XZB^hCzO^QlOx9iIGv-2hX3{P;k5N^7IjwHnW<Py{U%z8
z_AMVaLwY0b_$wGm?Jk+!R-Hh)Kz}GNOL%R68sx8h5w}(CHJ^(#)7QNTM>=%40k^*3
zOkVTA-u;=16EVV&_*!}6J|-$-2Bd@S76zQlvU+0Zi#mnCzB1}*x1;?iAGASlq9X@F
z08%kC<zV}Ril|qDX*|bLg`o|f-<%J<mtM69m2knGZaD0O{01os+*Pq$Ug(;}BES+<
z0tiw+?%$}UK=O>Fl^Al@uP-$VC#}j9qv27+k2~i>jWkm{p_b7@STrPY^g~%32awHl
zX&WFV?2BJHtH1TsWowII4UY}|X`gR0oS)=-X8!kYJy-y@exc|dY<{TH-#>Dqu3{xP
zx^o7x!0affk%Jh=h-06sk>uMvubq5H4N7f6IisWj4xJFU#zNy~9fg87m^rJcWu`dY
ztLpEkdQ?fhs9pcqEi7?|?)oR$GwL=wU}RsVI{&j>cBYOO{|#Phn8Z6<m4367m!a;_
zkcnvexF!=O<0?Xp;VD^Kj&$``%oSymE={Kh&fPYN9<3R3ro5ZSUt?hEFl?6@gl@B{
zo7N0P%XYq@bPKgQ*^+DX&zu(uvlv;lkE%{EQ*`tC&-JK3`m3~{OXuys<7d@X;x(j!
zxwb?W1sK34G75@+g_@UV&=d6)Z&E_+HN|YE4$;cCp2gvbQV%E3tnn{Um=DGesocUs
z(MY}@yQ%@z^H+;Jeu`(|UKgKq)!5Zf#Z7>y@Z;2ooj7a~jC@eyZ^Mb!AKKUa(S;|*
z_{0zEYXFpjpFSq_D5~jCNl7<(U}LK)WNftRS^3Ya_5&8?Zq)BwMjebSQgH-iP~Ii*
z<=l>%ZDMnz52**2S9Ut4RKbuC+*zwaxwFqaJ_KM`#yoxysf-}v^YE`DdUB0MC`jX^
zhFS+Xx!L-eAKIVJTK<?4_0zdbF!RX0xs>FopPds~M464`kS=a&L#2VVC$0|ZZ)7eS
zk!(ucjlzEuEghmA+4`ZNYx#DoD74IZ!tQmXJ84UD$(-zhN7fk9Re*^kmq2USK7I^>
z)+GC5d&P>(dReO}&@b%l`)vHzP$JdG=sRFH$y3zV%Qm(+<c72h)df>@;{{!6KA1Ox
z9VJW45yiNn%&aK8;%;P`yZ9Y!Z<y$Ko4)H`_V7KwiHR7-(bEC;P|!9^#@*<pN?M~-
zGX1JQlV@+4%>?f?rmy+@QX)WZnVjc9f|M-_@Q`X(fX!Ii{@jc%<O}I96p@a=lyc^J
zs8lSJX6-|H0aIZjvcjTY=KyO^uE4s^T~H#kwRC4hUVQMt+}>QWI~FZ#c;v!I@yb=9
z^F@)>Tgr!*Ec4pMz$2Mg_LdnYrmY~hEn<gN+|;;ytwNSI0wD9W@r?b`1eDa@Pyfm(
zsmv5DwY0qQY}@nUf5uOnN_+AtLEW9DrCYH9`Z`BD5|w=?zonTa-%D|hw*I$!!}j37
zMSgau@5lvFva3&~q~b5RrVSy<)!OBn@jti#>KpWy_5AL70<=|^M6WBl6z+Z|OK0|m
zA?4*k&lgrpJv9^I^GiR(5pPXWUSDDb--VLe(8VKP9H#-m8(_Z*3{OWfsg(Hr&0W|o
z3ezDOy{w_f`I+-}4|{gx6=lChBQPqAQOlLnBh4mI#m^4M7t2^Zv06%yeR#56a;=f@
zlbz|W@|TWBDOf>Gt1B+5-czoj$3P+~tCdo?XGf-vF=t19(E=*nR%H}*OrB5aS(zLW
ztTZBf{ySc^nu4GZr{4Vc^jfsi?axh8xjTxiM4&1*UrAR6utKVUqLo!znQcLT$(|wL
znRtMxv8DB$u^8rVWUQ-^4jowr8=_5!sBCP`_1QnUl5cgu#&SUTeqV!uUU{hzv~_1r
zTN}UzrGS7`pIt+S*!stm&ij)9zCo}_>b*bBiDUkoTZq$vLO-e+0elI|V2Y~!0BqSL
zHPP^N%iKy#3sn)kSip-X+vR>c1y4z>w3S(#`~3Mfl>6USm5PS@^%nrNq|bZtzIiQp
zzQju&s*bm2+X^(yYH$8XG4&cGdI8qhyp$wj)7{220|0Ja#T#8R8tj`4;NEEy0Q{hS
zn&p-~Oga~STJH9wP(kkcwq$TyF_{f@7SaYnX{Q~#75j<t6+*_MMy2ZM0Kjb_At5RU
zK*(0TP;*&i^CL*N5EQX+Oql?F6A4PCbtFs!Wz}WoGXD2XvSf1HZ3vhwU`;x+e_W_<
z@}H&ta3fy>ml`2C(SUujM%uSnFBWxXB~4&$Bg^bZWeN<2LZ;?8FyMR)il`4AFs6m$
zocQ119O@X(&iW7A?c&c?>xzRJDp}3D#SdvV?UG0TjpM6R5Tn(|x%(D+PctUgz~X81
zT6hR?KhyYzgMFVMm{5U%<tSA$vKmRhRzA@yXW0X=3$e3BOzv>5PYI>-j)bOU^^dtu
z!*-%*yhqkJ)5hH(<;VPu)uGtO0We<x0|q-&TCjh53b0^t020AG6Z=yFDV=7kZI()%
zs(lyIX3LlWhV(`P2Hg1cAeV=^A7pHlYVS*gN>vX|<>hLC4!<G+9ukhnxPzSMm4R%U
ze1ipp9B>x-!)wtAy!hLEr4a7IUbak6ZTVI*Gow?q<H&Lr<r>3JmYkwo3iX6(7IpmL
zm1@Q^)eHA8xLdVvro~UixSV3hXd}<8cw^d_cJ9)Fu?vM9!^+!fG*zm7t(rp~JCgD5
z*-ch~ykbSn@m-J6v`)#pk4J$tN#O6Fz)UxJexhg8j%t>09}Q(2FtM~ZC&7RULVpNq
z_piQ;fjmUPX$PbwccaH4-xCvZb8}Pf@sT$jYtKM)$mRne6rhKdy|IhYE{WrIHYw2V
z>1(98qixGBAFQw;lY=Iq;=Ku$ufnkJ8xGQwZukP4Gy<69Fl$k7!sv86QWP*Ic_(D<
zZr^3amdVB3&C;Hf^5EeEmge#wSQNX3y=})6AGSGHN7Z`}tgNSl0vsT(ox;~p$8vlq
zt_wSrTH{jhTeJO>3f{3iJ?Ch!J+`PY5ad8&Hvq7K%6Nj$%Jexgi4Jx2`O2zAXG$lp
zl9^&}I^ae1ErkKJYKu-jctd=N^dgGJVO;&4Rf=-~(u9Twaz-^C2Ww<88EO<a?;b*R
z>i~gfeP@EQPx4JQNpTjFQvjJ+q97;zYVWVDnnfS8jjO~h2x{U#6}PbLJ(TH7SNdR6
z>bY%pMQ22D!%w&!&_7X;J<C|^$k!Gz1kY%*{jH9voGEv|GW#Ccs~?)-@VBFp=R_VH
z@<v*q&27I!t3=tEVO}c6dMd!P@+$S$1hiDFF3ROTA*j|^(WwSw8k3!03d$8H*@WK>
zc*>EEZ*r=bsk=DVlcyUfx11T{?pf;hr3Z!JFo0PkisjKx2S8rHg%SX#WPv@66O&Br
zy-6!61D-;jnR!k`KzywD;+V6Lk4+9&w8Z1d!*tj39rKA9*r=4+x$7Z32oB(oY^g^(
zH<3<^|8EBt$5`BLw>&<k8@fKrGr+WI#W?%x)y2-<(0q|ALHV8|x6xyJ?VucqJZl=I
zI;Z+vw`)>QsTG0SiaKrAAh70t|A$AR6H_Q*oeuGmH4JhBX0~F1L>iD9I%7ON+zns^
z>>V$L@LfKtdO}JDr+gTV={FGs)#PN2J%WNlBb|**dB^Y{HZ5nZN&h0Z{ymk{cdryo
z>;^9BLd3)>BoKg@+oK~OJ~PkHOaoAgjJB(~KcE}FO7gzg@sdU1ibB-0w(QRJt#Zg$
z|3iMEZ+(+LLxmw3Yn%xLK^6jKh@FWlx)aLNy(}kJ1pAQj5gR|*1@QoOdc(vdW(_rw
z50>9pNQ{h6>NeYpohS(UFQcWBA$lUQWW0FZ*_gZC6qrXEka8>p>COGbvJ{vB@@b<-
zK9W0ljTB!dBW6d#5^42b^YF&HBIJvG4Vudgd5pJjqLYv2@2Sm*PRN1=$VXKBFQl0m
z=3kEWu3S4xmX2`W0)Wo{xl&^?*YIu=tKOy~N_Da|tF)qC-uUkzjC>^EGK^@(H9B7h
z!0~d|P9i{Q{B869eR1=SzZ>}9`*F;FC)xkKFMsUs35^ygcRYdIN%`4mOZQ($QTk^j
zM~ypOS6kasiiT~}zU7#)96X5ngRrWLY~8x`Y7q3W1t9P0*_YCKuLeDMU|{eEvZs>|
zg`noE@wuiZTuRP$@+Or+QuA7z6_WhtO+-Z6vwbJn`w0ZC&5wxcOVbCXUEgzg|L)Vk
zbXIzm9S|`YB^InVI<tSG*C+^yd}Ix}I3s=5Tm(P!J$_75Qcb^osf-o1>&zM4)gXuI
zUq4lFslk>Di;}um@4hD*(&G0uS|c)zN^+~*o_u;|8RO>XYrx4j?-t@b*jZ#x3iMer
zGdl!J0_nM2Kac@_rd=WNzfHdZP!OJgHq5xT*;j)FtvuGAPzJ_A*UVRvn@gQ)Q=_)e
zisXCXOaSFjuc_>s4~74=qh&>pmIr%FyS^GPUY0<xZ!cQRQ$GO%D9>^(`nqbAges*i
z3%@vlwI`oC$i<ZnXkW&)J7<)4GeH+T`9&QtUEje`-iwG)3kjM{8U~JN>kf`1fDFt_
z&gowLr<=3+?tn>ys8o{Q)}ma5hhPr{Cnh6q6Z7(r>a?qfoogm>U=!-!Ssq?WW<9SG
z0?Ps(zF<>j%}`<Wl<W6^$gm2s+frQ1G5t++EN{-cWFJ?JgpGvne2c>_4TvaTzaGY8
z+n#%+yA-YI;E-EYRh2&D-_X#Y+#MAbmOME*Y0&8i0B5A6y-5<C$%P9SBIdL$yK}X~
zrS;U+4~N%l58&35Re9>tu-`$1?kK8R$pT(XC;TCM?&{<wA%l`{JB(TMSE|lDh)3Oh
z>FJ`?8p_D)bbJ$CoW=g)ZiC9(p<$I3Rc|<&v6yjopRxt&GYxsV)uwIg9!C1@3*(=a
zguFZ+J5RJ{*v8tCDt}_A)$zJ(8`q!+NQZ9&>$TWLky)Dj<PLqy!p)5d71UKOZ4H=w
zt;lub;>8Dvf}3E++#UTfV2pTnIB3M6$Szvq&bOPH%$%HArYpa~p9chJYiWfjaz;c%
zxc_{u=uhFbT9_G$6t@YJT^K&5`u6ONAhBCjTN7SBdbHK7r|<4?*+eBiQ7JeC>|DsO
z@J%U?U2ml^x6e{ekH>_}u|wy)7M!}>hN4UR{5VwZmj^8h0_T#f8a2~lgR!a)6LL6v
z$bIr7y}09`%KXBD_2TSUq^RY~sh$i>WqOWTO=PKr&K2`d523A*=NyxDFeXANc&i4r
zH>WOOuq&m^$5oV+Za6vRPpu5a`eYxu<OimZYktkF{9eC8z@c-w28-)f9vPHvoV~=>
z54xjP;A*pkYxYiuR~q%(%#vF*L9Sy_>y1bU00z+VIT9E1%>#wu8L4?lua8Xf0EMZ^
zo8YKqmVY~4d`L(3m*LTyeRZ>9rS65)m<kD#ESsGt9M1K2_R%0ND(UHDlTJ8dZgd3?
zAn(&^`87}<a5#o1%c!Jv|3yLESW&NCmoCq_bNcvXRZ$aGCT7?=l21yiW50WF;^W<{
z)>Jal8h-T{=Oh(vP~l#{@2mGOyk-}-4yjqHdc3>fZr?@KSXpD}0rv=-@bcafC+peK
z_8=IB;}I9Vucv74J8?baQ(yB4J|)9*C6s~5!oniV-LEwiXE#t6s-S*KKtQ>rrA6VD
z1Kf&hQ`P6sm+@yMBns<1HhL?bs~Z!_Q_@rd&PWvysx0BOCfm+Xz2z&)x32h}n!C-_
zcR@@5A}P0LsZtO@QYt+%13s%{P$>Oz2b1s{ImL(cEzb`5qC3uYSdWoiW`1kptma}W
z+~?<ZQ)@^jVF;s0qbO4EHD<z!9d-dzQ`6-itk_eHp$D!DTEX)sPsYJBR0n`oW1`2M
zB7~R0R4$}j*@A1k^5TG1)uWvbQqc;{Sx2vQ?|31|$JhL`Hdxh>L(+~gGlCD8f{qFe
z4%Qqjz0&t_=f2}_1}$+hS=`IRib<72PEw&kK^jSUm^)CJ0`MCk>U8!HcmW-l{6BvD
z@VBWB<hC#OCa0ySEQ;{)oywX6b7jMvP<f+1X7`-tHtFOw%>ayWp2-SIgqkx`n4UP(
zqv#_U0Faao6#e<Yc-xxf-hhG(@Y2+fhiScE(M`M_SD(_dJH(5XgBLp{eb!@ePZb!|
zHb`+qWL7gFrvd_pRLvy0P9+j{Nx|$E-#@XJPl=zOpUaVVc{+BL@Mz~gm~{L~3X?)-
z&S)?*GY4gFZ5zbJ+COUTaqVa5Ul|@ojeX0x1l$Ya4$yPmF5w+A?@z*_CYW>zDW4mo
zByGOEzZI02Wmsh07%9$v=HI6ZFAt?{p=UgJs|HPJ<Cm4KB#6J*>~`zcEiUTW=<5l2
zy%Y@AjvV&p%^STwx6phvMJG`Bx#M61zohh=prG5kY=w<W39jRc++K;YUJHC+<6w<Q
z?0I$Ml9=<T9-iIQdp@b<@u?FhYVvysX_|rs8>Odi*G&IMgQC7mUI0?77E`m2uWGJ9
zU8~~}00^Fe#^Th>zT~O=otirt;x8;xe59<e7f)O2z>*~Sgvq|aKwhPLpUlLM+NB~1
z*pb5@OtBGDPc0hWCde(jMJRMj#n-ORBjL%n8mVx#E~%@lCr!95Q%TpNMRv`wD5<Cr
zzP>&d8WCYdmUXS+ba_+S{iWJ{l~oxGLVB~uF~yh2?*%ihKKU`2Z{HE?HptfB5k&nA
zyCZxod;k8_6-7l3&V4SU-`+jp_Ab^K(lrRLnd-0M*i_vbGU{}YjV&!dU(Bp4Lsujr
zIZ$pz?~>o18#iypC9B0|!=zUZ0^epkdhGP+mSPgPRX+~9R07wUrO_F+2<AQkzR<zE
zBm^)+b{Z?7Zw>l_Ea7+6py;te@01S(0s)ba1tl`y`vm4l=eu1*QW7^TdzOFYI>Jsc
zJ*5A_N3bL5hhKYAIWKAa6`AZ}Qft#McX|jHRULiaWtLny)>$MdD{C^=Q4ky$80hKg
zNdT9M7uVO<56X5b6SVu_yD9k|H2o0c6J4Aa>@0dM8rRT3I2I@!Z)jKYCA9{w1iY#K
z0+nK!o>I(VU)~}%PR!5^#g!G8I1aI6qOYgGq|=5GAQ!+M2oeFujviIPKA)Iwes`&w
z0?9(JYX$f?vt^fFFVY(yh!6E+-ZYO2G29ayDXkQgPmc8o?i?$Gbf6iOV^@P#Bv-D}
z=ywpxGxT5s4~6nT@sJHkc^34Avbf!7DEEhzks+9=kZA))bLbg8U8-MD^q7>>uzH`&
z)YOy-{j{=Uqd3X6fjZt@MriWn{qp&<YlAHWG`W?jzzj6wz*rd^-#|1d<9YJwmJ`Pw
z1_olj6`n`Qu<%X`5(Hnp`hHJsO8w@QGoqpaq#HMGz)Y)d=aP0+hkqyI>{}C+#7oyv
zow&3T2ryKjZJ`JX5Po!^PAXOiuphvPm4c3z&4l<k`T$DhfnKe&53(uui${c<ZQr=2
zg$I>_)~n;2dgEWDK`tXv-P5DX1sPLx?ScuLrKrD5+vn0RB$2%q_CisOI)eq^sUxyQ
zlS?8qla6#m<ktUYFYll2q*;l=$C2`1UTRp`7Gy4&KVP1@i6k1b%S)#2le%;IYkR~J
z_@ES0zp`!HHut5e8db->zP^E;V3;hsV$U67^aAJdi%QitFo=XR2LwFrl$D>y$H%KU
zLdQ&{55nvSEIH>m_@)~1&R<{addIg36?OffcA(9{169jHK70$jP*dtXh)?Wm3Gywx
zOoC#dM6?I6;UwcN$b37NSnNDzfcJpd#o|4<J~`?D6Q0Sa4W22}WhEz>@16m)Gt$X5
zt<c}~X2_H~)J7K9y)}@mT2(~I@aC>D77|9$blKupaMJdjFJL<Yk9t!*9qWIZK~;;X
zC{tH@G8<;Nn%J^WysxdSj^R^i0WNd8ePOIMTovcKP|0TQr`>H=Bmr>`FiXX>p)+E~
zb<A!nX1Ekx#o&A_>x3)jrWOarMS(m>R()g8R|-H}q!<P36H$N?S!CjF1~sIrcsP1I
z$=EPA?6urV8lt|t{NyfXuD!XW+YTvNd6k%!$+F0yaO#&TWq$|or0L?uX~QExenqaU
z3lf#NMB~3{@T;{7Qdj!=rN+g{7xlPjq)~diN*o2tCt%a<GXbPbeY36YjEByulVv#1
zJBtNC)_apZB`HbUhWpEw2lx~<$*PCEy^9MJjLr1bjL}a_a*#Wms)h)RpB?M0uNeCL
zY@Z2c^@ZtDmFsdfhdm$osDpA;f~JoBI_iYl4+ui))5+^WiKHH56#86%$qmH{kYS>L
zT&mymT1f-^5{ro@3z#9L&^r#~o*Ad4`IHc8HbPBh=t;`k$BGWjr@@IR!zzfP_yER0
zV=$%&z)KKcHUq7tU{_RDHMD9)jEXF9z5ZA{F-8TC{HipITWdi&8bq<*1Vsgw-aeO|
zex9ugVn~EZh1-k!jMTG?=jFJ9P8cx1TCTnEH;P`;6jAH}nWKWep9=1<p=gC&{Mt5+
zViEvV#BB!0qyzTc+S(ct6cq0^Jvb6+lYROz1-zc3WL4{<M~~iAXXs+WoOrkXhU~yi
zS~tkk%Zr7T)v^I&RH89G*r<8o!u>+~-fYNY+rF9TVob6c8dO;J??=@J@g~m&1qUPf
ziR2TLot2f93nc7{c_fFNcRAuZ?$wGS>F%ywyLgO8hQDPSpQn!C6~RR*U%h(DnB(BV
zRLE$q2EDzW(h~4K9~e{GrPV!ZnZ5KO+qP_P#{Remb3i|eZ??Pw>;ce38Nh_*7Uf1|
zy8zw@(?q(BztkH9wj~pQ#)tYm%MJqNX$o|jYZo#<R6)WBP+|WKMWDXB&mF7OxK$l5
z|3=a|d9)R}eX_XHG_VrT2K%(3vyLr}=6)0hk--t57O5+3)TGK@jAE|_&TcB5H<WQq
z=9j~l)qr@uIK5v>&t(^t5>AA5*xm&mtkG!ZEvZ0E>%68jTP$(OEl*(787x`=GyKGl
zPTq@!xu<=tP><80fjk74JWE{LXnS6Lg#{!myY^)MJ~8m6I&$^s2P7@F?Udj>apGD~
zd_qD13HeLQSg&L_(B&#}s0;slz1-vAwaI?NLXc`A`SWg8llf;okf4A+sip)`oGERp
zQIhsL5SOC8x3lbIVj?|f5fr=k<8s1maq(F%Dp414auE3jo1$&rw%3IU7C;8Xz#*X`
zsGBV|{yK4>KHMWy4o%kTFFm^NxXL71bUnNI&Z*cb;XbT8H=^caf|zD1MckMOyb#e`
z+~CUnJVZX*^bjWyclpBvP{=CpJ_4B2;q%*fL^J~E>wYSLe#wh3u)3{)e@mB6A;SYK
zrevdx6KOvb$N0CBF_Ols0P?#}w|`+7KfUN#ctaPQifYs;?W{}LVLaRDw|Ni{HWuGC
z5vvymyi34geTW{2j#77Zp_KW|$z9AV<0KJx>D7wBm2u`aL3FIk^_Ey2td-O!Fe!1+
zb^0+KGU$_CE$Kg&5Q8x5llb#2&C>Eg`vIdhnwz2Ismz7Ww)e_N^?b9On!XAm^RyFq
zWrl+i+rbG|d#^%_UTHnG?zrhtS_sWW{09&TfB!uUY-c`aP_}H@qT0Qcm+k&X$P~y>
z1)kaL8RXym9a1lGm+>wQl2Oj>#~t}rngcRjP*x`A;77!&9zsrQ0Pl}fgoK1hN#C0I
zQd46CWoz|WNI-*+tDdPAwQLfT+Ie6s>0iFPP<6sEHncIZow>~T<dc{rj8{g{di^dY
zWv0-Zo|9l7%7ZA5fki7UO;o4{HX0#mC%l*A6`^E+en<y1jvSN)`qNsD1e8UKvg7ZG
z$7znz7tvP`PGcqCEt%2x%B||>`yVp`i>lxgS)vZ`bzMto76kIh*|#32afE;yrF*$X
zfq5r97LF^yf?jzTH0U#~*K09EAZiURJ>IhnDJz}Q<qKLs=2&ItPsZ^;R)A<rsa1q?
z$=NRu!E=VFP{$B{uCckHR!sl`PY&)!UrkUni;w7ht%lrUyw~*#$|n5Mlh{>!hC6#C
z#Iscf!tArw&#Ut#Yk)m%ObC2PrNRH4zEPQ7#ywxkWjvFSQ;JVox}0DG>Qhyl{S#Vq
zeNVW_^&(gTnV3=FPPLZ#{rw?3?As6Fp2v7+4w4RX*~rdyIYx?E1vx`DEP`Fqkejbn
z+rMvL0we+n(=j~M;g(OX-7vrob4QJL)|mhMFN&D14JY5N#G6#OkBpa1=-j!J33p`S
zwqL2=^N^lN*u{qzhjAQg;+hMe?dZfMlzW(XQMHvcEG&{whl77kP2~gpK;X!c3z{j{
zi8b6lnK;=+6*e}u(*Bp{ou(TlGwgdS2b}jK$9@G|4`6(9NwVwiL*0UPsy_9tscNNS
z4fg!IL@)lxUrSnu5c+Y*@BxyZSFWRB!MOdtj${pE4xf9AG6R)zfQ4)B82>iXPwX-K
zp&J`f`in|w(FHc3uA&CW4If1{G4v6me1{xe;~g(%^`&>{wPI(zZn3Me%j9%9!gy;y
zO|80kwQD&Ic%H_C*twQonYNRHJo^8_>I;P8A6^2T!LQ*3y)Zz=2b={PgqiP-g1ddZ
zYQ!>jg74H-z<m#Pb8rO1SR(C(Qk?+!8KRE-dqB@3S=)1nRo30y2M*{AvO}mr>O8+a
zZ1E&hp9+G<HNRP&G)Np;L+OmC=3WfG@aK?hay6bgWKZ^jvXMIZi79-++lm_EqA*aQ
z+vAv?Yf_shG^X-mdRFCmeM1AxzMz=~QCvtz+COU(Tb>F_87fW<u{B0c-wxi*d|+Em
zI-(sQZK|TVey?nV$V$F9MQ5t*^%~Z!RQ3;cR+M5aFT3Co8aKDeQujCdG&P%Eplc}I
zXQfe$s}=Ku+Z)jd<O83L@XAWhM_chT-nHWo?>)4ewT{gp^`;{0ew=nMQT$jIx-q6R
z=`p{yhMz^4Sn9anqg|H*zFc}8pgJ`f2QpqYnW?KK7c@5<k*{Amjky<?{dz3$D-Ndy
z)ij(|(u`Cz4<2kzN=h1m>`2nM6M~9>?6xl~(Gvh+scfo)5?f~S!xo+JbvG|&edS1%
zw^#g6(1?T#r3hqPrWe;z>*ewiavMiH_&oyphDkRfVh}stCgyT<`QOKL=!#^Ul8N)U
z#3-qq${HtX#96XAK$ZdCoius>lDOx0b%5!_dmPKUxk#)&*m$qm5iVQ*3I<y#gY$J>
za^N)-4?BTK1c?^96iEr*PY>-+x?ef+F+eWy4}%_g91NkEPI_TDAsInN&`{>^9X)yx
z9B1_sAPK|%x|goMJ^K#O!2ot~Wk}mk50bJBYuMK32io_aTVvLo4(MpPynGxce%$v9
z!*g~NyXD)))XA8aw&%6dt6@-y;}^q6q|DgoU^alqH(9L{zIPq?m^!bRiqP&1$3vjU
zb8kQ#Yem_S3y=)+iU0m~keTZbRjSIca|a!YuIke#bYIoB<zL}g0z_F}rRynp*WSLn
zsFBtr_Hz!2#3Tu8L7hx>SJz^q`T8iTD%^N_x9u$}!W{vVoQ@DHui~oNX4}jEHH((1
z?|kXX3ri4m=X=U`J-A!&F4t5L)(2$IiaLr6Mpi@CZ{3=?m|ku&J3s2M<-wQp2f{38
zRF4&a(uT{JA>3Z?9bki3OZPe->au(VA{heT>bYam>qRNBu82^-S$^yG?T8P;&Ntda
z)_A+&$)iW8&rg}1zGMJ~a?2p+N1f@L9Xog4SaWY#!t1LJQ4Wy?Pv7&ivF|g?T2wQC
zo9n(i2^RENpm!z#%NHqU8-vsvJGrxA{Yrg*B-k`U{X&i$k4UJ%-Du&SjuXf0^tk`|
zt1nrs_R*nkf@9v#!eWkQ3owDq1?ujs^`lKdyT=^wH001^XngS@4a@pw%YJ@T0&oO8
zL<&t<BV$S~xN_?vi1(0nT!^9qJ+H0cx<1bVJTU)@)Ki~eKAOo5p-pGL=lkARBG@}9
z?`j1wq+{_O1#|n1=uPE7l$KF|>p)hwFm;Px(X8&p^fyf)lN#2tjJI59fjB#~DvkZP
zGX3{$&@_x<W42DhK);7I1>o|;pk#ou8K}TX4SB~^>u#UQ15%7(nO41$wM3IVbNQPA
zB>gB*O(DGfc*_)$93g5(#QTzp0o{B*vYIJe(7I#e_-#76ztjoxTP{9*e+yZAWrYN5
ziU(HKy;;l-B7uT6BD^XGrBLmdv#w1AERTt(?sVpDyBdu~)_=k>RL^$9cGc-;rd}3k
ztI&)8_1X7bU?>|GN__{jj!EtJ80`lS8#ZNwUaq_pH|FfIb;{t0k?}EcD!COeCi`YV
z_3_;P$M``JFMR;5Gv%_}@vb<?BWkEH$;2If(L8WZ+=_Lw70Bka(>|nx{`Ejhe-1@}
zyNaECv_mlE-@7;gC|RSbC%l#_b>~9&P+|Rxh<K_li{xbnu>d)0Jif>8a{#iW3=%(N
zC9J`=?GZh(Anvm&A9xX1kq*K%3L>3s3NaQx&<4H<@jh*~%koJ3)ST_6$(2BAf&j5x
z!8-NYpQGOC=o<dw_Tnxay{w1UiPo%DH$cRxKELHl<`7~S{b?7z3y?mWOoVTzY212y
zODnq~p~kRsd*%+CN!(%Yy;qM@>4!<_iXKEt7eot|`NdIe_VxLESb-^?TLYG4ibzJl
z5<y1sU>D9P2wA8KDXD)BC?r8NW|J7x@z>aV*ay1ZjY~`~fdBHabg;=WY<atn2?M$)
z<9SdY7FNyOu!w717pcH3Jk7c$qH9B`@}55?3%(7!jE50Oy;K2CXchxug)VsY<PwnU
zaT)KJc*|@$C<{Jkq?=)9vKPoO#X;*s?1^f$&|J!Li5QGoo%Yl``##?t6dPey*=lpc
z)+CLnzXmj<>2Fb;FBw+OHAPOx19gVfyVSwF7c6@T@2f5aTXgFlqwEQIMue=;pd$JV
z)qgk}{6%DyLtw?3OQ2c$V&aqFe%XmM|8{y|VfX?7{KNNFA&pF(ibT}0saD_-{Uc%Q
zM;@w4)}osR?oCkCDg~k%2T%KeE@--VC`Z?V5Aw|gBi1a?ZJ-7ELtrACSihNorLT$A
zQY!(VbK5IxWKPi7Ul^M0S+VCiJD-wN$U?x&XjwZc`Vr+fQ}52F5Pp}C_5%jKahbz{
zk&S=*ZpY+2+7Y!msxcWvkX8dvGV(n??K0~DPXQwyUKr+W3T4jnIBD8uOmrCnKcS3c
zuQDcW57y`QeegzM3nuc8KD<k_oE0U5LU?u<{p_vVi_*K$Ho5h;;a3&QONPjTO|HHV
zVC>fztPkkMuIe8}T)Vo2u1?{vUn`wn<<SYY;yS^*y6ns?Voq1DtgPfd5gVPTVDFEi
zHI(n!UkV@gZ5JQ)Ok>_PIctOL*J*Cpl{(g<i(7T`PK#cCj!0yWce(4PMXy*RR1^`k
zM9{P>2OFeH2eGutttayEv`@w(<2Sutrjkuf=d5EP%@Gz2(c=W875C|ohE>=RI?L1c
zNzO7SvtrKM&FcrCFJ@ZNCR*Lx6S>MXq1dIlCs*#Q{%cmyR^K3<Fg3M0_LfUhTF22+
zpR`>5VJwViUZ;O<C)HMs_5_6OfBPjdc8#ZZfyJ;k?{2NS&(wYH%3MH2%|Q<juAVkM
zVg<5@6r|A^P@>ey#%66%WFo_=!UB7|33yh}^I-^<y8A4pAa`NlKC1-@z)$IZEsz#l
z6M2-7EV(NMgqXKsR+wz#`81lPx|peQkYJI=wulHxW$1%>luQ#xLwFwN@6ic-I&QtM
zLqX<PDark2o)j_<e94i^RrOqsa?d!DKR&#jUXU#)Xz261KZ<J_>+QNLdMusaZFQ4Z
zIaL(av_(C59kk!ND8mPfLXQ(}<j8Sl(lB9~WWm>cUBp1^0`^e9y+<<xgdNRyB1`?=
z``FuLj+;O+Cm2`aQ$R|q6=gt;V<61|>8MG9jgCt!h$R(f*+AnC`XJ??DJ;V_WSN@!
zKIQGrJpAHgdIeh^aoaEF6AHMCSGkltaT@w1C2j`uMOd4$QdKF6Kv}|^et7-axg>jx
zI!U;XU6h<s>ecYo8qG(`h~iG8EH=O$Xra8S;4bD_%06B|i9x=rO_Sp9mKUexPX&mY
zgY#UZPL_C&n@cFMGgS<X*KZGZ(veS!R?}g&<|eG5L24JZJcu1H_HxQ<L)1s(<%`~c
z_FgIJ`<OfKW!thhplq6}BsX$!Vq3V7+9_EQP*m$H8}y$3rT#{Ruq&UqNY`@&nI`0m
zKZec|3a+_^j>|ZRWwl-?TKN9`oqa{AFt9Mke)zR1sn&;`K#g<?DtjSheY`uBfF?O>
z>rpZg%?+#YPt+pod6`nV7<7r)g5{LES>NU>b1yT4J18%_YE2E-r1o(!aa)ei#tHes
zE+oagIbaK|yQ6?I>jx}3O6$9`u2nRZV^yCVN$q}TziNx#dEBPW`#Uq&o`Ozlb=9_x
zm0E?yXli10V3}%5#W7-2iw>|NsLNgI$h#6tG8aHUHKjNGaYQsED$0`DMkb8Qc+gfc
z!MLjZog5^<aY3kWG<)oD#&x@}VQ{5JQg<h#lrcBHJKHpNP^-V$*`Mvj5K^wAYZsY@
z3$9#Kaon;nNBouaqJn%F#k8|60iTSTZD8Y?5OSk%W)$gKUOx{iB^sQk9{4{ugVT9X
zZ)i6wZ5H7BN+=kwn3L3U4~Q<CeN%0wuuLG^x@A>5rNas6c+tF}sKFn8HDs!;Nr+6M
zL+_TCPdUiUM~(8Fy&mppV=3+i)_U%@c0|(~{zaxXJ<ju$-;x>)3lS?p6n@#6k@FQ!
z_dByVO-D6;t!xSHq2au74xU-S)NWj<yP?+6cQnyzt=vyrdGG0*bMe8BW1FbVv{4DS
z<8n@Dxp24s#54DWsgYefCg&Dbc<n1}%emz2{0+8kb3^yO>Pzq^A+()KTQEzH=67eo
z*|5{0m6*(-1ClN)n;WCCafAZ3^LTODl}c-wB597*sn<=VM#&|na?(k46b5eRgaZ{*
zVel3rX@YLZSMF8QLHF`baKJsdqIG7y9UQ0gf7$zxT8ngH&4urZmpD14h|fY^E>PXP
zc8EpS!CSTJOo3y*5VZrkV5EC>F$z>Af_X2&OHe;!QgpttI6%K7V^ZRW#(&=q_b&U6
z#t#{rs3QH~OWru>2YGS);Xg;3Pth`Pv{0!_BADf|W<-1iCgzI92nu%YFD!NY7T_QS
zYwOz@8brflv~Asny0u~5fX4})(&?M`DkY*;-hbcr*smj_;JRupkO_{aFc1TRI-wkg
zPUeCFC&BC|oWrbj@Oy@TSC@3f4Edt%JWo!QP2eF_{6oCuaElcaYN@zWfcp05GQF7D
z;9K?#4y38-f6hvS7a*}>-c02{#_47#s36&oWW&gep?&X;Ed(Ur`xiG}z<xM$CyWfQ
zlD>Ys!eQ0YR(;{4<$0%Hl8JfO$>$uz8WR@3KZ;$=?4UT0?KL?;)vcMvdKD0wd!UQa
z{jV;7V1?f+cT6;J+U@Sb9-%jKHNT~(b90iiBpIdJWD5PvM8>PzN0fbh99>kwQ5{!}
zAy4g5+Evg=#G2;wxDn<%;(3+l7vf@;8~cA1v<r0Ez{<vD=Z_Q}?sLfVh@JbZ_GtbI
zM-Y)uASuL$T_>(b2k``Oh}P}+hwEJAaa|qf$I%ps+*!s&wFd*aC95+IhY|;y+%<xn
zIwG>CrsmkDT~={8ppH?|q~PE4jQF$Qq&9C}$|yEyv>rkk+Sr_!ko(SD7bWB9S7SLj
zoX_uIZcZ7)uEe%w8rwIpGL?2*dJup^&+Zn9YV%rnHZm~Y&*bBY2X249=UJ(}M!D5E
ziAk;HEvt#d<LgD9L8-By8Kwp9mi^2s3K;s#5J*h?eV!P9#g~WwWF|T*T9o#D|6BCD
zzxe+tdgOzzAcckAz_+P=!2Z8~?vlCaN=aeq@%a8-GWk0qAIx_@&!Ev_sm@)JYdtad
zjQ6}Y<8W_L16>M8Snyn>y))wO5C($gxKni)Qldw=j#Rf+J-i}b4$>CTN4^9THuJ7E
zwD+K99#aIObN3*wrAuEe9kiq{XSB~Nc5Y`bNBC4<zdtATz^llU7az$l!>MARRcB@D
z^1)0kM7!u}yL#QIxrmH0OZWNQHk-`Gm#)+=uP$uK68`uqJY3hth82xHc?SAyz+}QE
zZ-lBlXan96X-6B+Nqm8EnO24$*lGWbOICd!e{5%Z-jYv0Az2MlMz+2W&!Ho!>4vlr
z5jXg^^9%-0{r&*WDaFoE_L-N<QXE1#p4Wk^1m_+wRh)AyOPHHMrDk?awcpYLhk4)s
z4!Q>-m-S@aLF75*eSHe7`P#kiR^fa=$^Yq^Q>PJjDwd0M_K>ag;PEfL`i}IpjCFF?
z-xUOM0-FuZA5c|65n3I{VdlS2uJ^`Z0piH4r0p6~m1QzMj1{_<Q59<cG1Quf(FxZ&
zp*%jFS)Zg7oT78^XeK{z>^|!v56-JI1?^&SKBi{n7Gv&#HdO|uW2Z?a)8gn{+QN<x
zK7WfNFF*Y!)dooh<-O33IZf8rdQEOvG}|v%`y9lSIqwWdf<pbj7BM;Q8B_%jHsQ~L
zn3u>)eCGVJ5Qaz95nQ{tjT~Rm77Nv{_4T3wWtW}WtSn1OSmkuS{pX<>^Bs54j>U+f
z(mg~J_VQ-hdU~lZSVfeBK-fnQEZ4z_ZQHlQqJ&!b4~N5%HE3ZC{(kkw{-bZjhpr$Z
zIRMGXjh3u}JWtj4sRz^I+rr5;*BOm2;ZdSz^iCM=d7W$nfl;+Dn|>TiBIi;bw~LgI
z645SQvK{>@FUsy7sUc@+8J<@(#AF**I^}>bvG%M`(!KZyBV=&fzaJvuiF=<Ac$CDs
zx#Gr|)DrNc0fAUd9R;#^ewW@Op?lhCOQfuky?s(I%+Jr)ef^5ar_g;D3lr;ugfrex
z{_x2z=7H_(ev1VYmgF40$=`AkKqyE^*A_(916HgpD+k}&3cj`A1?ZvaP&=vvIMX1x
zd&N^Rx3WF(edm)XIf(%JYFIY^)BP4iMiXPnf1Bm;5eihYRjCVPK{NqNXW9YXFc;3T
zu_GT1;CXshD63YGPb8V-4Fq5A_XImiIGx}f4-qQE*vxE)HLdLeZOD#IaqplQmvSC`
zvqHuEA6efW&}7zpt*%`W8y2bsL_k0VL^_Is0Vz^K2Nmhk6M9h*JE);49i@k&Lg-Ch
zVFl@gNCzo_gbqpQeDef%-`($*KU`PHQ}3O7X6Br818kS*4vX~8SZNQDtC6BSZ9}yx
zY@EwwU%t$=miyf=c4yHtFo-iMSiMwUUX5LtxnWwq99+IMA;iZwu66qt8k%WBGMyy~
zihq~qT0`FLy#<ti=%cR72ICY;wq&f|>S;$Vm)vP@xF?ubVr3QX-KPd<^DY*H_Mnq>
z4Qwlq{Yu$yX97fK5(&a34Wg*(vQ62cAMx)ut}I1(jYkov5~Hi>QJ6JdKqzRZT<u4@
z*=?BG^$m@@$oAeDX&{pZVxqL~{09*;S$O)pQI6P=y(x{2_6Iq;wDYxBoePz=&0gf^
z*EcjIV;3=xTwQ18Ru~$wa?#oO4l;sJ@r2Y3?X<rA2*jzRX6b$9tAlv(^RUO-Dh6Ib
zLY6r1IHv=VpjHS#AQYirH}zdQhf9J0h-n)-pUovk;l~;o`|Sz-1`&rM{rG*bZC7qJ
zHf1_Ob3Z8hTiEtC=B@U;0OCDlC*nW}2MmJ10P~5C_nP^BR*O-g*}h!ztF3O{E8&Oj
z#}<AgAT$rN+M4hPrt&?(i$3(s@`YiJp&`qR4`+eK<zGzi$hIR2YRSvXhZ_l<J*#;C
z{zgh;V(<(Ip((m4&CMY-qd#=L7X_dbYDO~kFipR81?C&_Q5+XMdLl-gDvv1ND9~@B
zG~e5baP~LYJegRHkGG##-hxX)(Anng5TU>v25!IDeMe49F=!PG{KPFY?B;)P@6XgK
z={|@vh75*Uj+!QBq*ji%4QR?CjDKCsWbulh$?)4rJT?HL-M&-4n2v+v0GWV<Wl?Me
z>_2J94(cm_Qw|>%wRO@0B7Lt8;nH!P5g8ih#>Jbbc+*Rj|JZs(@M585^4CB<n2Z^2
zWOsJii$=F@l^6Rie2A&fp$$cv3yO+1P{w~3s1-wX51tq!@vGwIfCrEVgj*0Rup`7e
zm=eV<e;pg3y?$>C>$VyW2>Ew@^a95|=OcL>rAnt116df&qn=ero+!CKfaGG1j<nVC
zA4^n8CT9`wi+XWDM$?T?A{S$iN)-3NaEL;%fNyhom|)IPVAk8lM7d`=?qRk8v{IqQ
zbuSWx6WZF^VNp@<Y9m`(vy3@d*bgROaJX#0YzT}NO1s!)$*x8<VWYv*qLWX`=Wjo*
zkCU^fokN}td_au?F`S)w{l|B0pF)%m7Nzbh%CYV#(Zz#otVhvk2zV`p^Tk6_bK@0R
z@=-?T0NHx}$Xf2~#h1oGO3aLYfD3iJm93IV(*VAL%UIeSmaA1H{FRZ_ZMpDVN>Nx2
zE845<!-uw%X?Q}!Jq{7%Kht#x`4^DONVp3qt8y2-gN`D%)bh1eW7Be9ZNDY6)ID4s
zx+McQuP(1dQx~Z|HI4;fI`AGil+7P4mXrP#4S(2l{BnXTGp<+lg><TL<dCvElg8IN
zY>}`mc&xHQu$CRhnPjlgPAAw6-4>EWJBJGN)>6P<5`Y9!ir{@Tej3^Va7l;|0e2O8
zN>ic^W*!mVLU?v9_w7|~`d>|XJE>AY#f9};DANV-y0=49wD;gs>lb?>*^a`54ewDh
z^mVwPa}7NspZ7L8Iu(|XOvrC$is=^Bnym)o$lY$3L}uPjC_w`EO|7Wt@enyO>vQ0H
zHqNe3^>LE}1Mf#h?Af?`lp&a+?I;^#Wxbjy7QffEd#9f6J>JK~d}AM<jJ2C4x|e_!
zXw!3#JRxq8%nYCfr%YRSR-9%m!aUQ#FPSdVpBarS>c2)Em^@!!;;H^pffhqLPC#(G
z?TqfrkPxV5sD@JokA9MYwDNq8uyYBmS!kD#$!y61ehJ8rvJ6YiN*H6rr0+UqJ5}pr
zD=Njg&)eJ#V)zy=44m)v>09-=4!Xn(dY)|{I*RkBdqJ*nL(HnaX(axeJv=2nd2{5p
z6~_?;#Spk&v_exb>-k~L(G0wZZRNdd@ZycM)yVbZ2f2GRB1Pj{E7tt3wYT@IB%VgT
z2%iKi*iW`bg&8+bLHYtK-sm|Vy8@wNk2?gC=+Vn2b5+KwJ(CMd&o>nq=bC#O+P7sh
zw*S;qvF%M|j>UX`OF$Egv%mD^hM#Y8M@j{7X^^5y293kApR;+}WPHZ9)P||;tmPk_
z@2l{Ct~q_Q*~g0R3v<E8M8D6SI-MGaKsll1n0G!ZQQ1;dSG^-)U8R;tDkoMKK6YCG
zb)(EXs%mJ9Qm0f$l=R<~hGc&(Refnz5%Z5Vt+&nrH*)HhBznP@`9=w~Q3rQ#5Z|j3
z!r9cGTdij>U$%Akll(KX21yW(Y8pfvzlT<bhuvubYU?1GY)w1&dmt!=>iiGjAQUBp
zZ_(48v3B^${YNjDG55vo09gY7Ww)Y)gmn$rkV*u^+kHD_sIH?>dN>GWy5pZe@7%Me
z8F>D|AJA#t*+XiF?dKYP*$*yk+_;)TR%^C@9`Qz6*bxeR<6Mpc2+#U!?*ZB3?NCIK
zm4E!~VaGV~NTI@!ZzS<|qI{zP$e#lPlR6MhkZKq%Z@gu^O6riDhwrlAQ1;TVuD9M0
z?JP<WfV6739In{Y$U($gd&J5Fm<gEkw89D}H^HOecs+gNmv=m#IwoCdAh*r6u5Wx&
zm{{cr@Hhp=+uQmjxC^KV6@rKXofFqhqkVRQ6|nter9mF6d32VMHM29BCWkq;`QG_E
zckYb*`Sc`&_M}C6S^dn^&DX$qs&RD6u8pi{0V*ayOPk-O6rf4rZF;)*EVK2-jt2-N
zciCv5>P5y!nsq}=|G5G{NXWE69xi2$4mU)kB<V*1Trzr3C2sb)_8~&lG_$b(qn_DG
z$nxNSOva}YFv()SoUCMjovVPaBkV^+iE%J<mR<y}2B{lyckhJij!~|A*>Jsi0_l*j
zfQ0NtfWhiMBdgk^@vem^RcyxY?Ng)<;-qH`0|Kcs7jvAmKI#~Ude#H>(JCfaFAWj$
zCL9b33Sy!d^HmMdoaj0`tKrqo&(F`N>F0<PQ!><QYHM|Y+VD>+A2PisdkY^h2hZ5E
z$79IS+_cvmYKBIkA2Pct^^w1=w*4~NVHeEfVVr(k8Q-q-04b}$&#xmjE$O|I{#{41
zPzEVQxpA3I4YrWlAlg0scpb|)j&2!ke6OEc=w$2&ksC4u64V$*h`n_}xzu>TF$8>X
z6Xf+}*<VRkEs+1&eO{JgYujg6U_VoKfUwwIfJAtRBY*ViT%!tZSbOb$qFa2=q`^vj
zIZ+Fuq;{|WQuy-nc?lb>FyIqsihNg6t}^73osV5!If?zsBKa4(if22p9b4w(5^uG`
z#6=!+DtCPLt&fsM>kL$JBVZ5a4wt3@Lj#ut#(j!qCDW0oo5Ya>E5YA6#d@U2Ttg2=
zHd4wX4jr+on3@T9^xjcxmvq2HU21%JGGKOw!N@r~r3Zy3vDp_S5_x!703hy>$3X-U
zu`#`wqadLK$RBc!2iElJb`U>>Ltg4A_bunOZvR5br%zaVX6?xN!|>C~4+7ct_D#BM
z?TJ%Tml?mVU$Yv>J!@L>5P$XgJ=K6<Jxk52@eb1s>6W#Mv@w_1>ay?^>Chwy?t>Vs
zYq<P?k2*MU!2YP@0AbJEiXURVwWB|@Y9sDH+der+WWUOYkey8Hkt<vD&ZaCFrH`!T
z^sLt2mg>k)Z!=Qhnsq}p(={&`l?fv;_!Tn)^Fur?CIi-tgMyAedogAt`ZW*-Qk%38
z9uLZ6o_d&K2Pj=dxkNqzets1o|3~IH(N<~NAYeif&HiTLQ&ey8e|fjJAL7=rD^E_{
zXO6fuK@Ra*sKH=05nNY_9}_F}st@0bb|&Nqc$Gn_47W}C>uBp%r-o`{y>^`@YigaJ
zUb+M%a!o|1D_xE3?dDJ_Q1#fE`GaI})gHO#4Vgq{zEUpb^6TNwT@9ztHfnzUESx2h
zYC<yWL<I$<hDUi{0n%rEe0*r=d*EM!9Kj5ruU-2maLHP3g%E+zyn0H#l#hIn1!A%)
z3f083Hm}m{S}Qy=I~y7w9}gTb<eP|^1mu0wg`&d3>Trme>FFCK?&GE2ZKYnbFMRgz
z-%nZo!MrE{|7PnH4qg<}Bm;`VhvG8{ZU1Vkr>)tHZ{ENcBaKxJ3Nl16IXY51v9B*;
z=k7Uu#|hS&`g*jDjZLha3=jc;=wApd&2wbui-Q>HA&fM^bx0M}43zjpcmqO$f*Gw?
zV0mJwSp{~$OXHqIaxN*Ub^{q;t^s2pIeP#jjeuRdzg``;Y%|f)N|5aFd|zMBtTw=m
zYf<9AEDpQT|6Y5bFuoPxaGe9eRI%rD3~zxEVJAqnbMov-Mv<Z=m|uTBmG-d$E!ZiI
znA0Go+PoxUQkVcFU_9V(pi6ZWy1Y*k`dkjomgJ-)&rF^3vW1|f0*V%rd_mY!RaYkh
zEAqw7+c1%fOt%89)zq;YQFRDR{l2ITg!>u~ZN}DP0`swob0Sgi4Y2UiK1`KLW40s0
z0^*QovU;=@N?~NIUCgzlo3L6M6T``rm>mR4;AHud2C(LL?p}84JAdZPbr4|aDl0z%
zawi`ObO8m`MpyeUfffj;gP`<kZoPF@R@MY4vK^&fxx9$9teDnjEZ6q*`SVba5dr4~
zVcS}bLy01S_x-8gZ#zx+;r1qje-Th@3=k>ZImj{v&-~Cfc+*YME*&P5@s)}JaG`J%
zxJrF<KceT#>e6H_iB#~z{_B@7bEyg|C|p=fOeQEEk4{=zS+U1%GY5j2j`N2kpr$!=
z72W{y8WEA$X~)m@1+uE*_8&N)W_l8)B5+4REe%wcOqv@rlZR`&{LtnuBoJ|nU#}y8
z^7n^jJCrBpUoJ2Enijqi{+@--+JrANGqodS6L#)$12vE#wZVI`jKPb7lSyE?&eQ@n
zc@Yw@woFzCUT~@ar@BGsix_gO2fDBx7?rdxw*~=(-N)cpkK#ow);am>P?kWj8On?B
zV-ph-3H}<t&wXs)i7NyBVBrgFUmynji=L6N5h;SN!O!?i+w}AoYC!%$aTVk{mQci7
z029%E#SmylxFpB!VlTf2ka+NYKj^$XKLCmykkSYhJWnhDz7HEH5Mf6-?ZB{#rS3`I
z@AwZVexJFO7oNt*voC?b(b@k$dW+3XcvF=D0M^+K4GZ$}{zcIi%(}WOfbCFR4sFA&
z>6>OCWF#@Voxif+l0XQ_?iTMyf6JS$@{(Hu-K(Q1$A>Z^*oE85^YL9>*F*s^?pjvd
zzTc+}d$jjByWqc{J_qyZ!x+V@rCk8gC!Ts(;eA2^Ws5LlvR4$flZ7Sg<6>0^mk`Q(
z`rBdkS$k48ut<R)N${5ceNZiKxEGs$&kSEA!5YLdr|A<_`<`V%l=iK}5_J3lZf?g?
zdFRTdidI+pm?28r#3be%aQDxmnnSo`>@v$MD;3p22MPRTP=(==fT&hBUB!X>hhXu6
z`}k$?gZ~Z<h!@)w4`6zn2$bYV@WAS-tH}yEU4m!MWD>1G$bo8ZdaqJeo_d=1$e}}4
zKZ3dCjBs-_k~zu74|tW~bG_Mt$W(`r2CAs*4S%m1_`N5t_%U;U_4`biMugsL{bVwK
zda|pVsFA5^a#1%R?ZtT$y))MhWS&WHE1&=MT=4Yiw5dgSqM(h`ZVpg_1*^!-8l?>~
zJmB4z8j(S`nm*OR;aGSHC+<VPi;(9*vWQCpfmt59fhpvHGYUfEg(CE?R~5VqUe#$}
zs?KDJBsR~?3hkL8hV?EFOX7GT<~^LP5d*y`N?-agJju2<6`)N$$i?MQoN@-1k>VA4
zC!(+frJ#bKWZ?*viU+1D$Y}kX`@aN%y6U8IYx~i^lRin{P?a;gpzC+uI1iQQduzaF
z4fpk3rij1L*8xXMT()-f1qZtoLkMV5XKy{=wS_pmIKZ=JK*1uC8boQkp%>A-!b=_S
zL!^*E6vrWwQSE{**XOY3iEJAT(x&BwS%PKlAyjk4Doqp!uMx%r5T1F#_2FeCZ(XcR
z!56S-WPU1lKHPr8{9o&qO$<_&c$#C9J&Qhk!&XYFXlB~h%(}s6g+>aVxDQLDPQ1L|
z955hH!@{*=#}4GGFz`bTrhamyUS@L6z#5jJD0#nPW`L!%Wkmy@Ed1501VkTIJQQJ!
zD8=gH<cx813*>kq2rXY05&jt$7sz%6Ml0@L{(W_6FSqaeV)yT{DcW&vV`aen!UF0O
z3I`RfK{CmCRdlASh!drs4th`QOewI35e~l5r#nx9ewi{jcn4NX9}`$x^Dv{@h}`!F
z!7N|}i|CEnK}i9l6rF974s+i-a~8Pd$Qo)!ng^P(HgdNh8-{D644VADri6@VmmmHH
zn20CJB3MEr)=k9Z#Ml2~`ZX3x#9(%Ve<*M?8XMcB-G-A)vfb=jPPI~SrS3C#Qlcbw
z=|c>qj=cr4EmL|4wYcx27(oa$$mGc`U$g^tr8>}>(NOssq8d+E*dc^mWX0pxh-rjD
ziJ70e<+rxNKxESg_wRoPgD$LC!@%GTI@2JrK32x3lmU92%MhWHA8p&l%ALt3gtnRL
z`;2ur`+YZB`z}9R?*aV&2X+OR{aV-IjI<Sot*dl})7gz*Vq#2CAXUjac;tuyxq)@p
zE*&@r^2T_0%!jauo&_}fQ&Y}4lRI|rJ~R6kD8TLH-v?AQJ$~g$@j88qMbFVO?$f8-
zU>5@ed&uU8%nmROPXh32%otI*pGo1PgeD{$TbSQmGbAmFICw~zNx7X;lb1gZ7QVUQ
zc(MLbWC2PO!gD|&uK{6}5iJw<F(=u*M`O9;<~ES6R^>ngmCbAxj0rMDm>tdywaDf;
z&!%TVa}@Cz$m@cBYkux!la~#kGoh1uerTX2?jM$p_zBF3D-O(KHe#|2m+otq%a71#
zkaa_Yv&1NWx9$~BerWv=yw@q32|E#7u*0+%bHmj&C4^Hd5udY%sbWq#A1fW6t`-@U
zu7^KMup`zWe!=S>i6?uH+p#mdtXq)V-7)_Xs%>^qBM&dOuIpGU-$UpGVd6DtR;tqX
zmap%Gk&wtFeQ5PQeDo;8vi2+pYOnKa+%YiKcngSN508AJRUIe5PWz#O0gHdK;(P4q
z|5N|G{0Fm~ZNLY)4v{b6Q4F>yZ*H88eI?fuoN?<Yt~G3s$XGSR+**D{>2CS${QO}z
zc<3b@B$@eS;czCZYBCuiT%E18A`jsr{;KA`CT#pj;LTd)-xf>3hhn$iFlEkUttg}n
z3|%z2Va*unWT>lM!+rYni2%ifm-a|Pm&5A+UL{riqc=w~^i}cDY+_pD0*oy~EK*eW
zadKuhHs&v`E?xIqq20K86^qyBTK$wOdRllqFG_;?E>3P?hwbl&+xQa@i5_BB4o##Q
zY(29Ty5UqoNMSqvRW~%NB1&l?`Mx-tD04{L!MEfoB+UihLd>rxaITL>e4Lz5O?7IS
zNj48=@UI>C+H-^C!#0yWPB2(BxMY-1pFP|7k0bU5Y{Ka)KcS7pI|{tF5#a9uYDGsr
z@)o4sVZP-J%qA3)e&*lxZ8&*mo_aJlQ)K-~>E45}7xo#*<tvLcom{JZ(q1!}=g-$0
znIitx1Ruu6g?W=K7*zVCY}4QVGjOR|kAc1FzqIVO*gG%7$5hPyxY__afOJ!uwO#`F
z0eM37K5nRdKSNTr4H?3~xq*7j**fT-0fmK3V+YC+;!-dy-1)*Bm>zu4Z6|h$f#0_f
zu%v)7l+sc^=dHgk<qPje{5Q4Yw`|)+?XdS5>0K*N3f$JxTDqVIK2NqNVI%`UNoA@<
zX5%UXd|)kx*(;Cc`5QD<ZaT0=CKu-$>m!EMsvrOY7Gf&mt=S|Q9EOPgWerXP$KT8-
zUlEviyeK6n_IF2LY79^j<SX&+&bG^_nwokvG+f^@{^yGEu8W{F?!I#C^R8t1_n$5}
zwWk!#9zHSvWG0~QG`da-WVkU2Rjyv83P@F^+~XY-0=>Hq`_vw3>3USb{}=bK71k*O
za3{dXztr$i9H{O_kFPtAD82()k#3sO<2{t0(?$~ZZ73gxKi;BRgXF~mp16y@o*yhS
zag?xk559f-_B<=dahRXRKUp{%&DR*D0`a+&<G3Wybe&$6WQ>4%3;ZCnL|CyuKv0U%
zVZp{y4@7kBN|)!r5t%l3pklZ}0FIHM3{`B2U>!Qonb{6#E{RXn`v~p^&#~g88qjWN
z%Un_1f?f8B0$R#ZY{Vh%u%vDuIt2=AbAKIZcte4NTpTHo1Ip|*NGIn2yFr|r)?!S-
ztRWY;?wRMA2tNiXgKn;sX;?%=V&FC%D5e?kH`LdcCv=yvo>ovWSY0)huxUI7u+Y$t
zmw9jSZSP~e7Y#HOrtRx|CM3aG9J~vXBO`>hmYpV=fM6L0j-izOH=ZMeT#&pX{GU^G
z#hO5YR>f6?l<TccHar&xlW4pe^bQpd<PSVIMH+iA70nQu8<U$uzo&BK1`hEOg1Wa!
zEV0OHd|Q-Ez<rfiq#Xut@g>y*%ucG~z3UI2D8>F+mtwEFbyKYy&=p48;a6(MN0|Ah
zqU8dzk%stY7>G!H<H3UmVKH4G{YecAb<;v>2~bwBA9@SbBZy!~B=Pm_7^UF9f+Ahi
zU-j(oJFff+zE8A?HRE@h3cZO6qNXDH5zM`VV5^N*5Ja*}h+S(UT}=-iU|)?X+6Z0N
z8cb{xVmREu#UlWQi!Dq4u@r;xoUpGmH0&<B3T<N4MIBf?y&|67;*xM@Ws4<VGs1Kq
z-1LAWQce?ui70o`@6ovm2$g)33JK8iCKN|Pt!NHdFjW_!FwJwQGy#g8!9_s&K{}F7
zhf5tduK-}lshD}kn-2C&5Zy>ncLa&Pjx5k~@-z(hLn9Ap(n}*o-AqbJ!YGoch3{o&
z&v^6ZQb&PPJhbXx&?i>V?mn-wOR__umqYqX48l=3xZi&cw8a^v8Rm*mexAE*TH+p#
zr0gocpVo%7RESH6>Nnb7)&T4T3VKY7kc|t%fDtWVa|kHWAg+ku1p>PcxY(g1LtHsk
zSCqlg2)k}|JnN|d-a(FB`%=NJU~p1160z=X%?7&ROAWu|g*#O16e^em9Xbq^NvAU=
zH+SwUpLzU^S>o(e1FSLXg_8y4(ZRiaInZRCgE}wwaTSPc;BJLW0-At6bUDuTm;*_}
z8`BZClX|)*>ujr|KEiCuw?=M4u?2C55)?RlRtr&rA>x<T)`*%KX*>wlj2t?C67wC>
z9t0YrM^h!qgM)%X)Ka97)|?DmCuD{KKxiS5%wRu^oA`o%I{(MunSi@Tqf>l<23Vsn
z(tB0rh;e0$bF%^8!^4w7(y6=`Hgvgyuf56#;h>ejIMVS+k=e?kve3gd#3J#Yv^I1z
zlJyTo4a4iyhX&tEDnf9xbzD@cI3p%&zzZd{^yj_so(Ua6QvikDR6)(wz_Gd#M?*DN
z8!Hg!T?$aRtyOc9rWHUGLF&`43_qAN0ya{PV}I>zU{;~;)gTQYy_>o1NWO&~`*{Nj
zv{}t9ngU|8G3U>hhhk7LBsfFxAj?bOMRLW1f<J0YPNRy!W*TX&L%UhTRPfbH%_lIK
z1dsLEVJCZ#dcpr%>y7t<HgB`<ySK`IF`)u6%}2tzS<h8KwT6~=tc*;}f*0>}T6fU&
zaOeCf)1yFqdGAdh5eZlu-i&mJwa7r(^7}*+6ZReuemN1Sx$K=$O{)&^vo02Cbrh9+
zqu=%Bh5`|~AV&sX7Wkv>H-5n#ul~uynmrYVkX$!@i4gvS2yOW)ALvS*>Xo^Hv;=;P
zcM-sv=37`%&tmYJcyM*_Q9U6aW*#XHt?!Kq?8qymkEKJgLg3^{rBu!MwxC_@H8nLi
z&}|ICGqQZ6+HV<4^P5q{s`B#V#7x6`K(>I=7=rxZU*yqFe*>e&zaDPhruG^4-hqRr
z&5Ey0zp<@c>JB^W^Rgx;qPXWREHUnxKC7_&%KqVCeXK%`M~~^yKF+Wtgb%?!A=Hzo
zS=_AGV65aX4jX`7mvQf+`Unl=iFI3O_B`Z-BE2Z1*jT0O?#{j0Mzj8JH-3Ts8uT0_
zV^ifG@*F|d(+z1}$USX^tSTK@-x?DGp&o->UG_>&O;y94KYyMV3awW!U5@tky}NVw
zZe0)v8Rgj|wq+SZ75mV`^-eu<oOkG~`RDoYH$}@IZ=_Od7#gs|o>DKxw=$rT4NKS0
z@-h-NVyv*tr=dq$>N(s(+h5YZX%ze3b(LA?00{zS>!i#0{lMNgRUW|=Wg2wwRsseB
zVy3FdG7Grf#wP8uk`f<E&W9ex3tk9AWO8k9Z-q3t{{QO}@q~jLFXPB#YDfP32^d(V
z<@tFDrl#A|Ki3B!WHW)7qG=u;TVO%TW&<D2I%T@@&1%FL_(4MVXdY?tO5e_HzmwaZ
z`L_~k{orW`2OG-onf0;Kc8Y7|#VHos+VOkycG>$8h{n^Pge)TDyMI5{2SaCS``$xf
z+6Bn+T%7OZm4z9`x-Ag0vB>(-{{B<_N7O@0fV=jfzzTt03Si_`Aftkz956NkrjBN^
zaxPb48nRA0<`>^ZzNL7QN#*(b0L=d?4m1|&sI*+1{lP#-4kr4^sAOfEpWizV#y9E%
zjGo?`r4t=|F~|6kUrs>7J^tt0fUGQ*=pdGU+fOS4Jc!k{fJ#1-w4h9K0w|6wEz`iD
zzV6dCgL-$ad?~=+jNfM~au9J-7(@R#nqsi?#f~>s<obBVVo&DS-IhYn?Kvq3m@(r4
zIJv2yM42SYy<3**itzBk{Gt3{3s!Q^QC)i<=4C1VAHP1kYrq9p9{}byTwmuJ0R|L_
zzqpMu)|LL=))&Z(Y&~wk)dVK{=xhGCrm@3jZT8Q505;)1SHk2!1(m#EKMP0TGjMnB
zWnOHW?f<=M8+Zv6PEQDiV5nx+ZG8T&=j;a#`>c9o7O@}RvRsopnB~EXLR#w3=w##M
z)Ey>3w-v!F=gi<$!`C`sB%hN6Q%^gG0OmtE_%8<V`cty|aiAj3j=jOF-x7#S;F40h
zb`R-8R{{514>S3f5&k1A*TBzaACRyo0SLc;KBob=h;T}EH_#`TOo*v&-OS^4J7rqB
z)lqVb@cIo2|KA&WI>D6=gq$OjOfOHG$=l;!5X{gwcQmCaHU5nm72D&oWYaPam{Iof
zL!bZv&$F?mLEb59vV*Vm%Z8iZ?VoMqoh(|)HtJo+|F}T}|NrNc;Ns;nab4%MGZ1*5
zm07;n3d~)O$Gf%h3CA4PZl|uB?pYRlz{7`8ZcLR>W`yWM7f#3e^Sda7<N-hu!jdSh
zhh+YCk|_2!-H3bky}!3w*5rD;{I`CFdHS?l(0V1Dy7ksyg65*5h@2gsz0+GpU7VB>
zA}TP9b+eXBN2V%pMy}6(QwriM19|`e0JE$BARu$Q0Z4=vojGj6h8$7c;Xf)u=1Iim
zAw&_}X)^GNuLqHU$(+p+pqbVJ9q6S~-|V5w3B2;sE-JEo7+)w)1zcv9!v#_7;~Elw
z$iI(linOt%f4P^yW;vn(0sh`cm`DHp2c<2CC+;0!l4_*Sm>o)9?6?b{<e;3i!!sCB
z(mrj;Om6KS6^<Z6xe;7Znb~C3@xZ)Ow+xGxPJ5|ebN<%7X&bOzf$;(~nDDn=%D~%a
zpS((&NPpGWC+NX~EDoMrK)U#3&FGMEW}X<?<6?uv83hG%aznhnw|6lwENBA?PA26u
z6&HBY-@Zij_249ONZ2S1%29Sr?}C`E+4X_2e(ecWQ-KjwR_K~1JqyGTOatY33%_Ut
z4DHxHm2>tl#0Gbo(B29Z1MS4BnHcvJdw5G#o?Sm*17q9njsx=`rI!F_*(n0&3Dz6T
z;+*Z!9rIT+UD^|t0u@s=IogA#HKl}2aOPsk3p}r*By}E#aIqaal!DGO+IQ;TQH;gx
z+7rTkiAp=Q9`9;#Zb_@K-`(-3BS>M31@JurV$N$MtAW|=E=Pe1Ejs$R>&1=?y;?Mm
zSHWDN{n^UkhtlU>xTNQiB7#(td=1OEw&dmK(q0$T`Tq!^X1v<)4~+Rcp=I8JBHI|y
z*pOPn3*fCU#cRA`{&OoAa$=ZPkXXcMbu{UY#u(R#Xhk=kC9pWX?@PF;WAH(IwQePN
zjb+bHG<i>K*sM|rsM}!|v`LHrwN$%)T(6Iqg&8N11TVf(xcKk8-N60~QDguuk2#ec
z*WF0(oq7Vxi>@|!QQ{cmEqwafbAI>7vMysx=LpKDKV-m;MS>r$CV)ad^+)boY0o*1
zp*yj}o=iE)UjN`?_i;fU9v*zb-w1_y6A2HI{4%Haw+(U265z=+W@Uzn6m1?Li!)!0
zoDW(6^}YG6+RnRemr3*|y3Sg4?%U>|ks6Kf9HG3zW50N5+opz$4t}#(gu;6(SmW$0
z;b5W==6T?cG-JLJmO}^)K|RVdlE}yWVH9F4)fWW5pj-<6Cbnzxf>NUC>et?QV@A#J
zTpM8zNokLfq*v(A($0ggOw!+Wc=fB%sJ-T^t3;~%-wnt0JE6--k8cF}L-cP=c+^?u
zp`md&GWdEx+q?V=vLD=@Sjt%Y=S!d28}SwH0c9$Y<s}KCqJD{=l^%igzu_M~*ZNf-
zvjqlv$Lco?i{;S5TkJ<#%mGcV8%BdGG4lTJhw^K(_kS*zdj}iXn2;p^Y}snX-&b95
zuP_;f^};@KYmal_-Q|rZ|9%e0e{UA;b5UZFeb@EteTj$zfudhTY;4xo$E(7Y!+7h+
ziHL{Wo&zi7G^MzwnDQxJ#B!Jd27KsSw-Sje{~0aJL*Mg8IQU`5Vaof2;*wep6BDsM
zgreeLBH#DwYL!2{X_23H4K9l40Hx_8veViB|7q1h;NotmCx_J!*7lsgVk(3ESj-uS
zbkgZhBFcgCl(*K<Q}$R-Z+L}gZEwlZqvCsl9&l9#>!jZ!Yk!nYR5yySqHmD1vunBZ
z+55*C&4<<JW^MocVWlmm(jWOY#X^GboyNNh+<&l2ynhn$DSYb%K?nZ+X~yGR#)qFA
zKV!OVCP`Q?7OI(jH`S-tKGZFpr@S}4u<&OK(^dSx*PE~r!4V=LZcm>YQ%L4n({wP(
zkBE$nOjSESW&bPn!*C*wFsR!2pQ*flh|`D#VBr)P;wsftB*8Dv(CKuHlt}j>U;Ny_
zTKarESyxwgaMU$h;M=!v(DK%^v&%?T`~Ox(I98hEDNRrkvZ#aA)3Y@%jf%!#{mb4g
zVFd*RMm_to-+M_dRx7L~LPg&!T;pj`QBlW7i^seIA|lyefQvh)W0-|THG|E>326Cf
zI=xkbC<z@Eyvcv?F7uiz2`@l@2it6Egy?F$o9Z+c|2YxpUKjmn<Z$tgZ)>ut(DF46
zx1IpUM`(hFY={$rratN3#y_BxpMw~wrA_q_j!8=Dr>Cb2iiprLND1n{pFVcPw7sSf
zGm3lmT;y7$2-RvWTFz7>ytK5mRrd51!BqtS<UYlmuwS5E1`dbgML|z0>ViX5s#@{z
zUFdPcnOTNo|1;^4Q{1yhgw>}9pnKK)O?yk%U~gXuYe)Bf=Uhx;-ld0iV0pzAyJH7y
zTNgYi+5hdV^UviK?m@b0=YfCfGkQ7wfs^g<sCL)zl8`y7S(7Z90RzMWd&kNu!-p|}
z6WqfJ4SOLG5e*j?7ZGyWn6IN_wziHAICJrfii!q-BLmPvYJU9CMWIm1Sl~*d&CJZ6
zJ%8Sk8t-q^PoP_q$z*Darh*<cTs!g|><drH$QV17(IOV<<3ex*<Qwp8_1)dw!>Jz|
zY%4@1B#2Y>a1(HfR4{o&K_ab?1&&d`1MnUz``6>RxAvi3M6kiNYP!~{WMmX~Z)<X+
z(Vcm20Rdqe28G=2RIc?5X5)rNEvVLIOvP_$t`HIGOWB|qsUuu)!692GKNpFvgH);y
zF@915tcc*kx%vyi(6^u=GAt|&%6*><&fpNzfu*G-G=||OQQ+!}jS>|T(`isxD}{<Y
zFO<YStE#E#fWH~g5KP;w1KbN7yAk_Bj64hx=u(CZym@m3vP2m>!$RjoXlhek<%Y;V
zYHD0D_NC7K51=)K{q^ULY8oyqE=~mHJ(Bnsx_o}b-u3$W`kR|)jUIpZNM6clOAs_p
zo!#C<tQ`N=Vku$3mz-SFu=e@v@Fba^Ctf*DgoQT3a9X)EdbE?X+Fm<SfOo!Q;noCl
z6lXbPman;wHuI&=ec~Mj1G+hk6wy^@;FL7>^E+@Fp3YF{?4G*m@B{jehn`=Bi|;7$
z$hm$hR8>`V?%QE=8}O@yn{5H7V*Blyd%*PxehVHzltMr`bg`jGjtAph0lwrJg;LFH
z*R-x*e-Y<R5xA<XEL|1vzi5ln2Dc9AyB!bxp7iV2?Yejcb9knRCGv4a1OIwxL&|~O
z5wLg=GotrZ4xRbw0c)!vjzKW2a7oaa1<T{HjB?HOXTtomFEc4mH|Kh6|8~}`TQ}Q$
z=E$|2p}U*t*a$aI_AUnU9^Itt-amYnuzgoJhVL3Fg=h-Z_lyK%$85dIj4`+I6P<a@
zuP(8YY|1kOAJdwuIk>7tU-&6+T=jSCEwS$1=&)j+5;8Q1_B6dd$^GnZi|QZ#Ed`f0
z@2t%!y0FA-$SEo*A#+`@Ec0IUvYhEv!ouRbYNUucjU2(ks(ke-QO&ba<iZ6sV!3-g
zMW_P%_WCK>WN&X%@KhP2$L%2lnX}zH!IEoqdp|S<1SBN%pn@DS;m@`J)DD*Wf5M|8
zICdL>S$341PyYKoi0N9CI5HezfWq{{v<sgFC&3R2;JyZ4QjyT`&jWH4oTQ@M{2xR4
z!YVKmf@aW0Fe9=X?<~>hl6DV+Z6;21T(N2FtCltGk+?<5j`gO6KMfh^@msW^v?kd#
zh*>CqI)B0G!i(f&zl6S5d#hc%7f;niNxg5j&*sZ+E48GWvs9Bhqc$dFvf<?$<NUU9
zR_EgQrGh9TW~C$NFWPvV;V13QFwUJ&AaD9(llaK%RZ3G?^kpR{$;}7wzbHj8P!D#~
z;@Gzw5RS-wv=GN7XQDl{@r!Kj(X!mZ6;+aXdHLK62XD828TRuw3ChcifFdsKOx7XN
zncs;{U$IMIDq`CB3#=Nozgu?O6z3NMD+m@2%qWn}<$Uzw?O9n>wbAGZc+}J(DWqi$
zVK<Q@!4$XzyeJv>G3OVt7hS$g6YzWd!GO~|xk2svb@7MWl7%jP-m>e^X$VWU8Zc-f
z7NlB7(klO8y%;Pv*QkU`%FE01{@;c`&MO~`vYtV87oT&zwY<!S54A*}(5o7*llB}*
zNUbfg8jO{9xENw{pnnv0$|K$5Dsi_TozV*!ID8;ZPxlH{+E4k?t;7fs^W<Cat8E$^
z`#V0`dt{MgE?O3=s;cGGtnPlwG3xI5p;Ur;!RBY$xf*HD!XA5O(XEe+sLHkKbJ$mE
zTKIIM`ITPA`_4Q?+V&7g5i}02vm$~1gm9Rp(BmG7b}Dy~akgfqg_Ay6)~ZgrvC(tE
zg$i*a!_H6j3zi&-Ai`=V-Fx8g={7a1Wu*P?s2EPqK&x+5JKJmMYsB%oXrJOF>BzY9
z@6%We#sdUgp2bO9Q}dFp80R~>a9000hs0y{54dLSy0-<DE}Td9Ca7$qdr*5Iip4GG
zRGY@tcF`oc8su(`T(i;FGDzDIYNnIAXMC<BEYiN~?WBQ5_W69@bpLa5REGeVigsU;
zNHJ9^!B6yGPIMo1+#~klu+ekOU~~mFP=bd;TKdqzLzJRFcNl%V^SVWjdFcu6fV?X!
zpyQ1Cv=Z;T%<fejW;aWxuQE=oYDS8h1JWVsc};-DFp@6$uPh1x?i(E)rI2#sA;up(
zcu?26;V3w>feMAQ8sZ%?$(Xzin17F`l8#-cM-{qv)ZzvEeijpEHFum55NP^v>+A0R
zZ!lo0#Y~7d&<i0*ReJq10qJ+ad+JTYvZcA#ytMJoh88|EF=Uo;J`Q?B?92t;gL~=8
z5@j0aaIR5Sl!V)(fs4Z9fzrG7nrU{kv+_vY{>cx3SuphDkQ&>;L((A!;y8puS9)!A
z6R#TB1og`;d7^C7HDcy9IOG>h?Asj9n&d((W8sic7K#wbaCvgpi!KYS_3|o){!q{k
zo!!;<H*O4X<LH}Abu^X68%Nf|z%mF8wc?;l!f$37d`dI3`#s7KV7%NJEZK9q+cQuk
zJj@fGWr^>?Ot@%iS+)@@qoCyDMV$&o0Xlm2>>2Lc?HjNR&?mZuLesq~>VWK7V|zwY
zlC+Q81eU`%Kf2-9QrO@DyK@3za@gA1f{E~}TJjxhYki+AbKmKpld^>%)dKK%wBEeV
zj~Q~2$EYBBSj5Dco!XuHGDSmu24hP)h$m9S4{`3-c4~P3;zj1nHsdye@X=^{1=N<U
zEdJL6w<@^nk#x-S9luXuc5KMrccJsDuu18kE}V{g@UxEor<|OEqQB1F{vzh>KIdF^
z9{Whgy8PDrDjQl2-^{ej<m1~Ol*anA)yT4fOD#1aFNIo5S!`cJWuSka6MRQNpD|5(
zymgJ-dy}*FyI$PTi^~t9iC$&QSH5i0-8Tx7!b|5+WRaLz3>%T26TgZbdd?wx`1Y=y
zJDY)sg6P8y5eI)gZPXDlctW;!p((6kL3exrLyld>J@dG%fwuO$xj9U#4^$kuu!S>3
zeRDk@zxaUFB3^-0r>X>G4MG)9tPe6MemY>rJL+2aOx!?;DD%|?$^mkw+OeI5(+zPV
ziJygp1)4etJYL1SH;|s>v69#~xr&yZO)-ln542pHC2Q!z9Nawsc*EP0vb%tc@?Eus
z=fhbI0XxrvG$EZMx%N1KJwyg;qd%_k7#2(<J`Y^%;!GI}RH2l%JxXgdO0tkDT0G&0
zA0UO8mRRPRW)e%`sSg>}+f-+FKk}MAW36i=oPn(~+{P+1EEf@KO!a1F1~g>r^(iM{
z{lJyBZQ8U+c5xZuEX{o9XFq%MUUN%}1aR1ZAzJ6$Gcncw^^wJQ?7a^O35vK@Ftki{
zvkbh4ETK6{N=jVj*4EZCD|f(ytpM%gK=%PpMEO*=&U^>Ai~^AuKrZ#e|KQ4r-1fVI
zpNz0mjhAA9mCUahr$x%{zH=d(&08g{RGn>2uY_nvyc%8S()Cxh3J4${6;-S*-g93Y
zcPjqgpy|<#jRc&_54C}>vdMgWAr)&Ev6Qe{Yr~lt6Z!YcoJIVu;U0^5d$^_3WG1!~
zvkH1Lo?O_+)<e$NDx(k(0KqeDJ#aR?{`#1hfwjM?;^ASW)b6#1N9vuJ^_h^5R&@`E
z#d>&EMl;cSHemjeb-h8J8+lK+i%Qx=F;yfe=ur_7^<iw5Pe3rkAvyj&L~y&_@-k_C
z-6YsE0B>0v!Iu5;oz$}$tlaLMJ2NnK?d|O$wDzlcPqnVi4pX|)b8CIZ<BOJg{E>Z#
z`%NaEnxuN@)45AN#RrXz-Su0ZHbQ>4*1UIgz9fH!ag8|HXG1We)k&)4Ejb0WI23fJ
zL{yaLHv47Oa~Cg`MwmvfEDiM~25K-m8p3<|^=Bhj{GZtzNX#Ga5a3PnBFJ-W$Yuc)
zYgFtT&Kx~yPugg!CZPod!ws?7(+5(I7H^+u_oy7N_pMkAe~CM#-uR(uZHH|A+X6)@
zx<WLxz$2Du_c2BSVrS2d_g)BqIJvr1k-;TjdZ_*GVOq(8fNH}}^e7f!ps=TfJAuwi
z?YreSH(e!24jJuMY6#&r%My8Mp5#RQ@=Yy9TBC#IsJPaShL_nb4NUNqFoC2@0kB|1
z_<IFrE)bSb#&J{c$5lr4B}bSbT7c49QGvJ+hlM32CGmn<+ivXV$B@~lPoE-Gdhp#N
z7Gv!ZYzLXc^FzWA6kVd68WS!7u0~+V$=z?_<8!_}KP&`U226HXR#Y`L^--v&fW3jH
z%{2f_mlnwRkhBP#kLA{uXW86OW&VhfaudH<xk1>h)Bxcv=Hx(c$W6kwnHP)}rQ#Sc
z)Y;pN4*-sbwp%m&GH56%qx#HV5k!f~2301Q8|~`nx0to6CY_99Pw)S#Qdk-QmVuA#
z`D|<3Dr)Qqc2zI#0AM5y`MLQ^>ccXM<%Gme=mP!ePU;zBi%EGuajYG#-&dplT-jW+
zCmVYDE9-#+)wX?=DkfV$nGnx<)#%bF?P@Psxn|;vNd5qtSYtNnqValEQb6X=q%eMJ
zA#j^QN|WYVe)Cj#omC64`X};oEVpdl3L1r>@U16mAI<QNwi!ENy}FksMLjawdp>3>
zRfl-{O~@9V6mu(Su@(>>|06Q7WNuE~dujZtNU#1vLr>_mCVNjLz9FU?@EFEd4zA<d
zpL1BRmn&kr?&C+JCGj5d@*x{;fxN`SAPWt=$9G>EEEXC9)ai{xGGUCNY}u=6*%02%
zU-GOxzGkvNNuOU|=-@6B_1@)`G^0la$GUV__%)8mkoIs+MdRsreV#ZEianK%2&Eob
z8+%^IE_J3pOX^GAEhIFyWp*ALRXzMQ$Vs&6`HqHG!`RQCt9Z7SS#@uflkqO}^<~$y
z=Y|xHSWY&A0P6^7DdEdrGs9|ES6XA=#k%N~sABA>$q=m;oy5K=CmhxAGX+7$=lTs<
zj?Ov9{y>g26n8Ow!7bH1xtm$k(yeBR1EU%ColZ_p-)q$rOczmrcc4B)yuC!aI=VGy
z>%L=QNg(Qg)k7HvS!)7}uIi#hCGcQ^ETZ+@)m^YxT{;v4khG6K-uIWd{+&BXKx+ht
z+BPTvq``NQK@3ZL2)A4YH1Sc*fDO_#6;^a{c~*7oC<Flb`j!qz!RiK@)@*u|_uNST
zn;e&cD!b17ETl;a_!Q`;)RCt5xTMU?GjPVEZ6>Bb=Esb^h9cCjUtLRI*IPs|Xtmrf
zM5_-}SB#vOHRzdPM2xO5BJp`ie`Xb_si_LG0O{v}nPo`=QP&pr^iax~#<bU(dPjlr
z6Bf2*aokCz)+oEy*fRfaxAst%lvK62>);dBuYt|sH_f1N8`J=79yI(Vx&IPM@XYB(
zVD^W_#+vp^EHNe}IaTtWIv0T<RH@UXS(&WMWda>9I9X9)l517(O!X5Ea55zHM#{Lp
z<cZ`H&8cDN9Z=}-Z+&s}dwBLFQU4SLE|j#8OMOt%s|iDoI`s5F*XraZXF^%Y-5~Ed
zuC(ttb!f^qp3&u?+nSNBeGZ+DyW<$6*fl-B^6#CU0(pg)1;OyJh+?_w-1m=#&K|3D
zDMjA6VSTG%aF%iRkaz^WzXM;aNqQzhUCjg(?Y5KEozkfBUinYzw};lmbS0V8rBm0v
z)oanZt6x)vcFrT~xm)$z#I5-=*P5eu^`_6vz7n6sMk4=~n1nijsH)(1z&RZ!<^N0E
zFpJc~>VzP$dsHq3*i>|N9Kv5%j=2RJc|{F?O{n<+1<lC8{8HcNt@B%fj!j(3g)TH3
z2Z!+x7SRmAW-vLRxezwWyT<78$$2l+*Pd%l@SMJlL@?YOh$w6!DuP<mU5Wt(tUUh}
zZ=hm>1%V+HUWlQZ^67xizu!4;3+|;Mjj{2);fzC|c7Sa*?3><Qg)th+`>m?V?#G*R
z#c+IBlzK19Rj=NKggMm>z=Sjy0m#qy{Q-{WYOsfm-tF7(xIOzeLZWPr14lJM5SKJL
zYg+o~HJK?ZD+_{p=!OMUb0{l+SDq>f6Cs_BvzQ%)Ras^$_jM{okDb+mvqxh1e9;#a
z^Onmji_=jDSlE{h!rgLA2%nm#fE%W^I?{^zP<-L8!Q@B;*-kk7fhUNH*w++9ZAL#0
z>D5=bkwXN(`oc=Adi}`2j0pg>So#<4)g@;dyAmV68MmL0PaV4x3>tpkK>YHIvK|%f
z+_f|8%~|Dme>ya?mB2?(TyvqqxbqYCd2LxJFEr#q3V?E@nikjE5u}6YW0M*7Bu8lg
zBW*crKec>dZMXVyt!;V1sm+iJF2>vAI}i14`KKE9iCx=wXP$jh0Jp*}J@-_#<c668
zT$zZ%0VG?&@Oj#<nOxJC=g1}h$e=OKY4Mbn<t#I>RC6%`E$6M#++$0-!)%F;rV}?N
z<GR`Qcl~JLyKs@(7C@PoK6^}Y<Es8z@9W+3>gHudQ(RvS{8w2WD?}mcd1Jp^RDUxU
zWpVdc*r*ZxahUX|vh55V4InfRQkUwV%|m!yU5pv5%P9jx6|k_!_E^9V#RDcVU%A^$
zHb$^+7BMYXWu;RGX39F@$D90>wz6P4){X~qqZ0|&a_W4$r^@|htV&mxn`(AaH5z_e
z9pR8T(bKpk*ZjIBN*jLXt8(zUA50FC%|)bHa}-K0g7SJv%MW<6-)`tnR*TfVD-_|l
zkPJ56Ccw)J2|;5pm~awQbc78)R1OsZCmY$Q4GIiy(veY=Wt|p;_<i`W{w@CU)s-cg
z%f8umSc%jUiy<mE0D7btI8%ye7mCjPRE8li?Pp+ifd=#E-3yViqzGYSk$`}JY6+*(
z>Eh$EjMVUe=F0mok6d=j{z>MZZoS6BwfOM7SOIms;IPz|bjTpv)I`h90Q}tY_@NCf
z-VnuGB&D#**VUF3KOaB-=p4|H!VZ!v;!%c$*IvJVjZ2C&^ESlm2lVCjz<^0kb%IFV
zt4h*#UqP?{)N1u`gN#YPPmfn?#G+x^*oQn&x(s}eyuoe-_6LSRTeft-kn3L%($B&i
z<vzm^Q(Ir}zVqnnP_Aa|gIF)G)L4qZT2HffYzcMq=B<<ka`ov`DLI*F{2>t&Ez5hK
zq+z$MadCPT$E@Xr$1)+XQ$%8rz^>g(1PHNE(T8nl>?y6h>akISbaK)OI+ixkqGDQN
zwy-g>E@}(OJDBcav9@e(I6xI)G!aYiLiEX0s87VkIVk9(uf`93>eU1oZd7EK+`l9M
z5QmTVh1+t$A2v4r)6dOEph}J7<@!rH?GM9kG&)aYx@Dmu19LY=zHE}z?U6r+dCMIM
zDc;CIQlej&3T0~AcJN?h?OK04ai_04wYmLl^~V?!%exEB`<64Z{v^k@eQ2uU;rswW
z+4Am+_Kt>NG+AR@Zh!gRYc(F07`7>)TJA<6j@`?E3?B8xb+6{cmWV3A(qCKj$MOm?
zkZB__jpxu%0=aDey4GXvyZMEqAr{^YXTw0h2{yIEwoviWFg?V~km5Yni(Z2f#*VLj
z9UIegQ^9w}QZsTOB6rI|vuN2tXSamXh41T~V;ED{aPE`clcW2cSqx{g-N*!~ifH@o
z8zAGbX~u`LkPaR?I5PG6q@&ybuo_5H{U-;(qv6e)awCGEx>aubXz|RY0?K^LGe&IH
zDb2T(?K178bH4N2p(@yi8Siuw)wV^U!W(vM-`!gLQqpFAYTvV`qj>m!NVW@72iggQ
z&=!?|<$?VwuRtlK@;-hwtEJTP58v#|u~xZ;ISsMaM<8i$oo(Py+7)25z@Lf@8{f~5
z0`~|}kJUFV5*zQ|hfAs3XP5VwHoWZU7~FfqOU7funSCj|At$CvSz*N(IYVgbb>g6a
z4gu5dvp6IgU}%l~S+~$_f(#(f97_cm!s`h7{efA;fFfNdH0+b}>lQ4WE>+rGM;-QY
z?HtXO^_;SJBsYEGtvK9X>f{iOszApqC<aAs?H+So9{I?boV|MOeH>S6_3ilPQpw)t
zwhAlnVw0EO<!zQ%<ce$MxbfdAOg@0X*mzvZEPCcs|3xUFuo*q4B$Y$O>rm<sH+Ip}
zXLM)Ayu59kW4QgtP!I}Pkt`XCTQycCo@^eCxhB}{nWy{o+dj<m@2*yh%yBJpN}WCP
zY_$8U%ku3nxu7@F?JtFjMKJq5rz1kAo%bvQGN7!4SFKgdfB9)Gm?c%&s~N~WDvE>?
z#jnf?^%RXp6pa$cIlihly+|H)?ZQPmy>>i5nvbk#|MalLk4$D642@*}q5I9~4wjt?
z8DYztg6~OtxMbL?<X1hjGMY;?c~mOv>)|yr7$c(?hlRby@V2z94|8>Q4-p{FXe6e7
zd9VpOT>1+!<ai#PTONdhUiUpga*HE3Qyl|<+^1?-_}9KC(Xy5qw+DWKwJR^`DjMG+
ziyZG$r^S`%CxRrG!KqtcUGQyL_%4PDw^!?E87f<WLqf0I9l9`nm)qN`952%wW95EY
zUwB-SnRVd@P~tJ8MyYP9`j<Vji;p2I__4E%XVFlsL_eX~&C@%bVyn0VeA8;}YXd|N
z9Q%_{?>d|*zdCCjwcK%6?yPg#@Q<Z3`6b_6k<}Ng6+}jA@cq@kz7%+&y*c#mrA^B#
zP#wyB^s%>s_E;K^)O_G=>fBVkS33)35~EzlK%8|$%ZDb5gJON>SUBXA0jUd8`}*zV
z$2(>$hef`+z=9>nGT;8Tv`peoW2Gt?mxQcNGhvb8Z>OK07n5&-R)oG3!=WykBjn}K
zptNad{90gQ=*>c@A6Xi>Sm``GX@v>wTVJHpbv9Jel0lPQBe(Q^)#cY4>8qG2j8wRw
zw0Y8P<BynH(INe90XLcU5HJWTX(!0@JJjEVC9TEE==A7e7#m={aA!v#gE7O%baQtN
zwSy2{J6$qSjIVF&6T}b`Evi+OtXSpdK4@znI#M+gF#p-|CqB~*D(aruzSS2{h``U(
zjN|B0!&{F_pk(08F5@-x5SE-G0?#&9F7eEP%8eHK+WOr*vGg1zmB@jfQ=#6B(SaE^
z9n&&zhKu($90FpX5uwW%nXp@+%D|SBwbHD+BMx&MHeW)SoaSjegNN#%#u6mR=0ny~
zb{F9UEkB`L);gFHol)9GWNdWKDt1mZ;85sH3XXSZ{!z4sAIWB9P|LX3T1rx*#OXAQ
z7j5{@?~^RmmkPQ}zP`1~QOB3$S#<}5G{h>HzxU$i`e_bz(&s17M8thmXZ>?dyFdhc
z;Kj>lHd$DFFR9mkvPDKMqGWe+IQ9&`KBQv=0ODJ=Za&>#)I{l~mJ7<vn%eK-I=8jC
z)?*ESJ>HCATUX5TsA%!qT&W<Ir$Ns4;)GW~o-u>qsOPb^b_ki0S{?|#kSgeQkA{3f
zf12?PUK?-4DHh2$jF$(hlcLpkiWT(nC?LO!e6;Ed0u(aH)#{C1Z(9V%BDU(bj^Azj
zan!N9!fCQcFem+V=AlFE!{Y8RX&}YTqDz}#_heGsCIz=+hhHRr(Tb17i`)xO|IX-r
zD|RUL<BPgz`-2@&0(61RWcS}5E6s%>QtHwJ$D-tph71IBysfi}<l4&^@3x=!MS$l?
zWhkkxw1(jwpRjoK%uu8;Z+w;uTi)P5SYL&djpfAl9j$~PvE~A9WPR@eh7%rHOg$#w
zt+M`knz!(6sv2JZ(k0rO&*iJ<Jyz<ReRV=lNkml-j%Oix#@)Fi)jwmrcI7$JmavC9
z#JqfvA~dBfIrnb<^Tq0qoGU9l)nR@kPw3+f=P`Lg_=FEy-*d^Mp%r(Vmy23*@Ou*p
zX@5DJ#GbWVu&-^<I||*>%&S*x<URi!HCbo~6FMw%kRznlLpbv<+8nbP+UI>4>Do=x
z>F8SXH6xYh6;1sXy=iKlK7&I;L!+N!Vphn8Y-@OfibBFu$CB|2nvs7q2^0hOubC_5
zQP#4Wo`&|?&bf(>NUkiNb|1O9uxM5h>#8M|{lEh|t}kEVx@2VknqWnBZu*#WN+VWU
zZ*&2|DB80=*6{^aPere0>$%#BfqRve-jl=nT*&H}WkS%d?FFhlmace9@n!-p)VkH{
z)rZ&H=zsP$tYs*)n8Jd&0dnoyrX~w1Bf5Wv(W7X#rbQ7s**?kQrTU0Ck*v06vHYVU
zIgwhrg;LiM42&TNoj%k0r66(y(m=|xp}c(XLAEBN8~d^#3Vp?8KkU#T8|FDI?LnHI
zI+0)GmiE|G#Vn}C&3sBN$fyrnJ439R?mEC0CnO+Dtmcr{qbHuk&it5!{T8RoASks!
z*N<|y8yTnfIuOHg5pky;6MoH@M$I7bj=LM@=rG))*;H%<2^w~+WI+2Ks$bZ+*>5lM
z4fx!1U6q;Gu^?`j#M<VYIeS>d2IdbEPEVXPN_Trqm-bkFFj1Bonp*qt@j`d&m4Zi`
zOJpUXm{UOh*nXFrHHoNKPzqR;&^#NCJ&;+e5uZ&NfxZCHw1(SO>Y`T2W!$ouM(1p#
z&w#czomyYq<r*h9`mKH=FH-Zf!XJ^4j4DiA506eJj*{yS#2VSNzrlXPMe3&#iYU9K
zex<+G^MCnsVPT0n=+TQG=~|G^+LiXAti<@%t=HxC@^>zJj5cf17VrAJnHo?CNExmR
z#A;U4DP14Sid8(O=kiTvGtm~LqQ9P?2~m^nO<%)5($uQSmT;?!In_L6f~LHFzU%@}
zJ_nSbyyv+NbP$kiB~k2_chv>Cy)A0p#h7e{w`}5#_sSCG1-^aFA`Py}2U4%+O!<P<
z!-8M%B)G!jbETQj6pPq#7xoPeB~L{NV+X$+=aTcf9vm<v1TkiSwLrwYJX1-9m72;S
zGJ5#FI<&Y3k&fj0$L7_e-Tqft<@dh-Hd&r(YChf+^y{`IkL)`r?DKwa^4g+c&gf~m
z@m<Hv#Y;rGxTIR?KCz#CVp&g5rE->BFBKfl(nGugSuCLV9;2LUJ+4*%)sXB5#2e+&
ziTJ&@p`;%6(JS}XnYG6}2RZlua;+~O%eOhqx&Iv$9}(;bJ9R8BQvX<l729+xh-h|(
zy)7zJUUDJm<-e40f#Q7RY&h$)HnhR>LmEr|y?%`EclUVsgd|VqwCV@oR~Ub2nfd@f
zw`XPBZVTbdlZAE-3Vt2$UTOxUyj)v;3&~q1*heU9I(?Tw$Rn-a>w0tC*ZjX#r@l6e
zJ*#oxRN3&6XlS_t$6_eM!)W&o#}s5Cn19-`o4PFPS4-nK23uWIG3BDo1%d$XQm5gS
zbrb|^N25JZ=eKGqEZxq99`4X+7V~+UTt&EGn;<bHO3g~e3d*Jb(R(M|xJ0CQTDf5@
zk^V7MN-&QNb-Y3=RU?)eeg5|*K0y9RYu;r6`$1+1cb4nIpxDE+fUbazxMfY*+3$Uj
zag4+y=bA1|8JP8q+HDD<)Npw`Y#Wi+zg6w$!$5a%L7h!OCYYEXdJC3V4MeAGA;NHl
zif-!1hYwxA#mB?2`u-nF_PRRgHqs*t4<#Jz9IXdMz7|h_^sx_lg$4jD!)CM@pj2d+
z_eGX>TUdD>*@tk-`>Jo=F4Uod(&+WTW$fla=S{@Qc(mGfXO|y#b9K$2^=?@Tu(*dG
zGGALnZ7Z*bttvNDvdz~zoG0SJNkcCu6&8tDnf#XTlN!jn5!VxE-@KZW%Tf)s`i1${
z(!f~L0+Cpxa;0MPuSRgrBD;D|4?869dyid*GU%Xys5#Auq68ETDD@9t%s<3NoaX{Q
z$dM3-{O20|pW*$OdEa{R?u3#4#RfoE`U{yOB8(%H>=3`DT*}@5$Jm>IQ@yTlz;?B_
z=2?Ttu1Fb6M8-;`l|p8+*d-~-5X+dMiAL=RB}1Z?j77pSRVqd1DKp7DESYED{Vv*P
zpY#8|>-yGpo$SLJe(U|c!}HwFec#VC>proTjOJ!|pD0X?ge`Q-sR&jaFMV;0{hr5s
zsBm9sC<OZLcYR^kT`hTI?>`j8iaEemKMwS?w~H0-)#Bd<dl(gJveiEC)kRzPtCwA-
zcO=6-#r#rSRF4}6?M1?m<~=kW!A!q^=&0s6rY+}*M6+jG)1~$5o=;D#`d!&DIJftk
zvM6=IqU4T<hp_7b`jaJF>}%ofJk;gKD`8QidouK7U;nWEJpNqfm+mAPPX;32l5b;!
zJmy$BDov@=lhIXJLBHx)3ic|9#cZqiQ<091btR}qaT|as;fb1Pv`R<Ji%g5^NdBe}
zTYVki_jL2zOm-b+^V`dlfSLM4``5o{>;Dmp$`AeTCaQgHvu!P6F9TPF<{w-(mlO~r
zOy;!eEL^&vNF(ce-20_-r%&#&(cTigG0g7xeU-*2e|}Ye+t+pGH+r1n7<JXhccwc>
zQjCqDWcXSkmo8DJz1yG_e4%Gfre7{*=@yKKb)KK9c%ByR`A7C1FCWta4P?+94MwR;
zJtc}5zWr`CC>gF^S<@9+QT#XUERTuQl$ecwi9~Q4ubv^86G|a0My{3JOmh4+H&^*W
z)$1bBE0+dJmiWJJEtE&~;>(uAKq;Df3SIT^KFP@D+DyNY`m*V{CuVm)fSW~yp{i1M
z!E#X~@b2!%c{|_WuBMOW93Z~~+^crJYt;;;!~S8fw+%g55BgcGDb)G6j8WGpxaXMP
zUiC%ec{#)5^XJ3#LLG2GoE*Q;^Ywcm^{I~9r$l#_vF&P`KS>hs4;ov7Vn+c^!$9lX
z-E(-KY#B$;a6A%ysYyYZx2>L5a>cs8-J7L*a^Gb%V{d$zbtZv44OjF*pXtNPp%+6^
zB649za^{$vuZym<Ig^rB?(N^YdSln60y&Q+H2;>VB><9Gm$Qpa+3#o@t%Q2acLz%V
zBu>+l&72Z_+v(=UO?NJ*{{450Nb81yw!O%{OLpp<kM19~f;;6z&?i4pqZaY<6b)1V
zkY?a4CW-po<m-kVl5ZYa?8Q0yAh$r$D&4Fm`PD|JmvPUJPViiq%9T!+HxKw@30K4X
zWrk4`x!2nk#vIfc9K~JdRIm;}(#!eDn1{!}v;e;LC8&&WqP<}`Po#trHaoknsu;<&
zQ=!_<r$OuLh#hXa_l7gS{N(}rol~ws(^to9_vRXP8uipKH0c?8-01N6$z_Y{nC_!*
za?Gz>eaz{ViJd<t0J{L~r8&95?u<k1FebhNc91l!CtA+Xd7z|{C$Z_RNMfqY5!Yj}
zD(*~lna`OT-^XG2@<`H@`bpsvr5*eQ|I~=ze%`2kVk&s&0fP4GXHFTD(iZ#DF8hve
z708VJYd_2KN%0;a1+7GL1+hD(xE%<$C4ejB$ldRZza3P0J~kooXs}q>cCI(Tx#Z++
zZy>j%+Q~l%-)a1b(<|hTn>wkCA&1V^1yZ|m)u+$rcMC=zT;xw}t#dHW*mC2c^X3Yx
zSX8e#$|vhpr{Ir@1P$IMt2c~a%kA+><iN2iZiz{kBj;*x61oJSzuw{Ga4sXBPqmT7
z#_dPui*0?L#Jhc`bznAQ#hNv%rRq+EmYF%wO;B}~<Qg9t(M%q0z8VPJ*E(v^$pXXl
zpbVv<?%F6rIi}7`Y`P8o(vi~{I#{RSBG<*nbc}yFzuO#$l3aYj+p^*`$Co|r-wd(E
z$CY?FEU83^laHFtGa!p<0)6QX>;|8+>BocQTZ=AFCN}zHN?o}HdcnZnqoPSY+`FCb
zY-(t0tvIm7^J5Cl((!uvW_m0QPQ4NVQK9DyM2@C9=K9~db+)@a{c+Nzb5a&fPc@A7
zT%2lknghWyh|x<5&FMr&Q)!h3WZELVe$vQP$B_l^HgtqRs-E14@<k~qhhgq(_Nf=%
zmF_*}rxLU$Cf8rIqSHons`Kg4#;UmYZX6U$gZtfKt2sG4+Pi;k6Ku&nvg@bArLl~~
z4RzI?;AUT3n2wU=?$3W0w$a@>FLHaow(C|BxvC5BDquP@GcJMiYm1eC?Oa4Okf%Qv
zGT=?vQ?sMxg4p&wj$oVYZ9np|KucE$H{@h++Qr(7pyp}n4g>MkOtv=}j=}BbG*H@?
z2IMNR+|=lCdRS0Y?_W9Z52^&Mo}8Qvl5X*Beqr$lMcRs&Z{YH@ebL%IS3*ouI->Oq
zX&F4|O|R9Mf=Ly$$Jm-n>ChqVkyyboS8`?kNjF1U?{=!@S|x0B8QCZ7VtQHLAVqVP
zA(u1NlRek|Zmzt;k4QP^%3GRrw9QQ4G4x2<&F@R~3D7;)eQNo7;)zXbfsP|nS#;gp
za)AB%O(NHz{j%p=)SKyaId7~q<3f0&143Pa?ZPpA8Q_A^pVYe)Q3cXl-(UYO(0Xj#
zDh8=!&y{`qlGYLAgE8ouS(P5Q)Sk7UtLY$Hc7L3fp3Z^h?=Q<6)q6#4#YL4;Go~Kr
zPxYS<Qs^vxrYwE2YlDk#;)#!$BmS<|&c?OXiMQuaCz`kYbH~gIs!tcA=3&<N;Dwf<
z`R>Pw=PUdESicf3cGk|^#lCNAJ)<h5t{0h+laxSICL?h|sHHr(etY%$_3eF^5Eg02
z9EsZTO~+NZS*FW(S>APVOT)%VvIatA;)(;XsYg)aRJ5bYduU4|Z)Ij?${VDA>fU=w
zYg}U5&5c=ZNIe!LL(|4h^EK3{3;>!gFe%FpX#B2ZOK$b)Nb$YrS}&l!6+av~alVR=
z*UP4J3|qhdJCz3ga<Q7|`&mt|x6&Tfx!H$qO_S2LudggFF`;t2dv|O}cF(*HGeK}0
z2=qiSLupCNA@jjC5sM@}&tYTqYP#}%Kd{Ci0j7CvhX@dibv+w)o85_Dx-quAzan}(
z0r1tXJBVc(`}C1OXB@6K8!0P<O?z>~ik}{@!0(Lc%jm1P!?}W4dRZ*~?#|WI`QFXG
z`6;MY`-jBExaHY$B6XK3o2>d;A&8sOa59N8BV38i@EA^7&sOM;;_h~FaZT`7i<0VH
zqe2$Cmfo+iq=_+|C#A&=BqcH^;QC4gPm}xUvRjoL(wU5Xj6r|1s<cNvY5gjW&d$zG
zqyOB}igZLZx4e2{L3HW(y8gCZPferLT7+H~suOKG9_W;Z-CL@Sgk!O>E62QB6BCm`
zSB}R@{{V-@ijg08>u+_F&NjeaBqvB^T4<Skdof}281y@5(eB2~TV`j=g_7SF>go-t
zh4YE3g1$4@omAiP<I5^<UN;4FGN{!rDypU0#R=9w+aV+#U2N+3_~;nQc0p2(`;B;{
zo?P`@DjmE6mjhJPB6F2}{bN9>*FIQtP7YWO4py+E=lxpm@S3LVxYC-Z*L#w;XmU&2
zMqkXFn4BCOt8pYm!9JCc-KF&}G)%K;vGQ~+>(-4r6%LP&-nw%~)5*z$5QC7`l1uWE
zz;rHdP8AeHi3M9n8(2491;-COo=*c0?57HE`}MWi8>HuJ4>(FZ&Pp`X3LvGU(ia+D
zPJ}uHGCrgf{e3Ee{QTLydUnILY)cMW|GeiLd=J4})xpG~thugXTkpEaQDd_wq-)k4
zCb5^tVyEP)e%+XZISGOH(N9+r(Fo|6KffP@DcFXM(tR;vZ(Lts;`!TP-o$}km^%EH
z6AZiFBj#2g0srWs-@L(hH|ce=yiH)-iudHk{?<=oC_i5~m9AX=E^Dl<=`I5MGwYTu
zo?lq1lbu>u@N_f%<;l#4!GrPqCiPTUf7PDSweM=Wy5ybQcm+8y(%i^q^~4Cj3yL-0
zcxu9>2TW4L6Ws%j5DAn44v~8Af)i-n&?No<oJr-kj~i=K*LQqNV7mLo94-U)9$422
z;+n+CV)Mb?t*kjmd)JBZz+a9!&)s9wuyYfS)AibN)Ho&1f>@yq(FsU)ks%8&sGqz!
z;8q-S?6F{>=w8=j6EzDbIi_`mI!8A*H=jTiF=HjyfaHtzn0G`i$SGm=<B$X!n}OVf
zn}>Ps+V&H^vd+O<y;L>hHV!*7xLBXuk@u!sM!XeN*=)DU-cY(SB9i1tA=7-b4<*K{
zOHw^SN<1$$-1nnBr)Jc*L=H<#yTVzfJ=lx8RPwp$^^<W`hXY0#0Ef;U>kw1A(WAcu
zup4*o7aEsk_3O}_$u9|kMSmyXr)g(>f8coQRs^H-!f0#x={Uhf?pnKza2q_9pL7J=
z<CB>gf~5Kwzly6Ur7B4w*F<+GO1qgMk{U?cl7=OBHThIozMks0H>15PbB)m(HuVqU
zMjcDd*5BE-XTs5hNBa9kOT(iM<tFZlpzm)9p@?5n=^mE?IUJ@NYlWO$OK&*b<yr%k
z=v;&HK7<2`Y}Pf(K8dIV)6Ky+q`x_S!S?%)VUHc((e%VbSU~I!Rk?nAXxdQN&HnzC
z#}YAR2AS(elEWF}cSzv2_X07rGD8CnWs-)27ZA<NoHit$1gam`(sJyy=@<LMm38_m
zf0G>TJXCU*QDhr-iF35A=DLkHFK*hTZ984iM`Fm&0-I5@|H9-wYVc@)1wjA6%71B@
z-qN1yl|1iovQ(;FTdPIwX>V)4$Qd0xthC{Zj_18go!SrMM94Dumd!3hyB4JiNQYFo
z4Lm*ytO6o;Tcf4@ZoTNmh4GY&&KVEu<OXs^K14BEqOg5?(puxPB=($pv+2)=!LRaO
zEDEEd@^FSvHL};nv~Q>!xNzWpU(_K~xEDX0Ce-!N4}F&pIdhxLy#_WXK`#R9nt;>=
zev-xjUTaknG|u(sh-GOL8`cwu!jBxVurw(wR709XAq)vLnP3T+M5B7AT_1={hG+`B
z(Dn8Y-;fsmrzj=!@1ur{!8g@_kHQ~YFv!*&Y`F5Dy&3b<YhLZjh~&_F=iXj*;aKC8
zO3zK%x|mby?eh0kY0bG#i<TovkFYNox3z3tYF59y*mx6THvQ8Y&j1sUu()wPmA42R
znIU|zh;uI7GFcYpoU|}?si7+JdGn9O2gfE)xJ8Kl)oSrX3`q0t*kdua`ET9X_+%yZ
z)17Nu*Cp7C+m>;>5}M@{;vBPDf8=#%X=sqEq_J7L?M@c8xpX6xRS}BB6xJerP`lQt
zGX_4|@ud3)#oKk_rxMtGQnCGmgTBZeFjBOpyOK^bHUqQY*oymc?{{5Qf2+I&y~7%)
z*%WD6;-Xob-CQa{o3mJWNg*p%)<mnA2~XENd2+%mt>vz{1`XRKeYAGP3@AGY3Nm)n
zqMtQBq_E*lmJD$XPm-{VMLB9Aqq)T_u0A8bAmf|CxrZ@Zdv5or$Dk)r5C{2KQcRL<
zHUTYY8~C|7r}hX^7D{@;oCVwq*D|MImwZ#DWs+a{Dfd^ztX^$<JNK`86rId5!F)~k
zgz>n&Zr91|v(`&RaEER5+>e)1^kD%?kW8Xvse!Ag`IzHO{fQ;mRV8w^h$3GF@i)_~
zO5?9vAG-up;zI>|Dpp){mt^fNo?11b1wXo}rlD^;B63>|7hKU2ecN*6uvLO|{i1Q{
z+qd$S)r0JW2Y#NjEt65G8jgsSK2dI)(UHb)Ul+wc#F|oSDH~*|zdm60=aOTZ2h3@p
zWm~7ACIeE4x%{S%4?vK3Dc#kF9A|y-Vi)|c;NPmz*MH@b?99g@-`l-i%aMb2;0)kx
zugm9_o$<(KtC$Cd{eL}@m#?fjiUUK+t7O-k?U0_8m`tAMD+uPNEX1)y+{nq(t!{rQ
zVa=!iytYs+T}=M?_>k!flr6l)t#fRJ#}#iKt*Z+b={Eg%CN+Y8y3?AXp1kMIB#Yku
z_83&~|9Lt7>&YBo_5;}m`?<4Gf08iHpV0q$BLIYiaL6LcM4!{aF$@-Az1ZEHbl&-|
zhX7{WQAFyj3rB5A!I>e%dV;&aqyIakRGg|n+|%Nhao^{~R{c~yy+_AAGlZ@@Qviur
z{=e^Evjb%WPO-L=s{S*3VZ)pMd#h%yD8l)FZ^g{-lb8M<qYc&{8l;K0(Eok7cmAKN
zn0ZpH;{T5iD0|})3n+k%a$uk4zux=*`@{Yw_jIqKwz_^K=$rRZYbtpr<=9o^i8@ME
ziOIj-WA;CvTqasOj%^4uu<;TGldAuBbpZLoDv!{B@ZT>;Jd;2z^?#H~lqJVT?YC=<
zfC|u<3{H}&KWi4auVRU#@xj*D*k$Z9lrn)n%Tm3wio&u_zxvS*u}f9*ZY?bDU=h}C
z{_EW<c9<W(kC@(u3w*wP?k^Xb3@gtXhM)r?>W{ypMuzeaJM1zoRQ-)%XZ0NQk0aiY
zZv9sqR*V(@rTZCLD7kHaZoe%1TgIfGz&0UU#v2V!yT0k+Ww*SbjKhi(5FfBZaa%5Z
zrs`}JL_SXI?BO8xZj0o`KUDpHT^jl6E{0e{%P|jUl7S%)0vN;fA=`+C(U9eq!j_y5
z-u1s<!1nekUa?)y_%W%wW96eJCmBPbwzSWjIT0)WcV>1RCaS%ji>N~Z2+~Jp8i`Pp
zZiAhv@KfT8g}uZ517Zyxe>a>7p6M0oF7Ute@QK#}`xK?gQ%>4Wd7n>OgWDU$@gm9>
zN3fN}XvkCu!kAAbxignpar6Jqdj&}ZMSQA`dias$@Tpu>j>^e;cCr_VN&f4x%&{+X
zqYjuMtW*u#8N3re$BYBLk`6L00@;XCJWN;ZeAALwmi#JC|5|M*jt~H2u}NdfN0fcR
z6^LK9ai^@2HwtH8>I(|G6MyLCOJ!J;M%)L$w738U@iGYb%2N7UX{f)_;twIso3a*C
zT9d2yJG-P-p|E5s)uz&kZ#!?YUSj!ag%FqC8}L&SrGVAwW5zr&I()L84lrF~Z&}6}
zOs=Nn422maynx*4h+R-!c!xiE@<cyR!@xj@(l<CbIPgz3gM8PHGNk>1pG2lQjkG+n
z`-DsfrsXH#YH}fBfbsU9Gh2tgX(ukNSl%Ft)~TSi5BBX9UNdo%PRjF5)?2uZ2t^gR
zzp^*d)X3|%{WV7dabauHc2;i>)OkdNb@^$(bL8(aJCFwKQLR1Dq|-P2>m5~r^yiqg
z`n{iovIDfIGM90`E9iqTabVnW7xfP|s$N1*K~?V;BZK_4n2{TAv_C`2f)DvxV=_M`
z7IRH(f@PJEEMG$uJ!}=R;IrP{AgKbeDmonaL&F^jOI>uGP)1r-Hqc(81=U!yEFT{q
zl$xdZ|8PS)L128mNc-^N8vthM&>Sm8p!r0N0n+1?2@crQLi0?F!=ZBzt`qq8B=N`n
z%03qz`KJLQa?X{K@j0aFM%YQr8qU$9PazZR3~vE{jEIE+0z`_*ZlmC*`d9btK<S|r
zV{HF|jzeijLTo^0ShmC~YR4U&j3FX7gsx5?$Odvm!b>8cfRCI{IBLO%8GTdOMWSBU
zVeJrXLB_5-);1p?j_`^5k&<gOG#W1fwG&5{r2l5KR<W<heR9F>A<N*O&lVXI9)188
z7NAw9os<<2ID)X!7o2d|s6fWU;{H+@nv>(haaOVHJeSm<yYqTQc;tjQe&on4V<ADo
z-0mI^D2*Ww^CtQVP<%UT?dzXKZTi>1oK@RxIa+LGpp~5h(UFsg^_3C_)W7AJ_sUW5
z=^QVi57NpvDgBk_T0dI}H`9vCvpWvXr}e^mfFUFdErmYVJNzrvO#@qXmIR8c74Zt;
z$z=<EI`k|s;g*fYw{2Q?8!77j3;OM;OjW_*50tDi-tDt0x%Yb(#T*ndXCkz$I+R!h
zYMAu(-eBdxCm*-><EUV0k82OfJ#cX&MRTkJR%9nNnqCqNvOiI?7&Qjp4Ux(_$CHzB
zTTv-P3)_Vj=z!01btv8{ffIFBE@6j!?LAn#qCqvba18HxhaDJIu;n#@PBmSEXas)X
zi|%qt9Kn#y{bO<AP<J&f;V(R-<C#)Yy2}0{TA8ksr^TqF-9+e^YR|O$x@y&`uyp5P
z>3n~}BBZ~<R7@Xjc?|W+aVXmvw9e<RjI*7b#{V_oY>)sn`7$?;bhWMUt@G&{O7&>6
zveCUBnl@V&&Hfoc+aPZBcCMDkYQcVx8Tb6&i{PBr5%3KWi^s<$Ws6olmx@&&J1V5Z
z*j%;b>E{bAko)-$cYRAdfkNz=WPYGX{wEc5-evdodm$yn)Gog;@?pgrpV({jb%gXZ
zqg)c4PrhGGfsA{uZ|}re`tZ=Vuw~~i7N1uNLOL{7-Qz-tBqat!WOkk1XX`OFL^vM9
zy$G|(e8u7ri_VRW^kN-O?&j4j$%NGfSWDPlW5>WG+A|FmA#8*eXKa{B93TWR;NAlh
z{RL6s;UBE1mA!vK#Dl+C&SwYfooLock1yWsf`ZD+<VT)VCwg4Je(v3s-=Tl-;{}U0
zx1{<X9V15c3BD5m2Q4ho#Z8zRHtSa>Bvgt>|NaR@%cIw8+rcC%#kX5x49roh!b5fH
zl+;Fv%^C06^fAMswqE}!BVSrGrd4Y-gbvuRWMbkbroOTC(^*&Th%^sEl<h*vjXnkD
zuZ@~pw}TFX_aljhNc{;Mq)XiT7G!;EZ9id<Pt9;{CU9TxUwS0|FTF9s88Z{uULe$t
z2tSI?RKF)9!L-1xa!Fx+MTHK!A-o9}Y|IqR7<q3kG9#V!4j=7r6@(}Kdq?O&U%QOk
z2^%D<K@wUP>j;LwH}CC_Pf=7<wfy%IPWB>292V^83mHOooVDn&a>c7nfzt25bBu$o
zMMrwLUH0}VKnXb45p}B}$udbwkN;z-!`l}b0r8b0kq31n@OP_uO{Y*(YL|mB;u+4B
zZ0m!+Dd-RZy3o|kBXQd^Ggk3u+Uwbms@&7c8%KeCaW>8%HOjejiNn!&i;{29Sm-zv
zxTCEr7bslE`OV1~_Cid9hr+VwRjR+SjqIsp(4u&^qrnKo1zLtYkRr^uMYQ)9DCkU2
zP4ZE&y8L(#9z2NIlpo^=Etg#SCDwb){NsM)ndy15*(Al?o6(}hA{fy!++eYkWO7kj
zs-sICV&9+bA&k%NRzToo;3A(?MG1|=PFTo%#79;08?{JeN8!2~$|!wnHX)K+oDJ4b
z^u;>l&qo5pQHkcN(InKjCKo|-EG_`LkplsJtyJ3Gn(4%!o@b$Jjm?pu6hBcKlew<L
zy4e+yh&kQOzU1V1^Ac3C+nHE7LY%`bf9c!KH>L#}Da41rBfSNx-8~szckZO=pZIs$
zqxKBiB<W!1{n&uDfx$&B_Am2`+EG<zN1#D1_W5C{bsEhQJ@Z!N+Ede#Y}k`Jy4IE?
z<X5;32W7?<xj6dm^7y;``l62>{lf?Ct<8f0&CP^n?jh?*W|jncsZ2%>jPt99Yn_?t
z-r*3&W`FZHa@|g0jQ6B=#?<}CV!}K8!v_E<M*kZ5hE{%XZPuI&^=kUOJ7xg2Q34|w
z=)Bodk3fq=NsPgej<N+!r7_B_W^xG-vtGHf|K9bvh{odAaBLrMSmEDlUNu-)AJ<{^
z*Rj|0Q=1~YkGaT=*NpaiG(8Rwx9-d+EUXUtgcG^8!*C{O*iF7dG7L?UhkPcgp?%?_
zT)upnCT4^{z-h39k5UzHa$9K4?Z!(m$~aRH?BZ+pORPsOeZoL))aYJnSxS%Z&zoaF
zUuOcCOq|O^JE1M42Wt@BXTwZvo;=Z`y3Rw~y`QB~G9SqI9$vEVGef(+cAea&ZEb$i
zkNC&`-Wjb|*7`ADOKpe3G`pg`BKe57gUx>sAD(2pYuB&u$*6<LPW3RioRg;a>Q$?n
z)|o@vkl6a-4$fwr3y_F$HNL}?C!!nBMquyb3k@PY>EChf-eO-X1MIj2$|0DaRSy*B
zrxU2Qjv+XHDZ7j+u2JF~d7*9Ak0in+M0cGMvbz49>Oq5L?M$E%KL?7*rLiqp4L^0Z
zvXxw1LfAg8T$z)^#2IDDOMy(o>y_t5r^7SyakZdQ78l-<RqJED6cFIu#p?%N?!MHw
zR+0ZbDuIMx=+Q|se_W2Hn(o<k%TOk1aIbHBzV+Dbia8&sU~xLAR1a5nzkpY|Lx?P&
z+VZp%PRSvy+b?Anx4I4=x|J=>cSId1p6uAn%9bU@6i@VVKc7L_Mzlr+^5fA*pXay<
zVi(ZHxP=Rb?n?#AMw#`b!0}9NmqqLxu*c@P;iaDk75NX$UN-sR-udqBZ<$39XjyZG
z<R?f`eSi*cl3fQUg=?*cqU__w1-j1bKuDdyx$DiP_SGA?BsLqqy0^^lp6Zrm%)dUq
z2U^=R_nN}gStyrSZ}>;Y%uRknoL;<7ztVk;s}+a~5l4U}7_`W9DR;*@bWPMo-xuC?
z^q+tfm2%zY!Gj0eU<L#$oQ|r*DA?u5{nM(Kb+xn(4Bg`FN>8tKUYK-&@11cry)Zgj
zun_&TP!jkk9cA74ozJ7`_?GVy7j+GM8~3St4p+Tq<XT-4_UHz~U~x9$s`Xw}+I8EH
zXQEOIScpSI6|uBe6Gjs!sK9)ANv|sS4vA#BnJBt>i@Qx-qFY=it$%EvEo!{FOg;h;
zIo%Q1tOQ!T5aXR#WFdnCtS+3a>%>0>TCw{rV{(6QGWY^L2TfbCvd7cA6u6=Q6UBk_
zg{c}TpXVEYvzV@^3>JA&mE$R%%dP^tFtc11&=i4`*<vkc4uKR$IEKKkFb?|<qWp9C
zp2Qzwqf^@^(qtvui<`Bm{RG__9zJ{+fxw>bxOvMK(inx0mv@_-92JnX7S=nWtQH3q
zL=sJ7kd)!@{9Kaz?=T_4=27a@8L8OFECZZ=zIGd5J2wpzSpmFK=&!KXM5T!W(xs(q
zm1$=<*CR}L3U+yHUj~j*J6qK||2bb0BY`^Unq(ic7q@_&T8+_}o{Q$kz=2LHFJR@~
z1}9jtWgbp<?DE8;3SL?!uXJIh^c-_Kiw2Q0?A%3B71e7rFwXYUy0=lTG|nh<Ve8FX
zw}{dh7DnCe&t?##nL#g2!FA%a+jXaQw9_if+R92J>nCWXTKSJ@y)QL-Up~+A?BxZA
z(*Jbd3#kueJ3v}jTJa_&55zojrg!~(6<8y1^%BkoFI1uNUL`07RWR0=A3q*6Z+>->
z#FTR&5*E#r=SWUS{r|tdj+qc9FU)((hU?wpvOJfe&ZUIi7tMxPLVWlOB(>Z`RSh6E
zRMfPN((Uks*$)*X@$*Gz#p}O)sJ2KwmVJ+B_`fGp=?!dTArmG(bw;C?Ps);7$WqA-
zpIFp`OUSZ7T=;!tJS9*Dd`*~Y=s3hOf(8tJFOeV3eZDZY4tf4yPU(6As7U*}^d63p
z8Py6$jw+HJ!Yx;`y!aCQ7xF@6(%*}CF@+rKtz@CfOp=y26b2?p6q<^EzKoZE{KIVG
z!?`l2LtxDS1+eB~M?z095>ak4{%T<A{l=DfO6<|<HEUYzbYF@MIo5QGpLP59ve>Km
zbF#ez*z=3tG`YWNZJ(1k?5;XPnMZ#c9QC%AIA0j98^5#Z0J%ALgpCOKkutrY)VKS&
zP6?Y)rHHHdYp^&XT&fR4HoCZiWK3Tu2_%I<3^v%~7;-WObND&&axs~n6r8W=F;9{O
zl;5{5$e2s$KtwTfavIyRS@jUN3il@Vr4COFJ7Vt2r{5W807i?^9lVSl4cWb}<XB6U
zR43RPK5TUZ({e;slNZNwb}PwP7a%#pah6E@=~xf7Md?m;Oz}5xERv(LNci~mGCkN1
zfUBw1G;Va%K^yfLJ4cao#q$)O2m)pT+Vlc9!fZp?p%c>q?ejlVblzVj#T1aBCFXr1
zYLE9Hl}izkX|TN#Yfc>@VFS^BAbJCrjU=2|HV8UjpK9NXy@2zI#SjB^utMW|@|yHe
z@u<Xz_ck`BDkYZLckFEs)}ZdVk&}y#p#rt-8JLL%c1JHk-cA4ewBmBq1|a0!Aa7}+
z;MP1h1coiZFwRd-#VD+6S+J1tv1G<muQcrc1%k3C`DQ?=2{78mg>mg`OG=84zl_F8
zIg4x`kv_5rd@FxI{$S6<;q$ZPkU62^`W!vp7*ylKR=d(4_C}YCATkoBX5_qxs^wXm
zM?hitI3bEg{HiBp+G)!p*crVRSTix1u@W`7&W<k|F%aZXh1`y?HJelVsH=5^s6WJn
z%-|C^AjY~egT%Oq^>`~Gz~A~1G$vlkiVK?wHMre7b`SL4j~-QXXYbsJ((??`$L9J+
z7dI0J#%$e49ZR8xVGsAOfrDe(#MQ;5;h6U!cmyHz<bL;(%}pUjmvOksFyQq3_2nN>
z@QA`31$M8~XaGdN4RmZsRgV_?x>rF?kl5SJ=b>^f81A%mLi`0@u+6yBpQGm_1`7Af
zCOUM}hCM<c^s}h%26mUZrhcsA?0uYJ;r5C3MJm>k5S2Xk3J>&@WE&R*!^CIHUMY~)
z=UkKM^)Hau0#h%0=P$rgQwI@J2X4%kg0KH6{oLI!9(nK^ci(V7Qo==G$KB$)t%;>K
zF~L(BaeRxSBm>Dp&exF-F|D4DvtFP2vKh5^O*OT)`6~|{dVMjVA|C~ISW6MVfo;Sq
z?`wRGi>qT<dfa(oFr<R=6WVlDEPS1HeOk8yp#-5jc39%z!PnZ@Hz?|`5Xuk9Z0M7F
z&>FcbJZREp_e{N5tBpHJ%bB&SuoaM;ko72iU;2Ww(J{8njCPIvxXlL1smc<*nLn{f
ztU<}Ein|Xb4_Y}YKlQ4}Nl}&3O6~D@kIfy`i!wt+#WO%M#bq62hp#ntjz3M+l-9u|
zZ28maM1M=LAqzBp@`pt)JpE=Kk(SDz&X8)`mTR-HcY{8npkho?7l75*%byCw6(j^&
z&zr;d!lnB2k+=dF<^80cJ|L(niU=2b;@p4gEN1V(l_cgtr=;HK$1u(&?D5(#I`X-`
zzTWzLLM8gPv6vdfx8!etuWv5MfVa7>1?mH^Z29)s=gUA@9qQL7@gU~elZFs<$Rq|X
ze3TgdByEV<7BXL)4YthK^OV&%uryRriR4trZ7TJ<(PQJs1+n!l+fqeMI^X<gZqHh#
z(+NeM1{_vid_LUj_CXz<TeZ%1o#>b-eR1Sv^g(T6z~b}RLLGGRCC*(PK}5vhn^Dj=
z=;yW!+($4v=(c@77J&5u>89SMO?g3eGi{yF7s3;4%6&+6t+?1>m&dX;I`^Z`31BM;
zWlsu;4-6d%`H6Ia+lKx3+VAartRvivwA^7m)E2#Z1#awx$}yd+pSYw4uSONP=Q<C!
z6FueWFS#W@zQl1d8Y<%;BiFpxw^-3i1oj+f@&X&<z2Njw0>=g|T}5~^)VVs}FOQx4
zJlY~=45C`f;!fY7R(K-31|yQ*s;mzA0Aaw0m>*Lff4f{=C{uKZQBoqgzNZ_?4vk}-
z<*wlhF%v#eZ7gnT9v*Ek%A_qk#Bef=&G(Jd@wV%(dZA<VsLj@>venDMEZk!m559mE
zja$0!E?t>?6Zfc&%#CiP%l{Mt7$T@)dUmR&UChyWLu~CU^CZG(LsFIf4M>Pe1xxn@
zgp-#7O>gXgK6&}xtb@M_Q^`3*cnxci&e5F(dwy@|n$hNeGPx1MfHKNgJ}UadwVeU|
zsVV4r5mmAW8f>Cbet*@3xbTUp20mfu=`sq_he0m}<@mFTwCSmfin{UfE_Io1nS^gf
z(|HRTcwX?X-0i(>ImGnB;Q0MuH`hD4OFf8MJW#>DZf3E))gt>C4hoj7+$*xh!;r*m
z#hS=M8H*ACp@KFQ^<4Y*rmApPoztCI<(qFb(R7c65|pM^xC9%r0FEafBNemmlkV(k
zlS7-6=D09LM#EsV6<L<BRn@huT@N!0ywbzo8ryncZea$(+Ueb%8$MOUO((zaeNuVe
z&Q`r9$v)1DN5L>mUng$rNwEt>wf={g?6**3CD;`0q3H_2VdKGeA4Kqv6RWb8Y$%uM
z)&Q>*?Nq=k!B-FM0jIL~n5(Pp=6P%l0@48*3DeW8)n5@028B612cXES*lCA<th#c{
zv3<pd{e`^?TiDPnFC&rE4<la!uoxX@pLOe53geGiZ`3D#UHg(&sNOAwb1e9ccIHqv
zs8m#@ayWruHKSmT|IxgCcln4<D8K3>bbHBA8778OS6u8c0z|T<WS>S?n%4H=&ooQ6
zK(j)RhEtf{xebQ+Du%9(Pa#Sbz%9SNXzeyA(39TZkNp;M5{^<E){0Wh%7wmJ%L~&$
z*TEXt4mPd#z(|v#1oLjil6^$L0r#Dpdg4xjsD+Qh3Sj&v4fJp%Zr{Er@Ke3v>u*Ke
z#b*-Q?@Ag<UR#XO*H!(bKv|0laO{;`rUf0TOcmnrg-3D+EN0Gq^gc+u-7F_ukNduR
zheT}fuS|JT2eWM_PjZjC=9V&tjl<z&*RHChX>*R%`ia&}A#zkNWlSnTBIKK?b(QYL
z*TdW-?PuXV_B`%sSgLu~!`8q#Zp3-(i9U^ZR&YKBxm5C66=;s)IQs5_A#N;$QGiWQ
zuGg3y6WV{((LbMpCW)z~4w{~U$EI4}hf*pqYikj=NT^(0{`C5L{nu9W2ItI~3*#%n
zEd7m_US?|0KU}%uCOzj`S)$V*yNWTPy!NWVbe$Lx!Alf$Tx^+9P^?JQEn;J92$rlf
z_%Tx@d>h7MjbIoO0*?>9+cI0~whnar^SOUddrfFg>{ZrCbS}f;9D(KzA=*MNCr~Ch
z4uJtZ*IEn}CFryIZP&A&#@SJp;J+o%v=u5D>^d^P&tJAtS~raCBqo6d|6Az&7>kRq
z*RALf_j{C5TU54#IdG2N4`#i6B~=vSsa&Utn)$uN>4?}R1t)k8@UCZU@vBI-Hm1LV
zC&Qz>#<Ds^3VNJfE77ff(`{f_jRmCWU|sTDlq6|t1@Z=|`zk$`I?vqZv&-Q-x5xF*
zQ3N?K7$(=acP>ew1y&%OQE+<=z9{)6TdZObGbOv(0SfD9i9BUrb|GU9`V@`056iTV
zkWLjFdM8qByyEbM+8EkvF}!d>3%c@m^IV@;+3AUO{-Gak!8XYS`LDFir|;`<2x<m(
zh1A07BIpyig{d@4m@3lraR+utkJb+Br=JPpePQfrSCz_iXYtoq7Xp8x)xW|eclK*=
zFyoSZoJSkF!*fAF`fl@&A7@!YS2yUsh_TA`R>3F<aN+4}p)v-vWkLns{&ai)iR19p
zsi-v6dVXoG62*df^4JjGJlWKw%Iw0ok+ngYR{KKjYhq0gEvc}aNeyN``;UL<0?Xzv
zU0}UuN-)Hzta4X}Oq#ZTVwKkF=-0{^4m*c95#7E%GdU$_q7oSbbJ*N-CMVl=rccww
zyKAQtdD~mwvK<Q^Q5gFu>e|>o16Pp`aR0;8Es+Hmur-{7hhfeaIS7T+j@eI2r@for
zLet@%gH~?Pz{^qf@8S~-JlM%u8cR*x<5dtMLx*b-l$N)y1jE>X=Ij+BLM^sW;U9=|
zo3!<{Ukqd@>(MUL2O#dGrR|dL>#hffr%9@!qen(!*Ew%!$4vIvl$Si4xd3uKOP2nM
zIG2r#7a5N^O!7<H{@4(-=P|SWqT1a4mZLhSA8QATgsI0$&l_W(2e%H(ps&+m-PsEZ
zy6ZDD^D9_F;a49(VHF?QnFYT~p0akExpU^i6ZEfjx4n8q;69SnsymTwBHfo)-+4)u
zjcp{wj5Zv^Iq+GLp}>gxxA`}x_^%tUb05Zf#7?1Z(nuy~SJHefwL;-wkrfsr?M4b;
zn9sN3nvMYHQ$hEY9xbe`v}0xCVec?d#MdK>h5Ld`->wf6$koYFi>h}e$=sc6c{gQ2
z)!6_z#a`dpu<o3{dEDoiJVo0QiQY%Qu{{YD5Ed>wcK30FWB*^Z_34j$k|&|_oks?W
z^)OgPRv390@VO~C9rdB-m5wf2i^A7pyR#MA!}S%%?BCcb+_=_x73^S8d}+Il^g9IT
z`By*)hbjx1%;F|&hbjdkFkAGCIl)UIRbSn+4?#rcrVbIGPp1|rw>mGoE?d_E(Uv}x
zW9eO$u#OG-M3`smrGNADdyt&g^SLq0f@b)-^1MpW@66;arR@yt4gSBqM?0~O_nDd5
zTdEEm_Qp0lfLcbU2?qT?5BHpzQZ@OF>rxbU#jdf3+;K6m6m?Jx3mLO~e>Gyaf}0y_
zw=u!db~m&4y951IYql&MZfXM1h~G&^3@|HwDuk7qCge{De7Re<Y}vxGeBIfH^p{We
zA}(Y}pwLVE#Q6O&g%Nj+qzpzeHY@ro;q^MfT8LwbJKLqU<^IDPrC!#@jB3YCy*+on
zt&l(P6C%XW;d&zxI2o;jhfFy!Z0j<{=b)0Nl-~94(gIt<Qc_qZkJ1F6dY8CIHZ7eK
z*B32JZ?Yq6kkK?$ElXV!dlEhq9fhyLH0bGwzr17THMJDDX%zc57>$ZtgL4h>RV`N6
zc|lDbA|^H@lC(JnRn80LMiLDmTD6HJzIgP)zi`%-1SWDoVgI@XOR@?UngXx&mlOzQ
zDiHG|$frn)bnc+}sqkwIupD*HCE}okGa)eSuhGa`35GiDukFSYi7;p``;ZLHsS6j!
zQsE7=zRa(GBL4ODB-e_RgRM~(Zf$%lWN2aIzS5gLMYV#mI`XR}iJqWTPK~iL@<i&;
z76>XD-rd`?-_Ar1s+8PVm*!_e2H~jvR*VKrJAbqCZ^D&&NQC2;Xn`wDB?eC{XW3*(
zgE-`)a0lTfx!9bE@H!XX=aZke%dT6#E~26}KdN7D_Sza8XY4zrTmf4BO2#>6IYn%0
z_jbFErFdQHx2F{M@=q)01?-0RZ?ei_u8|vmq*m7EBa-2XHEb#$grumbzu=y=V?G2K
zoi?pRgOuA(d>|l<0JA;XUt%2AKl#iS#$v^)%8+_kUM`&LW``w4;%E!GYP=5lW`L}T
znQuiv-WlN&Zw%_TYNU6~B987=+c!)lOh<ZcaI+5Es)B|`)>|ZaEy4*a0&twFD9$82
z{72T#FyYt+&sGl|rKtPoa}TObvx5ZKaarbayb=$0S7~>CL4AF5qU+R@ip?RGZlL<K
z`u^`yOB~uZk<+O)pWDm4`i;3x<KR67dCmWLe6~r|Cz?wFNYtC+DAlqH-glL!<jK2x
zUvOa6tV%Jfdi`QQbH2p9mS}DBpq|@Qe-Y{|DPN}iQZ{!e1GFp>Q+EVPOHfqrO<nNq
zj~REk3df|FEuPDA^-q^U>Km!(=>?C(XC;GxM>x1^sqkD{GHy{nPE0uK<~*3WaeG~k
z1dKYR=W$m)_a%(|;#M${QtE;&K|SMls|@c_RC*BnD&~DBGI7vwj{pXuqk70;NSMV}
zB+qn)zOzPObjU|`_tStyQny+%oleYv(-NdB4S75XUcGj$AOJXu`f!^F=!k>7I6ZtT
z4jekf;1=kI#>QMlCSi}k8Jpzl;d!3dwm~K5E&e%gsYlOOtvYOZowh~>-S=h8V<R%+
zA%Lh2E|{9YQ8x1x3JbN?L`N-Zo_no1M2F|M{j>BSP$N=kld}~&@C^XHl_Z2IMWDJP
z61N193ApTp48nU30HglM&`JPVN7H+@u->%nR}S|im}{zq=@sWZm|RfO%$Dc}JL{rn
zmZ;!*hcDBK+i8osI(Ay=T4;vksIx8T-9zpZp3Pm(uq*H1bJn^6=>=oq`Al&mFxQ;K
znWz^j?X?C8n2}`TxlqxQ^|20fW)ER^r#@QwK8iZstNTZHcX#_mcYS4L>ND)@S>NEP
zR16iFAdXXtI&s#V8Z)3f8$oGD|5X)GyZNwAE;8+tnQ$>UbdfGbIJ$Lc!bDg(T+B=F
z{fqdcAzEcgDa70?i~t?2;?F37jv$c1QFTvn;fkfV-S!i6Hiz<A_YIFxR)W>b`|DsH
z{NeX_E+6Ht>!`A-|D4jBbhq(4hAt*gPoD3tx<~YFWQ#?X7Ykt-eH?1I2nb$P{aLy#
z%!!o*RO$-=^uOfh2EFd_*f+%g689_XTUuqD*0=SAfT%#+!o=fTGkxuoYT%jqM~IQz
z)jyW1A@<I7hPQRhkIH^t3LwdxZ+*`|h8UQ|-~XgA-u)um8ZbBO8`XwHFD}J8VwjPw
zLpBLmf`8+?I+wAw!IXYk>Wno4m`V3*R`D;%1|?Q=-9{l0lViXwfGW!%snKU4v%R)c
z9(*7vqCfV@vnwj8X5BUSe};rDG8CD`5qPR$FNakJ5<y~&szKlSrTTQAZRN~_Wph20
zW4G)<cz#foPNyrl=Np{|Hf39bv=1gvMscT6(2o2aux!*<wVc_sym_aZm(IM_-E6_q
z1;??++;tsGniX<q?|~BS?c2xAOeV8kjCGe#5nc?$FYr@<_&I}aM>65SFoy^SqA}1w
z;1RhOgXSHMMM9E&z#Gm^%B)XNu=ywMExmyh4zWE8ZdISX_PyQ!)J^C2QPiRN1;N-f
zvGt;)>{&@DG+0KxBfa-6ISBW4rWQ8xDD|HkG5ZcUoPF!$n7g<{4bl!^N)Ard5Os~0
z!k9xCJ!$6n#xcHE3seS%!_TMmT&tC!qqA7ivzz$LJDpV<8(^riAgi^j*O&p$2#~SS
zPfT5?tpxUmRUkZjFvo@l>{w5CZ9&Mkmyc)$Y;LZSrFtk6lop`wf))RXg7HifD43#w
zbQAmZPo&&%xaKe+nE)4gL5oW5Xs)mQ0EQt*3|>vLxsRNd2(w<U#({OAb~(QB-RB|u
zsGCNsV0UTN)@ezUDPV5hT@IA#KMyqzRA344OpFDu&F4D@xSb4NxS+z@@r*VRvyCgG
z*POI3r4)+7ILw3XB=XVO`?8U2O#;1WNWn+RbPP`lcA8oMimp|@lOcKudk=NVJOK(k
zqIl>(pN7?T=RZI<vECMmt3*u!&qZX8>R%DHrwFXGA5A3@RRtGnzExOVg0w)@k`-Jv
znD(%0!b@u7m==xgD+AG6#)`4&zXol|aaK007cTK4msFmTdWZ=v7AG;hB4oh*=EoC*
zD>rv7&9a6^OmH2mnE1AU>sQk8>td~H7s6Bn$n^0upZN8C7=)dE781pd(opKNVU!q-
z5N6`btD%B-Ikhs)X9jif%MZf1{I5qW;qH?6LP?3+7==MlPSiu_md8<&pgS8r+;I@K
z2zB>NBj0}i%uo6_YgjKYmG~7w{(3j}kQlrZA&Nmp6@B6HZgM#u#McXZX*g$II-zij
zvUauJT}rbj-me$4?e#|OM0Bfc7|e_oH-VxLuk!(0N7mmpH~jCncNfDRriqQ<WEW5N
z#Yj2T(LJnZCRdSkLw55_Ya!4@2W+=5Ibv=73O#px0|N9rox6;YL#h}PR;b~>S)qHc
zmZ!G5cr=mXr=#kq$aU^2B}b<jfFfj%587j}8C1t7B>18y7W$AJK~CZwjxH`I5I1So
zXSkp^^`kF?TgGmiyu9J7SFdh)d7(PPc?XqrRNIxk(cHz1cF(12<YyBoy%Kj~^b?Pu
z96t*e&JM%gAc5Cw2q}^rwTu`?o59=ddQB-7nK3DiBk<pfO3T(qCn#ao)3NkGk~l=F
z^cFQz&z?Qga-zbHwWT0L)aPdX#g5zHk(@F%u4R<FQqjxwq%3N;wG3Lxw^zn;=`2)Z
z_EX(CD*@QT);5pTTB0t!$LC9R>Y;v@M=7~hT(!-?0?g5$N{<`Afe&3$&6+<WkGACf
z#uo7g1T-+S;4|UlQ}#lGpY&KM_U*Z{LDE7KBn{AZ!HO^g_ocMx_hmHH;}3(sW<l-j
zV1QVpwEV#@NPOnrY1fvdTt%%9RFZ8J)N)HvBP=6!ZqBiY5?E_+(NYWjW*5wkCD|AB
zYn$6Iur~3DueCEwVn1*1m2#s$&~FU%SF{{DSM~ZFF%}1b4mI27APzix{=5Swxc7PW
zgx1JS4wP8r85tND#0^#qPYe!Dj77^pxv5b-do-{vOU)D;D(Apqx2$iVj}*moynq6m
z<{Uf|xEQZn1m#LxR-RVfI10aTf7w41p_G#L67FVt=}w8PCP(Jw(Z@*zykZDexl!6N
z-o#*hyNpbAGYwM-Ob`tan23h<@4uHL!_7B28=IW0i`GtHMEf`Cz-%AsktNus_01Fi
z>i?8IfyPofd3iL(Zrom|$4GxLJG(cSZlz#JqdktZS1V*!$(K~{+ophc8$hpw`$3$e
zPr5vM^oS#$kGjCzFTG%fZ>@Fa%=1PD$g9~lQKvHV>uwh2=H?b16B8EBvv#dXw)Se(
z`hkv8gs8oL|NfeZf!Rqka|``U_h^I}A;Za%1$#!DEYS1Vu{p(UlgpuwE*UhzVf*_0
z!AQh>O>L*nN(wr96Wi_-uNXIpsnn(a8NHbmcVag>gHUeWym_4E61$9BT9df6e>_zL
zsz=})Pcn4)BN!i7u3qJ%w(CCh_I`?9>cj~f%M1;RwpGA^J3D>n&YdiJ8~7q;;RFv8
zmjV`jmr$z-!4yR5CBs~@4r<^(!DFigSsyhv4DAr`WS@_x?(-6YoR^J}%b;(rGg=b!
zQ_z`1U03&E*cs=&s@_;<z94oyc(D3ec=$H38Hs;wiajWv+Un{c1l4X7UUM6t;Ts$r
z8yy{eB<pbxv15iyIM;YRTEAyID}yHtLN``3*-31f=q<CI;?$GUYDWDxgJr~V0|@Jf
zhWU;KJRuu)Hp;fIotjsYW*b-`4eMZxSxV+9{&yV1Fa7$S*jF3W193nzE`35V26hir
z6H>d(;v!npf2J#oY0f7se9U{GR6{j|mj31R#cRbGqb(cg{X;tpE?$f$_T-D!ifr4t
z^LVlEpN$xh)?~Ynw>W?c3?N_(2MGsW=Es26d*g19uWDcCm~A}?E)RF(JG7>vW?a$(
z8K$@>ObLe8f|QQB^weAt_XP_UkW3CuHlKkWS?kyu<i*gAGwi+?gW9<tFIlEuJI5=q
zsS-6Ic5)i}Z-ES3XsvpXI^W0Jd-aA5QJ5B;*p6*%ZD7wh8Z!ODXZTS-K;+F;{71YA
zj|>6<tbGA#>8cfN6Af3F1@@pTn_X8on#^>B|Kc)`N$k#OnC;#HijYVF0ww|Q7#jWI
z6M^w01i|}R-)o$DSSCwy%(yX68&<HTR!@$e8f^oEt`TW*@zU;bOwp|@I$~~rb&_QT
zgz9LOCI}~OI34drvpVl^`+AoO>sloq7hXz7Wdc1c_lYfE_(ODO2i(?qlRwz%&OH==
z;PCkHY+GMzXJ-_VIqZ#ny0@X)GLtlQBfto}yxR&xy<yM3nqFvxRUURCRL(%pz#y6)
z>~sX97J!ylp`amVA7QNYp6G~*Gmr=7qKB;*#$Y~QPOGE0+#Ab!5sFv7`{230A750M
zZ!IwIz3<e{IOWbRan6MZ!O7V^pej%N48R_?8m~hFB@UAW{iHD$kVtAWn52i07dy;q
z+ApwPxObN1wQYlLD)zA23{kYX_vZR7wU3w)&|kr#`G`06NG{`5{3@EzIN;c@?a!0k
zu>Ug9O0+T)D>ZYgyDgg0)|UeAkrosU*cBp@rJ7W4En2!%+xGQO`dhL*iRt;ZshnV=
zB#R)@%;gX$#h9BMP2ax<w!FEG^@@E$B~YqyAUfVzO}o-XR77NVbV{t;V5!Ct^jgDT
zalpeLqg_hUz6VMnkgz(sM`yo1`SIlB0t8Bsz;v9BWdzU#2z}_HZXjwI$a0RuURES^
z$!?3TC`6>&wzaK+jw@<1aOUi4kXi~2>Dzi{WHhS>q<apLW+lg**X>5NxvWRllsTeP
znPz8_WrhF+dskUusG@}HgaZyLaN<bwJlskrv~MYkGg460c^_Z9k~D<#FOafrQ@frx
z)KQju?(1o>_LSCO4eU8sKo{mu&X~einaAy^9d4(Gm^J74lIB30mg{jiw|<Hzu8i3g
zu#Aqa=yAhnVNZfhS^)O9RtJ9UtzNW&&WgCY;Mr7^t*nu0?=w^UEqn_SGz6E?`qbZR
z2gj49{*rQSzrOQVJmXCkL*%<UJyrGV)P94?Wa}{AiqJF=UHyl}&lP|8NrTXzpzC6f
zYzNwolXJ?6kN`3F!H&bxNbyED5N_&%f)E8}vVxpkdhr-E=FvG%_FV;ul1z5e`wmT#
zNcR;BPrN>^sR~gA406M~TG`pz1$XZ*w|33-6Xvip5z4H$Gg0)`jw<VBm=kY%Z1H4}
zwjK-MMNcvu0DD=BEaKNzEBgW#fn&KI%jBSF!k!QkI>WqU=>S84>jaC;z+V)SY?Pg5
z9wsveH%`mZg+jUc=6vPmFEpj}The`Kf|K);RvGJz;Uyi2U|1f7m=K;?6g0`y!kk0z
z%2K*2&p{=n4RdaQ8W)$K;sRrF%w|8Fb2>&Y&)V9~qV<l7x6Km^!~tHt4LF^G=J?~Z
zM`axSCSTZ`!iP3>78Vvt>uH#PA|F%^{x<W7_n~_msmy}eZ>2U3*Km=l^B%8YvhL_V
z+OP6B@A=b<3Z-8Q>WzT(28+};b9N-W3Fy%oWwoZ`B4mz?x^hzd)XbJqu9M^<X4|uM
zr?;0gA#2dgRa_>Ab|m7Y!{e@92{|IyAXT!1do;Q*8W{S7gfLe>kg@&_Ldq>h4XA)1
z@Ukd`Z~+kk2f4z~8Ry0Yv9C$sK$@}7r(Wmo-l`fLeeK%37{hdUgB0nfIlSU+-CNrl
z;wC~u0qZJyO-+q}xs}#1Xo$>_F~mhN<pE|n8FdG5uW8ShVQOMj(O?7AN=L0<bN7iW
zPK>>%aBcWhTr9t1-Un3INU7Sx9A@04D9!rz@WqbB`Bn8~C~88YVx^9GUHo92M^op8
zJTePXafnLOcor|PXlakfFF=P#W+m;h!enD2RNr%-|K8;LM<crAk+n<FVf1UQ{ysil
zKiwn##=7Yc<)W-0auX83LA7Su_MV@*U>(j*O>f)YhJEn+;HY9I7HHMMit`z1077yV
zH2s?^Xi%|ARdy4FsEH7uf!~f3HfRnB9lgV`Ty>J=Dbh{@5QbkGEYndjHj&xow~Siu
zmtNOL+DB5<v8vDH2X3bXNLil>Lc^e$hgsOAWMLt3m~W7XcVs;pf)Xw_7inhZWO50J
z0xQ~|$u#t#-a#+C?WAQQvD~P0>J&y(Q31$RkWCS3Ub1ylX}Yt$QnCdQR*w8i{5MhH
z;Y;Kc6zJfT0o$FILc}h-#4?*S!HgmcIascG`52Dl@`&SMyp;ad0{c7F%wt%hc*&M7
zU7Tb%_ekW1=9yzZvw4EdBDa-d<a#QzZjvsd;eyn$9A|8eh-5jdvK$fBl7M>u{wpLZ
zr0}>5+|O-=>`kge1a0MrfDl(k(V6oIYm(Ndf)-bN6e5~4^<8pqY-~&bJI8S!Ub(){
z@Mt|hJ5&+Eq(j7zO}CSzLvL6|S-<OGhhrwlDZwK2eK7j-k|V!kS=_pt*MJQZ@#JNp
z^#laxM1fjj!b&Or`it~abvIXq&Wr$lFy%f#nz|f59MN0#?VD~oRxO7|?Wt3zctIDZ
zpe>A8pt6ceIkrc^_9Iq1XPC}3gAE)U&k$SYoO*?d)zzyKI03RJu~eXrBJm~>6@-3>
z$C=&}?^7>Xe@UZ#<JU*Klptjzhg|ryEuT=7QKqX`91)<reuK7sQ82kgha+!<^&}3n
zsAa5=eN|!Ts!Bil=qY0*WH~b}SfjASSban{NFVZAzw6U+rSs>{2VGw~n=v^U?td>O
zCpVVlu~Wy*qDrl~IcPW6<2-Q8!rR)=0cZT}4()p903Vy9s2&Z9B}El{PBc^g)KaBN
zCfZ>lCWGR_imL#vdQgOSoK@KelC!e(Fv4wg!Ha@QYCo(Ti}1z5u<`uP&W;_&umd_4
z@LuAuS^5uqdU)V2f{aQlNhpwyLL91ugN!tu-(sL6AHD`|8yG(`M5|RenYI-AfmY7G
z(P1yVH~qexo`}Kre2!E6?B6Y4ABACQLxz_7vj*~r&&$1ie$4OnUDB6Q9Hz8PNhbqy
zxVl+kV#lMS40NI`k28u(v1vt9?*tONlYKoq<9vMv72R(t(2fQEXJ&0fk{7DPQPZFh
z#UU0Zk_Xa@jUJF&r{U)k-6da@-9=^Zu5%ft!hz<?4pY6MKk2r7M`vk*4P%W=rs(Ln
zGvf|t?w2n+xsuE)z+EC;wXuoo3_db)9W_bMbBS>~ltapFGrH`G%ZNh&n;L?wdDt60
zTVc^1^ozwSLPRyC4-pCiuP@7Vb7M7Ct{y&wGwJ<xY|Lc<4Zw{@0*`bPYs+Tb5l57T
zQKtnr){sSBduL~7L{hxVw(+m={Z+$B@ut}6Q)HPv4{iCD>sRhVG$P!7#6SDi{?OU=
z)UW`(2X=5JnblU6@RbG36o1PYrjuj$<fwL6O%wHl=Fsuny~pN_jBj_$$qg2n!8DUt
zl6GGKtYly*d=zv%M>nRKcRkxs9y58Ecy*FaLxrSLgx*`|#Fg_cP0w2#2E@dEwPeyS
zO_nhJ2qUCPpVEPP9n790E~MItJ<h6)e1-;cuwE;Fe$41IUS3}ZWz@T?JQ}d?Bm5c1
z$B|Q=V&k%@(?gQY!JlbgjpI7KWcJfwqN}BkM$B)B#sA6kXu3i1MkB5YBc4LMlT>*P
z>bM6FCYGV47K7T<xJ7B;XSVqgb3(>LGiUmn3)NcRR>V!n_=Lk%R)>*a_CA&>6EyVo
z{O%~!SIx>8AnJ5Amsdr`yG^@hS%VbGSpeUE82eI58;7*p0O^TIVMpnUglgyS9WFX=
z=m?Ig7<`K66|O&QNw+V~ou|Tc3!)}#(HVqe&FXdedCpC=?EZ}|wl5*5;G^t1!z<IR
zqg5XkE5Bu^AWr7uMX&bGx$LjyY*HH&Dih6<7AmlpRVq4n$Chi^<)viblc_ynr;yX*
z6E&<cl)!~zCqfgQ@r2*l-j=<zbn}~u6$yWac!jei56lLkh`-Qh=);G$O4E=*TfJX*
z4_*Dv&Y!}yfu-^g-F0@)W2ywpo=lFz9oeuuS_gz*|Nb-Q>$)CFnlx_q-xLy$`yKH<
z1uV$J_>SRV+@$~fG;!pr8~AAh#mY@V@AXVNy~9z6)<BOn{6;i&aR<!%c6Qyi<y%ZE
zI-`O5xJm^REJBbX%8ZgOl%2S}MrYlW543Q{P~1IqcQ}UJ62ec5JozWcWYX!(=`PcJ
z-=$XO3hJOL<W1MtR|q(uHvfIV0$fxxgJJZ%3TzQf_3V_dYbZB}txJlM69#)BcNKqf
zjiAi9=_a&1`toJhVrF4ks-SZS6|60;VQ@q0&)o%U>-o>={wtv}MwQItItA8}dmjRE
zMD<;zX~<;~-m`?#sj_Lm{ji!hVmXoFcN_nVK6@`GL@-sg*mrL`>HF3<g-TL3C-`0<
z$zI%ljg9S|d1;$JtNaL+Lk=oszpSbY*=Cpxd$ULvJSCRAnY5WYO6x6oJF}_x_Q#_L
z1X_a*=ilgd!><ytqgTi9)cbWYHbpOvF;;%&RG2!L)Iyqlp;H(O(i)|Kbx7KVp*AFn
z`acj*j2wgJvhSV3;KajLf%L6Vjwshn8ecc3K8$|?x+B=+iRSbZ73B}G6<poOt=l~Q
zCho$I&nqmL{(=Z|Jc!9VCru)H8=973fDP<kMJ=!g0~FJE+fHbFLv-vDE$i#7(y%&+
z>+152(Sq#DCf$a5<kBMhzVZx*-Fz@VM@3*xqQEsTj^8<!|1N8-9;JQjhSKU4+)=a-
zV+m$*YUYX3<<i>R=R0-oN1l}n(Z8UzJW)U9;_~I^Wv(fj|7Pv|<eS>jfnoNn-7?Pn
zygy#<PiA&@G`rR(mZt^}_5_I=w)mLt%kTY*mSCE93zIGU3$s?2gM(wIUDtM+$1+I)
zLE*bihwh#qaGuL{*BAO2C);}A&70SVjM)@7lT}c7gd|RT5E2Ww<UL-i>?d>+ordQx
zBgf;*N>{twJle(rjvYcm0=KFyLb#B*sMYj_NFF+Q{P?Gz(AG#mSRG%^nDXFhU3_}5
zvtA)K%}jj&KRdsDSd?F&AC;CSYdYV$Njj-keoxf%8%y>*t+tFaS|0CYngz@-u=C*g
zwucV|Pupj6`!xOJ+Lyx!9_(Wp`PtM5<V>du%5;5;bDMVPedqc89XrphqUnki7B)kI
z{=YLtKCi1-oLyF-p(^)im#nU?=IT}ah7ap<<BN;8E~*kXc)hJNp$e}}cFvLe`N2mu
zyH=y;=FL^2U&jnIr=4KmW^3SB7QSxxC5Q5{rh>rbI))P4S=U~dY9B*;;OqBE)%BvW
zkF3VAvaFaeC7zIk{2NO)z4!M1n5V9IAbdC!iqLXniQ#s1q|X^Udj68z#!J1S52b#-
zk51e@n7))v|NXnG?1v6~81OedHsflfzktHV_9q=zEHOiDJi7%E7x9hAa4z~-1Z%U1
zh=?0*lbuE@UWG2IF4IxXVYJW{()ZlD?R@CKfeMS-Q#lV_SpS?JuD#P+&J1?m?G?4=
zu;6yRz%t?Jml4}U(g)(#Nm;2KIB;j3wL=;#1@x%nhR)r~cAoms*lr!GRz0$d|HFFI
zJF54197l>A&b268W7v0HIkZ7~MX+CN=5CW`&(@EtYw4{gxj=rycW0*X5e3B$9x84U
zSy!(gJoqz+85rW~wPMTCdy;h{#s*W9xnlXwBaNP7!C~!ntzDBqIJ`n?95fh$4Zp7v
zy|YQt)5P}K<DD)}mzd7}hXAi!Wu}~Me1GRB(&`OqhqO#gj;5O)DW7=Rm{mgKmK+;-
zsNm*0(dGB}vCv*AXFI#XK}Kh+DpOIw_ty9C!LPEsWX@bNR6cU#RP!y4qQnzPZ2+th
zU-PHmE8}+jaG(6jsZ6~;L3h&p^{cT#CXfFmX0fes*rB`mDfduD>DZciW_QJ>xSI-7
zKL?}7wWk^N5tyN!yN+W5`D~?fzt9xeyxD7m%caGf;!-Mmn!^Y701escHZ?KeJco_4
zPPW%QnR(f>sfa(=Yf*-c-H+C0z8Qtff|6Np822;7O+58~FD)Y;Yl>32exkV@eG*e&
z7wGMKswu!xKhg4Pz0Gi~n^B9L*|j-aHltf|QQ;=Vg#6Sdum6X=_Y7+?joL+V9K}%)
zu~0;c*hN4@dQ}lbL<dnIR0Rbz6zQEXHjpj|C|wazr1u^b2r3;UL8=nz5IUjftS7-4
z&$stEzxR)w>tck=n>SBc&nox2*Lpt>kpy*8KXEC`S&iQ2vUgorKznC9loWX@4ZOIO
z+4e|U-178H`Om(AYTLx%V8M(p+pey{^DpZ;2Zm>y7jGw<KYX!qRFVJP{VotRu501p
zvnd(-?Bu7zbu=#cFiQ@@ifL=GDlRvgb=gxorMbukJpB@VX$3uBqDDw~+{GvdN0m2O
zm*W*|r*SK(pXad9T>@iYG<T!Yx1xn-uW{7Eh0;^g;cm?9xqJI*i<tV1CIZx$1_6M4
zFtNLRPE^NN?5NGa{6z!%x;%_~Gi*s}y5D7m1()W&^_k%#O`g;v%XnIY+tiSG7`*|O
zw>BcXqL;UsxZBKR-o`jPNBgBk5<YIa)05gEVrrnRw+GhcjeVLtbu?T&GBTd;vfP4$
z%+uLXdwg&;AMT{5$E**Znc;MrP2iW!ACpGfo$;wf()Rt8uYut*Fj^cb_@|DTrMB32
z&L<^HMn+y<7oVRLUr9xGkz1V)%TrJ{eHs}#;1bcv(|6~Ql>Nh@;lzIT?z9e_J*9;9
zJZw&Xkj(I4%z*Xa=C+9t6JZ}dFJ)rqSNGSIc_gE-yhy_mM{GpncNI`2jR*eu5OwE~
zmt=|+pWv}$QDa=(y}>vSd8{?b(7Ddldc4ftJiy-5>JKIL5{q6}Ha6RuF}&|?L7jt)
zK4yPm7ilNgeDBt+Qs2Gxf<2d;R5A9EI9j&FoA!IEc@JM+d3#k^s2W12=i&u5!X;nb
z#trtpk22hCFFljFPkO-Lue|g7K(MdgdNW6PtX7mfR-4$_xX*_;($3YAT>VN7o`dVv
zT9L@z=O!Z2w?ge{h<eAh`CYnuFt2n)3QM@4OR=qp*~NHXIP^^gHa(oDEbi`gX#5a8
zYdP!qX&=<q7K@+7xAwJHi}&@_Eye`ecD{L{7Rkgk>-2tg#pKfq=Bip9BY*pPyc8wI
z!`@+}{U8IuIR9_u*r|7v66cKBwtLPTr|yg;)kLUNKKiby5#4dry6NLXj6L)-Oq-7K
zT3Ir$>)Tv-%b+C#SHEEJqI#HT$j)(5U2jJ$S)!cE&BCqVkwg5}N%0B1_V?dNjlU(5
zL63==F3!wPI+6%Ysyti>^r?+k#AEJ!E5E*^lJP{)_uDf^d&hN_M+3(M3g2dUGFkjJ
zu)6fT$+<^CQ%{@S^iu5h2E3Hmv3Dt<bmYzZPh=<2E3-<k#K|hHx|lkcg~3K-9Bqgi
zDQ&srXcX2SuniZjm$PrPzh9JP+N)EiI2Q&KY0{<!I;8i+J8*o+V8c>$+8hZpL!y)S
zrpY?^sP><Z4wTNKChURTm47nXsXGquBCSk(87#4h_w_C8UySa}tWYI9b?5UX^|%OX
zryA_O)rSog-iZzidq_M)_i0_mJ^DMKQ40Ui$&(&eS8baQ(#Lt~ahFpE2wiXG7E_2!
zW{b;PXd9?e0!(?DNCF-C^(QFz2HVs0(@4-tFaK@SDrU05jdWE$;hA8nuC`wL%?7+Q
zpy77)iu2#k&Kj9Qc@MWkgX?tnXHMK$&)j(jRtX)jNxhV#TBe|mv%Yt2n1siH5=JrL
z+2DrdwR%784@#Y$Zu{GHA#Gfdn-w(b$jBWyr~Mw3Rz9z`S5yip9HRT(3S76Yxn%2b
z)YK9i(<v3e84aivg5+?;QeIZYxtqr^#d4H586k!QS=>k)$N#x5cZcU3Ww%JZi?kQ@
zYk&)GLD9tLlI#J)E5KB@oPYP_+{1@Yz~33Nqc4U;hj7VgsD1g1A8$&Rms1-X0)|>l
zn_s=Nk25wh;vG45%&r^j!{b~lLn8+(q|A1M+RP(fjRdIlh%luHvm{|TKaqO(8rZ9P
zcPO#1jG~QDNKaqnL_utt2>p$)<wX>X*!R4V^b%{LOwqkN>XAZec@$7Ur)s7h#)v}2
zP9yC5Rrd12jk7ElvR%w6orUA8OWA+CjNY7^&z`qoRlv?UW;FNlr8r2|1}Jzg-mGhg
zlNXG-k{)6W#r*}o^32{*Q&UqWgExFC8!NUwcIJR5b_~=7<DrkZi+Oj6Ch`5YMl@N=
z=YSF45$!KDB_{?e29+dV@?Ws;Rxge@4r^jN-W3LEM$hIX`np)=0~lylC*<OMdM{Yt
zjTw2+_`vMpmkSrz%^%LB91}GC_+S$ABK2^bhYYBk8E}q>?f8W{u{>h#-KLkRMK>yZ
zBuC2ohC>U{pY#<9;Bmh|%z=ltp4H%eG~Au2s_mVb&TnM;b8~!>1e*fZw_tT98Tl#o
zOA@LD)lokhU`t?`xvHw<O$Rf7VB$&0I&+HlPRNif&->K$pPWwOl3tGkzgD{BIFb0-
zPOD+%OO2Rh3Blk)hk>y%ZJLDt>A}v_7CKr+ip!!Jx#!P&(x#IY{hw!)M$C{=Aa9um
zt1^7zM(11GuWWTo>b%i{t#897_|Y<CRxP!Y%Gp8Jas7CM^dmmr^OE+&=;LZWf8^ut
zk8!T*(|KK?=(E@EJaSkF;)>;z_QD0cR|K1|`{Gb?_L=K|Iu6;(I8$P-X#tdmyf0CQ
zPmKYYn#jqCjdE@9WicF!Y5~WG3|M5{vy#POHPKsNz6O|kf+Hp!pC^6Bvq)y4Y&Kc3
z%6o<R=GZssff$}!eSJv(`nGLvyK~-R#s;^fPbf5|twtMCSC?2nMY%6eR`)*Gd8xK7
z84|>WD|7nX*$!#i>AGyea#MGY8|I(ldG$`{>vKWQ=Yl`=T5@kwN$vmSB!SH{wXK!J
zKWFPrOGym?Yj$L$GwMZ$L4y?NO{DE*ly$)mq+TvjG#{v0bb}#cUR1(bqs^ZTObn{u
zEDf%uxTtx3%#68o>(SjD7fVk(9z)p+CZ<ofJ6>&JvKT9N9BV#CJ1j@HX1M^-Y@mCP
z;<ztI4_9S)iKFNNfOCOv7jp2B68%tuZp?x;H~+H*yk4`1A>bjKfDCG0$(BO1LRg&k
zi6a8N(LHh!D>5RAipc9twfFMq%CoJPHm`<9uJ1QFyJ@t!M)>paE69%SJ?pd8is(54
znvR$g0e=01zsS%Bc9jzx3SZ>KcG_0|l!?zf8VF7^I1A>r@@R2BJ~r*G;xP72`SL}#
z$mATl=*ZEdk0HF6asSr%zK^y%E5b$gocrdSGjb{Eiu8KlR>k{hbV&TQmF(;tFC_H>
zc3d+*>M^i9jT~0ZYnbP8?_jx&SMJ==-sI4;GFJm$+fQj&@|ghzooYga9r1w}8PaEu
z;iS8e0~HB>9S-`uc~M0<V2`+rDLeyaAZBD`z8Fh}P7W#dY3)BZAMA#ap%JDUWC_4>
z3J6e1sQ1TS&#zC08tkAu-SV)GmMJVNSA5?(=Di_pMhsl*=Sz5=0{!)PkIYRAG{Mx6
zui(*q-Lq{N^m2^ETyE+DPH`zFHADw<`*w`@k6OL)9tf#8rKj|{?AJ4I^F!A8;d<nc
z_ih+aHS}60bDz8ySl8#?Q*vq`#|XlMJ7tGRITA_ZMh>>bRTNbPXOu{w&63V2no3b)
zq4*Yp-QXfadCW*)$`X=fw~YOExQ$q+<j%byFrwf%b73RllSh+do|ab=ilV^2nozr(
z8lH6k4jV)LHebXCVVpqMCP_*w;jW?Kz$`=rrotc_*kB3d`Vf{J`>uuES@F20Bj&>O
zq-Y!kdtHGiNYqf@H`6(C@D-wWzbCNwnA6w8yLfP|L|W<P)YP;o1YOc4@B6MWLWEec
zS0wOhQCvC1L`3do^=0eQqXT;2-Fa$rWNWlKc8rB_?|sx^0K;c-BNor4y+tvK^?U>O
zh+)fMQ+4useHKlzwpLFnB{0SP`}@;qlF@SG`5lL=3(Cb))aHhBvyxlg8bI3gD(-8&
zzF6nRIz2VbJ%h12>U?o^;SfGuQb9}jaGXo?Aw~6yN30oCb7)gyt{qw1erm>D&FY02
zV<xYD6;6c|Lg)biw)({wmm9I`;wQ~7`QC2f4Y+#j+K4n#yzRNnBU`WTX5U=}fr6jx
zc<DQ$5;Q<QjpBh$`Mx-fM?r*m>3zHqIHn5UsRJ^Ax!lx5;;b7{mDek`-V=Ka2?V-j
zQ(|z>O^u#~`UMtU*ZZKAQj1=1vWl}M%%kWy=ASHx`wL<3QNY`FE7CCPW<0DiIY5kn
zV)VE684?sy<zo)w!ngQSL&NAw>EI-pB!R!c$My#UtDq9BpfFG##Ovu1+W@8We`6sO
zFO)iTsq{p8;qn(>UpMBE@zUvZJ!%Oc$>Nl(A0yc1=R5DP?6CH*NiU%+vJc5IS~NBO
z-Qlqcy>bp4{@EyVd}S#mz?Pcfq*i=@DPi}NSVctN0*5(4oYb=`(ojzH5wFwv=DzpZ
z1D}&|-1tK5of!AIc~0@EXRm73F}1zCdQF=E#1qpGC0kws)wl_sqx@3q*lr{OMhFC1
zoh!gsrCbwCq;{7j0xo67JcRVwJAm@bi2cN`22oR(=)~8sHf`Xd4t5qzoB5<cPfDna
zvC#<DioIg{p>j)fX+O1Fe;4eI{b+dyMQF#?j``=t#g?~I4ND{h1XjM;oL90V%g|Ei
z&6SlMM&`n`r@0J4Hyj81j%@e+v+?k#L`}U#{3N)dm2vKKcV-5PK>-t=Mph5ADhAZc
zj$O@YxOwi}xm4ZBU{H9sLmN&qSqiPL8B_LPg%byh9cO#Oy@?|q#|^n`8sfOMXgxm%
z+iwl1q|F9CIjpQ)i52sTo-qY9?*T28f$1r|3xk*q1xcaxb`WEOFA?Uz+^MUj?!4z>
zFGe4$0dF4CC@%hn<ps|`-SV=YmS?|YddnX1{sjrIAg~1zYC^D>nt%V@nBWF(DZnP?
zVXaI|`q2wp*g?wE+B<Rv4jF=vu9VXz@f+*ZBHC$XSeT7%l8Rg2KXirZ&Na-naIY@c
zWRb%t-ckzN0lA2^R{~}$BxRJ9<tD%8s73zq_q*12iWl+qz*IwJncjyE{%V~-{}wA!
z2Ea16F_`1Rm?%gINXt`~XMBA*?FLW7hXGsrxyB4eceh{%RXmwy!@HY}O@#Ji7Nq9W
z6&ML6)NQn>=RD*7hkw7n^vw4U5FAp!-p(@VOF`G)9nbZ7nVWiiv)0=-_Y8S@^qlbd
z*Aa&=X|$Z{#x|e<zz4rwQ}p|ilJZLZ4_{wj*DdUXF0JHq%9YaQfsEOh?fd=P7Ad$G
zZZ<Z5^$0>$<O=_nFQfy8J2H2_OHJ`pjdwXzAMK*1tQ_Mt{8)4*^DI3kO2GUIiO@Hv
zLN1ICNy3qfNxfs=>`gl{1J%<a^#Oi<j%tw`Ezcc0MywjKDc!xZTwc_=XoZ7~P4s8u
zeUs78hYz6kx=J~pFBhYQV!YbR(+!=1;(JzGq{i=!pMym<uwT)D&zQ8`Xfhu+$|7%*
zRc`2|WUb6?P>bB0yAKXhk8aV_{rRzRBi{n^28{-e*H>(tDyMtBSC$SM3ZQTJeW%a8
zl5zA~8ece98#R5Y(|$ZxH`~FrREpf^VoRt&13rkL(jXZV<-MXN7P&S(3iMDSD)u)H
zsn8)25s__ec;mg9IJ|Dr@O|Bx?szgem_+zUU5#<LZF%|_G0orC*Qvvb19o36vV#43
zTgX|{VB84T+e@*b!a(CrIQQ@V>6eDTQ}CUnd3m`lmn8EcJ;XHp0vj2d2tWG;OnyoR
zUnt(2&)>u8dS)>%9@W(+ICUKQA05^kXMU49Z=nkr@>JOWXzO`Ry3eol?$CeRPG4)Q
zkl&_+-pM`vtCEDV7fg*CVT`w3JIuV)=Yhx=_W$l#-FESh2TFQNB6&5OI-YZwW_oUa
z?UPJQ(Q4k?-&}(i3QN;2)@`d2m*r%5AoOd}e0t_KGy~~Mc6<5~X%VEAN$+_Sj~~|Q
z1jCo4U!@0?-TY}?P77RQN7~{k$R>De_qSXY6eD!>TZK6QuKMexB=qN|e{#pBup2j#
zs)5202iYDa!R*zRTE!C+NlqPWXdUD7zqi0`t)i{+ACKK}*tbk_Gu*V!Tg2naWJbVb
zWP6@E+JRrM1a_F_qiq|Ezi>w4X4KF$(<+n0uT2gmhjZC4xUPmX@B#YudV=_|EjQa<
zRLr3P>+wN~!?hW5@@el6(^5ZijyGoU=YKPce#PKBFuvjroX4A=YC0s^ac>O?o$Y&W
ztYf-9G7T9k=$<BqJ2d!rqrw^ug#H0<890BKE3!_XI3pu)d#_!KKL|~dLK1?BUOTSE
zdrnR(b?1M>Is6(w{A*zdYjfQAPJ!W1tLTNX7rD!1G=d#huFYbe!kh>OH&RT|F#ml;
z^TU{6pjN##4`t12J+EX515A+d3L4AnwZZE0(sXC>T=pGSk$gOx+Yhhx$)<li^DkJh
zOC1~@M;Y^>MR@L_k8uxE;~53o^0e;k4cDul5eqb$@ujit9hNy7&3*sltG}k$YbFQS
zwwlLR4L6HV(oHpdyjJ27Gie3uN$|K+y$yrA`R{OHiqKW;AHBXlD{k4{W6wkjD8?g_
z4g$@Ow==b;&c=J~q0J|p5|nFORUdoVvW+KH_!rX*Zt>>ux-$uvcnU;54WG<~&yo4w
ztx6Jci?`9RGzOtRXfREPc4Rdx<&?ro?n$yPh`hhBY?2Ack6Q7?{|1o|Hx(w#WU*2_
z`qb|lUxc~Cz7*j9&R3^2LnDpTyC{WcElbi)tYfl#i<aSyZh^vT!D!-}#p5M4nG^g<
z*1-y^S8I(6-_+Yfp3!`?d_;%bO6m!ap6(~PTE~~URXuC!xv-e^?-yD?1O0zA+F_So
z)?9i!pE;8_|H{OWkQGeQuB^ri3gnsk3}$+swv3FAbSPp{l24<}w9L<kvCxc-qQ3_5
zpoMtAyw0x8G&rNmP;1;Kdp3yA(Xu)CU$dyh4LyUt)<|?%?u^BE9xcyxDmfxVlNxbZ
zP>olHpGv2WK2@K4BIioR^8H2fI)taD@`0Ai#4n(bmg)zLnd9($F|OUaM{-t=C}|*J
zk;O^(1+QoNdLzEuU9}+H(4^|iwLqhH`Xu43%j0EXUjLoDc23xp(@vv>p1HJUr>tU_
z+)T@tRC2tR9#@}q|9%0PUAdQwJ@QRP1O@HA%+`I<e%ijzY4Goa5q>54nGTzHWDqPu
z9sgaegtwr~ScpJHG>H^84$7mY`esk%Y0iE#pDni5iVb4&{%KiY=;hFUW2vp&bE(Zq
z|HEnT#XT<Hy$}7heVg1}rRLy&54sZf0i{ir`9U2V%GG0AOuF#I>chK7ddYda)u1N*
z6db?~!dwULD2!+OSbm2vn2`MQ>ldkkP&XS83~AU=ai_sH(Ty|X(KCtvj*zZy1BpmR
zS0dZbX(sdZwm=k0yM62G)zn~6C&uHH2TV%S?bapB7T{LFf^v-EzY6EqGz6EHT7?O3
zNzmYI#M{)mEVQZ^{wLveQ1)qY5*@T$h_Ef-N#;$qOZNgyK{*wj*!Q^IDcb7KTgX$n
z&&<>KhUv%m)654})_`ajT&^Y@X#X}aW+ok0)1inSk?@&C=B|>%XyZPj*Oc1*jIp*C
zXSc#T&B6apMu|IVH$p3w_QP{>tJW=1J5sT%U^0L9Etm@ad(|n_xdS{bm0^-|JUe91
ze!YhGD>8h!e225FvIo3eNg1%b*b&b<XwyLe983-5jHyjPZgF1Amh^Rr+o4WUCGPK$
ztPD!C5M^<}N=<Q%Y<)@=wIYSi6-U8nZ)BB8I8EBh>!1XqI*6(aE!l!(?3BaOCBZ5A
zSN<&67?x1udygBt<Ooo6GsQ=MC%biTBmOf{792D+#T|^H=5Aul;LzPl-xqamP;hEF
z2BjATYQ&*z`++v_6%VaQF)nQsU|8rVr4pyH-tQmQk2q3Lt`PnT73N}M%0B{AEmR|Z
z!}oZpDXw*s&4qISANM|#J-};>ZJvf-MH~hj_ifxZ*fZ!DBxmCCuUrbL(9<aikM}zM
z^gSdG0`MspM=K93E}y<+93)>(6dS5$jKrIr(G09ndANn`)_3pKCa4g2rM`j5Tc{b<
z*81x#^JtIAkm|3i8UAnM1Bq6)q%0mSCZ_9H?Rdp@&B%&v@<;xEFDod*Jx%;|yoLD~
zH`HSk<S6YNhBe(qZId6!>g6p_1-LU*7)Z<c7ST(p(u-pSmz&qxQY!iH<VRY`!UR?*
z_cSbm(n{;Bs_byH&aVto8pE4W+9~VN_JSpf88-a&3tS9BugS2~VZv)%M7<cg*Q2yk
zJ?To;l68q$?O1t7`jZPup~5UoOzjUIt=a~yTUk0}c#<*J19U<OQv%o5<qfy+nLtt1
zI2?ZAoNaK|h^H66eCfdda^YV0+9!@dK))k!x#_MHZ>Kb7nQoOI4S7`qZXdk7l^Oo?
zsr$mR<1rN9E1jm)!R+aJq&k?azWk^d=HTBeH|UKXfmLk47{&Pqj8ThmK_W5$2Z{)d
zB8g_9YPdMsB{+12VL<ss8FE_(!pv;G4Cl{6?<{MF1INb~K0Kig&lxuhSraL<?2dHf
zz*yPwT_t0St*@Xfp|`{ke30n63@f%Dj?1s&ResS0H4gM)%h)fZ)W`T`N89CD9D8-o
z>Z(_%*m&0wL6OVFsb-T91|Bdx6DD{u$)v|~F38t+J@ZVkk-L|CvC}tc<ioUmarovs
z(B@fSX!>mm-zQhzqfi!x_8h%-FvKj^Hzg&-WxN3wSTx;VZ4>8NUiWB20Xra~qSN6d
z0fA;(fbTp}GT84dEAL+S@jUb9gMTn(h9k|Fw(jG8m8}}Za*P|EXUJJ&Dlk_$8u0U1
z<mM;Hm=_;bJ^eu@jDs^A1Op%$1>>|f+!7}IT;{6wHRuS-2hozEAW`*m=(Wj3ZrtM`
z5h3uTlf9-5<YuD>UY-c|)4H^mM>T+R50p<_M$eUM&om8|KFRCZJCwSx>PZcR?m`C*
zc^QK^aDgtO7VIMs6Sz}6`QsMr?1ze8ehd;FZd)OT+;^{{l#K0KKyiZF`o4j_TMy*i
z=LUE9uy!0yFE_b(+$j5)(MrWjm#OCkiMgqAltTLpowfr{3rBk&+YWxXzrSILg-J;a
zNsuN;(h*Gdanthga!<NE)0dSIU7jk6H1ZO+E?vl<DJ)ctEOhA=ZF)x%K6Bqnw}IF2
zrFpQhZTnlF%9rQHtLq9@BrZgx`f=No3sFj!x(gv)X$$#1lz;M;u$XwiKKqXcsyxyH
zzuZ!OTe{pSg&j4{IV2oElZb*UWy?+5x+fCD#AJv~b1<)S@!cg=Uu7Ho7q&!Hzv7eM
zn{=yh@;+bJ_OqZw%9r>CRG=?)82u}LPW(9AyUNU`7R<bDkPn`-cz%tb$#lLmpCO64
zEaSo+BK0NT-Lq~EO&vKl${8li$D=haciH8xASsz@Jvn%vqw3)RAH>~a#;!v3as&5Z
zRG9rb8<7SDDLg{Sa(4q3PdWYIp_NLzM?Yna7C1L|Cxhh`HBD_J-jyZxYBcH!pRq6p
zOzsZYDBI;X>&Y*cgacp`(Io>K%SNRo6J^LfPGCVtbY|o}GvBjcbiu}Bj1wPta*PyQ
z$?D~BR#|x~U%RYz@eRvYS3v3cYroMaeRP@m;QtcW(+df}`K7Q2V6`kxLe0buHnu8x
zr{Jr{!vE*}qOIC9_#Q9ux=0BK917sxp<^t1Xli;2-S4=fh=}#V=fY<vtj{ZNf`aNs
zhvLyvd!%du(6U%d12HMRdxCO_(0w)Ht(nW+<sk_19}9gVG}JtGHz!o}#P3pE{LshP
zdjR%tp@Y<iRRD0$Pq*08wYe{ILz}G+kAR}0h>_a@=#UrT9ROC(Peu9*wBD|^fPz&9
z--wCn6r;E{;ll&w+nZa@K2V%*VzFI(dzjD`b{TCi{|$6N5MHtK^2(w9QZdCLyS6{-
zVhi|(cC`I5J6Nv2TwO%tr62etv|Dh?qjcMta2jrT0dC2ysB`84Q>LR{fwkfCC>}@O
zc+>JXnI{%!yABUcf$Yx3xS~8S8=HEBaIimK@hD&_QUj^B40MCxGbN}owrlo~+<E)$
z0)H}f8_q*!GG0;@<LaucJae4FyFYkAWh<YX#je*faL^kGX}U$n;@rL55P*d4FWK#(
zzie7{fo8<;8FL{hf&nX)ZDMVXft|fRGE4bL?d=`E?B~n!;RAQZ(rHGn+&k?&a*IC}
zYMFMnh4psdW~~DFW`WA^HWKRAATDp>WtWhM6RR`(L~nG4fWQDZ#T0~rj$u9*!W19p
z;oWQB`RUnIO~(V~e=32lQuV+#nb4|Zu!D_zwe05S=38o!413gggfX^QSVcAZ`Yn9M
zb-@yW&n6-~U;ph%d}Jhq+P0Ox`yjjc1R$m=)^vYR(kN(0uQp4@9nu~!tKEaTdP|;&
z<A&^Lg?)W#rB0y}{EaCF6R|mouoGXt)R+=uoI@FpKx4X|!+=4g|6&b2u<s0$#S*XE
z%wu0)DeQ9Fks}uIAo5%w(!BvKm;8Kvxx|ds)}FEHUB|#PZnE*d5{FIl&bR6p%mB@8
zyFXa1c$aq!)YP03knq66H~~GOkJG!3(f{V=cK8e%`pjF8x~Q3vk5`is%=Y#~>rubW
zTlNd|mMPN2*D}aV68?0h5CX!0J)pda$*Q5)k>=-np4pyB?;W|^(Lq_+Bh$_C*NL)Z
zr^_V20IX&g>~w+^X0-sXs;o@+6*eoymM?~9C_mVS!~q>Ub-H!f&U@3JAKkqAaJ)w-
zw0>vF?oSL3WjyH$7Ktv9@3k+vga|$UuW^CW3Vre3YhQ%-pZxy*+VvOU{pbI^|Niyb
z_2*qe@|FI3wpoHTeg87UVJ(GVUFbuD|GZ&<UY6%zF8)X#t-b8%-k5jVg9(1C-)^rY
zL7#ft=1r{GXiI)w{t1F5_}waIf?t0p?D5*mo8A<UNs0TA+$ZAs|3-6tJ^eNoi4T~+
zMg7(bf<7mu=mT<_KuCYR=mT#gY-0V$@!tTw)1K4!EO+0>`ym?t-MLMVK7S?deR7-f
zcK$cOd=<uRHo|RQ|Mrdg43*XP@h{dhE5E<LlQGeI@P5Vb?*ps^18Y0;7wgCV-|xSX
zvA!F2@ID~?_I|qz<NA-ASkJWlw(jjG*Y1zr|NZ)7Yxjrur+>d*fbsqx=>6ZX-$Q@j
zqVECoi#}uo)?QZVu?G;?nS8w8IQ84I<uiO;y`w))pAY&^Y#P~r9;SnhAsQ~*LklKH
ztiP0rwHODRURKz*<^lNnPS-!*PFo}`&M)F;FVcCB7Oj6Gkx2lldO$qO*o6egb~5(f
zefaXf`PLB3i48waTX+)U6%HU1#>PgKpSXK*X?Fj=RvE4pVeHQZnBT}jI3{Z^%f|?C
zf!B842SOhR88t_#^%rqvLGlX^)(|!eJIH%vrN0yq5Rgf_0!f4r2Q~c|WWBVEc-h#-
zwrmy%zrcV7^%=(G{IdyuOKHZUc&B}+qV+f<qKAM0B8eh?W%EHRTVAjE7th=po&x9(
z8Ay~Wqobdh;q8nJ#C7Z;xlQ_UlgX@){~|wv%!nte+};+imGf&L>8a<C=XG!isiQ&(
zG(CC2q|ET}52(0o&o?+j7jPy0+2(*DwaCmW;Ck)_Zj)LhI)ZF$Yc@Mm9OOx;hmg@h
zpSOJQZ}ZOlcaA7=&sE)xqphH9v9fZm$Pr)gCF}!X2uFlgdIBg9%cvBd*eh?3z(ath
zSGh?&Zx+Q-k{rmkzCaTpkjm%sVzAeKOLRegEel#+-HOp!S&$fRPwO~Dy@jYiixsS<
z&{wqyYJl798;tT4XoNii0$xkeJvYZRX3a+-k^Qr8X;uSfq4x;49_)`dJFJwI4@1}*
z*-Piz`Fg8KhSAe)h+_vouy{ZcMVuY6pvb4kgKoD_g1K6-;|5ZYJGJe7e7JSb0lB`X
zVJ8VFxvLT&C6`_{7Zu<rS#NU{hzz8j333co7<h^}#eoi#?R5d#YI8$ole(DkXN)?K
zG*AZI1?UvR9&s&%xCpjC49eUbiT0MK+=;0Hril4m_D2AWxN#SNTktPaTNKD)huHtt
z_`?78W=FJ9DeTARj*po4OFY<K9VCD73)W#>YF#y-=PoEa%dqbPdO_h#w)!3UWDqW4
z+UhOz8C|GbFQe!K<>8W)?Zwz19|9Zfhi*kG!yv^dNYGEQFb*{6wMM5k#iJh`E~s6J
zNY}2ZKoG&$gP_=s<&nN($Iu4GciGv;4xl+clgAPdk)m8aEFkiRMx2hOCY!m2l-QRG
z>h=nk5wW`yC|tcU_Vw1qENE-YLK(hcrZ}9hd>b-p7M#M@`0naBk27m%v1RjVW*#~_
z98pftJh-Y+x;RL#_mi)$h4J4ZakQ0be1o3(%pjR8+as-r66>qW3zIqe)<HnCnwk8T
zV^;NLx8O@`fwd!1tL)u%sQlUM))s;m!(pgdTtMQ%%AJuNQntMhMeTkT^d>zQsp4_I
z7z8=;m>2J(&{3q*kr262wenGrk8`J}G`SquyNEl2DAWV>vB1ESOtl5}$*ol26VeKQ
zx<|gQh9WHMMM)HVA_yM-sk;b=kC$=y-bcJiNZ{X`@^JmT4oFtpZCr%{$Iq!nJ1<Fz
zPEAQJ>zTwWc=q-*EI4WN+d}eJf{VX%@DZ(4bmO+YPsM5NSlp*5C^ZbC({}BV;@HY_
z@|56Aq&j4T=;UWN9RsghZZQDlAqtIvfN2?$ZMCrUAmBym#S4aCXkCKVmrMz7t)l5Z
zdSe9G6{0yf>EIvk12?Q^J!^HYv0~_29z=sOSsfn`X;!{Nq|W1@k%z5{9FVav`-&jO
zZ78My+cSf-2&91qE?$VB$$Z8QQA_=j!F8KY_XDd~6bQ<P#%H_T{j>WoNjqA~Y{hhW
zuiy5Gv*DS7JP=HxT%6Hhh8P@)I%QZYBN>KG(GLskqC(Ev)G+TvSMx3P9C$PtNHTGm
zn$vLmZx-XF0(rZ74i0MP&pc>XSQn+Ad-q1Yz5ND$($h#%`v<fGp$u=XPRV8an&;47
z3}?gzI94XGx+cJ5(I|GRvwqZC_gw5SHhub%tkqnZ-NOxhxaBP0YQA@*S(N<_Q;<c+
z<RIgifPH(f@=KS(1G0HJXt<t0kUDmFpxEu(L<7TrDl`;oqNY?@p-THo#w8#4aLAvG
z51;vXUrFQFhqXYJR0r;PE^Z8D5O`W-ps#PYJ2eOpd#TsmVo4uHSh*GChExN97^8YD
zJcU#QELIIVc=INlZfj4m{WzT<@#}WkKm}w7?e0ipF4qO)WxZY?Fi8q36&{5R0tJ_B
zUJI>HNU{?;T8Ooo=KNJtwc3}>N3wzfyP#CFW@r+Gw)6feaqIt6B%=FTb&TtxxS{Mp
z#pQ&6$=oPLNV}y6NC`312M_v7x{hs=r92Za0B%0}JM^4@s4&KG!Ds*5_}57|q!VK8
z8no>JkBnu!IBc|7bkb{>etlH5jN=6$K$z7c<6wiEj;_<Q0dBc;gOG?wFqBMW*;V-=
zt3#Bxhvv7J%IX0-_U?z=5`0r2zucx%PZ^3o^PnpzU|@uqgbkF5!Ks`DjnIquP_S94
z(-Fd$=E0~(+qmPzB|#}m{iqb31R@le2I$tX{cw!bAzqLIjdaA%0ZMxPGeKZ%A+i-A
zM+XK5OzoXW(IHyD6qpL&%~f04;Xv<^f&PAH2KCi=-~Wk`hHks^7waF<Sa@6y-Kg?$
zxljGI7AaZw0h=?zepRtvQ3P1PY;0_(a^U_(mLRlWF^~-_AONdbS^4H(L8zNSl(9n4
z?(meThl6F#<9g!-M}h5tsuQ4U=gTt@sL|mwcD7muUYA%umKail7&tkHVxEgi&c+=T
zML%HUP{zBG&uHl^Q69J05)C9yep74EraAZg6&F4S(piE)rn<LffA|IQ{xop%yxkZj
z2@>}q@X}p7qiIb*Kr*j`7Cn`~fo=Kleuc^xGTlBr00Av3-zn;EPo1W-=|D@0r_>`o
z^zr3OjW}muHMM*wE8fLH4FLAgCs#{E@kLa|&8$XHN&^he=Z>o(FDkP8VMSY(a?*Ku
zc<5@2;jpiV_0%}WaQ`f<F7Y|50CkGwdI?H9xL2nMG7UpOI$Qoph<*vR2Th=y4`qmj
zU#NO|RBL1_8~OrN>rqCMBL_^{BEoRS^<J0>Itv4G`B0B5eg7FcwGWnoc?feCdJL2P
zD&fWV+-|&fh8mf5I6j0?`1fA>7~D73xqCONazWIX<A&J>ARbM$=_wbrX#76oil|J8
z@=7V8>WBiR6EXkbNLPOVBX`z^1z|7>RCtcrW5gds+?xS;9~QniQ3`CY8~DED%POGV
zOR3#2T}CeB{D3IA8~Ikie^HN@1fv@;GQ4@yw!KnEUTe6YKovS!aPVewtWw2*NO?Hs
zt_figc=ZF-sD=hOd)q}yCp@4$p&IP6N!!GaCin5~rnl|gFi$0WMhxb*gZIxU|26k1
z>Q{9LS)%Ej2uv34lS+z$S*6UjA?|-lH?YCr&o8dQ;2$0l6smhR0xe@=N1zu_C9Ei^
z{YGZ_op*o17wCo36~R{|L!EaXZE}Wum5SH&n_rH#BO(d^czG`CPV1NX`NUwlmWI?)
zuvk53ydy<+yq2N=)-YJhk0o1rcJltIr#!p;2aofm$8lBiCgWvu7a72wx3)Pj3C-&~
zp$MvBa9#&=H4<*j06ZL3W@rkDQx!v;cn|=MfEx&~|B29)S9Y1C9<KUIla&62F{8l;
zf(hls^*=yPdcZ;r9*04Ey%#<#kAcVj7+j89hWbDe^<11$TSVq3p~`a2#_9oOp~{uR
zLqtGekt)OvBd)!j%)0|nKvm_+bCCvIfKsjT1H85SfUZ{s?rBax;zGi?uzSS31m~M3
zzc8Q{iLzNj4D|QTWXC{Ua5i|{092BU?d<>+(|@vDT3R^tC`<Edn<$7OInJH$JcD`Q
zt$h$!jKGVMK~cvp_T8<n*5IHa4j=ubfDRaHMvHQ;j}e*WstD?MZg=jKJ}4j{T;g(b
z*REU`<aNQY_(%>#{8*~g(2PF$ZI2vBkCcha%wW0un*Wx243X2(54fel@I-OK(m0;4
zCQ`)zYVy??P{4!DNmxW;q-O%w(hDIKX|xrfw{R-tIz!ek7_gK4D_zCxgvrEh0pJ{p
zc}*D?RN;E2!sscC<FE`s+W^*|!o7R&Ye>Z!gqv0eGT|>hUJEdhy2zgA4$|+nDKURl
z08C_xxc}Wt)5eTSA#?|(wtEZ-V1X~E0gY%Uf#vbNdroSR>n-~>Z*H#|f^A|m_CU!I
z#_J6ux%kGcFNM|Qb8{bfOwG?e!1deN*i`wxNeT!6OvMWe7xD{O1v|jbh=Eg{uQu1f
z2LS1H<oi=E5WWcg4%pD+WUsLQ_4?JzAUB=V_Z2`mt4jpp(Ke+=fjyB3>!)+VVA_TF
z<%Zs8G|Ed|ycdIq|BI7D8$f`QfPkO7!{a#l;sfZz@UODwjcQ+C1X{0Qs0W7e*0Fmd
z4OZ{ZPaAU_Hbg1H+&h1uU~vN1UmwlK#&&kwP`JZUCTSLV%W+@dXZY(k)_|!4DM)A#
zjCkFjVSs4^tQmMPVj$XZE2T@2@)HvfSe@_JUmG!6May;cAf8_UA-@bnFJpF;&U%|&
zTm*WZ=s@hk|L*!PB#&KeZ08>GfWb0^@&9~!!SOua2*^?(F6hqar6*1IwS0X+8~OSU
zmKakZ3-v~eR$j$6Sw$6MTm-^H@3zRK`RK(k{K2HAeEO=AG6WoQFrVRr;q3|n9zFl=
zx`YNDQA<&C91Z~>&9U8+6#ENEgB!M;VMvj<`z+KZ!RK>pgwLT0rnQ&lKKg`z{RwA`
z<v02mdfQv#{94lS*G298^lAM16S8ji|L;xyPhOKX*vP_DJM}myvU_u50^!4rz0?d~
zJp%R9?`rZk&A%IkhsOThQg0!KJ+$m&7s2ed@4@WBxvVsZVlSzs4a|<~?`39PbsH_P
zp$>jaR1YI&n%u%HuRe6{ja{h0rrnrt>~3<;FeDG|Uy?X-)unDW*sLy)*Hvj|s7ybR
zI=0FTE;@eEPgJ8=GS7ANv!v;VkN8`)v0^t|97gmCF(ZcdD~X~jNgEvFw7^s>Qb_Xh
zymEIzYjQSbnBTwuTD&K63*P>!z>RCa#_OGbkuIb8XTq;tn{2KbC*&IA*$=8~w~j<%
z>@PI`DDUMp?CpJAeM;s5wOW$417GUyR(9vvYV$qxQ|LHl--NfZy~ru~%81&q+fPu0
zX5Kj!W*eBYf<{~9r2gk7!DGbgw6OS^C}=JhYXTvN1h!7&A@hEL3pGSDK!zMaeQ`RD
zLSfpo53`$Hh^0N!J0GbY`|V^zHUCQHrA|#<?hUO;uF8{?Ga8?`t^q@>THw%l>@Qp<
z3B`DOJUq`;Eka$KDmnWdZ(Hgfv$~^?r$wT6XpKh~VW{!q$p?UEYBR^HeKj>h=X-k5
z@{i#0zL<Es@%}MYts_GE+**`auH+b7{pHCz{DFMQUkk<LahmxI{L$w3G!nOi+_2#K
zG$O4|h6t12D>pwP>hhg;s0gZNrL?{N=FPxQMm`gBzD;z@>3>@JZJ>)wap`m6`J`cz
zy!B-0HQUKs)V|bzcU!P)bK(*uwncoo52sxz)=*!+nfp?avstMa&b8B_qU}>d4Ytup
zZfQvxSr$nw-$1>7`@Cc#+v}CZJiXwu*|}a$hwr>Bx<UnNk-_P+Z6D8#t1d)c22<9G
z8CSdgt-WwGh1sOJFOfWPW9dNg<$vd-FH6@)Z5JS)-M5vMeYaCUw2hp++uUHNqeemc
z!=}Sd>dYTN(;N4~YJQSRzWF%?*0y?hcQ0)80dtqTfG?nI@Xyk6$V(2kxEDxyef=lP
z<#S4E{bMxupT=^09C5g-_vgsZ&CP9`yeA@^FWZcEWPO9<5k9$$a<QcD2^SSB4L1H%
z!DXG5w%&v9Af;<uH~h(Ej3v1G!~MAcFshHocK;god!jX}9)g!1A=t)4K(J8K!(tpI
zMZv4G=Ypk}oY^0#490<L8jV4#q113759Hex4%Dr$f5Xu@)N^tlAjz+cc>Y8wbmx`j
znA9c3xu4NlCbzyF%E;j5JdVjuF(Q4<g#)VMZDW7dH+n=8c7~Hr&Y}V3N)zL;_Oqi+
z2T|r-&Y|ZarkWBHYS73?zoD@)R`yt`E+(RNA7x&X8FFd?Z*}fw6kkm_i?;PhI-5)>
zoF7fita9QA1^2!68Azw8^>FL}%7BXxuA&Tb3yUdoa|j-uAMYSbwBKWXiKF}WgpoG>
zHDu@8AT!TmWNLp6h+oK~lBe_(NFgWZiO;w`Hc%)Dw&j__!e9VO>K9-rc`%<voPT7h
zABS13e^u+5STt7p%aUF#3K7F}&F*wr^N$mCMj|LVJm2)$wt1+)tX6Sma6}ZqOw51|
zd>cf)wa=nqB_J^^v9t;m5GRF8hW|l+YhqBB;x_3*ow9WK$@zbV_{m`nrLj5P?T9rI
z)+!^!>+XQB>#nGq933CH84$cm@M6o_SE|#Qs9r4Ai}K0fNH>4KYhlVVND?zO$RXb{
ztuxM)vo0Si;Ns!O%7BPLrdi$;e)N|a&F#?)^tkB+u7p6~q<<M!kb;CKWClrZ97`O9
z0)CuzH?O_MO1dWL+})g76h_!;{dI+zr%)Ab-sI1U9)ASF$BD}b5Y6zO#mUBz5ov)y
zKp-u}`LmbBv-xo=ymBtfu-Xi1hdYG%@2A~g8v~A>5MXLkR#tcp>+c)$PvdUEnmuI{
z5MYyKX~kerJ6FsBOzF)!+!Iif?#54uu~P@_(cJ6KSaJAoV-&;7;4ZLS@WI#zvW#0@
z&GEkhXEx?VnsImRw{=-Z{|I2?J`=zKPtOqs-sN>SIdY%#h^N)8uwRvYv85ApRh=mA
z!&JaTFSymUZ56{eKKhQz_gqQS#ju;lO;4wOzYa$MrGJqip!1312(k-&2Pdw+Au&7U
z*e_-l4CwqtuV#9>w+>5@RTm>v_{>>{P8caun0j6+;`#1x>)bD&{zf-`_o~d)gy+t#
zup2&OJg^XE%9ew=&h-y|M0bXPjy562z+=za5|{EU>Vg$ll2gs!Seu@(Bin}`$3Xv(
z2rKPRcJ_UngPka)risMm&p7!oQDI8cL15%bqcn0Hu(K3we=Mk0`Gw!I?XE0oIbGA7
zokzD&KPu*KXUT)}bQI2XmfNfkq!Va?;ev|32xfEYyx{{bBBoP5zo(qP*fGsG(wec{
z31f5z&0E46nau#L*r<GL_r!}b(?#_y&E&lJ)EX(H^8T<#!rw+0XS#*_Hp{-gZ)QIr
zRJTdK|D<RCy@1Ik)j6vyH?U{sqqbnQkiJWuPGR1^U%-p@Q5KyIA?*SE91iokYpjb_
zLBlWVe0{mS9PHAtP9u7pq}A`0QnZ&xhl+0Fy^!;1p~W6~JP@9~u;eoHI9bxwTJy$@
zz0|Zsa^`(zRj6HHM20Z<1C0I$`6odGBw<Lnl|a1Z$;{SJ!^t~hzzs5mG#dmQKdQUi
zZhB9YGaG5(K@AjsE|wxz=iuYRL=|YA`|aX%#5kq<x}PI`eM+WMhp(?Mz7ou6oTwzo
zhDsVnGfTnLpfj=NknEm0a5y?$y56#}K{tka4c=!Pn9hIk3xC%eGc6L-oSp4vtOeu+
z=gYD5A1E81BxBQkJ>AB`XA%KzE8VcgwC@Y6fIzP=8xTc+V~1YtsX#qNzgQTlN2J$t
zI*&G%tC9G?LD?8<3?exs1o?c;>TT!oai9pl)L_S-7J?;lI3n_L@<ZXH6kekMUn!Ty
zI7d0sDi^t++h}jy?W!-?&)j-yIbA<$V5%?e5i8Wha_q{jnJ;|`au#WzU=>CJ25K;}
zk4<UV8~z*R*D*!apt2Lu<V$a$FU(b4D&No%AwmD?Lq<EafOR!g4Wo!(wX{R^Bw#Tl
z#l1w)puxe{rgxZE;?~K&d5usACR=}Ibqo8dkZGqgo}y+0^)H|cUxHSiS-luv#E%YZ
zy*+MvbTq&=!;I3a+qJx*M(m@1b+Alk{okE$OqpNF3aThCPf>=VN7J9xY!T}}M~c<T
zYPlr)YCvImf~>o6+SP4&biALCDt%BoBOZ?Lp})pa#O4CdUke!=G?QUZF;j4<qOJqz
zu7`h@v80A-R8kjm2*H6B+j#fN`<IyW2nrhS^zU9$U+ztRn^k!8HX#cYec!5~@sbQ2
zZ<{n+g*u~ablx6lBssd{l@K@rmSq3WJcn<?gT%Z{HbIGt<7G~DoR@L8PaAkvJ$qFE
z5JI^paRQtR79QO=S0|@>rW?1eT~qP40<QoaVqV;g=D8fAuKZR`da&E->UFGjA6Z@m
zlYI;vYV3r&7g%^3r@Ank=i5PehzA-JQ&qh0lH-u;vv(zM<t5dqB!6&#iz(rt{9>gT
z=EsM)sxC4y-iYtv+e>*yI?sl8-DlqB`(ZtEB`O_?G?=UiAfuXpLaduf{lpD*-Ll0B
zWeTG;DwBTVzXJI7D->S9k;gXAatOOA4ykrpE{(OwuM~raqic|;Z>n6WZzBTc-tKNj
zfNkA2e~q`L%V7Z%=C;AYO*yKO8b;2&lk3F@c-)Uzvv*m=kiD%Ok1v1u`Qv>yHkb-K
zfDWIdkh_^)_G6Ncsx(&MI14U$3HOWW@`B<Lno5O4l9lb}=EA-?<D0dC($+UGF7#PJ
zE)cs1SmZI{UY11Y`PuWdt>Mx%$MFk4%Nb&rDc($PB$Iz~3r86ru>X=j69tW@)d(&V
z@8wStfTsD(v98~t61#1~hOu67JYLIomM!|6!>lXw;d9@=Qe3{S{PomNF`HWfH8qNl
zvFSL6Fj9CVP0UnoO*`ClxYYR+QP%YGB@pA*@TDrXo-OOg3Z;yc-c&Rl#G;2s?$ZGP
zzJib+u<5EcwJpqsV0yWn3nF>buUSjgAl}NyT3=v>ft~hOPuWkXodlI;+q9vlJ2mf6
zfGofmsAmI!8Jo8xLXNmHc|<XA`JM)Cs}APc?kyZE(y#F|cb;ZocJ}pQ=>=nznH8W>
z68>RUj_)pesZVOhX&YtPU6YY=p=I!WmYQ4k7ZW1@+wzLJ&^sL*C#;#DGu$RZSU>Js
z4HS71_hhFUsVZA$QxJ~eI5~{9xmnwKjjS@wemnroN83+v*q6!V0<-FIV~?YB)Q26_
zyZPSmIhUf9+*U#&jily)y)-MGxkKp8e8IA`fbTDN7%R3PZE??VGiK1jltvi*R4W5G
zFo8e{Js*tSxVi^h-<iZk4&rGy515{wLTcj3TVmIE{O*yk?ucA4qp{nzD=gG@aGfsk
z^PA=RCok(T-&YgIYshH=|4CE_c7t4I>5CK}nBm0k0mX$0s@^DOB=PciS8qgo0Cbd|
zMLrchhM2zyUGrdb0?^Nv2E}7Y9U-3dsWwp0KoC7{N+FDRHNFu)44X06N$z<`igQ2p
z=Khbw%W^yM#k3cxZUO>EF_U%#Mb)jc$Lr;n0%A@VKrv+%63S^_@c}IK(Gte&L7VH=
zYDb*U8v1_Ik+y7pj<7=5D`^+@p|)q0@-Wpp#AolR6X2ART)SL%im2f!V4O#aAX-DT
zwWRy8dGalZmpwE`ip=AmIQAg0lLqw1-q56>qDLE<a4Vm}CI@$3POg?Tq*b^XGY+%T
zNWRrCM+NU$Vjhr;&*eWBb>zJcn6Y>2h8Y>-p^n`lXWec=HGRcP3n4dfp24I;6Pbx`
zz+Fua2FBnia_4>Kv2P}hLV7b^X*^7l)gt3@-6naG$$^IZle=Aw<W@c%v?V(x6TnTd
zk8>aSIbgDSuTL#<D^uh37OX=Ux9Di5hSTSF!JvUo9g&mj>t^na=)gS@%Z#k?7c&Y1
zBLl@F;u__LgB2z(2FNZgyOHdmVAJ*oH9Y`oF9Q}ppNSE~%*u;D=iPDQgLLaiZ>UTL
zChO#Mu;EteQ`5mukk<?qmkGp)>lAqxnM-nGqp9Y8zEafDNlb&WF^DYJj}O40-Z=A)
zI?GTIxz=lziW;5{opM;^7u^CBJ<lhSyat;{Vgxv%`@@Gr9F34)2xoq15;@&!rW;jH
zpDt19q6OQm9*m1u5UGEDLaw;arG612P=C#8N_@Hvp=MkKf)k+6RRnuZ`hP^WtZ7z4
zd3L3}&<B(%i=HWn`OtO~;6$TX%4}Q<3xJ;QX=Vx=@*PpQ1co&c!?VW*+<DR2dMFgx
z&6Lm$QTeThMM!P?lP2LL=bW)Xw8CxD7T0IG3NG*3y<6q>ZA`7JxtF$cIiC?VtZ;$A
zmn7@1sys8)B?z}Yt6Cn#!z@`(GW$}-db9P)Rb5Vw7-uK9&b*QO$(DGH`oWLXxzQrq
z&d27JJ6UPR5+g*b122x-Lgnbw@Qk<Ox)@M9P^}y-PJ_!Fo#vzQ{L{g&_c~2{511Tt
z?hMbPfF7tiy`I%qp-gglT?B45N5E*cVuY)~2z((@_g#Af`_?2b5^?KtnY_C-l;U*U
zjI8waedxa$BdP#2#efwC_ISO9k;Aq!faONmxJqWq(LX#;`O_Kefp~Z2dV5Kyg?HVW
z8Cm-XaHMU?b(dAaTStHky4=96=~JEC>;0@fk}JoN>m36Ckg_t=sh-n$0(zwETb{&M
zaGSZPLB5bSctqPVjubPpJ@Tt7TgFeR-ObG_p2{Y_EM1Q0a!1|_$k@UL3qX7|%MX>f
z_vjQmT20DOXtVpd$ZQqcYBs0sel2qj)VHX|;0sYosz~wra+u=sP}(;DKD=j&x{96D
zoHbLq_~lG0L-a=8ywQymlXHPqGC5~(T3)XDwJt-g0ki5gU$XB=-&Mi~g!I3pu7=u{
z7T>B_jqvKqDRh@fkOI;^;<IAYmhvQ5pNgV(vn?6+j?1#Jb}=Kfz@|kKQ6D{j?$cBi
zmq;~I7fs<OAx5p=qbOmTVdOa$C_{BhjN%c&K0=vAc(rA(aUztaWyhYL&F-hfoGjDC
z_7|^01lKR;Y#NCle%&c6_N7MgTdKPb9JSp#G@1P&x<;!Fb=#DY+g>GKKHt|-G#x?c
zbX9L5gIyd-e<1XODpDFI8h66_li7yvK?>P61Q+naA(%?3ic3ra7JF5z&R#w^X=45G
zr0gT;`LTPF6byexUBN6w1zhrCV;hL`R7o4)cr8=Kl^pw2lp4HSF#1&lGoP!Rse!)B
z36qM3`(Vs=;9Zv?s9t_KJtsnmin2B8@m#tY(Bpx1N~6Y4*DueEv|Liy=f>^~C|}h<
z^~9GZhH0cSZ~<pVK)!3|UCYg?@h?Aql<IrXl$V|d#d9XLw)@5UA)^uJ*sZC$wE@~B
z{?mU&thNnyVUg=L59%q9hOwvDZ=n^ux5foc0Omi!`Usr_iUSMFQ)HL`*7HZOgX!wW
z>EINx_s#&}VLqf!4lK(7zSH`Bpy=n+Z4A$%@Cq%+>ML&`1k5ud$O~DWnd_aIpV4Cd
z7IRQi9lS<u^J)-i=N#g(BNmaf<@jr3MS3L&qtHLB$iZRgW@F$mR5n|DD13OkCv_wa
zJ=!|jYW3bZF7kno24nb{q{2l%_1<AYVL$?<B#}TQb{Gm*dypq;2V9&rPid!9?&m#Z
zekXX*(Qiw=tgO6|LH4Qr+c8ixYic}DDwaXai(4HVZ_Zenq3k}pZKbz|d$qXmz<{`*
zw%Mv|{Xgp$Zv{9*pMaqic@W3K<<KpXTswGNYo9=WymfWfh9x)UNMNxrd0(%J)w;BQ
zKK$orLEtv1^5SI5?SD{vf7;S`S><Ld5V0>;CJbk*bKGrQ1mdgP)xhgV5t5$x8W?AQ
ztNV;uSB}=TUSYi6&H0bx0JfoDQzuX;Kbf|NXCoHYi6hc5=9_q8uBBCsYkflw@m(DX
zmJw?FkohohBq7yC#0Ius9gmX&{8>e#!e_?%Yddrn`Hrxb#5m-qbCHd^y9(>WgoeKL
z)CHpN1jO{S+vPjc2<>e#)(a6OwKZ&n$6-Oads)>uTCgBa(F5p*u-Do0BB%46vh=ss
zz?Y9MHPeEm>t{~taZ35;iSH^EkIYutLQs4gF!{-}{E3&LzT^k+ytqD8z=A<{iDiAa
zWl*-#<A!2?>gAAc+(^-K!y$KMBkSJG&ja7QmhRQMf8Eh22eyujJP?<$G(d}5S9f;X
z9^H(Uq@mWWEZy?6<*1Sc(M$D`I>rmdAP}i&nD1GlEM!5|k_J6bYSH=&$mc>naXViO
z=Ya94gQn%+?W52U;i{%>H{7e!jaTd-hHI`ym^JOV5f|WxHysK7z6jRRF}C#pe!Nxo
zBV^5xgReJ0{M=9lh;7h5pBcZ5@yT$=m<~7$Vj(P@H?LZBnPv62>&79FRBxxlrsJ?>
zfTz@Nj)zP@Ocq~Vn%VpD4s#ZpuWn^-V>?g|4E9pl(gm-Rdb~s6j3fGvP5#|73q@_V
z)%OsHUr&AY(!{gVWx9pSUR?IXA56KokoQ_0x2$m=s2M5h(Mb^ypQ~gbOr(wzo?sF0
zW~@KmbNS9AHteHCB+?Mu>kvCt_CMkQ>VDZA;5m|@dF>tv;+9G{nls$loqKLNe|YVn
z6lm>pS#H)cZCxYUvwfdHpIA2OJ=UH5z&u%NgX7B?DBpj46H_A-Uj*vS7vG|~l{=K4
z@oXGk(;2UjXNn47rVn+;ZhLAq15pC8WaoDkR4g+~ih%|`W5b?x^DRC=hIzP79cqa}
z55C*uK!bSd6$!gJQI$7jH^1EEe8k9ma3?TC-qC`~RF$;nkgi53qbVK-z>7w)O<j^s
zh9Rnn3E2JvFb!TdZW*y{(yw$zv(+_AR|&=@;FVzFhXQ|S1M@?zI_Np>$cs`Bjj{|w
zXbFKjI<OQQd;akNZ1789`a?QYb9sf2<_jTmoUI4Qw#E+5+F3a+_bf9FIa+URo!$so
zAagk^*hH@Co;Z16Wa-KqI5)muFJN+(`W_T6U<&Ha!l}H)2#qXEcT28_XhXg&Dp+tZ
z{{Wlxtl;_$V$L~b<kS#c<{JsL8|)HRrWO;ReNCY14YhlG&z_c0rs$1~*(`&5sQ(;l
z(8wQ*H3EEiJ>|_+@ry_{k=w8pfB`p0-qhQG2cV@WT*&W{kUGVgwNFlB?&tm9i5s)y
zN>}(m)I!B2uhZf*+=7cy^64Z2d2y$I)V2r6I4Kd_<=4VMOQJg|6xCF`<|YtUSWAmB
z|Fl4QpzK_U>K{y}9`bfMLqiAF#JpS-O!=31?FJv$fy~jdbsV|}6Xs!oB&GN<k;u(b
z)K9m*hpMYqiZ72F4UsAy?F}tYHyikPtLEhT8{)D&+B(|hhrC?6E=MiPD-8So7-G6X
z?~Gf=#qTlLbhsr0p5<&GceaHtd>?0?qk6mM+uNBEo+!ZM)pX03$0z$<ew51R#bp9X
zi;3Qn-8=0Ha<FiVAyNQUlEGl_6f-uwn!#@jO4N2na;{_a`*lYYtV1=J2tCWOFf^Sl
zL+iT&>d`=M@)-j7+&W+UfJHz|%Aw45fLJZFLJT3tlp4}08B8G^z$P;=p8)E7S^-CO
z!g{L36LV|;?6kvo2XL3Iv(?Q2E0kLKdbStk_0;BfFeN1AH8h<@&VrF*q!WaX0h~^{
zu>)Tvy{U`bHdQQ=UG2wXH;laV&{!!Eu?~XbNOk6Q9FfQC+6Ew+KnTuaCuq>0rDzGG
z3|H<r$#f2`^&<LuyrDG>8;Jl=LmGr~JRBYaqX7+npQ|bk_}&Yy#@AH$GVvXI{)Cdx
zYY^^!uL!ORyR66!k0t;tpjg7sZ!;8#!y4vqq7w!(caISBPM~NX{eYWJPc02)w`R?S
zIS$zuQ)2vLo!a-wICp1ZJ~|*De<Psk2Cm<10h(2vgzm@HUs%7iRQm&GVQfqLxq|d)
zsy|ak=|siGSiG&`@W`+rp%PLfw`UZ9jDo$J#)5)^VY%)Ys<q$JEC7)x`x%3yut8r$
zpP>^!A-h#=L?cOO12!blF|Z3(6RNAu0d}f#*JgH@RqPMTyl=@=qv%lqop`1jRzLC)
z7M2*q2|RuPN1o2wlTKFz-6ocCLGUJJ@qL{}zEK^;yCz~qh-Y4ZrrY==Mc*((9zTC}
zuedBn`C>cw5Xm%%`}uS^f(H}NepdlQpjO;+qmJqhT?s_{zy3Arm2cm`%ZK2nnfc2$
zbwLmgzN!|#AB6mmLmi|vIL#~aak$B(XYy2@7pI|0dnS^G*(*u2v^%a}{(?-M*ypnu
z_0(2cPtON1K|<uccB5~Cktr&OM5#DHFJ~V251sfFfwD4?qT3<wZaM#Om|kuO{Y^Bi
zp>s?#4@E!#)t9N9Pm@Lt+L$6<(A1jdwN!;Ol0AxIaJMeM@Mwxfw=Oe_96wm`SAZTt
z{Z!Lin|j&lmUSN`d!k}(dxled<Urs8;b=pGTLEJAlf{cXQv4-}E+9y$6W^baRS4jK
zYYwbRT&=tN^K7ufb2k2EXb;hnK^-qJ4(oQu<}BObf|KK1CAvXBYI|nNph~Is7}UA$
z`v=wLA0LEeorAnQsTy=@SKCX*%wY`#?Y?_^ajpA^KuWDkoLvI@G9cMrJLtv9CORog
zi#z{5wV}K0q|BjJ(9srC?g4WB-1Hu~zARnqtHCLOVCdPxFo)x^vCexm6Wag7-g`zx
zm3(`{%-<Q&F(9LYh=Ae<ItqwLjw*tRz!=G(AejcqIXI}GB$ZK+s3IUa2Z;t~P;zWC
zl0y?DbT`mIKfC&X^4xVl+_j!h@4IfVW$4rA)T!E4wNvf=+iPO)gcdo^-`4Emf=EwH
z+|qr<5drn)S0kWFaiIxLodH;)rZW|=#m4IIls&9{cKWiC&t_R2nrXFX-tA~ed**9z
zjIE+eh`evz{?QMRV}!?JB*KJ{s)MqNfnTrJpJvc}3MRRdV}9o-tK-UF`~}}SYdoe~
zxK^$3`H<e${XC6-$Bz7#3Qk%pcyMcr9K)A6Th4hPye#B}f>I1ZWH?mi*C5<raz@q`
zaxsM>jelmzfs{1u9KJj10Mb9tG$Sv|KHIJgIQmy>v;}W`hFV&h=weCkdE#o0jK@+I
zEzoh8uX0Jk)DlEB{zwSzAS&5;p$tJJ+=I;PtcqwBh&ZKZvfc8_UURGf570xFzmSUL
zF@q@tXbnl1B4*v-w@{ACvKeAz8-UqMAQa@$mQ#6peRN6-l<-alti^F|Jz;&7FlGMd
zr&o?hbHYB0Adot2gXW2Vx5>i%vimnCu<L7yW}ANrTEzE-Cue}!(j{%L=}k#9wx;-x
zxGv?DRslv?nRTy(1aRN|Mda3ZI)KRW?H8(IbTQ>I;A2=cxO$S?jW5c|Fv$6hrLT}P
zAaw=MpM1(FC9WRJOC^Q<uDvTveP>`CCck3X4&cOp&L%uNy3n%1WN7zE(yIRmcqB*g
z@1E{pa+e0d?($&SZ1cEL-OIc$=E%#Z5XlbPs3oa(?{T%EiCN@uMoXpP{Pagf&Y-OW
zD&2!&AoebI*-!=a(KZw86_Y|vi<HRK#9jk1P-Z&VJuh)d0-q62J9gRrQYkV#06nV=
z;K)3zyI*w?+)2mvzU-rs9R<pm4?k>PJW-lYRMW79AgazmPQcW1nB9ubA!3PcD*<`>
z;4q$_8BpN7mS*qU28bL89|Drp*+0FustMa|RkV1sI!aOifPh<)DLq5SyZig7@qZR$
z8Jr(jF42P+5Je1;WUu`qYFyI`eedtD^4JB)!Q(l#aLl9M)jm>zynK6S*&#VJdCu?g
z??U)kLqmH98MpaI#*M$^y!ljZ9>Pb}sx>!zxF;GoP6{#FmCVLA0Gqb+4lf?%=kn#z
zxVc5__=*6g7_d)PZx9zDO*_P61xWIk)wn2vlQPzw)JjZr<Xvv}q|N$CpEyy?=37mg
zu(!XF3?VjJmNY{JFPj)JY>6!a8AiNiN~sIC75G}bpPa7tT6G`zXF6gxrE9TwCYb2C
z4{5ZKj!QP{07Z9D5gGLHLRr)NGjpAmU&B0I$z2P>qmVTVLqwiVgyM`~laJp_eT+Jd
z&W6x?54bLyBHqr%F(Ohh`j73vn{6eL!g`_O|L*;Dd90470uCIW?@We+cX}@JgWkeZ
z9L<GrV~k#}`>9m4g6rB};sEK|(0>{n-Eh>WEPIZ03!FYwqyzfT)d6H0S~o(isW4U;
zBLa<obUdv@W?&gaR*KM30-#Ng5n4Wbv-f&~8K<JYQgHj+&ID3enjJArm@>JIA8knm
zFrVe+!HM+<K|u4kx#~+uEug{v&V{5``1WTkd$Q};_5{#<hG&}E;we2d#nY>bU7|y*
z)+2*j{h?L|ICUJRBGwC^{Ky;w;>lT3=X;J%6`R|*QJy7bN^Ic=FuR@KThx#@pR_mR
z&Vz<TYP&L_JU^?hF24?6YYz-a!yX-9_=``qp{(yy|JWhbP=bLny6IZu?V=UxBrBX9
zzQ|A@QFYwQkD!EMy#ws7S5IiIQZxz3J#2izW}p}!Ae~SveGH_NZNNCkX4`}m$-eKe
za~QX5`@N$AGL)YI#ICg`B4Y}b3Il!&y4+srg6XI$1|(tK@R?4{Y4O?6!?q5BQm-^e
z&WF`n7J3LnqOv$MbH=zgQ~!f8p#hTU>YgJ?FOIAsQ>8!04p(5{ni=S<sgFASb-avF
zFYMvbscb#16HMIBWGO{?v#qwq`Ggt@fVl?9Yi;%C(C)`&z9@EacMt9>8b`Y;EQvoL
zJe794b^tsNb>Nb)Tp0^GEGu9YOxfpLEt)x;=(w*sHh1bitu-sZmWYILYpU0KvLk>V
zfrr(RHqfcjeTWzXEHRm~oIGPd%n>-P5)$bc*rXyZIF(O|pGhj@sW6R?*aeCIs%y{(
zw~oiG1Gi?|fPG~ET^#s#w?ajP<8VbdC?}8{UGsayjXclN75dC?B2Tl!aoUc8-q3--
zfWC7~0SS~9i4k{&HLt(_E*%eD-7dF*p#CrM(E)0Du7{CCM?NR80fL~wj&X!z&5aO+
z=wjFMrqUH11%|tDR`bT35NX?b8vKI`H3Lkj%*CU{Y5vFUw!?-kH^4h<9N}>Fz+Av*
zgf`twIODz37k>U4%AW4o3#V(qm5sFXsFr#u1a|?Doz}BkWBQRGjmgs2p=tpiru0ao
zBce+#o=D+%J3iC1Q+)oFzq`!Dw~wSA_AosDWFL@bA0&3peDYW8?{;Lxvs=|%DmaaJ
z0>i5S3@QfL1D`zX$$fC<ww+V#AQIHf%n+2rj{?YjeXqx>?D)O5B^GkN(NE|AOQko)
zb|i9qLK^_HSPcRtMZgg<!9z&%&;{R~%Yy^ku0@_oMZkz40xjlk9Rb`v_5FC`W<9lD
z;}l{PI&&?i<PFae2!MgFR9f5e^vMeVY3aY;aCiXyfqKx7LUdQp6-k>1o;*bFZT*S$
zaJXCBZvI_g^5v}e#qOBb9Dj&@g*wTjjd`(VwJVWeP%2P9B8T8uMQqqk4v8|+AemDo
z&ht;lPWE*<Z|jFZ-luk^^cEqxc^&7kelt=PRXs(-4W^!WZ|2cq$$7`gqYcr=MYBEx
zgVjPm{jp3q^}z7<EIzJxg`wjWcwCOhP`_ymREW6dT?#`GMfzpwhX94~3Brj%pWM52
zI|BU|SBYW>WIbK9ia?=pNd-MfMf|p1V=Q)O{ih!-=iWt9wFuZ3+v|_x9&R;z3+N?h
zAkg^1T6QIBaKABh&TI$M>T+(lKI|GgjwAYEYyDcW4G7EK4<Zcq+tUVcaIR<HKiRb&
ziR;DJg*KY?RJ-xp3IJVvgTT)Xu?{^s`SUJ-zPl!Gcd1}IY96@5%eAv)>?``)#O238
zv5Rz^uAjdHFGX-*8!s^Y53v<DKJ&kgV0e@NBbr>FTctueG{fKV5Bz#m3ov~Ep1idU
zTm3C3sGUCa-)DuR|3v7p*eCq~=0fltEumThJAmT=6mcG+3m8T8;CT9NUN=?f(X-sJ
zXby67gXa_>N=VeaEIhs8CO#}<8w&LBOF~>(h$nKAiKB?U#>^ZLwd2_aYjOLi(G(1K
zYB{=uN(T0G-qS-CKxtP|*{IsYf*$q-%C93*LXpp24&Og;iC-c%;h@u@Yu{~(4t_bq
zC$KwK^)E9s>!T!-Gp$#|G;f7DpW7pCCK4L=^w)plv`?SgA}{CEZyD&-SN(7NOM~i}
zMQ<ZfS8~)#X;GFe=TbcZy|m(1NH>};m=MnND6LyE%&}Z)g=nhYG*u{81NjCRbpYnf
z2TLm|U8;@`f{^@jrB;+1a8oG+2M|cFD-J|La>3e1jup!z@D%=5?+tNEi;GEsY<e&$
z-XjCj<u~s*@Z`U_x206C*Vor6ezse^)LIMZ^VS(R^a6c9%Kz76@14u?8)&BEg(V~2
z#aBX}!pyvYXE-!z>LFrl4YiJzClVT<T<wN*f&wf$)8t#SkOEX-LO3#JW>5j)fS0fD
zy98$eu%Hb=@wV%qfh3UiVc20<Z}oC%?yd?n4|j+~2&p@PJ+!czf+Dc)gZ$K`Laq`9
zBLYvp^264V0-$*)!4rLototAAy3nPib^KZklgHw6!^SrpqBD^C$}@}}kW@t6J$=1|
zouc9iuz+60T@=sne!eG{4zBm79%DE47xJLSMsKMg;5$b-jf>8-wtfY?74p?Nj~s3=
zAs~lE@BQGXjibk4y(-^$mX=u4DQ3OcMl~?j0TcEY*O!Tjv_N*NB@KCbZP%8zqvH*S
z*K4zZsN~0><HGLt{T36G|L$l{f}3dS;&9M|E%&;Opap*_#fO_)|NHGt{bd6_8?aRC
zf5RX(b^|nXf9scExM?hN$4q4m;Aw4b+cuG$<Y!*8IM9}Et+j`BZ@D9$=DLP~fX1tX
z0d$>?A(TiDya>1Q_w^lPD&EB;vwRlra!!_!%C~EO=<5pz>O3IK&#W`>pO0pLd*aRX
z_&9&@QSSR&?$tJlNjX&k5+KYY=Ix?Wbrcgo2N`1&0)6KcquH6y-j}PWV&Rk;{N|0-
zdBN`Mrwgisih3s`6@7P&-u>iFzYc%N8Plx}ubYsaECI=}>(}d1(G6sN!rKFFMx<>Y
zFk&(Wh^m5t?BM{|C7a;QRJse??%}?Wu)F@Sgb#gvX9ILg{Y^CJ%bueT{;wN?up7ML
z2F;(H`7njy*h~T*&EO>`tcDUa+6Ew~s56@Y>w}N^=X)GP>GE#$APoB&Kz^>h-|J5-
zNR{yq?qByqZr*ygo?)$XT=w1dZmos``sq(V^o4&U?(I4Rsk`ep|B0pBNB}I&MDd2U
zrSH+ZZpVG-Y#SA;D@T9C^>?f<ch25Vr);1F`A^I($-ag8?COTjkWXXR!_jp}c3gii
zS$^&Qt#EzASjpGd?nl=*wtt6y9Z&+#j)IHm2Mwe#jGI5@eRmb`)13<RH@rHIZSY^A
z8N%V8!?oLsHFFZ0k=W2osyv-IWCj@4$cFA0U=S>A=e96^ic<PHRilsTQ+11pTYifx
z=Z5ztVZp4@{y<OhjW56wI>>To?>~{+ct6Ilr6H60PsN|@S2AK`VBF1pzgu;~byn=U
z54yhbeqQ?Z`rm-e8~Z;SfK4Opn0n_8-EqS-9v$CZhwL_V=b#?O4p<M%Z{gV3yzyG|
zKu#(o1h3EHA|_}HjvhK|BKdPvx2!PHq7%C7P<GVM-Ik6OW%c4$@!e&!VQEe%V;h$V
zdSA7nm&I7`2e(4=VH=te#fU5g#DBT}A!8kvd+LT?3E0$2!5BP&p)8bV!m0Vz^)BDa
z!#IHyY`&jcl7T+HC-L{Uw1;mPAGX1CcXQvd0^FkYCekrTsX_5WXURMp+VI2}hU+hI
zee;IvW7t{|I3#~TX2aTA!&P!+K6G~W>CgVlIbc&9!p!|=^oE^x8r!MlvuE!QZu&`U
zuVL&^Pxq4VlT-k}SnuR3L#!Fr-P~`FZ`gR17)>XJ?r#~p^pn;MHW<v{7Usqy8(x|n
zNMAp@m<!L|7uBZK`0nDqQ@3G1tw}q%uTKs$1!-B92m%{#x82wP_PQs-z~}$qz7qt{
zP3t|Z#|A358OZhP269beWV~}k{=%~j9qdr0Z&8zHyAEC4z!*mN(Z?y51uq5&v~|Y7
zAc6I~9vGMd;|6jCVo`vD^1e@MH_U1M41JQkBDOL&vTbYz<MH)>oxN}O=Z0o#u})@(
z?K;G9W&_o2>9fIrd&Vc9pOwl#mN^QE&ObX9O($o)QNX$T1h=`0v-eM%gLq!9@RZ^I
zNtkqY%;!GYcv2n-P%-MZJUpl-!Tf&Gf8S{FtPt*9ww9uxni=_hOIGv~3XG_B7?RYh
z?w#Tbubl37L|)Opz6Yr*BayVvPT%`j{S_{JEz(Qz70`2Wgbd6>kNqC^Bf))0krN@V
zuYa7ewKlq|m^{fABz0Fc;%-+4B#W-RX6>I4=-Q8zn6btS_0Xw-s*oNI(VqD%qy!?3
zv}+~in04hx#&zEfv?<pEp&^I}a;u||h^p;K$`_lS$m-W3sQNqpmDG<9_h6Cb_Y~wW
zT!7;1m7CtU=2-%oCU2*P8f#kVsu8&3l938xwwj|B5U@Ll>xG^3dRG}-F;JaXpGngM
zQBLP?QR?ZVvH6r$AN|jGob}{=MbH4>Y*X>QeNJ{S<9x5^*r_o&N#eNv+zZ*VPv_Gr
zu9d3)0VE1{nf8Brxc}2O1qinTP2~rVo4A3k3>BoUip?zCw(hDo&~Kf1KNDQx!2*W@
zh${L^=MbL7MPAPR6$e(nw3X6IW<GxM1f@I3!;ULv&s1Mehb9{{bGS$;$6l)&_%|V~
z_(nta#uvvxZ5D{2z8516?*8rPLiq!e;dY5oVZHp_)5H4BmCPAtq%btLg~g^U7}NU^
zHN0(I+T{Xyi3`?Ot{{C{(Bzw!*ysmUdC@a}uhYj%9$S%xHHR3v_V^rd`&-*%?0klO
zC)vrpremSzxDq(Z=3a>E55)0Z47mU$J0AC^-}5Q+;G(I!y_xq~806jQ`-W2*=~<)P
zOC&(i+{z%nI1s%G`N7d}D7@}aFu_pO4npw4Bpdp}%PD&TY$S%Zn%}n}RK9k-njiof
zNgTBt)W5|<>PRF6uL0z}(vf*WUmwuv2_2WoP9f+8sG=mIIV6z3y2vhy1CUo$4m*gH
z#m1G5L7>5x!tTntsQt{$b<(9L;cb~N=EPj}(%aYM<@fAaj$YTV*E$FHI}{oOLZUfy
zkgT|nLu(5?(|a~r24F^c;fQJvY4quOb~p~312{dhB!Jn23>;ryu5NohWcDN^Ck9qT
zN5GWo$#~kW8$H<=a2>qn5nbmkOTDs1Em=Dfnq<y6F6H#GTn!AHZ=W~IgSEng6(D7h
z3&&;%a?E{KSC;TwD>$H{M@Ueyf-jgPOFP2*|M5$MeRA9Y^mqM!#|qx{2Mg_f)ZQTL
z65LkI!OHsd59`2e2BGW=&Bjgp<WiT|Et&`Th$fD}V9Un|1c2w1=BQgW^8f;YMxUcb
z)3PJB@{P@6gzZ>ADDx^qms1N}v?nMtLFJ!=WLVHsQq-hHgeQuu6v1y#RLf<!R`0@Y
zaUL%ZVU0iQO{(Q`xBNG9PJE459>h=rq46jA0xu$W#|McC8`VUyGs!NgC-<fwYqe_o
zmwDos(d{c#(jzcXId~(T+~zy-jMqtOhnYpt0C~%KX_qqAs@g|&(TizdP~kF6=Uyx{
zMfU`>05q1)ew{M*Qcoc=b)n)Jzc>Gz3K?n{GTAmW?cWDauA9kn@pSzF8oU*B6-rOS
zivxh{FfXvr06vw!-%qdPG=w_sGT<*bh!!yV+zR@B56f<ZFD7Y}9#;W}qHAn^A*&)k
zZ~5W6vvYRrm6Yb@?n!P7TeqUqE7sr3P*7B^<PadGuBOJSS{v~L7dBn-=N;K=Z+ICN
zwNhQQj@0QTjX~T(AL?Vf-KXcX$9hW_Z?2nUA2<Oj9`%-iVYHD&U=i0bPg|X);o%5i
z-3`rf0dr))E%mXJPVuJ<dJKYOU#|21Ct~ZawO3UIR!iqJMrf-wdH)rQ7#_CM*rw+q
zPF$v~^wI))Pw0lNbL1ySf40z(yE4hs>)N02@?ywZw$Y;>+4u!-sd2K+6IAooRsOL*
zFcEq13SF2(`*I=K-(y3<-D$<8%SUdefP3fE+AV?`ZoyGI`S^uMCA3THg&Z#U(<Lk#
z-q5lWen6Zr4;Bf+Mn@m7vh~w!2A$gF-~4Per%?MMR_kbtx2Au%0`0`DZd%khw^KQn
zts93haUjP{mj$RL{-G}~v)-hp@{bJZxs!6<Dq(I|FZrKu_&Q-coMW~~S)C1OD_NO*
zTeWseH>Nd1E2CFog>;P9b<w^7VB!wcMc`;ZYSq*mN{QRvY;I}ES+YH@tMwd(SE5gP
z=Q_t=(7~gZjM+YKX~}S>c3up@k{uWdG2AM+x!$lyBO|9KdZnSe>DfAjyTkDxv!vu?
zGo1V`Dam|pMAV`qVxEWo3SfGeq6FXUwhBc@b*I)%x6P;&QKt$oT44iWm=K}Qh3mb?
zdAS%2Vs>XMuCuc^kgHpmZ>$EMJs5Q3h8i!uz7yS)@+$s-HYwc?_ev)!Li~6SoDVys
zjX1K4@DwBG)L=$O2Mt_oL3=QW3^|OVgE_zWc>D#a59;6bfg)JZ-RyQ4y?v$2Uw`#H
zMjK|V1{TRdRh;tx1;9TRzTKlkTkOJIM9!1Zu9M*|nL}YYrSwut3?^A<_xPj`r(ENC
zi^b8)6M9p$0Efe!>Lx|s*W7eGk%QBb_IP6ulpo)O(98cYbPS66h2YWda%fxfD0DmD
z7!J0r9A{!ul3%>1IDnG`O1b?_XJYd5@)SDjcxB5WJ0F@)`^Z&M7ahgHs(Vrb+%A}H
zqG?F%>>LPHWioYm$?<%;Y-tC33@k1gp|^{Mw5xeSW6H1s4>Iwo&tFBE2T+i~@1755
z1YK4E*LR#QrL9sgvcmA?Mhb3KKhN;^94FQXwL}Y&Dll5v<ww_ralio|1l-sft)8Zb
z6|_}dzoDkszGwhWFv;Em9u<T^iC}?2b7A_Ejv5*{?YcV+!kAfEiuTF!6CV8mWP;DD
z7<jT`NUu-=8|re^qtEoA9HdK-TLRzfipc?Ko|DI+d*5S%%4@D!`gL@4tN{=q4iyz$
zdh%;6*KW|EkVxr&G2OkZ8?ctpiJ8~GQ*@y44^!4;4ch+b<+5ME9cJGD;5PyMwr#rp
z$PI)<h1-1er8nUU@C5pJ8MU;ul*9b`{pP3pI9gU(QkYixnXw#BvI~)gm0qz}Na=+I
z_tp>YzD3ahMFEs=l|T}^h+&cFLi#TaF%>cwLy(P<LdJ*h&G1;k1DY`ql8$8KC6(=5
z#hzi^^dj4t>llAvnvM)cvMTULR?@M8ZVBW7=|jbdFP)aZ0N-2FBkK*_-sX$dN(^LK
zFV`FN(~Dby+g2`%&QO5bdAXKKbVs;JR=aI<0F}$_G&eV=r=1IZ4Lzw?eNO<SbLiKT
ztToC+ojHt>19dcl+{qV<$yRH%2HJ);VG!%^+uFxYYJIn_U8p>_&P3NPJn>m)Y-<+|
zGW}pN*cCa>ADkPz;3f5gRjxhb{9l1pX8&u6s=-75zv{@+hQ)+vU=q|p>G8`k_XKz&
zpB-X<u47Q&3c~y$YjlEtoZq=(X;SciWvvo7=jHi$S><p?Qj3}*0BAPG4ngj2MZ9un
z9`?*2rd-39Hg8;afpC=b@XKsxHC^Y}Ct8f}5)!_&<puL7Us^kBW*9xWKEEGy$7)1-
zFNgE<@hKO)efRF&h2p99EMvRro<-#XNyjOFsDYp;FMs>?>$`u^UnR%69-qNLzJ$QC
z!ewSF5ARNikBj3`2-yETEK1zgXnv}@u&I>th&RgjOE51WYklwg9PkOV?4Kz9ROT5j
zs^{Om-7){#hcnDXS}BBIdC)c5ZT5?N9y|SIUTbDFe3^Lu;)KRC5$U_%KFAZD=Nl9q
zsg5^q-Zb(r!<q%t5wjuTUOT?$&!1npc5OFQ*7o%+eUR!xnd+XhCp0&gK{<QS$+@U)
z6>rkh)0K(ul9T;+u#1$fQm1=U3&!(ubQLWOt^ppVK9xLa{p}uOu4!R-Co5{`-X=x`
zpuJCut0O|7N0P1~%eZc*<Yq)C4oQc%HAEm?A>lnBNJ5PvR|}X37t;7%X;*T!X(@Vp
zf4N`hd@*TcESk1F(pF$^J^^f5oQnvU`VN(=6I-AZ@(ijizSrb{*xg%uSXj^t8)I|K
z!*i{AdtQ&w^ROA@%-3~@`ZoY_ivRlj_yC~RS=wZ00-j?2=o>%%=66>#yp?Q+s~>IM
z&GWVf<uo)lHiilsC`duzEgKQ0I{<2K@^9X;zuCfFSXkJ4B+?Oq+qF`BwzK^aqU&Pn
zM@-NoG{!0o1WHa-zC$>+wKCKRv6cBI$v?MW*U(^t`lXMIqnvpR3hN|@$zo8OQ?t1C
z1sOshV73Ro9#5-oduUNHIuxQ8IMv-0zW4a?;{*R*Q~9DkUHwuhYbqo&Gc(&=<K|5k
zH9dFx>rj3B-IbWkR0D`;odMY7@*?NCQ~!7X<eb)a4vB0Xss~JnX%pbSvUR>p`U=>g
z04ZrO-keY~HD_BZ&O316fUJibekP4@xA$^{n4pT}WOg=%0I*g}Qs3o*qpij%!MIX_
z>+nnC##S{?smw@rWsYeJB9{z8cs_m1pdFDit4@X;Ac1cM6J7wlpw2<*0YGfG2@krG
z8<siQ<f6#wd<S2IKYUX}CQV66DW<5X=u5BtiZMQboiMxxCuEYcCK+KRx|TpmCO*7B
zThpBnyxjT~fgFO)vx8!D)sS<Pc`BZis+GrYR2|A3%&S^kFlA3{Er&VMUz{CMPBmzF
zbKV+yE5aVCRpeyt&nCnJcQ)ut1I>;6*+u!yr6nCEd=sw4<AHEtDaTj=*DdIpiue)p
zN)sR=dQqqdPBW?XWmSo9+ulC_CG>iAsNi9Tsjin{da_}6&INcoFf&74@~;Iw54J(p
z4%Buq#+OJfjmCs0<32y!aRnfR4Gj&i=;}r>1E%agQA=%@x_D)3vF^&2FjD4kc$+I+
zaTfei`!dX<gV==PS}L-Sp+yH%%k$Zr*^|1WZC$>XV>Xfl2PnOQ4ijymCvTt4BD_E&
zy}xz0{zO}bxSp1S&!(MX2V-i(!orM#5P&Z1CXq=;%p_Plf&pThv;q;rINH-PV6&A$
z-QYi9;qs-r4p+ZKgJlU}7c#mG3+YaE+PinY)&qFM9WM=q;1`~A_x)J-9z(Ap2*N-_
z^=y+X;bc=NhYAhGl@G<KMDEY)aWPjRMgWXy68ZefsuOJet4-|+!R80D{n~{8x-9|-
zdUc^8d|pnKhkQ<JKuCQF8>_C<ZNHpe7h;Ndq=B-=dmF=!`SjbLHH!n6($z&`V`Hye
zz4}bh6Bg;@PUcp|@ysveNIzBqOUG}g!YwL9xHALg!fM(w3=C%a%Qf;|XJ?-#I{f?m
z`D8<1VNz;AVtMa3U>F8KBPfLl;|C^qWL*rKv;u5jQyju2>?v~2xbx*%KI~`xzE2MX
zt^3RT>uMszg>Vv`qYk9L*N7=VnKFH#lZN*>aBavenc#~odR^NML&~2WQG%?`BZ4q(
z{&FqQsL+2d0QVHM?8^7I2RKoAn2zdjQ33wKiA;ZrRnZJy<iSg$ny}~g9;T+I)$kf9
zxt4pq`~9!~F*h^I+`Oae>sR!qnb|6Vin2$$!?$M(Z#Uk_B_lPtViEIuEi`4$0Ys>6
z;|kd1i(s6!wYvs$FGop<=hTGgIB2vQXqW0`{>EaP1B3E+@6`mcP$MQo8qtHENWsq0
zs2hVtA4hHi>{|{Y<JxK$j}{t_QEdcU1(&CrnMdyTZ-D5`vW=DBUjrdQs(r4TpJ*4#
z>A^qT&i2g33Oa}QHcy@>h%b#1QAao8WY>G4!&2&+n)?Mxmu=8XV9j$v3)O8eV6EM`
zFH8B8)Op%%;d`j4m9DmJjj%F*9&bP#CVB=1*0q)};EOMrpA-NKZv4;L2M-=tcbLY<
z{$u>vhbgG<vyWmBr?kydApEc5nyU2Pb3Qu*dWu~YVO(8~z3yyP00|ubpy`ExUKF$3
z{!@1@bd1^;0}k&N;$&OKVS`_bk6nwq<JOA?mt|D*7#I|w;RY)4zkhq~(`6)sfGkGU
z(PGy604l0D-BWBZTK`(myfvBUvtmHE^GGCHMM84&iPVy%@zL%=N09N-h)ePi+E2a}
z)i3kSrtD{&1ku-6k~Fi$EnEb5DctgaoD_8;ORFpD(7A_Yz>@o)De*r7s0%(8e(g|Z
zi|X8|R&@}D9rG13<cynXhdVF$2PmpeK=aGr7-fBZb$)q|2Cku@u{;KlslGb53t`9=
z9@NQ@j8uTEmIcww0fSTt7*_+@U2$EZuz=VDc|8Dc`XX^k-~CpKD`hHyByv+vb;T1J
zwz8qh&c9~Lai)pNr~;V9QcGH#yWZ{Fx3!)69wamzAg1xTW-gtae|s?)stJqLLRn>=
zx?T{mJUW>COlKYKSzW_Ydy)nw)~R7-Sbi?^qs;M<4w@ay7lV1q;c3kkj@>+$FFc4D
z-?9Jn(Mw87LjPO^I91gLQM%4U&;9M)2iSWnw@BFo9Un4ran?!AT{i3CaO`466YHz<
zI`QFj3$-z%<ll@`0rxQ_LHqG$ggARRNa_?fcWbH+J75ccb#~3O>WvaigUxT?=>Sck
z{)Wo9yZFWIdJz(0TwS=(?<X{jULr$Vtg9IO65KRQ2s+RPL=zi?+<~6X3<JgMH*dzB
zjR{cPQv`Q6m3WRd#+n|U65e@`)4ur%-&71}0e9|SPb-@J>Oauz)cxK}tY820v`LD^
zp>_cCkNadmLMqa*COg73cb*$QudJ-BIT=vbat_L@3}l6iTGg7`eSnNj+A2qGsxM-$
z<?fX35VGqyOlRwytE&CiWASfO`AFm5PXg+C7w1MQV8MmheWCL$xhSFk9HRe^LHVx}
zC;VYC-KmZSQE>U?sUv8;?{7)wyL9PN*mlcE`&JFMx&03bnE|)RQ-#wCz@_n?D@!CL
zt<>8mGj8un(gnWLS^z#{1K?XT)k1Y|{}Y_DgF$%bH{qNVc>iPNFE?pV4xJ0z{<wwl
zFZLuR5f)Zf#fuj&cDTYgREm*;I&Kf&0W&r}#R|~s6A0}J=~7VlN~=q;T>+1@IDFBI
zf1WG1r{6x;VW*{-BRNyHTWFY1w@3^$5B=H*aS)A9Ma+y8O{Ff~$~B0@*?j=-zk?GW
z?uKmQEdv9*|06abqq5nds;sC^+;hJCPPRaqrP1U$c0F%^g8vm;eO|S<em#qkB}^EW
zU-Fp{NV90JyajC08iM32#^R%+gqK@DYZ8zBLdgu6YOP-)5ru{WKp7aBPUW&rvkpDM
z-48hKqYE7E{=>QUZRxi)6fY!)@O@}+JZjti>GBRmN2s50tx>_<b?CX8e*LR68MY&}
z*|x7&7le~D`b-|~@b+O=W)x!o%Ay|7w%4s%<S#?5qSYm$X%ip`TQs?hpSv62?T=Iq
zq)OtT(0$CnXiQM;zGLYrph~dS$xtnlwcnot^}O*A)zDEA_yy9-*yh*+pJ;gE#Nm6V
zuuK2c@2Vo4AG357IUMOj_G&$~z9woUK;;++Gfzd%4G`_k3D*ojgS`T}A;|5o&fUsm
zElFxw(KxGHi5~Kqz$--uigP!AwV8p?&^y(~`S@^iOPRkN)cRd>GOyPIme1zo{ahi2
zRWHuV55Ef{RSEa#k*bPkzaBT8Q<WHd%aS*;Fc4%lTO9biL#vf)v9`i_i?5rQr0V-;
z=&BYdS7^47_Ee}a>F*0>k#Cc#tTfN%&|MIhs&h&Tka1!K+!M+hxPaTlN7!6KdXDRI
zt_Y>G$|1^b@F?;hz^C1*dTrg;pp6pY*yAi{(Uu+xJi4`E3p=tSkSYi3yky^LlfSd7
zjJ8d;m{<AU=6mpTe<Ih`>2q95f8$;G0zBF{fsU%JIGnlfNv)O19q)uW&!?=03g{G^
zCfWojMrs$>ng09Yh0(7h6{(prmeN8Yiu=H10s**-NLrHPbk9uX;UI{al41tD?Yeyd
z=^03K%rva(hf4HTP4Dc$_7F5{ewREgEJY)v=|!uz@e}6K($i1!D2MGqnhs*<CNmwG
zPBZ;Sk018~E|Ft?`qSGxlAL@2mDu@tz3#eQIrtV{X-&{^EU%4}G-!%bo>`u&tFWz;
zCfvC&2F6MtEOaBn`@4Og#3r+wI<D6to8hH#)WvW|Sf)nz+ch)6VP#xhC35MO;un@D
z=KL4X%|-+Qi0+$&beo~C{?0o#`IncMBPEOFVG_&{WCOhA>pfZ4^4+OAT2>bEOXFWZ
z!Hywl6bc)+f5J`fh-vY$r~?j*>^{IlE}v-65~{6p0fi*+`Ej+}ed#qkor{0N!W+N`
zC~f;wC0rz>Y14f$|0<VUwQ|gEB(+`xEy1zdUacAIxsDw3f#+(vrsR%OhF|{;J#Bh5
zspN3yyEn=!wa5SZtD{I2q^YL+4$Q|hdKvJav1P$f@B%DkMPOvwHeZe)T?6SIT~LFS
ztqS-EKkTdaiGr}-)z9BydQTc}NoptI+R|UQbO!TH%yrq;3BO;C5VyTb<I~K3*K#|?
z;_zk>R&^Bln?<Z*IjEg^=VB72iBWdpWA+#_2yiatkN28Z5Z?x?TypgU7Lh<e16B?f
zi7l4BQ~5+BAfM16V$~CIMNRQ95CBju6c6%`t`}PM6eag&K*d9m6ewY`$TpXXgot~m
z(|kp3eX}za)Vw@XcTjZzV*OQfjv;8E)-}R}J0}Q@i;+oj<SU<FS(pox+ATh|<OWJ$
zYHa=f^<|R%?#&x+BmjheZ32O|Pr}ZGt_n@#dP}6^?Tv-t_5RLaPb(K&?o&^qED_U;
zb<{vOftoK5|Flxr8H?b^I3y?aydMiPDX!82U_+J61XyL8=^3%le4nY{sw=PnGsZ8b
z(s0`ls8TUs>TV#<!S;Pm+1?_1xG9dy?K{vaCQ#xpT*1s1E1(=xV_cBz>Ourr)!yDd
ziEL~xymM*?r&PWUF-bO$g-`Qe(n^1SfBp)&Q>ZpW`>a{JhirSG4rn1A^RVKx_(S~S
zJ~_94DpdaMyUmUTq+sSuXX<Ey*cvFBtF79?EOLNNNG*VJWu>H=#RkcwaI%hk)8U6k
z?9XR_p_|N6u(dLXL5zd*k|%&mRwhttwsId>a>yP8Srm5Q#>q}!vvviF`NXGf0++WH
z-T+H_ubTE#=0E-dBOm(MY?mw7F%Trn3HG6Ccph+nWPc(Ci&&8ucyD4rE5yB25-2`x
zuCwEuGEybkt%?K<-V1mxR;6^r!_1&!F4@jV3V;&&cCr&0aA4U-HA(QQM1%@XBXhq%
z03XB^oiPCl>I=c?51W`SgZ_BIV%cNBpj+&NLm9K;U^ZXPZ^SV6j8kd>1X_Zsd!jNi
z0X8mDi5~7?XNge=c#KpFSlnUSB{Qp)EMB+?;1;zBFYu+&({3Y@8X@MEZ>wCOBb8!S
z+^2#ZS44Dx^(ORwDX=HLNls2KuQ$gW5Fn#eCJVt!ChCkc)ppcUm@;>oG#Q<5QdNEM
z0DKV!%L_BOoq7rr5{m4!7bDd#cf*#iQYS-!9Mk`f_WK06aW2S!M^-GDiDv(n0IW4~
zsUX`0*A8m#$UI1|316@?Lr)oALbf*YhzWma5__knt{%$lhE%n`M)TbkXHg4oV@i6L
zwjF)}H5<Aedn3v3&v<V(y#EZ^XGS6gJs+nW&H~k#YPJZ&U4v4Yy60GR?5^O8fO{fO
zi~(pOf*#8Y5#H*|g$moMZ+fnjAa&eK?{rTdQX={uuo@+2fv4-stD8t|V(t!;9L8;R
z7jAXhQ<`gX;B2)B_Z|Ms-_G!YXcIE3_Jv&(>%opnH6oRjE!s*--(X<OSLa^Q@zi{7
zFr9*bCmD8DfM?MV^$#YT3ntC%l!-WKx9HWHCv&YsMYvIQj{wuAI5d@4V;n%IH?puQ
zOWoCn%yu<x>+|E<Rk_**#?kH$co$?r(n;Ej7H_s`)0?6qDO`K7ibR5P#fi?`DKLM4
zl6wa#g6Iy8oN1f(hjGoc7p#1mdthe^-u`so-w^c2{`zxFxH(L}U>F>qMrTKqV1A7M
zdPz4SSp?>E3g^=#@Mi&JN|VA$BCNkFF$%GKqQD6wT6KWEBae}SNeXy0Yrz)uzolop
zE}-$t7Ni_|9lkF)Q?MbR+Q_w2|GAEA(0wy$9`kvvW|r(|%C5z$)P#B>^ZH1LHh2JF
znlwINMOGk~7KYVzxpm>1BKid1(16d@N-s{Bws=@c&FY!U^tOS<XaIywS=GKqwOaVz
zryRALM2$^wkC>DMg)rLxmeptb^YSM&vyT!-ok;tm%->sDf&GYo-?osSJCw)%bfx22
zlD6l-ZeA6C@ag0_r5Z|d*%rqsuero-T49mVa^`GnsTN*5$hNR7T_NB6tqIZa9wTSv
zv2Q}43*-a9TbPbf<&#55dAP$dlM3npvi)t{k)<Ad`#rMdz$&!ae=P0o+qX4+AD0TM
zs;aaO3{8L;Q|<h3Ch|Ih$y^&V{~U5y!Fv?m{Seq};*GhifH$nnY_E&o7A+2kvr%73
zgD>*mCTk0j%qPqd{%U9Ms)Jv&ET{*XQh3rY<=SLwgCZA%4hVsyVNql$9u6~qlbxMi
zZV#&q4+eEh;*}$vyE*;aNbFWpW~K%}Z!5L*X{6s+hr<lYti>GM${YLPDxPRBaGd5u
z9!PDsnQ|x!(uHiV)+?XE+#5)OA~Ofv=NlS|U8idP25apxl)1rwda!Na3vaYPu)y<W
zsR!%8<I_JFtZM1tP9jBu^Lhq&VHqe^rxX}~&G<FMC>r~B5Y)kw3#|Jv7!s;wkM|x&
z!qv1h%v||BGU8EoHTW|J-j75n;V59d^n-#Lbo=we^I*mgcyle^QZPBL6`JW0iBu0X
z{YG_B97IBzYD(VfK90K|eh~x%9*IvsVNUQ}X>2lJ<aD~#Is~S3r2V2Ql$Oy55r8~R
z^^$~L`byJ7Z~98$+zR^BnN#AcL$zy7*2n;zY5|P&FhOpe;wt{a6DqPR^G0<akv0Hx
ztpD}jW2PfLpr;u?Es=zwsRCju+O$xF$~ysvWKCAB#PL9}e&6dSGiCO;!p>8Ky(tg;
zRRz!<nhOx2QSTAo7_N(sUYcwU@@N-J7By{ryHCVI9r==SEOMu1Ru=}EWWp!g_QJI4
zICk$v+-M})QwFL4%_I|EAWuYWh;GO52g`FI+BO#tfQf58T}+9?5n+dL@J2c5&l3qy
z-~;EGr{F&7GW7NN%tTfleGI_AufPW9jkLQO;ne?Va%U>W8?y1e#h`Ca^XjZcAnT|i
zCFABz<bV&pm-`T%2!O;io#R2`?hmAbs1VIBy5lBuK%n~iIxue5x(X)_o-~SQ@3G#d
zE7a^HbZ&#r0EE$@1<Scu+zs%j0(213>Rn7NNqVRdmPZUQ85aQ4(eiM_t>FAYz#l#d
zXqL}*u3$+UUgRHE67H(HdfTzrp@EvliVwmhBtJAabQTv9x}V#XZE<+t!SV5<%f$zb
zlEgwkKR?G#k;%Z`hrL)u_9t(DdZgDB(6xBRwQumx|KvcgS$Yg37ekvQ98Tb2Ei?^-
zdU_mid^+xY`vAx3ScCO%O40oHsuo}#vh~-zG61C3wI<fCc?DvDrR%rA+1LNeF`--t
zrR-X%uK{gnUW}}#qDn7S32nC-te=^zz36|>EC2Tdciox3wj};1Tj2lYO#4-ptNY~i
zk76Zcv2`m*E<{ahPBwu6VW&S}m&q883v^8`ByWgf6{joUGBdOuulRojdZjFS67^Re
z1|*E}8n2#OPy5+$sBC9?ZJL_q3vgKDkZ7gkQ7EPBj=Qm*Z6nveP6sc3;-mPez;Y!I
z2r$$up6C~w{|4@=e#X4s-8s|6A^%Mbmr_UeVn8VQ!(oX29jpY=@IAQyaTPyALfR8W
z%NAL6`Pb^Xe$d5YhG9UXHjwc&w(u3gH9#<3n}@hu%dmw>kVh6D4hi-ZSV2Tgxt7+0
zwTi@TNh{q@wut7@cz$i722n7o_1wQ)_^&PI+}!kxsLsJhGpa|pE^1klyGHc;YryyH
z>rQUxmGQ)nfv+Zt{Wscori)f<%x5h!i6K423F1N9R>@olIPX<Uk8}K~o29EXeNtFX
zhFkg9=4FU{<`h+4b_jm`0pc$FI;ZkQ0phS54%GgXa;fZ_dCjzHfMR==Tl%~i@rp86
z51<%YyJ-lSv_aiHIE^tLIZkR*Aq_CsXRe=6pSMZYDm{d5kSKd~&j%mNs<#UQ0^XJz
zn)kX2OhvC=ST_6k2@Z%M^K}!0^1^o?*#nB(Irq_)+WV~MpFkKQ{cLRZAr{Ow_*%A@
z+B@@EG7dlSzU~MV4w5T;&YAAHht$Tqd8e3|jO6m*!iX+4*Hk(y+L@naWoc-kN^ksG
z&z}t6(sFU0k^`?5QJAB7iHD&I6Nc0pw#Js7jhco<`=1>z;q**Rc;xG=TkL`_Js^5Q
z#&LKIH)Vms$?7#w>}X<(d4GuQaCuYKNbGR*-7Z1FvBH61etNuF!D;M-r1J2N&)!^1
z^*;K|#y%D0tnSBtU+n|ZqsX>b=dEzvEWMEnE9&oElp&ALWp?XKq?JxE7JFE4hy|R;
zMWGqX|JHwepiWpAf~Y@*IuKGC(xxGb6$SCto9(t*JyRV;)rK5GG1A-6yWOH|=^X_>
z#9+N(iR27*W+W_Zp~7=nk**iMQVNG#A^$B9sz0KsR?~xsx{J^xL;aDpcXK+Ca&BbU
zkisBmZMemNo($&2Z`JQuy4Q!(?QbX*?$`+S27Pi0{#+aLCMFqeh^az1L^v(iV_SH1
zmmZfZRGYWxUG)iFsfH?2biG^$%SvFdv-WhMlp4%D>s64KZx=VlLbT+3#7Bc;uef|z
z1t^43Lg`wu^idmZ1Hba4mM4pYhLNPE8beRQaURKktq9>4G_5=tEDZHk6&AkX#h>b$
zHwB?rs$7c~u&8Of{KHIK5VXB_uU0TWJsz^)!1}=!3UDQTY20)*jg~$Ti4DPve?1l$
zNYrKk+S*&)QjM9LSY)nT$a;7*q9FSGKgo5h35NfTL;Byyte<O=z9{}TR_*^wL30JX
zI&v}z2?+s-<Kqi+(dMAHC}X_ugRXuJjjAIrkK#tVjP))Q954ySVtTRIMiAZ3@tKJd
zX6EJtld==O;3((S*_mB+Jne)ZuCqr4!+4NrL$R++9_c4#mKr=CPjwd@(NWR;5!N~S
z)y&Mypgk$A+`l6F@sU!UsI_zsogT%<egnxuGVFR{Beqx6)#+6O>yH4&1{_-m_`b{<
zcG_|Zt+@K3h-HC_3N`$)9uxNzWCr4(5CcbEx1ey;O3QNgV)^;=)@>ioJ)?_0ui{Gf
z(llR)AH_o^#NP*G7Si8V-4kgq8VYF3H&wzfXVvZBt5>M+AHVHC403@z9R+-;k$2B2
zn527_$~5HFfmCC}ks)aVf{W{K`zTxq;>5@$$NR37vAG@%cG`^?hNW>3KuG3(R1zrt
zgWyIiOc?v<v%|N}ZRwquWt*Vo-$?gK@01p{z1d~k>phd;EyI@Q;d!-jNUpHCwH1#t
zNdjHtV*m31g|7Ncl|q(Hm*;O#(N}79P@un+t2;Q1)2+=*jOhPV@O!;?%&QNhJ$AVG
z00~}hZk}GdbKAuRudR130pgtbtd?bltKIoMR_7<0mkX_;4{TzR78{$T%V9aSEd8PJ
z>rQu3()mYIN4&DAF1Qi{*HZUP;{W;QA2G<^?w{(kdc+vt%?4zhQ86^szB{w`ipGsd
zq>H9kgss-cBz*sdQesr4$#=W#21rN^#j>=$_+zy4EE^y<Cx5xouRo!JGY}EP*SD%d
z7eWJ5RSJsuFM6f#1so|3NT=c9=0?dWsEr2m-l(;zz)wO@zR}cb!@s2uw<Pr!?k<f+
zN<q4!%kme!vK6LPF>dbEVlxX!S`&MH2Ca`*RmYDW^?lUK!DZ}!0QBvFQlVq8=z{r^
zK=xWZIF{GV##|WHOrhtU(p80n(|bvy%#JjZOY-t37AI$&#)j1BIt%%zuy9VoQ<TAK
z3A#i2TAs(~Nr><AQxaG$g~3HT#b^FySu#X^t27RZfNeIA6(u;K>>Xh}n&w)f%!Ke`
zmw8`$CO!Am`{|EJhI>hWO%|V{E6_5W54WSv55}U5GDo}~SO6%W2ZG6Yb*_Re4~<!B
zU{v%VH=_)_^)_!nJUC#b!|Q?{!ov$mk@og8dO`n!%Ar<jb8+o9yD&gk@W)86_5!dM
zB0zIE37(2^wEIB^SrnoPuf@WWC4T$uxBakEUp>w11uUIw8hg=xqUQ_JJtA`P60rWj
z+Ayz$w3o4~FyimzPR|R){6~)h%RpoBDt?A~b0H7nu#r*m?a*47b^Vyk;-gKFIQGRV
zL{V88*EnRy_MiLWh!1gdUscVcr!Cx~n75%M8F>is^n}n?6g`c35xi8?nqw5fT!HnT
zn3xpIA78cWVD(4XH$Xx~Cebd4u7^_RSK+2{Qf)y2oy27+F77ya`2%*}c(Kd?hFf`~
zoyMiUzG(k9#-bje#~2`=q;$pStrGOV%=wcDx|E*hLg}Wd6x`>Jp@#$C$%3@Jh1nx&
zadBy|<mfA+s)KK;#L;DWd92+tyu|$yvZlr|LA{%?C*22KmYB*JVyD58$>-YC>np8{
z!{M}@#t3hq90q`RaETn`@o;pbCwMiYH!?6>olQtd&hgM*ZE{*@sJPk$$Q2xiqEnL=
zv-xy%24uFNJS<7el@b|%5dH=9&Ra}Zw6xfXq85)4j~f>@zc#0*lL3wIWOup%tmp6>
zy<V9H<I*6iqIHyu$Lgo-@82Lx6W0<zU79nYc3M@SaQt!ERl&&>RW5t^<pJ4M1Gm}T
zjPk(hA~SdFFn{M{ZeBD)6$K7h8svGxg=Pz;>;eKX0TyvH#j#~vIAdip4?I!C&iL*f
z>~LO}ajQXzZLagGL8?7vc~o%#l8enK1<}!^=}qGg1Fu3}l~&J!yG2LQk;$-ngJ}2u
zSDR#Er+PE)n8-H&BQgnaVR*D1Z)n?h=fPW%v?!*~)KFsNI-HVg4&*8zOT-B`G;Tya
zIFDWfQTwI_)z|z&mPPoaoK{C|wOa5!*R}MDrDK`SYIU$nCNZ6rAITjedVh%OkD*<E
zR!I>l;$In4osL_@k9j}gf>@+}S*y@pz>OenLd3G;k6^2nr*gaub_n|9f;!Be)J(HL
zqh*`X97^PaY=^iw#2nmKt3B<5`GYLFvc*drt0oi1b_2lG2y@QO6y4p9T|#`&R^x=t
zj=I<VZ{Fn3_iyXZe_dgB;h;SbZ^lor_98WKc)N^+T!cNoa-Y-aNAbvt_SSA-F8Nfl
zR>utrN{Q*5CUHhM7|)M;^{V9-_(2{hFO#x4!6nbKvnRp+oGT9Ajo3Zko^JKe6a<8F
zSVdYqkln$beNm?xWtWZw$%v9@rvORH;ehqRt9>?ueLv_KNuEC==3bW2VLDq0IYI+V
z?3S05nV?H<850o^GKG-b>NLn3RGz7(XYTMG@4ia`c+pN`)iWhmgL7z6ZWCD0FI+lk
zC$Hr(P{Ku$$O2lICG%Ewwoqac3pAn1uc4#tvIjADa;9r;E_{U=$8^>M5|XX7t;fz=
z6N;M->l1pzyqP3UDg+!ra9j1UVD-uUV<aOjNn+}5b%E^wKrmc>?5VW4olDNIa&tvW
z>{rT~?EsCWKP=5NrMwQ2poHe#skMEl(KRSc(OWn~Ug+V=tJoW&+dLe8;zmo$OpR4<
z{rLVD#Y>ur8GVpjZPC>99nCcSHd)XRf}8(XdlMc_x|wE5*v$YKjjNVv>^5kV(FDh+
zd?Gv|xxm-*i9KVe)1CIp<Ky%$-Y-j?|Fsz9P##w+j*^%n^xkbs#h0Nx(*5+EJt2%1
zgPIOyQp7#Cgz3{_OkIum9eh+0<Pnv4)GRdHL7MR8<*5Z0**wH&f-d%&+j8AsntNC5
zzN<uZ$OmU;mCSTGH%CAjpbKH8z1NA^RWd)@FXEXi-I~0j1JpmEo=>H!$nhf`Emv~t
z%i_IZ(th%pws2amw5;dt<>BYC%ndn92mSYpbKgwU2$z_0?3R??*;eZ5<DdIGgDXlq
zyHE+Pgv^JG#AuJ^Bti+|9UxDL=B@bX)p^V1!Hnqh@cxcjG(cVV;KO=d4i(a-6=cbQ
zG~CQZ9klx<P45Ln(o@nidMjjEtd>`6ob1aJ{paF)bSNr8qQ`q4Bk7sqa#meQ7%}wC
zoGuqY^Q6rLDYxEjvF{B;`9p>yZmBJ*N5h3(EyL?*u-_x1Z?-kCoN!5~5zQGNAMYR2
zt5tq$X;O<<4j+JAb&FZeYmiUxvqS1n7l_qCtz|$ukOn)~bb+HwvTl}0>f#c?fqHFQ
zu!!qaR)TxubITq@c{k(b(u$WOQPE+mh~$)`8T9Frvkd#4DL0qt>`J8yENk45tg>uw
zo=Q}+exa7qFU_swGYcdu-AABj^p4AH$?NfO3?@!Oe*OGpmR@3UM#BEo(!Mw`gF)Y$
zlzZT<Vz4mxN>5EqEpL#OtU4^~e8RF|W=X_zl{aYR#M6S;;v6lEeQ0$*Ptvs_2_NIC
zb|)`hKUkPVI<t?`lJ@pDMcy7aC8^mD(yrZtzj_5C<9_SA#MIjSF-;gV^y^>yw^2*Z
zputtT7!0D8f>oq?j>_sZ!)|V}bU+9Je4JHr|G1*f>Pf@5jb`;$Wc8d#NJ#->Ko%b?
z>nU+qj4~H*tVrUbh0fKy;R>OhCI(EKr|oBtmKgo8Fe>}}PRi}I4J;(n+4}HZyk|R^
zp%38cI_KX9euroC5;C~;3BjAf3&elFXgXeC2S`cQt!#(Gi+GTZ3z$*dQL95;*>eS}
z1#K;sxAGK$r-nxj7sMY0r4431ydcV|D;o;wl%7<P@=#v`xs%gPf^I$%jhAgs1N@}b
zxrbXdy#EfM9(1EI=Edh+ky;)#fb4pPm}R>wT6s8C^PoCl`L@3_=aSE;lgG^k`wD|?
zcIKcx;5PlDQ)oC^7E-Ur$_BzMtdbK`12wWnjONdn;JAEUQ08+ur^kVeBtF?=Rl4qc
zu$KUA@l{K7cfM(s%$5o3umb*}M#kGyS#`$u2Sb37xRHpo5`y%vc{wrfr!FEP(vgIZ
z1BhqH1pMc`z!<<B;pS0#vR83K=FsuRIK;fCxRk#fV`u~I*lF;dE5d$i9F|@99&^!(
z1vmd$a_VCE>enNzB86@@?Co2h)B?8%0J-l0yCv@ndpl@pNJ+L{jAbp~LGVNg`HelE
zw?F#LEH6LcYb^qH?H@jkboOuAk^=xLbsjR>MKsRA-*}XwJ?k@FwXo{L<$fX;#794c
z0-KOj09pyK!mc=X+J|$pD#ez|;p5u_N)5&`)jG4I^p<T@#_b2(w_L1r(D@6p?Gc^`
zf9d=iqqMEiof*)l(V#9;af%ZKJSm#RJYzMTIAl?c{n0TwXS{0OVL#SG<$7FzR5Q9G
z*sF+4>@9l6^6cHT_mirlX0SBrgH+Hm`Ydv>;01m~vBYh4)F>nkR{EA#3KPGNWydjn
z;uGx+ZSW|bXd&nu#oW3r0{8>9TbNit;f9(=kAMX?S-2X2`l3ue;{+rTC!H~ITg?;R
zvQVkI+8Xr6y3^Pgr3^OZE)q(eW0i?7g(&Zv&E0pk?Y>jUp93#|O!G`~S|=!oCv;~!
z--=r0eHmKHi<h(<6$E`ujuCu#UcVw{YTBeHMzOsD8fR_vG$`iFooc1eM5aM6P(bV2
zJTWoVk}wjU3H)3|!^*h507tbf{*n%}lg%p~32Tt0?tzsD^`XBrNwh|5?$;vZ?nZ_P
zz9w_J+r~8u!Y`Bykm|0;nIC^6<`&DEp@Od&(f*X~PMu&yun1-aeKix>kjWb_eSS_T
zS|+iDXp+JyO@4$nRG7!?h-#h-M@~+T>EWA!fJ4D?RSOms*!hm*<Y||sI~5*i7lst~
zwX+erVRm>Z)>neuB@87Ilbub|i4?IyR^mNZ&*sGVM(Dx}VRPmD!)(c^m$`(l<?ihF
z0}5QpNlBfPo=w~i!gy_$ncot|mUtQHlgtnq-=C6V+H_df)hvm6P}`MM8e8KE^D=4H
zNvxLH64{;F-awkFmDx?-xvI5>^B-N~q@M^bX}e#D7k1x82TS?Z!(}*s28rF8+_6?*
zC3&gQp(1G|#eyNbEQ$dDV|D4}JQ+_5oiApQ?Sw2*gwd8Tmiw!Txw(1Mk|+402XCgu
z@a-qFIZZr@*IZeIfo3-x4q{(=xii7sasJFZtKF0S_73GD<F#!gkr_d@i?wKKvWblV
z2vOE88`hX8vjrJ`!1AN5l?zDZ!otBBoF9RZJeh8Pgw%;FGX<{uvrq;zua$ve@eMK>
zKJ=IXdPifN&jEY+Bm#ZUmcyR)kzIa0N`MMotgPn&&jfD+Dcl@M>|NXQhlzTAU<00q
z8ChNuO)D#=$o}i_ITqXzVDz8s_l0y>W^X3*mYQ$i!ckBE9;;q#gtO?GRnQbm^5{Mn
zBrc)C)lh(ctc~l=l|Jm|(9>=#?0oKhVu8d9K0W4AXG7Cg7e+8VWah?V`kRAQs|&0o
z&wh@tJ3q1ieL^hGLVE;Q4c>O~2pB>P7v;}f$F(TWJw(Q<Cv{w{zbZugr3md&yazL&
zxbYH=Jx&cg^2d8m`_m{lBaiPWr4bDTRN3Dr7c2#V&eYj2LnG8hy)auqs3-%Cel)8j
zvrrJ|<MyEJY!@H*MKg-)2uiW8Za8-}MwH)`loOGg^BS+Z-6Fq4dp%uP(PLI!bCbg7
z73A6J*OPVCR1wu<*E2@=7vm(PuXw1g<O~BkOr9B4)UxA%?XXNpt5-uk@=PEU6fxMk
zDH2?;p!KWROM?hEQv(5%f}W}j8ae!Gj5P8xaOWtsXxz}@pj>u6NNU$6U(?aif%BrP
z$r{wcwpskN5LppAj=)^38y{8V{pHKf40XG$492WNDnJZ2rZOR(`@mK<q~M`_tGxx_
z(6ABiBg%EmyQ9T3?O!S~8Fn2w#`2JWrzuG|j;|siC0Z-TMLCf<1E`iT(Ag~B+-!`j
zxXI%1_^uZs-QV+C+K^IC5;h+YO*;{wrk4CwjK`aaeV1{h;Hmi1$sOj8+k{V90?$h*
z&Dy~p$pwZ2UfdOsa2i)>{lIk1NLGK))tbuguQ$@-mAP!^pTKr_rx=t^PRxKai!`g~
zqY$6ck=mP&OE2Mg4GOA(s?_sVqn0R{EhM5vqH?J;&f>jEm*t)YH_%F52%vE)bn2{>
z?6V&K64}An=i}HFEYjUL>K(AjhZ%IyY@WAGf5X~tmDy4!EnE6UW(xrH`6avW>c|X2
zGBQc;{hz4?Q=JLUq!D8!qU2<A@YTtBffG)G_?*ldTM)1Dy3@5XTM#5ki}5Wua=daw
zr#n$bTq&eDOvD|=7G@D-bxDzO#w4*gv(Gi4u5&539SQvOQ3Bh@ZFws7ATlvM=Ds#&
z%WP3RAafMd%)6SAJ31dS$&7y3*K)AFqj@QW-&NQn&(b|vo8;mH55q*D35Q-IhJ_5f
z$!v3V`7#jXhT5{U$s|3~YkFBrKJ)RUGe<jkSLde+Q*`wPO1Hj05N{D(HRPC%uzP^z
z($%OOrn9-W?{q)+st(9J27Tr9GR`omutZPC7-ZAb;-cwFl+Bp;cSyjuUvl2Uu!v$W
z{-|Hz>Pbt}=!^?*f8TZg9n+^~>g;0709dSlu<9=5B#V|Hg9W7CBa}kF?nO`${eUn<
zG`E}xU$U14g~<9dsTUzf_1var!}douMmEljUp)`RPpH!zp9bYjv0+*X3sQ1CX4~oz
zz@$Xc$JaAWBhcona(4Cr#pL54=re6)2&odt52qqF)s{U+S1;jWi1h?8S0T$iNSku#
ze!>O@C1SfZJzZaikx37GA;AD3vXaE3uYp?tAVz5{2PfWLS++r5L4-y%ZZy(m99=h-
zr=8ZfdsE#$ac+pv)grCDkDvnV039s{2~%X^#j&SZk@2Pj#A-GE_a|kRUo(~8pH}(W
zA+~EKkNEMQ^QE<8lpC;hdzZ;O*hC+(Lseg-ZKMSiOU2tFBoOly)FddW@wJP{zCaAj
z%$&xHbCq>(X12a?+TB((q~kag*aY?2yoHnj&wTY<%HrAd7C|6@wKssYb>xdw*=ngM
z52nyOZ{g7Fo~B`hh!X)s7+t9=?neT+h7i)q8Si3MvUsyLx{BqU`MVi$yHC~?asMon
za!XenAR$(&G=ZUSZjKdCv3y_LKAA`h7Xg3+>&X^c>%?Mxew;wGtVH4)iI~@U#}MOq
z8oi=*&JZjw#EL{jPh)X}DRYfgkkh=Y15meG`%kqm9c*@g#}7y1l&stxB2(V=S0&FE
zqksZrp!iLOk#H6SU15><C0j(Q5YNf+os-__V9;Ktc6;`md|kuzyX7U|c_7DLbWHB2
zobfeT{8+(fnh5JST@n4@YV1lqc);fS8Qi#cJ<K9(E%4=9-Y9+Xa5AnCtbSlZrtZ4{
zM5yzQx==VH=aTg}2|+4d{GzByTEW3;kDMWhxLO*Sr}=Xhep2Pjso__jCq{VaDU)`a
zB;V$`uOv`%FrIkX9Jb5OSx&e5do`)0XaR!_T+`aqN*oBP^6aqSx{uUXWKF0{de=Ms
zSra(weHUaaBtTn3r5f9A*lzNJt&VBJ?yQ=fjJH9BIrSex%9!`xv`({R&?{`l)S9nz
z-N(DHgf-@aw}P0~z#vz~_zbet$O_Sm^H)rpC_S{l0nKFc#dK;y!lSLdk^hIiw|<MV
zZM%lYKu}T<r9s6+N=jNp1yn$#TLh&$hDM|;LX?si6%^_21_41}l#m!2VdxrQh#7eI
zQ}6qEpY8kpf$xWp%?-USU^wSI_E>A}>p0GLU2@e3<iESQm;&_6&M6LHM5#xsEnhGt
zTg7g0{5YIdg8uF%?m8ihqy2?^aR-zFptK#9TsP*+VQcZ7Y}onGTUhZs7=-UcG4f}D
z1l+heYY36QYV#Q#%dd+#b;=SD+)h~Y^Ix(;Psrc+HW_1dTp>)lQZp2_E*>)b*t*Z6
z6_JFbc9AnSDoQ?z-b(Ovnq3F?!4#=1G+rz<=w}$4=iQ8IM4ii$B%*!r(WNA7?ULCN
zJ^dZI`@3D3BKKsON4-mPbG@(a-N@@TD_{1zL%!<vdXZ_x8-Y^ClXs_BDOhue2$@8<
zAfC*Smtj&cPZHug#Kl&QyxHbSIa@bOckfVl=uU7E@*qe!aiqN8+Cv|aVkW$;W-fjy
z+kDh7;W)n1aLhw*aH9lnL|L2~HcY_S>G50f;Q|jpf_%G%wxQcKb$mmm_7))bk=KcZ
z5_l}K#RGXg%_33X{1qs`uHVJ}g?$_%d>76j0RZ$2jU(cZ)xX%(m%4e!hXIje4g4BZ
zbaA2uMYOkWAcSvX>SBqj5?3IsM*>8}{E@-JV*2_?(;UQXgIm;N(<|6OTXsP=&2Pj)
z`JXGC*$5`ihC<)IGL<!wo7VXL%mCNJ*B1I*fzO}Afp8_1SH)?57n#BBwQR28OMY71
z9CXrKXuW)_;hp{iO~b_B(TR6zqMC3+gJqZnVmV~k=C<gBzE9}3<CdDUReTm4bZ>7c
zCzQIe@g-YdWnCW8sg|N;sknBRL*5(gA$AS~dUuJI3`2pCNtM+TS1ZecE*eU_X}&Js
zS8faEDZhl67qt5GoLSWAMrshJ)OCH(fB-_3E_ddf9iaSJZG7K)r^knY6E95P>zp~$
z8PK0KbN&!&{t;|^Q>u+f4trj)n3(h)d6Y&=$?k<Fc&bVwXY}SSy`9>SMcH`gt4FmT
zDVybp1LC`ImX0hUGa=nkPstWhWo5cJEu6ZO;V_rhQb(lnI}W6szlkBsav~KAZnpal
zz0`OMMlP{<5ouL)lFN(>o<|-+9r3nrrFX7&9C6<{?Kbpb2TmYPx#h$=o2Q0=Ub8`(
zve|O`W*~ZfCTA{?XM-p#yC~;Ja{4Dh?S$Q$Mf>u<AT<}!Ob2M20M2!|pVps<7eMIP
zi-X>?9Dr}S+kYVK4S0`44*{s3TSEad)C1bAOSCtafD`@Hd!L5J7k>k2<?N|9kWhyG
zY;+P>ByuX*@NPp`LUjSO00g605|A$2A!%xcNaHDXkq83;yw`QT4rvWb<UOXCz4aG1
zd|P82#FUQD+jDox>kt1Um2}xjBAEg4E9$|w+4A~)r|$%0n&V94$#1E2k}xP$JDWDw
z7A@|}HB#>TXdoZ?j7U8yhiuP}Y$v~Fn?q_goRbzia2`2pPXgRA$n8vxpIis}o+N7E
zgS2|t9Utk_r;i-jRRiPfXT$h2r`Kgv41Yuez)4;dhO?OqI+)`mV-RgHD+>pxaF4f#
z8TX4d>Fv=nnMM&V8z2k|OYYxBb~nh*IX)nIaJ#Bj7dyEkn&0OR<Yq>1bYqc$CUSP=
z(W5M9NIh8l+hA{wUJ-XkDB=jK$oCWAdYY2m@ow5f8^~_VUhvzjPGD6s^7L>_-vz9_
zSzm^EMenz%uoABweM`P>uVp)~$xjX$QYPg5+pKqOj)qf2&~(`E?zV5!*Bgna^l=Y;
zxB`)RCh{`3aHGU8Btb+#%bff1`^yLv@y49XD%J;(TH?4YPdO!WT0?!dL5>#3t_FzZ
z9Bu)m*SEidW3%Y%Vbz3hX;eb>k}RaZK0ztz3o9z}S7y28p6qxnISat)m0PC_s>h37
z+magv@F^-7A*UOkd>BAWzpJP33*1?C!IGBf155zq7<9>oJfhjB^+G7X*+Wwaw@MR4
zrDSaS-pf)QJ<4cbeb%-d0?%=b!uanRWerI}8389-YD=|Js3`lJtd;c-(BDp6_P&@b
zQ&<Lg+jg4P5RMT?7@}1bfaxP5c0cxhuQN^{9Q=>Rdw3rpX+uwtJYA%QgutxAI&z2;
zV0(Na7p$=Gw$BZ-4f(HGWDFuC-^r-hEg#T`Ux2crH@{aTwapC&l#&W(s;cPg9Tmb~
z9N1WjksN_n;soHyhP1ueZ9|a3<>FRu%=U@R2mD;Nce(L|D=>UlU3tL8YnvMx&P>4I
zc*>=6SI!H~iP!L1@*|PYJWybXqtRr(!5u(-AfLA4`<3SdpALM|(m0;|=;oW3>*LR;
zE$R%*wD@{DUuqp^%DDNt^FfrR21Cdj+n=qMpVK@~d|iK5tAR`wQu!{?uX?2=;qI!Z
zET?S3TV>U1JkMM9>XD_L9S`%y^xB=SS@wh4cG(|q+gSEL+48PVxm-z)x>o!F+1D!e
z-5z(&OfxMiW27tUZBFlYxU8zB==D9hYP_tVqUr5hX|+Sjs;TO9AquH(yxs3w-inx1
zI^N8K@29R<jltr(NU0d%K`|53Rh2ktWr{^rf4>h>>~xbQwv28gv}x7Mc0Jh^9K^AK
zc)Zh0%X!ZG{uOUmamDw2abixAiL652U!yM@eH}MRWm~jgtW<r6#S6QX9xs(@nm;&V
zRDI@8v6<U57rCMg6EFQ(yfE77mi~IC5PTi3ODMOBw7?|9HL>nV+kDi3HaG8TqAJt+
z?9o0k^wZ!8!WPYe$7k^g9KCZ~c9TtPz8+bJ*5*u^mmT2u{>%wa@+KW^@G&+nZ(AKn
z-y<FJ>)6D-A1MyyulRF%NYdy1n9wU@!$&ivpSN4%&jizJ!W9Q&<MyM^%j~tO2NQ2(
zH8XDXecs+D<lKxOq@1$&w)`>J`N8O-*(NEU^|ZI!*ry2G6x_rE+v|tDhfAHDHAfdy
zMr5}mvV~o{1q=$Wj!TH=xXtX%(=I-Dl}x<kfbNt*k9^#ZZZ6fbD@b3Ax2M5P9jS=3
z0?%yl!hW=(O7(2b{*koKH^e`&k@w5(Hxh$)C~JyUQ-zm(1qmaZi$tRw@jq2M-5DW^
zWjk~YrU|O4P48ZJ7Wl=QZ{i}ZQyx6ClJmfG=#R4JZd|I!7qfS_Xt>f@#L1UtpQdd|
z6$()*{~Zkj0sek&S9!gTr1|234CSf8z7KwM*J0h@&U}h+%<ar?H_15LC`D;<x8*{6
zl570ft^mI;Uz#(+OV9P6?O>2t5vuW-r4L?Ea%O;Ao@_oPcl3(yBVTWYgW(xdWd=e4
z_88v{kMFiEnH@b@xvxy543yH-J!4ENa(}cad+pxn4j<uUQP;0}V%XN~UNsz%M{1gK
zk#se>=kU9d!RD$g2751Sxia#;W4rv<ubD?!0;=c2^bbso)!DMa!W!vqDmM6NXZvEE
zdPMe0cVTe?y*Xh4M8BA6d}lvMFjro7jK_1|WtLNgg%zFGe(><}h&1IGnO;0_sHAs}
zHZDNW>$fed`ju7()i&p^nOcnAt}XGWN`m48A|OJ1ccv9i;s30E{&8B%m&WM1e!8Dr
zEY@|IJ@Au}%!4bGCcP&sXmPs_&Atd@4->HRSBvyNn#k%x03q?t>9c9nKn^g*jY?3J
zm1WTog|YHfzBSEKlw+TR{6yM(A~W0lBE#A$By!9&44fH)X(ifo4Xfr}HTl8F#iAZD
z>OOpX9^=lFa-in-#IMYL;@luX;Mak0(ycjA<wd=SXRCzwe$RA$%6^FMKYKEWbYSl-
zAMW~MiRXgkkBmi%C8<&cX}!|(CkW|=d6J9m3+w1X#aVaAi}#LQIW&oxD=rUjnJ(5c
zUva-TxFbk^S)_YqVU-r=>N@hx`*nqSb1YH0XcRS?KWX1wStDU~)yBdp{c6+P>YeaF
z%K)j#GyOVxPx?5eEv^}0&5dmH-TP+lYm*_sk8H6&H~(CxgAtzkpu60Pu4}{4d+=*_
zx5m?joZ&gXz18t@8UIbBPuPT18jA_l+FP{RSfplCeO>4m(s0!6X&0${i^$<!ePoa$
z*>^*doo>jrIV*aALxAu!Y3Sp)*|ZhwcbaDQTqGQl>Ao<PO3jqFyww<8L<)>`{ifqK
zY@T83Rwax^)J(`ekb*+=>uoqzl*aBRb=skfb$1QOou+RR7FToqj2qlaxuyS#LGVc_
zOvjnQE?z>PS1T*;F<m_*;He3lv1ht3+T`KU$>An<M~po#9~G!t)%(sKXfYw6UlPUE
zw2;{$Pi5p@_9<WT;w!=T#9tZsG$AhM<x%;DVh^F#;49%A!PLre%`fzeZQ{Dcc*a{_
z#8CM9I<8m?E!oq(J)7||ndvdchL*%G9cK5~e{_`t!?HX4DYPM^U@>4lcmb}-psef^
z=0H&qr!JGV^vK|@Uif(%9sWV~&(zIfVWq|)4JPhtN}VxYR`tWZB%`Z2X73;)868Jf
z+T^KDF1{3{G=aMHey5hbVPWjV)JAs?%dRYWtjGfYCtJ!cuX`~#UrJ+8r)}wnv5}W+
zcitAM*w$rk&9c?GY`-&u^oc2tn~Y0;+sh(G_{TD*QK^OFw}|w(J)aX;_P}Z%Pqt!E
z3i#ws{CjL}tyuQpU@pg|FRyk@s&2tjFO#-fPZ{3$)5WeYb1hrcg}ce&Z0rvU9-Nvb
z5pF~Mv(kPrZDn|JkK}y^E4Q71VJT+Ry}uL`V<Z&l{K!==(0a+IV5zXsb2y5znXNcW
z%jRX%puY*-QV?OGgp!q1`KwT3@oGbH6jO&@p~ag{F<r-vxHJ3Z^jQoJFOCY#_MBPf
zyy`N2FS%H%^lbqo({J0!`%7FTaUF=6{pi%vB>Pp(z0c-*f@;`ZlO&{^_Zs;;Zfib>
z(Z5)|td@yoN$s*slk86$I&xsacXdV4Wn^B;)Qyu)FetkCrbUTIZu9L6U8F6h7Goo0
ztG;Tx)s(LREdIqrXhgBp+Ht=s?Rhmt2)JV9?WdUIk{@E|K0cDt(Y<L8rB!BY)1bX{
zM!S4I^3@})#L#ntqxUkGuGPRw6q(@IRl|4&Q1^MJhzg&m|8tTlXwiL-+T}0s;W8=l
zvPqE=R5z=<nkvIR68HwkbEkxSGEAN2q`b_!$vP|bcXF7Uj5FKh1+lKVl9YAqT35pN
z&em5x&-3`G$SdhO|8vysU_rh^s;;C4+gyK@{wQ8AT#+eC6Yh`n7yZ%2*zQYVc?T&`
z)D;Ofn>*p6VkZq8`LUDvB1s%@!Tis?=$>u)u&8aG*ZZ!PPG1y<=MJRSfX{6{4^`Xp
zaMd@fV0|xn_)e|(@P53TfpMN1HO{>DczNXzmWfLHa}WD8C)A&|JoD5pmi!Av9{a{`
z#1h{i_a~P3da&@L&3jdwgIo}WpD5h31hFvm2-CmZE?@fSnWK?m%8|q;dDkPyVr$OG
z4(8^`H`4&(K@K*48VVWX`DB-|9G2pF;-)WCRF9|6%$4@{J~jMt%hW1yVlq!gFC;)E
zzZ`TzRbuN~1fG5>ErU93%3SoPnGwgO2a|b9$7V{2Ti(GNxAO;$oKs_>tQ_-Vwa*kB
zD;Em+aBOBdeCoWMCC55(tlp4z!Ta_h!W<*tclG<akKMTrQa)z$(!2zDsdHF(;8JW-
zxn#r0i>O+iQv45l+^sEJ+;q2HkTOT%ciW!UTtn&kwZQuO#(w0S+>#xf;ppOVw8Irv
zg88$kx(hH#>hUpUe?EOw<ood-rPR%beCbZURB;)3QE5LOMfY*M$>G+DV8cfJ%~$KN
z+9Cslc*=4poqXubc*-}!hGhet6UVl2!ZloNOMlNuMT%X7!L9_=Zu*U1H{J&@*t=fO
z@K0lus!&Lhi-o?(Qd1x)X3mL!rQvZok}2ai^Az`=GK1(7_99#g6{O<mBy45h?A)Cg
zT{~+YQBf~ioYr;mshh8*5`I?KEeLYre>uuEMd2<jHuJ=H&4|37+_T-1I=ZA^fX0mZ
zFi8K#^|8~1-0qNgKo-<Pwal%vo`|CJHIT-hTw)Kragtlbh3<OF&By>ex6a|QI63NP
zC#C71?A{ghTMTlxDyfgf^gftQ_&6-%1x?C$c_$yzS$n5OwY9qa)q`fKJzjQ#Z09MB
zLFP7-E`Tth5cARkXCYuo;^s+GPei+8lw6ew=o^LyGGHrqgzeuxE1cSuCUiD=jU=pQ
zxp=_Y1;EoO-bX>OmRU2xPpn!CXB@K*Su9q*;L&OxUL5kG!Bu%CS(VX3KTA2Lm6`77
z3oZHT$1pEve2fQErjAp9BzIfDi5G%7x1yD%&-E}JZm)OkZkBR?cPYkLl7HE`@M&t9
z=}6^m15;|F!vq9k&^?OFFw!GSslH3iR)yvsbkOjO5PJ43tKAT>N1N6P080@`_ffU+
zN^Tb)MQ(kT9<yryd40I~l++DE+RY;Lw{#W+vG&*4-k&C1%4jj8>%XITJ#dBQ*7;WU
z;)VX9ZFFwjRuyYl6w&+Yl>dHS?B87#NHDNA&A1#&KL&;9j3Xo%snvSoeZWK4qd#=y
z4-)pj)M{ShnTu+!?=R0XpzrXJ&Q1J>@n38WPB}x@jlEaflJn8@?iA{tWT0K;@Y1+n
z8+t|V9MiJ~=^O#W6OML)9{v+uhc-%zhR!I`(31@GiY3N(S`FG42k);?Qca9u0v;w+
zn7ZzJkTLe#?yyGH>n1!Q?a7kt9Rfq!(i`{vI$Bc(alC{g`w{-Ji7Vls<C`5#`K~R-
zC`H{5Jjrh}iwXGo^HSZ5=jNOrcp9W@mG<Et-mLQcX6SS8NL4fy-Sq=dFvIdI0QP=J
zY8d+oRovC8<a+2umd^l-Z$oY_3|A@cRBzwrvg>2s;Oc{7@!pB7;<@@lF;egTWp)hq
z<Yu#%LV#?dq}y|^$+Rq7tElw`+21yUgZRJ#m6~rA!|DD<JQ{-=)YU3L8z*azu=UmC
zjLGC?d51I|%<}BL_a?n&D`>8dWVP38c|S<-YOU7Xip5;<YJ}#vw=BkFvgz<d^Vx2e
zsJp<ekgof&Tdmlp>#48L^~ICyFAMc<im>MNW)S5DKL`-JEdY6HZnXSPIcQ4G%zP3@
zg~6r*XrPc~%t%L{eN0iIA&9|(@_+G1xG0(ga*JZt?vr(&gqQO5KrkAtm)CpuZok4F
zRF-sKe%QLP(AwS;xH3WG@0M15z;EnRBVf4hh`NC83Um6zzW$-n8eL%mdilJ5anpL@
ziMG}e-~2-Zky{e~)JF)QN4yT`2f!Rm=&svlDMo4b9K~~YdrAXtzd9A0aCN|xUH=Ft
zI$YEUARN2DL$Mui?;4Bn0UXpItuP#W7{R^T@+bR2wIT6Vwbj@Mm#2C=DjD)QAe2(N
zRekcl88darRclsH6y!$DK5JgZ^0Gv&Io7%NX!l61qBnL!*hC&}{*2h+)8BO)HP6tz
zk-XwrwQcr8tfzavr+Ae^857{(UEzI)_zF)@y1mGL(D~|>B$QT3J-?8G_LQ5<dWiYu
zC13`1($RLlSz%He=MN_am|fs>D<3nk5g2(R=FIS*Wya-JVn77mDeX@}fw~xFok3PX
zx@5J7E2o-w6w0~l!vLJ>-2WWe0%zG470(MyTvhWU!o1?`D~%?lWV;9g{9>6O)aO>F
z>l8T)G+qdBPIc^9nB<w|j6W_0hD)m_`Zd3`?+pZoj^4`GJf6-iEpx}l8yRi>?;JAj
z9YROknPEKPbd^0gtgy$rH^^l;W@)o6SH}G(sv@3Gx!h%tVta^05t&j`SuMhIO$YkW
zReW8~iHS+V)>`l59|y28m(r-xH8r$mHgt(Rwh?u$Pfd8H1aovtdnmhR2<PJ3OqP9&
zeLkye_C1vm<A^bIdK1>ta(IWR0cG%I>ujxgrw7!?f&#@`w9lFv3^=;?ywi>?UHf-B
zE`))S8Z0QpuMm)~vfXnCfmTioV6go-7R>+1=7jZ|j`Uf>a=d?8Fm9aXm5BE8?Gg#9
z7lI+IY_04{hf}|5(>HhtB-UR?*gW%+*KT8DxnIZShNTiaUhzuvXBj63EC+*34`_;>
ztSRS#cZf8UrDXuqqSISinR=#Q$K#Hq>3qA|@65n@`nS7H>FvlgQe~c((4x!Z-9fct
z3ugu^nWSs6_ipd92in)jJnU0lXAjiC3d1)0G0_5~KGaJ3Mb&#PRx9A+E@7jhZRvE|
zFC}C<k`7d=H`7Hg;eI;EXR1a!jLG{sbm9r3(`5?}7rz&DZarCKuvPkSh25F^EIZ+d
zWeevw%jculMxjXtRSG2et$e>^NU<2EJa@zTtBFE5&FOd1w$Z8C9m_keT$%Kw1iTYV
zI$u*Vlsxiklm6*oN`e7D6TQ^Xvax?f@=&UxEJjVO!}!C+F1wd~j`nuw`#GFKL~A;x
zGeR7y7WRF`s}hmQhz1bZNG%GK_Wquck#YH5^)EvyfVi#6id^EG9$hBu+DNrWK7OuI
zVC7>4hf5<Yvzp(o=H3t~%Noy6J-$Tdy_C@qCO0hRT>M#rYU+rQ%Ki9>FkzciNhKz`
zqZ1mJRpT$?!z87aoh|#PA{csSi{|#r;mZt6c#jW^75bA8$Z2b6g|x}Ln>Su+a2xq#
zbXX=F`dLYP0*8<^vmM>Ds63KG<d&?m8Qt|#qTQvq<{=qnqleOoaRHB^_*$Uf?q{8F
z_5)Z<UKbFs+{naz+O0Z>mDkC$QVGDI<AZ9^()E0m9GRyGG;BLdM^R7jUZ=Q@LcQk>
zY4~{Y?fIFveEPH*WF6fXP;^g5Yg-HF@Z()LIX3&*pIBR1e6un)PWo{+CPQ<y^v(}4
z>)kHDP7u4sJ*xo-x-<ynsFYT{(4e8w0zg)(eL!mR52Jz|!Ltf9ELy8qBhgtnTHJvh
zB5hfC*{YsoP|%UVL>i`J;?dC*>02IEMhc@&5TFZoc29Z5dvnvrXGP~krsVdSK>yH@
zxtnf0Cio_57|Oj}<yKfk#}csBxq*zFcf8`_^AoJ5pKEoDJSRn~s$Js7ilI)ER|hiA
z(A9R&52f;EC$YNLtOTaDxAErauFP{yoh5l^4{jckVpCsAlA&3;PrxgQ{YUWv=66QT
zFcBQBsn9PN#QqpU{vs?46cQd+lp_#iR*6TYL#h7^Ne~Vq_d)nW^1aw*$c}lUukx{e
zGGE*5qM1Qv-eUabe&Lnj5drLEWQBT2ts^Y(+?XQf=j(W1re5Fqq=1O$2z0a~bobn3
zmkW!L*ksHe*BFtlqMfKi`so89EdP3sq|~9Q)XKfF;A=Rz0Uw8A!YXPPrw)OX*O2h8
zhF?GX2Y=ax<(<#=eDow~&;<fB+K0rP-IRjzk-PNr@Wh#pJ9-cVohN^UX`gmxs5G)q
z)?zNo|6uc_Lw@>KRlG?BNJ~R1RxWfQ4T6*(UAoTe?QXn$?##fMuv4m6Y{L?JChECe
zkRi>|N^pm~(j;0hKLZ|=5ut(rz@LGkk~?=5M1^=c(pEBq&FI)D(8uBr_=Vo5O@p#D
z<k>|VnR4eG>9oTRq;#4+X4ug+@Xu6nK6{D{4S=;q8?{o^ZS9y!%js#`?}T`%_w^K+
zZ6$mLg*qq0IEF?Ul0iak>b$bfHyh=EFVq;hxU?6)`D5<Rfu$GF=Y<Ca+#9Q09Ckg<
z`V(qwws8I^ldUi;4UyVtOpuf9&X4Q6Nf>fNW#Kkk#C7e`HP5PGhxa^&;vNr1NquME
zMD=!#8E{FuT$tGrp}!OzZCkwN@uU$nUb|)U>!(@sBeQwMwL#>ygtXf7mW^84yo;?V
zz50jXy8Sv%FW=py9+NoL8s7ZpPfDZL-;Fm&jS#Ul$4Jx*X0JehjRZbG_v~PZ4nnWH
zO@%0rHCzOYKz4qj9Qnn-FNL+gwP(rl;a;^PMSrI)-7_ZD)UI5moa3xwcQi_Cqa>Jl
zg7{M^oz}hXAFx<aYI2`IXv~QrL(*(ytyjHtw4BZKXhiduN8Z2Ff8j}&9d=`?UH^z?
zea*a5ISl(Clq_J+a8yVjCB~cd<`y;k`AdWBfdH5qy|Jm~`#)@v%}y*X)dA(Oqz<E`
zd`!k))ZGb-@sQQK`M3zchFa_XD){*fkR1>Eo#QFLx87^K_am1B`>7{;&>)mqRs;0G
zC@fxmJzHR{WO6Am@S%BowXpyn$+Ui-gY(T=L*sc>+)|;2_74ga_uGG+!i*Pk40J2&
zpR#R<8KGqZnhv7%H@@M1Bk`J4u@nLK9A5pea7rwAG9sX6X!xx;o|5wY>=8|T+#&N5
z{CbyjdU2y<*$Rg@CQ{hRBe<jQKz3X;;BT<a;rA%0!|p-bMu6t_WM~Nj76XZlgBOhf
zJv-R#u5LeQkSNSZ7LEjpy&oyN8K3fRM;6Y!Jrm#zz2-1_&6ec;)}#XB_YQ|osG-R!
zuvOc>U2pTp-+ek{op0Pus^AZ!+tVS^qV1A>WE(S(23*{OecGCC1z0JhYevH#x4C7t
zE3Nzug6TJ+K(6xU^t{xx{zKSetyIfcf<5b1$`a!L85@AEeRTD`a%a*ZY3yGm@kOBC
zf2HPYPgc5nD4JLpAJZx7q#Zw@#!%0G^$2H)s5b9Qa}xg`*_7fK^&rPOPLb<Kn|!I`
z!10D9u7n-;ZV8Sl=bl)CXk^+S_KDNQEx=5Y6aj|?9Slf0qq+O+tZAiVW4dVYO4AJr
z0ab(hx*W_z!zwq!(G4i+^<k5#NKn=DpQoI114!!c!8|9c!&R#0UtwDBUxP(!F&DGt
z3-Gq>%e)apz5iT!L_u6xy0Nro=drX8@7wN~riO7G8$jn9#XN*J+1Q{eKDdEP-TgUA
z&fc3gg;AI==;4_Iz|evhZZs1)=t7_+h-{_r9Rb~(xF~bDBo7Y$40V$Q&Bo_%rFmXy
zl!K6k?f%$TE-it^(=Rhp#lBAT4E8f;JJ&+)^Il%SvAYR{G_@sSKtD4tb3QvL)O<vk
zc7CKccYilR2_#>GMk)1(ZD6uQ)CN{w+{!#c*Dgcru*@RpY1i$nEuQ8)S*nhxd)=a~
z^4fjxPP5^|KD%ku_4Z*O|8#$Z-pHChsXw3(0opK9w_2k89Zz66R2)pplJGrSy>-li
zx&Gs>>fdTS=r;N7$Fbp>vV#8G6t^%~b9Y~<SgHH3JlAuNLo79>#}b9;ul+4Laii;=
z3WshtP;|9nnrUagivAF#l@6rV3ud(LslS1=Gg=(HquvisD*+RP%kHM6Y}X+YR(9y;
z$Bs+Q?Cd3a7l|Ox^Q@Dug6a!Z_tZ#oyh_x4HYb}I)|cYOcVcTw{wJauHu2mBk}Fn*
zSH@1hzq0V<Q0S1>(sq5WE$0Z8dH-q&Ux_HI^UbfL6sB48IO$+>PI{5K?mPu#H1Moi
zeArv@o6t9h9kpA_{P&0M`rpc^OL7=X1J;ywsOYRgR7s?BN0`pKH8gZuTnn@Pnl|lP
zxHtqz9-?VDl3n|qpq47E=ll@h=>0&5Is$!%fo`3Wvp0K(+aZ3dvbll%DXZ&7Tr_9N
zX3yEfG8m7=r<zlaJqusl^bNoFx58x@1nY%2cbZ=>wMra|ZPrsiI!qAuJ9*<6dy2{z
zsDo{}3pv+gF93SDLOGW6gVkQPEd(As<mv~Zh#qph^BwK7e0p-_3T5TQ;aahC1a!W{
zQ`naH33=M%wKG<56#I9%T()Bxf@r}&{jByjtMfal7$3Vnu^h?sL2jzLw5i^Yj;Qdk
zUMSsanxjoTg~Y|)8m4|&+#o8`T{8dDrHsgde&fDLvxW_~R~dJZY2UHCdZiY5zx~!6
zuP-cnR(ZB{Z(;CGH);EWGEl@hFRt6uB=^}_mx*>XvmGy|n`eO57iv0Pe*N9zF`qcl
z4M6oeyd)L%47=4?5)C`noO&QBanCZ2i*>(9q<%DPzCPd@j1Ld#>G<RBDpzFPwiC$q
z`bdeSCArn6344$iV={KVZ|s@nRB`pz?~%(~<`B~Nc~7`q{a9s!yL~>_gMl~hnRd?F
z&UzL7IStoec)|?OE#XQcC}N@?U<(;BD#qOAZIq^!^~PdBVPv)+g>gnkRIq-L8!_fZ
z$ZaXNtEc|#V6B!1@B~XJxwj7g@~RpEJ(?E#U%LBr876M&>1dWFtxWz)>>W+v;w;5p
z>(ZiArq43+Z<-n%?_&S`_Bx)<`;nvkEdm*S^O@kDPjTKoek@H4)-s$jq-jQzCARF_
zTGDvf0=Amcf$(H@sJ*pOfCc|t)yno27)$p7)L&Cg{1|}~V3(2{H-+qEzcRepXOFpU
zQTa<<JN07kh*@bCj9qBopJ!lyqPP9qslnYn=?Bx5y)%Yj8sJ_gAZP_xg#yz(UTS*%
z$1u_W>HCzXk~*K(*$2*(RSxy-^3T6XW13sdV|%b={^T9j;)%3Y?fbe+>q{-{*Tf(k
z^F0@KqHzr2>J?1EZTM2)Z-+r8A}o3-OmXu(@aQyn+zG*)vF{g5y0n^B6ID|e<9$-c
z#CTs_QXD}4ou`hCwtm*y=!Zc@^}rse+N~pkDAd)zkB1BWKIRap;pXMAIB__rW>}~E
za!SBQ09etS)@KVh+nfcMivy%iklT1=W%kC$V-xquVg$@awC^%=5m)Z4;|ae)mP7|P
zwmTmm#io|s{ynZ8qcdCSZaQ;CCC=?_Q&{{5+>;KwpXpk@wqa5oxv({p^0M5<?|3_^
zGTYztJL`W)6ppS<8bFF$TY5tRA1@{d$;>`{*)`Lh)s@O(#|s)e?|EY`?a6C?%{~t2
z4U>L+Hik-eC=oaM!4TlZ$F6Pz8KK04fh@tFEZTD`%mXqAdOcK1YWtX|Go}k5VM>l{
z@O?o``=%7AEe|?gY%Q71=>JHrZl04fJ`ps?nO6S6gXx<N#sq|@s?yD(2wX$ZC;qbO
z{R;T>9?dHdr(G~VA!Co^bs++8;9&FMo2s>}Ng>LUjA^6hQ4M2MGqKrUGk>3D^gY^3
zjPIT6NkosZt;V_Za+I9w<|o{KqqTp{&%?*Eja<Fl$?MPLjda$&-U|t6?QAg{eHNwH
zYd(yNp5v2pdyNmI;CjzPXH&-~`MrQXQz4&G()5U~IdyLIB7zH%50(BXMgd`)J-glg
zRc~tRBN23VS;>+vQ|aR?!`q#(2lnKWs6Z);-F<z+puc&NS6wG_smJSPY4KXn#6Rxf
z+pY|r;Ja&XxAf|jaY6Smh|Cs%MOmfno_)C+pS1j}uCDz3{%cw%pGK!x=Tu+esU?mM
zHm}#7sd-^dhjg)W5GfU!cAj9%`BEhH1z~KM&uk992bHqjFQrrFf$;&Oa@E09M)!(9
z9#+^RxR0WLUE&?csvT-!s6S#fScVKMjo<3D`4`}gUvuUH$1^!#ueD#N#cWqfw`{vA
zc4@`InSs=7cA|2$NMo=6xK~&Mb$&g2A%N0ik>7J^8C~xz#b+W9*Zlm<m_sL3ZEK`N
z0v-2J@H$c)>t8+4H%U5wZ*GOhmad*}PloSfjXunf+-YzB5NnoJ1AHeu<vXHN-X;k1
zU~QvUTg(?-!mgDr*%Vle&`wEE<?UvZfejYjiVt|0U1_;{8OYi%<g}a*ZxY3F{gj$B
z<VcSvxqceuXbV)Xz4R6L^B+SH&t>fkNGjcz(lvIUVQNS>hQVv!ONS{Y4E*A`j*6ww
zzO6~)o{R1y0A{oyIS*s7FzmZtZvz;WYs26@P9NB!)Kay$)dw>u&kbe#kOCM|ifjGC
zx>Q~PE|){?>}^oDkX!#}qc?`XOTfPJCNeOR;;u5X=RR(^*cLD7oA5b`2<jJW{t=U`
z=422qI@$Jg%lHQfI|r^#;cJ|m)(*KoxU(KWU6-MGsAeRXmLuUiKbwlfXY8n32=(%|
zZkmxL-9lxxi|#j~5^S-2c(0M93x?l9vnzX9&@+xo3Cp;;mO~X<hujCn^!fm2_N7l{
zjFp8p&fmiNlmb-7I&zN7j=DlCx<T9TS!LAlK?M>v%sz(8Nlx3&?t5!0QeB_t%s@$e
zFS@h)&6tWB&|7`>F*XwU#6rbb=;t3IZi9glVLNl@)U1A@13iM8l>($5kkOc^OQBOJ
zJd9jS=?nk~PDIpTvP~rO+c6oxv_eJb8L|w>Ms4zg$nYdAFW*Z0`=u8USzfN_+1Syf
ze>ntasqy%{@(g+%N`^F&k?`~XO!1IBQPO4JCNgL=y2vc{=cFBJ7EL&LBTI+)caC@a
zw5BbLkD3IH#<{w}#X8m?A%tEF!2n$B>wrP&$|hhb&cAC2DkHMitQXS0W_AWRbI}iE
zYc<oI=NUArnFu4lFxdf}WI}RE%KR>Una|`b(Pb;Dw<+`TBq*hgJ?aWg>Y%ZH-bdd4
zX43$Gv%W(<R@U^3k^4;4*NM<yQ-6nh-|LfCK#e@wys8++Jp92YRd4xIc^$r~@}Ya>
zDgnn@oXj^hYdlyEQ}L8^gOtXn>SqW0EK($>AY>6eC^q1sT}4@XI?ww2FyEie)0#rG
z;vua9gQuI`OmW{}%h-U)+slL^&TvG8EW>oo(6H#&*iPB#<GKHo*e1i094Q-`We<dV
z9GDm&2vs-Nc{Gz%?2kyp#w&pu);ta*F+R^mO_lLdpX3W;d6x+$lDGf{JLzGP(Mz$v
zBk@xNRB{!4%61t;U9*l}aepU!An5DgD%GyW%L-K|X{BTKqn@7mH#;z6gDDYW$l!Ut
z3NeR_6XDKVb@!Xk#+o|qAA1H*e~#JkS&xEIq|l?McxW=Yg^~|ItGfg#gv^mZd6C>o
zVeH9kIP4@D{u{tpHdJ6b4?1T`joiQUUha>DHU+*O6MU@bF&$UF`O~Qci=N+}aHdPv
zq<s$5dF8_Ghq*@^LW1Xan&Ov!60p)tPO6LL6IzCj>lzAPISJlX{2XY1PnV@HmD1pD
zlo_ae9A6x@L?v;Ou_@g8UTh<F#w8tGRX>kTFC8x`ukV5NMMnL>{uF7|$)2r++Z{DP
zVR=h5d70cKbVq!>uHjnIU(-Fc`#Kc&@(kTtZbpZXO|j)@8xDz|%9&Z35}*p?2kO>S
zu#;xx=Uowtl_UB~(6W9%ya7^i@IimD3t24JUQ>XaNP053mhrqs4&B{<Dlr6DD(!6L
zyOdAEG75GTP|-D=I{GEyYpb3$T^p+$!Pr<tmctIAr@{FmBn>;bsk=+m>=T_<UtE;K
zz!3GIYys&DHa3j_;znOYoz+NnqAYpd86mz}IX-d>p58FRS?lIX5+ad1{I=C3ciN85
z>h+yn7N2*K)RdlgX&?g)&n%jg{rPX+5gvgZMt<i&?e3{liw*#}GPl&^PHturLu}5!
z=1PUJ<5!;@H-Beim`2nJ9jw_HJM{STc9dCw)E_dYD!D^eU1nGK0-OnBYf-VK^VYWY
zkFr(IY-|KEcW<ZN?=B3Ge%9{#td9kU-j`#98rt6Z@R1121Ur^@Js_Yom$t9tG1{NP
zI8=YaQMbstH|FpkE;L1yP&zkoHz{;XBD0gFP|l%>G}92qwVvG^&8j(SpA9Uw2v9+=
z&vEd^U3t#ilS9Q^Ir6gAstS6(WVK;+HF@Ky>bwENX2Kdh1BD-bCaed*SVU8wT<rd}
zoQO<PuFK|}Hx|vS`?z2McW@*(@pYa3f9uu5KMq&H_cR8Ukx*;8dMGQ}pi&_#(!d@V
z%4L6qrJ@R^5J!nVje#q{VsXuNtE&e7LdDQXk7da+w{bn8wrgG}So|eSz)-R1AMPCn
z1e*fn^aG>RN#>@54T(#^{N?j_hpRNE89+u>J*%RdpQ$creJ!JJJA62DTfuv`xCsnY
z;5*3mrV$@;uS)qDWP6fdkDWQ75U%L^(T0Yw$@3FMcRm+j*^gc+hDoL9X64%au!;wN
z%$P79FkS}CZw`FCP4KF&9lBrRv-UAUf{K9IRZni0U#6UF19w|UVm2Z|2~yU{HO<LY
z?>revtKsu&UN%A|68;iY%^W+766|ymiK;5havjS?E8$~wEYeEnF)p8YSf;K5_F&+D
z$QOhOV36LMd-ryZXrH8blr#{3vTa>BJPVOeW5kD##Y(MAaFtNS1w54fZN{d4<@N~Y
zRfb;nKnFrBDLY<T*|h%hYxZygmRHC-^(GAINn~UyeIFki7+(RHknF!?&+E*vYLJ~f
zvEs9{CRQjuz<%)Jw)8c0YM52bh?bYt#;t?^2gvN`YP6eAp43M|joT1quq|Q#E*u0Y
zi5&FOR~r@2R(!xXeJ`Xu>fuXcC{^X_U)V0AKMgJauwIYpjhO{VbJ=zLKOVZ!O)tOm
zt1|R$wCs0oK6X{gZNH42>;!AhT|M(zL-gP$fXepMJYJi>&R?(BLre}W&0N1=#f1iY
zTP5TWqgx^_kA_A1`_D2Ru)38#dxTgnkqJY>&cofXv%E}2c8RilvvcfWFsDU)k}*ae
zeB)ke&_o`YS7G+5e*TOw$OX$zM8_=L8|8sr^+sb|{>=o69ICzu^7{j+&@fCsoYeuG
zUa?qu)+|C<vh%1u$oXGQzMGYe#q_dXuc@=8!gsKAO}4hv9)5%jdDxprhTYFP?0~5;
zhwgl#cmn0#j@TgT?*+i9P1mZzFLwi>kqHe-_#u)35gW(kIO=k(M)p+V%CBlUQjT_d
zhLRDKM#*#M&p(nP;l;G1B1L2IInrz-aVC-x6|qt)y)Bsfo+8dZS32enanMJxuUE`K
zvwpO96D)i#>0t>mP}S2xEDEkoj#_$naf9fk;4wQ(gQ<g2whmp(|FF+ZkUe6XKc~Q7
zV33`KWGs@7_Ji3)j})(#B}{McH?NS+z2-V8T6@&)?ntW;csI%cZ>3N)*;TK2M)~CT
z2<D9T5@k~WhQI7L%J>`doK)>+6^QB;tVVkviZ!{)LfSDqU9KCC3y4s<*F5H6(WFxI
z02!G!vn4BUc*&>xCALq5P4KhF7m`zNm)06Mh&Be#6Pqm6X(ry~O>u8F*8qlKI#z4d
zCIJURxC9`!n+99Ze@;5mc!9|RoCC*?eLKR*<-0*o*pG?Z4XS8pm#0D-K{q>5wKsO?
zjxG8sJL2Kl1}-1eCjY##hS@nq2#4@c7%SQ>25QLddV%xtv&gk+In0a*Wu38ySf}@K
z;l28nylTdJimzF|eu`eU<d2;X0ki-|yH{X7^hJ@&?@G4E(+6uX;3{Jns&5N@-Uu#~
z-7p~P>g5lwpipsN<A&fAP;UJ)C+Bs<69Uy2E|-}&0e#LDQVQmhnWfsJ?}5_8d>}lQ
zSfKZ25u^>oF>skn5iA<(ZKU&&tjx}miGLluIH2@uU@AQ9yeK&nx25(K_(${xVx)l8
z7kRvzk`l}XTN)nr?c!F^<HOBhQ9yn%^3`{Er$+K7sNI$=<3Wc*l)yZLc$Z~%LOi0e
zsmOp3+K38Pj-c^igxYsXbqVy~$X)g{2hi<ka1Ft9st#(mAkBJ!&^A^g-=E|?4#)W5
zvc!iT&Ja#(k`CDA4Ua&9{Mdj-T!MnW25sb>k%nHCq~q(pKoi25r>*<*AAf6x+u^#G
zpesb=ng?6%_Chj!Bgv))Y+#o;OrdrtbGW~L3^N8k-O79TMhWiey-f0)vC-|>hr{+<
zKHod>U2qAA0tDbE%mYk|N8Jr4w&rD^E_BPs0Sgg<*`*`L2q2QR&U!h$T`4{oGQia8
zo2H}K(TrZ^fMS(X-;m>3k&kQYQ{Y>G8nJ@Oy)*92fY@~%1rB;cK<KiD=Sfn21W&t~
z?8@`Wm2hb3Ysi8~HbDzpn{FVo{$=*!^?`Um{D|$RQIv8FOr#<cUyRSX(mgB7?~Au5
z^DX*phJXGD<KzdE*6_xv3YWvdA+sDVE{n{zeFQe+PVULrKHN)@Q@mv0o91}8-}qGS
zN5p?V<1>y480Fe4mNdVpiFnagSNfb2puLb@k@QSl>8>vi(qw>+g!m~tN%S><U}m<=
zlky>mTYbr|rf%P!-Z^K47$mTM4pR1svMP5@2;7}DuZJ3CKSMwauOc6ex$f+&QGT6B
z3>fv}y6I_aSXKre&xF!2dniqgK9n$+eJ=y&(@t@-JKt3`u#G%^tWc%t**pqm77s_m
zBY(`%XF7*K0G{n7$_!fYCZJIH>cFqlhu4F|d@Ge*N4y#HuSC{Nn80x7((F)|lf|;X
zqOWP6_Hw#5kiKmQ*Zo*+uu+~0piDz!IVJN7q!v{#fgvSl!!K)LQc9zGLKs0cpC88~
zfXfwxI-p=V*+GVvX~o=umC2E^WbJ@yF6_+mHrW2EcibiH_RGojW(&Acb|`@U{tlNO
zg#a-S@l!LcI)QGBWeyU1Ybv`x;M4mn)Nnu0(+#w2XIpYlf7+Aj2B$fKegQ!#Z9BqH
z)~CAQK}K)3`jGg@!AmZaWd^f71dYjJtIzOy8SReEjYASANdtNw-pgL!Tgha6#}dr3
z-{wDv+LB@6&14x|jONpCn!o$HWN4S{S88H9N*?pGe=UnQH^IJznGql$n7OnMtT);r
z3cZ7ByRFjNlBgaI<U6tGXv>M___dbktaPxKLyEMv+kOU-%?iM($p{v1;D6xxJ*cdb
z;FbBB;}6m}#&@HPj#HZ1oz~NB>4`-zOk8L(GAR7AZ%u&i0RFSJt&StMydy`QcCi;Y
zPplef9rW|t#Hv8uIe;;#%b9_34IR7wX}^$_D>dk6K&5axpyC$U^gjT`sk?jk_8+N7
z;0j=?HYH=$hmKTC&kHLCRyJu77v!3t;Zan>b{LEgcnfmCUtCNYI8<W~&Z0E%K(O}J
z*moBn^rQ4EOTDFEY^M#PO9OfU+rephF*k8~#6^%m#DNV#mrSpech;VysYYJWb>)-3
z87}K$-+-n{$-{)EaRu%YK2ZQl`Mo%Wq;hfjTvEu|MnwifL=Fp_pb}x)^`n>d-m_W1
zT9h%=zOOUMZ}5lQ2~KIZ%Ph^|A+#Je9(30W^YY(U?W_Sx`2uc&<xRyaQ`|Znycu6J
zA3ToAbJ9u4Q{I#K3W028wPB^dMThVYlS=6xX9m!i?7sf&{wc&tU=IXOia*&L{-N=D
z@_eV=#SQj@5WPs-uddm$Kbr(TNn(hhGsCz9z7EoNqH?7}e%X)irWfa)^u9go-}#U4
zAcQ0sYd`?K&dQ^1hfbW*4ASLr)zY&Xx!>74wSsb{YZ7w8-ocGKzBU&KUW$?riUc-G
z*}$9FYW@s)D_i^EwKM0v{;9!VA*$gJJCQc|X|2AS2eyf!+a;5G@h_n`NS|+<-BK|F
z)9uaz>?3$xF})wfU9gF79&z1i2YU0UBEE}<fxGZ2IFUYFe0735kldE|lxF$B43>n(
z{TvmDu>2qUm6kT+p`U^WsowmZfum504BR)wz&)E1a^ocK#>B&fLl&NGn2gIEN0{Sk
zaIsi=R0I{nxlez4BkKE;hF}^k7^6M(+U>%&;0gUhmr?iMEp1+2c7{L?r1a+o{hBB(
z*z14`GF8OESO4?zG}8gxcR(3}UY+<cw?2UUoOfC3xn*bniZf&KwSP*~$aT3s3q9Hc
zLp)&Z;Q4zdp%`cl+ml7wl*OQ+SFN>LyNOeOKLWG&8DNEo5b_J#WRP;_yb*_R?cBO2
zq6+yhAg03|!KZ~FVM`)|h6PX!9zFecrZ`;9hoeKQBV9B&P~*B5&+XH#Q`d%33-Wng
z2viDC4d`s>0j(}JpgLPYC4wZTvr&WnBrrFth^IhZdwT;;C_vRd$wX20HALZV!wF$I
zuxIM62G?j6NK<EmslZR;GWlnYwuE+iq!)Re;D4K`sBNG)BU~5W#(!@NcLuWK36O#R
z0^FKr8lim_rKV0!*QdA#!3qI;L=c2PG(lN5z*HlNa*EZi!eQRx--Y}={hFJ05Ozug
zFCf;xiui+O(jZvC1W;s9ORrcLJ?xVM^J=8JuXgu<?{*dnIik!RNz06ex${uSzLZda
z+wIHZP7{R};dcM;OPhm}YNCP{D7ie^;7+k%#~h{+s8<4ZGO+tBZ+Uw<?LGr4g^zlT
zI065@7}z@OHrdKtw?%*}{ku%pcL=aTJw*oHfb><sPihcZ2*!X}2z0P0^bd(}C)2WB
z(IH@bJARIVB%`ZsAR{_E0V2YOd{zcTk_1=9)m%{7uhLHUHZMN;?>rD?b{1qw#Jdj)
z+B*%oL))O4P3Pa?&#$n&b_>}t1o%!9=EJ4!t?YsS*=RLyCmSJ#Bm^R3*qo%7G6bYl
zRG|y@2TKi5TTx1k2z2t0_pcjiH~s*|&jq^^5x)R~CB^Lp0?Ibu5(0ca4O$Oe-ZEEG
zd3o(<fySP=Q_Ibheg8Y=-H@2SIt`LxTmVYs+20*v@zO1;WCT(IsA`i(?KZ$r$BQ$T
zt&bmY57Ow-1+W!p6`32OQr@&^lVjjEP}z(SY7KxI%p+F<5CTDi2;>5NN0>x=2oYbA
zy-`DQ=FtE=+{D?Gs38;8vumJ01K<S0VB+xKn0tD81-zj76^EaX1F05#?Wc+ndMiP7
z?IjRg@W(#3q^pO0WvS=6FhAH2j>>^`htvCy5TsJ%ES{So7wixc|HLuwqU@^e+lE3W
z-Vb+5P5mCB-!cRNg#%J}8f=~ZxCBKmTXezG%u)Jd+t8FfYIefHJh_7vxvIsN3wTSS
z;C&3K{Es2&q7w)(o(M0%We;k(i66d?%!8eY9NXZZ^~c4+9Sj3iLE3fXLX9n3Mf{<Z
zBG~w6J8BMc8S>=w2p;4R`tJ^qr!V{z#4p0u#;rgB6b|C>*}ZEtbRhxz;9P@$ANf=h
z{VMbm64yLO35?G}m!M8PNc~si{`)Qe_wN=(B;o&GA5Uri7J~o(|NnpYK3I&;R&U*k
z{Il+Bj#mG-P>~&YLJ*nd-+x@QQS2W=eMp1aNO5iwL9CSYoP`z2&p%k3#MELz%;+0p
zM_r3PT>YfasJdZsiu=f(Xh4@o;olsiL`9s2Br{&v(~De#jOwh;sm`xZR$dt&@8wYj
zoCn^u(4ltaBZxZl>r)WV3?#{E*dBs@`}fyd9J}IZ^C^2Vz7{LINJ2!A_Qi9eIzOWM
z5V1ItIUe=YEDcaWq|5ZrQ*a76ZixLxEt(ruYiA%VLTez5YJmoj3yp7<kQg<v*7C%*
zzuXWY_k!IqR&LN}a!;iqt~E(8G?vApP&}b9Bm_VAOo5+ohp57#(f9jMR}^kOj=GeQ
zj%bs5W!o|UBrYJ{xgiy$I1q%b0nvbT8g%c}-wVDHrjlt$^uKhez;xX7%Z49xF01dO
z^0Pw)Ap<4$&3y+^H^$O3)Mvh^Aq2oD|FQLNZ^|d>qf5157MygEgbPD)D>$@A=$1Y~
z9fPcTUJC<vQ_DCoHg!IKyGK1x(KEBD>L$)~;@!gLjiQn6+mTk#_`w{BSX&>EgT8@>
zY!;w;*>e=?Tf3Yf*TVa{NvD=cr~V-goqM{vESnO8q75*oR0kVsAQOta-F8ST8$q|S
z4Gk<3pDKph11XrIj4jO@hif;$zee%w1CU_Yn4%93*Z39}<b6KP9AEb=0(Z6^ShSxr
za!H*m)b!uES`mMQdRRB_?6NaVl)xrY<nZf}GNSaClR6zQ%{yH&Wkh}0M%97=^ph{;
z6u#sw1j>-gO&X&mbb4ApW1pBG<q2pu$=Izp5LztI>ibYC5mDB`pX!HOWr7{2T(pU{
ziMM}<Qxuo|yFG$npPI?}5lvaGK{_%}AzC=?vd%xB#W+wL^NKq79N@3C@+UE}TP_8^
zqkKMeuBsqdB~$e(v`NFOZX)v6QP=JwU@4I)<9arW0e=iU2JLu}-H=|EUeUPJ=NBxJ
zF0ni_@C>c=jEpXLkY15>FF)Al@5B3h0$#Xdy)>wZFev|8IfkjAh^N8^L<g_AO7>7@
z-}G`<+nmKA$?4Jwy_pN=^hK4utgMP2<M^|7M%AP2(z|P{WDwH`qO||V*2;4HZxERk
zA^?8A{-%GUD{1=#oa|U<=+dgZ&^;E2`95i7iB>-vQen4O#xwKtqu(3`(`#WmqZ(zK
z{ky3%5oRjvI<=8`hf)1D01B$W4RXEu0D*v;fd|XJ`w^9zkiaf#KRmej<@CN0zr89r
z20&B2Kv7dubJbnipMnA$)+*IjpMY52jpal!sHgnB`P(zly?+j8kxU6a;}*MyJ;yn=
zJ2J57h3+q_DthYMNtfKTo!U{~#`ee~$e;e9=Po6rg{bXyANmYHZphBsc{{oX-yjp?
z@F!T(8IKpD=MqlIbuIfgP|-a3sxacQ?%Pl4xwVw@^%45<sGH>QKGYlF!Q`nDH5N%^
zWwzI5k};$|I@MBFx``uxIRe#vpZWBQzcU`c9S6M~aRx|o0O$lcN$4P@K7P_-e%hB+
zG9^RxvV}F85OF%bL}RW<{5PA{i~#Im$c_~>`dhuEQ+@(O=271M%e}B8S78nEafU?c
zl#&s{&-$rqUC+l97Lbbv7?QfX{My9kll^`3&<ckLPohi4%~xFgLpM@tKPv3~*7p<W
zslRExmNRf5@>`%1N;eg;u5S-h(nbXg+Le^MT-1Qa2>aL3Oac<0NtG%zZKi{+ulyj1
zSNm<wwm`PWK9osN#ghw*at5ZsG1K4Z5)acnxqvNk)hnOP@pN9-PbYuT>U`rT?%W=+
zh1lhgiZt~9q&Oy1!fGOG#)2+#Y4JlU3TM*$YqY~<_uN0UIfDMnma6g#q@;N}Runhw
zW(Mn4#_!wf2N;Jci1&<)l7`w9&OoKY$dZ-=u0;r9qcWt-2X8c<LFM{;Fnn;9*M~{h
z466`HBc0~S8-<YFteCw@Rq7;tmeSA&zbA;r3WZ{qe=1l2E-=Il21DFuwYK2){pxs<
z?m>lj)4BYXDZZZfJDbKu1&?xg;3R|lB_yH<j0^$fqLf}ZG@?A$XFsc}&eVUZ*8PK|
zUV3`BBA3r`s$(bq3A>L^$)ld8Ecend-r-koS$4k2`R*o?gSH0ABYRun{@kZ}Y2w0B
zCL}5by=zYeo#9f3Jcw108kf_m$46f)i)VbO!YzKOyQRNdrlMAPRp8#6T!_+g@O#C%
zP@#0&V5I@lUv_98bt)5i^o^ypr6sSzGWS=t&rYFLPiyTp3P}8)r7-zrLd?t$d>Y|o
zkEE=Ej%iDD!NX+azJzf4oVoW#5SmOf{m74}*AD%A)DCiQoB^eZOm4^Tr#=<V{>xC@
zK>Rkp_8ow0Y@qL^dO9q!`M(Uj{OKS!V-J|z+3c$gi;^Uj*Qs~tSY23q4i&`8DV4&*
zo@;GEicEq1dB{@M-dgXaK{Fqr8gkzfNvC}x<QK8*PeD&<H}U?I^HJ{Cm<i<ZsJO*j
zDHR}OTlKtmbwbY~>Qw&_JI@OcSF{a<RhTr_HIF>GTdu1vP_32atdAQK>C04^n{erf
zz_hsD1yc-JDN3`VaDK^tu1z?&;29Ij?Bn*n?V0qi>CxZ~`XC=5;xNiho>r6tc9E-#
z^ywmNZSd;u6{44nG_@8wcet{9VWtS(?dkDVphwewoV{#!_RgjGt_~*Ct7^okhm{~d
zN|>T!qF?yp>mxZAu#QRlO$d#y+=?FH8VT#!6mBC3RG(IcS+Iv>@J$(rxQIzaNS5MF
z7cpDDw!83F9^o!oXp$a`J@oLC(~DAm*<eV#l=?RBg-tJ%(do)aUrCqgkpZJ>eT>a;
zIw*48IrjEV=TK&Wz-C;BXvJIR$g2D?cg&MKq9Jj4E+kIwj_mFD!2@a4OYDYRMr-$Z
zNORiu>7*mu-X3i-h+6*!4!9r1+W*G-P!2Ss_0gQgp4c&b`qq8GP$GR_bqk(cvRL|!
z#g^X_HD1!3jL|d@Hp_)6>%GT4u&+hN@VuKFZYbfLe+|m)GrZ~n-u20%)~@l8lQXaP
zHM)p!*8;t)Jes^dC`0|O_mUdCIb?bO{o4-Rg+hgb7upGNeWtH>!@ex5wP~SC7p85{
z1rfL2i&}q4lJQDQF)IW{0iAj7Kx&kxn>a1%O5{IZR0hJ&dD<%%_Cq<r_I#pvi+8vY
zzR0nTKWX3n{piqHWrUL=)`6k+zkH-Na-GWu8Q-V>p142qsl(H4_jsb%^6`rJAd${b
zjo~g0-S^)Ur+JDxe%$}(KsxuAoUx)rzEcZSeS)979SMernL+0}?_y%i|6ZoJeKw4D
zE#YCdktwiC74flb(H(qxnbEubo<^U3O$FJJsSpjKNy?iOic+pSnk5!ZDe-3=+fkcG
zxo`Z2t(ek3`;CzA#7L-Rn>qn2?bO)Kvn`t5l}r1YTf$=rcB(+CecX38b6CJ-3kTAZ
zBzQ|sBhNAp<?yP8>q+~qo(k-L9H3t$QU_pmmjjn#l^B!k5w6;)Yra-kp{t~>D8XJn
zw}G+l{Psw>6WHtFqkr#8=P>f#U{^^DPbj1|{fJ+jL3T7K2A1jnhpzX4=K6aB$KO^c
zTV-V?iV)d*RU|30cVuMmy&{y1^ob~=BH1f@g+gUVWQ)k&d;Ok^@9&)d@0|bp9OqoG
zb?<$i=RWt@_r^v9f)Rp8cB5P<ne>Zw(8MjkGZmcz2ewUR6}G;UC1L@TWv#T;NZ(F-
z!6bn(jT^BFesUpps@8B&35!|YxxxRBG%s@w4IF9H#8)fh50X*&!uIbVeDW8dSNim{
zvB6n>+F#BwoD*?m4WtZB_gI;r6>&^~nJFI5=^M-m`IjM`J$uD*b$0jCbVt?u!4_Fc
z`>#RwCEVNG6#+m<4w>R|rx;Ip@)gZ<<|3O6%Zb>`RD<20{E)733yuE)3F-Rm?;rDQ
zZwZ^eee3wwVKVM4dWbJ$5>f*LzM;cAQpMT6Qcj7>I)5En{IeP_TbPDJqL{`xe|3Zi
zFER#sIex2O&&ZfDtlFiEOq>hn8PbTwudOg7us(r{@MDsQs}Iz?b+NcY(Lz?|)8=!A
z>H|L6ATWW|1zHfK{ZtGk!xZ3-%J2uxywZ~m@+Tl;QG(C%k+I<VH{Wn4`z8$!M29Rg
zMW+H1j%R221pXhr7!pXv?9Ybo1wdz}l68R!C*adqvZh$jWP@f@838Fv9057DbUitP
zd;vKNm_NYoKzDpQp5p&`j-{XXJS|Q5B9rRj7ZU-2fL?f26^-W$G%}!Z_>EKWDju2$
z_HiT11Nu5cK+f`-my?zz48DOtU`pcTo@d@>5QP7nAHmEQ8V`@B;d)*?^d5^m0aF5e
zm;(mq4_Rhp>GGjuzn{i+G${n(cTl6T|D@s;Ct#&xmc`^nEHcraf(HEj^$AGd@xpMT
zB90sWA0pv44zsN3d7v<1c>UGk>(|`L!qHg1T!%*Z5nht>p-+>;&H>!0fl;OcGyv3^
z1i^lKmw>d61jd;>#Vk%BhGyRcSGbQy9{zZdX%;XeEy{F!_XD5-UHKh^VdgtAD$|QP
z<fjk9H)aPQkv)aG*8!98i+Xr`aaP`)%=NHi{G;a!@BnqV08V@asXZ8=C=-n91`Mzq
zHQ=Xk=J<ARz#>y87C=J54<JecV5cKvl79gdGZh3qr|`gY?C=?Xc#QN2VA2KXi_G!_
z$-Ku6%oL!hlMny~u>%&JfIoVKg;hEDN+{5lH2`et=@Gz~w2yDMQ~$ru@zG$(@@vB|
zS`oOR@>Zxb%vD;D1sXSwCf$DL__o3Y7??SlpASq+^t^oNEl_inDFF0%aP>3LN5^S|
zRAoSF`u}Eq`uKJVHfp?OuAB14$Cf@1^z*@=jG2!d`WJy0|AQAXJMdjKS=2ua<U{cB
z=z#zaZ%5ri4Qja{7w9dS8~}lyje~<O<4?nie2Qi;hQ5pDe+%ZXeCC+k)X~TQJW)i)
z4gUs!wlX<Dj{=~_2jjhT9<US+ln{@WI3GC-7IlLVmybq;pdxqNz|fMy?FT^w&o2>>
zy;Fp--a<=V6-by5;WaJ@8hFQ;V+H6D!q60eQ<!3-h3$ECg@qEZ-Us8o1+&1YLf3qN
zPD~u2osal<;56_K1-$bI7FXOMagZEcv6v<xW61^(upuh^2D6Dnv;Oc5UjE;#8R1bD
zcsUCV5LPB88VwL8&Hn&aNimSZ3q&&G%y1h`PYsAVF5(F2Xb?0ohz^)C8v@NYAgnmx
zmhl|eK?+JR17ZYj#F_*F)5(|MBi1rU1XBQu(G&+du0t0QWN2aS7XW1VuR+JI(D7@)
z_90IaL^OQ~251di69RStfYy`}UVel=4R<k507TXRB4uJM*%VkqP1g|#B4!khz-kVS
zY-qr{((C9$FjIe+$?rq90W&T@Grj;F3!;u;#+aGo2I4*}{pbp?B*d|Q!vv!S|DVU?
z)nxq1EMd)}nE)&S@VHS11f<w&$GuLl99}CpGYStfW3&KQO!A>00x-<h@J-=5MwT~P
zj&ZEmSQs)uk3BAcbqe5Xgir!MKA7<cfozbpE3m6`2!<@@j~Y{O;-@umK!U&a!p<Jw
z+yN?NKw4yIS&NY~;MO6;z%MTF=wcK-jOs0nO8R15p!7xAAO&+=0%O=Qq@B@<VHlNR
zLc~2Q?M@bYjAwoya1AxVD{-)MkRgl<KRRlpaAF7L;ei8)7G5c!hj#^`K}&gj1-fl_
zhB4fSF_^MJ7uL`PnibG}3h;0XXZY|Y0#!B)>K6bRF(2$Dgi-h@!=yip!lcb$(ptc2
zqy=Hps4)fWnHE6F#0wuZMT6gk;UV55eg7EXKLNs_jLfo3SK&msKZh>^3cf^=F?SLI
zJE4U~>ru~K(BTspAJZ9V5FZm*CoBslhaiH04>02>VKh0yqbtw3VKv`{Pe!B7`4-^L
z0^N>=9XskA3<ieH<O5Tt1=zLoA2<B10h;JJ1$-beN0{_D+L_egc611Q#uNyKmFj3Y
zD@dW+00Dlk;|9}<<L73t`;%P)R4Wiek9@>1pe>lJ1p!RuAxs6j_FsirD@X#!enO9^
zamc06b9J|&Yd-j7*J0N%169<uJZgj;t><1?2vMRi>s8>33iRk@G;0@lnHyfFfR`J9
z^rY2b)(R4E8*v<q<5_=}MBfHLrm(|!rU92xgaFZWfV?ZLiWI;cKR3J+&jGi`V1A!Z
zq6Xqj@C%2o+udO{Q?T<MHY~ow+u<-oS~@IQR>1XV1^_R=02&0sCVvn<me=vD8-VXv
zc%y+MI70)A|Jw0$;ZHEk(ZN7+Jg9Hz5_0;;u?c{Y9$ta25v#@8fiKMhX!FosstmJ+
z=@4{i5s<N5f?-U7wB+v$v(5v8!qgsLLE}yVRttL?0Stu!cNUFH4TgXo<39oPeFdiI
z33FxA2NZVV!^^M{G7TONdmLbrLJG(l1Ik1VOegSi*f?3_Gsv0b1L2dMl<>|Jj6cd3
zhW#5+V<I%5XX#~h8-|<gaNNL5g&sY}@)E{v3;<X~9J?HdD+OjR?TUI4f?nX)ZjWwX
z3nf$Ff+21rl1M<G0U}H}3GfCE(#{XVG!jC$(ekB&#!tlE;75T7zz^Wvg}yC?295;-
z-y>&{=OAN}9{>O;BPk9sE0B>00uVQ`&^aFXF1ih{U;^Rwuz^7%L(e_8#w8#>><HMN
zv<V^^33$61$k8JH=xu)&82ASu3s`MO4U8BJJe~m-7aK4mV4m%t5F^n-ABX8MT?Np`
zBen!TGP+Tj<SCdfKhbdm$x68KK$r?=;cb|96b*EwAb@5I=xn+Sy)++B8?jvAg#-a#
zP>*PF(c+-bfRJMfB>oC|jC%}}au22r;SIpI06eB=kGlpD5uB~$z}=4SVpI{&fGh9b
z5|FW=RbhtE@Ed&v<_EK2z~w{ehacj%Ab*o%|AL<R5RIk-M4QBcM#%tVAc!y(q7`>I
zTEHqm3%+tJ3ZqwmX)}pJ7Za$9ICK-%JOxN*#?VUvh}0Njp#CPbhCaXwgiYd*$ePU1
z^Z^b8h&61%MTHaSD==euKs4e!u86$v!eg_*8Z2nx)4u@*FlK*i*kGH`qCF3ft;5sF
z%;+xg%|Fob3G@m=b0xZn5ITe!XhTNt%EG&_1Os4k2FxOjl;!xbKd^sdp^HG<pr%0s
zQL)PL6?hlPg#@NR@J+7AccsPAyD;G_uyZNGYDa8}>1<sf1}20U4(1ZSynBE1Z!r2C
zJJ6#6;25XSMMxGhvc}eijU5AML>oKo-dRl2FmntMyd4S@gMkGg?FqM-wCqFkAQ@o3
za>w8Z>G9(5-0mZ}APN&o04_e(CSZvSI5!4(2Kgzhy34SVq=f-SuK*85Fr_?@i!h@{
z3?fPq#(f1~Z4G?ZAMLxNfJ^jL2b>#uA3i4!knxAT3iBM^n1!c+EgtScrl7T9SeQZj
zMjf!iMO+|WCJ+-tgD}Q1u--nOgdxKBLjhaurO?QGbOd@N9{Ov6!hyCYGPI0=XJPVT
zZ42WP6p}%E32<o&3J4|(tt5ylhmGKnF&s*VNOyj2`KSgbgovhYQ`|ok!1SAIGu{}i
zA%xH$h@i~`WM(w*8U?%tSjNZt0?3Kdfd=dU1_5yOcZWVd5bTrePO12Pc=V_hoXXPi
zh!>@S-g;0rWt_m9+zX)%3QhpbXBgwNAWCW#?>fC6(y!rL9Dch{NjQif2NV@00rOKh
z4QoIE8Wtc&0i7IbwipVa9_0iP@!k*0;FQKqeuCyk1v>4H;^3?;Mdz)>-F>cufwL=;
z3ps|CZZA3%U^fK&Z4BU>b4aV`9_eLw;YGv25*O4Ln#LCD0^}-bM}QwF6NmUnxeC*z
z1(^(Oe}@euht)kD+1j(q(xF|EgwMcK-jkEF1hLXTaKk~nlG?(oRa=qw@Spwq3ySpp
ziOFOA=W-vd+afcQ4}t%K*w|;WtP&-wcqsMHiSgBY2(v|@If}p=qzg9Xf)*-QA|R5=
zz6HYyTZ6ypatJ}%P$?4`OXcLe*gtk8F&J^ec%r{DvQ%yrQ+>*JW;dZ!@Ir_Plak+@
zcx{I(8>Ax1i^?K^4VVdb^bZ;>`&IGoldMV`Emkkn4D>y3M&F(rP;dMse%+`1>^B#p
zq!J6-UFJHgiCgN~X&Mm3fI>P6dWf`xP6p9LEE;WVml?m*u+>VPjHyn>KP#REPj-JT
z(aRaG+V%4II1$43=w^`g1h7e_-ye@yHL$x2hm3Fv(S_-I3TCvGW1_?1K{FQdR|XGj
z(uv106IHwaF=#F3H4KUy^fbq1^k`OoE9H#G<sdf`!VaQ&wrKS8?v8SHOqRRcm@PxD
zTTkw%3X!||Li4l|Zf%b~`!)Whw{m-71e%5P1X|DPK)O%RI9@^nfCY*>K32*}*dxWD
zcU4$9QQ8Egg7jx9I0Y8|ra2G#{JdA_mpj<<ghLo-5iFtLR|2i%iq|1VX~Cx)gm1%d
z(%C}pw=q|1SL8D3+U=v82ChHm8b71j`t9|R5>dM^78RuDFZb}4QKZH!G5-G{*#Ql(
z8{q6V<Z%N^`tkcT+(PBxpb!{}p3wnbRt~9GXq?|cx$qprhOqfxyJ-h0P;&<be!)*0
zMHEs3m8$NOjkc6jC5NYq3BY$y(5&NMzG1v|U=)X)2n~CmCu4!soH9_%m0|PTK~Azi
zNd~8vHVo%?RJ*-u?sUhhXY}e@Zt8!Xzo}g56rEUM9<Ur~W3}-%=w;5F?AS^OL2let
z^`b-_Ncm)g^AFC0iCGx%(gbF|e)GZePZpE)TdD7yTie*THv%g2oJ+W%Q}Bnleqj<2
zdt#mXb1Z*6u2X2#ZMWp9MR5Ap1=^Op27>sHH-x}0Ngzb#B-10vgM=v8ZiFa3`_M&5
zhUnVgbVU_|kK&G+>;VmsJLroxf|M8$d13H&ph#n|56;=r7TmM<_XQg-y7^2*eskn}
z<P?+!F=F6tm&Y}{+WgA->S*otU*PBFb;9`m&qu?m;NJ71aIK=Bangy(vh5tpcs%n8
zDmtRT4S|W^uDMmjKss8>#&pnITt5HD>eJ@vweMCh%{K?F7B1&kc)(hYDA&67xaz_a
zz6NQ^(Og?r#jUM5=j|yuU_$;xlceO}k=|*$86tEPw#SrRneQA2`JqbDP%Rtr6xAHC
zAC?<G^s!ik{6l1J2X+QHW(xGE8v1;{>HH06c0lIe2uES(;ar}(;0T78AQY$1D~P2F
z1pu(Iw!s#do}63=Q9V(kyUel>iU!tYIJcA?27x*CD3^vUM$b&7>4X>Z-XX*3e4J;=
z==#&amwlykCKa#owf?|Bi@t+j=M?NvSN!yg^&q0*CHMnM^j%H?0P4U~^FgJw*8X)F
zhcQ2dUkL1MJlvZg_VoGs+S7N6rK-X=6}Y!5TxKiEPPChW^<+0v<1VTJvAN*LrR|&8
zD(0Tv3rynd^EofFn$VLM3I5p^o|1P^d|UO5IcKhVB19cXY&Myo{elP*g<gPD0pb_b
z_4KmLT1qeDMtQcx3;cv+Ep%~aseKfKivl%jUe`!RuZ~EJb#qJQ26*9OthmpK-Fd-w
zRw)`1*1o-y254ebCxmKzZi071l<HGAeMzF7n-j+L$yqMn6!S?H1k~eIX6p7L>OphZ
z&XExstBC^Qnd(ERl%kKb3i2xyG4BYf%`S4xX8%xvV>Vc|_>*t=o!MZtEuH(B(RNvC
zXvId~$ainSV86=1aOner%8Zbm!gl4xh{)QK84-!kWOt08?Ws?2TB5hp1k-a9-jY~6
zW7T>9vDxiveenOs&0nmb^B*Tnv=;WMBX*>J0o;u&gduH}plq()&7erQk7kJ%Ks}wq
zZXWWVq~H%===ip!H}K{LiESqr&K?+W3T2(NmU3&u{>#`eIBoK9eWCkN&w;7CULNd2
z`hHVgQGETw`wLiTy^j|6FnS40i||(Ld=uf|8a~~-zt`-cC_;)%6RSIMEBx~lODL}r
zIcFeI6~)>aqcnb4qpXU^mlZDrh0<PNOv!=r?!IsBFx+2`NAUW;F&BjxUF5q3ul0p)
ze2?37?oSb|KHz4Qy7%C9W>LO#TH<#7)gzBSIxftgs1WKF7eTOMbjq+e|J@t;)O`Ne
z#~q8h-e`~UuQlMIjL-x>gC|gLI=@1@i2^8gAg`1M!~a3hrq2TSfKG*LHVUb^P1kF9
zJ8f+%7DF3(5YG%mHlN7%6GDn^o0Cu*zhXD6+6a3Usa@j{IRD1Yt$F9nne|_TYGw@r
zev%X`mAijc_PSNYCb_+DL0C-i-d-=ciF0jJKC{Q8$dcG;aE8)FjDZ`)sw_LCdWE*{
zHLRGhd2^Xp_ojSRg<4)Y7s9r7rH6>-nd()VFH*nrN)POb|8)$b{zt33X5QT!@N(Nj
zTvxSuF`2d7S1l85sxzEJ)?FsB6KoIusOkA4#(s^6^yXS>{K3xi*Df=5^H;KnMnu^(
zf$tD+4DL>u{b=+1Czi`B{;G!~a?$8%S;V()a7ZgfGx+Q(dQ{!>#_bG;P*_L~d(L|1
z>{$+;$m#1CTEpA7BRtnK4E5I_zO_K~bU~sYQ?iRe1e*%2C0ZPB-$NYW^6>i$-MJS_
zU3ANiVg{pRP*ENDu3{&#+Kq20as&|nmSIo~PJ@|;BJ26ssx1)Jdy(J@lwdf!foBv3
z65#hXJNEQy4q^XQ@VZ?AnpPxy`qsh4x~C(L-ezbQB);;6sgTQ$@h_x*@_v!?YU`9z
zT!87aw{98&N5aZ{1U18dDHk}0+5s3-Td840B}u=m?ld`kQG49}hK5>V_MC`T6h|uB
zg_>+3)F}=m)lhJELJ%s{Yg}5kbQQwC<U0J5l!jtU)kio7@PM#`{L&^jp4~OzG`VOx
z^h0H;I*sw+e}dcK+~5ClnM->qcyt{WjPm8OTksg6$1Te(Hgu;RcbV`)EY1ANw3yQ6
z6639MKkDMf$nw&=5fc5x3u5<RA!e+(uTDod5NBhD+CZTd_!l;+?h-qxiq|+yVJ-_p
za==-DAMKZ0mqFOQHJrJCgM(FaoAEs`CE!9B({$G@k9hukEeb3@#KFF;O-Bm>+xrLs
z6A41`5RJ25_P1fXj01MfqmVb5v+mQRZ3@T(n(nhh2||qjW!FB-G{p=<`Mh@p-ys9w
z%97#L(`VK{gx(2W0YT&b1dl9sFpQQ~?EbU=IqARdh0ysf@UVUIT?xK!nI<J}LBe%*
zgE1$a%8*W#Ng+B>cl*)X-n(J%6PP^$HhxIv4V-W?OE%ps3wNCT-I{dmPdxKga;9bs
z>=NkEg6I@@@ka)Z^1V`dpLyOg=92E&VLHc-EBWJmRlDsg<$D>r;DWplN`Y37zIV8R
z?>`S^e!N8_X~yq)sricYaC`l}vzH6L)|eJAIpl@~;i|`l%JBVzm7(^7fz>?be_A@#
ziZur-j5z)Jr^<tNhbU9|O!7*8?YHFltdA6``VK@vAaPEOa|SEQ+q=h%+ZlQo9X_K}
zx-rwE(h~1*iQuy&+FwR$11~7T@e41bunS`RI>KA=Y+U+2s~tkqZEN!_^4fx<6Y7i>
zR)`?P@cDzg8{D-Q6n~~AWWLwB#NZ!}Jc?#Rt^ur;OPNaWDxV(2f}_A1#T$>rFh;Qu
zF|{_`trU&z6oN?!8L>L?lt4hg-_=&g`ZbQfZ>C@lVfw^|l#oQ$aNC=-8Sd)q=0q2N
zd7QsKvz}?&QQ%=0gu9k#ux$N3@+-ur$BU>D&ml8(jMSRupl>%9l0_vpGofCCN$$hx
zuRXL3Vj$)cy{*41=lgJT?}wk?S5-RLhXlsSAg18&$rqW@%V?vBk{Sj1=Zcj$j`d|O
zHHb$82Wz@%uLvw2!jrKdNvTfgFP1L_y5IlypuE!5`^z3UWF=YUErxCs*lbM-f=cuF
zv#X3($$W*ctHN(1C_ggK?($PW>frI{IxJp-TTGB<NNeM1n7eJ^(k$p+oqbi$|MUjq
z?b2d$7Z6QgFc%bm3>z2&|Jl9avsNn#QN%9O<HZ2z<n=j~O_eisqS*!&tw71)t>OVB
zm|55V>faKMh1^s%s)cMq2;mML`T7Eqk}Tj8(&vMdIMS<6jzT^GOo3+h_v0{DMcWcx
z5fL;cOjnVWkfJIC5<p0dIqEXxApR|I1^@+Q%P`3>S{vB)y8aCc9)w7sw@nfE7#U`L
zRZH@AoQ2OJ2YE1=F^J4C^Wy&)euVunAR#0T{=xA{xG#O>`ZE$jC2rlFjn8ecx&pSw
z_t$kVv3~L%lp^Za46kBIZ6tbssx8CNJ;W-wS<e3oj`)h6&mF7Xk707yIu^9BUlW%x
zT?yIW-MFgBSn1sLm3PCgy6ro0W}Sxktr#H<E&*#p*u_6Cw2b<M&}I<b>|B3JACS~?
zA*AIcUOjIJQ6mwL;_oFEalbQlR8%$BuQ4+zZ)$d=Y%}>gcjg*ODQ2yP&8|WcIxBAg
ziL|H4WZJdpY4#3CF@V?|1V`mpuson{l+yhrR?O7c#Spnefhy6@A%Cz%CK&R?18&M*
zy9Oa&Bp8Kg5CFJK`neQ6p-5Tq9Fepth}^eC7i!=x#p?X_OXiiGkTrT*M=7VZ+Whkk
z@<gQD5cRI_)zKZ?pXlyj@I3<PnC2;gVt(Pti49wOW@g3m%`_?+-x}v`LzCkAH)sC!
zhg(fIbp5d~XQKWtAZKPg;Z8XTQLjLxtW&eK<}mCp>1GE8gBz=Ipyj4SIeyt6cZIO1
zG3Zb0WH=mc5l+wBV6R*HG~}E8KQX(eYj=7car5?Xd?wyN0Uv8<wN1`zLxQ|B$?lNL
zE!(DP!rE@Udctb^CaafJg~STgIe7ZVF*4uXyv^L4{IgK?rc$$H1lB(Xw^&mAt;b1Q
z4V=0aDqdq_u()(~FJ5_KJBU9+S9}#gRXf|e(HypdE>WJ4uP-nuFT?yKA<|0#FIULr
zl>K=xE<dlwtPodw*N046XKJV_<d9pP#=~^_18F8#y`BzKZU^D<r-0LkL+Qho$6|qm
zj%c?cJ;R_h%2=3wMT{B_ZCFzJ(qO|#R~&ZItFf75oUvbH<5rdKRkp!Hegd;J+T63O
zIzdxBthcApwdVl~aU2(vgzL|_==8P=9imIkn)o5W2*clO7~7ruOLM@lROj3rXx*EU
zpnVhVzWMnsRkV2K<FrJ#sQtfW)~O#ph7VVyN-{oqtMxXvy>fQy?fI!U)I0q+@Ss{r
zqmsOrJGb}k)f1=L_j+4u<vAg4&*I7bLbQpt_IRbvunY}*k6!WY710y!g@`1J)jX%w
zflexv?k5Uoy@2dd&^H`Yb6%0-@?}KCpE|R&uYxR-QCX??y2M%y<-sUp(_XVLt?{d&
zgvd$^H4%NMIs_4>L!Hx}2eEoxi}c78&~$VEy8&f`E@RIL|AuymDe5ZuSST1X-vuGs
zmeNug+Dv6JTz<OIU1_8XT$rf~JUl9}PeX<h@OzWnj7C=v1nSjIa`P%KZANDBWD<$^
z3ugC!d=SP+H<22vIeX`KT2c^K@C%RwN%yC#^L7L$Ph_2KbPztrF)uZ6XJj(0s^YIG
zo6uC_!TR=@;JGB7%k~1vHx5E;tQ<b6AsJ(w8f+r!U+2GviukKDW(!&;8So2FH9qMD
z<~VbT&`0eD1d%gK_kPLN*JS)fd$sb*{0F8`sAlTE+onu<<MItXa~-Y`tsa%j3q9V3
zZ2?_b;zlvAQ^H<I3sfB3d*}@TpXI<$i~|EEIvXz3x7qw>a_!^KuoE+7sXSLk$rNxP
zv5H4g6heFFY)@i>{&juJUS4*Ddf&xR^|+uyMEX6{tbNToRhN(Ba{5#vM&W9LC<CV=
z5H-}UzV?|BU@ScV{PIx8y?)lM1b8>u{iYG_KCN;!sEl<9yc93fa=7#SjVfFlA-Enx
z(2=S{_44J*yQeXE+KU2m!?t>nAHqO6C7i^-1~j#Cb@DOs`k~OEEB@6%v{<4xuWG??
zht;KUcT@fvC&}qZw69$Z`eZ#f>@xVZC#Y&c*XqE`ec!YQYw3N|or$-*w<sq-zM>*w
zcZJ|Jr*>(G^87gySw+h$e(}=%uXXZWsUMy5e<w5GL>Dmn35eD7**z?(x__g0=R~X^
zH^*#3^qI3p;WgH-P+$q-sDZ6T6^Xkbp^mjXm-Pf@s^Q=_OrI;a#|pT@byUZdRT1Z-
zBmomK{a^ck0ILg%P^%qnIshKZdr(9~Q5BTVGCeLtt3it)ulJ12nY2+w6-8BFUoioz
zhSgh`sWiEei0Blc;F5|<(i$s=vReeFLhz~@1Wwbuu>JLJ=fKpX)wA+#=~#bn;gxG)
z?{!%pNKG(}M4z#PLX(dN+E#25-WH5~l}dFFPuT5dEHi65caO=sPI6fLQu;nl(bo=0
z7Yk$pnJ?42kv#x%DxaS8!p~SHp5~Pv6m?UFKsQRy#IfZF<<jtPMCS!#qDLpEfmCpd
zHSP2$DN3`zawNP!6>-kWt*}tX{`c&(zTr`#5Uy$J2-ZoA!i|>KLa{&oMmLUiOp0-8
z=M&KIxZ~~T==UAsK2x`6-P7gCDr7>Sqntnz1_-r(u^uW=j)qe6>8?U}n7WfBLOrvC
zjov3%Tc84<Vl+fq8bM|WQ`W%1_Eshc(V&yOxjn&%<GN^gm1tg|36_L{L8kcHbf+59
zgm-q3DYjb^S3LFSH_@*?H)S8&iqa2%o0lWze2Mq8m1g;Bi`Q2A=XGG3R??CC!8@1r
z*EH+bEq8r-IZC1SHc=du38pNbda?a2ST5`~VB<;|h^@4LJ@)tNHy%E}mU+80;+y(i
z;|1wWhi^}Xod5P7@ZnkvbLyMB6FsP!b9*?MqXX7cl;@4Jz2u2;HS))nR%=gJOFO_N
z;3Obp8S^PRuu{zWOv+T{vY>IW5Q5H+gSyWTKrVqFKQB}UQiwjWD%LUo0V6FBR-qm-
z&SDD)WyB6ri0`%<j%6*fdENVH8RD2giam9Cu_DbZ_vFA7&3!Ds1lT+#FG<YWo_w?l
zASp3)QF{LXt5ew)+gKs9mBBlPS$Y#R8CmQgyBuH6#TC$UFBUww3i2B$KkBnNU=@?&
zM^>=`$P`y9$YtfCP4er;t_e=rg&ig>C43_KJ6IF>(sz>XIK~-!t)#ss?ysdHfmQZC
z%Z*kzUv4ki2$I5k2TwCuZ5`}WCu5>oBSa>s6>qSe#fr1u@f(`FRyBxl&GIldiE8sV
z%2hp*Lz*F7L@|0GA)>J25{9f}L?%rkx_Us(#7!+q2JA(Os-VUWDr5PFLO4HbdO=1X
zz(@OsUrUsqb@iaK%=s($E8ktcAxW-ox_3S3zqtyac)7FhK+PoaaWg$ve%~z>8KJF7
zXT-YZe`3+6$9x0vf=T)nR&xN?=co6w$&9L_vWIrAscsAxC5J8R(8qmVUyU}$k$TN@
zuJs&0--X7|&2ux`Pg2eYf@9H8eT`dDb!DOjaZh>Y0f#ltoo%T?Flp@ROm?d{E_dZ$
zJoLq4n#4u8W-_%msT}ZWIoz4K8z!+*3Mp@YBn>5dhd)d1-6H+CXx7L#A#k!n_pU*Q
z@Tr2=r*zd96m2c6n-?kS*Oy%m2zGZ3rpiCJd1Nnl?WNd;J2r>f-igFQyZ32ag4cNk
zD#bUWb<Pde&3{OKzA5Fux9(M4ysNcBRm#aOfF-+vcN=WKii0%}<@wKe61SMsRrC8w
z(#>apI*?kwOU2yOof;{vgfi>cQEMC=+FLl%KWoj;7CiBDvBD^5?%zxgA)zk-yudI1
z<H+;`CdzhKU3ErFoKUe&Ru2<TE4%710i(G+@$PPI_s0EnzP}h%b^i?A$(-OhiJcd8
zv@>8Qkz;-fni|*Q%InPGle^-+U0*MWNU}!Mw0oEU+%SsrGWS4AmiEshT#4nrzTRZn
z(V16eKXodGaR;cDsQ)pZzUr^mk>$EttQresZ!<Ua%4w}$*VDgho`HNye|$hH*7W(L
z11f17UP5G;pXc505u{77Ee9llffBe*L0_cbE|@|w81f~W$JWchk6eYYFn?5!_cVVO
zNa^`Kh>HnT0)?UCwLj5|q~X?iHjMN=ZmLs0n5kq?PY0Ey&rdshv)8XrsATVnjf1W3
zWsDu)K#ZTY@6A37Zd%H7i(wOBV>mgEvE6H-ha?K2KR$u=0pN&G2L}W)lxFZHN^EBR
zcaHH-Y(^f(EO<>VWVc;sOcVxVW9$k(ZA+J)3i;_td{bMj<?mydljwwr@4=+h3E!Mv
z{dAB;<SXrfXA>J<4~wbFn)}e%oGvcOI-j}sE7J^Hp&IO{t2j~Bo6nFeboi5Ivlopl
zt{}vasUK1;Hb$|malCI3m!D;2*VD-%SwV8R=x3h(kpy^4kq!zkH$+fV_O9dazDtKJ
zkV8`=jP2?6kYEVT@csyWm1a42p8maFu?LMIn?=Iqj{z<eymFKlvgb%{C@2n9B)y?5
z%;?WNaBs<z$R98G&o|!{v_Iw%A<$Ca8HihhE?J*}72PFp{qdK~1_ScVvh~+GEpdK^
zMqaa_ym}~`=KuS%HcvD(1PcJz^|_`^#D{;;Of)HVrmXC9rp{Fwjce7fzi*Rb5Xj6M
zS(BnEHo?Q_o}0Vpa4;G$C!|?}{8?nZiFX{eZ$^?fnc)%yur<6X=iwSo=}&rfrkLU_
zXhJ?JQl^`#FH=snl{5XFt3<j<v7Ng`Il>q>6LdJWcE&DPulE@}?{zq-XnKDKP}WOA
z!W2Qf{PRCXBo%?|X?@_nK}jq&GymBSwT=w^5Xo|{)`zjawY>kRM1%D8iv7;?;JE|e
zakK2<N@i<mw29}$UG2Vdqxwia6->2hh8Sq(k;yg=q(u+p0vk&-EN{Bwb0<2d>fiLM
zHgdgi-px&rpT1s}#bt6p!aQcl5`;{o3AnXZh}r9cF)P8X{xQlQXn*%}t)<pZeSL}@
zd_gqJn_eG=1}}DR1#i%2)a34jKz^KJ#(`sv+3me+Dgd~Q?E((#9S{{};*$<oCia0S
zKz%q%5z!3Z5v>F)jQ_pgknyv>mg_f_nY)hi9>CXisC-8QQ?%(Scd?@Pn$3Us>zRuf
zoaQoxpQNJRy;GE)rK(#z7tQJ+evqltCUd4V@&#*|qwYiL8p`e>B`=Vd)H;Lb`rR_k
zl5X@DFT|wHC*KrO&-hrP8_n<De(AgA)V+m7+aiml^FMYZAQwYt$Je82PVP46Gb^c4
zZ-abIG0t^b+aGpgs*s03*=JZ<oal1Bt#qT%L#gQDx(BUu79`Z+EZ`}^m%1!*R4m)K
z4p++O+YD_oHpBV4aQKv7VtHV+=|8Wi6v)K;=*Ckb>LRXj<Ez#!p$<Xo%}pntl@?~3
z-^EIh@OY`MTa~*fvOB##9}4CbA>YFjyd`Bm{tY|@;+gl0JGGNPpQ`K1+1e@8JT1!}
ztZ=zgv0GWXZagoixT@6>Mz*%#bpPgd71T#MC+V%_weFn`l@E1XTwDT{Jiyq#yX&pk
zNyz?&DV9^k!(+*39S1~(4`6gr0~`gnCrDAE6o)`B;?7?Q{p!VIlyZ5uGm_5x4VGHb
zrY7`+S2VN-gBO$5ZN(k3Lez4(CF+Y+qLH`AlEH7|Mfs&%b%Q3!>!f1rX5=gotSL>v
zFN5Q`+T*lwxt*9)S;*T#V>X9~?)!^r9$JQq2e#ie=@*@jj3b^7zke_@ORe0*@rAvl
zd@e)xvfomYh=plW^^v6%N?as>+$Oo_9O63L%beRow=M}<K=6T*s<H7~Q5Q!_He8Hp
zxP(Aad=2oF!uv{Jc5v~>4fL1avZjL#R5{7jHjw?T;u_^-Ol6sj($KELL52j`vX@`~
zqyApd>e!SoYxLyIncSXO>7ws?vtxLwY_Ha<K}eWPXmY;?gdGr~?AkqeO9X}#ouxLt
z<H6TjZ*$eIf@z-V&mT=Gg36(2=h5B(+`~u!jB<n&Mra}Zukj8&t4WgFVjCDlz>`X9
zyNE5nf9=It@e)-!B{v<<TPRhNeo)2a#zx6$3$MBGHRe4rNQ?Mnx};3}aA$q4qJBNI
zvT`vvsO<+NSL!SdeE+--*)T3Wb5fC3jCOlf_aa+#%}Q<7q~;^67#UP7k~-*e2L_T?
z@G!rpKL_CSRr|b#jG_Adp_#SdXKi9&BAe>GMlb5jdJAImIy>hy2j9s^ocM>l6Sly{
zPG1}_(E#>sTj{Oy{xo?sE4Zk)!NXI2Fcm^%1KEFq_eqk0ujoT|#j?{gMwfi#j~^`t
zNnh~$64vjh80L0)u!(83wQjvn)Lv%K?ki=perlLON)o}~8o^EP;_#k*88`qp4^6I#
z4#Rtw2aNKSAHRW9%F1{D6xelz=bi4f57`hXqpj__#B~Vf{rIsr9TH#JR(nCad>I?d
zDOHmYOaj?dg%117j4ktnh8B~p+k|*~JERI>f>@aNYDO^1?~E9}JAwcHw|2g!nw?(q
zFAotY_LTX@;KI;w@FZ0>?=9-Whmf~wb9pcw%(iQ<L)h3p@$CXGE$%S2j)_oHFj#*?
zKELW~3B)f5ORW3P^lW8k3^6+Pmy=3{i%DDLaN9R5s=e^cI%L=>eJHI^#LMB!h|y(a
zOTcT(?n2os-n;EV92E2E>D~WXsx%G;`*kxAh#!DM1gXVizVq;Z`{Ws~u^cn%*}*H_
z_;e5dMdbwVC%b7_KM|8Ibsda|>R<2bYUmCr@M*NIcb$Axe2)>=Uzi>iIh~O2X<lJ!
zNE=tz){guB{rf#Ft&fl-nEI8aCdpg%LwUKVVrTo?dSrRS<o%|>d8!V|Ak{&!@O>tg
zjNF@>AfkPhXq2SUYaE{j$Lh?6-~RjWl6$Q8pT7rje$VrJR%zI|1c}Yda{hVARl1PU
zM7Jj#U@hxUrtk>)yJ9A7V4Fau_?(JOTJYQXs8<+*ZCdkoSj=>9&ijZTVuCsCBZ$oU
zbIVg}H+aRs-kczG{}U^+z^N~!{|b=9@6LA86p3_Y+kLRGvNaCQUnD}fzt0B9HZcrC
zmaydJh>zU0S|hN>Hq!T8zrm<q!!l20=*_HXykH3F!*<nM!L8yem-{uv28wMeARa~`
z`svf{-oCRKX|qLll4;EnaVp;3U$D|aJ5VdhnOkcS3i$-d(2xjCB-Sx!ScLDq6x8@9
zXJT^cTvzUbm%yKlorF_;86RVH2g{3l<_8Z{yL0w3KJId)w7|YF{q&p4!`3VZ2hF{H
zuvIX$)dsN#b9p$)1sa4Xv~FqJ)q8l%*uDO9@*rEgLSnoaklBGe$sX_CH#%JzUz42r
zvisjTo<qt>U!0C6mE-8zLaAAI?MlksW|B3sbu9YV2Q#v^Iqpk+eKe_&VeM2jzq5A1
zL49ziu_7rbduUR~QGP?3?w8MEI_qQo*{OVwA26Yu(tVqSlGW@;7s!7jOsGexpqjDX
zui8!C6H-|`WB=#=uf3+eT4P3XlRqc<FI1!wg8C|R@vA0y{<mBqsW4k>DMy?^rD*{Y
z^_EvwT<QqfL5bR#AKsqM^nnVnr=I!XbMo-SHmb#*4cm=*`4Z2U4ION--2_60jfnrF
z_4&`0-jFhkQiVZQ?f&3GM?bTzI1nJt*+{;S55`q}w<Uq-(}I~%Ubk%PoHnF}AM6Tk
zf}u>|&u=_35-eFJIVdZFd<^qpj~il|1#Jh`^WQH2c{O^$m5~9%RFAedPR$%58f*J9
zJz73fi(WD#85wiM&Z#ugjzkH=>9I&DK_Xko-mcnPm*RJw-GW0G%4{0X+G6l9{_=Yx
zD^q~JU}BtBNH>H``G-yN{0Cn$foZ6#FZ3YhPq;kjImy!E<s6+#mIMg1rbB7)P%m5u
z$dBWXX=xjfz!p^xHQUd<%ys_{L#5I@JeADzH$xY)2BO<f?ni$bZ;7Pvp?NnwJSktl
z4!nE2cCt`h#{O^ooUvVQ#*m!{OQHwfJ}{TDcqT$b2mT5BOY`i;^@01<_)Z5hi**tp
zMpP9#Dm9G>fz5HwttusCp{BXBrXxwewDZn`wguRrGOc3QnNQJf_1pglH~F-_=h)))
zu<Y%^mtiUjyVPnx{71+OPPnu7MLFpnoBeurnf<J^oUntMcIsc>Fh5@d%Juc48P_k}
zZH0CB^d0_@VFzK1UV@9N;DH@F0@Svx&5nu}S4&IlV!E&KNSoAw-fJPh`|jS#Eev~O
zj6VcCSE>6WW<Cde$v6wAInIuPrx|zzFc}*+HI|#M8l&OrO2qv>6?bv56a;px3UQ>d
z!QMB)?R_~f0qmaOe?t)h(!sw=!T6S}51V<bL<y@IUaeV6Jn~CA&zD^Qhp_o(0u1Vd
za%wR>70ziWx>2!FTN8x4frKR3?;v&YAB_v&Z#XXtlI=64Bt=AKO|#+(seS+-U)%Cq
z+*+O4F(9_AM_jifge^ng*Pu)AjaIvc+u*(vB%MBr8kSg<veOa8_X!il_w`-Lj-(Wg
zgoJ&%h_{7b32ik>^|-o4c^d6?)z^HLB9XL6&Z%U}k@;yL`0s-E{a&a$SM|cx`)DWV
zOpNc#Q$KjL!|=|bOlKO{Jd~Zh#C#wLh2_=ScyuTWiQ&_5ZqnW!52PAiU=^p%f;9fA
ztgD{Wzqizge5h4@LKjyE4(3VCd<Q@XFp*??Gc2_i@pkVUe{zxoRx033%hx*P=JWk)
zud;g8)aW{;9teCU!2F(ve07~dGi3#LdkAb0oyjV^uR&%F)PM5SDL~e%s2xvn2K9Th
z|LIRpix*1>frU{Ng!uHAbQ*ZY>@j+5H?YG_V}+7pL4<tg!olthxwYDk`qt4pEYLhE
z-2C3c4qR_z{>CAAdxJ6AtR>6vx{%ec%d-zd|Ni|;h_^+;D4B(WPlCIzB+rL`5l#b3
z<^ulh)46UHYx>3z(<F#s%CVuimRWVM^zGYS_MA9m^bAga&%e;27~FrL?j;?$XRF=S
zC|P5n+{Bt|KB4lY;^YXVy><m|JQEryhWHObyYz^yUdZP^xmyW2{Hage%oa{$-x&t(
zesZAkYgMF0L&Us!uR)<}MQURlCk`$?*BGHv{4o1OMrg-5(N(*-^mO7~bC*Af-9C(>
zs|zV}qzG|Q9=5O7RGVxLS8{a-<*B~uHl87BiU!@qft&D3_@;2=WU^VSfpw`3#4k8(
z)BshiE$+oW#@(oUd|r-m$E1EKI5UVktkJ1GPod+VQ?#yrvYSeYu@}f0KMp1gmnUw3
z-!1HxHnEcJ?_xOWYGLPm>B9M6k93xvuJ2>}I~y4c^h`O!>DxSaWMn2w*T<YiT_)np
z9}nzz++e)GpSZWTF^u03(K32HvwC;=M@mB4Nd9bn2r0WwjjLkA791U`90nTbv&MP;
z0oRG-=Md@Kbn;N03vGnJ2~V?cNuNx=(gpM*TY2YQDoC)0#iw0jn_%2O=b8x%j-oFX
z66qn8b`=6co1iASTH0+`fN6{en~gCHhPt|$e)}thQPL)Pb#<~XbA8I-A2s${fNCtp
z^`44roR?2{9qeuVg|q#7=ZF2IznnQodQLbwK}@P=sA@+x<LY)~ky0$T=->aijW@^#
zNEAiqO9jDC^UQO1qEVqUStbo74ButcG%(1?t?r{*;RPXBO<P;LcWh~<J2ST2b?)qv
zh>*3G9d-LZI32c`<K@JPj*cg*|MS<cGa<!X+gBXZ`%PRs>nJ*frs$6$zeKqkN+BmU
zE=1cfaZmV3F=iy;bp|U^hEW;}?tKbKgGh<~&!)x5fj?q2D`VxBHU{1vC#I%Sv$^%s
zK6}_TA*O;9ryok|o>tAzeH%<N^-x%ov&XvU4CPZ3N!z^}N%+1DP`?JYZ?ayfLZcZ%
zvZsr@def540pCIVyvr`^DUM$>-a?$wS0u&iPCXC<H34W>#J$AviJ7}jH4xnaMbicK
zw4BsK)B3HspSv9h|JLR?yCK!=o}nuSCGwsNhdO3_Fzi6IvUaLIe`~eW@z0BVA8kk5
z6P1d4v;7VTvF*U>9{V&W8EDa~{+^GaYh>*@a0LJN)X&!LE;=e)Th8gf#j6WD(N5dA
z+dR9Ym0FR6#W1vhBviR%F<EUDTsJX{j7ni=rTA9c6gs7(a__?M-b(`HEQD)7{k*cO
z0>U$m6Jzx1uVF!&;+8YyEkg&3YFvJkl<N0<&nz>%nBGZ!8sgghcPymAJKGSnG3L+i
zpt{7~8`k9ASgN62ui0jFWA}~#4$Tkh(sCC)p|I=1FXs6?Rtzp2{=sZAy0^U+CcI9s
z1hqkYw|^#0E%+V0{$HIOn|{HG&4PP1BeVN^JMSYHcN)LE4`*EHFHsS5?P63@Rt_I^
zv-*`KXiZ8ldilQB`dmL85OlM<t1IZ)iqgq*!<W+DP`EOWkGLwR#&SP?`16Bumy?n2
zGdN-GU?1mxq8MkR%jTl--0ziC$^Ff-yv8xVYTv!>bTxLjUX$(porSep`~^DOLOwsH
z-XkUCe9x%_F}K_9lAv7W<scXH+PJkG`CITSUp(mjGU0|fWUZD9gKL}@6d`6Hw}3v0
znwyr@a$>wc9o|yN=<Dl?>YjW0l(zU}4y?p$RN-MWydk8Fzr+?QDFu2b(8>TNTsCN%
z;JY0a6|u_byD0;@urZ_6kY9=k7Y`39;c^^Qb%AS^jS=*sE6s(nvd(bwUwcG+eEch{
zItj08BFl=G0pTsLr3fn{Zl_%}{ftUfwFnL8eTp_dQY5-+4*c`xBqm;I1j}$`243_P
zbMv(oZn)YiT)%9Bg-jf^QQ!U4awWuao|uddIF7xFYVVB}5(*-&s4C>+*K=KJ!x#Fu
zwUFfV1WBmi+>7Mg6qv7*30TPo(de@B{Ic#&wS%MlLgIW1K7p8v_^&)0fnBO|*5Y2K
zZBc~L8f<@TI5PRIUuQA{OQ~0JnMnw{&(H>rjDHDdbonjsJ9IhuH0{{c?^pu0c6Ij{
zsM)%U&W=~g+YG7Nyz;)J2pRm4oq{-fd}*qkk9DstMB}Wy+pYNZ^e9@YH}7LhrjlgW
zxZ-)a{e=C%HuKGrvU@e|s&d<g5Ek;0?n6Z9CH5jUFbr^Q7$R{2RC8?OilT*BU4zg`
z{G_%!f9<Ss+KgG{PPp-|YHAZ6*lcb#{ZWL+y11oO0`U_l{;A{@5d0*SG*pm^D`R;#
zjLP(YD0kY?uQ1_&5Gq`*oQH^R^}BMJV9VlL^&5cd7hD_pT5ExAX|L_PYTM^QM5No@
zz+fiwN4Bqd3=;R5zZSINH?I3q%3$KM+bhM!V6(e9Qj0_0IN4Hi<7A)Bz~<eqYr(18
zUju<p=IU3tTK;Q)%N(}5zu71yC=MrfJQHa(P*<nvY#6Evdv{_L3@f9&qpjaSZ(QA|
zIcVve$#b34@mcM-K`U7)oKl5+ay>f<#))#3Skg}ZyovcfkW-)!!P|YsP8HP>o7u;;
zt%8Rqp<KvIlY<}gX4u;Awd>umFzIWbABCX5BFFlSsKpT!fmNQ=1!dH*F?`KZ2U~Gy
z=V7lbH-2~jG5(;fTklCfpxo`%pDHhgV*GZ;7<uahYhj2n+&*d`fRHa&jMQR-0mun6
z5ym6CLC$&4a>y>0TVK|f(Q>hI%K7`8Yslb2F!4-1!_Oz|w3_7HJUl(4^&wnI!}MaV
z)V5YV^X@+;X)&{>#mjDHBpE^Jlyu@DJ79C2psfc(MeyGY>(!^gKw#Ylg5e2#>i)lz
zhpIY>?;5F&`aY<NpL}*~e?<C>rfy(MZE#HwjF=EiLevY`h(JJ@dhz{Z<Zm^TT{rh0
z?l~xboUvPxS=`_~Uo`V<*hMbHnb@nwaCl=fl(HX`3XPe{cB=wpD?qXNpsm?#=?#GC
zBAS+A0OUGBaf?(@<mSXMRmIhNq4oCmyPw(US?TS`Nde{(o6U=#4*o7L$<giZq9R8S
zTiM`qnetJhSgF+c7%+a)W$a#?rnC518+e=78b9RhdF_qb=MHE5hBXc(Z)|(GYRtX_
z{bpJ+BV&WE`25-evU|qv_l$uaf~Xj_z@|Acl_iI<i+|XV`XsqunD#+1eN-mBTI%aL
z2Jg-NAJNMj7^VuFA#1%`xrQ~q#++@bs&a6qiIvsMTM!G8TfIH`YP8k}Ou9&<2>Nt^
zoxSl&E|cm<Uaiu}aF=I>em1)d{P@!EALGLrWe|_}Sc25=U}w0lnyt!njnCSy|Ew?3
zrOqv464G)wR>29BX6bsH{xW??r_ow5@a3>}Uj(;*`qvI`Qk?L|Cm{ti1#A}(xO@*n
z=KcS>;uh*Qr3&Z!P;5-4B?SkK2NTh}8;h_qA-Ku_isV97$*=Z~8jxO!Z2EuQ+2dhn
zXV0tq6EBcSydib4d+OZ@))MRA=Q?9{cU?v2KK*p=x_bjp^rzdxzU<7e?5oZrH9PYa
z+mO9vrgdg<b1YKm%~)>D5TlF0XZt{EC~G$TyHN8><174&%{U~r-Gr&zGEZs)@n_hj
zL<H@{<w8h)qFQ1vIW=h`{07TiXvNmO>raNECD%VE_{pU$k%ueWvDELtS56m1csd_x
zA`HcuL&}wo$s&}KlE{oTKC^G%y$mKITDC;R&ZwWX2VVUPK#o8U)UUKQ=QFZnuuYQ=
z%mqB8oZR{1S{Z)-%%j}{&A$hX)=%6IMtVwJ3~n>s6G<L^5-_Hh|1i_`l_<v_NfP>P
zx26<fCjt5N>gD9JWmJo0drG^Ch;tSsmLg<~Vl9Pi5+tpB%{nn6#dfgrsr5%k(2`tt
zhB^c-Y}nHOkxT<ERyl6{(`a#Ai9RGPAzJ41_b{ecRMZxSXj5rRkfnqDPK9K~l<d-*
ze7p};(~3_N!-mmgvJ#^xN|9AqK%izXr2=*@(fnka-j)74bIU74>J*?WFg>IL(Sazp
z*8ku#*<Z&Z{#o;#h{3x%cYb9FoS+IOnx|MVn-~C(wp1p_gA<a%GL4gyc-vLJpb>U!
z4*z?5;PJCP%@MYi)eRxrl240WyLbz@NR0DR$m26;<JPkjR)KYZQp=u#UK51-<+d>M
zzHeVJC|TjDOD4HJnNW9$x*>AdcZZRAtPu|{LH*7h#*>Dniz4+-Uo)O<M*3YQ6=4TT
zR-J5RpZ@ngQUhFPNUZSLo=OY8=D!!VYvA}THMqERaQ^dVr62Q<LO>bns;cUPnM&99
z$A-RJsm5aNIgePOCSYgY98?6eA7KJ@i>A*L>@{4v>oKF72TPHEMK=a0>Z!N$8-LYs
z@9#jBz$c!1waqJ}P`HkAg%>zT8S=ptXWBl8GBpr$W_rdf6<fgzBE8OS+Ck*!G^`>N
zKm#dln3OL-mSE}xN9WjeyGHXQ8XOuhzQOe59{C<+R@4)z@3C6;<V>d|L>3hA)!RTa
z3%}!dQ&jiK{t_t}lg32G&KP>JX93L+W=~t(5=dD42>&9iZ-`k_j0O`^Zx2VOWTeEp
zg2E_ht<20FNVWnMME1mKh!M<re*Ok6b|`QVL+^afagi1owam<O8tUq_#VVpxrb>}G
z{?2#G(*Yo)#uw@x8jDVrwWyivO;r_4XGZO$ymK@ZhnkUm?QoVcDVO@!t14G!`igwM
z_w`hy_2*TwTwnV<@;#uIl6CJTLF#$RB^F*y6>30x(|7^cfh2@Ci0f^T(f%pn*WktE
zdr|>Vem>1&==}?#5*~Nk)YO%^q**~ndAF*~G|O@@swB8vSAoB_sL7{a$3#AIvPoIK
z+7z<9pWiC_-du0zkcFqD+53=wBf1qwRgexEz_{cD985K*+wXZBYBU9Ncqk1Gkgf1e
ze0_X9=|$g@ZEy-)wYD417eg*-oWLFNM?12=UUSIAXX}~F4ii%K>cUbrCQnC}ZB+b9
ztNmAdnhVJIAl-NZW0vKhsNS7)iD?a}IWU2dJA>p+y6VH)X}&aD_c9psv1Sl5pjhQf
zd51@&wM~j@E0b+gmQ27^1fW0Bke#}{H0HCjuH%vM3M6Oqj}h$MA^2YFv#D?1y!l*a
z`70|9IFif$7FE#Y4^|961T}H^c^c?u!G(wCOTw^`o00LfZ+_&C0fZ>kTWRU)(ouw-
z<1_u(_sNoSS!Z&5++wzOg}4NYnC&eb?B|XaBa@F3m5J8yO_ytzKK*$BAz!+l5ZDoF
zSkkI5=ZMLbTF+qE?XH4BL!BJlsC5*<zqtSf$qwyJFEALIS*S60sw_JnC&(aI$n;L~
z$BWxWo;^7YMth)r{zuebVt3Vgr#|pG$2ioW)B}IPom_((88{jm8nh>HQDzGDo%Hnd
zyR5Z1r@=>ZC+&6uc7IXPb4@lu(mS{%ZU??&{-Nl^Gk(Hf5K~ycq|jM1>`UiZ0~Ahu
zA_~mT^28!H-x^<!{c)y%_B<x#s?%BxsFaigY9H+>qu@kw5>G~9i*xqiW@4ZI@~HS>
zf*b2%4U!l(4r(W_-ueur^!dNr)ek%V+z4JlbsWhxcZ5{tS8_k|&}%;)=IN6chp<>U
zzw7org#FPyv_m&Pd;}^kQM$K<3q=C!Ajsk;@NWOl=tW4Xlm6(i{(=Q<vk&RS6-~J~
zDwC5rixcMae&6iI3U)qO3_K3Rmg4bPdH-s|Z)PDic<%YvLA5@~l^N5VKh&4qjnja{
zf^R;q^<nNfYmCa)G1p43uv|lau#GOT2RSjmAuIA61M?fIj8$)=L3Jm3dgoH}8LqJ+
z4<(o0#pIV6FEB=r8%<`DNEmL|UY=M?dbu<<KNvpz0G(v^ZE-Y&k-B(qv{u2<(b4&r
zwmD5JoH$KW^SWiMt>f(G-k&fYY^fyY&TlbiH`g=;R%hC4OQj!qESZ$_)4SZN1d{>t
z*ouowV$@E8<5ON~3z8GTCL~war@J}-3_uuNyZu&UG4VI7Pr{<EUyU&7wJ(w7olMTe
zjT$^+%CD~6jn#8ZZ<RX0PVn2uV}6O>(p)2y8};fUz#8ho>4-8;NROo@&0n#`$H#h4
zEV#RpbVFm+rXMPcEx$<mB7S`Z^Hq^O!D7?rNHmw%ckU2IpQ4rUywwcAHoAC?#A5xQ
zF_FCYzQ^jBCoRU;SEMO1`~p(99oK4}pZ~L?ciEoNeB)9SD;!?MzqkS#e5mIz@rUji
zCDlson$zXqYeZg6ndh9NhW||UTBLvwR^(-!&d4izf*4BFUrR~;o>xVfD6#!)3#k4A
z!s6~LHaygI&tbJ7>2ak@@0-4TyIw&1Q<F%EhWVe#`!coVN4}?yOm3(m$+qYOW%MqQ
zCb`T#oUJFIYF<4B-RU{p;afMB*A4ns>Hl9D_B&Ra;p%>}6E>hqQF2`lM(pNPBMJXN
z@%rBKtH>8AKLWQuQsje&9BksB+s#nYVoL<ZcxRpci-fN?c=KVXr^eWjZ!-9CaKdf#
zu0^A~0G!Cx^d3!l@y^7Fme+I{r?2ad2)Vx<8W_-1I<*_mNt<Y2M;JT@<{itrpeF%k
zq=6?A&aSwNI$t?4Qjf<EV&iBj*c!X8g{HP&dB5cW6Nb7^hb6%YmTL}nYJ%rRNG7$8
zjgw#24EaI8(!729cJrc925!jW?jz3GuMfQzeKIpLh-!q~zJ$y)NqKMPF|)n`s}dA_
z?G4>oy-IrLla-ry?+)Y{{2d?H5@lP#+)Y{h14>5y(<GmD%dWkn-3bJQZ!8!is>n&B
zCL8b<WZdn~^V+B(>VI;pT<P)1oqq5J7`MGNwEx^b{Utwmdhmx$ufc}Q=0c`hpvJES
zy>>xUN3F$&`_I|_cz|W-#TZz*i3#VyZ9$_k75fY!T2uDF(++%wpPa~Yy%=}Hn8n?}
z_k4_L9Gm{?{=C6nAJS2d76I1-CE<xX{hcL}5$?mtX0&}Gi<`EqeLXIdEO>?od}FlR
ztgTn@2y`I}MHGLnTV5x~vdS{xqy0+`sl7A@J!9E(qt#d+e4`b7L?#5!{k3QHCfNX4
zvo0_iCBdIAD=Ujx*a5p_qktfz?XH-X_*i2)nW!f7@Un?+5uX9$tH!s1nb_BL0He*4
z;JJlbkY*<tf*H?~=2-lb3K`v;l;pP?5}#OlwLp0(*)r#z1qng?T(5)as0pyqA_^A3
zW|ZYoIeV~HZ!JZJXX1N_=d&m89Bv%@%dtIwJgW&Q*%}5L7HSR*hJ7~lo94i*F_C;j
z+;?*nzrMJCE@EbBYildu%*jB_oBzq;`vR~2s7yD;5f1SYGCLWJ$@ZcN0b{GA*01nM
zn{iGrku1uK)@Z=M^lVG|?FaBl&Jl<yID**rGL}*MLhqcbF70J3e`kl)j<-qL!w3Co
z?{!!uc`q5v^_K`*`x&1+-S_qHL*!V-p==-0F1uiw>YnZ!tz%EXmH5Pj*x|m6E_nM0
zZw+~we?2?sFtf${;=2Ye9zj@$EAj6(MRr<t9?-;uSTSWjAr9~U{=0JKY|ZvG-J$o_
zLD`;jdQK3RdSl^0V{Z99>9*UnyLHy!btu{VGI(-Ew@Vx8iKBamLPw{jZRXkFIlCH(
zu8(bY20=HXNxWy2!^nDQ>Q%bI`tcuYRr$D_a@G25-a(>J$f<0gjyquFH2voWs$v@R
z9vp~!%E>U~-Z1;0g)!vRbpAynAvaGs5W@0UL;642`jE6Yrao9oU@;}?hd7q6-px=i
znnKd;{|f$4xAJD#2EBhXRh#e}mEmk>Uy&8p@bH|g)xUOQhZ1l!1wTs&IW;2CRU6oV
z7uxc2_Z@HKlh>2PZ(!N?<r(`JRTLKsntJ;#44r@L={Isk_?6b$!S9Nl(vRPF{dRL1
zLrI?U$q@v)UrpvzU}E{BADtX$m3h5yBEyn<?VED7rOkr}eJy=`;YBuUMFnjW<uSz?
zwCPs;@lP!u4nggPc<dqUo2|*zCZgVcetAxBX5L)AYHo|^=vi6%w={CDwXD^pHR`HU
z>st9xV??@!ymOY$zo}Q)UWR{rN{WBIvm9Prv^RbuFC&9RLHXhyr$T&-*=RW{8{0$C
z6XfvgSo=S0y#-j5QP(yKqI8Ee2nr~TNOvoUV9+HX-3<Z*(jcXz)PQt%$4D#PLpKsb
zcXRgme&755*Ewgd3mAkMe4f4HzVEfx-hQakjK~N1HRbOkc^MfrRyGxoPax7ZHpTWw
z&G~=qdNe+KICu6c9A_1)!^FfS^mDZ&pdO=BMTsDw-EI}B#sGz=raD15!EY{umhc!B
zmGqn(boIh<F1P?Er@nb^(RSXJe{4_BXxL3ih&D+zs&)MI*8)VdN%{5m)M+)j*mTRY
z{wAL%X(=#llrqT5SpjNWzlYIyi->&g3!S^?wCES8zsgtmq|a6Kg;Z_+dR?(!pGrAn
zV6&2<N?+h!YqQ>UCJHysb;T9%K75kV*lW|2`o-rW*h901QAIm4BD7;UA?NZ%rUdeW
ziHP(XS7XR&Mc%H!Pkq$$xi{W4pO9}1A4-*Eb?mm?mt$hejgEZ^p@)H~jx+j-T(cK5
zZX4nbMj>|H12SP(ypd-dM#hY4dsf*w9g1i7PS+Eb!upw0{HMi8Io2uY=7$kZPDM!@
zuUWLt)!4qSF`9~=m)O54Z4#6_m?kFTi;IVd@10*y8s)oayOcf~8w-K*g0`Whw~`}o
z<>Ueh<Eu2(s|*aPu^=ibbyTiV;nq#?JzGBmaQB-`#XcwMo)(sr;F}Gm9n75IVPZ<^
z>e66iV+SCfO4N28kra}Ey^ovXvO`0_LtEQ-Pnq!FB}=T5VSb7Cd}+v^TyENLHd$eU
z174NHCyI#zyI#Kd^+02_61}TSACFO!{o#ujFEC*mo|332dJWFsAn_8ad4(iqCfgJJ
z7ic@6<iaR$=CnOoj+ULB4QXrv@85<S1^Q>-rBI`gk|(^BK!EwsU<z5;Vr4MxRSETM
zbBK3G;g;VBT+`Ij<hYZRQ!=>s3f98Bxn6N-Nux$NSv_xvemfSc2@B$yqvW|ZHN23N
z3M^|n^W-_t<wuivq)s|peiXfY7U_S#9hV`@mtjbgXNWu$D@|-w14qWP{9pkCY|Aku
zm{+nZ-HUI|@Xwxq{$1JgBshGeS=4i8dU2-dv*2?eH&KT=GI+SxCuy8F^!Bn$ynjNV
zxy9dJY-dSA0W9qEk?||$QfBw<I*Q%s1(|xY<&Wd8RUh!2bDY-S(CuZO)@F6$e4W4q
zd(a3vpI2$v5D{5qz^Mb){z8~{^O~AoyF+GEkUKJUGYP6=h`Mek?l%Snp)YyK$jGRj
z@h11TK_qUTv~W@3E+aN4Ar=<T#P7U{7fS8+=9jbDg7M>6Yb?yo!FK5yP{WSyZXBtX
z$V>T2jmkzyj9f<{r2Co9qs6ugn1PMRqZ)UU79Ep;idx@HG(R-tdvkS$6?aTS8S!>#
zbDH7B3sPDU{nU(!nJEmN9%X?*oZjl{>JhZS-UKcYZ^@-PXp`g8RHaz}KkZqi75KZg
z3%mB0`+sgxIua1cv18<(XS=9F=jjUKy&2cn-@jk-kE*dS9&&YWIiaY!4f_z(uAw!c
zto3aRP)Y}wTrB3qlhVvSB&kGyg*IHX_mrs3Nujqe&?-SpOlDaAJv!ss7fFw}j?_j1
zB?*z_FZ6_L*t>&VGTt{_BQ<eq%aVStwakYH;4o?xvoSbg#<Qw<<>F5&FMKIb&Pp>d
z8fnoX8^TP`zTXRHbOX>*@_6Idsbn*WpPe7J#9SWTel4x&%ElVMpxMJgG0NlSXMV?1
zuKGThfp_Ez^UQ#z@JY{}j$pEVp7O^>@7^0_!zCe6-3N5o=|x`VX63ram!eJe>qGOs
zp#@{RKI}T*f`LJ*Gd%gpOhmJ-*ZCp6+%KhZ{RryQGGQa4UPuP$n%gDK!tHgP(>i9A
z75sb;5r{(`P~cW96-CEvf$Qh(x8UpBMfC)E%U$J-W2@-QQx@SZ;GQF^7-dlHr-PQ&
zMx!}*zl_SCLUKnpKfa*yZfJ?Hk$qKaASd?#oq&$<I6Eh&D^oF47WsfbM#uc;*PmW9
z#}LkocpN@iURjyjB_|~GjgBTvnAvdNnXPf!)(m76&4VL&%!fWEsBI+)OPW9b5&eB+
z0dcc7PU|8}d;GciI6b|gK^vP;ctH25k7UN^W>$1=r%~%#Z$ftR9g9jD=_R5Ls`vJ7
z2BWCCgn(J;0{Dqoi~1>OpgT_zZgDjm_`p`f!e|+>>R%S7^u}-u^Df}$T4g<&WbE6N
zdiByhUv8NYZudQNk7~=f#&~X{^Zs|f_ETY^vm#7-RQo`l8&|9{3?l5bK9w9rXY}`<
z!S-M1=_w49f+W{Id^IDiP8o|B)=ME={5{NS!TrMvWe$@CRr-C@z`k60QIgbqCFRh-
zDaW^$GYe3IpeS{l?r;mr{%L}Lj?ZZM`4G$9x9d@&{z5C)&fcWQOHDfAx>}>;FKC~!
z;|}?6uY4DFVdp*iYlFA69xECbBlqP_PGFdZRr#<+xpE(1Go!&LMAG3`N4;5B59K;p
z0&K>2`zP_JsaR5#=1++?>3)$VE7t`RQ<H2S+da;PzM7mMX$c@`UK8Ybh{Aq8%A$FD
zD+9TjVPULr@;bFL<4;aiuW%wIC0$Kmbp&4ZHUMKzOroT)(CQGy(9!X^k+J7xvDgKl
zOUmL|N9fAPrR`h;)=YiUBK)A<vs8b}TMdVxtGheX07jZy3Z1e(-M9pY#^RJNfnMs6
z$la}>y~3NZO=r$-z5j&!(tBQZe*gUCas<qz8P=D9eT%86l6KBP#hN63Wo3oOcJ|zA
znc4N_%Mkcoe&EID;|+!zujP*M;FCy!vo(UJC_MJ-6#UL!l0?*nDIDjAYrSC@cor6D
z-_jt3z5DCgN(rJ3Z%(!FcNCSB0tt;A4#tOG8q2*(h3Ydf{`^Y@*YO(Ejk!uSI(4=4
zK0a_Y^!Q}@bIbLx!1eH^sT$GPE~u@)^Pc)u=p4~sRi^R|hK=~f+pQ~a5TH5UHSb0m
zoRP#w(G=fHPx-P?-jkl<{SYG3{pHJ{RJ5f(C#od<*32(nC7UC>pUH`Qm|qQ&!V+$e
zMGS8$$UL613-6i~{__}F=VEMpTQ;v+3}1nTixDmx4fP*n<MYHMv1jdTWIG^rU##8s
zk|pEyO7yjpCHLpLn$AnSyY#r}+RKI#&=e8YQ1f@($VS{ULqD<FU5$GlMUv2iwBOJq
zu;OmlA&y0oo`S;mxH)Q+|FbhraP3wx?8OWp4sXEX-kwB&kdSe}mBV_Ui@V`474%L&
zBxLM2iw*}Xt96aBPO*CDYUN}3aQmz4Iw9xn$>H4fBS$GIsW#s2t*ydA$w*oe<{KKy
zXDvR{GHEDTSdcGWgxQ&Sd7NR!X+lo&M07MFt~4Vf=nc3&+U#lG6IcWU<Z1OjcQ@mM
zPw?>Y+U^g$dIbmb$^Y&{e*~)ZKiBvXf_V^BH*QI0nq{S^UZ|F+M+6R(xQv^*Nn%`_
z%#azCAl#fNZaj8UQ_FUyD*+JC==Ufcf2>5heG1m_8xG9L%G^6s8|T=R6n6HRLVW!e
zFD=ZMJ++S+EtM}%_?}HP!>lU@chtdc=B-!|e|Phxq^V%;Z?T*>!Oz0dy9cFBE%-2>
zeZ8i#4PNMUFO`7grN>S~*H#rWQEd5Xt&DiJn9jdMaJ69APJtfqHQeh%R)5DxDcLK@
zCN}<LZp`O=OzH);PgxB1cC4>m%auQTaWtBE)c1$dpa093kmpooi<?+&d*s)fF%R=G
zCI4du%Do4TVvA5u0^dVA#YBetZ{<y@nLOhpG_F3cd_B1;vzDXVO}j?tw-MTK;qE)Q
zRn_vScD51Ms?^bz;IWDxy}GB|uTL~QFLCAO)_q0L9@JHDEkh?;rPAh{o-VBk74P%#
z<rWrxtr-s>M!?FaH@7v{H^Es)-hclz2B7TRUO)G$>XC?X1NnPvxcvz`fYVRYZusMl
z)(6=p@*ga%(y&CGBn%Cy8eWVr-C_KuW!bA%+4sCSG+|g}*~3T|Z`}h~I?E-JK}La`
zE37nAzZCvKZ{$5HDr(5r#!HB8xn`CFIUk?VA}qfP<3AAqLGkDbBdnkxzbjtMW5h>|
zZ(QF-X8KPl3lY%;=hLT{2M5cq>p(EDif0YbDA6T~cM(p_q25p?vfm!dk15lA`*!Kf
z>XFa+{?VX>)n~~i3j8W?geJY}#>wY#4ARIMl!);=-F|Cx4RzPC6{na%NApr)_ruk3
zDOBN9{H3M&LE+c3V<Ue4GmM^}gUSZz{Wr$YhqCchebU)V4|8i^x%%G5sigZeP1TsC
zw<gVS8=)XH0Xq(9fCkzYD<%_PZk)8JEgr?|FG$t7>fBL3Vt37p-LOT6NEStYqz_rw
zv>{Se7m1A_2pFU4Xf&#Pb}v{j{FWXxxnX&Cgb`%QAFK6s-2I*<O9_Sk4|3q$+|3Ac
zX_@y_O%{E&PEac{H(%aEzj$?%(8J0*uREgo>L8^aAICtuFfS)p&E8&zA?s{B=U!)r
z^dVMy(x~K=SoU|BT+%aI8a7<v6?cMP;#e`popO?tFPuMx58?E7R(P_M2&yZA&8o9@
zlg>_JSG)^=QM#WMUjcCx01CYY+S4j6M#co-i|KGgpv%R@f+svNcokJ3lLs3WbvJmN
zUoNgA*|y=8W(~&m^&f{r{j2-1Q_1wgBaP(6v(-N_Bf{PLX^%bJOBJH%k}kDAtX|0a
zH+z2dF4Ks2rcugp@j?NVE}~%LW%&%x=Aq3NmzJ0aCKgSp+3>gJ_+5Oxb&5w>R$=|7
zGHS|v1(pRDrXz}E32}>SCSSAf!g>{(rh}?<8ih0(;tOGyRoRU)vd(iGqbyRIHQL4J
zr!%zT{ZGvKli#YTtqqG?G6>cKY`YB_T3njBoP|@Dr6MNMjR1jslPa8_m-7_hl1F{&
z?x)+7`S0i#uTcY6T*@`s>%1;1_I;%hp#PvGb;gDhFh)PWdr_rOuXu2njiP3;`jVl7
zu5L;WhAMzO6~mdaaUa0hworWyqnWC;^eq&i-tb?bH1_L!En_|tDUF0(w~KZjtlv7M
zz~Kt|OpCu-u?_73V)zJX*iZWbU5u}5KS`h5pB?-~Ao-RyV|D16Vf3T)BG;!0-#7<`
zU_vT0izptdJp9ZRT5MFm&6c^?O1r+F-Hw7O;(syoXAU{dtU6{CYRjBwnI<PIGaEK<
zz@t&Q-<&p*DxLQg=jVOOH940vrsy#d@}|rUxUl*a3c@};n96wzohhc&JEPGD^Ro^`
z(U>Tnr?hf^7!DxPQM<b=m(&2093M^CNTj#ilE=mwc&9B<{QNLlnEO^!A7swIuR>O(
zI&+F7pOTxr_}Ds165ygTV6b-5EWyZVMoiLqHXRm*O(UwgILf<sc=$Z(Y#1RkXZv15
zgC%fuyJ$j5+`u11`{ufWf_F|#@`dAJfVnl$4nBf5ov%ZE;_rR&)yx?BHhmu!3IAmt
z?l{e*U^CO;BkuFJkJ7Nsuy}Qa8XJe;XGR7ppm`$=tE-=)W|$ZmcYsM{)A&Zjl+-99
zYHSF*&aI|$PNi*>+#1!cR;*NB!VfpF2EWn}diXt7%a<EBs4(hH6J@_#RGYmGUikQW
z!2LB88nJm)>9C#>T6aSLYu)iV$D7w`CY4hNyD;>7*;#WllMNkxZ)>r+OGu<AAT2E&
z9nY_-sqyyhm)Y6DK+5wfU_#Gp?C#L1`HS4B^Q_=+nhZe*oTV$x%TukMo7T257+6!g
zpuwYhq3K%0s7zpSy0;JvPQzLpRgq}DJVDt14L>sO=+gHd@;+RBl_Kt~t?hd1d(W3p
z^aWsOXkoT<V;GN}cWD@qk-E++WCSp)xkk7A+c!#yAH;i?z)@!b!L;S&VskZ80AhT7
zPQ}e)7G73T)I_!7(>R$q^}BS^8YF!)&GQj$LvKsPqFz*IlxU%A)6QS{0tsHB3hO13
zAkZa6A#E2>4VEHk46i&<^wHSZg5FKZX%7Ms&}uTk%Eq5?Y-nV^N6!ZPR={;{+H?`4
zL&_0pMf0bHF%JSMrDxT(Vl|x3?Z;hf(S}PVt;67m@+p|b1Om>?O;`$huB=%LoMfOw
z<zFUrPW^GU;V$PpIO<7&qN?dk!%OF-!E-RsX13=b<nb=~mn6H_DV<@ez?lJSVPE3G
zVq=@z9k&eTUvc62T*PRuN|m$szz;;(q6+jSESaBaF1N;;3^+%fT^0B%+f!~XlKRN2
zwX$0m6dDn7qUDFgaa}{wlRZUSTW!7p9;kUXT(D!GTeeYW&-Dzr+!WdmWT>9?^!&7o
z-H!_BE{Bnk5g9`jhzX!Gcxs2&wI0lg6dAzqMO?S-8*PH|m#;i6Eb@ETmjKL}tX8_X
zp49JGvAP?(|KP#1d$vqWyM;qQ!1xGq8&c)Cy%>xthujD!w6>q0yKk;nnhh?3jrT?>
zj02?=gj3%nt-=BQO1ldVE(|_sblqWPzdO%F3~~U5x8Pl?vvz5joCjdlt+WoP1)bPQ
z=8g*OfE?<PTaZIVZ=)Ib1INk!iXP%Gvi>^O5yjZCYvokp8a?Lk{MRV{BI%3#u=rih
zVLtHN+M2sFBKg^kvTz}E%zU{I;~$KNF-n&Qgh&n!D>{GAH1@BZ*6YBRqDsZS@CdCO
z3~Xh?y<MaSeo1O;agMcl-CE{l8F<0scZrFHU6{nh^$()k0Do)`I+<*Ai<+6b-P+nx
z)z%IJ9k9loxB)2KMje=)4e9BRIvXA<Kt9;q0R%r;WfAj%Rz<(K46r{J*pRBjL<cCM
z3VA02ZGoY0#0+?mc-Av6E)vs&N=^2#AGowa1L~S@-!ka3nE^_0VCa9%;CD^4vx=&W
zBIt1#uvG)@)7>Q;{lkY3dFsYv#81XIo!b_oSL!!UJ_iH@)Y<rl<nbjY^1XBcMaA{f
zwq&K2j^RVg+^Y%ronPC}l{(Ku>aZRkKm|nw?0(Kj>Dt^wJD6<>4Lbqci~FLbwhT~(
zyrSnKv}08ky;8Gc7kF|M9DGa<-Go1E98HulXwY|w;12;3@NyKTI_C-0&_G{I%IXBQ
zTguVO5k`VuV`5PkbSUKvU^vpA-^c`LSo4b>94i|B%C1Cp1`UzK@oPS2EnAc%`Iy6w
z%#i=Ye1sCn|DE@r`?~M7szsMo^n@e*Hbo%;>kJ*`5r8x~lA7;~+{RhmB0=+=H+eP4
z0D*E)!;vZhvTlR(Z81!ITg2#z1qsDduRAx<uHWIZc1g#DhBBRhZfW*>W)BdMr0F4q
z2qwb_c;jc+`udxy5nlJQP1p|0KupM;A%94#Fp$|B;4;9hqWGGS<r6!rII55Kaob+N
z(f?$q6}T}Wk;$h|Pt!a!)YO(iaFg=z_|a=N1{{MsxgVGX0a9K1=?6+sGDbfgC0&6}
zkRgD)TS%7)G(>Q^W)R4@460`9)_w*TPJgej_m*Bm#j&ItLC8m1Rj>Ur=v@t9^+VAW
z58fTg{(5`_`tSk}TiZe+C=?MIg`2|SPywn;Lc(-$QZ2fnDoyq`-C8L^PUr}Dseh-@
zTiV<Vrk7M?<8qp=UgGrR<m**XS=rSeVu7AKPKNk7gM(dRcx-w>X#MN`n&pN}rks7P
zeSt!g6)dIMjSH*n<d)eqDBsu?$aab18>t&Trij1s+h{kSIj>Arunbzf(&2EdEolb{
z<KXWs+z=PeA5vUBrB<fXAkU_+>pGXla<O|w?4aH*&f}n810vu+IE@f-vVfiXtUVV8
zhn$7QrVpBtd?&>6ixeoe2G7`1uf6z?5YJEOd8U8ks0qBOpn&yyOQU%h9MqN~=84Y7
z$CsCv7j64Jitffrw@H(w@294wJ0a}a5ldjsndIlshL-~E5nWH8Ib*(<w_a%S;B{{3
zve(nq6=h^BQQzwAqxmu@0n^3<r}hzpTO<R-Tib?B=76BBw>nm>DiSvV#@&(6=(=#J
z`Cs!<Y`Tj9t)>b(0RZ>-ecC8WdiuTNE+17@LLdO`Um_(~IXStF1(<}i%!#1qDejvz
z(PuW9qnq5ev+kr1=}04w=G+<&3Jp%=H8m;P+S^m<c!h+t4$ja*D(Q)d^avipUZ@dm
z+@r$yRQ%@#A2?ywF)tRZQWK(XZAWg3*?M?J@2FEh@CN8PE>Q7|M7cWvkO2r`;^^*@
zW$YTGM2YrEm*z1au>E8TCWa0<VfU{A<TnCTpRtbrG&0_Y%bbKFZ(87rZ>T^;w`z3Z
zPa%yk5{FBNjM6do(Li|7@i(x5tdo~t@7u1xS`Ng2>6b+I;=Uz9(n&x`Gz6M^+rrUf
zCyhnBJ@Lt9hPVIxlkqSrjpv)@p?nSF(3<-m0|*G8n<-@NUG5k>Kckzz?j4#92K1Y7
z`k5vV*7uv+uc<d8&5fR1IMC*9yYX%LC`I+ulvjx6)SMU2_I7fMgKy}XoS2->`@{Yu
zY_I1t1z12O{~QQ&0MPE&wnD-G0{`Z_vN`=MQVUYmbyRd<*BHkTaly77u`(wZzP)XA
z%XR_bru`SH7|$owJ!Ua}qB%i7KR@I`fZX+l=wYP<1{`q`CYd%41`#}pQimx5kB^<@
z775I8r-5ACcB@lk{RRAEK!CXULJJ!E!^*9rm1fVg-)SOt32F2q;&yw(nZf%hTH^7K
zIBe3#YC&YjrQnuy-`x|`f5gs?3u=2Bw7ee^e&nb8o_s6YF<u@LdDVb@?_LDS_4L)Q
zyLj_wq0%;LIy(H+H!L*kM}zRTPtO@RIq87tkXKUD6-vUAg#?0azrQ_3mI&G)K;cv<
z)fXGikO{H(rhRb#{v%*K6a<FwMuF~eKqGrhE0^NdN*g(7R$pJ_V>dNf^R!IYV|}H&
zCAn8Rx}K+U>yk!Va6RaGXSumM#Aj{RI{u3C`ACpK?VZX{wLhw~C4Y(d3((9Z^R6^`
zxUsu*NNj7Xe_$o9+u?jN3dDo#vgV5>%F%VR6|N{Qd85*RcyT`142Mz-iO|Y<?RVmZ
zD0-TZkR(Y-Nfh}ADyIHz7PD$?y`Tqc-(zBib5;C$CH3~^n-5l^f&-IxAAWs+6yA2)
zH-=&Iva<KLwmPJ+fCSRO1A*(2WND#~`+bchkfma~(raF#BPR9(+PW_nZ1(9~x|{XP
z+(lPMN5kBk+oAjRcfM^?MWK<r%mtL9?wG)p1A_6uyMqOMJ9k?%BQKRZngPa0!g|6^
z;q3>PJ^5m!sIf?gt9C_Zx30p`a)6e`QMEu$N@9a~P|uGdL_S_z5iEVHXCqyD-UzB9
zxv<J)00~{>eGFbxNT><|6c+M#3!=Pp`psL-AUVUon&7r#u&tE;(L4RMp&yHjHJWFe
zBy9+{0o`1R`_GWhizt0P>Lq5JywSk*dC4u&Ye8p(uWYb`tMtvw|HvZ68X$vpx@jm3
zw0(AL2{;38BiS9<`UcGbWp>^_6qL;j3{rRD_6D)TzJQP~HO%rllr2o3Roe~h>c~>!
zCCyL@rsr;nVS5D1XpHH@ZZ1r0?_8Np@uUanZQ))t#sTxt1aOK*i0hjHii|xFHv&Nv
zaZtW57rJqo4x*I9@*I*>77Q+NJp8&`Ur|_tj!WT7C-#~XDw3O<y8<#A(FEvHEeIms
zS&{+)dU8@TBPwz*Dpxs~vp7LzA18#N4fGmRv?eBMR@uy`yF+#+YuGXs?xsynq|$k^
zHUwKs^=fTPWKJSUu7w>>W<?%7LaCkO#|F$nBLy~%C>-64PD_jQ^+id1&AfEcv|_dF
z?!5-oSk{tS(A<X?O-%I7H6Eurv7Q^_?~$otb4Cp69|vy-Cu{oS?Fo{l%jB#DB!4bU
zO^!DBEIG*nJ4VS7^`?*K)V$~2t;!K>$7ju-+#41y>&l<3eC}gxKk^G8xH%NfsN|#w
zZFg?w=>V07rEP3c*OX_GseWHxS#Sp_DBj_{R%~xJ&RzT}0DojQLQiUQdr-}y>hs6j
z;&P&E<_G0Qmr><Z04y%!54@|Lobe|@&C5#^a@P3g<(oIB?gq{JQGl;q?}F0;YV9g|
zL21mL<OU9-LyP&d>WIvAM33cPRw6*K`FOlx(72-lQp#?Fm7jvZZy9N6<hq1JMZvuW
zKr)h9Xqhh20B3rtP1HkAG<K+j1`;>6ue-zR(LhZj$Egg1Gc&UhXowgfK5)LF5nU`$
zWF&fPCBS1v*rF{!Fg406I`0P3gSw9(#$bQr45Gm1lyK?0K!q57n2E~ZFAc=s3o%fJ
z^uCmR+-HB1fmDDY5<#^<PRuVk`-BcLTYvGKcQ_ON4rC!%^Huuat>DMJBnJl)rk<o-
zRT}BX0#~oEBPUiN!OA-L{C^JqsXZZiCg+ZO41I)t4^&isnbAvZy<d~C+k<u7)`l&E
zv}XDJ7kq4Cj*(rYaeat5Wv+HVpz`S86ESo8!HEt?EB2+oe*og6@8N*`cQyQAgHFla
zT|q*Z@1!L+Cxk>{z<pm&w|pvT)m_%v7#mb!KVKHtAxf}pp+5?Fs4}^&C%IpzxC;O(
zGbf$^ATjc1VLd^PpPTiQydDnSUJEiZ-b1Rtjj5R%8ztvEc6$z2uV)56JzuJYHFsN>
zh}Rq3C|=ByQEpy3MQC%sRpK7}$o+4z<_65ezqkEBi3Ww8ql@0FXFeQPXM1}NBC@j1
zYBx-UmhRkaPNM3~#{_+iKAgLKG{GJESkm|(JAUCd9sY)vFL#=}4Bcbdwi37NQlf8~
z9?AXdX4cQgG55fdDN-YqF#hW7mBl9KFrF_NX1<p7R7@^rr-?~qcV8p@&<7rlx>S5O
z(@2>?Td{*~cp4$(tV_YpaQ?<g=aTfM%Q2%SyHT<@;M%|a(SWF=?AR*EfkU-+&o57v
zgQl#5I*q#i#IUH<?o3y+P1o3bO}528vt(`rsVpmZA*`e0NvFg1_&z{UPw8Aij9PSq
zCF533g*&YeWau^4n9tO3OxKbZk^}*}ovk~_D-w;sA?Hl5sd@NMb6nb(Ruf|<1l6#r
zsxL1Ux4vFpejbMe1_x(?3SDg_RZn10kkMqBVVf`q+2y-;mv^;BKizj`v9PdO^WJ9K
z1KlG<#0^<lC%QCxA)ha<yE!93+3eZ9lnb@AUy`N;jUiw0X{AZwV2W7bK+3yRA9lEL
zNk~-956CT#u{IKSNSee^0*p}RbY?hiLqgJ!;a2(-bU5$0n5!y-Xv^+%$1nz%4;luW
z{l>lpjR?bh(cUlz&G4{cNJJ<&Qg$ir!JM?nKefk1WBNY2(Ng7E`d0V@6mIK~E7ca`
zD`g(5COyDSmNZ?{`hF3hWGXN{MoQ1?7MR13;<RKpfxmrJ{?I;`r);GUZy`bWyLiR{
zbW2OLd}qVSRzDJllqXes>yN`jJJ`71NX>O3?AqA=1F49G<~;=+tFQs_B0Zz??eav&
z^8Wd40+wqa;|WMkWV{Aji^L2b?JP9|t@8#6`Od)sOE~@0z?CX5C>{S3{Yy@p@S(?o
zb;Z3qYYWYDa|Q>261zI*2s-Sc^RuI=?x^MMsiQnWSM@qK6PQ_C;t<~D5Wa0`CKvqO
zj@PV*?Y!*v&23)UF8D2dJq$)h4W#mu24S<UH=(e!v?LvL+1Vb<7jee?()w}exJh$I
zbEPYy8_c^oEJ>#h4o0p0%xpB;o^&YF?90o~|1xeVXKwx!iLP@8lR(uIAcR1mBwSw~
z4Tc@LdA00q3MId0uCiijfdvFLl%jwE<Wh%&<?*l<%k=_g;GQHb^AVtD<s8gqsOosS
zgnwEeAljI&E;I_4l9cpyz6FNT3M#%s<;DsdC%X%Ft7H$W!^IvkGOnljxPijyxzWH8
zMPh7@g^#iOlZRs0EMC`ZmPM0g@3f%?pHYC?^=*<ZBU@$I4(P7h4LD<pUdgccms3N3
z?B~>0vaCqZ0>)N>M2l1h+8T=b4ifn+a=LApP8EN>pHjixS=*Tl+7{XK=b63fgMbvp
z4Hd||{_sGtmmuSPaO4K@@B@Zc+UPM6tk#`bg5BCF>$Yu_3|g7M8*6@Q#U6sCzIxuL
z91;N=A)FhN8IOsLuF@+Rbosb9Cv$-J9`vlVRTxvBBoyVjVAAyX)E0iMJ#J+9<FA(n
zZ6@eui^{CX!Ip@Pdzo!-{8M?uc01?U_SD$+x~{G|qwYdT8Rl_l=;&;BL6YUBnVv}M
zagJ5xR2l5tb8Ot;KFX7hQ-_P%waLhv>Z2;Id13cDRn3XRJD^-&M74hOZT%?u`gPG>
z#KnamfTkdt+lw@&zsWr+xC34;oH|gtPESa<sHVffz(5yFMmtp+GXap+QB>q^frlr`
zQ&!gRkO{=eJ2e^5Hz5U}%hOC$ATil|TfxAn?TnUc=J^zD#@lLT0UvczRNRhyVqVHQ
zlmhRg@2-GN-2Q~S`RXsAiWxI{??MHxJUzv4Z*?C3bC91_I`;N6U3=H!A4reY1`}Vx
zynN!1j`f3b&y=pcxiW+z*9NU-nYmTB5=zfVn#3gR1{6y7hK$ZGLpHid!GC$&NzZN)
ziYCx`WNg<>F$oR5I=XJAWg8Mim(q!osRtlLR>AG$T&pqH_#RRg2lB237+{{VAyZ^z
zblm+~jQ9pHhGs2@;B--1__(+o03xLC|0a<3#91&17%zon<wt;9KBft2`{86()@UE~
zVqh-DVWy;O9xX!4znv`jt%eU#_F6C@JxMTFB<F~5SE_wSYbUoQIyoq<kiI}~ptdHL
zmYR=-+Ix;q*z&l2L(cl0CQO3fe_sq3H2Iz<3Zm?Gw+XO--%BYH&vwTHs~-}|Z(-SP
zaDmnBy6vNpcG^ika|DZn(4{5KuXaDa2MP|RWv)&oW!4*?et{&i-_X32zo~gSweV5g
zPG0@5`)pED<Uo*p!qvZA!&C4obT4?FUVHJmx!Z)UKTwLZ*HT{j{7U_?^09J?l=pF7
z_1*D}6B+%ZRU6?X*s6!&)PW4V#BZ+6W6I~ObK*p^;!+Gy`gJuQuz#iaXQj6c#J)yz
zz-Q`iP)0tSlJ0gQ=v(p=TctT4+X$wm93;*Ve2IjMfN%cJNst4-EZ@J8YvW1lfk>ao
zydVB%)O2$|91AV5{~R8B4xvaArKlyK&3=}$l^-E;%W;zuCp5peQ>(5P7ndmN@x5&K
z#|4i4j7_F?gB8fg{=!aw!?_y`0TNJh``5hjA9#ZNywULf-8**n?yghoP0qJ$2Pg34
z{dID3Y=q!$w5>CLGG1YeE=N)COX}VC6g$J7X2zG-))c~&+`AJZ_DVgfwcf~^7~SZS
zy6kr7uzSjLQzA(1X;-iM)lFQhfJOz3gh!2bzv*1%i6J!}TeA`VzK(W#G!M&yu617l
zQs&oh+RoN%pmE$jb$$cPM)YhKI@Vn&ay&Qm$2VcUX_CEFP)LIkr~9bN?Deb(nODEc
zq&3(V%rw(Tryj&3is&Kwe5{)r{SSG!-__jvZB2ZmldwS4$^wvg8PD_Y9Krc<l=;Vx
zj{q9>i`<c!tyy8E$z=u**_7S=SEj&k`W{7lv%iA5^lw&o26Yqt1=d^UKfSu;@I0Jt
z$(V|R7W{f|H{eFyQ|ak3WwgyX>#wkvI``y@AYY02dH$c7M!afrOEv$b5>3uAZ~)Cf
z$y9Ie!$w^E>9qtpNysK@(WN6F_|wbqk+wqud^F<At704A$%jzT{$xB;BWkDzFPYPB
z(D@G=`tN5r8Gsx>ezwpmg?oNz27O1eOl!fUD+QH%O@q1o5li2a*eE^=4|xCCIxDOE
zSUY1R9l6Cdo_YJ7jF<dxo!9`7wBEX}Vj$6$cLRD!pXZg9T&IHB*gdC##KB}Bd`0F&
zXG;K4cR8Ctf7}_2TbLrb^Bbs8G1Zu}iOQ0`G8|bn$&Zc`0g5n#8$uY6<o2JzcdKwh
z!=)u@!+JA;K{go@4<v_vcl8xU9*>ub3wc&vz!YLqImK<<iWcUx2wd}}O8o;p#)ieV
zPMq_MB3Vp|>4irLoSHwuu|mT^YVUsagOy&bYoSPaL6|$3q8_Ww4;3(;BES39bhWOC
zaNcqL{gN6V<*A^v>V}h|mqdVYO6fo+MiOA?d}`YFsn|Ad04*U!@Qwtn{GAj><`Hla
z5jz(P*izL^%`>X@8;_7c6qdWW2C|MRM^Z5+qEj|`C{u~RqW)C6*gm2e%d+LTwa``q
z7c8RD-!_`gOW<TLw_JD|WS!qOn}T~Yd(=VdRpB1DARVBf5{uQ_tlWGv!g;ZaC>3}m
zvEbOteIEpN=LGFku;;@E4GmNjV!Jm1JgfykYL{J&18e;lOq~OwuZ<M;Kt|!1<NFWb
z`QOh!5%PL^sob_WDCl@pvm<kiBjGFf-rWwtx3#u2=!R49Eq_<-cK?AcYXW6D_6Vnh
zsL@(-6780KyCmrV3<C1yW|cb)Dw*9x-buYW1)dTKVBukrq>sxr{Hiz^*`<3>e}AQ$
zf?K_H&eC*pw+E^}Yvfv@A&T$Fq0D5BPvg)XQ{h58feDjzWJW%y3$U?r-|MjsxTc!%
zPtun01liX3_WSyrZLNt)n&klFW1G5Ot9Sq*j^-f~rLDu>_>{?s=I<-XTp5jk2adr#
zYp{C(Nlg}YHa$B?C?xw*1`}=3bZ<xZ72)k(`a>D@jQEO+OD8-VC%#TBawU21tI(kF
z$9G9a)E;esBk}h&nB|Z%kGkQ;&4;YnZA8tB=o|$X!zH``I?-poD5^(C8JZ&Gycq!c
z&rVdQlT&;o%x#-gZgR+LKHTQ2wvmHqyAXT@2fGbiKJ$4m02NrNce~5l<P&whOmt2O
zuUh)uawNVnz4@{E6Pb8=(e$~Bp@a;Jzh(5{eEEAobHfz$y<czK1=-xSffRSXHcexH
zt`iZ;e^K3FXqAhD-xc!haiGh$Z(XKBHK1(`YM}d+!{_?I67ub=&1sOs_hMEE<rnV}
z`Tkc?qG~Eoq5vHZs3=GQ7uo*Q<_~~GvnTKIe~M!Nb^O(@03U*$)QU{$H7OMCAFn}-
zHs7>;$3{$PVO{PJY+|Ayv^%6w!=}M~wNz-x8!2*3;33&hS7C{Nn4VC`YJYl<=XBN=
zNLE(-#p5qbXT)0;fP;bCjJZ;-fZONWZ~Fcd?)<HLD7Uy6FpgN2Xaimqzt5-TH$iXE
z+1>5wE;~A2385%}W{t3w*YqN44lR$-O+QX#{Wv#oXZ;U!taYQV0C9-RP*o$|`+%TR
zxEeBT&Ch<bZTF6cC7q`#m#;9LPlDktxu=IFN-M^+K%dvcmk(HEkBXW(=bN>Gf92IZ
zic>2eJx9h`WOg1GtFWr1$wdb7Oti6ff7dTxzGxorLjwfP58so8QQp&a7{3MS7a8pK
zmzJ)+d%-aFx9PoTltc=f>wEn@b`=rK0G1li8L$UnCO}RFa8;D;DkSr6+I=5u+|clF
zqse^7Sh;W`$1XKgQ?8yN5InWYc-qU3vqnZE{*)aix-OTyPCxr5Sc6V0z%#AxlELgo
zfLe?*f4lF}j$ctCH+Ob9w-DkzggDVGTdaR5bUMM2taEv+(+t+?oqKdhUiB0xcCfOt
ze((W(lt|I_{{8z^&I13hgsWXWC}Ds&c9S<I1<jQsBYIit%+H=-y?XVE!*Ltvr&sg8
z@k;8lva%cPWnPBtjIwt>6MnZnEa(QL9Cp1jS&GVLqjtr9<C^ide>chfHse8^(}1jn
z9*{pl{JLyD|0<S#I?z;`1u2a9l7MkEChZZq4Rh*KFPcj!#2mbcnTUQo<Q`$BoD|B_
zF29m5u&(40k`294em^0t1o?@q67oAg{|Hj2pban3hH@*QgwnwVyXQSz@FMWjr{BkG
z-FlnOh9W{UHS)DwLN`X(yR|A`T{|WM7-B=n&CN|X+VzHP;!okR5DAHm<4jA_&ZyZN
zfj{+TCXsH`i7^;QxBD}94p*qp$~Ep)JnvTOJ!K70meaq5&jm{W`#HOo!3l7&5?Hqs
zP6J|>v0Zcf8h<3cJV-DA=Kpo{yuug(;e-MdSaP(Bho}MbXsg~NUl?5H|0BU~t+_Cw
zXMW<&8xT^WaJmm*yVYjNzlJ1a_ws)pdbQzQPmzU~f3cX1vA^Y<u{OJLXlu=84y;Mt
zE;5}@Y)<nHPO@Bp(;bX+8)$us_b6DyoiNfpQmz1ow5LSJwat~0pSCwlT@keP`Rwi(
z+3Tc+^H-UU_m55Ep$#Yt$=onm#iXF6;|jGT9yQH`Me__ZGmM!5%n2Z!a`)(WsC`y;
z$VkW+N_U=h53s!V!6p5z{bl0tgTmc4LE+IMi~6H1W+os1LyakQx0-byHui<2q!J4l
zs3x^Jf)yV#s9>Dz$4CoiS^t%4f1})Xc(4_t?6^xJZ(4udELv^5@oDI~0r%wwS1iW7
zUS0Q|8Y%6J>kEfZ@j3f?_9C=7QK_u`-vNN5g+N`PGjRK`AT4I2pUUq-kb%_0P6EL{
zHc9Gp6wHQ?(|ZV;q1N;E7Hhe24KCw6_$!-1)7)rdtx>W#d0;%*;w=(MFA>y{OhPoC
zjWdFt#ZVS;KB1+l8M3v-sw?P2XJTT~w%2kws1XtwslMZ%y3<1j!r?<X3DTvp{P%*8
zYl;T9y)Sijf{C9KKb$$Z&d0^&zO`RO34=V9KHC)=g88r#UmkzEwB9S!`;_&T$7%#_
zVE3+>69mIDK07urbP&2b=lSt?CsXZ8T}><WCw-XeJ6&9*;s+>0&7K6Z3JNRnIzbGA
zf|Hx#zK5p2OY}taPT}PdVa8;6qTbq;R==Y&LLwsMqIShdOR0(8zQ@EPvwH#xBS6rU
zcXt<LBly?<{=YT^sA8yoX>g~}H)JpCa3Q?(BR2&=++&JDk%pC{&v%C$UZ;R-Bu$82
zyxKd%S-~G?HJa`|Oci#){_C_JuwX&!=DvN-6B`%z%J`%Se6#wSi00y;?8Pp(n3x`g
z6AS(Or}W+HmZGNMp5NZA$>;BQ?*3SH#LZZ#YX`S^xcohf@(Mn@MDOwSz>GuirK;HF
zlP8bBx;XF7UIfv(nX6$XTr@7HQ30xyv51rIopM~9zu6{uR_bay@?yZdE-0n7zuY@O
zH=tQNUBcp-`EjbXmp7n8$}0#oG_-GVLi%;$jo7XNTKJM_46jBsP3+t)8&ps1=4$Z5
ztcZzcrOKg=*Rpxrb^-t&I&TdP+vGWbB)(AEuOU);o18?vFv!&z8dBBZurQt{cfS_r
zw3$c%Aagi9%{}n`-}rUiM?rfa@%-ZW$fn-oOtD?F`FWc}w>w=J6xMirjg$Zm1qIa3
zX#OlTC2!H7EKY73w>h5Wf!4M-jfSFTRRq6eUiS4KZ960a0GOEgBP9ZJY@*8<06-Ka
zj{N=K6?ghczyP^F>$`r?MsB1r<JIDdH~$%-yyT|CZ-<U@tfJiM_h3+}6s`p8?bl<w
z(YL)=ND$gV8#-S*`eBx)exHE0v#V?Q1a_?^n4@cG$Y3f_g!_CZO2YG$W|q&8F`mmH
zXzy$<0U}|v`m&SU*bKhbia}3!Nl8n~krD-vL0cdf=1$>{gDdM<krVx;uP(y`a$zgN
z`kq%OY6v^9wECVqYUA)<4s$woTn?W}((AY9piu$m^I%gN|GfyJVZMC3g-^#j$p97t
zW#|8XG?YY83(TL%=XL5fxf69}2Y-uC0^#dhUWDPO@a{gS1J%>IoiBg=8bFxBwSwQ<
z6S;iQP5&NTQa<hbfw?-Ft3;6tq2BHTp+-*7h0q1ME(0NvE#6f_EMGhQx^K@zwkQ<4
z5i5HR!JOS9w*ukjm^kfLrOlC(lWFOHohmM4%TmB19tm1_=s$uT`_6b*MYiuwW*Emn
zJstO2Y-=y1)SGSl%7&9>qM}04O7Nw+H+gfDS4DxQ6u6dX9y8-`jm-2&F}T^)QtLtW
z>o35d>_t*lUt;=xDEh4zG6V(ovhODJc_YtMgr5kd3>Tg6nMXxS*WvpZ`lF(H`SO7T
z-#F3myc{9Z4@1)WbXv-KH*$trbTv+Lh~!#{JiRl(E0yp5NDTd!iLne{lCPb?Riw((
zOaSP$@?n1$xegquSy}Vz#28R_`yz%`Ta_VA)UUu!i_1z)nP6$VjeWd2xVkUBcBo#b
ziT*JGTXcYpWTR8XWD<Fl=FO_P4kD2TMf&hz1KwHwvuB)LATBvhseoI!y-k@kZE$;L
zqIo<5y>Y|?D`2!W_UDaVmSED2J-+MS{93}wXT(=LY95C}Tv6D*iS^_;8K-{JhG*t~
zG2wro!0W(P7Z0fUA%W}UE#aXtW{cp3It@yYO3yRS+7)~QU`Q|;1pS?6<W;55-g7WF
z@fR#<YNW_)vu6T`5S8=;QsBDa-g8N{<0cY2EBJE}8TYBWX<Lp4h+(?zfW6Gd@y+kJ
zD;(83)k$2PiR+;q&H^1LU@h7B%6wjfgX?3xD#8&;M@L#`VR=A>&HRV$%H!SaGbvY&
zC=IA}{LzTpnAHHv@AhDn*~osC(7oJzdN<swYNI*8NDo#Gpsk=4xS;#Ac14XPVC_D^
zZA<9&7a;P#I@uVJ!Sv&6$!Bq&OB1LH*rLIELzU<5<N{W4p!#Rkb+o}uVL`rY^7Pq<
zX2mH4&}5ozRp^pFWHQlM;6`--;1@2@avD(9a{VDt^#?ao3q5mWpR}d44@?6i7K3eE
zI$|{ylu|>$)?l?WU<0L$va+FEOIIM76bRtThtq_Di2C+e<{M!cFH|HLEZq5V%wPbe
zGe~cB*Tf4Fd}^295xc!Dyky<1Al(%9+R$CCJPzZ!3@YQE^)P#gPsgt6H9TM8!3(y}
z37fG!g8apuiDN6Me0rjy9GD-B1tz4_biq*LXJUGvCT*U_@14r;Jj*=yAlvhe^mk{?
zFhhH7R`jf#M^5M5>da66Z$C#q|B2}0f?fOFc{P(^;6DUC33F|GJ-t!Y&S%#@v+5|U
z?sUor;y9889<y2bsjT4R;NS#q1-PC%1dFuHF@%pJFA6v`rnqK}?qo|#3!RF@N!I8}
zM^~3(hPYifE#zWNz819^T=yIBO(lm45xZ`qE8g?x3g^yvHXy~<uRnY`ai*dyx6twj
zCB3c-*i!3yJp%L)H;da^W%2VjJ?jc@T(Me{Krpc_{#1>QA4*HYA?G^3(OnBn)-E*C
zitD%@K@(p?8A!6yy`2lRWWVnMl$UE&^`E~(R}<)>3+_<?Wl5Bewl*i{ae2ZWFW17~
zy;ukUqc5)RRAg}p-^Gjshul39P|Kf*&pJ`g6*B)}()x~NAd8TATkB)z&>xf|52u(k
zh2rEXI_-BxrT3AD3IJDZpkU<NuAEC5T~6lL+3dfBHMi1>vJZS}Bf!5kzN?_3rv9ox
z=Zy>YplMsUJ@X#tI;*d@%I3<zc_<qE04J>-_;VYQ;90M;7u9H*@Mla_t}m8gk)Wcu
zDJO=!&9o(N$x0qfm2r3#y1(YO*V0_D{v2cj(d&I0(5oIBN81Troo5kGrvZO}VtOr3
zeRGxjv!MYyRDk84Ij&4W^$vyWhr;jYYYEiZC`&fA5pCc@TFr!sStad>H8OP-NXb-B
zg<j_7ERSnERO+UEj_kPlYmwmtg<N9MrHOSHS`Cv@{Qp@^VByf>$#3x%ZhroUgM9|R
zV0^=Ur&=TM-aXd^AJ{^!L$Htcic4ohf<EMdKL!Enkl?QByuOweWlv8eBY#b9)$WX)
zTV7f(pt}d>D^5f-G~pmjT%Sb1y#c}i`JhNkC?xy^@^Uin@Rs7@Xw~otO7xO(Q0n$t
zC?`SSVcggdbRA802&ON-e(5kv^jN{D)o(p(4cU9*;Lp|ayVLuue}79m+RTe1Hs%}u
zY^JpI{AEVbeNf~(vPw?-KvH#NLgUez;SYgv!W&r3M1y9~O^y2h>RJ@R9v^w|B9Zp)
zgbO!dEj@{^>by6eDhGyDO{U!yA0O?H9mluOIHUcOC42*JrGFRHE6&a5RrOUoB5(l%
z=<9j;Kv!|sel_w|Rx`lhikQTvt>_gm&(SUhvRaT!&*<AV(#6JKBnyC1U($=wb>ltu
zy34@n1S{z+u$DUK-_Q29g?|60$-soIt*?7}hZpoHcJ>LAFu#rk91Yyl)&MM$K$I2G
z{J4LKuzT4H)+}_!DI{Vilpvm?8|*f*<tk6FL1Q-LfXkCsoZpI67Ob4sQ?;bCJF>E#
z7^*X(h@U(_nfEXYEwjeN0pbD5$MCSW$5G<UO%N-1Nh{jj(IY>9vAdt+V>Imn<ve1b
z&sRO1$^n5V;Pijs>i<5grUSaJPOXi?5&_d>y%hoH*m$*bLQ<Sp-#kD<3?P0O%`OSd
z95&%+AP=~0^ZK7FK{hRb?o`ry;cOa^C-+yy^{d|vw}{#&#Ks1kE!<JldF`W?$^?LT
z$gWeP>oSWRF$C{a<(Z3h)jQbVl3EL5>C*z7uC6Yl`O(4O6DJ+B^(xp)ok$aCe!oZ7
z#WIh%YS^?~@tv8=i<ow}GxsLBFhu$6cS*lvN=}wt4x=I<P{$i1?T8x}+cr=C7<5Zp
zHb6JgVn(>RpWy)>I9ant4K&wkOYt_qUyz#C_wl_Y(7JP4&uDnV#0C_Im%T_Cc8u<u
zfNhZ*kEJWn@&ecVWH8?P{Mo7{t)aR|4#=gypY$_pzxs(dGydfCNb~+I5F=}x$w_G>
zWC7z^-Uxl}Rp}#Av$Ifg{^%PZPd^_woWGcn1*LDo4^1{7O_dD%5N|#=IPzmuJDvfs
z|FO}rvyjUlP@QKJC$CiRRDbZ>rxQN9hTK8M;BciSfoj6EX`mO``FKXbGnzqo5yUHJ
zVq(hIe=PL=b@;NpU#HOlD-Gz4C9Oos&dSPbp+jz%RmApGF#WUBlJ+}w2(HN*{j&cW
z{qxuV(^~Ui*Z@WtVyVSmY?uRPM1~maD)yl6K=TEptg|7!kEmb<pYr(!OhVhKCM`_D
zf|JL9KXf+y;<w>;-4<**nMl?@@t7#0$z7S-9!HzogeI|ud&WjlA9sLpATq?|$$NS?
z3i<^FO@5GIjJu<-;%MydgN4CHZJP`9<Tm;!A4B(EiHBArg)HEpmQx&^wmFV?K}8T*
zmn)S?Z3(y(6&t8dL>qF$?F9M`Qi})Nd)dCz(5u<3(DFeqNb2{+wVHZzhfI*NvrvBR
zRXJStwhM)U?-|fUKrteVJMKSvS0_@a8?yz=Oy_aJ^P1{L2Z%rlA3vtszg9?t5CZu*
zORFS8qM)0p<MhBC8oh`Q5sS)6d?js@gOc3O+%y1BT67hDa;hi^atCmA5@d5V8Fh!2
zc6<?JFc)QMm}EJD-$OFN3!d3{8EklwpqhTro5jQ0vtkSgu73G$FPDH3yd*X3<l$Gj
z@{$Q72Q4u!R>d2o(EQ*(2*mSGzg7EZCgAYQio>d9W*Iq;dLtbxZ?Q$WM+4dhrC_{3
zKQa)<V5rJRkF8NF`yq3a%j8E{`SaQa*8lb0|9<_(Yh=DJqMO$^IilCVoEPyJ7au=}
zfxR#HS90d}WuwjpFfE&pemvGiJI!)cszK?wzD?uXRqj8Jj>*egMgGU0e|N};-^#W<
zwUUo7%mo8~)r!tdQ(fJ){Q>6M%GlAVt;}ia*@dWU69C8h`ZW{;Dg$pnxO@%e$Lei)
zi0-J-TvCm7!thJoCx0H{UFvojnepyz1~N7S(V+16KS324EfL1sY`6NCLd?@+Sr6(%
zQVfASJR8dsQ}*e^bL0?!LLP^)`_S9rE6-htECMi<eML=|%#Q&)I%`2B=ppK0o7rJl
z;C#SwiOF1M15Pif9KIMt2foV6PAyECloe&Ud0qK8iJ8lDM+Mov)b?27skkUGq0eGh
zzfgl~a8q&n)rBwRiKwX&RX@{_>#*hRXi0`CW^uKC2}RBG`6CbzD1=A8r5k`hH%uIR
z4Pd_4`EW3#acN1hvmCp#0qot@&-)^dl-w$*c|&`Zf_ZzmnR?{id+uF<Ov?Xn%4LLA
z2BW*}O$A^3N$WP9J1MzsCLz&4E==jwD<W3Zdm8>;X%%DIqzF+;H*@GVOx<MG(AwHM
zMwi-bg=YuE$d7XkT%!0-KYQYh7YKfSzPm5~2{%gibrsfHE^C%cZ_9bG%J?cMW~6;~
z67O5@KL;Z(kAP4I8}QcaA-i8o(%rDjK3QDv{?#i*#1~;(bb=)L*dBcG&=*mqZeFyg
z>7Jk9%$u2_o(|i`;Czyo;@F^&J9;+Q2^ycJ>9QC1rJ&Pupek_e^tp$F!#l~@AKQEr
zf9PcIG@~cFYr*Mm$;A`dJOJu`Ro3Em>H*8&S1z%8L5b=`wVuzP0!*)ZrLA7HV7Tzb
z#j33yMsk0Sg@MPW?uE-Ki$`GB9`@ObQL;m*9Kqcy9+Ix5uy+00+S}xak--()=FDuB
zy$0j3P>0J#aV#vls<EnV1NHHOeGv5o=Sq!VhG=y21_ah$djsZ7=ehkB8KU}$>F#@#
zKFV|D&E^w!y}mDg<wd*e`3R%(uV`eH`0f31vw<q-+W%Aa{GVreaWmyk0{Y%J9J5Y#
z{Q6f2;_b-`+ID})$Ktb+dzuhPi%PdzVT;+i<#tvrz+Mg4&4AC(vOxC>8Zv6(LmD6(
zT7O%qsk*8(#q9O)tj#FMnMRz(1NE69_5q5`%>7pqZu|i_uwE{)bSm5rkLlMr>Ayn6
zLa+s}dlv))MrJQ8*O?9L-J%TmUeT|W8UjHNdTTl><o&m5VP*_O#9k-;4=KSDFu8gV
zE|>Oh<6|?FUByCl4IfBbI=1dOCyKkWs#|M5E3U*qF`K{f{oCU!Y3#la<~JCMlEqyM
z7=<Jt=b8+9cm20JVZ_~*W8#8!g|SZwXfBgkc+t$CjnV+c8`MJDPM$rJ$lAOtno40~
zkD?c^`7@w%OH~4jmtFIpgJ)pm$^AhZ@i2Vvmrre#l@$hU%OTGW8ckH_K&!{AN{lAn
zJ&sy$EL>b!!1~+5@lxA`Jzczj>a^r913QO^L*FZ%yTaY-On#>`Tj<bFV+rda*w;l3
z+hqG0IsxxOMM)K5yNe$yAf8SY^PDJbsmErz_lpHuq~7=G6M&ciLSz`{zQM%8`T~g5
zR|C&+J2e`a4{gym@89#7hSz+w`IJQjK#iFd<WR|{%5sQe;#A()q|NwzV?~9CdK66t
zgP<et8)eb|Pi{=wo~)-9aocHiyE+x{(A>Yff!zfcY{f&_o2$b`J`|b?uAEH)#d4y`
zXMNvZdFJA4BlZ_N*iBB3L-3&Jk#meXCJm3{lOWvThpVCC*0{D8mu{Y$BTQaCziJgt
z`=9Y;z<y#c9bZf#C0^Xuibr|HU@C_=3={QV56wzBP};~=W^o9}Err#cBAwu%rP(7k
z&YlIluq*|5SdM5=)9>#YF;c_vu>0uftQC(9_U6MqyWco8maa*2=!3B~TxGiOmgX4J
zK(8^HQt{2x|A(#f0H?bD|NlW{W@PWEP<A4lP$>zOkq9Y!?@b|+Q3;hjLbmK3;*jjU
zv$Bu99saLRb^osa|9}0?^}WCMb(iRz&wISa^YwU+92eMAdU0`IgP57ld6D_ke%I*0
zX=v~m99EZn^qc&8=K8P#?{nzf(uAY$)NLPH`;(DDl9UKLA6mxjB{R=0MHnHx35|;4
zrRjr%R>1Y=`G)ORRcHLjxRD8=z8;4tHZgd@l}Cx9;n(4+5I!h+7lr3_Fm*wzT>n+7
zr#BaO=Yv$SgSG=dG7Ur<g0%WPn4u|2%*q56=1+0~WAAESLUR?-B$ZeXuzHtii<gXK
zFTOc5PL?aVZXADLzyH&8LVghx0?v<KR6t@s>6@b_vf-<-{=;9YLRh(ZH+8$FMdO!u
zRJO_2?c*v;H-~9|ybziMBAT`9)hcqhRuz`-Z!VuGR;%`}AezJKj9<Cx0JVP2e5;us
zVH8X}k#G6=`FDl|m8I?kIl5JiC7Wxhd!7<H;!L}hb4%$yG3EbP@`d}inOWM7s!Z=N
z^P!w?D5TBn!a`n|UmBVB!=)eOYSGft2Gsfnxb%c-PrM+aH9XK!=X2;yl~@;ik6NAQ
zj3=C8hirORSdxx0QySCPogaO4SkVfTSIb({ku-F4fwU}cG$1!8UYzB3WqJ5<O4z?2
zW>D7JIF<bK7g2AZCM$fFgLU?3KfqdKP}JF5GdCQ+4S7@)ctVGL)!L%gW5exFI_tgd
z_QgRfA$g3EGl)&Qo**d<7j0q~lE}c8<kO>sEzNl>PKMkm{p(+rI6bPp;KVZMjmrGo
z4|E)##yc;j%s)=bud$*R!Y;01KWz?CmYwP7VoqR`2SLSS*QXS4xz_DNf39@))kQ66
zq3=FfbfaRv_!5?-PvgC8_|~f+hWW6*>6tN63(sE^i@!P1Jc(b31a+W-@mKzg`yRd+
zW^O2s-nJ_;=9I0+%QSPhfbN3)Mbwc#Nf_0S%h7)Y3*GDA9&Jxwyd?7@*ZRK8M53|(
z3^k+16KG|Nd!DWtD1W@0hl7Gf@i4z<8RYl|V$epeEO7hMZLR@V(*D)O<)3(ZD}$G?
zF-Tcjo!a`T_`}ld&wD}%S{hCd9I@NWLoM&kpXF=mOFQ4y>W6|41<QlsHrm8X1(aV#
zRZBas)1T|)%(=SHF*?$v%O<C*%Pf6p<G(q+y*yqRRQ&(<`NClyc7oo`wd}a=s`8*n
zQB0g5$EM2s>qKAtOO2jykLi<>Du;4aUR<8Do9kc;8&>1iQPt2m^|~Rc+;gmt_i@qu
zZS`lLpNvB8NWBbwlD<synL7u+wu4||d(TU%aq9;i%PZ*3sb;m0mXjitOo_}WM6v-g
zAz284AwGaAEA;#6kSNwY?n4p*St>|4kk*x(q)KBME%U`b$u_C;rM`JfIc~9Of39$d
zzoHjPo%QZ8318D{<CpS*XzumCl14)@9Iw#q*HH7cfgS+(MbpB~F>jbgw7B$;R2aI&
zA9l72<c!!khNh#uPMtdSBq&QiqKbceBuEE(UDr9-zC<}2+FFW4+hA{!ZSfS|nO4b?
zRcyU6E=Z+B%cFK;%coHw^3eA=H)MDv5yX`47r1WIwd<`*`ZSU;->R}|guWIc0_kLx
z=fpD_6)L!%bH88lnb_J#;#{x5W)LVv4RXM*-xqa;iU3S?z5FYa@09w=O%!%`w$eas
zJMm&B*${pGIqHJ*1IHS01|iy%S^mf0pdU@0%Z8f1v+p}Dm(aMX`1DyQ?Ioh$R=S+L
z(6hYhpg;>{s>x03z1Ff^cTW$rNB{@f_KJTs&b&IViLwEN{H5k~3I?M-I6p2gv{m~>
zMlfHmeU3Lb@P*Q+k=_Pa`D~tQaRLVHebB5~DtOv_-0+&8?~K)NC>m#I5N$>jRX@&e
zd!lhvQ))f_n78%IzDw`z1`?Ut+FAiW|BG_3AfH$pg3MtmTt(xYc=_6RUz6fFx2=Vf
zhEM&*bJ0a-FDD6|+FS{kC>eWE{fdNizpgua1o)fRP10E`hYFwHMZdX<fYwrAiZE%C
zvaY=FNGh@4dG+h{e|5$r^OjUzeE*p@q~av>Jr$oTt}7^9^#SF|)O0f?%W`+3JOKiG
zf+iaq7gzdcmFMZb#1J%Ep1W)_97rO$?tSEwJzSi;8gRy9JfB!5Gni~63cffAGuaR+
zjWxfAG(8dwplz2wTI+i<<A9ciX0j<P;InN26v2`}UENh$50#-y982B@%U6*~lfP|1
zh4ae2V3o}P=+Ff@Mryx)63g#T58w3*o%2AMy>UaSJk+Vvb8|I$Kdm;<mIc`cT(xU*
z0+qRf-*v7RZub&nvWJF0L5zf9mS~s}X=^OQ3z-_IVxAq7%5V>VoK|}a&tGsHuAty%
zdVbzq7u%2RhQq$Y^Q$16y~hWoIf^kc<0OIVYPc7B*>4cD#Pst}uX2QbN^lA3`O4JR
zI4To?^&8)JJ?KyyD4iOw+sfN%@M=YgVxw<^g0T53d6EV?^Lu+aVZP^~-Ccz-eaL<y
zstvg!`41WUEVMHfpP37LE<L!zB6O>pu?~t1lb~Tj#DfN&ARg=W9>Fo;OB;FL&vl_X
zzWZozL$rnV=yZEcg{o-eUghAk4;u|Jvw{K_mFp=Er$DyS!C%cvQ(dD-Kv<snbASpP
zBW%hsX*fw0aT151R!-R4)g!;3b$5Dpu*CVDUVEk(@A3GBeoGtf^XC=vG4)~6-*?xX
ziG-%0X4yb%^QQ&ieu~9)Q}Fx+;p*zGtu2?sHMAdpCPZCp3*4H=M_xisS(C*3I|n;c
zp@PYR&=EVovlsyVHu7iBl!b<)v@f6`d3vC(QAbDZ4^^?lmGLoWZDv)k<obv1AZ4Lo
z9KNq5<BSP++5f`n?>IOpBw(&VdRgf5XY->W^IRe{q-F+#UuOtNNgHeWJ%`TsH+-CZ
z>_I=iJh-ysWN7G?prT_vB8DM#Sm`Tz*go%8Y=|b!-GO0;z}K(kVPM2SfUeRi0K)y8
z(?Ix;+MazK|Ao`&bX`o0;QuATif87{ZLEvxyVRF^ut|6~0V*fTFlnkJEfo**a=X2`
zZuL(u+kVw!m$4zCY>V4UpyC*T#DVYe;ou6|9JBT)+kYtK03;l9@t=ZLcJ!FNx3Ndq
zQW^JCM~AafDYh;!nN`3_!<`#KCw2yE%E+OjtQtH&49$XKi?Lwi-~6%=z(O5%i-XbG
zWWnHG7V=vxUM{3CdkK9TV{@|+4Z9KewWHbR`2Ned!-cg_cHP~0P3&(84Cdg61$KVs
z)ix8vbwwiZkwI*Ovpc&|oUu=0bf^-l`YcyiaVf%wnxC)!EC11i+Qiw44<?ixAxFF*
zueGVjh82lu<SM@&IyU6%FdslPaHWW!ne+UEjbd$*TP!4qFv@_*o8iOzmvD{$0?mjy
ziykXfN{Pv&7E2~2F(*p84It*Iduc7=_I?Jb#LmCCz(=g?+8yQmyXy1)&NN@RK8SBO
z$aq)9AK9(iBz9=n>w2>bLsh?k*eVT~G}2#M9oHYOwx%+*5{6jyXXOD7{OsUgPH~={
zHA41G``dTx(8ovLXYgNwKJSC*<;;imwrz;SaSfD&j{|s$h~OI`V@!G$x?!;=D|D+V
z$W)Zk?<Kru`>z^ipK-sSzgJf?u~K$yqixwS)^1xe_B_AdyZh-MeGu%?)h$e`)^Y2N
zDArX7Z9ZH!I%CBu{$r}<(alg+sGgA7^sG-Cl<d091d~Hi4-~fNfW2LJ49|pG&#L9e
z571;WK|}c@YNCa+WB24{11&9~!FOnuf~-Itn{?Fo$eO5SJsSV$SJpc?SHr2W_au%a
zR(PQ3UjJ6`5)q8%Y<XbXkE#I4QE81r`QnqQS(r;ZlX`pEvO)Qm@ZP<953J8tuGZBV
zWy%h|e`4sSKlkf7o$zJ6w-o)xTqVK<+Sy!OT(Usg1c6IRTH5$3*(KnK!_d`vUT4hD
znn&#HX3RX1uY*?4qOxG#mdq$j0Tkttm`O*&?nvK(vI7CsuQFHX5(nphNwO6kG#qow
zrJb>le}0JU>>91GLZ(MF$4z2BxYX^!kc-7o1}$6`M9}YqVNv~+F)5hbx@oq6`XhiU
z(S8s>%2v0r2V*Oh*1=XLZFPR*n0-=5$1J8femMLu^+7j|O=wC3HCbBE$rAq>#&a$f
z$4a`Mft0)Mi3oS&7=2xxz{<R_pCh5?KG&tS!RC6$w&IQJvu&~J{o@hBkGo6jXX76E
zz%EF!4QNc~>h%(T%zaQ=|1<bbC3H5gQ`aG95^JtDArw;=O6&U{yJKJGNY6Dv2;~Z8
zkKGBwHOP?p(2m0(4P9NGW=d1XiG_UjeGp+8!z}3)4dxif_B&zdFf{u6-qt>>_AfNM
zrbG~{fK+0cdb^OuW<BlOH`&&Qr0(B(qALUYszr~M%eh&e9#<?=QqFce4#V}()n0$U
z8|(F0Ar9^V?O@n-$Y>M@A`?Nk3p!#o!#zUdwphR&hFRHE=+~rVfqoWILm*RBz&ue?
zzwZyxHi+G8JDPv31^6FV?(l~lK$N^`QUeKLEy%2GK(7wk*iNYo2|0<EMAm_E#q+^f
zN0bi~5SVf$L(BJHgRCrBG*tp*eWkHw*IGpW6cXU3FjD?R2uVS~Zw9KU2vn)|j}n;1
z*kCN=?{9_A3Hko8NeTK}Ku?MbQ-_iZVcb#`Ti-#|u4vg^RI9B=CVHYX#(%trE;(tn
zt0kA~(j1Nr!@B+U$xTpCP{Zl2<8>=6B%~oTmnX6=_-GUQT0zmLP=1U0kmEz^VWOV;
znEVpQP>qX>koWT|-R;@+LRZ>#rk6%qXWPDby^047#g{rmb1KN_Kh|3}WY?b(x-x*v
zWSt`c6R<CO%^b`1)YUIYV>c;-nI$kUb8e&~vz1=vO3uE4flY>Gi#y`j(NNvbbizs2
zO3rKL2(&XLj|0!|U#+|~87MfgE$(hP!`DuXU7R=R{^?7ctC<GZDNv$N0x+q49`a^(
zc45$O-bhy4a;B!H=G)<gNq)d3e*KD(Q&m+}iog9D(gE2M=!iG*V#Jh~ku7FEfje`Q
z#uHbKhs7ClXDvo1B$URegJ@785xbGRk1$Rn2FE=Qrl${C6Hz`gCyGsdp$EVfbRMPZ
zhp*@POz^k#o}Z1E*%Yae&}IMpS2>|rxF4qwF-MF$v{@Dg8jwrG!a}9yvG3wFC|^Sr
z`x~^eV9A_Db-64+t$U88m$}?YyoSopg+$>y0KieV6s|pZ8)jcJd%BW-7PCCyuF_aN
zOnf-7L9xx`<DpX~HT;X%7}j_0^E5FMUeEQ^@wTr_+g`XGBbs^}l-o6<<Hn-_L&Qb*
zSZecgkACE#zNK`+)J3r|OQ1Fpo}Ys<0SM%5Bu2fD6Spj!aI8bADJ{*Y)ki@4V?YvS
z(RZ(?)l<^C@VldJs@Q&~=+uqwBkyZRYx{af8C<$6KY!KAuexHyONJR?`$Ld$x5j5-
z%ME%<Oi1~K{faRGvAod@j#T9u6<f-0dXVZ<0rkm$##=9S|KRA$7tm>nK`3)4+KZKx
zsmYn1ywZ803iYc{YOl<DzuDMjHui#5&0+hlrwFFP`bM~pZ|W6MUTQoj>{`qvEGF4K
zF;Bg4=mZ3`_wT8a6B1<CD!{kK?-k`r^@OoF^ykf#0d~^_j3w<j;Qu`;!TQ+$7Ds*i
z;qBFeN@V?_?)I;TpOji;sQD!?MoJ2=MPnKV1@s!#dv-w)>xU^>mE|z3sL*qXF62g9
z`z&*Re{XMMN($ZQ&y(&Sd(9d!qZOjHmXrp<^0+<qeib`Q_0M0h_vk+T(81V(v<|&J
z6uQ43AdNXVNGCzA<W%NqVZnpMY!~%8jai-3MZ7wtF*eY^ffQ1s%sPE+)}BS?=x&Up
zYu9{f4bqE+R@~V<WkzJ}^?r*_hC>u3dp}S>q?l70J1xZHHs7A%PsG$3Cxs6`=f~_u
z)z~0f?JBwylQ~tKi?!{2BAqm^t2DJZsvBj_*3zky8<uuGD)7@8WLG)p680{xA=0aI
zDDzPdH<!E$z9McZ#BGiXDv1oy(3r=$=*8Tc=YTd69!uxpyOGwR`n{onO}aX)dpYwG
zx0-DhE?|A@)~3)Xl>AGQ>xzm5AT2CAeGG6H9<5a-8XlLsX58@Q<f54wSv?L|$ud5t
zozbg!$=0kPpa9GRG}D~?mLj7ld2=(?FXNS46$>!XuQn*3M4QtOq@IRnf2ymyTTMgb
zCBUgBJS=%ZM3-J2`rLBp*TkT`faSiYsO{v5jLb~rTg^MJKu!nafFI1Z8qL+sZePCl
zE?mH9(-Op5@=DGDlH^oWe$}4gZ$EqhjK-xrh)3t0LHrH=bT>RaJd~U_%DYov;da4+
z1B~aCytAlaIxitPiIYmcbHE<8Ev#gaGR#?yUdg`pETRlq8-HF7^4fdt)}P}I4cP^O
zT+vlUh61iMnRTUj)#nOVUAVSwl$@W#G|w4;2EgR$TtELwXz37NtAhb9_&f`U^e6%8
z;0a%pBN%ER7v0*IQSS$9rkoj;h)8F*ZGhR*)WSAq7}1|E4HZ$2R_w?gAAOnY%Z`5H
zZuo!-bR#44rS*_?zI*rX3iHlZ|2V2cw0hM-`81@VGfr8$@h6_yw7@sow)L)|m!JW)
zC!}=HU<{HT!1Km5GD}OklY*QCps%+XoIi-zoV_D;Cj+eqn-tMW#E9DB-t>|ThDVmt
zFO{K0t89o!r?n}oGa+wvydWy7)g8<q_me36{ri-8;-XPF9VEqHLeK>Fy{U}e!0<bX
zNB5Jp(wyw;h6nAI(2gbE`q3hHjfL%~7>Bz}d#?+_lZXF7n4WFd7;hktpR6~oFyi%y
z1Ezq7yGGeq5xN8i2MzF5>g0o1y*DLg2LQSi?|noMy6l~Fw+U#e*+OO4v<##?1Vlt;
z^GZ`i<>ig5H^9^aSOR|I%~4ebHEm9DkF9yJ*2}p#fWe#FDml8qv$J5TP?B?%(05M6
z;*iDOu5ow9g{I~D+?Mjy=Y9=#6kC0IC{%5Ev9cWx`mFx@&IH#Q$kLUa#{NEjg_Ini
zRjE?*pQ|E6*d{=mM1nU|o=nY8>m43AhDr}#pRTP{-r!jZf*ahpU8x21d~yKOs$oIy
zG%Yhm{JKSX2^R-GVA~2eyHZk&&cR$X3~-|WZjh(N)3p!FRg#o^D83-T&qd=IaDgX(
zL~wU~t%<*Sl@o0|tGpHbNII^zdola-arU0DNvpQ|hmOHgiJRJJjv?2}7=b+HXmh)f
zM5za}p(TdfOH(JX!kCWk{J795(v?pFol#2Amv(41^nqcf^oWd%tna{g#|3dN^~?+x
zH+MbMxz<2O5o8&~ua~Md+s<e+{V|k{jZXaO*>_eL-=7on1e+W6O64NwFKkic`h}8l
zGg*!wg=|9UfC7m(f%zB8ocRsdK>9`6I4F*A!uk1<jAGk==Qj*!!%dwrOc$ay*PF=+
zvvBI(dXFE!1XBF%7I>bH<=F+&OJh|^TFx!J^)SGV0$Lq}vs`W6)b8FrZJg55ES~%4
zcQ;}G-{*wW0;$yP55c!nRGjmL`FX41OT4@d2qW{^!Qz9*k2xw|q691%jLkUM%}xW!
ztPWKUFy|BaCD&ncIwke{6K^kil)f^?*+sxTMH6p)VbQx5LK7qcUnhH@*h`A!slamS
z<mA(4h|vU4nt8vjCx5JvdGPRacUU~rIpePlIn5s6rvroSjj$C8$kV1~i>=Pp?;~L-
zIuJ<ma^o?~hA_RYI4o{nP$?I~y9s<K!WQkesDHt|<djP;4yr3)3kMZkm0Ux0_Jq&K
zmOIRmztltn!!{If8eCkGe4{D|iKA3vKUwc9p;UQ*5}OSA0Ou9qr~sfzhqs+Qo#~DT
zJ;-OMjs4xloW5MlF9m2hl#zxlA0YrN4ly^Yu~8Jm%7n$?C05p)A->TXTL3Chv`e~1
znQ5twrH;a-$^GDbk6X2ZLJA)MG5{iuhPViLqwOZl{bJH3#hMojWvuzRxZZeO1+qa}
zdrP(kH^2ewo_x6upx6Zwc;K&I-4dYd;T)E5$wMK;>#v!Xy&qbQsHmxLw<IPe&cP@>
z3K_9y5_fRSdQo8(43H|A)m3oZqHoxna}bAvGEpV|L~gww{D!E<u0UIylrPYidixun
zUN+5Pn70VN4jeL4X7Lo$;FH2qXaP3Vf8C=o>|W{W_^p(4=N?`t{45$O@w2@>0A_%G
z#!20zNGQ-PdjaCZ^nv&(Qsh+Q{6o>!zNl*>fK&vt9)Z-Z>lCTNkk1t)_5*0Z;XzBt
zF33X+B;>W|;KnQ3yf~tIRCA0UOcxh=bkUQZq4HX~dShm0=KT?caQtbYaIY<wNW`4N
znfYlXRDI+YzM$-MQ(ZkGJtN~gWK^H^<Ih!%`GCWtVhhddhGY;kB;WLxMx)V6=u*3x
zpas_qg!&HdGO^MoI1G61fZw8%aEiG}rsmU_U<l^2E!)hwQ9uU*@2m2d*wv*$p}M`#
zfK2G>x;HUFNkLJ>r)PPIJhC9oSW#viC@oihoklq=U1~_D@RTyEfx2UWk#~aloCPfT
zuCrAL5(9om&9RaF#3sv67DA~Q`~{%j2Kw`7I}QdwB!%G55fs^Uh(+(4cwI0^nAnxa
z-??$7+z@OP<gVW+GMttyCjqzz72auNv^3Y*8J5qV*YwAIw>5WHi#zAt8WnI+@PF(-
z$=OFsAX+2axqE9T{nI!Qmszuia@@uf0GVjbXBzW>3rHR9(q2>m$f4fB(>b{Sc`|}c
zo?r?21RG%hDBrMydAv+BTI{(lNwaNEK%!j#q%4r0tUA+;3~ja1$3D%P{teI`_wM+d
zx9(nJXu=C40c!pp$CU^Ce~`O%hU>F^aNJy%mlr+4uJFg+CEx+WS`JA~=hUPmTsWc>
zl^6p7?#LZ?wZwAx?%ZqOrfCn!w$8dwH-*(5)xSI)?p5uQf7dq7$4#~6FT7n;${P+V
z7#D?wO#ncG{t=l9xW+vYN#_*(Qa?8^lZfQXhx*h!JSv9;PxY+7Jk1;oHy~aq14p4|
zMM@+atMe`tCzASe-OeSdu$qocAkEiciQtfsnNoQWpK1gNmm>@JB4AyRGHss>wkN!F
zxtIc}a$)F%7_6(dQlCUa@JK%Ja)aPX+AOW4e_2>-BNT|~Sk6cNXlc0;fKSH4^9_tg
z)vb#e!5silR9o<dwF-U<HAtWGy+$CV%|laib&VOjJ7r){c9Sd|J&U;{2|1kpl^cYM
zg(o<fKeif8|MtRk`ogxn-Mct*8=5fnzTomO04#L65gI_9#!Gj0*$w%`)opVh?`7Xy
z28bOx#nd{3R8mQqqW%ETy03xx$FhZmqp<8W*^e2?@;m7~30soWzNmVVg@O>iM{j34
zUH=UXsdW$Ss#oVpZaJ3_v~;JYD9OYN^(UrGzyDo~@HHprBcQVdkd`OMj1LM+u;076
zZ5xcbN4yL=ZGQrvrDWpTO<-B9ev@B;g)-OaTA61OVnc==tO|n_E_vD6|2H&_=7#dU
zkEN9-Y5`?yF;v)W>eBJ_@|U}pE1g$Z06<9(H=>5cN_t@-mA3GeD_q4ZLq*Z(S*s##
z1S;9P0X51x7d%)25T<aq)ki?%$>V5GJ1nk<mWoOrJey5SOjhSaNyv)%>R*yJj-ZXE
z_D-r4IcQpGLF@$eD)p>*tWBr@#s(%IE*85Q9pQ#bAo<PbUDCS>3Ozxs?)&r*LkH16
zM<rz4!6pvEpu#mMMJYMQ&XuP*$ybC#Gnzn$qEswCCMFoD;kYPq2XfZiNHUWEtmLOx
zZWuJZVUvrfhkgQ3|LzhD4;oXvZzrdtrR6Mq2$<)>dkN>jTx9c6S~nPH)Gd42p+nWV
ztd__aMM%`tbo~N&!G&m`$eb2VW8_V@<_2j0viTlJL2$Y^8R(H<Ng)dX05DcLC2jI$
zL_dnISw%$<EZ@Ez^f_Lcqublq;XHd%-;<T<<T^Wm`_wIM!Y&tt+l#7{8(6!5gEWow
z(u6zsT3hm@Z!zri!}x$3$v1aw=0zjajVfy_ghYT04KzfmS~=rltAlHTnE+Mg`F&)|
z^up2d^TXA!NX@ByP8q6G->S-{l^kAO)^AD}vkEIfN(|TB03$aM_sX}k%$_sxc%A5V
zZp{`y0%9>0`(g6!YIGbv3c-;lj&E=MJHdLcNb3~oYO#nYc+d!3KBty(hTzIw(oFz&
z2^V33Um9dH{vwU@Y__+`{Fnl8ToG!DSQuYDfW8s3q_U-6{vg6g<>D}Mn`yWxur<ds
z8ejUPz@XXvn1bWZC3w@p_~X|xoMGnTeUvJ>-{BAX(aYtn4!U<_FDl<V?!Ckl8KIe+
zHz)e;Ooh@SLUlp@L71#pmKRcTiR0pY)XweiPei~{k#NmZ=Kaa(Jl&)=zgGxH*1dar
z;737&>L@GNt$ein&<P9%+;&1KL!T9CuXU>k0~YmlVGa-oFI;GldnR>oqCC_RT!H9F
zPL*JDvLtzVfQte!RacKzxZ{c1+X0^PlB^xL9B+oeBt+KIk{7NxN>~jDu>eFznwn`0
z#f38QC1Iv{+Sv#<QlQxmYC*`TTGERYq3hQ*<M~S&46i99Y3e-;zRr)Ohw&ec!@HIv
ziEKP1{FQm+z|t+cf{f$#pVa_vIlEZ{Qf99QrFV8oRC*iHQ>Zu82ag+1ZHzdQkev|@
z9~#nb5O*fKxP&7Iry_!CgT#-5lJYf>z^<R=mpOJf5QC`k+|5ubQ0zitc*3{V$9Afb
z`w|JfRfFNNswux`uIkr}r>QBYCMT~fbI!ULvZ4T}&(6W2VLJ-!83DU#MF=rJ8FNcI
zWy$3)BiuL#2Th=wD%O4jSVzj|)8BQSl~sSHYu&$}Jg>FAIx&zx1tqV{O@_wrCdA(4
z6lyKn`_FgZSZt<0Z4fbBnd9fN9@v#C6t&5d(;@|zfHGIgP9cta1Q&16pLPLQe9Etc
zNcyd1yeTFy8F;d$bf4nc6-B%eRD$uH^U?>qYEM<#ZCo*J0|((y&wxzk><<&w&EqNW
zpETPSxpQwki+Fhd;J-EOK=eA47^m{>$5((N<+e!fcP8h!G8C_uTIQyQ+4roo+ukGz
zX6V!`y-ES5E#SkD510KHPhMnyQLyN&-w=68vcNkM4*<tNKq;>7z|HzVl7~k;2YIW%
z;G&fSpi$y6vX>!dogDiy<mi65N<=~N_9`Uo{?C#-=bTvGUD{28<uv+qAx(&iTNIae
zwuVTj+H>;Y5!|dWSe4}xncY24&OAyD*fwn~Jyq2N0x^#Bn-q~MF&*11>N+~?Jm`k9
zcq%OnVnK1~Wqp7#Ok&9qoI7>m1i{qlLh1OZFyjuO&ThD(w;=6!0w+^lQC50-$Ajg(
zq$D{8!?oe@u_?RYlN7IzMFq7^Qx<0kyU<L|kQMd(5R^rdBWA_hx9gB<NQj=7f0)eU
z5JZ!YX!c9S9=|~TTSaD%1Zo@d1oh-_G3Cq0RP~1+9|JKUivU*~-Y}({JCr3&P4RR!
z&;{)@bHE8z%?~k@0kmBzK59K7Q8F;yf6#&^gN`9YjW3fG{`zNO)bReW8JWY4u%n_D
z{8K=**=@CMBqF<5ePC7cdxKuY;zQ~n8*)kAd-&|e!@b^Xry#%&ynN|cYK5NiB8l{)
z@B?NzIBkckB@=e`xx4*pjYAP?6tZ-TIz;4iJW#Pxl5=!R;U)a6b4IzT>DM7H15TCA
z{sAxpKL9pYOVf5KEA>AKMf!Y`yw%QKjhcQwGW1N&I3T`VMFoW~^vz&>A*s<?-8`X;
z)rgifZDt&lYmg}e3a86X>w&*xs5;*0L*U-tT^U8m_LW{S5IdIrbHO%wBP^RL_lBJk
za5!i^Fn;>9H0u|HI3m*0V>1O7C`gB7?Y@d$n}A69>97J(3)Gyt9CAX{iQ(V@XsJ}S
z5y0-LBfG)u!ow>^Wb7M#(HaSaTF!%Bupfiz?E~_1Qc|=w_MRGrc06!=7x;c@id3du
zHvoBTP?|+Z0Ka^ndDAvBpF&U(nh;Di-9%zT3f-G8e0>c-&kq$11lscE{reM8aDjDV
zI-f%^D$o`q=DW4nPiP>TAV`(&-$^&)#38vCVwX*QJWWP=>C$`ky)%?hTPuB1r0s9t
zySVju^n;Au^i6}ZM<rHPJ8$t>V!^VNqV0Z*@F@oQAiPr~Zz6eVhym3+f`Li(j^u#m
zDRZbZ@vdYlpRD`pkr0z?`}LBagi}NvHDK$>@1F2s8P%2Pv4%~UWs8^K4@Nj6GNJYi
zEDl!?imKvTa#%^lC_aiM8p~KRe17v4O{9wES6sHgT4gn*3^3h59Ccdq1>epA;<((B
zb#P~YWb44D!N`8_DAH1fpr!t0xwn^~MPPBpE%zN}^#^wys96e$Nv&SPwojRX=sP{j
z&O3}<grm#yVBKay%szG)&^8K3-B6){cn5;QoLybO27elY_<8QKB!R5p!|XoeT5t?^
z9=xln`i5MgP&->7TDRtAtk^keW9Sdti*@D+`TK+Bp{Yr+<iO<grO1d^6EJX5{i%^0
zPS|fxFW*Aeft<X&?=Ti<w=IO9UMVtGJtl*vgA|*Qe*n{HHv;dp)A1$J6@VANZnXzJ
zL@Vi;nc**d^*pz%ue+$4>!0qRi2?J>Gm%9ahs0o@WmSszZEs`Ne<nw_VX7sQ_(wC|
z%XL(e28~j7Ue*lGNfd(o9ksGwOQPF<9o)06jgp;hn=A(4mu*E@r^)65+i6I-viA4&
z{OIQpL$c>~p%}VYcAnhB*^->$k|1iLn?@XFM7zz#U!5CmQOqb93cl6tg)q>&+RyV!
zkg_{mZ$VYPA)WN`fm)N*&R@qe_N3H;{esxKbs!T?It+t%MBVglfP`{g6r1_#skD6E
zz;#Z4XJ-}cl8`b~$#Adkd*#3nzm8mk3cO6pZcZ!=iQ2_{AVfj#oNEd;0qZfnW)X4i
zQBhF_t)JSFf@niZnYP?>Crq4@9$2?@R`;Eat<@)gVGm_eh;(U+-v&^q#E4?PwoXo-
zF%W|hr2hV{w~;|1U^ODZkUV0g`G{NkfQ*>9dn7kUw}Qy?aBntVY6$7_2L{GW6{7y!
zK2{#P6GXW?!T>^qJG6D!oUpAKFDUN8A(&ielJA?7^y{8(K6&zFEnE$V(F{*!@4_bC
zx=*5{PkIE_#Yr1{XNFirbV_Zm0T@iR{^O@l4Br92I`Wc?3rXNzPu9X_&^h%VYxsZS
z$h3m(7W`CGdRcrf<FA^A`GLM0VAUt=PZ|3K_5pnSu}9J(Hy(A2_aqned;T}jdtCmc
zfX%r|Yp+RntEMygoj+kzWOh?MWA0t&@+yxfNnFX-?vJ0@S1?r0S+op#HqkIvRaw*T
zz0f08GE8@F^V87ndE+igHb}$Ez@#AY!}mVQ=H_NObs6Uosi<m)`FD91mp@8=y3=QJ
zg=p3uikNI8bbm3tC-<SAft0M(hszOL3>{rS4yn85=G={W(_s?a<#8AG(0$3_sPHgj
z0lGp@7S;QY%x&F6*Ka+CGb}Jrk@;WyOc}WJ2H$*etm=*IFh+9k+fNKo0R-1S`Uok!
zkv+`P$h6rQheAqRb0>2)85hWjR-733NCJ>Ol6&xZW`6_cB!$}Ic@T1cULW^c!}G^^
z0=?%jI06pGN&r5aRF`nh)v+GXv?JmRuDM~xU#jLV%hDM>5%_D&1`Lji7sW1&=)s-R
zG_&KKAc&%4q<jTmkNO7Ttrichu(Heat2d+=&fD)bul{s(_}Gt@a7t=i76CXR)-4pS
z;=)ZgDY#IB0}0yWdduDUvOnX-ae{Fn9xg69NIN0PMuoH|w;C0g&0&6iG&2wr6zt^p
z?3y1k9V-Stq*cjVe1c=({a0azVO(?4iILav6!I|z2I9ye#{+u}usO-;>2Z<;e@x+1
zI$^A=^vdk6Yi+0OCwzip<R!V#iHV82^)MM0jnm{mjJ<+icT0yG+CziWY@UxCrok~_
zXm*91)FdlU(;9nnOFf76PRYty=?8jn4?`j4i})_)aL+CGVAhJm-PIA2_rEVO^z9e2
zhP^dEE)@)8@4Zv5^9=u2>U&ZFu15WyLR&U64=FMaA$W>uekzBQRfB^!Gk(NA&ULP6
zZFud7VO;lVNFu>^TI|y$BFFvqiW05fo>p3_poM{iRPW$7S*sx1*BDM}h!)^w_4Lp6
z1}oAQ;Kn*fP?_EKs<^mpD&bZ&OD0#i$p*nORGCl=#sqLS2jxw|dye$#n|BEMHBppw
zf#n_quZv#|rgrM=9=Zy1D7$xO7XK?KQ7@{*iT8J<&0pPDJ=UQAw~LZepXKWyiHyN0
zsCnFaH6X?;b-pbQ(FoDvBA<@l&ZMs+hMNc8;W1zx=q^7EY_WtW`_PVu7e}rPLW7$4
z0-*ohO$(1RXN6jd=K%-tunwH(P)F<f3LgqwB;yB@+<Sgae-0UkWoYCh@3rZ)x0KH+
zzN^0+I^e{ZjYe&rX0F~X9Jz%2p#(!}xy)V=N3ipv8ybo}eZ<}frhDF@TBUhVY+9d-
z7|cY&DV_&7=9;3C_4x6OQv{TMHoCK=Hjj*Z;lDI9rhm2rvd5?zl{w1g4aa{^HR*SF
zg;(zQkhpP<{H^AT=Px+X0(fvtMRe01%g?g1@#FRVE9!j6kn~*39y!I^9fxwK{+<oj
zJ-=$GkSg27z;%Z}`h6OW*Nh6ZzN{i^`k=JbC2Yw07KX#Z=`$3oct<^vAD6Uv>SoO!
zJ#-QK5$U{GCIeUe%qp6dj2H)LGZ`F!(1q7d3PP<VC&pyK+XULDP8L<AvWQba5;ByZ
z*|T$l>3xLel!>b_6y)}^m0kT&&YSz&ftUAdZs(7FSxo=L{x@dm+`>Q`10saOq2J)9
z<}%eg?`58wRXH@}c}Gh8>O3|KJ~48ppO^eVcOvesxwkkXCg)hy{PZ2JAIfI(yDgin
z76k3stnT?3=~-*DD84dMY^GFzHNe({AM(CM9@*TDdeol~MUDF$*>|X`n2^$xS0t`*
z@$r$uy?{c!Zoq|-ggOss-s-!YKpQ?Q8`u2wjNB`@r200=Yo7>KjNVA2G`>*jl20n@
zHw?bAbB%e^RmTJ^-jLac)q6)5Gku4Jc)R7_DW-!-7WQ*)FuI?W`K9bE$s46Ra~y|W
zP&Jgix`N@TFhbw$x$<!M&&mR9m>vW|4G`!Q#(X-nXuG=tpGXB~4O>xxObrQ?|4Y>O
z3tz7Ov7l_>Zo5=W|M6oW_z|VdAdMr2vxPm6pCW6Ms=YS5Pl;tY*U>%pE<OY=@V3A=
zbdDTwxTiXHmqu(oz`iv`g_5kL{R<S;HmVU@*Ikz=K3y1@{qsRF{2E`spfG(ECVtes
zGH^lbo1XFI2B2;J(gbrT)@5~+L$<FShSth_gYz8KQQ;huci62Gf)<Q!?eZl?Dc-rW
zc_0=imTXx(0qJo0XevytKGx%BXD_d&reUT%)d4Mx$_yq^3&qO3O4tcK{jU=}U7Pr=
z-CqqmJ#W0`Wv6b;Q)dT)AFAP|u>Y7@S5rT;TF^wUd=wp+5`j(5Za#uC(8cUm1ufq&
z3Th_~W$L9-M0{xs9%i#A9*za|HGhP61no`pS$js<(})jLs^v_r42qBQ_wsm6&1ONb
zng8I3=*OJHLDxTO3R>8^nZ4M7?@*gFxTkLnabTX#Bl9(LZ#d*~96=TBPPB8I9+B4!
zJm4UOW{(vdd%A|8y+-UMj&_GA5pXvs`Vn+u<yz;Xzrw@v8%=n&P~<Whf=(MztqcIM
zx0i>(4h(!wb!}}8J0`$`@#~R;Z|?N9MsU5U7`?gt{B>lpl9H0JOi#XcwkSXye=olZ
zOm}=(VHK7qX?eR`a~ax8>LhQ5^D`f4MFt!~L)jo-$6<Jz)7+_IG*wwYVRAQ9X823l
zF|165XAuV()zu7O0F}C&vpPZeck8{?djQ6H29<?4WB#PzQ9u)E-@kI-BOof^u-M|D
z*0KU|$s>%5c{{F&I2&)AxDDkoDjH_%NW!SX2iM<g>Oi6G_k<;N<@D1vDb>ZNrR&Sn
zwc=%g1hy~g7Zw^}y5`8;6uDFA<$8XY1fPjq4kxU*_vlgP7t1}DQ|O}#Ly>532=46Y
z__ZMhr;YGc&?EtlQDA2NK)}0s<K8KK_#iEYYeskQ$SL;Hm6e=*nrLA%U;+%puw$4Y
z+NfGOjB5jqo;uju>>n-}$?(BjE8+v+;ymkdX;YeS(6N9fqW|4A`!YR)iE9R~5Va5x
z*hr-*K6%0pKFBz~7A%4w@_*-LefeXhSI1;J?1_Pj9kamXq@=oKv55Cn=4KM-&!6B3
zzxCnt+PCK(P=|3SLkvoh;^e$IRJWU&npRu(&cMlscn(7PL%0ax`J|&eWg{8Y&?D&P
z3z{kDnU;YOEYRxfK8>uTID+QrNn;^Nnk5a?tl=6{MtehV(B=>hLIKFM5IYyUni<yL
z24G@}3ZbU6KeDOlSc%MY946x(!~c6DBrVozMicqXEX~tH)nrcnk=hMBh(ABePJ$KE
z?b~<RF6LJhwt^K*B~&R*T^Ea4ZN_^ZffQWTasy77;{%N5r!bkzLTaVQ`D>XTcYZQV
z+sS}~G|MOKbE<oHlwUO@(R$5p$KATW4;yPl%*v-f_avZ@0;Z-ba=tfiD_pDX-RS{^
z1q;+|b)?Oq)S`M~7D(6i5rEj9DBFfh{v{lv`yW4iAn*pV5)H>9FCU++>s{!%4U|~N
zrxv?!3M8hdD=w74upRVTDVRrlXS|FG=mD4?6{*ZY+0|{mg?zM~Mf2culzM9ji`YB7
z-Pqf0=>^AzXRn!}0~Lv(hFAWQ=U|dG$PtED-n<p5{9FN^3ku2#(k=SBu?G*GAfyw}
z|AsP%HSADs1yMQ|Z<RLTEig{FNk%#HR+AQirr5;5U09<N0DpIbNO`ESLnba3`*8JF
zE$#$ch{SrHKKLh-vN%+GL-~1qecjK#cYa7vQW1(dgMS(afQ?UkZV06<3Zqi-MQaFT
zLVp<TvLXi4uJ9Onjs;YTs-Pj!<my0=B3Q=#F?jeq(|2wOL_&!5kdB5Jl)L!+@s|(M
zi$;6E;gdEps&a=FOo9JC@AXdTeC&>qab*&?nf=C|^MB@g;O2?{y-_DNYY&`K5O=Mu
zqwmn|Qjx4W^M|V~&9q`G>L&0=@(7%e9NerMyn<<IvMDYxEo?1EOG&1aQRBUbjBg+#
zQT!b2Ki+H{xdXqV&;v{G!kRBwLYfp~l@CpjP(FicZufBXNj^dND(;WjoiQRZ+Lac>
z2nd)FrIM`ZZ;86fAz$qbz#RjEY95d^KO=^E##EsUBzt<^RkxgSa_|D+sr0{tA(P%!
zeZZ*!XViQiLqUO~e^M^V{05i=u5VjW_VEJCL$EV762kzyS=V=3onZO7M0m3wSj&S=
z+H*vv0oOx4Scp(v-6(p%dLrl4!P0?*##%Q7l=#HeZ@?ZBIws&M0#wDhuFu4%Um!rJ
z%Qr-)1n@$x^y!74c<kMLOOVb&2jit4HsfktU0p}Dr+W-A8xcR^w(d6F2017U>;5Ut
z#|ez>c+aLO-=Z}d9M4;G2mjA=ykLM40?mWOj9(D9Al*jLDc+EaH;EB<By}BDN*O$)
zm6XDfaAwtbp!DEeuAB*Lim|nXU?QWL8K1tl*GC(Y3fQ^eA^K@A0yXL8OcB}sad8#e
zN{Rg?_#L}Lq8dW~rHnh<7>P?j?p4@7tdap6Km%7$6hO;T&c7CIbbR9z6`{#toXk<l
z>$jiIyf%=Z>iBX$&nEXAG&%eAKE526+07ZA%2a350Ugmvf3%>536tASkQ`VHP*KO*
zxXC=jBu_=Jshc2n+ThB=)>I0ijs7gAzH8ln17o%A1yQuq#fw;f<0iOCcl&EZ5}-s@
zI-eR%&X94_GW#SgU(W;thun3qFd1Y+&G9u7EZt8p?^)IjL*cq%V*^4)@Oj^y>jV=A
zD!#{A^2*Am0iT#+O9%x_f7RrITcH5GMm#DPS9>*&Uqb8oah01~uJz%ad%C*W;&H(2
zGXF#lH~Jhr)^2SBm@)SQdgBRCbO*9Z-umIlmFGN7IgS2xejNYMzxZ3UqwT|2c>qg}
zo45wyETd|)$dGgrVj97{$TvMRbL(n%wnnDvvyPA8O>tIS`@q6;T|XY2lVVa~kOP)o
z1{o7L4Xd|9LzUk1z>Jt2R~BeEa|8M3oR&((?URPGLhPUbYuGq~6MJ{I#Qp+%Qlz?;
zgAQFD_215<bcqD?atO$C{z|Xk8x<i{wFZ9W2&4WI3FDl4xCin$G%fhSLFh)v95)Gv
z{RL<cm8-;m1N$Mx30Y&y7R0auoTinXJ9XzM(<-+^`;F&*jVa>(kBT);YrhswmxUFp
zwX#+y;6OG^05Xj5KB%Q~kK9)T;P?gWr^IY>32PPAQ#+msYjHo3QaW_lTRmMssi6pQ
z>4>kI`J*<ktlv4(CQ;xTI8hER=!7^o5#d6PB~m2@zX-(0Fr_1=;fd{|hK{4Ghe})5
zWTgg-XSHHGSkF*~+d!RR;$bB=rYBSe$o8GEmrC0Em%TQk^9O3Y<2$?%;l=>oO?dv7
zFJC?sr+E&Q6=bL^NlAfroY4#iovA|90^k7y;A`fHk&t&eKC|hP4W|15GW6BgyB|s;
zF}TRxj#7~`1Ck@1uo)FRAK}py@B;%+6^t!;+rx-jNK06XlCOh132bO&DLJ|Gfm9@D
z3&YX@B^?+(BCr@OZ&)tgK7z2|8T_m{@dAtMad|Nys)4X_e<TMSVATw4&^h;zZiRMn
z00D9aTa0e|l0Pj3tL3xc<Vt+t+7$raAZMkui*#+{%;3@$gs!oRBacd~jNVFNJCYPg
zZchhf^n)1r&r8z2uu}VzPLtID`LQ2q<5;I2&DoIv_p}t^9gQWnIuJj^oH_tI&nInJ
zg5cAZP<`9oha8233mvspYaL5uS4NePhr6R(rJnwN-~s5sGIl=N9oa~r2>L_evy6P4
zyJG@ze*lP98%xG9<d^WoDOp*=dU|kJ@F&V07jqbX*>8`GJ%Z92qC0@ms<PO^tFXG^
zQ%%q8_97b}^MXtu&wlo9S})PEgE;f#<m8(VAHJ`irRY4pP+WTs5%SJk?Otd7jS8G&
z`2IJgdiyiap#IacmaXj?_+hvU%L=cpt<4P<aPsMv`++(wAvN_z`Q8{9nn5D+0^(lt
zxL#F6_5=MF25=W9!z(NXtf9ojC#ShzZZ&~{1c;A}nx-cH>xSTP&fK;RDh7ric&>H%
zz5Bm!gC?{wgfR>x4?TU_h)V|49?vmNrAAxHDJYx=ncGM)r}yb$i28dSIUqW<N9P_)
zfV+2iBv#mm6ovF~gMw5PTN(+fo<t)XCS2$gbhZ#nR3<TP{|q4-D6tWctpsu<*Uo^~
zK{W(z(7*VWQV}re5JCTJrk9IP>?G7iQ9jaz0GClXC&F<?%5X%+r!&Cm8?<RlB{}tW
z7U?Np&449$)i`Uzm;19eOA4pqI=|`Q@Ig<H^<VJDc<ta<anQ>2QATAyH04YfQGCZw
z<fHWkuSC5cU<SD-GfMU0vq((Tc@76(=|bO@BNFD3VN02$;8W9H>!Q${1#=6UH15_q
zsgK|Ntme)<ldY-dP@a`GIFy|z-B-0Vkl*t%>&Gp1lQH?_6PI3L($F><@Y%lCE!RJA
z&TV?W;Hlo8TNct;1Z58hNnyB-HqLm_LEJAOKtA{CS%7CQ-ZDFV%J<1nIT-8sB<~n2
zag*S{8N)PTcK}7i&I)Iyws@H^P~{P}w@EmM%C^TzeV+Y|7$xY{gG}xNbmkHNi}dUw
z<o=bjw9K{%&dU>k?{6-S{>{{W4N~81S(!WfcNC_rA(b+H04(MqVp2Vw(-U>k6)-Ja
z&EJgne@(k8|B&z$=V=8+8~ja?Ehp_41Np6hnI*1~0H=Tqvz#`9bn`U(hd&0!G;ALd
zB2e(DUQT2j6sX?U0H!e-GJ3_6E?+0zf2*r^(2L2~4oPd_hA7PXJd_MShg6g4hOXz-
z*#?-E0&d`mk`2tMS5vN$k*v5KTG^eWMUnQ7majvprhb++GO|$^P{54Uui{vS7L_jP
zxNUz(52XYJ^IM&=VEv*fq)RA48VqqHv=*-1I`*75hGG)hlZc4u#UH~7n~K~LPhvvC
zw=V+M*2eHD54RW~d)P4jVdk!O!*|#xJ{g*2$k~0~p&x2OLEAe$@C$Q$<8Ko9XPKBr
z`ZBRnqbgwbz!O3Kr~U>%-#Kn9e)WCY__)-vO4dulu%01Msy8j#uTLKZ^B<h1@1YZ!
zmLg|Qx-llHwC!IL`nh`^bgWmT+O05N;?np#n;x((N2DcoQmx^HxL1>u>=~_JCWhF^
z&+Si`c}UtgF73_>rP&@$p8Ssf&IW@aQWXv2%o`X{no&W+v&YORKPM7LF{d%RL>d^g
zL`IWM_t>-+%mhVE&!Wz<6^H%)5q!kJN`^w{4Xwg*PROsZ%TLTN+I-!oYKxKZ1&UBg
zmb`-22>?@@n)Q$I7n%Pv^0-*?Yhg&N*uHYTv@nd*lg-Q${KmUXG;6H@WuISI2_6+-
zWK{=08eHI5fc!)-Ji9!~ftCC>ak+Mb-MYII5H$HfR5lg+YrdeF9}ABjfhqu!&c>aT
z|F>iqIAZaYxXy-umK#3?^8&DdSpBiy@4w}<fl34e1DGC;jf=*5025nf1OF3D=(sGj
z?tvEyw|5!%A3*l83T6?bFLz)nSwrVhQU7JYr!U~AB%Nz;0bD{*|EL-)$N7sTI+_=X
z{yw@U8AOVrIxJggYu~*GdD$Tzb=P`cqAl;}f0aLWWr+1U7DqML?X#E&P@u{zap?d1
zr{~0zM5I|z|Jh71#bX3SMhAD@(fM;2ubl_mlo?YPSht1~2d^KX(GuHNA#eihK;N>9
zL($qAGRwWOU|1&@6B35c@EUt4wZqypT7GwH2Zr+Q&<hbF))Qq39RPCVvp;$7IQA(Y
zQ><`5!K`UbG1Nky04JWhU)QU3Nh|=NN=rqp>cK}K;5Nqv(|k*g6X%o6PeZICou`wI
z@MieNVZ>WNf8s6c>W_2Y+ly;O)gOmiVelKk(1yQ9$z0wCX%dr(--pT*0OOY~YvEt<
zN=J+r5MK!xNGcuK23L}NzzKZ{MNDnL|KQh*7(Wc6r|dDoym@N>SFp)#uR7o?nKiDV
z0VY8nJnqApwFWC=v%j%)(&8}8KIem9lEs+ziG=)5zb2zn%SkA#Mz`@G4@;Rz^mQ-U
zH2seu{RL@g=2qvEg5Fh4V@zvH9~#k$w;diQA~m`TE7+UbEFVA4In{wx^`Dm>HS<M{
z6Ky>|;a%BrU~v$x-Eck-HV{%w8k<xZESV3|GQ+0iogX0$y6)0J%{zDk#@GQnMFs{O
zAuw}U%CmnT4#L@S-SjW2XKaM+*8q|&Nwf^4gpN&ZtHJPD5m6I_X}b3r9|kRL+~X9o
zPr}FiSp2ao6YDfz)R^qO$pf}8{jG>C4^WiyERUTgS}*+d2_R<s3SKM_E90Y>Bs}jB
zeE!cNVGrh!>(+YZ9O2oYM{h;kriqufXYjx2MLy<W|JV04f8nz?Fn2K*M>54EO~@Yn
zc!q@BDbII-ZPS471B?bFoJ(UhqVZhKnA{ERzrlLuQfyQ#FuUMcnPilj)NC_W56*4Z
zBXD{w`7`fj_nlqpOXe8}?0r)57)odeQsidhjlUmfc{SXA^?wShh_()rBgD^;diZhv
z;3_Dikg}9Em=A*QPDfW7Tql2CDVIb`c~OcJ*HB2NeROmrKS!UO_09$cE<h5<eJ9T0
zpsAYIli}}IJH&F!s6Pivg<qis>mn(tf_R6kF^B&lmIdMA2yBnV;h=ng8AnZh#B|;7
zIzbEY7c{5}UcC}wD|6NZ+;$ku*=4x;0Y0S>uBs~m^!+gHEhd>BiCERJNzKqWEOk&Y
zIv+loEAXtWF0j!BVgopm$U2UA&Uu%tunbazferOgD-amyiCI>;3e!HH4X;vs7lSP#
zBgFXBqrDz%qP^l^96Tg~;7c#4>YJ3d-<NA=c);{KGC7Mley}NSZ=;p+9BR*)iUI4N
zit9b+HfP9DcDE}0xXj7Z;s8lSOrd&J^?}haAs-5l1YtO-e|N{$U;Vt{VKKyX@r`kr
zDz`-%4a@uXV!*kbf;q%|aALB_LF^j<;mfWAMm^cPsNYMHXcESdw6Pd|k0uxR^TH=D
zw5X`-15X5pOG#29F6~gB4uzO#Ox8F5Gt!A*96#9f#y<9c_ctKc4g;ek#BmkT2$w_G
z-^IQ;iVkWeegV!WP(3|5-(JXgvXjK&`8bc4*8qgzUm)G|S*)N@9}4LPqlPM8fiW^8
zp%DFam8<kE(O}-9LVEE7NESxB(*8};^q0Zkk_^=Z?gSs5WzGf*vw}Uqpz~N7mv{l}
z3ImH{#Ct@hh4{DV(cPRm#e6W*ibB(JH*ST|eRvLr29wFBGm%ro6pPRWw-b{`UJgQ$
z!Z-2$)QJY<yq~KoP)DPO52imTtG3)6`6xyjNnGRtH%M36P`#ts)K+iZ>wo7L!6HZ4
zM?bKtARfepEkCyR^h?X4$*h(dVxb36cGefe^T>_U64BD-w7#kj9w-f^M{p&Tg5SkO
zS_A8T03GU{tdPn$Qgq-&I9=pLMlhI~<u=cnF~1E%sglPXxCV$l0H6!^Jw}A1`-oZq
zEED?@|9NA=q#g_H_$C-a5EjCXRS#Yf>ik&w^xvE^v+9h;7b}}pzyre3$rr$Qkas11
zcsS9*taq_kce_Ex@0ljstpjsGxK0ySzyYS;BaYs*J|C9beEr))NoQIN#kT9E1Hv>R
zM&K4rg6YRC)=I!(P)xIy{(W$BjqCc`iVfw$W#eqKozFm6sC?(sHisRHZYlv;TQhzA
z0%&{xyc}A=pA_-D&ci@a3)!)w2gsLScM*VsMp;;>^*jce-|*@@{S7{le_mw^r4C?x
z20*!+TAZvmF}!<pUPY@3$uP@G(TK+T!Sg(G<EJ8Hs3yx^LHF7k*kf`%IDz7CcU5x?
zu7vSimMZ7sNjlgPevV*6CO1c+N=AkoVu%4Fjc=T<HQ9j5Pza{DBFbgN?p_lxH7{V^
zb?2fMJslmFAJ0r;YnrYf<rcI2+IkGFzhh?2{)28|&hp57TsB?J!?i}q^R9Wn*T3!<
zx7s`$<pWbgSUG-|{9q8+^O9cX_Dk`Z(DAbDuTcZsIPg5@TXTWL2lymzX`4Cu_tx8C
z%F$C_v2b4iVU05@TGHrU%hA(u*LZ<$Ie?+ok&v!0_`;uyV!M^F7UH%3;TAI4K41S0
zzpTaoS2A}2=Hq;)d1sAEP|G+z@LFJAU-Y3T5e)W%u?lAUUzm}!2!>;iJc_JXG`x!`
zVSKS{R2n{TkUqfZhbjnw|Ls7<aQg1cZ=lfBKfX^3eTPx2c=(SpZ>9hUQvWAtF=Io}
zReTh>m18pOJax~=RWLgbcYx&vnC3sc9%bq^owu5-!C>dLurV-EL$QvxSTh*dY{+5C
z5XDD!*xdYj3)n0-?-VxAZ~x_=Wpu<_Z(Gy0$!BZ5({|~2D-|Q^=~Y~ak&(Fih33jT
z02Y>Ik(z*O*RZn%>tt~&VjRKzV)$ICZXWr!^JdxLKC*ZlsPl4jKN%5239(<C$NCAW
zHy=17O+<~!ZpNlg%4c<U@FPvBCCemUVzs$Ix?6AxaU#>tERC-~jd?p+orx^CjIO}S
zJ^>arc-i2g%5OSq9#)rTDQMkQDZAbs5Cc0AqNiKp?Qq*erlFx@@0uqBk>K#+fYjH_
zJW23mN|G#ysWwdi-Tzn25@<#8&()D*REi2ZH?Lsc2XVVj7ykgCE))vqx;YsvMd?8b
z^ygJ{8PQN4VgpqFj0-J4Z&(-Fp4DSs(T~4!(OidNbDxxVRQK;KYG$yGD-rhtm`h@^
ze~ddG%UX`O!M&j3?^iuoqpMYIIFKv6oCc;BRA(-OeU3{nVbnF5?Ag6*7(0VK0DzTX
zKZ=^+BH0u~=XG0GuW?E=A}FyLuoW>ES21)+5oq*=<6rnB!Akq5iS->Iy#pCS@njIh
z;`%_TD(AJDzI8StT^PFPO-gWf2%jA4!F8<`b(>7j%i8kALjkFs>jXiVI!nJp9Om#W
z@qy{yFH|Wh$B)cg+xA?ymhO&^-KzVlZ6fr5W`Qy0N{3|ycJhFb^)7h1gD=wGqeH=L
z>6+Z%_l%g-f?yQ7<U3XW<WB4|ufkq+7seWzkfF@@d-kc$@`!q<YO$mk9G1sczEOo^
zvjj(ucXr;z3)OM6UK$o1ANNu7@Dlh9?nyGEcY#i208I31Mb-BQ2c$6I|A&eg11@>@
z1K-TK)uCXs18Qil^K*cT<=mC(FD;p!!nCehxrPCukK>~aPf8nGg)UFoves{1-NROT
z=hOs3FHw0oPRdzBtJ-Gm#jxjyrw^`A+~^bkL42P~wmJk`;kAbCD0q~m!b<Wl*Za2*
z|NEEKc{og{PCk*GX#TKsB4l_Q@ahyVH~cHJ!RD^@;D-<%gfyijYo=oDaDp_5>(x7~
zi-5n1sCiCjWsPLALDkcfBZs<8#HYW|3t1GBpFP1)K!rf25T^w|&2@|pgcv}16@;t(
z5x0`P7q>$?^k6BN&Uc?oz~Yghax<n)3Ay?nr*9p&f=wg`53rmn`z^76Q7ZPZ1-e1W
zGQtdjQwM>E)w#jdhky*#IbrW3@li1I5##?tLI3j{?Iys9&Yb9lu8JgKrvC}&)q}NY
zcD%FJ-Ei;&7ar@yBmuyZ)MfbCn?7#hCkCDCpj&Xzi2|-1<xL|t;Y68wKZj8ukp_CC
zettKxB?l0yc%H}pr-zUHx5h1~GAM>1td@mG4}M2ykmSX3=>fP&P6ZJBTSx!zzmgb(
z8_;==!Ipw$Wy<ud5L^rGvkwjTnrB6rm~$mD>yp6MGP7E2`)NBjn9YgoF13&jJ}^vp
zAA%4Ztr#WOUlJF0ZN0{kW4F7d<X;bb6J_wG2ddRpwf60M?(2;?D|A8s5DW<rk))DQ
zz~3uxZbC*-0i?tK%d1CDo1MHb-!o9<pkFUz$2}gb)avXS<_*EvI5E67`AxizyNu@J
zJHUkjbKYIgK2I)5oj~De``F)S;Yqwg*lGwa9iogHJ;tQp0NhpMP9`Iyj+ELHfPmyv
zii%WH`BhgR0YLoaG;da8<-Y@4?AuxfrKn3OImEV%kZbuZuPc%L0*7`(#Gkjk<$w8$
z!Y}pQ@!*v^#~O_x+Yf!hSL-phWFHL|5f!?W2HlPi%S8Vk!zqr>2qpvU*CwK|kUbqc
zH8?`I@4|k=jyz(^juCmQf~#GQr!f5y4rYVFa56k7D71E^F{%Nr4wgbGAY>31K)3+3
z@|EGlmyU`DkJbO}wNlvQf`MmHX9wqDzh(35Gp^j{EM3Cm?C+mo#UlR0Kte?B`Yf-l
zb8sJNT5Ld|tz90iAPtdtdIaIyhzTixc>W*uzQQZY@7sHbFQFnJDAFw`0wUcZ3Wx}b
zihzKEG>Ay&prC?EC`y-7DkaiGj3T9^bR*pzL(R;)AN>CAd+%EJKX~6+i#7VpslCtM
zpB?8s=S=xcb{)cRK1-$>(6~*=eHh;A_-oG{@)c&g{deFv8ZP8s?Rni>$#$^Q_kaBi
zMPw_H<9zAQWNm|+o$h7kW%bSMp8$-8`|&708UuH!AffI)2Py1EQ5oX(U+gW|zi}~3
zo|Z=z67@#0OV@^;PJ&2xRxFq7$k!I%ciOfqB*#r~T1hQ!mt+u{;KsuN;tK057BFYl
zL%LBd1dhm?%M|*Ud)n#^a4dm`$}43<B{GTfe;pqEPPCCs3j=cAbK_b*KDR-fY>iZ9
zcy4Iipn9#?Z=`exxzeiv1^w{iMc|}va7ga$;cG|s(({`6;s345g(&1)O1z;9EaZna
z2tdZK=scXjHmcL*JDgosm<Kn(ItFTBhB9*r9|j!384gOhgMc#sJ4j&&?JjP=p92Rx
zXaqneqwLB$atIzA31|*C7&d=b@etR7^9T=4#)EtPuEhD|O}S5UZU9jIF68{*DKcS&
z<0<_5(VA;_?-|;2zXxj#j<I$ljQr#eUi_o0aNp$9l!PcXHMn8zcvPeh?syauRDIb8
zyQt%r-{*kr_dw3vgZz$v*7m`5pl~)~j0Db9VW-DhqKI|yDy4ojhrg`S@1iFpY9Fko
z!V8H%B3*(eaY}fz5~ur6ncw#z+<UlGLVFYy;WzD9y|%tA;@X$#HXucX`0h_>Z~p83
zXgHF7gG>x0XpX`GwD%zSf?V!srlhcc2Tczrb!u^bOWL1TC|NXuQ?+4-#8bC5=Hvgd
z694miX7>b~=?9*3`&S4AVGxs#IAQMvGN^lr3fgxCI5Tt8J#|5w>V~|Z7vAyzTy2?*
zgo6+X-5Ww~7FvUwtkld9>kj7-miWcOk${2_M+20M!I89&!?AZ3-II-IE<ScYv2Y1A
z5E#n~D45}1vhec)9C&swQMrKW;9ycrZUW>PAQk1m(`pv7nGw+|r0S`Ugu}@3(niNy
z;od(8!Wf-8*S;m^y&8QDSIA_}=)=u!ZA?D=Sh)Bx2oK?Cj*ZLMM{4j8;@u$t>-{RA
zOW$j}@<$=r+6T5B8a%uKS*5(QXm&uV8^l{c3v$lp&D_Y}$<hDuZ2u>ZKHii!^%``N
z4Y2PEdTm&Z9AJ$cKK1z?7R=~D%-wK;!BGtkVCgFMX*e@wOWi~AOKfjTN!E%1VO8cs
zQRHm$d&Y2zAtW?U_rHD4W(KEg1Gm%VmZ~6AwVZ8wCLt3!?o|{u<3Pm}HOZ|k*>V43
zC<4l&#RTHQkdN<;%|vAaF7IB+{jBp^Spm01e&<T-aoc?tlAfP45-qi>JYF-m^y|r@
zcNUYKN#StM3$sBJWBU20c}Da(S&oxa$3K7I@wAsr>87ZC`u)Ruq1C;;K&!Z)SJaNZ
zN%+~czT>&#c^}s4r~O*4$Rs!IR465zN$eRKt`dH2=Oq&*><z~g$XyK---w{(+FLow
z<OKwKmK;sQQuVKoxuHMLM=biHt9MrM@gmJlXSUl}MeC`jli7|B+^8`vUts=}<6YZ6
zQguvd*erIv--*-fawglrMe93sL>V{pTRJ0Eu4?KIajRc!ZN9ALPsGRO?Y~qUe-Wbm
zN;{Kyt|0qfd}#Q32*0jnb8he5nyTj#11fe|U%!4$Fgl?`RG*4@wt(?CGVB%Zi3=Q&
z_DLZ654&9>)F!d}50^*Y$a8!nLV^<1gY5!d?fj_!e5h>(HGH)3yUIlQ*&nvIlJhpg
zLIeo<SFku`@kW;ObYvbU=_qMrxrXt7aQPd}29I{@4IK38N0J}<Kks>)*XlnWcilKM
zj%E(u^LExtV2`<QeMxrbaoxb+yc6!##;#lQR(bNH?pm+Cp%QEJ_r663EiZo;;|+h|
zSXJnD)@Qz}qTVoH=i(jLx_@A(@3W}s)R>Hc;T8AFidjm31Z?M>?il|(klT#W%fWj(
z7BIEHa6B_M=aM@UfuD}-#~2L9@qFluJC(GpD`tnKZ+_r{{k~V{*E7VxMA#n7K6hWc
zo;m+CpV!=L0gsv0MQP6wxDh?~<);#YV5aI8%u$KVlkYfzgpqsq>XtHAHR%<7qTB<H
zz1ixsPOde>cbV~<P^g%~)fKkw{3_9Xt6B1VCZsCyM`lJuXOF>YLJw+EJ^<d{&-<<w
zt@7Hi$nGZax6o#Djy6(+Bse(Tsp^d@HQ&U{>ycN9?t`Z@b$4Ij45ktl1kF3{OEV=p
ztELq%b<N==5_9tSY48)o&E16nbC=B<z-IjxOlhsRh|>6zlLaFU2@h?w>-)Y8b#Ik(
z<}Y*S7%h*9iv;^uV&go%ewIDV@nFjhku<bU>~O}q=@ru~FU8qoGb*G(L%rWf@aDC@
zJR(H`$<vFMjw{D)IIT8BhSwEnGfA`Fwbz_Y_HQb^noN@SK7+WsqZ^+{B4*xE>s|eO
z+(?qa+-}~~xv{oG$|r$7{z;(4v(Tlt%qMuILRHSW%;{SEZm)G-&RcTY+Ggo-8GLV{
z?LGCq%U=01hWt+}VIxzSnvV3JJf3&({~6Z-+#)0^ma*7Vv)55Zh31oU!NG!}qPiGH
z6e@+)R^g+K$q@09*N&Nh$uSjEPQQ(MSa9LrzCt<h<=zE^t(Ws0?~rk8=?I9wU+L=U
zDY2)h@TFL+@Yx6Pb8bx~meeZYF1QcL9~~gJoe)^Cy=rXF4kGD1;)bgc#^DWyndw-4
z_Zsxa(thYVbZxPoV!%xQCbH_D_4?fBcnerA!0B)9YeBpqpEH90q>;o1)P|M4oURp3
z@-3_#`Tkh`NH7DfywcH6N*{j=uP<GRe=kEt=Wc=DTRbUrtBN(Rt76#p-X}F_ki<pI
zN%zSrqdm;l18jEo*)WcsW*P4ZX<i=lE)C8ajag!d?z~cnzu#WbPQh>b=|U*eqO{7%
zYp#F6cC$ZxtSGL>qWst5n9wKDlKJ)iL1+KcsUN+Sb|t~R5|`ENMcbH?omKA)wtNa|
z#P*82B(<aOFxe}c#&_A+%d`}C>K~#wdd`@H&$8w_Wlgm}a)_=nUZS|)E-S5(q+!0G
zRq17LaOKt@@9g!I4!>D#vlqd^9>e0j6nedOw|pa9sZl5u>6@=F*Y>;0wa+WjbCDnF
z{!H6}$oOoBPkB>ovfoxLiT~p#CG#R?+8A;{t<ZrZZs>l!uaR%}0Z+;sx4MS?$8-El
zd`glLEmguHU;+|a=+#{=Jj*#!n(@rB6K{JVd)MY>wkO(h!L-PDW8b{hy}736VS;t?
zc6jW#Z;5+{x)FZ&!JOG}l<)T_U-w<#bdLn@iJ#8xqXKnvMVyvvR5TPz=eT}hZ<~JI
zNtm(`XQU*le&B#J@d$aUtHglbUZK^BRwJ2Re>eP(+xIg<Li2Cq2w$7Kb#w;}uN&iD
zbaq#o|A8B-b5bKDC02IfOl;uDeaTn*t3L(idCkj(2TrO8Xk~_ezBD^iGH$@jGnO80
zaLVM6O2OP5L3(|?*lg!f`y>GBP?M?868+(1-&41$3gmXTK51gu0xE{lXdQKjxxjze
z)4A2L{`lRGA0N_?AL>{}6Zg`z1K#wsS>4|Jea0^$B)DbX1<U^n<`U>hxuBf-^ie{e
z8(+MJ;Qg1;iqWprt|_8?CaA>{{jP7p!MC@%v$Uc~+p?KVeZ+WtM~`aRo!t2mjaK2d
z--boBy;}k%hg>nwxLV?h<_k#WP){dvN(?Tl*8miJ07;vDgg{ru=<uI-tR&ZYz0wm(
zo8IdC>9i+YgAl2JWHU8m@jD@dOX@Wbb~jYbS^AG4cFXlNs@Z6JpMm~;v));9s`7kx
z_Ze1tdeO?&M{uEwfXPu6Q*HF#Wp(u<9QR!*G%sKHQ90VE9H2Hq@lSdh^h<GchKU|c
zJ%eJ58>zYpH7S>r&jJ|0U_Nrc>Y!^O5tLw^pHH=_1;;yIzbhcE@qMtwkto{$vlKnY
z-Y?wiF3H0K{3b`=W<Qe(?5hk=dq)_@G`030sZ|a5!m7PFcl`LL8|vy6<#UyYpkKpf
z(!~D02JUiKTI1t4U8SQ{?m5?vKCUi+sc34ga!9!$LH;PJ;zlG;=B0>Vh=*=*Nr90f
zuoHgf8B4W{q>xfD21C?=$z)ru*t-U#v9*bMZ!N^S$}+yLBir{U>`ZG#lSPc93DzBw
z4?*4dOb)#*d?xjydOG>sYdXCM|MImGgke{JVP(AG+prx|VZFTorY{14PkMSWupV%<
zPL!*xUVE6*+DdTn_Mbr7HzNOVY3MW$(2q7!Ty7-%*aD4}#d>lByB?)=B;O}(x%7t;
zh3Zd*UAoYM4%wRu*!ql6z1ol}da1^Y!Y44SJrn01t3}eCV_ag%N;X5DS6OTuweqa5
zHQ>I)1MwJ5DnWJHCb+s37^oibCEkAK;r2@bP8|$m02_`lM+gp<*_z=6Zd@MzPPqi3
z19or73I5B~IGv2<aH=Y^eU|FPvFZT~Fv+<0Y)R6-r+z?)eE)Iv`DvzBjhc*ySo&>P
zGumPyZ2E!jR8gJ)!BmL?j)qcB?L!=TDO`bX_K~0(O(barZnzv_iY1)(k#Bd?5#+J*
zC||w0n#%jjL}!zVjk?DFVxzyjzvP+gpKkB1_TMIS+anW@KZbvY{K0D%iud!7>Fzma
zuPK)pR%G9E3M8{mgVT?ZRmvgw#f`jPx9B{OBG*`Opqh?+r{OgrV|)_2xf$Dc?dcwj
zSJ-()HJ(EH&f0YyU^O37yW{0B_{5LNb}#;wz>6R6T@Ogtj;^y#_Jf&2F=O$I8Q=YA
zxTv1Kf8V@Pps^H&QFcT?;FU(w_HuBWm7o+D<2#0ihE^Mo<E?dck)I5)74SO1Rr#GD
zI1EY~!zSpZ=(F{z<Ej$m>EMdZzYXs+XZ)@YR~S3zNOAe<k1Ip8O*=ZBU3e$J9d-4Z
zCjzFSz;}&{XZQzcQ7DJkH}Xuy#{Q7;jERaTlJPlO`1xHSwwh_E*HG89M}pLT0wU@G
z2zYqLa9Fe`U;+FKu?RrTr63aW_j({2XN@p22fut+(q$d94j*JkWaLu77b-T7CTU*t
z4hOR=rCly4VqUu^WHGu9Zzt5uynYV6TCt|Vh6@?wzJg7|2qeHOiO*kO&Ey>uMfa$j
zJ}@860X}Gg1C0N^TZ;VrE2qOaG8D=<`+el^SINQ>0mt;{SZI@6S03*{{fi45PRXz%
zUbJFG4G#D~l#MPAOE3aw`LRd%kO!#dpH{#p;^untCAc01TCE`qZw;ezd}hw4a+@4<
zm05$+%Trx_(6gry^dmUS`VJF)ycOpHSTguOAzOEO@jNfSYNP!nH2$`<Rhg(DzW2vg
zAejzk;|hjPvj)505ljD`fnD#UYYGfiuAifP*$%~@a`&V{NbU`gw~v~eFKAe$YUG!*
zuVC0xY7npz-@E$*ua$Dn!A?BQe6iks9Nc%1I=wNl)zPtjdhzeKspw9GL|#=8;o&j$
z9-s7l(6^3^;LA>{@T=p?d9SF%sa3gI(EUH@^KDO5(<<+un|%~;Y-?bIAk{wWdLzx-
zR$Q-rtJkmR<ky}*!NH|lb<ZP3C<X7$ZU~5Ne%9foo>Kvca7{Z*aC@Zgz@qZWy{jK6
zzTCS(+%NhbIddM4t8?yV9tQ!K%}fq!RoXi{`vyAb)Q?xwy0FFKaEe>-TzvnLk+5K$
zNDstZxAT+mFMvNDim;bo<u>2-O7Ge}YaP%H)}@M{jCCqJf2mukb`glzqB^7p>Qala
zlAc~yA^)5baeqBcoAh!U?4cZoH&_AGmUWbj;~&5AXu<C5tE)E|e^H1MMoS}vy6uE>
z1PAL#lV0L@q<3ItFW&zXKsb<Yp0N*{`y&W3odbZ;f6>H$!zr3YAw)!MEh6x|_$u5e
zDu}eRN!Y`N-^{WD1gc(d(ZaBCh1WSgV_l8|{Za|>2ClC{B%l!_bs_&4*I6DkdRyB3
zPk?{^)_9TgYO^vO4>{%rNLKepGC5YY(cSJ<i&UO2At{GmI^-%87#RQ5daH8yKZmD4
z%Yp-GgYjF;ajsesrFA64(?oZ(0}MH)XU-9`9)BA!MZJ_BJO<aWWr7zfJ?=PXO_Mwm
zK$M<2;#0I#uCxH|?l%0e09v)8)v3!C-W&$Maq`!@eDjMsNOx8Mkz!~<#@@PhvLrW5
z0l&$ywpV{`PA~}1fe5A%OGQKy2|p0%u_6t+h#24wPtV!VXp3$O+$ob|dTLgR?s?ZJ
zQ{n-9UTR~}rs@tDt<_&b+L0pEg526s6?C(%a%ZkrjwQD!D9%1gx$8T>oiFxK1$(=|
z-Om^IB)RrdASsE-{k}Di@r>DU@GqWDUv=jN+GZFL97FGYzX;}S-1@M^ZzunFS1py0
z-rHuJOlDhXi{}2#Yv5lRTEEi9@Lj$#u1XF;*6jAm4+xy71?iDURe`Xb2S^iyLMG&m
z2(^vsxYUm>@!Xe_PL)weW3Wvx{4m<rSsmOyd6H_L4zPC4Kf3f`o&m8O$w^bR2R9oO
zR}nA<`OHoFT)^#0=Ce>`f5&ra0=y`U>!)}|m1xh&cj>EjtWE%7;RMGQQe+a>Z{0d!
zpo3Svk#_xB!C0US@k9Ajs>fHOucD7JV8Mx(3awHG8G}KgP=e-ri{cU;%xl%!%ORGH
zBRUwq6mkS|>)%96HScb5N}F+lo*^?SH)&j7|67BD<F7J+1VsQHulHbQpv7>7SL}B`
zQH5o;9+epimJ;TS;oVeCFnpkL7jvtsltij_C=mk(Y_k<-lm&VV>zB$|9;0T?hyDo6
zO!QS-$luG=iY6~?Z@6&uS0S_iW|r9@deX$XcLq^)?dkDW3iuMvJB(zM8@d=iL77jc
zm1A}DxvzqQ`9-^^pxl{60$*M7CMSRmqiX6h;GD_mTPJo--lIyeW9XE>6YPg?`(!m-
zb`BBb;BzO>{{--MM%<VDdq19S*NSqS;31dOx#0P*>vKQA(JF?sj6zMi9h_V+)Z6u+
z7!W3Q&~f;J5W*xu@10hHk3cr(pr2%F^8NYE>BBIR54N5w$P-`=YvNkYxJ83$Ag@|5
z-HgJ2C@pDiOVfVxr0YL3e()pB=y${eiKwKgKdxL+BlrZOm}ps|Pvm*rsUWJyE$7!;
zo+8o+L6&FR-3GoK&<K(8i6<X5)8Xf<9TEzjAU&yI4&I0ywh63rq=4Px1rjv0cH(a-
zfZwOosa#KustR%#?5`YypE?eH`Zl!)d{+xn$)x8XN1@)_0$0w>2^o-0bs*#CBt@S(
z^q_Ag@b2{5Q%V!E_da%mR)8sTMpY{*QWtFLxXwO;+SYU&L1XP3mym+jf+*kPkr8t#
zP@zzahmc`V(O#bcO{b<OWxwi4_d<7ED)4Vf?ReBZYNWmP3y1x=6{s$1{_Xn9B(xC5
zchCY0w2(?o+in8$%&rC1qoMBWAWC|!v-Hq6r0Kiu#qh(#S5&Gf!Ar;!dXAtlUZ9s8
z_70&^^pI{ZdPXc=g0`uu1NHWiwz(8EgHZRh=y}MCYt~9kU!p4s`@wYN0p`Fchts2~
zGoETe-=gRct{h6F<NlH!L^+!a6@_7x=@)|OdXH5HN&xv{(4h|%t(q;g)UWMHCl?N*
z<ABqHP%0kW>Qsf%D_lcRA9<wb4fVI^IMT#Os*mx(Z%<da-kt*La)4#)FiJ;g8?aRx
znlz@Sy?z#o7XxS8`Tv&Hp{9!xgyND=yby}#@GDT6Xav*Q&>YZNevF6QNZT{Q97u=v
zOu4xJe(g}vMV*6M{MCUfK|qLCbzs{jv>Zi6OA4VMLYpkiwa~vs$o_syXaszzfj)Mi
zR49Bm15YPl0+9csP_-Z-HeoAVwYl7M=Rk#Ez|djajlc7%;u#S|MaQE~bsvOk4fqmw
z3@Sq-q0|SJVIFKQdq!M;J=Z1VLc_>I9z^+g3j8)`zB<q$3^t?#;~aPts0!7gB#6;d
z;CJxBR2<Abw12&0n?+EaDjgW!n{XiOf+p30h0jpj%xXb;{m@`HNEPsDg^FIymI0Z?
z7eFaY`ln+&LG7oY?I=3#w^F03M%n=pXQ56U)G4Ne-+-x4wS(y{N5XmgD7`a5RPSA3
zF6Q7{0*3DhbCIs)8Bt8f#rGUqI5Dc4q6ojiW^=Vs2B;3hMxow<%nB-22Yw0pw@4)v
zDWsxpzeO4}fwZ6s<30wx%E1u#kX{dz<?R`$#$Fv5p#%K~u5f|SL9bAagEUA2#`Gc{
zm`o4Pwy9~=a4^laI&iZ&O3)2j+7F`SR)*>iV45}Pd4k4HDQNmo)3x)!v#ZE6pnD8x
z8v^ZN6hH(fKnGg#gq9lNTLx%jhi+d0*~V%C5zR<(pv4tnL{JGt22V||=4{Kxk*%4I
zI3fpdaXAj!O0FCI4o<(SfTj&#EF%*zqyU)iOwVy&8~Q&3V`Br}w%qvFEM+u<U=D#=
zFw#QPM|FM#5}nsK5m}i13fA|S0Fadm=jl~a+r&b9lt_C>-=H_VRCMijYC-T5EvZSm
zbG&LW9flJyP3hlfC{*DUc%(e4YQxE`HZu&}=7Jaw0o&Lw21G~!Tb2MoW{@@%f$&uz
z5_te1;RZa|12Gi_t_}eY+PdI@&oSr|Xs|-s2f+ul2wJ)b2$W36?JA1sILZ+zAHKrn
zdIUN&g$~nzb{vm_rUnC7nhDYd$n6`zlp&bUw@0B6M-U|mgubA+7+Qdt+sIguwn2E7
zR6QeFxKuRDf!=!{w1=Jo13*Rv6@iJp2la|y!6PN8$M*NpV>Qr~r#euNN2TEejISC%
zlMxZWD*!kc7{Iv$r9;Licn9XO?B7REK?@H7p@~`n5yCLOr$CqB4QTW>^aEwj9+1Zl
zQg;X;j|LtofX7(4!lm~Rnpn9bzD_Z!Di@04W(P1h1k~xxAWZ`)H2;1BlmWqlY|v{F
zJbGBM_N)DN*&|DJDpJ%_p#M<4N%$bc;bb%qPa*RR8)=a1Np3aGC}2K7z1mk`W=0Sd
zx8cD+5@8^31Qe)#g0f6VRw;{8p%_71G>4HUlzk?az*9_F2l;ppRhU8EJz!#f0`KGg
z{RY2|MJ*_TZB$hgG@nlc#Na9v1?Y1<PNF8405d8Kq6Q!ulnZL&5cc;0s7Wp;tck8C
z&<Kwdp^Q9IMnFN+;22k$K8&;ny1~f9)Uv=!v_4SaCQxgC0F-=yTo?dK#uM<f95O6m
zwTXsjMD8gS%}kiC7U+u+UhJB=!|A_$uPIqs8F&%U{qHX*RK!{M%@?LJ2HISQsjO8A
zrjtuv;nJdm&OuJ5q4O7^FtRWt#6sMrOF>d(ZBigsvIi1#Fl-JGA_sWn1xz&ul}Lmk
zqye{Pp;Zf{)yvQ-aQ*;skOyG7ks*7++$jQy^&pKeUPCVmqpENCR5YV)Sa>StU;BU)
ziQxx|dtoH?FcP^JQ0B-1x>SROV+S^4n4ldQAYBY3Jd9UCvz?r3_IxNA3C!99ZZ#WT
zsD6WrzB&pZMGgSPf%$KBV3aX93m5@zwcbZi{WQ$HFmRn42-k-0_JG0ZAjJL1R04vx
z0ZM^F4#6xH0)Jec;E_L44|uu7z>%g0<W2&)j=+NJFr|*XfNoMS0M>*4mM%h5h;xF}
zPXuXx0c971C{Oc|2JwM}8$mY+(6%A7XaH??A3)$t5)|766fXrX%>(1o0fCHkJtNe3
zRW!}vH%k~*Jp9%O-R1&K!Ux6(u!-v4I#iRPrmvoYYES|s=6WzWmDXE2?ui~51<#Gw
z&-cEv3wnXn0zDCo+-eOVg@9EuP#CFO3S5A15&{e_4mk7v7#E*2l+JPXd<ahGc(!;Q
z#8xV*z&HmObUTPUAR#y=&M<ty0zDRZ0zj-H0!{M+X92RfU?xrhCWDvw<{+(eHsA>$
zOgu3ADRd)sK(ydhwV)LyXuv3lYE%?P5C@=*=7teK3wNpL!CF$17-<AYTnCLs!00kC
z6zP|N2V642n`%K|?%F^d!5-rP?^Nk|(ry3~3PFz3FaO1%w`UHfrJYM%^E3naK&KAA
z$!!#&wOH_}o}#$_L3)5$Yy<p%%K~E5MooX+?m*}-zl4@FJ;7_>NkhzbAsB!7f5eh{
zK*SS1b<Iy8tG(x;+99Y`4ux(Us4L=)T@C>Nih<(lo^&bT$esqr$yJ&(h!HgL1<;{V
z55;?-%^?_VEl3Q^2zX=H55WZcLh*lK!i}%O$bdKxP!&}Mp0wLg+!d++4gohPoP97#
zWOSwQlQ7U9gA`$dA_#HsfH>V?@Z^9vS!h!Vrq4q_T{HiH{V8Hl>@~Cm9AxAjRSgJ(
zpTxjc$pib1q0QSsj4Mp)3ve*?z>7S6;y^Vfc%c}y(60tfgKY;ipgMgDsPh2mWmOAu
z^?+g~7lI>}fGR;ikb?(cRMnw8%vd2fJhdvo74TKB9|6^%fO<ku%mAsU4fT+@yY=q_
zs0aSQ5RmhQKZt6!1t`V<s3H$)!NGU{lecuqla31<Hdkq&FCX|+{+B*sC?5vw41>w{
z0DFe`tH^`Xr=UY^C=arS`gsh>!!%w7BRK?wg6=PJLwUq$;p0}rFaTq~V{K0awQ>N+
zDF$L)q25!~;0QI4OT<SzbRd@~V_?V<5H@oJ+NMO>hOx+l!*LRfe-04)5e9z<MCvI*
zAc!yHfpDVap1`9kQ11#nIuHF-!vMGeYi>imMW|<k)Qf~dKqvwpj3A{jPPsSm2&8l7
z5Io{R>cPx#!vw}q(_LqTaU!RWKGlJ7LO_7{kWbYRF$-t`esBYeFi3qwJRd?In!p!#
z(jZ2#&~L!6Md1341hffo&v)P+2DE^{a|5T|Al2bp&=<NT9aX*j7{z_@VlWs25EoG>
z4lV!}_>gZ7d{`9&IvzePn3y*~R9bI9?r}ie8|Vy<@@HfR2FD@KplJg@G{jXi`P*AA
zJURxGrv|;jHwgw@u{WR#r|G%U1gYuUZz9j6p*~z_r7{l_ggii@G=Y~U;EM_J!5n}|
z30MMw%H;!x9qQRYy*?<0fO8^rli~;h0hk87<kNy;Ae@Zg=whBALjq+mfVpD?UUot;
z#F425Dq9eV2c&QXmmTUIdJIh={oRL08Q{YnZcRK(g=&Lfr#+VCIb{*EAU_Zaa3hBh
z>I~8bK`5yM^WO*1!c$NSB*=B8gchFt^@6z%vVHs{U!FqGM<C$uKk}A^MC~#V2O%h3
z3P5%{1jr<Epc=>nm{c|3mj>L1jbVV6uXn7Z*mJ3@f)eveBC)%k9XZu$P!S{~4FE7~
zh=QVs(}+Ak$N<K(Lo_iH1|33hi>d|OfZ&#jH0UjOQ%FRbQYb+~Uj@Ebn)ZkI+xZ_r
z7E>62@1_U*Lq_jF4JasY4<?;R*gLYOorUD8S0S+j1iuZ=;I3w9QI?IuZW^^){-%M&
zvU*`00qjN)ikttVZSaali3#hb9DDnda*i^vk}2epkb^hDNF<>NW!un7q{vIsO~{wl
z3+0^+g*Qm$VCjU-H$apHC3pKm@E4wUFCd9iqnzMs(V1%$?`p{S1u{{`k(e!Iz-H!%
zEV3YAt{?nxD)BJQ2lWD}?w<Nd<=rv>z(q-#cH*1?_SJDAyEo9w7Sc<F*ZNqfG_vAR
z&>HuLg-VY!u9%syxw~#ba5;>O<rciX%QUhd7*p_P6x>D>%uoC25jiEoA|(^#0b%Vc
zI8u~_>0r^&kTC|9LV`Jm+#S1v$sn!v7=(dZ7RiPE%^XV)d-6hxmNVpF#o)w0Q^;zB
z*ZP!YsKYjXy$Z-dU9^Q%e<-nZXBUz+=8!ye9<!CM9bY%o!kj(S2HzneBk}b1-MQi1
zJ~UwiPL+lSg7L%vBBl}L<?>jPqt^Ql_Y%;*hhASrzj3u?jB(wKMDltT!%rsZ=~tbU
zOEm>FQ;h9d($KrJnd6@_lU^O<!`lVV&G+PmQ*vy3Wg8)DmeO|=CBx*_R?-?tQ(j6q
zir-Nj$87(0?71|QEX8NS@{bj=!2gpe^kww0r!07)Ts$8Zo-6N<LSpknTct_C`6SP|
zzLRZOGqzIV7g*p7T=?QQa#Gw*U17DeAm80Yj>Bv1_x8BJyv59e3uA}PB65V?){~7-
z>Sqwo4d2eUeft5_Ec-V~?}Pi!Kwd4$4=hKk$Sy2Y&BK(LhKu^IzPx5=$V?m|;)whv
z9Mro=c5(98@zt5saH}Wj$nXzV-P%zvj9QZv#~XfN>758$Ikz{zKVO~b$g3A>90{$Y
zz`e{VIirhFICiVt&hg4_PwZ-&s3~OQ3rKa#W-7Mlv4r_F?NqWM$$0{#t4B*yE#`BI
zFJssMhB}cA2XV)jYaZ{R6=BUc*;UpxLXmQj9=%tTXz`svS7Y&Wk=Q)JdOXW4=M@28
z^+EYU$N*%9X_fYUeR2EpA7GsV=6USbCGm$SS8KEFYNoMo_~*4p2XLX*C-A3W@uOn1
z+xYe6%@>ZveWzyEG<%T+NmwHCRlslP=fiQ+$bw9)ax4elec!G<ousW61o#$VG;zDD
zAY6l}Bwu&5(nAxW4g{I#MbsVp%-mD=48-)sjWbq+2_mGF-)AP9unCQLiC$uJRav+p
z39DV0e@LotLB`6|*l{ymX6qw1Tvus_Z+L&vc(v}A^!V>gG_%>#O=kS=!puwDvBLeF
z9`j!toOQgqN-V5|LT+UJ+W<fC_T*Pwl2$Z@$`e?_lv!JGs`*T-^y=Mm1rvJv$KGoB
z2wsXX<@77nAkXwk5dX{%TIE-;wovbc-Wv!GJ}Hx8w!e+xyx66}?ux>wg>xvHH+{Tt
zUYgv_ASX0gc{|<{4vent!S%@!=JJ}@%<S4{b;qy|;+cr<U1a%Ntp(?i?6=I~1cM(|
zKZu-)1ocOhoa$u{!d%{PnX|*WhOe2`XPJn2^NnTPyWZ6-v#S^dOmE%puIFaaNWHRd
zmGB9r9V1u@@3Vh+$E}vu^$Gcl7FbcVX!=N>@7lMvJ(EfdIWBaorhK`I0gl03O&9e$
zJ-aqzPD8fW5-%-%E63<KeLMwih4&n-xzGqL+1o-`kLjmXg0&0LSD9wsQm_Z&TyfT*
z6jBLpV9j57Dlk44kERpFmPvq0y+}me8^EK9%gD9$(XRAQmwH^7>L!&jA^?gizQl@U
zSWZd251XFG`q9ZJki9wd^vL$8pU;y|j`R}S1c~OYX^p82U9hBuEOjp7yYNVEJ$8~Q
zNnZA-(nF%4P{%4`0M>KqDbskJEs@^7V-|Ma9B%*f-KXxV{30WI(*XU>)ywq*0uuhj
zJ>1w+CevV80#sL5zxdf8!L6?Jq*sHgRy3vF*Y^4DS~Ou|>-P49c&ueT`}(HLTJZb)
zj&H+S(Ha8A#rs1s_!Sp1r|)Y`U+F11=|=F;=od+fe#!dTgr$$;kSU+WH3e7s?I)3;
z^!i20$NFRBi6NycgFmY>&zc`j@;vjPa?v{0hv6ofPd%V8*HN}A`?t|VxAw{3A;_8%
z2fj<&d0J7o7Pf=Hipsa>k@)@A{1K%Kks`Dy`mmL%K2leiwP*00aKYJkmuultuT-az
zMH&u+31pEAR<`5wU1!^yzQW3J?LS1hzHiK^`#*cEPQnH~nemv_Yn6L?_-`-o?1s;e
zy%r$I`)@T2#ai|sNgsvxx!I6CF(T#L``dLf^jgs!!c=s{Pf+)4ZFg&Z)N3M4aAD(@
zI2q9Lf1G%W-15@2)5x-SX97J-wuU_K4ksYXRRu}%Agp7h7FC~8xlzq_+wG&>153e0
zvu?4IaISMO91^;{7L6T~yUy30XT~|-ojzXFV~Q;Ji8l(t>Qw{p(GDw=AXk>s_BpFz
zFWp-aU+nHKZ%@%*uvo67P$&AEg>XDL;_Bn(Mr3uWtUNQNylSU#Zd%%~HB@FhKxUOQ
z%#9(1oQjSV_00?t!C~0J_=cs{hl65f;rOk-)9wS7&o$GVe%&~ND4;bHQObXH<|VRh
z)U*a*a#il0!#;j=q>bc+;Av$40W4MWELBWbWl#Dn78z{Jc1XkdKS#EV$&t0u?TrrI
zaU7QD2S<NkLtRt15WN};f{TWkQ7B=%+~$=<UfqyNk0E*Y{`_BQY8O*rW$0EOUeLc_
zq0Dn**33$WBduA_h@5KRYQUG{<W$<auyR?kI<-8OYly4W){eGRG=L443q_4dzw>Yg
z7JG}ux|kdNe`q-g+z0zSS9Sy*C3W0Ir6|tL&s+S|)*jzV9!iX@EmZ|$k*W(9jbs_*
z^?J|eM2ftV0!<G$NA_zxn*5b8UC4|&H1guza!tX@<i@hoaFD5D+8K(C5h?c($LDE{
zX*5cNQjsX^mTASt+OH<fJ(>gf3wEj*;Ut7=Zl0gf{{*kxpaQUfu!;z)45F}6xM6k6
z+FN4xmr2BIaO@WGj=zwOJr_4|7L)Q>FhEJ!RvG}J1n+k0eAtcV;zTNFi&QpiHK7Z~
zdp~HAJooPM#WU|-IF<~FRBc}@Sa%n|67kCxKb|RD(##B`jIxx%LfR>lQ>Y<LZO3QG
zE<eHmE?n`m`^y|`ny#70SI<6|{H5^uN2iXyfW_3Cq(P1XD!qqDgVKd7ADAfYbQY}k
zvpQKdo2%fYA(Jn*KfhP^opLcRk{j97(EMdax^?=9iV98&yfE|5;J|SwY;mL%nTm8f
z-G<rPSR+{7mtQYUW%{rJwj*9aFS^&?iuLR@IM)-k!UX*|c2RQHxwMKpJAI&%9E|UE
zX<PbTkjZ==6=!$y%F3)Y(=<8ROclb;?Qf&k6kVNqR8VrTp6%Rj#ibVTMbR6!jxl0j
zXNYs>>*w{?U<DF!it^_IX~#FEhhYg&nc(bKu?6e#svs`D8_M>uB|yk5_blf1d{vc`
zn=i6O5ZQFIyD=;Rn?3~3!+t*i=G7%1Z1}rnhu!v3+M=wn$`Nd`YY2Nr%)pUKu*>d4
zllJ*T#RGNG*gKz^AufO`Z)^Scj)cPcI1ACYJ4iFnm<fv?8i37q$*}n9lw|e>s@n}=
z!YzIz6Bre-+qE-Y_VH<rvwG#r7;T5j&0F~cx#cy;uDfeRir~B7)!vw`O!Q&6n6g?K
z0=v=d&s_+(1tt;=+q9Ig?sTsrE0dn(R+he{-fpll3>3k9sGd{6#QeEk>CqDdiUI6c
z%ms&$l5l%2RN^Jr&}kzM*$J*7sX5pkk{vdo!S3bR&hHkpfpJ^S>8OhI+HZWm4C|+;
znW$gCew{Z{V&rwCKw(mWw+Nt$hre{Z_3RmQAJ3h5h{#eH%cMzEKFz@eX~^PizQzIz
zeJu`;R<EJt^glUXB`&t!>qdv_zZy>>=w_ygL8Uy@94ABNyl)2D;N!}VJB1Ro1VhJf
zLV{{zw-HAP!)8qQCE&qQa+SCe50Cr6CbA_99;N7;cywX;O-NCE<_G)GNKtJxPy<%4
zAQ$<6KPvRc4x0F{CjmTsDzM`6-#!;L;mD=`{&^9B;{NadM=^4fsQr%zf@+Ag{<n|b
zfp78O9;8rF|Nnu2Q2gJ||9c!kUY-y<i}l?mq-mp27!uH(|N02}k_PDo%}GCa)nkfQ
zJRuUpIj}KzTz=up1$A|{hu<DwgX`E_y-<v$pY%mry%lW2Rh<`l$025Q_kOrVmcQRM
zY1nv5M^51SryK3*Za-H!T$*}MDtJC@x8(nvn=29};wQ_2-tYOHXGXj-@USW70&n%Q
z!hiJ+xpl4}o&wL+52Z7EOjCXjy0d-$p(5$c-dUfTJj-xut||(PQJ7X#T$i`L$Y>j|
z@>;{69&XKyt<Ow&WY^BmKNlu%Ro66NJ>i$jtuo`m@n0>cc*0u^^oBQ$2OJ<My{v_=
z3(beyLz~8x;G}Jn>p$U__?@z>7Bu`|IQl&pJiQX#-5Y#XeP1n`pCO5ze?NjWz##RO
zr0v#bB{**KxMH&sl}ZSh!XAsYw2;{P!zYwtUA6erGo}`0EUIT?>rLDUtj{m;@|-y%
zr0u;m*(eg<zTg5kUxHWqw@DQtfKL;3^|QWfv1!`S6XrCDnjnvTPxenk_kmXfsh{mK
z)3nJ_SWiFuGF1J~dZftvyH{c#86tntOY0CMU!J%f4Sbnjjo`j;>{BXTTE}dK<Bu|z
zX$`~h1!c0AqyJ$<N(_E&bPwK&fK{YAa;o<YkQmXkLuR|LfKwCm>djW$1(#!e%X`b%
z<W0}*6?~-9@sK_}gXn^6xbO&)jekeXH~qbjcH+oeIoo#G*O$}Zh=jUpW_CEQH%nUz
z%TLARi+Qg6Nz<PHI=(nZ5_b3+?Em~{eHt<n-2)Er^1<Fhfm7P`)7W)LdR<z+)~f~^
zoTNItYS#>+;nu*L8;j+BZ=<7~R^8|Sl|rSR`+i4el(~wB+y|sQwmFPUhBELurj>HA
z%lkayZ3b?gWURdYNmwarH<WdJhbbw1v3Nk_j1ab>PubO=tJ_L(siVZHe5?F(vD7W}
z#x>uS@1IW=)~C29Dx-?8!0?z%J(a+NHFBe|+3lCKCkWWt+41n0XXO;zZEmg<^_V$%
zG-uh_k9S~n#rN2u=8U1~Ft=G}cUM<!d%9?SbXDO^hrM@sg|jRM1_n&??X%gUuLoRA
z2Qb)Y_O{Eze&z#tzUeoou^<%{;v+@3#&K0Sj#&n#hH;yv9?MEOO5GI3?F8FF!psaV
z6ZB*ld^=$~)}>01`sRk-(j*g)q2}fzf4Oh-d@@fY95e!$jp#usv0K>jV^*V=@^jh|
ztPNR^Q^l%x_i7l6qTKA8WACnJjt`>o4>DS{ETZqo@z=eQ?L;&#<aNel_m3l`VjTY4
z?_;DEGb&mQZrrM~%}hF>!S3cd95#dyoECYt$w<n+yYhFY)5z^&2g9aVarx=+nqcfc
zeP3_qr|4-DX`ZoKer@xK;6RtH-@Sun;q}5LSDf-wi4#AkC4A2A*nRw%4dOMe4*RH`
z>w-GO8#O{X5<P<6-z+MEu$Fj+!`tTSRrcfW-Z^jluCMv6!P)V7Wt2bq&RZPqO0dr3
zU#sH+jEhX?QS9lfMZ7#j;z)B&BoOuf`P2kn*{^fvxAW@7=)#lUM#%6IWO+^Rd`;_f
zs|!;U2~#EnCD<Ev#KrmK&TfA3AFsRp<)P}!o*yvRr4#L^n_Cuq>e<CDrWVD&MhV~E
zz7P8|#nxu6lUigmUi|u1YPpLpJjv%!dP!=?-Qq%4*7)|gZZP;V(|$^3#@uG{DfiI0
z5wzJ$ahWh>KedF1)giLn<=sg{-^ExA22)DdwU2k~xN-AlEx?p`7`xA%!n9f0VP^<F
zb9>Hx`;NzrMB@sI%Ut?55{fzr!Mz)OPPR4Q%3L_Zh4NzJin2!)jVe5^4a*6g5gK1>
z%$zE;H?m`GNy4ji`wXlwJ2o%-jvKAxb0z%4;lk1rkpenRKL28=%Bt<jAZ7DL3deLm
z7TSb?chkgX>5--bz}8BBQPb%(2zLmAdvOSI=Y`ko<wEjI3gABT^3zHFQ?sR8aq~u!
z@>hPmQqz$)mUf>!u0I~miLU5tS<iu8#1?a%jmAf8BoL`7UC)&t-<@}|k&^knv5jc#
zI-I>%Fh4baZp77C+$ou!R#76e7OyO`_t=Uokp?D*5BbX&QZNaI{H?=MV;hKat+r?-
zBW?t@UeQzM%U$8iqNZnH;-`~EY8s!l^W<>r$in8AjEqw)F%P}3B>7$)o?kgCzYyUu
zAWS3k#l1OBW;Tr>p5_)DB9}lyxn^5hRdgz)Z%xdKk{I9d&?HIB!s>aGTnS=Uw)*Xj
z*qY!J$OB@P2;-a<gQcrpJ+^W$o#FJqJW0ot?t~5mMsi_yahJ6_p~6cHJzP;S`m;GP
z{$&;V-tcsHt|0?3+hJX*L|q%38ak5di-ld^$VX*0?%X}!sU#<Z;UD)SfhZXl+6tjo
zB4mu4y(`vx2vW29uVbEb`opRT9OJb0H0^M}QW^-RjL(>I$u4arQ}o%8!y*dUoAZR#
z@$m755Mo8&CNeK`1O=mxD7N|_>T%=a91aImgME2TSl7H5UvPKy$%#M|<VAJMKh>_>
zt-|+oRwS+uf;KuyDfISEXfar<j$Jf%JxbCL1-cVuoZ+;^QU;tu6ryFV_9fFK&8eH9
z{~v#+u0NRnuxxe`Zh0U0fI+)<z4OX@4%+F}lZ>E*YLTzeAzG=e$mHR;f^2}QQ&&zV
zd*I)9bzOtQcnf@iU#qEExeh&Ea1D{Y)ONCy8CbFqa2K3<s#uI~8nZI_5v!YvnORP2
zM}f2kptRIgZ!}f-T^by0k~P_B`ITM2qa+RBGtfy9r|e`};8@0K;%1pu9T;ljRofXO
zk6XQ!Q@)n?4$LxZ`DE1WHLSBm{G3hrl)pxNoY&r~Qh1hV`tO7=2A<XzdHK)b<fh$d
zCse=ME&X-(tmT~(<zV-xDv}e~r{Er2dwu0^VV$m6`K3||9yi7(&#3uWSkb#dG4dY%
z-P0*2{ijJ#Gf7}CX_hd1xe223&u$r56B^>-=d0G6Fl9ekz3uJ#3**lZa6q*KXnDqz
z<TW+h)Eapzk)gn9h!y_g3x?a~=9*lP{|>+vPU;SaBqS8W5TtReTNLwH+V|YZH>=(5
z5SSRkHA|O>eC#P5--a2n0FV;{S1Z;MCgmlV>ISbNcs%}HmbO07g`>sz$HpvCVBQ&g
z7ccowy5(NpQ?v^MR)a|{BIrl+=%P6pluaTs%zdnq-NsCe`})R7Ba=jrAw%3?V!^^{
zJvy;`INJxV&X$c8)pd$@_Gyt5w{B@LLWBRcz9c=e`2{9=sx>~kV98PZK{%j!O=>v)
zj1!fx*&os5XDfFvT3X(5+mviJHJ*l243~Z9b4niNc0~##Gk`<HEIs(pVo=J$N<n6N
zG+`GS>dAdf;lI<HD!a!j>Fuhp+nYC5%q(uv-`wGno31k;lcPwaWP5n`<@BTdS%&jH
zE0og;2?do1<vy>9(AyWf$LkiuD5CE?x;D&efS9$ZmPF2u2T4f`F}}_}-z22ifwl2c
zmPbGYY2AEjaHqL=@<ExUch+#~zXN_W`!+^lC!u0K2e8l72fx`g{;YWPrh!=`Zcxf!
zwEsg{vHpdDoYgWHmwyAX%k}!Yitk*h`5kB5qZ#^~szRv1(fu&}p^eS8P4!xLsz$pd
zfPlKXO{|(wS6A0$6XyCgLuP|JtEo+#UY3g9HE&NxUsS*Eb_Tn*RDQnE_&iL9%yPxy
z4;2*(JUmBb{(Re>)qT)R-7jpk;b5g6cjL_Q-%XsupKhG7c8znDOZ1RRV-~lvA_Ryo
z|K^30XF1`8nkxx=c_YnnI(DFX&P`$#7H~woFh?W!F^|GBRY4}4`z-YznYwg!_0+)O
zxZ>gUP;a?v?`n4$!mHch`O4<{-fLLR)NS~j2hL{c-jbnn&FFK>sIJaV#B5)?S=3=Q
z!h|x){P6XBE|&1DiI{^-=~>v@Z+)UDE-nsqy%D2SvC*z=IR6S9k7<@$H;eS|0EZE6
z6uaLLp}Bdv_Cfh_l2_F|ysw$&G;5CVNc2qVrSO(cxD1^`KjTgm1Eal>y|zf1>*ZH$
zV&{K(Zy>g|{@#epS&_1d4+*g>2H@{y)iIehv9mv%__*-pE+mw+B3nWbU+75?;st`|
zm0-U-HR#ooDBE~dcCxd{or0EwE!s>;@|12|Owm;x9i1uPqRsv3!=p4gxncUcvXb*B
zok~aRz**nUcG+sI=Lof^=ZN0y&q&?b9P;1Gu7AlS`b%~hJkwQl22rEi+0<+DrgOWN
zfK`sPb<09_@x?0UxADam;8;mq3OmVMGI(AwOSlBEwRE}42eB^kerAX_(xT*Jo{_WT
z@tl)B+SJ>*MKH_>zf=;t3pRb}%a5arEM*UGIyw&bUCbO(P_)OE4DWW7&M%esD~R*{
zH7;K){}Y#0ZKPvEe*F?HIo)s*&@UT&VWpfs3GiAGpY;U^o>IMaZS9uhG&o6xSySMQ
z+{R7Q^@E39pQ1=n<ei+8kGR6XPKpiAwyC`|nn0BF;PVG3zZDl)y|C{cnG08fw^1Fj
zYwvp9;VSjxO69PkTI@NJrMxS6&^d%hPHyNx+^~=6yt7N-6={!b`uvN_9zUktC*_4K
z$`_06*QfnmkVT@^x_Pk_V!$mdlg=ji_VH#N?Ow)!^Sy38L*$YqC>tgcHJkMQe&va?
z@{64vYlQE<Gw(+l=IE3WyQ_-HXxVQuG@OT+pnkPJIf8-9LHptRPl(HI-PfC6KZ#F0
z5BYK}f#f$GT7+7rXa^~kll09T>+7Nl$sQCnb%{%?$&nc>&(Fp^`v>0hk{PW@u$-Kn
zM9fv!4j#+t#dk_lJf0Ti=mGxc1bM-88rGzBqLaFV)I|3~_R8%K+Fz@J*u|&Xt_1sQ
z!{UO%iL<`v=QGsv6ncJKOVzM8>FLQejARICLbM~Z8!;@E#Z@~~@m_g>p*k_=l!R6|
z^Jk4J?~X<q`-)h#CNa>*SD{8$ru$aohPQjSgv@?=4bA6Ob}!+0&A1%*x2e6buFBgH
z^oH{zh#ZqtXWXlSDZQ^)wbeh!ywjpE&*?H;5B=1EsX*3uB8w_U6<e7y>~q=m0fQ2@
z7M*1s%bs(@b$mvRdbB7A&HEzU+g@dWeg2JRCP^+za@VW2y1^PHY~3{s=Wwp37Jz%T
z{<<(iI*Hz1EtM^X1xw8sGkK4taamjpr{97B#Qq$h3@_?AiEb@Y5YLWB%@Ti`|H%R4
zfPlI4w28;m#-!c3LX2Epcyfe`(>XI8n%oL=yQwl@)bx=GEJ)oFmROar_c7F7d2b;k
z_Pcky5de_5-~xa2)etd@qoHweCCI|>3mAT+%N3e=iA?UGopDyD1|Ma4^A4^e4S0)t
zyZlFZ!+>=PNKFA2ny!x>krkTu8+^0QnQx04P9EGf^THVe^73lDYGPTCN-puo4P@8*
zER`7)%x84W-adymRak2fT|2rz&@Suf-GT%`CzK07$(?_u>l-E9z6<e80f#R5nr!l0
zr4Ze&LS#JlQ{co@rz~NE+IjADrd48O)bR7*hPaiKQJ1#3k)68f#g^ou*X!l&D;$Y1
z2M`(q0+->~Q336zRH$+~2RUa$HEL|N?5)Ut;WX}6SvKQW2awH{{w-gz%4-c)Jx(VT
zKjmkz&#lLTVX_MM!0&F#Hijwf##ps#X``E_4(sP?XNs#v)KMH^i`i7l=t(CF2ora;
zA^e`$8urm_adX|&;IuRuzbe03n85r9j4_jtL3VKDRV99kMX`@Vycox;US3|^l3C8d
zxueedIc2%D%;))**B~NFu++)RLF~y@D*MGaNwIs?+cKb!=6RL42OSOQoG#BT%(LIS
zEE2C=dwZkqXfp|WOIh~`Bxkn{6!%-r=eV?7yv6P{oSNbI(RVQuB35B1N8zV?2ryY2
zx-7;7>r5AdhS(ExY#V{mlYVHALFf7e%bhT6fuzTJCYV6*tEPk4{w7-j!U{wZ!_u|Q
z!v1>QpkxdJiLT~@QsY|{s-NLNc!pE2Miwd?5tkYH0~geJQL@KzRdEmeq+0NKjqg|k
zA<huKSad6T)aR5C3cL2MK&E2YYg)?Zih-$^q$zr_$ci!n3s$Q684GJ?XJ<_zY-#}C
zC{`Tx(AebR=uUiPo*W=ijIz_P)sOHT1aS9fJ`1^!I)oyQgH@|Pm#P0wdg<s0dT>EZ
ziappp+Qj{5`S4in%Q$>O@nk~o=bTV5Yajdk6GBToAOuGIxtzF-_oKJN<mP5%aAw$n
zg)Qr0C0<i6OWVPRKSGW7l?pFGXhF05`^nS8V}w2bVg5~2n_`-`BP39e#k|?;0i=*H
z&Uq{9Dec&=BYW@plmyLX3CThXrf+(!d9c%Try7mcCrCHvVj&qab=JQ5NU*U}flfgy
z9s&!Os71u&$R+urxun@^Kgq67H;cC)RiW(nnoe978F9o7@y7Z7Bz&jL`g%!_P1eqJ
z*xn9oXSa<bO)BeB)xZPx6Q}NgGmqWf%o~Guo7`<?Y$0E?E|QnMzh-3?e>r{4l!)M>
zTT=h|V`laeudbFos(o?P-ly=Qwlqx~qV%@Lm0&*%TZ=k#?Xnf6UDgt#n~N--9btas
zLYCo--(mA@2)@-b*mtk8$IK^3r@n$;`sZIu7|@IukXu7$m1{3PIS;&wHEaaa=pYqy
z19YCg%<n4_V){eqV%*sSZ!tR-jDF7u{Cdd&Bkj{D+!0T+FS%78t{etI$%q5jqpbzX
zF^KFN$_)1YEKtVL&`z<cxFLeGAf{ny^~52I(potJr{q+%PM1IH#|G)26U$;HbyE<L
zfP+*65!v`sx%H%CUB&=&8(O7B&SOwa+<IkVO5(_8U;L)@M3Cuv^FpaCP2eqQ{J!)w
z5`7gX*Syq@s`+Z!_{eHv!A2M#CZ%Z2bjQ;_vzt@}*A6!oY)}5c37AmmrBp?@lC+r=
zT6I@OA&ILK$;vAMWbu9vzI}Vl?#`A&O_YohP52#W=(5&)r#EGG<^nx^r4P<_J-^U>
zO9O?u<YM+>I^H=Ce8}U7J3M8j?t-uf{GpTe$t$#wju20U2vqp9*V14;lJR*JThcnS
zLU+rhr@H%D)`M*vr;`*_&$(kG^v^j@=x3S^FU8Kl9lm3OE?6ccm;=o)jSiwT_R;?!
z8CP5o*AmwA+VPoh;APimQKa5EG@9;jeZ_T(JG;sL&YqmX_{tvy?h%i(+!VyB6Qb23
zht0VzSv>YqC<i+dGXM)hkU#?oaLPnwK?9o<XUUGroU>}iNatd9;}ZOktV>gzn-lVP
zC2k{nWhBoZpOxTN58f6B7%XR^pK`diNaCCI{e?c-!a1dF&~3}5opA6_Pw6UU_7NzN
z{7uVO`DKjwyfXwbNPu$t%gWEv(PymVzw7<ql~kE2ZP^%)U=R;i{@WT79mwJkx7CXv
zpj;`r?&8ye1{YZtH_OU7Jy^ExqNIVuyVglwa?4^8T@r((4t-xMM!y3(t^P@PK3>dR
zGR-y(&iU9<`SLHXX15-*cn|rK=2FG~gfJyemw_csiF?~tBaw(}OPU6`C*uX|d6y}(
zuur3YF_QDc6}VN_q<Hv;Ov+Qjd!5Ry-T7t;Us3R#yRFj-DA_2um?b5h>XCFD^7pyF
z-yL_D+@|SB(3gJzWlQA9zmx^s(H7rwOM7wS^G%X(EuD~(Pq0k({aV#LFx%Bs){6V*
zvI|VJ-2J*!sNzA091tn5^}`LZ9;9^UyMT!EW)k77(p4sV@er10_tCIIw#%}5?~~~#
z&z;HWW3i#4;F{4$51w?HR^kX(+?uh%ZaAJ)T<$hT_fPdP>&i~1RZN$!N=kMKbu9$H
zTzu{HthTr?2eBFJ>mM$*S}FEO_(nTjn%qJxjJ$*K;ycrFDdf~2<P#7S3Q0BJ>8677
ze#uAo>h3uYZT3tJ8s~oc^fT_a@W`KKYyau&?0OLW+|n@(=U=A<APWsia(Hw2IP2UT
z&-G7m_Kj0<YZsDDVmOrr=}@Pbg+izBMh9zTZGz{~(l{0{DhCs;08UMd^750Ws&K$;
zB&w0cm6`d=`k)99m$_i~3-xsy`>nya!j;@MXCZuRN|qLN5v^R_8YtQEGsbL8Rus{K
z_vo^ed8O>Ez(SAbSU@r43a2G`#vr+86;_a~5q?tof$st!v*G;kqsEOUpN^E`En36y
z_-8o8^=}kuq`6}XK~+;ROPI^#i{plVln_iaL5?BvlRYGOWRqu+)F!0w&inBqflo<u
z3^U{m8e=Ed0Cnmc=y|0F!asl&7Qy=3S-F4TTi)|Jd%Kitx<WEHeRVHlS-gLknV0oB
zBP$Zcwa5d#gbWxi5=tS<8H@dtsHd}#{jWhRq{o-%!m-pWu)0lW<Ot~RLJ(BmU*Ua3
zkP&euqd4lIPsKA5{ExBRe6vXT!kYpI{BAKNRs7zuiLsX=wk{7z16n$w<`IA76|1xo
z63xO&fT`!`P7~A04w4Z<GOCM*0+pkz`M%jo>$dtb5B_;YJ<gzrwy0xcLH^*j>(y>!
zr`ngIA|V3Fw_|V>-GInoGy6N0kR_e<r$4~SEggHoX_?pqo~68mN=%+k`?l3pV~NCj
zWwQ&O5R^~QoGsSyq3~<yNt)~Wm2zLngx#jO=cp<Ex5i>s-@i*g4rK+cNikg-pLIv7
zocC7+CW3NKfCDtov3ASY@m+aN2$4<Ps;P;(xj9KO^Mal5{BK?ag7R~JR(52(&+-l2
zKm&Lu>}~I`q4%i`apxK#zD1gJNiLVf8D~O@uXxxhKEY=hLgC`tL>z=697xir=<Eo7
z9EmfAGEK^@bjm3k^FU0OQP`ap`;NUu1Z=?FvCJ88HTGFn<eOhb;+_uL_po5&WcF;?
ze|a!Q!PdO{Zfod;)Np0Od_~^R9_5FSBM<|Lp7*#5hHkZ`eEI%Un{`=m_r8YZBXS7g
z&Vh{AfBjrstiK#R&3bpYX*uED`mn*xMMj8_d*1uWqBL8;$ysZ;ex&UhpF_&KH9zOI
zUHd$@+W{+(E*|8sN0L^u?B5`6|JtW)Gvc#cnP8cd$ox^3Y?rpdaEq|FJZ(|}(E~u?
zaCU4E$nJS`n>0R9na3QAfm|UO<Kr7=-ch&ez)~032=?hjj|VMG1w}>Z-UX&g9VElT
z{yuj$dK~0{oum8nNNK)Fo{*?$`1e4{`aj<Tk?0%l?qTXNLp!#(Rpu;4`lf2b`XjZh
znS!X_&g4-=+8rxCQ^MSul-ZB@xw%J53_DhAgFegLvdfloi7f-Uv4Cp{mNdM_q$&-M
zz4rN$lMlJ!b^o%FA!`-?)mnZpr&C=>F8vSFUr3rc30S>O@o{al(atWfa;wF#7%~Ad
zkQ7dEpR>*H8TR=<+`WZc)Z6z4I*N)xsHg}?C^iBr4HAloh=fwoBGTO*iUOj9pdgI}
z(p^J|2q-NG0}Mk*cQ?b_wNcMG-{1WM?(^Jv9y}hL`ON<8&)#dl>s{|!OOoVH6mrEZ
zhw9gxWK61*24|-fy6eeIV#mz|Y7yxHd|;GIjsNuFgu98wZcWI4D&Figx%6P*Q#%~i
z`2~#{x|5UmJdS8{T***tvdZuU>5q58q0duFx1j%}ku%bfGVFkNTLvQaGz~vEl1}-;
z5RpUYn*K7uR;<t0m*9X;?O23NE8qHtFX4?^F4NHtt6&(h3rvohnws5%t7})UUw?5_
z;Fjn9xZOV?%q7uNc5(Ew=ZP~2bWYd44%2o&H;r9n;M3n6nR<OIcPwxTg{9ES7_I){
zus&%MO7I}LT{3N-DIVw4xF~ASG1IqhaffoX6cY|CE&t*x1)EYwEaFJE;xGPim=95}
zfulRHQQo7m!V)c8?JY`r#D0Ib{5|@#Xto|zI_<S)WhXBwB_*Lsf<vPpE0yR46DO0>
z5i`NPJ=iN;UwB?T#I>til(hC$M@&Cobp`q%MRi{Ej)FqSo^&4N-#pV1urlLnZ?wY9
zq5K#(@c}G0pet%smln9>^4H(Y`<KFj^K0l!AS|lzWmCLae!U>AOiwMW&SJi-C4xm+
z6lXncU2Is(W>RwUa}=tXUqis8#%1A~&|Lop=(daJIlkeCTp%iJ6Y5Vdj3o?T-m`jR
z6^IQ1Cj*iOknYWcf86aKc$>zOIgUo!%eVLn6VxES&UX>9M=7cn@QomxE2HypSUJGR
zD`pH_-t5M{#_IV-VOp4uaEFU+@!f9A(e-HxcT_t}KXYnhOvN=dufJcMukSi~;F8M{
zS@?S0-^dyeX({4sF%Tp{?(YQ;J14}~2^_Bu$XR<IXdPM~%a`6-UJxI`%1yb*!|1!b
zh|{X=xY567N9TziC!=#+5f<-!+n&g;57X@^>}$tf22(034WKEzI*QYFpV)H9G>PQv
z3$%fM%-|rSV9+*s>~HM4FpB4cd&xq4;#Wq8x;nbWK}i)&I^@np*)~5zWMd^zIov{*
zZ>!)PV%^>&Kd}P=WE5h2aW)4qR8+tcx|7e_$jz-75#?*pp=#iEW_({V1QG>M$li-e
z@a+6N;)v!qQe372kXd9$5r=9f8^s|vIuPI&bZ|Ffo*8XCorGb$xTJdnc%$f}TObyU
zB!Z#KcB|XnR`s8ljFqlW5het|F{+JVv;-NzEFvL_%u6|OLN$P=j>6^mm)^Yp^<qy#
z^=p;e{zX%zY+E~`%I`2+r>h9P^y00-3oc`c37182u!GQzyJSDq3vuJiFNxh)Xam=`
z^W?rG9KI0oYjkEtC%l5Jz&RUAW-fijs7nw>T8-yAJ5{nAR9qcy;n5OLID|Y4lMXqL
zVD)hnN}$Yy#-B$c4VrvB!dDsvCIi7M4$}<94+%gNKGn%YE!Bu2_dO*Oz}hb4s|N6I
zWYn$a0t?e1yzJss5%$|?iB%hOym-y|@YS@|G!WF4aOoq<uxV(}S4tjpzt?qTGCqps
zfjX?6g5EFl{U|<^Z6Ml|G;`mClJ4?{j$t*fdz+=}6AZxkxBL=BhY~muz&i+DY5)do
zc+*lHk;MVRL!VI85P1v<-sG&j^(+Oa=zGG@iI&hEU*76U#yreWU=OZLP(k5(|LSQ!
zLz&&Vg`V9Y9ccNrI<lADt#sR2Ex_Laz<=$9T<<E1Cr!Ilw49XCLQ<{O2QL~0l%w31
zzWVw)PGm~jly((t%q24N?rjM@52rFhKDT4IFPS)1_+IOmi``!|ktKbF)Mew8kcTKK
zM(Yc}8of|A506>Yy9P-7HrxQ>ZV{&Imj42ilcE~GwlK+nya4*a1c)UfUkY(YL#m{s
z7Nx8DR~DM0QYH}=?&iW^wfZ?t1A)Vd`n&?(HA6zQv)TeM%XL^}($LzAGUH+F;OrT(
zK=D$<%ztqHxaE-wjXn4pe{mg!kC~hXXyK8xm=Z-xXT1yNYLeB2TP)SNDb$)AN$7LT
zpyMl=EOj}}vSLI?K%|FF>6;#t=@NWS8Nt3s_}zD&vOZVH?hv(jQ+D;Yhv7)ksVlFq
z|M>u`<Y3Nm`tCsQ`5p-LpM_~ccdXoN`iDP35yR@8v>HcI@C7kv)&aBL9we)w;doZs
zsl4?mCzJa8vZ`VGNGNDRaOn9iWZesNV-}MKfOG4B%(ui#DAKXeWbv?*S;mAJf<E1J
z5I!yK;1W_R?P>A#MP}4S79!n3#9e>R(k6ER?&iSFqnO_tyG8<gH*;V+H%-r9PUP2w
zMSUWe;5{@|!zF?I@C|j1qqbOaucxU>z=I;@?x=_>sbFf&gil?(g4hQj(qf+2gZ7)y
zMH4Vx%JM1M2B$#WV!T)~R7FOY4orH&RDA3+S2F5+gZSbYr#0Oa!WR}c3^xcVbiugB
zlhh@Rc7Ms&ANu9mx6nrMxal4onEIzH0^YC-fUJ8PD08P?xd*3qSV%JMV-eeJ)(kUx
z6owK-)lV5sn5TmXA=UKB(vN`8qiC=uO?PkJH?*@uUW3n1c^I~aW%*Nqt3ja+dN4pF
z@@bfZAjkLhr&93Hy5pq2#`j*8<ekIZl9Al?1j0`*;NWcIF@z^|DfKW{r7VR18nRx#
zzcK7)R$*t6PjCnXTD9Iq#^UJJ%ux~jhNzczUMK)AD>(WUg(?~C%}ghPr4zo=(a1Kc
z@xq}YaJ4MHDpuq;n_&-qef@>5oM=Spo|fGRi^9^U;Zgk3ZEeXv+M&C!a&i)$ez@qE
zWWdpIhnc6jCT-j<l(7(DOu6$K(PAmX>hxwAg~WREzTzPhzzt#5$cN6a^1ezpmk81j
zsSq`$+${NM=bA)R_K45ry(uWl9>BQyXpaB3Pqt+L!TX?subthnX{>}*Ft<d04>0kS
zjTvzyL+dP#&F^+*Gl)c54L>&bSFLnz;1w}4v6u>;HIqhr7KN=q{BRWN2+Cer{HZWI
zK(jBB^4{i36$6Su;uRZp1BD~9FKG98aYgLW$dl~H-1pi>Mm{w8JYPVDjA~WCx|T0!
z79uJ60+=9+s*m;2ApyJZo65TAE10Inm{AzGsx2EOv~HJALG~P-2^QL);P7h)P#J!8
zZa!RaaV~082QeH64xn%@t+qxm*UScr=OWawr_cYGm1VXaFH<|xwm7BZk?Z{Yh;U?n
znVLz!DQ!y1$zX`rSAx7gL?B>j?baVYyWs;RoR62RzkWM<$yzZv>k!iKAd14`G+JNB
z96vv@`guokoJ6hOyHAQ1L#Y4oefTRpi<TriA7z#50;~QI4uNzOE(glwAY3a|jf9p3
zxbN+6c__ejHHXM>vN7C^9|R$Xh<91Qxd$9pL+_t-O2&&ElcQP6>4|?gN}JbT<!`aL
zn0wWRb(LqwLB3%jgP7b76Zr}eB*_U7v`f7U;Xy>UC~GIM^6n&bwoDoBuE>1|1J!V;
zw}XJA!t-q<-jgyhUDzNE6rliSH`kdMuTu*6+s6DSsKki+%eaU}sP?rbG?M+}FBNsn
z|F{op0q7M2yITw=ds6BdQ~SCg*k^7Z4J3@d<8QU2=k}In;nH0Y2tp9`4fkr)8(|k&
zG^C@EXU@LijB2IlEPcbUH;R8&+gk94C>#)s?i-_aqr7GD;2?cU>O6-$R^(s@iYz4;
zFSnW)8@~e{P1zzJ{w%)wG(LJ3Tnb(xwt-OR(T`!Bi`e)_b*_EIu8%5#brPLk0&)f7
z($!ofq~005kxemFbVgf61!wBEx|H3jtZp|_Xwqovm-;$gt{gxmkjcWZVxyJ!iCqHv
zl))f+G5QT4>0+-Vh_(iX>nj2?u%=8}@@P4=4uM7mQF-6?d<JO82`>DH6qBw{q|}=#
z>_ND-bK?H8f8Zdv^Eudh<he<JDbrXW?&D+V@&Gv}B0wvFG8@d%M4A^k@%N)^3QfJ~
znAk*GA99k$FpO+&Y92|zKmhRzv^o|F_<i3_yYHL42ovjQ*-$b21u!cjb50S|L)xZQ
zwPI-OYnLT$Okzw@*zqsgxgY=BMt<xls^f;v*c6S-6E?GHu*zWHRe{q`4gcEyE2m<0
zsipI!Wm1y8-yhl{u7f^6Kz~ACk_l*>K(umo1LznyOAAgSRGhNw2b|UIfUbW%p^=?v
zKKE)H_I;a%oSKW7Upx1lT8r5bgFn;=?AuaaY(5?C2Y<A7oqP>G#Sb(FNZMYq2b|<G
z?^@v>iSydx>onBq(|%CqhJh6$E)%byu#w|hcmmft0~q*rhcY5WOO_fmxahw;kg@RQ
zHf8I%#OuIrY9@rX%0!3FI}iY_OiMC-7pl<(z<?NT{<RU^2+H`}AwhzrE21OyMJe$j
z@P%3WJdj`)TLu0+Gh{zDcHT(8u`X&qVRZ?VyR%4tBS4~L-OH1j0PB$-eviD%>gF)*
z0C2<_jno;@#U~hi26IxC)3u@(3*Kc}XX940n1nCK1}4NfpHHa22uJ1!F5M%!lL8ES
zeN^CZtP2MU3(pHAfoVQ2?u`oO+BE1Wq!Jm8H2Q}I)}wgx>)Y~<Bld#9yx@{@Yg<)~
zgK`yeNsv-l+()?@Xrm|r?bRDIrsHRy{Y9AH95@SMU)(Ekwo7p}(3>b~EEQPpQAkw0
z9pNh5CfwxPMrj_w`FRoSu}!Fwvb%sm2N-zXBBE9_x8(-l?R!ASWcCLL4Mk;pdk%u#
zqCwCpWf<;_Fc!WT(cK>a*x<ebkOPLxR>)%(c=XkE5y4*AXmj1P+93X&7}s(a5ORFO
z*_*!=6>$NF48`(>T-y)_fwohMo<F%f(?!esvMhaJfx?{=x8DHYd1m?8GIP_^{1!<O
zrRxsMMHiM1#2w(;Oq`h2R0#3_+|6tqmjiG)eUcpH2(M^5)j_}~%kVZ4&c&~w!26j-
z=gA-qI}mnO?kEq!*AS2GPI61YeFPa@x|vlp(w>2H)M4tFnTRknh(zgeS~i-p>b(er
zO`PVU<r{|W_G^V^^Y~P$3y7$4yg<aK0AdJq&<h>5Fww$?J||`B2AV8UcUN_`#37b*
z*(xWubm-OMNM<DuH<Dz>zs>tddBO8;YXnIYKj-1mPm1J2OX(=DsbgDM40y?T-Nwnh
za>Ck3{t@``cyU{V?kEUpv$faq2an=AsgMyoEhBQ~G|?%v)cfUv+B&(VdO-TDyPBYZ
zOxY`Qa~Ct=hNPtE&Y$r}MxYC7BCbIE!Mi5y+FwI+>E_(@@k#8lv2AVm&_-4Dz_LDv
zw}raq&J~~D{t<4osDcl^B}HLJ8?3(jjCsa#w>WQ+Y-!xR(*5lW7R51z!}oyUStdAG
zbki9`H2iG&5nY)eTXH3N-UaYemq$<I{L-CIL~-+s^xVGkA;ijZl#T?~Z6d3Suypab
zyV~-oem)-{pV?@x#u@=Ra0`NHey$@aj;aHSiqx>h>!(67lOGFi6L^R9D0(1jzIF5<
z8XqiPAY0nX9eoctaBYnJe37xZEE>BSoo)SP4|>8V?AFlRf_%4OF76zx^YfnfY4!t9
zj^3!nyhhFb$1>*&6vTEK*4*zwRPi{Bd_v@ZEIY(&mu*ThZx_3|_Fc}RUX>SidAO9<
z5issJEf<+KQtFm7U{+O^f-^0t=M}(1WvgQVFdgTfJ#{jmi2*<Bc7&~LJZCG4xA^)>
zJddd_>_$`zVwn%T6t>)eRrxBL00@PDKE>k&&@W#B+zgl8fQd?13R&Z3+9=b(%LERl
zLAZi}=@=mQD7du;Ki(PigJ1G;5sPB4C|SUS1QRgtO^)O%_7K@^cTP^Ve(Z;QL5PN6
z#jVLv5ddg`VE9<F<3-dwEl{tvMVxCz$=<5uIFNCpK)7qMxhC@6q9XNS0ZxZ$|FIu)
zHMO<6fDYPH9#cl=EdvRY65g3swAq=mNZ)33p~uvd@@gg-HUC9Kq9XS4=3<TJH1boC
zi+A89-}Sa$bVh+6p9!Q}v(B;)15OwWsX%lyXTi({GWhR+GTn^duz)1}>dpAKY4A+)
zjmlQ_ho1ZLkEcw-=^A@5d#bRgay_*rffUP60^OF%`NIGq>SF?t18xP+v@Qxb5E@zj
zOT$+hL8)5@KM0^xFsd=4gJ~KD%1C6;KW&;)C_=HiwEQdh6pBkg{Z_db5awi`?#+RN
zA-voZU=cS`O4HmeKtWE3TlPQR$GejkrB66{Q4GgAT#f90e{BZzL@(!6pSK^{Kwh<?
zqVf<W6|dp$NJv^k%zvRQMQU2Z7>OI991y~`O}InCL?#d_%9K>-Gzq`I3D9qT*Fn}3
z-9XUZj{R13ydZv&aml~JI&E<^;62QWdC6izc>f6OeWc7fazP`A>+I)1i{j%Z1Xubo
zGuJErNP27H3L6f2FX83Kk=l8K&?h-Sq49$|D4g@B6UfgVMo*(d8tQ%<Oxi$1e&7CU
zLR)!JP46H+es=gqt4i5gYZM(T+P}lOlzhbBPv3JuCTfKfiN~`;d3JnPyA0mQ62YJ+
zMQ?TcGw6u$fU*{;uQoTovCf;984b@PDFATv59@!?9Ju7v3`_tbKdA)BK_7P8VC5z2
zjVc85?I`@mEo70G74Z`r&cFc1@g*OH3b2I^ZDrwH1_M9sK<8BjTj#rN1T%8sY}65z
z7{`;M0$d_+9U**gc;}bsoW!G$%kfh|w*HD1lCTb|@0AY)kbpiakOszo;DU*(tObNp
zhcAeN-p^WJ+_+u2rSX<7B23uHPjPT^HVWxJ?C&?Xgo(;=q{6fhRMOg{kE7=-8^rPY
z)?khqq~r7?VRTyPq7m3dJVHb6GPFs^Q^MC8G(>d>)NW~m0^a{&@T1E2AW0Zd>5(NO
z%1TN+LgI_jqD8C*9iXxg*+b0>=R%{=GN8xnKz8pqJOA`}r1_Z#3U9Jz?K0WRWqUah
ze+SRtP##y~8b~#eH8Z$<l$pB0oy9!HUf~6!%kAz+!!uEq51I%6M0Y)q@(<x?@Dq#|
zO(57<or}{5bI6N$MngIUsv*9j#(K&tof&~8OPwy+`0<-a7YT2n)s3Wx=?n(?8?Dp$
zc^CC4hwhz`!lmG~ZxQ-^KFpaNlZ-&$r;2E!81I%p(v}WL1(sE<b7PO|e0_=?61r5H
zA%FTdxWdUxkfqZ)A;1m@v1mG`b!_<)kc(UK<84+&AyB2jV#z@tgs0j1lsn^`5c|@Q
z1#Kbx5vxdw*zCa;UOjRmg1U8jBe$$xH4ieJCPf0mv}&SD@<%b${)|ood^VvxjQd$)
zQLIHjRytjJ_yU7qj^H#FA~{D;KG0%%pIWSie!rrGMECN^SZa}btyA;6Kh{v7WW5|i
zz!6T8{H9l|^%M}p35tP-H>Oa2A-u8%_uXGKwf0DbED<nOF3VFb6TFdWkrvE|8;QKc
zg-)@3v~?DFx*NctR`xJEJycYh{5i3Sa5CKRVNv4u)Y-XOPCflXIyFs3q=C{ef!nTb
zdfTd+J%&Wzuo`H{8Exekrg5Su0x`!Vj5H@q4g@!q_-v0PmGkxxPT*zKRd28YU+j|6
zoPbqles!fdb^S9W)8fJt;&oH~&>Cq6_IBR;oXe(Dd~|4cGSHKCvpn66e<3xrtf;q5
zVFvq*yhxC)vCXd`bHJz&Tj~b*+novIlO>h&JqtwVq3{G<IAv_~my+SVNWuj2%5a+(
z>BU*x<5s2e*A=|TsRO_ht$MsV|6nz_Hd~+m4{H5-srm(Bg5nzT?qIO9%aTlVB;q&L
zOpuMMl6ApWsPue9rrX5i_3P97fQI!=ZbPG?ukmxl&BZz!YF8Vbn$WiKjymB*G*4)D
zP)bcPNcv_0C4NON3CJib^YG>juy(l_k}xdlrM;Rhbm95vABQzd(Gl~u`enLXb2E>{
zxLMwJ)jYV(`YD5IMhDZSLf7Fe;p$bO=>%%&_0`S&Mcp^7BA54kltmezp7r!73Y=BT
zF&m;zVzX&U6hM3@a6m>l-^ky~LjF7$*e-noDTXVKGx`-u{wP8Q{o>k}z^T9fRa^ft
z0&0-~?~ix2Mi2=gDT0#x;95@H|A2NI7<{3Dqv|#R3?J?$qL{OO51h7;ge8#<VgRy)
z_`8V!>@8ivjSob4)I)SVrDGBze>ojyygOLblR>M6EH3&v!COL$P)q9r%<&VyW<Z!1
zao7q4>K2{M9GM|_oKm^$ZUd{aMzGCRkTA5~Jh{r)5!L42&^hO1%I^S~>w#N2HKjb+
zH@5|eI^vE*7Ikyep0qHDOggoCtsg9_x~ohnT>=uEwd^vKm4@JshB?G+%tT`97e(<=
z;O|VgWmAeDMDPM*_}ZI+2E-4NK$jtZa;Oldz8WIX2O-x#U-eHeUmU~OH`%Gk7RIS_
zaJRm)Ox(FTZIvf;mrB|}Me}|cM_<YR$qfAA6zK#=a%a;8Dc&r&$UH(cBjD_W*%o3>
z=>Q*?kiQ3;T~B!pb7)stB0QWNDWz6f#9#OjSpH`Go<QkbTT$4oo%?9NBF~X6?ha%k
zAau|$P7Si}57gV@dVw$=taDr*(JdQ0LPpR1jjyQ!Vjwvy5w6)Al+2~1Bdv%<MaO(w
z7CaXGu@iNCCjG!1;kgwqHu3&X?(ZJFTRy=$bc^*D?PLB0MFJo<yZtx{TAwL~ir`Lj
z0)+DvWKBv)N=Or*oJth$?$8vv3qdAEYzbIl#H_Vtfp%D*1g%nt%Qm5Axxh*&R>0aH
z)bQ$dT8=Irwgz<-3MDDu%TPJrYFffsvT)ZYhLa`ozp2V%UyxNnW*o8~gAX56g)5`@
zes(%S_55R>-iL57$FU%8+CUYNoK5P|kBaluz*qEPs)n$n^%ocEu+n3&R2qvm!RmZh
z<po7Cdy>v@I?=2l3pumXg~bEG&#fOvLKXlM7={L+_rCz1M+lP`S4+hb*RD0A^z6T{
z{U}8d9Wwxqx+k#6?1Jv|LGyskyA&TMJ<OZ{a-1(j0_lvD(k7}%Mvq|Hw*%w`n*<1l
ze5h^YhaihUZCc4v1j>wSm;+uUoJ(B?;9GaEmih#U<nG*24bL@&@a8YzSRS%(IfITF
zeT$Sx4?et#q(u#N{zy}cLYeb1DCh%0D1vGNonL6^iNB+Tl!8Y$Ki;*fpya#pCtGn#
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
LDrWX)0bl<cbw|h*

diff --git a/0.10.0/architecture/docs/design/images/highest-level.jpg b/0.10.0/architecture/docs/design/images/highest-level.jpg
deleted file mode 100644
index d2bec9c41ebf59546699aa36799aab03c0246c66..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 72314
zcmeEu2UJtb)^HRnii!v*)k_fx?NR~;1S}LO0V$!EOP4@E2qbi@ND&kekdAZ`5~L)Q
zP!yy$DWM0H-a_y7kMF*Fas6w(udMfd-~0b>-C=QN=gi)-_nDcqXP-TL=CJSZ8{m?v
zl8O@G*f9X$81)ZuIC`v4<^Fy1huWG-D(Z^A7c>B<>BO%90NlyVRa^Pqbpu1A>!-i{
zPVuA6!V2;DNB$2Iwcd@MAGHGjT|)l==ij=0*4hSPMMYSm{`0s}nNx+mLWQr`{SM#!
z0bBkK-~Iuk+#b78aUTAFU3InZQ(<c=eADhH*zzaX>apt&{MS^R+i*wsAH05~9}=Ip
zaf0el^E1?cHUI*k4NwN$`|<qL-_+!s3IN<%2LNc^9^JEy1pta)0svPBj_&cK000+X
z004ycqkBhf^4P-F;&0WRpk9yL+5!M8SpWc?AppSe6#$?${#zOK@(*OYPAy`i%H>S`
zvjaE+Yyj5*DgY;d6+oB@i2;5Ehyo-J2Lbm1G{=9WA6FV`I&td6k96kLsgtM9o}r~Z
zd*<v}+VdCB)1JF<?(A7Qdb$f2FI}R)M0@@+!{tj1RQS@5N{;=Yq&abhN_gqq*>lvp
z|H*Xt2|#~_rsM<*%`q;(ar$F4^v4dr0N8(wHJW2T(jSj|>cq*@XK0QeJ4-FLxdfmx
zK7Q=Px$`GapQb$tI0ra(oaV&IQ>W=KGykF&b%x;zqo@}2T~TK@6PKjaU43_CWOPTD
zn1x#*o?8NR50UXjTu0aC>GRR6Jh!whZC%473eMiQd-j1Bm3l+LI_-0H%@UQ(wZ92)
zBmz|wDw~rhs6|5b)Z0H~IC<iSm_LL(Mt}UWD9tZg40lgl5fgXOw#Z-NdK&(r<NM(N
z;5^MS>ci2{1LOgR0Cg(vQc`6=)C@bs@lvUdn_~pGzB4Cyb+I<9>0PqZ$d~gUEm5Og
z6RMiU&Z9ER_A42DgT>1<f>#r_ing^QDT7;KdqzGvDjSr&JI$x~{DkCm(|3^v+*M4;
zKy6>5|0S`{K_elWQT%e`s=&W0{i{v?8d86~QU6;MN^%KKZ#L-iO@Wzo?{Ye8EYy61
z>*?FS%@W6ftF}dE>tZ8nUU;qE>SjjW&@l9=rfyf=JAvcMT$#JT%tHVcQqR}Nd{2<w
z_#)b(bvft$x*w+VHvzh-LgsgefIo}Ca-YiRf1B;|)qZlmL%wn2<kyhXdNs3QnjeK<
z7)TR1byH|0G*^6|x^aCbecVZloIm%0=>ql@=_a6+VK4bN(=#949p$pecaKjiKF3(B
zs{+Io{;K`2micSU{Pi~dr3wBS9T|6SQY6%1W&TEHbJ(EJs@&qkdKEPlHVuR~S&s<B
z(?g{cCifM$`QH2ReLjfIK48@o1Kv5s`eTAngZ!!P&w?vKH~sQRUg{?;2+r53Uq=6;
zq%z5QcF8{zCLchGdXZ$Ylze)}Hf;-Tz<8a8?g>>U-psA;4?9)RnO_-SB#f}Ulh>cE
zxN-dBpwwHyrGJsg0G`#0FSg{nK%6zOrfSV!w=|#ci)-yk=F+}B7VwEG)a5Q8*u#Bu
z^xAvcY7OU5RZh&hS>!PTczgrk49#0B38@guhZxn|UhXgzyKLtZ(CpVRF}r+vDOldq
zoRxS@g#Lv@8xEh5hdtfR8PDUq<4WA-Zmv%5JRc&}WEm<aOLeoVml=SwN-?iA3f{;$
zXUn#lNV~uDT=l(M^cTTjt@PK>`0IW6OKbdhsLE#u2#&GXSGpEg41CoM?dg961M>RM
zsBnL?N|@M(q0w5g4<lRT7`{=RT;2Y37=g35Yre}}Tx(Tc8u<7hn1#7xW)1<LAIaP2
zuEo-Fp)?Q9-Q9)Qr8j7?Q@x-6;Uppb1pS`lL3a86bnbq0wbZ9&z2rG}_f3tp#rzS~
z6&7PZ2&#A^Byj;X-)v&GzhG@X1%xJ@(CmOJklBcZWsgS_Utg`e7Bq%Diy3QN@e(+{
zuHBtx7m<ny2`;dEoacxt-{<s-cMQx941~>mj<Gmlc0Wh74<vuN%g&H2Q-Jo`3FzV3
z<JTPONZZhRoX5<x>!IV^gP5zgmP;Xo?M7O9okNt3_N}ec>kgq8mbD-fkDUi?0%BVb
z!(SAjiX$jK$-#vnQFUTAn0K+@R4lv?@hjWC;u}?V5~eGJfn9HYZ-|&E+cxZmD>y$5
zrL;#x18*DxL}Wg%UtXiQkl2cERL|zdu=!ueiokUV8S^T-vAOa&#0FJQ%9hK>znWM=
zoWJJf!^V1bKEA=(z}+d`R6=jtxz>t6KnLJ}4YM$TStccgkIEW7X&sCUsPiEO0#|YU
zQhjY7dUF>@(PKzDjSg6X-g7}ToQ_Z_GXxp}2`lO;N;o<|gUd&Nl&a=}`C4)ITsFDl
z0tU&FiETZ`tT;Z?h@MesVrqd+d5wxjK8C(U*C%v@0M?ogPZgO?U2HE<f=!lM$0oh`
zR!T@5+objK9#(;9n$?@cs|kuLYE{3}?3eQ9^)?A!uvWq|HZBsB25e@<w>AqTmm4<l
zIV+{e`<L6HE|?;%o?&<p92<Q~Mdv|edZQ*+F-m!mCGgF6)2<+TdgRcmT)2Jfn*!vB
zYmclI+;k;+=5hA3nn%7SUpogMje6zZGG-kt4<@Ff4*{f+>eRclcU;+MG;Qbo{q#-t
zs+H|4WVuXkVo4Dyw|k<3f@eD3n361Y6?L7ZSNWRDh<6erV<Ez_YB~B9^u&ku6yr2+
zXW7*NqmrC-S04AvTKIAmmSw)Db1lTo=^P@*dE)e~9?iVoSyM$!7u#vI*@D4zy#a?@
z21U2vxY+KMEpwhXPAv-Lc=#9G=(glkP&e75No=_OcISH7D7BA&$?vVK^~qX{Hx$Zf
z)ulu#3uwu>BJe>q)tEYTLMz!I(=7h<N#e#GTLT-8b0O{Nj3~h@!IZ@A=q862jsB&_
zOUq5U-@m)T3IwXM1GBTsXX9D0Uai19-4Z4Kv?wW)N>(?0R!W&#i^ST7TV!ImiZ)i)
zCkztB(zC@DQYAKDD@M7#Qda@1kj&T+fzenO=oyIg?Yp0>T((Dhn+oyF7$47UcNXs(
zA9*=L*cB0-b$Na5*r*W4r(I@O8KHwkOs_Yi+?`nVCeXrA?3!3Qzeu@RcVuCFBGQb*
zzXyif^g@T#CEDW+7GnemjCKt|YkjTm)@@PE%*gwL+*ZAb9mU%q=UL?Ljak#2nDVDB
z;=YD0LZ0zUveKP#^92)-djmU7K@MZZ9e3)1X$FxGdb!6<i@z%@0THV*0WRKr-?KW|
zFxt5H>^5{==gY*}QTZwcwQla`ZfnUrbA#b28sst&S|_aTlH;f)&a{C|W3d11yP9`n
z$d)N(VUOBKQM9UnP@6-7c*9IWd|l&AUwkzVQX18iv$J7ZuqZtf*=w^oucj)2OA|9O
zYz<g8m@AjKRR1ui>QRtcFS4J(Mp46BQBiT5(IC_G#pO7Q><x%+&5Y|V8|cb%%l7r`
zj2xIG%qWmt!=p(R8t9K_WS#(0m*G<W!y55oPsAS7B3U0h9D2<_Wk#e{@7lT-dAcL&
zl|Zx3lm7vYeYRx<){wgv-l5;ERf(Rvt2&e73Zhu!1+6xqijXans$Y~Kc2ymOsw}Ko
zEIpQeU8zWYHhgXKoCsvaU*^q9eTku$bL94rf3)uN-Zd{j?!Gl?^Gx1~>gFz=<hHTB
z`~@bn`0)c2=S0+XFIo9Zf0h2<t?|pCGxnoxH0;zk%4^4K)~KI1tiZM+dwN%&HtU@6
zfy*%a!M#t3RX*}{{+6ZwuWr7P8g*-xRpV~iN)*@BYrPKm_6-1FQ6Ei8&7*DL=f56d
zKZz&Rv$^0+HY+S#xs8I_&}bspFGPT6GW|R%qe+I@rQAZW({kJQoXoPa-VRC!s!cXp
z*Q<nda3nnF!K0>>(x42;Vn@NsRdn2|^gbtucbCAf81{CnP_G&pTXZo@b!*1kQVyn|
zJ7De4pl|CGSZ?eT7+jfgs`v(n^K-5ycc}t#&4L|vv1Z3DQqnVuCVA7_A*UoOA~`vz
ze2!JV5s&j5avD=wtj-dO;cRjpGUmp^0+L}ktsHmf+yEAoiVj`yX=2bX(R}&yPk(_q
zQlj*O8VhbTc?Z(<so(zas(+PTI;+#yAfBed=}PpF%2vh3pyqw9p_}sW#;hAv$CXQO
z#br}Uw~%JOU)xe*MBBwHjGGfPw}s-!$j_!ug&EaDTbWqB0$qh~{mAe(=z#3jmItGj
z)cx-3)-`RLA%18B?@OY)wx=D59oFv%A#PB&?vJ^ss}>p@(~jz{E|T!#$-yA-##G<L
z`qoQcKbOpHj$;{dX;3;0UrOA%U!$QR4<*!E)9Y=+1k}=TN`>1X6o$_!TjuDaae2kn
zVazy5$~MBABMN&uJ|h}N<HGD`Mp%KC59n`=A;Re?BW`3VNSkztle6>uBYg1?WCON)
z!*isR68^P9fK#<;h7D(}p@1lM2-mS*5<a+q==~OJ0@~W2h@}e)*k-S+e2V`n=9ZC{
zWdO7og=|@edJc?lKU}Rm>)TAcHoIu#8E&7X=~v5J+HE4bO8`3?bz3ulO+KoB(KR4p
zT9QD}$w3?0Ur%Imcn6H+#?9Du14Ag4#LIOe(O{ul69F^lUAoKMVR`P|Tp)9%h0XHY
z#*Pz{W=y4a!u@{!(bGOg3~FhfaA6BA$E^C<bab&GvJ9Ee$~x<faks3mCLugfrrVLe
z#pXIsBQJ1fzK6~+_r{N*;dmUO%Yxu-&CJ(TaXmYN(`$pEsKG1~%c#Zdw*3Gzd@|Og
zXtjWeq!KdJgI@QKM)x!1nDy!_^n6*kiBg~hmS0f#KH?6EOjy6k`ug_bqv+N6*}5>>
zx8M4O3IfQs<vMz(wqBkKX)#3v$@Jjt>^6|%H>kN!Nb9JW0ML0r2-lx!Z~DSof8IeZ
zqgaLAChRGxKntp^FdfZrWml=-3N{HFbV8;&w-=`X8efGWhE8jVVflIz4%9i8)y%V*
zS;eu)6Pa$sr#d^jmA*tguu{~kXob2KCu*^v%ZH}&pD>L_UX<C8c|;J<3L16*v8qtC
zO~)IZw3UTsYgxLbPlhu|akaGZTCQUBKabv&0lEO24(bI%7^_8N(Y9va;X(wGLLTaz
zg9ReuRw`seK^Zuo&=8#Uh(>nBs<3$g!*N$1i;9D*7sBApw5lx5h<EQpfK1V-B|c}k
zG6D^@rX)NV=7q%X5Ok7ivpn%qR+UAT@4O7djbJ!1BcnUIeW(knI;-E^Re=pt7^TeC
ziF%N5uBoZZj^3}CT`lT&uM0|HYU@?WHide<VuOi;u-TsI#FY$?3@hK2g2$;#qEe6{
zB9~Lb)U{H3e8{nGlNHE=PRgAId*{u#kcsH2kVZougqZu7yTt3PsK7>+bzMa-rv*RX
zaN_RO%O=8XHTli-F_*d?rDj)mU5T491U0E?_q0QK*nEVX9evsmL`!_AK9^%4=9}Ws
z%r}O&fRlgBwRG--*YO7AbHX|e^}5{AlJzGdFyTb!mO9*^3*W0cM|J6ougi^hSzj&0
zi97-&EiC7)#kJvbs58_e%OOA|cXl?pS>_RVClu}?g7WCyf!OKm9vEz*LjBWw+}$-N
z5{oWA92hnG2Xq`C@Lwv(W9BoUL{pt@EAlYtAkvUTl8;7ymA&r}<V~!r>U5AU%UY=?
zmOJd<D8!)s1t}?B0lk-xIK26jt>NIEbvhjHPm*!`$+wX3be7db?TCZypKR^mG~JRV
zF-IJZ*tQLv&i)TRSfQPLxpAHw#?Ud*CWvD?N>55utJO4$ku9)%WLCPPPIP3-khzC7
zCjC}VqH#ov)ODH%fAqn={gDOpBIzg7#<d)O>!(l7f{#C&HpkNe79XiqoG3bSqejM$
zX}_A?*H8bX$7;I*I1ctp-eY>c5!bHrHkHrq5b&*tv#7^Q{Utr=_Z7y!OAy!Yp9c5W
zG^!BedUphK`^w||j5^j89|1O!mi`d-r~J6y{?Z}f+J5lF0b44c^T@^J<UXAF_a^S9
ztvsTceC__={s!Q5+xDlQX#Q=G=ECza5vGH>@4K0?0qm#i%!KwsYc?Ug-xA8c0=~`C
zjOjy9(g~9A+Q<_7F}DJF8#5-n6to|_cjj@)uJrDe2`|yI{L8>q?>WWKIfsC_&-vEH
zF9;f@(=06r-ul&Zyf>6X%<P2;Ws}GzuQC<w2jkAOy4zYPMNL{DP(+$l?B*FX#HPz=
zes({zs8ql_!b-w)x$Ntv;B?X2o+$B6sNtst`?N`iDBsQJvB;LLP>s)cXEya>P3IhB
zQSM@<>Wi#s&WUTq3?4QPrmbZNN-@|)9ew8n;7ll_2P@Q3c2fY)Cze`3$bs^YhI0z8
z!oTY&vYK*-gNt>Y8q1u@r+FHyhuC)2+;<;<GJw}I`|-R3so~{_&RkcWZl%_aThaVR
zy%?0P29KiCY)~n$?|j$1O<i8hd8f^smdug?^u!0uOE_qOqVr|lYVb=RBc?Derwo`S
zB^Co8JNusUDex1%P!)f#!`$~%q0zZoUMzZ+^pc~Wf3O-yUIu5cDJq!8yh^qi^nEuK
zj&w)zw{lzB=2iz!^fPY6ZDj32e^a<i*b---W*I{9e6;C-nS?NxcaY&xxs-S7Zjq7(
z>6+b>s|XRXte1?8SNiGi0BBxYRkam}<VuM=aOrOo4Lbx#H&lKcs`#Z|BUy0P>CS1T
zKZXP+mUjzXBbR4f!6NoCveP^`SA2Gz*pVi1K|ea{*iQ=}dY3(4Rr_$x#J%~B|4sMF
zdC4C&L>~?P%ZNYy^)-&ecL2&FU59{YU;VlaXT+{3EF8TO(glC;{*f~nF0R4zX6E!W
z6|^IdVCSs$_GTlwY%GAIYxrmUKVa37O3pF)e3Po0cM6o<?+4<$jLmys1y6IvO^5oe
zDx!boC&2c|tv}HJ{oLZKkIm>v-;lgp*RM4xTg|mq`6Yfc>E#SDMgTT;qXgo&jJfIA
zWOB(59|<R(^?1QFeDhrShQtv5)aGL>#>n9{lfhJI@Rp^c3-%tUGrtw#Q8DY3@F1rx
zYbVC%L-dq&iScg;Rv}ZtkD_MiP-Sp%H*|2EtRd6)^h3X$)j?GEx9zC9E@N}hsP}Vg
zf|}slbm!n3slY~7_S$l%kzq<(!W2Y0z00*NCvG+KSj;S^g}FuK;x+c5rSWYg6%kKt
z@fBU8Q>_~0WI?|x{ru^X_*Fzhw`r8g!|}MPe#5>l-|7OmYjdulo<KB7GGam*;vANw
zrZyCch^sG<6iDbnqg@2T$=K=a__R0oHdLn-s|r}vvp%Dp9N@XnGGbWa=BHUL(N<<X
z%f;2XdJP-6p_$6PUB`0e12x%jmb{4X%SdIIu()}M1%spqe{M$uo|&)sd6JErqr#{X
z7kChz>cVXlyuhua7e8ERlbB}svSr7q9gfTny^0Gtr;q3O;tkbibzQ}KM#*ch@(aD#
z(6*7b=`(2AAlv18rxR_&`-SGyigY@(KTW(L2)1QqIXb$g8H{VdNo}^fsX+GO`o6`u
zK^b0maYMc`Lw1{%<zAzk*R5Bux(Gox>}V8*^SHPdY8Ag=hFtYPJ}*MjjWd#i+rJJ~
z@f6*C+cA<+W$ZA`F4&zLW%#M5v94h_ds12n*E&hYX$Z4NCCVKF@<S-Q=(UxO{`wHR
z9+<B}lOQ-+2$hNQoyrV|h*pz82L}xhtev8a(4;Acf$ZKJ)Y-`5V^|Yep;ltV7#m0Q
z&dP0*82GUCRTstfP|`hCFDX&`=0GSy+s%Q5oN~lY_2IfGSLO@LX63}A90CfzW+XG%
zwxra}qPdI<J5Yy!L@u!#V4SWcF^K(3sNPc6<(w&8gS!5yUR(?26gVUHw!V=Mj`l%8
zma(<|y)Ri_xlL1e50mj{Ou{4F?}vSRV|j|NltvZ~nuhAbl^WdiSsK^1=VQ)4+f*;+
z=Xlp~C;T%IlVW!Q4)c%D1Fkv~qvY<l_UVDGddv^5O9xU^37<W(YA8YMsbq6jn*fQ>
zucCPrCq;+2M1pcE(C=Nj8N=YawIywxS{1c(Tmejyx5g|Tdq51<3Yy{c7bWI2tuB1f
zo9#B*?^{hUUQVbsa?2>~GO>cD<19g}U(m1prSZ8iyg_z3ovVOJJWirNj(`j?R<;rj
z87muP!dg<@uj7xkMGgU}*vMLl(qsiEYo@z6OE7xPH5Io9oaCa^mgNP0#6BpPNy>L<
zUH#?jS<sE)p=h*faM*Y2rT)IArq&Vekt;#0)+5#B{ChFY#Zp;CR{76$`*Y#F2MsL?
z<hSE%5(}AlZDXT~cGX@`iz3uuOhJjDLVvY~LL|*jxG45*_AN)*+or+}v|@S;Fchy>
z$b|u*mmyCS<*6OUJ66Uz6sxG$Eh-5s1t+!>24`WB;8HcAIyUiqnoFfN*KTAXl@0Uf
zH24C>CB5cs%04@z!*s(;$6Occ9K+LObV?I?fVo6`Ho17{5U{k@Ss~F*<ZyCoeSF?;
zQ?Q@TMkW(itSH#X`6#QOl{>zU90k>}fkdGo?+QCBYkePd$ZEADJ{@P`m#7!cOp;rN
zk~9X&z^1Ixe4;t$-dA833^w%_@^N#-xWIce&Q{EJr@}1}-`-1N?J21p`cPgITxg-D
z3{QBdRYJXra%)Q+r7hm$A*o=Bxmx9owbC<~5<Jz&s-M}ht4T$8`8O0AWjGd#OOi%5
zLuGGwVRRB3`ckYzR=jJW{Zc?8JCPf2EYZHK3QKC(Q@fc(bR6uF^(rE?>ZopV@tx$!
z|6HTP<y3yN*KxwBDX8{K;w#NvhCDCh54|l6XSxS4NEiQXwU@S<Y-}sKT)TZyIDHxX
z<7Fw|tzz%wm8FETkv<!&XQoS_8D1|-oub=^)dfNIZ(9aGSU|l}nglbUkOWYh*~KoZ
zSqSyewSzQ<>RfybxNzaaPuAi5)YW?bL~C;cC$qO>S(?%AR7)}Kk2&LC@A%5y+>z{E
zTgP;9@v9ucQe8V!6If1Ny(bs#7yl6U=bZP*I^;tBWHsK-3*N<#?U|FSMt%eMEGGO+
z^KZkyPRofcJI_0Dmf62QnlL-f&NgGIEt*0lK89^{?l!=I-5VDKW7nd+_~)h^g_Ivm
zkA|9!!+@y*1lW9VPW#G-0&aZ#sK4|M9<gS4f-T~CA?jjYQB8Pe$lMi4{#4Z$#45(o
zv<E)2#e@QVu0ki@E<bC@`IcRlwKUZQ_J}QEZik3QgN6~=8cuw5Q`5V+jBo+{H+VEq
zb$rY!3LQ+MIwe9kEo0=Z{1W$%K@I^$D;%~1M#6P|jf3m~lJ#!}@z-7#7s#);fSs-c
z3A&^rxap0^;b4MJZp4r%JW|AC47?%!{<k8pkT5+gJi78#<)wx%o6RgBs8LRpc!!n|
z)|@6>%jX2bo5zh5C*s^|{JNLryw`N#z=Io^%6brB!*u^S%g{FE2UDU*1>_(CoyvuF
z@w&#@mz9n36~TGcW=c~Bq?w3J@3w$!e@C8U3e?QDKv7qZFVrZgY@?oqBKs+KAg0eb
z-J>P$sbY}z+U6<pvQb<R_pn-qEaYB3HfT0Ps=~Y20i`=>8Uv4pC+xCfa0W!drJbSR
zt}vS&|Lm*WdFyoPcs&~?P+A5icH{$twKDPL!Z!V&hfZ?B!s&4LbFw{xOkH;pqs#6F
z*^~&eH^r%}2qIG<lvS6<HQGC#NUuDGa4F~G-jqmpU5ARt^#w|jN?^8LE+9~NI%iBA
zZS^un<SU^0&X2DD-}gdY?Uf$h7=$eda5^p+@Wem&Eh#a=5U4SjPtL#f1UC2A$Bi?w
zyhgY8b@}BLbX3ge<fWC$JxbN%0`F<SB^#@Ixo~qWA#JFA4pO<5(Z>>mx*=Z}V^lX@
zV*N~z5a_-ZdYW8-77>rj&iSs)wd!$xX4alm6CFkf%czSZ9Ajkmjbe7P0n=TmQgi8H
z8+nkul#`kBMX;@`UWeU|0W%c-Y5ZkAk9R)QPC;=LHN6Gi#um5^V-XtS3v-{sJIgx{
z0m&BK+czN3hD2$%Goqyi=AxPf;SL045r(ToFt}^@5HP9F9X@<gu^%}pSQ=|+oAVxU
z{0X%;sZm4!3iXlMvb^Zt=ex<U&^EqEBB04+_B;X-M`lPH`%b<^7#)Fk`Ig^wy2D{t
zN4&awUG%ll^Ap7z=K7suJv-KE&*EOurDY}E(vnmvNFz{fx8c)Hn3V<XaoOOjSWT-?
ze=EW--bt-0W?Ou56rIyZP0)RyWs*vU^A#UwuiBaxtb!sW(l(Wa&Uikt2Yx-1IL>@f
zca8nEF{UT%Ton<hpc*ah)O)@nBfm@u**Z`T491T3`_RI1>~E!Og1&>z+;dFBE?Y_5
znkXiwj0mOYF7$glTpREYx6Jiv({}*^y~%_rY5y4cJ*z#_(}ruWSbHe9O6`Xsi(I*u
za?#k_(TK2&<nbv>rv!>Qty2O-AEa-`fASE(v&*aT+;T_UrA3&o#G)(1H<_onb|^{$
zkBv|+uoVv-<U*1Zoi8sErm?Odox-sgw+7KU({29UdnVc6FccFL(>#JGdrf6y<shZ9
z!PRlfd<6|rD4EfFYtL(j^2^t`3-t=`eFQH;t|gW~%<pUn8}*J~EYV_!|6JKNC^kDP
z6d9L@owp&GtQVCWlpqy*Z2Ce$>QDy59MM?^*pRnz$rxOrqZHbz%#Csy+Pg_iBe;4A
z(NmM80@yZeE{k8k<<+UiCG@<Ecx^PZ$vg=v+KuOmk_t1(dSlyE3n}ejfOplDl1^bf
zFrxE-^VvU!pv!C2c8}tEz{Jc28Sqc)Wu|K)5z+vd{`3QhnrPP3s~8RJNOPz(CB4gD
zYRk|7U$bH_2^)*1mF{o<OsLt!j{lO;#Q_J|8}|YefBK?T*1PjJ&c9!dJIEe{;`e1?
zYYoBLM{wxcLFu-GGKn#TX2AOs6_q+W9?+RqStM^dNh()Yh6%i+Q#{dzu*wNqsxTsg
zS;loui?=<i^`CfOyGi78+L1>T+Mjrj2R$no(>YJlKdFljL*2hDYy9152-sQ-TV2qC
z;eLrh3L-^~meeHG2Asfp3K*X<ZGl*}M_bGuX~>~RBuBx`hCr%eE#~6rm8C4<eXZlX
zhKbA-Tq&tT&6pRFUee4Ku~Cl?)m03At-=02`NjbU!XZ1(JqVU0r1NSr`b%zcH&9m6
z?Ak9;Qr{z_JdD=Jo_ng<)Rk?Kvz<hLRAbin+?g@?iPwG{ce@j1Kg{cN(}`8h$Z4S>
z(tg1$$Y9wa=5Vz%`lYlatb!6+hJY5{YnZSswt=*gff#Qg_lZ`hqB_e5Eu9S*H|86A
zptQ|18#nNaVv{%A*di{;?q(9gF8C$u&N)`2y4B)j_@;ts6g?xos_ml->>M8^2BKpG
z+I_`k)aKWhaywABAD4!UnlgBsUzUGl+%^T4f=(_uCdwQFa->=IGjAZ?tS#3Rn#9%g
znFkp;ZZ?IOcyee#olEo!6dhtUzibLHHe_d$bQR6~ka#W6D2?@y4e$)|4eVvCDA^>g
zYXo+>Q+G_CrDS++)g;U+Cb4zIPo%?v*-i>cX?wZOY<1y%*UUvOd~WGbE+pI6L<g$T
zHWz>bn?#5yiDH%cE~ip80F=5=t7~c-v%zCu`QFBDJDu6&*&)EKxMpZ$Y8cor@F=a{
zC=r`$<=KJLg={K}#L|0ynd!H+d(rikB-ql<ImcH1sVoHX)l{xWu6|(d#X?!Z_<#d#
z#cV;drhXxhs}I!+C#57Sc~F#9<R*R`89O5<^-9;7{O%n*qSR!8*C>b4IzG|o<{R&D
zdF@{&AGjE|Tfeday^+u9j6V<wv-*0Mx6Zhg`-8hl_oDZhhTC^nOthqcmj19P)JGW~
z(wRs(1Zd?2bRpcmHM*7n7utV#M30?JF1!&bQfD00J$N0r;P9rZ<TFqHWB*^ODncoy
zd#s3L;fY=m;cpdCL&~YqpRLiV->uQ%Y}#!6>={lWp&A-YI2P(CaM$o63+3A=rETyK
zz%ABjnyo*m$UYi35mwJ`EfjTi*Jn?i3?3kA5~hi%l$8&*5c{f6MAYu$aQXI#=+I8&
zgrfsyR{j=BE`8gWWp?LH8~@!Cy@*-OsC-;r_TKj+j0^ze2#LKtM^3M<tTJsi_~HLs
z=uw?{+A|pbc*kNR*i27mH1MS!hLKATY!^jr{x<gA!I&@|pI5d0>&${tp-gJ98hcr+
zIh$;O3b#WnYxJW|({Ma1F#r^$B?;LwS`g~R$6Oak(lr4E!+>7zb0u7Q>gg0BbhyVH
zg`-&7I@{z1CJ<1M%}J-`*2+OJYJP$i9T0$oSfysWi!<S_&1A#``1uJlT4x82oR*Sr
zZp*lS+@W-xuc@zBzuWKeg0IR70YqBoOwfK3gq!M47O*lk*V?Z66T?Ln5O;(mldSE7
z4R!Zbp1P89_WuX;Re2kHq_I;;fVgI$8W|N}{kTzWnAZMVPEaF6YcI8N5X$mJaf<3C
z?{b%BwwfTC2=z1ZUmy&_8GA2um=0Wy7MkUDhB?jL4%H1^Sn><;f#F<8uaDM!K<3NU
zjpUvur`u+KpJG<??0WZE^2}9?_Jze_3YiaH$30&&KLk)LtT1IdVRK3sb)HOsVpxoQ
zO_p@!RL@>*4DWc*&k~qtHCTYr@%R3=?4eFk{UkV$^=w#T_j(RCtJrL2H!0OfDnAlb
z{(#b#=MWb{)Tt&(fm8w<C)T>&gtVAX8;K14`rT7F{_8BqN1Of_tI1;h??zAURE?eV
z)d{sZ={X3iLqL4)$F@+1n5RUZ&@rdhNysL2(3p6MpJK1Z&S{-QETGjmRjavBdzr^d
zvOj_U!jKHtjm8zk6_)V6+5o%$5IhSh(#Al;P>?Pwhd9P8JQiIbxs+xs{kW7zK?#5R
z3_7qIste<~!8=}>4^A_BnWJmeh3fEiEEofUb@iA=9=Xa~0oL^zcUr%CW=ma7U-Lp!
zT83>P<rh#XZ4T)>r(ezR`nDYc?z>fugV`r?!z%aR>SJwuI;5PgmTV|E&}%VUD=giZ
zCEg(4jLR)9Xc;R3h^72cX+K#U{~J66xALqfOU)z#8f^+KqDydKq_IJf<a--fX{fFq
zzFn7mE3uXb;sDiRG%s5S)irZQ<jqfXHqFT?dteE(yp@$7-uCokqc?Kj&5lFOec1#N
zEP=s6H)gw$Ll215O>s`G@$f;;Mu{538A_qP(Z{)F>rydc_fQ$P%XLH#diH^&Vcvdv
zXwb@s()L}c$E?1fh!~aMOh$J-FabOSMYiq*M`yC6zO<Y@bVx`k6}XDdYpkNv-^0zl
zs?F0K!T9A`T|L+(GNCX7s7y(;8X?8{twFyD$?Z~Gy&MY7B@oUP%C@ez5J==o1!le8
zw_qvFVtHeQX;{j|Ma<m46Fi%x)LZa?o?d_C%bE&n85f1<xnWw|x5|O;>C10x*|Xy7
ziF@!%Jx~y$dKT7K(4nKt<I06^(_5+v&<CUXZ|OZ4BHn2FZH6b>=XrsSUO_1EWp1@>
zTl<yH&ia8Fo@_TQzvo)?^rixQ2z}?{vO2M~>%#M(x!IB8&HBY{R9skdWxX^ErdkS;
z4z<D};xCIuWGp&07hw9rF=>#l>Tv~gS_A|8Ti+-oR;c8Aj}NS}U$2y52FHkh;}|KH
z)VWQ6*<*|0<sMuG*$>ru?#D>Jz@Fg|29p0R6Xlbg-=X$6IyDoD_7QT+&KH!;vqL)t
z4*Q1Rb{NySs5ST~y;H8P<=LvH`n#{)V$!p*mWmpa*7-6|=Za<Mv)8|yIbW1|Q9BD8
zn84(9mx&J`V-5jk_zEQCk*#!-@^Ik}%xsaM?2)0|+3gJCp+?4Khp(dNiQ;Re<)`3N
z1?QCW_moJ9W(Y4MHQ5y@HK*tYwkojqr2eJ`4;k1z(RtCcSd)bV)c`k;OhGz+gFg%I
zcdyH=jW<-Iz1Q2>%F2ayQ+=)bT`x7wB#1D)ela@h?#pkovA3{(>4P`3Kfccu%q&0-
zD8S3YJL<WO+D^a<Z69D-f)<&my~4#6zYaoGRkDkio3v71j~xPf({AG5(6+m+ay3iT
z2&R{o^*ZOo1WO87XGP`9w&>S#Yqd@}&3qxp*etCkIh1cGJ23KDf<kodSL%vyU>irA
zl8P(Vnrk&e6SWetRuuaKNWwIEyIhWeMsvJyoMjseR*JgUW5F>Yz!hg?uxrW_b>W%(
zR~Q$UK!)`KjPgwxjkxuq!GHSVYhSm>Lx7D|s1YT0uhe1Afh5$9AKNG-4)qTc?31D%
z4o-Hfm&Nshd>(9BP_!WuLB%o=x8kNAFYdz$Bk>5XWJ8I%!eiOpJGUz%(ypc-xR{?a
zTYKpdH_TiYYREzv9`VACjBru%$LXwnds_QFH4zo&^GrZkJiC<V!Zr5eq=!mhvXn|C
zq5YV_%f1Qa4Y+;p_g5$4p1sNMGIeIUU6!=&SVGeFZjv$Sc6+QVi9v0=@UPIrSigxa
zpYAF2ExvDtZ4FBn&vSo2Ccm|w7*k+%Zv_~<<DiuKP@O>ZG6jyi=_p^3X#Ttyt(<?Y
zOz<_V*pCMhj!rPCpE^4q|COT9U|H)TxI#<JP-cFV6%mn|XsfFTRgyLs=oN0j6bSDP
z(}ZLu%_vrVObWnJ^@y>!FhLsZkSEz}1rxZe-_jU2!zk$%zR_(71UCf6a|s|7H53CU
zdvir3x?sv9OYFM%b|^&c(bMQHvKzi`sxGK%1s-uWei53zDQ{!Bb(?D)q;6eBpQqSG
zWIqH{nonl~7IyCdE*CGp+G?NI7g?I1m+{;3e|=EvdI-3n#i3v8JFt8pvM{pv@yMpk
zxKT9n&6K#mxoGCI7^@1P{e52k_pevoIInpWZ%ADvOSJstKovPLL7m=DKLngUHJ{Rg
z2YyC%sp~)x*0pE^+nWjybk6Y^@fqlin^~_IP`J6h1#8};Fh|#3;GN%08?Wc&wQJvo
zB?O~wd-?^Ijf`R4wLI8RZSV(I;+v6FO0gJMp4^Z?(R^e5BiErqMbY?o>yJB!3OS~t
zRaIZz6*rnLB}GUjVs^R`CI`qVTfJ5bHX#m>>fq%hd&)^G{=A;}bsy3KURqJ9-jo)M
z^y0!bHPSbhrTUvPCc2H$w@ned4Tmddl-_q3p$l7bqI2>d61;%IlX0myJv7(C+k5qm
z1<nPyLFY0j)d}Ay7Ka8~m0aoutFOaW_`8A<**maM;`dLO^Wuut{a3?K7iGe83KqWv
zwIN#Xb;pXxhOhM`N|nqkh`Tzm)45K@GML_u(%ViSvzCBRUWc|qwn$LV{X@W0delUj
zi@RDIL%*lExaw{E0wF!ZbUHg$<)qba7&b5Z)_ZifGXq=TICNBL*@?JtBj`1$jQD+K
zUb(<ZeI(W60ApL4!G50cU3WJrqAdDRk6J`^J>>kaOUOnj8?K+*A<~*m4Ys=}>g&`+
zhSZ7l!a+^nOLPr$GK>OEPrTLDZu~T1=lIMPPf^svHDUXarp5i5JT|>HL{smpD>B0A
zee-(3=i%@rbKp$u<CK(g-YYlrHQM@m#Go2XSuCme){&j^-m4&j@hj_777@@nXt7kK
z)^CLm$-DJ$B%`0^gPW$cVF4N&g45VZr>2D~gKpnVV-zN&^x^YHZLYp5UvH~Pw&3{9
zJ<IMs+(EwxxJ9&z*AZYTr^jP8z3Q^W_?|SC*lG|QayNh!mCWFNwHKAklEQ>qLnACk
zuWW*Rv%NzpwRS*jaB;E3PbXr7!$Izi6?<q2G=zubBi-eio|WUc=H5GCz!#*4v*VJJ
zs$e5`XnA&h%Fb#REg4*7k7f?RXI3T=0*dbfVf<+O499Ryh6ND>M?D_OMxuV{D)wuk
z?!gZMz)}i3)2qUB`M3#>VuR^*v%a19ROO)s13O1HO$ELDRcVPZsntx1cU*RPQ($@B
z*opbb4tDjXjOxd)cOs@d!lat|SWk2ikfKnwX=`tm#&AjVuZYrc{ZH{phE2=Of}DF2
zqSKbe)!pH6e3+{!eX~R{Q`$ILJ~w+)%Kt)h{(yVfpfdppL4uW?QUjvis)Tob=`(ok
z@Qa!^{nfyPhVE^Kak7t<Q}TGL=9Fw?l$U9m*-YsJ!bERKfW9m)8t)i+|B6Hh2~=1+
z&{vmQc{L$B3^jvmO7J^5TdHYu;pO*tlCZs3U`M*DPLyxuRmwU-R|V3(hxri3r@|^b
zS32Bt5WMwn1#7+3iR3WFz^ok~>cB9QamvE2p+W9W3(#%)3z29Po9j&fF(%Cn=|cd#
z8eyORNGFT}ISGm0hEv)Qm#+;|O2VhhRoi&`6B-hPwaKF5X0g?)KAKvh11801tF*}!
zP+&zSI<W~0RqQv)CJLB@v|wGivYG;xzE!*e7Z$3Y=5p)H6t~YVngDI=#Fg8E;024~
z9*pZB7u&KAc&5l&TG=^-J)uQqSsiA&=J$Xz|J#<z<lH5?NkuE2dOG#D8APq3`3=IX
z2677U4dqS2$y||0I>D~n+LLoVqFE&qncv2B7tjJGzcvL{UQq^RXNRn$A{YUdyb+sN
zGsR%5YrYq~R?3lsp6R2b4+LfmW$1?`lv7hh<}_TaYejuvodh;-HiEGbZgey)Ej{e2
z>6dsJB#55bZD}Fl5WrtVbLmT)k+eGVnUwmeFVm0b*g;`gL3V`uPA}g@EW>MSX{DYH
z&c`n#?EbP^GBbG+RX>w2lgVg>F6clDfy#`1G%}y+_(tE_@-QUKeN$M<d!0f<FWF8<
zcY)@a(Sn4&w=JVZdLE&Rmz`agY1%3-E|Fe~D|CAJhPWO0mX?<6$|@q(kct1b&6@07
z)AAsEGBPCSdR~V0ys}3JM{r;j7TlV0H6-XYNb<GvmHPSidO-scnhXo)=>6K+QGey4
z@{P99(Ckptu2__Y|GUqT5Q$NT69(x6{-KqPCz^E_@jcm0(cscUz&l5i+h-Pi7JY)M
zD$TDwIK>4|Vljz1Q-hGch22K-KdR8tL6=>{Os6I03lBPd@e-k>w3az?SO40OUvJSd
zs%P70GR$n$`Am4+)y2i}<I<9dG}qSc+mqAh6$imJ7vh?2Q;P~dE8C|&>%St~(sVP$
z>NiIj_&}$G#ucZbAsKl7hx)ZNby1lZKbO$kbrjGpkQc&;yJ`aydC4+~XUwkT>8DK*
zr7QgOV`7gwieV2L+^pHN+YpG^at&Om6j<nev+R#N1o%F4fE=70tQzrKpWp{kzkZHW
zMi#5QR;PTL9s(Zz`$oa<7)OCdnHI0^F2{uUTRq<IQt{vuE&|+=egXjXsv|fmp%3+j
zb0z0qDx&>nQ{vE35tR{e0wo;WfMMM@C`9T|-0?<>gn@Y3g+aB)DY>CvyE{qu`Yqx>
zlX?|l)X<D7Akfj~2{&#Bl&-%c04Ho_Y-PCfCdqX<XC<|3Y|U_w_??N%?SDP8lT+ZA
z26z6vgi&9Qk}SX1s0^x$la_Aerz|VY#(DIAX44ih3f=%!u47F*7-AW$kmuqo1RxpG
z=E|?TE!@fwuWR0rTJYinvGz~-d83dAT3?rz1S;k{Nm83RqxS`vyXG0r5HxLTJ`M^+
zJj;Q?_@{4LJ_AST*y!T}1J?)Rll`n3%f>JR@l1Im>&z#s$k$#x%7A7D9|9aRqxRd8
z?&@I+U-Y=c^W4<ESr@}S7|{#PXJ>}S^hE_P)Q4H4n4vviZKRA?6)TOHBo*B7-W##Z
zL9GL_)Wu6OQn&vKDJs^A;Xu>t<SJ*@AprTPN-#b1^RL0cK=ky|AREJH2Q@bBTBnzJ
zVFMv$T6isD`kC^X%iitXFxOU{`p5HA^j&jNymbzluoy-HRzk?fe&``jXL>MBQBkjy
zp2)RO$zIME;Zza6^Co&avy!C3WM@-iut<`fDlLn;Y3z_;1L09mF|<T60OQ^ul7`*;
z+st^E&Vpb<;q#3jO>R&>SI=eF<hqV6rLnSSY;2h-eX$B}QFv<nDM47l)iI$dFxyt&
zs^?r{8`-<mfU=Haz1KA7YqHi70Rx4XiwTOj3Z&^v#SQ`Ev&0f~Xy;2mi=ceWSxT&~
z)uPX*6?GcAp2J6VZwwYKz#gZIl@2-75g%jT$1jAm1P7xEB@LUJMd)b18Hn`>h-$h-
z%dMF3_>hp@#rNLfFUt;TdXIkphKL&8hU&PR`Jcs=&YXHToa=UrGy-u6ZiZmXB_wo=
zQhX$GDt8q~PA!nlkyr3d^J`|OVBcTb74$F9IWifa%na*y&Tu|)<=tb+tCmi?^F5;U
zSP04IjO~*<)MM}JWcKE`c4}PLUa=>PU0qzw4Vj~B?qqYDS!v502e|$A_t)y!&QEcQ
zXJvm1V4U!TJ^m?9(Z=GZ0LGIK05v~qIBS1&Y6G8CUB*SyPM*q>T*=mPzzNrV`7NQ-
z6i`y+FA5qzZ6oEzT&Gh0k&c0q4gpF72T6D@YeoK_ekkquo9yA!W`n;TqsV^y1O2D`
z1okLYQR66rQ8{Ya99ixkvRk}6&tT-dBuqZo-OS@x!Afm0J5hDbZf~;8r1q1)ugm^a
z-#-9P9YyhqpFi>`s(l8#ryTp-{ey~k{k}}`OhDqe^iza_8<T(!$({vACMXqe-|C>Q
zh2nE|hF;#GsoRn5%g>JGcwK3{QDUB(lk;o4cZ1MFqa2P#Yn<)km|LhJ{Txd^ds}eW
z2t1H)d~?=}>OK+R%R*y`k4~ixT2-dg3yiBlBsv8_H@l}OKD4<o>VC)&|I^@uXV0^8
zeESDh=vIw>g;>uQel0DU{4P7(YrA=`e*vBr2ei|aCHi&tHuNmZVuRSmHIF|aZ*MA0
z_B%l>2{XzzN--t^?3$6yu_mrJDJwPHCcAD??;zF`*W#C2P~+ChT`)5|2C;uK?B;h%
z<@0bW)^83v)|wj^PI31rSh@fmaf8Xu^fyXnL-Qn&nmYG2Urr;gzsyzjeNa2d)VOoz
zb-1J^^V5r}Pi%);1m6Qr{7t9-G$@gXpJHsgvYMsi-yZ9D^7jroJ*VOa{Me4^SyXzR
z%d-|UiaEbi;k5RssU~V7=hHuNTnByg+D`%HGE^mYGG#xru+#cxSneOpf5>p6$9tdE
zVaJO!6MiNA2xgtxN38U`K?~eDU9|Z#{tucT>0k0m?Dt1Z(T`8!r+ehvkEAqN*x1d#
z`creduDU1wcmIC#*#7BNx8)Qn#_2WA)~>qe)E}JxX*7+W1EOuImANGReVKW8lU>@U
zFsBs2e)aeE008`oj(V?J^QUeFn;9jXI67>_(BP+TeX0%kwU1iEaigP?OH_V3C#=vD
zaEz_$Xlpt{+0iQVEOl4rQPQ-#q7NKY6dS-UVw0jL?i&tV<Gwmo01S9AuIQD9`VQNI
z(q1xjL7a6#FbvPRI>#HgCw)Ee*ffsx85s82c(vMe$yZ*g+gBb;()7kQR>Ga-yzg(1
zk)0r`4xXz6ob5O7Y*&6*P1M~i8;YOoS)D49Pm=8!ACW9hmi@4|^5SCrEa!g}=_II1
zzMO170==7sinX*})d7=x70BrU`ik60!^lq?V5ueH!OWS0D1{!Xg1tlX1$!OvYE#c<
z@tK0I9X(O~k)#iwuKM1elFnIlFO_P=PPISszkT$O6K6Q3y5$h)r2j6`o8t{4u`e@c
z^n-c^X5ef1@JiL-IJ;$OGg5V6_=AZ<z(ihy-jm0@xOI>dj%9r~6Fcw^tj6>FcaGgT
z>hymTqA~ZVci9WL^}VVOyLs!oYnfz^c7e5J-b*cxkb-!?iIE##&a1wm?&=&V<L!_G
z=X_kw^KO2C!aumr;1fGj)w%&9{p$5RQdVlavaT%i;=^<RWW|nZ)k^jC>VBTRpuRRT
zxyv&9UiRMGV^WPt@p~gyraGsy!Qx&1@$(Mo-_~jG{3E{qgY^f@_S@qPZw@*a8uQ=e
zH$YE*R-=aCG3rwz*R<%RbZ!EUc3}OFyw#UI_P}-Wj%w;<&Zry%7?3UUzVV&c-sa-N
z!3oeam8bb$(nDf=RyE@Wr;?2;(r269=tPcwqS__4v6Y_d#DP0x8nuzzU6X|Esh&l9
z_SIH72j?VTr;WE#cRDx!#8N&YrTZ#T@h4XJ5h>080tOKK#Wgzpu9&=0=neCuM^5<U
z1on1xS7C}X%XIe3qs75(j&p&XK&-_{ADG=tJNzJBu~5l}B6l+ulk8WGeOBjCMPb{M
z$)MtPxnl1JtSR>1Q*k~$Be!?R6z)pTtXBAHJ9fD9)HI9P5!Mmu)3Q@BM_4j{l3sUu
z`k!SG*X92dxwtt};Tdz(Q+yIDV=;vniwW!!73yCoL|Od1Ga-AJL%^Ia*CAl*_}YKF
zSbs72*AI=q`r!Y&K5&-!$z1f;go8HNXs+dxe|g{l@9_evzVB#QIBWGX)Eh;O0E=Rj
zQtV6lXYI&;Y%Cnthg4o5?aTWf@asY^m%*2ic{96<%c?2BCqEILg^O-or26N5cc-Fw
z2=Dh!Q{$T}_gCvb=KO^8UjY6yQJ9=8Wld_nJf!vYhg~{4bu+ecc4^$9p^%{|uxB_u
zJrwHsw!UJRa%%#ex$Tn|92^juSYSV48rQwVHwT64Dkw}*FN#ow+l4tsIjC+lZqnNI
ztJOzYPRP9ldmtN$T&N3QNlg{7S^^<m7bqp5EJc!zUaq83ELJMFr}UAi+DqRw&MZ`U
zT#_L_8Z(r<R}V(N36|f<C9_pBQ+CeMjkF|Z#%h}P9M}h5%(RcNs2eo&-D}*jf49Ex
zJQ;Riy)V(^bx^#je#hiKDCSS(M~jo1UFunRbN&)vXfCzdY_9UnWa{*;SH;O}N3M18
z&+Uw~iUPif|5R5@nH{#*Q7nhhQddTpvxpsO%L-p-)V*MSE~*XclkbBLMo+F%h)4&|
z65cMs&q8k=capSwb?zH0>M$zGD!`+!rFzLmh&B>Uda0XYsVVElPLfvVzJAF}Zle>%
znp84WAdrz^>7t@ACA<)QV%rFf#s%HJz2MX~sv@gsPaG8K8E~kLD`RN_mUJ5My=<72
z#jK<rQqQD!%xc9bc9~}876MM`9*r1Yx4~}|^RCU2(I`bNfy|N9u!H2vL%<dE@xR6R
z{(%_X#rb4oWOJm_Q(Mjc%_nc?-NljH-n4K3DE}|XkN<SiWbRKR@>34rsw0)dF`*-m
z5YObFr)CE9mj__@ngl)E<GeTSn>88Tl2mj}#U!ooGl}N3ZI*h5X9uG*<!s^%epM4#
zMD4_g$?lq5QVN_w+vq|cj8X#)Ci?xT!%!crm5ol)Y$+5tNEzPUeOqz0588PDE-UG4
zhp3;@)~#{feSSuI{ZD~C^IcvNrs^<K05TQEJEx6v=^nZ|D+A>wtueLn=!W{R6QCM)
zE!mhc2YM)W1SPu);8c%LR~B#u&_4NlOC8h6VhQo+Qp04WSw}^~N^i|kvd1AqmDf_p
zNXJSEs8ZD@N{k)B;Buoau=y2UbUwH>%7}lFK)W?Njn;xjNV)0inkMvukb0%eZq!BH
zAA<$R%3W8Y=knHm;(KohO~fNUy-nXT<)vDKZb<RSP6TxuO~>ssf#bRggQPyBjYZqM
zi}~_SRK#g?y`ZMXHTww#jhh+H>t^v;QctzCw4mtVD#;3FHC&>hGvE}<A3c25RB}s3
ze{FwrD?>|Hb*A|9KvmXaRW0xd`VWjBId4(@H`!w9a(t3*#DLWj#~{^b*3MC#{xi-$
z5C6RR|KB-@PQEN8yGQmG^~9E`S}j9uT-dW`e0*?pI71?Xe}@%H5z!k<-R1#x(396)
zzYwp1P(2s-RmI#GYK6{9%Y-fASCCuGo}2|sqV$YVBy}y25qjwxGp2Qfm)QQ+8q{p~
zI7h)Deeh*?J|i?=iQM~4a)Bu2zJx}XHcg56vdfYeFBq*`tT(I}AJ}+CUT;Kq!iu>H
zuBMTHNe|NZBQfZIN@&2j?oI)@^29)_IKYl|{i6x$VX8m35vz&5VAZ$HcU4vhd?6YX
zCDDoA2yW=me>ASJ1TR~vU<eAv5T<bs_&bJ4BoD7$&GpNlvkC5{hQrh7>$+it02_t4
z2t~~fSH73bHhQJ9bK&5aSY-BXHOq=&Q3tY|a#+tMZ*}6WTT$g&tt_~OV7-L|7wR_R
zGN5o1$swFk7MfWWW#8?s8zu3vENo2iQ_~JJG3YCJaH$m6e`^eNuEd-gRX~jp3WNC!
zticy=xp!d%0LNNWet(FlF6ZZXf6Wp9U?`&kF5ZV7v*WkBr=3mv_wv7C(IkI2bOMDA
zj0BCN2F^j7NKl<~->})%7b1j**28SMNw?l_fWydA3Zwm=9S^5ZH+jLlqSJu(V^P$Y
zciF&k#Y4a&7PE(sh2#6An>Y<zpFedQ{@n9$r>?6)vg$_Xeu)3E;dt{%d%xPMC-Wem
zly9a|AKl-{eVjObe5T@g?uYfzEHAhpBx9H9faXt%KG^o%Pi4-(&E531Xu5E+%low9
z{W(^RwSm2OwGE-Y(|=NYB(40xu;v}xxy+3V1+RJ}6KC+-k}>nfTNnPMu)zGu@YT&*
z%#e9@n~S+{nJ$MFxXAxu@4dsCO!u`>W*o<{4`M)Rj#TM_1f)8S1W=klLLjt}PC^j^
z0jXo5Hvs|Z8hS#41d;%usPrx+v=ES9L+{O#*?Y~%KG&?h*0s+$dw*wr-}{Goe0h3%
zpXXQZdw{&c^Jj`$=${2%__I|^3%mZwA<JUd&tFpn7yVfv_aCh)E?w3sYA&s@8h!sY
z#d*s=3sm@{Ro0GwcFLbAP@L6&7WhBcjg4E%+utWJ!o|DmwyX4U2$!1}Owm);+fkW+
zbo!}H2~-0{fiw>W&ww<Uom_h+PqO~TJbQGJAhA}-NWIX&NWC9j;vzc;4fL&}ADG>*
zd9i!vcC86`NZ8gWJNZ+^TQ0iO7Z#y3C5r!++BVaE-r}IKh0Id7B%U8#(KnZDNK07s
z)W+1A*xGc9nbwy8Y{Fu;^D}nkccK0W4`1Eab0fq4wBCjR+Y!QB{Vw9Lj!VmtjRv0r
ztMZvXOhC937pAiF;u{Yqe9Pj-QleZtr<OSzV6|Kx5$}a08osYSsjB?vm=T_}I_Bj*
zixcy_1J4b6sTOUe0Bgu?cUh=d=evggKQrim>xC#3__SOf*Ip=!Z3|7h;eTx1nu2ng
zaGr!%rdtd<`#Mt!!4oo)fzH6Q_ZoC^cd5ub#g=pT3(te64QDm1dM_u6&j`L78go`T
zG0W&@T3ReyhdZVlUQRo|0^}%vJw<b-Li|LH!~cEf{=fhGj|A%{I(XtOFBI3H5qJDg
zw{#Q?0#_Ee_Jm5dKcyA!D_W}g?H#@OsxbUBccp7q%Ns}5`#elZioavyg~kEO;hon<
zjZCG~D9pNGqp#F`;|j~J`ESe=Crn;i&Pli2SU~Xm4vMe#5ILu%Sv$>R&1TAR@BkuH
zp{z!Su%dpw;B1Izx7hCMqq!~Mpze3YF_>A-4!K&Iaif$I1Wrk&JjM`dS+Num9C1OC
zC(^5<8R}4`??pgQ89q)o=Rh(&6+4wfqdh3g{N1{jY0kraOR2esPBA?#q7PEw2f^s?
z@4F|iKFRer?0Ld|V~I_@VR>A0EU0EaT=od#bPa2iJ%lg6<z_VG@@mudK?vb~Rt!<$
zWxKfOB+{a?W!54;)s;Z@aJ_Wh?9YDquLmymEk~VuK6~~~w%LO?7=88aOaE`|HzL9e
zn9|k1dj63%_Tp`nj-O(~QCQ*OhOn4oo=tykq3di)=jbo)C5v<Ztm_MVzx}RP`))}q
z-x$SzOT=}%>`g%|tLcd=bGBg1Z&#$5h-(d%4eG!YtKAm{TG1BQ3mHlRk!nZ*`@I1s
zVM{<&D2^*SkraQueF6O-f@s^9Q*ytyUfiviEtq{LmTgjRUu5n2Ug_ixgr?8fTs2-h
zYr9sR0@tJ)f`(VY>V2z}m;f(PenZ<YEYSHAxvw{&oM%J|=H?gp!eQk~5GCFXjR%Kh
zFx;=Q3FEeyCELts_Qc_-N-7x@aVAD_tvXr&C>z(_x!8jx4a)n<;gM^-nZv<(Kef6j
zBK-5J1xco9E=Us|F##vGtsLZ}uGAS(sf%aUg=jlJGgu~)a1Su}Rw;IHFQ>9WblXO5
zSZ9{48WG7S#g!D{fq)f|nh6CPrSOEk35R#1+1NaokMDY6QqVKGElh9~8?l259!D6W
ziez%<v1`b0`aiTXU`cKPIU~+V3PWwEEAv)a?!^TMRbtj2NBbWsd{ur*NZ~MT@3q45
zyz>ML1i{xlSgEcD4DP3rBt;znkYA&3^xMQjD3Z*t#nZlTn%*sT3RIh~aX+9jz2hta
zL@H__%OUwpqugw-bt?I6ETFlQ@P*|tUQ$QB%4}o4Uf&`4-DDD`45x_?!!v;A1A0{2
zz=N!;7>Zw-<|%_ytD!h+*bFv-mDQ{oaOl^#!Mv0W>~jR>tzR2pSne<A-gc4pcQn61
zwlgvK)oU@;N6G3j4Sn=WX3%E9UaoUeX|Xp+<1xikha}yb+!NZDVbO6aR_V&VB(e%p
z)F$~PnBTL^pu0MZG%xN#rJ>P?I2YA{ZKWu)BX-Fph@Ma7joxXc8u83S(O%uGFD#L}
z_*6+A+k~!fI(BWou*?~uJ+B>DC+Zy~z=id{urz2(n*YeX{Pq6|Un710pZ(?7QI+!y
z4!#6;gtOh>WIZg14!rn8Zq#P<s9Ym=W#!Q;fR?_N5?(iBcDuWYpjL!Q-@Kr%pnp3h
zLKH38{CVZ4_ql(y?0$czitIcoehC86;lBB?KJLDNJFpNgG(QEIW{N|G_qb1$phy$!
zVS*Xa1lR-9!!5dFIaqxPUauiese%|zLJ+WOS$FihXrlHoM~Tx>TR_9WGS4(BuUl;2
z3%RZ3FmDu3@}|7yXP7!sR^1*Sm1NP^4^-<-V@#L4%Cb^LGs_ES8&r*`%^w;|Eb5HV
zkJq!(@*^hhaHl;w{ah$jNFKE0Tx$OQ6;A=XY)DAR)DgM0erz<;f474z^ASlxwP~N{
z-LM@VlS@T3&0o)s%grJ;6>lq1SuNMlt_0_{(9p29pg0RQO3%*|DO~x<E{={=&cf))
zp=9a8>1|sQ<}SB?ZghHap|-_kU5T>v<@Ac87L1!|l8ristX3K$N|}ysm|Yu0(Bkd%
zjZMslc`#5?hHM_f*VNZ#Scz$#r^F<C5_K$X9oY2rNZh-RU6{AZ&CQMK(UI*`m$^NZ
zTHfKl&d0}x!L0LLUn`~K$P4B?OYNor+mn9h3UczphP6|KiQN6f05J2h?0XXK^!y<*
zpfTMfYOg<Xs&8Hlq@6hYtVin%q*MD<kv~YnR!sluiL~C&8p73s^Nd*i(?W;~*4dmA
zS>AU<68HU$TwQ|;WVoX6f)Uq<8u!1=mI$ltQ2`7~_;z`hcRis3B->ImsHYN2;|aVo
z&;l}#WW14cO6*<8qYMV3#*mhkm7iM>5uj+26?I8I?~Gekto$yA|1R+gdlu@R5$cXP
zg%7Fo@QvrU6JCOE2(>oB!h&G<j^n(gj1#30H*N%Er99q|2j3^8W@I<q(nd=AQ_H4&
z`ea%k$Mr+StbDDR;!SpS>3JqdHk2O%!!YFlqaI*+J$LD7A130f=wet!(ca5-^}8Oe
zvTVg1tnn;iy_?R@hLaE}54WvxUA=kEg?Qt@-S9Y-))KN_VCQGKsu<4aucpc&<|?XH
z*0A)5>Y<?*NoCfgksI)`uG{7h8gf@KuFDyr6bzp?M;LjywRCJSQ7O~9cTiWtl8)NT
z@ipFz>Z&TTPKdD{*wBz>ARz#}8W=2Zf4W<KKYlTsic`vqz3N=H{k<tjJB*+Kyaz~#
z);n+qGBMLk=wWv3UM#;;X#U;jf9iX9N-_V#y0XRL<0{AcKH4zZ(Fl$2M<VvM>@2(E
z<Zq<|{LGq<O4Zc%hi<lY%q5tvpIcgYVe|#J4T*Bu=xU}AiecLd%iAp!=k^J;nU!Tf
zmPu5UY-eGg=z(f*7I$<U(cT)r6s=)Ytsp-dM&T1<dP<E?>wUk^btdXgo5<?0LLw&h
zml0`uDK>k*2t6?frhc%g*Xy}!tg_hn%-nAmd?oo)C$<-IW-j_i=bojd>Kop7GvRy*
zW|U-dy$;92*D>hD>hqD9v<vGVJ=kC=zbd&3hFO0*U5sKC9U$Q0&>oK}#`NVq54<Sf
zWX7Vv!^GfCI(MnvDvx5I;gf~QfVVWN9LSKeqJ-7J%&Ut+K}T4Huxi8l&G(W-c_-9n
zWG%eFIrvmJY1CZ<m0(3=<)*?VJ9OeFciHNTKe2G{bJr1Qc1TFt<hGdN2Ym$W{`H&*
zYe#R3em<aC#%^d71S*PNnwlOwe}VPaH|22p-X<JxYo16In-`(Lve3?++D`WqqIGQt
zujEs_<@L5U2j7OHg+C}e$0=|Y`f{gcr4$g*c`d0|`Y0ewqvk7iUr!+57Q`&}E~hl5
zC<vvOwD~mg_lbp4tsk8`XxvhQ9_{r+^TZT;?FC97MpKz`_|ithIh?~(|EmA(506uE
zBb%Y)8|*&VwT}zoU5!Io>0NFs3f8Wb8i6+shkHS&{c`B*?7y8~nbs$UI-Gsh5LRi{
ztAMplHdf{H2p3NYcwjN>kJw{E*`FbQZ+2heB<3cXTlOqeXN*oIo<U^msCRPAeYnLN
z6Rp0pW6_5n6?KVd%kk#Es36a}*sty8akz_5uZVs0K%fPX5aIE_zsyLNN=BG$&5Zh!
zcfGb7`gj|N4I&-^^+8Yr!6IFkcxZpK@r;ZQF;U*FDzvX0uoOE_5k)gmQ!5+2zbAuh
zJARz)s~PKWTWieSmE__T$sEBfyY~%e<$HeY2g3NksQlOIc#xXf=W%x-2FSd;E3m9D
zbOE2~=#n{bGp&brxmpn5#DP$Ow+m*ha<5gjYp7fqWNp(}m%1>l)!CMI6n(<;<~sh=
z!04;H7xG8kccp!KIt|2^O5_G3Kkz$mNEcp=Ar)}~Z4z3JgnfHw#s{GhsgSz^`#4<f
z#!)q*0dPOv(R%crjfZ&;uwnx4Df_rWv|1>O#vdEK-3CVsKV^lY_WaIo)J8wLtxh&0
zm^MH#(BXh*8K$NTQl;-T4}6w2y#}DYrdj8kJu{}J=M%LnfA1piCoJQX)r*viKDalD
zD<s91?=liKDl#j0cdxO<b|TDh8VadPy(?0C9V4eJUO!nsYxac&yw4-e?zm)gU@2X1
zll!)efCqZG8$A?u$j`ze{MV$HTrV*?$rqb20j1k&#0%yQIeq@>Z$1<P<!Da5tol~5
zI#nKV>x%FK0faY6XUEW9O3|gDwsY9|^<iAA;bUwmtRR1y0^YVojzwJ|vaJxY{97xO
zAe_#Da+AGERBUwA9K|d=JVVxCY30#JS;aW*P8d)NHU?E}HP_dP9GJBHZnaDPS+3C+
zmcA%^kb1eYvg9hy<ojad!hw2p;)fX69IkKZ#y&(vLe`O6U%s{kme$;XsbSn|b}>Tz
zkM6^rHdG#K0+y$nQz0h@T}rLM8`J7utrmXDa|&#U1Pua4z8m!%lm|~X4tDSH&&>P(
z{1u$!&(-xG*SRQ~>2l1+Ln}_@rgYu&YgrKCIa$4V{xbMNd~y#7klvBNb}+Oxon=;&
z^AVG=37bLA`%BDD4YQnToB#JLcZ`g>P3P?JxculdKHhY3f(i{733tI@$L~QxVfMu)
z)7jV*jtbxOmU4U))TLkFM0OEGXZ2Fo>;>-vIMNN%UZFpkafYY=G*XeZD_2JVt19po
z6HCZJW`%Tp-?uH*Kx@F0F0c9q+14McVS)t+G1$Cs(8qB3)*%63_A_N~k@4PT&?x6s
z(N#WdZ07_Nvvf-T`;Z@NoxLG~&H#*0fr+`Pphtv0pGq@-SAKqYXc`TutW*>Q9{saZ
z{>y=HBwThrHL3nqvInXw5X6mgUOn}RJy5eOf$z7!%<~_DnI_~TEHSc9zWVJb6{GO*
zRCJ!l-8MIzWmlM+Dm`Hgte4o3T1}#}K|0^)C2GRbmO>ipW@0|l2bZlEzmk>J=B7jS
zyc-IVg0E~nXlP{{+EQU{M?yWAcU5#|4-wuMteQYoaLN3nu;^X^Ur?5qfvi-(?D94%
zMQ7tTD#f>HBwfLCU0}7rH?c*(FDNSg@?PnDO0IR#>wx#){|9y09hv*w($$XH2!3lw
z2QtY9E*u02P`eYa15nmwYDkSo&lG)Od2xtXbMjK*?c%`nOe-9IO9CV9$U{P|y8vBO
z`@>A}jFV0Q-y_Ay0nNOg@Dw|Eb7H1u=>xxLO_|E2pe`6!=_{jx!IA}4aNJvLN9;kt
zrFF{QzWj(%SM>#(J8yP9;T3p9=^qBNOxKBjMh5?v1N2Y4{D1qj_4jSTZ|4@x`r_kz
zr;P<~aUo-kVEb@U8O5nxn;8Gt_?_*+BFpYUXe8s;5=am7Qrp@}t$BT2ct5cX`FcwQ
z(^$;-o8k-r0AQGWDEXB$8yl#1v$ZlC@gjAD=jA|LhGey=&*75|xlR2=PYGx~ew$T3
zAdSdbxE`Ke+zyn`QSPPwZZ>^+{nj&M8@;o<RHnyEAP&H^833uKb57?^V0Br(A^rTf
zUOTaa2P64y-0uq%Iq8GA0Bc(ONp{6iI@FHe)!#Z)@L@eb2cmXa_A(MerE0$H>G^p?
zL@3tpJUp-f0D;;twc}tlh@Ph7g@_M9SQ)3x(moq^X#-iS)qAei@wPUmI~E0Pb8>V;
z51kZDM3m3;>%Mda#74}$L93KZ$@VwVh+4V0=pe{7KvjT-XzuLpfs4*i=Lz{4U&>FX
z+MTIL^X&Iu2@;PPBcSt-&6sbFsg3`M>G0Q4zCA9M(lV`<mAUvv{3zB<6!drE|Ce>b
zzp*^+AVM`Ib~nzVh!vdY!hhJgj&YYl6j&j%Z!M-`pY+?K#a?4Dsp#_P**99YZQ`x9
zL@=>$XfG8s6b$1EV%s;@5pPO!qkPP`U=K88o@9*5<-m}8(>^^9J@Pnu?Rwf#FpT1!
z+F0<|FViw_i!n>Zm?}KtHMaBPG`_VXRZ4;F3yWZzY2H=KqY5cI)iCPor6~_f`)^JK
zd|`>3mgtFO?f~W-B^P%kt?0K~zOZa|`AYkn3$=XyX?b+btiHl6foW5Q-g<OA7hZh4
z?c*Q4mXD>m`5$wG-Y1lu-pI--qr1rVAtb&dZj1JdiOiu7g)!b{n96o5R|?b7JmcES
zWy@oQSk35d)LiL#Ev%&oh8R&76FAP)Th9x^rK;=}5wJetramH@Kh+BYG4Uzk2}AD_
zQw*~c4^^_3gFdW6Cn5SPR3m=qGj@FI&`+QlCx`shqB#|P0F4h=IQ#Q871D6O$<5;<
z{4X=fe&c^)`jLAk+i=8AU8M^<_RdVesvK`bv6llNNMJA>VEFoItt5DdIn<~n%a`Wl
z53h^A^Afx5%JiGscA45ek&q@|AGl9;KX}T75oiA?ddmL%s^t-5xaKGKugT;_zqhJm
z9WETJ7W=|NrzA~YFnT-+_`<S8Z(aMI_PNdYnbOyMS~|GKYYu7U0YB6Hu15T*aV#GN
zlUhIM7Z!?_R1=r$b7`v|mcHh5>R6?mSM0>^@_fzcYo(m4&((+Wmw(NN`)j4n|F<{p
z(lIM4zhjLPD%}Scb0W@z-E-E%T$2jeLU_v*<UCt)nmb;Kx)O5d#z1rqTM!euUAxif
z?+%CA|3WSOmmbFd)41Ok^8X(f;D7VTHIe-sY_9!ma>zFhPRo4`E@qzxZ50^o4owyh
zS-T8uelVxl7eVM%Ssr?RsiL{9ouqxq-pa2#)Y;tJ|70H>L;ml(|6WN<%{jT&ui-=N
zMeT_NDSLvuSFpY|20-pcr%8}bmp%#%l4<%!s^9<TK2^sL3CG+C1Vw;(HJ^Z%x)wEI
z;1_@8Zuw(#0mIx073~%4rH!C-`1$6g?shsdRInk;?_EU1rt{hhv*)i(J&ENO`8s(i
zfsqx5AbSh0!+na94o|ht7nY`CZywszwE0kYFKBu+xn(3n`Zty%U_0~9=`JeuRR75<
zvArK~cD=cd?5P%>r~3l-wzJB&vmQi$VnQE<jvcCUJZ8}34*{djH6{+xAh^O4vf2+v
z&v#~k1(dX~3Pwkb$l)25@QCV`2(nDv(35<l^!vnNDR%gSe34nn1f!g#7jT8;r^Avy
ze4>j~bEa6%nM`~C0{lF2;R3;i(=BfNcCc8UORLMEd%qx1(cJp&XPBM(w(s1PX*|O>
zDczKOv9&x8y%^l&WO6dMvC!wP$A@35!KCouN%C#U%UTZ^JJyNDBuy#}=~~lL*%V&j
zrcHTxCmIP0pHX0C`-sUtdTX~;CI4}0uzmha*evcx)UI_NTv1~^OP@15KNVB1EDCz~
zeC)2#(B2vNR<ZHWYZDnDG@Z2_#KeGX-a@2oWu;91ewALoaqSZl=R!?k@D~qC%2k5g
z6&E(wGU~O|5*XPdj>&w*zSgfN4{vl;?h9AbA#!|6^w^50&+eUHfGS;EdflKrH<6cL
z(LE}H*U5pFbM`lLYeuUtRbSg=>T}Q%^#w^!zJnwgj91R*Z0qoquH+>4-$y>!$REGo
z?P;D8Ikru49ve5`Ub*gAHzIjKV4UVpo*8()_brA`6ockNV)B`z5YD{$QIJx96V@D`
zbbkx$JoK{}4R~I<2YT}0c=*S!eo9|c{kM25{e3^gZ_sUcvZ+q)X(xg~BNSq(q1G(=
z)}y#sC_NUN5akP?@h70he`!t)y`LI7^31DBF{$UA{nC^MDSBhxQd>HclE6FUwQErn
z(zRCQdhKH<Th&}|^=s=pUZN_cUU>$4k0K9;^S79Pv^>?aSs8fdC*AF@Z%5L#=7Mi+
zyJyifS~mTziS?}>+<2;V?5&TdRPL2ddP|J+H8JXnUy*6!3i`X{uWxz27Uow3{qXNq
zVCt)9Ig9e7EbB0OqhI6R#9hgFGw5iOmDT1}AN>H6LY!#KgG^-DxBYJ89JS)6$*3`^
zo${$>oAMdC6XY%I+f(3wvmsy!?CY?so3l}Sb-!Gnk;RO_@oy1+{QD6uCM<X#UH&=!
zShBAj7n3l*qYA}M?C5{{*WIZK#eUwkAjgcUogVqx$x2^q!|d+o|6T<_#|5OA1;m*!
zitmH(A)<g_N;hmO$Im6qnwCzz#E0IhpB_}^y_7#u1nNS~yY-`IDW2{u=l+eVhgYvp
z-1<)2z8DnHvzQ|8<C~F5Ivdq&j8Du6LSzucHNzul+>=ohrg^YJ3sY{ES9n^j2XP4=
zH$USE^%`^X|IFYiPH!JRtRcHGiDKPWk*@WmQK5sWq|?6TfmQ)`@7gtDOI4Sxvx{v9
z)FJ>4ao-IRyUP6;NWhcPhVT*L08){RLVim6wL*q@WXe;B;X|CJsEobBlGiN1FMKCJ
z=jHsaT#U7e&|72AyTolRqq~pbABQ5Cvs3IR$jr01yp3*+9h1{z;0g02{{;Rem2hK_
zrzhjxRC&V52tG_)#Z-*Gxi6#|9(G4(_=gSwka>b>J^7a5hCZiRUA;Rj*-dLH-Jx0}
z&cHU=Y|VPk_;pbHNaJHygnIU-yIV=HoPx^ooe+-|(bvX+@h>bnP@Dt0;ql(0Tm~&n
zaP8R#m3H#?UEnO9(z%kfzU3Ou63=Nh5K{}kl*HRmXaG0UaWb*cdsOkLZ<6@X97lB{
zU|{Ao&Fz)&#yrKMTZZY-Lv<I9f#sk_3cwz*XA6OpzEPYDapcmf@es*Ozf(h;uzD*1
z2<MlBlT>+KF1{)c3tz|MXA>_X7Ik9`^XC_Ao97vQl%S6c!H<qSo}Oy&#0Evh5{m5E
zy4rQh6Xozn0Mp?{ZD|H<5nI%-E^O3klk>3vVF@~E^G?RGJEuLW^D`JSrcq_M$yjrV
z&_OM#d~lW17>6YHc`dofqguFR%wLz5UK}6wj_tzWhi7|z%2~OW6Z8%94CbhD@%r<d
zzbIm+D*9mjgyypu9W$C&g`G6`y}iq}SBltaelJ?arqg0LdJbkD$}IS^zn)esHgrx;
zOf2vJ?hSE}ot>XO?sWPs!zhX{R~f`>W@a4XQ7@>oAhl@MwV+e`Q+d6LZjQlVH$k+1
z>GdNM(JZ)}%?urfY6q|I8@kxs>jKcDjE4tLZY?`>Ae8_Y^bGb|>(Tx0PO=HeI|o@w
zBVvP%6|0ZS0s1JA+Tg{iqT-?xB}}Nv>v!F&3AD&5Y1_nEx;|SvkD7}+>7;uj<t=?_
z+A@&o??8DQqMZ6*g)X}I;-j<^UwH1b)-;o4S?JJ7e1`GDr7NuMzB?mK2Ib{$kRFw^
zP)&O`akfGHHvYa(DJ)gbR8GT<+$^fOEmkm=Y#`)>DOlF`Q*x;hE$Ej@@v^CzdEN20
z4+52$2yZk6aO<mteHUiPDWf|OPIbrdA)Thzcf5c;zFB?dvel#bovnL;{(?uj4;qKy
z7@8nJcI{5sa!}fhX-tv4Qc~*Si%x5vPkZ%D_CS@>M?Kd!Zg+OtRq3$Fe#>x4VBJ2O
z;CT{=7g}!>gnBd_UFrFVXE?=w=p;==V`ifwj9k1A=f@Ik+0O<8>E^Z2U-7o$?Tp!m
zW=fyDf<l(sHYTmZU2;Dq5>cG=17WiCs>|It+uihz9$^=9Yy1e0*(-uyjI}pxL|_oW
z>|`)V*8_AlJw%@BBd#Gs9f~-)&f4m!%5W&@0jb`(D{2U1$Y`dSlkOWC2|LGfc#H=6
zl3RMmreDJN%eHRLA1MWv^cvI#O<k()bjmNo!G?ILQRz7ZBFabl8h?P%(u`C{+Qydt
z8#%<5t9j<&EkE+*3i{{pl-UIy<aJwwH5?f2qbk3+0q5h7caBvkr-F9|_BlNkuGP6O
zat5O}_El|g{!X|01fql0;C#)O!$(vF!5T%JRkvdmVih99Z%!*FL^<MeQ*}MM62)_O
zwTDEOSRcu8C=sD<WG^t}!5k+piXfIyz3;pe@0{@P5G7*>8Q-I&k9oZIcj2=4#D`C@
zE2&V4%{pS~gr;ajS|l`!Y_uwxCnF`pCwOoeNz(Wb1MZnub<^{2c$*j(w?~U~!Nnyk
zK^T|HyRepAUKW?f=*n=H(*3*A=C|7rNQ%xre-VX#<5KX1L`OMMWoT(2W+@C{9DQG9
z9(Ws4sGi%@zT2G9ASzsPt@>!jV}Z#l<hI@ON=)zZwmk=OTLY0v+#0#)|Dm4DaZ#1V
z=<q|Hmt2hRQ~Ko*XL{`1Vd@o3##I;I8LPrLJo@%XjAobpAP$6tQ4YdGEBBqMTpxN2
z)ideq`Kzh@?_W=?C4OPi8jh2$^!(B7G4O!7VORj^Y_=;-`H=YAX39$ms9{$Npb;Lu
zxFB(!{QVmw*4mycf5KYeNFO&dZiIFT>#RUupE=lSbtrKZhb2FAG(y}%zKKh$kodWh
z9+!d1S<|k&Pst>!bPJ^2|Hy=dRN$$mEidjTMq6>D#oTCG!kU5)s=IjNCLZj<UV169
zHidVvXAMn_TLcL1$_+fjF5atM+G)Mn7XNUaRuva55Kg;i=o!WLW^CFz3t^>(OrZ~r
z$RhQz1liu=G+{{}*BCh2mRBF%u0$ZTYDLoEna<G!<6rZW&GH*HW6Lp<aIr0rIoa(b
zvdP_FvP%M1`!1r&??;moaIwjxr&gktC-(yHY9oIVijNPg?==m@l0oL3;DL?qR;v!N
z&2P^JHK6C*iQPka_a~#Qj6WZ8pn;+Jo1^Jow7O6P+r7v4apgG~b0^I^LX?U;8|L&N
zV&2T1PG8BO7>8uVG?W7%5P<w}vYGO#*7GTEUcI1Ej|DZ?+bR&1k&Kj8Q}b8dT0BEh
z``KMB^_jc(q3Lr3*9ytzHhNXGyRug?g}2m(-E?zXq0K$l+J%wm!!=bO-=p6YR$`-0
zl3P_N*pqa}(}cq=lxevWeq~`Y4F36?2i3cuVY&`QTW@puf0uN*z%K#tN)Mx+t*ybw
z&n51+P!key_?z>Gy~zaw#lUF)!Ax3+Ff6v`0J+q5G;EK`6eHFAbm;C`z;mZjb+MCC
z8;{eRJ5t!T3v}Ts-IeQ~yoT2$^5^Z$(320#jzvRd3Jo1R-)!#7W>Rc&@0Z*mU-%l&
zrDu|68NaHiJ!|7E8)<`~Y7TFSrSv<uVS2$3og<x|LkIsSioMa96PYOct+8X7oFDQ_
zMKo3T4zd<r)v(cVNuz$2gNcQ#p=gC+0-d%JD%|l^J>>M;Wt4#SnL#i6$juKbu8T}i
zoG0xxeTTIJ$0Q1!M+IPZG;P1#7G(aB3B|8E4FOq6Me*53WW;=JoJ4<ac8}%Dfbzer
z2HXFK{c^m_37se-bNHL0yvj~36-f0I<mWlZHy+YWv6_V%{M_4EFSQjn5!<8}gofci
zQO*9P;g?u0rmz3@=j8rJf&Uz6iCR=+BX`cIAGj`DZOULD@`US{SQ@l=^FtLlM?`q@
zd+9BqsYQyI>w>LYFAg?;4SaIr3(L*vs?3@VaN8XsY0vLe{Nr;W#d7C3cteC1wK|KS
z-V6_1QCW9)+blx#lF(N3>jHyNoG;nkDXguaEks9AUc1=SYV7DWZRs)x{0stzA!QK4
z3G84)a8J`9-|yy#Ox+|z1ITo~V}6LiV3~^&2q~Kjrf<CtZ}gn!@4-5^JQpHqXxv2<
z#u?9q1o4Nbus1j4*SWIkw`_Rbf~G4A$(<g&Hh30-Nw#<~v%|~(y}j0>jD?u$QQ2k<
z**PxD%Z6f;?&Z-FGwx!5+W@&4x=?E*ey+CbTrd50yy*5>UjJwc|G1IYTgk^b`%8Qn
za_OquQfN5Exw^ULx7<7J9knJ)B<>=8V2RSl)e5YOG{n8k!WAAN*b<E6OXv)b0_;Do
ziDFpTLdMm`6_qH`6d}R)qk|{zXWed@^YDz|K=|9Fulk+7<H*S02xv+#8F3v-vggAO
zD^FD^rKzRtd-*=*eb6V_7TH(p)x+t}S?iq4t(bs#fDwfs4f6Z~)||A_Uj@!KWLZp3
zjHZrIMu9480feJwe3P<V(huExIAEhFF<#nJ8|z}Tq~*^eCg{r-+Y&FuSyfzh(2WLi
zQr7poov;-ub{B6y;(3|U95qxjNa5eetPFcW8+D6bb_fQO&ARd<h8}rDyDNew>{?>L
zbhBu6F#ty#ZC}YVt_x8N$9w)Z)-^YB*BvHw*QHEh+eee^BR~M!nD;o06jbVHJVyI=
z$YDq@m)ND3PqbtgQ~Iy^@=K+h&Gwd)c;d%iCgva}d8wW4(ZsW>>9X_vi#t6eh0wk%
zGt8FcK}*EhUl-dK)7##q<t|6f3GuZs6z=D>VCLa=FwbaJL8H58G@~cf>t!gr8oA6H
z0+rPwUB0pW!(<z|<QabSt<RJ6iQAqM>X!NI?I2eY6)fiXYf45ymvT%117h!F#IJ8Q
z;>ZeV{zzFWl_I#RHUZu9?g7ysq6}=L-k3&_YPhi`v-8Gbb+c5!n$yx{pXIvDH<N=3
zWT&#`3Kbc@nT#{WmWGD1kL%eW%W)d~u)e$?2sHV}l@77N_(83FPRICp-fKAn4?aDL
zYnSLFG3nxLUdqT-SqJkDN1I%!^BtKAXz2&C%IiK+ZPkHyZhHMJTclJ96LBuvx^ICm
z3?k}Hcy^z*3%d>;SM%el+s?b>5*{@(T#|<jPcmz;oP8%;dW4n7)#4IhvCd@EH4{Gf
zVG&#>v`76&-YF7-OfU=y@)PU8JWQiqIF2P{e;mQ?e=#5_9s8OtQcWJtBANBUv2b-}
z{~Za3J#;CHub%f`Y<J&?9RtQ@I|i6N<p-q~T^m1Q9PP85nDP7k7is_c)i+;(F12gF
zQcuUN=$bpQJoa?Mw=z^)H#Lfxq*otrnriqhL)IQvWF%Gag+%dV!!`DI&H9Aen9Mtd
z9|*{GZm*LqN~-UaML)cFh?27g$_^ZoQU=fUSk5WgL<Y+>^ee%un7$dJj5c3x&Xi*5
zV3)MvN^Cyt5zZ%~5O%(Rtju`^YF(V8ZqOt)w{KqIr4o(gj1a8=>m;S81zbE$nT&r}
zGxf3J!xHnpN56(NUtW&!{BSTqWPBJZ+jk9_`b^u*h&kaeSDEm}JSw@KJ!L^I6AsC$
z)b3b<AY3yme!?6*FdmM~3>M)bpH0Azxf7pM-%HPZg>p1>pinM9dM|#lSk=o=UVORI
zq2Uuw&xJ|pa#-Rb(Q}Z=@$Jfr>vD`=+635_uhd!{&iA(0Y$<xsRN0@TD5oKz^GnJ5
zXydntw7w$MmPsaswC%K^p*i_Qg-tYv*P=~3bEE%svW{`qv!Qf8NW^6uSny2p^zDR>
zc%sVewwnTk2IL{_b9FQyUZtkcp&xzuWYq`n`ZTTH=DDlyP?-L18>CnP0wFS{flu<%
zxx+UsP*^Vu>(aTSQb$z5#O4##Z<6&bZrtF+V~t}M6Vq7%fv<uX_pep}TT+SggQ(#d
z?M23-fp2UWmemDIR>}Ar#v})Se+x5m&T%b<FgI!|R6aoD4KWvUSmnB)=jeGphBKmk
z-XIz~BJO!HQ5LzwS&YUS=?oK8yiGs$gg>f^@S)w;dDIh;WNnmLD|p@~rx92N1{t?t
z1bxf<zHjNr#scI9SzAB$g6)>v7_&gi1I)&Jk&#2m1JO!@r<lFes9TmY_ex>`JY1Xv
z{#dh7-`e_)2vVIOr6jP}Zq5X7UJlnKb3ZK-fpOk^wTi|tma`MtiwpLs`ahN!6*-vX
zjpW^AT<vr+PgRh^YDLR&%amLR9t2qo<pZwWx}IhKty+wUDcLbr-U#hGdQs6;BD>-=
z_DVwvO3iw^&9EGQwVUqyfy2x24n@fWAQ3Yv2XgYQP#0bcr;}%Bwkn=l5G`{ZfHOcF
za(VNdQ?U+P*J5n6PFK4-@^`w$e1Gj_EJ^unz@h>*wbR<})u)oHZ{mSHEwnVM@sy{{
zh2ZLp+^QZFF`>vf!P|s$u}ICRX#=9ccfHG(v(#GQ4fX!!DbY{LQaTcH^Pq70ef2_2
zk^jBHp^>e2?(it9tjwBAt^^`0M|vaf=PE6`^YK!=TPm~cg`er+L&dqfy28UIygH-N
zn_XU>vgutkMq9Ad)K&g0`^%xY?GBwvF#<A9A<&wa3`JdW?8r1NzD<8U&M}{wZk|K!
zoyW4xiw;wr!i3@O3|Za5Yt=0^qE5c=FB;4UHGg!~bs5ZAKT9(AyvPy4-2}hNk9Br~
z$h<9WiBq@|#t(oo1|q#=zOb0O##_BSasJdXw$_p~Yn~&|SpP@mKKG*2RZV(_f4dO*
z$If#Hc8m&6_!vhVcaende;o_rH<oD2W6+CX^slI)o;H7!{rj&_$>=Q2vZt>|J2dB5
zcvNp8GqKcPAI74RS9v`CAK`xjfB3g=)~g@?5&s|m{v)Je7M4@Nz88znSsN2GO*VxM
z#XX?=R31j@t9Qe5gAa#pXYA4l(z7^_I*8lZoUGoEp8-&5d!lq}(X7w!8l-5bWS~5s
z9l^Cm^dLt7M+9MB+St08Vgm(MFW<BckUAF9q2^8;7OCPOM$V@}mQ)7DvVBZqXUdl{
z6?20pP{dxtKA7YD>sPW)ema3?MFx5qzF5||IxP8877D)T4gJ|Oi?utQy$EGHKw)>g
z2OLN3zb!<EIkGN?3p{}830zbI(*k&<PVBzi5_-NRHth{rxJgwpZFh7xzt@^CM6O1E
z=gvfq+0fagMnNE-!xUckTAMI;3PbCGiGdF$c_}CTyUa~ZfzxL<KVp1>X*r3SiKnf?
zq6WLw8|Bn1fbOEgGFcFg!0)FEZlxx=x$<P7dJb<kzl;8GXx3U30n)mcdhdJ()g=q-
ztOo9#<JaeDs0Y)BHAi@;`uwi!trf!1p7TF;`^~(|?J<1$Yaj29P6W7jn_9{$gBKYZ
zgp>$0ji?HMnUqmXK?z+UQd_F{mf0!~S8w{MRH=Hr@yO5pcQ{kv6^ZTlrCi_`?T%0R
z4Ju3$`71Mzn<5BOoaI1NMuSUxS?PSHItG~eJ#nl(%d^6WHl7Ge$Z;>?_S4O=P5^LE
zS_V+T(~v<hX=aoz&`3C|yZ;l=Qb*~;tjsx85dkcDN@n1ydw$;1EAqqgbfTa-1%(la
z(M)Zm7<#yjqC+5yCVhwZIy?mvAB;3<Ydu^9$X-Z<`Cwh2;5Vp0gimQYcC%+QT$<}D
z;UgTPXf!#<)zv(5*Fx$Idz9d(boF?yioxNMR#W{;sMOLJy4`~pV?M=2zGR));Tyd!
z9lxB__GR4!dUiAxR;2Q#Pqa50&w%a*>EG8)SYN5CBG@1~dm$5avs7&CZItVa#5tyk
zyB6<97H;$3SHOv5h^&Jh#}8(@nd0*<Kc7<nW1U>X9Rm%HKZYiJ0h*Zi4-JJAQzr~U
z<`1FS?~N`Y{ooG|EioIf&(u1N{LG>ub&MlYZ7K7B{rOf(=lz#x#eY+!{82ue$?}GC
z(cA(wSIr>)YuGh!v$GYZnvY}Q?HTza?(yFTUonH#7+;};pI8F65sf=Fl)&ouEW4w(
zk0<%h!(U09dv1Q+BC;#ll3*;{JU{=Q_+nd}#yOWnC^6DXENw=zsaNj|<{<Qxbo)Nv
z#*7}(@M`zDXRyhtDV3t~oNyt<lyn>4<g<1@Rov9rMI<b=AGw3lMdn|dZn&F&TeWZi
zn5j@+!@sQ;Z#EXdA;A-eN8QyySnj4Y-r_e>pR<TT>>kczFpQ2o-?q(;)%01RXt=I~
zKb8cURLBW`w)o1hLSlq)pT}IO3<9t=xw7n2*)js4rOkOfuIt@=)Gou@q@wul(GwD?
zC43=)!cwl<^~4r%XAOt7s_Sp$)GS2o7}=rmv#D7m$UtJBc+B-Ti!VP_!UkWO-M}R+
zdoaqo4Z#(+=i@|wpkHe0HBT#a$EH?DwswRh*?hcez39J~ULgdH>&IQNbt7!6c-Hsa
zRg@t_(Wznpl|w_)VD}D0fh3eJvqpx7>|NJ@@Hh(q-etuphSJ3Jn>$P5Jx0H<+*<VB
z=5O%i`X#Sh;%<!TEv-X4omVES2jPQAyi;N`y3o3;FC&37@_9&*ets&Wjj|L`^N#6?
zX7<|&(cede``8z+;}}J%qQ|bip*xG>pH`5Ej#BkTS2um=vt0=<GU5&(k20aSk*KT2
z?v=#br<H5RR4;C{Ype_r-W`Xz`8J#7(K}`_-<6JXzPbaQuM+z9UHsQ6&t<p9@~uL^
z*QqVc6u^Bhy;j=iqaDObeffJ0|9Db51GAh1^<Y&pe6PNS`Tg(U17Ka7AP1JMjFsQx
z`XR7<<SsC@BieWl?boTEJCB2l;zx^K?{f}kex}m4t};y<KPSu>*X%rZs4JGxC{Lrm
z0}e|jJNM2v6v@kAbgN~RMowgor=&(2+78%uF>P#dLos7U74ms=(hLh!xhmMQx1d5)
zWXz@U9L>~0)@VIwt|Pqh6%7xeI(fGEBxXyu3P=}sRR}vptEs`)%UQj{eP6(m20{jE
zK{4IE_dto$PuS?<IA0rQV$4&V5%CMlTbf)@#(p|m)V}BnI#V?RUud_o;}ghQ#6{eG
zy?WR>Y%dpKu`=j+QM^a}p@q^y@KCx}QGBV!kU&sj*nF%K$xUHjyTcY?=)Zdq;NK=d
z9jPyz__o4m0kAGdoB~$WdcUb?nd54#=T!LwTyig#i-lAwi9tfcG0_A2G*OI$uasvu
zDf-Dz`FS7h5=E@tiEX})vk7>negzB$f#iLXV(9%)i)n4E8IB{{IcKrng$qTGdUr|k
z8g4mn3lfb@dHl4aZ9H7Y%!m3F<md|JEfXKz7D)MnluN}av;c^?oX)FB2zx@MQO8{F
zv&%>-Dt4dARt<|7gNr37bODr%&Z9Ydp4!X022>3boZzIORSOX*AhH5ygEWf}l$<}J
z60l~`OgfC*)|wZN^Y(0Kvx+>e?q}RO8hLgqM1pfW%`y7b{Lwe5Q)JG?R?f2RleyLS
zoQ{In1hJvm)$$hnU}&Q@bu=|fPDTH1qFF|L_70ub@ktq7iqJ*ESEH-FbY!$d3nMto
zTd>QlO`S)zFwb`A`Hj7v0yn-z7U$nFnE%5K_R`fHNJ|W`L68WejLCEl!-`Q`^(BEX
z>BG9ytH^*7v6{iWpKGf44lYWKS2Mi7uyAa{U$L1VwJV-Hoa6YcbeQ6CcE4Nd{cfhr
zU%fu_P{(Uuc9vs1+w!;NEyqt%%bGPTB6oqKi#=~FM`8m`{E<CN&UgKRCAv=oeLy=G
zzOdM(e|xkMvGVPIU!M0Z))vuJ!|yzHBtTB?qyzzvTi8SqK}MwmMLi!ELzD(IRbMr&
z;6vg$?UTV+4S;GURS}kJSl-M(6ZK9!UW}(<>bZ^PP%6bGz+(`Q*>ckCd8S^boum!$
z@&LeBUt}^rG1)4i8=K1Q;$)`9WgP8Z-ma4{n$;0yK9t(zu8heY)iBk0@c>^CLejdN
zfD8LX2{R1RXMikhKr6y8-2bZAzWuA0|KnZxPY?Mq@~@eIR-T8{LauX-MOP9?x%H0&
z?tOR856DXOGEh9-U#choU(HHjMS)j{ax(+fi@t3@`&&)YTG54$2gdF2d*(xs5;1cy
zHHcExyFmGD**oLf`B{xKZ)eJOIi!H)-$+AGyh1dPEJ}m5b?H%adsF>R)$^njMS%*!
zb4Tyn@w*zu?K3OLmAnN$8QvBigC3YBLC0><zI=R#00!xqc%hpema3X*+);?pb4+pL
zs;JNx796WQM9o}BE{DqBRo9Vg<)yu>x4dJX%4d2Wvi1!2{jfo@Jq)FpCgm>8TMvCK
z7RwPP2LbKM-N?$g`m3|HL2;K#{#F&o2o@p_8m%wRZ+Bm?I2B@15>YFhIBNAKW8&cu
zDl6MhU)o~QN)#=Yz?SN%c4(8fWh9sO>sGt$`@$>d(}z70Ie&0S7A@v15#tP<1F*fH
zp@g;W4d-3XUsT9L@h6WN9fB}#$QEnCwgcmaw61G0P-4r}7$nIt>+rHVgSRQ7vtlWI
z;>V`B^>YuJ6T1zY^-eC)b=;yw0Dx73Ln_k?2k8>ZNV1lhd+bc=fqH80BOM(l^T#xt
z8=~M8=Odl1l_WWE9sa7-qHFKzP3wz&JX-yy2@!aKgxGr;JmI3EpkN>S`V!7&m5H5<
zB4mF=gdLGJzt_;zfAM~kq{mQR)F=3Ow^c<d6garm?4+H%!69P*4B8Pdfb)nN;*h?&
zY-o?(F{M;ghryAaNm@>diLIhTm$okxye{>kj(R@anxK&$lOqDoe_;VB3-!=>^;&+h
zQXRM3RvFRV+0R-cZB;Ka4vWetdKWo35J!eF5zghLT`dZ@Ane6Rfx|c)l6tz-7rpFN
zwwTx-i|UwU(5b@?lME#{^7EL84Kj-6eR)oJ-D5PwgZ^aehkQ(aczD6sp*nK0@7gDK
zY)2Vn4CbYu0hh}(D|9Dq(SRxyim&Hwk_GZLf6a^;Ar=N+QZY=2r5?qtOM#Ioz4Q(>
zy;F)2H*F7Deq>?!*Akgdq`#!UjGqO+ZU+jTm(wwf*Hcmc5oA8RgqUDx_MuVaRcs<y
zP1p5QYdMhVUWZWJY-dB^c_MkAyxY=TkQmx^A@*<Gn39`^wUjwd7bX%wwz951!0vLT
zWO;QoHYr`1_p-|Q&olaYVCqMQdB=JG>rqJbasmlYrzu%_-W5>xb*-(V>TK=$2~lKQ
z@^41|vYu=<kqFb0I7eM;WFK~ylM^d5tw6g_oKi7D^T@+*`Xb3NXW~^rk5*2Dle@G4
z30gfp^a6LJ-{#J*WD2Mht)H>59ZhYJEJ)+9NXFVum-zB-n7;I5cM_vZ1uA(qz>emY
zRHtcCvE=8^qmC~0SMMKGU$C|>+`AKnKmjDV;+mDuJGEo7F;4?u<>n*I`l?u;q@}7f
z;VjQ6_?;!>bc;&vi%Jf+0QA{B&4UM{s_W+FQc%_<9c7(XwnN$-^$GJMMf6+w#UN10
z!(Iac*1Bmd1Rrapf!!UVT7Fw@JR&SAR4;2DO)oMkq3drys-gH^PP7<X4qR8g@y6bn
zkxt&#p{O4yOB_mFl)qyGWtzt(uqtzZj?c@zrKl)e()kJXlXc0gI46H#ixAEe;6WA@
ztGw)Z;&Xb3J9;a}x2t_{37*HHC?!Kgfe#$Nuvii2JM-nzK~x^o@)_X3qDpQT4@l<Y
zfSd-O$~-~EqM#1DCdJ-@VZ{8xht8eNubDrSpEjSLd0j<CmF?5qwAteo;P~is)I*eo
z3BJPro(aS%?^$9IKPDxiOM|~4fwl^4idOSA{Z4r{99!K?aPghoy{mIyt8NJH{gx3?
zHyIT=BDjhlVVlQ<ree^-3!Jjf?Q0$t78%adzn$;#C+qZ2$}N6-=?hDtchz$v=_;-i
z&gP;)9%W)ImR~LS3`*lx?6P~2V!7i;FG3$WWnNCETxzYo1*WF4uyh+8qhl9#9lf}k
zIe@nuYvFI%DWX{1sXwG0ZZW?pyYGKLs{d2ZH3i4HX+MMZ@7z^SiH##u!VBHeWK>ZT
zMKpJAP4xA~KOn?RR+4dC6D=$Oi4=1M37(wRZVV32#RC$r<S;BYJFP^;VwFwPCQL<$
z1nkWQk9dNsf%8U%Z8AjT#M0}jf_DToUY@wx4Xy@34YSgsz&>t#D`*Bm#bo|q{XsF~
zUiG-b$$7%Wd36p?t@;y=Hr6Ig;S29o=JYR5^@}npT2QUP<&<R*KKJw7X&0G_qd!(J
za(deCw6O;CvME+*%I_!oonbn4V#342^Q(jkZr1lCWh(uI+j|nb0LVO9KCY0Pt!Ljz
z6S%FC-h7e}h81cn#3b8BvCfA^sxjRx)iG$7G_x$$#<!X3`$DqQ`(b@1;yW+&>Eb&K
z$QWY3{b6Z*Q|REpl!nvn0D}x3P4-UmwA7(f0E?bviV?(~dhV$HC2g_G7+%D_A9)T_
z-mO7C<$?KF=od!t-GEEUh%V)a+l*C(r#QaQw>N5aMuAK;@=L|h)%BKcOF;<+3dXxM
zJ~BywfSTi;5lgt8-WH{%rUh(1PwG#W!3w-G^8dEWN$>me5ox~|UbBq-7*iK|-TsuG
zyZRJjI?*WagjsrVn+Bh#l#EMgfoHb&k=rx49n^+67Zq^gw-IU1@T7^&L4ZUca@ZKJ
zmj6shd%KZqkOH+CG)r4(>($NesEZVNj9}-2rcQ4HjdNgB>%kLCk<NXesMc3r8nz5{
z6<j>$tb0n@@X%C<Mps?*Zn*hi|LC4+yiKyMMx23HHEG+w&}P#qN6q|g7_5OL=R#RQ
zBQZkzi=h#C>(jD*A@80aMO@)nqy{7_h~(dTFw)u<EZ4GO<zQ>wl|My`sMedIH8_d;
zzvxr8qUu>S>|gh6=yA>lIbHTpK>YMf04kPnmFp*UvM0pCW(8C5$<gENm5>`D(%7ao
zt)M>T>o*mIafQ*)UVT)@0P#|}^|-%QdPVvE3VvZ(en!a7+05+G_<r<D6KQ-cx1}Wx
zYTBz9p}p_7L0;MeE5f|93!TKDMnYHQ<kY9peDWVhf2XHJcqFlXa%pbAYOY|Kz`wR-
znNJWAb-C4B%@}gLWIUN}<Fm98+rsE#l~-rN4qYFRG>`TM_1v5FID?+^bGh?#i^F(<
z%}S0{HXF&#Wi!mAV;U{lrt7>#`)FVbvy7SA?c>UqSERh~;^uuY=iGIdpX(eJat0*q
z0<tP^ic&LLDW^z<1b*W+^MysH=;EX|F+_OLFm5W~?NUq1c|%NIUhG;G`|X)>IR(?U
z{P1YFbLZz>IYl{&L+?AddAfr~ii+NQ=>r!fkJ~}K>U(gCKzeZtQRk^;y*wL$GooYa
z&`bitfS5-N`9gCzoPSE330Q^<F(epp8iWfWGC!)QQ_n`@1hN+C+87nd2SGnRvQT0d
zm*=EeXxu9pdg|E1=<6G@Z@z(VbM|aW=EbW+L>med^r6Y#`u+>@kg>bfLj5zv7q&yp
zN-J`y!DegCB8y%r6u+(Ex2$4|YeX1Uty)f+J532wq=?3dikZ@yszkb-pc=)^tBdB_
zXA<zZ#Hq(cWxY6%t-lQg)jS=me><a6V$?=$dd0N@_qG$#-irK<1@td<fKd(`oY8Z~
zHp>Rbb;5=ecZ-11-M!_N_s_Ko@=4D}j14kfN#<2hNFJv}zgps0qR~_mV(QF5rt&L1
zvGcMnRO>^19YOsI%PE8l&3SD{+f$YfbK~~elQPWnn41y_nM<;jz={xu-P;4+P)z3L
zO$43KO0cTWhwA&Uvo>>zx@1bu@R`e#=9ldfv&VK-`WS$4F*87dtcPdJQzCr8VW4Sp
zY^9hT6fh!JI+xh-fuTq=E0BCS&yKz?$i3Pt9Y=p-#I##eU~PISG)qCQr^|dm50I3w
z&_i2vQAPD;Y`0uE=Co~;qj5v_jR-FN&<)GUt7ASp=Ix(pToQF9qpdMHSa4j&;CfQj
z%CJ$!>YJg_rz4VHoD{nZ`V@{pq@F!UE0#gaj!up-HOWLdoox$i_NoLQt%0zp(VM2}
zANx%UIDVKbN}zvQx-uRHN7?uat*#0OnRev&3%B@;w-59`8(17XjE-CI_v4Hbh@+be
ztYF8Wh2d3i4FuHl*6_5jYoGPD7TK6OZ{3-0Q5^uqfNCy&`J7QtGlbt4BfnbSEM{X3
zi}Dd04$bdnnv;P*V6#2wwYjjBq2m4VP9_ubL|aOHUa3mB&(mD!p>T`j8rTL%Z}iM6
zz%mLvtW=q@oBU9!28s$AP3A5%S}Z6(DC|~3m7#u}x40T_>3SLU0Dc?G6tKSKH?egB
zw?zTC`+@pc{`3y&jM{3!@XCcc9+?j^72F?9@fxvxL#$kI+xha6`d^|BPe$RapU{|I
zaA?Vv(D2Zl3<dNKNg9*PUi1)3x2c@$W#nR?Ia<T)fK^4dQTa?}&o!NuazC-7);ZHQ
zMh3f|N@bh&>QROrX|6q$aF%dO{yp)`D#|wGL{@ZgqhlVH;T$dZxGoMYDtSOtfI3qx
z=>0ZhvYf5nxE>vr;<<*iID%c`Li*l=2b8FDtJ$x58By3_Wu4fTK1>nE+4Rr!I~uPy
zPz9(Pa~=6ph%_Dd8teXMYfU(2k?0%*PyHBqq|e=mToJx7N1AJ+ECw6;0!p9AV&ecM
z;EFD~3Z1T{_<ynY9#BoC`}#05mKpmXM3kZqRcR^`Fd|k$4;V-Ygf>zop(wqh&WI35
zFknEcN>2j81QH-LMWq)h0YV6fG${$v5d^<|?*B}=>)x}zyY9L7TkF5RvlokG=iTq#
z?|%EQJx`E(;GNHF=AJxn?wk22gGZ0jA9*`DWYK__q)^FkA}vNEb>S6Su}-P9^x2if
zq`j{e+uRRTcByJpU4^6jXQn<kzp=nOS4+bZTu1p5ELlJG=FU5r%4Jg<_C?%eXi!zN
zx{8fG(j$*R7ZgP2#rqRT&YvM2`t<bmq%GsDik^e-=EO`Hb%BDKafpIY*?TO9QroBX
zqW6xVe826vsxy13K~r21TnlQybS|=S|B1tIN-xRs{A-PFWL$o+wnr%ol&p}7YYZeA
z5~Uc*g13aJh1hNYgr995&2dQ%**<=@<xUIbU_<zMhO%kh&(E}y=LT<6-70ja&0$hg
zxKm>znboJw8hz>>+Qrpr0d!ZvHJAjKhgw-Kf%_BWU!ql)SI$`%aZC#WOc|CMsJ3cM
zOw~mg$?}<-tm4pAj&Ljf=z&>%!Ns4EK}}LlrM+tikZA99l6RDJ3Ae+VgiCLm-vJPc
zuFNm@3LC=rS<<YEaQPGAbjP`6L0*294W)Z8DYme%uLenpV+p794E!iQ<!6_f&L<vx
z)vBp@R=(MIMtiKSH|~(L6~n0#rZAY?j1{OiZjK_FDJNq&d$}k5o=)gf;Y49CSF|It
zxx;YgU`o%eOnk-eDqCOdQt2_w?Jgz*rQ5voAOT4@mA<8im&1zzpr6HKdgcxTn@2Ty
zC%R{aB-@E9h2zH6K_*EBc+Scp1KFHps8f0Rqtpvpu%Rjde1}L1yzt>mWTH(OX2QP~
z>Plz-VA;9zGmG3RX4kh+*`*@kA39$uHvV~EH!CXps}{B3MEUl_Bp=zGVR?S8^R24H
z!xCfD?)nsLiU-;1N;zw9O_eQCcPwhMYbomELe}JkZOZD|4;%Cd#(24o5PF+!bE<m;
zgv>8~+^ld>g(NxQC&S3D`6}Qo4*_k(kHCL$M$=GtvK41X9s3Gkl7WL87j<=dIMnlL
z+xHF<rfvTuxXt{N_clT0cLk`=+JMLjovHuQ#{b_g`U~Zx+fn~N_WCIgd}puj__Z+P
zyg8*x37oFbo7NV^P?vV##ksB7h2n<3UXNz#=pB}Atfsyay46T^vN!o0lwY5FQrNK-
zbJLe54NTsWmtKP>$ajXcntd@Wb8xSROB_D7q0eyKFTKhxJv$g~Ij&uRYoBn>mn<ch
z*+e>KOV-bNe(~0Ivt7ww^7@r|Euj2NwV)#w<z~nQNfrVyZ+uZLAF<rceL6}S?Uvbr
zqD5j}$tI@daZoIItiWq{kO9F>YH8}L<b)mPjOy{lURNE@zbyCoJ=VuX=tT{-9kGdV
zvQ}BRAS}YB?+WmnKtGZ<L#zp$?Us=XIUq;|#|D47+ho{hAS_?<e!&@`z22)a3fo!<
z<JX&wZ0FquEJ8MkOf7CmIWU50fg23xDoAZdLBedbvrq2agSz2dledz0?~rYEC9gJh
zJ$`4%$o2M<B=`j<1^AJWVo{<>@i4A!+H}BW=BWMS<b8sA$}q3U8m|sEo>5XRWvTt(
zGbU&!LIx-k268nslt`k^0GGOEn<ZLuvEB8R61(3d#I=2WY0`Rl#W-;FQw1>rIjRTj
zeL(j0u?*#<UmWO!`Y@p=oVwvdL2S52CB|amo{;amIoB-fX@>UKX&;dvp=Li046Bv<
zXbA0`K6Kchw+5d;W8JzgMIEU#Dv&6?nilK>Z^af=T*LuT(6WuMH9W_$oKH9$KqilR
z>%j!jO1LTmU2$(HDO&+d_dbmB#%=W@m^O!GuKfF!ZID2te#N&&n=dx5hf@E9ixW$3
zOvI|C&@s9;0TF8bKT|8#>d`j#Mi#5NFoAE*Qy}1HRZF{MuhKL{>D)4>M*Q8T6jMd4
z&vrtMr`=OH!-e|i*IBhYDn!2!>fu=ONbVeTn>r{+Nren|h$oe)Ro9>j*_?c|xyd#7
zvkB3`akg?ENco!T3UY6{&+DBqe_SkEw&Y+FC7t5!I=WF>aBNixp7Al{VJ*ASfTu$%
zcAzVq!TN}GyEWncjr%qy41nb^?t^9PU@CY;=RDbWUm(T$WuN`om~=c}xH^e~BlQ{c
znl~#K>3Cug$~%tD<VD$NPgQ0{k2>aO5+TPSWUr3g;<Q%b11vbM;*|7ENKUx0fLN-V
z2>JP=4U)X5Oes0+lbU@i2=(%8WOL1d-tg>8=MQ#z%+i+Vi<VbsjAIUyi=ZggGs#*E
zdm_y-nA!#?Q%>WPR*|b$M!8_KpC4m%<t3Dl+3s>OFo9pvOjQ1yqnLGpFK)&M0j>jF
zc+fyb3)qC-F=d<AN7WNQ2J2u=n6(*ay<N{s>!lvfM%2X09XTb3k=2!mblZOLnKslz
zF9CO(-k>|5Yyj&E++Wo2FlTPMS<U_im~TQ0%#}UYhpH_qyH;6XxI}=@Uccu&$a#m@
z-UGqix@vjMe)o`fAV$^~n64|!dyk^4-AyJTEXN<_tCME94u|mHW}F(c37pG#KdX4!
zsa@Ts7tYggyKHN40Axx6c{*1(Oj@$Q>24(&6uRgk^=SgwFL`3X&!y9=GeXb5(%#}4
z>iEn6cdxlVr9b$B^#JISty0Wv_Yl2EsnluoPRC54*G>LQTxhrxqcmDFYJ5hTdDcLV
z<z&QOpvcbG*Og?lZUhu<{XB<fx^nejx|Dlv^DPV3i&*4ha7)uzbXFDy>0ebNnc!O#
zTfT42S7$g|c1Z&5$5qHqD+#sp+tndk%nl@x35lT>aYk+ruarodOX)ZVPVuXj{IV<(
zOY|10j;?A@uLhdx;n7fricm|^zYy?<K%%3;)tw3KG#Wqx14hC_x=i+8x!5unI-MUp
zX`kWI$G8#f>ZxV-px;P5h-w;<6J$Cb+kq$Q#uPgQpk%K+ONIA+dNxuIL(V<^uKE36
zy;lE!%e(wP>G<C(t5S9z2=A1PtLZd&iDPe6KC^@)FJCc|?=f9d$&?%Z#Od&@L?T<N
zD71-+W3TGVxvG8X&Z;ab6eLrtrRtemP~dWhNgc(UE5z$<*`8=sz%|AXlIN`XY0(@&
zP2r_0b3g}BQveX98d|d8LJFn2c@%kxW3C>;y+TcWM|cKjNb8tuZhv4M=Ma!<G6CJ=
zor@ibksv>3Om@LuKV_9j``*$XnG1dPr+dk&*k|^oUYaH4Y(!zxY`Shozg@q2n`gRQ
z9=?5&Yw5z*;ynyr@gGa;u=j1njU650tQ-|Wu*}wg!T|g5Cy2YRW-9rk$w(*JrWJmW
zUpYVzuA>!myB)gVYqR|9Cm;~Gh*lJkoa*YIKHot5z_+hkslHM)6_A;V_A*xpXo(Z=
zP!G<d72lrqosp7lb$_5=^>CIKyy^UuGl^n>&3E&J(esv@O3Rxj!eku<WQlAOb`k44
zRP^3?c@KJK^)6VHo(%-u6#Ld(q1JQk*SMf^_|xfrX}{yuC?2gGdw|Vib;;$G_x4&a
zjBXE)b2}aiq1GI@77~+9IbrfHt@ANYS+#r<Cey*U>gb0X+3awOc3Tg2Xv}6dw`H_E
zN?&kjmQFuC_dM?n_mR8i)Aqoh&5^s<ly>Pe`Q)@0IA+hLP_aIKP?v*x_z93#DNA-s
zXm9_TxDCH+1rWs|yXmEU8#h~@m^QG5Gm*kfM$hVMQ#DxK>P~&HL*O}4B;<W5RNLTX
ziKKgh%|TtG*pWMzLTj6Sur>zXg{=Awj0-jxP1G+QO>mhs6Nfz>a307%7mGfY@Nq!E
z=<;-zI3ROC<>Y<PNN)9hJ@47YCBF>q>m}B-Gf!MsV@r#T!&Hy#b8Q(l%0$V>GheGH
zq~jf?C@eEjkSAYMG9DvK`MH#_`ilpDa^9sNQYoG12~l(QT8+;dbG23jkq#ma0T;Ee
zMh)b7WE<dU{3?cGYI&}kUVOS|zlK0}O|+-lyY(&^>d6e;v=d*fq>h>?f+buLe9Kpq
zs52K~d6l58R3sqWo{J+*Wa!u_3(lIr=R?xJ=A_Z=YhnHA<B(NHu1(BX>VYNcm%kia
z^-w>%%?Tqn%#o3>Yl=L!cGDCcBrprmpJ%nQm(<^Hv~po8o@r2$2UOkYE`1WBCd)DR
zVQE0Ac`gZ_tkne?Aoa#0KETTLuZ(z&mYPxAbd_ufV{1}O_BW9`blVwPU?hKdhD)~o
z@@W$r>?+VuzH89X3-mk7Sit{ozg@`>Z_cxi*q*nu=!(q6Z_ytQ73PqgWq_?(;j(?o
z%8Sk=_2x^q;&t%R<)d!yN#mR&pM*>;lLKUBWx;Z%9wNY8Y_N$BpsgOJZTf{xQnr&A
zLB^SR$cq&%yrkkXQY<!WWXR0qNzidk_q!J}L%JiCWbXiPSG(z#B$;w9#N*XV>`qV_
zOI72Ycl3n#9jito@8~1FjZ!*xo<zxB17^`$v4MBYu*>Ax1$)(=OGnt*QxB(CAx=dU
zs3+&htc&KNA;+FWnFLEb@`sLoj?6YO+mxketep*fh8q16Ekk6-dL#Pg()ykxB70=#
zre&>a1c5EppD1w~cCGaSHeKCa{@n)=(HsAAs{5aIsyl8>pV{?{egz$HxRv5hVr6Jw
zuBMqdHytxkUC!iaDEV794-QT^uUGb@r%JKsa5&_^N~c`^*Nt+?E{qkdz&{y1;LQcQ
z?(EVE`z_w@Bo5zcwM1_r_)?|Q<tmc`ArXgE;V`M}G_9sa#SUzeKVs{4ly!stTY?rC
zkMRWlVxooQu(7HOB}<M!QC{8Q|3vMPxz;CxcsU_{t`DtJCcIDAW>2OW0H}awoV+M;
zKl$_pYRYndW=Q#baIMlo74Cr-6+=&u@6}SwsM$EF-{`HDrp5Z_j>(Pb(;fOMttq{F
zpXWm9@2^kW>b!7jdW*nv$Zun6Wu9y$&$hrWgk*n7w!RbDF^HN#63X9^K4`9DFEOsK
z5Ga-2#^fD#y$A!ZF|L?D05>^;8?9SDHx~v#7rwah)v9c5^J$}s-DEZu<&QM~emiH`
zs5r3te)^d9P%BbL>2A22cC&xwt-#>ZPEOeu-HTP9H7kDQ)w%ir0ng8F&E@o9inU*B
zPJ!xE)Y?gEtdO&VIHQvh?Az#p$;6<`5-i2~V&q4}!Wj)YlI|~&hmWSK<a?SLNyiXE
z!52tkuW&j3YthFgD4ZaN^J@CcnahlEc7%<06XsL#Q!@p3Le^+Ntmxrmyo=YrC?!X_
zj6@M-*x>d-cd=^tM?Ma{BXPtEgAM$dvPW&vp?j^k247T!QZ2@)q%$DZJfA9}79TFL
zb<p~jjYU9goU+p1D-SOKwyyPrp0s|ZHGq9n-2&j!rbNx9JBR{oBk}Hlwyb?A!lmu(
z{;-=~ebk2YkGbf+ZhMb(<Cssm#LtF>t6>~0B*m2<t~w%ce>vT=dBQKFrChwXjVji{
z7{Dq3(eHY#NrR1Z<?O(B`|SGUND{z~GSI$Ds#552D>`@+(WRm97uF93L8_%&B8j46
zE>i6!QlAu`56kys6(#c7oFGoMWOhGNcaXN=?MLx6j7R<&+JBBl?ADd+*v0dX;MKNd
zHD3|Ev0u&VjhGx1>6?R&!BIyYe4cEja(sKA0%Vc@ckV#X75Z2g^&)jC9#ZB(<p{&a
zZ>JrIjYz5C!Uow&9+*-ktGp!HwW1Gr`aA52w4gi6j1^Mr<b6rF^?4bn{THRuncGXp
z`>8!!mfMu?&a_ymj8zAKg2oAdTpF5o=?!Ok8wessilj`afEI=?;;I%6PFt4{7J88*
ziMp`kw`P_B<nM1HlzS$Nzu#EyNfD|sct&}?`FMW9*_F^JN)+d+!WZLr;X#CK+E?Nq
zPfD;fcp6%Bg>z-*`Qfj5PPICXa8#tx(yxe@gZZjuObMf>{k35KKy<&XF2Sm%Di_cr
zBSDt|_4DULf8>1mXHLUEi%8CC({*?@^K9kjfA;2by<L;XOUzfyHwt&w{qZ)CKMDxc
z%OO<3M!^>1d&fWCMf&#w8m?%DJo+!ynq&H(x~(|dt=$Hh)&)%H9e@8P0fN*e9_92P
zC(2_KHsK6M2FtXiukX9jww`{*VqmdWvEAPG7m>?B|8=dGNH3~AkU4S06vuOoXfNAO
z@g!;lf3zRRqBG_ld#UYp_jva%e=QvUCZfgE^)Q3Lo436%q1_qlJ9K1)C3VV>EA7SR
zXiEaZH!2;SRaS6W#4~zkb1^6B>tOFn-h~MRr7ukKtg+vR-A&&AcU=y7-tbFBBdCQk
zb-m0F#aEt91Q8i3QmVLRGsUGdkDTx9lh06K-TVID-z)o2-(Osnji&$fVSc32YI*Ok
zuFC%}jGQWaAhqCAktLi^(_Ob%J|{)wQl`I&yuN+Kqi8vGuWXR{_P%SIF!$UhxQxv|
zYUm$p<knByuRN3A23w;=Lk&J#RLx#C`igle`(8x+A7%O{fB)Z$u-Aj;uA&2r{QJM+
ze&lpSVR7S==Rh4O^>#h3HWJvOdu)!gc-`SS#SZB2h552)5_vvGiv(uyAHRObei~D2
z;#H&6a*;Fk_tcQvyJwtazo@a6pPiaT5&oV!@mz`=6Zd;Y$lp_w?|J{<dfSj=xoJK=
zMeneAkp{$u;^sv|7GZKVJLe2I9?EMd<Z~jCNXI90<LdEWf2xS^Y`H=}Nd(k8R|%TE
z%5%RMpsRgty{0e2`%2Wl(?-69F8=*YI++)0{v?3fdR5y}RN_BeE5bL`b5vjrCr!v;
z7Jg4H+YxY1H2m)w8~>iV`2Ilezi#`lN|3?)t0w@1<$tphZrP|VTdyQPc<tq!Zse7R
zBV^Ko#1bzI#AB4dQW;8+wC_aznPuwaKVCnsf9ia_?@?b{&ice%|G%8vS=H^o`j4~y
z(<%Q9D(gRf`1ca}kw4m9X1ShdREf*}%gH0Uko}Ld{qre*p?+_v{|o;A-pAiXzXEQ5
z_)kKQdaJEpn%$c{d@uP<c;+YXJ$5^*Wza?uoA%}C3PN8uU0Ky*vE*S$LZ{zMLCQHZ
z3VHR{h}2T{%fk_!lq|b<7byjUKm3t&f1v(f3I7vS^04dK1BpY$sRj!zV>*>9maR_<
zkciD|pxm1n<Bz1R#^8q36YTIL|770HiLrT(yQDCwK%*)ae(4l01|VdhvczQgzy0S;
z#Jy9r^Vy#*Hnc&WXtShHBAy4H{a3=@`uF{RRms0P!|#*bzdFNzcV_s@8r1m5bo1+n
zp)hd8NKwiq+>%RTS|?Hs4TWCQG$(cxB#WCVwJqzJ4FRyfyKg<bC-UYhuu}c~_+iq<
zIa<426HmA>NDCXPl7nATrY@d5@!X?FF2HRzVL-h+Kfi@xq1QBORdT;AEvQkNyp^6=
z-Vz~aH)B=Q9Mko-bIH#huIRX`p?&_F2v2?Yd&!kbR1erOutE656so`4u^RzKHGcgy
zYqEU1he$4e<gA`dORmi%`Ge0Pt|@yrJB8{J%q5lmPXEyRd$IofjP5G=+k_ngOxPdC
z|9Y~i#2y#<57a#06$TpZ(u><g;5&wqw6|{^R<&y_O)9Uk{T_1JN;Si=a0{w<7g_!I
z)?>?akaa9A-i5l|WUCSc@RjgZQg&btgjx-I3{LUS+2VENyyug55%SX4(*}kZRde4&
zzWSw#YwuNgVxoHh;dhQ^JyKsi7aD9m{+Zdl2n2k5x%unKKMVdp^KA$6@rYHk$zIEw
zCU+{V+Me`^!<FS`6cI>Xz$6x4I0cz)>th030xePokRnWtP@hR=Q)o@GW18*l=T2)0
zj>**eBSwOiJPTvTklve7WnA>x-$=y%$<iCa74waQ6%rNX6n}*0%@Pf2;5QNFtzilc
zVFiZcso#I+7jD$M0v1m_unW^I7v_RUVub`}jAM@y>ByEf2pVAB34$~MDp~qVh7(g8
z8T}>Aa{ea4$fMXq_HtI7E1$A#9;VvNP_7A1YgFtKFlv@pj%@60CeJ8;B2Og~XBBkD
z@ihN42n6aJQX4ZzNiS&1zjjsRs?vNgyX}j5#WL|d9~3;oK69IDPrTrc2}Z&tV`alu
zKbL3PRskRbgfjc=s-C9hXyZ_vhrKxprp{-ixe4A$u_iw&D=Yg!XxKDLzbs8H&^5+Z
zrHXsE#Y>Y@J+kD1b@m+D00q~5l?of)@k^7scjb_b-7sIwiCj=nl=vfsh^yYGtY28d
zm0lIp?IZFaGWEkU@ABJkzq|>>(9wm0-kXYDmKIkBoSdS#&T!Ey0}toqvs>@R=6UJ(
zEFVbi(AQGx=+o_R{9ewk5TJ}FvQ8;RE5|(Bxu9V<j$zJ)!O`Q60A2UPJ^P~fZbHvf
zG#5MsN%W@e)fSpb_@}HRa#D4El+F35!=8j7u~fw&<zpXu(Y_b}2r7HRqMv7fb?wca
z2TWV(Cl+*3hvtxVOBaMM1caW1lwhcKIJW5_Yt1D~T6wG055yZGb|LRI*x9L|-cMh`
z-1pfieQIu(6c+QVr#q@Q&!*al{P_I$uDV;dehiAuNAn(<`hS+=N;b>R_4*CR19oBW
zDcPv9{STz{Yk_Sya{}0Q<HwH;gAn6hmu+tor5ki<UM`q^urN%jUa)G<7msbLJ#re9
zlS-2ua+ozsb$#LTt720DsfKraj$q5N%?VxFjw1@V!@GuRn}su1`_K%}!1Zm8d+p6W
zL%d(#1$S%~9$SG#7FK1;RhIMKdN%!0ND&duR4uQV(Kw$q8{*ADsQ|LEvXP2{VNP-Y
zrc!P!sK!7U90)~>cqL`DRSy?>29mv3;^aQ!CF5OGZRAsh2&^2Q+_6^E(#Ir^qGb2)
zUjintI0F^()_dN_`Q!B3Q&XM^*ra+~ABCbESt@XQ>n%}{IPvTp!G`5;WjONA#I!wS
zxUH}X(cC#-QH}>m#(N6{33S}4=dq8kiOCVPa;zJ`qQ!cjWo3hZ%08Bwe?o2|wh~sr
zx+YeTe0dIkLfQ*9w5A==B`S(UhW{Y!aw4~-j+mw;hlbtg57jY^p|i8EB%)bM>K*1g
z4^HZrEXI^L{8)tbT9&wAkv4I|9JN=MA@BE=EA^Jcr!w++*-P1}B9VZhuAxy1UW@_!
zI?`p8Vh_FFxdRr~;Ne{&obj-~;pYse_tlR?FqA18`s)e_nGv(q(#FLA8<gVscM{l2
z6Syuce?sgRwk;>tavw6-uHWbNdF?4+juWJeTh&nKpN^Yn@>Jf<oi~7mH>(9s=fTDZ
z6vl;&<q>Ze-|UhrG5m4s0IFhPKBYK|orMmpRY=5<m%EMjt)ld%=<rX&igX?mJ#Mw6
z-ZCDDd~~dl9*XK3V;QS>YUsKU%igmt53YQ!nTf3$u2acmQ<f+xFOyAM#Yf!7t=7x+
z0RCT=rtg{ima&#mt5VUGB^X_T0l1m{H+(CL!zuf}9}&Z-oLz$^4CV2^-nmhu$~bd*
zsYjNX=v|m$ZgxxyMilHgDH#V^4Ev1}7{~mcH?PHUva(oMD1FHL3=>;5<L+CxuiqjD
zVbjL3gOm9~_kJG~|NJNB^M*g$^~<j9JPM6@QAgphvapZtgv<7j`iQEv9so4^U)&-~
zKUYczIIO<*s2Gv(mJiqu6DVix8Vs>(vMVHa0Kn*%^!s<eV0T;cmDs@eXZB0<zS%ME
zJno4V_gb5I=La8xMQK1nDneRtH^2K+zx-W8)k%NzeVhxovs>jV6b`(eD@UoxIDZ&*
z44?7fhz-}wk*u_G(k4s%X`iaqcxj)0a01mqy>0A3T=6w3lE3V0n@h+Jy%<x4hVhP_
zcM1iM<hN(wsy63CM^fIS^HhF$8<zKJyMI?-k0uR^91>-WnoZRNeg*?5&nd6)P$XB>
zoU^O`!K{%?1cRN$NJ9)mo|72*%L_Sa6dX1nY5zy}(?ZjQGfUcL?BcIo%~=ZDZqxn9
zx-`TCH=3+%(j}9x?L9PVl%}tHY*Z>cfa5bsI_dT_*84xrb3e^Vq4NCOx;FmBnertA
z#o&}L=>_&y+a4CXJz|o_JApXI^Zv7xk#_0SkB*bxnE|$6@(hpV|MfYW1_c8}{!DQb
zBa|x0M6#t>2-e6h@-Zm&hDdm2^f~~<C$9XxXV0VdgtlwctBe~_imH7)i7gy-Y@k6S
z?}AME5ni^5Z1AN+2nXjBk49(KF7=-s4KA%k7p=u*fDYwX7=3Tnq(aF~z{fjCD1#lU
z&7eVbh!Gczc6H*Q&*#vR>CLGH;}>&T06&c0LX|>87?ZM@XxWEg+NicyLhM#4*@BL&
zL!rG}hP~$B%St8Oaa`*;J$qu^__0QXN!SB`{W;a#`kP3-?(3)#(}JR?QRS;m$!oj5
zi9~2*0g)oV{pAwGeWIFh-}Z*9uJbpMAOCU<d55g+ki^z<OK9V^=pR??vDmFwUU6n~
z`pHVdSGnKQ59jVr&;}w@HC;m+@nh?KDo;2yzf|QRUHa1|5+#EVACoM>N)9Vs36hmn
z!UrMDd`sy4H?q62ZNcG{%uTsC>GB(Q+`|EwfOM!OV)_N9=SJrsy6Hpah2YFOf1gD~
zzHxXoNhv~xk;o7r8ZT<!xOT`>U-yz~IE5^3Huc$Xl}vopH6ruaem=-VypJ8qHdYRH
zDomDWn|izPFth{{Hi#dzUR~qOziW#wx4V^LI^iI4_Wd8j`g@bh<&FCh0EN!rjOQ7Y
z>DH>j&8A}G<hq7F=3y7TsgL)cDSoQFVIiBGW48G8WPWnCjViOv<t*J%o?v}ErjH5C
z;;2+nu>i}1oRBid(|xpdzdYJQniXVuk);PLBphxC=`zB>|IEv_zlE{?PaILwlT1(t
zK+wqtcw50*CdN~uthEq)^DUzG^YR)k;{gt&pwOH|fI9q$N`DCNg!<;luDiAwuX|N=
z=L_nFWS^5j+SutXTH1@ajb}U0pHI)c@c7e@F|iDZdwTlW;KCRH8(pa>>gq`mk)tWt
z;#~xeZ5X?kk%b#ES3sI}+NVpynRaVuX7sa5HuslyW~Lq6HJoEExCoBz)w&dipuHbk
zZlP`)6YU6;)TWHD2i*7B185~s)zk`;yBf)J&U3%@&h@}$+&Ce}K;>7Mu%ugOi!Z^|
z!172-{TTxY9!lII%aK4W6CYrlh}FiN=N)&^8GQw2qg7xoNTw#m23US$it@tNrIbz_
z`d&EBa{)H5g$t|9>3)|ZPd`?87uoq-u&+<h&o4;B;of;>CFj&^zT5epnzbg|KnII9
zGr|Bn_|t0UjQ)We+((M2fM!7-Pv0hA6C8*eoQZyY!14&W+q1t0P7xm9vo`1AK5F~7
z4xd-cq^#L&%HLJH(o;0KMR4%I%nv+?^+bDonmHjJbXpGeMm$3eHdu(GjQeV*yZWB)
z^w}aUYibMjH$ThlvHe_>g<Joc@9{~;QXwljTIn2_=PW25Eey@E(5>J!#lB<z+%ei*
z#AQ7Vv~_vPaS7-fY*}NcWrIGtw7Fh6B!!y5d{)k02SHk9Ys^$KX6l>}Pe{qLoSNiK
z-ueq-Qo|rF%vBQ)<@p;h^ud9jneAUd`&edCHA!0EM52P8FTb(#FR^i^1!lOuw}0m8
ztHIdy02A^7iPS?u&mUceT2XvhyzCc&Au~NYH6yZ6Z}aeUg~(J(4kE|Wo2TM^TFPNw
zGDlQuJ6CtFGa@N^qDe&K1tjFv-AyJU#rSq!89#T*mc+D>e5B4(@|?6Xja}5Ts;N`w
zJ^AIw3o0}g_BXBlWLX=Ewy{*as?{|#P*3kL6kq_0qL>s4q>$!B>+}pu@(C(?KcZGT
zNQ0|BSvkPvLC}*x+@(Xml8!^aEQAIl(ewZe>g(u6OY8L+uX2N&S%F`%f?mw9c#4aG
z210Mr?7~nZMe$QVq<v(VtluPZ_4h%iP&V>m#j$6t^CQWCcXO%AD$Pk^|L`W%(b9`a
zSD+XlO|)@N@P|h2t<=VNrvu?0ogbix30-_9@u*^viQhZ=UX@;wIH_ExSZ}FY>w;`_
zcCCk#flk7523Kkx4hk{|kD*{p;`76*nnYUe{r#!Cv!jy>G>bEfvoP3Q;vEkR-mbWm
z?-`iD4iL-&uQ$pvThbx(28se_6ziLa#>Pf#pte1jW!7)6ayS`3Gc50A+F|$tX-?8{
z=2qUqu;4acPm;qtbt#FsBbKk)Il<Nq*<fvlfJyVcPa-@{O{*=_Z@#y91B2~2eBs5z
zm<IjcNkA%Wi^-C|{OWJ>kKBq6;@sA;p4t3dS54;1k=E<4lHOgDlF#I`+^!EFscFY-
zPD@g&l2Rq!d^qf4y`z&h*Y#R}CzPM>u0g$3GYhj-82o}WIv{<?grPFrSQCgun7KIa
z!BTaJl72bXLY)*>Fo>k(nZ}a5Xw38X%mSj7Rq>fKC9sbl%+$DVtAa&gUS#&g+X|&y
z`i*7t=Csh103nX2OCzc{l>ON3lB|H>I`iAH<sYHu;j!f{u$dDs#}5@8DGFqaUW=%*
zTO8Q*N^W$2j;_Kx$$N!W$YQd?`YNl0<7SawUz+1g8(}{v_7Iw-Z(M0bna?g{lpJWW
zH)TFX`-Y*r+L3#G-mW91C!1m!^Br*v<!nD4Z-#0qDdnWdz1#B@Zji@qB+}}#Ynaq)
zP<?9aE<2--o^6Ow?FRlj>Qy1R%}3-XjpmTIO1LC>Du78Hl#5t<h%XBFL2~IFa7;W9
z9f&6t_CZh&(eFM8(o3V@=DX|;TX3#Pzi)d-0Hi-aM9XjCKqnE1NrZ(uN4zg|rU;#H
z<m$E0MoqjMVmE#I1pA!y#Fi4hJxn41rDCBC2@28g{j&@I-j)9wpWo#+Jp;)!O4T5$
zqW1;Ns9*Mun2}8;KKmwOLB`dQ#cSnh$%7{ESQL(<WNjKl;<XCAg#$1P+XJ9oAz%LX
z@BP*-z=2S&<ejf$Ncf95yaM;I4(Xz@HanY_USDh^_qkzB){ov*vy8m=qsVcKxo+k!
z{e1l{6|H<k_v<($pB7(PORKy+YPhLqoZ%-oP-LclJW_rkJg?{co#c<YXspWJc<+gj
z^6?<)P%bjCEH~DtBr8!H!1BP45@m^&xXbdB4j@=hs`)_-DE;bk$?2XM02H7>dy@18
zCL`U~deBI%Te3xBo|kU%E?Ex?NlRbPpfUt+hZj)XbE*9^+t+d{jz<q^7~REe7^?Rx
z4*#70AS>-fyq_B)OdI75#IP%-Q&`%7Y%XT&b51)X$d<(72bcE_dM}G}dciLNsNA%C
z#a8hJT@cNAU>pJXHNoMQu24nchEZO~u6+KjS`XG4N3Sxa1GR+go*kpPKH4?0xZ$H+
zfv~Q^n1Y|9T+Q4g@@ghFT%VVlQg^;Yz;>?nR=+k;LtmvN85tQ*QuCbyk<gErs#h^M
zTrA3Uj@YQNzhC4fPtD@;JF*r!E;DiQOIH==+I(J4_@&D$0{4qm_=r^jZ$goOvyFzo
z_V5;q61t(|px~DCV5XtbQCwV9zlEixi7zHe_8N)G={d=jbIIkuK7GTOj!t(bu<B0q
zeDxjN)Fd6|IhtS}D8VlW=D7PS_hmOQz@juO!P}Uas%+^i4l5-`s>ecKKNx<gOcg>N
z*m|`F7e1INi$fyes@`6z-kz9ZD{XhkCn}?0Z}~Id(o_Am?{ZGDrURc$KQwbEYP261
zWM}ppemY%TM&QZ`NQc2q(=wf<aBT-y2d`DHeCJ~A<Bhz?Km<>w=8So+@eg*1shPbq
zE>V)#8G;7-LYVNt>c}&%_WR>%`})H4)egBFESX}(;UA>&i8s`|7?D5pzSjB0)4qeB
z^031u&>7_qRO6EDk^`?wu~Z8A=4c@&^C#MybJZ;jsR+vaNFmlrIW;L*j{2|&`+Q9A
zvrq_{v}Ykr{4FpES9jdwteUz7Y}7sWQ2*gY`Tj&ZbZz23W^;Lr$Mb^xLT70%>3BPb
zR|$mj0;q%dmbg*9`3BE_n@4b>YlMD-Ou*Z{qzdgogF3k7$+vSYw;~3rzKM)pe-&SS
zrw_AJ`c&a8H1pF0VlpbAjZc)=?!2r1O=SK3fqVaFWP`O$>%{22T8S%9&|XV5+MY-x
zU2ny_m*9JPxuE%OOKSjhnD9-+yYNM>b8c3?a{lF00Af<hl<Zs#pp&bRlDk<6R?tf*
zpm$jf7r1S&jz~y{8&*N6I;59iKwa4_R|j8zX`@nVShYfe_gbJ`?LT>T&r9XUjVIG<
zK`6zUC&IO2%r}u!02_3e%ow^4e6%444Mf3;x#%gM#Bf9F24@82unQH%GA?Hd$oW)C
z&hYIl4mQ11(HGFZ73d_@`))UE9m$^yc`Ib4#YYPEuh~|w9HNGs7Wz$h3BAtC49yeK
z_(!h3m7;}fb<do;K6nd$m03*ADbA_rF|hTaM(1ZCJ`!%b7|^H343spUIgdru+vuA1
zw>i8>PH&5Al<UHkapG7!gdQ$tg)6G#<Rupj7ah`}4+QGe^Pi`ZGzmEsaN{ygFCpmg
zYYkcTCP7jxr61fL*!;F190=q5RQ&jyIw}mA_KZziyJ&nAAVp8LJn!Vb?Txr`xIg7%
zP|G6=8{arsePF&2m&`it5Icszk_@$8{aX`h+Ek_P23z_Pr6<v@1y#Dmn95Es`L;r<
zY^8@tS%i6C-qP{rqg=UA2tm)!j>88@yeiCH%vSa!vrm)X2&s6hYxnG}KTUU0cn8q5
zh0Yyt<Y{CSRnrtkl*n9Q9>-017PhEg-3cJncGhHl6Is65{!L`T_DW38@duFAT8}I0
zlJKyeg8*4~N}Y;n4S%SnXRr!pY8jO@=6+<0`e-@HYYo5$?@NzUc36P<zhKyXZlMMm
z?L3dhc$MJT5aJPSOSXcMC=eX`rgrN7LYxbv(b?SD0rJ#BA%Zdbtl2BvPx+gOntmy#
zu^vF(PG@QX%xKQ<Q_LFhciW0JKBnQh*kJY;i5R5ob)XcK&1{8#pWlIZ!*@7HC}{w^
zegIsC@@YR(;1z3O??rdF25+^OgJs<-Mgh6GUK*Wz(O2&<*J&sKVWW0dc0qlUl1&j}
zYzp}4Y9V14no2H0b3$_lUKD~C5f}Si10qHJGDCz`4@uNP?Jq8mTwzHY#lEs~*0`Eq
z&-ZLL*!uN&<`}M=Il;h0tHd#^)wB(A=~g^Ne0*r@z915DVM!j3$)6#Q>LFNjPv^WE
zHs$YZ*dAz^7{)RgFO<sd(~U_73k*CH8;U-<OC9fp^~CBfS=Vv6k&+JwCKM50EfwA{
z4^BLq9C%on%+^_vIq&YW+|+9T)jiLDBM0JDO47I>R75M=5_HI|*R(dy=4G6O%VgYu
z;0wrP#^anRyBSex5o9tpXdP@<!%){+QaVhbRC&vg?6RI;a8npqNk_OR+w1l5T`3(@
zde*?E!hWq7uP2Bk-Rgs>U2my8$MX9qFH)3+Oj|=yn0m(My&Y-*+G_qU^lrzylyTSu
zxsc3UD$y`d(3$f6CQ^bU#%||X6g_TRS6);_5BDpZz$}pg_C2Xigv@23`O1Qoe%%c8
zC%6AI-Tbrvj|SO7YgbI4l>cZq$sD>{3y~3jS?8)3?t2ctP$P<R2g5A`rp}8TtvJxI
zWIfA~sUP2bs79+iMaJaE7N;Q%pMJTJ(f)K9n=80o*hgEalwlVf?n`95OUb<xMGF-Y
zr~Fe#$nzzc9X^{N<dp&Bk;j+TxN`Rp?rBxocaftOE?RqaYMT3_o4wKO3r+z#7mmCD
zQ5u+b!`_!&5tF(<?yRUZ(RkXRS!Mc}Qh>U}4vHVZ*m1D=EVRcofE)7=)J2!@c7bHY
zJFQUz%V&%G1h-1EU(^f<RBoVj&wnH^wBS@bx?y3gEV!kR!m%frP3|_mbU*h?bi}}X
z?n>yMz%J9lO`^4Hh2_AknpFzI)_bAz662jlFF07%dvS9)NCzFu_NlT|oPM6#v11_R
z!F%+n6TY3xEVgtuAvpnuYS#|9jKS$sMUkKAZL4>f60z33u(ca~ulkk;7bY5wmtw+x
zJnueqE<MvBtnmC5MK<q4PO>qROs2+8@4X(wkYya9gVMb@21`m1^YaX^eSMo*dHo*S
zFrqW00fNoV!h&|pQoNYGcUQ{@hEntCQiJo|X5Q*v)yi2JJED@XZ~Ues3uoP)V!!%M
z3&xIBx!UYHFxl!=b-k>EiaXM<YVej4kE)E<v(GGb3G6^{5$n7=suCA!ovejw1MTD|
z<*pSyy~72q>Zo8fR`AEQZbPo)MV5zXpx|~)hSA3nXa3dNJgp0nv1384W^62JX6jZ+
zPENJG*O}+kEYiX|8)<(`zpA;ftRdc)qRd2!qMR#4oQ8^?iYWPn@CjWOoAwvm1K8z2
zOooANT9O(6s|-Cz|9Tu_ZrZMa#*?KiiQ1~Htn%<^%o&tN^2JbpSXVLXvOy)h2#+@l
zsu5Z-i_HL&RV<r)Cc)Cq2BzDw+`yO!$iymVJ6EKCPeu1#kE?BcEp_yruP4FJZYwFy
zc??9E3a)xXoJa()=Co}iYJZ@T3z6tz|8$CMt44OEj#Ks>Cb9?{MC|r%5&2$3WWPyq
zM_QNO#!Pb4GKLvXP+TxlCD^A*Ni9|a3LA6DxIm>lRbKX~=2dpp@IjAUL_us-u%fRg
z^B@BG5hFO#68mbxM~Xhz#aPKiG;7FxXgr;5C>GJBqAa>aZ+Rw{y7!zUc?%sYHlY^x
zs-fIgjTNeIE701&C|g&i?z#jc0FpkrSWoX9?Pwn)sHmXA-t)-dAO$7&JS#g9A|DG6
zf;wm5iUFYC$uBp#K!E|ITb;;ywN!u*C70PRc{<F%w|8xqaZj<`DaxdV0aM564#c6@
z3PLl}UYeVLW{Y@ut~)6GlEhZKuyR1xq;kY^5Y9P#X3M=rFuWF74nc7H-gnuNU0zgl
zy+*>6z2wg~BsllHEp~9d{9%t|+i?>+U&Jpfu;)bGMO(`8shdWu;RUIVvad~raYx#r
zL5CX^d1pRy0tl1MPd_Q-Q*x8ake0^jm-lEvxq*Pxgh2Ru1Ndn;>qIVIM{Nah?9%D_
z)lLw*STbYjhGtAtS2(6Qt5KHrRn4F0S839;De@!0QBco{CQKM_C~sI(P9}Mu0>m&X
zLm0>ST3CpSTU3^Pc4v3V0f5%orGNjea!eXP=n}p6w*cRw(l_!YVK!p!$dAOr0lTTd
zj?>y<5_mXIp;G1^xMry>D^V_Eb}p=-rM<W}OzE4*#5a*4>*UA(PR*y8GS_&b(Zx$G
zz^U0@E_n2L9=?ZToGz$xa#E=XLhxr|`sU|JVi^bWyu4&sgfM(Pz$k^b&eU9LTXwmt
z4}f6$rKF0Af{>_JF;HtDID-@r;^ir3$@&nFi_WrwB;fG43A{tUAIk_dPlUs1dVWX8
zhryN;NQ0m@40+Z!*eaT9y4neI^DJBmFLqEgL9A}}S5jh%V<~iI^IIA*_=xTTV0Qgy
zSAc)Z|J|<zJq%pf<Y`$Z<Gq~%Ft0`|mvIupr)3M8GAlXf3RZQ#=Ed%MeAC`WSIZ=x
z1*)-?Tx}HZ7$q<=XE@2JLT<3=&;hF&u|VB;`;1}5iz!E2ijTSOqpBquHvbakLCwvq
z28sK5;^?NG`|M&0f%pfIG{?`5V7r-fM@07CA20F4#h%qyb7q85(*`XaYCgMQM=(5$
zf-<k$_$Km1>&ryf%1uQOCjFa8w|4M424Iq(xhSE`vf)@R+Z7UAB0)AF30JJV)i_lA
zre4!YJRLBt#XDQNF#+3}Y<LWO^KWguXJcsgL|$=Xzy3@s(_h_sBA*F2L9aWqzG@V~
z{BAi)cv=Y~PkB&QBx&9plqEC{-m!i{;SvECR@7CAUS;T0E?x|TfGCrcizqN0L@y61
z@#^CRWJOE40#YfCkQytkxxAotVGI+F$HGO$R(^)772L7!4v(JjZ<zHIR1P^)?voPk
zyM`T3K3YC_?08K2JGLB2rlTtR$ko4)Eq?EAF+A{c-`7@I{q;iEWQj_+XcAZ(-$HGR
zNzkX1G}BE*NH0oWRCYJodlfyPrMUo`Zh51lfRQH2-%=Rmy?#X3kDNRO+aW;Npkn(~
zFu9<EzKTr@Wm%SsIg!Df8`;QzL6QjDWop%y_qnBcT!09=kp5ccM#{1?F}(znGCqlP
z=4fM>_JchA0idUSSJa^7TA)>JGd}9<Lo^5~@GYrLzCF+q8eI@8*<hjU(?OMEeOB*#
ztAE2iYt}@ZHIr{)uePLM&n9;*u#R=nd}_U?-!_6fod<EaqA((eTAJh$Gl}4;D3teE
zuCX?+_pQ})<<_6=rBLLFRW5>;mGEE%JuX09haFti%8vi5<H*4XJY$cL3lr{ceB)cw
zl3{8Vq^1eC&<Xg0JYl+gT4OHSR;K1>7US4F=<7{ek6h$vcvWQj>XhNrtS>VeUr#f<
zCot-ab}X(Ho6mfsGGQFtMN5WNOh!FiyyETZmqD32(?Ua@YX5h$!XN$gzw_mQed~$b
z60%9AE)>R|Y>>Y@bSfi0^C*sj5ByY2jG<6p%h|Q}1Jv?b_YPQ|xtQRc>Kq{x{RPIF
zKI4--q65G5W6_6HfOBV7E(ZogfIaHrPZ|w<s!p@7%84M=@S%e}D+_`AZz5YsPWy<3
zS@UEG1J;F;^nue~NQ*^@cFNM6&&=Xc+=Yy1awJ#tO(ov(+Myznpi!eLgH%M0T%Bd!
zaK`skwsx8;>-W(WppGH+eK|aa>|Jn+Aa<cBC%2-z^@gJf2&O5pGTC2bKo|VY8$#oG
z6L}|It|Zy|m^qf}8lV~W`Sl&*tgK>FOmE>@2N%*m!W7!Ce$?an%vBZ(lcCW$-?5R(
ziqi_Uv_!*{6(3EyPSkey-k!ZnA<VJ9mbmsw`jayM;*ZHFVU>3kV13fbpcKaRLIHI*
z0H=A~qCl+^OFHKE=2YR)DbG^A(5O)=YF1uTK$Lgf)MY+fPk0-=NfE*wH7>64y?^rS
z$w?oaCd;r|US4D8$aKs{PK2jJ+Q&xiaS4LD^KH3ioBd8d&U#r^JkP;dF~&?zXn<X@
zL&TbnsjxJHQ$yCuVdRunM(&5tuS$m&CBtq6jSdP4<&~)I7K9wAd85aF%YAN_^E=9*
zt3|)s!Kj3O-P#`uX`+ah`QCvszl@13LtMU$gGXfD^-pK3<a^_ZRSMlJF!}unQKTod
z(JTWcfLR1K#h0G{u1o~0YPA<Dt|735+uB+!Co^ivO*1&M7B6-Nu<R&lfD8M;T3B?i
z-VL|!fDYL0h6JB=Ub+FjRJJ0qhg?iV=oKauL?Gr0jMD40=4=2w`%M@(r_IG$O>+eo
z``W~x)oVKO*<hc_&;BKjy?t^S)WthOn<gfccS@DjVxmh)zKB*ndJG2J=}`)h;Q;FA
z4Wj5zEh6`Thwa$C8DJulI2vXf;T38-?MgwTkA``fZWZH%{bJf?5E)jx_t%-iN6)BL
z+6!T>eSD|N+xlhQcC;;~+OpqAJR!8Buh%~_ADk(pv=0dyI#nerEXe89!6s~}Y|30I
zYth{;hju9kr9X3p{@~IF);+F`4DFd)lS)x;wu!rG;ixLeDHJ}^?`OH6>-HIxNO**=
zDiO2GxYT&-l7MUfx##+oE$5rxL<E-ayIaLYFNch~+-=~54X@~7fek!`vM#zS>F_&(
zRKOhj&1f}Wt%8t&(ZU)zQzB$qW(n3uD7ZbT?Q%NKS)5R2_@z_i@{7v(yydM6z2P^I
z3wx!<eqbv^P--OZe^qX5SfzCUl$3!r)Hd>VFCQenln;uYT}`xA##Bl9N=sOj4Nurx
z`j+3cLaGM9SDQgDguR9RWi_Io#y|R{Jd1Rhy6En-dMn!XX~aTB$20Xq{^gDo@}h|t
zNupAi4tDj0Kr;Hn_$1M~Y;w7_E=N&EzFe38MC8_U5s|l5=;F0jFIe`h=^)Oyq7R^f
zpm=i@l>M>`9)f^F6b`@HDstUgk(L+X01ly|(;vQQcj|={_9HE8K({jCkaAzSrxSYm
zMMRVOn3x#v{i-<ii4HYn5f@J@M_P0;qDbLBv7fU6l^2!*Smzq@Zv&10{j_trecv%k
zPMESsMRFQt&ymv~ki5t}Ql;s&O}O;A@kw80zhfT`+`z6J>0Tep&+2+?DJzG>4$VkD
z`6f~}{j>8JG0M^je@S|ZTiIvWr&~H*)9!|u8}4#6Tp!t3&y=%^-Dai#WQRBXaxlj(
z8>_ZzqL6^s7OZeIP(~+atYr-ctJb?CeGWgv?c>iLE<v>T_}Qz0IzHO|w(#aKFaPr$
zT{*1nknoFiA<en`qaX28(a^I-Fb%_OheBZ_5QMZFdQwhp8C)@^+m7#r%E&6K+{U1%
z-bh(Sh3w7Fu8#vOEno0@W=E7Re-jDuliCtX8!VEfmBwm+WT7mZ`nC%K*RI!nk-cvn
zKBIgx_kl5mJQjV_nqeeQ&}ZWH_;!@)rkIQwiaug8wb%ry8X7*}*j`$qZA~7`0uQDt
zg8~=)e8$X^j@#}E*f3NswM|kt`96nx&HV72tNq!+1b^eHizp?nR=JE`tDLkxos3^1
z3rpJ)=T%d9$8|tfx*OtMEh`UL^jLPWsa@pK{h@Ye`41n>BTFzU@W8oVI}0t{e%u=O
zh`NW4K#Y78P%%=tE_yig6}r&8FY=ZCB{V&+w8p8RH^ae0Ed7B>jm}72tYiWbxut(;
z<37?K`s;y4EM}x5&c^ovdaq%B<JTMun;<iP!Ck6^7fCSU_sb8i9&@Zcg&4(Z2X7zt
zFed$tt|u|q3#-kSjn+gOW<x)NLC8S95a6d3ikt+djQ_Rc#NHWY6A}o@uH9`8LyCP!
zQ_2^FdqWMtQ5FEc%bnfSA6hWaY4(>}+(<r}H>sZ}llI;7`W!u@!TImo_=DW^w!#U3
zu3G-q9jN01?=tNA6Nxk=DL&L>e>|}ZwzCiyt7<`qFBqoNI-PQo0=W7+Y$HsH$7E<V
zwM#eL2x%8)F|t@pVu<K`xJG4$YA6eQzp1c+)?IM8GRR^v?%zClAbozh4s$EcX3Q)6
zLw7gt1$6P>3}u#9g)w%&+qT5(IQ{@=0JDW^tCOEI#gEwC@tu&|$_^@aE_mnGu=GvD
zSKH2bxs@*y6q<Tx+a@02v*<&_15lt-AE7+g8xlKvjyIVcMBNDN2vZVMrN8Ed(EynK
z1BU|Sa{O$*R{NkzAI|hIDP1|(+C~ZdN!#w$IY>y$$iN%&MiAJQdOhst*}MBK82QFA
za{+yO!>FfZWEZYfj+2^-eU8k;^SlF)NPAAGcig8Hsy?043RRn_UGuB9Q>+^HUJ*jG
zYFYLb69_Z6{B}M4f?pdb6zco$ys1X=KxjYE=Ib0zH*Z?8ghs|?rKM@ZG`njgn+5=Z
z$hSm8R#ur(c$ljh2T!&BM9eVF&nYerOZp~~yfsSD{b~mb=S6+E`_!XIhU-hFwFqxs
z-XrXAvV1KEVpw+R#|=7%s<#l3{)v@<8$`YzWE~D`zWp~r@&C(X_wlq+mhHT@(&yEg
z*$Lm4*io|{CBO4g{evG8w$hJ9?-o;i0@-cklqo8upoc=kl3WDm_4{<|ikmexDg!^u
z7cD#ioHzekVz71w<;|_+i?$C#gX{z!qX|dYm{i-^mdUqoQB-)iIuF34&K6sN5BY|S
zl52a`6n0&T&&uL8B%lmAd<Fti#q7Y$72_#I*rd4FnRu&Pqo1LJ-u(wB2+FutPO~eq
zSkIp<V@Ge8(y5;xA80TCtk{&%6#cdO<X<JPzn18K@B8ljFV`HVPnWRdAJrYH)wY!H
zuxf-$b?LZXBIqHpC+dd*^qMfasC^X|P@W>K4I1eVsH-#VU5TeZM0pftXNoe#{jz0?
zEa;$MK#Bw~+55rhNov|;WzbIDNF4(kU&0p?T_{_yKO&E`Owezkds7F82~d|JzFi?#
zavVdctkTKY%r{5{K&WkQWmnhtBK><oGMzUkMpC7A)-I)9MrLX+DBa6`D@va^z+F%!
zbbrm)mYpNA!`u&V*J9q8e-lyapvrf88#Zw7ZU&@j7u046F80DC*Q?TYeF)sX{0UZV
zd{*uL370y10m^M)F_c+^s|<Qx8JORYS?&`7lS9Yg?bodNTW-R4YXSq4U#<drj*gHI
zc@K=!Qd7mxopY2=@C6rP6lW-aoEN)Dq`RjKrt<xszkO!&OJwu@_(H?kTwwd(s<lV7
z*t$QWCq#1lh!F2vDS6*>Pa#<DN0P0K85HK7I$P=?yghR)bE6y5l>k7(q#x^^Jo@Cv
zxXYHe@gQwzguhYy*wmd@yrjy!?ffnu*V>j(nc?ia*Szu5Z{vfsWp3~m8xJe%@+jWb
zs?d*N@W_DFq?w>!k1|{D5JRf+{R4F6E}1k;E*JvKKOOvulCF{#SNW?~Su^ZXib<Y(
z5Fdk%&nkA-SK6ygF_6-B=$AsG+=Ns>pXN(VPN<>rVeTvo^zHRcsPz5^m$mQeJS^6O
z^-nl>2YfMo{_n=e|6XtWk9WR|M3iyL7XP0G0gtV;5!&AR@x+zln0czM&w_<Ci@H^O
zyDkQ@UYj}Rq<`@|w=-9s`DIOU-+7{A9{a{~p`mwQ%+B4wkg(l;*LSA_Z;ek*1fJt@
z&hzbR;EBPj|CJvFE|d%ScY4+n<6|%0R<M?o%3qCMT52Mo|LZ>U^D6!BjO%~fGBmF5
z>w8+}aes2y(V(7?qQJ|?HeOmhvD~#dH1v{I#hpFYTi3an1{WtVG6ss8h1?bS<H};7
cw2dQD3U~v+u|;|N-`FQ$dTF?c@c+LF0OX@De*gdg

diff --git a/0.10.0/architecture/docs/design/images/multi-cluster-layout.jpg b/0.10.0/architecture/docs/design/images/multi-cluster-layout.jpg
deleted file mode 100644
index 042a33fb9c7c8311a1c610320a7ef7b9301ef7f9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 399046
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
Z{0DLmsP3*&14lz(Gz5lJ2-yF>2>=s$0yh8v

diff --git a/0.10.0/architecture/docs/design/images/observability.png b/0.10.0/architecture/docs/design/images/observability.png
deleted file mode 100644
index bd2156d72daf1005df66087aa50afa7f66cc7d92..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 53788
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

diff --git a/0.10.0/architecture/docs/design/images/ocm-integration.png b/0.10.0/architecture/docs/design/images/ocm-integration.png
deleted file mode 100644
index 8267cb8256f9812348b9a6055d7e3ea42c6aec79..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 114401
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

diff --git a/0.10.0/architecture/docs/design/images/request-flow.png b/0.10.0/architecture/docs/design/images/request-flow.png
deleted file mode 100644
index b70e3c3eed99083818d84c6a283096bdc53cb132..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 374884
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
KT=>mj_x=+T?StX~

diff --git a/0.10.0/architecture/docs/design/images/single-cluster-layout.jpg b/0.10.0/architecture/docs/design/images/single-cluster-layout.jpg
deleted file mode 100644
index b24badf3b794a01f2e11378c3900e333b4f0c024..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 376787
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%0DGAU4Zd!QN<bj7Nj~meN>xObw%)8~~Zq7Zk%^UI*
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

diff --git a/0.10.0/architecture/docs/design/modular_installation/index.html b/0.10.0/architecture/docs/design/modular_installation/index.html
deleted file mode 100644
index 43acce147..000000000
--- a/0.10.0/architecture/docs/design/modular_installation/index.html
+++ /dev/null
@@ -1,3456 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/docs/design/modular_installation/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Kuadrant Proposal - Modular Installation - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-proposal-modular-installation" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Kuadrant Proposal - Modular Installation
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#problem-statement" class="md-nav__link">
-    <span class="md-ellipsis">
-      Problem Statement
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#high-level-goals" class="md-nav__link">
-    <span class="md-ellipsis">
-      High Level Goals
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#proposed-solution" class="md-nav__link">
-    <span class="md-ellipsis">
-      Proposed Solution
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/docs/design/modular_installation.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrant-proposal-modular-installation">Kuadrant Proposal - Modular Installation<a class="headerlink" href="#kuadrant-proposal-modular-installation" title="Permanent link">&para;</a></h1>
-<p>Kuadrant is developing a set of loosely coupled functionalities built directly on top of Kubernetes.
-Kuadrant aims to allow customers to just install, use and understand those functionalities they need.</p>
-<h2 id="problem-statement">Problem Statement<a class="headerlink" href="#problem-statement" title="Permanent link">&para;</a></h2>
-<p>Currently, the installation tool of kuadrant, the <a href="https://github.com/Kuadrant/kuadrantctl">kuadrantctl CLI</a>,
-installs all or nothing. Installing more than the customer needs adds unneeded complexity and operational effort.
-For example, if a customer is looking for rate limiting and not interested in authentication functionality,
-then the customer should be able to just install and run that part of Kuadrant.</p>
-<h2 id="high-level-goals">High Level Goals<a class="headerlink" href="#high-level-goals" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Install only required components. Operate only required components.</li>
-</ul>
-<p>Reduce system complexity and operational effort to the minimum required.
-Components in this context make reference to deployments and running instances.</p>
-<ul>
-<li>Expose only the activated functionalities</li>
-</ul>
-<p>A user of a partial Kuadrant install should not be confronted with data in custom resources that
-has no meaning or is not accessible in their partial Kuadrant install. The design of the kuadrant
-API should have this goal into account.</p>
-<h2 id="proposed-solution">Proposed Solution<a class="headerlink" href="#proposed-solution" title="Permanent link">&para;</a></h2>
-<p>The kuadrant installation mechanism should offer modular installation to enable/disable loosely coupled pieces of kuadrant.
-Modular installation options should be feature oriented rather than deployment component oriented.
-Then, it is up to the installation tool to decide what components need to be deployed and how to
-configure it.</p>
-<p>Each feature, or part of it, is eligible to be included or excluded when installing kuadrant.</p>
-<p>Some profiles can be defined to group set of commonly required features. Naming the profiles
-allows the customer to easily express wanted installation configuration. Furthermore, profiles
-not only can be used to group a set of features, profiles can be used to define deployment options.</p>
-<table>
-<thead>
-<tr>
-<th>Name</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><strong>Minimal</strong></td>
-<td>Minimal installation required to run an API without any protection, analytics or API management. Default deployment option</td>
-</tr>
-<tr>
-<td><strong>AuthZ</strong></td>
-<td>Authentication and authorization mechanisms activated</td>
-</tr>
-<tr>
-<td><strong>RateLimit</strong></td>
-<td>Basic rate limit (only pre-auth rate limit) features</td>
-</tr>
-<tr>
-<td><strong>Full</strong></td>
-<td>Full featured kuadrant installation</td>
-</tr>
-</tbody>
-</table>
-<p>A kuadrant operator, together with a design of a kuadrant CRD is desired.
-Not only for kuadrant installation, but also for lifecycle management.
-Additionally, the <a href="https://github.com/Kuadrant/kuadrantctl">kuadrantctl</a> CLI tool can also
-be useful to either deploy kuadrant components and manifests or just deploy the kuadrant operator.</p>
-<p>The kuadrant control plane should be aware of the installed profile via env vars or command line params
-in the control plane running components. With that information, the control plane can decide to
-enable or disable CRD watching, label and annotation monitoring and ultimately reject any configuration
-object that relies on disabled functionality. The least a customer can expect from kuadrant is to be
-consistent and reject any functionality request that cannot provide.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0001-rlp-v2/index.html b/0.10.0/architecture/rfcs/0001-rlp-v2/index.html
deleted file mode 100644
index 31ad370e0..000000000
--- a/0.10.0/architecture/rfcs/0001-rlp-v2/index.html
+++ /dev/null
@@ -1,5274 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0001-rlp-v2/">
-      
-      
-        <link rel="prev" href="../../../api-quickstart/">
-      
-      
-        <link rel="next" href="../0002-well-known-attributes/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0001: RateLimitPolicy API "v2" - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#ratelimitpolicy-api-v2" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0001: RateLimitPolicy API "v2"
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#summary" class="md-nav__link">
-    <span class="md-ellipsis">
-      Summary
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Summary">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#motivation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Motivation
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#goals" class="md-nav__link">
-    <span class="md-ellipsis">
-      Goals
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#current-wip-to-consider" class="md-nav__link">
-    <span class="md-ellipsis">
-      Current WIP to consider
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#highlights" class="md-nav__link">
-    <span class="md-ellipsis">
-      Highlights
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#guide-level-explanation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Guide-level explanation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Guide-level explanation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#examples-of-rlps-based-on-the-new-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples of RLPs based on the new API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Examples of RLPs based on the new API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#example-1-minimal-example-network-resource-targeted-entirely-without-filtering-unconditional-and-unqualified-rate-limiting" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 1. Minimal example - network resource targeted entirely without filtering, unconditional and unqualified rate limiting
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-2-targeting-specific-route-rules-with-counter-qualifiers-multiple-rates-per-limit-definition-and-soft-conditions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 2. Targeting specific route rules, with counter qualifiers, multiple rates per limit definition and "soft" conditions
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-3-targeting-a-subset-of-an-httprouterule-httproutematch-missing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 3. Targeting a subset of an HTTPRouteRule - HTTPRouteMatch missing
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-4-targeting-a-subset-of-an-httprouterule-httproutematch-found" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 4. Targeting a subset of an HTTPRouteRule - HTTPRouteMatch found
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-5-one-limit-triggered-by-multiple-httprouterules" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 5. One limit triggered by multiple HTTPRouteRules
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-6-multiple-limit-definitions-targeting-the-same-httprouterule" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 6. Multiple limit definitions targeting the same HTTPRouteRule
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-7-limits-triggered-for-specific-hostnames" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 7. Limits triggered for specific hostnames
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-8-targeting-the-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 8. Targeting the Gateway
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#comparison-to-current-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Comparison to current RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#reference-level-explanation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reference-level explanation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Reference-level explanation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#well-known-selectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Well-known selectors
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#mechanics-of-generating-rl-descriptor-actions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Mechanics of generating RL descriptor actions
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#artificial-limitador-condition-for-routeselectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Artificial Limitador condition for routeSelectors
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#support-in-wasm-shim-and-envoy-rl-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Support in wasm shim and Envoy RL API
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#drawbacks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Drawbacks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#rationale-and-alternatives" class="md-nav__link">
-    <span class="md-ellipsis">
-      Rationale and alternatives
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Rationale and alternatives">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#targeting-full-httprouterules" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting full HTTPRouteRules
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#all-limit-definitions-apply-vs-limit-shadowing" class="md-nav__link">
-    <span class="md-ellipsis">
-      All limit definitions apply vs. Limit "shadowing"
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#writing-soft-when-conditions-based-on-attributes-of-the-http-request" class="md-nav__link">
-    <span class="md-ellipsis">
-      Writing "soft" when conditions based on attributes of the HTTP request
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#possible-variations-for-the-selectors-conditions-and-counter-qualifiers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Possible variations for the selectors (conditions and counter qualifiers)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#prior-art" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prior art
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#unresolved-questions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Unresolved questions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#future-possibilities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Future possibilities
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#summary" class="md-nav__link">
-    <span class="md-ellipsis">
-      Summary
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Summary">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#motivation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Motivation
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#goals" class="md-nav__link">
-    <span class="md-ellipsis">
-      Goals
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#current-wip-to-consider" class="md-nav__link">
-    <span class="md-ellipsis">
-      Current WIP to consider
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#highlights" class="md-nav__link">
-    <span class="md-ellipsis">
-      Highlights
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#guide-level-explanation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Guide-level explanation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Guide-level explanation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#examples-of-rlps-based-on-the-new-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples of RLPs based on the new API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Examples of RLPs based on the new API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#example-1-minimal-example-network-resource-targeted-entirely-without-filtering-unconditional-and-unqualified-rate-limiting" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 1. Minimal example - network resource targeted entirely without filtering, unconditional and unqualified rate limiting
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-2-targeting-specific-route-rules-with-counter-qualifiers-multiple-rates-per-limit-definition-and-soft-conditions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 2. Targeting specific route rules, with counter qualifiers, multiple rates per limit definition and "soft" conditions
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-3-targeting-a-subset-of-an-httprouterule-httproutematch-missing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 3. Targeting a subset of an HTTPRouteRule - HTTPRouteMatch missing
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-4-targeting-a-subset-of-an-httprouterule-httproutematch-found" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 4. Targeting a subset of an HTTPRouteRule - HTTPRouteMatch found
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-5-one-limit-triggered-by-multiple-httprouterules" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 5. One limit triggered by multiple HTTPRouteRules
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-6-multiple-limit-definitions-targeting-the-same-httprouterule" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 6. Multiple limit definitions targeting the same HTTPRouteRule
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-7-limits-triggered-for-specific-hostnames" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 7. Limits triggered for specific hostnames
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example-8-targeting-the-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example 8. Targeting the Gateway
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#comparison-to-current-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Comparison to current RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#reference-level-explanation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reference-level explanation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Reference-level explanation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#well-known-selectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Well-known selectors
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#mechanics-of-generating-rl-descriptor-actions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Mechanics of generating RL descriptor actions
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#artificial-limitador-condition-for-routeselectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Artificial Limitador condition for routeSelectors
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#support-in-wasm-shim-and-envoy-rl-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Support in wasm shim and Envoy RL API
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#drawbacks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Drawbacks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#rationale-and-alternatives" class="md-nav__link">
-    <span class="md-ellipsis">
-      Rationale and alternatives
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Rationale and alternatives">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#targeting-full-httprouterules" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting full HTTPRouteRules
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#all-limit-definitions-apply-vs-limit-shadowing" class="md-nav__link">
-    <span class="md-ellipsis">
-      All limit definitions apply vs. Limit "shadowing"
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#writing-soft-when-conditions-based-on-attributes-of-the-http-request" class="md-nav__link">
-    <span class="md-ellipsis">
-      Writing "soft" when conditions based on attributes of the HTTP request
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#possible-variations-for-the-selectors-conditions-and-counter-qualifiers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Possible variations for the selectors (conditions and counter qualifiers)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#prior-art" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prior art
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#unresolved-questions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Unresolved questions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#future-possibilities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Future possibilities
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0001-rlp-v2.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="ratelimitpolicy-api-v2">RateLimitPolicy API v2<a class="headerlink" href="#ratelimitpolicy-api-v2" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>rlp-v2</code></li>
-<li>Start Date: 2023-02-02</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/12">Kuadrant/architecture#12</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/architecture/issues/13">Kuadrant/architecture#13</a></li>
-</ul>
-<h2 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h2>
-<p>Proposal of new API for the Kuadrant's <code>RateLimitPolicy</code> (RLP) CRD, for improved UX.</p>
-<h3 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h3>
-<p>The <a href="https://pkg.go.dev/github.com/kuadrant/kuadrant-operator@v0.2.1/api/v1beta1#RateLimitPolicy"><code>RateLimitPolicy</code></a> API (v1beta1), particularly its <a href="https://pkg.go.dev/github.com/kuadrant/kuadrant-operator@v0.2.1/api/v1beta1#RateLimit"><code>RateLimit</code></a> type used in <code>ratelimitpolicy.spec.rateLimits</code>, designed in part to fit the underlying implementation based on the Envoy <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter">Rate limit</a> filter, has been proven to be complex, as well as somewhat limiting for the extension of the API for other platforms and/or for supporting use cases of not contemplated in the original design.</p>
-<p>Users of the <code>RateLimitPolicy</code> will immediately recognize elements of Envoy's Rate limit API in the definitions of the <code>RateLimit</code> type, with almost 1:1 correspondence between the <a href="https://pkg.go.dev/github.com/kuadrant/kuadrant-operator@v0.2.1/api/v1beta1#Configuration"><code>Configuration</code></a> type and its <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/route/v3/route_components.proto#envoy-v3-api-msg-config-route-v3-ratelimit">counterpart in the Envoy configuration</a>. Although compatibility between those continue to be desired, leaking such implementation details to the level of the API can be avoided to provide a better abstraction for activators ("matchers") and payload ("descriptors"), stated by users in a seamless way.</p>
-<p>Furthermore, the <a href="https://pkg.go.dev/github.com/kuadrant/kuadrant-operator@v0.2.1/api/v1beta1#Limit"><code>Limit</code></a> type – used as well in the RLP's <code>RateLimit</code> type – implies presently a logical relationship between its inner concepts – i.e. conditions and variables on one side, and limits themselves on the other – that otherwise could be shaped in a different manner, to provide clearer understanding of the meaning of these concepts by the user and avoid repetition. I.e., one limit definition contains multiple rate limits, and not the other way around.</p>
-<h3 id="goals">Goals<a class="headerlink" href="#goals" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Decouple the API from the underlying implementation - i.e. provide a more generic and more user-friendly abstraction</li>
-<li>Prepare the API for upcoming changes in the Gateway API Policy Attachment specification</li>
-<li>Improve consistency of the API with respect to Kuadrant's <a href="https://pkg.go.dev/github.com/kuadrant/kuadrant-operator@v0.2.1/api/v1beta1#AuthPolicy">AuthPolicy</a> CRD - i.e. same language, similar UX</li>
-</ol>
-<h3 id="current-wip-to-consider">Current WIP to consider<a class="headerlink" href="#current-wip-to-consider" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Policy attachment update (<a href="https://github.com/kubernetes-sigs/gateway-api/pull/1565">kubernetes-sigs/gateway-api#1565</a>)</li>
-<li><em>No</em> merging of policies (<a href="https://github.com/Kuadrant/architecture/pull/10">kuadrant/architecture#10</a>)</li>
-<li>A single Policy scoped to HTTPRoutes and HTTPRouteRule (<a href="https://github.com/Kuadrant/architecture/pull/4">kuadrant/architecture#4</a>) - future</li>
-<li>Implement <code>skip_if_absent</code> for the RequestHeaders action (<a href="https://github.com/Kuadrant/wasm-shim/issues/29">kuadrant/wasm-shim#29</a>)</li>
-</ol>
-<h3 id="highlights">Highlights<a class="headerlink" href="#highlights" title="Permanent link">&para;</a></h3>
-<ul>
-<li><code>spec.rateLimits[]</code> replaced with <code>spec.limits{&lt;limit-name&gt;: &lt;limit-definition&gt;}</code></li>
-<li><code>spec.rateLimits.limits</code> replaced with <code>spec.limits.&lt;limit-name&gt;.rates</code></li>
-<li><code>spec.rateLimits.limits.maxValue</code> replaced with <code>spec.limits.&lt;limit-name&gt;.rates.limit</code></li>
-<li><code>spec.rateLimits.limits.seconds</code> replaced with <code>spec.limits.&lt;limit-name&gt;.rates.duration</code> + <code>spec.limits.&lt;limit-name&gt;.rates.unit</code></li>
-<li><code>spec.rateLimits.limits.conditions</code> replaced with <code>spec.limits.&lt;limit-name&gt;.when</code>, structured field based on <em>well-known selectors</em>, mainly for expressing conditions not related to the HTTP route (although not exclusively)</li>
-<li><code>spec.rateLimits.limits.variables</code> replaced with <code>spec.limits.&lt;limit-name&gt;.counters</code>, based on <em>well-known selectors</em></li>
-<li><code>spec.rateLimits.rules</code> replaced with <code>spec.limits.&lt;limit-name&gt;.routeSelectors</code>, for selecting (or "sub-targeting") HTTPRouteRules that trigger the limit</li>
-<li>new matcher <code>spec.limits.&lt;limit-name&gt;.routeSelectors.hostnames[]</code></li>
-<li><code>spec.rateLimits.configurations</code> removed – descriptor actions configuration (previously <code>spec.rateLimits.configurations.actions</code>) generated from <code>spec.limits.&lt;limit-name&gt;.when.selector</code> ∪ <code>spec.limits.&lt;limit-name&gt;.counters</code> and unique identifier of the limit (associated with <code>spec.limits.&lt;limit-name&gt;.routeSelectors</code>)</li>
-<li>Limitador conditions composed of "soft" <code>spec.limits.&lt;limit-name&gt;.when</code> conditions + a "hard" condition that binds the limit to its trigger HTTPRouteRules</li>
-</ul>
-<p>For detailed differences between current and new RLP API, see <a href="#comparison-to-current-ratelimitpolicy">Comparison to current RateLimitPolicy</a>.</p>
-<h2 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h2>
-<h3 id="examples-of-rlps-based-on-the-new-api">Examples of RLPs based on the new API<a class="headerlink" href="#examples-of-rlps-based-on-the-new-api" title="Permanent link">&para;</a></h3>
-<p>Given the following network resources:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1alpha2</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="nt">gatewayClassName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span><span class="nt">listeners</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">hostname</span><span class="p">:</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;*.acme.com&quot;</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="nn">---</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1alpha2</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">  </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">  </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;*.toystore.acme.com&quot;</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a><span class="w">    </span><span class="nt">filters</span><span class="p">:</span>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ResponseHeaderModifier</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a><span class="w">      </span><span class="nt">responseHeaderModifier</span><span class="p">:</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a><span class="w">        </span><span class="nt">set</span><span class="p">:</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Cache-Control</span>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49" href="#__codelineno-0-49"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;max-age=31536000,</span><span class="nv"> </span><span class="s">immutable&quot;</span>
-</span></code></pre></div>
-<p>The following are examples of RLPs targeting the route and the gateway. Each example is independent from the other.</p>
-<h4 id="example-1-minimal-example-network-resource-targeted-entirely-without-filtering-unconditional-and-unqualified-rate-limiting">Example 1. Minimal example - network resource targeted entirely without filtering, unconditional and unqualified rate limiting<a class="headerlink" href="#example-1-minimal-example-network-resource-targeted-entirely-without-filtering-unconditional-and-unqualified-rate-limiting" title="Permanent link">&para;</a></h4>
-<p>In this example, all traffic to <code>*.toystore.acme.com</code> will be limited to 5rps, regardless of any other attribute of the HTTP request (method, path, headers, etc), without any extra "soft" conditions (conditions non-related to the HTTP route), across all consumers of the API (unqualified rate limiting).</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-infra-rl</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">    </span><span class="nt">base</span><span class="p">:</span><span class="w"> </span><span class="c1"># user-defined name of the limit definition - future use for handling hierarchical policy attachment</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rates</span><span class="p">:</span><span class="w"> </span><span class="c1"># at least one rate limit required</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP implemented under the hood?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;POST&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/assets/*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-infra-rl/base&quot;</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-infra-rl/base == &quot;1&quot;</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">TDB</span>
-</span></code></pre></div>
-</details>
-
-<h4 id="example-2-targeting-specific-route-rules-with-counter-qualifiers-multiple-rates-per-limit-definition-and-soft-conditions">Example 2. Targeting specific route rules, with counter qualifiers, multiple rates per limit definition and "soft" conditions<a class="headerlink" href="#example-2-targeting-specific-route-rules-with-counter-qualifiers-multiple-rates-per-limit-definition-and-soft-conditions" title="Permanent link">&para;</a></h4>
-<p>In this example, a distinct limit will be associated ("bound") to each individual HTTPRouteRule of the targeted HTTPRoute, by using the <code>routeSelectors</code> field for selecting (or "sub-targeting") the HTTPRouteRule.</p>
-<p>The following limit definitions will be bound to each HTTPRouteRule:</p>
-<ul>
-<li><code>/toys*</code> → 50rpm, enforced per username (counter qualifier) and only in case the user is not an admin ("soft" condition).</li>
-<li><code>/assets/*</code> → 5rpm / 100rp12h</li>
-</ul>
-<p>Each set of trigger matches in the RLP will be matched to <strong>all</strong> HTTPRouteRules whose HTTPRouteMatches is a superset of the set of trigger matches in the RLP. For every HTTPRouteRule matched, the HTTPRouteRule will be bound to the corresponding limit definition that specifies that trigger. In case no HTTPRouteRule is found containing at least one HTTPRouteMatch that is identical to some set of matching rules of a particular limit definition, the limit definition is considered invalid and reported as such in the status of RLP.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-per-endpoint</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="w">    </span><span class="nt">toys</span><span class="p">:</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">minute</span>
-</span><span id="__span-4-18"><a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a><span class="w">      </span><span class="nt">counters</span><span class="p">:</span>
-</span><span id="__span-4-19"><a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-4-20"><a id="__codelineno-4-20" name="__codelineno-4-20" href="#__codelineno-4-20"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-4-21"><a id="__codelineno-4-21" name="__codelineno-4-21" href="#__codelineno-4-21"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches the 1st HTTPRouteRule (i.e. GET or POST to /toys*)</span>
-</span><span id="__span-4-22"><a id="__codelineno-4-22" name="__codelineno-4-22" href="#__codelineno-4-22"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-4-23"><a id="__codelineno-4-23" name="__codelineno-4-23" href="#__codelineno-4-23"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-4-24"><a id="__codelineno-4-24" name="__codelineno-4-24" href="#__codelineno-4-24"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-4-25"><a id="__codelineno-4-25" name="__codelineno-4-25" href="#__codelineno-4-25"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-4-26"><a id="__codelineno-4-26" name="__codelineno-4-26" href="#__codelineno-4-26"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.group</span>
-</span><span id="__span-4-27"><a id="__codelineno-4-27" name="__codelineno-4-27" href="#__codelineno-4-27"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-4-28"><a id="__codelineno-4-28" name="__codelineno-4-28" href="#__codelineno-4-28"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-4-29"><a id="__codelineno-4-29" name="__codelineno-4-29" href="#__codelineno-4-29"></a>
-</span><span id="__span-4-30"><a id="__codelineno-4-30" name="__codelineno-4-30" href="#__codelineno-4-30"></a><span class="w">    </span><span class="nt">assets</span><span class="p">:</span>
-</span><span id="__span-4-31"><a id="__codelineno-4-31" name="__codelineno-4-31" href="#__codelineno-4-31"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-4-32"><a id="__codelineno-4-32" name="__codelineno-4-32" href="#__codelineno-4-32"></a>
-</span><span id="__span-4-33"><a id="__codelineno-4-33" name="__codelineno-4-33" href="#__codelineno-4-33"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-4-34"><a id="__codelineno-4-34" name="__codelineno-4-34" href="#__codelineno-4-34"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-4-35"><a id="__codelineno-4-35" name="__codelineno-4-35" href="#__codelineno-4-35"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">minute</span>
-</span><span id="__span-4-36"><a id="__codelineno-4-36" name="__codelineno-4-36" href="#__codelineno-4-36"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">100</span>
-</span><span id="__span-4-37"><a id="__codelineno-4-37" name="__codelineno-4-37" href="#__codelineno-4-37"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">12</span>
-</span><span id="__span-4-38"><a id="__codelineno-4-38" name="__codelineno-4-38" href="#__codelineno-4-38"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">hour</span>
-</span><span id="__span-4-39"><a id="__codelineno-4-39" name="__codelineno-4-39" href="#__codelineno-4-39"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-4-40"><a id="__codelineno-4-40" name="__codelineno-4-40" href="#__codelineno-4-40"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches the 2nd HTTPRouteRule (i.e. /assets/*)</span>
-</span><span id="__span-4-41"><a id="__codelineno-4-41" name="__codelineno-4-41" href="#__codelineno-4-41"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-4-42"><a id="__codelineno-4-42" name="__codelineno-4-42" href="#__codelineno-4-42"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-4-43"><a id="__codelineno-4-43" name="__codelineno-4-43" href="#__codelineno-4-43"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP implemented under the hood?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;POST&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-per-endpoint/toys&quot;</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;auth.identity.group&quot;</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="w">      </span><span class="nt">metadata_key</span><span class="p">:</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;envoy.filters.http.ext_authz&quot;</span>
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a><span class="w">        </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;identity&quot;</span>
-</span><span id="__span-5-21"><a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-5-22"><a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;group&quot;</span>
-</span><span id="__span-5-23"><a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-5-24"><a id="__codelineno-5-24" name="__codelineno-5-24" href="#__codelineno-5-24"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;auth.identity.username&quot;</span>
-</span><span id="__span-5-25"><a id="__codelineno-5-25" name="__codelineno-5-25" href="#__codelineno-5-25"></a><span class="w">      </span><span class="nt">metadata_key</span><span class="p">:</span>
-</span><span id="__span-5-26"><a id="__codelineno-5-26" name="__codelineno-5-26" href="#__codelineno-5-26"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;envoy.filters.http.ext_authz&quot;</span>
-</span><span id="__span-5-27"><a id="__codelineno-5-27" name="__codelineno-5-27" href="#__codelineno-5-27"></a><span class="w">        </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-5-28"><a id="__codelineno-5-28" name="__codelineno-5-28" href="#__codelineno-5-28"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-5-29"><a id="__codelineno-5-29" name="__codelineno-5-29" href="#__codelineno-5-29"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;identity&quot;</span>
-</span><span id="__span-5-30"><a id="__codelineno-5-30" name="__codelineno-5-30" href="#__codelineno-5-30"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-5-31"><a id="__codelineno-5-31" name="__codelineno-5-31" href="#__codelineno-5-31"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;username&quot;</span>
-</span><span id="__span-5-32"><a id="__codelineno-5-32" name="__codelineno-5-32" href="#__codelineno-5-32"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-5-33"><a id="__codelineno-5-33" name="__codelineno-5-33" href="#__codelineno-5-33"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/assets/*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-34"><a id="__codelineno-5-34" name="__codelineno-5-34" href="#__codelineno-5-34"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-35"><a id="__codelineno-5-35" name="__codelineno-5-35" href="#__codelineno-5-35"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-5-36"><a id="__codelineno-5-36" name="__codelineno-5-36" href="#__codelineno-5-36"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-5-37"><a id="__codelineno-5-37" name="__codelineno-5-37" href="#__codelineno-5-37"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-per-endpoint/assets&quot;</span>
-</span><span id="__span-5-38"><a id="__codelineno-5-38" name="__codelineno-5-38" href="#__codelineno-5-38"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-per-endpoint/toys == &quot;1&quot;</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.group != &quot;admin&quot;</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w">  </span><span class="nt">variables</span><span class="p">:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-per-endpoint/assets == &quot;1&quot;</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-per-endpoint/assets == &quot;1&quot;</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">100</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">43200</span><span class="w"> </span><span class="c1"># 12 hours</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span></code></pre></div>
-</details>
-
-<h4 id="example-3-targeting-a-subset-of-an-httprouterule-httproutematch-missing">Example 3. Targeting a subset of an HTTPRouteRule - HTTPRouteMatch missing<a class="headerlink" href="#example-3-targeting-a-subset-of-an-httprouterule-httproutematch-missing" title="Permanent link">&para;</a></h4>
-<p>Consider a 150rps rate limit set on requests to <code>GET /toys/special</code>. Such specific application endpoint is covered by the first HTTPRouteRule in the HTTPRoute (as a subset of <code>GET</code> or <code>POST</code> to any path that starts with <code>/toys</code>). However, to avoid binding limits to HTTPRouteRules that are more permissive than the actual intended scope of the limit, the RateLimitPolicy controller requires trigger matches to find identical matching rules explicitly defined amongst the sets of HTTPRouteMatches of the HTTPRouteRules potentially targeted.</p>
-<p>As a consequence, by simply defining a trigger match for <code>GET /toys/special</code> in the RLP, the <code>GET|POST /toys*</code> HTTPRouteRule will NOT be bound to the limit definition. In order to ensure the limit definition is properly bound to a routing rule that strictly covers the <code>GET /toys/special</code> application endpoint, first the user has to modify the spec of the HTTPRoute by adding an explicit HTTPRouteRule for this case:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1alpha2</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w">  </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="w">  </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;*.toystore.acme.com&quot;</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-7-21"><a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-7-22"><a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-7-23"><a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-7-24"><a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-7-25"><a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-7-26"><a id="__codelineno-7-26" name="__codelineno-7-26" href="#__codelineno-7-26"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-7-27"><a id="__codelineno-7-27" name="__codelineno-7-27" href="#__codelineno-7-27"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-7-28"><a id="__codelineno-7-28" name="__codelineno-7-28" href="#__codelineno-7-28"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-7-29"><a id="__codelineno-7-29" name="__codelineno-7-29" href="#__codelineno-7-29"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span><span id="__span-7-30"><a id="__codelineno-7-30" name="__codelineno-7-30" href="#__codelineno-7-30"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-7-31"><a id="__codelineno-7-31" name="__codelineno-7-31" href="#__codelineno-7-31"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-7-32"><a id="__codelineno-7-32" name="__codelineno-7-32" href="#__codelineno-7-32"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-7-33"><a id="__codelineno-7-33" name="__codelineno-7-33" href="#__codelineno-7-33"></a><span class="w">    </span><span class="nt">filters</span><span class="p">:</span>
-</span><span id="__span-7-34"><a id="__codelineno-7-34" name="__codelineno-7-34" href="#__codelineno-7-34"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ResponseHeaderModifier</span>
-</span><span id="__span-7-35"><a id="__codelineno-7-35" name="__codelineno-7-35" href="#__codelineno-7-35"></a><span class="w">      </span><span class="nt">responseHeaderModifier</span><span class="p">:</span>
-</span><span id="__span-7-36"><a id="__codelineno-7-36" name="__codelineno-7-36" href="#__codelineno-7-36"></a><span class="w">        </span><span class="nt">set</span><span class="p">:</span>
-</span><span id="__span-7-37"><a id="__codelineno-7-37" name="__codelineno-7-37" href="#__codelineno-7-37"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Cache-Control</span>
-</span><span id="__span-7-38"><a id="__codelineno-7-38" name="__codelineno-7-38" href="#__codelineno-7-38"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;max-age=31536000,</span><span class="nv"> </span><span class="s">immutable&quot;</span>
-</span><span id="__span-7-39"><a id="__codelineno-7-39" name="__codelineno-7-39" href="#__codelineno-7-39"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># new (more specific) HTTPRouteRule added</span>
-</span><span id="__span-7-40"><a id="__codelineno-7-40" name="__codelineno-7-40" href="#__codelineno-7-40"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-7-41"><a id="__codelineno-7-41" name="__codelineno-7-41" href="#__codelineno-7-41"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-7-42"><a id="__codelineno-7-42" name="__codelineno-7-42" href="#__codelineno-7-42"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys/special&quot;</span>
-</span><span id="__span-7-43"><a id="__codelineno-7-43" name="__codelineno-7-43" href="#__codelineno-7-43"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-7-44"><a id="__codelineno-7-44" name="__codelineno-7-44" href="#__codelineno-7-44"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-7-45"><a id="__codelineno-7-45" name="__codelineno-7-45" href="#__codelineno-7-45"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-7-46"><a id="__codelineno-7-46" name="__codelineno-7-46" href="#__codelineno-7-46"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span></code></pre></div>
-<p>After that, the RLP can target the new HTTPRouteRule strictly:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-special-toys</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w">    </span><span class="nt">specialToys</span><span class="p">:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">150</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches the new HTTPRouteRule (i.e. GET /toys/special)</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys/special&quot;</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP implemented under the hood?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys/special&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-special-toys/specialToys&quot;</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-special-toys/specialToys == &quot;1&quot;</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">150</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span></code></pre></div>
-</details>
-
-<h4 id="example-4-targeting-a-subset-of-an-httprouterule-httproutematch-found">Example 4. Targeting a subset of an HTTPRouteRule - HTTPRouteMatch found<a class="headerlink" href="#example-4-targeting-a-subset-of-an-httprouterule-httproutematch-found" title="Permanent link">&para;</a></h4>
-<p>This example is similar to <a href="#example-3-targeting-a-subset-of-an-httprouterule---httproutematch-missing">Example 3</a>. Consider the use case of setting a 150rpm rate limit on requests to <code>GET /toys*</code>.</p>
-<p>The targeted application endpoint is covered by the first HTTPRouteRule in the HTTPRoute (as a subset of <code>GET</code> or <code>POST</code> to any path that starts with <code>/toys</code>). However, unlike in the previous example where, at first, no HTTPRouteRule included an explicit HTTPRouteMatch for <code>GET /toys/special</code>, in this example the HTTPRouteMatch for the targeted application endpoint <code>GET /toys*</code> does exist explicitly in one of the HTTPRouteRules, thus the RateLimitPolicy controller would find no problem to bind the limit definition to the HTTPRouteRule. That would nonetheless cause a unexpected behavior of the limit triggered not strictly for <code>GET /toys*</code>, but also for <code>POST /toys*</code>.</p>
-<p>To avoid extending the scope of the limit beyond desired, with no extra "soft" conditions, again the user must modify the spec of the HTTPRoute, so an exclusive HTTPRouteRule exists for the <code>GET /toys*</code> application endpoint:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1alpha2</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="w">  </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="w">  </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;*.toystore.acme.com&quot;</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># first HTTPRouteRule split into two – one for GET /toys*, other for POST /toys*</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-11-19"><a id="__codelineno-11-19" name="__codelineno-11-19" href="#__codelineno-11-19"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-20"><a id="__codelineno-11-20" name="__codelineno-11-20" href="#__codelineno-11-20"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-11-21"><a id="__codelineno-11-21" name="__codelineno-11-21" href="#__codelineno-11-21"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-11-22"><a id="__codelineno-11-22" name="__codelineno-11-22" href="#__codelineno-11-22"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-11-23"><a id="__codelineno-11-23" name="__codelineno-11-23" href="#__codelineno-11-23"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-11-24"><a id="__codelineno-11-24" name="__codelineno-11-24" href="#__codelineno-11-24"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-11-25"><a id="__codelineno-11-25" name="__codelineno-11-25" href="#__codelineno-11-25"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-11-26"><a id="__codelineno-11-26" name="__codelineno-11-26" href="#__codelineno-11-26"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-11-27"><a id="__codelineno-11-27" name="__codelineno-11-27" href="#__codelineno-11-27"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-28"><a id="__codelineno-11-28" name="__codelineno-11-28" href="#__codelineno-11-28"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-11-29"><a id="__codelineno-11-29" name="__codelineno-11-29" href="#__codelineno-11-29"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-11-30"><a id="__codelineno-11-30" name="__codelineno-11-30" href="#__codelineno-11-30"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-11-31"><a id="__codelineno-11-31" name="__codelineno-11-31" href="#__codelineno-11-31"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-11-32"><a id="__codelineno-11-32" name="__codelineno-11-32" href="#__codelineno-11-32"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-11-33"><a id="__codelineno-11-33" name="__codelineno-11-33" href="#__codelineno-11-33"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span><span id="__span-11-34"><a id="__codelineno-11-34" name="__codelineno-11-34" href="#__codelineno-11-34"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-35"><a id="__codelineno-11-35" name="__codelineno-11-35" href="#__codelineno-11-35"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-11-36"><a id="__codelineno-11-36" name="__codelineno-11-36" href="#__codelineno-11-36"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-11-37"><a id="__codelineno-11-37" name="__codelineno-11-37" href="#__codelineno-11-37"></a><span class="w">    </span><span class="nt">filters</span><span class="p">:</span>
-</span><span id="__span-11-38"><a id="__codelineno-11-38" name="__codelineno-11-38" href="#__codelineno-11-38"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ResponseHeaderModifier</span>
-</span><span id="__span-11-39"><a id="__codelineno-11-39" name="__codelineno-11-39" href="#__codelineno-11-39"></a><span class="w">      </span><span class="nt">responseHeaderModifier</span><span class="p">:</span>
-</span><span id="__span-11-40"><a id="__codelineno-11-40" name="__codelineno-11-40" href="#__codelineno-11-40"></a><span class="w">        </span><span class="nt">set</span><span class="p">:</span>
-</span><span id="__span-11-41"><a id="__codelineno-11-41" name="__codelineno-11-41" href="#__codelineno-11-41"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Cache-Control</span>
-</span><span id="__span-11-42"><a id="__codelineno-11-42" name="__codelineno-11-42" href="#__codelineno-11-42"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;max-age=31536000,</span><span class="nv"> </span><span class="s">immutable&quot;</span>
-</span></code></pre></div>
-<p>The RLP can then target the new HTTPRouteRule strictly:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toy-readers</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="w">    </span><span class="nt">toyReaders</span><span class="p">:</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">150</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches the new more specific HTTPRouteRule (i.e. GET /toys*)</span>
-</span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-12-20"><a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-12-21"><a id="__codelineno-12-21" name="__codelineno-12-21" href="#__codelineno-12-21"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-12-22"><a id="__codelineno-12-22" name="__codelineno-12-22" href="#__codelineno-12-22"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP implemented under the hood?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toy-readers/toyReaders&quot;</span>
-</span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toy-readers/toyReaders == &quot;1&quot;</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">150</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span></code></pre></div>
-</details>
-
-<h4 id="example-5-one-limit-triggered-by-multiple-httprouterules">Example 5. One limit triggered by multiple HTTPRouteRules<a class="headerlink" href="#example-5-one-limit-triggered-by-multiple-httprouterules" title="Permanent link">&para;</a></h4>
-<p>In this example, both HTTPRouteRules, i.e. <code>GET|POST /toys*</code> and <code>/assets/*</code>, are targeted by the same limit of 50rpm per username.</p>
-<p>Because the HTTPRoute has no other rule, this is technically equivalent to targeting the entire HTTPRoute and therefore similar to <a href="#example-1-minimal-example---network-resource-targeted-entirely-without-filtering-unconditional-and-unqualified-rate-limiting">Example 1</a>. However, if the HTTPRoute had other rules or got other rules added afterwards, this would ensure the limit applies only to the two original route rules.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-per-user</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="w">    </span><span class="nt">toysOrAssetsPerUsername</span><span class="p">:</span>
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a>
-</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">minute</span>
-</span><span id="__span-15-18"><a id="__codelineno-15-18" name="__codelineno-15-18" href="#__codelineno-15-18"></a><span class="w">      </span><span class="nt">counters</span><span class="p">:</span>
-</span><span id="__span-15-19"><a id="__codelineno-15-19" name="__codelineno-15-19" href="#__codelineno-15-19"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-15-20"><a id="__codelineno-15-20" name="__codelineno-15-20" href="#__codelineno-15-20"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-15-21"><a id="__codelineno-15-21" name="__codelineno-15-21" href="#__codelineno-15-21"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-15-22"><a id="__codelineno-15-22" name="__codelineno-15-22" href="#__codelineno-15-22"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-15-23"><a id="__codelineno-15-23" name="__codelineno-15-23" href="#__codelineno-15-23"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-15-24"><a id="__codelineno-15-24" name="__codelineno-15-24" href="#__codelineno-15-24"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-15-25"><a id="__codelineno-15-25" name="__codelineno-15-25" href="#__codelineno-15-25"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-15-26"><a id="__codelineno-15-26" name="__codelineno-15-26" href="#__codelineno-15-26"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-15-27"><a id="__codelineno-15-27" name="__codelineno-15-27" href="#__codelineno-15-27"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-15-28"><a id="__codelineno-15-28" name="__codelineno-15-28" href="#__codelineno-15-28"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-15-29"><a id="__codelineno-15-29" name="__codelineno-15-29" href="#__codelineno-15-29"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-15-30"><a id="__codelineno-15-30" name="__codelineno-15-30" href="#__codelineno-15-30"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-15-31"><a id="__codelineno-15-31" name="__codelineno-15-31" href="#__codelineno-15-31"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-15-32"><a id="__codelineno-15-32" name="__codelineno-15-32" href="#__codelineno-15-32"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-15-33"><a id="__codelineno-15-33" name="__codelineno-15-33" href="#__codelineno-15-33"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP implemented under the hood?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a>
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-16-7"><a id="__codelineno-16-7" name="__codelineno-16-7" href="#__codelineno-16-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-16-8"><a id="__codelineno-16-8" name="__codelineno-16-8" href="#__codelineno-16-8"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;POST&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-16-9"><a id="__codelineno-16-9" name="__codelineno-16-9" href="#__codelineno-16-9"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-16-10"><a id="__codelineno-16-10" name="__codelineno-16-10" href="#__codelineno-16-10"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/assets/*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-16-11"><a id="__codelineno-16-11" name="__codelineno-16-11" href="#__codelineno-16-11"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-16-12"><a id="__codelineno-16-12" name="__codelineno-16-12" href="#__codelineno-16-12"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-16-13"><a id="__codelineno-16-13" name="__codelineno-16-13" href="#__codelineno-16-13"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-16-14"><a id="__codelineno-16-14" name="__codelineno-16-14" href="#__codelineno-16-14"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-per-user/toysOrAssetsPerUsername&quot;</span>
-</span><span id="__span-16-15"><a id="__codelineno-16-15" name="__codelineno-16-15" href="#__codelineno-16-15"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-16-16"><a id="__codelineno-16-16" name="__codelineno-16-16" href="#__codelineno-16-16"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-16-17"><a id="__codelineno-16-17" name="__codelineno-16-17" href="#__codelineno-16-17"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;auth.identity.username&quot;</span>
-</span><span id="__span-16-18"><a id="__codelineno-16-18" name="__codelineno-16-18" href="#__codelineno-16-18"></a><span class="w">      </span><span class="nt">metadata_key</span><span class="p">:</span>
-</span><span id="__span-16-19"><a id="__codelineno-16-19" name="__codelineno-16-19" href="#__codelineno-16-19"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;envoy.filters.http.ext_authz&quot;</span>
-</span><span id="__span-16-20"><a id="__codelineno-16-20" name="__codelineno-16-20" href="#__codelineno-16-20"></a><span class="w">        </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-16-21"><a id="__codelineno-16-21" name="__codelineno-16-21" href="#__codelineno-16-21"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-16-22"><a id="__codelineno-16-22" name="__codelineno-16-22" href="#__codelineno-16-22"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;identity&quot;</span>
-</span><span id="__span-16-23"><a id="__codelineno-16-23" name="__codelineno-16-23" href="#__codelineno-16-23"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-16-24"><a id="__codelineno-16-24" name="__codelineno-16-24" href="#__codelineno-16-24"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;username&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-per-user/toysOrAssetsPerUsername == &quot;1&quot;</span>
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="w">  </span><span class="nt">variables</span><span class="p">:</span>
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-17-9"><a id="__codelineno-17-9" name="__codelineno-17-9" href="#__codelineno-17-9"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span></code></pre></div>
-</details>
-
-<h4 id="example-6-multiple-limit-definitions-targeting-the-same-httprouterule">Example 6. Multiple limit definitions targeting the same HTTPRouteRule<a class="headerlink" href="#example-6-multiple-limit-definitions-targeting-the-same-httprouterule" title="Permanent link">&para;</a></h4>
-<p>In case multiple limit definitions target a same HTTPRouteRule, all those limit definitions will be bound to the HTTPRouteRule. No limit "shadowing" will be be enforced by the RLP controller. Due to how things work as of today in Limitador nonetheless (i.e. the rule of the most restrictive limit wins), in some cases, across multiple limits triggered, one limit ends up "shadowing" others, depending on further qualification of the counters and the actual RL values.</p>
-<p>E.g., the following RLP intends to set 50rps per username on <code>GET /toys*</code>, and 100rps on <code>POST /toys*</code> or <code>/assets/*</code>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-per-endpoint</span>
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-18-9"><a id="__codelineno-18-9" name="__codelineno-18-9" href="#__codelineno-18-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-18-10"><a id="__codelineno-18-10" name="__codelineno-18-10" href="#__codelineno-18-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-18-11"><a id="__codelineno-18-11" name="__codelineno-18-11" href="#__codelineno-18-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-18-12"><a id="__codelineno-18-12" name="__codelineno-18-12" href="#__codelineno-18-12"></a><span class="w">    </span><span class="nt">readToys</span><span class="p">:</span>
-</span><span id="__span-18-13"><a id="__codelineno-18-13" name="__codelineno-18-13" href="#__codelineno-18-13"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-18-14"><a id="__codelineno-18-14" name="__codelineno-18-14" href="#__codelineno-18-14"></a>
-</span><span id="__span-18-15"><a id="__codelineno-18-15" name="__codelineno-18-15" href="#__codelineno-18-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-18-16"><a id="__codelineno-18-16" name="__codelineno-18-16" href="#__codelineno-18-16"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-18-17"><a id="__codelineno-18-17" name="__codelineno-18-17" href="#__codelineno-18-17"></a><span class="w">      </span><span class="nt">counters</span><span class="p">:</span>
-</span><span id="__span-18-18"><a id="__codelineno-18-18" name="__codelineno-18-18" href="#__codelineno-18-18"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-18-19"><a id="__codelineno-18-19" name="__codelineno-18-19" href="#__codelineno-18-19"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-18-20"><a id="__codelineno-18-20" name="__codelineno-18-20" href="#__codelineno-18-20"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches the 1st HTTPRouteRule (i.e. GET or POST to /toys*)</span>
-</span><span id="__span-18-21"><a id="__codelineno-18-21" name="__codelineno-18-21" href="#__codelineno-18-21"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-18-22"><a id="__codelineno-18-22" name="__codelineno-18-22" href="#__codelineno-18-22"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-18-23"><a id="__codelineno-18-23" name="__codelineno-18-23" href="#__codelineno-18-23"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-18-24"><a id="__codelineno-18-24" name="__codelineno-18-24" href="#__codelineno-18-24"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-18-25"><a id="__codelineno-18-25" name="__codelineno-18-25" href="#__codelineno-18-25"></a>
-</span><span id="__span-18-26"><a id="__codelineno-18-26" name="__codelineno-18-26" href="#__codelineno-18-26"></a><span class="w">    </span><span class="nt">postToysOrAssets</span><span class="p">:</span>
-</span><span id="__span-18-27"><a id="__codelineno-18-27" name="__codelineno-18-27" href="#__codelineno-18-27"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-18-28"><a id="__codelineno-18-28" name="__codelineno-18-28" href="#__codelineno-18-28"></a>
-</span><span id="__span-18-29"><a id="__codelineno-18-29" name="__codelineno-18-29" href="#__codelineno-18-29"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">100</span>
-</span><span id="__span-18-30"><a id="__codelineno-18-30" name="__codelineno-18-30" href="#__codelineno-18-30"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-18-31"><a id="__codelineno-18-31" name="__codelineno-18-31" href="#__codelineno-18-31"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-18-32"><a id="__codelineno-18-32" name="__codelineno-18-32" href="#__codelineno-18-32"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches the 1st HTTPRouteRule (i.e. GET or POST to /toys*)</span>
-</span><span id="__span-18-33"><a id="__codelineno-18-33" name="__codelineno-18-33" href="#__codelineno-18-33"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-18-34"><a id="__codelineno-18-34" name="__codelineno-18-34" href="#__codelineno-18-34"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-18-35"><a id="__codelineno-18-35" name="__codelineno-18-35" href="#__codelineno-18-35"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-18-36"><a id="__codelineno-18-36" name="__codelineno-18-36" href="#__codelineno-18-36"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-18-37"><a id="__codelineno-18-37" name="__codelineno-18-37" href="#__codelineno-18-37"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches the 2nd HTTPRouteRule (i.e. /assets/*)</span>
-</span><span id="__span-18-38"><a id="__codelineno-18-38" name="__codelineno-18-38" href="#__codelineno-18-38"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-18-39"><a id="__codelineno-18-39" name="__codelineno-18-39" href="#__codelineno-18-39"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-18-40"><a id="__codelineno-18-40" name="__codelineno-18-40" href="#__codelineno-18-40"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP implemented under the hood?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a>
-</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-6"><a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-7"><a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-8"><a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;POST&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-9"><a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-10"><a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-19-11"><a id="__codelineno-19-11" name="__codelineno-19-11" href="#__codelineno-19-11"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-19-12"><a id="__codelineno-19-12" name="__codelineno-19-12" href="#__codelineno-19-12"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-per-endpoint/readToys&quot;</span>
-</span><span id="__span-19-13"><a id="__codelineno-19-13" name="__codelineno-19-13" href="#__codelineno-19-13"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-19-14"><a id="__codelineno-19-14" name="__codelineno-19-14" href="#__codelineno-19-14"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-19-15"><a id="__codelineno-19-15" name="__codelineno-19-15" href="#__codelineno-19-15"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;auth.identity.username&quot;</span>
-</span><span id="__span-19-16"><a id="__codelineno-19-16" name="__codelineno-19-16" href="#__codelineno-19-16"></a><span class="w">      </span><span class="nt">metadata_key</span><span class="p">:</span>
-</span><span id="__span-19-17"><a id="__codelineno-19-17" name="__codelineno-19-17" href="#__codelineno-19-17"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;envoy.filters.http.ext_authz&quot;</span>
-</span><span id="__span-19-18"><a id="__codelineno-19-18" name="__codelineno-19-18" href="#__codelineno-19-18"></a><span class="w">        </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-19-19"><a id="__codelineno-19-19" name="__codelineno-19-19" href="#__codelineno-19-19"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-19-20"><a id="__codelineno-19-20" name="__codelineno-19-20" href="#__codelineno-19-20"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;identity&quot;</span>
-</span><span id="__span-19-21"><a id="__codelineno-19-21" name="__codelineno-19-21" href="#__codelineno-19-21"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-19-22"><a id="__codelineno-19-22" name="__codelineno-19-22" href="#__codelineno-19-22"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;username&quot;</span>
-</span><span id="__span-19-23"><a id="__codelineno-19-23" name="__codelineno-19-23" href="#__codelineno-19-23"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-19-24"><a id="__codelineno-19-24" name="__codelineno-19-24" href="#__codelineno-19-24"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-25"><a id="__codelineno-19-25" name="__codelineno-19-25" href="#__codelineno-19-25"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-26"><a id="__codelineno-19-26" name="__codelineno-19-26" href="#__codelineno-19-26"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-27"><a id="__codelineno-19-27" name="__codelineno-19-27" href="#__codelineno-19-27"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-28"><a id="__codelineno-19-28" name="__codelineno-19-28" href="#__codelineno-19-28"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;POST&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-29"><a id="__codelineno-19-29" name="__codelineno-19-29" href="#__codelineno-19-29"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-30"><a id="__codelineno-19-30" name="__codelineno-19-30" href="#__codelineno-19-30"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/assets/*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-31"><a id="__codelineno-19-31" name="__codelineno-19-31" href="#__codelineno-19-31"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-32"><a id="__codelineno-19-32" name="__codelineno-19-32" href="#__codelineno-19-32"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-19-33"><a id="__codelineno-19-33" name="__codelineno-19-33" href="#__codelineno-19-33"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-19-34"><a id="__codelineno-19-34" name="__codelineno-19-34" href="#__codelineno-19-34"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-per-endpoint/readToys&quot;</span>
-</span><span id="__span-19-35"><a id="__codelineno-19-35" name="__codelineno-19-35" href="#__codelineno-19-35"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-19-36"><a id="__codelineno-19-36" name="__codelineno-19-36" href="#__codelineno-19-36"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-19-37"><a id="__codelineno-19-37" name="__codelineno-19-37" href="#__codelineno-19-37"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-per-endpoint/postToysOrAssets&quot;</span>
-</span><span id="__span-19-38"><a id="__codelineno-19-38" name="__codelineno-19-38" href="#__codelineno-19-38"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a>
-</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="c1"># actually applies to GET|POST /toys*</span>
-</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-per-endpoint/readToys == &quot;1&quot;</span>
-</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a><span class="w">  </span><span class="nt">variables</span><span class="p">:</span>
-</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-20-7"><a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-20-8"><a id="__codelineno-20-8" name="__codelineno-20-8" href="#__codelineno-20-8"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-20-9"><a id="__codelineno-20-9" name="__codelineno-20-9" href="#__codelineno-20-9"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span><span id="__span-20-10"><a id="__codelineno-20-10" name="__codelineno-20-10" href="#__codelineno-20-10"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="c1"># actually applies to GET|POST /toys* and /assets/*</span>
-</span><span id="__span-20-11"><a id="__codelineno-20-11" name="__codelineno-20-11" href="#__codelineno-20-11"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-per-endpoint/postToysOrAssets == &quot;1&quot;</span>
-</span><span id="__span-20-12"><a id="__codelineno-20-12" name="__codelineno-20-12" href="#__codelineno-20-12"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">100</span>
-</span><span id="__span-20-13"><a id="__codelineno-20-13" name="__codelineno-20-13" href="#__codelineno-20-13"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-20-14"><a id="__codelineno-20-14" name="__codelineno-20-14" href="#__codelineno-20-14"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span></code></pre></div>
-</details>
-
-<p>This example was only written in this way to highlight that it is possible that multiple limit definitions select a same HTTPRouteRule. To avoid over-limiting between <code>GET|POST /toys*</code> and thus ensure the originally intended limit definitions for each of these routes apply, the HTTPRouteRule should be split into two, like done in <a href="#example-4-targeting-a-subset-of-an-httprouterule---httproutematch-found">Example 4</a>.</p>
-<h4 id="example-7-limits-triggered-for-specific-hostnames">Example 7. Limits triggered for specific hostnames<a class="headerlink" href="#example-7-limits-triggered-for-specific-hostnames" title="Permanent link">&para;</a></h4>
-<p>In the previous examples, the limit definitions and therefore the counters were set indistinctly for all hostnames – i.e. no matter if the request is sent to <code>games.toystore.acme.com</code> or <code>dolls.toystore.acme.com</code>, the same counters are expected to be affected. In this example on the other hand, a 1000rpd rate limit is set for requests to <code>/assets/*</code> only when the hostname matches <code>games.toystore.acme.com</code>.</p>
-<p>First, the user needs to edit the HTTPRoute to make the targeted hostname <code>games.toystore.acme.com</code> explicit:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1alpha2</span>
-</span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-21-3"><a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-21-4"><a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-21-5"><a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-21-6"><a id="__codelineno-21-6" name="__codelineno-21-6" href="#__codelineno-21-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-21-7"><a id="__codelineno-21-7" name="__codelineno-21-7" href="#__codelineno-21-7"></a><span class="w">  </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-21-8"><a id="__codelineno-21-8" name="__codelineno-21-8" href="#__codelineno-21-8"></a>
-</span><span id="__span-21-9"><a id="__codelineno-21-9" name="__codelineno-21-9" href="#__codelineno-21-9"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-21-10"><a id="__codelineno-21-10" name="__codelineno-21-10" href="#__codelineno-21-10"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-21-11"><a id="__codelineno-21-11" name="__codelineno-21-11" href="#__codelineno-21-11"></a><span class="w">  </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-21-12"><a id="__codelineno-21-12" name="__codelineno-21-12" href="#__codelineno-21-12"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;*.toystore.acme.com&quot;</span>
-</span><span id="__span-21-13"><a id="__codelineno-21-13" name="__codelineno-21-13" href="#__codelineno-21-13"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">games.toystore.acme.com</span><span class="w"> </span><span class="c1"># new (more specific) hostname added</span>
-</span><span id="__span-21-14"><a id="__codelineno-21-14" name="__codelineno-21-14" href="#__codelineno-21-14"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-21-15"><a id="__codelineno-21-15" name="__codelineno-21-15" href="#__codelineno-21-15"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-21-16"><a id="__codelineno-21-16" name="__codelineno-21-16" href="#__codelineno-21-16"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-21-17"><a id="__codelineno-21-17" name="__codelineno-21-17" href="#__codelineno-21-17"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-21-18"><a id="__codelineno-21-18" name="__codelineno-21-18" href="#__codelineno-21-18"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-21-19"><a id="__codelineno-21-19" name="__codelineno-21-19" href="#__codelineno-21-19"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-21-20"><a id="__codelineno-21-20" name="__codelineno-21-20" href="#__codelineno-21-20"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-21-21"><a id="__codelineno-21-21" name="__codelineno-21-21" href="#__codelineno-21-21"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-21-22"><a id="__codelineno-21-22" name="__codelineno-21-22" href="#__codelineno-21-22"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-21-23"><a id="__codelineno-21-23" name="__codelineno-21-23" href="#__codelineno-21-23"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-21-24"><a id="__codelineno-21-24" name="__codelineno-21-24" href="#__codelineno-21-24"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-21-25"><a id="__codelineno-21-25" name="__codelineno-21-25" href="#__codelineno-21-25"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-21-26"><a id="__codelineno-21-26" name="__codelineno-21-26" href="#__codelineno-21-26"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-21-27"><a id="__codelineno-21-27" name="__codelineno-21-27" href="#__codelineno-21-27"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-21-28"><a id="__codelineno-21-28" name="__codelineno-21-28" href="#__codelineno-21-28"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-21-29"><a id="__codelineno-21-29" name="__codelineno-21-29" href="#__codelineno-21-29"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-21-30"><a id="__codelineno-21-30" name="__codelineno-21-30" href="#__codelineno-21-30"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span><span id="__span-21-31"><a id="__codelineno-21-31" name="__codelineno-21-31" href="#__codelineno-21-31"></a><span class="w">    </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-21-32"><a id="__codelineno-21-32" name="__codelineno-21-32" href="#__codelineno-21-32"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-21-33"><a id="__codelineno-21-33" name="__codelineno-21-33" href="#__codelineno-21-33"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-21-34"><a id="__codelineno-21-34" name="__codelineno-21-34" href="#__codelineno-21-34"></a><span class="w">    </span><span class="nt">filters</span><span class="p">:</span>
-</span><span id="__span-21-35"><a id="__codelineno-21-35" name="__codelineno-21-35" href="#__codelineno-21-35"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ResponseHeaderModifier</span>
-</span><span id="__span-21-36"><a id="__codelineno-21-36" name="__codelineno-21-36" href="#__codelineno-21-36"></a><span class="w">      </span><span class="nt">responseHeaderModifier</span><span class="p">:</span>
-</span><span id="__span-21-37"><a id="__codelineno-21-37" name="__codelineno-21-37" href="#__codelineno-21-37"></a><span class="w">        </span><span class="nt">set</span><span class="p">:</span>
-</span><span id="__span-21-38"><a id="__codelineno-21-38" name="__codelineno-21-38" href="#__codelineno-21-38"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Cache-Control</span>
-</span><span id="__span-21-39"><a id="__codelineno-21-39" name="__codelineno-21-39" href="#__codelineno-21-39"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;max-age=31536000,</span><span class="nv"> </span><span class="s">immutable&quot;</span>
-</span></code></pre></div>
-<p>After that, the RLP can target specifically the newly added hostname:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-22-2"><a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-22-3"><a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-22-4"><a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-per-hostname</span>
-</span><span id="__span-22-5"><a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-22-6"><a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-22-7"><a id="__codelineno-22-7" name="__codelineno-22-7" href="#__codelineno-22-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-22-8"><a id="__codelineno-22-8" name="__codelineno-22-8" href="#__codelineno-22-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-22-9"><a id="__codelineno-22-9" name="__codelineno-22-9" href="#__codelineno-22-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-22-10"><a id="__codelineno-22-10" name="__codelineno-22-10" href="#__codelineno-22-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-22-11"><a id="__codelineno-22-11" name="__codelineno-22-11" href="#__codelineno-22-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-22-12"><a id="__codelineno-22-12" name="__codelineno-22-12" href="#__codelineno-22-12"></a><span class="w">    </span><span class="nt">games</span><span class="p">:</span>
-</span><span id="__span-22-13"><a id="__codelineno-22-13" name="__codelineno-22-13" href="#__codelineno-22-13"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-22-14"><a id="__codelineno-22-14" name="__codelineno-22-14" href="#__codelineno-22-14"></a>
-</span><span id="__span-22-15"><a id="__codelineno-22-15" name="__codelineno-22-15" href="#__codelineno-22-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1000</span>
-</span><span id="__span-22-16"><a id="__codelineno-22-16" name="__codelineno-22-16" href="#__codelineno-22-16"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">day</span>
-</span><span id="__span-22-17"><a id="__codelineno-22-17" name="__codelineno-22-17" href="#__codelineno-22-17"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-22-18"><a id="__codelineno-22-18" name="__codelineno-22-18" href="#__codelineno-22-18"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-22-19"><a id="__codelineno-22-19" name="__codelineno-22-19" href="#__codelineno-22-19"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-22-20"><a id="__codelineno-22-20" name="__codelineno-22-20" href="#__codelineno-22-20"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-22-21"><a id="__codelineno-22-21" name="__codelineno-22-21" href="#__codelineno-22-21"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span><span id="__span-22-22"><a id="__codelineno-22-22" name="__codelineno-22-22" href="#__codelineno-22-22"></a><span class="w">        </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-22-23"><a id="__codelineno-22-23" name="__codelineno-22-23" href="#__codelineno-22-23"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">games.toystore.acme.com</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP implemented under the hood?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>
-</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/assets/*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-23-5"><a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;games.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-23-6"><a id="__codelineno-23-6" name="__codelineno-23-6" href="#__codelineno-23-6"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-23-7"><a id="__codelineno-23-7" name="__codelineno-23-7" href="#__codelineno-23-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-23-8"><a id="__codelineno-23-8" name="__codelineno-23-8" href="#__codelineno-23-8"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-per-hostname/games&quot;</span>
-</span><span id="__span-23-9"><a id="__codelineno-23-9" name="__codelineno-23-9" href="#__codelineno-23-9"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-24-2"><a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a>
-</span><span id="__span-24-3"><a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-24-4"><a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-per-hostname/games == &quot;1&quot;</span>
-</span><span id="__span-24-5"><a id="__codelineno-24-5" name="__codelineno-24-5" href="#__codelineno-24-5"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1000</span>
-</span><span id="__span-24-6"><a id="__codelineno-24-6" name="__codelineno-24-6" href="#__codelineno-24-6"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">86400</span><span class="w"> </span><span class="c1"># 1 day</span>
-</span><span id="__span-24-7"><a id="__codelineno-24-7" name="__codelineno-24-7" href="#__codelineno-24-7"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span></code></pre></div>
-</details>
-
-<h4 id="example-8-targeting-the-gateway">Example 8. Targeting the Gateway<a class="headerlink" href="#example-8-targeting-the-gateway" title="Permanent link">&para;</a></h4>
-<blockquote>
-<p><strong>Note:</strong> Additional meaning and context may be given to this use case in the future, when discussing <a href="https://gateway-api.sigs.k8s.io/references/policy-attachment/#hierarchy">defaults and overrides</a>.</p>
-</blockquote>
-<p>Targeting a Gateway is a shortcut to targeting all individual HTTPRoutes referencing the gateway as parent. This differs from <a href="#example-1-minimal-example---network-resource-targeted-entirely-without-filtering-unconditional-and-unqualified-rate-limiting">Example 1</a> nonetheless because, by targeting the gateway rather than an individual HTTPRoute, the RLP applies automatically to all HTTPRoutes pointing to the gateway, including routes created before and after the creation of the RLP. Moreover, all those routes will share the same limit counters specified in the RLP.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-25-1"><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-25-2"><a id="__codelineno-25-2" name="__codelineno-25-2" href="#__codelineno-25-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-25-3"><a id="__codelineno-25-3" name="__codelineno-25-3" href="#__codelineno-25-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-25-4"><a id="__codelineno-25-4" name="__codelineno-25-4" href="#__codelineno-25-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gw-rl</span>
-</span><span id="__span-25-5"><a id="__codelineno-25-5" name="__codelineno-25-5" href="#__codelineno-25-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-25-6"><a id="__codelineno-25-6" name="__codelineno-25-6" href="#__codelineno-25-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-25-7"><a id="__codelineno-25-7" name="__codelineno-25-7" href="#__codelineno-25-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-25-8"><a id="__codelineno-25-8" name="__codelineno-25-8" href="#__codelineno-25-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-25-9"><a id="__codelineno-25-9" name="__codelineno-25-9" href="#__codelineno-25-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-25-10"><a id="__codelineno-25-10" name="__codelineno-25-10" href="#__codelineno-25-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-25-11"><a id="__codelineno-25-11" name="__codelineno-25-11" href="#__codelineno-25-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-25-12"><a id="__codelineno-25-12" name="__codelineno-25-12" href="#__codelineno-25-12"></a><span class="w">    </span><span class="nt">base</span><span class="p">:</span>
-</span><span id="__span-25-13"><a id="__codelineno-25-13" name="__codelineno-25-13" href="#__codelineno-25-13"></a>
-</span><span id="__span-25-14"><a id="__codelineno-25-14" name="__codelineno-25-14" href="#__codelineno-25-14"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-25-15"><a id="__codelineno-25-15" name="__codelineno-25-15" href="#__codelineno-25-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-25-16"><a id="__codelineno-25-16" name="__codelineno-25-16" href="#__codelineno-25-16"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP implemented under the hood?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-26-1"><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-26-2"><a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a>
-</span><span id="__span-26-3"><a id="__codelineno-26-3" name="__codelineno-26-3" href="#__codelineno-26-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-26-4"><a id="__codelineno-26-4" name="__codelineno-26-4" href="#__codelineno-26-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-26-5"><a id="__codelineno-26-5" name="__codelineno-26-5" href="#__codelineno-26-5"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-26-6"><a id="__codelineno-26-6" name="__codelineno-26-6" href="#__codelineno-26-6"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-26-7"><a id="__codelineno-26-7" name="__codelineno-26-7" href="#__codelineno-26-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-26-8"><a id="__codelineno-26-8" name="__codelineno-26-8" href="#__codelineno-26-8"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;POST&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-26-9"><a id="__codelineno-26-9" name="__codelineno-26-9" href="#__codelineno-26-9"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-26-10"><a id="__codelineno-26-10" name="__codelineno-26-10" href="#__codelineno-26-10"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/assets/*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-26-11"><a id="__codelineno-26-11" name="__codelineno-26-11" href="#__codelineno-26-11"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-26-12"><a id="__codelineno-26-12" name="__codelineno-26-12" href="#__codelineno-26-12"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-26-13"><a id="__codelineno-26-13" name="__codelineno-26-13" href="#__codelineno-26-13"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-26-14"><a id="__codelineno-26-14" name="__codelineno-26-14" href="#__codelineno-26-14"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;istio-system/gw-rl/base&quot;</span>
-</span><span id="__span-26-15"><a id="__codelineno-26-15" name="__codelineno-26-15" href="#__codelineno-26-15"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-27-1"><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-27-2"><a id="__codelineno-27-2" name="__codelineno-27-2" href="#__codelineno-27-2"></a>
-</span><span id="__span-27-3"><a id="__codelineno-27-3" name="__codelineno-27-3" href="#__codelineno-27-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-27-4"><a id="__codelineno-27-4" name="__codelineno-27-4" href="#__codelineno-27-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system/gw-rl/base == &quot;1&quot;</span>
-</span><span id="__span-27-5"><a id="__codelineno-27-5" name="__codelineno-27-5" href="#__codelineno-27-5"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-27-6"><a id="__codelineno-27-6" name="__codelineno-27-6" href="#__codelineno-27-6"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-27-7"><a id="__codelineno-27-7" name="__codelineno-27-7" href="#__codelineno-27-7"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">TDB</span>
-</span></code></pre></div>
-</details>
-
-<h3 id="comparison-to-current-ratelimitpolicy">Comparison to current RateLimitPolicy<a class="headerlink" href="#comparison-to-current-ratelimitpolicy" title="Permanent link">&para;</a></h3>
-<table>
-  <thead>
-    <tr>
-      <th>Current</th>
-      <th>New</th>
-      <th>Reason</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>1:1 relation between <i>Limit</i> (the object) and the actual <i>Rate limit</i> (the value) (<code>spec.rateLimits.limits</code>)</td>
-      <td><i>Rate limit</i> becomes a detail of <i>Limit</i> where each limit may define one or more rates (1:N) (<code>spec.limits.&lt;limit-name&gt;.rates</code>)</td>
-      <td>
-        <ul>
-          <li>It allows to reuse <code>when</code> conditions and <code>counters</code> for <i>groups of rate limits</i></li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>Parsed <code>spec.rateLimits.limits.conditions</code> field, directly exposing the Limitador's API</td>
-      <td>Structured <code>spec.limits.&lt;limit-name&gt.when</code> condition field composed of 3 well-defined properties: <code>selector</code>, <code>operator</code> and <code>value</code></td>
-      <td>
-        <ul>
-          <li>Feels more K8s-native</li>
-          <li>Consistent with <a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta1#JSONPatternExpression">github.com/kuadrant/authorino/api/v1beta1#JSONPatternExpression</a></li>
-          <li>No need for a parser (only if implemented by Limitador)</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td><code>spec.rateLimits.configurations</code> as a list of "variables assignments" and direct exposure of <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter#composing-actions">Envoy's RL descriptor actions API</a></td>
-      <td>Descriptor actions composed from selectors used in the limit definitions (<code>spec.limits.&lt;limit-name&gt.when.selector</code> and <code>spec.limits.&lt;limit-name&gt.counters</code>) plus a fixed identifier of the route rules (<code>spec.limits.&lt;limit-name&gt.routeSelectors</code>)</td>
-      <td>
-        <ul>
-          <li>Abstract the Envoy-specific concepts of "actions" and "descriptors"</li>
-          <li>No risk of mismatching descriptors keys between "actions" and actual usage in the limits</li>
-          <li>No user-defined generic descriptors (e.g. "limited = 1")</li>
-          <li>Source value of the selectors defined from an implicit "context" data structure</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>Key-value descriptors</td>
-      <td>Structured descriptors referring to a contextual well-known data structure</td>
-      <td>
-        <ul>
-          <li>Consistent with Authorino's <a href="https://github.com/Kuadrant/authorino/blob/main/docs/architecture.md#the-authorization-json">Authorization JSON (#context)</a></li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>Limitador conditions independent from the route rules</td>
-      <td>Artificial Limitador condition injected to bind routes and corresponding limits</td>
-      <td>
-        <ul>
-          <li>Ensure the limit is enforced only for corresponding selected HTTPRouteRules</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td><code>translate(spec.rateLimits.rules) ⊂ httproute.spec.rules</code></a></td>
-      <td><code>spec.limits.&lt;limit-name&gt.routeSelectors.matches ⊆ httproute.spec.rules.matches</code></td>
-      <td>
-        <ul>
-          <li>HTTPRouteRule selector (via HTTPRouteMatch subset)</li>
-          <li>Gateway API language</li>
-          <li>Preparation for inherited policies and defaults & overrides</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td><code>spec.rateLimits.limits.seconds</code></td>
-      <td><code>spec.limits.&lt;limit-name&gt.rates.duration</code> and <code>spec.limits.&lt;limit-name&gt.rates.unit</code></td>
-      <td>
-        <ul>
-          <li>Support for more units beyond seconds</li>
-          <li><code>duration: 1</code> by default</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td><code>spec.rateLimits.limits.variables</code></td>
-      <td><code>spec.limits.&lt;limit-name&gt.counters</code></td>
-      <td>
-        <ul>
-          <li>Improved (more specific) naming</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td><code>spec.rateLimits.limits.maxValue</code></td>
-      <td><code>spec.limits.&lt;limit-name&gt.rates.limit</code></td>
-      <td>
-        <ul>
-          <li>Improved (more generic) naming</li>
-        </ul>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<h2 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h2>
-<p>By completely dropping out the <code>configurations</code> field from the RLP, <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter#composing-actions">composing the RL descriptor actions</a> is now done based essentially on the selectors listed in the <code>when</code> conditions and the <code>counters</code>, plus an artificial condition used to bind the HTTPRouteRules to the corresponding limits to trigger in Limitador.</p>
-<p>The descriptor actions composed from the selectors in the "soft" <code>when</code> conditions and counter qualifiers originate from the direct references these selectors make to paths within a well-known data structure that stores information about the context (HTTP request and ext-authz filter). These selectors in "soft" <code>when</code> conditions and counter qualifiers are thereby called <em>well-known selectors</em>.</p>
-<p>Other descriptor actions might be composed by the RLP controller to define additional RL conditions to bind HTTPRouteRules and corresponding limits.</p>
-<h3 id="well-known-selectors">Well-known selectors<a class="headerlink" href="#well-known-selectors" title="Permanent link">&para;</a></h3>
-<p>Each selector used in a <code>when</code> condition or counter qualifier is a direct reference to a path within a well-known data structure that stores information about the <code>context</code> (L4 and L7 data of the original request handled by the proxy), as well as <code>auth</code> data (dynamic metadata occasionally exported by the external authorization filter and injected by the proxy into the rate-limit filter).</p>
-<p>The well-known data structure for building RL descriptor actions resembles Authorino's <a href="https://github.com/Kuadrant/authorino/blob/main/docs/architecture.md#the-authorization-json">"Authorization JSON"</a>, whose <code>context</code> component consists of Envoy's <a href="https://pkg.go.dev/github.com/envoyproxy/go-control-plane/envoy/service/auth/v3?utm_source=gopls#AttributeContext"><code>AttributeContext</code></a> type of the external authorization API (marshalled as JSON). Compared to the more generic <a href="https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0/envoy/service/ratelimit/v3#RateLimitRequest"><code>RateLimitRequest</code></a> struct, the <code>AttributeContext</code> provides a more structured and arguibly more intuitive relation between the data sources for the RL descriptors actions and their corresponding key names through which the values are referred within the RLP, in a context of predominantly serving for HTTP applications.</p>
-<p>To keep compatibility with the <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter">Envoy Rate Limit API</a>, the well-known data structure can optionally be extended with the <code>RateLimitRequest</code>, thus resulting in the following final structure.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-28-1"><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a><span class="nt">context</span><span class="p">:</span><span class="w"> </span><span class="c1"># Envoy&#39;s Ext-Authz `CheckRequest.AttributeContext` type</span>
-</span><span id="__span-28-2"><a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a><span class="w">  </span><span class="nt">source</span><span class="p">:</span>
-</span><span id="__span-28-3"><a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a><span class="w">    </span><span class="nt">address</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-4"><a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a><span class="w">    </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-5"><a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a><span class="w">    </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-6"><a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a><span class="w">  </span><span class="nt">destination</span><span class="p">:</span>
-</span><span id="__span-28-7"><a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a><span class="w">    </span><span class="nt">address</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-8"><a id="__codelineno-28-8" name="__codelineno-28-8" href="#__codelineno-28-8"></a><span class="w">    </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-9"><a id="__codelineno-28-9" name="__codelineno-28-9" href="#__codelineno-28-9"></a><span class="w">    </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-10"><a id="__codelineno-28-10" name="__codelineno-28-10" href="#__codelineno-28-10"></a><span class="w">  </span><span class="nt">request</span><span class="p">:</span>
-</span><span id="__span-28-11"><a id="__codelineno-28-11" name="__codelineno-28-11" href="#__codelineno-28-11"></a><span class="w">    </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-28-12"><a id="__codelineno-28-12" name="__codelineno-28-12" href="#__codelineno-28-12"></a><span class="w">      </span><span class="nt">host</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-13"><a id="__codelineno-28-13" name="__codelineno-28-13" href="#__codelineno-28-13"></a><span class="w">      </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-14"><a id="__codelineno-28-14" name="__codelineno-28-14" href="#__codelineno-28-14"></a><span class="w">      </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-28-15"><a id="__codelineno-28-15" name="__codelineno-28-15" href="#__codelineno-28-15"></a><span class="w">      </span><span class="nt">headers</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-28-16"><a id="__codelineno-28-16" name="__codelineno-28-16" href="#__codelineno-28-16"></a>
-</span><span id="__span-28-17"><a id="__codelineno-28-17" name="__codelineno-28-17" href="#__codelineno-28-17"></a><span class="nt">auth</span><span class="p">:</span><span class="w"> </span><span class="c1"># Dynamic metadata exported by the external authorization service</span>
-</span><span id="__span-28-18"><a id="__codelineno-28-18" name="__codelineno-28-18" href="#__codelineno-28-18"></a>
-</span><span id="__span-28-19"><a id="__codelineno-28-19" name="__codelineno-28-19" href="#__codelineno-28-19"></a><span class="nt">ratelimit</span><span class="p">:</span><span class="w"> </span><span class="c1"># Envoy&#39;s Rate Limit `RateLimitRequest` type</span>
-</span><span id="__span-28-20"><a id="__codelineno-28-20" name="__codelineno-28-20" href="#__codelineno-28-20"></a><span class="w">  </span><span class="nt">domain</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span><span class="w"> </span><span class="c1"># generated by the Kuadrant controller</span>
-</span><span id="__span-28-21"><a id="__codelineno-28-21" name="__codelineno-28-21" href="#__codelineno-28-21"></a><span class="w">  </span><span class="nt">descriptors</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span><span class="w"> </span><span class="c1"># descriptors configured by the user directly in the proxy (not generated by the Kuadrant controller, if allowed)</span>
-</span><span id="__span-28-22"><a id="__codelineno-28-22" name="__codelineno-28-22" href="#__codelineno-28-22"></a><span class="w">  </span><span class="nt">hitsAddend</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">…</span><span class="w"> </span><span class="c1"># only in case we want to allow users to refer to this value in a policy</span>
-</span></code></pre></div>
-<h3 id="mechanics-of-generating-rl-descriptor-actions">Mechanics of generating RL descriptor actions<a class="headerlink" href="#mechanics-of-generating-rl-descriptor-actions" title="Permanent link">&para;</a></h3>
-<p>From the perspective of a user who writes a RLP, the selectors used in then <code>when</code> and <code>counters</code> fields are paths to the well-known data structure (see <a href="#well-known-selectors"><em>Well-known selectors</em></a>). While desiging a policy, the user intuitively pictures the well-known data structure and states each limit definition having in mind the possible values assumed by each of those paths in the data plane. For example,</p>
-<p>The user story:</p>
-<blockquote>
-<p><em>Each distinct user (<code>auth.identity.username</code>) can send no more than 1rps to the same HTTP path (<code>context.request.http.path</code>).</em></p>
-</blockquote>
-<p>...materializes as the following RLP:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-29-1"><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-29-2"><a id="__codelineno-29-2" name="__codelineno-29-2" href="#__codelineno-29-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-29-3"><a id="__codelineno-29-3" name="__codelineno-29-3" href="#__codelineno-29-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-29-4"><a id="__codelineno-29-4" name="__codelineno-29-4" href="#__codelineno-29-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-29-5"><a id="__codelineno-29-5" name="__codelineno-29-5" href="#__codelineno-29-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-29-6"><a id="__codelineno-29-6" name="__codelineno-29-6" href="#__codelineno-29-6"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-29-7"><a id="__codelineno-29-7" name="__codelineno-29-7" href="#__codelineno-29-7"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-29-8"><a id="__codelineno-29-8" name="__codelineno-29-8" href="#__codelineno-29-8"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-29-9"><a id="__codelineno-29-9" name="__codelineno-29-9" href="#__codelineno-29-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-29-10"><a id="__codelineno-29-10" name="__codelineno-29-10" href="#__codelineno-29-10"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-29-11"><a id="__codelineno-29-11" name="__codelineno-29-11" href="#__codelineno-29-11"></a><span class="w">    </span><span class="nt">dolls</span><span class="p">:</span>
-</span><span id="__span-29-12"><a id="__codelineno-29-12" name="__codelineno-29-12" href="#__codelineno-29-12"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-29-13"><a id="__codelineno-29-13" name="__codelineno-29-13" href="#__codelineno-29-13"></a>
-</span><span id="__span-29-14"><a id="__codelineno-29-14" name="__codelineno-29-14" href="#__codelineno-29-14"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-29-15"><a id="__codelineno-29-15" name="__codelineno-29-15" href="#__codelineno-29-15"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-29-16"><a id="__codelineno-29-16" name="__codelineno-29-16" href="#__codelineno-29-16"></a><span class="w">      </span><span class="nt">counters</span><span class="p">:</span>
-</span><span id="__span-29-17"><a id="__codelineno-29-17" name="__codelineno-29-17" href="#__codelineno-29-17"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-29-18"><a id="__codelineno-29-18" name="__codelineno-29-18" href="#__codelineno-29-18"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span></code></pre></div>
-<p>The following selectors are to be interpreted by the RLP controller:</p>
-<ul>
-<li><code>auth.identity.username</code></li>
-<li><code>context.request.http.path</code></li>
-</ul>
-<p>The RLP controller uses a map to translate each selector into its corresponding descriptor action. (Roughly described:)</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-30-1"><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a>context.source.address    → source_cluster(...) # TBC
-</span><span id="__span-30-2"><a id="__codelineno-30-2" name="__codelineno-30-2" href="#__codelineno-30-2"></a>context.source.service    → source_cluster(...) # TBC
-</span><span id="__span-30-3"><a id="__codelineno-30-3" name="__codelineno-30-3" href="#__codelineno-30-3"></a>context.destination...    → destination_cluster(...)
-</span><span id="__span-30-4"><a id="__codelineno-30-4" name="__codelineno-30-4" href="#__codelineno-30-4"></a>context.destination...    → destination_cluster(...)
-</span><span id="__span-30-5"><a id="__codelineno-30-5" name="__codelineno-30-5" href="#__codelineno-30-5"></a>context.request.http.&lt;X&gt;  → request_headers(header_name: &quot;:&lt;X&gt;&quot;)
-</span><span id="__span-30-6"><a id="__codelineno-30-6" name="__codelineno-30-6" href="#__codelineno-30-6"></a>context.request...        → ...
-</span><span id="__span-30-7"><a id="__codelineno-30-7" name="__codelineno-30-7" href="#__codelineno-30-7"></a>auth.&lt;X&gt;                  → metadata(key: &quot;envoy.filters.http.ext_authz&quot;, path: &lt;X&gt;)
-</span><span id="__span-30-8"><a id="__codelineno-30-8" name="__codelineno-30-8" href="#__codelineno-30-8"></a>ratelimit.domain          → &lt;hostname&gt;
-</span></code></pre></div>
-<p>...to yield effectively:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-31-1"><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a><span class="nt">rate_limits</span><span class="p">:</span>
-</span><span id="__span-31-2"><a id="__codelineno-31-2" name="__codelineno-31-2" href="#__codelineno-31-2"></a>
-</span><span id="__span-31-3"><a id="__codelineno-31-3" name="__codelineno-31-3" href="#__codelineno-31-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-31-4"><a id="__codelineno-31-4" name="__codelineno-31-4" href="#__codelineno-31-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-31-5"><a id="__codelineno-31-5" name="__codelineno-31-5" href="#__codelineno-31-5"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;auth.identity.username&quot;</span>
-</span><span id="__span-31-6"><a id="__codelineno-31-6" name="__codelineno-31-6" href="#__codelineno-31-6"></a><span class="w">      </span><span class="nt">metadata_key</span><span class="p">:</span>
-</span><span id="__span-31-7"><a id="__codelineno-31-7" name="__codelineno-31-7" href="#__codelineno-31-7"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;envoy.filters.http.ext_authz&quot;</span>
-</span><span id="__span-31-8"><a id="__codelineno-31-8" name="__codelineno-31-8" href="#__codelineno-31-8"></a><span class="w">        </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-31-9"><a id="__codelineno-31-9" name="__codelineno-31-9" href="#__codelineno-31-9"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-31-10"><a id="__codelineno-31-10" name="__codelineno-31-10" href="#__codelineno-31-10"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;identity&quot;</span>
-</span><span id="__span-31-11"><a id="__codelineno-31-11" name="__codelineno-31-11" href="#__codelineno-31-11"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-31-12"><a id="__codelineno-31-12" name="__codelineno-31-12" href="#__codelineno-31-12"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;username&quot;</span>
-</span><span id="__span-31-13"><a id="__codelineno-31-13" name="__codelineno-31-13" href="#__codelineno-31-13"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">request_headers</span><span class="p">:</span>
-</span><span id="__span-31-14"><a id="__codelineno-31-14" name="__codelineno-31-14" href="#__codelineno-31-14"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;context.request.http.path&quot;</span>
-</span><span id="__span-31-15"><a id="__codelineno-31-15" name="__codelineno-31-15" href="#__codelineno-31-15"></a><span class="w">      </span><span class="nt">header_name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;:path&quot;</span>
-</span></code></pre></div>
-<h3 id="artificial-limitador-condition-for-routeselectors">Artificial Limitador condition for <code>routeSelectors</code><a class="headerlink" href="#artificial-limitador-condition-for-routeselectors" title="Permanent link">&para;</a></h3>
-<p>For each limit definition that explicitly or implicitly defines a <code>routeSelectors</code> field, the RLP controller will generate an artificial Limitador condition that ensures that the limit applies only when the filterred rules are honoured when serving the request. This can be implemented with a 2-step procedure:</p>
-<ol>
-<li>generate an unique identifier of the limit - i.e. <code>&lt;policy-namespace&gt;/&lt;policy-name&gt;/&lt;limit-name&gt;</code></li>
-<li>associate a <code>generic_key</code> type descriptor action with each <code>HTTPRouteRule</code> targeted by the limit – i.e. <code>{ descriptor_key: &lt;unique identifier of the limit&gt;, descriptor_value: "1" }</code>.</li>
-</ol>
-<p>For example, given the following RLP:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-32-1"><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-32-2"><a id="__codelineno-32-2" name="__codelineno-32-2" href="#__codelineno-32-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-32-3"><a id="__codelineno-32-3" name="__codelineno-32-3" href="#__codelineno-32-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-32-4"><a id="__codelineno-32-4" name="__codelineno-32-4" href="#__codelineno-32-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-non-admin-users</span>
-</span><span id="__span-32-5"><a id="__codelineno-32-5" name="__codelineno-32-5" href="#__codelineno-32-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-32-6"><a id="__codelineno-32-6" name="__codelineno-32-6" href="#__codelineno-32-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-32-7"><a id="__codelineno-32-7" name="__codelineno-32-7" href="#__codelineno-32-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-32-8"><a id="__codelineno-32-8" name="__codelineno-32-8" href="#__codelineno-32-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-32-9"><a id="__codelineno-32-9" name="__codelineno-32-9" href="#__codelineno-32-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-32-10"><a id="__codelineno-32-10" name="__codelineno-32-10" href="#__codelineno-32-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-32-11"><a id="__codelineno-32-11" name="__codelineno-32-11" href="#__codelineno-32-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-32-12"><a id="__codelineno-32-12" name="__codelineno-32-12" href="#__codelineno-32-12"></a><span class="w">    </span><span class="nt">toys</span><span class="p">:</span>
-</span><span id="__span-32-13"><a id="__codelineno-32-13" name="__codelineno-32-13" href="#__codelineno-32-13"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-32-14"><a id="__codelineno-32-14" name="__codelineno-32-14" href="#__codelineno-32-14"></a>
-</span><span id="__span-32-15"><a id="__codelineno-32-15" name="__codelineno-32-15" href="#__codelineno-32-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-32-16"><a id="__codelineno-32-16" name="__codelineno-32-16" href="#__codelineno-32-16"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-32-17"><a id="__codelineno-32-17" name="__codelineno-32-17" href="#__codelineno-32-17"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-32-18"><a id="__codelineno-32-18" name="__codelineno-32-18" href="#__codelineno-32-18"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-32-19"><a id="__codelineno-32-19" name="__codelineno-32-19" href="#__codelineno-32-19"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-32-20"><a id="__codelineno-32-20" name="__codelineno-32-20" href="#__codelineno-32-20"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-32-21"><a id="__codelineno-32-21" name="__codelineno-32-21" href="#__codelineno-32-21"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-32-22"><a id="__codelineno-32-22" name="__codelineno-32-22" href="#__codelineno-32-22"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-32-23"><a id="__codelineno-32-23" name="__codelineno-32-23" href="#__codelineno-32-23"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-32-24"><a id="__codelineno-32-24" name="__codelineno-32-24" href="#__codelineno-32-24"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-32-25"><a id="__codelineno-32-25" name="__codelineno-32-25" href="#__codelineno-32-25"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-32-26"><a id="__codelineno-32-26" name="__codelineno-32-26" href="#__codelineno-32-26"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-32-27"><a id="__codelineno-32-27" name="__codelineno-32-27" href="#__codelineno-32-27"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">minute</span>
-</span><span id="__span-32-28"><a id="__codelineno-32-28" name="__codelineno-32-28" href="#__codelineno-32-28"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-32-29"><a id="__codelineno-32-29" name="__codelineno-32-29" href="#__codelineno-32-29"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.group</span>
-</span><span id="__span-32-30"><a id="__codelineno-32-30" name="__codelineno-32-30" href="#__codelineno-32-30"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-32-31"><a id="__codelineno-32-31" name="__codelineno-32-31" href="#__codelineno-32-31"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-32-32"><a id="__codelineno-32-32" name="__codelineno-32-32" href="#__codelineno-32-32"></a>
-</span><span id="__span-32-33"><a id="__codelineno-32-33" name="__codelineno-32-33" href="#__codelineno-32-33"></a><span class="w">    </span><span class="nt">assets</span><span class="p">:</span>
-</span><span id="__span-32-34"><a id="__codelineno-32-34" name="__codelineno-32-34" href="#__codelineno-32-34"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-32-35"><a id="__codelineno-32-35" name="__codelineno-32-35" href="#__codelineno-32-35"></a>
-</span><span id="__span-32-36"><a id="__codelineno-32-36" name="__codelineno-32-36" href="#__codelineno-32-36"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-32-37"><a id="__codelineno-32-37" name="__codelineno-32-37" href="#__codelineno-32-37"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-32-38"><a id="__codelineno-32-38" name="__codelineno-32-38" href="#__codelineno-32-38"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-32-39"><a id="__codelineno-32-39" name="__codelineno-32-39" href="#__codelineno-32-39"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/assets/&quot;</span>
-</span><span id="__span-32-40"><a id="__codelineno-32-40" name="__codelineno-32-40" href="#__codelineno-32-40"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-32-41"><a id="__codelineno-32-41" name="__codelineno-32-41" href="#__codelineno-32-41"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-32-42"><a id="__codelineno-32-42" name="__codelineno-32-42" href="#__codelineno-32-42"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-32-43"><a id="__codelineno-32-43" name="__codelineno-32-43" href="#__codelineno-32-43"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">minute</span>
-</span><span id="__span-32-44"><a id="__codelineno-32-44" name="__codelineno-32-44" href="#__codelineno-32-44"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-32-45"><a id="__codelineno-32-45" name="__codelineno-32-45" href="#__codelineno-32-45"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.group</span>
-</span><span id="__span-32-46"><a id="__codelineno-32-46" name="__codelineno-32-46" href="#__codelineno-32-46"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-32-47"><a id="__codelineno-32-47" name="__codelineno-32-47" href="#__codelineno-32-47"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span></code></pre></div>
-<p>Apart from the following descriptor action associated with both routes:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-33-1"><a id="__codelineno-33-1" name="__codelineno-33-1" href="#__codelineno-33-1"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-33-2"><a id="__codelineno-33-2" name="__codelineno-33-2" href="#__codelineno-33-2"></a><span class="w">    </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;auth.identity.group&quot;</span>
-</span><span id="__span-33-3"><a id="__codelineno-33-3" name="__codelineno-33-3" href="#__codelineno-33-3"></a><span class="w">    </span><span class="nt">metadata_key</span><span class="p">:</span>
-</span><span id="__span-33-4"><a id="__codelineno-33-4" name="__codelineno-33-4" href="#__codelineno-33-4"></a><span class="w">      </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;envoy.filters.http.ext_authz&quot;</span>
-</span><span id="__span-33-5"><a id="__codelineno-33-5" name="__codelineno-33-5" href="#__codelineno-33-5"></a><span class="w">      </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-33-6"><a id="__codelineno-33-6" name="__codelineno-33-6" href="#__codelineno-33-6"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-33-7"><a id="__codelineno-33-7" name="__codelineno-33-7" href="#__codelineno-33-7"></a><span class="w">          </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;identity&quot;</span>
-</span><span id="__span-33-8"><a id="__codelineno-33-8" name="__codelineno-33-8" href="#__codelineno-33-8"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">segment</span><span class="p">:</span>
-</span><span id="__span-33-9"><a id="__codelineno-33-9" name="__codelineno-33-9" href="#__codelineno-33-9"></a><span class="w">          </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;group&quot;</span>
-</span></code></pre></div>
-<p>...and its corresponding Limitador condition:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-34-1"><a id="__codelineno-34-1" name="__codelineno-34-1" href="#__codelineno-34-1"></a>auth.identity.group != &quot;admin&quot;
-</span></code></pre></div>
-<p>The following additional artificial descriptor actions will be generated:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-35-1"><a id="__codelineno-35-1" name="__codelineno-35-1" href="#__codelineno-35-1"></a><span class="c1"># associated with route rule GET|POST /toys*</span>
-</span><span id="__span-35-2"><a id="__codelineno-35-2" name="__codelineno-35-2" href="#__codelineno-35-2"></a>
-</span><span id="__span-35-3"><a id="__codelineno-35-3" name="__codelineno-35-3" href="#__codelineno-35-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-35-4"><a id="__codelineno-35-4" name="__codelineno-35-4" href="#__codelineno-35-4"></a><span class="w">    </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-non-admin-users/toys&quot;</span>
-</span><span id="__span-35-5"><a id="__codelineno-35-5" name="__codelineno-35-5" href="#__codelineno-35-5"></a><span class="w">    </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-35-6"><a id="__codelineno-35-6" name="__codelineno-35-6" href="#__codelineno-35-6"></a>
-</span><span id="__span-35-7"><a id="__codelineno-35-7" name="__codelineno-35-7" href="#__codelineno-35-7"></a><span class="c1"># associated with route rule /assets/*</span>
-</span><span id="__span-35-8"><a id="__codelineno-35-8" name="__codelineno-35-8" href="#__codelineno-35-8"></a>
-</span><span id="__span-35-9"><a id="__codelineno-35-9" name="__codelineno-35-9" href="#__codelineno-35-9"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-35-10"><a id="__codelineno-35-10" name="__codelineno-35-10" href="#__codelineno-35-10"></a><span class="w">    </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-non-admin-users/assets&quot;</span>
-</span><span id="__span-35-11"><a id="__codelineno-35-11" name="__codelineno-35-11" href="#__codelineno-35-11"></a><span class="w">    </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-<p>...and their corresponding Limitador conditions.</p>
-<p>In the end, the following Limitador configuration is yielded:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-36-1"><a id="__codelineno-36-1" name="__codelineno-36-1" href="#__codelineno-36-1"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-36-2"><a id="__codelineno-36-2" name="__codelineno-36-2" href="#__codelineno-36-2"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-non-admin-users/toys == &quot;1&quot;</span>
-</span><span id="__span-36-3"><a id="__codelineno-36-3" name="__codelineno-36-3" href="#__codelineno-36-3"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.group != &quot;admin&quot;</span>
-</span><span id="__span-36-4"><a id="__codelineno-36-4" name="__codelineno-36-4" href="#__codelineno-36-4"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-36-5"><a id="__codelineno-36-5" name="__codelineno-36-5" href="#__codelineno-36-5"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-36-6"><a id="__codelineno-36-6" name="__codelineno-36-6" href="#__codelineno-36-6"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span><span id="__span-36-7"><a id="__codelineno-36-7" name="__codelineno-36-7" href="#__codelineno-36-7"></a>
-</span><span id="__span-36-8"><a id="__codelineno-36-8" name="__codelineno-36-8" href="#__codelineno-36-8"></a>
-</span><span id="__span-36-9"><a id="__codelineno-36-9" name="__codelineno-36-9" href="#__codelineno-36-9"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-36-10"><a id="__codelineno-36-10" name="__codelineno-36-10" href="#__codelineno-36-10"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-non-admin-users/assets == &quot;1&quot;</span>
-</span><span id="__span-36-11"><a id="__codelineno-36-11" name="__codelineno-36-11" href="#__codelineno-36-11"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.group != &quot;admin&quot;</span>
-</span><span id="__span-36-12"><a id="__codelineno-36-12" name="__codelineno-36-12" href="#__codelineno-36-12"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-36-13"><a id="__codelineno-36-13" name="__codelineno-36-13" href="#__codelineno-36-13"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-36-14"><a id="__codelineno-36-14" name="__codelineno-36-14" href="#__codelineno-36-14"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span></code></pre></div>
-<h3 id="support-in-wasm-shim-and-envoy-rl-api">Support in wasm shim and Envoy RL API<a class="headerlink" href="#support-in-wasm-shim-and-envoy-rl-api" title="Permanent link">&para;</a></h3>
-<p>This proposal tries to keep compatibility with the <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter">Envoy API for rate limit</a> and does not introduce any new requirement that otherwise would require the use of <a href="https://github.com/Kuadrant/wasm-shim">wasm shim</a> to be implemented.</p>
-<p>In the case of implementation of this proposal in the wasm shim, all types of matchers supported by the <a href="https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1beta1.HTTPRouteMatch">HTTPRouteMatch</a> type of Gateway API must be also supported in the <code>rate_limit_policies.gateway_actions.rules</code> field of the <a href="https://github.com/Kuadrant/kuadrant-operator/blob/faf41ff6b08df27946a663c34a5736476578dea5/pkg/rlptools/wasm_utils.go#L109">wasm plugin configuration</a>. These include matchers based on path (prefix, exact), headers, query string parameters and method.</p>
-<h2 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h2>
-<p><strong>HTTPRoute editing occasionally required</strong><br/>
-Need to duplicate rules that don't explicitly include a matcher wanted for the policy, so that matcher can be added as a special case for each of those rules.</p>
-<p><strong>Risk of over-targeting</strong><br/>
-Some HTTPRouteRules might need to be split into more specific ones so a limit definition is not bound to beyond intended (e.g. target <code>method: GET</code> when the route matches <code>method: POST|GET</code>).</p>
-<p><strong>Prone to consistency issues</strong><br/>
-Typos and updates to the HTTPRoute can easily cause a mismatch and invalidate a RLP.</p>
-<p><strong>Two types of conditions – <code>routeSelectors</code> and <code>when</code> conditions</strong><br/>
-Although with different meanings (evaluates in the gateway vs. evaluated in Limitador) and meant for expressing different types of rules (HTTPRouteRule selectors vs. "soft" conditions based on attributes not related to the HTTP request), users might still perceive these as two ways of expressing conditions and find difficult to understand at first that "soft" conditions do not accept expressions related to attributes of the HTTP request.</p>
-<h2 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h2>
-<h3 id="targeting-full-httprouterules">Targeting full HTTPRouteRules<a class="headerlink" href="#targeting-full-httprouterules" title="Permanent link">&para;</a></h3>
-<p>Requiring users to specify full HTTPRouteRule matches in the RLP (as opposed to any subset of HTTPRoureMatches of targeted HTTPRouteRules – current proposal) contains some of the same <a href="#drawbacks">drawbacks</a> of this proposal, such as HTTPRoute editing occasionally required and prone to consistency issues. If, on one hand, it eliminates the risk of over-targeting, on the other hand, it does it at the cost of requiring excessively verbose policies written by the users, to the point of sometimes expecting user to have to specify trigger matching rules that are significantly more than what's originally and strictly intended.</p>
-<p>E.g.:</p>
-<p>On a HTTPRoute that contains the following HTTPRouteRules (simplified representation):</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-37-1"><a id="__codelineno-37-1" name="__codelineno-37-1" href="#__codelineno-37-1"></a>{ header: x-canary=true } → backend-canary
-</span><span id="__span-37-2"><a id="__codelineno-37-2" name="__codelineno-37-2" href="#__codelineno-37-2"></a>{ * } → backend-rest
-</span></code></pre></div>
-<p>Where the user wants to define a RLP that targets <code>{ method: POST }</code>. First, the user needs to edit the HTTPRoute and duplicate the HTTPRouteRules:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-38-1"><a id="__codelineno-38-1" name="__codelineno-38-1" href="#__codelineno-38-1"></a>{ header: x-canary=true, method: POST } → backend-canary
-</span><span id="__span-38-2"><a id="__codelineno-38-2" name="__codelineno-38-2" href="#__codelineno-38-2"></a>{ header: x-canary=true } → backend-canary
-</span><span id="__span-38-3"><a id="__codelineno-38-3" name="__codelineno-38-3" href="#__codelineno-38-3"></a>{ method: POST } → backend-rest
-</span><span id="__span-38-4"><a id="__codelineno-38-4" name="__codelineno-38-4" href="#__codelineno-38-4"></a>{ * } → backend-rest
-</span></code></pre></div>
-<p>Then, user needs to include the following trigger in the RLP so only full HTTPRouteRules are specified:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-39-1"><a id="__codelineno-39-1" name="__codelineno-39-1" href="#__codelineno-39-1"></a>{ header: x-canary=true, method: POST }
-</span><span id="__span-39-2"><a id="__codelineno-39-2" name="__codelineno-39-2" href="#__codelineno-39-2"></a>{ method: POST }
-</span></code></pre></div>
-<p>The first matching rule of the trigger (i.e. <code>{ header: x-canary=true, method: POST }</code>) is beoynd the original user intent of targeting simply <code>{ method: POST }</code>.</p>
-<p>This issue can be even more concerning in the case of targeting gateways with multiple child HTTPRoutes. All the HTTPRoutes would have to be fixed and the HTTPRouteRules that cover for all the cases in all HTTPRoutes listed in the policy targeting the gateway.</p>
-<h3 id="all-limit-definitions-apply-vs-limit-shadowing">All limit definitions apply vs. Limit "shadowing"<a class="headerlink" href="#all-limit-definitions-apply-vs-limit-shadowing" title="Permanent link">&para;</a></h3>
-<p>The proposed <a href="#artificial-limitador-condition-for-routeselectors">binding between limit definition and HTTPRouteRules that trigger the limits</a> was thought so multiple limit definitions can be bound to a same HTTPRouteRule that triggers those limits in Limitador. That means that no limit definition will "shadow" another at the level of the RLP controller, i.e. the RLP controller will honour the intended binding according to the selectors specified in the policy.</p>
-<p>Due to how things work as of today in Limitador nonetheless, i.e., the rule of the most restrictive limit wins, and because all limit definitions triggered by a given shared HTTPRouteRule, it might be the case that, across multiple limits triggered, one limit ends up "shadowing" other limits. However, that is by implementation of Limitador and therefore beyond the scope of the API.</p>
-<p>An alternative to the approach of allowing all limit definitions to be bound to a same selected HTTPRouteRules would be enforcing that, amongst multiple limit definitions targeting a same HTTPRouteRule, only the first of those limits definitions is bound to the HTTPRouteRule. This alternative approach effectively would cause the first limit to "shadow" any other on that particular HTTPRouteRule, as by implementation of the RLP controller (i.e., at API level).</p>
-<p>While the first approach causes an artificial Limitador condition of the form <code>&lt;policy-ns&gt;/&lt;policy-name&gt;/&lt;limit-name&gt; == "1"</code>, the alternative approach ("limit shadowing") could be implemented by generating a descriptor of the following form instead: <code>ratelimit.binding == "&lt;policy-ns&gt;/&lt;policy-name&gt;/&lt;limit-name&gt;"</code>.</p>
-<p>The downside of allowing multiple bindings to the same HTTPRouteRule is that all limits apply in Limitador, thus making status report frequently harder. The most restritive rate limit strategy implemented by Limitador might not be obvious to users who set multiple limit definitions and will require additional information reported back to the user about the actual status of the limit definitions stated in a RLP. On the other hand, it allows enables use cases of different limit definitions that vary on the counter qualifiers, additional "soft" conditions, or actual rate limit values to be triggered by a same HTTPRouteRule.</p>
-<h3 id="writing-soft-when-conditions-based-on-attributes-of-the-http-request">Writing "soft" <code>when</code> conditions based on attributes of the HTTP request<a class="headerlink" href="#writing-soft-when-conditions-based-on-attributes-of-the-http-request" title="Permanent link">&para;</a></h3>
-<p>As a first step, users will not be able to write "soft" <code>when</code> conditions to selective apply rate limit definitions based on attributes of the HTTP request that otherwise could be specified using the <code>routeSelectors</code> field of the RLP instead.</p>
-<p>On one hand, using <code>when</code> conditions for route filtering would make it easy to define limits when the HTTPRoute cannot be modified to include the special rule. On the other hand, users would miss information in the status. An HTTPRouteRule for <code>GET|POST /toys*</code>, for example, that is targeted with an additional "soft" <code>when</code> condition that specifies that the method must be equal to <code>GET</code> and the path exactly equal to <code>/toys/special</code> (see <a href="#example-3-targeting-a-subset-of-an-httprouterule---httproutematch-missing">Example 3</a>) would be reported as rate limited with extra details that this is in fact only for <code>GET /toys/special</code>. For small deployments, this might be considered acceptable; however it would easily explode to unmanageable number of cases for deployments with only a few limit definitions and HTTPRouteRules.</p>
-<p>Moreover, by not specifying a more strict HTTPRouteRule for <code>GET /toys/special</code>, the RLP controller would bind the limit definition to other rules that would cause the rate limit filter to invoke the rate limit service (Limitador) for cases other than strictly <code>GET /toys/special</code>. Even if the rate limits would still be ensured to apply in Limitador only for <code>GET /toys/special</code> (due to the presence of a hypothetical "soft" <code>when</code> condition), an extra no-op hop to the rate limit service would happen. This is avoided with the current imposed limitation.</p>
-<p>Example of "soft" <code>when</code> conditions for rate limit based on attributes of the HTTP request (NOT SUPPORTED):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-40-1"><a id="__codelineno-40-1" name="__codelineno-40-1" href="#__codelineno-40-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v2beta1</span>
-</span><span id="__span-40-2"><a id="__codelineno-40-2" name="__codelineno-40-2" href="#__codelineno-40-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-40-3"><a id="__codelineno-40-3" name="__codelineno-40-3" href="#__codelineno-40-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-40-4"><a id="__codelineno-40-4" name="__codelineno-40-4" href="#__codelineno-40-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-special-toys</span>
-</span><span id="__span-40-5"><a id="__codelineno-40-5" name="__codelineno-40-5" href="#__codelineno-40-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-40-6"><a id="__codelineno-40-6" name="__codelineno-40-6" href="#__codelineno-40-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-40-7"><a id="__codelineno-40-7" name="__codelineno-40-7" href="#__codelineno-40-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-40-8"><a id="__codelineno-40-8" name="__codelineno-40-8" href="#__codelineno-40-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-40-9"><a id="__codelineno-40-9" name="__codelineno-40-9" href="#__codelineno-40-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-40-10"><a id="__codelineno-40-10" name="__codelineno-40-10" href="#__codelineno-40-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-40-11"><a id="__codelineno-40-11" name="__codelineno-40-11" href="#__codelineno-40-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-40-12"><a id="__codelineno-40-12" name="__codelineno-40-12" href="#__codelineno-40-12"></a><span class="w">    </span><span class="nt">specialToys</span><span class="p">:</span>
-</span><span id="__span-40-13"><a id="__codelineno-40-13" name="__codelineno-40-13" href="#__codelineno-40-13"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-40-14"><a id="__codelineno-40-14" name="__codelineno-40-14" href="#__codelineno-40-14"></a>
-</span><span id="__span-40-15"><a id="__codelineno-40-15" name="__codelineno-40-15" href="#__codelineno-40-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">150</span>
-</span><span id="__span-40-16"><a id="__codelineno-40-16" name="__codelineno-40-16" href="#__codelineno-40-16"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-40-17"><a id="__codelineno-40-17" name="__codelineno-40-17" href="#__codelineno-40-17"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-40-18"><a id="__codelineno-40-18" name="__codelineno-40-18" href="#__codelineno-40-18"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches the original HTTPRouteRule GET|POST /toys*</span>
-</span><span id="__span-40-19"><a id="__codelineno-40-19" name="__codelineno-40-19" href="#__codelineno-40-19"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-40-20"><a id="__codelineno-40-20" name="__codelineno-40-20" href="#__codelineno-40-20"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-40-21"><a id="__codelineno-40-21" name="__codelineno-40-21" href="#__codelineno-40-21"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/toys&quot;</span>
-</span><span id="__span-40-22"><a id="__codelineno-40-22" name="__codelineno-40-22" href="#__codelineno-40-22"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-40-23"><a id="__codelineno-40-23" name="__codelineno-40-23" href="#__codelineno-40-23"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-40-24"><a id="__codelineno-40-24" name="__codelineno-40-24" href="#__codelineno-40-24"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span><span class="w"> </span><span class="c1"># cannot omit this selector or POST /toys/special would also be rate limited</span>
-</span><span id="__span-40-25"><a id="__codelineno-40-25" name="__codelineno-40-25" href="#__codelineno-40-25"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-40-26"><a id="__codelineno-40-26" name="__codelineno-40-26" href="#__codelineno-40-26"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-40-27"><a id="__codelineno-40-27" name="__codelineno-40-27" href="#__codelineno-40-27"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-40-28"><a id="__codelineno-40-28" name="__codelineno-40-28" href="#__codelineno-40-28"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-40-29"><a id="__codelineno-40-29" name="__codelineno-40-29" href="#__codelineno-40-29"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/toys/special</span>
-</span></code></pre></div>
-<details>
-  <summary><sub>How is this RLP would be implemented under the hood if supported?</sub></summary>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-41-1"><a id="__codelineno-41-1" name="__codelineno-41-1" href="#__codelineno-41-1"></a><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-41-2"><a id="__codelineno-41-2" name="__codelineno-41-2" href="#__codelineno-41-2"></a>
-</span><span id="__span-41-3"><a id="__codelineno-41-3" name="__codelineno-41-3" href="#__codelineno-41-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-41-4"><a id="__codelineno-41-4" name="__codelineno-41-4" href="#__codelineno-41-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-41-5"><a id="__codelineno-41-5" name="__codelineno-41-5" href="#__codelineno-41-5"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-41-6"><a id="__codelineno-41-6" name="__codelineno-41-6" href="#__codelineno-41-6"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-41-7"><a id="__codelineno-41-7" name="__codelineno-41-7" href="#__codelineno-41-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/toys*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-41-8"><a id="__codelineno-41-8" name="__codelineno-41-8" href="#__codelineno-41-8"></a><span class="w">    </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;POST&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-41-9"><a id="__codelineno-41-9" name="__codelineno-41-9" href="#__codelineno-41-9"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.acme.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-41-10"><a id="__codelineno-41-10" name="__codelineno-41-10" href="#__codelineno-41-10"></a><span class="w">  </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-41-11"><a id="__codelineno-41-11" name="__codelineno-41-11" href="#__codelineno-41-11"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-41-12"><a id="__codelineno-41-12" name="__codelineno-41-12" href="#__codelineno-41-12"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;toystore/toystore-special-toys/specialToys&quot;</span>
-</span><span id="__span-41-13"><a id="__codelineno-41-13" name="__codelineno-41-13" href="#__codelineno-41-13"></a><span class="w">      </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-41-14"><a id="__codelineno-41-14" name="__codelineno-41-14" href="#__codelineno-41-14"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">request_headers</span><span class="p">:</span>
-</span><span id="__span-41-15"><a id="__codelineno-41-15" name="__codelineno-41-15" href="#__codelineno-41-15"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;context.request.http.method&quot;</span>
-</span><span id="__span-41-16"><a id="__codelineno-41-16" name="__codelineno-41-16" href="#__codelineno-41-16"></a><span class="w">      </span><span class="nt">header_name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;:method&quot;</span>
-</span><span id="__span-41-17"><a id="__codelineno-41-17" name="__codelineno-41-17" href="#__codelineno-41-17"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">request_headers</span><span class="p">:</span>
-</span><span id="__span-41-18"><a id="__codelineno-41-18" name="__codelineno-41-18" href="#__codelineno-41-18"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;context.request.http.path&quot;</span>
-</span><span id="__span-41-19"><a id="__codelineno-41-19" name="__codelineno-41-19" href="#__codelineno-41-19"></a><span class="w">      </span><span class="nt">header_name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;:path&quot;</span>
-</span></code></pre></div>
-
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-42-1"><a id="__codelineno-42-1" name="__codelineno-42-1" href="#__codelineno-42-1"></a><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-42-2"><a id="__codelineno-42-2" name="__codelineno-42-2" href="#__codelineno-42-2"></a>
-</span><span id="__span-42-3"><a id="__codelineno-42-3" name="__codelineno-42-3" href="#__codelineno-42-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-42-4"><a id="__codelineno-42-4" name="__codelineno-42-4" href="#__codelineno-42-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore/toystore-special-toys/specialToys == &quot;1&quot;</span>
-</span><span id="__span-42-5"><a id="__codelineno-42-5" name="__codelineno-42-5" href="#__codelineno-42-5"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method == &quot;GET&quot;</span>
-</span><span id="__span-42-6"><a id="__codelineno-42-6" name="__codelineno-42-6" href="#__codelineno-42-6"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path == &quot;/toys/special&quot;</span>
-</span><span id="__span-42-7"><a id="__codelineno-42-7" name="__codelineno-42-7" href="#__codelineno-42-7"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">150</span>
-</span><span id="__span-42-8"><a id="__codelineno-42-8" name="__codelineno-42-8" href="#__codelineno-42-8"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-42-9"><a id="__codelineno-42-9" name="__codelineno-42-9" href="#__codelineno-42-9"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant</span>
-</span></code></pre></div>
-</details>
-
-<h3 id="possible-variations-for-the-selectors-conditions-and-counter-qualifiers">Possible variations for the selectors (conditions and counter qualifiers)<a class="headerlink" href="#possible-variations-for-the-selectors-conditions-and-counter-qualifiers" title="Permanent link">&para;</a></h3>
-<p>The main drivers behind the proposed design for the selectors (conditions and counter qualifiers), based on (i) structured condition expressions composed of fields <code>selector</code>, <code>operator</code>, and <code>value</code>, and (ii) <code>when</code> conditions and <code>counters</code> separated in two distinct fields (variation "C" below), are:</p>
-<ol>
-<li>consistency with the Authorino <code>AuthConfig</code> API, which also specifies <a href="https://github.com/Kuadrant/authorino/blob/main/docs/features.md#common-feature-conditions-when"><code>when</code></a> conditions expressed in <code>selector</code>, <code>operator</code>, and <code>value</code> fields;</li>
-<li>explicit user intent, without subtle distinction of meaning based on presence of optional fields.</li>
-</ol>
-<p>Nonetheless here are a few alternative variations to consider:</p>
-<table>
-  <thead>
-    <tr>
-      <th></th>
-      <th>Structured condition expressions</th>
-      <th>Parsed condition expressions</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <th>Single field</th>
-      <td>
-        <b>A</b>
-        <pre>
-selectors:
-
-  - selector: context.request.http.method
-    operator: eq
-    value: GET
-  - selector: auth.identity.username</pre>
-      </td>
-      <td>
-        <b>B</b>
-        <pre>
-selectors:
-  - context.request.http.method == "GET"
-  - auth.identity.username</pre>
-      </td>
-    </tr>
-    <tr>
-      <th>Distinct fields</th>
-      <td>
-        <b>C <sup>⭐️</sup></b>
-        <pre>
-when:
-  - selector: context.request.http.method
-    operator: eq
-    value: GET
-counters:
-  - auth.identity.username</pre>
-      </td>
-      <td>
-        <b>D</b>
-        <pre>
-when:
-  - context.request.http.method == "GET"
-counters:
-  - auth.identity.username</pre>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><sup>⭐️ Variation adopted for the <a href="#examples-of-rlps-based-on-the-new-api">examples</a> and (so far) final design proposal.</sup></p>
-<h2 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h2>
-<p>Most implementations currently orbiting around Gateway API (e.g. Istio, Envoy Gateway, etc) for added RL functionality seem to have been leaning more to the direct route extension pattern instead of Policy Attachment. That might be an option particularly suitable for gateway implementations (gateway providers) and for those aiming to avoid dealing with defaults and overrides.</p>
-<h2 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h2>
-<ol>
-<li>In case a limit definition lists route selectors such that some can be bound to HTTPRouteRules and some cannot (see <a href="#example-6-multiple-limit-definitions-targeting-the-same-httprouterule">Example 6</a>), do we bind the valid route selectors and ignore the invalid ones or the limit definition is invalid altogether and bound to no HTTPRouteRule at all?<br/>
-   <strong><em>A:</em></strong> By allowing multiple limit definitions to target a same HTTPRouteRule, the issue here stated will become less often. For the other cases where a limit definition still fails to select an HTTPRouteRule (e.g. due to mismatching trigger matches), the limit definition is not considered invalid. Possibly the limit definitions is considered "stale" (or "orphan"), i.e., not bound to any HTTPRouteRule.</li>
-<li>What should we fill domain/namespace with, if no longer with the hostname? This can be useful for multi-tenancy.<br/>
-   <strong><em>A:</em></strong> For now, the domain/namespace field of the RL configuration (Envoy and Limitador ends) will be filled with a fixed (configurable) string (e.g. "kuadrant"). This can change in future to better support multi-tenancy and/or other use cases where a total sharding of the limit definitions within a same instance of Kuadrant is desired.</li>
-<li>How do we support lists of hostnames in Limitador conditions (single counter)? Should we open an issue for a new <code>in</code> operator?<br/>
-   <strong><em>A:</em></strong> Not needed. The hostnames must exist in the targeted object explicitly, just like any other routing rules intended to be targeted by a limit definition. By setting the explicit hostname in the targeted network object (Gateway or HTTPRoute), the also becomes a route rules available for "hard" trigger configuration.</li>
-<li>What "soft" condition <code>operator</code>s do we need to support (e.g. <code>eq</code>, <code>neq</code>, <code>exists</code>, <code>nexists</code>, <code>matches</code>)?</li>
-<li>Do we need special field to define shared counters across clusters/Limitador instances or that's to be solved at another layer (<code>Limitador</code>, <code>Kuadrant</code> CRDs, MCTC)?</li>
-</ol>
-<h2 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Port <code>routeSelectors</code> and the semantics around it to the <code>AuthPolicy</code> API (aka "KAP v2").</li>
-<li>Defaults and overrides, either along the lines of <a href="https://github.com/Kuadrant/architecture/pull/4">architecture#4</a> or <a href="https://github.com/Kuadrant/architecture/pull/10">architecture#10</a>.</li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0002-well-known-attributes/index.html b/0.10.0/architecture/rfcs/0002-well-known-attributes/index.html
deleted file mode 100644
index 7cbca85cf..000000000
--- a/0.10.0/architecture/rfcs/0002-well-known-attributes/index.html
+++ /dev/null
@@ -1,4059 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0002-well-known-attributes/">
-      
-      
-        <link rel="prev" href="../0001-rlp-v2/">
-      
-      
-        <link rel="next" href="../0003-dns-policy/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0002: Well-known Attributes - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#well-known-attributes" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0002: Well-known Attributes
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="well-known-attributes">Well-known Attributes<a class="headerlink" href="#well-known-attributes" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>well-known-attributes</code></li>
-<li>Start Date: 2023-06-13</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/17">Kuadrant/architecture#17</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/architecture/issues/53">Kuadrant/architecture#53</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>Define a well-known structure for users to declare request data selectors in their RateLimitPolicies and AuthPolicies. This structure is referred to as the Kuadrant <em>Well-known Attributes</em>.</p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>The well-known attributes let users write policy rules – conditions and, in general, dynamic values that refer to attributes in the data plane - in a concise and seamless way.</p>
-<p>Decoupled from the policy CRDs, the well-known attributes:</p>
-<ol>
-<li>define a common language for referring to values of the data plane in the Kuadrant policies;</li>
-<li>allow dynamically evolving the policy APIs regarding how they admit references to data plane attributes;</li>
-<li>encompass all common and component-specific selectors for data plane attributes;</li>
-<li>have a single and unified specification, although this specification may occasionally link to additional, component-specific, external docs.</li>
-</ol>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>One who writes a Kuadrant policy and wants to build policy constructs such as conditions, qualifiers, variables, etc, based on dynamic values of the data plane, must refer the attributes that carry those values, using the declarative language of Kuadrant's <em>Well-known Attributes</em>.</p>
-<p>A dynamic data plane value is typically a value of an attribute of the request or an <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/advanced/well_known_dynamic_metadata">Envoy Dynamic Metadata</a> entry. It can be a value of the outer request being handled by the API gateway or proxy that is managed by Kuadrant ("context request") or an attribute of the direct request to the Kuadrant component that delivers the functionality in the data plane (rate-limiting or external auth).</p>
-<p>A <em>Well-known Selector</em> is a construct of a policy API whose value contains a direct reference to a well-known attribute. The language of the well-known attributes and therefore what one would declare within a well-known selector resembles a JSON path for navigating a possibly complex JSON object.</p>
-<p><strong>Example 1.</strong> Well-known selector used in a condition</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiGroup</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">examples.kuadrant.io</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PaintPolicy</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.group</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">color</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">red</span>
-</span></code></pre></div>
-<p>In the example, <code>auth.identity.group</code> is a well-known selector of an attribute <code>group</code>, known to be injected by the external authorization service (<code>auth</code>) to describe the group the user (<code>identity</code>) belongs to. In the data plane, whenever this value is equal to <code>admin</code>, the abstract <code>PaintPolicy</code> policy states that the traffic must be painted <code>red</code>.</p>
-<p><strong>Example 2.</strong> Well-known selector used in a variable</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiGroup</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">examples.kuadrant.io</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PaintPolicy</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">color</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">red</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">    </span><span class="nt">alpha</span><span class="p">:</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">      </span><span class="nt">dynamic</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.headers.x-color-alpha</span>
-</span></code></pre></div>
-<p>In the example, <code>request.headers.x-color-alpha</code> is a selector of a well-known attribute <code>request.headers</code> that gives access to the headers of the context HTTP request. The selector retrieves the value of the <code>x-color-alpha</code> request header to dynamically fill the <code>alpha</code> property of the abstract <code>PaintPolicy</code> policy at each request.</p>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<p>The <em>Well-known Attributes</em> are a compilation inspired by some of the <a href="https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/advanced/attributes"><strong>Envoy attributes</strong></a> and Authorino's <a href="https://github.com/Kuadrant/authorino/blob/main/docs/architecture.md#the-authorization-json"><strong>Authorization JSON</strong></a> and its related <a href="https://github.com/Kuadrant/authorino/blob/main/docs/features.md#common-feature-json-paths-valuefromauthjson">JSON paths</a>.</p>
-<p>From the Envoy attributes, only attributes that are available before establishing connection with the upstream server qualify as a Kuadrant well-known attribute. This excludes attributes such as the response attributes and the upstream attributes.</p>
-<p>As for the attributes inherited from Authorino, these are either based on Envoy's <a href="https://pkg.go.dev/github.com/envoyproxy/go-control-plane/envoy/service/auth/v3?utm_source=gopls#AttributeContext"><code>AttributeContext</code></a> type of the external auth request API or from internal types defined by Authorino to fulfill the <a href="https://github.com/Kuadrant/authorino/blob/main/docs/architecture.md#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a>.</p>
-<p>These two subsets of attributes are unified into a single set of well-known attributes. For each attribute that exists in both subsets, the name of the attribute as specified in the Envoy attributes subset prevails. Example of such is <code>request.id</code> (to refer to the ID of the request) superseding <code>context.request.http.id</code> (as the same attribute is referred in an Authorino <a href="https://github.com/Kuadrant/authorino/blob/main/docs/architecture.md#the-authorino-authconfig-custom-resource-definition-crd"><code>AuthConfig</code></a>).</p>
-<p><br/></p>
-<p>The next sections specify the well-known attributes organized in the following groups:</p>
-<ul>
-<li><a href="#request-attributes">Request attributes</a></li>
-<li><a href="#connection-attributes">Connection attributes</a></li>
-<li><a href="#metadata-and-filter-state-attributes">Metadata and filter state attributes</a></li>
-<li><a href="#auth-attributes">Auth attributes</a></li>
-<li><a href="#rate-limit-attributes">Rate-limit attributes</a></li>
-</ul>
-<h2 id="request-attributes">Request attributes<a class="headerlink" href="#request-attributes" title="Permanent link">&para;</a></h2>
-<p>The following attributes are related to the context HTTP request that is handled by the API gateway or proxy managed by Kuadrant.</p>
-<table>
-  <thead>
-    <tr>
-      <th><p>Attribute</p></th>
-      <th><p>Type</p></th>
-      <th><p>Description</p></th>
-      <th><p>Auth</p></th>
-      <th><p>RL</p></th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><p>request.id</p></td>
-      <td><p>String</p></td>
-      <td><p>Request ID corresponding to <code><span>x-request-id</span></code> header value</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.time</p></td>
-      <td><p>Timestamp</p></td>
-      <td><p>Time of the first byte received</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.protocol</p></td>
-      <td><p>String</p></td>
-      <td><p>Request protocol (“HTTP/1.0”, “HTTP/1.1”, “HTTP/2”, or “HTTP/3”)</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.scheme</p></td>
-      <td><p>String</p></td>
-      <td><p>The scheme portion of the URL e.g. “http”</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.host</p></td>
-      <td><p>String</p></td>
-      <td><p>The host portion of the URL</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.method</p></td>
-      <td><p>String</p></td>
-      <td><p>Request method e.g. “GET”</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.path</p></td>
-      <td><p>String</p></td>
-      <td><p>The path portion of the URL</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.url_path</p></td>
-      <td><p>String</p></td>
-      <td><p>The path portion of the URL without the query string</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.query</p></td>
-      <td><p>String</p></td>
-      <td><p>The query portion of the URL in the format of “name1=value1&amp;name2=value2”</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.headers</p></td>
-      <td><p>Map&lt;String, String&gt;</p></td>
-      <td><p>All request headers indexed by the lower-cased header name</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.referer</p></td>
-      <td><p>String</p></td>
-      <td><p>Referer request header</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.useragent</p></td>
-      <td><p>String</p></td>
-      <td><p>User agent request header</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>request.size</p></td>
-      <td><p>Number</p></td>
-      <td><p>The HTTP request size in bytes. If unknown, it must be -1</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>request.body</p></td>
-      <td><p>String</p></td>
-      <td><p>The HTTP request body. (Disabled by default. Requires additional proxy configuration to enabled it.)</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>request.raw_body</p></td>
-      <td><p>Array&lt;Number&gt;</p></td>
-      <td><p>The HTTP request body in bytes. This is sometimes used instead of <code>body</code> depending on the proxy configuration.</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>request.context_extensions</p></td>
-      <td><p>Map&lt;String, String&gt;</p></td>
-      <td><p>This is analogous to <code>request.headers</code>, however these contents are not sent to the upstream server. It provides an extension mechanism for sending additional information to the auth service without modifying the proto definition. It maps to the internal opaque context in the proxy filter chain. (Requires additional configuration in the proxy.)</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-  </tbody>
-</table>
-
-<h2 id="connection-attributes">Connection attributes<a class="headerlink" href="#connection-attributes" title="Permanent link">&para;</a></h2>
-<p>The following attributes are available once the downstream connection with the API gateway or proxy managed by Kuadrant is established. They apply to HTTP requests (L7) as well, but also to proxied connections limited at L3/L4.</p>
-<table>
-  <thead>
-    <tr>
-      <th><p>Attribute</p></th>
-      <th><p>Type</p></th>
-      <th><p>Description</p></th>
-      <th><p>Auth</p></th>
-      <th><p>RL</p></th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><p>source.address</p></td>
-      <td><p>String</p></td>
-      <td><p>Downstream connection remote address</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>source.port</p></td>
-      <td><p>Number</p></td>
-      <td><p>Downstream connection remote port</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>source.service</p></td>
-      <td><p>String</p></td>
-      <td><p>The canonical service name of the peer</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>source.labels</p></td>
-      <td><p>Map&lt;String, String&gt;</p></td>
-      <td><p>The labels associated with the peer. These could be pod labels for Kubernetes or tags for VMs. The source of the labels could be an X.509 certificate or other configuration.</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>source.principal</p></td>
-      <td><p>String</p></td>
-      <td><p>The authenticated identity of this peer. If an X.509 certificate is used to assert the identity in the proxy, this field is sourced from “URI Subject Alternative Names“, “DNS Subject Alternate Names“ or “Subject“ in that order. The format is issuer specific – e.g. SPIFFE format is <code>spiffe://trust-domain/path</code>, Google account format is <code>https://accounts.google.com/{userid}</code>.</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>source.certificate</p></td>
-      <td><p>String</p></td>
-      <td><p>The X.509 certificate used to authenticate the identify of this peer. When present, the certificate contents are encoded in URL and PEM format.</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>destination.address</p></td>
-      <td><p>String</p></td>
-      <td><p>Downstream connection local address</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>destination.port</p></td>
-      <td><p>Number</p></td>
-      <td><p>Downstream connection local port</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>destination.service</p></td>
-      <td><p>String</p></td>
-      <td><p>The canonical service name of the peer</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>destination.labels</p></td>
-      <td><p>Map&lt;String, String&gt;</p></td>
-      <td><p>The labels associated with the peer. These could be pod labels for Kubernetes or tags for VMs. The source of the labels could be an X.509 certificate or other configuration.</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>destination.principal</p></td>
-      <td><p>String</p></td>
-      <td><p>The authenticated identity of this peer. If an X.509 certificate is used to assert the identity in the proxy, this field is sourced from “URI Subject Alternative Names“, “DNS Subject Alternate Names“ or “Subject“ in that order. The format is issuer specific – e.g. SPIFFE format is <code>spiffe://trust-domain/path</code>, Google account format is <code>https://accounts.google.com/{userid}</code>.</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>destination.certificate</p></td>
-      <td><p>String</p></td>
-      <td><p>The X.509 certificate used to authenticate the identify of this peer. When present, the certificate contents are encoded in URL and PEM format.</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>connection.id</p></td>
-      <td><p>Number</p></td>
-      <td><p>Downstream connection ID</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.mtls</p></td>
-      <td><p>Boolean</p></td>
-      <td><p>Indicates whether TLS is applied to the downstream connection and the peer ceritificate is presented</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.requested_server_name</p></td>
-      <td><p>String</p></td>
-      <td><p>Requested server name in the downstream TLS connection</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.tls_session.sni</p></td>
-      <td><p>String</p></td>
-      <td><p>SNI used for TLS session</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>connection.tls_version</p></td>
-      <td><p>String</p></td>
-      <td><p>TLS version of the downstream TLS connection</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.subject_local_certificate</p></td>
-      <td><p>String</p></td>
-      <td><p>The subject field of the local certificate in the downstream TLS connection</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.subject_peer_certificate</p></td>
-      <td><p>String</p></td>
-      <td><p>The subject field of the peer certificate in the downstream TLS connection</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.dns_san_local_certificate</p></td>
-      <td><p>String</p></td>
-      <td><p>The first DNS entry in the SAN field of the local certificate in the downstream TLS connection</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.dns_san_peer_certificate</p></td>
-      <td><p>String</p></td>
-      <td><p>The first DNS entry in the SAN field of the peer certificate in the downstream TLS connection</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.uri_san_local_certificate</p></td>
-      <td><p>String</p></td>
-      <td><p>The first URI entry in the SAN field of the local certificate in the downstream TLS connection</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.uri_san_peer_certificate</p></td>
-      <td><p>String</p></td>
-      <td><p>The first URI entry in the SAN field of the peer certificate in the downstream TLS connection</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>connection.sha256_peer_certificate_digest</p></td>
-      <td>String</td>
-      <td><p>SHA256 digest of the peer certificate in the downstream TLS connection if present</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-  </tbody>
-</table>
-
-<h2 id="metadata-and-filter-state-attributes">Metadata and filter state attributes<a class="headerlink" href="#metadata-and-filter-state-attributes" title="Permanent link">&para;</a></h2>
-<p>The following attributes are related to the Envoy proxy filter chain. They include metadata exported by the proxy throughout the filters and information about the states of the filters themselves.</p>
-<table>
-  <thead>
-    <tr>
-      <th><p>Attribute</p></th>
-      <th><p>Type</p></th>
-      <th><p>Description</p></th>
-      <th><p>Auth</p></th>
-      <th><p>RL</p></th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><p>metadata</p></td>
-      <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-metadata">Metadata</a></p></td>
-      <td><p>Dynamic request metadata</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>filter_state</p></td>
-      <td><p>Map&lt;String, String&gt;</p></td>
-      <td><p>Mapping from a filter state name to its serialized string value</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-  </tbody>
-</table>
-
-<h2 id="auth-attributes">Auth attributes<a class="headerlink" href="#auth-attributes" title="Permanent link">&para;</a></h2>
-<p>The following attributes are exclusive of the external auth service (Authorino).</p>
-<table>
-  <thead>
-    <tr>
-      <th><p>Attribute</p></th>
-      <th><p>Type</p></th>
-      <th><p>Description</p></th>
-      <th><p>Auth</p></th>
-      <th><p>RL</p></th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><p>auth.identity</p></td>
-      <td><p>Any</p></td>
-      <td><p>Single resolved identity object, post-identity verification</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>auth.metadata</p></td>
-      <td><p>Map&lt;String, Any&gt;</p></td>
-      <td><p>External metadata fetched</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>auth.authorization</p></td>
-      <td><p>Map&lt;String, Any&gt;</p></td>
-      <td><p>Authorization results resolved by each authorization rule, access granted only</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>auth.response</p></td>
-      <td><p>Map&lt;String, Any&gt;</p></td>
-      <td><p>Response objects exported by the auth service post-access granted</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-    <tr>
-      <td><p>auth.callbacks</p></td>
-      <td><p>Map&lt;String, Any&gt;</p></td>
-      <td><p>Response objects returned by the callback requests issued by the auth service</p></td>
-      <td align="center"><p>✓</p></td>
-      <td align="center"><p></p></td>
-    </tr>
-  </tbody>
-</table>
-
-<p>The auth service also supports modifying selected values by chaining <a href="https://github.com/Kuadrant/authorino/blob/main/docs/features.md#string-modifiers">modifiers</a> in the path.</p>
-<h2 id="rate-limit-attributes">Rate-limit attributes<a class="headerlink" href="#rate-limit-attributes" title="Permanent link">&para;</a></h2>
-<p>The following attributes are exclusive of the rate-limiting service (Limitador).</p>
-<table>
-  <thead>
-    <tr>
-      <th><p>Attribute</p></th>
-      <th><p>Type</p></th>
-      <th><p>Description</p></th>
-      <th><p>Auth</p></th>
-      <th><p>RL</p></th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><p>ratelimit.domain</p></td>
-      <td><p>String</p></td>
-      <td><p>The rate limit domain. This enables the configuration to be namespaced per application (multi-tenancy).</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-    <tr>
-      <td><p>ratelimit.hits_addend</p></td>
-      <td><p>Number</p></td>
-      <td><p>Specifies the number of hits a request adds to the matched limit. Fixed value: `1`. Reserved for future usage.</p></td>
-      <td align="center"><p></p></td>
-      <td align="center"><p>✓</p></td>
-    </tr>
-  </tbody>
-</table>
-
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<p>The decoupling of the well-known attributes and the language of well-known attributes and selectors from the individual policy CRDs is what makes it somewhat flexible and common across the components (rate-limiting and auth). However, it's less structured and it introduces another syntax for users to get familiar with.</p>
-<p>This additional language competes with the language of the route selectors (<a href="https://github.com/Kuadrant/architecture/blob/main/rfcs/0001-rlp-v2.md">RFC 0001</a>), based on Gateway API's <a href="https://gateway-api.sigs.k8s.io/v1alpha2/references/spec/#gateway.networking.k8s.io/v1beta1.HTTPRouteMatch"><code>HTTPRouteMatch</code></a> type.</p>
-<p>Being "soft-coded" in the policy specs (as opposed to a hard-coded sub-structure inside of each policy type) does not mean it's completely decoupled from implementation in the control plane and/or intermediary data plane components. Although many attributes can be supported almost as a pass-through, from being used in a selector in a policy, to a corresponding value requested by the wasm-shim to its host, that is not always the case. Some translation may be required for components not integrated via wasm-shim (e.g. Authorino), as well as for components integrated via wasm-shim (e.g. Limitador) in special cases of composite or abstraction well-known attributes (i.e. attributes not available as-is via ABI, e.g. <code>auth.identity</code> in a RLP). Either way, some validation of the values introduced by users in the selectors may be needed at some point in the control plane, thus requiring arguably a level of awaresness and coupling between the well-known selectors specification and the control plane (policy controllers) or intermediary data plane (wasm-shim) components.</p>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<p>As an alternative to JSON path-like selectors based on a well-known structure that induces the proposed language of well-known attributes, these same attributes could be defined as sub-types of each policy CRD. The Golang packages defining the common attributes across CRDs could be shared by the policy type definitions to reduce repetition. However, that approach would possibly involve a staggering number of new type definitions to cover all the cases for all the groups of attributes to be supported. These are constructs that not only need to be understood by the policy controllers, but also known by the user who writes a policy.</p>
-<p>Additionally, all attributes, including new attributes occasionally introduced by Envoy and made available to the wasm-shim via ABI, would always require translation from the user-level abstraction how it's represented in a policy, to the actual form how it's used in the wasm-shim configuration and Authorino AuthConfigs.</p>
-<p>Not implementing this proposal and keeping the current state of things mean little consistency between these common constructs for rules and conditions on how they are represented in each type of policy. This lack of consistency has a direct impact on the overhead faced by users to learn how to interact with Kuadrant and write different kinds of policies, as well as for the maintainers on tasks of coding for policy validation and reconciliation of data plane configurations.</p>
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<p>Authorino's dynamic <a href="https://github.com/Kuadrant/authorino/blob/main/docs/features.md#common-feature-json-paths-valuefromauthjson">JSON paths</a>, related to Authorino's <a href="https://github.com/Kuadrant/authorino/blob/main/docs/architecture.md#the-authorization-json">Authorization JSON</a> and used in <code>when</code> conditions and inside of multiple other constructs of the AuthConfig, are an example of feature of very similar approach to the one proposed here.</p>
-<p>Arguably, Authorino's perceived flexibility would not have been possible with the Authorization JSON selectors. Users can write quite sophisticated policy rules (conditions, variable references, etc) by leveraging the those dynamic selectors. Because they are backed by JSON-based machinery in the code, Authorino's selectors have very little to, in some cases, none at all variation compared <a href="https://www.openpolicyagent.org/docs/latest/policy-reference/">Open Policy Agent's Rego policy language</a>, which is often used side by side in the same AuthConfigs.</p>
-<p>Authorino's Authorization JSON selectors are, in one hand, more restrict to the structure of the <a href="https://pkg.go.dev/github.com/envoyproxy/go-control-plane/envoy/service/auth/v3?utm_source=gopls#CheckRequest"><code>CheckRequest</code></a> payload (<code>context.*</code> attributes). At the same time, they are very open in the part associated with the internal attributes built along the Auth Pipeline (i.e. <code>auth.*</code> attributes). That makes Authorino's Authorization JSON selectors more limited, compared to the <a href="https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/advanced/attributes">Envoy attributes</a> made available to the wasm-shim via ABI, but also harder to validate. In some cases, such as of deep references to inside objects fetched from external sources of metadata, resolved OPA objects, JWT claims, etc, it is impossible to validate for correct references.</p>
-<p>Another experience learned from Authorino's Authorization JSON selectors is that they depend substantially on the so-called "<a href="https://github.com/Kuadrant/authorino/blob/main/docs/features.md#string-modifiers">modifiers</a>". Many use cases involving parsing and breaking down attributes that are originally available in a more complex form would not be possible without the modifiers. Examples of such cases are: extracting portions of the path and/or query string parameters (e.g. collection and resource identifiers), applying translations on HTTP verbs into corresponding operations, base64-decoding values from the context HTTP request, amongst several others.</p>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<ol>
-<li>
-<p>How to deal with the differences regarding the availability and data types of the attributes across clients/hosts?</p>
-</li>
-<li>
-<p>Can we make more attributes that are currently available to only one of the components common to both?</p>
-</li>
-<li>
-<p>Will we need some kind of global support for modifiers (functions) in the well-known selectors or those can continue to be an Authorino-only feature?</p>
-</li>
-<li>
-<p>Does Authorino, which is more strict regarding the data structure that induces the selectors, need to implement this specification or could/should it keep its current selectors and a translation be performed by the AuthPolicy controller?</p>
-</li>
-</ol>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<ol>
-<li>Extend with more well-known attributes that abstract common patterns and/or for rather opinioned use cases. Examples:</li>
-<li><code>auth.*</code> attributes supported in the rate limit service</li>
-<li><code>request.authenticated</code></li>
-<li><code>request.operation.(read|write)</code></li>
-<li><code>request.param.my-param</code></li>
-<li>
-<p><code>connection.secure</code></p>
-</li>
-<li>
-<p>Other Envoy attributes</p>
-</li>
-</ol>
-<details>
-  <summary><a href="https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/advanced/attributes#wasm-attributes">Wasm attributes</a></summary>
-
-  <table>
-    <thead>
-      <tr>
-        <th><p>Attribute</p></th>
-        <th><p>Type</p></th>
-        <th><p>Description</p></th>
-        <th><p>Auth</p></th>
-        <th><p>RL</p></th>
-      </tr>
-    </thead>
-    <tbody>
-      <tr>
-        <td><p>wasm.plugin_name</p></td>
-        <td><p>String</p></td>
-        <td><p>Plugin name</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.plugin_root_id</p></td>
-        <td><p>String</p></td>
-        <td><p>Plugin root ID</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.plugin_vm_id</p></td>
-        <td><p>String</p></td>
-        <td><p>Plugin VM ID</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.node</p></td>
-        <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-node"><span>Node</span></a></p></td>
-        <td><p>Local node description</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.cluster_name</p></td>
-        <td><p>String</p></td>
-        <td><p>Upstream cluster name</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.cluster_metadata</p></td>
-        <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-metadata">Metadata</a></p></td>
-        <td><p>Upstream cluster metadata</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.listener_direction</p></td>
-        <td><p>Number</p></td>
-        <td><p>Enumeration value of the <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/listener/v3/listener.proto#envoy-v3-api-field-config-listener-v3-listener-traffic-direction"><span>listener traffic direction</span></a></p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.listener_metadata</p></td>
-        <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-metadata">Metadata</a></p></td>
-        <td><p>Listener metadata</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.route_name</p></td>
-        <td><p>String</p></td>
-        <td><p>Route name</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.route_metadata</p></td>
-        <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-metadata">Metadata</a></p></td>
-        <td><p>Route metadata</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>wasm.upstream_host_metadata</p></td>
-        <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-metadata">Metadata</a></p></td>
-        <td><p>Upstream host metadata</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-    </tbody>
-  </table>
-</details>
-
-<details>
-  <summary><a href="https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/advanced/attributes#configuration-attributes">Proxy configuration attributes</a></summary>
-
-  <table>
-    <thead>
-      <tr>
-        <th><p>Attribute</p></th>
-        <th><p>Type</p></th>
-        <th><p>Description</p></th>
-        <th><p>Auth</p></th>
-        <th><p>RL</p></th>
-      </tr>
-    </thead>
-    <tbody>
-      <tr>
-        <td><p>xds.cluster_name</p></td>
-        <td><p>String</p></td>
-        <td><p>Upstream cluster name</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>xds.cluster_metadata</p></td>
-        <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-metadata">Metadata</a></p></td>
-        <td><p>Upstream cluster metadata</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>xds.route_name</p></td>
-        <td><p>String</p></td>
-        <td><p>Route name</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>xds.route_metadata</p></td>
-        <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-metadata">Metadata</a></p></td>
-        <td><p>Route metadata</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>xds.upstream_host_metadata</p></td>
-        <td><p><a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/base.proto#envoy-v3-api-msg-config-core-v3-metadata">Metadata</a></p></td>
-        <td><p>Upstream host metadata</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-      <tr>
-        <td><p>xds.filter_chain_name</p></td>
-        <td><p>String</p></td>
-        <td><p>Listener filter chain name</p></td>
-        <td align="center"><p></p></td>
-        <td align="center"><p>✓</p></td>
-      </tr>
-    </tbody>
-  </table>
-</details>
-
-<ol>
-<li>Add some support for value modifiers (functions), along the lines of Authorino's <a href="https://github.com/Kuadrant/authorino/blob/main/docs/features.md#string-modifiers">JSON path modifiers</a> and/or Envoy attributes' <a href="https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/advanced/attributes#path-expressions">path expressions</a>.</li>
-</ol>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/index.html b/0.10.0/architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/index.html
deleted file mode 100644
index 06c85870a..000000000
--- a/0.10.0/architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/index.html
+++ /dev/null
@@ -1,3595 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>DNSRecordStructure - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#requirements" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              DNSRecordStructure
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#diagram" class="md-nav__link">
-    <span class="md-ellipsis">
-      Diagram
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#proposal" class="md-nav__link">
-    <span class="md-ellipsis">
-      Proposal
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Proposal">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#apex-domains" class="md-nav__link">
-    <span class="md-ellipsis">
-      Apex Domains
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#geo-agnostic-everything-is-in-a-default-geo-catch-all" class="md-nav__link">
-    <span class="md-ellipsis">
-      Geo Agnostic (everything is in a default * geo catch all)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#geo-specific" class="md-nav__link">
-    <span class="md-ellipsis">
-      geo specific
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#wildcards" class="md-nav__link">
-    <span class="md-ellipsis">
-      WildCards
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#pros" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pros
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cons" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cons
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0003-dns-policy-assets/DNSRecordStructure.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>DNSRecordStructure</h1>
-
-<p>DNSRecord is our API for expressing DNS endpoints via a kube CRD based API. It is managed by the multi-cluster gateway controller based on the desired state expressed in higher level APIs such as the Gateway or a DNSPolicy. In order to provide our feature set, we need to carefully consider how we structure our records and the types of records we need. This document proposes a particular structure based on the requirements and feature set we have.</p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<p>We want to be able to support Gateway definitions that use the following listener definitions:</p>
-<ul>
-<li>wildcard: <code>*.example.com</code> and fully qualified listener host <code>www.example.com</code> definitions with the notable exception of fully wildcarded ie <code>*</code> as we cannot provide any DNS or TLS for something with no defined hostname.</li>
-<li>listeners that have HTTPRoute defined on less than all the clusters where the listener is available. IE we don't want to send traffic to clusters where there is no HTTPRoute attached to the listener.</li>
-<li>Gateway instances that provide IPs that are deployed alongside instances on different infra that provide host names causing the addresses types on each of gateway instance to be different (IPAddress or HostAddress). </li>
-<li>We want to provide GEO based DNS as a feature of DNSPolicy and so our DNSRecord structure must support this.</li>
-<li>We want to offer default weighted and custom weighted DNS as part of DNSPolicy</li>
-<li>We want to allow root or apex domain to be used as listener hosts</li>
-</ul>
-<h2 id="diagram">Diagram<a class="headerlink" href="#diagram" title="Permanent link">&para;</a></h2>
-<p>https://lucid.app/lucidchart/2f95c9c9-8ddf-4609-af37-48145c02ef7f/edit?viewport_loc=-188%2C-61%2C2400%2C1183%2C0_0&amp;invitationId=inv_d5f35eb7-16a9-40ec-b568-38556de9b568</p>
-<h2 id="proposal">Proposal<a class="headerlink" href="#proposal" title="Permanent link">&para;</a></h2>
-<p>For each listener defined in a gateway, we will create a set of records with the following rules.</p>
-<p><strong>none apex domain:</strong></p>
-<p>We will have a generated lb (load balancer) dns name that we will use as a CNAME for the listener hostname. This DNS name is not intended for use within a HTTPRoute but is instead just a DNS construct. This will allow us to set up additional CNAME records for that DNS name in the future that are returned based a GEO location. These DNS records will also be CNAMES pointing to specific gateway dns names, this will allow us to setup a weighted response. So the first layer CNAME handles balancing based on geo, the second layer handles balancing based on weighting. </p>
-<div class="language-text highlight"><pre><span></span><code>                                        shop.example.com
-                                        |             |
-                                      (IE)          (AUS)
-                                CNAME lb.shop..      lb.shop..
-                                    |     |         |      |
-                                 (w 100) (w 200)   (w 100) (w100)
-                                CNAME g1.lb.. g2.lb..   g3.lb..  g4.lb..
-                                A 192..   A 81..  CNAME  aws.lb   A 82..
-</code></pre></div>
-<p>When there is no geo strategy defined within the DNSPolicy, we will put everything into a default geo (IE a catch-all record) <code>default.lb-{guid}.{listenerHost}</code> but set the routing policy to GEO allowing us to add more geo based records in the future if the gateway admin decides to move to a geo strategy as their needs grow. </p>
-<p>To ensure this lb dns name is unique and does not clash we will use a short guid as part of the subdomain so <code>lb-{guid}.{listenerHost}.</code> this guid will be based on the gateway name and gateway namespace in the control plane.</p>
-<p>For a geo strategy we will add a geo record with a prefix to the lb subdomain based on the geo code. When there is no geo we will use <code>default</code> as the prefix. <code>{geo-code}.lb-{guid}.{listenerHost}</code>.
-Finally, for each gateway instance on a target cluster we will add a <code>{spokeClusterName}.lb-{guid}.{listenerHost}</code></p>
-<p>To allow for a mix of hostname and IP address types, we will always use a CNAME . So we will create a dns name for IPAddress with the following structure: <code>{guid}.lb-{guid}.{listenerHost}</code> where the first guid will be based on the cluster name where the gateway is placed.</p>
-<h3 id="apex-domains">Apex Domains<a class="headerlink" href="#apex-domains" title="Permanent link">&para;</a></h3>
-<p>An apex domain is the domain at the apex or root of a zone. These are handled differently by DNS as they often have NS and SOA records. Generally it is not possible to set up a CNAME for apex domain (although some providers allow it).</p>
-<p>If a listener is added to a gateway that is an apex domain, we can only add A records for that domain to keep ourselves compliant with as many providers as possible.
-If a listener is the apex domain, we will setup A records for that domain (favouring gateways with an IP address or resolving the IP behind a host) but there will be no special balancing/weighting done. Instead, we will expect that the owner of that will setup a HTTPRoute with a 301 permanent redirect sending users from the apex domain e.g. example.com to something like: www.example.com where the www subdomain based listener would use the rules of the none apex domains and be where advanced geo and weighted strategies are applied.</p>
-<ul>
-<li>gateway listener host name : example.com <ul>
-<li>example.com A 81.17.241.20</li>
-</ul>
-</li>
-</ul>
-<h3 id="geo-agnostic-everything-is-in-a-default-geo-catch-all">Geo Agnostic (everything is in a default * geo catch all)<a class="headerlink" href="#geo-agnostic-everything-is-in-a-default-geo-catch-all" title="Permanent link">&para;</a></h3>
-<p>This is the type of DNS Record structure that would back our default DNSPolicy.</p>
-<ul>
-<li>
-<p>gateway listener host name : www.example.com </p>
-<p><strong>DNSRecords:</strong></p>
-<ul>
-<li>www.example.com CNAME lb-1ab1.www.example.com </li>
-<li>lb-1ab1.www.example.com CNAME geolocation * default.lb-1ab1.www.example.com </li>
-<li>default.lb-1ab1.www.example.com CNAME weighted 100 1bc1.lb-1ab1.www.example.com</li>
-<li>default.lb-1ab1.www.example.com CNAME weighted 100 aws.lb.com</li>
-<li>1bc1.lb-1ab1.www.example.com A 192.22.2.1</li>
-</ul>
-</li>
-</ul>
-<p>So in the above example working up from the bottom, we have a mix of hostname and IP based addresses for the gateway instance. We have 2 evenly weighted records that balance between the two available gateways, then next we have the geo based record that is set to a default catch all as no geo has been specified then finally we have the actual listener hostname that points at our DNS based load balancer name.</p>
-<p>DNSRecord Yaml</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSRecord</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">gateway-name</span><span class="p p-Indicator">}</span><span class="l l-Scalar l-Scalar-Plain">-{listenerName}</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">multi-cluster-gateways</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">www.example.com</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span><span class="nt">managedZone</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">mgc-dev-mz</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">  </span><span class="nt">endpoints</span><span class="p">:</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">www.example.com</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lb-1ab1.www.example.com</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lb-1ab1.www.example.com</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">      </span><span class="nt">setIdentifier</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">mygateway-multicluster-gateways</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">      </span><span class="nt">providerSpecific</span><span class="p">:</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;geolocation-country-code&quot;</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;*&quot;</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default.lb-1ab1.www.example.com</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default.lb-1ab1.www.example.com</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="w">      </span><span class="nt">setIdentifier</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cluster1</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="w">      </span><span class="nt">providerSpecific</span><span class="p">:</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;weight&quot;</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;100&quot;</span>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1bc1.lb-1ab1.www.example.com</span>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default.lb-a1b2.shop.example.com</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a><span class="w">      </span><span class="nt">setIdentifier</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cluster2</span>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a><span class="w">      </span><span class="nt">providerSpecific</span><span class="p">:</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;weight&quot;</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;100&quot;</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">aws.lb.com</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1bc1.lb-1ab1.www.example.com</span>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">192.22.2.1</span>
-</span></code></pre></div>
-<h3 id="geo-specific">geo specific<a class="headerlink" href="#geo-specific" title="Permanent link">&para;</a></h3>
-<p>Once the end user selects to use a geo strategy via the DNSPolicy, we then need to restructure our DNS to add in our geo specific records. Here the default record</p>
-<p>lb short code is {gw name + gw namespace}
-gw short code is {cluster name}</p>
-<ul>
-<li>
-<p>gateway listener host : shop.example.com  </p>
-<p><strong>DNSRecords:</strong></p>
-<ul>
-<li>shop.example.com CNAME lb-a1b2.shop.example.com </li>
-<li>lb-a1b2.shop.example.com  CNAME geolocation ireland ie.lb-a1b2.shop.example.com </li>
-<li>lb-a1b2.shop.example.com  geolocation australia aus.lb-a1b2.shop.example.com </li>
-<li>lb-a1b2.shop.example.com  geolocation default ie.lb-a1b2.shop.example.com  (set by the default geo option)</li>
-<li>ie.lb-a1b2.shop.example.com   CNAME weighted 100 ab1.lb-a1b2.shop.example.com </li>
-<li>ie.lb-a1b2.shop.example.com   CNAME weighted 100 aws.lb.com</li>
-<li>aus.lb-a1b2.shop.example.com  CNAME weighted 100 ab2.lb-a1b2.shop.example.com </li>
-<li>aus.lb-a1b2.shop.example.com  CNAME weighted 100 ab3.lb-a1b2.shop.example.com </li>
-<li>ab1.lb-a1b2.shop.example.com  A 192.22.2.1 192.22.2.5</li>
-<li>ab2.lb-a1b2.shop.example.com  A 192.22.2.3</li>
-<li>ab3.lb-a1b2.shop.example.com  A 192.22.2.4</li>
-</ul>
-</li>
-</ul>
-<p>In the above example we move from a default catch all to geo specific setup. Based on a DNSPolicy that specifies IE as the default geo location. We leave the <code>default</code> subdomain in place to allow for clients that may still be using that and set up geo specific subdomains that allow us to route traffic based on its origin. In this example we are load balancing across 2 geos and 4 clusters</p>
-<h3 id="wildcards">WildCards<a class="headerlink" href="#wildcards" title="Permanent link">&para;</a></h3>
-<p>In the examples we have used fully qualified domain names, however sometimes it may be required to use a wildcard subdomain. example:</p>
-<ul>
-<li>gateway listener host : *.example.com  </li>
-</ul>
-<p>To support these we need to change the name of the DNSRecord away from the name of the listener as the k8s resource does not allow * in the name. </p>
-<p>To do this we will set the dns record resource name to be a combination of <code>{gateway-name}-{listenerName}</code></p>
-<p>to keep a record of the host this is for we will set a top level property named <code>dnsName</code>. You can see an example in the DNSRecord above.</p>
-<h2 id="pros">Pros<a class="headerlink" href="#pros" title="Permanent link">&para;</a></h2>
-<p>This setup allows us a powerful set of features and flexibility</p>
-<h2 id="cons">Cons<a class="headerlink" href="#cons" title="Permanent link">&para;</a></h2>
-<p>With this CNAME based approach we are increasing the number of DNS lookups required to get to an IP which will increase the cost and add a small amount of latency. To counteract this, we will set a reasonably high TTL (at least 5 mins) for our CNAMES and (2 mins) for A records</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0003-dns-policy/index.html b/0.10.0/architecture/rfcs/0003-dns-policy/index.html
deleted file mode 100644
index 2c3b57534..000000000
--- a/0.10.0/architecture/rfcs/0003-dns-policy/index.html
+++ /dev/null
@@ -1,3570 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0003-dns-policy/">
-      
-      
-        <link rel="prev" href="../0002-well-known-attributes/">
-      
-      
-        <link rel="next" href="../0004-policy-status/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0003: DNSPolicy - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#rfc-template" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0003: DNSPolicy
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0003-dns-policy.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="rfc-template">RFC Template<a class="headerlink" href="#rfc-template" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: DNSPolicy</li>
-<li>Start Date: 2023-07-01</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/20">Kuadrant/architecture#20</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/multicluster-gateway-controller/issues/219">Kuadrant/multicluster-gateway-controller#219</a></li>
-<li>Labels: DNS, Load Balancing, Multi-Cluster</li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>Provide a policy for configuring how DNS should be handed for a given gateway. Provide a mechanism for enabling DNS based load balancing.</p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>Gateway admins, need a way to define the DNS policy for a multi-cluster gateway in order to control how much and which traffic reaches these gateways. 
-Ideally we would allow them to express a strategy that they want to use without needing to get into the details of each provider and needing to create and maintain dns record structure and individual records for all the different gateways that may be within their infrastructure.</p>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>Allow definition of a DNSPolicy that configures load balancing to decide how traffic should be distributed across multiple gateway instances from the central control plane.</p>
-<h2 id="terms">Terms<a class="headerlink" href="#terms" title="Permanent link">&para;</a></h2>
-<ul>
-<li><strong>managed listener</strong>: This is a listener with a host backed by a DNS zone managed by the multi-cluster gateway controller</li>
-<li><strong>hub cluster</strong>: control plane cluster that managed 1 or more spokes</li>
-<li><strong>spoke cluster</strong>: a cluster managed by the hub control plane cluster. This is where gateway are instantiated</li>
-</ul>
-<p>Provide a control plane DNSPolicy API that uses the idea of direct <a href="https://gateway-api.sigs.k8s.io/references/policy-attachment/#direct-policy-attachment">policy attachment</a> from gateway API that allows a load balancing strategy to be applied to the DNS records structure for any managed listeners being served by the data plane instances of this gateway. 
-The DNSPolicy also covers health checks that inform the DNS response but that is not covered in this document.</p>
-<p>Below is a draft API for what we anticipate the DNSPolicy to look like</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># defaults to gateway gvk and current namespace</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway-name</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="nt">health</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">   </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span><span class="nt">loadBalancing</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">    </span><span class="nt">weighted</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">     </span><span class="nt">defaultWeight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">     </span><span class="nt">custom</span><span class="p">:</span><span class="w"> </span><span class="c1">#optional</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">     </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AWS</span><span class="w">  </span><span class="c1">#optional with both GEO and weighted. With GEO the custom weight is applied to gateways within a Geographic region</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">       </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">     </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GCP</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">       </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">20</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">    </span><span class="nt">GEO</span><span class="p">:</span><span class="w"> </span><span class="c1">#optional</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">      </span><span class="nt">defaultGeo</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">IE</span><span class="w"> </span><span class="c1"># required with GEO. Chooses a default DNS response when no particular response is defined for a request from an unknown GEO.</span>
-</span></code></pre></div>
-<h3 id="available-load-balancing-strategies">Available Load Balancing Strategies<a class="headerlink" href="#available-load-balancing-strategies" title="Permanent link">&para;</a></h3>
-<p>GEO and Weighted load balancing are well understood strategies and this API effectively allow a complex requirement to be expressed relatively simply and executed by the gateway controller in the chosen DNS provider. Our default policy will execute a "Round Robin" weighted strategy which reflects the current default behaviour.</p>
-<p>With the above API we can provide weighted and GEO and weighted within a GEO. A weighted strategy with a minimum of a default weight is always required and the simplest type of policy. The multi-cluster gateway controller will set up a default policy when a gateway is discovered (shown below). This policy can be replaced or modified by the user.  A weighted strategy can be complimented with a GEO strategy IE they can be used together in order to provide a GEO and weighted (within a GEO) load balancing. By defining a GEO section, you are indicating that you want to use a GEO based strategy (how this works is covered below).</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default-policy</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># defaults to gateway gvk and current namespace</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway-name</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">  </span><span class="nt">loadBalancing</span><span class="p">:</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="nt">weighted</span><span class="p">:</span><span class="w"> </span><span class="c1"># required</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">     </span><span class="nt">defaultWeight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span><span class="w">  </span><span class="c1">#required, all records created get this weight</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">  </span><span class="nt">health</span><span class="p">:</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">   </span><span class="l l-Scalar l-Scalar-Plain">...</span><span class="w">   </span>
-</span></code></pre></div>
-<p>In order to provide GEO based DNS and allow customisation of the weighting, we need some additional information to be provided by the gateway / cluster admin about where this gateway has been placed. For example if they want to use GEO based DNS as a strategy, we need to know what GEO identifier(s) to use for each record we create and a default GEO to use as a catch-all. Also, if the desired load balancing approach is to provide custom weighting and no longer simply use Round Robin, we will need a way to identify which records to apply that custom weighting to based on the clusters the gateway is placed on.</p>
-<p>To solve this we will allow two new attributes to be added to the <code>ManagedCluster</code> resource as labels:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>   kuadrant.io/lb-attribute-geo-code: &quot;IE&quot;
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>   kuadrant.io/lb-attribute-custom-weight: &quot;GCP&quot;
-</span></code></pre></div>
-<p>These two labels allow setting values in the DNSPolicy that will be reflected into DNS records for gateways placed on that cluster depending on the strategies used. (see the first DNSPolicy definition above to see how these values are used) or take a look at the examples at the bottom.</p>
-<p>example :
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cluster.open-cluster-management.io/v1</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ManagedCluster</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w"> </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">   </span><span class="nt">kuadrant.io/lb-attribute-geo-code</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;IE&quot;</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">   </span><span class="nt">kuadrant.io/lb-attribute-custom-weight</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;GCP&quot;</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="nt">spec</span><span class="p">:</span><span class="w">    </span>
-</span></code></pre></div></p>
-<p>The attributes provide the key and value we need in order to understand how to define records for a given LB address based on the DNSPolicy targeting the gateway.</p>
-<p>The <code>kuadrant.io/lb-attribute-geo-code</code> attribute value is provider specific, using an invalid code will result in an error status condition in the DNSrecord resource. </p>
-<h3 id="dns-record-structure">DNS Record Structure<a class="headerlink" href="#dns-record-structure" title="Permanent link">&para;</a></h3>
-<p>This is an advanced topic and so is broken out into its own proposal doc <a href="../0003-dns-policy-assets/DNSRecordStructure/">DNS Record Structure</a></p>
-<h3 id="custom-weighting">Custom Weighting<a class="headerlink" href="#custom-weighting" title="Permanent link">&para;</a></h3>
-<p>Custom weighting will use the associated <code>custom-weight</code> attribute set on the <code>ManagedCluster</code> to decide which records should get a specific weight. The value of this attribute is up to the end user.</p>
-<p>example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cluster.open-cluster-management.io/v1</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ManagedCluster</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w"> </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="w">   </span><span class="nt">kuadrant.io/lb-attribute-custom-weight</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;GCP&quot;</span>
-</span></code></pre></div>
-<p>The above is then used in the DNSPolicy to set custom weights for the records associated with the target gateway.</p>
-<div class="language-YAML highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GCP</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="w">      </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">20</span>
-</span></code></pre></div>
-<p>So any gateway targeted by a DNSPolicy with the above definition that is placed on a <code>ManagedCluster</code> with the <code>kuadrant.io/lb-attribute-custom-weight</code> set with a value of GCP will get an A record with a weight of 20 </p>
-<h3 id="status">Status<a class="headerlink" href="#status" title="Permanent link">&para;</a></h3>
-<p>DNSPolicy should have a ready condition that reflect that the DNSRecords have been created and configured as expected. In the case that there is an invalid policy, the status message should reflect this and indicate to the user that the old DNS has been preserved.</p>
-<p>We will also want to add a status condition to the gateway status indicating it is effected by this policy. Gateway API recommends the following status condition </p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/PolicyAffected</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="w">  </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">True</span><span class="w"> </span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w">  </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;DNSPolicy</span><span class="nv"> </span><span class="s">has</span><span class="nv"> </span><span class="s">been</span><span class="nv"> </span><span class="s">applied&quot;</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">  </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PolicyApplied</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">  </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span></code></pre></div>
-<p>https://github.com/kubernetes-sigs/gateway-api/pull/2128/files#diff-afe84021d0647e83f420f99f5d18b392abe5ec82d68f03156c7534de9f19a30aR888</p>
-<h2 id="example-policies">Example Policies<a class="headerlink" href="#example-policies" title="Permanent link">&para;</a></h2>
-<h3 id="round-robin-the-default-policy">Round Robin (the default policy)<a class="headerlink" href="#round-robin-the-default-policy" title="Permanent link">&para;</a></h3>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RoundRobinPolicy</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># defaults to gateway gvk and current namespace</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway-name</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w">  </span><span class="nt">loadBalancing</span><span class="p">:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w">    </span><span class="nt">weighted</span><span class="p">:</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w">     </span><span class="nt">defaultWeight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span></code></pre></div>
-<h3 id="geo-round-robin">GEO (Round Robin)<a class="headerlink" href="#geo-round-robin" title="Permanent link">&para;</a></h3>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GEODNS</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># defaults to gateway gvk and current namespace</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway-name</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w">  </span><span class="nt">loadBalancing</span><span class="p">:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">    </span><span class="nt">weighted</span><span class="p">:</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">     </span><span class="nt">defaultWeight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">    </span><span class="nt">GEO</span><span class="p">:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w">     </span><span class="nt">defaultGeo</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">IE</span>
-</span></code></pre></div>
-<h3 id="custom">Custom<a class="headerlink" href="#custom" title="Permanent link">&para;</a></h3>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SendMoreToAzure</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># defaults to gateway gvk and current namespace</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway-name</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w">  </span><span class="nt">loadBalancing</span><span class="p">:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w">    </span><span class="nt">weighted</span><span class="p">:</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="w">     </span><span class="nt">defaultWeight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="w">     </span><span class="nt">custom</span><span class="p">:</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="w">     </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">attribute</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cloud</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="w">       </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Azure</span><span class="w"> </span><span class="c1">#any record associated with a gateway on a cluster without this value gets the default</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="w">       </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
-</span></code></pre></div>
-<h3 id="geo-with-custom-weights">GEO with Custom Weights<a class="headerlink" href="#geo-with-custom-weights" title="Permanent link">&para;</a></h3>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GEODNSAndSendMoreToAzure</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># defaults to gateway gvk and current namespace</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway-name</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="w">  </span><span class="nt">loadBalancing</span><span class="p">:</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="w">    </span><span class="nt">weighted</span><span class="p">:</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="w">     </span><span class="nt">defaultWeight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="w">     </span><span class="nt">custom</span><span class="p">:</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="w">     </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">attribute</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cloud</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="w">       </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Azure</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="w">       </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="w">    </span><span class="nt">GEO</span><span class="p">:</span>
-</span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="w">      </span><span class="nt">defaultGeo</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">IE</span>
-</span></code></pre></div>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Add a DNSPolicy CRD that conforms to policy attachment spec</li>
-<li>Add a new DNSPolicy controller to MCG</li>
-<li>DNS logic and record management should all migrate out of the gateway controller into this new DNSPolicy controller as it is the responsibility and domain of the DNSPolicy controller to manage DNS</li>
-<li>remove the Hosts interface as we want do not want other controllers using this to bring DNS Logic into other areas of the code.</li>
-</ul>
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<p>You cannot have a different load balancing strategy for each listener within a gateway. So in the following gateway definition</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="w">    </span><span class="nt">gatewayClassName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-multi-cluster-gateway-instance-per-cluster</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w">    </span><span class="nt">listeners</span><span class="p">:</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allowedRoutes</span><span class="p">:</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="w">        </span><span class="nt">namespaces</span><span class="p">:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="w">          </span><span class="nt">from</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">All</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="w">      </span><span class="nt">hostname</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myapp.hcpapps.net</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">443</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="w">      </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPS</span>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allowedRoutes</span><span class="p">:</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="w">        </span><span class="nt">namespaces</span><span class="p">:</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="w">          </span><span class="nt">from</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">All</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="w">      </span><span class="nt">hostname</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">other.hcpapps.net</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api</span>
-</span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">443</span>
-</span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="w">      </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPS</span><span class="w">      </span>
-</span></code></pre></div>
-<p>The DNS policy targeting this gateway will apply to both myapp.hcpapps.net and other.hcpapps.net</p>
-<p>However, there is still significant value even with this limitation. This limitation is something we will likely revisit in the future</p>
-<h2 id="background-docs">Background Docs<a class="headerlink" href="#background-docs" title="Permanent link">&para;</a></h2>
-<p><a href="https://github.com/Kuadrant/multicluster-gateway-controller/blob/main/docs/proposals/multiple-dns-provider-support.md">DNS Provider Support</a></p>
-<p><a href="https://gateway-api.sigs.k8s.io/references/policy-attachment/#direct-policy-attachment">Direct Policy Attachment</a> </p>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<p>An alternative is to configure all of this yourself manually in a dns provider. This can be a highly complex dns configuration that it would be easy to get wrong.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_1.png b/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_1.png
deleted file mode 100644
index 6732aa0a6a90ebfe877962c11fde32ecb9628a5c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 18956
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

diff --git a/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_2.png b/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_2.png
deleted file mode 100644
index ec42f0080668926cdcf627a86b29437563eed7f9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 27708
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
ZCGXAOWp<e=fuIzW*;-sEIp=!&zW{a<Q62yQ

diff --git a/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_3.png b/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_3.png
deleted file mode 100644
index ceb698197d65b742aeecf68cecd7dc54d1638041..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 67663
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%0Alj_;-<6R@K>62kH!v|
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

diff --git a/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_4.png b/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_4.png
deleted file mode 100644
index cd173ea863fb8aa3f55831a3694590a61b22696d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 76260
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
T-ExSOG;VESZ(e@d>-+x(|0j(}

diff --git a/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_5.png b/0.10.0/architecture/rfcs/0004-policy-status-assets/policy_status_5.png
deleted file mode 100644
index 7169cdd696c9fd9e53bcea27f66dca6046e9097f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 81655
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

diff --git a/0.10.0/architecture/rfcs/0004-policy-status/index.html b/0.10.0/architecture/rfcs/0004-policy-status/index.html
deleted file mode 100644
index bcfe86c70..000000000
--- a/0.10.0/architecture/rfcs/0004-policy-status/index.html
+++ /dev/null
@@ -1,3596 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0004-policy-status/">
-      
-      
-        <link rel="prev" href="../0003-dns-policy/">
-      
-      
-        <link rel="next" href="../0005-single-cluster-dnspolicy/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0004: Policy Status - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#policy-status" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0004: Policy Status
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0004-policy-status.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="policy-status">Policy Status<a class="headerlink" href="#policy-status" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>policy_status_states</code></li>
-<li>Start Date: 2023-02-03</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/9">Kuadrant/architecture#0009</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/architecture/issues/38">Kuadrant/architecture#0038</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>This RFC proposes a new design for any Kuadrant Policy (<code>RateLimitPolicy</code>, <code>AuthPolicy</code>, etc..) status definition and transitions.</p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>At the time being, the <code>RateLimitPolicy</code> and <code>AuthPolicy</code> status doesn't clearly and truthfully communicate the actual state of
-reconciliation and healthiness with its operator managed services, i.e., the Rate Limit service ("Limitador") and
-the Auth service ("Authorino"), referred to as "Kuadrant services".</p>
-<p>As a consequence, misleading information is shared causing unexpected errors and flawed assumptions.</p>
-<p>The following are some issues reported in relation to the aforementioned problems:</p>
-<ul>
-<li>https://github.com/Kuadrant/kuadrant-operator/issues/87</li>
-<li>https://github.com/Kuadrant/kuadrant-operator/issues/96</li>
-<li>https://github.com/Kuadrant/kuadrant-operator/issues/140</li>
-</ul>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>This design for setting the status of the Kuadrant policy CRs is divided in 2 stages, where each stage could be
-applied/developed in order and would reflect valuable and accurate information with different degrees of acuity.</p>
-<p>The Policy CRD Status in the following diagrams are simplified as states, which in the
-<a href="#reference-level-explanation">Reference-level explanation</a> will be translated to the actual Status Conditions.</p>
-<h2 id="stage-1">Stage 1<a class="headerlink" href="#stage-1" title="Permanent link">&para;</a></h2>
-<p><strong>State of the policy CR defined by: application, validation, and reconciliation of it</strong></p>
-<p>The main signalization at Stage 1 is about whether a policy CR has been <code>Accepted</code> or not.</p>
-<p>States rationale:</p>
-<ul>
-<li><code>Accepted</code>: This state is reached after the <code>Validation</code> and <code>Reconciliation</code> event has being successfully passed.</li>
-<li><code>Invalid</code>: When the <code>Validation</code> process encounters an error, this state will be set.</li>
-<li><code>TargetNotFound</code>: This state will be set when the <code>Reconciliation</code> process encounters an error.</li>
-<li><code>Conflicted</code>: This state will be set when the <code>Reconciliation</code> process encounters an error.</li>
-</ul>
-<p><img alt="" src="../0004-policy-status-assets/policy_status_4.png" /></p>
-<p>Notes:</p>
-<ul>
-<li>States from the Stage 2 could be implemented as well, but only relying on <em>Validation</em> and <em>Reconciliation</em> events.</li>
-</ul>
-<h2 id="stage-2">Stage 2<a class="headerlink" href="#stage-2" title="Permanent link">&para;</a></h2>
-<p><strong>Final state of the policy CR defined by: health check with the Kuadrant services (post-reconciliation)</strong></p>
-<p>The <code>Enforced</code> type is introduced to capture the difference between a policy been <em>reconciled</em> and it's been <em>enforced</em>
-at the service.</p>
-<p>States rationale:</p>
-<ul>
-<li><code>Enforced</code>: After a successful response of the <code>Service Probe</code>, this states communicates the policy is finally enforced.</li>
-<li><code>PartiallyEnforced</code>: This state will be set when the <code>Reconciliation</code> event encounters an overlap with other policies.</li>
-<li><code>Overridden</code>: This state will be set when the <code>Reconciliation</code> event invalidates the policy because another one takes precedence.</li>
-</ul>
-<p><img alt="" src="../0004-policy-status-assets/policy_status_5.png" /></p>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<p>In general, the new states and conditions align with <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#conditions">GEP-713</a>.</p>
-<p>Besides the proposed <code>Accepted</code> <em>PolicyType</em>, the <code>Enforced</code> <em>PolicyType</em> would be added to reflect the final state of
-the policy, which means that the policy is showing the synced actual state of the Kuadrant services.</p>
-<p>The missing <code>Failed</code> <em>PolicyType</em> would be implicitly represented by the <code>TargetNotFound</code> and <code>Invalid</code> <em>PolicyTypeReason</em>.</p>
-<h2 id="conditions">Conditions<a class="headerlink" href="#conditions" title="Permanent link">&para;</a></h2>
-<p>All conditions are top-level.</p>
-<table>
-<thead>
-<tr>
-<th>Type</th>
-<th>Status</th>
-<th>Reason</th>
-<th>Message</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>Accepted</td>
-<td>True</td>
-<td>"Accepted"</td>
-<td>"KuadrantPolicy has been accepted"</td>
-</tr>
-<tr>
-<td></td>
-<td>False</td>
-<td>"Conflicted"</td>
-<td>"KuadrantPolicy is conflicted by [policy-ns/policy-name], ..."</td>
-</tr>
-<tr>
-<td></td>
-<td>False</td>
-<td>"Invalid"</td>
-<td>"KuadrantPolicy is invalid"</td>
-</tr>
-<tr>
-<td></td>
-<td>False</td>
-<td>"TargetNotFound"</td>
-<td>"KuadrantPolicy target [resource-name] was not found"</td>
-</tr>
-<tr>
-<td>Enforced</td>
-<td>True</td>
-<td>"Enforced"</td>
-<td>"KuadrantPolicy has been successfully enforced"</td>
-</tr>
-<tr>
-<td></td>
-<td>False</td>
-<td>"Unknown"</td>
-<td>"KuadrantPolicy has encountered some issues"</td>
-</tr>
-<tr>
-<td></td>
-<td>False</td>
-<td>"Overridden"</td>
-<td>"KuadrantPolicy is overridden by [policy-ns/policy-name], ..."</td>
-</tr>
-</tbody>
-</table>
-<p>Messages corresponding <em>falsey</em> statuses are required and should reflect the error that encountered.</p>
-<p>It's possible to have the <em>Failed</em> state as a top level condition too. In this case, it might be useful to consider a
-third "Unknown" status.</p>
-<h2 id="policy-ancestor-status">Policy ancestor status<a class="headerlink" href="#policy-ancestor-status" title="Permanent link">&para;</a></h2>
-<p>The Status stanza of the policy CRs must implement Gateway API's <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#standard-status-struct">PolicyAncestorStatus</a>
-struct. This will provide broader consistency and improved discoverability of effective policies.</p>
-<h2 id="implementation-detailsrequisites">Implementation details/requisites<a class="headerlink" href="#implementation-detailsrequisites" title="Permanent link">&para;</a></h2>
-<p>Full implementation of Stage 2 states assumes reporting mechanisms in place, provided by the Kuadrant services, that
-allow tracing the state of the configurations applied on the services, back to the original policies, to infer the
-final state of the policy CRs (i.e. whether truly <code>Enforced</code> or not.)</p>
-<p>Without such, Stage 2 could be only partially achieved, by relying only on Reconciliation events.</p>
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<ul>
-<li>This proposal will require to change the code controllers assert the status</li>
-<li>Since the Status is part of the "API", won't be backwards compatible</li>
-<li>Documentation updating</li>
-<li>The implementation of the affected policies will create a <em>fan-out</em> problem, that might lead to updating many policy
-objects and apiserver load.</li>
-</ul>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<p>Another option was considered (previously referred to as "Option 1"). While valid, this alternative would not align
-with <a href="https://gateway-api.sigs.k8s.io/geps/gep-713">GEP-713</a>, neither it would be as flexible as
-the final design proposed.</p>
-<details>
-  <summary>Details of the discarded alternative</summary>
-
-  <br/>
-
-  This alternative design would come in 3 stages:
-
-  **Stage 1 : State of the policy CR defined by: application and validation of it**
-
-  This first stage is a simple version where the operator only relies on itself, not checking the healthiness with the
-  Kuadrant services, but just validating the Spec.
-
-  ![](0004-policy-status-assets/policy_status_1.png)
-
-  States rationale:
-
-  * `Created`: The initial state. It announces that the policy has successfully being created, the operator acknowledges it.
-  * `Applied`: This state is reached after the `Validation` event has being successfully passed.
-  * `Failed`: This one would be set when the `Validation` process encounters an error. This could be either condition's failed/error
-  state or a top-level condition.
-  * `Updated`: From `Failed` or `Applied`, it could be triggered a `Spec Change` event that would move it to this state.
-
-  **Stage 2: Further reconciliation check provides a new state**
-
-  This following one, besides checking what the former stage does, it also adds the states reflecting the reconciliation
-  process of any needed Kubernets object, Kuadrant Services custom resources and any other 3rd party CR required.
-  An example would be in the case of the RLP, it would create/update the `ConfigMap` holding the `Limitador` config file.
-
-  ![](0004-policy-status-assets/policy_status_2.png)
-
-  States rationale:
-
-  * `Applied`: The __Applied__ state would not be final, and would be preceding a `Reconciliation` event.
-  * `Reconciled`: It communicates that the policy has successfully being reconciled, and any K8s object or required CR has been updated.
-  * `Failed`: This one would be reached when either of `Validation` and `Reconcilation` processes have encounter any errors.
-
-  **Stage 3: Final state of the policy CR defined by: health check with the Kuadrant services (post-reconciliation)**
-
-  The final stage would bring a greater degree of accuracy, thanks for a final process that would check the healthiness and
-  configuration version the Kuadrant services currently enforces.
-
-  ![](0004-policy-status-assets/policy_status_3.png)
-
-  States rationale:
-
-  * `Reconciled`: This state would precede the "Health check" process  graphed as `Service Probe` event.
-  * `Enforced`: After a successful response of the `Service Probe`, this states communicates the policy is finally enforced.
-  This is the final top-level condition.
-  * `Failed`: Now this state could also be set after encountering errors in the `Service Probe` check.
-
-  <br/>
-
-  The stages before mentioned would follow the [Kubernetes guidelines](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#typical-status-properties)
-  regarding the Status object definition.
-
-  **Conditions**
-
-  All conditions are top-level.
-
-  | Type        | Status | Reason                      | Message                                                                     |
-  |-------------|--------|-----------------------------|-----------------------------------------------------------------------------|
-  | Progressing | True   | "PolicyCreated"             | "KuadrantPolicy created"                                                    |
-  |             | True   | "PolicyUpdated"             | "KuadrantPolicy has been updated"                                           |
-  |             | True   | "PolicyApplied"             | "KuadrantPolicy has been successfully applied                               |
-  |             | True   | "PolicyReconciled"          | "KuadrantPolicy has been successfully reconciled"                           |
-  |             | False  | "PolicyEnforced"            | "KuadrantPolicy has been successfully enforced"                             |
-  |             | False  | "PolicyError"               | "KuadrantPolicy has encountered an error"                                   |
-  | Enforced    | True   | "PolicyEnforced"            | "KuadrantPolicy has been successfully enforced"                             |
-  |             | False  | "PolicyPartiallyEnforced"   | "KuadrantPolicy has encountered some issues and has been partially applied" |
-  |             | False  | "PolicyOverridden"          | "KuadrantPolicy is overridden by [policy-ns/policy-name]"                   |
-  | Failed      | True   | "PolicyValidationError"     | "KuadrantPolicy has failed to validate"                                     |
-  |             | True   | "PolicyServiceError"        | "KuadrantPolicy has encountered has failed to enforce"                      |
-  |             | False  | "PolicyEnforced"            | "KuadrantPolicy has been successfully enforced"                             |
-</details>
-
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<ul>
-<li><a href="https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status">Kubernetes API Conventions</a></li>
-<li><a href="https://github.com/Kuadrant/kuadrant-operator/blob/main/controllers/KuadrantPolicy_status.go">Current KuadrantPolicy Status work</a></li>
-</ul>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Is it worthy to implement a state machine or state machine design pattern to achieve this set of conditions?</li>
-</ul>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<p>The implementation of this proposal could be part of <a href="https://github.com/Kuadrant/gateway-api-machinery">kuadrant/gateway-api-machinery</a>.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0005-single-cluster-dnspolicy/index.html b/0.10.0/architecture/rfcs/0005-single-cluster-dnspolicy/index.html
deleted file mode 100644
index 7982b217c..000000000
--- a/0.10.0/architecture/rfcs/0005-single-cluster-dnspolicy/index.html
+++ /dev/null
@@ -1,3624 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0005-single-cluster-dnspolicy/">
-      
-      
-        <link rel="prev" href="../0004-policy-status/">
-      
-      
-        <link rel="next" href="../0006-kuadrant_sub_components_configurations/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0005: Single Cluster DNSPolicy - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#single-cluster-dnspolicy" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0005: Single Cluster DNSPolicy
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0005-single-cluster-dnspolicy.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="single-cluster-dnspolicy">Single Cluster DNSPolicy<a class="headerlink" href="#single-cluster-dnspolicy" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>single-cluster-dnspolicy</code></li>
-<li>Start Date: 2023-10-09</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/30">Kuadrant/architecture#30</a></li>
-<li>Issue tracking: </li>
-<li><a href="https://github.com/Kuadrant/architecture/issues/31">Kuadrant/architecture#31</a></li>
-<li><a href="https://github.com/Kuadrant/architecture/issues/67">Kuadrant/architecture#67</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>Proposal for changes to the <code>DNSPolicy</code> API to allow it to provide a simple routing strategy as an option in a single cluster context. This will remove, but not negate, the complex DNS structure we use in a multi-cluster environment and in doing so allow use of popular dns integrators such as external-dns .</p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>The <a href="https://github.com/Kuadrant/multicluster-gateway-controller/blob/main/pkg/apis/v1alpha1/dnspolicy_types.go"><code>DNSPolicy</code></a> API (v1alpha1), was implemented as part of our multi cluster gateway offering using OCM and as such the design and implementation were influenced heavily by how we want multi cluster dns to work.</p>
-<ul>
-<li>Decouple the API entirely from OCM and multi cluster specific concepts.</li>
-<li>Simplify the DNS record structure created for a gateway listeners host for single cluster use.</li>
-<li>Improve the likelihood of adoption by creating an integration path for other kubernetes dns controllers such as <a href="https://github.com/kubernetes-sigs/external-dns">external-dns</a>.</li>
-</ul>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>The DNSPolicy can be used to target a Gateway in a single cluster context and will create dns records for each listener host in an appropriately configured external dns provider.
-In this context the advanced <code>loadbalancing</code> configuration is unnecessary, and the resulting DNSRecord can be created mapping individual listener hosts to a single DNS A or CNAME record by using the <code>simple</code> routing strategy in the DNSPolicy.</p>
-<p><strong>Example 1.</strong> DNSPolicy using <code>simple</code> routing strategy</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha2</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-gateways</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="nt">providerRef</span><span class="p">:</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route53-credentials</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">  </span><span class="nt">routingStrategy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">simple</span>
-</span></code></pre></div>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1beta1</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-gateways</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">  </span><span class="nt">gatewayClassName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">  </span><span class="nt">listeners</span><span class="p">:</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allowedRoutes</span><span class="p">:</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">        </span><span class="nt">namespaces</span><span class="p">:</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">          </span><span class="nt">from</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">All</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w">      </span><span class="nt">hostname</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;myapp.mn.hcpapps.net&quot;</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w">      </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTP</span>
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a><span class="nt">status</span><span class="p">:</span>
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a><span class="w">  </span><span class="nt">addresses</span><span class="p">:</span>
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">IPAddress</span>
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.200.0</span>
-</span></code></pre></div>
-<p>In the example the <code>api</code> listener has a hostname <code>myapp.mn.hcpapps.net</code> that matches a hosted zone being managed by the provider referenced <code>my-route53-credentials</code> in the DNSPolicy. 
-As the <code>simple</code> routing strategy is set in the DNSPolicy a DNSRecord resource with the following contents will be created:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha2</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSRecord</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web-api</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-gateways</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">  </span><span class="nt">providerRef</span><span class="p">:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route53-credentials</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">  </span><span class="nt">endpoints</span><span class="p">:</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myapp.mn.hcpapps.net</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.200.0</span>
-</span></code></pre></div>
-<p>The <code>providerRef</code> is included in the DNSRecord to allow the dns record controller to load the appropriate provider configuration during reconciliation and create the DNS records in the dns provider service e.g. route 53.</p>
-<p><strong>Example 2.</strong> DNSPolicy using <code>simple</code> routing strategy on multi cluster gateway</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha2</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-gateways</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">  </span><span class="nt">providerRef</span><span class="p">:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route53-credentials</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="w">  </span><span class="nt">routingStrategy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">simple</span>
-</span></code></pre></div>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1beta1</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-gateways</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="w">  </span><span class="nt">gatewayClassName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-multi-cluster-gateway-instance-per-cluster</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="w">  </span><span class="nt">listeners</span><span class="p">:</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allowedRoutes</span><span class="p">:</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="w">        </span><span class="nt">namespaces</span><span class="p">:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="w">          </span><span class="nt">from</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">All</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="w">      </span><span class="nt">hostname</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;myapp.mn.hcpapps.net&quot;</span>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a><span class="w">      </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTP</span>
-</span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a><span class="nt">status</span><span class="p">:</span>
-</span><span id="__span-4-18"><a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a><span class="w">  </span><span class="nt">addresses</span><span class="p">:</span>
-</span><span id="__span-4-19"><a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/MultiClusterIPAddress</span>
-</span><span id="__span-4-20"><a id="__codelineno-4-20" name="__codelineno-4-20" href="#__codelineno-4-20"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.200.0</span>
-</span><span id="__span-4-21"><a id="__codelineno-4-21" name="__codelineno-4-21" href="#__codelineno-4-21"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/MultiClusterIPAddress</span>
-</span><span id="__span-4-22"><a id="__codelineno-4-22" name="__codelineno-4-22" href="#__codelineno-4-22"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.201.0</span>
-</span></code></pre></div>
-<p>Similar to example 1, except here the Gateway is a multi cluster gateway that has had its status updated by the <code>Gateway</code> controller to include <code>kuadrant.io/MultiClusterIPAddress</code> type addresses.
-As the <code>simple</code> routing strategy is set in the DNSPolicy a DNSRecord resource with the following contents will be created:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha2</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSRecord</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web-api</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-gateways</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="w">  </span><span class="nt">providerRef</span><span class="p">:</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route53-credentials</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="w">  </span><span class="nt">endpoints</span><span class="p">:</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myapp.mn.hcpapps.net</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.200.0</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.201.0</span>
-</span></code></pre></div>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<h2 id="api-updates">API Updates<a class="headerlink" href="#api-updates" title="Permanent link">&para;</a></h2>
-<p>DNSPolicy:</p>
-<ul>
-<li>new providerRef field <code>spec.providerRef</code></li>
-<li>new routingStrategy field <code>spec.routingStrategy</code></li>
-<li>new api version <code>v1alpha2</code></li>
-</ul>
-<p>DNSRecord:</p>
-<ul>
-<li><code>spec.managedZone</code> replaced with <code>spec.providerRef</code></li>
-<li>new zoneID field <code>spec.zoneID</code> </li>
-<li>new api version <code>v1alpha2</code></li>
-</ul>
-<p>ManagedZone:</p>
-<ul>
-<li>ManagedZone API wil be removed and no longer supported as part of MGC/Kuadrant.</li>
-</ul>
-<h3 id="dnspolicyspecproviderref">DNSPolicy.spec.providerRef<a class="headerlink" href="#dnspolicyspecproviderref" title="Permanent link">&para;</a></h3>
-<p>The <code>providerRef</code> field is mandatory and contains a reference to a secret containing provider credentials.</p>
-<div class="language-text highlight"><pre><span></span><code>- `spec.providerRef.name` - name of the provider resource.
-</code></pre></div>
-<p>A <code>DNSPolicy</code> referencing a providerRef secret will expect that secret to exist in the same namespace. The expected contents of the secrets data is comparable to the <code>dnsProviderSecretRef</code> used by ManageZones.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">aws-credentials</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/aws</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="nt">data</span><span class="p">:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w">  </span><span class="nt">AWS_ACCESS_KEY_ID</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;foo&quot;</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="w">  </span><span class="nt">AWS_SECRET_ACCESS_KEY</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;bar&quot;</span>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">  </span><span class="nt">CONFIG</span><span class="p">:</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="w">    </span><span class="nt">zoneIDFilter</span><span class="p">:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Z04114632NOABXYWH93QUl</span>
-</span></code></pre></div>
-<p>The <code>CONFIG</code> section of the secrets data will be added to allow provider specific configuration to be stored alongside the providers credentials and can be used during the instantiation of the provider client, and during any provider operations.
-The above for example would use the <code>zoneIDFilter</code> value to limit what hosted zones this provider is allowed to update.</p>
-<h3 id="dnspolicyspecroutingstrategysimpleweightedgeo">DNSPolicy.spec.routingStrategy[simple|weightedGeo]<a class="headerlink" href="#dnspolicyspecroutingstrategysimpleweightedgeo" title="Permanent link">&para;</a></h3>
-<p>The <code>routingStrategy</code> field is mandatory and dictates what kind of dns record structure the policy will create. Two routing strategy options are allowed <code>simple</code> or <code>weightedGeo</code>.</p>
-<p>A reconciliation of DNSPolicy processes the target gateway and creates a DNSRecord per listener that is supported by the currently configured provider(hostname matches the hosted zones accessible with the credentials and config). The routing strategy used will determine the contents of the DNSRecord resources Endpoints array.</p>
-<h4 id="simple">simple<a class="headerlink" href="#simple" title="Permanent link">&para;</a></h4>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha2</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSRecord</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w">  </span><span class="nt">providerRef</span><span class="p">:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route53-credentials</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="w">  </span><span class="nt">endpoints</span><span class="p">:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myapp.mn.hcpapps.net</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.200.0</span>
-</span></code></pre></div>
-<p>Simple creates a single endpoint for an A record with multiple targets. Although intended for use in a single cluster context a simple routing strategy can still be used in a multi-cluster environment (OCM hub). In this scenario each clusters address will be added to the targets array to create a multi answer section in the dns response.</p>
-<h4 id="weightedgeo">weightedGeo<a class="headerlink" href="#weightedgeo" title="Permanent link">&para;</a></h4>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha2</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSRecord</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w">  </span><span class="nt">providerRef</span><span class="p">:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route53-credentials</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w">  </span><span class="nt">endpoints</span><span class="p">:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myapp.mn.hcpapps.net</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lb-4ej5le.myapp.mn.hcpapps.net</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lb-4ej5le.myapp.mn.hcpapps.net</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="w">      </span><span class="nt">providerSpecific</span><span class="p">:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">geo-code</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&#39;*&#39;</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="w">      </span><span class="nt">setIdentifier</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default.lb-4ej5le.myapp.mn.hcpapps.net</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default.lb-4ej5le.myapp.mn.hcpapps.net</span>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="w">      </span><span class="nt">providerSpecific</span><span class="p">:</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">weight</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;120&quot;</span>
-</span><span id="__span-8-26"><a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-8-27"><a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-8-28"><a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a><span class="w">      </span><span class="nt">setIdentifier</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lrnse3.lb-4ej5le.myapp.mn.hcpapps.net</span>
-</span><span id="__span-8-29"><a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-8-30"><a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lrnse3.lb-4ej5le.myapp.mn.hcpapps.net</span>
-</span><span id="__span-8-31"><a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lrnse3.lb-4ej5le.myapp.mn.hcpapps.net</span>
-</span><span id="__span-8-32"><a id="__codelineno-8-32" name="__codelineno-8-32" href="#__codelineno-8-32"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-8-33"><a id="__codelineno-8-33" name="__codelineno-8-33" href="#__codelineno-8-33"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A</span>
-</span><span id="__span-8-34"><a id="__codelineno-8-34" name="__codelineno-8-34" href="#__codelineno-8-34"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-8-35"><a id="__codelineno-8-35" name="__codelineno-8-35" href="#__codelineno-8-35"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.200.0</span>
-</span></code></pre></div>
-<p>WeightedGeo creates a more complex set of endpoints which use a combination of weighted and geo routing strategies. Although intended for use in a multi-cluster environment  (OCM hub) it will still be possible to use it in a single cluster context. In this scenario the record structure described above would be created for the single cluster.</p>
-<p>This is the current default for DNSPolicy in a multi-cluster environment (OCM hub) and more details about it can be found in the original <a href="https://github.com/Kuadrant/architecture/blob/main/rfcs/0003-dns-policy.md">DNSPolicy rfc</a>.</p>
-<h3 id="dnsrecordspecproviderref">DNSRecord.spec.providerRef<a class="headerlink" href="#dnsrecordspecproviderref" title="Permanent link">&para;</a></h3>
-<p>More details of <code>providerRef</code> found in <a href="#dnspolicyspecproviderref">DNSPolicy.spec.providerRef</a></p>
-<p>The DNSRecord API is updated to remove the <code>managedZone</code> reference in favour of directly referencing the <code>providerRef</code> credentials instead. The DNSRecord reconciliation will be unchanged except for loading the provider client from <code>providerRef</code> credentials.</p>
-<p>The DNSPolicy reconciliation will be updated to remove the requirement for a ManagedZone resource to be created before a DNSPolicy can create dns records for it, instead it will be replaced in favour of just listing available zones directly in the currently configured dns provider. If no matching zone is found, no DNSRecord will be created.</p>
-<p>There is a potential for a DNSRecord to be created successfully, but then a provider updated to remove access. In this case it is the responsibility of the DNSPolicy controller to report appropriate status back to the policy and target resource about the failure to process the record. More details on how status will be reported can be found in <a href="https://github.com/Kuadrant/architecture/blob/main/rfcs//0004-rlp-status.md">rfc-0004</a></p>
-<h3 id="dnsrecordspeczoneid">DNSRecord.spec.zoneID<a class="headerlink" href="#dnsrecordspeczoneid" title="Permanent link">&para;</a></h3>
-<p>The <code>zoneID</code> field is mandatory and contains the provider specific id of the hosted zone that this record should be published into. </p>
-<p>The DNSRecord reconciliation will use this zone when creating/updating or deleting endpoints for this record set. </p>
-<p>The <code>zoneID</code> should not change after being selected during initial creation and as such will be marked as immutable.</p>
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<p><a href="https://github.com/kubernetes-sigs/external-dns">ExternalDNS</a></p>
-<ul>
-<li>Uses annotations on the target Gateway as opposed to a proper API.</li>
-<li>Requires access to the HTTP route resources.</li>
-<li>Supports only a single provider per external dns instance.</li>
-</ul>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<p>When a provider is configured using a kind not supported by the <code>DNSPolicy</code> controller e.g. <code>ExternalDNS</code> we will be relying on an external controller to correctly update the status of any DNSRecord resources created by our policy. This may have a negative impact on our ability to correctly report status back to the target resource.</p>
-<p>When using a weightedGeo routing strategy in a single cluster context it is not expected that this will offer multi cluster capabilities without the use of OCM. Currently, it is expected that if you want to create a recordset that contains the addresses of multiple clusters you must use an OCM hub.</p>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<p>The ability to support other kubernetes dns controllers such as ExternalDNS would potentially allow us to contribute to some of these projects in the area of polices for dns management of Gateway resources in kubernetes.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0006-kuadrant_sub_components_configurations/index.html b/0.10.0/architecture/rfcs/0006-kuadrant_sub_components_configurations/index.html
deleted file mode 100644
index f4cf0a446..000000000
--- a/0.10.0/architecture/rfcs/0006-kuadrant_sub_components_configurations/index.html
+++ /dev/null
@@ -1,3580 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0006-kuadrant_sub_components_configurations/">
-      
-      
-        <link rel="prev" href="../0005-single-cluster-dnspolicy/">
-      
-      
-        <link rel="next" href="../0007-policy-sync-v1/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0006: Configuration of Kuadrant Sub Components - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#configuration-of-kuadrant-sub-components" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0006: Configuration of Kuadrant Sub Components
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0006-kuadrant_sub_components_configurations.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="configuration-of-kuadrant-sub-components">Configuration of Kuadrant Sub Components<a class="headerlink" href="#configuration-of-kuadrant-sub-components" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>sub-components-config</code></li>
-<li>Start Date: 2023-09-11</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/25">Kuadrant/architecture#25</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/kuadrant-operator/issues/163">Kuadrant/kuadrant-operator#163</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>Enable configuration of sub components of Kuadrant from a centralized location, namely the Kuadrant CR. </p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>The initial request comes from MGC to configure Redis for Limitador by the following issue <a href="https://github.com/Kuadrant/kuadrant-operator/issues/163">#163</a>.
-MGC's current work around is to update the Limitador CR after the deployment with the configuration setting for Redis Instance.
-This change would allow for the configuration of sub components before the Kuadrant is deployed. </p>
-<p>This reduces the number of CRs that users of Kuadrant are required to modify to get the installation they require.
-The sub components CRs (Authorino, Limitador) never have to be modified by a Kuadrant user (and should never be modified by a Kuadrant User).</p>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>As the Kuadrant operator would be responsible for reconciling these configurations into the requested components, restrictions and limitations can be placed on the components which maybe allowed in a standalone installation.
-An example in this space is the disk storage for Limitador which is a new feature and the Kuadrant installation may not want to support it till there is a proven track record for the feature.</p>
-<p>For existing Kuadrant Users this may be a possible breaking changes if those users manually configure the Kuadrant sub components via their CRs.
-A guide can be created to help migrate the users configurations to the Kuadrant CR.
-This guide can be part of the release notes and/or possibly released before the release of Kuadrant.</p>
-<p>The deployment configuration for each component can be placed in the Kuadrant CR.
-These configurations are then reconciled into the CRs for each component. 
-Only the options below are exposed in the Kuadrant CR. 
-All fields in the spec are optional.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Kuadrant</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-sample</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">    </span><span class="nt">limitador</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">        </span><span class="nt">afffinity</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">        </span><span class="nt">listener</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">        </span><span class="nt">pdb</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">        </span><span class="nt">replicas</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">        </span><span class="nt">resourceRequirements</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">        </span><span class="nt">storage</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">    </span><span class="nt">authorino</span><span class="p">:</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">        </span><span class="nt">evaluatorCacheSize</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">        </span><span class="nt">healthz</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">        </span><span class="nt">listener</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">        </span><span class="nt">logLevel</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">        </span><span class="nt">metrics</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">        </span><span class="nt">oidcServer</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">        </span><span class="nt">replicas</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">        </span><span class="nt">tracing</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">        </span><span class="nt">volumes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="nt">status</span><span class="p">:</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">    </span><span class="l l-Scalar l-Scalar-Plain">...</span>
-</span></code></pre></div>
-<p>The Kuadrant operator will watch for changes in the Authorino and Limitador CRs, reconciling back any changes that a user may do to these configurations.
-How ever Kuadrant operator will not reconcile fields that are given above. 
-An example of this is the <code>image</code> field on the Authorino CR.
-This field allows a user to set the image that Authorino is deployed with.
-The feature is meant for dev and testing purposes. 
-If a user wishes to use a different image, they can.
-Kuadrant assumes they know what they are doing but requires the user to set the change on the component directly.</p>
-<p>Only the sub component operator will be responsible for actioning the configurations pasted from the Kuadrant CR to the sub components CR.
-This ensure no extra changes will be required in the sub operators to meet the needs of Kuadrant.</p>
-<p>Status errors related to the configuration of the sub components should be reported back to the Kuadrant CR.
-The errors messages in Kuadrant state what components are currently having issue and which resource to review for more details.</p>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<p>All the fields in the Authorino and Limitador CRs that are configurable in the Kuadrant CR are optional and have sound defaults.
-Kuadrant needs to remain installable with out having to set any spec in the Kuadrant CR.</p>
-<p>The Kuadrant operator should only reconcile the spec that is given. 
-This would mean if the user states the number of replicas to be used in one of the components only the replica field for that component should be reconciled.
-As the other fields would be blank at this stage, blank fields would not be reconciled to the component CR.
-By this behaviour a few things are being achieved.
-Component controllers define the defaults to be used in the components.
-Optional fields in the component CRs never get set with blank values.
-Blank values in the component CR could override the defaults of the components causing unexpected behaviour.
-Existing Kuadrant users may already have custom fields set in the component CRs.
-By only reconciling the fields set in the kuadrant CR this allows time for a user to migrate their custom configuration from the component CR to the Kuadrant CR.</p>
-<h2 id="fields-to-reconcile">Fields to reconcile<a class="headerlink" href="#fields-to-reconcile" title="Permanent link">&para;</a></h2>
-<p>Fields being reconcile can be classified into different groups.
-These classifications are based around the tasks a user is achieve.</p>
-<ul>
-<li>Kubernetes native, setting that affect how Kubernetes handles the resource.</li>
-<li>Observability, configuration settings that allow insights into how the applications are operation.
-This can be Kubernetes native or external tooling.</li>
-<li>Application Settings, setting targeting the application and how it connects to external services.</li>
-</ul>
-<h3 id="authorino-spec">Authorino Spec<a class="headerlink" href="#authorino-spec" title="Permanent link">&para;</a></h3>
-<h4 id="kubernetes-native">Kubernetes native<a class="headerlink" href="#kubernetes-native" title="Permanent link">&para;</a></h4>
-<ul>
-<li>replicas</li>
-</ul>
-<h4 id="observability">Observability<a class="headerlink" href="#observability" title="Permanent link">&para;</a></h4>
-<ul>
-<li>healthz</li>
-<li>logLevel</li>
-<li>metrics</li>
-<li>tracing</li>
-</ul>
-<h4 id="application-settings">Application Settings<a class="headerlink" href="#application-settings" title="Permanent link">&para;</a></h4>
-<ul>
-<li>evaluatorCacheSize</li>
-<li>listener</li>
-<li>oidcServer</li>
-<li>volumes</li>
-</ul>
-<h3 id="limitador-spec">Limitador Spec<a class="headerlink" href="#limitador-spec" title="Permanent link">&para;</a></h3>
-<h4 id="kubernetes-native_1">Kubernetes native<a class="headerlink" href="#kubernetes-native_1" title="Permanent link">&para;</a></h4>
-<ul>
-<li>afffinity</li>
-<li>pdb</li>
-<li>replicas</li>
-<li>resourceRequirements</li>
-</ul>
-<h4 id="application-settings_1">Application Settings<a class="headerlink" href="#application-settings_1" title="Permanent link">&para;</a></h4>
-<ul>
-<li>listener</li>
-<li>storage</li>
-</ul>
-<h2 id="fields-not-reconciled">Fields not reconciled<a class="headerlink" href="#fields-not-reconciled" title="Permanent link">&para;</a></h2>
-<p>There are a number of fields in both Authorino and Limitador that are not reconciled.
-Reasons for doing this are:</p>
-<p>It is better to start with a sub set of features and expand to include more at a later date.
-Removing feature support is far harder than adding it.</p>
-<p>There are four classifications the unreconciled fields fail into.</p>
-<ul>
-<li>Deprecated, fields that are deprecated and/or have plans to be removed from the spec in the future.</li>
-<li>Unsupported, the features would have hard coded or expected defaults in the Kuadrant operator. 
-Work would be required to all the custom configurations options.</li>
-<li>Dev/Testing focused, features that should only be used during development &amp; testing and not recommended for production.
-The defaults would for the fields are the production recommendations.</li>
-<li>Reconciled by others, this mostly affects Limitador as the deployment configuration and runtime configuration are in the same CR.
-In the case of Kuadrant the runtime configuration for Limitador is added via the RateLimitingPolicy CR.</li>
-</ul>
-<h3 id="authorino-spec_1">Authorino Spec<a class="headerlink" href="#authorino-spec_1" title="Permanent link">&para;</a></h3>
-<h4 id="unsupported">Unsupported<a class="headerlink" href="#unsupported" title="Permanent link">&para;</a></h4>
-<ul>
-<li>clusterWide</li>
-<li>authConfigLabelSelectors</li>
-<li>secretLabelSelectors</li>
-</ul>
-<h4 id="devtesting-focused">Dev/Testing focused<a class="headerlink" href="#devtesting-focused" title="Permanent link">&para;</a></h4>
-<ul>
-<li>image</li>
-<li>imagePullPolicy</li>
-<li>logMode</li>
-</ul>
-<h3 id="limitador-spec_1">Limitador Spec<a class="headerlink" href="#limitador-spec_1" title="Permanent link">&para;</a></h3>
-<h4 id="unsupported_1">Unsupported<a class="headerlink" href="#unsupported_1" title="Permanent link">&para;</a></h4>
-<ul>
-<li>RateLimitHeaders</li>
-</ul>
-<h4 id="reconciled-by-others">Reconciled by others<a class="headerlink" href="#reconciled-by-others" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Limits</li>
-</ul>
-<h4 id="deprecated">Deprecated<a class="headerlink" href="#deprecated" title="Permanent link">&para;</a></h4>
-<ul>
-<li>version</li>
-</ul>
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<p>As the Kuadrant CR spec will be a sub set of the features that can be configured in the sub components spec, extra maintenances will be required to ensure specs are in sync.</p>
-<p>New features of a component will not be accessible in Kuadrant initially.
-This is both a pro and a con.</p>
-<p>Documentation becomes harder, as the sub component should be documenting their own features but in Kuadrant the user does not configure the feature in sub component.
-This has the risk of confusing new users.</p>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Why is this design the best in the space of possible designs?</li>
-<li>What other designs have been considered and what is the rationale for not choosing them?</li>
-<li>What is the impact of not doing this?</li>
-</ul>
-<p>One alternative that was being looked at was allowing the user to bring their own Limitador instances by stating which Limitador CR Kuadrant should use. 
-A major point of issue with this approach was knowing what limits the user had configured and what limits Kuadrant configured. 
-Sharing global counters is a valid reason to want to share Limitador instances. 
-How ever it this case Limitador would not be using one replica and therefore would have a back-end storage configured.
-It is the back-end storage that needs to be shared across instances.
-This can be done with adding the configuration in the Kuadrant CR.</p>
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<p>Discuss prior art, both the good and the bad, in relation to this proposal.
-A few examples of what this can include are:</p>
-<ul>
-<li>Does another project have a similar feature?</li>
-<li>What can be learned from it? What's good? What's less optimal?</li>
-<li>Papers: Are there any published papers or great posts that discuss this? If you have some relevant papers to refer to, this can serve as a more detailed theoretical background.</li>
-</ul>
-<p>This section is intended to encourage you as an author to think about the lessons from other tentatives - successful or not, provide readers of your RFC with a fuller picture.</p>
-<p>Note that while precedent set by other projects is some motivation, it does not on its own motivate an RFC.</p>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<ul>
-<li>What parts of the design do you expect to resolve through the RFC process before this gets merged?</li>
-<li>What parts of the design do you expect to resolve through the implementation of this feature before stabilization?</li>
-<li>What related issues do you consider out of scope for this RFC that could be addressed in the future independently of the solution that comes out of this RFC?</li>
-</ul>
-<hr />
-<ul>
-<li>Is there a need to add validation on the configuration?</li>
-<li>If a valid configuration is add to the Kuadrant CR and this configuration is pass to the sub components CR but there is a error trying to setting up the configuration.
-How is this error reported back to the user? 
-An example of this is configuring Redis as the back-end in Limitador, this requires stating the name and namespace of a configmap.
-The Limitador CR will have an error if the configmap does not exist and as the user only configures the Kuadrant CR this error may go unnoticed.
-This is only one example but there is a need for good error reporting back to the user, where they would expect to see the error.</li>
-</ul>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<p>Think about what the natural extension and evolution of your proposal would be and how it would affect the platform and project as a whole. Try to use this section as a tool to further consider all possible interactions with the project and its components in your proposal. Also consider how this all fits into the roadmap for the project and of the relevant sub-team.</p>
-<p>This is also a good place to "dump ideas", if they are out of scope for the RFC you are writing but otherwise related.</p>
-<p>Note that having something written down in the future-possibilities section is not a reason to accept the current or a future RFC; such notes should be in the section on motivation or rationale in this or subsequent RFCs. The section merely provides additional information.</p>
-<hr />
-<p>The implementation stated here allows the user to state spec fields in the component CRs or the Kuadrant CR (Kuadrant CR overrides the component CRs).
-A future possibility would be to warn the user if they add configuration to the components CRs that would get overridden if the same spec fields are configured in the Kuadrant CR.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0007-policy-sync-v1/index.html b/0.10.0/architecture/rfcs/0007-policy-sync-v1/index.html
deleted file mode 100644
index 76ebf7d56..000000000
--- a/0.10.0/architecture/rfcs/0007-policy-sync-v1/index.html
+++ /dev/null
@@ -1,3526 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0007-policy-sync-v1/">
-      
-      
-        <link rel="prev" href="../0006-kuadrant_sub_components_configurations/">
-      
-      
-        <link rel="next" href="../0008-kuadrant-release-process/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0007: Policy Sync - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#rfc-policy-sync" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0007: Policy Sync
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0007-policy-sync-v1.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="rfc-policy-sync">RFC - Policy Sync<a class="headerlink" href="#rfc-policy-sync" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>policy_sync_v1</code></li>
-<li>Start Date: 2023-10-10</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/0000">Kuadrant/architecture#0000</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/architecture/issues/26">https://github.com/Kuadrant/architecture/issues/26</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>The ability for the Multicluster Gateway Controller to sync policies defined in
-the hub cluster downstream to the spoke clusters, therefore allowing all policies
-to be defined in the same place. These policies will be reconciled by the downstream
-policy controller(s).</p>
-<h1 id="nomenclature">Nomenclature<a class="headerlink" href="#nomenclature" title="Permanent link">&para;</a></h1>
-<ul>
-<li>
-<p>Policy: When refering to a Policy, this document is refering to a Gateway API
-  policy as defined in the Policy Attachment Model. The Multicluster Gateway Controller
-  relies on <a href="https://open-cluster-management.io/">OCM</a> as a Multicluster solution, which defines its own unrelated
-  set of Policies and Policy Framework. Unless explicitely mentioned, this document
-  refers to Policies as Gateway API Policies.</p>
-</li>
-<li>
-<p>Policy overriding: The concept of policy overriding is mentioned in this document. It refers to the proposed ability of the downstream Gateway implementation to prioritise downstream Policies against synced Policies in case of conflicts.</p>
-</li>
-</ul>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>Currently, Kuadrant's support for the Policy Attachment Model can be divided in
-two categories:</p>
-<ul>
-<li>Policies targeting the Multicluster Gateway, defined in the hub cluster and
-  reconciled by the Multicluster Gateway Controller</li>
-<li>Policies targeting the downstream Gateway, defined in the spoke clusters and
-  reconciled by the downstream Gateway controllers.</li>
-</ul>
-<p>In a realistic multicluster scenario where multiple spoke clusters are present, the management of these policies can become tedious and error-prone, as policies have
-to be defined in the hub cluster, as well as replicated in the multiple spoke clusters.</p>
-<p>As Kuadrant users:</p>
-<ul>
-<li>Gateway-admin has a set of homogeneous clusters and needs to apply per cluster rate limits across the entire set.</li>
-<li>Platform-admin with a set of clusters with rate limits applied needs to change rate limit for one particular cluster. </li>
-</ul>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>The policy sync feature will allow a gateway-admin to configure, via GatewayClass
-parameters, a set of Policy GVRs to be synced by the Multicluster Gateway Controller.</p>
-<p>The <code>policiesToSync</code> field in the parameters defines those GVRs. For example, in
-order to configure the controller to sync AuthPolicies:</p>
-<div class="language-json highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">&quot;policiesToSync&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">  </span><span class="p">{</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">    </span><span class="nt">&quot;group&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;kuadrant.io&quot;</span><span class="p">,</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">    </span><span class="nt">&quot;version&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;v1beta1&quot;</span><span class="p">,</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">    </span><span class="nt">&quot;resource&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;authpolicies&quot;</span><span class="w"> </span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="p">}</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="p">]</span>
-</span></code></pre></div>
-<p>The support for resources that the controller can sync is limited by the following:</p>
-<ul>
-<li>The controller ServiceAccount must have permission to watch, list, and get the
-  resource to be synced</li>
-<li>The resource must implement the Policy schema:<ul>
-<li>Have a <code>.spec.targetRef</code> field</li>
-</ul>
-</li>
-</ul>
-<p>When a Policy is configured to be synced in a GatewayClass, the Multicluster
-Gateway Controller starts watching events on the resources, and propagates changes
-by placing the policy in the spoke clusters, with the following mutations:</p>
-<ul>
-<li>The <code>TargetRef</code> of the policy is changed to reference the downstream Gateway</li>
-<li>The <code>kuadrant.io/policy-synced</code> annotation is set</li>
-</ul>
-<p>The upstream policy is annotated with a reference to the name and namespace
-of the downstream policies:
-  <div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">annotations</span><span class="p">:</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w">  </span><span class="s">&quot;kuadrant.io/policies-synced&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="s">&quot;[{\&quot;cluster\&quot;:</span><span class="nv"> </span><span class="s">\&quot;...\&quot;,</span><span class="nv"> </span><span class="s">\&quot;name\&quot;:</span><span class="nv"> </span><span class="s">\&quot;...\&quot;,</span><span class="nv"> </span><span class="s">\&quot;namespace\&quot;:</span><span class="nv"> </span><span class="s">\&quot;...\&quot;}]&quot;</span>
-</span></code></pre></div></p>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<h3 id="process-overview">Process overview<a class="headerlink" href="#process-overview" title="Permanent link">&para;</a></h3>
-<h4 id="dynamic-policy-watches">Dynamic Policy watches<a class="headerlink" href="#dynamic-policy-watches" title="Permanent link">&para;</a></h4>
-<p>The Multicluster Gateway Controller reconciles parameters referenced by the
-GatewayClass of a Gateway. A new field is added to the parameters that allows
-the configuration of a set of GVRs of Policies to be synced.</p>
-<p>The GatewayClass reconciler validates that:</p>
-<ul>
-<li>The GVRs reference existing resource definitions</li>
-<li>The GVRs reference resources that implement the Policy schema.</li>
-</ul>
-<p>Validation failures are reported as part of the status of the GatewayClass</p>
-<p>The Gateway reconciler sets up dynamic watches to react to events on the configured
-Policies, calling the PolicySyncer component with the updated Policy as well
-as the associated Gateway.</p>
-<h4 id="policysyncer-component">PolicySyncer component<a class="headerlink" href="#policysyncer-component" title="Permanent link">&para;</a></h4>
-<p>The PolicySyncer component is in charge of reconciling Policy watch events to
-apply the necessary changes and place the Policies in the spoke clusters.</p>
-<p>This component is injected in the event source and called when a change is made
-to a hub Policy that has been configured to be synced.</p>
-<p>The PolicySyncer implementation uses OCM ManifestWorks to place the policies in
-the spoke clusters. Through the ManifestWorks, OCM allows to:</p>
-<ul>
-<li>Place the Policy in each spoke cluster</li>
-<li>Report the desired status back to the hub using JSON feedback rules</li>
-</ul>
-<h3 id="policy-hierarchy">Policy Hierarchy<a class="headerlink" href="#policy-hierarchy" title="Permanent link">&para;</a></h3>
-<p>In order to avoid conflict with Policies created directly in the spoke clusters,
-a hierarchy must be defined to prioritise those Policies.</p>
-<p>The controller will set the <code>kuadrant.io/policy-synced</code> annotation on the policy
-when placing it in the spoke cluster.</p>
-<p>The Kuadrant operator will be aware of the presence of this annotation, and, in case
-of conflicts, override Policies that contain this annotation. When a policy is
-overriden due to conflicts, the <code>Enforced</code> status will be set to <code>False</code>, with
-the reason being <code>Overriden</code> and a human readable message explaining the reason
-why the policy was overriden. See <a href="../0004-policy-status/">Policy Status RFC</a></p>
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<h2 id="third-party-policy-support">Third party Policy support<a class="headerlink" href="#third-party-policy-support" title="Permanent link">&para;</a></h2>
-<p>In order for a Policy to be supported for syncing, the MGC must have permissions
-to watch/list/get the resource, and the implementation of the downstream Gateway
-controller must be aware of the <code>policy-synced</code> annotation.</p>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<h2 id="alternatives">Alternatives<a class="headerlink" href="#alternatives" title="Permanent link">&para;</a></h2>
-<p>Different technology stacks are available to sync resources across clusters. However, adoption of these technologies for the purpose of the goal this RFC intends to achieve, implies adding another dependency to the current stack, with the cost of added complexity and maintainance effort.</p>
-<p>The MGC currently uses OCM to place Gateways across clusters. Relying on OCM for the purpose of placing Policies is the most straightforward alternative from a design and implementation point of view.</p>
-<h2 id="consequences-of-not-implementing">Consequences of not implementing<a class="headerlink" href="#consequences-of-not-implementing" title="Permanent link">&para;</a></h2>
-<p>Gateway-admins will have no centralized system for handling spoke-level policies targeting a gateway created there from the hub.</p>
-<h4 id="ocms-policy-framework-will-not-be-used-to-complete-this-objective">OCMs Policy Framework will not be used to complete this objective:<a class="headerlink" href="#ocms-policy-framework-will-not-be-used-to-complete-this-objective" title="Permanent link">&para;</a></h4>
-<p>OCMs Policy Framework is a system designed to make assertions about the state of a spoke, and potentially take actions based on that state, as such it is not a suitable replacement for manifestworks in the case of syncing resources to a spoke.</p>
-<h3 id="potential-migration-from-manifestworks-to-manifestworkreplicasets">Potential migration from ManifestWorks to ManifestWorkReplicaSets<a class="headerlink" href="#potential-migration-from-manifestworks-to-manifestworkreplicasets" title="Permanent link">&para;</a></h3>
-<p>ManifestWorkPeplicaSets may be a future improvement that the MGC could support
-to simplify the placement of related resources, but beyond the scope of this RFC.</p>
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<p>No applicable prior art.</p>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<h2 id="status-reporting">Status reporting<a class="headerlink" href="#status-reporting" title="Permanent link">&para;</a></h2>
-<p>While the controller can assume common status fields among the Policies that it
-syncs, there might be a scenario where certain policies use custom status fields
-that are not handled by the controller. In order to support this, two alternatives
-are identified:</p>
-<ol>
-<li>
-<p>Configurable rules.</p>
-<p>An extra field is added in the GatewayClass params that configures the policies
-to sync, to specify custom fields that the controller must propagate back from
-the spokes to the hub.</p>
-</li>
-<li>
-<p>Hard-coded support.</p>
-<p>The PolicySync component can identify the Policy type and select which extra
-status fields are propagated </p>
-</li>
-</ol>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<p>If OCMs Policy Framework is updated to enable syncing of resources status back to the hub, it could be an opportunity to refactor the MGC to use this framework in place of the current approach of creating ManifestWorks directly.</p>
-<p>This system could mutate over time to dynamically sync more CRDs than policies to spoke clusters.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0008-kuadrant-release-process/index.html b/0.10.0/architecture/rfcs/0008-kuadrant-release-process/index.html
deleted file mode 100644
index 90962889a..000000000
--- a/0.10.0/architecture/rfcs/0008-kuadrant-release-process/index.html
+++ /dev/null
@@ -1,3647 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0008-kuadrant-release-process/">
-      
-      
-        <link rel="prev" href="../0007-policy-sync-v1/">
-      
-      
-        <link rel="next" href="../0009-defaults-and-overrides/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0008: Kuadrant Release Process - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-release-process" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0008: Kuadrant Release Process
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0008-kuadrant-release-process.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrant-release-process">Kuadrant Release Process<a class="headerlink" href="#kuadrant-release-process" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>kuadrant-release-process</code></li>
-<li>Start Date: 2024-01-11</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/46">Kuadrant/architecture#46</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/architecture/issues/59">Kuadrant/architecture#59</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>Kuadrant is a set of components whose artifacts are built and delivered independently. This RFC aims to define every
-aspect of the event of releasing a new version of the whole, in terms of versioning, cadence, communication, channels,
-handover to other teams, etc.</p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>At the time being, there's no clear process nor guidelines to follow when releasing a new version of Kuadrant, which
-leads to confusion and lack of transparency. We are currently relying on internal communication and certain people
-in charge of the release process, which is not ideal.</p>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>First, we need to define what releasing Kuadrant means, in a clear and transparent way that communicates to the community
-what's happening and what to expect. The Kuadrant suite is composed of several components, each of them with its own
-set of artifacts and versioning scheme. Defining the release process of the whole suite is a complex task, and it's
-not only about the technical details of releasing the components, but also about the communication and transparency
-with the community, the definition of the frequency of the releases, and when it's ready to be handover to other teams like
-QA. This section aims to provide guidelines for the different aspects of the release process.</p>
-<h2 id="components-and-versioning">Components and versioning<a class="headerlink" href="#components-and-versioning" title="Permanent link">&para;</a></h2>
-<p>The set of components that are part of the <em>Kuadrant suite</em> are the following:</p>
-<ul>
-<li><a href="https://github.com/Kuadrant/authorino">Authorino</a>: Kubernetes-native authorization service for tailor-made Zero Trust API security.</li>
-<li><a href="https://github.com/Kuadrant/authorino-operator">Authorino Operator</a>: A Kubernetes Operator to manage Authorino instances.</li>
-<li><a href="https://github.com/Kuadrant/limitador">Limitador</a>: A generic rate-limiter written in Rust.</li>
-<li><a href="https://github.com/Kuadrant/limitador-operator/">Limitador Operator</a>: A Kubernetes Operator to manage Limitador deployments.</li>
-<li><a href="https://github.com/Kuadrant/wasm-shim/">Wasm Shim</a>: A Proxy-Wasm module written in Rust, acting as a shim between Envoy and Limitador.
-connectivity and global load balancing.</li>
-<li><a href="https://github.com/Kuadrant/dns-operator">DNS Operator</a>: A Kubernetes Operator to manage DNS in single and multi-cluster
-environments.</li>
-<li><a href="https://github.com/Kuadrant/kuadrant-operator/">Kuadrant Operator</a>: The Operator to install and manage the lifecycle
-  of the Kuadrant components deployments. Example alerts and dashboards are also included as optional.</li>
-<li><a href="https://github.com/Kuadrant/kuadrantctl">kuadrantctl</a>: A CLI tool for managing Kuadrant configurations and resources.</li>
-</ul>
-<p>Each of them needs to be versioned independently, and the versioning scheme should follow <a href="https://semver.org/">Semantic Versioning</a>.
-At the time of cutting a release for any of them, it's important to keep in mind what section of the version to bump,
-given a version number MAJOR.MINOR.PATCH, increment the:</p>
-<ul>
-<li>MAJOR version when you make incompatible API changes</li>
-<li>MINOR version when you add functionality in a backward compatible manner</li>
-<li>PATCH version when you make backward compatible bug fixes</li>
-</ul>
-<p>Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.</p>
-<p>A more detailed explanation of the versioning scheme can be found in the <a href="https://semver.org/">Semantic Versioning</a> website.</p>
-<p>By releasing a new version of Kuadrant, we mean releasing the set of components with their corresponding semantic versioning,
-some of them maybe freshly released, or others still using versioning from the previous one, and being the version of the
-<strong>Kuadrant Operator</strong> the one that defines the version of the whole suite.</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>Kuadrant Suite vx.y.z = Kuadrant Operator vx.y.z +  Authorino Operator va.b.c + Limitador Operator vd.e.f + DNS Operator vg.h.i + MGC Controller vj.k.l + Wasm Shim vm.n.o
-</span></code></pre></div>
-<p>The technical details of how to release each component are out of the scope of this RFC and could be found in the
-<a href="https://github.com/Kuadrant/architecture/pull/41">Kuadrant components CI/CD</a> RFC.</p>
-<h2 id="qa-sanity-check">QA Sanity Check<a class="headerlink" href="#qa-sanity-check" title="Permanent link">&para;</a></h2>
-<p>Probably the most important and currently missing step in the release process is the green flagging from the Quality Assurance
-(QA) team. The QA team is responsible for testing the different components of the Kuadrant suite, and they need to
-be aware of the new version of the suite that is going to be released, what are the changes that are included, bug fixes
-and new features in order they can plan their testing processes accordingly. This check is not meant to be a fully fledged
-assessment from the QA team when it's handover to them, it's aimed to not take more than 1-2 days, and ideally expected
-to be fully automated. This step will happen once the release candidate has no PRs pending to be merged, and it has been
-tested by the Engineering team. The QA team should work closely to the engineering throughout the process, both teams aiming
-for zero handover time and continuous delivery mindset, so immediate testing can be triggered on release candidates once
-handed over. This process should happen without the need of formal communication between the teams or any overhead in
-general, but by keeping constant synergy between quality and product engineering instead.</p>
-<p>There is an ideal time to hand over to the QA team for testing, especially since we are using GitHub for orchestration,
-we could briefly define it in the following steps:</p>
-<ol>
-<li>Complete Development Work: The engineering team completes their work included in the milestone.</li>
-<li>Create Release Candidate: The engineering team creates Release Candidate builds and manifests for all components required
-for the release</li>
-<li>Flagging/Testing: The QA team do the actual assertion/testing of the release candidate, checking for any obvious bugs or issues.
-Then QA reports all the bugs as GitHub issues and communicates testing status back publicly on Slack and/or email.</li>
-<li>Iterate: Based on the feedback from the QA team, the Engineering team makes any necessary adjustments and repeats the
-process until the release candidate is deemed ready for production.</li>
-<li>Publish Release: Once QA communicates that the testing has been successfully finished, the engineering team will publish
-the release both on Github and in the corresponding registries, updates documentation for the new release, and communicates
-it to all channels specified in Communication section.</li>
-</ol>
-<h2 id="cadence">Cadence<a class="headerlink" href="#cadence" title="Permanent link">&para;</a></h2>
-<p>Once the project is stable enough, and its adoption increases, the community will be expecting a certain degree of
-commitment from the maintainers, and that includes a regular release cadence. The frequency of the releases of the
-different components could vary depending on the particular component needs. However, the <strong>Kuadrant Operator</strong>
-it's been discussed in the past that it should be released every 3-4 weeks initially, including the latest released version
-of every component in the suite. There's another RFC that focuses on the actual frequency of each component, one could
-refer to the <a href="https://github.com/pmccarthy/architecture/blob/release-cadence-proposal/rfcs/0007-project-release-cadence.md">Kuadrant Release Cadence RFC</a>.</p>
-<p>There are a few reasons for this:</p>
-<ul>
-<li>Delivering Unparalleled Value to Users: Regular releases can provide users with regular updates and improvements.
-  These updates can include new features and essential bug fixes, thus enhancing the overall value delivered to the users.</li>
-<li>Resource Optimization: By releasing software at regular intervals, teams can align their activities with
-  available resources and environments, ensuring optimal utilization. This leads to increased efficiency in the deployment
-  process and reduces the risk of resource wastage.</li>
-<li>Risk Management: Regular releases can help identify and fix issues early, reducing the risk of major failures that could
-  affect users.</li>
-<li>Feedback Cycle: Regular releases allow for quicker feedback cycles. This means that any issues or improvements
-  identified by users can be addressed promptly, leading to a more refined product over time.</li>
-<li>Synchronization: Regular releases can help synchronize work across different teams or departments, creating a more
-  reliable, dependable solution development and delivery process.</li>
-<li>Reduced Complexity: Managing a smaller number of releases can reduce complexity. For example, having many different
-  releases out in the field can lead to confusion and management overhead.</li>
-</ul>
-<p>By committing to a release cadence, software projects can benefit from improved efficiency, risk management, faster feedback
-cycles, synchronization, and reduced complexity.</p>
-<h2 id="repositories-and-hubs">Repositories and Hubs<a class="headerlink" href="#repositories-and-hubs" title="Permanent link">&para;</a></h2>
-<p>Every component in Kuadrant has its own repository, and the source code is hosted in GitHub, mentioned in the previous
-section. However, the images built and manifests generated are hosted in different registries, depending on the
-component. The following table shows the different registries used by each component:</p>
-<table>
-<thead>
-<tr>
-<th>Component</th>
-<th>Artifacts</th>
-<th>Registry / Hub</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>Authorino</td>
-<td>authorino images</td>
-<td><a href="https://quay.io/repository/kuadrant/authorino">Quay.io</a></td>
-</tr>
-<tr>
-<td>Authorino Operator</td>
-<td>authorino-operator images</td>
-<td><a href="https://quay.io/repository/kuadrant/authorino-operator">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>authorino-operator-bundle images</td>
-<td><a href="https://quay.io/repository/kuadrant/authorino-operator-bundle">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>authorino-operator-catalog images</td>
-<td><a href="https://quay.io/repository/kuadrant/authorino-operator-catalog">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>authorino-operator manifests</td>
-<td><a href="https://operatorhub.io/operator/authorino-operator">OperatorHub.io</a></td>
-</tr>
-<tr>
-<td>Limitador</td>
-<td>limitador server images</td>
-<td><a href="https://quay.io/repository/kuadrant/limitador">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>limitador crate</td>
-<td><a href="https://crates.io/crates/limitador">Crates.io</a></td>
-</tr>
-<tr>
-<td>Limitador Operator</td>
-<td>limitador-operator images</td>
-<td><a href="https://quay.io/repository/kuadrant/limitador-operator">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>limitador-operator-bundle images</td>
-<td><a href="https://quay.io/repository/kuadrant/limitador-operator-bundle">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>limitador-operator-catalog images</td>
-<td><a href="https://quay.io/repository/kuadrant/limitador-operator-catalog">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>limitador-operator manifests</td>
-<td><a href="https://operatorhub.io/operator/limitador-operator">OperatorHub.io</a></td>
-</tr>
-<tr>
-<td>Wasm Shim</td>
-<td>wasm-shim images</td>
-<td><a href="https://quay.io/repository/kuadrant/wasm-shim">Quay.io</a></td>
-</tr>
-<tr>
-<td>DNS Operator</td>
-<td>dns-operator images</td>
-<td><a href="https://quay.io/repository/kuadrant/dns-operator">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>dns-operator-bundle images</td>
-<td><a href="https://quay.io/repository/kuadrant/dns-operator-bundle">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>dns-operator-catalog images</td>
-<td><a href="https://quay.io/repository/kuadrant/dns-operator-catalog">Quay.io</a></td>
-</tr>
-<tr>
-<td>Kuadrant Operator</td>
-<td>kuadrant-operator images</td>
-<td><a href="https://quay.io/repository/kuadrant/kuadrant-operator">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>kuadrant-operator-bundle images</td>
-<td><a href="https://quay.io/repository/kuadrant/kuadrant-operator-bundle">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>kuadrant-operator-catalog images</td>
-<td><a href="https://quay.io/repository/kuadrant/kuadrant-operator-catalog">Quay.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>kuadrant-operator manifests</td>
-<td><a href="https://operatorhub.io/operator/kuadrant-operator">OperatorHub.io</a></td>
-</tr>
-<tr>
-<td></td>
-<td>kuadrant-operator source (includes example dashboards and alerts)</td>
-<td><a href="https://github.com/Kuadrant/kuadrant-operator/releases">Github Releases</a></td>
-</tr>
-<tr>
-<td>kuadrantctl</td>
-<td>kuadrantctl CLI</td>
-<td><a href="https://github.com/Kuadrant/kuadrantctl/releases">Github Releases</a></td>
-</tr>
-</tbody>
-</table>
-<h2 id="documentation">Documentation<a class="headerlink" href="#documentation" title="Permanent link">&para;</a></h2>
-<p>It's important to  note that keeping the documentation up to date is a responsibility of the component maintainers, and
-it needs to be done before releasing a new version of the component. The importance of keeping a clear and up-to-date
-documentation is crucial for the success of the project.</p>
-<p>The documentation for the Kuadrant suite is compiled and available on the <a href="https://kuadrant.io/">Kuadrant website</a>. One
-can find the source of the documentation within each component repository, in the <code>docs</code> directory. However, making this
-information available on the website is a manual process, and should be done by the maintainers of the project. The
-process of updating the documentation is simple and consists of the following steps:</p>
-<ol>
-<li>Update the documentation in the corresponding component repository.</li>
-<li>Follow the instruction in <a href="https://github.com/Kuadrant/docs.kuadrant.io/">https://github.com/Kuadrant/docs.kuadrant.io/</a>
-to update the Docs pointers to the tag or branch of the component repository that contains the updated documentation.</li>
-<li>Once the changes are merged to main, the workflow that updates the website will be triggered, and the documentation
-will be updated.</li>
-<li>If for some reason it's needed to trigger the workflow manually, one can do it from the GitHub Actions tab in the
-<a href="https://github.com/Kuadrant/docs.kuadrant.io/actions/workflows/build.yaml">docs.kuadrant.io</a> (<code>Actions &gt; ci &gt; Run Workflow</code>).</li>
-</ol>
-<h2 id="communication">Communication<a class="headerlink" href="#communication" title="Permanent link">&para;</a></h2>
-<p>Another important aspect of releasing a new version of the Kuadrant suite is the communication with the community and
-other teams within the organization. A few examples of the communication channels that need to be updated are:</p>
-<ul>
-<li>Changelog generation</li>
-<li>Release notes</li>
-<li>Github Release publication</li>
-<li>Slack channel in Kubernetes workspace</li>
-<li>Blog post, if applicable</li>
-<li>Social media, if applicable</li>
-</ul>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<p>The alternative to the proposal is to keep the current process, which is not ideal and leads to confusion and lack of
-transparency.</p>
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<p>There's been an organically grown process for releasing new versions of the Kuadrant suite, which is not documented and
-it's been changing over time. However, there are some documentation for some of the components, worth mentioning:</p>
-<ul>
-<li><a href="https://github.com/Kuadrant/authorino/blob/main/RELEASE.md">Authorino release process</a></li>
-<li><a href="https://github.com/Kuadrant/authorino-operator/blob/main/RELEASE.md">Authorino Operator release process</a></li>
-<li><a href="https://github.com/Kuadrant/limitador/blob/main/RELEASE.md">Limitador release process</a></li>
-<li><a href="https://github.com/Kuadrant/dns-operator/blob/main/docs/RELEASE.md">DNS Operator release process</a></li>
-</ul>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<ul>
-<li>What would be Kuadrant support policy?</li>
-<li>How many version are we going to back-port security and bug fixes to?</li>
-<li>What other teams need to be involved in the release process?</li>
-</ul>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<p>Once the release process is accepted and battle-tested, we could aim to automate the process as much as possible.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-a1.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-a1.png
deleted file mode 100644
index 05edf2aba55ff3a0415fb13b2af6dda3cc952284..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 270738
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%0DyeuNjmt
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
Z_tnBQA0z6XE&%_W?RW1e+U9fle*q<-u_6Ef

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-b1.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-b1.png
deleted file mode 100644
index 960fd827f296dddaa9c413e7be770d1177f3e8da..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 275553
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%0DyeuNjmt
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
Trf)q4{*w@q5l*|U^Zfq+8Iqm$

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-b2.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-b2.png
deleted file mode 100644
index 91381dd78e85016c851068b2006f54fda7288ebe..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 272439
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%0D3e!1>$Y^`)lr|5js
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

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-c1.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-c1.png
deleted file mode 100644
index 21398dee95d833c0e273213a068314b0bd78dfef..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 274404
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%0D3e!1>$Y^`)lr|5js
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%0AhJ2medD3^B{7Q_X5x3VW4;y&S
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

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-d1.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-d1.png
deleted file mode 100644
index 90b9648fa6b015a9fdb0b44a0884bab19e055270..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 276316
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

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-d2.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-d2.png
deleted file mode 100644
index e916bf3844bd69e6a7976ac35302576279393842..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 290482
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%0DyeuNjmt
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
Q`0ucV-NC{?-2VDM0GHoCc>n+a

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e1.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e1.png
deleted file mode 100644
index e6041bc6a318108058dc3cf2ae323f58c0980e17..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 287541
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%0D3e!1>$Y^`)lr|5js
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%0D<UKb|~;PoUgCNdG@Pd(WGw7CHG}hSN0wLxrGg
z^W$HK)9nVbhQBMPKEsGR@E2{$?~qEHpCh-&C17kW_~3td_8to*cru&+G8vK$xV$L}
z76yNv47m$xv;AE;^_T#bdGi-x*grU5KP6y$RY0~K_dh&)&*K8v6CeJ|WXM<7z;AEp
zQvEs^61U@I7&P>E<rJPci8A&VVc7p3zW=)p-z!Dinr~hJf9@d;!Ti=T`2Xo3rn6qx
z*XQ5b+PZoD`r$`u8yk+MW@bSvD=XE~-#nTA@Q4QyNH7HBQ(62&f_ijtug<S3!Sx+1
zROR1cp~Qlid0)l$#$W=>*4EajJwZ;@&!KKLh+R3#e|l?mO4-yjohs((nXftS#SFmf
zx;lKK=*QBU&EfCr07YNWF8ffzF`5CoH&s=C8RH$n=={<LV|fjNO9_$pPDIS<Nu;DY
zmc|iD5bQ?W6de@j6C`G9^hx^sbFYhIE1c}QEgx@4qThx*`b^I3c70%AAc{_2Rcig#
zRQL!Kt?RtK-W$EHt|}%+ao~XZsFw4-uQ7J17~I3KV*P@F!5tCh?iAGsmbxGJI5Ax9
z1J%e;v(auTV%I708_UvLQ~Q<6FIs~~8sJK63Iz%4QQuMSQ=c}+sq^QNYR@H`raM)`
zKq0ojzs<kv#B>JoG=o*C78|b$NT<iKUfrGx3+0Q_Q(|X$cqTr{QaSW6yQ0pST3Cem
z`W_UU%YwTtM`5&zEc#FL^70B=4PCg*SM@;TjL$AME&)Q?LIv*Dz>i(sBQk|t4!@2;
zeFA<lf5Bxp2O|B7?k`fqrX=?-)Y8X~0jcL6+bB-OfK8R_MRLeR>_@-+87czj>~X$U
zyZMD#TX$;OtLY~GSi`$r%?u8(tzh-46%2zM`<YSc-j`(a;a60pw~V;YoUzSFmt`v(
zb6%Tnx5X{jx#rEPMn^<M7)><3R=s}3>CK>W1jYLJ__(68b7^z5M6cKy3f|V(ldT;M
zX>4jba4a`BH|#jiZAAzKVxSMxEck-kT9sApWyGpUE<Z&Ll?sjDDPar`54Rol;Z$;T
zbS$Ys?dnnt?tqN->afX=ZL--S8MR+H0<UPn`}46;`Je#~3KaUCBXDKfPUV;D_!coE
z%XipMtT`SjQQXp9hEA34^Gz~Z{piLeAs{$WRvVPEcOC0|PRM8a;rnn%%#37Xk>%ic
zy8^RA&s1|bYiEke>JaN}>k?<ITSqt<drafZ!+Jw6MvkU1ey11A(6x3!cid)mx_EuO
zEURbUv@5R;;8)z#(9lrjVjsU4!pIr*@JUEW$QAB)r*<Fic^EiWU6$5ADaU_buKqQA
z_~_roIX8*^4NX1lyZe|Z6=#nWS@2RS1de{;SM<ObajkO4?EAJG{Sajr7ndRF2CfqK
zZI^b3F2*sJ_H_mc$1Jdh(!`ybN?KV|bo)F=>qSIFS{;!t>(HE*NYN&V#fq^I%Lfl0
z=43;-+I#(+(laydUd+;|_=`=xdDUr8j<;)*qDd>}i-SnCV{3+$^&yDujRU2W61&Hf
zwiT4WH;dPI2vc9L@v^_Gf7pnn{5>6N8x4RY=<9z+dw&;mf{5RquQleLc8kKdPsrz_
z+tR!I#VV{gWm70`a8J)|A7OR*p*#DzN^HjDohQQ~B$|9YJi*SZlUL>C<qcvhJKEb%
z5%6e4a(X)V+rbzW_P3pPou}iyl9H3<C@3h5-aR4f39Qc?P%fV_-az#WLNROg&$3x3
z_4EpgG8(>$-DAKZ91TyQU3>8pWFk0?(%ChY{R_yd-ATthc4Gbat_eu5f#>MorO@6@
zj^K-lG3u|iO|GtgahxY9BcsvTQE2S>f?L&8jB6BBJ>^<psom5^%i!rJetv!{n_~eI
zjN=$R1xAOEYi|Tj<qSp`Jm-@%>*5ky{y@zd<Fr_b7Pq#DxL}iT(s?}aNK-%g?OZ+3
zE!;|h&#iT;g`rRu*oPk+>~a<1L02RLNp}mkgX-WArVlRt(A~Q_yfM}AODsMLL@{jV
za(qfM06vhL`%M%Rv=5rI8w|fUhh8;;71Sx>+bN3Fu6lrWdMJ7%IOn+wcT_0=X-|r!
zwITD;Z{L;PylC6_k=VaDZEEW20=3I4a+piXc8MPM<$gU>xe;_wq=}@7$ph?zr;%63
zYp7&G!t~wyoedZ>K7FCcJ&Q)d5cUoZV%=h&ACnq=^rf@WR3X1_e^H*lvkMJrjS@3#
zv$V1b^<sAK6LSO`K*`wHxX%{q#HU}SGdnvQ6|UMUK9^PHRbw>>59$-Dc*@%hT)TGg
zn}^{3PFf&;_hVcKNBwV-GM01Tw;mmf@ZOcU{T0`L7sB3?4Var5H3hjEJ3$ocD{VOz
z*~ePN_>B;i_s13qYGuXe`^ux%3s5J+H@lVDctu6W?;xuchl8+5^V?3wn%a>IrGx6y
ztg?bHUKkB+(I~c-tVm(UbmwLQ2P76>Q63-Z8}6rbvxNF(U28Zga<{P!TVeFt-_N;w
z!;itZ35wpM^*U-zjP9Iys4#BsoT>YSaewy!y)E<h!9<!EzGt1ObrlL-B(u)+Os==?
zjyNkEALM1FjA3Q3gNn~`>q)*j<8frT!NTNdxTJIbN%ze!lxS)-$y4j=>p4%T8Xj=E
zo)38edVZqTF`0ws0k=Yiu%$K?MXh?_l9H0r`<PsU*Sidj%&7a~n}P9Fb<1Z>_6CoR
z-V>Wi3LX`cLup+-!F!iYOiausTH#x)h3~{#=ns6Kq#X<ApTP$oaBPEUd#~&&{CWog
zI)?^h(62uIo4`+zXcf!{RFFH=3!S(HJbOp}O5qavhS0-Xd{x}IbA`pOb(C7L&Qb3=
zW$EIJFQ%AI*beQHCo(PuW1;en#l>DB`v>CpMuq9G88<`<vOjPt@Qb#t<X%?}^R{<T
z;OTL_CIt!1n0gbe=5x2mY6h7!QK<Q((f9gPVO6=jOP2vA?PZxlKN!X5@sf@aqh~#Q
zsCQ%U%`DPzvlD=|hW9V5!)5{!=FZ(tQK4_DA<OvWk-{?vd#`*g)cV?*J;bR5ig`>a
zbXKS2Q&dD3a(-4~<FhA~IO7<Z*~dt-11CzV5KKCo(}@9%iXy9RHxw9;FS}8{X=rW^
z5o(hZO49M8NEZ<nuJ<5kqP4dGX+geW&0aB-z`E{9A&%)gNq+cdrK2-<zfQh0C?UeG
z!=e8^-)tu!qw(j6vp0Wt<?W}L2CeMbu7j+)4w0mWPf^Qb#>EsDj=9}?9&*yoqD#C>
zrr_Fud5?0$neKFx&!3c^(_fE~a(@ys*MIf>(?72neBj0{!#Y-1lOK)b39bak1_?W;
zHUW5YEI2?pj9zEqY=-n0|JL*I5Y4{SXS$0Fs879ol8=hURiZh_To-xgBSn?xu!~n$
z8F-S*-IYJnhns~4UPYFjeLL(_duOKqPBVP(>l;F$<MTqg6ebJ&tX*p68n1=7u~%nw
z^oO;tNy%=(U>YkNDiq?pF^43K+KX|ZDW?Y7^yuOFeoL$t?ilSkA%iuV^D2d4xK30j
zvXk6?M47*mjX8ZWM9*Ia|A<aX+$J_GSvgEeLBZ>3BzKZZ%jqOf9#4$`a;8TY?P*iq
zzP+w0#_saDsg#@WZPw{2fuJ&GlCP)Z@jhZi$4k=v3~ODy2cjC=N0B4DBH{0*E5BQl
ztJDv0Z9@6;c?!{3mD1U}SDRWK92P@G%##*cWhAC<xvkFuZp7setJuBrw&<8M$Mtcx
zeJh}yuSd`9+$R>Qd*c)}U#YN#7#zM;i8g9tEJj;p{E4Xrqet0eW2`B?aE`N3<nWpK
zj+v7THXj0Sx^y(0n!qfiVcL%;=*d#|WkWD;;z)RB`ujbgCd9T)Lys}lg~+_i+>=pN
z2nPJJQ~xr~4(cQ^m`HOrBrsN77<G<+Va?nisj5mZBQrC))p#EBj-2^Ig|oA>;Fqzs
z@)#*uuhVP!ZPM5ah;^9Yt$i8!`5pUj>~Z9<seO83?JVcZ6TC{((Ti2u(AX|PhuK?O
z<D4>d_PL@+H+68S&Z9cv0n=KFd-I1tuB7UEEk;s{QU<r=q4UCSx2;KgekVyv|EWXp
z`+L>;yYcOBLzYThYO-7gjsDb7?l?R)c(f*9UzyWjnL|hZEH4CEU+Q%gK%kfE=0b-!
zd95q>5-!uferZi1-s4n5>HD=K_|`fwZvGI#?xhgvi<s;W;en^8r(^td&#c{mjydF)
z!<+iGTsE8q@AYI!k)6(RSnNB+V1-XdE!><+$EaaOsMyq7f{t1Osm1csi)QXn^TjMS
zo6V=?i&i2p-w({?wo666^D1m`cp2?N&b+h`3P`6#5A5vVlDLP~uV$)AsX{=h+a^|F
z(JyFfX?dLSv{uQ(cxdCR>^ap%cID6u=-yMIvXo+Mh7KS@4W4KUljvmz`K{2Z7Zl#&
z;>bLaNGc48b_j*muVX;bGO=98?9?hT>dk6&Q^sV$2CA;Q+lyf#Bi`m0S>+$?`QiGw
zQhi_a=kozP{lEvWJYN261yWW`wQniw2TwnRUv-(1J1ywduOvr`tjb9*)xOhCv(iLT
z(UXNrJdI4)!gCjh{)lvE67D_!bE%kf_nuzEzoYW>Umphk;Hay?#-PDG?|Q+g{7bun
zQJr0zIF`p6ceUOIo{0ZqoNrhAvURfFxvp`#?W8qjEp9l^(9@z~zE_on)g1RIe6!H{
zid5Ymd13;vg6_6pJ+tqqrKt`+$wC|dRGn===t{Z#FsX9##JZ;3y2Zu`b-2*6bc41x
zV`{#R5mWxjmkq{WYwGQ925gj&FST_1(zqpA=dFpb=r)iaA4rOeV=;`~Kgd3y@}dhp
zIUan!ZJc_Z9z%$8R%_u(3bSh!Q-G2s!pIYKU*7+kM{@4ukpn-e(SCnN|E0qJUH2~d
z%v*eDB#6o{jgFmY9OrQ_m>Q9iy6MpU+M}PhBOh+mC?bjy%jxOS%YM&c_T2xWVNl!?
zvzk5f^0AI(zERY!MV^d2`eDzpi*|g}ycRd?=J-K(m*dFsq=zQM)2?H*gC-oo1yLu%
zZ5<XZcmh?y7?1>3|B!Q>wM?5MS$m7DOUE`wAYi`5n$yE_7wXoHUcJ}CBC@jWm&g?|
zVp7qm;FZREF$J9v;Zd`)%87CuF!guR(0HA7C-1$M41ROW7}Vi054<2T&hqE2hPY;C
zW{71RXMt*fG$zeru&AZfD@HD9F+pN<{ic={w-=Mk17uB3(KkRME9<P-n6Hpdw6fvX
z`t$$WoJb??YswNOAe&4n;#MInwH+e7J$DX1gX1gze46`>^sp9S;&9C6AU<mGZ=t4=
z?zFfZvAlZAAW7-j?JLi2v+<}?m@pmArZ5a}u*!JN$9Um}AtiRJ<~UP6C}$ftE%eU-
zky#7d$_HvSMJN<{^9h|*#L!diwdT_<&jYXUDTkf~S*G6IyJuFX+NjDjbakW8>Q@c*
zi&~FJrl+Ot6JKx~!($gU_0fFX+}wd6y?i%66S8Yaw$n7bI-CL^h#$zL|C8X@Esvf6
z>7W)EF50ebg<t=yvwF&fxo%OyHJ76E-Z5H6PMXC+or)Vt4T4`rbH(e5r3g{N__4)S
zOh{%9*f?{S3)l@k0(q*K=ZkXuRd5RvK_X_iKG=Z>l;q=FZS4^V!>`7+X3?bti%pVl
za0{3;({43Gq&p$jE9X_-UT%Ao0Fl1hl_1f-Sf1;|5f={VL0MYxCsu{F6G~ce6F>MO
zxSS4&PddsLKck$VHZG&cX^D}Nm;^IS1p*{jyp14`ruWYd+z;I)dj3I@PMou)p<U#3
z_^G@2HsUqvpETg{2uW=5*TL$)O(ba2%2sSS58o8P9_H4zFY~6~qX&*}Yt>LXwmxUl
zWTp%L(8xq-0^ArFOH3zo^1LTH`eH+fxs|up)KfBf_f66ps}vGwHTCs5bb<*j9icE+
zd804iI}E^tfgF<_abTWVgS@k=b18PAocvbhjWdtz0X9WBO;0MeHR8JHkTOWb3dZ~;
ztXRTcxGW45norcy=-W3&**0?DymN>4misnlJ^x-UML4LU0VF0m{U(MxDL(!Zz{5N@
z6b3%^x-67VMb(J!Nvsjb3x&i&i2%#zQaXcs-H~Ho17Q&;Ro<OgZ(T>dI}D^uoqS!t
zXgsQsAUVKwy6<r5M>s&YV<R!;mp1AS5hLGnr^)`PgDk_kLeJ$E7aQC@>l&uVxT6Gj
zwZ90rKb2{M2BsoDcfP5IJWPBr84}9__>3&wqP(Foj1nYMA2RF{NLW3}0=Qp;f<iUR
z?BMhTk3jtD7GPp)Yx78SO%0xPNjW(DPUrgd&&^ix=()F7)YXI4$KyOHZ_>RPIeg9C
zz3N(oa6^<h8zSti)@h8&)v~GsC(bI~VYGiNOD@*Y**O6KCr1ZnDIp*C!Sy2wCy#{n
z9^kKFnd`~6i)sTYZplL7*BgGABQ?gwOlRu)uC=1aEn-9OMfL#p+IR3lutxD80EGY=
zJ<{<jbZt-qc!)OrqdWb5$r+MD7_PDawq|Hh1V|HvTQ2m)FLo3Gm2j^&Z?9}@E(?A!
zN50AkfNbmoRZe1$4~1_R4r!eXcZn9dFP9usdfMaVIWF;0MLN5VhI5NuI6xMd@E?q}
zRUMX;&XjK^r@#0of=nKzU}<h14Djzy{UUag*TO~2L*e+P8Y*Qt#odYV@%jY0mnik;
zZrgcvOu-*N$~V;4zk;`l^BAsw#iVK-1mwtVW85*Osd^yHg>`gvym7!`kpw;or-hKA
zAsw;#g3f!Py=2YTc#Z=`g7rv6No)M!-P9!=P@~w6YZs!!zxg{($9ZqH8{XSaggDQk
zPzQ1L_VyR%5Lz@?SOB~BvQw(R+6Hea^RJ1IKY*tRZeZ%#w{aq0F!Ct;kxo(DZVgT6
zmH73h_OC>MzvwNr6vPU;dl!=JAd3LK`v@lJhtfr&0%Z<{xj!7qQQC=q{o(+h{f71C
zdUi*lO=4R59wQt(@|9mPzN24eA%R~Ru&vI`MWt2O_i*Cb2V?Ip48cCc+a<4sd}ui>
zaLXfb*vz2UzgIt4SY#71{kdQD0tZJ)9mS@YzzSwAx2b%wYR((HyqTcr==m%pF&j@^
zeY&4|JT1|GC8Q+gh;d7Vh-&oYE&yz&AtU9z1i**@p|~Y*=>TGTIQs`nmix6Yjsv83
zLI({(rr#qd_Hn7EmR9&lry-k-__uT7^$DcBE;9j_`d;RL?U%$7DH*0UwKptxQ_5!0
zm1p{unsV5i1uPGVFS!$uy5aJbx`8#O2S%cOuWs%Cjv?-}W~=Q$RM0uUe-}3^tL78&
zd|x(~YqJn3Ws_iU)%Q6|GcEjzZMW}fm;SAu$eXam;Z~P8--vUpBU(~NkJGjv?{MgC
ziwnz}f?lG4G(YUo-BzfCYO2&7UJr@i=i9|ws(E+Bt!Dqyh1cpH(Frw_0p`zx)2M>S
zJ>4mN--Pp`!mpf9TdW7@@f;VED=H6Q$R%tq<q^@0p^BQZbd2@@Ht==ts8d*PW+OHL
zR?p80uQSR_McKWNfwWbOo`1C*0K>@^StFUysI!=PRpl@~hgqBIKgsKTFI0_X-p)R{
zEpun>9yv6M5w~lJ;$g@EUXTOB4^wnf@Rn3B44wyeZA&g0{Sp&B0S0OG@MN&fagd(_
zV~Sm`V4#x&Wo@Ey3Hi^v`Z02+m33*Sl_kwaVxGGdk6J(t*eyn#Os~L{Ne!B1&t~w*
z`3X~?lmU~m(*2Qxfy98)X;M~3vnBk;LHA*XjO+0M`F3q#Pt@E_-*s>aNEdCk(AtPA
z$Z}IzJIgeozXb~_?$tZerVL;jpa%g_TDm}bmX0S^8wLD-aVJ5o@6!i=Ai3V9o^RU8
zA@W7FEDE~OA8$GCA=M^BsJNx6DIvnm#r2AqyX=2(B{PCji`W2Eg_Q9X1JJt>RIMjB
zLYx2sH}XjKS$LQ2M>>e&?c2BeY`=i%d6$)xm5uSZtuHV3%y$Y^Oo!{O+0Le?Dpg?y
zsm+~N8aRysW`2e|^b{zQZfA{t9c#mq3|>r<)hb}}00-0E=G*TRqi@|e#nWr096!J5
zi)TP1(x$&`C-S-}?&(3=!tHyl_YX-}f4s&mvxuuM(n~L$7wssma{8leq_yAtg)gD8
z)<p!Bp9xpL+Y8d6?sJ+%TB$LGjC0yC6n1~Z89Mg<`%RZy=SK2m#m&r<=WEc$bqCrc
z>YAz^#;;1GR_F*S_#YHgSWJUG2uHci)K=%AY$k3x;>n0<ltHZ4jHzkhbC~35UTXxm
z89f<X`<o=m!xAFLXuUPfdPC~vO{b~Y=<7-gYf$6y)X9vpV^>w3<sNPY6c6-d2Zy4O
zuNl>3CQ#fG1Oywegv1)gux(*ji-7hrntI9ql=qy=yUQA0vNcSrqpFC#@@8gc<HXn^
z>(YF#PO%hoaCQP@r!?Ce@qx3eoBeI>J^fR)1RNmrQE%@xt(<=NGG@QgY*+dzjqHq!
zAR@G|mUYTRY&y<!oErK>v+RClPEPBLMK9t0#Wwi_$SE<*bYhF?IoO;(2GkHAxr+&S
z>`VMixy5jq##+{CllD_5D%JQ`CtK{?>o9HL4*o3ZdgDf5l-o)}-V3|k8EGCNpph0-
z)&eH|0DIRuro+Iw>L08<hd|Ii(_evpfgw;Xmsr?*J75k}XJ3bE>QfH6z86I>9-V$m
zzCHJ(b~PX@=)V7<s7|Na=K6LgL_ZUOz!w<hL*0^6koj(_5V3`<cC3Fvzoh3}6Cmpt
z$*9sM$*ZD<=i%BD6dKO$!Vv;c@EOyQbdwu5Jg0!UQJmbNN6cc2cj%-DLYK<d<%w!P
z`ckHRB#IV3eULjss?I_jA&P6`?a(L|dl1|I$uRiE0T)sM6a6Hl<rxe344}$ONiItu
z)#D@E4FjBQQn&llb=-ojO%$9lGpWh9$=-laI50Rk0btRGZy?QYPLZE{_?V_4TAYZL
zu1qv(@R_LzD3MF%Ydqps0N@-lB`H?HDJoKKQ3mz4hU5z^T%X*?{*PMwipXu!EodWm
zs-htfSFtm>ZyK83hR+@B5j1W*77p%r16}{QT?G5HGPq5vEQ(6bSmKMr@s<Q&+43^r
z@-Go^-&0~oJhV1gg4k}lR0*WN!76gezw~O{Kvex;?0IB|AAjn|+nW8RrKN%s8Rj)T
z_vgE1LWa#gm*{ao2`{{b+^5HG)SNK;gxSp1KO<(waTsndV)govD4{vLwgz<olf5@z
zQxB^9DW{6TW#g4fF+opU)N<C9%SeJ(LU{!}sIR1^%Qa*62ec#^!zrrNwlV*OQY_w!
z7&A$Z)4vTHkin@AWOik-8HPUT_fqUn=&U)pACZYksqIKK(arlNxau#LL@*trEnVh}
z$<0lV3y-gfNxnzKqfJ`qQ;8{5)aPg1i?vAcV+pdXCeQs99lA~h&2*-EMK8<7CPHv`
z%Ir;(I&~L|WiM<rP)TnZe7eTDk%!M>cIdhxX!!mqKB`e{_f;klxey_yjjzb_$mM|G
z{EOi)*Tx?t+ed+`27l2hu?8S8Bno8NTB=okQ7ha8x+?D``Q1LPEN2{2DbwWiC!xcN
z^74HysN0@x>p>|2bGA&n_79Vs*Utd=tvqKq%F5c#gbv67f>A3J+_#0ei~@L9AIy7Z
zc7G*)C#00VN|2pW%EK%Vj@DHxrbhV5lgqE=Bi*qLU^7l<$*k0~=F2{NWM4hH);UH+
zxWGyE1qOH*<MYMHP>@}6;^HNmSG&-cybPt6ebf|fY?crA_-lU~<8&GXezu!V4|2gB
z3y!}Ro&576-4cnPqxoaRPD68hCmF14IS8n9GJg}U>JoFm!RI^O6EI$~asTEyft4>_
z%#BU_2vor{so;7jdYDt{%pDP%(JNx$snv6`AF+Jxt|>}^|DE2OGU@X@YbCUpxvyo}
zVN#V_PNaLbPb##XPVI%kbGmdogb*;N*+*?%&%o5)?@dPHUkCZY*WgX9K{BvAideCv
z>PR{4!<wItL$^kZ+cdcSob&Z=QT&`|v8?ap1^0Kt7En2JbAGO?_GY?(9uHP)+*}@;
zcuY#Uub_d5$qyD;5{pGuK_MYhtkyTIeNP1_ls{zh3N5+pnt+3Gf*ymmWM6;X*9_U?
z3(znD)*;d3?e15KIx5T*q>XCWo9e%OHXg7IM>~MP2IzoyUgsV%`4dRCpwLj;wtCX<
zTo*keJHI=W?os8p7xzZ=0dQ1|+b2}+jkg?0XgJ79YJDK*=l8_&N_?l@4E<5NeGl#T
z4<BVsSX6o4ulHqADpA{dl=f=riAj&I5vRHdd~?N+IB90&4~(e2Ce8i71g;u2a9&^o
zL*PUe_Izv0{R7JB&6@z`u654weexv4O`7TZQZ50Xsw25Y&DC?js9eDCh>*bh3Sd=U
zUmaaa^7D4CUIND%RM^C+N7;WFqyC;g{qtUn0Ab_OS0jCw;a%FpXsJo!uMwJw$X;CD
zo1Xyz>puLQt^FTt=06ZeAXEMqA9f=mfhNV#mgvL&*UwY@4Vm{Z)zt6A(7&kr1s;HP
z-0Qb%r2k#RHx=RcZ4~3Tm+?pktYaNReMStR0XThEUi=4}`NLk|ja~RJLlA<9?1%7y
z2I3He_fO@TtM{$$RRQ$S|93L)U-QQQfh^(2U{M_hpaDAJT|43U-j-eJaE$r+Grx$K
zKihzi!eq^o=>pEmNcK0D!+)6ZaPcH~W266N2!bMU2!fFr=gtrW>J#TkS(}L?{C-E~
z{pakFUrv`NxbTfWeVt;VC;HV7Bd0&@D@^e1<B#h==zCP*ku?iMS1!fhQu_Zi<H3eF
zdXx0O3_%D7zda~DdWbj#;o6-K2Ym&IW66I<=KbHp_tlBue-9rC>;E3U^M)W<d0PE{
z@Zq~cGd&YHpIbQ_0?KjTE%j7+{<iiH`#w?n*i2-2f`KYVpRP*TUHYM^`Y5F|ZQsxL
z?_)JkC2l6g-xB%PY-o>TG}C~DZAoyJcXTN5f_C7b=-?x8lV?&NRreg_eY^cSEE#I4
z@yU{c@`55osv6Zm-N#Q9sOyG-z=sKa`?Q4incPzM2Ry>p7F8t<c0Nacxlc{IY?xT9
zWelGAuW3J{AChQ)e&|0)m;t1*+@|o3n6Ui2Yc;9lVoR>|>sCJoR%v5Lxo6i(#yh<0
z#2#Nv*yD2dZj#Hg!>O>g=(2!YI%~<Vwo$a=e?Fm*g;*oQ9p8%FK@;_g{Kc)+#Q9ys
z3f<iknEQF`Oz-;XMq46gjIrncy+rAzPTb5)YSK*lL{QI^n3I!(nCm{@H4j6flxmDV
zP6sI2jB%QL{#xg6d(6h-?>MG^_SS2L1XU}ZEgTv1?5E6IP`rLB|M2|b{^zVUnt<au
zTU7beCH{Nn$zK<N&!?$~Z<o{86eImCv3Q+3N-SQ9S^$GL6w@9UsllTC9)X6KKc}be
z7grFfy0*6hTKiv%;*(-E_rnIh`p$q6G!+4rqJi@U$hs_Q+H*(WAxymtsEQ5?fD6m_
z%Ir3vE`7^x6lV)1)PA}CU)=%Mzt1{jb0z?6F=gMgH_!Ce!e46a=bm7p!m<J32)LMl
z;?Tno6a_|a&g1@IE_d!e({GE8Zq)z^sl#@Eq;lpnzSqdSzsiwbj^&%We%mxXBo=n5
z<X(*x^Sl5mB8uFfDE*1LE`9bV?`Ur-hR`!#OSf<N*THm<S)7`1a<BtcPwa#5bP=0c
zrLSG#zn&AsmL{q{ziZQ;6aTB>z!E8NV558mc^<gQz!^Ay7{<$WRbq+mB1;AM=Ow=M
zx4l0Ix6?m$NRs}1G%oI{%v=r7z}Ri=^><ILy_5er>2Ep@=7a;nD_G`g0b(_MjlunK
zKy>||D<FTej=EALiz|#{o3Doa;jsi(>3w<9d%d4d=gs(J=e@twOS|duM)iU*$g+9<
zGPeKiLmUjM1|n6{%$!hvmBOIFFiz*!uF5@WH$3gvrNU;0ZgK*{r4G1Vs!^C<Fb+^q
z3x<ZI$o7_`%pq6akq0H_=n7ayDBd0TBbV02Ma>Q_jDQc6I=)+jvcuE33SQ}>*VYt^
zU8<S`S)~Yjd?<a{Fz~MKlJ2cmB6+5innN5()=<AxQLg(A@Gz4T9TQQr)31iE2D4j_
zet7COg>t2|mkJ~uPb8BUKW`lb0LU<0Wh&80kQC}0w_09o?S$t@&O{`$nluAg3>7!#
zSr{(^m(a`(YCgisW}VATiV-~>I4^LgZ7_C@Xz()$n73J@H-d8Uhm@E<6cNMe#-X`n
z?d?{2O};Jll!KcX?taQyWL|Wprn1_qDmR#Qe`VYC{2Qbf-mT{XXC7FRqjM4=nm<ta
z>#r9bM(=v+f7g^PB@#PG1rh&JJWP6+=yb9UgDKv<jo|I*W^`dcUR2L@Hsl7U`)zUa
z^NLLoB7zGzeno%!v;n6b3>luy{Q&J<>ZJ_4nyyfpjJSa|h{%;g;|I069uENdeq*2d
zi4v-Sw7KpPXD|C(xxvHHKyxd!xuO*wBxY6+5{q_jIK#-`)?9nL)2^-29}*iF({p>j
z^WKS&oXh8HSN&g)0@g=aGAwwbP~+xuEkD(Ri-j*|pYfKdbUR}YwE4`=91@Sw&^vXU
zMu)a9b@)6I*zUlVVgymM!?`is<rO-GXxOuZMV2n$%`UIJh?_G>`_%k2*InwNifb~U
z`Xo)v7hfLWutshhq0$e`C*<^yO9=!$ZR=<)9tld}B(MYTzRQwPUYZ_(pf9dCb2aw$
zfCT<*X)rn{U#Qi7BB=ho1Td$L=vGUmkeNm>pF)Z{*fIXWunpWKfS1s@%>1pG@~B0y
zRh?pIfd7QOtENFE(IPF3B6?j{Nfi_2`$i;l(F&qXE;74Nr3@{Sh_Ym~>d$sxOOPqf
z3thvJgm11Zk5Rl|JLG!-`EClIxHm_X9I9{sidRZTU%o{~Pu_h+Jul<%#-o}sLdc}1
zUa0Q;{JY+sWFaB;#JGz}UC4zaaLRqI?#O5n#P;j8G(@+_Ib_=jk)^6H%v2Jm5U&u>
zS!;BCO+ZNds?2@Wmzxsd^PiHd^ds@MUS<$uY7?Ig^qFhRZ^~!85Z2j?nTS}7T{jxZ
zvL4-f{m;leNEEO0na_D&L<u~mGjv3H#m5ROKz++s**?@uz;C1(Xdw|37!ojv^}y80
z)5)n(^s6pq7c+`HS3!p_Te?QY70)PidS)glzRJ3lz#%qy2QE6hcm>9sFcRe%LmdC+
zW1^_Y{sYJYV2^!LG{2~N6b*L(D4p*Bl=lqtKatFDANwQ(?ZVC8J|Y75j!ZUa<xEBu
z$X!aE7R|6OnV5`&y0BU!=vuX>8JJy#Q5SowIHx^w@3)C-QkXPPyK<p6z)lIlBrCu7
z(#6EY?|neiB6aO!l$#Qg^+xgf#l-;`yk6Ptc?DhwrO7cGG-cUs&*us!okK!0{v4Do
zd~;C_iA~M)7<bimehqi6GtX`8@nSkARdcOGuJ~##0UI%%_R0sevhEH^JnBbXM>v#n
z_wp8PptQ2fCKXPLH+MoBZo;dHjw8^Gj|kHk{_=#&96AYm*QgAD1(|85KH;>biwV8x
zOL_}E=WRc$Rz*cEM#^;j@}VO#oL{UWvP~Gmmk50Oow(lS&Nep5?(KtQ81yDt>z?4c
zf7>y=?UVSn76trRdR)(&U{y-HD^b^nT50t6xt<+~zRzDm%<}@YhA4eeW|o1i0|RfS
zjxmesEBRyXn{87b<6X6}sWKUlN6y1}W*04vi__=6H^)fOo3;zpcH!@CyBhGi>^-oJ
z&e|Rp=^0tdWTlK|5PBO|<I`Y9&UkY$p2RLN^Z_jQbTqXUY;d43pXk12#W>(|za6&P
zj9?GuLkP~IZgtCGeb$6UKH7AToEA?j3@bCq>Nmcb$4JlQe8+Km@e%T^Dy`Hu+87r`
z7~Eg;TnvR$`iMT&QQ5ypoVz|^`tn_l&yR4KcJ$nLh;KI=N-En4r*HpdINd%>4Db=!
z?o70}=+I!+XI^eMDIl#u6@Wz@7GW9>-3G1W*`|(+y(NQ&Po9ucfr!#ZS!zBEMJqyN
zE0fY$TUkuI-=!f(7b=c#k9A;p=g5GcgqsNb%7~up)m4c_#W~kSrMcPSCnNi$LHCPp
zD_vH0!Eo^t{82&0hLS;;yEg30J2<=btT1<<tF<YzqThMUl}M)6KJ@mya?-o$$&&5z
z`|8;ixR%_FX0C*hlvo+4e#4+^#<A8n+%skZuuK<HH#kL3LC(##Pn`Bg+E~o6?w*w+
zStfh?HkuKno)097xx8}t06R~`iJ&oXJH6jnT5s*~*pWs7bBl2C#hGdYW2uL3qoP%&
zFMKF9Ei~aA)9*@$XW<3PEoDb7|JW#^i3yA5(YKRkz?_cGuw1)FrU#&zG5D?GacNWM
zv2{IJDc6^n7(dC;2Mv*u{o(KA+Ppul;IWPC{g2Dl?^Mzufcq6XM)WDcfy4xXlZ(UC
z)h2d1Su!^ut>vv>U51`mW0{-h&wd4bfc8FlKnADsxuES`b*GZPFBdXqgSYBR50~w7
z;u>%&Snx>hC^Wr)F+qJ;oxh!gReUWO^0;q(*@D_7G>&P#wELx%*BxcR<Gty)QJVKc
ztPb>h__7cTWaMpuM@8V5ChG$$RcEoC2~`Rvk6rU3Os_Bp6bk3wW!GNVGXE@j1LjGw
zA#-tCWmuCURVB>oILh?KpH$mU<(0FE7fTCJXT#T`n-VF5df}D!qE?68WISgRq~T(&
zDuI&gXzP%OBgyyYZi~3KuU5vIc5k?FM>zTVZZ+?}l-keGVBr-LdZL}cF>j_WbXiMT
z5|#_n49)dx$|?kxv)4K9hu~GO1>>Myh)Wq#_KbJCA>~`$no(^frsj6<KQvYGVBp71
zwOj#r6Q;g)O~1bpadC?#118(qjgZ4wKaa_KP`BD94)a`h5LA+H8V9~s9qiHD={=O)
zGKBQCw6<(5`^N&Bg&r|lobU%ps9SLDLg=PPK{_G($eU9N+q%4j4wwW%;zLv~+9?4+
z1zoHwLW4T=QLf6~O!=QEss}^Q_kKtAcavvYK9Kd`Iy-*E%fT?v-*}zc?7^IRJMoS@
zY3p@Zln^V~MO0IcCg2)<l9QZ}H3_*6Sj1_6C<4c>fv{nC&U;df-&X4%kV?%%lTn-V
zi;AK2IC?8n_eH6G+q(Hmudc$E0b;63(o!-yHz4{T4KiC=8urlQlTYj4r^MPUZ=j!q
z`8X#>mD8<Eq!?bRe62(E$-iJN`qI5LQda1k7I1bJ`zWrHNZ#RSHPWShr8pqw)MvW`
zPgL7UO|+3v1$id-5MO-r@};`w=UZpx4*0&wpDcE^tD*rgEat2Ruo8v5&3BAgYOz+p
zS(vjjt`SR`O3!U6P?^mpzo#&rg&#HF%OW-S{;tRYKcP%tOw|VoS*7(BnP4W7ebRRg
zKDa$^wjQJB6}Z<JfmEHojLiUp)nnfbd#;pQ8(i@k=Wt&YBwAyYRtX6OQ+}DQmb;yD
zOE0rI;p~7zG$zvMiK)xpRGTyP2{P(mLit3z-8*9mY{O^jQ^Qazw&6?bQtxsfPEA86
zv2+)5-tQmd$7hVEeZGT~^P&<R!l^^{a*M)9*Bp-aQ$puVi?FNc#wc?F(I>HoaEq+e
zelUIUO8XauD^XwMV^asMwzG@(v`|p<2z2PFvx*novH$e$$Y5Vr`Xmg-9UbXHh|zSL
zX9!|YINTUDH|6-&^O5*55n#!uaos4?xgZWHUY$rdBn%iBaj1~Y+yiH*tyr~?UJubG
z$WH*sr@KqIGV-HewvWZ1IlF@azSVUsuU_ozIif;4r|>&4`#TlkzBO5c8UQx%t()K<
zk#CBVR_B%vl&Zr>Sd-1J!`%m+vTB)d{Z6+J*e&F=s-{;hmsR_+0hS<*&EqsN1@JoZ
zYUuhZv|HZBlW(d5Mt@ZC_MkCpowtc8WHL<iLivsrrK+|Ovww-6E0#G)x3WctU+<9b
z9t~+8<wnHj@rFoY?gvg44BK>%E%$z=bTDAkie-n!I`rb|Pw|SQ9@5#ZaG!HlDN*oB
ztq`bDY^FeSzqPD=3EcApA-R<GMwwdX_mX-Jn|$*E;7vb4+b(og1-~$HL)PR_fb?mJ
zt}H<px?Gdx{WOgNRt)&5&}swpSEr^3*&DDyApu{#5=Hrp{-gxnN$gC>jZ2|d!=U<P
z%`Z;J<gfd{8a7fxCF<(Z5$s#8i;Q_$(CW5J&(;x}&Me;Qj_>5mCIe<R5})a75>g{6
zaj2W`$SOYo!68C%vr_y@5`?Y2$y+Ub3HfB-mu7)fY$4-7*VzY=R#=Bc>h$ZKA<TM=
zLU$4mSeMPInrc@zit%f<^xd?1_pGwldkJX-Wj;L=Gb~HAOy9Rm?PmT{U3+wBpU$p3
z`1k%K%LEZCOTGFpwWMGd#Np$O^H-B;qJ^6H@pp9$J?M`M&SYi3&YOzie<oydr7}~h
zM)9i_L7vx|ISZs?#5$LHwom!cAM;ofyo<;_XezyLPFUcozu$$`XHXUR2vKs-MS88f
zdid=6-VL8w6_g>3L&dC@%)>?>mjlkmC#_G3_O=TJO^07yJ8FHQIx2D+>2dgdooEN?
z0H+>i{_uU#^(8w4HtyKufODB^238_z651^t0++~0@A2-qe9Pcf1r-8z6jrxw+8B#v
z1@E_EFE=CTFn`|U76=NB<O$|S-0bMSxbfhnkZfI>mF<g=G?p8A6vv)vix+oY^^5Vl
z!u!>zspj~B^0xidLk}$%efiI@+;*NnWY`oQ?eXV|nd2LuS$Kqoc+W`+tSeAYW|iaV
zr|vA{#*)Y1+^-3pEAPy`^bBbC*w@h`6O#Tyt056k_L1b}@Koc$F@pUIwOfV>SvL|#
zr9@0hGcsXZ2_%6oli@`7XcK4k>fHJ3*(T>^Z(O=w>03VC6eQ!2;hgjaF(3Z;9+^|n
zI@DXsl!8qcKs+4{!H%*&z@=>2VkJj@fmdFD#>=vr?7#DlX8lCv!L<H-b+)#5Jto~`
zkn1`e7UDMf^b$h_{XX9`a|t+W8giMB=rA1FebE`X0zT~;!YI!SRa|8gQa_WceR9#5
zbfQ@s18nV#l%BFEHenZ)hhquTQ9_f=@Z{-gPm-xR_|4Tp{i{=<yf@=VieiD{OEQ%$
z*_V;F;kHNk{y-8TKC`i@9e?-d`IALR#VL##L<pFty$BHFo4iIfsgp}s7#Ls)iaDh<
zTe^mlYE6*U)XeA?=@L8%hP9}p17EzX8kdA+5s2dc)cUkBwU8SMZ3na~@IW3jWyjoh
zWo2ENJ+<PrMX931H_=z?7ovB(_?!<N3$tlx>O=IyfxCsy%QmaY<0WcdJV*1}z`}mB
zeRk{N)L&+8;NsfnT=YO9>SBC^m?HTL4BXxtnPbv7`>Oc{`z0Z>gT>X}Tg?+Hk$e*b
zhd`djjR^Ym?G}PKC^WF9+*@ln?<vkX?BP6;leB^$otKr5U19(}7C-dCmP|hH{RP$J
zCQ@=_4iWw8?*3%}@LN}#xLA@y0g`7W^d3oXT8Q*%lXLG3nV`o-Yv}O-rZ-pV8J*82
zAQ!e5dF7bPlWS|2p?+TA@ESGt>ed#`o@nd6wMw^Bjx|fNOy7}Yh>kQ%Rwh@qe`9R3
z7`cs&p?T|bGi6cCz3;ro5h?7ukjyS$QqQ-5S{vls7IbRCZ0HOy1T*hXet&l(D8<C>
z6MQ-;vtKX2E<|Z$MBSBC$;^?QpU*|!mlutkdRpX|*?$oDrX@v~_Rof|97rPC^3r+)
z9!`j3T;3xeMHh44%D$E7!UM-oTQ-)cSzwcieE1?1`sFfrpA*tMmEHVt1yG31S(j>+
z&4Foj@#%>80PjsGRobE^QOHEpJv%9QP50lseByXa^L3bPRCsCEyD#8Y@xq9@B~k>;
z)`qWJOkRTwx4?Qb=(N_5Z-*KylSh^HeIA+RS5Y0|srEQUbagUX+mFcmq5e8La&YK7
zko8qER=X33Fa67w1?}U<F)jC-q+mqPw;Q<$<b^b?F|5h4+HWCyJ-8sic@+l9y92V`
z*6O~8Q<3kwZ&)#-<9(2olBldRB4!4#spspek2pHcve_U%$daiTBq1)vJPa6}tFEsT
zl6dOMSByOk4aLj2I+0lQYV`WShMQ%BQ%oa;O(XrUzrM8h_?1T*drn^5b7g|co1!(r
zJAs6Z!uXh+9`we;%NKd}QKnt+Ao2HZJSfOz+9{^uCEOy3M~lytZ4ZxAx)x6@WHCxl
zIa6x6#yX(&(5vO>9!P1GE2C@l9C9PH0DT}<tp$b6V^$H<v!5)ppLBB9yjx}38M4Yb
z%ff#PvEbxxZW|WDH+GmdTsIS^5^3obm>Izs?|+D)#l1URMtA#dt};Y&VOhv=+S~(o
zos>0Fzvn4S<kH6=m8oPq_q95ReMKts(At8GvV_b^Z0GZQlk$x)AgY=~<1Gi4-%<I}
zP7a)daAfi#)*|fF_E)zY$IZ;44O48yVWWHY$g4(eyCKE+UT_%(<_jc9UQ#zOs>=L~
z*|YC3%f-ik{7FLm<6-`OfXSyO*jTXzlr_H$`J@=me1w)xRmCsl>nC<UI(ryc8s8!J
z2=q57qo(z&{<4kjY*m8_&R1e)?UzC$)khAU;#XywXE~gMc-Wm$Fav=}tDMz3+RB7H
z>k;@YH9EA_{4$-cexyF`ef#Nt<1ja^fla84z(kWMVwx=Y<veEuXC`u96Yg5yFS8tM
z+EBJ$r#m{UzcpdMG-+wa$0oIKfJf$(fMDT8DDJFE<(RGlHX_<;<;m8zsHKWm1hUw(
z7#Tyk*dGj;T%7GHFgbAK+RTMEa&0~AYy+e0O7@AYJAt7h<?&~&9ObkeTT8jUUQy2X
z1#XBUn?^EoPR@_s_X=dT(0F~`BXAlPfL{<{y}Rw5tClK*IVa?wolCajdB|7T<73yJ
zw6eWICVOHhJsFVhas$IS(b5Xrmay{@hG(^k`FQ)^p5wK2U!*)w@RNRo-6(Ks(lFJB
zW3P>@vmwg-&AlDCF4gusQt&tmZEL%?t`c<ZMh@r+s~6wG@JgG@ilbBAT|T-md*&+-
zL|D7n-^Ho~ykIt^QUv+Z#oE~mT_s$ni<=~*!BQr%W-R=)l1uFT;3!8idt49=Qiu*v
zzQfiUKwR1sd8KcQy|a`K`@rC>EKe|kQDAs~bK*t4>Z*AuShyn;L(R>2;X;{uq+Bq&
zKoCu--oq^(2|oe;C<KN^Uj!3T7_hxjFgeF0Juz2YF*`BysWsa42He20vrW>v5i%xT
z@`cx0)ipwwWubMmPUQJkiGOwdt!`=e(3BCIg~aICt!riT%p;-{Iw2zrFdS#(^^al`
zZ_zM?@&va9cp_Hytahj>3`gBDOD_3v!$z1u^}Ib{CMAqf-XztGnzj_5jR@Ot$J=p>
zz|{Fso1zXI<;(<A{R87(w72T-8W)Gv&b28`Nl%s5k&e^|Nl0(B+pm`6r>8Z5HU}I#
z!&Y2TU5j&fOPEN!7b$ra8wsnE+e)zMphOOBc+~LI3!&!?{d018_z`Cr`^!aJH0r9{
znalk330pMa{KCel9lT1o5}wL6zV}|)qv8=rt-*+9|9*_XA0F`(#Mf>6uTD}41BtVf
zXR<TI@7V!usKbcIc!d5|ayuo-)`9ce?+<h)sH;UUn=2czIlbXqJ2ysio_T1=6%o0C
zYon3ZZFT+fvh%&VYIw)?0MhOL08;YCHqc$WHIk)@m8_F4stqF1PKj!^pC@9Z+hGyf
zQLofVSk?Qnn_7)d%`bzfP$kfTVT%<1>72xQ!b;mr55m1|`a_T(L#J4qd#f(<#?XM<
zls`p!zt;4VDg6lB2S%-6M)tsF^YXmFQ5aJXi~#RwbVa(h9vvE{gz~;(HZvF>KyJcJ
z35C5WKFP|RWMR7QPT>$-8E>vRUV9L=_L{)p)FTAr$}X8spu>KostO@to%s|mJm8b{
z=bi0C$TzKznv1WzxILeLpuUk@`a(7#XEA2k9D{+rvH3&#f*}bBE2ppfi1kStxp7D5
zI?e|azRj+5LqF~BJ*t9WX7iV0!mWPeH>Sppp72>^C1I^ePY*o$SJ=Dw_#z|tGR8ST
zY&~+#iG-2N3R_2&GKgQW?f{+14rl%cF^VHAg~eJdu2A^(^N1elg=JHf)vncWy>kLV
z5u8cZn9`{>dI9cUAGJgJZ|}*86Xe2P2XGK7C!mWe#jwxJ@^zU^n8KN6lVVRB1f@ke
zx9%#Y*N?9pSA|w)h{3GcAn*0eF^WABnBSaM=(s{Xt+gFT9&m!P4MWB&lf@yhGN73%
zJ6PPdWrQxR%I0;_n_Ad=1_Ra(Su+_{$(9VocF-ZWLrR?{_aW`I(xOP|X)4BzzXWfz
zxMJW1=(4$vbp+l#ks-%<O*FL-xmoWhN_C)Y%E2p;rjkX35bIlj`4XTADd>B4ippKu
zlR~p{)OcoTVc4|47ENz%F#g$}ab~vn<Z!lWd-z;O$`szBTztq+Z(=H^#p>q7it+OH
zw+MA66|(IlJtxrVXN`f&s7Mf2YtRqSX_hejf_<HrjBr_PxSF%sT?ayL)QqFk9FA*W
zI}U$V3_WDu8X#4^E>e|5!s^#J*~BMRw%R{hJM$ig&NKewyr=3yUuQwD%sidx1au)-
zO$|E>F1LY53FpgX;Bw<4RE$Xebh+s%e;)lQBtAU4b0pLL)sdX$dN?+it5`0x-q5ZY
z?KGp@@%}ZBwyt5@Yt0k}cdSZcm3h^ccIQAY;W-_`O35H;=5-A-gis%lT-$PaDqJtI
zwg$H5#VsQyDWe6w55Ml%FE({;a62OmA<Q@ehpcH0)=t;yav>q1WGR|@?)?uS-Z%${
z)SQ>L%!CwL<`H&&rVQzFU%bK&(l|Dk&rsdtRK+@v`B1ld(6Z{5XE95*)q62Zni}Tq
zgc*X9GzqJy=$AxBm3`a@KDTaue|+>jtO(ye7~l?5N&OZQ;SRCua94WT2Aah&Nc!27
z#j-yt++gYb4WHka=LNsJ;2yf6Yo}7S;Ac(SZJ6_{JNb@RL@d@EHowkIh}5@)Dda+H
za#OZ@^<z&6!-89_@#kAGX6~?JTqA#~Z1J%8Eb!;bpR<cq)<$l)Cgu)qQp>y!jfQSy
z70<4GaU+voq0Pb0Bd=j|h9v1*b;?gS3s0V8i7>BAsyb2M24OV8;OmaiihV-iZB$m_
zVFY<KVZ&#u`nV1;m9a-FXlSPdQd->M(rV!r!f9E9gtZAVDs5WR8GA$~A`dzY3})ub
zXB*q6bgTGa@2<}s_LNZOFA<2|mX#4qRKpqcLS!O~@OW+c)Dvg*r8D$#xIRaH1XbNg
z@3Iew?PAL!Z*q@(kULVUJF>h#f`oN7d9m#0ZIr*Wjq-`xNSrzBtzy*gQ>1CG!=$X1
zG+L8#AGO_=HD;D_bQ8-hUGT}K?X%rNBU^pd^=bFvT#ntnlETqjCDyS=yXxNsFyKF1
z1|NvGL#ju(&&4c#pv#rH`vIS#FGHX4;4<@EET+<QA`G_WyUi){fJ4gK1s$8L%ZycQ
zM0P%B#^)8_aI2g${(i&yxO-*GPO!OYAQ4%5&LN!d)|t|0Jh0K)=EgA`;>q8#zG|K`
zd}mZ{g#^o+>*6fwP%!KkK%+N;;(OTqesoNt)!hVataH}|v|mjx;kRcnAMIe&7rAoj
zNmxPl^}1Ry2iY%!p*A&z+g0o2=2Kr^C^qVJo{3`KUM{UNYMdIwX`LCfUPYfKM-+*?
z{Ia^J>0Efo*8<urp@4|&pBajE*1PM5p_@3Wjvsa!J2dkgxjo;2P}r*B^9YnI;?eIw
zseY;$SYWaLTr}8`4I@+)%z98M@$gkWS}W|_ZgT^+DsQapsEw4#DSfRf%l6Mlw?9P>
zR20FcksTYbN5}{0;8I7ES&&t`^%!yl+w74Cp?q5o-c*l(J+O~_mYS_Hh1-N{KjXK?
z&!LkT!R;4ZQy#Zf?r!lI(v+zmNI7hyU<QX@A2~FK5hbXKcRfAUlxc2YRPXTSV7CYo
z*JzR&w%+2;53iIjf3v;Jtb#{xp*Y@%_aetY+F-&^+@|Ua{A7J>7RPdIZd}>_GUVBj
z3F790-g+<fWBz^dv(Zt2hpLK<4Jk4?gwt@x2MWrZ26<crJ@;;g{x!$wIt8w(JW6n9
zy|d^1bc1ED{7M*~4xA$z&#0!9s$<(wpjno!H55TZ&)i>Zy|(r38ZUr0H5{dFIG{;o
zF&IjD{^i{<^Lq`W_D1*KwGUr;|9++7y4!?j)tPKUD`(w8XVF+^t(_M;#8Pn%fyQ=>
zcB)F`5aKzeZCCXxIp;B5oc<%LtxR_FCxblCy5g}y!MzN;AD{zhCYqsoLvIP`EuVtz
zZCEU&B~rQ{)=mdWQE7RPF3PopZB5Pin;4?)b2|}ZJ~LfjlJ;c*CX!)J;$j65^!U^u
zeq7g-;Ls~_M>*nIp<1LQ%;Ns?Kxapg!(4!r)R>L)Y4?#l<Ka$(bz|F2JzuvbSAt_f
ziFolC4*?auyvdouKG&<JT|6Yp--SdtnB(#rHi}HXEPfd-?|h#!330<xbF|gTM=lyy
z!9tZj-xJQk3E>};`#n+Ln%StUT0uw76*#TZaLNp9j>(9PSxE#(`<wc%LQESIP~?&V
z#56=~!N~wkz+0CkYaN8e?YBFLy}Q1okaV0zPjbM|uvU(S5xYEYGgQm9C>TU&JuAN6
z)zAiSX<6KQSukZ6D@A`I633QIEPL*5fAUIxO{4RQBO-ROR8O-C#U2dnG&vY4{3m>#
zfZ?C<55Q@Pzg_>>&JG#aW+QL*7rx}5ZB6jJ5qIBa75!lTewA@Sd58TaIIjE^f@AUK
z4Mz#B{=OJn0(p|0xvGkCWNz$2;oJdzMQ!9tc`)<Da@5xN;#Hp1Eo}5+o)lplpGu{=
z5E_CIAmFkI3n|a*DmHYW>(gk{!PpABV;{K@vCcGp;j=}Al<b*m!1#8j;#qJa*ek7y
zy2+_~k#WXRZfT2m;G{;nQQji$eN5Q0Z6uz3ej7=kn;$9wccaL#`6YN_+lmR!uCl0N
z^7YIoe@2CJ5g4{da^;5Uyr}d_34asJs~EN^YpQ@Bbf1DL*rkR$`q0fETw4zC%YmnD
zNmMM8$B0azSzr%8_h@$%A#g8=^|s7{lc5d#e(Qj>OY^joFpQbgjxoPRBo~`})w3e9
z9|OTv+k9!ol|QV}9+8|_oYi^PMZJs_I8#PQmk0B6B5wLZS-^3$3UhLMl2TpY*RT8P
zrz%&~b|-bb@b6Mb|3kjlwpL6Gm)@)2PWCZbp8LY_;Nb;+t3xkwG%>bH;)^tT7mU4L
zaqGjTE*<o>c!Uw^_<!2_&Zs7{u5AZ(P*Ks*0YoW+ii{vOKx%N5qLhp<j!Fv%f`AmM
zQj&-b6$B~LAv!cs0hLaGpp4Rq5G0ZSu>hf%1PCFd+{t@~XHeqvyffpo*7vRVNBrY*
znLD}9Is4lC+IwH;9Ccc_FJTJHKX?`&>4Mn}3kR46`_;Xq&=v68!On9Wrq#;Gp@MR<
zan1(w<ov^WG#PbyA2;0s$7iR@kmK6=`?7eWZpSHGN+w9`a1R<8qFs(}9!u&{def*E
zBF~2p|I%>M@ZRYpAgK_h-E`c35Ar-d0L7$xfS{TORG+2mtF-|UPww}vbg8*U#licE
z_%m@H91@Q)WGZn|6LPpMxj?xC`^(yiA>*mxyCH=KtAL8Y2dB9TFagiZQ5kOv&`ZC@
z2HD5WaJDDCuAPkSPHHgYx}}p!m$xNrLP~aJJbBI=3Gu<Y-nbvAM<L3mSb2#_JHWu`
z(0b^$mm`yKfEC^oqldrvy!&hi=|)|S-=VeUNhjCJWX=}FSypPH_kbuvpg8$!bOJRS
zC+3qJ%<#h;lorNRBEZS@{qKRU%;I?LP>Lq12=Nx5Cl{I$<wm|e-HPFmF%SB#xy0f-
zu}H&#nO<$^tSm5aj`zK#nq&9X9l^K9{mwV2hB&fLz!G~QV|pr>-P#r0X)oM;xA$y|
zk};`#vYb^u8d3e~ymQ5t1ASpHiTPKJ{7>x?motHwhcj~zhcm5MM2BMZrw`$Ix3S#k
z{s&pKa$hdPjfr}s5*O#KhGuT}_{f9=w2o~V?3?oC>kixNG(!}~b?=Oa{azuPPDlAC
zZbFidMM?21`ihjq4;6E=z<>Evvx;|VK~i*{lsOHnf-68rcX6$tyutpyUE({SoDpAh
zuliZ%5ct5}qFUUqgWJ!|v|_|r?g6Y@$9EQTBdicd>7i?FsqCR9l@OFFO8tDWm|jWW
z`t!y3I}=aH4<B{k_T|)lL?}pUAtkKoNXa3-o}%0e=a<~doTreF7vfOy!$$za_JfKF
znd?9}Y<Mx)X8G~=8$U>?N+`E(II!F#O!ZpEq7o8#X~WTNg3`m8SJm<Q<NGwMe^x$=
zIO61b5WK2!zR0wYCO<d~g3v{7nThV@F{^tyMyIc$LNKRzXJN^~S`x+Xc2)W{5v4Mr
zXX!(nuAj&94e%3h8_dQ~A@AR^ZpLXt&tmFMpR0$c+oHA9A^giDg={8m<Mo~RHvWjw
zi#5JHN*Vw9#}KU>fWMwbkHgfDOmla`_cx2OYaHtlgyn?c#yQ{8gF(Y^Is?@+#-94Y
zCfgQC7LUfG?smdE16(R~h}vA99WEQoV`c*Rl-Ftx3^*#N{U3LW<KP{cOfRY9C7j}d
zTpMZtDv&V&(>{w&t3Ac9b&Kaeg}#6Uucrqxv*`9b$85mHW9<6vfZ(hWRGu}i*4$$4
z!K8to+%~^{f$PoRpU&GwgVXwII@qVHeLn?;Ad;u?WVs_1b#zLI`k6Rsb;_%-jcVt9
zKI8HH@&Vf_m?4@@8hf$fsrg_LIUNRvZ`fI*nVsF;sn>cwqF3@Z&uz=*+GZaz(63=J
z2Eje2DDaqF#XD86I^<J`+>SQAT_C@tnVDk^m{q&+^;2ss-+oB{*qO2+$B*DrU%e%k
zS2sP~mcQFC4y6^l8TqL%fcjG@Lk{`&>aui)#E~$~@>4ZqwPnS9)gDu0?iNJO+kvE5
z%7FnNnVdUsNI=I^2h*nLPWu!s1EzZc@ab*h$A^cjsUvOamyWDnktC_h&1f_$UB2o=
zo)71pc(-@QZu`Ae8zCB$n>)4yk1K;K<6w3SHSN1LXK39Y_I!u7&duqH(81HYsOdJv
zi6Mi!<N`#^mQFV9^@LyJj~LW!#0ahw5vOBRdVi%wNBNcBn_PG*WAmhQ37F5<`7^^x
z7uCq{300efSXAaR@KcSdXEHap<a9P|SNnl%3f{44W1}ow%FzX@r@Fm|z#>~Jbs4qL
zX#e_)93;<_KvcVE_=J*wJXIOye~5mB{<7o4MD4pk3ZKQ+3HkA6W2)+&A2>1SENKqy
zyi_!GfcvtH_G)v+%eUbs=oqzA_4?`_FT}j$XP@Xu-|W=Puk~u|!~!7%B&B@J$?>(}
zQ>U_DLZ)hhI)0wE^k6KNf18<+I<YSRftU~<L<J*0<>VMMA1ScQ!9s-mi(OHxD)?=X
zyepN1gsXSf#z@U*cm;1f%>auCnb#)`hW2(cvEB8Xi=iPA<B1+fdO&)JZ3~)ZaR42p
z<{6AT1zx9J`jDk#i{P<b-phiYrSPZTmw`!K))wYvH<g=bJFvXgk}6-@3sWy$HU-o-
z&$^Ls4e)`qK&Opc(#|2Gv~z!C)`Zv&eCkh>9*m<0O+XNPC|*3DEpO}LWxI|Hb~sPf
zFg*HL(z$nGv%_Giu(_6SvJ~CgiG}Z`@LrH{yonOaDC)Ujn{&agr>oAex=?xINQS{G
zIR*<ZS-n;#uzDB%J+l7J?0}zxZmmmG7inxq^V6ZnrRk^v^X^;GyT{wp8gGSg$x*mS
zH|a!sVr>Afdq-_qZQs<{6C14BozWLC-#bLPxo63tc)t>GJzJx^Tai)8*&ztsVFYtx
z<K-=tk0#bY!Q$#gO)tF<LiN3hboTni^`a$_IRevR9la5t9NKf%G54xTEB8i2v!ADD
zu28o4OBC4GY|;gbtjlm&M%Tntl=fI}y|VT5m#zK<{Jl%YUOGdI40U_HkI<JGy|WT9
z5$?`E1THng{)N(of8bGn2A^3Kea7tbR~3PFY`b^OGaLJj$6qL&bv_a*pgoG_Uf^9N
zi#)iWn4qAdh-k8Fs*dO8eIA^d>8XL0i#})c&fF37;2-0_5elluzwT7rW9@u=_00tm
zb?+|tKfCe|1>cHR@<-Qx6hw>fPuqgK@fMZnA~%4K`HM~I4eEkCOQT}}hPp4ttrmUk
zJ2BX_phSlhU{Me+{=bh-$q$F-t5Gmh*SpTm!UBS_oh>%BCFi}I=!M4moq7MFY_^M(
znT$g6hIH0^iF2A@L#5}}+f%XIci(EJOvgfBZ<N_oQvK+&0SG3vp=G{UFAL81KVM$4
z$fZP|WB6KLP?5<q*N?9PJ4;cxhb2~D){-p+c4_QtF`Spi>$j^}OPM4IN~AL<B}0^i
zRv-}!#I6T}V!p|gw~OKH-=D<Y*Q2Jw4|J?mE-)D1>%q7puOALUeJQOTJOnP9%8L3Z
z;;Szu6@!g0)E66^(YxIFtXF3~>owf%9DnfdlU|__JOyVt=JvB1389hxdQxkt@JL%h
z%l=8@7a2#;;}^8mnytK@#9AL2e<}Z{kf|-R1-l|;Mz<Wm3*4@235ARqRWR``2*xlM
z*)+T8CR%tsC&AyjZqxWJy_dznayk#rnoG`O>d!*ef;V?NE(y)sJwbxfDzWjpG}&Z&
z>@(HccF*I>3JAPbq!jpl>UYjaN5((6Zz(iXI9SY@DIB2Hefa%G|8ClxpqYX2`XKCo
z_CyHWPtTrjNrb+bAt>0$0IMHwcRoV@ve@&O1)bfm_ysB80}t#$e=;q0?fuK@_=qq4
z$Cc;O7k`_g(Y<S+W0A;xYwWbm^W28Te%S~Gjuh_63@=&aPD$xin}rr}HB4aen)3$F
zs=8|Y;qP7df=`>DyjMFwf~(a!zI&szancjB(=x}i@2T#wcIaDuL+Eoqfd$3FS|jI+
zV670fo36C|fb|H-FvQY#2))j_bAoD)m}>BPnVYf%p`pGm07r@<0E4@}xR0^Q9aIyc
zMQj9rXOq<$5q$n-O(OXGUxZKT$}PG{6}&Ojf&KMS?h~5Br7yjpP%j0>s4AHt|B3fO
z8dpT)pal*7vB_+M91T0Lk7irz1Gi;fRmp$pUhEaF3M{xkl_N$@Lsy?L{c%Dx&GFd#
z9YXl=`(a+tkorwMAMjK<smP_31Ifj#JbZh%3p-AWI||Jm&d{>tzhCX{3p8+Wvlygr
zwnKJ((;r7{IbeChOP+UQ3=)$3C;oql1aZ6EIJIEw;#R^{+B4y|>z;2VlzmGpVgBV*
zBjb&u!7d>ob)wv<?^)ScHP(DX2gVyl<Z%baVkMF1o^dYU-G%F>cS23q%3E+s>UPKt
z)`d@(YQ{zM3=BSZomP_l^Hm~4!Qh*w@^;nk%|hPn(EZhsLf-8A?Si!4AN0-tJgvXf
z@OF7{1emH^YD_N)pL<&}z+CR)H1r7-VP#w6{PAs+pDS%JaJUVY?ta%4ZwRaetJjE*
z!}<N>Sw1%|uno<hIfuF?fm^PD@JK)P%=MUp_`++;f=tl!!3%E8)-SFxO(FcGaPF3P
zQsC;#Zwt81KXvtyPgiXj#6TPv-O>tmZX3=W1nd+ttl-Uuo5JD@HF`~*hS-(0Iuzgq
z*_71#FbblS#qy5Jn6<0@+-1im4{#F7rZ^}aZ-~kQXI8NWZT84GmR2WJKN+d~zF3&)
zs-VDd>E|g62K5JDNXq-39<zn7nxBJvYr&`-8w7H^75U&zOD@t?<3DO_rtGoaUF*jf
z2L(t5+XbC<f6qPq&X7MlxUh&f=g4=idG+Sf5xnK41p83dSyh_ZzNhDo*SwoP*-5}h
zEzIu*Fev#e^>C`)?Kj2~hviUUi0g)`_g@n-3M=_}YOwE{sKJP_(*%lpfxzhE%P!yA
zx+eL2e`>FwvpeNcaM$JyUyl?SACEKT1q}JwmX<bqfb_Do&WHC1W1+`mz)T#hkll&6
zLKx#sX%KTEqrVpdzQ|xpINDi=WB3mHDGPCogGWKTxo*=e;ARdZ#>dX(w*S2_X0@3U
zEeM|n$HP+A(ugU^-nts<5N3bUjvWtywE~%uPwfXLZm<JZ>lM>+F~wo}tVg2_%8;=A
zW3lA;`3`XQ3EF@O0m(>ClG<${U0>Vh;TnsNzaoyit5F@;;{`U^k8MV=t^`C}i(6P@
zK)}o<2FL@8n3>_O4~~DX&%YRi-#(D3t}eLsEgs~-DW@h=NJ6j{4bUFE<3IO%T9Cd^
znIM<JDR3wthsTUpVLf%8mTcnpR`Q*7t0?*C>pjc1{f4A8c5mt^mes_J=<RtnoZ^_c
zb|Bc!7F4@|4hTZLr6g|R@8>$jF72+yhWb1z=~~DHU#EcH5Y`QlR2FyWbNMw@%0fhF
zwVeR0jOcGlM6QYHY<V{PrbOnN7-6mN(Nbcw4rKOI#Q@X{<A4Ir6J`r&$D%?gH4{AZ
zl>Ghj%sJ1c8cpAutQ`!qs{tAnj<LA$254OT;i&ExZwm53@qgBDNXFsrX^Guc6X9N6
z1a7x<K^YP`{>-j98DG0kj__1j-M;*%EaqkD@~Y_F3vl6qX2mY0a;&~|6wF8`E<l8g
zPo_qI?4M)=$fjRd8U2SK`}k{MN3L2vODfZJ;2@F1qs=>ZbidFn$Qza>?JAnP#mTkV
zUF}+iYaW~^_PQ*=&klxva8cDnTMpq{#gRd_{4A&;JLpF~&6_{>e7+SIyXD{>omK(<
zgP@_d0)668wXCc_!(wYu*=D|lJe_Z{Ihz-A(X)4U#2f{w8Bw)->pHLjb-;@>{azC@
z#qW;vDzWsK`VjcO&GEPuCuJev2`KrGXH!!SfdTJJve_<C7cG>FG#phEM3E2QRvfmD
z%tG-36QQYQyJ!KZ)20^%QR8gs$0LJzO6vBhyCYbS+$gY)sE!RG6}%~QcX1pt@Yo8M
zDIId|8fdtQZQyv}iPb^JoQ68rTdLV6NrC5CpNoncd3tEf3A7imFR0Q)JWG!2(BNL{
z!e`BT$C(!xaMvf|Q;VK5vXBS-GtP-AORtD&HyPglul0Pl48&dLl9_CuO<%-EGrz8`
z+$xlpCW3t?*MoWAl4vv>ReS=FAW1$zbVyu%VgQ2eF6euT(;Yy)h|0jExUV@VoQS}u
zX54GP#TnGdVhlhxU2~$c@9}%%-I&R{G{U=f_B@*`EBENYBM<8`yyX4+je?O=(POV5
z7rl;gW^WtXu`Y?{GeWrmwcwP@s36>R8ILe-v4f_N!QLKrZ2m~$%3}MAp&O*87t-fn
z!IHl9@x8C~lZ5!z-W>E6Ap~d6fcaOW>IFeX^-IF@HzidovB<^_s?y22nU^^<SBFx)
zCe?sX$E-hA)`I2I?p{c(l3Z;l(V@{xZ2hAQ2W^2WtUrjltSokDz%CvCN5b|}QeEh+
z*CTBjda|+}KWmV+-e-Y)F@xc?%*1VYYU{t=aE}ofAik3-8omRD--T2+IkiS8b6*mv
zCrI7tIqSX!qLC}Nfcuh@q|_{;@sB-zSiQm26m?})iXpN`-qUHDB%;Zbw`+h~fYc{+
zd>qy8J-_E!SdcD_m6F^z&L3c;VRMU4)_Nc4yvyXbmhn`fSwZb$%B9nDe|95f?txBY
zNp!D&vrsiaeQ%KRVq^PGEJVO2$);Ncu{b3({s&prf1q{yQDRFKr6LfA=Ix~T29pl@
zzcV@(wN_4>aC3V!?(&bjaQ7)hQ`DNhd!CWUAK@%%RcEHdn@MK8dMo%)4vxU5Gn(Mo
za+H93m`8=stjs$JcRE>xsO+FBPz5x;p0AR{DvHZ0_hn7Ks)WS{Bf;|X?|qTOm)l^c
z{}=c1S$gv`?RVj5_k)BW+Esm1wEN{<^Ybg9h>BHI#vfPDGS$v)Xns!gg=%x3+u<T7
ziqR9C^TC#<S@%kgO<?FPAz7PGO%SxXo&+Sou)O0wFXijdWp`*G-tSyd#&u*`ZAQF1
zT{^3-;K+HUoeSXY6G0_Wb|-Smyv>8Z;OriP3hBb%SJU_15CTl-{gC5A5#iv?`BG8;
zH_?$_cRm>|FUfvJG+8UJh93P;HW#xW_bi~(QsOr)y<49^9WyD+oB-<R$Bassw%iGp
zX^BkTOqz=Fz`FDGu(?*hIrUwW&MVEHt;<pTW2ogjEuV{R8MthXi265c6$KK6vF3WX
z$9n<}7mDSuej`zmVPTfKJ)aE0UVP}=nf+KVhNkWUZrEV@FlJuE=Pb%}0Q^h21s*fM
zf=+J*exVTdEuEI1HdOJveUFAin0;Ljb|kBt7eII`1&xq{oShjh%^d=K70k++Q~({Y
zJUzo1UscWf@zbr(qZm-Qt!-HEb$`#-d`AF@+%8w^;q^$)WJlv6kOD|(pljbS>sWaj
zRvvs_*+RqiH(1VwKV8{94bW56=W;MmAu7oax?n1_b}|)$Xg)3|zWrmK9@)A~3p3Q6
z<9utodG~TG=D_gl=FF1smYD=c3}HYa04uu7M|POgqF0bP^@mD<pu6Zlo;$|`4-Pdq
zouyiuYx!7^^*K7F2q?aOOuL)+s51A!-uO;mF=dJL8tg0~VE8U5phDmtw2eo>9drd9
z+#)n~A#bh&0W@PZNL;hX2M)HrHxY(e!aS+G^DQuw$!Ump!^g-e0A}f@s`eBiUSBcY
zdTDnGDSRMkj1A+Lccnc3EIoxGMt>o2KS;;2dn+27vmcdMY1e(c6?l#_+d?~g2ILl?
zrr{aD)MnjfXn&R>t_d7oDxcJgWHQ@zM?q~-OIguWOUVgI76D9k^qqToiQgsW<JmOi
zZ?>Vda4doJIg_aeA;y-X(GWuZ6L`~@wJ<I7!+$pfVs?|2+&5{j_Uwo(qD7bz7&qg{
zY0q;`+CNde9eio7qN%+8@aoNvk%ax-tx|fvTL{(r9XMVkP!@^%aQhzr$yp-qHgdAJ
z472jNMSZ%%f!`3rOL1%(o7(A|-r_a$wu*fcQQbG?azS?@90O4Y1w_Av3{Iz?1l1qG
zG3;!{V+E^SyKByMmY}DfN#`kxug&dQ=CM1XZ<pIA<dbUZ8_e9pF6`SEnqJ+ZU~_yE
zhrLiR^!ptos#Zx{E=hY)-ptpnS}GjK?dJjO{w;ugrFf@N*3OYJ{jsFy(*ghY!zG_K
z#=eahqnk!v%9FNF?d088(BY-OZ|{U6b-lyMM4Q3B+*;2S^HM+@$k}F!CoT3@Z6{};
zwDf^Z9`9T4o_%nFAMQl7981SzsG~9&_uA5Zx%p+Y$K$et+O_L}TV)&@)E36+Fy8X9
zPYS%Q)0`AZQ|FvG<oUp=4+tjI9Y8{NDGV@tOQYLQlpu_CYr~nN{WY|3H{Ia`b1K_D
zdV#;*1o`XsYpGGr!u)k<t@(mWpEs6<qv`_wI{i)j)oHaDkvEOS$tkcaJxT)EA^Ll>
z*mt6=IDLUCm9?{P#$L}-a^ik7RHVI{GH6<E70jpc^X+(SgRzF&+FL?yo{&TyvAyvA
zB^Wr1e(#`4H95SK&pue|4y_p<*2t=DeNkRe0DAM8vcSeyEdhr;>^awAmYfm{!oP|Y
zuJiFJDf>4BD+QX}b{lRf=MzDvSx~1Fz#H7in9*l$Aqm@U*c}&N>%-5{&0(3=gJ*L?
z)iL-wTpBcNdZ>7ZPOU$<IYmRRhSJ+bmVnx2baJX;GUb5eg16KHy(QtNef3j|0>DRl
z@OB|zIoCZ8uB>mVQSbRa(%__Hn$H|X8$23lUa)jw!+~=gT|c5XXb^Q;nx)aEnB2ZR
z*Y^)kcz~**vB~;6fwp$6IqUi5{;lGNtvJ0+`F8vd15E>GSa52FmOdpsP7gv-@qhhc
zlDBlM%+z2<Q4Jp;bAst%fZZS`WNa46ZAcoho?fGpyxUSjmUGzBXon^mX;CkwaSW8)
z#*{t#NL2`}OwAa)@X{d&E8QNM2nwT~N1}u8w2(W2n<$HDti5)q`9crS$PxsS<_VWt
zmz&W_$4=#{#q9k19^mIz&flnJoGirb9O<or=bB<wPl7u^9|uwcvh{}TGp^KLX|4#V
z2a4r(<#T?&d9&=(U`p<7DAMGZgj6mVIr&wN1rZ&GaWyLXQ&n`UzzqilO7mAFq&We3
zxHQL{o_jCN(Y#X+k_9|gIJN;Sz=V*41ll_WhV?3NG*&Mkm^OCLOzRAtg_e`5T?vm4
zF0{~6VW2&*7zXht<G!?gtz575X9yLJu7hpgeVGsEtBL=xqwN$UR*85Ac#xY6byxX4
zMvUU~H9I)jwLbhf$pQxy=R8PJbp0=4sb%-T`buAQM)!hZfjQJ&KTBP4K<{Qh`?+Lp
z9o{}`t@itSjpCA8dhpD&WZ1>y0u2B(`nQsLy^{u1FMp@eSSUhCu4*=Y#N9(l-TU&+
zNAh#;%06WV#7;~s`%k9-CFza967LE}7W02~SYyAXupu;C3mvB-gU0I%X8{PhPYe5A
z{-)LWxz_Msb~?Y<?O!*a{;6Vlao!TSxOuxk{r{%bxnMB=ZKv~#dhIWJxBs|4_`f!9
z|J0WLO{??sHiG}M)46CP+F$l=|8Y{dm<}#(-Y(RE|EAUXSxfa_b~?XoQO*6!-tA{;
z%HQa2{v(t`@Np8sXI>~Eg3n*e)<p0T7TSoS&!xpW8xed&@R?WMiOAbx-t<ppY9jcE
z;3I<1dKppfGq3U#<vxGC*;!ON5K>8tN(bu{7mK7t@Daghe%pko@+Q>J`-giBMDP*8
zM+Be$dW((-J|g&t;3I<1pBqF)ZPUL#Z&cJa71|*xYMU-wv3P&A2tFeC2)2xiR0j*%
zsz0~7|Fh!>MDP*8M+Be$`g9Kwd_?dO!AAt2KM%(dNk;$r%>2dD2a#m7;Qy`SdX7&-
zC(5;z&*(M;y|G%onQC&`xp9Dg&h@RI_Wtu#n^#^YXzv04o>Lt^+H>OWv1k2t*JX`j
zA>+l5?>^qJ$<^_D7y5|w658O<`>jmYY}RCxqeWyqr`;KE;?`3bz3o5(8$8SoKJwLx
z6HaSDY5x^EcrL`c_OZnauIQHzZiVwmYIArXZEOLt!w7DdsrLBlc&Ag~@lLK&D<8fO
z@^)Q|MZ8dQ08dU=J>Vd;QAF{HKr1h9jZ)gvEz1`Ekv#B6?h^2WkED&asU=)nA9@8m
zzpgystJA9dkl<U2#xg&vqID73m<TT-KPK|YpLIi`__C<%E{c_3PLCADN>Qv7#Y$1E
z6vawWtQ6&yf(`7VeE%~$_&->?U`yZES+YdE_UMsAzlv%yV5R8);2Me6MYJxW8m6co
z`}y=OQJq{=^B46mM13Vuk8Hsuit4eVdaS6YEa=vX@|Vx)wxXY?*Dumwi1Z}?y*6gU
z#<XkePp{icL4j8;A;?hP5Y+HIlG}vj_JgO((n?@@lX4*(1<ag;UZ?*m;l08K!TZsM
zB5;*8XYeK?@&Y~32bfIgu28)2-8#PLhMb0GEYOdIlid*`?)CIi2&a_98Uufl%!2|w
zP<TOQNj-Z!EuUDDE&rAu5$mHcME<T`VMM{8nW+>thW$AT1HKK*pC_i=W_k0wg)_wk
z#m9Hi>&={o$VeU;vtN?dH}V~#A~Y4{Ek8ouiXepgp?GDXHx!;wk$W#m@Lw0_fmQp#
zdn{Y0ZRHyy<FBdoy%s)!(?62LE+T~$qaq$A?_(sMKfN(t_t?0KhX(&U*y}ZDt$mR2
z*$q-h;jWyLl35AO>3z3J+zyhxH3dxqs0knU?GzFz&CN=v{V0<b#nS&nA|`^vC(|W_
zjyr#s+EDvrz|Tr3+o3xRW<M*J-aF(plu8fJ9Eeu>L8|4&4FmoQP+%3_o*piIy6`x7
zSnMP0>$oO-dAv?~4ftrBqXi){zQ<&l3F7=i(*@G>uL`}%yKoX`FiJY1Gb}N5>)2z1
zmguAI@RrA#Ezt+MN0!SDAaan-xe7xYWLe>SDoS13oOdmLIR6i!TLdRxf~S2)gcsDz
zE4K#k=}=HW9}509KQ_Vk*!WHyTiT?)jvqI7R=AE~?<A&7l=gK!bVTFUq(;n^N(0Vj
zhs|kT0$o>O9H=0xG4oX3AhljbC)~t7PUr}^dUdgtF@d*T$CV0i553G?c`KK4ulZCv
z&m%HkzZslQJDxUOPk8xON3M(+`p%G|-vF9S=p}4#^p=rGxcmr8p&!L&wOxVFmeY2<
z7EJEgwe_WnXT+3ohPE5yUpFH;7$gObY`%i#$HBPQ#7*TEuC(}*b@^&c5-|W#q3%#=
zBe-6Fngt2*2aGCLqqT39gY;3qTrXuDs(ibR%25Z`S>#7;gv-%CXb2|SJhttg@Ou(9
z_C&@%-kU}+!<&X>wLDf&W9+aI5B11uiH?k?T!|QDPj)Lsh2B6>XgngarhoOEv`KQt
z4?@>eHb^V)@qL*o&NP*rrmurY$o(LdrX@M)5q{w?6C=}b4S7!ERw|-G?S`59S*gSA
zKi^QhWwvHJ1qncqLDewTJ<s}+WY#SPbiE8Xd*>&1f;PW=JuW|XpJq~VPA(#0Haapq
zN+F%l+#hBqJ;rYCIby94I-?P@BBr)+sCxV2uUMg`J_*o}{6-1Q-4ZeFja+ac&O|{C
zz~xc{__5Cy1NTzHOEF^QnGu+DnwIa&{_joX)%{bQ?MD5khU)y$YPXs%-zck7R0>Lh
zzOi0r;utx*SLl}_j*DUFdKh|Fn|4KcQen=Dn8#C?Bc96p(~F}mke*65%ArMC`!ssy
z7%)CV6Y<(@BWToXZU}qIDvNjGkh$lkAaYDAG;qxlnr;S1OEg=I$a7Sr^N@|?bm-DQ
zxQX|XWD+;g9+}pQ+4HRZSD6)y-=zLvq?&*8W`${!b`Q=WgnU0;kt8`K_rn-ZTD<z5
zWasZUz$HMd?Aa%H%l6-I@TW2SR)0(<_*MU51xUaE2{?D?h^K0tWBp#ur1Mw_MYr{T
z;Ixn)7@4Y&x%-8;+l$b<_W_Uhjy0G$K8QyKX;Ml6LP=fYC=8R=&^%$%`Gp>V_>Zhy
zpW0x?Ti$!sSpJR4vrgA>#k$^YIbp>q`UVg9tSxgjtOr@*b2_}y4oRXoOD%AY$Y(2%
z*==Q@ueG=qxhU%ZeeH(19;K+YF+*E<dB$s(y5DcK<#Wz^sTSs(U#fgsW^Z|7ZJ@G*
zQa*s?PiT}d8naE5|MMt0b)<0cIw9NEp5u;>@*d>W0{ng8$g=Vwc6ihL9SQ1Q7V>XQ
z5sZ^a21T5+DP)}tYxMz`@U1yE%Mf#o3Wx`BfljV=n?b`2IGF30zjtY<j7*wjtYI_r
zOcaJu!t1g>QwWKS&&zLgS`5NT<CU4^&CajY0#8jKv(#>lYB|T3t&9d2NG-<f)HX&E
ze+I(uwuOB1IPf2X&fFlgp6Pt(2=8StIB;;xS=ZL#P$@pH$B$^-Fax$xq?a<+LJnxg
zR|oZ`SrCKb#|m~Q5X?N43gfx0CEQlM7#_oJRZOkV&}yNWadC4bWbO)N?iYm?j9P+L
zd3=wtWBA^&lTgVC1wcZ1|Ij?#`RC#rXDO0MI*iv?$$CS2_fSlkv;=!nIJ|6L8Nug}
z_@i49Qo84*b=nVe2gO;w2V`J|C*DmYv<AqX-L22DfgH`yK9`@JAbX6Uc55yUIVTO3
z!*7z_Aft1*OLOs*8NCZwhM2sfP<zU}uilv6b@|3J<8DN!OoThi$Wu9BcBXXuo`j$s
zg||UtSQ*Qm*5FUqZ+47GZfJh_&PO;VDJ<hnO7bUj*k&)3G~Srxo9rvUbH4gDorhb>
zx!=&7BhGRhoz&*Ngfuf!JeHdzr>$DLc<~#gRVFzYJ_jo~MW4)mVkV}nVbDze&d~d{
z8;PVV221%hTl#SO12^PmnKS?qJu;)Rv%5TrKiP<R(iz7N+xDMV^t~i<?*8@Z2gwQ2
zzB6sw)`ySkof_Zi%g0!NqbnG558o)0R=&eVGIXOXD-Xubt5o>p-Va9X{jVdwy6tZL
zTn>btBgu%rYW%F%)l&&5DY05JRMucN$a^gz_pHI0K)D<hku1);YMD<FJ9O)N)g8G8
z#%;zzvwf*SdtLK~%W4OkGj`!d4(Y#-)4#{Oe4R=@WJtCfnq0GkoP{AUqKmx)J6t>!
z3!`$g6T(`&%9AotUNb=)gh6b`jtk*Jwxu}Pm7!L8>i)#e!fO`Z+k%oj(1>mz#Z$G~
zjT%p|#QR$`5myCTp0RsmCZ`;9yGQ34VknPorhpCczwJS;2`DMsbeK>Hy!`4S!ex%q
zql7<ZY|yD%LGg}W2?SF@k8yYBRB_IXrnSOYjTsf93^(M>yymtbom~wF4V$rtFUq%*
zo$C}v^$sL_)CnQzH<QzWbtv(<vXTJZD?&72MQxFhd@kJ&AY6%%@1`sAA6TAp6+E!j
z5RV1eJYSBv1Mt8IuaS>ZFOO9_Gpc*cb6efq`{NLDUh+PC=0v-JKhW>{$^ecOq9#U8
z%OiUZxTzHe1P*{ctK0Bl*38o$TWe?<t%K3s3HYO`3v63=+SBoj8$GJsR)CV7r!vk5
zpQ`^bdMLBUbR@iVILuQS-(G@V>?1EVkXHtJ|2`q*fNc(oFAfhh7|MHMR-Xd$oZSJa
z!F|(Y7ZA$mrONczS>jXrsRfj%Ih|x6!qB^(C^;R#sit!C{O)|`DTL%p4Xea}Ukm_!
zzk-gXtTGLQcHcPn<A0O^il_;w9+DWmT+(GOz5&1eE;*~`K)2g>he3mg&UH)Bl2EiZ
zZQ(^^(}rZLN6M<P{k2U~Iq@uw#Sv`9x{I*LLid?u+19ecYq_xr71GAJvHO~)S!FCA
zy!A+WHJ<BPo-{F1@AX6BiCl`VNy(2#JCw`s6vyZ8PN?uwc2H<BsHvl#L@!*8^C$nj
z=%84B%g09gC{Z)6=jZNxs|3JMJ1D*k9yjBD6^Hae$=`#miD_32O-0Tqf{X7{3Gf`{
zhXMvXF!HaWW<vvchlQD})Vk)SL6!6+sHiy)^7{z+SM)pC%hwRKP-Kv4ki&2zhIAZ6
zzX1s-VwOa0jZnX1`|4AEMZ8u}QkjiJnr%yPo7j!A!h#`gkBxtpM?hRZr0C{izXBTG
zqZPT}1B}?7L-`cl)}EvCZ+`KAJh7AIQ=F#7ymiR)r#^iBZKLrY2J#W{VJ7373qu0o
z+ce|LfW8^}fc-8?e+iAHh3P!;)%t-(k)>1~?NORn-{oZn#<mL3vzz&6)dzcSg>)Gj
z7(v8MMhbF?lo@(MmX_pDocsvr*`ipPI8sZHKZODq#=WWh$~~~e0L3hEwg>0Ep5!#~
z+FGJGXOKplDQC-9Gr13`DE=;oseonH*i>3RsXVp^l5gp-EhrIBC@z=@%7-wUdzrjU
z(mOq2RJ=PM*|VoYGqxBBuC4J}hy7#M*6C!Yx0S)O#(Zgsq{IuZFpid(!-h1yT(@{x
z6TGouf#E(<i>7}^b<<1$#s?+IUbypP!3<0zd$v_*MtfW4Ovn{R<_`3lviqy8JhuhJ
z700z>sT>FmVqk`mm1$|5)%Rmwxi~oT+FRq|=*u;slUU9CtO=jWcFQ%pqRPH{(|wWp
zM%Xntlok<;7om!@s2Tm{0t(ijS{8Z{nh`!!Z*aYBN&mSNqjBj0D@agW&mn8+G250L
z*<<)qBj^A`aTh-Gc?aB|^ob^0miX1=ZeF4P&?WG84oGgIEIPJnCiFl-mqsPm)?2|K
z0JlsY8tZ|Te%rglx+Jy2OSUjzOW|#B#=wAGZ%RTU27>uq*r!`xz46nA3aNNoW5VN=
zX<9+CJ~rY<(FIxwUL*1b*Jm(cVW)UE8=ARSb!rFL&ItMD@QLMXbh2IgXf#OJ9Z82Z
zs{b|v4$BPnjUd;IM>Hh+LPtBVL=Y&A5%TZQ9Xj-^!4X0!i5WV`V%Lv(;n$DKzRJ;U
z-I5{O++)%mT(=D<E4&|=0ml4#tl5lAZ~WdLghIuf^>X<)*7<|+HKv|hZ4}aYYM0H5
zz=w1Oz3WjEmgqY2Tk_i!UCEOGwb(qcLkTE!cby0`Wf$Je&H6ZoWx7E~C@s8Y21$p*
z`)X!ai4`6V)C0WXxf60@1v?UgV++6!13f1Gb=ASXd*}T41yLiC(2h62<Q)UpXcSfd
z2Km0e<WxyHy-vrS8t-KRVSYk<Uno>%_)cusiinFh2K8OBQ;2ogrQGZaObT!IJ42@2
z6>5ponbnXV%p6>1t%;*rns>pp#$;d9vn6NjPPXVc9BwHG0|ebvc?u>p1&U8%jmBjh
zCQ=bn`z$h+uhn>Sydrw5KLVCh0>KzE2WIi{tl8Tj^-P1M5{x}J75ZABiy|XDF&I3)
z)u5763B_v&Ws#BSRk<cz<<T>xCPOw1kl0ykj|I?y>cN?Sfv4#RUN?UTvuB?Q`4EDD
zSc1L6(yxUgIqOg^10#Cy4ywCfwJ&W#=o<Sak&l*7PwF!*k%Yl%#X-t!BpeMPyTv!!
zKT>$dApqgzDhy*;esMfz2Hm^2{7xU#($&uN=)kt1yPwG1vg%i}^2Bg=n7Oc%9Xxz*
zLV7HuNLllax7_yf1n)K58Hr^qM_4I`)lnTXTkflJ$M$9aR=^|N9Ii|u_n5N7252y?
zCO{~?TN26KIGTQh?SM{2;7zURqrq$<&~v0_z%c|7LhS>jmnsKXLtH~3l2ZdCk%-tl
zR0VcoA`rsN=v5GoPN$AKag6HVqg3%}Dsw4!3l@Rek532e0}vt1QcObBQ|>7z&&@1z
z3}{aw-nm{X1IS-Z)39V&4~~2Q>680v+ppI3azl^SNC~k=&suzpZHBk#h7!qnD6c$9
zxHqSiMx!jND8Jc<ed=L@8?EqC94pA8*O2hd<+#q0^m^f&S{0w98+j`2FYeK(vApd<
z%$H9HHl*=Bk#)zI1|KH70F-<-BrJ?NFjGJ&QWz@0gk*RPp^0AZemdE3b>UH7^o@*@
z&qYb;54}ed^>0AY0~L}qxDQMjVAbKUFlK-S`g%h}Y`kFFDXxO)l0Gza3Wdj~@wj;d
zvna@ng77dWJH-mmf<POrU?duF0Dy|cW&zwFNK=`w%H#v9r$z1-9WJqXvrj8Kf~Eo1
zk2=Y)1OEorV`2^&Z+rJtc$pZU*Z@{3=zw8CNeYiUJ4UAE@Nie?rqIs13`8Xkd*vd#
zk7W4T7lHyPT36CtSQCg?kFTO&_^OB*MS!t1SiS~LiDK(N#*)XFWSv10ij)fQ>H^wH
zHDV5JW=O(}jdmI^gT4-u!(_mx0D{EjqX4obH%gcqs%?8+9y4P@H{(38ntpKonSllg
zss{;Y1C;|b><m`=;;)aIpZ4s_ALupqSJRB=>7y7-916DQU(@iFb2eCBqZQ99BNk1_
z6A|Ov=vlnSC3`V@IUtNq@#@3E{CHC~Gq|n}Y80Tu>z?gC93G2h)<Cqe<@@gRF@^J+
zWxq)Ym`dm*HJEd+egG8^phn6d82~=0knxMN<z6e#d&%}eDK5m|+uMK?0*}faub;JD
zW%3o@L0CK4O_<5$5<#W~@n#43FzEx;#2NJba-+1R&FYl2TM^^30TJv%WFVxe!n<Ct
zi4JTDH=JZ>;_yO6!zGbFF1JRfKF!OYdSFTUm=|21i1qKVSHV+BsDNxpc-TGO&cdgC
zz>{^(R-KK^0)qY@$nng67viiU<Ev%#6jLzx1%LUf{#A%4ClYQ*qGEm9ncXy!0g7d3
zr^vV+vyU@i#qXMZ5c|wP3s3Q4AgKT5u2%&*xY+TV5tYQ6mS70E(>DuIiPa0z=McP>
zS)-c=o{<=LSm$Re%i~gF86gEIS_miNHS()i^1E0etbMW@3J1qyC)r0O+rsO3EHG$7
zrZi&O#Y10r9_^zA6H$PH9SnkhJE+3>cV7V2w>Wu2S#olJ=M1v~$l`WF2X>Lq;Wu0?
zd=>xEVSic|ljj9wk|;A|4LrXq`}5tM|9X{3&1HrsNTW3^F%?Ya3_Z)I0EMB{1=w>c
z#E7!Sw1U~a%4U4C3|f#Lz?$H2M{j)nJQK816lkRox1=$eH%E_kx0)Kwfl6Wp>3+b6
zD~A<ghf945_~($}k4v(!`<_q`v0h&-$SN_S_@_-avEYxGa)>T0M65fKz-74W<U82B
zJMN&|Bwrq&M&$lJgBy996CB$?%A63cwXS&l(~}~v8Qx4O{{hNHBP)@ViG>lc7brvt
z{f9O)PrW-n<^d7z92WO-L^7;&0DIvp?{&)fT^_+W7K)~j-_Fi)^COZ;DFKcIB(D><
zbf)pm^0>9kr!xicLWuTTME3I`y*^|QRfpWg-161sw4`61IKR}@IU=)pITdk1$l?^h
z8^RpNg5IyVAxGCF7XFZet$|<;aELtRYlh4&a_m=8r*h-PqS!7}0sjHTWdQZm9ZAH}
z1kZ<OHRKSED3~J&RP2h%rs+__iD0${z+gJ+HeLA2b4rPoyxGpC&nT3K$9BvGIP#OD
znzH4SLqLvx1|G&PDc69Ph*ui8bJE~nJ((>QC;!l0AFdDJ2`Tk>j0S$xh3zGgYxqp=
ztOAr@9$XwBPyy5<P`IYAQ57yx`zvwu;~1v5)3-0X6o9iL!uxsUVsV~7!qq@0v57KU
zYFGhi>V$;%8~$7DNC7{k4}OZZhKOaK;=jtoH)UhtVHXjCY8Z@tE?l4EQAwhFBx2o2
zU&Ys|M-8))dK?dO2xW{(qtQ84JT_>&W+t@;*+5yqpgBNsug*^vcD?<UPImNBAP3-4
zfC0l|WStRSn@uHttV1CPEJvmSg<1af0JD}=1jP(OArx+L3LD7aWE%3gKta?e0TXyp
zU^s{f4n*q7aK3WOvEYo>RyH|;%Q%>w@{zz<aehMCV4C7?%H-Gz@BB7;S1cAct^j|`
zp>M9_0B8u~G^zlZ)lf0m6(aa{Oi3P8nCnp0o)md(8Nm9I5E@N51Y>3rXlZE9oFk}e
zz<J$M2Ke?R<-+gdbRrUJ5C~y^>UzraE`bk{$4k^F3)7opxOrHZF0YXGSlu~L_>p%_
zVyK63eZeCNFbeKaf+3U-UuIa)Ii*7iMZw6$Uwyo)p}<ov&M-XiF^x?i2T=LquvNd7
VCBnC@S_1w#YHW3+_-Cif{{x)6V#NRe

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e2.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e2.png
deleted file mode 100644
index aa57f1ab5051c8148d219ceee648c1852ec6223a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 287550
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%0D3e!1>$Y^`)lr|5js
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
M(END*F^Av&7nA&0<p2Nx

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e3.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-e3.png
deleted file mode 100644
index 137b24999a5321da9d73a4d4e521d5887925b9ca..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 334115
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%0DLSwqh>u5
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

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-f1.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-f1.png
deleted file mode 100644
index f82544c5fed28ecef7109290d114022fdc8a9f83..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 272470
zcmeFZWmH^S);5YIKnPMma0`V5f@^RH?izx-ySoGp?(V_e9Rh(6+=FXyclU2|`kd3<
zr2F16-uK_VUyV`JruJTIO`p%4YeArllrZ88oEH!f5Qw580&)-#FGC<8pgZB71K)5Q
z{jvbQ;4$Xsml5UXCz7$TG%z;Phky_XjQt3!B;SLPrWzH&`yQT%i1d^!Km?wM)E9%-
zr4AGY@udR`j?zI-wyh>Z2NJiDGIPq<p<^&}>PCl;PZ<-zVNLSIW@DL~<?%o&&qK=9
zP@?U|LId=tYxq*76dx0ah_}7*9WXbHQBm?(*%qJL2ti8FIPvl127-cq&`Qr|TjL#B
zA&5=O*t@Imryn$f$uuLnpdkXi--V`k_4!>AK{&mVrs{$H^k!usZ#`HaOEH7m3-W!l
zj6WlKy_o+`bf>a8G8%tG>$eb;CTgW5&=52F-Hb1suw{HEU@M{nXwe}v20u-avpO;m
zE-M6>XM|$uByuzE!KQ|^8s{P!+caSFE74;*%fh3q2in&Ed>FF3J%~yM<DY6jD^kfN
zArWFROsG?xj{dHvgt)9Bt0F+sp@QOxa=dnqk`*IiEYjRgz`VLvp*{GCrbEijf)}g9
z9|bnhhPXY}O{I}80GeLy^(K=xH#w3HR{-XVV<_ENmSmD>-I$i)YdiSloYf&~Qkzx=
zP2}w9BdVPH9SKO`g7A?Sj4P<Gb9v2Vi6jC(B|NXt)o?IN7&Va4Cgac<79tLf{9y@c
z9m0#gTQ=PFVw9ARUhHOcuDR_>Cz-)71&(wfJsle}vm1G$ccpjbvuzs<f<W;lA3mRk
z+~qH|OYcv-Kjtbdyxwpt7M$><91vz<1<QA^$%?toNkpJgtqc%3^t=uD5cUJ@c*$E~
zb7gD!HvgSqijy`5E0Y)qx#guVGz%QWOCmpJM2Y9hyi*Ia!w3%)F5VEBBD~L0AYe%u
z-x13$fW0S`WZ>?7MIes-JFog&pJhNCYkpSxF%FsC=Zdfju56PJu;s(*_Ik)Umd$)^
z3I7XT&-dYQ&@UEtWx(sh#KXZA-#N#3Z;AS-NF*1%d}I|==s?I06djZi4AyV%R<xXW
z8h2Xuor(2bzc^cF(b7=a;lkl2;ZuEQqkRRV(lhZ8*uQv0Fkl+<tV7j#CzaOo>?4kU
zVJHp8g@B!VcCEeCGF<gmZ@RZ$Us?M$`>qcA)`~U8L64k4j6modJbTL-Wgu*eFBiFX
z-F5p$M-sP})ir;^@L`v*a_F=9)KJ{i`&|eJ435Cmt}rdcPhR+4I2A0r`7e=6O39DM
znK!A02&7rYK=<Dlf2GFiGYl0>6m)F`XVPlYNuGy2-|bo6Le&;B;P!du2m|Q@US<o^
zddI=m1VJ>biC$L5I&$m|Jz{<{IPd@saj*gn4gI;*_DdJ!)CLmaL+(KeBANw$Aw-Jl
zvMA}Z7fA8yaEH`ikkXmlwO;mnA*O^gT0v`kLx%B|L4jZ9Wk`U_8uHyygUa<z)FOBT
zsjr2t^lZW_R10AW(!u900}>CCybaq5r1pHWO}*Zw@f*T0?1I-2oOc8Y<$K{%5LyRn
zg>VXpY}p5fcuC}CR7f^4b^u%?F=OPF2)0~UF+U5Kxtlv1o-Hs%m_1^)n?D=YIn?bv
zy#nI6P^ipXJCa@jWg{${&r-aM!xToZRYGX^CNsu2X{rgh0yPB6vQjq@stGOn3KM7y
zg4nbqLP7;~D3sXA+6;7al%6Suj%yDba%=uzuh7^9OLc6$gLeG%_8m-km-8jM8%qn8
z=I4WNJ4cGQl=mnH-&;ZXF#O(JZPDLelYkiD<l#wuU$nEdziv0aq_PJsfC2^7Gnq&5
zxr2K;sFq(Y>nyu06D-5)z#h?8qze#lMem9(WQ(B2$4FDYE+O3`#wS;QZ6C><pI?}e
z|E>t8AUi)mAxMEz!J!aOz9I8iVvSMR$4vB`L^$edb!#<ewPe-cnA8UIicv6HNAf7Q
zL$>nG$s5x*_Ax(WTw_=Z3kwYj2?|FF-;XyGnkrlrrpdeKU&~604@iZUuxLmY)(V(6
z&A`{pnpoy56uue{PkKL)NAqPuMp~9ohG%$_Nf_sIXWqb<52M@0AB||od$!}Ysm=no
z{kC6i!;aAwT$n^K7c))asD)1B#NtTeurgmWZzW|hfthWYF-`Z!ILoF>1V<}JUyLoA
zzA`l*Vb3{B2pbvLGGh<tPH&0zNLt8|9IKsJH!?JiH$IrKnB4z4GHN{{I-Hm*Utp_{
zCy)8FW^`?HeUoN<zRZ>X;wN2}cCog%cCi0AViUve*99vs9xgA9f(3%FJ1*&`*w<dy
z)7O1xxTgoWzn(ihA9*g1$byx^vWZ{HHD~(H(rN4P?)w2&roV$fy+7m2I;>jkb6jlP
zXSji(6F8|1+sqTp=Zu348pdw@^<BOe%eur&%EmTxt8DzA+jLgxCg@bK-E;kOU+2pG
z9LU|vO&=&8SRM%KKTnuv%}Zb$_&M+~sV?C{IYB9;Cc#+N)VeFmtf#uaTFu;f;`nQ9
z&4<i!sG{dZ7N%ULVfJ6_OU}4(3q#8W(34G)O=|^IbIoh_TxR<m@>7e{bJcU^NnOVl
z1~iOX7g}^-w0*naMgq1$toUPiN=VO;YLJle?eV|k2jk)5X@*r}B{JAtbytB~*&5i_
z-kIAsa)_BKZ02Xm4rFO?%(9)NyiF|&%?(4s;WD&a+5AXzP6HK>NK>b_RjR9wSzlZ4
zVQ=dgT|eG%R<By0*Z8qvQO|@iD<L>>gA<P6p1_tf%*pN4?xg=>?%*mu-sfZOq*U2H
z{e&)zZf%(JuKD`F*~0Gp*7rlvv+32JTc+E6XC>$EtA_hs7qjaZA^Ls2I(s@_PaTir
zFA0x5htBnebkgCzL3u-qLC-+fK&?PeKI4XCK<I@lMBGMjKuiO<5&NQ`VpMXjl63`q
zUm3Hyem~D|=vV7s;P=D71i=;E0+R;bk{~z?5x+@i_bXf<oU8ypNx-T=X+SffK0Y()
zwiOdSJ7puowQ+xbLL$AP?p8&#j$>y_@JYBTjw9;=nFh{cR7M&d_ZPAycO70GXC1@Q
z?rddI%xJ_Yzn)Nv>=@q|bBenasIC&6N#+H6x1LK}v|@6JWGj!%wvLoQVe$g$WhwRu
zF%e0L`NV5K+@6y4^E~U(!qICdvjvj{gcd?i(pKSL)Ne33#V@32r4I%V2bCg6qPLQj
zBd6c$Axy$+>ig-L_q(LyCw}E}B_gLclr9ysFtLah5s#rZNj2kio>@hz_*yS8$M(av
zw~)d;ims=Ylf?49hHeYXZG>g?jEH9>H`O6UKGh{1v-Y-^anetLpEJ3$lA26+%GxqZ
zmW+qk&Dhk8l7@rHS5_FN6YJC6yVcXww*4FELt9C>oQ_?bz0JGMt(a`DVlls_roU@#
zn96suI9k#4_AH?O5-TERL35~5ZvDDNroP;LWK+--)BWvQyv7?_%Az+nl?ip1?PXaW
z>L)wjqE1Qo#OLEIl!VmCR2+004vz8HlGgmz!as(n%eF>URNAf0eu!2~Ewd_^s!ys^
zX>7EWyiDq>!7z<4xvQkHoj((M=;iw0{~@?=p=_h9wX)5Ue_kjnR3Dee9Mz(+hRw;=
zz2<}c4~*qFZ))i}GBd6l+>^Q_^XId@weIsYGYbu117XupSIGgX@2TRZBPzz`L#0Pe
zGzUmi^GX{sb<W}YX_a5K%IpqK+zW0jc9CZnZ9X|?>}RaC74o0*=bVY$onE*2_xlfa
zu6Bmy4(G-hl&$lB#z(f~(Q(N>&L14f>3Y)@6pn~T%emnB-YxS&ud}C%I$C8vO^n^X
zgt@Wi&TeYU*3f$}g}sm6^)}_A0ldLA#Hy~PVN}2AP|-3_vp0ND+Dd5RXj;~~>QQi1
z*|oMFMvvcBda1$Y%=~LR(KN*rvrJg+pdRG8GBI$(%3*nAX}>twaJMbhmOA9Pu>hWX
z`?buvb=hmlXPd|DVe04Bg!8HPx9_#W72*5b>s%g3BnLh5rOSC^d9Q{f(#GvL90|AJ
zw;OKV=1xj6mod{_#qY;%tG06n`g}aE?#3tL$0pCjj!k}@Ewf%**0$O^&yEs~Km1bP
zZyGuf=h^g}I*PnH+Rf{b9^#h1dw*TIUbHv4ZmGSvkGP8TGN1vq^j03i=ar;1?5{Hi
zi2NRi;ian(1}W?NXiNcXgIMrkdiiq58(Is9v9^PYO^r)?TeMGKRhNzswu{1HiGp76
zroi$FhZ7X~7&2cq$SDRK;+0ceo2ppgT(SyUuiw7jPgf<9w}<4Zdw}vybCc59NoNBp
ziXeR@Q3FXy2uk1@4gv-e2jUrU1qr;lA#wk{7J_^O0sY7KP!JHGjUizEd`1fRe0)U!
z@5eF!_=Jw~hkylsLj~SW8Bl*c{W2s2`mbx~PT(E{pFF>)DDWw-Yoo7kVQXY*=MjX<
z4157^C8BH#0f9mK_=XgfBRK@-pEOobvQv_jVAr)Yr_t84)X}GLGPio12ZGay9k?{t
zx6>waGB>lZWq0Bt{^JRD;QH}vT4JI<9<ej!B36==A>y~R(I;Y|p`)QA=6*p$M8s*M
zXTUBeAoS;O;5RN}BRe}Qc3N6TM@Je*MjA^SLt1(^Ha1#123iINYTyZKTW1S9Z6|6A
zTkt<7`D-2leOp}{V=FsjOADgMd9`&c?d`aTi60mG`}Gex^_`6WxsrwLpKJjP(mvjy
zrKh2z{d;a;DCgt1>@vnq`ew=k#^!*`fHk<;SXem!c>cFL|6K83Mk@VtBqIYo!@myw
zms?MVez4WI;kPsg*0kgPr@sCi{I56v9LP!g$ojvC;vaJU<6A(`+%Gt3|5h4stDM3N
z&?BC)fV2Ye30T?V3vvbc@#Y_&z%|rbuX>xmAOr+2gs1?Yf)nI!Dy$pckF&0HYUTZ}
z7w>6v(TI58zef-yszz}+_)3bxp0GeqjV=%U8Xi)P$QJ`u<lfgn7kBp8Lh>B-tjW3O
zLa#JINok2))VbZ_-704l@M2tSkWZ*PU@iOc+z}2Ih6n-@ju!$7<rBpJ?2@<Y^)OVM
zNL8ZvbEyB_Ob{?oP;f$*#Qz&=9+~hm5Q1nEVN90shyLFZgc5Ry|34MX-|`#?f$)wr
zVEOVA_J1zre@sS%wZ!qiR2KwH5;i0Zc);vEHq!r0;eYdmVr13U?T?6?@$xq@8`Z+7
zR2z+$b#;DA@`tF6$z2+hfBl5=3~M+oabvu}hI{l~a09o`DdAJ`M1hRVW<|a}15=Gg
zOOmerW};q{P@!L^KD#!<Yl#P5+zxX*HDn_ds43Z`I8R+p{8<rQnRV=^Q$+N^R2mZo
zQekN?rS)mzUn4!`L{gF{Iruu40AXk-1mL6poh-srDv2TjfI9*THf1kwMD_=;x%~er
zp+9WL%LygF%$!8GO(f=rYfR(OHxb(3oo@OyivAaZ918~*;kTipMDjNxxo0?42b{kz
zH>?DcIVGGqW?p=MlClb1b7qc7-V2oe?lv~zyy&jNF^xjRC0ZoWg3gufJ-vHN*-wQ4
z;kEvrXgZTqxq)Y2V*B!}rz@G4-BqM;r=awQ>)0vMZw#Y^@-n!JRN9zw&D$3V&)C5*
zR9KP}MHe@334M=#s%8i%M1G>gP_S~tVz9)v(p`*qqyoaxVa;I!H<4^2*SqK)5B1~U
zNy;UOu&BUqA>f{DA*ZaO&uKKU7g>=eilruTqjoFJ5?3(DlCmGzj(GoD=vsbHlv)CI
z<8muq5m7K$5r2G&h1*NvJXm0|U4QB15N=c*d2$2qH@1cqU`D5D+9$tn%p3^lv!p3Z
z7E2BLt4dfNB2cAg*T=1RYtkxf%$}A_Gm8AqWrGA!^X2(a^qPJ1J+tR+PwyT3>WVl~
z;@)>!>9|SRt4Y+<F2~i=m%l9=f$dek_nl{mgwP|%Q~DBTBUGBmY_^=hx9{#m&-v?Q
ztATms?_Am>@=nDqrIYvVINh1vUq;7H=C5E()xdz^gS=gDZTddTmn0PSd)BX&w4_G=
zJ{%Cz^fJ4e#m16CS7ad-r&JLx%?9TJ4C*w?ZKZ(o+bRX&1S&#;ubQ-Op|(%m>JzU#
zNJM|~u#B`<H8F?XU(eao%>%zR#cc&u#GvS~kJ_@}eE4{2tToPvM3HBNx%YQ-mlP#R
zEFu15{hKskeHLK-x)TfwkUBpdDm&u#m42Lbtbds?SP^3o7Wo(9?<9nw9AeJIm098t
zG}d4Ow5P$iC4W8}rmb?zWRgv+)m{snsbY}(eH;zS;T|3^IayP#ZjI@EJzDJ5WDhH+
zS2_OoG^4e|>?QUY|5(4132utt!XptT++}UB)xuy_?vnNF-I5KL^jj>^YKTdOx6(1v
z4g>63lY1%XzbhC4=Jr|b+8xt}h1OhM#Ppk$I#UnqD<@PDy_Lg0sxsqugxr%L|DEal
zlG6XAD;uv*mMi7W>Ha56w)k0^>yHz#0~2(DBf2fL^*xd(4>W(Kk#kr!%N~*Z&hQ=l
zB@03yxmZm<Epoc4^zF`4+H{STvsJpP-bZ1qqsnpnl74CC1JCM8&;5-%)40hoq>?_!
zr-2Y9fYIx)eP)muaifGPW&84$f#X7cU{-r?hRv80-ggh@zF}IpdLvFchOE&--veiG
zhwXQ4K@<k#*5nUJB4zSKfDk`9R&_y|x$JYzNBhp!P|<I7ep9vpE$+zy6DLF8ogW(4
zm}|bz)Y$$9EzZIDn!j=&sI{GP&Q$1Hjh}5uH(5X`N#4u{X_GYP*V^)oyJbrETsVk~
zc|^z6+*wIPbEkjie-bQs?@<pi_j-=Sx-fR*a4HTPVxv2QKTS&%e{`^@MWe23&e@qP
zL+%}PF%O%^NIvZWUw7rw+QB^4@NqCN!%d)OsX)JhPJ!%;bX7Lv@2GUD0bD-@@5aoC
zmrl#SBUR1n#I_uD;#O=Ur+Ph25Vx;~EA{(uh(U`qI<?_eCU(VhgVZG$AyYc@G*b=f
z*TIgq7Q+k!WjAeu4yI;uFyM;B7wk{a7SRFRrpmNt_l>hBUzwKKh(&>BoZ~MWqi+U`
z6*RLA)6&&*$J!i0ap@<WoK4Iu6yA|j63_6TkP_htV^?Cv60PTe-c)Mk#vzt@(hNNX
z13kfZg8ZoO8^WqcBbN@4@MT>WS-2Jni#(t36X#wfg{<-<sS1CCUKOlllF`1wr(Q>g
ztaylvR)kA6b=IL-uezZ5%``DBey`Q^?5lMT5msQI#4z#`!@UyD$jl^G%GiNgz&MJV
zSzeHim2p}k;2z=$IwGjB6t8GbH__k;+<l|sv7m|3Vetu0NQafw4({J|!@GbYqZ%|V
z)m~u9U(xIhKP%O~;S60C_}s(+#kD!r6z86#G91r-OxD4)_))A$NbFBABT*Tgf})~<
z8KEqlwyMY_ClF<~fGCR_Y(o93W=^xibb&h-)}7oT+DnVXLH_;cr_w<58XX<g0+k^l
zwM6@@*+-T-b1_*4JBXKX=6~a<AkjKU+e=wvM)d4=$Xtt?JZ)#i?6Oe%Z@j?G%JuuB
zN)0$H&&t1yQm?Wd^(WOjM{y5Y`|beZxG*P<<5^G8#i{kNH^Xle!Edw1eHz2Yl6jq-
zov8`YszMW}JEYINTDUrfR1H<?e>4y{5M;Yp=*LYyYg#v7+RrQ0i{w8q91+5kLJ8^6
z#@K}Z_qn`oNy-fdl5o5uy}i9vf?Yg8k8H&zr4LC59pTqZOBR1N;Hj`#3<GE#^VeaC
z6<^RW0jx%l4mG(T1N<c8ABTOK26)RHL^+qm6(!z)^IM&jzI9uGH1mc`#up$ocb42+
znHBCQSkCJra5Y0aWxoT1Lb4475TDo$iV+sn&O}L3?dJsbj!}Vg(4L<q^3ln}cNOnQ
zfnX=<6U^flTc7na`NN;?#RF5>fT$T?J#}f`1&~sMO-{a#4;!133Br|t6jGxVGVQ|m
z4QE(}Txgb?K!>5@q-(-O$o69c`H|CO$B!KrcK=OlN;M`Q#5jVc<)}UYHuS<Frt_vT
zflDCW$a#?_(|K`7;G{)eU`YDil5gjZl`r{gtU!q1!YA?}iueFUN=oXb)!`;V#jJ@|
z<>xEkil%)dBIFISH93@5@4iXTOm|=Ol%hHY=%7cmgL>i#8mLOOX38~M0+@%j0d-?3
zxKuSin%j>t4?MVO`8w@}*Wtd*GaAD672S2D5ckI|a|k4Gt;G`-hs|#S`nM3<M0ukB
z=GWzJSH~u*K{MiRu0d>qzI$&BSmE=Wp-bRlacV=2KK2XgIDo|6n*wIU`dMs_d&pUr
z;G%eN+C*$v)Skp02rqxqUzSoP_oQ)2>K$@5pGhhMl@iaGzG!u5cFaO8;Nji=Xrf+z
zOG%l%7s*r2q8m+&6*!<U40@t{XW@+c`udrQFXiRs>}3cS3c=3L)@T>*+!pvkjy{cR
z=m<}Rq1NUk+>xYc+?CZ#2>kb8nos?s?n{DJM_pFFI%%Q2z=D@qHY9mv=w{Y<UWXYt
zsgR2#GCeRZ-C@Q!bZpiroR1DQ6tm_jE+le=K{b~$VTmdSRD34Win>_WF$6m~52YTS
zQF))`{IG%`*dFZkDrl2f<0ldiPkCc#y&fQMeX`9b>C@{LTyC}0&WoiJh7{+Id8|$T
z*$(0A7K}XvN~ZoHJ&?9ME9aI6w-}bWHtC^;(bNXm(R|GC>!%Xp=QXD=;W;vYlk{;`
zREa6`JX#`^`1rXN7#T=a*Gg4^N`<wcfzR#|V+1<fWJzhx>xrRrJN*QowMZDH#=M`V
zu3a=Z%Y1EzsB-rXH}Tssmn{8zS#Wy*^=35nvN`<$$2%hpp49NW$VH3)ZkP!ijuti1
zJ_oxIy(6!q{oFL#L#8tZJTm7in=QrR5ro_f;i|HXTvo_;bXgccK$uQOWrz89fI?&m
z*PqN<=1(msNW6}&?G2I~_lPorMuL9j5L9k6x{G>fPCQd-i96CfE!<C|^Bz<asC1uV
zJJ@59S2+g6Fe<NX>?e{!2>=lN7k^7!`kR0m!OSV4s24(ZM+6!jriraitmL1Mk8QRb
z+NFt+^S@Z~(v1%L8vlm^Hi6kx@z>aJ;fErXL8Qijx^U`cYUVtDtE64F7*=jb+kj#6
zWJcfgT$_MHbBa1QMca?zorI!$<iuD71HPzFDKf%?sxllZt^Ja~CAdf4qU*~haOr?v
z^Cbaa&~<wQH*e$W3cV`)(s*h}U`UcqhXusL^>BNl3y<6;LY3zy#rN;<ryBvP_KOf%
zEohND)2g3LrvTD)31bs?x5Lq5xS4w09<t0?y?#~-xi;WqMSzD(np*-hS~7Z@h*_?8
z*pp(jn*-`+o;0TFH`T&F5?$+!56zT0eOb8~q^0o!B;b1kp!ZD)-Eo;L=yxQx0Wusx
zGaoGOGKn0r1n5wkD8BGNiFe2T-$Jk%M`z^R+5)C!`yEiFPM)iwA&%{WwPyp;l7Sd;
zLVF}%6Ru`AA}Bd_GZrpL7nOwk@u~Y|EWvI1<E-oI7`xv|jJ^<ZBZpOQPS)y3!DSkk
zK9EPYtdE?m(1!ur!*rQHp@2xn5=uT-0v_Y2@l%~(b51QsE;~ztkw7X=JK>%$8^>4^
zKT`xV)H=!+#A_*#3I9<lal3b9IrUl?y`b`rd@as<x+v<X>L+jl0!kKMB9*-+j`|17
z;vqg*f+>>)4J~xDs^4G7cx*$S#}=x`3~YdTbSKf@)zLw`uA8})6R(kU#gAJ-<{c^I
zJCOARVen==_ex|moH(Wj?DRT5Aw1BMP*yd-y}F{@oTNaDBr@6uUZ@=jNnc-o^dKb5
z#Eu1t98PGN4&fB?Nrv!1y<AVW%+AlxkIV825|W^ki}!Q$7!8@sk7g50VD!x;!=TR#
z5U7o5>Z%Ey{HA94-}1uYUfm*Db&hW;aerFoATpd#()vzhKg%+LP<t)tjP>XTaZ>B;
zabL0lgmGGs76~E|&2PZm2b92Ku7b#eHk&ZEDDnMKB=i-)8JU7eN2!;%#a)d~b<zyv
zpUZuG(u%b7zA5w68R-1ioS?Pb5m=LgXZPAN*jfGCEcy5#@{2*u?hX8IETngd@&d%F
zVwv-d193J7lY6?X?EfvmNF*^)e4+jU1763{c8JlF0!_){+`o<PWyzdWpwhuLxdh^7
zk!RqH(5dZO>_-+i!<|DIz_dPfQa?4Vh*y7@)~(nrq8Qq=(Ac7YIg$2FfPH&icy<UK
z5a4T1d|D$|H=c{brk)^}^89zS-g1AvV?qw=`P$MOwAk~y_dWLkZ>QC_b@Zh?6aEof
zTmSBkIGcx#unJs!0Pst~<39=D5v(v|5(yE*kB(WBH`R%olmwVK;ca;PF+PwLH2%yA
z1G8Oj5^gslQ$qm$V7ePG^BC{u8rrpn6Jl5qpne*ry15~Fpo*@Ne4l|^%(Dl*Bi{h{
z>Bh&yKgCh)Tv%-g0~9ibMpXBk(o^9>a9L@rY=)mTQ!n4afyuA}8zahWKiAWn!t_(L
zOS^xDvkjvA3@14b-;M`hl;dBlsZ|qsX3V}?B&sCFzqMC0QL%VD-1Jm~Xff!&1mwu3
zOW*awCrAn$&{YKFwzvzh{**}$$Th&M7&8NZ)O5FBM>g+Bf)m04v4lSn6NDEI3>8$-
zfvHZi@!0qfiMDT~f;UL@+vij~|1?jx(810nm^KkS1268Ufl(Stw<}C?dsRzT$jne;
z_7!7vD&cXoL9>v#6e#Z60o^u)E)PzV3IHXXr{?iai2Y~J+eCJAeUY99Yg{N<mPMK5
zpcnk8({d;wOt&99fqYFeu+vo+uC)50D%=+c8A8W9nh%Xj9IBtmiLeTwnJj+8S;Z&`
z@2qv+YohV=2F&o^4v3Cp=n(GsS`roj<)-(7X7|prI_6nzfb`lb-L5xU@!fxi$XJX9
z66FDw^Nscqg(4lqp_d5Go}l#Z9=^6KgsWy~?C+2_Ea-b_2PoQ)Y|6mG)#PmsCa%BK
zZZZl>nPYay0$M%)IrIa{AT<!C#|_Fc5bx1DLEL?V_z+7!8^A4k(vmL9FdHx}NJULe
z9cx<lwf6soSvu|a@7qM2bmdN%WjO)>1*RVEfkmHzfm|$2+!nybs?<2`N3L>HAqooV
zFreIodx~<wbS|fxI8sRKzcPX^^&VN&)IHkAxWqepttACoN6{{@6z=JWJ3frDIKm$5
zOasc<{|viW7Z0C-3(P1?_$$I^WOlR4-IB!?zL~CiC7BBl?#v1@m9c<;OhAUy!$S6<
zt=oQ5ee(a&$Gpl~?;HKKI(EU0iT>9~QwBK7uR^B65|YSfUddw~QQ}PBW=2=?EW6YO
zXl18CG~oYxxQBq*miX02+giM~s)cZ+=MAzqIurz-TjAk{2yn{%;b-FV@Iqq_nGUb2
zvNo^4@=aa3yc)D9Ax?DNPaBH7S*Rk_SN=eW(;kq!j^d@2Et{9u`MsYd(@(o8z>*LE
zac2B-;(*_O>xKV!2?IEew=<lO5KhQU9&t8i>{h~UHeg1C;fS%|m9_xpL1V@R=FyhJ
z4+X=|)HK{|4)TDr|Hncb@>NK_ybtyAKpWrB@@OA6cD>4oA>2>&1o=Sr;`hx7G^3zI
ztq5o1H!7@+5zadcn12JP{67{p8Qzf+<`iTYN309wh^$ltxK@&MGK(yk;ghyNQ=?D^
z1Q-)QBtKORB6Df${WaO9`?WBtHVGHl<ca@(;{A?7*9P#jtD6aoq9=?NLJOICPtYdv
zU4p&jH!)hEUM>gIngj^SQLmcQ0}U3|^%=(?AY8Et<%50Mg%ad_0|onEw|5XH5o7g)
zUggF=O)bOkU~Y{{Y9T+f36RVP{uBV4NLPfP1E}r$P&@#C^AgnoQ~_Y98PPF}WzVt6
zRexLyqszgGC3rZYZHQ3Sr|5#{Elg)9?#I4Kz|OP*EGBe|$Xtxp;+`!960!r8g&~n)
zjM&0}{o{Y{dlF@OM;?|YxTG1q1~{o}p>L7*UEj+ZL}}3yNPT^(s{>jD(oSqw?nTJ_
zx4{1r3wSe)O0<C*Q)X9J3IqTUVL0(eB=~ZyE_8F{Yz{Lx-@Sv|1i1p)JCZDciU9uK
z%K``}HbGt>3zY?4CnUHFJOi6xj*RUR$0c!*q-_7%p~8ZvU9D?gjhSjQyID$@ItzRn
zc0ciYpj_Ub4Ed-Nnh8q);DMNXq%@&1f6~vj5eVcy8qLC69D)f-9e7|l0A|&q!+?*{
z3|(NKk`XEnY)P&hmk#{|th-j%0q}HS5P)o0#$;{+%%#M9Bd`0RE`BozTM{~l-6<82
z(AcDaAn~@Tw-yQ04xG??-gkaaD={JPC#~!e8P;nbpbQ+CC0F+aN~KWl51c4Z9p5J4
zlaT3nD65=#i}r{h)0yM&nB+Uuy^KWu??VNp*R`O%`m|&vK;e`)d~{LrKgA56;%cJj
zFeo7cDFD0ydCC43SSp3S!GIfo`W$R#aB!n&lb9wXXTM&g0IU{3P8>%508-Wgagn!+
zL`x7N|HelGDlZ-C&p^>(YQW>-2WWIMK~>>ISfUW&#7}|7C*Bvpj<MV~Q9JlH5n{@i
zCpq&IuPzEunPJ5wuVepVdn*SSfm+$d>;8Ga33?w`HHyP_V^*ko(!~NWO>RKcj_WaL
zzdgwbM}itM)tQ}SGB)1c-oD*k<N>3I&zA{TOg*RL?xRut>?_T}-4C}+07j|PGi$1-
zP^xO!1hJqMLAQw%=lTpj2@&0I0UnYL?2-`$<sVi!1c<PVTTX_$pE_cOHXLvVs}ymh
z5b)#kGqpY9bJ0~pISmb(b<<3sQg2=I$HmEXJ+n9oWnIX3#ASN2-wG6e`3S()FQ@?M
z48VnKKaCtfF#{)5>CfPRcqIjT>}7F1?WRJ&*u(%^*>j2S0L^?AdX$&2^lzrI@P}y-
z{x{PA{9r<+vlOrg;MBlw?&se<F6<9gp#7l=I3XLu{mtLDVmgumIs#67v`C2Q3V*|q
z6M&?8aC)bhS2+Y9)A8wVT@aLRS%6s^!)3r5&w-BAem_3fZ-(fE1{k8X2Vm$hLiSHh
zuNwytr7}NulRw~Xj}-&K)0PAfd&B@{_a#yQeQAKPdQuy*@}3GE#S)-{co2wQ0pId}
z+kI9BT$;r6jqYT`0s3Qq`6vI={xUC-Fg(C)YT$`Ec*Yb4+`#B~`dcJkmIUbNxB@y<
zAguA<^koX@OAk?h7w0&Y__3mMdD`iNgj;<BFx$Xr-C{1_8v5uKVZXaYGeAe+J05@=
zs4VuUDPAuW&{y%75Ow|*d6>sS1o>$p0^x;63NY(PHdq&GR0axJ9h@7He=76<)<^r@
zfNc{I&{FvPGyoQZ02gMCsW9z!3<5OQwDnt8fhZyiV0Lw|;|hpz%#W7L;qu~Xs6HYC
z=vcl5xcR?M^8Z06*=c+sM36Yc73bq|9B^N;i<$act+y`y=r3$S|JPss|LQO0o%tHd
z6mMHDIi2LR>nuh+PN;EK3OJzwB*iNSwI&|dom3$2y<_hGGIrvt3u#H;v%f<XiXRZ_
z-c;KZmHrX4>(*&7U7L&q6GPH#7&fmJ@7P5i_RVdqu}-m}P>h6NS`u4T)-lQugihy6
zn#7Y8sgp)Fv0nTYKP5#0OOziCKQ{w1t|PGL(HTB70;f>ANc3>+B5EZ+L?g)Hrj=)e
zD1-Y*S{%Gq)c}J`lFy%^G2=N9FPW{fc>oxfFmfG*s(d|kkz+HEB>76EHfBNiPAyyT
zd&`{a(bY!fY7NixA#+&;5`IgZiUMS|l(*{Tym1d3x{<v>+p_3(yChslSJr22iJahH
z9kM?TTEMYyKaOEJUHBkJwhyM7##mPdehV7nj<x@pXHI!&`^<0uU~I%gRPp#E9iP;c
z+!MF@!<gr%m-W9gi>t-|W&f{D<m3+N@)2?*9dO=&lUwoy7VuT6)?VQj2D@^=`ej}0
zeso`uNo>+cCtfjBETR5<YD^9eo6r41FrL3RNT~s~3|Ch3F}?^ZS)KZN!)n6gq~r#N
zUPcw$>eeDM5%)pSvCw@7itP**x@f3pj3h%!-t$_og-SzN@ua=8szqJ3FVgi?(y4^o
zZ-eV7wpc?|AC~L5>259H;Iu&6b`Ih11W^d2xB?;2O$d<C2LWZ=#f&%k6iq1h?xYXK
zf54rDn$Z&9(6AZg<M*y!Ko%MK_E{6NFW=GdIkQR~WkeqB6oug4T!Vs~3PstSWlOPI
zRnL$>Vw&|gEec8_rNz{_FEN^2<M#K250+_E${#dze|7Esly0<tQz+ZnLk9JLr%8pj
zUc8|2Yfa@<ZA8_)CFQKJZOybnGTPo>z*mO#5l-0f(?wxT-D0N4*PxM)HNM*{G{u>V
z{MztB$Y8<!vjUB#Mzk@X*GpV$*8zq>pwk|8u^9X6p!K6^^L#j`3j0B=Yl+PZ0fl~+
zm0DG~Osr)A1M1W%s$^L2NVC!Gzq@^Iz*25F18)x=L6)(GZL%2?CO5O9V$7JE>}+8<
zZ(2k75<Ys;PG47WIyQOVd#U|r7W~m0Gz)CgOfn1o@M;geB#9Ln*%NOxo9!l5^wAYS
zPUC@s_qRRG+3$j0sP^U~R6QgEU37Fd%)h{JJ~?2}XE0L%bvLyjcdEyR_@Y2~;{mO_
zet&g@wC_$Izaf&PmGJpGB^LJ8I@6Weait2QOW%=d->}A>X{`M4Ej)?pM!NMct!c|9
zf&oHae4%`u+LLsw=;OgWnyG0)Ve`aFsj=XJaRb~~=(E4T60oWKC|6*U0c)z4wk3kp
z)0w}7W#4m0T_L1U{RSn3WIa}NYkBg4q^PU@SpdWM8!$~QCrU_++f68X>rs-~o3bq?
zGy}!4qPkO#ofIqU-NDJhB+_6F57`;yMLw6?)nS)2%lWy6%3oXLa~ExQopTjmGJ|CK
z;e^(?9*ScI5>sV8RqGG*`SJ!w8#Q@Y2k~>}4U+ZkG<8479gSa)GpF+3w#oy&OH(qZ
zzt43}69GsD7ky>g|Bq0VW*f7oakrkDc)V5jf%fq29J}-ea7^ItO}L9^+^ymAXa-0(
z2|%J{1|>0u3&|AvYah<N_0Vq|E#FS!f7P$-tDt!3+dx>G9|>NKxr6Ps_}(~Hq-p6^
z%X`1<plJU(BDKNhYw^dMB#ugIEai_ae5IcH-o@t*R)_>KtLelWGQ&-_xY%<=CA+Qe
z(pxK;4jpR=4NjqRM|nMR>w-L^Ez_1S+C<b0f;|4JkRm7mbtgudT)R9X&#aA|$)<;}
z#mfRaZn*1${Cqg>wSD(WkKW#1Z)sy=;|Oks8rPr5WPHeJoSB~9qqj8I7rr{q_vuyh
zYIRm8&3u&eYCAw{YJV|Ux<#E*x|O4^#IwkQzcKD-Rs(|21Y2@<XlweLx8f{<ilPD)
zv8v%bPBVwk!?mI}r)B#*uG%L@3)H`;d7diDT9(LaX5lR!ZR-_G8L?27<sWaDz_oRA
zSxQ72BbZ(rjBSQE%5AbZZ%q`$zTBRcI-ja6GULg}a;({^imwkfRxFuDuTXSdeMo&z
zH+pI-fc%$%2Rt5KX3_v^Pp)$ND#O0!E<$)pVl2_2x6wGk54VlQ*Nf!Nud$R5k1h2F
zF0B)_B0DcV^v5F6V=?acNhz>d6;*02sQE1<@VAHs8R2Oqo7M|6nqR|!f0ll26w8h|
z>?uG9zCMrT&P$>3OJ&a~o$~!SDUnKvAjE}z3M`E#1rz?)`BfqYK>Cr9YyF7-Xxuz@
zJ3$VAG~fp)mMgZnbXg7Xh)1OZgM{x_Qb<sM;~25Vp&KdRdu}wTqufwJI4|prkAK9>
zG<_!1Is1kEJ;$|cS7=(|H03%*IXhwCx+Xq3Y`T$Ka=iY+$NI<d?hT_)r5S<{cWR>=
z!Trt{&QP$;G5!XYb=&LjI(y~E-HUmB4=u`+a6*~=RQ7+lW&kumrFDW||Mjm~p;II-
z)(W8C2;@8LA+;jrakj+8(<V{AI#7t7;rTkXI{8Po5if!Pbvg!@&KC`ffv*_Y!lsJS
z@fw5|B??)T@#pbY7beMIhlXkqSF&MS;bzR?+5&3SF|D9oYoav?Y8&kKh6`!xSbMov
zHj1N~H11fOFn}n;H^~2&2D^y?dO+HM&X9{Mo`G`^FzVruS`pb5r>gQ!xwc|XQ~N7$
zu1K&bG;1a7nk_gIaH^^;I!`GfeS!_NL1s)Q!Uro-`LeVY<R_YL8WU0}MASh+dYh8q
z%9*eJ=pj^hzqpiH%~ifNj|qy7ykVt&p(?uL1#KFteK*4_SE1uqtXXFf-JLCnuw{F#
zToKHolWJ+y)?FFS6E&WGPwS-Cgzp%$e?w>#PWI1&_ly{59cf(ZxK|yZYwLh)LxA#W
zr=U-414otaI4*eMu&w?F-{QqwWisAZ!)DE>$!9j)@IpZ!<9Znh`yD{9Su9>PfTmdY
zNoxtH=fgs`)p9<+K%==nDkmbG^rUe!DK36P5&znKrYAtRu1AFxSB@?-Re|q^&7>t)
zh<p6G;3x;*X@owhex;7RUre0kOhKi&tXBx9DXj5|14rn}$gp>$@M7BQ#+?F!ygRE1
zGt8<~!IgL9r|^Gvw!HcuEB+99Jd?-5E__;0f=TBb=zduzl<Z!70klvRG}+x<mxAog
zaqVCX{)ktrd=5L_LA@TWB_O-gXfwTCi8Gc*{U-7_^c;0wK_F|&Zcl*(EKR79r7<UU
z8%kj#N_U(Te9Ue<xJ}f)Gj>JFS1mVBWSCHO<QvYc|EkhXzagf07X4MO-wET@xU6ai
z%}l`A*Due&S6Wrfaetq<X5xOdjYRODwz1_JbHjWrN*85R%ku7Z`>CqMOPZQ#o3|92
zbefbOOJgufQs7qBcZ29qxmvmP8z`}kx;Rf-nsRJ<P>si{;$JrJzIc!eZ4MGz=V2A=
z#iS{wbcBk2JvmQAovK7;A<T~;w9KM${nrjO@5yUG%UAvSP9%Rd!$f@}>1x((7pA-;
z*ZFC#L>_4gXius<vl-OQ@)7_3*)D22c#@5tKM|dczC9noLCQ|ttk>oP-7++%{p#j7
z__c4Tu6;d=gugTkBMDhub2zWpPfa!gyuQx#?sZwJW=W|@;i%A|##@j6eZDV=5RgFw
zW8Py#FWCTk?0ewHPK;F6X*HlI+3UC>`x8k(Bx!?p10UOxnsl2KE1eh58D<3G#=-j_
zC0k(ip|-W5@c18nVmX!<EH)RSvsdvZtMTlSLtLI|#I_h^h`p+>YGb+vr|IKxO_-{+
zvY%r~{pFvJDEYCr2U_ATT5v+6j6o{k#b@B)MJGu`^N@+*hvh!K@sGNCYpwU#TD$hW
z#-rLrC0WGg)z^U2(&r;Q90tXN6xfJS;4mpYPjPKg50V7-u>bWSWPk_|NCmXm6z2bI
z-A^F_yNWhO@4*hQ9&cbP3^}$12;p6AObJ33%u3HG-XF~BA5Thez;477wlwT=X4^hT
zPtFwsd@SUUbST8O$wYC_+oiwdZf#ioW-90DmYi3>W6KR@!gt(#Ho)QgE-@Jn{S6$@
z5KqZ|?#ARDx%++Kalwk_r8QAVrTO6{VUDw?w`us8DF-cr9~&;ok3zpCNqd8C)=hmA
zq{*n^rC1LZH7stOZ*M=LgiM+Jef&Hk_;H~WW*G367qe<xz-*h|czuQ360vIa{;c#2
zA_0}0QUZZUBhIT=at!uCG1O{Ae(H^4vu*s@<+cOy=T|gXiPk#<l^z2)#?z&#!AeWS
zp$dw<)wrb}-hM$p+o6S~X?};lM%J{T;2jxdNhYdnU12xp;Z$-UuYi>(gmpBV>U@DO
z*Wl)yn)R(Xm0NvcFpXl*-<-z$Imu$+PfvpwH(OB1=DUf3RBH2UWV_-NzCJ&rwZHy?
zC&L-&=#9E<OgaV)H@n~BGl4>w7OyNzfwe|^dGj+ES&JQ2u_ub$70D`!ZG0pWs^knB
z^0B|N*F;g@*hg64n+VnQJGON@OS_R4O)83fuJt>vpN*}sxqHsGw=~kW7zf0-z5v~o
zi_!TOJjvHsBL`#Ti&T+_qwmkHq`>BCByrbx02>vCkMS^AI274InqaOeb<Smu#epJA
zVdKKKPJFvE>czBs)!^t?-GN1Zq0sDtF+3PB`%qRMbv$WNpZ?{yFotsBS*EOYhQF%B
z0k1#0vVxCY*$G>;;LFF@2e_E5%Z%DHutft|x}-8jG5_;3v$v|}dqjfIrk(SO`dbn|
z5}VKCIM~)rAeUJmtJB#`?#S!i_P=VIJS;$Pur|HJuo;nGu_1;s1@-|u-)SJk#p?g4
zjWG5FJsfoWu;35X2j0Y(`g&u2Bj8o3lsYl8rp1nPA9jNQq^*mx1~{RXv?{S&nm3UH
zbBm$o*N!o9(^t`}S;WYHR#dz%|L7S~0A2_!P6}kiN&$@K!<1rL_4x8H=Nv%A>2VwF
zJ6T;m$M%iZ>F6r^0uv}hp=s*hY~A(HP(7?Z=>2HrK{vE6EF7)OdD(pW!dO{`=)~j3
zJ7zF}23JhnbYUN_O7(1;^ltE->I-(ed}nH(svN>*^0yBMt(7g=*@}A@B|+Kq6RP3|
z=?}yxIb*7H%P<%}EL%xQ(a2$lgTtEk$>u$rcuO`qD>Cfv-4bsOefTEX_bc*FZ>K?g
z9)n<Tj@iQ8H$IQ4631-E7{~S$wpM2a%8zBG^!=r<_{6CW(>X$kX$r+kuTRq5RVK<1
z+&|7c>PFmHRKF3sU3ULrnBIHr*`j%;UPz_90z>nP@8(%5`?!l#eMU`i_sGU2+V>yu
zLwV}9A7mEpy0dalESmb-dG0kP*uQjN*U%{BF=i+d?z<Kb?c0tPj5bQ2;#2MrV^Q39
z&5p}z`Oh)ES0P){cURL?#JDwolgc5?QtuXe-?XUGH&K!^u&%1t-#H^0XCO~kxqLD-
zpVEp6mx#($wil-=O3Nxd{qFRJ<KfCM$L%PSQtFG4Dtc{H`@+|p1JOK~$qg=6v6+UA
z3(nm`nSsKeY~g_Fg9^)=JpAGWOQ2sXW*#(Ds@`^{&k?TLJj4+#4hr6EId{m`^iurg
zjlj`Jpz$28Kc@mTo+YSs!a%h?z!9hV0hROXXfe9u1Na}uGY{*tqm`Zfs_d{n(VlcN
z4)`jzEAXwOkA*cZO=U-CPJt&y_W@mTRZ7i6hRWL3i!?XO+>qp!%0`vC!IIT=-P*Vx
z`#Jm2p2?I5adBeKg8FCn1L*b4XXic~y|FyA%|gz(<h@Jt^ubWC1uhBPBb%df``BQS
zfj`^cev2gwdmGP__EwX9!{(0K!*Z6uW|hGGdwA&DRsRpu)y8<T=kBwfT^crpH({IB
z^9N+T{eGr%8qn0M4Z)70Hw;Re1VCw(8xwC{NndTn9>gI%BQ^7C97DnFcu&rGjmOs1
zeX@~Fc4(kgghmGYtc?nrah}b}jH!>Bwjii_Wb~{`zDbd9G5UU`(fU^y*IN1f=qv{}
z)<>$L#-q)n<(#J8!kSo{MNRTPJaSG->ar_!^AAcycdpfO$#ag48Az4`SucdDr6(J&
z64%!A07%8@d@rREbDW^wtSEHvo<yZAtFcp;yQ@HD_iOO$>f!v)D$%QqP|PX{Ea&_0
z)5m^j^=4D=HkLLBtE73R9h3K$mf2H_s=A{O`eW9LdUG->&!JU;&PFQh4)F#)r@-mK
z-p>9(|4{3!^!aq-`3Yvpn`jQrhlxZ1mOHXydFYhO)j}}pgSqQU)w5#&QdWLhpOjER
z7ddp)Z{2fIV*Dpgf&efAB1DZ>(y2N48m=lh!3fxm1gcvjsHFO7;N;Dn<&o<>gEDZ=
z`)=`cX76k57G>8#v>RIcvp%u4mR3no7ti=GKMP$yqjq=q{U+VuHOus&_%qxGRm}(7
z2a7rbi?v;5<XihfH%7;r;<pIYFmvvA^Vdt0!e*~iXY-U#w)x+8Z462s1yy~dQo}jc
zwK}t-ephYD!FKcM^=O$YZjZl~z~tzGTaAd=9FB|XhOcKY@^jK^c;80sVEOrX{F7ep
zc)_kx3pATQi_-g}c|7G_d7a4_ri<yzSMi0o*{Tq|FSnKajJ&t{4*5K|@Ptw!ab;q6
zX~p;8BA%;m7lQ_A(1-b6^{1Y?@wlVf9=a*3hht;4^ltJp>)01{uQ`X?T4QrAmmyJP
z573-Tr<af5WLEf{Zf;0wi<;QPhpQT;CX=q8i=D4NTWE-f=-JEV*n>iDms(E>!K>W%
zZG*<Fr%E4NH1;3*6cYD4<O4lS_f#-@SuDN>h<mbAefY@O5+~Uv!ar?>hA6~J*>F)N
zuXi6cs=`87V(C!c=h@iM1Ps1D(VOlOB<I#|^$JXi#(kg@jbnFJxHS6Nm=p5OVwN}M
zRZH$}n)Ugr0L!bItu$HK8@o&Fl)tv?B9eftHRfibE=VVbAX?%Lr2OT&g_u~vho%WG
z#o<axTx^@~0}d*0sXcZq_wU0^VpaKqz29TAFSBqAykq|C^x(fho=zF;aZw4hS6oE*
zG*3>pWw;J2-!g_RXMn`kxzEcL8ky$5v`1=?r@S#u8P*+t;I>YC^^C!+V{gl%$bO#K
z?h;ewY?A_-wsn*?NZ;eWDobx~)zYU0(S9)$W1k~axF<WXayT&jbo12bE~m>2_Su!*
zL-D;!GnLEM50!Y1{WJ9~=glFL*rE)>E7yYw%1Lj&kLuBOErvW+n!ozf4?87Zq=F2m
z%pDEn<R$1v*D?ru#K@frNiE>(mRoq-rFq0>knnL@qK@Z02uobfZ5Geo%1zV+zvaG5
zr*dAY`BnY!BR&Vcuo#a^C9e6Nd|F1<mCtxjx$u#vG~zv$+5VvI7$AN#xUNFWwP^8;
zdI&7VRf8P0w}c;})(&pL1#~%`U-w-VhAVUr9fcmkUVe2J2<>ypBu>R<Ro5(<d(p^Y
zt!PL-`hxHzMN2;wjf|9Cp`76~P8Cf(^RK^E^rCv)StE_0H|zW-a_X>Jt{lq&lxC`t
z_NEH6VE`@)PZe?V&10)5s))GN!`Rz4pzJPc#$t2!tK_eKt&K$BWRT_A*^gzA>scg^
z2Pf_2y^3?DomN?`O_OV2>Q+U+AawnbW3)Fu(a-s;_Q+u5SqUL&_16a+pP#!o+|B(M
zaU`jR!@oaq;ehpVWo5^@T(j=G;V|O1z8@S9!^<)(j<{J&K()ItbUlv+y2kO9I~N=q
zaU+8TJZ^K2Gge#U4YgJ6XJryG*a#+`AJ3YO`u%#Ip{#!cc}V4MsH-!DMjF19R-MNT
zNpb9!abDiTu3T8O0`nnIDm843?G<5@<wuowdl16z&#6k?d)VZWKCE+SBvYXol=N?M
z+_bl@cQ<8WUe}QiTv)dr?S#!$N`;AdWKE-oq}+EWs1Rd5D9hGgUHF}BkDW}f>Mt$(
zZj{U|A{k0WGHhVcmw)8AU@fezN(h?JcxZKoKbU;~ijVN?{9peIfS8n>%0w#DRQ7>@
z%*2P`ul)u&0MbS!NvHgAY$N{h*hU?2SR(Lev3?nC0SuVdlT-Nq-uak0g58hDdLc}d
z<78CWc5RO~s&$B(%7|h}1AX4X>dJOS|L8agH(bNxa{c&lF*i@`#7Ou<v&RL+>_kvP
zk{!x^`<`bK6`G;pFT-UF*3V7$4{0>s>mO*{@R^+d=&lAtYP#QepB0rB@7{NcjbnR`
zHGN1HN~wI%V$*VpmC*#Zq_7|N{W=iO1#wGiEnTQj&Ro2+mbsLH{H`1xhJ*>b0edhb
zEHzi>*>2ic(e7#y9dnI$JwH3mc9q9r#wolv&vU6>LQz724!>AdTT>LapjNvzN$*Cn
z=By3_ZrNL}MXQVC<C-CL@9c_>dk5LRTiwcR&da({-!Y9)XX`L_jRz=#DQ19$v!%7M
z)xGS#3x3uNdd=$Dff{S#)~=a$W1={Nt485LJ<Hm|LUZog0*`cLncepU7~x7o(tI({
zUugU6v8zhV`B($xpoSQ&`ZP#$)2tz|Qm?Dlnvw(c&U2jrsl{n|_PwObA4%NGS=LmS
zcL#cRNlCQnZ{uhYdbcUDWRKb^kr#mfrj#V$e6(E1w~gB#N*l_|&Yw(OYZLj#A(qAc
zrne9tO>f%uA)<Hf1MR>ECWg~a)ls2_H$dOWVA0dkz60JGp~zv@>@AL0#?M21y@8bJ
zN`u>X6xPfB+uh(&LUVtlX#1bJ6QXp>2yfe~SPz3VMT_=p9QzO^O?ywaCN*~)7K<XF
zCWqR9BW(0{ojcHc;e$iJiptJtN&AbkZmvHRd7JXtp~j1oVU4`OJW;p9zA4>maAyS$
zI*GO1b-J^r4C}4v6uF67f3U-04HtBm=g={;vY)Z6lI$GOl%QKiR`irky}0>ecQr_0
z5#J6)k;pC>*K!jU)6|XMwv;yV&@P@`b3<V0GA2mJa1q#*W49hs2uDW&L-&s=ds>f<
zVslQJNzCt_X2!C%;ikl$+7$0+4b9mz`qVirS3EnbT>ktIw8`EebJHyj%Slw5n5{*&
zi}?Y6ExiRs>Apsa=%OxJVArXdfI)%XtnO<yK7)W*s+RuVsc~hmAa&(I!3U``N9(0@
zjad6dsi@x2)?jZM_3R9F*OBT2YjPM*+hTliaZKtcomZFjaNz4YHP3Vxpim{>t6k)4
z+`E7-68r1?05A08StAG;-O=nnn`q^a1!jj{B~At|;E6bEORqQTTWhN;uY0(fs^iYh
zU*we7(!8@+^q|nZ+`03-JWx~3Rjm6$j5@DhQ3{;LOd;5Fs8OqKmO%Zgr1*JfZ+<Wu
z_T|Bv1M3_Sp`;4NE{c+dY>oVK1os}p%vX7E-0k*NSrHg|(;|_h!3cr_af`&YUL8A+
zMr{wT{bT*mC{CnsE%p?JRc3y$RtKh{0`zQxC|MjFU=6ltTBo}+D*HV8H#q8S-`S}1
z`J4Bpt`3z81Th-XwtnJhXWRG`+j6MVD9P2h8Z$g!q*0=#y>kU*Cz)zs=h$mU>;7<i
z1$CvCdObh4{Y92Vq5I3l*@0}0wMZzR6Zv4Cu*Y_0@GeVn@W-TgI~@3z%%`kYb1l$%
zU2Um8^Bk=SjS}~p8riDZ(RN|N9;$I=!CI^Thpe}Nit78`hYdh5zyYO07!Z)|27?(I
zq;mjC=>`E|6qOEXY3T;(5)h=j8%F6K7-HyoFCWG4?_K}3X0ZmA-h0nJ`|No3v-jO>
zZ^vrfvrW?Jevv(%C}5?j>Qw!$^jZCM=gzYvlVY|yVX5>nRDiLN_wsF$3RBYxo_80v
zMM7qBlX-UgOr3{`*0-T^$Cf2;MLQ>Z_|<xA#Ejc~@}zqX0G{a00c<62^>cw|?Ttx6
zw&kXn(9)G<SY|ensDeXXSZGp-ia2Rqb#3wixMrar$GrpcatP+b<`aQ(Gx%xPK4c<7
zo=?;*aicwjSW&Hld1`<8e7d{8VOZ1E5g~?uWtz!DfdI$XIAJRWfMqIe{^R_40W|T-
z&i3?rz;P0q6Orw<+nE%RR6N_Fv!rogCn?1oiurVW?S!U*9@Dsh$mO07id)a>Xo5aY
z5$IzOqUI#pDV+0uMfH4ytqs$zkxgP#b<#n$^=p!=-HC-S2p)#K{@5vhLsuWw^G3VY
zF;WmRP9$<~i_WvI;@4E^0Sb;_zmt}665Oy*<h9;);Qxelup{5n;2XkpprZ|r?*!6<
zH)vWSZZ&$VE*76`jdK^jfi)|T6}f@L&8>rf<ULPy4u=?=ybhIjJmjm;{UXLTS*zTB
zGICmG5)*V`=~s9YfC_kTw4~b_2USpjzZU7}Zqo&7cq#erTi7WuD0m9#HbW$+<M(Uf
zO;}*>I4HB&NTCwE+DnOqR!Z^{s94xD&E{^}b03hRGjFxI<8?no@^Y^?sP*to&}ovA
ztCg+S+@07>Lfg_4J#DY~u_@P8GrAMc3DYvg(ye!j?|U7~%Ys&+ObxT84TxDl0m!?|
ztmJv?hiw#571N0=_!aH8Th`z@n>mJWAPbX(fKYUu?QjxyY7Qj#g57d)twixG6`?Cu
z>-yyO$H%jJBN;((Zr0y+mPKVOp(kIv`d&AJ>ovEY)QRXSRMIV4CQx1xy67)iLtL>L
znYhr1wA_ZzvYdpHR7ZOoqtEZUcu?CnK}OMId}R|t9K|P_sw<BSs&K)FGZkfKoo5J9
z%j{=U-q}f+Xs-4#rm{%)ezAqb!bUtrk?oq;ebG((x+u;h_Z6GbaLDai*XRrLlvrMs
z*5{1D%*U4Uy{?JZ9$9`2pBKP9VZrP<^t$pVGXy>Q{LPW*LD3mXj@kPF-4t1OvG{VW
z7A?-_QL+;qn`yGC`E2rsfj(Oy<*<C1#kc{H;1MHH@W*Lw0rSuvr|?(%(hQ_{2mws%
zifLiceIoxr+dQfzT0My_cP-ALHaymoBnOS=$1xbRMCraA9Iq(X7;}x0ymKE=DCOUy
z`_nU8NuQs7y7d8mu<<eMiGv=ouz1sN;<Kcgv%{lZC8Dv>X6!~!nXzCBU6<KWBz!QF
z85~P*(*f(qGNhk$GMjY^Qxj}@>4gnu5y$Aod_Qde#dRW3)Xota9XieEwmyhlf6F+*
zMJrX?81zIj!J#gJV<k8p9*a|lP|5Pct5wV4U96?xsSokE+MbaQz*+S85p-O5h*Ae=
zmX}0O`sGNiux-GHe>8YUT`p%QwB{KHVU-@uWJz`l7mSS_)8;g?k+=vWLm>hZ^as}O
z%&Ni#rM;^iR-pOWxxx+xXZsWDu>k^<brsg(%b941Qb@k*401d1d$EKE%i6a74MyRf
z)Y(Q2lBSLz#r>VW*aUu&-D$Z>xnzTE<~^F4nm0qe0o06}0@B{)s{N1bFrsH;&MT~?
zyn^+Z{og~w^#i?&U(~-ti_W)NzFKlONmo;Oxt|TbsbW_odPV;>1!CNxruLvgV$z+i
zsRPv4v?RT<8nL=#ke5H)!iDIaA$y!>Xp%ThduUswT0mV_M`d`h<dOChQ_no^gip=t
zS$z_K@8Vy3USXF9zPn}{zwWO#{?prlyw!Z<lgM~QTof9z6jM;*sYjnw(&r!-*4L-~
zyUoBl2~~G-_@xy!<X4uLAh&ds9(|T%*;uFGCWQP&JBrTgI>NV~2Eh2@uo*gam!d0f
z!e<7chF*$Q3X0zal6t|bLfsH<<RDhq4#x91mB(+~|9k32&5HOJbvFHuF%O3*r%jCg
zjFHR|X%b#wry{9$H%p|Y+N{&YwqsM6?+9>M>Sp6jXWIC>uLF>_>LJDJSi&rV>JZ6>
z8Pe-&<0d3j!mPPFdgB6(r{kMCAU*&OAr>lWe%K!>H$gL-u@Ij=UzfZKeq=55^@X7v
z>K1pKO{qO%L)9lOXTz&3J5yKSq+i5zarKv-_LC-m1B1Pk+GFpD-a6{eG;JJ`jU6Q|
z&In7d_2Ssk5=`YnW#>_VGB(&Mac9kkvEep<i1PJjY4a*s=eNH<-X^Gh{m>(a3T0@{
zB1S8-NL)x1D(-O_Fx~Zo+U7uI5uD%?ZbDFn)OwJrkXCuY_bNd2yf64y#6^fmKVD$N
z0{?FrS9x7EI<Pm!<{(RK?SegTRz_fB08^}yu=RnR&LPXs#x=dU5s_GDoK>Yva8()e
zxMWj<9{Ggt|A@eY5(8X>f|Gst=)H1;i`$yl$l&P8K__pNVMcn;(7@gfSk<*qxC?T-
z{f*7n389T*XT?*G2Q{nsHxtV|Yk#_-2-e2{7O5aItU6aGL-kzVW+P@g&&{rYJxtl`
zu;W(73`FrW{X&se$#b(=7teu(%4u6hFC|f-g*gF%CTR+i=yU{gb|xie({H;ta69s&
zd1*pAF7$~;QB+M>XhEnJ$p2~LME01nGVQQ!jZ8-Kmf$bq-SfV>ms5A8kvoe){s4&k
zxoKR_Ab(B%HbBQHor6@y3C%A*Jxgs41OCp)Hk~D)A4Njay?JZ<o;P|83*2SZK-5?`
z%jCV`brJ^<x%P3y4T8tE22x~V>l+gAJl3zs1}~KW{anZ6Y^yp|1jSc{A%Qj)`Zgl1
z{vrm#;GF9D6V1msgT&?TUe`Uwo_#PiSV>F_0qb(mc-?Z{8fWmciQ%65d4o~qIFl%U
zwWM8RcCq<I1k(HHZ(4}s!e`V8)WnDuRnHe10o?}hnAJP$PSg~z4KB9X%FNn5lgA?P
zvD%vO+ur9xAD=$@>g9DYKc#psry1MHprk4Ec5_~z&;W3FWCsO8x1of1mTyT<C`9)L
zxt`Gn=(Fo|d!@c+^PaUA58Qd?7WI9lf?1`8OJ~caapK7<`uicjxaXtuLadxgrrKxj
z9HjXW|CSmThX1k~UhHP>_CZnkI>#7LH@FuH$30jKG+bn<a$2spy`>;V2$_`O*D!b)
z6|m6n-WOncpi`wCcv=`zYoGnG&fGV}<-m?n4e2k6>Y>W8^3(YJ<R8E@a18)>d9RJ&
zSPlWr8sL4(Ch40^p|8q1vB3RrIdw0DT$NqI&@O|Led31p2ku_n_ZUbg?fjA*eW&HY
zqYiCg_8U1t%~QQXZ4yx}T>40KE7KEV_p|RwLq*u?n+{7(3;EdmQ;KR${&U6~)V-&E
z&~GzY22zbo8ppBX@ho=m-)HhO;npFA8|Nw{z2HdPf{R~0$uXU^gWEx6h9>Q)NlRTR
znUzFe3Yqgl*a8hrCf6MYJ2;3-=q7!IOxbU5*RVg&hj2DbLd3|%SiG=^;UA(Ew{$ww
z&5?$~M9jSpoBRW_`c4(1kD#Au!m4*G?O>l>3oNV7NADQif{P5{LCd)e&JI}^=_s~a
zOxEz>>B*7aoYMGHCCg?4YuhXTSkf+xml>tVWkw08TF-H>u?oMH*=TQH6RkbFD@dr+
zg%@agQU!8aDX8r6_ZkbZw0z?+&g4rSa(^0MK}NKEVncL)q909E>G59vONjHnKtqte
zr@99G_|tTk(|Mcg?ff*Mv(@|ggpF$0*aG?_g5OE*k+a_H6O(vFWB!K|#;!8ag=c81
zpv9>C%84*IV}2p5{;06Avnx#EcA)R9cPyOQRGg?udTD)B<qR#5pEhrOmYf-AQu-^C
z#I$!@9shZp<jSsypxuaSsjcN`C@84`b92pMC+w`7Y{>~o@Q|NYOlC9ksPyV;5mw{K
zt=Pe%@`&@<UP(?BaF?_I3E^>9{*bu&$-VJT9L6Jy$*hpOHNTh34|1>i7@oRbR{8PU
z1uN(Ow%n*O8PUK=dbt@nE0uC}?JO@!)^<IcP>Z1R1%FWuuiF5tl3|UnZ`U9x{NSbE
zJBmc2<6p^JrDJxUO)$jl`rD=si&FwcQf>N~H6CggMbLKZ(m=!3VvGSj$@|2E34p|;
zK_+M-;h|{8!GEAV{#{hrj6;V=lz+Y3dSgS?Hg+%!<{W&`_e_SsOU7e|y&m8nE}VLe
z#V(tRo|z6H{xV#IJNz&;i*XJBOCT=jY)~b+lT$^~i71$IX?b^N_VnZ6h_FDmziZ*0
zrGPzd#4aaMQ-^bv(}El(nFS%(<WJ?dIi?$mFn^acCVl=|B(C9O6;7Xv;tht4yo=<S
zg^wIwiPs*lhqL&Af?lRC1PN=LCJYx#QPga-Y^l(p+}3A2fx1Nz(SD||8M{7syk5<8
zL8kntO`c~B&Q%@m91v_SO=H{lY2ctbUAEkWOIC)XP$-?saH%Xa^Yl;FVN|EmmT3W4
zU;&IngnXPX;Y<#NMUK<%dy#$V*_R*l@6nQWIy>RGgr=0(hphTuQ!@B0O1`K7|3a_2
zqRu5<CF3Wt57bh?aLn6RF3JF8Lk`<*B{09mPigg9goJH({fm@bxy!3O=>%^{ggiL+
z$<4BCK7i=|WIDXJDyz}uMk3t$!7s@G*N6Z^No+a**U}V^D=(kIiG30g(8vsZJm`Mr
zF!P%~_RBB+xB;-G37Hk6CKec7gUf2HM^7x~y}c>#C*-M`<#*oODako6MYcAWSs`k_
zerQ4CbOKgSC@Xil5yO~tE%cJ)d&!@D-*(x3K?gKdti3<>3BMi-V+KliwOy%**}Twh
zuRcKlx+RNfNX6v?TK&0K*R3+Ysd^mj`5@})t=dAOfx@E6YA=}ZaLP>)>G<RQ(3amV
z`hwUT`}3&^?gfpN;6nV{E)RmSwrWo`-|p6wzt(;P6bl&!(~Z<M&c+fHXLgWZm4LhG
zPT9n~Y40}0T)d2_KSzJn?_W@g3Y|75Uj8P82d$-XFL$1^L6`5XNUZ>Qy(IYkYc&GQ
z#IF`w3fb-(zuy_m<!N$|z3E(%0Z;TehrfCP`}iehYr6ZhmEDe=LW*0T<FK9Mje@S*
z%<JO@IC^g!PCTFUogo%KCqSjU)6!msoTT*CBB^t=R9Fi=go$He%Go#y_tj%xKM`*G
z#39aDc<XMIw|R2X;jwpAxLTu-P0kV04lo)Q56dT)+9jfGPd5`Py`Ee-+0Rs$LEulW
z&_aOm8(&2Lg3b%-P9h^YNNd(}dYAe%8Ra0Rqge#7S;a^<;r1n02wT~Sp=VPPTa$Et
z^9@Gvj!gzcYkFH}sk$k5hMNePgPu{7Kjy}vfBi`(K;!LwbH<Pv-Nf#3B9fPHC`pqA
zdVC?4D(Fx7xv+zsj35pFp_ln*06bKwr1|`&s=ratFI+;n9VEu?2!b{&(1m1(#3ulz
z_Lg5A;tT77SwR#(1RFJS9Ou;-orwqCcN;8n=|$LnB07u`Zi+f@3pr2Lb&I{@&D)}A
zmB}cvZ@PoI_Y)TN*#Htu$lV*DYWvn*Wnj7gaFbCA8F!5A6pmo=2|uw{Vf+I3u8_u`
zEL4I9TUX7>rv)E9ue{Yy%04S%h9EX|g8W036aaZyqWt&b0M4=ZdQAZ2?Wuob9F9-8
zVE^m#20$<C6z3GToi|EMZOd+ojW`^yr&mdnhHy=(T8`P`Hc4j<Vo5a!DTpV0mk-pb
z$@xSw5_;cKOsusK+l41cjsHPDg`!Pw+7b|rXn7h4w(l|6vNx=>ploz1zRhc8d7DhD
zZCKA1ECFMeaEvD=Cn4<poHz0(hvPpOE(YJc)$Ki<Nn&_BD8yZn&7?&XoHLQHTGvdD
zh?O;WW?@6zmvlMcSjEA2OZ)~KT5T{>-5jWVNiD&+7a|6X-IotxO+WndhcZEAS3Zws
zOhj)*E7c%uDA1?9hp!MNCll5jt_iKHi2hnh)j{cMf;0ELyH3GH4$3cvs4n&GP}*iC
z8q*UkAdw$<;k1dy=}>a*)a!^SqS3o*4|*g9)DqXoMson>Cr;=`Mxgl=n{Iui&~N$H
z1u8FCk`#|ZQJECr$Iwi^%9##m{4^ad(ZvNYpC!T9M&vjNm)>*bi0t)EXE-i(m51w=
z=MNX1y4)Ab%&{{dvmeYPJD_grfRQ;2$r8V!kEFPr*pYV%l9KT&RN*MfhQSMU!!@O+
zZ7QQ17?UDohWXZeyjKCdubR_;glF+2!BVe#ksdHp!&Hpt6jQb$Ri`U>jHcY>!s7vi
zrY7-0>~!q4(m`W|rmG=UfELc+URi8sKrPaEx}!z@>-B7R^B+j!^~%N#VozfRK^;xA
zh|t4WU=MYJv?(-gSNBQ_8zV<=Tep<WEM2e(z;Qt8AGI8dND=pZQI+(<0(Y*p?gc`=
zN>_>G9?nrJ;v8BsR?(zrl`n)5Hc8K7fyIBCxVxxSAGQC?$R_e*5P5qM7x=c>W)eSi
z`tD}bAb{4M*E}NCE>Dv$dgH1$a3BY-tl1PUcX~srErw1H-mLQ?01Brq%FtzYZAQ(;
zBbS{`c{lrBODT)LC8p0SK&ZIbNAhE=*&AR}xh)qrh#g>qpWNpPuU|$=*m$l@rK)?;
zC~sU;-+{(d_wuv5B-pMhlk7GkJ76?T(rorz?A4fJRnz^ErDp`g0dDLr8|@6XRAjAL
zribNB{B^3(Q2Z9VKP3i%vW|+BS}xJewlt{+;ZXY*@o+_touIE!V?5}PGh_8kt4*H$
z$;Af~^C}r=-a@&b)GauLEBP3tNRV|mt1NfBO1gAw`azdnU&v#@L02HQF-mlu{GP9O
zIQ%O2^T?@A6cadGf_p09<CxUkm(01OjK90~XTUL?Hwd80-dYBxp;XiXLD|}2{dsfi
zfp}OQ09rfschuT7I{1V=C*z;5>{v+Jn*giuo4d~8Lc3yF!za<R^#PGiF*5Fg=6S#D
z4}53e=1&`CEN^24Yy*SUV4Oo~-=fRc$BT*kfS!!Z95*|Qy5pE3*MYA(<3F*Z^EJDB
zrt{Nwoln<Z4K3Aq`sHVc8634E<T_V5KHxt7X<Nr*b8i1h?|yKBn<AXYwpM)A!x*yr
z1+&SdEpj~lE3PvwnAIHv)84)CR6iG9l^U{Xr1`k(c-6T0^d^vP4!yHasJ1|mJ>NTg
z#yQkNG%Ov4#s*)2bt|oz1*q#X?{19FarDW~>D!N+R|#)PzrcgCmVOZS74=j`CGkf#
zRsTj4nVy{S9RzYl6l@8`oQ9&NBpy;{3UAtlj(MIm1Iv2k;$`s79%1n_Q*&i;9>;S#
z64@IS)>hY%07~m$t^d=85LGuz4a15z9uCspbYB}HXnWXQhU~waXS#0v3h}cRN;;TC
z>FJu=nKy7=#8=xgFt=qo{whiJHpE&Uz~V)ZH?sFW3<K>74E`R*<J=0ppe(slI`^Z3
z9=iP#n-w3!mat@1O~s2ZJe{ZW<;v_`D$ly78Z$Qx;^=vZt9#$gIAGR(^2G1SCo520
zA;R335e1K;Lyqaj0|{Wi{NgMU#gBk4c_Mg&5?rVUa--)E^q(pEeMnRl{a$Pe`h3TC
zx)Y;hD+L!r0g8sdCcG?f1J*$|r`(Mct6a^SjPjct2K1@rfnGT-(B4iylE0i)YgxHI
zRV0m5joja9N;0`q6$h<-VFR(`8Cv*wj?)?Dx*oS3qch$cnu`b_VV}$#J8;InJisey
zQ^^ObtA<P=4_g<C#<M$);#hpl^|#Wf?P4FT?*dGQSP3{cM~>6T-1*YZY#ByCZ1&9I
zZ~ymaByff$&v1ZNZ30$S(o241ms$VNmy)Jl82n6it+u~mjUw<R_|PYu5f0uklaD1X
zoaz3RkWaY;zN>^%;QX6OETlimE1I@QLCS>DU@}fbwSj>s&Vct%t~dE*s!9JM-obs%
z2b<e%@#eF0eRfOeEfO*CddZGbv1}(v3ZGSzG`}EZNe4(N(A(Tcfd-?NMzusG*7im*
z#E@;|q{1L3dDQarjjJu814`S3c$$jphe@=&c0kv%5MPMPb^!<JAW2NZffb|bvW5_e
z)yLq3uxVKww6*5SA<^t>j_L)Vzhrk^0JW7ks-iZb0u_4pVq~EWp%h`UCx?P^qJAK<
zI%8F1AgvEZBuuL29M8mWs>}r$X4rzD_%k(CiD$rIP*oqqo592{`@E_pa@Dil$rK!|
z-Ex^ury8gZZIO>0*<$_JO&vJ|W}SY<B)1fwxj39j-=Tf>$ypitmP@k|@)EE1#lNB?
z9uUFHTw}<B0JPe=oE4ybTUh(vK;bt-$@D!1CyHki==o|SK@<&gh9zIAvO)tUkpHbu
z-u1?=ZsJS5FlS}9&E#-9#mN509Fb`necKMtjOyB_jfuPEXoL+Y+(ccP*oU&zZQj>b
z#4;Tq`)@UMtPIC=zkufkc7^*(<(0~Vzr~B)1ETeK^>JWsl)-emSZ9?2Y#yljET;ua
zidj1m)fclLMgx|mhh3j#{LJ<FyR4$bG)JIOW<`SQadn}2?3g1ax5DdP-&^P4s2EMz
z$Km1W;wdLr0ItbpV}w~^o)s<7f)&oYa0gmzJ>%72GLNNwG)<BR0ng%}$2m`K)X7Zy
zd(dwCgnuf&cqZFWaC<{=^RS2NAmnF{Co-ZdQ*Q5ZbH_eK(hCpwxN>WRzVKF3T=nZ#
zKN>8>O>8QWu3rWQ=Bp7|z+fW`b)WN~{u9_ptTi6gStSeR>9T|Vy5M&BIoXdU&N(>(
z_60pcRBC&|JD9`x!p=e2l#aUQ{wqm8-mUn2pKzBcPnxye$QR(yQrppUCa_n(uqMFu
z(3u?=BET?rBiuy<k>4@bhrBR1^NYi;=JWtV(Sc?v%07kN2cE};xfsBLJ}4VJ>gNTp
z21pU6RimlMqaQA)J4aE*v>GhTKI1qu7VZ`y&qsKf(#BR+@)$%h5t4+FGj?l4cYdB@
z_i1sMrr*q}$S2uA-55_}&iS=m6GSAUPyg0FlsI{}<27@>76%nfGUx-h^Vj3)>^nXr
z6>+$@XR#<rQW*?`kjvuhT)js9QU=oF6el{579pZF<ye^ML4y-DMs_SpqvKt&%~B{)
z<!G9;6gw^y2)4D7J<QEGi*6|*^gWy{sVstB3OA+5+}j|Ms1Lzk-Y85rY%FeN7*xgA
z<&7Q0&0LMjc)ARj50k#UT&v3g6hX;gQj2wMi|;F^KA>r@i=Z`@8`s}?2`HX4Jra7|
zzN(BJ5kj}^12XV;1jtX9^f7u0*=9#XWdzW`wBaqFY{ss)FlNHG=#M;<>!8;=N|BK>
zX^L=ZYP%UHX~^dZjQr#5oLZSA4qhcv^!V0=T)!o<A2AFU{C4<aIBMo(y$aQvs2-mF
zTc->#jDrp2*&kfj*cbuY07cxyk!mIod|HK0ssI#(lG<9DtyO?>5(!XFbiG3EUhxD%
zq%LXTW0&OCJ#6rYqFU%}5jT8W9lk>r?Xy#adJwc$gmD+Z)I}+zX0XBC7keeFo_obj
zFHaL4D$A#>%cOrMd;fGPO-&Q!zydQwKJIEJNxpOR<rfo?)+mTkZ|O24g@~zA1Og~q
zp`l3|n?Toz%SJ|yfdrZTZ-zK|hY(>NWVQMe&B6#D+gX#HX!W!}@`po-0KC_d=KeY(
z>-tJ^ikaGEP2!WTj{O9?&-XGjT|#4`lBkFNHlRLg1PHpoGzvS82EGHJwLc!2cnaoe
zlGbv56?#WU69TSE`lc|J7_x=!1`v%e*uQ8})n{5u7!J!pQ(&cMYhl6RsKBo8{(rh{
zFd@v>1Hp~c2BAlaDJEK$QKxlJvYbq$IETtX&?n<|pH-#2$$Ai}h&7gWlhvbnrD~x&
zoAovXLg=qe7n#AROAiHfmGya)2M%+c9>%_K>)ovS40`t<TKue53tF$spmsdBlk7Nl
z@xf=Rl|^o;)I2YZiNNtj&2$9rq6%*>!<Er5eF|(1@gsf}BEVeI<O1fB9MAhMHDFYz
zg`KLMH(oy2?;;tnY68%q7#jSr$BEMXqGfe0e9iv4x4W1L)P*{bCF%k-JD(LO&KW2o
z4ZM51iA)aDDxN7jkpwfbzyvlBAxwi*jj(Sz(C;XPAFEQf_uPGS<+6l(l6?*7A7<uR
z0eDGCFXwt~Tf<InNoiV!o<}tkDFMB|Pq?jG4IOF8Yijb`wJhUGMS+3>y<(7QMt%^t
zV^<av*j$VsIu@-yCKTbUAuRo`j~1Z&`y1T&4?-jgUQJ?YJW~n8?E5LCg@fVjNp90@
zUg;K=Eig{HhYz{8pd<&)Y>Ibk-C~<G&z|)9^TYH}7j>oc=jgoKw{M$F_)iPKf+L)~
zv{IE7b%>=`U~UhqAkU-fC<?bXrD$SMHBLSk_v#KpgHOo>YY?t-1O5EEHf-mLLTsif
z`Pg93Z3Zy{5m8fE{py{&Z)w$PDOMVfz8AQFTy-8i>>NmdX5>?^)k0EMy%z_!-O4?u
zJU<{1`HckYkO1f5`ylADDC%=mZvx4FCbEV^dit3<$Ivi-v%1z*o3i?}ZC%p7*zTgd
zZN74QN<XcwzE16N=ONcdgJ*`3j6*$LSx*B-pP55{)4PhzbZ2y2_L(34<hEJ!At8iJ
z`(#(D^sKNE`#@yt)N9S5BaCQHj`r%*-n$&s^Aly$H3p<pz0&{!rP?REASM!LDCzkN
ziIa<e*DbNSaNmJrcHML0&UW=}Xx9^gjyQHp-wR@o+SqEe)SH0Qb;iA={uH%Bp$(!}
zlBYYn9~o-tBauRko)VT%y^hWIE`TVJiHEoV&-Lfq?RgmYb~c92&5t%|Db~*}xm>rw
zaFH6_ED(wOig&m9c}@nw<eMh_IVp!7>G3RmjG<nM=&5(KDm+WsYTMhmG&rF|W$FQ6
zp`qj{y!KQqs*Z^p@`-J!bI;AuD5uB96Mf+x_;$&4d2}J-Cx7IuuL~YZ`J&`_WF@Tj
z+pDxg6EJtT1wmL$VAsJ=rg6CF+qNC17X_NIAnr7Hc669xKO6iE`nVrPRjxbU!FjO$
zK;VkNc^@FWM2Hw*{b@V6>^OiQY*}zO`B$C}wlJU;CCt<$=6gQ)cA%@a^u6@Q<pC=v
zTojZH_$Ik7pAboE2{%TI;U{GkzxE*vjz7C2^9DzxI8n#tODf+>^$uOrqC;)&<V^>w
zE>~cBW5+SYUBu2cWp<mJo0M_X<`Ux2u^0_mMv{ty!7?{#_k_t|Iy@-#iON`Aqxmh7
zXI%jnSj>kzO4;nOei&gs!QK(ySLiG`n->A{>0?KYjZ9t^K*weUdteVM2?QEO5jrdE
zKa^<u-Sym{uMNE~!s9ax<KLi*r6RXUH>l?VlJv&6zpb>tIm7PTm}e0EvT*+0CJ3mL
z`(F1aR99mX!50zlQcoHoSL8@qLE9>0|6iW_A`5^&fXso3Umk|JKu(Sh?3Zxrn=97f
zTa>&b7Ag!C-YS(l@l_r1uQzNt@Cqe*9+i8)nF@w4__FqV=iQ@}^_0MeEGA>KioCyx
z!<v+(nmU>#zSA)ngiMZv?m4gS&(>$Qhr#35cSGR4Ax={+jrb?pBgKtDq7Duj;yvHd
z?74ciYB~USKecKm9yMpdZW&aa!)8-8p>mS!3hk;j4I=5Dk%D&lqDsH&KWOUkiG{OR
zwS`%IUgfL-!uU9DZDR2~=O1OJ3H;oPz6q**?_o2)(jw#=d-3d^u-xDpd?!~dO`*`X
zeK4#C0{RnI4NA|DcGxhxzb$HTQj5J-I}A+Y905;yohg+e%?^0a=4~;PfrpI`f^J84
zB3W$ObN-?HNta#rJhc;uRT0SRIdLGAm2lBsGX(0d;=g`ZWp!o)9G2wFKD1lX_rm>6
zHHqJK^}j*^tnZf9bKG8<5={vq$FPQY1$R~$>~U-;In9}Gxe*K-9M&NA;sV_}wC<`S
zOfmMpZoluS)w@g4Y&Wg(!?Gbs)2}gq&|P*<+wTuJIHH}?@Mpc0KT&#^%)k64r6)b^
zO4<%dPvq&zEA4omYA^D8Pmd&66x~0Gy3h>rd1bRix2?BAhcs~nD!p_B!cG3ve*l76
zuE=T2(N3UJ#4#jjzcS~DLf;x8m&@}JF-TxV2!^+N+qTaGW$Q0_mLXObZr&0kri=b!
zCmjq*A_-qb033#;il)&f<RtM5KOJ}jL`l5V8z<tOz?>Xik5I#m1~sRZ3xE?(^$CNR
z@$f!udSQaFSqIn{K=!ba!v1;uLPXP#lG(8hTPZX;+N$fr>3&KrF7$H70td#*^-))q
zZ{;fDneEZBhAVl(J|W4hLv9dCD^>yj47b27xjbnfIrn(2TK?NWs!gh>x8nLi1@un+
zkkEGiEF_G{2P6@14O?bkyEgMlk2p9up<ZSCVtCQ;%_X0lXeBfG=EAou>w3MN7R@HN
znoniBv+hHfGB@fSW%WrKiM9HtPu^dnRRdWZmaZ3hjaR(l$SJ7b&>3T&aN7zDq}o8t
zwT9LYVqLeuOJ$&^{j@LNg-H~c=}Z!j?2(_NZ>&rCJ?n<>s(On|C_wfdCzYvIr3v~0
z<gpK*O!rUR#u_PRCr`b${Cf9~=N$=OMM(^*xUBF_Ztkp#y9%eLH6PVU<c#4<-M@DI
zzt8(0pm&BXN-@BU!&}P=oOEm>->y52-a=|qEMQ3cg?CM4CtIs9pWXO;?C%HruNn@2
zKx;!NL|5*HT83A)Cl_TIM`=G{vDhODQ<h3sr?PwC`hs&v-$04Mt@M4paYUur+;1l=
zg7)bT4*Gl;tGr|D<U!}d+-z0UQPKTR4f~qsKhbLEgSVigJqt={Bc0pzR8uVs4i0Me
zL44c+`QpJjl*sR<51BS|euV+pc4V;=A=iu9H0&scj#m$oVwNqnpxT0Wpe8p=iyP!a
zx(nJKbH!=%9{B_@anm+!y<HM1G3{HR?=R07IVZ^Ic|qW$ix~c74+`#}<QKQ6(SA~Z
zLmNQknmQAybim8EQE})xwLcO$Qk&W$h?a^<Cm&A_&akIXu1$e+vuAGCr5v}ISq=#L
zT*G|_e4a`?0vsm-W-`n4JOC2)N>T)aPC6-f*q1)mVkNe;v8nLV(a{M$+ni?|eirX^
z_q(sV?gL<GZ4Jiz@JaQT`a80LuLv-hB=KbKi4Wdxs)D%C%5RL{H}v&hk>YiR)tH~T
zFj2KYXSP+eUGB^to}{QDS`=|yGq!P|&JG_fr9#6u-!0V06@=g1N6qy#p6Zg-w@S>*
zt}8D3yURUUT{@-+KJ6E=7TgjUt1s!@_amWb)A{5s<Gg`q9O9{WzSn#fvfoO$;aQ-E
zM&J6aZC8{wny`M4!#^xpWRMY=Y1C4hnb(>A9uDA-AD1%w+0)mzH2fadg;7h#QYt@c
zwH@ZL%3H%DmXK+=CsUOy8gttzVrC5OOsfaHYbyr7cBeCwG9+{MOJDA-yO}>9yJIkI
zx0gLOtl(33^Ugp^Otv0?Nqi<#ZmF8&z&y|<mM1~^>>Ae7|2}WQ*P8t85_?|CAt=Ik
zbG$$d<PH@AX~?jg`f#c78hG(que%Yvg~#hsoTp_7metncLgY6`Z%`xARwoiVtMK~~
zX?RT%rUf}NU_HArVWsyN_GXo{N|iX=2X`$<mSS_=d8J;G%ww9bg>k&(=7-(QjvuTt
ziGEB?7g6CiR|Da}J65l2!%wjQ-d~6xZh<9%lJL%h_b$e!M6<2<c<a1_p%Olz01uIc
za7deI7Alb){Yo*K^^5!73ip)x%(eK>DeE!ME>%;70Inw4xa;kgG4p=cc_YA>nVG#y
z(Cr{>lcaAR`H}D?Rn6%m;a5meP4)ViPe48EvExAyrKyQ-8CUi!^xjuF%=Wn_EnLDD
zZuPKm*82SPcNmjY({Oq)B`@=IrPONwUhz~j=&#_OKKh3Bh;%oS5evNiz9K4GSyzFt
zBFZk4{Lqr4GxC*}kQ7<&%4;xmp62`(<%L^dZ%;<Y5tb~e_>4}``E;i*=e<_QgVZ#e
z*W;G(v-j~rM%OWpN<!I5sj#&!Xj`l5^Y<Gx%B>0B!)^CQx{QnGxLgC?5=KW!JA6Rt
zQEZjHSNvI9p?1DRGE!>+hDbtGfurs)>)g;@(cZmox2$@Qt-;S-I+6PGbw^_#LtyAO
zInzpB!-<b&HEa%>rweRkEVHcC!@RP;2G!pGaW}BLud=RxR0jKw6Mgf${3wSJE@}u%
z(Ka4bd-`x|q|}s0z2TI<!bv~HoUvc1#1IR@eKR(IjITgj!MemyZ%!EPzCaos{wxkI
z5n<%y$ZYoGTDER<hcr9shW#A2>pU6gftuIZ^@^An;n@U-&D{q{$xs=vln~5`m6MKd
zhHF@-hc2nWf>EVQ(%d0xBtIVWknh{OX2TzD^ug3GKJ<xB7j@!$<CD9+B^c3Dbwzw2
zY!3yy^?#h7Zb5`^ox#GRoZ8~r28Z`x{ry#M5l^%^hxIk3lyh^V-1ke`yiO#PWjY_E
zAnV#8=W_>Dh%tshBk`L;>k23Oo*U}HZ(F5kRA$2v(+xy)oSls*gyO;G?ZwGoLf`n3
zU?qtidm4MKD^T|_=4|DRpKb%yKl+nP+C<siI#pl_g}U8(`iE@_wt<Q?PaSG%*pZr_
zO1+^OsZ{;d{t_lVMadG!B6{HdL6n5nq6uH{XQb*F9&4A=?o6(@9@PO8c)j*4iRDY{
za~}GCo<biul+wki1Rm|R${!a;Z-Jmbp$(cMT77LTg*H_CgFc16uSytydK{-7wP|X+
zTnnW+F*2rG^Z9v4&<97#P9Ze&Oy2x@!`aL4;SiFdA)b`j&$!^BNTapQ4}P_I^Odk%
zpd+$yrh&Z9pP3z#ec;#b@IjR+xqanJ-UeHFLuq)j$xT--=MMR>be@S1n1Nuds`*$n
zanxV}LKhn}l<fboNW%7RD-<%phdJcP+~4lcY;%)hZ)ufO4$4e22%uXHOurpcJIU-o
zT`!r3LxoL{rx!Ym;qOU*4JoGR`EGQ)xk8bXl{#vhJXBoA_t}atT2hqTRoZv>9Eqyq
z$!66L8+I4-y(@1|)&va*&e&G=#80#EoWfMI`veQXr;N<+(z=Y6g(r6)qbBECZ`YEv
zjI@x}9!`Yw^71Ihm&#EbX?ui;6|ytu@ij;}?k2wQ9W-z)C3zU|TN;nTl2u1jZZB4y
z)JCu7=aI3b23;mY>qG?$qtS$NC%W@3zqJjoBuDI7`cwT9i)`9l#r~9;^po(jo5(_*
z<W{_&s%wT94l`W$WP`Hx4$D{Vo)p_;!kyGe4=`keT#HYVyL0qBi%{r!`1c|f_at>;
z!&uh%rZg5M8ByD!DWiu%f@7Y@aTT4a%=c;ObZbN4LWE1ZaDeq!F0+@V#wD}v4(>Nc
zd4-Xq(wXeG7CpTc9mb@XLW&Ofo@gdg!!}(grKn0B6!rxpWERzZ>W%o8G`H+B7LqF&
z<;Ef9*d>2p7eXmU-F*$ky|9)%+&10jbN4?ddg(`3@c=;DV|jK<`P{9@Tg?dM1($To
zy51!1W|6QW?p`(Bc8ZOnK5Pp`WBe}onwH>=-8m^IjyJvP7G@Rul;$K-aCT3l>(Jq5
za*TyDGY7Wx=$!qvG)J92Bo?9iK8nio)_S~fTRU{9T6BCK7ern#tJ806w_IY!Z5xgr
zdf*-FQZ-JCv|{16$##1~@M7-8h{)JeZvm<{WKK~8XYKFI=t?;hwdc7*dJ-KyD|2q9
zlsIde2Jw)biYGWiVvXZP@X5BI43$_w`1vTuj$I%7kRUNw4?e?0qWN4mL(99e+9#&4
zm`_+D2yKItp@rC+EqqVD6km#yhoEh7KZ`W7w6v%ylp;sI3brrtD~UkFA>Sr#sS3(O
zg-<JynO9{qcsg+OAX+>hYGiZdaR_ZU8%2FMg1OE7QkxSfLyQk?<et@(#lBR{KM;Vs
zwH=mL@Ps9~zO7578bY~AN93<E&g;EeGTS(9n7SowA8Q>iN*6t|6`Nb1ZOY(6X=9W>
zSUIKSfVO3~Dt+6o|Ir2+PBoW!F0gX$ueLl6%O<Y%mrZO<Y#xLV#I1f0+d;V{NH?sk
zV>BJL3{j0dqK)ZyhL_H$Y!+$+vyA4z9)9Ti^e{&g+E&3$CE1!yssKZ&L+ja0!|lmD
zanp156{ZHNGu;mvSaW4HA3sSIwMdSMRTh>T+JyXOg;vmd_Irkr<tTayuis#G`EZs*
z#3(BL=-Q1xpL)4#K=^(9f^(jHVytQ|!}n985X_m8baH>^=17-s@3zX&B6F0}S%7P7
zkZpCJ8LO>ZQ&=Q@s8NK|5VNaW`RLe?ujh6-OPR=TOgxRl^p;{;=sfTSh(7)xn7Ye6
zb1h`4oo46|*{G@>Vk{}o3dy2ZHFx51;oX&+3B?%32JQa5!}OTZZ{7QNa+_L+%=rQm
z#W`}^DqB3ErYE1NB$i4ti8|JVz2IUkSnZ|9*-kii--$|7QF%Q9w{_MwJ+~21z2!M{
z5akPl6G0e6Fk1EA%WNY}Jq!V~Z`C}6U0lmmrMzys=;+uebe&{uH8v_3er0b7W6BT(
zoxPEHh^#lR@(!mQrT1wkYQk*1&dJ6<ylc&~t!c9>XG1I{<G_pJs9p0|sa>ZQUxwM2
zB)v&@AAUT=eF`e{eGzj?=5Pwb|0Fqg;_yASZctn@>f7-eV`u4TZIfYnH$n&mk)(gD
z!YD-q3J<<W@~7ZW#OW7oUlUmqd>l}ao)#{szjvVbQR?TB=lqk=GN$yiB@!46mCx#V
zq8%mLR&TChQSfRsMXe8{efRel%cOBdx>Em+zBi$Zo?p+mK3k$@JB4g&XL(X>(Mvf}
zWZ@@-7W6^sVA}V8;^}L+`_$KQp&nsg-#j%WbUKwWt2m%}8C8M6rys)&i)HPn8+}3=
zSgbY?=3;ozK5yrMUgL)Ra9H;omD|{N5%ym+Su`H-r2IVZ=uU#B$m3f!Vr$B5`;O5h
zKm8|Hw$l_tjAekL$&q8M!-rXjxckKrvn^cOYpt$#f9?6HSB4h<s-i+@s@VlsV`|Op
z(OeF{6oE|ES+L{@3SGoRvOd+z7~;ZRq&YsKjM+7a&Ry^_SNOWg+uydHXZtNQ)R(U4
z1hfz?)n8(8Q(Z|w@TF;}RL!`uG%a1K)e3u+dNfV^@SA%&S|;D>Q$wcQ1cg7}zBxG{
zo)WST=cpvN&Ph;|u+QnH*%@_l8L59H8%HWaUsmG#30vbJWXt!d<oT=`+Ml-Prn%C$
zAnADvwk2^*2`x{;yPaZW-!BMIPG7UtGY_0kF@-}x-<Ru7S!E2+C8Uyfwbclf6=k14
zIL!#)9D6Rfw)U%2$Qg%1>5c3>1l8kLI437Iy63vZK~%a*N#gs+F=ZQjL|0_HC<xbj
z+f;Q1Rv8`SzbVH5L&X>5_-sr!87%&iN}`Nz!b$#x6X6;TaVA5lvX)y!Aa~mKmW&$7
zC{F0VvnqBOFZ3UMLfIZ5j!r;6;V+AxuAav4LGZlLQkkml+gRZ7GH^)9l1BQQ?1XAV
zqyw3AQ|iwx_N3hbx;n9&bwT3E)qy)XQWf^&Jv_1U4vvDqEa2^`i%OF#?)yKD>fG$y
z+hvx}7<_(fMBkvs(rH?Rpkeh{$|v4PFtc#h&7*o7-vl(jx@PclzefwXg<5oOItwG=
zx(-uVvR0nMcl${-VyxV<qJ=`rRE<QsH?lxq!k5s*_zg7(U3I~vo?TS8NFJ_QnzrD;
zj~jFk@u2Ko6(1PoK7P7gR{>ffP)bB@nv9gBx3c;u&*Rsa!H};B8MzNO{Zr%6#%hwv
z=lYt+C3D9SEiVMLn8Ur@ZJf^a(7v0cuRpX_Nm7HO`i%g3EUeams*Ymog(RMvJ^fvV
zi15RYRk&${3+Z>oWv$as$oT~0ibPz?huu_Qn(aZ$tQ8QjvgrkNnO2J{W<LowN8BT(
z+l~*Bd<++8$qkh)b#0awcR8b6JC(}|-Ne&xf=kr0tPZ9JOD7Oom<WsHKD+TJ@4tS3
z6?Wr(@KGm?4`}?y6Nx0L>Bi%!wfP+i+pG?HPXad;i|#TdU9gYf>?=0uSvQHUMd_O!
zPmJE<)PP>E9*8cfqUZd$F}q52Pw0l2mYHsy`I>1KDbl4G=lmjW*uHQ2gPq$ak5%d-
z%qrkUL<@*!Cev3!Q>9hc?pt`(DalI^X9krA={*zTBFV=?{lDbc(d0=_+g>`NsVZ|G
zTFTQs?`+(Zb(yk~dhyMP;|?+9-PwcdttO_b7Y{YpAeC?N5Yze#n@LR??}dnG?1>=X
zt~GJ-*-Sh&?H4s=#CIql>Q|OTO?++4Oly{zn3sLG_@+@9ak9KI^39}VdPRPe$U*ij
zM>)!AX4jYWX>`6Z*Buk#Sv(UxQKA@|>DLSA7?*AVpH>#^svfo8>CgsT2kU4do_CGK
zH;=TpZ1YZB#Yf*B=1Pg9k~#!k$ukuXd-r~{onoY7x&pWHJF7YP;Y{~xe$mC+bnK~~
zv>3A&AM15k@vj=J)P#7OjN`+lWVOEzm8W$Jwr|(E67t!91-)Xlm{HWp#b|?O{CC=<
zd*Chd#QnQp!vEyMz)z2`Ygpj=cJT?Zjkfy{n!w8=d=whcQ;o+M4HXBA^x12YSi3!~
zMF@Awkk1DcOScAf70Hd!;JNiukNAUlIL@X=LPV@9#_5cSQ7Il#FacG9SI(8xZi&X$
zADoXj>88Btt3%Z+v4`+VGVSd{BK0ob6_ZEPbf%mXv@m;os%4it{{41J+<hO-EVR!Z
zB)=@=FK;4Vl_ET5T7J8ps?z{9!VPxx(-)^_dA}`OVUE=H@SN?n%eMl0i?#x}f9EAV
zV;!qT@9!3|5B>oYV4>WUEO_nheF>{Wh8JF;zI)3A39zE{a<GIjO@kGFQhC4OVNOkW
z2;C+`Bsth%-@$)H?)W#{EAHG)vN#=Ogaw8^%Pyt$GbSXc7;h|ZE}3vmCM8i&(l@lr
z*u|G(b3bkGtrQN8`&|>jyFq{I)z}LRpsFRQZ!FHQl>D{(V{&2EqeuNfl#0f%xFl#y
z!!yrF@_z01gt9nf3}pP3ER5aN!g{`h$S(+vU>nzh`xz}bZwn+?>&w7k=uG*K&rs;*
zSo%3$<XdyT=q>-A#Wm^xedmiN?AgGxw5rqHc}I_fgb-+We&Z((*y2BM<M|7qF>Amc
zUy|cw&cB>-<$f@hPl5aNoAY+I{p(UZ&hlmb2_`FdpTZhXxA>rv_g%K%hz5t8QX%g3
zFQX}?l<OC~=K5d(I}Fbku){b?h;lc!I`rFBNfezOLw^GXGI|)lUICOlbKXa;yRUs7
z-_<?WUIZRq8)^*udfOY_7=gY<8CeWHA$a>OG~H!t+USj=>->b$w|=pbs0Ohufn$`S
z*ut+@&OhFqGGz@FZEEYGha9Kcl%LKrIPg21ml)s82Ge~X{6t0QfPT*d3&NwEKJ`hj
zX*k(}>W+}MZ>;O3S>NrJ;iNmR<wi;PrAPB3{Wa3Im8IOxwgp`hVf#kyxY>C{KtSHL
zw{>Q_9TZ78>PyM+d;r9nw`S{+0w!ua_(@!actMA~>2@^>z(Vt|#?0P%$*cWjSsrca
z8l$rO*r=>{fwIZ-ZdKB+DT~*fXlq!A(xE5y$-r^lW?qqKLiTRFJe#zW%j61ofTh>2
zs$9rPv%z5<46o{~?fr-U_T$F$%b1euIp;hhry5%NX&QXwErzW^-G+xQNV2U>S<UhZ
zgF^gsi@NRgU41x*MlU9woR}@jU|UG`$6Qoj_>IqBuG#Twc<*25E8B&8dQm~z+Eg}w
z(MFXIzmZ*5dK9w2pwd>UBtd&eO1)$R)pk1w2ndInYzH0%a!|_1q_>lvqo-YdSKQ}P
z2g7yv?YPrENM_j!YJ{dmb~O9Z6C)q(8vlG=CLC%zq*orQQx!u77oqo2bcQ}|#qZ)t
zo~_>8w#!=$uHw*_kGA`6_8@b!QpA+XDbbtE{eQXpB~;1rlt4Ka$lVEpn1130u%?Oo
za}uUuKNHAecmx8A>%UZtc432N1RPaMlYf37cN$C~eTrP1CTMI>RHVy2`{qcoYq#w@
zz%Jyx!`=tI(NH-WyB_eqs~cgPrV{!YtV}+nnr1Qb^}&=?&$Z$~-Ls`f$_kP{lr@H1
z=BTFK6S5+4G8qTHZDPf9vPQSvQ(POD5Da=hRBV;^TD#MA>c{+-u}Z}*nV|H+50S6K
z!f$Q{i=CMwV%NK!_9;9UVD-7lDbr?$d9tio0a-KqZ=Uoh054=9aJC2@qr$;>+7+^u
z_JuHprgD9Vs2je!ef`SK;XVRl${V;m9SUon;GyU#66G|IrYD#<=#v`O7_n<D<FV8@
z_Ten&%i(0F;Ia;}mp1817m%lvGX4{0axOfh{5rvCqX67T$c}bo^a{Po8Xi@E?+(6{
zeH0T`<n5ug46j?BAp--E7tL#P?vz53SbR&<3HP#Dj>+)K??|o9diFexRTT8#763sD
zX0()|57<U#W}1}U(wXg^-Y9nGRxn$*xK4S!vhguU(my?p0a8I9u3YIfa@T!@CN4o<
z_4e@V=iZiZh_QfOKo^Qagj&0yB$Qv1j|}9nDAXkrlAbylP(JPNoI)8o!MDD=cq&mf
z7`Zn_q3IRydNGUa!H28h8tV(-K)i2!0?>ZL9Q^<Csr!{!vfH&uQyc5SxN=~#Inc}N
z>J!hKe*8TeUt@v9e5m`*{g!Q)bllE-0=i%<kZ?TC-^#%?!q=6~Lp5b26d0Q1R(&BP
zdeGSVn%}#ue?Cj^K2Tf0eh^6vh@M+gNb_H2?=M3_^z%<7vRZ{jU+XVP7TzJyukW);
zcYgTnN6ViFke9kVn6X&EkN2s<e=v6~!kklMGWGAM2(H5nW>seMDZE!g1b4~*;-4qv
zz;2&R1-kZ12?V}00-2JgioWhr2EJ4CF6DfG-N)XyZaG3P^k#s!^SL4EpIG%7!_E&s
zNV$K#i)^jy)axmCY1x;jFBbj<vJICd5&=cCoJ?d$$D5G`f5MQQbC8!E@L)Uzlx<hJ
zsm6^)$B`r{aV_)2O)>Tl?1IjM1DADz|2|(nUP_-GczulbjTbI|N-y8&Upn?Djp*xI
zg|Itrur83s5H)?hl6@F((~K~-9DXXGyntFy_Z;|WD0$PD_3C>5Ps=ht^d;1P6h6ZI
z<QXzrYbtyE<+U^E?Z5wE-wp`xKK7q%0HU}2BYNO96g%3g!4LkE)mJ#EdOyxo4K^+t
zP6%6^m!UMJPlI3oVg2_3ezaTy$xaTy4<gdMKU(yW>OBy|4UN_GQ!FUP^Ts(U3Nmjl
zzq|fd$DSH609M8TrkxM^*rSLC8BrGS2Nr=Wk}$*hqi=Iq)W_9dykRg?`T4GNsiDQ+
z7Qe-4gQ>4}?>?}5&E{ORq<AS6&C*v-68>ZUpu!nbXB9Fp)^0Wc@w?|%;N$c^+eQx*
z3sQDy|IdSdiFrDzY4CDkeN=IwEGk;X+$vw0T7*7j;`}D0wN?3Wmr+H{u~gOT!N2|a
z7z*r9sxj4ivU55v193PQ_)Q;g|JGmJp$N~}nXormQywspiVp*2Deets>oN7naTl#*
zv<_qY;R~RSZe3yUU(vY0x$)dQ-_i!k7oMXH{(;<dp}dqy7MFFQB}Dn+@X(MEB@Hb0
zx7|2xuEffhCfc=INq?W^DJS0db2(-<wp^EWBUK1bh1OIE%I8_Y12WJvJg!0K3)-Jd
zY|L%B;<x{uv*-VzBJKbx0(h`n{~b?Gw)bfp#Rpc_%%0m2ZH(wtvFA&&s|WnANPx$x
z#8Z()0g=}CdPK@K{NxquAB8`U`%%U6WG%N}_UyTRKiLAao#A%_^jGe`diCz9;U!$B
zmE2^l0Ibe?Q7-_pe;!_0$sZBs4~#{}TMqnc^LKCTAKRaNxRZ28EDESqBxKS22$lUm
z0d4f<iJ15MKlaE_=SF6~gj`{!?ptyLAQ(4IaU^eDT0T*uiT<}%pUdd!mp$K${3}nk
z^lW%AC=2y9*K;rtmT2m`HW6~2ns>|o7uJ94eI$>^t1G;krKzc+8Z@e#Rb^q4(K=+q
z7<`~{Z~U){UBmK`2QK^QCcfbw5R~!eA3~yDOKyb$3w^r!`u1PBozdGP>#QtZK+=`m
zTH7ImnNkl126`k@*3$|931<h``gulOT<95=@A^Lr^6$&_%bfVf%lIPN|DEa<=WgHY
z|1gk$8u=v=kk4a-M>cPOCwkCbLm0Gr3cerwdf+qmm2dl7!@c~K=JLKb>FaL;gEQ~_
zFV_4gw&yay`d$v<+Zg;$Y(zj9T7>6u^Z&UVF8n{+LB4)zJ1RKRfLE%)|9{5gs!n%#
z`5%=3849ZZYbgFL0{DUz46Nh&3yWG`;AC~?hiyM2@&OIAQQ%<xJzM{T^T^N<xbK&@
z@5_G!4nu`?MV1vP`90-Kd-j6(N_GFwo!<g6jX%NX{U`T>S9w4GQTzWRk^8s|fHiq8
zBU0|Q1_c3^x(klFr2zb;?(yoq|L1a#&MviD+$sk!@j1YW{m;Z-8Y2ZRl`Bj0KRG#F
zI<|h7%gXtcFTL^tm#ewY39JL_Zsr>KPzW7;v3Tv}edVjHN$+3j$(37p_pTGTuMrA+
z$Tu4qB3+WmQsUnraihr}=brZed)xav?*UngKOM>kgfjf}%547I<fo6KfW5$D*cv#@
zq<}D$_;UvXeh;vwTk&57{-4Xe-(dul@u(oRL4Yn@<CIPocr&&X@ZVGTTCYs+|B-gj
zvrA_@e*OPA<9~|)zC8T_C?FwcRF;*rK;Y-^C##qD<(e&h_4I$+dnKaBz<vEYNu()~
zfjhT47PZiwTmUbWBIh;vcO3t>q#wXLPJ@sBKla`-Dyyz-8#O>gq*GG4=tk+3y68^n
z?k;Hr47$6!L%Kn_yFoy@LAqhD3**-NdG{FaH}*Hi{`36f2Q1c_bDnja$9c?q!bQNM
zNId+V(f-~G4=EI2!XUhiZzjqdEv1#Pn~v8J2$e)-CZ2QuJmuGiG$#QIxKR2LFe!iK
z9Y3-m?`Z;H=G|o+4fLN@MF$Xd!B?s<|25{{_WWOC{;x6rGUFeH{r|z3&n-!%u6JCF
zsVPh2z|-oNQZ8-{YR@G8Wwm#X$0nbT4xI9rPkZE82K(R!*}=U@VOnWQ_w9&QSZOvL
zX;<M>(to*}RY;&<9dC+~UI)U8#&5H4#f;5<_@D{&IXU~I+Z#2ViKeqFT{caZ%>Usf
zfUE=Xeh==vUyTtgL;girMZ@>_k+aauT`+5hxDAEi{lA_2>pfH;`8}O@t^^wVCkl89
z5bSuqvw(^WA02kx%eTv|o9~aY-Q{VC@0R|1VV@6P0?vHnn(@0G6yUDDf_{a=MM~+>
zhaTUMSe8-*+D~OII4L;;ce!m0>L35xJEB4gmw~psFr}sH3c#9a*~_}!?59_Bi61Ug
z-ZC-EcHQo#^egyD=alw2F@ym(MYcSma9<G+iTw<xcXKUt8rFpVSKwGDg}hWPT*04v
zu~EA<kEvggneTyrlkII!!1zw$wkNoOjyQ{zp~8Mpet<d+Lo~~(Z+P4sw~q*G199tH
z86DZ5vHIS9L`W8KuR}NLs2=%Q>|L2&4he)^7zi!JAj{*gE8($N;>_YWI*M~q66Owe
z#1ZBu^qJ`=;9e5Q69=Ob$$O#yi0jYKAWsaVhg4i}Bb)GfibLaTNsM6b#eU~zTMU5B
zy`G8VJw4MY<{44|u*cwgB4u<{ap4>FGTl*mf2FWLUUJ<F^3`5`H98`9+y}waWZ?SE
zd9~XHx>7+dnp6!%MOj``w7zOf8I9=B3D)@IPHkh8z2~oB!52$x4r*j_e}3%x1n@N2
zq?L(Nu<q#Z@V8K!d2N>7XfY{q>+Bprzk^AeG)<dH+w5PGtN#+%8SX;9Mu$l{;Xk&+
z1OJY^2i!Yy21_NDH*sC;PoeJEg~bUV#g*O}v<<JtDHWyoO{vhovgMsV@=W|IzJ4JB
zUW2}i7fK83ublAtJHfE~Aj|p7Ekj{x__j9wp%F|#0*CIi8`CJkM3W@{PxRo&aUC3h
z1b!~K!v9E|E@y<?)fD-HTt4?lGeO?y;@S$&DTvAGCxCDl!XINo!h1Dvz4zTG@X@{O
zL!*Rg@+OZ2s><I%{yq{NG7yW!%CPR^`<kP@a6BI3G~}g2(OfsANrt*elWOuuhO9Ky
z5f51BPwRJulywWG>38wIKSGIr{ztekYYZskeuCbMr3G16_sc@9hCl!81~A=LN&Vk1
z1>D;i%~gZN^oNDNCV*s5^J<zu*?;d3{y7piWO9J%({fZtKm7AAG=Ah;pZ_D@+OYub
z1o1)x$i<9o;Q3E_;azt1p7JgQVFm7;f*PNbDEGsVIeK?LoWVN0CoY!RBC~ywPz0Ov
z<6=pv+W3A>FsC0wzPbSQiVC?^tB@}N$7I$Fhy0UrO@5^^(<!kXYU*%0TP)(`HB<q9
z2kcah395*QQKhm#HYyC?0Rj=&W-^NI!hqB`^XJAEY3Vt&(*0I9a9~gRPf~(du<f|p
z&zF9bRKKz*Cn2Dyz<<E7zw?h(c>7?|-Q&wM`#gx4muJ-douL~KX|1FUT7a<(=zC@c
z3Z<2$V@27ykedSFk%dWKc20SVAti`-JZgqx9JX9Dy{gV*Jc?Ob$AmqgTQoI<wF~W8
zRRJ1Bo_Pv-+-7!peHeI|L`usZMS#_IP_{{kZWXE94vA^2Vq8|(@s)s}z@UUz7^G(H
zScAg+>%2c7g_s@V{_ZIx)u#Myc(VqkC+suqY#TG^Gi0x*BT1ICYH$ndM1hvRWZ1`y
zp>O`Xjb7G@Www0OX8ES635T-T@8&O^V|l5uawg|QOhmSFO8R-vWA+)$EuXY?@SoUX
zS6ptzP8&UYm78y}a)N3orv8MueY$e~?sW$z#+xdhcm7VPAV0hY?g|0QMvlkens@Sb
zw=|4}O6HW_A`+QjM+VaSB>OW@VzE_N1q5V=TYbV`?LejFAGDkTQ`z&`Bg4jds4>B>
zs|~LG7C${Lj&ST&%FQ#{@*9vfSz$_L@^h8PPzF$J87er?K|f0v8Qb(tjbCYG$xFb^
z6K@)t(HGj6Sf+V#ho;J?S@2_FzP&<?i55DKQr#`>)VXZ_AlK;dqC7G}Mo>0v+kT_(
z*?H%g1GZ&rNO;9op~Qp>c`&Ql5~DHAo4u0j=w2#p%XO`A4mX1|R(EJnQ#9X>MWamL
zga*pq)iWJq3quBeD(l4_w$|cFlGE@Je`nWoQY@SAleBO-6l<<x@RW*JCZR9w6tT}H
zyg24O{r)t`=gELg@@EZI9{lC3zH1ypn5zeyh1bCeA2SDc(_jX}lF&*W(q@^Os-nr*
zcHX_P{c<LjX1a=#XE+=AXmjuc@t_oSeRZj$_{BR53RvX0-h{@GO(jbpI=SvC;DHa+
zMYLVeb{Ltw`X}cr>tl*;v(w+Yueb)_wG>+H8Z&ct)!xgnltNLv2|_l0tR6I9n4P|-
zs8ISs5H!YIUY(zWgej1<n<RO;7rt;%Q^`w@;^=ns2$-sCq7$>uPioQj4m-gUs|^%l
zra7mC*cERz0zjC(a2QfhZXJ+$BM(=uRFn87L0;bpSIwILe!$~*#eGanB90zOGoij<
zk>z7f^CAu$_j<{{>-;ZxfUo!(La$K`aWJyK3p)Dw>GM~FjvXqW19yb&O~unm1V<un
z$%v*dv$gNP7a5WcDeH*#fZ$60snzqQspmZuUBlzYG_hy|;uE;+!)vFK$fO+K7nGM0
z#)tJAnF$k!TEWF5-b6JA*&%2>fyi~lQ-Tg>ON7Se#TCSRUB>PmQS~9qtz<Pz;R!DG
z?}~lfUL;XbWf5ZZjg|=U&y&jNpqs;pb*68?ECZ_9fdSj9%hg3pgU#iP_WAOl93T3l
zN}o5j+xTAogg;J^hAK>(3SQ%)!ENb$PmYHGM@bUP^_LWhMLc=T-%R$qU|}f$<Y|g>
z9O1weDRkD^Do)Obbbiw!l8?*+1w6|l!D#d1hxQfssv0q5`eHfD5o&d4{0IWq*E8-{
zO&O1yix<4tvAQ{S9YnO6e6!^Co1EoNM}iV_9qJ=Fuc<`vUybW<B7X}1>d0<aqqV%b
zI{D(9VY%5)P0d<G;e3N*`lfHfyl4w^k+oTLF2*3N$TLK<Uu)^%X-Gz@DnX*VBa`Jb
ztBzUqJ=j%T4!ee%lbP(a5CJ-6lm&^Kh}&_Ie<3@kfWNXDAo*If4n_t#zO!B=KrE~8
z);@DPf7P>1g50!MY`n8W^W8_ac4wLX=-Vd&`$wow^)KGQ+D_!KZwN>@`aH1OV>dBG
z7wq{?oMBTIa*O+_+a%pPPeWBgZzk5&Xjl&~X8vnWW>sA#CR172NSjS0n~&-d8xVwe
zd>9T}tpeNd2Q+T2;9S2vz|t6gzmQ|wH<Z??2)Nxfq+Gi*J#j|P3+WJA2U9zQxLCfd
z-L<%TUG`y-$dZ|uT-E%P#rlZR!2+*tm_~DOq5rbxZ@xfaF3gTD6{{!M5+ueLIt8Ey
z`n8L5w%k$zwM8O+q!6z(8@RE#u5B#su~jGKvI=GNDLkFjv~?di5+`(ry0aaU3m2>E
z8CR@&X`@387{rYFH=h^Dea=?=h&ex7d}}Y_a3T_4H7uPQMjyE4iC|R7%9`8kwzJCJ
z|K3P)v2Dn|`$k4a6tP}o*`7K*P~;gd^lIc%$8ds0k^X&&S9-;V-j@SqY?ShLxIs;^
zd>Se+g65}nrI9z^%7?;S3=(T~OVr<U{1M;pJ$8T~(SjWPm@lw4v}KNg(nhH!eA>h$
zJ1r$;>%kiTGTpaeK4C(;@WzweFmL|W7v!}&;El^2$rXz$0!GY&SGz$3?ETp2t%c=<
zsDeB^VhT*e;)%RIX<%6wa~j5c6;W}M390MU5B49=g=OES#V=*rF)jz26cuF^6xH+M
z^(pXuI>`hZuaS|2Y9BsgAGPNS=;}?650kKJ_$D<hqb?CgP&c65{SjIE;Ug*S1tF11
zqdIxhW-w1*9JA~WEw^k-Xd9FHTzk=5*^|wl(JIrN0y5)ouSG&n-p26LZ)}t$%$O<H
z`^LtEiO~1<%Sam?trZk$_NRDs$X~auRXheonnkp~YE^iN#!e;)Ke19AwnY?xvnJab
zs0nCweyjStFc48@w|huKyQX0W-==FjaGBHdNc!;~NZ_CWr0E3A#-Hevqxfd0nIi#2
z(6gf3ZAsDWvfL0Rc_#Mjvxduc58JPaUWQzP!)Llp3RztUVgVT~S<AyT+XCPFD-~qT
zycicZp+8|(F=`@tUG^xYr#jDnH8P~wVY9x614_4)3&B#BQRNdIpBS>p%iC_ZMHcj)
z4C`2?xo*&6uRk8qce5|RXKrIjb`%T`U)T;9vDr-Tg5F@V2v6KJ*O%_Lqml?AB1EMZ
znq=jU$VAJ0_6Qvhx6IB};Gt`AS*V-x6yv9B`~Gwr#1f|$$D<9Z&e0!`8jGLv68i)f
zn=IU$HW6dfvn&fIP*5BhUQ|}@w^0yoWkb>9d#YS_jNZ%o-WZQ-v6HZ<*eZaCUZk_f
zKMVGXYNrj^`lB9kC_lj)Sp~_xYZ-k~iJI-C53_-f7prJ|T}^F?IBn?t3DFS$nWO-U
zX%0v-`-<R|+Smuemo%&Z;4Vgq7F}G|nB40CQ?zVI5Qxk#Xvr{a<h*9Z--F<^ou*yu
z`ecKXi6r!7p4IP$i#RUvD*wHLd09i2B!y5~9t(wc?ee<m3uaK_$pTp(>Zc3{41VF2
zV0tAjBREf81gH)r=Z03Ex=zJ8n$9^HPa}Jj7IyK@7#B#()a?Zz>18Q{Y;$io@FGT@
z<bb5Pz$?Tf>7H^rdnAd~;qsM(l695)<c*Dath(@;$Q`x=ga~6<{B*7-ekgV#`?zL$
z%x-H*%Fz-_pV9{{s3zaY)Foh80eS6i$gz;HKhx^ApC*x#&ARB8rpi0K82h<16!Xo!
zG`H&{+?5rFz*gVCf#(JYmWwH(jQ1GKfW=+{ZVe)6s8stwc`_uVfTUw%*H>X|8J+K;
zu<eiS(2xl%C@C8@9)UK&a@H^5Yi~$YsuOb@)~ItYcNEje2$>>FBspTBAMDl}nqMB+
z<X&%zst|?ptZDGW^0^*zDV=t_%yn2HPAfuwJC}x-*5PQR@)S3;!`Y2~Pj|ojqINI2
zUtvzldvP$UboXfb^yC9v&OyOM!EsekS>sK>%NyV}lFL{o)8v8yZXMLFY>_!AkPL0K
zjnq=G&W0bY)JQiv(UzL!7S**(&|ylf7k2j2DSt!{{Zh6LnOP9$G2y?m1_(;7s=a~w
zVN;NsbrawfU9=vsi7(bfDGaW5lccGhJT7F(9qf-wPkX_qrH(S|#H%Pb0^}hz`zsOc
z*Qk?lD~#I#!}2woAGovQ;U5vLAoyqH1z`(JQB_$+5TSH|sN$7m<aAU6wbHJ#XyW;$
zLlk(t^PG=LF6T51zT#k_3P@@&2se%{T@{)7KW~||<FDzcz*b>jAI^#_(Gq44Vh>Gh
z9Ieg%rh>7~(FP_71tbnSPK>C&T1AY9GY-15DvP2Dat?(tKSasF>1AElfgNY_rd#XL
zi;#<sdkre#g!7CnZtAbMc!L*lrW2n!z;|%#=m>3=``Jwrx2WFXT&{yK{&$xgl8wI;
z1!~f&R_$(HR}20}WB@@Y+B)aKOERCc{bznSfU3SRjbILLzC;(jF~5up!>s!Wl!$*o
z*_iYLC}b%P`(2s}YtF;oC>+C^k|$|GCsZ_=FwbP)XfD#!pWBev--_n+y}n%yYab>n
z3Z&03=&HR15hx{OJi4ea&#v<j>5el@vU;YTmIK@tEHbS$XZX~3m0Tz1OOLaQyep;J
z{<ihfB?)tv`bguOcT2{iLaEtvH>(s`r*;}ppr&{)JLvq|k6Uc(Hd5!-7|+#?<6T>|
z?aXl5<*IM0q&Lz2PM5v|1srmaLp&`&e(B|Bejh}@>U+?C6QxFs%!M{k*QVUgUALyO
zZxQN^>ok3EgbPT_@XIlv_tx+=>Mr9<6r`0HtYV!*a;Do;Mzn<3O}T;M*O+enB*a4i
zk<dPW@j$hacF+?!3a^GdUn@l%9nPExzTt`j80@i^9Z}AI&uqP#_gepYr}7*<pl#`%
zs_M~O1SixcH2?K$hn`bigj};FXSywgxOc)4INHfESG|XCAHx0t^4x=}gFqlSDc|c0
zaRdM$qG4-&tJAKj^T*Jc-qh^H)E@fL;slO=$?|(cr>i<2`-zq1D^fRR4&XM=-rGd3
zxs4ighlQS?lUxthZSe#46AJRKFf4&F#STqabh*n0eC{<NkWFLBlh?cYG+r@5S?T_w
z>48Py=a?MlwF#JVz_KT{e{<-YXI(#y)5F`<ZSr<-iZCP^P+L^1N*mx=St~V|FyN{z
z%%BKMbD(owP2DZesr33Yb9j9Vq34|CmqHSEKrO*#ypSC<c1mrJ9|@ko*V%i@7tb5d
z>|8ul#^O+Q>c1b}gZ%1fd1uy!RS=>2vTv-Nntn*yc0Ojw=(V-~-20w78Wzh++NDkK
zb;D~ou<G$zp;)|UuY+!g)wu;~=|=Cv!&!O8?xKax!VKI6`Qe4y)j{%01p0%-o9e9{
z#xh>N*3E&ruq^vAM)$Sk-7uZ1LN6{D&b=zcj6yZ{W<%_#s8k6ns6Wt|d-sEYTy@{O
z<D3u*)Guc0iG1>vW$~mop3+iyzmHkQAnpT-J+`Em1ba)4M4R)T)GRHx4N-t$VEO_T
z*3{V-SKS;kX8+AY78xOzhBZv(`iG$5&L|Bmfejcuv4^)#!ERG}b5x!o2!S*uH{)^s
z^!iCoH67VR^7H*!v5rYtc3~vqnenI+)~w7Oygm#v0OztoTZ7PllHxLW-vA-7FGhfF
zIE;1OhQj?)JXfPEc#`o`d34h0sOw2aZwtai-V4M(QjmKO%z+$a5kq`Z13+#8%;0k6
zi0wWx*0X4AQN-f6VjXg77Ac}h>c(gqCj-1uA&iBIwej7#u>qYgZuQb&JJR1HEppnN
zoTJt|C5`SiZj^HyaSDzE6V0)gI>gU~zIp!yDEHXb=<|4d*zJvJ_Grn{m>cFz<9At^
zylB`=t7?|_$wI*TFF_FxsIh?8H-5Tl7-{FQltukfP~n-Pq`&Twf%LS9cR=bh7{oMA
zFnqA=?<uXjP5CYYn01l2m@E&_q37YD(~ix6?S37uNfg@loK}^oO^?8UyXHNW*$zVn
zT|yyC$zV?Zp@u~|tvl`8t^C(P-<-C(baLoAY+A+YANnvH%nhjcr|O(^r|GZ~=2Yrp
zq<H$<w5R#yloxoBysD*C`z&iSbejBiM>ePCqBwysB=MEXc!%*Nl3|ng(aIL?k(DqP
z?nILn!bLU9sDsrF*m#ALHliI-JYy>mFXP__sR(kAd^;NeVUH7zWdPgt@zpNwNa#ne
z;)ex?l1QY+qe|N6E{W5n?gn-Bre0Cr?$|a~K0tQ_*{{=KTi<+`%ayfw45o_Mt`B?G
zo}TqqAnqGotpKyCf&WCDX8Q76ZFYU;M?!7woNpCx)Yq~V$y{&V7%SIzlWqEFrf1m<
zb`YJ<0o_|Cgg~3c1o2$8s&|BhX=HZ3TLH9L&QgD4^y~m^GyIkSdY0^gXGlYBzp=gu
z-QsSC?RCe6Nmf8+!Y3AIxFaI0DTN7<DDKkU^?pprP-E52s+f8a^^Q4W;)Kuhnrzm_
zg*D43lQ_H|N;Wa(M0}F{!<Br$B3Fg&pc`KBZRdN0F*kMU0rR)HI|Z}8N>&gK!qkOw
zT2dk~EWrk&b8nhEMIDA7X{xz7WBJUGowmT@Rz_s+vmw8XBoxTn-OTHQo3d=nkoKY>
zZ^Nl~i#6hJy22gCNCreZGL%(rNVi}4F}Sx;pYvG?ia&p`&hQ$o9i9Mi`OOK|t6&<g
zx-U8Gz`(7Y`|j(&{>|p8kFs6}(B01j@3MksrB8YNS@kdEvU4pm^aI;NV=xTXsB|B(
zk05z?03V=pI6gAqZvKkIX8sK-8GB#t2omF=g`(WBY|<N$SIx|lj2$PQGaF1tMT-?4
z?%KCa7cDDlvnAL3#_e$7eR_7LW>tCqXMdGjRgk_899g0-P$p-hnl=du@;xkQ)X5yO
z0t%<L3uHC^fC{Urmz!l}G607YzIOMK{Pqc!X_I$GO)SOS88^^)%0Te@kX=7(L`8Vz
zEhfUi|J-^gPLtoq7^t2`g8gXij0a?!ekNc66b(-REEJ}L{*ekDiZ3fmKkV9HCG8+8
zu#iXZ6RY>eAYOz1R2f>^wh541Qm1=M!1?8S*~VU#yQ&c*Ml?`^K)@q)3&aYk6l-TV
z&YLNxX}KXWYSZt7g{g0iL4H1gsQ`eIyGk%X?1<`5))KN%Eevp&_dXIRE2iTJoKZk<
zqa%7@uF0*>rc3s*J?hkXl`2nZQ}MR3TIhx4aL(CD62*v*<>(eCx%&TtLB9|{5O==3
zw_A`6M*(gyc*}ikv^GDwGBQ4{??QFOUhAT)q7on}D(YwDVygz;lV}y+vk82*y()4`
zg;1fHUYL_W<6`Y||E(0516}tLUyZ+@)01(mz1ED4J=a0E9qMkGQ#@JBq7NNmsr6tm
z2vLko_Iz1VfFcQ9Sa@Ih;~_NpAqm#`Ko6xuQAUnRKSTQU2tgU!&Ubk_6o1xEmLs&l
zt>hqrzZ+VQ0rh6^Rr-@A?^mBS;lRe2RLN!*jSF9`m_-OvQ*$)O@znR8#%jK2E@I;3
z{G`mRR8QrA=dI8LnEm>NNx(FD?H<n?L4v&54bGXaIK#HeIbFFUU?mrEaRsp%nuH#&
zePbd0I~9B_39)cgr_~0<J6eOc^!u0ImJGg9kC3h9z{sV3rDDv|So|!s!k?i*cjy3F
zF}TrkceXLKuGgVvt!!W2;z^`b3IJR0x&ZUrGsEBPo(7`V!Ggo3TkhBD4*54C*wxK0
zIhJOG^*fq|NOu5QywNt6xVoRmQvf6!|03JFVobS>CGgsb4XE5u@l^k$>pW%xR>V`B
z#c~Ir`3>j(Vvh)Yi$2vC1&&^?hPv>;=PE)ZVSX$iA7OjqJLg9C;mLqYxktmbPTYRN
z;N?-|DG64!Wxq_WNtqOapw_ttbL!`-tzzQs$+QF)WPd0VgutiG5R-iOn{sy-WF9j>
zc7y2GZp8Zf<s9XZ=Hm$pNJHHg)snw_k@!)~0v+sN3{nEF8+P6+5qKJM142b5Z?Gg1
zFwmE74t{|vO%yX-F%g<k;~VQZhY|RCSY1}<=@@`7ZF;z;^?D)hGjK*tgnw)OxhhJZ
z0a{+X*HXOY4+85iZ_N1u$e$$FV=mQyc4GjZ<*It^u0IWM&v(aaK~~aj8Tc`B+Q-Cn
zWG|GBOe38-CS<CV<~y&7hs>vo)CD`lU@r7z#pmr{Jdw!C;pQVavjU?`KoP;HrGiAo
zRRbC%xWnq5xf8Qy7Z`~C&nwB&ji<y55Ki=~nXgsLJr#ZubE~QT2^lv<0Ke3%PC}27
z`Y0=(&k@8}t_<1)((Eb`mOrUVKS@fp2Cfi#a_H~Ar_caP+{!L+$`#CW(%3aL%*2>q
zz6>R-wb1AFv64QTtgdwszy!VkM1VO|l$U3A-J?EGb)`FpBb=_ay$%YRAF5<7AF5!3
zE0|W5+@i$JHdQH=o{!U9{@MY|iHfqr_XwxYNa7o8wM_Wm!IVu_`3qG*%=^Onmyd;t
z1#mhy6o57SObIyR!#YENSbZQ;#&$8O9-f{5;qwQoC{LR@BdZ5w50fYZLcr}EBVRy4
znWJ6mbyDBs1F8?z)S*GlYLeUbktpDROdf;2?|wofAK~SI9Ic%*5vW-by_S-_0Fu%%
zF7Dd<zt7k@EO5r0cn7|oZvKKm3H_s;;jf>m0WZT{n48+cP0sYuw!>)2&`>{>yJbsZ
zR`W6XuCoO-HF*VCL|Ajl{}n=SmTQN;1FnW3>Cn+93~W2V`ZBreCcpPqAAV-2If)Lz
zpRuc}0=n1w4JTRB+ro4x+pH{slz>P8Ff))7DZm=~sQC4AYReNtrN}jd%^eMqjfA8M
ztW$uvrTGOA0r@9&tmg+BV(Jg(1I&->k*n2yH5}7%EX5r}fj54sx3azfNx{YDWFOl<
z`6#te8!=<ppS2Z`A_(Rmd?8!1F?#*cA)(v914A}1!wYy*8h7&;WN|rMTMoB5{-PZ=
z1u19BM1Y9xj1Z{vq{GfK{^8&5{rMmyfeIr7^6)RbFR<QlA7X48nrCJo*<#!GxyQpG
ze+vcffcG`8@qorNLqo<9Z7HhtAXH*lWIP8@OV~8uAg=Tpf`(Tgmwv3n!DFBx8MU#D
zNB#T%B;OGMU^#8(^Zuj)(4S&oys81tt?~@JQ9H=b|HTfM({rGW;qhy8`ki!(k;e#W
zNPO|R3@}CfkMXJ72%5YPQd#L3Bk|dsJv9#9&TGXPEEW`&@Ff8ReW1x|&_n%`oeIwS
zxMD#wmU~?Q#ExG6Wk>7Okl>5qczZc^3SKt<O<F|0or>KLlmZ%SbC*kJ^*}wN^B7q6
zT+Ex~gG~%y&EihRj)2qz*3DenF2$zKd}hUG$SN7v)luU68Ad7zxfcpG+Z%fA)uc^A
zpVu^T1_Q-d3cZ$a|K)!?NPtWviT?$b)gz22O`Vy71exR1aRL1{{Ty+j;2<k}p?ji0
zE^jnf7gND;@|nK*hz}vn0|s|}#*kH8D1;wjVVSyFXhYN{$EeLZ&Ak7pl+37C3AA@i
zfRTYVZ~w}!q5@lf78cA4q#wnPl<9_XARAI%F1<qtbQ_-u7|CX#>}|8i^Zd<0se;I;
zu)kc;0BU1^=4*=>3sAyu+47!2sn8K#_d0}g3Rl=kiP@rYIu%-I!!b7O;y$F7BcriM
zj?*Z9f(}UT)8W;t6iT)j8?<%CAgZ*zoFnw-_};{(Tvpg_cuEmS_tFOxa2CoRZoRur
zJgRNPoLh_P|6Us*a0&j1t@k|jeZyti@cJr%*h`}bI_(qR0U)O~nuPvx<`yX$6Js)N
z`W)h&lE)d&qrWFM?%Mu1fZ>~xi6spI9Es1rTeX=QB1w<1fE5lXDohV82xxb>aor}1
zWnrk=3vWWAi0>Mb1{%59no@*)99Hp?rWv7tZv$G-M}wDJ{`Rvw7FAnEB&)S<Fd9D(
zmdl;bv$Ufzk*}WRz4U)3L=M}qGf-s=qxYv>Uxz`wU?Ff{$(>Od6=WxiBhHc5@}eQ5
zi}Mv-BMK0cvLm+3!p@rz5j;J@xlt8XS>v*h8>n5EfwbYBESPW2=Bh#}IBv47Dw!8P
zZKl>YBr<Vc-RqJLt-PEzHZf}9e2Z;I>?_<v{mK;uWa_xUYOJou_$4@Q_6eAm4o2tu
zG`C(+9e;rPXF=a=GHm)DHs+m@`6;P<uPh!j*K0=OGgqH|T%2P<5V_r+E7_s9yF(59
z#9v&hFJPc7#PQ{d8VVo`SK@yLCW9P^qXa#~51PwMZ7WBc%sB9dF&kD#Ut(^Yhr@-4
zi=`V_*&M#N5Gq$y#HOC9ot}%5o;nmCbz;oDC&(?Gegvm>dmu7BXGrf`H(Oay7(wIS
zz6mRv8r@rMi6U@8H+$Pq8yQ(xBtIL<?&T}h+r;FJ7xTKP1vM#R5RsAsUNW=630n=)
zg=tXK#VYIktX>z7r*Hd8?Gl(clbJHDWd}fL8kV|u_IM%Ylzfl=LVh?P$PX%>joJus
zMs$re_<g{m5FY8Oa^-Fy37TgJwS1rLtRJPn0XZ8*DE=}T$Viyp4gO6$Sm;2nQImcT
z{p*19qfq_Cmyu6O!u(w%Z({mAk<Sst$i=cK1F4R3$k7@3DI`}f3y-Yl8}YZSeXV}R
znF+UsH^l*oH>ULkiGX7uTh+vQY|w0ncf`7WJ`klaOj*}4F+Qh7i4RQgnsaeg1=^b>
zym<Ien0P)&3hDQ+y#)N&Qz|r1<c;!!5y!IYxT1jj-bzG!b#UY)pccp12*iZxWbRA1
z+0|9vge<vyP5JD&##JmUWJm(c^O~wcUmYK;BwEM%iJS;TZW`xa9N35?GQ@;}14|k^
z4Im}&W9UUVu+$vu8mrm_98t6I%56P3VaKdO8z|#)s#Z2wM^$x?Z;-+w#QA7y-t%)T
z(oBs@<b9K%Ba{bRjTxETFL|yI+QTT{fUR+9i1t=fh-&IcJg3)3Cj?_I!YlG>pli6p
z=8L6I!X3u-IHty&7vYbMN^S%Qy1)=f-9NmY;kV=5z*nbaI1l4;62%m9>X%7A2#!$M
zT%V$4l6r=t@U&knxmI$fi}LE1l9kikd+glemAK9IxD|QZ#W^oBP@CiJ;t>ohFKHG%
zpUir@QQDXpP0%9e!G4h6jvL3R9`4(Q@{bDUU(L&6;*cdvC8m8Ab-w0-!+HF;9=`>?
zAJrEE79X*#tFuaSYLekGk&Ev2livdB7KU@p1@<em=>F?ALpZ%cei<+WvB{YKBSsXk
zK?9HqU$Xp~umPCuYL$=D=ZZL46Im{Yh;@xjvN%~%o7=WIzR+{t9)kff0c#ZcPMfGI
zd-eT`AeD754bcD<SyY|%NYoA)rbb04QTgM7qt-0q_C$}YlVkhV{dRxBd}+z7K-||+
zw>s|uC`>)oxZ&L9+0HBTcRks$nB3*ztvq0DRR&JSCjKb1Y+mF}$na;bKFl+Ub3&}4
z`Np=C_T!GARAl^Cn#TN`%&DY&=7ywP0>BAM_3{Mp1uoPeT;LvEIR@QI1W>D0@NG`p
z)hRM1p7sX+?Lh9xTD-z}4*`O@7qcPucz)(IfqU}mSl&~w)A*4rSvi@PZEI^L=svy{
z4IykZRA}tBSQ!LoiXzK8y1bqRzp%ejm5)N*tUFHw@k4p{`94k-=JmG2?1DrEs*l6r
zw^2Lx#HvXXP5G0h>_&?-^8G31T;r6PONu>xX_|L}s;+6|+m@^#QW}Dye$u3N^Vh0^
z9^dQ*Mx`3RGnbf_-(ca#g!8vpR88gV0Ch(yK%PnC@DU(p?MPZDLNQdT{g}&j6HLWn
z-w|Fi;1;f=Bm|HF+K2XQtooNA`O-`kF}CPx87i4x>UFz^w;>bvF;uyt{F^wfp$Cn9
zD$vxRC*%QZln);9oe@shrw8})*tK^Aete|t4kIWM(z?_cYo9uzx*YmLFp5e=WM`%T
zj1QaEF_`>nAhO4veAGrNLDA(q{@C?V8e2KLKCa!<jGf}Ff74FCpaVfrReA$Q?_ZRc
zt&frR%4*7z1FqFgXZz|;(QoWJ>99GTH}xx})Xeclan+ATf2Vg|kzPn90)pch!k00d
zC>+ngqjV*<%Wo+Rx|$F4GNy4jfVr5BW>R-%f68Tjddssle6RKBS(}|{8B#c3<MkB_
zW@)_uJ8u4NSH}J#6XUf8mRu52`V*GZL9H@o99tHWoYP&4jH9hw<6NW9*mPo8iQoxb
z&f#JTwUh0axzpwarE8N<YrYLGNZ@lu6;Cdq;~!@Fl4M;X0#pI^l`JV!+w>WN!8Y0T
z^B~%k%yIiAH!WL)BA=znHYwflxI8mcLdU?(S~eQ)2!y0qvop`=FXv=^JBDPd$&ws{
zThCqkog9$uz9-5;?V%@>xHpInc{|j)TxRvj%`cmNv0Mo(?-L5#?-I?49T=lMc-2rq
zS>sI+rSn#R%n7IS&xX$taCIOsD#vy=D)&2cgv`n*f+9}E9HVY+rCF($ym1c-9owWo
zgvTO@e_%a9W(DpLq@(o-oOVSDzz-J_wo*HR1MWcWGE?n0OD6``qOq|wX!u4ig@T@J
z&&`i1F)J_)m1;x{PWQp*dY=*!u7Bvsob2b+>ra?1@334SRb?}4Y?2uJ&{Rjfa<l`4
z)!u7ik=1i<x5Rq2PvP857M#~tYfN1->iQgN&PQa}(WZ^Jvg$J;Hd8(wdu?h%QUN$;
zNeiq#wp4r6`)G!y_%jQZ%Mywk;}f^(b}BWiE`#Z&v2O3`XM_AN-S-L>>`JF~h1h}4
zL3=~k^ipUE@*5xf5LI4Am<^Q-OEnlqH#;hTbeE@b#+NXSr^mf{u@s*$H7(x^`&WUu
z4FTbjf&jQy?aNaw-qI}svk}&smM;$x%H$P1k>#JKe)62DNu{2I0_8p+7(wLre6(BH
zsG!{!S${>yNb}a=g>Rr%2&@JE_n>1u+^&=n?F|&4Z9|@mUal265$spvIpT`Y$9XsD
z2bhVaYAE{xx*{(Htl4)0;76yvYGdB#mlvC}WA5g%k7X;zBYx1;ez{xz<W+h&G?Fwq
zIodN!gU1|fo7LhNW7%j;HUM#LK4<g#t$fIi;bT1s&RP3HgY=}nQUZE@v<mB0l!#6(
zzO=NMAXo0z!*15=r_&dUs)W?3K3{PXLWKE>YNp4<vR5^?f?ov=eEjbF?eQz*tH!{O
zPMg8y=9SoXle<gj`grc4qE^Bdy*%w>5Je!WVXKIPqMG(BL)OAwfj{xf*SCas1X2qC
zvUrw4+45Kq!gO#bYBcZMGbTa2Hu2nnaaW^D-RwrZDwV*`k`RUkn?lDs9>uF|y9Gy?
z43E$56=qULs5!G}`@eYfpi6iNHzX}=6KBRO6{Wu3gX(ql@%v(icktJ)!rfAQW8&Tc
zFE4@}@P-9TGg|sD(??O${0<Rtc8LaqP0*<@&QERJv9zICF<*!nTbF6!4o?pA*aeu`
zFJXW_gx$V;zv?DWIJPs4#`LJVIlw@2f7Nj$&wbhlPghkt9~lp?>3Z@IS=t9HmE&xV
zt=5}lSnK2+OO3@ve?<cyBaF(Ycp%Wal;?*ENT`YFoKFdBf#O-Xn3(JaPr!a=0lK(^
z+Q10^lk2Ks<H6LRolp>*(P^`7eW%%t&w$AKC-jK)7p<DVv;ZU~R?ZW)(ozCP`u-x3
zufGLKU)Ut#J6^T1#@)mkp9Xl7M%nYL^Y)zAPP{5vlee+roM2LQHf5;y(q+*oy9YG3
zV2M-<J?D2VWNKv<Gez7M1d`=zrcgZYQN}W9zqY2`cP4(QzM_G+JOCSXYIbW^m)=iv
z*Zpn5PRaI*^n)8e|N6vJ`dAhA_!E@$0}T@0Ay#)B<66l9RR)8c{oR7@;ZSWd@)y3!
zGm~AEl{xX6opz1}b8lT9U6<tgDmxN@B@Y^II#~-r_P$uUt2igA$kmF3aYWV{g=bf;
zm8!~}$Qs1F1&OKx0kCZV=KCJf+zqbF?|BnMWj`$$X7Ur4B7O5eHi5P&0RXd&FKBd7
zzMIwUKAyv}ba=y>dd1?Rin%tjpyFgt_NW}T{VaUNRs^oR&gJR+RDVW*zfNEp1BOPG
zh&T?@ATaMMEvS>0*JH02LKQAFdrE8n0HgK^zJxLBrtnw?!BoJko*jmJD?)dgSYoA)
zEqZ+eKT?hhP?H!)`^~i41g))OIpP`#K+yp?>6#p)-YF;9*1AqY_pv86l|4OSWA-}5
zMH}9EbUZG$%Pusy3{y}#NG`;ij<3IQaJOHopU1B5xNjmyt80;_IH2a6C7QI<PxTgi
zWK-N+X^6GmNyj`UGZrg(bRMOa^Y6COkNzZSKJ5=6iQX3&8q1FwXL3Lm1u)(G9Gy^t
zVS?D=Qt|Bt5!Dhn!G$Vizvlg<D8)&EF{Fp@J0?-}wDV0QLk=V522F5%(q;v21DBA8
zT8waowO^iYSfGGzla$DwBa?Fw(}z#Sq-DlCcUrRVB?q2*PYjWAy|FOBT2K<~C&fq~
zLZ<>FwRmqJQrqTQf1{bQJ<-_V)L~P&pvAGJqMR~!xy3EYIfRh-mdfbcqw(Ms(*qqi
z(L(|fd0An`ERrV{uAx;R08|x&v9xRVE3$UNkx9*kAM(F(W5i2jCN{^#AmP-{XQ4#A
z{lI)adqD>pMtr9-=&vEuceD_o=tC&$CM1C+{F%TagL{kBXYoGZ`-~I^yt-lYN0=iX
zQQ%k_YNPU9pBA)2<EZQ1OE^5cmX&;kfDeZ8-!tZGtf<LP#MfLyEKJqeJSL)*AVNq8
z<r6$~E^OR@v#<NUS&5SXg%h~b={EQ|9*WHi<j4Y69NH2Y9l5P<3}lLQt_bSt^Ug8}
z#Ma|a9s`+XS3n55{j&BlSu{Zw-)nD4;d*v(ZCMo1n4)e=gWD}zF*~lwb0`VJNNJ-D
z->Q(UC9@%{*-6<1FFhp4PZOZ(9SUO+cRX1Xc0xY*vy6ZKEd;3J@%LFY-fOnT2wOxd
zQBdZ%ofF{Jr+8CEpo7z4eO@C+go{~$z=Q8NPXQsM%g-6J&n(6&4|DYJoCET677U;F
z0V6Ci+9ft*ZVvZ}1MmcgsNU_9j@?|qF<w=NPUq!ir{(w%hOr*44W@)w0SX}4&%OkQ
z;5w#h&ykLnSUoJCuu_tmlk*c1BSa?GwM2_vXSjvu9_8R;`h<sPUsf>;Q3?@#^X!fB
zxn4B9>Yqv>R3$$C<%spU?VGz;n?RE!chy}S-fz<KLw$Jq_rn~xysrVMD}Q}&GEiow
z3LVv_{Tz*ibSW$6>RHnOt+0=$9jPT?inUH`lxq+<SL`sVj$viUMj1Db{C7%|pipm}
zo4rqcWyK{v6~)qg?6rKjozfy74TztGklJgdc=NODlM09XwFxlFNl%Eti|+tRC}41j
zR&#hWLlX4kh9goP*MN?O$N(WCHa`bzF+D!-riZBOt*!^A(wZ(tJ;f5)tH~DtO!OFs
z9`{XSL{dTx28d1ET$v*PKc3&&5-RGd7i!Gz3qTKcwA;N3C^Htt%lIrff_nOl7a)E?
z<-0Qc$>SP41zPsN{BHh#jG^?g4Fi4E3q3W)f@wL)4933g{ERS^MV4tHm!|<MZ~OU3
z^>Ox+Iq_~U;kpf1+MROqEmBrj5kSVqbMK(AnOR~;N|)d?KsC8mSH(Gj4eH9mDkgC`
zksv>!gXmBCBtxwW<YkxH9%wjYE%10_$OHm_^sG2zP<@0lOSg%&Hkuw$$1wM4XU0%<
zm$LY63DCa4e#27a72EP)4%K-rN(Rt=%o2v)upMsjdRQ};OYj$W?}7%>WKsP;m?uYT
zc|1#&8u8(H6CyIOY=CJHV{Q&~?@Vjx|EF2pYcIee7E1g77?1%VH!2Ljk-5&at(Rh~
zM%zKr)^F&@{un#DYyYfcLfnT<%%8Fgf6g>O{W<ncj3NCIxf{Y?&QxJ~`uGoY;KwM*
zmu28#^yd$ZS^z93UFr9P9>3Rb!HYkiefAmvvIw4U$OHG(7(M@+x&b-=NFtDgKGfdu
z@{jrJ|Ha(*%AJ-0^8b~w?|%TcX!9w$=l@>5d-ua2w9I9=ba+XCq@n%0>_CRcF8Rxb
zf3z3AJp>Md%e!<%4`2ww<4^L?T@U}=Yck0B7nx4k5&dWW`hPL^9clBEd;Nc5?E9DA
z3NM{@jb6*Uzo3J=eHN1d_AQJyn27@**7^Q3WzS&P`RCBn&#iuk2svT*L)D=@krN*M
z?a1#IB?X{c3y~Rps-Oi@=${fP|C_n*Uu~KH8)M%P;rF}IFYk>=_=ms6^?r}8(Xj&i
zCf4wJ`a3Y!NdC{1{ZR4?xIX~FUp*u)2pJVd$O#?Lc*p*$Nd2)W??VA|O-aX_Zumz`
z;eR9I@C%;$LjdO25Eo>d{*N>q{%g$tHD=(@{MVR&Pgwoen12MJdyoHrj?8E7C;bn&
ze3y2B3&UAnynheHYx$N!&M@ax1GpAeG)Lww=H?u4z0}*cZymR)RGz<hjpj|ccW4^j
z^K~}S)LPh_ws9dWzpuaF#lXI+pQ~}rL$j5TPWMl~#t+B-7z^;~4?ezJe*z>J|3rEy
zwaOIU{|w$dK-dd;zW2Pq>Ef&Rw!$GqX=N1{cN$98LjR9c=pNJ+1W_XhKB9u?+I;?-
z=mL58U?LC~jU=acoT-7hH$HZ!s1tIsgR1(UvNm6CfZr{aB-pe8$(T$j00L}ofNI(0
z5xMb`|A;<F5Fwx9Nkk-nC8&=8tOxl8Gu~v=CKu!U!pzUvh9cO^h2n)CyuayWo)Asa
zrU_Dy+>pPtSES0M5q^P$@1A+A;Pe>rNtat0o~F!_lTh?h;hg-eMBfzv1&Vgk?(iBo
zecV_b(!sj|I(R1=vZFs#%I-mJgOfE)sHv43`?61hd!aVRINQy|U%UQ%hcDs48)PbR
z>;VPcD;!)%580z%D7mmKyyEH##5g`0&BSfKPA7uP*?y#CVqaLjpxm)>z1J{M9Qa$;
zz+({T-V3dt6afvYt<4{!{p%;(%0D#A?mb}h_}IR4G)I7wW2sWmFjJg3Q~-xpYVuKs
zU5XNu<5g03-e$mJ;8Z;(UcKnRYxDr?pNUU$3xqqSwN9;}l!Ox!rl$f3Wt{`bB~@A*
z?9W4@Df)n$iXxTRaV66($oFZQ&FKIW=Xh+wsq1H7jDi_sw4q7^+&&f~B@^G4>Ysmu
z#BjGw=>KdJ(jwG>KBq+aISxm~OSV^GPLjYh#eO6{(00pMw#5Ir6O(bkQl0E_Ta-`y
zd1f6z-oGa1k=UT-^olzL-ItwBrEGOs`V#Tayi0+bf%pR-{`lui5T1i8n<Vf(%6X2!
ztt`@qfF#vqmZY@o&zNXP?opEasOEc&qq?N~ZmJb79^+RN{5%-o?mv;I=RbCB8zQ*r
z#|ho!Euh(XcfMapBp+oF81<aacjcGMidIfcJexuCXVGeU^y?VCrUdfaVUc${E;WB_
z6Vlt~xp&*NBlc}G3R6}_m1x%GYp{L8OPUFMsBv_KVa~mR^l7KH^URBn;3W&F$KdHS
zOiTE?m-UbWSYzI<PBM_M>8Swpwf_1TL(vC_?j^C~nDW+8-V5PaI75+9yi<7m--cP?
za`H=>HZ}urBg#{Xhb95J0#t0%Us<anP<uGEEx93iBEKb>{L%IOCZRcdeJa%wNeu-M
zGH|wka~%vJ>7jBz&E&x7pPK^ZOq=QkS@J<HsMVr*Fk(aFaMdJbl(=D%-y#JMkLEb0
z$;QA6F;tU~lr0R!{X1LMgz!%%)6=SA0XH+M+y_xNiUs5jTDe?(V<GwVYZVlhrQ%!v
zTS|%OQ9p#F!BT444<%mSUsCH{*6huqg98BgG&PV%{>K6KOau-LM(tx@uf7E1K^zqu
zxkm+t|8k#Ge8t2#ioko>@eD;<nQp^hx(K#hkh;q}X$y>8Qt0-BZeo6$c1NYq{P0C1
zuX0fAB$XW26Pa>(JE^h&8YJlw!)F3V@l?uSXXX?5NTQ6Jq3lOunmhujkGS|=|G(}|
z7WYMw^wm(U-Y|Wwe%VTflsyu%p$TwLuMOP#<%bVoKT-sVlqC{vQ)ubaG>RVwxB%i?
z1swjdok3yPGC*`7Ok1Gzr%So}$3(WD-u>m$Y%d9@@0gdA5bNWmEIX(u2Sla}Qy71m
z<sd-)Lca8eay92SE?9-g$MpfyW!gzx0^*PdCsRYtZ=|hP<u<T{P!>JXuYOq!WNe%2
z!0UIY@sI%M`ymq3`@h$<j2`%vX)H?^j3OL?&YFum@rz*(y!WDzHr8t-fCxe4&6bvs
z2k2C=KkQifv46at5QE<UL*9sb1`t3S_@7_M6rhk+T1fqPACGSk6K}hLM83~b-TkOC
zdT^Lh*A-@?#Go)hX2ORM^l-R&6CNj<#Qh=T=%|!wlBsWBH{laF6T2z+m6bBHIaLuX
zHvd!^S@9l9jXG~^3JNl<v&X(dLUesg1N}SY<#H8<$c*E1IC=v1JDUSW2^5lMS}!7K
zRd_@8eb9QANOPS}CC1z+0}9B=l4HNB;>YO$H+@N1xn4>uiTOtm)~%W?(`&TrBsGJ`
zjE)SS_ywNCHWI_|@z4<t1RoIl1*}P51*f3JgpZ=2vHaF#eEtsDH`wRB&nZRz5e5Ym
zM068AZk`cINsqj~txO&5oZ#k+yvS<1<mi}x3Y<%_tYlvb6C6V+eGYgr$>i_jk{N^J
zzHAo(TO17*iknjfenxgTZ%RK@$d8V^zfsFEaS1oVcehuVFw1IGjF6HyOOsYOZT-?1
zcOi?&zDE94L6kF8xuYP(iv7CO2`&Oq+viB8oJt{>R-tS5Hf*{m2v?C40F|QTXx!Ud
zIl*-&UMVljOb$H|H6|l|5&H31<f);1Wrxxe=q4ev7J&6VFtm8UhTXPAPRUro`RRTk
z^qnIZgayu;c9O)ze@4}Cp}DLZb$R2f>zOP;DtI7Nu6y4T)1*^%Bvr32j`!`}JlosE
zTEZhGp{N_1T$x>6BW??yW{kbnXTIg4I(#X5&~0RDuedo@zcRnix8hnlHmD-~ns|Vc
z@w>BvwkbcQ$P49I4KU>)rJ-(8>%0Di@?04%33H34&YEVCM1m>(x{koz5ys~>AzZOo
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

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-f2.png b/0.10.0/architecture/rfcs/0009-defaults-and-overrides-assets/example-f2.png
deleted file mode 100644
index 2e41bbaa70273561b27ff8bbe21aa37f42d96536..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 276483
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%0D#A?mb}h_}IR4G)I7wW2sWmFjJg3Q~-xpYVuKs
zU5XNu<5g03-e$mJ;8Z;(UcKnRYxDr?pNUU$3xqqSwN9;}l!Ox!rl$f3Wt{`bB~@A*
z?9W4@Df)n$iXxTRaV66($oFZQ&FKIW=Xh+wsq1H7jDi_sw4q7^+&&f~B@^G4>Ysmu
z#BjGw=>KdJ(jwG>KBq+aISxm~OSV^GPLjYh#eO6{(00pMw#5Ir6O(bkQl0E_Ta-`y
zd1f6z-oGa1k=UT-^olzL-ItwBrEGOs`V#Tayi0+bf%pR-{`lui5T1i8n<Vf(%6X2!
ztt`@qfF#vqmZY@o&zNXP?opEasOEc&qq?N~ZmJb79^+RN{5%-o?mv;I=RbCB8zQ*r
z#|ho!Euh(XcfMapBp+oF81<aacjcGMidIfcJexuCXVGeU^y?VCrUdfaVUc${E;WB_
z6Vlt~xp&*NBlc}G3R6}_m1x%GYp{L8OPUFMsBv_KVa~mR^l7KH^URBn;3W&F$KdHS
zOiTE?m-UbWSYzI<PBM_M>8Swpwf_1TL(vC_?j^C~nDW+8-V5PaI75+9yi<7m--cP?
za`H=>HZ}urBg#{Xhb95J0#t0%Us<anP<uGEEx93iBEKb>{L%IOCZRcdeJa%wNeu-M
zGH|wka~%vJ>7jBz&E&x7pPK^ZOq=QkS@J<HsMVr*Fk(aFaMdJbl(=D%-y#JMkLEb0
z$;QA6F;tU~lr0R!{X1LMgz!%%)6=SA0XH+M+y_xNiUs5jTDe?(V<GwVYZVlhrQ%!v
zTS|%OQ9p#F!BT444<%mSUsCH{*6huqg98BgG&PV%{>K6KOau-LM(tx@uf7E1K^zqu
zxkm+t|8k#Ge8t2#ioko>@eD;<nQp^hx(K#hkh;q}X$y>8Qt0-BZeo6$c1NYq{P0C1
zuX0fAB$XW26Pa>(JE^h&8YJlw!)F3V@l?uSXXX?5NTQ6Jq3lOunmhujkGS|=|G(}|
z7WYMw^wm(U-Y|Wwe%VTflsyu%p$TwLuMOP#<%bVoKT-sVlqC{vQ)ubaG>RVwxB%i?
z1swjdok3yPGC*`7Ok1Gzr%So}$3(WD-u>m$Y%d9@@0gdA5bNWmEIX(u2Sla}Qy71m
z<sd-)Lca8eay92SE?9-g$MpfyW!gzx0^*PdCsRYtZ=|hP<u<T{P!>JXuYOq!WNe%2
z!0UIY@sI%M`ymq3`@h$<j2`%vX)H?^j3OL?&YFum@rz*(y!WDzHr8t-fCxe4&6bvs
z2k2C=KkQifv46at5QE<UL*9sb1`t3S_@7_M6rhk+T1fqPACGSk6K}hLM83~b-TkOC
zdT^Lh*A-@?#Go)hX2ORM^l-R&6CNj<#Qh=T=%|!wlBsWBH{laF6T2z+m6bBHIaLuX
zHvd!^S@9l9jXG~^3JNl<v&X(dLUesg1N}SY<#H8<$c*E1IC=v1JDUSW2^5lMS}!7K
zRd_@8eb9QANOPS}CC1z+0}9B=l4HNB;>YO$H+@N1xn4>uiTOtm)~%W?(`&TrBsGJ`
zjE)SS_ywNCHWI_|@z4<t1RoIl1*}P51*f3JgpZ=2vHaF#eEtsDH`wRB&nZRz5e5Ym
zM068AZk`cINsqj~txO&5oZ#k+yvS<1<mi}x3Y<%_tYlvb6C6V+eGYgr$>i_jk{N^J
zzHAo(TO17*iknjfenxgTZ%RK@$d8V^zfsFEaS1oVcehuVFw1IGjF6HyOOsYOZT-?1
zcOi?&zDE94L6kF8xuYP(iv7CO2`&Oq+viB8oJt{>R-tS5Hf*{m2v?C40F|QTXx!Ud
zIl*-&UMVljOb$H|H6|l|5&H31<f);1Wrxxe=q4ev7J&6VFtm8UhTXPAPRUro`RRTk
z^qnIZgayu;c9O)ze@4}Cp}DLZb$R2f>zOP;DtI7Nu6y4T)1*^%Bvr32j`!`}JlosE
zTEZhGp{N_1T$x>6BW??yW{kbnXTIg4I(#X5&~0RDuedo@zcRnix8hnlHmD-~ns|Vc
z@w>BvwkbcQ$P49I4KU>)rJ-(8>%0Di@?04%33H34&YEVCM1m>(x{koz5ys~>AzZOo
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

diff --git a/0.10.0/architecture/rfcs/0009-defaults-and-overrides/index.html b/0.10.0/architecture/rfcs/0009-defaults-and-overrides/index.html
deleted file mode 100644
index 665ef9aa4..000000000
--- a/0.10.0/architecture/rfcs/0009-defaults-and-overrides/index.html
+++ /dev/null
@@ -1,4297 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0009-defaults-and-overrides/">
-      
-      
-        <link rel="prev" href="../0008-kuadrant-release-process/">
-      
-      
-        <link rel="next" href="../0010-gateway-api-metrics-exporter/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0009: Defaults & Overrides - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#defaults-overrides" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0009: Defaults & Overrides
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0009-defaults-and-overrides.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="defaults-overrides">Defaults &amp; Overrides<a class="headerlink" href="#defaults-overrides" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>defaults-and-overrides</code></li>
-<li>Start Date: 2024-02-15</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/58">Kuadrant/architecture#58</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/kuadrant-operator/issues/431">Kuadrant/kuadrant-operator#431</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>This is a proposal for extending the Kuadrant Policy APIs to fully support use cases of <strong>Defaults &amp; Overrides (D/O)</strong> for <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#inherited-policy-attachment-its-all-about-the-defaults-and-overrides">Inherited Policies</a>, including the base use cases of <em>full default</em> and <em>full override</em>, and more specific nuances that involve merging individual policy rules (as defaults or overrides), declaring constraints and unsetting defaults.</p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>As of Kuadrant Operator <a href="https://github.com/Kuadrant/kuadrant-operator/releases/tag/v0.6.0">v0.6.0</a>, Kuadrant policy resources that have hierarchical effect across the tree of network objects (Gateway, HTTPRoute), or what is known as <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#inherited-policy-attachment-its-all-about-the-defaults-and-overrides">Inherited Policies</a>, provide only <em>limited support for setting defaults</em> and <em>no support for overrides</em> at all.</p>
-<p>The above is notably the case of the AuthPolicy and the RateLimitPolicy v1beta2 APIs, shipped with the aforementioned version of Kuadrant. These kinds of policies can be attached to Gateways or to HTTPRoutes, with cascading effects through the hierarchy that result in one <em>effective policy</em> per gateway-route combination. This effective policy is either the policy attached to the Gateway or, if present, the one attached to the HTTRoute, thus conforming with a strict case of <em>implicit defaults set at the level of the gateway</em>.</p>
-<p>Enhancing the Kuadrant Inherited Policy CRDs, so the corresponding policy instances can declare <code>defaults</code> and <code>overrides</code> stanzas, is imperative:</p>
-<ol>
-<li>to provide full support for D/O along the lines proposed by <a href="https://gateway-api.sigs.k8s.io/geps/gep-713">GEP-713</a> (to be superseded by <a href="https://github.com/kubernetes-sigs/gateway-api/pull/2813">GEP-2649</a><sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup>) of the Kubernetes Gateway API special group (base use cases);</li>
-<li>to extend D/O support to other derivative cases, learnt to be just as important for platform engineers and app developers who require more granular policy interaction on top of the base cases;</li>
-<li>to support more sophisticated hierarchies with other kinds of network objects and/or multiples policies targetting at the same level of the hierarchy (possibly, in the future.)</li>
-</ol>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<h2 id="conceptualization-and-user-story">Conceptualization and User story<a class="headerlink" href="#conceptualization-and-user-story" title="Permanent link">&para;</a></h2>
-<p>The base use cases for Defaults &amp; Overrides (D/O) are:</p>
-<ul>
-<li><strong>Defaults (D):</strong> policies declared lower in the hierarchy supersede ones set (as "defaults") at a higher level, or <em>"more specific beats less specific"</em></li>
-<li><strong>Overrides (O):</strong> policies declared higher in the hierarchy (as "overrides") supersede ones set at the lower levels, or <em>"less specific beats more specific"</em></li>
-</ul>
-<p>The base cases are expanded with the following additional derivative cases and concepts:</p>
-<ul>
-<li><strong>Merged defaults (DR):</strong> "higher" default policy rules that are merged into more specific "lower" policies (as opposed to an atomic less specific set of rules that is activated only when another more specific one is absent)</li>
-<li><strong>Merged overrides (OR):</strong> "higher" override policy rules that are merged into more specific "lower" policies (as opposed to an atomic less specific set of rules that is activated fully replacing another more specific one that is present)</li>
-<li><strong>Constraints (C):</strong> specialization of an override that, rather than declaring concrete values, specify higher level constraints (e.g., min value, max value, enums) for lower level values, with the semantics of "clipping" lower level values so they are enforced, in an override fashion, to be the boundaries dictated by the constraints; typically employed for constraining numeric values and regular patterns (e.g. limited sets)</li>
-<li><strong>Unsetting (U):</strong> specialization that completes a merge default use case by allowing lower level policies to disable ("unset") individual defaults set a higher level (as opposed to superseding those defaults with actual, more specific, policy rules with proper meaning)</li>
-</ul>
-<p>Together, these concepts relate to solve the following user stories:</p>
-<table>
-<thead>
-<tr>
-<th>User story</th>
-<th style="text-align: center;">Group</th>
-<th>Unique ID</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>As a Platform Engineer, when configuring a Gateway, I want to set a default policy for all routes linked to my Gateway, that can be fully replaced with more specific ones(*).</td>
-<td style="text-align: center;">D</td>
-<td><strong>gateway-default-policy</strong></td>
-</tr>
-<tr>
-<td>As a Platform Engineer, when configuring a Gateway, I want to set default policy rules (parts of a policy) for all routes linked to my Gateway, that can be individually replaced and/or expanded by more specific rules(*).</td>
-<td style="text-align: center;">DR</td>
-<td><strong>gateway-default-policy-rule</strong></td>
-</tr>
-<tr>
-<td>As a Platform Engineer, when defining a policy that configures a Gateway, I want to set constraints (e.g. minimum/maximum value, enumerated options, etc) for more specific policy rules that are declared(*) with the purpose of replacing the defaults I set for the routes linked to my Gateway.</td>
-<td style="text-align: center;">C</td>
-<td><strong>policy-constraints</strong></td>
-</tr>
-<tr>
-<td>As a Platform Engineer, when configuring a Gateway, I want to set a policy for all routes linked to my Gateway, that cannot be replaced nor expanded by more specific ones(*).</td>
-<td style="text-align: center;">O</td>
-<td><strong>gateway-override-policy</strong></td>
-</tr>
-<tr>
-<td>As a Platform Engineer, when configuring a Gateway, I want to set policy rules (parts of a policy) for all routes linked to my Gateway, that cannot be individually replaced by more specific ones(*), but only expanded with additional more specific rules(*).</td>
-<td style="text-align: center;">OR</td>
-<td><strong>gateway-override-policy-rule</strong></td>
-</tr>
-<tr>
-<td>As an Application Developer, when managing an application, I want to set a policy for my application, that fully replaces any default policy that may exist for the application at the level of the Gateway, without having to know about the existence of the default policy.</td>
-<td style="text-align: center;">D</td>
-<td><strong>route-replace-policy</strong></td>
-</tr>
-<tr>
-<td>As an Application Developer, when managing an application, I want to expand a default set of policy rules set for my application at the level of the gateway, without having to refer to those existing rules by name.</td>
-<td style="text-align: center;">D/O</td>
-<td><strong>route-add-policy-rule</strong></td>
-</tr>
-<tr>
-<td>As an Application Developer, when managing an application, I want to unset an individual default rule set for my application at the level of the gateway.</td>
-<td style="text-align: center;">U</td>
-<td><strong>route-unset-policy-rule</strong></td>
-</tr>
-</tbody>
-</table>
-<p><sup>(*) declared in the past or in the future, by myself or any other authorized user.</sup></p>
-<p>The interactive nature of setting policies at levels in the hierarchy and by different personas, make that the following additional user stories arise. These are stories here grouped under the <strong>Observability (Ob)</strong> aspect of D/O, but referred to as well in relation to the <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#status-and-the-discoverability-problem">"Discoverability Problem"</a> described by Gateway API.</p>
-<table>
-<thead>
-<tr>
-<th>User story</th>
-<th style="text-align: center;">Group</th>
-<th>Unique ID</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>As one who has read access to Kuadrant policies, I want to view the effective policy enforced at the traffic routed to an application, considering all active defaults and overrides at different policies(*).</td>
-<td style="text-align: center;">Ob</td>
-<td><strong>view-effective-policy</strong></td>
-</tr>
-<tr>
-<td>As a Platform Engineer, I want to view all default policy rules that may have been replaced by more specific ones(*).</td>
-<td style="text-align: center;">Ob</td>
-<td><strong>view-policy-rule-status</strong></td>
-</tr>
-<tr>
-<td>As a Policy Manager, I want to view all gateways and/or routes whose traffic is subject to enforcement of a particular policy rule referred by name.</td>
-<td style="text-align: center;">Ob</td>
-<td><strong>view-policy-rule-reach</strong></td>
-</tr>
-</tbody>
-</table>
-<p><sup>(*) declared in the past or in the future, by myself or any other authorized user.</sup></p>
-<h2 id="writing-do-enabled-kuadrant-policies">Writing D/O-enabled Kuadrant Policies<a class="headerlink" href="#writing-do-enabled-kuadrant-policies" title="Permanent link">&para;</a></h2>
-<p>Writing a Kuadrant policy enabled for Defaults &amp; Overrides (D/O), to be attached to a network object, involves declaring the following fields at the first level of the spec:</p>
-<ul>
-<li><code>targetRef</code> (required): the reference to a hierarchical network object targeted by the policy, typed as a Gateway API <a href="https://pkg.go.dev/sigs.k8s.io/gateway-api/apis/v1alpha2#PolicyTargetReference"><code>PolicyTargetReference</code></a> or <a href="https://pkg.go.dev/sigs.k8s.io/gateway-api/apis/v1alpha2#PolicyTargetReferenceWithSectionName"><code>PolicyTargetReferenceWithSectionName</code></a> type</li>
-<li><code>defaults</code>: a block of <em>default</em> policy rules with further specification of a strategy (<em>atomic</em> set of rules or individual rules to be <em>merged</em> into lower policies), and optional conditions for applying the defaults down through the hierarchy</li>
-<li><code>overrides</code>: a block of <em>override</em> policy rules with further specification of a strategy (<em>atomic</em> set of rules or individual rules to be <em>merged</em> into lower policies), and optional conditions for applying the overrides down through the hierarchy</li>
-<li>the bare policy rules block without further qualification as a default or override set of rules – e.g. the <code>rules</code> field in a Kuadrant AuthPolicy, the <code>limits</code> field in a RateLimitPolicy.</li>
-</ul>
-<p>Between the following mutually exclusive options, either one or the other shall be used in a policy:</p>
-<ol>
-<li><code>defaults</code> and/or <code>overrides</code> blocks; or</li>
-<li>the bare set of policy rules (without further qualification as neither defaults nor overrides.)</li>
-</ol>
-<p>In case the bare set of policy rules is used, it is treated implicitly as a block of defaults.</p>
-<p>Supporting specifying the bare set of policy rules at the first level of the spec, alternatively to the <code>defaults</code> and <code>overrides</code> blocks, is a strategy that aims to provide:</p>
-<ol>
-<li>more natural usability, especially for those who write policies attached to the lowest level of the hierarchy supported; as well as</li>
-<li>backward compatibility for policies that did not support explicit D/O and later on have moved to doing so.</li>
-</ol>
-<h3 id="inherited-policies-that-declare-an-intent">Inherited Policies that <em>declare an intent</em><a class="headerlink" href="#inherited-policies-that-declare-an-intent" title="Permanent link">&para;</a></h3>
-<p>A policy that does not specify D/O fields (<code>defaults</code>, <code>overrides</code>) is a policy that <em>declares an intent</em>.</p>
-<p>One who writes a policy without specifying <code>defaults</code> or <code>overrides</code>, but only the bare set of policy rules, may feel like declaring a <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#direct-policy-attachment"><em>Direct Policy</em></a>.
-Depending on the state of other policies indirectly affecting the same object or not, the final outcome can be the same as writing a direct policy.
-This is especially true when the policy that declares the intent targets an object whose kind is the lowest kind accepted by Kuadrant in the hierarchy of network resources, and there are no other policies with lower precedence.</p>
-<p>Nevertheless, because other policies can affect the final behavior of the target (e.g. by injecting defaults, by overriding rules, by adding more definitions beneath), policies that simply declare an intent, conceptually, are still Inherited Policies.</p>
-<p>Compared to the inherited policy that misses D/O blocks, these other policies affecting the behavior may be declared:</p>
-<ul>
-<li>at higher levels in the hierarchy,</li>
-<li>at lower levels in hierarchy, or even</li>
-<li>at the same level in the hierarchy but happening to have lower precedence (if such case is allowed by the kind of policy.)</li>
-</ul>
-<p>At any time, any one of these policies can be created and therefore the final behavior of a target should never be assumed to be equivalent to the intent declared by any individual policy in particular, but always collectively determined by the combination of all intents, defaults and overrides from all inherited policies affecting the target.</p>
-<p>From <a href="https://github.com/kubernetes-sigs/gateway-api/pull/2813">GEP-2649</a>:</p>
-<blockquote>
-<p>If a Policy can be used as an Inherited Policy, it MUST be treated as an Inherited Policy, regardless of whether a specific instance of the Policy is only affecting a single object.</p>
-</blockquote>
-<p>An inherited policy that simply declares an intent (i.e. without specifying D/O) will be treated as a policy that implicitly declares an atomic set of <em>defaults</em>, whether the policy targets higher levels in the hierarchy or lower ones.
-In the absence of any other conflicting policy affecting the same target, the <em>behavior</em> equals the <em>defaults</em> which equal the <em>intent</em>.</p>
-<h3 id="inherited-policies-that-modify-an-intent">Inherited Policies that <em>modify an intent</em><a class="headerlink" href="#inherited-policies-that-modify-an-intent" title="Permanent link">&para;</a></h3>
-<p>A policy that specifies D/O fields (<code>defaults</code>, <code>overrides</code>) is a policy explicitly declared to <em>modify an intent</em>.</p>
-<p>Without any other policy with lower precedence, there is no special meaning in choosing whether <em>defaults</em> or <em>overrides</em> in a inherited policy that targets an object whose kind is the lowest kind accepted by Kuadrant in the hierarchy of network resources.
-The sets of rules specified in these policies affect indistinctively the targeted objects, regardless of how they are qualified.</p>
-<p>However, because other policies may ocasionally be declared with lower precedence (i.e. targeting lower levels in the hierarchy or due to ordering, see <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#conflict-resolution">Conflict Resolution</a>), one who declares a policy to modify an intent must carefuly choose between <code>defaults</code> and/or <code>overrides</code> blocks to organize the policy rules, regardless if the targeted object is of a kind that is the lowest kind in the hierarchy of network resources accepted by Kuadrant.</p>
-<p>Even in the cases where no more than one policy of a kind is allowed to target a same object (1:1 relationship) and thus there should never exist two policies affecting a target from a same level of the hierarchy simultaneaously (or equivalently a policy with lower precedence than another, both at the lowest level of the hierarchy), users must assume that this constraint may change (i.e. N:1 relationship between policies of a kind and target become allowed.)</p>
-<p>In all cases, <em>defaults</em> and <em>overrides</em> must be used with the semantics of declaring rules that modify an intent.</p>
-<ul>
-<li>When an intent does not specify a rule for which there is a higher default declared, the default modifies the intent by setting the value specified by the default.</li>
-<li>For an intent that whether specifies or omits a rule for which there is a higher override declared, the override modifies the intent by setting the value specified by the override.</li>
-</ul>
-<h3 id="identifying-inherited-policy-kinds">Identifying inherited policy kinds<a class="headerlink" href="#identifying-inherited-policy-kinds" title="Permanent link">&para;</a></h3>
-<p>All Custom Resource Definitions (CRDs) that define a Kuadrant inherited policy must be labeled <code>gateway.networking.k8s.io/policy: inherited</code>.</p>
-<p>Users can rely on the presence of that label to identify policy kinds whose instances are treated as inhertied policies.</p>
-<p>In some exceptional cases, there may be kinds of Kuadrant policies that do not specify <code>defaults</code> and <code>overrides</code> blocks, but that are still labeled as inherited policy kinds.
-Instances of these kinds of policies implicitly declare an atomic sets of <em>defaults</em>, similarly to described in <a href="#inherited-policies-that-declare-an-intent">Inherited Policies that declare an intent</a>.</p>
-<h3 id="examples-of-do-enabled-kuadrant-policy">Examples of D/O-enabled Kuadrant policy<a class="headerlink" href="#examples-of-do-enabled-kuadrant-policy" title="Permanent link">&para;</a></h3>
-<p><strong>Example 1.</strong> Atomic defaults</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gw-policy</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">      </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">        </span><span class="s">&quot;a&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">      </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">        </span><span class="s">&quot;b&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">    </span><span class="nt">strategy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">atomic</span>
-</span></code></pre></div>
-<p>The above is a proper Inherited Policy that sets a <strong><em>default</em> atomic set of auth rules</strong> that will be set at lower objects in case those lower object do not have policies attached of their own at all.</p>
-<p>The following is a sligthly different example that defines <strong>auth rules</strong> that will be <strong>individually merged</strong> into lower objects, evaluated one by one if already defined at the "lower" (more specific) level and therefore should take precedence, or if otherwise is missing at the lower level and therefore the default should be activated.</p>
-<p><strong>Example 2.</strong> Merged defaults</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gw-policy</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">      </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">        </span><span class="s">&quot;a&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">      </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">        </span><span class="s">&quot;b&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">    </span><span class="nt">strategy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">merge</span>
-</span></code></pre></div>
-<p>Similarly, a set of <code>overrides</code> policy rules could be specified, instead or alongside with the <code>defaults</code> set of policy rules.</p>
-<h3 id="atomic-vs-individually-merged-policy-rules">Atomic vs. individually merged policy rules<a class="headerlink" href="#atomic-vs-individually-merged-policy-rules" title="Permanent link">&para;</a></h3>
-<p>There are 2 supported strategies for applying proper Inherited Policies down to the lower levels of the herarchy:</p>
-<ul>
-<li><strong>Atomic policy rules:</strong> the bare set of policy rules in a <code>defaults</code> or <code>overrides</code> block is applied as an atomic piece; i.e., a lower object than the target of the policy, that is evaluated to be potentially affected by the policy, also has an atomic set of rules if another policy is attached to this object, therefore either the <em>entire</em> set of rules declared by the higher (less specific) policy is taken or the <em>entire</em> set of rules declared by the lower (more specific) policy is taken (depending if it's <code>defaults</code> or <code>overrides</code>), but the two sets are never merged into one.</li>
-<li><strong>Merged policy rules:</strong> each <em>individual</em> policy rule within a <code>defaults</code> or <code>overrides</code> block is compared one to one against lower level policy rules and, when they conflict (i.e. have the same key with different values), either one or the other (more specific or less specific) is taken (depending if it's <code>defaults</code> or <code>overrides</code>), in a way that the final effective policy is a merge between the two policies.</li>
-</ul>
-<p>Each block of <code>defaults</code> and <code>overrides</code> must specify a <code>strategy</code> field whose value is set to either <code>atomic</code> or <code>merge</code>. If omitted, <code>atomic</code> is assumed.</p>
-<h4 id="level-of-granularity-of-compared-policy-rules">Level of granularity of compared policy rules<a class="headerlink" href="#level-of-granularity-of-compared-policy-rules" title="Permanent link">&para;</a></h4>
-<p>Atomic versus merge strategies, as a specification of the <code>defaults</code> and <code>overrides</code> blocks, imply that there are only two levels of granularity for comparing policies <em>vis-a-vis</em>.</p>
-<ul>
-<li>
-<p><code>atomic</code> means that the level of granularity is the entire set of policy rules within the <code>defaults</code> or <code>overrides</code> block. I.e., the policy is atomic, or, equivalently, the final effective policy will be either one indivisible ("atomic") set of rules ("policy") or the other.</p>
-</li>
-<li>
-<p>For the <code>merge</code> strategy, on the other hand, the granularity is of each <em>named policy rule</em>, where the name of the policy rule is the key and the value is an atomic object that specifies that policy rule. The final effective policy will be a merge of two policies.</p>
-</li>
-</ul>
-<h4 id="matrix-of-do-strategies-and-effective-policy">Matrix of D/O strategies and Effective Policy<a class="headerlink" href="#matrix-of-do-strategies-and-effective-policy" title="Permanent link">&para;</a></h4>
-<p>When two policies are compared to compute a so-called <em>Effective Policy</em> out of their sets of policy rules and given default or override semantics, plus specified <code>atomic</code> or <code>merge</code> strategies, the following matrix applies:</p>
-<table>
-<thead>
-<tr>
-<th></th>
-<th>Atomic (entire sets of rules)</th>
-<th>Merge (individual policy rules at a given granularity)</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><strong>Defaults</strong></td>
-<td>More specific <em>entire</em> set of rules beats less specific <em>entire</em> set of rules → takes all the rules from the <em>lower</em> policy</td>
-<td>More specific <em>individual</em> policy rules beat less specific <em>individual</em> set of rules → compare one by one each pair of policy rules and take the <em>lower</em> one if they conflict</td>
-</tr>
-<tr>
-<td><strong>Overrides</strong></td>
-<td>Less specific <em>entire</em> set of rules beats more specific <em>entire</em> set of rules → takes all the rules from the <em>higher</em> policy</td>
-<td>Less specific <em>individual</em> policy rules beat more specific <em>individual</em> set of rules → compare one by one each pair of policy rules and take the <em>higher</em> one if they conflict</td>
-</tr>
-</tbody>
-</table>
-<p>The order of the policies, from less specific (or "higher") to more specific (or "lower), is determined according to the <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#hierarchy">Gateway API hierarchy of network resources</a>, based on the kind of the object targeted by the policy. The policy that sets higher in the hierarchy dictates the strategy to be applied.</p>
-<p>For a more detailed reference, including how to resolve conflicts in case of policies targeting objects at the same level, see GEP-713's section <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#hierarchy">Hierarchy</a> and <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#conflict-resolution">Conflict Resolution</a>.</p>
-<h3 id="unsetting-inherited-defaults">Unsetting inherited defaults<a class="headerlink" href="#unsetting-inherited-defaults" title="Permanent link">&para;</a></h3>
-<p>In some cases, it may be desirable to be able to unset, at a lower policy, a merged default that is inherited from a higher one. In fact, some inherited defaults could be harmful to an application, at the same time as they are unfeasible to remove from scope for all applications altogether, and therefore require an exception.</p>
-<p>Unsetting defaults via specification at lower level policies provides users who own policy rules at different levels of the hirarchy the option of not having to coordinate those exceptions "offline", nor having to accept the addition of special cases (conditions) <em>at the higher level</em> to exempt only specific lower policies from being affected by a particular default, which otherwise would configure a violation of the inheritance pattern, as well as an imposition of additional cognitive complexity for one who reads a higher policy with too many conditions.</p>
-<p>Instead, users should continue to be able to declare their intents through policies, and redeem an entitlement to unset unapplicable defaults, without any leakage of lower level details upwards at the higher policies.</p>
-<p>The option of unsetting inherited defaults is presented as part of the volition implied by the inheritance of policy rules, which are tipically specified for the more general case (e.g. at the level of a gateway, for all routes), though not necessarily applicable for all special cases beneath. If enabled, this feature helps disambiguate the concept of "default", which should not be understood strictly as the option to set values that protect the system in case of lack of specialisation. Rather, by its property of volition and changeability. I.e., by definition, <strong>every default policy rule is opt-out and specifies a value that is modifiable</strong>.</p>
-<p>In constrast, a policy rule that is neither opt-out nor modifiable better fits the definition of an <em>override</em>. While a policy rule that is not opt-out, nor it sets a concrete default value to be enforced in the lack of specialisation, defines a <a href="#policy-requirements"><em>requirement</em></a>.</p>
-<p>Finally, for the use case where users want to set defaults that cannot be unset (though still modifable), the very feature of unsetting defaults itself should be configurable, at least at the level of the system. This can be achieved with feature switches and policy validation, including backed by the cluster's RBAC if needed.</p>
-<p>The capability of unsetting inherited defaults from an effective policy can be identified by the presence of the <code>spec.unset</code> field in a policy. The value is a list of default named policy rules to be unset.</p>
-<h3 id="conditionally-applying-do">Conditionally applying D/O<a class="headerlink" href="#conditionally-applying-do" title="Permanent link">&para;</a></h3>
-<p>Users should be able to specify conditions for applying their blocks of <code>defaults</code> and <code>overrides</code>. These conditions aim to support exceptional cases where the blocks cannot be simply applied downwards, but rather depend on specifics found in the lower policies, while still defined in generic terms – as opposed to conditions that leak details of individual lower policies upwards.</p>
-<p>Between a higher and a lower set of policy rules, the higher level dictates the conditions for its rules to be applied (either as defaults or as overrides) over the lower level, and never the other way around.</p>
-<p>D/O conditions are identfied by the presence of the <code>spec.defaults.when</code> or <code>spec.overrides.when</code> fields in a policy. Those should be defined using <a href="https://github.com/google/cel-spec">Common Expression Language (CEL)</a>, evaluated in the control plane against the lower level specification that the higher level is being applied to. I.e. <code>self</code> in the CEL expression is the lower policy.</p>
-<p>A concrete useful application for conditionally enforcing a block of D/O is for specifying <em>constraints</em> for lower values. E.g. if a lower policy tries to set a value on a numeric field that is greater (or lower) than a given threshold, apply an override that sets that field value to equal to the threshold; otherwise, use the value declared by the lower policy.</p>
-<p>In contrast, an example of trivially redundant application of D/O conditions would be specifying a default block of rules that is only applied when the lower level does not declare a more specific replacement. Since this is natural semantics of a default, one does not have to use conditions for that.</p>
-<h2 id="examples-of-do-cases">Examples of D/O cases<a class="headerlink" href="#examples-of-do-cases" title="Permanent link">&para;</a></h2>
-<p>The following sets of examples generalize D/O applications for the presented <a href="#conceptualization-and-user-story">user stories</a>, regardless of details about specific personas and kinds of targeted resources. They illustrate the expected behavior for different cases involving defaults, overrides, constraints and unsetting.</p>
-<table>
-<thead>
-<tr>
-<th>Examples</th>
-<th>Highlighted user stories</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><a href="#examples-a---default-policy-entirely-replaced-by-another-at-lower-level">A. Default policy entirely replaced by another at lower level</a></td>
-<td>gateway-default-policy, route-replace-policy</td>
-</tr>
-<tr>
-<td><a href="#examples-b---default-policy-rules-merged-into-policies-at-lower-level">B. Default policy rules merged into policies at lower level</a></td>
-<td>gateway-default-policy-rule, route-add-policy-rule</td>
-</tr>
-<tr>
-<td><a href="#examples-c---override-policy-entirely-replacing-other-at-lower-level">C. Override policy entirely replacing other at lower level</a></td>
-<td>gateway-override-policy</td>
-</tr>
-<tr>
-<td><a href="#examples-d---override-policy-rules-merged-into-other-at-lower-level">D. Override policy rules merged into other at lower level</a></td>
-<td>gateway-override-policy-rule</td>
-</tr>
-<tr>
-<td><a href="#examples-e---override-policy-rules-setting-constraints-to-other-at-lower-level">E. Override policy rules setting constraints to other at lower level</a></td>
-<td>policy-constraints</td>
-</tr>
-<tr>
-<td><a href="#examples-f---policy-rule-that-unsets-a-default-from-higher-level">F. Policy rule that unsets a default from higher level</a></td>
-<td>route-unset-policy-rule</td>
-</tr>
-</tbody>
-</table>
-<p>In all the examples, a Gateway and a HTTPRoute objects are targeted by two policies, and an effective policy is presented highlighting the expected outcome. This poses no harm to generalizations involving same or different kinds of targeted resources, multiples policies targeting a same object, etc.</p>
-<p>The leftmost YAML is always the "higher" (less specific) policy; the one in the middle, separated from the leftmost one by a "+" sign, is the "lower" (more specific) policy; and the rightmost YAML is the expected <em>Effective Policy</em>.</p>
-<p>For a complete reference of the order of hierarchy, from least specific to most specific kinds of resources, as well as how to resolve conflicts of hierarchy in case of policies targeting objects at the same level, see Gateway API's <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#hierarchy">Hierarchy</a> definition for Policy Attachment and <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#conflict-resolution">Conflict Resolution</a>.</p>
-<h3 id="examples-a-default-policy-entirely-replaced-by-another-at-lower-level">Examples A - Default policy entirely replaced by another at lower level<a class="headerlink" href="#examples-a-default-policy-entirely-replaced-by-another-at-lower-level" title="Permanent link">&para;</a></h3>
-<p><strong>Example A1.</strong> A <em>default</em> policy that is <em>replaced entirely</em> if another one is set at a lower level</p>
-<p><img alt="A default policy that is replaced entirely if another one is set at a lower level" src="../0009-defaults-and-overrides-assets/example-a1.png" /></p>
-<h3 id="examples-b-default-policy-rules-merged-into-policies-at-lower-level">Examples B - Default policy rules merged into policies at lower level<a class="headerlink" href="#examples-b-default-policy-rules-merged-into-policies-at-lower-level" title="Permanent link">&para;</a></h3>
-<p><strong>Example B1.</strong> A <em>default</em> policy whose rules are <em>merged into other policies</em> at a lower level, where individual default policy rules can be overridden or unset - <em>without conflict</em></p>
-<p><img alt="A default policy whose rules are merged into other policies at a lower level, where individual default policy rules can be overridden or unset - without conflict" src="../0009-defaults-and-overrides-assets/example-b1.png" /></p>
-<p><strong>Example B2.</strong> A <em>default</em> policy whose rules are <em>merged into other policies</em> at a lower level, where individual default policy rules can be overridden or unset - <em>with conflict</em></p>
-<p><img alt="A default policy whose rules are merged into other policies at a lower level, where individual default policy rules can be overridden or unset - with conflict" src="../0009-defaults-and-overrides-assets/example-b2.png" /></p>
-<h3 id="examples-c-override-policy-entirely-replacing-other-at-lower-level">Examples C - Override policy entirely replacing other at lower level<a class="headerlink" href="#examples-c-override-policy-entirely-replacing-other-at-lower-level" title="Permanent link">&para;</a></h3>
-<p><strong>Example C1.</strong> An <em>override</em> policy that <em>replaces any other</em> that is set at a lower level <em>entirely</em></p>
-<p><img alt="An override policy that replaces any other that is set at a lower level entirely" src="../0009-defaults-and-overrides-assets/example-c1.png" /></p>
-<h3 id="examples-d-override-policy-rules-merged-into-other-at-lower-level">Examples D - Override policy rules merged into other at lower level<a class="headerlink" href="#examples-d-override-policy-rules-merged-into-other-at-lower-level" title="Permanent link">&para;</a></h3>
-<p><strong>Example D1.</strong> An <em>override</em> policy whose rules are <em>merged into other policies</em> at a lower level, overriding individual policy rules with same identification - <em>without conflict</em></p>
-<p><img alt="An override policy whose rules are merged into other policies at a lower level, overriding individual policy rules with same identification - without conflict" src="../0009-defaults-and-overrides-assets/example-d1.png" /></p>
-<p><strong>Example D2.</strong> An <em>override</em> policy whose rules are <em>merged into other policies</em> at a lower level, overriding individual policy rules with same identification - <em>with conflict</em></p>
-<p><img alt="An override policy whose rules are merged into other policies at a lower level, overriding individual policy rules with same identification - with conflict" src="../0009-defaults-and-overrides-assets/example-d2.png" /></p>
-<h3 id="examples-e-override-policy-rules-setting-constraints-to-other-at-lower-level">Examples E - Override policy rules setting constraints to other at lower level<a class="headerlink" href="#examples-e-override-policy-rules-setting-constraints-to-other-at-lower-level" title="Permanent link">&para;</a></h3>
-<p>The examples in this section introduce the proposal for a new <code>when</code> field for the <code>defaults</code> and <code>overrides</code> blocks. This field dictates the conditions to be found in a lower policy that would make a higher policy or policy rule to apply, according to the corresponding <code>defaults</code> or <code>overrides</code> semantics and <code>atomic</code> or <code>merge</code> strategy.</p>
-<p>Combined with a simple case of override policy (see <a href="#examples-c---override-policy-entirely-replacing-other-at-lower-level">Examples C</a>), the <code>when</code> condition field allows modeling for use cases of setting constraints for lower-level policies.</p>
-<p>As here proposed, the value of the <code>when</code> condition field must be a valid <a href="https://github.com/google/cel-spec">Common Expression Language (CEL)</a> expression.</p>
-<p><strong>Example E1.</strong> An <em>override</em> policy whose rules <em>set constraints</em> to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - <em>lower policy is compliant with the constraint</em></p>
-<p><img alt="An override policy whose rules set constraints to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - compliant" src="../0009-defaults-and-overrides-assets/example-e1.png" /></p>
-<p><strong>Example E2.</strong> An <em>override</em> policy whose rules <em>set constraints</em> to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - <em>lower level violates the constraint</em></p>
-<p><img alt="An override policy whose rules set constraints to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - violated" src="../0009-defaults-and-overrides-assets/example-e2.png" /></p>
-<p><strong>Example E3.</strong> An <em>override</em> policy whose rules <em>set constraints</em> to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - <em>merge granularity problem</em></p>
-<p>The following example illustrates the possibly unintended consequences of enforcing D/O at <a href="#level-of-granularity-of-compared-policy-rules">strict levels of granularity</a>, and the flip side of the <code>strategy</code> field offering a closed set of options (<code>atomic</code>, <code>merge</code>).</p>
-<p>On one hand, the API is simple and straightforward, and there are no deeper side effects to be concerned about, other than at the two levels provided (atomic sets or merged individual policy rules.) On the other hand, this design may require more offline interaction between the actors who manage conflicting policies.</p>
-<p><img alt="An override policy whose rules set constraints to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - merge granularity problem" src="../0009-defaults-and-overrides-assets/example-e3.png" /></p>
-<h3 id="examples-f-policy-rule-that-unsets-a-default-from-higher-level">Examples F - Policy rule that unsets a default from higher level<a class="headerlink" href="#examples-f-policy-rule-that-unsets-a-default-from-higher-level" title="Permanent link">&para;</a></h3>
-<p>The examples in this section introduce a new field <code>unset: []string</code> at the same level as the bare set of policy rules. The value of this field, provided as a list, dictates the default policy rules declared at a higher level to be removed ("unset") from the effective policy, specified by name of the policy rules.</p>
-<p><strong>Example F1.</strong> A policy that <em>unsets</em> a <em>default</em> policy rule set at a higher level</p>
-<p><img alt="A policy that unsets a default policy rule set at a higher level" src="../0009-defaults-and-overrides-assets/example-f1.png" /></p>
-<p><strong>Example F2.</strong> A policy that tries to <em>unset</em> an <em>override</em> policy rule set a higher level</p>
-<p><img alt="A policy that tries to unset an override policy rule set a higher level" src="../0009-defaults-and-overrides-assets/example-f2.png" /></p>
-<h2 id="status-reporting-and-policy-discoverability">Status reporting and Policy discoverability<a class="headerlink" href="#status-reporting-and-policy-discoverability" title="Permanent link">&para;</a></h2>
-<h3 id="possible-statuses-of-an-inherited-policy">Possible statuses of an inherited policy<a class="headerlink" href="#possible-statuses-of-an-inherited-policy" title="Permanent link">&para;</a></h3>
-<p>An inherited policy can be at any of the following conditions (<a href="https://docs.kuadrant.io/architecture/rfcs/0004-policy-status/">RFC 0004</a>):</p>
-<table>
-<thead>
-<tr>
-<th style="text-align: center;">Type</th>
-<th style="text-align: center;">Status</th>
-<th>Reason</th>
-<th>Message</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td style="text-align: center;">Accepted</td>
-<td style="text-align: center;">True</td>
-<td>"Accepted"</td>
-<td>"Policy has been accepted"</td>
-</tr>
-<tr>
-<td style="text-align: center;"></td>
-<td style="text-align: center;">False</td>
-<td>"Conflicted"</td>
-<td>"Policy is conflicted by &lt;policy-ns/policy-name&gt;"</td>
-</tr>
-<tr>
-<td style="text-align: center;"></td>
-<td style="text-align: center;">False</td>
-<td>"Invalid"</td>
-<td>"Policy is invalid"</td>
-</tr>
-<tr>
-<td style="text-align: center;"></td>
-<td style="text-align: center;">False</td>
-<td>"TargetNotFound"</td>
-<td>"Policy target &lt;resource-name&gt; was not found"</td>
-</tr>
-<tr>
-<td style="text-align: center;">Enforced</td>
-<td style="text-align: center;">True</td>
-<td>"Enforced"</td>
-<td>"Policy has been successfuly enforced[. The following defaults have been added by <policy-ns/policy-name>: x, y]"</td>
-</tr>
-<tr>
-<td style="text-align: center;"></td>
-<td style="text-align: center;">True</td>
-<td>"PartiallyEnforced"</td>
-<td>"Policy has been successfuly enforced. The following rules have been overridden by <policy-ns/policy-name>: a, b[; the following defaults have been added by <policy-ns/policy-name>: x, y]"</td>
-</tr>
-<tr>
-<td style="text-align: center;"></td>
-<td style="text-align: center;">False</td>
-<td>"Overridden"</td>
-<td>"Policy has been overridden by &lt;policy-ns/policy-name&gt;"</td>
-</tr>
-<tr>
-<td style="text-align: center;"></td>
-<td style="text-align: center;">False</td>
-<td>"Unknown"</td>
-<td>"Policy has encountered some issues"</td>
-</tr>
-</tbody>
-</table>
-<h3 id="policy-discoverability-and-effective-policy">Policy discoverability and Effective policy<a class="headerlink" href="#policy-discoverability-and-effective-policy" title="Permanent link">&para;</a></h3>
-<p>A special condition must be added to every object that is targeted by a Kuadrant inherited policy if the policy's <code>Enforced</code> status condition is <code>True</code>.</p>
-<p>This special condition to be added to the target object is <code>kuadrant.io/xPolicyAffected</code>, where "xPolicy" is the kind of the inherited policy (e.g. AuthPolicy, RateLimitPolicy.)</p>
-<p>The possible statuses of an object regarding its sensitivity to one or more inherited policies are:</p>
-<table>
-<thead>
-<tr>
-<th style="text-align: center;">Type</th>
-<th style="text-align: center;">Status</th>
-<th>Reason</th>
-<th>Message</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td style="text-align: center;">xPolicyAffected</td>
-<td style="text-align: center;">False</td>
-<td>"Unaffected"</td>
-<td>"The object is not affected by any xPolicy"</td>
-</tr>
-<tr>
-<td style="text-align: center;"></td>
-<td style="text-align: center;">True</td>
-<td>"Affected"</td>
-<td>"The object is affected by xPolicy &lt;policy-ns/policy-name&gt;"</td>
-</tr>
-<tr>
-<td style="text-align: center;"></td>
-<td style="text-align: center;">True</td>
-<td>"PartiallyAffected"</td>
-<td>"The following sections of the object are affected by xPolicy &lt;policy-ns/policy-name&gt;: rules.0, rules.2"</td>
-</tr>
-</tbody>
-</table>
-<p>The presence of the <code>PolicyAffected</code> status condition helps identify that an object is sensitive to one of more policies of a kind, and gives some specifics about the scope of that effect (entire object or selected sections.)
-In many cases, this should be enough for inferring the actual policy rules being enforced for that object.</p>
-<p>For other cases where any of the following situations hold, a more detailed view of the final <em>Effective Policy</em> must be provided to the user:</p>
-<ul>
-<li>If the rules of the policy cannot be inferred by the name of the policy and/or the user lacks permission to read the policy object;</li>
-<li>If the object is affected by more than one policy.</li>
-</ul>
-<p>To help visualize the effective policy for a given target object in that situation, at least one of the following options must be provided to the user:</p>
-<ol>
-<li>A read-only <code>EffectivePolicy</code> custom resource, defined for each kind of inherited policy, and with an instance created for each affected object, that is reconciled and updated by the policy controller.</li>
-<li>A HTTP endpoint of the policy controller that users can consume to read the effective policy.</li>
-<li>A CLI tool that offers a command that queries the cluster and returns the effective policy – either by leveraging any of the methods above or computing the effective policy "on-the-fly" in the same fashion as the policy controller does.</li>
-</ol>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<h2 id="applying-policies">Applying policies<a class="headerlink" href="#applying-policies" title="Permanent link">&para;</a></h2>
-<p>The following diagrams are a high level model to guide the process of applying a set of policies of a kind for a given Gateway object, where the Gateway object is considered the root of a hierarchy, and for all objects beneath, being the xRoute objects the leaves of the hierarchical tree.</p>
-<p>As presented, policies can target either Gateways of route objects (HTTPRoutes, GRPCRoutes), with no restriction regarding the number of policies of a kind that target a same particular object. I.e. N:1 relationship allowed. Without any loss of generality, 1:1 relationship between policies of a kind and targeted objects can be imposed if preferred as a measure to initially reduce the blast of information for the user and corresponding cognitive load.</p>
-<h3 id="apply-policies-to-a-gateway-root-object-and-all-objects-beneath">Apply policies to a Gateway (root object) and all objects beneath<a class="headerlink" href="#apply-policies-to-a-gateway-root-object-and-all-objects-beneath" title="Permanent link">&para;</a></h3>
-<pre class="mermaid"><code>%%{ init: { "theme": "neutral" } }%%
-flowchart LR
-    start([For a Gateway &lt;i&gt;g&lt;/i&gt;&lt;br&gt;and policy kind &lt;i&gt;pk&lt;/i&gt;]) --&gt;
-    list-routes[List all routes&lt;br&gt;accepted by &lt;i&gt;g&lt;/i&gt; as &lt;i&gt;R&lt;/i&gt;] --&gt;
-    apply-policies-for-r
-    subgraph for-each-route[For each &lt;i&gt;r in R&lt;/i&gt;]
-        apply-policies-for-r[[Apply policies&lt;br&gt;of kind &lt;i&gt;pk&lt;/i&gt;&lt;br&gt;scoped for &lt;i&gt;r&lt;/i&gt;]] --&gt;
-        apply-policies-for-r
-    end
-    for-each-route --&gt;
-    build-virtual-route[Build a virtual route &lt;i&gt;vr&lt;/i&gt;&lt;br&gt;with all route rules not&lt;br&gt;target by any policy] --&gt;
-    apply-policies-for-vr[[Apply policies&lt;br&gt;of kind &lt;i&gt;pk&lt;/i&gt;&lt;br&gt;scoped for &lt;i&gt;vr&lt;/i&gt;]] --&gt;
-    finish(((END)))</code></pre>
-<h3 id="apply-policies-of-a-kind-for-an-object">Apply policies of a kind for an object<a class="headerlink" href="#apply-policies-of-a-kind-for-an-object" title="Permanent link">&para;</a></h3>
-<pre class="mermaid"><code>%%{ init: { "theme": "neutral" } }%%
-flowchart LR
-    apply-policies-for-o-start([Apply policies of kind &lt;i&gt;pk&lt;/i&gt;&lt;br&gt;scoped for an object &lt;i&gt;o&lt;/i&gt;]) --&gt;
-    list-policies[Make &lt;i&gt;P&lt;/i&gt; ← all policies &lt;br&gt;of kind &lt;i&gt;pk&lt;/i&gt; that&lt;br&gt;affect &lt;i&gt;o&lt;/i&gt;] --&gt;
-    sort-policies[Sort &lt;i&gt;P&lt;/i&gt; from&lt;br&gt;lowest to highest] --&gt;
-    build-effective-policy[Build an effective&lt;br&gt;policy &lt;i&gt;ep&lt;/i&gt; without&lt;br&gt;any policy rules] --&gt;
-    merge-p-into-ep
-    subgraph for-each-policy[For each policy &lt;i&gt;p in P&lt;/i&gt;]
-        merge-p-into-ep[[Merge &lt;i&gt;p into &lt;i&gt;ep&lt;/i&gt;]] --&gt;
-        merge-p-into-ep
-    end
-    for-each-policy --&gt;
-    reconcile-ep[Reconcile resources&lt;br&gt;for &lt;i&gt;ep&lt;/i&gt;] --&gt;
-    apply-policies-for-o-finish(((END)))</code></pre>
-<h3 id="merging-two-policies-together">Merging two policies together<a class="headerlink" href="#merging-two-policies-together" title="Permanent link">&para;</a></h3>
-<pre class="mermaid"><code>%%{ init: { "theme": "neutral" } }%%
-flowchart LR
-    merge-p1-into-p2-start([Merge policy &lt;i&gt;p1&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p2&lt;/i&gt;]) --&gt;
-    p1-format{Explicit&lt;br&gt;&lt;i&gt;defaults&lt;/i&gt; or &lt;i&gt;overrides&lt;/i&gt;&lt;br&gt;declared in &lt;i&gt;p1&lt;/i&gt;?}
-    p1-format -- Yes --&gt; merge-defaults-for-r[["Merge &lt;b&gt;defaults&lt;/b&gt; block&lt;br&gt;of policy rules&lt;br&gt;of &lt;i&gt;p1&lt;/i&gt; into &lt;i&gt;p2&lt;/i&gt;"]] --&gt; merge-overrides-for-r[["Merge &lt;b&gt;overrides&lt;/b&gt; block&lt;br&gt;of policy rules&lt;br&gt;of &lt;i&gt;p1&lt;/i&gt; into &lt;i&gt;p2&lt;/i&gt;"]] --&gt; merge-p1-into-p2-finish(((Return &lt;i&gt;p2&lt;/i&gt;)))
-    p1-format -- No --&gt; merge-bare-rules-for-r[["Merge ungrouped&lt;br&gt;block of policy rules&lt;br&gt;of &lt;i&gt;p1&lt;/i&gt; into &lt;i&gt;p2&lt;/i&gt;&lt;br&gt;(as &lt;b&gt;defaults&lt;/b&gt;)"]] --&gt; merge-p1-into-p2-finish</code></pre>
-<h3 id="merging-a-generic-block-of-policy-rules-defaults-or-overrides-into-a-policy-with-conditions">Merging a generic block of policy rules (defaults or overrides) into a policy with conditions<a class="headerlink" href="#merging-a-generic-block-of-policy-rules-defaults-or-overrides-into-a-policy-with-conditions" title="Permanent link">&para;</a></h3>
-<pre class="mermaid"><code>%%{ init: { "theme": "neutral" } }%%
-flowchart LR
-    merge-block-of-rules-into-p-start([Merge block of&lt;br&gt;policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]) --&gt;
-    r-conditions-match{"&lt;i&gt;B.when(p)&lt;/i&gt;"}
-    r-conditions-match -- "Conditions do not match" --&gt; merge-block-of-rules-into-p-finish(((Return &lt;i&gt;p&lt;/i&gt;)))
-    r-conditions-match -- "Conditions match" --&gt; block-semantics{Merge &lt;i&gt;B&lt;/i&gt; as}
-    block-semantics -- "Defaults" --&gt; merge-default-block-into-p[[Merge default block&lt;br&gt;of policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]] --&gt; merge-block-of-rules-into-p-finish
-    block-semantics -- "Overrides" --&gt; merge-override-block-into-p[[Merge override block&lt;br&gt;of policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]] --&gt; merge-block-of-rules-into-p-finish</code></pre>
-<h3 id="merge-a-defaults-block-of-policy-rules-into-a-policy">Merge a <code>defaults</code> block of policy rules into a policy<a class="headerlink" href="#merge-a-defaults-block-of-policy-rules-into-a-policy" title="Permanent link">&para;</a></h3>
-<pre class="mermaid"><code>%%{ init: { "theme": "neutral" } }%%
-flowchart LR
-    merge-default-block-into-p-start([Merge default block&lt;br&gt;of policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]) --&gt;
-    unset-unwanted-policy-rules[Remove from &lt;i&gt;B&lt;/i&gt;&lt;br&gt;all policy rules&lt;br&gt;listed in &lt;i&gt;p.unset&lt;/i&gt;] --&gt;
-    p-empty{&lt;i&gt;p.empty?&lt;/i&gt;}
-    p-empty -- "Yes" --&gt; full-replace-p-with-defaut-block[&lt;i&gt;p.rules ← B&lt;/i&gt;] --&gt; merge-default-block-into-p-finish(((Return &lt;i&gt;p&lt;/i&gt;)))
-    p-empty -- "No" --&gt; default-block-strategy{&lt;i&gt;B.strategy&lt;/i&gt;}
-    default-block-strategy -- "Atomic" --&gt; merge-default-block-into-p-finish
-    default-block-strategy -- "Merge" --&gt; default-p-r-exists
-    subgraph for-each-default-policy-rule["For each &lt;i&gt;r in B&lt;i&gt;"]
-        default-p-r-exists{"&lt;i&gt;p[r.id].exists?&lt;/i&gt;"}
-        default-p-r-exists -- "Yes" --&gt; default-p-r-exists
-        default-p-r-exists -- "No" --&gt; default-replace-pr["&lt;i&gt;p[r.id] ← r&lt;/i&gt;"] --&gt; default-p-r-exists
-    end
-    for-each-default-policy-rule --&gt;
-    merge-default-block-into-p-finish</code></pre>
-<h3 id="merge-an-overrides-block-of-policy-rules-into-a-policy">Merge an <code>overrides</code> block of policy rules into a policy<a class="headerlink" href="#merge-an-overrides-block-of-policy-rules-into-a-policy" title="Permanent link">&para;</a></h3>
-<pre class="mermaid"><code>%%{ init: { "theme": "neutral" } }%%
-flowchart LR
-    merge-override-block-into-p-start([Merge override block&lt;br&gt;of policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]) --&gt;
-    override-block-strategy{&lt;i&gt;B.strategy&lt;/i&gt;}
-    override-block-strategy -- "Atomic" --&gt; full-replace-p-with-override-block[&lt;i&gt;p.rules ← B&lt;/i&gt;] --&gt; merge-override-block-into-p-finish(((Return &lt;i&gt;p&lt;/i&gt;)))
-    override-block-strategy -- "Merge" --&gt; override-replace-pr
-    subgraph for-each-override-policy-rule["For each &lt;i&gt;r in B&lt;i&gt;"]
-        override-replace-pr["&lt;i&gt;p[r.id] ← r&lt;/i&gt;"] --&gt; override-replace-pr
-    end
-    for-each-override-policy-rule --&gt;
-    merge-override-block-into-p-finish</code></pre>
-<h2 id="implementation-tiers">Implementation tiers<a class="headerlink" href="#implementation-tiers" title="Permanent link">&para;</a></h2>
-<p>This section proposes a possible path for the implementation of this RFC for Kuadrant's existing kinds of policies that are affected by D/O – notably AuthPolicy and RateLimitPolicy.</p>
-<p>The path is divided in 3 tiers that could be delivered in steps, additionaly to a series of enhancements &amp; refactoring.</p>
-<h3 id="tier-1">Tier 1<a class="headerlink" href="#tier-1" title="Permanent link">&para;</a></h3>
-<ul>
-<li>Atomic defaults (currently supported; missing addition of the <code>defaults</code> field to the APIs)</li>
-<li>Atomic overrides</li>
-<li>Policy status and Policy discoverability (i.e. PolicyAffected status on target objects)</li>
-<li>CRD labels <code>gateway.networking.k8s.io/policy: inherited | direct</code></li>
-</ul>
-<h3 id="tier-2">Tier 2<a class="headerlink" href="#tier-2" title="Permanent link">&para;</a></h3>
-<ul>
-<li>D/O <code>when</code> conditions (and support for "constraints")</li>
-<li>Merge strategy</li>
-<li>Reporting of effective policy</li>
-</ul>
-<h3 id="tier-3">Tier 3<a class="headerlink" href="#tier-3" title="Permanent link">&para;</a></h3>
-<ul>
-<li>Unsetting (<code>unset</code>)</li>
-<li>Metrics for D/O policies (control plane)</li>
-<li>Docs: possible approaches for <a href="#policy-requirements">"requirements"</a></li>
-</ul>
-<h3 id="enhancements-and-refactoring">Enhancements and refactoring<a class="headerlink" href="#enhancements-and-refactoring" title="Permanent link">&para;</a></h3>
-<ul>
-<li>Extract generic part of D/O implementation to <a href="https://github.com/Kuadrant/gateway-api-machinery">Kuadrant/gateway-api-machinery</a>.</li>
-</ul>
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<p>See <em>Mutually exclusive API designs &gt; <a href="#design-option-strategy-field">Design option: <code>strategy</code> field</a></em>.</p>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<h2 id="mutually-exclusive-api-designs">Mutually exclusive API designs<a class="headerlink" href="#mutually-exclusive-api-designs" title="Permanent link">&para;</a></h2>
-<p>The following alternatives were considered for the design of the API spec to support D/O:</p>
-<ol>
-<li><a href="#design-option-strategy-field"><code>strategy</code> field</a> - RECOMMENDED</li>
-<li><a href="#design-option-granularity-field"><code>granularity</code> field</a></li>
-<li><a href="#design-option-when-conditions-at-any-level-of-the-spec"><code>when</code> conditions (at any level of the spec)</a></li>
-<li><a href="#design-option-cel-functions-at-any-level-of-the-spec">CEL functions (at any level of the spec)</a></li>
-<li><a href="#design-option-path-keys">“path-keys”</a></li>
-<li><a href="#design-option-json-patch-like">JSON patch-like</a></li>
-</ol>
-<p>All the examples in the RFC are based on API design <strong><code>strategy</code> field</strong>.</p>
-<h3 id="design-option-strategy-field">Design option: <code>strategy</code> field<a class="headerlink" href="#design-option-strategy-field" title="Permanent link">&para;</a></h3>
-<p>Each block of <code>defaults</code> and <code>overrides</code> specify a field <code>strategy: atomic | merge</code>, with <code>atomic</code> assumed if the field is omitted.</p>
-<p>All the examples in the RFC are based on this design for the API spec.</p>
-<p>Some of the implications of the design are explained in the section <a href="#atomic-vs-individually-merged-policy-rules">Atomic vs. individually merged policy rules</a>, with highlights to the support for specifying the level of atomicity of the rules in the policy based on only 2 granularities – entire set of policy rules (<code>atomic</code>) or to the level of each named policy rule (<code>merge</code>.)</p>
-<table>
-  <thead>
-    <tr>
-      <th>✅ Pros</th>
-      <th>❌ Cons</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <ul>
-          <li>Same schema as a normal policy without D/O</li>
-          <li>Declarative</li>
-          <li>Safe against "unmergeable objects" (e.g. two rules declaring different one-of options)</li>
-          <li>Strong types</li>
-          <li>Extensible (by adding more fields, e.g.: to support unsetting defaults)</li>
-          <li>Easy to learn</li>
-        </ul>
-      </td>
-      <td>
-        <ul>
-          <li>2 levels of granularity only – either all (‘atomic’) or policy rule (‘merge’)</li>
-          <li>1 granularity declaration per D/O block → declaring both ‘atomic’ and ‘merge’ simultaneously requires 2 separate policies targeting the same object</li>
-        </ul>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p>The design option based on the <code>strategy</code> field is the RECOMMENDED design for the implementation of Kuadrant Policies enabled for D/O. This is due to the pros above, plus the fact that this design can evolve to other, more versatile forms, such as <a href="#design-option-granularity-field"><strong><code>granularity</code> field</strong></a>, <a href="#design-option-when-conditions-at-any-level-of-the-spec"><strong><code>when</code> conditions</strong></a> or <a href="#design-option-cel-functions-at-any-level-of-the-spec"><strong>CEL functions</strong></a>, in the future, while the opposite would be harder to achieve.</p>
-<h3 id="design-option-granularity-field">Design option: <code>granularity</code> field<a class="headerlink" href="#design-option-granularity-field" title="Permanent link">&para;</a></h3>
-<p>Each block of <code>defaults</code> and <code>overrides</code> would specify a <code>granularity</code> field, set to a numeric integer value that describes which level of the policy spec, from the root of the set of policy rules until that number of levels down, to treat as the key, and the rest as the atomic value.</p>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gw-policy</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">      </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">        </span><span class="s">&quot;a&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">      </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">        </span><span class="s">&quot;b&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">    </span><span class="nt">granularity</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">0</span><span class="w"> </span><span class="c1"># the entire spec (&quot;rules&quot;) is an atomic value</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="w">  </span><span class="nt">overrides</span><span class="p">:</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="w">      </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a><span class="w">        </span><span class="s">&quot;c&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a><span class="w">      </span><span class="nt">response</span><span class="p">:</span>
-</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a><span class="w">        </span><span class="s">&quot;d&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a><span class="w">    </span><span class="nt">granularity</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span><span class="w"> </span><span class="c1"># each policy rule (&quot;c&quot;, &quot;d&quot;) is an atomic value</span>
-</span></code></pre></div>
-<table>
-  <thead>
-    <tr>
-      <th>✅ Pros</th>
-      <th>❌ Cons</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <ul>
-          <li>Same as design option <a href="#design-option-strategy-field"><b><code>strategy</code> field</b></a></li>
-          <li>Unlimited levels of granularity (values can be pointed as atomic at any level)</li>
-        </ul>
-      </td>
-      <td>
-        <ul>
-          <li>1 granularity declaration per D/O block → <i>N</i> levels simultaneously require <i>N</i> policies</li>
-          <li>Granularity specified as a number - user needs to count the levels</li>
-          <li>Setting a deep level of granularity can cause merging "unmergeable objects"</li>
-        </ul>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<h3 id="design-option-when-conditions-at-any-level-of-the-spec">Design option: <code>when</code> conditions (at any level of the spec)<a class="headerlink" href="#design-option-when-conditions-at-any-level-of-the-spec" title="Permanent link">&para;</a></h3>
-<p>Inspired by the extension of the API for D/O with an additional <code>when</code> field (see <a href="#examples-e---override-policy-rules-setting-constraints-to-other-at-lower-level">Examples E</a>), this design alternative would use the presence of this field to signal the granularity of the atomic operation of default or override.</p>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gw-policy</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">      </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">        </span><span class="s">&quot;a&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">        </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CEL</span><span class="w"> </span><span class="c1"># level 1 - entire &quot;authentication&quot; block</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="w">      </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="w">        </span><span class="s">&quot;b&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="w">          </span><span class="s">&quot;prop-1&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="w">          </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CEL</span><span class="w"> </span><span class="c1"># level 2 - &quot;b&quot; authorization policy rule</span>
-</span></code></pre></div>
-<table>
-  <thead>
-    <tr>
-      <th>✅ Pros</th>
-      <th>❌ Cons</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <ul>
-          <li>Same as <a href="#design-option-granularity-field"><b><code>granularity</code> field</b></a></li>
-          <li>As many granularity declarations per D/O block as complex objects in the policy</li>
-          <li>Granularity specified “in-place”</li>
-        </ul>
-      </td>
-      <td>
-        <ul>
-          <li>Setting a deep level of granularity can cause merging "unmergeable objects"</li>
-          <li>Implementation nightmare - hard to define the API from existing types</li>
-        </ul>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<h3 id="design-option-cel-functions-at-any-level-of-the-spec">Design option: CEL functions (at any level of the spec)<a class="headerlink" href="#design-option-cel-functions-at-any-level-of-the-spec" title="Permanent link">&para;</a></h3>
-<p>This design option leans on the power of <a href="https://github.com/google/cel-spec">Common Expression Language (CEL)</a>, extrapolating the design alternative with <a href="#design-option-when-conditions-at-any-level-of-the-spec"><strong><code>when</code> conditions</strong></a> beyond declaring a CEL expression just to determine if a statically declared value should apply. Rather, it proposes the use of <a href="https://github.com/google/cel-spec/blob/master/doc/langdef.md#functions">CEL functions</a> that outputs the value to default to or to ovrride with, taking the conflicting "lower" value as input, with or without a condition as part of the CEL expression. The value of a key set to a CEL function indicates the level of granularity of the D/O operation.</p>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gw-policy</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="w">      </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="w">        </span><span class="s">&quot;a&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span><span class="w"> </span><span class="c1"># static value</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="w">        </span><span class="s">&quot;b&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="s">&quot;cel:self.value</span><span class="nv"> </span><span class="s">&gt;</span><span class="nv"> </span><span class="s">3</span><span class="nv"> </span><span class="s">?</span><span class="nv"> </span><span class="s">AuthenticationRule{value:</span><span class="nv"> </span><span class="s">3}</span><span class="nv"> </span><span class="s">:</span><span class="nv"> </span><span class="s">self&quot;</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="w">      </span><span class="nt">authorization</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">|</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="w">        </span><span class="no">cel:Authorization{</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="w">          </span><span class="no">c: AuthorizationRule{prop1: &quot;x&quot;}</span>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="w">        </span><span class="no">}</span>
-</span></code></pre></div>
-<table>
-  <thead>
-    <tr>
-      <th>✅ Pros</th>
-      <th>❌ Cons</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <ul>
-          <li>Unlimited levels of granularity</li>
-          <li>Granularity specified “in-place”</li>
-          <li>Extremely powerful</li>
-          <li>Elegant and simple implementation-wise</li>
-        </ul>
-      </td>
-      <td>
-        <ul>
-          <li>Weakly typed</li>
-          <li>Implementation completely new – cannot reuse current API types</li>
-          <li>Requires all types to be defined as protobufs</li>
-          <li>Without strong guardrails, users can easily shoot themselves in the foot</li>
-          <li>Validation likely requires complex functions for parsing the CEL expressions</li>
-          <li>Non-declarative</li>
-        </ul>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<h3 id="design-option-path-keys">Design option: “path-keys”<a class="headerlink" href="#design-option-path-keys" title="Permanent link">&para;</a></h3>
-<p>A more radical alternative considered consisted of defining <code>defaults</code> and <code>overrides</code> blocks whose schemas would not match the ones of a normal policy without D/O. Instead, these blocks would consist of simple key-value pairs, where the keys specify the paths in an affected policy where to apply the value atomically.</p>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gw-policy</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="w">    </span><span class="s">&quot;rules.authentication&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="w">      </span><span class="s">&quot;a&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">G</span><span class="p p-Indicator">}</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="w">    </span><span class="s">&quot;rules.authorization.b&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">G</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<table>
-  <thead>
-    <tr>
-      <th>✅ Pros</th>
-      <th>❌ Cons</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <ul>
-          <li>D/O as simple key-value sets (keys: where to apply, values: what to apply)</li>
-          <li>Declarative</li>
-          <li>Unlimited levels of granularity (values can be pointed as atomic at any level)</li>
-          <li>Unlimited merge declarations per D/O block</li>
-          <li>Intuitive, easy-to-learn</li>
-        </ul>
-      </td>
-      <td>
-        <ul>
-          <li>Not same schema as the normal policy (without D/O) - not very GWAPI-like</li>
-          <li>Weakly typed (i.e. <code>map[string]any)</code></li>
-          <li>Not extensible (e.g., cannot add other fields to the API)</code></li>
-        </ul>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<h3 id="design-option-json-patch-like">Design option: JSON patch-like<a class="headerlink" href="#design-option-json-patch-like" title="Permanent link">&para;</a></h3>
-<p>Similar to the <a href="#design-option-path-keys"><strong>path-keys</strong></a> design option, inspired by <a href="https://jsonpatch.com/">JSON patch</a> operations, to provide more kinds of operations and extensibility.</p>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gw-policy</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rules.authentication</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="w">    </span><span class="nt">operation</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">add</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="w">    </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="w"> </span><span class="s">&quot;a&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">G</span><span class="p p-Indicator">}</span><span class="w"> </span><span class="p p-Indicator">}</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rules.authorization.b</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="w">    </span><span class="nt">operation</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">remove</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">|</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="w">      </span><span class="no">rules.authentication.a.</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="w">      </span><span class="no">value</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="w">    </span><span class="nt">operation</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">le</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="w">    </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span></code></pre></div>
-<table>
-  <thead>
-    <tr>
-      <th>✅ Pros</th>
-      <th>❌ Cons</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <ul>
-          <li>Same as <a href="#design-option-path-keys"><b>"path-keys" field</b></a></li>
-          <li>Extensible, all kinds of operations supported (add, remove, constraint)</li>
-        </ul>
-      </td>
-      <td>
-        <ul>
-          <li>Not same schema as the normal policy (without D/O) - not very GWAPI-like</li>
-          <li>Less declarative</li>
-          <li>Weakly typed (i.e. <code>value: any)</code></li>
-        </ul>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<p>Other than the primitive support only for implicit atomic defaults provided by Kuadrant for the AuthPolicy and RateLimitPolicy, other real-life implementations of D/O along the lines proposed by Gateway API are currently unknown.</p>
-<p>Some orientative examples provided in:</p>
-<ul>
-<li><a href="https://github.com/kubernetes-sigs/gateway-api/pull/2813">GEP-2649</a> - search for "CDNCachingPolicy" as well as "Merging into existing spec fields";</li>
-<li><a href="https://github.com/kubernetes-sigs/gateway-api/tree/v1.0.0/gwctl"><code>gwctl</code></a> effective policy calculation for inherited policies - see <a href="https://github.com/kubernetes-sigs/gateway-api/blob/v1.0.0/gwctl/pkg/policymanager/merger_test.go">policy manager's merge test cases</a>.</li>
-</ul>
-<h1 id="out-of-scope">Out of scope<a class="headerlink" href="#out-of-scope" title="Permanent link">&para;</a></h1>
-<h2 id="policy-requirements">Policy requirements<a class="headerlink" href="#policy-requirements" title="Permanent link">&para;</a></h2>
-<p>A use case often described in association with D/O is the one for declaring <em>policy requirements</em>. These are high level policies that declare requirements to be fulfilled by more specific (lower level) policies without specifying concrete default or override values nor constraints. E.g.: "an authentication policy must be enforced, but none is provided by default."</p>
-<p>A typical generic policy requirement user story is:</p>
-<blockquote>
-<p><em>As a Platform Engineer, when configuring a Gateway, I want to set policy requirements to be fulfilled by one who manages an application/route linked to my Gateway, so all interested parties, including myself, can be aware of applications deployed to the cluster that lack a particular policy protection being enforced.</em></p>
-</blockquote>
-<p>Policy requirements as here described are out of scope of this RFC.</p>
-<p>We believe policy requirement use cases can be stated and solved as an observability problem, by defining metrics and alerts that cover for missing policies or policy rules, without necessarily having to write a policy of the same kind to express such requirement to be fulfilled.</p>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<h2 id="merging-policies-with-references-to-external-objects">Merging policies with references to external objects<a class="headerlink" href="#merging-policies-with-references-to-external-objects" title="Permanent link">&para;</a></h2>
-<p><strong>How to handle merges of policies from different namespaces that contain references to other objects (e.g. Secrets)?</strong></p>
-<p>Often policies rules include references to other Kubernetes objects, such as Secrets, typically defined in the same namespace as the policy object. When merging policies from different namespaces, these references need to be taken into account.</p>
-<p>If not carried along with the derivative resources (e.g. Authorino AuthConfig objects) that are created from a merge of policies (or from the computed effective policy), composed out of definitions from different namespaces, and that depend on those references, these references to external objects can be broken.</p>
-<p>This is not much of a problem for atomic D/O only, as the derivative objects that depend on the references could be forced to be created in the same namespace as the policy that wins against all the others – and therefore in the same namespace of the winning referents as well. However, when merging policies, we can run into a situation where final effective policies (thus also other derivative resources) contain references to objects inherited from definitions from other namespaces.</p>
-<p>Possible solutions to this problem include:</p>
-<ol>
-<li>Copying the referenced objects into the namespace where the derivative resources will be created.</li>
-<li>Involves maintaining (watching and reconciling) those referenced objects</li>
-<li>May raise security concerns</li>
-<li>Allowing derivative resources (e.g. Authorino AuthConfigs) to reference objects across namespaces, as well as giving permissions to the components that process those references (e.g. Authorino) to read across namespaces</li>
-<li>May raise security concerns</li>
-<li>Should probably be restricted to derivative resources created by Kuadrant and not allowed to users who create the derivative resources themselves</li>
-</ol>
-<h2 id="policy-spec-resembling-more-the-target-spec">Policy spec resembling more the target spec<a class="headerlink" href="#policy-spec-resembling-more-the-target-spec" title="Permanent link">&para;</a></h2>
-<p><strong>Should Kuadrant's inherited policy specs resemble more the specs of the objects they target?</strong></p>
-<p>The UX for one who writes a Kuadrant policy of the inherited class of policies is arguably not very different from writing any custom resource that happens to specify a <code>targetRef</code> field.
-Other than name and kind of target object, there is nothing much in a Kuadrant policy custom resource that provides the user with an experience almost close to be "adding fields" in the target object.</p>
-<p>With the exception of a few types reused for the <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/route-selectors/">route selectors</a>, the spec of a Kuadrant policy is very different from the spec of the object that ultimately the policy augments, i.e. the spec of the route object. This remains basically unchanged after this RFC. However, another way to think on the design of those APIs is one where, in contrast, the specs of the policies partially mirror the spec of the route, so users can write policies in a more intuitive fashion, as if the definitions of the policy would look like extensions of the routes they target (directly or by targeting gateways the routes are attached to.)</p>
-<p>E.g.:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rule-1</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w">    </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w">    </span><span class="nt">backendRef</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rule-2</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="w">    </span><span class="nt">backendRef</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<p>An inherited policy that targets the HTTPRoute above could otherwise look like the following:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Policy</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-policy</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span><span class="w"> </span><span class="c1"># mirrors the spec of the httproute object</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">    </span><span class="nt">policySpecificDef</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span><span class="w"> </span><span class="c1"># augments the entire httproute object</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">  </span><span class="nt">overrides</span><span class="p">:</span><span class="w"> </span><span class="c1"># mirrors the spec of the httproute object</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rule-2</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="w">      </span><span class="nt">policySpecificDef</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span><span class="w"> </span><span class="c1"># augments only httprouterule rule-2 of the httproute object</span>
-</span></code></pre></div>
-<p>The above already is somewhat closer to being true for the AuthPolicy API, than it is for the RateLimitPolicy one. However, that is strictly coincidental, because the AuthPolicy's spec happens to specify a <code>rules</code> field, where the equivalent at the same level in RateLimitPolicy is called <code>limits</code>.</p>
-<p>This alternative design could make writing policies more like defining filters in an HTTPRoute, with the difference that policies are external to the target they extend (while filters are internal.) At the same time, it could be a replacement for Kuadrant route selectors, where the context of applicability of a policy rule is given by the very structure within the spec how the policy rule is declared (resembling the one of the target), thus also would shaping context for D/O.</p>
-<p>One caveat of this design though is that each policy specific definition (i.e. the rule specification that extends the object at a given point defined by the very structure of the spec) is exclusive of that given point in the structure of the object. I.e., one cannot specify a single policy rule that augments N &gt; 1 specific rules of a target HTTPRoute.</p>
-<p>Due to its relevance to the design of the API that enables D/O, this was left as an unresolved question. To be nonetheless noticed that, as a pattern, this alternative API design extends beyond inherited policies, impacting as well the direct policy kinds DNSPolicy and TLSPolicy.</p>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<h2 id="n1-policy-target-relationship">N:1 policy-target relationship<a class="headerlink" href="#n1-policy-target-relationship" title="Permanent link">&para;</a></h2>
-<p>Although this proposal was thought to keep options open for multiple policies of a kind targeting a same network resource, this is currently not the state of things for Kuadrant. Instead, Kuadrant enforces 1:1 relationship between policies of a kind and target resources.</p>
-<p>Supporting N:1 relationships could enable use cases such as of App Developers defining D/O for each other at the same level of a shared xRoute, as well as Platform Engineers setting different policy rules on the same Gateway.</p>
-<p>This could provide an alternative to achieving separation of concerns for complex policy kinds such as the AuthPolicy, where different users could be responsible for authentication and authorization, without necessarily depending on defining new kinds of policies.</p>
-<h2 id="route-rule-name-and-targetrefsectionname">Route rule <code>name</code> and <code>targetRef.sectionName</code><a class="headerlink" href="#route-rule-name-and-targetrefsectionname" title="Permanent link">&para;</a></h2>
-<p>If Gateway API's <a href="https://github.com/kubernetes-sigs/gateway-api/issues/995">GEP-995</a> is accepted (i.e. <a href="https://github.com/kubernetes-sigs/gateway-api/pull/2593">kubernetes-sigs/gateway-api#2593</a> gets merged) and the <code>name</code> field for route rules implemented in the APIs (HTTPRoute and GRPCRoute), this could impact how Kuadrant delivers D/O. Although the semantics could remain the same, the users specify the scope for a given set of policy rules could simplify significantly.</p>
-<p>As of today, Kuadrant's AuthPolicy and RateLimitPolicy APIs allow users to target sections of a HTTPRoute based on <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/route-selectors/">route selectors</a>, and thus all the conflict resolution involved in handling D/O must take that logics into account.</p>
-<p>With named route rules supported by Gateway API, either route selectors could be redefined in a simpler form where each selector consists of a list of names of rules and/or entire policies could be scoped for a section of a resource, by defining the <code>targetRef</code> field based on the <a href="https://pkg.go.dev/sigs.k8s.io/gateway-api/apis/v1alpha2#PolicyTargetReferenceWithSectionName"><code>PolicyTargetReferenceWithSectionName</code></a> type.</p>
-<p>To be noted <a href="https://github.com/kubernetes-sigs/gateway-api/pull/2813">GEP-2649</a>'s recommendation of not defining inherited policies that allow for <code>sectionName</code> in the <code>targetRef</code>. Nonetheless, this is a general rule from the spec <a href="https://github.com/kubernetes-sigs/gateway-api/pull/2813#discussion_r1511950231">said to be acceptable to be broken</a> in the spirit of offering better functionality to users, provided it can deal with the associated discoverability and complexity problems of this feature.</p>
-<h2 id="use-listmaptype-instead-of-maps-of-policy-rules">Use listMapType instead of maps of policy rules<a class="headerlink" href="#use-listmaptype-instead-of-maps-of-policy-rules" title="Permanent link">&para;</a></h2>
-<p>Despite having recently modified the AuthPolicy and RateLimitPolicy APIs to use maps for declaring policy rules instead of lists (<a href="https://docs.kuadrant.io/architecture/rfcs/0001-rlp-v2/">RFC 0001</a>), reverting this design in future versions of these APIs, plus treating those lists as <code>listMapType</code>, could let us leverage the API server's strategic merge type to handle merges between policy objects.</p>
-<p>In the Policy CRDs, the policy rule types must specify a <code>name</code> field (required). The list of rules type (i.e. <code>[]Rule</code>) must then speficy the following <a href="https://book.kubebuilder.io/reference/markers/crd-processing.html?highlight=listType#crd-processing">Kubebuilder CRD processing annotations</a>:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>// +listType=map
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>// +listMapKey=name
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>As the time of writing, <a href="https://gateway-api.sigs.k8s.io/geps/gep-713">GEP-713</a> (Kubernetes Gateway API, SIG-NETWORK) is <a href="https://github.com/kubernetes-sigs/gateway-api/pull/2813">under revision</a>, expected to be split into two separate GEPs, one for Direct Policies (GEP-2648) and one for Inherited Policies (GEP-2649.) Once these new GEPs supersede GEP-713, all references to the previous GEP in this document must be updated to GEP-2649.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0010-gateway-api-metrics-exporter/index.html b/0.10.0/architecture/rfcs/0010-gateway-api-metrics-exporter/index.html
deleted file mode 100644
index d92a87c37..000000000
--- a/0.10.0/architecture/rfcs/0010-gateway-api-metrics-exporter/index.html
+++ /dev/null
@@ -1,3532 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0010-gateway-api-metrics-exporter/">
-      
-      
-        <link rel="prev" href="../0009-defaults-and-overrides/">
-      
-      
-        <link rel="next" href="../0011-policy-machinery/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0010: Gateway API Metrics Exporter - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#gateway-api-metrics-exporter" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0010: Gateway API Metrics Exporter
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0010-gateway-api-metrics-exporter.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="gateway-api-metrics-exporter">Gateway API Metrics Exporter<a class="headerlink" href="#gateway-api-metrics-exporter" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: gateway-api-metrics-exporter</li>
-<li>Start Date: 2024-07-26</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/101">Kuadrant/architecture#101</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/kuadrant-operator/issues/675">kuadrant-operator/issues/675</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>A new sub-project for a <a href="https://prometheus.io/docs/instrumenting/writing_exporters/">prometheus exporter</a> that exports metrics about the state of <a href="https://gateway-api.sigs.k8s.io/api-types/gateway/">Gateway API resources</a> in a Kubernetes cluster.</p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>Allow additional stateful information about Gateway API resources to be made available via metrics.
-Currently a set of metrics are made available via the <a href="https://github.com/Kuadrant/gateway-api-state-metrics/blob/main/METRICS.md">gateway-api-state-metrics</a> project.
-However, there are <a href="https://github.com/Kuadrant/gateway-api-state-metrics/issues/1">limitations</a> with what resource information can be exposed using the underlying <a href="https://github.com/kubernetes/kube-state-metrics">kube-state-metrics</a> project.
-Additional stateful information would include:</p>
-<ul>
-<li>Individual listener status within a Gateway</li>
-<li>HTTPRoute status</li>
-</ul>
-<p>For example, the individual status listener information from a Gateway:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="w">  </span><span class="nt">status</span><span class="p">:</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">    </span><span class="nt">listeners</span><span class="p">:</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">attachedRoutes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">      </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2023-08-15T13:22:06Z&quot;</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">No errors found</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Ready</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Ready</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2023-08-15T13:22:06Z&quot;</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">No errors found</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ResolvedRefs</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ResolvedRefs</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api</span>
-</span></code></pre></div>
-<p>and HTTPRoute parents status conditions:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="w">  </span><span class="nt">status</span><span class="p">:</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w">    </span><span class="nt">parents</span><span class="p">:</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-05-16T16:17:38Z&quot;</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Object affected by AuthPolicy default/toystore</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Accepted</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/AuthPolicyAffected</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-05-16T16:18:51Z&quot;</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Object affected by RateLimitPolicy default/toystore</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Accepted</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/RateLimitPolicyAffected</span>
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a><span class="w">      </span><span class="nt">controllerName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/policy-controller</span>
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a><span class="w">      </span><span class="nt">parentRef</span><span class="p">:</span>
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a><span class="w">        </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a><span class="w">        </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api-gateway</span>
-</span><span id="__span-1-22"><a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-system</span>
-</span><span id="__span-1-23"><a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-1-24"><a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-05-16T16:17:38Z&quot;</span>
-</span><span id="__span-1-25"><a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Object affected by AuthPolicy default/toystore</span>
-</span><span id="__span-1-26"><a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-1-27"><a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Accepted</span>
-</span><span id="__span-1-28"><a id="__codelineno-1-28" name="__codelineno-1-28" href="#__codelineno-1-28"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-1-29"><a id="__codelineno-1-29" name="__codelineno-1-29" href="#__codelineno-1-29"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/AuthPolicyAffected</span>
-</span><span id="__span-1-30"><a id="__codelineno-1-30" name="__codelineno-1-30" href="#__codelineno-1-30"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-05-16T16:18:51Z&quot;</span>
-</span><span id="__span-1-31"><a id="__codelineno-1-31" name="__codelineno-1-31" href="#__codelineno-1-31"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Object affected by RateLimitPolicy default/toystore</span>
-</span><span id="__span-1-32"><a id="__codelineno-1-32" name="__codelineno-1-32" href="#__codelineno-1-32"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-1-33"><a id="__codelineno-1-33" name="__codelineno-1-33" href="#__codelineno-1-33"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Accepted</span>
-</span><span id="__span-1-34"><a id="__codelineno-1-34" name="__codelineno-1-34" href="#__codelineno-1-34"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-1-35"><a id="__codelineno-1-35" name="__codelineno-1-35" href="#__codelineno-1-35"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/RateLimitPolicyAffected</span>
-</span><span id="__span-1-36"><a id="__codelineno-1-36" name="__codelineno-1-36" href="#__codelineno-1-36"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-05-20T11:45:33Z&quot;</span>
-</span><span id="__span-1-37"><a id="__codelineno-1-37" name="__codelineno-1-37" href="#__codelineno-1-37"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Route was valid</span>
-</span><span id="__span-1-38"><a id="__codelineno-1-38" name="__codelineno-1-38" href="#__codelineno-1-38"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-1-39"><a id="__codelineno-1-39" name="__codelineno-1-39" href="#__codelineno-1-39"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Accepted</span>
-</span><span id="__span-1-40"><a id="__codelineno-1-40" name="__codelineno-1-40" href="#__codelineno-1-40"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-1-41"><a id="__codelineno-1-41" name="__codelineno-1-41" href="#__codelineno-1-41"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Accepted</span>
-</span><span id="__span-1-42"><a id="__codelineno-1-42" name="__codelineno-1-42" href="#__codelineno-1-42"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-05-20T11:45:33Z&quot;</span>
-</span><span id="__span-1-43"><a id="__codelineno-1-43" name="__codelineno-1-43" href="#__codelineno-1-43"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">All references resolved</span>
-</span><span id="__span-1-44"><a id="__codelineno-1-44" name="__codelineno-1-44" href="#__codelineno-1-44"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-1-45"><a id="__codelineno-1-45" name="__codelineno-1-45" href="#__codelineno-1-45"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ResolvedRefs</span>
-</span><span id="__span-1-46"><a id="__codelineno-1-46" name="__codelineno-1-46" href="#__codelineno-1-46"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-1-47"><a id="__codelineno-1-47" name="__codelineno-1-47" href="#__codelineno-1-47"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ResolvedRefs</span>
-</span><span id="__span-1-48"><a id="__codelineno-1-48" name="__codelineno-1-48" href="#__codelineno-1-48"></a><span class="w">      </span><span class="nt">controllerName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio.io/gateway-controller</span>
-</span><span id="__span-1-49"><a id="__codelineno-1-49" name="__codelineno-1-49" href="#__codelineno-1-49"></a><span class="w">      </span><span class="nt">parentRef</span><span class="p">:</span>
-</span><span id="__span-1-50"><a id="__codelineno-1-50" name="__codelineno-1-50" href="#__codelineno-1-50"></a><span class="w">        </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-1-51"><a id="__codelineno-1-51" name="__codelineno-1-51" href="#__codelineno-1-51"></a><span class="w">        </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-1-52"><a id="__codelineno-1-52" name="__codelineno-1-52" href="#__codelineno-1-52"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api-gateway</span>
-</span><span id="__span-1-53"><a id="__codelineno-1-53" name="__codelineno-1-53" href="#__codelineno-1-53"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-system</span>
-</span></code></pre></div>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>First, implement the existing Gateway API metrics that are part of the <a href="https://github.com/Kuadrant/gateway-api-state-metrics/blob/main/METRICS.md">gateway-api-state-metrics</a> project.
-This will allow the new prometheus exporter to replace that project as a whole.
-The metrics will be backwards compatible with the gateway-api-state-metrics project, with the addition of new metrics.</p>
-<p>Second, implement new metrics, as per the examples below, to capture the additional status information:</p>
-<p><div class="language-promql highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nv">gatewayapi_gateway_status_listeners_conditions</span><span class="p">{</span><span class="nl">namespace</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;NAMESPACE&gt;</span><span class="p">&quot;,</span><span class="nl">name</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;GATEWAY&gt;</span><span class="p">&quot;,</span><span class="nl">listener_name</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;LISTENER_NAME&gt;</span><span class="p">&quot;,</span><span class="err">type=&quot;&lt;ResolvedRefs|Ready|Other&gt;</span><span class="p">}</span><span class="w"> </span><span class="mi">1</span>
-</span></code></pre></div>
-This metric captures the status condition types of individual listeners in a Gateway.
-It will allow the status of individual named listeners to be queried, graphed and alerted on via metrics.
-The health status of listeners can then be visualised in a stat panel in Grafana, showing healthy and unhealthy listeners.
-This expands the debugging path beyond just the overall health of a Gateway.</p>
-<p><div class="language-promql highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nv">gatewayapi_httproute_status_parents_conditions</span><span class="p">{</span><span class="nl">namespace</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;NAMESPACE&gt;</span><span class="p">&quot;,</span><span class="nl">name</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;GATEWAY&gt;</span><span class="p">&quot;,</span><span class="nl">controller_name</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;CONTROLLER_NAME&gt;</span><span class="p">&quot;,</span><span class="err">&quot;</span><span class="nl">parent_group</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;PARENT_GROUP&gt;</span><span class="p">&quot;,</span><span class="nl">parent_kind</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;PARENT_KIND&gt;</span><span class="p">&quot;,</span><span class="nl">parent_name</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;PARENT_NAME&gt;</span><span class="p">&quot;,</span><span class="nl">parent_namespace</span><span class="o">=</span><span class="p">&quot;</span><span class="s">&lt;PARENT_NAMESPACE&gt;</span><span class="p">&quot;,</span><span class="err">type=&quot;&lt;ResolvedRefs|Accepted|Other&gt;</span><span class="p">}</span><span class="w"> </span><span class="mi">1</span>
-</span></code></pre></div>
-This metric captures the condition types for each parent of a HTTPRoute.
-The <code>type</code> field would also record any custom types set by a controller. For example, <code>kuadrant.io/AuthPolicyAffected</code> and <code>kuadrant.io/RateLimitPolicyAffected</code>.
-This will allow the health of HTTPRoutes to be reported via metrics. A HTTPRoute that has an <code>type</code> of Accepted and value of 1 means the HTTPRoute is accepted by the Gateway and can be considered healthy.
-It will also allow policy specific information about a HTTPRoute to be represented in metrics.
-For example, alerting on any HTTPRoutes that don't have the <code>kuadrant.io/AuthPolicyAffected</code> type with a value of 1 i.e. HTTPRoutes without an AuthPolicy.</p>
-<p>Tests will be added directly to the project in a similar manner to the <a href="https://github.com/oliver006/redis_exporter/blob/master/exporter/http_test.go">redis-exporter</a>.
-The test environment will bring up a kind cluster, create the Gateway API CRDs, example Gateway &amp; HTTPRoute resources, then test the scrape endpoint.
-This will be the same as how <a href="https://github.com/Kuadrant/gateway-api-state-metrics/blob/main/tests/e2e.sh">metrics are tested</a> for the gateway-api-state-metrics project.
-There is a <a href="https://github.com/Kuadrant/gateway-api-state-metrics/blob/main/tests/e2e/main_test.go">separate test function</a> for each resource.</p>
-<p>Existing <a href="https://github.com/Kuadrant/gateway-api-state-metrics/tree/main/src/dashboards">example dashboards</a> in the gateway-api-state-metrics project will be copied over to the exporter project and continue to work as before.
-However, initially it will just be the Gateway, GatewayClass and HTTPRoute dashboards as those will be the metrics that are implemented first.</p>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<p>The exporter will be written in golang and follow the guidelines from https://prometheus.io/docs/instrumenting/writing_exporters/.
-Other exporters like the https://github.com/prometheus/node_exporter/tree/master and https://github.com/oliver006/redis_exporter will be referenced for patterns and library usage.
-Metrics will only be pulled from the kubernetes API when Prometheus scrapes them.
-That is, the exporter will not perform scrapes based on its own timers.
-All scrapes will be synchronous.</p>
-<p>The <a href="https://github.com/kubernetes/client-go">client-go</a> library will be used for all kubernetes API calls.
-As the number of Gateways and HTTPRoutes could vary greatly, there is a performance consideration with these API calls if there are a lot of resources.
-To allow for this, a single list of all resources of a kind will used rather than 1 by 1.
-If in future there are issues with performance, there is an option to cache responses to expensive queries.</p>
-<p>A 'gateway_metrics_up` metric will be included, as per https://prometheus.io/docs/instrumenting/writing_exporters/#failed-scrapes
-such that the exporter can continue to respond in a standard way if there are issues with some aspects of scraping.
-The scrape response should include all metrics that have information available at that time of scraping.</p>
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<p>This is an additional library to maintain.
-However, it will supersede the gateway-api-state-metrics project and dependency on kube-state-metrics.</p>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<p>In theory it should be possible to get the desired functionality from the kube-state-metrics project if the proposed change in https://github.com/kubernetes/kube-state-metrics/pull/2059 is accepted and subsequently implemented.
-However, that proposal has been open since May 2023.
-I have ruled out the possibility of helping with the implementation of this change in that project due to:</p>
-<ul>
-<li>lack of detailed knowledge of the current implementation of selectors in kube-state-metrics</li>
-<li>potential complexity of implementing generic CEL support in that project</li>
-<li>it not being core to the Kuadrant project goals, combined with the ongoing maintenance commitment after implementation. It wouldn't be fair to land the change we need without following up on maintenance after</li>
-</ul>
-<p>The proposed design is a more focused solution on the needs of the Kuadrant project from Gateway API resources in the form of metrics.
-There are plenty of examples of exporters out there that we can reference and follow established patterns.</p>
-<p>If we don't make this change, we are limited to having just the overall Gateway status available via metrics,
-and no HTTPRoute status information on which we can visualise and alert.</p>
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<p>The primary prior art are the kube-state-metrics project, and the gateway-api-state-metrics projects.
-The gateway-api-state-metrics project uses the <a href="https://github.com/Kuadrant/gateway-api-state-metrics/blob/main/config/default/custom-resource-state.yaml">CustomResourceStateMetrics</a> configuration feature of kube-state-metrics to configure what fields in which resources should be made available via metrics.</p>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<p>n/a</p>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<p>Although this exporter is intended to replace the gateway-api-state-metrics project,
-it will likely take a phased approach to get to that point.
-The initial goal is to get 'like for like' functionality from a Kuadrant project point of view (Gateways, GatewayClasses and HTTPRoutes),
-followed by the new status functionality as detailed in this RFC.
-Other resources, such as TLSRoute, UDPRoute etc.. can be added later.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/0011-policy-machinery/index.html b/0.10.0/architecture/rfcs/0011-policy-machinery/index.html
deleted file mode 100644
index 94fd83888..000000000
--- a/0.10.0/architecture/rfcs/0011-policy-machinery/index.html
+++ /dev/null
@@ -1,3555 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/0011-policy-machinery/">
-      
-      
-        <link rel="prev" href="../0010-gateway-api-metrics-exporter/">
-      
-      
-        <link rel="next" href="../../../kuadrant-operator/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC 0011: Policy Machinery for reconciliation - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#policy-machinery-for-reconciliation" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC 0011: Policy Machinery for reconciliation
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/0011-policy-machinery.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="policy-machinery-for-reconciliation">Policy Machinery for reconciliation<a class="headerlink" href="#policy-machinery-for-reconciliation" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: <code>policy_machinery</code></li>
-<li>Start Date: 2024-07-03</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/95">Kuadrant/architecture#95</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/architecture/issues/29">Kuadrant/architecture#29</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>Explain how Kuadrant's <a href="https://github.com/Kuadrant/policy-machinery">Policy Machinery</a> can be used for reconciliation.</p>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>The <em>Policy Machinery</em> project (<a href="https://github.com/Kuadrant/policy-machinery">repo</a>, <a href="https://pkg.go.dev/github.com/kuadrant/policy-machinery">pkg.go</a>) offers a set of types and functions for implementing Gateway API policies – i.e.</p>
-<ul>
-<li>highly flexible representation of topologies of targetable resources;</li>
-<li>calculating effective policies based on custom or default merge strategies;</li>
-<li>tooling to watch and reconcile resources based on cluster events.</li>
-</ul>
-<p>These can be used for tailoring implemention of Kuadrant policies and Kuadrant instances. See <a href="https://github.com/Kuadrant/policy-machinery/tree/main/examples/kuadrant">example</a> provided.</p>
-<p>Leveraging the Policy Machinery can be key to:</p>
-<ol>
-<li>Improve flow control of concurrent reconciliation events</li>
-<li>Simplification of the calculation of effective policies respectively to the topological routing path of the requests</li>
-<li>Correct implementation of Defaults &amp; Overrides' <code>merge</code> strategy (<a href="https://docs.kuadrant.io/0.8.0/architecture/rfcs/0009-defaults-and-overrides/">RFC 0009</a>)</li>
-<li>Supporting multiple policies targeting a same resource</li>
-<li>Supporting targeting sections of a resource (e.g. Gateway listeners, HTTPRouteRules)</li>
-<li>Supporting multiple targetRefs in a policy</li>
-<li>Extending policies to target other kinds of resources (e.g. GatewayClass, Service, Namespace) -– future</li>
-</ol>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>Although essentially an implementation detail of the Kuadrant Operator, levering the Policy Machinery may introduce the following user-perceived features:</p>
-<ul>
-<li>Acknowledgement of the topological routing path of the request respectively to applicable <em>effective policies</em></li>
-<li>New form of targeting sections of a resource with a policy</li>
-<li>Elevated meaning of uniquely identifiable concepts across policy resources (e.g. named policy rules)</li>
-<li>Possibility of multiple policies of a kind targeting a same resource</li>
-<li>(Window of opportunity for) introducing plural targetRefs</li>
-</ul>
-<h3 id="user-acknowledgeable-reference-of-the-topological-routing-path-of-the-request">User-acknowledgeable reference of the topological routing path of the request<a class="headerlink" href="#user-acknowledgeable-reference-of-the-topological-routing-path-of-the-request" title="Permanent link">&para;</a></h3>
-<p>One who specifies Kuadrant policies targeting resources at any levels of the hierarchy <em>Gateway → Listener → HTTPRoute → HTTPRouteRule</em><sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> shall expect the effect of such policies to be reported always respectively to the lowest level of the hierarchy that the kind of policy allows targeting. E.g.:</p>
-<ul>
-<li>A DNSPolicy that allows targeting a Gateway hypothetically with or without specifying a <code>sectionName</code> actually targets gateway listeners; the user wants to reason about the state of DNSPolicies regarding their effect on each listeners specified in the Gateway. In a context with 2+ DNSPolicies, simultaneously targeting both a Gateway and specific listeners, DNS records for some listener hostnames may have been reconciled according to the specification from one policy or another, occasionally no policy at all.</li>
-<li>A RateLimitPolicy that allows targeting a Gateway, a HTTPRoute or specific HTTPRouteRule actually targets (directly or indirectly) HTTPRouteRule objects; the user wants to reason about the state of all RateLimitPolicies with respect to each HTTPRouteRule, where some HTTPRouteRules may be protected by one RateLimitPolicy, a combination of multiple RateLimitPolicies, or occasionally no RateLimitPolicy at all.</li>
-</ul>
-<p>In the specific case of policy kinds that allow targeting HTTPRouteRules, due to complex network topologies supported by Gateway API, including in particular HTTPRoutes with multiple Gateway parents, a same HTTPRouteRule may or may not be affected by a policy, depending on which routing path in the network topology a request flows. Therefore, ultimately <em>users will reason about policies and effective policies in terms of the paths between at least gateways and the lowest levels targeted by the policies that a request can flow.</em> Possibly, in terms of all possible paths between Gateways and Services.</p>
-<p>Kuadrant shall provide users with such visibility. Leveraging Policy Machinery is an implementation detail that nonetheless makes achieving this goal easier.</p>
-<h3 id="user-facing-changes-to-the-policy-apis">User-facing changes to the policy APIs<a class="headerlink" href="#user-facing-changes-to-the-policy-apis" title="Permanent link">&para;</a></h3>
-<h4 id="targeting-sections-of-network-resource">Targeting sections of network resource<a class="headerlink" href="#targeting-sections-of-network-resource" title="Permanent link">&para;</a></h4>
-<p>Leveraging Policy Machinery may also motivate some user-facing changes. In particular, replacing AuthPolicy's and RateLimitPolicy's <code>routeSelectors</code> for a <code>targetRef</code> with optional <code>sectionName</code> (made possible since <a href="https://github.com/kubernetes-sigs/gateway-api/pull/2985">kubernetes-sigs/gateway-api#2895</a>.)</p>
-<p>This change would cause a policy of AuthPolicy or RateLimitPolicy kind to always be attached to its targets <em>entirely</em>, i.e. without having rules that attach to some sections and other rules to other sections or no section at all. This differs from current situation where a policy of those kinds can be attached to a HTTPRoute and some of the policy's rules more specifically attached to individual HTTPRouteRules only, including with multiple policy rules attached to different HTTPRouteRules of the same targeted HTTPRoute. Instead, attaching a policy must be a cohesive, unambiguous operation, that occasionally requires users to specify more fine-grained policy objects to be attached only to sections of a resource.</p>
-<h4 id="identity-of-concepts-across-multiple-policy-objects">Identity of concepts across multiple policy objects<a class="headerlink" href="#identity-of-concepts-across-multiple-policy-objects" title="Permanent link">&para;</a></h4>
-<p>In some cases, splitting policy objects for the purpose of targeting sections of a network resource, without breaking the semantics of having a single set of policy objects cohesively defined, also implies that definitions about a same entity or concept within a policy (e.g. a limit definition), repeated at multiple policy objects, may have a way to represent to refer to the same thing (e.g. same set of counters).</p>
-<p>This is the case, for example, of limit definitions in a RateLimitPolicy as well as cache configs in an AuthPolicy. To avoid creating multiple rate-limit counter namespaces (analogously, multiple authorization rule cache entries) for definitions that are effectively about the same entity, despite specified at multiple policy objects, the APIs must provide a way for users to convey one of the other intent: definitions refer to the same thing versus definitions refer to different things.<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup></p>
-<h4 id="other-user-facing-changes">Other user-facing changes<a class="headerlink" href="#other-user-facing-changes" title="Permanent link">&para;</a></h4>
-<p>The following possible (non-required) other user-facing changes can be enabled leveraging Policy Machinery, without marginal implementation cost:</p>
-<ol>
-<li>Plural <code>targetRefs</code>.</li>
-<li>Multiple policies of a kind targeting a same network resource/resource section ("horizontal Defaults &amp; Overrides.")</li>
-<li>Aesthetical difference between <a href="https://gateway-api.sigs.k8s.io/geps/gep-2648/">Direct</a> versus <a href="https://gateway-api.sigs.k8s.io/geps/gep-2649/">Inherited</a> policies, implied by the merge strategies implemented by each kind of policy, rather than a necessary distinction.</li>
-</ol>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<p>Usage of the <a href="https://github.com/Kuadrant/policy-machinery">Policy Machinery</a> consists of importing two packages:</p>
-<ul>
-<li><a href="https://github.com/Kuadrant/policy-machinery/tree/main/machinery"><code>machinery</code></a>: provides the types and abstractions to build Gateway API topologies of targetable network resources, policies and adjacent objects;</li>
-<li><a href="https://github.com/Kuadrant/policy-machinery/tree/main/controller"><code>controller</code></a>: offers tools for implementing topology-based custom controllers of reconciliation logic.</li>
-</ul>
-<p>From that on, the following steps drive leveraging the Policy Machinery in the Kuadrant Operator:</p>
-<ol>
-<li>
-<p>Implement the <a href="https://github.com/Kuadrant/policy-machinery/blob/e963418c9566a5e61acdd766c6109d3f0c147222/machinery/types.go#L47"><code>machinery.Policy</code></a> interface for all kinds of policies.</p>
-<blockquote>
-<p><a href="https://github.com/Kuadrant/policy-machinery/tree/main/examples/kuadrant/apis">Example provided</a> for the DNSPolicy, TLSPolicy, AuthPolicy and RateLimitPolicy kinds.</p>
-</blockquote>
-</li>
-<li>
-<p>Define wrappers that implement the <a href="https://github.com/Kuadrant/policy-machinery/blob/e963418c9566a5e61acdd766c6109d3f0c147222/machinery/types.go#L13"><code>machinery.Object</code></a> interface for any kind of adjacent object whose unique identifier as a node in the topology graph cannot be based on the default <a href="https://github.com/Kuadrant/policy-machinery/blob/e963418c9566a5e61acdd766c6109d3f0c147222/controller/object.go#L17"><code>controller.RuntimeObject</code></a> type provided (if any.)</p>
-</li>
-<li>
-<p>Implement the linking functions for all kinds of adjacent objects and corresponding parents and children in the topology graph, including types such as <code>Kuadrant</code>, Istio's <code>WasmPlugin</code>, <code>ConfigMap</code>, etc.</p>
-<blockquote>
-<p>The <code>Kuadrant</code> custom resources shall be the roots of a directed acyclic graph (DAG) from which an entired topology of targetable network resources, adjacent objects and policies are connected.</p>
-</blockquote>
-</li>
-<li>
-<p>Start a <a href="https://github.com/Kuadrant/policy-machinery/blob/e963418c9566a5e61acdd766c6109d3f0c147222/controller/controller.go#L130"><code>controller.Controller</code></a> that:</p>
-<ol>
-<li>Watches for all kinds of objects to be represented in the topology.</li>
-<li>Triggers a <a href="https://github.com/Kuadrant/policy-machinery/blob/e963418c9566a5e61acdd766c6109d3f0c147222/controller/workflow.go#L12"><code>controller.Workflow</code></a> on events related to any of the watched resources.</li>
-</ol>
-</li>
-<li>
-<p>At every reconciliation event<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>:</p>
-<ol>
-<li>
-<p>Reconcile the internal objects for setting up the environment for a Kuadrant instance (deployments, gateway controller configs, etc).</p>
-</li>
-<li>
-<p>For each kind of policy and applicable path in the topology graph relevant for the policy kind:</p>
-</li>
-<li>
-<p>Compute an effective policy and give it a unique identifier.</p>
-</li>
-<li>Perform (or delegate) the policy-specific configuration (DNS, TLS, Auth, RL) of the effective policy with the policy decision/enforcement point<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup>.</li>
-<li>For policy kinds enforced at request time (data-plane policies), configure the gateway to call the policy decision point (PDP) on requests that match the attributes of the path<sup id="fnref:5"><a class="footnote-ref" href="#fn:5">5</a></sup>, passing in the payload to the PDP the identifier of the effective policy.</li>
-<li>
-<p>Update the status stanzas of all targetables in the topology whose paths were configured for an effective policy (or lack of such), with a map that allows users to inspect, for a given path, what effective policy (if any) will be enforced.
-       &gt; <strong>Note:</strong> If unsuitable for the status stanza of the object, the details of the effective policies may require additional tooling to be inspected by the users and the mapping must be to the unique identifier of the effective policy.</p>
-</li>
-<li>
-<p>Store a DOT representation of the topology graph in a ConfigMap.</p>
-</li>
-</ol>
-</li>
-</ol>
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<p>Part of the work consists on refactoring, without value perceived by the user.</p>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<h4 id="annotations">Annotations<a class="headerlink" href="#annotations" title="Permanent link">&para;</a></h4>
-<p>Use of annnotations to track back references from targeted objects to policies. This approach has been slowly deprecated to favour the use of an in-memory directed acyclic graph (DAG) representing the relationship between network objects and policies<sup id="fnref:6"><a class="footnote-ref" href="#fn:6">6</a></sup>.</p>
-<h4 id="bottom-up-reconciliation">Bottom-up reconciliation<a class="headerlink" href="#bottom-up-reconciliation" title="Permanent link">&para;</a></h4>
-<p>Bottom-up reconciliation by default, focusing on the policy resources first. This approach has been slowly refactored to using mappers (<a href="https://pkg.go.dev/sigs.k8s.io/controller-runtime/pkg/handler">event handlers</a>) that often multiply a lower-level event into multiple top-down ones, occasionally with the occurrence of repetitive events.</p>
-<h4 id="dag-10">DAG 1.0<a class="headerlink" href="#dag-10" title="Permanent link">&para;</a></h4>
-<p>Preliminary version of the topology DAG<sup id="fnref2:6"><a class="footnote-ref" href="#fn:6">6</a></sup> that:</p>
-<ol>
-<li>is bootstrapped at every reconciliation event (though leveraging <a href="https://pkg.go.dev/k8s.io/apimachinery">k8s.io/apimachinery</a>'s and <a href="https://pkg.go.dev/sigs.k8s.io/controller-runtime">sigs.k8s.io/controller-runtime</a>'s caches);</li>
-<li>does not include all kinds of targetables – missing object sections in particular;</li>
-<li>does not include internal configuration objects;</li>
-<li>was designed for one single kind of policy in each instance of the topology.</li>
-</ol>
-<h4 id="effective-policy-less-reconciliation">Effective policy-less reconciliation<a class="headerlink" href="#effective-policy-less-reconciliation" title="Permanent link">&para;</a></h4>
-<p>Configuration of internal resources for implementing effective policy behavior:</p>
-<ol>
-<li>tailored for each specific kind of policy, without leveraging generic and resusable merge strategy functions;</li>
-<li>not organically integrated with the topology DAG;</li>
-<li>decoupled from the rather user-acknowledgeable reference of the topological routing path of the request.</li>
-</ol>
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<h4 id="envoy-gateway-state-of-the-world-reconciliation">Envoy Gateway state-of-the-world reconciliation<a class="headerlink" href="#envoy-gateway-state-of-the-world-reconciliation" title="Permanent link">&para;</a></h4>
-<p>Envoy Gateway has implemented a custom controller for Gateway API and provider-specific resources with the following characteristics similar to the Policy Machinery <code>controller</code> package's approach:</p>
-<ol>
-<li>Based on <a href="https://pkg.go.dev/sigs.k8s.io/controller-runtime">controller-runtime</a></li>
-<li>Single <code>Reconcile</code> function that:<ol>
-<li>lists all watched resources from the cluster at every reconciliation event;</li>
-<li>rebuilds and updates a long-living <a href="https://github.com/telepresenceio/watchable">watchable</a> map of all the resources;</li>
-<li>trigger reconciliation logic subscribed to changes to the map – <code>goroutines</code> decoupled from controller-runtime.</li>
-</ol>
-</li>
-</ol>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<ul>
-<li>The <a href="https://gateway-api.sigs.k8s.io/geps/gep-713/#fanout-status-update-problems">fanout problem</a>, especially of status reconciliation.</li>
-<li>~~How to avoid changes performed by the reconciliation function to loop back in the form of multiple other (no-op) reconciliation events.~~ ⇨ issue state-modifying actions against the API server directly and safe-guard against create/update/delete events for states already reflected in the topology</li>
-<li>~~How to compact multiple equifinal reconciliation events waiting in the queue into a single one, thus avoiding unnecessary loops.~~ ⇨ rely on controller-runtime event coalescing</li>
-<li>~~What to do in case of reconciliation failures without retry~~ ⇨ always move the system to a final state, with proper status updating, and wait until state-of-the-world reconciliation kicks in again on the next event</li>
-</ul>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Extending policies to target other kinds of resources (e.g. GatewayClass, Service, Namespace.)</li>
-</ul>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>Gateway listeners and HTTPRouteRules can be targeted by specifying in a policy their main Gateway and HTTPRoute objects as targets, in combination with either a <code>sectionName</code> (supported in the <code>targetRef</code> field of the policy) or via <code>routeSelectors</code> (in the policy spec proper), respectively. Not all kinds of policies support targeting all 4 kinds of targetables of the <em>Gateway → Listener → HTTPRoute → HTTPRouteRule</em> hierarchy; some kinds of policies may support targeting only a few of those.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p>In the context of rate-limit, this problem is also referred to as the problem of the <em>identity of a limit</em>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>Specific steps can be filtered by type of event.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>While the DNS operator as well as the configuration performed by the Kuadrant Operator for a TLSPolicy are closer to the <em>enforcement</em> of the specifications in the DNS and TLS policy objects, Authorino and Limitador are policy <em>decision</em> points (PDP) rather. Indistinctively, control-plane operations that configure a service based on the specification of a policy, as well as the data-plane protection services that perform at request-time along with the gateways are all part of the policy enforcement.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-<li id="fn:5">
-<p>The attributes of a path in the topology from a Gateway to a HTTPRouteRule object typically include a hostname and the set of HTTPRouteMatches specified in the HTTPRouteRule.&#160;<a class="footnote-backref" href="#fnref:5" title="Jump back to footnote 5 in the text">&#8617;</a></p>
-</li>
-<li id="fn:6">
-<p>See <a href="https://github.com/Kuadrant/kuadrant-operator/issues/530">kuadrant-operator#530</a>.&#160;<a class="footnote-backref" href="#fnref:6" title="Jump back to footnote 6 in the text">&#8617;</a><a class="footnote-backref" href="#fnref2:6" title="Jump back to footnote 6 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/architecture/rfcs/dns-policy-api-changes/index.html b/0.10.0/architecture/rfcs/dns-policy-api-changes/index.html
deleted file mode 100644
index d6aee3446..000000000
--- a/0.10.0/architecture/rfcs/dns-policy-api-changes/index.html
+++ /dev/null
@@ -1,3464 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/architecture/rfcs/dns-policy-api-changes/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RFC DNSPolicy v1 changes and improvements - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#rfc-dnspolicy-v1-changes-and-improvements" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RFC DNSPolicy v1 changes and improvements
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/architecture/blob/main/rfcs/dns-policy-api-changes.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="rfc-dnspolicy-v1-changes-and-improvements">RFC DNSPolicy v1 changes and improvements<a class="headerlink" href="#rfc-dnspolicy-v1-changes-and-improvements" title="Permanent link">&para;</a></h1>
-<ul>
-<li>Feature Name: (<code>dns_policy_api_changes</code>)</li>
-<li>Start Date: (2024-09-11)</li>
-<li>RFC PR: <a href="https://github.com/Kuadrant/architecture/pull/0000">Kuadrant/architecture#0000</a></li>
-<li>Issue tracking: <a href="https://github.com/Kuadrant/architecture/issues/104">https://github.com/Kuadrant/architecture/issues/104</a></li>
-</ul>
-<h1 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">&para;</a></h1>
-<p>DNSPolicy is soon to go GA. There are several improvement we have identified over time that will enhance the GA of this API</p>
-<ul>
-<li>
-<p>Remove the need for labels on Gateways for GEO and custom weighting values</p>
-</li>
-<li>
-<p>Reduce the verbosity of GEO and Weighting definitions</p>
-</li>
-<li>
-<p>Remove the need for a strategy to be chosen as part of the policy definition.</p>
-</li>
-</ul>
-<h1 id="motivation">Motivation<a class="headerlink" href="#motivation" title="Permanent link">&para;</a></h1>
-<p>We want to simplify and improve the DNSPolicy API and remove some of the legacy structures that have hung on since its original inception, as this involves some breaking changes we want these before we create a v1 API.</p>
-<p><strong>Weighting and GEO attributes:</strong></p>
-<p>The loadbalancing options we provide were first designed as part of an API that was intended to work with OCM (open cluster management). This provided multiple views of gateways across multiple clusters. So in order to understand the GEO context or individual weighing needed for a given cluster, we needed that context applying separately from the DNSPolicy spec that for legacy reasons targeted a "template" Gateway in the hub cluster.</p>
-<p>Now DNSPolicy is created on the same cluster as the actual Gateway and we do not use OCM or hub clusters, the need to label individual objects and Gateways with specific annotations and labels is now redundant and makes for a more complex and awkward API interaction.</p>
-<p><strong>routingStrategy:</strong></p>
-<p>We have also identified that the routingStrategy option in the DNSPolicy spec is redundant. When added we expected there to be more than two strategies. This has not emerged and so it is another awkward piece of the API that is not needed.</p>
-<h1 id="guide-level-explanation">Guide-level explanation<a class="headerlink" href="#guide-level-explanation" title="Permanent link">&para;</a></h1>
-<p>You will no longer need to apply labels to Gateways in order to specify the GEO or Weighting for that Gateway. The policy targets a given Gateway and you will now just specify those values in the policy spec directly.</p>
-<p>You will no longer need to specify what routingStrategy you want to use. Instead you will either specify a loadbalancing section (meaning it is a loadbalanced strategy) or you will leave it empty (meaning it has no loadbalancing).</p>
-<h1 id="reference-level-explanation">Reference-level explanation<a class="headerlink" href="#reference-level-explanation" title="Permanent link">&para;</a></h1>
-<p>Below is an example of what is currently needed to setup GEO and Custom Weighting with the existing API</p>
-<p><div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>apiVersion: kuadrant.io/v1alpha1
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>kind: DNSPolicy
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>metadata:
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>  name: prod-web
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>  namespace: ingress-gateway
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>spec:
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>  targetRef:
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>    name: prod-web
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>    group: gateway.networking.k8s.io
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>    kind: Gateway
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>  routingStrategy: loabalanced  
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>  loadBalancing:
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>    weighted:
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>      defaultWeight: 120
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>      custom: # &lt;--- New Custom Weights being added
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>        - weight: 255
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>          selector:
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>            matchLabels:
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>              kuadrant.io/lb-attribute-custom-weight: AWS # slects gateways to apply it to (when there can only be one)
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>    geo: 
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a>      defaultGeo: US #catch all geo              
-</span></code></pre></div>
-So here to apply a custom weighting, you have to specify the weighting under the custom section and then apply the <code>kuadrant.io/lb-attribute-custom-weight: AWS</code> label to the gateway that is already being targeted by the policy. </p>
-<p>To change the GEO for the targeted cluster, you need to apply a different label to the gateway: <code>kuadrant.io/lb-attribute-geo-code: EU</code> for example. </p>
-<p>On top of this you also have to specify that it is a load balanced DNSPolicy even though you have specified a load balancing section. </p>
-<p>This is an awkward and disconnected API that evolved from the legacy requirements called out above.</p>
-<p>Instead the new API to achieve the same goal will be:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>apiVersion: kuadrant.io/v1alpha1
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kind: DNSPolicy
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>metadata:
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a>  name: prod-web
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>  namespace: ingress-gateway
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>spec:
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>  targetRef:
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a>    name: prod-web
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>    group: gateway.networking.k8s.io
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a>    kind: Gateway
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a>  loadBalancing:
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a>    weight: 100 #weight for listeners targeted 
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a>    geo: US # geo for listeners targeted 
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a>    defaultGEO: true # should this be consisdered the default GEO for the listener hosts
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a>  providerRefs:
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a>
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a>    - name: aws-credential-secret    
-</span></code></pre></div>
-<p>So no longer do you need to specify whether the policy is a load balanced one or not via the redundant <code>routingStrategy</code> field</p>
-<p>Now you simplify specify the weight you want to use for the listeners in the gateway, the geo you want to use and whether it should be used as a default GEO or not (this is used by some cloud providers as a catch-all option if a user from a none specified GEO does a DNS lookup.). Each of the fields under "loadbalancing" will now be required.</p>
-<p>From an implementation perspective, all changes will happen in the Kuadarant Operator, where it will no longer look for the attribute labels on the gateways but instead will simply use the spec of the DNSPolicy. The resulting DNSRecord will not change in structure. </p>
-<p>To setup a simple DNS structure (single A or CNAME record), the API would now look like:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>apiVersion: kuadrant.io/v1alpha1
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>kind: DNSPolicy
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>metadata:
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a>  name: prod-web
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>  namespace: ingress-gateway
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a>spec:
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a>  targetRef:
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a>    name: prod-web
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>    group: gateway.networking.k8s.io
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a>    kind: Gateway
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a>  providerRefs:
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a>    - name: aws-credential-secret    
-</span></code></pre></div>
-<p>Again no need for the redundant strategy field. </p>
-<h1 id="drawbacks">Drawbacks<a class="headerlink" href="#drawbacks" title="Permanent link">&para;</a></h1>
-<p>Introduces a breaking change to the API.</p>
-<h1 id="rationale-and-alternatives">Rationale and alternatives<a class="headerlink" href="#rationale-and-alternatives" title="Permanent link">&para;</a></h1>
-<p>These are breaking changes and we are about to move to v1. Changes like these should land pre v1. These changes provide a much simpler and better user experience.</p>
-<h1 id="prior-art">Prior art<a class="headerlink" href="#prior-art" title="Permanent link">&para;</a></h1>
-<p>NA</p>
-<h1 id="unresolved-questions">Unresolved questions<a class="headerlink" href="#unresolved-questions" title="Permanent link">&para;</a></h1>
-<p>NA</p>
-<h1 id="future-possibilities">Future possibilities<a class="headerlink" href="#future-possibilities" title="Permanent link">&para;</a></h1>
-<p>NA</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/assets/images/architecture-multi-cluster.png b/0.10.0/assets/images/architecture-multi-cluster.png
deleted file mode 100644
index 82b9671e2ccdaaae9509bde0d7ed9ca7709faf83..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 150505
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

diff --git a/0.10.0/assets/images/architecture-single-cluster.png b/0.10.0/assets/images/architecture-single-cluster.png
deleted file mode 100644
index bf200653e2278ab3bac64c0156c8d79b1b971ade..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 76590
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
DpBui7

diff --git a/0.10.0/assets/images/cncf-color.png b/0.10.0/assets/images/cncf-color.png
deleted file mode 100644
index 280fa66f5799811cd0dc9548437975a80e1c8703..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 24146
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
R(f!v1>FL7mR@}CI{Xh0xSDgR=

diff --git a/0.10.0/assets/images/deploy.png b/0.10.0/assets/images/deploy.png
deleted file mode 100644
index 7b03173507b3517b871303faeb7c59ea2f450a3d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 91193
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

diff --git a/0.10.0/assets/images/favicon.png b/0.10.0/assets/images/favicon.png
deleted file mode 100644
index ca869960653c0d13951e3b5010aaff58f076fb58..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 658
zcmV;D0&V??P)<h;3K|Lk000e1NJLTq001BW001Be1^@s6b9#F800076Nkl<ZScPL?
zU|{%<2U85ZSKg_0S^eO4(uD2m*yI@rSj0%K#UAUQE6CkAHt7#Lr|%CgUIva2uRr_{
z5J^~;VYiXy4)ECcSWo21-MO!2RZNh@#U9;y`AS~ZZ>O*9DVjOJbK_G(fme?fyc3tz
z!zM5C^xlD|!ot1>!nD6IFfcGMk!k@x;J*2R5&x@)i*Q-az`(%pMq0^1_{ZN=7@ukm
zaNqpENbKRgRqw^+bO@<s{q?QLW$i;HsyV=Y^8+KPJJ&b8l2cPAM*Vv+85zDGpCT9-
zsE`I=mOoS0l_t))5Fq&S@txPgvKACMfLzOA;6EdyAK6hrspSj|3=E=AZu^qu0BTsy
zz`(%3$iQe#auj%Od|)VX@A_s+EoWe0VBq@n{s&18@ZR!FQ{u+CT~E{uWGJ;9*#e>*
z;Iis2zrx)MXC7;tt5C~w1_lz!0iic9w^G}3q8;F|`N;y-AD^wMZ8^~npd}#60XuwU
z5`J^=9vv_TFfcGMyb}@kmc4rN4z(RH;MtI*G_ci2>iRQP9Y3kNm!DF@a;{JBe~_FA
zxBDxcf2N{I6-RJ?es_<oT(Hwu;T$y_@t@)U(V<%%GcZsV5`r%u-}(Fd|1pXSB61z^
zi;HLe-XNK`R4EBzju3lv>n<_s1z$aR@`;0Q1p@;Wi{hQW3g=$QD}@QZd~}77+TUzk
zeS3oC?@`qOFh_h8laCX6`S=npH6l;%9eB&ZJR8QRdS$fTU;6xeF_~D=$9K-4%ZWX@
s_4193VmYi=#K15JI;RW_1Kd3a0H10jYRu8s3;+NC07*qoM6N<$f)YhGivR!s

diff --git a/0.10.0/assets/images/logo.png b/0.10.0/assets/images/logo.png
deleted file mode 100644
index a84a1b5ebd7796715a70e0ba032a451f685496ab..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5690
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

diff --git a/0.10.0/assets/javascripts/bundle.bd41221c.min.js b/0.10.0/assets/javascripts/bundle.bd41221c.min.js
deleted file mode 100644
index 70bcbf19a..000000000
--- a/0.10.0/assets/javascripts/bundle.bd41221c.min.js
+++ /dev/null
@@ -1,29 +0,0 @@
-"use strict";(()=>{var _i=Object.create;var br=Object.defineProperty;var Ai=Object.getOwnPropertyDescriptor;var Ci=Object.getOwnPropertyNames,Ft=Object.getOwnPropertySymbols,ki=Object.getPrototypeOf,vr=Object.prototype.hasOwnProperty,eo=Object.prototype.propertyIsEnumerable;var Zr=(e,t,r)=>t in e?br(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,F=(e,t)=>{for(var r in t||(t={}))vr.call(t,r)&&Zr(e,r,t[r]);if(Ft)for(var r of Ft(t))eo.call(t,r)&&Zr(e,r,t[r]);return e};var to=(e,t)=>{var r={};for(var o in e)vr.call(e,o)&&t.indexOf(o)<0&&(r[o]=e[o]);if(e!=null&&Ft)for(var o of Ft(e))t.indexOf(o)<0&&eo.call(e,o)&&(r[o]=e[o]);return r};var gr=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var Hi=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Ci(t))!vr.call(e,n)&&n!==r&&br(e,n,{get:()=>t[n],enumerable:!(o=Ai(t,n))||o.enumerable});return e};var jt=(e,t,r)=>(r=e!=null?_i(ki(e)):{},Hi(t||!e||!e.__esModule?br(r,"default",{value:e,enumerable:!0}):r,e));var ro=(e,t,r)=>new Promise((o,n)=>{var i=c=>{try{a(r.next(c))}catch(p){n(p)}},s=c=>{try{a(r.throw(c))}catch(p){n(p)}},a=c=>c.done?o(c.value):Promise.resolve(c.value).then(i,s);a((r=r.apply(e,t)).next())});var no=gr((xr,oo)=>{(function(e,t){typeof xr=="object"&&typeof oo!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(xr,function(){"use strict";function e(r){var o=!0,n=!1,i=null,s={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function a(C){return!!(C&&C!==document&&C.nodeName!=="HTML"&&C.nodeName!=="BODY"&&"classList"in C&&"contains"in C.classList)}function c(C){var ct=C.type,Ne=C.tagName;return!!(Ne==="INPUT"&&s[ct]&&!C.readOnly||Ne==="TEXTAREA"&&!C.readOnly||C.isContentEditable)}function p(C){C.classList.contains("focus-visible")||(C.classList.add("focus-visible"),C.setAttribute("data-focus-visible-added",""))}function l(C){C.hasAttribute("data-focus-visible-added")&&(C.classList.remove("focus-visible"),C.removeAttribute("data-focus-visible-added"))}function f(C){C.metaKey||C.altKey||C.ctrlKey||(a(r.activeElement)&&p(r.activeElement),o=!0)}function u(C){o=!1}function h(C){a(C.target)&&(o||c(C.target))&&p(C.target)}function w(C){a(C.target)&&(C.target.classList.contains("focus-visible")||C.target.hasAttribute("data-focus-visible-added"))&&(n=!0,window.clearTimeout(i),i=window.setTimeout(function(){n=!1},100),l(C.target))}function A(C){document.visibilityState==="hidden"&&(n&&(o=!0),Z())}function Z(){document.addEventListener("mousemove",J),document.addEventListener("mousedown",J),document.addEventListener("mouseup",J),document.addEventListener("pointermove",J),document.addEventListener("pointerdown",J),document.addEventListener("pointerup",J),document.addEventListener("touchmove",J),document.addEventListener("touchstart",J),document.addEventListener("touchend",J)}function te(){document.removeEventListener("mousemove",J),document.removeEventListener("mousedown",J),document.removeEventListener("mouseup",J),document.removeEventListener("pointermove",J),document.removeEventListener("pointerdown",J),document.removeEventListener("pointerup",J),document.removeEventListener("touchmove",J),document.removeEventListener("touchstart",J),document.removeEventListener("touchend",J)}function J(C){C.target.nodeName&&C.target.nodeName.toLowerCase()==="html"||(o=!1,te())}document.addEventListener("keydown",f,!0),document.addEventListener("mousedown",u,!0),document.addEventListener("pointerdown",u,!0),document.addEventListener("touchstart",u,!0),document.addEventListener("visibilitychange",A,!0),Z(),r.addEventListener("focus",h,!0),r.addEventListener("blur",w,!0),r.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&r.host?r.host.setAttribute("data-js-focus-visible",""):r.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(r){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var zr=gr((kt,Vr)=>{/*!
- * clipboard.js v2.0.11
- * https://clipboardjs.com/
- *
- * Licensed MIT © Zeno Rocha
- */(function(t,r){typeof kt=="object"&&typeof Vr=="object"?Vr.exports=r():typeof define=="function"&&define.amd?define([],r):typeof kt=="object"?kt.ClipboardJS=r():t.ClipboardJS=r()})(kt,function(){return function(){var e={686:function(o,n,i){"use strict";i.d(n,{default:function(){return Li}});var s=i(279),a=i.n(s),c=i(370),p=i.n(c),l=i(817),f=i.n(l);function u(D){try{return document.execCommand(D)}catch(M){return!1}}var h=function(M){var O=f()(M);return u("cut"),O},w=h;function A(D){var M=document.documentElement.getAttribute("dir")==="rtl",O=document.createElement("textarea");O.style.fontSize="12pt",O.style.border="0",O.style.padding="0",O.style.margin="0",O.style.position="absolute",O.style[M?"right":"left"]="-9999px";var I=window.pageYOffset||document.documentElement.scrollTop;return O.style.top="".concat(I,"px"),O.setAttribute("readonly",""),O.value=D,O}var Z=function(M,O){var I=A(M);O.container.appendChild(I);var W=f()(I);return u("copy"),I.remove(),W},te=function(M){var O=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},I="";return typeof M=="string"?I=Z(M,O):M instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(M==null?void 0:M.type)?I=Z(M.value,O):(I=f()(M),u("copy")),I},J=te;function C(D){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?C=function(O){return typeof O}:C=function(O){return O&&typeof Symbol=="function"&&O.constructor===Symbol&&O!==Symbol.prototype?"symbol":typeof O},C(D)}var ct=function(){var M=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},O=M.action,I=O===void 0?"copy":O,W=M.container,K=M.target,Ce=M.text;if(I!=="copy"&&I!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(K!==void 0)if(K&&C(K)==="object"&&K.nodeType===1){if(I==="copy"&&K.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(I==="cut"&&(K.hasAttribute("readonly")||K.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if(Ce)return J(Ce,{container:W});if(K)return I==="cut"?w(K):J(K,{container:W})},Ne=ct;function Pe(D){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?Pe=function(O){return typeof O}:Pe=function(O){return O&&typeof Symbol=="function"&&O.constructor===Symbol&&O!==Symbol.prototype?"symbol":typeof O},Pe(D)}function xi(D,M){if(!(D instanceof M))throw new TypeError("Cannot call a class as a function")}function Xr(D,M){for(var O=0;O<M.length;O++){var I=M[O];I.enumerable=I.enumerable||!1,I.configurable=!0,"value"in I&&(I.writable=!0),Object.defineProperty(D,I.key,I)}}function yi(D,M,O){return M&&Xr(D.prototype,M),O&&Xr(D,O),D}function Ei(D,M){if(typeof M!="function"&&M!==null)throw new TypeError("Super expression must either be null or a function");D.prototype=Object.create(M&&M.prototype,{constructor:{value:D,writable:!0,configurable:!0}}),M&&dr(D,M)}function dr(D,M){return dr=Object.setPrototypeOf||function(I,W){return I.__proto__=W,I},dr(D,M)}function wi(D){var M=Oi();return function(){var I=Pt(D),W;if(M){var K=Pt(this).constructor;W=Reflect.construct(I,arguments,K)}else W=I.apply(this,arguments);return Ti(this,W)}}function Ti(D,M){return M&&(Pe(M)==="object"||typeof M=="function")?M:Si(D)}function Si(D){if(D===void 0)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return D}function Oi(){if(typeof Reflect=="undefined"||!Reflect.construct||Reflect.construct.sham)return!1;if(typeof Proxy=="function")return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(D){return!1}}function Pt(D){return Pt=Object.setPrototypeOf?Object.getPrototypeOf:function(O){return O.__proto__||Object.getPrototypeOf(O)},Pt(D)}function hr(D,M){var O="data-clipboard-".concat(D);if(M.hasAttribute(O))return M.getAttribute(O)}var Mi=function(D){Ei(O,D);var M=wi(O);function O(I,W){var K;return xi(this,O),K=M.call(this),K.resolveOptions(W),K.listenClick(I),K}return yi(O,[{key:"resolveOptions",value:function(){var W=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof W.action=="function"?W.action:this.defaultAction,this.target=typeof W.target=="function"?W.target:this.defaultTarget,this.text=typeof W.text=="function"?W.text:this.defaultText,this.container=Pe(W.container)==="object"?W.container:document.body}},{key:"listenClick",value:function(W){var K=this;this.listener=p()(W,"click",function(Ce){return K.onClick(Ce)})}},{key:"onClick",value:function(W){var K=W.delegateTarget||W.currentTarget,Ce=this.action(K)||"copy",It=Ne({action:Ce,container:this.container,target:this.target(K),text:this.text(K)});this.emit(It?"success":"error",{action:Ce,text:It,trigger:K,clearSelection:function(){K&&K.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(W){return hr("action",W)}},{key:"defaultTarget",value:function(W){var K=hr("target",W);if(K)return document.querySelector(K)}},{key:"defaultText",value:function(W){return hr("text",W)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function(W){var K=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return J(W,K)}},{key:"cut",value:function(W){return w(W)}},{key:"isSupported",value:function(){var W=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],K=typeof W=="string"?[W]:W,Ce=!!document.queryCommandSupported;return K.forEach(function(It){Ce=Ce&&!!document.queryCommandSupported(It)}),Ce}}]),O}(a()),Li=Mi},828:function(o){var n=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function s(a,c){for(;a&&a.nodeType!==n;){if(typeof a.matches=="function"&&a.matches(c))return a;a=a.parentNode}}o.exports=s},438:function(o,n,i){var s=i(828);function a(l,f,u,h,w){var A=p.apply(this,arguments);return l.addEventListener(u,A,w),{destroy:function(){l.removeEventListener(u,A,w)}}}function c(l,f,u,h,w){return typeof l.addEventListener=="function"?a.apply(null,arguments):typeof u=="function"?a.bind(null,document).apply(null,arguments):(typeof l=="string"&&(l=document.querySelectorAll(l)),Array.prototype.map.call(l,function(A){return a(A,f,u,h,w)}))}function p(l,f,u,h){return function(w){w.delegateTarget=s(w.target,f),w.delegateTarget&&h.call(l,w)}}o.exports=c},879:function(o,n){n.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},n.nodeList=function(i){var s=Object.prototype.toString.call(i);return i!==void 0&&(s==="[object NodeList]"||s==="[object HTMLCollection]")&&"length"in i&&(i.length===0||n.node(i[0]))},n.string=function(i){return typeof i=="string"||i instanceof String},n.fn=function(i){var s=Object.prototype.toString.call(i);return s==="[object Function]"}},370:function(o,n,i){var s=i(879),a=i(438);function c(u,h,w){if(!u&&!h&&!w)throw new Error("Missing required arguments");if(!s.string(h))throw new TypeError("Second argument must be a String");if(!s.fn(w))throw new TypeError("Third argument must be a Function");if(s.node(u))return p(u,h,w);if(s.nodeList(u))return l(u,h,w);if(s.string(u))return f(u,h,w);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function p(u,h,w){return u.addEventListener(h,w),{destroy:function(){u.removeEventListener(h,w)}}}function l(u,h,w){return Array.prototype.forEach.call(u,function(A){A.addEventListener(h,w)}),{destroy:function(){Array.prototype.forEach.call(u,function(A){A.removeEventListener(h,w)})}}}function f(u,h,w){return a(document.body,u,h,w)}o.exports=c},817:function(o){function n(i){var s;if(i.nodeName==="SELECT")i.focus(),s=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var a=i.hasAttribute("readonly");a||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),a||i.removeAttribute("readonly"),s=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var c=window.getSelection(),p=document.createRange();p.selectNodeContents(i),c.removeAllRanges(),c.addRange(p),s=c.toString()}return s}o.exports=n},279:function(o){function n(){}n.prototype={on:function(i,s,a){var c=this.e||(this.e={});return(c[i]||(c[i]=[])).push({fn:s,ctx:a}),this},once:function(i,s,a){var c=this;function p(){c.off(i,p),s.apply(a,arguments)}return p._=s,this.on(i,p,a)},emit:function(i){var s=[].slice.call(arguments,1),a=((this.e||(this.e={}))[i]||[]).slice(),c=0,p=a.length;for(c;c<p;c++)a[c].fn.apply(a[c].ctx,s);return this},off:function(i,s){var a=this.e||(this.e={}),c=a[i],p=[];if(c&&s)for(var l=0,f=c.length;l<f;l++)c[l].fn!==s&&c[l].fn._!==s&&p.push(c[l]);return p.length?a[i]=p:delete a[i],this}},o.exports=n,o.exports.TinyEmitter=n}},t={};function r(o){if(t[o])return t[o].exports;var n=t[o]={exports:{}};return e[o](n,n.exports,r),n.exports}return function(){r.n=function(o){var n=o&&o.__esModule?function(){return o.default}:function(){return o};return r.d(n,{a:n}),n}}(),function(){r.d=function(o,n){for(var i in n)r.o(n,i)&&!r.o(o,i)&&Object.defineProperty(o,i,{enumerable:!0,get:n[i]})}}(),function(){r.o=function(o,n){return Object.prototype.hasOwnProperty.call(o,n)}}(),r(686)}().default})});var Kn=gr((Cw,qn)=>{"use strict";/*!
- * escape-html
- * Copyright(c) 2012-2013 TJ Holowaychuk
- * Copyright(c) 2015 Andreas Lubbe
- * Copyright(c) 2015 Tiancheng "Timothy" Gu
- * MIT Licensed
- */var Va=/["'&<>]/;qn.exports=za;function za(e){var t=""+e,r=Va.exec(t);if(!r)return t;var o,n="",i=0,s=0;for(i=r.index;i<t.length;i++){switch(t.charCodeAt(i)){case 34:o="&quot;";break;case 38:o="&amp;";break;case 39:o="&#39;";break;case 60:o="&lt;";break;case 62:o="&gt;";break;default:continue}s!==i&&(n+=t.substring(s,i)),s=i+1,n+=o}return s!==i?n+t.substring(s,i):n}});var mM=jt(no());/*! *****************************************************************************
-Copyright (c) Microsoft Corporation.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
-***************************************************************************** */var yr=function(e,t){return yr=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(r,o){r.__proto__=o}||function(r,o){for(var n in o)Object.prototype.hasOwnProperty.call(o,n)&&(r[n]=o[n])},yr(e,t)};function se(e,t){if(typeof t!="function"&&t!==null)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");yr(e,t);function r(){this.constructor=e}e.prototype=t===null?Object.create(t):(r.prototype=t.prototype,new r)}function io(e,t,r,o){function n(i){return i instanceof r?i:new r(function(s){s(i)})}return new(r||(r=Promise))(function(i,s){function a(l){try{p(o.next(l))}catch(f){s(f)}}function c(l){try{p(o.throw(l))}catch(f){s(f)}}function p(l){l.done?i(l.value):n(l.value).then(a,c)}p((o=o.apply(e,t||[])).next())})}function Ut(e,t){var r={label:0,sent:function(){if(i[0]&1)throw i[1];return i[1]},trys:[],ops:[]},o,n,i,s;return s={next:a(0),throw:a(1),return:a(2)},typeof Symbol=="function"&&(s[Symbol.iterator]=function(){return this}),s;function a(p){return function(l){return c([p,l])}}function c(p){if(o)throw new TypeError("Generator is already executing.");for(;r;)try{if(o=1,n&&(i=p[0]&2?n.return:p[0]?n.throw||((i=n.return)&&i.call(n),0):n.next)&&!(i=i.call(n,p[1])).done)return i;switch(n=0,i&&(p=[p[0]&2,i.value]),p[0]){case 0:case 1:i=p;break;case 4:return r.label++,{value:p[1],done:!1};case 5:r.label++,n=p[1],p=[0];continue;case 7:p=r.ops.pop(),r.trys.pop();continue;default:if(i=r.trys,!(i=i.length>0&&i[i.length-1])&&(p[0]===6||p[0]===2)){r=0;continue}if(p[0]===3&&(!i||p[1]>i[0]&&p[1]<i[3])){r.label=p[1];break}if(p[0]===6&&r.label<i[1]){r.label=i[1],i=p;break}if(i&&r.label<i[2]){r.label=i[2],r.ops.push(p);break}i[2]&&r.ops.pop(),r.trys.pop();continue}p=t.call(e,r)}catch(l){p=[6,l],n=0}finally{o=i=0}if(p[0]&5)throw p[1];return{value:p[0]?p[1]:void 0,done:!0}}}function ue(e){var t=typeof Symbol=="function"&&Symbol.iterator,r=t&&e[t],o=0;if(r)return r.call(e);if(e&&typeof e.length=="number")return{next:function(){return e&&o>=e.length&&(e=void 0),{value:e&&e[o++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function V(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var o=r.call(e),n,i=[],s;try{for(;(t===void 0||t-- >0)&&!(n=o.next()).done;)i.push(n.value)}catch(a){s={error:a}}finally{try{n&&!n.done&&(r=o.return)&&r.call(o)}finally{if(s)throw s.error}}return i}function z(e,t,r){if(r||arguments.length===2)for(var o=0,n=t.length,i;o<n;o++)(i||!(o in t))&&(i||(i=Array.prototype.slice.call(t,0,o)),i[o]=t[o]);return e.concat(i||Array.prototype.slice.call(t))}function ot(e){return this instanceof ot?(this.v=e,this):new ot(e)}function ao(e,t,r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=r.apply(e,t||[]),n,i=[];return n={},s("next"),s("throw"),s("return"),n[Symbol.asyncIterator]=function(){return this},n;function s(u){o[u]&&(n[u]=function(h){return new Promise(function(w,A){i.push([u,h,w,A])>1||a(u,h)})})}function a(u,h){try{c(o[u](h))}catch(w){f(i[0][3],w)}}function c(u){u.value instanceof ot?Promise.resolve(u.value.v).then(p,l):f(i[0][2],u)}function p(u){a("next",u)}function l(u){a("throw",u)}function f(u,h){u(h),i.shift(),i.length&&a(i[0][0],i[0][1])}}function so(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof ue=="function"?ue(e):e[Symbol.iterator](),r={},o("next"),o("throw"),o("return"),r[Symbol.asyncIterator]=function(){return this},r);function o(i){r[i]=e[i]&&function(s){return new Promise(function(a,c){s=e[i](s),n(a,c,s.done,s.value)})}}function n(i,s,a,c){Promise.resolve(c).then(function(p){i({value:p,done:a})},s)}}function k(e){return typeof e=="function"}function pt(e){var t=function(o){Error.call(o),o.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var Wt=pt(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription:
-`+r.map(function(o,n){return n+1+") "+o.toString()}).join(`
-  `):"",this.name="UnsubscriptionError",this.errors=r}});function Ve(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var Ie=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var s=this._parentage;if(s)if(this._parentage=null,Array.isArray(s))try{for(var a=ue(s),c=a.next();!c.done;c=a.next()){var p=c.value;p.remove(this)}}catch(A){t={error:A}}finally{try{c&&!c.done&&(r=a.return)&&r.call(a)}finally{if(t)throw t.error}}else s.remove(this);var l=this.initialTeardown;if(k(l))try{l()}catch(A){i=A instanceof Wt?A.errors:[A]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=ue(f),h=u.next();!h.done;h=u.next()){var w=h.value;try{co(w)}catch(A){i=i!=null?i:[],A instanceof Wt?i=z(z([],V(i)),V(A.errors)):i.push(A)}}}catch(A){o={error:A}}finally{try{h&&!h.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new Wt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)co(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&Ve(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&Ve(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Er=Ie.EMPTY;function Dt(e){return e instanceof Ie||e&&"closed"in e&&k(e.remove)&&k(e.add)&&k(e.unsubscribe)}function co(e){k(e)?e():e.unsubscribe()}var ke={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var lt={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=lt.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,z([e,t],V(r))):setTimeout.apply(void 0,z([e,t],V(r)))},clearTimeout:function(e){var t=lt.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function Nt(e){lt.setTimeout(function(){var t=ke.onUnhandledError;if(t)t(e);else throw e})}function Se(){}var po=function(){return wr("C",void 0,void 0)}();function lo(e){return wr("E",void 0,e)}function mo(e){return wr("N",e,void 0)}function wr(e,t,r){return{kind:e,value:t,error:r}}var nt=null;function mt(e){if(ke.useDeprecatedSynchronousErrorHandling){var t=!nt;if(t&&(nt={errorThrown:!1,error:null}),e(),t){var r=nt,o=r.errorThrown,n=r.error;if(nt=null,o)throw n}}else e()}function fo(e){ke.useDeprecatedSynchronousErrorHandling&&nt&&(nt.errorThrown=!0,nt.error=e)}var Tt=function(e){se(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,Dt(r)&&r.add(o)):o.destination=Ii,o}return t.create=function(r,o,n){return new it(r,o,n)},t.prototype.next=function(r){this.isStopped?Sr(mo(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Sr(lo(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Sr(po,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(Ie);var $i=Function.prototype.bind;function Tr(e,t){return $i.call(e,t)}var Ri=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){Vt(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){Vt(o)}else Vt(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){Vt(r)}},e}(),it=function(e){se(t,e);function t(r,o,n){var i=e.call(this)||this,s;if(k(r)||!r)s={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var a;i&&ke.useDeprecatedNextContext?(a=Object.create(r),a.unsubscribe=function(){return i.unsubscribe()},s={next:r.next&&Tr(r.next,a),error:r.error&&Tr(r.error,a),complete:r.complete&&Tr(r.complete,a)}):s=r}return i.destination=new Ri(s),i}return t}(Tt);function Vt(e){ke.useDeprecatedSynchronousErrorHandling?fo(e):Nt(e)}function Pi(e){throw e}function Sr(e,t){var r=ke.onStoppedNotification;r&&lt.setTimeout(function(){return r(e,t)})}var Ii={closed:!0,next:Se,error:Pi,complete:Se};var ft=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function ce(e){return e}function uo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Or(e)}function Or(e){return e.length===0?ce:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var j=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=ji(t)?t:new it(t,r,o);return mt(function(){var s=n,a=s.operator,c=s.source;i.add(a?a.call(i,c):c?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=ho(r),new r(function(n,i){var s=new it({next:function(a){try{t(a)}catch(c){i(c),s.unsubscribe()}},error:i,complete:n});o.subscribe(s)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[ft]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Or(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=ho(t),new t(function(o,n){var i;r.subscribe(function(s){return i=s},function(s){return n(s)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function ho(e){var t;return(t=e!=null?e:ke.Promise)!==null&&t!==void 0?t:Promise}function Fi(e){return e&&k(e.next)&&k(e.error)&&k(e.complete)}function ji(e){return e&&e instanceof Tt||Fi(e)&&Dt(e)}function Ui(e){return k(e==null?void 0:e.lift)}function x(e){return function(t){if(Ui(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function S(e,t,r,o,n){return new Wi(e,t,r,o,n)}var Wi=function(e){se(t,e);function t(r,o,n,i,s,a){var c=e.call(this,r)||this;return c.onFinalize=s,c.shouldUnsubscribe=a,c._next=o?function(p){try{o(p)}catch(l){r.error(l)}}:e.prototype._next,c._error=i?function(p){try{i(p)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,c._complete=n?function(){try{n()}catch(p){r.error(p)}finally{this.unsubscribe()}}:e.prototype._complete,c}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(Tt);var ut={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=ut.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new Ie(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ut.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,z([],V(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ut.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,z([],V(e)))},delegate:void 0};var bo=pt(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var v=function(e){se(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new vo(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new bo},t.prototype.next=function(r){var o=this;mt(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var s=ue(o.currentObservers),a=s.next();!a.done;a=s.next()){var c=a.value;c.next(r)}}catch(p){n={error:p}}finally{try{a&&!a.done&&(i=s.return)&&i.call(s)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;mt(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;mt(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,s=n.isStopped,a=n.observers;return i||s?Er:(this.currentObservers=null,a.push(r),new Ie(function(){o.currentObservers=null,Ve(a,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,s=o.isStopped;n?r.error(i):s&&r.complete()},t.prototype.asObservable=function(){var r=new j;return r.source=this,r},t.create=function(r,o){return new vo(r,o)},t}(j);var vo=function(e){se(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:Er},t}(v);var St={now:function(){return(St.delegate||Date).now()},delegate:void 0};var Ot=function(e){se(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=St);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,s=o._infiniteTimeWindow,a=o._timestampProvider,c=o._windowTime;n||(i.push(r),!s&&i.push(a.now()+c)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,s=n._buffer,a=s.slice(),c=0;c<a.length&&!r.closed;c+=i?1:2)r.next(a[c]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,s=r._infiniteTimeWindow,a=(s?1:2)*o;if(o<1/0&&a<i.length&&i.splice(0,i.length-a),!s){for(var c=n.now(),p=0,l=1;l<i.length&&i[l]<=c;l+=2)p=l;p&&i.splice(0,p+1)}},t}(v);var go=function(e){se(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(Ie);var Mt={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=Mt.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,z([e,t],V(r))):setInterval.apply(void 0,z([e,t],V(r)))},clearInterval:function(e){var t=Mt.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var zt=function(e){se(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,s=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(s,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(s,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),Mt.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&Mt.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(s){n=!0,i=s||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,Ve(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(go);var Mr=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=St.now,e}();var qt=function(e){se(t,e);function t(r,o){o===void 0&&(o=Mr.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Mr);var ie=new qt(zt),Lr=ie;var xo=function(e){se(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=ut.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var s=r.actions;o!=null&&((i=s[s.length-1])===null||i===void 0?void 0:i.id)!==o&&(ut.cancelAnimationFrame(o),r._scheduled=void 0)},t}(zt);var yo=function(e){se(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(qt);var de=new yo(xo);var L=new j(function(e){return e.complete()});function Kt(e){return e&&k(e.schedule)}function _r(e){return e[e.length-1]}function Je(e){return k(_r(e))?e.pop():void 0}function Ae(e){return Kt(_r(e))?e.pop():void 0}function Qt(e,t){return typeof _r(e)=="number"?e.pop():t}var dt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Yt(e){return k(e==null?void 0:e.then)}function Bt(e){return k(e[ft])}function Gt(e){return Symbol.asyncIterator&&k(e==null?void 0:e[Symbol.asyncIterator])}function Jt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Di(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var Xt=Di();function Zt(e){return k(e==null?void 0:e[Xt])}function er(e){return ao(this,arguments,function(){var r,o,n,i;return Ut(this,function(s){switch(s.label){case 0:r=e.getReader(),s.label=1;case 1:s.trys.push([1,,9,10]),s.label=2;case 2:return[4,ot(r.read())];case 3:return o=s.sent(),n=o.value,i=o.done,i?[4,ot(void 0)]:[3,5];case 4:return[2,s.sent()];case 5:return[4,ot(n)];case 6:return[4,s.sent()];case 7:return s.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function tr(e){return k(e==null?void 0:e.getReader)}function N(e){if(e instanceof j)return e;if(e!=null){if(Bt(e))return Ni(e);if(dt(e))return Vi(e);if(Yt(e))return zi(e);if(Gt(e))return Eo(e);if(Zt(e))return qi(e);if(tr(e))return Ki(e)}throw Jt(e)}function Ni(e){return new j(function(t){var r=e[ft]();if(k(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function Vi(e){return new j(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function zi(e){return new j(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,Nt)})}function qi(e){return new j(function(t){var r,o;try{for(var n=ue(e),i=n.next();!i.done;i=n.next()){var s=i.value;if(t.next(s),t.closed)return}}catch(a){r={error:a}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Eo(e){return new j(function(t){Qi(e,t).catch(function(r){return t.error(r)})})}function Ki(e){return Eo(er(e))}function Qi(e,t){var r,o,n,i;return io(this,void 0,void 0,function(){var s,a;return Ut(this,function(c){switch(c.label){case 0:c.trys.push([0,5,6,11]),r=so(e),c.label=1;case 1:return[4,r.next()];case 2:if(o=c.sent(),!!o.done)return[3,4];if(s=o.value,t.next(s),t.closed)return[2];c.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return a=c.sent(),n={error:a},[3,11];case 6:return c.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:c.sent(),c.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function xe(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function Oe(e,t){return t===void 0&&(t=0),x(function(r,o){r.subscribe(S(o,function(n){return xe(o,e,function(){return o.next(n)},t)},function(){return xe(o,e,function(){return o.complete()},t)},function(n){return xe(o,e,function(){return o.error(n)},t)}))})}function ze(e,t){return t===void 0&&(t=0),x(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function wo(e,t){return N(e).pipe(ze(t),Oe(t))}function To(e,t){return N(e).pipe(ze(t),Oe(t))}function So(e,t){return new j(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function Oo(e,t){return new j(function(r){var o;return xe(r,t,function(){o=e[Xt](),xe(r,t,function(){var n,i,s;try{n=o.next(),i=n.value,s=n.done}catch(a){r.error(a);return}s?r.complete():r.next(i)},0,!0)}),function(){return k(o==null?void 0:o.return)&&o.return()}})}function rr(e,t){if(!e)throw new Error("Iterable cannot be null");return new j(function(r){xe(r,t,function(){var o=e[Symbol.asyncIterator]();xe(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function Mo(e,t){return rr(er(e),t)}function Lo(e,t){if(e!=null){if(Bt(e))return wo(e,t);if(dt(e))return So(e,t);if(Yt(e))return To(e,t);if(Gt(e))return rr(e,t);if(Zt(e))return Oo(e,t);if(tr(e))return Mo(e,t)}throw Jt(e)}function fe(e,t){return t?Lo(e,t):N(e)}function $(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ae(e);return fe(e,r)}function Ar(e,t){var r=k(e)?e:function(){return e},o=function(n){return n.error(r())};return new j(t?function(n){return t.schedule(o,0,n)}:o)}var or=pt(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function _o(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return x(function(r,o){var n=0;r.subscribe(S(o,function(i){o.next(e.call(t,i,n++))}))})}var Yi=Array.isArray;function Bi(e,t){return Yi(t)?e.apply(void 0,z([],V(t))):e(t)}function Xe(e){return m(function(t){return Bi(e,t)})}var Gi=Array.isArray,Ji=Object.getPrototypeOf,Xi=Object.prototype,Zi=Object.keys;function Ao(e){if(e.length===1){var t=e[0];if(Gi(t))return{args:t,keys:null};if(ea(t)){var r=Zi(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function ea(e){return e&&typeof e=="object"&&Ji(e)===Xi}function Co(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ae(e),o=Je(e),n=Ao(e),i=n.args,s=n.keys;if(i.length===0)return fe([],r);var a=new j(Cr(i,r,s?function(c){return Co(s,c)}:ce));return o?a.pipe(Xe(o)):a}function Cr(e,t,r){return r===void 0&&(r=ce),function(o){ko(t,function(){for(var n=e.length,i=new Array(n),s=n,a=n,c=function(l){ko(t,function(){var f=fe(e[l],t),u=!1;f.subscribe(S(o,function(h){i[l]=h,u||(u=!0,a--),a||o.next(r(i.slice()))},function(){--s||o.complete()}))},o)},p=0;p<n;p++)c(p)},o)}}function ko(e,t,r){e?xe(r,e,t):t()}function Ho(e,t,r,o,n,i,s,a){var c=[],p=0,l=0,f=!1,u=function(){f&&!c.length&&!p&&t.complete()},h=function(A){return p<o?w(A):c.push(A)},w=function(A){i&&t.next(A),p++;var Z=!1;N(r(A,l++)).subscribe(S(t,function(te){n==null||n(te),i?h(te):t.next(te)},function(){Z=!0},void 0,function(){if(Z)try{p--;for(var te=function(){var J=c.shift();s?xe(t,s,function(){return w(J)}):w(J)};c.length&&p<o;)te();u()}catch(J){t.error(J)}}))};return e.subscribe(S(t,h,function(){f=!0,u()})),function(){a==null||a()}}function re(e,t,r){return r===void 0&&(r=1/0),k(t)?re(function(o,n){return m(function(i,s){return t(o,i,n,s)})(N(e(o,n)))},r):(typeof t=="number"&&(r=t),x(function(o,n){return Ho(o,n,e,r)}))}function ht(e){return e===void 0&&(e=1/0),re(ce,e)}function $o(){return ht(1)}function Fe(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return $o()(fe(e,Ae(e)))}function H(e){return new j(function(t){N(e()).subscribe(t)})}var ta=["addListener","removeListener"],ra=["addEventListener","removeEventListener"],oa=["on","off"];function d(e,t,r,o){if(k(r)&&(o=r,r=void 0),o)return d(e,t,r).pipe(Xe(o));var n=V(aa(e)?ra.map(function(a){return function(c){return e[a](t,c,r)}}):na(e)?ta.map(Ro(e,t)):ia(e)?oa.map(Ro(e,t)):[],2),i=n[0],s=n[1];if(!i&&dt(e))return re(function(a){return d(a,t,r)})(N(e));if(!i)throw new TypeError("Invalid event target");return new j(function(a){var c=function(){for(var p=[],l=0;l<arguments.length;l++)p[l]=arguments[l];return a.next(1<p.length?p:p[0])};return i(c),function(){return s(c)}})}function Ro(e,t){return function(r){return function(o){return e[r](t,o)}}}function na(e){return k(e.addListener)&&k(e.removeListener)}function ia(e){return k(e.on)&&k(e.off)}function aa(e){return k(e.addEventListener)&&k(e.removeEventListener)}function nr(e,t,r){return r?nr(e,t).pipe(Xe(r)):new j(function(o){var n=function(){for(var s=[],a=0;a<arguments.length;a++)s[a]=arguments[a];return o.next(s.length===1?s[0]:s)},i=e(n);return k(t)?function(){return t(n,i)}:void 0})}function Ze(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Lr);var o=-1;return t!=null&&(Kt(t)?r=t:o=t),new j(function(n){var i=_o(e)?+e-r.now():e;i<0&&(i=0);var s=0;return r.schedule(function(){n.closed||(n.next(s++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function T(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ae(e),o=Qt(e,1/0),n=e;return n.length?n.length===1?N(n[0]):ht(o)(fe(n,r)):L}var qe=new j(Se);var sa=Array.isArray;function bt(e){return e.length===1&&sa(e[0])?e[0]:e}function g(e,t){return x(function(r,o){var n=0;r.subscribe(S(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function Lt(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Je(e),o=bt(e);return o.length?new j(function(n){var i=o.map(function(){return[]}),s=o.map(function(){return!1});n.add(function(){i=s=null});for(var a=function(p){N(o[p]).subscribe(S(n,function(l){if(i[p].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,z([],V(f))):f),i.some(function(u,h){return!u.length&&s[h]})&&n.complete()}},function(){s[p]=!0,!i[p].length&&n.complete()}))},c=0;!n.closed&&c<o.length;c++)a(c);return function(){i=s=null}}):L}function Po(e){return x(function(t,r){var o=!1,n=null,i=null,s=!1,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var p=n;n=null,r.next(p)}s&&r.complete()},c=function(){i=null,s&&r.complete()};t.subscribe(S(r,function(p){o=!0,n=p,i||N(e(p)).subscribe(i=S(r,a,c))},function(){s=!0,(!o||!i||i.closed)&&r.complete()}))})}function Me(e,t){return t===void 0&&(t=ie),Po(function(){return Ze(e,t)})}function Ke(e,t){return t===void 0&&(t=null),t=t!=null?t:e,x(function(r,o){var n=[],i=0;r.subscribe(S(o,function(s){var a,c,p,l,f=null;i++%t===0&&n.push([]);try{for(var u=ue(n),h=u.next();!h.done;h=u.next()){var w=h.value;w.push(s),e<=w.length&&(f=f!=null?f:[],f.push(w))}}catch(te){a={error:te}}finally{try{h&&!h.done&&(c=u.return)&&c.call(u)}finally{if(a)throw a.error}}if(f)try{for(var A=ue(f),Z=A.next();!Z.done;Z=A.next()){var w=Z.value;Ve(n,w),o.next(w)}}catch(te){p={error:te}}finally{try{Z&&!Z.done&&(l=A.return)&&l.call(A)}finally{if(p)throw p.error}}},function(){var s,a;try{for(var c=ue(n),p=c.next();!p.done;p=c.next()){var l=p.value;o.next(l)}}catch(f){s={error:f}}finally{try{p&&!p.done&&(a=c.return)&&a.call(c)}finally{if(s)throw s.error}}o.complete()},void 0,function(){n=null}))})}function he(e){return x(function(t,r){var o=null,n=!1,i;o=t.subscribe(S(r,void 0,void 0,function(s){i=N(e(s,he(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function Io(e,t,r,o,n){return function(i,s){var a=r,c=t,p=0;i.subscribe(S(s,function(l){var f=p++;c=a?e(c,l,f):(a=!0,l),o&&s.next(c)},n&&function(){a&&s.next(c),s.complete()}))}}function kr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Je(e);return r?uo(kr.apply(void 0,z([],V(e))),Xe(r)):x(function(o,n){Cr(z([o],V(bt(e))))(n)})}function je(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return kr.apply(void 0,z([],V(e)))}function be(e,t){return t===void 0&&(t=ie),x(function(r,o){var n=null,i=null,s=null,a=function(){if(n){n.unsubscribe(),n=null;var p=i;i=null,o.next(p)}};function c(){var p=s+e,l=t.now();if(l<p){n=this.schedule(void 0,p-l),o.add(n);return}a()}r.subscribe(S(o,function(p){i=p,s=t.now(),n||(n=t.schedule(c,e),o.add(n))},function(){a(),o.complete()},void 0,function(){i=n=null}))})}function Qe(e){return x(function(t,r){var o=!1;t.subscribe(S(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function ye(e){return e<=0?function(){return L}:x(function(t,r){var o=0;t.subscribe(S(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function ee(){return x(function(e,t){e.subscribe(S(t,Se))})}function Fo(e){return m(function(){return e})}function Hr(e,t){return t?function(r){return Fe(t.pipe(ye(1),ee()),r.pipe(Hr(e)))}:re(function(r,o){return N(e(r,o)).pipe(ye(1),Fo(r))})}function Ye(e,t){t===void 0&&(t=ie);var r=Ze(e,t);return Hr(function(){return r})}function Y(e,t){return t===void 0&&(t=ce),e=e!=null?e:ca,x(function(r,o){var n,i=!0;r.subscribe(S(o,function(s){var a=t(s);(i||!e(n,a))&&(i=!1,n=a,o.next(s))}))})}function ca(e,t){return e===t}function X(e,t){return Y(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function jo(e){return e===void 0&&(e=pa),x(function(t,r){var o=!1;t.subscribe(S(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function pa(){return new or}function oe(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return Fe(r,$.apply(void 0,z([],V(e))))}}function _(e){return x(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function He(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?g(function(n,i){return e(n,i,o)}):ce,ye(1),r?Qe(t):jo(function(){return new or}))}}function $r(e){return e<=0?function(){return L}:x(function(t,r){var o=[];t.subscribe(S(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var s=ue(o),a=s.next();!a.done;a=s.next()){var c=a.value;r.next(c)}}catch(p){n={error:p}}finally{try{a&&!a.done&&(i=s.return)&&i.call(s)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function Uo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ae(e),o=Qt(e,1/0);return e=bt(e),x(function(n,i){ht(o)(fe(z([n],V(e)),r)).subscribe(i)})}function $e(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Uo.apply(void 0,z([],V(e)))}function at(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return L}:x(function(n,i){var s=0,a,c=function(){if(a==null||a.unsubscribe(),a=null,o!=null){var l=typeof o=="number"?Ze(o):N(o(s)),f=S(i,function(){f.unsubscribe(),p()});l.subscribe(f)}else p()},p=function(){var l=!1;a=n.subscribe(S(i,void 0,function(){++s<r?a?c():l=!0:i.complete()})),l&&c()};p()})}function Rr(e,t){return x(Io(e,t,arguments.length>=2,!0))}function le(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new v}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,s=i===void 0?!0:i,a=e.resetOnRefCountZero,c=a===void 0?!0:a;return function(p){var l,f,u,h=0,w=!1,A=!1,Z=function(){f==null||f.unsubscribe(),f=void 0},te=function(){Z(),l=u=void 0,w=A=!1},J=function(){var C=l;te(),C==null||C.unsubscribe()};return x(function(C,ct){h++,!A&&!w&&Z();var Ne=u=u!=null?u:r();ct.add(function(){h--,h===0&&!A&&!w&&(f=Pr(J,c))}),Ne.subscribe(ct),!l&&h>0&&(l=new it({next:function(Pe){return Ne.next(Pe)},error:function(Pe){A=!0,Z(),f=Pr(te,n,Pe),Ne.error(Pe)},complete:function(){w=!0,Z(),f=Pr(te,s),Ne.complete()}}),N(C).subscribe(l))})(p)}}function Pr(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new it({next:function(){n.unsubscribe(),e()}});return N(t.apply(void 0,z([],V(r)))).subscribe(n)}}function B(e,t,r){var o,n,i,s,a=!1;return e&&typeof e=="object"?(o=e.bufferSize,s=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,a=i===void 0?!1:i,r=e.scheduler):s=e!=null?e:1/0,le({connector:function(){return new Ot(s,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:a})}function Le(e){return g(function(t,r){return e<=r})}function Ir(e){return x(function(t,r){var o=!1,n=S(r,function(){n==null||n.unsubscribe(),o=!0},Se);N(e).subscribe(n),t.subscribe(S(r,function(i){return o&&r.next(i)}))})}function q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Ae(e);return x(function(o,n){(r?Fe(e,o,r):Fe(e,o)).subscribe(n)})}function b(e,t){return x(function(r,o){var n=null,i=0,s=!1,a=function(){return s&&!n&&o.complete()};r.subscribe(S(o,function(c){n==null||n.unsubscribe();var p=0,l=i++;N(e(c,l)).subscribe(n=S(o,function(f){return o.next(t?t(c,f,l,p++):f)},function(){n=null,a()}))},function(){s=!0,a()}))})}function U(e){return x(function(t,r){N(e).subscribe(S(r,function(){return r.complete()},Se)),!r.closed&&t.subscribe(r)})}function Fr(e,t){return t===void 0&&(t=!1),x(function(r,o){var n=0;r.subscribe(S(o,function(i){var s=e(i,n++);(s||t)&&o.next(i),!s&&o.complete()}))})}function y(e,t,r){var o=k(e)||t||r?{next:e,error:t,complete:r}:e;return o?x(function(n,i){var s;(s=o.subscribe)===null||s===void 0||s.call(o);var a=!0;n.subscribe(S(i,function(c){var p;(p=o.next)===null||p===void 0||p.call(o,c),i.next(c)},function(){var c;a=!1,(c=o.complete)===null||c===void 0||c.call(o),i.complete()},function(c){var p;a=!1,(p=o.error)===null||p===void 0||p.call(o,c),i.error(c)},function(){var c,p;a&&((c=o.unsubscribe)===null||c===void 0||c.call(o)),(p=o.finalize)===null||p===void 0||p.call(o)}))}):ce}function Wo(e,t){return x(function(r,o){var n=t!=null?t:{},i=n.leading,s=i===void 0?!0:i,a=n.trailing,c=a===void 0?!1:a,p=!1,l=null,f=null,u=!1,h=function(){f==null||f.unsubscribe(),f=null,c&&(Z(),u&&o.complete())},w=function(){f=null,u&&o.complete()},A=function(te){return f=N(e(te)).subscribe(S(o,h,w))},Z=function(){if(p){p=!1;var te=l;l=null,o.next(te),!u&&A(te)}};r.subscribe(S(o,function(te){p=!0,l=te,!(f&&!f.closed)&&(s?Z():A(te))},function(){u=!0,!(c&&p&&f&&!f.closed)&&o.complete()}))})}function _t(e,t,r){t===void 0&&(t=ie);var o=Ze(e,t);return Wo(function(){return o},r)}function ae(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Je(e);return x(function(o,n){for(var i=e.length,s=new Array(i),a=e.map(function(){return!1}),c=!1,p=function(f){N(e[f]).subscribe(S(n,function(u){s[f]=u,!c&&!a[f]&&(a[f]=!0,(c=a.every(ce))&&(a=null))},Se))},l=0;l<i;l++)p(l);o.subscribe(S(n,function(f){if(c){var u=z([f],V(s));n.next(r?r.apply(void 0,z([],V(u))):u)}}))})}function Do(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return x(function(r,o){Lt.apply(void 0,z([r],V(e))).subscribe(o)})}function jr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Do.apply(void 0,z([],V(e)))}function No(){let e=new Ot(1);return d(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function R(e,t=document){return Array.from(t.querySelectorAll(e))}function P(e,t=document){let r=me(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function me(e,t=document){return t.querySelector(e)||void 0}function Re(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var la=T(d(document.body,"focusin"),d(document.body,"focusout")).pipe(be(1),q(void 0),m(()=>Re()||document.body),B(1));function vt(e){return la.pipe(m(t=>e.contains(t)),Y())}function Vo(e,t){return T(d(e,"mouseenter").pipe(m(()=>!0)),d(e,"mouseleave").pipe(m(()=>!1))).pipe(t?be(t):ce,q(!1))}function Ue(e){return{x:e.offsetLeft,y:e.offsetTop}}function zo(e){return T(d(window,"load"),d(window,"resize")).pipe(Me(0,de),m(()=>Ue(e)),q(Ue(e)))}function ir(e){return{x:e.scrollLeft,y:e.scrollTop}}function et(e){return T(d(e,"scroll"),d(window,"resize")).pipe(Me(0,de),m(()=>ir(e)),q(ir(e)))}function qo(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)qo(e,r)}function E(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)qo(o,n);return o}function ar(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function gt(e){let t=E("script",{src:e});return H(()=>(document.head.appendChild(t),T(d(t,"load"),d(t,"error").pipe(b(()=>Ar(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),_(()=>document.head.removeChild(t)),ye(1))))}var Ko=new v,ma=H(()=>typeof ResizeObserver=="undefined"?gt("https://unpkg.com/resize-observer-polyfill"):$(void 0)).pipe(m(()=>new ResizeObserver(e=>{for(let t of e)Ko.next(t)})),b(e=>T(qe,$(e)).pipe(_(()=>e.disconnect()))),B(1));function pe(e){return{width:e.offsetWidth,height:e.offsetHeight}}function Ee(e){return ma.pipe(y(t=>t.observe(e)),b(t=>Ko.pipe(g(({target:r})=>r===e),_(()=>t.unobserve(e)),m(()=>pe(e)))),q(pe(e)))}function xt(e){return{width:e.scrollWidth,height:e.scrollHeight}}function sr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}var Qo=new v,fa=H(()=>$(new IntersectionObserver(e=>{for(let t of e)Qo.next(t)},{threshold:0}))).pipe(b(e=>T(qe,$(e)).pipe(_(()=>e.disconnect()))),B(1));function yt(e){return fa.pipe(y(t=>t.observe(e)),b(t=>Qo.pipe(g(({target:r})=>r===e),_(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function Yo(e,t=16){return et(e).pipe(m(({y:r})=>{let o=pe(e),n=xt(e);return r>=n.height-o.height-t}),Y())}var cr={drawer:P("[data-md-toggle=drawer]"),search:P("[data-md-toggle=search]")};function Bo(e){return cr[e].checked}function Be(e,t){cr[e].checked!==t&&cr[e].click()}function We(e){let t=cr[e];return d(t,"change").pipe(m(()=>t.checked),q(t.checked))}function ua(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function da(){return T(d(window,"compositionstart").pipe(m(()=>!0)),d(window,"compositionend").pipe(m(()=>!1))).pipe(q(!1))}function Go(){let e=d(window,"keydown").pipe(g(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:Bo("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),g(({mode:t,type:r})=>{if(t==="global"){let o=Re();if(typeof o!="undefined")return!ua(o,r)}return!0}),le());return da().pipe(b(t=>t?L:e))}function ve(){return new URL(location.href)}function st(e,t=!1){if(G("navigation.instant")&&!t){let r=E("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function Jo(){return new v}function Xo(){return location.hash.slice(1)}function Zo(e){let t=E("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function ha(e){return T(d(window,"hashchange"),e).pipe(m(Xo),q(Xo()),g(t=>t.length>0),B(1))}function en(e){return ha(e).pipe(m(t=>me(`[id="${t}"]`)),g(t=>typeof t!="undefined"))}function At(e){let t=matchMedia(e);return nr(r=>t.addListener(()=>r(t.matches))).pipe(q(t.matches))}function tn(){let e=matchMedia("print");return T(d(window,"beforeprint").pipe(m(()=>!0)),d(window,"afterprint").pipe(m(()=>!1))).pipe(q(e.matches))}function Ur(e,t){return e.pipe(b(r=>r?t():L))}function Wr(e,t){return new j(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let s=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+s*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function De(e,t){return Wr(e,t).pipe(b(r=>r.text()),m(r=>JSON.parse(r)),B(1))}function rn(e,t){let r=new DOMParser;return Wr(e,t).pipe(b(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),B(1))}function on(e,t){let r=new DOMParser;return Wr(e,t).pipe(b(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),B(1))}function nn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function an(){return T(d(window,"scroll",{passive:!0}),d(window,"resize",{passive:!0})).pipe(m(nn),q(nn()))}function sn(){return{width:innerWidth,height:innerHeight}}function cn(){return d(window,"resize",{passive:!0}).pipe(m(sn),q(sn()))}function pn(){return Q([an(),cn()]).pipe(m(([e,t])=>({offset:e,size:t})),B(1))}function pr(e,{viewport$:t,header$:r}){let o=t.pipe(X("size")),n=Q([o,r]).pipe(m(()=>Ue(e)));return Q([r,t,n]).pipe(m(([{height:i},{offset:s,size:a},{x:c,y:p}])=>({offset:{x:s.x-c,y:s.y-p+i},size:a})))}function ba(e){return d(e,"message",t=>t.data)}function va(e){let t=new v;return t.subscribe(r=>e.postMessage(r)),t}function ln(e,t=new Worker(e)){let r=ba(t),o=va(t),n=new v;n.subscribe(o);let i=o.pipe(ee(),oe(!0));return n.pipe(ee(),$e(r.pipe(U(i))),le())}var ga=P("#__config"),Et=JSON.parse(ga.textContent);Et.base=`${new URL(Et.base,ve())}`;function we(){return Et}function G(e){return Et.features.includes(e)}function ge(e,t){return typeof t!="undefined"?Et.translations[e].replace("#",t.toString()):Et.translations[e]}function Te(e,t=document){return P(`[data-md-component=${e}]`,t)}function ne(e,t=document){return R(`[data-md-component=${e}]`,t)}function xa(e){let t=P(".md-typeset > :first-child",e);return d(t,"click",{once:!0}).pipe(m(()=>P(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function mn(e){if(!G("announce.dismiss")||!e.childElementCount)return L;if(!e.hidden){let t=P(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return H(()=>{let t=new v;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),xa(e).pipe(y(r=>t.next(r)),_(()=>t.complete()),m(r=>F({ref:e},r)))})}function ya(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function fn(e,t){let r=new v;return r.subscribe(({hidden:o})=>{e.hidden=o}),ya(e,t).pipe(y(o=>r.next(o)),_(()=>r.complete()),m(o=>F({ref:e},o)))}function Ct(e,t){return t==="inline"?E("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},E("div",{class:"md-tooltip__inner md-typeset"})):E("div",{class:"md-tooltip",id:e,role:"tooltip"},E("div",{class:"md-tooltip__inner md-typeset"}))}function un(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return E("aside",{class:"md-annotation",tabIndex:0},Ct(t),E("a",{href:r,class:"md-annotation__index",tabIndex:-1},E("span",{"data-md-annotation-id":e})))}else return E("aside",{class:"md-annotation",tabIndex:0},Ct(t),E("span",{class:"md-annotation__index",tabIndex:-1},E("span",{"data-md-annotation-id":e})))}function dn(e){return E("button",{class:"md-clipboard md-icon",title:ge("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}function Dr(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(c=>!e.terms[c]).reduce((c,p)=>[...c,E("del",null,p)," "],[]).slice(0,-1),i=we(),s=new URL(e.location,i.base);G("search.highlight")&&s.searchParams.set("h",Object.entries(e.terms).filter(([,c])=>c).reduce((c,[p])=>`${c} ${p}`.trim(),""));let{tags:a}=we();return E("a",{href:`${s}`,class:"md-search-result__link",tabIndex:-1},E("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&E("div",{class:"md-search-result__icon md-icon"}),r>0&&E("h1",null,e.title),r<=0&&E("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&e.tags.map(c=>{let p=a?c in a?`md-tag-icon md-tag--${a[c]}`:"md-tag-icon":"";return E("span",{class:`md-tag ${p}`},c)}),o>0&&n.length>0&&E("p",{class:"md-search-result__terms"},ge("search.result.term.missing"),": ",...n)))}function hn(e){let t=e[0].score,r=[...e],o=we(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),s=r.findIndex(l=>l.score<t);s===-1&&(s=r.length);let a=r.slice(0,s),c=r.slice(s),p=[Dr(i,2|+(!n&&s===0)),...a.map(l=>Dr(l,1)),...c.length?[E("details",{class:"md-search-result__more"},E("summary",{tabIndex:-1},E("div",null,c.length>0&&c.length===1?ge("search.result.more.one"):ge("search.result.more.other",c.length))),...c.map(l=>Dr(l,1)))]:[]];return E("li",{class:"md-search-result__item"},p)}function bn(e){return E("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>E("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?ar(r):r)))}function Nr(e){let t=`tabbed-control tabbed-control--${e}`;return E("div",{class:t,hidden:!0},E("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function vn(e){return E("div",{class:"md-typeset__scrollwrap"},E("div",{class:"md-typeset__table"},e))}function Ea(e){let t=we(),r=new URL(`../${e.version}/`,t.base);return E("li",{class:"md-version__item"},E("a",{href:`${r}`,class:"md-version__link"},e.title))}function gn(e,t){return e=e.filter(r=>{var o;return!((o=r.properties)!=null&&o.hidden)}),E("div",{class:"md-version"},E("button",{class:"md-version__current","aria-label":ge("select.version")},t.title),E("ul",{class:"md-version__list"},e.map(Ea)))}var wa=0;function Ta(e,t){document.body.append(e);let{width:r}=pe(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=sr(t),n=typeof o!="undefined"?et(o):$({x:0,y:0}),i=T(vt(t),Vo(t)).pipe(Y());return Q([i,n]).pipe(m(([s,a])=>{let{x:c,y:p}=Ue(t),l=pe(t),f=t.closest("table");return f&&t.parentElement&&(c+=f.offsetLeft+t.parentElement.offsetLeft,p+=f.offsetTop+t.parentElement.offsetTop),{active:s,offset:{x:c-a.x+l.width/2-r/2,y:p-a.y+l.height+8}}}))}function Ge(e){let t=e.title;if(!t.length)return L;let r=`__tooltip_${wa++}`,o=Ct(r,"inline"),n=P(".md-typeset",o);return n.innerHTML=t,H(()=>{let i=new v;return i.subscribe({next({offset:s}){o.style.setProperty("--md-tooltip-x",`${s.x}px`),o.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),T(i.pipe(g(({active:s})=>s)),i.pipe(be(250),g(({active:s})=>!s))).subscribe({next({active:s}){s?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(Me(16,de)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(_t(125,de),g(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?o.style.setProperty("--md-tooltip-0",`${-s}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),Ta(o,e).pipe(y(s=>i.next(s)),_(()=>i.complete()),m(s=>F({ref:e},s)))}).pipe(ze(ie))}function Sa(e,t){let r=H(()=>Q([zo(e),et(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:s,height:a}=pe(e);return{x:o-i.x+s/2,y:n-i.y+a/2}}));return vt(e).pipe(b(o=>r.pipe(m(n=>({active:o,offset:n})),ye(+!o||1/0))))}function xn(e,t,{target$:r}){let[o,n]=Array.from(e.children);return H(()=>{let i=new v,s=i.pipe(ee(),oe(!0));return i.subscribe({next({offset:a}){e.style.setProperty("--md-tooltip-x",`${a.x}px`),e.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),yt(e).pipe(U(s)).subscribe(a=>{e.toggleAttribute("data-md-visible",a)}),T(i.pipe(g(({active:a})=>a)),i.pipe(be(250),g(({active:a})=>!a))).subscribe({next({active:a}){a?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(Me(16,de)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(_t(125,de),g(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?e.style.setProperty("--md-tooltip-0",`${-a}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),d(n,"click").pipe(U(s),g(a=>!(a.metaKey||a.ctrlKey))).subscribe(a=>{a.stopPropagation(),a.preventDefault()}),d(n,"mousedown").pipe(U(s),ae(i)).subscribe(([a,{active:c}])=>{var p;if(a.button!==0||a.metaKey||a.ctrlKey)a.preventDefault();else if(c){a.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(p=Re())==null||p.blur()}}),r.pipe(U(s),g(a=>a===o),Ye(125)).subscribe(()=>e.focus()),Sa(e,t).pipe(y(a=>i.next(a)),_(()=>i.complete()),m(a=>F({ref:e},a)))})}function Oa(e){return e.tagName==="CODE"?R(".c, .c1, .cm",e):[e]}function Ma(e){let t=[];for(let r of Oa(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let s;for(;s=/(\(\d+\))(!)?/.exec(i.textContent);){let[,a,c]=s;if(typeof c=="undefined"){let p=i.splitText(s.index);i=p.splitText(a.length),t.push(p)}else{i.textContent=a,t.push(i);break}}}}return t}function yn(e,t){t.append(...Array.from(e.childNodes))}function lr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,s=new Map;for(let a of Ma(t)){let[,c]=a.textContent.match(/\((\d+)\)/);me(`:scope > li:nth-child(${c})`,e)&&(s.set(c,un(c,i)),a.replaceWith(s.get(c)))}return s.size===0?L:H(()=>{let a=new v,c=a.pipe(ee(),oe(!0)),p=[];for(let[l,f]of s)p.push([P(".md-typeset",f),P(`:scope > li:nth-child(${l})`,e)]);return o.pipe(U(c)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of p)l?yn(f,u):yn(u,f)}),T(...[...s].map(([,l])=>xn(l,t,{target$:r}))).pipe(_(()=>a.complete()),le())})}function En(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return En(t)}}function wn(e,t){return H(()=>{let r=En(e);return typeof r!="undefined"?lr(r,e,t):L})}var Tn=jt(zr());var La=0;function Sn(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return Sn(t)}}function _a(e){return Ee(e).pipe(m(({width:t})=>({scrollable:xt(e).width>t})),X("scrollable"))}function On(e,t){let{matches:r}=matchMedia("(hover)"),o=H(()=>{let n=new v,i=n.pipe($r(1));n.subscribe(({scrollable:c})=>{c&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let s=[];if(Tn.default.isSupported()&&(e.closest(".copy")||G("content.code.copy")&&!e.closest(".no-copy"))){let c=e.closest("pre");c.id=`__code_${La++}`;let p=dn(c.id);c.insertBefore(p,e),G("content.tooltips")&&s.push(Ge(p))}let a=e.closest(".highlight");if(a instanceof HTMLElement){let c=Sn(a);if(typeof c!="undefined"&&(a.classList.contains("annotate")||G("content.code.annotate"))){let p=lr(c,e,t);s.push(Ee(a).pipe(U(i),m(({width:l,height:f})=>l&&f),Y(),b(l=>l?p:L)))}}return _a(e).pipe(y(c=>n.next(c)),_(()=>n.complete()),m(c=>F({ref:e},c)),$e(...s))});return G("content.lazy")?yt(e).pipe(g(n=>n),ye(1),b(()=>o)):o}function Aa(e,{target$:t,print$:r}){let o=!0;return T(t.pipe(m(n=>n.closest("details:not([open])")),g(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(g(n=>n||!o),y(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function Mn(e,t){return H(()=>{let r=new v;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),Aa(e,t).pipe(y(o=>r.next(o)),_(()=>r.complete()),m(o=>F({ref:e},o)))})}var Ln=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var qr,ka=0;function Ha(){return typeof mermaid=="undefined"||mermaid instanceof Element?gt("https://unpkg.com/mermaid@10.7.0/dist/mermaid.min.js"):$(void 0)}function _n(e){return e.classList.remove("mermaid"),qr||(qr=Ha().pipe(y(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Ln,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),B(1))),qr.subscribe(()=>ro(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${ka++}`,r=E("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),s=r.attachShadow({mode:"closed"});s.innerHTML=n,e.replaceWith(r),i==null||i(s)})),qr.pipe(m(()=>({ref:e})))}var An=E("table");function Cn(e){return e.replaceWith(An),An.replaceWith(vn(e)),$({ref:e})}function $a(e){let t=e.find(r=>r.checked)||e[0];return T(...e.map(r=>d(r,"change").pipe(m(()=>P(`label[for="${r.id}"]`))))).pipe(q(P(`label[for="${t.id}"]`)),m(r=>({active:r})))}function kn(e,{viewport$:t,target$:r}){let o=P(".tabbed-labels",e),n=R(":scope > input",e),i=Nr("prev");e.append(i);let s=Nr("next");return e.append(s),H(()=>{let a=new v,c=a.pipe(ee(),oe(!0));Q([a,Ee(e)]).pipe(U(c),Me(1,de)).subscribe({next([{active:p},l]){let f=Ue(p),{width:u}=pe(p);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let h=ir(o);(f.x<h.x||f.x+u>h.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),Q([et(o),Ee(o)]).pipe(U(c)).subscribe(([p,l])=>{let f=xt(o);i.hidden=p.x<16,s.hidden=p.x>f.width-l.width-16}),T(d(i,"click").pipe(m(()=>-1)),d(s,"click").pipe(m(()=>1))).pipe(U(c)).subscribe(p=>{let{width:l}=pe(o);o.scrollBy({left:l*p,behavior:"smooth"})}),r.pipe(U(c),g(p=>n.includes(p))).subscribe(p=>p.click()),o.classList.add("tabbed-labels--linked");for(let p of n){let l=P(`label[for="${p.id}"]`);l.replaceChildren(E("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),d(l.firstElementChild,"click").pipe(U(c),g(f=>!(f.metaKey||f.ctrlKey)),y(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return G("content.tabs.link")&&a.pipe(Le(1),ae(t)).subscribe(([{active:p},{offset:l}])=>{let f=p.innerText.trim();if(p.hasAttribute("data-md-switching"))p.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let w of R("[data-tabs]"))for(let A of R(":scope > input",w)){let Z=P(`label[for="${A.id}"]`);if(Z!==p&&Z.innerText.trim()===f){Z.setAttribute("data-md-switching",""),A.click();break}}window.scrollTo({top:e.offsetTop-u});let h=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...h])])}}),a.pipe(U(c)).subscribe(()=>{for(let p of R("audio, video",e))p.pause()}),$a(n).pipe(y(p=>a.next(p)),_(()=>a.complete()),m(p=>F({ref:e},p)))}).pipe(ze(ie))}function Hn(e,{viewport$:t,target$:r,print$:o}){return T(...R(".annotate:not(.highlight)",e).map(n=>wn(n,{target$:r,print$:o})),...R("pre:not(.mermaid) > code",e).map(n=>On(n,{target$:r,print$:o})),...R("pre.mermaid",e).map(n=>_n(n)),...R("table:not([class])",e).map(n=>Cn(n)),...R("details",e).map(n=>Mn(n,{target$:r,print$:o})),...R("[data-tabs]",e).map(n=>kn(n,{viewport$:t,target$:r})),...R("[title]",e).filter(()=>G("content.tooltips")).map(n=>Ge(n)))}function Ra(e,{alert$:t}){return t.pipe(b(r=>T($(!0),$(!1).pipe(Ye(2e3))).pipe(m(o=>({message:r,active:o})))))}function $n(e,t){let r=P(".md-typeset",e);return H(()=>{let o=new v;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),Ra(e,t).pipe(y(n=>o.next(n)),_(()=>o.complete()),m(n=>F({ref:e},n)))})}function Pa({viewport$:e}){if(!G("header.autohide"))return $(!1);let t=e.pipe(m(({offset:{y:n}})=>n),Ke(2,1),m(([n,i])=>[n<i,i]),X(0)),r=Q([e,t]).pipe(g(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),Y()),o=We("search");return Q([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),Y(),b(n=>n?r:$(!1)),q(!1))}function Rn(e,t){return H(()=>Q([Ee(e),Pa(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),Y((r,o)=>r.height===o.height&&r.hidden===o.hidden),B(1))}function Pn(e,{header$:t,main$:r}){return H(()=>{let o=new v,n=o.pipe(ee(),oe(!0));o.pipe(X("active"),je(t)).subscribe(([{active:s},{hidden:a}])=>{e.classList.toggle("md-header--shadow",s&&!a),e.hidden=a});let i=fe(R("[title]",e)).pipe(g(()=>G("content.tooltips")),re(s=>Ge(s)));return r.subscribe(o),t.pipe(U(n),m(s=>F({ref:e},s)),$e(i.pipe(U(n))))})}function Ia(e,{viewport$:t,header$:r}){return pr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=pe(e);return{active:o>=n}}),X("active"))}function In(e,t){return H(()=>{let r=new v;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=me(".md-content h1");return typeof o=="undefined"?L:Ia(o,t).pipe(y(n=>r.next(n)),_(()=>r.complete()),m(n=>F({ref:e},n)))})}function Fn(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),Y()),n=o.pipe(b(()=>Ee(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),X("bottom"))));return Q([o,n,t]).pipe(m(([i,{top:s,bottom:a},{offset:{y:c},size:{height:p}}])=>(p=Math.max(0,p-Math.max(0,s-c,i)-Math.max(0,p+c-a)),{offset:s-i,height:p,active:s-i<=c})),Y((i,s)=>i.offset===s.offset&&i.height===s.height&&i.active===s.active))}function Fa(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return $(...e).pipe(re(o=>d(o,"change").pipe(m(()=>o))),q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),B(1))}function jn(e){let t=R("input",e),r=E("meta",{name:"theme-color"});document.head.appendChild(r);let o=E("meta",{name:"color-scheme"});document.head.appendChild(o);let n=At("(prefers-color-scheme: light)");return H(()=>{let i=new v;return i.subscribe(s=>{if(document.body.setAttribute("data-md-color-switching",""),s.color.media==="(prefers-color-scheme)"){let a=matchMedia("(prefers-color-scheme: light)"),c=document.querySelector(a.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");s.color.scheme=c.getAttribute("data-md-color-scheme"),s.color.primary=c.getAttribute("data-md-color-primary"),s.color.accent=c.getAttribute("data-md-color-accent")}for(let[a,c]of Object.entries(s.color))document.body.setAttribute(`data-md-color-${a}`,c);for(let a=0;a<t.length;a++){let c=t[a].nextElementSibling;c instanceof HTMLElement&&(c.hidden=s.index!==a)}__md_set("__palette",s)}),i.pipe(m(()=>{let s=Te("header"),a=window.getComputedStyle(s);return o.content=a.colorScheme,a.backgroundColor.match(/\d+/g).map(c=>(+c).toString(16).padStart(2,"0")).join("")})).subscribe(s=>r.content=`#${s}`),i.pipe(Oe(ie)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),Fa(t).pipe(U(n.pipe(Le(1))),at(),y(s=>i.next(s)),_(()=>i.complete()),m(s=>F({ref:e},s)))})}function Un(e,{progress$:t}){return H(()=>{let r=new v;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(y(o=>r.next({value:o})),_(()=>r.complete()),m(o=>({ref:e,value:o})))})}var Kr=jt(zr());function ja(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function Wn({alert$:e}){Kr.default.isSupported()&&new j(t=>{new Kr.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||ja(P(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(y(t=>{t.trigger.focus()}),m(()=>ge("clipboard.copied"))).subscribe(e)}function Dn(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function Ua(e,t){let r=new Map;for(let o of R("url",e)){let n=P("loc",o),i=[Dn(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let s of R("[rel=alternate]",o)){let a=s.getAttribute("href");a!=null&&i.push(Dn(new URL(a),t))}}return r}function mr(e){return on(new URL("sitemap.xml",e)).pipe(m(t=>Ua(t,new URL(e))),he(()=>$(new Map)))}function Wa(e,t){if(!(e.target instanceof Element))return L;let r=e.target.closest("a");if(r===null)return L;if(r.target||e.metaKey||e.ctrlKey)return L;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),$(new URL(r.href))):L}function Nn(e){let t=new Map;for(let r of R(":scope > *",e.head))t.set(r.outerHTML,r);return t}function Vn(e){for(let t of R("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return $(e)}function Da(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...G("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=me(o),i=me(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=Nn(document);for(let[o,n]of Nn(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Te("container");return Fe(R("script",r)).pipe(b(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new j(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),L}),ee(),oe(document))}function zn({location$:e,viewport$:t,progress$:r}){let o=we();if(location.protocol==="file:")return L;let n=mr(o.base);$(document).subscribe(Vn);let i=d(document.body,"click").pipe(je(n),b(([c,p])=>Wa(c,p)),le()),s=d(window,"popstate").pipe(m(ve),le());i.pipe(ae(t)).subscribe(([c,{offset:p}])=>{history.replaceState(p,""),history.pushState(null,"",c)}),T(i,s).subscribe(e);let a=e.pipe(X("pathname"),b(c=>rn(c,{progress$:r}).pipe(he(()=>(st(c,!0),L)))),b(Vn),b(Da),le());return T(a.pipe(ae(e,(c,p)=>p)),e.pipe(X("pathname"),b(()=>e),X("hash")),e.pipe(Y((c,p)=>c.pathname===p.pathname&&c.hash===p.hash),b(()=>i),y(()=>history.back()))).subscribe(c=>{var p,l;history.state!==null||!c.hash?window.scrollTo(0,(l=(p=history.state)==null?void 0:p.y)!=null?l:0):(history.scrollRestoration="auto",Zo(c.hash),history.scrollRestoration="manual")}),e.subscribe(()=>{history.scrollRestoration="manual"}),d(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),t.pipe(X("offset"),be(100)).subscribe(({offset:c})=>{history.replaceState(c,"")}),a}var Qn=jt(Kn());function Yn(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,s)=>`${i}<mark data-md-highlight>${s}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return s=>(0,Qn.default)(s).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function Ht(e){return e.type===1}function fr(e){return e.type===3}function Bn(e,t){let r=ln(e);return T($(location.protocol!=="file:"),We("search")).pipe(He(o=>o),b(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:G("search.suggest")}}})),r}function Gn({document$:e}){let t=we(),r=De(new URL("../versions.json",t.base)).pipe(he(()=>L)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:s,aliases:a})=>s===i||a.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),b(n=>d(document.body,"click").pipe(g(i=>!i.metaKey&&!i.ctrlKey),ae(o),b(([i,s])=>{if(i.target instanceof Element){let a=i.target.closest("a");if(a&&!a.target&&n.has(a.href)){let c=a.href;return!i.target.closest(".md-version")&&n.get(c)===s?L:(i.preventDefault(),$(c))}}return L}),b(i=>{let{version:s}=n.get(i);return mr(new URL(i)).pipe(m(a=>{let p=ve().href.replace(t.base,"");return a.has(p.split("#")[0])?new URL(`../${s}/${p}`,t.base):new URL(i)}))})))).subscribe(n=>st(n,!0)),Q([r,o]).subscribe(([n,i])=>{P(".md-header__topic").appendChild(gn(n,i))}),e.pipe(b(()=>o)).subscribe(n=>{var s;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let a=((s=t.version)==null?void 0:s.default)||"latest";Array.isArray(a)||(a=[a]);e:for(let c of a)for(let p of n.aliases.concat(n.version))if(new RegExp(c,"i").test(p)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let a of ne("outdated"))a.hidden=!1})}function Ka(e,{worker$:t}){let{searchParams:r}=ve();r.has("q")&&(Be("search",!0),e.value=r.get("q"),e.focus(),We("search").pipe(He(i=>!i)).subscribe(()=>{let i=ve();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=vt(e),n=T(t.pipe(He(Ht)),d(e,"keyup"),o).pipe(m(()=>e.value),Y());return Q([n,o]).pipe(m(([i,s])=>({value:i,focus:s})),B(1))}function Jn(e,{worker$:t}){let r=new v,o=r.pipe(ee(),oe(!0));Q([t.pipe(He(Ht)),r],(i,s)=>s).pipe(X("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(X("focus")).subscribe(({focus:i})=>{i&&Be("search",i)}),d(e.form,"reset").pipe(U(o)).subscribe(()=>e.focus());let n=P("header [for=__search]");return d(n,"click").subscribe(()=>e.focus()),Ka(e,{worker$:t}).pipe(y(i=>r.next(i)),_(()=>r.complete()),m(i=>F({ref:e},i)),B(1))}function Xn(e,{worker$:t,query$:r}){let o=new v,n=Yo(e.parentElement).pipe(g(Boolean)),i=e.parentElement,s=P(":scope > :first-child",e),a=P(":scope > :last-child",e);We("search").subscribe(l=>a.setAttribute("role",l?"list":"presentation")),o.pipe(ae(r),Ir(t.pipe(He(Ht)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:s.textContent=f.length?ge("search.result.none"):ge("search.result.placeholder");break;case 1:s.textContent=ge("search.result.one");break;default:let u=ar(l.length);s.textContent=ge("search.result.other",u)}});let c=o.pipe(y(()=>a.innerHTML=""),b(({items:l})=>T($(...l.slice(0,10)),$(...l.slice(10)).pipe(Ke(4),jr(n),b(([f])=>f)))),m(hn),le());return c.subscribe(l=>a.appendChild(l)),c.pipe(re(l=>{let f=me("details",l);return typeof f=="undefined"?L:d(f,"toggle").pipe(U(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(g(fr),m(({data:l})=>l)).pipe(y(l=>o.next(l)),_(()=>o.complete()),m(l=>F({ref:e},l)))}function Qa(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=ve();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function Zn(e,t){let r=new v,o=r.pipe(ee(),oe(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),d(e,"click").pipe(U(o)).subscribe(n=>n.preventDefault()),Qa(e,t).pipe(y(n=>r.next(n)),_(()=>r.complete()),m(n=>F({ref:e},n)))}function ei(e,{worker$:t,keyboard$:r}){let o=new v,n=Te("search-query"),i=T(d(n,"keydown"),d(n,"focus")).pipe(Oe(ie),m(()=>n.value),Y());return o.pipe(je(i),m(([{suggest:a},c])=>{let p=c.split(/([\s-]+)/);if(a!=null&&a.length&&p[p.length-1]){let l=a[a.length-1];l.startsWith(p[p.length-1])&&(p[p.length-1]=l)}else p.length=0;return p})).subscribe(a=>e.innerHTML=a.join("").replace(/\s/g,"&nbsp;")),r.pipe(g(({mode:a})=>a==="search")).subscribe(a=>{switch(a.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(g(fr),m(({data:a})=>a)).pipe(y(a=>o.next(a)),_(()=>o.complete()),m(()=>({ref:e})))}function ti(e,{index$:t,keyboard$:r}){let o=we();try{let n=Bn(o.search,t),i=Te("search-query",e),s=Te("search-result",e);d(e,"click").pipe(g(({target:c})=>c instanceof Element&&!!c.closest("a"))).subscribe(()=>Be("search",!1)),r.pipe(g(({mode:c})=>c==="search")).subscribe(c=>{let p=Re();switch(c.type){case"Enter":if(p===i){let l=new Map;for(let f of R(":first-child [href]",s)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,h])=>h-u);f.click()}c.claim()}break;case"Escape":case"Tab":Be("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof p=="undefined")i.focus();else{let l=[i,...R(":not(details) > [href], summary, details[open] [href]",s)],f=Math.max(0,(Math.max(0,l.indexOf(p))+l.length+(c.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}c.claim();break;default:i!==Re()&&i.focus()}}),r.pipe(g(({mode:c})=>c==="global")).subscribe(c=>{switch(c.type){case"f":case"s":case"/":i.focus(),i.select(),c.claim();break}});let a=Jn(i,{worker$:n});return T(a,Xn(s,{worker$:n,query$:a})).pipe($e(...ne("search-share",e).map(c=>Zn(c,{query$:a})),...ne("search-suggest",e).map(c=>ei(c,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,qe}}function ri(e,{index$:t,location$:r}){return Q([t,r.pipe(q(ve()),g(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>Yn(o.config)(n.searchParams.get("h"))),m(o=>{var s;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let a=i.nextNode();a;a=i.nextNode())if((s=a.parentElement)!=null&&s.offsetHeight){let c=a.textContent,p=o(c);p.length>c.length&&n.set(a,p)}for(let[a,c]of n){let{childNodes:p}=E("span",null,c);a.replaceWith(...Array.from(p))}return{ref:e,nodes:n}}))}function Ya(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return Q([r,t]).pipe(m(([{offset:i,height:s},{offset:{y:a}}])=>(s=s+Math.min(n,Math.max(0,a-i))-n,{height:s,locked:a>=i+n})),Y((i,s)=>i.height===s.height&&i.locked===s.locked))}function Qr(e,o){var n=o,{header$:t}=n,r=to(n,["header$"]);let i=P(".md-sidebar__scrollwrap",e),{y:s}=Ue(i);return H(()=>{let a=new v,c=a.pipe(ee(),oe(!0)),p=a.pipe(Me(0,de));return p.pipe(ae(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*s}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),p.pipe(He()).subscribe(()=>{for(let l of R(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=pe(f);f.scrollTo({top:u-h/2})}}}),fe(R("label[tabindex]",e)).pipe(re(l=>d(l,"click").pipe(Oe(ie),m(()=>l),U(c)))).subscribe(l=>{let f=P(`[id="${l.htmlFor}"]`);P(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),Ya(e,r).pipe(y(l=>a.next(l)),_(()=>a.complete()),m(l=>F({ref:e},l)))})}function oi(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return Lt(De(`${r}/releases/latest`).pipe(he(()=>L),m(o=>({version:o.tag_name})),Qe({})),De(r).pipe(he(()=>L),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),Qe({}))).pipe(m(([o,n])=>F(F({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return De(r).pipe(m(o=>({repositories:o.public_repos})),Qe({}))}}function ni(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return De(r).pipe(he(()=>L),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),Qe({}))}function ii(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return oi(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return ni(r,o)}return L}var Ba;function Ga(e){return Ba||(Ba=H(()=>{let t=__md_get("__source",sessionStorage);if(t)return $(t);if(ne("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return L}return ii(e.href).pipe(y(o=>__md_set("__source",o,sessionStorage)))}).pipe(he(()=>L),g(t=>Object.keys(t).length>0),m(t=>({facts:t})),B(1)))}function ai(e){let t=P(":scope > :last-child",e);return H(()=>{let r=new v;return r.subscribe(({facts:o})=>{t.appendChild(bn(o)),t.classList.add("md-source__repository--active")}),Ga(e).pipe(y(o=>r.next(o)),_(()=>r.complete()),m(o=>F({ref:e},o)))})}function Ja(e,{viewport$:t,header$:r}){return Ee(document.body).pipe(b(()=>pr(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),X("hidden"))}function si(e,t){return H(()=>{let r=new v;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(G("navigation.tabs.sticky")?$({hidden:!1}):Ja(e,t)).pipe(y(o=>r.next(o)),_(()=>r.complete()),m(o=>F({ref:e},o)))})}function Xa(e,{viewport$:t,header$:r}){let o=new Map,n=R(".md-nav__link",e);for(let a of n){let c=decodeURIComponent(a.hash.substring(1)),p=me(`[id="${c}"]`);typeof p!="undefined"&&o.set(a,p)}let i=r.pipe(X("height"),m(({height:a})=>{let c=Te("main"),p=P(":scope > :first-child",c);return a+.8*(p.offsetTop-c.offsetTop)}),le());return Ee(document.body).pipe(X("height"),b(a=>H(()=>{let c=[];return $([...o].reduce((p,[l,f])=>{for(;c.length&&o.get(c[c.length-1]).tagName>=f.tagName;)c.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let h=f.offsetParent;for(;h;h=h.offsetParent)u+=h.offsetTop;return p.set([...c=[...c,l]].reverse(),u)},new Map))}).pipe(m(c=>new Map([...c].sort(([,p],[,l])=>p-l))),je(i),b(([c,p])=>t.pipe(Rr(([l,f],{offset:{y:u},size:h})=>{let w=u+h.height>=Math.floor(a.height);for(;f.length;){let[,A]=f[0];if(A-p<u||w)l=[...l,f.shift()];else break}for(;l.length;){let[,A]=l[l.length-1];if(A-p>=u&&!w)f=[l.pop(),...f];else break}return[l,f]},[[],[...c]]),Y((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([a,c])=>({prev:a.map(([p])=>p),next:c.map(([p])=>p)})),q({prev:[],next:[]}),Ke(2,1),m(([a,c])=>a.prev.length<c.prev.length?{prev:c.prev.slice(Math.max(0,a.prev.length-1),c.prev.length),next:[]}:{prev:c.prev.slice(-1),next:c.next.slice(0,c.next.length-a.next.length)}))}function ci(e,{viewport$:t,header$:r,main$:o,target$:n}){return H(()=>{let i=new v,s=i.pipe(ee(),oe(!0));if(i.subscribe(({prev:a,next:c})=>{for(let[p]of c)p.classList.remove("md-nav__link--passed"),p.classList.remove("md-nav__link--active");for(let[p,[l]]of a.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",p===a.length-1)}),G("toc.follow")){let a=T(t.pipe(be(1),m(()=>{})),t.pipe(be(250),m(()=>"smooth")));i.pipe(g(({prev:c})=>c.length>0),je(o.pipe(Oe(ie))),ae(a)).subscribe(([[{prev:c}],p])=>{let[l]=c[c.length-1];if(l.offsetHeight){let f=sr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=pe(f);f.scrollTo({top:u-h/2,behavior:p})}}})}return G("navigation.tracking")&&t.pipe(U(s),X("offset"),be(250),Le(1),U(n.pipe(Le(1))),at({delay:250}),ae(i)).subscribe(([,{prev:a}])=>{let c=ve(),p=a[a.length-1];if(p&&p.length){let[l]=p,{hash:f}=new URL(l.href);c.hash!==f&&(c.hash=f,history.replaceState({},"",`${c}`))}else c.hash="",history.replaceState({},"",`${c}`)}),Xa(e,{viewport$:t,header$:r}).pipe(y(a=>i.next(a)),_(()=>i.complete()),m(a=>F({ref:e},a)))})}function Za(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:s}})=>s),Ke(2,1),m(([s,a])=>s>a&&a>0),Y()),i=r.pipe(m(({active:s})=>s));return Q([i,n]).pipe(m(([s,a])=>!(s&&a)),Y(),U(o.pipe(Le(1))),oe(!0),at({delay:250}),m(s=>({hidden:s})))}function pi(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new v,s=i.pipe(ee(),oe(!0));return i.subscribe({next({hidden:a}){e.hidden=a,a?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(U(s),X("height")).subscribe(({height:a})=>{e.style.top=`${a+16}px`}),d(e,"click").subscribe(a=>{a.preventDefault(),window.scrollTo({top:0})}),Za(e,{viewport$:t,main$:o,target$:n}).pipe(y(a=>i.next(a)),_(()=>i.complete()),m(a=>F({ref:e},a)))}function li({document$:e}){e.pipe(b(()=>R(".md-ellipsis")),re(t=>yt(t).pipe(U(e.pipe(Le(1))),g(r=>r),m(()=>t),ye(1))),g(t=>t.offsetWidth<t.scrollWidth),re(t=>{let r=t.innerText,o=t.closest("a")||t;return o.title=r,Ge(o).pipe(U(e.pipe(Le(1))),_(()=>o.removeAttribute("title")))})).subscribe(),e.pipe(b(()=>R(".md-status")),re(t=>Ge(t))).subscribe()}function mi({document$:e,tablet$:t}){e.pipe(b(()=>R(".md-toggle--indeterminate")),y(r=>{r.indeterminate=!0,r.checked=!1}),re(r=>d(r,"change").pipe(Fr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),ae(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function es(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function fi({document$:e}){e.pipe(b(()=>R("[data-md-scrollfix]")),y(t=>t.removeAttribute("data-md-scrollfix")),g(es),re(t=>d(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function ui({viewport$:e,tablet$:t}){Q([We("search"),t]).pipe(m(([r,o])=>r&&!o),b(r=>$(r).pipe(Ye(r?400:100))),ae(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function ts(){return location.protocol==="file:"?gt(`${new URL("search/search_index.js",Yr.base)}`).pipe(m(()=>__index),B(1)):De(new URL("search/search_index.json",Yr.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var rt=No(),Rt=Jo(),wt=en(Rt),Br=Go(),_e=pn(),ur=At("(min-width: 960px)"),hi=At("(min-width: 1220px)"),bi=tn(),Yr=we(),vi=document.forms.namedItem("search")?ts():qe,Gr=new v;Wn({alert$:Gr});var Jr=new v;G("navigation.instant")&&zn({location$:Rt,viewport$:_e,progress$:Jr}).subscribe(rt);var di;((di=Yr.version)==null?void 0:di.provider)==="mike"&&Gn({document$:rt});T(Rt,wt).pipe(Ye(125)).subscribe(()=>{Be("drawer",!1),Be("search",!1)});Br.pipe(g(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=me("link[rel=prev]");typeof t!="undefined"&&st(t);break;case"n":case".":let r=me("link[rel=next]");typeof r!="undefined"&&st(r);break;case"Enter":let o=Re();o instanceof HTMLLabelElement&&o.click()}});li({document$:rt});mi({document$:rt,tablet$:ur});fi({document$:rt});ui({viewport$:_e,tablet$:ur});var tt=Rn(Te("header"),{viewport$:_e}),$t=rt.pipe(m(()=>Te("main")),b(e=>Fn(e,{viewport$:_e,header$:tt})),B(1)),rs=T(...ne("consent").map(e=>fn(e,{target$:wt})),...ne("dialog").map(e=>$n(e,{alert$:Gr})),...ne("header").map(e=>Pn(e,{viewport$:_e,header$:tt,main$:$t})),...ne("palette").map(e=>jn(e)),...ne("progress").map(e=>Un(e,{progress$:Jr})),...ne("search").map(e=>ti(e,{index$:vi,keyboard$:Br})),...ne("source").map(e=>ai(e))),os=H(()=>T(...ne("announce").map(e=>mn(e)),...ne("content").map(e=>Hn(e,{viewport$:_e,target$:wt,print$:bi})),...ne("content").map(e=>G("search.highlight")?ri(e,{index$:vi,location$:Rt}):L),...ne("header-title").map(e=>In(e,{viewport$:_e,header$:tt})),...ne("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Ur(hi,()=>Qr(e,{viewport$:_e,header$:tt,main$:$t})):Ur(ur,()=>Qr(e,{viewport$:_e,header$:tt,main$:$t}))),...ne("tabs").map(e=>si(e,{viewport$:_e,header$:tt})),...ne("toc").map(e=>ci(e,{viewport$:_e,header$:tt,main$:$t,target$:wt})),...ne("top").map(e=>pi(e,{viewport$:_e,header$:tt,main$:$t,target$:wt})))),gi=rt.pipe(b(()=>os),$e(rs),B(1));gi.subscribe();window.document$=rt;window.location$=Rt;window.target$=wt;window.keyboard$=Br;window.viewport$=_e;window.tablet$=ur;window.screen$=hi;window.print$=bi;window.alert$=Gr;window.progress$=Jr;window.component$=gi;})();
-//# sourceMappingURL=bundle.bd41221c.min.js.map
-
diff --git a/0.10.0/assets/javascripts/bundle.bd41221c.min.js.map b/0.10.0/assets/javascripts/bundle.bd41221c.min.js.map
deleted file mode 100644
index 1663daba2..000000000
--- a/0.10.0/assets/javascripts/bundle.bd41221c.min.js.map
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["node_modules/focus-visible/dist/focus-visible.js", "node_modules/clipboard/dist/clipboard.js", "node_modules/escape-html/index.js", "src/templates/assets/javascripts/bundle.ts", "node_modules/rxjs/node_modules/tslib/tslib.es6.js", "node_modules/rxjs/src/internal/util/isFunction.ts", "node_modules/rxjs/src/internal/util/createErrorClass.ts", "node_modules/rxjs/src/internal/util/UnsubscriptionError.ts", "node_modules/rxjs/src/internal/util/arrRemove.ts", "node_modules/rxjs/src/internal/Subscription.ts", "node_modules/rxjs/src/internal/config.ts", "node_modules/rxjs/src/internal/scheduler/timeoutProvider.ts", "node_modules/rxjs/src/internal/util/reportUnhandledError.ts", "node_modules/rxjs/src/internal/util/noop.ts", "node_modules/rxjs/src/internal/NotificationFactories.ts", "node_modules/rxjs/src/internal/util/errorContext.ts", "node_modules/rxjs/src/internal/Subscriber.ts", "node_modules/rxjs/src/internal/symbol/observable.ts", "node_modules/rxjs/src/internal/util/identity.ts", "node_modules/rxjs/src/internal/util/pipe.ts", "node_modules/rxjs/src/internal/Observable.ts", "node_modules/rxjs/src/internal/util/lift.ts", "node_modules/rxjs/src/internal/operators/OperatorSubscriber.ts", "node_modules/rxjs/src/internal/scheduler/animationFrameProvider.ts", "node_modules/rxjs/src/internal/util/ObjectUnsubscribedError.ts", "node_modules/rxjs/src/internal/Subject.ts", "node_modules/rxjs/src/internal/scheduler/dateTimestampProvider.ts", "node_modules/rxjs/src/internal/ReplaySubject.ts", "node_modules/rxjs/src/internal/scheduler/Action.ts", "node_modules/rxjs/src/internal/scheduler/intervalProvider.ts", "node_modules/rxjs/src/internal/scheduler/AsyncAction.ts", "node_modules/rxjs/src/internal/Scheduler.ts", "node_modules/rxjs/src/internal/scheduler/AsyncScheduler.ts", "node_modules/rxjs/src/internal/scheduler/async.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameAction.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameScheduler.ts", "node_modules/rxjs/src/internal/scheduler/animationFrame.ts", "node_modules/rxjs/src/internal/observable/empty.ts", "node_modules/rxjs/src/internal/util/isScheduler.ts", "node_modules/rxjs/src/internal/util/args.ts", "node_modules/rxjs/src/internal/util/isArrayLike.ts", "node_modules/rxjs/src/internal/util/isPromise.ts", "node_modules/rxjs/src/internal/util/isInteropObservable.ts", "node_modules/rxjs/src/internal/util/isAsyncIterable.ts", "node_modules/rxjs/src/internal/util/throwUnobservableError.ts", "node_modules/rxjs/src/internal/symbol/iterator.ts", "node_modules/rxjs/src/internal/util/isIterable.ts", "node_modules/rxjs/src/internal/util/isReadableStreamLike.ts", "node_modules/rxjs/src/internal/observable/innerFrom.ts", "node_modules/rxjs/src/internal/util/executeSchedule.ts", "node_modules/rxjs/src/internal/operators/observeOn.ts", "node_modules/rxjs/src/internal/operators/subscribeOn.ts", "node_modules/rxjs/src/internal/scheduled/scheduleObservable.ts", "node_modules/rxjs/src/internal/scheduled/schedulePromise.ts", "node_modules/rxjs/src/internal/scheduled/scheduleArray.ts", "node_modules/rxjs/src/internal/scheduled/scheduleIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleAsyncIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleReadableStreamLike.ts", "node_modules/rxjs/src/internal/scheduled/scheduled.ts", "node_modules/rxjs/src/internal/observable/from.ts", "node_modules/rxjs/src/internal/observable/of.ts", "node_modules/rxjs/src/internal/observable/throwError.ts", "node_modules/rxjs/src/internal/util/EmptyError.ts", "node_modules/rxjs/src/internal/util/isDate.ts", "node_modules/rxjs/src/internal/operators/map.ts", "node_modules/rxjs/src/internal/util/mapOneOrManyArgs.ts", "node_modules/rxjs/src/internal/util/argsArgArrayOrObject.ts", "node_modules/rxjs/src/internal/util/createObject.ts", "node_modules/rxjs/src/internal/observable/combineLatest.ts", "node_modules/rxjs/src/internal/operators/mergeInternals.ts", "node_modules/rxjs/src/internal/operators/mergeMap.ts", "node_modules/rxjs/src/internal/operators/mergeAll.ts", "node_modules/rxjs/src/internal/operators/concatAll.ts", "node_modules/rxjs/src/internal/observable/concat.ts", "node_modules/rxjs/src/internal/observable/defer.ts", "node_modules/rxjs/src/internal/observable/fromEvent.ts", "node_modules/rxjs/src/internal/observable/fromEventPattern.ts", "node_modules/rxjs/src/internal/observable/timer.ts", "node_modules/rxjs/src/internal/observable/merge.ts", "node_modules/rxjs/src/internal/observable/never.ts", "node_modules/rxjs/src/internal/util/argsOrArgArray.ts", "node_modules/rxjs/src/internal/operators/filter.ts", "node_modules/rxjs/src/internal/observable/zip.ts", "node_modules/rxjs/src/internal/operators/audit.ts", "node_modules/rxjs/src/internal/operators/auditTime.ts", "node_modules/rxjs/src/internal/operators/bufferCount.ts", "node_modules/rxjs/src/internal/operators/catchError.ts", "node_modules/rxjs/src/internal/operators/scanInternals.ts", "node_modules/rxjs/src/internal/operators/combineLatest.ts", "node_modules/rxjs/src/internal/operators/combineLatestWith.ts", "node_modules/rxjs/src/internal/operators/debounceTime.ts", "node_modules/rxjs/src/internal/operators/defaultIfEmpty.ts", "node_modules/rxjs/src/internal/operators/take.ts", "node_modules/rxjs/src/internal/operators/ignoreElements.ts", "node_modules/rxjs/src/internal/operators/mapTo.ts", "node_modules/rxjs/src/internal/operators/delayWhen.ts", "node_modules/rxjs/src/internal/operators/delay.ts", "node_modules/rxjs/src/internal/operators/distinctUntilChanged.ts", "node_modules/rxjs/src/internal/operators/distinctUntilKeyChanged.ts", "node_modules/rxjs/src/internal/operators/throwIfEmpty.ts", "node_modules/rxjs/src/internal/operators/endWith.ts", "node_modules/rxjs/src/internal/operators/finalize.ts", "node_modules/rxjs/src/internal/operators/first.ts", "node_modules/rxjs/src/internal/operators/takeLast.ts", "node_modules/rxjs/src/internal/operators/merge.ts", "node_modules/rxjs/src/internal/operators/mergeWith.ts", "node_modules/rxjs/src/internal/operators/repeat.ts", "node_modules/rxjs/src/internal/operators/scan.ts", "node_modules/rxjs/src/internal/operators/share.ts", "node_modules/rxjs/src/internal/operators/shareReplay.ts", "node_modules/rxjs/src/internal/operators/skip.ts", "node_modules/rxjs/src/internal/operators/skipUntil.ts", "node_modules/rxjs/src/internal/operators/startWith.ts", "node_modules/rxjs/src/internal/operators/switchMap.ts", "node_modules/rxjs/src/internal/operators/takeUntil.ts", "node_modules/rxjs/src/internal/operators/takeWhile.ts", "node_modules/rxjs/src/internal/operators/tap.ts", "node_modules/rxjs/src/internal/operators/throttle.ts", "node_modules/rxjs/src/internal/operators/throttleTime.ts", "node_modules/rxjs/src/internal/operators/withLatestFrom.ts", "node_modules/rxjs/src/internal/operators/zip.ts", "node_modules/rxjs/src/internal/operators/zipWith.ts", "src/templates/assets/javascripts/browser/document/index.ts", "src/templates/assets/javascripts/browser/element/_/index.ts", "src/templates/assets/javascripts/browser/element/focus/index.ts", "src/templates/assets/javascripts/browser/element/hover/index.ts", "src/templates/assets/javascripts/browser/element/offset/_/index.ts", "src/templates/assets/javascripts/browser/element/offset/content/index.ts", "src/templates/assets/javascripts/utilities/h/index.ts", "src/templates/assets/javascripts/utilities/round/index.ts", "src/templates/assets/javascripts/browser/script/index.ts", "src/templates/assets/javascripts/browser/element/size/_/index.ts", "src/templates/assets/javascripts/browser/element/size/content/index.ts", "src/templates/assets/javascripts/browser/element/visibility/index.ts", "src/templates/assets/javascripts/browser/toggle/index.ts", "src/templates/assets/javascripts/browser/keyboard/index.ts", "src/templates/assets/javascripts/browser/location/_/index.ts", "src/templates/assets/javascripts/browser/location/hash/index.ts", "src/templates/assets/javascripts/browser/media/index.ts", "src/templates/assets/javascripts/browser/request/index.ts", "src/templates/assets/javascripts/browser/viewport/offset/index.ts", "src/templates/assets/javascripts/browser/viewport/size/index.ts", "src/templates/assets/javascripts/browser/viewport/_/index.ts", "src/templates/assets/javascripts/browser/viewport/at/index.ts", "src/templates/assets/javascripts/browser/worker/index.ts", "src/templates/assets/javascripts/_/index.ts", "src/templates/assets/javascripts/components/_/index.ts", "src/templates/assets/javascripts/components/announce/index.ts", "src/templates/assets/javascripts/components/consent/index.ts", "src/templates/assets/javascripts/templates/tooltip/index.tsx", "src/templates/assets/javascripts/templates/annotation/index.tsx", "src/templates/assets/javascripts/templates/clipboard/index.tsx", "src/templates/assets/javascripts/templates/search/index.tsx", "src/templates/assets/javascripts/templates/source/index.tsx", "src/templates/assets/javascripts/templates/tabbed/index.tsx", "src/templates/assets/javascripts/templates/table/index.tsx", "src/templates/assets/javascripts/templates/version/index.tsx", "src/templates/assets/javascripts/components/tooltip/index.ts", "src/templates/assets/javascripts/components/content/annotation/_/index.ts", "src/templates/assets/javascripts/components/content/annotation/list/index.ts", "src/templates/assets/javascripts/components/content/annotation/block/index.ts", "src/templates/assets/javascripts/components/content/code/_/index.ts", "src/templates/assets/javascripts/components/content/details/index.ts", "src/templates/assets/javascripts/components/content/mermaid/index.css", "src/templates/assets/javascripts/components/content/mermaid/index.ts", "src/templates/assets/javascripts/components/content/table/index.ts", "src/templates/assets/javascripts/components/content/tabs/index.ts", "src/templates/assets/javascripts/components/content/_/index.ts", "src/templates/assets/javascripts/components/dialog/index.ts", "src/templates/assets/javascripts/components/header/_/index.ts", "src/templates/assets/javascripts/components/header/title/index.ts", "src/templates/assets/javascripts/components/main/index.ts", "src/templates/assets/javascripts/components/palette/index.ts", "src/templates/assets/javascripts/components/progress/index.ts", "src/templates/assets/javascripts/integrations/clipboard/index.ts", "src/templates/assets/javascripts/integrations/sitemap/index.ts", "src/templates/assets/javascripts/integrations/instant/index.ts", "src/templates/assets/javascripts/integrations/search/highlighter/index.ts", "src/templates/assets/javascripts/integrations/search/worker/message/index.ts", "src/templates/assets/javascripts/integrations/search/worker/_/index.ts", "src/templates/assets/javascripts/integrations/version/index.ts", "src/templates/assets/javascripts/components/search/query/index.ts", "src/templates/assets/javascripts/components/search/result/index.ts", "src/templates/assets/javascripts/components/search/share/index.ts", "src/templates/assets/javascripts/components/search/suggest/index.ts", "src/templates/assets/javascripts/components/search/_/index.ts", "src/templates/assets/javascripts/components/search/highlight/index.ts", "src/templates/assets/javascripts/components/sidebar/index.ts", "src/templates/assets/javascripts/components/source/facts/github/index.ts", "src/templates/assets/javascripts/components/source/facts/gitlab/index.ts", "src/templates/assets/javascripts/components/source/facts/_/index.ts", "src/templates/assets/javascripts/components/source/_/index.ts", "src/templates/assets/javascripts/components/tabs/index.ts", "src/templates/assets/javascripts/components/toc/index.ts", "src/templates/assets/javascripts/components/top/index.ts", "src/templates/assets/javascripts/patches/ellipsis/index.ts", "src/templates/assets/javascripts/patches/indeterminate/index.ts", "src/templates/assets/javascripts/patches/scrollfix/index.ts", "src/templates/assets/javascripts/patches/scrolllock/index.ts", "src/templates/assets/javascripts/polyfills/index.ts"],
-  "sourcesContent": ["(function (global, factory) {\n  typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n  typeof define === 'function' && define.amd ? define(factory) :\n  (factory());\n}(this, (function () { 'use strict';\n\n  /**\n   * Applies the :focus-visible polyfill at the given scope.\n   * A scope in this case is either the top-level Document or a Shadow Root.\n   *\n   * @param {(Document|ShadowRoot)} scope\n   * @see https://github.com/WICG/focus-visible\n   */\n  function applyFocusVisiblePolyfill(scope) {\n    var hadKeyboardEvent = true;\n    var hadFocusVisibleRecently = false;\n    var hadFocusVisibleRecentlyTimeout = null;\n\n    var inputTypesAllowlist = {\n      text: true,\n      search: true,\n      url: true,\n      tel: true,\n      email: true,\n      password: true,\n      number: true,\n      date: true,\n      month: true,\n      week: true,\n      time: true,\n      datetime: true,\n      'datetime-local': true\n    };\n\n    /**\n     * Helper function for legacy browsers and iframes which sometimes focus\n     * elements like document, body, and non-interactive SVG.\n     * @param {Element} el\n     */\n    function isValidFocusTarget(el) {\n      if (\n        el &&\n        el !== document &&\n        el.nodeName !== 'HTML' &&\n        el.nodeName !== 'BODY' &&\n        'classList' in el &&\n        'contains' in el.classList\n      ) {\n        return true;\n      }\n      return false;\n    }\n\n    /**\n     * Computes whether the given element should automatically trigger the\n     * `focus-visible` class being added, i.e. whether it should always match\n     * `:focus-visible` when focused.\n     * @param {Element} el\n     * @return {boolean}\n     */\n    function focusTriggersKeyboardModality(el) {\n      var type = el.type;\n      var tagName = el.tagName;\n\n      if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n        return true;\n      }\n\n      if (tagName === 'TEXTAREA' && !el.readOnly) {\n        return true;\n      }\n\n      if (el.isContentEditable) {\n        return true;\n      }\n\n      return false;\n    }\n\n    /**\n     * Add the `focus-visible` class to the given element if it was not added by\n     * the author.\n     * @param {Element} el\n     */\n    function addFocusVisibleClass(el) {\n      if (el.classList.contains('focus-visible')) {\n        return;\n      }\n      el.classList.add('focus-visible');\n      el.setAttribute('data-focus-visible-added', '');\n    }\n\n    /**\n     * Remove the `focus-visible` class from the given element if it was not\n     * originally added by the author.\n     * @param {Element} el\n     */\n    function removeFocusVisibleClass(el) {\n      if (!el.hasAttribute('data-focus-visible-added')) {\n        return;\n      }\n      el.classList.remove('focus-visible');\n      el.removeAttribute('data-focus-visible-added');\n    }\n\n    /**\n     * If the most recent user interaction was via the keyboard;\n     * and the key press did not include a meta, alt/option, or control key;\n     * then the modality is keyboard. Otherwise, the modality is not keyboard.\n     * Apply `focus-visible` to any current active element and keep track\n     * of our keyboard modality state with `hadKeyboardEvent`.\n     * @param {KeyboardEvent} e\n     */\n    function onKeyDown(e) {\n      if (e.metaKey || e.altKey || e.ctrlKey) {\n        return;\n      }\n\n      if (isValidFocusTarget(scope.activeElement)) {\n        addFocusVisibleClass(scope.activeElement);\n      }\n\n      hadKeyboardEvent = true;\n    }\n\n    /**\n     * If at any point a user clicks with a pointing device, ensure that we change\n     * the modality away from keyboard.\n     * This avoids the situation where a user presses a key on an already focused\n     * element, and then clicks on a different element, focusing it with a\n     * pointing device, while we still think we're in keyboard modality.\n     * @param {Event} e\n     */\n    function onPointerDown(e) {\n      hadKeyboardEvent = false;\n    }\n\n    /**\n     * On `focus`, add the `focus-visible` class to the target if:\n     * - the target received focus as a result of keyboard navigation, or\n     * - the event target is an element that will likely require interaction\n     *   via the keyboard (e.g. a text box)\n     * @param {Event} e\n     */\n    function onFocus(e) {\n      // Prevent IE from focusing the document or HTML element.\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n        addFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * On `blur`, remove the `focus-visible` class from the target.\n     * @param {Event} e\n     */\n    function onBlur(e) {\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (\n        e.target.classList.contains('focus-visible') ||\n        e.target.hasAttribute('data-focus-visible-added')\n      ) {\n        // To detect a tab/window switch, we look for a blur event followed\n        // rapidly by a visibility change.\n        // If we don't see a visibility change within 100ms, it's probably a\n        // regular focus change.\n        hadFocusVisibleRecently = true;\n        window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n        hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n          hadFocusVisibleRecently = false;\n        }, 100);\n        removeFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * If the user changes tabs, keep track of whether or not the previously\n     * focused element had .focus-visible.\n     * @param {Event} e\n     */\n    function onVisibilityChange(e) {\n      if (document.visibilityState === 'hidden') {\n        // If the tab becomes active again, the browser will handle calling focus\n        // on the element (Safari actually calls it twice).\n        // If this tab change caused a blur on an element with focus-visible,\n        // re-apply the class when the user switches back to the tab.\n        if (hadFocusVisibleRecently) {\n          hadKeyboardEvent = true;\n        }\n        addInitialPointerMoveListeners();\n      }\n    }\n\n    /**\n     * Add a group of listeners to detect usage of any pointing devices.\n     * These listeners will be added when the polyfill first loads, and anytime\n     * the window is blurred, so that they are active when the window regains\n     * focus.\n     */\n    function addInitialPointerMoveListeners() {\n      document.addEventListener('mousemove', onInitialPointerMove);\n      document.addEventListener('mousedown', onInitialPointerMove);\n      document.addEventListener('mouseup', onInitialPointerMove);\n      document.addEventListener('pointermove', onInitialPointerMove);\n      document.addEventListener('pointerdown', onInitialPointerMove);\n      document.addEventListener('pointerup', onInitialPointerMove);\n      document.addEventListener('touchmove', onInitialPointerMove);\n      document.addEventListener('touchstart', onInitialPointerMove);\n      document.addEventListener('touchend', onInitialPointerMove);\n    }\n\n    function removeInitialPointerMoveListeners() {\n      document.removeEventListener('mousemove', onInitialPointerMove);\n      document.removeEventListener('mousedown', onInitialPointerMove);\n      document.removeEventListener('mouseup', onInitialPointerMove);\n      document.removeEventListener('pointermove', onInitialPointerMove);\n      document.removeEventListener('pointerdown', onInitialPointerMove);\n      document.removeEventListener('pointerup', onInitialPointerMove);\n      document.removeEventListener('touchmove', onInitialPointerMove);\n      document.removeEventListener('touchstart', onInitialPointerMove);\n      document.removeEventListener('touchend', onInitialPointerMove);\n    }\n\n    /**\n     * When the polfyill first loads, assume the user is in keyboard modality.\n     * If any event is received from a pointing device (e.g. mouse, pointer,\n     * touch), turn off keyboard modality.\n     * This accounts for situations where focus enters the page from the URL bar.\n     * @param {Event} e\n     */\n    function onInitialPointerMove(e) {\n      // Work around a Safari quirk that fires a mousemove on <html> whenever the\n      // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n      if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n        return;\n      }\n\n      hadKeyboardEvent = false;\n      removeInitialPointerMoveListeners();\n    }\n\n    // For some kinds of state, we are interested in changes at the global scope\n    // only. For example, global pointer input, global key presses and global\n    // visibility change should affect the state at every scope:\n    document.addEventListener('keydown', onKeyDown, true);\n    document.addEventListener('mousedown', onPointerDown, true);\n    document.addEventListener('pointerdown', onPointerDown, true);\n    document.addEventListener('touchstart', onPointerDown, true);\n    document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n    addInitialPointerMoveListeners();\n\n    // For focus and blur, we specifically care about state changes in the local\n    // scope. This is because focus / blur events that originate from within a\n    // shadow root are not re-dispatched from the host element if it was already\n    // the active element in its own scope:\n    scope.addEventListener('focus', onFocus, true);\n    scope.addEventListener('blur', onBlur, true);\n\n    // We detect that a node is a ShadowRoot by ensuring that it is a\n    // DocumentFragment and also has a host property. This check covers native\n    // implementation and polyfill implementation transparently. If we only cared\n    // about the native implementation, we could just check if the scope was\n    // an instance of a ShadowRoot.\n    if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n      // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n      // have a root element to add a class to. So, we add this attribute to the\n      // host element instead:\n      scope.host.setAttribute('data-js-focus-visible', '');\n    } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n      document.documentElement.classList.add('js-focus-visible');\n      document.documentElement.setAttribute('data-js-focus-visible', '');\n    }\n  }\n\n  // It is important to wrap all references to global window and document in\n  // these checks to support server-side rendering use cases\n  // @see https://github.com/WICG/focus-visible/issues/199\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    // Make the polyfill helper globally available. This can be used as a signal\n    // to interested libraries that wish to coordinate with the polyfill for e.g.,\n    // applying the polyfill to a shadow root:\n    window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n    // Notify interested libraries of the polyfill's presence, in case the\n    // polyfill was loaded lazily:\n    var event;\n\n    try {\n      event = new CustomEvent('focus-visible-polyfill-ready');\n    } catch (error) {\n      // IE11 does not support using CustomEvent as a constructor directly:\n      event = document.createEvent('CustomEvent');\n      event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n    }\n\n    window.dispatchEvent(event);\n  }\n\n  if (typeof document !== 'undefined') {\n    // Apply the polyfill to the global document, so that no JavaScript\n    // coordination is required to use the polyfill in the top-level document:\n    applyFocusVisiblePolyfill(document);\n  }\n\n})));\n", "/*!\n * clipboard.js v2.0.11\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 686:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n  \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/common/command.js\n/**\n * Executes a given operation type.\n * @param {String} type\n * @return {Boolean}\n */\nfunction command(type) {\n  try {\n    return document.execCommand(type);\n  } catch (err) {\n    return false;\n  }\n}\n;// CONCATENATED MODULE: ./src/actions/cut.js\n\n\n/**\n * Cut action wrapper.\n * @param {String|HTMLElement} target\n * @return {String}\n */\n\nvar ClipboardActionCut = function ClipboardActionCut(target) {\n  var selectedText = select_default()(target);\n  command('cut');\n  return selectedText;\n};\n\n/* harmony default export */ var actions_cut = (ClipboardActionCut);\n;// CONCATENATED MODULE: ./src/common/create-fake-element.js\n/**\n * Creates a fake textarea element with a value.\n * @param {String} value\n * @return {HTMLElement}\n */\nfunction createFakeElement(value) {\n  var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n  var fakeElement = document.createElement('textarea'); // Prevent zooming on iOS\n\n  fakeElement.style.fontSize = '12pt'; // Reset box model\n\n  fakeElement.style.border = '0';\n  fakeElement.style.padding = '0';\n  fakeElement.style.margin = '0'; // Move element out of screen horizontally\n\n  fakeElement.style.position = 'absolute';\n  fakeElement.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n  var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n  fakeElement.style.top = \"\".concat(yPosition, \"px\");\n  fakeElement.setAttribute('readonly', '');\n  fakeElement.value = value;\n  return fakeElement;\n}\n;// CONCATENATED MODULE: ./src/actions/copy.js\n\n\n\n/**\n * Create fake copy action wrapper using a fake element.\n * @param {String} target\n * @param {Object} options\n * @return {String}\n */\n\nvar fakeCopyAction = function fakeCopyAction(value, options) {\n  var fakeElement = createFakeElement(value);\n  options.container.appendChild(fakeElement);\n  var selectedText = select_default()(fakeElement);\n  command('copy');\n  fakeElement.remove();\n  return selectedText;\n};\n/**\n * Copy action wrapper.\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @return {String}\n */\n\n\nvar ClipboardActionCopy = function ClipboardActionCopy(target) {\n  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n    container: document.body\n  };\n  var selectedText = '';\n\n  if (typeof target === 'string') {\n    selectedText = fakeCopyAction(target, options);\n  } else if (target instanceof HTMLInputElement && !['text', 'search', 'url', 'tel', 'password'].includes(target === null || target === void 0 ? void 0 : target.type)) {\n    // If input type doesn't support `setSelectionRange`. Simulate it. https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setSelectionRange\n    selectedText = fakeCopyAction(target.value, options);\n  } else {\n    selectedText = select_default()(target);\n    command('copy');\n  }\n\n  return selectedText;\n};\n\n/* harmony default export */ var actions_copy = (ClipboardActionCopy);\n;// CONCATENATED MODULE: ./src/actions/default.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\n\n\n/**\n * Inner function which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n * @param {Object} options\n */\n\nvar ClipboardActionDefault = function ClipboardActionDefault() {\n  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  // Defines base properties passed from constructor.\n  var _options$action = options.action,\n      action = _options$action === void 0 ? 'copy' : _options$action,\n      container = options.container,\n      target = options.target,\n      text = options.text; // Sets the `action` to be performed which can be either 'copy' or 'cut'.\n\n  if (action !== 'copy' && action !== 'cut') {\n    throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n  } // Sets the `target` property using an element that will be have its content copied.\n\n\n  if (target !== undefined) {\n    if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n      if (action === 'copy' && target.hasAttribute('disabled')) {\n        throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n      }\n\n      if (action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n        throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n      }\n    } else {\n      throw new Error('Invalid \"target\" value, use a valid Element');\n    }\n  } // Define selection strategy based on `text` property.\n\n\n  if (text) {\n    return actions_copy(text, {\n      container: container\n    });\n  } // Defines which selection strategy based on `target` property.\n\n\n  if (target) {\n    return action === 'cut' ? actions_cut(target) : actions_copy(target, {\n      container: container\n    });\n  }\n};\n\n/* harmony default export */ var actions_default = (ClipboardActionDefault);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n  var attribute = \"data-clipboard-\".concat(suffix);\n\n  if (!element.hasAttribute(attribute)) {\n    return;\n  }\n\n  return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n  _inherits(Clipboard, _Emitter);\n\n  var _super = _createSuper(Clipboard);\n\n  /**\n   * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n   * @param {Object} options\n   */\n  function Clipboard(trigger, options) {\n    var _this;\n\n    _classCallCheck(this, Clipboard);\n\n    _this = _super.call(this);\n\n    _this.resolveOptions(options);\n\n    _this.listenClick(trigger);\n\n    return _this;\n  }\n  /**\n   * Defines if attributes would be resolved using internal setter functions\n   * or custom functions that were passed in the constructor.\n   * @param {Object} options\n   */\n\n\n  _createClass(Clipboard, [{\n    key: \"resolveOptions\",\n    value: function resolveOptions() {\n      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n      this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n      this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n      this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n      this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n    }\n    /**\n     * Adds a click event listener to the passed trigger.\n     * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n     */\n\n  }, {\n    key: \"listenClick\",\n    value: function listenClick(trigger) {\n      var _this2 = this;\n\n      this.listener = listen_default()(trigger, 'click', function (e) {\n        return _this2.onClick(e);\n      });\n    }\n    /**\n     * Defines a new `ClipboardAction` on each click event.\n     * @param {Event} e\n     */\n\n  }, {\n    key: \"onClick\",\n    value: function onClick(e) {\n      var trigger = e.delegateTarget || e.currentTarget;\n      var action = this.action(trigger) || 'copy';\n      var text = actions_default({\n        action: action,\n        container: this.container,\n        target: this.target(trigger),\n        text: this.text(trigger)\n      }); // Fires an event based on the copy operation result.\n\n      this.emit(text ? 'success' : 'error', {\n        action: action,\n        text: text,\n        trigger: trigger,\n        clearSelection: function clearSelection() {\n          if (trigger) {\n            trigger.focus();\n          }\n\n          window.getSelection().removeAllRanges();\n        }\n      });\n    }\n    /**\n     * Default `action` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultAction\",\n    value: function defaultAction(trigger) {\n      return getAttributeValue('action', trigger);\n    }\n    /**\n     * Default `target` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultTarget\",\n    value: function defaultTarget(trigger) {\n      var selector = getAttributeValue('target', trigger);\n\n      if (selector) {\n        return document.querySelector(selector);\n      }\n    }\n    /**\n     * Allow fire programmatically a copy action\n     * @param {String|HTMLElement} target\n     * @param {Object} options\n     * @returns Text copied.\n     */\n\n  }, {\n    key: \"defaultText\",\n\n    /**\n     * Default `text` lookup function.\n     * @param {Element} trigger\n     */\n    value: function defaultText(trigger) {\n      return getAttributeValue('text', trigger);\n    }\n    /**\n     * Destroy lifecycle.\n     */\n\n  }, {\n    key: \"destroy\",\n    value: function destroy() {\n      this.listener.destroy();\n    }\n  }], [{\n    key: \"copy\",\n    value: function copy(target) {\n      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n        container: document.body\n      };\n      return actions_copy(target, options);\n    }\n    /**\n     * Allow fire programmatically a cut action\n     * @param {String|HTMLElement} target\n     * @returns Text cutted.\n     */\n\n  }, {\n    key: \"cut\",\n    value: function cut(target) {\n      return actions_cut(target);\n    }\n    /**\n     * Returns the support of the given action, or all actions if no action is\n     * given.\n     * @param {String} [action]\n     */\n\n  }, {\n    key: \"isSupported\",\n    value: function isSupported() {\n      var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n      var actions = typeof action === 'string' ? [action] : action;\n      var support = !!document.queryCommandSupported;\n      actions.forEach(function (action) {\n        support = support && !!document.queryCommandSupported(action);\n      });\n      return support;\n    }\n  }]);\n\n  return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n    var proto = Element.prototype;\n\n    proto.matches = proto.matchesSelector ||\n                    proto.mozMatchesSelector ||\n                    proto.msMatchesSelector ||\n                    proto.oMatchesSelector ||\n                    proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n    while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n        if (typeof element.matches === 'function' &&\n            element.matches(selector)) {\n          return element;\n        }\n        element = element.parentNode;\n    }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n    var listenerFn = listener.apply(this, arguments);\n\n    element.addEventListener(type, listenerFn, useCapture);\n\n    return {\n        destroy: function() {\n            element.removeEventListener(type, listenerFn, useCapture);\n        }\n    }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n    // Handle the regular Element usage\n    if (typeof elements.addEventListener === 'function') {\n        return _delegate.apply(null, arguments);\n    }\n\n    // Handle Element-less usage, it defaults to global delegation\n    if (typeof type === 'function') {\n        // Use `document` as the first parameter, then apply arguments\n        // This is a short way to .unshift `arguments` without running into deoptimizations\n        return _delegate.bind(null, document).apply(null, arguments);\n    }\n\n    // Handle Selector-based usage\n    if (typeof elements === 'string') {\n        elements = document.querySelectorAll(elements);\n    }\n\n    // Handle Array-like based usage\n    return Array.prototype.map.call(elements, function (element) {\n        return _delegate(element, selector, type, callback, useCapture);\n    });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n    return function(e) {\n        e.delegateTarget = closest(e.target, selector);\n\n        if (e.delegateTarget) {\n            callback.call(element, e);\n        }\n    }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n    return value !== undefined\n        && value instanceof HTMLElement\n        && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return value !== undefined\n        && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n        && ('length' in value)\n        && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n    return typeof value === 'string'\n        || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n    if (!target && !type && !callback) {\n        throw new Error('Missing required arguments');\n    }\n\n    if (!is.string(type)) {\n        throw new TypeError('Second argument must be a String');\n    }\n\n    if (!is.fn(callback)) {\n        throw new TypeError('Third argument must be a Function');\n    }\n\n    if (is.node(target)) {\n        return listenNode(target, type, callback);\n    }\n    else if (is.nodeList(target)) {\n        return listenNodeList(target, type, callback);\n    }\n    else if (is.string(target)) {\n        return listenSelector(target, type, callback);\n    }\n    else {\n        throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n    }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n    node.addEventListener(type, callback);\n\n    return {\n        destroy: function() {\n            node.removeEventListener(type, callback);\n        }\n    }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n    Array.prototype.forEach.call(nodeList, function(node) {\n        node.addEventListener(type, callback);\n    });\n\n    return {\n        destroy: function() {\n            Array.prototype.forEach.call(nodeList, function(node) {\n                node.removeEventListener(type, callback);\n            });\n        }\n    }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n    return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n    var selectedText;\n\n    if (element.nodeName === 'SELECT') {\n        element.focus();\n\n        selectedText = element.value;\n    }\n    else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n        var isReadOnly = element.hasAttribute('readonly');\n\n        if (!isReadOnly) {\n            element.setAttribute('readonly', '');\n        }\n\n        element.select();\n        element.setSelectionRange(0, element.value.length);\n\n        if (!isReadOnly) {\n            element.removeAttribute('readonly');\n        }\n\n        selectedText = element.value;\n    }\n    else {\n        if (element.hasAttribute('contenteditable')) {\n            element.focus();\n        }\n\n        var selection = window.getSelection();\n        var range = document.createRange();\n\n        range.selectNodeContents(element);\n        selection.removeAllRanges();\n        selection.addRange(range);\n\n        selectedText = selection.toString();\n    }\n\n    return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(686);\n/******/ })()\n.default;\n});", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param  {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n  var str = '' + string;\n  var match = matchHtmlRegExp.exec(str);\n\n  if (!match) {\n    return str;\n  }\n\n  var escape;\n  var html = '';\n  var index = 0;\n  var lastIndex = 0;\n\n  for (index = match.index; index < str.length; index++) {\n    switch (str.charCodeAt(index)) {\n      case 34: // \"\n        escape = '&quot;';\n        break;\n      case 38: // &\n        escape = '&amp;';\n        break;\n      case 39: // '\n        escape = '&#39;';\n        break;\n      case 60: // <\n        escape = '&lt;';\n        break;\n      case 62: // >\n        escape = '&gt;';\n        break;\n      default:\n        continue;\n    }\n\n    if (lastIndex !== index) {\n      html += str.substring(lastIndex, index);\n    }\n\n    lastIndex = index + 1;\n    html += escape;\n  }\n\n  return lastIndex !== index\n    ? html + str.substring(lastIndex, index)\n    : html;\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport \"focus-visible\"\n\nimport {\n  EMPTY,\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  delay,\n  filter,\n  map,\n  merge,\n  mergeWith,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n  at,\n  getActiveElement,\n  getOptionalElement,\n  requestJSON,\n  setLocation,\n  setToggle,\n  watchDocument,\n  watchKeyboard,\n  watchLocation,\n  watchLocationTarget,\n  watchMedia,\n  watchPrint,\n  watchScript,\n  watchViewport\n} from \"./browser\"\nimport {\n  getComponentElement,\n  getComponentElements,\n  mountAnnounce,\n  mountBackToTop,\n  mountConsent,\n  mountContent,\n  mountDialog,\n  mountHeader,\n  mountHeaderTitle,\n  mountPalette,\n  mountProgress,\n  mountSearch,\n  mountSearchHiglight,\n  mountSidebar,\n  mountSource,\n  mountTableOfContents,\n  mountTabs,\n  watchHeader,\n  watchMain\n} from \"./components\"\nimport {\n  SearchIndex,\n  setupClipboardJS,\n  setupInstantNavigation,\n  setupVersionSelector\n} from \"./integrations\"\nimport {\n  patchEllipsis,\n  patchIndeterminate,\n  patchScrollfix,\n  patchScrolllock\n} from \"./patches\"\nimport \"./polyfills\"\n\n/* ----------------------------------------------------------------------------\n * Functions - @todo refactor\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch search index\n *\n * @returns Search index observable\n */\nfunction fetchSearchIndex(): Observable<SearchIndex> {\n  if (location.protocol === \"file:\") {\n    return watchScript(\n      `${new URL(\"search/search_index.js\", config.base)}`\n    )\n      .pipe(\n        // @ts-ignore - @todo fix typings\n        map(() => __index),\n        shareReplay(1)\n      )\n  } else {\n    return requestJSON<SearchIndex>(\n      new URL(\"search/search_index.json\", config.base)\n    )\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$   = watchLocationTarget(location$)\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$   = watchMedia(\"(min-width: 960px)\")\nconst screen$   = watchMedia(\"(min-width: 1220px)\")\nconst print$    = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n  ? fetchSearchIndex()\n  : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject<string>()\nsetupClipboardJS({ alert$ })\n\n/* Set up progress indicator */\nconst progress$ = new Subject<number>()\n\n/* Set up instant navigation, if enabled */\nif (feature(\"navigation.instant\"))\n  setupInstantNavigation({ location$, viewport$, progress$ })\n    .subscribe(document$)\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n  setupVersionSelector({ document$ })\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n  .pipe(\n    delay(125)\n  )\n    .subscribe(() => {\n      setToggle(\"drawer\", false)\n      setToggle(\"search\", false)\n    })\n\n/* Set up global keyboard handlers */\nkeyboard$\n  .pipe(\n    filter(({ mode }) => mode === \"global\")\n  )\n    .subscribe(key => {\n      switch (key.type) {\n\n        /* Go to previous page */\n        case \"p\":\n        case \",\":\n          const prev = getOptionalElement<HTMLLinkElement>(\"link[rel=prev]\")\n          if (typeof prev !== \"undefined\")\n            setLocation(prev)\n          break\n\n        /* Go to next page */\n        case \"n\":\n        case \".\":\n          const next = getOptionalElement<HTMLLinkElement>(\"link[rel=next]\")\n          if (typeof next !== \"undefined\")\n            setLocation(next)\n          break\n\n        /* Expand navigation, see https://bit.ly/3ZjG5io */\n        case \"Enter\":\n          const active = getActiveElement()\n          if (active instanceof HTMLLabelElement)\n            active.click()\n      }\n    })\n\n/* Set up patches */\npatchEllipsis({ document$ })\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n  .pipe(\n    map(() => getComponentElement(\"main\")),\n    switchMap(el => watchMain(el, { viewport$, header$ })),\n    shareReplay(1)\n  )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n  /* Consent */\n  ...getComponentElements(\"consent\")\n    .map(el => mountConsent(el, { target$ })),\n\n  /* Dialog */\n  ...getComponentElements(\"dialog\")\n    .map(el => mountDialog(el, { alert$ })),\n\n  /* Header */\n  ...getComponentElements(\"header\")\n    .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n  /* Color palette */\n  ...getComponentElements(\"palette\")\n    .map(el => mountPalette(el)),\n\n  /* Progress bar */\n  ...getComponentElements(\"progress\")\n    .map(el => mountProgress(el, { progress$ })),\n\n  /* Search */\n  ...getComponentElements(\"search\")\n    .map(el => mountSearch(el, { index$, keyboard$ })),\n\n  /* Repository information */\n  ...getComponentElements(\"source\")\n    .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n  /* Announcement bar */\n  ...getComponentElements(\"announce\")\n    .map(el => mountAnnounce(el)),\n\n  /* Content */\n  ...getComponentElements(\"content\")\n    .map(el => mountContent(el, { viewport$, target$, print$ })),\n\n  /* Search highlighting */\n  ...getComponentElements(\"content\")\n    .map(el => feature(\"search.highlight\")\n      ? mountSearchHiglight(el, { index$, location$ })\n      : EMPTY\n    ),\n\n  /* Header title */\n  ...getComponentElements(\"header-title\")\n    .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n  /* Sidebar */\n  ...getComponentElements(\"sidebar\")\n    .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n      ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n      : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n    ),\n\n  /* Navigation tabs */\n  ...getComponentElements(\"tabs\")\n    .map(el => mountTabs(el, { viewport$, header$ })),\n\n  /* Table of contents */\n  ...getComponentElements(\"toc\")\n    .map(el => mountTableOfContents(el, {\n      viewport$, header$, main$, target$\n    })),\n\n  /* Back-to-top button */\n  ...getComponentElements(\"top\")\n    .map(el => mountBackToTop(el, { viewport$, header$, main$, target$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n  .pipe(\n    switchMap(() => content$),\n    mergeWith(control$),\n    shareReplay(1)\n  )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$  = document$          /* Document observable */\nwindow.location$  = location$          /* Location subject */\nwindow.target$    = target$            /* Location target observable */\nwindow.keyboard$  = keyboard$          /* Keyboard observable */\nwindow.viewport$  = viewport$          /* Viewport observable */\nwindow.tablet$    = tablet$            /* Media tablet observable */\nwindow.screen$    = screen$            /* Media screen observable */\nwindow.print$     = print$             /* Media print observable */\nwindow.alert$     = alert$             /* Alert subject */\nwindow.progress$  = progress$          /* Progress indicator subject */\nwindow.component$ = component$         /* Component observable */\n", "/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n", "/**\n * Returns true if the object is a function.\n * @param value The value to check\n */\nexport function isFunction(value: any): value is (...args: any[]) => any {\n  return typeof value === 'function';\n}\n", "/**\n * Used to create Error subclasses until the community moves away from ES5.\n *\n * This is because compiling from TypeScript down to ES5 has issues with subclassing Errors\n * as well as other built-in types: https://github.com/Microsoft/TypeScript/issues/12123\n *\n * @param createImpl A factory function to create the actual constructor implementation. The returned\n * function should be a named function that calls `_super` internally.\n */\nexport function createErrorClass<T>(createImpl: (_super: any) => any): T {\n  const _super = (instance: any) => {\n    Error.call(instance);\n    instance.stack = new Error().stack;\n  };\n\n  const ctorFunc = createImpl(_super);\n  ctorFunc.prototype = Object.create(Error.prototype);\n  ctorFunc.prototype.constructor = ctorFunc;\n  return ctorFunc;\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface UnsubscriptionError extends Error {\n  readonly errors: any[];\n}\n\nexport interface UnsubscriptionErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (errors: any[]): UnsubscriptionError;\n}\n\n/**\n * An error thrown when one or more errors have occurred during the\n * `unsubscribe` of a {@link Subscription}.\n */\nexport const UnsubscriptionError: UnsubscriptionErrorCtor = createErrorClass(\n  (_super) =>\n    function UnsubscriptionErrorImpl(this: any, errors: (Error | string)[]) {\n      _super(this);\n      this.message = errors\n        ? `${errors.length} errors occurred during unsubscription:\n${errors.map((err, i) => `${i + 1}) ${err.toString()}`).join('\\n  ')}`\n        : '';\n      this.name = 'UnsubscriptionError';\n      this.errors = errors;\n    }\n);\n", "/**\n * Removes an item from an array, mutating it.\n * @param arr The array to remove the item from\n * @param item The item to remove\n */\nexport function arrRemove<T>(arr: T[] | undefined | null, item: T) {\n  if (arr) {\n    const index = arr.indexOf(item);\n    0 <= index && arr.splice(index, 1);\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { UnsubscriptionError } from './util/UnsubscriptionError';\nimport { SubscriptionLike, TeardownLogic, Unsubscribable } from './types';\nimport { arrRemove } from './util/arrRemove';\n\n/**\n * Represents a disposable resource, such as the execution of an Observable. A\n * Subscription has one important method, `unsubscribe`, that takes no argument\n * and just disposes the resource held by the subscription.\n *\n * Additionally, subscriptions may be grouped together through the `add()`\n * method, which will attach a child Subscription to the current Subscription.\n * When a Subscription is unsubscribed, all its children (and its grandchildren)\n * will be unsubscribed as well.\n *\n * @class Subscription\n */\nexport class Subscription implements SubscriptionLike {\n  /** @nocollapse */\n  public static EMPTY = (() => {\n    const empty = new Subscription();\n    empty.closed = true;\n    return empty;\n  })();\n\n  /**\n   * A flag to indicate whether this Subscription has already been unsubscribed.\n   */\n  public closed = false;\n\n  private _parentage: Subscription[] | Subscription | null = null;\n\n  /**\n   * The list of registered finalizers to execute upon unsubscription. Adding and removing from this\n   * list occurs in the {@link #add} and {@link #remove} methods.\n   */\n  private _finalizers: Exclude<TeardownLogic, void>[] | null = null;\n\n  /**\n   * @param initialTeardown A function executed first as part of the finalization\n   * process that is kicked off when {@link #unsubscribe} is called.\n   */\n  constructor(private initialTeardown?: () => void) {}\n\n  /**\n   * Disposes the resources held by the subscription. May, for instance, cancel\n   * an ongoing Observable execution or cancel any other type of work that\n   * started when the Subscription was created.\n   * @return {void}\n   */\n  unsubscribe(): void {\n    let errors: any[] | undefined;\n\n    if (!this.closed) {\n      this.closed = true;\n\n      // Remove this from it's parents.\n      const { _parentage } = this;\n      if (_parentage) {\n        this._parentage = null;\n        if (Array.isArray(_parentage)) {\n          for (const parent of _parentage) {\n            parent.remove(this);\n          }\n        } else {\n          _parentage.remove(this);\n        }\n      }\n\n      const { initialTeardown: initialFinalizer } = this;\n      if (isFunction(initialFinalizer)) {\n        try {\n          initialFinalizer();\n        } catch (e) {\n          errors = e instanceof UnsubscriptionError ? e.errors : [e];\n        }\n      }\n\n      const { _finalizers } = this;\n      if (_finalizers) {\n        this._finalizers = null;\n        for (const finalizer of _finalizers) {\n          try {\n            execFinalizer(finalizer);\n          } catch (err) {\n            errors = errors ?? [];\n            if (err instanceof UnsubscriptionError) {\n              errors = [...errors, ...err.errors];\n            } else {\n              errors.push(err);\n            }\n          }\n        }\n      }\n\n      if (errors) {\n        throw new UnsubscriptionError(errors);\n      }\n    }\n  }\n\n  /**\n   * Adds a finalizer to this subscription, so that finalization will be unsubscribed/called\n   * when this subscription is unsubscribed. If this subscription is already {@link #closed},\n   * because it has already been unsubscribed, then whatever finalizer is passed to it\n   * will automatically be executed (unless the finalizer itself is also a closed subscription).\n   *\n   * Closed Subscriptions cannot be added as finalizers to any subscription. Adding a closed\n   * subscription to a any subscription will result in no operation. (A noop).\n   *\n   * Adding a subscription to itself, or adding `null` or `undefined` will not perform any\n   * operation at all. (A noop).\n   *\n   * `Subscription` instances that are added to this instance will automatically remove themselves\n   * if they are unsubscribed. Functions and {@link Unsubscribable} objects that you wish to remove\n   * will need to be removed manually with {@link #remove}\n   *\n   * @param teardown The finalization logic to add to this subscription.\n   */\n  add(teardown: TeardownLogic): void {\n    // Only add the finalizer if it's not undefined\n    // and don't add a subscription to itself.\n    if (teardown && teardown !== this) {\n      if (this.closed) {\n        // If this subscription is already closed,\n        // execute whatever finalizer is handed to it automatically.\n        execFinalizer(teardown);\n      } else {\n        if (teardown instanceof Subscription) {\n          // We don't add closed subscriptions, and we don't add the same subscription\n          // twice. Subscription unsubscribe is idempotent.\n          if (teardown.closed || teardown._hasParent(this)) {\n            return;\n          }\n          teardown._addParent(this);\n        }\n        (this._finalizers = this._finalizers ?? []).push(teardown);\n      }\n    }\n  }\n\n  /**\n   * Checks to see if a this subscription already has a particular parent.\n   * This will signal that this subscription has already been added to the parent in question.\n   * @param parent the parent to check for\n   */\n  private _hasParent(parent: Subscription) {\n    const { _parentage } = this;\n    return _parentage === parent || (Array.isArray(_parentage) && _parentage.includes(parent));\n  }\n\n  /**\n   * Adds a parent to this subscription so it can be removed from the parent if it\n   * unsubscribes on it's own.\n   *\n   * NOTE: THIS ASSUMES THAT {@link _hasParent} HAS ALREADY BEEN CHECKED.\n   * @param parent The parent subscription to add\n   */\n  private _addParent(parent: Subscription) {\n    const { _parentage } = this;\n    this._parentage = Array.isArray(_parentage) ? (_parentage.push(parent), _parentage) : _parentage ? [_parentage, parent] : parent;\n  }\n\n  /**\n   * Called on a child when it is removed via {@link #remove}.\n   * @param parent The parent to remove\n   */\n  private _removeParent(parent: Subscription) {\n    const { _parentage } = this;\n    if (_parentage === parent) {\n      this._parentage = null;\n    } else if (Array.isArray(_parentage)) {\n      arrRemove(_parentage, parent);\n    }\n  }\n\n  /**\n   * Removes a finalizer from this subscription that was previously added with the {@link #add} method.\n   *\n   * Note that `Subscription` instances, when unsubscribed, will automatically remove themselves\n   * from every other `Subscription` they have been added to. This means that using the `remove` method\n   * is not a common thing and should be used thoughtfully.\n   *\n   * If you add the same finalizer instance of a function or an unsubscribable object to a `Subscription` instance\n   * more than once, you will need to call `remove` the same number of times to remove all instances.\n   *\n   * All finalizer instances are removed to free up memory upon unsubscription.\n   *\n   * @param teardown The finalizer to remove from this subscription\n   */\n  remove(teardown: Exclude<TeardownLogic, void>): void {\n    const { _finalizers } = this;\n    _finalizers && arrRemove(_finalizers, teardown);\n\n    if (teardown instanceof Subscription) {\n      teardown._removeParent(this);\n    }\n  }\n}\n\nexport const EMPTY_SUBSCRIPTION = Subscription.EMPTY;\n\nexport function isSubscription(value: any): value is Subscription {\n  return (\n    value instanceof Subscription ||\n    (value && 'closed' in value && isFunction(value.remove) && isFunction(value.add) && isFunction(value.unsubscribe))\n  );\n}\n\nfunction execFinalizer(finalizer: Unsubscribable | (() => void)) {\n  if (isFunction(finalizer)) {\n    finalizer();\n  } else {\n    finalizer.unsubscribe();\n  }\n}\n", "import { Subscriber } from './Subscriber';\nimport { ObservableNotification } from './types';\n\n/**\n * The {@link GlobalConfig} object for RxJS. It is used to configure things\n * like how to react on unhandled errors.\n */\nexport const config: GlobalConfig = {\n  onUnhandledError: null,\n  onStoppedNotification: null,\n  Promise: undefined,\n  useDeprecatedSynchronousErrorHandling: false,\n  useDeprecatedNextContext: false,\n};\n\n/**\n * The global configuration object for RxJS, used to configure things\n * like how to react on unhandled errors. Accessible via {@link config}\n * object.\n */\nexport interface GlobalConfig {\n  /**\n   * A registration point for unhandled errors from RxJS. These are errors that\n   * cannot were not handled by consuming code in the usual subscription path. For\n   * example, if you have this configured, and you subscribe to an observable without\n   * providing an error handler, errors from that subscription will end up here. This\n   * will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onUnhandledError: ((err: any) => void) | null;\n\n  /**\n   * A registration point for notifications that cannot be sent to subscribers because they\n   * have completed, errored or have been explicitly unsubscribed. By default, next, complete\n   * and error notifications sent to stopped subscribers are noops. However, sometimes callers\n   * might want a different behavior. For example, with sources that attempt to report errors\n   * to stopped subscribers, a caller can configure RxJS to throw an unhandled error instead.\n   * This will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onStoppedNotification: ((notification: ObservableNotification<any>, subscriber: Subscriber<any>) => void) | null;\n\n  /**\n   * The promise constructor used by default for {@link Observable#toPromise toPromise} and {@link Observable#forEach forEach}\n   * methods.\n   *\n   * @deprecated As of version 8, RxJS will no longer support this sort of injection of a\n   * Promise constructor. If you need a Promise implementation other than native promises,\n   * please polyfill/patch Promise as you see appropriate. Will be removed in v8.\n   */\n  Promise?: PromiseConstructorLike;\n\n  /**\n   * If true, turns on synchronous error rethrowing, which is a deprecated behavior\n   * in v6 and higher. This behavior enables bad patterns like wrapping a subscribe\n   * call in a try/catch block. It also enables producer interference, a nasty bug\n   * where a multicast can be broken for all observers by a downstream consumer with\n   * an unhandled error. DO NOT USE THIS FLAG UNLESS IT'S NEEDED TO BUY TIME\n   * FOR MIGRATION REASONS.\n   *\n   * @deprecated As of version 8, RxJS will no longer support synchronous throwing\n   * of unhandled errors. All errors will be thrown on a separate call stack to prevent bad\n   * behaviors described above. Will be removed in v8.\n   */\n  useDeprecatedSynchronousErrorHandling: boolean;\n\n  /**\n   * If true, enables an as-of-yet undocumented feature from v5: The ability to access\n   * `unsubscribe()` via `this` context in `next` functions created in observers passed\n   * to `subscribe`.\n   *\n   * This is being removed because the performance was severely problematic, and it could also cause\n   * issues when types other than POJOs are passed to subscribe as subscribers, as they will likely have\n   * their `this` context overwritten.\n   *\n   * @deprecated As of version 8, RxJS will no longer support altering the\n   * context of next functions provided as part of an observer to Subscribe. Instead,\n   * you will have access to a subscription or a signal or token that will allow you to do things like\n   * unsubscribe and test closed status. Will be removed in v8.\n   */\n  useDeprecatedNextContext: boolean;\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetTimeoutFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearTimeoutFunction = (handle: TimerHandle) => void;\n\ninterface TimeoutProvider {\n  setTimeout: SetTimeoutFunction;\n  clearTimeout: ClearTimeoutFunction;\n  delegate:\n    | {\n        setTimeout: SetTimeoutFunction;\n        clearTimeout: ClearTimeoutFunction;\n      }\n    | undefined;\n}\n\nexport const timeoutProvider: TimeoutProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setTimeout(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = timeoutProvider;\n    if (delegate?.setTimeout) {\n      return delegate.setTimeout(handler, timeout, ...args);\n    }\n    return setTimeout(handler, timeout, ...args);\n  },\n  clearTimeout(handle) {\n    const { delegate } = timeoutProvider;\n    return (delegate?.clearTimeout || clearTimeout)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { config } from '../config';\nimport { timeoutProvider } from '../scheduler/timeoutProvider';\n\n/**\n * Handles an error on another job either with the user-configured {@link onUnhandledError},\n * or by throwing it on that new job so it can be picked up by `window.onerror`, `process.on('error')`, etc.\n *\n * This should be called whenever there is an error that is out-of-band with the subscription\n * or when an error hits a terminal boundary of the subscription and no error handler was provided.\n *\n * @param err the error to report\n */\nexport function reportUnhandledError(err: any) {\n  timeoutProvider.setTimeout(() => {\n    const { onUnhandledError } = config;\n    if (onUnhandledError) {\n      // Execute the user-configured error handler.\n      onUnhandledError(err);\n    } else {\n      // Throw so it is picked up by the runtime's uncaught error mechanism.\n      throw err;\n    }\n  });\n}\n", "/* tslint:disable:no-empty */\nexport function noop() { }\n", "import { CompleteNotification, NextNotification, ErrorNotification } from './types';\n\n/**\n * A completion object optimized for memory use and created to be the\n * same \"shape\" as other notifications in v8.\n * @internal\n */\nexport const COMPLETE_NOTIFICATION = (() => createNotification('C', undefined, undefined) as CompleteNotification)();\n\n/**\n * Internal use only. Creates an optimized error notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function errorNotification(error: any): ErrorNotification {\n  return createNotification('E', undefined, error) as any;\n}\n\n/**\n * Internal use only. Creates an optimized next notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function nextNotification<T>(value: T) {\n  return createNotification('N', value, undefined) as NextNotification<T>;\n}\n\n/**\n * Ensures that all notifications created internally have the same \"shape\" in v8.\n *\n * TODO: This is only exported to support a crazy legacy test in `groupBy`.\n * @internal\n */\nexport function createNotification(kind: 'N' | 'E' | 'C', value: any, error: any) {\n  return {\n    kind,\n    value,\n    error,\n  };\n}\n", "import { config } from '../config';\n\nlet context: { errorThrown: boolean; error: any } | null = null;\n\n/**\n * Handles dealing with errors for super-gross mode. Creates a context, in which\n * any synchronously thrown errors will be passed to {@link captureError}. Which\n * will record the error such that it will be rethrown after the call back is complete.\n * TODO: Remove in v8\n * @param cb An immediately executed function.\n */\nexport function errorContext(cb: () => void) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    const isRoot = !context;\n    if (isRoot) {\n      context = { errorThrown: false, error: null };\n    }\n    cb();\n    if (isRoot) {\n      const { errorThrown, error } = context!;\n      context = null;\n      if (errorThrown) {\n        throw error;\n      }\n    }\n  } else {\n    // This is the general non-deprecated path for everyone that\n    // isn't crazy enough to use super-gross mode (useDeprecatedSynchronousErrorHandling)\n    cb();\n  }\n}\n\n/**\n * Captures errors only in super-gross mode.\n * @param err the error to capture\n */\nexport function captureError(err: any) {\n  if (config.useDeprecatedSynchronousErrorHandling && context) {\n    context.errorThrown = true;\n    context.error = err;\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { Observer, ObservableNotification } from './types';\nimport { isSubscription, Subscription } from './Subscription';\nimport { config } from './config';\nimport { reportUnhandledError } from './util/reportUnhandledError';\nimport { noop } from './util/noop';\nimport { nextNotification, errorNotification, COMPLETE_NOTIFICATION } from './NotificationFactories';\nimport { timeoutProvider } from './scheduler/timeoutProvider';\nimport { captureError } from './util/errorContext';\n\n/**\n * Implements the {@link Observer} interface and extends the\n * {@link Subscription} class. While the {@link Observer} is the public API for\n * consuming the values of an {@link Observable}, all Observers get converted to\n * a Subscriber, in order to provide Subscription-like capabilities such as\n * `unsubscribe`. Subscriber is a common type in RxJS, and crucial for\n * implementing operators, but it is rarely used as a public API.\n *\n * @class Subscriber<T>\n */\nexport class Subscriber<T> extends Subscription implements Observer<T> {\n  /**\n   * A static factory for a Subscriber, given a (potentially partial) definition\n   * of an Observer.\n   * @param next The `next` callback of an Observer.\n   * @param error The `error` callback of an\n   * Observer.\n   * @param complete The `complete` callback of an\n   * Observer.\n   * @return A Subscriber wrapping the (partially defined)\n   * Observer represented by the given arguments.\n   * @nocollapse\n   * @deprecated Do not use. Will be removed in v8. There is no replacement for this\n   * method, and there is no reason to be creating instances of `Subscriber` directly.\n   * If you have a specific use case, please file an issue.\n   */\n  static create<T>(next?: (x?: T) => void, error?: (e?: any) => void, complete?: () => void): Subscriber<T> {\n    return new SafeSubscriber(next, error, complete);\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected isStopped: boolean = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected destination: Subscriber<any> | Observer<any>; // this `any` is the escape hatch to erase extra type param (e.g. R)\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * There is no reason to directly create an instance of Subscriber. This type is exported for typings reasons.\n   */\n  constructor(destination?: Subscriber<any> | Observer<any>) {\n    super();\n    if (destination) {\n      this.destination = destination;\n      // Automatically chain subscriptions together here.\n      // if destination is a Subscription, then it is a Subscriber.\n      if (isSubscription(destination)) {\n        destination.add(this);\n      }\n    } else {\n      this.destination = EMPTY_OBSERVER;\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `next` from\n   * the Observable, with a value. The Observable may call this method 0 or more\n   * times.\n   * @param {T} [value] The `next` value.\n   * @return {void}\n   */\n  next(value?: T): void {\n    if (this.isStopped) {\n      handleStoppedNotification(nextNotification(value), this);\n    } else {\n      this._next(value!);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `error` from\n   * the Observable, with an attached `Error`. Notifies the Observer that\n   * the Observable has experienced an error condition.\n   * @param {any} [err] The `error` exception.\n   * @return {void}\n   */\n  error(err?: any): void {\n    if (this.isStopped) {\n      handleStoppedNotification(errorNotification(err), this);\n    } else {\n      this.isStopped = true;\n      this._error(err);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive a valueless notification of type\n   * `complete` from the Observable. Notifies the Observer that the Observable\n   * has finished sending push-based notifications.\n   * @return {void}\n   */\n  complete(): void {\n    if (this.isStopped) {\n      handleStoppedNotification(COMPLETE_NOTIFICATION, this);\n    } else {\n      this.isStopped = true;\n      this._complete();\n    }\n  }\n\n  unsubscribe(): void {\n    if (!this.closed) {\n      this.isStopped = true;\n      super.unsubscribe();\n      this.destination = null!;\n    }\n  }\n\n  protected _next(value: T): void {\n    this.destination.next(value);\n  }\n\n  protected _error(err: any): void {\n    try {\n      this.destination.error(err);\n    } finally {\n      this.unsubscribe();\n    }\n  }\n\n  protected _complete(): void {\n    try {\n      this.destination.complete();\n    } finally {\n      this.unsubscribe();\n    }\n  }\n}\n\n/**\n * This bind is captured here because we want to be able to have\n * compatibility with monoid libraries that tend to use a method named\n * `bind`. In particular, a library called Monio requires this.\n */\nconst _bind = Function.prototype.bind;\n\nfunction bind<Fn extends (...args: any[]) => any>(fn: Fn, thisArg: any): Fn {\n  return _bind.call(fn, thisArg);\n}\n\n/**\n * Internal optimization only, DO NOT EXPOSE.\n * @internal\n */\nclass ConsumerObserver<T> implements Observer<T> {\n  constructor(private partialObserver: Partial<Observer<T>>) {}\n\n  next(value: T): void {\n    const { partialObserver } = this;\n    if (partialObserver.next) {\n      try {\n        partialObserver.next(value);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n\n  error(err: any): void {\n    const { partialObserver } = this;\n    if (partialObserver.error) {\n      try {\n        partialObserver.error(err);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    } else {\n      handleUnhandledError(err);\n    }\n  }\n\n  complete(): void {\n    const { partialObserver } = this;\n    if (partialObserver.complete) {\n      try {\n        partialObserver.complete();\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n}\n\nexport class SafeSubscriber<T> extends Subscriber<T> {\n  constructor(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((e?: any) => void) | null,\n    complete?: (() => void) | null\n  ) {\n    super();\n\n    let partialObserver: Partial<Observer<T>>;\n    if (isFunction(observerOrNext) || !observerOrNext) {\n      // The first argument is a function, not an observer. The next\n      // two arguments *could* be observers, or they could be empty.\n      partialObserver = {\n        next: (observerOrNext ?? undefined) as (((value: T) => void) | undefined),\n        error: error ?? undefined,\n        complete: complete ?? undefined,\n      };\n    } else {\n      // The first argument is a partial observer.\n      let context: any;\n      if (this && config.useDeprecatedNextContext) {\n        // This is a deprecated path that made `this.unsubscribe()` available in\n        // next handler functions passed to subscribe. This only exists behind a flag\n        // now, as it is *very* slow.\n        context = Object.create(observerOrNext);\n        context.unsubscribe = () => this.unsubscribe();\n        partialObserver = {\n          next: observerOrNext.next && bind(observerOrNext.next, context),\n          error: observerOrNext.error && bind(observerOrNext.error, context),\n          complete: observerOrNext.complete && bind(observerOrNext.complete, context),\n        };\n      } else {\n        // The \"normal\" path. Just use the partial observer directly.\n        partialObserver = observerOrNext;\n      }\n    }\n\n    // Wrap the partial observer to ensure it's a full observer, and\n    // make sure proper error handling is accounted for.\n    this.destination = new ConsumerObserver(partialObserver);\n  }\n}\n\nfunction handleUnhandledError(error: any) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    captureError(error);\n  } else {\n    // Ideal path, we report this as an unhandled error,\n    // which is thrown on a new call stack.\n    reportUnhandledError(error);\n  }\n}\n\n/**\n * An error handler used when no error handler was supplied\n * to the SafeSubscriber -- meaning no error handler was supplied\n * do the `subscribe` call on our observable.\n * @param err The error to handle\n */\nfunction defaultErrorHandler(err: any) {\n  throw err;\n}\n\n/**\n * A handler for notifications that cannot be sent to a stopped subscriber.\n * @param notification The notification being sent\n * @param subscriber The stopped subscriber\n */\nfunction handleStoppedNotification(notification: ObservableNotification<any>, subscriber: Subscriber<any>) {\n  const { onStoppedNotification } = config;\n  onStoppedNotification && timeoutProvider.setTimeout(() => onStoppedNotification(notification, subscriber));\n}\n\n/**\n * The observer used as a stub for subscriptions where the user did not\n * pass any arguments to `subscribe`. Comes with the default error handling\n * behavior.\n */\nexport const EMPTY_OBSERVER: Readonly<Observer<any>> & { closed: true } = {\n  closed: true,\n  next: noop,\n  error: defaultErrorHandler,\n  complete: noop,\n};\n", "/**\n * Symbol.observable or a string \"@@observable\". Used for interop\n *\n * @deprecated We will no longer be exporting this symbol in upcoming versions of RxJS.\n * Instead polyfill and use Symbol.observable directly *or* use https://www.npmjs.com/package/symbol-observable\n */\nexport const observable: string | symbol = (() => (typeof Symbol === 'function' && Symbol.observable) || '@@observable')();\n", "/**\n * This function takes one parameter and just returns it. Simply put,\n * this is like `<T>(x: T): T => x`.\n *\n * ## Examples\n *\n * This is useful in some cases when using things like `mergeMap`\n *\n * ```ts\n * import { interval, take, map, range, mergeMap, identity } from 'rxjs';\n *\n * const source$ = interval(1000).pipe(take(5));\n *\n * const result$ = source$.pipe(\n *   map(i => range(i)),\n *   mergeMap(identity) // same as mergeMap(x => x)\n * );\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * Or when you want to selectively apply an operator\n *\n * ```ts\n * import { interval, take, identity } from 'rxjs';\n *\n * const shouldLimit = () => Math.random() < 0.5;\n *\n * const source$ = interval(1000);\n *\n * const result$ = source$.pipe(shouldLimit() ? take(5) : identity);\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * @param x Any value that is returned by this function\n * @returns The value passed as the first parameter to this function\n */\nexport function identity<T>(x: T): T {\n  return x;\n}\n", "import { identity } from './identity';\nimport { UnaryFunction } from '../types';\n\nexport function pipe(): typeof identity;\nexport function pipe<T, A>(fn1: UnaryFunction<T, A>): UnaryFunction<T, A>;\nexport function pipe<T, A, B>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>): UnaryFunction<T, B>;\nexport function pipe<T, A, B, C>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>, fn3: UnaryFunction<B, C>): UnaryFunction<T, C>;\nexport function pipe<T, A, B, C, D>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>\n): UnaryFunction<T, D>;\nexport function pipe<T, A, B, C, D, E>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>\n): UnaryFunction<T, E>;\nexport function pipe<T, A, B, C, D, E, F>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>\n): UnaryFunction<T, F>;\nexport function pipe<T, A, B, C, D, E, F, G>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>\n): UnaryFunction<T, G>;\nexport function pipe<T, A, B, C, D, E, F, G, H>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>\n): UnaryFunction<T, H>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>\n): UnaryFunction<T, I>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>,\n  ...fns: UnaryFunction<any, any>[]\n): UnaryFunction<T, unknown>;\n\n/**\n * pipe() can be called on one or more functions, each of which can take one argument (\"UnaryFunction\")\n * and uses it to return a value.\n * It returns a function that takes one argument, passes it to the first UnaryFunction, and then\n * passes the result to the next one, passes that result to the next one, and so on.  \n */\nexport function pipe(...fns: Array<UnaryFunction<any, any>>): UnaryFunction<any, any> {\n  return pipeFromArray(fns);\n}\n\n/** @internal */\nexport function pipeFromArray<T, R>(fns: Array<UnaryFunction<T, R>>): UnaryFunction<T, R> {\n  if (fns.length === 0) {\n    return identity as UnaryFunction<any, any>;\n  }\n\n  if (fns.length === 1) {\n    return fns[0];\n  }\n\n  return function piped(input: T): R {\n    return fns.reduce((prev: any, fn: UnaryFunction<T, R>) => fn(prev), input as any);\n  };\n}\n", "import { Operator } from './Operator';\nimport { SafeSubscriber, Subscriber } from './Subscriber';\nimport { isSubscription, Subscription } from './Subscription';\nimport { TeardownLogic, OperatorFunction, Subscribable, Observer } from './types';\nimport { observable as Symbol_observable } from './symbol/observable';\nimport { pipeFromArray } from './util/pipe';\nimport { config } from './config';\nimport { isFunction } from './util/isFunction';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A representation of any set of values over any amount of time. This is the most basic building block\n * of RxJS.\n *\n * @class Observable<T>\n */\nexport class Observable<T> implements Subscribable<T> {\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  source: Observable<any> | undefined;\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  operator: Operator<any, T> | undefined;\n\n  /**\n   * @constructor\n   * @param {Function} subscribe the function that is called when the Observable is\n   * initially subscribed to. This function is given a Subscriber, to which new values\n   * can be `next`ed, or an `error` method can be called to raise an error, or\n   * `complete` can be called to notify of a successful completion.\n   */\n  constructor(subscribe?: (this: Observable<T>, subscriber: Subscriber<T>) => TeardownLogic) {\n    if (subscribe) {\n      this._subscribe = subscribe;\n    }\n  }\n\n  // HACK: Since TypeScript inherits static properties too, we have to\n  // fight against TypeScript here so Subject can have a different static create signature\n  /**\n   * Creates a new Observable by calling the Observable constructor\n   * @owner Observable\n   * @method create\n   * @param {Function} subscribe? the subscriber function to be passed to the Observable constructor\n   * @return {Observable} a new observable\n   * @nocollapse\n   * @deprecated Use `new Observable()` instead. Will be removed in v8.\n   */\n  static create: (...args: any[]) => any = <T>(subscribe?: (subscriber: Subscriber<T>) => TeardownLogic) => {\n    return new Observable<T>(subscribe);\n  };\n\n  /**\n   * Creates a new Observable, with this Observable instance as the source, and the passed\n   * operator defined as the new observable's operator.\n   * @method lift\n   * @param operator the operator defining the operation to take on the observable\n   * @return a new observable with the Operator applied\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * If you have implemented an operator using `lift`, it is recommended that you create an\n   * operator by simply returning `new Observable()` directly. See \"Creating new operators from\n   * scratch\" section here: https://rxjs.dev/guide/operators\n   */\n  lift<R>(operator?: Operator<T, R>): Observable<R> {\n    const observable = new Observable<R>();\n    observable.source = this;\n    observable.operator = operator;\n    return observable;\n  }\n\n  subscribe(observerOrNext?: Partial<Observer<T>> | ((value: T) => void)): Subscription;\n  /** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\n  subscribe(next?: ((value: T) => void) | null, error?: ((error: any) => void) | null, complete?: (() => void) | null): Subscription;\n  /**\n   * Invokes an execution of an Observable and registers Observer handlers for notifications it will emit.\n   *\n   * <span class=\"informal\">Use it when you have all these Observables, but still nothing is happening.</span>\n   *\n   * `subscribe` is not a regular operator, but a method that calls Observable's internal `subscribe` function. It\n   * might be for example a function that you passed to Observable's constructor, but most of the time it is\n   * a library implementation, which defines what will be emitted by an Observable, and when it be will emitted. This means\n   * that calling `subscribe` is actually the moment when Observable starts its work, not when it is created, as it is often\n   * the thought.\n   *\n   * Apart from starting the execution of an Observable, this method allows you to listen for values\n   * that an Observable emits, as well as for when it completes or errors. You can achieve this in two\n   * of the following ways.\n   *\n   * The first way is creating an object that implements {@link Observer} interface. It should have methods\n   * defined by that interface, but note that it should be just a regular JavaScript object, which you can create\n   * yourself in any way you want (ES6 class, classic function constructor, object literal etc.). In particular, do\n   * not attempt to use any RxJS implementation details to create Observers - you don't need them. Remember also\n   * that your object does not have to implement all methods. If you find yourself creating a method that doesn't\n   * do anything, you can simply omit it. Note however, if the `error` method is not provided and an error happens,\n   * it will be thrown asynchronously. Errors thrown asynchronously cannot be caught using `try`/`catch`. Instead,\n   * use the {@link onUnhandledError} configuration option or use a runtime handler (like `window.onerror` or\n   * `process.on('error)`) to be notified of unhandled errors. Because of this, it's recommended that you provide\n   * an `error` method to avoid missing thrown errors.\n   *\n   * The second way is to give up on Observer object altogether and simply provide callback functions in place of its methods.\n   * This means you can provide three functions as arguments to `subscribe`, where the first function is equivalent\n   * of a `next` method, the second of an `error` method and the third of a `complete` method. Just as in case of an Observer,\n   * if you do not need to listen for something, you can omit a function by passing `undefined` or `null`,\n   * since `subscribe` recognizes these functions by where they were placed in function call. When it comes\n   * to the `error` function, as with an Observer, if not provided, errors emitted by an Observable will be thrown asynchronously.\n   *\n   * You can, however, subscribe with no parameters at all. This may be the case where you're not interested in terminal events\n   * and you also handled emissions internally by using operators (e.g. using `tap`).\n   *\n   * Whichever style of calling `subscribe` you use, in both cases it returns a Subscription object.\n   * This object allows you to call `unsubscribe` on it, which in turn will stop the work that an Observable does and will clean\n   * up all resources that an Observable used. Note that cancelling a subscription will not call `complete` callback\n   * provided to `subscribe` function, which is reserved for a regular completion signal that comes from an Observable.\n   *\n   * Remember that callbacks provided to `subscribe` are not guaranteed to be called asynchronously.\n   * It is an Observable itself that decides when these functions will be called. For example {@link of}\n   * by default emits all its values synchronously. Always check documentation for how given Observable\n   * will behave when subscribed and if its default behavior can be modified with a `scheduler`.\n   *\n   * #### Examples\n   *\n   * Subscribe with an {@link guide/observer Observer}\n   *\n   * ```ts\n   * import { of } from 'rxjs';\n   *\n   * const sumObserver = {\n   *   sum: 0,\n   *   next(value) {\n   *     console.log('Adding: ' + value);\n   *     this.sum = this.sum + value;\n   *   },\n   *   error() {\n   *     // We actually could just remove this method,\n   *     // since we do not really care about errors right now.\n   *   },\n   *   complete() {\n   *     console.log('Sum equals: ' + this.sum);\n   *   }\n   * };\n   *\n   * of(1, 2, 3) // Synchronously emits 1, 2, 3 and then completes.\n   *   .subscribe(sumObserver);\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Subscribe with functions ({@link deprecations/subscribe-arguments deprecated})\n   *\n   * ```ts\n   * import { of } from 'rxjs'\n   *\n   * let sum = 0;\n   *\n   * of(1, 2, 3).subscribe(\n   *   value => {\n   *     console.log('Adding: ' + value);\n   *     sum = sum + value;\n   *   },\n   *   undefined,\n   *   () => console.log('Sum equals: ' + sum)\n   * );\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Cancel a subscription\n   *\n   * ```ts\n   * import { interval } from 'rxjs';\n   *\n   * const subscription = interval(1000).subscribe({\n   *   next(num) {\n   *     console.log(num)\n   *   },\n   *   complete() {\n   *     // Will not be called, even when cancelling subscription.\n   *     console.log('completed!');\n   *   }\n   * });\n   *\n   * setTimeout(() => {\n   *   subscription.unsubscribe();\n   *   console.log('unsubscribed!');\n   * }, 2500);\n   *\n   * // Logs:\n   * // 0 after 1s\n   * // 1 after 2s\n   * // 'unsubscribed!' after 2.5s\n   * ```\n   *\n   * @param {Observer|Function} observerOrNext (optional) Either an observer with methods to be called,\n   * or the first of three possible handlers, which is the handler for each value emitted from the subscribed\n   * Observable.\n   * @param {Function} error (optional) A handler for a terminal event resulting from an error. If no error handler is provided,\n   * the error will be thrown asynchronously as unhandled.\n   * @param {Function} complete (optional) A handler for a terminal event resulting from successful completion.\n   * @return {Subscription} a subscription reference to the registered handlers\n   * @method subscribe\n   */\n  subscribe(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((error: any) => void) | null,\n    complete?: (() => void) | null\n  ): Subscription {\n    const subscriber = isSubscriber(observerOrNext) ? observerOrNext : new SafeSubscriber(observerOrNext, error, complete);\n\n    errorContext(() => {\n      const { operator, source } = this;\n      subscriber.add(\n        operator\n          ? // We're dealing with a subscription in the\n            // operator chain to one of our lifted operators.\n            operator.call(subscriber, source)\n          : source\n          ? // If `source` has a value, but `operator` does not, something that\n            // had intimate knowledge of our API, like our `Subject`, must have\n            // set it. We're going to just call `_subscribe` directly.\n            this._subscribe(subscriber)\n          : // In all other cases, we're likely wrapping a user-provided initializer\n            // function, so we need to catch errors and handle them appropriately.\n            this._trySubscribe(subscriber)\n      );\n    });\n\n    return subscriber;\n  }\n\n  /** @internal */\n  protected _trySubscribe(sink: Subscriber<T>): TeardownLogic {\n    try {\n      return this._subscribe(sink);\n    } catch (err) {\n      // We don't need to return anything in this case,\n      // because it's just going to try to `add()` to a subscription\n      // above.\n      sink.error(err);\n    }\n  }\n\n  /**\n   * Used as a NON-CANCELLABLE means of subscribing to an observable, for use with\n   * APIs that expect promises, like `async/await`. You cannot unsubscribe from this.\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * #### Example\n   *\n   * ```ts\n   * import { interval, take } from 'rxjs';\n   *\n   * const source$ = interval(1000).pipe(take(4));\n   *\n   * async function getTotal() {\n   *   let total = 0;\n   *\n   *   await source$.forEach(value => {\n   *     total += value;\n   *     console.log('observable -> ' + value);\n   *   });\n   *\n   *   return total;\n   * }\n   *\n   * getTotal().then(\n   *   total => console.log('Total: ' + total)\n   * );\n   *\n   * // Expected:\n   * // 'observable -> 0'\n   * // 'observable -> 1'\n   * // 'observable -> 2'\n   * // 'observable -> 3'\n   * // 'Total: 6'\n   * ```\n   *\n   * @param next a handler for each value emitted by the observable\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   */\n  forEach(next: (value: T) => void): Promise<void>;\n\n  /**\n   * @param next a handler for each value emitted by the observable\n   * @param promiseCtor a constructor function used to instantiate the Promise\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   * @deprecated Passing a Promise constructor will no longer be available\n   * in upcoming versions of RxJS. This is because it adds weight to the library, for very\n   * little benefit. If you need this functionality, it is recommended that you either\n   * polyfill Promise, or you create an adapter to convert the returned native promise\n   * to whatever promise implementation you wanted. Will be removed in v8.\n   */\n  forEach(next: (value: T) => void, promiseCtor: PromiseConstructorLike): Promise<void>;\n\n  forEach(next: (value: T) => void, promiseCtor?: PromiseConstructorLike): Promise<void> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor<void>((resolve, reject) => {\n      const subscriber = new SafeSubscriber<T>({\n        next: (value) => {\n          try {\n            next(value);\n          } catch (err) {\n            reject(err);\n            subscriber.unsubscribe();\n          }\n        },\n        error: reject,\n        complete: resolve,\n      });\n      this.subscribe(subscriber);\n    }) as Promise<void>;\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<any>): TeardownLogic {\n    return this.source?.subscribe(subscriber);\n  }\n\n  /**\n   * An interop point defined by the es7-observable spec https://github.com/zenparsing/es-observable\n   * @method Symbol.observable\n   * @return {Observable} this instance of the observable\n   */\n  [Symbol_observable]() {\n    return this;\n  }\n\n  /* tslint:disable:max-line-length */\n  pipe(): Observable<T>;\n  pipe<A>(op1: OperatorFunction<T, A>): Observable<A>;\n  pipe<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): Observable<B>;\n  pipe<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): Observable<C>;\n  pipe<A, B, C, D>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>\n  ): Observable<D>;\n  pipe<A, B, C, D, E>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>\n  ): Observable<E>;\n  pipe<A, B, C, D, E, F>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>\n  ): Observable<F>;\n  pipe<A, B, C, D, E, F, G>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>\n  ): Observable<G>;\n  pipe<A, B, C, D, E, F, G, H>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>\n  ): Observable<H>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>\n  ): Observable<I>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>,\n    ...operations: OperatorFunction<any, any>[]\n  ): Observable<unknown>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Used to stitch together functional operators into a chain.\n   * @method pipe\n   * @return {Observable} the Observable result of all of the operators having\n   * been called in the order they were passed in.\n   *\n   * ## Example\n   *\n   * ```ts\n   * import { interval, filter, map, scan } from 'rxjs';\n   *\n   * interval(1000)\n   *   .pipe(\n   *     filter(x => x % 2 === 0),\n   *     map(x => x + x),\n   *     scan((acc, x) => acc + x)\n   *   )\n   *   .subscribe(x => console.log(x));\n   * ```\n   */\n  pipe(...operations: OperatorFunction<any, any>[]): Observable<any> {\n    return pipeFromArray(operations)(this);\n  }\n\n  /* tslint:disable:max-line-length */\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: typeof Promise): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: PromiseConstructorLike): Promise<T | undefined>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Subscribe to this Observable and get a Promise resolving on\n   * `complete` with the last emission (if any).\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * @method toPromise\n   * @param [promiseCtor] a constructor function used to instantiate\n   * the Promise\n   * @return A Promise that resolves with the last value emit, or\n   * rejects on an error. If there were no emissions, Promise\n   * resolves with undefined.\n   * @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise\n   */\n  toPromise(promiseCtor?: PromiseConstructorLike): Promise<T | undefined> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor((resolve, reject) => {\n      let value: T | undefined;\n      this.subscribe(\n        (x: T) => (value = x),\n        (err: any) => reject(err),\n        () => resolve(value)\n      );\n    }) as Promise<T | undefined>;\n  }\n}\n\n/**\n * Decides between a passed promise constructor from consuming code,\n * A default configured promise constructor, and the native promise\n * constructor and returns it. If nothing can be found, it will throw\n * an error.\n * @param promiseCtor The optional promise constructor to passed by consuming code\n */\nfunction getPromiseCtor(promiseCtor: PromiseConstructorLike | undefined) {\n  return promiseCtor ?? config.Promise ?? Promise;\n}\n\nfunction isObserver<T>(value: any): value is Observer<T> {\n  return value && isFunction(value.next) && isFunction(value.error) && isFunction(value.complete);\n}\n\nfunction isSubscriber<T>(value: any): value is Subscriber<T> {\n  return (value && value instanceof Subscriber) || (isObserver(value) && isSubscription(value));\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { OperatorFunction } from '../types';\nimport { isFunction } from './isFunction';\n\n/**\n * Used to determine if an object is an Observable with a lift function.\n */\nexport function hasLift(source: any): source is { lift: InstanceType<typeof Observable>['lift'] } {\n  return isFunction(source?.lift);\n}\n\n/**\n * Creates an `OperatorFunction`. Used to define operators throughout the library in a concise way.\n * @param init The logic to connect the liftedSource to the subscriber at the moment of subscription.\n */\nexport function operate<T, R>(\n  init: (liftedSource: Observable<T>, subscriber: Subscriber<R>) => (() => void) | void\n): OperatorFunction<T, R> {\n  return (source: Observable<T>) => {\n    if (hasLift(source)) {\n      return source.lift(function (this: Subscriber<R>, liftedSource: Observable<T>) {\n        try {\n          return init(liftedSource, this);\n        } catch (err) {\n          this.error(err);\n        }\n      });\n    }\n    throw new TypeError('Unable to lift unknown Observable type');\n  };\n}\n", "import { Subscriber } from '../Subscriber';\n\n/**\n * Creates an instance of an `OperatorSubscriber`.\n * @param destination The downstream subscriber.\n * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n * and send to the `destination` error handler.\n * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n * this handler are sent to the `destination` error handler.\n * @param onFinalize Additional teardown logic here. This will only be called on teardown if the\n * subscriber itself is not already closed. This is called after all other teardown logic is executed.\n */\nexport function createOperatorSubscriber<T>(\n  destination: Subscriber<any>,\n  onNext?: (value: T) => void,\n  onComplete?: () => void,\n  onError?: (err: any) => void,\n  onFinalize?: () => void\n): Subscriber<T> {\n  return new OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize);\n}\n\n/**\n * A generic helper for allowing operators to be created with a Subscriber and\n * use closures to capture necessary state from the operator function itself.\n */\nexport class OperatorSubscriber<T> extends Subscriber<T> {\n  /**\n   * Creates an instance of an `OperatorSubscriber`.\n   * @param destination The downstream subscriber.\n   * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n   * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n   * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n   * and send to the `destination` error handler.\n   * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n   * this handler are sent to the `destination` error handler.\n   * @param onFinalize Additional finalization logic here. This will only be called on finalization if the\n   * subscriber itself is not already closed. This is called after all other finalization logic is executed.\n   * @param shouldUnsubscribe An optional check to see if an unsubscribe call should truly unsubscribe.\n   * NOTE: This currently **ONLY** exists to support the strange behavior of {@link groupBy}, where unsubscription\n   * to the resulting observable does not actually disconnect from the source if there are active subscriptions\n   * to any grouped observable. (DO NOT EXPOSE OR USE EXTERNALLY!!!)\n   */\n  constructor(\n    destination: Subscriber<any>,\n    onNext?: (value: T) => void,\n    onComplete?: () => void,\n    onError?: (err: any) => void,\n    private onFinalize?: () => void,\n    private shouldUnsubscribe?: () => boolean\n  ) {\n    // It's important - for performance reasons - that all of this class's\n    // members are initialized and that they are always initialized in the same\n    // order. This will ensure that all OperatorSubscriber instances have the\n    // same hidden class in V8. This, in turn, will help keep the number of\n    // hidden classes involved in property accesses within the base class as\n    // low as possible. If the number of hidden classes involved exceeds four,\n    // the property accesses will become megamorphic and performance penalties\n    // will be incurred - i.e. inline caches won't be used.\n    //\n    // The reasons for ensuring all instances have the same hidden class are\n    // further discussed in this blog post from Benedikt Meurer:\n    // https://benediktmeurer.de/2018/03/23/impact-of-polymorphism-on-component-based-frameworks-like-react/\n    super(destination);\n    this._next = onNext\n      ? function (this: OperatorSubscriber<T>, value: T) {\n          try {\n            onNext(value);\n          } catch (err) {\n            destination.error(err);\n          }\n        }\n      : super._next;\n    this._error = onError\n      ? function (this: OperatorSubscriber<T>, err: any) {\n          try {\n            onError(err);\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._error;\n    this._complete = onComplete\n      ? function (this: OperatorSubscriber<T>) {\n          try {\n            onComplete();\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._complete;\n  }\n\n  unsubscribe() {\n    if (!this.shouldUnsubscribe || this.shouldUnsubscribe()) {\n      const { closed } = this;\n      super.unsubscribe();\n      // Execute additional teardown if we have any and we didn't already do so.\n      !closed && this.onFinalize?.();\n    }\n  }\n}\n", "import { Subscription } from '../Subscription';\n\ninterface AnimationFrameProvider {\n  schedule(callback: FrameRequestCallback): Subscription;\n  requestAnimationFrame: typeof requestAnimationFrame;\n  cancelAnimationFrame: typeof cancelAnimationFrame;\n  delegate:\n    | {\n        requestAnimationFrame: typeof requestAnimationFrame;\n        cancelAnimationFrame: typeof cancelAnimationFrame;\n      }\n    | undefined;\n}\n\nexport const animationFrameProvider: AnimationFrameProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  schedule(callback) {\n    let request = requestAnimationFrame;\n    let cancel: typeof cancelAnimationFrame | undefined = cancelAnimationFrame;\n    const { delegate } = animationFrameProvider;\n    if (delegate) {\n      request = delegate.requestAnimationFrame;\n      cancel = delegate.cancelAnimationFrame;\n    }\n    const handle = request((timestamp) => {\n      // Clear the cancel function. The request has been fulfilled, so\n      // attempting to cancel the request upon unsubscription would be\n      // pointless.\n      cancel = undefined;\n      callback(timestamp);\n    });\n    return new Subscription(() => cancel?.(handle));\n  },\n  requestAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.requestAnimationFrame || requestAnimationFrame)(...args);\n  },\n  cancelAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.cancelAnimationFrame || cancelAnimationFrame)(...args);\n  },\n  delegate: undefined,\n};\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface ObjectUnsubscribedError extends Error {}\n\nexport interface ObjectUnsubscribedErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): ObjectUnsubscribedError;\n}\n\n/**\n * An error thrown when an action is invalid because the object has been\n * unsubscribed.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n *\n * @class ObjectUnsubscribedError\n */\nexport const ObjectUnsubscribedError: ObjectUnsubscribedErrorCtor = createErrorClass(\n  (_super) =>\n    function ObjectUnsubscribedErrorImpl(this: any) {\n      _super(this);\n      this.name = 'ObjectUnsubscribedError';\n      this.message = 'object unsubscribed';\n    }\n);\n", "import { Operator } from './Operator';\nimport { Observable } from './Observable';\nimport { Subscriber } from './Subscriber';\nimport { Subscription, EMPTY_SUBSCRIPTION } from './Subscription';\nimport { Observer, SubscriptionLike, TeardownLogic } from './types';\nimport { ObjectUnsubscribedError } from './util/ObjectUnsubscribedError';\nimport { arrRemove } from './util/arrRemove';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A Subject is a special type of Observable that allows values to be\n * multicasted to many Observers. Subjects are like EventEmitters.\n *\n * Every Subject is an Observable and an Observer. You can subscribe to a\n * Subject, and you can call next to feed values as well as error and complete.\n */\nexport class Subject<T> extends Observable<T> implements SubscriptionLike {\n  closed = false;\n\n  private currentObservers: Observer<T>[] | null = null;\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  observers: Observer<T>[] = [];\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  isStopped = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  hasError = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  thrownError: any = null;\n\n  /**\n   * Creates a \"subject\" by basically gluing an observer to an observable.\n   *\n   * @nocollapse\n   * @deprecated Recommended you do not use. Will be removed at some point in the future. Plans for replacement still under discussion.\n   */\n  static create: (...args: any[]) => any = <T>(destination: Observer<T>, source: Observable<T>): AnonymousSubject<T> => {\n    return new AnonymousSubject<T>(destination, source);\n  };\n\n  constructor() {\n    // NOTE: This must be here to obscure Observable's constructor.\n    super();\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  lift<R>(operator: Operator<T, R>): Observable<R> {\n    const subject = new AnonymousSubject(this, this);\n    subject.operator = operator as any;\n    return subject as any;\n  }\n\n  /** @internal */\n  protected _throwIfClosed() {\n    if (this.closed) {\n      throw new ObjectUnsubscribedError();\n    }\n  }\n\n  next(value: T) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        if (!this.currentObservers) {\n          this.currentObservers = Array.from(this.observers);\n        }\n        for (const observer of this.currentObservers) {\n          observer.next(value);\n        }\n      }\n    });\n  }\n\n  error(err: any) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.hasError = this.isStopped = true;\n        this.thrownError = err;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.error(err);\n        }\n      }\n    });\n  }\n\n  complete() {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.isStopped = true;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.complete();\n        }\n      }\n    });\n  }\n\n  unsubscribe() {\n    this.isStopped = this.closed = true;\n    this.observers = this.currentObservers = null!;\n  }\n\n  get observed() {\n    return this.observers?.length > 0;\n  }\n\n  /** @internal */\n  protected _trySubscribe(subscriber: Subscriber<T>): TeardownLogic {\n    this._throwIfClosed();\n    return super._trySubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._checkFinalizedStatuses(subscriber);\n    return this._innerSubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _innerSubscribe(subscriber: Subscriber<any>) {\n    const { hasError, isStopped, observers } = this;\n    if (hasError || isStopped) {\n      return EMPTY_SUBSCRIPTION;\n    }\n    this.currentObservers = null;\n    observers.push(subscriber);\n    return new Subscription(() => {\n      this.currentObservers = null;\n      arrRemove(observers, subscriber);\n    });\n  }\n\n  /** @internal */\n  protected _checkFinalizedStatuses(subscriber: Subscriber<any>) {\n    const { hasError, thrownError, isStopped } = this;\n    if (hasError) {\n      subscriber.error(thrownError);\n    } else if (isStopped) {\n      subscriber.complete();\n    }\n  }\n\n  /**\n   * Creates a new Observable with this Subject as the source. You can do this\n   * to create custom Observer-side logic of the Subject and conceal it from\n   * code that uses the Observable.\n   * @return {Observable} Observable that the Subject casts to\n   */\n  asObservable(): Observable<T> {\n    const observable: any = new Observable<T>();\n    observable.source = this;\n    return observable;\n  }\n}\n\n/**\n * @class AnonymousSubject<T>\n */\nexport class AnonymousSubject<T> extends Subject<T> {\n  constructor(\n    /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n    public destination?: Observer<T>,\n    source?: Observable<T>\n  ) {\n    super();\n    this.source = source;\n  }\n\n  next(value: T) {\n    this.destination?.next?.(value);\n  }\n\n  error(err: any) {\n    this.destination?.error?.(err);\n  }\n\n  complete() {\n    this.destination?.complete?.();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    return this.source?.subscribe(subscriber) ?? EMPTY_SUBSCRIPTION;\n  }\n}\n", "import { TimestampProvider } from '../types';\n\ninterface DateTimestampProvider extends TimestampProvider {\n  delegate: TimestampProvider | undefined;\n}\n\nexport const dateTimestampProvider: DateTimestampProvider = {\n  now() {\n    // Use the variable rather than `this` so that the function can be called\n    // without being bound to the provider.\n    return (dateTimestampProvider.delegate || Date).now();\n  },\n  delegate: undefined,\n};\n", "import { Subject } from './Subject';\nimport { TimestampProvider } from './types';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * A variant of {@link Subject} that \"replays\" old values to new subscribers by emitting them when they first subscribe.\n *\n * `ReplaySubject` has an internal buffer that will store a specified number of values that it has observed. Like `Subject`,\n * `ReplaySubject` \"observes\" values by having them passed to its `next` method. When it observes a value, it will store that\n * value for a time determined by the configuration of the `ReplaySubject`, as passed to its constructor.\n *\n * When a new subscriber subscribes to the `ReplaySubject` instance, it will synchronously emit all values in its buffer in\n * a First-In-First-Out (FIFO) manner. The `ReplaySubject` will also complete, if it has observed completion; and it will\n * error if it has observed an error.\n *\n * There are two main configuration items to be concerned with:\n *\n * 1. `bufferSize` - This will determine how many items are stored in the buffer, defaults to infinite.\n * 2. `windowTime` - The amount of time to hold a value in the buffer before removing it from the buffer.\n *\n * Both configurations may exist simultaneously. So if you would like to buffer a maximum of 3 values, as long as the values\n * are less than 2 seconds old, you could do so with a `new ReplaySubject(3, 2000)`.\n *\n * ### Differences with BehaviorSubject\n *\n * `BehaviorSubject` is similar to `new ReplaySubject(1)`, with a couple of exceptions:\n *\n * 1. `BehaviorSubject` comes \"primed\" with a single value upon construction.\n * 2. `ReplaySubject` will replay values, even after observing an error, where `BehaviorSubject` will not.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n * @see {@link shareReplay}\n */\nexport class ReplaySubject<T> extends Subject<T> {\n  private _buffer: (T | number)[] = [];\n  private _infiniteTimeWindow = true;\n\n  /**\n   * @param bufferSize The size of the buffer to replay on subscription\n   * @param windowTime The amount of time the buffered items will stay buffered\n   * @param timestampProvider An object with a `now()` method that provides the current timestamp. This is used to\n   * calculate the amount of time something has been buffered.\n   */\n  constructor(\n    private _bufferSize = Infinity,\n    private _windowTime = Infinity,\n    private _timestampProvider: TimestampProvider = dateTimestampProvider\n  ) {\n    super();\n    this._infiniteTimeWindow = _windowTime === Infinity;\n    this._bufferSize = Math.max(1, _bufferSize);\n    this._windowTime = Math.max(1, _windowTime);\n  }\n\n  next(value: T): void {\n    const { isStopped, _buffer, _infiniteTimeWindow, _timestampProvider, _windowTime } = this;\n    if (!isStopped) {\n      _buffer.push(value);\n      !_infiniteTimeWindow && _buffer.push(_timestampProvider.now() + _windowTime);\n    }\n    this._trimBuffer();\n    super.next(value);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._trimBuffer();\n\n    const subscription = this._innerSubscribe(subscriber);\n\n    const { _infiniteTimeWindow, _buffer } = this;\n    // We use a copy here, so reentrant code does not mutate our array while we're\n    // emitting it to a new subscriber.\n    const copy = _buffer.slice();\n    for (let i = 0; i < copy.length && !subscriber.closed; i += _infiniteTimeWindow ? 1 : 2) {\n      subscriber.next(copy[i] as T);\n    }\n\n    this._checkFinalizedStatuses(subscriber);\n\n    return subscription;\n  }\n\n  private _trimBuffer() {\n    const { _bufferSize, _timestampProvider, _buffer, _infiniteTimeWindow } = this;\n    // If we don't have an infinite buffer size, and we're over the length,\n    // use splice to truncate the old buffer values off. Note that we have to\n    // double the size for instances where we're not using an infinite time window\n    // because we're storing the values and the timestamps in the same array.\n    const adjustedBufferSize = (_infiniteTimeWindow ? 1 : 2) * _bufferSize;\n    _bufferSize < Infinity && adjustedBufferSize < _buffer.length && _buffer.splice(0, _buffer.length - adjustedBufferSize);\n\n    // Now, if we're not in an infinite time window, remove all values where the time is\n    // older than what is allowed.\n    if (!_infiniteTimeWindow) {\n      const now = _timestampProvider.now();\n      let last = 0;\n      // Search the array for the first timestamp that isn't expired and\n      // truncate the buffer up to that point.\n      for (let i = 1; i < _buffer.length && (_buffer[i] as number) <= now; i += 2) {\n        last = i;\n      }\n      last && _buffer.splice(0, last + 1);\n    }\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Subscription } from '../Subscription';\nimport { SchedulerAction } from '../types';\n\n/**\n * A unit of work to be executed in a `scheduler`. An action is typically\n * created from within a {@link SchedulerLike} and an RxJS user does not need to concern\n * themselves about creating and manipulating an Action.\n *\n * ```ts\n * class Action<T> extends Subscription {\n *   new (scheduler: Scheduler, work: (state?: T) => void);\n *   schedule(state?: T, delay: number = 0): Subscription;\n * }\n * ```\n *\n * @class Action<T>\n */\nexport class Action<T> extends Subscription {\n  constructor(scheduler: Scheduler, work: (this: SchedulerAction<T>, state?: T) => void) {\n    super();\n  }\n  /**\n   * Schedules this action on its parent {@link SchedulerLike} for execution. May be passed\n   * some context object, `state`. May happen at some point in the future,\n   * according to the `delay` parameter, if specified.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler.\n   * @return {void}\n   */\n  public schedule(state?: T, delay: number = 0): Subscription {\n    return this;\n  }\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetIntervalFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearIntervalFunction = (handle: TimerHandle) => void;\n\ninterface IntervalProvider {\n  setInterval: SetIntervalFunction;\n  clearInterval: ClearIntervalFunction;\n  delegate:\n    | {\n        setInterval: SetIntervalFunction;\n        clearInterval: ClearIntervalFunction;\n      }\n    | undefined;\n}\n\nexport const intervalProvider: IntervalProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setInterval(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = intervalProvider;\n    if (delegate?.setInterval) {\n      return delegate.setInterval(handler, timeout, ...args);\n    }\n    return setInterval(handler, timeout, ...args);\n  },\n  clearInterval(handle) {\n    const { delegate } = intervalProvider;\n    return (delegate?.clearInterval || clearInterval)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { Action } from './Action';\nimport { SchedulerAction } from '../types';\nimport { Subscription } from '../Subscription';\nimport { AsyncScheduler } from './AsyncScheduler';\nimport { intervalProvider } from './intervalProvider';\nimport { arrRemove } from '../util/arrRemove';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncAction<T> extends Action<T> {\n  public id: TimerHandle | undefined;\n  public state?: T;\n  // @ts-ignore: Property has no initializer and is not definitely assigned\n  public delay: number;\n  protected pending: boolean = false;\n\n  constructor(protected scheduler: AsyncScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (this.closed) {\n      return this;\n    }\n\n    // Always replace the current state with the new state.\n    this.state = state;\n\n    const id = this.id;\n    const scheduler = this.scheduler;\n\n    //\n    // Important implementation note:\n    //\n    // Actions only execute once by default, unless rescheduled from within the\n    // scheduled callback. This allows us to implement single and repeat\n    // actions via the same code path, without adding API surface area, as well\n    // as mimic traditional recursion but across asynchronous boundaries.\n    //\n    // However, JS runtimes and timers distinguish between intervals achieved by\n    // serial `setTimeout` calls vs. a single `setInterval` call. An interval of\n    // serial `setTimeout` calls can be individually delayed, which delays\n    // scheduling the next `setTimeout`, and so on. `setInterval` attempts to\n    // guarantee the interval callback will be invoked more precisely to the\n    // interval period, regardless of load.\n    //\n    // Therefore, we use `setInterval` to schedule single and repeat actions.\n    // If the action reschedules itself with the same delay, the interval is not\n    // canceled. If the action doesn't reschedule, or reschedules with a\n    // different delay, the interval will be canceled after scheduled callback\n    // execution.\n    //\n    if (id != null) {\n      this.id = this.recycleAsyncId(scheduler, id, delay);\n    }\n\n    // Set the pending flag indicating that this action has been scheduled, or\n    // has recursively rescheduled itself.\n    this.pending = true;\n\n    this.delay = delay;\n    // If this action has already an async Id, don't request a new one.\n    this.id = this.id ?? this.requestAsyncId(scheduler, this.id, delay);\n\n    return this;\n  }\n\n  protected requestAsyncId(scheduler: AsyncScheduler, _id?: TimerHandle, delay: number = 0): TimerHandle {\n    return intervalProvider.setInterval(scheduler.flush.bind(scheduler, this), delay);\n  }\n\n  protected recycleAsyncId(_scheduler: AsyncScheduler, id?: TimerHandle, delay: number | null = 0): TimerHandle | undefined {\n    // If this action is rescheduled with the same delay time, don't clear the interval id.\n    if (delay != null && this.delay === delay && this.pending === false) {\n      return id;\n    }\n    // Otherwise, if the action's delay time is different from the current delay,\n    // or the action has been rescheduled before it's executed, clear the interval id\n    if (id != null) {\n      intervalProvider.clearInterval(id);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Immediately executes this action and the `work` it contains.\n   * @return {any}\n   */\n  public execute(state: T, delay: number): any {\n    if (this.closed) {\n      return new Error('executing a cancelled action');\n    }\n\n    this.pending = false;\n    const error = this._execute(state, delay);\n    if (error) {\n      return error;\n    } else if (this.pending === false && this.id != null) {\n      // Dequeue if the action didn't reschedule itself. Don't call\n      // unsubscribe(), because the action could reschedule later.\n      // For example:\n      // ```\n      // scheduler.schedule(function doWork(counter) {\n      //   /* ... I'm a busy worker bee ... */\n      //   var originalAction = this;\n      //   /* wait 100ms before rescheduling the action */\n      //   setTimeout(function () {\n      //     originalAction.schedule(counter + 1);\n      //   }, 100);\n      // }, 1000);\n      // ```\n      this.id = this.recycleAsyncId(this.scheduler, this.id, null);\n    }\n  }\n\n  protected _execute(state: T, _delay: number): any {\n    let errored: boolean = false;\n    let errorValue: any;\n    try {\n      this.work(state);\n    } catch (e) {\n      errored = true;\n      // HACK: Since code elsewhere is relying on the \"truthiness\" of the\n      // return here, we can't have it return \"\" or 0 or false.\n      // TODO: Clean this up when we refactor schedulers mid-version-8 or so.\n      errorValue = e ? e : new Error('Scheduled action threw falsy error');\n    }\n    if (errored) {\n      this.unsubscribe();\n      return errorValue;\n    }\n  }\n\n  unsubscribe() {\n    if (!this.closed) {\n      const { id, scheduler } = this;\n      const { actions } = scheduler;\n\n      this.work = this.state = this.scheduler = null!;\n      this.pending = false;\n\n      arrRemove(actions, this);\n      if (id != null) {\n        this.id = this.recycleAsyncId(scheduler, id, null);\n      }\n\n      this.delay = null!;\n      super.unsubscribe();\n    }\n  }\n}\n", "import { Action } from './scheduler/Action';\nimport { Subscription } from './Subscription';\nimport { SchedulerLike, SchedulerAction } from './types';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * An execution context and a data structure to order tasks and schedule their\n * execution. Provides a notion of (potentially virtual) time, through the\n * `now()` getter method.\n *\n * Each unit of work in a Scheduler is called an `Action`.\n *\n * ```ts\n * class Scheduler {\n *   now(): number;\n *   schedule(work, delay?, state?): Subscription;\n * }\n * ```\n *\n * @class Scheduler\n * @deprecated Scheduler is an internal implementation detail of RxJS, and\n * should not be used directly. Rather, create your own class and implement\n * {@link SchedulerLike}. Will be made internal in v8.\n */\nexport class Scheduler implements SchedulerLike {\n  public static now: () => number = dateTimestampProvider.now;\n\n  constructor(private schedulerActionCtor: typeof Action, now: () => number = Scheduler.now) {\n    this.now = now;\n  }\n\n  /**\n   * A getter method that returns a number representing the current time\n   * (at the time this function was called) according to the scheduler's own\n   * internal clock.\n   * @return {number} A number that represents the current time. May or may not\n   * have a relation to wall-clock time. May or may not refer to a time unit\n   * (e.g. milliseconds).\n   */\n  public now: () => number;\n\n  /**\n   * Schedules a function, `work`, for execution. May happen at some point in\n   * the future, according to the `delay` parameter, if specified. May be passed\n   * some context object, `state`, which will be passed to the `work` function.\n   *\n   * The given arguments will be processed an stored as an Action object in a\n   * queue of actions.\n   *\n   * @param {function(state: ?T): ?Subscription} work A function representing a\n   * task, or some unit of work to be executed by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler itself.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @return {Subscription} A subscription in order to be able to unsubscribe\n   * the scheduled work.\n   */\n  public schedule<T>(work: (this: SchedulerAction<T>, state?: T) => void, delay: number = 0, state?: T): Subscription {\n    return new this.schedulerActionCtor<T>(this, work).schedule(state, delay);\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Action } from './Action';\nimport { AsyncAction } from './AsyncAction';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncScheduler extends Scheduler {\n  public actions: Array<AsyncAction<any>> = [];\n  /**\n   * A flag to indicate whether the Scheduler is currently executing a batch of\n   * queued actions.\n   * @type {boolean}\n   * @internal\n   */\n  public _active: boolean = false;\n  /**\n   * An internal ID used to track the latest asynchronous task such as those\n   * coming from `setTimeout`, `setInterval`, `requestAnimationFrame`, and\n   * others.\n   * @type {any}\n   * @internal\n   */\n  public _scheduled: TimerHandle | undefined;\n\n  constructor(SchedulerAction: typeof Action, now: () => number = Scheduler.now) {\n    super(SchedulerAction, now);\n  }\n\n  public flush(action: AsyncAction<any>): void {\n    const { actions } = this;\n\n    if (this._active) {\n      actions.push(action);\n      return;\n    }\n\n    let error: any;\n    this._active = true;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions.shift()!)); // exhaust the scheduler queue\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions.shift()!)) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\n/**\n *\n * Async Scheduler\n *\n * <span class=\"informal\">Schedule task as if you used setTimeout(task, duration)</span>\n *\n * `async` scheduler schedules tasks asynchronously, by putting them on the JavaScript\n * event loop queue. It is best used to delay tasks in time or to schedule tasks repeating\n * in intervals.\n *\n * If you just want to \"defer\" task, that is to perform it right after currently\n * executing synchronous code ends (commonly achieved by `setTimeout(deferredTask, 0)`),\n * better choice will be the {@link asapScheduler} scheduler.\n *\n * ## Examples\n * Use async scheduler to delay task\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * const task = () => console.log('it works!');\n *\n * asyncScheduler.schedule(task, 2000);\n *\n * // After 2 seconds logs:\n * // \"it works!\"\n * ```\n *\n * Use async scheduler to repeat task in intervals\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * function task(state) {\n *   console.log(state);\n *   this.schedule(state + 1, 1000); // `this` references currently executing Action,\n *                                   // which we reschedule with new state and delay\n * }\n *\n * asyncScheduler.schedule(task, 3000, 0);\n *\n * // Logs:\n * // 0 after 3s\n * // 1 after 4s\n * // 2 after 5s\n * // 3 after 6s\n * ```\n */\n\nexport const asyncScheduler = new AsyncScheduler(AsyncAction);\n\n/**\n * @deprecated Renamed to {@link asyncScheduler}. Will be removed in v8.\n */\nexport const async = asyncScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\nimport { SchedulerAction } from '../types';\nimport { animationFrameProvider } from './animationFrameProvider';\nimport { TimerHandle } from './timerHandle';\n\nexport class AnimationFrameAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: AnimationFrameScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  protected requestAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay is greater than 0, request as an async action.\n    if (delay !== null && delay > 0) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n    // Push the action to the end of the scheduler queue.\n    scheduler.actions.push(this);\n    // If an animation frame has already been requested, don't request another\n    // one. If an animation frame hasn't been requested yet, request one. Return\n    // the current animation frame request id.\n    return scheduler._scheduled || (scheduler._scheduled = animationFrameProvider.requestAnimationFrame(() => scheduler.flush(undefined)));\n  }\n\n  protected recycleAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle | undefined {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n    if (delay != null ? delay > 0 : this.delay > 0) {\n      return super.recycleAsyncId(scheduler, id, delay);\n    }\n    // If the scheduler queue has no remaining actions with the same async id,\n    // cancel the requested animation frame and set the scheduled flag to\n    // undefined so the next AnimationFrameAction will request its own.\n    const { actions } = scheduler;\n    if (id != null && actions[actions.length - 1]?.id !== id) {\n      animationFrameProvider.cancelAnimationFrame(id as number);\n      scheduler._scheduled = undefined;\n    }\n    // Return undefined so the action knows to request a new async id if it's rescheduled.\n    return undefined;\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\nexport class AnimationFrameScheduler extends AsyncScheduler {\n  public flush(action?: AsyncAction<any>): void {\n    this._active = true;\n    // The async id that effects a call to flush is stored in _scheduled.\n    // Before executing an action, it's necessary to check the action's async\n    // id to determine whether it's supposed to be executed in the current\n    // flush.\n    // Previous implementations of this method used a count to determine this,\n    // but that was unsound, as actions that are unsubscribed - i.e. cancelled -\n    // are removed from the actions array and that can shift actions that are\n    // scheduled to be executed in a subsequent flush into positions at which\n    // they are executed within the current flush.\n    const flushId = this._scheduled;\n    this._scheduled = undefined;\n\n    const { actions } = this;\n    let error: any;\n    action = action || actions.shift()!;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions[0]) && action.id === flushId && actions.shift());\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions[0]) && action.id === flushId && actions.shift()) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AnimationFrameAction } from './AnimationFrameAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\n\n/**\n *\n * Animation Frame Scheduler\n *\n * <span class=\"informal\">Perform task when `window.requestAnimationFrame` would fire</span>\n *\n * When `animationFrame` scheduler is used with delay, it will fall back to {@link asyncScheduler} scheduler\n * behaviour.\n *\n * Without delay, `animationFrame` scheduler can be used to create smooth browser animations.\n * It makes sure scheduled task will happen just before next browser content repaint,\n * thus performing animations as efficiently as possible.\n *\n * ## Example\n * Schedule div height animation\n * ```ts\n * // html: <div style=\"background: #0ff;\"></div>\n * import { animationFrameScheduler } from 'rxjs';\n *\n * const div = document.querySelector('div');\n *\n * animationFrameScheduler.schedule(function(height) {\n *   div.style.height = height + \"px\";\n *\n *   this.schedule(height + 1);  // `this` references currently executing Action,\n *                               // which we reschedule with new state\n * }, 0, 0);\n *\n * // You will see a div element growing in height\n * ```\n */\n\nexport const animationFrameScheduler = new AnimationFrameScheduler(AnimationFrameAction);\n\n/**\n * @deprecated Renamed to {@link animationFrameScheduler}. Will be removed in v8.\n */\nexport const animationFrame = animationFrameScheduler;\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\n/**\n * A simple Observable that emits no items to the Observer and immediately\n * emits a complete notification.\n *\n * <span class=\"informal\">Just emits 'complete', and nothing else.</span>\n *\n * ![](empty.png)\n *\n * A simple Observable that only emits the complete notification. It can be used\n * for composing with other Observables, such as in a {@link mergeMap}.\n *\n * ## Examples\n *\n * Log complete notification\n *\n * ```ts\n * import { EMPTY } from 'rxjs';\n *\n * EMPTY.subscribe({\n *   next: () => console.log('Next'),\n *   complete: () => console.log('Complete!')\n * });\n *\n * // Outputs\n * // Complete!\n * ```\n *\n * Emit the number 7, then complete\n *\n * ```ts\n * import { EMPTY, startWith } from 'rxjs';\n *\n * const result = EMPTY.pipe(startWith(7));\n * result.subscribe(x => console.log(x));\n *\n * // Outputs\n * // 7\n * ```\n *\n * Map and flatten only odd numbers to the sequence `'a'`, `'b'`, `'c'`\n *\n * ```ts\n * import { interval, mergeMap, of, EMPTY } from 'rxjs';\n *\n * const interval$ = interval(1000);\n * const result = interval$.pipe(\n *   mergeMap(x => x % 2 === 1 ? of('a', 'b', 'c') : EMPTY),\n * );\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following to the console:\n * // x is equal to the count on the interval, e.g. (0, 1, 2, 3, ...)\n * // x will occur every 1000ms\n * // if x % 2 is equal to 1, print a, b, c (each on its own)\n * // if x % 2 is not equal to 1, nothing will be output\n * ```\n *\n * @see {@link Observable}\n * @see {@link NEVER}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const EMPTY = new Observable<never>((subscriber) => subscriber.complete());\n\n/**\n * @param scheduler A {@link SchedulerLike} to use for scheduling\n * the emission of the complete notification.\n * @deprecated Replaced with the {@link EMPTY} constant or {@link scheduled} (e.g. `scheduled([], scheduler)`). Will be removed in v8.\n */\nexport function empty(scheduler?: SchedulerLike) {\n  return scheduler ? emptyScheduled(scheduler) : EMPTY;\n}\n\nfunction emptyScheduled(scheduler: SchedulerLike) {\n  return new Observable<never>((subscriber) => scheduler.schedule(() => subscriber.complete()));\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport function isScheduler(value: any): value is SchedulerLike {\n  return value && isFunction(value.schedule);\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\nimport { isScheduler } from './isScheduler';\n\nfunction last<T>(arr: T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n\nexport function popResultSelector(args: any[]): ((...args: unknown[]) => unknown) | undefined {\n  return isFunction(last(args)) ? args.pop() : undefined;\n}\n\nexport function popScheduler(args: any[]): SchedulerLike | undefined {\n  return isScheduler(last(args)) ? args.pop() : undefined;\n}\n\nexport function popNumber(args: any[], defaultValue: number): number {\n  return typeof last(args) === 'number' ? args.pop()! : defaultValue;\n}\n", "export const isArrayLike = (<T>(x: any): x is ArrayLike<T> => x && typeof x.length === 'number' && typeof x !== 'function');", "import { isFunction } from \"./isFunction\";\n\n/**\n * Tests to see if the object is \"thennable\".\n * @param value the object to test\n */\nexport function isPromise(value: any): value is PromiseLike<any> {\n  return isFunction(value?.then);\n}\n", "import { InteropObservable } from '../types';\nimport { observable as Symbol_observable } from '../symbol/observable';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being Observable (but not necessary an Rx Observable) */\nexport function isInteropObservable(input: any): input is InteropObservable<any> {\n  return isFunction(input[Symbol_observable]);\n}\n", "import { isFunction } from './isFunction';\n\nexport function isAsyncIterable<T>(obj: any): obj is AsyncIterable<T> {\n  return Symbol.asyncIterator && isFunction(obj?.[Symbol.asyncIterator]);\n}\n", "/**\n * Creates the TypeError to throw if an invalid object is passed to `from` or `scheduled`.\n * @param input The object that was passed.\n */\nexport function createInvalidObservableTypeError(input: any) {\n  // TODO: We should create error codes that can be looked up, so this can be less verbose.\n  return new TypeError(\n    `You provided ${\n      input !== null && typeof input === 'object' ? 'an invalid object' : `'${input}'`\n    } where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.`\n  );\n}\n", "export function getSymbolIterator(): symbol {\n  if (typeof Symbol !== 'function' || !Symbol.iterator) {\n    return '@@iterator' as any;\n  }\n\n  return Symbol.iterator;\n}\n\nexport const iterator = getSymbolIterator();\n", "import { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being an Iterable */\nexport function isIterable(input: any): input is Iterable<any> {\n  return isFunction(input?.[Symbol_iterator]);\n}\n", "import { ReadableStreamLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport async function* readableStreamLikeToAsyncGenerator<T>(readableStream: ReadableStreamLike<T>): AsyncGenerator<T> {\n  const reader = readableStream.getReader();\n  try {\n    while (true) {\n      const { value, done } = await reader.read();\n      if (done) {\n        return;\n      }\n      yield value!;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nexport function isReadableStreamLike<T>(obj: any): obj is ReadableStreamLike<T> {\n  // We don't want to use instanceof checks because they would return\n  // false for instances from another Realm, like an <iframe>.\n  return isFunction(obj?.getReader);\n}\n", "import { isArrayLike } from '../util/isArrayLike';\nimport { isPromise } from '../util/isPromise';\nimport { Observable } from '../Observable';\nimport { ObservableInput, ObservedValueOf, ReadableStreamLike } from '../types';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isIterable } from '../util/isIterable';\nimport { isReadableStreamLike, readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\nimport { Subscriber } from '../Subscriber';\nimport { isFunction } from '../util/isFunction';\nimport { reportUnhandledError } from '../util/reportUnhandledError';\nimport { observable as Symbol_observable } from '../symbol/observable';\n\nexport function innerFrom<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\nexport function innerFrom<T>(input: ObservableInput<T>): Observable<T> {\n  if (input instanceof Observable) {\n    return input;\n  }\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return fromInteropObservable(input);\n    }\n    if (isArrayLike(input)) {\n      return fromArrayLike(input);\n    }\n    if (isPromise(input)) {\n      return fromPromise(input);\n    }\n    if (isAsyncIterable(input)) {\n      return fromAsyncIterable(input);\n    }\n    if (isIterable(input)) {\n      return fromIterable(input);\n    }\n    if (isReadableStreamLike(input)) {\n      return fromReadableStreamLike(input);\n    }\n  }\n\n  throw createInvalidObservableTypeError(input);\n}\n\n/**\n * Creates an RxJS Observable from an object that implements `Symbol.observable`.\n * @param obj An object that properly implements `Symbol.observable`.\n */\nexport function fromInteropObservable<T>(obj: any) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    const obs = obj[Symbol_observable]();\n    if (isFunction(obs.subscribe)) {\n      return obs.subscribe(subscriber);\n    }\n    // Should be caught by observable subscribe function error handling.\n    throw new TypeError('Provided object does not correctly implement Symbol.observable');\n  });\n}\n\n/**\n * Synchronously emits the values of an array like and completes.\n * This is exported because there are creation functions and operators that need to\n * make direct use of the same logic, and there's no reason to make them run through\n * `from` conditionals because we *know* they're dealing with an array.\n * @param array The array to emit values from\n */\nexport function fromArrayLike<T>(array: ArrayLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    // Loop over the array and emit each value. Note two things here:\n    // 1. We're making sure that the subscriber is not closed on each loop.\n    //    This is so we don't continue looping over a very large array after\n    //    something like a `take`, `takeWhile`, or other synchronous unsubscription\n    //    has already unsubscribed.\n    // 2. In this form, reentrant code can alter that array we're looping over.\n    //    This is a known issue, but considered an edge case. The alternative would\n    //    be to copy the array before executing the loop, but this has\n    //    performance implications.\n    for (let i = 0; i < array.length && !subscriber.closed; i++) {\n      subscriber.next(array[i]);\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromPromise<T>(promise: PromiseLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    promise\n      .then(\n        (value) => {\n          if (!subscriber.closed) {\n            subscriber.next(value);\n            subscriber.complete();\n          }\n        },\n        (err: any) => subscriber.error(err)\n      )\n      .then(null, reportUnhandledError);\n  });\n}\n\nexport function fromIterable<T>(iterable: Iterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    for (const value of iterable) {\n      subscriber.next(value);\n      if (subscriber.closed) {\n        return;\n      }\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromAsyncIterable<T>(asyncIterable: AsyncIterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    process(asyncIterable, subscriber).catch((err) => subscriber.error(err));\n  });\n}\n\nexport function fromReadableStreamLike<T>(readableStream: ReadableStreamLike<T>) {\n  return fromAsyncIterable(readableStreamLikeToAsyncGenerator(readableStream));\n}\n\nasync function process<T>(asyncIterable: AsyncIterable<T>, subscriber: Subscriber<T>) {\n  for await (const value of asyncIterable) {\n    subscriber.next(value);\n    // A side-effect may have closed our subscriber,\n    // check before the next iteration.\n    if (subscriber.closed) {\n      return;\n    }\n  }\n  subscriber.complete();\n}\n", "import { Subscription } from '../Subscription';\nimport { SchedulerAction, SchedulerLike } from '../types';\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay: number,\n  repeat: true\n): void;\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay?: number,\n  repeat?: false\n): Subscription;\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay = 0,\n  repeat = false\n): Subscription | void {\n  const scheduleSubscription = scheduler.schedule(function (this: SchedulerAction<any>) {\n    work();\n    if (repeat) {\n      parentSubscription.add(this.schedule(null, delay));\n    } else {\n      this.unsubscribe();\n    }\n  }, delay);\n\n  parentSubscription.add(scheduleSubscription);\n\n  if (!repeat) {\n    // Because user-land scheduler implementations are unlikely to properly reuse\n    // Actions for repeat scheduling, we can't trust that the returned subscription\n    // will control repeat subscription scenarios. So we're trying to avoid using them\n    // incorrectly within this library.\n    return scheduleSubscription;\n  }\n}\n", "/** @prettier */\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Re-emits all notifications from source Observable with specified scheduler.\n *\n * <span class=\"informal\">Ensure a specific scheduler is used, from outside of an Observable.</span>\n *\n * `observeOn` is an operator that accepts a scheduler as a first parameter, which will be used to reschedule\n * notifications emitted by the source Observable. It might be useful, if you do not have control over\n * internal scheduler of a given Observable, but want to control when its values are emitted nevertheless.\n *\n * Returned Observable emits the same notifications (nexted values, complete and error events) as the source Observable,\n * but rescheduled with provided scheduler. Note that this doesn't mean that source Observables internal\n * scheduler will be replaced in any way. Original scheduler still will be used, but when the source Observable emits\n * notification, it will be immediately scheduled again - this time with scheduler passed to `observeOn`.\n * An anti-pattern would be calling `observeOn` on Observable that emits lots of values synchronously, to split\n * that emissions into asynchronous chunks. For this to happen, scheduler would have to be passed into the source\n * Observable directly (usually into the operator that creates it). `observeOn` simply delays notifications a\n * little bit more, to ensure that they are emitted at expected moments.\n *\n * As a matter of fact, `observeOn` accepts second parameter, which specifies in milliseconds with what delay notifications\n * will be emitted. The main difference between {@link delay} operator and `observeOn` is that `observeOn`\n * will delay all notifications - including error notifications - while `delay` will pass through error\n * from source Observable immediately when it is emitted. In general it is highly recommended to use `delay` operator\n * for any kind of delaying of values in the stream, while using `observeOn` to specify which scheduler should be used\n * for notification emissions in general.\n *\n * ## Example\n *\n * Ensure values in subscribe are called just before browser repaint\n *\n * ```ts\n * import { interval, observeOn, animationFrameScheduler } from 'rxjs';\n *\n * const someDiv = document.createElement('div');\n * someDiv.style.cssText = 'width: 200px;background: #09c';\n * document.body.appendChild(someDiv);\n * const intervals = interval(10);      // Intervals are scheduled\n *                                      // with async scheduler by default...\n * intervals.pipe(\n *   observeOn(animationFrameScheduler) // ...but we will observe on animationFrame\n * )                                    // scheduler to ensure smooth animation.\n * .subscribe(val => {\n *   someDiv.style.height = val + 'px';\n * });\n * ```\n *\n * @see {@link delay}\n *\n * @param scheduler Scheduler that will be used to reschedule notifications from source Observable.\n * @param delay Number of milliseconds that states with what delay every notification should be rescheduled.\n * @return A function that returns an Observable that emits the same\n * notifications as the source Observable, but with provided scheduler.\n */\nexport function observeOn<T>(scheduler: SchedulerLike, delay = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => executeSchedule(subscriber, scheduler, () => subscriber.next(value), delay),\n        () => executeSchedule(subscriber, scheduler, () => subscriber.complete(), delay),\n        (err) => executeSchedule(subscriber, scheduler, () => subscriber.error(err), delay)\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Asynchronously subscribes Observers to this Observable on the specified {@link SchedulerLike}.\n *\n * With `subscribeOn` you can decide what type of scheduler a specific Observable will be using when it is subscribed to.\n *\n * Schedulers control the speed and order of emissions to observers from an Observable stream.\n *\n * ![](subscribeOn.png)\n *\n * ## Example\n *\n * Given the following code:\n *\n * ```ts\n * import { of, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3);\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 1\n * // 2\n * // 3\n * // 4\n * // 5\n * // 6\n * ```\n *\n * Both Observable `a` and `b` will emit their values directly and synchronously once they are subscribed to.\n *\n * If we instead use the `subscribeOn` operator declaring that we want to use the {@link asyncScheduler} for values emitted by Observable `a`:\n *\n * ```ts\n * import { of, subscribeOn, asyncScheduler, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3).pipe(subscribeOn(asyncScheduler));\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 4\n * // 5\n * // 6\n * // 1\n * // 2\n * // 3\n * ```\n *\n * The reason for this is that Observable `b` emits its values directly and synchronously like before\n * but the emissions from `a` are scheduled on the event loop because we are now using the {@link asyncScheduler} for that specific Observable.\n *\n * @param scheduler The {@link SchedulerLike} to perform subscription actions on.\n * @param delay A delay to pass to the scheduler to delay subscriptions\n * @return A function that returns an Observable modified so that its\n * subscriptions happen on the specified {@link SchedulerLike}.\n */\nexport function subscribeOn<T>(scheduler: SchedulerLike, delay: number = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    subscriber.add(scheduler.schedule(() => source.subscribe(subscriber), delay));\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { InteropObservable, SchedulerLike } from '../types';\n\nexport function scheduleObservable<T>(input: InteropObservable<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { SchedulerLike } from '../types';\n\nexport function schedulePromise<T>(input: PromiseLike<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\nexport function scheduleArray<T>(input: ArrayLike<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    // The current array index.\n    let i = 0;\n    // Start iterating over the array like on a schedule.\n    return scheduler.schedule(function () {\n      if (i === input.length) {\n        // If we have hit the end of the array like in the\n        // previous job, we can complete.\n        subscriber.complete();\n      } else {\n        // Otherwise let's next the value at the current index,\n        // then increment our index.\n        subscriber.next(input[i++]);\n        // If the last emission didn't cause us to close the subscriber\n        // (via take or some side effect), reschedule the job and we'll\n        // make another pass.\n        if (!subscriber.closed) {\n          this.schedule();\n        }\n      }\n    });\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from '../util/isFunction';\nimport { executeSchedule } from '../util/executeSchedule';\n\n/**\n * Used in {@link scheduled} to create an observable from an Iterable.\n * @param input The iterable to create an observable from\n * @param scheduler The scheduler to use\n */\nexport function scheduleIterable<T>(input: Iterable<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    let iterator: Iterator<T, T>;\n\n    // Schedule the initial creation of the iterator from\n    // the iterable. This is so the code in the iterable is\n    // not called until the scheduled job fires.\n    executeSchedule(subscriber, scheduler, () => {\n      // Create the iterator.\n      iterator = (input as any)[Symbol_iterator]();\n\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          let value: T;\n          let done: boolean | undefined;\n          try {\n            // Pull the value out of the iterator\n            ({ value, done } = iterator.next());\n          } catch (err) {\n            // We got an error while pulling from the iterator\n            subscriber.error(err);\n            return;\n          }\n\n          if (done) {\n            // If it is \"done\" we just complete. This mimics the\n            // behavior of JavaScript's `for..of` consumption of\n            // iterables, which will not emit the value from an iterator\n            // result of `{ done: true: value: 'here' }`.\n            subscriber.complete();\n          } else {\n            // The iterable is not done, emit the value.\n            subscriber.next(value);\n          }\n        },\n        0,\n        true\n      );\n    });\n\n    // During finalization, if we see this iterator has a `return` method,\n    // then we know it is a Generator, and not just an Iterator. So we call\n    // the `return()` function. This will ensure that any `finally { }` blocks\n    // inside of the generator we can hit will be hit properly.\n    return () => isFunction(iterator?.return) && iterator.return();\n  });\n}\n", "import { SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { executeSchedule } from '../util/executeSchedule';\n\nexport function scheduleAsyncIterable<T>(input: AsyncIterable<T>, scheduler: SchedulerLike) {\n  if (!input) {\n    throw new Error('Iterable cannot be null');\n  }\n  return new Observable<T>((subscriber) => {\n    executeSchedule(subscriber, scheduler, () => {\n      const iterator = input[Symbol.asyncIterator]();\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          iterator.next().then((result) => {\n            if (result.done) {\n              // This will remove the subscriptions from\n              // the parent subscription.\n              subscriber.complete();\n            } else {\n              subscriber.next(result.value);\n            }\n          });\n        },\n        0,\n        true\n      );\n    });\n  });\n}\n", "import { SchedulerLike, ReadableStreamLike } from '../types';\nimport { Observable } from '../Observable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\n\nexport function scheduleReadableStreamLike<T>(input: ReadableStreamLike<T>, scheduler: SchedulerLike): Observable<T> {\n  return scheduleAsyncIterable(readableStreamLikeToAsyncGenerator(input), scheduler);\n}\n", "import { scheduleObservable } from './scheduleObservable';\nimport { schedulePromise } from './schedulePromise';\nimport { scheduleArray } from './scheduleArray';\nimport { scheduleIterable } from './scheduleIterable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isPromise } from '../util/isPromise';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isIterable } from '../util/isIterable';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isReadableStreamLike } from '../util/isReadableStreamLike';\nimport { scheduleReadableStreamLike } from './scheduleReadableStreamLike';\n\n/**\n * Converts from a common {@link ObservableInput} type to an observable where subscription and emissions\n * are scheduled on the provided scheduler.\n *\n * @see {@link from}\n * @see {@link of}\n *\n * @param input The observable, array, promise, iterable, etc you would like to schedule\n * @param scheduler The scheduler to use to schedule the subscription and emissions from\n * the returned observable.\n */\nexport function scheduled<T>(input: ObservableInput<T>, scheduler: SchedulerLike): Observable<T> {\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return scheduleObservable(input, scheduler);\n    }\n    if (isArrayLike(input)) {\n      return scheduleArray(input, scheduler);\n    }\n    if (isPromise(input)) {\n      return schedulePromise(input, scheduler);\n    }\n    if (isAsyncIterable(input)) {\n      return scheduleAsyncIterable(input, scheduler);\n    }\n    if (isIterable(input)) {\n      return scheduleIterable(input, scheduler);\n    }\n    if (isReadableStreamLike(input)) {\n      return scheduleReadableStreamLike(input, scheduler);\n    }\n  }\n  throw createInvalidObservableTypeError(input);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf } from '../types';\nimport { scheduled } from '../scheduled/scheduled';\nimport { innerFrom } from './innerFrom';\n\nexport function from<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function from<O extends ObservableInput<any>>(input: O, scheduler: SchedulerLike | undefined): Observable<ObservedValueOf<O>>;\n\n/**\n * Creates an Observable from an Array, an array-like object, a Promise, an iterable object, or an Observable-like object.\n *\n * <span class=\"informal\">Converts almost anything to an Observable.</span>\n *\n * ![](from.png)\n *\n * `from` converts various other objects and data types into Observables. It also converts a Promise, an array-like, or an\n * <a href=\"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#iterable\" target=\"_blank\">iterable</a>\n * object into an Observable that emits the items in that promise, array, or iterable. A String, in this context, is treated\n * as an array of characters. Observable-like objects (contains a function named with the ES2015 Symbol for Observable) can also be\n * converted through this operator.\n *\n * ## Examples\n *\n * Converts an array to an Observable\n *\n * ```ts\n * import { from } from 'rxjs';\n *\n * const array = [10, 20, 30];\n * const result = from(array);\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 10\n * // 20\n * // 30\n * ```\n *\n * Convert an infinite iterable (from a generator) to an Observable\n *\n * ```ts\n * import { from, take } from 'rxjs';\n *\n * function* generateDoubles(seed) {\n *    let i = seed;\n *    while (true) {\n *      yield i;\n *      i = 2 * i; // double it\n *    }\n * }\n *\n * const iterator = generateDoubles(3);\n * const result = from(iterator).pipe(take(10));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 3\n * // 6\n * // 12\n * // 24\n * // 48\n * // 96\n * // 192\n * // 384\n * // 768\n * // 1536\n * ```\n *\n * With `asyncScheduler`\n *\n * ```ts\n * import { from, asyncScheduler } from 'rxjs';\n *\n * console.log('start');\n *\n * const array = [10, 20, 30];\n * const result = from(array, asyncScheduler);\n *\n * result.subscribe(x => console.log(x));\n *\n * console.log('end');\n *\n * // Logs:\n * // 'start'\n * // 'end'\n * // 10\n * // 20\n * // 30\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link fromEventPattern}\n *\n * @param {ObservableInput<T>} A subscription object, a Promise, an Observable-like,\n * an Array, an iterable, or an array-like object to be converted.\n * @param {SchedulerLike} An optional {@link SchedulerLike} on which to schedule the emission of values.\n * @return {Observable<T>}\n */\nexport function from<T>(input: ObservableInput<T>, scheduler?: SchedulerLike): Observable<T> {\n  return scheduler ? scheduled(input, scheduler) : innerFrom(input);\n}\n", "import { SchedulerLike, ValueFromArray } from '../types';\nimport { Observable } from '../Observable';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function of(value: null): Observable<null>;\nexport function of(value: undefined): Observable<undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of(scheduler: SchedulerLike): Observable<never>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of<A extends readonly unknown[]>(...valuesAndScheduler: [...A, SchedulerLike]): Observable<ValueFromArray<A>>;\n\nexport function of(): Observable<never>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function of<T>(): Observable<T>;\nexport function of<T>(value: T): Observable<T>;\nexport function of<A extends readonly unknown[]>(...values: A): Observable<ValueFromArray<A>>;\n\n/**\n * Converts the arguments to an observable sequence.\n *\n * <span class=\"informal\">Each argument becomes a `next` notification.</span>\n *\n * ![](of.png)\n *\n * Unlike {@link from}, it does not do any flattening and emits each argument in whole\n * as a separate `next` notification.\n *\n * ## Examples\n *\n * Emit the values `10, 20, 30`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of(10, 20, 30)\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: 10\n * // next: 20\n * // next: 30\n * // the end\n * ```\n *\n * Emit the array `[1, 2, 3]`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of([1, 2, 3])\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: [1, 2, 3]\n * // the end\n * ```\n *\n * @see {@link from}\n * @see {@link range}\n *\n * @param {...T} values A comma separated list of arguments you want to be emitted\n * @return {Observable} An Observable that emits the arguments\n * described above and then completes.\n */\nexport function of<T>(...args: Array<T | SchedulerLike>): Observable<T> {\n  const scheduler = popScheduler(args);\n  return from(args as T[], scheduler);\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { SchedulerLike } from '../types';\nimport { isFunction } from '../util/isFunction';\n\n/**\n * Creates an observable that will create an error instance and push it to the consumer as an error\n * immediately upon subscription.\n *\n * <span class=\"informal\">Just errors and does nothing else</span>\n *\n * ![](throw.png)\n *\n * This creation function is useful for creating an observable that will create an error and error every\n * time it is subscribed to. Generally, inside of most operators when you might want to return an errored\n * observable, this is unnecessary. In most cases, such as in the inner return of {@link concatMap},\n * {@link mergeMap}, {@link defer}, and many others, you can simply throw the error, and RxJS will pick\n * that up and notify the consumer of the error.\n *\n * ## Example\n *\n * Create a simple observable that will create a new error with a timestamp and log it\n * and the message every time you subscribe to it\n *\n * ```ts\n * import { throwError } from 'rxjs';\n *\n * let errorCount = 0;\n *\n * const errorWithTimestamp$ = throwError(() => {\n *   const error: any = new Error(`This is error number ${ ++errorCount }`);\n *   error.timestamp = Date.now();\n *   return error;\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * // Logs the timestamp and a new error message for each subscription\n * ```\n *\n * ### Unnecessary usage\n *\n * Using `throwError` inside of an operator or creation function\n * with a callback, is usually not necessary\n *\n * ```ts\n * import { of, concatMap, timer, throwError } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // This is probably overkill.\n *       return throwError(() => new Error(`Invalid time ${ ms }`));\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * You can just throw the error instead\n *\n * ```ts\n * import { of, concatMap, timer } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // Cleaner and easier to read for most folks.\n *       throw new Error(`Invalid time ${ ms }`);\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * @param errorFactory A factory function that will create the error instance that is pushed.\n */\nexport function throwError(errorFactory: () => any): Observable<never>;\n\n/**\n * Returns an observable that will error with the specified error immediately upon subscription.\n *\n * @param error The error instance to emit\n * @deprecated Support for passing an error value will be removed in v8. Instead, pass a factory function to `throwError(() => new Error('test'))`. This is\n * because it will create the error at the moment it should be created and capture a more appropriate stack trace. If\n * for some reason you need to create the error ahead of time, you can still do that: `const err = new Error('test'); throwError(() => err);`.\n */\nexport function throwError(error: any): Observable<never>;\n\n/**\n * Notifies the consumer of an error using a given scheduler by scheduling it at delay `0` upon subscription.\n *\n * @param errorOrErrorFactory An error instance or error factory\n * @param scheduler A scheduler to use to schedule the error notification\n * @deprecated The `scheduler` parameter will be removed in v8.\n * Use `throwError` in combination with {@link observeOn}: `throwError(() => new Error('test')).pipe(observeOn(scheduler));`.\n * Details: https://rxjs.dev/deprecations/scheduler-argument\n */\nexport function throwError(errorOrErrorFactory: any, scheduler: SchedulerLike): Observable<never>;\n\nexport function throwError(errorOrErrorFactory: any, scheduler?: SchedulerLike): Observable<never> {\n  const errorFactory = isFunction(errorOrErrorFactory) ? errorOrErrorFactory : () => errorOrErrorFactory;\n  const init = (subscriber: Subscriber<never>) => subscriber.error(errorFactory());\n  return new Observable(scheduler ? (subscriber) => scheduler.schedule(init as any, 0, subscriber) : init);\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface EmptyError extends Error {}\n\nexport interface EmptyErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): EmptyError;\n}\n\n/**\n * An error thrown when an Observable or a sequence was queried but has no\n * elements.\n *\n * @see {@link first}\n * @see {@link last}\n * @see {@link single}\n * @see {@link firstValueFrom}\n * @see {@link lastValueFrom}\n *\n * @class EmptyError\n */\nexport const EmptyError: EmptyErrorCtor = createErrorClass((_super) => function EmptyErrorImpl(this: any) {\n  _super(this);\n  this.name = 'EmptyError';\n  this.message = 'no elements in sequence';\n});\n", "/**\n * Checks to see if a value is not only a `Date` object,\n * but a *valid* `Date` object that can be converted to a\n * number. For example, `new Date('blah')` is indeed an\n * `instanceof Date`, however it cannot be converted to a\n * number.\n */\nexport function isValidDate(value: any): value is Date {\n  return value instanceof Date && !isNaN(value as any);\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function map<T, R>(project: (value: T, index: number) => R): OperatorFunction<T, R>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function map<T, R, A>(project: (this: A, value: T, index: number) => R, thisArg: A): OperatorFunction<T, R>;\n\n/**\n * Applies a given `project` function to each value emitted by the source\n * Observable, and emits the resulting values as an Observable.\n *\n * <span class=\"informal\">Like [Array.prototype.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map),\n * it passes each source value through a transformation function to get\n * corresponding output values.</span>\n *\n * ![](map.png)\n *\n * Similar to the well known `Array.prototype.map` function, this operator\n * applies a projection to each value and emits that projection in the output\n * Observable.\n *\n * ## Example\n *\n * Map every click to the `clientX` position of that click\n *\n * ```ts\n * import { fromEvent, map } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const positions = clicks.pipe(map(ev => ev.clientX));\n *\n * positions.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link mapTo}\n * @see {@link pluck}\n *\n * @param {function(value: T, index: number): R} project The function to apply\n * to each `value` emitted by the source Observable. The `index` parameter is\n * the number `i` for the i-th emission that has happened since the\n * subscription, starting from the number `0`.\n * @param {any} [thisArg] An optional argument to define what `this` is in the\n * `project` function.\n * @return A function that returns an Observable that emits the values from the\n * source Observable transformed by the given `project` function.\n */\nexport function map<T, R>(project: (value: T, index: number) => R, thisArg?: any): OperatorFunction<T, R> {\n  return operate((source, subscriber) => {\n    // The index of the value from the source. Used with projection.\n    let index = 0;\n    // Subscribe to the source, all errors and completions are sent along\n    // to the consumer.\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value: T) => {\n        // Call the projection function with the appropriate this context,\n        // and send the resulting value to the consumer.\n        subscriber.next(project.call(thisArg, value, index++));\n      })\n    );\n  });\n}\n", "import { OperatorFunction } from \"../types\";\nimport { map } from \"../operators/map\";\n\nconst { isArray } = Array;\n\nfunction callOrApply<T, R>(fn: ((...values: T[]) => R), args: T|T[]): R {\n    return isArray(args) ? fn(...args) : fn(args);\n}\n\n/**\n * Used in several -- mostly deprecated -- situations where we need to \n * apply a list of arguments or a single argument to a result selector.\n */\nexport function mapOneOrManyArgs<T, R>(fn: ((...values: T[]) => R)): OperatorFunction<T|T[], R> {\n    return map(args => callOrApply(fn, args))\n}", "const { isArray } = Array;\nconst { getPrototypeOf, prototype: objectProto, keys: getKeys } = Object;\n\n/**\n * Used in functions where either a list of arguments, a single array of arguments, or a\n * dictionary of arguments can be returned. Returns an object with an `args` property with\n * the arguments in an array, if it is a dictionary, it will also return the `keys` in another\n * property.\n */\nexport function argsArgArrayOrObject<T, O extends Record<string, T>>(args: T[] | [O] | [T[]]): { args: T[]; keys: string[] | null } {\n  if (args.length === 1) {\n    const first = args[0];\n    if (isArray(first)) {\n      return { args: first, keys: null };\n    }\n    if (isPOJO(first)) {\n      const keys = getKeys(first);\n      return {\n        args: keys.map((key) => first[key]),\n        keys,\n      };\n    }\n  }\n\n  return { args: args as T[], keys: null };\n}\n\nfunction isPOJO(obj: any): obj is object {\n  return obj && typeof obj === 'object' && getPrototypeOf(obj) === objectProto;\n}\n", "export function createObject(keys: string[], values: any[]) {\n  return keys.reduce((result, key, i) => ((result[key] = values[i]), result), {} as any);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf, ObservableInputTuple } from '../types';\nimport { argsArgArrayOrObject } from '../util/argsArgArrayOrObject';\nimport { Subscriber } from '../Subscriber';\nimport { from } from './from';\nimport { identity } from '../util/identity';\nimport { Subscription } from '../Subscription';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { popResultSelector, popScheduler } from '../util/args';\nimport { createObject } from '../util/createObject';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { AnyCatcher } from '../AnyCatcher';\nimport { executeSchedule } from '../util/executeSchedule';\n\n// combineLatest(any)\n// We put this first because we need to catch cases where the user has supplied\n// _exactly `any`_ as the argument. Since `any` literally matches _anything_,\n// we don't want it to randomly hit one of the other type signatures below,\n// as we have no idea at build-time what type we should be returning when given an any.\n\n/**\n * You have passed `any` here, we can't figure out if it is\n * an array or an object, so you're getting `unknown`. Use better types.\n * @param arg Something typed as `any`\n */\nexport function combineLatest<T extends AnyCatcher>(arg: T): Observable<unknown>;\n\n// combineLatest([a, b, c])\nexport function combineLatest(sources: []): Observable<never>;\nexport function combineLatest<A extends readonly unknown[]>(sources: readonly [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R,\n  scheduler: SchedulerLike\n): Observable<R>;\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  sources: readonly [...ObservableInputTuple<A>],\n  scheduler: SchedulerLike\n): Observable<A>;\n\n// combineLatest(a, b, c)\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelectorAndScheduler: [...ObservableInputTuple<A>, (...values: A) => R, SchedulerLike]\n): Observable<R>;\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): Observable<A>;\n\n// combineLatest({a, b, c})\nexport function combineLatest(sourcesObject: { [K in any]: never }): Observable<never>;\nexport function combineLatest<T extends Record<string, ObservableInput<any>>>(\n  sourcesObject: T\n): Observable<{ [K in keyof T]: ObservedValueOf<T[K]> }>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are\n * calculated from the latest values of each of its input Observables.\n *\n * <span class=\"informal\">Whenever any input Observable emits a value, it\n * computes a formula using the latest values from all the inputs, then emits\n * the output of that formula.</span>\n *\n * ![](combineLatest.png)\n *\n * `combineLatest` combines the values from all the Observables passed in the\n * observables array. This is done by subscribing to each Observable in order and,\n * whenever any Observable emits, collecting an array of the most recent\n * values from each Observable. So if you pass `n` Observables to this operator,\n * the returned Observable will always emit an array of `n` values, in an order\n * corresponding to the order of the passed Observables (the value from the first Observable\n * will be at index 0 of the array and so on).\n *\n * Static version of `combineLatest` accepts an array of Observables. Note that an array of\n * Observables is a good choice, if you don't know beforehand how many Observables\n * you will combine. Passing an empty array will result in an Observable that\n * completes immediately.\n *\n * To ensure the output array always has the same length, `combineLatest` will\n * actually wait for all input Observables to emit at least once,\n * before it starts emitting results. This means if some Observable emits\n * values before other Observables started emitting, all these values but the last\n * will be lost. On the other hand, if some Observable does not emit a value but\n * completes, resulting Observable will complete at the same moment without\n * emitting anything, since it will now be impossible to include a value from the\n * completed Observable in the resulting array. Also, if some input Observable does\n * not emit any value and never completes, `combineLatest` will also never emit\n * and never complete, since, again, it will wait for all streams to emit some\n * value.\n *\n * If at least one Observable was passed to `combineLatest` and all passed Observables\n * emitted something, the resulting Observable will complete when all combined\n * streams complete. So even if some Observable completes, the result of\n * `combineLatest` will still emit values when other Observables do. In case\n * of a completed Observable, its value from now on will always be the last\n * emitted value. On the other hand, if any Observable errors, `combineLatest`\n * will error immediately as well, and all other Observables will be unsubscribed.\n *\n * ## Examples\n *\n * Combine two timer Observables\n *\n * ```ts\n * import { timer, combineLatest } from 'rxjs';\n *\n * const firstTimer = timer(0, 1000); // emit 0, 1, 2... after every second, starting from now\n * const secondTimer = timer(500, 1000); // emit 0, 1, 2... after every second, starting 0,5s from now\n * const combinedTimers = combineLatest([firstTimer, secondTimer]);\n * combinedTimers.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0] after 0.5s\n * // [1, 0] after 1s\n * // [1, 1] after 1.5s\n * // [2, 1] after 2s\n * ```\n *\n * Combine a dictionary of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = {\n *   a: of(1).pipe(delay(1000), startWith(0)),\n *   b: of(5).pipe(delay(5000), startWith(0)),\n *   c: of(10).pipe(delay(10000), startWith(0))\n * };\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // { a: 0, b: 0, c: 0 } immediately\n * // { a: 1, b: 0, c: 0 } after 1s\n * // { a: 1, b: 5, c: 0 } after 5s\n * // { a: 1, b: 5, c: 10 } after 10s\n * ```\n *\n * Combine an array of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = [1, 5, 10].map(\n *   n => of(n).pipe(\n *     delay(n * 1000), // emit 0 and then emit n after n seconds\n *     startWith(0)\n *   )\n * );\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0, 0] immediately\n * // [1, 0, 0] after 1s\n * // [1, 5, 0] after 5s\n * // [1, 5, 10] after 10s\n * ```\n *\n * Use map operator to dynamically calculate the Body-Mass Index\n *\n * ```ts\n * import { of, combineLatest, map } from 'rxjs';\n *\n * const weight = of(70, 72, 76, 79, 75);\n * const height = of(1.76, 1.77, 1.78);\n * const bmi = combineLatest([weight, height]).pipe(\n *   map(([w, h]) => w / (h * h)),\n * );\n * bmi.subscribe(x => console.log('BMI is ' + x));\n *\n * // With output to console:\n * // BMI is 24.212293388429753\n * // BMI is 23.93948099205209\n * // BMI is 23.671253629592222\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link merge}\n * @see {@link withLatestFrom}\n *\n * @param {ObservableInput} [observables] An array of input Observables to combine with each other.\n * An array of Observables must be given as the first argument.\n * @param {function} [project] An optional function to project the values from\n * the combined latest values into a new value on the output Observable.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for subscribing to\n * each input Observable.\n * @return {Observable} An Observable of projected values from the most recent\n * values from each input Observable, or an array of the most recent values from\n * each input Observable.\n */\nexport function combineLatest<O extends ObservableInput<any>, R>(...args: any[]): Observable<R> | Observable<ObservedValueOf<O>[]> {\n  const scheduler = popScheduler(args);\n  const resultSelector = popResultSelector(args);\n\n  const { args: observables, keys } = argsArgArrayOrObject(args);\n\n  if (observables.length === 0) {\n    // If no observables are passed, or someone has passed an empty array\n    // of observables, or even an empty object POJO, we need to just\n    // complete (EMPTY), but we have to honor the scheduler provided if any.\n    return from([], scheduler as any);\n  }\n\n  const result = new Observable<ObservedValueOf<O>[]>(\n    combineLatestInit(\n      observables as ObservableInput<ObservedValueOf<O>>[],\n      scheduler,\n      keys\n        ? // A handler for scrubbing the array of args into a dictionary.\n          (values) => createObject(keys, values)\n        : // A passthrough to just return the array\n          identity\n    )\n  );\n\n  return resultSelector ? (result.pipe(mapOneOrManyArgs(resultSelector)) as Observable<R>) : result;\n}\n\nexport function combineLatestInit(\n  observables: ObservableInput<any>[],\n  scheduler?: SchedulerLike,\n  valueTransform: (values: any[]) => any = identity\n) {\n  return (subscriber: Subscriber<any>) => {\n    // The outer subscription. We're capturing this in a function\n    // because we may have to schedule it.\n    maybeSchedule(\n      scheduler,\n      () => {\n        const { length } = observables;\n        // A store for the values each observable has emitted so far. We match observable to value on index.\n        const values = new Array(length);\n        // The number of currently active subscriptions, as they complete, we decrement this number to see if\n        // we are all done combining values, so we can complete the result.\n        let active = length;\n        // The number of inner sources that still haven't emitted the first value\n        // We need to track this because all sources need to emit one value in order\n        // to start emitting values.\n        let remainingFirstValues = length;\n        // The loop to kick off subscription. We're keying everything on index `i` to relate the observables passed\n        // in to the slot in the output array or the key in the array of keys in the output dictionary.\n        for (let i = 0; i < length; i++) {\n          maybeSchedule(\n            scheduler,\n            () => {\n              const source = from(observables[i], scheduler as any);\n              let hasFirstValue = false;\n              source.subscribe(\n                createOperatorSubscriber(\n                  subscriber,\n                  (value) => {\n                    // When we get a value, record it in our set of values.\n                    values[i] = value;\n                    if (!hasFirstValue) {\n                      // If this is our first value, record that.\n                      hasFirstValue = true;\n                      remainingFirstValues--;\n                    }\n                    if (!remainingFirstValues) {\n                      // We're not waiting for any more\n                      // first values, so we can emit!\n                      subscriber.next(valueTransform(values.slice()));\n                    }\n                  },\n                  () => {\n                    if (!--active) {\n                      // We only complete the result if we have no more active\n                      // inner observables.\n                      subscriber.complete();\n                    }\n                  }\n                )\n              );\n            },\n            subscriber\n          );\n        }\n      },\n      subscriber\n    );\n  };\n}\n\n/**\n * A small utility to handle the couple of locations where we want to schedule if a scheduler was provided,\n * but we don't if there was no scheduler.\n */\nfunction maybeSchedule(scheduler: SchedulerLike | undefined, execute: () => void, subscription: Subscription) {\n  if (scheduler) {\n    executeSchedule(subscription, scheduler, execute);\n  } else {\n    execute();\n  }\n}\n", "import { Observable } from '../Observable';\nimport { innerFrom } from '../observable/innerFrom';\nimport { Subscriber } from '../Subscriber';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A process embodying the general \"merge\" strategy. This is used in\n * `mergeMap` and `mergeScan` because the logic is otherwise nearly identical.\n * @param source The original source observable\n * @param subscriber The consumer subscriber\n * @param project The projection function to get our inner sources\n * @param concurrent The number of concurrent inner subscriptions\n * @param onBeforeNext Additional logic to apply before nexting to our consumer\n * @param expand If `true` this will perform an \"expand\" strategy, which differs only\n * in that it recurses, and the inner subscription must be schedule-able.\n * @param innerSubScheduler A scheduler to use to schedule inner subscriptions,\n * this is to support the expand strategy, mostly, and should be deprecated\n */\nexport function mergeInternals<T, R>(\n  source: Observable<T>,\n  subscriber: Subscriber<R>,\n  project: (value: T, index: number) => ObservableInput<R>,\n  concurrent: number,\n  onBeforeNext?: (innerValue: R) => void,\n  expand?: boolean,\n  innerSubScheduler?: SchedulerLike,\n  additionalFinalizer?: () => void\n) {\n  // Buffered values, in the event of going over our concurrency limit\n  const buffer: T[] = [];\n  // The number of active inner subscriptions.\n  let active = 0;\n  // An index to pass to our accumulator function\n  let index = 0;\n  // Whether or not the outer source has completed.\n  let isComplete = false;\n\n  /**\n   * Checks to see if we can complete our result or not.\n   */\n  const checkComplete = () => {\n    // If the outer has completed, and nothing is left in the buffer,\n    // and we don't have any active inner subscriptions, then we can\n    // Emit the state and complete.\n    if (isComplete && !buffer.length && !active) {\n      subscriber.complete();\n    }\n  };\n\n  // If we're under our concurrency limit, just start the inner subscription, otherwise buffer and wait.\n  const outerNext = (value: T) => (active < concurrent ? doInnerSub(value) : buffer.push(value));\n\n  const doInnerSub = (value: T) => {\n    // If we're expanding, we need to emit the outer values and the inner values\n    // as the inners will \"become outers\" in a way as they are recursively fed\n    // back to the projection mechanism.\n    expand && subscriber.next(value as any);\n\n    // Increment the number of active subscriptions so we can track it\n    // against our concurrency limit later.\n    active++;\n\n    // A flag used to show that the inner observable completed.\n    // This is checked during finalization to see if we should\n    // move to the next item in the buffer, if there is on.\n    let innerComplete = false;\n\n    // Start our inner subscription.\n    innerFrom(project(value, index++)).subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (innerValue) => {\n          // `mergeScan` has additional handling here. For example\n          // taking the inner value and updating state.\n          onBeforeNext?.(innerValue);\n\n          if (expand) {\n            // If we're expanding, then just recurse back to our outer\n            // handler. It will emit the value first thing.\n            outerNext(innerValue as any);\n          } else {\n            // Otherwise, emit the inner value.\n            subscriber.next(innerValue);\n          }\n        },\n        () => {\n          // Flag that we have completed, so we know to check the buffer\n          // during finalization.\n          innerComplete = true;\n        },\n        // Errors are passed to the destination.\n        undefined,\n        () => {\n          // During finalization, if the inner completed (it wasn't errored or\n          // cancelled), then we want to try the next item in the buffer if\n          // there is one.\n          if (innerComplete) {\n            // We have to wrap this in a try/catch because it happens during\n            // finalization, possibly asynchronously, and we want to pass\n            // any errors that happen (like in a projection function) to\n            // the outer Subscriber.\n            try {\n              // INNER SOURCE COMPLETE\n              // Decrement the active count to ensure that the next time\n              // we try to call `doInnerSub`, the number is accurate.\n              active--;\n              // If we have more values in the buffer, try to process those\n              // Note that this call will increment `active` ahead of the\n              // next conditional, if there were any more inner subscriptions\n              // to start.\n              while (buffer.length && active < concurrent) {\n                const bufferedValue = buffer.shift()!;\n                // Particularly for `expand`, we need to check to see if a scheduler was provided\n                // for when we want to start our inner subscription. Otherwise, we just start\n                // are next inner subscription.\n                if (innerSubScheduler) {\n                  executeSchedule(subscriber, innerSubScheduler, () => doInnerSub(bufferedValue));\n                } else {\n                  doInnerSub(bufferedValue);\n                }\n              }\n              // Check to see if we can complete, and complete if so.\n              checkComplete();\n            } catch (err) {\n              subscriber.error(err);\n            }\n          }\n        }\n      )\n    );\n  };\n\n  // Subscribe to our source observable.\n  source.subscribe(\n    createOperatorSubscriber(subscriber, outerNext, () => {\n      // Outer completed, make a note of it, and check to see if we can complete everything.\n      isComplete = true;\n      checkComplete();\n    })\n  );\n\n  // Additional finalization (for when the destination is torn down).\n  // Other finalization is added implicitly via subscription above.\n  return () => {\n    additionalFinalizer?.();\n  };\n}\n", "import { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { map } from './map';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { mergeInternals } from './mergeInternals';\nimport { isFunction } from '../util/isFunction';\n\n/* tslint:disable:max-line-length */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R,\n  concurrent?: number\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link mergeAll}.</span>\n *\n * ![](mergeMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an Observable, and then merging those resulting Observables and\n * emitting the results of this merger.\n *\n * ## Example\n *\n * Map and flatten each letter to an Observable ticking every 1 second\n *\n * ```ts\n * import { of, mergeMap, interval, map } from 'rxjs';\n *\n * const letters = of('a', 'b', 'c');\n * const result = letters.pipe(\n *   mergeMap(x => interval(1000).pipe(map(i => x + i)))\n * );\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // a0\n * // b0\n * // c0\n * // a1\n * // b1\n * // c1\n * // continues to list a, b, c every second with respective ascending integers\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link merge}\n * @see {@link mergeAll}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchMap}\n *\n * @param {function(value: T, ?index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and merging\n * the results of the Observables obtained from this transformation.\n */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: ((outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R) | number,\n  concurrent: number = Infinity\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  if (isFunction(resultSelector)) {\n    // DEPRECATED PATH\n    return mergeMap((a, i) => map((b: any, ii: number) => resultSelector(a, b, i, ii))(innerFrom(project(a, i))), concurrent);\n  } else if (typeof resultSelector === 'number') {\n    concurrent = resultSelector;\n  }\n\n  return operate((source, subscriber) => mergeInternals(source, subscriber, project, concurrent));\n}\n", "import { mergeMap } from './mergeMap';\nimport { identity } from '../util/identity';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable which\n * concurrently delivers all values that are emitted on the inner Observables.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables.</span>\n *\n * ![](mergeAll.png)\n *\n * `mergeAll` subscribes to an Observable that emits Observables, also known as\n * a higher-order Observable. Each time it observes one of these emitted inner\n * Observables, it subscribes to that and delivers all the values from the\n * inner Observable on the output Observable. The output Observable only\n * completes once all inner Observables have completed. Any error delivered by\n * a inner Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Spawn a new interval Observable for each click event, and blend their outputs as one Observable\n *\n * ```ts\n * import { fromEvent, map, interval, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(map(() => interval(1000)));\n * const firstOrder = higherOrder.pipe(mergeAll());\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * Count from 0 to 9 every second for each click, but only allow 2 concurrent timers\n *\n * ```ts\n * import { fromEvent, map, interval, take, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(10)))\n * );\n * const firstOrder = higherOrder.pipe(mergeAll(2));\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concatAll}\n * @see {@link exhaustAll}\n * @see {@link merge}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @param {number} [concurrent=Infinity] Maximum number of inner\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits values coming from\n * all the inner Observables emitted by the source Observable.\n */\nexport function mergeAll<O extends ObservableInput<any>>(concurrent: number = Infinity): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeMap(identity, concurrent);\n}\n", "import { mergeAll } from './mergeAll';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable by\n * concatenating the inner Observables in order.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables by putting one\n * inner Observable after the other.</span>\n *\n * ![](concatAll.svg)\n *\n * Joins every Observable emitted by the source (a higher-order Observable), in\n * a serial fashion. It subscribes to each inner Observable only after the\n * previous inner Observable has completed, and merges all of their values into\n * the returned observable.\n *\n * __Warning:__ If the source Observable emits Observables quickly and\n * endlessly, and the inner Observables it emits generally complete slower than\n * the source emits, you can run into memory issues as the incoming Observables\n * collect in an unbounded buffer.\n *\n * Note: `concatAll` is equivalent to `mergeAll` with concurrency parameter set\n * to `1`.\n *\n * ## Example\n *\n * For each click event, tick every second from 0 to 3, with no concurrency\n *\n * ```ts\n * import { fromEvent, map, interval, take, concatAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(4)))\n * );\n * const firstOrder = higherOrder.pipe(concatAll());\n * firstOrder.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // (results are not concurrent)\n * // For every click on the \"document\" it will emit values 0 to 3 spaced\n * // on a 1000ms interval\n * // one click = 1000ms-> 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concat}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link exhaustAll}\n * @see {@link mergeAll}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @return A function that returns an Observable emitting values from all the\n * inner Observables concatenated.\n */\nexport function concatAll<O extends ObservableInput<any>>(): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeAll(1);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple, SchedulerLike } from '../types';\nimport { concatAll } from '../operators/concatAll';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function concat<T extends readonly unknown[]>(...inputs: [...ObservableInputTuple<T>]): Observable<T[number]>;\nexport function concat<T extends readonly unknown[]>(\n  ...inputsAndScheduler: [...ObservableInputTuple<T>, SchedulerLike]\n): Observable<T[number]>;\n\n/**\n * Creates an output Observable which sequentially emits all values from the first given\n * Observable and then moves on to the next.\n *\n * <span class=\"informal\">Concatenates multiple Observables together by\n * sequentially emitting their values, one Observable after the other.</span>\n *\n * ![](concat.png)\n *\n * `concat` joins multiple Observables together, by subscribing to them one at a time and\n * merging their results into the output Observable. You can pass either an array of\n * Observables, or put them directly as arguments. Passing an empty array will result\n * in Observable that completes immediately.\n *\n * `concat` will subscribe to first input Observable and emit all its values, without\n * changing or affecting them in any way. When that Observable completes, it will\n * subscribe to then next Observable passed and, again, emit its values. This will be\n * repeated, until the operator runs out of Observables. When last input Observable completes,\n * `concat` will complete as well. At any given moment only one Observable passed to operator\n * emits values. If you would like to emit values from passed Observables concurrently, check out\n * {@link merge} instead, especially with optional `concurrent` parameter. As a matter of fact,\n * `concat` is an equivalent of `merge` operator with `concurrent` parameter set to `1`.\n *\n * Note that if some input Observable never completes, `concat` will also never complete\n * and Observables following the one that did not complete will never be subscribed. On the other\n * hand, if some Observable simply completes immediately after it is subscribed, it will be\n * invisible for `concat`, which will just move on to the next Observable.\n *\n * If any Observable in chain errors, instead of passing control to the next Observable,\n * `concat` will error immediately as well. Observables that would be subscribed after\n * the one that emitted error, never will.\n *\n * If you pass to `concat` the same Observable many times, its stream of values\n * will be \"replayed\" on every subscription, which means you can repeat given Observable\n * as many times as you like. If passing the same Observable to `concat` 1000 times becomes tedious,\n * you can always use {@link repeat}.\n *\n * ## Examples\n *\n * Concatenate a timer counting from 0 to 3 with a synchronous sequence from 1 to 10\n *\n * ```ts\n * import { interval, take, range, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(4));\n * const sequence = range(1, 10);\n * const result = concat(timer, sequence);\n * result.subscribe(x => console.log(x));\n *\n * // results in:\n * // 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3 -immediate-> 1 ... 10\n * ```\n *\n * Concatenate 3 Observables\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const result = concat(timer1, timer2, timer3);\n * result.subscribe(x => console.log(x));\n *\n * // results in the following:\n * // (Prints to console sequentially)\n * // -1000ms-> 0 -1000ms-> 1 -1000ms-> ... 9\n * // -2000ms-> 0 -2000ms-> 1 -2000ms-> ... 5\n * // -500ms-> 0 -500ms-> 1 -500ms-> ... 9\n * ```\n *\n * Concatenate the same Observable to repeat it\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(2));\n *\n * concat(timer, timer) // concatenating the same Observable!\n *   .subscribe({\n *     next: value => console.log(value),\n *     complete: () => console.log('...and it is done!')\n *   });\n *\n * // Logs:\n * // 0 after 1s\n * // 1 after 2s\n * // 0 after 3s\n * // 1 after 4s\n * // '...and it is done!' also after 4s\n * ```\n *\n * @see {@link concatAll}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link startWith}\n * @see {@link endWith}\n *\n * @param args Input Observables to concatenate.\n */\nexport function concat(...args: any[]): Observable<unknown> {\n  return concatAll()(from(args, popScheduler(args)));\n}\n", "import { Observable } from '../Observable';\nimport { ObservedValueOf, ObservableInput } from '../types';\nimport { innerFrom } from './innerFrom';\n\n/**\n * Creates an Observable that, on subscribe, calls an Observable factory to\n * make an Observable for each new Observer.\n *\n * <span class=\"informal\">Creates the Observable lazily, that is, only when it\n * is subscribed.\n * </span>\n *\n * ![](defer.png)\n *\n * `defer` allows you to create an Observable only when the Observer\n * subscribes. It waits until an Observer subscribes to it, calls the given\n * factory function to get an Observable -- where a factory function typically\n * generates a new Observable -- and subscribes the Observer to this Observable.\n * In case the factory function returns a falsy value, then EMPTY is used as\n * Observable instead. Last but not least, an exception during the factory\n * function call is transferred to the Observer by calling `error`.\n *\n * ## Example\n *\n * Subscribe to either an Observable of clicks or an Observable of interval, at random\n *\n * ```ts\n * import { defer, fromEvent, interval } from 'rxjs';\n *\n * const clicksOrInterval = defer(() => {\n *   return Math.random() > 0.5\n *     ? fromEvent(document, 'click')\n *     : interval(1000);\n * });\n * clicksOrInterval.subscribe(x => console.log(x));\n *\n * // Results in the following behavior:\n * // If the result of Math.random() is greater than 0.5 it will listen\n * // for clicks anywhere on the \"document\"; when document is clicked it\n * // will log a MouseEvent object to the console. If the result is less\n * // than 0.5 it will emit ascending numbers, one every second(1000ms).\n * ```\n *\n * @see {@link Observable}\n *\n * @param {function(): ObservableInput} observableFactory The Observable\n * factory function to invoke for each Observer that subscribes to the output\n * Observable. May also return a Promise, which will be converted on the fly\n * to an Observable.\n * @return {Observable} An Observable whose Observers' subscriptions trigger\n * an invocation of the given Observable factory function.\n */\nexport function defer<R extends ObservableInput<any>>(observableFactory: () => R): Observable<ObservedValueOf<R>> {\n  return new Observable<ObservedValueOf<R>>((subscriber) => {\n    innerFrom(observableFactory()).subscribe(subscriber);\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Observable } from '../Observable';\nimport { mergeMap } from '../operators/mergeMap';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isFunction } from '../util/isFunction';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n// These constants are used to create handler registry functions using array mapping below.\nconst nodeEventEmitterMethods = ['addListener', 'removeListener'] as const;\nconst eventTargetMethods = ['addEventListener', 'removeEventListener'] as const;\nconst jqueryMethods = ['on', 'off'] as const;\n\nexport interface NodeStyleEventEmitter {\n  addListener(eventName: string | symbol, handler: NodeEventHandler): this;\n  removeListener(eventName: string | symbol, handler: NodeEventHandler): this;\n}\n\nexport type NodeEventHandler = (...args: any[]) => void;\n\n// For APIs that implement `addListener` and `removeListener` methods that may\n// not use the same arguments or return EventEmitter values\n// such as React Native\nexport interface NodeCompatibleEventEmitter {\n  addListener(eventName: string, handler: NodeEventHandler): void | {};\n  removeListener(eventName: string, handler: NodeEventHandler): void | {};\n}\n\n// Use handler types like those in @types/jquery. See:\n// https://github.com/DefinitelyTyped/DefinitelyTyped/blob/847731ba1d7fa6db6b911c0e43aa0afe596e7723/types/jquery/misc.d.ts#L6395\nexport interface JQueryStyleEventEmitter<TContext, T> {\n  on(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n  off(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n}\n\nexport interface EventListenerObject<E> {\n  handleEvent(evt: E): void;\n}\n\nexport interface HasEventTargetAddRemove<E> {\n  addEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void;\n  removeEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: EventListenerOptions | boolean\n  ): void;\n}\n\nexport interface EventListenerOptions {\n  capture?: boolean;\n  passive?: boolean;\n  once?: boolean;\n}\n\nexport interface AddEventListenerOptions extends EventListenerOptions {\n  once?: boolean;\n  passive?: boolean;\n}\n\nexport function fromEvent<T>(target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>, eventName: string): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  resultSelector: (event: T) => R\n): Observable<R>;\nexport function fromEvent<T>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions,\n  resultSelector: (event: T) => R\n): Observable<R>;\n\nexport function fromEvent(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string\n): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent<T>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string,\n  resultSelector: (value: T, ...args: any[]) => R\n): Observable<R>;\n\n/**\n * Creates an Observable that emits events of a specific type coming from the\n * given event target.\n *\n * <span class=\"informal\">Creates an Observable from DOM events, or Node.js\n * EventEmitter events or others.</span>\n *\n * ![](fromEvent.png)\n *\n * `fromEvent` accepts as a first argument event target, which is an object with methods\n * for registering event handler functions. As a second argument it takes string that indicates\n * type of event we want to listen for. `fromEvent` supports selected types of event targets,\n * which are described in detail below. If your event target does not match any of the ones listed,\n * you should use {@link fromEventPattern}, which can be used on arbitrary APIs.\n * When it comes to APIs supported by `fromEvent`, their methods for adding and removing event\n * handler functions have different names, but they all accept a string describing event type\n * and function itself, which will be called whenever said event happens.\n *\n * Every time resulting Observable is subscribed, event handler function will be registered\n * to event target on given event type. When that event fires, value\n * passed as a first argument to registered function will be emitted by output Observable.\n * When Observable is unsubscribed, function will be unregistered from event target.\n *\n * Note that if event target calls registered function with more than one argument, second\n * and following arguments will not appear in resulting stream. In order to get access to them,\n * you can pass to `fromEvent` optional project function, which will be called with all arguments\n * passed to event handler. Output Observable will then emit value returned by project function,\n * instead of the usual value.\n *\n * Remember that event targets listed below are checked via duck typing. It means that\n * no matter what kind of object you have and no matter what environment you work in,\n * you can safely use `fromEvent` on that object if it exposes described methods (provided\n * of course they behave as was described above). So for example if Node.js library exposes\n * event target which has the same method names as DOM EventTarget, `fromEvent` is still\n * a good choice.\n *\n * If the API you use is more callback then event handler oriented (subscribed\n * callback function fires only once and thus there is no need to manually\n * unregister it), you should use {@link bindCallback} or {@link bindNodeCallback}\n * instead.\n *\n * `fromEvent` supports following types of event targets:\n *\n * **DOM EventTarget**\n *\n * This is an object with `addEventListener` and `removeEventListener` methods.\n *\n * In the browser, `addEventListener` accepts - apart from event type string and event\n * handler function arguments - optional third parameter, which is either an object or boolean,\n * both used for additional configuration how and when passed function will be called. When\n * `fromEvent` is used with event target of that type, you can provide this values\n * as third parameter as well.\n *\n * **Node.js EventEmitter**\n *\n * An object with `addListener` and `removeListener` methods.\n *\n * **JQuery-style event target**\n *\n * An object with `on` and `off` methods\n *\n * **DOM NodeList**\n *\n * List of DOM Nodes, returned for example by `document.querySelectorAll` or `Node.childNodes`.\n *\n * Although this collection is not event target in itself, `fromEvent` will iterate over all Nodes\n * it contains and install event handler function in every of them. When returned Observable\n * is unsubscribed, function will be removed from all Nodes.\n *\n * **DOM HtmlCollection**\n *\n * Just as in case of NodeList it is a collection of DOM nodes. Here as well event handler function is\n * installed and removed in each of elements.\n *\n *\n * ## Examples\n *\n * Emit clicks happening on the DOM document\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * clicks.subscribe(x => console.log(x));\n *\n * // Results in:\n * // MouseEvent object logged to console every time a click\n * // occurs on the document.\n * ```\n *\n * Use `addEventListener` with capture option\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * // note optional configuration parameter which will be passed to addEventListener\n * const clicksInDocument = fromEvent(document, 'click', { capture: true });\n * const clicksInDiv = fromEvent(div, 'click');\n *\n * clicksInDocument.subscribe(() => console.log('document'));\n * clicksInDiv.subscribe(() => console.log('div'));\n *\n * // By default events bubble UP in DOM tree, so normally\n * // when we would click on div in document\n * // \"div\" would be logged first and then \"document\".\n * // Since we specified optional `capture` option, document\n * // will catch event when it goes DOWN DOM tree, so console\n * // will log \"document\" and then \"div\".\n * ```\n *\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n * @see {@link fromEventPattern}\n *\n * @param {FromEventTarget<T>} target The DOM EventTarget, Node.js\n * EventEmitter, JQuery-like event target, NodeList or HTMLCollection to attach the event handler to.\n * @param {string} eventName The event name of interest, being emitted by the\n * `target`.\n * @param {EventListenerOptions} [options] Options to pass through to addEventListener\n * @return {Observable<T>}\n */\nexport function fromEvent<T>(\n  target: any,\n  eventName: string,\n  options?: EventListenerOptions | ((...args: any[]) => T),\n  resultSelector?: (...args: any[]) => T\n): Observable<T> {\n  if (isFunction(options)) {\n    resultSelector = options;\n    options = undefined;\n  }\n  if (resultSelector) {\n    return fromEvent<T>(target, eventName, options as EventListenerOptions).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  // Figure out our add and remove methods. In order to do this,\n  // we are going to analyze the target in a preferred order, if\n  // the target matches a given signature, we take the two \"add\" and \"remove\"\n  // method names and apply them to a map to create opposite versions of the\n  // same function. This is because they all operate in duplicate pairs,\n  // `addListener(name, handler)`, `removeListener(name, handler)`, for example.\n  // The call only differs by method name, as to whether or not you're adding or removing.\n  const [add, remove] =\n    // If it is an EventTarget, we need to use a slightly different method than the other two patterns.\n    isEventTarget(target)\n      ? eventTargetMethods.map((methodName) => (handler: any) => target[methodName](eventName, handler, options as EventListenerOptions))\n      : // In all other cases, the call pattern is identical with the exception of the method names.\n      isNodeStyleEventEmitter(target)\n      ? nodeEventEmitterMethods.map(toCommonHandlerRegistry(target, eventName))\n      : isJQueryStyleEventEmitter(target)\n      ? jqueryMethods.map(toCommonHandlerRegistry(target, eventName))\n      : [];\n\n  // If add is falsy, it's because we didn't match a pattern above.\n  // Check to see if it is an ArrayLike, because if it is, we want to\n  // try to apply fromEvent to all of it's items. We do this check last,\n  // because there are may be some types that are both ArrayLike *and* implement\n  // event registry points, and we'd rather delegate to that when possible.\n  if (!add) {\n    if (isArrayLike(target)) {\n      return mergeMap((subTarget: any) => fromEvent(subTarget, eventName, options as EventListenerOptions))(\n        innerFrom(target)\n      ) as Observable<T>;\n    }\n  }\n\n  // If add is falsy and we made it here, it's because we didn't\n  // match any valid target objects above.\n  if (!add) {\n    throw new TypeError('Invalid event target');\n  }\n\n  return new Observable<T>((subscriber) => {\n    // The handler we are going to register. Forwards the event object, by itself, or\n    // an array of arguments to the event handler, if there is more than one argument,\n    // to the consumer.\n    const handler = (...args: any[]) => subscriber.next(1 < args.length ? args : args[0]);\n    // Do the work of adding the handler to the target.\n    add(handler);\n    // When we finalize, we want to remove the handler and free up memory.\n    return () => remove!(handler);\n  });\n}\n\n/**\n * Used to create `add` and `remove` functions to register and unregister event handlers\n * from a target in the most common handler pattern, where there are only two arguments.\n * (e.g.  `on(name, fn)`, `off(name, fn)`, `addListener(name, fn)`, or `removeListener(name, fn)`)\n * @param target The target we're calling methods on\n * @param eventName The event name for the event we're creating register or unregister functions for\n */\nfunction toCommonHandlerRegistry(target: any, eventName: string) {\n  return (methodName: string) => (handler: any) => target[methodName](eventName, handler);\n}\n\n/**\n * Checks to see if the target implements the required node-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isNodeStyleEventEmitter(target: any): target is NodeStyleEventEmitter {\n  return isFunction(target.addListener) && isFunction(target.removeListener);\n}\n\n/**\n * Checks to see if the target implements the required jQuery-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isJQueryStyleEventEmitter(target: any): target is JQueryStyleEventEmitter<any, any> {\n  return isFunction(target.on) && isFunction(target.off);\n}\n\n/**\n * Checks to see if the target implements the required EventTarget methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isEventTarget(target: any): target is HasEventTargetAddRemove<any> {\n  return isFunction(target.addEventListener) && isFunction(target.removeEventListener);\n}\n", "import { Observable } from '../Observable';\nimport { isFunction } from '../util/isFunction';\nimport { NodeEventHandler } from './fromEvent';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n/* tslint:disable:max-line-length */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void\n): Observable<T>;\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Creates an Observable from an arbitrary API for registering event handlers.\n *\n * <span class=\"informal\">When that method for adding event handler was something {@link fromEvent}\n * was not prepared for.</span>\n *\n * ![](fromEventPattern.png)\n *\n * `fromEventPattern` allows you to convert into an Observable any API that supports registering handler functions\n * for events. It is similar to {@link fromEvent}, but far\n * more flexible. In fact, all use cases of {@link fromEvent} could be easily handled by\n * `fromEventPattern` (although in slightly more verbose way).\n *\n * This operator accepts as a first argument an `addHandler` function, which will be injected with\n * handler parameter. That handler is actually an event handler function that you now can pass\n * to API expecting it. `addHandler` will be called whenever Observable\n * returned by the operator is subscribed, so registering handler in API will not\n * necessarily happen when `fromEventPattern` is called.\n *\n * After registration, every time an event that we listen to happens,\n * Observable returned by `fromEventPattern` will emit value that event handler\n * function was called with. Note that if event handler was called with more\n * than one argument, second and following arguments will not appear in the Observable.\n *\n * If API you are using allows to unregister event handlers as well, you can pass to `fromEventPattern`\n * another function - `removeHandler` - as a second parameter. It will be injected\n * with the same handler function as before, which now you can use to unregister\n * it from the API. `removeHandler` will be called when consumer of resulting Observable\n * unsubscribes from it.\n *\n * In some APIs unregistering is actually handled differently. Method registering an event handler\n * returns some kind of token, which is later used to identify which function should\n * be unregistered or it itself has method that unregisters event handler.\n * If that is the case with your API, make sure token returned\n * by registering method is returned by `addHandler`. Then it will be passed\n * as a second argument to `removeHandler`, where you will be able to use it.\n *\n * If you need access to all event handler parameters (not only the first one),\n * or you need to transform them in any way, you can call `fromEventPattern` with optional\n * third parameter - project function which will accept all arguments passed to\n * event handler when it is called. Whatever is returned from project function will appear on\n * resulting stream instead of usual event handlers first argument. This means\n * that default project can be thought of as function that takes its first parameter\n * and ignores the rest.\n *\n * ## Examples\n *\n * Emits clicks happening on the DOM document\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * function addClickHandler(handler) {\n *   document.addEventListener('click', handler);\n * }\n *\n * function removeClickHandler(handler) {\n *   document.removeEventListener('click', handler);\n * }\n *\n * const clicks = fromEventPattern(\n *   addClickHandler,\n *   removeClickHandler\n * );\n * clicks.subscribe(x => console.log(x));\n *\n * // Whenever you click anywhere in the browser, DOM MouseEvent\n * // object will be logged.\n * ```\n *\n * Use with API that returns cancellation token\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * const token = someAPI.registerEventHandler(function() {});\n * someAPI.unregisterEventHandler(token); // this APIs cancellation method accepts\n *                                        // not handler itself, but special token.\n *\n * const someAPIObservable = fromEventPattern(\n *   function(handler) { return someAPI.registerEventHandler(handler); }, // Note that we return the token here...\n *   function(handler, token) { someAPI.unregisterEventHandler(token); }  // ...to then use it here.\n * );\n * ```\n *\n * Use with project function\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * someAPI.registerEventHandler((eventType, eventMessage) => {\n *   console.log(eventType, eventMessage); // Logs 'EVENT_TYPE' 'EVENT_MESSAGE' to console.\n * });\n *\n * const someAPIObservable = fromEventPattern(\n *   handler => someAPI.registerEventHandler(handler),\n *   handler => someAPI.unregisterEventHandler(handler)\n *   (eventType, eventMessage) => eventType + ' --- ' + eventMessage // without that function only 'EVENT_TYPE'\n * );                                                                // would be emitted by the Observable\n *\n * someAPIObservable.subscribe(value => console.log(value));\n *\n * // Logs:\n * // 'EVENT_TYPE --- EVENT_MESSAGE'\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n *\n * @param {function(handler: Function): any} addHandler A function that takes\n * a `handler` function as argument and attaches it somehow to the actual\n * source of events.\n * @param {function(handler: Function, token?: any): void} [removeHandler] A function that\n * takes a `handler` function as an argument and removes it from the event source. If `addHandler`\n * returns some kind of token, `removeHandler` function will have it as a second parameter.\n * @param {function(...args: any): T} [project] A function to\n * transform results. It takes the arguments from the event handler and\n * should return a single value.\n * @return {Observable<T>} Observable which, when an event happens, emits first parameter\n * passed to registered event handler. Alternatively it emits whatever project function returns\n * at that moment.\n */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T | T[]> {\n  if (resultSelector) {\n    return fromEventPattern<T>(addHandler, removeHandler).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  return new Observable<T | T[]>((subscriber) => {\n    const handler = (...e: T[]) => subscriber.next(e.length === 1 ? e[0] : e);\n    const retValue = addHandler(handler);\n    return isFunction(removeHandler) ? () => removeHandler(handler, retValue) : undefined;\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { async as asyncScheduler } from '../scheduler/async';\nimport { isScheduler } from '../util/isScheduler';\nimport { isValidDate } from '../util/isDate';\n\n/**\n * Creates an observable that will wait for a specified time period, or exact date, before\n * emitting the number 0.\n *\n * <span class=\"informal\">Used to emit a notification after a delay.</span>\n *\n * This observable is useful for creating delays in code, or racing against other values\n * for ad-hoc timeouts.\n *\n * The `delay` is specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Examples\n *\n * Wait 3 seconds and start another observable\n *\n * You might want to use `timer` to delay subscription to an\n * observable by a set amount of time. Here we use a timer with\n * {@link concatMapTo} or {@link concatMap} in order to wait\n * a few seconds and start a subscription to a source.\n *\n * ```ts\n * import { of, timer, concatMap } from 'rxjs';\n *\n * // This could be any observable\n * const source = of(1, 2, 3);\n *\n * timer(3000)\n *   .pipe(concatMap(() => source))\n *   .subscribe(console.log);\n * ```\n *\n * Take all values until the start of the next minute\n *\n * Using a `Date` as the trigger for the first emission, you can\n * do things like wait until midnight to fire an event, or in this case,\n * wait until a new minute starts (chosen so the example wouldn't take\n * too long to run) in order to stop watching a stream. Leveraging\n * {@link takeUntil}.\n *\n * ```ts\n * import { interval, takeUntil, timer } from 'rxjs';\n *\n * // Build a Date object that marks the\n * // next minute.\n * const currentDate = new Date();\n * const startOfNextMinute = new Date(\n *   currentDate.getFullYear(),\n *   currentDate.getMonth(),\n *   currentDate.getDate(),\n *   currentDate.getHours(),\n *   currentDate.getMinutes() + 1\n * );\n *\n * // This could be any observable stream\n * const source = interval(1000);\n *\n * const result = source.pipe(\n *   takeUntil(timer(startOfNextMinute))\n * );\n *\n * result.subscribe(console.log);\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `dueTime`.\n *\n * @param due If a `number`, the amount of time in milliseconds to wait before emitting.\n * If a `Date`, the exact time at which to emit.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(due: number | Date, scheduler?: SchedulerLike): Observable<0>;\n\n/**\n * Creates an observable that starts an interval after a specified delay, emitting incrementing numbers -- starting at `0` --\n * on each interval after words.\n *\n * The `delay` and `intervalDuration` are specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Example\n *\n * ### Start an interval that starts right away\n *\n * Since {@link interval} waits for the passed delay before starting,\n * sometimes that's not ideal. You may want to start an interval immediately.\n * `timer` works well for this. Here we have both side-by-side so you can\n * see them in comparison.\n *\n * Note that this observable will never complete.\n *\n * ```ts\n * import { timer, interval } from 'rxjs';\n *\n * timer(0, 1000).subscribe(n => console.log('timer', n));\n * interval(1000).subscribe(n => console.log('interval', n));\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `startDue`.\n * @param startDue If a `number`, is the time to wait before starting the interval.\n * If a `Date`, is the exact time at which to start the interval.\n * @param intervalDuration The delay between each value emitted in the interval. Passing a\n * negative number here will result in immediate completion after the first value is emitted, as though\n * no `intervalDuration` was passed at all.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(startDue: number | Date, intervalDuration: number, scheduler?: SchedulerLike): Observable<number>;\n\n/**\n * @deprecated The signature allowing `undefined` to be passed for `intervalDuration` will be removed in v8. Use the `timer(dueTime, scheduler?)` signature instead.\n */\nexport function timer(dueTime: number | Date, unused: undefined, scheduler?: SchedulerLike): Observable<0>;\n\nexport function timer(\n  dueTime: number | Date = 0,\n  intervalOrScheduler?: number | SchedulerLike,\n  scheduler: SchedulerLike = asyncScheduler\n): Observable<number> {\n  // Since negative intervalDuration is treated as though no\n  // interval was specified at all, we start with a negative number.\n  let intervalDuration = -1;\n\n  if (intervalOrScheduler != null) {\n    // If we have a second argument, and it's a scheduler,\n    // override the scheduler we had defaulted. Otherwise,\n    // it must be an interval.\n    if (isScheduler(intervalOrScheduler)) {\n      scheduler = intervalOrScheduler;\n    } else {\n      // Note that this *could* be negative, in which case\n      // it's like not passing an intervalDuration at all.\n      intervalDuration = intervalOrScheduler;\n    }\n  }\n\n  return new Observable((subscriber) => {\n    // If a valid date is passed, calculate how long to wait before\n    // executing the first value... otherwise, if it's a number just schedule\n    // that many milliseconds (or scheduler-specified unit size) in the future.\n    let due = isValidDate(dueTime) ? +dueTime - scheduler!.now() : dueTime;\n\n    if (due < 0) {\n      // Ensure we don't schedule in the future.\n      due = 0;\n    }\n\n    // The incrementing value we emit.\n    let n = 0;\n\n    // Start the timer.\n    return scheduler.schedule(function () {\n      if (!subscriber.closed) {\n        // Emit the next value and increment.\n        subscriber.next(n++);\n\n        if (0 <= intervalDuration) {\n          // If we have a interval after the initial timer,\n          // reschedule with the period.\n          this.schedule(undefined, intervalDuration);\n        } else {\n          // We didn't have an interval. So just complete.\n          subscriber.complete();\n        }\n      }\n    }, due);\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, ObservableInputTuple, SchedulerLike } from '../types';\nimport { mergeAll } from '../operators/mergeAll';\nimport { innerFrom } from './innerFrom';\nimport { EMPTY } from './empty';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function merge<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A[number]>;\nexport function merge<A extends readonly unknown[]>(...sourcesAndConcurrency: [...ObservableInputTuple<A>, number?]): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike?]\n): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number?, SchedulerLike?]\n): Observable<A[number]>;\n\n/**\n * Creates an output Observable which concurrently emits all values from every\n * given input Observable.\n *\n * <span class=\"informal\">Flattens multiple Observables together by blending\n * their values into one Observable.</span>\n *\n * ![](merge.png)\n *\n * `merge` subscribes to each given input Observable (as arguments), and simply\n * forwards (without doing any transformation) all the values from all the input\n * Observables to the output Observable. The output Observable only completes\n * once all input Observables have completed. Any error delivered by an input\n * Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Merge together two Observables: 1s interval and clicks\n *\n * ```ts\n * import { merge, fromEvent, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const clicksOrTimer = merge(clicks, timer);\n * clicksOrTimer.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // timer will emit ascending values, one every second(1000ms) to console\n * // clicks logs MouseEvents to console every time the \"document\" is clicked\n * // Since the two streams are merged you see these happening\n * // as they occur.\n * ```\n *\n * Merge together 3 Observables, but run only 2 concurrently\n *\n * ```ts\n * import { interval, take, merge } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const concurrent = 2; // the argument\n * const merged = merge(timer1, timer2, timer3, concurrent);\n * merged.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // - First timer1 and timer2 will run concurrently\n * // - timer1 will emit a value every 1000ms for 10 iterations\n * // - timer2 will emit a value every 2000ms for 6 iterations\n * // - after timer1 hits its max iteration, timer2 will\n * //   continue, and timer3 will start to run concurrently with timer2\n * // - when timer2 hits its max iteration it terminates, and\n * //   timer3 will continue to emit a value every 500ms until it is complete\n * ```\n *\n * @see {@link mergeAll}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n *\n * @param {...ObservableInput} observables Input Observables to merge together.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for managing\n * concurrency of input Observables.\n * @return {Observable} an Observable that emits items that are the result of\n * every input Observable.\n */\nexport function merge(...args: (ObservableInput<unknown> | number | SchedulerLike)[]): Observable<unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  const sources = args as ObservableInput<unknown>[];\n  return !sources.length\n    ? // No source provided\n      EMPTY\n    : sources.length === 1\n    ? // One source? Just return it.\n      innerFrom(sources[0])\n    : // Merge all sources\n      mergeAll(concurrent)(from(sources, scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { noop } from '../util/noop';\n\n/**\n * An Observable that emits no items to the Observer and never completes.\n *\n * ![](never.png)\n *\n * A simple Observable that emits neither values nor errors nor the completion\n * notification. It can be used for testing purposes or for composing with other\n * Observables. Please note that by never emitting a complete notification, this\n * Observable keeps the subscription from being disposed automatically.\n * Subscriptions need to be manually disposed.\n *\n * ##  Example\n *\n * Emit the number 7, then never emit anything else (not even complete)\n *\n * ```ts\n * import { NEVER, startWith } from 'rxjs';\n *\n * const info = () => console.log('Will not be called');\n *\n * const result = NEVER.pipe(startWith(7));\n * result.subscribe({\n *   next: x => console.log(x),\n *   error: info,\n *   complete: info\n * });\n * ```\n *\n * @see {@link Observable}\n * @see {@link EMPTY}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const NEVER = new Observable<never>(noop);\n\n/**\n * @deprecated Replaced with the {@link NEVER} constant. Will be removed in v8.\n */\nexport function never() {\n  return NEVER;\n}\n", "const { isArray } = Array;\n\n/**\n * Used in operators and functions that accept either a list of arguments, or an array of arguments\n * as a single argument.\n */\nexport function argsOrArgArray<T>(args: (T | T[])[]): T[] {\n  return args.length === 1 && isArray(args[0]) ? args[0] : (args as T[]);\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, S extends T, A>(predicate: (this: A, value: T, index: number) => value is S, thisArg: A): OperatorFunction<T, S>;\nexport function filter<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function filter<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, A>(predicate: (this: A, value: T, index: number) => boolean, thisArg: A): MonoTypeOperatorFunction<T>;\nexport function filter<T>(predicate: (value: T, index: number) => boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Filter items emitted by the source Observable by only emitting those that\n * satisfy a specified predicate.\n *\n * <span class=\"informal\">Like\n * [Array.prototype.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),\n * it only emits a value from the source if it passes a criterion function.</span>\n *\n * ![](filter.png)\n *\n * Similar to the well-known `Array.prototype.filter` method, this operator\n * takes values from the source Observable, passes them through a `predicate`\n * function and only emits those values that yielded `true`.\n *\n * ## Example\n *\n * Emit only click events whose target was a DIV element\n *\n * ```ts\n * import { fromEvent, filter } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksOnDivs = clicks.pipe(filter(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * clicksOnDivs.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n * @see {@link distinctUntilKeyChanged}\n * @see {@link ignoreElements}\n * @see {@link partition}\n * @see {@link skip}\n *\n * @param predicate A function that\n * evaluates each value emitted by the source Observable. If it returns `true`,\n * the value is emitted, if `false` the value is not passed to the output\n * Observable. The `index` parameter is the number `i` for the i-th source\n * emission that has happened since the subscription, starting from the number\n * `0`.\n * @param thisArg An optional argument to determine the value of `this`\n * in the `predicate` function.\n * @return A function that returns an Observable that emits items from the\n * source Observable that satisfy the specified `predicate`.\n */\nexport function filter<T>(predicate: (value: T, index: number) => boolean, thisArg?: any): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // An index passed to our predicate function on each call.\n    let index = 0;\n\n    // Subscribe to the source, all errors and completions are\n    // forwarded to the consumer.\n    source.subscribe(\n      // Call the predicate with the appropriate `this` context,\n      // if the predicate returns `true`, then send the value\n      // to the consumer.\n      createOperatorSubscriber(subscriber, (value) => predicate.call(thisArg, value, index++) && subscriber.next(value))\n    );\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple } from '../types';\nimport { innerFrom } from './innerFrom';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { EMPTY } from './empty';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { popResultSelector } from '../util/args';\n\nexport function zip<A extends readonly unknown[]>(sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\nexport function zip<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are calculated from the values, in order, of each\n * of its input Observables.\n *\n * If the last parameter is a function, this function is used to compute the created value from the input values.\n * Otherwise, an array of the input values is returned.\n *\n * ## Example\n *\n * Combine age and name from different sources\n *\n * ```ts\n * import { of, zip, map } from 'rxjs';\n *\n * const age$ = of(27, 25, 29);\n * const name$ = of('Foo', 'Bar', 'Beer');\n * const isDev$ = of(true, true, false);\n *\n * zip(age$, name$, isDev$).pipe(\n *   map(([age, name, isDev]) => ({ age, name, isDev }))\n * )\n * .subscribe(x => console.log(x));\n *\n * // Outputs\n * // { age: 27, name: 'Foo', isDev: true }\n * // { age: 25, name: 'Bar', isDev: true }\n * // { age: 29, name: 'Beer', isDev: false }\n * ```\n *\n * @param sources\n * @return {Observable<R>}\n */\nexport function zip(...args: unknown[]): Observable<unknown> {\n  const resultSelector = popResultSelector(args);\n\n  const sources = argsOrArgArray(args) as Observable<unknown>[];\n\n  return sources.length\n    ? new Observable<unknown[]>((subscriber) => {\n        // A collection of buffers of values from each source.\n        // Keyed by the same index with which the sources were passed in.\n        let buffers: unknown[][] = sources.map(() => []);\n\n        // An array of flags of whether or not the sources have completed.\n        // This is used to check to see if we should complete the result.\n        // Keyed by the same index with which the sources were passed in.\n        let completed = sources.map(() => false);\n\n        // When everything is done, release the arrays above.\n        subscriber.add(() => {\n          buffers = completed = null!;\n        });\n\n        // Loop over our sources and subscribe to each one. The index `i` is\n        // especially important here, because we use it in closures below to\n        // access the related buffers and completion properties\n        for (let sourceIndex = 0; !subscriber.closed && sourceIndex < sources.length; sourceIndex++) {\n          innerFrom(sources[sourceIndex]).subscribe(\n            createOperatorSubscriber(\n              subscriber,\n              (value) => {\n                buffers[sourceIndex].push(value);\n                // if every buffer has at least one value in it, then we\n                // can shift out the oldest value from each buffer and emit\n                // them as an array.\n                if (buffers.every((buffer) => buffer.length)) {\n                  const result: any = buffers.map((buffer) => buffer.shift()!);\n                  // Emit the array. If theres' a result selector, use that.\n                  subscriber.next(resultSelector ? resultSelector(...result) : result);\n                  // If any one of the sources is both complete and has an empty buffer\n                  // then we complete the result. This is because we cannot possibly have\n                  // any more values to zip together.\n                  if (buffers.some((buffer, i) => !buffer.length && completed[i])) {\n                    subscriber.complete();\n                  }\n                }\n              },\n              () => {\n                // This source completed. Mark it as complete so we can check it later\n                // if we have to.\n                completed[sourceIndex] = true;\n                // But, if this complete source has nothing in its buffer, then we\n                // can complete the result, because we can't possibly have any more\n                // values from this to zip together with the other values.\n                !buffers[sourceIndex].length && subscriber.complete();\n              }\n            )\n          );\n        }\n\n        // When everything is done, release the arrays above.\n        return () => {\n          buffers = completed = null!;\n        };\n      })\n    : EMPTY;\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\n\nimport { operate } from '../util/lift';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Ignores source values for a duration determined by another Observable, then\n * emits the most recent value from the source Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link auditTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](audit.svg)\n *\n * `audit` is similar to `throttle`, but emits the last value from the silenced\n * time window, instead of the first value. `audit` emits the most recent value\n * from the source Observable on the output Observable as soon as its internal\n * timer becomes disabled, and ignores source values while the timer is enabled.\n * Initially, the timer is disabled. As soon as the first source value arrives,\n * the timer is enabled by calling the `durationSelector` function with the\n * source value, which returns the \"duration\" Observable. When the duration\n * Observable emits a value, the timer is disabled, then the most\n * recent source value is emitted on the output Observable, and this process\n * repeats for the next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, audit, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(audit(ev => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttle}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the silencing\n * duration, returned as an Observable or a Promise.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function audit<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    let durationSubscriber: Subscriber<any> | null = null;\n    let isComplete = false;\n\n    const endDuration = () => {\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n      isComplete && subscriber.complete();\n    };\n\n    const cleanupDuration = () => {\n      durationSubscriber = null;\n      isComplete && subscriber.complete();\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          lastValue = value;\n          if (!durationSubscriber) {\n            innerFrom(durationSelector(value)).subscribe(\n              (durationSubscriber = createOperatorSubscriber(subscriber, endDuration, cleanupDuration))\n            );\n          }\n        },\n        () => {\n          isComplete = true;\n          (!hasValue || !durationSubscriber || durationSubscriber.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { audit } from './audit';\nimport { timer } from '../observable/timer';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\n\n/**\n * Ignores source values for `duration` milliseconds, then emits the most recent\n * value from the source Observable, then repeats this process.\n *\n * <span class=\"informal\">When it sees a source value, it ignores that plus\n * the next ones for `duration` milliseconds, and then it emits the most recent\n * value from the source.</span>\n *\n * ![](auditTime.png)\n *\n * `auditTime` is similar to `throttleTime`, but emits the last value from the\n * silenced time window, instead of the first value. `auditTime` emits the most\n * recent value from the source Observable on the output Observable as soon as\n * its internal timer becomes disabled, and ignores source values while the\n * timer is enabled. Initially, the timer is disabled. As soon as the first\n * source value arrives, the timer is enabled. After `duration` milliseconds (or\n * the time unit determined internally by the optional `scheduler`) has passed,\n * the timer is disabled, then the most recent source value is emitted on the\n * output Observable, and this process repeats for the next source value.\n * Optionally takes a {@link SchedulerLike} for managing timers.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, auditTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(auditTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttleTime}\n *\n * @param {number} duration Time to wait before emitting the most recent source\n * value, measured in milliseconds or the time unit determined internally\n * by the optional `scheduler`.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the rate-limiting behavior.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function auditTime<T>(duration: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return audit(() => timer(duration, scheduler));\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { arrRemove } from '../util/arrRemove';\n\n/**\n * Buffers the source Observable values until the size hits the maximum\n * `bufferSize` given.\n *\n * <span class=\"informal\">Collects values from the past as an array, and emits\n * that array only when its size reaches `bufferSize`.</span>\n *\n * ![](bufferCount.png)\n *\n * Buffers a number of values from the source Observable by `bufferSize` then\n * emits the buffer and clears it, and starts a new buffer each\n * `startBufferEvery` values. If `startBufferEvery` is not provided or is\n * `null`, then new buffers are started immediately at the start of the source\n * and when each buffer closes and is emitted.\n *\n * ## Examples\n *\n * Emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * On every click, emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2, 1));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link buffer}\n * @see {@link bufferTime}\n * @see {@link bufferToggle}\n * @see {@link bufferWhen}\n * @see {@link pairwise}\n * @see {@link windowCount}\n *\n * @param {number} bufferSize The maximum size of the buffer emitted.\n * @param {number} [startBufferEvery] Interval at which to start a new buffer.\n * For example if `startBufferEvery` is `2`, then a new buffer will be started\n * on every other value from the source. A new buffer is started at the\n * beginning of the source by default.\n * @return A function that returns an Observable of arrays of buffered values.\n */\nexport function bufferCount<T>(bufferSize: number, startBufferEvery: number | null = null): OperatorFunction<T, T[]> {\n  // If no `startBufferEvery` value was supplied, then we're\n  // opening and closing on the bufferSize itself.\n  startBufferEvery = startBufferEvery ?? bufferSize;\n\n  return operate((source, subscriber) => {\n    let buffers: T[][] = [];\n    let count = 0;\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          let toEmit: T[][] | null = null;\n\n          // Check to see if we need to start a buffer.\n          // This will start one at the first value, and then\n          // a new one every N after that.\n          if (count++ % startBufferEvery! === 0) {\n            buffers.push([]);\n          }\n\n          // Push our value into our active buffers.\n          for (const buffer of buffers) {\n            buffer.push(value);\n            // Check to see if we're over the bufferSize\n            // if we are, record it so we can emit it later.\n            // If we emitted it now and removed it, it would\n            // mutate the `buffers` array while we're looping\n            // over it.\n            if (bufferSize <= buffer.length) {\n              toEmit = toEmit ?? [];\n              toEmit.push(buffer);\n            }\n          }\n\n          if (toEmit) {\n            // We have found some buffers that are over the\n            // `bufferSize`. Emit them, and remove them from our\n            // buffers list.\n            for (const buffer of toEmit) {\n              arrRemove(buffers, buffer);\n              subscriber.next(buffer);\n            }\n          }\n        },\n        () => {\n          // When the source completes, emit all of our\n          // active buffers.\n          for (const buffer of buffers) {\n            subscriber.next(buffer);\n          }\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Clean up our memory when we finalize\n          buffers = null!;\n        }\n      )\n    );\n  });\n}\n", "import { Observable } from '../Observable';\n\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { Subscription } from '../Subscription';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { operate } from '../util/lift';\n\n/* tslint:disable:max-line-length */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>>;\n/* tslint:enable:max-line-length */\n\n/**\n * Catches errors on the observable to be handled by returning a new observable or throwing an error.\n *\n * <span class=\"informal\">\n * It only listens to the error channel and ignores notifications.\n * Handles errors from the source observable, and maps them to a new observable.\n * The error may also be rethrown, or a new error can be thrown to emit an error from the result.\n * </span>\n *\n * ![](catch.png)\n *\n * This operator handles errors, but forwards along all other events to the resulting observable.\n * If the source observable terminates with an error, it will map that error to a new observable,\n * subscribe to it, and forward all of its events to the resulting observable.\n *\n * ## Examples\n *\n * Continue with a different Observable when there's an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => of('I', 'II', 'III', 'IV', 'V'))\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, I, II, III, IV, V\n * ```\n *\n * Retry the caught source Observable again in case of error, similar to `retry()` operator\n *\n * ```ts\n * import { of, map, catchError, take } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError((err, caught) => caught),\n *     take(30)\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, 1, 2, 3, ...\n * ```\n *\n * Throw a new error when the source Observable throws an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => {\n *       throw 'error in source. Details: ' + err;\n *     })\n *   )\n *   .subscribe({\n *     next: x => console.log(x),\n *     error: err => console.log(err)\n *   });\n *   // 1, 2, 3, error in source. Details: four!\n * ```\n *\n * @see {@link onErrorResumeNext}\n * @see {@link repeat}\n * @see {@link repeatWhen}\n * @see {@link retry }\n * @see {@link retryWhen}\n *\n * @param {function} selector a function that takes as arguments `err`, which is the error, and `caught`, which\n * is the source observable, in case you'd like to \"retry\" that observable by returning it again. Whatever observable\n * is returned by the `selector` will be used to continue the observable chain.\n * @return A function that returns an Observable that originates from either\n * the source or the Observable returned by the `selector` function.\n */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>> {\n  return operate((source, subscriber) => {\n    let innerSub: Subscription | null = null;\n    let syncUnsub = false;\n    let handledResult: Observable<ObservedValueOf<O>>;\n\n    innerSub = source.subscribe(\n      createOperatorSubscriber(subscriber, undefined, undefined, (err) => {\n        handledResult = innerFrom(selector(err, catchError(selector)(source)));\n        if (innerSub) {\n          innerSub.unsubscribe();\n          innerSub = null;\n          handledResult.subscribe(subscriber);\n        } else {\n          // We don't have an innerSub yet, that means the error was synchronous\n          // because the subscribe call hasn't returned yet.\n          syncUnsub = true;\n        }\n      })\n    );\n\n    if (syncUnsub) {\n      // We have a synchronous error, we need to make sure to\n      // finalize right away. This ensures that callbacks in the `finalize` operator are called\n      // at the right time, and that finalization occurs at the expected\n      // time between the source error and the subscription to the\n      // next observable.\n      innerSub.unsubscribe();\n      innerSub = null;\n      handledResult!.subscribe(subscriber);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A basic scan operation. This is used for `scan` and `reduce`.\n * @param accumulator The accumulator to use\n * @param seed The seed value for the state to accumulate\n * @param hasSeed Whether or not a seed was provided\n * @param emitOnNext Whether or not to emit the state on next\n * @param emitBeforeComplete Whether or not to emit the before completion\n */\n\nexport function scanInternals<V, A, S>(\n  accumulator: (acc: V | A | S, value: V, index: number) => A,\n  seed: S,\n  hasSeed: boolean,\n  emitOnNext: boolean,\n  emitBeforeComplete?: undefined | true\n) {\n  return (source: Observable<V>, subscriber: Subscriber<any>) => {\n    // Whether or not we have state yet. This will only be\n    // false before the first value arrives if we didn't get\n    // a seed value.\n    let hasState = hasSeed;\n    // The state that we're tracking, starting with the seed,\n    // if there is one, and then updated by the return value\n    // from the accumulator on each emission.\n    let state: any = seed;\n    // An index to pass to the accumulator function.\n    let index = 0;\n\n    // Subscribe to our source. All errors and completions are passed through.\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Always increment the index.\n          const i = index++;\n          // Set the state\n          state = hasState\n            ? // We already have state, so we can get the new state from the accumulator\n              accumulator(state, value, i)\n            : // We didn't have state yet, a seed value was not provided, so\n\n              // we set the state to the first value, and mark that we have state now\n              ((hasState = true), value);\n\n          // Maybe send it to the consumer.\n          emitOnNext && subscriber.next(state);\n        },\n        // If an onComplete was given, call it, otherwise\n        // just pass through the complete notification to the consumer.\n        emitBeforeComplete &&\n          (() => {\n            hasState && subscriber.next(state);\n            subscriber.complete();\n          })\n      )\n    );\n  };\n}\n", "import { combineLatestInit } from '../observable/combineLatest';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { pipe } from '../util/pipe';\nimport { popResultSelector } from '../util/args';\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  project: (...values: [T, ...A]) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  ...sourcesAndProject: [...ObservableInputTuple<A>, (...values: [T, ...A]) => R]\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/**\n * @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8.\n */\nexport function combineLatest<T, R>(...args: (ObservableInput<any> | ((...values: any[]) => R))[]): OperatorFunction<T, unknown> {\n  const resultSelector = popResultSelector(args);\n  return resultSelector\n    ? pipe(combineLatest(...(args as Array<ObservableInput<any>>)), mapOneOrManyArgs(resultSelector))\n    : operate((source, subscriber) => {\n        combineLatestInit([source, ...argsOrArgArray(args)])(subscriber);\n      });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { combineLatest } from './combineLatest';\n\n/**\n * Create an observable that combines the latest values from all passed observables and the source\n * into arrays and emits them.\n *\n * Returns an observable, that when subscribed to, will subscribe to the source observable and all\n * sources provided as arguments. Once all sources emit at least one value, all of the latest values\n * will be emitted as an array. After that, every time any source emits a value, all of the latest values\n * will be emitted as an array.\n *\n * This is a useful operator for eagerly calculating values based off of changed inputs.\n *\n * ## Example\n *\n * Simple concatenation of values from two inputs\n *\n * ```ts\n * import { fromEvent, combineLatestWith, map } from 'rxjs';\n *\n * // Setup: Add two inputs to the page\n * const input1 = document.createElement('input');\n * document.body.appendChild(input1);\n * const input2 = document.createElement('input');\n * document.body.appendChild(input2);\n *\n * // Get streams of changes\n * const input1Changes$ = fromEvent(input1, 'change');\n * const input2Changes$ = fromEvent(input2, 'change');\n *\n * // Combine the changes by adding them together\n * input1Changes$.pipe(\n *   combineLatestWith(input2Changes$),\n *   map(([e1, e2]) => (<HTMLInputElement>e1.target).value + ' - ' + (<HTMLInputElement>e2.target).value)\n * )\n * .subscribe(x => console.log(x));\n * ```\n *\n * @param otherSources the other sources to subscribe to.\n * @return A function that returns an Observable that emits the latest\n * emissions from both source and provided Observables.\n */\nexport function combineLatestWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, Cons<T, A>> {\n  return combineLatest(...otherSources);\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SchedulerAction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link delay}, but passes only the most\n * recent notification from each burst of emissions.</span>\n *\n * ![](debounceTime.png)\n *\n * `debounceTime` delays notifications emitted by the source Observable, but drops\n * previous pending delayed emissions if a new notification arrives on the source\n * Observable. This operator keeps track of the most recent notification from the\n * source Observable, and emits that only when `dueTime` has passed\n * without any other notification appearing on the source Observable. If a new value\n * appears before `dueTime` silence occurs, the previous notification will be dropped\n * and will not be emitted and a new `dueTime` is scheduled.\n * If the completing event happens during `dueTime` the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during `dueTime` or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * This is a rate-limiting operator, because it is impossible for more than one\n * notification to be emitted in any time window of duration `dueTime`, but it is also\n * a delay-like operator since output emissions do not occur at the same time as\n * they did on the source Observable. Optionally takes a {@link SchedulerLike} for\n * managing timers.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, debounceTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(debounceTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param {number} dueTime The timeout duration in milliseconds (or the time\n * unit determined internally by the optional `scheduler`) for the window of\n * time required to wait for emission silence before emitting the most recent\n * source value.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the timeout for each value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified `dueTime`, and may drop some values\n * if they occur too frequently.\n */\nexport function debounceTime<T>(dueTime: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let activeTask: Subscription | null = null;\n    let lastValue: T | null = null;\n    let lastTime: number | null = null;\n\n    const emit = () => {\n      if (activeTask) {\n        // We have a value! Free up memory first, then emit the value.\n        activeTask.unsubscribe();\n        activeTask = null;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n    function emitWhenIdle(this: SchedulerAction<unknown>) {\n      // This is called `dueTime` after the first value\n      // but we might have received new values during this window!\n\n      const targetTime = lastTime! + dueTime;\n      const now = scheduler.now();\n      if (now < targetTime) {\n        // On that case, re-schedule to the new target\n        activeTask = this.schedule(undefined, targetTime - now);\n        subscriber.add(activeTask);\n        return;\n      }\n\n      emit();\n    }\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          lastValue = value;\n          lastTime = scheduler.now();\n\n          // Only set up a task if it's not already up\n          if (!activeTask) {\n            activeTask = scheduler.schedule(emitWhenIdle, dueTime);\n            subscriber.add(activeTask);\n          }\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = activeTask = null;\n        }\n      )\n    );\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a given value if the source Observable completes without emitting any\n * `next` value, otherwise mirrors the source Observable.\n *\n * <span class=\"informal\">If the source Observable turns out to be empty, then\n * this operator will emit a default value.</span>\n *\n * ![](defaultIfEmpty.png)\n *\n * `defaultIfEmpty` emits the values emitted by the source Observable or a\n * specified default value if the source Observable is empty (completes without\n * having emitted any `next` value).\n *\n * ## Example\n *\n * If no clicks happen in 5 seconds, then emit 'no clicks'\n *\n * ```ts\n * import { fromEvent, takeUntil, interval, defaultIfEmpty } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksBeforeFive = clicks.pipe(takeUntil(interval(5000)));\n * const result = clicksBeforeFive.pipe(defaultIfEmpty('no clicks'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link empty}\n * @see {@link last}\n *\n * @param defaultValue The default value used if the source\n * Observable is empty.\n * @return A function that returns an Observable that emits either the\n * specified `defaultValue` if the source Observable emits no items, or the\n * values emitted by the source Observable.\n */\nexport function defaultIfEmpty<T, R>(defaultValue: R): OperatorFunction<T, T | R> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => {\n          if (!hasValue) {\n            subscriber.next(defaultValue!);\n          }\n          subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits only the first `count` values emitted by the source Observable.\n *\n * <span class=\"informal\">Takes the first `count` values from the source, then\n * completes.</span>\n *\n * ![](take.png)\n *\n * `take` returns an Observable that emits only the first `count` values emitted\n * by the source Observable. If the source emits fewer than `count` values then\n * all of its values are emitted. After that, it completes, regardless if the\n * source completes.\n *\n * ## Example\n *\n * Take the first 5 seconds of an infinite 1-second interval Observable\n *\n * ```ts\n * import { interval, take } from 'rxjs';\n *\n * const intervalCount = interval(1000);\n * const takeFive = intervalCount.pipe(take(5));\n * takeFive.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * ```\n *\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of `next` values to emit.\n * @return A function that returns an Observable that emits only the first\n * `count` values emitted by the source Observable, or all of the values from\n * the source if the source emits fewer than `count` values.\n */\nexport function take<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? // If we are taking no values, that's empty.\n      () => EMPTY\n    : operate((source, subscriber) => {\n        let seen = 0;\n        source.subscribe(\n          createOperatorSubscriber(subscriber, (value) => {\n            // Increment the number of values we have seen,\n            // then check it against the allowed count to see\n            // if we are still letting values through.\n            if (++seen <= count) {\n              subscriber.next(value);\n              // If we have met or passed our allowed count,\n              // we need to complete. We have to do <= here,\n              // because re-entrant code will increment `seen` twice.\n              if (count <= seen) {\n                subscriber.complete();\n              }\n            }\n          })\n        );\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { noop } from '../util/noop';\n\n/**\n * Ignores all items emitted by the source Observable and only passes calls of `complete` or `error`.\n *\n * ![](ignoreElements.png)\n *\n * The `ignoreElements` operator suppresses all items emitted by the source Observable,\n * but allows its termination notification (either `error` or `complete`) to pass through unchanged.\n *\n * If you do not care about the items being emitted by an Observable, but you do want to be notified\n * when it completes or when it terminates with an error, you can apply the `ignoreElements` operator\n * to the Observable, which will ensure that it will never call its observers\u2019 `next` handlers.\n *\n * ## Example\n *\n * Ignore all `next` emissions from the source\n *\n * ```ts\n * import { of, ignoreElements } from 'rxjs';\n *\n * of('you', 'talking', 'to', 'me')\n *   .pipe(ignoreElements())\n *   .subscribe({\n *     next: word => console.log(word),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // result:\n * // 'the end'\n * ```\n *\n * @return A function that returns an empty Observable that only calls\n * `complete` or `error`, based on which one is called by the source\n * Observable.\n */\nexport function ignoreElements(): OperatorFunction<unknown, never> {\n  return operate((source, subscriber) => {\n    source.subscribe(createOperatorSubscriber(subscriber, noop));\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { map } from './map';\n\n/** @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R>;\n/**\n * @deprecated Do not specify explicit type parameters. Signatures with type parameters\n * that cannot be inferred will be removed in v8. `mapTo` itself will be removed in v9,\n * use {@link map} instead: `map(() => value)`.\n * */\nexport function mapTo<T, R>(value: R): OperatorFunction<T, R>;\n\n/**\n * Emits the given constant value on the output Observable every time the source\n * Observable emits a value.\n *\n * <span class=\"informal\">Like {@link map}, but it maps every source value to\n * the same output value every time.</span>\n *\n * ![](mapTo.png)\n *\n * Takes a constant `value` as argument, and emits that whenever the source\n * Observable emits a value. In other words, ignores the actual source value,\n * and simply uses the emission moment to know when to emit the given `value`.\n *\n * ## Example\n *\n * Map every click to the string `'Hi'`\n *\n * ```ts\n * import { fromEvent, mapTo } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const greetings = clicks.pipe(mapTo('Hi'));\n *\n * greetings.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link map}\n *\n * @param value The value to map each source value to.\n * @return A function that returns an Observable that emits the given `value`\n * every time the source Observable emits.\n * @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`.\n */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R> {\n  return map(() => value);\n}\n", "import { Observable } from '../Observable';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { concat } from '../observable/concat';\nimport { take } from './take';\nimport { ignoreElements } from './ignoreElements';\nimport { mapTo } from './mapTo';\nimport { mergeMap } from './mergeMap';\nimport { innerFrom } from '../observable/innerFrom';\n\n/** @deprecated The `subscriptionDelay` parameter will be removed in v8. */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay: Observable<any>\n): MonoTypeOperatorFunction<T>;\nexport function delayWhen<T>(delayDurationSelector: (value: T, index: number) => ObservableInput<any>): MonoTypeOperatorFunction<T>;\n\n/**\n * Delays the emission of items from the source Observable by a given time span\n * determined by the emissions of another Observable.\n *\n * <span class=\"informal\">It's like {@link delay}, but the time span of the\n * delay duration is determined by a second Observable.</span>\n *\n * ![](delayWhen.png)\n *\n * `delayWhen` operator shifts each emitted value from the source Observable by\n * a time span determined by another Observable. When the source emits a value,\n * the `delayDurationSelector` function is called with the value emitted from\n * the source Observable as the first argument to the `delayDurationSelector`.\n * The `delayDurationSelector` function should return an {@link ObservableInput},\n * that is internally converted to an Observable that is called the \"duration\"\n * Observable.\n *\n * The source value is emitted on the output Observable only when the \"duration\"\n * Observable emits ({@link guide/glossary-and-semantics#next next}s) any value.\n * Upon that, the \"duration\" Observable gets unsubscribed.\n *\n * Before RxJS V7, the {@link guide/glossary-and-semantics#complete completion}\n * of the \"duration\" Observable would have been triggering the emission of the\n * source value to the output Observable, but with RxJS V7, this is not the case\n * anymore.\n *\n * Only next notifications (from the \"duration\" Observable) trigger values from\n * the source Observable to be passed to the output Observable. If the \"duration\"\n * Observable only emits the complete notification (without next), the value\n * emitted by the source Observable will never get to the output Observable - it\n * will be swallowed. If the \"duration\" Observable errors, the error will be\n * propagated to the output Observable.\n *\n * Optionally, `delayWhen` takes a second argument, `subscriptionDelay`, which\n * is an Observable. When `subscriptionDelay` emits its first value or\n * completes, the source Observable is subscribed to and starts behaving like\n * described in the previous paragraph. If `subscriptionDelay` is not provided,\n * `delayWhen` will subscribe to the source Observable as soon as the output\n * Observable is subscribed.\n *\n * ## Example\n *\n * Delay each click by a random amount of time, between 0 and 5 seconds\n *\n * ```ts\n * import { fromEvent, delayWhen, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(\n *   delayWhen(() => interval(Math.random() * 5000))\n * );\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delay}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param delayDurationSelector A function that returns an `ObservableInput` for\n * each `value` emitted by the source Observable, which is then used to delay the\n * emission of that `value` on the output Observable until the `ObservableInput`\n * returned from this function emits a next value. When called, beside `value`,\n * this function receives a zero-based `index` of the emission order.\n * @param subscriptionDelay An Observable that triggers the subscription to the\n * source Observable once it emits any value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by an amount of time specified by the Observable\n * returned by `delayDurationSelector`.\n */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay?: Observable<any>\n): MonoTypeOperatorFunction<T> {\n  if (subscriptionDelay) {\n    // DEPRECATED PATH\n    return (source: Observable<T>) =>\n      concat(subscriptionDelay.pipe(take(1), ignoreElements()), source.pipe(delayWhen(delayDurationSelector)));\n  }\n\n  return mergeMap((value, index) => innerFrom(delayDurationSelector(value, index)).pipe(take(1), mapTo(value)));\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { delayWhen } from './delayWhen';\nimport { timer } from '../observable/timer';\n\n/**\n * Delays the emission of items from the source Observable by a given timeout or\n * until a given Date.\n *\n * <span class=\"informal\">Time shifts each item by some specified amount of\n * milliseconds.</span>\n *\n * ![](delay.svg)\n *\n * If the delay argument is a Number, this operator time shifts the source\n * Observable by that amount of time expressed in milliseconds. The relative\n * time intervals between the values are preserved.\n *\n * If the delay argument is a Date, this operator time shifts the start of the\n * Observable execution until the given date occurs.\n *\n * ## Examples\n *\n * Delay each click by one second\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(delay(1000)); // each click emitted after 1 second\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * Delay all clicks until a future date happens\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const date = new Date('March 15, 2050 12:00:00'); // in the future\n * const delayedClicks = clicks.pipe(delay(date)); // click emitted only after that date\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delayWhen}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param {number|Date} due The delay duration in milliseconds (a `number`) or\n * a `Date` until which the emission of the source items is delayed.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the time-shift for each item.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified timeout or Date.\n */\nexport function delay<T>(due: number | Date, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  const duration = timer(due, scheduler);\n  return delayWhen(() => duration);\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { identity } from '../util/identity';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function distinctUntilChanged<T>(comparator?: (previous: T, current: T) => boolean): MonoTypeOperatorFunction<T>;\nexport function distinctUntilChanged<T, K>(\n  comparator: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a result {@link Observable} that emits all values pushed by the source observable if they\n * are distinct in comparison to the last value the result observable emitted.\n *\n * When provided without parameters or with the first parameter (`{@link distinctUntilChanged#comparator comparator}`),\n * it behaves like this:\n *\n * 1. It will always emit the first value from the source.\n * 2. For all subsequent values pushed by the source, they will be compared to the previously emitted values\n *    using the provided `comparator` or an `===` equality check.\n * 3. If the value pushed by the source is determined to be unequal by this check, that value is emitted and\n *    becomes the new \"previously emitted value\" internally.\n *\n * When the second parameter (`{@link distinctUntilChanged#keySelector keySelector}`) is provided, the behavior\n * changes:\n *\n * 1. It will always emit the first value from the source.\n * 2. The `keySelector` will be run against all values, including the first value.\n * 3. For all values after the first, the selected key will be compared against the key selected from\n *    the previously emitted value using the `comparator`.\n * 4. If the keys are determined to be unequal by this check, the value (not the key), is emitted\n *    and the selected key from that value is saved for future comparisons against other keys.\n *\n * ## Examples\n *\n * A very basic example with no `{@link distinctUntilChanged#comparator comparator}`. Note that `1` is emitted more than once,\n * because it's distinct in comparison to the _previously emitted_ value,\n * not in comparison to _all other emitted values_.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * of(1, 1, 1, 2, 2, 2, 1, 1, 3, 3)\n *   .pipe(distinctUntilChanged())\n *   .subscribe(console.log);\n * // Logs: 1, 2, 1, 3\n * ```\n *\n * With a `{@link distinctUntilChanged#comparator comparator}`, you can do custom comparisons. Let's say\n * you only want to emit a value when all of its components have\n * changed:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const totallyDifferentBuilds$ = of(\n *   { engineVersion: '1.1.0', transmissionVersion: '1.2.0' },\n *   { engineVersion: '1.1.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.5.0' },\n *   { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ).pipe(\n *   distinctUntilChanged((prev, curr) => {\n *     return (\n *       prev.engineVersion === curr.engineVersion ||\n *       prev.transmissionVersion === curr.transmissionVersion\n *     );\n *   })\n * );\n *\n * totallyDifferentBuilds$.subscribe(console.log);\n *\n * // Logs:\n * // { engineVersion: '1.1.0', transmissionVersion: '1.2.0' }\n * // { engineVersion: '1.3.0', transmissionVersion: '1.4.0' }\n * // { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ```\n *\n * You can also provide a custom `{@link distinctUntilChanged#comparator comparator}` to check that emitted\n * changes are only in one direction. Let's say you only want to get\n * the next record temperature:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const temps$ = of(30, 31, 20, 34, 33, 29, 35, 20);\n *\n * const recordHighs$ = temps$.pipe(\n *   distinctUntilChanged((prevHigh, temp) => {\n *     // If the current temp is less than\n *     // or the same as the previous record,\n *     // the record hasn't changed.\n *     return temp <= prevHigh;\n *   })\n * );\n *\n * recordHighs$.subscribe(console.log);\n * // Logs: 30, 31, 34, 35\n * ```\n *\n * Selecting update events only when the `updatedBy` field shows\n * the account changed hands.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * // A stream of updates to a given account\n * const accountUpdates$ = of(\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'blesh', data: [] }\n * );\n *\n * // We only want the events where it changed hands\n * const changedHands$ = accountUpdates$.pipe(\n *   distinctUntilChanged(undefined, update => update.updatedBy)\n * );\n *\n * changedHands$.subscribe(console.log);\n * // Logs:\n * // { updatedBy: 'blesh', data: Array[0] }\n * // { updatedBy: 'ncjamieson', data: Array[0] }\n * // { updatedBy: 'blesh', data: Array[0] }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilKeyChanged}\n *\n * @param comparator A function used to compare the previous and current keys for\n * equality. Defaults to a `===` check.\n * @param keySelector Used to select a key value to be passed to the `comparator`.\n *\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values.\n */\nexport function distinctUntilChanged<T, K>(\n  comparator?: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K = identity as (value: T) => K\n): MonoTypeOperatorFunction<T> {\n  // We've been allowing `null` do be passed as the `compare`, so we can't do\n  // a default value for the parameter, because that will only work\n  // for `undefined`.\n  comparator = comparator ?? defaultCompare;\n\n  return operate((source, subscriber) => {\n    // The previous key, used to compare against keys selected\n    // from new arrivals to determine \"distinctiveness\".\n    let previousKey: K;\n    // Whether or not this is the first value we've gotten.\n    let first = true;\n\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        // We always call the key selector.\n        const currentKey = keySelector(value);\n\n        // If it's the first value, we always emit it.\n        // Otherwise, we compare this key to the previous key, and\n        // if the comparer returns false, we emit.\n        if (first || !comparator!(previousKey, currentKey)) {\n          // Update our state *before* we emit the value\n          // as emission can be the source of re-entrant code\n          // in functional libraries like this. We only really\n          // need to do this if it's the first value, or if the\n          // key we're tracking in previous needs to change.\n          first = false;\n          previousKey = currentKey;\n\n          // Emit the value!\n          subscriber.next(value);\n        }\n      })\n    );\n  });\n}\n\nfunction defaultCompare(a: any, b: any) {\n  return a === b;\n}\n", "import { distinctUntilChanged } from './distinctUntilChanged';\nimport { MonoTypeOperatorFunction } from '../types';\n\n/* tslint:disable:max-line-length */\nexport function distinctUntilKeyChanged<T>(key: keyof T): MonoTypeOperatorFunction<T>;\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Returns an Observable that emits all items emitted by the source Observable that are distinct by comparison from the previous item,\n * using a property accessed by using the key provided to check if the two items are distinct.\n *\n * If a comparator function is provided, then it will be called for each item to test for whether or not that value should be emitted.\n *\n * If a comparator function is not provided, an equality check is used by default.\n *\n * ## Examples\n *\n * An example comparing the name of persons\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo' },\n *   { age: 6, name: 'Foo' }\n * ).pipe(\n *   distinctUntilKeyChanged('name')\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo' }\n * ```\n *\n * An example comparing the first letters of the name\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo1' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo2' },\n *   { age: 6, name: 'Foo3' }\n * ).pipe(\n *   distinctUntilKeyChanged('name', (x, y) => x.substring(0, 3) === y.substring(0, 3))\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo1' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo2' }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n *\n * @param {string} key String key for object property lookup on each item.\n * @param {function} [compare] Optional comparison function called to test if an item is distinct from the previous item in the source.\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values based on the key specified.\n */\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare?: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T> {\n  return distinctUntilChanged((x: T, y: T) => compare ? compare(x[key], y[key]) : x[key] === y[key]);\n}\n", "import { EmptyError } from '../util/EmptyError';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * If the source observable completes without emitting a value, it will emit\n * an error. The error will be created at that time by the optional\n * `errorFactory` argument, otherwise, the error will be {@link EmptyError}.\n *\n * ![](throwIfEmpty.png)\n *\n * ## Example\n *\n * Throw an error if the document wasn't clicked within 1 second\n *\n * ```ts\n * import { fromEvent, takeUntil, timer, throwIfEmpty } from 'rxjs';\n *\n * const click$ = fromEvent(document, 'click');\n *\n * click$.pipe(\n *   takeUntil(timer(1000)),\n *   throwIfEmpty(() => new Error('The document was not clicked within 1 second'))\n * )\n * .subscribe({\n *   next() {\n *    console.log('The document was clicked');\n *   },\n *   error(err) {\n *     console.error(err.message);\n *   }\n * });\n * ```\n *\n * @param errorFactory A factory function called to produce the\n * error to be thrown when the source observable completes without emitting a\n * value.\n * @return A function that returns an Observable that throws an error if the\n * source Observable completed without emitting.\n */\nexport function throwIfEmpty<T>(errorFactory: () => any = defaultErrorFactory): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => (hasValue ? subscriber.complete() : subscriber.error(errorFactory()))\n      )\n    );\n  });\n}\n\nfunction defaultErrorFactory() {\n  return new EmptyError();\n}\n", "/** prettier */\nimport { Observable } from '../Observable';\nimport { concat } from '../observable/concat';\nimport { of } from '../observable/of';\nimport { MonoTypeOperatorFunction, SchedulerLike, OperatorFunction, ValueFromArray } from '../types';\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T>(scheduler: SchedulerLike): MonoTypeOperatorFunction<T>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T, A extends unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\n\nexport function endWith<T, A extends unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that will emit all values from the source, then synchronously emit\n * the provided value(s) immediately after the source completes.\n *\n * NOTE: Passing a last argument of a Scheduler is _deprecated_, and may result in incorrect\n * types in TypeScript.\n *\n * This is useful for knowing when an observable ends. Particularly when paired with an\n * operator like {@link takeUntil}\n *\n * ![](endWith.png)\n *\n * ## Example\n *\n * Emit values to know when an interval starts and stops. The interval will\n * stop when a user clicks anywhere on the document.\n *\n * ```ts\n * import { interval, map, fromEvent, startWith, takeUntil, endWith } from 'rxjs';\n *\n * const ticker$ = interval(5000).pipe(\n *   map(() => 'tick')\n * );\n *\n * const documentClicks$ = fromEvent(document, 'click');\n *\n * ticker$.pipe(\n *   startWith('interval started'),\n *   takeUntil(documentClicks$),\n *   endWith('interval ended by click')\n * )\n * .subscribe(x => console.log(x));\n *\n * // Result (assuming a user clicks after 15 seconds)\n * // 'interval started'\n * // 'tick'\n * // 'tick'\n * // 'tick'\n * // 'interval ended by click'\n * ```\n *\n * @see {@link startWith}\n * @see {@link concat}\n * @see {@link takeUntil}\n *\n * @param values Items you want the modified Observable to emit last.\n * @return A function that returns an Observable that emits all values from the\n * source, then synchronously emits the provided value(s) immediately after the\n * source completes.\n */\nexport function endWith<T>(...values: Array<T | SchedulerLike>): MonoTypeOperatorFunction<T> {\n  return (source: Observable<T>) => concat(source, of(...values)) as Observable<T>;\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Returns an Observable that mirrors the source Observable, but will call a specified function when\n * the source terminates on complete or error.\n * The specified function will also be called when the subscriber explicitly unsubscribes.\n *\n * ## Examples\n *\n * Execute callback function when the observable completes\n *\n * ```ts\n * import { interval, take, finalize } from 'rxjs';\n *\n * // emit value in sequence every 1 second\n * const source = interval(1000);\n * const example = source.pipe(\n *   take(5), //take only the first 5 values\n *   finalize(() => console.log('Sequence complete')) // Execute when the observable completes\n * );\n * const subscribe = example.subscribe(val => console.log(val));\n *\n * // results:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * // 'Sequence complete'\n * ```\n *\n * Execute callback function when the subscriber explicitly unsubscribes\n *\n * ```ts\n * import { interval, finalize, tap, noop, timer } from 'rxjs';\n *\n * const source = interval(100).pipe(\n *   finalize(() => console.log('[finalize] Called')),\n *   tap({\n *     next: () => console.log('[next] Called'),\n *     error: () => console.log('[error] Not called'),\n *     complete: () => console.log('[tap complete] Not called')\n *   })\n * );\n *\n * const sub = source.subscribe({\n *   next: x => console.log(x),\n *   error: noop,\n *   complete: () => console.log('[complete] Not called')\n * });\n *\n * timer(150).subscribe(() => sub.unsubscribe());\n *\n * // results:\n * // '[next] Called'\n * // 0\n * // '[finalize] Called'\n * ```\n *\n * @param {function} callback Function to be called when source terminates.\n * @return A function that returns an Observable that mirrors the source, but\n * will call the specified function on termination.\n */\nexport function finalize<T>(callback: () => void): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // TODO: This try/finally was only added for `useDeprecatedSynchronousErrorHandling`.\n    // REMOVE THIS WHEN THAT HOT GARBAGE IS REMOVED IN V8.\n    try {\n      source.subscribe(subscriber);\n    } finally {\n      subscriber.add(callback);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { EmptyError } from '../util/EmptyError';\nimport { OperatorFunction, TruthyTypesOf } from '../types';\nimport { filter } from './filter';\nimport { take } from './take';\nimport { defaultIfEmpty } from './defaultIfEmpty';\nimport { throwIfEmpty } from './throwIfEmpty';\nimport { identity } from '../util/identity';\n\nexport function first<T, D = T>(predicate?: null, defaultValue?: D): OperatorFunction<T, T | D>;\nexport function first<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function first<T, D>(predicate: BooleanConstructor, defaultValue: D): OperatorFunction<T, TruthyTypesOf<T> | D>;\nexport function first<T, S extends T>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue?: S\n): OperatorFunction<T, S>;\nexport function first<T, S extends T, D>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue: D\n): OperatorFunction<T, S | D>;\nexport function first<T, D = T>(\n  predicate: (value: T, index: number, source: Observable<T>) => boolean,\n  defaultValue?: D\n): OperatorFunction<T, T | D>;\n\n/**\n * Emits only the first value (or the first value that meets some condition)\n * emitted by the source Observable.\n *\n * <span class=\"informal\">Emits only the first value. Or emits only the first\n * value that passes some test.</span>\n *\n * ![](first.png)\n *\n * If called with no arguments, `first` emits the first value of the source\n * Observable, then completes. If called with a `predicate` function, `first`\n * emits the first value of the source that matches the specified condition. Throws an error if\n * `defaultValue` was not provided and a matching element is not found.\n *\n * ## Examples\n *\n * Emit only the first click that happens on the DOM\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first());\n * result.subscribe(x => console.log(x));\n * ```\n *\n * Emits the first click that happens on a DIV\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link filter}\n * @see {@link find}\n * @see {@link take}\n *\n * @throws {EmptyError} Delivers an EmptyError to the Observer's `error`\n * callback if the Observable completes before any `next` notification was sent.\n * This is how `first()` is different from {@link take}(1) which completes instead.\n *\n * @param {function(value: T, index: number, source: Observable<T>): boolean} [predicate]\n * An optional function called with each item to test for condition matching.\n * @param {D} [defaultValue] The default value emitted in case no valid value\n * was found on the source.\n * @return A function that returns an Observable that emits the first item that\n * matches the condition.\n */\nexport function first<T, D>(\n  predicate?: ((value: T, index: number, source: Observable<T>) => boolean) | null,\n  defaultValue?: D\n): OperatorFunction<T, T | D> {\n  const hasDefaultValue = arguments.length >= 2;\n  return (source: Observable<T>) =>\n    source.pipe(\n      predicate ? filter((v, i) => predicate(v, i, source)) : identity,\n      take(1),\n      hasDefaultValue ? defaultIfEmpty(defaultValue!) : throwIfEmpty(() => new EmptyError())\n    );\n}\n", "import { EMPTY } from '../observable/empty';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Waits for the source to complete, then emits the last N values from the source,\n * as specified by the `count` argument.\n *\n * ![](takeLast.png)\n *\n * `takeLast` results in an observable that will hold values up to `count` values in memory,\n * until the source completes. It then pushes all values in memory to the consumer, in the\n * order they were received from the source, then notifies the consumer that it is\n * complete.\n *\n * If for some reason the source completes before the `count` supplied to `takeLast` is reached,\n * all values received until that point are emitted, and then completion is notified.\n *\n * **Warning**: Using `takeLast` with an observable that never completes will result\n * in an observable that never emits a value.\n *\n * ## Example\n *\n * Take the last 3 values of an Observable with many values\n *\n * ```ts\n * import { range, takeLast } from 'rxjs';\n *\n * const many = range(1, 100);\n * const lastThree = many.pipe(takeLast(3));\n * lastThree.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of values to emit from the end of\n * the sequence of values emitted by the source Observable.\n * @return A function that returns an Observable that emits at most the last\n * `count` values emitted by the source Observable.\n */\nexport function takeLast<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        // This buffer will hold the values we are going to emit\n        // when the source completes. Since we only want to take the\n        // last N values, we can't emit until we're sure we're not getting\n        // any more values.\n        let buffer: T[] = [];\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              // Add the most recent value onto the end of our buffer.\n              buffer.push(value);\n              // If our buffer is now larger than the number of values we\n              // want to take, we remove the oldest value from the buffer.\n              count < buffer.length && buffer.shift();\n            },\n            () => {\n              // The source completed, we now know what are last values\n              // are, emit them in the order they were received.\n              for (const value of buffer) {\n                subscriber.next(value);\n              }\n              subscriber.complete();\n            },\n            // Errors are passed through to the consumer\n            undefined,\n            () => {\n              // During finalization release the values in our buffer.\n              buffer = null!;\n            }\n          )\n        );\n      });\n}\n", "import { ObservableInput, ObservableInputTuple, OperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mergeAll } from './mergeAll';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from '../observable/from';\n\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrency: [...ObservableInputTuple<A>, number]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n\nexport function merge<T>(...args: unknown[]): OperatorFunction<T, unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  args = argsOrArgArray(args);\n\n  return operate((source, subscriber) => {\n    mergeAll(concurrent)(from([source, ...(args as ObservableInput<T>[])], scheduler)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction } from '../types';\nimport { merge } from './merge';\n\n/**\n * Merge the values from all observables to a single observable result.\n *\n * Creates an observable, that when subscribed to, subscribes to the source\n * observable, and all other sources provided as arguments. All values from\n * every source are emitted from the resulting subscription.\n *\n * When all sources complete, the resulting observable will complete.\n *\n * When any source errors, the resulting observable will error.\n *\n * ## Example\n *\n * Joining all outputs from multiple user input event streams\n *\n * ```ts\n * import { fromEvent, map, mergeWith } from 'rxjs';\n *\n * const clicks$ = fromEvent(document, 'click').pipe(map(() => 'click'));\n * const mousemoves$ = fromEvent(document, 'mousemove').pipe(map(() => 'mousemove'));\n * const dblclicks$ = fromEvent(document, 'dblclick').pipe(map(() => 'dblclick'));\n *\n * mousemoves$\n *   .pipe(mergeWith(clicks$, dblclicks$))\n *   .subscribe(x => console.log(x));\n *\n * // result (assuming user interactions)\n * // 'mousemove'\n * // 'mousemove'\n * // 'mousemove'\n * // 'click'\n * // 'click'\n * // 'dblclick'\n * ```\n *\n * @see {@link merge}\n *\n * @param otherSources the sources to combine the current source with.\n * @return A function that returns an Observable that merges the values from\n * all given Observables.\n */\nexport function mergeWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, T | A[number]> {\n  return merge(...otherSources);\n}\n", "import { Subscription } from '../Subscription';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { timer } from '../observable/timer';\n\nexport interface RepeatConfig {\n  /**\n   * The number of times to repeat the source. Defaults to `Infinity`.\n   */\n  count?: number;\n\n  /**\n   * If a `number`, will delay the repeat of the source by that number of milliseconds.\n   * If a function, it will provide the number of times the source has been subscribed to,\n   * and the return value should be a valid observable input that will notify when the source\n   * should be repeated. If the notifier observable is empty, the result will complete.\n   */\n  delay?: number | ((count: number) => ObservableInput<any>);\n}\n\n/**\n * Returns an Observable that will resubscribe to the source stream when the source stream completes.\n *\n * <span class=\"informal\">Repeats all values emitted on the source. It's like {@link retry}, but for non error cases.</span>\n *\n * ![](repeat.png)\n *\n * Repeat will output values from a source until the source completes, then it will resubscribe to the\n * source a specified number of times, with a specified delay. Repeat can be particularly useful in\n * combination with closing operators like {@link take}, {@link takeUntil}, {@link first}, or {@link takeWhile},\n * as it can be used to restart a source again from scratch.\n *\n * Repeat is very similar to {@link retry}, where {@link retry} will resubscribe to the source in the error case, but\n * `repeat` will resubscribe if the source completes.\n *\n * Note that `repeat` will _not_ catch errors. Use {@link retry} for that.\n *\n * - `repeat(0)` returns an empty observable\n * - `repeat()` will repeat forever\n * - `repeat({ delay: 200 })` will repeat forever, with a delay of 200ms between repetitions.\n * - `repeat({ count: 2, delay: 400 })` will repeat twice, with a delay of 400ms between repetitions.\n * - `repeat({ delay: (count) => timer(count * 1000) })` will repeat forever, but will have a delay that grows by one second for each repetition.\n *\n * ## Example\n *\n * Repeat a message stream\n *\n * ```ts\n * import { of, repeat } from 'rxjs';\n *\n * const source = of('Repeat message');\n * const result = source.pipe(repeat(3));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results\n * // 'Repeat message'\n * // 'Repeat message'\n * // 'Repeat message'\n * ```\n *\n * Repeat 3 values, 2 times\n *\n * ```ts\n * import { interval, take, repeat } from 'rxjs';\n *\n * const source = interval(1000);\n * const result = source.pipe(take(3), repeat(2));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results every second\n * // 0\n * // 1\n * // 2\n * // 0\n * // 1\n * // 2\n * ```\n *\n * Defining two complex repeats with delays on the same source.\n * Note that the second repeat cannot be called until the first\n * repeat as exhausted it's count.\n *\n * ```ts\n * import { defer, of, repeat } from 'rxjs';\n *\n * const source = defer(() => {\n *    return of(`Hello, it is ${new Date()}`)\n * });\n *\n * source.pipe(\n *    // Repeat 3 times with a delay of 1 second between repetitions\n *    repeat({\n *      count: 3,\n *      delay: 1000,\n *    }),\n *\n *    // *Then* repeat forever, but with an exponential step-back\n *    // maxing out at 1 minute.\n *    repeat({\n *      delay: (count) => timer(Math.min(60000, 2 ^ count * 1000))\n *    })\n * )\n * ```\n *\n * @see {@link repeatWhen}\n * @see {@link retry}\n *\n * @param count The number of times the source Observable items are repeated, a count of 0 will yield\n * an empty Observable.\n */\nexport function repeat<T>(countOrConfig?: number | RepeatConfig): MonoTypeOperatorFunction<T> {\n  let count = Infinity;\n  let delay: RepeatConfig['delay'];\n\n  if (countOrConfig != null) {\n    if (typeof countOrConfig === 'object') {\n      ({ count = Infinity, delay } = countOrConfig);\n    } else {\n      count = countOrConfig;\n    }\n  }\n\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        let soFar = 0;\n        let sourceSub: Subscription | null;\n\n        const resubscribe = () => {\n          sourceSub?.unsubscribe();\n          sourceSub = null;\n          if (delay != null) {\n            const notifier = typeof delay === 'number' ? timer(delay) : innerFrom(delay(soFar));\n            const notifierSubscriber = createOperatorSubscriber(subscriber, () => {\n              notifierSubscriber.unsubscribe();\n              subscribeToSource();\n            });\n            notifier.subscribe(notifierSubscriber);\n          } else {\n            subscribeToSource();\n          }\n        };\n\n        const subscribeToSource = () => {\n          let syncUnsub = false;\n          sourceSub = source.subscribe(\n            createOperatorSubscriber(subscriber, undefined, () => {\n              if (++soFar < count) {\n                if (sourceSub) {\n                  resubscribe();\n                } else {\n                  syncUnsub = true;\n                }\n              } else {\n                subscriber.complete();\n              }\n            })\n          );\n\n          if (syncUnsub) {\n            resubscribe();\n          }\n        };\n\n        subscribeToSource();\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { scanInternals } from './scanInternals';\n\nexport function scan<V, A = V>(accumulator: (acc: A | V, value: V, index: number) => A): OperatorFunction<V, V | A>;\nexport function scan<V, A>(accumulator: (acc: A, value: V, index: number) => A, seed: A): OperatorFunction<V, A>;\nexport function scan<V, A, S>(accumulator: (acc: A | S, value: V, index: number) => A, seed: S): OperatorFunction<V, A>;\n\n// TODO: link to a \"redux pattern\" section in the guide (location TBD)\n\n/**\n * Useful for encapsulating and managing state. Applies an accumulator (or \"reducer function\")\n * to each value from the source after an initial state is established -- either via\n * a `seed` value (second argument), or from the first value from the source.\n *\n * <span class=\"informal\">It's like {@link reduce}, but emits the current\n * accumulation state after each update</span>\n *\n * ![](scan.png)\n *\n * This operator maintains an internal state and emits it after processing each value as follows:\n *\n * 1. First value arrives\n *   - If a `seed` value was supplied (as the second argument to `scan`), let `state = seed` and `value = firstValue`.\n *   - If NO `seed` value was supplied (no second argument), let `state = firstValue` and go to 3.\n * 2. Let `state = accumulator(state, value)`.\n *   - If an error is thrown by `accumulator`, notify the consumer of an error. The process ends.\n * 3. Emit `state`.\n * 4. Next value arrives, let `value = nextValue`, go to 2.\n *\n * ## Examples\n *\n * An average of previous numbers. This example shows how\n * not providing a `seed` can prime the stream with the\n * first value from the source.\n *\n * ```ts\n * import { of, scan, map } from 'rxjs';\n *\n * const numbers$ = of(1, 2, 3);\n *\n * numbers$\n *   .pipe(\n *     // Get the sum of the numbers coming in.\n *     scan((total, n) => total + n),\n *     // Get the average by dividing the sum by the total number\n *     // received so far (which is 1 more than the zero-based index).\n *     map((sum, index) => sum / (index + 1))\n *   )\n *   .subscribe(console.log);\n * ```\n *\n * The Fibonacci sequence. This example shows how you can use\n * a seed to prime accumulation process. Also... you know... Fibonacci.\n * So important to like, computers and stuff that its whiteboarded\n * in job interviews. Now you can show them the Rx version! (Please don't, haha)\n *\n * ```ts\n * import { interval, scan, map, startWith } from 'rxjs';\n *\n * const firstTwoFibs = [0, 1];\n * // An endless stream of Fibonacci numbers.\n * const fibonacci$ = interval(1000).pipe(\n *   // Scan to get the fibonacci numbers (after 0, 1)\n *   scan(([a, b]) => [b, a + b], firstTwoFibs),\n *   // Get the second number in the tuple, it's the one you calculated\n *   map(([, n]) => n),\n *   // Start with our first two digits :)\n *   startWith(...firstTwoFibs)\n * );\n *\n * fibonacci$.subscribe(console.log);\n * ```\n *\n * @see {@link expand}\n * @see {@link mergeScan}\n * @see {@link reduce}\n * @see {@link switchScan}\n *\n * @param accumulator A \"reducer function\". This will be called for each value after an initial state is\n * acquired.\n * @param seed The initial state. If this is not provided, the first value from the source will\n * be used as the initial state, and emitted without going through the accumulator. All subsequent values\n * will be processed by the accumulator function. If this is provided, all values will go through\n * the accumulator function.\n * @return A function that returns an Observable of the accumulated values.\n */\nexport function scan<V, A, S>(accumulator: (acc: V | A | S, value: V, index: number) => A, seed?: S): OperatorFunction<V, V | A> {\n  // providing a seed of `undefined` *should* be valid and trigger\n  // hasSeed! so don't use `seed !== undefined` checks!\n  // For this reason, we have to check it here at the original call site\n  // otherwise inside Operator/Subscriber we won't know if `undefined`\n  // means they didn't provide anything or if they literally provided `undefined`\n  return operate(scanInternals(accumulator, seed as S, arguments.length >= 2, true));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Subject } from '../Subject';\nimport { SafeSubscriber } from '../Subscriber';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SubjectLike, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\n\nexport interface ShareConfig<T> {\n  /**\n   * The factory used to create the subject that will connect the source observable to\n   * multicast consumers.\n   */\n  connector?: () => SubjectLike<T>;\n  /**\n   * If `true`, the resulting observable will reset internal state on error from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"retried\" in the event of an error.\n   * If `false`, when an error comes from the source it will push the error into the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent retries\n   * or resubscriptions will resubscribe to that same subject. In all cases, RxJS subjects will emit the same error again, however\n   * {@link ReplaySubject} will also push its buffered values before pushing the error.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnError?: boolean | ((error: any) => ObservableInput<any>);\n  /**\n   * If `true`, the resulting observable will reset internal state on completion from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"repeated\" after it is done.\n   * If `false`, when the source completes, it will push the completion through the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent repeats\n   * or resubscriptions will resubscribe to that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnComplete?: boolean | (() => ObservableInput<any>);\n  /**\n   * If `true`, when the number of subscribers to the resulting observable reaches zero due to those subscribers unsubscribing, the\n   * internal state will be reset and the resulting observable will return to a \"cold\" state. This means that the next\n   * time the resulting observable is subscribed to, a new subject will be created and the source will be subscribed to\n   * again.\n   * If `false`, when the number of subscribers to the resulting observable reaches zero due to unsubscription, the subject\n   * will remain connected to the source, and new subscriptions to the result will be connected through that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnRefCountZero?: boolean | (() => ObservableInput<any>);\n}\n\nexport function share<T>(): MonoTypeOperatorFunction<T>;\n\nexport function share<T>(options: ShareConfig<T>): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a new Observable that multicasts (shares) the original Observable. As long as there is at least one\n * Subscriber this Observable will be subscribed and emitting data. When all subscribers have unsubscribed it will\n * unsubscribe from the source Observable. Because the Observable is multicasting it makes the stream `hot`.\n * This is an alias for `multicast(() => new Subject()), refCount()`.\n *\n * The subscription to the underlying source Observable can be reset (unsubscribe and resubscribe for new subscribers),\n * if the subscriber count to the shared observable drops to 0, or if the source Observable errors or completes. It is\n * possible to use notifier factories for the resets to allow for behaviors like conditional or delayed resets. Please\n * note that resetting on error or complete of the source Observable does not behave like a transparent retry or restart\n * of the source because the error or complete will be forwarded to all subscribers and their subscription will be\n * closed. Only new subscribers after a reset on error or complete happened will cause a fresh subscription to the\n * source. To achieve transparent retries or restarts pipe the source through appropriate operators before sharing.\n *\n * ![](share.png)\n *\n * ## Example\n *\n * Generate new multicast Observable from the `source` Observable value\n *\n * ```ts\n * import { interval, tap, map, take, share } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   tap(x => console.log('Processing: ', x)),\n *   map(x => x * x),\n *   take(6),\n *   share()\n * );\n *\n * source.subscribe(x => console.log('subscription 1: ', x));\n * source.subscribe(x => console.log('subscription 2: ', x));\n *\n * // Logs:\n * // Processing: 0\n * // subscription 1: 0\n * // subscription 2: 0\n * // Processing: 1\n * // subscription 1: 1\n * // subscription 2: 1\n * // Processing: 2\n * // subscription 1: 4\n * // subscription 2: 4\n * // Processing: 3\n * // subscription 1: 9\n * // subscription 2: 9\n * // Processing: 4\n * // subscription 1: 16\n * // subscription 2: 16\n * // Processing: 5\n * // subscription 1: 25\n * // subscription 2: 25\n * ```\n *\n * ## Example with notifier factory: Delayed reset\n *\n * ```ts\n * import { interval, take, share, timer } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   take(3),\n *   share({\n *     resetOnRefCountZero: () => timer(1000)\n *   })\n * );\n *\n * const subscriptionOne = source.subscribe(x => console.log('subscription 1: ', x));\n * setTimeout(() => subscriptionOne.unsubscribe(), 1300);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 2: ', x)), 1700);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 3: ', x)), 5000);\n *\n * // Logs:\n * // subscription 1:  0\n * // (subscription 1 unsubscribes here)\n * // (subscription 2 subscribes here ~400ms later, source was not reset)\n * // subscription 2:  1\n * // subscription 2:  2\n * // (subscription 2 unsubscribes here)\n * // (subscription 3 subscribes here ~2000ms later, source did reset before)\n * // subscription 3:  0\n * // subscription 3:  1\n * // subscription 3:  2\n * ```\n *\n * @see {@link shareReplay}\n *\n * @return A function that returns an Observable that mirrors the source.\n */\nexport function share<T>(options: ShareConfig<T> = {}): MonoTypeOperatorFunction<T> {\n  const { connector = () => new Subject<T>(), resetOnError = true, resetOnComplete = true, resetOnRefCountZero = true } = options;\n  // It's necessary to use a wrapper here, as the _operator_ must be\n  // referentially transparent. Otherwise, it cannot be used in calls to the\n  // static `pipe` function - to create a partial pipeline.\n  //\n  // The _operator function_ - the function returned by the _operator_ - will\n  // not be referentially transparent - as it shares its source - but the\n  // _operator function_ is called when the complete pipeline is composed via a\n  // call to a source observable's `pipe` method - not when the static `pipe`\n  // function is called.\n  return (wrapperSource) => {\n    let connection: SafeSubscriber<T> | undefined;\n    let resetConnection: Subscription | undefined;\n    let subject: SubjectLike<T> | undefined;\n    let refCount = 0;\n    let hasCompleted = false;\n    let hasErrored = false;\n\n    const cancelReset = () => {\n      resetConnection?.unsubscribe();\n      resetConnection = undefined;\n    };\n    // Used to reset the internal state to a \"cold\"\n    // state, as though it had never been subscribed to.\n    const reset = () => {\n      cancelReset();\n      connection = subject = undefined;\n      hasCompleted = hasErrored = false;\n    };\n    const resetAndUnsubscribe = () => {\n      // We need to capture the connection before\n      // we reset (if we need to reset).\n      const conn = connection;\n      reset();\n      conn?.unsubscribe();\n    };\n\n    return operate<T, T>((source, subscriber) => {\n      refCount++;\n      if (!hasErrored && !hasCompleted) {\n        cancelReset();\n      }\n\n      // Create the subject if we don't have one yet. Grab a local reference to\n      // it as well, which avoids non-null assertions when using it and, if we\n      // connect to it now, then error/complete need a reference after it was\n      // reset.\n      const dest = (subject = subject ?? connector());\n\n      // Add the finalization directly to the subscriber - instead of returning it -\n      // so that the handling of the subscriber's unsubscription will be wired\n      // up _before_ the subscription to the source occurs. This is done so that\n      // the assignment to the source connection's `closed` property will be seen\n      // by synchronous firehose sources.\n      subscriber.add(() => {\n        refCount--;\n\n        // If we're resetting on refCount === 0, and it's 0, we only want to do\n        // that on \"unsubscribe\", really. Resetting on error or completion is a different\n        // configuration.\n        if (refCount === 0 && !hasErrored && !hasCompleted) {\n          resetConnection = handleReset(resetAndUnsubscribe, resetOnRefCountZero);\n        }\n      });\n\n      // The following line adds the subscription to the subscriber passed.\n      // Basically, `subscriber === dest.subscribe(subscriber)` is `true`.\n      dest.subscribe(subscriber);\n\n      if (\n        !connection &&\n        // Check this shareReplay is still activate - it can be reset to 0\n        // and be \"unsubscribed\" _before_ it actually subscribes.\n        // If we were to subscribe then, it'd leak and get stuck.\n        refCount > 0\n      ) {\n        // We need to create a subscriber here - rather than pass an observer and\n        // assign the returned subscription to connection - because it's possible\n        // for reentrant subscriptions to the shared observable to occur and in\n        // those situations we want connection to be already-assigned so that we\n        // don't create another connection to the source.\n        connection = new SafeSubscriber({\n          next: (value) => dest.next(value),\n          error: (err) => {\n            hasErrored = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnError, err);\n            dest.error(err);\n          },\n          complete: () => {\n            hasCompleted = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnComplete);\n            dest.complete();\n          },\n        });\n        innerFrom(source).subscribe(connection);\n      }\n    })(wrapperSource);\n  };\n}\n\nfunction handleReset<T extends unknown[] = never[]>(\n  reset: () => void,\n  on: boolean | ((...args: T) => ObservableInput<any>),\n  ...args: T\n): Subscription | undefined {\n  if (on === true) {\n    reset();\n    return;\n  }\n\n  if (on === false) {\n    return;\n  }\n\n  const onSubscriber = new SafeSubscriber({\n    next: () => {\n      onSubscriber.unsubscribe();\n      reset();\n    },\n  });\n\n  return innerFrom(on(...args)).subscribe(onSubscriber);\n}\n", "import { ReplaySubject } from '../ReplaySubject';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { share } from './share';\n\nexport interface ShareReplayConfig {\n  bufferSize?: number;\n  windowTime?: number;\n  refCount: boolean;\n  scheduler?: SchedulerLike;\n}\n\nexport function shareReplay<T>(config: ShareReplayConfig): MonoTypeOperatorFunction<T>;\nexport function shareReplay<T>(bufferSize?: number, windowTime?: number, scheduler?: SchedulerLike): MonoTypeOperatorFunction<T>;\n\n/**\n * Share source and replay specified number of emissions on subscription.\n *\n * This operator is a specialization of `replay` that connects to a source observable\n * and multicasts through a `ReplaySubject` constructed with the specified arguments.\n * A successfully completed source will stay cached in the `shareReplay`ed observable forever,\n * but an errored source can be retried.\n *\n * ## Why use `shareReplay`?\n *\n * You generally want to use `shareReplay` when you have side-effects or taxing computations\n * that you do not wish to be executed amongst multiple subscribers.\n * It may also be valuable in situations where you know you will have late subscribers to\n * a stream that need access to previously emitted values.\n * This ability to replay values on subscription is what differentiates {@link share} and `shareReplay`.\n *\n * ## Reference counting\n *\n * By default `shareReplay` will use `refCount` of false, meaning that it will _not_ unsubscribe the\n * source when the reference counter drops to zero, i.e. the inner `ReplaySubject` will _not_ be unsubscribed\n * (and potentially run for ever).\n * This is the default as it is expected that `shareReplay` is often used to keep around expensive to setup\n * observables which we want to keep running instead of having to do the expensive setup again.\n *\n * As of RXJS version 6.4.0 a new overload signature was added to allow for manual control over what\n * happens when the operators internal reference counter drops to zero.\n * If `refCount` is true, the source will be unsubscribed from once the reference count drops to zero, i.e.\n * the inner `ReplaySubject` will be unsubscribed. All new subscribers will receive value emissions from a\n * new `ReplaySubject` which in turn will cause a new subscription to the source observable.\n *\n * ## Examples\n *\n * Example with a third subscriber coming late to the party\n *\n * ```ts\n * import { interval, take, shareReplay } from 'rxjs';\n *\n * const shared$ = interval(2000).pipe(\n *   take(6),\n *   shareReplay(3)\n * );\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * setTimeout(() => {\n *   shared$.subscribe(y => console.log('sub C: ', y));\n * }, 11000);\n *\n * // Logs:\n * // (after ~2000 ms)\n * // sub A: 0\n * // sub B: 0\n * // (after ~4000 ms)\n * // sub A: 1\n * // sub B: 1\n * // (after ~6000 ms)\n * // sub A: 2\n * // sub B: 2\n * // (after ~8000 ms)\n * // sub A: 3\n * // sub B: 3\n * // (after ~10000 ms)\n * // sub A: 4\n * // sub B: 4\n * // (after ~11000 ms, sub C gets the last 3 values)\n * // sub C: 2\n * // sub C: 3\n * // sub C: 4\n * // (after ~12000 ms)\n * // sub A: 5\n * // sub B: 5\n * // sub C: 5\n * ```\n *\n * Example for `refCount` usage\n *\n * ```ts\n * import { Observable, tap, interval, shareReplay, take } from 'rxjs';\n *\n * const log = <T>(name: string, source: Observable<T>) => source.pipe(\n *   tap({\n *     subscribe: () => console.log(`${ name }: subscribed`),\n *     next: value => console.log(`${ name }: ${ value }`),\n *     complete: () => console.log(`${ name }: completed`),\n *     finalize: () => console.log(`${ name }: unsubscribed`)\n *   })\n * );\n *\n * const obs$ = log('source', interval(1000));\n *\n * const shared$ = log('shared', obs$.pipe(\n *   shareReplay({ bufferSize: 1, refCount: true }),\n *   take(2)\n * ));\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * // PRINTS:\n * // shared: subscribed <-- reference count = 1\n * // source: subscribed\n * // shared: subscribed <-- reference count = 2\n * // source: 0\n * // shared: 0\n * // sub A: 0\n * // shared: 0\n * // sub B: 0\n * // source: 1\n * // shared: 1\n * // sub A: 1\n * // shared: completed <-- take(2) completes the subscription for sub A\n * // shared: unsubscribed <-- reference count = 1\n * // shared: 1\n * // sub B: 1\n * // shared: completed <-- take(2) completes the subscription for sub B\n * // shared: unsubscribed <-- reference count = 0\n * // source: unsubscribed <-- replaySubject unsubscribes from source observable because the reference count dropped to 0 and refCount is true\n *\n * // In case of refCount being false, the unsubscribe is never called on the source and the source would keep on emitting, even if no subscribers\n * // are listening.\n * // source: 2\n * // source: 3\n * // source: 4\n * // ...\n * ```\n *\n * @see {@link publish}\n * @see {@link share}\n * @see {@link publishReplay}\n *\n * @param configOrBufferSize Maximum element count of the replay buffer or {@link ShareReplayConfig configuration}\n * object.\n * @param windowTime Maximum time length of the replay buffer in milliseconds.\n * @param scheduler Scheduler where connected observers within the selector function\n * will be invoked on.\n * @return A function that returns an Observable sequence that contains the\n * elements of a sequence produced by multicasting the source sequence within a\n * selector function.\n */\nexport function shareReplay<T>(\n  configOrBufferSize?: ShareReplayConfig | number,\n  windowTime?: number,\n  scheduler?: SchedulerLike\n): MonoTypeOperatorFunction<T> {\n  let bufferSize: number;\n  let refCount = false;\n  if (configOrBufferSize && typeof configOrBufferSize === 'object') {\n    ({ bufferSize = Infinity, windowTime = Infinity, refCount = false, scheduler } = configOrBufferSize);\n  } else {\n    bufferSize = (configOrBufferSize ?? Infinity) as number;\n  }\n  return share<T>({\n    connector: () => new ReplaySubject(bufferSize, windowTime, scheduler),\n    resetOnError: true,\n    resetOnComplete: false,\n    resetOnRefCountZero: refCount,\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { filter } from './filter';\n\n/**\n * Returns an Observable that skips the first `count` items emitted by the source Observable.\n *\n * ![](skip.png)\n *\n * Skips the values until the sent notifications are equal or less than provided skip count. It raises\n * an error if skip count is equal or more than the actual number of emits and source raises an error.\n *\n * ## Example\n *\n * Skip the values before the emission\n *\n * ```ts\n * import { interval, skip } from 'rxjs';\n *\n * // emit every half second\n * const source = interval(500);\n * // skip the first 10 emitted values\n * const result = source.pipe(skip(10));\n *\n * result.subscribe(value => console.log(value));\n * // output: 10...11...12...13...\n * ```\n *\n * @see {@link last}\n * @see {@link skipWhile}\n * @see {@link skipUntil}\n * @see {@link skipLast}\n *\n * @param {Number} count - The number of times, items emitted by source Observable should be skipped.\n * @return A function that returns an Observable that skips the first `count`\n * values emitted by the source Observable.\n */\nexport function skip<T>(count: number): MonoTypeOperatorFunction<T> {\n  return filter((_, index) => count <= index);\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Returns an Observable that skips items emitted by the source Observable until a second Observable emits an item.\n *\n * The `skipUntil` operator causes the observable stream to skip the emission of values until the passed in observable\n * emits the first value. This can be particularly useful in combination with user interactions, responses of HTTP\n * requests or waiting for specific times to pass by.\n *\n * ![](skipUntil.png)\n *\n * Internally, the `skipUntil` operator subscribes to the passed in `notifier` `ObservableInput` (which gets converted\n * to an Observable) in order to recognize the emission of its first value. When `notifier` emits next, the operator\n * unsubscribes from it and starts emitting the values of the *source* observable until it completes or errors. It\n * will never let the *source* observable emit any values if the `notifier` completes or throws an error without\n * emitting a value before.\n *\n * ## Example\n *\n * In the following example, all emitted values of the interval observable are skipped until the user clicks anywhere\n * within the page\n *\n * ```ts\n * import { interval, fromEvent, skipUntil } from 'rxjs';\n *\n * const intervalObservable = interval(1000);\n * const click = fromEvent(document, 'click');\n *\n * const emitAfterClick = intervalObservable.pipe(\n *   skipUntil(click)\n * );\n * // clicked at 4.6s. output: 5...6...7...8........ or\n * // clicked at 7.3s. output: 8...9...10..11.......\n * emitAfterClick.subscribe(value => console.log(value));\n * ```\n *\n * @see {@link last}\n * @see {@link skip}\n * @see {@link skipWhile}\n * @see {@link skipLast}\n *\n * @param notifier An `ObservableInput` that has to emit an item before the source Observable elements begin to\n * be mirrored by the resulting Observable.\n * @return A function that returns an Observable that skips items from the\n * source Observable until the `notifier` Observable emits an item, then emits the\n * remaining items.\n */\nexport function skipUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let taking = false;\n\n    const skipSubscriber = createOperatorSubscriber(\n      subscriber,\n      () => {\n        skipSubscriber?.unsubscribe();\n        taking = true;\n      },\n      noop\n    );\n\n    innerFrom(notifier).subscribe(skipSubscriber);\n\n    source.subscribe(createOperatorSubscriber(subscriber, (value) => taking && subscriber.next(value)));\n  });\n}\n", "import { concat } from '../observable/concat';\nimport { OperatorFunction, SchedulerLike, ValueFromArray } from '../types';\nimport { popScheduler } from '../util/args';\nimport { operate } from '../util/lift';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function startWith<T>(value: null): OperatorFunction<T, T | null>;\nexport function startWith<T>(value: undefined): OperatorFunction<T, T | undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function startWith<T, A extends readonly unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\nexport function startWith<T, A extends readonly unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that, at the moment of subscription, will synchronously emit all\n * values provided to this operator, then subscribe to the source and mirror all of its emissions\n * to subscribers.\n *\n * This is a useful way to know when subscription has occurred on an existing observable.\n *\n * <span class=\"informal\">First emits its arguments in order, and then any\n * emissions from the source.</span>\n *\n * ![](startWith.png)\n *\n * ## Examples\n *\n * Emit a value when a timer starts.\n *\n * ```ts\n * import { timer, map, startWith } from 'rxjs';\n *\n * timer(1000)\n *   .pipe(\n *     map(() => 'timer emit'),\n *     startWith('timer start')\n *   )\n *   .subscribe(x => console.log(x));\n *\n * // results:\n * // 'timer start'\n * // 'timer emit'\n * ```\n *\n * @param values Items you want the modified Observable to emit first.\n * @return A function that returns an Observable that synchronously emits\n * provided values before subscribing to the source Observable.\n *\n * @see {@link endWith}\n * @see {@link finalize}\n * @see {@link concat}\n */\nexport function startWith<T, D>(...values: D[]): OperatorFunction<T, T | D> {\n  const scheduler = popScheduler(values);\n  return operate((source, subscriber) => {\n    // Here we can't pass `undefined` as a scheduler, because if we did, the\n    // code inside of `concat` would be confused by the `undefined`, and treat it\n    // like an invalid observable. So we have to split it two different ways.\n    (scheduler ? concat(values, source, scheduler) : concat(values, source)).subscribe(subscriber);\n  });\n}\n", "import { Subscriber } from '../Subscriber';\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/* tslint:disable:max-line-length */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable, emitting values only from the most recently projected Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link switchAll}.</span>\n *\n * ![](switchMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an (so-called \"inner\") Observable. Each time it observes one of these\n * inner Observables, the output Observable begins emitting the items emitted by\n * that inner Observable. When a new inner Observable is emitted, `switchMap`\n * stops emitting items from the earlier-emitted inner Observable and begins\n * emitting items from the new one. It continues to behave like this for\n * subsequent inner Observables.\n *\n * ## Example\n *\n * Generate new Observable according to source Observable values\n *\n * ```ts\n * import { of, switchMap } from 'rxjs';\n *\n * const switched = of(1, 2, 3).pipe(switchMap(x => of(x, x ** 2, x ** 3)));\n * switched.subscribe(x => console.log(x));\n * // outputs\n * // 1\n * // 1\n * // 1\n * // 2\n * // 4\n * // 8\n * // 3\n * // 9\n * // 27\n * ```\n *\n * Restart an interval Observable on every click event\n *\n * ```ts\n * import { fromEvent, switchMap, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(switchMap(() => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link mergeMap}\n * @see {@link switchAll}\n * @see {@link switchMapTo}\n *\n * @param {function(value: T, index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and taking\n * only the values from the most recently projected inner Observable.\n */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  return operate((source, subscriber) => {\n    let innerSubscriber: Subscriber<ObservedValueOf<O>> | null = null;\n    let index = 0;\n    // Whether or not the source subscription has completed\n    let isComplete = false;\n\n    // We only complete the result if the source is complete AND we don't have an active inner subscription.\n    // This is called both when the source completes and when the inners complete.\n    const checkComplete = () => isComplete && !innerSubscriber && subscriber.complete();\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Cancel the previous inner subscription if there was one\n          innerSubscriber?.unsubscribe();\n          let innerIndex = 0;\n          const outerIndex = index++;\n          // Start the next inner subscription\n          innerFrom(project(value, outerIndex)).subscribe(\n            (innerSubscriber = createOperatorSubscriber(\n              subscriber,\n              // When we get a new inner value, next it through. Note that this is\n              // handling the deprecate result selector here. This is because with this architecture\n              // it ends up being smaller than using the map operator.\n              (innerValue) => subscriber.next(resultSelector ? resultSelector(value, innerValue, outerIndex, innerIndex++) : innerValue),\n              () => {\n                // The inner has completed. Null out the inner subscriber to\n                // free up memory and to signal that we have no inner subscription\n                // currently.\n                innerSubscriber = null!;\n                checkComplete();\n              }\n            ))\n          );\n        },\n        () => {\n          isComplete = true;\n          checkComplete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Emits the values emitted by the source Observable until a `notifier`\n * Observable emits a value.\n *\n * <span class=\"informal\">Lets values pass until a second Observable,\n * `notifier`, emits a value. Then, it completes.</span>\n *\n * ![](takeUntil.png)\n *\n * `takeUntil` subscribes and begins mirroring the source Observable. It also\n * monitors a second Observable, `notifier` that you provide. If the `notifier`\n * emits a value, the output Observable stops mirroring the source Observable\n * and completes. If the `notifier` doesn't emit any value and completes\n * then `takeUntil` will pass all values.\n *\n * ## Example\n *\n * Tick every second until the first click happens\n *\n * ```ts\n * import { interval, fromEvent, takeUntil } from 'rxjs';\n *\n * const source = interval(1000);\n * const clicks = fromEvent(document, 'click');\n * const result = source.pipe(takeUntil(clicks));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param {Observable} notifier The Observable whose first emitted value will\n * cause the output Observable of `takeUntil` to stop emitting values from the\n * source Observable.\n * @return A function that returns an Observable that emits the values from the\n * source Observable until `notifier` emits its first value.\n */\nexport function takeUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    innerFrom(notifier).subscribe(createOperatorSubscriber(subscriber, () => subscriber.complete(), noop));\n    !subscriber.closed && source.subscribe(subscriber);\n  });\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: true): MonoTypeOperatorFunction<T>;\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: false): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S, inclusive: false): OperatorFunction<T, S>;\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive?: boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Emits values emitted by the source Observable so long as each value satisfies\n * the given `predicate`, and then completes as soon as this `predicate` is not\n * satisfied.\n *\n * <span class=\"informal\">Takes values from the source only while they pass the\n * condition given. When the first value does not satisfy, it completes.</span>\n *\n * ![](takeWhile.png)\n *\n * `takeWhile` subscribes and begins mirroring the source Observable. Each value\n * emitted on the source is given to the `predicate` function which returns a\n * boolean, representing a condition to be satisfied by the source values. The\n * output Observable emits the source values until such time as the `predicate`\n * returns false, at which point `takeWhile` stops mirroring the source\n * Observable and completes the output Observable.\n *\n * ## Example\n *\n * Emit click events only while the clientX property is greater than 200\n *\n * ```ts\n * import { fromEvent, takeWhile } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const result = clicks.pipe(takeWhile(ev => ev.clientX > 200));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link skip}\n *\n * @param {function(value: T, index: number): boolean} predicate A function that\n * evaluates a value emitted by the source Observable and returns a boolean.\n * Also takes the (zero-based) index as the second argument.\n * @param {boolean} inclusive When set to `true` the value that caused\n * `predicate` to return `false` will also be emitted.\n * @return A function that returns an Observable that emits values from the\n * source Observable so long as each value satisfies the condition defined by\n * the `predicate`, then completes.\n */\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive = false): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let index = 0;\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        const result = predicate(value, index++);\n        (result || inclusive) && subscriber.next(value);\n        !result && subscriber.complete();\n      })\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, Observer } from '../types';\nimport { isFunction } from '../util/isFunction';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { identity } from '../util/identity';\n\n/**\n * An extension to the {@link Observer} interface used only by the {@link tap} operator.\n *\n * It provides a useful set of callbacks a user can register to do side-effects in\n * cases other than what the usual {@link Observer} callbacks are\n * ({@link guide/glossary-and-semantics#next next},\n * {@link guide/glossary-and-semantics#error error} and/or\n * {@link guide/glossary-and-semantics#complete complete}).\n *\n * ## Example\n *\n * ```ts\n * import { fromEvent, switchMap, tap, interval, take } from 'rxjs';\n *\n * const source$ = fromEvent(document, 'click');\n * const result$ = source$.pipe(\n *   switchMap((_, i) => i % 2 === 0\n *     ? fromEvent(document, 'mousemove').pipe(\n *         tap({\n *           subscribe: () => console.log('Subscribed to the mouse move events after click #' + i),\n *           unsubscribe: () => console.log('Mouse move events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('Mouse move events #' + i + ' finalized')\n *         })\n *       )\n *     : interval(1_000).pipe(\n *         take(5),\n *         tap({\n *           subscribe: () => console.log('Subscribed to the 1-second interval events after click #' + i),\n *           unsubscribe: () => console.log('1-second interval events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('1-second interval events #' + i + ' finalized')\n *         })\n *       )\n *   )\n * );\n *\n * const subscription = result$.subscribe({\n *   next: console.log\n * });\n *\n * setTimeout(() => {\n *   console.log('Unsubscribe after 60 seconds');\n *   subscription.unsubscribe();\n * }, 60_000);\n * ```\n */\nexport interface TapObserver<T> extends Observer<T> {\n  /**\n   * The callback that `tap` operator invokes at the moment when the source Observable\n   * gets subscribed to.\n   */\n  subscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when an explicit\n   * {@link guide/glossary-and-semantics#unsubscription unsubscribe} happens. It won't get invoked on\n   * `error` or `complete` events.\n   */\n  unsubscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when any kind of\n   * {@link guide/glossary-and-semantics#finalization finalization} happens - either when\n   * the source Observable `error`s or `complete`s or when it gets explicitly unsubscribed\n   * by the user. There is no difference in using this callback or the {@link finalize}\n   * operator, but if you're already using `tap` operator, you can use this callback\n   * instead. You'd get the same result in either case.\n   */\n  finalize: () => void;\n}\nexport function tap<T>(observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void)): MonoTypeOperatorFunction<T>;\n/** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\nexport function tap<T>(\n  next?: ((value: T) => void) | null,\n  error?: ((error: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Used to perform side-effects for notifications from the source observable\n *\n * <span class=\"informal\">Used when you want to affect outside state with a notification without altering the notification</span>\n *\n * ![](tap.png)\n *\n * Tap is designed to allow the developer a designated place to perform side effects. While you _could_ perform side-effects\n * inside of a `map` or a `mergeMap`, that would make their mapping functions impure, which isn't always a big deal, but will\n * make it so you can't do things like memoize those functions. The `tap` operator is designed solely for such side-effects to\n * help you remove side-effects from other operations.\n *\n * For any notification, next, error, or complete, `tap` will call the appropriate callback you have provided to it, via a function\n * reference, or a partial observer, then pass that notification down the stream.\n *\n * The observable returned by `tap` is an exact mirror of the source, with one exception: Any error that occurs -- synchronously -- in a handler\n * provided to `tap` will be emitted as an error from the returned observable.\n *\n * > Be careful! You can mutate objects as they pass through the `tap` operator's handlers.\n *\n * The most common use of `tap` is actually for debugging. You can place a `tap(console.log)` anywhere\n * in your observable `pipe`, log out the notifications as they are emitted by the source returned by the previous\n * operation.\n *\n * ## Examples\n *\n * Check a random number before it is handled. Below is an observable that will use a random number between 0 and 1,\n * and emit `'big'` or `'small'` depending on the size of that number. But we wanted to log what the original number\n * was, so we have added a `tap(console.log)`.\n *\n * ```ts\n * import { of, tap, map } from 'rxjs';\n *\n * of(Math.random()).pipe(\n *   tap(console.log),\n *   map(n => n > 0.5 ? 'big' : 'small')\n * ).subscribe(console.log);\n * ```\n *\n * Using `tap` to analyze a value and force an error. Below is an observable where in our system we only\n * want to emit numbers 3 or less we get from another source. We can force our observable to error\n * using `tap`.\n *\n * ```ts\n * import { of, tap } from 'rxjs';\n *\n * const source = of(1, 2, 3, 4, 5);\n *\n * source.pipe(\n *   tap(n => {\n *     if (n > 3) {\n *       throw new TypeError(`Value ${ n } is greater than 3`);\n *     }\n *   })\n * )\n * .subscribe({ next: console.log, error: err => console.log(err.message) });\n * ```\n *\n * We want to know when an observable completes before moving on to the next observable. The system\n * below will emit a random series of `'X'` characters from 3 different observables in sequence. The\n * only way we know when one observable completes and moves to the next one, in this case, is because\n * we have added a `tap` with the side effect of logging to console.\n *\n * ```ts\n * import { of, concatMap, interval, take, map, tap } from 'rxjs';\n *\n * of(1, 2, 3).pipe(\n *   concatMap(n => interval(1000).pipe(\n *     take(Math.round(Math.random() * 10)),\n *     map(() => 'X'),\n *     tap({ complete: () => console.log(`Done with ${ n }`) })\n *   ))\n * )\n * .subscribe(console.log);\n * ```\n *\n * @see {@link finalize}\n * @see {@link TapObserver}\n *\n * @param observerOrNext A next handler or partial observer\n * @param error An error handler\n * @param complete A completion handler\n * @return A function that returns an Observable identical to the source, but\n * runs the specified Observer or callback(s) for each item.\n */\nexport function tap<T>(\n  observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void) | null,\n  error?: ((e: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T> {\n  // We have to check to see not only if next is a function,\n  // but if error or complete were passed. This is because someone\n  // could technically call tap like `tap(null, fn)` or `tap(null, null, fn)`.\n  const tapObserver =\n    isFunction(observerOrNext) || error || complete\n      ? // tslint:disable-next-line: no-object-literal-type-assertion\n        ({ next: observerOrNext as Exclude<typeof observerOrNext, Partial<TapObserver<T>>>, error, complete } as Partial<TapObserver<T>>)\n      : observerOrNext;\n\n  return tapObserver\n    ? operate((source, subscriber) => {\n        tapObserver.subscribe?.();\n        let isUnsub = true;\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              tapObserver.next?.(value);\n              subscriber.next(value);\n            },\n            () => {\n              isUnsub = false;\n              tapObserver.complete?.();\n              subscriber.complete();\n            },\n            (err) => {\n              isUnsub = false;\n              tapObserver.error?.(err);\n              subscriber.error(err);\n            },\n            () => {\n              if (isUnsub) {\n                tapObserver.unsubscribe?.();\n              }\n              tapObserver.finalize?.();\n            }\n          )\n        );\n      })\n    : // Tap was called with no valid tap observer or handler\n      // (e.g. `tap(null, null, null)` or `tap(null)` or `tap()`)\n      // so we're going to just mirror the source.\n      identity;\n}\n", "import { Subscription } from '../Subscription';\n\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * An object interface used by {@link throttle} or {@link throttleTime} that ensure\n * configuration options of these operators.\n *\n * @see {@link throttle}\n * @see {@link throttleTime}\n */\nexport interface ThrottleConfig {\n  /**\n   * If `true`, the resulting Observable will emit the first value from the source\n   * Observable at the **start** of the \"throttling\" process (when starting an\n   * internal timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the first value from the source Observable at the\n   * start of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `true`.\n   */\n  leading?: boolean;\n  /**\n   * If `true`, the resulting Observable will emit the last value from the source\n   * Observable at the **end** of the \"throttling\" process (when ending an internal\n   * timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the last value from the source Observable at the\n   * end of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `false`.\n   */\n  trailing?: boolean;\n}\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for a duration determined by another Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link throttleTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](throttle.svg)\n *\n * `throttle` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled by calling the `durationSelector` function with the source value,\n * which returns the \"duration\" Observable. When the duration Observable emits a\n * value, the timer is disabled, and this process repeats for the\n * next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttle, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttle(() => interval(1000)));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function that receives a value from the source\n * Observable, for computing the silencing duration for each source value,\n * returned as an `ObservableInput`.\n * @param config A configuration object to define `leading` and `trailing`\n * behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttle<T>(durationSelector: (value: T) => ObservableInput<any>, config?: ThrottleConfig): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    const { leading = true, trailing = false } = config ?? {};\n    let hasValue = false;\n    let sendValue: T | null = null;\n    let throttled: Subscription | null = null;\n    let isComplete = false;\n\n    const endThrottling = () => {\n      throttled?.unsubscribe();\n      throttled = null;\n      if (trailing) {\n        send();\n        isComplete && subscriber.complete();\n      }\n    };\n\n    const cleanupThrottling = () => {\n      throttled = null;\n      isComplete && subscriber.complete();\n    };\n\n    const startThrottle = (value: T) =>\n      (throttled = innerFrom(durationSelector(value)).subscribe(createOperatorSubscriber(subscriber, endThrottling, cleanupThrottling)));\n\n    const send = () => {\n      if (hasValue) {\n        // Ensure we clear out our value and hasValue flag\n        // before we emit, otherwise reentrant code can cause\n        // issues here.\n        hasValue = false;\n        const value = sendValue!;\n        sendValue = null;\n        // Emit the value.\n        subscriber.next(value);\n        !isComplete && startThrottle(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        // Regarding the presence of throttled.closed in the following\n        // conditions, if a synchronous duration selector is specified - weird,\n        // but legal - an already-closed subscription will be assigned to\n        // throttled, so the subscription's closed property needs to be checked,\n        // too.\n        (value) => {\n          hasValue = true;\n          sendValue = value;\n          !(throttled && !throttled.closed) && (leading ? send() : startThrottle(value));\n        },\n        () => {\n          isComplete = true;\n          !(trailing && hasValue && throttled && !throttled.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { throttle, ThrottleConfig } from './throttle';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { timer } from '../observable/timer';\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for `duration` milliseconds, then repeats this process.\n *\n * <span class=\"informal\">Lets a value pass, then ignores source values for the\n * next `duration` milliseconds.</span>\n *\n * ![](throttleTime.png)\n *\n * `throttleTime` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled. After `duration` milliseconds (or the time unit determined\n * internally by the optional `scheduler`) has passed, the timer is disabled,\n * and this process repeats for the next source value. Optionally takes a\n * {@link SchedulerLike} for managing timers.\n *\n * ## Examples\n *\n * ### Limit click rate\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttleTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttleTime(1000));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttle}\n *\n * @param duration Time to wait before emitting another value after\n * emitting the last value, measured in milliseconds or the time unit determined\n * internally by the optional `scheduler`.\n * @param scheduler The {@link SchedulerLike} to use for\n * managing the timers that handle the throttling. Defaults to {@link asyncScheduler}.\n * @param config A configuration object to define `leading` and\n * `trailing` behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttleTime<T>(\n  duration: number,\n  scheduler: SchedulerLike = asyncScheduler,\n  config?: ThrottleConfig\n): MonoTypeOperatorFunction<T> {\n  const duration$ = timer(duration, scheduler);\n  return throttle(() => duration$, config);\n}\n", "import { OperatorFunction, ObservableInputTuple } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { identity } from '../util/identity';\nimport { noop } from '../util/noop';\nimport { popResultSelector } from '../util/args';\n\nexport function withLatestFrom<T, O extends unknown[]>(...inputs: [...ObservableInputTuple<O>]): OperatorFunction<T, [T, ...O]>;\n\nexport function withLatestFrom<T, O extends unknown[], R>(\n  ...inputs: [...ObservableInputTuple<O>, (...value: [T, ...O]) => R]\n): OperatorFunction<T, R>;\n\n/**\n * Combines the source Observable with other Observables to create an Observable\n * whose values are calculated from the latest values of each, only when the\n * source emits.\n *\n * <span class=\"informal\">Whenever the source Observable emits a value, it\n * computes a formula using that value plus the latest values from other input\n * Observables, then emits the output of that formula.</span>\n *\n * ![](withLatestFrom.png)\n *\n * `withLatestFrom` combines each value from the source Observable (the\n * instance) with the latest values from the other input Observables only when\n * the source emits a value, optionally using a `project` function to determine\n * the value to be emitted on the output Observable. All input Observables must\n * emit at least one value before the output Observable will emit a value.\n *\n * ## Example\n *\n * On every click event, emit an array with the latest timer event plus the click event\n *\n * ```ts\n * import { fromEvent, interval, withLatestFrom } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const result = clicks.pipe(withLatestFrom(timer));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatest}\n *\n * @param {ObservableInput} other An input Observable to combine with the source\n * Observable. More than one input Observables may be given as argument.\n * @param {Function} [project] Projection function for combining values\n * together. Receives all values in order of the Observables passed, where the\n * first parameter is a value from the source Observable. (e.g.\n * `a.pipe(withLatestFrom(b, c), map(([a1, b1, c1]) => a1 + b1 + c1))`). If this is not\n * passed, arrays will be emitted on the output Observable.\n * @return A function that returns an Observable of projected values from the\n * most recent values from each input Observable, or an array of the most\n * recent values from each input Observable.\n */\nexport function withLatestFrom<T, R>(...inputs: any[]): OperatorFunction<T, R | any[]> {\n  const project = popResultSelector(inputs) as ((...args: any[]) => R) | undefined;\n\n  return operate((source, subscriber) => {\n    const len = inputs.length;\n    const otherValues = new Array(len);\n    // An array of whether or not the other sources have emitted. Matched with them by index.\n    // TODO: At somepoint, we should investigate the performance implications here, and look\n    // into using a `Set()` and checking the `size` to see if we're ready.\n    let hasValue = inputs.map(() => false);\n    // Flipped true when we have at least one value from all other sources and\n    // we are ready to start emitting values.\n    let ready = false;\n\n    // Other sources. Note that here we are not checking `subscriber.closed`,\n    // this causes all inputs to be subscribed to, even if nothing can be emitted\n    // from them. This is an important distinction because subscription constitutes\n    // a side-effect.\n    for (let i = 0; i < len; i++) {\n      innerFrom(inputs[i]).subscribe(\n        createOperatorSubscriber(\n          subscriber,\n          (value) => {\n            otherValues[i] = value;\n            if (!ready && !hasValue[i]) {\n              // If we're not ready yet, flag to show this observable has emitted.\n              hasValue[i] = true;\n              // Intentionally terse code.\n              // If all of our other observables have emitted, set `ready` to `true`,\n              // so we know we can start emitting values, then clean up the `hasValue` array,\n              // because we don't need it anymore.\n              (ready = hasValue.every(identity)) && (hasValue = null!);\n            }\n          },\n          // Completing one of the other sources has\n          // no bearing on the completion of our result.\n          noop\n        )\n      );\n    }\n\n    // Source subscription\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        if (ready) {\n          // We have at least one value from the other sources. Go ahead and emit.\n          const values = [value, ...otherValues];\n          subscriber.next(project ? project(...values) : values);\n        }\n      })\n    );\n  });\n}\n", "import { zip as zipStatic } from '../observable/zip';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { operate } from '../util/lift';\n\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  otherInputsAndProject: [...ObservableInputTuple<A>],\n  project: (...values: Cons<T, A>) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  ...otherInputsAndProject: [...ObservableInputTuple<A>, (...values: Cons<T, A>) => R]\n): OperatorFunction<T, R>;\n\n/**\n * @deprecated Replaced with {@link zipWith}. Will be removed in v8.\n */\nexport function zip<T, R>(...sources: Array<ObservableInput<any> | ((...values: Array<any>) => R)>): OperatorFunction<T, any> {\n  return operate((source, subscriber) => {\n    zipStatic(source as ObservableInput<any>, ...(sources as Array<ObservableInput<any>>)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { zip } from './zip';\n\n/**\n * Subscribes to the source, and the observable inputs provided as arguments, and combines their values, by index, into arrays.\n *\n * What is meant by \"combine by index\": The first value from each will be made into a single array, then emitted,\n * then the second value from each will be combined into a single array and emitted, then the third value\n * from each will be combined into a single array and emitted, and so on.\n *\n * This will continue until it is no longer able to combine values of the same index into an array.\n *\n * After the last value from any one completed source is emitted in an array, the resulting observable will complete,\n * as there is no way to continue \"zipping\" values together by index.\n *\n * Use-cases for this operator are limited. There are memory concerns if one of the streams is emitting\n * values at a much faster rate than the others. Usage should likely be limited to streams that emit\n * at a similar pace, or finite streams of known length.\n *\n * In many cases, authors want `combineLatestWith` and not `zipWith`.\n *\n * @param otherInputs other observable inputs to collate values from.\n * @return A function that returns an Observable that emits items by index\n * combined from the source Observable and provided Observables, in form of an\n * array.\n */\nexport function zipWith<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>> {\n  return zip(...otherInputs);\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ReplaySubject,\n  Subject,\n  fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject<Document> {\n  const document$ = new ReplaySubject<Document>(1)\n  fromEvent(document, \"DOMContentLoaded\", { once: true })\n    .subscribe(() => document$.next(document))\n\n  /* Return document */\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounceTime,\n  distinctUntilChanged,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Focus observable\n *\n * Previously, this observer used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n */\nconst observer$ = merge(\n  fromEvent(document.body, \"focusin\"),\n  fromEvent(document.body, \"focusout\")\n)\n  .pipe(\n    debounceTime(1),\n    startWith(undefined),\n    map(() => getActiveElement() || document.body),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      map(active => el.contains(active)),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounceTime,\n  fromEvent,\n  identity,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element hover\n *\n * @param el - Element\n * @param duration - Debounce duration\n *\n * @returns Element hover observable\n */\nexport function watchElementHover(\n  el: HTMLElement, duration?: number\n): Observable<boolean> {\n  return merge(\n    fromEvent(el, \"mouseenter\").pipe(map(() => true)),\n    fromEvent(el, \"mouseleave\").pipe(map(() => false))\n  )\n    .pipe(\n      duration ? debounceTime(duration) : identity,\n      startWith(false)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.offsetLeft,\n    y: el.offsetTop\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(window, \"load\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementOffset(el)),\n      startWith(getElementOffset(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.scrollLeft,\n    y: el.scrollTop\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(el, \"scroll\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementContentOffset(el)),\n      startWith(getElementContentOffset(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n  & JSXInternal.HTMLAttributes\n  & JSXInternal.SVGAttributes\n  & Record<string, any>\n\n/**\n * Child element\n */\ntype Child =\n  | ChildNode\n  | HTMLElement\n  | Text\n  | string\n  | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n  /* Handle primitive types (including raw HTML) */\n  if (typeof child === \"string\" || typeof child === \"number\") {\n    el.innerHTML += child.toString()\n\n  /* Handle nodes */\n  } else if (child instanceof Node) {\n    el.appendChild(child)\n\n  /* Handle nested children */\n  } else if (Array.isArray(child)) {\n    for (const node of child)\n      appendChild(el, node)\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h<T extends keyof HTMLElementTagNameMap>(\n  tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n  const el = document.createElement(tag)\n\n  /* Set attributes, if any */\n  if (attributes)\n    for (const attr of Object.keys(attributes)) {\n      if (typeof attributes[attr] === \"undefined\")\n        continue\n\n      /* Set default attribute or boolean */\n      if (typeof attributes[attr] !== \"boolean\")\n        el.setAttribute(attr, attributes[attr])\n      else\n        el.setAttribute(attr, \"\")\n    }\n\n  /* Append child nodes */\n  for (const child of children)\n    appendChild(el, child)\n\n  /* Return element */\n  return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n  namespace JSX {\n    type Element = HTMLElement\n    type IntrinsicElements = JSXInternal.IntrinsicElements\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n  if (value > 999) {\n    const digits = +((value - 950) % 1000 > 99)\n    return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n  } else {\n    return value.toString()\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  switchMap,\n  take,\n  throwError\n} from \"rxjs\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create and load a `script` element\n *\n * This function returns an observable that will emit when the script was\n * successfully loaded, or throw an error if it wasn't.\n *\n * @param src - Script URL\n *\n * @returns Script observable\n */\nexport function watchScript(src: string): Observable<void> {\n  const script = h(\"script\", { src })\n  return defer(() => {\n    document.head.appendChild(script)\n    return merge(\n      fromEvent(script, \"load\"),\n      fromEvent(script, \"error\")\n        .pipe(\n          switchMap(() => (\n            throwError(() => new ReferenceError(`Invalid script: ${src}`))\n          ))\n        )\n    )\n      .pipe(\n        map(() => undefined),\n        finalize(() => document.head.removeChild(script)),\n        take(1)\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"../../../script\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n  width: number                        /* Element width */\n  height: number                       /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject<ResizeObserverEntry>()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * If the browser doesn't have a `ResizeObserver` implementation available, a\n * polyfill is automatically downloaded from unpkg.com. This is also compatible\n * with the built-in privacy plugin, which will download the polyfill and put\n * it alongside the built site for self-hosting.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => (\n  typeof ResizeObserver === \"undefined\"\n    ? watchScript(\"https://unpkg.com/resize-observer-polyfill\")\n    : of(undefined)\n))\n  .pipe(\n    map(() => new ResizeObserver(entries => {\n      for (const entry of entries)\n        entry$.next(entry)\n    })),\n    switchMap(observer => merge(NEVER, of(observer))\n      .pipe(\n        finalize(() => observer.disconnect())\n      )\n    ),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.offsetWidth,\n    height: el.offsetHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n  el: HTMLElement\n): Observable<ElementSize> {\n  return observer$\n    .pipe(\n      tap(observer => observer.observe(el)),\n      switchMap(observer => entry$\n        .pipe(\n          filter(({ target }) => target === el),\n          finalize(() => observer.unobserve(el)),\n          map(() => getElementSize(el))\n        )\n      ),\n      startWith(getElementSize(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.scrollWidth,\n    height: el.scrollHeight\n  }\n}\n\n/**\n * Retrieve the overflowing container of an element, if any\n *\n * @param el - Element\n *\n * @returns Overflowing container or nothing\n */\nexport function getElementContainer(\n  el: HTMLElement\n): HTMLElement | undefined {\n  let parent = el.parentElement\n  while (parent)\n    if (\n      el.scrollWidth  <= parent.scrollWidth &&\n      el.scrollHeight <= parent.scrollHeight\n    )\n      parent = (el = parent).parentElement\n    else\n      break\n\n  /* Return overflowing container */\n  return parent ? el : undefined\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElementContentSize,\n  getElementSize,\n  watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject<IntersectionObserverEntry>()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n  new IntersectionObserver(entries => {\n    for (const entry of entries)\n      entry$.next(entry)\n  }, {\n    threshold: 0\n  })\n))\n  .pipe(\n    switchMap(observer => merge(NEVER, of(observer))\n      .pipe(\n        finalize(() => observer.disconnect())\n      )\n    ),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      tap(observer => observer.observe(el)),\n      switchMap(observer => entry$\n        .pipe(\n          filter(({ target }) => target === el),\n          finalize(() => observer.unobserve(el)),\n          map(({ isIntersecting }) => isIntersecting)\n        )\n      )\n    )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n  el: HTMLElement, threshold = 16\n): Observable<boolean> {\n  return watchElementContentOffset(el)\n    .pipe(\n      map(({ y }) => {\n        const visible = getElementSize(el)\n        const content = getElementContentSize(el)\n        return y >= (\n          content.height - visible.height - threshold\n        )\n      }),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n  | \"drawer\"                           /* Toggle for drawer */\n  | \"search\"                           /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record<Toggle, HTMLInputElement> = {\n  drawer: getElement(\"[data-md-toggle=drawer]\"),\n  search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n  return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n  if (toggles[name].checked !== value)\n    toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable<boolean> {\n  const el = toggles[name]\n  return fromEvent(el, \"change\")\n    .pipe(\n      map(() => el.checked),\n      startWith(el.checked)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  share,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n  | \"global\"                           /* Global */\n  | \"search\"                           /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n  mode: KeyboardMode                   /* Keyboard mode */\n  type: string                         /* Key type */\n  claim(): void                        /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n  el: HTMLElement, type: string\n): boolean {\n  switch (el.constructor) {\n\n    /* Input elements */\n    case HTMLInputElement:\n      /* @ts-expect-error - omit unnecessary type cast */\n      if (el.type === \"radio\")\n        return /^Arrow/.test(type)\n      else\n        return true\n\n    /* Select element and textarea */\n    case HTMLSelectElement:\n    case HTMLTextAreaElement:\n      return true\n\n    /* Everything else */\n    default:\n      return el.isContentEditable\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch composition events\n *\n * @returns Composition observable\n */\nexport function watchComposition(): Observable<boolean> {\n  return merge(\n    fromEvent(window, \"compositionstart\").pipe(map(() => true)),\n    fromEvent(window, \"compositionend\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(false)\n    )\n}\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable<Keyboard> {\n  const keyboard$ = fromEvent<KeyboardEvent>(window, \"keydown\")\n    .pipe(\n      filter(ev => !(ev.metaKey || ev.ctrlKey)),\n      map(ev => ({\n        mode: getToggle(\"search\") ? \"search\" : \"global\",\n        type: ev.key,\n        claim() {\n          ev.preventDefault()\n          ev.stopPropagation()\n        }\n      } as Keyboard)),\n      filter(({ mode, type }) => {\n        if (mode === \"global\") {\n          const active = getActiveElement()\n          if (typeof active !== \"undefined\")\n            return !isSusceptibleToKeyboard(active, type)\n        }\n        return true\n      }),\n      share()\n    )\n\n  /* Don't emit during composition events - see https://bit.ly/3te3Wl8 */\n  return watchComposition()\n    .pipe(\n      switchMap(active => !active ? keyboard$ : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Subject } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n  return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * If instant navigation is enabled, this function creates a temporary anchor\n * element, sets the `href` attribute, appends it to the body, clicks it, and\n * then removes it again. The event will bubble up the DOM and trigger be\n * intercepted by the instant loading business logic.\n *\n * Note that we must append and remove the anchor element, or the event will\n * not bubble up the DOM, making it impossible to intercept it.\n *\n * @param url - URL to navigate to\n * @param navigate - Force navigation\n */\nexport function setLocation(\n  url: URL | HTMLLinkElement, navigate = false\n): void {\n  if (feature(\"navigation.instant\") && !navigate) {\n    const el = h(\"a\", { href: url.href })\n    document.body.appendChild(el)\n    el.click()\n    el.remove()\n\n  // If we're not using instant navigation, and the page should not be reloaded\n  // just instruct the browser to navigate to the given URL\n  } else {\n    location.href = url.href\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject<URL> {\n  return new Subject<URL>()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n  return location.hash.slice(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n  const el = h(\"a\", { href: hash })\n  el.addEventListener(\"click\", ev => ev.stopPropagation())\n  el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @param location$ - Location observable\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(\n  location$: Observable<URL>\n): Observable<string> {\n  return merge(\n    fromEvent<HashChangeEvent>(window, \"hashchange\"),\n    location$\n  )\n    .pipe(\n      map(getLocationHash),\n      startWith(getLocationHash()),\n      filter(hash => hash.length > 0),\n      shareReplay(1)\n    )\n}\n\n/**\n * Watch location target\n *\n * @param location$ - Location observable\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(\n  location$: Observable<URL>\n): Observable<HTMLElement> {\n  return watchLocationHash(location$)\n    .pipe(\n      map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n      filter(el => typeof el !== \"undefined\")\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  fromEvent,\n  fromEventPattern,\n  map,\n  merge,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable<boolean> {\n  const media = matchMedia(query)\n  return fromEventPattern<boolean>(next => (\n    media.addListener(() => next(media.matches))\n  ))\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable<boolean> {\n  const media = matchMedia(\"print\")\n  return merge(\n    fromEvent(window, \"beforeprint\").pipe(map(() => true)),\n    fromEvent(window, \"afterprint\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at<T>(\n  query$: Observable<boolean>, factory: () => Observable<T>\n): Observable<T> {\n  return query$\n    .pipe(\n      switchMap(active => active ? factory() : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  map,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Options\n */\ninterface Options {\n  progress$?: Subject<number>          // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * This function returns an observable that emits the response as a blob and\n * completes, or emits an error if the request failed. The caller can cancel\n * the request by unsubscribing at any time, which will automatically abort\n * the inflight request and complete the observable.\n *\n * Note that we use `XMLHTTPRequest` not because we're nostalgic, but because\n * it's the only way to get progress events for downloads and also allow for\n * cancellation of requests, as the official Fetch API does not support this\n * yet, even though we're already in 2024.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function request(\n  url: URL | string, options?: Options\n): Observable<Blob> {\n  return new Observable<Blob>(observer => {\n    const req = new XMLHttpRequest()\n    req.open(\"GET\", `${url}`)\n    req.responseType = \"blob\"\n\n    // Handle response\n    req.addEventListener(\"load\", () => {\n      if (req.status >= 200 && req.status < 300) {\n        observer.next(req.response)\n        observer.complete()\n\n      // Every response that is not in the 2xx range is considered an error\n      } else {\n        observer.error(new Error(req.statusText))\n      }\n    })\n\n    // Handle network errors\n    req.addEventListener(\"error\", () => {\n      observer.error(new Error(\"Network error\"))\n    })\n\n    // Handle aborted requests\n    req.addEventListener(\"abort\", () => {\n      observer.complete()\n    })\n\n    // Handle download progress\n    if (typeof options?.progress$ !== \"undefined\") {\n      req.addEventListener(\"progress\", event => {\n        if (event.lengthComputable) {\n          options.progress$!.next((event.loaded / event.total) * 100)\n\n        // Hack: Chromium doesn't report the total number of bytes if content\n        // is compressed, so we need this fallback - see https://t.ly/ZXofI\n        } else {\n          const length = req.getResponseHeader(\"Content-Length\") ?? 0\n          options.progress$!.next((event.loaded / +length) * 100)\n        }\n      })\n\n      // Immediately set progress to 5% to indicate that we're loading\n      options.progress$.next(5)\n    }\n\n    // Send request and automatically abort request upon unsubscription\n    req.send()\n    return () => req.abort()\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON<T>(\n  url: URL | string, options?: Options\n): Observable<T> {\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(body => JSON.parse(body) as T),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch HTML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestHTML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/html\")),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/xml\")),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n  return {\n    x: Math.max(0, scrollX),\n    y: Math.max(0, scrollY)\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable<ViewportOffset> {\n  return merge(\n    fromEvent(window, \"scroll\", { passive: true }),\n    fromEvent(window, \"resize\", { passive: true })\n  )\n    .pipe(\n      map(getViewportOffset),\n      startWith(getViewportOffset())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n  width: number                        /* Viewport width */\n  height: number                       /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n  return {\n    width:  innerWidth,\n    height: innerHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable<ViewportSize> {\n  return fromEvent(window, \"resize\", { passive: true })\n    .pipe(\n      map(getViewportSize),\n      startWith(getViewportSize())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  map,\n  shareReplay\n} from \"rxjs\"\n\nimport {\n  ViewportOffset,\n  watchViewportOffset\n} from \"../offset\"\nimport {\n  ViewportSize,\n  watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n  offset: ViewportOffset               /* Viewport offset */\n  size: ViewportSize                   /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable<Viewport> {\n  return combineLatest([\n    watchViewportOffset(),\n    watchViewportSize()\n  ])\n    .pipe(\n      map(([offset, size]) => ({ offset, size })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilKeyChanged,\n  map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Viewport> {\n  const size$ = viewport$\n    .pipe(\n      distinctUntilKeyChanged(\"size\")\n    )\n\n  /* Compute element offset */\n  const offset$ = combineLatest([size$, header$])\n    .pipe(\n      map(() => getElementOffset(el))\n    )\n\n  /* Compute relative viewport, return hot observable */\n  return combineLatest([header$, viewport$, offset$])\n    .pipe(\n      map(([{ height }, { offset, size }, { x, y }]) => ({\n        offset: {\n          x: offset.x - x,\n          y: offset.y - y + height\n        },\n        size\n      }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  mergeWith,\n  share,\n  takeUntil\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n  type: unknown                        /* Message type */\n  data?: unknown                       /* Message data */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create an observable for receiving from a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message observable\n */\nfunction recv<T>(worker: Worker): Observable<T> {\n  return fromEvent<MessageEvent<T>, T>(worker, \"message\", ev => ev.data)\n}\n\n/**\n * Create a subject for sending to a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message subject\n */\nfunction send<T>(worker: Worker): Subject<T> {\n  const send$ = new Subject<T>()\n  send$.subscribe(data => worker.postMessage(data))\n\n  /* Return message subject */\n  return send$\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a bidirectional communication channel to a web worker\n *\n * @template T - Data type\n *\n * @param url - Worker URL\n * @param worker - Worker\n *\n * @returns Worker subject\n */\nexport function watchWorker<T extends WorkerMessage>(\n  url: string, worker = new Worker(url)\n): Subject<T> {\n  const recv$ = recv<T>(worker)\n  const send$ = send<T>(worker)\n\n  /* Create worker subject and forward messages */\n  const worker$ = new Subject<T>()\n  worker$.subscribe(send$)\n\n  /* Return worker subject */\n  const done$ = send$.pipe(ignoreElements(), endWith(true))\n  return worker$\n    .pipe(\n      ignoreElements(),\n      mergeWith(recv$.pipe(takeUntil(done$))),\n      share()\n    ) as Subject<T>\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n  | \"announce.dismiss\"                 /* Dismissable announcement bar */\n  | \"content.code.annotate\"            /* Code annotations */\n  | \"content.code.copy\"                /* Code copy button */\n  | \"content.lazy\"                     /* Lazy content elements */\n  | \"content.tabs.link\"                /* Link content tabs */\n  | \"content.tooltips\"                 /* Tooltips */\n  | \"header.autohide\"                  /* Hide header */\n  | \"navigation.expand\"                /* Automatic expansion */\n  | \"navigation.indexes\"               /* Section pages */\n  | \"navigation.instant\"               /* Instant navigation */\n  | \"navigation.instant.progress\"      /* Instant navigation progress */\n  | \"navigation.sections\"              /* Section navigation */\n  | \"navigation.tabs\"                  /* Tabs navigation */\n  | \"navigation.tabs.sticky\"           /* Tabs navigation (sticky) */\n  | \"navigation.top\"                   /* Back-to-top button */\n  | \"navigation.tracking\"              /* Anchor tracking */\n  | \"search.highlight\"                 /* Search highlighting */\n  | \"search.share\"                     /* Search sharing */\n  | \"search.suggest\"                   /* Search suggestions */\n  | \"toc.follow\"                       /* Following table of contents */\n  | \"toc.integrate\"                    /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n  | \"clipboard.copy\"                   /* Copy to clipboard */\n  | \"clipboard.copied\"                 /* Copied to clipboard */\n  | \"search.result.placeholder\"        /* Type to start searching */\n  | \"search.result.none\"               /* No matching documents */\n  | \"search.result.one\"                /* 1 matching document */\n  | \"search.result.other\"              /* # matching documents */\n  | \"search.result.more.one\"           /* 1 more on this page */\n  | \"search.result.more.other\"         /* # more on this page */\n  | \"search.result.term.missing\"       /* Missing */\n  | \"select.version\"                   /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations =\n  Record<Translation, string>\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n  provider: \"mike\"                     /* Version provider */\n  default?: string | string[]          /* Default version */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n  base: string                         /* Base URL */\n  features: Flag[]                     /* Feature flags */\n  translations: Translations           /* Translations */\n  search: string                       /* Search worker URL */\n  tags?: Record<string, string>        /* Tags mapping */\n  version?: Versioning                 /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n  return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n  return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n  key: Translation, value?: string | number\n): string {\n  return typeof value !== \"undefined\"\n    ? config.translations[key].replace(\"#\", value.toString())\n    : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n  | \"announce\"                         /* Announcement bar */\n  | \"container\"                        /* Container */\n  | \"consent\"                          /* Consent */\n  | \"content\"                          /* Content */\n  | \"dialog\"                           /* Dialog */\n  | \"header\"                           /* Header */\n  | \"header-title\"                     /* Header title */\n  | \"header-topic\"                     /* Header topic */\n  | \"main\"                             /* Main area */\n  | \"outdated\"                         /* Version warning */\n  | \"palette\"                          /* Color palette */\n  | \"progress\"                         /* Progress indicator */\n  | \"search\"                           /* Search */\n  | \"search-query\"                     /* Search input */\n  | \"search-result\"                    /* Search results */\n  | \"search-share\"                     /* Search sharing */\n  | \"search-suggest\"                   /* Search suggestions */\n  | \"sidebar\"                          /* Sidebar */\n  | \"skip\"                             /* Skip link */\n  | \"source\"                           /* Repository information */\n  | \"tabs\"                             /* Navigation tabs */\n  | \"toc\"                              /* Table of contents */\n  | \"top\"                              /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n  T extends {} = {},\n  U extends HTMLElement = HTMLElement\n> =\n  T & {\n    ref: U                             /* Component reference */\n  }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n  \"announce\": HTMLElement              /* Announcement bar */\n  \"container\": HTMLElement             /* Container */\n  \"consent\": HTMLElement               /* Consent */\n  \"content\": HTMLElement               /* Content */\n  \"dialog\": HTMLElement                /* Dialog */\n  \"header\": HTMLElement                /* Header */\n  \"header-title\": HTMLElement          /* Header title */\n  \"header-topic\": HTMLElement          /* Header topic */\n  \"main\": HTMLElement                  /* Main area */\n  \"outdated\": HTMLElement              /* Version warning */\n  \"palette\": HTMLElement               /* Color palette */\n  \"progress\": HTMLElement              /* Progress indicator */\n  \"search\": HTMLElement                /* Search */\n  \"search-query\": HTMLInputElement     /* Search input */\n  \"search-result\": HTMLElement         /* Search results */\n  \"search-share\": HTMLAnchorElement    /* Search sharing */\n  \"search-suggest\": HTMLElement        /* Search suggestions */\n  \"sidebar\": HTMLElement               /* Sidebar */\n  \"skip\": HTMLAnchorElement            /* Skip link */\n  \"source\": HTMLAnchorElement          /* Repository information */\n  \"tabs\": HTMLElement                  /* Navigation tabs */\n  \"toc\": HTMLElement                   /* Table of contents */\n  \"top\": HTMLAnchorElement             /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n  return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n  return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Announcement bar\n */\nexport interface Announce {\n  hash: number                        /* Content hash */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar observable\n */\nexport function watchAnnounce(\n  el: HTMLElement\n): Observable<Announce> {\n  const button = getElement(\".md-typeset > :first-child\", el)\n  return fromEvent(button, \"click\", { once: true })\n    .pipe(\n      map(() => getElement(\".md-typeset\", el)),\n      map(content => ({ hash: __md_hash(content.innerHTML) }))\n    )\n}\n\n/**\n * Mount announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar component observable\n */\nexport function mountAnnounce(\n  el: HTMLElement\n): Observable<Component<Announce>> {\n  if (!feature(\"announce.dismiss\") || !el.childElementCount)\n    return EMPTY\n\n  /* Support instant navigation - see https://t.ly/3FTme */\n  if (!el.hidden) {\n    const content = getElement(\".md-typeset\", el)\n    if (__md_hash(content.innerHTML) === __md_get(\"__announce\"))\n      el.hidden = true\n  }\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Announce>()\n    push$.subscribe(({ hash }) => {\n      el.hidden = true\n\n      /* Persist preference in local storage */\n      __md_set<number>(\"__announce\", hash)\n    })\n\n    /* Create and return component */\n    return watchAnnounce(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Consent\n */\nexport interface Consent {\n  hidden: boolean                      /* Consent is hidden */\n}\n\n/**\n * Consent defaults\n */\nexport interface ConsentDefaults {\n  analytics?: boolean                  /* Consent for Analytics */\n  github?: boolean                     /* Consent for GitHub */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent observable\n */\nexport function watchConsent(\n  el: HTMLElement, { target$ }: WatchOptions\n): Observable<Consent> {\n  return target$\n    .pipe(\n      map(target => ({ hidden: target !== el }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent component observable\n */\nexport function mountConsent(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Consent>> {\n  const internal$ = new Subject<Consent>()\n  internal$.subscribe(({ hidden }) => {\n    el.hidden = hidden\n  })\n\n  /* Create and return component */\n  return watchConsent(el, options)\n    .pipe(\n      tap(state => internal$.next(state)),\n      finalize(() => internal$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip style\n */\nexport type TooltipStyle =\n  | \"inline\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a tooltip\n *\n * @param id - Tooltip identifier\n * @param style - Tooltip style\n *\n * @returns Element\n */\nexport function renderTooltip(\n  id?: string, style?: TooltipStyle\n): HTMLElement {\n  if (style === \"inline\") { // @todo refactor control flow\n    return (\n      <div class=\"md-tooltip md-tooltip--inline\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  } else {\n    return (\n      <div class=\"md-tooltip\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\nimport { renderTooltip } from \"../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an annotation\n *\n * @param id - Annotation identifier\n * @param prefix - Tooltip identifier prefix\n *\n * @returns Element\n */\nexport function renderAnnotation(\n  id: string | number, prefix?: string\n): HTMLElement {\n  prefix = prefix ? `${prefix}_annotation_${id}` : undefined\n\n  /* Render tooltip with anchor, if given */\n  if (prefix) {\n    const anchor = prefix ? `#${prefix}` : undefined\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <a href={anchor} class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </a>\n      </aside>\n    )\n  } else {\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <span class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </span>\n      </aside>\n    )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n  return (\n    <button\n      class=\"md-clipboard md-icon\"\n      title={translation(\"clipboard.copy\")}\n      data-clipboard-target={`#${id} > code`}\n    ></button>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ComponentChild } from \"preact\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { SearchItem } from \"~/integrations/search\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n  TEASER = 1,                          /* Render teaser */\n  PARENT = 2                           /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n  document: SearchItem, flag: Flag\n): HTMLElement {\n  const parent = flag & Flag.PARENT\n  const teaser = flag & Flag.TEASER\n\n  /* Render missing query terms */\n  const missing = Object.keys(document.terms)\n    .filter(key => !document.terms[key])\n    .reduce<ComponentChild[]>((list, key) => [\n      ...list, <del>{key}</del>, \" \"\n    ], [])\n    .slice(0, -1)\n\n  /* Assemble query string for highlighting */\n  const config = configuration()\n  const url = new URL(document.location, config.base)\n  if (feature(\"search.highlight\"))\n    url.searchParams.set(\"h\", Object.entries(document.terms)\n      .filter(([, match]) => match)\n      .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n    )\n\n  /* Render article or section, depending on flags */\n  const { tags } = configuration()\n  return (\n    <a href={`${url}`} class=\"md-search-result__link\" tabIndex={-1}>\n      <article\n        class=\"md-search-result__article md-typeset\"\n        data-md-score={document.score.toFixed(2)}\n      >\n        {parent > 0 && <div class=\"md-search-result__icon md-icon\"></div>}\n        {parent > 0 && <h1>{document.title}</h1>}\n        {parent <= 0 && <h2>{document.title}</h2>}\n        {teaser > 0 && document.text.length > 0 &&\n          document.text\n        }\n        {document.tags && document.tags.map(tag => {\n          const type = tags\n            ? tag in tags\n              ? `md-tag-icon md-tag--${tags[tag]}`\n              : \"md-tag-icon\"\n            : \"\"\n          return (\n            <span class={`md-tag ${type}`}>{tag}</span>\n          )\n        })}\n        {teaser > 0 && missing.length > 0 &&\n          <p class=\"md-search-result__terms\">\n            {translation(\"search.result.term.missing\")}: {...missing}\n          </p>\n        }\n      </article>\n    </a>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n  result: SearchItem[]\n): HTMLElement {\n  const threshold = result[0].score\n  const docs = [...result]\n\n  const config = configuration()\n\n  /* Find and extract parent article */\n  const parent = docs.findIndex(doc => {\n    const l = `${new URL(doc.location, config.base)}` // @todo hacky\n    return !l.includes(\"#\")\n  })\n  const [article] = docs.splice(parent, 1)\n\n  /* Determine last index above threshold */\n  let index = docs.findIndex(doc => doc.score < threshold)\n  if (index === -1)\n    index = docs.length\n\n  /* Partition sections */\n  const best = docs.slice(0, index)\n  const more = docs.slice(index)\n\n  /* Render children */\n  const children = [\n    renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n    ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n    ...more.length ? [\n      <details class=\"md-search-result__more\">\n        <summary tabIndex={-1}>\n          <div>\n            {more.length > 0 && more.length === 1\n              ? translation(\"search.result.more.one\")\n              : translation(\"search.result.more.other\", more.length)\n            }\n          </div>\n        </summary>\n        {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n      </details>\n    ] : []\n  ]\n\n  /* Render search result */\n  return (\n    <li class=\"md-search-result__item\">\n      {children}\n    </li>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n  return (\n    <ul class=\"md-source__facts\">\n      {Object.entries(facts).map(([key, value]) => (\n        <li class={`md-source__fact md-source__fact--${key}`}>\n          {typeof value === \"number\" ? round(value) : value}\n        </li>\n      ))}\n    </ul>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tabbed control type\n */\ntype TabbedControlType =\n  | \"prev\"\n  | \"next\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render control for content tabs\n *\n * @param type - Control type\n *\n * @returns Element\n */\nexport function renderTabbedControl(\n  type: TabbedControlType\n): HTMLElement {\n  const classes = `tabbed-control tabbed-control--${type}`\n  return (\n    <div class={classes} hidden>\n      <button class=\"tabbed-button\" tabIndex={-1} aria-hidden=\"true\"></button>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n  return (\n    <div class=\"md-typeset__scrollwrap\">\n      <div class=\"md-typeset__table\">\n        {table}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version properties\n */\nexport interface VersionProperties {\n  hidden?: boolean                     /* Version is hidden */\n}\n\n/**\n * Version\n */\nexport interface Version {\n  version: string                      /* Version identifier */\n  title: string                        /* Version title */\n  aliases: string[]                    /* Version aliases */\n  properties?: VersionProperties       /* Version properties */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n  const config = configuration()\n\n  /* Ensure trailing slash - see https://bit.ly/3rL5u3f */\n  const url = new URL(`../${version.version}/`, config.base)\n  return (\n    <li class=\"md-version__item\">\n      <a href={`${url}`} class=\"md-version__link\">\n        {version.title}\n      </a>\n    </li>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n  versions: Version[], active: Version\n): HTMLElement {\n  versions = versions.filter(version => !version.properties?.hidden)\n  return (\n    <div class=\"md-version\">\n      <button\n        class=\"md-version__current\"\n        aria-label={translation(\"select.version\")}\n      >\n        {active.title}\n      </button>\n      <ul class=\"md-version__list\">\n        {versions.map(renderVersion)}\n      </ul>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  subscribeOn,\n  tap,\n  throttleTime\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getElement,\n  getElementContainer,\n  getElementOffset,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderTooltip } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      /* Tooltip is active */\n  offset: ElementOffset                /* Tooltip offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function will append the tooltip temporarily to compute its width,\n * which is necessary for correct centering, and then removing it again.\n *\n * @param el - Tooltip element\n * @param host - Host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip(\n  el: HTMLElement, host: HTMLElement\n): Observable<Tooltip> {\n  document.body.append(el)\n\n  /* Compute width and remove tooltip immediately */\n  const { width } = getElementSize(el)\n  el.style.setProperty(\"--md-tooltip-width\", `${width}px`)\n  el.remove()\n\n  /* Retrieve and watch containing element */\n  const container = getElementContainer(host)\n  const scroll$ =\n    typeof container !== \"undefined\"\n      ? watchElementContentOffset(container)\n      : of({ x: 0, y: 0 })\n\n  /* Compute tooltip visibility */\n  const active$ = merge(\n    watchElementFocus(host),\n    watchElementHover(host)\n  )\n    .pipe(\n      distinctUntilChanged()\n    )\n\n  /* Compute tooltip offset */\n  return combineLatest([active$, scroll$])\n    .pipe(\n      map(([active, scroll]) => {\n        let { x, y } = getElementOffset(host)\n        const size = getElementSize(host)\n\n        /**\n         * Experimental: fix handling of tables - see https://bit.ly/3TQEj5O\n         *\n         * If this proves to be a viable fix, we should refactor tooltip\n         * positioning and somehow streamline the current process. This might\n         * also fix positioning for annotations inside tables, which is another\n         * limitation.\n         */\n        const table = host.closest(\"table\")\n        if (table && host.parentElement) {\n          x += table.offsetLeft + host.parentElement.offsetLeft\n          y += table.offsetTop  + host.parentElement.offsetTop\n        }\n        return {\n          active,\n          offset: {\n            x: x - scroll.x + size.width  / 2 - width / 2,\n            y: y - scroll.y + size.height + 8\n          }\n        }\n      })\n    )\n}\n\n/**\n * Mount tooltip\n *\n * @param el - Host element\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip(\n  el: HTMLElement\n): Observable<Component<Tooltip>> {\n  const title = el.title\n  if (!title.length)\n    return EMPTY\n\n  /* Render tooltip and set title from host element */\n  const id = `__tooltip_${sequence++}`\n  const tooltip = renderTooltip(id, \"inline\")\n  const typeset = getElement(\".md-typeset\", tooltip)\n  typeset.innerHTML = title\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        tooltip.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        tooltip.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        tooltip.style.removeProperty(\"--md-tooltip-x\")\n        tooltip.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active) {\n            el.insertAdjacentElement(\"afterend\", tooltip)\n            el.setAttribute(\"aria-describedby\", id)\n            el.removeAttribute(\"title\")\n          } else {\n            tooltip.remove()\n            el.removeAttribute(\"aria-describedby\")\n            el.setAttribute(\"title\", title)\n          }\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.remove()\n          el.removeAttribute(\"aria-describedby\")\n          el.setAttribute(\"title\", title)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    // @todo - refactor positioning together with annotations \u2013 there are\n    // several things that overlap and are identical in handling\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n      .subscribe({\n\n        /* Handle emission */\n        next(origin) {\n          if (origin)\n            tooltip.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n          else\n            tooltip.style.removeProperty(\"--md-tooltip-0\")\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.style.removeProperty(\"--md-tooltip-0\")\n        }\n      })\n\n    /* Create and return component */\n    return watchTooltip(tooltip, el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  delay,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  switchMap,\n  take,\n  takeUntil,\n  tap,\n  throttleTime,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getActiveElement,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementOffset,\n  watchElementVisibility\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n  active: boolean                      /* Annotation is active */\n  offset: ElementOffset                /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n  el: HTMLElement, container: HTMLElement\n): Observable<Annotation> {\n  const offset$ = defer(() => combineLatest([\n    watchElementOffset(el),\n    watchElementContentOffset(container)\n  ]))\n    .pipe(\n      map(([{ x, y }, scroll]): ElementOffset => {\n        const { width, height } = getElementSize(el)\n        return ({\n          x: x - scroll.x + width  / 2,\n          y: y - scroll.y + height / 2\n        })\n      })\n    )\n\n  /* Actively watch annotation on focus */\n  return watchElementFocus(el)\n    .pipe(\n      switchMap(active => offset$\n        .pipe(\n          map(offset => ({ active, offset })),\n          take(+!active || Infinity)\n        )\n      )\n    )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n  el: HTMLElement, container: HTMLElement, { target$ }: MountOptions\n): Observable<Component<Annotation>> {\n  const [tooltip, index] = Array.from(el.children)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Annotation>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.style.removeProperty(\"--md-tooltip-x\")\n        el.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Start animation only when annotation is visible */\n    watchElementVisibility(el)\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(visible => {\n          el.toggleAttribute(\"data-md-visible\", visible)\n        })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active)\n            el.prepend(tooltip)\n          else\n            tooltip.remove()\n        },\n\n        /* Handle complete */\n        complete() {\n          el.prepend(tooltip)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next(origin) {\n            if (origin)\n              el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n            else\n              el.style.removeProperty(\"--md-tooltip-0\")\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-tooltip-0\")\n          }\n        })\n\n    /* Allow to copy link without scrolling to anchor */\n    fromEvent<MouseEvent>(index, \"click\")\n      .pipe(\n        takeUntil(done$),\n        filter(ev => !(ev.metaKey || ev.ctrlKey))\n      )\n        .subscribe(ev => {\n          ev.stopPropagation()\n          ev.preventDefault()\n        })\n\n    /* Allow to open link in new tab or blur on close */\n    fromEvent<MouseEvent>(index, \"mousedown\")\n      .pipe(\n        takeUntil(done$),\n        withLatestFrom(push$)\n      )\n        .subscribe(([ev, { active }]) => {\n\n          /* Open in new tab */\n          if (ev.button !== 0 || ev.metaKey || ev.ctrlKey) {\n            ev.preventDefault()\n\n          /* Close annotation */\n          } else if (active) {\n            ev.preventDefault()\n\n            /* Focus parent annotation, if any */\n            const parent = el.parentElement!.closest(\".md-annotation\")\n            if (parent instanceof HTMLElement)\n              parent.focus()\n            else\n              getActiveElement()?.blur()\n          }\n        })\n\n    /* Open and focus annotation on location target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(target => target === tooltip),\n        delay(125)\n      )\n        .subscribe(() => el.focus())\n\n    /* Create and return component */\n    return watchAnnotation(el, container)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  endWith,\n  finalize,\n  ignoreElements,\n  merge,\n  share,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  getOptionalElement\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation hosts in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation hosts\n */\nfunction findHosts(container: HTMLElement): HTMLElement[] {\n  return container.tagName === \"CODE\"\n    ? getElements(\".c, .c1, .cm\", container)\n    : [container]\n}\n\n/**\n * Find all annotation markers in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findMarkers(container: HTMLElement): Text[] {\n  const markers: Text[] = []\n  for (const el of findHosts(container)) {\n    const nodes: Text[] = []\n\n    /* Find all text nodes in current element */\n    const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n    for (let node = it.nextNode(); node; node = it.nextNode())\n      nodes.push(node as Text)\n\n    /* Find all markers in each text node */\n    for (let text of nodes) {\n      let match: RegExpExecArray | null\n\n      /* Split text at marker and add to list */\n      while ((match = /(\\(\\d+\\))(!)?/.exec(text.textContent!))) {\n        const [, id, force] = match\n        if (typeof force === \"undefined\") {\n          const marker = text.splitText(match.index)\n          text = marker.splitText(id.length)\n          markers.push(marker)\n\n        /* Replace entire text with marker */\n        } else {\n          text.textContent = id\n          markers.push(text)\n          break\n        }\n      }\n    }\n  }\n  return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n  target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n  el: HTMLElement, container: HTMLElement, { target$, print$ }: MountOptions\n): Observable<Component<Annotation>> {\n\n  /* Compute prefix for tooltip anchors */\n  const parent = container.closest(\"[id]\")\n  const prefix = parent?.id\n\n  /* Find and replace all markers with empty annotations */\n  const annotations = new Map<string, HTMLElement>()\n  for (const marker of findMarkers(container)) {\n    const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n    if (getOptionalElement(`:scope > li:nth-child(${id})`, el)) {\n      annotations.set(id, renderAnnotation(id, prefix))\n      marker.replaceWith(annotations.get(id)!)\n    }\n  }\n\n  /* Keep list if there are no annotations to render */\n  if (annotations.size === 0)\n    return EMPTY\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n    /* Retrieve container pairs for swapping */\n    const pairs: [HTMLElement, HTMLElement][] = []\n    for (const [id, annotation] of annotations)\n      pairs.push([\n        getElement(\".md-typeset\", annotation),\n        getElement(`:scope > li:nth-child(${id})`, el)\n      ])\n\n    /* Handle print mode - see https://bit.ly/3rgPdpt */\n    print$.pipe(takeUntil(done$))\n      .subscribe(active => {\n        el.hidden = !active\n\n        /* Add class to discern list element */\n        el.classList.toggle(\"md-annotation-list\", active)\n\n        /* Show annotations in code block or list (print) */\n        for (const [inner, child] of pairs)\n          if (!active)\n            swap(child, inner)\n          else\n            swap(inner, child)\n      })\n\n    /* Create and return component */\n    return merge(...[...annotations]\n      .map(([, annotation]) => (\n        mountAnnotation(annotation, container, { target$ })\n      ))\n    )\n      .pipe(\n        finalize(() => push$.complete()),\n        share()\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable, defer } from \"rxjs\"\n\nimport { Component } from \"../../../_\"\nimport { Annotation } from \"../_\"\nimport { mountAnnotationList } from \"../list\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find list element directly following a block\n *\n * @param el - Annotation block element\n *\n * @returns List element or nothing\n */\nfunction findList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation block\n *\n * @param el - Annotation block element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Annotation>> {\n  return defer(() => {\n    const list = findList(el)\n    return typeof list !== \"undefined\"\n      ? mountAnnotationList(list, el, options)\n      : EMPTY\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  filter,\n  finalize,\n  map,\n  mergeWith,\n  switchMap,\n  take,\n  takeLast,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  getElementContentSize,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../../tooltip\"\nimport {\n  Annotation,\n  mountAnnotationList\n} from \"../../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block overflow\n */\nexport interface Overflow {\n  scrollable: boolean                  /* Code block overflows */\n}\n\n/**\n * Code block\n */\nexport type CodeBlock =\n  | Overflow\n  | Annotation\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for code blocks\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findCandidateList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n  el: HTMLElement\n): Observable<Overflow> {\n  return watchElementSize(el)\n    .pipe(\n      map(({ width }) => {\n        const content = getElementContentSize(el)\n        return {\n          scrollable: content.width > width\n        }\n      }),\n      distinctUntilKeyChanged(\"scrollable\")\n    )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * Note that code blocks may be mounted eagerly or lazily. If they're mounted\n * lazily (on first visibility), code annotation anchor links will not work,\n * as they are evaluated on initial page load, and code annotations in general\n * might feel a little bumpier.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<CodeBlock>> {\n  const { matches: hover } = matchMedia(\"(hover)\")\n\n  /* Defer mounting of code block - see https://bit.ly/3vHVoVD */\n  const factory$ = defer(() => {\n    const push$ = new Subject<Overflow>()\n    const done$ = push$.pipe(takeLast(1))\n    push$.subscribe(({ scrollable }) => {\n      if (scrollable && hover)\n        el.setAttribute(\"tabindex\", \"0\")\n      else\n        el.removeAttribute(\"tabindex\")\n    })\n\n    /* Render button for Clipboard.js integration */\n    const content$: Array<Observable<Component<CodeBlock>>> = []\n    if (ClipboardJS.isSupported()) {\n      if (el.closest(\".copy\") || (\n        feature(\"content.code.copy\") && !el.closest(\".no-copy\")\n      )) {\n        const parent = el.closest(\"pre\")!\n        parent.id = `__code_${sequence++}`\n\n        /* Mount tooltip, if enabled */\n        const button = renderClipboardButton(parent.id)\n        parent.insertBefore(button, el)\n        if (feature(\"content.tooltips\"))\n          content$.push(mountTooltip(button))\n      }\n    }\n\n    /* Handle code annotations */\n    const container = el.closest(\".highlight\")\n    if (container instanceof HTMLElement) {\n      const list = findCandidateList(container)\n\n      /* Mount code annotations, if enabled */\n      if (typeof list !== \"undefined\" && (\n        container.classList.contains(\"annotate\") ||\n        feature(\"content.code.annotate\")\n      )) {\n        const annotations$ = mountAnnotationList(list, el, options)\n        content$.push(\n          watchElementSize(container)\n            .pipe(\n              takeUntil(done$),\n              map(({ width, height }) => width && height),\n              distinctUntilChanged(),\n              switchMap(active => active ? annotations$ : EMPTY)\n            )\n        )\n      }\n    }\n\n    /* Create and return component */\n    return watchCodeBlock(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(...content$)\n      )\n  })\n\n  /* Mount code block lazily */\n  if (feature(\"content.lazy\"))\n    return watchElementVisibility(el)\n      .pipe(\n        filter(visible => visible),\n        take(1),\n        switchMap(() => factory$)\n      )\n\n  /* Mount code block */\n  return factory$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n  action: \"open\" | \"close\"             /* Details state */\n  reveal?: boolean                     /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n  el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable<Details> {\n  let open = true\n  return merge(\n\n    /* Open and focus details on location target */\n    target$\n      .pipe(\n        map(target => target.closest(\"details:not([open])\")!),\n        filter(details => el === details),\n        map(() => ({\n          action: \"open\", reveal: true\n        }) as Details)\n      ),\n\n    /* Open details on print and close afterwards */\n    print$\n      .pipe(\n        filter(active => active || !open),\n        tap(() => open = el.open),\n        map(active => ({\n          action: active ? \"open\" : \"close\"\n        }) as Details)\n      )\n  )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n  el: HTMLDetailsElement, options: MountOptions\n): Observable<Component<Details>> {\n  return defer(() => {\n    const push$ = new Subject<Details>()\n    push$.subscribe(({ action, reveal }) => {\n      el.toggleAttribute(\"open\", action === \"open\")\n      if (reveal)\n        el.scrollIntoView()\n    })\n\n    /* Create and return component */\n    return watchDetails(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", ".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\nimport themeCSS from \"./index.css\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid diagram\n */\nexport interface Mermaid {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid instance observable\n */\nlet mermaid$: Observable<void>\n\n/**\n * Global sequence number for diagrams\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch Mermaid script\n *\n * @returns Mermaid scripts observable\n */\nfunction fetchScripts(): Observable<void> {\n  return typeof mermaid === \"undefined\" || mermaid instanceof Element\n    ? watchScript(\"https://unpkg.com/mermaid@10.7.0/dist/mermaid.min.js\")\n    : of(undefined)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount Mermaid diagram\n *\n * @param el - Code block element\n *\n * @returns Mermaid diagram component observable\n */\nexport function mountMermaid(\n  el: HTMLElement\n): Observable<Component<Mermaid>> {\n  el.classList.remove(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n  mermaid$ ||= fetchScripts()\n    .pipe(\n      tap(() => mermaid.initialize({\n        startOnLoad: false,\n        themeCSS,\n        sequence: {\n          actorFontSize: \"16px\", // Hack: mitigate https://bit.ly/3y0NEi3\n          messageFontSize: \"16px\",\n          noteFontSize: \"16px\"\n        }\n      })),\n      map(() => undefined),\n      shareReplay(1)\n    )\n\n  /* Render diagram */\n  mermaid$.subscribe(async () => {\n    el.classList.add(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n    const id = `__mermaid_${sequence++}`\n\n    /* Create host element to replace code block */\n    const host = h(\"div\", { class: \"mermaid\" })\n    const text = el.textContent\n\n    /* Render and inject diagram */\n    const { svg, fn } = await mermaid.render(id, text)\n\n    /* Create a shadow root and inject diagram */\n    const shadow = host.attachShadow({ mode: \"closed\" })\n    shadow.innerHTML = svg\n\n    /* Replace code block with diagram and bind functions */\n    el.replaceWith(host)\n    fn?.(shadow)\n  })\n\n  /* Create and return component */\n  return mermaid$\n    .pipe(\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n  el: HTMLElement\n): Observable<Component<DataTable>> {\n  el.replaceWith(sentinel)\n  sentinel.replaceWith(renderTable(el))\n\n  /* Create and return component */\n  return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  skip,\n  startWith,\n  subscribeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContentOffset,\n  getElementContentSize,\n  getElementOffset,\n  getElementSize,\n  getElements,\n  watchElementContentOffset,\n  watchElementSize\n} from \"~/browser\"\nimport { renderTabbedControl } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n  active: HTMLLabelElement             /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param inputs - Content tabs input elements\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n  inputs: HTMLInputElement[]\n): Observable<ContentTabs> {\n  const initial = inputs.find(input => input.checked) || inputs[0]\n  return merge(...inputs.map(input => fromEvent(input, \"change\")\n    .pipe(\n      map(() => getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`))\n    )\n  ))\n    .pipe(\n      startWith(getElement<HTMLLabelElement>(`label[for=\"${initial.id}\"]`)),\n      map(active => ({ active }))\n    )\n}\n\n/**\n * Mount content tabs\n *\n * @param el - Content tabs element\n * @param options - Options\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n  el: HTMLElement, { viewport$, target$ }: MountOptions\n): Observable<Component<ContentTabs>> {\n  const container = getElement(\".tabbed-labels\", el)\n  const inputs = getElements<HTMLInputElement>(\":scope > input\", el)\n\n  /* Render content tab previous button for pagination */\n  const prev = renderTabbedControl(\"prev\")\n  el.append(prev)\n\n  /* Render content tab next button for pagination */\n  const next = renderTabbedControl(\"next\")\n  el.append(next)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<ContentTabs>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    combineLatest([push$, watchElementSize(el)])\n      .pipe(\n        takeUntil(done$),\n        auditTime(1, animationFrameScheduler)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next([{ active }, size]) {\n            const offset = getElementOffset(active)\n            const { width } = getElementSize(active)\n\n            /* Set tab indicator offset and width */\n            el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n            el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n            /* Scroll container to active content tab */\n            const content = getElementContentOffset(container)\n            if (\n              offset.x         < content.x              ||\n              offset.x + width > content.x + size.width\n            )\n              container.scrollTo({\n                left: Math.max(0, offset.x - 16),\n                behavior: \"smooth\"\n              })\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-indicator-x\")\n            el.style.removeProperty(\"--md-indicator-width\")\n          }\n        })\n\n    /* Hide content tab buttons on borders */\n    combineLatest([\n      watchElementContentOffset(container),\n      watchElementSize(container)\n    ])\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(([offset, size]) => {\n          const content = getElementContentSize(container)\n          prev.hidden = offset.x < 16\n          next.hidden = offset.x > content.width - size.width - 16\n        })\n\n    /* Paginate content tab container on click */\n    merge(\n      fromEvent(prev, \"click\").pipe(map(() => -1)),\n      fromEvent(next, \"click\").pipe(map(() => +1))\n    )\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(direction => {\n          const { width } = getElementSize(container)\n          container.scrollBy({\n            left: width * direction,\n            behavior: \"smooth\"\n          })\n        })\n\n    /* Switch to content tab target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(input => inputs.includes(input as HTMLInputElement))\n      )\n        .subscribe(input => input.click())\n\n    /* Add link to each content tab label */\n    container.classList.add(\"tabbed-labels--linked\")\n    for (const input of inputs) {\n      const label = getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`)\n      label.replaceChildren(h(\"a\", {\n        href: `#${label.htmlFor}`,\n        tabIndex: -1\n      }, ...Array.from(label.childNodes)))\n\n      /* Allow to copy link without scrolling to anchor */\n      fromEvent<MouseEvent>(label.firstElementChild!, \"click\")\n        .pipe(\n          takeUntil(done$),\n          filter(ev => !(ev.metaKey || ev.ctrlKey)),\n          tap(ev => {\n            ev.preventDefault()\n            ev.stopPropagation()\n          })\n        )\n          // @todo we might need to remove the anchor link on complete\n          .subscribe(() => {\n            history.replaceState({}, \"\", `#${label.htmlFor}`)\n            label.click()\n          })\n    }\n\n    /* Set up linking of content tabs, if enabled */\n    if (feature(\"content.tabs.link\"))\n      push$.pipe(\n        skip(1),\n        withLatestFrom(viewport$)\n      )\n        .subscribe(([{ active }, { offset }]) => {\n          const tab = active.innerText.trim()\n          if (active.hasAttribute(\"data-md-switching\")) {\n            active.removeAttribute(\"data-md-switching\")\n\n          /* Determine viewport offset of active tab */\n          } else {\n            const y = el.offsetTop - offset.y\n\n            /* Passively activate other tabs */\n            for (const set of getElements(\"[data-tabs]\"))\n              for (const input of getElements<HTMLInputElement>(\n                \":scope > input\", set\n              )) {\n                const label = getElement(`label[for=\"${input.id}\"]`)\n                if (\n                  label !== active &&\n                  label.innerText.trim() === tab\n                ) {\n                  label.setAttribute(\"data-md-switching\", \"\")\n                  input.click()\n                  break\n                }\n              }\n\n            /* Bring active tab into view */\n            window.scrollTo({\n              top: el.offsetTop - y\n            })\n\n            /* Persist active tabs in local storage */\n            const tabs = __md_get<string[]>(\"__tabs\") || []\n            __md_set(\"__tabs\", [...new Set([tab, ...tabs])])\n          }\n        })\n\n    /* Pause media (audio, video) on switch - see https://bit.ly/3Bk6cel */\n    push$.pipe(takeUntil(done$))\n      .subscribe(() => {\n        for (const media of getElements<HTMLAudioElement>(\"audio, video\", el))\n          media.pause()\n      })\n\n    /* Create and return component */\n    return watchContentTabs(inputs)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, merge } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { Viewport, getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../tooltip\"\nimport {\n  Annotation,\n  mountAnnotationBlock\n} from \"../annotation\"\nimport {\n  CodeBlock,\n  mountCodeBlock\n} from \"../code\"\nimport {\n  Details,\n  mountDetails\n} from \"../details\"\nimport {\n  Mermaid,\n  mountMermaid\n} from \"../mermaid\"\nimport {\n  DataTable,\n  mountDataTable\n} from \"../table\"\nimport {\n  ContentTabs,\n  mountContentTabs\n} from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n  | Annotation\n  | CodeBlock\n  | ContentTabs\n  | DataTable\n  | Details\n  | Mermaid\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n  el: HTMLElement, { viewport$, target$, print$ }: MountOptions\n): Observable<Component<Content>> {\n  return merge(\n\n    /* Annotations */\n    ...getElements(\".annotate:not(.highlight)\", el)\n      .map(child => mountAnnotationBlock(child, { target$, print$ })),\n\n    /* Code blocks */\n    ...getElements(\"pre:not(.mermaid) > code\", el)\n      .map(child => mountCodeBlock(child, { target$, print$ })),\n\n    /* Mermaid diagrams */\n    ...getElements(\"pre.mermaid\", el)\n      .map(child => mountMermaid(child)),\n\n    /* Data tables */\n    ...getElements(\"table:not([class])\", el)\n      .map(child => mountDataTable(child)),\n\n    /* Details */\n    ...getElements(\"details\", el)\n      .map(child => mountDetails(child, { target$, print$ })),\n\n    /* Content tabs */\n    ...getElements(\"[data-tabs]\", el)\n      .map(child => mountContentTabs(child, { viewport$, target$ })),\n\n    /* Tooltips */\n    ...getElements(\"[title]\", el)\n      .filter(() => feature(\"content.tooltips\"))\n      .map(child => mountTooltip(child))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  delay,\n  finalize,\n  map,\n  merge,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n  message: string                      /* Dialog message */\n  active: boolean                      /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n  _el: HTMLElement, { alert$ }: WatchOptions\n): Observable<Dialog> {\n  return alert$\n    .pipe(\n      switchMap(message => merge(\n        of(true),\n        of(false).pipe(delay(2000))\n      )\n        .pipe(\n          map(active => ({ message, active }))\n        )\n      )\n    )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Dialog>> {\n  const inner = getElement(\".md-typeset\", el)\n  return defer(() => {\n    const push$ = new Subject<Dialog>()\n    push$.subscribe(({ message, active }) => {\n      el.classList.toggle(\"md-dialog--active\", active)\n      inner.textContent = message\n    })\n\n    /* Create and return component */\n    return watchDialog(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  combineLatestWith,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  from,\n  ignoreElements,\n  map,\n  mergeMap,\n  mergeWith,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementSize,\n  watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n  height: number                       /* Header visible height */\n  hidden: boolean                      /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable<boolean> {\n  if (!feature(\"header.autohide\"))\n    return of(false)\n\n  /* Compute direction and turning point */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => [a < b, b] as const),\n      distinctUntilKeyChanged(0)\n    )\n\n  /* Compute whether header should be hidden */\n  const hidden$ = combineLatest([viewport$, direction$])\n    .pipe(\n      filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n      map(([, [direction]]) => direction),\n      distinctUntilChanged()\n    )\n\n  /* Compute threshold for hiding */\n  const search$ = watchToggle(\"search\")\n  return combineLatest([viewport$, search$])\n    .pipe(\n      map(([{ offset }, search]) => offset.y > 400 && !search),\n      distinctUntilChanged(),\n      switchMap(active => active ? hidden$ : of(false)),\n      startWith(false)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n  el: HTMLElement, options: WatchOptions\n): Observable<Header> {\n  return defer(() => combineLatest([\n    watchElementSize(el),\n    isHidden(options)\n  ]))\n    .pipe(\n      map(([{ height }, hidden]) => ({\n        height,\n        hidden\n      })),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.hidden === b.hidden\n      )),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n  el: HTMLElement, { header$, main$ }: MountOptions\n): Observable<Component<Header | Tooltip>> {\n  return defer(() => {\n    const push$ = new Subject<Main>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$\n      .pipe(\n        distinctUntilKeyChanged(\"active\"),\n        combineLatestWith(header$)\n      )\n        .subscribe(([{ active }, { hidden }]) => {\n          el.classList.toggle(\"md-header--shadow\", active && !hidden)\n          el.hidden = hidden\n        })\n\n    /* Mount tooltips, if enabled */\n    const tooltips = from(getElements(\"[title]\", el))\n      .pipe(\n        filter(() => feature(\"content.tooltips\")),\n        mergeMap(child => mountTooltip(child))\n      )\n\n    /* Link to main area */\n    main$.subscribe(push$)\n\n    /* Create and return component */\n    return header$\n      .pipe(\n        takeUntil(done$),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(tooltips.pipe(takeUntil(done$)))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElementSize,\n  getOptionalElement,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n  active: boolean                      /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<HeaderTitle> {\n  return watchViewportAt(el, { viewport$, header$ })\n    .pipe(\n      map(({ offset: { y } }) => {\n        const { height } = getElementSize(el)\n        return {\n          active: y >= height\n        }\n      }),\n      distinctUntilKeyChanged(\"active\")\n    )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<HeaderTitle>> {\n  return defer(() => {\n    const push$ = new Subject<HeaderTitle>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ active }) {\n        el.classList.toggle(\"md-header__title--active\", active)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.classList.remove(\"md-header__title--active\")\n      }\n    })\n\n    /* Obtain headline, if any */\n    const heading = getOptionalElement(\".md-content h1\")\n    if (typeof heading === \"undefined\")\n      return EMPTY\n\n    /* Create and return component */\n    return watchHeaderTitle(heading, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  map,\n  switchMap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n  offset: number                       /* Main area top offset */\n  height: number                       /* Main area visible height */\n  active: boolean                      /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Main> {\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      map(({ height }) => height),\n      distinctUntilChanged()\n    )\n\n  /* Compute the main area's top and bottom borders */\n  const border$ = adjust$\n    .pipe(\n      switchMap(() => watchElementSize(el)\n        .pipe(\n          map(({ height }) => ({\n            top:    el.offsetTop,\n            bottom: el.offsetTop + height\n          })),\n          distinctUntilKeyChanged(\"bottom\")\n        )\n      )\n    )\n\n  /* Compute the main area's offset, visible height and if we scrolled past */\n  return combineLatest([adjust$, border$, viewport$])\n    .pipe(\n      map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n        height = Math.max(0, height\n          - Math.max(0, top    - y,  header)\n          - Math.max(0, height + y - bottom)\n        )\n        return {\n          offset: top - header,\n          height,\n          active: top - header <= y\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.offset === b.offset &&\n        a.height === b.height &&\n        a.active === b.active\n      ))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  mergeMap,\n  observeOn,\n  of,\n  repeat,\n  shareReplay,\n  skip,\n  startWith,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { getElements, watchMedia } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n  media?: string                       /* Media query */\n  scheme?: string                      /* Color scheme */\n  primary?: string                     /* Primary color */\n  accent?: string                      /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n  index: number                        /* Palette index */\n  color: PaletteColor                  /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n  inputs: HTMLInputElement[]\n): Observable<Palette> {\n  const current = __md_get<Palette>(\"__palette\") || {\n    index: inputs.findIndex(input => matchMedia(\n      input.getAttribute(\"data-md-color-media\")!\n    ).matches)\n  }\n\n  /* Emit changes in color palette */\n  const index = Math.max(0, Math.min(current.index, inputs.length - 1))\n  return of(...inputs)\n    .pipe(\n      mergeMap(input => fromEvent(input, \"change\").pipe(map(() => input))),\n      startWith(inputs[index]),\n      map(input => ({\n        index: inputs.indexOf(input),\n        color: {\n          media:   input.getAttribute(\"data-md-color-media\"),\n          scheme:  input.getAttribute(\"data-md-color-scheme\"),\n          primary: input.getAttribute(\"data-md-color-primary\"),\n          accent:  input.getAttribute(\"data-md-color-accent\")\n        }\n      } as Palette)),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n  el: HTMLElement\n): Observable<Component<Palette>> {\n  const inputs = getElements<HTMLInputElement>(\"input\", el)\n  const meta = h(\"meta\", { name: \"theme-color\" })\n  document.head.appendChild(meta)\n\n  // Add color scheme meta tag\n  const scheme = h(\"meta\", { name: \"color-scheme\" })\n  document.head.appendChild(scheme)\n\n  /* Mount component on subscription */\n  const media$ = watchMedia(\"(prefers-color-scheme: light)\")\n  return defer(() => {\n    const push$ = new Subject<Palette>()\n    push$.subscribe(palette => {\n      document.body.setAttribute(\"data-md-color-switching\", \"\")\n\n      /* Retrieve color palette for system preference */\n      if (palette.color.media === \"(prefers-color-scheme)\") {\n        const media = matchMedia(\"(prefers-color-scheme: light)\")\n        const input = document.querySelector(media.matches\n          ? \"[data-md-color-media='(prefers-color-scheme: light)']\"\n          : \"[data-md-color-media='(prefers-color-scheme: dark)']\"\n        )!\n\n        /* Retrieve colors for system preference */\n        palette.color.scheme  = input.getAttribute(\"data-md-color-scheme\")!\n        palette.color.primary = input.getAttribute(\"data-md-color-primary\")!\n        palette.color.accent  = input.getAttribute(\"data-md-color-accent\")!\n      }\n\n      /* Set color palette */\n      for (const [key, value] of Object.entries(palette.color))\n        document.body.setAttribute(`data-md-color-${key}`, value)\n\n      /* Set toggle visibility */\n      for (let index = 0; index < inputs.length; index++) {\n        const label = inputs[index].nextElementSibling\n        if (label instanceof HTMLElement)\n          label.hidden = palette.index !== index\n      }\n\n      /* Persist preference in local storage */\n      __md_set(\"__palette\", palette)\n    })\n\n    /* Update theme-color meta tag */\n    push$\n      .pipe(\n        map(() => {\n          const header = getComponentElement(\"header\")\n          const style  = window.getComputedStyle(header)\n\n          // Set color scheme\n          scheme.content = style.colorScheme\n\n          /* Return color in hexadecimal format */\n          return style.backgroundColor.match(/\\d+/g)!\n            .map(value => (+value).toString(16).padStart(2, \"0\"))\n            .join(\"\")\n        })\n      )\n        .subscribe(color => meta.content = `#${color}`)\n\n    /* Revert transition durations after color switch */\n    push$.pipe(observeOn(asyncScheduler))\n      .subscribe(() => {\n        document.body.removeAttribute(\"data-md-color-switching\")\n      })\n\n    /* Create and return component */\n    return watchPalette(inputs)\n      .pipe(\n        takeUntil(media$.pipe(skip(1))),\n        repeat(),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Progress indicator\n */\nexport interface Progress {\n  value: number                        // Progress value\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount progress indicator\n *\n * @param el - Progress indicator element\n * @param options - Options\n *\n * @returns Progress indicator component observable\n */\nexport function mountProgress(\n  el: HTMLElement, { progress$ }: MountOptions\n): Observable<Component<Progress>> {\n\n  // Mount component on subscription\n  return defer(() => {\n    const push$ = new Subject<Progress>()\n    push$.subscribe(({ value }) => {\n      el.style.setProperty(\"--md-progress-value\", `${value}`)\n    })\n\n    // Create and return component\n    return progress$\n      .pipe(\n        tap(value => push$.next({ value })),\n        finalize(() => push$.complete()),\n        map(value => ({ ref: el, value }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  Observable,\n  Subject,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n  el.setAttribute(\"data-md-copying\", \"\")\n  const copy = el.closest(\"[data-copy]\")\n  const text = copy\n    ? copy.getAttribute(\"data-copy\")!\n    : el.innerText\n  el.removeAttribute(\"data-md-copying\")\n  return text.trimEnd()\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n  { alert$ }: SetupOptions\n): void {\n  if (ClipboardJS.isSupported()) {\n    new Observable<ClipboardJS.Event>(subscriber => {\n      new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n        text: el => (\n          el.getAttribute(\"data-clipboard-text\")! ||\n          extract(getElement(\n            el.getAttribute(\"data-clipboard-target\")!\n          ))\n        )\n      })\n        .on(\"success\", ev => subscriber.next(ev))\n    })\n      .pipe(\n        tap(ev => {\n          const trigger = ev.trigger as HTMLElement\n          trigger.focus()\n        }),\n        map(() => translation(\"clipboard.copied\"))\n      )\n        .subscribe(alert$)\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  catchError,\n  map,\n  of\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  requestXML\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sitemap, i.e. a list of URLs\n */\nexport type Sitemap = Map<string, URL[]>\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Resolve URL to the given base URL\n *\n * When serving the site with instant navigation, MkDocs will set the hostname\n * to the value as specified in `dev_addr`, but the browser allows for several\n * hostnames to be used: `localhost`, `127.0.0.1` or even `0.0.0.0`, depending\n * on configuration. This function resolves the URL to the given hostname.\n *\n * @param url - URL\n * @param base - Base URL\n *\n * @returns Resolved URL\n */\nfunction resolve(url: URL, base: URL) {\n  url.protocol = base.protocol\n  url.hostname = base.hostname\n  return url\n}\n\n/**\n * Extract sitemap from document\n *\n * This function extracts the URLs and alternate links from the document, and\n * associates alternate links to the original URL as found in `loc`, allowing\n * the browser to navigate to the correct page when switching languages. The\n * format of the sitemap is expected to adhere to:\n *\n * ``` xml\n * <urlset>\n *   <url>\n *     <loc>...</loc>\n *     <xhtml:link rel=\"alternate\" hreflang=\"en\" href=\"...\"/>\n *     <xhtml:link rel=\"alternate\" hreflang=\"de\" href=\"...\"/>\n *     ...\n *   </url>\n *   ...\n * </urlset>\n * ```\n *\n * @param document - Document\n * @param base - Base URL\n *\n * @returns Sitemap\n */\nfunction extract(document: Document, base: URL): Sitemap {\n  const sitemap: Sitemap = new Map()\n  for (const el of getElements(\"url\", document)) {\n    const url = getElement(\"loc\", el)\n\n    // Create entry for location and add it to the list of links\n    const links = [resolve(new URL(url.textContent!), base)]\n    sitemap.set(`${links[0]}`, links)\n\n    // Attach alternate links to current entry\n    for (const link of getElements(\"[rel=alternate]\", el)) {\n      const href = link.getAttribute(\"href\")\n      if (href != null)\n        links.push(resolve(new URL(href), base))\n    }\n  }\n\n  // Return sitemap\n  return sitemap\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the sitemap for the given base URL\n *\n * If a network or parsing error occurs, we just default to an empty sitemap,\n * which means the caller should fall back to regular navigation.\n *\n * @param base - Base URL\n *\n * @returns Sitemap observable\n */\nexport function fetchSitemap(base: URL | string): Observable<Sitemap> {\n  return requestXML(new URL(\"sitemap.xml\", base))\n    .pipe(\n      map(document => extract(document, new URL(base))),\n      catchError(() => of(new Map())),\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  combineLatestWith,\n  concat,\n  debounceTime,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  of,\n  share,\n  switchMap,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  requestHTML,\n  setLocation,\n  setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\n\nimport { Sitemap, fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  location$: Subject<URL>              // Location subject\n  viewport$: Observable<Viewport>      // Viewport observable\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Handle clicks on internal URLs while skipping external URLs\n *\n * @param ev - Mouse event\n * @param sitemap - Sitemap\n *\n * @returns URL observable\n */\nfunction handle(\n  ev: MouseEvent, sitemap: Sitemap\n): Observable<URL> {\n  if (!(ev.target instanceof Element))\n    return EMPTY\n\n  // Skip, as target is not within a link - clicks on non-link elements are\n  // also captured, which we need to exclude from processing\n  const el = ev.target.closest(\"a\")\n  if (el === null)\n    return EMPTY\n\n  // Skip, as link opens in new window - we now know we have captured a click\n  // on a link, but the link either has a `target` property defined, or the\n  // user pressed the `meta` or `ctrl` key to open it in a new window. Thus,\n  // we need to filter this event as well.\n  if (el.target || ev.metaKey || ev.ctrlKey)\n    return EMPTY\n\n  // Next, we must check if the URL is relevant for us, i.e., if it's an\n  // internal link to a page that is managed by MkDocs. Only then we can be\n  // sure that the structure of the page to be loaded adheres to the current\n  // document structure and can subsequently be injected into it without doing\n  // a full reload. For this reason, we must canonicalize the URL by removing\n  // all search parameters and hash fragments.\n  const url = new URL(el.href)\n  url.search = url.hash = \"\"\n\n  // Skip, if URL is not included in the sitemap - this could be the case when\n  // linking between versions or languages, or to another page that the author\n  // included as part of the build, but that is not managed by MkDocs. In that\n  // case we must not continue with instant navigation.\n  if (!sitemap.has(`${url}`))\n    return EMPTY\n\n  // We now know that we have a link to an internal page, so we prevent the\n  // browser from navigation and emit the URL for instant navigation. Note that\n  // this also includes anchor links, which means we need to implement anchor\n  // positioning ourselves. The reason for this is that if we wouldn't manage\n  // anchor links as well, scroll restoration will not work correctly (e.g.\n  // following an anchor link and scrolling).\n  ev.preventDefault()\n  return of(new URL(el.href))\n}\n\n/**\n * Create a map of head elements for lookup and replacement\n *\n * @param document - Document\n *\n * @returns Tag map\n */\nfunction head(document: Document): Map<string, HTMLElement> {\n  const tags = new Map<string, HTMLElement>()\n  for (const el of getElements(\":scope > *\", document.head))\n    tags.set(el.outerHTML, el)\n\n  // Return tag map\n  return tags\n}\n\n/**\n * Resolve relative URLs in the given document\n *\n * This function resolves relative `href` and `src` attributes, which can belong\n * to all sorts of tags, like meta tags, links, images, scripts and more.\n *\n * @param document - Document\n *\n * @returns Document observable\n */\nfunction resolve(document: Document): Observable<Document> {\n  for (const el of getElements(\"[href], [src]\", document))\n    for (const key of [\"href\", \"src\"]) {\n      const value = el.getAttribute(key)\n      if (value && !/^(?:[a-z]+:)?\\/\\//i.test(value)) {\n        // @ts-expect-error - trick: self-assign to resolve URL\n        el[key] = el[key]\n        break\n      }\n    }\n\n  // Return document observable\n  return of(document)\n}\n\n/**\n * Inject the contents of a document into the current one\n *\n * @param next - Next document\n *\n * @returns Document observable\n */\nfunction inject(next: Document): Observable<Document> {\n  for (const selector of [\n    \"[data-md-component=announce]\",\n    \"[data-md-component=container]\",\n    \"[data-md-component=header-topic]\",\n    \"[data-md-component=outdated]\",\n    \"[data-md-component=logo]\",\n    \"[data-md-component=skip]\",\n    ...feature(\"navigation.tabs.sticky\")\n      ? [\"[data-md-component=tabs]\"]\n      : []\n  ]) {\n    const source = getOptionalElement(selector)\n    const target = getOptionalElement(selector, next)\n    if (\n      typeof source !== \"undefined\" &&\n      typeof target !== \"undefined\"\n    ) {\n      source.replaceWith(target)\n    }\n  }\n\n  // Update meta tags\n  const tags = head(document)\n  for (const [html, el] of head(next))\n    if (tags.has(html))\n      tags.delete(html)\n    else\n      document.head.appendChild(el)\n\n  // Remove meta tags that are not present in the new document\n  for (const el of tags.values()) {\n    const name = el.getAttribute(\"name\")\n    // @todo - find a better way to handle attributes we add dynamically in\n    // other components without mounting components on every navigation, as\n    // this might impact overall performance - see https://t.ly/ehp_O\n    if (name !== \"theme-color\" && name !== \"color-scheme\")\n      el.remove()\n  }\n\n  // After components and meta tags were replaced, re-evaluate scripts\n  // that were provided by the author as part of Markdown files\n  const container = getComponentElement(\"container\")\n  return concat(getElements(\"script\", container))\n    .pipe(\n      switchMap(el => {\n        const script = next.createElement(\"script\")\n        if (el.src) {\n          for (const name of el.getAttributeNames())\n            script.setAttribute(name, el.getAttribute(name)!)\n          el.replaceWith(script)\n\n          // Complete when script is loaded\n          return new Observable(observer => {\n            script.onload = () => observer.complete()\n          })\n\n        // Complete immediately\n        } else {\n          script.textContent = el.textContent\n          el.replaceWith(script)\n          return EMPTY\n        }\n      }),\n      ignoreElements(),\n      endWith(document)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant navigation\n *\n * This is a heavily orchestrated operation - see inline comments to learn how\n * this works with Material for MkDocs, and how you can hook into it.\n *\n * @param options - Options\n *\n * @returns Document observable\n */\nexport function setupInstantNavigation(\n  { location$, viewport$, progress$ }: SetupOptions\n): Observable<Document> {\n  const config = configuration()\n  if (location.protocol === \"file:\")\n    return EMPTY\n\n  // Load sitemap immediately, so we have it available when the user initiates\n  // the first navigation request without any perceivable delay\n  const sitemap$ = fetchSitemap(config.base)\n\n  // Since we might be on a slow connection, the user might trigger multiple\n  // instant navigation events that overlap. MkDocs produces relative URLs for\n  // all internal links, which becomes a problem in this case, because we need\n  // to change the base URL the moment the user clicks a link that should be\n  // intercepted in order to be consistent with popstate, which means that the\n  // base URL would now be incorrect when resolving another relative link from\n  // the same site. For this reason we always resolve all relative links to\n  // absolute links, so we can be sure this never happens.\n  of(document)\n    .subscribe(resolve)\n\n  // --------------------------------------------------------------------------\n  // Navigation interception\n  // --------------------------------------------------------------------------\n\n  // Intercept navigation - to keep the number of event listeners down we use\n  // the fact that uncaptured events bubble up to the body. This has the nice\n  // property that we don't need to detach and then re-attach event listeners\n  // when the document is replaced after a navigation event.\n  const instant$ =\n    fromEvent<MouseEvent>(document.body, \"click\")\n      .pipe(\n        combineLatestWith(sitemap$),\n        switchMap(([ev, sitemap]) => handle(ev, sitemap)),\n        share()\n      )\n\n  // Intercept history change events, e.g. when the user uses the browser's\n  // back or forward buttons, and emit new location for fetching and parsing\n  const history$ =\n    fromEvent<PopStateEvent>(window, \"popstate\")\n      .pipe(\n        map(getLocation),\n        share()\n      )\n\n  // While it would be better UX to defer navigation events until the document\n  // is fully fetched and parsed, we must schedule it here to synchronize with\n  // popstate events, as they are emitted immediately. Moreover we need to\n  // store the current viewport offset for scroll restoration later on.\n  instant$.pipe(withLatestFrom(viewport$))\n    .subscribe(([url, { offset }]) => {\n      history.replaceState(offset, \"\")\n      history.pushState(null, \"\", url)\n    })\n\n  // Emit URLs that should be fetched via instant navigation on location subject\n  // which was passed into this function. The state of instant navigation can be\n  // intercepted by other parts of the application, which can synchronously back\n  // up or restore state before or after instant navigation happens.\n  merge(instant$, history$)\n    .subscribe(location$)\n\n  // --------------------------------------------------------------------------\n  // Fetching and parsing\n  // --------------------------------------------------------------------------\n\n  // Fetch document - we deduplicate requests to the same location, so we don't\n  // end up with multiple requests for the same page. We use `switchMap`, since\n  // we want to cancel the previous request when a new one is triggered, which\n  // is automatically handled by the observable returned by `request`. This is\n  // essential to ensure a good user experience, as we don't want to load pages\n  // that are not needed anymore, e.g., when the user clicks multiple links in\n  // quick succession or on slow connections. If the request fails for some\n  // reason, we fall back and use regular navigation, forcing a reload.\n  const document$ =\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(url => requestHTML(url, { progress$ })\n        .pipe(\n          catchError(() => {\n            setLocation(url, true)\n            return EMPTY\n          })\n        )\n      ),\n\n      // The document was successfully fetched and parsed, so we can inject its\n      // contents into the currently active document\n      switchMap(resolve),\n      switchMap(inject),\n      share()\n    )\n\n  // --------------------------------------------------------------------------\n  // Scroll restoration\n  // --------------------------------------------------------------------------\n\n  // Handle scroll restoration - we must restore the viewport offset after the\n  // document has been fetched and injected, and every time the user clicks an\n  // anchor that leads to an element on the same page, which might also happen\n  // when the user uses the back or forward button.\n  merge(\n    document$.pipe(withLatestFrom(location$, (_, url) => url)),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with a hash fragment different from the current one, as\n    // well as from popstate events, which are emitted when the user navigates\n    // back and forth between pages. We use a two-layered subscription to scope\n    // the scroll restoration to the current page, as we don't need to restore\n    // the viewport offset when the user navigates to a different page, as this\n    // is already handled by the previous observable.\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"hash\"),\n    ),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with the same hash fragment as the current one in the\n    // URL. Is is essential that we only intercept those from instant navigation\n    // events and not from history change events, or we'll end up in and endless\n    // loop. The top-level history entry must be removed, as it will be replaced\n    // with a new one, which would otherwise lead to a duplicate entry.\n    location$.pipe(\n      distinctUntilChanged((a, b) => (\n        a.pathname === b.pathname &&\n        a.hash     === b.hash\n      )),\n      switchMap(() => instant$),\n      tap(() => history.back())\n    )\n  )\n    .subscribe(url => {\n\n      // Check if the current history entry has a state, which happens when the\n      // user presses the back or forward button to visit a page we've already\n      // seen. If there's no state, it means a new page was visited and we must\n      // scroll to the top, unless an anchor is given.\n      if (history.state !== null || !url.hash) {\n        window.scrollTo(0, history.state?.y ?? 0)\n      } else {\n        history.scrollRestoration = \"auto\"\n        setLocationHash(url.hash)\n        history.scrollRestoration = \"manual\"\n      }\n    })\n\n  // Disable scroll restoration when an instant navigation event occurs, so the\n  // browser does not immediately set the viewport offset to the prior history\n  // entry, scrolling to the position on the same page, which would look odd.\n  // Instead, we manually restore the position once the page has loaded.\n  location$.subscribe(() => {\n    history.scrollRestoration = \"manual\"\n  })\n\n  // Enable scroll restoration before window unloads - this is essential to\n  // ensure that full reloads (F5) restore the viewport offset correctly. If\n  // only popstate events wouldn't reset the viewport offset prior to their\n  // emission, we could just reset this in popstate. Meh.\n  fromEvent(window, \"beforeunload\")\n    .subscribe(() => {\n      history.scrollRestoration = \"auto\"\n    })\n\n  // Track viewport offset, so we can restore it when the user navigates back\n  // and forth between pages. Note that this must be debounced and cannot be\n  // done in popstate, as popstate has already removed the entry from the\n  // history, which means it is too late.\n  viewport$.pipe(\n    distinctUntilKeyChanged(\"offset\"),\n    debounceTime(100)\n  )\n    .subscribe(({ offset }) => {\n      history.replaceState(offset, \"\")\n    })\n\n  // Return document observable\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchConfig } from \"../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search configuration\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n  config: SearchConfig\n): SearchHighlightFactoryFn {\n  // Hack: temporarily remove pure lookaheads and lookbehinds\n  const regex = config.separator.split(\"|\").map(term => {\n    const temp = term.replace(/(\\(\\?[!=<][^)]+\\))/g, \"\")\n    return temp.length === 0 ? \"\uFFFD\" : term\n  })\n    .join(\"|\")\n\n  const separator = new RegExp(regex, \"img\")\n  const highlight = (_: unknown, data: string, term: string) => {\n    return `${data}<mark data-md-highlight>${term}</mark>`\n  }\n\n  /* Return factory function */\n  return (query: string) => {\n    query = query\n      .replace(/[\\s*+\\-:~^]+/g, \" \")\n      .trim()\n\n    /* Create search term match expression */\n    const match = new RegExp(`(^|${config.separator}|)(${\n      query\n        .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n        .replace(separator, \"|\")\n    })`, \"img\")\n\n    /* Highlight string value */\n    return value => escapeHTML(value)\n      .replace(match, highlight)\n      .replace(/<\\/mark>(\\s+)<mark[^>]*>/img, \"$1\")\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SearchResult } from \"../../_\"\nimport { SearchIndex } from \"../../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n  SETUP,                               /* Search index setup */\n  READY,                               /* Search index ready */\n  QUERY,                               /* Search query */\n  RESULT                               /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n  type: SearchMessageType.SETUP        /* Message type */\n  data: SearchIndex                    /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n  type: SearchMessageType.READY        /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n  type: SearchMessageType.QUERY        /* Message type */\n  data: string                         /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n  type: SearchMessageType.RESULT       /* Message type */\n  data: SearchResult                   /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n  | SearchSetupMessage\n  | SearchReadyMessage\n  | SearchQueryMessage\n  | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n  message: SearchMessage\n): message is SearchReadyMessage {\n  return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n  message: SearchMessage\n): message is SearchResultMessage {\n  return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ObservableInput,\n  Subject,\n  first,\n  merge,\n  of,\n  switchMap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { watchToggle, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates and initializes a web worker that is used for search,\n * so that the user interface doesn't freeze. In general, the application does\n * not care how search is implemented, as long as the web worker conforms to\n * the format expected by the application as defined in `SearchMessage`. This\n * allows the author to implement custom search functionality, by providing a\n * custom web worker via configuration.\n *\n * Material for MkDocs' built-in search implementation makes use of Lunr.js, an\n * efficient and fast implementation for client-side search. Leveraging a tiny\n * iframe-based web worker shim, search is even supported for the `file://`\n * protocol, enabling search for local non-hosted builds.\n *\n * If the protocol is `file://`, search initialization is deferred to mitigate\n * freezing, as it's now synchronous by design - see https://bit.ly/3C521EO\n *\n * @see https://bit.ly/3igvtQv - How to implement custom search\n *\n * @param url - Worker URL\n * @param index$ - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n  url: string, index$: ObservableInput<SearchIndex>\n): Subject<SearchMessage> {\n  const worker$ = watchWorker<SearchMessage>(url)\n  merge(\n    of(location.protocol !== \"file:\"),\n    watchToggle(\"search\")\n  )\n    .pipe(\n      first(active => active),\n      switchMap(() => index$)\n    )\n      .subscribe(({ config, docs }) => worker$.next({\n        type: SearchMessageType.SETUP,\n        data: {\n          config,\n          docs,\n          options: {\n            suggest: feature(\"search.suggest\")\n          }\n        }\n      }))\n\n  /* Return search worker */\n  return worker$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Subject,\n  catchError,\n  combineLatest,\n  filter,\n  fromEvent,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  getElement,\n  getLocation,\n  requestJSON,\n  setLocation\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n  Version,\n  renderVersionSelector\n} from \"~/templates\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  document$: Subject<Document>         /* Document subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n *\n * @param options - Options\n */\nexport function setupVersionSelector(\n  { document$ }: SetupOptions\n): void {\n  const config = configuration()\n  const versions$ = requestJSON<Version[]>(\n    new URL(\"../versions.json\", config.base)\n  )\n    .pipe(\n      catchError(() => EMPTY) // @todo refactor instant loading\n    )\n\n  /* Determine current version */\n  const current$ = versions$\n    .pipe(\n      map(versions => {\n        const [, current] = config.base.match(/([^/]+)\\/?$/)!\n        return versions.find(({ version, aliases }) => (\n          version === current || aliases.includes(current)\n        )) || versions[0]\n      })\n    )\n\n  /* Intercept inter-version navigation */\n  versions$\n    .pipe(\n      map(versions => new Map(versions.map(version => [\n        `${new URL(`../${version.version}/`, config.base)}`,\n        version\n      ]))),\n      switchMap(urls => fromEvent<MouseEvent>(document.body, \"click\")\n        .pipe(\n          filter(ev => !ev.metaKey && !ev.ctrlKey),\n          withLatestFrom(current$),\n          switchMap(([ev, current]) => {\n            if (ev.target instanceof Element) {\n              const el = ev.target.closest(\"a\")\n              if (el && !el.target && urls.has(el.href)) {\n                const url = el.href\n                // This is a temporary hack to detect if a version inside the\n                // version selector or on another part of the site was clicked.\n                // If we're inside the version selector, we definitely want to\n                // find the same page, as we might have different deployments\n                // due to aliases. However, if we're outside the version\n                // selector, we must abort here, because we might otherwise\n                // interfere with instant navigation. We need to refactor this\n                // at some point together with instant navigation.\n                //\n                // See https://github.com/squidfunk/mkdocs-material/issues/4012\n                if (!ev.target.closest(\".md-version\")) {\n                  const version = urls.get(url)!\n                  if (version === current)\n                    return EMPTY\n                }\n                ev.preventDefault()\n                return of(url)\n              }\n            }\n            return EMPTY\n          }),\n          switchMap(url => {\n            const { version } = urls.get(url)!\n            return fetchSitemap(new URL(url))\n              .pipe(\n                map(sitemap => {\n                  const location = getLocation()\n                  const path = location.href.replace(config.base, \"\")\n                  return sitemap.has(path.split(\"#\")[0])\n                    ? new URL(`../${version}/${path}`, config.base)\n                    : new URL(url)\n                })\n              )\n          })\n        )\n      )\n    )\n      .subscribe(url => setLocation(url, true))\n\n  /* Render version selector and warning */\n  combineLatest([versions$, current$])\n    .subscribe(([versions, current]) => {\n      const topic = getElement(\".md-header__topic\")\n      topic.appendChild(renderVersionSelector(versions, current))\n    })\n\n  /* Integrate outdated version banner with instant navigation */\n  document$.pipe(switchMap(() => current$))\n    .subscribe(current => {\n\n      /* Check if version state was already determined */\n      let outdated = __md_get(\"__outdated\", sessionStorage)\n      if (outdated === null) {\n        outdated = true\n\n        /* Obtain and normalize default versions */\n        let ignored = config.version?.default || \"latest\"\n        if (!Array.isArray(ignored))\n          ignored = [ignored]\n\n        /* Check if version is considered a default */\n        main: for (const ignore of ignored)\n          for (const version of current.aliases.concat(current.version))\n            if (new RegExp(ignore, \"i\").test(version)) {\n              outdated = false\n              break main\n            }\n\n        /* Persist version state in session storage */\n        __md_set(\"__outdated\", outdated, sessionStorage)\n      }\n\n      /* Unhide outdated version banner */\n      if (outdated)\n        for (const warning of getComponentElements(\"outdated\"))\n          warning.hidden = false\n    })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  first,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  shareReplay,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getLocation,\n  setToggle,\n  watchElementFocus,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchMessageType,\n  isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n  value: string                        /* Query value */\n  focus: boolean                       /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n  el: HTMLInputElement, { worker$ }: WatchOptions\n): Observable<SearchQuery> {\n\n  /* Support search deep linking */\n  const { searchParams } = getLocation()\n  if (searchParams.has(\"q\")) {\n    setToggle(\"search\", true)\n\n    /* Set query from parameter */\n    el.value = searchParams.get(\"q\")!\n    el.focus()\n\n    /* Remove query parameter on close */\n    watchToggle(\"search\")\n      .pipe(\n        first(active => !active)\n      )\n        .subscribe(() => {\n          const url = getLocation()\n          url.searchParams.delete(\"q\")\n          history.replaceState({}, \"\", `${url}`)\n        })\n  }\n\n  /* Intercept focus and input events */\n  const focus$ = watchElementFocus(el)\n  const value$ = merge(\n    worker$.pipe(first(isSearchReadyMessage)),\n    fromEvent(el, \"keyup\"),\n    focus$\n  )\n    .pipe(\n      map(() => el.value),\n      distinctUntilChanged()\n    )\n\n  /* Combine into single observable */\n  return combineLatest([value$, focus$])\n    .pipe(\n      map(([value, focus]) => ({ value, focus })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n  el: HTMLInputElement, { worker$ }: MountOptions\n): Observable<Component<SearchQuery, HTMLInputElement>> {\n  const push$ = new Subject<SearchQuery>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n  /* Handle value change */\n  combineLatest([\n    worker$.pipe(first(isSearchReadyMessage)),\n    push$\n  ], (_, query) => query)\n    .pipe(\n      distinctUntilKeyChanged(\"value\")\n    )\n      .subscribe(({ value }) => worker$.next({\n        type: SearchMessageType.QUERY,\n        data: value\n      }))\n\n  /* Handle focus change */\n  push$\n    .pipe(\n      distinctUntilKeyChanged(\"focus\")\n    )\n      .subscribe(({ focus }) => {\n        if (focus)\n          setToggle(\"search\", focus)\n      })\n\n  /* Handle reset */\n  fromEvent(el.form!, \"reset\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(() => el.focus())\n\n  // Focus search query on label click - note that this is necessary to bring\n  // up the keyboard on iOS and other mobile platforms, as the search dialog is\n  // not visible at first, and programatically focusing an input element must\n  // be triggered by a user interaction - see https://t.ly/Cb30n\n  const label = getElement(\"header [for=__search]\")\n  fromEvent(label, \"click\")\n    .subscribe(() => el.focus())\n\n  /* Create and return component */\n  return watchSearchQuery(el, { worker$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  bufferCount,\n  filter,\n  finalize,\n  first,\n  fromEvent,\n  map,\n  merge,\n  mergeMap,\n  of,\n  share,\n  skipUntil,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom,\n  zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n  getElement,\n  getOptionalElement,\n  watchElementBoundary,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchReadyMessage,\n  isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n  el: HTMLElement, { worker$, query$ }: MountOptions\n): Observable<Component<SearchResult>> {\n  const push$ = new Subject<SearchResult>()\n  const boundary$ = watchElementBoundary(el.parentElement!)\n    .pipe(\n      filter(Boolean)\n    )\n\n  /* Retrieve container */\n  const container = el.parentElement!\n\n  /* Retrieve nested components */\n  const meta = getElement(\":scope > :first-child\", el)\n  const list = getElement(\":scope > :last-child\", el)\n\n  /* Reveal to accessibility tree \u2013 see https://bit.ly/3iAA7t8 */\n  watchToggle(\"search\")\n    .subscribe(active => list.setAttribute(\n      \"role\", active ? \"list\" : \"presentation\"\n    ))\n\n  /* Update search result metadata */\n  push$\n    .pipe(\n      withLatestFrom(query$),\n      skipUntil(worker$.pipe(first(isSearchReadyMessage)))\n    )\n      .subscribe(([{ items }, { value }]) => {\n        switch (items.length) {\n\n          /* No results */\n          case 0:\n            meta.textContent = value.length\n              ? translation(\"search.result.none\")\n              : translation(\"search.result.placeholder\")\n            break\n\n          /* One result */\n          case 1:\n            meta.textContent = translation(\"search.result.one\")\n            break\n\n          /* Multiple result */\n          default:\n            const count = round(items.length)\n            meta.textContent = translation(\"search.result.other\", count)\n        }\n      })\n\n  /* Render search result item */\n  const render$ = push$\n    .pipe(\n      tap(() => list.innerHTML = \"\"),\n      switchMap(({ items }) => merge(\n        of(...items.slice(0, 10)),\n        of(...items.slice(10))\n          .pipe(\n            bufferCount(4),\n            zipWith(boundary$),\n            switchMap(([chunk]) => chunk)\n          )\n      )),\n      map(renderSearchResultItem),\n      share()\n    )\n\n  /* Update search result list */\n  render$.subscribe(item => list.appendChild(item))\n  render$\n    .pipe(\n      mergeMap(item => {\n        const details = getOptionalElement(\"details\", item)\n        if (typeof details === \"undefined\")\n          return EMPTY\n\n        /* Keep position of details element stable */\n        return fromEvent(details, \"toggle\")\n          .pipe(\n            takeUntil(push$),\n            map(() => details)\n          )\n      })\n    )\n      .subscribe(details => {\n        if (\n          details.open === false &&\n          details.offsetTop <= container.scrollTop\n        )\n          container.scrollTo({ top: details.offsetTop })\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n  url: URL                             /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n  _el: HTMLElement, { query$ }: WatchOptions\n): Observable<SearchShare> {\n  return query$\n    .pipe(\n      map(({ value }) => {\n        const url = getLocation()\n        url.hash = \"\"\n\n        /* Compute readable query strings */\n        value = value\n          .replace(/\\s+/g, \"+\")        /* Collapse whitespace */\n          .replace(/&/g, \"%26\")        /* Escape '&' character */\n          .replace(/=/g, \"%3D\")        /* Escape '=' character */\n\n        /* Replace query string */\n        url.search = `q=${value}`\n        return { url }\n      })\n    )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n  el: HTMLAnchorElement, options: MountOptions\n): Observable<Component<SearchShare>> {\n  const push$ = new Subject<SearchShare>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe(({ url }) => {\n    el.setAttribute(\"data-clipboard-text\", el.href)\n    el.href = `${url}`\n  })\n\n  /* Prevent following of link */\n  fromEvent(el, \"click\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(ev => ev.preventDefault())\n\n  /* Create and return component */\n  return watchSearchShare(el, options)\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  combineLatestWith,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  observeOn,\n  tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n  el: HTMLElement, { worker$, keyboard$ }: MountOptions\n): Observable<Component<SearchSuggest>> {\n  const push$ = new Subject<SearchResult>()\n\n  /* Retrieve query component and track all changes */\n  const query  = getComponentElement(\"search-query\")\n  const query$ = merge(\n    fromEvent(query, \"keydown\"),\n    fromEvent(query, \"focus\")\n  )\n    .pipe(\n      observeOn(asyncScheduler),\n      map(() => query.value),\n      distinctUntilChanged(),\n    )\n\n  /* Update search suggestions */\n  push$\n    .pipe(\n      combineLatestWith(query$),\n      map(([{ suggest }, value]) => {\n        const words = value.split(/([\\s-]+)/)\n        if (suggest?.length && words[words.length - 1]) {\n          const last = suggest[suggest.length - 1]\n          if (last.startsWith(words[words.length - 1]))\n            words[words.length - 1] = last\n        } else {\n          words.length = 0\n        }\n        return words\n      })\n    )\n      .subscribe(words => el.innerHTML = words\n        .join(\"\")\n        .replace(/\\s/g, \"&nbsp;\")\n      )\n\n  /* Set up search keyboard handlers */\n  keyboard$\n    .pipe(\n      filter(({ mode }) => mode === \"search\")\n    )\n      .subscribe(key => {\n        switch (key.type) {\n\n          /* Right arrow: accept current suggestion */\n          case \"ArrowRight\":\n            if (\n              el.innerText.length &&\n              query.selectionStart === query.value.length\n            )\n              query.value = el.innerText\n            break\n        }\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  ObservableInput,\n  filter,\n  fromEvent,\n  merge,\n  mergeWith\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  Keyboard,\n  getActiveElement,\n  getElements,\n  setToggle\n} from \"~/browser\"\nimport {\n  SearchIndex,\n  SearchResult,\n  setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n  Component,\n  getComponentElement,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SearchQuery,\n  mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n  SearchShare,\n  mountSearchShare\n} from \"../share\"\nimport {\n  SearchSuggest,\n  mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n  | SearchQuery\n  | SearchResult\n  | SearchShare\n  | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n  el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable<Component<Search>> {\n  const config = configuration()\n  try {\n    const worker$ = setupSearchWorker(config.search, index$)\n\n    /* Retrieve query and result components */\n    const query  = getComponentElement(\"search-query\", el)\n    const result = getComponentElement(\"search-result\", el)\n\n    /* Always close search on result selection */\n    fromEvent<PointerEvent>(el, \"click\")\n      .pipe(\n        filter(({ target }) => (\n          target instanceof Element && !!target.closest(\"a\")\n        ))\n      )\n        .subscribe(() => setToggle(\"search\", false))\n\n    /* Set up search keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"search\")\n      )\n        .subscribe(key => {\n          const active = getActiveElement()\n          switch (key.type) {\n\n            /* Enter: go to first (best) result */\n            case \"Enter\":\n              if (active === query) {\n                const anchors = new Map<HTMLAnchorElement, number>()\n                for (const anchor of getElements<HTMLAnchorElement>(\n                  \":first-child [href]\", result\n                )) {\n                  const article = anchor.firstElementChild!\n                  anchors.set(anchor, parseFloat(\n                    article.getAttribute(\"data-md-score\")!\n                  ))\n                }\n\n                /* Go to result with highest score, if any */\n                if (anchors.size) {\n                  const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n                  best.click()\n                }\n\n                /* Otherwise omit form submission */\n                key.claim()\n              }\n              break\n\n            /* Escape or Tab: close search */\n            case \"Escape\":\n            case \"Tab\":\n              setToggle(\"search\", false)\n              query.blur()\n              break\n\n            /* Vertical arrows: select previous or next search result */\n            case \"ArrowUp\":\n            case \"ArrowDown\":\n              if (typeof active === \"undefined\") {\n                query.focus()\n              } else {\n                const els = [query, ...getElements(\n                  \":not(details) > [href], summary, details[open] [href]\",\n                  result\n                )]\n                const i = Math.max(0, (\n                  Math.max(0, els.indexOf(active)) + els.length + (\n                    key.type === \"ArrowUp\" ? -1 : +1\n                  )\n                ) % els.length)\n                els[i].focus()\n              }\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n\n            /* All other keys: hand to search query */\n            default:\n              if (query !== getActiveElement())\n                query.focus()\n          }\n        })\n\n    /* Set up global keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"global\")\n      )\n        .subscribe(key => {\n          switch (key.type) {\n\n            /* Open search and select query */\n            case \"f\":\n            case \"s\":\n            case \"/\":\n              query.focus()\n              query.select()\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n          }\n        })\n\n    /* Create and return component */\n    const query$ = mountSearchQuery(query, { worker$ })\n    return merge(\n      query$,\n      mountSearchResult(result, { worker$, query$ })\n    )\n      .pipe(\n        mergeWith(\n\n          /* Search sharing */\n          ...getComponentElements(\"search-share\", el)\n            .map(child => mountSearchShare(child, { query$ })),\n\n          /* Search suggestions */\n          ...getComponentElements(\"search-suggest\", el)\n            .map(child => mountSearchSuggest(child, { worker$, keyboard$ }))\n        )\n      )\n\n  /* Gracefully handle broken search */\n  } catch (err) {\n    el.hidden = true\n    return NEVER\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  ObservableInput,\n  combineLatest,\n  filter,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n  SearchIndex,\n  setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n  nodes: Map<ChildNode, string>        /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  location$: Observable<URL>           /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n  el: HTMLElement, { index$, location$ }: MountOptions\n): Observable<Component<SearchHighlight>> {\n  return combineLatest([\n    index$,\n    location$\n      .pipe(\n        startWith(getLocation()),\n        filter(url => !!url.searchParams.get(\"h\"))\n      )\n  ])\n    .pipe(\n      map(([index, url]) => setupSearchHighlighter(index.config)(\n        url.searchParams.get(\"h\")!\n      )),\n      map(fn => {\n        const nodes = new Map<ChildNode, string>()\n\n        /* Traverse text nodes and collect matches */\n        const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n        for (let node = it.nextNode(); node; node = it.nextNode()) {\n          if (node.parentElement?.offsetHeight) {\n            const original = node.textContent!\n            const replaced = fn(original)\n            if (replaced.length > original.length)\n              nodes.set(node as ChildNode, replaced)\n          }\n        }\n\n        /* Replace original nodes with matches */\n        for (const [node, text] of nodes) {\n          const { childNodes } = h(\"span\", null, text)\n          node.replaceWith(...Array.from(childNodes))\n        }\n\n        /* Return component */\n        return { ref: el, nodes }\n      })\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  finalize,\n  first,\n  from,\n  fromEvent,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElement,\n  getElementOffset,\n  getElementSize,\n  getElements\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n  height: number                       /* Sidebar height */\n  locked: boolean                      /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n  el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable<Sidebar> {\n  const parent = el.closest<HTMLElement>(\".md-grid\")!\n  const adjust =\n    parent.offsetTop -\n    parent.parentElement!.offsetTop\n\n  /* Compute the sidebar's available height and if it should be locked */\n  return combineLatest([main$, viewport$])\n    .pipe(\n      map(([{ offset, height }, { offset: { y } }]) => {\n        height = height\n          + Math.min(adjust, Math.max(0, y - offset))\n          - adjust\n        return {\n          height,\n          locked: y >= offset + adjust\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.locked === b.locked\n      ))\n    )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n  el: HTMLElement, { header$, ...options }: MountOptions\n): Observable<Component<Sidebar>> {\n  const inner = getElement(\".md-sidebar__scrollwrap\", el)\n  const { y } = getElementOffset(inner)\n  return defer(() => {\n    const push$ = new Subject<Sidebar>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    const next$ = push$\n      .pipe(\n        auditTime(0, animationFrameScheduler)\n      )\n\n    /* Update sidebar height and offset */\n    next$.pipe(withLatestFrom(header$))\n      .subscribe({\n\n        /* Handle emission */\n        next([{ height }, { height: offset }]) {\n          inner.style.height = `${height - 2 * y}px`\n          el.style.top       = `${offset}px`\n        },\n\n        /* Handle complete */\n        complete() {\n          inner.style.height = \"\"\n          el.style.top       = \"\"\n        }\n      })\n\n    /* Bring active item into view on initial load */\n    next$.pipe(first())\n      .subscribe(() => {\n        for (const item of getElements(\".md-nav__link--active[href]\", el)) {\n          if (!item.clientHeight) // skip invisible toc in left sidebar\n            continue\n          const container = item.closest<HTMLElement>(\".md-sidebar__scrollwrap\")!\n          if (typeof container !== \"undefined\") {\n            const offset = item.offsetTop - container.offsetTop\n            const { height } = getElementSize(container)\n            container.scrollTo({\n              top: offset - height / 2\n            })\n          }\n        }\n      })\n\n    /* Handle accessibility for expandable items, see https://bit.ly/3jaod9p */\n    from(getElements<HTMLLabelElement>(\"label[tabindex]\", el))\n      .pipe(\n        mergeMap(label => fromEvent(label, \"click\")\n          .pipe(\n            observeOn(asyncScheduler),\n            map(() => label),\n            takeUntil(done$)\n          )\n        )\n      )\n        .subscribe(label => {\n          const input = getElement<HTMLInputElement>(`[id=\"${label.htmlFor}\"]`)\n          const nav = getElement(`[aria-labelledby=\"${label.id}\"]`)\n          nav.setAttribute(\"aria-expanded\", `${input.checked}`)\n        })\n\n    /* Create and return component */\n    return watchSidebar(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Repo, User } from \"github-types\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n  user: string, repo?: string\n): Observable<SourceFacts> {\n  if (typeof repo !== \"undefined\") {\n    const url = `https://api.github.com/repos/${user}/${repo}`\n    return zip(\n\n      /* Fetch version */\n      requestJSON<Release>(`${url}/releases/latest`)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(release => ({\n            version: release.tag_name\n          })),\n          defaultIfEmpty({})\n        ),\n\n      /* Fetch stars and forks */\n      requestJSON<Repo>(url)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(info => ({\n            stars: info.stargazers_count,\n            forks: info.forks_count\n          })),\n          defaultIfEmpty({})\n        )\n    )\n      .pipe(\n        map(([release, info]) => ({ ...release, ...info }))\n      )\n\n  /* User or organization */\n  } else {\n    const url = `https://api.github.com/users/${user}`\n    return requestJSON<User>(url)\n      .pipe(\n        map(info => ({\n          repositories: info.public_repos\n        })),\n        defaultIfEmpty({})\n      )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ProjectSchema } from \"gitlab\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n  base: string, project: string\n): Observable<SourceFacts> {\n  const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n  return requestJSON<ProjectSchema>(url)\n    .pipe(\n      catchError(() => EMPTY), // @todo refactor instant loading\n      map(({ star_count, forks_count }) => ({\n        stars: star_count,\n        forks: forks_count\n      })),\n      defaultIfEmpty({})\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n  stars?: number                       /* Number of stars */\n  forks?: number                       /* Number of forks */\n  version?: string                     /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n  repositories?: number                /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n  | RepositoryFacts\n  | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n  url: string\n): Observable<SourceFacts> {\n\n  /* Try to match GitHub repository */\n  let match = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)\n  if (match) {\n    const [, user, repo] = match\n    return fetchSourceFactsFromGitHub(user, repo)\n  }\n\n  /* Try to match GitLab repository */\n  match = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)\n  if (match) {\n    const [, base, slug] = match\n    return fetchSourceFactsFromGitLab(base, slug)\n  }\n\n  /* Fallback */\n  return EMPTY\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  defer,\n  filter,\n  finalize,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { ConsentDefaults } from \"~/components/consent\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport {\n  Component,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SourceFacts,\n  fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n  facts: SourceFacts                   /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable<Source>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n  el: HTMLAnchorElement\n): Observable<Source> {\n  return fetch$ ||= defer(() => {\n    const cached = __md_get<SourceFacts>(\"__source\", sessionStorage)\n    if (cached) {\n      return of(cached)\n    } else {\n\n      /* Check if consent is configured and was given */\n      const els = getComponentElements(\"consent\")\n      if (els.length) {\n        const consent = __md_get<ConsentDefaults>(\"__consent\")\n        if (!(consent && consent.github))\n          return EMPTY\n      }\n\n      /* Fetch repository facts */\n      return fetchSourceFacts(el.href)\n        .pipe(\n          tap(facts => __md_set(\"__source\", facts, sessionStorage))\n        )\n    }\n  })\n    .pipe(\n      catchError(() => EMPTY),\n      filter(facts => Object.keys(facts).length > 0),\n      map(facts => ({ facts })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n  el: HTMLAnchorElement\n): Observable<Component<Source>> {\n  const inner = getElement(\":scope > :last-child\", el)\n  return defer(() => {\n    const push$ = new Subject<Source>()\n    push$.subscribe(({ facts }) => {\n      inner.appendChild(renderSourceFacts(facts))\n      inner.classList.add(\"md-source__repository--active\")\n    })\n\n    /* Create and return component */\n    return watchSource(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  watchElementSize,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n  hidden: boolean                      /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Tabs> {\n  return watchElementSize(document.body)\n    .pipe(\n      switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n      map(({ offset: { y } }) => {\n        return {\n          hidden: y >= 10\n        }\n      }),\n      distinctUntilKeyChanged(\"hidden\")\n    )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Tabs>> {\n  return defer(() => {\n    const push$ = new Subject<Tabs>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ hidden }) {\n        el.hidden = hidden\n      },\n\n      /* Handle complete */\n      complete() {\n        el.hidden = false\n      }\n    })\n\n    /* Create and return component */\n    return (\n      feature(\"navigation.tabs.sticky\")\n        ? of({ hidden: false })\n        : watchTabs(el, options)\n    )\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  bufferCount,\n  combineLatestWith,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  finalize,\n  ignoreElements,\n  map,\n  merge,\n  observeOn,\n  of,\n  repeat,\n  scan,\n  share,\n  skip,\n  startWith,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContainer,\n  getElementSize,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  watchElementSize\n} from \"~/browser\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n  prev: HTMLAnchorElement[][]          /* Anchors (previous) */\n  next: HTMLAnchorElement[][]          /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<TableOfContents> {\n  const table = new Map<HTMLAnchorElement, HTMLElement>()\n\n  /* Compute anchor-to-target mapping */\n  const anchors = getElements<HTMLAnchorElement>(\".md-nav__link\", el)\n  for (const anchor of anchors) {\n    const id = decodeURIComponent(anchor.hash.substring(1))\n    const target = getOptionalElement(`[id=\"${id}\"]`)\n    if (typeof target !== \"undefined\")\n      table.set(anchor, target)\n  }\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n      map(({ height }) => {\n        const main = getComponentElement(\"main\")\n        const grid = getElement(\":scope > :first-child\", main)\n        return height + 0.8 * (\n          grid.offsetTop -\n          main.offsetTop\n        )\n      }),\n      share()\n    )\n\n  /* Compute partition of previous and next anchors */\n  const partition$ = watchElementSize(document.body)\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n\n      /* Build index to map anchor paths to vertical offsets */\n      switchMap(body => defer(() => {\n        let path: HTMLAnchorElement[] = []\n        return of([...table].reduce((index, [anchor, target]) => {\n          while (path.length) {\n            const last = table.get(path[path.length - 1])!\n            if (last.tagName >= target.tagName) {\n              path.pop()\n            } else {\n              break\n            }\n          }\n\n          /* If the current anchor is hidden, continue with its parent */\n          let offset = target.offsetTop\n          while (!offset && target.parentElement) {\n            target = target.parentElement\n            offset = target.offsetTop\n          }\n\n          /* Fix anchor offsets in tables - see https://bit.ly/3CUFOcn */\n          let parent = target.offsetParent as HTMLElement\n          for (; parent; parent = parent.offsetParent as HTMLElement)\n            offset += parent.offsetTop\n\n          /* Map reversed anchor path to vertical offset */\n          return index.set(\n            [...path = [...path, anchor]].reverse(),\n            offset\n          )\n        }, new Map<HTMLAnchorElement[], number>()))\n      })\n        .pipe(\n\n          /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n          map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n          combineLatestWith(adjust$),\n\n          /* Re-compute partition when viewport offset changes */\n          switchMap(([index, adjust]) => viewport$\n            .pipe(\n              scan(([prev, next], { offset: { y }, size }) => {\n                const last = y + size.height >= Math.floor(body.height)\n\n                /* Look forward */\n                while (next.length) {\n                  const [, offset] = next[0]\n                  if (offset - adjust < y || last) {\n                    prev = [...prev, next.shift()!]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Look backward */\n                while (prev.length) {\n                  const [, offset] = prev[prev.length - 1]\n                  if (offset - adjust >= y && !last) {\n                    next = [prev.pop()!, ...next]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Return partition */\n                return [prev, next]\n              }, [[], [...index]]),\n              distinctUntilChanged((a, b) => (\n                a[0] === b[0] &&\n                a[1] === b[1]\n              ))\n            )\n          )\n        )\n      )\n    )\n\n  /* Compute and return anchor list migrations */\n  return partition$\n    .pipe(\n      map(([prev, next]) => ({\n        prev: prev.map(([path]) => path),\n        next: next.map(([path]) => path)\n      })),\n\n      /* Extract anchor list migrations */\n      startWith({ prev: [], next: [] }),\n      bufferCount(2, 1),\n      map(([a, b]) => {\n\n        /* Moving down */\n        if (a.prev.length < b.prev.length) {\n          return {\n            prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n            next: []\n          }\n\n        /* Moving up */\n        } else {\n          return {\n            prev: b.prev.slice(-1),\n            next: b.next.slice(0, b.next.length - a.next.length)\n          }\n        }\n      })\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<TableOfContents>> {\n  return defer(() => {\n    const push$ = new Subject<TableOfContents>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe(({ prev, next }) => {\n\n      /* Look forward */\n      for (const [anchor] of next) {\n        anchor.classList.remove(\"md-nav__link--passed\")\n        anchor.classList.remove(\"md-nav__link--active\")\n      }\n\n      /* Look backward */\n      for (const [index, [anchor]] of prev.entries()) {\n        anchor.classList.add(\"md-nav__link--passed\")\n        anchor.classList.toggle(\n          \"md-nav__link--active\",\n          index === prev.length - 1\n        )\n      }\n    })\n\n    /* Set up following, if enabled */\n    if (feature(\"toc.follow\")) {\n\n      /* Toggle smooth scrolling only for anchor clicks */\n      const smooth$ = merge(\n        viewport$.pipe(debounceTime(1), map(() => undefined)),\n        viewport$.pipe(debounceTime(250), map(() => \"smooth\" as const))\n      )\n\n      /* Bring active anchor into view */ // @todo: refactor\n      push$\n        .pipe(\n          filter(({ prev }) => prev.length > 0),\n          combineLatestWith(main$.pipe(observeOn(asyncScheduler))),\n          withLatestFrom(smooth$)\n        )\n          .subscribe(([[{ prev }], behavior]) => {\n            const [anchor] = prev[prev.length - 1]\n            if (anchor.offsetHeight) {\n\n              /* Retrieve overflowing container and scroll */\n              const container = getElementContainer(anchor)\n              if (typeof container !== \"undefined\") {\n                const offset = anchor.offsetTop - container.offsetTop\n                const { height } = getElementSize(container)\n                container.scrollTo({\n                  top: offset - height / 2,\n                  behavior\n                })\n              }\n            }\n          })\n    }\n\n    /* Set up anchor tracking, if enabled */\n    if (feature(\"navigation.tracking\"))\n      viewport$\n        .pipe(\n          takeUntil(done$),\n          distinctUntilKeyChanged(\"offset\"),\n          debounceTime(250),\n          skip(1),\n          takeUntil(target$.pipe(skip(1))),\n          repeat({ delay: 250 }),\n          withLatestFrom(push$)\n        )\n          .subscribe(([, { prev }]) => {\n            const url = getLocation()\n\n            /* Set hash fragment to active anchor */\n            const anchor = prev[prev.length - 1]\n            if (anchor && anchor.length) {\n              const [active] = anchor\n              const { hash } = new URL(active.href)\n              if (url.hash !== hash) {\n                url.hash = hash\n                history.replaceState({}, \"\", `${url}`)\n              }\n\n            /* Reset anchor when at the top */\n            } else {\n              url.hash = \"\"\n              history.replaceState({}, \"\", `${url}`)\n            }\n          })\n\n    /* Create and return component */\n    return watchTableOfContents(el, { viewport$, header$ })\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  repeat,\n  skip,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n  hidden: boolean                      /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n  _el: HTMLElement, { viewport$, main$, target$ }: WatchOptions\n): Observable<BackToTop> {\n\n  /* Compute direction */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => a > b && b > 0),\n      distinctUntilChanged()\n    )\n\n  /* Compute whether main area is active */\n  const active$ = main$\n    .pipe(\n      map(({ active }) => active)\n    )\n\n  /* Compute threshold for hiding */\n  return combineLatest([active$, direction$])\n    .pipe(\n      map(([active, direction]) => !(active && direction)),\n      distinctUntilChanged(),\n      takeUntil(target$.pipe(skip(1))),\n      endWith(true),\n      repeat({ delay: 250 }),\n      map(hidden => ({ hidden }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<BackToTop>> {\n  const push$ = new Subject<BackToTop>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe({\n\n    /* Handle emission */\n    next({ hidden }) {\n      el.hidden = hidden\n      if (hidden) {\n        el.setAttribute(\"tabindex\", \"-1\")\n        el.blur()\n      } else {\n        el.removeAttribute(\"tabindex\")\n      }\n    },\n\n    /* Handle complete */\n    complete() {\n      el.style.top = \"\"\n      el.hidden = true\n      el.removeAttribute(\"tabindex\")\n    }\n  })\n\n  /* Watch header height */\n  header$\n    .pipe(\n      takeUntil(done$),\n      distinctUntilKeyChanged(\"height\")\n    )\n      .subscribe(({ height }) => {\n        el.style.top = `${height + 16}px`\n      })\n\n  /* Go back to top */\n  fromEvent(el, \"click\")\n    .subscribe(ev => {\n      ev.preventDefault()\n      window.scrollTo({ top: 0 })\n    })\n\n  /* Create and return component */\n  return watchBackToTop(el, { viewport$, main$, target$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  finalize,\n  map,\n  mergeMap,\n  skip,\n  switchMap,\n  take,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  getElements,\n  watchElementVisibility\n} from \"~/browser\"\nimport { mountTooltip } from \"~/components\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch ellipsis\n *\n * This function will fetch all elements that are shortened with ellipsis, and\n * filter those which are visible. Once they become visible, they stay in that\n * state, even though they may be hidden again. This optimization is necessary\n * to reduce pressure on the browser, with elements fading in and out of view.\n *\n * @param options - Options\n */\nexport function patchEllipsis(\n  { document$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-ellipsis\")),\n      mergeMap(el => watchElementVisibility(el)\n        .pipe(\n          takeUntil(document$.pipe(skip(1))),\n          filter(visible => visible),\n          map(() => el),\n          take(1)\n        )\n      ),\n      filter(el => el.offsetWidth < el.scrollWidth),\n      mergeMap(el => {\n        const text = el.innerText\n        const host = el.closest(\"a\") || el\n        host.title = text\n\n        /* Mount tooltip */\n        return mountTooltip(host)\n          .pipe(\n            takeUntil(document$.pipe(skip(1))),\n            finalize(() => host.removeAttribute(\"title\"))\n          )\n      })\n    )\n      .subscribe()\n\n  // @todo move this outside of here and fix memleaks\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-status\")),\n      mergeMap(el => mountTooltip(el))\n    )\n      .subscribe()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  takeWhile,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n  { document$, tablet$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements<HTMLInputElement>(\n        \".md-toggle--indeterminate\"\n      )),\n      tap(el => {\n        el.indeterminate = true\n        el.checked = false\n      }),\n      mergeMap(el => fromEvent(el, \"change\")\n        .pipe(\n          takeWhile(() => el.classList.contains(\"md-toggle--indeterminate\")),\n          map(() => el)\n        )\n      ),\n      withLatestFrom(tablet$)\n    )\n      .subscribe(([el, tablet]) => {\n        el.classList.remove(\"md-toggle--indeterminate\")\n        if (tablet)\n          el.checked = false\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n  return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n  { document$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\"[data-md-scrollfix]\")),\n      tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n      filter(isAppleDevice),\n      mergeMap(el => fromEvent(el, \"touchstart\")\n        .pipe(\n          map(() => el)\n        )\n      )\n    )\n      .subscribe(el => {\n        const top = el.scrollTop\n\n        /* We're at the top of the container */\n        if (top === 0) {\n          el.scrollTop = 1\n\n        /* We're at the bottom of the container */\n        } else if (top + el.offsetHeight === el.scrollHeight) {\n          el.scrollTop = top - 1\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  delay,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n  { viewport$, tablet$ }: PatchOptions\n): void {\n  combineLatest([watchToggle(\"search\"), tablet$])\n    .pipe(\n      map(([active, tablet]) => active && !tablet),\n      switchMap(active => of(active)\n        .pipe(\n          delay(active ? 400 : 100)\n        )\n      ),\n      withLatestFrom(viewport$)\n    )\n      .subscribe(([active, { offset: { y }}]) => {\n        if (active) {\n          document.body.setAttribute(\"data-md-scrolllock\", \"\")\n          document.body.style.top = `-${y}px`\n        } else {\n          const value = -1 * parseInt(document.body.style.top, 10)\n          document.body.removeAttribute(\"data-md-scrolllock\")\n          document.body.style.top = \"\"\n          if (value)\n            window.scrollTo(0, value)\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n"],
-  "mappings": "2rCAAA,IAAAA,GAAAC,GAAA,CAAAC,GAAAC,KAAA,EAAC,SAAUC,EAAQC,EAAS,CAC1B,OAAOH,IAAY,UAAY,OAAOC,IAAW,YAAcE,EAAQ,EACvE,OAAO,QAAW,YAAc,OAAO,IAAM,OAAOA,CAAO,EAC1DA,EAAQ,CACX,GAAEH,GAAO,UAAY,CAAE,aASrB,SAASI,EAA0BC,EAAO,CACxC,IAAIC,EAAmB,GACnBC,EAA0B,GAC1BC,EAAiC,KAEjCC,EAAsB,CACxB,KAAM,GACN,OAAQ,GACR,IAAK,GACL,IAAK,GACL,MAAO,GACP,SAAU,GACV,OAAQ,GACR,KAAM,GACN,MAAO,GACP,KAAM,GACN,KAAM,GACN,SAAU,GACV,iBAAkB,EACpB,EAOA,SAASC,EAAmBC,EAAI,CAC9B,MACE,GAAAA,GACAA,IAAO,UACPA,EAAG,WAAa,QAChBA,EAAG,WAAa,QAChB,cAAeA,GACf,aAAcA,EAAG,UAKrB,CASA,SAASC,EAA8BD,EAAI,CACzC,IAAIE,GAAOF,EAAG,KACVG,GAAUH,EAAG,QAUjB,MARI,GAAAG,KAAY,SAAWL,EAAoBI,EAAI,GAAK,CAACF,EAAG,UAIxDG,KAAY,YAAc,CAACH,EAAG,UAI9BA,EAAG,kBAKT,CAOA,SAASI,EAAqBJ,EAAI,CAC5BA,EAAG,UAAU,SAAS,eAAe,IAGzCA,EAAG,UAAU,IAAI,eAAe,EAChCA,EAAG,aAAa,2BAA4B,EAAE,EAChD,CAOA,SAASK,EAAwBL,EAAI,CAC9BA,EAAG,aAAa,0BAA0B,IAG/CA,EAAG,UAAU,OAAO,eAAe,EACnCA,EAAG,gBAAgB,0BAA0B,EAC/C,CAUA,SAASM,EAAUC,EAAG,CAChBA,EAAE,SAAWA,EAAE,QAAUA,EAAE,UAI3BR,EAAmBL,EAAM,aAAa,GACxCU,EAAqBV,EAAM,aAAa,EAG1CC,EAAmB,GACrB,CAUA,SAASa,EAAcD,EAAG,CACxBZ,EAAmB,EACrB,CASA,SAASc,EAAQF,EAAG,CAEbR,EAAmBQ,EAAE,MAAM,IAI5BZ,GAAoBM,EAA8BM,EAAE,MAAM,IAC5DH,EAAqBG,EAAE,MAAM,CAEjC,CAMA,SAASG,EAAOH,EAAG,CACZR,EAAmBQ,EAAE,MAAM,IAK9BA,EAAE,OAAO,UAAU,SAAS,eAAe,GAC3CA,EAAE,OAAO,aAAa,0BAA0B,KAMhDX,EAA0B,GAC1B,OAAO,aAAaC,CAA8B,EAClDA,EAAiC,OAAO,WAAW,UAAW,CAC5DD,EAA0B,EAC5B,EAAG,GAAG,EACNS,EAAwBE,EAAE,MAAM,EAEpC,CAOA,SAASI,EAAmBJ,EAAG,CACzB,SAAS,kBAAoB,WAK3BX,IACFD,EAAmB,IAErBiB,EAA+B,EAEnC,CAQA,SAASA,GAAiC,CACxC,SAAS,iBAAiB,YAAaC,CAAoB,EAC3D,SAAS,iBAAiB,YAAaA,CAAoB,EAC3D,SAAS,iBAAiB,UAAWA,CAAoB,EACzD,SAAS,iBAAiB,cAAeA,CAAoB,EAC7D,SAAS,iBAAiB,cAAeA,CAAoB,EAC7D,SAAS,iBAAiB,YAAaA,CAAoB,EAC3D,SAAS,iBAAiB,YAAaA,CAAoB,EAC3D,SAAS,iBAAiB,aAAcA,CAAoB,EAC5D,SAAS,iBAAiB,WAAYA,CAAoB,CAC5D,CAEA,SAASC,IAAoC,CAC3C,SAAS,oBAAoB,YAAaD,CAAoB,EAC9D,SAAS,oBAAoB,YAAaA,CAAoB,EAC9D,SAAS,oBAAoB,UAAWA,CAAoB,EAC5D,SAAS,oBAAoB,cAAeA,CAAoB,EAChE,SAAS,oBAAoB,cAAeA,CAAoB,EAChE,SAAS,oBAAoB,YAAaA,CAAoB,EAC9D,SAAS,oBAAoB,YAAaA,CAAoB,EAC9D,SAAS,oBAAoB,aAAcA,CAAoB,EAC/D,SAAS,oBAAoB,WAAYA,CAAoB,CAC/D,CASA,SAASA,EAAqBN,EAAG,CAG3BA,EAAE,OAAO,UAAYA,EAAE,OAAO,SAAS,YAAY,IAAM,SAI7DZ,EAAmB,GACnBmB,GAAkC,EACpC,CAKA,SAAS,iBAAiB,UAAWR,EAAW,EAAI,EACpD,SAAS,iBAAiB,YAAaE,EAAe,EAAI,EAC1D,SAAS,iBAAiB,cAAeA,EAAe,EAAI,EAC5D,SAAS,iBAAiB,aAAcA,EAAe,EAAI,EAC3D,SAAS,iBAAiB,mBAAoBG,EAAoB,EAAI,EAEtEC,EAA+B,EAM/BlB,EAAM,iBAAiB,QAASe,EAAS,EAAI,EAC7Cf,EAAM,iBAAiB,OAAQgB,EAAQ,EAAI,EAOvChB,EAAM,WAAa,KAAK,wBAA0BA,EAAM,KAI1DA,EAAM,KAAK,aAAa,wBAAyB,EAAE,EAC1CA,EAAM,WAAa,KAAK,gBACjC,SAAS,gBAAgB,UAAU,IAAI,kBAAkB,EACzD,SAAS,gBAAgB,aAAa,wBAAyB,EAAE,EAErE,CAKA,GAAI,OAAO,QAAW,aAAe,OAAO,UAAa,YAAa,CAIpE,OAAO,0BAA4BD,EAInC,IAAIsB,EAEJ,GAAI,CACFA,EAAQ,IAAI,YAAY,8BAA8B,CACxD,OAASC,EAAO,CAEdD,EAAQ,SAAS,YAAY,aAAa,EAC1CA,EAAM,gBAAgB,+BAAgC,GAAO,GAAO,CAAC,CAAC,CACxE,CAEA,OAAO,cAAcA,CAAK,CAC5B,CAEI,OAAO,UAAa,aAGtBtB,EAA0B,QAAQ,CAGtC,CAAE,ICvTF,IAAAwB,GAAAC,GAAA,CAAAC,GAAAC,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMC,SAA0CC,EAAMC,EAAS,CACtD,OAAOH,IAAY,UAAY,OAAOC,IAAW,SACnDA,GAAO,QAAUE,EAAQ,EAClB,OAAO,QAAW,YAAc,OAAO,IAC9C,OAAO,CAAC,EAAGA,CAAO,EACX,OAAOH,IAAY,SAC1BA,GAAQ,YAAiBG,EAAQ,EAEjCD,EAAK,YAAiBC,EAAQ,CAChC,GAAGH,GAAM,UAAW,CACpB,OAAiB,UAAW,CAClB,IAAII,EAAuB,CAE/B,IACC,SAASC,EAAyBC,EAAqBC,EAAqB,CAEnF,aAGAA,EAAoB,EAAED,EAAqB,CACzC,QAAW,UAAW,CAAE,OAAqBE,EAAW,CAC1D,CAAC,EAGD,IAAIC,EAAeF,EAAoB,GAAG,EACtCG,EAAoCH,EAAoB,EAAEE,CAAY,EAEtEE,EAASJ,EAAoB,GAAG,EAChCK,EAA8BL,EAAoB,EAAEI,CAAM,EAE1DE,EAAaN,EAAoB,GAAG,EACpCO,EAA8BP,EAAoB,EAAEM,CAAU,EAOlE,SAASE,EAAQC,EAAM,CACrB,GAAI,CACF,OAAO,SAAS,YAAYA,CAAI,CAClC,OAASC,EAAK,CACZ,MAAO,EACT,CACF,CAUA,IAAIC,EAAqB,SAA4BC,EAAQ,CAC3D,IAAIC,EAAeN,EAAe,EAAEK,CAAM,EAC1C,OAAAJ,EAAQ,KAAK,EACNK,CACT,EAEiCC,EAAeH,EAOhD,SAASI,EAAkBC,EAAO,CAChC,IAAIC,EAAQ,SAAS,gBAAgB,aAAa,KAAK,IAAM,MACzDC,EAAc,SAAS,cAAc,UAAU,EAEnDA,EAAY,MAAM,SAAW,OAE7BA,EAAY,MAAM,OAAS,IAC3BA,EAAY,MAAM,QAAU,IAC5BA,EAAY,MAAM,OAAS,IAE3BA,EAAY,MAAM,SAAW,WAC7BA,EAAY,MAAMD,EAAQ,QAAU,MAAM,EAAI,UAE9C,IAAIE,EAAY,OAAO,aAAe,SAAS,gBAAgB,UAC/D,OAAAD,EAAY,MAAM,IAAM,GAAG,OAAOC,EAAW,IAAI,EACjDD,EAAY,aAAa,WAAY,EAAE,EACvCA,EAAY,MAAQF,EACbE,CACT,CAYA,IAAIE,EAAiB,SAAwBJ,EAAOK,EAAS,CAC3D,IAAIH,EAAcH,EAAkBC,CAAK,EACzCK,EAAQ,UAAU,YAAYH,CAAW,EACzC,IAAIL,EAAeN,EAAe,EAAEW,CAAW,EAC/C,OAAAV,EAAQ,MAAM,EACdU,EAAY,OAAO,EACZL,CACT,EASIS,GAAsB,SAA6BV,EAAQ,CAC7D,IAAIS,EAAU,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAChF,UAAW,SAAS,IACtB,EACIR,EAAe,GAEnB,OAAI,OAAOD,GAAW,SACpBC,EAAeO,EAAeR,EAAQS,CAAO,EACpCT,aAAkB,kBAAoB,CAAC,CAAC,OAAQ,SAAU,MAAO,MAAO,UAAU,EAAE,SAASA,GAAW,KAA4B,OAASA,EAAO,IAAI,EAEjKC,EAAeO,EAAeR,EAAO,MAAOS,CAAO,GAEnDR,EAAeN,EAAe,EAAEK,CAAM,EACtCJ,EAAQ,MAAM,GAGTK,CACT,EAEiCU,EAAgBD,GAEjD,SAASE,EAAQC,EAAK,CAAE,0BAA2B,OAAI,OAAO,QAAW,YAAc,OAAO,OAAO,UAAa,SAAYD,EAAU,SAAiBC,EAAK,CAAE,OAAO,OAAOA,CAAK,EAAYD,EAAU,SAAiBC,EAAK,CAAE,OAAOA,GAAO,OAAO,QAAW,YAAcA,EAAI,cAAgB,QAAUA,IAAQ,OAAO,UAAY,SAAW,OAAOA,CAAK,EAAYD,EAAQC,CAAG,CAAG,CAUzX,IAAIC,GAAyB,UAAkC,CAC7D,IAAIL,EAAU,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAAC,EAE/EM,EAAkBN,EAAQ,OAC1BO,EAASD,IAAoB,OAAS,OAASA,EAC/CE,EAAYR,EAAQ,UACpBT,EAASS,EAAQ,OACjBS,GAAOT,EAAQ,KAEnB,GAAIO,IAAW,QAAUA,IAAW,MAClC,MAAM,IAAI,MAAM,oDAAoD,EAItE,GAAIhB,IAAW,OACb,GAAIA,GAAUY,EAAQZ,CAAM,IAAM,UAAYA,EAAO,WAAa,EAAG,CACnE,GAAIgB,IAAW,QAAUhB,EAAO,aAAa,UAAU,EACrD,MAAM,IAAI,MAAM,mFAAmF,EAGrG,GAAIgB,IAAW,QAAUhB,EAAO,aAAa,UAAU,GAAKA,EAAO,aAAa,UAAU,GACxF,MAAM,IAAI,MAAM,uGAAwG,CAE5H,KACE,OAAM,IAAI,MAAM,6CAA6C,EAKjE,GAAIkB,GACF,OAAOP,EAAaO,GAAM,CACxB,UAAWD,CACb,CAAC,EAIH,GAAIjB,EACF,OAAOgB,IAAW,MAAQd,EAAYF,CAAM,EAAIW,EAAaX,EAAQ,CACnE,UAAWiB,CACb,CAAC,CAEL,EAEiCE,GAAmBL,GAEpD,SAASM,GAAiBP,EAAK,CAAE,0BAA2B,OAAI,OAAO,QAAW,YAAc,OAAO,OAAO,UAAa,SAAYO,GAAmB,SAAiBP,EAAK,CAAE,OAAO,OAAOA,CAAK,EAAYO,GAAmB,SAAiBP,EAAK,CAAE,OAAOA,GAAO,OAAO,QAAW,YAAcA,EAAI,cAAgB,QAAUA,IAAQ,OAAO,UAAY,SAAW,OAAOA,CAAK,EAAYO,GAAiBP,CAAG,CAAG,CAE7Z,SAASQ,GAAgBC,EAAUC,EAAa,CAAE,GAAI,EAAED,aAAoBC,GAAgB,MAAM,IAAI,UAAU,mCAAmC,CAAK,CAExJ,SAASC,GAAkBxB,EAAQyB,EAAO,CAAE,QAASC,EAAI,EAAGA,EAAID,EAAM,OAAQC,IAAK,CAAE,IAAIC,EAAaF,EAAMC,CAAC,EAAGC,EAAW,WAAaA,EAAW,YAAc,GAAOA,EAAW,aAAe,GAAU,UAAWA,IAAYA,EAAW,SAAW,IAAM,OAAO,eAAe3B,EAAQ2B,EAAW,IAAKA,CAAU,CAAG,CAAE,CAE5T,SAASC,GAAaL,EAAaM,EAAYC,EAAa,CAAE,OAAID,GAAYL,GAAkBD,EAAY,UAAWM,CAAU,EAAOC,GAAaN,GAAkBD,EAAaO,CAAW,EAAUP,CAAa,CAEtN,SAASQ,GAAUC,EAAUC,EAAY,CAAE,GAAI,OAAOA,GAAe,YAAcA,IAAe,KAAQ,MAAM,IAAI,UAAU,oDAAoD,EAAKD,EAAS,UAAY,OAAO,OAAOC,GAAcA,EAAW,UAAW,CAAE,YAAa,CAAE,MAAOD,EAAU,SAAU,GAAM,aAAc,EAAK,CAAE,CAAC,EAAOC,GAAYC,GAAgBF,EAAUC,CAAU,CAAG,CAEhY,SAASC,GAAgBC,EAAGC,EAAG,CAAE,OAAAF,GAAkB,OAAO,gBAAkB,SAAyBC,EAAGC,EAAG,CAAE,OAAAD,EAAE,UAAYC,EAAUD,CAAG,EAAUD,GAAgBC,EAAGC,CAAC,CAAG,CAEzK,SAASC,GAAaC,EAAS,CAAE,IAAIC,EAA4BC,GAA0B,EAAG,OAAO,UAAgC,CAAE,IAAIC,EAAQC,GAAgBJ,CAAO,EAAGK,EAAQ,GAAIJ,EAA2B,CAAE,IAAIK,EAAYF,GAAgB,IAAI,EAAE,YAAaC,EAAS,QAAQ,UAAUF,EAAO,UAAWG,CAAS,CAAG,MAASD,EAASF,EAAM,MAAM,KAAM,SAAS,EAAK,OAAOI,GAA2B,KAAMF,CAAM,CAAG,CAAG,CAExa,SAASE,GAA2BC,EAAMC,EAAM,CAAE,OAAIA,IAAS3B,GAAiB2B,CAAI,IAAM,UAAY,OAAOA,GAAS,YAAsBA,EAAeC,GAAuBF,CAAI,CAAG,CAEzL,SAASE,GAAuBF,EAAM,CAAE,GAAIA,IAAS,OAAU,MAAM,IAAI,eAAe,2DAA2D,EAAK,OAAOA,CAAM,CAErK,SAASN,IAA4B,CAA0E,GAApE,OAAO,SAAY,aAAe,CAAC,QAAQ,WAA6B,QAAQ,UAAU,KAAM,MAAO,GAAO,GAAI,OAAO,OAAU,WAAY,MAAO,GAAM,GAAI,CAAE,YAAK,UAAU,SAAS,KAAK,QAAQ,UAAU,KAAM,CAAC,EAAG,UAAY,CAAC,CAAC,CAAC,EAAU,EAAM,OAASS,EAAG,CAAE,MAAO,EAAO,CAAE,CAEnU,SAASP,GAAgBP,EAAG,CAAE,OAAAO,GAAkB,OAAO,eAAiB,OAAO,eAAiB,SAAyBP,EAAG,CAAE,OAAOA,EAAE,WAAa,OAAO,eAAeA,CAAC,CAAG,EAAUO,GAAgBP,CAAC,CAAG,CAa5M,SAASe,GAAkBC,EAAQC,EAAS,CAC1C,IAAIC,EAAY,kBAAkB,OAAOF,CAAM,EAE/C,GAAKC,EAAQ,aAAaC,CAAS,EAInC,OAAOD,EAAQ,aAAaC,CAAS,CACvC,CAOA,IAAIC,GAAyB,SAAUC,EAAU,CAC/CxB,GAAUuB,EAAWC,CAAQ,EAE7B,IAAIC,EAASnB,GAAaiB,CAAS,EAMnC,SAASA,EAAUG,EAAShD,EAAS,CACnC,IAAIiD,EAEJ,OAAArC,GAAgB,KAAMiC,CAAS,EAE/BI,EAAQF,EAAO,KAAK,IAAI,EAExBE,EAAM,eAAejD,CAAO,EAE5BiD,EAAM,YAAYD,CAAO,EAElBC,CACT,CAQA,OAAA9B,GAAa0B,EAAW,CAAC,CACvB,IAAK,iBACL,MAAO,UAA0B,CAC/B,IAAI7C,EAAU,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAAC,EACnF,KAAK,OAAS,OAAOA,EAAQ,QAAW,WAAaA,EAAQ,OAAS,KAAK,cAC3E,KAAK,OAAS,OAAOA,EAAQ,QAAW,WAAaA,EAAQ,OAAS,KAAK,cAC3E,KAAK,KAAO,OAAOA,EAAQ,MAAS,WAAaA,EAAQ,KAAO,KAAK,YACrE,KAAK,UAAYW,GAAiBX,EAAQ,SAAS,IAAM,SAAWA,EAAQ,UAAY,SAAS,IACnG,CAMF,EAAG,CACD,IAAK,cACL,MAAO,SAAqBgD,EAAS,CACnC,IAAIE,EAAS,KAEb,KAAK,SAAWlE,EAAe,EAAEgE,EAAS,QAAS,SAAUR,GAAG,CAC9D,OAAOU,EAAO,QAAQV,EAAC,CACzB,CAAC,CACH,CAMF,EAAG,CACD,IAAK,UACL,MAAO,SAAiBA,EAAG,CACzB,IAAIQ,EAAUR,EAAE,gBAAkBA,EAAE,cAChCjC,GAAS,KAAK,OAAOyC,CAAO,GAAK,OACjCvC,GAAOC,GAAgB,CACzB,OAAQH,GACR,UAAW,KAAK,UAChB,OAAQ,KAAK,OAAOyC,CAAO,EAC3B,KAAM,KAAK,KAAKA,CAAO,CACzB,CAAC,EAED,KAAK,KAAKvC,GAAO,UAAY,QAAS,CACpC,OAAQF,GACR,KAAME,GACN,QAASuC,EACT,eAAgB,UAA0B,CACpCA,GACFA,EAAQ,MAAM,EAGhB,OAAO,aAAa,EAAE,gBAAgB,CACxC,CACF,CAAC,CACH,CAMF,EAAG,CACD,IAAK,gBACL,MAAO,SAAuBA,EAAS,CACrC,OAAOP,GAAkB,SAAUO,CAAO,CAC5C,CAMF,EAAG,CACD,IAAK,gBACL,MAAO,SAAuBA,EAAS,CACrC,IAAIG,EAAWV,GAAkB,SAAUO,CAAO,EAElD,GAAIG,EACF,OAAO,SAAS,cAAcA,CAAQ,CAE1C,CAQF,EAAG,CACD,IAAK,cAML,MAAO,SAAqBH,EAAS,CACnC,OAAOP,GAAkB,OAAQO,CAAO,CAC1C,CAKF,EAAG,CACD,IAAK,UACL,MAAO,UAAmB,CACxB,KAAK,SAAS,QAAQ,CACxB,CACF,CAAC,EAAG,CAAC,CACH,IAAK,OACL,MAAO,SAAczD,EAAQ,CAC3B,IAAIS,EAAU,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAChF,UAAW,SAAS,IACtB,EACA,OAAOE,EAAaX,EAAQS,CAAO,CACrC,CAOF,EAAG,CACD,IAAK,MACL,MAAO,SAAaT,EAAQ,CAC1B,OAAOE,EAAYF,CAAM,CAC3B,CAOF,EAAG,CACD,IAAK,cACL,MAAO,UAAuB,CAC5B,IAAIgB,EAAS,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAAC,OAAQ,KAAK,EAC3F6C,EAAU,OAAO7C,GAAW,SAAW,CAACA,CAAM,EAAIA,EAClD8C,GAAU,CAAC,CAAC,SAAS,sBACzB,OAAAD,EAAQ,QAAQ,SAAU7C,GAAQ,CAChC8C,GAAUA,IAAW,CAAC,CAAC,SAAS,sBAAsB9C,EAAM,CAC9D,CAAC,EACM8C,EACT,CACF,CAAC,CAAC,EAEKR,CACT,EAAG/D,EAAqB,CAAE,EAEOF,GAAaiE,EAExC,EAEA,IACC,SAASxE,EAAQ,CAExB,IAAIiF,EAAqB,EAKzB,GAAI,OAAO,SAAY,aAAe,CAAC,QAAQ,UAAU,QAAS,CAC9D,IAAIC,EAAQ,QAAQ,UAEpBA,EAAM,QAAUA,EAAM,iBACNA,EAAM,oBACNA,EAAM,mBACNA,EAAM,kBACNA,EAAM,qBAC1B,CASA,SAASC,EAASb,EAASQ,EAAU,CACjC,KAAOR,GAAWA,EAAQ,WAAaW,GAAoB,CACvD,GAAI,OAAOX,EAAQ,SAAY,YAC3BA,EAAQ,QAAQQ,CAAQ,EAC1B,OAAOR,EAETA,EAAUA,EAAQ,UACtB,CACJ,CAEAtE,EAAO,QAAUmF,CAGX,EAEA,IACC,SAASnF,EAAQoF,EAA0B9E,EAAqB,CAEvE,IAAI6E,EAAU7E,EAAoB,GAAG,EAYrC,SAAS+E,EAAUf,EAASQ,EAAU/D,EAAMuE,EAAUC,EAAY,CAC9D,IAAIC,EAAaC,EAAS,MAAM,KAAM,SAAS,EAE/C,OAAAnB,EAAQ,iBAAiBvD,EAAMyE,EAAYD,CAAU,EAE9C,CACH,QAAS,UAAW,CAChBjB,EAAQ,oBAAoBvD,EAAMyE,EAAYD,CAAU,CAC5D,CACJ,CACJ,CAYA,SAASG,EAASC,EAAUb,EAAU/D,EAAMuE,EAAUC,EAAY,CAE9D,OAAI,OAAOI,EAAS,kBAAqB,WAC9BN,EAAU,MAAM,KAAM,SAAS,EAItC,OAAOtE,GAAS,WAGTsE,EAAU,KAAK,KAAM,QAAQ,EAAE,MAAM,KAAM,SAAS,GAI3D,OAAOM,GAAa,WACpBA,EAAW,SAAS,iBAAiBA,CAAQ,GAI1C,MAAM,UAAU,IAAI,KAAKA,EAAU,SAAUrB,EAAS,CACzD,OAAOe,EAAUf,EAASQ,EAAU/D,EAAMuE,EAAUC,CAAU,CAClE,CAAC,EACL,CAWA,SAASE,EAASnB,EAASQ,EAAU/D,EAAMuE,EAAU,CACjD,OAAO,SAASnB,EAAG,CACfA,EAAE,eAAiBgB,EAAQhB,EAAE,OAAQW,CAAQ,EAEzCX,EAAE,gBACFmB,EAAS,KAAKhB,EAASH,CAAC,CAEhC,CACJ,CAEAnE,EAAO,QAAU0F,CAGX,EAEA,IACC,SAAStF,EAAyBL,EAAS,CAQlDA,EAAQ,KAAO,SAASuB,EAAO,CAC3B,OAAOA,IAAU,QACVA,aAAiB,aACjBA,EAAM,WAAa,CAC9B,EAQAvB,EAAQ,SAAW,SAASuB,EAAO,CAC/B,IAAIP,EAAO,OAAO,UAAU,SAAS,KAAKO,CAAK,EAE/C,OAAOA,IAAU,SACTP,IAAS,qBAAuBA,IAAS,4BACzC,WAAYO,IACZA,EAAM,SAAW,GAAKvB,EAAQ,KAAKuB,EAAM,CAAC,CAAC,EACvD,EAQAvB,EAAQ,OAAS,SAASuB,EAAO,CAC7B,OAAO,OAAOA,GAAU,UACjBA,aAAiB,MAC5B,EAQAvB,EAAQ,GAAK,SAASuB,EAAO,CACzB,IAAIP,EAAO,OAAO,UAAU,SAAS,KAAKO,CAAK,EAE/C,OAAOP,IAAS,mBACpB,CAGM,EAEA,IACC,SAASf,EAAQoF,EAA0B9E,EAAqB,CAEvE,IAAIsF,EAAKtF,EAAoB,GAAG,EAC5BoF,EAAWpF,EAAoB,GAAG,EAWtC,SAASI,EAAOQ,EAAQH,EAAMuE,EAAU,CACpC,GAAI,CAACpE,GAAU,CAACH,GAAQ,CAACuE,EACrB,MAAM,IAAI,MAAM,4BAA4B,EAGhD,GAAI,CAACM,EAAG,OAAO7E,CAAI,EACf,MAAM,IAAI,UAAU,kCAAkC,EAG1D,GAAI,CAAC6E,EAAG,GAAGN,CAAQ,EACf,MAAM,IAAI,UAAU,mCAAmC,EAG3D,GAAIM,EAAG,KAAK1E,CAAM,EACd,OAAO2E,EAAW3E,EAAQH,EAAMuE,CAAQ,EAEvC,GAAIM,EAAG,SAAS1E,CAAM,EACvB,OAAO4E,EAAe5E,EAAQH,EAAMuE,CAAQ,EAE3C,GAAIM,EAAG,OAAO1E,CAAM,EACrB,OAAO6E,EAAe7E,EAAQH,EAAMuE,CAAQ,EAG5C,MAAM,IAAI,UAAU,2EAA2E,CAEvG,CAWA,SAASO,EAAWG,EAAMjF,EAAMuE,EAAU,CACtC,OAAAU,EAAK,iBAAiBjF,EAAMuE,CAAQ,EAE7B,CACH,QAAS,UAAW,CAChBU,EAAK,oBAAoBjF,EAAMuE,CAAQ,CAC3C,CACJ,CACJ,CAWA,SAASQ,EAAeG,EAAUlF,EAAMuE,EAAU,CAC9C,aAAM,UAAU,QAAQ,KAAKW,EAAU,SAASD,EAAM,CAClDA,EAAK,iBAAiBjF,EAAMuE,CAAQ,CACxC,CAAC,EAEM,CACH,QAAS,UAAW,CAChB,MAAM,UAAU,QAAQ,KAAKW,EAAU,SAASD,EAAM,CAClDA,EAAK,oBAAoBjF,EAAMuE,CAAQ,CAC3C,CAAC,CACL,CACJ,CACJ,CAWA,SAASS,EAAejB,EAAU/D,EAAMuE,EAAU,CAC9C,OAAOI,EAAS,SAAS,KAAMZ,EAAU/D,EAAMuE,CAAQ,CAC3D,CAEAtF,EAAO,QAAUU,CAGX,EAEA,IACC,SAASV,EAAQ,CAExB,SAASkG,EAAO5B,EAAS,CACrB,IAAInD,EAEJ,GAAImD,EAAQ,WAAa,SACrBA,EAAQ,MAAM,EAEdnD,EAAemD,EAAQ,cAElBA,EAAQ,WAAa,SAAWA,EAAQ,WAAa,WAAY,CACtE,IAAI6B,EAAa7B,EAAQ,aAAa,UAAU,EAE3C6B,GACD7B,EAAQ,aAAa,WAAY,EAAE,EAGvCA,EAAQ,OAAO,EACfA,EAAQ,kBAAkB,EAAGA,EAAQ,MAAM,MAAM,EAE5C6B,GACD7B,EAAQ,gBAAgB,UAAU,EAGtCnD,EAAemD,EAAQ,KAC3B,KACK,CACGA,EAAQ,aAAa,iBAAiB,GACtCA,EAAQ,MAAM,EAGlB,IAAI8B,EAAY,OAAO,aAAa,EAChCC,EAAQ,SAAS,YAAY,EAEjCA,EAAM,mBAAmB/B,CAAO,EAChC8B,EAAU,gBAAgB,EAC1BA,EAAU,SAASC,CAAK,EAExBlF,EAAeiF,EAAU,SAAS,CACtC,CAEA,OAAOjF,CACX,CAEAnB,EAAO,QAAUkG,CAGX,EAEA,IACC,SAASlG,EAAQ,CAExB,SAASsG,GAAK,CAGd,CAEAA,EAAE,UAAY,CACZ,GAAI,SAAUC,EAAMjB,EAAUkB,EAAK,CACjC,IAAIrC,EAAI,KAAK,IAAM,KAAK,EAAI,CAAC,GAE7B,OAACA,EAAEoC,CAAI,IAAMpC,EAAEoC,CAAI,EAAI,CAAC,IAAI,KAAK,CAC/B,GAAIjB,EACJ,IAAKkB,CACP,CAAC,EAEM,IACT,EAEA,KAAM,SAAUD,EAAMjB,EAAUkB,EAAK,CACnC,IAAIxC,EAAO,KACX,SAASyB,GAAY,CACnBzB,EAAK,IAAIuC,EAAMd,CAAQ,EACvBH,EAAS,MAAMkB,EAAK,SAAS,CAC/B,CAEA,OAAAf,EAAS,EAAIH,EACN,KAAK,GAAGiB,EAAMd,EAAUe,CAAG,CACpC,EAEA,KAAM,SAAUD,EAAM,CACpB,IAAIE,EAAO,CAAC,EAAE,MAAM,KAAK,UAAW,CAAC,EACjCC,IAAW,KAAK,IAAM,KAAK,EAAI,CAAC,IAAIH,CAAI,GAAK,CAAC,GAAG,MAAM,EACvD3D,EAAI,EACJ+D,EAAMD,EAAO,OAEjB,IAAK9D,EAAGA,EAAI+D,EAAK/D,IACf8D,EAAO9D,CAAC,EAAE,GAAG,MAAM8D,EAAO9D,CAAC,EAAE,IAAK6D,CAAI,EAGxC,OAAO,IACT,EAEA,IAAK,SAAUF,EAAMjB,EAAU,CAC7B,IAAInB,EAAI,KAAK,IAAM,KAAK,EAAI,CAAC,GACzByC,EAAOzC,EAAEoC,CAAI,EACbM,EAAa,CAAC,EAElB,GAAID,GAAQtB,EACV,QAAS1C,EAAI,EAAG+D,EAAMC,EAAK,OAAQhE,EAAI+D,EAAK/D,IACtCgE,EAAKhE,CAAC,EAAE,KAAO0C,GAAYsB,EAAKhE,CAAC,EAAE,GAAG,IAAM0C,GAC9CuB,EAAW,KAAKD,EAAKhE,CAAC,CAAC,EAQ7B,OAACiE,EAAW,OACR1C,EAAEoC,CAAI,EAAIM,EACV,OAAO1C,EAAEoC,CAAI,EAEV,IACT,CACF,EAEAvG,EAAO,QAAUsG,EACjBtG,EAAO,QAAQ,YAAcsG,CAGvB,CAEI,EAGIQ,EAA2B,CAAC,EAGhC,SAASxG,EAAoByG,EAAU,CAEtC,GAAGD,EAAyBC,CAAQ,EACnC,OAAOD,EAAyBC,CAAQ,EAAE,QAG3C,IAAI/G,EAAS8G,EAAyBC,CAAQ,EAAI,CAGjD,QAAS,CAAC,CACX,EAGA,OAAA5G,EAAoB4G,CAAQ,EAAE/G,EAAQA,EAAO,QAASM,CAAmB,EAGlEN,EAAO,OACf,CAIA,OAAC,UAAW,CAEXM,EAAoB,EAAI,SAASN,EAAQ,CACxC,IAAIgH,EAAShH,GAAUA,EAAO,WAC7B,UAAW,CAAE,OAAOA,EAAO,OAAY,EACvC,UAAW,CAAE,OAAOA,CAAQ,EAC7B,OAAAM,EAAoB,EAAE0G,EAAQ,CAAE,EAAGA,CAAO,CAAC,EACpCA,CACR,CACD,EAAE,EAGD,UAAW,CAEX1G,EAAoB,EAAI,SAASP,EAASkH,EAAY,CACrD,QAAQC,KAAOD,EACX3G,EAAoB,EAAE2G,EAAYC,CAAG,GAAK,CAAC5G,EAAoB,EAAEP,EAASmH,CAAG,GAC/E,OAAO,eAAenH,EAASmH,EAAK,CAAE,WAAY,GAAM,IAAKD,EAAWC,CAAG,CAAE,CAAC,CAGjF,CACD,EAAE,EAGD,UAAW,CACX5G,EAAoB,EAAI,SAASyB,EAAKoF,EAAM,CAAE,OAAO,OAAO,UAAU,eAAe,KAAKpF,EAAKoF,CAAI,CAAG,CACvG,EAAE,EAMK7G,EAAoB,GAAG,CAC/B,EAAG,EACX,OACD,CAAC,ICz3BD,IAAA8G,GAAAC,GAAA,CAAAC,GAAAC,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAeA,IAAIC,GAAkB,UAOtBD,GAAO,QAAUE,GAUjB,SAASA,GAAWC,EAAQ,CAC1B,IAAIC,EAAM,GAAKD,EACXE,EAAQJ,GAAgB,KAAKG,CAAG,EAEpC,GAAI,CAACC,EACH,OAAOD,EAGT,IAAIE,EACAC,EAAO,GACPC,EAAQ,EACRC,EAAY,EAEhB,IAAKD,EAAQH,EAAM,MAAOG,EAAQJ,EAAI,OAAQI,IAAS,CACrD,OAAQJ,EAAI,WAAWI,CAAK,EAAG,CAC7B,IAAK,IACHF,EAAS,SACT,MACF,IAAK,IACHA,EAAS,QACT,MACF,IAAK,IACHA,EAAS,QACT,MACF,IAAK,IACHA,EAAS,OACT,MACF,IAAK,IACHA,EAAS,OACT,MACF,QACE,QACJ,CAEIG,IAAcD,IAChBD,GAAQH,EAAI,UAAUK,EAAWD,CAAK,GAGxCC,EAAYD,EAAQ,EACpBD,GAAQD,CACV,CAEA,OAAOG,IAAcD,EACjBD,EAAOH,EAAI,UAAUK,EAAWD,CAAK,EACrCD,CACN,ICvDA,IAAAG,GAAO,SCtBP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gFAgBA,IAAIC,GAAgB,SAASC,EAAGC,EAAG,CAC/B,OAAAF,GAAgB,OAAO,gBAClB,CAAE,UAAW,CAAC,CAAE,YAAa,OAAS,SAAUC,EAAGC,EAAG,CAAED,EAAE,UAAYC,CAAG,GAC1E,SAAUD,EAAGC,EAAG,CAAE,QAASC,KAAKD,EAAO,OAAO,UAAU,eAAe,KAAKA,EAAGC,CAAC,IAAGF,EAAEE,CAAC,EAAID,EAAEC,CAAC,EAAG,EAC7FH,GAAcC,EAAGC,CAAC,CAC7B,EAEO,SAASE,GAAUH,EAAGC,EAAG,CAC5B,GAAI,OAAOA,GAAM,YAAcA,IAAM,KACjC,MAAM,IAAI,UAAU,uBAAyB,OAAOA,CAAC,EAAI,+BAA+B,EAC5FF,GAAcC,EAAGC,CAAC,EAClB,SAASG,GAAK,CAAE,KAAK,YAAcJ,CAAG,CACtCA,EAAE,UAAYC,IAAM,KAAO,OAAO,OAAOA,CAAC,GAAKG,EAAG,UAAYH,EAAE,UAAW,IAAIG,EACnF,CAwCO,SAASC,GAAUC,EAASC,EAAYC,EAAGC,EAAW,CACzD,SAASC,EAAMC,EAAO,CAAE,OAAOA,aAAiBH,EAAIG,EAAQ,IAAIH,EAAE,SAAUI,EAAS,CAAEA,EAAQD,CAAK,CAAG,CAAC,CAAG,CAC3G,OAAO,IAAKH,IAAMA,EAAI,UAAU,SAAUI,EAASC,EAAQ,CACvD,SAASC,EAAUH,EAAO,CAAE,GAAI,CAAEI,EAAKN,EAAU,KAAKE,CAAK,CAAC,CAAG,OAASK,EAAG,CAAEH,EAAOG,CAAC,CAAG,CAAE,CAC1F,SAASC,EAASN,EAAO,CAAE,GAAI,CAAEI,EAAKN,EAAU,MAASE,CAAK,CAAC,CAAG,OAASK,EAAG,CAAEH,EAAOG,CAAC,CAAG,CAAE,CAC7F,SAASD,EAAKG,EAAQ,CAAEA,EAAO,KAAON,EAAQM,EAAO,KAAK,EAAIR,EAAMQ,EAAO,KAAK,EAAE,KAAKJ,EAAWG,CAAQ,CAAG,CAC7GF,GAAMN,EAAYA,EAAU,MAAMH,EAASC,GAAc,CAAC,CAAC,GAAG,KAAK,CAAC,CACxE,CAAC,CACL,CAEO,SAASY,GAAYb,EAASc,EAAM,CACvC,IAAIC,EAAI,CAAE,MAAO,EAAG,KAAM,UAAW,CAAE,GAAIC,EAAE,CAAC,EAAI,EAAG,MAAMA,EAAE,CAAC,EAAG,OAAOA,EAAE,CAAC,CAAG,EAAG,KAAM,CAAC,EAAG,IAAK,CAAC,CAAE,EAAGC,EAAGC,EAAGF,EAAGG,EAC/G,OAAOA,EAAI,CAAE,KAAMC,EAAK,CAAC,EAAG,MAASA,EAAK,CAAC,EAAG,OAAUA,EAAK,CAAC,CAAE,EAAG,OAAO,QAAW,aAAeD,EAAE,OAAO,QAAQ,EAAI,UAAW,CAAE,OAAO,IAAM,GAAIA,EACvJ,SAASC,EAAKC,EAAG,CAAE,OAAO,SAAUC,EAAG,CAAE,OAAOb,EAAK,CAACY,EAAGC,CAAC,CAAC,CAAG,CAAG,CACjE,SAASb,EAAKc,EAAI,CACd,GAAIN,EAAG,MAAM,IAAI,UAAU,iCAAiC,EAC5D,KAAOF,GAAG,GAAI,CACV,GAAIE,EAAI,EAAGC,IAAMF,EAAIO,EAAG,CAAC,EAAI,EAAIL,EAAE,OAAYK,EAAG,CAAC,EAAIL,EAAE,SAAcF,EAAIE,EAAE,SAAcF,EAAE,KAAKE,CAAC,EAAG,GAAKA,EAAE,OAAS,EAAEF,EAAIA,EAAE,KAAKE,EAAGK,EAAG,CAAC,CAAC,GAAG,KAAM,OAAOP,EAE3J,OADIE,EAAI,EAAGF,IAAGO,EAAK,CAACA,EAAG,CAAC,EAAI,EAAGP,EAAE,KAAK,GAC9BO,EAAG,CAAC,EAAG,CACX,IAAK,GAAG,IAAK,GAAGP,EAAIO,EAAI,MACxB,IAAK,GAAG,OAAAR,EAAE,QAAgB,CAAE,MAAOQ,EAAG,CAAC,EAAG,KAAM,EAAM,EACtD,IAAK,GAAGR,EAAE,QAASG,EAAIK,EAAG,CAAC,EAAGA,EAAK,CAAC,CAAC,EAAG,SACxC,IAAK,GAAGA,EAAKR,EAAE,IAAI,IAAI,EAAGA,EAAE,KAAK,IAAI,EAAG,SACxC,QACI,GAAMC,EAAID,EAAE,KAAM,EAAAC,EAAIA,EAAE,OAAS,GAAKA,EAAEA,EAAE,OAAS,CAAC,KAAOO,EAAG,CAAC,IAAM,GAAKA,EAAG,CAAC,IAAM,GAAI,CAAER,EAAI,EAAG,QAAU,CAC3G,GAAIQ,EAAG,CAAC,IAAM,IAAM,CAACP,GAAMO,EAAG,CAAC,EAAIP,EAAE,CAAC,GAAKO,EAAG,CAAC,EAAIP,EAAE,CAAC,GAAK,CAAED,EAAE,MAAQQ,EAAG,CAAC,EAAG,KAAO,CACrF,GAAIA,EAAG,CAAC,IAAM,GAAKR,EAAE,MAAQC,EAAE,CAAC,EAAG,CAAED,EAAE,MAAQC,EAAE,CAAC,EAAGA,EAAIO,EAAI,KAAO,CACpE,GAAIP,GAAKD,EAAE,MAAQC,EAAE,CAAC,EAAG,CAAED,EAAE,MAAQC,EAAE,CAAC,EAAGD,EAAE,IAAI,KAAKQ,CAAE,EAAG,KAAO,CAC9DP,EAAE,CAAC,GAAGD,EAAE,IAAI,IAAI,EACpBA,EAAE,KAAK,IAAI,EAAG,QACtB,CACAQ,EAAKT,EAAK,KAAKd,EAASe,CAAC,CAC7B,OAASL,EAAG,CAAEa,EAAK,CAAC,EAAGb,CAAC,EAAGQ,EAAI,CAAG,QAAE,CAAUD,EAAID,EAAI,CAAG,CACzD,GAAIO,EAAG,CAAC,EAAI,EAAG,MAAMA,EAAG,CAAC,EAAG,MAAO,CAAE,MAAOA,EAAG,CAAC,EAAIA,EAAG,CAAC,EAAI,OAAQ,KAAM,EAAK,CACnF,CACJ,CAcO,SAASC,GAASC,EAAG,CACxB,IAAIC,EAAI,OAAO,QAAW,YAAc,OAAO,SAAUC,EAAID,GAAKD,EAAEC,CAAC,EAAGE,EAAI,EAC5E,GAAID,EAAG,OAAOA,EAAE,KAAKF,CAAC,EACtB,GAAIA,GAAK,OAAOA,EAAE,QAAW,SAAU,MAAO,CAC1C,KAAM,UAAY,CACd,OAAIA,GAAKG,GAAKH,EAAE,SAAQA,EAAI,QACrB,CAAE,MAAOA,GAAKA,EAAEG,GAAG,EAAG,KAAM,CAACH,CAAE,CAC1C,CACJ,EACA,MAAM,IAAI,UAAUC,EAAI,0BAA4B,iCAAiC,CACzF,CAEO,SAASG,EAAOJ,EAAGK,EAAG,CACzB,IAAIH,EAAI,OAAO,QAAW,YAAcF,EAAE,OAAO,QAAQ,EACzD,GAAI,CAACE,EAAG,OAAOF,EACf,IAAIG,EAAID,EAAE,KAAKF,CAAC,EAAGM,EAAGC,EAAK,CAAC,EAAGC,EAC/B,GAAI,CACA,MAAQH,IAAM,QAAUA,KAAM,IAAM,EAAEC,EAAIH,EAAE,KAAK,GAAG,MAAMI,EAAG,KAAKD,EAAE,KAAK,CAC7E,OACOG,EAAO,CAAED,EAAI,CAAE,MAAOC,CAAM,CAAG,QACtC,CACI,GAAI,CACIH,GAAK,CAACA,EAAE,OAASJ,EAAIC,EAAE,SAAYD,EAAE,KAAKC,CAAC,CACnD,QACA,CAAU,GAAIK,EAAG,MAAMA,EAAE,KAAO,CACpC,CACA,OAAOD,CACX,CAkBO,SAASG,EAAcC,EAAIC,EAAMC,EAAM,CAC1C,GAAIA,GAAQ,UAAU,SAAW,EAAG,QAASC,EAAI,EAAGC,EAAIH,EAAK,OAAQI,EAAIF,EAAIC,EAAGD,KACxEE,GAAM,EAAEF,KAAKF,MACRI,IAAIA,EAAK,MAAM,UAAU,MAAM,KAAKJ,EAAM,EAAGE,CAAC,GACnDE,EAAGF,CAAC,EAAIF,EAAKE,CAAC,GAGtB,OAAOH,EAAG,OAAOK,GAAM,MAAM,UAAU,MAAM,KAAKJ,CAAI,CAAC,CAC3D,CAEO,SAASK,GAAQC,EAAG,CACvB,OAAO,gBAAgBD,IAAW,KAAK,EAAIC,EAAG,MAAQ,IAAID,GAAQC,CAAC,CACvE,CAEO,SAASC,GAAiBC,EAASC,EAAYC,EAAW,CAC7D,GAAI,CAAC,OAAO,cAAe,MAAM,IAAI,UAAU,sCAAsC,EACrF,IAAIC,EAAID,EAAU,MAAMF,EAASC,GAAc,CAAC,CAAC,EAAGP,EAAGU,EAAI,CAAC,EAC5D,OAAOV,EAAI,CAAC,EAAGW,EAAK,MAAM,EAAGA,EAAK,OAAO,EAAGA,EAAK,QAAQ,EAAGX,EAAE,OAAO,aAAa,EAAI,UAAY,CAAE,OAAO,IAAM,EAAGA,EACpH,SAASW,EAAKC,EAAG,CAAMH,EAAEG,CAAC,IAAGZ,EAAEY,CAAC,EAAI,SAAUR,EAAG,CAAE,OAAO,IAAI,QAAQ,SAAUS,EAAGC,EAAG,CAAEJ,EAAE,KAAK,CAACE,EAAGR,EAAGS,EAAGC,CAAC,CAAC,EAAI,GAAKC,EAAOH,EAAGR,CAAC,CAAG,CAAC,CAAG,EAAG,CACzI,SAASW,EAAOH,EAAGR,EAAG,CAAE,GAAI,CAAEY,EAAKP,EAAEG,CAAC,EAAER,CAAC,CAAC,CAAG,OAASa,EAAG,CAAEC,EAAOR,EAAE,CAAC,EAAE,CAAC,EAAGO,CAAC,CAAG,CAAE,CACjF,SAASD,EAAKG,EAAG,CAAEA,EAAE,iBAAiBhB,GAAU,QAAQ,QAAQgB,EAAE,MAAM,CAAC,EAAE,KAAKC,EAASC,CAAM,EAAIH,EAAOR,EAAE,CAAC,EAAE,CAAC,EAAGS,CAAC,CAAG,CACvH,SAASC,EAAQE,EAAO,CAAEP,EAAO,OAAQO,CAAK,CAAG,CACjD,SAASD,EAAOC,EAAO,CAAEP,EAAO,QAASO,CAAK,CAAG,CACjD,SAASJ,EAAOK,EAAGnB,EAAG,CAAMmB,EAAEnB,CAAC,EAAGM,EAAE,MAAM,EAAGA,EAAE,QAAQK,EAAOL,EAAE,CAAC,EAAE,CAAC,EAAGA,EAAE,CAAC,EAAE,CAAC,CAAC,CAAG,CACrF,CAQO,SAASc,GAAcC,EAAG,CAC7B,GAAI,CAAC,OAAO,cAAe,MAAM,IAAI,UAAU,sCAAsC,EACrF,IAAIC,EAAID,EAAE,OAAO,aAAa,EAAGE,EACjC,OAAOD,EAAIA,EAAE,KAAKD,CAAC,GAAKA,EAAI,OAAOG,IAAa,WAAaA,GAASH,CAAC,EAAIA,EAAE,OAAO,QAAQ,EAAE,EAAGE,EAAI,CAAC,EAAGE,EAAK,MAAM,EAAGA,EAAK,OAAO,EAAGA,EAAK,QAAQ,EAAGF,EAAE,OAAO,aAAa,EAAI,UAAY,CAAE,OAAO,IAAM,EAAGA,GAC9M,SAASE,EAAKC,EAAG,CAAEH,EAAEG,CAAC,EAAIL,EAAEK,CAAC,GAAK,SAAUC,EAAG,CAAE,OAAO,IAAI,QAAQ,SAAUC,EAASC,EAAQ,CAAEF,EAAIN,EAAEK,CAAC,EAAEC,CAAC,EAAGG,EAAOF,EAASC,EAAQF,EAAE,KAAMA,EAAE,KAAK,CAAG,CAAC,CAAG,CAAG,CAC/J,SAASG,EAAOF,EAASC,EAAQE,EAAGJ,EAAG,CAAE,QAAQ,QAAQA,CAAC,EAAE,KAAK,SAASA,EAAG,CAAEC,EAAQ,CAAE,MAAOD,EAAG,KAAMI,CAAE,CAAC,CAAG,EAAGF,CAAM,CAAG,CAC/H,CCtMM,SAAUG,EAAWC,EAAU,CACnC,OAAO,OAAOA,GAAU,UAC1B,CCGM,SAAUC,GAAoBC,EAAgC,CAClE,IAAMC,EAAS,SAACC,EAAa,CAC3B,MAAM,KAAKA,CAAQ,EACnBA,EAAS,MAAQ,IAAI,MAAK,EAAG,KAC/B,EAEMC,EAAWH,EAAWC,CAAM,EAClC,OAAAE,EAAS,UAAY,OAAO,OAAO,MAAM,SAAS,EAClDA,EAAS,UAAU,YAAcA,EAC1BA,CACT,CCDO,IAAMC,GAA+CC,GAC1D,SAACC,EAAM,CACL,OAAA,SAA4CC,EAA0B,CACpED,EAAO,IAAI,EACX,KAAK,QAAUC,EACRA,EAAO,OAAM;EACxBA,EAAO,IAAI,SAACC,EAAKC,EAAC,CAAK,OAAGA,EAAI,EAAC,KAAKD,EAAI,SAAQ,CAAzB,CAA6B,EAAE,KAAK;GAAM,EACzD,GACJ,KAAK,KAAO,sBACZ,KAAK,OAASD,CAChB,CARA,CAQC,ECvBC,SAAUG,GAAaC,EAA6BC,EAAO,CAC/D,GAAID,EAAK,CACP,IAAME,EAAQF,EAAI,QAAQC,CAAI,EAC9B,GAAKC,GAASF,EAAI,OAAOE,EAAO,CAAC,EAErC,CCOA,IAAAC,GAAA,UAAA,CAyBE,SAAAA,EAAoBC,EAA4B,CAA5B,KAAA,gBAAAA,EAdb,KAAA,OAAS,GAER,KAAA,WAAmD,KAMnD,KAAA,YAAqD,IAMV,CAQnD,OAAAD,EAAA,UAAA,YAAA,UAAA,aACME,EAEJ,GAAI,CAAC,KAAK,OAAQ,CAChB,KAAK,OAAS,GAGN,IAAAC,EAAe,KAAI,WAC3B,GAAIA,EAEF,GADA,KAAK,WAAa,KACd,MAAM,QAAQA,CAAU,MAC1B,QAAqBC,EAAAC,GAAAF,CAAU,EAAAG,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAA5B,IAAMG,EAAMD,EAAA,MACfC,EAAO,OAAO,IAAI,yGAGpBJ,EAAW,OAAO,IAAI,EAIlB,IAAiBK,EAAqB,KAAI,gBAClD,GAAIC,EAAWD,CAAgB,EAC7B,GAAI,CACFA,EAAgB,QACTE,EAAG,CACVR,EAASQ,aAAaC,GAAsBD,EAAE,OAAS,CAACA,CAAC,EAIrD,IAAAE,EAAgB,KAAI,YAC5B,GAAIA,EAAa,CACf,KAAK,YAAc,SACnB,QAAwBC,EAAAR,GAAAO,CAAW,EAAAE,EAAAD,EAAA,KAAA,EAAA,CAAAC,EAAA,KAAAA,EAAAD,EAAA,KAAA,EAAE,CAAhC,IAAME,EAASD,EAAA,MAClB,GAAI,CACFE,GAAcD,CAAS,QAChBE,EAAK,CACZf,EAASA,GAAM,KAANA,EAAU,CAAA,EACfe,aAAeN,GACjBT,EAAMgB,EAAAA,EAAA,CAAA,EAAAC,EAAOjB,CAAM,CAAA,EAAAiB,EAAKF,EAAI,MAAM,CAAA,EAElCf,EAAO,KAAKe,CAAG,sGAMvB,GAAIf,EACF,MAAM,IAAIS,GAAoBT,CAAM,EAG1C,EAoBAF,EAAA,UAAA,IAAA,SAAIoB,EAAuB,OAGzB,GAAIA,GAAYA,IAAa,KAC3B,GAAI,KAAK,OAGPJ,GAAcI,CAAQ,MACjB,CACL,GAAIA,aAAoBpB,EAAc,CAGpC,GAAIoB,EAAS,QAAUA,EAAS,WAAW,IAAI,EAC7C,OAEFA,EAAS,WAAW,IAAI,GAEzB,KAAK,aAAcC,EAAA,KAAK,eAAW,MAAAA,IAAA,OAAAA,EAAI,CAAA,GAAI,KAAKD,CAAQ,EAG/D,EAOQpB,EAAA,UAAA,WAAR,SAAmBsB,EAAoB,CAC7B,IAAAnB,EAAe,KAAI,WAC3B,OAAOA,IAAemB,GAAW,MAAM,QAAQnB,CAAU,GAAKA,EAAW,SAASmB,CAAM,CAC1F,EASQtB,EAAA,UAAA,WAAR,SAAmBsB,EAAoB,CAC7B,IAAAnB,EAAe,KAAI,WAC3B,KAAK,WAAa,MAAM,QAAQA,CAAU,GAAKA,EAAW,KAAKmB,CAAM,EAAGnB,GAAcA,EAAa,CAACA,EAAYmB,CAAM,EAAIA,CAC5H,EAMQtB,EAAA,UAAA,cAAR,SAAsBsB,EAAoB,CAChC,IAAAnB,EAAe,KAAI,WACvBA,IAAemB,EACjB,KAAK,WAAa,KACT,MAAM,QAAQnB,CAAU,GACjCoB,GAAUpB,EAAYmB,CAAM,CAEhC,EAgBAtB,EAAA,UAAA,OAAA,SAAOoB,EAAsC,CACnC,IAAAR,EAAgB,KAAI,YAC5BA,GAAeW,GAAUX,EAAaQ,CAAQ,EAE1CA,aAAoBpB,GACtBoB,EAAS,cAAc,IAAI,CAE/B,EAlLcpB,EAAA,MAAS,UAAA,CACrB,IAAMwB,EAAQ,IAAIxB,EAClB,OAAAwB,EAAM,OAAS,GACRA,CACT,EAAE,EA+KJxB,GArLA,EAuLO,IAAMyB,GAAqBC,GAAa,MAEzC,SAAUC,GAAeC,EAAU,CACvC,OACEA,aAAiBF,IAChBE,GAAS,WAAYA,GAASC,EAAWD,EAAM,MAAM,GAAKC,EAAWD,EAAM,GAAG,GAAKC,EAAWD,EAAM,WAAW,CAEpH,CAEA,SAASE,GAAcC,EAAwC,CACzDF,EAAWE,CAAS,EACtBA,EAAS,EAETA,EAAU,YAAW,CAEzB,CChNO,IAAMC,GAAuB,CAClC,iBAAkB,KAClB,sBAAuB,KACvB,QAAS,OACT,sCAAuC,GACvC,yBAA0B,ICGrB,IAAMC,GAAmC,CAG9C,WAAA,SAAWC,EAAqBC,EAAgB,SAAEC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,EAAA,CAAA,EAAA,UAAAA,CAAA,EACxC,IAAAC,EAAaL,GAAe,SACpC,OAAIK,GAAQ,MAARA,EAAU,WACLA,EAAS,WAAU,MAAnBA,EAAQC,EAAA,CAAYL,EAASC,CAAO,EAAAK,EAAKJ,CAAI,CAAA,CAAA,EAE/C,WAAU,MAAA,OAAAG,EAAA,CAACL,EAASC,CAAO,EAAAK,EAAKJ,CAAI,CAAA,CAAA,CAC7C,EACA,aAAA,SAAaK,EAAM,CACT,IAAAH,EAAaL,GAAe,SACpC,QAAQK,GAAQ,KAAA,OAARA,EAAU,eAAgB,cAAcG,CAAa,CAC/D,EACA,SAAU,QCjBN,SAAUC,GAAqBC,EAAQ,CAC3CC,GAAgB,WAAW,UAAA,CACjB,IAAAC,EAAqBC,GAAM,iBACnC,GAAID,EAEFA,EAAiBF,CAAG,MAGpB,OAAMA,CAEV,CAAC,CACH,CCtBM,SAAUI,IAAI,CAAK,CCMlB,IAAMC,GAAyB,UAAA,CAAM,OAAAC,GAAmB,IAAK,OAAW,MAAS,CAA5C,EAAsE,EAO5G,SAAUC,GAAkBC,EAAU,CAC1C,OAAOF,GAAmB,IAAK,OAAWE,CAAK,CACjD,CAOM,SAAUC,GAAoBC,EAAQ,CAC1C,OAAOJ,GAAmB,IAAKI,EAAO,MAAS,CACjD,CAQM,SAAUJ,GAAmBK,EAAuBD,EAAYF,EAAU,CAC9E,MAAO,CACL,KAAIG,EACJ,MAAKD,EACL,MAAKF,EAET,CCrCA,IAAII,GAAuD,KASrD,SAAUC,GAAaC,EAAc,CACzC,GAAIC,GAAO,sCAAuC,CAChD,IAAMC,EAAS,CAACJ,GAKhB,GAJII,IACFJ,GAAU,CAAE,YAAa,GAAO,MAAO,IAAI,GAE7CE,EAAE,EACEE,EAAQ,CACJ,IAAAC,EAAyBL,GAAvBM,EAAWD,EAAA,YAAEE,EAAKF,EAAA,MAE1B,GADAL,GAAU,KACNM,EACF,MAAMC,QAMVL,EAAE,CAEN,CAMM,SAAUM,GAAaC,EAAQ,CAC/BN,GAAO,uCAAyCH,KAClDA,GAAQ,YAAc,GACtBA,GAAQ,MAAQS,EAEpB,CCrBA,IAAAC,GAAA,SAAAC,EAAA,CAAmCC,GAAAF,EAAAC,CAAA,EA6BjC,SAAAD,EAAYG,EAA6C,CAAzD,IAAAC,EACEH,EAAA,KAAA,IAAA,GAAO,KATC,OAAAG,EAAA,UAAqB,GAUzBD,GACFC,EAAK,YAAcD,EAGfE,GAAeF,CAAW,GAC5BA,EAAY,IAAIC,CAAI,GAGtBA,EAAK,YAAcE,IAEvB,CAzBO,OAAAN,EAAA,OAAP,SAAiBO,EAAwBC,EAA2BC,EAAqB,CACvF,OAAO,IAAIC,GAAeH,EAAMC,EAAOC,CAAQ,CACjD,EAgCAT,EAAA,UAAA,KAAA,SAAKW,EAAS,CACR,KAAK,UACPC,GAA0BC,GAAiBF,CAAK,EAAG,IAAI,EAEvD,KAAK,MAAMA,CAAM,CAErB,EASAX,EAAA,UAAA,MAAA,SAAMc,EAAS,CACT,KAAK,UACPF,GAA0BG,GAAkBD,CAAG,EAAG,IAAI,GAEtD,KAAK,UAAY,GACjB,KAAK,OAAOA,CAAG,EAEnB,EAQAd,EAAA,UAAA,SAAA,UAAA,CACM,KAAK,UACPY,GAA0BI,GAAuB,IAAI,GAErD,KAAK,UAAY,GACjB,KAAK,UAAS,EAElB,EAEAhB,EAAA,UAAA,YAAA,UAAA,CACO,KAAK,SACR,KAAK,UAAY,GACjBC,EAAA,UAAM,YAAW,KAAA,IAAA,EACjB,KAAK,YAAc,KAEvB,EAEUD,EAAA,UAAA,MAAV,SAAgBW,EAAQ,CACtB,KAAK,YAAY,KAAKA,CAAK,CAC7B,EAEUX,EAAA,UAAA,OAAV,SAAiBc,EAAQ,CACvB,GAAI,CACF,KAAK,YAAY,MAAMA,CAAG,UAE1B,KAAK,YAAW,EAEpB,EAEUd,EAAA,UAAA,UAAV,UAAA,CACE,GAAI,CACF,KAAK,YAAY,SAAQ,UAEzB,KAAK,YAAW,EAEpB,EACFA,CAAA,EApHmCiB,EAAY,EA2H/C,IAAMC,GAAQ,SAAS,UAAU,KAEjC,SAASC,GAAyCC,EAAQC,EAAY,CACpE,OAAOH,GAAM,KAAKE,EAAIC,CAAO,CAC/B,CAMA,IAAAC,GAAA,UAAA,CACE,SAAAA,EAAoBC,EAAqC,CAArC,KAAA,gBAAAA,CAAwC,CAE5D,OAAAD,EAAA,UAAA,KAAA,SAAKE,EAAQ,CACH,IAAAD,EAAoB,KAAI,gBAChC,GAAIA,EAAgB,KAClB,GAAI,CACFA,EAAgB,KAAKC,CAAK,QACnBC,EAAO,CACdC,GAAqBD,CAAK,EAGhC,EAEAH,EAAA,UAAA,MAAA,SAAMK,EAAQ,CACJ,IAAAJ,EAAoB,KAAI,gBAChC,GAAIA,EAAgB,MAClB,GAAI,CACFA,EAAgB,MAAMI,CAAG,QAClBF,EAAO,CACdC,GAAqBD,CAAK,OAG5BC,GAAqBC,CAAG,CAE5B,EAEAL,EAAA,UAAA,SAAA,UAAA,CACU,IAAAC,EAAoB,KAAI,gBAChC,GAAIA,EAAgB,SAClB,GAAI,CACFA,EAAgB,SAAQ,QACjBE,EAAO,CACdC,GAAqBD,CAAK,EAGhC,EACFH,CAAA,EArCA,EAuCAM,GAAA,SAAAC,EAAA,CAAuCC,GAAAF,EAAAC,CAAA,EACrC,SAAAD,EACEG,EACAN,EACAO,EAA8B,CAHhC,IAAAC,EAKEJ,EAAA,KAAA,IAAA,GAAO,KAEHN,EACJ,GAAIW,EAAWH,CAAc,GAAK,CAACA,EAGjCR,EAAkB,CAChB,KAAOQ,GAAc,KAAdA,EAAkB,OACzB,MAAON,GAAK,KAALA,EAAS,OAChB,SAAUO,GAAQ,KAARA,EAAY,YAEnB,CAEL,IAAIG,EACAF,GAAQG,GAAO,0BAIjBD,EAAU,OAAO,OAAOJ,CAAc,EACtCI,EAAQ,YAAc,UAAA,CAAM,OAAAF,EAAK,YAAW,CAAhB,EAC5BV,EAAkB,CAChB,KAAMQ,EAAe,MAAQZ,GAAKY,EAAe,KAAMI,CAAO,EAC9D,MAAOJ,EAAe,OAASZ,GAAKY,EAAe,MAAOI,CAAO,EACjE,SAAUJ,EAAe,UAAYZ,GAAKY,EAAe,SAAUI,CAAO,IAI5EZ,EAAkBQ,EAMtB,OAAAE,EAAK,YAAc,IAAIX,GAAiBC,CAAe,GACzD,CACF,OAAAK,CAAA,EAzCuCS,EAAU,EA2CjD,SAASC,GAAqBC,EAAU,CAClCC,GAAO,sCACTC,GAAaF,CAAK,EAIlBG,GAAqBH,CAAK,CAE9B,CAQA,SAASI,GAAoBC,EAAQ,CACnC,MAAMA,CACR,CAOA,SAASC,GAA0BC,EAA2CC,EAA2B,CAC/F,IAAAC,EAA0BR,GAAM,sBACxCQ,GAAyBC,GAAgB,WAAW,UAAA,CAAM,OAAAD,EAAsBF,EAAcC,CAAU,CAA9C,CAA+C,CAC3G,CAOO,IAAMG,GAA6D,CACxE,OAAQ,GACR,KAAMC,GACN,MAAOR,GACP,SAAUQ,IC5QL,IAAMC,GAA+B,UAAA,CAAM,OAAC,OAAO,QAAW,YAAc,OAAO,YAAe,cAAvD,EAAsE,ECoClH,SAAUC,GAAYC,EAAI,CAC9B,OAAOA,CACT,CCiCM,SAAUC,IAAI,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACnB,OAAOC,GAAcF,CAAG,CAC1B,CAGM,SAAUE,GAAoBF,EAA+B,CACjE,OAAIA,EAAI,SAAW,EACVG,GAGLH,EAAI,SAAW,EACVA,EAAI,CAAC,EAGP,SAAeI,EAAQ,CAC5B,OAAOJ,EAAI,OAAO,SAACK,EAAWC,EAAuB,CAAK,OAAAA,EAAGD,CAAI,CAAP,EAAUD,CAAY,CAClF,CACF,CC9EA,IAAAG,EAAA,UAAA,CAkBE,SAAAA,EAAYC,EAA6E,CACnFA,IACF,KAAK,WAAaA,EAEtB,CA4BA,OAAAD,EAAA,UAAA,KAAA,SAAQE,EAAyB,CAC/B,IAAMC,EAAa,IAAIH,EACvB,OAAAG,EAAW,OAAS,KACpBA,EAAW,SAAWD,EACfC,CACT,EA6IAH,EAAA,UAAA,UAAA,SACEI,EACAC,EACAC,EAA8B,CAHhC,IAAAC,EAAA,KAKQC,EAAaC,GAAaL,CAAc,EAAIA,EAAiB,IAAIM,GAAeN,EAAgBC,EAAOC,CAAQ,EAErH,OAAAK,GAAa,UAAA,CACL,IAAAC,EAAuBL,EAArBL,EAAQU,EAAA,SAAEC,EAAMD,EAAA,OACxBJ,EAAW,IACTN,EAGIA,EAAS,KAAKM,EAAYK,CAAM,EAChCA,EAIAN,EAAK,WAAWC,CAAU,EAG1BD,EAAK,cAAcC,CAAU,CAAC,CAEtC,CAAC,EAEMA,CACT,EAGUR,EAAA,UAAA,cAAV,SAAwBc,EAAmB,CACzC,GAAI,CACF,OAAO,KAAK,WAAWA,CAAI,QACpBC,EAAK,CAIZD,EAAK,MAAMC,CAAG,EAElB,EA6DAf,EAAA,UAAA,QAAA,SAAQgB,EAA0BC,EAAoC,CAAtE,IAAAV,EAAA,KACE,OAAAU,EAAcC,GAAeD,CAAW,EAEjC,IAAIA,EAAkB,SAACE,EAASC,EAAM,CAC3C,IAAMZ,EAAa,IAAIE,GAAkB,CACvC,KAAM,SAACW,EAAK,CACV,GAAI,CACFL,EAAKK,CAAK,QACHN,EAAK,CACZK,EAAOL,CAAG,EACVP,EAAW,YAAW,EAE1B,EACA,MAAOY,EACP,SAAUD,EACX,EACDZ,EAAK,UAAUC,CAAU,CAC3B,CAAC,CACH,EAGUR,EAAA,UAAA,WAAV,SAAqBQ,EAA2B,OAC9C,OAAOI,EAAA,KAAK,UAAM,MAAAA,IAAA,OAAA,OAAAA,EAAE,UAAUJ,CAAU,CAC1C,EAOAR,EAAA,UAACG,EAAiB,EAAlB,UAAA,CACE,OAAO,IACT,EA4FAH,EAAA,UAAA,KAAA,UAAA,SAAKsB,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACH,OAAOC,GAAcF,CAAU,EAAE,IAAI,CACvC,EA6BAtB,EAAA,UAAA,UAAA,SAAUiB,EAAoC,CAA9C,IAAAV,EAAA,KACE,OAAAU,EAAcC,GAAeD,CAAW,EAEjC,IAAIA,EAAY,SAACE,EAASC,EAAM,CACrC,IAAIC,EACJd,EAAK,UACH,SAACkB,EAAI,CAAK,OAACJ,EAAQI,CAAT,EACV,SAACV,EAAQ,CAAK,OAAAK,EAAOL,CAAG,CAAV,EACd,UAAA,CAAM,OAAAI,EAAQE,CAAK,CAAb,CAAc,CAExB,CAAC,CACH,EA1aOrB,EAAA,OAAkC,SAAIC,EAAwD,CACnG,OAAO,IAAID,EAAcC,CAAS,CACpC,EAyaFD,GA9cA,EAudA,SAAS0B,GAAeC,EAA+C,OACrE,OAAOC,EAAAD,GAAW,KAAXA,EAAeE,GAAO,WAAO,MAAAD,IAAA,OAAAA,EAAI,OAC1C,CAEA,SAASE,GAAcC,EAAU,CAC/B,OAAOA,GAASC,EAAWD,EAAM,IAAI,GAAKC,EAAWD,EAAM,KAAK,GAAKC,EAAWD,EAAM,QAAQ,CAChG,CAEA,SAASE,GAAgBF,EAAU,CACjC,OAAQA,GAASA,aAAiBG,IAAgBJ,GAAWC,CAAK,GAAKI,GAAeJ,CAAK,CAC7F,CCzeM,SAAUK,GAAQC,EAAW,CACjC,OAAOC,EAAWD,GAAM,KAAA,OAANA,EAAQ,IAAI,CAChC,CAMM,SAAUE,EACdC,EAAqF,CAErF,OAAO,SAACH,EAAqB,CAC3B,GAAID,GAAQC,CAAM,EAChB,OAAOA,EAAO,KAAK,SAA+BI,EAA2B,CAC3E,GAAI,CACF,OAAOD,EAAKC,EAAc,IAAI,QACvBC,EAAK,CACZ,KAAK,MAAMA,CAAG,EAElB,CAAC,EAEH,MAAM,IAAI,UAAU,wCAAwC,CAC9D,CACF,CCjBM,SAAUC,EACdC,EACAC,EACAC,EACAC,EACAC,EAAuB,CAEvB,OAAO,IAAIC,GAAmBL,EAAaC,EAAQC,EAAYC,EAASC,CAAU,CACpF,CAMA,IAAAC,GAAA,SAAAC,EAAA,CAA2CC,GAAAF,EAAAC,CAAA,EAiBzC,SAAAD,EACEL,EACAC,EACAC,EACAC,EACQC,EACAI,EAAiC,CAN3C,IAAAC,EAoBEH,EAAA,KAAA,KAAMN,CAAW,GAAC,KAfV,OAAAS,EAAA,WAAAL,EACAK,EAAA,kBAAAD,EAeRC,EAAK,MAAQR,EACT,SAAuCS,EAAQ,CAC7C,GAAI,CACFT,EAAOS,CAAK,QACLC,EAAK,CACZX,EAAY,MAAMW,CAAG,EAEzB,EACAL,EAAA,UAAM,MACVG,EAAK,OAASN,EACV,SAAuCQ,EAAQ,CAC7C,GAAI,CACFR,EAAQQ,CAAG,QACJA,EAAK,CAEZX,EAAY,MAAMW,CAAG,UAGrB,KAAK,YAAW,EAEpB,EACAL,EAAA,UAAM,OACVG,EAAK,UAAYP,EACb,UAAA,CACE,GAAI,CACFA,EAAU,QACHS,EAAK,CAEZX,EAAY,MAAMW,CAAG,UAGrB,KAAK,YAAW,EAEpB,EACAL,EAAA,UAAM,WACZ,CAEA,OAAAD,EAAA,UAAA,YAAA,UAAA,OACE,GAAI,CAAC,KAAK,mBAAqB,KAAK,kBAAiB,EAAI,CAC/C,IAAAO,EAAW,KAAI,OACvBN,EAAA,UAAM,YAAW,KAAA,IAAA,EAEjB,CAACM,KAAUC,EAAA,KAAK,cAAU,MAAAA,IAAA,QAAAA,EAAA,KAAf,IAAI,GAEnB,EACFR,CAAA,EAnF2CS,EAAU,ECd9C,IAAMC,GAAiD,CAG5D,SAAA,SAASC,EAAQ,CACf,IAAIC,EAAU,sBACVC,EAAkD,qBAC9CC,EAAaJ,GAAsB,SACvCI,IACFF,EAAUE,EAAS,sBACnBD,EAASC,EAAS,sBAEpB,IAAMC,EAASH,EAAQ,SAACI,EAAS,CAI/BH,EAAS,OACTF,EAASK,CAAS,CACpB,CAAC,EACD,OAAO,IAAIC,GAAa,UAAA,CAAM,OAAAJ,GAAM,KAAA,OAANA,EAASE,CAAM,CAAf,CAAgB,CAChD,EACA,sBAAqB,UAAA,SAACG,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACZ,IAAAL,EAAaJ,GAAsB,SAC3C,QAAQI,GAAQ,KAAA,OAARA,EAAU,wBAAyB,uBAAsB,MAAA,OAAAM,EAAA,CAAA,EAAAC,EAAIH,CAAI,CAAA,CAAA,CAC3E,EACA,qBAAoB,UAAA,SAACA,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACX,IAAAL,EAAaJ,GAAsB,SAC3C,QAAQI,GAAQ,KAAA,OAARA,EAAU,uBAAwB,sBAAqB,MAAA,OAAAM,EAAA,CAAA,EAAAC,EAAIH,CAAI,CAAA,CAAA,CACzE,EACA,SAAU,QCrBL,IAAMI,GAAuDC,GAClE,SAACC,EAAM,CACL,OAAA,UAAoC,CAClCA,EAAO,IAAI,EACX,KAAK,KAAO,0BACZ,KAAK,QAAU,qBACjB,CAJA,CAIC,ECXL,IAAAC,EAAA,SAAAC,EAAA,CAAgCC,GAAAF,EAAAC,CAAA,EAwB9B,SAAAD,GAAA,CAAA,IAAAG,EAEEF,EAAA,KAAA,IAAA,GAAO,KAzBT,OAAAE,EAAA,OAAS,GAEDA,EAAA,iBAAyC,KAGjDA,EAAA,UAA2B,CAAA,EAE3BA,EAAA,UAAY,GAEZA,EAAA,SAAW,GAEXA,EAAA,YAAmB,MAenB,CAGA,OAAAH,EAAA,UAAA,KAAA,SAAQI,EAAwB,CAC9B,IAAMC,EAAU,IAAIC,GAAiB,KAAM,IAAI,EAC/C,OAAAD,EAAQ,SAAWD,EACZC,CACT,EAGUL,EAAA,UAAA,eAAV,UAAA,CACE,GAAI,KAAK,OACP,MAAM,IAAIO,EAEd,EAEAP,EAAA,UAAA,KAAA,SAAKQ,EAAQ,CAAb,IAAAL,EAAA,KACEM,GAAa,UAAA,SAEX,GADAN,EAAK,eAAc,EACf,CAACA,EAAK,UAAW,CACdA,EAAK,mBACRA,EAAK,iBAAmB,MAAM,KAAKA,EAAK,SAAS,OAEnD,QAAuBO,EAAAC,GAAAR,EAAK,gBAAgB,EAAAS,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAAzC,IAAMG,EAAQD,EAAA,MACjBC,EAAS,KAAKL,CAAK,qGAGzB,CAAC,CACH,EAEAR,EAAA,UAAA,MAAA,SAAMc,EAAQ,CAAd,IAAAX,EAAA,KACEM,GAAa,UAAA,CAEX,GADAN,EAAK,eAAc,EACf,CAACA,EAAK,UAAW,CACnBA,EAAK,SAAWA,EAAK,UAAY,GACjCA,EAAK,YAAcW,EAEnB,QADQC,EAAcZ,EAAI,UACnBY,EAAU,QACfA,EAAU,MAAK,EAAI,MAAMD,CAAG,EAGlC,CAAC,CACH,EAEAd,EAAA,UAAA,SAAA,UAAA,CAAA,IAAAG,EAAA,KACEM,GAAa,UAAA,CAEX,GADAN,EAAK,eAAc,EACf,CAACA,EAAK,UAAW,CACnBA,EAAK,UAAY,GAEjB,QADQY,EAAcZ,EAAI,UACnBY,EAAU,QACfA,EAAU,MAAK,EAAI,SAAQ,EAGjC,CAAC,CACH,EAEAf,EAAA,UAAA,YAAA,UAAA,CACE,KAAK,UAAY,KAAK,OAAS,GAC/B,KAAK,UAAY,KAAK,iBAAmB,IAC3C,EAEA,OAAA,eAAIA,EAAA,UAAA,WAAQ,KAAZ,UAAA,OACE,QAAOgB,EAAA,KAAK,aAAS,MAAAA,IAAA,OAAA,OAAAA,EAAE,QAAS,CAClC,kCAGUhB,EAAA,UAAA,cAAV,SAAwBiB,EAAyB,CAC/C,YAAK,eAAc,EACZhB,EAAA,UAAM,cAAa,KAAA,KAACgB,CAAU,CACvC,EAGUjB,EAAA,UAAA,WAAV,SAAqBiB,EAAyB,CAC5C,YAAK,eAAc,EACnB,KAAK,wBAAwBA,CAAU,EAChC,KAAK,gBAAgBA,CAAU,CACxC,EAGUjB,EAAA,UAAA,gBAAV,SAA0BiB,EAA2B,CAArD,IAAAd,EAAA,KACQa,EAAqC,KAAnCE,EAAQF,EAAA,SAAEG,EAASH,EAAA,UAAED,EAASC,EAAA,UACtC,OAAIE,GAAYC,EACPC,IAET,KAAK,iBAAmB,KACxBL,EAAU,KAAKE,CAAU,EAClB,IAAII,GAAa,UAAA,CACtBlB,EAAK,iBAAmB,KACxBmB,GAAUP,EAAWE,CAAU,CACjC,CAAC,EACH,EAGUjB,EAAA,UAAA,wBAAV,SAAkCiB,EAA2B,CACrD,IAAAD,EAAuC,KAArCE,EAAQF,EAAA,SAAEO,EAAWP,EAAA,YAAEG,EAASH,EAAA,UACpCE,EACFD,EAAW,MAAMM,CAAW,EACnBJ,GACTF,EAAW,SAAQ,CAEvB,EAQAjB,EAAA,UAAA,aAAA,UAAA,CACE,IAAMwB,EAAkB,IAAIC,EAC5B,OAAAD,EAAW,OAAS,KACbA,CACT,EAxHOxB,EAAA,OAAkC,SAAI0B,EAA0BC,EAAqB,CAC1F,OAAO,IAAIrB,GAAoBoB,EAAaC,CAAM,CACpD,EAuHF3B,GA7IgCyB,CAAU,EAkJ1C,IAAAG,GAAA,SAAAC,EAAA,CAAyCC,GAAAF,EAAAC,CAAA,EACvC,SAAAD,EAESG,EACPC,EAAsB,CAHxB,IAAAC,EAKEJ,EAAA,KAAA,IAAA,GAAO,KAHA,OAAAI,EAAA,YAAAF,EAIPE,EAAK,OAASD,GAChB,CAEA,OAAAJ,EAAA,UAAA,KAAA,SAAKM,EAAQ,UACXC,GAAAC,EAAA,KAAK,eAAW,MAAAA,IAAA,OAAA,OAAAA,EAAE,QAAI,MAAAD,IAAA,QAAAA,EAAA,KAAAC,EAAGF,CAAK,CAChC,EAEAN,EAAA,UAAA,MAAA,SAAMS,EAAQ,UACZF,GAAAC,EAAA,KAAK,eAAW,MAAAA,IAAA,OAAA,OAAAA,EAAE,SAAK,MAAAD,IAAA,QAAAA,EAAA,KAAAC,EAAGC,CAAG,CAC/B,EAEAT,EAAA,UAAA,SAAA,UAAA,UACEO,GAAAC,EAAA,KAAK,eAAW,MAAAA,IAAA,OAAA,OAAAA,EAAE,YAAQ,MAAAD,IAAA,QAAAA,EAAA,KAAAC,CAAA,CAC5B,EAGUR,EAAA,UAAA,WAAV,SAAqBU,EAAyB,SAC5C,OAAOH,GAAAC,EAAA,KAAK,UAAM,MAAAA,IAAA,OAAA,OAAAA,EAAE,UAAUE,CAAU,KAAC,MAAAH,IAAA,OAAAA,EAAII,EAC/C,EACFX,CAAA,EA1ByCY,CAAO,EC5JzC,IAAMC,GAA+C,CAC1D,IAAG,UAAA,CAGD,OAAQA,GAAsB,UAAY,MAAM,IAAG,CACrD,EACA,SAAU,QCwBZ,IAAAC,GAAA,SAAAC,EAAA,CAAsCC,GAAAF,EAAAC,CAAA,EAUpC,SAAAD,EACUG,EACAC,EACAC,EAA6D,CAF7DF,IAAA,SAAAA,EAAA,KACAC,IAAA,SAAAA,EAAA,KACAC,IAAA,SAAAA,EAAAC,IAHV,IAAAC,EAKEN,EAAA,KAAA,IAAA,GAAO,KAJC,OAAAM,EAAA,YAAAJ,EACAI,EAAA,YAAAH,EACAG,EAAA,mBAAAF,EAZFE,EAAA,QAA0B,CAAA,EAC1BA,EAAA,oBAAsB,GAc5BA,EAAK,oBAAsBH,IAAgB,IAC3CG,EAAK,YAAc,KAAK,IAAI,EAAGJ,CAAW,EAC1CI,EAAK,YAAc,KAAK,IAAI,EAAGH,CAAW,GAC5C,CAEA,OAAAJ,EAAA,UAAA,KAAA,SAAKQ,EAAQ,CACL,IAAAC,EAA+E,KAA7EC,EAASD,EAAA,UAAEE,EAAOF,EAAA,QAAEG,EAAmBH,EAAA,oBAAEJ,EAAkBI,EAAA,mBAAEL,EAAWK,EAAA,YAC3EC,IACHC,EAAQ,KAAKH,CAAK,EAClB,CAACI,GAAuBD,EAAQ,KAAKN,EAAmB,IAAG,EAAKD,CAAW,GAE7E,KAAK,YAAW,EAChBH,EAAA,UAAM,KAAI,KAAA,KAACO,CAAK,CAClB,EAGUR,EAAA,UAAA,WAAV,SAAqBa,EAAyB,CAC5C,KAAK,eAAc,EACnB,KAAK,YAAW,EAQhB,QANMC,EAAe,KAAK,gBAAgBD,CAAU,EAE9CJ,EAAmC,KAAjCG,EAAmBH,EAAA,oBAAEE,EAAOF,EAAA,QAG9BM,EAAOJ,EAAQ,MAAK,EACjBK,EAAI,EAAGA,EAAID,EAAK,QAAU,CAACF,EAAW,OAAQG,GAAKJ,EAAsB,EAAI,EACpFC,EAAW,KAAKE,EAAKC,CAAC,CAAM,EAG9B,YAAK,wBAAwBH,CAAU,EAEhCC,CACT,EAEQd,EAAA,UAAA,YAAR,UAAA,CACQ,IAAAS,EAAoE,KAAlEN,EAAWM,EAAA,YAAEJ,EAAkBI,EAAA,mBAAEE,EAAOF,EAAA,QAAEG,EAAmBH,EAAA,oBAK/DQ,GAAsBL,EAAsB,EAAI,GAAKT,EAK3D,GAJAA,EAAc,KAAYc,EAAqBN,EAAQ,QAAUA,EAAQ,OAAO,EAAGA,EAAQ,OAASM,CAAkB,EAIlH,CAACL,EAAqB,CAKxB,QAJMM,EAAMb,EAAmB,IAAG,EAC9Bc,EAAO,EAGFH,EAAI,EAAGA,EAAIL,EAAQ,QAAWA,EAAQK,CAAC,GAAgBE,EAAKF,GAAK,EACxEG,EAAOH,EAETG,GAAQR,EAAQ,OAAO,EAAGQ,EAAO,CAAC,EAEtC,EACFnB,CAAA,EAzEsCoB,CAAO,EClB7C,IAAAC,GAAA,SAAAC,EAAA,CAA+BC,GAAAF,EAAAC,CAAA,EAC7B,SAAAD,EAAYG,EAAsBC,EAAmD,QACnFH,EAAA,KAAA,IAAA,GAAO,IACT,CAWO,OAAAD,EAAA,UAAA,SAAP,SAAgBK,EAAWC,EAAiB,CAAjB,OAAAA,IAAA,SAAAA,EAAA,GAClB,IACT,EACFN,CAAA,EAjB+BO,EAAY,ECHpC,IAAMC,GAAqC,CAGhD,YAAA,SAAYC,EAAqBC,EAAgB,SAAEC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,EAAA,CAAA,EAAA,UAAAA,CAAA,EACzC,IAAAC,EAAaL,GAAgB,SACrC,OAAIK,GAAQ,MAARA,EAAU,YACLA,EAAS,YAAW,MAApBA,EAAQC,EAAA,CAAaL,EAASC,CAAO,EAAAK,EAAKJ,CAAI,CAAA,CAAA,EAEhD,YAAW,MAAA,OAAAG,EAAA,CAACL,EAASC,CAAO,EAAAK,EAAKJ,CAAI,CAAA,CAAA,CAC9C,EACA,cAAA,SAAcK,EAAM,CACV,IAAAH,EAAaL,GAAgB,SACrC,QAAQK,GAAQ,KAAA,OAARA,EAAU,gBAAiB,eAAeG,CAAa,CACjE,EACA,SAAU,QCrBZ,IAAAC,GAAA,SAAAC,EAAA,CAAoCC,GAAAF,EAAAC,CAAA,EAOlC,SAAAD,EAAsBG,EAAqCC,EAAmD,CAA9G,IAAAC,EACEJ,EAAA,KAAA,KAAME,EAAWC,CAAI,GAAC,KADF,OAAAC,EAAA,UAAAF,EAAqCE,EAAA,KAAAD,EAFjDC,EAAA,QAAmB,IAI7B,CAEO,OAAAL,EAAA,UAAA,SAAP,SAAgBM,EAAWC,EAAiB,OAC1C,GADyBA,IAAA,SAAAA,EAAA,GACrB,KAAK,OACP,OAAO,KAIT,KAAK,MAAQD,EAEb,IAAME,EAAK,KAAK,GACVL,EAAY,KAAK,UAuBvB,OAAIK,GAAM,OACR,KAAK,GAAK,KAAK,eAAeL,EAAWK,EAAID,CAAK,GAKpD,KAAK,QAAU,GAEf,KAAK,MAAQA,EAEb,KAAK,IAAKE,EAAA,KAAK,MAAE,MAAAA,IAAA,OAAAA,EAAI,KAAK,eAAeN,EAAW,KAAK,GAAII,CAAK,EAE3D,IACT,EAEUP,EAAA,UAAA,eAAV,SAAyBG,EAA2BO,EAAmBH,EAAiB,CAAjB,OAAAA,IAAA,SAAAA,EAAA,GAC9DI,GAAiB,YAAYR,EAAU,MAAM,KAAKA,EAAW,IAAI,EAAGI,CAAK,CAClF,EAEUP,EAAA,UAAA,eAAV,SAAyBY,EAA4BJ,EAAkBD,EAAwB,CAE7F,GAFqEA,IAAA,SAAAA,EAAA,GAEjEA,GAAS,MAAQ,KAAK,QAAUA,GAAS,KAAK,UAAY,GAC5D,OAAOC,EAILA,GAAM,MACRG,GAAiB,cAAcH,CAAE,CAIrC,EAMOR,EAAA,UAAA,QAAP,SAAeM,EAAUC,EAAa,CACpC,GAAI,KAAK,OACP,OAAO,IAAI,MAAM,8BAA8B,EAGjD,KAAK,QAAU,GACf,IAAMM,EAAQ,KAAK,SAASP,EAAOC,CAAK,EACxC,GAAIM,EACF,OAAOA,EACE,KAAK,UAAY,IAAS,KAAK,IAAM,OAc9C,KAAK,GAAK,KAAK,eAAe,KAAK,UAAW,KAAK,GAAI,IAAI,EAE/D,EAEUb,EAAA,UAAA,SAAV,SAAmBM,EAAUQ,EAAc,CACzC,IAAIC,EAAmB,GACnBC,EACJ,GAAI,CACF,KAAK,KAAKV,CAAK,QACRW,EAAG,CACVF,EAAU,GAIVC,EAAaC,GAAQ,IAAI,MAAM,oCAAoC,EAErE,GAAIF,EACF,YAAK,YAAW,EACTC,CAEX,EAEAhB,EAAA,UAAA,YAAA,UAAA,CACE,GAAI,CAAC,KAAK,OAAQ,CACV,IAAAS,EAAoB,KAAlBD,EAAEC,EAAA,GAAEN,EAASM,EAAA,UACbS,EAAYf,EAAS,QAE7B,KAAK,KAAO,KAAK,MAAQ,KAAK,UAAY,KAC1C,KAAK,QAAU,GAEfgB,GAAUD,EAAS,IAAI,EACnBV,GAAM,OACR,KAAK,GAAK,KAAK,eAAeL,EAAWK,EAAI,IAAI,GAGnD,KAAK,MAAQ,KACbP,EAAA,UAAM,YAAW,KAAA,IAAA,EAErB,EACFD,CAAA,EA9IoCoB,EAAM,ECgB1C,IAAAC,GAAA,UAAA,CAGE,SAAAA,EAAoBC,EAAoCC,EAAiC,CAAjCA,IAAA,SAAAA,EAAoBF,EAAU,KAAlE,KAAA,oBAAAC,EAClB,KAAK,IAAMC,CACb,CA6BO,OAAAF,EAAA,UAAA,SAAP,SAAmBG,EAAqDC,EAAmBC,EAAS,CAA5B,OAAAD,IAAA,SAAAA,EAAA,GAC/D,IAAI,KAAK,oBAAuB,KAAMD,CAAI,EAAE,SAASE,EAAOD,CAAK,CAC1E,EAnCcJ,EAAA,IAAoBM,GAAsB,IAoC1DN,GArCA,ECnBA,IAAAO,GAAA,SAAAC,EAAA,CAAoCC,GAAAF,EAAAC,CAAA,EAkBlC,SAAAD,EAAYG,EAAgCC,EAAiC,CAAjCA,IAAA,SAAAA,EAAoBC,GAAU,KAA1E,IAAAC,EACEL,EAAA,KAAA,KAAME,EAAiBC,CAAG,GAAC,KAlBtB,OAAAE,EAAA,QAAmC,CAAA,EAOnCA,EAAA,QAAmB,IAY1B,CAEO,OAAAN,EAAA,UAAA,MAAP,SAAaO,EAAwB,CAC3B,IAAAC,EAAY,KAAI,QAExB,GAAI,KAAK,QAAS,CAChBA,EAAQ,KAAKD,CAAM,EACnB,OAGF,IAAIE,EACJ,KAAK,QAAU,GAEf,EACE,IAAKA,EAAQF,EAAO,QAAQA,EAAO,MAAOA,EAAO,KAAK,EACpD,YAEMA,EAASC,EAAQ,MAAK,GAIhC,GAFA,KAAK,QAAU,GAEXC,EAAO,CACT,KAAQF,EAASC,EAAQ,MAAK,GAC5BD,EAAO,YAAW,EAEpB,MAAME,EAEV,EACFT,CAAA,EAhDoCK,EAAS,EC6CtC,IAAMK,GAAiB,IAAIC,GAAeC,EAAW,EAK/CC,GAAQH,GCjDrB,IAAAI,GAAA,SAAAC,EAAA,CAA6CC,GAAAF,EAAAC,CAAA,EAC3C,SAAAD,EAAsBG,EAA8CC,EAAmD,CAAvH,IAAAC,EACEJ,EAAA,KAAA,KAAME,EAAWC,CAAI,GAAC,KADF,OAAAC,EAAA,UAAAF,EAA8CE,EAAA,KAAAD,GAEpE,CAEU,OAAAJ,EAAA,UAAA,eAAV,SAAyBG,EAAoCG,EAAkBC,EAAiB,CAE9F,OAF6EA,IAAA,SAAAA,EAAA,GAEzEA,IAAU,MAAQA,EAAQ,EACrBN,EAAA,UAAM,eAAc,KAAA,KAACE,EAAWG,EAAIC,CAAK,GAGlDJ,EAAU,QAAQ,KAAK,IAAI,EAIpBA,EAAU,aAAeA,EAAU,WAAaK,GAAuB,sBAAsB,UAAA,CAAM,OAAAL,EAAU,MAAM,MAAS,CAAzB,CAA0B,GACtI,EAEUH,EAAA,UAAA,eAAV,SAAyBG,EAAoCG,EAAkBC,EAAiB,OAI9F,GAJ6EA,IAAA,SAAAA,EAAA,GAIzEA,GAAS,KAAOA,EAAQ,EAAI,KAAK,MAAQ,EAC3C,OAAON,EAAA,UAAM,eAAc,KAAA,KAACE,EAAWG,EAAIC,CAAK,EAK1C,IAAAE,EAAYN,EAAS,QACzBG,GAAM,QAAQI,EAAAD,EAAQA,EAAQ,OAAS,CAAC,KAAC,MAAAC,IAAA,OAAA,OAAAA,EAAE,MAAOJ,IACpDE,GAAuB,qBAAqBF,CAAY,EACxDH,EAAU,WAAa,OAI3B,EACFH,CAAA,EApC6CW,EAAW,ECHxD,IAAAC,GAAA,SAAAC,EAAA,CAA6CC,GAAAF,EAAAC,CAAA,EAA7C,SAAAD,GAAA,+CAkCA,CAjCS,OAAAA,EAAA,UAAA,MAAP,SAAaG,EAAyB,CACpC,KAAK,QAAU,GAUf,IAAMC,EAAU,KAAK,WACrB,KAAK,WAAa,OAEV,IAAAC,EAAY,KAAI,QACpBC,EACJH,EAASA,GAAUE,EAAQ,MAAK,EAEhC,EACE,IAAKC,EAAQH,EAAO,QAAQA,EAAO,MAAOA,EAAO,KAAK,EACpD,aAEMA,EAASE,EAAQ,CAAC,IAAMF,EAAO,KAAOC,GAAWC,EAAQ,MAAK,GAIxE,GAFA,KAAK,QAAU,GAEXC,EAAO,CACT,MAAQH,EAASE,EAAQ,CAAC,IAAMF,EAAO,KAAOC,GAAWC,EAAQ,MAAK,GACpEF,EAAO,YAAW,EAEpB,MAAMG,EAEV,EACFN,CAAA,EAlC6CO,EAAc,ECgCpD,IAAMC,GAA0B,IAAIC,GAAwBC,EAAoB,EC8BhF,IAAMC,EAAQ,IAAIC,EAAkB,SAACC,EAAU,CAAK,OAAAA,EAAW,SAAQ,CAAnB,CAAqB,EC9D1E,SAAUC,GAAYC,EAAU,CACpC,OAAOA,GAASC,EAAWD,EAAM,QAAQ,CAC3C,CCDA,SAASE,GAAQC,EAAQ,CACvB,OAAOA,EAAIA,EAAI,OAAS,CAAC,CAC3B,CAEM,SAAUC,GAAkBC,EAAW,CAC3C,OAAOC,EAAWJ,GAAKG,CAAI,CAAC,EAAIA,EAAK,IAAG,EAAK,MAC/C,CAEM,SAAUE,GAAaF,EAAW,CACtC,OAAOG,GAAYN,GAAKG,CAAI,CAAC,EAAIA,EAAK,IAAG,EAAK,MAChD,CAEM,SAAUI,GAAUJ,EAAaK,EAAoB,CACzD,OAAO,OAAOR,GAAKG,CAAI,GAAM,SAAWA,EAAK,IAAG,EAAMK,CACxD,CClBO,IAAMC,GAAe,SAAIC,EAAM,CAAwB,OAAAA,GAAK,OAAOA,EAAE,QAAW,UAAY,OAAOA,GAAM,UAAlD,ECMxD,SAAUC,GAAUC,EAAU,CAClC,OAAOC,EAAWD,GAAK,KAAA,OAALA,EAAO,IAAI,CAC/B,CCHM,SAAUE,GAAoBC,EAAU,CAC5C,OAAOC,EAAWD,EAAME,EAAiB,CAAC,CAC5C,CCLM,SAAUC,GAAmBC,EAAQ,CACzC,OAAO,OAAO,eAAiBC,EAAWD,GAAG,KAAA,OAAHA,EAAM,OAAO,aAAa,CAAC,CACvE,CCAM,SAAUE,GAAiCC,EAAU,CAEzD,OAAO,IAAI,UACT,iBACEA,IAAU,MAAQ,OAAOA,GAAU,SAAW,oBAAsB,IAAIA,EAAK,KAAG,0HACwC,CAE9H,CCXM,SAAUC,IAAiB,CAC/B,OAAI,OAAO,QAAW,YAAc,CAAC,OAAO,SACnC,aAGF,OAAO,QAChB,CAEO,IAAMC,GAAWD,GAAiB,ECJnC,SAAUE,GAAWC,EAAU,CACnC,OAAOC,EAAWD,GAAK,KAAA,OAALA,EAAQE,EAAe,CAAC,CAC5C,CCHM,SAAiBC,GAAsCC,EAAqC,mGAC1FC,EAASD,EAAe,UAAS,2DAGX,MAAA,CAAA,EAAAE,GAAMD,EAAO,KAAI,CAAE,CAAA,gBAArCE,EAAkBC,EAAA,KAAA,EAAhBC,EAAKF,EAAA,MAAEG,EAAIH,EAAA,KACfG,iBAAA,CAAA,EAAA,CAAA,SACF,MAAA,CAAA,EAAAF,EAAA,KAAA,CAAA,qBAEIC,CAAM,CAAA,SAAZ,MAAA,CAAA,EAAAD,EAAA,KAAA,CAAA,SAAA,OAAAA,EAAA,KAAA,mCAGF,OAAAH,EAAO,YAAW,6BAIhB,SAAUM,GAAwBC,EAAQ,CAG9C,OAAOC,EAAWD,GAAG,KAAA,OAAHA,EAAK,SAAS,CAClC,CCPM,SAAUE,EAAaC,EAAyB,CACpD,GAAIA,aAAiBC,EACnB,OAAOD,EAET,GAAIA,GAAS,KAAM,CACjB,GAAIE,GAAoBF,CAAK,EAC3B,OAAOG,GAAsBH,CAAK,EAEpC,GAAII,GAAYJ,CAAK,EACnB,OAAOK,GAAcL,CAAK,EAE5B,GAAIM,GAAUN,CAAK,EACjB,OAAOO,GAAYP,CAAK,EAE1B,GAAIQ,GAAgBR,CAAK,EACvB,OAAOS,GAAkBT,CAAK,EAEhC,GAAIU,GAAWV,CAAK,EAClB,OAAOW,GAAaX,CAAK,EAE3B,GAAIY,GAAqBZ,CAAK,EAC5B,OAAOa,GAAuBb,CAAK,EAIvC,MAAMc,GAAiCd,CAAK,CAC9C,CAMM,SAAUG,GAAyBY,EAAQ,CAC/C,OAAO,IAAId,EAAW,SAACe,EAAyB,CAC9C,IAAMC,EAAMF,EAAIG,EAAiB,EAAC,EAClC,GAAIC,EAAWF,EAAI,SAAS,EAC1B,OAAOA,EAAI,UAAUD,CAAU,EAGjC,MAAM,IAAI,UAAU,gEAAgE,CACtF,CAAC,CACH,CASM,SAAUX,GAAiBe,EAAmB,CAClD,OAAO,IAAInB,EAAW,SAACe,EAAyB,CAU9C,QAASK,EAAI,EAAGA,EAAID,EAAM,QAAU,CAACJ,EAAW,OAAQK,IACtDL,EAAW,KAAKI,EAAMC,CAAC,CAAC,EAE1BL,EAAW,SAAQ,CACrB,CAAC,CACH,CAEM,SAAUT,GAAee,EAAuB,CACpD,OAAO,IAAIrB,EAAW,SAACe,EAAyB,CAC9CM,EACG,KACC,SAACC,EAAK,CACCP,EAAW,SACdA,EAAW,KAAKO,CAAK,EACrBP,EAAW,SAAQ,EAEvB,EACA,SAACQ,EAAQ,CAAK,OAAAR,EAAW,MAAMQ,CAAG,CAApB,CAAqB,EAEpC,KAAK,KAAMC,EAAoB,CACpC,CAAC,CACH,CAEM,SAAUd,GAAgBe,EAAqB,CACnD,OAAO,IAAIzB,EAAW,SAACe,EAAyB,aAC9C,QAAoBW,EAAAC,GAAAF,CAAQ,EAAAG,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAAzB,IAAMJ,EAAKM,EAAA,MAEd,GADAb,EAAW,KAAKO,CAAK,EACjBP,EAAW,OACb,yGAGJA,EAAW,SAAQ,CACrB,CAAC,CACH,CAEM,SAAUP,GAAqBqB,EAA+B,CAClE,OAAO,IAAI7B,EAAW,SAACe,EAAyB,CAC9Ce,GAAQD,EAAed,CAAU,EAAE,MAAM,SAACQ,EAAG,CAAK,OAAAR,EAAW,MAAMQ,CAAG,CAApB,CAAqB,CACzE,CAAC,CACH,CAEM,SAAUX,GAA0BmB,EAAqC,CAC7E,OAAOvB,GAAkBwB,GAAmCD,CAAc,CAAC,CAC7E,CAEA,SAAeD,GAAWD,EAAiCd,EAAyB,uIACxDkB,EAAAC,GAAAL,CAAa,gFAIrC,GAJeP,EAAKa,EAAA,MACpBpB,EAAW,KAAKO,CAAK,EAGjBP,EAAW,OACb,MAAA,CAAA,CAAA,6RAGJ,OAAAA,EAAW,SAAQ,WChHf,SAAUqB,GACdC,EACAC,EACAC,EACAC,EACAC,EAAc,CADdD,IAAA,SAAAA,EAAA,GACAC,IAAA,SAAAA,EAAA,IAEA,IAAMC,EAAuBJ,EAAU,SAAS,UAAA,CAC9CC,EAAI,EACAE,EACFJ,EAAmB,IAAI,KAAK,SAAS,KAAMG,CAAK,CAAC,EAEjD,KAAK,YAAW,CAEpB,EAAGA,CAAK,EAIR,GAFAH,EAAmB,IAAIK,CAAoB,EAEvC,CAACD,EAKH,OAAOC,CAEX,CCeM,SAAUC,GAAaC,EAA0BC,EAAS,CAAT,OAAAA,IAAA,SAAAA,EAAA,GAC9CC,EAAQ,SAACC,EAAQC,EAAU,CAChCD,EAAO,UACLE,EACED,EACA,SAACE,EAAK,CAAK,OAAAC,GAAgBH,EAAYJ,EAAW,UAAA,CAAM,OAAAI,EAAW,KAAKE,CAAK,CAArB,EAAwBL,CAAK,CAA1E,EACX,UAAA,CAAM,OAAAM,GAAgBH,EAAYJ,EAAW,UAAA,CAAM,OAAAI,EAAW,SAAQ,CAAnB,EAAuBH,CAAK,CAAzE,EACN,SAACO,EAAG,CAAK,OAAAD,GAAgBH,EAAYJ,EAAW,UAAA,CAAM,OAAAI,EAAW,MAAMI,CAAG,CAApB,EAAuBP,CAAK,CAAzE,CAA0E,CACpF,CAEL,CAAC,CACH,CCPM,SAAUQ,GAAeC,EAA0BC,EAAiB,CAAjB,OAAAA,IAAA,SAAAA,EAAA,GAChDC,EAAQ,SAACC,EAAQC,EAAU,CAChCA,EAAW,IAAIJ,EAAU,SAAS,UAAA,CAAM,OAAAG,EAAO,UAAUC,CAAU,CAA3B,EAA8BH,CAAK,CAAC,CAC9E,CAAC,CACH,CC7DM,SAAUI,GAAsBC,EAA6BC,EAAwB,CACzF,OAAOC,EAAUF,CAAK,EAAE,KAAKG,GAAYF,CAAS,EAAGG,GAAUH,CAAS,CAAC,CAC3E,CCFM,SAAUI,GAAmBC,EAAuBC,EAAwB,CAChF,OAAOC,EAAUF,CAAK,EAAE,KAAKG,GAAYF,CAAS,EAAGG,GAAUH,CAAS,CAAC,CAC3E,CCJM,SAAUI,GAAiBC,EAAqBC,EAAwB,CAC5E,OAAO,IAAIC,EAAc,SAACC,EAAU,CAElC,IAAIC,EAAI,EAER,OAAOH,EAAU,SAAS,UAAA,CACpBG,IAAMJ,EAAM,OAGdG,EAAW,SAAQ,GAInBA,EAAW,KAAKH,EAAMI,GAAG,CAAC,EAIrBD,EAAW,QACd,KAAK,SAAQ,EAGnB,CAAC,CACH,CAAC,CACH,CCfM,SAAUE,GAAoBC,EAAoBC,EAAwB,CAC9E,OAAO,IAAIC,EAAc,SAACC,EAAU,CAClC,IAAIC,EAKJ,OAAAC,GAAgBF,EAAYF,EAAW,UAAA,CAErCG,EAAYJ,EAAcI,EAAe,EAAC,EAE1CC,GACEF,EACAF,EACA,UAAA,OACMK,EACAC,EACJ,GAAI,CAEDC,EAAkBJ,EAAS,KAAI,EAA7BE,EAAKE,EAAA,MAAED,EAAIC,EAAA,WACPC,EAAK,CAEZN,EAAW,MAAMM,CAAG,EACpB,OAGEF,EAKFJ,EAAW,SAAQ,EAGnBA,EAAW,KAAKG,CAAK,CAEzB,EACA,EACA,EAAI,CAER,CAAC,EAMM,UAAA,CAAM,OAAAI,EAAWN,GAAQ,KAAA,OAARA,EAAU,MAAM,GAAKA,EAAS,OAAM,CAA/C,CACf,CAAC,CACH,CCvDM,SAAUO,GAAyBC,EAAyBC,EAAwB,CACxF,GAAI,CAACD,EACH,MAAM,IAAI,MAAM,yBAAyB,EAE3C,OAAO,IAAIE,EAAc,SAACC,EAAU,CAClCC,GAAgBD,EAAYF,EAAW,UAAA,CACrC,IAAMI,EAAWL,EAAM,OAAO,aAAa,EAAC,EAC5CI,GACED,EACAF,EACA,UAAA,CACEI,EAAS,KAAI,EAAG,KAAK,SAACC,EAAM,CACtBA,EAAO,KAGTH,EAAW,SAAQ,EAEnBA,EAAW,KAAKG,EAAO,KAAK,CAEhC,CAAC,CACH,EACA,EACA,EAAI,CAER,CAAC,CACH,CAAC,CACH,CCzBM,SAAUC,GAA8BC,EAA8BC,EAAwB,CAClG,OAAOC,GAAsBC,GAAmCH,CAAK,EAAGC,CAAS,CACnF,CCoBM,SAAUG,GAAaC,EAA2BC,EAAwB,CAC9E,GAAID,GAAS,KAAM,CACjB,GAAIE,GAAoBF,CAAK,EAC3B,OAAOG,GAAmBH,EAAOC,CAAS,EAE5C,GAAIG,GAAYJ,CAAK,EACnB,OAAOK,GAAcL,EAAOC,CAAS,EAEvC,GAAIK,GAAUN,CAAK,EACjB,OAAOO,GAAgBP,EAAOC,CAAS,EAEzC,GAAIO,GAAgBR,CAAK,EACvB,OAAOS,GAAsBT,EAAOC,CAAS,EAE/C,GAAIS,GAAWV,CAAK,EAClB,OAAOW,GAAiBX,EAAOC,CAAS,EAE1C,GAAIW,GAAqBZ,CAAK,EAC5B,OAAOa,GAA2Bb,EAAOC,CAAS,EAGtD,MAAMa,GAAiCd,CAAK,CAC9C,CCoDM,SAAUe,GAAQC,EAA2BC,EAAyB,CAC1E,OAAOA,EAAYC,GAAUF,EAAOC,CAAS,EAAIE,EAAUH,CAAK,CAClE,CCxBM,SAAUI,GAAE,SAAIC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACpB,IAAMC,EAAYC,GAAaH,CAAI,EACnC,OAAOI,GAAKJ,EAAaE,CAAS,CACpC,CCsCM,SAAUG,GAAWC,EAA0BC,EAAyB,CAC5E,IAAMC,EAAeC,EAAWH,CAAmB,EAAIA,EAAsB,UAAA,CAAM,OAAAA,CAAA,EAC7EI,EAAO,SAACC,EAA6B,CAAK,OAAAA,EAAW,MAAMH,EAAY,CAAE,CAA/B,EAChD,OAAO,IAAII,EAAWL,EAAY,SAACI,EAAU,CAAK,OAAAJ,EAAU,SAASG,EAAa,EAAGC,CAAU,CAA7C,EAAiDD,CAAI,CACzG,CCpGO,IAAMG,GAA6BC,GAAiB,SAACC,EAAM,CAAK,OAAA,UAAuB,CAC5FA,EAAO,IAAI,EACX,KAAK,KAAO,aACZ,KAAK,QAAU,yBACjB,CAJuE,CAItE,ECrBK,SAAUC,GAAYC,EAAU,CACpC,OAAOA,aAAiB,MAAQ,CAAC,MAAMA,CAAY,CACrD,CCsCM,SAAUC,EAAUC,EAAyCC,EAAa,CAC9E,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAEhC,IAAIC,EAAQ,EAGZF,EAAO,UACLG,EAAyBF,EAAY,SAACG,EAAQ,CAG5CH,EAAW,KAAKJ,EAAQ,KAAKC,EAASM,EAAOF,GAAO,CAAC,CACvD,CAAC,CAAC,CAEN,CAAC,CACH,CC1DQ,IAAAG,GAAY,MAAK,QAEzB,SAASC,GAAkBC,EAA6BC,EAAW,CAC/D,OAAOH,GAAQG,CAAI,EAAID,EAAE,MAAA,OAAAE,EAAA,CAAA,EAAAC,EAAIF,CAAI,CAAA,CAAA,EAAID,EAAGC,CAAI,CAChD,CAMM,SAAUG,GAAuBJ,EAA2B,CAC9D,OAAOK,EAAI,SAAAJ,EAAI,CAAI,OAAAF,GAAYC,EAAIC,CAAI,CAApB,CAAqB,CAC5C,CCfQ,IAAAK,GAAY,MAAK,QACjBC,GAA0D,OAAM,eAArCC,GAA+B,OAAM,UAAlBC,GAAY,OAAM,KAQlE,SAAUC,GAAqDC,EAAuB,CAC1F,GAAIA,EAAK,SAAW,EAAG,CACrB,IAAMC,EAAQD,EAAK,CAAC,EACpB,GAAIL,GAAQM,CAAK,EACf,MAAO,CAAE,KAAMA,EAAO,KAAM,IAAI,EAElC,GAAIC,GAAOD,CAAK,EAAG,CACjB,IAAME,EAAOL,GAAQG,CAAK,EAC1B,MAAO,CACL,KAAME,EAAK,IAAI,SAACC,EAAG,CAAK,OAAAH,EAAMG,CAAG,CAAT,CAAU,EAClC,KAAID,IAKV,MAAO,CAAE,KAAMH,EAAa,KAAM,IAAI,CACxC,CAEA,SAASE,GAAOG,EAAQ,CACtB,OAAOA,GAAO,OAAOA,GAAQ,UAAYT,GAAeS,CAAG,IAAMR,EACnE,CC7BM,SAAUS,GAAaC,EAAgBC,EAAa,CACxD,OAAOD,EAAK,OAAO,SAACE,EAAQC,EAAKC,EAAC,CAAK,OAAEF,EAAOC,CAAG,EAAIF,EAAOG,CAAC,EAAIF,CAA5B,EAAqC,CAAA,CAAS,CACvF,CCsMM,SAAUG,GAAa,SAAoCC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAC/D,IAAMC,EAAYC,GAAaH,CAAI,EAC7BI,EAAiBC,GAAkBL,CAAI,EAEvCM,EAA8BC,GAAqBP,CAAI,EAA/CQ,EAAWF,EAAA,KAAEG,EAAIH,EAAA,KAE/B,GAAIE,EAAY,SAAW,EAIzB,OAAOE,GAAK,CAAA,EAAIR,CAAgB,EAGlC,IAAMS,EAAS,IAAIC,EACjBC,GACEL,EACAN,EACAO,EAEI,SAACK,EAAM,CAAK,OAAAC,GAAaN,EAAMK,CAAM,CAAzB,EAEZE,EAAQ,CACb,EAGH,OAAOZ,EAAkBO,EAAO,KAAKM,GAAiBb,CAAc,CAAC,EAAsBO,CAC7F,CAEM,SAAUE,GACdL,EACAN,EACAgB,EAAiD,CAAjD,OAAAA,IAAA,SAAAA,EAAAF,IAEO,SAACG,EAA2B,CAGjCC,GACElB,EACA,UAAA,CAaE,QAZQmB,EAAWb,EAAW,OAExBM,EAAS,IAAI,MAAMO,CAAM,EAG3BC,EAASD,EAITE,EAAuBF,aAGlBG,EAAC,CACRJ,GACElB,EACA,UAAA,CACE,IAAMuB,EAASf,GAAKF,EAAYgB,CAAC,EAAGtB,CAAgB,EAChDwB,EAAgB,GACpBD,EAAO,UACLE,EACER,EACA,SAACS,EAAK,CAEJd,EAAOU,CAAC,EAAII,EACPF,IAEHA,EAAgB,GAChBH,KAEGA,GAGHJ,EAAW,KAAKD,EAAeJ,EAAO,MAAK,CAAE,CAAC,CAElD,EACA,UAAA,CACO,EAAEQ,GAGLH,EAAW,SAAQ,CAEvB,CAAC,CACF,CAEL,EACAA,CAAU,GAjCLK,EAAI,EAAGA,EAAIH,EAAQG,MAAnBA,CAAC,CAoCZ,EACAL,CAAU,CAEd,CACF,CAMA,SAASC,GAAclB,EAAsC2B,EAAqBC,EAA0B,CACtG5B,EACF6B,GAAgBD,EAAc5B,EAAW2B,CAAO,EAEhDA,EAAO,CAEX,CC3RM,SAAUG,GACdC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EAAgC,CAGhC,IAAMC,EAAc,CAAA,EAEhBC,EAAS,EAETC,EAAQ,EAERC,EAAa,GAKXC,EAAgB,UAAA,CAIhBD,GAAc,CAACH,EAAO,QAAU,CAACC,GACnCR,EAAW,SAAQ,CAEvB,EAGMY,EAAY,SAACC,EAAQ,CAAK,OAACL,EAASN,EAAaY,EAAWD,CAAK,EAAIN,EAAO,KAAKM,CAAK,CAA5D,EAE1BC,EAAa,SAACD,EAAQ,CAI1BT,GAAUJ,EAAW,KAAKa,CAAY,EAItCL,IAKA,IAAIO,EAAgB,GAGpBC,EAAUf,EAAQY,EAAOJ,GAAO,CAAC,EAAE,UACjCQ,EACEjB,EACA,SAACkB,GAAU,CAGTf,GAAY,MAAZA,EAAee,EAAU,EAErBd,EAGFQ,EAAUM,EAAiB,EAG3BlB,EAAW,KAAKkB,EAAU,CAE9B,EACA,UAAA,CAGEH,EAAgB,EAClB,EAEA,OACA,UAAA,CAIE,GAAIA,EAKF,GAAI,CAIFP,IAKA,sBACE,IAAMW,EAAgBZ,EAAO,MAAK,EAI9BF,EACFe,GAAgBpB,EAAYK,EAAmB,UAAA,CAAM,OAAAS,EAAWK,CAAa,CAAxB,CAAyB,EAE9EL,EAAWK,CAAa,GARrBZ,EAAO,QAAUC,EAASN,QAYjCS,EAAa,QACNU,EAAK,CACZrB,EAAW,MAAMqB,CAAG,EAG1B,CAAC,CACF,CAEL,EAGA,OAAAtB,EAAO,UACLkB,EAAyBjB,EAAYY,EAAW,UAAA,CAE9CF,EAAa,GACbC,EAAa,CACf,CAAC,CAAC,EAKG,UAAA,CACLL,GAAmB,MAAnBA,EAAmB,CACrB,CACF,CClEM,SAAUgB,GACdC,EACAC,EACAC,EAA6B,CAE7B,OAFAA,IAAA,SAAAA,EAAA,KAEIC,EAAWF,CAAc,EAEpBF,GAAS,SAACK,EAAGC,EAAC,CAAK,OAAAC,EAAI,SAACC,EAAQC,EAAU,CAAK,OAAAP,EAAeG,EAAGG,EAAGF,EAAGG,CAAE,CAA1B,CAA2B,EAAEC,EAAUT,EAAQI,EAAGC,CAAC,CAAC,CAAC,CAAjF,EAAoFH,CAAU,GAC/G,OAAOD,GAAmB,WACnCC,EAAaD,GAGRS,EAAQ,SAACC,EAAQC,EAAU,CAAK,OAAAC,GAAeF,EAAQC,EAAYZ,EAASE,CAAU,CAAtD,CAAuD,EAChG,CChCM,SAAUY,GAAyCC,EAA6B,CAA7B,OAAAA,IAAA,SAAAA,EAAA,KAChDC,GAASC,GAAUF,CAAU,CACtC,CCNM,SAAUG,IAAS,CACvB,OAAOC,GAAS,CAAC,CACnB,CCmDM,SAAUC,IAAM,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACrB,OAAOC,GAAS,EAAGC,GAAKH,EAAMI,GAAaJ,CAAI,CAAC,CAAC,CACnD,CC9DM,SAAUK,EAAsCC,EAA0B,CAC9E,OAAO,IAAIC,EAA+B,SAACC,EAAU,CACnDC,EAAUH,EAAiB,CAAE,EAAE,UAAUE,CAAU,CACrD,CAAC,CACH,CChDA,IAAME,GAA0B,CAAC,cAAe,gBAAgB,EAC1DC,GAAqB,CAAC,mBAAoB,qBAAqB,EAC/DC,GAAgB,CAAC,KAAM,KAAK,EAkO5B,SAAUC,EACdC,EACAC,EACAC,EACAC,EAAsC,CAMtC,GAJIC,EAAWF,CAAO,IACpBC,EAAiBD,EACjBA,EAAU,QAERC,EACF,OAAOJ,EAAaC,EAAQC,EAAWC,CAA+B,EAAE,KAAKG,GAAiBF,CAAc,CAAC,EAUzG,IAAAG,EAAAC,EAEJC,GAAcR,CAAM,EAChBH,GAAmB,IAAI,SAACY,EAAU,CAAK,OAAA,SAACC,EAAY,CAAK,OAAAV,EAAOS,CAAU,EAAER,EAAWS,EAASR,CAA+B,CAAtE,CAAlB,CAAyF,EAElIS,GAAwBX,CAAM,EAC5BJ,GAAwB,IAAIgB,GAAwBZ,EAAQC,CAAS,CAAC,EACtEY,GAA0Bb,CAAM,EAChCF,GAAc,IAAIc,GAAwBZ,EAAQC,CAAS,CAAC,EAC5D,CAAA,EAAE,CAAA,EATDa,EAAGR,EAAA,CAAA,EAAES,EAAMT,EAAA,CAAA,EAgBlB,GAAI,CAACQ,GACCE,GAAYhB,CAAM,EACpB,OAAOiB,GAAS,SAACC,EAAc,CAAK,OAAAnB,EAAUmB,EAAWjB,EAAWC,CAA+B,CAA/D,CAAgE,EAClGiB,EAAUnB,CAAM,CAAC,EAOvB,GAAI,CAACc,EACH,MAAM,IAAI,UAAU,sBAAsB,EAG5C,OAAO,IAAIM,EAAc,SAACC,EAAU,CAIlC,IAAMX,EAAU,UAAA,SAACY,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAAmB,OAAAF,EAAW,KAAK,EAAIC,EAAK,OAASA,EAAOA,EAAK,CAAC,CAAC,CAAhD,EAEpC,OAAAR,EAAIJ,CAAO,EAEJ,UAAA,CAAM,OAAAK,EAAQL,CAAO,CAAf,CACf,CAAC,CACH,CASA,SAASE,GAAwBZ,EAAaC,EAAiB,CAC7D,OAAO,SAACQ,EAAkB,CAAK,OAAA,SAACC,EAAY,CAAK,OAAAV,EAAOS,CAAU,EAAER,EAAWS,CAAO,CAArC,CAAlB,CACjC,CAOA,SAASC,GAAwBX,EAAW,CAC1C,OAAOI,EAAWJ,EAAO,WAAW,GAAKI,EAAWJ,EAAO,cAAc,CAC3E,CAOA,SAASa,GAA0Bb,EAAW,CAC5C,OAAOI,EAAWJ,EAAO,EAAE,GAAKI,EAAWJ,EAAO,GAAG,CACvD,CAOA,SAASQ,GAAcR,EAAW,CAChC,OAAOI,EAAWJ,EAAO,gBAAgB,GAAKI,EAAWJ,EAAO,mBAAmB,CACrF,CCnMM,SAAUwB,GACdC,EACAC,EACAC,EAAsC,CAEtC,OAAIA,EACKH,GAAoBC,EAAYC,CAAa,EAAE,KAAKE,GAAiBD,CAAc,CAAC,EAGtF,IAAIE,EAAoB,SAACC,EAAU,CACxC,IAAMC,EAAU,UAAA,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAAc,OAAAH,EAAW,KAAKE,EAAE,SAAW,EAAIA,EAAE,CAAC,EAAIA,CAAC,CAAzC,EACzBE,EAAWT,EAAWM,CAAO,EACnC,OAAOI,EAAWT,CAAa,EAAI,UAAA,CAAM,OAAAA,EAAcK,EAASG,CAAQ,CAA/B,EAAmC,MAC9E,CAAC,CACH,CCtBM,SAAUE,GACdC,EACAC,EACAC,EAAyC,CAFzCF,IAAA,SAAAA,EAAA,GAEAE,IAAA,SAAAA,EAAAC,IAIA,IAAIC,EAAmB,GAEvB,OAAIH,GAAuB,OAIrBI,GAAYJ,CAAmB,EACjCC,EAAYD,EAIZG,EAAmBH,GAIhB,IAAIK,EAAW,SAACC,EAAU,CAI/B,IAAIC,EAAMC,GAAYT,CAAO,EAAI,CAACA,EAAUE,EAAW,IAAG,EAAKF,EAE3DQ,EAAM,IAERA,EAAM,GAIR,IAAIE,EAAI,EAGR,OAAOR,EAAU,SAAS,UAAA,CACnBK,EAAW,SAEdA,EAAW,KAAKG,GAAG,EAEf,GAAKN,EAGP,KAAK,SAAS,OAAWA,CAAgB,EAGzCG,EAAW,SAAQ,EAGzB,EAAGC,CAAG,CACR,CAAC,CACH,CChGM,SAAUG,GAAK,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACpB,IAAMC,EAAYC,GAAaH,CAAI,EAC7BI,EAAaC,GAAUL,EAAM,GAAQ,EACrCM,EAAUN,EAChB,OAAQM,EAAQ,OAGZA,EAAQ,SAAW,EAEnBC,EAAUD,EAAQ,CAAC,CAAC,EAEpBE,GAASJ,CAAU,EAAEK,GAAKH,EAASJ,CAAS,CAAC,EAL7CQ,CAMN,CCjEO,IAAMC,GAAQ,IAAIC,EAAkBC,EAAI,ECpCvC,IAAAC,GAAY,MAAK,QAMnB,SAAUC,GAAkBC,EAAiB,CACjD,OAAOA,EAAK,SAAW,GAAKF,GAAQE,EAAK,CAAC,CAAC,EAAIA,EAAK,CAAC,EAAKA,CAC5D,CCoDM,SAAUC,EAAUC,EAAiDC,EAAa,CACtF,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAEhC,IAAIC,EAAQ,EAIZF,EAAO,UAILG,EAAyBF,EAAY,SAACG,EAAK,CAAK,OAAAP,EAAU,KAAKC,EAASM,EAAOF,GAAO,GAAKD,EAAW,KAAKG,CAAK,CAAhE,CAAiE,CAAC,CAEtH,CAAC,CACH,CCxBM,SAAUC,IAAG,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAClB,IAAMC,EAAiBC,GAAkBH,CAAI,EAEvCI,EAAUC,GAAeL,CAAI,EAEnC,OAAOI,EAAQ,OACX,IAAIE,EAAsB,SAACC,EAAU,CAGnC,IAAIC,EAAuBJ,EAAQ,IAAI,UAAA,CAAM,MAAA,CAAA,CAAA,CAAE,EAK3CK,EAAYL,EAAQ,IAAI,UAAA,CAAM,MAAA,EAAA,CAAK,EAGvCG,EAAW,IAAI,UAAA,CACbC,EAAUC,EAAY,IACxB,CAAC,EAKD,mBAASC,EAAW,CAClBC,EAAUP,EAAQM,CAAW,CAAC,EAAE,UAC9BE,EACEL,EACA,SAACM,EAAK,CAKJ,GAJAL,EAAQE,CAAW,EAAE,KAAKG,CAAK,EAI3BL,EAAQ,MAAM,SAACM,EAAM,CAAK,OAAAA,EAAO,MAAP,CAAa,EAAG,CAC5C,IAAMC,EAAcP,EAAQ,IAAI,SAACM,EAAM,CAAK,OAAAA,EAAO,MAAK,CAAZ,CAAe,EAE3DP,EAAW,KAAKL,EAAiBA,EAAc,MAAA,OAAAc,EAAA,CAAA,EAAAC,EAAIF,CAAM,CAAA,CAAA,EAAIA,CAAM,EAI/DP,EAAQ,KAAK,SAACM,EAAQI,EAAC,CAAK,MAAA,CAACJ,EAAO,QAAUL,EAAUS,CAAC,CAA7B,CAA8B,GAC5DX,EAAW,SAAQ,EAGzB,EACA,UAAA,CAGEE,EAAUC,CAAW,EAAI,GAIzB,CAACF,EAAQE,CAAW,EAAE,QAAUH,EAAW,SAAQ,CACrD,CAAC,CACF,GA9BIG,EAAc,EAAG,CAACH,EAAW,QAAUG,EAAcN,EAAQ,OAAQM,MAArEA,CAAW,EAmCpB,OAAO,UAAA,CACLF,EAAUC,EAAY,IACxB,CACF,CAAC,EACDU,CACN,CC9DM,SAAUC,GAASC,EAAoD,CAC3E,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAW,GACXC,EAAsB,KACtBC,EAA6C,KAC7CC,EAAa,GAEXC,EAAc,UAAA,CAGlB,GAFAF,GAAkB,MAAlBA,EAAoB,YAAW,EAC/BA,EAAqB,KACjBF,EAAU,CACZA,EAAW,GACX,IAAMK,EAAQJ,EACdA,EAAY,KACZF,EAAW,KAAKM,CAAK,EAEvBF,GAAcJ,EAAW,SAAQ,CACnC,EAEMO,EAAkB,UAAA,CACtBJ,EAAqB,KACrBC,GAAcJ,EAAW,SAAQ,CACnC,EAEAD,EAAO,UACLS,EACER,EACA,SAACM,EAAK,CACJL,EAAW,GACXC,EAAYI,EACPH,GACHM,EAAUZ,EAAiBS,CAAK,CAAC,EAAE,UAChCH,EAAqBK,EAAyBR,EAAYK,EAAaE,CAAe,CAAE,CAG/F,EACA,UAAA,CACEH,EAAa,IACZ,CAACH,GAAY,CAACE,GAAsBA,EAAmB,SAAWH,EAAW,SAAQ,CACxF,CAAC,CACF,CAEL,CAAC,CACH,CC3CM,SAAUU,GAAaC,EAAkBC,EAAyC,CAAzC,OAAAA,IAAA,SAAAA,EAAAC,IACtCC,GAAM,UAAA,CAAM,OAAAC,GAAMJ,EAAUC,CAAS,CAAzB,CAA0B,CAC/C,CCEM,SAAUI,GAAeC,EAAoBC,EAAsC,CAAtC,OAAAA,IAAA,SAAAA,EAAA,MAGjDA,EAAmBA,GAAgB,KAAhBA,EAAoBD,EAEhCE,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAiB,CAAA,EACjBC,EAAQ,EAEZH,EAAO,UACLI,EACEH,EACA,SAACI,EAAK,aACAC,EAAuB,KAKvBH,IAAUL,IAAsB,GAClCI,EAAQ,KAAK,CAAA,CAAE,MAIjB,QAAqBK,EAAAC,GAAAN,CAAO,EAAAO,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAAzB,IAAMG,EAAMD,EAAA,MACfC,EAAO,KAAKL,CAAK,EAMbR,GAAca,EAAO,SACvBJ,EAASA,GAAM,KAANA,EAAU,CAAA,EACnBA,EAAO,KAAKI,CAAM,uGAItB,GAAIJ,MAIF,QAAqBK,EAAAH,GAAAF,CAAM,EAAAM,EAAAD,EAAA,KAAA,EAAA,CAAAC,EAAA,KAAAA,EAAAD,EAAA,KAAA,EAAE,CAAxB,IAAMD,EAAME,EAAA,MACfC,GAAUX,EAASQ,CAAM,EACzBT,EAAW,KAAKS,CAAM,sGAG5B,EACA,UAAA,aAGE,QAAqBI,EAAAN,GAAAN,CAAO,EAAAa,EAAAD,EAAA,KAAA,EAAA,CAAAC,EAAA,KAAAA,EAAAD,EAAA,KAAA,EAAE,CAAzB,IAAMJ,EAAMK,EAAA,MACfd,EAAW,KAAKS,CAAM,oGAExBT,EAAW,SAAQ,CACrB,EAEA,OACA,UAAA,CAEEC,EAAU,IACZ,CAAC,CACF,CAEL,CAAC,CACH,CCbM,SAAUc,GACdC,EAAgD,CAEhD,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAgC,KAChCC,EAAY,GACZC,EAEJF,EAAWF,EAAO,UAChBK,EAAyBJ,EAAY,OAAW,OAAW,SAACK,EAAG,CAC7DF,EAAgBG,EAAUT,EAASQ,EAAKT,GAAWC,CAAQ,EAAEE,CAAM,CAAC,CAAC,EACjEE,GACFA,EAAS,YAAW,EACpBA,EAAW,KACXE,EAAc,UAAUH,CAAU,GAIlCE,EAAY,EAEhB,CAAC,CAAC,EAGAA,IAMFD,EAAS,YAAW,EACpBA,EAAW,KACXE,EAAe,UAAUH,CAAU,EAEvC,CAAC,CACH,CC/HM,SAAUO,GACdC,EACAC,EACAC,EACAC,EACAC,EAAqC,CAErC,OAAO,SAACC,EAAuBC,EAA2B,CAIxD,IAAIC,EAAWL,EAIXM,EAAaP,EAEbQ,EAAQ,EAGZJ,EAAO,UACLK,EACEJ,EACA,SAACK,EAAK,CAEJ,IAAMC,EAAIH,IAEVD,EAAQD,EAEJP,EAAYQ,EAAOG,EAAOC,CAAC,GAIzBL,EAAW,GAAOI,GAGxBR,GAAcG,EAAW,KAAKE,CAAK,CACrC,EAGAJ,GACG,UAAA,CACCG,GAAYD,EAAW,KAAKE,CAAK,EACjCF,EAAW,SAAQ,CACrB,CAAE,CACL,CAEL,CACF,CCnCM,SAAUO,IAAa,SAAOC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAClC,IAAMC,EAAiBC,GAAkBH,CAAI,EAC7C,OAAOE,EACHE,GAAKL,GAAa,MAAA,OAAAM,EAAA,CAAA,EAAAC,EAAKN,CAAoC,CAAA,CAAA,EAAGO,GAAiBL,CAAc,CAAC,EAC9FM,EAAQ,SAACC,EAAQC,EAAU,CACzBC,GAAiBN,EAAA,CAAEI,CAAM,EAAAH,EAAKM,GAAeZ,CAAI,CAAC,CAAA,CAAA,EAAGU,CAAU,CACjE,CAAC,CACP,CCUM,SAAUG,IAAiB,SAC/BC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAEA,OAAOC,GAAa,MAAA,OAAAC,EAAA,CAAA,EAAAC,EAAIJ,CAAY,CAAA,CAAA,CACtC,CCgBM,SAAUK,GAAgBC,EAAiBC,EAAyC,CAAzC,OAAAA,IAAA,SAAAA,EAAAC,IACxCC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAkC,KAClCC,EAAsB,KACtBC,EAA0B,KAExBC,EAAO,UAAA,CACX,GAAIH,EAAY,CAEdA,EAAW,YAAW,EACtBA,EAAa,KACb,IAAMI,EAAQH,EACdA,EAAY,KACZF,EAAW,KAAKK,CAAK,EAEzB,EACA,SAASC,GAAY,CAInB,IAAMC,EAAaJ,EAAYR,EACzBa,EAAMZ,EAAU,IAAG,EACzB,GAAIY,EAAMD,EAAY,CAEpBN,EAAa,KAAK,SAAS,OAAWM,EAAaC,CAAG,EACtDR,EAAW,IAAIC,CAAU,EACzB,OAGFG,EAAI,CACN,CAEAL,EAAO,UACLU,EACET,EACA,SAACK,EAAQ,CACPH,EAAYG,EACZF,EAAWP,EAAU,IAAG,EAGnBK,IACHA,EAAaL,EAAU,SAASU,EAAcX,CAAO,EACrDK,EAAW,IAAIC,CAAU,EAE7B,EACA,UAAA,CAGEG,EAAI,EACJJ,EAAW,SAAQ,CACrB,EAEA,OACA,UAAA,CAEEE,EAAYD,EAAa,IAC3B,CAAC,CACF,CAEL,CAAC,CACH,CCpFM,SAAUS,GAAqBC,EAAe,CAClD,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAW,GACfF,EAAO,UACLG,EACEF,EACA,SAACG,EAAK,CACJF,EAAW,GACXD,EAAW,KAAKG,CAAK,CACvB,EACA,UAAA,CACOF,GACHD,EAAW,KAAKH,CAAa,EAE/BG,EAAW,SAAQ,CACrB,CAAC,CACF,CAEL,CAAC,CACH,CCXM,SAAUI,GAAQC,EAAa,CACnC,OAAOA,GAAS,EAEZ,UAAA,CAAM,OAAAC,CAAA,EACNC,EAAQ,SAACC,EAAQC,EAAU,CACzB,IAAIC,EAAO,EACXF,EAAO,UACLG,EAAyBF,EAAY,SAACG,EAAK,CAIrC,EAAEF,GAAQL,IACZI,EAAW,KAAKG,CAAK,EAIjBP,GAASK,GACXD,EAAW,SAAQ,EAGzB,CAAC,CAAC,CAEN,CAAC,CACP,CC9BM,SAAUI,IAAc,CAC5B,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChCD,EAAO,UAAUE,EAAyBD,EAAYE,EAAI,CAAC,CAC7D,CAAC,CACH,CCCM,SAAUC,GAASC,EAAQ,CAC/B,OAAOC,EAAI,UAAA,CAAM,OAAAD,CAAA,CAAK,CACxB,CC4CM,SAAUE,GACdC,EACAC,EAAmC,CAEnC,OAAIA,EAEK,SAACC,EAAqB,CAC3B,OAAAC,GAAOF,EAAkB,KAAKG,GAAK,CAAC,EAAGC,GAAc,CAAE,EAAGH,EAAO,KAAKH,GAAUC,CAAqB,CAAC,CAAC,CAAvG,EAGGM,GAAS,SAACC,EAAOC,EAAK,CAAK,OAAAC,EAAUT,EAAsBO,EAAOC,CAAK,CAAC,EAAE,KAAKJ,GAAK,CAAC,EAAGM,GAAMH,CAAK,CAAC,CAAzE,CAA0E,CAC9G,CCzCM,SAAUI,GAASC,EAAoBC,EAAyC,CAAzCA,IAAA,SAAAA,EAAAC,IAC3C,IAAMC,EAAWC,GAAMJ,EAAKC,CAAS,EACrC,OAAOI,GAAU,UAAA,CAAM,OAAAF,CAAA,CAAQ,CACjC,CC0EM,SAAUG,EACdC,EACAC,EAA0D,CAA1D,OAAAA,IAAA,SAAAA,EAA+BC,IAK/BF,EAAaA,GAAU,KAAVA,EAAcG,GAEpBC,EAAQ,SAACC,EAAQC,EAAU,CAGhC,IAAIC,EAEAC,EAAQ,GAEZH,EAAO,UACLI,EAAyBH,EAAY,SAACI,EAAK,CAEzC,IAAMC,EAAaV,EAAYS,CAAK,GAKhCF,GAAS,CAACR,EAAYO,EAAaI,CAAU,KAM/CH,EAAQ,GACRD,EAAcI,EAGdL,EAAW,KAAKI,CAAK,EAEzB,CAAC,CAAC,CAEN,CAAC,CACH,CAEA,SAASP,GAAeS,EAAQC,EAAM,CACpC,OAAOD,IAAMC,CACf,CCjHM,SAAUC,EAA8CC,EAAQC,EAAuC,CAC3G,OAAOC,EAAqB,SAACC,EAAMC,EAAI,CAAK,OAAAH,EAAUA,EAAQE,EAAEH,CAAG,EAAGI,EAAEJ,CAAG,CAAC,EAAIG,EAAEH,CAAG,IAAMI,EAAEJ,CAAG,CAApD,CAAqD,CACnG,CC7BM,SAAUK,GAAgBC,EAA6C,CAA7C,OAAAA,IAAA,SAAAA,EAAAC,IACvBC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAW,GACfF,EAAO,UACLG,EACEF,EACA,SAACG,EAAK,CACJF,EAAW,GACXD,EAAW,KAAKG,CAAK,CACvB,EACA,UAAA,CAAM,OAACF,EAAWD,EAAW,SAAQ,EAAKA,EAAW,MAAMJ,EAAY,CAAE,CAAnE,CAAqE,CAC5E,CAEL,CAAC,CACH,CAEA,SAASC,IAAmB,CAC1B,OAAO,IAAIO,EACb,CCMM,SAAUC,IAAO,SAAIC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACzB,OAAO,SAACC,EAAqB,CAAK,OAAAC,GAAOD,EAAQE,EAAE,MAAA,OAAAC,EAAA,CAAA,EAAAC,EAAIN,CAAM,CAAA,CAAA,CAAA,CAA3B,CACpC,CCHM,SAAUO,EAAYC,EAAoB,CAC9C,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAGhC,GAAI,CACFD,EAAO,UAAUC,CAAU,UAE3BA,EAAW,IAAIH,CAAQ,EAE3B,CAAC,CACH,CCMM,SAAUI,GACdC,EACAC,EAAgB,CAEhB,IAAMC,EAAkB,UAAU,QAAU,EAC5C,OAAO,SAACC,EAAqB,CAC3B,OAAAA,EAAO,KACLH,EAAYI,EAAO,SAACC,EAAG,EAAC,CAAK,OAAAL,EAAUK,EAAG,EAAGF,CAAM,CAAtB,CAAuB,EAAIG,GACxDC,GAAK,CAAC,EACNL,EAAkBM,GAAeP,CAAa,EAAIQ,GAAa,UAAA,CAAM,OAAA,IAAIC,EAAJ,CAAgB,CAAC,CAHxF,CAKJ,CC/CM,SAAUC,GAAYC,EAAa,CACvC,OAAOA,GAAS,EACZ,UAAA,CAAM,OAAAC,CAAA,EACNC,EAAQ,SAACC,EAAQC,EAAU,CAKzB,IAAIC,EAAc,CAAA,EAClBF,EAAO,UACLG,EACEF,EACA,SAACG,EAAK,CAEJF,EAAO,KAAKE,CAAK,EAGjBP,EAAQK,EAAO,QAAUA,EAAO,MAAK,CACvC,EACA,UAAA,aAGE,QAAoBG,EAAAC,GAAAJ,CAAM,EAAAK,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAAvB,IAAMD,EAAKG,EAAA,MACdN,EAAW,KAAKG,CAAK,oGAEvBH,EAAW,SAAQ,CACrB,EAEA,OACA,UAAA,CAEEC,EAAS,IACX,CAAC,CACF,CAEL,CAAC,CACP,CC1DM,SAAUM,IAAK,SAAIC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACvB,IAAMC,EAAYC,GAAaH,CAAI,EAC7BI,EAAaC,GAAUL,EAAM,GAAQ,EAC3C,OAAAA,EAAOM,GAAeN,CAAI,EAEnBO,EAAQ,SAACC,EAAQC,EAAU,CAChCC,GAASN,CAAU,EAAEO,GAAIC,EAAA,CAAEJ,CAAM,EAAAK,EAAMb,CAA6B,CAAA,EAAGE,CAAS,CAAC,EAAE,UAAUO,CAAU,CACzG,CAAC,CACH,CCcM,SAAUK,IAAS,SACvBC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAEA,OAAOC,GAAK,MAAA,OAAAC,EAAA,CAAA,EAAAC,EAAIJ,CAAY,CAAA,CAAA,CAC9B,CCmEM,SAAUK,GAAUC,EAAqC,OACzDC,EAAQ,IACRC,EAEJ,OAAIF,GAAiB,OACf,OAAOA,GAAkB,UACxBG,EAA4BH,EAAa,MAAzCC,EAAKE,IAAA,OAAG,IAAQA,EAAED,EAAUF,EAAa,OAE5CC,EAAQD,GAILC,GAAS,EACZ,UAAA,CAAM,OAAAG,CAAA,EACNC,EAAQ,SAACC,EAAQC,EAAU,CACzB,IAAIC,EAAQ,EACRC,EAEEC,EAAc,UAAA,CAGlB,GAFAD,GAAS,MAATA,EAAW,YAAW,EACtBA,EAAY,KACRP,GAAS,KAAM,CACjB,IAAMS,EAAW,OAAOT,GAAU,SAAWU,GAAMV,CAAK,EAAIW,EAAUX,EAAMM,CAAK,CAAC,EAC5EM,EAAqBC,EAAyBR,EAAY,UAAA,CAC9DO,EAAmB,YAAW,EAC9BE,EAAiB,CACnB,CAAC,EACDL,EAAS,UAAUG,CAAkB,OAErCE,EAAiB,CAErB,EAEMA,EAAoB,UAAA,CACxB,IAAIC,EAAY,GAChBR,EAAYH,EAAO,UACjBS,EAAyBR,EAAY,OAAW,UAAA,CAC1C,EAAEC,EAAQP,EACRQ,EACFC,EAAW,EAEXO,EAAY,GAGdV,EAAW,SAAQ,CAEvB,CAAC,CAAC,EAGAU,GACFP,EAAW,CAEf,EAEAM,EAAiB,CACnB,CAAC,CACP,CCpFM,SAAUE,GAAcC,EAA6DC,EAAQ,CAMjG,OAAOC,EAAQC,GAAcH,EAAaC,EAAW,UAAU,QAAU,EAAG,EAAI,CAAC,CACnF,CC+CM,SAAUG,GAASC,EAA4B,CAA5BA,IAAA,SAAAA,EAAA,CAAA,GACf,IAAAC,EAAgHD,EAAO,UAAvHE,EAASD,IAAA,OAAG,UAAA,CAAM,OAAA,IAAIE,CAAJ,EAAgBF,EAAEG,EAA4EJ,EAAO,aAAnFK,EAAYD,IAAA,OAAG,GAAIA,EAAEE,EAAuDN,EAAO,gBAA9DO,EAAeD,IAAA,OAAG,GAAIA,EAAEE,EAA+BR,EAAO,oBAAtCS,EAAmBD,IAAA,OAAG,GAAIA,EAUnH,OAAO,SAACE,EAAa,CACnB,IAAIC,EACAC,EACAC,EACAC,EAAW,EACXC,EAAe,GACfC,EAAa,GAEXC,EAAc,UAAA,CAClBL,GAAe,MAAfA,EAAiB,YAAW,EAC5BA,EAAkB,MACpB,EAGMM,GAAQ,UAAA,CACZD,EAAW,EACXN,EAAaE,EAAU,OACvBE,EAAeC,EAAa,EAC9B,EACMG,EAAsB,UAAA,CAG1B,IAAMC,EAAOT,EACbO,GAAK,EACLE,GAAI,MAAJA,EAAM,YAAW,CACnB,EAEA,OAAOC,EAAc,SAACC,EAAQC,GAAU,CACtCT,IACI,CAACE,GAAc,CAACD,GAClBE,EAAW,EAOb,IAAMO,GAAQX,EAAUA,GAAO,KAAPA,EAAWX,EAAS,EAO5CqB,GAAW,IAAI,UAAA,CACbT,IAKIA,IAAa,GAAK,CAACE,GAAc,CAACD,IACpCH,EAAkBa,GAAYN,EAAqBV,CAAmB,EAE1E,CAAC,EAIDe,GAAK,UAAUD,EAAU,EAGvB,CAACZ,GAIDG,EAAW,IAOXH,EAAa,IAAIe,GAAe,CAC9B,KAAM,SAACC,GAAK,CAAK,OAAAH,GAAK,KAAKG,EAAK,CAAf,EACjB,MAAO,SAACC,GAAG,CACTZ,EAAa,GACbC,EAAW,EACXL,EAAkBa,GAAYP,GAAOb,EAAcuB,EAAG,EACtDJ,GAAK,MAAMI,EAAG,CAChB,EACA,SAAU,UAAA,CACRb,EAAe,GACfE,EAAW,EACXL,EAAkBa,GAAYP,GAAOX,CAAe,EACpDiB,GAAK,SAAQ,CACf,EACD,EACDK,EAAUP,CAAM,EAAE,UAAUX,CAAU,EAE1C,CAAC,EAAED,CAAa,CAClB,CACF,CAEA,SAASe,GACPP,EACAY,EAAoD,SACpDC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,EAAA,CAAA,EAAA,UAAAA,CAAA,EAEA,GAAIF,IAAO,GAAM,CACfZ,EAAK,EACL,OAGF,GAAIY,IAAO,GAIX,KAAMG,EAAe,IAAIP,GAAe,CACtC,KAAM,UAAA,CACJO,EAAa,YAAW,EACxBf,EAAK,CACP,EACD,EAED,OAAOW,EAAUC,EAAE,MAAA,OAAAI,EAAA,CAAA,EAAAC,EAAIJ,CAAI,CAAA,CAAA,CAAA,EAAG,UAAUE,CAAY,EACtD,CChHM,SAAUG,EACdC,EACAC,EACAC,EAAyB,WAErBC,EACAC,EAAW,GACf,OAAIJ,GAAsB,OAAOA,GAAuB,UACnDK,EAA8EL,EAAkB,WAAhGG,EAAUE,IAAA,OAAG,IAAQA,EAAEC,EAAuDN,EAAkB,WAAzEC,EAAUK,IAAA,OAAG,IAAQA,EAAEC,EAAgCP,EAAkB,SAAlDI,EAAQG,IAAA,OAAG,GAAKA,EAAEL,EAAcF,EAAkB,WAEnGG,EAAcH,GAAkB,KAAlBA,EAAsB,IAE/BQ,GAAS,CACd,UAAW,UAAA,CAAM,OAAA,IAAIC,GAAcN,EAAYF,EAAYC,CAAS,CAAnD,EACjB,aAAc,GACd,gBAAiB,GACjB,oBAAqBE,EACtB,CACH,CCxIM,SAAUM,GAAQC,EAAa,CACnC,OAAOC,EAAO,SAACC,EAAGC,EAAK,CAAK,OAAAH,GAASG,CAAT,CAAc,CAC5C,CCaM,SAAUC,GAAaC,EAA8B,CACzD,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAS,GAEPC,EAAiBC,EACrBH,EACA,UAAA,CACEE,GAAc,MAAdA,EAAgB,YAAW,EAC3BD,EAAS,EACX,EACAG,EAAI,EAGNC,EAAUR,CAAQ,EAAE,UAAUK,CAAc,EAE5CH,EAAO,UAAUI,EAAyBH,EAAY,SAACM,EAAK,CAAK,OAAAL,GAAUD,EAAW,KAAKM,CAAK,CAA/B,CAAgC,CAAC,CACpG,CAAC,CACH,CCVM,SAAUC,GAAS,SAAOC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAC9B,IAAMC,EAAYC,GAAaH,CAAM,EACrC,OAAOI,EAAQ,SAACC,EAAQC,EAAU,EAI/BJ,EAAYK,GAAOP,EAAQK,EAAQH,CAAS,EAAIK,GAAOP,EAAQK,CAAM,GAAG,UAAUC,CAAU,CAC/F,CAAC,CACH,CCmBM,SAAUE,EACdC,EACAC,EAA6G,CAE7G,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAyD,KACzDC,EAAQ,EAERC,EAAa,GAIXC,EAAgB,UAAA,CAAM,OAAAD,GAAc,CAACF,GAAmBD,EAAW,SAAQ,CAArD,EAE5BD,EAAO,UACLM,EACEL,EACA,SAACM,EAAK,CAEJL,GAAe,MAAfA,EAAiB,YAAW,EAC5B,IAAIM,EAAa,EACXC,EAAaN,IAEnBO,EAAUb,EAAQU,EAAOE,CAAU,CAAC,EAAE,UACnCP,EAAkBI,EACjBL,EAIA,SAACU,EAAU,CAAK,OAAAV,EAAW,KAAKH,EAAiBA,EAAeS,EAAOI,EAAYF,EAAYD,GAAY,EAAIG,CAAU,CAAzG,EAChB,UAAA,CAIET,EAAkB,KAClBG,EAAa,CACf,CAAC,CACD,CAEN,EACA,UAAA,CACED,EAAa,GACbC,EAAa,CACf,CAAC,CACF,CAEL,CAAC,CACH,CCvFM,SAAUO,EAAaC,EAA8B,CACzD,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChCC,EAAUJ,CAAQ,EAAE,UAAUK,EAAyBF,EAAY,UAAA,CAAM,OAAAA,EAAW,SAAQ,CAAnB,EAAuBG,EAAI,CAAC,EACrG,CAACH,EAAW,QAAUD,EAAO,UAAUC,CAAU,CACnD,CAAC,CACH,CCIM,SAAUI,GAAaC,EAAiDC,EAAiB,CAAjB,OAAAA,IAAA,SAAAA,EAAA,IACrEC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAQ,EACZF,EAAO,UACLG,EAAyBF,EAAY,SAACG,EAAK,CACzC,IAAMC,EAASR,EAAUO,EAAOF,GAAO,GACtCG,GAAUP,IAAcG,EAAW,KAAKG,CAAK,EAC9C,CAACC,GAAUJ,EAAW,SAAQ,CAChC,CAAC,CAAC,CAEN,CAAC,CACH,CCqGM,SAAUK,EACdC,EACAC,EACAC,EAA8B,CAK9B,IAAMC,EACJC,EAAWJ,CAAc,GAAKC,GAASC,EAElC,CAAE,KAAMF,EAA2E,MAAKC,EAAE,SAAQC,CAAA,EACnGF,EAEN,OAAOG,EACHE,EAAQ,SAACC,EAAQC,EAAU,QACzBC,EAAAL,EAAY,aAAS,MAAAK,IAAA,QAAAA,EAAA,KAArBL,CAAW,EACX,IAAIM,EAAU,GACdH,EAAO,UACLI,EACEH,EACA,SAACI,EAAK,QACJH,EAAAL,EAAY,QAAI,MAAAK,IAAA,QAAAA,EAAA,KAAhBL,EAAmBQ,CAAK,EACxBJ,EAAW,KAAKI,CAAK,CACvB,EACA,UAAA,OACEF,EAAU,IACVD,EAAAL,EAAY,YAAQ,MAAAK,IAAA,QAAAA,EAAA,KAApBL,CAAW,EACXI,EAAW,SAAQ,CACrB,EACA,SAACK,EAAG,OACFH,EAAU,IACVD,EAAAL,EAAY,SAAK,MAAAK,IAAA,QAAAA,EAAA,KAAjBL,EAAoBS,CAAG,EACvBL,EAAW,MAAMK,CAAG,CACtB,EACA,UAAA,SACMH,KACFD,EAAAL,EAAY,eAAW,MAAAK,IAAA,QAAAA,EAAA,KAAvBL,CAAW,IAEbU,EAAAV,EAAY,YAAQ,MAAAU,IAAA,QAAAA,EAAA,KAApBV,CAAW,CACb,CAAC,CACF,CAEL,CAAC,EAIDW,EACN,CCnIM,SAAUC,GAAYC,EAAsDC,EAAuB,CACvG,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAC1B,IAAAC,EAAuCJ,GAAM,KAANA,EAAU,CAAA,EAA/CK,EAAAD,EAAA,QAAAE,EAAOD,IAAA,OAAG,GAAIA,EAAEE,EAAAH,EAAA,SAAAI,EAAQD,IAAA,OAAG,GAAKA,EACpCE,EAAW,GACXC,EAAsB,KACtBC,EAAiC,KACjCC,EAAa,GAEXC,EAAgB,UAAA,CACpBF,GAAS,MAATA,EAAW,YAAW,EACtBA,EAAY,KACRH,IACFM,EAAI,EACJF,GAAcT,EAAW,SAAQ,EAErC,EAEMY,EAAoB,UAAA,CACxBJ,EAAY,KACZC,GAAcT,EAAW,SAAQ,CACnC,EAEMa,EAAgB,SAACC,GAAQ,CAC7B,OAACN,EAAYO,EAAUnB,EAAiBkB,EAAK,CAAC,EAAE,UAAUE,EAAyBhB,EAAYU,EAAeE,CAAiB,CAAC,CAAhI,EAEID,EAAO,UAAA,CACX,GAAIL,EAAU,CAIZA,EAAW,GACX,IAAMQ,GAAQP,EACdA,EAAY,KAEZP,EAAW,KAAKc,EAAK,EACrB,CAACL,GAAcI,EAAcC,EAAK,EAEtC,EAEAf,EAAO,UACLiB,EACEhB,EAMA,SAACc,GAAK,CACJR,EAAW,GACXC,EAAYO,GACZ,EAAEN,GAAa,CAACA,EAAU,UAAYL,EAAUQ,EAAI,EAAKE,EAAcC,EAAK,EAC9E,EACA,UAAA,CACEL,EAAa,GACb,EAAEJ,GAAYC,GAAYE,GAAa,CAACA,EAAU,SAAWR,EAAW,SAAQ,CAClF,CAAC,CACF,CAEL,CAAC,CACH,CCxFM,SAAUiB,GACdC,EACAC,EACAC,EAAuB,CADvBD,IAAA,SAAAA,EAAAE,IAGA,IAAMC,EAAYC,GAAML,EAAUC,CAAS,EAC3C,OAAOK,GAAS,UAAA,CAAM,OAAAF,CAAA,EAAWF,CAAM,CACzC,CCJM,SAAUK,IAAc,SAAOC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACnC,IAAMC,EAAUC,GAAkBH,CAAM,EAExC,OAAOI,EAAQ,SAACC,EAAQC,EAAU,CAehC,QAdMC,EAAMP,EAAO,OACbQ,EAAc,IAAI,MAAMD,CAAG,EAI7BE,EAAWT,EAAO,IAAI,UAAA,CAAM,MAAA,EAAA,CAAK,EAGjCU,EAAQ,cAMHC,EAAC,CACRC,EAAUZ,EAAOW,CAAC,CAAC,EAAE,UACnBE,EACEP,EACA,SAACQ,EAAK,CACJN,EAAYG,CAAC,EAAIG,EACb,CAACJ,GAAS,CAACD,EAASE,CAAC,IAEvBF,EAASE,CAAC,EAAI,IAKbD,EAAQD,EAAS,MAAMM,EAAQ,KAAON,EAAW,MAEtD,EAGAO,EAAI,CACL,GAnBIL,EAAI,EAAGA,EAAIJ,EAAKI,MAAhBA,CAAC,EAwBVN,EAAO,UACLQ,EAAyBP,EAAY,SAACQ,EAAK,CACzC,GAAIJ,EAAO,CAET,IAAMO,EAAMC,EAAA,CAAIJ,CAAK,EAAAK,EAAKX,CAAW,CAAA,EACrCF,EAAW,KAAKJ,EAAUA,EAAO,MAAA,OAAAgB,EAAA,CAAA,EAAAC,EAAIF,CAAM,CAAA,CAAA,EAAIA,CAAM,EAEzD,CAAC,CAAC,CAEN,CAAC,CACH,CCxFM,SAAUG,IAAG,SAAOC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACxB,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChCL,GAAS,MAAA,OAAAM,EAAA,CAACF,CAA8B,EAAAG,EAAMN,CAAuC,CAAA,CAAA,EAAE,UAAUI,CAAU,CAC7G,CAAC,CACH,CCCM,SAAUG,IAAO,SAAkCC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACvD,OAAOC,GAAG,MAAA,OAAAC,EAAA,CAAA,EAAAC,EAAIJ,CAAW,CAAA,CAAA,CAC3B,CCYO,SAASK,IAAmC,CACjD,IAAMC,EAAY,IAAIC,GAAwB,CAAC,EAC/C,OAAAC,EAAU,SAAU,mBAAoB,CAAE,KAAM,EAAK,CAAC,EACnD,UAAU,IAAMF,EAAU,KAAK,QAAQ,CAAC,EAGpCA,CACT,CCHO,SAASG,EACdC,EAAkBC,EAAmB,SAChC,CACL,OAAO,MAAM,KAAKA,EAAK,iBAAoBD,CAAQ,CAAC,CACtD,CAuBO,SAASE,EACdF,EAAkBC,EAAmB,SAClC,CACH,IAAME,EAAKC,GAAsBJ,EAAUC,CAAI,EAC/C,GAAI,OAAOE,GAAO,YAChB,MAAM,IAAI,eACR,8BAA8BH,CAAQ,iBACxC,EAGF,OAAOG,CACT,CAsBO,SAASC,GACdJ,EAAkBC,EAAmB,SACtB,CACf,OAAOA,EAAK,cAAiBD,CAAQ,GAAK,MAC5C,CAOO,SAASK,IAA4C,CAnH5D,IAAAC,EAAAC,EAAAC,EAAAC,EAoHE,OACEA,GAAAD,GAAAD,GAAAD,EAAA,SAAS,gBAAT,YAAAA,EAAwB,aAAxB,YAAAC,EAAoC,gBAApC,KAAAC,EACA,SAAS,gBADT,KAAAC,EAEA,MAEJ,CCvEA,IAAMC,GAAYC,EAChBC,EAAU,SAAS,KAAM,SAAS,EAClCA,EAAU,SAAS,KAAM,UAAU,CACrC,EACG,KACCC,GAAa,CAAC,EACdC,EAAU,MAAS,EACnBC,EAAI,IAAMC,GAAiB,GAAK,SAAS,IAAI,EAC7CC,EAAY,CAAC,CACf,EAaK,SAASC,GACdC,EACqB,CACrB,OAAOT,GACJ,KACCK,EAAIK,GAAUD,EAAG,SAASC,CAAM,CAAC,EACjCC,EAAqB,CACvB,CACJ,CCpCO,SAASC,GACdC,EAAiBC,EACI,CACrB,OAAOC,EACLC,EAAUH,EAAI,YAAY,EAAE,KAAKI,EAAI,IAAM,EAAI,CAAC,EAChDD,EAAUH,EAAI,YAAY,EAAE,KAAKI,EAAI,IAAM,EAAK,CAAC,CACnD,EACG,KACCH,EAAWI,GAAaJ,CAAQ,EAAIK,GACpCC,EAAU,EAAK,CACjB,CACJ,CCAO,SAASC,GACdC,EACe,CACf,MAAO,CACL,EAAGA,EAAG,WACN,EAAGA,EAAG,SACR,CACF,CAWO,SAASC,GACdD,EAC2B,CAC3B,OAAOE,EACLC,EAAU,OAAQ,MAAM,EACxBA,EAAU,OAAQ,QAAQ,CAC5B,EACG,KACCC,GAAU,EAAGC,EAAuB,EACpCC,EAAI,IAAMP,GAAiBC,CAAE,CAAC,EAC9BO,EAAUR,GAAiBC,CAAE,CAAC,CAChC,CACJ,CCxCO,SAASQ,GACdC,EACe,CACf,MAAO,CACL,EAAGA,EAAG,WACN,EAAGA,EAAG,SACR,CACF,CAWO,SAASC,GACdD,EAC2B,CAC3B,OAAOE,EACLC,EAAUH,EAAI,QAAQ,EACtBG,EAAU,OAAQ,QAAQ,CAC5B,EACG,KACCC,GAAU,EAAGC,EAAuB,EACpCC,EAAI,IAAMP,GAAwBC,CAAE,CAAC,EACrCO,EAAUR,GAAwBC,CAAE,CAAC,CACvC,CACJ,CCnBA,SAASQ,GAAYC,EAAiBC,EAA8B,CAGlE,GAAI,OAAOA,GAAU,UAAY,OAAOA,GAAU,SAChDD,EAAG,WAAaC,EAAM,SAAS,UAGtBA,aAAiB,KAC1BD,EAAG,YAAYC,CAAK,UAGX,MAAM,QAAQA,CAAK,EAC5B,QAAWC,KAAQD,EACjBF,GAAYC,EAAIE,CAAI,CAE1B,CAyBO,SAASC,EACdC,EAAaC,KAAmCC,EAC7C,CACH,IAAMN,EAAK,SAAS,cAAcI,CAAG,EAGrC,GAAIC,EACF,QAAWE,KAAQ,OAAO,KAAKF,CAAU,EACnC,OAAOA,EAAWE,CAAI,GAAM,cAI5B,OAAOF,EAAWE,CAAI,GAAM,UAC9BP,EAAG,aAAaO,EAAMF,EAAWE,CAAI,CAAC,EAEtCP,EAAG,aAAaO,EAAM,EAAE,GAI9B,QAAWN,KAASK,EAClBP,GAAYC,EAAIC,CAAK,EAGvB,OAAOD,CACT,CC9EO,SAASQ,GAAMC,EAAuB,CAC3C,GAAIA,EAAQ,IAAK,CACf,IAAMC,EAAS,GAAGD,EAAQ,KAAO,IAAO,IACxC,MAAO,KAAKA,EAAQ,MAAY,KAAM,QAAQC,CAAM,CAAC,GACvD,KACE,QAAOD,EAAM,SAAS,CAE1B,CCCO,SAASE,GAAYC,EAA+B,CACzD,IAAMC,EAASC,EAAE,SAAU,CAAE,IAAAF,CAAI,CAAC,EAClC,OAAOG,EAAM,KACX,SAAS,KAAK,YAAYF,CAAM,EACzBG,EACLC,EAAUJ,EAAQ,MAAM,EACxBI,EAAUJ,EAAQ,OAAO,EACtB,KACCK,EAAU,IACRC,GAAW,IAAM,IAAI,eAAe,mBAAmBP,CAAG,EAAE,CAAC,CAC9D,CACH,CACJ,EACG,KACCQ,EAAI,IAAG,EAAY,EACnBC,EAAS,IAAM,SAAS,KAAK,YAAYR,CAAM,CAAC,EAChDS,GAAK,CAAC,CACR,EACH,CACH,CCVA,IAAMC,GAAS,IAAIC,EAiBbC,GAAYC,EAAM,IACtB,OAAO,gBAAmB,YACtBC,GAAY,4CAA4C,EACxDC,EAAG,MAAS,CACjB,EACE,KACCC,EAAI,IAAM,IAAI,eAAeC,GAAW,CACtC,QAAWC,KAASD,EAClBP,GAAO,KAAKQ,CAAK,CACrB,CAAC,CAAC,EACFC,EAAUC,GAAYC,EAAMC,GAAOP,EAAGK,CAAQ,CAAC,EAC5C,KACCG,EAAS,IAAMH,EAAS,WAAW,CAAC,CACtC,CACF,EACAI,EAAY,CAAC,CACf,EAaK,SAASC,GACdC,EACa,CACb,MAAO,CACL,MAAQA,EAAG,YACX,OAAQA,EAAG,YACb,CACF,CAuBO,SAASC,GACdD,EACyB,CACzB,OAAOd,GACJ,KACCgB,EAAIR,GAAYA,EAAS,QAAQM,CAAE,CAAC,EACpCP,EAAUC,GAAYV,GACnB,KACCmB,EAAO,CAAC,CAAE,OAAAC,CAAO,IAAMA,IAAWJ,CAAE,EACpCH,EAAS,IAAMH,EAAS,UAAUM,CAAE,CAAC,EACrCV,EAAI,IAAMS,GAAeC,CAAE,CAAC,CAC9B,CACF,EACAK,EAAUN,GAAeC,CAAE,CAAC,CAC9B,CACJ,CCnHO,SAASM,GACdC,EACa,CACb,MAAO,CACL,MAAQA,EAAG,YACX,OAAQA,EAAG,YACb,CACF,CASO,SAASC,GACdD,EACyB,CACzB,IAAIE,EAASF,EAAG,cAChB,KAAOE,IAEHF,EAAG,aAAgBE,EAAO,aAC1BF,EAAG,cAAgBE,EAAO,eAE1BA,GAAUF,EAAKE,GAAQ,cAK3B,OAAOA,EAASF,EAAK,MACvB,CCfA,IAAMG,GAAS,IAAIC,EAUbC,GAAYC,EAAM,IAAMC,EAC5B,IAAI,qBAAqBC,GAAW,CAClC,QAAWC,KAASD,EAClBL,GAAO,KAAKM,CAAK,CACrB,EAAG,CACD,UAAW,CACb,CAAC,CACH,CAAC,EACE,KACCC,EAAUC,GAAYC,EAAMC,GAAON,EAAGI,CAAQ,CAAC,EAC5C,KACCG,EAAS,IAAMH,EAAS,WAAW,CAAC,CACtC,CACF,EACAI,EAAY,CAAC,CACf,EAaK,SAASC,GACdC,EACqB,CACrB,OAAOZ,GACJ,KACCa,EAAIP,GAAYA,EAAS,QAAQM,CAAE,CAAC,EACpCP,EAAUC,GAAYR,GACnB,KACCgB,EAAO,CAAC,CAAE,OAAAC,CAAO,IAAMA,IAAWH,CAAE,EACpCH,EAAS,IAAMH,EAAS,UAAUM,CAAE,CAAC,EACrCI,EAAI,CAAC,CAAE,eAAAC,CAAe,IAAMA,CAAc,CAC5C,CACF,CACF,CACJ,CAaO,SAASC,GACdN,EAAiBO,EAAY,GACR,CACrB,OAAOC,GAA0BR,CAAE,EAChC,KACCI,EAAI,CAAC,CAAE,EAAAK,CAAE,IAAM,CACb,IAAMC,EAAUC,GAAeX,CAAE,EAC3BY,EAAUC,GAAsBb,CAAE,EACxC,OAAOS,GACLG,EAAQ,OAASF,EAAQ,OAASH,CAEtC,CAAC,EACDO,EAAqB,CACvB,CACJ,CCjFA,IAAMC,GAA4C,CAChD,OAAQC,EAAW,yBAAyB,EAC5C,OAAQA,EAAW,yBAAyB,CAC9C,EAaO,SAASC,GAAUC,EAAuB,CAC/C,OAAOH,GAAQG,CAAI,EAAE,OACvB,CAaO,SAASC,GAAUD,EAAcE,EAAsB,CACxDL,GAAQG,CAAI,EAAE,UAAYE,GAC5BL,GAAQG,CAAI,EAAE,MAAM,CACxB,CAWO,SAASG,GAAYH,EAAmC,CAC7D,IAAMI,EAAKP,GAAQG,CAAI,EACvB,OAAOK,EAAUD,EAAI,QAAQ,EAC1B,KACCE,EAAI,IAAMF,EAAG,OAAO,EACpBG,EAAUH,EAAG,OAAO,CACtB,CACJ,CC9BA,SAASI,GACPC,EAAiBC,EACR,CACT,OAAQD,EAAG,YAAa,CAGtB,KAAK,iBAEH,OAAIA,EAAG,OAAS,QACP,SAAS,KAAKC,CAAI,EAElB,GAGX,KAAK,kBACL,KAAK,oBACH,MAAO,GAGT,QACE,OAAOD,EAAG,iBACd,CACF,CAWO,SAASE,IAAwC,CACtD,OAAOC,EACLC,EAAU,OAAQ,kBAAkB,EAAE,KAAKC,EAAI,IAAM,EAAI,CAAC,EAC1DD,EAAU,OAAQ,gBAAgB,EAAE,KAAKC,EAAI,IAAM,EAAK,CAAC,CAC3D,EACG,KACCC,EAAU,EAAK,CACjB,CACJ,CAOO,SAASC,IAAsC,CACpD,IAAMC,EAAYJ,EAAyB,OAAQ,SAAS,EACzD,KACCK,EAAOC,GAAM,EAAEA,EAAG,SAAWA,EAAG,QAAQ,EACxCL,EAAIK,IAAO,CACT,KAAMC,GAAU,QAAQ,EAAI,SAAW,SACvC,KAAMD,EAAG,IACT,OAAQ,CACNA,EAAG,eAAe,EAClBA,EAAG,gBAAgB,CACrB,CACF,EAAc,EACdD,EAAO,CAAC,CAAE,KAAAG,EAAM,KAAAX,CAAK,IAAM,CACzB,GAAIW,IAAS,SAAU,CACrB,IAAMC,EAASC,GAAiB,EAChC,GAAI,OAAOD,GAAW,YACpB,MAAO,CAACd,GAAwBc,EAAQZ,CAAI,CAChD,CACA,MAAO,EACT,CAAC,EACDc,GAAM,CACR,EAGF,OAAOb,GAAiB,EACrB,KACCc,EAAUH,GAAWA,EAAqBI,EAAZT,CAAiB,CACjD,CACJ,CC1GO,SAASU,IAAmB,CACjC,OAAO,IAAI,IAAI,SAAS,IAAI,CAC9B,CAgBO,SAASC,GACdC,EAA4BC,EAAW,GACjC,CACN,GAAIC,EAAQ,oBAAoB,GAAK,CAACD,EAAU,CAC9C,IAAME,EAAKC,EAAE,IAAK,CAAE,KAAMJ,EAAI,IAAK,CAAC,EACpC,SAAS,KAAK,YAAYG,CAAE,EAC5BA,EAAG,MAAM,EACTA,EAAG,OAAO,CAIZ,MACE,SAAS,KAAOH,EAAI,IAExB,CASO,SAASK,IAA8B,CAC5C,OAAO,IAAIC,CACb,CCxCO,SAASC,IAA0B,CACxC,OAAO,SAAS,KAAK,MAAM,CAAC,CAC9B,CAYO,SAASC,GAAgBC,EAAoB,CAClD,IAAMC,EAAKC,EAAE,IAAK,CAAE,KAAMF,CAAK,CAAC,EAChCC,EAAG,iBAAiB,QAASE,GAAMA,EAAG,gBAAgB,CAAC,EACvDF,EAAG,MAAM,CACX,CAWO,SAASG,GACdC,EACoB,CACpB,OAAOC,EACLC,EAA2B,OAAQ,YAAY,EAC/CF,CACF,EACG,KACCG,EAAIV,EAAe,EACnBW,EAAUX,GAAgB,CAAC,EAC3BY,EAAOV,GAAQA,EAAK,OAAS,CAAC,EAC9BW,EAAY,CAAC,CACf,CACJ,CASO,SAASC,GACdP,EACyB,CACzB,OAAOD,GAAkBC,CAAS,EAC/B,KACCG,EAAIK,GAAMC,GAAmB,QAAQD,CAAE,IAAI,CAAE,EAC7CH,EAAOT,GAAM,OAAOA,GAAO,WAAW,CACxC,CACJ,CCtDO,SAASc,GAAWC,EAAoC,CAC7D,IAAMC,EAAQ,WAAWD,CAAK,EAC9B,OAAOE,GAA0BC,GAC/BF,EAAM,YAAY,IAAME,EAAKF,EAAM,OAAO,CAAC,CAC5C,EACE,KACCG,EAAUH,EAAM,OAAO,CACzB,CACJ,CAOO,SAASI,IAAkC,CAChD,IAAMJ,EAAQ,WAAW,OAAO,EAChC,OAAOK,EACLC,EAAU,OAAQ,aAAa,EAAE,KAAKC,EAAI,IAAM,EAAI,CAAC,EACrDD,EAAU,OAAQ,YAAY,EAAE,KAAKC,EAAI,IAAM,EAAK,CAAC,CACvD,EACG,KACCJ,EAAUH,EAAM,OAAO,CACzB,CACJ,CAcO,SAASQ,GACdC,EAA6BC,EACd,CACf,OAAOD,EACJ,KACCE,EAAUC,GAAUA,EAASF,EAAQ,EAAIG,CAAK,CAChD,CACJ,CC/BO,SAASC,GACdC,EAAmBC,EACD,CAClB,OAAO,IAAIC,EAAiBC,GAAY,CACtC,IAAMC,EAAM,IAAI,eAChB,OAAAA,EAAI,KAAK,MAAO,GAAGJ,CAAG,EAAE,EACxBI,EAAI,aAAe,OAGnBA,EAAI,iBAAiB,OAAQ,IAAM,CAC7BA,EAAI,QAAU,KAAOA,EAAI,OAAS,KACpCD,EAAS,KAAKC,EAAI,QAAQ,EAC1BD,EAAS,SAAS,GAIlBA,EAAS,MAAM,IAAI,MAAMC,EAAI,UAAU,CAAC,CAE5C,CAAC,EAGDA,EAAI,iBAAiB,QAAS,IAAM,CAClCD,EAAS,MAAM,IAAI,MAAM,eAAe,CAAC,CAC3C,CAAC,EAGDC,EAAI,iBAAiB,QAAS,IAAM,CAClCD,EAAS,SAAS,CACpB,CAAC,EAGG,OAAOF,GAAA,YAAAA,EAAS,YAAc,cAChCG,EAAI,iBAAiB,WAAYC,GAAS,CA/FhD,IAAAC,EAgGQ,GAAID,EAAM,iBACRJ,EAAQ,UAAW,KAAMI,EAAM,OAASA,EAAM,MAAS,GAAG,MAIrD,CACL,IAAME,GAASD,EAAAF,EAAI,kBAAkB,gBAAgB,IAAtC,KAAAE,EAA2C,EAC1DL,EAAQ,UAAW,KAAMI,EAAM,OAAS,CAACE,EAAU,GAAG,CACxD,CACF,CAAC,EAGDN,EAAQ,UAAU,KAAK,CAAC,GAI1BG,EAAI,KAAK,EACF,IAAMA,EAAI,MAAM,CACzB,CAAC,CACH,CAcO,SAASI,GACdR,EAAmBC,EACJ,CACf,OAAOF,GAAQC,EAAKC,CAAO,EACxB,KACCQ,EAAUC,GAAOA,EAAI,KAAK,CAAC,EAC3BC,EAAIC,GAAQ,KAAK,MAAMA,CAAI,CAAM,EACjCC,EAAY,CAAC,CACf,CACJ,CAUO,SAASC,GACdd,EAAmBC,EACG,CACtB,IAAMc,EAAM,IAAI,UAChB,OAAOhB,GAAQC,EAAKC,CAAO,EACxB,KACCQ,EAAUC,GAAOA,EAAI,KAAK,CAAC,EAC3BC,EAAID,GAAOK,EAAI,gBAAgBL,EAAK,WAAW,CAAC,EAChDG,EAAY,CAAC,CACf,CACJ,CAUO,SAASG,GACdhB,EAAmBC,EACG,CACtB,IAAMc,EAAM,IAAI,UAChB,OAAOhB,GAAQC,EAAKC,CAAO,EACxB,KACCQ,EAAUC,GAAOA,EAAI,KAAK,CAAC,EAC3BC,EAAID,GAAOK,EAAI,gBAAgBL,EAAK,UAAU,CAAC,EAC/CG,EAAY,CAAC,CACf,CACJ,CC5HO,SAASI,IAAoC,CAClD,MAAO,CACL,EAAG,KAAK,IAAI,EAAG,OAAO,EACtB,EAAG,KAAK,IAAI,EAAG,OAAO,CACxB,CACF,CASO,SAASC,IAAkD,CAChE,OAAOC,EACLC,EAAU,OAAQ,SAAU,CAAE,QAAS,EAAK,CAAC,EAC7CA,EAAU,OAAQ,SAAU,CAAE,QAAS,EAAK,CAAC,CAC/C,EACG,KACCC,EAAIJ,EAAiB,EACrBK,EAAUL,GAAkB,CAAC,CAC/B,CACJ,CC3BO,SAASM,IAAgC,CAC9C,MAAO,CACL,MAAQ,WACR,OAAQ,WACV,CACF,CASO,SAASC,IAA8C,CAC5D,OAAOC,EAAU,OAAQ,SAAU,CAAE,QAAS,EAAK,CAAC,EACjD,KACCC,EAAIH,EAAe,EACnBI,EAAUJ,GAAgB,CAAC,CAC7B,CACJ,CCXO,SAASK,IAAsC,CACpD,OAAOC,EAAc,CACnBC,GAAoB,EACpBC,GAAkB,CACpB,CAAC,EACE,KACCC,EAAI,CAAC,CAACC,EAAQC,CAAI,KAAO,CAAE,OAAAD,EAAQ,KAAAC,CAAK,EAAE,EAC1CC,EAAY,CAAC,CACf,CACJ,CCVO,SAASC,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EAChB,CACtB,IAAMC,EAAQF,EACX,KACCG,EAAwB,MAAM,CAChC,EAGIC,EAAUC,EAAc,CAACH,EAAOD,CAAO,CAAC,EAC3C,KACCK,EAAI,IAAMC,GAAiBR,CAAE,CAAC,CAChC,EAGF,OAAOM,EAAc,CAACJ,EAASD,EAAWI,CAAO,CAAC,EAC/C,KACCE,EAAI,CAAC,CAAC,CAAE,OAAAE,CAAO,EAAG,CAAE,OAAAC,EAAQ,KAAAC,CAAK,EAAG,CAAE,EAAAC,EAAG,EAAAC,CAAE,CAAC,KAAO,CACjD,OAAQ,CACN,EAAGH,EAAO,EAAIE,EACd,EAAGF,EAAO,EAAIG,EAAIJ,CACpB,EACA,KAAAE,CACF,EAAE,CACJ,CACJ,CCzBA,SAASG,GAAQC,EAA+B,CAC9C,OAAOC,EAA8BD,EAAQ,UAAWE,GAAMA,EAAG,IAAI,CACvE,CAWA,SAASC,GAAQH,EAA4B,CAC3C,IAAMI,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAUE,GAAQN,EAAO,YAAYM,CAAI,CAAC,EAGzCF,CACT,CAgBO,SAASG,GACdC,EAAaR,EAAS,IAAI,OAAOQ,CAAG,EACxB,CACZ,IAAMC,EAAQV,GAAQC,CAAM,EACtBI,EAAQD,GAAQH,CAAM,EAGtBU,EAAU,IAAIL,EACpBK,EAAQ,UAAUN,CAAK,EAGvB,IAAMO,EAAQP,EAAM,KAAKQ,GAAe,EAAGC,GAAQ,EAAI,CAAC,EACxD,OAAOH,EACJ,KACCE,GAAe,EACfE,GAAUL,EAAM,KAAKM,EAAUJ,CAAK,CAAC,CAAC,EACtCK,GAAM,CACR,CACJ,CCLA,IAAMC,GAASC,EAAW,WAAW,EAC/BC,GAAiB,KAAK,MAAMF,GAAO,WAAY,EACrDE,GAAO,KAAO,GAAG,IAAI,IAAIA,GAAO,KAAMC,GAAY,CAAC,CAAC,GAW7C,SAASC,IAAwB,CACtC,OAAOF,EACT,CASO,SAASG,EAAQC,EAAqB,CAC3C,OAAOJ,GAAO,SAAS,SAASI,CAAI,CACtC,CAUO,SAASC,GACdC,EAAkBC,EACV,CACR,OAAO,OAAOA,GAAU,YACpBP,GAAO,aAAaM,CAAG,EAAE,QAAQ,IAAKC,EAAM,SAAS,CAAC,EACtDP,GAAO,aAAaM,CAAG,CAC7B,CC/BO,SAASE,GACdC,EAASC,EAAmB,SACP,CACrB,OAAOC,EAAW,sBAAsBF,CAAI,IAAKC,CAAI,CACvD,CAYO,SAASE,GACdH,EAASC,EAAmB,SACL,CACvB,OAAOG,EAAY,sBAAsBJ,CAAI,IAAKC,CAAI,CACxD,CC7EO,SAASI,GACdC,EACsB,CACtB,IAAMC,EAASC,EAAW,6BAA8BF,CAAE,EAC1D,OAAOG,EAAUF,EAAQ,QAAS,CAAE,KAAM,EAAK,CAAC,EAC7C,KACCG,EAAI,IAAMF,EAAW,cAAeF,CAAE,CAAC,EACvCI,EAAIC,IAAY,CAAE,KAAM,UAAUA,EAAQ,SAAS,CAAE,EAAE,CACzD,CACJ,CASO,SAASC,GACdN,EACiC,CACjC,GAAI,CAACO,EAAQ,kBAAkB,GAAK,CAACP,EAAG,kBACtC,OAAOQ,EAGT,GAAI,CAACR,EAAG,OAAQ,CACd,IAAMK,EAAUH,EAAW,cAAeF,CAAE,EACxC,UAAUK,EAAQ,SAAS,IAAM,SAAS,YAAY,IACxDL,EAAG,OAAS,GAChB,CAGA,OAAOS,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,KAAAE,CAAK,IAAM,CAC5BZ,EAAG,OAAS,GAGZ,SAAiB,aAAcY,CAAI,CACrC,CAAC,EAGMb,GAAcC,CAAE,EACpB,KACCa,EAAIC,GAASJ,EAAM,KAAKI,CAAK,CAAC,EAC9BC,EAAS,IAAML,EAAM,SAAS,CAAC,EAC/BN,EAAIU,GAAUE,EAAA,CAAE,IAAKhB,GAAOc,EAAQ,CACtC,CACJ,CAAC,CACH,CC5BO,SAASG,GACdC,EAAiB,CAAE,QAAAC,CAAQ,EACN,CACrB,OAAOA,EACJ,KACCC,EAAIC,IAAW,CAAE,OAAQA,IAAWH,CAAG,EAAE,CAC3C,CACJ,CAYO,SAASI,GACdJ,EAAiBK,EACe,CAChC,IAAMC,EAAY,IAAIC,EACtB,OAAAD,EAAU,UAAU,CAAC,CAAE,OAAAE,CAAO,IAAM,CAClCR,EAAG,OAASQ,CACd,CAAC,EAGMT,GAAaC,EAAIK,CAAO,EAC5B,KACCI,EAAIC,GAASJ,EAAU,KAAKI,CAAK,CAAC,EAClCC,EAAS,IAAML,EAAU,SAAS,CAAC,EACnCJ,EAAIQ,GAAUE,EAAA,CAAE,IAAKZ,GAAOU,EAAQ,CACtC,CACJ,CCrEO,SAASG,GACdC,EAAaC,EACA,CACb,OAAIA,IAAU,SAEVC,EAAC,OAAI,MAAM,gCAAgC,GAAIF,EAAI,KAAK,WACtDE,EAAC,OAAI,MAAM,+BAA+B,CAC5C,EAIAA,EAAC,OAAI,MAAM,aAAa,GAAIF,EAAI,KAAK,WACnCE,EAAC,OAAI,MAAM,+BAA+B,CAC5C,CAGN,CCxBO,SAASC,GACdC,EAAqBC,EACR,CAIb,GAHAA,EAASA,EAAS,GAAGA,CAAM,eAAeD,CAAE,GAAK,OAG7CC,EAAQ,CACV,IAAMC,EAASD,EAAS,IAAIA,CAAM,GAAK,OACvC,OACEE,EAAC,SAAM,MAAM,gBAAgB,SAAU,GACpCC,GAAcH,CAAM,EACrBE,EAAC,KAAE,KAAMD,EAAQ,MAAM,uBAAuB,SAAU,IACtDC,EAAC,QAAK,wBAAuBH,EAAI,CACnC,CACF,CAEJ,KACE,QACEG,EAAC,SAAM,MAAM,gBAAgB,SAAU,GACpCC,GAAcH,CAAM,EACrBE,EAAC,QAAK,MAAM,uBAAuB,SAAU,IAC3CA,EAAC,QAAK,wBAAuBH,EAAI,CACnC,CACF,CAGN,CC5BO,SAASK,GAAsBC,EAAyB,CAC7D,OACEC,EAAC,UACC,MAAM,uBACN,MAAOC,GAAY,gBAAgB,EACnC,wBAAuB,IAAIF,CAAE,UAC9B,CAEL,CCQA,SAASG,GACPC,EAAsBC,EACT,CACb,IAAMC,EAASD,EAAO,EAChBE,EAASF,EAAO,EAGhBG,EAAU,OAAO,KAAKJ,EAAS,KAAK,EACvC,OAAOK,GAAO,CAACL,EAAS,MAAMK,CAAG,CAAC,EAClC,OAAyB,CAACC,EAAMD,IAAQ,CACvC,GAAGC,EAAMC,EAAC,WAAKF,CAAI,EAAQ,GAC7B,EAAG,CAAC,CAAC,EACJ,MAAM,EAAG,EAAE,EAGRG,EAASC,GAAc,EACvBC,EAAM,IAAI,IAAIV,EAAS,SAAUQ,EAAO,IAAI,EAC9CG,EAAQ,kBAAkB,GAC5BD,EAAI,aAAa,IAAI,IAAK,OAAO,QAAQV,EAAS,KAAK,EACpD,OAAO,CAAC,CAAC,CAAEY,CAAK,IAAMA,CAAK,EAC3B,OAAO,CAACC,EAAW,CAACC,CAAK,IAAM,GAAGD,CAAS,IAAIC,CAAK,GAAG,KAAK,EAAG,EAAE,CACpE,EAGF,GAAM,CAAE,KAAAC,CAAK,EAAIN,GAAc,EAC/B,OACEF,EAAC,KAAE,KAAM,GAAGG,CAAG,GAAI,MAAM,yBAAyB,SAAU,IAC1DH,EAAC,WACC,MAAM,uCACN,gBAAeP,EAAS,MAAM,QAAQ,CAAC,GAEtCE,EAAS,GAAKK,EAAC,OAAI,MAAM,iCAAiC,EAC1DL,EAAS,GAAKK,EAAC,UAAIP,EAAS,KAAM,EAClCE,GAAU,GAAKK,EAAC,UAAIP,EAAS,KAAM,EACnCG,EAAS,GAAKH,EAAS,KAAK,OAAS,GACpCA,EAAS,KAEVA,EAAS,MAAQA,EAAS,KAAK,IAAIgB,GAAO,CACzC,IAAMC,EAAOF,EACTC,KAAOD,EACL,uBAAuBA,EAAKC,CAAG,CAAC,GAChC,cACF,GACJ,OACET,EAAC,QAAK,MAAO,UAAUU,CAAI,IAAKD,CAAI,CAExC,CAAC,EACAb,EAAS,GAAKC,EAAQ,OAAS,GAC9BG,EAAC,KAAE,MAAM,2BACNW,GAAY,4BAA4B,EAAE,KAAG,GAAGd,CACnD,CAEJ,CACF,CAEJ,CAaO,SAASe,GACdC,EACa,CACb,IAAMC,EAAYD,EAAO,CAAC,EAAE,MACtBE,EAAO,CAAC,GAAGF,CAAM,EAEjBZ,EAASC,GAAc,EAGvBP,EAASoB,EAAK,UAAUC,GAErB,CADG,GAAG,IAAI,IAAIA,EAAI,SAAUf,EAAO,IAAI,CAAC,GACrC,SAAS,GAAG,CACvB,EACK,CAACgB,CAAO,EAAIF,EAAK,OAAOpB,EAAQ,CAAC,EAGnCuB,EAAQH,EAAK,UAAUC,GAAOA,EAAI,MAAQF,CAAS,EACnDI,IAAU,KACZA,EAAQH,EAAK,QAGf,IAAMI,EAAOJ,EAAK,MAAM,EAAGG,CAAK,EAC1BE,EAAOL,EAAK,MAAMG,CAAK,EAGvBG,EAAW,CACf7B,GAAqByB,EAAS,EAAc,EAAE,CAACtB,GAAUuB,IAAU,EAAE,EACrE,GAAGC,EAAK,IAAIG,GAAW9B,GAAqB8B,EAAS,CAAW,CAAC,EACjE,GAAGF,EAAK,OAAS,CACfpB,EAAC,WAAQ,MAAM,0BACbA,EAAC,WAAQ,SAAU,IACjBA,EAAC,WACEoB,EAAK,OAAS,GAAKA,EAAK,SAAW,EAChCT,GAAY,wBAAwB,EACpCA,GAAY,2BAA4BS,EAAK,MAAM,CAEzD,CACF,EACC,GAAGA,EAAK,IAAIE,GAAW9B,GAAqB8B,EAAS,CAAW,CAAC,CACpE,CACF,EAAI,CAAC,CACP,EAGA,OACEtB,EAAC,MAAG,MAAM,0BACPqB,CACH,CAEJ,CCrIO,SAASE,GAAkBC,EAAiC,CACjE,OACEC,EAAC,MAAG,MAAM,oBACP,OAAO,QAAQD,CAAK,EAAE,IAAI,CAAC,CAACE,EAAKC,CAAK,IACrCF,EAAC,MAAG,MAAO,oCAAoCC,CAAG,IAC/C,OAAOC,GAAU,SAAWC,GAAMD,CAAK,EAAIA,CAC9C,CACD,CACH,CAEJ,CCAO,SAASE,GACdC,EACa,CACb,IAAMC,EAAU,kCAAkCD,CAAI,GACtD,OACEE,EAAC,OAAI,MAAOD,EAAS,OAAM,IACzBC,EAAC,UAAO,MAAM,gBAAgB,SAAU,GAAI,cAAY,OAAO,CACjE,CAEJ,CCpBO,SAASC,GAAYC,EAAiC,CAC3D,OACEC,EAAC,OAAI,MAAM,0BACTA,EAAC,OAAI,MAAM,qBACRD,CACH,CACF,CAEJ,CCcA,SAASE,GAAcC,EAA+B,CACpD,IAAMC,EAASC,GAAc,EAGvBC,EAAM,IAAI,IAAI,MAAMH,EAAQ,OAAO,IAAKC,EAAO,IAAI,EACzD,OACEG,EAAC,MAAG,MAAM,oBACRA,EAAC,KAAE,KAAM,GAAGD,CAAG,GAAI,MAAM,oBACtBH,EAAQ,KACX,CACF,CAEJ,CAcO,SAASK,GACdC,EAAqBC,EACR,CACb,OAAAD,EAAWA,EAAS,OAAON,GAAQ,CAtFrC,IAAAQ,EAsFwC,SAACA,EAAAR,EAAQ,aAAR,MAAAQ,EAAoB,QAAM,EAE/DJ,EAAC,OAAI,MAAM,cACTA,EAAC,UACC,MAAM,sBACN,aAAYK,GAAY,gBAAgB,GAEvCF,EAAO,KACV,EACAH,EAAC,MAAG,MAAM,oBACPE,EAAS,IAAIP,EAAa,CAC7B,CACF,CAEJ,CCxBA,IAAIW,GAAW,EAiBR,SAASC,GACdC,EAAiBC,EACI,CACrB,SAAS,KAAK,OAAOD,CAAE,EAGvB,GAAM,CAAE,MAAAE,CAAM,EAAIC,GAAeH,CAAE,EACnCA,EAAG,MAAM,YAAY,qBAAsB,GAAGE,CAAK,IAAI,EACvDF,EAAG,OAAO,EAGV,IAAMI,EAAYC,GAAoBJ,CAAI,EACpCK,EACJ,OAAOF,GAAc,YACjBG,GAA0BH,CAAS,EACnCI,EAAG,CAAE,EAAG,EAAG,EAAG,CAAE,CAAC,EAGjBC,EAAUC,EACdC,GAAkBV,CAAI,EACtBW,GAAkBX,CAAI,CACxB,EACG,KACCY,EAAqB,CACvB,EAGF,OAAOC,EAAc,CAACL,EAASH,CAAO,CAAC,EACpC,KACCS,EAAI,CAAC,CAACC,EAAQC,CAAM,IAAM,CACxB,GAAI,CAAE,EAAAC,EAAG,EAAAC,CAAE,EAAIC,GAAiBnB,CAAI,EAC9BoB,EAAOlB,GAAeF,CAAI,EAU1BqB,EAAQrB,EAAK,QAAQ,OAAO,EAClC,OAAIqB,GAASrB,EAAK,gBAChBiB,GAAKI,EAAM,WAAarB,EAAK,cAAc,WAC3CkB,GAAKG,EAAM,UAAarB,EAAK,cAAc,WAEtC,CACL,OAAAe,EACA,OAAQ,CACN,EAAGE,EAAID,EAAO,EAAII,EAAK,MAAS,EAAInB,EAAQ,EAC5C,EAAGiB,EAAIF,EAAO,EAAII,EAAK,OAAS,CAClC,CACF,CACF,CAAC,CACH,CACJ,CASO,SAASE,GACdvB,EACgC,CAChC,IAAMwB,EAAQxB,EAAG,MACjB,GAAI,CAACwB,EAAM,OACT,OAAOC,EAGT,IAAMC,EAAK,aAAa5B,IAAU,GAC5B6B,EAAUC,GAAcF,EAAI,QAAQ,EACpCG,EAAUC,EAAW,cAAeH,CAAO,EACjD,OAAAE,EAAQ,UAAYL,EAGbO,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAE,CAAO,EAAG,CACfP,EAAQ,MAAM,YAAY,iBAAkB,GAAGO,EAAO,CAAC,IAAI,EAC3DP,EAAQ,MAAM,YAAY,iBAAkB,GAAGO,EAAO,CAAC,IAAI,CAC7D,EAGA,UAAW,CACTP,EAAQ,MAAM,eAAe,gBAAgB,EAC7CA,EAAQ,MAAM,eAAe,gBAAgB,CAC/C,CACF,CAAC,EAGDjB,EACEsB,EAAM,KAAKG,EAAO,CAAC,CAAE,OAAAnB,CAAO,IAAMA,CAAM,CAAC,EACzCgB,EAAM,KAAKI,GAAa,GAAG,EAAGD,EAAO,CAAC,CAAE,OAAAnB,CAAO,IAAM,CAACA,CAAM,CAAC,CAC/D,EACG,UAAU,CAGT,KAAK,CAAE,OAAAA,CAAO,EAAG,CACXA,GACFhB,EAAG,sBAAsB,WAAY2B,CAAO,EAC5C3B,EAAG,aAAa,mBAAoB0B,CAAE,EACtC1B,EAAG,gBAAgB,OAAO,IAE1B2B,EAAQ,OAAO,EACf3B,EAAG,gBAAgB,kBAAkB,EACrCA,EAAG,aAAa,QAASwB,CAAK,EAElC,EAGA,UAAW,CACTG,EAAQ,OAAO,EACf3B,EAAG,gBAAgB,kBAAkB,EACrCA,EAAG,aAAa,QAASwB,CAAK,CAChC,CACF,CAAC,EAGHQ,EACG,KACCK,GAAU,GAAIC,EAAuB,CACvC,EACG,UAAU,CAAC,CAAE,OAAAtB,CAAO,IAAM,CACzBW,EAAQ,UAAU,OAAO,qBAAsBX,CAAM,CACvD,CAAC,EAMLgB,EACG,KACCO,GAAa,IAAKD,EAAuB,EACzCH,EAAO,IAAM,CAAC,CAACnC,EAAG,YAAY,EAC9Be,EAAI,IAAMf,EAAG,aAAc,sBAAsB,CAAC,EAClDe,EAAI,CAAC,CAAE,EAAAG,CAAE,IAAMA,CAAC,CAClB,EACC,UAAU,CAGT,KAAKsB,EAAQ,CACPA,EACFb,EAAQ,MAAM,YAAY,iBAAkB,GAAG,CAACa,CAAM,IAAI,EAE1Db,EAAQ,MAAM,eAAe,gBAAgB,CACjD,EAGA,UAAW,CACTA,EAAQ,MAAM,eAAe,gBAAgB,CAC/C,CACF,CAAC,EAGI5B,GAAa4B,EAAS3B,CAAE,EAC5B,KACCyC,EAAIC,GAASV,EAAM,KAAKU,CAAK,CAAC,EAC9BC,EAAS,IAAMX,EAAM,SAAS,CAAC,EAC/BjB,EAAI2B,GAAUE,EAAA,CAAE,IAAK5C,GAAO0C,EAAQ,CACtC,CACJ,CAAC,EACE,KACCG,GAAYC,EAAc,CAC5B,CACJ,CC1KO,SAASC,GACdC,EAAiBC,EACO,CACxB,IAAMC,EAAUC,EAAM,IAAMC,EAAc,CACxCC,GAAmBL,CAAE,EACrBM,GAA0BL,CAAS,CACrC,CAAC,CAAC,EACC,KACCM,EAAI,CAAC,CAAC,CAAE,EAAAC,EAAG,EAAAC,CAAE,EAAGC,CAAM,IAAqB,CACzC,GAAM,CAAE,MAAAC,EAAO,OAAAC,CAAO,EAAIC,GAAeb,CAAE,EAC3C,MAAQ,CACN,EAAGQ,EAAIE,EAAO,EAAIC,EAAS,EAC3B,EAAGF,EAAIC,EAAO,EAAIE,EAAS,CAC7B,CACF,CAAC,CACH,EAGF,OAAOE,GAAkBd,CAAE,EACxB,KACCe,EAAUC,GAAUd,EACjB,KACCK,EAAIU,IAAW,CAAE,OAAAD,EAAQ,OAAAC,CAAO,EAAE,EAClCC,GAAK,CAAC,CAACF,GAAU,GAAQ,CAC3B,CACF,CACF,CACJ,CAWO,SAASG,GACdnB,EAAiBC,EAAwB,CAAE,QAAAmB,CAAQ,EAChB,CACnC,GAAM,CAACC,EAASC,CAAK,EAAI,MAAM,KAAKtB,EAAG,QAAQ,EAG/C,OAAOG,EAAM,IAAM,CACjB,IAAMoB,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGC,GAAQ,EAAI,CAAC,EACxD,OAAAJ,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAN,CAAO,EAAG,CACfjB,EAAG,MAAM,YAAY,iBAAkB,GAAGiB,EAAO,CAAC,IAAI,EACtDjB,EAAG,MAAM,YAAY,iBAAkB,GAAGiB,EAAO,CAAC,IAAI,CACxD,EAGA,UAAW,CACTjB,EAAG,MAAM,eAAe,gBAAgB,EACxCA,EAAG,MAAM,eAAe,gBAAgB,CAC1C,CACF,CAAC,EAGD4B,GAAuB5B,CAAE,EACtB,KACC6B,EAAUJ,CAAK,CACjB,EACG,UAAUK,GAAW,CACpB9B,EAAG,gBAAgB,kBAAmB8B,CAAO,CAC/C,CAAC,EAGLC,EACER,EAAM,KAAKS,EAAO,CAAC,CAAE,OAAAhB,CAAO,IAAMA,CAAM,CAAC,EACzCO,EAAM,KAAKU,GAAa,GAAG,EAAGD,EAAO,CAAC,CAAE,OAAAhB,CAAO,IAAM,CAACA,CAAM,CAAC,CAC/D,EACG,UAAU,CAGT,KAAK,CAAE,OAAAA,CAAO,EAAG,CACXA,EACFhB,EAAG,QAAQqB,CAAO,EAElBA,EAAQ,OAAO,CACnB,EAGA,UAAW,CACTrB,EAAG,QAAQqB,CAAO,CACpB,CACF,CAAC,EAGHE,EACG,KACCW,GAAU,GAAIC,EAAuB,CACvC,EACG,UAAU,CAAC,CAAE,OAAAnB,CAAO,IAAM,CACzBK,EAAQ,UAAU,OAAO,qBAAsBL,CAAM,CACvD,CAAC,EAGLO,EACG,KACCa,GAAa,IAAKD,EAAuB,EACzCH,EAAO,IAAM,CAAC,CAAChC,EAAG,YAAY,EAC9BO,EAAI,IAAMP,EAAG,aAAc,sBAAsB,CAAC,EAClDO,EAAI,CAAC,CAAE,EAAAC,CAAE,IAAMA,CAAC,CAClB,EACG,UAAU,CAGT,KAAK6B,EAAQ,CACPA,EACFrC,EAAG,MAAM,YAAY,iBAAkB,GAAG,CAACqC,CAAM,IAAI,EAErDrC,EAAG,MAAM,eAAe,gBAAgB,CAC5C,EAGA,UAAW,CACTA,EAAG,MAAM,eAAe,gBAAgB,CAC1C,CACF,CAAC,EAGLsC,EAAsBhB,EAAO,OAAO,EACjC,KACCO,EAAUJ,CAAK,EACfO,EAAOO,GAAM,EAAEA,EAAG,SAAWA,EAAG,QAAQ,CAC1C,EACG,UAAUA,GAAM,CACfA,EAAG,gBAAgB,EACnBA,EAAG,eAAe,CACpB,CAAC,EAGLD,EAAsBhB,EAAO,WAAW,EACrC,KACCO,EAAUJ,CAAK,EACfe,GAAejB,CAAK,CACtB,EACG,UAAU,CAAC,CAACgB,EAAI,CAAE,OAAAvB,CAAO,CAAC,IAAM,CA3OzC,IAAAyB,EA8OU,GAAIF,EAAG,SAAW,GAAKA,EAAG,SAAWA,EAAG,QACtCA,EAAG,eAAe,UAGTvB,EAAQ,CACjBuB,EAAG,eAAe,EAGlB,IAAMG,EAAS1C,EAAG,cAAe,QAAQ,gBAAgB,EACrD0C,aAAkB,YACpBA,EAAO,MAAM,GAEbD,EAAAE,GAAiB,IAAjB,MAAAF,EAAoB,MACxB,CACF,CAAC,EAGLrB,EACG,KACCS,EAAUJ,CAAK,EACfO,EAAOY,GAAUA,IAAWvB,CAAO,EACnCwB,GAAM,GAAG,CACX,EACG,UAAU,IAAM7C,EAAG,MAAM,CAAC,EAGxBD,GAAgBC,EAAIC,CAAS,EACjC,KACC6C,EAAIC,GAASxB,EAAM,KAAKwB,CAAK,CAAC,EAC9BC,EAAS,IAAMzB,EAAM,SAAS,CAAC,EAC/BhB,EAAIwC,GAAUE,EAAA,CAAE,IAAKjD,GAAO+C,EAAQ,CACtC,CACJ,CAAC,CACH,CCxMA,SAASG,GAAUC,EAAuC,CACxD,OAAOA,EAAU,UAAY,OACzBC,EAAY,eAAgBD,CAAS,EACrC,CAACA,CAAS,CAChB,CASA,SAASE,GAAYF,EAAgC,CACnD,IAAMG,EAAkB,CAAC,EACzB,QAAWC,KAAML,GAAUC,CAAS,EAAG,CACrC,IAAMK,EAAgB,CAAC,EAGjBC,EAAK,SAAS,mBAAmBF,EAAI,WAAW,SAAS,EAC/D,QAASG,EAAOD,EAAG,SAAS,EAAGC,EAAMA,EAAOD,EAAG,SAAS,EACtDD,EAAM,KAAKE,CAAY,EAGzB,QAASC,KAAQH,EAAO,CACtB,IAAII,EAGJ,KAAQA,EAAQ,gBAAgB,KAAKD,EAAK,WAAY,GAAI,CACxD,GAAM,CAAC,CAAEE,EAAIC,CAAK,EAAIF,EACtB,GAAI,OAAOE,GAAU,YAAa,CAChC,IAAMC,EAASJ,EAAK,UAAUC,EAAM,KAAK,EACzCD,EAAOI,EAAO,UAAUF,EAAG,MAAM,EACjCP,EAAQ,KAAKS,CAAM,CAGrB,KAAO,CACLJ,EAAK,YAAcE,EACnBP,EAAQ,KAAKK,CAAI,EACjB,KACF,CACF,CACF,CACF,CACA,OAAOL,CACT,CAQA,SAASU,GAAKC,EAAqBC,EAA2B,CAC5DA,EAAO,OAAO,GAAG,MAAM,KAAKD,EAAO,UAAU,CAAC,CAChD,CAoBO,SAASE,GACdZ,EAAiBJ,EAAwB,CAAE,QAAAiB,EAAS,OAAAC,CAAO,EACxB,CAGnC,IAAMC,EAASnB,EAAU,QAAQ,MAAM,EACjCoB,EAASD,GAAA,YAAAA,EAAQ,GAGjBE,EAAc,IAAI,IACxB,QAAWT,KAAUV,GAAYF,CAAS,EAAG,CAC3C,GAAM,CAAC,CAAEU,CAAE,EAAIE,EAAO,YAAa,MAAM,WAAW,EAChDU,GAAmB,yBAAyBZ,CAAE,IAAKN,CAAE,IACvDiB,EAAY,IAAIX,EAAIa,GAAiBb,EAAIU,CAAM,CAAC,EAChDR,EAAO,YAAYS,EAAY,IAAIX,CAAE,CAAE,EAE3C,CAGA,OAAIW,EAAY,OAAS,EAChBG,EAGFC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGC,GAAQ,EAAI,CAAC,EAGlDC,EAAsC,CAAC,EAC7C,OAAW,CAACrB,EAAIsB,CAAU,IAAKX,EAC7BU,EAAM,KAAK,CACTE,EAAW,cAAeD,CAAU,EACpCC,EAAW,yBAAyBvB,CAAE,IAAKN,CAAE,CAC/C,CAAC,EAGH,OAAAc,EAAO,KAAKgB,EAAUN,CAAK,CAAC,EACzB,UAAUO,GAAU,CACnB/B,EAAG,OAAS,CAAC+B,EAGb/B,EAAG,UAAU,OAAO,qBAAsB+B,CAAM,EAGhD,OAAW,CAACC,EAAOC,CAAK,IAAKN,EACtBI,EAGHtB,GAAKuB,EAAOC,CAAK,EAFjBxB,GAAKwB,EAAOD,CAAK,CAGvB,CAAC,EAGIE,EAAM,GAAG,CAAC,GAAGjB,CAAW,EAC5B,IAAI,CAAC,CAAC,CAAEW,CAAU,IACjBO,GAAgBP,EAAYhC,EAAW,CAAE,QAAAiB,CAAQ,CAAC,CACnD,CACH,EACG,KACCuB,EAAS,IAAMd,EAAM,SAAS,CAAC,EAC/Be,GAAM,CACR,CACJ,CAAC,CACH,CC7JA,SAASC,GAASC,EAA0C,CAC1D,GAAIA,EAAG,mBAAoB,CACzB,IAAMC,EAAUD,EAAG,mBACnB,GAAIC,EAAQ,UAAY,KACtB,OAAOA,EAGJ,GAAIA,EAAQ,UAAY,KAAO,CAACA,EAAQ,SAAS,OACpD,OAAOF,GAASE,CAAO,CAC3B,CAIF,CAcO,SAASC,GACdF,EAAiBG,EACkB,CACnC,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAON,GAASC,CAAE,EACxB,OAAO,OAAOK,GAAS,YACnBC,GAAoBD,EAAML,EAAIG,CAAO,EACrCI,CACN,CAAC,CACH,CCjEA,IAAAC,GAAwB,SA2ExB,IAAIC,GAAW,EAaf,SAASC,GAAkBC,EAA0C,CACnE,GAAIA,EAAG,mBAAoB,CACzB,IAAMC,EAAUD,EAAG,mBACnB,GAAIC,EAAQ,UAAY,KACtB,OAAOA,EAGJ,GAAIA,EAAQ,UAAY,KAAO,CAACA,EAAQ,SAAS,OACpD,OAAOF,GAAkBE,CAAO,CACpC,CAIF,CAgBO,SAASC,GACdF,EACsB,CACtB,OAAOG,GAAiBH,CAAE,EACvB,KACCI,EAAI,CAAC,CAAE,MAAAC,CAAM,KAEJ,CACL,WAFcC,GAAsBN,CAAE,EAElB,MAAQK,CAC9B,EACD,EACDE,EAAwB,YAAY,CACtC,CACJ,CAoBO,SAASC,GACdR,EAAiBS,EACiB,CAClC,GAAM,CAAE,QAASC,CAAM,EAAI,WAAW,SAAS,EAGzCC,EAAWC,EAAM,IAAM,CAC3B,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAS,CAAC,CAAC,EACpCH,EAAM,UAAU,CAAC,CAAE,WAAAI,CAAW,IAAM,CAC9BA,GAAcP,EAChBV,EAAG,aAAa,WAAY,GAAG,EAE/BA,EAAG,gBAAgB,UAAU,CACjC,CAAC,EAGD,IAAMkB,EAAoD,CAAC,EAC3D,GAAI,GAAAC,QAAY,YAAY,IACtBnB,EAAG,QAAQ,OAAO,GACpBoB,EAAQ,mBAAmB,GAAK,CAACpB,EAAG,QAAQ,UAAU,GACrD,CACD,IAAMqB,EAASrB,EAAG,QAAQ,KAAK,EAC/BqB,EAAO,GAAK,UAAUvB,IAAU,GAGhC,IAAMwB,EAASC,GAAsBF,EAAO,EAAE,EAC9CA,EAAO,aAAaC,EAAQtB,CAAE,EAC1BoB,EAAQ,kBAAkB,GAC5BF,EAAS,KAAKM,GAAaF,CAAM,CAAC,CACtC,CAIF,IAAMG,EAAYzB,EAAG,QAAQ,YAAY,EACzC,GAAIyB,aAAqB,YAAa,CACpC,IAAMC,EAAO3B,GAAkB0B,CAAS,EAGxC,GAAI,OAAOC,GAAS,cAClBD,EAAU,UAAU,SAAS,UAAU,GACvCL,EAAQ,uBAAuB,GAC9B,CACD,IAAMO,EAAeC,GAAoBF,EAAM1B,EAAIS,CAAO,EAC1DS,EAAS,KACPf,GAAiBsB,CAAS,EACvB,KACCI,EAAUd,CAAK,EACfX,EAAI,CAAC,CAAE,MAAAC,EAAO,OAAAyB,CAAO,IAAMzB,GAASyB,CAAM,EAC1CC,EAAqB,EACrBC,EAAUC,GAAUA,EAASN,EAAeO,CAAK,CACnD,CACJ,CACF,CACF,CAGA,OAAOhC,GAAeF,CAAE,EACrB,KACCmC,EAAIC,GAASvB,EAAM,KAAKuB,CAAK,CAAC,EAC9BC,EAAS,IAAMxB,EAAM,SAAS,CAAC,EAC/BT,EAAIgC,GAAUE,EAAA,CAAE,IAAKtC,GAAOoC,EAAQ,EACpCG,GAAU,GAAGrB,CAAQ,CACvB,CACJ,CAAC,EAGD,OAAIE,EAAQ,cAAc,EACjBoB,GAAuBxC,CAAE,EAC7B,KACCyC,EAAOC,GAAWA,CAAO,EACzBC,GAAK,CAAC,EACNX,EAAU,IAAMrB,CAAQ,CAC1B,EAGGA,CACT,CC1KO,SAASiC,GACdC,EAAwB,CAAE,QAAAC,EAAS,OAAAC,CAAO,EACrB,CACrB,IAAIC,EAAO,GACX,OAAOC,EAGLH,EACG,KACCI,EAAIC,GAAUA,EAAO,QAAQ,qBAAqB,CAAE,EACpDC,EAAOC,GAAWR,IAAOQ,CAAO,EAChCH,EAAI,KAAO,CACT,OAAQ,OAAQ,OAAQ,EAC1B,EAAa,CACf,EAGFH,EACG,KACCK,EAAOE,GAAUA,GAAU,CAACN,CAAI,EAChCO,EAAI,IAAMP,EAAOH,EAAG,IAAI,EACxBK,EAAII,IAAW,CACb,OAAQA,EAAS,OAAS,OAC5B,EAAa,CACf,CACJ,CACF,CAaO,SAASE,GACdX,EAAwBY,EACQ,CAChC,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,OAAAE,EAAQ,OAAAC,CAAO,IAAM,CACtCjB,EAAG,gBAAgB,OAAQgB,IAAW,MAAM,EACxCC,GACFjB,EAAG,eAAe,CACtB,CAAC,EAGMD,GAAaC,EAAIY,CAAO,EAC5B,KACCF,EAAIQ,GAASJ,EAAM,KAAKI,CAAK,CAAC,EAC9BC,EAAS,IAAML,EAAM,SAAS,CAAC,EAC/BT,EAAIa,GAAUE,EAAA,CAAE,IAAKpB,GAAOkB,EAAQ,CACtC,CACJ,CAAC,CACH,CCzIA,IAAAG,GAAA,ktLCqDA,IAAIC,GAKAC,GAAW,EAWf,SAASC,IAAiC,CACxC,OAAO,OAAO,SAAY,aAAe,mBAAmB,QACxDC,GAAY,sDAAsD,EAClEC,EAAG,MAAS,CAClB,CAaO,SAASC,GACdC,EACgC,CAChC,OAAAA,EAAG,UAAU,OAAO,SAAS,EAC7BN,QAAaE,GAAa,EACvB,KACCK,EAAI,IAAM,QAAQ,WAAW,CAC3B,YAAa,GACb,SAAAC,GACA,SAAU,CACR,cAAe,OACf,gBAAiB,OACjB,aAAc,MAChB,CACF,CAAC,CAAC,EACFC,EAAI,IAAG,EAAY,EACnBC,EAAY,CAAC,CACf,GAGFV,GAAS,UAAU,IAAYW,GAAA,sBAC7BL,EAAG,UAAU,IAAI,SAAS,EAC1B,IAAMM,EAAK,aAAaX,IAAU,GAG5BY,EAAOC,EAAE,MAAO,CAAE,MAAO,SAAU,CAAC,EACpCC,EAAOT,EAAG,YAGV,CAAE,IAAAU,EAAK,GAAAC,CAAG,EAAI,MAAM,QAAQ,OAAOL,EAAIG,CAAI,EAG3CG,EAASL,EAAK,aAAa,CAAE,KAAM,QAAS,CAAC,EACnDK,EAAO,UAAYF,EAGnBV,EAAG,YAAYO,CAAI,EACnBI,GAAA,MAAAA,EAAKC,EACP,EAAC,EAGMlB,GACJ,KACCS,EAAI,KAAO,CAAE,IAAKH,CAAG,EAAE,CACzB,CACJ,CCtFA,IAAMa,GAAWC,EAAE,OAAO,EAgBnB,SAASC,GACdC,EACkC,CAClC,OAAAA,EAAG,YAAYH,EAAQ,EACvBA,GAAS,YAAYI,GAAYD,CAAE,CAAC,EAG7BE,EAAG,CAAE,IAAKF,CAAG,CAAC,CACvB,CC2BO,SAASG,GACdC,EACyB,CACzB,IAAMC,EAAUD,EAAO,KAAKE,GAASA,EAAM,OAAO,GAAKF,EAAO,CAAC,EAC/D,OAAOG,EAAM,GAAGH,EAAO,IAAIE,GAASE,EAAUF,EAAO,QAAQ,EAC1D,KACCG,EAAI,IAAMC,EAA6B,cAAcJ,EAAM,EAAE,IAAI,CAAC,CACpE,CACF,CAAC,EACE,KACCK,EAAUD,EAA6B,cAAcL,EAAQ,EAAE,IAAI,CAAC,EACpEI,EAAIG,IAAW,CAAE,OAAAA,CAAO,EAAE,CAC5B,CACJ,CAUO,SAASC,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACF,CACpC,IAAMC,EAAYP,EAAW,iBAAkBI,CAAE,EAC3CV,EAASc,EAA8B,iBAAkBJ,CAAE,EAG3DK,EAAOC,GAAoB,MAAM,EACvCN,EAAG,OAAOK,CAAI,EAGd,IAAME,EAAOD,GAAoB,MAAM,EACvC,OAAAN,EAAG,OAAOO,CAAI,EAGPC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGC,GAAQ,EAAI,CAAC,EACxDC,EAAc,CAACL,EAAOM,GAAiBf,CAAE,CAAC,CAAC,EACxC,KACCgB,EAAUL,CAAK,EACfM,GAAU,EAAGC,EAAuB,CACtC,EACG,UAAU,CAGT,KAAK,CAAC,CAAE,OAAApB,CAAO,EAAGqB,CAAI,EAAG,CACvB,IAAMC,EAASC,GAAiBvB,CAAM,EAChC,CAAE,MAAAwB,CAAM,EAAIC,GAAezB,CAAM,EAGvCE,EAAG,MAAM,YAAY,mBAAoB,GAAGoB,EAAO,CAAC,IAAI,EACxDpB,EAAG,MAAM,YAAY,uBAAwB,GAAGsB,CAAK,IAAI,EAGzD,IAAME,EAAUC,GAAwBtB,CAAS,GAE/CiB,EAAO,EAAYI,EAAQ,GAC3BJ,EAAO,EAAIE,EAAQE,EAAQ,EAAIL,EAAK,QAEpChB,EAAU,SAAS,CACjB,KAAM,KAAK,IAAI,EAAGiB,EAAO,EAAI,EAAE,EAC/B,SAAU,QACZ,CAAC,CACL,EAGA,UAAW,CACTpB,EAAG,MAAM,eAAe,kBAAkB,EAC1CA,EAAG,MAAM,eAAe,sBAAsB,CAChD,CACF,CAAC,EAGLc,EAAc,CACZY,GAA0BvB,CAAS,EACnCY,GAAiBZ,CAAS,CAC5B,CAAC,EACE,KACCa,EAAUL,CAAK,CACjB,EACG,UAAU,CAAC,CAACS,EAAQD,CAAI,IAAM,CAC7B,IAAMK,EAAUG,GAAsBxB,CAAS,EAC/CE,EAAK,OAASe,EAAO,EAAI,GACzBb,EAAK,OAASa,EAAO,EAAII,EAAQ,MAAQL,EAAK,MAAQ,EACxD,CAAC,EAGL1B,EACEC,EAAUW,EAAM,OAAO,EAAE,KAAKV,EAAI,IAAM,EAAE,CAAC,EAC3CD,EAAUa,EAAM,OAAO,EAAE,KAAKZ,EAAI,IAAM,CAAE,CAAC,CAC7C,EACG,KACCqB,EAAUL,CAAK,CACjB,EACG,UAAUiB,GAAa,CACtB,GAAM,CAAE,MAAAN,CAAM,EAAIC,GAAepB,CAAS,EAC1CA,EAAU,SAAS,CACjB,KAAMmB,EAAQM,EACd,SAAU,QACZ,CAAC,CACH,CAAC,EAGL1B,EACG,KACCc,EAAUL,CAAK,EACfkB,EAAOrC,GAASF,EAAO,SAASE,CAAyB,CAAC,CAC5D,EACG,UAAUA,GAASA,EAAM,MAAM,CAAC,EAGrCW,EAAU,UAAU,IAAI,uBAAuB,EAC/C,QAAWX,KAASF,EAAQ,CAC1B,IAAMwC,EAAQlC,EAA6B,cAAcJ,EAAM,EAAE,IAAI,EACrEsC,EAAM,gBAAgBC,EAAE,IAAK,CAC3B,KAAM,IAAID,EAAM,OAAO,GACvB,SAAU,EACZ,EAAG,GAAG,MAAM,KAAKA,EAAM,UAAU,CAAC,CAAC,EAGnCpC,EAAsBoC,EAAM,kBAAoB,OAAO,EACpD,KACCd,EAAUL,CAAK,EACfkB,EAAOG,GAAM,EAAEA,EAAG,SAAWA,EAAG,QAAQ,EACxCC,EAAID,GAAM,CACRA,EAAG,eAAe,EAClBA,EAAG,gBAAgB,CACrB,CAAC,CACH,EAEG,UAAU,IAAM,CACf,QAAQ,aAAa,CAAC,EAAG,GAAI,IAAIF,EAAM,OAAO,EAAE,EAChDA,EAAM,MAAM,CACd,CAAC,CACP,CAGA,OAAII,EAAQ,mBAAmB,GAC7BzB,EAAM,KACJ0B,GAAK,CAAC,EACNC,GAAenC,CAAS,CAC1B,EACG,UAAU,CAAC,CAAC,CAAE,OAAAH,CAAO,EAAG,CAAE,OAAAsB,CAAO,CAAC,IAAM,CACvC,IAAMiB,EAAMvC,EAAO,UAAU,KAAK,EAClC,GAAIA,EAAO,aAAa,mBAAmB,EACzCA,EAAO,gBAAgB,mBAAmB,MAGrC,CACL,IAAMwC,EAAItC,EAAG,UAAYoB,EAAO,EAGhC,QAAWmB,KAAOnC,EAAY,aAAa,EACzC,QAAWZ,KAASY,EAClB,iBAAkBmC,CACpB,EAAG,CACD,IAAMT,EAAQlC,EAAW,cAAcJ,EAAM,EAAE,IAAI,EACnD,GACEsC,IAAUhC,GACVgC,EAAM,UAAU,KAAK,IAAMO,EAC3B,CACAP,EAAM,aAAa,oBAAqB,EAAE,EAC1CtC,EAAM,MAAM,EACZ,KACF,CACF,CAGF,OAAO,SAAS,CACd,IAAKQ,EAAG,UAAYsC,CACtB,CAAC,EAGD,IAAME,EAAO,SAAmB,QAAQ,GAAK,CAAC,EAC9C,SAAS,SAAU,CAAC,GAAG,IAAI,IAAI,CAACH,EAAK,GAAGG,CAAI,CAAC,CAAC,CAAC,CACjD,CACF,CAAC,EAGL/B,EAAM,KAAKO,EAAUL,CAAK,CAAC,EACxB,UAAU,IAAM,CACf,QAAW8B,KAASrC,EAA8B,eAAgBJ,CAAE,EAClEyC,EAAM,MAAM,CAChB,CAAC,EAGIpD,GAAiBC,CAAM,EAC3B,KACC2C,EAAIS,GAASjC,EAAM,KAAKiC,CAAK,CAAC,EAC9BC,EAAS,IAAMlC,EAAM,SAAS,CAAC,EAC/Bd,EAAI+C,GAAUE,EAAA,CAAE,IAAK5C,GAAO0C,EAAQ,CACtC,CACJ,CAAC,EACE,KACCG,GAAYC,EAAc,CAC5B,CACJ,CCnMO,SAASC,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,EAAS,OAAAC,CAAO,EACd,CAChC,OAAOC,EAGL,GAAGC,EAAY,4BAA6BL,CAAE,EAC3C,IAAIM,GAASC,GAAqBD,EAAO,CAAE,QAAAJ,EAAS,OAAAC,CAAO,CAAC,CAAC,EAGhE,GAAGE,EAAY,2BAA4BL,CAAE,EAC1C,IAAIM,GAASE,GAAeF,EAAO,CAAE,QAAAJ,EAAS,OAAAC,CAAO,CAAC,CAAC,EAG1D,GAAGE,EAAY,cAAeL,CAAE,EAC7B,IAAIM,GAASG,GAAaH,CAAK,CAAC,EAGnC,GAAGD,EAAY,qBAAsBL,CAAE,EACpC,IAAIM,GAASI,GAAeJ,CAAK,CAAC,EAGrC,GAAGD,EAAY,UAAWL,CAAE,EACzB,IAAIM,GAASK,GAAaL,EAAO,CAAE,QAAAJ,EAAS,OAAAC,CAAO,CAAC,CAAC,EAGxD,GAAGE,EAAY,cAAeL,CAAE,EAC7B,IAAIM,GAASM,GAAiBN,EAAO,CAAE,UAAAL,EAAW,QAAAC,CAAQ,CAAC,CAAC,EAG/D,GAAGG,EAAY,UAAWL,CAAE,EACzB,OAAO,IAAMa,EAAQ,kBAAkB,CAAC,EACxC,IAAIP,GAASQ,GAAaR,CAAK,CAAC,CACrC,CACF,CCtDO,SAASS,GACdC,EAAkB,CAAE,OAAAC,CAAO,EACP,CACpB,OAAOA,EACJ,KACCC,EAAUC,GAAWC,EACnBC,EAAG,EAAI,EACPA,EAAG,EAAK,EAAE,KAAKC,GAAM,GAAI,CAAC,CAC5B,EACG,KACCC,EAAIC,IAAW,CAAE,QAAAL,EAAS,OAAAK,CAAO,EAAE,CACrC,CACF,CACF,CACJ,CAaO,SAASC,GACdC,EAAiBC,EACc,CAC/B,IAAMC,EAAQC,EAAW,cAAeH,CAAE,EAC1C,OAAOI,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,QAAAZ,EAAS,OAAAK,CAAO,IAAM,CACvCE,EAAG,UAAU,OAAO,oBAAqBF,CAAM,EAC/CI,EAAM,YAAcT,CACtB,CAAC,EAGMJ,GAAYW,EAAIC,CAAO,EAC3B,KACCM,EAAIC,GAASH,EAAM,KAAKG,CAAK,CAAC,EAC9BC,EAAS,IAAMJ,EAAM,SAAS,CAAC,EAC/BR,EAAIW,GAAUE,EAAA,CAAE,IAAKV,GAAOQ,EAAQ,CACtC,CACJ,CAAC,CACH,CCrBA,SAASG,GAAS,CAAE,UAAAC,CAAU,EAAsC,CAClE,GAAI,CAACC,EAAQ,iBAAiB,EAC5B,OAAOC,EAAG,EAAK,EAGjB,IAAMC,EAAaH,EAChB,KACCI,EAAI,CAAC,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,IAAMA,CAAC,EAC5BC,GAAY,EAAG,CAAC,EAChBF,EAAI,CAAC,CAACG,EAAGC,CAAC,IAAM,CAACD,EAAIC,EAAGA,CAAC,CAAU,EACnCC,EAAwB,CAAC,CAC3B,EAGIC,EAAUC,EAAc,CAACX,EAAWG,CAAU,CAAC,EAClD,KACCS,EAAO,CAAC,CAAC,CAAE,OAAAC,CAAO,EAAG,CAAC,CAAER,CAAC,CAAC,IAAM,KAAK,IAAIA,EAAIQ,EAAO,CAAC,EAAI,GAAG,EAC5DT,EAAI,CAAC,CAAC,CAAE,CAACU,CAAS,CAAC,IAAMA,CAAS,EAClCC,EAAqB,CACvB,EAGIC,EAAUC,GAAY,QAAQ,EACpC,OAAON,EAAc,CAACX,EAAWgB,CAAO,CAAC,EACtC,KACCZ,EAAI,CAAC,CAAC,CAAE,OAAAS,CAAO,EAAGK,CAAM,IAAML,EAAO,EAAI,KAAO,CAACK,CAAM,EACvDH,EAAqB,EACrBI,EAAUC,GAAUA,EAASV,EAAUR,EAAG,EAAK,CAAC,EAChDmB,EAAU,EAAK,CACjB,CACJ,CAcO,SAASC,GACdC,EAAiBC,EACG,CACpB,OAAOC,EAAM,IAAMd,EAAc,CAC/Be,GAAiBH,CAAE,EACnBxB,GAASyB,CAAO,CAClB,CAAC,CAAC,EACC,KACCpB,EAAI,CAAC,CAAC,CAAE,OAAAuB,CAAO,EAAGC,CAAM,KAAO,CAC7B,OAAAD,EACA,OAAAC,CACF,EAAE,EACFb,EAAqB,CAACR,EAAGC,IACvBD,EAAE,SAAWC,EAAE,QACfD,EAAE,SAAWC,EAAE,MAChB,EACDqB,EAAY,CAAC,CACf,CACJ,CAaO,SAASC,GACdP,EAAiB,CAAE,QAAAQ,EAAS,MAAAC,CAAM,EACO,CACzC,OAAOP,EAAM,IAAM,CACjB,IAAMQ,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGC,GAAQ,EAAI,CAAC,EACxDJ,EACG,KACCxB,EAAwB,QAAQ,EAChC6B,GAAkBP,CAAO,CAC3B,EACG,UAAU,CAAC,CAAC,CAAE,OAAAX,CAAO,EAAG,CAAE,OAAAQ,CAAO,CAAC,IAAM,CACvCL,EAAG,UAAU,OAAO,oBAAqBH,GAAU,CAACQ,CAAM,EAC1DL,EAAG,OAASK,CACd,CAAC,EAGL,IAAMW,EAAWC,GAAKC,EAAY,UAAWlB,CAAE,CAAC,EAC7C,KACCX,EAAO,IAAMX,EAAQ,kBAAkB,CAAC,EACxCyC,GAASC,GAASC,GAAaD,CAAK,CAAC,CACvC,EAGF,OAAAX,EAAM,UAAUC,CAAK,EAGdF,EACJ,KACCc,EAAUV,CAAK,EACf/B,EAAI0C,GAAUC,EAAA,CAAE,IAAKxB,GAAOuB,EAAQ,EACpCE,GAAUT,EAAS,KAAKM,EAAUV,CAAK,CAAC,CAAC,CAC3C,CACJ,CAAC,CACH,CCjIO,SAASc,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACb,CACzB,OAAOC,GAAgBH,EAAI,CAAE,UAAAC,EAAW,QAAAC,CAAQ,CAAC,EAC9C,KACCE,EAAI,CAAC,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,IAAM,CACzB,GAAM,CAAE,OAAAC,CAAO,EAAIC,GAAeP,CAAE,EACpC,MAAO,CACL,OAAQK,GAAKC,CACf,CACF,CAAC,EACDE,EAAwB,QAAQ,CAClC,CACJ,CAaO,SAASC,GACdT,EAAiBU,EACmB,CACpC,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClBD,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAE,CAAO,EAAG,CACfd,EAAG,UAAU,OAAO,2BAA4Bc,CAAM,CACxD,EAGA,UAAW,CACTd,EAAG,UAAU,OAAO,0BAA0B,CAChD,CACF,CAAC,EAGD,IAAMe,EAAUC,GAAmB,gBAAgB,EACnD,OAAI,OAAOD,GAAY,YACdE,EAGFlB,GAAiBgB,EAASL,CAAO,EACrC,KACCQ,EAAIC,GAASP,EAAM,KAAKO,CAAK,CAAC,EAC9BC,EAAS,IAAMR,EAAM,SAAS,CAAC,EAC/BR,EAAIe,GAAUE,EAAA,CAAE,IAAKrB,GAAOmB,EAAQ,CACtC,CACJ,CAAC,CACH,CChEO,SAASG,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACpB,CAGlB,IAAMC,EAAUD,EACb,KACCE,EAAI,CAAC,CAAE,OAAAC,CAAO,IAAMA,CAAM,EAC1BC,EAAqB,CACvB,EAGIC,EAAUJ,EACb,KACCK,EAAU,IAAMC,GAAiBT,CAAE,EAChC,KACCI,EAAI,CAAC,CAAE,OAAAC,CAAO,KAAO,CACnB,IAAQL,EAAG,UACX,OAAQA,EAAG,UAAYK,CACzB,EAAE,EACFK,EAAwB,QAAQ,CAClC,CACF,CACF,EAGF,OAAOC,EAAc,CAACR,EAASI,EAASN,CAAS,CAAC,EAC/C,KACCG,EAAI,CAAC,CAACQ,EAAQ,CAAE,IAAAC,EAAK,OAAAC,CAAO,EAAG,CAAE,OAAQ,CAAE,EAAAC,CAAE,EAAG,KAAM,CAAE,OAAAV,CAAO,CAAE,CAAC,KAChEA,EAAS,KAAK,IAAI,EAAGA,EACjB,KAAK,IAAI,EAAGQ,EAASE,EAAIH,CAAM,EAC/B,KAAK,IAAI,EAAGP,EAASU,EAAID,CAAM,CACnC,EACO,CACL,OAAQD,EAAMD,EACd,OAAAP,EACA,OAAQQ,EAAMD,GAAUG,CAC1B,EACD,EACDT,EAAqB,CAACU,EAAGC,IACvBD,EAAE,SAAWC,EAAE,QACfD,EAAE,SAAWC,EAAE,QACfD,EAAE,SAAWC,EAAE,MAChB,CACH,CACJ,CC1CO,SAASC,GACdC,EACqB,CACrB,IAAMC,EAAU,SAAkB,WAAW,GAAK,CAChD,MAAOD,EAAO,UAAUE,GAAS,WAC/BA,EAAM,aAAa,qBAAqB,CAC1C,EAAE,OAAO,CACX,EAGMC,EAAQ,KAAK,IAAI,EAAG,KAAK,IAAIF,EAAQ,MAAOD,EAAO,OAAS,CAAC,CAAC,EACpE,OAAOI,EAAG,GAAGJ,CAAM,EAChB,KACCK,GAASH,GAASI,EAAUJ,EAAO,QAAQ,EAAE,KAAKK,EAAI,IAAML,CAAK,CAAC,CAAC,EACnEM,EAAUR,EAAOG,CAAK,CAAC,EACvBI,EAAIL,IAAU,CACZ,MAAOF,EAAO,QAAQE,CAAK,EAC3B,MAAO,CACL,MAASA,EAAM,aAAa,qBAAqB,EACjD,OAASA,EAAM,aAAa,sBAAsB,EAClD,QAASA,EAAM,aAAa,uBAAuB,EACnD,OAASA,EAAM,aAAa,sBAAsB,CACpD,CACF,EAAa,EACbO,EAAY,CAAC,CACf,CACJ,CASO,SAASC,GACdC,EACgC,CAChC,IAAMX,EAASY,EAA8B,QAASD,CAAE,EAClDE,EAAOC,EAAE,OAAQ,CAAE,KAAM,aAAc,CAAC,EAC9C,SAAS,KAAK,YAAYD,CAAI,EAG9B,IAAME,EAASD,EAAE,OAAQ,CAAE,KAAM,cAAe,CAAC,EACjD,SAAS,KAAK,YAAYC,CAAM,EAGhC,IAAMC,EAASC,GAAW,+BAA+B,EACzD,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAUE,GAAW,CAIzB,GAHA,SAAS,KAAK,aAAa,0BAA2B,EAAE,EAGpDA,EAAQ,MAAM,QAAU,yBAA0B,CACpD,IAAMC,EAAQ,WAAW,+BAA+B,EAClDpB,EAAQ,SAAS,cAAcoB,EAAM,QACvC,wDACA,sDACJ,EAGAD,EAAQ,MAAM,OAAUnB,EAAM,aAAa,sBAAsB,EACjEmB,EAAQ,MAAM,QAAUnB,EAAM,aAAa,uBAAuB,EAClEmB,EAAQ,MAAM,OAAUnB,EAAM,aAAa,sBAAsB,CACnE,CAGA,OAAW,CAACqB,EAAKC,CAAK,IAAK,OAAO,QAAQH,EAAQ,KAAK,EACrD,SAAS,KAAK,aAAa,iBAAiBE,CAAG,GAAIC,CAAK,EAG1D,QAASrB,EAAQ,EAAGA,EAAQH,EAAO,OAAQG,IAAS,CAClD,IAAMsB,EAAQzB,EAAOG,CAAK,EAAE,mBACxBsB,aAAiB,cACnBA,EAAM,OAASJ,EAAQ,QAAUlB,EACrC,CAGA,SAAS,YAAakB,CAAO,CAC/B,CAAC,EAGDF,EACG,KACCZ,EAAI,IAAM,CACR,IAAMmB,EAASC,GAAoB,QAAQ,EACrCC,EAAS,OAAO,iBAAiBF,CAAM,EAG7C,OAAAX,EAAO,QAAUa,EAAM,YAGhBA,EAAM,gBAAgB,MAAM,MAAM,EACtC,IAAIJ,IAAU,CAACA,GAAO,SAAS,EAAE,EAAE,SAAS,EAAG,GAAG,CAAC,EACnD,KAAK,EAAE,CACZ,CAAC,CACH,EACG,UAAUK,GAAShB,EAAK,QAAU,IAAIgB,CAAK,EAAE,EAGlDV,EAAM,KAAKW,GAAUC,EAAc,CAAC,EACjC,UAAU,IAAM,CACf,SAAS,KAAK,gBAAgB,yBAAyB,CACzD,CAAC,EAGIhC,GAAaC,CAAM,EACvB,KACCgC,EAAUhB,EAAO,KAAKiB,GAAK,CAAC,CAAC,CAAC,EAC9BC,GAAO,EACPC,EAAIC,GAASjB,EAAM,KAAKiB,CAAK,CAAC,EAC9BC,EAAS,IAAMlB,EAAM,SAAS,CAAC,EAC/BZ,EAAI6B,GAAUE,EAAA,CAAE,IAAK3B,GAAOyB,EAAQ,CACtC,CACJ,CAAC,CACH,CCnIO,SAASG,GACdC,EAAiB,CAAE,UAAAC,CAAU,EACI,CAGjC,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,MAAAE,CAAM,IAAM,CAC7BL,EAAG,MAAM,YAAY,sBAAuB,GAAGK,CAAK,EAAE,CACxD,CAAC,EAGMJ,EACJ,KACCK,EAAID,GAASF,EAAM,KAAK,CAAE,MAAAE,CAAM,CAAC,CAAC,EAClCE,EAAS,IAAMJ,EAAM,SAAS,CAAC,EAC/BK,EAAIH,IAAU,CAAE,IAAKL,EAAI,MAAAK,CAAM,EAAE,CACnC,CACJ,CAAC,CACH,CChEA,IAAAI,GAAwB,SAiCxB,SAASC,GAAQC,EAAyB,CACxCA,EAAG,aAAa,kBAAmB,EAAE,EACrC,IAAMC,EAAOD,EAAG,QAAQ,aAAa,EAC/BE,EAAOD,EACTA,EAAK,aAAa,WAAW,EAC7BD,EAAG,UACP,OAAAA,EAAG,gBAAgB,iBAAiB,EAC7BE,EAAK,QAAQ,CACtB,CAWO,SAASC,GACd,CAAE,OAAAC,CAAO,EACH,CACF,GAAAC,QAAY,YAAY,GAC1B,IAAIC,EAA8BC,GAAc,CAC9C,IAAI,GAAAF,QAAY,iDAAkD,CAChE,KAAML,GACJA,EAAG,aAAa,qBAAqB,GACrCD,GAAQS,EACNR,EAAG,aAAa,uBAAuB,CACzC,CAAC,CAEL,CAAC,EACE,GAAG,UAAWS,GAAMF,EAAW,KAAKE,CAAE,CAAC,CAC5C,CAAC,EACE,KACCC,EAAID,GAAM,CACQA,EAAG,QACX,MAAM,CAChB,CAAC,EACDE,EAAI,IAAMC,GAAY,kBAAkB,CAAC,CAC3C,EACG,UAAUR,CAAM,CAEzB,CCrCA,SAASS,GAAQC,EAAUC,EAAW,CACpC,OAAAD,EAAI,SAAWC,EAAK,SACpBD,EAAI,SAAWC,EAAK,SACbD,CACT,CA2BA,SAASE,GAAQC,EAAoBF,EAAoB,CACvD,IAAMG,EAAmB,IAAI,IAC7B,QAAWC,KAAMC,EAAY,MAAOH,CAAQ,EAAG,CAC7C,IAAMH,EAAMO,EAAW,MAAOF,CAAE,EAG1BG,EAAQ,CAACT,GAAQ,IAAI,IAAIC,EAAI,WAAY,EAAGC,CAAI,CAAC,EACvDG,EAAQ,IAAI,GAAGI,EAAM,CAAC,CAAC,GAAIA,CAAK,EAGhC,QAAWC,KAAQH,EAAY,kBAAmBD,CAAE,EAAG,CACrD,IAAMK,EAAOD,EAAK,aAAa,MAAM,EACjCC,GAAQ,MACVF,EAAM,KAAKT,GAAQ,IAAI,IAAIW,CAAI,EAAGT,CAAI,CAAC,CAC3C,CACF,CAGA,OAAOG,CACT,CAgBO,SAASO,GAAaV,EAAyC,CACpE,OAAOW,GAAW,IAAI,IAAI,cAAeX,CAAI,CAAC,EAC3C,KACCY,EAAIV,GAAYD,GAAQC,EAAU,IAAI,IAAIF,CAAI,CAAC,CAAC,EAChDa,GAAW,IAAMC,EAAG,IAAI,GAAK,CAAC,CAChC,CACJ,CClDA,SAASC,GACPC,EAAgBC,EACC,CACjB,GAAI,EAAED,EAAG,kBAAkB,SACzB,OAAOE,EAIT,IAAMC,EAAKH,EAAG,OAAO,QAAQ,GAAG,EAChC,GAAIG,IAAO,KACT,OAAOD,EAMT,GAAIC,EAAG,QAAUH,EAAG,SAAWA,EAAG,QAChC,OAAOE,EAQT,IAAME,EAAM,IAAI,IAAID,EAAG,IAAI,EAO3B,OANAC,EAAI,OAASA,EAAI,KAAO,GAMnBH,EAAQ,IAAI,GAAGG,CAAG,EAAE,GASzBJ,EAAG,eAAe,EACXK,EAAG,IAAI,IAAIF,EAAG,IAAI,CAAC,GATjBD,CAUX,CASA,SAASI,GAAKC,EAA8C,CAC1D,IAAMC,EAAO,IAAI,IACjB,QAAWL,KAAMM,EAAY,aAAcF,EAAS,IAAI,EACtDC,EAAK,IAAIL,EAAG,UAAWA,CAAE,EAG3B,OAAOK,CACT,CAYA,SAASE,GAAQH,EAA0C,CACzD,QAAWJ,KAAMM,EAAY,gBAAiBF,CAAQ,EACpD,QAAWI,IAAO,CAAC,OAAQ,KAAK,EAAG,CACjC,IAAMC,EAAQT,EAAG,aAAaQ,CAAG,EACjC,GAAIC,GAAS,CAAC,qBAAqB,KAAKA,CAAK,EAAG,CAE9CT,EAAGQ,CAAG,EAAIR,EAAGQ,CAAG,EAChB,KACF,CACF,CAGF,OAAON,EAAGE,CAAQ,CACpB,CASA,SAASM,GAAOC,EAAsC,CACpD,QAAWC,IAAY,CACrB,+BACA,gCACA,mCACA,+BACA,2BACA,2BACA,GAAGC,EAAQ,wBAAwB,EAC/B,CAAC,0BAA0B,EAC3B,CAAC,CACP,EAAG,CACD,IAAMC,EAASC,GAAmBH,CAAQ,EACpCI,EAASD,GAAmBH,EAAUD,CAAI,EAE9C,OAAOG,GAAW,aAClB,OAAOE,GAAW,aAElBF,EAAO,YAAYE,CAAM,CAE7B,CAGA,IAAMX,EAAOF,GAAK,QAAQ,EAC1B,OAAW,CAACc,EAAMjB,CAAE,IAAKG,GAAKQ,CAAI,EAC5BN,EAAK,IAAIY,CAAI,EACfZ,EAAK,OAAOY,CAAI,EAEhB,SAAS,KAAK,YAAYjB,CAAE,EAGhC,QAAWA,KAAMK,EAAK,OAAO,EAAG,CAC9B,IAAMa,EAAOlB,EAAG,aAAa,MAAM,EAI/BkB,IAAS,eAAiBA,IAAS,gBACrClB,EAAG,OAAO,CACd,CAIA,IAAMmB,EAAYC,GAAoB,WAAW,EACjD,OAAOC,GAAOf,EAAY,SAAUa,CAAS,CAAC,EAC3C,KACCG,EAAUtB,GAAM,CACd,IAAMuB,EAASZ,EAAK,cAAc,QAAQ,EAC1C,GAAIX,EAAG,IAAK,CACV,QAAWkB,KAAQlB,EAAG,kBAAkB,EACtCuB,EAAO,aAAaL,EAAMlB,EAAG,aAAakB,CAAI,CAAE,EAClD,OAAAlB,EAAG,YAAYuB,CAAM,EAGd,IAAIC,EAAWC,GAAY,CAChCF,EAAO,OAAS,IAAME,EAAS,SAAS,CAC1C,CAAC,CAGH,KACE,QAAAF,EAAO,YAAcvB,EAAG,YACxBA,EAAG,YAAYuB,CAAM,EACdxB,CAEX,CAAC,EACD2B,GAAe,EACfC,GAAQ,QAAQ,CAClB,CACJ,CAgBO,SAASC,GACd,CAAE,UAAAC,EAAW,UAAAC,EAAW,UAAAC,CAAU,EACZ,CACtB,IAAMC,EAASC,GAAc,EAC7B,GAAI,SAAS,WAAa,QACxB,OAAOlC,EAIT,IAAMmC,EAAWC,GAAaH,EAAO,IAAI,EAUzC9B,EAAG,QAAQ,EACR,UAAUK,EAAO,EAUpB,IAAM6B,EACJC,EAAsB,SAAS,KAAM,OAAO,EACzC,KACCC,GAAkBJ,CAAQ,EAC1BZ,EAAU,CAAC,CAACzB,EAAIC,CAAO,IAAMF,GAAOC,EAAIC,CAAO,CAAC,EAChDyC,GAAM,CACR,EAIEC,EACJH,EAAyB,OAAQ,UAAU,EACxC,KACCI,EAAIC,EAAW,EACfH,GAAM,CACR,EAMJH,EAAS,KAAKO,GAAeb,CAAS,CAAC,EACpC,UAAU,CAAC,CAAC7B,EAAK,CAAE,OAAA2C,CAAO,CAAC,IAAM,CAChC,QAAQ,aAAaA,EAAQ,EAAE,EAC/B,QAAQ,UAAU,KAAM,GAAI3C,CAAG,CACjC,CAAC,EAMH4C,EAAMT,EAAUI,CAAQ,EACrB,UAAUX,CAAS,EActB,IAAMiB,EACJjB,EAAU,KACRkB,EAAwB,UAAU,EAClCzB,EAAUrB,GAAO+C,GAAY/C,EAAK,CAAE,UAAA8B,CAAU,CAAC,EAC5C,KACCkB,GAAW,KACTC,GAAYjD,EAAK,EAAI,EACdF,EACR,CACH,CACF,EAIAuB,EAAUf,EAAO,EACjBe,EAAUZ,EAAM,EAChB6B,GAAM,CACR,EAUF,OAAAM,EACEC,EAAU,KAAKH,GAAed,EAAW,CAACsB,EAAGlD,IAAQA,CAAG,CAAC,EASzD4B,EAAU,KACRkB,EAAwB,UAAU,EAClCzB,EAAU,IAAMO,CAAS,EACzBkB,EAAwB,MAAM,CAChC,EAQAlB,EAAU,KACRuB,EAAqB,CAACC,EAAGC,IACvBD,EAAE,WAAaC,EAAE,UACjBD,EAAE,OAAaC,EAAE,IAClB,EACDhC,EAAU,IAAMc,CAAQ,EACxBmB,EAAI,IAAM,QAAQ,KAAK,CAAC,CAC1B,CACF,EACG,UAAUtD,GAAO,CAzYtB,IAAAuD,EAAAC,EA+YU,QAAQ,QAAU,MAAQ,CAACxD,EAAI,KACjC,OAAO,SAAS,GAAGwD,GAAAD,EAAA,QAAQ,QAAR,YAAAA,EAAe,IAAf,KAAAC,EAAoB,CAAC,GAExC,QAAQ,kBAAoB,OAC5BC,GAAgBzD,EAAI,IAAI,EACxB,QAAQ,kBAAoB,SAEhC,CAAC,EAMH4B,EAAU,UAAU,IAAM,CACxB,QAAQ,kBAAoB,QAC9B,CAAC,EAMDQ,EAAU,OAAQ,cAAc,EAC7B,UAAU,IAAM,CACf,QAAQ,kBAAoB,MAC9B,CAAC,EAMHP,EAAU,KACRiB,EAAwB,QAAQ,EAChCY,GAAa,GAAG,CAClB,EACG,UAAU,CAAC,CAAE,OAAAf,CAAO,IAAM,CACzB,QAAQ,aAAaA,EAAQ,EAAE,CACjC,CAAC,EAGIE,CACT,CCjaA,IAAAc,GAAuB,SAqChB,SAASC,GACdC,EAC0B,CAE1B,IAAMC,EAAQD,EAAO,UAAU,MAAM,GAAG,EAAE,IAAIE,GAC/BA,EAAK,QAAQ,sBAAuB,EAAE,EACvC,SAAW,EAAI,SAAMA,CAClC,EACE,KAAK,GAAG,EAELC,EAAY,IAAI,OAAOF,EAAO,KAAK,EACnCG,EAAY,CAACC,EAAYC,EAAcJ,IACpC,GAAGI,CAAI,2BAA2BJ,CAAI,UAI/C,OAAQK,GAAkB,CACxBA,EAAQA,EACL,QAAQ,gBAAiB,GAAG,EAC5B,KAAK,EAGR,IAAMC,EAAQ,IAAI,OAAO,MAAMR,EAAO,SAAS,MAC7CO,EACG,QAAQ,uBAAwB,MAAM,EACtC,QAAQJ,EAAW,GAAG,CAC3B,IAAK,KAAK,EAGV,OAAOM,MAAS,GAAAC,SAAWD,CAAK,EAC7B,QAAQD,EAAOJ,CAAS,EACxB,QAAQ,8BAA+B,IAAI,CAChD,CACF,CCEO,SAASO,GACdC,EAC+B,CAC/B,OAAOA,EAAQ,OAAS,CAC1B,CASO,SAASC,GACdD,EACgC,CAChC,OAAOA,EAAQ,OAAS,CAC1B,CC1CO,SAASE,GACdC,EAAaC,EACW,CACxB,IAAMC,EAAUC,GAA2BH,CAAG,EAC9C,OAAAI,EACEC,EAAG,SAAS,WAAa,OAAO,EAChCC,GAAY,QAAQ,CACtB,EACG,KACCC,GAAMC,GAAUA,CAAM,EACtBC,EAAU,IAAMR,CAAM,CACxB,EACG,UAAU,CAAC,CAAE,OAAAS,EAAQ,KAAAC,CAAK,IAAMT,EAAQ,KAAK,CAC5C,OACA,KAAM,CACJ,OAAAQ,EACA,KAAAC,EACA,QAAS,CACP,QAASC,EAAQ,gBAAgB,CACnC,CACF,CACF,CAAC,CAAC,EAGCV,CACT,CCxBO,SAASW,GACd,CAAE,UAAAC,CAAU,EACN,CACN,IAAMC,EAASC,GAAc,EACvBC,EAAYC,GAChB,IAAI,IAAI,mBAAoBH,EAAO,IAAI,CACzC,EACG,KACCI,GAAW,IAAMC,CAAK,CACxB,EAGIC,EAAWJ,EACd,KACCK,EAAIC,GAAY,CACd,GAAM,CAAC,CAAEC,CAAO,EAAIT,EAAO,KAAK,MAAM,aAAa,EACnD,OAAOQ,EAAS,KAAK,CAAC,CAAE,QAAAE,EAAS,QAAAC,CAAQ,IACvCD,IAAYD,GAAWE,EAAQ,SAASF,CAAO,CAChD,GAAKD,EAAS,CAAC,CAClB,CAAC,CACH,EAGFN,EACG,KACCK,EAAIC,GAAY,IAAI,IAAIA,EAAS,IAAIE,GAAW,CAC9C,GAAG,IAAI,IAAI,MAAMA,EAAQ,OAAO,IAAKV,EAAO,IAAI,CAAC,GACjDU,CACF,CAAC,CAAC,CAAC,EACHE,EAAUC,GAAQC,EAAsB,SAAS,KAAM,OAAO,EAC3D,KACCC,EAAOC,GAAM,CAACA,EAAG,SAAW,CAACA,EAAG,OAAO,EACvCC,GAAeX,CAAQ,EACvBM,EAAU,CAAC,CAACI,EAAIP,CAAO,IAAM,CAC3B,GAAIO,EAAG,kBAAkB,QAAS,CAChC,IAAME,EAAKF,EAAG,OAAO,QAAQ,GAAG,EAChC,GAAIE,GAAM,CAACA,EAAG,QAAUL,EAAK,IAAIK,EAAG,IAAI,EAAG,CACzC,IAAMC,EAAMD,EAAG,KAWf,MAAI,CAACF,EAAG,OAAO,QAAQ,aAAa,GAClBH,EAAK,IAAIM,CAAG,IACZV,EACPJ,GAEXW,EAAG,eAAe,EACXI,EAAGD,CAAG,EACf,CACF,CACA,OAAOd,CACT,CAAC,EACDO,EAAUO,GAAO,CACf,GAAM,CAAE,QAAAT,CAAQ,EAAIG,EAAK,IAAIM,CAAG,EAChC,OAAOE,GAAa,IAAI,IAAIF,CAAG,CAAC,EAC7B,KACCZ,EAAIe,GAAW,CAEb,IAAMC,EADWC,GAAY,EACP,KAAK,QAAQxB,EAAO,KAAM,EAAE,EAClD,OAAOsB,EAAQ,IAAIC,EAAK,MAAM,GAAG,EAAE,CAAC,CAAC,EACjC,IAAI,IAAI,MAAMb,CAAO,IAAIa,CAAI,GAAIvB,EAAO,IAAI,EAC5C,IAAI,IAAImB,CAAG,CACjB,CAAC,CACH,CACJ,CAAC,CACH,CACF,CACF,EACG,UAAUA,GAAOM,GAAYN,EAAK,EAAI,CAAC,EAG5CO,EAAc,CAACxB,EAAWI,CAAQ,CAAC,EAChC,UAAU,CAAC,CAACE,EAAUC,CAAO,IAAM,CACpBkB,EAAW,mBAAmB,EACtC,YAAYC,GAAsBpB,EAAUC,CAAO,CAAC,CAC5D,CAAC,EAGHV,EAAU,KAAKa,EAAU,IAAMN,CAAQ,CAAC,EACrC,UAAUG,GAAW,CA5J1B,IAAAoB,EA+JM,IAAIC,EAAW,SAAS,aAAc,cAAc,EACpD,GAAIA,IAAa,KAAM,CACrBA,EAAW,GAGX,IAAIC,IAAUF,EAAA7B,EAAO,UAAP,YAAA6B,EAAgB,UAAW,SACpC,MAAM,QAAQE,CAAO,IACxBA,EAAU,CAACA,CAAO,GAGpBC,EAAM,QAAWC,KAAUF,EACzB,QAAWrB,KAAWD,EAAQ,QAAQ,OAAOA,EAAQ,OAAO,EAC1D,GAAI,IAAI,OAAOwB,EAAQ,GAAG,EAAE,KAAKvB,CAAO,EAAG,CACzCoB,EAAW,GACX,MAAME,CACR,CAGJ,SAAS,aAAcF,EAAU,cAAc,CACjD,CAGA,GAAIA,EACF,QAAWI,KAAWC,GAAqB,UAAU,EACnDD,EAAQ,OAAS,EACvB,CAAC,CACL,CCrFO,SAASE,GACdC,EAAsB,CAAE,QAAAC,CAAQ,EACP,CAGzB,GAAM,CAAE,aAAAC,CAAa,EAAIC,GAAY,EACjCD,EAAa,IAAI,GAAG,IACtBE,GAAU,SAAU,EAAI,EAGxBJ,EAAG,MAAQE,EAAa,IAAI,GAAG,EAC/BF,EAAG,MAAM,EAGTK,GAAY,QAAQ,EACjB,KACCC,GAAMC,GAAU,CAACA,CAAM,CACzB,EACG,UAAU,IAAM,CACf,IAAMC,EAAML,GAAY,EACxBK,EAAI,aAAa,OAAO,GAAG,EAC3B,QAAQ,aAAa,CAAC,EAAG,GAAI,GAAGA,CAAG,EAAE,CACvC,CAAC,GAIP,IAAMC,EAASC,GAAkBV,CAAE,EAC7BW,EAASC,EACbX,EAAQ,KAAKK,GAAMO,EAAoB,CAAC,EACxCC,EAAUd,EAAI,OAAO,EACrBS,CACF,EACG,KACCM,EAAI,IAAMf,EAAG,KAAK,EAClBgB,EAAqB,CACvB,EAGF,OAAOC,EAAc,CAACN,EAAQF,CAAM,CAAC,EAClC,KACCM,EAAI,CAAC,CAACG,EAAOC,CAAK,KAAO,CAAE,MAAAD,EAAO,MAAAC,CAAM,EAAE,EAC1CC,EAAY,CAAC,CACf,CACJ,CAUO,SAASC,GACdrB,EAAsB,CAAE,QAAAC,CAAQ,EACsB,CACtD,IAAMqB,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGC,GAAQ,EAAI,CAAC,EAGxDT,EAAc,CACZhB,EAAQ,KAAKK,GAAMO,EAAoB,CAAC,EACxCS,CACF,EAAG,CAACK,EAAGC,IAAUA,CAAK,EACnB,KACCC,EAAwB,OAAO,CACjC,EACG,UAAU,CAAC,CAAE,MAAAX,CAAM,IAAMjB,EAAQ,KAAK,CACrC,OACA,KAAMiB,CACR,CAAC,CAAC,EAGNI,EACG,KACCO,EAAwB,OAAO,CACjC,EACG,UAAU,CAAC,CAAE,MAAAV,CAAM,IAAM,CACpBA,GACFf,GAAU,SAAUe,CAAK,CAC7B,CAAC,EAGLL,EAAUd,EAAG,KAAO,OAAO,EACxB,KACC8B,EAAUN,CAAK,CACjB,EACG,UAAU,IAAMxB,EAAG,MAAM,CAAC,EAM/B,IAAM+B,EAAQC,EAAW,uBAAuB,EAChD,OAAAlB,EAAUiB,EAAO,OAAO,EACrB,UAAU,IAAM/B,EAAG,MAAM,CAAC,EAGtBD,GAAiBC,EAAI,CAAE,QAAAC,CAAQ,CAAC,EACpC,KACCgC,EAAIC,GAASZ,EAAM,KAAKY,CAAK,CAAC,EAC9BC,EAAS,IAAMb,EAAM,SAAS,CAAC,EAC/BP,EAAImB,GAAUE,EAAA,CAAE,IAAKpC,GAAOkC,EAAQ,EACpCd,EAAY,CAAC,CACf,CACJ,CCnHO,SAASiB,GACdC,EAAiB,CAAE,QAAAC,EAAS,OAAAC,CAAO,EACE,CACrC,IAAMC,EAAQ,IAAIC,EACZC,EAAYC,GAAqBN,EAAG,aAAc,EACrD,KACCO,EAAO,OAAO,CAChB,EAGIC,EAAYR,EAAG,cAGfS,EAAOC,EAAW,wBAAyBV,CAAE,EAC7CW,EAAOD,EAAW,uBAAwBV,CAAE,EAGlDY,GAAY,QAAQ,EACjB,UAAUC,GAAUF,EAAK,aACxB,OAAQE,EAAS,OAAS,cAC5B,CAAC,EAGHV,EACG,KACCW,GAAeZ,CAAM,EACrBa,GAAUd,EAAQ,KAAKe,GAAMC,EAAoB,CAAC,CAAC,CACrD,EACG,UAAU,CAAC,CAAC,CAAE,MAAAC,CAAM,EAAG,CAAE,MAAAC,CAAM,CAAC,IAAM,CACrC,OAAQD,EAAM,OAAQ,CAGpB,IAAK,GACHT,EAAK,YAAcU,EAAM,OACrBC,GAAY,oBAAoB,EAChCA,GAAY,2BAA2B,EAC3C,MAGF,IAAK,GACHX,EAAK,YAAcW,GAAY,mBAAmB,EAClD,MAGF,QACE,IAAMC,EAAQC,GAAMJ,EAAM,MAAM,EAChCT,EAAK,YAAcW,GAAY,sBAAuBC,CAAK,CAC/D,CACF,CAAC,EAGL,IAAME,EAAUpB,EACb,KACCqB,EAAI,IAAMb,EAAK,UAAY,EAAE,EAC7Bc,EAAU,CAAC,CAAE,MAAAP,CAAM,IAAMQ,EACvBC,EAAG,GAAGT,EAAM,MAAM,EAAG,EAAE,CAAC,EACxBS,EAAG,GAAGT,EAAM,MAAM,EAAE,CAAC,EAClB,KACCU,GAAY,CAAC,EACbC,GAAQxB,CAAS,EACjBoB,EAAU,CAAC,CAACK,CAAK,IAAMA,CAAK,CAC9B,CACJ,CAAC,EACDC,EAAIC,EAAsB,EAC1BC,GAAM,CACR,EAGF,OAAAV,EAAQ,UAAUW,GAAQvB,EAAK,YAAYuB,CAAI,CAAC,EAChDX,EACG,KACCY,GAASD,GAAQ,CACf,IAAME,EAAUC,GAAmB,UAAWH,CAAI,EAClD,OAAI,OAAOE,GAAY,YACdE,EAGFC,EAAUH,EAAS,QAAQ,EAC/B,KACCI,EAAUrC,CAAK,EACf4B,EAAI,IAAMK,CAAO,CACnB,CACJ,CAAC,CACH,EACG,UAAUA,GAAW,CAElBA,EAAQ,OAAS,IACjBA,EAAQ,WAAa5B,EAAU,WAE/BA,EAAU,SAAS,CAAE,IAAK4B,EAAQ,SAAU,CAAC,CACjD,CAAC,EAGWnC,EACb,KACCM,EAAOkC,EAAqB,EAC5BV,EAAI,CAAC,CAAE,KAAAW,CAAK,IAAMA,CAAI,CACxB,EAIC,KACClB,EAAImB,GAASxC,EAAM,KAAKwC,CAAK,CAAC,EAC9BC,EAAS,IAAMzC,EAAM,SAAS,CAAC,EAC/B4B,EAAIY,GAAUE,EAAA,CAAE,IAAK7C,GAAO2C,EAAQ,CACtC,CACJ,CCpHO,SAASG,GACdC,EAAkB,CAAE,OAAAC,CAAO,EACF,CACzB,OAAOA,EACJ,KACCC,EAAI,CAAC,CAAE,MAAAC,CAAM,IAAM,CACjB,IAAMC,EAAMC,GAAY,EACxB,OAAAD,EAAI,KAAO,GAGXD,EAAQA,EACL,QAAQ,OAAQ,GAAG,EACnB,QAAQ,KAAM,KAAK,EACnB,QAAQ,KAAM,KAAK,EAGtBC,EAAI,OAAS,KAAKD,CAAK,GAChB,CAAE,IAAAC,CAAI,CACf,CAAC,CACH,CACJ,CAUO,SAASE,GACdC,EAAuBC,EACa,CACpC,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGC,GAAQ,EAAI,CAAC,EACxD,OAAAJ,EAAM,UAAU,CAAC,CAAE,IAAAL,CAAI,IAAM,CAC3BG,EAAG,aAAa,sBAAuBA,EAAG,IAAI,EAC9CA,EAAG,KAAO,GAAGH,CAAG,EAClB,CAAC,EAGDU,EAAUP,EAAI,OAAO,EAClB,KACCQ,EAAUJ,CAAK,CACjB,EACG,UAAUK,GAAMA,EAAG,eAAe,CAAC,EAGjCjB,GAAiBQ,EAAIC,CAAO,EAChC,KACCS,EAAIC,GAAST,EAAM,KAAKS,CAAK,CAAC,EAC9BC,EAAS,IAAMV,EAAM,SAAS,CAAC,EAC/BP,EAAIgB,GAAUE,EAAA,CAAE,IAAKb,GAAOW,EAAQ,CACtC,CACJ,CCpDO,SAASG,GACdC,EAAiB,CAAE,QAAAC,EAAS,UAAAC,CAAU,EACA,CACtC,IAAMC,EAAQ,IAAIC,EAGZC,EAASC,GAAoB,cAAc,EAC3CC,EAASC,EACbC,EAAUJ,EAAO,SAAS,EAC1BI,EAAUJ,EAAO,OAAO,CAC1B,EACG,KACCK,GAAUC,EAAc,EACxBC,EAAI,IAAMP,EAAM,KAAK,EACrBQ,EAAqB,CACvB,EAGF,OAAAV,EACG,KACCW,GAAkBP,CAAM,EACxBK,EAAI,CAAC,CAAC,CAAE,QAAAG,CAAQ,EAAGC,CAAK,IAAM,CAC5B,IAAMC,EAAQD,EAAM,MAAM,UAAU,EACpC,GAAID,GAAA,MAAAA,EAAS,QAAUE,EAAMA,EAAM,OAAS,CAAC,EAAG,CAC9C,IAAMC,EAAOH,EAAQA,EAAQ,OAAS,CAAC,EACnCG,EAAK,WAAWD,EAAMA,EAAM,OAAS,CAAC,CAAC,IACzCA,EAAMA,EAAM,OAAS,CAAC,EAAIC,EAC9B,MACED,EAAM,OAAS,EAEjB,OAAOA,CACT,CAAC,CACH,EACG,UAAUA,GAASjB,EAAG,UAAYiB,EAChC,KAAK,EAAE,EACP,QAAQ,MAAO,QAAQ,CAC1B,EAGJf,EACG,KACCiB,EAAO,CAAC,CAAE,KAAAC,CAAK,IAAMA,IAAS,QAAQ,CACxC,EACG,UAAUC,GAAO,CAChB,OAAQA,EAAI,KAAM,CAGhB,IAAK,aAEDrB,EAAG,UAAU,QACbK,EAAM,iBAAmBA,EAAM,MAAM,SAErCA,EAAM,MAAQL,EAAG,WACnB,KACJ,CACF,CAAC,EAGWC,EACb,KACCkB,EAAOG,EAAqB,EAC5BV,EAAI,CAAC,CAAE,KAAAW,CAAK,IAAMA,CAAI,CACxB,EAIC,KACCC,EAAIC,GAAStB,EAAM,KAAKsB,CAAK,CAAC,EAC9BC,EAAS,IAAMvB,EAAM,SAAS,CAAC,EAC/BS,EAAI,KAAO,CAAE,IAAKZ,CAAG,EAAE,CACzB,CACJ,CCjDO,SAAS2B,GACdC,EAAiB,CAAE,OAAAC,EAAQ,UAAAC,CAAU,EACN,CAC/B,IAAMC,EAASC,GAAc,EAC7B,GAAI,CACF,IAAMC,EAAUC,GAAkBH,EAAO,OAAQF,CAAM,EAGjDM,EAASC,GAAoB,eAAgBR,CAAE,EAC/CS,EAASD,GAAoB,gBAAiBR,CAAE,EAGtDU,EAAwBV,EAAI,OAAO,EAChC,KACCW,EAAO,CAAC,CAAE,OAAAC,CAAO,IACfA,aAAkB,SAAW,CAAC,CAACA,EAAO,QAAQ,GAAG,CAClD,CACH,EACG,UAAU,IAAMC,GAAU,SAAU,EAAK,CAAC,EAG/CX,EACG,KACCS,EAAO,CAAC,CAAE,KAAAG,CAAK,IAAMA,IAAS,QAAQ,CACxC,EACG,UAAUC,GAAO,CAChB,IAAMC,EAASC,GAAiB,EAChC,OAAQF,EAAI,KAAM,CAGhB,IAAK,QACH,GAAIC,IAAWT,EAAO,CACpB,IAAMW,EAAU,IAAI,IACpB,QAAWC,KAAUC,EACnB,sBAAuBX,CACzB,EAAG,CACD,IAAMY,EAAUF,EAAO,kBACvBD,EAAQ,IAAIC,EAAQ,WAClBE,EAAQ,aAAa,eAAe,CACtC,CAAC,CACH,CAGA,GAAIH,EAAQ,KAAM,CAChB,GAAM,CAAC,CAACI,CAAI,CAAC,EAAI,CAAC,GAAGJ,CAAO,EAAE,KAAK,CAAC,CAAC,CAAEK,CAAC,EAAG,CAAC,CAAEC,CAAC,IAAMA,EAAID,CAAC,EAC1DD,EAAK,MAAM,CACb,CAGAP,EAAI,MAAM,CACZ,CACA,MAGF,IAAK,SACL,IAAK,MACHF,GAAU,SAAU,EAAK,EACzBN,EAAM,KAAK,EACX,MAGF,IAAK,UACL,IAAK,YACH,GAAI,OAAOS,GAAW,YACpBT,EAAM,MAAM,MACP,CACL,IAAMkB,EAAM,CAAClB,EAAO,GAAGa,EACrB,wDACAX,CACF,CAAC,EACKiB,EAAI,KAAK,IAAI,GACjB,KAAK,IAAI,EAAGD,EAAI,QAAQT,CAAM,CAAC,EAAIS,EAAI,QACrCV,EAAI,OAAS,UAAY,GAAK,IAE9BU,EAAI,MAAM,EACdA,EAAIC,CAAC,EAAE,MAAM,CACf,CAGAX,EAAI,MAAM,EACV,MAGF,QACMR,IAAUU,GAAiB,GAC7BV,EAAM,MAAM,CAClB,CACF,CAAC,EAGLL,EACG,KACCS,EAAO,CAAC,CAAE,KAAAG,CAAK,IAAMA,IAAS,QAAQ,CACxC,EACG,UAAUC,GAAO,CAChB,OAAQA,EAAI,KAAM,CAGhB,IAAK,IACL,IAAK,IACL,IAAK,IACHR,EAAM,MAAM,EACZA,EAAM,OAAO,EAGbQ,EAAI,MAAM,EACV,KACJ,CACF,CAAC,EAGL,IAAMY,EAASC,GAAiBrB,EAAO,CAAE,QAAAF,CAAQ,CAAC,EAClD,OAAOwB,EACLF,EACAG,GAAkBrB,EAAQ,CAAE,QAAAJ,EAAS,OAAAsB,CAAO,CAAC,CAC/C,EACG,KACCI,GAGE,GAAGC,GAAqB,eAAgBhC,CAAE,EACvC,IAAIiC,GAASC,GAAiBD,EAAO,CAAE,OAAAN,CAAO,CAAC,CAAC,EAGnD,GAAGK,GAAqB,iBAAkBhC,CAAE,EACzC,IAAIiC,GAASE,GAAmBF,EAAO,CAAE,QAAA5B,EAAS,UAAAH,CAAU,CAAC,CAAC,CACnE,CACF,CAGJ,OAASkC,EAAK,CACZ,OAAApC,EAAG,OAAS,GACLqC,EACT,CACF,CCnKO,SAASC,GACdC,EAAiB,CAAE,OAAAC,EAAQ,UAAAC,CAAU,EACG,CACxC,OAAOC,EAAc,CACnBF,EACAC,EACG,KACCE,EAAUC,GAAY,CAAC,EACvBC,EAAOC,GAAO,CAAC,CAACA,EAAI,aAAa,IAAI,GAAG,CAAC,CAC3C,CACJ,CAAC,EACE,KACCC,EAAI,CAAC,CAACC,EAAOF,CAAG,IAAMG,GAAuBD,EAAM,MAAM,EACvDF,EAAI,aAAa,IAAI,GAAG,CAC1B,CAAC,EACDC,EAAIG,GAAM,CA1FhB,IAAAC,EA2FQ,IAAMC,EAAQ,IAAI,IAGZC,EAAK,SAAS,mBAAmBd,EAAI,WAAW,SAAS,EAC/D,QAASe,EAAOD,EAAG,SAAS,EAAGC,EAAMA,EAAOD,EAAG,SAAS,EACtD,IAAIF,EAAAG,EAAK,gBAAL,MAAAH,EAAoB,aAAc,CACpC,IAAMI,EAAWD,EAAK,YAChBE,EAAWN,EAAGK,CAAQ,EACxBC,EAAS,OAASD,EAAS,QAC7BH,EAAM,IAAIE,EAAmBE,CAAQ,CACzC,CAIF,OAAW,CAACF,EAAMG,CAAI,IAAKL,EAAO,CAChC,GAAM,CAAE,WAAAM,CAAW,EAAIC,EAAE,OAAQ,KAAMF,CAAI,EAC3CH,EAAK,YAAY,GAAG,MAAM,KAAKI,CAAU,CAAC,CAC5C,CAGA,MAAO,CAAE,IAAKnB,EAAI,MAAAa,CAAM,CAC1B,CAAC,CACH,CACJ,CCPO,SAASQ,GACdC,EAAiB,CAAE,UAAAC,EAAW,MAAAC,CAAM,EACf,CACrB,IAAMC,EAASH,EAAG,QAAqB,UAAU,EAC3CI,EACJD,EAAO,UACPA,EAAO,cAAe,UAGxB,OAAOE,EAAc,CAACH,EAAOD,CAAS,CAAC,EACpC,KACCK,EAAI,CAAC,CAAC,CAAE,OAAAC,EAAQ,OAAAC,CAAO,EAAG,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,CAAC,KACzCD,EAASA,EACL,KAAK,IAAIJ,EAAQ,KAAK,IAAI,EAAGK,EAAIF,CAAM,CAAC,EACxCH,EACG,CACL,OAAAI,EACA,OAAQC,GAAKF,EAASH,CACxB,EACD,EACDM,EAAqB,CAACC,EAAGC,IACvBD,EAAE,SAAWC,EAAE,QACfD,EAAE,SAAWC,EAAE,MAChB,CACH,CACJ,CAuBO,SAASC,GACdb,EAAiBc,EACe,CADf,IAAAC,EAAAD,EAAE,SAAAE,CA5JrB,EA4JmBD,EAAcE,EAAAC,GAAdH,EAAc,CAAZ,YAEnB,IAAMI,EAAQC,EAAW,0BAA2BpB,CAAE,EAChD,CAAE,EAAAS,CAAE,EAAIY,GAAiBF,CAAK,EACpC,OAAOG,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGC,GAAQ,EAAI,CAAC,EAClDC,EAAQL,EACX,KACCM,GAAU,EAAGC,EAAuB,CACtC,EAGF,OAAAF,EAAM,KAAKG,GAAef,CAAO,CAAC,EAC/B,UAAU,CAGT,KAAK,CAAC,CAAE,OAAAR,CAAO,EAAG,CAAE,OAAQD,CAAO,CAAC,EAAG,CACrCY,EAAM,MAAM,OAAS,GAAGX,EAAS,EAAIC,CAAC,KACtCT,EAAG,MAAM,IAAY,GAAGO,CAAM,IAChC,EAGA,UAAW,CACTY,EAAM,MAAM,OAAS,GACrBnB,EAAG,MAAM,IAAY,EACvB,CACF,CAAC,EAGH4B,EAAM,KAAKI,GAAM,CAAC,EACf,UAAU,IAAM,CACf,QAAWC,KAAQC,EAAY,8BAA+BlC,CAAE,EAAG,CACjE,GAAI,CAACiC,EAAK,aACR,SACF,IAAME,EAAYF,EAAK,QAAqB,yBAAyB,EACrE,GAAI,OAAOE,GAAc,YAAa,CACpC,IAAM5B,EAAS0B,EAAK,UAAYE,EAAU,UACpC,CAAE,OAAA3B,CAAO,EAAI4B,GAAeD,CAAS,EAC3CA,EAAU,SAAS,CACjB,IAAK5B,EAASC,EAAS,CACzB,CAAC,CACH,CACF,CACF,CAAC,EAGH6B,GAAKH,EAA8B,kBAAmBlC,CAAE,CAAC,EACtD,KACCsC,GAASC,GAASC,EAAUD,EAAO,OAAO,EACvC,KACCE,GAAUC,EAAc,EACxBpC,EAAI,IAAMiC,CAAK,EACfI,EAAUlB,CAAK,CACjB,CACF,CACF,EACG,UAAUc,GAAS,CAClB,IAAMK,EAAQxB,EAA6B,QAAQmB,EAAM,OAAO,IAAI,EACxDnB,EAAW,qBAAqBmB,EAAM,EAAE,IAAI,EACpD,aAAa,gBAAiB,GAAGK,EAAM,OAAO,EAAE,CACtD,CAAC,EAGE7C,GAAaC,EAAIiB,CAAO,EAC5B,KACC4B,EAAIC,GAASvB,EAAM,KAAKuB,CAAK,CAAC,EAC9BC,EAAS,IAAMxB,EAAM,SAAS,CAAC,EAC/BjB,EAAIwC,GAAUE,EAAA,CAAE,IAAKhD,GAAO8C,EAAQ,CACtC,CACJ,CAAC,CACH,CCxKO,SAASG,GACdC,EAAcC,EACW,CACzB,GAAI,OAAOA,GAAS,YAAa,CAC/B,IAAMC,EAAM,gCAAgCF,CAAI,IAAIC,CAAI,GACxD,OAAOE,GAGLC,GAAqB,GAAGF,CAAG,kBAAkB,EAC1C,KACCG,GAAW,IAAMC,CAAK,EACtBC,EAAIC,IAAY,CACd,QAASA,EAAQ,QACnB,EAAE,EACFC,GAAe,CAAC,CAAC,CACnB,EAGFL,GAAkBF,CAAG,EAClB,KACCG,GAAW,IAAMC,CAAK,EACtBC,EAAIG,IAAS,CACX,MAAOA,EAAK,iBACZ,MAAOA,EAAK,WACd,EAAE,EACFD,GAAe,CAAC,CAAC,CACnB,CACJ,EACG,KACCF,EAAI,CAAC,CAACC,EAASE,CAAI,IAAOC,IAAA,GAAKH,GAAYE,EAAO,CACpD,CAGJ,KAAO,CACL,IAAMR,EAAM,gCAAgCF,CAAI,GAChD,OAAOI,GAAkBF,CAAG,EACzB,KACCK,EAAIG,IAAS,CACX,aAAcA,EAAK,YACrB,EAAE,EACFD,GAAe,CAAC,CAAC,CACnB,CACJ,CACF,CCvDO,SAASG,GACdC,EAAcC,EACW,CACzB,IAAMC,EAAM,WAAWF,CAAI,oBAAoB,mBAAmBC,CAAO,CAAC,GAC1E,OAAOE,GAA2BD,CAAG,EAClC,KACCE,GAAW,IAAMC,CAAK,EACtBC,EAAI,CAAC,CAAE,WAAAC,EAAY,YAAAC,CAAY,KAAO,CACpC,MAAOD,EACP,MAAOC,CACT,EAAE,EACFC,GAAe,CAAC,CAAC,CACnB,CACJ,CCOO,SAASC,GACdC,EACyB,CAGzB,IAAIC,EAAQD,EAAI,MAAM,qCAAqC,EAC3D,GAAIC,EAAO,CACT,GAAM,CAAC,CAAEC,EAAMC,CAAI,EAAIF,EACvB,OAAOG,GAA2BF,EAAMC,CAAI,CAC9C,CAIA,GADAF,EAAQD,EAAI,MAAM,oCAAoC,EAClDC,EAAO,CACT,GAAM,CAAC,CAAEI,EAAMC,CAAI,EAAIL,EACvB,OAAOM,GAA2BF,EAAMC,CAAI,CAC9C,CAGA,OAAOE,CACT,CCpBA,IAAIC,GAgBG,SAASC,GACdC,EACoB,CACpB,OAAOF,QAAWG,EAAM,IAAM,CAC5B,IAAMC,EAAS,SAAsB,WAAY,cAAc,EAC/D,GAAIA,EACF,OAAOC,EAAGD,CAAM,EAKhB,GADYE,GAAqB,SAAS,EAClC,OAAQ,CACd,IAAMC,EAAU,SAA0B,WAAW,EACrD,GAAI,EAAEA,GAAWA,EAAQ,QACvB,OAAOC,CACX,CAGA,OAAOC,GAAiBP,EAAG,IAAI,EAC5B,KACCQ,EAAIC,GAAS,SAAS,WAAYA,EAAO,cAAc,CAAC,CAC1D,CAEN,CAAC,EACE,KACCC,GAAW,IAAMJ,CAAK,EACtBK,EAAOF,GAAS,OAAO,KAAKA,CAAK,EAAE,OAAS,CAAC,EAC7CG,EAAIH,IAAU,CAAE,MAAAA,CAAM,EAAE,EACxBI,EAAY,CAAC,CACf,EACJ,CASO,SAASC,GACdd,EAC+B,CAC/B,IAAMe,EAAQC,EAAW,uBAAwBhB,CAAE,EACnD,OAAOC,EAAM,IAAM,CACjB,IAAMgB,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,MAAAR,CAAM,IAAM,CAC7BM,EAAM,YAAYI,GAAkBV,CAAK,CAAC,EAC1CM,EAAM,UAAU,IAAI,+BAA+B,CACrD,CAAC,EAGMhB,GAAYC,CAAE,EAClB,KACCQ,EAAIY,GAASH,EAAM,KAAKG,CAAK,CAAC,EAC9BC,EAAS,IAAMJ,EAAM,SAAS,CAAC,EAC/BL,EAAIQ,GAAUE,EAAA,CAAE,IAAKtB,GAAOoB,EAAQ,CACtC,CACJ,CAAC,CACH,CCtDO,SAASG,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACpB,CAClB,OAAOC,GAAiB,SAAS,IAAI,EAClC,KACCC,EAAU,IAAMC,GAAgBL,EAAI,CAAE,QAAAE,EAAS,UAAAD,CAAU,CAAC,CAAC,EAC3DK,EAAI,CAAC,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,KACZ,CACL,OAAQA,GAAK,EACf,EACD,EACDC,EAAwB,QAAQ,CAClC,CACJ,CAaO,SAASC,GACdT,EAAiBU,EACY,CAC7B,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAE,CAAO,EAAG,CACfd,EAAG,OAASc,CACd,EAGA,UAAW,CACTd,EAAG,OAAS,EACd,CACF,CAAC,GAICe,EAAQ,wBAAwB,EAC5BC,EAAG,CAAE,OAAQ,EAAM,CAAC,EACpBjB,GAAUC,EAAIU,CAAO,GAExB,KACCO,EAAIC,GAASN,EAAM,KAAKM,CAAK,CAAC,EAC9BC,EAAS,IAAMP,EAAM,SAAS,CAAC,EAC/BN,EAAIY,GAAUE,EAAA,CAAE,IAAKpB,GAAOkB,EAAQ,CACtC,CACJ,CAAC,CACH,CCfO,SAASG,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACT,CAC7B,IAAMC,EAAQ,IAAI,IAGZC,EAAUC,EAA+B,gBAAiBL,CAAE,EAClE,QAAWM,KAAUF,EAAS,CAC5B,IAAMG,EAAK,mBAAmBD,EAAO,KAAK,UAAU,CAAC,CAAC,EAChDE,EAASC,GAAmB,QAAQF,CAAE,IAAI,EAC5C,OAAOC,GAAW,aACpBL,EAAM,IAAIG,EAAQE,CAAM,CAC5B,CAGA,IAAME,EAAUR,EACb,KACCS,EAAwB,QAAQ,EAChCC,EAAI,CAAC,CAAE,OAAAC,CAAO,IAAM,CAClB,IAAMC,EAAOC,GAAoB,MAAM,EACjCC,EAAOC,EAAW,wBAAyBH,CAAI,EACrD,OAAOD,EAAS,IACdG,EAAK,UACLF,EAAK,UAET,CAAC,EACDI,GAAM,CACR,EAqFF,OAlFmBC,GAAiB,SAAS,IAAI,EAC9C,KACCR,EAAwB,QAAQ,EAGhCS,EAAUC,GAAQC,EAAM,IAAM,CAC5B,IAAIC,EAA4B,CAAC,EACjC,OAAOC,EAAG,CAAC,GAAGrB,CAAK,EAAE,OAAO,CAACsB,EAAO,CAACnB,EAAQE,CAAM,IAAM,CACvD,KAAOe,EAAK,QACGpB,EAAM,IAAIoB,EAAKA,EAAK,OAAS,CAAC,CAAC,EACnC,SAAWf,EAAO,SACzBe,EAAK,IAAI,EAOb,IAAIG,EAASlB,EAAO,UACpB,KAAO,CAACkB,GAAUlB,EAAO,eACvBA,EAASA,EAAO,cAChBkB,EAASlB,EAAO,UAIlB,IAAImB,EAASnB,EAAO,aACpB,KAAOmB,EAAQA,EAASA,EAAO,aAC7BD,GAAUC,EAAO,UAGnB,OAAOF,EAAM,IACX,CAAC,GAAGF,EAAO,CAAC,GAAGA,EAAMjB,CAAM,CAAC,EAAE,QAAQ,EACtCoB,CACF,CACF,EAAG,IAAI,GAAkC,CAAC,CAC5C,CAAC,EACE,KAGCd,EAAIa,GAAS,IAAI,IAAI,CAAC,GAAGA,CAAK,EAAE,KAAK,CAAC,CAAC,CAAEG,CAAC,EAAG,CAAC,CAAEC,CAAC,IAAMD,EAAIC,CAAC,CAAC,CAAC,EAC9DC,GAAkBpB,CAAO,EAGzBU,EAAU,CAAC,CAACK,EAAOM,CAAM,IAAM9B,EAC5B,KACC+B,GAAK,CAAC,CAACC,EAAMC,CAAI,EAAG,CAAE,OAAQ,CAAE,EAAAC,CAAE,EAAG,KAAAC,CAAK,IAAM,CAC9C,IAAMC,EAAOF,EAAIC,EAAK,QAAU,KAAK,MAAMf,EAAK,MAAM,EAGtD,KAAOa,EAAK,QAAQ,CAClB,GAAM,CAAC,CAAER,CAAM,EAAIQ,EAAK,CAAC,EACzB,GAAIR,EAASK,EAASI,GAAKE,EACzBJ,EAAO,CAAC,GAAGA,EAAMC,EAAK,MAAM,CAAE,MAE9B,MAEJ,CAGA,KAAOD,EAAK,QAAQ,CAClB,GAAM,CAAC,CAAEP,CAAM,EAAIO,EAAKA,EAAK,OAAS,CAAC,EACvC,GAAIP,EAASK,GAAUI,GAAK,CAACE,EAC3BH,EAAO,CAACD,EAAK,IAAI,EAAI,GAAGC,CAAI,MAE5B,MAEJ,CAGA,MAAO,CAACD,EAAMC,CAAI,CACpB,EAAG,CAAC,CAAC,EAAG,CAAC,GAAGT,CAAK,CAAC,CAAC,EACnBa,EAAqB,CAACV,EAAGC,IACvBD,EAAE,CAAC,IAAMC,EAAE,CAAC,GACZD,EAAE,CAAC,IAAMC,EAAE,CAAC,CACb,CACH,CACF,CACF,CACF,CACF,EAIC,KACCjB,EAAI,CAAC,CAACqB,EAAMC,CAAI,KAAO,CACrB,KAAMD,EAAK,IAAI,CAAC,CAACV,CAAI,IAAMA,CAAI,EAC/B,KAAMW,EAAK,IAAI,CAAC,CAACX,CAAI,IAAMA,CAAI,CACjC,EAAE,EAGFgB,EAAU,CAAE,KAAM,CAAC,EAAG,KAAM,CAAC,CAAE,CAAC,EAChCC,GAAY,EAAG,CAAC,EAChB5B,EAAI,CAAC,CAAC,EAAGiB,CAAC,IAGJ,EAAE,KAAK,OAASA,EAAE,KAAK,OAClB,CACL,KAAMA,EAAE,KAAK,MAAM,KAAK,IAAI,EAAG,EAAE,KAAK,OAAS,CAAC,EAAGA,EAAE,KAAK,MAAM,EAChE,KAAM,CAAC,CACT,EAIO,CACL,KAAMA,EAAE,KAAK,MAAM,EAAE,EACrB,KAAMA,EAAE,KAAK,MAAM,EAAGA,EAAE,KAAK,OAAS,EAAE,KAAK,MAAM,CACrD,CAEH,CACH,CACJ,CAYO,SAASY,GACdzC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,EAAS,MAAAwC,EAAO,QAAAC,CAAQ,EACd,CACxC,OAAOrB,EAAM,IAAM,CACjB,IAAMsB,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGC,GAAQ,EAAI,CAAC,EAoBxD,GAnBAJ,EAAM,UAAU,CAAC,CAAE,KAAAX,EAAM,KAAAC,CAAK,IAAM,CAGlC,OAAW,CAAC5B,CAAM,IAAK4B,EACrB5B,EAAO,UAAU,OAAO,sBAAsB,EAC9CA,EAAO,UAAU,OAAO,sBAAsB,EAIhD,OAAW,CAACmB,EAAO,CAACnB,CAAM,CAAC,IAAK2B,EAAK,QAAQ,EAC3C3B,EAAO,UAAU,IAAI,sBAAsB,EAC3CA,EAAO,UAAU,OACf,uBACAmB,IAAUQ,EAAK,OAAS,CAC1B,CAEJ,CAAC,EAGGgB,EAAQ,YAAY,EAAG,CAGzB,IAAMC,EAAUC,EACdlD,EAAU,KAAKmD,GAAa,CAAC,EAAGxC,EAAI,IAAG,EAAY,CAAC,EACpDX,EAAU,KAAKmD,GAAa,GAAG,EAAGxC,EAAI,IAAM,QAAiB,CAAC,CAChE,EAGAgC,EACG,KACCS,EAAO,CAAC,CAAE,KAAApB,CAAK,IAAMA,EAAK,OAAS,CAAC,EACpCH,GAAkBY,EAAM,KAAKY,GAAUC,EAAc,CAAC,CAAC,EACvDC,GAAeN,CAAO,CACxB,EACG,UAAU,CAAC,CAAC,CAAC,CAAE,KAAAjB,CAAK,CAAC,EAAGwB,CAAQ,IAAM,CACrC,GAAM,CAACnD,CAAM,EAAI2B,EAAKA,EAAK,OAAS,CAAC,EACrC,GAAI3B,EAAO,aAAc,CAGvB,IAAMoD,EAAYC,GAAoBrD,CAAM,EAC5C,GAAI,OAAOoD,GAAc,YAAa,CACpC,IAAMhC,EAASpB,EAAO,UAAYoD,EAAU,UACtC,CAAE,OAAA7C,CAAO,EAAI+C,GAAeF,CAAS,EAC3CA,EAAU,SAAS,CACjB,IAAKhC,EAASb,EAAS,EACvB,SAAA4C,CACF,CAAC,CACH,CACF,CACF,CAAC,CACP,CAGA,OAAIR,EAAQ,qBAAqB,GAC/BhD,EACG,KACC4D,EAAUf,CAAK,EACfnC,EAAwB,QAAQ,EAChCyC,GAAa,GAAG,EAChBU,GAAK,CAAC,EACND,EAAUlB,EAAQ,KAAKmB,GAAK,CAAC,CAAC,CAAC,EAC/BC,GAAO,CAAE,MAAO,GAAI,CAAC,EACrBP,GAAeZ,CAAK,CACtB,EACG,UAAU,CAAC,CAAC,CAAE,CAAE,KAAAX,CAAK,CAAC,IAAM,CAC3B,IAAM+B,EAAMC,GAAY,EAGlB3D,EAAS2B,EAAKA,EAAK,OAAS,CAAC,EACnC,GAAI3B,GAAUA,EAAO,OAAQ,CAC3B,GAAM,CAAC4D,CAAM,EAAI5D,EACX,CAAE,KAAA6D,CAAK,EAAI,IAAI,IAAID,EAAO,IAAI,EAChCF,EAAI,OAASG,IACfH,EAAI,KAAOG,EACX,QAAQ,aAAa,CAAC,EAAG,GAAI,GAAGH,CAAG,EAAE,EAIzC,MACEA,EAAI,KAAO,GACX,QAAQ,aAAa,CAAC,EAAG,GAAI,GAAGA,CAAG,EAAE,CAEzC,CAAC,EAGAjE,GAAqBC,EAAI,CAAE,UAAAC,EAAW,QAAAC,CAAQ,CAAC,EACnD,KACCkE,EAAIC,GAASzB,EAAM,KAAKyB,CAAK,CAAC,EAC9BC,EAAS,IAAM1B,EAAM,SAAS,CAAC,EAC/BhC,EAAIyD,GAAUE,EAAA,CAAE,IAAKvE,GAAOqE,EAAQ,CACtC,CACJ,CAAC,CACH,CC9RO,SAASG,GACdC,EAAkB,CAAE,UAAAC,EAAW,MAAAC,EAAO,QAAAC,CAAQ,EACvB,CAGvB,IAAMC,EAAaH,EAChB,KACCI,EAAI,CAAC,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,IAAMA,CAAC,EAC5BC,GAAY,EAAG,CAAC,EAChBF,EAAI,CAAC,CAACG,EAAGC,CAAC,IAAMD,EAAIC,GAAKA,EAAI,CAAC,EAC9BC,EAAqB,CACvB,EAGIC,EAAUT,EACb,KACCG,EAAI,CAAC,CAAE,OAAAO,CAAO,IAAMA,CAAM,CAC5B,EAGF,OAAOC,EAAc,CAACF,EAASP,CAAU,CAAC,EACvC,KACCC,EAAI,CAAC,CAACO,EAAQE,CAAS,IAAM,EAAEF,GAAUE,EAAU,EACnDJ,EAAqB,EACrBK,EAAUZ,EAAQ,KAAKa,GAAK,CAAC,CAAC,CAAC,EAC/BC,GAAQ,EAAI,EACZC,GAAO,CAAE,MAAO,GAAI,CAAC,EACrBb,EAAIc,IAAW,CAAE,OAAAA,CAAO,EAAE,CAC5B,CACJ,CAYO,SAASC,GACdC,EAAiB,CAAE,UAAApB,EAAW,QAAAqB,EAAS,MAAApB,EAAO,QAAAC,CAAQ,EACpB,CAClC,IAAMoB,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAe,EAAGT,GAAQ,EAAI,CAAC,EACxD,OAAAM,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAJ,CAAO,EAAG,CACfE,EAAG,OAASF,EACRA,GACFE,EAAG,aAAa,WAAY,IAAI,EAChCA,EAAG,KAAK,GAERA,EAAG,gBAAgB,UAAU,CAEjC,EAGA,UAAW,CACTA,EAAG,MAAM,IAAM,GACfA,EAAG,OAAS,GACZA,EAAG,gBAAgB,UAAU,CAC/B,CACF,CAAC,EAGDC,EACG,KACCP,EAAUU,CAAK,EACfE,EAAwB,QAAQ,CAClC,EACG,UAAU,CAAC,CAAE,OAAAC,CAAO,IAAM,CACzBP,EAAG,MAAM,IAAM,GAAGO,EAAS,EAAE,IAC/B,CAAC,EAGLC,EAAUR,EAAI,OAAO,EAClB,UAAUS,GAAM,CACfA,EAAG,eAAe,EAClB,OAAO,SAAS,CAAE,IAAK,CAAE,CAAC,CAC5B,CAAC,EAGI/B,GAAesB,EAAI,CAAE,UAAApB,EAAW,MAAAC,EAAO,QAAAC,CAAQ,CAAC,EACpD,KACC4B,EAAIC,GAAST,EAAM,KAAKS,CAAK,CAAC,EAC9BC,EAAS,IAAMV,EAAM,SAAS,CAAC,EAC/BlB,EAAI2B,GAAUE,EAAA,CAAE,IAAKb,GAAOW,EAAQ,CACtC,CACJ,CCtHO,SAASG,GACd,CAAE,UAAAC,CAAU,EACN,CACNA,EACG,KACCC,EAAU,IAAMC,EAAY,cAAc,CAAC,EAC3CC,GAASC,GAAMC,GAAuBD,CAAE,EACrC,KACCE,EAAUN,EAAU,KAAKO,GAAK,CAAC,CAAC,CAAC,EACjCC,EAAOC,GAAWA,CAAO,EACzBC,EAAI,IAAMN,CAAE,EACZO,GAAK,CAAC,CACR,CACF,EACAH,EAAOJ,GAAMA,EAAG,YAAcA,EAAG,WAAW,EAC5CD,GAASC,GAAM,CACb,IAAMQ,EAAOR,EAAG,UACVS,EAAOT,EAAG,QAAQ,GAAG,GAAKA,EAChC,OAAAS,EAAK,MAAQD,EAGNE,GAAaD,CAAI,EACrB,KACCP,EAAUN,EAAU,KAAKO,GAAK,CAAC,CAAC,CAAC,EACjCQ,EAAS,IAAMF,EAAK,gBAAgB,OAAO,CAAC,CAC9C,CACJ,CAAC,CACH,EACG,UAAU,EAGfb,EACG,KACCC,EAAU,IAAMC,EAAY,YAAY,CAAC,EACzCC,GAASC,GAAMU,GAAaV,CAAE,CAAC,CACjC,EACG,UAAU,CACjB,CC3CO,SAASY,GACd,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACf,CACND,EACG,KACCE,EAAU,IAAMC,EACd,2BACF,CAAC,EACDC,EAAIC,GAAM,CACRA,EAAG,cAAgB,GACnBA,EAAG,QAAU,EACf,CAAC,EACDC,GAASD,GAAME,EAAUF,EAAI,QAAQ,EAClC,KACCG,GAAU,IAAMH,EAAG,UAAU,SAAS,0BAA0B,CAAC,EACjEI,EAAI,IAAMJ,CAAE,CACd,CACF,EACAK,GAAeT,CAAO,CACxB,EACG,UAAU,CAAC,CAACI,EAAIM,CAAM,IAAM,CAC3BN,EAAG,UAAU,OAAO,0BAA0B,EAC1CM,IACFN,EAAG,QAAU,GACjB,CAAC,CACP,CC9BA,SAASO,IAAyB,CAChC,MAAO,qBAAqB,KAAK,UAAU,SAAS,CACtD,CAiBO,SAASC,GACd,CAAE,UAAAC,CAAU,EACN,CACNA,EACG,KACCC,EAAU,IAAMC,EAAY,qBAAqB,CAAC,EAClDC,EAAIC,GAAMA,EAAG,gBAAgB,mBAAmB,CAAC,EACjDC,EAAOP,EAAa,EACpBQ,GAASF,GAAMG,EAAUH,EAAI,YAAY,EACtC,KACCI,EAAI,IAAMJ,CAAE,CACd,CACF,CACF,EACG,UAAUA,GAAM,CACf,IAAMK,EAAML,EAAG,UAGXK,IAAQ,EACVL,EAAG,UAAY,EAGNK,EAAML,EAAG,eAAiBA,EAAG,eACtCA,EAAG,UAAYK,EAAM,EAEzB,CAAC,CACP,CCpCO,SAASC,GACd,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACf,CACNC,EAAc,CAACC,GAAY,QAAQ,EAAGF,CAAO,CAAC,EAC3C,KACCG,EAAI,CAAC,CAACC,EAAQC,CAAM,IAAMD,GAAU,CAACC,CAAM,EAC3CC,EAAUF,GAAUG,EAAGH,CAAM,EAC1B,KACCI,GAAMJ,EAAS,IAAM,GAAG,CAC1B,CACF,EACAK,GAAeV,CAAS,CAC1B,EACG,UAAU,CAAC,CAACK,EAAQ,CAAE,OAAQ,CAAE,EAAAM,CAAE,CAAC,CAAC,IAAM,CACzC,GAAIN,EACF,SAAS,KAAK,aAAa,qBAAsB,EAAE,EACnD,SAAS,KAAK,MAAM,IAAM,IAAIM,CAAC,SAC1B,CACL,IAAMC,EAAQ,GAAK,SAAS,SAAS,KAAK,MAAM,IAAK,EAAE,EACvD,SAAS,KAAK,gBAAgB,oBAAoB,EAClD,SAAS,KAAK,MAAM,IAAM,GACtBA,GACF,OAAO,SAAS,EAAGA,CAAK,CAC5B,CACF,CAAC,CACP,CC7DK,OAAO,UACV,OAAO,QAAU,SAAUC,EAAa,CACtC,IAAMC,EAA2B,CAAC,EAClC,QAAWC,KAAO,OAAO,KAAKF,CAAG,EAE/BC,EAAK,KAAK,CAACC,EAAKF,EAAIE,CAAG,CAAC,CAAC,EAG3B,OAAOD,CACT,GAGG,OAAO,SACV,OAAO,OAAS,SAAUD,EAAa,CACrC,IAAMC,EAAiB,CAAC,EACxB,QAAWC,KAAO,OAAO,KAAKF,CAAG,EAE/BC,EAAK,KAAKD,EAAIE,CAAG,CAAC,EAGpB,OAAOD,CACT,GAKE,OAAO,SAAY,cAGhB,QAAQ,UAAU,WACrB,QAAQ,UAAU,SAAW,SAC3BE,EAA8BC,EACxB,CACF,OAAOD,GAAM,UACf,KAAK,WAAaA,EAAE,KACpB,KAAK,UAAYA,EAAE,MAEnB,KAAK,WAAaA,EAClB,KAAK,UAAYC,EAErB,GAGG,QAAQ,UAAU,cACrB,QAAQ,UAAU,YAAc,YAC3BC,EACG,CACN,IAAMC,EAAS,KAAK,WACpB,GAAIA,EAAQ,CACND,EAAM,SAAW,GACnBC,EAAO,YAAY,IAAI,EAGzB,QAASC,EAAIF,EAAM,OAAS,EAAGE,GAAK,EAAGA,IAAK,CAC1C,IAAIC,EAAOH,EAAME,CAAC,EACd,OAAOC,GAAS,SAClBA,EAAO,SAAS,eAAeA,CAAI,EAC5BA,EAAK,YACZA,EAAK,WAAW,YAAYA,CAAI,EAG7BD,EAGHD,EAAO,aAAa,KAAK,gBAAkBE,CAAI,EAF/CF,EAAO,aAAaE,EAAM,IAAI,CAGlC,CACF,CACF,IpMMJ,SAASC,IAA4C,CACnD,OAAI,SAAS,WAAa,QACjBC,GACL,GAAG,IAAI,IAAI,yBAA0BC,GAAO,IAAI,CAAC,EACnD,EACG,KAECC,EAAI,IAAM,OAAO,EACjBC,EAAY,CAAC,CACf,EAEKC,GACL,IAAI,IAAI,2BAA4BH,GAAO,IAAI,CACjD,CAEJ,CAOA,SAAS,gBAAgB,UAAU,OAAO,OAAO,EACjD,SAAS,gBAAgB,UAAU,IAAI,IAAI,EAG3C,IAAMI,GAAYC,GAAc,EAC1BC,GAAYC,GAAc,EAC1BC,GAAYC,GAAoBH,EAAS,EACzCI,GAAYC,GAAc,EAG1BC,GAAYC,GAAc,EAC1BC,GAAYC,GAAW,oBAAoB,EAC3CC,GAAYD,GAAW,qBAAqB,EAC5CE,GAAYC,GAAW,EAGvBlB,GAASmB,GAAc,EACvBC,GAAS,SAAS,MAAM,UAAU,QAAQ,EAC5CtB,GAAiB,EACjBuB,GAGEC,GAAS,IAAIC,EACnBC,GAAiB,CAAE,OAAAF,EAAO,CAAC,EAG3B,IAAMG,GAAY,IAAIF,EAGlBG,EAAQ,oBAAoB,GAC9BC,GAAuB,CAAE,UAAArB,GAAW,UAAAM,GAAW,UAAAa,EAAU,CAAC,EACvD,UAAUrB,EAAS,EAzJxB,IAAAwB,KA4JIA,GAAA5B,GAAO,UAAP,YAAA4B,GAAgB,YAAa,QAC/BC,GAAqB,CAAE,UAAAzB,EAAU,CAAC,EAGpC0B,EAAMxB,GAAWE,EAAO,EACrB,KACCuB,GAAM,GAAG,CACX,EACG,UAAU,IAAM,CACfC,GAAU,SAAU,EAAK,EACzBA,GAAU,SAAU,EAAK,CAC3B,CAAC,EAGLtB,GACG,KACCuB,EAAO,CAAC,CAAE,KAAAC,CAAK,IAAMA,IAAS,QAAQ,CACxC,EACG,UAAUC,GAAO,CAChB,OAAQA,EAAI,KAAM,CAGhB,IAAK,IACL,IAAK,IACH,IAAMC,EAAOC,GAAoC,gBAAgB,EAC7D,OAAOD,GAAS,aAClBE,GAAYF,CAAI,EAClB,MAGF,IAAK,IACL,IAAK,IACH,IAAMG,EAAOF,GAAoC,gBAAgB,EAC7D,OAAOE,GAAS,aAClBD,GAAYC,CAAI,EAClB,MAGF,IAAK,QACH,IAAMC,EAASC,GAAiB,EAC5BD,aAAkB,kBACpBA,EAAO,MAAM,CACnB,CACF,CAAC,EAGLE,GAAc,CAAE,UAAAtC,EAAU,CAAC,EAC3BuC,GAAmB,CAAE,UAAAvC,GAAW,QAAAU,EAAQ,CAAC,EACzC8B,GAAe,CAAE,UAAAxC,EAAU,CAAC,EAC5ByC,GAAgB,CAAE,UAAAjC,GAAW,QAAAE,EAAQ,CAAC,EAGtC,IAAMgC,GAAUC,GAAYC,GAAoB,QAAQ,EAAG,CAAE,UAAApC,EAAU,CAAC,EAClEqC,GAAQ7C,GACX,KACCH,EAAI,IAAM+C,GAAoB,MAAM,CAAC,EACrCE,EAAUC,GAAMC,GAAUD,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,EAAQ,CAAC,CAAC,EACrD5C,EAAY,CAAC,CACf,EAGImD,GAAWvB,EAGf,GAAGwB,GAAqB,SAAS,EAC9B,IAAIH,GAAMI,GAAaJ,EAAI,CAAE,QAAA3C,EAAQ,CAAC,CAAC,EAG1C,GAAG8C,GAAqB,QAAQ,EAC7B,IAAIH,GAAMK,GAAYL,EAAI,CAAE,OAAA7B,EAAO,CAAC,CAAC,EAGxC,GAAGgC,GAAqB,QAAQ,EAC7B,IAAIH,GAAMM,GAAYN,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,EAAM,CAAC,CAAC,EAG3D,GAAGK,GAAqB,SAAS,EAC9B,IAAIH,GAAMO,GAAaP,CAAE,CAAC,EAG7B,GAAGG,GAAqB,UAAU,EAC/B,IAAIH,GAAMQ,GAAcR,EAAI,CAAE,UAAA1B,EAAU,CAAC,CAAC,EAG7C,GAAG6B,GAAqB,QAAQ,EAC7B,IAAIH,GAAMS,GAAYT,EAAI,CAAE,OAAA/B,GAAQ,UAAAV,EAAU,CAAC,CAAC,EAGnD,GAAG4C,GAAqB,QAAQ,EAC7B,IAAIH,GAAMU,GAAYV,CAAE,CAAC,CAC9B,EAGMW,GAAWC,EAAM,IAAMjC,EAG3B,GAAGwB,GAAqB,UAAU,EAC/B,IAAIH,GAAMa,GAAcb,CAAE,CAAC,EAG9B,GAAGG,GAAqB,SAAS,EAC9B,IAAIH,GAAMc,GAAad,EAAI,CAAE,UAAAvC,GAAW,QAAAJ,GAAS,OAAAS,EAAO,CAAC,CAAC,EAG7D,GAAGqC,GAAqB,SAAS,EAC9B,IAAIH,GAAMzB,EAAQ,kBAAkB,EACjCwC,GAAoBf,EAAI,CAAE,OAAA/B,GAAQ,UAAAd,EAAU,CAAC,EAC7C6D,CACJ,EAGF,GAAGb,GAAqB,cAAc,EACnC,IAAIH,GAAMiB,GAAiBjB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,EAAQ,CAAC,CAAC,EAGzD,GAAGQ,GAAqB,SAAS,EAC9B,IAAIH,GAAMA,EAAG,aAAa,cAAc,IAAM,aAC3CkB,GAAGrD,GAAS,IAAMsD,GAAanB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,EAAM,CAAC,CAAC,EACjEoB,GAAGvD,GAAS,IAAMwD,GAAanB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,EAAM,CAAC,CAAC,CACrE,EAGF,GAAGK,GAAqB,MAAM,EAC3B,IAAIH,GAAMoB,GAAUpB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,EAAQ,CAAC,CAAC,EAGlD,GAAGQ,GAAqB,KAAK,EAC1B,IAAIH,GAAMqB,GAAqBrB,EAAI,CAClC,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,GAAO,QAAAzC,EAC7B,CAAC,CAAC,EAGJ,GAAG8C,GAAqB,KAAK,EAC1B,IAAIH,GAAMsB,GAAetB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,GAAO,QAAAzC,EAAQ,CAAC,CAAC,CACzE,CAAC,EAGKkE,GAAatE,GAChB,KACC8C,EAAU,IAAMY,EAAQ,EACxBa,GAAUtB,EAAQ,EAClBnD,EAAY,CAAC,CACf,EAGFwE,GAAW,UAAU,EAMrB,OAAO,UAAatE,GACpB,OAAO,UAAaE,GACpB,OAAO,QAAaE,GACpB,OAAO,UAAaE,GACpB,OAAO,UAAaE,GACpB,OAAO,QAAaE,GACpB,OAAO,QAAaE,GACpB,OAAO,OAAaC,GACpB,OAAO,OAAaK,GACpB,OAAO,UAAaG,GACpB,OAAO,WAAaiD",
-  "names": ["require_focus_visible", "__commonJSMin", "exports", "module", "global", "factory", "applyFocusVisiblePolyfill", "scope", "hadKeyboardEvent", "hadFocusVisibleRecently", "hadFocusVisibleRecentlyTimeout", "inputTypesAllowlist", "isValidFocusTarget", "el", "focusTriggersKeyboardModality", "type", "tagName", "addFocusVisibleClass", "removeFocusVisibleClass", "onKeyDown", "e", "onPointerDown", "onFocus", "onBlur", "onVisibilityChange", "addInitialPointerMoveListeners", "onInitialPointerMove", "removeInitialPointerMoveListeners", "event", "error", "require_clipboard", "__commonJSMin", "exports", "module", "root", "factory", "__webpack_modules__", "__unused_webpack_module", "__webpack_exports__", "__webpack_require__", "clipboard", "tiny_emitter", "tiny_emitter_default", "listen", "listen_default", "src_select", "select_default", "command", "type", "err", "ClipboardActionCut", "target", "selectedText", "actions_cut", "createFakeElement", "value", "isRTL", "fakeElement", "yPosition", "fakeCopyAction", "options", "ClipboardActionCopy", "actions_copy", "_typeof", "obj", "ClipboardActionDefault", "_options$action", "action", "container", "text", "actions_default", "clipboard_typeof", "_classCallCheck", "instance", "Constructor", "_defineProperties", "props", "i", "descriptor", "_createClass", "protoProps", "staticProps", "_inherits", "subClass", "superClass", "_setPrototypeOf", "o", "p", "_createSuper", "Derived", "hasNativeReflectConstruct", "_isNativeReflectConstruct", "Super", "_getPrototypeOf", "result", "NewTarget", "_possibleConstructorReturn", "self", "call", "_assertThisInitialized", "e", "getAttributeValue", "suffix", "element", "attribute", "Clipboard", "_Emitter", "_super", "trigger", "_this", "_this2", "selector", "actions", "support", "DOCUMENT_NODE_TYPE", "proto", "closest", "__unused_webpack_exports", "_delegate", "callback", "useCapture", "listenerFn", "listener", "delegate", "elements", "is", "listenNode", "listenNodeList", "listenSelector", "node", "nodeList", "select", "isReadOnly", "selection", "range", "E", "name", "ctx", "data", "evtArr", "len", "evts", "liveEvents", "__webpack_module_cache__", "moduleId", "getter", "definition", "key", "prop", "require_escape_html", "__commonJSMin", "exports", "module", "matchHtmlRegExp", "escapeHtml", "string", "str", "match", "escape", "html", "index", "lastIndex", "import_focus_visible", "extendStatics", "d", "b", "p", "__extends", "__", "__awaiter", "thisArg", "_arguments", "P", "generator", "adopt", "value", "resolve", "reject", "fulfilled", "step", "e", "rejected", "result", "__generator", "body", "_", "t", "f", "y", "g", "verb", "n", "v", "op", "__values", "o", "s", "m", "i", "__read", "n", "r", "ar", "e", "error", "__spreadArray", "to", "from", "pack", "i", "l", "ar", "__await", "v", "__asyncGenerator", "thisArg", "_arguments", "generator", "g", "q", "verb", "n", "a", "b", "resume", "step", "e", "settle", "r", "fulfill", "reject", "value", "f", "__asyncValues", "o", "m", "i", "__values", "verb", "n", "v", "resolve", "reject", "settle", "d", "isFunction", "value", "createErrorClass", "createImpl", "_super", "instance", "ctorFunc", "UnsubscriptionError", "createErrorClass", "_super", "errors", "err", "i", "arrRemove", "arr", "item", "index", "Subscription", "initialTeardown", "errors", "_parentage", "_parentage_1", "__values", "_parentage_1_1", "parent_1", "initialFinalizer", "isFunction", "e", "UnsubscriptionError", "_finalizers", "_finalizers_1", "_finalizers_1_1", "finalizer", "execFinalizer", "err", "__spreadArray", "__read", "teardown", "_a", "parent", "arrRemove", "empty", "EMPTY_SUBSCRIPTION", "Subscription", "isSubscription", "value", "isFunction", "execFinalizer", "finalizer", "config", "timeoutProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "reportUnhandledError", "err", "timeoutProvider", "onUnhandledError", "config", "noop", "COMPLETE_NOTIFICATION", "createNotification", "errorNotification", "error", "nextNotification", "value", "kind", "context", "errorContext", "cb", "config", "isRoot", "_a", "errorThrown", "error", "captureError", "err", "Subscriber", "_super", "__extends", "destination", "_this", "isSubscription", "EMPTY_OBSERVER", "next", "error", "complete", "SafeSubscriber", "value", "handleStoppedNotification", "nextNotification", "err", "errorNotification", "COMPLETE_NOTIFICATION", "Subscription", "_bind", "bind", "fn", "thisArg", "ConsumerObserver", "partialObserver", "value", "error", "handleUnhandledError", "err", "SafeSubscriber", "_super", "__extends", "observerOrNext", "complete", "_this", "isFunction", "context_1", "config", "Subscriber", "handleUnhandledError", "error", "config", "captureError", "reportUnhandledError", "defaultErrorHandler", "err", "handleStoppedNotification", "notification", "subscriber", "onStoppedNotification", "timeoutProvider", "EMPTY_OBSERVER", "noop", "observable", "identity", "x", "pipe", "fns", "_i", "pipeFromArray", "identity", "input", "prev", "fn", "Observable", "subscribe", "operator", "observable", "observerOrNext", "error", "complete", "_this", "subscriber", "isSubscriber", "SafeSubscriber", "errorContext", "_a", "source", "sink", "err", "next", "promiseCtor", "getPromiseCtor", "resolve", "reject", "value", "operations", "_i", "pipeFromArray", "x", "getPromiseCtor", "promiseCtor", "_a", "config", "isObserver", "value", "isFunction", "isSubscriber", "Subscriber", "isSubscription", "hasLift", "source", "isFunction", "operate", "init", "liftedSource", "err", "createOperatorSubscriber", "destination", "onNext", "onComplete", "onError", "onFinalize", "OperatorSubscriber", "_super", "__extends", "shouldUnsubscribe", "_this", "value", "err", "closed_1", "_a", "Subscriber", "animationFrameProvider", "callback", "request", "cancel", "delegate", "handle", "timestamp", "Subscription", "args", "_i", "__spreadArray", "__read", "ObjectUnsubscribedError", "createErrorClass", "_super", "Subject", "_super", "__extends", "_this", "operator", "subject", "AnonymousSubject", "ObjectUnsubscribedError", "value", "errorContext", "_b", "__values", "_c", "observer", "err", "observers", "_a", "subscriber", "hasError", "isStopped", "EMPTY_SUBSCRIPTION", "Subscription", "arrRemove", "thrownError", "observable", "Observable", "destination", "source", "AnonymousSubject", "_super", "__extends", "destination", "source", "_this", "value", "_b", "_a", "err", "subscriber", "EMPTY_SUBSCRIPTION", "Subject", "dateTimestampProvider", "ReplaySubject", "_super", "__extends", "_bufferSize", "_windowTime", "_timestampProvider", "dateTimestampProvider", "_this", "value", "_a", "isStopped", "_buffer", "_infiniteTimeWindow", "subscriber", "subscription", "copy", "i", "adjustedBufferSize", "now", "last", "Subject", "Action", "_super", "__extends", "scheduler", "work", "state", "delay", "Subscription", "intervalProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "AsyncAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "_a", "_id", "intervalProvider", "_scheduler", "error", "_delay", "errored", "errorValue", "e", "actions", "arrRemove", "Action", "Scheduler", "schedulerActionCtor", "now", "work", "delay", "state", "dateTimestampProvider", "AsyncScheduler", "_super", "__extends", "SchedulerAction", "now", "Scheduler", "_this", "action", "actions", "error", "asyncScheduler", "AsyncScheduler", "AsyncAction", "async", "AnimationFrameAction", "_super", "__extends", "scheduler", "work", "_this", "id", "delay", "animationFrameProvider", "actions", "_a", "AsyncAction", "AnimationFrameScheduler", "_super", "__extends", "action", "flushId", "actions", "error", "AsyncScheduler", "animationFrameScheduler", "AnimationFrameScheduler", "AnimationFrameAction", "EMPTY", "Observable", "subscriber", "isScheduler", "value", "isFunction", "last", "arr", "popResultSelector", "args", "isFunction", "popScheduler", "isScheduler", "popNumber", "defaultValue", "isArrayLike", "x", "isPromise", "value", "isFunction", "isInteropObservable", "input", "isFunction", "observable", "isAsyncIterable", "obj", "isFunction", "createInvalidObservableTypeError", "input", "getSymbolIterator", "iterator", "isIterable", "input", "isFunction", "iterator", "readableStreamLikeToAsyncGenerator", "readableStream", "reader", "__await", "_a", "_b", "value", "done", "isReadableStreamLike", "obj", "isFunction", "innerFrom", "input", "Observable", "isInteropObservable", "fromInteropObservable", "isArrayLike", "fromArrayLike", "isPromise", "fromPromise", "isAsyncIterable", "fromAsyncIterable", "isIterable", "fromIterable", "isReadableStreamLike", "fromReadableStreamLike", "createInvalidObservableTypeError", "obj", "subscriber", "obs", "observable", "isFunction", "array", "i", "promise", "value", "err", "reportUnhandledError", "iterable", "iterable_1", "__values", "iterable_1_1", "asyncIterable", "process", "readableStream", "readableStreamLikeToAsyncGenerator", "asyncIterable_1", "__asyncValues", "asyncIterable_1_1", "executeSchedule", "parentSubscription", "scheduler", "work", "delay", "repeat", "scheduleSubscription", "observeOn", "scheduler", "delay", "operate", "source", "subscriber", "createOperatorSubscriber", "value", "executeSchedule", "err", "subscribeOn", "scheduler", "delay", "operate", "source", "subscriber", "scheduleObservable", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "schedulePromise", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "scheduleArray", "input", "scheduler", "Observable", "subscriber", "i", "scheduleIterable", "input", "scheduler", "Observable", "subscriber", "iterator", "executeSchedule", "value", "done", "_a", "err", "isFunction", "scheduleAsyncIterable", "input", "scheduler", "Observable", "subscriber", "executeSchedule", "iterator", "result", "scheduleReadableStreamLike", "input", "scheduler", "scheduleAsyncIterable", "readableStreamLikeToAsyncGenerator", "scheduled", "input", "scheduler", "isInteropObservable", "scheduleObservable", "isArrayLike", "scheduleArray", "isPromise", "schedulePromise", "isAsyncIterable", "scheduleAsyncIterable", "isIterable", "scheduleIterable", "isReadableStreamLike", "scheduleReadableStreamLike", "createInvalidObservableTypeError", "from", "input", "scheduler", "scheduled", "innerFrom", "of", "args", "_i", "scheduler", "popScheduler", "from", "throwError", "errorOrErrorFactory", "scheduler", "errorFactory", "isFunction", "init", "subscriber", "Observable", "EmptyError", "createErrorClass", "_super", "isValidDate", "value", "map", "project", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "isArray", "callOrApply", "fn", "args", "__spreadArray", "__read", "mapOneOrManyArgs", "map", "isArray", "getPrototypeOf", "objectProto", "getKeys", "argsArgArrayOrObject", "args", "first_1", "isPOJO", "keys", "key", "obj", "createObject", "keys", "values", "result", "key", "i", "combineLatest", "args", "_i", "scheduler", "popScheduler", "resultSelector", "popResultSelector", "_a", "argsArgArrayOrObject", "observables", "keys", "from", "result", "Observable", "combineLatestInit", "values", "createObject", "identity", "mapOneOrManyArgs", "valueTransform", "subscriber", "maybeSchedule", "length", "active", "remainingFirstValues", "i", "source", "hasFirstValue", "createOperatorSubscriber", "value", "execute", "subscription", "executeSchedule", "mergeInternals", "source", "subscriber", "project", "concurrent", "onBeforeNext", "expand", "innerSubScheduler", "additionalFinalizer", "buffer", "active", "index", "isComplete", "checkComplete", "outerNext", "value", "doInnerSub", "innerComplete", "innerFrom", "createOperatorSubscriber", "innerValue", "bufferedValue", "executeSchedule", "err", "mergeMap", "project", "resultSelector", "concurrent", "isFunction", "a", "i", "map", "b", "ii", "innerFrom", "operate", "source", "subscriber", "mergeInternals", "mergeAll", "concurrent", "mergeMap", "identity", "concatAll", "mergeAll", "concat", "args", "_i", "concatAll", "from", "popScheduler", "defer", "observableFactory", "Observable", "subscriber", "innerFrom", "nodeEventEmitterMethods", "eventTargetMethods", "jqueryMethods", "fromEvent", "target", "eventName", "options", "resultSelector", "isFunction", "mapOneOrManyArgs", "_a", "__read", "isEventTarget", "methodName", "handler", "isNodeStyleEventEmitter", "toCommonHandlerRegistry", "isJQueryStyleEventEmitter", "add", "remove", "isArrayLike", "mergeMap", "subTarget", "innerFrom", "Observable", "subscriber", "args", "_i", "fromEventPattern", "addHandler", "removeHandler", "resultSelector", "mapOneOrManyArgs", "Observable", "subscriber", "handler", "e", "_i", "retValue", "isFunction", "timer", "dueTime", "intervalOrScheduler", "scheduler", "async", "intervalDuration", "isScheduler", "Observable", "subscriber", "due", "isValidDate", "n", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "sources", "innerFrom", "mergeAll", "from", "EMPTY", "NEVER", "Observable", "noop", "isArray", "argsOrArgArray", "args", "filter", "predicate", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "zip", "args", "_i", "resultSelector", "popResultSelector", "sources", "argsOrArgArray", "Observable", "subscriber", "buffers", "completed", "sourceIndex", "innerFrom", "createOperatorSubscriber", "value", "buffer", "result", "__spreadArray", "__read", "i", "EMPTY", "audit", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "isComplete", "endDuration", "value", "cleanupDuration", "createOperatorSubscriber", "innerFrom", "auditTime", "duration", "scheduler", "asyncScheduler", "audit", "timer", "bufferCount", "bufferSize", "startBufferEvery", "operate", "source", "subscriber", "buffers", "count", "createOperatorSubscriber", "value", "toEmit", "buffers_1", "__values", "buffers_1_1", "buffer", "toEmit_1", "toEmit_1_1", "arrRemove", "buffers_2", "buffers_2_1", "catchError", "selector", "operate", "source", "subscriber", "innerSub", "syncUnsub", "handledResult", "createOperatorSubscriber", "err", "innerFrom", "scanInternals", "accumulator", "seed", "hasSeed", "emitOnNext", "emitBeforeComplete", "source", "subscriber", "hasState", "state", "index", "createOperatorSubscriber", "value", "i", "combineLatest", "args", "_i", "resultSelector", "popResultSelector", "pipe", "__spreadArray", "__read", "mapOneOrManyArgs", "operate", "source", "subscriber", "combineLatestInit", "argsOrArgArray", "combineLatestWith", "otherSources", "_i", "combineLatest", "__spreadArray", "__read", "debounceTime", "dueTime", "scheduler", "asyncScheduler", "operate", "source", "subscriber", "activeTask", "lastValue", "lastTime", "emit", "value", "emitWhenIdle", "targetTime", "now", "createOperatorSubscriber", "defaultIfEmpty", "defaultValue", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "take", "count", "EMPTY", "operate", "source", "subscriber", "seen", "createOperatorSubscriber", "value", "ignoreElements", "operate", "source", "subscriber", "createOperatorSubscriber", "noop", "mapTo", "value", "map", "delayWhen", "delayDurationSelector", "subscriptionDelay", "source", "concat", "take", "ignoreElements", "mergeMap", "value", "index", "innerFrom", "mapTo", "delay", "due", "scheduler", "asyncScheduler", "duration", "timer", "delayWhen", "distinctUntilChanged", "comparator", "keySelector", "identity", "defaultCompare", "operate", "source", "subscriber", "previousKey", "first", "createOperatorSubscriber", "value", "currentKey", "a", "b", "distinctUntilKeyChanged", "key", "compare", "distinctUntilChanged", "x", "y", "throwIfEmpty", "errorFactory", "defaultErrorFactory", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "EmptyError", "endWith", "values", "_i", "source", "concat", "of", "__spreadArray", "__read", "finalize", "callback", "operate", "source", "subscriber", "first", "predicate", "defaultValue", "hasDefaultValue", "source", "filter", "v", "identity", "take", "defaultIfEmpty", "throwIfEmpty", "EmptyError", "takeLast", "count", "EMPTY", "operate", "source", "subscriber", "buffer", "createOperatorSubscriber", "value", "buffer_1", "__values", "buffer_1_1", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "argsOrArgArray", "operate", "source", "subscriber", "mergeAll", "from", "__spreadArray", "__read", "mergeWith", "otherSources", "_i", "merge", "__spreadArray", "__read", "repeat", "countOrConfig", "count", "delay", "_a", "EMPTY", "operate", "source", "subscriber", "soFar", "sourceSub", "resubscribe", "notifier", "timer", "innerFrom", "notifierSubscriber_1", "createOperatorSubscriber", "subscribeToSource", "syncUnsub", "scan", "accumulator", "seed", "operate", "scanInternals", "share", "options", "_a", "connector", "Subject", "_b", "resetOnError", "_c", "resetOnComplete", "_d", "resetOnRefCountZero", "wrapperSource", "connection", "resetConnection", "subject", "refCount", "hasCompleted", "hasErrored", "cancelReset", "reset", "resetAndUnsubscribe", "conn", "operate", "source", "subscriber", "dest", "handleReset", "SafeSubscriber", "value", "err", "innerFrom", "on", "args", "_i", "onSubscriber", "__spreadArray", "__read", "shareReplay", "configOrBufferSize", "windowTime", "scheduler", "bufferSize", "refCount", "_a", "_b", "_c", "share", "ReplaySubject", "skip", "count", "filter", "_", "index", "skipUntil", "notifier", "operate", "source", "subscriber", "taking", "skipSubscriber", "createOperatorSubscriber", "noop", "innerFrom", "value", "startWith", "values", "_i", "scheduler", "popScheduler", "operate", "source", "subscriber", "concat", "switchMap", "project", "resultSelector", "operate", "source", "subscriber", "innerSubscriber", "index", "isComplete", "checkComplete", "createOperatorSubscriber", "value", "innerIndex", "outerIndex", "innerFrom", "innerValue", "takeUntil", "notifier", "operate", "source", "subscriber", "innerFrom", "createOperatorSubscriber", "noop", "takeWhile", "predicate", "inclusive", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "result", "tap", "observerOrNext", "error", "complete", "tapObserver", "isFunction", "operate", "source", "subscriber", "_a", "isUnsub", "createOperatorSubscriber", "value", "err", "_b", "identity", "throttle", "durationSelector", "config", "operate", "source", "subscriber", "_a", "_b", "leading", "_c", "trailing", "hasValue", "sendValue", "throttled", "isComplete", "endThrottling", "send", "cleanupThrottling", "startThrottle", "value", "innerFrom", "createOperatorSubscriber", "throttleTime", "duration", "scheduler", "config", "asyncScheduler", "duration$", "timer", "throttle", "withLatestFrom", "inputs", "_i", "project", "popResultSelector", "operate", "source", "subscriber", "len", "otherValues", "hasValue", "ready", "i", "innerFrom", "createOperatorSubscriber", "value", "identity", "noop", "values", "__spreadArray", "__read", "zip", "sources", "_i", "operate", "source", "subscriber", "__spreadArray", "__read", "zipWith", "otherInputs", "_i", "zip", "__spreadArray", "__read", "watchDocument", "document$", "ReplaySubject", "fromEvent", "getElements", "selector", "node", "getElement", "el", "getOptionalElement", "getActiveElement", "_a", "_b", "_c", "_d", "observer$", "merge", "fromEvent", "debounceTime", "startWith", "map", "getActiveElement", "shareReplay", "watchElementFocus", "el", "active", "distinctUntilChanged", "watchElementHover", "el", "duration", "merge", "fromEvent", "map", "debounceTime", "identity", "startWith", "getElementOffset", "el", "watchElementOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "getElementContentOffset", "el", "watchElementContentOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "appendChild", "el", "child", "node", "h", "tag", "attributes", "children", "attr", "round", "value", "digits", "watchScript", "src", "script", "h", "defer", "merge", "fromEvent", "switchMap", "throwError", "map", "finalize", "take", "entry$", "Subject", "observer$", "defer", "watchScript", "of", "map", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "getElementSize", "el", "watchElementSize", "tap", "filter", "target", "startWith", "getElementContentSize", "el", "getElementContainer", "parent", "entry$", "Subject", "observer$", "defer", "of", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "watchElementVisibility", "el", "tap", "filter", "target", "map", "isIntersecting", "watchElementBoundary", "threshold", "watchElementContentOffset", "y", "visible", "getElementSize", "content", "getElementContentSize", "distinctUntilChanged", "toggles", "getElement", "getToggle", "name", "setToggle", "value", "watchToggle", "el", "fromEvent", "map", "startWith", "isSusceptibleToKeyboard", "el", "type", "watchComposition", "merge", "fromEvent", "map", "startWith", "watchKeyboard", "keyboard$", "filter", "ev", "getToggle", "mode", "active", "getActiveElement", "share", "switchMap", "EMPTY", "getLocation", "setLocation", "url", "navigate", "feature", "el", "h", "watchLocation", "Subject", "getLocationHash", "setLocationHash", "hash", "el", "h", "ev", "watchLocationHash", "location$", "merge", "fromEvent", "map", "startWith", "filter", "shareReplay", "watchLocationTarget", "id", "getOptionalElement", "watchMedia", "query", "media", "fromEventPattern", "next", "startWith", "watchPrint", "merge", "fromEvent", "map", "at", "query$", "factory", "switchMap", "active", "EMPTY", "request", "url", "options", "Observable", "observer", "req", "event", "_a", "length", "requestJSON", "switchMap", "res", "map", "body", "shareReplay", "requestHTML", "dom", "requestXML", "getViewportOffset", "watchViewportOffset", "merge", "fromEvent", "map", "startWith", "getViewportSize", "watchViewportSize", "fromEvent", "map", "startWith", "watchViewport", "combineLatest", "watchViewportOffset", "watchViewportSize", "map", "offset", "size", "shareReplay", "watchViewportAt", "el", "viewport$", "header$", "size$", "distinctUntilKeyChanged", "offset$", "combineLatest", "map", "getElementOffset", "height", "offset", "size", "x", "y", "recv", "worker", "fromEvent", "ev", "send", "send$", "Subject", "data", "watchWorker", "url", "recv$", "worker$", "done$", "ignoreElements", "endWith", "mergeWith", "takeUntil", "share", "script", "getElement", "config", "getLocation", "configuration", "feature", "flag", "translation", "key", "value", "getComponentElement", "type", "node", "getElement", "getComponentElements", "getElements", "watchAnnounce", "el", "button", "getElement", "fromEvent", "map", "content", "mountAnnounce", "feature", "EMPTY", "defer", "push$", "Subject", "hash", "tap", "state", "finalize", "__spreadValues", "watchConsent", "el", "target$", "map", "target", "mountConsent", "options", "internal$", "Subject", "hidden", "tap", "state", "finalize", "__spreadValues", "renderTooltip", "id", "style", "h", "renderAnnotation", "id", "prefix", "anchor", "h", "renderTooltip", "renderClipboardButton", "id", "h", "translation", "renderSearchDocument", "document", "flag", "parent", "teaser", "missing", "key", "list", "h", "config", "configuration", "url", "feature", "match", "highlight", "value", "tags", "tag", "type", "translation", "renderSearchResultItem", "result", "threshold", "docs", "doc", "article", "index", "best", "more", "children", "section", "renderSourceFacts", "facts", "h", "key", "value", "round", "renderTabbedControl", "type", "classes", "h", "renderTable", "table", "h", "renderVersion", "version", "config", "configuration", "url", "h", "renderVersionSelector", "versions", "active", "_a", "translation", "sequence", "watchTooltip", "el", "host", "width", "getElementSize", "container", "getElementContainer", "scroll$", "watchElementContentOffset", "of", "active$", "merge", "watchElementFocus", "watchElementHover", "distinctUntilChanged", "combineLatest", "map", "active", "scroll", "x", "y", "getElementOffset", "size", "table", "mountTooltip", "title", "EMPTY", "id", "tooltip", "renderTooltip", "typeset", "getElement", "defer", "push$", "Subject", "offset", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "tap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "watchAnnotation", "el", "container", "offset$", "defer", "combineLatest", "watchElementOffset", "watchElementContentOffset", "map", "x", "y", "scroll", "width", "height", "getElementSize", "watchElementFocus", "switchMap", "active", "offset", "take", "mountAnnotation", "target$", "tooltip", "index", "push$", "Subject", "done$", "ignoreElements", "endWith", "watchElementVisibility", "takeUntil", "visible", "merge", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "fromEvent", "ev", "withLatestFrom", "_a", "parent", "getActiveElement", "target", "delay", "tap", "state", "finalize", "__spreadValues", "findHosts", "container", "getElements", "findMarkers", "markers", "el", "nodes", "it", "node", "text", "match", "id", "force", "marker", "swap", "source", "target", "mountAnnotationList", "target$", "print$", "parent", "prefix", "annotations", "getOptionalElement", "renderAnnotation", "EMPTY", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "pairs", "annotation", "getElement", "takeUntil", "active", "inner", "child", "merge", "mountAnnotation", "finalize", "share", "findList", "el", "sibling", "mountAnnotationBlock", "options", "defer", "list", "mountAnnotationList", "EMPTY", "import_clipboard", "sequence", "findCandidateList", "el", "sibling", "watchCodeBlock", "watchElementSize", "map", "width", "getElementContentSize", "distinctUntilKeyChanged", "mountCodeBlock", "options", "hover", "factory$", "defer", "push$", "Subject", "done$", "takeLast", "scrollable", "content$", "ClipboardJS", "feature", "parent", "button", "renderClipboardButton", "mountTooltip", "container", "list", "annotations$", "mountAnnotationList", "takeUntil", "height", "distinctUntilChanged", "switchMap", "active", "EMPTY", "tap", "state", "finalize", "__spreadValues", "mergeWith", "watchElementVisibility", "filter", "visible", "take", "watchDetails", "el", "target$", "print$", "open", "merge", "map", "target", "filter", "details", "active", "tap", "mountDetails", "options", "defer", "push$", "Subject", "action", "reveal", "state", "finalize", "__spreadValues", "mermaid_default", "mermaid$", "sequence", "fetchScripts", "watchScript", "of", "mountMermaid", "el", "tap", "mermaid_default", "map", "shareReplay", "__async", "id", "host", "h", "text", "svg", "fn", "shadow", "sentinel", "h", "mountDataTable", "el", "renderTable", "of", "watchContentTabs", "inputs", "initial", "input", "merge", "fromEvent", "map", "getElement", "startWith", "active", "mountContentTabs", "el", "viewport$", "target$", "container", "getElements", "prev", "renderTabbedControl", "next", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatest", "watchElementSize", "takeUntil", "auditTime", "animationFrameScheduler", "size", "offset", "getElementOffset", "width", "getElementSize", "content", "getElementContentOffset", "watchElementContentOffset", "getElementContentSize", "direction", "filter", "label", "h", "ev", "tap", "feature", "skip", "withLatestFrom", "tab", "y", "set", "tabs", "media", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "mountContent", "el", "viewport$", "target$", "print$", "merge", "getElements", "child", "mountAnnotationBlock", "mountCodeBlock", "mountMermaid", "mountDataTable", "mountDetails", "mountContentTabs", "feature", "mountTooltip", "watchDialog", "_el", "alert$", "switchMap", "message", "merge", "of", "delay", "map", "active", "mountDialog", "el", "options", "inner", "getElement", "defer", "push$", "Subject", "tap", "state", "finalize", "__spreadValues", "isHidden", "viewport$", "feature", "of", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilKeyChanged", "hidden$", "combineLatest", "filter", "offset", "direction", "distinctUntilChanged", "search$", "watchToggle", "search", "switchMap", "active", "startWith", "watchHeader", "el", "options", "defer", "watchElementSize", "height", "hidden", "shareReplay", "mountHeader", "header$", "main$", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatestWith", "tooltips", "from", "getElements", "mergeMap", "child", "mountTooltip", "takeUntil", "state", "__spreadValues", "mergeWith", "watchHeaderTitle", "el", "viewport$", "header$", "watchViewportAt", "map", "y", "height", "getElementSize", "distinctUntilKeyChanged", "mountHeaderTitle", "options", "defer", "push$", "Subject", "active", "heading", "getOptionalElement", "EMPTY", "tap", "state", "finalize", "__spreadValues", "watchMain", "el", "viewport$", "header$", "adjust$", "map", "height", "distinctUntilChanged", "border$", "switchMap", "watchElementSize", "distinctUntilKeyChanged", "combineLatest", "header", "top", "bottom", "y", "a", "b", "watchPalette", "inputs", "current", "input", "index", "of", "mergeMap", "fromEvent", "map", "startWith", "shareReplay", "mountPalette", "el", "getElements", "meta", "h", "scheme", "media$", "watchMedia", "defer", "push$", "Subject", "palette", "media", "key", "value", "label", "header", "getComponentElement", "style", "color", "observeOn", "asyncScheduler", "takeUntil", "skip", "repeat", "tap", "state", "finalize", "__spreadValues", "mountProgress", "el", "progress$", "defer", "push$", "Subject", "value", "tap", "finalize", "map", "import_clipboard", "extract", "el", "copy", "text", "setupClipboardJS", "alert$", "ClipboardJS", "Observable", "subscriber", "getElement", "ev", "tap", "map", "translation", "resolve", "url", "base", "extract", "document", "sitemap", "el", "getElements", "getElement", "links", "link", "href", "fetchSitemap", "requestXML", "map", "catchError", "of", "handle", "ev", "sitemap", "EMPTY", "el", "url", "of", "head", "document", "tags", "getElements", "resolve", "key", "value", "inject", "next", "selector", "feature", "source", "getOptionalElement", "target", "html", "name", "container", "getComponentElement", "concat", "switchMap", "script", "Observable", "observer", "ignoreElements", "endWith", "setupInstantNavigation", "location$", "viewport$", "progress$", "config", "configuration", "sitemap$", "fetchSitemap", "instant$", "fromEvent", "combineLatestWith", "share", "history$", "map", "getLocation", "withLatestFrom", "offset", "merge", "document$", "distinctUntilKeyChanged", "requestHTML", "catchError", "setLocation", "_", "distinctUntilChanged", "a", "b", "tap", "_a", "_b", "setLocationHash", "debounceTime", "import_escape_html", "setupSearchHighlighter", "config", "regex", "term", "separator", "highlight", "_", "data", "query", "match", "value", "escapeHTML", "isSearchReadyMessage", "message", "isSearchResultMessage", "setupSearchWorker", "url", "index$", "worker$", "watchWorker", "merge", "of", "watchToggle", "first", "active", "switchMap", "config", "docs", "feature", "setupVersionSelector", "document$", "config", "configuration", "versions$", "requestJSON", "catchError", "EMPTY", "current$", "map", "versions", "current", "version", "aliases", "switchMap", "urls", "fromEvent", "filter", "ev", "withLatestFrom", "el", "url", "of", "fetchSitemap", "sitemap", "path", "getLocation", "setLocation", "combineLatest", "getElement", "renderVersionSelector", "_a", "outdated", "ignored", "main", "ignore", "warning", "getComponentElements", "watchSearchQuery", "el", "worker$", "searchParams", "getLocation", "setToggle", "watchToggle", "first", "active", "url", "focus$", "watchElementFocus", "value$", "merge", "isSearchReadyMessage", "fromEvent", "map", "distinctUntilChanged", "combineLatest", "value", "focus", "shareReplay", "mountSearchQuery", "push$", "Subject", "done$", "ignoreElements", "endWith", "_", "query", "distinctUntilKeyChanged", "takeUntil", "label", "getElement", "tap", "state", "finalize", "__spreadValues", "mountSearchResult", "el", "worker$", "query$", "push$", "Subject", "boundary$", "watchElementBoundary", "filter", "container", "meta", "getElement", "list", "watchToggle", "active", "withLatestFrom", "skipUntil", "first", "isSearchReadyMessage", "items", "value", "translation", "count", "round", "render$", "tap", "switchMap", "merge", "of", "bufferCount", "zipWith", "chunk", "map", "renderSearchResultItem", "share", "item", "mergeMap", "details", "getOptionalElement", "EMPTY", "fromEvent", "takeUntil", "isSearchResultMessage", "data", "state", "finalize", "__spreadValues", "watchSearchShare", "_el", "query$", "map", "value", "url", "getLocation", "mountSearchShare", "el", "options", "push$", "Subject", "done$", "ignoreElements", "endWith", "fromEvent", "takeUntil", "ev", "tap", "state", "finalize", "__spreadValues", "mountSearchSuggest", "el", "worker$", "keyboard$", "push$", "Subject", "query", "getComponentElement", "query$", "merge", "fromEvent", "observeOn", "asyncScheduler", "map", "distinctUntilChanged", "combineLatestWith", "suggest", "value", "words", "last", "filter", "mode", "key", "isSearchResultMessage", "data", "tap", "state", "finalize", "mountSearch", "el", "index$", "keyboard$", "config", "configuration", "worker$", "setupSearchWorker", "query", "getComponentElement", "result", "fromEvent", "filter", "target", "setToggle", "mode", "key", "active", "getActiveElement", "anchors", "anchor", "getElements", "article", "best", "a", "b", "els", "i", "query$", "mountSearchQuery", "merge", "mountSearchResult", "mergeWith", "getComponentElements", "child", "mountSearchShare", "mountSearchSuggest", "err", "NEVER", "mountSearchHiglight", "el", "index$", "location$", "combineLatest", "startWith", "getLocation", "filter", "url", "map", "index", "setupSearchHighlighter", "fn", "_a", "nodes", "it", "node", "original", "replaced", "text", "childNodes", "h", "watchSidebar", "el", "viewport$", "main$", "parent", "adjust", "combineLatest", "map", "offset", "height", "y", "distinctUntilChanged", "a", "b", "mountSidebar", "_a", "_b", "header$", "options", "__objRest", "inner", "getElement", "getElementOffset", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "next$", "auditTime", "animationFrameScheduler", "withLatestFrom", "first", "item", "getElements", "container", "getElementSize", "from", "mergeMap", "label", "fromEvent", "observeOn", "asyncScheduler", "takeUntil", "input", "tap", "state", "finalize", "__spreadValues", "fetchSourceFactsFromGitHub", "user", "repo", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "release", "defaultIfEmpty", "info", "__spreadValues", "fetchSourceFactsFromGitLab", "base", "project", "url", "requestJSON", "catchError", "EMPTY", "map", "star_count", "forks_count", "defaultIfEmpty", "fetchSourceFacts", "url", "match", "user", "repo", "fetchSourceFactsFromGitHub", "base", "slug", "fetchSourceFactsFromGitLab", "EMPTY", "fetch$", "watchSource", "el", "defer", "cached", "of", "getComponentElements", "consent", "EMPTY", "fetchSourceFacts", "tap", "facts", "catchError", "filter", "map", "shareReplay", "mountSource", "inner", "getElement", "push$", "Subject", "renderSourceFacts", "state", "finalize", "__spreadValues", "watchTabs", "el", "viewport$", "header$", "watchElementSize", "switchMap", "watchViewportAt", "map", "y", "distinctUntilKeyChanged", "mountTabs", "options", "defer", "push$", "Subject", "hidden", "feature", "of", "tap", "state", "finalize", "__spreadValues", "watchTableOfContents", "el", "viewport$", "header$", "table", "anchors", "getElements", "anchor", "id", "target", "getOptionalElement", "adjust$", "distinctUntilKeyChanged", "map", "height", "main", "getComponentElement", "grid", "getElement", "share", "watchElementSize", "switchMap", "body", "defer", "path", "of", "index", "offset", "parent", "a", "b", "combineLatestWith", "adjust", "scan", "prev", "next", "y", "size", "last", "distinctUntilChanged", "startWith", "bufferCount", "mountTableOfContents", "main$", "target$", "push$", "Subject", "done$", "ignoreElements", "endWith", "feature", "smooth$", "merge", "debounceTime", "filter", "observeOn", "asyncScheduler", "withLatestFrom", "behavior", "container", "getElementContainer", "getElementSize", "takeUntil", "skip", "repeat", "url", "getLocation", "active", "hash", "tap", "state", "finalize", "__spreadValues", "watchBackToTop", "_el", "viewport$", "main$", "target$", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilChanged", "active$", "active", "combineLatest", "direction", "takeUntil", "skip", "endWith", "repeat", "hidden", "mountBackToTop", "el", "header$", "push$", "Subject", "done$", "ignoreElements", "distinctUntilKeyChanged", "height", "fromEvent", "ev", "tap", "state", "finalize", "__spreadValues", "patchEllipsis", "document$", "switchMap", "getElements", "mergeMap", "el", "watchElementVisibility", "takeUntil", "skip", "filter", "visible", "map", "take", "text", "host", "mountTooltip", "finalize", "patchIndeterminate", "document$", "tablet$", "switchMap", "getElements", "tap", "el", "mergeMap", "fromEvent", "takeWhile", "map", "withLatestFrom", "tablet", "isAppleDevice", "patchScrollfix", "document$", "switchMap", "getElements", "tap", "el", "filter", "mergeMap", "fromEvent", "map", "top", "patchScrolllock", "viewport$", "tablet$", "combineLatest", "watchToggle", "map", "active", "tablet", "switchMap", "of", "delay", "withLatestFrom", "y", "value", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "fetchSearchIndex", "watchScript", "config", "map", "shareReplay", "requestJSON", "document$", "watchDocument", "location$", "watchLocation", "target$", "watchLocationTarget", "keyboard$", "watchKeyboard", "viewport$", "watchViewport", "tablet$", "watchMedia", "screen$", "print$", "watchPrint", "configuration", "index$", "NEVER", "alert$", "Subject", "setupClipboardJS", "progress$", "feature", "setupInstantNavigation", "_a", "setupVersionSelector", "merge", "delay", "setToggle", "filter", "mode", "key", "prev", "getOptionalElement", "setLocation", "next", "active", "getActiveElement", "patchEllipsis", "patchIndeterminate", "patchScrollfix", "patchScrolllock", "header$", "watchHeader", "getComponentElement", "main$", "switchMap", "el", "watchMain", "control$", "getComponentElements", "mountConsent", "mountDialog", "mountHeader", "mountPalette", "mountProgress", "mountSearch", "mountSource", "content$", "defer", "mountAnnounce", "mountContent", "mountSearchHiglight", "EMPTY", "mountHeaderTitle", "at", "mountSidebar", "mountTabs", "mountTableOfContents", "mountBackToTop", "component$", "mergeWith"]
-}
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.ar.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.ar.min.js
deleted file mode 100644
index 9b06c26c1..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.ar.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ar=function(){this.pipeline.reset(),this.pipeline.add(e.ar.trimmer,e.ar.stopWordFilter,e.ar.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ar.stemmer))},e.ar.wordCharacters="ء-ٛٱـ",e.ar.trimmer=e.trimmerSupport.generateTrimmer(e.ar.wordCharacters),e.Pipeline.registerFunction(e.ar.trimmer,"trimmer-ar"),e.ar.stemmer=function(){var e=this;return e.result=!1,e.preRemoved=!1,e.sufRemoved=!1,e.pre={pre1:"ف ك ب و س ل ن ا ي ت",pre2:"ال لل",pre3:"بال وال فال تال كال ولل",pre4:"فبال كبال وبال وكال"},e.suf={suf1:"ه ك ت ن ا ي",suf2:"نك نه ها وك يا اه ون ين تن تم نا وا ان كم كن ني نن ما هم هن تك ته ات يه",suf3:"تين كهم نيه نهم ونه وها يهم ونا ونك وني وهم تكم تنا تها تني تهم كما كها ناه نكم هنا تان يها",suf4:"كموه ناها ونني ونهم تكما تموه تكاه كماه ناكم ناهم نيها وننا"},e.patterns=JSON.parse('{"pt43":[{"pt":[{"c":"ا","l":1}]},{"pt":[{"c":"ا,ت,ن,ي","l":0}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"و","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ي","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ا","l":2},{"c":"ل","l":3,"m":3}]},{"pt":[{"c":"م","l":0}]}],"pt53":[{"pt":[{"c":"ت","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":3},{"c":"ل","l":3,"m":4},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":3}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ن","l":4}]},{"pt":[{"c":"ت","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"م","l":0},{"c":"و","l":3}]},{"pt":[{"c":"ا","l":1},{"c":"و","l":3}]},{"pt":[{"c":"و","l":1},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"ا","l":2},{"c":"ن","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":1},{"c":"ا","l":3}]},{"pt":[{"c":"ي,ت,ا,ن","l":0},{"c":"ت","l":1}],"mPt":[{"c":"ف","l":0,"m":2},{"c":"ع","l":1,"m":3},{"c":"ا","l":2},{"c":"ل","l":3,"m":4}]},{"pt":[{"c":"ت,ي,ا,ن","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":2},{"c":"ي","l":3}]},{"pt":[{"c":"ا,ي,ت,ن","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ء","l":4}]}],"pt63":[{"pt":[{"c":"ا","l":0},{"c":"ت","l":2},{"c":"ا","l":4}]},{"pt":[{"c":"ا,ت,ن,ي","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"و","l":3}]},{"pt":[{"c":"م","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ي","l":1},{"c":"ي","l":3},{"c":"ا","l":4},{"c":"ء","l":5}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ا","l":4}]}],"pt54":[{"pt":[{"c":"ت","l":0}]},{"pt":[{"c":"ا,ي,ت,ن","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"م","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":2}]}],"pt64":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":1}]}],"pt73":[{"pt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ا","l":5}]}],"pt75":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":5}]}]}'),e.execArray=["cleanWord","removeDiacritics","cleanAlef","removeStopWords","normalizeHamzaAndAlef","removeStartWaw","removePre432","removeEndTaa","wordCheck"],e.stem=function(){var r=0;for(e.result=!1,e.preRemoved=!1,e.sufRemoved=!1;r<e.execArray.length&&1!=e.result;)e.result=e[e.execArray[r]](),r++},e.setCurrent=function(r){e.word=r},e.getCurrent=function(){return e.word},e.cleanWord=function(){var r=new RegExp("[^ء-ٛٱـ]");return e.word=e.word.replace(new RegExp("ـ","g"),""),!!r.test("")},e.removeDiacritics=function(){new RegExp("[ً-ٛ]");return e.word=e.word.replace(/[\u064b-\u065b]/gi,""),!1},e.cleanAlef=function(){var r=new RegExp("[آأإٱى]");return e.word=e.word.replace(r,"ا"),!1},e.removeStopWords=function(){if("، اض امين اه اها اي ا اب اجل اجمع اخ اخذ اصبح اضحى اقبل اقل اكثر الا ام اما امامك امامك امسى اما ان انا انت انتم انتما انتن انت انشا انى او اوشك اولئك اولئكم اولاء اولالك اوه اي ايا اين اينما اي ان اي اف اذ اذا اذا اذما اذن الى اليكم اليكما اليكن اليك اليك الا اما ان انما اي اياك اياكم اياكما اياكن ايانا اياه اياها اياهم اياهما اياهن اياي ايه ان ا ابتدا اثر اجل احد اخرى اخلولق اذا اربعة ارتد استحال اطار اعادة اعلنت اف اكثر اكد الالاء الالى الا الاخيرة الان الاول الاولى التى التي الثاني الثانية الذاتي الذى الذي الذين السابق الف اللائي اللاتي اللتان اللتيا اللتين اللذان اللذين اللواتي الماضي المقبل الوقت الى اليوم اما امام امس ان انبرى انقلب انه انها او اول اي ايار ايام ايضا ب بات باسم بان بخ برس بسبب بس بشكل بضع بطان بعد بعض بك بكم بكما بكن بل بلى بما بماذا بمن بن بنا به بها بي بيد بين بس بله بئس تان تانك تبدل تجاه تحول تلقاء تلك تلكم تلكما تم تينك تين ته تي ثلاثة ثم ثم ثمة ثم جعل جلل جميع جير حار حاشا حاليا حاي حتى حرى حسب حم حوالى حول حيث حيثما حين حي حبذا حتى حذار خلا خلال دون دونك ذا ذات ذاك ذانك ذان ذلك ذلكم ذلكما ذلكن ذو ذوا ذواتا ذواتي ذيت ذينك ذين ذه ذي راح رجع رويدك ريث رب زيارة سبحان سرعان سنة سنوات سوف سوى ساء ساءما شبه شخصا شرع شتان صار صباح صفر صه صه ضد ضمن طاق طالما طفق طق ظل عاد عام عاما عامة عدا عدة عدد عدم عسى عشر عشرة علق على عليك عليه عليها عل عن عند عندما عوض عين عدس عما غدا غير  ف فان فلان فو فى في فيم فيما فيه فيها قال قام قبل قد قط قلما قوة كانما كاين كاي كاين كاد كان كانت كذا كذلك كرب كل كلا كلاهما كلتا كلم كليكما كليهما كلما كلا كم كما كي كيت كيف كيفما كان كخ لئن لا لات لاسيما لدن لدى لعمر لقاء لك لكم لكما لكن لكنما لكي لكيلا للامم لم لما لما لن لنا له لها لو لوكالة لولا لوما لي لست لست لستم لستما لستن لست لسن لعل لكن ليت ليس ليسا ليستا ليست ليسوا لسنا ما ماانفك مابرح مادام ماذا مازال مافتئ مايو متى مثل مذ مساء مع معاذ مقابل مكانكم مكانكما مكانكن مكانك مليار مليون مما ممن من منذ منها مه مهما من من نحن نحو نعم نفس نفسه نهاية نخ نعما نعم ها هاؤم هاك هاهنا هب هذا هذه هكذا هل هلم هلا هم هما هن هنا هناك هنالك هو هي هيا هيت هيا هؤلاء هاتان هاتين هاته هاتي هج هذا هذان هذين هذه هذي هيهات و وا واحد واضاف واضافت واكد وان واها واوضح وراءك وفي وقال وقالت وقد وقف وكان وكانت ولا ولم ومن وهو وهي ويكان وي وشكان يكون يمكن يوم ايان".split(" ").indexOf(e.word)>=0)return!0},e.normalizeHamzaAndAlef=function(){return e.word=e.word.replace("ؤ","ء"),e.word=e.word.replace("ئ","ء"),e.word=e.word.replace(/([\u0627])\1+/gi,"ا"),!1},e.removeEndTaa=function(){return!(e.word.length>2)||(e.word=e.word.replace(/[\u0627]$/,""),e.word=e.word.replace("ة",""),!1)},e.removeStartWaw=function(){return e.word.length>3&&"و"==e.word[0]&&"و"==e.word[1]&&(e.word=e.word.slice(1)),!1},e.removePre432=function(){var r=e.word;if(e.word.length>=7){var t=new RegExp("^("+e.pre.pre4.split(" ").join("|")+")");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=6){var c=new RegExp("^("+e.pre.pre3.split(" ").join("|")+")");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=5){var l=new RegExp("^("+e.pre.pre2.split(" ").join("|")+")");e.word=e.word.replace(l,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.patternCheck=function(r){for(var t=0;t<r.length;t++){for(var c=!0,l=0;l<r[t].pt.length;l++){var n=r[t].pt[l].c.split(","),o=!1;if(n.forEach(function(c){e.word[r[t].pt[l].l]==c&&(o=!0)}),!o){c=!1;break}}if(1==c){if(r[t].mPt){for(var p=[],m=0;m<r[t].mPt.length;m++)null!=r[t].mPt[m].m?p[r[t].mPt[m].l]=e.word[r[t].mPt[m].m]:p[r[t].mPt[m].l]=r[t].mPt[m].c;e.word=p.join("")}e.result=!0;break}}},e.removePre1=function(){var r=e.word;if(0==e.preRemoved&&e.word.length>3){var t=new RegExp("^("+e.pre.pre1.split(" ").join("|")+")");e.word=e.word.replace(t,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.removeSuf1=function(){var r=e.word;if(0==e.sufRemoved&&e.word.length>3){var t=new RegExp("("+e.suf.suf1.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.removeSuf432=function(){var r=e.word;if(e.word.length>=6){var t=new RegExp("("+e.suf.suf4.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=5){var c=new RegExp("("+e.suf.suf3.split(" ").join("|")+")$");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=4){var l=new RegExp("("+e.suf.suf2.split(" ").join("|")+")$");e.word=e.word.replace(l,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.wordCheck=function(){for(var r=(e.word,[e.removeSuf432,e.removeSuf1,e.removePre1]),t=0,c=!1;e.word.length>=7&&!e.result&&t<r.length;)7!=e.word.length||c?(r[t](),t++,c=!1):(e.checkPattern73(),c=!0);var l=[e.checkPattern63,e.removeSuf432,e.removeSuf1,e.removePre1,e.checkPattern64];for(t=0;6==e.word.length&&!e.result&&t<l.length;)l[t](),t++;var n=[e.checkPattern53,e.removeSuf432,e.removeSuf1,e.removePre1,e.checkPattern54];for(t=0;5==e.word.length&&!e.result&&t<n.length;)n[t](),t++;var o=[e.checkPattern43,e.removeSuf1,e.removePre1,e.removeSuf432];for(t=0;4==e.word.length&&!e.result&&t<o.length;)o[t](),t++;return!0},e.checkPattern43=function(){e.patternCheck(e.patterns.pt43)},e.checkPattern53=function(){e.patternCheck(e.patterns.pt53)},e.checkPattern54=function(){e.patternCheck(e.patterns.pt54)},e.checkPattern63=function(){e.patternCheck(e.patterns.pt63)},e.checkPattern64=function(){e.patternCheck(e.patterns.pt64)},e.checkPattern73=function(){e.patternCheck(e.patterns.pt73)},function(r){return"function"==typeof r.update?r.update(function(r){return e.setCurrent(r),e.stem(),e.getCurrent()}):(e.setCurrent(r),e.stem(),e.getCurrent())}}(),e.Pipeline.registerFunction(e.ar.stemmer,"stemmer-ar"),e.ar.stopWordFilter=e.generateStopWordFilter("، اض امين اه اها اي ا اب اجل اجمع اخ اخذ اصبح اضحى اقبل اقل اكثر الا ام اما امامك امامك امسى اما ان انا انت انتم انتما انتن انت انشا انى او اوشك اولئك اولئكم اولاء اولالك اوه اي ايا اين اينما اي ان اي اف اذ اذا اذا اذما اذن الى اليكم اليكما اليكن اليك اليك الا اما ان انما اي اياك اياكم اياكما اياكن ايانا اياه اياها اياهم اياهما اياهن اياي ايه ان ا ابتدا اثر اجل احد اخرى اخلولق اذا اربعة ارتد استحال اطار اعادة اعلنت اف اكثر اكد الالاء الالى الا الاخيرة الان الاول الاولى التى التي الثاني الثانية الذاتي الذى الذي الذين السابق الف اللائي اللاتي اللتان اللتيا اللتين اللذان اللذين اللواتي الماضي المقبل الوقت الى اليوم اما امام امس ان انبرى انقلب انه انها او اول اي ايار ايام ايضا ب بات باسم بان بخ برس بسبب بس بشكل بضع بطان بعد بعض بك بكم بكما بكن بل بلى بما بماذا بمن بن بنا به بها بي بيد بين بس بله بئس تان تانك تبدل تجاه تحول تلقاء تلك تلكم تلكما تم تينك تين ته تي ثلاثة ثم ثم ثمة ثم جعل جلل جميع جير حار حاشا حاليا حاي حتى حرى حسب حم حوالى حول حيث حيثما حين حي حبذا حتى حذار خلا خلال دون دونك ذا ذات ذاك ذانك ذان ذلك ذلكم ذلكما ذلكن ذو ذوا ذواتا ذواتي ذيت ذينك ذين ذه ذي راح رجع رويدك ريث رب زيارة سبحان سرعان سنة سنوات سوف سوى ساء ساءما شبه شخصا شرع شتان صار صباح صفر صه صه ضد ضمن طاق طالما طفق طق ظل عاد عام عاما عامة عدا عدة عدد عدم عسى عشر عشرة علق على عليك عليه عليها عل عن عند عندما عوض عين عدس عما غدا غير  ف فان فلان فو فى في فيم فيما فيه فيها قال قام قبل قد قط قلما قوة كانما كاين كاي كاين كاد كان كانت كذا كذلك كرب كل كلا كلاهما كلتا كلم كليكما كليهما كلما كلا كم كما كي كيت كيف كيفما كان كخ لئن لا لات لاسيما لدن لدى لعمر لقاء لك لكم لكما لكن لكنما لكي لكيلا للامم لم لما لما لن لنا له لها لو لوكالة لولا لوما لي لست لست لستم لستما لستن لست لسن لعل لكن ليت ليس ليسا ليستا ليست ليسوا لسنا ما ماانفك مابرح مادام ماذا مازال مافتئ مايو متى مثل مذ مساء مع معاذ مقابل مكانكم مكانكما مكانكن مكانك مليار مليون مما ممن من منذ منها مه مهما من من نحن نحو نعم نفس نفسه نهاية نخ نعما نعم ها هاؤم هاك هاهنا هب هذا هذه هكذا هل هلم هلا هم هما هن هنا هناك هنالك هو هي هيا هيت هيا هؤلاء هاتان هاتين هاته هاتي هج هذا هذان هذين هذه هذي هيهات وا واحد واضاف واضافت واكد وان واها واوضح وراءك وفي وقال وقالت وقد وقف وكان وكانت ولا ولم ومن وهو وهي ويكان وي وشكان يكون يمكن يوم ايان".split(" ")),e.Pipeline.registerFunction(e.ar.stopWordFilter,"stopWordFilter-ar")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.da.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.da.min.js
deleted file mode 100644
index b9d850986..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.da.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Danish` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.da=function(){this.pipeline.reset(),this.pipeline.add(e.da.trimmer,e.da.stopWordFilter,e.da.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.da.stemmer))},e.da.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.da.trimmer=e.trimmerSupport.generateTrimmer(e.da.wordCharacters),e.Pipeline.registerFunction(e.da.trimmer,"trimmer-da"),e.da.stemmer=function(){var r=e.stemmerSupport.Among,i=e.stemmerSupport.SnowballProgram,n=new function(){function e(){var e,r=f.cursor+3;if(d=f.limit,0<=r&&r<=f.limit){for(a=r;;){if(e=f.cursor,f.in_grouping(w,97,248)){f.cursor=e;break}if(f.cursor=e,e>=f.limit)return;f.cursor++}for(;!f.out_grouping(w,97,248);){if(f.cursor>=f.limit)return;f.cursor++}d=f.cursor,d<a&&(d=a)}}function n(){var e,r;if(f.cursor>=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(c,32),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del();break;case 2:f.in_grouping_b(p,97,229)&&f.slice_del()}}function t(){var e,r=f.limit-f.cursor;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.find_among_b(l,4)?(f.bra=f.cursor,f.limit_backward=e,f.cursor=f.limit-r,f.cursor>f.limit_backward&&(f.cursor--,f.bra=f.cursor,f.slice_del())):f.limit_backward=e)}function s(){var e,r,i,n=f.limit-f.cursor;if(f.ket=f.cursor,f.eq_s_b(2,"st")&&(f.bra=f.cursor,f.eq_s_b(2,"ig")&&f.slice_del()),f.cursor=f.limit-n,f.cursor>=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(m,5),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del(),i=f.limit-f.cursor,t(),f.cursor=f.limit-i;break;case 2:f.slice_from("løs")}}function o(){var e;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.out_grouping_b(w,97,248)?(f.bra=f.cursor,u=f.slice_to(u),f.limit_backward=e,f.eq_v_b(u)&&f.slice_del()):f.limit_backward=e)}var a,d,u,c=[new r("hed",-1,1),new r("ethed",0,1),new r("ered",-1,1),new r("e",-1,1),new r("erede",3,1),new r("ende",3,1),new r("erende",5,1),new r("ene",3,1),new r("erne",3,1),new r("ere",3,1),new r("en",-1,1),new r("heden",10,1),new r("eren",10,1),new r("er",-1,1),new r("heder",13,1),new r("erer",13,1),new r("s",-1,2),new r("heds",16,1),new r("es",16,1),new r("endes",18,1),new r("erendes",19,1),new r("enes",18,1),new r("ernes",18,1),new r("eres",18,1),new r("ens",16,1),new r("hedens",24,1),new r("erens",24,1),new r("ers",16,1),new r("ets",16,1),new r("erets",28,1),new r("et",-1,1),new r("eret",30,1)],l=[new r("gd",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("elig",1,1),new r("els",-1,1),new r("løst",-1,2)],w=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],p=[239,254,42,3,0,0,0,0,0,0,0,0,0,0,0,0,16],f=new i;this.setCurrent=function(e){f.setCurrent(e)},this.getCurrent=function(){return f.getCurrent()},this.stem=function(){var r=f.cursor;return e(),f.limit_backward=r,f.cursor=f.limit,n(),f.cursor=f.limit,t(),f.cursor=f.limit,s(),f.cursor=f.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.da.stemmer,"stemmer-da"),e.da.stopWordFilter=e.generateStopWordFilter("ad af alle alt anden at blev blive bliver da de dem den denne der deres det dette dig din disse dog du efter eller en end er et for fra ham han hans har havde have hende hendes her hos hun hvad hvis hvor i ikke ind jeg jer jo kunne man mange med meget men mig min mine mit mod ned noget nogle nu når og også om op os over på selv sig sin sine sit skal skulle som sådan thi til ud under var vi vil ville vor være været".split(" ")),e.Pipeline.registerFunction(e.da.stopWordFilter,"stopWordFilter-da")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.de.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.de.min.js
deleted file mode 100644
index f3b5c108c..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.de.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `German` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.de=function(){this.pipeline.reset(),this.pipeline.add(e.de.trimmer,e.de.stopWordFilter,e.de.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.de.stemmer))},e.de.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.de.trimmer=e.trimmerSupport.generateTrimmer(e.de.wordCharacters),e.Pipeline.registerFunction(e.de.trimmer,"trimmer-de"),e.de.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!v.eq_s(1,e)||(v.ket=v.cursor,!v.in_grouping(p,97,252)))&&(v.slice_from(r),v.cursor=n,!0)}function i(){for(var r,n,i,s,t=v.cursor;;)if(r=v.cursor,v.bra=r,v.eq_s(1,"ß"))v.ket=v.cursor,v.slice_from("ss");else{if(r>=v.limit)break;v.cursor=r+1}for(v.cursor=t;;)for(n=v.cursor;;){if(i=v.cursor,v.in_grouping(p,97,252)){if(s=v.cursor,v.bra=s,e("u","U",i))break;if(v.cursor=s,e("y","Y",i))break}if(i>=v.limit)return void(v.cursor=n);v.cursor=i+1}}function s(){for(;!v.in_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}for(;!v.out_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}return!1}function t(){m=v.limit,l=m;var e=v.cursor+3;0<=e&&e<=v.limit&&(d=e,s()||(m=v.cursor,m<d&&(m=d),s()||(l=v.cursor)))}function o(){for(var e,r;;){if(r=v.cursor,v.bra=r,!(e=v.find_among(h,6)))return;switch(v.ket=v.cursor,e){case 1:v.slice_from("y");break;case 2:case 5:v.slice_from("u");break;case 3:v.slice_from("a");break;case 4:v.slice_from("o");break;case 6:if(v.cursor>=v.limit)return;v.cursor++}}}function c(){return m<=v.cursor}function u(){return l<=v.cursor}function a(){var e,r,n,i,s=v.limit-v.cursor;if(v.ket=v.cursor,(e=v.find_among_b(w,7))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:v.slice_del(),v.ket=v.cursor,v.eq_s_b(1,"s")&&(v.bra=v.cursor,v.eq_s_b(3,"nis")&&v.slice_del());break;case 3:v.in_grouping_b(g,98,116)&&v.slice_del()}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(f,4))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:if(v.in_grouping_b(k,98,116)){var t=v.cursor-3;v.limit_backward<=t&&t<=v.limit&&(v.cursor=t,v.slice_del())}}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(_,8))&&(v.bra=v.cursor,u()))switch(e){case 1:v.slice_del(),v.ket=v.cursor,v.eq_s_b(2,"ig")&&(v.bra=v.cursor,r=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-r,u()&&v.slice_del()));break;case 2:n=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-n,v.slice_del());break;case 3:if(v.slice_del(),v.ket=v.cursor,i=v.limit-v.cursor,!v.eq_s_b(2,"er")&&(v.cursor=v.limit-i,!v.eq_s_b(2,"en")))break;v.bra=v.cursor,c()&&v.slice_del();break;case 4:v.slice_del(),v.ket=v.cursor,e=v.find_among_b(b,2),e&&(v.bra=v.cursor,u()&&1==e&&v.slice_del())}}var d,l,m,h=[new r("",-1,6),new r("U",0,2),new r("Y",0,1),new r("ä",0,3),new r("ö",0,4),new r("ü",0,5)],w=[new r("e",-1,2),new r("em",-1,1),new r("en",-1,2),new r("ern",-1,1),new r("er",-1,1),new r("s",-1,3),new r("es",5,2)],f=[new r("en",-1,1),new r("er",-1,1),new r("st",-1,2),new r("est",2,1)],b=[new r("ig",-1,1),new r("lich",-1,1)],_=[new r("end",-1,1),new r("ig",-1,2),new r("ung",-1,1),new r("lich",-1,3),new r("isch",-1,2),new r("ik",-1,2),new r("heit",-1,3),new r("keit",-1,4)],p=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32,8],g=[117,30,5],k=[117,30,4],v=new n;this.setCurrent=function(e){v.setCurrent(e)},this.getCurrent=function(){return v.getCurrent()},this.stem=function(){var e=v.cursor;return i(),v.cursor=e,t(),v.limit_backward=e,v.cursor=v.limit,a(),v.cursor=v.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.de.stemmer,"stemmer-de"),e.de.stopWordFilter=e.generateStopWordFilter("aber alle allem allen aller alles als also am an ander andere anderem anderen anderer anderes anderm andern anderr anders auch auf aus bei bin bis bist da damit dann das dasselbe dazu daß dein deine deinem deinen deiner deines dem demselben den denn denselben der derer derselbe derselben des desselben dessen dich die dies diese dieselbe dieselben diesem diesen dieser dieses dir doch dort du durch ein eine einem einen einer eines einig einige einigem einigen einiger einiges einmal er es etwas euch euer eure eurem euren eurer eures für gegen gewesen hab habe haben hat hatte hatten hier hin hinter ich ihm ihn ihnen ihr ihre ihrem ihren ihrer ihres im in indem ins ist jede jedem jeden jeder jedes jene jenem jenen jener jenes jetzt kann kein keine keinem keinen keiner keines können könnte machen man manche manchem manchen mancher manches mein meine meinem meinen meiner meines mich mir mit muss musste nach nicht nichts noch nun nur ob oder ohne sehr sein seine seinem seinen seiner seines selbst sich sie sind so solche solchem solchen solcher solches soll sollte sondern sonst um und uns unse unsem unsen unser unses unter viel vom von vor war waren warst was weg weil weiter welche welchem welchen welcher welches wenn werde werden wie wieder will wir wird wirst wo wollen wollte während würde würden zu zum zur zwar zwischen über".split(" ")),e.Pipeline.registerFunction(e.de.stopWordFilter,"stopWordFilter-de")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.du.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.du.min.js
deleted file mode 100644
index 49a0f3f0a..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.du.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Dutch` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");console.warn('[Lunr Languages] Please use the "nl" instead of the "du". The "nl" code is the standard code for Dutch language, and "du" will be removed in the next major versions.'),e.du=function(){this.pipeline.reset(),this.pipeline.add(e.du.trimmer,e.du.stopWordFilter,e.du.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.du.stemmer))},e.du.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.du.trimmer=e.trimmerSupport.generateTrimmer(e.du.wordCharacters),e.Pipeline.registerFunction(e.du.trimmer,"trimmer-du"),e.du.stemmer=function(){var r=e.stemmerSupport.Among,i=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e,r,i,o=C.cursor;;){if(C.bra=C.cursor,e=C.find_among(b,11))switch(C.ket=C.cursor,e){case 1:C.slice_from("a");continue;case 2:C.slice_from("e");continue;case 3:C.slice_from("i");continue;case 4:C.slice_from("o");continue;case 5:C.slice_from("u");continue;case 6:if(C.cursor>=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(r=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=r);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=r;else if(n(r))break}else if(n(r))break}function n(e){return C.cursor=e,e>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,f=_,t()||(_=C.cursor,_<3&&(_=3),t()||(f=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var e;;)if(C.bra=C.cursor,e=C.find_among(p,3))switch(C.ket=C.cursor,e){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return f<=C.cursor}function a(){var e=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-e,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var e;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.slice_del(),w=!0,a())))}function m(){var e;u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.eq_s_b(3,"gem")||(C.cursor=C.limit-e,C.slice_del(),a())))}function d(){var e,r,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,e=C.find_among_b(h,5))switch(C.bra=C.cursor,e){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(z,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(r=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-r,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,e=C.find_among_b(k,6))switch(C.bra=C.cursor,e){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(j,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var f,_,w,b=[new r("",-1,6),new r("á",0,1),new r("ä",0,1),new r("é",0,2),new r("ë",0,2),new r("í",0,3),new r("ï",0,3),new r("ó",0,4),new r("ö",0,4),new r("ú",0,5),new r("ü",0,5)],p=[new r("",-1,3),new r("I",0,2),new r("Y",0,1)],g=[new r("dd",-1,-1),new r("kk",-1,-1),new r("tt",-1,-1)],h=[new r("ene",-1,2),new r("se",-1,3),new r("en",-1,2),new r("heden",2,1),new r("s",-1,3)],k=[new r("end",-1,1),new r("ig",-1,2),new r("ing",-1,1),new r("lijk",-1,3),new r("baar",-1,4),new r("bar",-1,5)],v=[new r("aa",-1,-1),new r("ee",-1,-1),new r("oo",-1,-1),new r("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(e){C.setCurrent(e)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var r=C.cursor;return e(),C.cursor=r,o(),C.limit_backward=r,C.cursor=C.limit,d(),C.cursor=C.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.du.stemmer,"stemmer-du"),e.du.stopWordFilter=e.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),e.Pipeline.registerFunction(e.du.stopWordFilter,"stopWordFilter-du")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.el.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.el.min.js
deleted file mode 100644
index ace017bd6..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.el.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.el=function(){this.pipeline.reset(),void 0===this.searchPipeline&&this.pipeline.add(e.el.trimmer,e.el.normilizer),this.pipeline.add(e.el.stopWordFilter,e.el.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.el.stemmer))},e.el.wordCharacters="A-Za-zΑαΒβΓγΔδΕεΖζΗηΘθΙιΚκΛλΜμΝνΞξΟοΠπΡρΣσςΤτΥυΦφΧχΨψΩωΆάΈέΉήΊίΌόΎύΏώΪΐΫΰΐΰ",e.el.trimmer=e.trimmerSupport.generateTrimmer(e.el.wordCharacters),e.Pipeline.registerFunction(e.el.trimmer,"trimmer-el"),e.el.stemmer=function(){function e(e){return s.test(e)}function t(e){return/[ΑΕΗΙΟΥΩ]$/.test(e)}function r(e){return/[ΑΕΗΙΟΩ]$/.test(e)}function n(n){var s=n;if(n.length<3)return s;if(!e(n))return s;if(i.indexOf(n)>=0)return s;var u=new RegExp("(.*)("+Object.keys(l).join("|")+")$"),o=u.exec(s);return null!==o&&(s=o[1]+l[o[2]]),null!==(o=/^(.+?)(ΑΔΕΣ|ΑΔΩΝ)$/.exec(s))&&(s=o[1],/(ΟΚ|ΜΑΜ|ΜΑΝ|ΜΠΑΜΠ|ΠΑΤΕΡ|ΓΙΑΓΙ|ΝΤΑΝΤ|ΚΥΡ|ΘΕΙ|ΠΕΘΕΡ|ΜΟΥΣΑΜ|ΚΑΠΛΑΜ|ΠΑΡ|ΨΑΡ|ΤΖΟΥΡ|ΤΑΜΠΟΥΡ|ΓΑΛΑΤ|ΦΑΦΛΑΤ)$/.test(o[1])||(s+="ΑΔ")),null!==(o=/^(.+?)(ΕΔΕΣ|ΕΔΩΝ)$/.exec(s))&&(s=o[1],/(ΟΠ|ΙΠ|ΕΜΠ|ΥΠ|ΓΗΠ|ΔΑΠ|ΚΡΑΣΠ|ΜΙΛ)$/.test(o[1])&&(s+="ΕΔ")),null!==(o=/^(.+?)(ΟΥΔΕΣ|ΟΥΔΩΝ)$/.exec(s))&&(s=o[1],/(ΑΡΚ|ΚΑΛΙΑΚ|ΠΕΤΑΛ|ΛΙΧ|ΠΛΕΞ|ΣΚ|Σ|ΦΛ|ΦΡ|ΒΕΛ|ΛΟΥΛ|ΧΝ|ΣΠ|ΤΡΑΓ|ΦΕ)$/.test(o[1])&&(s+="ΟΥΔ")),null!==(o=/^(.+?)(ΕΩΣ|ΕΩΝ|ΕΑΣ|ΕΑ)$/.exec(s))&&(s=o[1],/^(Θ|Δ|ΕΛ|ΓΑΛ|Ν|Π|ΙΔ|ΠΑΡ|ΣΤΕΡ|ΟΡΦ|ΑΝΔΡ|ΑΝΤΡ)$/.test(o[1])&&(s+="Ε")),null!==(o=/^(.+?)(ΕΙΟ|ΕΙΟΣ|ΕΙΟΙ|ΕΙΑ|ΕΙΑΣ|ΕΙΕΣ|ΕΙΟΥ|ΕΙΟΥΣ|ΕΙΩΝ)$/.exec(s))&&o[1].length>4&&(s=o[1]),null!==(o=/^(.+?)(ΙΟΥΣ|ΙΑΣ|ΙΕΣ|ΙΟΣ|ΙΟΥ|ΙΟΙ|ΙΩΝ|ΙΟΝ|ΙΑ|ΙΟ)$/.exec(s))&&(s=o[1],(t(s)||s.length<2||/^(ΑΓ|ΑΓΓΕΛ|ΑΓΡ|ΑΕΡ|ΑΘΛ|ΑΚΟΥΣ|ΑΞ|ΑΣ|Β|ΒΙΒΛ|ΒΥΤ|Γ|ΓΙΑΓ|ΓΩΝ|Δ|ΔΑΝ|ΔΗΛ|ΔΗΜ|ΔΟΚΙΜ|ΕΛ|ΖΑΧΑΡ|ΗΛ|ΗΠ|ΙΔ|ΙΣΚ|ΙΣΤ|ΙΟΝ|ΙΩΝ|ΚΙΜΩΛ|ΚΟΛΟΝ|ΚΟΡ|ΚΤΗΡ|ΚΥΡ|ΛΑΓ|ΛΟΓ|ΜΑΓ|ΜΠΑΝ|ΜΠΡ|ΝΑΥΤ|ΝΟΤ|ΟΠΑΛ|ΟΞ|ΟΡ|ΟΣ|ΠΑΝΑΓ|ΠΑΤΡ|ΠΗΛ|ΠΗΝ|ΠΛΑΙΣ|ΠΟΝΤ|ΡΑΔ|ΡΟΔ|ΣΚ|ΣΚΟΡΠ|ΣΟΥΝ|ΣΠΑΝ|ΣΤΑΔ|ΣΥΡ|ΤΗΛ|ΤΙΜ|ΤΟΚ|ΤΟΠ|ΤΡΟΧ|ΦΙΛ|ΦΩΤ|Χ|ΧΙΛ|ΧΡΩΜ|ΧΩΡ)$/.test(o[1]))&&(s+="Ι"),/^(ΠΑΛ)$/.test(o[1])&&(s+="ΑΙ")),null!==(o=/^(.+?)(ΙΚΟΣ|ΙΚΟΝ|ΙΚΕΙΣ|ΙΚΟΙ|ΙΚΕΣ|ΙΚΟΥΣ|ΙΚΗ|ΙΚΗΣ|ΙΚΟ|ΙΚΑ|ΙΚΟΥ|ΙΚΩΝ|ΙΚΩΣ)$/.exec(s))&&(s=o[1],(t(s)||/^(ΑΔ|ΑΛ|ΑΜΑΝ|ΑΜΕΡ|ΑΜΜΟΧΑΛ|ΑΝΗΘ|ΑΝΤΙΔ|ΑΠΛ|ΑΤΤ|ΑΦΡ|ΒΑΣ|ΒΡΩΜ|ΓΕΝ|ΓΕΡ|Δ|ΔΙΚΑΝ|ΔΥΤ|ΕΙΔ|ΕΝΔ|ΕΞΩΔ|ΗΘ|ΘΕΤ|ΚΑΛΛΙΝ|ΚΑΛΠ|ΚΑΤΑΔ|ΚΟΥΖΙΝ|ΚΡ|ΚΩΔ|ΛΟΓ|Μ|ΜΕΡ|ΜΟΝΑΔ|ΜΟΥΛ|ΜΟΥΣ|ΜΠΑΓΙΑΤ|ΜΠΑΝ|ΜΠΟΛ|ΜΠΟΣ|ΜΥΣΤ|Ν|ΝΙΤ|ΞΙΚ|ΟΠΤ|ΠΑΝ|ΠΕΤΣ|ΠΙΚΑΝΤ|ΠΙΤΣ|ΠΛΑΣΤ|ΠΛΙΑΤΣ|ΠΟΝΤ|ΠΟΣΤΕΛΝ|ΠΡΩΤΟΔ|ΣΕΡΤ|ΣΗΜΑΝΤ|ΣΤΑΤ|ΣΥΝΑΔ|ΣΥΝΟΜΗΛ|ΤΕΛ|ΤΕΧΝ|ΤΡΟΠ|ΤΣΑΜ|ΥΠΟΔ|Φ|ΦΙΛΟΝ|ΦΥΛΟΔ|ΦΥΣ|ΧΑΣ)$/.test(o[1])||/(ΦΟΙΝ)$/.test(o[1]))&&(s+="ΙΚ")),"ΑΓΑΜΕ"===s&&(s="ΑΓΑΜ"),null!==(o=/^(.+?)(ΑΓΑΜΕ|ΗΣΑΜΕ|ΟΥΣΑΜΕ|ΗΚΑΜΕ|ΗΘΗΚΑΜΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΑΜΕ)$/.exec(s))&&(s=o[1],/^(ΑΝΑΠ|ΑΠΟΘ|ΑΠΟΚ|ΑΠΟΣΤ|ΒΟΥΒ|ΞΕΘ|ΟΥΛ|ΠΕΘ|ΠΙΚΡ|ΠΟΤ|ΣΙΧ|Χ)$/.test(o[1])&&(s+="ΑΜ")),null!==(o=/^(.+?)(ΑΓΑΝΕ|ΗΣΑΝΕ|ΟΥΣΑΝΕ|ΙΟΝΤΑΝΕ|ΙΟΤΑΝΕ|ΙΟΥΝΤΑΝΕ|ΟΝΤΑΝΕ|ΟΤΑΝΕ|ΟΥΝΤΑΝΕ|ΗΚΑΝΕ|ΗΘΗΚΑΝΕ)$/.exec(s))&&(s=o[1],/^(ΤΡ|ΤΣ)$/.test(o[1])&&(s+="ΑΓΑΝ")),null!==(o=/^(.+?)(ΑΝΕ)$/.exec(s))&&(s=o[1],(r(s)||/^(ΒΕΤΕΡ|ΒΟΥΛΚ|ΒΡΑΧΜ|Γ|ΔΡΑΔΟΥΜ|Θ|ΚΑΛΠΟΥΖ|ΚΑΣΤΕΛ|ΚΟΡΜΟΡ|ΛΑΟΠΛ|ΜΩΑΜΕΘ|Μ|ΜΟΥΣΟΥΛΜΑΝ|ΟΥΛ|Π|ΠΕΛΕΚ|ΠΛ|ΠΟΛΙΣ|ΠΟΡΤΟΛ|ΣΑΡΑΚΑΤΣ|ΣΟΥΛΤ|ΤΣΑΡΛΑΤ|ΟΡΦ|ΤΣΙΓΓ|ΤΣΟΠ|ΦΩΤΟΣΤΕΦ|Χ|ΨΥΧΟΠΛ|ΑΓ|ΟΡΦ|ΓΑΛ|ΓΕΡ|ΔΕΚ|ΔΙΠΛ|ΑΜΕΡΙΚΑΝ|ΟΥΡ|ΠΙΘ|ΠΟΥΡΙΤ|Σ|ΖΩΝΤ|ΙΚ|ΚΑΣΤ|ΚΟΠ|ΛΙΧ|ΛΟΥΘΗΡ|ΜΑΙΝΤ|ΜΕΛ|ΣΙΓ|ΣΠ|ΣΤΕΓ|ΤΡΑΓ|ΤΣΑΓ|Φ|ΕΡ|ΑΔΑΠ|ΑΘΙΓΓ|ΑΜΗΧ|ΑΝΙΚ|ΑΝΟΡΓ|ΑΠΗΓ|ΑΠΙΘ|ΑΤΣΙΓΓ|ΒΑΣ|ΒΑΣΚ|ΒΑΘΥΓΑΛ|ΒΙΟΜΗΧ|ΒΡΑΧΥΚ|ΔΙΑΤ|ΔΙΑΦ|ΕΝΟΡΓ|ΘΥΣ|ΚΑΠΝΟΒΙΟΜΗΧ|ΚΑΤΑΓΑΛ|ΚΛΙΒ|ΚΟΙΛΑΡΦ|ΛΙΒ|ΜΕΓΛΟΒΙΟΜΗΧ|ΜΙΚΡΟΒΙΟΜΗΧ|ΝΤΑΒ|ΞΗΡΟΚΛΙΒ|ΟΛΙΓΟΔΑΜ|ΟΛΟΓΑΛ|ΠΕΝΤΑΡΦ|ΠΕΡΗΦ|ΠΕΡΙΤΡ|ΠΛΑΤ|ΠΟΛΥΔΑΠ|ΠΟΛΥΜΗΧ|ΣΤΕΦ|ΤΑΒ|ΤΕΤ|ΥΠΕΡΗΦ|ΥΠΟΚΟΠ|ΧΑΜΗΛΟΔΑΠ|ΨΗΛΟΤΑΒ)$/.test(o[1]))&&(s+="ΑΝ")),null!==(o=/^(.+?)(ΗΣΕΤΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΕΤΕ)$/.exec(s))&&(s=o[1],(r(s)||/(ΟΔ|ΑΙΡ|ΦΟΡ|ΤΑΘ|ΔΙΑΘ|ΣΧ|ΕΝΔ|ΕΥΡ|ΤΙΘ|ΥΠΕΡΘ|ΡΑΘ|ΕΝΘ|ΡΟΘ|ΣΘ|ΠΥΡ|ΑΙΝ|ΣΥΝΔ|ΣΥΝ|ΣΥΝΘ|ΧΩΡ|ΠΟΝ|ΒΡ|ΚΑΘ|ΕΥΘ|ΕΚΘ|ΝΕΤ|ΡΟΝ|ΑΡΚ|ΒΑΡ|ΒΟΛ|ΩΦΕΛ)$/.test(o[1])||/^(ΑΒΑΡ|ΒΕΝ|ΕΝΑΡ|ΑΒΡ|ΑΔ|ΑΘ|ΑΝ|ΑΠΛ|ΒΑΡΟΝ|ΝΤΡ|ΣΚ|ΚΟΠ|ΜΠΟΡ|ΝΙΦ|ΠΑΓ|ΠΑΡΑΚΑΛ|ΣΕΡΠ|ΣΚΕΛ|ΣΥΡΦ|ΤΟΚ|Υ|Δ|ΕΜ|ΘΑΡΡ|Θ)$/.test(o[1]))&&(s+="ΕΤ")),null!==(o=/^(.+?)(ΟΝΤΑΣ|ΩΝΤΑΣ)$/.exec(s))&&(s=o[1],/^ΑΡΧ$/.test(o[1])&&(s+="ΟΝΤ"),/ΚΡΕ$/.test(o[1])&&(s+="ΩΝΤ")),null!==(o=/^(.+?)(ΟΜΑΣΤΕ|ΙΟΜΑΣΤΕ)$/.exec(s))&&(s=o[1],/^ΟΝ$/.test(o[1])&&(s+="ΟΜΑΣΤ")),null!==(o=/^(.+?)(ΙΕΣΤΕ)$/.exec(s))&&(s=o[1],/^(Π|ΑΠ|ΣΥΜΠ|ΑΣΥΜΠ|ΑΚΑΤΑΠ|ΑΜΕΤΑΜΦ)$/.test(o[1])&&(s+="ΙΕΣΤ")),null!==(o=/^(.+?)(ΕΣΤΕ)$/.exec(s))&&(s=o[1],/^(ΑΛ|ΑΡ|ΕΚΤΕΛ|Ζ|Μ|Ξ|ΠΑΡΑΚΑΛ|ΠΡΟ|ΝΙΣ)$/.test(o[1])&&(s+="ΕΣΤ")),null!==(o=/^(.+?)(ΗΘΗΚΑ|ΗΘΗΚΕΣ|ΗΘΗΚΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΗΚΑ|ΗΚΕΣ|ΗΚΕ)$/.exec(s))&&(s=o[1],(/(ΣΚΩΛ|ΣΚΟΥΛ|ΝΑΡΘ|ΣΦ|ΟΘ|ΠΙΘ)$/.test(o[1])||/^(ΔΙΑΘ|Θ|ΠΑΡΑΚΑΤΑΘ|ΠΡΟΣΘ|ΣΥΝΘ)$/.test(o[1]))&&(s+="ΗΚ")),null!==(o=/^(.+?)(ΟΥΣΑ|ΟΥΣΕΣ|ΟΥΣΕ)$/.exec(s))&&(s=o[1],(t(s)||/^(ΦΑΡΜΑΚ|ΧΑΔ|ΑΓΚ|ΑΝΑΡΡ|ΒΡΟΜ|ΕΚΛΙΠ|ΛΑΜΠΙΔ|ΛΕΧ|Μ|ΠΑΤ|Ρ|Λ|ΜΕΔ|ΜΕΣΑΖ|ΥΠΟΤΕΙΝ|ΑΜ|ΑΙΘ|ΑΝΗΚ|ΔΕΣΠΟΖ|ΕΝΔΙΑΦΕΡ)$/.test(o[1])||/(ΠΟΔΑΡ|ΒΛΕΠ|ΠΑΝΤΑΧ|ΦΡΥΔ|ΜΑΝΤΙΛ|ΜΑΛΛ|ΚΥΜΑΤ|ΛΑΧ|ΛΗΓ|ΦΑΓ|ΟΜ|ΠΡΩΤ)$/.test(o[1]))&&(s+="ΟΥΣ")),null!==(o=/^(.+?)(ΑΓΑ|ΑΓΕΣ|ΑΓΕ)$/.exec(s))&&(s=o[1],(/^(ΑΒΑΣΤ|ΠΟΛΥΦ|ΑΔΗΦ|ΠΑΜΦ|Ρ|ΑΣΠ|ΑΦ|ΑΜΑΛ|ΑΜΑΛΛΙ|ΑΝΥΣΤ|ΑΠΕΡ|ΑΣΠΑΡ|ΑΧΑΡ|ΔΕΡΒΕΝ|ΔΡΟΣΟΠ|ΞΕΦ|ΝΕΟΠ|ΝΟΜΟΤ|ΟΛΟΠ|ΟΜΟΤ|ΠΡΟΣΤ|ΠΡΟΣΩΠΟΠ|ΣΥΜΠ|ΣΥΝΤ|Τ|ΥΠΟΤ|ΧΑΡ|ΑΕΙΠ|ΑΙΜΟΣΤ|ΑΝΥΠ|ΑΠΟΤ|ΑΡΤΙΠ|ΔΙΑΤ|ΕΝ|ΕΠΙΤ|ΚΡΟΚΑΛΟΠ|ΣΙΔΗΡΟΠ|Λ|ΝΑΥ|ΟΥΛΑΜ|ΟΥΡ|Π|ΤΡ|Μ)$/.test(o[1])||/(ΟΦ|ΠΕΛ|ΧΟΡΤ|ΛΛ|ΣΦ|ΡΠ|ΦΡ|ΠΡ|ΛΟΧ|ΣΜΗΝ)$/.test(o[1])&&!/^(ΨΟΦ|ΝΑΥΛΟΧ)$/.test(o[1])||/(ΚΟΛΛ)$/.test(o[1]))&&(s+="ΑΓ")),null!==(o=/^(.+?)(ΗΣΕ|ΗΣΟΥ|ΗΣΑ)$/.exec(s))&&(s=o[1],/^(Ν|ΧΕΡΣΟΝ|ΔΩΔΕΚΑΝ|ΕΡΗΜΟΝ|ΜΕΓΑΛΟΝ|ΕΠΤΑΝ|Ι)$/.test(o[1])&&(s+="ΗΣ")),null!==(o=/^(.+?)(ΗΣΤΕ)$/.exec(s))&&(s=o[1],/^(ΑΣΒ|ΣΒ|ΑΧΡ|ΧΡ|ΑΠΛ|ΑΕΙΜΝ|ΔΥΣΧΡ|ΕΥΧΡ|ΚΟΙΝΟΧΡ|ΠΑΛΙΜΨ)$/.test(o[1])&&(s+="ΗΣΤ")),null!==(o=/^(.+?)(ΟΥΝΕ|ΗΣΟΥΝΕ|ΗΘΟΥΝΕ)$/.exec(s))&&(s=o[1],/^(Ν|Ρ|ΣΠΙ|ΣΤΡΑΒΟΜΟΥΤΣ|ΚΑΚΟΜΟΥΤΣ|ΕΞΩΝ)$/.test(o[1])&&(s+="ΟΥΝ")),null!==(o=/^(.+?)(ΟΥΜΕ|ΗΣΟΥΜΕ|ΗΘΟΥΜΕ)$/.exec(s))&&(s=o[1],/^(ΠΑΡΑΣΟΥΣ|Φ|Χ|ΩΡΙΟΠΛ|ΑΖ|ΑΛΛΟΣΟΥΣ|ΑΣΟΥΣ)$/.test(o[1])&&(s+="ΟΥΜ")),null!=(o=/^(.+?)(ΜΑΤΟΙ|ΜΑΤΟΥΣ|ΜΑΤΟ|ΜΑΤΑ|ΜΑΤΩΣ|ΜΑΤΩΝ|ΜΑΤΟΣ|ΜΑΤΕΣ|ΜΑΤΗ|ΜΑΤΗΣ|ΜΑΤΟΥ)$/.exec(s))&&(s=o[1]+"Μ",/^(ΓΡΑΜ)$/.test(o[1])?s+="Α":/^(ΓΕ|ΣΤΑ)$/.test(o[1])&&(s+="ΑΤ")),null!==(o=/^(.+?)(ΟΥΑ)$/.exec(s))&&(s=o[1]+"ΟΥ"),n.length===s.length&&null!==(o=/^(.+?)(Α|ΑΓΑΤΕ|ΑΓΑΝ|ΑΕΙ|ΑΜΑΙ|ΑΝ|ΑΣ|ΑΣΑΙ|ΑΤΑΙ|ΑΩ|Ε|ΕΙ|ΕΙΣ|ΕΙΤΕ|ΕΣΑΙ|ΕΣ|ΕΤΑΙ|Ι|ΙΕΜΑΙ|ΙΕΜΑΣΤΕ|ΙΕΤΑΙ|ΙΕΣΑΙ|ΙΕΣΑΣΤΕ|ΙΟΜΑΣΤΑΝ|ΙΟΜΟΥΝ|ΙΟΜΟΥΝΑ|ΙΟΝΤΑΝ|ΙΟΝΤΟΥΣΑΝ|ΙΟΣΑΣΤΑΝ|ΙΟΣΑΣΤΕ|ΙΟΣΟΥΝ|ΙΟΣΟΥΝΑ|ΙΟΤΑΝ|ΙΟΥΜΑ|ΙΟΥΜΑΣΤΕ|ΙΟΥΝΤΑΙ|ΙΟΥΝΤΑΝ|Η|ΗΔΕΣ|ΗΔΩΝ|ΗΘΕΙ|ΗΘΕΙΣ|ΗΘΕΙΤΕ|ΗΘΗΚΑΤΕ|ΗΘΗΚΑΝ|ΗΘΟΥΝ|ΗΘΩ|ΗΚΑΤΕ|ΗΚΑΝ|ΗΣ|ΗΣΑΝ|ΗΣΑΤΕ|ΗΣΕΙ|ΗΣΕΣ|ΗΣΟΥΝ|ΗΣΩ|Ο|ΟΙ|ΟΜΑΙ|ΟΜΑΣΤΑΝ|ΟΜΟΥΝ|ΟΜΟΥΝΑ|ΟΝΤΑΙ|ΟΝΤΑΝ|ΟΝΤΟΥΣΑΝ|ΟΣ|ΟΣΑΣΤΑΝ|ΟΣΑΣΤΕ|ΟΣΟΥΝ|ΟΣΟΥΝΑ|ΟΤΑΝ|ΟΥ|ΟΥΜΑΙ|ΟΥΜΑΣΤΕ|ΟΥΝ|ΟΥΝΤΑΙ|ΟΥΝΤΑΝ|ΟΥΣ|ΟΥΣΑΝ|ΟΥΣΑΤΕ|Υ||ΥΑ|ΥΣ|Ω|ΩΝ|ΟΙΣ)$/.exec(s))&&(s=o[1]),null!=(o=/^(.+?)(ΕΣΤΕΡ|ΕΣΤΑΤ|ΟΤΕΡ|ΟΤΑΤ|ΥΤΕΡ|ΥΤΑΤ|ΩΤΕΡ|ΩΤΑΤ)$/.exec(s))&&(/^(ΕΞ|ΕΣ|ΑΝ|ΚΑΤ|Κ|ΠΡ)$/.test(o[1])||(s=o[1]),/^(ΚΑ|Μ|ΕΛΕ|ΛΕ|ΔΕ)$/.test(o[1])&&(s+="ΥΤ")),s}var l={"ΦΑΓΙΑ":"ΦΑ","ΦΑΓΙΟΥ":"ΦΑ","ΦΑΓΙΩΝ":"ΦΑ","ΣΚΑΓΙΑ":"ΣΚΑ","ΣΚΑΓΙΟΥ":"ΣΚΑ","ΣΚΑΓΙΩΝ":"ΣΚΑ","ΣΟΓΙΟΥ":"ΣΟ","ΣΟΓΙΑ":"ΣΟ","ΣΟΓΙΩΝ":"ΣΟ","ΤΑΤΟΓΙΑ":"ΤΑΤΟ","ΤΑΤΟΓΙΟΥ":"ΤΑΤΟ","ΤΑΤΟΓΙΩΝ":"ΤΑΤΟ","ΚΡΕΑΣ":"ΚΡΕ","ΚΡΕΑΤΟΣ":"ΚΡΕ","ΚΡΕΑΤΑ":"ΚΡΕ","ΚΡΕΑΤΩΝ":"ΚΡΕ","ΠΕΡΑΣ":"ΠΕΡ","ΠΕΡΑΤΟΣ":"ΠΕΡ","ΠΕΡΑΤΑ":"ΠΕΡ","ΠΕΡΑΤΩΝ":"ΠΕΡ","ΤΕΡΑΣ":"ΤΕΡ","ΤΕΡΑΤΟΣ":"ΤΕΡ","ΤΕΡΑΤΑ":"ΤΕΡ","ΤΕΡΑΤΩΝ":"ΤΕΡ","ΦΩΣ":"ΦΩ","ΦΩΤΟΣ":"ΦΩ","ΦΩΤΑ":"ΦΩ","ΦΩΤΩΝ":"ΦΩ","ΚΑΘΕΣΤΩΣ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΟΣ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΑ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΩΝ":"ΚΑΘΕΣΤ","ΓΕΓΟΝΟΣ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΟΣ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΑ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΩΝ":"ΓΕΓΟΝ","ΕΥΑ":"ΕΥ"},i=["ΑΚΡΙΒΩΣ","ΑΛΑ","ΑΛΛΑ","ΑΛΛΙΩΣ","ΑΛΛΟΤΕ","ΑΜΑ","ΑΝΩ","ΑΝΑ","ΑΝΑΜΕΣΑ","ΑΝΑΜΕΤΑΞΥ","ΑΝΕΥ","ΑΝΤΙ","ΑΝΤΙΠΕΡΑ","ΑΝΤΙΟ","ΑΞΑΦΝΑ","ΑΠΟ","ΑΠΟΨΕ","ΑΡΑ","ΑΡΑΓΕ","ΑΥΡΙΟ","ΑΦΟΙ","ΑΦΟΥ","ΑΦΟΤΟΥ","ΒΡΕ","ΓΕΙΑ","ΓΙΑ","ΓΙΑΤΙ","ΓΡΑΜΜΑ","ΔΕΗ","ΔΕΝ","ΔΗΛΑΔΗ","ΔΙΧΩΣ","ΔΥΟ","ΕΑΝ","ΕΓΩ","ΕΔΩ","ΕΔΑ","ΕΙΘΕ","ΕΙΜΑΙ","ΕΙΜΑΣΤΕ","ΕΙΣΑΙ","ΕΙΣΑΣΤΕ","ΕΙΝΑΙ","ΕΙΣΤΕ","ΕΙΤΕ","ΕΚΕΙ","ΕΚΟ","ΕΛΑ","ΕΜΑΣ","ΕΜΕΙΣ","ΕΝΤΕΛΩΣ","ΕΝΤΟΣ","ΕΝΤΩΜΕΤΑΞΥ","ΕΝΩ","ΕΞΙ","ΕΞΙΣΟΥ","ΕΞΗΣ","ΕΞΩ","ΕΟΚ","ΕΠΑΝΩ","ΕΠΕΙΔΗ","ΕΠΕΙΤΑ","ΕΠΙ","ΕΠΙΣΗΣ","ΕΠΟΜΕΝΩΣ","ΕΠΤΑ","ΕΣΑΣ","ΕΣΕΙΣ","ΕΣΤΩ","ΕΣΥ","ΕΣΩ","ΕΤΣΙ","ΕΥΓΕ","ΕΦΕ","ΕΦΕΞΗΣ","ΕΧΤΕΣ","ΕΩΣ","ΗΔΗ","ΗΜΙ","ΗΠΑ","ΗΤΟΙ","ΘΕΣ","ΙΔΙΩΣ","ΙΔΗ","ΙΚΑ","ΙΣΩΣ","ΚΑΘΕ","ΚΑΘΕΤΙ","ΚΑΘΟΛΟΥ","ΚΑΘΩΣ","ΚΑΙ","ΚΑΝ","ΚΑΠΟΤΕ","ΚΑΠΟΥ","ΚΑΤΑ","ΚΑΤΙ","ΚΑΤΟΠΙΝ","ΚΑΤΩ","ΚΕΙ","ΚΙΧ","ΚΚΕ","ΚΟΛΑΝ","ΚΥΡΙΩΣ","ΚΩΣ","ΜΑΚΑΡΙ","ΜΑΛΙΣΤΑ","ΜΑΛΛΟΝ","ΜΑΙ","ΜΑΟ","ΜΑΟΥΣ","ΜΑΣ","ΜΕΘΑΥΡΙΟ","ΜΕΣ","ΜΕΣΑ","ΜΕΤΑ","ΜΕΤΑΞΥ","ΜΕΧΡΙ","ΜΗΔΕ","ΜΗΝ","ΜΗΠΩΣ","ΜΗΤΕ","ΜΙΑ","ΜΙΑΣ","ΜΙΣ","ΜΜΕ","ΜΟΛΟΝΟΤΙ","ΜΟΥ","ΜΠΑ","ΜΠΑΣ","ΜΠΟΥΦΑΝ","ΜΠΡΟΣ","ΝΑΙ","ΝΕΣ","ΝΤΑ","ΝΤΕ","ΞΑΝΑ","ΟΗΕ","ΟΚΤΩ","ΟΜΩΣ","ΟΝΕ","ΟΠΑ","ΟΠΟΥ","ΟΠΩΣ","ΟΣΟ","ΟΤΑΝ","ΟΤΕ","ΟΤΙ","ΟΥΤΕ","ΟΧΙ","ΠΑΛΙ","ΠΑΝ","ΠΑΝΟ","ΠΑΝΤΟΤΕ","ΠΑΝΤΟΥ","ΠΑΝΤΩΣ","ΠΑΝΩ","ΠΑΡΑ","ΠΕΡΑ","ΠΕΡΙ","ΠΕΡΙΠΟΥ","ΠΙΑ","ΠΙΟ","ΠΙΣΩ","ΠΛΑΙ","ΠΛΕΟΝ","ΠΛΗΝ","ΠΟΤΕ","ΠΟΥ","ΠΡΟ","ΠΡΟΣ","ΠΡΟΧΤΕΣ","ΠΡΟΧΘΕΣ","ΡΟΔΙ","ΠΩΣ","ΣΑΙ","ΣΑΣ","ΣΑΝ","ΣΕΙΣ","ΣΙΑ","ΣΚΙ","ΣΟΙ","ΣΟΥ","ΣΡΙ","ΣΥΝ","ΣΥΝΑΜΑ","ΣΧΕΔΟΝ","ΤΑΔΕ","ΤΑΞΙ","ΤΑΧΑ","ΤΕΙ","ΤΗΝ","ΤΗΣ","ΤΙΠΟΤΑ","ΤΙΠΟΤΕ","ΤΙΣ","ΤΟΝ","ΤΟΤΕ","ΤΟΥ","ΤΟΥΣ","ΤΣΑ","ΤΣΕ","ΤΣΙ","ΤΣΟΥ","ΤΩΝ","ΥΠΟ","ΥΠΟΨΗ","ΥΠΟΨΙΝ","ΥΣΤΕΡΑ","ΦΕΤΟΣ","ΦΙΣ","ΦΠΑ","ΧΑΦ","ΧΘΕΣ","ΧΤΕΣ","ΧΩΡΙΣ","ΩΣ","ΩΣΑΝ","ΩΣΟΤΟΥ","ΩΣΠΟΥ","ΩΣΤΕ","ΩΣΤΟΣΟ"],s=new RegExp("^[ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩ]+$");return function(e){return"function"==typeof e.update?e.update(function(e){return n(e.toUpperCase()).toLowerCase()}):n(e.toUpperCase()).toLowerCase()}}(),e.Pipeline.registerFunction(e.el.stemmer,"stemmer-el"),e.el.stopWordFilter=e.generateStopWordFilter("αλλα αν αντι απο αυτα αυτεσ αυτη αυτο αυτοι αυτοσ αυτουσ αυτων για δε δεν εαν ειμαι ειμαστε ειναι εισαι ειστε εκεινα εκεινεσ εκεινη εκεινο εκεινοι εκεινοσ εκεινουσ εκεινων ενω επι η θα ισωσ κ και κατα κι μα με μετα μη μην να ο οι ομωσ οπωσ οσο οτι παρα ποια ποιεσ ποιο ποιοι ποιοσ ποιουσ ποιων που προσ πωσ σε στη στην στο στον τα την τησ το τον τοτε του των ωσ".split(" ")),e.Pipeline.registerFunction(e.el.stopWordFilter,"stopWordFilter-el"),e.el.normilizer=function(){var e={"Ά":"Α","ά":"α","Έ":"Ε","έ":"ε","Ή":"Η","ή":"η","Ί":"Ι","ί":"ι","Ό":"Ο","ο":"ο","Ύ":"Υ","ύ":"υ","Ώ":"Ω","ώ":"ω","Ϊ":"Ι","ϊ":"ι","Ϋ":"Υ","ϋ":"υ","ΐ":"ι","ΰ":"υ"};return function(t){if("function"==typeof t.update)return t.update(function(t){for(var r="",n=0;n<t.length;n++)r+=e[t.charAt(n)]||t.charAt(n);return r});for(var r="",n=0;n<t.length;n++)r+=e[t.charAt(n)]||t.charAt(n);return r}}(),e.Pipeline.registerFunction(e.el.normilizer,"normilizer-el")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.es.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.es.min.js
deleted file mode 100644
index 2989d3426..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.es.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Spanish` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,s){"function"==typeof define&&define.amd?define(s):"object"==typeof exports?module.exports=s():s()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.es=function(){this.pipeline.reset(),this.pipeline.add(e.es.trimmer,e.es.stopWordFilter,e.es.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.es.stemmer))},e.es.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.es.trimmer=e.trimmerSupport.generateTrimmer(e.es.wordCharacters),e.Pipeline.registerFunction(e.es.trimmer,"trimmer-es"),e.es.stemmer=function(){var s=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(){if(A.out_grouping(x,97,252)){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}return!0}function n(){if(A.in_grouping(x,97,252)){var s=A.cursor;if(e()){if(A.cursor=s,!A.in_grouping(x,97,252))return!0;for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}}return!1}return!0}function i(){var s,r=A.cursor;if(n()){if(A.cursor=r,!A.out_grouping(x,97,252))return;if(s=A.cursor,e()){if(A.cursor=s,!A.in_grouping(x,97,252)||A.cursor>=A.limit)return;A.cursor++}}g=A.cursor}function a(){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}return!0}function t(){var e=A.cursor;g=A.limit,p=g,v=g,i(),A.cursor=e,a()&&(p=A.cursor,a()&&(v=A.cursor))}function o(){for(var e;;){if(A.bra=A.cursor,e=A.find_among(k,6))switch(A.ket=A.cursor,e){case 1:A.slice_from("a");continue;case 2:A.slice_from("e");continue;case 3:A.slice_from("i");continue;case 4:A.slice_from("o");continue;case 5:A.slice_from("u");continue;case 6:if(A.cursor>=A.limit)break;A.cursor++;continue}break}}function u(){return g<=A.cursor}function w(){return p<=A.cursor}function c(){return v<=A.cursor}function m(){var e;if(A.ket=A.cursor,A.find_among_b(y,13)&&(A.bra=A.cursor,(e=A.find_among_b(q,11))&&u()))switch(e){case 1:A.bra=A.cursor,A.slice_from("iendo");break;case 2:A.bra=A.cursor,A.slice_from("ando");break;case 3:A.bra=A.cursor,A.slice_from("ar");break;case 4:A.bra=A.cursor,A.slice_from("er");break;case 5:A.bra=A.cursor,A.slice_from("ir");break;case 6:A.slice_del();break;case 7:A.eq_s_b(1,"u")&&A.slice_del()}}function l(e,s){if(!c())return!0;A.slice_del(),A.ket=A.cursor;var r=A.find_among_b(e,s);return r&&(A.bra=A.cursor,1==r&&c()&&A.slice_del()),!1}function d(e){return!c()||(A.slice_del(),A.ket=A.cursor,A.eq_s_b(2,e)&&(A.bra=A.cursor,c()&&A.slice_del()),!1)}function b(){var e;if(A.ket=A.cursor,e=A.find_among_b(S,46)){switch(A.bra=A.cursor,e){case 1:if(!c())return!1;A.slice_del();break;case 2:if(d("ic"))return!1;break;case 3:if(!c())return!1;A.slice_from("log");break;case 4:if(!c())return!1;A.slice_from("u");break;case 5:if(!c())return!1;A.slice_from("ente");break;case 6:if(!w())return!1;A.slice_del(),A.ket=A.cursor,e=A.find_among_b(C,4),e&&(A.bra=A.cursor,c()&&(A.slice_del(),1==e&&(A.ket=A.cursor,A.eq_s_b(2,"at")&&(A.bra=A.cursor,c()&&A.slice_del()))));break;case 7:if(l(P,3))return!1;break;case 8:if(l(F,3))return!1;break;case 9:if(d("at"))return!1}return!0}return!1}function f(){var e,s;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(W,12),A.limit_backward=s,e)){if(A.bra=A.cursor,1==e){if(!A.eq_s_b(1,"u"))return!1;A.slice_del()}return!0}return!1}function _(){var e,s,r,n;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(L,96),A.limit_backward=s,e))switch(A.bra=A.cursor,e){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"u")?(n=A.limit-A.cursor,A.eq_s_b(1,"g")?A.cursor=A.limit-n:A.cursor=A.limit-r):A.cursor=A.limit-r,A.bra=A.cursor;case 2:A.slice_del()}}function h(){var e,s;if(A.ket=A.cursor,e=A.find_among_b(z,8))switch(A.bra=A.cursor,e){case 1:u()&&A.slice_del();break;case 2:u()&&(A.slice_del(),A.ket=A.cursor,A.eq_s_b(1,"u")&&(A.bra=A.cursor,s=A.limit-A.cursor,A.eq_s_b(1,"g")&&(A.cursor=A.limit-s,u()&&A.slice_del())))}}var v,p,g,k=[new s("",-1,6),new s("á",0,1),new s("é",0,2),new s("í",0,3),new s("ó",0,4),new s("ú",0,5)],y=[new s("la",-1,-1),new s("sela",0,-1),new s("le",-1,-1),new s("me",-1,-1),new s("se",-1,-1),new s("lo",-1,-1),new s("selo",5,-1),new s("las",-1,-1),new s("selas",7,-1),new s("les",-1,-1),new s("los",-1,-1),new s("selos",10,-1),new s("nos",-1,-1)],q=[new s("ando",-1,6),new s("iendo",-1,6),new s("yendo",-1,7),new s("ándo",-1,2),new s("iéndo",-1,1),new s("ar",-1,6),new s("er",-1,6),new s("ir",-1,6),new s("ár",-1,3),new s("ér",-1,4),new s("ír",-1,5)],C=[new s("ic",-1,-1),new s("ad",-1,-1),new s("os",-1,-1),new s("iv",-1,1)],P=[new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,1)],F=[new s("ic",-1,1),new s("abil",-1,1),new s("iv",-1,1)],S=[new s("ica",-1,1),new s("ancia",-1,2),new s("encia",-1,5),new s("adora",-1,2),new s("osa",-1,1),new s("ista",-1,1),new s("iva",-1,9),new s("anza",-1,1),new s("logía",-1,3),new s("idad",-1,8),new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,2),new s("mente",-1,7),new s("amente",13,6),new s("ación",-1,2),new s("ución",-1,4),new s("ico",-1,1),new s("ismo",-1,1),new s("oso",-1,1),new s("amiento",-1,1),new s("imiento",-1,1),new s("ivo",-1,9),new s("ador",-1,2),new s("icas",-1,1),new s("ancias",-1,2),new s("encias",-1,5),new s("adoras",-1,2),new s("osas",-1,1),new s("istas",-1,1),new s("ivas",-1,9),new s("anzas",-1,1),new s("logías",-1,3),new s("idades",-1,8),new s("ables",-1,1),new s("ibles",-1,1),new s("aciones",-1,2),new s("uciones",-1,4),new s("adores",-1,2),new s("antes",-1,2),new s("icos",-1,1),new s("ismos",-1,1),new s("osos",-1,1),new s("amientos",-1,1),new s("imientos",-1,1),new s("ivos",-1,9)],W=[new s("ya",-1,1),new s("ye",-1,1),new s("yan",-1,1),new s("yen",-1,1),new s("yeron",-1,1),new s("yendo",-1,1),new s("yo",-1,1),new s("yas",-1,1),new s("yes",-1,1),new s("yais",-1,1),new s("yamos",-1,1),new s("yó",-1,1)],L=[new s("aba",-1,2),new s("ada",-1,2),new s("ida",-1,2),new s("ara",-1,2),new s("iera",-1,2),new s("ía",-1,2),new s("aría",5,2),new s("ería",5,2),new s("iría",5,2),new s("ad",-1,2),new s("ed",-1,2),new s("id",-1,2),new s("ase",-1,2),new s("iese",-1,2),new s("aste",-1,2),new s("iste",-1,2),new s("an",-1,2),new s("aban",16,2),new s("aran",16,2),new s("ieran",16,2),new s("ían",16,2),new s("arían",20,2),new s("erían",20,2),new s("irían",20,2),new s("en",-1,1),new s("asen",24,2),new s("iesen",24,2),new s("aron",-1,2),new s("ieron",-1,2),new s("arán",-1,2),new s("erán",-1,2),new s("irán",-1,2),new s("ado",-1,2),new s("ido",-1,2),new s("ando",-1,2),new s("iendo",-1,2),new s("ar",-1,2),new s("er",-1,2),new s("ir",-1,2),new s("as",-1,2),new s("abas",39,2),new s("adas",39,2),new s("idas",39,2),new s("aras",39,2),new s("ieras",39,2),new s("ías",39,2),new s("arías",45,2),new s("erías",45,2),new s("irías",45,2),new s("es",-1,1),new s("ases",49,2),new s("ieses",49,2),new s("abais",-1,2),new s("arais",-1,2),new s("ierais",-1,2),new s("íais",-1,2),new s("aríais",55,2),new s("eríais",55,2),new s("iríais",55,2),new s("aseis",-1,2),new s("ieseis",-1,2),new s("asteis",-1,2),new s("isteis",-1,2),new s("áis",-1,2),new s("éis",-1,1),new s("aréis",64,2),new s("eréis",64,2),new s("iréis",64,2),new s("ados",-1,2),new s("idos",-1,2),new s("amos",-1,2),new s("ábamos",70,2),new s("áramos",70,2),new s("iéramos",70,2),new s("íamos",70,2),new s("aríamos",74,2),new s("eríamos",74,2),new s("iríamos",74,2),new s("emos",-1,1),new s("aremos",78,2),new s("eremos",78,2),new s("iremos",78,2),new s("ásemos",78,2),new s("iésemos",78,2),new s("imos",-1,2),new s("arás",-1,2),new s("erás",-1,2),new s("irás",-1,2),new s("ís",-1,2),new s("ará",-1,2),new s("erá",-1,2),new s("irá",-1,2),new s("aré",-1,2),new s("eré",-1,2),new s("iré",-1,2),new s("ió",-1,2)],z=[new s("a",-1,1),new s("e",-1,2),new s("o",-1,1),new s("os",-1,1),new s("á",-1,1),new s("é",-1,2),new s("í",-1,1),new s("ó",-1,1)],x=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,4,10],A=new r;this.setCurrent=function(e){A.setCurrent(e)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return t(),A.limit_backward=e,A.cursor=A.limit,m(),A.cursor=A.limit,b()||(A.cursor=A.limit,f()||(A.cursor=A.limit,_())),A.cursor=A.limit,h(),A.cursor=A.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.es.stemmer,"stemmer-es"),e.es.stopWordFilter=e.generateStopWordFilter("a al algo algunas algunos ante antes como con contra cual cuando de del desde donde durante e el ella ellas ellos en entre era erais eran eras eres es esa esas ese eso esos esta estaba estabais estaban estabas estad estada estadas estado estados estamos estando estar estaremos estará estarán estarás estaré estaréis estaría estaríais estaríamos estarían estarías estas este estemos esto estos estoy estuve estuviera estuvierais estuvieran estuvieras estuvieron estuviese estuvieseis estuviesen estuvieses estuvimos estuviste estuvisteis estuviéramos estuviésemos estuvo está estábamos estáis están estás esté estéis estén estés fue fuera fuerais fueran fueras fueron fuese fueseis fuesen fueses fui fuimos fuiste fuisteis fuéramos fuésemos ha habida habidas habido habidos habiendo habremos habrá habrán habrás habré habréis habría habríais habríamos habrían habrías habéis había habíais habíamos habían habías han has hasta hay haya hayamos hayan hayas hayáis he hemos hube hubiera hubierais hubieran hubieras hubieron hubiese hubieseis hubiesen hubieses hubimos hubiste hubisteis hubiéramos hubiésemos hubo la las le les lo los me mi mis mucho muchos muy más mí mía mías mío míos nada ni no nos nosotras nosotros nuestra nuestras nuestro nuestros o os otra otras otro otros para pero poco por porque que quien quienes qué se sea seamos sean seas seremos será serán serás seré seréis sería seríais seríamos serían serías seáis sido siendo sin sobre sois somos son soy su sus suya suyas suyo suyos sí también tanto te tendremos tendrá tendrán tendrás tendré tendréis tendría tendríais tendríamos tendrían tendrías tened tenemos tenga tengamos tengan tengas tengo tengáis tenida tenidas tenido tenidos teniendo tenéis tenía teníais teníamos tenían tenías ti tiene tienen tienes todo todos tu tus tuve tuviera tuvierais tuvieran tuvieras tuvieron tuviese tuvieseis tuviesen tuvieses tuvimos tuviste tuvisteis tuviéramos tuviésemos tuvo tuya tuyas tuyo tuyos tú un una uno unos vosotras vosotros vuestra vuestras vuestro vuestros y ya yo él éramos".split(" ")),e.Pipeline.registerFunction(e.es.stopWordFilter,"stopWordFilter-es")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.fi.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.fi.min.js
deleted file mode 100644
index 29f5dfcea..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.fi.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Finnish` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(i,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():e()(i.lunr)}(this,function(){return function(i){if(void 0===i)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===i.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");i.fi=function(){this.pipeline.reset(),this.pipeline.add(i.fi.trimmer,i.fi.stopWordFilter,i.fi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(i.fi.stemmer))},i.fi.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",i.fi.trimmer=i.trimmerSupport.generateTrimmer(i.fi.wordCharacters),i.Pipeline.registerFunction(i.fi.trimmer,"trimmer-fi"),i.fi.stemmer=function(){var e=i.stemmerSupport.Among,r=i.stemmerSupport.SnowballProgram,n=new function(){function i(){f=A.limit,d=f,n()||(f=A.cursor,n()||(d=A.cursor))}function n(){for(var i;;){if(i=A.cursor,A.in_grouping(W,97,246))break;if(A.cursor=i,i>=A.limit)return!0;A.cursor++}for(A.cursor=i;!A.out_grouping(W,97,246);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}function t(){return d<=A.cursor}function s(){var i,e;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(h,10)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.in_grouping_b(x,97,246))return;break;case 2:if(!t())return}A.slice_del()}else A.limit_backward=e}function o(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(v,9))switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"k")||(A.cursor=A.limit-r,A.slice_del());break;case 2:A.slice_del(),A.ket=A.cursor,A.eq_s_b(3,"kse")&&(A.bra=A.cursor,A.slice_from("ksi"));break;case 3:A.slice_del();break;case 4:A.find_among_b(p,6)&&A.slice_del();break;case 5:A.find_among_b(g,6)&&A.slice_del();break;case 6:A.find_among_b(j,2)&&A.slice_del()}else A.limit_backward=e}function l(){return A.find_among_b(q,7)}function a(){return A.eq_s_b(1,"i")&&A.in_grouping_b(L,97,246)}function u(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(C,30)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.eq_s_b(1,"a"))return;break;case 2:case 9:if(!A.eq_s_b(1,"e"))return;break;case 3:if(!A.eq_s_b(1,"i"))return;break;case 4:if(!A.eq_s_b(1,"o"))return;break;case 5:if(!A.eq_s_b(1,"ä"))return;break;case 6:if(!A.eq_s_b(1,"ö"))return;break;case 7:if(r=A.limit-A.cursor,!l()&&(A.cursor=A.limit-r,!A.eq_s_b(2,"ie"))){A.cursor=A.limit-r;break}if(A.cursor=A.limit-r,A.cursor<=A.limit_backward){A.cursor=A.limit-r;break}A.cursor--,A.bra=A.cursor;break;case 8:if(!A.in_grouping_b(W,97,246)||!A.out_grouping_b(W,97,246))return}A.slice_del(),k=!0}else A.limit_backward=e}function c(){var i,e,r;if(A.cursor>=d)if(e=A.limit_backward,A.limit_backward=d,A.ket=A.cursor,i=A.find_among_b(P,14)){if(A.bra=A.cursor,A.limit_backward=e,1==i){if(r=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-r}A.slice_del()}else A.limit_backward=e}function m(){var i;A.cursor>=f&&(i=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.find_among_b(F,2)?(A.bra=A.cursor,A.limit_backward=i,A.slice_del()):A.limit_backward=i)}function w(){var i,e,r,n,t,s;if(A.cursor>=f){if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.eq_s_b(1,"t")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.in_grouping_b(W,97,246)&&(A.cursor=A.limit-r,A.slice_del(),A.limit_backward=e,n=A.limit-A.cursor,A.cursor>=d&&(A.cursor=d,t=A.limit_backward,A.limit_backward=A.cursor,A.cursor=A.limit-n,A.ket=A.cursor,i=A.find_among_b(S,2))))){if(A.bra=A.cursor,A.limit_backward=t,1==i){if(s=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-s}return void A.slice_del()}A.limit_backward=e}}function _(){var i,e,r,n;if(A.cursor>=f){for(i=A.limit_backward,A.limit_backward=f,e=A.limit-A.cursor,l()&&(A.cursor=A.limit-e,A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.in_grouping_b(y,97,228)&&(A.bra=A.cursor,A.out_grouping_b(W,97,246)&&A.slice_del()),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"j")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.eq_s_b(1,"o")?A.slice_del():(A.cursor=A.limit-r,A.eq_s_b(1,"u")&&A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"o")&&(A.bra=A.cursor,A.eq_s_b(1,"j")&&A.slice_del()),A.cursor=A.limit-e,A.limit_backward=i;;){if(n=A.limit-A.cursor,A.out_grouping_b(W,97,246)){A.cursor=A.limit-n;break}if(A.cursor=A.limit-n,A.cursor<=A.limit_backward)return;A.cursor--}A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,b=A.slice_to(),A.eq_v_b(b)&&A.slice_del())}}var k,b,d,f,h=[new e("pa",-1,1),new e("sti",-1,2),new e("kaan",-1,1),new e("han",-1,1),new e("kin",-1,1),new e("hän",-1,1),new e("kään",-1,1),new e("ko",-1,1),new e("pä",-1,1),new e("kö",-1,1)],p=[new e("lla",-1,-1),new e("na",-1,-1),new e("ssa",-1,-1),new e("ta",-1,-1),new e("lta",3,-1),new e("sta",3,-1)],g=[new e("llä",-1,-1),new e("nä",-1,-1),new e("ssä",-1,-1),new e("tä",-1,-1),new e("ltä",3,-1),new e("stä",3,-1)],j=[new e("lle",-1,-1),new e("ine",-1,-1)],v=[new e("nsa",-1,3),new e("mme",-1,3),new e("nne",-1,3),new e("ni",-1,2),new e("si",-1,1),new e("an",-1,4),new e("en",-1,6),new e("än",-1,5),new e("nsä",-1,3)],q=[new e("aa",-1,-1),new e("ee",-1,-1),new e("ii",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1),new e("ää",-1,-1),new e("öö",-1,-1)],C=[new e("a",-1,8),new e("lla",0,-1),new e("na",0,-1),new e("ssa",0,-1),new e("ta",0,-1),new e("lta",4,-1),new e("sta",4,-1),new e("tta",4,9),new e("lle",-1,-1),new e("ine",-1,-1),new e("ksi",-1,-1),new e("n",-1,7),new e("han",11,1),new e("den",11,-1,a),new e("seen",11,-1,l),new e("hen",11,2),new e("tten",11,-1,a),new e("hin",11,3),new e("siin",11,-1,a),new e("hon",11,4),new e("hän",11,5),new e("hön",11,6),new e("ä",-1,8),new e("llä",22,-1),new e("nä",22,-1),new e("ssä",22,-1),new e("tä",22,-1),new e("ltä",26,-1),new e("stä",26,-1),new e("ttä",26,9)],P=[new e("eja",-1,-1),new e("mma",-1,1),new e("imma",1,-1),new e("mpa",-1,1),new e("impa",3,-1),new e("mmi",-1,1),new e("immi",5,-1),new e("mpi",-1,1),new e("impi",7,-1),new e("ejä",-1,-1),new e("mmä",-1,1),new e("immä",10,-1),new e("mpä",-1,1),new e("impä",12,-1)],F=[new e("i",-1,-1),new e("j",-1,-1)],S=[new e("mma",-1,1),new e("imma",0,-1)],y=[17,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8],W=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],x=[17,97,24,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],A=new r;this.setCurrent=function(i){A.setCurrent(i)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return i(),k=!1,A.limit_backward=e,A.cursor=A.limit,s(),A.cursor=A.limit,o(),A.cursor=A.limit,u(),A.cursor=A.limit,c(),A.cursor=A.limit,k?(m(),A.cursor=A.limit):(A.cursor=A.limit,w(),A.cursor=A.limit),_(),!0}};return function(i){return"function"==typeof i.update?i.update(function(i){return n.setCurrent(i),n.stem(),n.getCurrent()}):(n.setCurrent(i),n.stem(),n.getCurrent())}}(),i.Pipeline.registerFunction(i.fi.stemmer,"stemmer-fi"),i.fi.stopWordFilter=i.generateStopWordFilter("ei eivät emme en et ette että he heidän heidät heihin heille heillä heiltä heissä heistä heitä hän häneen hänelle hänellä häneltä hänen hänessä hänestä hänet häntä itse ja johon joiden joihin joiksi joilla joille joilta joina joissa joista joita joka joksi jolla jolle jolta jona jonka jos jossa josta jota jotka kanssa keiden keihin keiksi keille keillä keiltä keinä keissä keistä keitä keneen keneksi kenelle kenellä keneltä kenen kenenä kenessä kenestä kenet ketkä ketkä ketä koska kuin kuka kun me meidän meidät meihin meille meillä meiltä meissä meistä meitä mihin miksi mikä mille millä miltä minkä minkä minua minulla minulle minulta minun minussa minusta minut minuun minä minä missä mistä mitkä mitä mukaan mutta ne niiden niihin niiksi niille niillä niiltä niin niin niinä niissä niistä niitä noiden noihin noiksi noilla noille noilta noin noina noissa noista noita nuo nyt näiden näihin näiksi näille näillä näiltä näinä näissä näistä näitä nämä ole olemme olen olet olette oli olimme olin olisi olisimme olisin olisit olisitte olisivat olit olitte olivat olla olleet ollut on ovat poikki se sekä sen siihen siinä siitä siksi sille sillä sillä siltä sinua sinulla sinulle sinulta sinun sinussa sinusta sinut sinuun sinä sinä sitä tai te teidän teidät teihin teille teillä teiltä teissä teistä teitä tuo tuohon tuoksi tuolla tuolle tuolta tuon tuona tuossa tuosta tuota tähän täksi tälle tällä tältä tämä tämän tänä tässä tästä tätä vaan vai vaikka yli".split(" ")),i.Pipeline.registerFunction(i.fi.stopWordFilter,"stopWordFilter-fi")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.fr.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.fr.min.js
deleted file mode 100644
index 68cd0094a..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.fr.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `French` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.fr=function(){this.pipeline.reset(),this.pipeline.add(e.fr.trimmer,e.fr.stopWordFilter,e.fr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.fr.stemmer))},e.fr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.fr.trimmer=e.trimmerSupport.generateTrimmer(e.fr.wordCharacters),e.Pipeline.registerFunction(e.fr.trimmer,"trimmer-fr"),e.fr.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,s){return!(!W.eq_s(1,e)||(W.ket=W.cursor,!W.in_grouping(F,97,251)))&&(W.slice_from(r),W.cursor=s,!0)}function i(e,r,s){return!!W.eq_s(1,e)&&(W.ket=W.cursor,W.slice_from(r),W.cursor=s,!0)}function n(){for(var r,s;;){if(r=W.cursor,W.in_grouping(F,97,251)){if(W.bra=W.cursor,s=W.cursor,e("u","U",r))continue;if(W.cursor=s,e("i","I",r))continue;if(W.cursor=s,i("y","Y",r))continue}if(W.cursor=r,W.bra=r,!e("y","Y",r)){if(W.cursor=r,W.eq_s(1,"q")&&(W.bra=W.cursor,i("u","U",r)))continue;if(W.cursor=r,r>=W.limit)return;W.cursor++}}}function t(){for(;!W.in_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}for(;!W.out_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}return!1}function u(){var e=W.cursor;if(q=W.limit,g=q,p=q,W.in_grouping(F,97,251)&&W.in_grouping(F,97,251)&&W.cursor<W.limit)W.cursor++;else if(W.cursor=e,!W.find_among(v,3)){W.cursor=e;do{if(W.cursor>=W.limit){W.cursor=q;break}W.cursor++}while(!W.in_grouping(F,97,251))}q=W.cursor,W.cursor=e,t()||(g=W.cursor,t()||(p=W.cursor))}function o(){for(var e,r;;){if(r=W.cursor,W.bra=r,!(e=W.find_among(h,4)))break;switch(W.ket=W.cursor,e){case 1:W.slice_from("i");break;case 2:W.slice_from("u");break;case 3:W.slice_from("y");break;case 4:if(W.cursor>=W.limit)return;W.cursor++}}}function c(){return q<=W.cursor}function a(){return g<=W.cursor}function l(){return p<=W.cursor}function w(){var e,r;if(W.ket=W.cursor,e=W.find_among_b(C,43)){switch(W.bra=W.cursor,e){case 1:if(!l())return!1;W.slice_del();break;case 2:if(!l())return!1;W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")&&(W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU"));break;case 3:if(!l())return!1;W.slice_from("log");break;case 4:if(!l())return!1;W.slice_from("u");break;case 5:if(!l())return!1;W.slice_from("ent");break;case 6:if(!c())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(z,6))switch(W.bra=W.cursor,e){case 1:l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&W.slice_del()));break;case 2:l()?W.slice_del():a()&&W.slice_from("eux");break;case 3:l()&&W.slice_del();break;case 4:c()&&W.slice_from("i")}break;case 7:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(y,3))switch(W.bra=W.cursor,e){case 1:l()?W.slice_del():W.slice_from("abl");break;case 2:l()?W.slice_del():W.slice_from("iqU");break;case 3:l()&&W.slice_del()}break;case 8:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")))){W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU");break}break;case 9:W.slice_from("eau");break;case 10:if(!a())return!1;W.slice_from("al");break;case 11:if(l())W.slice_del();else{if(!a())return!1;W.slice_from("eux")}break;case 12:if(!a()||!W.out_grouping_b(F,97,251))return!1;W.slice_del();break;case 13:return c()&&W.slice_from("ant"),!1;case 14:return c()&&W.slice_from("ent"),!1;case 15:return r=W.limit-W.cursor,W.in_grouping_b(F,97,251)&&c()&&(W.cursor=W.limit-r,W.slice_del()),!1}return!0}return!1}function f(){var e,r;if(W.cursor<q)return!1;if(r=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,!(e=W.find_among_b(x,35)))return W.limit_backward=r,!1;if(W.bra=W.cursor,1==e){if(!W.out_grouping_b(F,97,251))return W.limit_backward=r,!1;W.slice_del()}return W.limit_backward=r,!0}function m(){var e,r,s;if(W.cursor<q)return!1;if(r=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,!(e=W.find_among_b(I,38)))return W.limit_backward=r,!1;switch(W.bra=W.cursor,e){case 1:if(!l())return W.limit_backward=r,!1;W.slice_del();break;case 2:W.slice_del();break;case 3:W.slice_del(),s=W.limit-W.cursor,W.ket=W.cursor,W.eq_s_b(1,"e")?(W.bra=W.cursor,W.slice_del()):W.cursor=W.limit-s}return W.limit_backward=r,!0}function _(){var e,r,s,i,n=W.limit-W.cursor;if(W.ket=W.cursor,W.eq_s_b(1,"s")?(W.bra=W.cursor,r=W.limit-W.cursor,W.out_grouping_b(S,97,232)?(W.cursor=W.limit-r,W.slice_del()):W.cursor=W.limit-n):W.cursor=W.limit-n,W.cursor>=q){if(s=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,e=W.find_among_b(P,7))switch(W.bra=W.cursor,e){case 1:if(l()){if(i=W.limit-W.cursor,!W.eq_s_b(1,"s")&&(W.cursor=W.limit-i,!W.eq_s_b(1,"t")))break;W.slice_del()}break;case 2:W.slice_from("i");break;case 3:W.slice_del();break;case 4:W.eq_s_b(2,"gu")&&W.slice_del()}W.limit_backward=s}}function b(){var e=W.limit-W.cursor;W.find_among_b(U,5)&&(W.cursor=W.limit-e,W.ket=W.cursor,W.cursor>W.limit_backward&&(W.cursor--,W.bra=W.cursor,W.slice_del()))}function d(){for(var e,r=1;W.out_grouping_b(F,97,251);)r--;if(r<=0){if(W.ket=W.cursor,e=W.limit-W.cursor,!W.eq_s_b(1,"é")&&(W.cursor=W.limit-e,!W.eq_s_b(1,"è")))return;W.bra=W.cursor,W.slice_from("e")}}function k(){if(!w()&&(W.cursor=W.limit,!f()&&(W.cursor=W.limit,!m())))return W.cursor=W.limit,void _();W.cursor=W.limit,W.ket=W.cursor,W.eq_s_b(1,"Y")?(W.bra=W.cursor,W.slice_from("i")):(W.cursor=W.limit,W.eq_s_b(1,"ç")&&(W.bra=W.cursor,W.slice_from("c")))}var p,g,q,v=[new r("col",-1,-1),new r("par",-1,-1),new r("tap",-1,-1)],h=[new r("",-1,4),new r("I",0,1),new r("U",0,2),new r("Y",0,3)],z=[new r("iqU",-1,3),new r("abl",-1,3),new r("Ièr",-1,4),new r("ièr",-1,4),new r("eus",-1,2),new r("iv",-1,1)],y=[new r("ic",-1,2),new r("abil",-1,1),new r("iv",-1,3)],C=[new r("iqUe",-1,1),new r("atrice",-1,2),new r("ance",-1,1),new r("ence",-1,5),new r("logie",-1,3),new r("able",-1,1),new r("isme",-1,1),new r("euse",-1,11),new r("iste",-1,1),new r("ive",-1,8),new r("if",-1,8),new r("usion",-1,4),new r("ation",-1,2),new r("ution",-1,4),new r("ateur",-1,2),new r("iqUes",-1,1),new r("atrices",-1,2),new r("ances",-1,1),new r("ences",-1,5),new r("logies",-1,3),new r("ables",-1,1),new r("ismes",-1,1),new r("euses",-1,11),new r("istes",-1,1),new r("ives",-1,8),new r("ifs",-1,8),new r("usions",-1,4),new r("ations",-1,2),new r("utions",-1,4),new r("ateurs",-1,2),new r("ments",-1,15),new r("ements",30,6),new r("issements",31,12),new r("ités",-1,7),new r("ment",-1,15),new r("ement",34,6),new r("issement",35,12),new r("amment",34,13),new r("emment",34,14),new r("aux",-1,10),new r("eaux",39,9),new r("eux",-1,1),new r("ité",-1,7)],x=[new r("ira",-1,1),new r("ie",-1,1),new r("isse",-1,1),new r("issante",-1,1),new r("i",-1,1),new r("irai",4,1),new r("ir",-1,1),new r("iras",-1,1),new r("ies",-1,1),new r("îmes",-1,1),new r("isses",-1,1),new r("issantes",-1,1),new r("îtes",-1,1),new r("is",-1,1),new r("irais",13,1),new r("issais",13,1),new r("irions",-1,1),new r("issions",-1,1),new r("irons",-1,1),new r("issons",-1,1),new r("issants",-1,1),new r("it",-1,1),new r("irait",21,1),new r("issait",21,1),new r("issant",-1,1),new r("iraIent",-1,1),new r("issaIent",-1,1),new r("irent",-1,1),new r("issent",-1,1),new r("iront",-1,1),new r("ît",-1,1),new r("iriez",-1,1),new r("issiez",-1,1),new r("irez",-1,1),new r("issez",-1,1)],I=[new r("a",-1,3),new r("era",0,2),new r("asse",-1,3),new r("ante",-1,3),new r("ée",-1,2),new r("ai",-1,3),new r("erai",5,2),new r("er",-1,2),new r("as",-1,3),new r("eras",8,2),new r("âmes",-1,3),new r("asses",-1,3),new r("antes",-1,3),new r("âtes",-1,3),new r("ées",-1,2),new r("ais",-1,3),new r("erais",15,2),new r("ions",-1,1),new r("erions",17,2),new r("assions",17,3),new r("erons",-1,2),new r("ants",-1,3),new r("és",-1,2),new r("ait",-1,3),new r("erait",23,2),new r("ant",-1,3),new r("aIent",-1,3),new r("eraIent",26,2),new r("èrent",-1,2),new r("assent",-1,3),new r("eront",-1,2),new r("ât",-1,3),new r("ez",-1,2),new r("iez",32,2),new r("eriez",33,2),new r("assiez",33,3),new r("erez",32,2),new r("é",-1,2)],P=[new r("e",-1,3),new r("Ière",0,2),new r("ière",0,2),new r("ion",-1,1),new r("Ier",-1,2),new r("ier",-1,2),new r("ë",-1,4)],U=[new r("ell",-1,-1),new r("eill",-1,-1),new r("enn",-1,-1),new r("onn",-1,-1),new r("ett",-1,-1)],F=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,128,130,103,8,5],S=[1,65,20,0,0,0,0,0,0,0,0,0,0,0,0,0,128],W=new s;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){var e=W.cursor;return n(),W.cursor=e,u(),W.limit_backward=e,W.cursor=W.limit,k(),W.cursor=W.limit,b(),W.cursor=W.limit,d(),W.cursor=W.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.fr.stemmer,"stemmer-fr"),e.fr.stopWordFilter=e.generateStopWordFilter("ai aie aient aies ait as au aura aurai auraient aurais aurait auras aurez auriez aurions aurons auront aux avaient avais avait avec avez aviez avions avons ayant ayez ayons c ce ceci celà ces cet cette d dans de des du elle en es est et eu eue eues eurent eus eusse eussent eusses eussiez eussions eut eux eûmes eût eûtes furent fus fusse fussent fusses fussiez fussions fut fûmes fût fûtes ici il ils j je l la le les leur leurs lui m ma mais me mes moi mon même n ne nos notre nous on ont ou par pas pour qu que quel quelle quelles quels qui s sa sans se sera serai seraient serais serait seras serez seriez serions serons seront ses soi soient sois soit sommes son sont soyez soyons suis sur t ta te tes toi ton tu un une vos votre vous y à étaient étais était étant étiez étions été étée étées étés êtes".split(" ")),e.Pipeline.registerFunction(e.fr.stopWordFilter,"stopWordFilter-fr")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.he.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.he.min.js
deleted file mode 100644
index b863d3eae..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.he.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.he=function(){this.pipeline.reset(),this.pipeline.add(e.he.trimmer,e.he.stopWordFilter,e.he.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.he.stemmer))},e.he.wordCharacters="֑-״א-תa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.he.trimmer=e.trimmerSupport.generateTrimmer(e.he.wordCharacters),e.Pipeline.registerFunction(e.he.trimmer,"trimmer-he"),e.he.stemmer=function(){var e=this;return e.result=!1,e.preRemoved=!1,e.sufRemoved=!1,e.pre={pre1:"ה ו י ת",pre2:"ב כ ל מ ש כש",pre3:"הב הכ הל המ הש בש לכ",pre4:"וב וכ ול ומ וש",pre5:"מה שה כל",pre6:"מב מכ מל ממ מש",pre7:"בה בו בי בת כה כו כי כת לה לו לי לת",pre8:"ובה ובו ובי ובת וכה וכו וכי וכת ולה ולו ולי ולת"},e.suf={suf1:"ך כ ם ן נ",suf2:"ים ות וך וכ ום ון ונ הם הן יכ יך ינ ים",suf3:"תי תך תכ תם תן תנ",suf4:"ותי ותך ותכ ותם ותן ותנ",suf5:"נו כם כן הם הן",suf6:"ונו וכם וכן והם והן",suf7:"תכם תכן תנו תהם תהן",suf8:"הוא היא הם הן אני אתה את אנו אתם אתן",suf9:"ני נו כי כו כם כן תי תך תכ תם תן",suf10:"י ך כ ם ן נ ת"},e.patterns=JSON.parse('{"hebrewPatterns": [{"pt1": [{"c": "ה", "l": 0}]}, {"pt2": [{"c": "ו", "l": 0}]}, {"pt3": [{"c": "י", "l": 0}]}, {"pt4": [{"c": "ת", "l": 0}]}, {"pt5": [{"c": "מ", "l": 0}]}, {"pt6": [{"c": "ל", "l": 0}]}, {"pt7": [{"c": "ב", "l": 0}]}, {"pt8": [{"c": "כ", "l": 0}]}, {"pt9": [{"c": "ש", "l": 0}]}, {"pt10": [{"c": "כש", "l": 0}]}, {"pt11": [{"c": "בה", "l": 0}]}, {"pt12": [{"c": "וב", "l": 0}]}, {"pt13": [{"c": "וכ", "l": 0}]}, {"pt14": [{"c": "ול", "l": 0}]}, {"pt15": [{"c": "ומ", "l": 0}]}, {"pt16": [{"c": "וש", "l": 0}]}, {"pt17": [{"c": "הב", "l": 0}]}, {"pt18": [{"c": "הכ", "l": 0}]}, {"pt19": [{"c": "הל", "l": 0}]}, {"pt20": [{"c": "המ", "l": 0}]}, {"pt21": [{"c": "הש", "l": 0}]}, {"pt22": [{"c": "מה", "l": 0}]}, {"pt23": [{"c": "שה", "l": 0}]}, {"pt24": [{"c": "כל", "l": 0}]}]}'),e.execArray=["cleanWord","removeDiacritics","removeStopWords","normalizeHebrewCharacters"],e.stem=function(){var r=0;for(e.result=!1,e.preRemoved=!1,e.sufRemoved=!1;r<e.execArray.length&&1!=e.result;)e.result=e[e.execArray[r]](),r++},e.setCurrent=function(r){e.word=r},e.getCurrent=function(){return e.word},e.cleanWord=function(){return!!new RegExp("[^֑-״א-ת]").test("")},e.removeDiacritics=function(){var r=new RegExp("[ְ-ֿ]","g");return e.word=e.word.replace(r,""),!1},e.removeStopWords=function(){if("אבל או אולי אותו אותי אותך אותם אותן אותנו אז אחר אחרות אחרי אחריכן אחרים אחרת אי איזה איך אין איפה אל אלה אלו אם אנחנו אני אף אפשר את אתה אתכם אתכן אתם אתן באיזה באיזו בגלל בין בלבד בעבור בעזרת בכל בכן בלי במידה במקום שבו ברוב בשביל בשעה ש בתוך גם דרך הוא היא היה היי היכן היתה היתי הם הן הנה הסיבה שבגללה הרי ואילו ואת זאת זה זות יהיה יוכל יוכלו יותר מדי יכול יכולה יכולות יכולים יכל יכלה יכלו יש כאן כאשר כולם כולן כזה כי כיצד כך כל כלל כמו כן כפי כש לא לאו לאיזותך לאן לבין לה להיות להם להן לו לזה לזות לי לך לכם לכן למה למעלה למעלה מ למטה למטה מ למעט למקום שבו למרות לנו לעבר לעיכן לפיכך לפני מאד מאחורי מאיזו סיבה מאין מאיפה מבלי מבעד מדוע מה מהיכן מול מחוץ מי מידע מכאן מכל מכן מלבד מן מנין מסוגל מעט מעטים מעל מצד מקום בו מתחת מתי נגד נגר נו עד עז על עלי עליו עליה עליהם עליך עלינו עם עצמה עצמהם עצמהן עצמו עצמי עצמם עצמן עצמנו פה רק שוב של שלה שלהם שלהן שלו שלי שלך שלכה שלכם שלכן שלנו שם תהיה תחת".split(" ").indexOf(e.word)>=0)return!0},e.normalizeHebrewCharacters=function(){return e.word=e.word.replace("ך","כ"),e.word=e.word.replace("ם","מ"),e.word=e.word.replace("ן","נ"),e.word=e.word.replace("ף","פ"),e.word=e.word.replace("ץ","צ"),!1},function(r){return"function"==typeof r.update?r.update(function(r){return e.setCurrent(r),e.stem(),e.getCurrent()}):(e.setCurrent(r),e.stem(),e.getCurrent())}}(),e.Pipeline.registerFunction(e.he.stemmer,"stemmer-he"),e.he.stopWordFilter=e.generateStopWordFilter("אבל או אולי אותו אותי אותך אותם אותן אותנו אז אחר אחרות אחרי אחריכן אחרים אחרת אי איזה איך אין איפה אל אלה אלו אם אנחנו אני אף אפשר את אתה אתכם אתכן אתם אתן באיזה באיזו בגלל בין בלבד בעבור בעזרת בכל בכן בלי במידה במקום שבו ברוב בשביל בשעה ש בתוך גם דרך הוא היא היה היי היכן היתה היתי הם הן הנה הסיבה שבגללה הרי ואילו ואת זאת זה זות יהיה יוכל יוכלו יותר מדי יכול יכולה יכולות יכולים יכל יכלה יכלו יש כאן כאשר כולם כולן כזה כי כיצד כך כל כלל כמו כן כפי כש לא לאו לאיזותך לאן לבין לה להיות להם להן לו לזה לזות לי לך לכם לכן למה למעלה למעלה מ למטה למטה מ למעט למקום שבו למרות לנו לעבר לעיכן לפיכך לפני מאד מאחורי מאיזו סיבה מאין מאיפה מבלי מבעד מדוע מה מהיכן מול מחוץ מי מידע מכאן מכל מכן מלבד מן מנין מסוגל מעט מעטים מעל מצד מקום בו מתחת מתי נגד נגר נו עד עז על עלי עליו עליה עליהם עליך עלינו עם עצמה עצמהם עצמהן עצמו עצמי עצמם עצמן עצמנו פה רק שוב של שלה שלהם שלהן שלו שלי שלך שלכה שלכם שלכן שלנו שם תהיה תחת".split(" ")),e.Pipeline.registerFunction(e.he.stopWordFilter,"stopWordFilter-he")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.hi.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.hi.min.js
deleted file mode 100644
index 7dbc41402..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.hi.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hi=function(){this.pipeline.reset(),this.pipeline.add(e.hi.trimmer,e.hi.stopWordFilter,e.hi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hi.stemmer))},e.hi.wordCharacters="ऀ-ःऄ-एऐ-टठ-यर-िी-ॏॐ-य़ॠ-९॰-ॿa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.hi.trimmer=e.trimmerSupport.generateTrimmer(e.hi.wordCharacters),e.Pipeline.registerFunction(e.hi.trimmer,"trimmer-hi"),e.hi.stopWordFilter=e.generateStopWordFilter("अत अपना अपनी अपने अभी अंदर आदि आप इत्यादि इन इनका इन्हीं इन्हें इन्हों इस इसका इसकी इसके इसमें इसी इसे उन उनका उनकी उनके उनको उन्हीं उन्हें उन्हों उस उसके उसी उसे एक एवं एस ऐसे और कई कर करता करते करना करने करें कहते कहा का काफ़ी कि कितना किन्हें किन्हों किया किर किस किसी किसे की कुछ कुल के को कोई कौन कौनसा गया घर जब जहाँ जा जितना जिन जिन्हें जिन्हों जिस जिसे जीधर जैसा जैसे जो तक तब तरह तिन तिन्हें तिन्हों तिस तिसे तो था थी थे दबारा दिया दुसरा दूसरे दो द्वारा न नके नहीं ना निहायत नीचे ने पर पहले पूरा पे फिर बनी बही बहुत बाद बाला बिलकुल भी भीतर मगर मानो मे में यदि यह यहाँ यही या यिह ये रखें रहा रहे ऱ्वासा लिए लिये लेकिन व वग़ैरह वर्ग वह वहाँ वहीं वाले वुह वे वो सकता सकते सबसे सभी साथ साबुत साभ सारा से सो संग ही हुआ हुई हुए है हैं हो होता होती होते होना होने".split(" ")),e.hi.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.hi.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var t=i.toString().toLowerCase().replace(/^\s+/,"");return r.cut(t).split("|")},e.Pipeline.registerFunction(e.hi.stemmer,"stemmer-hi"),e.Pipeline.registerFunction(e.hi.stopWordFilter,"stopWordFilter-hi")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.hu.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.hu.min.js
deleted file mode 100644
index ed9d909f7..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.hu.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Hungarian` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hu=function(){this.pipeline.reset(),this.pipeline.add(e.hu.trimmer,e.hu.stopWordFilter,e.hu.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hu.stemmer))},e.hu.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.hu.trimmer=e.trimmerSupport.generateTrimmer(e.hu.wordCharacters),e.Pipeline.registerFunction(e.hu.trimmer,"trimmer-hu"),e.hu.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,n=L.cursor;if(d=L.limit,L.in_grouping(W,97,252))for(;;){if(e=L.cursor,L.out_grouping(W,97,252))return L.cursor=e,L.find_among(g,8)||(L.cursor=e,e<L.limit&&L.cursor++),void(d=L.cursor);if(L.cursor=e,e>=L.limit)return void(d=e);L.cursor++}if(L.cursor=n,L.out_grouping(W,97,252)){for(;!L.in_grouping(W,97,252);){if(L.cursor>=L.limit)return;L.cursor++}d=L.cursor}}function i(){return d<=L.cursor}function a(){var e;if(L.ket=L.cursor,(e=L.find_among_b(h,2))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e")}}function t(){var e=L.limit-L.cursor;return!!L.find_among_b(p,23)&&(L.cursor=L.limit-e,!0)}function s(){if(L.cursor>L.limit_backward){L.cursor--,L.ket=L.cursor;var e=L.cursor-1;L.limit_backward<=e&&e<=L.limit&&(L.cursor=e,L.bra=e,L.slice_del())}}function c(){var e;if(L.ket=L.cursor,(e=L.find_among_b(_,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function o(){L.ket=L.cursor,L.find_among_b(v,44)&&(L.bra=L.cursor,i()&&(L.slice_del(),a()))}function w(){var e;if(L.ket=L.cursor,(e=L.find_among_b(z,3))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("e");break;case 2:case 3:L.slice_from("a")}}function l(){var e;if(L.ket=L.cursor,(e=L.find_among_b(y,6))&&(L.bra=L.cursor,i()))switch(e){case 1:case 2:L.slice_del();break;case 3:L.slice_from("a");break;case 4:L.slice_from("e")}}function u(){var e;if(L.ket=L.cursor,(e=L.find_among_b(j,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function m(){var e;if(L.ket=L.cursor,(e=L.find_among_b(C,7))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e");break;case 3:case 4:case 5:case 6:case 7:L.slice_del()}}function k(){var e;if(L.ket=L.cursor,(e=L.find_among_b(P,12))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 9:L.slice_del();break;case 2:case 5:case 8:L.slice_from("e");break;case 3:case 6:L.slice_from("a")}}function f(){var e;if(L.ket=L.cursor,(e=L.find_among_b(F,31))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 8:case 9:case 12:case 13:case 16:case 17:case 18:L.slice_del();break;case 2:case 5:case 10:case 14:case 19:L.slice_from("a");break;case 3:case 6:case 11:case 15:case 20:L.slice_from("e")}}function b(){var e;if(L.ket=L.cursor,(e=L.find_among_b(S,42))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 5:case 6:case 9:case 10:case 11:case 14:case 15:case 16:case 17:case 20:case 21:case 24:case 25:case 26:case 29:L.slice_del();break;case 2:case 7:case 12:case 18:case 22:case 27:L.slice_from("a");break;case 3:case 8:case 13:case 19:case 23:case 28:L.slice_from("e")}}var d,g=[new n("cs",-1,-1),new n("dzs",-1,-1),new n("gy",-1,-1),new n("ly",-1,-1),new n("ny",-1,-1),new n("sz",-1,-1),new n("ty",-1,-1),new n("zs",-1,-1)],h=[new n("á",-1,1),new n("é",-1,2)],p=[new n("bb",-1,-1),new n("cc",-1,-1),new n("dd",-1,-1),new n("ff",-1,-1),new n("gg",-1,-1),new n("jj",-1,-1),new n("kk",-1,-1),new n("ll",-1,-1),new n("mm",-1,-1),new n("nn",-1,-1),new n("pp",-1,-1),new n("rr",-1,-1),new n("ccs",-1,-1),new n("ss",-1,-1),new n("zzs",-1,-1),new n("tt",-1,-1),new n("vv",-1,-1),new n("ggy",-1,-1),new n("lly",-1,-1),new n("nny",-1,-1),new n("tty",-1,-1),new n("ssz",-1,-1),new n("zz",-1,-1)],_=[new n("al",-1,1),new n("el",-1,2)],v=[new n("ba",-1,-1),new n("ra",-1,-1),new n("be",-1,-1),new n("re",-1,-1),new n("ig",-1,-1),new n("nak",-1,-1),new n("nek",-1,-1),new n("val",-1,-1),new n("vel",-1,-1),new n("ul",-1,-1),new n("nál",-1,-1),new n("nél",-1,-1),new n("ból",-1,-1),new n("ról",-1,-1),new n("tól",-1,-1),new n("bõl",-1,-1),new n("rõl",-1,-1),new n("tõl",-1,-1),new n("ül",-1,-1),new n("n",-1,-1),new n("an",19,-1),new n("ban",20,-1),new n("en",19,-1),new n("ben",22,-1),new n("képpen",22,-1),new n("on",19,-1),new n("ön",19,-1),new n("képp",-1,-1),new n("kor",-1,-1),new n("t",-1,-1),new n("at",29,-1),new n("et",29,-1),new n("ként",29,-1),new n("anként",32,-1),new n("enként",32,-1),new n("onként",32,-1),new n("ot",29,-1),new n("ért",29,-1),new n("öt",29,-1),new n("hez",-1,-1),new n("hoz",-1,-1),new n("höz",-1,-1),new n("vá",-1,-1),new n("vé",-1,-1)],z=[new n("án",-1,2),new n("én",-1,1),new n("ánként",-1,3)],y=[new n("stul",-1,2),new n("astul",0,1),new n("ástul",0,3),new n("stül",-1,2),new n("estül",3,1),new n("éstül",3,4)],j=[new n("á",-1,1),new n("é",-1,2)],C=[new n("k",-1,7),new n("ak",0,4),new n("ek",0,6),new n("ok",0,5),new n("ák",0,1),new n("ék",0,2),new n("ök",0,3)],P=[new n("éi",-1,7),new n("áéi",0,6),new n("ééi",0,5),new n("é",-1,9),new n("ké",3,4),new n("aké",4,1),new n("eké",4,1),new n("oké",4,1),new n("áké",4,3),new n("éké",4,2),new n("öké",4,1),new n("éé",3,8)],F=[new n("a",-1,18),new n("ja",0,17),new n("d",-1,16),new n("ad",2,13),new n("ed",2,13),new n("od",2,13),new n("ád",2,14),new n("éd",2,15),new n("öd",2,13),new n("e",-1,18),new n("je",9,17),new n("nk",-1,4),new n("unk",11,1),new n("ánk",11,2),new n("énk",11,3),new n("ünk",11,1),new n("uk",-1,8),new n("juk",16,7),new n("ájuk",17,5),new n("ük",-1,8),new n("jük",19,7),new n("éjük",20,6),new n("m",-1,12),new n("am",22,9),new n("em",22,9),new n("om",22,9),new n("ám",22,10),new n("ém",22,11),new n("o",-1,18),new n("á",-1,19),new n("é",-1,20)],S=[new n("id",-1,10),new n("aid",0,9),new n("jaid",1,6),new n("eid",0,9),new n("jeid",3,6),new n("áid",0,7),new n("éid",0,8),new n("i",-1,15),new n("ai",7,14),new n("jai",8,11),new n("ei",7,14),new n("jei",10,11),new n("ái",7,12),new n("éi",7,13),new n("itek",-1,24),new n("eitek",14,21),new n("jeitek",15,20),new n("éitek",14,23),new n("ik",-1,29),new n("aik",18,26),new n("jaik",19,25),new n("eik",18,26),new n("jeik",21,25),new n("áik",18,27),new n("éik",18,28),new n("ink",-1,20),new n("aink",25,17),new n("jaink",26,16),new n("eink",25,17),new n("jeink",28,16),new n("áink",25,18),new n("éink",25,19),new n("aitok",-1,21),new n("jaitok",32,20),new n("áitok",-1,22),new n("im",-1,5),new n("aim",35,4),new n("jaim",36,1),new n("eim",35,4),new n("jeim",38,1),new n("áim",35,2),new n("éim",35,3)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,52,14],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var n=L.cursor;return e(),L.limit_backward=n,L.cursor=L.limit,c(),L.cursor=L.limit,o(),L.cursor=L.limit,w(),L.cursor=L.limit,l(),L.cursor=L.limit,u(),L.cursor=L.limit,k(),L.cursor=L.limit,f(),L.cursor=L.limit,b(),L.cursor=L.limit,m(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.hu.stemmer,"stemmer-hu"),e.hu.stopWordFilter=e.generateStopWordFilter("a abban ahhoz ahogy ahol aki akik akkor alatt amely amelyek amelyekben amelyeket amelyet amelynek ami amikor amit amolyan amíg annak arra arról az azok azon azonban azt aztán azután azzal azért be belül benne bár cikk cikkek cikkeket csak de e ebben eddig egy egyes egyetlen egyik egyre egyéb egész ehhez ekkor el ellen elsõ elég elõ elõször elõtt emilyen ennek erre ez ezek ezen ezt ezzel ezért fel felé hanem hiszen hogy hogyan igen ill ill. illetve ilyen ilyenkor ismét ison itt jobban jó jól kell kellett keressünk keresztül ki kívül között közül legalább legyen lehet lehetett lenne lenni lesz lett maga magát majd majd meg mellett mely melyek mert mi mikor milyen minden mindenki mindent mindig mint mintha mit mivel miért most már más másik még míg nagy nagyobb nagyon ne nekem neki nem nincs néha néhány nélkül olyan ott pedig persze rá s saját sem semmi sok sokat sokkal szemben szerint szinte számára talán tehát teljes tovább továbbá több ugyanis utolsó után utána vagy vagyis vagyok valaki valami valamint való van vannak vele vissza viszont volna volt voltak voltam voltunk által általában át én éppen és így õ õk õket össze úgy új újabb újra".split(" ")),e.Pipeline.registerFunction(e.hu.stopWordFilter,"stopWordFilter-hu")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.hy.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.hy.min.js
deleted file mode 100644
index b37f79298..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.hy.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hy=function(){this.pipeline.reset(),this.pipeline.add(e.hy.trimmer,e.hy.stopWordFilter)},e.hy.wordCharacters="[A-Za-z԰-֏ff-ﭏ]",e.hy.trimmer=e.trimmerSupport.generateTrimmer(e.hy.wordCharacters),e.Pipeline.registerFunction(e.hy.trimmer,"trimmer-hy"),e.hy.stopWordFilter=e.generateStopWordFilter("դու և եք էիր էիք հետո նաև նրանք որը վրա է որ պիտի են այս մեջ ն իր ու ի այդ որոնք այն կամ էր մի ես համար այլ իսկ էին ենք հետ ին թ էինք մենք նրա նա դուք եմ էի ըստ որպես ում".split(" ")),e.Pipeline.registerFunction(e.hy.stopWordFilter,"stopWordFilter-hy"),e.hy.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}(),e.Pipeline.registerFunction(e.hy.stemmer,"stemmer-hy")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.it.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.it.min.js
deleted file mode 100644
index 344b6a3c0..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.it.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Italian` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.it=function(){this.pipeline.reset(),this.pipeline.add(e.it.trimmer,e.it.stopWordFilter,e.it.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.it.stemmer))},e.it.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.it.trimmer=e.trimmerSupport.generateTrimmer(e.it.wordCharacters),e.Pipeline.registerFunction(e.it.trimmer,"trimmer-it"),e.it.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!x.eq_s(1,e)||(x.ket=x.cursor,!x.in_grouping(L,97,249)))&&(x.slice_from(r),x.cursor=n,!0)}function i(){for(var r,n,i,o,t=x.cursor;;){if(x.bra=x.cursor,r=x.find_among(h,7))switch(x.ket=x.cursor,r){case 1:x.slice_from("à");continue;case 2:x.slice_from("è");continue;case 3:x.slice_from("ì");continue;case 4:x.slice_from("ò");continue;case 5:x.slice_from("ù");continue;case 6:x.slice_from("qU");continue;case 7:if(x.cursor>=x.limit)break;x.cursor++;continue}break}for(x.cursor=t;;)for(n=x.cursor;;){if(i=x.cursor,x.in_grouping(L,97,249)){if(x.bra=x.cursor,o=x.cursor,e("u","U",i))break;if(x.cursor=o,e("i","I",i))break}if(x.cursor=i,x.cursor>=x.limit)return void(x.cursor=n);x.cursor++}}function o(e){if(x.cursor=e,!x.in_grouping(L,97,249))return!1;for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function t(){if(x.in_grouping(L,97,249)){var e=x.cursor;if(x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return o(e);x.cursor++}return!0}return o(e)}return!1}function s(){var e,r=x.cursor;if(!t()){if(x.cursor=r,!x.out_grouping(L,97,249))return;if(e=x.cursor,x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return x.cursor=e,void(x.in_grouping(L,97,249)&&x.cursor<x.limit&&x.cursor++);x.cursor++}return void(k=x.cursor)}if(x.cursor=e,!x.in_grouping(L,97,249)||x.cursor>=x.limit)return;x.cursor++}k=x.cursor}function a(){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function u(){var e=x.cursor;k=x.limit,p=k,g=k,s(),x.cursor=e,a()&&(p=x.cursor,a()&&(g=x.cursor))}function c(){for(var e;;){if(x.bra=x.cursor,!(e=x.find_among(q,3)))break;switch(x.ket=x.cursor,e){case 1:x.slice_from("i");break;case 2:x.slice_from("u");break;case 3:if(x.cursor>=x.limit)return;x.cursor++}}}function w(){return k<=x.cursor}function l(){return p<=x.cursor}function m(){return g<=x.cursor}function f(){var e;if(x.ket=x.cursor,x.find_among_b(C,37)&&(x.bra=x.cursor,(e=x.find_among_b(z,5))&&w()))switch(e){case 1:x.slice_del();break;case 2:x.slice_from("e")}}function v(){var e;if(x.ket=x.cursor,!(e=x.find_among_b(S,51)))return!1;switch(x.bra=x.cursor,e){case 1:if(!m())return!1;x.slice_del();break;case 2:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del());break;case 3:if(!m())return!1;x.slice_from("log");break;case 4:if(!m())return!1;x.slice_from("u");break;case 5:if(!m())return!1;x.slice_from("ente");break;case 6:if(!w())return!1;x.slice_del();break;case 7:if(!l())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(P,4),e&&(x.bra=x.cursor,m()&&(x.slice_del(),1==e&&(x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&x.slice_del()))));break;case 8:if(!m())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(F,3),e&&(x.bra=x.cursor,1==e&&m()&&x.slice_del());break;case 9:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del())))}return!0}function b(){var e,r;x.cursor>=k&&(r=x.limit_backward,x.limit_backward=k,x.ket=x.cursor,e=x.find_among_b(W,87),e&&(x.bra=x.cursor,1==e&&x.slice_del()),x.limit_backward=r)}function d(){var e=x.limit-x.cursor;if(x.ket=x.cursor,x.in_grouping_b(y,97,242)&&(x.bra=x.cursor,w()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(1,"i")&&(x.bra=x.cursor,w()))))return void x.slice_del();x.cursor=x.limit-e}function _(){d(),x.ket=x.cursor,x.eq_s_b(1,"h")&&(x.bra=x.cursor,x.in_grouping_b(U,99,103)&&w()&&x.slice_del())}var g,p,k,h=[new r("",-1,7),new r("qu",0,6),new r("á",0,1),new r("é",0,2),new r("í",0,3),new r("ó",0,4),new r("ú",0,5)],q=[new r("",-1,3),new r("I",0,1),new r("U",0,2)],C=[new r("la",-1,-1),new r("cela",0,-1),new r("gliela",0,-1),new r("mela",0,-1),new r("tela",0,-1),new r("vela",0,-1),new r("le",-1,-1),new r("cele",6,-1),new r("gliele",6,-1),new r("mele",6,-1),new r("tele",6,-1),new r("vele",6,-1),new r("ne",-1,-1),new r("cene",12,-1),new r("gliene",12,-1),new r("mene",12,-1),new r("sene",12,-1),new r("tene",12,-1),new r("vene",12,-1),new r("ci",-1,-1),new r("li",-1,-1),new r("celi",20,-1),new r("glieli",20,-1),new r("meli",20,-1),new r("teli",20,-1),new r("veli",20,-1),new r("gli",20,-1),new r("mi",-1,-1),new r("si",-1,-1),new r("ti",-1,-1),new r("vi",-1,-1),new r("lo",-1,-1),new r("celo",31,-1),new r("glielo",31,-1),new r("melo",31,-1),new r("telo",31,-1),new r("velo",31,-1)],z=[new r("ando",-1,1),new r("endo",-1,1),new r("ar",-1,2),new r("er",-1,2),new r("ir",-1,2)],P=[new r("ic",-1,-1),new r("abil",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],F=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],S=[new r("ica",-1,1),new r("logia",-1,3),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,9),new r("anza",-1,1),new r("enza",-1,5),new r("ice",-1,1),new r("atrice",7,1),new r("iche",-1,1),new r("logie",-1,3),new r("abile",-1,1),new r("ibile",-1,1),new r("usione",-1,4),new r("azione",-1,2),new r("uzione",-1,4),new r("atore",-1,2),new r("ose",-1,1),new r("ante",-1,1),new r("mente",-1,1),new r("amente",19,7),new r("iste",-1,1),new r("ive",-1,9),new r("anze",-1,1),new r("enze",-1,5),new r("ici",-1,1),new r("atrici",25,1),new r("ichi",-1,1),new r("abili",-1,1),new r("ibili",-1,1),new r("ismi",-1,1),new r("usioni",-1,4),new r("azioni",-1,2),new r("uzioni",-1,4),new r("atori",-1,2),new r("osi",-1,1),new r("anti",-1,1),new r("amenti",-1,6),new r("imenti",-1,6),new r("isti",-1,1),new r("ivi",-1,9),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,6),new r("imento",-1,6),new r("ivo",-1,9),new r("ità",-1,8),new r("istà",-1,1),new r("istè",-1,1),new r("istì",-1,1)],W=[new r("isca",-1,1),new r("enda",-1,1),new r("ata",-1,1),new r("ita",-1,1),new r("uta",-1,1),new r("ava",-1,1),new r("eva",-1,1),new r("iva",-1,1),new r("erebbe",-1,1),new r("irebbe",-1,1),new r("isce",-1,1),new r("ende",-1,1),new r("are",-1,1),new r("ere",-1,1),new r("ire",-1,1),new r("asse",-1,1),new r("ate",-1,1),new r("avate",16,1),new r("evate",16,1),new r("ivate",16,1),new r("ete",-1,1),new r("erete",20,1),new r("irete",20,1),new r("ite",-1,1),new r("ereste",-1,1),new r("ireste",-1,1),new r("ute",-1,1),new r("erai",-1,1),new r("irai",-1,1),new r("isci",-1,1),new r("endi",-1,1),new r("erei",-1,1),new r("irei",-1,1),new r("assi",-1,1),new r("ati",-1,1),new r("iti",-1,1),new r("eresti",-1,1),new r("iresti",-1,1),new r("uti",-1,1),new r("avi",-1,1),new r("evi",-1,1),new r("ivi",-1,1),new r("isco",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("Yamo",-1,1),new r("iamo",-1,1),new r("avamo",-1,1),new r("evamo",-1,1),new r("ivamo",-1,1),new r("eremo",-1,1),new r("iremo",-1,1),new r("assimo",-1,1),new r("ammo",-1,1),new r("emmo",-1,1),new r("eremmo",54,1),new r("iremmo",54,1),new r("immo",-1,1),new r("ano",-1,1),new r("iscano",58,1),new r("avano",58,1),new r("evano",58,1),new r("ivano",58,1),new r("eranno",-1,1),new r("iranno",-1,1),new r("ono",-1,1),new r("iscono",65,1),new r("arono",65,1),new r("erono",65,1),new r("irono",65,1),new r("erebbero",-1,1),new r("irebbero",-1,1),new r("assero",-1,1),new r("essero",-1,1),new r("issero",-1,1),new r("ato",-1,1),new r("ito",-1,1),new r("uto",-1,1),new r("avo",-1,1),new r("evo",-1,1),new r("ivo",-1,1),new r("ar",-1,1),new r("ir",-1,1),new r("erà",-1,1),new r("irà",-1,1),new r("erò",-1,1),new r("irò",-1,1)],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2,1],y=[17,65,0,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2],U=[17],x=new n;this.setCurrent=function(e){x.setCurrent(e)},this.getCurrent=function(){return x.getCurrent()},this.stem=function(){var e=x.cursor;return i(),x.cursor=e,u(),x.limit_backward=e,x.cursor=x.limit,f(),x.cursor=x.limit,v()||(x.cursor=x.limit,b()),x.cursor=x.limit,_(),x.cursor=x.limit_backward,c(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.it.stemmer,"stemmer-it"),e.it.stopWordFilter=e.generateStopWordFilter("a abbia abbiamo abbiano abbiate ad agl agli ai al all alla alle allo anche avemmo avendo avesse avessero avessi avessimo aveste avesti avete aveva avevamo avevano avevate avevi avevo avrai avranno avrebbe avrebbero avrei avremmo avremo avreste avresti avrete avrà avrò avuta avute avuti avuto c che chi ci coi col come con contro cui da dagl dagli dai dal dall dalla dalle dallo degl degli dei del dell della delle dello di dov dove e ebbe ebbero ebbi ed era erano eravamo eravate eri ero essendo faccia facciamo facciano facciate faccio facemmo facendo facesse facessero facessi facessimo faceste facesti faceva facevamo facevano facevate facevi facevo fai fanno farai faranno farebbe farebbero farei faremmo faremo fareste faresti farete farà farò fece fecero feci fosse fossero fossi fossimo foste fosti fu fui fummo furono gli ha hai hanno ho i il in io l la le lei li lo loro lui ma mi mia mie miei mio ne negl negli nei nel nell nella nelle nello noi non nostra nostre nostri nostro o per perché più quale quanta quante quanti quanto quella quelle quelli quello questa queste questi questo sarai saranno sarebbe sarebbero sarei saremmo saremo sareste saresti sarete sarà sarò se sei si sia siamo siano siate siete sono sta stai stando stanno starai staranno starebbe starebbero starei staremmo staremo stareste staresti starete starà starò stava stavamo stavano stavate stavi stavo stemmo stesse stessero stessi stessimo steste stesti stette stettero stetti stia stiamo stiano stiate sto su sua sue sugl sugli sui sul sull sulla sulle sullo suo suoi ti tra tu tua tue tuo tuoi tutti tutto un una uno vi voi vostra vostre vostri vostro è".split(" ")),e.Pipeline.registerFunction(e.it.stopWordFilter,"stopWordFilter-it")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.ja.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.ja.min.js
deleted file mode 100644
index 5f254ebe9..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.ja.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.ja=function(){this.pipeline.reset(),this.pipeline.add(e.ja.trimmer,e.ja.stopWordFilter,e.ja.stemmer),r?this.tokenizer=e.ja.tokenizer:(e.tokenizer&&(e.tokenizer=e.ja.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.ja.tokenizer))};var t=new e.TinySegmenter;e.ja.tokenizer=function(i){var n,o,s,p,a,u,m,l,c,f;if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t.toLowerCase()):t.toLowerCase()});for(o=i.toString().toLowerCase().replace(/^\s+/,""),n=o.length-1;n>=0;n--)if(/\S/.test(o.charAt(n))){o=o.substring(0,n+1);break}for(a=[],s=o.length,c=0,l=0;c<=s;c++)if(u=o.charAt(c),m=c-l,u.match(/\s/)||c==s){if(m>0)for(p=t.segment(o.slice(l,c)).filter(function(e){return!!e}),f=l,n=0;n<p.length;n++)r?a.push(new e.Token(p[n],{position:[f,p[n].length],index:a.length})):a.push(p[n]),f+=p[n].length;l=c+1}return a},e.ja.stemmer=function(){return function(e){return e}}(),e.Pipeline.registerFunction(e.ja.stemmer,"stemmer-ja"),e.ja.wordCharacters="一二三四五六七八九十百千万億兆一-龠々〆ヵヶぁ-んァ-ヴーｱ-ﾝﾞa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.ja.trimmer=e.trimmerSupport.generateTrimmer(e.ja.wordCharacters),e.Pipeline.registerFunction(e.ja.trimmer,"trimmer-ja"),e.ja.stopWordFilter=e.generateStopWordFilter("これ それ あれ この その あの ここ そこ あそこ こちら どこ だれ なに なん 何 私 貴方 貴方方 我々 私達 あの人 あのかた 彼女 彼 です あります おります います は が の に を で え から まで より も どの と し それで しかし".split(" ")),e.Pipeline.registerFunction(e.ja.stopWordFilter,"stopWordFilter-ja"),e.jp=e.ja,e.Pipeline.registerFunction(e.jp.stemmer,"stemmer-jp"),e.Pipeline.registerFunction(e.jp.trimmer,"trimmer-jp"),e.Pipeline.registerFunction(e.jp.stopWordFilter,"stopWordFilter-jp")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.jp.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.jp.min.js
deleted file mode 100644
index c055ebaf3..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.jp.min.js
+++ /dev/null
@@ -1 +0,0 @@
-module.exports=require("./lunr.ja");
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.kn.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.kn.min.js
deleted file mode 100644
index 1cef9befd..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.kn.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.kn=function(){this.pipeline.reset(),this.pipeline.add(e.kn.trimmer,e.kn.stopWordFilter,e.kn.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.kn.stemmer))},e.kn.wordCharacters="ಀ-಄ಅ-ಔಕ-ಹಾ-ೌ಼-ಽೕ-ೖೝ-ೞೠ-ೡೢ-ೣ೤೥೦-೯ೱ-ೳ",e.kn.trimmer=e.trimmerSupport.generateTrimmer(e.kn.wordCharacters),e.Pipeline.registerFunction(e.kn.trimmer,"trimmer-kn"),e.kn.stopWordFilter=e.generateStopWordFilter("ಮತ್ತು ಈ ಒಂದು ರಲ್ಲಿ ಹಾಗೂ ಎಂದು ಅಥವಾ ಇದು ರ ಅವರು ಎಂಬ ಮೇಲೆ ಅವರ ತನ್ನ ಆದರೆ ತಮ್ಮ ನಂತರ ಮೂಲಕ ಹೆಚ್ಚು ನ ಆ ಕೆಲವು ಅನೇಕ ಎರಡು ಹಾಗು ಪ್ರಮುಖ ಇದನ್ನು ಇದರ ಸುಮಾರು ಅದರ ಅದು ಮೊದಲ ಬಗ್ಗೆ ನಲ್ಲಿ ರಂದು ಇತರ ಅತ್ಯಂತ ಹೆಚ್ಚಿನ ಸಹ ಸಾಮಾನ್ಯವಾಗಿ ನೇ ಹಲವಾರು ಹೊಸ ದಿ ಕಡಿಮೆ ಯಾವುದೇ ಹೊಂದಿದೆ ದೊಡ್ಡ ಅನ್ನು ಇವರು ಪ್ರಕಾರ ಇದೆ ಮಾತ್ರ ಕೂಡ ಇಲ್ಲಿ ಎಲ್ಲಾ ವಿವಿಧ ಅದನ್ನು ಹಲವು ರಿಂದ ಕೇವಲ ದ ದಕ್ಷಿಣ ಗೆ ಅವನ ಅತಿ ನೆಯ ಬಹಳ ಕೆಲಸ ಎಲ್ಲ ಪ್ರತಿ ಇತ್ಯಾದಿ ಇವು ಬೇರೆ ಹೀಗೆ ನಡುವೆ ಇದಕ್ಕೆ ಎಸ್ ಇವರ ಮೊದಲು ಶ್ರೀ ಮಾಡುವ ಇದರಲ್ಲಿ ರೀತಿಯ ಮಾಡಿದ ಕಾಲ ಅಲ್ಲಿ ಮಾಡಲು ಅದೇ ಈಗ ಅವು ಗಳು ಎ ಎಂಬುದು ಅವನು ಅಂದರೆ ಅವರಿಗೆ ಇರುವ ವಿಶೇಷ ಮುಂದೆ ಅವುಗಳ ಮುಂತಾದ ಮೂಲ ಬಿ ಮೀ ಒಂದೇ ಇನ್ನೂ ಹೆಚ್ಚಾಗಿ ಮಾಡಿ ಅವರನ್ನು ಇದೇ ಯ ರೀತಿಯಲ್ಲಿ ಜೊತೆ ಅದರಲ್ಲಿ ಮಾಡಿದರು ನಡೆದ ಆಗ ಮತ್ತೆ ಪೂರ್ವ ಆತ ಬಂದ ಯಾವ ಒಟ್ಟು ಇತರೆ ಹಿಂದೆ ಪ್ರಮಾಣದ ಗಳನ್ನು ಕುರಿತು ಯು ಆದ್ದರಿಂದ ಅಲ್ಲದೆ ನಗರದ ಮೇಲಿನ ಏಕೆಂದರೆ ರಷ್ಟು ಎಂಬುದನ್ನು ಬಾರಿ ಎಂದರೆ ಹಿಂದಿನ ಆದರೂ ಆದ ಸಂಬಂಧಿಸಿದ ಮತ್ತೊಂದು ಸಿ ಆತನ ".split(" ")),e.kn.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.kn.tokenizer=function(t){if(!arguments.length||null==t||void 0==t)return[];if(Array.isArray(t))return t.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var n=t.toString().toLowerCase().replace(/^\s+/,"");return r.cut(n).split("|")},e.Pipeline.registerFunction(e.kn.stemmer,"stemmer-kn"),e.Pipeline.registerFunction(e.kn.stopWordFilter,"stopWordFilter-kn")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.ko.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.ko.min.js
deleted file mode 100644
index eaf9dabf7..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.ko.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ko=function(){this.pipeline.reset(),this.pipeline.add(e.ko.trimmer,e.ko.stopWordFilter)},e.ko.wordCharacters="[A-Za-z가-힣]",e.ko.trimmer=e.trimmerSupport.generateTrimmer(e.ko.wordCharacters),e.Pipeline.registerFunction(e.ko.trimmer,"trimmer-ko"),e.ko.stopWordFilter=e.generateStopWordFilter("아 휴 아이구 아이쿠 아이고 어 나 우리 저희 따라 의해 을 를 에 의 가 으로 로 에게 뿐이다 의거하여 근거하여 입각하여 기준으로 예하면 예를 들면 예를 들자면 저 소인 소생 저희 지말고 하지마 하지마라 다른 물론 또한 그리고 비길수 없다 해서는 안된다 뿐만 아니라 만이 아니다 만은 아니다 막론하고 관계없이 그치지 않다 그러나 그런데 하지만 든간에 논하지 않다 따지지 않다 설사 비록 더라도 아니면 만 못하다 하는 편이 낫다 불문하고 향하여 향해서 향하다 쪽으로 틈타 이용하여 타다 오르다 제외하고 이 외에 이 밖에 하여야 비로소 한다면 몰라도 외에도 이곳 여기 부터 기점으로 따라서 할 생각이다 하려고하다 이리하여 그리하여 그렇게 함으로써 하지만 일때 할때 앞에서 중에서 보는데서 으로써 로써 까지 해야한다 일것이다 반드시 할줄알다 할수있다 할수있어 임에 틀림없다 한다면 등 등등 제 겨우 단지 다만 할뿐 딩동 댕그 대해서 대하여 대하면 훨씬 얼마나 얼마만큼 얼마큼 남짓 여 얼마간 약간 다소 좀 조금 다수 몇 얼마 지만 하물며 또한 그러나 그렇지만 하지만 이외에도 대해 말하자면 뿐이다 다음에 반대로 반대로 말하자면 이와 반대로 바꾸어서 말하면 바꾸어서 한다면 만약 그렇지않으면 까악 툭 딱 삐걱거리다 보드득 비걱거리다 꽈당 응당 해야한다 에 가서 각 각각 여러분 각종 각자 제각기 하도록하다 와 과 그러므로 그래서 고로 한 까닭에 하기 때문에 거니와 이지만 대하여 관하여 관한 과연 실로 아니나다를가 생각한대로 진짜로 한적이있다 하곤하였다 하 하하 허허 아하 거바 와 오 왜 어째서 무엇때문에 어찌 하겠는가 무슨 어디 어느곳 더군다나 하물며 더욱이는 어느때 언제 야 이봐 어이 여보시오 흐흐 흥 휴 헉헉 헐떡헐떡 영차 여차 어기여차 끙끙 아야 앗 아야 콸콸 졸졸 좍좍 뚝뚝 주룩주룩 솨 우르르 그래도 또 그리고 바꾸어말하면 바꾸어말하자면 혹은 혹시 답다 및 그에 따르는 때가 되어 즉 지든지 설령 가령 하더라도 할지라도 일지라도 지든지 몇 거의 하마터면 인젠 이젠 된바에야 된이상 만큼\t어찌됏든 그위에 게다가 점에서 보아 비추어 보아 고려하면 하게될것이다 일것이다 비교적 좀 보다더 비하면 시키다 하게하다 할만하다 의해서 연이서 이어서 잇따라 뒤따라 뒤이어 결국 의지하여 기대여 통하여 자마자 더욱더 불구하고 얼마든지 마음대로 주저하지 않고 곧 즉시 바로 당장 하자마자 밖에 안된다 하면된다 그래 그렇지 요컨대 다시 말하자면 바꿔 말하면 즉 구체적으로 말하자면 시작하여 시초에 이상 허 헉 허걱 바와같이 해도좋다 해도된다 게다가 더구나 하물며 와르르 팍 퍽 펄렁 동안 이래 하고있었다 이었다 에서 로부터 까지 예하면 했어요 해요 함께 같이 더불어 마저 마저도 양자 모두 습니다 가까스로 하려고하다 즈음하여 다른 다른 방면으로 해봐요 습니까 했어요 말할것도 없고 무릎쓰고 개의치않고 하는것만 못하다 하는것이 낫다 매 매번 들 모 어느것 어느 로써 갖고말하자면 어디 어느쪽 어느것 어느해 어느 년도 라 해도 언젠가 어떤것 어느것 저기 저쪽 저것 그때 그럼 그러면 요만한걸 그래 그때 저것만큼 그저 이르기까지 할 줄 안다 할 힘이 있다 너 너희 당신 어찌 설마 차라리 할지언정 할지라도 할망정 할지언정 구토하다 게우다 토하다 메쓰겁다 옆사람 퉤 쳇 의거하여 근거하여 의해 따라 힘입어 그 다음 버금 두번째로 기타 첫번째로 나머지는 그중에서 견지에서 형식으로 쓰여 입장에서 위해서 단지 의해되다 하도록시키다 뿐만아니라 반대로 전후 전자 앞의것 잠시 잠깐 하면서 그렇지만 다음에 그러한즉 그런즉 남들 아무거나 어찌하든지 같다 비슷하다 예컨대 이럴정도로 어떻게 만약 만일 위에서 서술한바와같이 인 듯하다 하지 않는다면 만약에 무엇 무슨 어느 어떤 아래윗 조차 한데 그럼에도 불구하고 여전히 심지어 까지도 조차도 하지 않도록 않기 위하여 때 시각 무렵 시간 동안 어때 어떠한 하여금 네 예 우선 누구 누가 알겠는가 아무도 줄은모른다 줄은 몰랏다 하는 김에 겸사겸사 하는바 그런 까닭에 한 이유는 그러니 그러니까 때문에 그 너희 그들 너희들 타인 것 것들 너 위하여 공동으로 동시에 하기 위하여 어찌하여 무엇때문에 붕붕 윙윙 나 우리 엉엉 휘익 윙윙 오호 아하 어쨋든 만 못하다\t하기보다는 차라리 하는 편이 낫다 흐흐 놀라다 상대적으로 말하자면 마치 아니라면 쉿 그렇지 않으면 그렇지 않다면 안 그러면 아니었다면 하든지 아니면 이라면 좋아 알았어 하는것도 그만이다 어쩔수 없다 하나 일 일반적으로 일단 한켠으로는 오자마자 이렇게되면 이와같다면 전부 한마디 한항목 근거로 하기에 아울러 하지 않도록 않기 위해서 이르기까지 이 되다 로 인하여 까닭으로 이유만으로 이로 인하여 그래서 이 때문에 그러므로 그런 까닭에 알 수 있다 결론을 낼 수 있다 으로 인하여 있다 어떤것 관계가 있다 관련이 있다 연관되다 어떤것들 에 대해 이리하여 그리하여 여부 하기보다는 하느니 하면 할수록 운운 이러이러하다 하구나 하도다 다시말하면 다음으로 에 있다 에 달려 있다 우리 우리들 오히려 하기는한데 어떻게 어떻해 어찌됏어 어때 어째서 본대로 자 이 이쪽 여기 이것 이번 이렇게말하자면 이런 이러한 이와 같은 요만큼 요만한 것 얼마 안 되는 것 이만큼 이 정도의 이렇게 많은 것 이와 같다 이때 이렇구나 것과 같이 끼익 삐걱 따위 와 같은 사람들 부류의 사람들 왜냐하면 중의하나 오직 오로지 에 한하다 하기만 하면 도착하다 까지 미치다 도달하다 정도에 이르다 할 지경이다 결과에 이르다 관해서는 여러분 하고 있다 한 후 혼자 자기 자기집 자신 우에 종합한것과같이 총적으로 보면 총적으로 말하면 총적으로 대로 하다 으로서 참 그만이다 할 따름이다 쿵 탕탕 쾅쾅 둥둥 봐 봐라 아이야 아니 와아 응 아이 참나 년 월 일 령 영 일 이 삼 사 오 육 륙 칠 팔 구 이천육 이천칠 이천팔 이천구 하나 둘 셋 넷 다섯 여섯 일곱 여덟 아홉 령 영".split(" ")),e.Pipeline.registerFunction(e.ko.stopWordFilter,"stopWordFilter-ko"),e.ko.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}(),e.Pipeline.registerFunction(e.ko.stemmer,"stemmer-ko")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.multi.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.multi.min.js
deleted file mode 100644
index 7debad096..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.multi.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){e.multiLanguage=function(){for(var t=Array.prototype.slice.call(arguments),i=t.join("-"),r="",n=[],s=[],p=0;p<t.length;++p)"en"==t[p]?(r+="\\w",n.unshift(e.stopWordFilter),n.push(e.stemmer),s.push(e.stemmer)):(r+=e[t[p]].wordCharacters,e[t[p]].stopWordFilter&&n.unshift(e[t[p]].stopWordFilter),e[t[p]].stemmer&&(n.push(e[t[p]].stemmer),s.push(e[t[p]].stemmer)));var o=e.trimmerSupport.generateTrimmer(r);return e.Pipeline.registerFunction(o,"lunr-multi-trimmer-"+i),n.unshift(o),function(){this.pipeline.reset(),this.pipeline.add.apply(this.pipeline,n),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add.apply(this.searchPipeline,s))}}}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.nl.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.nl.min.js
deleted file mode 100644
index c4a253594..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.nl.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Dutch` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(r,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():e()(r.lunr)}(this,function(){return function(r){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");r.nl=function(){this.pipeline.reset(),this.pipeline.add(r.nl.trimmer,r.nl.stopWordFilter,r.nl.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(r.nl.stemmer))},r.nl.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",r.nl.trimmer=r.trimmerSupport.generateTrimmer(r.nl.wordCharacters),r.Pipeline.registerFunction(r.nl.trimmer,"trimmer-nl"),r.nl.stemmer=function(){var e=r.stemmerSupport.Among,i=r.stemmerSupport.SnowballProgram,n=new function(){function r(){for(var r,e,i,o=C.cursor;;){if(C.bra=C.cursor,r=C.find_among(b,11))switch(C.ket=C.cursor,r){case 1:C.slice_from("a");continue;case 2:C.slice_from("e");continue;case 3:C.slice_from("i");continue;case 4:C.slice_from("o");continue;case 5:C.slice_from("u");continue;case 6:if(C.cursor>=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(e=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=e);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=e;else if(n(e))break}else if(n(e))break}function n(r){return C.cursor=r,r>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,d=_,t()||(_=C.cursor,_<3&&(_=3),t()||(d=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var r;;)if(C.bra=C.cursor,r=C.find_among(p,3))switch(C.ket=C.cursor,r){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return d<=C.cursor}function a(){var r=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-r,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var r;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.slice_del(),w=!0,a())))}function m(){var r;u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.eq_s_b(3,"gem")||(C.cursor=C.limit-r,C.slice_del(),a())))}function f(){var r,e,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,r=C.find_among_b(h,5))switch(C.bra=C.cursor,r){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(j,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(e=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-e,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,r=C.find_among_b(k,6))switch(C.bra=C.cursor,r){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(z,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var d,_,w,b=[new e("",-1,6),new e("á",0,1),new e("ä",0,1),new e("é",0,2),new e("ë",0,2),new e("í",0,3),new e("ï",0,3),new e("ó",0,4),new e("ö",0,4),new e("ú",0,5),new e("ü",0,5)],p=[new e("",-1,3),new e("I",0,2),new e("Y",0,1)],g=[new e("dd",-1,-1),new e("kk",-1,-1),new e("tt",-1,-1)],h=[new e("ene",-1,2),new e("se",-1,3),new e("en",-1,2),new e("heden",2,1),new e("s",-1,3)],k=[new e("end",-1,1),new e("ig",-1,2),new e("ing",-1,1),new e("lijk",-1,3),new e("baar",-1,4),new e("bar",-1,5)],v=[new e("aa",-1,-1),new e("ee",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(r){C.setCurrent(r)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var e=C.cursor;return r(),C.cursor=e,o(),C.limit_backward=e,C.cursor=C.limit,f(),C.cursor=C.limit_backward,s(),!0}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.nl.stemmer,"stemmer-nl"),r.nl.stopWordFilter=r.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),r.Pipeline.registerFunction(r.nl.stopWordFilter,"stopWordFilter-nl")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.no.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.no.min.js
deleted file mode 100644
index 92bc7e4e8..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.no.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Norwegian` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.no=function(){this.pipeline.reset(),this.pipeline.add(e.no.trimmer,e.no.stopWordFilter,e.no.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.no.stemmer))},e.no.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.no.trimmer=e.trimmerSupport.generateTrimmer(e.no.wordCharacters),e.Pipeline.registerFunction(e.no.trimmer,"trimmer-no"),e.no.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,r=w.cursor+3;if(a=w.limit,0<=r||r<=w.limit){for(s=r;;){if(e=w.cursor,w.in_grouping(d,97,248)){w.cursor=e;break}if(e>=w.limit)return;w.cursor=e+1}for(;!w.out_grouping(d,97,248);){if(w.cursor>=w.limit)return;w.cursor++}a=w.cursor,a<s&&(a=s)}}function i(){var e,r,n;if(w.cursor>=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(m,29),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:n=w.limit-w.cursor,w.in_grouping_b(c,98,122)?w.slice_del():(w.cursor=w.limit-n,w.eq_s_b(1,"k")&&w.out_grouping_b(d,97,248)&&w.slice_del());break;case 3:w.slice_from("er")}}function t(){var e,r=w.limit-w.cursor;w.cursor>=a&&(e=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,w.find_among_b(u,2)?(w.bra=w.cursor,w.limit_backward=e,w.cursor=w.limit-r,w.cursor>w.limit_backward&&(w.cursor--,w.bra=w.cursor,w.slice_del())):w.limit_backward=e)}function o(){var e,r;w.cursor>=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(l,11),e?(w.bra=w.cursor,w.limit_backward=r,1==e&&w.slice_del()):w.limit_backward=r)}var s,a,m=[new r("a",-1,1),new r("e",-1,1),new r("ede",1,1),new r("ande",1,1),new r("ende",1,1),new r("ane",1,1),new r("ene",1,1),new r("hetene",6,1),new r("erte",1,3),new r("en",-1,1),new r("heten",9,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",12,1),new r("s",-1,2),new r("as",14,1),new r("es",14,1),new r("edes",16,1),new r("endes",16,1),new r("enes",16,1),new r("hetenes",19,1),new r("ens",14,1),new r("hetens",21,1),new r("ers",14,1),new r("ets",14,1),new r("et",-1,1),new r("het",25,1),new r("ert",-1,3),new r("ast",-1,1)],u=[new r("dt",-1,-1),new r("vt",-1,-1)],l=[new r("leg",-1,1),new r("eleg",0,1),new r("ig",-1,1),new r("eig",2,1),new r("lig",2,1),new r("elig",4,1),new r("els",-1,1),new r("lov",-1,1),new r("elov",7,1),new r("slov",7,1),new r("hetslov",9,1)],d=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],c=[119,125,149,1],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,i(),w.cursor=w.limit,t(),w.cursor=w.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.no.stemmer,"stemmer-no"),e.no.stopWordFilter=e.generateStopWordFilter("alle at av bare begge ble blei bli blir blitt både båe da de deg dei deim deira deires dem den denne der dere deres det dette di din disse ditt du dykk dykkar då eg ein eit eitt eller elles en enn er et ett etter for fordi fra før ha hadde han hans har hennar henne hennes her hjå ho hoe honom hoss hossen hun hva hvem hver hvilke hvilken hvis hvor hvordan hvorfor i ikke ikkje ikkje ingen ingi inkje inn inni ja jeg kan kom korleis korso kun kunne kva kvar kvarhelst kven kvi kvifor man mange me med medan meg meget mellom men mi min mine mitt mot mykje ned no noe noen noka noko nokon nokor nokre nå når og også om opp oss over på samme seg selv si si sia sidan siden sin sine sitt sjøl skal skulle slik so som som somme somt så sånn til um upp ut uten var vart varte ved vere verte vi vil ville vore vors vort vår være være vært å".split(" ")),e.Pipeline.registerFunction(e.no.stopWordFilter,"stopWordFilter-no")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.pt.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.pt.min.js
deleted file mode 100644
index 6c16996d6..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.pt.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Portuguese` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.pt=function(){this.pipeline.reset(),this.pipeline.add(e.pt.trimmer,e.pt.stopWordFilter,e.pt.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.pt.stemmer))},e.pt.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.pt.trimmer=e.trimmerSupport.generateTrimmer(e.pt.wordCharacters),e.Pipeline.registerFunction(e.pt.trimmer,"trimmer-pt"),e.pt.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(k,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("a~");continue;case 2:z.slice_from("o~");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function n(){if(z.out_grouping(y,97,250)){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!0;z.cursor++}return!1}return!0}function i(){if(z.in_grouping(y,97,250))for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return g=z.cursor,!0}function o(){var e,r,s=z.cursor;if(z.in_grouping(y,97,250))if(e=z.cursor,n()){if(z.cursor=e,i())return}else g=z.cursor;if(z.cursor=s,z.out_grouping(y,97,250)){if(r=z.cursor,n()){if(z.cursor=r,!z.in_grouping(y,97,250)||z.cursor>=z.limit)return;z.cursor++}g=z.cursor}}function t(){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return!0}function a(){var e=z.cursor;g=z.limit,b=g,h=g,o(),z.cursor=e,t()&&(b=z.cursor,t()&&(h=z.cursor))}function u(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(q,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("ã");continue;case 2:z.slice_from("õ");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function w(){return g<=z.cursor}function m(){return b<=z.cursor}function c(){return h<=z.cursor}function l(){var e;if(z.ket=z.cursor,!(e=z.find_among_b(F,45)))return!1;switch(z.bra=z.cursor,e){case 1:if(!c())return!1;z.slice_del();break;case 2:if(!c())return!1;z.slice_from("log");break;case 3:if(!c())return!1;z.slice_from("u");break;case 4:if(!c())return!1;z.slice_from("ente");break;case 5:if(!m())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(j,4),e&&(z.bra=z.cursor,c()&&(z.slice_del(),1==e&&(z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del()))));break;case 6:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(C,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 7:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(P,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 8:if(!c())return!1;z.slice_del(),z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del());break;case 9:if(!w()||!z.eq_s_b(1,"e"))return!1;z.slice_from("ir")}return!0}function f(){var e,r;if(z.cursor>=g){if(r=z.limit_backward,z.limit_backward=g,z.ket=z.cursor,e=z.find_among_b(S,120))return z.bra=z.cursor,1==e&&z.slice_del(),z.limit_backward=r,!0;z.limit_backward=r}return!1}function d(){var e;z.ket=z.cursor,(e=z.find_among_b(W,7))&&(z.bra=z.cursor,1==e&&w()&&z.slice_del())}function v(e,r){if(z.eq_s_b(1,e)){z.bra=z.cursor;var s=z.limit-z.cursor;if(z.eq_s_b(1,r))return z.cursor=z.limit-s,w()&&z.slice_del(),!1}return!0}function p(){var e;if(z.ket=z.cursor,e=z.find_among_b(L,4))switch(z.bra=z.cursor,e){case 1:w()&&(z.slice_del(),z.ket=z.cursor,z.limit-z.cursor,v("u","g")&&v("i","c"));break;case 2:z.slice_from("c")}}function _(){if(!l()&&(z.cursor=z.limit,!f()))return z.cursor=z.limit,void d();z.cursor=z.limit,z.ket=z.cursor,z.eq_s_b(1,"i")&&(z.bra=z.cursor,z.eq_s_b(1,"c")&&(z.cursor=z.limit,w()&&z.slice_del()))}var h,b,g,k=[new r("",-1,3),new r("ã",0,1),new r("õ",0,2)],q=[new r("",-1,3),new r("a~",0,1),new r("o~",0,2)],j=[new r("ic",-1,-1),new r("ad",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],C=[new r("ante",-1,1),new r("avel",-1,1),new r("ível",-1,1)],P=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],F=[new r("ica",-1,1),new r("ância",-1,1),new r("ência",-1,4),new r("ira",-1,9),new r("adora",-1,1),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,8),new r("eza",-1,1),new r("logía",-1,2),new r("idade",-1,7),new r("ante",-1,1),new r("mente",-1,6),new r("amente",12,5),new r("ável",-1,1),new r("ível",-1,1),new r("ución",-1,3),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,1),new r("imento",-1,1),new r("ivo",-1,8),new r("aça~o",-1,1),new r("ador",-1,1),new r("icas",-1,1),new r("ências",-1,4),new r("iras",-1,9),new r("adoras",-1,1),new r("osas",-1,1),new r("istas",-1,1),new r("ivas",-1,8),new r("ezas",-1,1),new r("logías",-1,2),new r("idades",-1,7),new r("uciones",-1,3),new r("adores",-1,1),new r("antes",-1,1),new r("aço~es",-1,1),new r("icos",-1,1),new r("ismos",-1,1),new r("osos",-1,1),new r("amentos",-1,1),new r("imentos",-1,1),new r("ivos",-1,8)],S=[new r("ada",-1,1),new r("ida",-1,1),new r("ia",-1,1),new r("aria",2,1),new r("eria",2,1),new r("iria",2,1),new r("ara",-1,1),new r("era",-1,1),new r("ira",-1,1),new r("ava",-1,1),new r("asse",-1,1),new r("esse",-1,1),new r("isse",-1,1),new r("aste",-1,1),new r("este",-1,1),new r("iste",-1,1),new r("ei",-1,1),new r("arei",16,1),new r("erei",16,1),new r("irei",16,1),new r("am",-1,1),new r("iam",20,1),new r("ariam",21,1),new r("eriam",21,1),new r("iriam",21,1),new r("aram",20,1),new r("eram",20,1),new r("iram",20,1),new r("avam",20,1),new r("em",-1,1),new r("arem",29,1),new r("erem",29,1),new r("irem",29,1),new r("assem",29,1),new r("essem",29,1),new r("issem",29,1),new r("ado",-1,1),new r("ido",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("indo",-1,1),new r("ara~o",-1,1),new r("era~o",-1,1),new r("ira~o",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("ir",-1,1),new r("as",-1,1),new r("adas",47,1),new r("idas",47,1),new r("ias",47,1),new r("arias",50,1),new r("erias",50,1),new r("irias",50,1),new r("aras",47,1),new r("eras",47,1),new r("iras",47,1),new r("avas",47,1),new r("es",-1,1),new r("ardes",58,1),new r("erdes",58,1),new r("irdes",58,1),new r("ares",58,1),new r("eres",58,1),new r("ires",58,1),new r("asses",58,1),new r("esses",58,1),new r("isses",58,1),new r("astes",58,1),new r("estes",58,1),new r("istes",58,1),new r("is",-1,1),new r("ais",71,1),new r("eis",71,1),new r("areis",73,1),new r("ereis",73,1),new r("ireis",73,1),new r("áreis",73,1),new r("éreis",73,1),new r("íreis",73,1),new r("ásseis",73,1),new r("ésseis",73,1),new r("ísseis",73,1),new r("áveis",73,1),new r("íeis",73,1),new r("aríeis",84,1),new r("eríeis",84,1),new r("iríeis",84,1),new r("ados",-1,1),new r("idos",-1,1),new r("amos",-1,1),new r("áramos",90,1),new r("éramos",90,1),new r("íramos",90,1),new r("ávamos",90,1),new r("íamos",90,1),new r("aríamos",95,1),new r("eríamos",95,1),new r("iríamos",95,1),new r("emos",-1,1),new r("aremos",99,1),new r("eremos",99,1),new r("iremos",99,1),new r("ássemos",99,1),new r("êssemos",99,1),new r("íssemos",99,1),new r("imos",-1,1),new r("armos",-1,1),new r("ermos",-1,1),new r("irmos",-1,1),new r("ámos",-1,1),new r("arás",-1,1),new r("erás",-1,1),new r("irás",-1,1),new r("eu",-1,1),new r("iu",-1,1),new r("ou",-1,1),new r("ará",-1,1),new r("erá",-1,1),new r("irá",-1,1)],W=[new r("a",-1,1),new r("i",-1,1),new r("o",-1,1),new r("os",-1,1),new r("á",-1,1),new r("í",-1,1),new r("ó",-1,1)],L=[new r("e",-1,1),new r("ç",-1,2),new r("é",-1,1),new r("ê",-1,1)],y=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,3,19,12,2],z=new s;this.setCurrent=function(e){z.setCurrent(e)},this.getCurrent=function(){return z.getCurrent()},this.stem=function(){var r=z.cursor;return e(),z.cursor=r,a(),z.limit_backward=r,z.cursor=z.limit,_(),z.cursor=z.limit,p(),z.cursor=z.limit_backward,u(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.pt.stemmer,"stemmer-pt"),e.pt.stopWordFilter=e.generateStopWordFilter("a ao aos aquela aquelas aquele aqueles aquilo as até com como da das de dela delas dele deles depois do dos e ela elas ele eles em entre era eram essa essas esse esses esta estamos estas estava estavam este esteja estejam estejamos estes esteve estive estivemos estiver estivera estiveram estiverem estivermos estivesse estivessem estivéramos estivéssemos estou está estávamos estão eu foi fomos for fora foram forem formos fosse fossem fui fôramos fôssemos haja hajam hajamos havemos hei houve houvemos houver houvera houveram houverei houverem houveremos houveria houveriam houvermos houverá houverão houveríamos houvesse houvessem houvéramos houvéssemos há hão isso isto já lhe lhes mais mas me mesmo meu meus minha minhas muito na nas nem no nos nossa nossas nosso nossos num numa não nós o os ou para pela pelas pelo pelos por qual quando que quem se seja sejam sejamos sem serei seremos seria seriam será serão seríamos seu seus somos sou sua suas são só também te tem temos tenha tenham tenhamos tenho terei teremos teria teriam terá terão teríamos teu teus teve tinha tinham tive tivemos tiver tivera tiveram tiverem tivermos tivesse tivessem tivéramos tivéssemos tu tua tuas tém tínhamos um uma você vocês vos à às éramos".split(" ")),e.Pipeline.registerFunction(e.pt.stopWordFilter,"stopWordFilter-pt")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.ro.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.ro.min.js
deleted file mode 100644
index 727714018..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.ro.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Romanian` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ro=function(){this.pipeline.reset(),this.pipeline.add(e.ro.trimmer,e.ro.stopWordFilter,e.ro.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ro.stemmer))},e.ro.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.ro.trimmer=e.trimmerSupport.generateTrimmer(e.ro.wordCharacters),e.Pipeline.registerFunction(e.ro.trimmer,"trimmer-ro"),e.ro.stemmer=function(){var i=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(e,i){L.eq_s(1,e)&&(L.ket=L.cursor,L.in_grouping(W,97,259)&&L.slice_from(i))}function n(){for(var i,r;;){if(i=L.cursor,L.in_grouping(W,97,259)&&(r=L.cursor,L.bra=r,e("u","U"),L.cursor=r,e("i","I")),L.cursor=i,L.cursor>=L.limit)break;L.cursor++}}function t(){if(L.out_grouping(W,97,259)){for(;!L.in_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}return!0}function a(){if(L.in_grouping(W,97,259))for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}function o(){var e,i,r=L.cursor;if(L.in_grouping(W,97,259)){if(e=L.cursor,!t())return void(h=L.cursor);if(L.cursor=e,!a())return void(h=L.cursor)}L.cursor=r,L.out_grouping(W,97,259)&&(i=L.cursor,t()&&(L.cursor=i,L.in_grouping(W,97,259)&&L.cursor<L.limit&&L.cursor++),h=L.cursor)}function u(){for(;!L.in_grouping(W,97,259);){if(L.cursor>=L.limit)return!1;L.cursor++}for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!1;L.cursor++}return!0}function c(){var e=L.cursor;h=L.limit,k=h,g=h,o(),L.cursor=e,u()&&(k=L.cursor,u()&&(g=L.cursor))}function s(){for(var e;;){if(L.bra=L.cursor,e=L.find_among(z,3))switch(L.ket=L.cursor,e){case 1:L.slice_from("i");continue;case 2:L.slice_from("u");continue;case 3:if(L.cursor>=L.limit)break;L.cursor++;continue}break}}function w(){return h<=L.cursor}function m(){return k<=L.cursor}function l(){return g<=L.cursor}function f(){var e,i;if(L.ket=L.cursor,(e=L.find_among_b(C,16))&&(L.bra=L.cursor,m()))switch(e){case 1:L.slice_del();break;case 2:L.slice_from("a");break;case 3:L.slice_from("e");break;case 4:L.slice_from("i");break;case 5:i=L.limit-L.cursor,L.eq_s_b(2,"ab")||(L.cursor=L.limit-i,L.slice_from("i"));break;case 6:L.slice_from("at");break;case 7:L.slice_from("aţi")}}function p(){var e,i=L.limit-L.cursor;if(L.ket=L.cursor,(e=L.find_among_b(P,46))&&(L.bra=L.cursor,m())){switch(e){case 1:L.slice_from("abil");break;case 2:L.slice_from("ibil");break;case 3:L.slice_from("iv");break;case 4:L.slice_from("ic");break;case 5:L.slice_from("at");break;case 6:L.slice_from("it")}return _=!0,L.cursor=L.limit-i,!0}return!1}function d(){var e,i;for(_=!1;;)if(i=L.limit-L.cursor,!p()){L.cursor=L.limit-i;break}if(L.ket=L.cursor,(e=L.find_among_b(F,62))&&(L.bra=L.cursor,l())){switch(e){case 1:L.slice_del();break;case 2:L.eq_s_b(1,"ţ")&&(L.bra=L.cursor,L.slice_from("t"));break;case 3:L.slice_from("ist")}_=!0}}function b(){var e,i,r;if(L.cursor>=h){if(i=L.limit_backward,L.limit_backward=h,L.ket=L.cursor,e=L.find_among_b(q,94))switch(L.bra=L.cursor,e){case 1:if(r=L.limit-L.cursor,!L.out_grouping_b(W,97,259)&&(L.cursor=L.limit-r,!L.eq_s_b(1,"u")))break;case 2:L.slice_del()}L.limit_backward=i}}function v(){var e;L.ket=L.cursor,(e=L.find_among_b(S,5))&&(L.bra=L.cursor,w()&&1==e&&L.slice_del())}var _,g,k,h,z=[new i("",-1,3),new i("I",0,1),new i("U",0,2)],C=[new i("ea",-1,3),new i("aţia",-1,7),new i("aua",-1,2),new i("iua",-1,4),new i("aţie",-1,7),new i("ele",-1,3),new i("ile",-1,5),new i("iile",6,4),new i("iei",-1,4),new i("atei",-1,6),new i("ii",-1,4),new i("ului",-1,1),new i("ul",-1,1),new i("elor",-1,3),new i("ilor",-1,4),new i("iilor",14,4)],P=[new i("icala",-1,4),new i("iciva",-1,4),new i("ativa",-1,5),new i("itiva",-1,6),new i("icale",-1,4),new i("aţiune",-1,5),new i("iţiune",-1,6),new i("atoare",-1,5),new i("itoare",-1,6),new i("ătoare",-1,5),new i("icitate",-1,4),new i("abilitate",-1,1),new i("ibilitate",-1,2),new i("ivitate",-1,3),new i("icive",-1,4),new i("ative",-1,5),new i("itive",-1,6),new i("icali",-1,4),new i("atori",-1,5),new i("icatori",18,4),new i("itori",-1,6),new i("ători",-1,5),new i("icitati",-1,4),new i("abilitati",-1,1),new i("ivitati",-1,3),new i("icivi",-1,4),new i("ativi",-1,5),new i("itivi",-1,6),new i("icităi",-1,4),new i("abilităi",-1,1),new i("ivităi",-1,3),new i("icităţi",-1,4),new i("abilităţi",-1,1),new i("ivităţi",-1,3),new i("ical",-1,4),new i("ator",-1,5),new i("icator",35,4),new i("itor",-1,6),new i("ător",-1,5),new i("iciv",-1,4),new i("ativ",-1,5),new i("itiv",-1,6),new i("icală",-1,4),new i("icivă",-1,4),new i("ativă",-1,5),new i("itivă",-1,6)],F=[new i("ica",-1,1),new i("abila",-1,1),new i("ibila",-1,1),new i("oasa",-1,1),new i("ata",-1,1),new i("ita",-1,1),new i("anta",-1,1),new i("ista",-1,3),new i("uta",-1,1),new i("iva",-1,1),new i("ic",-1,1),new i("ice",-1,1),new i("abile",-1,1),new i("ibile",-1,1),new i("isme",-1,3),new i("iune",-1,2),new i("oase",-1,1),new i("ate",-1,1),new i("itate",17,1),new i("ite",-1,1),new i("ante",-1,1),new i("iste",-1,3),new i("ute",-1,1),new i("ive",-1,1),new i("ici",-1,1),new i("abili",-1,1),new i("ibili",-1,1),new i("iuni",-1,2),new i("atori",-1,1),new i("osi",-1,1),new i("ati",-1,1),new i("itati",30,1),new i("iti",-1,1),new i("anti",-1,1),new i("isti",-1,3),new i("uti",-1,1),new i("işti",-1,3),new i("ivi",-1,1),new i("ităi",-1,1),new i("oşi",-1,1),new i("ităţi",-1,1),new i("abil",-1,1),new i("ibil",-1,1),new i("ism",-1,3),new i("ator",-1,1),new i("os",-1,1),new i("at",-1,1),new i("it",-1,1),new i("ant",-1,1),new i("ist",-1,3),new i("ut",-1,1),new i("iv",-1,1),new i("ică",-1,1),new i("abilă",-1,1),new i("ibilă",-1,1),new i("oasă",-1,1),new i("ată",-1,1),new i("ită",-1,1),new i("antă",-1,1),new i("istă",-1,3),new i("ută",-1,1),new i("ivă",-1,1)],q=[new i("ea",-1,1),new i("ia",-1,1),new i("esc",-1,1),new i("ăsc",-1,1),new i("ind",-1,1),new i("ând",-1,1),new i("are",-1,1),new i("ere",-1,1),new i("ire",-1,1),new i("âre",-1,1),new i("se",-1,2),new i("ase",10,1),new i("sese",10,2),new i("ise",10,1),new i("use",10,1),new i("âse",10,1),new i("eşte",-1,1),new i("ăşte",-1,1),new i("eze",-1,1),new i("ai",-1,1),new i("eai",19,1),new i("iai",19,1),new i("sei",-1,2),new i("eşti",-1,1),new i("ăşti",-1,1),new i("ui",-1,1),new i("ezi",-1,1),new i("âi",-1,1),new i("aşi",-1,1),new i("seşi",-1,2),new i("aseşi",29,1),new i("seseşi",29,2),new i("iseşi",29,1),new i("useşi",29,1),new i("âseşi",29,1),new i("işi",-1,1),new i("uşi",-1,1),new i("âşi",-1,1),new i("aţi",-1,2),new i("eaţi",38,1),new i("iaţi",38,1),new i("eţi",-1,2),new i("iţi",-1,2),new i("âţi",-1,2),new i("arăţi",-1,1),new i("serăţi",-1,2),new i("aserăţi",45,1),new i("seserăţi",45,2),new i("iserăţi",45,1),new i("userăţi",45,1),new i("âserăţi",45,1),new i("irăţi",-1,1),new i("urăţi",-1,1),new i("ârăţi",-1,1),new i("am",-1,1),new i("eam",54,1),new i("iam",54,1),new i("em",-1,2),new i("asem",57,1),new i("sesem",57,2),new i("isem",57,1),new i("usem",57,1),new i("âsem",57,1),new i("im",-1,2),new i("âm",-1,2),new i("ăm",-1,2),new i("arăm",65,1),new i("serăm",65,2),new i("aserăm",67,1),new i("seserăm",67,2),new i("iserăm",67,1),new i("userăm",67,1),new i("âserăm",67,1),new i("irăm",65,1),new i("urăm",65,1),new i("ârăm",65,1),new i("au",-1,1),new i("eau",76,1),new i("iau",76,1),new i("indu",-1,1),new i("ându",-1,1),new i("ez",-1,1),new i("ească",-1,1),new i("ară",-1,1),new i("seră",-1,2),new i("aseră",84,1),new i("seseră",84,2),new i("iseră",84,1),new i("useră",84,1),new i("âseră",84,1),new i("iră",-1,1),new i("ură",-1,1),new i("âră",-1,1),new i("ează",-1,1)],S=[new i("a",-1,1),new i("e",-1,1),new i("ie",1,1),new i("i",-1,1),new i("ă",-1,1)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,2,32,0,0,4],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var e=L.cursor;return n(),L.cursor=e,c(),L.limit_backward=e,L.cursor=L.limit,f(),L.cursor=L.limit,d(),L.cursor=L.limit,_||(L.cursor=L.limit,b(),L.cursor=L.limit),v(),L.cursor=L.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.ro.stemmer,"stemmer-ro"),e.ro.stopWordFilter=e.generateStopWordFilter("acea aceasta această aceea acei aceia acel acela acele acelea acest acesta aceste acestea aceşti aceştia acolo acord acum ai aia aibă aici al ale alea altceva altcineva am ar are asemenea asta astea astăzi asupra au avea avem aveţi azi aş aşadar aţi bine bucur bună ca care caut ce cel ceva chiar cinci cine cineva contra cu cum cumva curând curînd când cât câte câtva câţi cînd cît cîte cîtva cîţi că căci cărei căror cărui către da dacă dar datorită dată dau de deci deja deoarece departe deşi din dinaintea dintr- dintre doi doilea două drept după dă ea ei el ele eram este eu eşti face fata fi fie fiecare fii fim fiu fiţi frumos fără graţie halbă iar ieri la le li lor lui lângă lîngă mai mea mei mele mereu meu mi mie mine mult multă mulţi mulţumesc mâine mîine mă ne nevoie nici nicăieri nimeni nimeri nimic nişte noastre noastră noi noroc nostru nouă noştri nu opt ori oricare orice oricine oricum oricând oricât oricînd oricît oriunde patra patru patrulea pe pentru peste pic poate pot prea prima primul prin puţin puţina puţină până pînă rog sa sale sau se spate spre sub sunt suntem sunteţi sută sînt sîntem sînteţi să săi său ta tale te timp tine toate toată tot totuşi toţi trei treia treilea tu tăi tău un una unde undeva unei uneia unele uneori unii unor unora unu unui unuia unul vi voastre voastră voi vostru vouă voştri vreme vreo vreun vă zece zero zi zice îi îl îmi împotriva în  înainte înaintea încotro încât încît între întrucât întrucît îţi ăla ălea ăsta ăstea ăştia şapte şase şi ştiu ţi ţie".split(" ")),e.Pipeline.registerFunction(e.ro.stopWordFilter,"stopWordFilter-ro")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.ru.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.ru.min.js
deleted file mode 100644
index 186cc485c..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.ru.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Russian` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ru=function(){this.pipeline.reset(),this.pipeline.add(e.ru.trimmer,e.ru.stopWordFilter,e.ru.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ru.stemmer))},e.ru.wordCharacters="Ѐ-҄҇-ԯᴫᵸⷠ-ⷿꙀ-ꚟ︮︯",e.ru.trimmer=e.trimmerSupport.generateTrimmer(e.ru.wordCharacters),e.Pipeline.registerFunction(e.ru.trimmer,"trimmer-ru"),e.ru.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,t=new function(){function e(){for(;!W.in_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function t(){for(;!W.out_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function w(){b=W.limit,_=b,e()&&(b=W.cursor,t()&&e()&&t()&&(_=W.cursor))}function i(){return _<=W.cursor}function u(e,n){var r,t;if(W.ket=W.cursor,r=W.find_among_b(e,n)){switch(W.bra=W.cursor,r){case 1:if(t=W.limit-W.cursor,!W.eq_s_b(1,"а")&&(W.cursor=W.limit-t,!W.eq_s_b(1,"я")))return!1;case 2:W.slice_del()}return!0}return!1}function o(){return u(h,9)}function s(e,n){var r;return W.ket=W.cursor,!!(r=W.find_among_b(e,n))&&(W.bra=W.cursor,1==r&&W.slice_del(),!0)}function c(){return s(g,26)}function m(){return!!c()&&(u(C,8),!0)}function f(){return s(k,2)}function l(){return u(P,46)}function a(){s(v,36)}function p(){var e;W.ket=W.cursor,(e=W.find_among_b(F,2))&&(W.bra=W.cursor,i()&&1==e&&W.slice_del())}function d(){var e;if(W.ket=W.cursor,e=W.find_among_b(q,4))switch(W.bra=W.cursor,e){case 1:if(W.slice_del(),W.ket=W.cursor,!W.eq_s_b(1,"н"))break;W.bra=W.cursor;case 2:if(!W.eq_s_b(1,"н"))break;case 3:W.slice_del()}}var _,b,h=[new n("в",-1,1),new n("ив",0,2),new n("ыв",0,2),new n("вши",-1,1),new n("ивши",3,2),new n("ывши",3,2),new n("вшись",-1,1),new n("ившись",6,2),new n("ывшись",6,2)],g=[new n("ее",-1,1),new n("ие",-1,1),new n("ое",-1,1),new n("ые",-1,1),new n("ими",-1,1),new n("ыми",-1,1),new n("ей",-1,1),new n("ий",-1,1),new n("ой",-1,1),new n("ый",-1,1),new n("ем",-1,1),new n("им",-1,1),new n("ом",-1,1),new n("ым",-1,1),new n("его",-1,1),new n("ого",-1,1),new n("ему",-1,1),new n("ому",-1,1),new n("их",-1,1),new n("ых",-1,1),new n("ею",-1,1),new n("ою",-1,1),new n("ую",-1,1),new n("юю",-1,1),new n("ая",-1,1),new n("яя",-1,1)],C=[new n("ем",-1,1),new n("нн",-1,1),new n("вш",-1,1),new n("ивш",2,2),new n("ывш",2,2),new n("щ",-1,1),new n("ющ",5,1),new n("ующ",6,2)],k=[new n("сь",-1,1),new n("ся",-1,1)],P=[new n("ла",-1,1),new n("ила",0,2),new n("ыла",0,2),new n("на",-1,1),new n("ена",3,2),new n("ете",-1,1),new n("ите",-1,2),new n("йте",-1,1),new n("ейте",7,2),new n("уйте",7,2),new n("ли",-1,1),new n("или",10,2),new n("ыли",10,2),new n("й",-1,1),new n("ей",13,2),new n("уй",13,2),new n("л",-1,1),new n("ил",16,2),new n("ыл",16,2),new n("ем",-1,1),new n("им",-1,2),new n("ым",-1,2),new n("н",-1,1),new n("ен",22,2),new n("ло",-1,1),new n("ило",24,2),new n("ыло",24,2),new n("но",-1,1),new n("ено",27,2),new n("нно",27,1),new n("ет",-1,1),new n("ует",30,2),new n("ит",-1,2),new n("ыт",-1,2),new n("ют",-1,1),new n("уют",34,2),new n("ят",-1,2),new n("ны",-1,1),new n("ены",37,2),new n("ть",-1,1),new n("ить",39,2),new n("ыть",39,2),new n("ешь",-1,1),new n("ишь",-1,2),new n("ю",-1,2),new n("ую",44,2)],v=[new n("а",-1,1),new n("ев",-1,1),new n("ов",-1,1),new n("е",-1,1),new n("ие",3,1),new n("ье",3,1),new n("и",-1,1),new n("еи",6,1),new n("ии",6,1),new n("ами",6,1),new n("ями",6,1),new n("иями",10,1),new n("й",-1,1),new n("ей",12,1),new n("ией",13,1),new n("ий",12,1),new n("ой",12,1),new n("ам",-1,1),new n("ем",-1,1),new n("ием",18,1),new n("ом",-1,1),new n("ям",-1,1),new n("иям",21,1),new n("о",-1,1),new n("у",-1,1),new n("ах",-1,1),new n("ях",-1,1),new n("иях",26,1),new n("ы",-1,1),new n("ь",-1,1),new n("ю",-1,1),new n("ию",30,1),new n("ью",30,1),new n("я",-1,1),new n("ия",33,1),new n("ья",33,1)],F=[new n("ост",-1,1),new n("ость",-1,1)],q=[new n("ейше",-1,1),new n("н",-1,2),new n("ейш",-1,1),new n("ь",-1,3)],S=[33,65,8,232],W=new r;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){return w(),W.cursor=W.limit,!(W.cursor<b)&&(W.limit_backward=b,o()||(W.cursor=W.limit,f()||(W.cursor=W.limit),m()||(W.cursor=W.limit,l()||(W.cursor=W.limit,a()))),W.cursor=W.limit,W.ket=W.cursor,W.eq_s_b(1,"и")?(W.bra=W.cursor,W.slice_del()):W.cursor=W.limit,p(),W.cursor=W.limit,d(),!0)}};return function(e){return"function"==typeof e.update?e.update(function(e){return t.setCurrent(e),t.stem(),t.getCurrent()}):(t.setCurrent(e),t.stem(),t.getCurrent())}}(),e.Pipeline.registerFunction(e.ru.stemmer,"stemmer-ru"),e.ru.stopWordFilter=e.generateStopWordFilter("алло без близко более больше будем будет будете будешь будто буду будут будь бы бывает бывь был была были было быть в важная важное важные важный вам вами вас ваш ваша ваше ваши вверх вдали вдруг ведь везде весь вниз внизу во вокруг вон восемнадцатый восемнадцать восемь восьмой вот впрочем времени время все всегда всего всем всеми всему всех всею всю всюду вся всё второй вы г где говорил говорит год года году да давно даже далеко дальше даром два двадцатый двадцать две двенадцатый двенадцать двух девятнадцатый девятнадцать девятый девять действительно дел день десятый десять для до довольно долго должно другая другие других друго другое другой е его ее ей ему если есть еще ещё ею её ж же жизнь за занят занята занято заняты затем зато зачем здесь значит и из или им именно иметь ими имя иногда их к каждая каждое каждые каждый кажется как какая какой кем когда кого ком кому конечно которая которого которой которые который которых кроме кругом кто куда лет ли лишь лучше люди м мало между меля менее меньше меня миллионов мимо мира мне много многочисленная многочисленное многочисленные многочисленный мной мною мог могут мож может можно можхо мои мой мор мочь моя моё мы на наверху над надо назад наиболее наконец нам нами нас начала наш наша наше наши не него недавно недалеко нее ней нельзя нем немного нему непрерывно нередко несколько нет нею неё ни нибудь ниже низко никогда никуда ними них ничего но ну нужно нх о об оба обычно один одиннадцатый одиннадцать однажды однако одного одной около он она они оно опять особенно от отовсюду отсюда очень первый перед по под пожалуйста позже пока пор пора после посреди потом потому почему почти прекрасно при про просто против процентов пятнадцатый пятнадцать пятый пять раз разве рано раньше рядом с сам сама сами самим самими самих само самого самой самом самому саму свое своего своей свои своих свою сеаой себе себя сегодня седьмой сейчас семнадцатый семнадцать семь сих сказал сказала сказать сколько слишком сначала снова со собой собою совсем спасибо стал суть т та так такая также такие такое такой там твой твоя твоё те тебе тебя тем теми теперь тех то тобой тобою тогда того тоже только том тому тот тою третий три тринадцатый тринадцать ту туда тут ты тысяч у уж уже уметь хорошо хотеть хоть хотя хочешь часто чаще чего человек чем чему через четвертый четыре четырнадцатый четырнадцать что чтоб чтобы чуть шестнадцатый шестнадцать шестой шесть эта эти этим этими этих это этого этой этом этому этот эту я \ufeffа".split(" ")),e.Pipeline.registerFunction(e.ru.stopWordFilter,"stopWordFilter-ru")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.sa.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.sa.min.js
deleted file mode 100644
index 50ee56420..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.sa.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.sa=function(){this.pipeline.reset(),this.pipeline.add(e.sa.trimmer,e.sa.stopWordFilter,e.sa.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.sa.stemmer))},e.sa.wordCharacters="ऀ-ःऄ-एऐ-टठ-यर-िी-ॏॐ-य़ॠ-९॰-ॿ꣠-꣱ꣲ-ꣷ꣸-ꣻ꣼-ꣽꣾ-ꣿᆰ0-ᆰ9",e.sa.trimmer=e.trimmerSupport.generateTrimmer(e.sa.wordCharacters),e.Pipeline.registerFunction(e.sa.trimmer,"trimmer-sa"),e.sa.stopWordFilter=e.generateStopWordFilter('तथा अयम्‌ एकम्‌ इत्यस्मिन्‌ तथा तत्‌ वा अयम्‌ इत्यस्य ते आहूत उपरि तेषाम्‌  किन्तु तेषाम्‌ तदा इत्यनेन अधिकः इत्यस्य तत्‌ केचन बहवः द्वि तथा महत्वपूर्णः अयम्‌ अस्य  विषये अयं अस्ति तत्‌ प्रथमः विषये इत्युपरि इत्युपरि इतर अधिकतमः अधिकः अपि सामान्यतया ठ इतरेतर नूतनम्‌ द  न्यूनम्‌ कश्चित्‌ वा विशालः द  सः अस्ति तदनुसारम् तत्र अस्ति केवलम्‌ अपि अत्र सर्वे विविधाः तत्‌ बहवः यतः इदानीम्‌ द  दक्षिण इत्यस्मै तस्य उपरि नथ अतीव कार्यम्‌ सर्वे एकैकम्‌ इत्यादि। एते सन्ति  उत इत्थम्‌ मध्ये एतदर्थं . स कस्य प्रथमः श्री. करोति अस्मिन् प्रकारः निर्मिता कालः तत्र कर्तुं  समान अधुना ते सन्ति स एकः अस्ति सः अर्थात् तेषां कृते . स्थितम्  विशेषः अग्रिम तेषाम्‌ समान स्रोतः ख म समान इदानीमपि अधिकतया करोतु ते समान इत्यस्य वीथी सह यस्मिन्  कृतवान्‌ धृतः तदा पुनः पूर्वं सः आगतः किम्‌ कुल इतर पुरा  मात्रा स विषये उ अतएव अपि नगरस्य  उपरि यतः प्रतिशतं  कतरः कालः साधनानि भूत तथापि जात सम्बन्धि अन्यत्‌ ग अतः अस्माकं स्वकीयाः अस्माकं इदानीं अन्तः इत्यादयः भवन्तः इत्यादयः एते एताः तस्य अस्य इदम् एते तेषां तेषां तेषां तान् तेषां तेषां तेषां समानः सः एकः च तादृशाः बहवः अन्ये च वदन्ति यत् कियत् कस्मै  कस्मै  यस्मै  यस्मै  यस्मै  यस्मै न अतिनीचः किन्तु प्रथमं सम्पूर्णतया  ततः चिरकालानन्तरं पुस्तकं सम्पूर्णतया अन्तः  किन्तु अत्र वा इह इव श्रद्धाय अवशिष्यते  परन्तु अन्ये वर्गाः सन्ति ते सन्ति शक्नुवन्ति सर्वे मिलित्वा सर्वे एकत्र"'.split(" ")),e.sa.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.sa.tokenizer=function(t){if(!arguments.length||null==t||void 0==t)return[];if(Array.isArray(t))return t.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var i=t.toString().toLowerCase().replace(/^\s+/,"");return r.cut(i).split("|")},e.Pipeline.registerFunction(e.sa.stemmer,"stemmer-sa"),e.Pipeline.registerFunction(e.sa.stopWordFilter,"stopWordFilter-sa")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.stemmer.support.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.stemmer.support.min.js
deleted file mode 100644
index abd4475bb..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.stemmer.support.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(r,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(r.lunr)}(this,function(){return function(r){r.stemmerSupport={Among:function(r,t,i,s){if(this.toCharArray=function(r){for(var t=r.length,i=new Array(t),s=0;s<t;s++)i[s]=r.charCodeAt(s);return i},!r&&""!=r||!t&&0!=t||!i)throw"Bad Among initialisation: s:"+r+", substring_i: "+t+", result: "+i;this.s_size=r.length,this.s=this.toCharArray(r),this.substring_i=t,this.result=i,this.method=s},SnowballProgram:function(){var r;return{bra:0,ket:0,limit:0,cursor:0,limit_backward:0,setCurrent:function(t){r=t,this.cursor=0,this.limit=t.length,this.limit_backward=0,this.bra=this.cursor,this.ket=this.limit},getCurrent:function(){var t=r;return r=null,t},in_grouping:function(t,i,s){if(this.cursor<this.limit){var e=r.charCodeAt(this.cursor);if(e<=s&&e>=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor++,!0}return!1},in_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e<=s&&e>=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor--,!0}return!1},out_grouping:function(t,i,s){if(this.cursor<this.limit){var e=r.charCodeAt(this.cursor);if(e>s||e<i)return this.cursor++,!0;if(e-=i,!(t[e>>3]&1<<(7&e)))return this.cursor++,!0}return!1},out_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e>s||e<i)return this.cursor--,!0;if(e-=i,!(t[e>>3]&1<<(7&e)))return this.cursor--,!0}return!1},eq_s:function(t,i){if(this.limit-this.cursor<t)return!1;for(var s=0;s<t;s++)if(r.charCodeAt(this.cursor+s)!=i.charCodeAt(s))return!1;return this.cursor+=t,!0},eq_s_b:function(t,i){if(this.cursor-this.limit_backward<t)return!1;for(var s=0;s<t;s++)if(r.charCodeAt(this.cursor-t+s)!=i.charCodeAt(s))return!1;return this.cursor-=t,!0},find_among:function(t,i){for(var s=0,e=i,n=this.cursor,u=this.limit,o=0,h=0,c=!1;;){for(var a=s+(e-s>>1),f=0,l=o<h?o:h,_=t[a],m=l;m<_.s_size;m++){if(n+l==u){f=-1;break}if(f=r.charCodeAt(n+l)-_.s[m])break;l++}if(f<0?(e=a,h=l):(s=a,o=l),e-s<=1){if(s>0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n+_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n+_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},find_among_b:function(t,i){for(var s=0,e=i,n=this.cursor,u=this.limit_backward,o=0,h=0,c=!1;;){for(var a=s+(e-s>>1),f=0,l=o<h?o:h,_=t[a],m=_.s_size-1-l;m>=0;m--){if(n-l==u){f=-1;break}if(f=r.charCodeAt(n-1-l)-_.s[m])break;l++}if(f<0?(e=a,h=l):(s=a,o=l),e-s<=1){if(s>0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n-_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n-_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},replace_s:function(t,i,s){var e=s.length-(i-t),n=r.substring(0,t),u=r.substring(i);return r=n+s+u,this.limit+=e,this.cursor>=i?this.cursor+=e:this.cursor>t&&(this.cursor=t),e},slice_check:function(){if(this.bra<0||this.bra>this.ket||this.ket>this.limit||this.limit>r.length)throw"faulty slice operation"},slice_from:function(r){this.slice_check(),this.replace_s(this.bra,this.ket,r)},slice_del:function(){this.slice_from("")},insert:function(r,t,i){var s=this.replace_s(r,t,i);r<=this.bra&&(this.bra+=s),r<=this.ket&&(this.ket+=s)},slice_to:function(){return this.slice_check(),r.substring(this.bra,this.ket)},eq_v_b:function(r){return this.eq_s_b(r.length,r)}}}},r.trimmerSupport={generateTrimmer:function(r){var t=new RegExp("^[^"+r+"]+"),i=new RegExp("[^"+r+"]+$");return function(r){return"function"==typeof r.update?r.update(function(r){return r.replace(t,"").replace(i,"")}):r.replace(t,"").replace(i,"")}}}}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.sv.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.sv.min.js
deleted file mode 100644
index 3e5eb6400..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.sv.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Swedish` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.sv=function(){this.pipeline.reset(),this.pipeline.add(e.sv.trimmer,e.sv.stopWordFilter,e.sv.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.sv.stemmer))},e.sv.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.sv.trimmer=e.trimmerSupport.generateTrimmer(e.sv.wordCharacters),e.Pipeline.registerFunction(e.sv.trimmer,"trimmer-sv"),e.sv.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,t=new function(){function e(){var e,r=w.cursor+3;if(o=w.limit,0<=r||r<=w.limit){for(a=r;;){if(e=w.cursor,w.in_grouping(l,97,246)){w.cursor=e;break}if(w.cursor=e,w.cursor>=w.limit)return;w.cursor++}for(;!w.out_grouping(l,97,246);){if(w.cursor>=w.limit)return;w.cursor++}o=w.cursor,o<a&&(o=a)}}function t(){var e,r=w.limit_backward;if(w.cursor>=o&&(w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(u,37),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.in_grouping_b(d,98,121)&&w.slice_del()}}function i(){var e=w.limit_backward;w.cursor>=o&&(w.limit_backward=o,w.cursor=w.limit,w.find_among_b(c,7)&&(w.cursor=w.limit,w.ket=w.cursor,w.cursor>w.limit_backward&&(w.bra=--w.cursor,w.slice_del())),w.limit_backward=e)}function s(){var e,r;if(w.cursor>=o){if(r=w.limit_backward,w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(m,5))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.slice_from("lös");break;case 3:w.slice_from("full")}w.limit_backward=r}}var a,o,u=[new r("a",-1,1),new r("arna",0,1),new r("erna",0,1),new r("heterna",2,1),new r("orna",0,1),new r("ad",-1,1),new r("e",-1,1),new r("ade",6,1),new r("ande",6,1),new r("arne",6,1),new r("are",6,1),new r("aste",6,1),new r("en",-1,1),new r("anden",12,1),new r("aren",12,1),new r("heten",12,1),new r("ern",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",18,1),new r("or",-1,1),new r("s",-1,2),new r("as",21,1),new r("arnas",22,1),new r("ernas",22,1),new r("ornas",22,1),new r("es",21,1),new r("ades",26,1),new r("andes",26,1),new r("ens",21,1),new r("arens",29,1),new r("hetens",29,1),new r("erns",21,1),new r("at",-1,1),new r("andet",-1,1),new r("het",-1,1),new r("ast",-1,1)],c=[new r("dd",-1,-1),new r("gd",-1,-1),new r("nn",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1),new r("tt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("els",-1,1),new r("fullt",-1,3),new r("löst",-1,2)],l=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,24,0,32],d=[119,127,149],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,t(),w.cursor=w.limit,i(),w.cursor=w.limit,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return t.setCurrent(e),t.stem(),t.getCurrent()}):(t.setCurrent(e),t.stem(),t.getCurrent())}}(),e.Pipeline.registerFunction(e.sv.stemmer,"stemmer-sv"),e.sv.stopWordFilter=e.generateStopWordFilter("alla allt att av blev bli blir blivit de dem den denna deras dess dessa det detta dig din dina ditt du där då efter ej eller en er era ert ett från för ha hade han hans har henne hennes hon honom hur här i icke ingen inom inte jag ju kan kunde man med mellan men mig min mina mitt mot mycket ni nu när någon något några och om oss på samma sedan sig sin sina sitta själv skulle som så sådan sådana sådant till under upp ut utan vad var vara varför varit varje vars vart vem vi vid vilka vilkas vilken vilket vår våra vårt än är åt över".split(" ")),e.Pipeline.registerFunction(e.sv.stopWordFilter,"stopWordFilter-sv")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.ta.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.ta.min.js
deleted file mode 100644
index a644bed22..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.ta.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ta=function(){this.pipeline.reset(),this.pipeline.add(e.ta.trimmer,e.ta.stopWordFilter,e.ta.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ta.stemmer))},e.ta.wordCharacters="஀-உஊ-ஏஐ-ஙச-ட஠-னப-யர-ஹ஺-ிீ-௉ொ-௏ௐ-௙௚-௟௠-௩௪-௯௰-௹௺-௿a-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.ta.trimmer=e.trimmerSupport.generateTrimmer(e.ta.wordCharacters),e.Pipeline.registerFunction(e.ta.trimmer,"trimmer-ta"),e.ta.stopWordFilter=e.generateStopWordFilter("அங்கு அங்கே அது அதை அந்த அவர் அவர்கள் அவள் அவன் அவை ஆக ஆகவே ஆகையால் ஆதலால் ஆதலினால் ஆனாலும் ஆனால் இங்கு இங்கே இது இதை இந்த இப்படி இவர் இவர்கள் இவள் இவன் இவை இவ்வளவு உனக்கு உனது உன் உன்னால் எங்கு எங்கே எது எதை எந்த எப்படி எவர் எவர்கள் எவள் எவன் எவை எவ்வளவு எனக்கு எனது எனவே என் என்ன என்னால் ஏது ஏன் தனது தன்னால் தானே தான் நாங்கள் நாம் நான் நீ நீங்கள்".split(" ")),e.ta.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var t=e.wordcut;t.init(),e.ta.tokenizer=function(r){if(!arguments.length||null==r||void 0==r)return[];if(Array.isArray(r))return r.map(function(t){return isLunr2?new e.Token(t.toLowerCase()):t.toLowerCase()});var i=r.toString().toLowerCase().replace(/^\s+/,"");return t.cut(i).split("|")},e.Pipeline.registerFunction(e.ta.stemmer,"stemmer-ta"),e.Pipeline.registerFunction(e.ta.stopWordFilter,"stopWordFilter-ta")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.te.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.te.min.js
deleted file mode 100644
index 9fa7a93b9..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.te.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.te=function(){this.pipeline.reset(),this.pipeline.add(e.te.trimmer,e.te.stopWordFilter,e.te.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.te.stemmer))},e.te.wordCharacters="ఀ-ఄఅ-ఔక-హా-ౌౕ-ౖౘ-ౚౠ-ౡౢ-ౣ౦-౯౸-౿఼ఽ్ౝ౷౤౥",e.te.trimmer=e.trimmerSupport.generateTrimmer(e.te.wordCharacters),e.Pipeline.registerFunction(e.te.trimmer,"trimmer-te"),e.te.stopWordFilter=e.generateStopWordFilter("అందరూ అందుబాటులో అడగండి అడగడం అడ్డంగా అనుగుణంగా అనుమతించు అనుమతిస్తుంది అయితే ఇప్పటికే ఉన్నారు ఎక్కడైనా ఎప్పుడు ఎవరైనా ఎవరో ఏ ఏదైనా ఏమైనప్పటికి ఒక ఒకరు కనిపిస్తాయి కాదు కూడా గా గురించి చుట్టూ చేయగలిగింది తగిన తర్వాత దాదాపు దూరంగా నిజంగా పై ప్రకారం ప్రక్కన మధ్య మరియు మరొక మళ్ళీ మాత్రమే మెచ్చుకో వద్ద వెంట వేరుగా వ్యతిరేకంగా సంబంధం".split(" ")),e.te.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var t=e.wordcut;t.init(),e.te.tokenizer=function(r){if(!arguments.length||null==r||void 0==r)return[];if(Array.isArray(r))return r.map(function(t){return isLunr2?new e.Token(t.toLowerCase()):t.toLowerCase()});var i=r.toString().toLowerCase().replace(/^\s+/,"");return t.cut(i).split("|")},e.Pipeline.registerFunction(e.te.stemmer,"stemmer-te"),e.Pipeline.registerFunction(e.te.stopWordFilter,"stopWordFilter-te")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.th.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.th.min.js
deleted file mode 100644
index dee3aac6e..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.th.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.th=function(){this.pipeline.reset(),this.pipeline.add(e.th.trimmer),r?this.tokenizer=e.th.tokenizer:(e.tokenizer&&(e.tokenizer=e.th.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.th.tokenizer))},e.th.wordCharacters="[฀-๿]",e.th.trimmer=e.trimmerSupport.generateTrimmer(e.th.wordCharacters),e.Pipeline.registerFunction(e.th.trimmer,"trimmer-th");var t=e.wordcut;t.init(),e.th.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t):t});var n=i.toString().replace(/^\s+/,"");return t.cut(n).split("|")}}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.tr.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.tr.min.js
deleted file mode 100644
index 563f6ec1f..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.tr.min.js
+++ /dev/null
@@ -1,18 +0,0 @@
-/*!
- * Lunr languages, `Turkish` language
- * https://github.com/MihaiValentin/lunr-languages
- *
- * Copyright 2014, Mihai Valentin
- * http://www.mozilla.org/MPL/
- */
-/*!
- * based on
- * Snowball JavaScript Library v0.3
- * http://code.google.com/p/urim/
- * http://snowball.tartarus.org/
- *
- * Copyright 2010, Oleg Mazko
- * http://www.mozilla.org/MPL/
- */
-
-!function(r,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(r.lunr)}(this,function(){return function(r){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");r.tr=function(){this.pipeline.reset(),this.pipeline.add(r.tr.trimmer,r.tr.stopWordFilter,r.tr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(r.tr.stemmer))},r.tr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",r.tr.trimmer=r.trimmerSupport.generateTrimmer(r.tr.wordCharacters),r.Pipeline.registerFunction(r.tr.trimmer,"trimmer-tr"),r.tr.stemmer=function(){var i=r.stemmerSupport.Among,e=r.stemmerSupport.SnowballProgram,n=new function(){function r(r,i,e){for(;;){var n=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(r,i,e)){Dr.cursor=Dr.limit-n;break}if(Dr.cursor=Dr.limit-n,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function n(){var i,e;i=Dr.limit-Dr.cursor,r(Wr,97,305);for(var n=0;n<Br.length;n++){e=Dr.limit-Dr.cursor;var t=Br[n];if(Dr.eq_s_b(1,t[0])&&r(t[1],t[2],t[3]))return Dr.cursor=Dr.limit-i,!0;Dr.cursor=Dr.limit-e}return Dr.cursor=Dr.limit-e,!(!Dr.eq_s_b(1,"ü")||!r(Zr,246,252))&&(Dr.cursor=Dr.limit-i,!0)}function t(r,i){var e,n=Dr.limit-Dr.cursor;return r()&&(Dr.cursor=Dr.limit-n,Dr.cursor>Dr.limit_backward&&(Dr.cursor--,e=Dr.limit-Dr.cursor,i()))?(Dr.cursor=Dr.limit-e,!0):(Dr.cursor=Dr.limit-n,r()?(Dr.cursor=Dr.limit-n,!1):(Dr.cursor=Dr.limit-n,!(Dr.cursor<=Dr.limit_backward)&&(Dr.cursor--,!!i()&&(Dr.cursor=Dr.limit-n,!0))))}function u(r){return t(r,function(){return Dr.in_grouping_b(Wr,97,305)})}function o(){return u(function(){return Dr.eq_s_b(1,"n")})}function s(){return u(function(){return Dr.eq_s_b(1,"s")})}function c(){return u(function(){return Dr.eq_s_b(1,"y")})}function l(){return t(function(){return Dr.in_grouping_b(Lr,105,305)},function(){return Dr.out_grouping_b(Wr,97,305)})}function a(){return Dr.find_among_b(ur,10)&&l()}function m(){return n()&&Dr.in_grouping_b(Lr,105,305)&&s()}function d(){return Dr.find_among_b(or,2)}function f(){return n()&&Dr.in_grouping_b(Lr,105,305)&&c()}function b(){return n()&&Dr.find_among_b(sr,4)}function w(){return n()&&Dr.find_among_b(cr,4)&&o()}function _(){return n()&&Dr.find_among_b(lr,2)&&c()}function k(){return n()&&Dr.find_among_b(ar,2)}function p(){return n()&&Dr.find_among_b(mr,4)}function g(){return n()&&Dr.find_among_b(dr,2)}function y(){return n()&&Dr.find_among_b(fr,4)}function z(){return n()&&Dr.find_among_b(br,2)}function v(){return n()&&Dr.find_among_b(wr,2)&&c()}function h(){return Dr.eq_s_b(2,"ki")}function q(){return n()&&Dr.find_among_b(_r,2)&&o()}function C(){return n()&&Dr.find_among_b(kr,4)&&c()}function P(){return n()&&Dr.find_among_b(pr,4)}function F(){return n()&&Dr.find_among_b(gr,4)&&c()}function S(){return Dr.find_among_b(yr,4)}function W(){return n()&&Dr.find_among_b(zr,2)}function L(){return n()&&Dr.find_among_b(vr,4)}function x(){return n()&&Dr.find_among_b(hr,8)}function A(){return Dr.find_among_b(qr,2)}function E(){return n()&&Dr.find_among_b(Cr,32)&&c()}function j(){return Dr.find_among_b(Pr,8)&&c()}function T(){return n()&&Dr.find_among_b(Fr,4)&&c()}function Z(){return Dr.eq_s_b(3,"ken")&&c()}function B(){var r=Dr.limit-Dr.cursor;return!(T()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,Z()))))}function D(){if(A()){var r=Dr.limit-Dr.cursor;if(S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T())return!1}return!0}function G(){if(W()){Dr.bra=Dr.cursor,Dr.slice_del();var r=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,x()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,T()||(Dr.cursor=Dr.limit-r)))),nr=!1,!1}return!0}function H(){if(!L())return!0;var r=Dr.limit-Dr.cursor;return!E()&&(Dr.cursor=Dr.limit-r,!j())}function I(){var r,i=Dr.limit-Dr.cursor;return!(S()||(Dr.cursor=Dr.limit-i,F()||(Dr.cursor=Dr.limit-i,P()||(Dr.cursor=Dr.limit-i,C()))))||(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,T()||(Dr.cursor=Dr.limit-r),!1)}function J(){var r,i=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,nr=!0,B()&&(Dr.cursor=Dr.limit-i,D()&&(Dr.cursor=Dr.limit-i,G()&&(Dr.cursor=Dr.limit-i,H()&&(Dr.cursor=Dr.limit-i,I()))))){if(Dr.cursor=Dr.limit-i,!x())return;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T()||(Dr.cursor=Dr.limit-r)}Dr.bra=Dr.cursor,Dr.slice_del()}function K(){var r,i,e,n;if(Dr.ket=Dr.cursor,h()){if(r=Dr.limit-Dr.cursor,p())return Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,a()&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))),!0;if(Dr.cursor=Dr.limit-r,w()){if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,e=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-e,!m()&&(Dr.cursor=Dr.limit-e,!K())))return!0;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}return!0}if(Dr.cursor=Dr.limit-r,g()){if(n=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-n,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-n,!K())return!1;return!0}}return!1}function M(r){if(Dr.ket=Dr.cursor,!g()&&(Dr.cursor=Dr.limit-r,!k()))return!1;var i=Dr.limit-Dr.cursor;if(d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-i,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-i,!K())return!1;return!0}function N(r){if(Dr.ket=Dr.cursor,!z()&&(Dr.cursor=Dr.limit-r,!b()))return!1;var i=Dr.limit-Dr.cursor;return!(!m()&&(Dr.cursor=Dr.limit-i,!d()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)}function O(){var r,i=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,!(!w()&&(Dr.cursor=Dr.limit-i,!v()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,!(!W()||(Dr.bra=Dr.cursor,Dr.slice_del(),!K()))||(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!(a()||(Dr.cursor=Dr.limit-r,m()||(Dr.cursor=Dr.limit-r,K())))||(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)))}function Q(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,!p()&&(Dr.cursor=Dr.limit-e,!f()&&(Dr.cursor=Dr.limit-e,!_())))return!1;if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,a())Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()||(Dr.cursor=Dr.limit-i);else if(Dr.cursor=Dr.limit-r,!W())return!0;return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,K(),!0}function R(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,W())return Dr.bra=Dr.cursor,Dr.slice_del(),void K();if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,q())if(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-r,!m())){if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!W())return;if(Dr.bra=Dr.cursor,Dr.slice_del(),!K())return}Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}else if(Dr.cursor=Dr.limit-e,!M(e)&&(Dr.cursor=Dr.limit-e,!N(e))){if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,y())return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,i=Dr.limit-Dr.cursor,void(a()?(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())):(Dr.cursor=Dr.limit-i,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,K())));if(Dr.cursor=Dr.limit-e,!O()){if(Dr.cursor=Dr.limit-e,d())return Dr.bra=Dr.cursor,void Dr.slice_del();Dr.cursor=Dr.limit-e,K()||(Dr.cursor=Dr.limit-e,Q()||(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,(a()||(Dr.cursor=Dr.limit-e,m()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))))}}}function U(){var r;if(Dr.ket=Dr.cursor,r=Dr.find_among_b(Sr,4))switch(Dr.bra=Dr.cursor,r){case 1:Dr.slice_from("p");break;case 2:Dr.slice_from("ç");break;case 3:Dr.slice_from("t");break;case 4:Dr.slice_from("k")}}function V(){for(;;){var r=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(Wr,97,305)){Dr.cursor=Dr.limit-r;break}if(Dr.cursor=Dr.limit-r,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function X(r,i,e){if(Dr.cursor=Dr.limit-r,V()){var n=Dr.limit-Dr.cursor;if(!Dr.eq_s_b(1,i)&&(Dr.cursor=Dr.limit-n,!Dr.eq_s_b(1,e)))return!0;Dr.cursor=Dr.limit-r;var t=Dr.cursor;return Dr.insert(Dr.cursor,Dr.cursor,e),Dr.cursor=t,!1}return!0}function Y(){var r=Dr.limit-Dr.cursor;(Dr.eq_s_b(1,"d")||(Dr.cursor=Dr.limit-r,Dr.eq_s_b(1,"g")))&&X(r,"a","ı")&&X(r,"e","i")&&X(r,"o","u")&&X(r,"ö","ü")}function $(){for(var r,i=Dr.cursor,e=2;;){for(r=Dr.cursor;!Dr.in_grouping(Wr,97,305);){if(Dr.cursor>=Dr.limit)return Dr.cursor=r,!(e>0)&&(Dr.cursor=i,!0);Dr.cursor++}e--}}function rr(r,i,e){for(;!Dr.eq_s(i,e);){if(Dr.cursor>=Dr.limit)return!0;Dr.cursor++}return(tr=i)!=Dr.limit||(Dr.cursor=r,!1)}function ir(){var r=Dr.cursor;return!rr(r,2,"ad")||(Dr.cursor=r,!rr(r,5,"soyad"))}function er(){var r=Dr.cursor;return!ir()&&(Dr.limit_backward=r,Dr.cursor=Dr.limit,Y(),Dr.cursor=Dr.limit,U(),!0)}var nr,tr,ur=[new i("m",-1,-1),new i("n",-1,-1),new i("miz",-1,-1),new i("niz",-1,-1),new i("muz",-1,-1),new i("nuz",-1,-1),new i("müz",-1,-1),new i("nüz",-1,-1),new i("mız",-1,-1),new i("nız",-1,-1)],or=[new i("leri",-1,-1),new i("ları",-1,-1)],sr=[new i("ni",-1,-1),new i("nu",-1,-1),new i("nü",-1,-1),new i("nı",-1,-1)],cr=[new i("in",-1,-1),new i("un",-1,-1),new i("ün",-1,-1),new i("ın",-1,-1)],lr=[new i("a",-1,-1),new i("e",-1,-1)],ar=[new i("na",-1,-1),new i("ne",-1,-1)],mr=[new i("da",-1,-1),new i("ta",-1,-1),new i("de",-1,-1),new i("te",-1,-1)],dr=[new i("nda",-1,-1),new i("nde",-1,-1)],fr=[new i("dan",-1,-1),new i("tan",-1,-1),new i("den",-1,-1),new i("ten",-1,-1)],br=[new i("ndan",-1,-1),new i("nden",-1,-1)],wr=[new i("la",-1,-1),new i("le",-1,-1)],_r=[new i("ca",-1,-1),new i("ce",-1,-1)],kr=[new i("im",-1,-1),new i("um",-1,-1),new i("üm",-1,-1),new i("ım",-1,-1)],pr=[new i("sin",-1,-1),new i("sun",-1,-1),new i("sün",-1,-1),new i("sın",-1,-1)],gr=[new i("iz",-1,-1),new i("uz",-1,-1),new i("üz",-1,-1),new i("ız",-1,-1)],yr=[new i("siniz",-1,-1),new i("sunuz",-1,-1),new i("sünüz",-1,-1),new i("sınız",-1,-1)],zr=[new i("lar",-1,-1),new i("ler",-1,-1)],vr=[new i("niz",-1,-1),new i("nuz",-1,-1),new i("nüz",-1,-1),new i("nız",-1,-1)],hr=[new i("dir",-1,-1),new i("tir",-1,-1),new i("dur",-1,-1),new i("tur",-1,-1),new i("dür",-1,-1),new i("tür",-1,-1),new i("dır",-1,-1),new i("tır",-1,-1)],qr=[new i("casına",-1,-1),new i("cesine",-1,-1)],Cr=[new i("di",-1,-1),new i("ti",-1,-1),new i("dik",-1,-1),new i("tik",-1,-1),new i("duk",-1,-1),new i("tuk",-1,-1),new i("dük",-1,-1),new i("tük",-1,-1),new i("dık",-1,-1),new i("tık",-1,-1),new i("dim",-1,-1),new i("tim",-1,-1),new i("dum",-1,-1),new i("tum",-1,-1),new i("düm",-1,-1),new i("tüm",-1,-1),new i("dım",-1,-1),new i("tım",-1,-1),new i("din",-1,-1),new i("tin",-1,-1),new i("dun",-1,-1),new i("tun",-1,-1),new i("dün",-1,-1),new i("tün",-1,-1),new i("dın",-1,-1),new i("tın",-1,-1),new i("du",-1,-1),new i("tu",-1,-1),new i("dü",-1,-1),new i("tü",-1,-1),new i("dı",-1,-1),new i("tı",-1,-1)],Pr=[new i("sa",-1,-1),new i("se",-1,-1),new i("sak",-1,-1),new i("sek",-1,-1),new i("sam",-1,-1),new i("sem",-1,-1),new i("san",-1,-1),new i("sen",-1,-1)],Fr=[new i("miş",-1,-1),new i("muş",-1,-1),new i("müş",-1,-1),new i("mış",-1,-1)],Sr=[new i("b",-1,1),new i("c",-1,2),new i("d",-1,3),new i("ğ",-1,4)],Wr=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,8,0,0,0,0,0,0,1],Lr=[1,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,0,0,0,0,0,1],xr=[1,64,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],Ar=[17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,130],Er=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],jr=[17],Tr=[65],Zr=[65],Br=[["a",xr,97,305],["e",Ar,101,252],["ı",Er,97,305],["i",jr,101,105],["o",Tr,111,117],["ö",Zr,246,252],["u",Tr,111,117]],Dr=new e;this.setCurrent=function(r){Dr.setCurrent(r)},this.getCurrent=function(){return Dr.getCurrent()},this.stem=function(){return!!($()&&(Dr.limit_backward=Dr.cursor,Dr.cursor=Dr.limit,J(),Dr.cursor=Dr.limit,nr&&(R(),Dr.cursor=Dr.limit_backward,er())))}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.tr.stemmer,"stemmer-tr"),r.tr.stopWordFilter=r.generateStopWordFilter("acaba altmış altı ama ancak arada aslında ayrıca bana bazı belki ben benden beni benim beri beş bile bin bir biri birkaç birkez birçok birşey birşeyi biz bizden bize bizi bizim bu buna bunda bundan bunlar bunları bunların bunu bunun burada böyle böylece da daha dahi de defa değil diye diğer doksan dokuz dolayı dolayısıyla dört edecek eden ederek edilecek ediliyor edilmesi ediyor elli en etmesi etti ettiği ettiğini eğer gibi göre halen hangi hatta hem henüz hep hepsi her herhangi herkesin hiç hiçbir iki ile ilgili ise itibaren itibariyle için işte kadar karşın katrilyon kendi kendilerine kendini kendisi kendisine kendisini kez ki kim kimden kime kimi kimse kırk milyar milyon mu mü mı nasıl ne neden nedenle nerde nerede nereye niye niçin o olan olarak oldu olduklarını olduğu olduğunu olmadı olmadığı olmak olması olmayan olmaz olsa olsun olup olur olursa oluyor on ona ondan onlar onlardan onları onların onu onun otuz oysa pek rağmen sadece sanki sekiz seksen sen senden seni senin siz sizden sizi sizin tarafından trilyon tüm var vardı ve veya ya yani yapacak yapmak yaptı yaptıkları yaptığı yaptığını yapılan yapılması yapıyor yedi yerine yetmiş yine yirmi yoksa yüz zaten çok çünkü öyle üzere üç şey şeyden şeyi şeyler şu şuna şunda şundan şunları şunu şöyle".split(" ")),r.Pipeline.registerFunction(r.tr.stopWordFilter,"stopWordFilter-tr")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.vi.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.vi.min.js
deleted file mode 100644
index 22aed28c4..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.vi.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.vi=function(){this.pipeline.reset(),this.pipeline.add(e.vi.stopWordFilter,e.vi.trimmer)},e.vi.wordCharacters="[A-Za-ẓ̀͐́͑̉̃̓ÂâÊêÔôĂ-ăĐ-đƠ-ơƯ-ư]",e.vi.trimmer=e.trimmerSupport.generateTrimmer(e.vi.wordCharacters),e.Pipeline.registerFunction(e.vi.trimmer,"trimmer-vi"),e.vi.stopWordFilter=e.generateStopWordFilter("là cái nhưng mà".split(" "))}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/min/lunr.zh.min.js b/0.10.0/assets/javascripts/lunr/min/lunr.zh.min.js
deleted file mode 100644
index fda66e9c5..000000000
--- a/0.10.0/assets/javascripts/lunr/min/lunr.zh.min.js
+++ /dev/null
@@ -1 +0,0 @@
-!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r(require("@node-rs/jieba")):r()(e.lunr)}(this,function(e){return function(r,t){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var i="2"==r.version[0];r.zh=function(){this.pipeline.reset(),this.pipeline.add(r.zh.trimmer,r.zh.stopWordFilter,r.zh.stemmer),i?this.tokenizer=r.zh.tokenizer:(r.tokenizer&&(r.tokenizer=r.zh.tokenizer),this.tokenizerFn&&(this.tokenizerFn=r.zh.tokenizer))},r.zh.tokenizer=function(n){if(!arguments.length||null==n||void 0==n)return[];if(Array.isArray(n))return n.map(function(e){return i?new r.Token(e.toLowerCase()):e.toLowerCase()});t&&e.load(t);var o=n.toString().trim().toLowerCase(),s=[];e.cut(o,!0).forEach(function(e){s=s.concat(e.split(" "))}),s=s.filter(function(e){return!!e});var u=0;return s.map(function(e,t){if(i){var n=o.indexOf(e,u),s={};return s.position=[n,e.length],s.index=t,u=n,new r.Token(e,s)}return e})},r.zh.wordCharacters="\\w一-龥",r.zh.trimmer=r.trimmerSupport.generateTrimmer(r.zh.wordCharacters),r.Pipeline.registerFunction(r.zh.trimmer,"trimmer-zh"),r.zh.stemmer=function(){return function(e){return e}}(),r.Pipeline.registerFunction(r.zh.stemmer,"stemmer-zh"),r.zh.stopWordFilter=r.generateStopWordFilter("的 一 不 在 人 有 是 为 為 以 于 於 上 他 而 后 後 之 来 來 及 了 因 下 可 到 由 这 這 与 與 也 此 但 并 並 个 個 其 已 无 無 小 我 们 們 起 最 再 今 去 好 只 又 或 很 亦 某 把 那 你 乃 它 吧 被 比 别 趁 当 當 从 從 得 打 凡 儿 兒 尔 爾 该 該 各 给 給 跟 和 何 还 還 即 几 幾 既 看 据 據 距 靠 啦 另 么 麽 每 嘛 拿 哪 您 凭 憑 且 却 卻 让 讓 仍 啥 如 若 使 谁 誰 虽 雖 随 隨 同 所 她 哇 嗡 往 些 向 沿 哟 喲 用 咱 则 則 怎 曾 至 致 着 著 诸 諸 自".split(" ")),r.Pipeline.registerFunction(r.zh.stopWordFilter,"stopWordFilter-zh")}});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/tinyseg.js b/0.10.0/assets/javascripts/lunr/tinyseg.js
deleted file mode 100644
index 167fa6dd6..000000000
--- a/0.10.0/assets/javascripts/lunr/tinyseg.js
+++ /dev/null
@@ -1,206 +0,0 @@
-/**
- * export the module via AMD, CommonJS or as a browser global
- * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js
- */
-;(function (root, factory) {
-    if (typeof define === 'function' && define.amd) {
-        // AMD. Register as an anonymous module.
-        define(factory)
-    } else if (typeof exports === 'object') {
-        /**
-         * Node. Does not work with strict CommonJS, but
-         * only CommonJS-like environments that support module.exports,
-         * like Node.
-         */
-        module.exports = factory()
-    } else {
-        // Browser globals (root is window)
-        factory()(root.lunr);
-    }
-}(this, function () {
-    /**
-     * Just return a value to define the module export.
-     * This example returns an object, but the module
-     * can return a function as the exported value.
-     */
-
-    return function(lunr) {
-        // TinySegmenter 0.1 -- Super compact Japanese tokenizer in Javascript
-        // (c) 2008 Taku Kudo <taku@chasen.org>
-        // TinySegmenter is freely distributable under the terms of a new BSD licence.
-        // For details, see http://chasen.org/~taku/software/TinySegmenter/LICENCE.txt
-
-        function TinySegmenter() {
-          var patterns = {
-            "[一二三四五六七八九十百千万億兆]":"M",
-            "[一-龠々〆ヵヶ]":"H",
-            "[ぁ-ん]":"I",
-            "[ァ-ヴーｱ-ﾝﾞｰ]":"K",
-            "[a-zA-Zａ-ｚＡ-Ｚ]":"A",
-            "[0-9０-９]":"N"
-          }
-          this.chartype_ = [];
-          for (var i in patterns) {
-            var regexp = new RegExp(i);
-            this.chartype_.push([regexp, patterns[i]]);
-          }
-
-          this.BIAS__ = -332
-          this.BC1__ = {"HH":6,"II":2461,"KH":406,"OH":-1378};
-          this.BC2__ = {"AA":-3267,"AI":2744,"AN":-878,"HH":-4070,"HM":-1711,"HN":4012,"HO":3761,"IA":1327,"IH":-1184,"II":-1332,"IK":1721,"IO":5492,"KI":3831,"KK":-8741,"MH":-3132,"MK":3334,"OO":-2920};
-          this.BC3__ = {"HH":996,"HI":626,"HK":-721,"HN":-1307,"HO":-836,"IH":-301,"KK":2762,"MK":1079,"MM":4034,"OA":-1652,"OH":266};
-          this.BP1__ = {"BB":295,"OB":304,"OO":-125,"UB":352};
-          this.BP2__ = {"BO":60,"OO":-1762};
-          this.BQ1__ = {"BHH":1150,"BHM":1521,"BII":-1158,"BIM":886,"BMH":1208,"BNH":449,"BOH":-91,"BOO":-2597,"OHI":451,"OIH":-296,"OKA":1851,"OKH":-1020,"OKK":904,"OOO":2965};
-          this.BQ2__ = {"BHH":118,"BHI":-1159,"BHM":466,"BIH":-919,"BKK":-1720,"BKO":864,"OHH":-1139,"OHM":-181,"OIH":153,"UHI":-1146};
-          this.BQ3__ = {"BHH":-792,"BHI":2664,"BII":-299,"BKI":419,"BMH":937,"BMM":8335,"BNN":998,"BOH":775,"OHH":2174,"OHM":439,"OII":280,"OKH":1798,"OKI":-793,"OKO":-2242,"OMH":-2402,"OOO":11699};
-          this.BQ4__ = {"BHH":-3895,"BIH":3761,"BII":-4654,"BIK":1348,"BKK":-1806,"BMI":-3385,"BOO":-12396,"OAH":926,"OHH":266,"OHK":-2036,"ONN":-973};
-          this.BW1__ = {",と":660,",同":727,"B1あ":1404,"B1同":542,"、と":660,"、同":727,"」と":1682,"あっ":1505,"いう":1743,"いっ":-2055,"いる":672,"うし":-4817,"うん":665,"から":3472,"がら":600,"こう":-790,"こと":2083,"こん":-1262,"さら":-4143,"さん":4573,"した":2641,"して":1104,"すで":-3399,"そこ":1977,"それ":-871,"たち":1122,"ため":601,"った":3463,"つい":-802,"てい":805,"てき":1249,"でき":1127,"です":3445,"では":844,"とい":-4915,"とみ":1922,"どこ":3887,"ない":5713,"なっ":3015,"など":7379,"なん":-1113,"にし":2468,"には":1498,"にも":1671,"に対":-912,"の一":-501,"の中":741,"ませ":2448,"まで":1711,"まま":2600,"まる":-2155,"やむ":-1947,"よっ":-2565,"れた":2369,"れで":-913,"をし":1860,"を見":731,"亡く":-1886,"京都":2558,"取り":-2784,"大き":-2604,"大阪":1497,"平方":-2314,"引き":-1336,"日本":-195,"本当":-2423,"毎日":-2113,"目指":-724,"Ｂ１あ":1404,"Ｂ１同":542,"｣と":1682};
-          this.BW2__ = {"..":-11822,"11":-669,"――":-5730,"−−":-13175,"いう":-1609,"うか":2490,"かし":-1350,"かも":-602,"から":-7194,"かれ":4612,"がい":853,"がら":-3198,"きた":1941,"くな":-1597,"こと":-8392,"この":-4193,"させ":4533,"され":13168,"さん":-3977,"しい":-1819,"しか":-545,"した":5078,"して":972,"しな":939,"その":-3744,"たい":-1253,"たた":-662,"ただ":-3857,"たち":-786,"たと":1224,"たは":-939,"った":4589,"って":1647,"っと":-2094,"てい":6144,"てき":3640,"てく":2551,"ては":-3110,"ても":-3065,"でい":2666,"でき":-1528,"でし":-3828,"です":-4761,"でも":-4203,"とい":1890,"とこ":-1746,"とと":-2279,"との":720,"とみ":5168,"とも":-3941,"ない":-2488,"なが":-1313,"など":-6509,"なの":2614,"なん":3099,"にお":-1615,"にし":2748,"にな":2454,"によ":-7236,"に対":-14943,"に従":-4688,"に関":-11388,"のか":2093,"ので":-7059,"のに":-6041,"のの":-6125,"はい":1073,"はが":-1033,"はず":-2532,"ばれ":1813,"まし":-1316,"まで":-6621,"まれ":5409,"めて":-3153,"もい":2230,"もの":-10713,"らか":-944,"らし":-1611,"らに":-1897,"りし":651,"りま":1620,"れた":4270,"れて":849,"れば":4114,"ろう":6067,"われ":7901,"を通":-11877,"んだ":728,"んな":-4115,"一人":602,"一方":-1375,"一日":970,"一部":-1051,"上が":-4479,"会社":-1116,"出て":2163,"分の":-7758,"同党":970,"同日":-913,"大阪":-2471,"委員":-1250,"少な":-1050,"年度":-8669,"年間":-1626,"府県":-2363,"手権":-1982,"新聞":-4066,"日新":-722,"日本":-7068,"日米":3372,"曜日":-601,"朝鮮":-2355,"本人":-2697,"東京":-1543,"然と":-1384,"社会":-1276,"立て":-990,"第に":-1612,"米国":-4268,"１１":-669};
-          this.BW3__ = {"あた":-2194,"あり":719,"ある":3846,"い.":-1185,"い。":-1185,"いい":5308,"いえ":2079,"いく":3029,"いた":2056,"いっ":1883,"いる":5600,"いわ":1527,"うち":1117,"うと":4798,"えと":1454,"か.":2857,"か。":2857,"かけ":-743,"かっ":-4098,"かに":-669,"から":6520,"かり":-2670,"が,":1816,"が、":1816,"がき":-4855,"がけ":-1127,"がっ":-913,"がら":-4977,"がり":-2064,"きた":1645,"けど":1374,"こと":7397,"この":1542,"ころ":-2757,"さい":-714,"さを":976,"し,":1557,"し、":1557,"しい":-3714,"した":3562,"して":1449,"しな":2608,"しま":1200,"す.":-1310,"す。":-1310,"する":6521,"ず,":3426,"ず、":3426,"ずに":841,"そう":428,"た.":8875,"た。":8875,"たい":-594,"たの":812,"たり":-1183,"たる":-853,"だ.":4098,"だ。":4098,"だっ":1004,"った":-4748,"って":300,"てい":6240,"てお":855,"ても":302,"です":1437,"でに":-1482,"では":2295,"とう":-1387,"とし":2266,"との":541,"とも":-3543,"どう":4664,"ない":1796,"なく":-903,"など":2135,"に,":-1021,"に、":-1021,"にし":1771,"にな":1906,"には":2644,"の,":-724,"の、":-724,"の子":-1000,"は,":1337,"は、":1337,"べき":2181,"まし":1113,"ます":6943,"まっ":-1549,"まで":6154,"まれ":-793,"らし":1479,"られ":6820,"るる":3818,"れ,":854,"れ、":854,"れた":1850,"れて":1375,"れば":-3246,"れる":1091,"われ":-605,"んだ":606,"んで":798,"カ月":990,"会議":860,"入り":1232,"大会":2217,"始め":1681,"市":965,"新聞":-5055,"日,":974,"日、":974,"社会":2024,"ｶ月":990};
-          this.TC1__ = {"AAA":1093,"HHH":1029,"HHM":580,"HII":998,"HOH":-390,"HOM":-331,"IHI":1169,"IOH":-142,"IOI":-1015,"IOM":467,"MMH":187,"OOI":-1832};
-          this.TC2__ = {"HHO":2088,"HII":-1023,"HMM":-1154,"IHI":-1965,"KKH":703,"OII":-2649};
-          this.TC3__ = {"AAA":-294,"HHH":346,"HHI":-341,"HII":-1088,"HIK":731,"HOH":-1486,"IHH":128,"IHI":-3041,"IHO":-1935,"IIH":-825,"IIM":-1035,"IOI":-542,"KHH":-1216,"KKA":491,"KKH":-1217,"KOK":-1009,"MHH":-2694,"MHM":-457,"MHO":123,"MMH":-471,"NNH":-1689,"NNO":662,"OHO":-3393};
-          this.TC4__ = {"HHH":-203,"HHI":1344,"HHK":365,"HHM":-122,"HHN":182,"HHO":669,"HIH":804,"HII":679,"HOH":446,"IHH":695,"IHO":-2324,"IIH":321,"III":1497,"IIO":656,"IOO":54,"KAK":4845,"KKA":3386,"KKK":3065,"MHH":-405,"MHI":201,"MMH":-241,"MMM":661,"MOM":841};
-          this.TQ1__ = {"BHHH":-227,"BHHI":316,"BHIH":-132,"BIHH":60,"BIII":1595,"BNHH":-744,"BOHH":225,"BOOO":-908,"OAKK":482,"OHHH":281,"OHIH":249,"OIHI":200,"OIIH":-68};
-          this.TQ2__ = {"BIHH":-1401,"BIII":-1033,"BKAK":-543,"BOOO":-5591};
-          this.TQ3__ = {"BHHH":478,"BHHM":-1073,"BHIH":222,"BHII":-504,"BIIH":-116,"BIII":-105,"BMHI":-863,"BMHM":-464,"BOMH":620,"OHHH":346,"OHHI":1729,"OHII":997,"OHMH":481,"OIHH":623,"OIIH":1344,"OKAK":2792,"OKHH":587,"OKKA":679,"OOHH":110,"OOII":-685};
-          this.TQ4__ = {"BHHH":-721,"BHHM":-3604,"BHII":-966,"BIIH":-607,"BIII":-2181,"OAAA":-2763,"OAKK":180,"OHHH":-294,"OHHI":2446,"OHHO":480,"OHIH":-1573,"OIHH":1935,"OIHI":-493,"OIIH":626,"OIII":-4007,"OKAK":-8156};
-          this.TW1__ = {"につい":-4681,"東京都":2026};
-          this.TW2__ = {"ある程":-2049,"いった":-1256,"ころが":-2434,"しょう":3873,"その後":-4430,"だって":-1049,"ていた":1833,"として":-4657,"ともに":-4517,"もので":1882,"一気に":-792,"初めて":-1512,"同時に":-8097,"大きな":-1255,"対して":-2721,"社会党":-3216};
-          this.TW3__ = {"いただ":-1734,"してい":1314,"として":-4314,"につい":-5483,"にとっ":-5989,"に当た":-6247,"ので,":-727,"ので、":-727,"のもの":-600,"れから":-3752,"十二月":-2287};
-          this.TW4__ = {"いう.":8576,"いう。":8576,"からな":-2348,"してい":2958,"たが,":1516,"たが、":1516,"ている":1538,"という":1349,"ました":5543,"ません":1097,"ようと":-4258,"よると":5865};
-          this.UC1__ = {"A":484,"K":93,"M":645,"O":-505};
-          this.UC2__ = {"A":819,"H":1059,"I":409,"M":3987,"N":5775,"O":646};
-          this.UC3__ = {"A":-1370,"I":2311};
-          this.UC4__ = {"A":-2643,"H":1809,"I":-1032,"K":-3450,"M":3565,"N":3876,"O":6646};
-          this.UC5__ = {"H":313,"I":-1238,"K":-799,"M":539,"O":-831};
-          this.UC6__ = {"H":-506,"I":-253,"K":87,"M":247,"O":-387};
-          this.UP1__ = {"O":-214};
-          this.UP2__ = {"B":69,"O":935};
-          this.UP3__ = {"B":189};
-          this.UQ1__ = {"BH":21,"BI":-12,"BK":-99,"BN":142,"BO":-56,"OH":-95,"OI":477,"OK":410,"OO":-2422};
-          this.UQ2__ = {"BH":216,"BI":113,"OK":1759};
-          this.UQ3__ = {"BA":-479,"BH":42,"BI":1913,"BK":-7198,"BM":3160,"BN":6427,"BO":14761,"OI":-827,"ON":-3212};
-          this.UW1__ = {",":156,"、":156,"「":-463,"あ":-941,"う":-127,"が":-553,"き":121,"こ":505,"で":-201,"と":-547,"ど":-123,"に":-789,"の":-185,"は":-847,"も":-466,"や":-470,"よ":182,"ら":-292,"り":208,"れ":169,"を":-446,"ん":-137,"・":-135,"主":-402,"京":-268,"区":-912,"午":871,"国":-460,"大":561,"委":729,"市":-411,"日":-141,"理":361,"生":-408,"県":-386,"都":-718,"｢":-463,"･":-135};
-          this.UW2__ = {",":-829,"、":-829,"〇":892,"「":-645,"」":3145,"あ":-538,"い":505,"う":134,"お":-502,"か":1454,"が":-856,"く":-412,"こ":1141,"さ":878,"ざ":540,"し":1529,"す":-675,"せ":300,"そ":-1011,"た":188,"だ":1837,"つ":-949,"て":-291,"で":-268,"と":-981,"ど":1273,"な":1063,"に":-1764,"の":130,"は":-409,"ひ":-1273,"べ":1261,"ま":600,"も":-1263,"や":-402,"よ":1639,"り":-579,"る":-694,"れ":571,"を":-2516,"ん":2095,"ア":-587,"カ":306,"キ":568,"ッ":831,"三":-758,"不":-2150,"世":-302,"中":-968,"主":-861,"事":492,"人":-123,"会":978,"保":362,"入":548,"初":-3025,"副":-1566,"北":-3414,"区":-422,"大":-1769,"天":-865,"太":-483,"子":-1519,"学":760,"実":1023,"小":-2009,"市":-813,"年":-1060,"強":1067,"手":-1519,"揺":-1033,"政":1522,"文":-1355,"新":-1682,"日":-1815,"明":-1462,"最":-630,"朝":-1843,"本":-1650,"東":-931,"果":-665,"次":-2378,"民":-180,"気":-1740,"理":752,"発":529,"目":-1584,"相":-242,"県":-1165,"立":-763,"第":810,"米":509,"自":-1353,"行":838,"西":-744,"見":-3874,"調":1010,"議":1198,"込":3041,"開":1758,"間":-1257,"｢":-645,"｣":3145,"ｯ":831,"ｱ":-587,"ｶ":306,"ｷ":568};
-          this.UW3__ = {",":4889,"1":-800,"−":-1723,"、":4889,"々":-2311,"〇":5827,"」":2670,"〓":-3573,"あ":-2696,"い":1006,"う":2342,"え":1983,"お":-4864,"か":-1163,"が":3271,"く":1004,"け":388,"げ":401,"こ":-3552,"ご":-3116,"さ":-1058,"し":-395,"す":584,"せ":3685,"そ":-5228,"た":842,"ち":-521,"っ":-1444,"つ":-1081,"て":6167,"で":2318,"と":1691,"ど":-899,"な":-2788,"に":2745,"の":4056,"は":4555,"ひ":-2171,"ふ":-1798,"へ":1199,"ほ":-5516,"ま":-4384,"み":-120,"め":1205,"も":2323,"や":-788,"よ":-202,"ら":727,"り":649,"る":5905,"れ":2773,"わ":-1207,"を":6620,"ん":-518,"ア":551,"グ":1319,"ス":874,"ッ":-1350,"ト":521,"ム":1109,"ル":1591,"ロ":2201,"ン":278,"・":-3794,"一":-1619,"下":-1759,"世":-2087,"両":3815,"中":653,"主":-758,"予":-1193,"二":974,"人":2742,"今":792,"他":1889,"以":-1368,"低":811,"何":4265,"作":-361,"保":-2439,"元":4858,"党":3593,"全":1574,"公":-3030,"六":755,"共":-1880,"円":5807,"再":3095,"分":457,"初":2475,"別":1129,"前":2286,"副":4437,"力":365,"動":-949,"務":-1872,"化":1327,"北":-1038,"区":4646,"千":-2309,"午":-783,"協":-1006,"口":483,"右":1233,"各":3588,"合":-241,"同":3906,"和":-837,"員":4513,"国":642,"型":1389,"場":1219,"外":-241,"妻":2016,"学":-1356,"安":-423,"実":-1008,"家":1078,"小":-513,"少":-3102,"州":1155,"市":3197,"平":-1804,"年":2416,"広":-1030,"府":1605,"度":1452,"建":-2352,"当":-3885,"得":1905,"思":-1291,"性":1822,"戸":-488,"指":-3973,"政":-2013,"教":-1479,"数":3222,"文":-1489,"新":1764,"日":2099,"旧":5792,"昨":-661,"時":-1248,"曜":-951,"最":-937,"月":4125,"期":360,"李":3094,"村":364,"東":-805,"核":5156,"森":2438,"業":484,"氏":2613,"民":-1694,"決":-1073,"法":1868,"海":-495,"無":979,"物":461,"特":-3850,"生":-273,"用":914,"町":1215,"的":7313,"直":-1835,"省":792,"県":6293,"知":-1528,"私":4231,"税":401,"立":-960,"第":1201,"米":7767,"系":3066,"約":3663,"級":1384,"統":-4229,"総":1163,"線":1255,"者":6457,"能":725,"自":-2869,"英":785,"見":1044,"調":-562,"財":-733,"費":1777,"車":1835,"軍":1375,"込":-1504,"通":-1136,"選":-681,"郎":1026,"郡":4404,"部":1200,"金":2163,"長":421,"開":-1432,"間":1302,"関":-1282,"雨":2009,"電":-1045,"非":2066,"駅":1620,"１":-800,"｣":2670,"･":-3794,"ｯ":-1350,"ｱ":551,"ｸﾞ":1319,"ｽ":874,"ﾄ":521,"ﾑ":1109,"ﾙ":1591,"ﾛ":2201,"ﾝ":278};
-          this.UW4__ = {",":3930,".":3508,"―":-4841,"、":3930,"。":3508,"〇":4999,"「":1895,"」":3798,"〓":-5156,"あ":4752,"い":-3435,"う":-640,"え":-2514,"お":2405,"か":530,"が":6006,"き":-4482,"ぎ":-3821,"く":-3788,"け":-4376,"げ":-4734,"こ":2255,"ご":1979,"さ":2864,"し":-843,"じ":-2506,"す":-731,"ず":1251,"せ":181,"そ":4091,"た":5034,"だ":5408,"ち":-3654,"っ":-5882,"つ":-1659,"て":3994,"で":7410,"と":4547,"な":5433,"に":6499,"ぬ":1853,"ね":1413,"の":7396,"は":8578,"ば":1940,"ひ":4249,"び":-4134,"ふ":1345,"へ":6665,"べ":-744,"ほ":1464,"ま":1051,"み":-2082,"む":-882,"め":-5046,"も":4169,"ゃ":-2666,"や":2795,"ょ":-1544,"よ":3351,"ら":-2922,"り":-9726,"る":-14896,"れ":-2613,"ろ":-4570,"わ":-1783,"を":13150,"ん":-2352,"カ":2145,"コ":1789,"セ":1287,"ッ":-724,"ト":-403,"メ":-1635,"ラ":-881,"リ":-541,"ル":-856,"ン":-3637,"・":-4371,"ー":-11870,"一":-2069,"中":2210,"予":782,"事":-190,"井":-1768,"人":1036,"以":544,"会":950,"体":-1286,"作":530,"側":4292,"先":601,"党":-2006,"共":-1212,"内":584,"円":788,"初":1347,"前":1623,"副":3879,"力":-302,"動":-740,"務":-2715,"化":776,"区":4517,"協":1013,"参":1555,"合":-1834,"和":-681,"員":-910,"器":-851,"回":1500,"国":-619,"園":-1200,"地":866,"場":-1410,"塁":-2094,"士":-1413,"多":1067,"大":571,"子":-4802,"学":-1397,"定":-1057,"寺":-809,"小":1910,"屋":-1328,"山":-1500,"島":-2056,"川":-2667,"市":2771,"年":374,"庁":-4556,"後":456,"性":553,"感":916,"所":-1566,"支":856,"改":787,"政":2182,"教":704,"文":522,"方":-856,"日":1798,"時":1829,"最":845,"月":-9066,"木":-485,"来":-442,"校":-360,"業":-1043,"氏":5388,"民":-2716,"気":-910,"沢":-939,"済":-543,"物":-735,"率":672,"球":-1267,"生":-1286,"産":-1101,"田":-2900,"町":1826,"的":2586,"目":922,"省":-3485,"県":2997,"空":-867,"立":-2112,"第":788,"米":2937,"系":786,"約":2171,"経":1146,"統":-1169,"総":940,"線":-994,"署":749,"者":2145,"能":-730,"般":-852,"行":-792,"規":792,"警":-1184,"議":-244,"谷":-1000,"賞":730,"車":-1481,"軍":1158,"輪":-1433,"込":-3370,"近":929,"道":-1291,"選":2596,"郎":-4866,"都":1192,"野":-1100,"銀":-2213,"長":357,"間":-2344,"院":-2297,"際":-2604,"電":-878,"領":-1659,"題":-792,"館":-1984,"首":1749,"高":2120,"｢":1895,"｣":3798,"･":-4371,"ｯ":-724,"ｰ":-11870,"ｶ":2145,"ｺ":1789,"ｾ":1287,"ﾄ":-403,"ﾒ":-1635,"ﾗ":-881,"ﾘ":-541,"ﾙ":-856,"ﾝ":-3637};
-          this.UW5__ = {",":465,".":-299,"1":-514,"E2":-32768,"]":-2762,"、":465,"。":-299,"「":363,"あ":1655,"い":331,"う":-503,"え":1199,"お":527,"か":647,"が":-421,"き":1624,"ぎ":1971,"く":312,"げ":-983,"さ":-1537,"し":-1371,"す":-852,"だ":-1186,"ち":1093,"っ":52,"つ":921,"て":-18,"で":-850,"と":-127,"ど":1682,"な":-787,"に":-1224,"の":-635,"は":-578,"べ":1001,"み":502,"め":865,"ゃ":3350,"ょ":854,"り":-208,"る":429,"れ":504,"わ":419,"を":-1264,"ん":327,"イ":241,"ル":451,"ン":-343,"中":-871,"京":722,"会":-1153,"党":-654,"務":3519,"区":-901,"告":848,"員":2104,"大":-1296,"学":-548,"定":1785,"嵐":-1304,"市":-2991,"席":921,"年":1763,"思":872,"所":-814,"挙":1618,"新":-1682,"日":218,"月":-4353,"査":932,"格":1356,"機":-1508,"氏":-1347,"田":240,"町":-3912,"的":-3149,"相":1319,"省":-1052,"県":-4003,"研":-997,"社":-278,"空":-813,"統":1955,"者":-2233,"表":663,"語":-1073,"議":1219,"選":-1018,"郎":-368,"長":786,"間":1191,"題":2368,"館":-689,"１":-514,"Ｅ２":-32768,"｢":363,"ｲ":241,"ﾙ":451,"ﾝ":-343};
-          this.UW6__ = {",":227,".":808,"1":-270,"E1":306,"、":227,"。":808,"あ":-307,"う":189,"か":241,"が":-73,"く":-121,"こ":-200,"じ":1782,"す":383,"た":-428,"っ":573,"て":-1014,"で":101,"と":-105,"な":-253,"に":-149,"の":-417,"は":-236,"も":-206,"り":187,"る":-135,"を":195,"ル":-673,"ン":-496,"一":-277,"中":201,"件":-800,"会":624,"前":302,"区":1792,"員":-1212,"委":798,"学":-960,"市":887,"広":-695,"後":535,"業":-697,"相":753,"社":-507,"福":974,"空":-822,"者":1811,"連":463,"郎":1082,"１":-270,"Ｅ１":306,"ﾙ":-673,"ﾝ":-496};
-          
-          return this;
-        }
-        TinySegmenter.prototype.ctype_ = function(str) {
-          for (var i in this.chartype_) {
-            if (str.match(this.chartype_[i][0])) {
-              return this.chartype_[i][1];
-            }
-          }
-          return "O";
-        }
-
-        TinySegmenter.prototype.ts_ = function(v) {
-          if (v) { return v; }
-          return 0;
-        }
-
-        TinySegmenter.prototype.segment = function(input) {
-          if (input == null || input == undefined || input == "") {
-            return [];
-          }
-          var result = [];
-          var seg = ["B3","B2","B1"];
-          var ctype = ["O","O","O"];
-          var o = input.split("");
-          for (i = 0; i < o.length; ++i) {
-            seg.push(o[i]);
-            ctype.push(this.ctype_(o[i]))
-          }
-          seg.push("E1");
-          seg.push("E2");
-          seg.push("E3");
-          ctype.push("O");
-          ctype.push("O");
-          ctype.push("O");
-          var word = seg[3];
-          var p1 = "U";
-          var p2 = "U";
-          var p3 = "U";
-          for (var i = 4; i < seg.length - 3; ++i) {
-            var score = this.BIAS__;
-            var w1 = seg[i-3];
-            var w2 = seg[i-2];
-            var w3 = seg[i-1];
-            var w4 = seg[i];
-            var w5 = seg[i+1];
-            var w6 = seg[i+2];
-            var c1 = ctype[i-3];
-            var c2 = ctype[i-2];
-            var c3 = ctype[i-1];
-            var c4 = ctype[i];
-            var c5 = ctype[i+1];
-            var c6 = ctype[i+2];
-            score += this.ts_(this.UP1__[p1]);
-            score += this.ts_(this.UP2__[p2]);
-            score += this.ts_(this.UP3__[p3]);
-            score += this.ts_(this.BP1__[p1 + p2]);
-            score += this.ts_(this.BP2__[p2 + p3]);
-            score += this.ts_(this.UW1__[w1]);
-            score += this.ts_(this.UW2__[w2]);
-            score += this.ts_(this.UW3__[w3]);
-            score += this.ts_(this.UW4__[w4]);
-            score += this.ts_(this.UW5__[w5]);
-            score += this.ts_(this.UW6__[w6]);
-            score += this.ts_(this.BW1__[w2 + w3]);
-            score += this.ts_(this.BW2__[w3 + w4]);
-            score += this.ts_(this.BW3__[w4 + w5]);
-            score += this.ts_(this.TW1__[w1 + w2 + w3]);
-            score += this.ts_(this.TW2__[w2 + w3 + w4]);
-            score += this.ts_(this.TW3__[w3 + w4 + w5]);
-            score += this.ts_(this.TW4__[w4 + w5 + w6]);
-            score += this.ts_(this.UC1__[c1]);
-            score += this.ts_(this.UC2__[c2]);
-            score += this.ts_(this.UC3__[c3]);
-            score += this.ts_(this.UC4__[c4]);
-            score += this.ts_(this.UC5__[c5]);
-            score += this.ts_(this.UC6__[c6]);
-            score += this.ts_(this.BC1__[c2 + c3]);
-            score += this.ts_(this.BC2__[c3 + c4]);
-            score += this.ts_(this.BC3__[c4 + c5]);
-            score += this.ts_(this.TC1__[c1 + c2 + c3]);
-            score += this.ts_(this.TC2__[c2 + c3 + c4]);
-            score += this.ts_(this.TC3__[c3 + c4 + c5]);
-            score += this.ts_(this.TC4__[c4 + c5 + c6]);
-        //  score += this.ts_(this.TC5__[c4 + c5 + c6]);    
-            score += this.ts_(this.UQ1__[p1 + c1]);
-            score += this.ts_(this.UQ2__[p2 + c2]);
-            score += this.ts_(this.UQ3__[p3 + c3]);
-            score += this.ts_(this.BQ1__[p2 + c2 + c3]);
-            score += this.ts_(this.BQ2__[p2 + c3 + c4]);
-            score += this.ts_(this.BQ3__[p3 + c2 + c3]);
-            score += this.ts_(this.BQ4__[p3 + c3 + c4]);
-            score += this.ts_(this.TQ1__[p2 + c1 + c2 + c3]);
-            score += this.ts_(this.TQ2__[p2 + c2 + c3 + c4]);
-            score += this.ts_(this.TQ3__[p3 + c1 + c2 + c3]);
-            score += this.ts_(this.TQ4__[p3 + c2 + c3 + c4]);
-            var p = "O";
-            if (score > 0) {
-              result.push(word);
-              word = "";
-              p = "B";
-            }
-            p1 = p2;
-            p2 = p3;
-            p3 = p;
-            word += seg[i];
-          }
-          result.push(word);
-
-          return result;
-        }
-
-        lunr.TinySegmenter = TinySegmenter;
-    };
-
-}));
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/lunr/wordcut.js b/0.10.0/assets/javascripts/lunr/wordcut.js
deleted file mode 100644
index 0d898c9ed..000000000
--- a/0.10.0/assets/javascripts/lunr/wordcut.js
+++ /dev/null
@@ -1,6708 +0,0 @@
-(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}(g.lunr || (g.lunr = {})).wordcut = f()}})(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
-var _ = require("underscore");
-
-var Acceptors = {
-  creators: null,
-  current: null,
-  tag: null,
-
-  init: function() {
-    this.creators = [];
-    this.current = [];
-    this.tag = {};
-  },
-
-  reset: function() {
-    this.current = [];
-    this.tag = {}
-  },
-
-  transit: function(ch) {
-    var self = this;
-
-    self.creators.forEach(function(creator) {
-      var acceptor = creator.createAcceptor(self.tag);
-      if (acceptor) 
-        self.current.push(acceptor);
-    });
-    
-    var _current = [];
-    self.tag = {};
-
-    for (var i = 0; i < self.current.length; i++) {
-      var _acceptor = self.current[i]
-        , acceptor = _acceptor.transit(ch);
-      
-      if (!acceptor.isError) {
-        _current.push(acceptor);
-        self.tag[acceptor.tag] = acceptor;
-      }
-    }
-    self.current = _current;
-
-  },
-
-  getFinalAcceptors: function() {    
-    return this.current.filter(function(acceptor) {
-      return acceptor.isFinal;
-    });
-  }
-};
-
-module.exports = function() {
-  var acceptors = _.clone(Acceptors);
-  acceptors.init();
-  return acceptors;
-};
-
-},{"underscore":25}],2:[function(require,module,exports){
-(function (__dirname){
-
-var LEFT = 0;
-var RIGHT = 1;
-var path = require("path");
-var glob = require("glob");
-
-var WordcutDict = {
-
-
-  init: function (dictPathFile, withDefault, words) {
-    withDefault = withDefault || false
-    var defaultDict = path.normalize(__dirname + "/..") + "/data/tdict-*.txt";
-    this.dict=[]
-    var dictPathIsDefined = dictPathFile !== undefined
-    var dictPath = (withDefault || !dictPathIsDefined) ? [defaultDict]: [];
-    var dictPathFile = dictPathFile || defaultDict
-
-    if(dictPathIsDefined){
-      if (Array.isArray(dictPathFile)) {
-        dictPath.concat.apply(dictPath, dictPathFile);
-      } else {
-        dictPath.push(dictPathFile)
-      }
-    }
-
-    this.addFiles(dictPath, false)
-
-    if(words!==undefined){
-      this.addWords(words, false)
-    }
-    this.finalizeDict();
-  },
-
-  addWords: function(words, finalize){
-    finalize = finalize===undefined || finalize;
-    this.dict.push.apply(this.dict, words)
-    if(finalize){
-      this.finalizeDict();
-    }
-  },
-
-  finalizeDict: function(){
-    this.dict = this.sortuniq(this.dict);
-  },
-
-  addFiles: function(files, finalize){
-    finalize = finalize===undefined || finalize;
-    
-    for (var i = 0; i < 1; i++) {
-      var words = "ก.ก.\nก.ก.น.\nก.ข.ค.\nก.ค.\nก.จ.\nก.ช.น.\nก.ฌ.\nก.ต.\nก.ต.ง.\nก.ต.ช.\nก.ตร.\nก.ท.\nก.น.ช.\nก.บช.\nก.บถ.\nก.ป.ส.\nก.พ.\nก.ม.\nก.ย.\nก.ร.\nก.ล.ต.\nก.ว.\nก.ศ.ว.\nก.ส.ท.\nก.ส.ธ.\nก.ส.อ.\nก.อ.\nกก.ตชด.\nกก.ตร.น.\nกก.ภ.จว.\nกก.รสช.\nกกบ.ขส.ทบ.\nกกล.รพน.\nกง.กห.\nกง.ทบ.\nกง.ทร.\nกซข.ป.\nกซม.ป.\nกทม.กรุงเทพมหานคร\nกบ.ทบ.\nกป.สป.\nกพ.ทบ.\nกพ.ทร.\nกพ.ทหาร\nกร.ทบ.\nกรป.กลาง\nกรอ.พอ.\nกศ.ด.\nกศ.บ.\nกศ.บป.\nกศ.ม.\nกษ.ด.\nกษ.บ.\nกษ.ม.\nกส.ด.\nกส.ทบ.\nกส.บ.\nกส.ม.\nกอ.ปค.\nกอ.รพน.\nกอ.รมน.\nกอ.รสต.\nข.ต.ว.\nขว.ทบ.\nขว.ทร.\nขว.ทหาร\nขส.ทบ.\nขส.ทร.\nขส.ทอ.\nค.ด.\nค.บ.\nค.พ.ศ.\nค.ม.\nค.ร.น.\nค.ร.ฟ.\nค.ร.ม.\nค.ศ.\nค.อ.ด.\nค.อ.บ.\nค.อ.ม.\nคศ.ด.\nคศ.บ.\nคศ.ม.\nง.ด.\nจ.จ.\nจ.จ.จ.\nจ.ช.\nจ.ต.\nจ.ท.\nจ.ป.ร.\nจ.ม.\nจ.ศ.\nจ.ส.ต.\nจ.ส.ท.\nจ.ส.อ.\nจ.อ.\nจ.อ.ร.\nจ.๑๘\nจก.ธน.\nจก.สน.\nช.ค.\nช.ค.บ.\nช.พ.ค.\nช.ส.\nช.ส.ค.\nฌ.ป.ค.\nฌ.ศ.ร.\nฌ.ส.อ.\nฐท.สห.\nด.ช.\nด.ญ.\nด.ต.\nด.ศ.ค.\nด.ศ.ร.\nดย.ทร.\nต.ก.\nต.ค.\nต.จ.\nต.จ.ว.\nต.ช.\nต.ต.\nต.บ.\nต.ม.\nต.ร.\nต.ศ.ร.\nต.ห.\nต.อ.\nต.อ.จ.\nตร.กม.\nตร.ซม.\nตร.ต.\nตร.ทล.\nตร.น.\nตร.ปม.\nตร.ภ.\nตร.ม.\nตร.รฟ.\nตร.ว.\nตร.ส.\nตร.สข.\nท.จ.\nท.จ.ว.\nท.ช.\nท.ญ.\nท.ด.\nท.ท.ท.\nท.ทบ.\nท.บ.\nท.พ.\nท.ม.\nท.ศ.\nทก.ด.\nทก.บ.\nทก.ม.\nทส.ปช.\nทส.รมว.กห.\nทุ.ส.นิ.ม.\nธ.ก.ส.\nธ.ค.\nธ.ญ\nธ.บ.\nน.ช.\nน.ญ.\nน.ด.\nน.ต.\nน.ท.\nน.น.\nน.บ.\nน.บ.ท.\nน.ป.ท.\nน.พ.\nน.ม.\nน.ร.\nน.ว.\nน.ศ.\nน.ส.\nน.ส.พ.\nน.ส.๓\nน.สพ.\nน.อ.\nนปพ.ภ.\nนศ.ด.\nนศ.บ.\nนศ.ม.\nบ.ก.\nบ.ข.ส.\nบ.ช.\nบ.ด.ท.\nบ.ตร.\nบ.ภ.\nบ.ม.\nบก.จร.\nบก.ตชด.\nบก.ตม.\nบก.ทล.\nบก.น.\nบก.ป.\nบก.ปค.\nบก.ปม.\nบก.ภ.เขต\nบก.รน.\nบก.รฟ.\nบก.ร้อย.ตชด.\nบก.ส.\nบกข.ป.\nบจพ.ป.\nบช.ก.\nบช.ด.\nบช.ตชด.\nบช.น.\nบช.บ.\nบช.ปส.\nบช.ภ.\nบช.ม.\nบชท.ป.\nบชน.ป.\nบชส.ป.\nบธ.ด.\nบธ.บ.\nบธ.ม.\nบนท.ป.\nบนอ.ป.\nบปช.ป.\nป.กท.\nป.กศ.\nป.กศ.สูง\nป.จ.\nป.จ.ว.\nป.ช.\nป.ธ.\nป.ป.\nป.ป.ก.\nป.ป.ช.\nป.ป.ป.\nป.ป.ร.\nป.ป.ส.\nป.พ.\nป.พ.พ.\nป.พย.\nป.ม.\nป.ม.ก.\nป.ม.ช.\nป.ม.ธ.\nป.ม.ศ.\nป.ม.อ.\nป.ร.ร.๔\nป.ร.ร.๕\nป.ร.ร.๖\nป.ล.\nป.ว.พ.\nป.วิ.อ.\nป.ส.ส.\nป.อ.\nป.อ.ร.ส.\nป.๑\nปม.วส.\nปอ.พ.\nผกก.ภ.\nผช.ผอ.\nผต.มท.\nผบ.ตร.\nผบ.ทบ.\nผบ.ทร.\nผบ.ทสส.\nผบ.ทอ.\nผบก.น.\nผบก.ป.\nผบก.ปค.\nผบก.ปม.\nผบก.ภ.\nผบช.ก.\nผบช.ตชด.\nผบช.น.\nผบช.ภ.\nผว.กทม.\nผอ.ปจ.\nพ.ก.ง.\nพ.กศ.\nพ.ข.ต.\nพ.ค.\nพ.ค.ช.\nพ.ค.ว.\nพ.ค.ศ.\nพ.จ.ต.\nพ.จ.ท.\nพ.จ.อ.\nพ.ช.\nพ.ช.ค.\nพ.ด.\nพ.ต.\nพ.ต.ต.\nพ.ต.ท.\nพ.ต.อ.\nพ.ต.อ.พิเศษ\nพ.ท.\nพ.บ.\nพ.ป.\nพ.ภ.ม.\nพ.ม.\nพ.ม.ช.\nพ.ย.\nพ.ร.ก.\nพ.ร.ฎ.\nพ.ร.ต.\nพ.ร.ธ.\nพ.ร.บ.\nพ.ศ.\nพ.ศ.บ.\nพ.ส.ร.\nพ.ส.ล.\nพ.อ.\nพ.อ.ต.\nพ.อ.ท.\nพ.อ.พิเศษ\nพ.อ.อ.\nพณ.ด.\nพณ.บ.\nพณ.ม.\nพธ.ด.\nพธ.บ.\nพธ.ม.\nพบ.ด.\nพบ.บ.\nพบ.ม.\nพย.ด.\nพย.บ.\nพย.ม.\nพล.จ.\nพล.ต.\nพล.ต.จ.\nพล.ต.ต.\nพล.ต.ท.\nพล.ต.อ.\nพล.ท.\nพล.ปตอ.\nพล.ม.\nพล.ม.๒\nพล.ร.จ.\nพล.ร.ต.\nพล.ร.ท.\nพล.ร.อ.\nพล.อ.\nพล.อ.จ.\nพล.อ.ต.\nพล.อ.ท.\nพล.อ.อ.\nพลา.ทร.\nพศ.ด.\nพศ.บ.\nพศ.ม.\nพอ.สว.\nภ.ง.ด.\nภ.ง.ด.๙\nภ.ด.\nภ.บ.\nภ.บ.ท.๕\nภ.ป.ร.\nภ.พ.\nภ.ม.\nภ.สถ.บ.\nม.ค.\nม.จ.\nม.ป.ท.\nม.ป.ป.\nม.ป.พ.\nม.ร.ว.\nม.ศ.\nม.อ.\nม.อ.ปัตตานี\nมิ.ย.\nมี.ค.\nยศ.ทบ.\nยศ.ทร.\nยศ.ทอ.\nร.ง.\nร.ด.\nร.ต.\nร.ต.ต.\nร.ต.ท.\nร.ต.อ.\nร.ท.\nร.น.\nร.บ.\nร.พ.\nร.ฟ.ล.\nร.ย.ล.\nร.ย.ส.ท.\nร.ล.\nร.ศ.\nร.ส.พ.\nร.อ.\nรป.ม.\nรร.จปร.\nรร.จอ.\nรร.ชท.\nรร.ตท.\nรร.นร.\nรร.นรต.\nรร.นอ.\nล.ญ.\nล.ว.\nลส.ชบ.\nว.ค.\nว.ฉ.\nว.ช.\nว.ด.ป.\nว.ป.ถ.\nวท.บ.\nศ.บ.\nศ.ป.ก.\nศ.ศ.ป.\nศฝร.ภ.\nศศ.บ.\nศษ.บ.\nศส.บ.\nส.ก.\nส.ก.ศ.ท.\nส.ค.\nส.ค.1\nส.ค.ร.\nส.ค.ส.\nส.ต.\nส.ต.ต.\nส.ต.ท.\nส.ต.อ.\nส.ท.\nส.ทร.\nส.ป.ช.\nส.ป.ส.ท.\nส.ป.อ.\nส.ร.\nส.ล.น.\nส.ว.\nส.ว.ท.\nส.ว.ส.ท.\nส.ส.\nส.ส.ท.\nส.ส.ร.\nส.ห.\nส.อ.\nสถ.บ.\nสนง.สสอ.\nสพ.ญ.\nสพ.บ.\nสว.จร.\nสว.ธร.\nสว.ส.\nสว.สป.\nสว.สส.\nสว.อก.\nสส.บ.\nสุ.จิ.ปุ.ลิ.\nห.ร.ม.\nอ.ก.ค.\nอ.ก.จ.\nอ.จ.\nอ.ช.พ.\nอ.ตร.\nอ.บ.\nอ.ส.ท.\nอ.ส.ม.ท.\nอ.ส.ย.\nอ.อ.ป.\nอส.รด.\nอุ.อา.ก.ส.\nฮ.จ.\nฮ.ท.\nฮ.ฝ.\nฮ.ล.\nฮ.ศ.\nเม.ย.\n\nกรีนิช\nกลันตัน\nกัลกัตตา\nกัวลาลัมเปอร์\nกัศมีร์\nกาฐมาณฑุ\nโกลกาตา\nควิเบก\nคอนเนตทิคัต\nคาบูล\nคุชราต\nคุนหมิง\nเคนตักกี\nเคนทักกี\nเคมบริดจ์\nแคชเมียร์\nแคนซัส\nแคนเบอร์รา\nแคโรไลนา\nแคลิฟอร์เนีย\nโคเปนเฮเกน\nโคลัมโบ\nโคโลราโด\nไครสต์เชิร์ช\nไคโร\nจาการ์ตา\nจำปาศักดิ์\nเจนไน\nเจนีวา\nเจ้อเจียง\nฉงชิ่ง\nเฉิงตู\nชานตง\nชิคาโก\nเชนไน\nเชอร์โนบิล\nซัปโปโร\nซานมารีโน\nซาบาห์\nซาราเยโว\nซาราวัก\nซิดนีย์\nซีอาน\nซีแอตเทิล\nซูริก\nซูริค\nเซเชลส์\nเซนได\nเซี่ยงไฮ้\nโซเฟีย\nโซล\nโซโลมอน\nไซ่ง่อน\nไซบีเรีย\nดัลลัส\nดาโคตา\nดานัง\nดีทรอยต์\nดูไบ\nเดนเวอร์\nเดลาแวร์\nเดียนเบียนฟู\nโดเวอร์\nโดฮา\nไดฟุกุ\nไดฟูกุ\nตรังกานู\nตริโปลี\nตูวาลู\nเตหะราน\nโตเกียว\nโตรอนโต\nทมิฬนาฑู\nทริโปลี\nทิเบต\nเทกซัส\nเท็กซัส\nเทนเนสซี\nเทลอาวีฟ\nแทสเมเนีย\nโทรอนโต\nไทเป\nธากา\nนางาซากิ\nนาริตะ\nนิวเจอร์ซีย์\nนิวเดลี\nนิวยอร์ก\nนิวยอร์ค\nนิวแฮมป์เชียร์\nเนบราสกา\nเนแบรสกา\nเนวาดา\nบรัสเซลส์\nบราซิเลีย\nบอมเบย์\nบอสตัน\nบังกาลอร์\nบังคาลอร์\nบูคาเรสต์\nบูดาเปสต์\nเบงกาซี\nเบนกาซี\nเบรุต\nเบลเกรด\nเบอร์ลิน\nแบกแดด\nปอยเปต\nปะลิส\nปะหัง\nปักกิ่ง\nปัญจาบ\nปัฏนา\nปารีส\nปีนัง\nเประ\nเปียงยาง\nพนมเปญ\nพระตะบอง\nพะโค\nพะสิม\nพาราณสี\nพิหารี\nเพนซิลวาเนีย\nเพนซิลเวเนีย\nฟรานซ์\nฟลอริดา\nฟิลาเดลเฟีย\nฟุกุชิมะ\nฟุกุชิมา\nฟุกุโอกะ\nฟูกูโอกะ\nแฟรงก์เฟิร์ต\nมอสโก\nมะนิลา\nมะละแหม่ง\nมัณฑะเลย์\nมัทราส\nมาดริด\nมิชิแกน\nมินนิโซตา\nมิยางิ\nมิลาน\nมิวนิก\nมิสซูรี\nมุมไบ\nเมน\nเมลเบิร์น\nเมาะตะมะ\nเมาะลำเลิง\nแมนจูเรีย\nแมนเชสเตอร์\nแมนฮัตตัน\nแมริแลนด์\nแมรีแลนด์\nแมสซาชูเซตส์\nยะไข่\nย่างกุ้ง\nยูทาห์\nยูนนาน\nเยรูซาเล็ม\nโยโกฮามา\nริยาด\nรีโอเดจาเนโร\nโรดไอแลนด์\nลอนดอน\nลอสแองเจลิส\nลาปาซ\nลาสเวกัส\nลิสบอน\nลุยเซียนา\nโลซาน\nโลซานน์\nวอชิงตัน\nวอร์ซอ\nวิสคอนซิน\nเวนิส\nเวลส์\nเวอร์จิเนีย\nเวอร์มอนต์\nเวียงจันทน์\nเวียนนา\nแวนคูเวอร์\nไวโอมิง\nสกอตแลนด์\nสก็อตแลนด์\nสตอกโฮล์ม\nสลังงอร์\nเสฉวน\nเสียมราฐ\nเสียมเรียบ\nหงสา\nหงสาวดี\nหนานไห่\nหลวงพระบาง\nหูเป่ย\nหูเป่ย์\nหูหนาน\nเหอเป่ย\nเหอเป่ย์\nเหอหนาน\nอชันตา\nอลาสกา\nอวันตี\nออริกอน\nออสโล\nอะแลสกา\nอัตตะปือ\nอัมมาน\nอัมสเตอร์ดัม\nอัสสัม\nอาบูดาบี\nอาร์คันซอ\nอินเดียนา\nอิบารากิ\nอิลลินอยส์\nอิสตันบูล\nอิสลามาบัด\nอุรุมชี\nอูลานบาตอร์\nเอดินบะระ\nเอเธนส์\nแอตแลนตา\nแอริโซนา\nแอลเจียร์\nโอคลาโฮมา\nโอค็อตสค์\nโอกินาวา\nโอซากา\nโอริสสา\nโอเรกอน\nโอไฮโอ\nไอดาโฮ\nไอโอวา\nฮอนโนลูลู\nฮานอย\nฮาเนดะ\nฮาราเร\nฮาวาย\nฮิโรชิมา\nฮุสตัน\nเฮลซิงกิ\n\nมกรา\nกุมภา\nมีนา\nเมษา\nพฤษภา\nมิถุนา\nกรกฎา\nสิงหา\nกันยา\nตุลา\nพฤศจิกา\nธันวา\nเอ\nบี\nซี\nดี\nอี\nเอฟ\nจี\nเอช\nไอ\nเจ\nเค\nแอล\nเอ็ม\nเอ็น\nโอ\nพี\nคิว\nอาร์\nเอส\nที\nยู\nวี\nดับเบิล\nดับบลิว\nเอ็กซ์\nเอ๊กซ์\nวาย\nแซด\nแอลฟา\nแอลฟ่า\nเบตา\nเบต้า\nแกมมา\nแกมม่า\nเดลตา\nเดลต้า\nโอเมกา\nโอเมก้า\nเมกะ\nกิกะ\nนาโน\nไมโคร\n\nกรรมาชน\nกรอบรูป\nกระดี๊กระด๊า\nกระบับ\nกราวนด์\nกรีน\nกรุ๊ป\nกฤษณ์\nกลาส\nก๊วน\nกษัตริยา\nกษัตริยาธิราช\nก่อนหน้า\nกะบับ\nกับดัก\nกัมมันตะ\nก๊าก\nก๋ากั่น\nกาญจน์\nกาญจนาภิเษก\nกามิกาเซ่\nการันตี\nกาหลิบ\nกิฟท์\nกิมจิ\nกีวี\nกึ๊ก\nกึ๋ย\nกุนซือ\nกุมภาพันธ์\nกู๋\nเกจิ\nเกมส์\nเกย์\nเกรด\nเกรย์\nเกสต์เฮาส์\nเก๊ะ\nเก๋ากี้\nเกิร์ล\nแกงค์\nแกรนด์\nแกสโซฮอล์\nแก๊สโซฮอล์\nโกเต็กซ์\nโกลด์\nโกะ\nโก๊ะ\nไกด์\nขั้นตอน\nเขวี้ยง\nคณาญาติ\nครัวซอง\nครัวซองต์\nคร่ำครวญ\nครีเอทีฟ\nครูเสด\nคลับ\nคลาสสิก\nคลิตอริส\nคลิป\nความหมาย\nควิก\nควีน\nคองเกรส\nคอนซูเมอร์\nคอนเซปต์\nคอนเซ็ปต์\nคอนโด\nคอนโดมิเนียม\nคอนเทนเนอร์\nคอนแทค\nคอนแท็ค\nคอนโทรล\nคอนเฟิร์ม\nคอปเตอร์\nคอมพ์\nคอมเพล็กซ์\nคอมมอนส์\nคอมเมนท์\nคอมเมนต์\nคอร์ป\nคอร์ปอเรชั่น\nคอร์รัปชัน\nคอร์รัปชั่น\nคอรัปชัน\nคอรัปชั่น\nคอร์ส\nคอลเล็กชั่น\nคอลัมน์\nคอลัมนิสต์\nคัตเอาต์\nคันคาก\nคันถธุระ\nคันธาระ\nคันยิ\nคัสตาร์ด\nคาราโอเกะ\nคีตกวี\nคีตปฏิภาณ\nคีตราชัน\nคาปูชิโน\nคามิคาเซ่\nคาเฟ่\nคาร์\nคาร์โก้\nคาราเมล\nคาแรกเตอร์\nคาแร็กเตอร์\nคาแรคเตอร์\nคาแร็คเตอร์\nคาวบอย\nคาสิโน\nคิกขุ\nคิวบิก\nคูลเลอร์\nเคบับ\nเครป\nเคลม\nเคลียร์\nเคลื่อนย้าย\nเคส\nเคอร์ฟิว\nแคชเชียร์\nแคทวอล์ค\nแคนดิเดต\nแคนตาลูป\nแคนยอน\nแคนู\nแคป\nแคมป์\nแคมปัส\nแคมเปญ\nแคร์\nแครกเกอร์\nแคร็กเกอร์\nแครอท\nแคสต์\nแคสติง\nแคสติ้ง\nโค้ก\nโค้ช\nโคโยตี\nโคโยตี้\nโครนา\nโคอะล่า\nโคอาลา\nโคอาล่า\nไคลแมกซ์\nไคลแม็กซ์\nงั้น\nง่าว\nงี้\nเง็ง\nโง่เขลา\nไง\nจตุคาม\nจ๊อกกี้\nจอหงวน\nจังโก้\nจัมโบ้\nจ๊าบ\nจารกรรม\nจารชน\nจิ๊ก\nจิ๊กโก๋\nจิ๊กซอว์\nจิตพิสัย\nจิตเภท\nจีดีพี\nจึ๊ก\nจุ๊ย\nจูน\nจูเนียร์\nเจ๊\nเจได\nเจ็ต\nเจล\nเจ๊าะแจ๊ะ\nเจี๊ยว\nแจ็กเก็ต\nแจ๊กเก็ต\nแจ็กพอต\nแจ็กพ็อต\nแจ๊กพอต\nแจ๊กพ็อต\nแจม\nแจ๊ส\nโจ๋\nฉลุย\nเฉิ่ม\nชนะเลิศ\nช็อค\nช็อต\nช็อป\nช็อปปิ้ง\nช็อปเปอร์\nชะโนด\nชัตเตอร์\nชัวร์\nชาร์จ\nชาร์ต\nชาร์ป\nชินบัญชร\nชิฟฟอน\nชีส\nชีอะห์\nเช็ก\nเช็งเม้ง\nเชฟ\nเชลียร์\nเชอร์รี่\nแชเชือน\nแช่แข็ง\nแชมป์\nแชมปิยอง\nแชมเปญ\nแชมเปี้ยน\nแชมพู\nโชว์รูม\nโชห่วย\nใช้งาน\nไชน่า\nซ้อ\nซอมบี้\nซะ\nซังเต\nซันตาคลอส\nซัพพลาย\nซัพพลายเออร์\nซัมเมอร์\nซากุระ\nซาดิสต์\nซาดิสม์\nซาตาน\nซานตาคลอส\nซาฟารี\nซาบะ\nซามูไร\nซาร์\nซาร์ดีน\nซาเล้ง\nซิง\nซิ่ง\nซิงเกิล\nซิตี\nซิตี้\nซินโดรม\nซิม\nซิ้ม\nซิมโฟนี\nซิมโฟนี่\nซิลเวอร์\nซี้\nซี้ซั้ว\nซีดาน\nซีน\nซีนีเพล็กซ์\nซีเนียร์\nซีร็อกซ์\nซีรีส์\nซีเรียส\nซีอีโอ\nซื่อบื้อ\nซุนหนี่\nซุปเปอร์\nซูชิ\nซูเปอร์\nซูม\nซูโม่\nซูเอี๋ย\nซูฮก\nเซ็กซ์\nเซ็กซี่\nเซ็กส์\nเซนเซอร์\nเซ็นเซอร์\nเซนเตอร์\nเซ็นเตอร์\nเซ็นทรัล\nเซนส์\nเซ่นไหว้\nเซฟตี้\nเซรามิก\nเซลส์\nเซลส์แมน\nเซอร์\nเซอร์ไพรส์\nเซอร์วิส\nเซาท์\nเซี้ยว\nแซ็ก\nแซกโซโฟน\nแซ็กโซโฟน\nแซนด์วิช\nแซมบ้า\nแซลมอน\nแซว\nโซเชียล\nโซน\nโซนี่\nโซลาร์\nโซโล\nโซโล่\nญาณทัสสนะ\nดยุก\nดยุค\nดร็อป\nดรัมเมเยอร์\nดรามา\nดราม่า\nดอกเตอร์\nด็อกเตอร์\nดัมพ์\nดั๊มพ์\nดาวน์\nดิกชันนารี\nดิสเครดิต\nดีกรี\nดีเจ\nดีไซน์\nดีไซน์เนอร์\nดีไซเนอร์\nดีเบต\nดีพาร์ตเมนต์\nดีพาร์ตเมนท์\nดีพาร์ทเมนต์\nดีพาร์ทเมนท์\nดีมานด์\nดีล\nดีลเลอร์\nดีเลย์\nเดชานุภาพ\nเดบิต\nเดโม\nเดย์\nเด้อ\nเดอะ\nเด๊ะ\nเดี้ยง\nเดี๊ยะ\nแดนซ์\nแดนเซอร์\nแดรี่\nโดนัท\nโดมิโน\nโดรายากิ\nไดเอ็ต\nตถตา\nตนเอง\nตรวจทาน\nตรวจสอบ\nตอกย้ำ\nต๊อง\nต่อยอด\nต่อรอง\nตะหงิด\nตังค์\nตันเถียน\nตัวตน\nตัวเอง\nตาปรือ\nต้าอ่วย\nติงต๊อง\nติ๋ม\nติ่มซำ\nติว\nติวเตอร์\nตี๋\nตื้บ\nตุ๊ก\nตุ๊กตุ๊ก\nตุ๊ด\nตุ๋ย\nตู้เซฟ\nเต๊ะ\nเตี๊ยม\nแตงกวา\nแตงโม\nแต๋ว\nโต๋เต๋\nโต๊ะจีน\nไตรมาส\nถ่ายทำ\nถูกต้อง\nทงคัตสึ\nทริป\nทรู\nทอม\nท็อป\nทอร์นาโด\nทอล์ค\nทักซิโด\nทันตกรรม\nทันตแพทยศาสตร์\nทับซ้อน\nทัวร์\nทัวร์นาเมนต์\nทัวร์นาเมนท์\nทัวริสต์\nทาเลนต์\nทาวน์\nทาวน์เฮาส์\nทำงาน\nทิป\nทิพยสมบัติ\nทิวลิป\nทีรามิสุ\nทีวี\nทูน่า\nเท็กซ์\nเทค\nเทคโน\nเทคโนแครต\nเทควันโด\nเทป\nเทรด\nเทรนด์\nเทรนเนอร์\nเทรลเลอร์\nเทรลเล่อร์\nเทเลกราฟ\nเทวบัญชา\nเทวบุตร\nเทวา\nเทวาธิราช\nเทโวโรหนะ\nเทอร์โบ\nเที่ยงคืน\nเที่ยงวัน\nเทียมทาน\nแทกติค\nแทคติค\nแทงกั๊ก\nแทงโก้\nโทมาฮอก\nโทมาฮอว์ก\nโทมาฮอว์ค\nโทร\nโทรโข่ง\nไทม์\nไทยแลนด์\nไทเฮา\nธรรมา\nธรรมาภิบาล\nธัมโม\nธีม\nธุรกรรม\nธุหร่ำ\nเธค\nนพมาศ\nนรีแพทย์\nน็อก\nน็อค\nน้องใหม่\nนอมินี\nนอร์ท\nน่ะ\nนางแบบ\nนาฏยศาลา\nนายแบบ\nนายพราน\nนินจา\nนิรันดร์\nนิว\nนิวส์\nนู้ด\nเนอะ\nเนิร์สเซอรี\nเนิร์สเซอรี่\nเนี้ยบ\nโนติส\nไนท์\nไนน์\nบรรพชน\nบร็อกโคลี\nบร็อคโคลี\nบรา\nบริกร\nบริวเวอรี่ส์\nบลอนด์\nบลูเบอร์รี\nบลูเบอร์รี่\nบ๊วย\nบอกซ์\nบ็อกซ์\nบ๊อกซ์\nบอดี้\nบอนด์\nบ๊อบ\nบอมบ์\nบ๋อย\nบอยคอต\nบอยคอตต์\nบอร์ด\nบังเกอร์\nบัตเตอร์\nบัลลาสต์\nบัส\nบาบูน\nบาร์บีคิว\nบาร์บี้\nบาลานซ์\nบิ๊ก\nบิล\nบึม\nบึ้ม\nบุญคุณ\nบุ๋น\nบุปผา\nบู๊\nบูชิโด\nบูติก\nบูติค\nบูม\nเบเกอรี่\nเบญจมบพิตร\nเบตาดีน\nเบนโตะ\nเบนโล\nเบบี้\nเบลอ\nเบอร์เกอร์\nเบอร์รี\nเบิร์ด\nเบิร์น\nแบ็กโฮ\nแบคโฮ\nแบด\nแบต\nแบนเนอร์\nแบรนด์\nแบล็ก\nแบล็ค\nไบโอ\nโบกี้\nโบตั๋น\nโบ้ย\nโบรกเกอร์\nโบรชัวร์\nโบว์\nโบว์ลิ่ง\nไบเบิล\nปฏิสัมพันธ์\nป๊อก\nปอดแหก\nป๊อป\nป๋อหลอ\nปักขคณนา\nปัจเจกชน\nปัจฉิมนิเทศ\nป๊า\nป๋า\nป่าไม้\nปาร์ตี้\nปาสกาล\nปาสคาล\nปาสเตอร์\nปิกอัพ\nปิ๊ง\nปิโตรเคมี\nปิยมิตร\nปึ้ก\nปูอัด\nเปโซ\nเป็นไง\nเปปเปอร์มินต์\nเปเปอร์\nเปราะบาง\nเป๊ะ\nเป่ายิงฉุบ\nเป่ายิ้งฉุบ\nเปียโน\nแป้ก\nแป๋ว\nแป๊ะเจี๊ยะ\nโปร\nโปรเจกต์\nโปรเจ็กต์\nโปรเจกเตอร์\nโปรเจ็กเตอร์\nโปรเจคท์\nโปรเจ็คท์\nโปรดักชั่น\nโปรดิวเซอร์\nโปรโมชั่น\nโปรโมต\nโปรโมเตอร์\nโปรโมท\nโปลิศ\nโปสเตอร์\nผลไม้\nผลักดัน\nผ้าห่ม\nผิดพลาด\nผู้นำ\nแผดเผา\nเฝอ\nพงษ์\nพริตตี้\nพรีเซนต์\nพรีเซ็นเตอร์\nพรีเมียม\nพรีเมียร์\nพฤหัส\nพล็อต\nพลาซ่า\nพลานุภาพ\nพ่อค้า\nพอเพียง\nพะเรอ\nพันธกิจ\nพันธุวิศวกรรม\nพาร์\nพาร์ตเนอร์\nพาร์ทเนอร์\nพาวเวอร์\nพาสเจอร์ไรส์\nพาสตา\nพาสต้า\nพาสปอร์ต\nพาเหรด\nพิซซ่า\nพีเรียด\nพุดดิ้ง\nพุทธภูมิ\nพุทธศตวรรษ\nพุทโธ\nพูล\nเพทนาการ\nเพนกวิน\nเพนตากอน\nเพรส\nเพรียวบาง\nเพลซ\nเพลท\nเพลย์บอย\nเพียบแปร้\nเพียว\nเพาเวอร์\nแพกเกจ\nแพ็ค\nแพตเทิร์น\nแพทเทิร์น\nแพทยสภา\nแพนงเชิญ\nแพนดา\nแพนด้า\nแพลน\nโพลล์\nโพลารอยด์\nโพสต์\nไพลิน\nฟยอร์ด\nฟรังก์\nฟรุต\nฟลอร์\nฟลุก\nฟลุค\nฟลุต\nฟลุท\nฟอยล์\nฟอร์ม\nฟันด์\nฟาวล์\nฟาสต์ฟู้ด\nฟินิกซ์\nฟิวเจอร์\nฟีด\nฟีเวอร์\nฟุตบาท\nเฟรช\nเฟรชชี่\nเฟรม\nเฟมินิสต์\nเฟส\nเฟอร์นิเจอร์\nเฟอร์รี่\nเฟิร์ม\nเฟี้ยวฟ้าว\nแฟกซ์\nแฟ็กซ์\nแฟนซี\nแฟนตาซี\nแฟ้บ\nแฟร์\nแฟรนไชส์\nแฟรี\nแฟรี่\nแฟลช\nแฟล็ต\nโฟน\nโฟม\nโฟล์ค\nไฟต์\nไฟแนนซ์\nไฟลต์\nไฟลท์\nภควัทคีตา\nภควัมบดี\nภควัมปติ\nภคันทลาพาธ\nภววิสัย\nภารตะ\nภูมิทัศน์\nม้ง\nมวลชน\nมยุราภิรมย์\nมลภาวะ\nมหภาค\nมหาอุปราชา\nมอคคา\nมอคค่า\nมอนสเตอร์\nม็อบ\nมอบตัว\nมอยส์เจอไรเซอร์\nมอลล์\nมะกัน\nมั้ง\nมัฟฟิน\nมั้ย\nม้านั่ง\nมาเฟีย\nมาม่า\nมายองเนส\nมายาคติ\nมาร์ก\nมาร์เก็ต\nมาร์เก็ตติ้ง\nมาร์ค\nมาร์จิน\nมาร์ช\nมาร์ต\nมาร์ท\nมาราธอน\nม้าหินอ่อน\nมินต์\nมินท์\nมินิ\nมิลค์\nมิวสิค\nมิสซัง\nมิสไซล์\nมิสเตอร์\nมือถือ\nมุมมอง\nเมคอัพ\nเมจิก\nเมจิค\nเมทัล\nเมเปิล\nเมาท์\nเมี่ยงคำ\nแมกกาซีน\nแม็กกาซีน\nแมคเคอเรล\nแม่ค้า\nแมชชีน\nแมชีน\nแมนชั่น\nแมมบ้า\nแมมโบ้\nโมจิ\nโมเดล\nโมเดิร์น\nโมเต็ล\nโมโนเรล\nโมหจริต\nไมค์\nไมเกรน\nยนตรกรรม\nยอมรับ\nยะเยือก\nยังไง\nยากูซ่า\nยาวี\nยิม\nยิว\nยุวทูต\nยูโทเปีย\nยูโร\nยูวี\nเยน\nเยลลี่\nเย้ว\nเยอบีรา\nเยอบีร่า\nเยอร์บีรา\nเยอร์บีร่า\nแยมโรล\nโยเกิร์ต\nโยโย่\nรวมมิตร\nร็อค\nร็อคเก็ต\nรองรับ\nรอมฎอน\nรอยัลตี้\nระโงก\nรันเวย์\nรัม\nรากหญ้า\nราชบัณฑิตยสถาน\nราชานุญาต\nราชานุสาวรีย์\nรามเทพ\nรามาธิบดี\nรามายณะ\nราเม็ง\nราเมน\nรายชื่อ\nราสเบอร์รี\nริกเตอร์\nริคเตอร์\nรีไซเคิล\nรีดไถ\nรีทัช\nรีเทิร์น\nรีไทร์\nรีแบรนด์\nรีพอร์ท\nรีโมต\nรีโมท\nรีวิว\nรีสอร์ต\nรีสอร์ท\nรีเสิร์ช\nรุมบ้า\nรุสโซ\nรูบิก\nรูบิค\nเรซิน\nเรซิ่น\nเรดิโอ\nเรต\nเรตติ้ง\nแรงใจ\nแรงดูด\nแรงผลัก\nแรลลี\nแรลลี่\nโรดแมป\nโรเนียว\nโรแมนติก\nโรแมนติค\nโรล\nโรลออน\nไรเฟิล\nล็อกเกอร์\nลอจิสติกส์\nล็อต\nล็อบบี้\nลอร์ด\nล้มเหลว\nละติน\nละอ่อน\nลาซานญ่า\nลาติน\nลาเต้\nลานีญา\nลามะ\nลิมิต\nลิมูซีน\nลิสต์\nลีก\nลีด\nลีดเดอร์\nลีเมอร์\nลีลาวดี\nลุค\nลูกชาย\nลูกสาว\nเลกเชอร์\nเลคเชอร์\nเลดี้\nเลสเบี้ยน\nเลิฟ\nแลนด์\nแล็บ\nโลโก้\nโลชั่น\nไลท์\nไลน์\nไลฟ์\nวนาราม\nวราราม\nวโรกาส\nว้อดก้า\nวอเตอร์\nวอฟเฟิล\nว้อย\nวอร์ม\nวอร์มอัพ\nวอร์รูม\nวอล์ก\nวอล์ค\nวอลซ์\nวอลนัต\nวอลนัท\nวอลล์\nว่ะ\nวันเวย์\nวัสสา\nวาซาบิ\nวาทกรรม\nวาทะ\nวานิลลา\nวานิลา\nวาฟเฟิล\nวาริชศาสตร์\nว้าว\nวัคค์\nวัจนะ\nวาไรตี้\nวิก\nวิดีโอ\nวิทย์\nวิน\nวิป\nวิปปิ้ง\nวิภัชภาค\nวิว\nวิลล์\nวิลเลจ\nวีเจ\nวีซ่า\nวีดิทัศน์\nวีน\nวีไอพี\nวืด\nเวณิกา\nเวเฟอร์\nเวสต์\nเวอร์\nเวิร์ก\nเวิร์กช็อป\nเวิร์ค\nเวิร์ลด์\nเวิลด์\nแวมไพร์\nไวกิ้ง\nไวเบรเตอร์\nไวอะกร้า\nไวอากร้า\nศากยบุตร\nศิรินทร์\nศิลปวัฒนธรรม\nศิลปากร\nศิวิไลซ์\nศึกษาศาสตร์\nสกรัม\nสกาย\nสกู๊ป\nสเกตช์\nสเก็ตช์\nสคริปต์\nสแควร์\nสงบสุข\nสจ๊วต\nสตรอเบอร์รี\nสตรอเบอรี\nสตรอว์เบอร์รี\nสตริง\nสต็อก\nสต๊อก\nสต็อค\nสต๊อค\nสตอรี\nสตาร์\nสตาร์ท\nสติกเกอร์\nสติ๊กเกอร์\nสตีล\nสตูดิโอ\nสเตชัน\nสเตชั่น\nสเตเดียม\nสเตนเลส\nสเต็ป\nสเตย์\nสเตริโอ\nสเตอริโอ\nสแตนดาร์ด\nสแตนเลส\nสโตน\nสโตร์\nสไตรค์\nสไตล์\nสถาปัตย์\nสไนเปอร์\nสปอต\nสป็อต\nสปอนเซอร์\nสปอร์ต\nสปา\nสปาย\nสปิริต\nสเปก\nสเปค\nสไปเดอร์\nสมณพราหมณ์\nสมาพันธ์\nสมิติเวช\nสโรชา\nสลัม\nสแล็ก\nสโลแกน\nสโลว์\nสไลด์\nสวีท\nสหรัฐ\nสหัชญาณ\nสหัสวรรษ\nสะกอม\nสะเด่า\nสะบึม\nสะบึมส์\nสะออน\nสังโฆ\nสะโหลสะเหล\nสันทนาการ\nสัมนา\nสามช่า\nสามแยก\nสารขัณฑ์\nสี่แยก\nสึนามิ\nสุนทรีย์\nสุริยยาตร\nสุริยยาตร์\nสุหนี่\nเสกสรรค์\nเสพติด\nเสือโคร่ง\nหงวน\nหน่อมแน้ม\nหมวย\nหมั่นโถว\nหม่านโถว\nหมายปอง\nหมิง\nหยวน\nหลวงตา\nหลวงปู่\nหลวงพี่\nหล่อฮังก้วย\nหลินจือ\nห่วย\nเห็นด้วย\nเหมย\nเห่ย\nเหี่ยวย่น\nแหม็บ\nแหวว\nโหงว\nโหงวเฮ้ง\nโหลน\nโหลยโท่ย\nไหง\nไหร่\nอพาร์ตเมนต์\nอพาร์ตเมนท์\nอพาร์ทเมนต์\nอพาร์ทเมนท์\nอมาตยาธิปไตย\nอยุติธรรม\nอริยสงฆ์\nอ่วม\nอวอร์ด\nออกแบบ\nออดิชั่น\nออดิทอเรียม\nออเดอร์\nออโต้\nออทิสติก\nอ่อนด้อย\nออฟ\nออยล์\nออร์แกน\nออร์แกนิก\nออร์แกนิค\nออร์เดอร์\nออรัล\nออสซี่\nอะ\nอัตลักษณ์\nอัตวิสัย\nอันเดอร์\nอันตรกิริยา\nอัลตรา\nอัลไซเมอร์\nอัลบัม\nอัลบั้ม\nอัลมอนด์\nอาข่า\nอาโนเนะ\nอาฟเตอร์\nอาร์ติสต์\nอาร์พีจี\nอาว์\nอาสวะ\nอิกัวนา\nอินดอร์\nอินดัสตรีส์\nอินเตอร์\nอิ่มแปร้\nอิมพีเรียล\nอิเล็กทริก\nอิเล็กทริค\nอิเลียด\nอิสรชน\nอิเหนา\nอิออน\nอีแต๋น\nอีโรติก\nอีเวนท์\nอีสต์\nอีสเตอร์\nอึ๊บ\nอึ้ม\nอึ๋ม\nอึมครึม\nอุด้ง\nอุตสาหการ\nอุเทน\nอุปการคุณ\nอุปทาน\nอุปนายก\nอุปนายิกา\nอุปสงค์\nอุปัทวเหตุ\nอุรังคธาตุ\nอูคูเลเล่\nอู้ฟู่\nเอ๋\nเอ็กซ์โป\nเอ็กซ์เพรส\nเอ็กโซเซต์\nเอ็กโซเซ่ต์\nเอเซีย\nเอ็นจีโอ\nเอ็นเตอร์เทน\nเอนทรานซ์\nเอ็นทรานซ์\nเอฟเฟ็กต์\nเอเยนต์\nเอลนีโญ\nเอสเปรสโซ\nเอสเพรสโซ\nเอ๋อ\nเอาต์\nเอาท์\nเอาท์ดอร์\nเอ๊าะ\nแอ็กชั่น\nแอ็คชั่น\nแอคทีฟ\nแอดมิชชั่น\nแอดมิสชัน\nแอนด์\nแอ๊บแบ๊ว\nแอปเปิล\nแอปเปิ้ล\nแอปพริคอท\nแอพพริคอท\nแอพริคอต\nแอร์\nแอโรบิก\nแอโรบิค\nแอลมอนด์\nแอสเตอร์\nโอเค\nโอเปอเรเตอร์\nโอเปร่า\nโอเพ่น\nโอ้ย\nโอยัวะ\nโอรสาธิราช\nโอเลี้ยง\nโอวัลติน\nโอเวอร์\nไอซ์\nไอซียู\nไอดอล\nไอเดีย\nไอติม\nฮวงจุ้ย\nฮ่องเต้\nฮองเฮา\nฮอต\nฮ็อต\nฮอตดอก\nฮ็อตด็อก\nฮันนีมูน\nฮัม\nฮัลโลวีน\nฮัลโหล\nฮากกา\nฮาร์ด\nฮาราคีรี\nฮาลาล\nฮาโลวีน\nฮิ\nฮิต\nฮิบรู\nฮิปโป\nฮิปฮอป\nฮีโร่\nฮูลาฮูป\nฮูล่าฮูป\nเฮฟวี\nเฮฟวี่\nเฮอร์ริเคน\nเฮีย\nแฮนด์\nแฮปปี้\nแฮมเบอร์เกอร์\nโฮป\nโฮม\nโฮลดิงส์\nโฮลวีต\nโฮสเตส\nไฮกุ\nไฮแจ็ค\nไฮโซ\nไฮเทค\nไฮบริด\nไฮเปอร์\nไฮไลต์\nไฮไลท์\nไฮเวย์\nไฮสคูล\nไฮเอนด์\n\nกรีซ\nกัมพูชา\nกัวเตมาลา\nกาตาร์\nกานา\nกาบอง\nกายอานา\nกินี\nเกรนาดีนส์\nเกรเนดา\nเกาหลี\nแกมเบีย\nโกตดิวัวร์\nคองโก\nคอโมโรส\nคอสตาริกา\nคาซัคสถาน\nคิตส์\nคิริบาตี\nคิริบาส\nคิวบา\nคีร์กีซสถาน\nคูเวต\nเคนยา\nเคปเวิร์ด\nเคย์แมน\nแคนาดา\nแคเมอรูน\nโครเอเชีย\nโคลอมเบีย\nจอร์เจีย\nจอร์แดน\nจาเมกา\nจิบูตี\nจีน\nชาด\nชิลี\nเช็ก\nซามัว\nซาอุ\nซิมบับเว\nซีเรีย\nซูดาน\nซูรินาเม\nเซนต์\nเซเนกัล\nเซอร์เบีย\nเซาตูเม\nเซียร์รา\nแซมเบีย\nโซมาเลีย\nโซเวียต\nไซปรัส\nญี่ปุ่น\nดารุสซาลาม\nเดนมาร์ก\nโดมินิกัน\nโดมินิกา\nตรินิแดด\nตองกา\nติมอร์\nตุรกี\nตูนิเซีย\nเติร์กเมนิสถาน\nโตโก\nโตเบโก\nไต้หวัน\nทาจิกิสถาน\nแทนซาเนีย\nนอร์เวย์\nนามิเบีย\nนาอูรู\nนิการากัว\nนิวซีแลนด์\nเนเธอร์แลนด์\nเนปาล\nเนวิส\nไนจีเรีย\nไนเจอร์\nบราซิล\nบริติช\nบริเตน\nบรูไน\nบอตสวานา\nบอสเนีย\nบังกลาเทศ\nบังคลาเทศ\nบัลแกเรีย\nบาร์บูดา\nบาร์เบโดส\nบาห์เรน\nบาฮามาส\nบิสเซา\nบุรุนดี\nบูร์กินาฟาโซ\nเบนิน\nเบลเยียม\nเบลารุส\nเบลีซ\nเบอร์มิวดา\nโบลิเวีย\nปรินซิปี\nปากีสถาน\nปานามา\nปาปัวนิวกินี\nปารากวัย\nปาเลสไตน์\nปาเลา\nเปรู\nเปอร์เซีย\nเปอร์โตริโก\nโปรตุเกส\nโปแลนด์\nฝรั่งเศส\nพม่า\nฟิจิ\nฟินแลนด์\nฟิลิปปินส์\nเฟรนช์\nภูฏาน\nภูฐาน\nมองโกเลีย\nมอนเตเนโกร\nมอนแทนา\nมอริเชียส\nมอริเตเนีย\nมอลโดวา\nมอลตา\nมัลดีฟส์\nมาเก๊า\nมาซิโดเนีย\nมาดากัสการ์\nมาร์แชลล์\nมาลาวี\nมาลี\nมาเลเซีย\nเม็กซิโก\nเมียนมาร์\nโมซัมบิก\nโมนาโก\nโมนาโค\nโมร็อกโก\nไมโครนีเซีย\nยูกันดา\nยูโกสลาเวีย\nยูเครน\nเยเมน\nเยอรมนี\nรวันดา\nรัสเซีย\nโรมาเนีย\nลักเซมเบิร์ก\nลัตเวีย\nลาว\nลิกเตนสไตน์\nลิทัวเนีย\nลิเบีย\nลีโอน\nลูเซีย\nเลโซโท\nเลบานอน\nเลสเต\nไลบีเรีย\nวาติกัน\nวานูอาตู\nวินเซนต์\nเวเนซุเอลา\nเวียดนาม\nศรีลังกา\nสเปน\nสโลวะเกีย\nสโลวัก\nสโลวีเนีย\nสวาซิแลนด์\nสวิตเซอร์แลนด์\nสวีเดน\nสหรัฐ\nสหราชอาณาจักร\nสิกขิม\nสิงคโปร์\nอเมริกา\nออสเตรเลีย\nออสเตรีย\nอันดอร์รา\nอัฟกานิสถาน\nอาเซอร์ไบจาน\nอาร์เจนตินา\nอาร์เมเนีย\nอาระเบีย\nอิเควทอเรียล\nอิตาลี\nอินเดีย\nอินโดนีเซีย\nอิรัก\nอิสราเอล\nอิหร่าน\nอียิปต์\nอุซเบกิสถาน\nอุรุกวัย\nเอกวาดอร์\nเอธิโอเปีย\nเอมิเรตส์\nเอริเทรีย\nเอลซัลวาดอร์\nเอสโตเนีย\nแองโกลา\nแอนติกา\nแอลจีเรีย\nแอลเบเนีย\nโอมาน\nไอซ์แลนด์\nไอร์แลนด์\nฮ่องกง\nฮอนดูรัส\nฮังการี\nเฮติ\nเฮอร์เซโกวีนา\n\nกระบี่\nกรุงเทพ\nกาญจนบุรี\nกาฬสินธุ์\nกำแพงเพชร\nขอนแก่น\nจันทบุรี\nฉะเชิงเทรา\nชลบุรี\nชัยนาท\nชัยภูมิ\nชุมพร\nเชียงราย\nเชียงใหม่\nตรัง\nตราด\nตาก\nนครนายก\nนครปฐม\nนครพนม\nนครราชสีมา\nนครศรีธรรมราช\nนครสวรรค์\nนนทบุรี\nนราธิวาส\nน่าน\nบึงกาฬ\nบุรีรัมย์\nปทุมธานี\nประจวบคีรีขันธ์\nปราจีนบุรี\nปัตตานี\nพะเยา\nพังงา\nพัทลุง\nพิจิตร\nพิษณุโลก\nเพชรบุรี\nเพชรบูรณ์\nแพร่\nภูเก็ต\nมหาสารคาม\nมุกดาหาร\nแม่ฮ่องสอน\nยโสธร\nยะลา\nร้อยเอ็ด\nระนอง\nระยอง\nราชบุรี\nลพบุรี\nลำปาง\nลำพูน\nเลย\nศรีสะเกษ\nสกลนคร\nสงขลา\nสตูล\nสมุทรปราการ\nสมุทรสงคราม\nสมุทรสาคร\nสระแก้ว\nสระบุรี\nสิงห์บุรี\nสุโขทัย\nสุพรรณบุรี\nสุราษฎร์\nสุราษฎร์ธานี\nสุรินทร์\nหนองคาย\nหนองบัวลำภู\nอยุธยา\nอ่างทอง\nอำนาจเจริญ\nอุดรธานี\nอุตรดิตถ์\nอุทัยธานี\nอุบลราชธานี\nกันทรลักษ์\nจตุจักร\nไชยา\nซีคอน\nดอนเมือง\nถลาง\nไทรโยค\nธนบุรี\nธัญบุรี\nบางกอก\nบางปะกง\nบางระจัน\nปะทิว\nปาย\nพญาไท\nพัฒน์พงษ์\nพัทยา\nพารากอน\nภูมิซรอล\nรัตนาธิเบศร์\nรังสิต\nลันตา\nลาดพร้าว\nวโรรส\nวิภาวดี\nสตึก\nสมุย\nสัตหีบ\nสิมิลัน\nสุขุมวิท\nสุไหง\nเสลภูมิ\nอังรีดูนังต์\nอ่างขาง\nอินทนนท์\nเอ็มโพเรียม\n\nคิวชู\nแคริบเบียน\nแคสเปียน\nดานูบ\nตะนาวศรี\nนอร์วีเจียน\nนิโคบาร์\nเนรัญชรา\nไนล์\nบอร์เนียว\nบอลติก\nเบงกอล\nปิง\nแปซิฟิก\nมะละกา\nมินดาเนา\nมิสซิสซิปปี\nเมดิเตอร์เรเนียน\nเมโสโปเตเมีย\nยมุนา\nยุโรป\nยูเรเชีย\nยูเรเซีย\nแยงซี\nแยงซีเกียง\nสแกนดิเนเวีย\nสะโตง\nสาละวิน\nสุมาตรา\nสุเอซ\nอะเมซอน\nอันดามัน\nอัลไต\nอาร์กติก\nอาหรับ\nอินโดจีน\nอิรวดี\nอิระวดี\nอีเจียน\nอุษาคเณย์\nอูราล\nเอเชีย\nเอเดรียติก\nเอเวอเรสต์\nแอตแลนติก\nแอนตาร์กติก\nแอนตาร์กติกา\nแอฟริกา\nโอลิมปัส\nไอโอเนียน\nฮวงโห\nฮอกไกโด\nฮอนชู\n\nกบิลพัสดุ์\nกุสินารา\nโกลิยะ\nโกสัมพี\nโคตรบอง\nโคตรบูรณ์\nตองอู\nทรอย\nทวารวดี\nทวาราวดี\nเทวทหะ\nไทรบุรี\nนาลันทา\nไบแซนไทน์\nปรัสเซีย\nปัลลวะ\nปาฏลีบุตร\nพุทธคยา\nมถุรา\nมายัน\nมิถิลา\nราชคฤห์\nล้านช้าง\nล้านนา\nลุมพินี\nวัชชี\nเวสาลี\nสารนาถ\nสาวัตถี\nหริภุญชัย\nอโยธยา\nออตโตมัน\nอังวะ\nอินทปัตถ์\nอุชเชนี\n\nกราฟิก\nกราฟิกส์\nกราฟิค\nกริด\nกิกะไบต์\nกูเกิล\nกูเกิ้ล\nเกตเวย์\nโกลบอล\nคลัสเตอร์\nคลาส\nคลิก\nคลิปอาร์ต\nคอนโซล\nคอนเทนต์\nคอมพิวติ้ง\nคอมไพล์\nคอมไพเลอร์\nคอมมูนิเคชั่น\nคอร์\nคีย์\nคีย์บอร์ด\nเครือข่าย\nเคอร์เซอร์\nเคอร์เนล\nแคช\nแคมฟรอก\nแคมฟร็อก\nแคร็ก\nโค้ด\nจาวา\nจีพีเอส\nชิป\nชิพ\nเชลล์\nแช็ต\nแชนเนล\nแชนแนล\nซ็อกเก็ต\nซอฟต์แวร์\nซอฟท์แวร์\nซอร์ส\nซัพพอร์ต\nซัพพอร์ท\nซีดี\nซีดีรอม\nซีเนอร์\nเซิร์ฟเวอร์\nโซลูชัน\nโซลูชั่น\nไซต์\nไซเบอร์\nทรานแซกชัน\nทรานแซกชั่น\nทรานแซ็กชัน\nทรานแซ็กชั่น\nทรานแซคชัน\nทรานแซคชั่น\nทรานแซ็คชัน\nทรานแซ็คชั่น\nทวิตเตอร์\nทวีต\nทัชแพด\nเทมเพลต\nเทอร์มินัล\nแท็ก\nแท็บ\nแทบเล็ต\nโทรจัน\nเน็ต\nเน็ตบุ๊ก\nเน็ตบุค\nเน็ตบุ๊ค\nเน็ตเวิร์ก\nเน็ตเวิร์ค\nโน้ตบุ๊ก\nโน้ตบุค\nโน้ตบุ๊ค\nดอส\nดาวน์เกรด\nดาวน์โหลด\nดิจิตอล\nดิจิทัล\nดีบั๊ก\nดีวีดี\nดีไวซ์\nเดเบียน\nเดลไฟ\nเดสก์ท็อป\nโดเมน\nไดรว์\nไดรเวอร์\nไดเรกทอรี\nไดโอด\nเทเลคอม\nบล็อกเกอร์\nบรอดแบนด์\nบราวเซอร์\nบลูทูท\nบลูทูธ\nบลูเรย์\nบั๊ก\nบัฟเฟอร์\nบิต\nบิท\nบูต\nเบราว์เซอร์\nแบนด์วิดท์\nไบต์\nไบนารี\nโปรแกรมเมอร์\nโปรเซส\nโปรเซสเซอร์\nโปรโตคอล\nพร็อกซี\nพอร์ต\nพอร์ท\nพาเนล\nพาร์ทิชัน\nพารามิเตอร์\nพาสเวิร์ด\nพิกเซล\nเพจ\nเพจเจอร์\nแพกเก็ต\nแพตช์\nแพลตฟอร์ม\nโพรเซส\nโพรเซสเซอร์\nโพรโทคอล\nไพธอน\nฟล็อปส์\nฟอนต์\nฟอร์แมต\nฟอร์เวิร์ด\nฟอรัม\nฟีเจอร์\nเฟซบุ๊ก\nเฟิร์มแวร์\nแฟล็ก\nโฟลเดอร์\nไฟร์ฟอกซ์\nไฟร์วอลล์\nไฟล์\nมอดูล\nมอนิเตอร์\nมัลติ\nมัลติทัช\nมัลติเพล็กซ์\nมัลแวร์\nมาสเตอร์\nมีเดีย\nเมนู\nเมมโมรี\nเมล\nเมาส์\nแมค\nโมดูล\nโมเด็ม\nโมบาย\nโมบายล์\nโมไบล์\nไมโครซอฟท์\nยูนิกซ์\nยูนิโคด\nยูนิโค้ด\nริงโทน\nรีเฟรช\nรีเลย์\nเราเตอร์\nเรียลไทม์\nลิงก์\nลินุกซ์\nลีนุกซ์\nลูป\nเลเยอร์\nแล็ปท็อป\nไลเซนส์\nไลบรารี\nวิกิ\nวิกิพีเดีย\nวินโดวส์\nวินโดว์ส\nเว็บ\nเวอร์ชวล\nเวอร์ชัน\nเวอร์ชั่น\nเวิร์กสเตชัน\nเวิร์กสเตชั่น\nเวิร์คสเตชัน\nเวิร์คสเตชั่น\nเวิร์ด\nเวิร์ม\nไวแมกซ์\nสกรีน\nสแกน\nสแกนเนอร์\nสแต็ก\nสนิฟเฟอร์\nสปายแวร์\nสเปซ\nสแปม\nสมาร์ท\nสล็อต\nเสิร์ช\nโหลด\nออนไลน์\nออปติก\nออปติคอล\nออปติคัล\nออฟไลน์\nออราเคิล\nอัพเกรด\nอัพเดต\nอัพโหลด\nอัปเกรด\nอัปเดต\nอัปโหลด\nอัลกอริทึม\nอาร์กิวเมนต์\nอินเตอร์เน็ต\nอินทิเกรเตอร์\nอินเทอร์เน็ต\nอินเทอร์เฟซ\nอินเทล\nอินพุต\nอินพุท\nอีเมล\nอีเมล์\nอูบุนตู\nอูบันตู\nเอนจิน\nเอ็นจิน\nเอาต์พุต\nเอาต์พุท\nเอาท์พุต\nเอาท์พุท\nแอนะล็อก\nแอนิเมชัน\nแอนิเมชั่น\nแอปพลิเคชัน\nแอปพลิเคชั่น\nแอพพลิเคชัน\nแอพพลิเคชั่น\nแอสเซมบลี\nแอสเซมเบลอร์\nโอเพน\nไอคอน\nไอซี\nไอพอด\nไอพ็อด\nไอแพด\nไอโฟน\nฮับ\nฮาร์ดดิสก์\nฮาร์ดแวร์\nแฮกเกอร์\nแฮ็กเกอร์\nแฮนด์เฮลด์\nโฮสต์\n\nกรีก\nกัณณาฑ\nกัศมีรี\nคันจิ\nคาตาคานะ\nคุชราตี\nคุรุมุขี\nซีริลลิก\nซูลู\nเซลติก\nเซิร์บ\nตากาล็อก\nเตลุคู\nเติร์ก\nทราวิฑ\nเบงกาลี\nปัญจาบี\nพินอิน\nมลยาฬัม\nมองโกล\nมาราฐี\nมาเลย์\nเม็กซิกัน\nแมนจู\nแมนดาริน\nไมถิลี\nเยอรมัน\nรัสเซียน\nสวาฮิลี\nสวิส\nสินธี\nอูรดู\nอัสสมี\nอารบิก\nอิตาเลียน\nอุยกูร์\nแอฟริกัน\nโอริยา\nไอริช\nฮันกึล\nฮินดี\nฮิรางานะ\nฮีบรู\n\nกรีนพีซ\nกรือเซะ\nกวนอิม\nกวนอู\nกัดดาฟี\nกัลยาณวัตร\nกัสสปะ\nกาลิเลโอ\nกินเนส\nกุมภกรรณ\nกูเตนเบิร์ก\nเกตส์\nเกษมณี\nโกณฑัญญะ\nขงเบ้ง\nคริสโตเฟอร์\nคองคอร์ด\nคอลเกต\nคานธี\nคาเบรียล\nคาร์ฟูร์\nคาร์สัน\nคาราบาว\nคาสิโอ\nคิริน\nคุนลุ้น\nคูโบต้า\nเครมลิน\nแคทรีนา\nโคตมะ\nโคตมี\nโคลัมบัส\nไคฟง\nไครสเลอร์\nง้อไบ๊\nจตุพร\nจ็อบส์\nจอห์น\nจิ้น\nจิม\nจิ๋ม\nจิว\nจุฬาภรณ์\nจุฬาลงกรณ์\nเจมส์\nแจ็กสัน\nโจเซฟ\nโจว\nชมัยมรุเชฐ\nชมัยมรุเชษฐ์\nชเวดากอง\nชาร์ลส์\nชินราช\nชินวัตร\nชุนชิว\nเช็ง\nเชตวัน\nเชฟรอน\nเชฟโรเลต\nเชลซี\nไชยานุชิต\nซ่ง\nซังฮี้\nซัดดัม\nซันซิล\nซัมซุง\nซัวเจ๋ง\nซินหัว\nซีซาร์\nซีแพค\nซูซาน\nซูซูกิ\nซูบารุ\nเซ็นทารา\nเซเวน\nเซเว่น\nโซฟิเทล\nโซยุซ\nโซยูซ\nณัฐวุฒิ\nดาร์ลี่\nดาวโจนส์\nดิสนีย์\nดีแทค\nดูปองท์\nเดโมแครต\nเดลล์\nเดลินิวส์\nเดวิด\nแดวู\nโดนัลด์\nโดราเอมอน\nโดเรมอน\nต๋อง\nตั๊กม้อ\nตากสิน\nตาเมือน\nตาลีบัน\nตูน\nเตมีย์\nโต๋\nโตชิบา\nโตโยต้า\nถังซัมจั๋ง\nถังซำจั๋ง\nทรพา\nทราเวล\nทรูมูฟ\nทีปังกร\nเทปโก\nเทพรัตน\nเทวทัต\nเทสโก้\nโทมัส\nไททานิก\nไททานิค\nไทยรัฐ\nธีออส\nนครินทรา\nนโปเลียน\nนพดล\nนราดูร\nนเรนทร\nนอสตราดามุส\nนาซา\nนาซ่า\nนาซี\nนาโต\nนาโต้\nนาลแก\nนิคอน\nนิโคลัส\nนิด้า\nนินเทนโด\nนิปปอน\nนิวตัน\nนิสสัน\nเนคเทค\nเนชั่น\nเนชันแนล\nเนชั่นแนล\nเนวิน\nเนสเล่\nเนสาด\nแนท\nแนสแดค\nโนเกีย\nโนเบล\nโนเวลล์\nโนโวเทล\nไนเม็กซ์\nบรอดเวย์\nบรัดเลย์\nบรู๊ซ\nบัลเมอร์\nบารัก\nบารัค\nบู๊ตึ๊ง\nเบญกาย\nเบนซ์\nเบ็นซ์\nเบนจามิน\nโบตัน\nไบโอเทค\nประชาธิปัตย์\nปวีณา\nปอเต็กตึ๊ง\nปอเต๊กตึ๊ง\nป่อเต็กตึ๊ง\nปัตตะโชติ\nปารุสก์\nปีเตอร์\nปูติน\nเป๊ปซี่\nเป้ย\nเปอร์โยต์\nเปาบุ้นจิ้น\nโปเกมอน\nโป๊ยก่าย\nพรหมทัต\nพลาโต\nพอลล่า\nพานาโซนิค\nพานาโซนิก\nพิทยานุกูล\nพิมพิสาร\nเพนแทกซ์\nเพลโต\nไพโอเนียร์\nฟรอยด์\nฟรังซิส\nฟรานซิส\nฟลอเรนซ์\nฟอร์ด\nฟิลิปส์\nฟูจิ\nแฟซ่า\nโฟร์โมสต์\nภูมิพล\nภูริทัต\nมงฟอร์ต\nมณโฑ\nมติชน\nมหิตลาธิเบศร\nมโหสถ\nมัจฉานุ\nมาร์กาเร็ต\nมาร์ติน\nมาสด้า\nมิตซูบิชิ\nมิราเคิล\nมุสโสลินี\nเม้ง\nเมจิ\nเมอร์ซีเดส\nเมอร์เซเดส\nแมกซ์เวลล์\nแมกไซไซ\nแมคอินทอช\nแมชีนเนอรี่\nโมคคัลลานะ\nโมโตโรลา\nโมโตโรล่า\nโมเนีย\nไมเคิล\nไมยราพณ์\nยโสธรา\nยะโฮวา\nยะโฮวาห์\nยามาฮ่า\nยาเวห์\nยาฮู\nยูนิเซฟ\nยูเนสโก\nยูไล\nเยโฮวาห์\nรอยเตอร์\nรอยัล\nรัชดา\nรัสปูติน\nราฟาเอล\nรามาวตาร\nราเมศวร\nราหุล\nริชาร์ด\nรีพับลิกัน\nรูนีย์\nเรนโบว์\nแรมโบ้\nโรตารี\nโรนัลโด\nโรนัลโด้\nโรบินสัน\nโรเบิร์ต\nล็อกซเล่ย์\nลิงคอล์น\nลิจฉวี\nลิไท\nลิไทย\nลินคอล์น\nลิเวอร์พูล\nเลโนโว\nเลียดก๊ก\nโลตัส\nวชิราลงกรณ์\nวลาดิเมียร์\nวอลล์สตรีท\nวาเลนไทน์\nวิกตอเรีย\nวิทยานุสรณ์\nวิทยายน\nวิมเบิลดัน\nวิลเลียม\nวีระ\nวุฒิชัย\nเวียดกง\nไวตามิลค์\nศกุนตลา\nศรีวิชัย\nศิริพงษ์\nศิริราช\nศุภชลาศัย\nสดกก๊อกธม\nสดายุ\nสตาลิน\nสตีฟ\nสแตนฟอร์ด\nสวรินทิรา\nสังกัจจายน์\nสาทิตย์\nสารีบุตร\nสิริกิติ์\nสิรินธร\nสิหิงค์\nสีวลี\nสีหนุ\nสีหมุนี\nสีหโมนี\nสุครีพ\nสุทโธทนะ\nสุเทพ\nสุนทราภรณ์\nสุนีย์\nสุรนารี\nสุรยุทธ์\nสุริยาสน์\nเส้าหลิน\nโสกราตีส\nโสภิต\nหนุมาน\nหลินฮุ่ย\nหลุยส์\nเห้งเจีย\nไหหม่า\nองคต\nองคุลิมาล\nอชาตศัตรู\nอดุลยเดช\nอพอลโล\nอริสโตเติล\nอริสมันต์\nอลิซาเบธ\nอ๋อม\nออร์คิด\nออสการ์\nอะพอลโล\nอับราฮัม\nอั้ม\nอัลกออิดะห์\nอัลคาเทล\nอัลจาซีราห์\nอัลเฟรด\nอัลเลาะห์\nอัสซุส\nอัสสชิ\nอัสสัมชัญ\nอาเซม\nอาเซ็ม\nอาเซียน\nอาฟต้า\nอาร์เซนอล\nอินทรชิต\nอินทราทิตย์\nอีซูซุ\nอีเลฟเวน\nอีเลฟเว่น\nอุณรุท\nอุบลรัตน์\nอุบาลี\nอุ๋ย\nเอกทัศน์\nเอเซอร์\nเอ็ดเวิร์ด\nเอดิสัน\nเอแบค\nเอลิซาเบธ\nเอสพลานาด\nเอสพลานาร์ด\nแอคคอร์\nแอคคอร์ด\nแองเจลิน่า\nแอตแลนติส\nแอน\nแอ๋ม\nแอมบาสซาเดอร์\nแอมบาสเดอร์\nแอมเวย์\nแอ๋ว\nโอดีสซีย์\nโอเดียน\nโอบามา\nโอรสาราม\nโอลิมเปีย\nโออิชิ\nไอน์สไตน์\nฮอนด้า\nฮอปกินส์\nฮอลลีวูด\nฮอลลีวู้ด\nฮานามิ\nฮามาส\nฮิตเลอร์\nฮิตาชิ\nฮุนเซน\nฮุนเซ็น\nฮุนได\nฮุสเซ็น\nเฮนรี\nเฮนรี่\nเฮเลน\nโฮจิมินห์\nโฮปเวลล์\nโฮเมอร์\n\nกลีเซอรีน\nกำทอน\nแกนีมีด\nครอส\nคริสตัล\nคลอโรพลาสต์\nคลอไรด์\nควอนตัม\nคอนดักเตอร์\nคอปเปอร์\nคอลลาเจน\nคอเลสเตอรอล\nคอสมิก\nคูลอมบ์\nเคอราติน\nแคโรทีน\nแคสสินี\nโครมาโทกราฟี\nไคโตซาน\nจีโนม\nจุลชีววิทยา\nชิคุนกุนยา\nซัลฟิวริก\nซัลเฟต\nซัลไฟด์\nซิงค์\nซิริอุส\nซิลิกา\nซิลิเกต\nซิลิโคน\nซีเทน\nซีเวิร์ต\nเซ็กเตอร์\nเซ็กเมนต์\nเซมิ\nโซนาร์\nไซบอร์ก\nดอปเปลอร์\nดอปเพลอร์\nไดนามิก\nไดนามิกส์\nไดนามิค\nไดนามิคส์\nไดออกไซด์\nทรานส์\nทามิฟลู\nเทฟลอน\nเทสโทสเตอโรน\nเทอร์โม\nแทนนิน\nไททัน\nไทฟอยด์\nไทรอยด์\nธาลัสซีเมีย\nเนกาตีฟ\nโนวา\nบอแรกซ์\nโบทอกซ์\nโบท็อกซ์\nไบโอติน\nปฏิยานุพันธ์\nโปรเจสเตอโรน\nพอลิเมอร์\nพันธุศาสตร์\nพัลซาร์\nพาร์กินสัน\nพาราเซตามอล\nพาราโบลา\nเพอร์ออกไซด์\nโพรเจสเทอโรน\nโพลาไรซ์\nโพลิเมอร์\nโพลีเอทิลีน\nไพรเมต\nฟลาโวนอยด์\nฟลูออเรสเซนซ์\nฟลูออไรด์\nฟอสซิล\nฟิชชัน\nฟิวชัน\nฟีโรโมน\nไฟเบอร์\nมอนอกไซด์\nมิราจ\nเมตริกซ์\nเมทริกซ์\nเมลานิน\nเมลามีน\nโมเมนตัม\nไมโตคอนเดรีย\nไมโทคอนเดรีย\nยีสต์\nยูริก\nยูเรีย\nรูมาตอยด์\nวีก้า\nเวกเตอร์\nเวก้า\nเวสิเคิล\nโวลต์\nสเกล\nสเกลาร์\nสเต็ม\nสเตียรอยด์\nสปีชีส์\nสเปิร์ม\nสัมพัทธภาพ\nสุริยจักรวาล\nออกเทน\nออโรรา\nออโรร่า\nอะคริลิก\nอะครีลิก\nอะซีติก\nอะซีโตน\nอะมิโน\nอะลูมินา\nอันโดรเมดา\nอัลคาไลน์\nอัลตราซาวด์\nอัลตราซาวนด์\nอัลลอยด์\nอินทิกรัล\nอินทิเกรต\nอีโบลา\nอีโบล่า\nเอ็กซ์โพเนนเชียล\nเอทานอล\nเอทิลีน\nเอนโทรปี\nเอสเตอร์\nเอสโตรเจน\nเอสโทรเจน\nแอนดรอยด์\nแอนแทร็กซ์\nแอมพลิจูด\nแอมโมเนียม\nแอลกอฮอลิซึม\nแอสพาร์แตม\nโอเซลทามิเวียร์\nฮับเบิล\nฮิวมัส\nไฮดรอกไซด์\nไฮดรอลิก\nไฮโดรลิก\nไฮเพอร์โบลา\n\nกงเต็ก\nกฎุมพี\nกฏ\nกฏหมาย\nกบฎ\nกราไฟต์\nก๊อปปี้\nกะทะ\nกังวาล\nกุฎฐัง\nกุฏุมพี\nฃวด\nคฑา\nคลินิค\nคลีนิก\nคลีนิค\nคาทอลิค\nคึ่นฉ่าย\nแคตตาล็อก\nโควต้า\nฅน\nจุมพฎ\nช็อคโกแลต\nแซ่ด\nดัทช์\nทนง\nทรมาณ\nทราก\nทะแยง\nทิฏฐิ\nบล็อค\nบ๊องแบ๊ว\nบัลเล่ต์\nเบรค\nแบงค์\nปรากฎ\nปัคคหะ\nปาฏิโมกข์\nปิติ\nปิรามิด\nโปรเตสแตนท์\nพนิช\nพยักเพยิด\nพริ้ว\nพลูโตเนียม\nพากษ์\nเฟิร์น\nยากี้\nเยภุยยสิกา\nรุสเซีย\nฤาษี\nล็อค\nล็อคเกอร์\nวันทยาหัตถ์\nวานิช\nวิญญาน\nวิศิษฐ์\nศรีษะ\nสเปกโทรสโคป\nสฤษฎ์\nสลิ่ม\nสัตตสดก\nสาราณียากร\nสุกี้\nสุกี้ยากี้\nสูญญากาศ\nหยอมแหยม\nหยอย\nหล่ะ\nอะดรีนาลีน\nอะหลั่ย\nอัตคัต\nอัฟริกา\nอานิสงค์\nอาฟริกา\nอิริยาบท\nอิเลคโทรนิคส์\nอีรุงตุงนัง\nอุตรายัน\nอุลตรา\nอุลตร้า\nโอกาศ\n\nกกหู\nกงการ\nกงจักร\nกฎเกณฑ์\nกฎบัตร\nกฎหมาย\nกฎหมู่\nกดขี่\nกดดัน\nก้นกบ\nก้นบึ้ง\nก้นปล่อง\nกนิษฐภคินี\nกนิษฐภาดา\nกรงเล็บ\nกรมการ\nกรมท่า\nกรมธรรม์\nกรมนา\nกรมวัง\nกรรมกร\nกรรมการ\nกรรมฐาน\nกรรมบถ\nกรรมพันธุ์\nกรรมวิธี\nกรรมสิทธิ์\nกระจกเงา\nกระจกตา\nกระจกนูน\nกระจกเว้า\nกระจอกชวา\nกระจอกเทศ\nกระจ้อยร่อย\nกระจับบก\nกระจับปิ้ง\nกระจับปี่\nกระโชกโฮกฮาก\nกระดานดำ\nกระดานหก\nกระดาษแก้ว\nกระดาษไข\nกระดาษทราย\nกระดาษสา\nกระดูกงู\nกระทาชาย\nกระเท่เร่\nกระบวนการ\nกระบองเพชร\nกระผีกริ้น\nกระยาทิพย์\nกระยาสารท\nกระยาหาร\nกระสอบทราย\nกระสุนปืน\nกระแสจิต\nกระแสน้ำ\nกระแสลม\nกรับคู่\nกรับพวง\nกรับเสภา\nกราดเกรี้ยว\nกราวรูด\nกริ่งเกรง\nกรีฑาสถาน\nกรีดกราย\nกรี๊ดกร๊าด\nกลไก\nกลบท\nกลเม็ด\nกลยุทธ์\nกลวิธี\nกลศาสตร์\nกลอักษร\nกลบเกลื่อน\nกลมกล่อม\nกลมกลืน\nกลมเกลียว\nกล้วยแขก\nกล้วยไม้\nกล่องเสียง\nกล่อมเกลา\nกล่อมเกลี้ยง\nกลัดกลุ้ม\nกลัดมัน\nกลั่นกรอง\nกลั่นแกล้ง\nกลับกลอก\nกลางคน\nกลางคัน\nกลางค่ำ\nกลางคืน\nกลางแจ้ง\nกลางแปลง\nกลางวัน\nกลาดเกลื่อน\nกล่าวขวัญ\nกล่าวโทษ\nกล่าวหา\nกล้ำกราย\nกล้ำกลืน\nกลิ้งกลอก\nกลิ้งเกลือก\nกลิ่นอาย\nกลียุค\nกวดขัน\nกวัดแกว่ง\nกวัดไกว\nกวีนิพนธ์\nก่อกวน\nก่อการ\nก่อตั้ง\nก่อสร้าง\nก่อหวอด\nก้อร่อก้อติก\nกองกลาง\nกองเกิน\nกองโจร\nกองทัพ\nกองทุน\nกองพล\nกองพัน\nกองฟอน\nกองร้อย\nกองหนุน\nกอบโกย\nกะเกณฑ์\nกะบังลม\nกักกัน\nกักขัง\nกักตัว\nกักตุน\nกัณฑ์เทศน์\nกัดฟัน\nกันชน\nกันท่า\nกันสาด\nกันเอง\nกับแกล้ม\nกับข้าว\nกับระเบิด\nกากเพชร\nกากหมู\nกาชาด\nกาญจนาภิเษก\nก้านคอ\nกาฝาก\nก้ามกราม\nกามกิจ\nกามคุณ\nกามเทพ\nกามโรค\nก้ามปู\nกายกรรม\nกายบริหาร\nกายภาพ\nกายวิภาค\nกายสิทธิ์\nก่ายกอง\nการคลัง\nการเงิน\nการบ้าน\nการเปรียญ\nการเมือง\nการเรือน\nการละเล่น\nกาลกิริยา\nกาลเทศะ\nก้าวก่าย\nก้าวร้าว\nก้าวหน้า\nกาสาวพัสตร์\nกาฬพฤกษ์\nกาฬโรค\nกำปั้น\nกำมือ\nกำแพงขาว\nกำลังใจ\nกำลังม้า\nกี่งอำเภอ\nกิจกรรม\nกิจการ\nกิจวัตร\nกิจจะลักษณะ\nกิตติคุณ\nกิตติศัพท์\nกินขาด\nกินใจ\nกินดอง\nกินโต๊ะ\nกินแบ่ง\nกินเปล่า\nกินเลี้ยง\nกินเส้น\nกินแหนง\nกิโลกรัม\nกิโลเมตร\nกิโลลิตร\nกิโลเฮิรตซ์\nกีดกัน\nกีดกั้น\nกีดขวาง\nกึกก้อง\nกึกกัก\nกึกกือ\nกึ่งกลาง\nกุกกัก\nกุ๊กกิ๊ก\nกุ้งฝอย\nกุ้งมังกร\nกุ้งแห้ง\nกุ้งเต้น\nกุ้งยิง\nกุญแจผี\nกุญแจมือ\nกุญแจเลื่อน\nกุญแจเสียง\nกุลธิดา\nกุลบุตร\nกุลสตรี\nกู้ยืม\nเก้งก้าง\nเก็บกวาด\nเก็บเกี่ยว\nเก็บงำ\nเก็บตก\nเกรงกลัว\nเกรงใจ\nเกรงขาม\nเกรียงไกร\nเกรียมกรม\nเกรี้ยวกราด\nเกล็ดเลือด\nเกลี้ยกล่อม\nเกลี้ยงเกลา\nเกลือกกลั้ว\nเกลือกกลิ้ง\nเกลื่อนกล่น\nเกลื่อนกลาด\nเกศธาตุ\nเกษตรกร\nเกษตรกรรม\nเกษตรศาสตร์\nเกษมสันต์\nเกษียรสมุทร\nเก้อเขิน\nเกาะแกะ\nเกี่ยงงอน\nเกียจคร้าน\nเกียรติคุณ\nเกียรตินิยม\nเกียรติประวัติ\nเกียรติภูมิ\nเกียรติยศ\nเกียรติศักดิ์\nเกียรติมุข\nเกี่ยวข้อง\nเกี่ยวดอง\nเกี่ยวพัน\nเกี่ยวโยง\nเกี้ยวพาน\nเกี้ยวพาราสี\nแก่แดด\nแก้ขัด\nแก้ไข\nแก้ตัว\nแก้เผ็ด\nแก้ลำ\nแกงคั่ว\nแกงจืด\nแกงบวด\nแกงป่า\nแกงเผ็ด\nแกงส้ม\nแก่งแย่ง\nแก่นแก้ว\nแก่นสาร\nแก้วตา\nแก้วหู\nแกว่งกวัด\nแกว่งไกว\nแกะรอย\nโก้เก๋\nโกรธเกรี้ยว\nโกรธขึ้ง\nไก่เขี่ย\nไก่ชน\nไก่บ้าน\nไก่ป่า\nไก่ฟ้า\nไกล่เกลี่ย\nขจัดขจาย\nขนเพชร\nขนสัตว์\nขนหนู\nขนส่ง\nขนมจีน\nขบขัน\nขบวนการ\nข่มขี่\nข่มขู่\nข่มขืน\nข่มเหง\nขมหิน\nขมิ้นชัน\nขมุบขมิบ\nขยะแขยง\nขยักขย่อน\nขยักขย้อน\nขยับขยาย\nขยับเขยื้อน\nขวดโหล\nขวยเขิน\nขวัญใจ\nขวัญตา\nขวัญอ่อน\nขวากหนาม\nขวางโลก\nของ้าว\nขอสับ\nขอขมา\nขอทาน\nขอโทษ\nขอร้อง\nขออภัย\nข้อเขียน\nข้อความ\nข้อเท็จจริง\nของกลาง\nของขวัญ\nของแข็ง\nของชำ\nของลับ\nของเล่น\nของว่าง\nของเหลว\nของไหล\nของไหว้\nข้องใจ\nข้องแวะ\nขอบข่าย\nขอบเขต\nขอบคุณ\nขอบใจ\nขอบพระคุณ\nข้อมูล\nข้อแม้\nข้อหา\nข้อสังเกต\nขัดข้อง\nขัดขืน\nขัดเขิน\nขัดจังหวะ\nขัดดอก\nขัดแตะ\nขัดยอก\nขัดแย้ง\nขัดสมาธิ\nขันหมาก\nขันอาสา\nขับขี่\nขับเคี่ยว\nขั้วโลก\nขาจร\nขาประจำ\nข้าราชการ\nข้าศึก\nข้าหลวง\nขาดแคลน\nขาดใจ\nขาดตอน\nขาดตัว\nขาดทุน\nขาดเหลือ\nขายหน้า\nข่าวกรอง\nข่าวคราว\nข่าวล่า\nข่าวลือ\nข่าวสาร\nข้าวเกรียบ\nข้าวแกง\nข้าวของ\nข้าวจี่\nข้าวเจ้า\nข้าวซอย\nข้าวต้ม\nข้าวตอก\nข้าวตัง\nข้าวแตน\nข้าวทิพย์\nข้าวบิณฑ์\nข้าวเปลือก\nข้าวโพด\nข้าวฟ่าง\nข้าวเม่า\nข้าวสวย\nข้าวสาร\nข้าวเหนียว\nข้าวหมาก\nข้าวหลาม\nขี้เกียจ\nขี้ข้า\nขี้ครอก\nขี้คร้าน\nขี้คุก\nขี้ไคล\nขี้เซา\nขีดขั้น\nขีดคร่อม\nขีดคั่น\nขีดฆ่า\nขี้ตา\nขี้ตืด\nขี้เถ้า\nขี้ทูด\nขี้ปะติ๋ว\nขี้ผึ้ง\nขี้มูก\nขี้ยา\nขี้แย\nขี้ริ้ว\nขี้เรื้อน\nขี้เล็บ\nขี้หู\nขี้หน้า\nขี้เหนียว\nขี้เหล็ก\nขี้เหร่\nขึงขัง\nขึงพืด\nขึ้งโกรธ\nขึ้นใจ\nขึ้นชื่อ\nขึ้นมือ\nขืนใจ\nขื่นขม\nขุดคุ้ย\nขุนทอง\nขุนนาง\nขุนพล\nขุนศึก\nขุนหลวง\nขูดรีด\nเข็มกลัด\nเข็มขัด\nเข้มข้น\nเข้มแข็ง\nเข้มงวด\nเข็มทิศ\nเข็มหมุด\nเข้าขา\nเข้าเค้า\nเข้าใจ\nเข้าชื่อ\nเข้าตัว\nเข้าถึง\nเข้าทรง\nเข้าท่า\nเข้าที\nเข้าเนื้อ\nเข้าเล่ม\nเขียวเสวย\nเขียวหวาน\nแขกเต้า\nแข็งกร้าว\nแข็งกล้า\nแข็งแกร่ง\nแข็งข้อ\nแข็งขัน\nแข่งขัน\nแข็งใจ\nแข็งตัว\nแข็งเมือง\nแข็งแรง\nแขวนลอย\nโขกสับ\nโขยกเขยก\nไขข้อ\nไขควง\nไขมัน\nไข่มุก\nไขว่ห้าง\nไขสันหลัง\nไขสือ\nไข่เค็ม\nไข่เยี่ยวม้า\nไข่หงส์\nไข่เหี้ย\nคงกระพัน\nคงตัว\nคงทน\nคงที่\nคชลักษณ์\nคชสาร\nคชสีห์\nคชราช\nคณิตศาสตร์\nคดเคี้ยว\nคติธรรม\nคติพจน์\nคนกลาง\nคนไข้\nคนใช้\nคนทรง\nคบไฟ\nคบเพลิง\nคบค้า\nคบคิด\nคบหา\nคมคาย\nครบครัน\nครบถ้วน\nครอบครอง\nครอบคลุม\nครอบครัว\nครอบงำ\nครอบจักรวาล\nคริสตกาล\nคริสตจักร\nคริสต์มาส\nคริสต์ศตวรรษ\nคริสต์ศักราช\nคริสตัง\nคริสเตียน\nครุกรรม\nครุภัณฑ์\nครุศาสตร์\nครุฑพ่าห์\nครุ่นคิด\nคลอเคลีย\nคล่องแคล่ว\nคล่องตัว\nคล่องมือ\nคลั่งไคล้\nคลาคล่ำ\nคลาไคล\nคลาดเคลื่อน\nคลาดแคล้ว\nคลี่คลาย\nคลึงเคล้น\nคลึงเคล้า\nคลื่นไส้\nคลื่นเหียน\nคลุกคลี\nคลุกคลาน\nคลุมเครือ\nคลุมโปง\nคลุ้มคลั่ง\nควงสว่าน\nควบคุม\nควบคู่\nควบแน่น\nควันหลง\nความคิด\nความหลัง\nความเห็น\nคอหอย\nคอห่าน\nคอแห้ง\nค่อนขอด\nค่อนแคะ\nค้อนควัก\nคั่งค้าง\nคั่งแค้น\nคัดค้าน\nคัดง้าง\nคัดท้าย\nคัดเลือก\nคันจาม\nคันฉ่อง\nคันฉาย\nคันชัก\nคันชั่ง\nคันไถ\nคันนา\nคันเร่ง\nคับขัน\nคับคั่ง\nคับแค้น\nคับแคบ\nคางทูม\nคางหมู\nค้างคืน\nค้างปี\nคาดคั้น\nคาดเชือก\nคาดโทษ\nคาดหมาย\nคานหาม\nคาบเกี่ยว\nคาบศิลา\nคาบสมุทร\nคำขาด\nคำนำ\nคิดค้น\nคืนดี\nคืนตัว\nคุกเข่า\nคุณค่า\nคุณชาย\nคุณธรรม\nคุณนาย\nคุณภาพ\nคุณลักษณะ\nคุณวุฒิ\nคุณศัพท์\nคุณสมบัติ\nคุณหญิง\nคุณากร\nคุณูปการ\nคุโณปการ\nคุมเชิง\nคุ้มกัน\nคุยเขื่อง\nคุยโต\nคุ้ยเขี่ย\nคุ้มครอง\nคู่กรณี\nคู่กัด\nคู่ขา\nคู่แข่ง\nคู่ครอง\nคู่ควร\nคู่คิด\nคู่คี่\nคู่ใจ\nคู่ชีพ\nคู่ชีวิต\nคู่บารมี\nคู่บุญ\nคู่ปรปักษ์\nคู่ปรับ\nคู่ผสม\nคู่มือ\nคู่รัก\nคู่ลำดับ\nคู่สาย\nคู่หมั้น\nคู่หู\nคู่อริ\nคู่อาฆาต\nเคมีภัณฑ์\nเคยตัว\nเคร่งขรึม\nเคร่งครัด\nเคร่งเครียด\nเครดิตฟองซิเอร์\nเครื่องกล\nเครื่องกัณฑ์\nเครื่องแกง\nเครื่องเขิน\nเครื่องครัว\nเครื่องเคียง\nเครื่องเงิน\nเครื่องจักร\nเครื่องเซ่น\nเครื่องดนตรี\nเครื่องต้น\nเครื่องทุ่นแรง\nเครื่องเทศ\nเครื่องใน\nเครื่องบิน\nเครื่องบูชา\nเครื่องแบบ\nเครื่องประดับ\nเครื่องปรุง\nเครื่องปรุงรส\nเครื่องมือ\nเครื่องยนต์\nเครื่องร่อน\nเครื่องราง\nเครื่องเรือน\nเครื่องล่าง\nเครื่องเล่น\nเครื่องสาย\nเครื่องสำอาง\nเครื่องสุกำศพ\nเครื่องหมาย\nเครือรัฐ\nเคลียคลอ\nเคลื่อนที่\nเคลื่อนไหว\nเคลือบแคลง\nเคลือบแฝง\nเคลือบฟัน\nเคว้งคว้าง\nเคหสถาน\nเค้าโครง\nเคียดแค้น\nเคี่ยวเข็ญ\nเคี้ยวเอื้อง\nเคืองขุ่น\nโคนม\nโคบาล\nโคมูตร\nโคมลอย\nโครงการ\nโครงเรื่อง\nโครงงาน\nโครงสร้าง\nโครมคราม\nโคลงเคลง\nฆ้องกระแต\nฆ้องชัย\nฆ้องวง\nฆ้องหุ่ย\nฆ้องเหม่ง\nฆ้องโหม่ง\nฆาตกร\nฆาตกรรม\nฆานประสาท\nงงงวย\nงงงัน\nงดเว้น\nงบดุล\nงบประมาณ\nงมโข่ง\nงมงาย\nง่วงงุน\nง่วงเหงา\nงอหาย\nง้องอน\nงอนง้อ\nงอมแงม\nงาช้าง\nง่าเงย\nงานการ\nง่ายดาย\nงึมงำ\nเงินเดือน\nเงินตรา\nเงินยวง\nเงียบกริบ\nเงียบเชียบ\nเงียบเหงา\nเงื่องหงอย\nเงื่อนไข\nเงื่อนงำ\nเงื่อนเวลา\nเงื้อมมือ\nแง่งอน\nจงใจ\nจงรัก\nจดจ่อ\nจดจำ\nจดหมาย\nจดหมายเหตุ\nจรจัด\nจรรยาบรรณ\nจริงจัง\nจริงใจ\nจอมขวัญ\nจอมใจ\nจอมทัพ\nจอมปลวก\nจอมพล\nจ๊ะเอ๋\nจักสาน\nจักรพรรดิ\nจักรภพ\nจักรยาน\nจักรยานยนต์\nจักรราศี\nจักรวรรดิ\nจักรวรรดินิยม\nจักรวาล\nจังหนับ\nจัดการ\nจัดจ้าน\nจัดเจน\nจัดแจง\nจัดตั้ง\nจัดสรร\nจับกุม\nจับจด\nจับเจ่า\nจ่าหน้า\nจาตุทสี\nจาตุมหาราช\nจาตุมหาราชิก\nจาตุมหาราชิกา\nจาตุรงคสันนิบาต\nจาตุรราชการ\nจานเชิง\nจานบิน\nจานผี\nจานเสียง\nจาบจ้วง\nจำเป็น\nจำพรรษา\nจำวัด\nจ้ำจี้จ้ำไช\nจำเลาะตา\nจิงโจ้น้ำ\nจิตใจ\nจิตตภาวนา\nจิตตัง\nจิตตานุปัสสนา\nจิตนิยม\nจิตบำบัด\nจิตแพทย์\nจิตวิสัย\nจิตรกร\nจิตรกรรม\nจิตรลดา\nจิตวิทยา\nจิตเวช\nจิตเวชศาสตร์\nจินตกวี\nจินตนา\nจินตนาการ\nจินตภาพ\nจุฑามณี\nจุฑามาศ\nจุฑารัตน์\nจุนเจือ\nจุ้นจ้าน\nจุลชีพ\nจุลชีวัน\nจุลชีวิน\nจุลทรรศน์\nจุลภาค\nจุลวรรค\nจุลศักราช\nจุลสาร\nจุลินทรีย์\nจุฬามณี\nจุฬาลักษณ์\nเจตคติ\nเจตจำนง\nเจตนารมณ์\nเจตภูต\nเจริญพร\nเจ้ากรม\nเจ้ากรรม\nเจ้าของ\nเจ้าขา\nเจ้าข้า\nเจ้าคณะ\nเจ้าค่ะ\nเจ้าจอม\nเจ้าชู้\nเจ้าตัว\nเจ้าถิ่น\nเจ้าท่า\nเจ้าที่\nเจ้าทุกข์\nเจ้านาย\nเจ้าเนื้อ\nเจ้าบ้าน\nเจ้าบ่าว\nเจ้าประคุณ\nเจ้าประคู้น\nเจ้าพนักงาน\nเจ้าพระคุณ\nเจ้าพระยา\nเจ้าพ่อ\nเจ้าพายุ\nเจ้าฟ้า\nเจ้าภาพ\nเจ้ามือ\nเจ้าแม่\nเจ้าเรือน\nเจ้าสังกัด\nเจ้าสัว\nเจ้าสาว\nเจ้าหน้าที่\nเจ้าหนี้\nเจ้าอาวาส\nเจาะจง\nเจือจาง\nเจือจาน\nเจือปน\nเจื้อยแจ้ว\nแจกจ่าย\nแจ่มแจ้ง\nแจ่มใส\nโจงกระเบน\nโจมตี\nโจรกรรม\nโจรสลัด\nใจความ\nใจคอ\nฉกฉวย\nฉกชิง\nฉลองได\nฉ้อฉล\nฉัตรมงคล\nฉันทลักษณ์\nฉายาลักษณ์\nฉิบหาย\nฉุกเฉิน\nฉุกละหุก\nฉุนเฉียว\nฉุปศาสตร์\nเฉไฉ\nเฉยเมย\nเฉาโฉด\nเฉิดฉัน\nเฉิดฉาย\nเฉิดฉิน\nเฉียบขาด\nเฉียบพลัน\nเฉียบแหลม\nเฉื่อยชา\nแฉะแบะ\nโฉดเฉา\nโฉมงาม\nโฉมฉาย\nโฉมเฉลา\nโฉมตรู\nโฉมยง\nโฉมศรี\nโฉมหน้า\nชดช้อย\nชดเชย\nชดใช้\nชนบท\nชนินทร์\nชนกกรรม\nชนมพรรษา\nชนมายุ\nชมเชย\nชมพูทวีป\nชมพูนท\nชมพูนุท\nชราธรรม\nชราภาพ\nชลจร\nชลธาร\nชลธี\nชลนัยน์\nชลนา\nชลเนตร\nชลประทาน\nชลมารค\nชลาธาร\nชลาลัย\nชลาศัย\nชลาสินธุ์\nชโลทร\nช่วงชิง\nช่วงใช้\nชวนชม\nชวนหัว\nช่วยเหลือ\nช่อฟ้า\nช่อม่วง\nชอกช้ำ\nช่องเขา\nช่องแคบ\nช่องไฟ\nช่องว่าง\nช้องนาง\nชอบกล\nชอบใจ\nชอบธรรม\nชอบพอ\nชักโครก\nชักเงา\nชักจูง\nชักชวน\nชักนำ\nชักเนื้อ\nชักพระ\nชักเย่อ\nชักใย\nชั่งใจ\nชังฆวิหาร\nชัดเจน\nชั้นเชิง\nชั่วคน\nชั่วคราว\nชั่วช้า\nชั่วโมง\nชั่วแล่น\nชาเย็น\nช้านาน\nช่างเครื่อง\nช่างฝีมือ\nช่างฟิต\nช่างไฟ\nช้างน้ำ\nช้างเผือก\nช้างพลาย\nช้างพัง\nช้างสาร\nช้างสีดอ\nชาติธรรม\nชาตินิยม\nชาติพันธุ์\nชาติพันธุ์วิทยา\nชาติภูมิ\nชานชาลา\nชายชาตรี\nชายคา\nชายฝั่ง\nชายทะเล\nชาวเล\nชาววัง\nช้ำใจ\nช้ำชอก\nชิงชัง\nชิงพลบ\nชินชา\nชินบุตร\nชิ้นเอก\nชิมลาง\nชีเปลือย\nชี้ขาด\nชี้แจง\nชี้นำ\nชี้แนะ\nชี้ฟ้า\nชีพจร\nชีพิตักษัย\nชื่นชม\nชื่นบาน\nชื่นมื่น\nชื่อย่อ\nชื่อรอง\nชื่อเล่น\nชื่อเสียง\nชุกชุม\nชุติมา\nชุบตัว\nชุบเลี้ยง\nชุมชน\nชุมทาง\nชุมสาย\nชุ่มใจ\nชุ่มชื่น\nชุ่มชื้น\nชุมนุมชน\nชูชีพ\nชูโรง\nชู้สาว\nเชยชม\nเชลยศักดิ์\nเชลยศึก\nเช่าซื้อ\nเช้าตรู่\nเช้ามืด\nเชิงกราน\nเชิงกล\nเชิงชั้น\nเชิงชาย\nเชิงซ้อน\nเชิงเดียว\nเชิงเดี่ยว\nเชิงตะกอน\nเชิงเทิน\nเชิงมุม\nเชิดชู\nเชิงอรรถ\nเชี่ยนหมาก\nเชี่ยวชาญ\nเชื่องช้า\nเชื่อใจ\nเชื่อถือ\nเชื่อฟัง\nเชื่อมือ\nเชื้อชาติ\nเชื้อเพลิง\nเชื้อไฟ\nเชื้อโรค\nเชื้อสาย\nเชื้อเชิญ\nเชื่องช้า\nเชือนแช\nเชื่อวัน\nแช่เย็น\nแช่อิ่ม\nแช่มช้อย\nแช่มชื่น\nโชกโชน\nโชติช่วง\nโชติรส\nใช้สอย\nซบเซา\nซมซาน\nซวนเซ\nซอกซอน\nซอกแซก\nซ่องสุม\nซ่องเสพ\nซ่องแซ่ง\nซ่อนรูป\nซ่อนเร้น\nซ่อนหา\nซ่อนกลิ่น\nซ่อนทราย\nซ่อมแซม\nซักค้าน\nซักซ้อม\nซักไซ้\nซักฟอก\nซักแห้ง\nซังกะตาย\nซังตาย\nซัดเซ\nซัดทอด\nซับซ้อน\nซับใน\nซับพระพักตร์\nซากศพ\nซ่านเซ็น\nซ้ำซ้อน\nซ้ำซาก\nซ้ำเติม\nซ้ำร้าย\nซี่โครง\nซีดเซียว\nซึมกะทือ\nซึมซาบ\nซึมเซา\nซึมทราบ\nซึมเศร้า\nซื่อตรง\nซื่อสัตย์\nซื้อขาย\nซุกซน\nซุกซ่อน\nซุบซิบ\nซู่ซ่า\nเซซัง\nเซ่อซ่า\nแซ่ซ้อง\nโซดาไฟ\nญาณทัสนะ\nญาณวิทยา\nญาณศาสตร์\nญาติกา\nฐานราก\nดกดื่น\nดงดิบ\nดลใจ\nดลบันดาล\nดวงแก้ว\nดวงใจ\nดวงเดือน\nดวงตรา\nดวงตา\nดวงสมร\nดอกจัน\nดอกจิก\nดอกบัว\nดอกเบี้ย\nดอกฟ้า\nดอกไม้\nดอกยาง\nดอกเล็บ\nดอกทอง\nดอกสร้อย\nดองยา\nดักคอ\nดักฟัง\nดังนั้น\nดังนี้\nดังหนึ่ง\nดั้งเดิม\nดัดจริต\nดัดแปลง\nดันทุรัง\nดับขันธ์\nดับจิต\nดับชีพ\nด่าทอ\nด่างทับทิม\nด่างพร้อย\nดาดฟ้า\nดาราศาสตร์\nดาลเดือด\nดาวกระจาย\nดาวเคราะห์\nดาวตก\nดาวเทียม\nดาวรุ่ง\nดาวเรือง\nดาวฤกษ์\nดาวหาง\nดาวเหนือ\nดาษดื่น\nดินขาว\nดินดาน\nดินดำ\nดินประสิว\nดินปืน\nดินระเบิด\nดินสอ\nดินสอพอง\nดิ้นรน\nดิบดี\nดีเกลือ\nดีใจ\nดีซ่าน\nดีดัก\nดีเดือด\nดีฝ่อ\nดีดดิ้น\nดึกดำบรรพ์\nดึกดื่น\nดึงดัน\nดึงดูด\nดื่มด่ำ\nดื้อด้าน\nดื้อดึง\nดื้อแพ่ง\nดื้อยา\nดื้อรั้น\nดุดัน\nดุเดือด\nดุร้าย\nดุลการค้า\nดุลพินิจ\nดุลภาค\nดุลยพินิจ\nดุลยภาพ\nดุษฎีนิพนธ์\nดุษฎีบัณฑิต\nดุษณีภาพ\nดูแคลน\nดูถูก\nดูดาย\nดูเบา\nดูแล\nดูหมิ่น\nดูเหมือน\nดูดดื่ม\nเด็ดขาด\nเด็ดดวง\nเด็ดเดี่ยว\nเดนตาย\nเดาสวด\nเดาสุ่ม\nเดินทาง\nเดินสะพัด\nเดินสาย\nเดินเหิน\nเดิมพัน\nเดียงสา\nเดียดฉันท์\nเดียวกัน\nเดียวดาย\nเดี๋ยวเดียว\nเดี๋ยวนี้\nเดือดดาล\nเดือดร้อน\nเดือนมืด\nเดือนหงาย\nแดดาล\nแดดิ้น\nแดกดัน\nโด่เด่\nโด่งดัง\nโดดเดี่ยว\nโดยสาร\nได้การ\nได้แก่\nได้ใจ\nได้ที\nได้ยิน\nได้เสีย\nตกเขียว\nตกค้าง\nตกใจ\nตกต่ำ\nตกแต่ง\nตกทอด\nตกฟาก\nตกมัน\nตกยาก\nตกลง\nตกหล่น\nต้นขั้ว\nต้นคิด\nต้นฉบับ\nต้นตอ\nต้นตำรับ\nต้นทุน\nต้นแบบ\nต้นเพลิง\nต้นมือ\nต้นไม้\nต้นร่าง\nต้นเรื่อง\nต้นสังกัด\nต้นหน\nต้นเหตุ\nตบตา\nตบแต่ง\nตบแผละ\nตบมือ\nต้มข่า\nต้มโคล้ง\nต้มยำ\nต้มส้ม\nตรมตรอม\nตรรกวิทยา\nตรรกศาสตร์\nตรวจการ\nตรวจการณ์\nตรวจตรา\nตระบัดสัตย์\nตรัสรู้\nตราตั้ง\nตราบาป\nตรายาง\nตราสาร\nตริตรอง\nตรีกฏุก\nตรีกาย\nตรีโกณ\nตรีโกณมิติ\nตรีคูณ\nตรีทูต\nตรีปิฎก\nตรีภพ\nตรีมูรติ\nตรึกตรอง\nตรึงตรา\nตรุษจีน\nตฤณชาติ\nตฤณมัย\nตลกบาตร\nตลบตะแลง\nตลบหลัง\nตลาดนัด\nตลาดน้ำ\nตลาดมืด\nตลาดสด\nต่อตี\nต่อเติม\nต่อว่า\nต่อสู้\nต่อกร\nต่อต้าน\nต่อแย้ง\nต้องการ\nต้องโทษ\nต้องหา\nต้อนรับ\nตอบโต้\nตอบแทน\nต่อยหอย\nตะพาบน้ำ\nตักตวง\nตักบาตร\nตั้งเข็ม\nตั้งไข่\nตั้งเค้า\nตั้งแง่\nตั้งใจ\nตั้งต้น\nตั้งแต่\nตั้งท้อง\nตัดขาด\nตัดใจ\nตัดเชือก\nตัดตอน\nตัดทอน\nตัดบท\nตัดพ้อ\nตัดรอน\nตัดสิน\nตับเต่า\nตับแลบ\nตับอ่อน\nตัวกลาง\nตัวการ\nตัวเก็ง\nตัวดี\nตัวตั้ง\nตัวเต็ง\nตัวถัง\nตัวแทน\nตัวประกอบ\nตัวประกัน\nตัวแปร\nตัวผู้\nตัวพิมพ์\nตัวเมีย\nตัวยืน\nตัวเลข\nตัวอย่าง\nตั๋วเงิน\nตั๋วแลกเงิน\nตากล้อง\nตาไก่\nตาข่าย\nตาชั่ง\nตาตุ่ม\nตาทวด\nตาปลา\nตาราง\nต่างหาก\nต้านทาน\nตามใจ\nตายใจ\nตายซาก\nตายด้าน\nตายตัว\nตายทั้งกลม\nตายห่า\nตายโหง\nตาลปัตร\nต่ำช้า\nต่ำต้อย\nตำส้ม\nติเตียน\nติณชาติ\nติดขัด\nติดใจ\nติดต่อ\nติดตั้ง\nติดตาม\nติดตื้น\nติดพัน\nติดลม\nติดอ่าง\nตีเกลียว\nตีขลุม\nตีความ\nตีคู่\nตีจาก\nตีตื้น\nตีแผ่\nตีรวน\nตีลังกา\nตีวง\nตีเสมอ\nตีนกา\nตีนคู้\nตีนจก\nตีนตะขาบ\nตีนผี\nตีนเหยียด\nตึกแถว\nตึกระฟ้า\nตึงเครียด\nตึงตัง\nตื้นตัน\nตื่นตัว\nตื่นตูม\nตื่นเต้น\nตุ๊ต๊ะ\nตุ้บตั้บ\nตุ้มหู\nตุลาการ\nตุลาคม\nตู้นิรภัย\nตูมตาม\nตู้เสบียง\nเตโชธาตุ\nเตร็ดเตร่\nเต้นรำ\nเตาแก๊ส\nเตาผิง\nเตาฟู่\nเตาไฟ\nเตารีด\nเตาสูบ\nเต่าทอง\nเต้ารับ\nเต้าส่วน\nเต้าเสียบ\nเต้าหู้ยี้\nแต่ละ\nแตกคอ\nแตกคอก\nแตกฉาน\nแตกดับ\nแตกตื่น\nแตกพาน\nแตกแยก\nแตกร้าว\nแตกหัก\nแต่งงาน\nแต่งตั้ง\nแต้มคู\nแต้มต่อ\nแตรงอน\nแตรเดี่ยว\nแตรฝรั่ง\nแตรฟันฟาร์\nแตรวง\nโต้ตอบ\nโต้เถียง\nโต้แย้ง\nโต๊ะหมู่\nโต๊ะอิหม่าม\nใต้ถุน\nไต้ก๋ง\nไต่คู้\nไต่เต้า\nไต่ถาม\nไต้ฝุ่น\nไตรจักร\nไตรจีวร\nไตรตรึงษ์\nไตรทวาร\nไตรปิฎก\nไตรเพท\nไตรภพ\nไตรภูมิ\nไตรภาคี\nไตรยางศ์\nไตรรงค์\nไตรรัตน์\nไตรลักษณ์\nไตรโลก\nไตรสรณคมน์\nไตรสิกขา\nไต่สวน\nถกเถียง\nถดถอย\nถนัดถนี่\nถนิมสร้อย\nถมถืด\nถมเถ\nถมไป\nถลากไถล\nถ้วนถี่\nถ้วยฟู\nถ่องแท้\nถอดถอน\nถ้อยคำ\nถ้อยแถลง\nถากถาง\nถ่านไฟฉาย\nถ่านหิน\nถามไถ่\nถ่ายทอด\nถ่ายทุกข์\nถ่ายเท\nถาวรวัตถุ\nถ้ำมอง\nถี่ถ้วน\nถึงใจ\nถูกใจ\nถูกชะตา\nเถรวาท\nเถ้าแก่\nเถ้าแก่เนี้ย\nแถมพก\nแถลงการณ์\nไถ่ถอน\nไถ่ถาม\nทดแทน\nทดรอง\nทดลอง\nทดสอบ\nทนทาน\nทนายความ\nทบทวน\nทแยงมุม\nทรงกลด\nทรงเครื่อง\nทรงเจ้า\nทรัพย์สิน\nทรามชม\nทรามเชย\nทรามวัย\nทรามสงวน\nทรามสวาท\nทรุดโทรม\nทฤษฎีบท\nท้วงติง\nท่วมท้น\nทวาทศ\nทวาทศมาส\nทวาบรยุค\nทวารบาล\nทวิบถ\nทวิบท\nทวิบาท\nทวิภาค\nทวิภาคี\nทวีคูณ\nทศกัณฐ์\nทศชาติ\nทศทิศ\nทศนิยม\nทศพร\nทศพล\nทศพิธราชธรรม\nทศมาส\nทศวรรษ\nท่อไอเสีย\nท้อถอย\nท้อแท้\nทองขาว\nทองคำ\nทองคำขาว\nทองคำเปลว\nทองเค\nทองแดง\nทองบรอนซ์\nทองม้วน\nทองย้อย\nทองสัมฤทธิ์\nทองหยอด\nทองหยิบ\nทองเหลือง\nทองเอก\nท่องเที่ยว\nท้องตรา\nท้องถิ่น\nท้องที่\nท้องน้อย\nท้องร่อง\nท้องเรื่อง\nทอดมัน\nทอดทิ้ง\nทอดน่อง\nทอดยอด\nทอดหุ่ย\nทอยกอง\nทะเบียนบ้าน\nทะเลทราย\nทะเลสาบ\nทะเลหลวง\nทักขิณาวัฏ\nทักท้วง\nทักทาย\nทักษิณาวรรต\nทักษิณาทาน\nทักษิณานุประทาน\nทั้งกลม\nทั้งคน\nทั้งดุ้น\nทั้งที\nทั้งนั้น\nทั้งนี้\nทั้งปวง\nทั้งผอง\nทั้งเพ\nทั้งมวล\nทั้งสิ้น\nทั้งหมด\nทั้งหลาย\nทัณฑ์บน\nทัดทาน\nทัดเทียม\nทันควัน\nทันใจ\nทันใด\nทันตา\nทันสมัย\nทันที\nทับถม\nทับทรวง\nทับศัพท์\nทั่วถึง\nทั่วไป\nท่าทาง\nท่าที\nท้าทาย\nทางการ\nทางข้าม\nทางด่วน\nทางเท้า\nทางโท\nทางใน\nทางผ่าน\nทางม้าลาย\nทางหลวง\nทางออก\nทางเอก\nทานกัณฑ์\nทานตะวัน\nท่านชาย\nทานบารมี\nท่านผู้หญิง\nท่านหญิง\nทาบทาม\nท้ายทอย\nทารุณกรรม\nทำคลอด\nทำใจ\nทำซ้ำ\nทำท่า\nทำที\nทำแท้ง\nทำโทษ\nทำบาป\nทำบุญ\nทำพิษ\nทำฟัน\nทำร้าย\nทำวัตร\nทำสาว\nทำเสน่ห์\nทำหมัน\nทำให้\nทิ้งขว้าง\nทิ้งทวน\nทิ้งท้าย\nทินกร\nทิพจักขุ\nทิพโสต\nทิพยจักษุ\nทิพยญาณ\nทิพยเนตร\nทิพยรส\nทิพากร\nทิ่มตำ\nทิ่มแทง\nทิวากร\nทิวากาล\nทิศทาง\nทีเด็ด\nทีท่า\nทีนี้\nทีหลัง\nทีฆนิกาย\nทีฆสระ\nที่ดิน\nที่นอน\nที่นั่ง\nที่ปรึกษา\nที่พึ่ง\nที่มั่น\nที่ราบ\nที่ว่าการ\nที่สุด\nที่หมาย\nที่ไหน\nทุกที\nทุกเมื่อ\nทุกข์สุข\nทุนทรัพย์\nทุนนิยม\nทุนรอน\nทุนสำรอง\nทุ่มเถียง\nทุ่มเท\nทูนหัว\nทูลกระหม่อม\nเทกระจาด\nเทครัว\nเทพเจ้า\nเทพดา\nเทพธิดา\nเทพนม\nเทพนิยม\nเทพนิยาย\nเทพบุตร\nเทพสังหรณ์\nเทศกาล\nเทศนาโวหาร\nเทศบัญญัติ\nเทศบาล\nเทศมนตรี\nเทห์ฟากฟ้า\nเท่ากับ\nเท่าใด\nเท่าตัว\nเท่าทัน\nเท่าทุน\nเท่าเทียม\nเท่านั้น\nเท่าไร\nเท้าช้าง\nเทิดทูน\nเที่ยงตรง\nเที่ยงแท้\nเที่ยงธรรม\nเทียนชนวน\nเทียนพรรษา\nเทียบเคียง\nเทียบเท่า\nเทือกเขา\nเทือกเถา\nแท็งก์น้ำ\nแท่นพิมพ์\nแท่นมณฑล\nแท่นหมึก\nแทรกซอน\nแทรกซ้อน\nแทรกซึม\nแทรกแซง\nแทะโลม\nไทยดำ\nไทยทาน\nไทยธรรม\nไทยน้อย\nไทยใหญ่\nธงชัย\nธงชาติ\nธงทิว\nธรณีวิทยา\nธรณีสงฆ์\nธรรมกาย\nธรรมการ\nธรรมเกษตร\nธรรมขันธ์\nธรรมคุณ\nธรรมจรรยา\nธรรมจริยา\nธรรมจักร\nธรรมจักษุ\nธรรมจาคะ\nธรรมจารี\nธรรมชาติ\nธรรมดา\nธรรมเนียม\nธรรมราชา\nธรรมศาสตร์\nธรรมสภา\nธรรมสังเวช\nธัญพืช\nธารพระกร\nธีรภาพ\nธีรราช\nนกเขา\nนกต่อ\nนกยูง\nนกรู้\nนกหวีด\nนครบาล\nนครรัฐ\nนงคราญ\nนงนุช\nนงพะงา\nนงเยาว์\nนงราม\nนงลักษณ์\nนบนอบ\nนพเก้า\nนพคุณ\nนพเคราะห์\nนพปฎล\nนพพล\nนพรัตน์\nนพศก\nนพศูล\nนมข้น\nนมผง\nนมไม้\nนมนาน\nนมหนู\nนมแมว\nนรีเวช\nนรีเวชวิทยา\nนวดฟั้น\nนวยนาด\nนวลระหง\nนวลลออ\nนวลละออง\nนวลจันทร์\nนอกครู\nนอกคอก\nนอกจาก\nนอกใจ\nนอกชาน\nนอกรีต\nนอกเหนือ\nนองเนือง\nนองเลือด\nนอนก้น\nนอนใจ\nนอบนบ\nนอนเล่น\nนอบน้อม\nน้อมนำ\nน้อยใจ\nน้อยหน้า\nนักการ\nนักการเมือง\nนักกีฬา\nนักข่าว\nนักท่องเที่ยว\nนักเทศน์\nนักโทษ\nนักธรรม\nนักบวช\nนักบิน\nนักบุญ\nนักปราชญ์\nนักพรต\nนักรบ\nนักเรียน\nนักเลง\nนักวิชาการ\nนักศึกษา\nนักสิทธิ์\nนักสืบ\nนักหนา\nนั่งเทียน\nนั่งร้าน\nนัดแนะ\nนัดหมาย\nนั่นแหละ\nนั่นเอง\nนับถือ\nนับประสา\nนัยน์ตา\nนาดำ\nนาปรัง\nนาปี\nนาสวน\nนาหว่าน\nนาคบาศ\nนาคปรก\nนาคราช\nนางกวัก\nนางกำนัล\nนางงาม\nนางใน\nนางบำเรอ\nนางแบบ\nนางพญา\nนางฟ้า\nนางไม้\nนางโลม\nนางสาว\nนางห้าม\nนางเอก\nนาฏกรรม\nนาฏดนตรี\nนาฏศิลป์\nนานนม\nน่านน้ำ\nน่านฟ้า\nนามกร\nนามธรรม\nนามไธย\nนามบัตร\nนามปากกา\nนามแฝง\nนามสกุล\nนามสงเคราะห์\nนามสมญา\nนายทะเบียน\nนายท่า\nนายท้าย\nนายทุน\nนายประกัน\nนายหน้า\nนายอำเภอ\nนารายณ์หัตถ์\nนารีผล\nนาวิกโยธิน\nนำจับ\nนำพา\nนำทาง\nนำร่อง\nนำสืบ\nนำแสดง\nน้ำกรด\nน้ำกาม\nน้ำเกลือ\nน้ำข้าว\nน้ำแข็ง\nน้ำแข็งไส\nน้ำแข็งแห้ง\nน้ำครำ\nน้ำคร่ำ\nน้ำค้าง\nน้ำค้างแข็ง\nน้ำคาวปลา\nน้ำคำ\nน้ำเค็ม\nน้ำเคย\nน้ำเงิน\nน้ำเงี้ยว\nน้ำจัณฑ์\nน้ำจิ้ม\nน้ำใจ\nน้ำเชื้อ\nน้ำเชื่อม\nน้ำซาวข้าว\nน้ำดอกไม้\nน้ำดี\nน้ำตก\nน้ำตา\nน้ำตาล\nน้ำท่า\nน้ำนม\nน้ำนวล\nน้ำบาดาล\nน้ำประสานทอง\nน้ำประปา\nน้ำปลา\nน้ำป่า\nน้ำผึ้ง\nน้ำพริก\nน้ำพริกเผา\nน้ำพี้\nน้ำพุ\nน้ำมนต์\nน้ำมนตร์\nน้ำมัน\nน้ำมือ\nน้ำมูก\nน้ำเมา\nน้ำย่อย\nน้ำยา\nน้ำรัก\nน้ำแร่\nน้ำลาย\nน้ำเลี้ยง\nน้ำสต๊อก\nน้ำส้ม\nน้ำส้มสายชู\nน้ำสังข์\nน้ำสาบาน\nน้ำเสียง\nน้ำหนวก\nน้ำหนอง\nน้ำหนัก\nน้ำหน้า\nน้ำหนึ่ง\nน้ำหมึก\nน้ำหอม\nน้ำเหลือง\nน้ำอบ\nน้ำอ้อย\nน้ำอัดลม\nนิ่งเฉย\nนิจศีล\nนิดเดียว\nนิดหน่อย\nนิติกร\nนิติกรรม\nนิติธรรม\nนิตินัย\nนิติบัญญัติ\nนิติบุคคล\nนิติภาวะ\nนิติวิทยาศาสตร์\nนิติเวช\nนิติเวชศาสตร์\nนิติศาสตร์\nนิเทศศาสตร์\nนิ่มนวล\nนิรุกติศาสตร์\nนิเวศวิทยา\nนิศากร\nนิศากาล\nนิศาชล\nนิศารัตน์\nนี่แน่ะ\nนี่แหละ\nนี่เอง\nนึกคิด\nนุงถุง\nนุ่งห่ม\nนุ่มนวล\nนุ่มนิ่ม\nเนตรนารี\nเนติบัณฑิต\nเนยเทียม\nเนยใส\nเนิ่นนาน\nเนิบนาบ\nเนื้อความ\nเนื้อคู่\nเนื้อเค็ม\nเนื้องอก\nเนื้อตัว\nเนื้อตาย\nเนื้อที่\nเนื้อแท้\nเนื้อเปื่อย\nเนื้อผ้า\nเนื้อเพลง\nเนื้อไม้\nเนื้อเยื่อ\nเนื้อร้อง\nเนื้อร้าย\nเนื้อเรื่อง\nเนื้อหา\nเนืองนอง\nเนืองนิตย์\nเนืองแน่น\nแน่ใจ\nแน่ชัด\nแน่แท้\nแน่นอน\nแน่นิ่ง\nแน่แน่ว\nแน่นแฟ้น\nแน่นหนา\nแนบเนียน\nแนบแน่น\nแนวคิด\nแนวทาง\nแนวโน้ม\nแนวป่า\nแนวรบ\nแนวร่วม\nแนวหน้า\nแนวหลัง\nแน่วแน่\nแนะนำ\nแนะแนว\nโน้มน้าว\nในหลวง\nบกพร่อง\nบงกช\nบงการ\nบดบัง\nบทกลอน\nบทกวี\nบทความ\nบทคัดย่อ\nบทเฉพาะกาล\nบทนำ\nบทบัญญัติ\nบทบาท\nบทประพันธ์\nบทเพลง\nบทร้อง\nบทเรียน\nบทลงโทษ\nบทสนทนา\nบทอัศจรรย์\nบทจร\nบทบงสุ์\nบทมาลย์\nบทรัช\nบทเรศ\nบทวลัญช์\nบนบาน\nบรมครู\nบรมธาตุ\nบรมบพิตร\nบรมวงศานุวงศ์\nบรมอัฐิ\nบรรณพิภพ\nบรรณศาลา\nบรรณาการ\nบรรณาธิการ\nบรรณานุกรม\nบรรณารักษ์\nบรรณารักษศาสตร์\nบรรดามี\nบรรดาศักดิ์\nบรรทัดฐาน\nบรรพบุรุษ\nบรรลัยกัลป์\nบรรลัยจักร\nบริคณห์สนธิ\nบวงสรวง\nบ่วงบาศ\nบ้วนพระโอษฐ์\nบ่อเกิด\nบอกกล่าว\nบอกบท\nบอกบุญ\nบอกใบ้\nบอกปัด\nบ้องกัญชา\nบ้องตื้น\nบ้องไฟ\nบ้องหู\nบอดสี\nบ่อนทำลาย\nบอบช้ำ\nบอบบาง\nบอบแบบ\nบังโกลน\nบังโคลน\nบังใบ\nบั้งไฟ\nบังคับการ\nบังคับบัญชา\nบัญชาการ\nบัณฑุกัมพล\nบัดดล\nบัดเดี๋ยว\nบัดนั้น\nบัดนี้\nบัดสีบัดเถลิง\nบัตรเครดิต\nบัตรพลี\nบัตรสนเท่ห์\nบัตรสินเชื่อ\nบั่นทอน\nบั้นท้าย\nบั้นปลาย\nบั้นพระองค์\nบั้นเอว\nบันไดลิง\nบันไดเลื่อน\nบันเทิงคดี\nบัวลอย\nบัวบก\nบ้าจี้\nบ้าดีเดือด\nบ้าน้ำลาย\nบ้าบิ่น\nบ้าระห่ำ\nบ้าเลือด\nบ้าหอบฟาง\nบากบั่น\nบากหน้า\nบางตา\nบางเบา\nบางที\nบาดเจ็บ\nบาดแผล\nบาดหมาง\nบาตรใหญ่\nบาทบงกช\nบาทบงสุ์\nบาทบริจาริกา\nบาทวิถี\nบานเกล็ด\nบานตะเกียง\nบานตะไท\nบานเบอะ\nบานปลาย\nบานแผละ\nบานพับ\nบ้านจัดสรร\nบ้านช่อง\nบ้านนอก\nบ้านพัก\nบ้านเมือง\nบ้านรับรอง\nบ้านเรือน\nบาปกรรม\nบายศรี\nบ่ายเบี่ยง\nบ่ายหน้า\nบ่าวไพร่\nบิดเบี้ยว\nบิดเบือน\nบิดพลิ้ว\nบี้แบน\nบีบคั้น\nบีบรัด\nบึ้งตึง\nบึ้งบูด\nบุกบั่น\nบุกเบิก\nบุกรุก\nบุคลิกภาพ\nบุคลิกลักษณะ\nบุญธรรม\nบุญนิธิ\nบุญฤทธิ์\nบุบสลาย\nบุ้ยใบ้\nบุรุษเพศ\nบุหงารำไป\nบู้บี้\nบูชายัญ\nบูดบึ้ง\nบูดเบี้ยว\nเบาความ\nเบาใจ\nเบาบาง\nเบาปัญญา\nเบามือ\nเบาแรง\nเบาสมอง\nเบาหวาน\nเบาโหวง\nเบ้าตา\nเบาะแส\nเบิกความ\nเบิกบาน\nเบี้ยล่าง\nเบี้ยเลี้ยง\nเบี้ยหวัด\nเบี่ยงบ่าย\nเบียดบัง\nเบียดเบียน\nเบียดเสียด\nเบื้องต้น\nเบื้องบน\nเบื้องหน้า\nเบื้องหลัง\nแบกะดิน\nแบเบาะ\nแบ่งเบา\nแบ่งปัน\nแบ่งแยก\nแบบฉบับ\nแบบแปลน\nแบบแผน\nแบบฝึกหัด\nแบบพิมพ์\nแบบสอบถาม\nแบบอย่าง\nแบะแฉะ\nแบะท่า\nโบแดง\nโบราณคดี\nโบราณวัตถุ\nโบราณสถาน\nใบขับขี่\nใบจอง\nใบตอง\nใบแทรก\nใบบอก\nใบบุญ\nใบเบิกทาง\nใบปลิว\nใบพัด\nใบโพ\nใบไม้\nใบระกา\nใบรับรอง\nใบลา\nใบเลี้ยง\nใบสั่ง\nใบสำคัญ\nใบสุทธิ\nใบเสร็จ\nใบหน้า\nใบอนุญาต\nใบระกา\nปกครอง\nปกคลุม\nปกป้อง\nปกปิด\nปฏิบัติการ\nปฏิบัติบูชา\nปฐพีวิทยา\nปฐมฌาน\nปฐมทัศน์\nปฐมเทศนา\nปฐมนิเทศ\nปฐมพยาบาล\nปฐมยาม\nปฐมฤกษ์\nปฐมวัย\nปฐมสมโพธิ\nปนเป\nป่นปี้\nปมเขื่อง\nปมเด่น\nปมด้อย\nปรนเปรอ\nปรบไก่\nปรบมือ\nปรสิตวิทยา\nประโปรย\nประพรม\nประกันชีวิต\nประกันภัย\nประจักษ์พยาน\nประจัญบาน\nประจันหน้า\nประจำการ\nประจำเดือน\nประจำเมือง\nประจำยาม\nประชดประชัน\nประชากร\nประชากรศาสตร์\nประชาคม\nประชาชน\nประชาราษฎร์\nประชาชาติ\nประชาชี\nประชาทัณฑ์\nประชาบาล\nประชาพิจารณ์\nประชาภิบาล\nประชามติ\nประชาสงเคราะห์\nประชาสัมพันธ์\nประดับประดา\nประดามี\nประดาน้ำ\nประเดี๋ยวเดียว\nประเดี๋ยวนี้\nประทับใจ\nประทุษร้าย\nประเทศราช\nประพาสต้น\nประเพณีนิยม\nประลัยกัลป์\nประวัติการณ์\nประวัติศาสตร์\nประสบการณ์\nประสบการณ์นิยม\nประสาทการ\nประสูติการ\nประสูติกาล\nประเส\nปรับทุกข์\nปรับโทษ\nปรับปรุง\nปรากฏการณ์\nปราดเปรียว\nปราดเปรื่อง\nปราบปราม\nปริญญาบัตร\nปรัยัติธรรม\nปรุโปร่ง\nปลงใจ\nปลงตก\nปลดทุกข์\nปลดปลง\nปลดปล่อย\nปลดเปลื้อง\nปลดระวาง\nปลดแอก\nปล้นสะดม\nปลอกกระสุน\nปลอกคอ\nปลอดโปร่ง\nปลอดภัย\nปลอมปน\nปลอมแปลง\nปลอบโยน\nปล่อยใจ\nปล่อยตัว\nปล่อยปละ\nปลั๊กไฟ\nปลากริม\nปลาเค็ม\nปลาจ่อม\nปลาเจ่า\nปลาแดก\nปลาตู้\nปลาทอง\nปลาร้า\nปลาส้ม\nปลาดาว\nปลาบิน\nปลาฝา\nปลาวาฬ\nปลาหมึก\nปลาบปลื้ม\nปลายข้าว\nปลายแถว\nปลายทาง\nปลิ้นปลอก\nปลิ้นปล้อน\nปลีกตัว\nปลีกย่อย\nปลุกใจ\nปลุกปล้ำ\nปลุกปั่น\nปลุกระดม\nปลุกเสก\nปลูกฝัง\nปลูกสร้าง\nปวดถ่วง\nปวดมวน\nปวดร้าว\nป่วนปั่น\nป่วยการ\nปอกลอก\nป้องกัน\nปักใจ\nปักดำ\nปักหลัก\nปัจเจกบุคคล\nปัจเจกพุทธะ\nปัจเจกโพธิ\nปัจฉิมชน\nปัจฉิมทิศ\nปัจฉิมภาค\nปัจฉิมยาม\nปัจฉิมลิขิต\nปัจฉิมวัย\nปัจฉิมวาจา\nปัญญาชน\nปัญญาวิมุติ\nปัญญาอ่อน\nปัดเป่า\nปันส่วน\nปั่นป่วน\nปั่นแปะ\nปั่นหัว\nปั้นจิ้ม\nปั้นเจ๋อ\nปั้นปึ่ง\nปั้นสิบ\nปั๊มน้ำมัน\nป่าช้า\nป่าชายเลน\nป่าดง\nป่าดงดิบ\nป่าดิบ\nป่าเถื่อน\nป่าเบญจพรรณ\nป่าละเมาะ\nปากกา\nปากขอ\nปากแข็ง\nปากคอ\nปากคำ\nปากคีบ\nปากจัด\nปากน้ำ\nปากเปล่า\nปากเสียง\nปานกลาง\nป่านนี้\nป้านลม\nป้ายสี\nป่าวร้อง\nปิดฉาก\nปิดบัง\nปิตุฆาต\nปิตุภูมิ\nปีมะโว้\nปีแสง\nปี่กลาง\nปี่ไฉน\nปี่ชวา\nปี่นอก\nปี่ใน\nปี่พาทย์\nปี่อ้อ\nปีกกา\nปีนเกลียว\nปีนป่าย\nปึกแผ่น\nปึงปัง\nปืนกล\nปืนครก\nปืนพก\nปืนยา\nปืนยาว\nปืนลม\nปืนเล็ก\nปืนเล็กยาว\nปืนสั้น\nปืนใหญ่\nปุบปับ\nปุ๊บปั๊บ\nปุ่มเปือก\nปุยฝ้าย\nปุ๋ยคอก\nปุ๋ยเคมี\nปุ๋ยวิทยาศาสตร์\nปุ๋ยหมัก\nปุ๋ยอินทรีย์\nปูจ๋า\nปูเสฉวน\nปู่เจ้า\nปู่ทวด\nปูนขาว\nปูนซีเมนต์\nปูนดิบ\nปูนแดง\nปูนปลาสเตอร์\nปูนปั้น\nเป็ดเทศ\nเป็ดน้ำ\nเป็นกลาง\nเป็นใจ\nเป็นต้น\nเป็นต่อ\nเป็นรอง\nเป็นไร\nเป็นลม\nเป็นห่วง\nเป็นอยู่\nเปรมปรีดิ์\nเปรอะเปื้อน\nเปรียบเทียบ\nเปรียบเปรย\nเปรี้ยวปาก\nเปรี้ยวหวาน\nเปรื่องปราด\nเปลญวน\nเปล่งปลั่ง\nเปล่าดาย\nเปล่าเปลี่ยว\nเปลี่ยนใจ\nเปลี่ยนตัว\nเปลี่ยนแปลง\nเปลี่ยนมือ\nเปลี่ยนหน้า\nเป๋อเหลอ\nเปะปะ\nเป่ากบ\nเป้านิ่ง\nเป้าหมาย\nเปิดฉาก\nเปิดเปิง\nเปิดโปง\nเปิดผนึก\nเปิดเผย\nเปียกปูน\nแป้งสาลี\nแป้งนวล\nแป้งเปียก\nแป้งมัน\nแป้งฝุ่น\nแป้งร่ำ\nแป้งสิงคโปร์\nแป้งหมี่\nแปดปน\nแปดเปื้อน\nแปรปรวน\nแปรผัน\nแปรพักตร์\nแปรรูป\nแปรอักษร\nแปลกปลอม\nแปะโป้ง\nโป้ปด\nโปร่งแสง\nโปร่งใส\nโปรดปราน\nโปรยทาน\nโปรยปราย\nโปโลน้ำ\nผกผัน\nผกากรอง\nผงขาว\nผงชูรส\nผงซักฟอก\nผงฟู\nผดุงครรภ์\nผมไฟ\nผลพลอยได้\nผลลัพธ์\nผลัดเปลี่ยน\nผลิตผล\nผลิตภัณฑ์\nผลุบโผล่\nผสมเทียม\nผสมผสาน\nผสมผเส\nผสมพันธุ์\nผสมโรง\nผสมเสร็จ\nผ่องแผ้ว\nผ่องใส\nผ่อนคลาย\nผ่อนชำระ\nผ่อนปรน\nผ่อนผัน\nผ่อนส่ง\nผอมโซ\nผอมแห้ง\nผักชี\nผักตบชวา\nผักบุ้ง\nผังเมือง\nผัดผ่อน\nผันแปร\nผันผวน\nผ่าตัด\nผ่าเผย\nผ่าหมาก\nผ่าเหล่า\nผ้าขนหนู\nผ้าขาวม้า\nผ้าขี้ริ้ว\nผ้าเช็ดตัว\nผ้าเช็ดปาก\nผ้าเช็ดมือ\nผ้าเช็ดหน้า\nผ้าดิบ\nผ้าต่วน\nผ้าไตร\nผ้าถุง\nผ้าแถบ\nผ้านวม\nผ้านุ่ง\nผ้าใบ\nผ้าป่า\nผ้าป่าน\nผ้าผ่อน\nผ้าพันคอ\nผ้าพันแผล\nผ้าแพร\nผ้าโพกหัว\nผ้ามัดหมี่\nผ้ายาง\nผ้าลูกไม้\nผ้าเหลือง\nผ้าอนามัย\nผ้าอ้อม\nผาดโผน\nผาติกรรม\nผิดหวัง\nผิวเผิน\nผิวพรรณ\nผิวหนัง\nผีกระสือ\nผีกระหัง\nผีกองกอย\nผีโขมด\nผีดิบ\nผีตองเหลือง\nผีถ้วยแก้ว\nผีแถน\nผีทะเล\nผีบุญ\nผีปอบ\nผีพุ่งไต้\nผีฟ้า\nผีเรือน\nผีสาง\nผีเสื้อ\nผีห่า\nผึ่งผาย\nผุดผ่อง\nผุดผาด\nผู้คน\nผู้คุม\nผู้จัดการ\nผู้ชาย\nผู้เชี่ยวชาญ\nผู้ดี\nผู้โดยสาร\nผู้ต้องขัง\nผู้ต้องหา\nผู้แทน\nผู้น้อย\nผู้บริโภค\nผู้บังคับบัญชา\nผู้ปกครอง\nผู้ประกอบการ\nผู้ป่วย\nผู้พิพากษา\nผู้เยาว์\nผู้ร้าย\nผู้วิเศษ\nผู้สื่อข่าว\nผู้เสียหาย\nผู้หญิง\nผู้ใหญ่\nผู้ใหญ่บ้าน\nผูกขวัญ\nผูกขาด\nผูกพัน\nผูกมัด\nเผชิญหน้า\nเผด็จการ\nเผด็จศึก\nเผยแผ่\nเผยแพร่\nเผละผละ\nเผ่าพันธุ์\nเผื่อแผ่\nแผงลอย\nแผนการ\nแผนงาน\nแผนที่\nแผนผัง\nแผนภาพ\nแผนภูมิ\nแผ่นดิน\nแผ่นเสียง\nแผ้วพาน\nโผงผาง\nฝนทอง\nฝอยทอง\nฝักแค\nฝักบัว\nฝักฝ่าย\nฝักใฝ่\nฝังใจ\nฝังหัว\nฝาชี\nฝาแฝด\nฝาละมี\nฝ่าพระบาท\nฝ่าฝืน\nฝ่าฟัน\nฝ้าฟาง\nฝากตัว\nฝากฝัง\nฝีดาษ\nฝีมะม่วง\nฝีจักร\nฝีเท้า\nฝีปาก\nฝีพาย\nฝีมือ\nฝีเย็บ\nฝึกงาน\nฝึกปรือ\nฝึกฝน\nฝึกสอน\nฝึกหัด\nฝืดเคือง\nใฝ่ฝัน\nพงพี\nพงศ์พันธุ์\nพญาโศก\nพญาไฟ\nพบปะ\nพบพาน\nพรสวรรค์\nพรมคด\nพรมแดน\nพรมมิ\nพรรคพวก\nพรรณราย\nพรวดพราด\nพรหมชาติ\nพรหมลิขิต\nพรหมโลก\nพรหมวิหาร\nพร้อมใจ\nพร้อมพรั่ง\nพร้อมเพรียง\nพร้อมมูล\nพร้อมสรรพ\nพร้อมหน้า\nพระครู\nพระคุณ\nพระเคราะห์\nพระเครื่อง\nพระเจ้า\nพระเจ้าอยู่หัว\nพระชายา\nพระทัย\nพระนาง\nพระนางเจ้า\nพระเป็นเจ้า\nพระผู้เป็นเจ้า\nพระพิมพ์\nพระพุทธเจ้า\nพระพุทธองค์\nพระภูมิ\nพระยา\nพระรอง\nพระสนม\nพระสนมเอก\nพระองค์\nพระองค์เจ้า\nพระเอก\nพรั่งพร้อม\nพรั่งพรู\nพรั่นพรึง\nพร่างพราว\nพรายน้ำ\nพรายแพรว\nพราวแพรว\nพร่ำพลอด\nพร่ำเพรื่อ\nพร่ำเพ้อ\nพริกไทย\nพริ้งพราย\nพริ้งเพรา\nพริ้งเพริศ\nพริบตา\nพริ้มพราย\nพริ้มเพรา\nพรุ่งนี้\nพฤติกรรม\nพฤติการณ์\nพฤตินัย\nพลการ\nพลขับ\nพลความ\nพลเมือง\nพลรบ\nพลร่ม\nพลเรือน\nพลโลก\nพลศึกษา\nพลบค่ำ\nพลอดรัก\nพลังงาน\nพลังเงียบ\nพลังจิต\nพลั้งปาก\nพลั้งเผลอ\nพลั้งพลาด\nพลัดถิ่น\nพลัดพราก\nพลาดท่า\nพลาดพลั้ง\nพลิกแพลง\nพลีกรรม\nพลุ่งพล่าน\nพวกพ้อง\nพวงมาลัย\nพวงมาลา\nพวงหรีด\nพวงคราม\nพวงชมพู\nพวงแสด\nพ่วงพี\nพวยน้ำ\nพวยพุ่ง\nพสกนิกร\nพหุคูณ\nพหุภาคี\nพหูพจน์\nพหูสูต\nพอควร\nพอใจ\nพอใช้\nพอใช้ได้\nพอดี\nพอตัว\nพอทำเนา\nพอประมาณ\nพอเพียง\nพอแรง\nพอสมควร\nพอเหมาะ\nพ่อขุน\nพ่อครัว\nพ่อตา\nพ่อบ้าน\nพ่อพันธุ์\nพ่อม่าย\nพ่อเมือง\nพ่อเลี้ยง\nพ่อสื่อ\nพอกพูน\nพ้องพาน\nพักผ่อน\nพักพิง\nพักฟื้น\nพักร้อน\nพักแรม\nพัดยศ\nพัดลม\nพันพัว\nพับฐาน\nพับเพียบ\nพัวพัน\nพาซื่อ\nพาดพิง\nพิณพาทย์\nพิธีกร\nพิธีกรรม\nพิธีการ\nพิธีรีตอง\nพิธีสาร\nพินัยกรรม\nพิมพ์เขียว\nพิมพ์ใจ\nพิมพ์ดีด\nพิษสง\nพี่น้อง\nพี่เบิ้ม\nพี่เลี้ยง\nพึงใจ\nพึงพอใจ\nพึ่งพา\nพึ่งพิง\nพืชพันธุ์\nพืชมงคล\nพื้นฐาน\nพื้นที่\nพื้นบ้าน\nพื้นเพ\nพื้นเมือง\nพื้นเสีย\nพุพอง\nพุทธกาล\nพุทธคุณ\nพุทธจักร\nพุทธเจดีย์\nพุทธฎีกา\nพุทธปฏิมา\nพุทธปฏิมากร\nพุทธมามกะ\nพุทธศักราช\nพุทธศาสนิกชน\nพุทธองค์\nพุทธชาด\nพุทธรักษา\nพุ่มพวง\nพุ่มไม้\nพู่กัน\nพูดจา\nเพ่งเล็ง\nเพดานบิน\nเพดานปาก\nเพริศพราย\nเพริศพริ้ง\nเพริศแพร้ว\nเพรียกพร้อง\nเพรียวลม\nเพลงเชิด\nเพลงยาว\nเพลิงกัลป์\nเพลินใจ\nเพลินตา\nเพลี่ยงพล้ำ\nเพ้อฝัน\nเพาะกาย\nเพาะชำ\nเพาะปลูก\nเพิกถอน\nเพิกเฉย\nเพิ่มเติม\nเพิ่มพูน\nเพียงตา\nเพียงพอ\nเพียบแประ\nเพียบพร้อม\nเพื่อนเกลอ\nเพื่อนตาย\nเพื่อนบ้าน\nเพื่อนฝูง\nเพื่อนยาก\nแพ้ท้อง\nแพร่หลาย\nแพร่งพราย\nแพรวพราว\nโพธิญาณ\nโพธิบัลลังก์\nโพธิสมภาร\nโพธิสัตว์\nโพ้นทะเล\nโพยภัย\nไพ่ตาย\nไพ่ป๊อก\nไพรวัน\nไพรสณฑ์\nไพรสัณฑ์\nไพร่พล\nไพร่ฟ้า\nไพร่สม\nไพร่ส่วย\nไพร่หลวง\nฟกช้ำ\nฟองเต้าหู้\nฟองน้ำ\nฟองมัน\nฟ้องกลับ\nฟ้องร้อง\nฟอนเฟะ\nฟักทอง\nฟัดเฟียด\nฟันดาบ\nฟันฝ่า\nฟันแท้\nฟันน้ำนม\nฟันปลา\nฟันฟาง\nฟันเฟือง\nฟันม้า\nฟันเลื่อย\nฟันหนู\nฟั่นเฝือ\nฟั่นเฟือน\nฟื้นตัว\nฟื้นฝอย\nฟื้นฟู\nฟุ้งซ่าน\nฟุ้งเฟ้อ\nฟุ้งเฟื่อง\nฟุตบอล\nฟูฟ่อง\nฟูเฟื่อง\nฟูมฟัก\nฟูมฟาย\nเฟะฟะ\nเฟื่องฟ้า\nเฟื่องฟุ้ง\nเฟื่องฟู\nไฟฉาย\nไฟแช็ก\nไฟธาตุ\nไฟฟ้า\nภัตกิจ\nภาคทัณฑ์\nภาคพื้น\nภาคเรียน\nภาคภูมิ\nภาพถ่าย\nภาพนิ่ง\nภาพประกอบ\nภาพพจน์\nภาพยนตร์\nภาพลวงตา\nภาพลักษณ์\nภายนอก\nภายใน\nภายหน้า\nภายหลัง\nภารกิจ\nภารธุระ\nภารโรง\nภารตวิทยา\nภาษาศาสตร์\nภาสกร\nภิญโญภาพ\nภินชาติ\nภูธร\nภูธเรศ\nภูบาล\nภูเบศ\nภูเบศวร์\nภูเขา\nภูเขาไฟ\nภูผา\nภูตคาม\nภูตบดี\nภูตรูป\nภูเตศวร\nภูมินทร์\nภูมิบาล\nภูมิประเทศ\nภูมิภาค\nภูมิรัฐศาสตร์\nภูมิลำเนา\nภูมิศาสตร์\nภูมิอากาศ\nภูมิธรรม\nภูมิปัญญา\nภูมิรู้\nภูมิใจ\nภูมิฐาน\nภูมิคุ้มกัน\nภูมิแพ้\nภูษาโยง\nเภทภัย\nเภสัชกร\nเภสัชกรรม\nเภสัชวิทยา\nเภสัชศาสตร์\nโภคทรัพย์\nโภคภัณฑ์\nโภชนากร\nโภชนาการ\nมกุฎราชกุมาร\nมงคลแฝด\nมงคลสูตร\nมงคลหัตถี\nมณเฑียรบาล\nมดดำ\nมดแดง\nมดเท็จ\nมดยอบ\nมดลูก\nมธุปายาส\nมธุรส\nมนเทียรบาล\nมนุษย์กบ\nมโนกรรม\nมโนคติ\nมโนทุจริต\nมโนธรรม\nมโนภาพ\nมโนมัย\nมโนรถ\nมโนรมย์\nมโนสุจริต\nมรรคนายก\nมรรคผล\nมฤคชาติ\nมฤคทายวัน\nมฤคราช\nมลทิน\nมลพิษ\nมลสาร\nมวกเหล็ก\nม้วนหน้า\nมวยไทย\nมวยปล้ำ\nมวยล้ม\nมวยวัด\nมวยสากล\nมวยหมู่\nมวลสาร\nมอคราม\nมอซอ\nมอหมึก\nมองเมียง\nมอบตัว\nมอบหมาย\nมอมเมา\nมะขามเทศ\nมะขามป้อม\nมะขามเปียก\nมะเขือเทศ\nมะเขือพวง\nมะพร้าวแก้ว\nมักคุ้น\nมักจี่\nมักง่าย\nมักน้อย\nมักมาก\nมักใหญ่\nมั่งคั่ง\nมั่งมี\nมัจจุราช\nมัชฌิมนิกาย\nมัชฌิมประเทศ\nมัชฌิมยาม\nมัชฌิมวัย\nมัดจำ\nมัดหมี่\nมัธยมกาล\nมัธยมศึกษา\nมันแกว\nมันเทศ\nมันฝรั่ง\nมันเปลว\nมันสมอง\nมั่นคง\nมั่นใจ\nมั่นหมาย\nมั่นเหมาะ\nมัวเมา\nมัวหมอง\nมั่วสุม\nม้าเทศ\nม้าน้ำ\nม้ามืด\nม้าเร็ว\nม้าล่อ\nม้าลาย\nมากมาย\nมาตรการ\nมาตรฐาน\nมาตราส่วน\nมาตุคาม\nมาตุฆาต\nมาตุภูมิ\nม่านตา\nม่านบังตา\nมายากร\nมายากล\nมายาการ\nมายาวี\nมารผจญ\nมารวิชัย\nมารสังคม\nมารหัวขน\nมาลาการ\nมิ่งขวัญ\nมิ่งมิตร\nมิจฉาจาร\nมิจฉาชีพ\nมิดชิด\nมิดเมี้ยน\nมิดหมี\nมิตรจิต\nมิตรภาพ\nมิตรสหาย\nมิน่า\nมีหน้า\nมีดโกน\nมีดดาบ\nมีดโต้\nมีดพก\nมีดพับ\nมีดสั้น\nมึนงง\nมึนชา\nมึนตึง\nมึนเมา\nมืดครึ้ม\nมืดมน\nมืดมัว\nมือจับ\nมือดี\nมือเติบ\nมือปืน\nมือเปล่า\nมือมืด\nมือสอง\nมือเสือ\nมือหนึ่ง\nมือใหม่\nมุกตลก\nมุขปาฐะ\nมุขมนตรี\nมุ่งมั่น\nมุ่งมาด\nมุ่งหน้า\nมุ่งหมาย\nมุ่งหวัง\nมุ้งลวด\nมุ้งสายบัว\nมุมก้ม\nมุมกลับ\nมุมเงย\nมุมฉาก\nมุมตรง\nมุมป้าน\nมุมมืด\nมุมแย้ง\nมุมสะท้อน\nมุมหักเห\nมุมแหลม\nมุสาวาท\nมูกเลือด\nมูกมัน\nมูกหลวง\nมูนดิน\nมูลฐาน\nมูลนาย\nมูลนิธิ\nมูลเหตุ\nมูลค่า\nมูลฝอย\nเม็ดเงิน\nเม็ดเลือด\nเม็ดโลหิต\nเม่นทะเล\nเมรุมาศ\nเมรุราช\nเมล์อากาศ\nเมาดิบ\nเมามัน\nเมามัว\nเมามาย\nเมินเฉย\nเมียน้อย\nเมียหลวง\nเมียงมอง\nเมี่ยงลาว\nเมี่ยงส้ม\nเมื่อกี้\nเมื่อตะกี้\nเมื่อใด\nเมื่อไร\nเมื่อไหร่\nเมื่อนั้น\nเมืองขึ้น\nเมืองท่า\nเมืองนอก\nเมืองหลวง\nเมื่อยขบ\nเมื่อยล้า\nแม่กอง\nแม่กุญแจ\nแม่คุณ\nแม่งาน\nแม่เจ้า\nแม่ชี\nแม่ทัพ\nแม่นม\nแม่น้ำ\nแม่บท\nแม่บ้าน\nแม่เบี้ย\nแม่พระ\nแม่พิมพ์\nแม่เพลง\nแม่มด\nแม่ม่าย\nแม่ไม้\nแม่ยก\nแม่ยาย\nแม่ร้าง\nแม่เรือน\nแม่แรง\nแม่เล้า\nแม่เลี้ยง\nแม่สี\nแม่สื่อ\nแม่เหล็ก\nแมงมุม\nแม่นยำ\nแมลงช้าง\nแมลงวัน\nแมลงปอ\nแมลงภู่\nแมลงเม่า\nแมวเซา\nแมวน้ำ\nแมวป่า\nแมวมอง\nไม้กลัด\nไม้กวาด\nไม้กางเขน\nไม้เกาหลัง\nไม้ขีดไฟ\nไม้จิ้มฟัน\nไม้เด็ด\nไม้ตาย\nไม้ตีพริก\nไม้ที\nไม้เท้า\nไม้บรรทัด\nไม้เมตร\nไม้ระแนง\nไม้เรียว\nไม้หมอน\nไม้อัด\nไม้จัตวา\nไม้ตรี\nไม้ไต่คู้\nไม้โท\nไม้ผัด\nไม้มลาย\nไม้ม้วน\nไม้ยมก\nไม้หน้า\nไม้หันอากาศ\nไม้เอก\nยกกลีบ\nยกครู\nยกเครื่อง\nยกเค้า\nยกทรง\nยกฟ้อง\nยกเมฆ\nยกยอ\nยกย่อง\nยกเลิก\nยกเว้น\nย่นย่อ\nยมทูต\nยมบาล\nยมราช\nยมโลก\nยวดยิ่ง\nยวดยาน\nยวนยี\nยวบยาบ\nย่อท้อ\nย่อส่วน\nย่อหน้า\nย่อหย่อน\nยอกย้อน\nยองใย\nย่องเบา\nย่องแย่ง\nยอดเยี่ยม\nยอดอก\nย้อนยอก\nย้อนรอย\nย้อนศร\nย้อนแสง\nย้อนหลัง\nยอบแยบ\nยอมความ\nย่อมเยา\nย่อยยับ\nยักยอก\nยักย้าย\nยักเยื้อง\nยัญกรรม\nยัญพิธี\nยัดเยียด\nยับเยิน\nยับยั้ง\nยั่วยวน\nยั่วยุ\nยั่วเย้า\nยากวาด\nยากันยุง\nยาเขียว\nยาใจ\nยาฉุน\nยาชา\nยาซัด\nยาดอง\nยาแดง\nยาถ่าย\nยาธาตุ\nยานัตถุ์\nยาเบื่อ\nยาโป๊\nยาแฝด\nยาพิษ\nยาระบาย\nยาสลบ\nยาสั่ง\nยาสีฟัน\nยาสูบ\nยาเส้น\nยาเสพติด\nยาหม่อง\nยาเหลือง\nย่าทวด\nย่านาง\nยากแค้น\nยากจน\nยากเย็น\nยากไร้\nยางนอก\nยางใน\nยางมะตอย\nยางมะตูม\nยางลบ\nยางสน\nยางอาย\nย่างกราย\nย่างเยื้อง\nย่างสด\nย่างสามขุม\nย่างเหยียบ\nยานเกราะ\nยานพาหนะ\nยานอวกาศ\nยานคาง\nยายทวด\nยาวเฟื้อย\nยาวยืด\nยาวเหยียด\nยำทวาย\nยำใหญ่\nยำเกรง\nยำเยง\nย่ำต๊อก\nย่ำยี\nย่ำแย่\nยิงเป้า\nยิ่งนัก\nยิ่งยวด\nยิ่งใหญ่\nยินดี\nยินยอม\nยินร้าย\nยิ้มกริ่ม\nยิ้มแฉ่ง\nยิ้มแต้\nยิ้มแป้น\nยิ้มเผล่\nยิ้มเยาะ\nยิ้มแย้ม\nยียวน\nยึดครอง\nยึดถือ\nยึดมั่น\nยึดเหนี่ยว\nยืดยาด\nยืดยาว\nยืดเยื้อ\nยืดหยุ่น\nยืดอก\nยืนกราน\nยืนต้น\nยืนพื้น\nยืนยง\nยืนยัน\nยืนหยัด\nยื้อยุด\nยุยง\nยุแยง\nยุแหย่\nยุคลบาท\nยุคเข็ญ\nยุคทอง\nยุคมืด\nยุ่งขิง\nยุ่งยาก\nยุ่งเหยิง\nยุติธรรม\nยุทธการ\nยุทธนาวี\nยุทธปัจจัย\nยุทธภัณฑ์\nยุทธภูมิ\nยุทธวิธี\nยุทธศาสตร์\nยุทธหัตถี\nยุทธนาการ\nยุทธนาธิการ\nยุบยับ\nยุบยิบ\nยุพราช\nยู่ยี่\nเย็นเจี๊ยบ\nเย็นใจ\nเย็นฉ่ำ\nเย็นเฉียบ\nเย็นชา\nเย็นชืด\nเย็นตา\nเย็นเยียบ\nเย็นเยือก\nเย็นวาบ\nเย็นวูบ\nเย็บกี่\nเย็บจักร\nเย็บด้าย\nเย้ยหยัน\nเย้าหยอก\nเยาะเย้ย\nเยี่ยมกราย\nเยี่ยมเยียน\nเยี่ยมเยือน\nเยี่ยมยอด\nเยื่อเคย\nเยื่อใย\nเยือกเย็น\nเยื้องกราย\nเยื้องยัก\nเยื้องย่าง\nแยกย้าย\nแยกแยะ\nแย่งชิง\nแยบคาย\nแยบยล\nแย้มพราย\nแย้มยิ้ม\nแย้มสรวล\nโยเย\nโย้เย้\nโยกโคลง\nโยกย้าย\nโยกโย้\nโยนกลอง\nใยหิน\nรกชัฏ\nรกร้าง\nรกเรี้ยว\nรกเรื้อ\nรกราก\nรงควัตถุ\nรชนีกร\nรถกระบะ\nรถเก๋ง\nรถเข็น\nรถแข่ง\nรถจักร\nรถจี๊ป\nรถตู้\nรถทัวร์\nรถบรรทุก\nรถพ่วง\nรถพยาบาล\nรถไฟ\nรถไฟฟ้า\nรถม้า\nรถเมล์\nรถยนต์\nรถราง\nรถลาก\nรถสปอร์ต\nรถสิบล้อ\nรบกวน\nรบรา\nรบเร้า\nรมดำ\nร่มเกล้า\nร่มชูชีพ\nร่มเย็น\nร่มรื่น\nร่วงโรย\nรวงผึ้ง\nรวงรัง\nรวดเร็ว\nรวนเร\nรวบยอด\nรวบรวม\nรวบรัด\nรวมพล\nรวมหัว\nร่วมใจ\nร่วมเพศ\nร่วมมือ\nร่วมรัก\nร่วมสมัย\nรวยริน\nรวยรื่น\nรสชาติ\nรสนิยม\nรองท้อง\nรองเท้า\nรองพื้น\nร่องน้ำ\nร่องรอย\nร้องขอ\nร้องทุกข์\nร้องเรียน\nร้องห่ม\nร้องไห้\nรองช้ำ\nรองทรง\nรอดชีวิต\nรอดตัว\nรอดตาย\nรอนแรม\nร่อนเร่\nร้อนใจ\nร้อนตัว\nร้อนรน\nร้อนรุ่ม\nร้อนวิชา\nร้อนอาสน์\nรอบจัด\nรอบเดือน\nรอบรู้\nรอยร้าว\nร่อยหรอ\nร้อยละ\nร้อยกรอง\nร้อยแก้ว\nร้อยหวาย\nระนาดทุ้ม\nระนาดเอก\nระเบิดขวด\nระเบิดมือ\nระเบียบการ\nรักใคร่\nรักษาการ\nรักษาการณ์\nรังไข่\nรังแตน\nรังนก\nรังผึ้ง\nรังเพลิง\nรังมด\nรังสรรค์\nรังสฤษฏ์\nรั้งรอ\nรังสีแพทย์\nรังสีวิทยา\nรัชกาล\nรัชทายาท\nรัชนีกร\nรัฐธรรมนูญ\nรัฐบาล\nรัฐบุรุษ\nรัฐประศาสน์\nรัฐประหาร\nรัฐพิธี\nรัฐมนตรี\nรัฐวิสาหกิจ\nรัฐศาสตร์\nรัฐสภา\nรัดกุม\nรัดเกล้า\nรัดตัว\nรัดประคด\nรัดรึง\nรัดรูป\nรัตติกาล\nรับขวัญ\nรับจ้าง\nรับช่วง\nรับใช้\nรับซื้อ\nรับทราบ\nรับประกัน\nรับประทาน\nรับปาก\nรับผิด\nรับผิดชอบ\nรับฟ้อง\nรับฟัง\nรับมือ\nรับรอง\nรับรู้\nรับสมัคร\nรับสั่ง\nรับหน้า\nรับเหมา\nรั่วไหล\nรามือ\nร่าเริง\nรากแก้ว\nรากขวัญ\nรากฐาน\nรากฟัน\nรากศัพท์\nรากเหง้า\nร่างกาย\nร่างแห\nร้างรา\nราชกรณียกิจ\nราชการ\nราชกิจ\nราชครู\nราชฐาน\nราชทัณฑ์\nราชทินนาม\nราชทูต\nราชธานี\nราชนาวี\nราชบัณฑิต\nราชบัลลังก์\nราชบาตร\nราชบุตร\nราชปะแตน\nราชภัฏ\nราชมัล\nราชยาน\nราชรถ\nราชลัญจกร\nราชเลขาธิการ\nราชเลขานุการ\nราชวงศ์\nราชวัติ\nราชสกุล\nราชสมบัติ\nราชสาส์น\nราชหัตถเลขา\nราชองครักษ์\nราชโองการ\nราชาคณะ\nราชาศัพท์\nราชินีนาถ\nร้านชำ\nร้านรวง\nราบคาบ\nราบรื่น\nราบเรียบ\nรายการ\nรายงาน\nรายจ่าย\nรายได้\nรายทาง\nรายรับ\nรายล้อม\nรายละเอียด\nรายวิชา\nร่ายยาว\nร่ายรำ\nร้ายกาจ\nร้ายแรง\nราวนม\nราวป่า\nร้าวฉาน\nร้าวราน\nรำพัด\nรำแพน\nรำวง\nร่ำไป\nร่ำร้อง\nร่ำเรียน\nร่ำไร\nร่ำลา\nร่ำไห้\nริเริ่ม\nริอ่าน\nริมฝีปาก\nริ้วรอย\nรีบร้อน\nรีบรุด\nรีบเร่ง\nรื่นรมย์\nรื่นเริง\nรื้อถอน\nรื้อฟื้น\nรุกฆาต\nรุกราน\nรุกล้ำ\nรุกไล่\nรุ่งขึ้น\nรุ่งแจ้ง\nรุ่งเช้า\nรุ่งเรือง\nรุ่งโรจน์\nรุ่งสว่าง\nรุ่งสาง\nรุ่งอรุณ\nรุจิเรข\nรุดหน้า\nรุนแรง\nรุมเร้า\nรุมล้อม\nรุ่มรวย\nรุ่มร้อน\nรุ่ยร่าย\nรู้แกว\nรู้ความ\nรู้คุณ\nรู้งาน\nรู้จัก\nรู้แจ้ง\nรู้ใจ\nรู้เชิง\nรู้ตัว\nรู้ทัน\nรู้เท่า\nรู้เรื่อง\nรู้สำนึก\nรู้สึก\nรู้เห็น\nรูปการณ์\nรูปโฉม\nรูปฌาน\nรูปถ่าย\nรูปทรง\nรูปธรรม\nรูปแบบ\nรูปพรรณ\nรูปพรหม\nรูปภพ\nรูปภาพ\nรูปร่าง\nรูปสมบัติ\nเร่ร่อน\nเร่งด่วน\nเร่งมือ\nเร่งรัด\nเร่งรีบ\nเร่งเร้า\nเร้นลับ\nเร่อร่า\nเร่าร้อน\nเราะราย\nเราะร้าย\nเริงใจ\nเริงรมย์\nเริดร้าง\nเริ่มต้น\nเริ่มแรก\nเรี่ยราด\nเรี่ยไร\nเรียกคืน\nเรียกตัว\nเรียกร้อง\nเรียกหา\nเรียบร้อย\nเรียงความ\nเรียงตัว\nเรียงเบอร์\nเรียงพิมพ์\nเรียงเม็ด\nเรียงราย\nเรียนรู้\nเรียบร้อย\nเรียบเรียง\nเรียบวุธ\nเรี่ยมเร้\nเรี่ยวแรง\nเรือกลไฟ\nเรือกอและ\nเรือกำปั่น\nเรือจ้าง\nเรือดำน้ำ\nเรือโดยสาร\nเรือตรวจการณ์\nเรือตังเก\nเรือธง\nเรือนำร่อง\nเรือบด\nเรือบิน\nเรือใบ\nเรือประมง\nเรือพ่วง\nเรือพิฆาต\nเรือยนต์\nเรือยาว\nเรือโยง\nเรือรบ\nเรือลากจูง\nเรือสำปั้น\nเรือสำเภา\nเรือหลวง\nเรือหางยาว\nเรืออีโปง\nเรือเอี้ยมจุ๊น\nเรื้อรัง\nเรือกสวน\nเรืองนาม\nเรืองรอง\nเรืองแสง\nเรื่องราว\nเรื่องสั้น\nเรือนแก้ว\nเรือนจำ\nเรือนเบี้ย\nเรือนแพ\nเรือนหอ\nเรื่อยเจื้อย\nเรื่อยเฉื่อย\nเรื่อยเปื่อย\nแรเงา\nแรกนา\nแรกนาขวัญ\nแรงงาน\nแรงดึงดูด\nแรงเทียน\nแรงม้า\nแรงเหวี่ยง\nแรมรอน\nแรมรา\nแรมโรย\nโรคจิต\nโรงครัว\nโรงงาน\nโรงเจ\nโรงเตี๊ยม\nโรงทาน\nโรงนา\nโรงพยาบาล\nโรงพัก\nโรงพิมพ์\nโรงเรียน\nโรงเรือน\nโรงแรม\nโรงเลี้ยง\nโรงเลื่อย\nโรงสี\nโรงสีข้าว\nโรงอาหาร\nโรมรัน\nโรยรา\nฤชากร\nฤดูกาล\nลงขัน\nลงแขก\nลงคอ\nลงตัว\nลงท้าย\nลงทุน\nลงโทษ\nลงพุง\nลงมือ\nลงรัก\nลงรอย\nลงแรง\nลงโรง\nลงเอย\nลดตัว\nลดละ\nลดเลี้ยว\nลดหย่อน\nลดหลั่น\nลนลาน\nล้นพ้น\nล้นหลาม\nล้นเหลือ\nลบล้าง\nลบเลือน\nลบหลู่\nลมกรด\nลมค้า\nลมงวง\nลมแดด\nลมทะเล\nลมบก\nลมบน\nลมบ้าหมู\nลมปราณ\nลมปาก\nลมพิษ\nลมว่าว\nลมเสีย\nลมหนาว\nลมหายใจ\nล่มจม\nล่มสลาย\nล้มละลาย\nล้มลุก\nล้มเลิก\nล่วงเกิน\nล่วงรู้\nล่วงละเมิด\nล่วงลับ\nล่วงล้ำ\nล่วงเลย\nล่วงหน้า\nลวดลาย\nลวดสปริง\nลวดหนาม\nล้วนแล้ว\nลหุโทษ\nล่อลวง\nล่อหลอก\nล่อแหลม\nล้อต๊อก\nล้อเลื่อน\nล้อเล่น\nล้อเลียน\nล้อหลอก\nลองเชิง\nลองดี\nลองภูมิ\nล่องหน\nลอดช่อง\nล่อนจ้อน\nลอบกัด\nล้อมวง\nลอยแก้ว\nลอยชาย\nลอยตัว\nลอยนวล\nลอยแพ\nลอยลำ\nละทิ้ง\nละเลย\nละเว้น\nละครนอก\nละครใน\nละครเพลง\nละครร้อง\nละครรำ\nละครลิง\nละครสัตว์\nละเอียดอ่อน\nลักไก่\nลักพา\nลักเพศ\nลักยิ้ม\nลักลอบ\nลักลั่น\nลักหลับ\nลัดเลาะ\nลับตา\nลับแล\nลับหลัง\nลาออก\nล่าช้า\nล่าทัพ\nล้าสมัย\nล้าหลัง\nลากข้าง\nล้างบาง\nล้างผลาญ\nลาดเขา\nลาดตระเวน\nลาดเท\nลาดยาง\nลานบิน\nลาภปาก\nลาภลอย\nลามปาม\nลามเลีย\nลายคราม\nลายเซ็น\nลายแทง\nลายน้ำ\nลายพร้อย\nลายมือ\nลายลักษณ์\nลายเส้น\nลำกล้อง\nลำแข้ง\nลำธาร\nลำแสง\nลำไส้\nลำตัด\nลำนำ\nล่ำสัน\nล้ำยุค\nล้ำสมัย\nล้ำลึก\nล้ำเลิศ\nล้ำเส้น\nล้ำหน้า\nลิงจุ่น\nลิงลม\nลิงโลด\nลิดรอน\nลิ้นไก่\nลิ้นชัก\nลิ้นปี่\nลิ้นควาย\nลิ้นงูเห่า\nลิ้นหมา\nลิบลับ\nลิบลิ่ว\nลิ่มเลือด\nลี้ภัย\nลี้ลับ\nลึกซึ้ง\nลึกลับ\nลึกล้ำ\nลืมตน\nลืมต้น\nลืมตัว\nลืมตา\nลืมเลือน\nลือชา\nลือชื่อ\nลือลั่น\nลุล่วง\nลุกลน\nลุกลาม\nลุกลี้ลุกลน\nลุกฮือ\nลุ่มน้ำ\nลุ่มลึก\nลุ่มหลง\nลุ่ทาง\nลูกกรง\nลูกกรอก\nลูกกรุง\nลูกกลอน\nลูกกลิ้ง\nลูกกวาด\nลูกกะจ๊อก\nลูกกุญแจ\nลูกเกด\nลูกแก้ว\nลูกขนไก่\nลูกข่าง\nลูกขุน\nลูกเขย\nลูกครึ่ง\nลูกคลื่น\nลูกความ\nลูกคอ\nลูกค้า\nลูกคิด\nลูกคู่\nลูกจ้าง\nลูกช้าง\nลูกชิด\nลูกชิ้น\nลูกชุบ\nลูกซอง\nลูกโซ่\nลูกดอก\nลูกดิ่ง\nลูกตะกั่ว\nลูกตุ้ม\nลูกเต้า\nลูกเต๋า\nลูกถ้วย\nลูกทุ่ง\nลูกเธอ\nลูกน้อง\nลูกน้ำ\nลูกนิมิต\nลูกบอล\nลูกบ้าน\nลูกบาศก์\nลูกบิด\nลูกเบี้ยว\nลูกประคบ\nลูกประคำ\nลูกปัด\nลูกปืน\nลูกโป่ง\nลูกผสม\nลูกผู้ชาย\nลูกผู้หญิง\nลูกพรรค\nลูกพี่\nลูกฟูก\nลูกไฟ\nลูกมือ\nลูกโม่\nลูกไม้\nลูกยาเธอ\nลูกรอก\nลูกรัง\nลูกเรือ\nลูกล้อ\nลูกลอย\nลูกเล่น\nลูกเลี้ยง\nลูกโลก\nลูกวัด\nลูกศร\nลูกศิษย์\nลูกสมุน\nลูกสะใภ้\nลูกสูบ\nลูกเสือ\nลูกหนัง\nลูกหนี้\nลูกหนู\nลูกหมาก\nลูกหลง\nลูกหลาน\nลูกหาบ\nลูกหิน\nลูกเห็บ\nลูกเหม็น\nลูกแหง่\nลูกอม\nลูกหม้อ\nลูบคม\nลูบคลำ\nลูบไล้\nเล็กน้อย\nเลขคณิต\nเลขผา\nเลขหมาย\nเล็ดลอด\nเล่นงาน\nเล่นแง่\nเล่นชู้\nเล่นตัว\nเล่นลิ้น\nเล่นหัว\nเลนส์นูน\nเลนส์เว้า\nเล็บครุฑ\nเลยเถิด\nเลศนัย\nเล่ห์กล\nเล่ห์เหลี่ยม\nเลอโฉม\nเลอมาน\nเลอเลิศ\nเลอสรวง\nเล่อล่า\nเลอะเลือน\nเล่าเรียน\nเล่าลือ\nเลาะลัด\nเลิกรา\nเลิกร้าง\nเลิกล้ม\nเลิศเลอ\nเลี้ยงชีพ\nเลี้ยงดู\nเลี้ยงต้อย\nเลียบเคียง\nเลี้ยวลด\nเลือกตั้ง\nเลือกเฟ้น\nเลือกสรร\nเลื่องลือ\nเลือดกำเดา\nเลือดเนื้อ\nเลือดฝาด\nเลือดเย็น\nเลือดร้อน\nเลือดหมู\nเลือดอุ่น\nเลือนราง\nเลื่อนเปื้อน\nเลื่อนลอย\nเลื่อมพราย\nเลื่อมใส\nเลื่อยฉลุ\nเลื่อยลันดา\nเลื่อยวงเดือน\nเลื้อยคลาน\nแลเหลียว\nแลกเปลี่ยน\nแล้วกัน\nและเล็ม\nโล่งใจ\nโล่งโถง\nโล่งอก\nโลดเต้น\nโลดโผน\nโลดลิ่ว\nโลดแล่น\nไล่ที่\nไล่เบี้ย\nไล่เลี่ย\nไล่เลียง\nไล่หลัง\nไล่ออก\nวกวน\nวงกบ\nวงกลม\nวงการ\nวงแขน\nวงเงิน\nวงจร\nวงนอก\nวงใน\nวงรี\nวงเล็บ\nวงเวียน\nวงแหวน\nวงศ์วาน\nวจีกรรม\nวจีเภท\nวจีภาค\nวนเวียน\nวอดวาย\nว็อบแว็บ\nวังวน\nวังหน้า\nวังหลวง\nวังหลัง\nวัดราษฎร์\nวัดวา\nวัดหลวง\nวัดผล\nวัดพื้น\nวัตถุนิยม\nวัตถุประสงค์\nวัตรปฏิบัติ\nวันโกน\nวันพระ\nวันเพ็ญ\nวัยรุ่น\nวัยวุฒิ\nว่ากล่าว\nว่าจ้าง\nว่าด้วย\nว่าที่\nวางก้าม\nวางใจ\nวางตัว\nวางตา\nวางโต\nวางท่า\nวางมวย\nวางมาด\nวางมือ\nวางวาย\nว่างเปล่า\nว่างเว้น\nวาดเขียน\nว่านเครือ\nวาบหวาม\nวายชนม์\nวายปราณ\nวายวาง\nวายวอด\nวายร้าย\nวายุภักษ์\nวาววับ\nวาววาม\nวาวแวว\nวาวแสง\nวิกฤตการณ์\nวิกฤติการณ์\nวิกฤตกาล\nวิกฤติกาล\nวิกลจริต\nวิงเวียน\nวิ่งเต้น\nวิ่งผลัด\nวิ่งรอก\nวิ่งราว\nวิจิตรศิลป์\nวิชาการ\nวิชาชีพ\nวิชาธร\nวิญญูชน\nวิดพื้น\nวิตกจริต\nวิถีทาง\nวิทยากร\nวิทยากล\nวิทยาการ\nวิทยาเขต\nวิทยาทาน\nวิทยาธร\nวิทยานิพนธ์\nวิทยาศาสตร์\nวิเทศสัมพันธ์\nวิธีการ\nวินัยธร\nวินัยปิฎก\nวินาศกรรม\nวินาศภัย\nวินาศสันตะโร\nวิภัชพยากรณ์\nวิภัชวาที\nวิไลวรรณ\nวิสัญญีแพทย์\nวิสัญญีภาพ\nวิสัญญีวิทยา\nวุฒิบัตร\nวุฒิสภา\nวุฒิสมาชิก\nวุ่นวาย\nวุ้นเส้น\nวูบวาบ\nเวจกุฎี\nเวจมรรค\nเวชกรรม\nเวชภัณฑ์\nเวชศาสตร์\nเวทมนตร์\nเวนคืน\nเวรกรรม\nเวฬุการ\nเวฬุวัน\nเว้าวอน\nเวิ้งว้าง\nเวียงวัง\nเวียนเทียน\nแว้งกัด\nแวดล้อม\nแวดวง\nแว่นขยาย\nแว่นแคว้น\nแว่นตา\nแวบวับ\nแววตา\nแวววาม\nแวววาว\nแวะเวียน\nโวยวาย\nไวไฟ\nไว้ใจ\nไว้ชื่อ\nไว้ตัว\nไว้ทุกข์\nไว้ลาย\nไว้หน้า\nไว้อาลัย\nศนิวาร\nศอกกลับ\nศอกกำ\nศอกกำมา\nศักดิ์ศรี\nศักดิ์สิทธิ์\nศารทวิษุวัติ\nศาลแขวง\nศาลจังหวัด\nศาลชั้นต้น\nศาลฎีกา\nศาลเตี้ย\nศาลทหาร\nศาลปกครอง\nศาลพระภูมิ\nศาลเพียงตา\nศาลแพ่ง\nศาลรัฐธรรมนูญ\nศาลแรงงาน\nศาลล้มละลาย\nศาลโลก\nศาลสูง\nศาลสูงสุด\nศาลอาญา\nศาลอุทธรณ์\nศาลากลาง\nศาลาดิน\nศาลาราย\nศาลาวัด\nศิลาฤกษ์\nศิลาแลง\nศิษย์เก่า\nศิษย์เอก\nศีลจุ่ม\nศีลธรรม\nศีลวัต\nศีลอด\nศูนย์กลาง\nศูนย์การค้า\nศูนย์ถ่วง\nศูนย์สูตร\nศูนย์หน้า\nเศร้าใจ\nเศร้าโศก\nเศร้าสร้อย\nเศร้าสลด\nเศร้าหมอง\nเศวตฉัตร\nเศษเกิน\nเศษซ้อน\nเศษวรรค\nเศษส่วน\nเศษเหล็ก\nโศกนาฏกรรม\nโศกศัลย์\nโศกเศร้า\nโศกสลด\nสกลโลก\nส่งเดช\nส่งท้าย\nส่งเสริม\nส่งเสีย\nส่งเสียง\nสงบเงียบ\nสงบเสงี่ยม\nสง่างาม\nสง่าราศี\nสดชื่น\nสดใส\nสตรีเพศ\nสติปัญญา\nสถลมารค\nสถานกงสุล\nสถานที่\nสถานทูต\nสถานการณ์\nสถานภาพ\nสถิติศาสตร์\nสนตะพาย\nสนใจ\nส้นตีน\nสนธิสัญญา\nสนนราคา\nสนับแข้ง\nสนับเพลา\nสนับมือ\nสนามบิน\nสนามเพลาะ\nสนิทสนม\nสนิมขุม\nสนิมสร้อย\nสนุกสนาน\nสบประมาท\nสบายใจ\nสภาพธรรม\nสมควร\nสมจริง\nสมใจ\nสมนัย\nสมน้ำหน้า\nสมประกอบ\nสมส่วน\nสมหวัง\nสมคบ\nสมทบ\nสมยอม\nสมรัก\nสมรู้\nสมสู่\nส้มฉุน\nส้มตำ\nส้มลิ้ม\nส้มกุ้ง\nส้มเช้า\nสมญานาม\nสมมติฐาน\nสมมุติฐาน\nสมมติเทพ\nสมรภูมิ\nสมัครใจ\nสมัยนิยม\nสมุทรศาสตร์\nสมุทรเสนา\nสยดสยอง\nสยองขวัญ\nสยามรัฐ\nสรรหา\nสรวมชีพ\nสรวลเส\nสร้อยเศร้า\nสร้างสรรค์\nสร้างเสริม\nสลดใจ\nสลบไสล\nสละสลวย\nสลาเหิน\nสลากภัต\nสวนครัว\nสวนป่า\nสวนสนุก\nสวนหย่อม\nส่วนกลาง\nส่วนเกิน\nส่วนตัว\nส่วนบุญ\nส่วนแบ่ง\nส่วนประกอบ\nส่วนพระองค์\nส่วนผสม\nส่วนรวม\nส่วนร่วม\nส่วนลด\nส่วนสัด\nสวมกอด\nสวมเขา\nสวมรอย\nสวยมภู\nสว่างไสว\nสวามิภักดิ์\nสวิงสวาย\nสสารนิยม\nส่อเสียด\nสอดคล้อง\nสอดแทรก\nสอดแนม\nสอบถาม\nสอบทาน\nสอบไล่\nสอบสวน\nส้อมเสียง\nสะสวย\nสะแกวัลย์\nสะแกแสง\nสะใจ\nสะเด็ดยาด\nสะเทือนใจ\nสะบัดช่อ\nสั่งสม\nสั่งสอน\nสั่งเสีย\nสังเกตการณ์\nสังคมนิยม\nสังคมวิทยา\nสังคมศาสตร์\nสังคมศึกษา\nสังคมสงเคราะห์\nสัญญาบัตร\nสัดส่วน\nสัตการ\nสัตบุรุษ\nสัตบริภัณฑ์\nสัตภัณฑ์\nสัตมหาสถาน\nสัตโลหะ\nสันเขา\nสันดอน\nสันหลัง\nสั่นเทา\nสั่นเทิ้ม\nสันติบาล\nสันติภาพ\nสันติวิธี\nสันติสุข\nสับเปลี่ยน\nสับสน\nสับหลีก\nสับหว่าง\nสัมมาคารวะ\nสัมมาชีพ\nส่าเหล้า\nสากกะเบือ\nสาทิสลักษณ์\nสาธุการ\nสาธุชน\nสาบเสือ\nสาปสรร\nสาปแช่ง\nสาปส่ง\nสามง่าม\nสามล้อ\nสามเหลี่ยม\nสามเวท\nสามัญชน\nสามัญสำนึก\nสายดิ่ง\nสายดิน\nสายตรวจ\nสายน้ำ\nสายบัว\nสายพาน\nสายฟ้า\nสายยาง\nสายยู\nสายใย\nสายรก\nสายรุ้ง\nสายล่อฟ้า\nสายลับ\nสายเลือด\nสายโลหิต\nสายวัด\nสายส่ง\nสายสวาท\nสายสะดือ\nสายสะพาย\nสายสัมพันธ์\nสายสิญจน์\nสายสืบ\nสายไหม\nสายอากาศ\nสายตา\nสายหยุด\nสารตรา\nสารประกอบ\nสารละลาย\nสารส้ม\nสารหนู\nสารทฤดู\nสาวใช้\nสาวน้อย\nสาวใหญ่\nสำนักงาน\nสำนักพิมพ์\nสำนักสงฆ์\nสำมะโนครัว\nสำเร็จรูป\nสิกขาบท\nสิงสถิต\nสิงสู่\nสิ่งก่อสร้าง\nสิ่งของ\nสิ่งปฏิกูล\nสิ่งพิมพ์\nสิ่งแวดล้อม\nสิ่งศักดิ์สิทธิ์\nสิทธิกร\nสิทธิ์ขาด\nสิทธิชัย\nสิทธิโชค\nสิทธิบัตร\nสินค้า\nสินจ้าง\nสินเชื่อ\nสินไถ่\nสินทรัพย์\nสินน้ำใจ\nสินบน\nสินแร่\nสินสมรส\nสินสอด\nสินไหม\nสิ้นเชิง\nสิ้นสุด\nสีผึ้ง\nสีลม\nสีชอล์ก\nสีถ่าน\nสีเทียน\nสีน้ำ\nสีน้ำมัน\nสีโปสเตอร์\nสีฝุ่น\nสี่เหลี่ยม\nสีหน้า\nสึกหรอ\nสืบทอด\nสืบค้น\nสืบสวน\nสืบสาว\nสืบเสาะ\nสื่อผสม\nสื่อมวลชน\nสื่อสาร\nสุกงอม\nสุกดิบ\nสุกปลั่ง\nสุกใส\nสุขนาฏกรรม\nสุขภัณฑ์\nสุขภาพ\nสุขลักษณะ\nสุขวิทยา\nสุขศาลา\nสุขศึกษา\nสุดท้าย\nสุตกวี\nสุนทรพจน์\nสุภาพชน\nสู่ขอ\nสู่รู้\nสู่สม\nสูงส่ง\nสูญเปล่า\nสูญสิ้น\nสูญเสีย\nสูญหาย\nเสสรวล\nเสแสร้ง\nเสกสรร\nเสถียรภาพ\nเส้นชัย\nเส้นตรง\nเส้นตาย\nเส้นทาง\nเส้นใย\nเส้นรุ้ง\nเส้นเลือด\nเส้นแวง\nเส้นสาย\nเส้นเสียง\nเส้นหมี่\nเส้นเอ็น\nเสบียงกรัง\nเสมอภาค\nเสมอหน้า\nเสมอเหมือน\nเสมียนตรา\nเสร็จสรรพ\nเสร็จสิ้น\nเสริมส่ง\nเสริมสร้าง\nเสริมสวย\nเสรีไทย\nเสรีธรรม\nเสรีนิยม\nเสรีภาพ\nเสาเข็ม\nเสาธง\nเสียใจ\nเสียเชิง\nเสียดาย\nเสียที\nเสียเที่ยว\nเสียเปรียบ\nเสียเปล่า\nเสียรู้\nเสียแรง\nเสียสละ\nเสียหลัก\nเสียหาย\nเสี่ยงทาย\nเสียดแทง\nเสียดแทรก\nเสียดสี\nเสี้ยนศึก\nเสี้ยนหนาม\nเสี้ยมสอน\nเสียวซ่าน\nเสียวไส้\nเสือดาว\nเสือดำ\nเสือปลา\nเสือป่า\nเสือไฟ\nเสื่อกก\nเสื่อกระจูด\nเสื่อน้ำมัน\nเสื่อลำแพน\nเสื้อกล้าม\nเสื้อกั๊ก\nเสื้อเกราะ\nเสื้อครุย\nเสื้อแสง\nเสื้อเมือง\nเสือกคลาน\nเสือกสน\nเสือกไส\nเสื่อมคลาย\nเสื่อมถอย\nเสื่อมทราม\nเสื่อมโทรม\nเสื่อมสลาย\nเสื่อมสูญ\nเสื่อมเสีย\nเสือหมอบ\nแสกหน้า\nแสดงออก\nแสเถา\nแสนกล\nแสนรู้\nแสร้งว่า\nใส่ความ\nใส่ไคล้\nใส่ใจ\nใส่ไฟ\nไส้กรอก\nไส้ไก่\nไส้ติ่ง\nไส้ศึก\nไส้อั่ว\nไส้เดือน\nไส้ตัน\nไสยเวท\nไสยศาสตร์\nหกล้ม\nหงส์หยก\nหงอนไก่\nหงอยก๋อย\nหงอยเหงา\nหงายท้อง\nหงายหลัง\nหงำเหงอะ\nหงำเหงือก\nหดหาย\nหดหู่\nหนทาง\nหนวกหู\nหน่วงเหนี่ยว\nหน่วยก้าน\nหน่อไม้\nหนองใน\nหนองแซง\nหนักข้อ\nหนักใจ\nหนักแน่น\nหนักหน่วง\nหนักหนา\nหนังกลับ\nหนังตะลุง\nหนังเรียด\nหนังสด\nหนังใหญ่\nหนังสือพิมพ์\nหนาแน่น\nหน้ากระดาน\nหน้ากาก\nหน้ากาฬ\nหน้าแข้ง\nหน้าจั่ว\nหน้าฉาน\nหน้าตัก\nหน้าตา\nหน้าต่าง\nหน้าท้อง\nหน้าทับ\nหน้าที่\nหน้าที่นั่ง\nหน้าบัน\nหน้าปัด\nหน้าผา\nหน้าผาก\nหน้าม้า\nหน้ามุข\nหน้าไม้\nหน้าเลือด\nหน้าอก\nหนามเตย\nหน่ายหนี\nหน่ายแหนง\nหนาวเหน็บ\nหนำใจ\nหนี้สิน\nหนี้สูญ\nหนุนเนื่อง\nหนุนหลัง\nหมกมุ่น\nหมดจด\nหมอขวัญ\nหมอความ\nหมอแคน\nหมองู\nหมอดู\nหมอตำแย\nหมอทำขวัญ\nหมอนวด\nหมอผี\nหมอยา\nหมอลำ\nหมอเสน่ห์\nหม้อแกง\nหม้อตาล\nหม้อน้ำ\nหม้อแปลง\nหมองใจ\nหมองมัว\nหมองหม่น\nหมองหมาง\nหมอนขวาน\nหมอนข้าง\nหมอนทอง\nหม่อมเจ้า\nหม่อมฉัน\nหม่อมราชวงศ์\nหม่อมหลวง\nหม่อมห้าม\nหมั่นไส้\nหมาป่า\nหมาหมู่\nหมากฝรั่ง\nหมากสง\nหมากหอม\nหมากเก็บ\nหมากรุก\nหมากเม่า\nหมางใจ\nหมางเมิน\nหมาไม้\nหมายเกณฑ์\nหมายขัง\nหมายค้น\nหมายความ\nหมายจับ\nหมายใจ\nหมายตา\nหมายปล่อย\nหมายมั่น\nหมายเรียก\nหมายเลข\nหมายเหตุ\nหมิ่นเหม่\nหมึกจีน\nหมุนเวียน\nหมูแดง\nหมูป่า\nหมูแผ่น\nหมูยอ\nหมูหย็อง\nหมูหัน\nหมูแฮม\nหมู่บ้าน\nหยดย้อย\nหยอกเย้า\nหยักรั้ง\nหยักศก\nหยั่งทราบ\nหยั่งรู้\nหยั่งเสียง\nหยาบคาย\nหยาบช้า\nหยาบโลน\nหยาบหยาม\nหยิบมือ\nหยิบยก\nหยิบยืม\nหยิบหย่ง\nหยิบโหย่ง\nหริรักษ์\nหริวงศ์\nหลงผิด\nหลบฉาก\nหลบมุม\nหลวงจีน\nหลวงพ่อ\nหลวมตัว\nหล่อลื่น\nหล่อเลี้ยง\nหล่อหลอม\nหลอกลวง\nหลอกล่อ\nหลอกล้อ\nหลอดลม\nหลอดเลือด\nหลอดอาหาร\nหลอมตัว\nหลอมเหลว\nหลักการ\nหลักเกณฑ์\nหลักชัย\nหลักฐาน\nหลักทรัพย์\nหลักเมือง\nหลักลอย\nหลักสูตร\nหลักแหล่ง\nหลักแหลม\nหลังคา\nหลังเต่า\nหลั่งไหล\nหลับนก\nหลับใน\nหลากใจ\nหลากหลาย\nหลาบจำ\nหลายหลาก\nหลายแหล่\nหลุดพ้น\nหลุดลอย\nหลุดลุ่ย\nหลุมโจน\nหลุมพราง\nหวงก้าง\nหวงห้าม\nหวงแหน\nห่วงใย\nห้วงน้ำ\nหวังใจ\nหวังดี\nหวั่นกลัว\nหวั่นเกรง\nหวั่นใจ\nหวั่นวิตก\nหวั่นหวาด\nหวั่นไหว\nหวาดกลัว\nหวาดเกรง\nหวาดผวา\nหวาดเสียว\nหวาดหวั่น\nหวาดไหว\nหวานเย็น\nหว่านล้อม\nหอคอย\nหอคำ\nหอฉัน\nหอไตร\nหอประชุม\nหอพัก\nห่อหมก\nห่อเหี่ยว\nหอกซัด\nห้องเครื่อง\nห้องชุด\nห้องแถว\nห้องโถง\nห้องน้ำ\nห้องสมุด\nหอสมุด\nหอมหวน\nห้อมล้อม\nห้อยโหน\nหักล้าง\nหักหาญ\nหักห้าม\nหักเห\nหักโหม\nหักมุก\nหันเห\nหับเผย\nหัวขโมย\nหัวข้อ\nหัวขั้ว\nหัวเข่า\nหัวโขน\nหัวคะแนน\nหัวค่ำ\nหัวคิด\nหัวจุก\nหัวโจก\nหัวใจ\nหัวเทียน\nหัวนม\nหัวนอน\nหัวป่า\nหัวมุม\nหัวเรื่อง\nหัวแร้ง\nหัวใส\nหัวหน้า\nหัวหน่าว\nหัวหอก\nหัวเห็ด\nหัวไหล่\nหัวอก\nหัสดนตรี\nหัสนาฏกรรม\nหัสนิยาย\nหัสดีลิงค์\nหางเครื่อง\nหางแถว\nหางเลข\nหางว่าว\nหางเสียง\nหางเสือ\nห่างเหิน\nหาบเร่\nห้ามปราม\nห้ามล้อ\nหายตัว\nหาวนอน\nห้าวหาญ\nห้ำหั่น\nหินงอก\nหินทราย\nหินปูน\nหินย้อย\nหินอ่อน\nหินชาติ\nหินยาน\nหีบเพลง\nหีบห่อ\nหุ่นกระบอก\nหุ่นยนต์\nหุ้นลม\nหุ้นส่วน\nหุบเขา\nหุบผา\nหุบเหว\nหูกระต่าย\nหูช้าง\nหูรูด\nหูกวาง\nเหงาหงอย\nเหงื่อกาฬ\nเหตุการณ์\nเหตุผล\nเห็นแก่\nเห็นใจ\nเหน็บแนม\nเหน็บชา\nเหนียวแน่น\nเหนี่ยวนำ\nเหนี่ยวรั้ง\nเหนื่อยหน่าย\nเหมาะเจาะ\nเหมาะสม\nเหมาะเหม็ง\nเหยเก\nเหยียดหยาม\nเหล็กกล้า\nเหล็กจาร\nเหล็กใน\nเหล็กส่ง\nเหล็กเส้น\nเหล็กหล่อ\nเหล็กไหล\nเหลวแหลก\nเหลวไหล\nเหลอหลา\nเหล่ากอ\nเหลียวแล\nเหลือเกิน\nเหลือขอ\nเหลือใจ\nเหลือเชื่อ\nเหลือเฟือ\nเหลือร้าย\nเหลือล้น\nเหลือหลาย\nเหลือแหล่\nเหลือแสน\nเหลือหลอ\nเหลื่อมล้ำ\nเห่อเหิม\nเหินห่าง\nเหิมเกริม\nเหิมหาญ\nเหี้ยมเกรียม\nเหี้ยมหาญ\nเหี้ยมโหด\nเหี่ยวแห้ง\nเหือดหาย\nเหือดแห้ง\nแห่แหน\nแหนงหน่าย\nแหลกลาญ\nแหลกเหลว\nแหวกแนว\nแหวกว่าย\nโหงพราย\nโหดร้าย\nโหดเหี้ยม\nโหยหวน\nโหวงเหวง\nให้การ\nให้ท่า\nให้ท้าย\nให้ร้าย\nให้หลัง\nไหมพรม\nไหวพริบ\nอกไก่\nอกร่อง\nองค์กร\nองค์การ\nอดกลั้น\nอดทน\nอดสู\nอดอยาก\nอดออม\nอดีตกาล\nอดีตชาติ\nอดีตภพ\nอติชาตบุตร\nอธิการบดี\nอนาคตกาล\nอนิจกรรม\nอนุชาตบุตร\nอเนกประสงค์\nอบรม\nอบอวล\nอบอ้าว\nอบอุ่น\nอบายภูมิ\nอบายมุข\nอภัพบุคคล\nอภัยทาน\nอภัยโทษ\nอภิชาตบุตร\nอมยิ้ม\nอมรรัตน์\nอมฤตบท\nอมฤตรส\nอย่างไร\nอรรถกร\nอรรถกวี\nอรรถคดี\nอรรถประโยชน์\nอรรถรส\nอรรธนิศา\nอรรธภาค\nอรรธสระ\nอรสุมพล\nอรูปฌาน\nอรูปพรหม\nอรูปภพ\nอรูปภูมิ\nอวชาตบุตร\nอวดดี\nอวดอ้าง\nอ้วนท้วน\nอ้วนพี\nอวบอั๋น\nอวยชัย\nอวยพร\nอสุภกรรมฐาน\nอสุภสัญญา\nอโหสิกรรม\nออเจ้า\nออกแขก\nออกตัว\nออกโรง\nออกฤทธิ์\nออกลาย\nออกหาก\nออดอ้อน\nออดแอด\nอ่อนข้อ\nอ่อนใจ\nอ่อนช้อย\nอ่อนน้อม\nอ่อนเปลี้ย\nอ่อนเพลีย\nอ่อนโยน\nอ่อนหวาน\nอ่อนหัด\nอ่อนไหว\nอ่อนแอ\nอ้อนวอน\nอ้อนออด\nอ้อมค้อม\nอักษรศาสตร์\nอักษรสาส์น\nอัคคีภัย\nอัญชนะศักราช\nอัดฉีด\nอัดอั้น\nอัตราส่วน\nอันโตชน\nอันโตนาที\nอับจน\nอับเฉา\nอับอาย\nอัสสุชล\nอัสสุธารา\nอากัปกิริยา\nอาการนาม\nอากาศธาตุ\nอากาศยาน\nอาคารชุด\nอ่างเก็บน้ำ\nอ้างอิง\nอาจหาญ\nอาจอง\nอาชญากร\nอาชญากรรม\nอาชญาบัตร\nอาชญาสิทธิ์\nอาญาสิทธิ์\nอาณาเขต\nอาณาจักร\nอาณานิคม\nอาณาประโยชน์\nอาโปกสิณ\nอาโปธาตุ\nอาภากร\nอายุขัย\nอายุวัฒนะ\nอาโลกกสิณ\nอาหารว่าง\nอำพราง\nอิดโรย\nอิดออด\nอิดเอื้อน\nอิตถีลิงค์\nอิทธิปาฏิหาริย์\nอิทธิพล\nอิทธิฤทธิ์\nอินังขังขอบ\nอิ่มตัว\nอิ่มหนำ\nอิ่มเอม\nอิ่มเอิบ\nอีฉัน\nอีตัว\nอึงคะนึง\nอึงมี่\nอึงอล\nอึ่งยาง\nอึ่งอ่าง\nอึดใจ\nอึดอัด\nอืดอาด\nอื้อฉาว\nอื้อซ่า\nอื้ออึง\nอุกฉกรรจ์\nอุกอาจ\nอุดอู้\nอุ่นเครื่อง\nอุ่นใจ\nอุบอิบ\nอุบัติภัย\nอุบัติเหตุ\nอุโบสถกรรม\nอุโบสถหัตถี\nอุปมาโวหาร\nอุ้มชู\nอุ้มสม\nอุ้ยอ้าย\nอู้อี้\nเอกจิต\nเอกฉันท์\nเอกชน\nเอกเทศ\nเอกนัย\nเอกบุคคล\nเอกบุรุษ\nเอกพจน์\nเอกภพ\nเอกภาพ\nเอกมัย\nเอกราช\nเอกรูป\nเอกลักษณ์\nเอกศก\nเอกสาร\nเอกสิทธิ์\nเอกอุ\nเอ็ดอึง\nเอนเอียง\nเอมอร\nเอออวย\nเออออ\nเอาการ\nเอางาน\nเอาจริง\nเอาใจ\nเอาเปรียบ\nเอาเยี่ยง\nเอิบอาบ\nเอียงอาย\nเอียงเอน\nเอื้อเฟื้อ\nโอ่โถง\nโอ้โถง\nโอ่อวด\nโอ้อวด\nโอ่อ่า\nโอ้โลม\nโอดครวญ\nโอดโอย\nโอนอ่อน\nโอนเอน\nโอบอ้อม\nโอบอุ้ม\nโอสถกรรม\nไอเสีย\nไอกรน\nฮวบฮาบ\nฮาป่า\nฮึกหาญ\nฮึกห้าว\nฮึกเหิม\nฮึกโหม\nฮึกฮัก\nเฮงซวย\nโฮกฮือ\nโฮกฮาก\n\nก็\nกก\nก๊ก\nกกุธภัณฑ์\nกง\nก่ง\nก้ง\nก๊ง\nก๋ง\nกงกอน\nกงไฉ่\nกงเต๊ก\nกงสี\nกงสุล\nกช\nกฎ\nกฏุก\nกฐิน\nกณิกนันต์\nกณิการ์\nกด\nกตเวทิตา\nกตเวที\nกตัญชลี\nกตัญญุตา\nกตัญญู\nกตาธิการ\nกตาภินิหาร\nกติกา\nกถา\nกถิกาจารย์\nกทลี\nกน\nก่น\nก้น\nกนก\nกนิษฐ์\nกนิษฐา\nกบ\nกบฏ\nกบดาน\nกบทู\nกบาล\nกบินทร์\nกบิล\nกบี่\nกบูร\nกเบนทร์\nกม\nก้ม\nกมณฑลาภิเษก\nกมณฑโลทก\nกมล\nกมลา\nกมลาศ\nกมลาสน์\nกมเลศ\nกมัณฑลุ\nกมุท\nกร\nกรกฎ\nกรกฎาคม\nกรกฏ\nกรง\nกรชกาย\nกรณฑ์\nกรณิการ์\nกรณี\nกรณีย์\nกรณียกิจ\nกรณียะ\nกรด\nกรน\nกรบ\nกรบูร\nกรพินธุ์\nกรม\nกรรกฎ\nกรรกศ\nกรรเกด\nกรรไกร\nกรรเจียก\nกรรชิง\nกรรเชียง\nกรรโชก\nกรรฐ์\nกรรฐา\nกรรณ\nกรรณา\nกรรณิกา\nกรรณิการ์\nกรรดิ\nกรรดิก\nกรรดึก\nกรรตุ\nกรรไตร\nกรรทบ\nกรรแทก\nกรรบิด\nกรรบูร\nกรรภิรมย์\nกรรม\nกรรม์\nกรรม์ภิรมย์\nกรรมชวาต\nกรรมัชวาต\nกรรมาชีพ\nกรรมาธิการ\nกรรมาร\nกรรษก\nกรรสะ\nกรรแสง\nกรวด\nกรวบ\nกรวม\nกร้วม\nกรวย\nกรวิก\nกรสาปน์\nกรสุทธิ์\nกรอ\nกร้อ\nกรอก\nกร็อกกร๋อย\nกรอกแกรก\nกรอง\nกรองกรอย\nกรอด\nกร่อน\nกรอบ\nกรอม\nกร่อย\nกระ\nกระกร\nกระกรุ่น\nกระกลับกลอก\nกระกี้\nกระเกรอก\nกระเกริก\nกระเกริ่น\nกระคน\nกระคาย\nกระงกกระเงิ่น\nกระง่องกระแง่ง\nกระง่อนกระแง่น\nกระเง้ากระงอด\nกระโงก\nกระจก\nกระจง\nกระจร\nกระจอก\nกระจองหง่อง\nกระจ๋องหง่อง\nกระจองอแง\nกระจ้อน\nกระจอนหู\nกระจ้อย\nกระจ๋อหวอ\nกระจะ\nกระจัก\nกระจัง\nกระจัด\nกระจับ\nกระจ่า\nกระจ่าง\nกระจาด\nกระจาน\nกระจาบ\nกระจาม\nกระจาย\nกระจาว\nกระจิก\nกระจิ๋ง\nกระจิด\nกระจิบ\nกระจิ๋ม\nกระจิริด\nกระจิ๋ว\nกระจี้\nกระจี๋\nกระจุก\nกระจุ๋งกระจิ๋ง\nกระจุบ\nกระจุ๊บ\nกระจุ๋มกระจิ๋ม\nกระจุย\nกระจู้\nกระจู๋กระจี๋\nกระจูด\nกระเจอะกระเจิง\nกระเจา\nกระเจ่า\nกระเจ้า\nกระเจาะ\nกระเจิง\nกระเจิดกระเจิง\nกระเจี้ยง\nกระเจี๊ยบ\nกระเจียว\nกระเจี๊ยว\nกระแจะ\nกระโจน\nกระโจม\nกระฉอก\nกระฉ่อน\nกระฉับกระเฉง\nกระฉิ่ง\nกระฉีก\nกระฉูด\nกระเฉก\nกระเฉด\nกระแฉก\nกระโฉกกระเฉก\nกระโฉม\nกระชดกระช้อย\nกระชอน\nกระชอมดอก\nกระช้อย\nกระชัง\nกระชั้น\nกระชับ\nกระชาก\nกระชาย\nกระชิง\nกระชิด\nกระชุ\nกระชุก\nกระชุ่มกระชวย\nกระเชอ\nกระเชา\nกระเช้า\nกระเชียง\nกระแชง\nกระแชะ\nกระโชก\nกระซ่องกระแซ่ง\nกระซับ\nกระซาบ\nกระซิก\nกระซิบ\nกระซี้\nกระซุง\nกระซุบกระซิบ\nกระซุ้ม\nกระซู่\nกระเซ็น\nกระเซอ\nกระเซอะกระเซอ\nกระเซอะกระเซิง\nกระเซ้า\nกระเซิง\nกระแซ\nกระแซะ\nกระโซกระเซ\nกระฎี\nกระฎุมพี\nกระดก\nกระด้ง\nกระดนโด่\nกระดวง\nกระดวน\nกระด้วมกระเดี้ยม\nกระดอ\nกระดอง\nกระดองหาย\nกระดอน\nกระดอม\nกระดักกระเดี้ย\nกระดังงัว\nกระดังงา\nกระดาก\nกระด้าง\nกระดางลาง\nกระดาด\nกระดาดขาว\nกระดาน\nกระดานพน\nกระดาษ\nกระดำกระด่าง\nกระดิก\nกระดิ่ง\nกระดิ้ง\nกระดิบ\nกระดี่\nกระดี้กระเดียม\nกระดึง\nกระดืบ\nกระดุ\nกระดุกกระดิก\nกระดุ้งกระดิ้ง\nกระดุบ\nกระดุบกระดิบ\nกระดุม\nกระดูก\nกระเดก\nกระเด้ง\nกระเด็น\nกระเด้า\nกระเดาะ\nกระเดิด\nกระเดี้ย\nกระเดียด\nกระเดือก\nกระเดื่อง\nกระแด็ก\nกระแด้ง\nกระแด้แร่\nกระแด่ว\nกระแดะ\nกระโดก\nกระโดง\nกระโดด\nกระโดน\nกระได\nกระตรับ\nกระตราก\nกระตรุด\nกระตรุม\nกระต้วมกระเตี้ยม\nกระต้อ\nกระต่องกระแต่ง\nกระต๊อบ\nกระต้อยตีวิด\nกระตัก\nกระตั้ว\nกระต่าย\nกระติก\nกระติ๊ด\nกระติบ\nกระตือรือร้น\nกระตุก\nกระตุ้งกระติ้ง\nกระตุ่น\nกระตุ้น\nกระตูบ\nกระเตง\nกระเต็น\nกระเตอะ\nกระเตาะ\nกระเตาะกระแตะ\nกระเตื้อง\nกระแต\nกระแตแต้แว้ด\nกระโตกกระตาก\nกระโตน\nกระถด\nกระถอบ\nกระถั่ว\nกระถาง\nกระถิก\nกระถิน\nกระเถิบ\nกระโถน\nกระทก\nกระทง\nกระทบ\nกระทรวง\nกระทอก\nกระท้อน\nกระท่อนกระแท่น\nกระท่อม\nกระท้อมกระแท้ม\nกระทะ\nกระทั่ง\nกระทั้น\nกระทา\nกระทาย\nกระทาสี\nกระทาหอง\nกระทำ\nกระทิกกระทวย\nกระทิง\nกระทึง\nกระทืบ\nกระทุ\nกระทุง\nกระทุ้ง\nกระทุ่ม\nกระทู้\nกระเท่\nกระเทียบ\nกระเทียม\nกระเทือน\nกระเทื้อม\nกระแทก\nกระแท่น\nกระแทะ\nกระไทชาย\nกระน่อง\nกระนั้น\nกระนี้\nกระแนะกระแหน\nกระโน้น\nกระไน\nกระบก\nกระบม\nกระบวน\nกระบวย\nกระบวร\nกระบอก\nกระบอง\nกระบะ\nกระบัด\nกระบั้วกระเบี้ย\nกระบ่า\nกระบ้า\nกระบาก\nกระบาย\nกระบาล\nกระบิ\nกระบิ้ง\nกระบิด\nกระบิล\nกระบี่\nกระบือ\nกระบุง\nกระบุ่มกระบ่าม\nกระบู้กระบี้\nกระบูน\nกระบูร\nกระเบง\nกระเบญ\nกระเบ็ดกระบวน\nกระเบน\nกระเบา\nกระเบิก\nกระเบียด\nกระเบียน\nกระเบื้อง\nกระแบก\nกระแบะ\nกระโบม\nกระปมกระปำ\nกระปมกระเปา\nกระปรอก\nกระปรอกว่าว\nกระปรี้กระเปร่า\nกระปอก\nกระป้อกระแป้\nกระป่อง\nกระป๋อง\nกระปอดกระแปด\nกระป๋อหลอ\nกระปั้วกระเปี้ย\nกระป่ำ\nกระปุก\nกระปุ๊กลุก\nกระปุ่ม\nกระปุ่มกระป่ำ\nกระปุ่มกระปิ่ม\nกระเป๋า\nกระเปาะ\nกระโปก\nกระโปรง\nกระผม\nกระผลีกระผลาม\nกระผาน\nกระผีก\nกระพรวน\nกระพริ้ม\nกระพอก\nกระพอง\nกระพ้อม\nกระพัก\nกระพัง\nกระพังเหิร\nกระพังโหม\nกระพัด\nกระพัตร\nกระพัน\nกระพั่น\nกระพา\nกระพาก\nกระพี้\nกระพือ\nกระพุ้ง\nกระพุ่ม\nกระเพาะ\nกระเพิง\nกระเพื่อม\nกระแพ้ง\nกระฟัดกระเฟียด\nกระฟูมกระฟาย\nกระมล\nกระมอบ\nกระมอมกระแมม\nกระมัง\nกระมัน\nกระมิดกระเมี้ยน\nกระมุท\nกระเมาะ\nกระย่อง\nกระย่องกระแย่ง\nกระย่อน\nกระย่อม\nกระยา\nกระยาง\nกระยาจก\nกระยาหงัน\nกระยิก\nกระยิ้มกระย่อง\nกระยึกกระยือ\nกระยืดกระยาด\nกระเย้อกระแหย่ง\nกระรอก\nกระเรียน\nกระโรกน้ำข้าว\nกระโรกใหญ่\nกระไร\nกระลด\nกระลบ\nกระลอก\nกระลอม\nกระละหล่ำ\nกระลัด\nกระลับ\nกระลัมพร\nกระลา\nกระลำ\nกระลำพัก\nกระลำพุก\nกระลิง\nกระลี\nกระลุมพาง\nกระลุมพุก\nกระลุมพู\nกระลูน\nกระลู่น์\nกระเล็น\nกระเลียด\nกระเลือก\nกระโลง\nกระวน\nกระวัด\nกระวาด\nกระวาน\nกระวาย\nกระวิน\nกระวี\nกระวีกระวาด\nกระวูดกระวาด\nกระเวน\nกระเวยกระวาย\nกระแวน\nกระโวยกระวาย\nกระษัย\nกระษาปณ์\nกระสง\nกระสบ\nกระสม\nกระสรวล\nกระสร้อย\nกระสวน\nกระสวย\nกระสอบ\nกระสะ\nกระสัง\nกระสัน\nกระสับกระส่าย\nกระสา\nกระสานติ์\nกระสาบ\nกระสาย\nกระสือ\nกระสุงกระสิง\nกระสุน\nกระสูทธิ์\nกระสูบ\nกระเสด\nกระเส็นกระสาย\nกระเส่า\nกระเสาะกระแสะ\nกระเสียน\nกระเสียร\nกระเสือกกระสน\nกระแส\nกระแสง\nกระแสะ\nกระโสง\nกระไส\nกระหนก\nกระหนาก\nกระหนาบ\nกระหน่ำ\nกระหมวด\nกระหมอบ\nกระหม่อม\nกระหมั่ง\nกระหมิบ\nกระหมุดกระหมิด\nกระหมุบ\nกระหย่ง\nกระหย่อม\nกระหยัง\nกระหยับ\nกระหยิ่ม\nกระหรอด\nกระหริ่ง\nกระหวน\nกระหวัด\nกระหอง\nกระหัง\nกระหัด\nกระหาง\nกระหาย\nกระหึม\nกระหึ่ม\nกระหืดกระหอบ\nกระเห็น\nกระเหนียด\nกระเหม็ดกระเหมียด\nกระเหม็ดกระแหม่\nกระเหม่น\nกระเหม่า\nกระเหว่า\nกระเห่อ\nกระเหิม\nกระเหี้ยนกระหือรือ\nกระแห\nกระแหทอง\nกระแหนบ\nกระแหนะ\nกระแหมบ\nกระแหม่ว\nกระแหย่ง\nกระแหร่ม\nกระแหล่ง\nกระโห้\nกระโหนด\nกระโหม\nกระโหย\nกระโหย่ง\nกระอวล\nกระอ้อกระแอ้\nกระออดกระแอด\nกระออบ\nกระออม\nกระอ้อมกระแอ้ม\nกระอัก\nกระอักกระอ่วน\nกระอั้วแทงควาย\nกระอ้า\nกระอาน\nกระอิด\nกระอิดกระเอื้อน\nกระอึก\nกระอืด\nกระอุ\nกระอุก\nกระเอา\nกระเอิก\nกระเอิบ\nกระแอก\nกระแอบ\nกระแอม\nกระไอ\nกรัก\nกรักขี\nกรัง\nกรัชกาย\nกรัณฑ์\nกรัณย์\nกรัน\nกรับ\nกรัม\nกราก\nกราง\nกร่าง\nกราด\nกราดวง\nกราน\nกร้าน\nกราบ\nกราฟ\nกราม\nกราย\nกร่าย\nกราว\nกร้าว\nกรำ\nกร่ำ\nกริก\nกริ๊ก\nกริกกริว\nกริกกรี\nกริ่ง\nกริ๊ง\nกริงกริว\nกริ้งกริ้ว\nกริช\nกริณี\nกริน\nกรินทร์\nกรินี\nกริบ\nกริม\nกริ่ม\nกริยา\nกริยานุเคราะห์\nกริว\nกริ้ว\nกรี\nกรีฑา\nกรีด\nกรี๊ด\nกรีธา\nกรีษ\nกรีส\nกรึ๊บ\nกรุ\nกรุง\nกรุ้งกริ่ง\nกรุณ\nกรุณา\nกรุณาธิคุณ\nกรุ่น\nกรุบ\nกรุ่ม\nกรุ้มกริ่ม\nกรุย\nกรุยเกรียว\nกรู\nกรูด\nกรูม\nกเรณุ\nกเรนทร\nกเรนทร์\nกฤช\nกฤดาภินิหาร\nกฤตติกา\nกฤษฎา\nกฤษฎาธาร\nกฤษฎาภินิหาร\nกฤษฎีกา\nกฤษณา\nกล\nกลด\nกล่น\nกลบ\nกลม\nกลละ\nกลวง\nกล้วย\nกลศ\nกล้อ\nกลอก\nกลอง\nกล่อง\nกล้อง\nกล้องแกล้ง\nกลอน\nกล่อน\nกล้อน\nกล่อม\nกล้อมแกล้ม\nกลอย\nกลัก\nกลัด\nกลั่น\nกลั้น\nกลันทก์\nกลันทะ\nกลับ\nกลัมพร\nกลัมพัก\nกลัว\nกลั้ว\nกลา\nกล้า\nกลาก\nกลากลาด\nกลาง\nกลาด\nกลาบาต\nกลาป\nกล้าม\nกลาย\nกล้าย\nกลายกลอก\nกล่าว\nกลาโหม\nกล่ำ\nกล้ำ\nกลิ้ง\nกลิงค์\nกลิ่น\nกลี\nกลีบ\nกลึง\nกลึงค์\nกลืน\nกลุ่ม\nกลุ้ม\nกลูโคส\nกเลวระ\nกวด\nกวน\nกวม\nกวย\nกวยจั๊บ\nกวยจี๊\nก๋วยเตี๋ยว\nกวัก\nกวัด\nกวา\nกว่า\nกวาง\nกว่าง\nกว้าง\nกว่างโซ้ง\nกวางตุ้ง\nกวาด\nกว้าน\nกว๊าน\nกว้าว\nกวาวเครือ\nกวี\nกษณะ\nกษมา\nกษัตร\nกษัตรา\nกษัตริย์\nกษัตรี\nกษัตรีย์\nกษัย\nกษาปณ์\nกษิดิ\nกษีร\nกษีรธารา\nกษีระ\nกสานติ์\nกสิกร\nกสิกรรม\nกสิณ\nกหังปายา\nกหาปณะ\nกเฬวราก\nกอ\nก่อ\nก้อ\nก๊อ\nกอก\nก๊อก\nกอแก\nกอง\nก่อง\nก้อง\nกองกอย\nก๊อซ\nกอด\nก่อน\nก้อน\nกอบ\nกอบนาง\nก๊อบปี้\nกอปร\nก้อม\nกอมก้อ\nก่อมก้อ\nกอย\nก้อย\nก๋อย\nกอริลลา\nกอล์ฟ\nกอและ\nกอเอี๊ยะ\nกะ\nกะกัง\nกะง้องกะแง้ง\nกะจัง\nกะแจะ\nกะชะ\nกะชัง\nกะชามาศ\nกะชิง\nกะชึ่กกะชั่ก\nกะแช่\nกะซวก\nกะซ้าหอย\nกะซี่\nกะโซ่\nกะโซ้\nกะดก\nกะดง\nกะดวน\nกะดอก\nกะดะ\nกะดังบาย\nกะดัด\nกะด้าง\nกะดำกะด่าง\nกะดี\nกะดี่\nกะดุ้ง\nกะเด้\nกะเดก\nกะเดี๋ยว\nกะตรุด\nกะตอก\nกะต่อย\nกะตัก\nกะตั้ก\nกะตัง\nกะตังกะติ้ว\nกะต๊าก\nกะต้ำ\nกะติ๊กริก\nกะติงกะแตง\nกะตีบ\nกะตึงกะแตง\nกะตุ๊ก\nกะตุด\nกะตูก\nกะเตง\nกะโต๊ก\nกะโตงกะเตง\nกะโต้งโห่ง\nกะถัว\nกะทกรก\nกะทอ\nกะทัง\nกะทังหัน\nกะทัดรัด\nกะทันหัน\nกะทับ\nกะทิ\nกะทือ\nกะทุน\nกะเทย\nกะเทาะ\nกะแท้\nกะแท่ง\nกะแทน\nกะนวล\nกะนัด\nกะบ่อนกะแบ่น\nกะบัง\nกะบั้ง\nกะบิ้ง\nกะบิล\nกะบึงกะบอน\nกะบุด\nกะเบ้อ\nกะเบียน\nกะเบือ\nกะปริดกะปรอย\nกะปริบ\nกะปริบกะปรอย\nกะปลกกะเปลี้ย\nกะปวกกะเปียก\nกะปอม\nกะปอมขาง\nกะปะ\nกะป้ำกะเป๋อ\nกะปิ\nกะปู\nกะปูด\nกะปูดหลูด\nกะเปะ\nกะเปิ๊บกะป๊าบ\nกะเปียด\nกะแป้น\nกะแปะ\nกะโปรง\nกะโปโล\nกะผลุบกะโผล่\nกะเผ่น\nกะเผลก\nกะโผลกกะเผลก\nกะพง\nกะพรวดกะพราด\nกะพร่องกะแพร่ง\nกะพริบ\nกะพรุน\nกะพรูดกะพราด\nกะพล้อ\nกะพ้อ\nกะเพรา\nกะเพียด\nกะเม็ง\nกะร่องกะแร่ง\nกะระตะ\nกะระหนะ\nกะรัง\nกะรัต\nกะราง\nกะริง\nกะรุงกะรัง\nกะรุ่งกะริ่ง\nกะรุน\nกะเร\nกะเรกะร่อน\nกะเร่กะร่อน\nกะเร่อ\nกะเรี่ยกะราด\nกะโรกะเร\nกะลวย\nกะลอ\nกะล่อกะแล่\nกะลอจี๊\nกะล่อน\nกะล่อมกะแล่ม\nกะล่อยกะหลิบ\nกะละปังหา\nกะละมัง\nกะละแม\nกะละออม\nกะลังตังไก่\nกะลัน\nกะลันทา\nกะลา\nกะลาง\nกะลาสี\nกะลำพอ\nกะลิง\nกะลิงปลิง\nกะลิ้มกะเหลี่ย\nกะลิอ่อง\nกะลุมพี\nกะเล็ง\nกะเล่อกะล่า\nกะเลิด\nกะเลียว\nกะแล\nกะโล่\nกะโลง\nกะวอกกะแวก\nกะวะ\nกะส้มชื่น\nกะสัง\nกะส้าหอย\nกะหนอกะแหน\nกะหน็องกะแหน็ง\nกะหนะ\nกะหนุงกะหนิง\nกะหร่อง\nกะหรอด\nกะหร็อมกะแหร็ม\nกะหราน\nกะหรี่\nกะหรี่ปั๊บ\nกะหลาป๋า\nกะหล่ำ\nกะหลี่\nกะหลีกะหลอ\nกะหลุกกะหลิก\nกะหำ\nกะหำแพะ\nกะหือ\nกะหูด\nกะเหรี่ยง\nกะเหลาะเปาะ\nกะแหยก\nกะแหะ\nกะโหลก\nกะโหล้ง\nกะไหล่\nกะอวม\nกะออม\nกะอาน\nกะอาม\nกะอูบ\nกัก\nกั๊ก\nกักกรา\nกักการุ\nกักขฬะ\nกัง\nกั้ง\nกังก้า\nกังเกียง\nกังขา\nกังฉิน\nกังฟู\nกังวล\nกังวาน\nกังสดาล\nกังไส\nกังหัน\nกัจฉปะ\nกัจฉะ\nกัจฉา\nกัญ\nกัญจุก\nกัญจุการา\nกัญชา\nกัญญา\nกัฐ\nกัณฏกะ\nกัณฐกะ\nกัณฐชะ\nกัณฐัศ\nกัณฐัศว์\nกัณฐา\nกัณฐี\nกัณฑ์\nกัณณ์\nกัณหา\nกัด\nกัตติกมาส\nกัตติกา\nกัตติเกยา\nกัตรา\nกัทลี\nกัน\nกั่น\nกั้น\nกันเกรา\nกันไกร\nกันชิง\nกันเชอ\nกันดาร\nกันดาล\nกันได\nกันต์\nกันตัง\nกันไตร\nกันทร\nกันทรากร\nกันภิรมย์\nกันเมียง\nกันย์\nกันยา\nกันยายน\nกันลง\nกันลอง\nกันแสง\nกั้นหยั่น\nกับ\nกับแก้\nกัป\nกัปตัน\nกัปปาสิก\nกัปปิยภัณฑ์\nกัปปิยะ\nกัมปนาท\nกัมประโด\nกัมปี\nกัมพล\nกัมพุช\nกัมพู\nกัมพูชา\nกัมโพช\nกัมมัชวาต\nกัมมัฏฐาน\nกัมมันตภาพรังสี\nกัมมันตรังสี\nกัมมาร\nกัมลาศ\nกัยวิกัย\nกัลชาญ\nกัลบก\nกัลป์\nกัลปนา\nกัลปพฤกษ์\nกัลปังหา\nกัลปาวสาน\nกัลปิต\nกัลเม็ด\nกัลยา\nกัลยาณมิตร\nกัลยาณี\nกัลออม\nกัศยป\nกัษณ\nกา\nก๋า\nกาก\nกากบาท\nกากะทิง\nกากะเยีย\nกากี\nกาง\nก้าง\nกางเกง\nกางเขน\nก๊าซ\nกาซะลอง\nกาญจนา\nกาฐ\nกาด\nก๊าด\nกาน\nก่าน\nก้าน\nก๊าน\nกานดา\nกานต์\nกานน\nก้านพร้าว\nกานพลู\nกาน้า\nกาบ\nก้าบ\nกาบู\nกาพย์\nกาเฟอีน\nกาแฟ\nกาม\nก้าม\nกามารมณ์\nกามินี\nกาเมสุมิจฉาจาร\nกาย\nก่าย\nกาเยน\nการ\nการณ์\nการ์ด\nการ์ตูน\nการบูร\nการย์\nการวิก\nการเวก\nการะเกด\nการะบุหนิง\nการัณย์\nการันต์\nการางหัวขวาน\nการิตการก\nการิตวาจก\nการุญ\nการุณย์\nกาเรการ่อน\nกาล\nกาลกรรณี\nกาลกิณี\nกาลจักร\nกาลัญญุตา\nกาลัญญู\nกาลัด\nกาลานุกาล\nกาลิก\nกาลี\nกาแล\nกาแล็กซี\nกาแล็กโทส\nกาว\nก้าว\nกาววาว\nกาวาง\nกาแวน\nกาศิก\nกาษฐะ\nกาษา\nกาสร\nกาสะ\nกาสา\nกาสาร\nกาสาวะ\nกาสิโน\nกาหล\nกาหลง\nกาหลา\nกาเหว่า\nกาไหล่\nกาฬ\nกาฬาวก\nกาฮัง\nกำ\nก่ำ\nกำกวม\nกำกัด\nกำกับ\nก้ำกึ่ง\nกำกูน\nก้ำเกิน\nกำเกียง\nกำคูน\nกำจร\nกำจัด\nกำจาย\nกำชับ\nกำชำ\nกำซาบ\nกำซำ\nกำด้น\nกำดัด\nกำดาล\nกำเดา\nกำธร\nกำนล\nกำนัน\nกำนัล\nกำเนิด\nกำบัง\nก่ำบึ้ง\nกำเบ้อ\nกำปอ\nกำปั่น\nกำผลา\nกำพง\nกำพด\nกำพต\nกำพร้า\nกำพราก\nกำพวด\nกำพอง\nกำพืด\nกำพุด\nกำพู\nกำเพลิง\nกำแพง\nกำภู\nกำมลาศน์\nกำมเลศ\nกำมะถัน\nกำมะลอ\nกำมะหยี่\nกำมะหริด\nกำมังละการ\nกำมังวิลิต\nกำมัชพล\nกำยาน\nกำยำ\nกำรอ\nกำราบ\nกำราล\nกำเริบ\nกำไร\nกำลัง\nกำลุง\nกำเลา\nกำไล\nกำสรด\nกำสรวล\nกำหนด\nกำหนัด\nกำเหน็จ\nกำแหง\nกิก\nกิ๊ก\nกิ่ง\nกิ้งก่า\nกิ้งกือ\nกิ้งโครง\nกิจ\nกิจจะ\nกิจจา\nกิดาการ\nกิดาหยัน\nกิตติ\nกิตติมศักดิ์\nกิน\nกินนร\nกินปลี\nกินเปี้ยว\nกินริน\nกินรี\nกิ๊บ\nกิมตึ๋ง\nกิมิชาติ\nกิมิวิทยา\nกิโมโน\nกิโยตีน\nกิระ\nกิริณี\nกิรินท\nกิริเนศวร\nกิริยา\nกิเลน\nกิเลส\nกิโล\nกิโลมกะ\nกิ่ว\nกิ๋ว\nกี\nกี่\nกี้\nกี๊\nกี๋\nกีฏวิทยา\nกีด\nกีตาร์\nกีบ\nกีรติ\nกีฬา\nกึก\nกึง\nกึ่ง\nกึ๋น\nกุ\nกุก\nกุ๊ก\nกุกกุฏ\nกุกกุร\nกุกรรม\nกุ้ง\nกุงอน\nกุงาน\nกุโงก\nกุจี\nกุญแจ\nกุญชร\nกุฎ\nกุฎา\nกุฎี\nกุฎุมพี\nกุฏฐัง\nกุฏิ\nกุณฑ์\nกุณฑล\nกุณฑี\nกุณโฑ\nกุณาล\nกุณี\nกุด\nกุดัง\nกุดั่น\nกุดา\nกุทัณฑ์\nกุน\nกุ๊น\nกุนเชียง\nกุนที\nกุโนกามอ\nกุบ\nกุบกับ\nกุม\nกุ่ม\nกุมฝอย\nกุมภ์\nกุมภนิยา\nกุมภัณฑ์\nกุมภา\nกุมภิล\nกุมภีล์\nกุมเหง\nกุมาร\nกุมารา\nกุมารี\nกุมุท\nกุย\nกุ๊ย\nกุ๋ย\nกุยช่าย\nกุยเฮง\nกุรระ\nกุรุพินท์\nกุเรา\nกุล\nกุลา\nกุลาหล\nกุลี\nกุลีกุจอ\nกุเลา\nกุแล\nกุเวร\nกุศราช\nกุศล\nกุศโลบาย\nกุสุม\nกุสุมภ์\nกุสุมา\nกุสุมาลย์\nกุสุมิตลดาเวลลิตา\nกุหนี\nกุหนุง\nกุหร่า\nกุหล่า\nกุหลาบ\nกุแหละ\nกู\nกู่\nกู้\nกู๊ก\nกูฏ\nกูฏา\nกูณฑ์\nกูด\nกูบ\nกูปรี\nกูรมะ\nกูรมาวตาร\nเก\nเก้\nเก๊\nเก๋\nเกก\nเก๊ก\nเกกมะเหรก\nเก๊กฮวย\nเก้กัง\nเก็ง\nเก่ง\nเก้ง\nเก๋ง\nเกงกอย\nเก่งกาจ\nเกงเขง\nเก๋งเคง\nเก็จ\nเกจิอาจารย์\nเกชา\nเกณฑ์\nเกด\nเก็ด\nเกตุ\nเกน\nเก็บ\nเกม\nเกย\nเกยูร\nเกรง\nเกร็ง\nเกร็ด\nเกรน\nเกร่อ\nเกรอะ\nเกราะ\nเกริก\nเกริน\nเกริ่น\nเกรียก\nเกรียง\nเกรียด\nเกรียน\nเกรียบ\nเกรียม\nเกรียว\nเกรี้ยว\nเกเร\nเกล็ด\nเกลศ\nเกลอ\nเกลา\nเกล้า\nเกลาะ\nเกลี่ย\nเกลี้ย\nเกลียง\nเกลี้ยง\nเกลียด\nเกลียว\nเกลือ\nเกลื้อ\nเกลือก\nเกลื่อน\nเกลื้อน\nเกวัฏ\nเกวียน\nเกศ\nเกศว\nเกศวะ\nเกศา\nเกศินี\nเกศี\nเกษตร\nเกษม\nเกษียณ\nเกษียน\nเกษียร\nเกส\nเกสร\nเกสรี\nเกสา\nเกสี\nเก้อ\nเกอิชา\nเกะ\nเกะกะ\nเกา\nเก่า\nเก้า\nเก๋า\nเกาต์\nเกาทัณฑ์\nเกาบิล\nเกาลัด\nเกาลิน\nเกาไศย\nเกาหลี\nเกาเหลา\nเกาเหลียง\nเก้าอี้\nเกาะ\nเกิ้ง\nเกิด\nเกิน\nเกิบ\nเกีย\nเกียกกาย\nเกียง\nเกี่ยง\nเกี๋ยง\nเกียจ\nเกียด\nเกียน\nเกี้ยมไฉ่\nเกี้ยมอี๋\nเกียร์\nเกียรติ\nเกียรติ์\nเกี่ยว\nเกี้ยว\nเกี๊ยว\nเกี๊ยะ\nเกื้อ\nเกือก\nเกื้อกูล\nเกือบ\nแก\nแก่\nแก้\nแกง\nแก่ง\nแก้ง\nแก๊ง\nแกงได\nแกงแนง\nแกโดลิเนียม\nแกน\nแก่น\nแก๊ป\nแกม\nแก้ม\nแกมมา\nแกรก\nแกร่ง\nแกร็น\nแกรนิต\nแกรไฟต์\nแกร่ว\nแกระ\nแกล\nแกล้ง\nแกลน\nแกลบ\nแกล้ม\nแกลลอน\nแกลเลียม\nแกล้ว\nแกละ\nแกแล\nแกว\nแก้ว\nแกว่ง\nแก๊ส\nแกะ\nโก\nโก่\nโก้\nโก๋\nโกก\nโกกนุท\nโกกิลา\nโกโก้\nโกง\nโก่ง\nโกงกาง\nโก้งเก้ง\nโกงโก้\nโก้งโค้ง\nโกเชาว์\nโกญจนาท\nโกญจา\nโกฏิ\nโกฐ\nโกฐาส\nโกณะ\nโกดัง\nโกทัณฑ์\nโกน\nโก่น\nโก๋น\nโกมล\nโกมุท\nโกเมน\nโกเมศ\nโกย\nโกรก\nโกรกกราก\nโกรง\nโกร่ง\nโกร่งกร่าง\nโกรงเกรง\nโกร๋งเกร๋ง\nโกรญจ\nโกรต๋น\nโกรธ\nโกรธา\nโกร๋น\nโกรม\nโกรย\nโกรศ\nโกโรโกเต\nโกโรโกโรก\nโกโรโกโส\nโกลน\nโกลาหล\nโกไล\nโกวิท\nโกศ\nโกศล\nโกษม\nโกสน\nโกสัช\nโกสินทร์\nโกสีย์\nโกสุม\nโกไสย\nโกหก\nใกล้\nไก\nไก่\nไก๊\nไก๋\nไก่กอม\nไกพัล\nไกร\nไกรพ\nไกรลาส\nไกรศร\nไกรศรี\nไกรสร\nไกรสรี\nไกรสิทธิ\nไกล\nไกล่\nไกลาส\nไกว\nไกวัล\nขงจื๊อ\nขจร\nขจรจบ\nขจัด\nขจ่าง\nขจาย\nขจาว\nขจิต\nขจี\nขจุย\nขเจา\nขณะ\nขด\nขน\nข้น\nขนง\nขนด\nขนบ\nขนม\nขนอง\nขนอน\nขนอบ\nขนัด\nขนัน\nขนาก\nขนาง\nขนาด\nขนาน\nขนาบ\nขนาย\nขนำ\nขนิษฐ\nขนิษฐา\nขนุน\nขนุนนก\nขบ\nขบถ\nขบวน\nขบวร\nขม\nข่ม\nขมงโกรย\nขมวด\nขมวน\nขมอง\nขม่อม\nขมัง\nขมับ\nขมา\nขม้ำ\nขมิ้น\nขมิบ\nขมีขมัน\nขมึง\nขมึงทึง\nขมุ\nขมุกขมัว\nขมุบ\nขโมย\nขยด\nขยม\nขย่ม\nขยอก\nขยอง\nขย่อน\nขย้อน\nขยะ\nขยัก\nขยัน\nขยั้น\nขยับ\nขยาด\nขยาย\nขยำ\nขย้ำ\nขยิก\nขยิบ\nขยิ่ม\nขยี้\nขยุกขยิก\nขยุกขยุย\nขยุบ\nขยุบขยิบ\nขยุม\nขยุ้ม\nขยุย\nขรม\nขรรค์\nขรัว\nขริบ\nขรี\nขรึม\nขรุขระ\nขลบ\nขล้อ\nขลัง\nขลับ\nขลาด\nขลาย\nขลิบ\nขลุก\nขลุกขลัก\nขลุกขลิก\nขลุบ\nขลุม\nขลุ่ย\nขลู\nขลู่\nขวง\nข่วง\nขวด\nข่วน\nขวนขวาย\nขวบ\nขวย\nขวักไขว่\nขวัญ\nขวั้น\nขวับ\nขวับเขวียว\nขวา\nขวาก\nขวาง\nขว้าง\nขวาด\nขวาน\nขวายขวน\nขวาว\nขว้าว\nขวิด\nขอ\nข่อ\nข้อ\nของ\nข้อง\nขอด\nขอน\nข้อน\nขอบ\nขอม\nข่อย\nข้อย\nข่อยหยอง\nขะแจะ\nขะเน็ด\nขะมอมขะแมม\nขะมักเขม้น\nขะมุกขะมอม\nขะยิก\nขะยุก\nขะเย้อแขย่ง\nขัค\nขัง\nขังขอก\nขัช\nขัณฑสกร\nขัณฑสีมา\nขัด\nขัดมอน\nขัตติยมานะ\nขัน\nขั้น\nขันติ\nขันตี\nขันโตก\nขันที\nขันธ์\nขันธาวาร\nขับ\nขัว\nขั้ว\nขา\nข่า\nข้า\nขาก\nขาก๊วย\nขาง\nข่าง\nข้าง\nขาณุ\nขาด\nขาทนียะ\nขาน\nขาบ\nข้าพเจ้า\nขาม\nข่าม\nข้าม\nขาย\nข่าย\nขาล\nขาว\nข่าว\nข้าว\nข้าวอังกุลี\nขำ\nขิก\nขิง\nขิงแกลง\nขิงแครง\nขิด\nขิปสัทโท\nขิม\nขี่\nขี้\nขี้เข็บ\nขีณาสพ\nขีด\nขี้ตังนี\nขีปนาวุธ\nขี้ยอก\nขีระ\nขึง\nขึ้ง\nขึ้น\nขึ้นฉ่าย\nขืน\nขื่น\nขื่อ\nขุก\nขุด\nขุน\nขุ่น\nขุนเพ็ด\nขุม\nขุย\nขู่\nขูด\nเข\nเข้\nเขก\nเข็ง\nเข่ง\nเขจร\nเข็ญ\nเข็ด\nเขดา\nเขต\nเขน\nเข็น\nเข่น\nเขนง\nเขน็ด\nเขนย\nเขบ็จขบวน\nเขบ็ต\nเขม\nเข็ม\nเข้ม\nเข้มขาบ\nเขม็ง\nเขม็ดแขม่\nเขม่น\nเขม้น\nเขม้นขะมัก\nเขมร\nเขมา\nเขม่า\nเขมือบ\nเขย\nเขยก\nเขย่ง\nเขย้อแขย่ง\nเขย่า\nเขยิน\nเขยิบ\nเขยื้อน\nเขรอะ\nเขลง\nเขลอะ\nเขละ\nเขลา\nเขลาะ\nเขว\nเขษม\nเขฬะ\nเขะขะ\nเขา\nเข่า\nเข้า\nเขิง\nเขิน\nเขิบ\nเขี่ย\nเขียง\nเขียด\nเขียดตะปาด\nเขียน\nเขี่ยน\nเขียม\nเขียว\nเขี้ยว\nเขียะ\nเขือ\nเขือง\nเขื่อง\nเขื่อน\nเขือม\nแข\nแข้\nแขก\nแข็ง\nแข่ง\nแข้ง\nแขน\nแข่น\nแข้น\nแขนง\nแขม\nแขม็บ\nแขม่ว\nแขยง\nแขย่ง\nแขวก\nแขวง\nแขวน\nแขวะ\nโข\nโขก\nโขง\nโข่ง\nโขด\nโขดง\nโขน\nโขนง\nโขม\nโขมง\nโขมด\nโขยก\nโขยง\nโขย่ง\nโขยด\nโขลก\nโขลง\nโขลน\nโขษม\nไข\nไข่\nไข้\nไขว่\nไขว้\nคคนะ\nคคนัมพร\nคคนางค์\nคคนานต์\nคง\nคงคา\nคงไคย\nคช\nคชาชาติ\nคชาชีพ\nคชาธาร\nคชาภรณ์\nคณนา\nคณบดี\nคณะ\nคณาจารย์\nคณาธิการ\nคณาธิปไตย\nคณานับ\nคณิกา\nคณิต\nคเณศ\nคด\nคดี\nคติ\nคทา\nคน\nค้น\nคนทา\nคนทิสอ\nคนที\nคนโท\nคนธ์\nคันธ์\nคนธรรพ์\nคเนจร\nคบ\nคม\nคมน์\nคมนาการ\nคมนาคม\nคมิกภัต\nครก\nครบ\nครรชิต\nครรภ\nครรภ์\nครรลอง\nครรโลง\nครรไล\nครวญ\nครวี\nครหา\nครอก\nครอง\nครองแครง\nคร่อเงาะ\nคร่อเทียน\nครอบ\nคร่อม\nคระเมิม\nคระแลง\nคระไล\nคระแวง\nคระหน\nคระหวน\nคระหาย\nคระโหย\nครั่ง\nครั้ง\nครัดเคร่ง\nครัน\nครั่น\nครั้น\nครับ\nครัว\nครา\nคร่า\nคราก\nคราง\nคราญ\nคราด\nคร้าน\nคราบ\nคราม\nคร้าม\nครามครัน\nคราว\nคร่าว\nคราส\nครำ\nคร่ำ\nคร่ำเคร่ง\nคริปทอน\nคริสต์\nครีบ\nครีม\nครีษมายัน\nครึ\nครึกครื้น\nครึกโครม\nครึ่ง\nครึ่ด\nครึน\nครึ้ม\nครืด\nครืน\nครื้น\nครืนครั่น\nครื้นครั่น\nครื้นครึก\nครื้นเครง\nครือ\nครุ\nครุคระ\nครุฑ\nครุ่น\nครุมเครือ\nครุย\nครุวนา\nครู\nครู่\nครูด\nคฤโฆษ\nคฤนถ์\nคฤหบดี\nคฤหัสถ์\nคฤหาสน์\nคลวง\nคลอ\nคล้อ\nคลอก\nคลอง\nคล่อง\nคล้อง\nคลอด\nคลอน\nคล้อย\nคลอรีน\nคลอโรฟอร์ม\nคลอโรฟีลล์\nคละ\nคละคลุ้ง\nคลัก\nคลั่ก\nคลัง\nคลั่ง\nคลัตช์\nคลับคล้าย\nคลับคลา\nคลา\nคล้า\nคลางแคลง\nคลาด\nคลาน\nคลาย\nคล้าย\nคล้ายคลึง\nคล่าว\nคลำ\nคล่ำ\nคล้ำ\nคลิ้งโคลง\nคลิด\nคลินิก\nคลี\nคลี่\nคลึง\nคลื่น\nคลุก\nคลุ้ง\nคลุบ\nคลุม\nคลุ่ม\nคลุ้ม\nควง\nควณ\nควน\nควบ\nควย\nควร\nควัก\nควั่ก\nควั่งคว้าง\nควัน\nควั่น\nคว้า\nควาก\nคว้าง\nควาญ\nควาน\nคว้าน\nความ\nควาย\nคว่าว\nคว่ำ\nควินิน\nควิวคว่าง\nคหกรรม\nคหกรรมศาสตร์\nคหบดี\nคหัฐ\nคอ\nค้อ\nคอก\nค็อกคัส\nค็อกเทล\nคอเคซอยด์\nค่องอ้อย\nคอด\nคอแดง\nคอน\nค่อน\nค้อน\nคอนกรีต\nคอนเดนเซอร์\nคอนแวนต์\nคอนเสิร์ต\nคอม\nค่อม\nค้อม\nคอมพิวเตอร์\nคอมมานโด\nคอมมิวนิสต์\nคอย\nค่อย\nค้อย\nคอยล์\nคอร์ด\nคอแลน\nคอสติกโซดา\nคะ\nค่ะ\nคะไขว่\nคะค้อย\nคะคาน\nคะนน\nคะนอง\nคะน้า\nคะนึง\nคะเน\nคะเนงร้าย\nคะเน็ด\nคะแนน\nคะมำ\nคะยั้นคะยอ\nคะเยอ\nคัก\nคั่ก\nคัคนะ\nคัคนัมพร\nคัคนางค์\nคัคนานต์\nคั่ง\nคังไคย\nคัจฉ\nคัณฑมาลา\nคัณฑสูตร\nคัด\nคัดเค้า\nคัดมอน\nคัดเม็ง\nคัทลียา\nคัน\nคั่น\nคั้น\nคันถรจนาจารย์\nคันธกุฎี\nคันธมาทน์\nคันธารราษฎร์\nคับ\nคับค้อน\nคับคา\nคับแค\nคัพภ์\nคัมภีร์\nคัมภีรภาพ\nคัล\nคั่ว\nคา\nค่า\nค้า\nค่าคบ\nคาง\nค่าง\nค้าง\nคางคก\nค้างคาว\nคาด\nคาถา\nคาทอลิก\nคาน\nค้าน\nคาบ\nคาพยุต\nคาม\nคามวาสี\nคามณีย์\nคามภีร์\nคาย\nค่าย\nคาร์บอน\nคาร์บอเนต\nคาร์บอลิก\nคาร์บูเรเตอร์\nคาร์โบรันดัม\nคาร์โบไฮเดรต\nคารม\nคารวะ\nคาราเต้\nคาราวาน\nคาว\nค่าว\nค้าว\nคาวตอง\nคาวี\nคาวุต\nคาส\nคำ\nค่ำ\nค้ำ\nคำนวณ\nคำนวร\nคำนับ\nคำนัล\nคำนึง\nคำนูณ\nคำฝอย\nคำเพลิง\nคำรน\nคำรบ\nคำราม\nคำแสด\nคำแหง\nคำโอง\nคิก\nคิง\nคิด\nคิมหันต์\nคิรี\nคิลาน\nคิลานะ\nคิว\nคิ้ว\nคี่\nคีต\nคีบ\nคีม\nคีรี\nคีรีบูน\nคึก\nคึ่ก\nคึกคัก\nคืน\nคืบ\nคือ\nคุ\nคุก\nคุกกี้\nคุกคาม\nคุกพาทย์\nคุ้ง\nคุณ\nคุด\nคุดทะราด\nคุต\nคุตติ\nคุ่น\nคุ้น\nคุป\nคุปต์\nคุปติ\nคุม\nคุ่ม\nคุ้ม\nคุย\nคุ้ย\nคุยหฐาน\nคุยหประเทศ\nคุรุ\nคุลา\nคุลิก่า\nคุลีการ\nคุหา\nคู\nคู่\nคู้\nคูณ\nคูถ\nคูน\nคูปอง\nคูเรียม\nคูหา\nเค้ก\nเค้เก้\nเค้ง\nเคณฑะ\nเคด\nเค็ด\nเคน\nเค้น\nเคเบิล\nเค็ม\nเคมี\nเคย\nเครง\nเคร่ง\nเครงครา\nเครงครำ\nเครดิต\nเครน\nเครา\nเคร่า\nเคราหณี\nเคราะห์\nเครียด\nเครียว\nเครือ\nเครื่อง\nเคล้ง\nเคล็ด\nเคล้น\nเคล้า\nเคล่าคล่อง\nเคลิบเคลิ้ม\nเคลิ้ม\nเคลีย\nเคลื่อน\nเคลือบ\nเคว้ง\nเคหะ\nเคหา\nเคอะ\nเค้า\nเคาน์เตอร์\nเคารพ\nเคาะ\nเคาะแคะ\nเคียง\nเคียด\nเคียน\nเคียม\nเคี่ยม\nเคียร\nเคียว\nเคี่ยว\nเคี้ยว\nเคือง\nแค\nแค่\nแค้\nแคแล\nแคดเมียม\nแค็ตตาล็อก\nแคแตร\nแคโทด\nแคน\nแค่น\nแค้น\nแคบ\nแคบหมู\nแคปซูล\nแคม\nแคร่\nแครก\nแครง\nแคระ\nแคลคูลัส\nแคลง\nแคลเซียม\nแคลน\nแคล้ว\nแคล่วคล่อง\nแคลอรี\nแคลิฟอร์เนียม\nแคว\nแควก\nแคว้น\nแคแสด\nแคะ\nโค\nโคก\nโคเคน\nโค่ง\nโค้ง\nโคจร\nโคเซแคนต์\nโคไซน์\nโคตร\nโคแทนเจนต์\nโคธา\nโคน\nโค่น\nโคบอลต์\nโคปผกะ\nโคม\nโคม่า\nโครก\nโครกคราก\nโครง\nโคร่ง\nโคร่งคร่าง\nโครม\nโครเมียม\nโครโมโซม\nโคราช\nโครำ\nโคล\nโคลง\nโคลน\nโควตา\nโคออร์ดิเนต\nใคร\nใคร่\nใคร่ครวญ\nไค\nไค้\nไคร้\nไคร้เครือ\nไคล\nไคล้\nฆนะ\nฆราวาส\nฆ้อง\nฆ่า\nฆาต\nฆาน\nฆานินทรีย์\nเฆี่ยน\nโฆรวิส\nโฆษก\nโฆษณา\nโฆษะ\nโฆษิต\nงก\nงง\nงด\nงดงาม\nงบ\nงม\nงวง\nง่วง\nงวด\nง่วน\nง้วน\nงวยงง\nงอ\nง้อ\nงอก\nงอกแงก\nง่อกแง่ก\nง่อง\nง่องแง่ง\nงอแง\nงอด\nงอดแงด\nงอน\nง่อน\nง่อนแง่น\nงอนหง่อ\nงอบ\nงอม\nง้อม\nงอย\nง่อย\nงัก\nงั่ก\nงั่ง\nงัด\nงัน\nงันงก\nงับ\nงัว\nงั่ว\nงัวเงีย\nงา\nง่า\nง้าง\nงาน\nง่าน\nงาบ\nงาม\nง่าม\nงาย\nง่าย\nง้าว\nงำ\nง่ำ\nง้ำ\nงิ้ว\nงี่เง่า\nงีบ\nงึก\nงึน\nงึม\nงุด\nงุนงง\nงุ่นง่าน\nงุบ\nงุบงิบ\nงุ้ม\nงุ่มง่าม\nงุย\nงู\nงูบ\nงูสวัด\nเงก\nเงย\nเงอะ\nเงอะงะ\nเงา\nเง่า\nเง้า\nเงาะ\nเงิน\nเงี่ยง\nเงี่ยน\nเงียบ\nเงี้ยว\nเงี่ยหู\nเงื้อ\nเงือก\nเงื่อง\nเงือด\nเงื่อน\nเงือบ\nเงื้อม\nแง\nแง่\nแง่ง\nแง่น\nแง้ม\nแงะ\nโง\nโง่\nโงก\nโงกเงก\nโงง\nโง่ง\nโง้ง\nโงงเงง\nโง่งเง่ง\nโงเง\nโงน\nโงนเงน\nไง้\nจก\nจง\nจ่ง\nจงกรม\nจงกล\nจงกลนี\nจงโคร่ง\nโจงโคร่ง\nจงอร\nจงอาง\nจด\nจดุรงค์\nจตุปัจจัย\nจตุลังคบาท\nจตุโลกบาล\nจตุสดมภ์\nจตุตถ\nจตุตถี\nจตุร\nจตุรงค์\nจตุรพักตร์\nจตุรพิธ\nจตุรพิธพร\nจน\nจบ\nจม\nจ่ม\nจมร\nจมรี\nจมูก\nจยุติ\nจร\nจรณะ\nจรด\nจรรจา\nจรรโจษ\nจรรม\nจรรยา\nจรรโลง\nจรลี\nจรวจ\nจรวด\nจรส\nจรอก\nจระเข้\nจระนำ\nจระบี\nจรัล\nจรัส\nจราจร\nจราญ\nจริก\nจริง\nจริต\nจริม\nจริยธรรม\nจริยวัตร\nจริยาวัตร\nจริยศาสตร์\nจริยศึกษา\nจริยา\nจรุง\nจรูง\nจรูญ\nจเร\nจล\nจลนพลศาสตร์\nจลนศาสตร์\nจลนี\nจลาจล\nจวก\nจ๊วก\nจวง\nจ้วง\nจ๋วง\nจวด\nจวน\nจวบ\nจวัก\nจอ\nจ่อ\nจ้อ\nจ๋อ\nจอก\nจ้อก\nจ๊อก\nจ้อกแจ้ก\nจอง\nจ้อง\nจ๋อง\nจ้องเต\nจองเปรียง\nจ้องหน่อง\nจองหอง\nจอแจ\nจ๋อแจ๋\nจอด\nจอน\nจ้อน\nจอนจ่อ\nจอบ\nจอม\nจ่อม\nจอมสุรางค์\nจ่อย\nจ้อย\nจ๋อย\nจอแส\nจะ\nจ้ะ\nจ๊ะ\nจ๋ะ\nจะกละ\nจะกลาม\nจะกูด\nจะขาบ\nจะเข้\nจะเข็บ\nจะงอย\nจะจะ\nจ๊ะจ๋า\nจะแจ้ง\nจะแจ่ม\nจะละเม็ด\nจะละหวั่น\nจัก\nจั้ก\nจักกาย\nจั๊กกิ้ม\nจักขุ\nจักจั่น\nจักจี้\nจั๊กจี้\nจั๊กเดียม\nจักร\nจักรพาก\nจักรวาก\nจักริน\nจักรี\nจั๊กเล้อ\nจักษุ\nจักแหล่น\nจัง\nจั้ง\nจั๋ง\nจังกวด\nจังกอบ\nจังก้า\nจังกูด\nจังโกฏก์\nจังงัง\nจั้งมั่ง\nจังไร\nจังหนับ\nจังหรีด\nจังหวะ\nจังหวัด\nจังหัน\nจัญไร\nจัณฑ์\nจัณฑาล\nจัด\nจัตตาฬีสะ\nจัตวา\nจัตุ\nจัตุรงค์\nจัตุรัส\nจัตุลังคบาท\nจัตุโลกบาล\nจัตุสดมภ์\nจัน\nจั่น\nจันโจษ\nจั่นดิน\nจันท์\nจันทน์\nจันทร์\nจันทรคติ\nจันทรคราส\nจันทรุปราคา\nจันทรเม็ด\nจันทวาร\nจันทัน\nจันอับ\nจับ\nจับกัง\nจับฉ่าย\nจับเดิม\nจับปิ้ง\nจับยี่กี\nจัมบก\nจัมปกะ\nจัมปา\nจัมมะ\nจัว\nจั่ว\nจั๊วะ\nจา\nจ่า\nจ้า\nจ๋า\nจาก\nจากพาก\nจาคะ\nจาคี\nจาง\nจ่าง\nจ้าง\nจางปาง\nจางวาง\nจาด\nจาตุรงค์\nจาตุรนต์\nจาตุรันต์\nจาน\nจ้าน\nจาบ\nจาบัล\nจาบัลย์\nจาป\nจาม\nจ่ามงกุฎ\nจามจุรี\nจามร\nจามรี\nจามีกร\nจ่าย\nจาร\nจ่ารง\nจารวาก\nจาระไน\nจาระบี\nจาริก\nจารึก\nจารี\nจารีต\nจารุ\nจ้าละหวั่น\nจาว\nจ้าว\nจ่าหวัก\nจำ\nจ้ำ\nจำกัด\nจำงาย\nจ้ำจี้\nจำเจ\nจำเดิม\nจำทวย\nจำนง\nจำนน\nจำนรรจ์\nจำนรรจา\nจำนวน\nจำนอง\nจำนัล\nจำนำ\nจำเนียน\nจำเนียม\nจำเนียร\nจำแนก\nจำบ่ม\nจำบัง\nจ้ำเบ้า\nจำปา\nจำปาดะ\nจำปี\nจำปูน\nจำพวก\nจำเพาะ\nจ้ำม่ำ\nจำรัส\nจำราญ\nจำรูญ\nจำเริญ\nจำเรียง\nจำลอง\nจำเลย\nจำเลาะ\nจำแลง\nจำแล่น\nจำหนับ\nจ๋ำหนับ\nจำหน่าย\nจำหระ\nจำหล่อ\nจำหลัก\nจำเหียง\nจำอวด\nจิ\nจิก\nจิ้งโกร่ง\nจิ้งจก\nจิงจ้อ\nจิ้งจอก\nจิงจัง\nจิ้งจัง\nจิงโจ้\nจิ้งหรีด\nจิ้งเหลน\nจิต\nจิตกาธาน\nจิตต์\nจิตร\nจิตรจุล\nจิตระ\nจิตรา\nจินเจา\nจินดา\nจินดาหนา\nจินดาหรา\nจินต์\nจิบ\nจิปาถะ\nจิ่ม\nจิ้ม\nจิ้มก้อง\nจิ้มลิ้ม\nจิรกาล\nจิ๋ว\nจี\nจี่\nจี้\nจี๋\nจี๋จ้อ\nจีแจ๊บ\nจี๊ด\nจีน\nจีนแส\nจีบ\nจีโบ\nจีม\nจีวร\nจึง\nจึ่ง\nจึ้ง\nจืด\nจุ\nจุก\nจุ๊กกรู๊\nจุกจิก\nจุกชี\nจุกผาม\nจุกโรหินี\nจุ่ง\nจุ๋งจิ๋ง\nจุฑา\nจุณ\nจุณณียบท\nจุด\nจุติ\nจุตูปปาตญาณ\nจุทส\nจุน\nจุ่น\nจุ้น\nจุนจู๋\nจุ้นจู๊\nจุนทการ\nจุนสี\nจุบ\nจุ๊บ\nจุบจิบ\nจุ๊บแจง\nจุ่ม\nจุ้ม\nจุ๋มจิ๋ม\nจุมพฏ\nจุมพรวด\nจุมพล\nจุมพิต\nจุมโพล่\nจุ้ย\nจุรณ\nจูรณ\nจุรี\nจุไร\nจุล\nจุลจอมเกล้า\nจุลวงศ์\nจุฬา\nจุฬาราชมนตรี\nจุฬาลัมพา\nจุฬาลำพา\nจู\nจู่\nจู้\nจู๋\nจูง\nจู้จี้\nจู๋จี๋\nจู๊ด\nจูบ\nเจ\nเจ๊ก\nเจ่ง\nเจ้ง\nเจ๊ง\nเจ๋ง\nเจ็ด\nเจ็ดตะคลี\nเจดีย์\nเจดียสถาน\nเจต\nเจตนา\nเจตพังคี\nเจตมูลเพลิง\nเจตสิก\nเจโตวิมุติ\nเจน\nเจ็บ\nเจรจา\nเจริญ\nเจริด\nเจรียง\nเจลียง\nเจว็ด\nเจษฎา\nเจ๊สัว\nเจอ\nเจ่อ\nเจ๋อ\nเจ๋อเจ๊อะ\nเจอร์เมเนียม\nเจอะ\nเจา\nเจ่า\nเจ้า\nเจ๊า\nเจาะ\nเจิ่ง\nเจิด\nเจิ่น\nเจิม\nเจีย\nเจียง\nเจียด\nเจียน\nเจี๋ยน\nเจี๊ยบ\nเจียม\nเจี๋ยมเจี้ยม\nเจียร\nเจียระไน\nเจียระบาด\nเจียว\nเจี๊ยวจ๊าว\nเจือ\nเจื่อน\nเจื้อย\nเจือสม\nแจ\nแจ้\nแจ๋\nแจก\nแจกัน\nแจง\nแจ่ง\nแจ้ง\nแจงลอน\nแจ๊ด\nแจ๊ดแจ๋\nแจตร\nแจ้น\nแจบ\nแจ่ม\nแจรง\nแจว\nแจ่ว\nแจ้ว\nแจ๋ว\nแจะ\nโจก\nโจ๊ก\nโจง\nโจ่งครึ่ม\nโจ๋งครึ่ม\nโจ่งครุ่ม\nโจ๋งเจ๋ง\nโจ่งแจ้ง\nโจท\nโจทก์\nโจทนา\nโจทย์\nโจน\nโจม\nโจร\nโจล\nโจษ\nโจษจัน\nใจ\nไจ\nไจ้\nฉก\nฉกรรจ์\nฉกษัตริย์\nฉกาจ\nฉกามาพจร\nฉกามาวจร\nฉง\nฉงน\nฉงาย\nฉทึง\nฉนวน\nฉนัง\nฉนาก\nฉนำ\nฉบัง\nฉบัด\nฉบับ\nฉบำ\nฉม\nฉมบ\nฉมวก\nฉมวย\nฉม่อง\nฉมัง\nฉมัน\nฉมา\nฉมำ\nฉล\nฉลวย\nฉลอง\nฉลอม\nฉลัก\nฉลับ\nฉลาก\nฉลาง\nฉลาด\nฉลาม\nฉลาย\nฉลิว\nฉลีก\nฉลุ\nฉลู\nฉวย\nฉวะ\nฉวัดเฉวียน\nฉวาง\nฉวี\nฉศก\nฉ้อ\nฉอก\nฉ่อง\nฉอด\nฉ่อย\nฉอเลาะ\nฉะ\nฉะฉาด\nฉะฉาน\nฉะฉ่ำ\nฉะฉี่\nฉะเฉื่อย\nฉะนั้น\nฉะนี้\nฉะอ้อน\nฉักกะ\nฉัฐ\nฉัด\nฉัตร\nฉัททันต์\nฉัน\nฉันท\nฉันท์\nฉันทะ\nฉันทา\nฉันทาคติ\nฉันทานุมัติ\nฉับ\nฉัพพรรณรังสี\nฉัยยา\nฉ่า\nฉาก\nฉาง\nฉ่าง\nฉ่าฉาว\nฉาด\nฉาดฉาน\nฉาตกภัย\nฉาน\nฉาบ\nฉาบฉวย\nฉาย\nฉายา\nฉาว\nฉ่ำ\nฉำฉา\nฉำแฉะ\nฉิ่ง\nฉิน\nฉินท์\nฉินทฤกษ์\nฉิบ\nฉิมพลี\nฉิว\nฉี่\nฉีก\nฉีด\nฉุ\nฉุก\nฉุด\nฉุน\nฉุป\nฉุป\nฉุย\nฉุยฉาย\nฉู่\nฉู่ฉี่\nฉูด\nฉูดฉาด\nเฉ\nเฉก\nเฉโก\nเฉ่ง\nเฉด\nเฉท\nเฉนียน\nเฉพาะ\nเฉย\nเฉลย\nเฉลว\nเฉลา\nเฉลิม\nเฉลี่ย\nเฉลียง\nเฉลี่ยง\nเฉลียบ\nเฉลียว\nเฉวียง\nเฉวียน\nเฉอะแฉะ\nเฉา\nเฉาก๊วย\nเฉาฮื้อ\nเฉาะ\nเฉิด\nเฉิบ\nเฉียง\nเฉียงพร้านางแอ\nเฉียด\nเฉียบ\nเฉียว\nเฉี่ยว\nเฉือน\nเฉื่อย\nแฉ\nแฉ่\nแฉก\nแฉง\nแฉ่ง\nแฉลบ\nแฉล้ม\nแฉะ\nโฉ\nโฉ่\nโฉเก\nโฉ่งฉ่าง\nโฉงเฉง\nโฉด\nโฉนด\nโฉบ\nโฉเบ๊\nโฉม\nโฉลก\nไฉน\nไฉไล\nชก\nชคัตตรัย\nชง\nชงโค\nชงฆ์\nชงฆา\nชงโลง\nชฎา\nชฎามังษี\nชฎามังสี\nชฎิล\nชด\nชน\nชนก\nชนนี\nชนม์\nชนวน\nชนะ\nชนัก\nชนา\nชนาง\nชนิด\nชเนตตี\nชบา\nชม\nชมดชม้อย\nชมนาด\nชมพู\nชมพู่\nชมรม\nชม้อย\nชม้าย\nชไม\nชยา\nชโย\nชรทึง\nชรริน\nชรอุ่ม\nชระล้ำ\nชระลุ\nชระอาบ\nชระเอม\nชรัด\nชรา\nชล\nชโลง\nชโลม\nช่วง\nชวด\nชวน\nชวย\nช่วย\nชวร\nชวลิต\nชวา\nชวาล\nชวาลา\nช่อ\nชอก\nช็อก\nช็อกโกเลต\nช็อกโกแลต\nชอง\nช่อง\nช้อง\nชองระอา\nชอน\nช่อน\nช้อน\nชอบ\nชอม\nช้อย\nชอล์ก\nชอ่ำ\nชอุ่ม\nชะ\nชะคราม\nชะงอก\nชะง่อน\nชะงัก\nชะงัด\nชะง้ำ\nชะงุ้ม\nชะเง้อ\nชะเงื้อม\nชะแง้\nชะโงก\nชะฉ่า\nชะช่อง\nชะชะ\nชะช้า\nชะโด\nชะตา\nชะต้า\nชะนี\nชะเนาะ\nชะเนียง\nชะพลู\nชะเพลิง\nชะมด\nชะมบ\nชะมวง\nชะมัง\nชะมัด\nชะแม่\nชะรอย\nชะลอ\nชะลอม\nชะล่า\nชะลาน\nชะลิน\nชะลูด\nชะเลง\nชะเลย\nชะแล็ก\nชะแลง\nชะวาก\nชะวาด\nชะเวิกชะวาก\nชะแวง\nชะอม\nชะอ้อน\nชะเอม\nชะโอน\nชัก\nชักคราม\nชักช้า\nชัง\nชั่ง\nชังคา\nชังฆ\nชัชวาล\nชัฏ\nชัด\nชัดช้า\nชัน\nชั้น\nชันกาด\nชันชี\nชันตุ\nชันนะตุ\nชันนุ\nชันโรง\nชันษา\nชันสูตร\nชัปนะ\nชัพ\nชัมพูนท\nชัย\nชัยพฤกษ์\nชัยภูมิ\nชัลลุกา\nชั่ว\nชั้ว\nชัวชม\nชา\nช้า\nชาคระ\nชาคริต\nชาคริยานุโยค\nช่าง\nช้าง\nช้าช่อน\nชาญ\nชาด\nชาดก\nชาต\nชาตบุษย์\nชาตรี\nชาตะ\nชาตา\nชาติ\nชาน\nชานุ\nช้าปี่\nชาปีไหน\nช้าแป้น\nช้าพลู\nชาม\nชามพูนท\nชามาดร\nชามาดา\nชามาตุ\nชาย\nชายา\nชาล\nชาลา\nชาลินี\nช้าเลือด\nชาว\nชาวี\nชำ\nช่ำ\nช้ำ\nชำงัด\nชำงาย\nช่ำชอง\nชำนะ\nชำนัญ\nชำนัน\nชำนาญ\nชำนิ\nชำเนียร\nชำมะนาด\nชำมะเลียง\nชำร่วย\nชำระ\nช้ำรั่ว\nชำรุด\nชำเรา\nชำเราะ\nชำแรก\nชำแระ\nชำเลือง\nชำแหละ\nชิ\nชิง\nชิ่ง\nชิงชัน\nชิงช้า\nชิงช้าชาลี\nชิงชี่\nชิงฮื้อ\nชิชะ\nชิชิ\nชิณณะ\nชิด\nชิเดนทรีย์\nชิต\nชิตินทรีย์\nชิน\nชิ้น\nชินโต\nชิโนรส\nชิม\nชิมแปนซี\nชิยา\nชิรณะ\nชิระ\nชิวหา\nชิสา\nชี\nชี่\nชี้\nชีปะขาว\nชีผะขาว\nชีผ้าขาว\nชีพ\nชีฟอง\nชีรณ\nชีระ\nชีวเคมี\nชีวประวัติ\nชีวภาพ\nชีววิทยา\nชีวะ\nชีวัน\nชีวา\nชีวาตม์\nชีวาลัย\nชีวิต\nชีวิตักษัย\nชีวิน\nชีวี\nชืด\nชื่น\nชื้น\nชื่อ\nชุก\nชุกชี\nชุ้ง\nชุณห\nชุด\nชุติ\nชุน\nชุบ\nชุม\nชุ่ม\nชุมนุม\nชุมพร\nชุมพา\nชุมแพรก\nชุมรุม\nชุมแสง\nชุมเห็ด\nชุ่ย\nชุลมุน\nชุลี\nชุษณะ\nชู\nชู้\nเช็ค\nเช้ง\nเช้งวับ\nเชงเลง\nเช็ด\nเชน\nเช่น\nเชย\nเชลง\nเชลย\nเชลแล็ก\nเชลียง\nเชวง\nเชษฐะ\nเชษฐา\nเชอ\nเช่า\nเช้า\nเชาว์\nเชาวน์\nเชิง\nเชิญ\nเชิด\nเชิ้ต\nเชียง\nเชี่ยน\nเชียบ\nเชี่ยม\nเชียร\nเชียร์\nเชียว\nเชี่ยว\nเชื่อ\nเชื้อ\nเชือก\nเชื่อง\nเชือด\nเชือน\nเชื่อม\nแช\nแช่\nแช่ง\nแชงมา\nแชบ๊วย\nแช่ม\nแชร์\nแชล่ม\nแชสซี\nแชะ\nโชก\nโชค\nโชงโลง\nโชดก\nโชดึก\nโชต\nโชตก\nโชติ\nโชติก\nโชน\nโชมโรม\nโชย\nโชยงการ\nโชยชาย\nโชยติส\nโชว์\nใช่\nใช้\nไช\nไชนะ\nไชย\nไชโย\nซก\nซ่ก\nซงดำ\nซ่งฮื้อ\nซด\nซน\nซ้น\nซบ\nซม\nซวดเซ\nซวน\nซวย\nซอ\nซอก\nซอง\nซ่อง\nซ้อง\nซองแมว\nซ้องแมว\nซอน\nซ่อน\nซ้อน\nซอม\nซ่อม\nซ้อม\nซอมซ่อ\nซอย\nซอส\nซัก\nซักส้าว\nซัง\nซั้ง\nซัด\nซับ\nซัลฟา\nซั้ว\nซา\nซ่า\nซาก\nซาง\nซ่าง\nซาด\nซาน\nซ่าน\nซาบซ่าน\nซาบซึ้ง\nซ่าโบะ\nซาแมเรียม\nซ้าย\nซาลาเปา\nซาว\nซ่าหริ่ม\nซำ\nซ้ำ\nซิ\nซี\nซิก\nซิกข์\nซิกซี้\nซิกแซ็ก\nซิการ์\nซิงโคนา\nซิ่น\nซินนามิก\nซินแส\nซิบ\nซิป\nซิฟิลิส\nซิลิคอน\nซิว\nซี่\nซีก\nซีเซียม\nซีด\nซี้ด\nซีนอน\nซีป่าย\nซีเมนต์\nซีเรียม\nซีลีเนียม\nซีอิ๊ว\nซึก\nซึง\nซึ่ง\nซึ้ง\nซึม\nซื่อ\nซื้อ\nซุก\nซุง\nซุน\nซุบ\nซุป\nซุ่ม\nซุ้ม\nซุ่มซ่าม\nซุย\nซู่\nซูโครส\nซูด\nซู้ด\nซูดซาด\nซูบ\nเซ\nเซ็ก\nเซแคนต์\nเซ็ง\nเซ่ง\nเซ้ง\nเซ็งแซ่\nเซต\nเซน\nเซ็น\nเซ่น\nเซนติกรัม\nเซนติเกรด\nเซนติเมตร\nเซนติลิตร\nเซปักตะกร้อ\nเซราะ\nเซรุ่ม\nเซลเซียส\nเซลล์\nเซลลูลอยด์\nเซลลูโลส\nเซ่อ\nเซอร์โคเนียม\nเซอะ\nเซา\nเซ้าซี้\nเซาะ\nเซิง\nเซิ้ง\nเซียน\nเซียบ\nเซียมซี\nเซียว\nเซี่ยว\nเซี่ยวกาง\nเซื่อง\nแซ\nแซ่\nแซ็กคาริน\nแซง\nแซงแซว\nแซด\nแซบ\nแซม\nแซยิด\nแซ่ว\nแซะ\nโซ\nโซ่\nโซก\nโซ่ง\nโซงโขดง\nโซเซ\nโซดา\nโซเดียม\nโซม\nโซรม\nโซลา\nไซ\nไซ้\nไซเกิล\nไซโคลน\nไซน์\nไซยาไนด์\nไซร้\nไซเรน\nไซโล\nฌาน\nฌาปน\nฌาปนกิจ\nฌาปนสถาน\nเฌอ\nเฌอเอม\nญวน\nญัตติ\nญาณ\nญาติ\nญานาซะฮ์\nญิบ\nญี่ปุ่น\nเญยธรรม\nไญยธรรม\nฎีกา\nฐกัด\nฐากูร\nฐาน\nฐานะ\nฐานันดร\nฐานานุกรม\nฐานานุรูป\nฐานานุศักดิ์\nฐานียะ\nฐาปน\nฐาปนา\nฐายี\nฐิต\nฐิติ\nฑาหก\nฑาหะ\nเฒ่า\nณรงค์\nเณร\nดก\nดง\nด้ง\nด้น\nดนโด่\nดนตรี\nดนัย\nดนุ\nดนู\nดบัสวิน\nดบัสวี\nดม\nดรงค์\nดรณี\nดรรชนี\nดราฟต์\nดรุณ\nดรุณี\nดล\nดวง\nด้วง\nดวด\nด่วน\nด้วน\nด้วย\nดอก\nดอง\nด่อง\nด้อง\nดองฉาย\nดองดึง\nดอด\nดอน\nด่อน\nดอม\nด้อม\nดอย\nด้อย\nดอลลาร์\nดะ\nดะโต๊ะ\nดะหมัง\nดัก\nดักดาน\nดักแด้\nดัง\nดั่ง\nดั้ง\nดัชนี\nดัด\nดัตช์\nดัน\nดั้น\nดับ\nดัมพ์\nดั้วเดี้ย\nดัสกร\nดา\nด่า\nดาก\nด่าง\nด้าง\nดาด\nดาน\nด่าน\nด้าน\nดาบ\nดาบส\nดาม\nด้าม\nด้ามจิ้ว\nดามพ์\nดาย\nด้าย\nดารกะ\nดารณี\nดารดาษ\nดาระ\nดารา\nดาล\nดาลัด\nดาว\nด่าว\nด้าว\nดาวดึงส์\nดาวบส\nดาษ\nดาษดา\nดำ\nด่ำ\nด้ำ\nดำกล\nดำเกิง\nดำแคง\nดำดง\nดำนาณ\nดำเนิน\nดำบล\nดำรง\nดำรวจ\nดำรัส\nดำริ\nดำรี\nดำรู\nดำฤษณา\nดำเลิง\nดิก\nดิ่ง\nดิฉัน\nดิฐ\nดิตถ์\nดิถี\nดิน\nดิ้น\nดิบ\nดิรัจฉาน\nดิลก\nดิ่ว\nดิ้ว\nดิ้วเดี้ยว\nดิษฐ์\nดิสโพรเซียม\nดี\nดีเซล\nดีด\nดีดีที\nดีบุก\nดีปลี\nดีเปรสชัน\nดีหมี\nดีหลี\nดึก\nดึง\nดึ่ง\nดึ่ม\nดื่น\nดื่ม\nดือ\nดื้อ\nดุ\nดุก\nดุกดิก\nดุกทะเล\nดุ้ง\nดุ้งดิ้ง\nดุจ\nดุด\nดุน\nดุ้น\nดุบ\nดุม\nดุ่ม\nดุ่ย\nดุรงค์\nดุริยะ\nดุริยางค์\nดุริยางคศาสตร์\nดุริยางคศิลป์\nดุล\nดุษฎี\nดุษณี\nดุษณีภาพ\nดุษิต\nดุสิต\nดุเหว่า\nดู\nดูกค่าง\nดูกร\nดูด\nดูรา\nดูแล\nเด\nเด่\nเดก\nเด็ก\nเดกซ์โทรส\nเดคากรัม\nเดคาเมตร\nเดคาลิตร\nเด้ง\nเด็จ\nเดช\nเดชน์\nเดชนะ\nเดชะ\nเดโช\nเดซิกรัม\nเดซิเมตร\nเดซิลิตร\nเด็ด\nเดน\nเด่น\nเดนมาร์ก\nเดรัจฉาน\nเด๋อ\nเด๋อด๋า\nเดา\nเด้า\nเดาะ\nเดิน\nเดิ่น\nเดิม\nเดียง\nเดียด\nเดียรดาษ\nเดียรถีย์\nเดียรัจฉาน\nเดียว\nเดี่ยว\nเดี๋ยว\nเดียะ\nเดื่อ\nเดือก\nเดื่อง\nเดือด\nเดือน\nเดือย\nแด\nแด่\nแดก\nแด็ก\nแดกงา\nแดกแด้\nแดง\nแดด\nแดน\nแด่น\nแด่ว\nแดะ\nแดะแด๋\nโด\nโด่\nโดกเดก\nโด่ง\nโดด\nโดน\nโดม\nโดมร\nโดย\nโดรณ\nใด\nได\nได้\nไดแซ็กคาไรด์\nไดนาโม\nไดนาไมต์\nไดโนเสาร์\nไดเรกตริกซ์\nตก\nต๊กโต\nตง\nต๋ง\nตงฉิน\nตงิด\nตงุ่น\nตด\nตติย\nตถาคต\nตน\nต้น\nตนัย\nตนุ\nตบ\nตบะ\nตปนียะ\nตม\nต้ม\nตมูก\nตยาคี\nตรง\nตรณี\nตรม\nตรรก\nตรรกะ\nตรลบ\nตรลอด\nตรลาด\nตรวจ\nตรวน\nตรอก\nตรอง\nตรอมใจ\nตรอมตรม\nตระ\nตระกล\nตระกวน\nตระกอง\nตระการ\nตระกูล\nตระคัร\nตระเตรียม\nตระนาว\nตระบก\nตระบอก\nตระบอง\nตระบัด\nตระบัน\nตระเบ็ง\nตระแบก\nตระแบง\nตระโบม\nตระพอง\nตระพัง\nตระลาการ\nตระวัน\nตระเว็ด\nตระเวน\nตระสัก\nตระหง่าน\nตระหนก\nตระหนัก\nตระหน่ำ\nตระหนี่\nตรัง\nตรังค์\nตรับ\nตรับฟัง\nตรัย\nตรัยตรึงศ์\nตรัส\nตรัสสา\nตรา\nตรากตรำ\nตราชู\nตราบ\nตราสัง\nตรำ\nตริ\nตริว\nตรี\nตรีปวาย\nตรีพิธพรรณ\nตรียัมปวาย\nตรึก\nตรึง\nตรุ\nตรุณ\nตรุณะ\nตรุษ\nตรู\nตรู่\nตฤณ\nตฤตีย\nตฤษณา\nตลก\nตลบ\nตลอด\nตลับ\nตลาด\nตลิ่ง\nตลึง\nตวง\nต่วน\nต้วมเตี้ยม\nตวัก\nตวัด\nตวาด\nตอ\nตอม่อ\nต่อ\nต้อ\nตอก\nต๊อก\nต๊อกต๋อย\nตอง\nต้อง\nตองกราย\nต้องเต\nตองแตก\nต่องแต่ง\nตองเหลือง\nตอด\nตอน\nต้อน\nตอบ\nตอเบา\nตอม\nต่อม\nต๋อม\nต่อย\nต้อย\nต้อยตริ่ง\nต้อยติ่ง\nต้อยตีวิด\nตอแย\nตอร์ปิโด\nต่อไส้\nตอแหล\nตะ\nตะกรน\nตะกร้อ\nตะกรัน\nตะกรับ\nตะกร้า\nตะกราม\nตะกรุด\nตะกรุม\nตะกรุมตะกราม\nตะกละ\nตะกลาม\nตะกวด\nตะกอ\nตะกอน\nตะกัง\nตะกั่ว\nตะกาง\nตะกาด\nตะกาย\nตะกาว\nตะกุกตะกัก\nตะกุย\nตะกู\nตะกูด\nตะเกียกตะกาย\nตะเกียง\nตะเกียบ\nตะแก\nตะแก่\nตะแกรง\nตะโก\nตะโก้\nตะโกก\nตะโกน\nตะโกรง\nตะโกรม\nตะไกร\nตะขบ\nตะขอ\nตะขาบ\nตะขิดตะขวง\nตะเข้\nตะเข็บ\nตะโขง\nตะคร้อ\nตะครอง\nตะครั่นตะครอ\nตะคร้ำ\nตะคริว\nตะคิว\nตะครุบ\nตะคอก\nตะคัน\nตะค้า\nตะคาก\nตะค้าน\nตะคุ่ม\nตะเครียว\nตะเคียว\nตะเคียน\nตะแคง\nตะไคร่\nตะไคร้\nตะเฆ่\nตะนอย\nตะนาว\nตะบม\nตะบอง\nตะบอย\nตะบัน\nตะบิ้ง\nตะบิด\nตะบิดตะบอย\nตะบี้ตะบัน\nตะบึง\nตะบูน\nตะเบ็ง\nตะเบ็งมาน\nตะเบ๊ะ\nตะแบก\nตะแบง\nตะโบม\nตะไบ\nตะปบ\nตะปลิง\nตะปิ้ง\nตะปุ่มตะป่ำ\nตะปู\nตะพง\nตะพด\nตะพอง\nตะพัก\nตะพัง\nตะพัด\nตะพั้น\nตะพาก\nตะพาน\nตะพาบ\nตะพาย\nตะพึด\nตะพึดตะพือ\nตะพุ่น\nตะเพรา\nตะเพิง\nตะเพิด\nตะเพียน\nตะโพก\nตะโพง\nตะโพน\nตะเภา\nตะใภ้\nตะม่อ\nตะมอย\nตะรังกะนู\nตะรังตังกวาง\nตะรังตังช้าง\nตะราง\nตะลอง\nตะลอน\nตะล่อม\nตะละ\nตะลาน\nตะลิงปลิง\nตะลิบ\nตะลีตะลาน\nตะลึง\nตะลึงพรึงเพริด\nตะลุง\nตะลุ่ม\nตะลุ่มนก\nตะลุมบอน\nตะลุ่มโปง\nตะลุมพอ\nตะลุมพุก\nตะลุย\nตะเลง\nตะแลงแกง\nตะไล\nตะวัน\nตะเวน\nตะหลิว\nตะหลุก\nตะหลุง\nตะแหง่ว\nตะแหมะแขะ\nตะโหงก\nตัก\nตักกะ\nตักเตือน\nตั๊กแตน\nตักษัย\nตัง\nตั่ง\nตั้ง\nตังเก\nตังฉ่าย\nตังเม\nตังวาย\nตังโอ๋\nตัจฉก\nตัจฉนี\nตัณฑุล\nตัณหา\nตัด\nตัน\nตันตระ\nตันติ\nตันหยง\nตับ\nตับปิ้ง\nตัว\nตั๋ว\nตัวจี๊ด\nตัวตืด\nตั้วโผ\nตั้วเหี่ย\nตา\nตาก\nตากวาง\nต่าง\nตาด\nตาน\nต่าน\nต้าน\nตานนกกด\nตานี\nตาบ\nตาม\nตามะแน\nตามิน\nตาย\nตาราไต\nตาล\nตาลุ\nต๋าว\nตาเสือ\nตาหนู\nตาฬ\nตำ\nต่ำ\nตำนาน\nตำบล\nตำแบ\nตำแย\nตำรวจ\nตำรับ\nตำรา\nตำรุ\nตำลึง\nตำเสา\nตำหนัก\nตำหนิ\nตำแหน่ง\nติ\nติก\nติ๊ก\nติกะ\nติกาหรัง\nติง\nติ่ง\nติ๋ง\nติ่งตั่ง\nติ๋งต่าง\nติงส\nติงสติ\nติณ\nติด\nติตติกะ\nติตติร\nติตถ\nติตถะ\nติถี\nติมิงคละ\nติรัจฉาน\nติลก\nติละ\nติ้ว\nตี\nตี่\nตีน\nตีบ\nตีรถะ\nตีระ\nตึ\nตึก\nตึ้ก\nตึ้กตั้ก\nตึง\nตึดตื๋อ\nตึ๊ดตื๋อ\nตืด\nตื่น\nตื้น\nตื้อ\nตื๊อ\nตื๋อ\nตุ\nตุ๊\nตุ๊กแก\nตุ๊กตา\nตุ๊กต่ำ\nตุกติก\nตุ๊กติ๊ก\nตุ๊กตุ่น\nตุ๊กตุ๋ย\nตุง\nตุ้งก่า\nตุ้งติ้ง\nตุ๊ดตู่\nตุน\nตุ่น\nตุ๋น\nตุนาหงัน\nตุบ\nตุ้บ\nตุ๊บป่อง\nตุปัดตุป่อง\nตุปัดตุเป๋\nตุ่ม\nตุ้ม\nตุ๋ม\nตุ้มกว้าว\nตุมกา\nตุ้มแซะ\nตุมตัง\nตุ้มเต๋น\nตุ้มปี่\nตุมพะ\nตุ่ย\nตุ้ย\nตุ๊ย\nตุ๋ยตุ่ย\nตุรคะ\nตุรงค์\nตุล\nตุลา\nตุหรัดตุเหร่\nตู\nตู่\nตู้\nตูก\nตูด\nตูบ\nตูม\nเต๊ก\nเต็ง\nเต่ง\nเตช\nเตโช\nเต้น\nเต็นท์\nเต็ม\nเตย\nเตร่\nเตร็ด\nเตรตา\nเตรียม\nเตรียมตรม\nเตละ\nเตลิด\nเตว็ด\nเต่อ\nเตอะ\nเตะ\nเตา\nเต่า\nเต้า\nเต๋า\nเต่าเกียด\nเต้าเจี้ยว\nเต้าทึง\nเต้าหู้\nเต้าฮวย\nเต๊าะ\nเตาะแตะ\nเติ่ง\nเติบ\nเติม\nเตี้ย\nเตียง\nเตียน\nเตียบ\nเตี๋ยม\nเตียรถ์\nเตียว\nเตี่ยว\nเตือน\nแต่\nแต้\nแตก\nแตง\nแต่ง\nแตงเม\nแต้จิ๋ว\nแตด\nแต๊ดแต๋\nแตน\nแต้ม\nแตร\nแตระ\nแต้ว\nแต้วแร้ว\nแต้วแล้ว\nแต่ว่า\nแต้แว้ด\nแตะ\nโต\nโต้\nโตก\nโต่ง\nโต้ง\nโตงเตง\nโตฎก\nโต๊ด\nโตน\nโตนด\nโต้โผ\nโตมร\nโตย\nโตรก\nโต๊ะ\nใต้\nไต\nไต่\nไต้\nไต๋\nไตร\nไตรกิศยา\nไตรดายุค\nไตร่ตรอง\nไตรย\nไต้หวัน\nถก\nถกล\nถงาด\nถด\nถนน\nถนอม\nถนัด\nถนัน\nถนำ\nถนิม\nถม\nถ่ม\nถมอ\nถมึงทึง\nถลก\nถลกบาตร\nถลน\nถล่ม\nถลอก\nถลัน\nถลา\nถลาก\nถลาย\nถลำ\nถลึงตา\nถลุง\nถ่วง\nถ้วน\nถ้วย\nถวัล\nถวัลย์\nถวาย\nถวิน\nถวิล\nถ่อ\nถ้อ\nถอก\nถอง\nถ่อง\nถ้อง\nถอด\nถอน\nถอบ\nถอบแถบ\nถ่อม\nถอย\nถ่อย\nถ้อย\nถะ\nถะถั่น\nถะมัดถะแมง\nถัก\nถัง\nถั่ง\nถัด\nถัทธ\nถัน\nถั่น\nถับ\nถัมภ์\nถัว\nถั่ว\nถา\nถ้า\nถาก\nถาง\nถ่าง\nถาด\nถาน\nถ่าน\nถาบ\nถาม\nถามะ\nถ่าย\nถ่าว\nถาวร\nถาวรธิรา\nถ้ำ\nถิ่น\nถี่\nถีบ\nถึก\nถึง\nถือ\nถุง\nถุน\nถุย\nถู\nถูก\nเถกิง\nเถน\nเถร\nเถระ\nเถรานุเถระ\nเถรี\nเถลไถล\nเถลิง\nเถลือกถลน\nเถ่อ\nเถอะ\nเถา\nเถ้า\nเถาวัลย์\nเถาะ\nเถิก\nเถิง\nเถิด\nเถิดเทิง\nเถิน\nเถียง\nเถียร\nเถือ\nเถือก\nเถื่อน\nแถ\nแถก\nแถง\nแถน\nแถบ\nแถม\nแถลง\nแถลบ\nแถว\nโถ\nโถง\nโถงเถง\nโถบ\nโถม\nโถมนาการ\nไถ\nไถ่\nไถ้\nไถง\nไถล\nทกล้า\nทแกล้ว\nท่ง\nทด\nทน\nท้น\nทนต์\nทนโท่\nทนาย\nทบ\nทบวง\nทมอ\nทมะ\nทมิฬ\nทโมน\nทยอย\nทแยง\nทรกรรม\nทรชน\nทรชาติ\nทรพิษ\nทรยศ\nทรราช\nทรลักษณ์\nทรง\nทรพี\nทรมาทรกรรม\nทรมาน\nทรรทึง\nทรรป\nทรรปณ์\nทรรปณะ\nทรรศนะ\nทรรศนาการ\nทรรศนีย์\nทรวง\nทรวดทรง\nทรวาร\nทรหด\nทรหวล\nทรหึง\nทรอมโบน\nทระนง\nทรัพย์\nทรัพยากร\nทรัมเป็ต\nทรานซิสเตอร์\nทราบ\nทราม\nทราย\nทรุด\nทฤษฎี\nทลาย\nทลิท\nทลิททก\nทวง\nท้วง\nท่วงท่า\nท่วงทำนอง\nท่วงที\nทวด\nทวน\nท้วน\nท่วม\nท้วม\nทวย\nท่วย\nท้วย\nทวอย\nทวัตดึงส์\nทวัย\nทวา\nทวาบร\nทว่า\nทวาย\nทวาร\nทวิ\nทวิช\nทวิตีย์\nทวิตียา\nทวี\nทวีธาภิเษก\nทวีป\nทศ\nทศมี\nทศางค์\nทหระ\nทหาร\nทอ\nท่อ\nท้อ\nทอก\nทอง\nท่อง\nท้อง\nทองกวาว\nทองภู\nทองลิน\nทองหลาง\nทองโหลง\nทองอุไร\nทอด\nทอน\nท่อน\nทอนซิล\nทอฟฟี่\nท่อม\nทอย\nทอเรียม\nทะ\nทะงัน\nทะนง\nทะนน\nทะนาน\nทะนุ\nทะเบียน\nทะมัดทะแมง\nทะมึน\nทะมื่น\nทะแม่ง\nทะยาน\nทะเยอทะยาน\nทะแย\nทะร่อทะแร่\nทะลวง\nทะลอก\nทะลัก\nทะลาย\nทะลึ่ง\nทะลุ\nทะลุดทะลาด\nทะเล\nทะเล้น\nทะเล่อทะล่า\nทะเลาะ\nทะเลิ่กทะลั่ก\nทะวาย\nทัก\nทักข์\nทักขิญ\nทักขิณ\nทักขิณา\nทักขิณาวัฏ\nทักขิโณทก\nทักขิไณยบุคคล\nทักทิน\nทักษะ\nทักษา\nทักษิณ\nทักษิณา\nทักษิโณทก\nทัง\nทั่ง\nทั้ง\nทังวล\nทังวี้ทังวล\nทังสเตน\nทัณฑ์\nทัณฑกรรม\nทัณฑฆาต\nทัณฑสถาน\nทัณฑะ\nทัณฑิกา\nทัณฑิมา\nทัณฑีบท\nทัด\nทัดทา\nทัต\nทัน\nทันต์\nทันตชะ\nทันตแพทย์\nทันติน\nทันตี\nทันธ์\nทับ\nทับทิม\nทับสมิงคลา\nทัพ\nทัพพะ\nทัพพี\nทั่ว\nทัศ\nทัศน์\nทัศนะ\nทัศนา\nทัศนคติ\nทัศนวิสัย\nทัศนศาสตร์\nทัศนศิลป์\nทัศนศึกษา\nทัศนาการ\nทัศนาจร\nทัศนีย์\nทัศนียภาพ\nทัศนูปกรณ์\nทัศไนย\nทัสนานุตริยะ\nทัฬหะ\nทัฬหิ\nทัฬหี\nทา\nท่า\nท้า\nทาก\nทาง\nท้าง\nทาฐะ\nทาฐิกะ\nทาฒะ\nทาฒิกะ\nทาน\nท่าน\nทานต์\nทานพ\nทาบ\nทาม\nท่ามกลาง\nทาย\nท้าย\nทายก\nทายัช\nทายาด\nทายาท\nทายิกา\nทารก\nทารพี\nทาริกา\nทารุณ\nทาว\nท่าว\nท้าว\nทาส\nทาสี\nทำ\nทำนบ\nทำนอง\nทำนาย\nทำนุ\nทำนูล\nทำเนา\nทำเนียบ\nทำไม\nทำลาย\nทำเล\nทิคัมพร\nทิฆัมพร\nทิ้ง\nทิงเจอร์\nทิ้งถ่อน\nทิ้งทูด\nทิชะ\nทิชากร\nทิชาชาติ\nทิฏฐะ\nทิฏฐานุคติ\nทิฏฐุชุกรรม\nทิฐธรรม\nทิฐิ\nทิด\nทิต\nทิน\nทิพ\nทิพย์\nทิพา\nทิม\nทิ่ม\nทิมทอง\nทิว\nทิวงคต\nทิวทัศน์\nทิวา\nทิศ\nทิศา\nทิศานุทิศ\nที\nที่\nทีฆชาติ\nทีฆนิกาย\nทีฆสระ\nทีฆายุ\nทีป\nทีม\nทีเอ็นที\nทึก\nทึกทัก\nทึ่ง\nทึ้ง\nทึดทือ\nทึนทึก\nทึบ\nทึม\nทึ่ม\nทื่อ\nทุ\nทุก\nทุกข์\nทุกขลาภ\nทุกขเวทนา\nทุกขารมณ์\nทุกฏ\nทุกรกิริยา\nทุกะ\nทุกัง\nทุกูล\nทุคตะ\nทุคติ\nทุ่ง\nทุ้ง\nทุงงะ\nทุจริต\nทุด\nทุทรรศนนิยม\nทุนิยม\nทุน\nทุ่น\nทุนนิมิต\nทุบ\nทุบทู\nทุปปัญญา\nทุพพรรณ\nทุพพล\nทุพพลภาพ\nทุพภิกขภัย\nทุม\nทุ่ม\nทุ้ม\nทุย\nทุ้ย\nทุรกันดาร\nทุรชน\nทุรชาติ\nทุรพล\nทุรลักษณ์\nทุรน\nทุรนทุราย\nทุรัศ\nทุราคม\nทุราจาร\nทุเรศ\nทุเรียน\nทุลักทุเล\nทุเลา\nทุศีล\nทุสสะ\nทุสสีล\nทู\nทูโม่ง\nทู่\nทู้\nทูกัง\nทู่ซี้\nทูต\nทูตานุทูต\nทูน\nทูบ\nทูม\nทูล\nทูเลียม\nเท\nเท่\nเทคนิค\nเทคนีเชียม\nเทคโนโลยี\nเท้ง\nเท้งเต้ง\nเท็จ\nเทนนิส\nเทพ\nเทพา\nเทพารักษ์\nเทพยเจ้า\nเทพยดา\nเทพยุดา\nเทพิน\nเทพินทร์\nเทพี\nเทเพนทร์\nเทโพ\nเทริด\nเทลลูเรียม\nเทวทัณฑ์\nเทวดา\nเทวทูต\nเทวธรรม\nเทวนาครี\nเทวนิยม\nเทวรูป\nเทวโลก\nเทววิทยา\nเทวสถาน\nเทวศ\nเทวษ\nเทวัญ\nเทวัน\nเทวาลัย\nเทวินทร์\nเทวี\nเทเวศ\nเทเวศร์\nเทเวศวร์\nเทศ\nเทศะ\nเทศาภิบาล\nเทศน์\nเทศนา\nเทห์\nเท่ห์\nเทห์ฟากฟ้า\nเทหวัตถุ\nเท่อ\nเท้อ\nเทอญ\nเทอม\nเทอร์เบียม\nเทอร์โมมิเตอร์\nเทอะทะ\nเทา\nเท่า\nเท้า\nเท้ายายม่อม\nเท่ารึง\nเทิ่ง\nเทิด\nเทิน\nเทิบ\nเทิบทาบ\nเทิ้ม\nเที่ยง\nเทียด\nเทียน\nเที้ยน\nเทียบ\nเทียม\nเทียร\nเที้ยร\nเทียว\nเที่ยว\nเทือ\nเทื่อ\nเทื้อ\nเทือก\nแท้\nแท็กซี่\nแทง\nแท่ง\nแท้ง\nแท็งก์\nแทงทวย\nแทงวิสัย\nแทตย์\nแทน\nแท่น\nแทนเจนต์\nแทนทาลัม\nแทบ\nแทรก\nแทรกเตอร์\nแทลเลียม\nแทะ\nโท\nโท่\nโทกเทก\nโทง\nโทงเทง\nโทณะ\nโทน\nโทนโท่\nโทมนัส\nโทรคมนาคม\nโทรทรรศน์\nโทรทัศน์\nโทรพิมพ์\nโทรภาพ\nโทรเลข\nโทรศัพท์\nโทรสาร\nโทรม\nโทษ\nโทษา\nโทษานุโทษ\nโทสะ\nโทสาคติ\nโทโส\nโทหฬินี\nไท\nไท้\nไทเทเนียม\nไทเทรต\nไทย\nไทร\nไทวะ\nธง\nธงก์\nธชะ\nธชี\nธตรฐ\nธนบัตร\nธนสมบัติ\nธนสาร\nธนะ\nธนา\nธนาคม\nธนาคาร\nธนาณัติ\nธเนศ\nธโนปจัย\nธไนศวรรย์\nธนิต\nธนิษฐะ\nธนิษฐา\nธนุ\nธนุรวิทยา\nธนุรเวท\nธนู\nธม\nธมกรก\nธรณะ\nธรณิน\nธรณินทร์\nธรณิศ\nธรณิศร\nธรณิศวร์\nธรณี\nธรมาน\nธรรม\nธรรมนูญ\nธรรมยุต\nธรรมยุติกนิกาย\nธรรมะ\nธรรมาทิตย์\nธรรมาธรรม\nธรรมาธิปไตย\nธรรมาธิษฐาน\nธรรมานุสาร\nธรรมาภิมุข\nธรรมาภิสมัย\nธรรมายตนะ\nธรรมารมณ์\nธรรมาสน์\nธรรมิก\nธรา\nธราดล\nธราธร\nธราธาร\nธราธิบดี\nธราธิป\nธริษตรี\nธเรษตรี\nธเรศ\nธวัช\nธัช\nธัญ\nธัญญาหาร\nธันยา\nธันยาวาท\nธันวาคม\nธัมมะ\nธาดา\nธาตรี\nธาตวากร\nธาตุ\nธาตุโขภ\nธาตุมมิสสา\nธานิน\nธานินทร์\nธานี\nธาร\nธารกำนัล\nธารคำนัล\nธารณะ\nธารณา\nธารา\nธาษตรี\nธำมรงค์\nธำรง\nธิดา\nธิติ\nธีระ\nธุช\nธุดงค์\nธุดงควัตร\nธุต\nธุตตะ\nธุมเกตุ\nธุมา\nธุรการ\nธุรกิจ\nธุระ\nธุรำ\nธุลี\nธุวดารา\nธุวภาค\nธุวมณฑล\nธูป\nเธนุ\nเธอ\nเธียร\nโธ่\nโธวนะ\nนก\nนกุล\nนขลิขิต\nนขะ\nนขา\nนเคนทร์\nนโคทร\nนคร\nนครินทร์\nนคเรศ\nนง\nนงคุฐ\nนที\nนนตรา\nนนท์\nนันทน์\nนนทรี\nนนทลี\nนนทิ\nนบ\nนปุงสกลิงค์\nนปุงสกลึงค์\nนพ\nนพนิต\nนภจร\nนภดล\nนภศูล\nนภา\nนภาลัย\nนม\nนมตำเรีย\nนมตำเลีย\nนมะ\nนมัสการ\nนมาซ\nนยนะ\nนยนา\nนโยบาย\nนรชาติ\nนรเทพ\nนรนาถ\nนรบดี\nนรบาล\nนรสิงห์\nนรสีห์\nนรา\nนรากร\nนราธิป\nนรินทร์\nนริศ\nนริศร\nนริศวร\nนเรศ\nนเรศวร\nนเรศวร์\nนโรดม\nนรก\nนรกานต์\nนรการ\nนรี\nนฤเทพ\nนฤบดี\nนฤบาล\nนฤเบศ\nนฤปเวศม์\nนฤปัตนี\nนฤคหิต\nนฤนาท\nนฤมล\nนฤตย์\nนฤตยสถาน\nนฤพาน\nนฤมาณ\nนฤมิต\nนลาฏ\nนลิน\nนลินี\nนวกรรม\nนวการ\nนวกิจ\nนวนิยาย\nนวปฎล\nนวรัตน์\nนวโลหะ\nนวกะ\nนวโกวาท\nนวด\nนวม\nน่วม\nนวมี\nนวย\nนวล\nนวัตกรรม\nนวาระ\nนหารุ\nนหุต\nนฬการ\nนอ\nนอก\nนอง\nน่อง\nน้อง\nน่องแน่ง\nนอต\nนอน\nนอบ\nน้อม\nน้อย\nน้อยหน่า\nน้อยโหน่ง\nนะ\nนะแน่ง\nนัก\nนักขัต\nนักขัตฤกษ์\nนักษัตร\nนักสราช\nนัข\nนั่ง\nนังคัล\nนัจ\nนัฑ\nนัด\nนัดดา\nนัตถุ์\nนั่น\nนั้น\nนันททายี\nนันทนาการ\nนันทวัน\nนันทิ\nนับ\nนัย\nนัยน์\nนัยนา\nนัว\nนัวเนีย\nนา\nน่า\nน้า\nนาก\nนากบุด\nนากาสาหรี\nนาค\nนาคร\nนาคา\nนาคาวโลก\nนาคินทร์\nนาคี\nนาเคนทร์\nนาเคศวร\nนาง\nนางเกล็ด\nนางนวล\nนางนูน\nนางรม\nนางรำ\nนางล้อม\nนางเล็ด\nนางเลิ้ง\nนางหงส์\nนางอาย\nนางแอ่น\nนาฏ\nนาฏกะ\nนาด\nนาถ\nนาท\nนาที\nนาน\nน่าน\nนานัครส\nนานัปการ\nนานา\nนาเนก\nนาบ\nนาภี\nนาม\nนามานุกรม\nนามาภิไธย\nนาย\nน่าย\nนายก\nนายิกา\nนารา\nนารายณ์\nนารี\nนาเรศ\nนาลิวัน\nนาว\nน้าว\nนาวา\nนาวิก\nนาวิน\nนาวี\nนาเวศ\nนาศ\nนาสา\nนาสิก\nนาฬิกา\nนาฬิเก\nนาฬี\nนำ\nน้ำ\nน้ำละว้า\nน้ำว้า\nนิ\nนิกเกิล\nนิกขะ\nนิกร\nนิกรอยด์\nนิกาย\nนิคม\nนิครนถ์\nนิคหกรรม\nนิคหะ\nนิคหิต\nนิคาลัย\nนิเคราะห์\nนิโคติน\nนิโครธ\nนิโครม\nนิ่ง\nนิจ\nนิด\nนิตย์\nนิตยทาน\nนิตยภัต\nนิตยสาร\nนิติ\nนิทร\nนิทรรศการ\nนิทรา\nนิทรารมณ์\nนิทัศน์\nนิทาน\nนิเทศ\nนิธาน\nนิธิ\nนินทา\nนินนาท\nนินาท\nนิบาต\nนิปริยาย\nนิปัจการ\nนิพจน์\nนิพนธ์\nนิพพาน\nนิพพิทา\nนิพัทธ์\nนิพันธ์\nนิพิท\nนิเพท\nนิภา\nนิ่ม\nนิ้ม\nนิมนต์\nนิมมาน\nนิมมานรดี\nนิมิต\nนิยต\nนิยม\nนิยัตินิยม\nนิยาม\nนิยาย\nนิยุต\nนิรคุณ\nนิรชร\nนิรชรา\nนิรทุกข์\nนิรเทศ\nนิรโทษ\nนิรโทษกรรม\nนิรนัย\nนิรนาม\nนิรภัย\nนิรมล\nนิรมาน\nนิรัตศัย\nนิรันดร\nนิราพาธ\nนิรามัย\nนิรามิษ\nนิราศรัย\nนิรินธน์\nนิรมาณ\nนิรมิต\nนิรยบาล\nนิรัพพุท\nนิรา\nนิราศ\nนิรุกติ\nนิรุตติ\nนิรุทธ์\nนิโรธ\nนิล\nนิลุบล\nนิโลบล\nนิ่ว\nนิ้ว\nนิวคลิอิก\nนิวเคลียร์\nนิวเคลียส\nนิวตรอน\nนิวรณ์\nนิวัต\nนิวัตน์\nนิวาต\nนิวาส\nนิเวศ\nนิเวศน์\nนิศา\nนิษาท\nนิสัช\nนิสัชชาการ\nนิสัย\nนิสาท\nนิสิต\nนิสีทนสันถัต\nนิสีทนะ\nนิสีทนาการ\nนิเสธ\nนี่\nนี้\nนี่นัน\nนีรนาท\nนีออน\nนีโอดิเมียม\nนึก\nนึง\nนึ่ง\nนุง\nนุ่ง\nนุงนัง\nนุช\nนุต\nนุ่น\nนุ่ม\nนุ้ย\nนูน\nนู่น\nนู้น\nเนกขัม\nเนตบอล\nเนตร\nเนติ\nเน้น\nเนบิวลา\nเนปจูน\nเนปทูเนียม\nเนมิ\nเนย\nเนรกัณฐี\nเนรคุณ\nเนรเทศ\nเนรนาด\nเนรมิต\nเนระพูสี\nเนอ\nเน้อ\nเนา\nเน่า\nเนาวนิต\nเนาวรัตน์\nเนิน\nเนิ่น\nเนิบ\nเนียง\nเนียน\nเนียม\nเนียร\nเนียรทุกข์\nเนียรเทศ\nเนียรนาท\nเนื้อ\nเนือง\nเนื่อง\nเนือย\nแน่\nแน่ง\nแน่น\nแนบ\nแน่บ\nแนม\nแนว\nแน่ว\nแนะ\nแน่ะ\nแนะแหน\nโน\nโน้ต\nโนน\nโน่น\nโน้น\nโนเบเลียม\nโน้ม\nโนมพรรณ\nโนรา\nโนรี\nใน\nไน\nไนต์คลับ\nไนโตรเจน\nไนลอน\nไนโอเบียม\nบ่\nบก\nบง\nบ่ง\nบงก์\nบ๊งเบ๊ง\nบงสุ์\nบด\nบดินทร์\nบดี\nบถ\nบท\nบน\nบ่น\nบพิตร\nบพิธ\nบ่ม\nบรม\nบรมัตถ์\nบรรจง\nบรรจถรณ์\nบรรจบ\nบรรจวบ\nบรรจุ\nบรรเจิด\nบรรณ\nบรรดา\nบรรตานึก\nบรรถร\nบรรทม\nบรรทัด\nบรรทาน\nบรรทุก\nบรรเทา\nบรรเทือง\nบรรพ\nบรรพ์\nบรรพชา\nบรรพชิต\nบรรพต\nบรรยง\nบรรยงก์\nบรรยเวกษก์\nบรรยากาศ\nบรรยาย\nบรรลัย\nบรรลาย\nบรรลุ\nบรรเลง\nบรรโลม\nบรรษัท\nบรรสบ\nบรรสพ\nบรรสม\nบรรสาน\nบรรสาร\nบรรหาน\nบรรหาร\nบรอนซ์\nบรั่นดี\nบรัศว์\nบราลี\nบริกรรม\nบริการ\nบริขาร\nบริขารโจล\nบริคณห์\nบริจาค\nบริจาริกา\nบริเฉท\nบริชน\nบริดจ์\nบริบท\nบริบาล\nบริบูรณ์\nบริพนธ์\nบริพัตร\nบริพันธ์\nบริพาชก\nบริพาร\nบริภัณฑ์\nบริภาษ\nบริโภค\nบริมาส\nบริยาย\nบริรม\nบริรักษ์\nบริราช\nบริวรรต\nบริวาร\nบริวาส\nบริเวณ\nบริษัท\nบริสชน\nบริสุทธิ์\nบริหาร\nบล็อก\nบวก\nบวง\nบ่วง\nบวช\nบวน\nบ้วน\nบวบ\nบวม\nบ๊วย\nบวร\nบหลิ่ม\nบอ\nบ่อ\nบ้อ\nบอก\nบอง\nบ่อง\nบ้อง\nบ๊อง\nบ้องแบ๊ว\nบองหลา\nบอด\nบอน\nบ่อน\nบอบ\nบ้อม\nบ๋อม\nบ่อย\nบอระเพ็ด\nบอล\nบอลลูน\nบ้อหุ้น\nบ๊ะ\nบ๊ะจ่าง\nบะหมี่\nบัก\nบักโกรก\nบัคเตรี\nบัง\nบั้ง\nบังกะโล\nบังเกิด\nบังคน\nบังคม\nบังคล\nบังควร\nบังคับ\nบังคัล\nบังแทรก\nบังวาย\nบังเวียน\nบังสุกุล\nบังสุกูลิก\nบังสูรย์\nบังหวน\nบังเหตุ\nบังเหียน\nบังอร\nบังอวจ\nบังอาจ\nบังเอิญ\nบัญจก\nบัญชร\nบัญชา\nบัญชี\nบัญญัติ\nบัญหา\nบัฏ\nบัณฑร\nบัณฑิต\nบัณฑิตย์\nบัณฑุ\nบัณฑูร\nบัณเฑาะก์\nบัณเฑาะว์\nบัณณาส\nบัณรส\nบัณรสี\nบัด\nบัดกรี\nบัดซบ\nบัดสี\nบัตร\nบัทม์\nบัน\nบั่น\nบั้น\nบันจวบ\nบันดล\nบันดาล\nบันได\nบันทึก\nบันทึง\nบันเทิง\nบันยะบันยัง\nบันลือ\nบัปผาสะ\nบัพ\nบัพชา\nบัพพาชนียกรรม\nบัล\nบัลลพ\nบัลลังก์\nบัลลูน\nบัลเลต์\nบัว\nบา\nบ่า\nบ้า\nบาก\nบาง\nบ่าง\nบ้าง\nบาจรีย์\nบาซิลลัส\nบาด\nบาดทะจิต\nบาดทะพิษ\nบาดทะยัก\nบาดาล\nบาตร\nบาท\nบาทสกุณี\nบาทหลวง\nบาทาธึก\nบาทุกา\nบาน\nบ้าน\nบานชื่น\nบานเช้า\nบานบุรี\nบานไม่รู้โรย\nบานเย็น\nบ้าบ๋า\nบาป\nบาย\nบ่าย\nบ้าย\nบาร์\nบารนี\nบารมี\nบาร์เรล\nบาร์เลย์\nบารอมิเตอร์\nบ้าระบุ่น\nบาเรียน\nบาเรียม\nบาล\nบาลี\nบ่าว\nบ่าวขุน\nบาศ\nบาศก์\nบาสเกตบอล\nบาหลี\nบ๋ำ\nบำเทิง\nบำนาญ\nบำบวง\nบำบัด\nบำเพ็ญ\nบำราบ\nบำราศ\nบำรุง\nบำรู\nบำเรอ\nบำหยัด\nบำเหน็จ\nบิ\nบิฐ\nบิณฑบาต\nบิด\nบิดร\nบิดหล่า\nบิดา\nบิตุ\nบิตุจฉา\nบิตุรงค์\nบิตุเรศ\nบิตุลา\nบิน\nบิ่น\nบินยา\nบิลเลียด\nบิวเรตต์\nบิสมัท\nบี้\nบีฑา\nบีตา\nบีบ\nบีเยศ\nบึก\nบึกบึน\nบึง\nบึ่ง\nบึ้ง\nบุ\nบุก\nบุคคล\nบุคลากร\nบุคลาธิษฐาน\nบุคลิก\nบุง\nบุ่ง\nบุ้ง\nบุ้งกี๋\nบุญ\nบุญญาธิการ\nบุญญานุภาพ\nบุญญาภินิหาร\nบุญญาภิสังขาร\nบุณฑริก\nบุณมี\nบุณย์\nบุตร\nบุตรี\nบุถุชน\nบุทคล\nบุนนาค\nบุบ\nบุบบิบ\nบุปผชาติ\nบุพกรรม\nบุพการี\nบุพกิจ\nบุพชาติ\nบุพทักษิณ\nบุพนิมิต\nบุพบท\nบุพพาจารย์\nบุพเพสันนิวาส\nบุพโพ\nบุ๋ม\nบุ่มบ่าม\nบุ้ย\nบุรณะ\nบุรพทิศ\nบุรพบท\nบุรพาจารย์\nบูรพาจารย์\nบุระ\nบุราณ\nบุรินทร์\nบุริมทิศ\nบุริมพรรษา\nบุริมสิทธิ\nบุรี\nบุรุษ\nบุโรทั่ง\nบุษกร\nบุษบก\nบุษบง\nบุษบัน\nบุษบา\nบุษบามินตรา\nบุษปราค\nบุษปะ\nบุษย์\nบุษย์น้ำทอง\nบุษยมาส\nบุษยะ\nบุษราคัม\nบุหงัน\nบุหงา\nบุหรง\nบุหรี่\nบุหลัน\nบู่\nบู้\nบูชนียสถาน\nบูชา\nบูชิต\nบูด\nบูดู\nบูร\nบูรณ์\nบูรณภาพ\nบูรณมี\nบูรณะ\nบูรณาการ\nบูรพ์\nบูรพะ\nบูรพา\nเบ้\nเบ่ง\nเบ๊จี๋\nเบญกานี\nเบญจกัลยาณี\nเบญจกามคุณ\nเบญจขันธ์\nเบญจดุริยางค์\nเบญจธรรม\nเบญจบรรพต\nเบญจพรรณ\nเบญจเพส\nเบญจมาศ\nเบญจรงค์\nเบญจศก\nเบญจศีล\nเบญจะ\nเบญจา\nเบญจางค์\nเบญจางคประดิษฐ์\nเบญญา\nเบญพาด\nเบ็ด\nเบ็ดเตล็ด\nเบ็ดเสร็จ\nเบน\nเบนซิน\nเบรก\nเบริลเลียม\nเบส\nเบ้อ\nเบอร์\nเบอร์คีเลียม\nเบ้อเร่อ\nเบ้อเร่อเท่อ\nเบ้อเริ่ม\nเบ้อเริ่มเทิ่ม\nเบอะ\nเบอะบะ\nเบะ\nเบา\nเบ้า\nเบาราณ\nเบาะ\nเบิก\nเบิ่ง\nเบี้ย\nเบี่ยง\nเบียด\nเบียน\nเบียร์\nเบี้ยว\nเบือ\nเบื่อ\nเบื้อ\nเบื้อง\nเบือน\nแบ\nแบ้\nแบก\nแบคทีเรีย\nแบ่ง\nแบงก์\nแบดมินตัน\nแบตเตอรี่\nแบน\nแบนโจ\nแบบ\nแบ็บ\nแบเรียม\nแบหลา\nแบะ\nโบ\nโบ้\nโบ๋\nโบก\nโบกขรณี\nโบกขรพรรษ\nโบชุก\nโบต\nโบนัส\nโบ๊เบ๊\nโบย\nโบรมีน\nโบรอน\nโบราณ\nโบสถ์\nใบ\nใบ้\nไบ่\nปก\nปกติ\nปกรณ์\nปกรณัม\nปกิณกะ\nปกีรณัม\nปโกฏิ\nปง\nป่ง\nปงช้าง\nปฎล\nปฏัก\nปฏิกรณ์\nปฏิกรรม\nปฏิการะ\nปฏิกิริยา\nปฏิกูล\nปฏิคม\nปฏิคหิต\nปฏิคาหก\nปฏิฆะ\nปฏิชีวนะ\nปฏิญญา\nปฏิญาณ\nปฏิทิน\nปฏิบถ\nปฏิบัติ\nปฏิปทา\nปฏิปักษ์\nปฏิปัน\nปฏิปุจฉาพยากรณ์\nปฏิปุจฉาวาที\nปฏิพัทธ์\nปฏิพากย์\nปฏิภาค\nปฏิภาณ\nปฏิมา\nปฏิมากร\nปฏิยุทธ์\nปฏิรพ\nปฏิรูป\nปฏิโลม\nปฏิวัติ\nปฏิวาต\nปฏิวาท\nปฏิเวธ\nปฏิสนธิ\nปฏิสวะ\nปฏิสังขรณ์\nปฏิสันถาร\nปฏิสัมภิทา\nปฏิเสธ\nปฐพี\nปฐม\nปฐวี\nปณต\nปณาม\nปณิธาน\nปณิธิ\nปณีต\nปด\nปดิวรัดา\nปติ\nปถพี\nปถมัง\nปถวี\nปทัฏฐาน\nปทัสถาน\nปทานุกรม\nปทีป\nปทุม\nปน\nป่น\nปนัดดา\nปปัญจะ\nปม\nปรนัย\nปรปักษ์\nปรโลก\nปรวาที\nปรก\nปรกติ\nปรง\nปรตยักษ์\nปรน\nปรนนิบัติ\nปรนิมมิตวสวัตดี\nปรบ\nปรปักษ์\nปรมัตถ์\nปรมาจารย์\nปรมาณู\nปรมาภิไธย\nปรมาภิเษก\nปรมินทร์\nบรเมนทร์\nปรเมศวร์\nปรเมษฐ์\nปรวด\nปรวนแปร\nปรศุ\nปรสิต\nปร๋อ\nปรองดอง\nปรอด\nปรอท\nปรอย\nประ\nประกบ\nประกฤต\nประกฤติ\nประกล\nประกวด\nประกวดประขัน\nประกอบ\nประกัน\nประกับ\nประกาย\nประกายพรึก\nประการ\nประกาศ\nประกาศนียบัตร\nประกาศิต\nประกำ\nประกิด\nประกิต\nประคด\nประคนธรรพ\nประคนธรรพ์\nประคบ\nประคบประหงม\nประคอง\nประคับประคอง\nประคัลภ์\nประคำ\nประคิ่น\nประคุณ\nประเคน\nประเคราะห์\nประโคน\nประโคนธรรพ\nประโคนธรรพ์\nประโคม\nประจง\nประจญ\nประจบ\nประจบประแจง\nประจวบ\nประจ๋อประแจ๋\nประจักษ์\nประจักษนิยม\nประจัญ\nประจัน\nประจาก\nประจาค\nประจาน\nประจำ\nประจิม\nประจิ้มประเจ๋อ\nประจุ\nประจุคมน์\nประจุบัน\nประเจก\nประเจิด\nประเจิดประเจ้อ\nประเจียด\nประแจ\nประชด\nประชน\nประชวม\nประชวร\nประชัน\nประชา\nประชาธิปไตย\nประชิด\nประชี\nประชุม\nประเชิญ\nประณต\nประณม\nประณาม\nประณิธาน\nประณิธิ\nประณีต\nประณุท\nประดง\nประดน\nประดวน\nประดอน\nประดอย\nประดัก\nประดักประเดิด\nประดัง\nประดับ\nประดา\nประดาก\nประดาป\nประดาษ\nประดิชญา\nประดิดประดอย\nประดิทิน\nประดิษฐ์\nประดิษฐกรรม\nประดิษฐาน\nประดุง\nประดุจ\nประดู่\nประเด\nประเด็น\nประเดิม\nประเดียง\nประเดี๋ยว\nประเดี๋ยวประด๋าว\nประแดง\nประแดะ\nประโดง\nประโดย\nประตง\nประตัก\nประตาป\nประติชญา\nประติญาณ\nประติทิน\nประติมากร\nประติมากรรม\nประติรพ\nประตู\nประถม\nประถมจินดา\nประทม\nประท้วง\nประทวน\nประทักษ์\nประทักษิณ\nประทัง\nประทัด\nประทับ\nประทาน\nประทาย\nประทาศี\nประทิน\nประทิ่น\nประทีป\nประทุฐ\nประทุน\nประทุษ\nประทุษฐ์\nประเทศ\nประเทา\nประเทียด\nประเทียบ\nประเทือง\nประธาน\nประธานาธิบดี\nประนม\nประนอ\nประนอม\nประนัง\nประนัปดา\nประนีประนอม\nประปราน\nประปราย\nประปา\nประเปรี้ยง\nประเปรียว\nประพจน์\nประพนธ์\nประพรม\nประพฤติ\nประพฤทธิ์\nประพัด\nประพัทธ์\nประพันธ์\nประพาต\nประพาส\nประพาสมหรณพ\nประพาฬ\nประพิณ\nประพิมพ์ประพาย\nประพุทธ์\nประเพณี\nประโพธ\nประไพ\nประไพร\nประภพ\nประภัสสร\nประภา\nประภาคาร\nประภาพ\nประภาษ\nประภาส\nประเภท\nประมง\nประมวล\nประมาณ\nประมาท\nประมุข\nประมุท\nประมูล\nประเมิน\nประโมง\nประโมทย์\nประยงค์\nประยุกต์\nประยุทธ์\nประยุร\nประยูร\nประโยค\nประโยชน์\nประโรหิต\nประลมพ์\nประลอง\nประลัย\nประลาต\nประลาย\nประลุ\nประเล่ห์\nประเล้าประโลม\nประโลม\nประวรรต\nประวรรตน์\nประวัติ\nประวาล\nประวาลปัทม์\nประวาส\nประวิง\nประวิช\nประวิตร\nประวิน\nประวีณ\nประเวณี\nประเวศ\nประเวศน์\nประศม\nประศาสน์\nประศุ\nประสก\nประสงค์\nประสบ\nประสพ\nประสม\nประสะ\nประสัก\nประสันนาการ\nประสัยห์\nประสา\nประสาท\nประสาธน์\nประสาน\nประสาร\nประสิทธิ์\nประสิทธิผล\nประสิทธิภาพ\nประสีประสา\nประสูต\nประสูติ\nประเสบัน\nประเสบันอากง\nประเสริฐ\nประหนึ่ง\nประหม่า\nประหยัด\nประหลาด\nประหล่ำ\nประหวัด\nประหวั่น\nประหัตประหาร\nประหาณ\nประหาร\nประเหล\nประเหส\nประไหมสุหรี\nประอบ\nประอร\nปรัก\nปรักปรำ\nปรักมะ\nปรัง\nปรัชญา\nปรัตถจริยา\nปรัตยุบัน\nปรัน\nปรับ\nปรัมปรา\nปรัศจิม\nปรัศนา\nปรัศนี\nปรัศว์\nปรัสสบท\nปร่า\nปรากฏ\nปรากรม\nปรากฤต\nปราการ\nปราง\nปรางค์\nปราจีน\nปราชญ์\nปราชญา\nปราชัย\nปราณ\nปราณี\nปราด\nปราน\nปรานี\nปราบ\nปราบดาภิเษก\nปราปต์\nปราม\nปรามาส\nปราโมช\nปราโมทย์\nปราย\nปรารถนา\nปรารภ\nปรารมภ์\nปราศ\nปราศจาก\nปราศรัย\nปราษณี\nปราษาณ\nปราสัย\nปราสาท\nปรำ\nปริ\nปริก\nปริกขาร\nปริกรรม\nปริกัป\nปริคณห์\nปริจาค\nปริจาริกา\nปริเฉท\nปริชน\nปริซึม\nปริญญา\nปริณาม\nปริณายก\nปริต\nปริตตะ\nปริตโตทก\nปริตร\nปริทรรศน์\nปริทัยหัคคี\nปริทัศน์\nปริเทพ\nปริเทวะ\nปรินิพพาน\nปริบ\nปริบท\nปริปันถ์\nปริพนธ์\nปริพัตร\nปริพันธ์\nปริพาชก\nปริภัณฑ์\nปริภาษ\nปริภูมิ\nปริโภค\nปริ่ม\nปริมณฑล\nปริมาณ\nปริมาตร\nปริยัติ\nปริยานุช\nปริยาย\nปริเยศ\nปริโยสาน\nปริวรรต\nปริวัตร\nปริวาร\nปริวาส\nปริวิตก\nปริเวณ\nปริศนา\nปริษัท\nปริสัญญู\nปริสุทธิ\nปริหาน\nปริหาร\nปรี่\nปรีชญา\nปรีชา\nปรี๊ด\nปรีดา\nปรีดิ\nปรีดิ์\nปรีดี\nปรีติ\nปรียะ\nปรียา\nปรึก\nปรึกษา\nปรึง\nปรือ\nปรื๋อ\nปรุ\nปรุง\nปรู\nปรู๋\nปรูด\nปรู๊ด\nปรู๊ดปร๊าด\nปรู๊ฟ\nปฤงคพ\nปฤจฉา\nปฤษฎางค์\nปฤษฐ\nปลก\nปลกเปลี้ย\nปลง\nปล่ง\nปลด\nปล้น\nปลวก\nปลอก\nปล่อง\nปล้อง\nปลอด\nปล้อน\nปลอบ\nปลอม\nปล่อย\nปละ\nปลัก\nปลั๊ก\nปลัง\nปลั่ง\nปลัด\nปลัดขิก\nปลา\nปลาต\nปลาบ\nปลาย\nปลาสเตอร์\nปลาสนาการ\nปล้ำ\nปลิง\nปลิด\nปลิ้น\nปลิโพธ\nปลิม\nปลิ่ม\nปลิว\nปลี\nปลีก\nปลื้ม\nปลุก\nปลูก\nปวกเปียก\nปวง\nป่วง\nปวด\nป่วน\nป้วน\nป้วนเปี้ยน\nป่วย\nปวัตน์\nปวารณา\nปวาล\nปวาส\nปวาฬ\nปวิช\nปวิตร\nปวิธ\nปวิเวก\nปวีณ\nปวุติ\nปเวณี\nปเวส\nปเวสน์\nปศุ\nปสันนะ\nปสันนาการ\nปสาท\nปสาน\nปสาสน์\nปสุ\nปสุต\nปสูติ\nปหังสนะ\nปหาน\nปหาร\nปหาส\nปอ\nป้อ\nป๋อ\nปอก\nปอง\nป่อง\nป้อง\nปอด\nปอน\nป้อน\nปอนด์\nปอเนาะ\nปอบ\nป้อแป้\nปอม\nป้อม\nป๋อม\nปอย\nป้อย\nป้อยอ\nปะ\nปะกน\nปะกัง\nปะการัง\nปะกำ\nปะขาว\nปะงาบ\nปะตาปา\nปะตาระกาหลา\nปะติดปะต่อ\nปะติยาน\nปะทะ\nปะทะปะทัง\nปะทุ\nปะทุน\nปะปน\nปะมง\nปะราลี\nปะรำ\nปะไร\nปะลอม\nปะเลง\nปะแล่ม\nปะโลง\nปะวะหล่ำ\nปะหงับ\nปะหนัน\nปะหัง\nปะเหลาะ\nปัก\nปักข์\nปักเป้า\nปักษ์\nปักษา\nปักษิน\nปักษี\nปัง\nปั๋ง\nปังสุ์\nปังสุกุล\nปัจจัตตะ\nปัจจันต์\nปัจจันตคาม\nปัจจันตชนบท\nปัจจันตประเทศ\nปัจจัย\nปัจจามิตร\nปัจจุคมน์\nปัจจุทธรณ์\nปัจจุบัน\nปัจจุสมัย\nปัจเจก\nปัจโจปการกิจ\nปัจฉา\nปัจฉิม\nปัจถรณ์\nปัจนึก\nปัจยาการ\nปัจเวกขณ์\nปัชชุน\nปัญจนที\nปัญจวัคคีย์\nปัญจก\nปัญจกะ\nปัญจมี\nปัญจวีสติ\nปัญญัติ\nปัญญา\nปัญหา\nปัฏ\nปัฏนะ\nปัฐยาวัต\nปัณฑรหัตถี\nปัณณะ\nปัณณาส\nปัณณาสก์\nปัณรสี\nปัณหิ\nปัด\nปัตคาด\nปัตตะ\nปัตตานึก\nปัตตานุโมทนา\nปัตตาเวีย\nปัตติ\nปัตติก\nปัตถร\nปัตถะ\nปัตนิ\nปัตนี\nปัตหล่า\nปัถพี\nปัถวี\nปัทม์\nปัทมะ\nปัทมาสน์\nปัน\nปั่น\nปั้น\nปั้นจั่น\nปันจุเหร็จ\nปั้นลม\nปั้นหยา\nปั้นเหน่ง\nปับ\nปั๊บ\nปัปผาสะ\nปัพพาชนียกรรม\nปัพภาระ\nปั๊ม\nปัยกา\nปัยยิกา\nปัวเปีย\nปัศจิม\nปัศตัน\nปัสสาวะ\nปัสสาสะ\nปา\nป่า\nป้า\nปาก\nปาง\nป้าง\nปาจรีย์\nปาจิตตีย์\nปาจีน\nปาฏลิ\nปาฏิบท\nปาฏิบุคลิก\nปาฏิโภค\nปาฏิหาริย์\nปาฐก\nปาฐกถา\nปาฐะ\nปาณกชาติ\nปาณะ\nปาณาติบาต\nปาณิ\nปาณี\nปาด\nปาติโมกข์\nปาตี\nปาเต๊ะ\nปาท่องโก๋\nปาทังกา\nปาทาน\nปาทุกา\nปาน\nป่าน\nป้าน\nปานะ\nปานียะ\nป้าบ\nป๊าบ\nปาพจน์\nปาม\nปาโมกข์\nป่าย\nป้าย\nปายาส\nปาร์เกต์\nปารมี\nปารเมศ\nปาราชิก\nปาริฉัตร\nปาริชาต\nปารุสกวัน\nปาล\nปาล์ม\nปาลิไลยก์\nปาลี\nปาว\nป่าว\nป๊าว\nปาวาร\nปาษาณ\nปาส\nปาสาณ\nปาสาทิกะ\nปาหนัน\nปาหี่\nปำ\nป้ำ\nป้ำเป๋อ\nปิกนิก\nปิ้ง\nปิงคละ\nปิงปอง\nปิฎก\nปิฏฐะ\nปิฐิ\nปิณฑะ\nปิด\nปิตตะ\nปิตา\nปิตามหัยกา\nปิตามหัยยิกา\nปิตุ\nปิตุจฉา\nปิตุภูมิ\nปิตุลา\nปิโตรเลียม\nปิ่น\nปิ่นแก้ว\nปิ่นโต\nปิปผลี\nปิ่ม\nปิ้ม\nปิยะ\nปิยังคุ\nปิโยรส\nปิลันธน์\nปิ๋ว\nปิศาจ\nปิหกะ\nปี\nปี่\nปี้\nปี๋\nปีก\nปีฐะ\nปี๊ด\nปีติ\nปีน\nปีบ\nปี๊บ\nปีศาจ\nปีฬกะ\nปึก\nปึง\nปึ่ง\nปึ๋ง\nปึ้ด\nปึมปื้อ\nปืน\nปื้น\nปือ\nปื้อ\nปื๋อ\nปุ\nปุ๊\nปุก\nปุกปุย\nปุคละ\nปุ้งกี๋\nปุงควะ\nปุงลิงค์\nปุงลึงค์\nปุจฉา\nปุฏะ\nปุณฑริก\nปุด\nปุตตะ\nปุถุชน\nปุนนาค\nปุนภพ\nปุนัพสุ\nปุบ\nปุ๊บ\nปุปผะ\nปุปะ\nปุพพะ\nปุ่ม\nปุ่มป่ำ\nปุ้ม\nปุ๋ม\nปุย\nปุ้ย\nปุ๋ย\nปุรณะ\nปุระ\nปุราณ\nปุราณะ\nปุริมพรรษา\nปุเรจาริก\nปุโรหิต\nปุลลิงค์\nปุลลึงค์\nปุลินท์\nปุโลปุเล\nปุษยะ\nปุสสะ\nปู\nปู่\nปูชกะ\nปูชนียบุคคล\nปูชนียวัตถุ\nปูชนียะ\nปูชา\nปูชิต\nปูด\nปูน\nปูม\nปู้ยี่ปู้ยำ\nปูระ\nปูลู\nเป้\nเป๋\nเปก\nเป๊ก\nเป่ง\nเป้ง\nเป๋ง\nเป็ด\nเปตพลี\nเปตอง\nเป็น\nเปยยาล\nเปร็ง\nเปรต\nเปรม\nเปรย\nเปรอ\nเปรอะ\nเปราะ\nเปรียง\nเปรี้ยง\nเปรี้ยงปร้าง\nเปรียญ\nเปรียบ\nเปรี่ยม\nเปรียว\nเปรี้ยว\nเปรียะ\nเปรี๊ยะ\nเปรื่อง\nเปรื้อย\nเปล\nเปล่ง\nเปลว\nเปลา\nเปล่า\nเปล้า\nเปลาะ\nเปลี้ย\nเปลี่ยน\nเปลี่ยม\nเปลี่ยว\nเปลือก\nเปลือง\nเปลื้อง\nเปลือย\nเปศะ\nเปศัส\nเปสการ\nเปสละ\nเปสุญวาท\nเป๋อ\nเป้อเย้อ\nเปอร์\nเปอร์เซ็นต์\nเปะ\nเปา\nเป่า\nเป้า\nเป๊า\nเป๋า\nเป๋าฮื้อ\nเปาะ\nเป๊าะ\nเปาะเปี๊ยะ\nเปาะแปะ\nเปิก\nเปิง\nเปิงมาง\nเปิด\nเปิ่น\nเปิบ\nเปิ๊บ\nเปีย\nเปียก\nเปี๊ยก\nเปี๊ยบ\nเปี่ยม\nเปี้ยว\nเปี๊ยว\nเปียะ\nเปี๊ยะ\nเปือก\nเปื้อน\nเปื่อย\nแป\nแป้ง\nแป๋ง\nแปด\nแป๊ด\nแปทู\nแป้น\nแป๊น\nแปบ\nแป๊บ\nแปม\nแปร\nแปร๋\nแปรก\nแปรง\nแปร่ง\nแปร๊ด\nแปร้น\nแปร๋น\nแปรปรวน\nแประ\nแปล\nแปล้\nแปลก\nแปลง\nแปลน\nแปลบ\nแปล๊บ\nแป้ว\nแป๊ว\nแปะ\nแป๊ะ\nแป๊ะซะ\nโป\nโป่\nโป้\nโป๊\nโปก\nโป๊ก\nโป๊กเกอร์\nโปกขรณี\nโปกขรพรรษ\nโปเก\nโปง\nโป่ง\nโป้ง\nโป่งข่าม\nโปงลาง\nโป่งวิด\nโปฐบท\nโปฐปทมาส\nโปดก\nโปตถกะ\nโปน\nโป๊ป\nโป๊ยเซียน\nโปรแกรม\nโปรง\nโปร่ง\nโปรด\nโปรตอน\nโปรตีน\nโปรเตสแตนต์\nโปรแทรกเตอร์\nโปรย\nโปล่ง\nโปลิโอ\nโปโล\nโปสก\nโปสต์การ์ด\nโปะ\nโป๊ะ\nโป๊ะจ้าย\nไป\nไป่\nไป๋\nไปยาล\nไปรษณีย์\nไปรษณียบัตร\nไปรษณียภัณฑ์\nไปรษณียากร\nไปล่\nไปศาจ\nผก\nผกา\nผกาย\nผคม\nผง\nผงก\nผงม\nผงะ\nผงาด\nผง่าน\nผจง\nผจญ\nผจัญ\nผจาน\nผชุม\nผณิน\nผณินทร\nผณิศวร\nผด\nผดุง\nผเดิน\nผทม\nผนวก\nผนวช\nผนัง\nผนิด\nผนึก\nผม\nผยอง\nผรณาปีติ\nผรสุ\nผริต\nผรุสวาท\nผล\nผลคุน\nผลคุนี\nผล็อย\nผละ\nผลัก\nผลัด\nผลับ\nผลัวะ\nผลา\nผลาญ\nผลานิสงส์\nผลาผล\nผลาหาร\nผลิ\nผลิกะ\nผลิต\nผลิน\nผลี\nผลีผลาม\nผลึก\nผลึ่ง\nผลือ\nผลุ\nผลุง\nผลุด\nผลุน\nผลุนผลัน\nผลุบ\nผลุบผลับ\nผลุย\nผลู\nผวน\nผวย\nผวา\nผสม\nผสาน\nผอง\nผ่อง\nผ่อน\nผอบ\nผอม\nผ็อย\nผอูน\nผะ\nผะดา\nผะสา\nผัก\nผัคคุณ\nผัคคุณี\nผัง\nผัด\nผัน\nผับ\nผัว\nผัวะ\nผัสสะ\nผัสสาหาร\nผา\nผ่า\nผ้า\nผาก\nผาง\nผ่าง\nผาณิต\nผาด\nผาติ\nผ่าน\nผาม\nผาย\nผ่ายผอม\nผาล\nผาลคุน\nผาลา\nผ่าว\nผาสุก\nผ้าฮาด\nผำ\nผ้ำ\nผิ\nผิง\nผิด\nผิตะ\nผิน\nผิว\nผี\nผี้ว์\nผึง\nผึ่ง\nผึ้ง\nผึ้งรวง\nผืน\nผื่น\nผุ\nผุด\nผุยผง\nผุสราคา\nผู้\nผูก\nเผ\nเผง\nเผชิญ\nเผ็ด\nเผด็จ\nเผดิม\nเผดียง\nเผ่น\nเผนิก\nเผย\nเผยอ\nเผยิบ\nเผยิบผยาบ\nเผล\nเผล่\nเผล็ด\nเผลอ\nเผลอไผล\nเผละ\nเผลาะ\nเผลาะแผละ\nเผลียง\nเผอเรอ\nเผอิญ\nเผอิล\nเผะ\nเผา\nเผ่า\nเผ้า\nเผาะ\nเผิ้ง\nเผิน\nเผียน\nเผือ\nเผื่อ\nเผือก\nเผือด\nเผือน\nเผื่อน\nแผ่\nแผก\nแผง\nแผด\nแผน\nแผ่น\nแผนก\nแผล\nแผลง\nแผล็บ\nแผล็ว\nแผละ\nแผ่ว\nแผ้ว\nโผ\nโผง\nโผฏฐัพพะ\nโผน\nโผเผ\nโผย\nโผล่\nโผลกเผลก\nโผละ\nโผอน\nโผะ\nไผ\nไผ่\nไผท\nฝน\nฝรั่ง\nฝรั่งเศส\nฝ่อ\nฝอย\nฝัก\nฝัง\nฝั่ง\nฝัด\nฝัน\nฝา\nฝ่า\nฝ้า\nฝาก\nฝาง\nฝาด\nฝาน\nฝาย\nฝ่าย\nฝ้าย\nฝิ่น\nฝี\nฝี่\nฝีก\nฝึก\nฝืด\nฝืน\nฝุ่น\nฝูง\nเฝ้า\nเฝือ\nเฝือก\nเฝือง\nเฝื่อน\nแฝก\nแฝง\nแฝด\nใฝ่\nไฝ\nพก\nพกุล\nพง\nพงศ์\nพงศกร\nพงศธร\nพงศา\nพงศาวดาร\nพจน์\nพจนา\nพจนานุกรม\nพจนารถ\nพจนีย์\nพจมาน\nพจี\nพชระ\nพญา\nพญาลอ\nพณิช\nพณิชย์\nพดด้วง\nพธู\nพนันดร\nพนาดร\nพนาดอน\nพนาราม\nพนาลัย\nพนาลี\nพนาวาส\nพนาเวศ\nพนาศรม\nพนาสณฑ์\nพนาสัณฑ์\nพเนจร\nพ่น\nพ้น\nพนม\nพนอง\nพนอม\nพนัก\nพนักงาน\nพนัง\nพนัน\nพนัส\nพนา\nพนาย\nพนิดา\nพนิต\nพบ\nพม่า\nพยนต์\nพยศ\nพยัก\nพยักพเยิด\nพยัคฆ์\nพยัคฆา\nพยัคฆิน\nพยัคฆี\nพยัชน์\nพยัญชนะ\nพยัต\nพยับ\nพยากรณ์\nพยาฆร์\nพยางค์\nพยาธิ\nพยาน\nพยาบาท\nพยาบาล\nพยาม\nพยามะ\nพยายาม\nพยุ\nพยุง\nพยุหยาตรา\nพยุหโยธา\nพยุหเสนา\nพยุหะ\nพยู่ห์\nพเยีย\nพร\nพรต\nพรม\nพรรค\nพรรค์\nพรรคานต์\nพรรณ\nพรรณนา\nพรรดึก\nพรรลาย\nพรรษ\nพรรษา\nพรรเอิญ\nพรวด\nพรวน\nพรหม\nพรหมจรรย์\nพรหมจาริณี\nพรหมจารี\nพรหมา\nพรหมาสตร์\nพรหมินทร์\nพรอก\nพร่อง\nพร้อง\nพรอด\nพร้อม\nพร้อมพรัก\nพร่อย\nพร้อย\nพระ\nพระนอม\nพระนาด\nพระฮาม\nพรักพร้อม\nพรั่ง\nพรัด\nพรั่น\nพรับ\nพร่า\nพร้า\nพราก\nพราง\nพร่าง\nพราด\nพราน\nพราย\nพราว\nพราหมณ์\nพราหมณะ\nพราหมณี\nพราหมี\nพรำ\nพร่ำ\nพริก\nพริ้ง\nพริบ\nพริ้ม\nพรึง\nพรึน\nพรึบ\nพรึ่บ\nพรืด\nพรุ\nพรุ่ง\nพรุน\nพรู\nพรูด\nพฤกษ์\nพฤกษชาติ\nพฤกษเทวดา\nพฤกษราช\nพฤกษศาสตร์\nพฤกษา\nพฤฒ\nพฤฒา\nพฤฒาจารย์\nพฤฒิ\nพฤต\nพฤติ\nพฤทธ์\nพฤทธิ์\nพฤนต์\nพฤนท์\nพฤศจิก\nพฤศจิกายน\nพฤษภ\nพฤษภาคม\nพฤหัสบดี\nพล\nพละ\nพลากร\nพลาดิศัย\nพลาธิการ\nพลานามัย\nพลบ\nพลวก\nพลวง\nพลวัต\nพลศาสตร์\nพลอ\nพล้อ\nพลอง\nพลอด\nพลอน\nพลอมแพลม\nพลอย\nพล่อย\nพลั่ก\nพลัง\nพลั่ง\nพลั้ง\nพลัด\nพลัน\nพลับ\nพลับพลา\nพลับพลึง\nพลั่ว\nพล่า\nพลาง\nพลาญ\nพลาด\nพล่าน\nพลาม\nพล่าม\nพลาย\nพลาสติก\nพลาสมา\nพลาหก\nพลำ\nพล้ำ\nพลำภัง\nพลิก\nพลิพัท\nพลิ้ว\nพลี\nพลุ\nพลุก\nพลุ่ก\nพลุกพล่าน\nพลุ่ง\nพลุ้ย\nพลู\nพลูโต\nพลูโทเนียม\nพวก\nพวง\nพ่วง\nพวน\nพวย\nพสก\nพสุ\nพสุธา\nพสุสงกรานต์\nพหล\nพหุ\nพหุล\nพหู\nพอ\nพ่อ\nพ้อ\nพอก\nพอง\nพ้อง\nพอน\nพ้อม\nพอโลเนียม\nพะ\nพะงา\nพะงาบ\nพะจง\nพะทำมะรง\nพะนอ\nพะเน้าพะนอ\nพะเนิน\nพะเนียง\nพะแนง\nพะพาน\nพะพิง\nพะเพิง\nพะยอม\nพ่ะย่ะค่ะ\nพะยูง\nพะยูน\nพะเยิบ\nพะเยิบพะยาบ\nพะรุงพะรัง\nพะโล้\nพะไล\nพะวง\nพะวักพะวน\nพะวา\nพะว้าพะวัง\nพะอง\nพะอากพะอำ\nพะอืดพะอม\nพัก\nพักตร์\nพักตรา\nพักร\nพัง\nพังกา\nพังงา\nพังผืด\nพังพวย\nพังพอน\nพังพาน\nพังพาบ\nพังเพย\nพัช\nพัชนี\nพัชระ\nพัญจน์\nพัฒนะ\nพัฒนา\nพัฒนากร\nพัฒนาการ\nพัด\nพัดชา\nพัดดึงส์\nพัตร\nพัทธ์\nพัทธยา\nพัทธสีมา\nพัทร\nพัน\nพันตู\nพันทาง\nพันธ์\nพันธะ\nพันธกรณี\nพันธบัตร\nพันธมิตร\nพันธนะ\nพันธนาคาร\nพันธนาการ\nพันธุ์\nพันธุกรรม\nพันลึก\nพันลือ\nพันเลิศ\nพันเอิญ\nพับ\nพัลลภ\nพัลวัน\nพัว\nพัวะ\nพัศดี\nพัสดุ\nพัสตร์\nพัสถาน\nพา\nพาก\nพากเพียร\nพากย์\nพาง\nพ่าง\nพาชี\nพาณิช\nพาณิชย์\nพาณิชยกรรม\nพาณิชยการ\nพาณิชยศาสตร์\nพาณิชยศิลป์\nพาณินี\nพาณี\nพาณีนี\nพาด\nพาท\nพาทย์\nพาธ\nพาธา\nพาน\nพ่าน\nพานร\nพานรินทร์\nพาม\nพาย\nพ่าย\nพายม้า\nพายัพ\nพายุ\nพาร์เซก\nพารณ\nพารา\nพาราฟิน\nพาล\nพาลา\nพาลี\nพาลุก\nพาโล\nพาไล\nพาส\nพาสน์\nพาสนา\nพาสุกรี\nพ่าห์\nพาหนะ\nพาหะ\nพาหา\nพาหิรกะ\nพาหิระ\nพาหุ\nพาหุรัด\nพาหุสัจจะ\nพาเหียร\nพาฬ\nพำ\nพำนัก\nพำพึม\nพำลา\nพิกล\nพิกสิต\nพิกัด\nพิกัติ\nพิกัน\nพิการ\nพิกุล\nพิเคราะห์\nพิฆน์\nพิฆเนศ\nพิฆเนศวร\nพิฆาต\nพิง\nพิจัย\nพิจาร\nพิจารณ์\nพิจารณา\nพิจิก\nพิจิต\nพิจิตร\nพิชญ์\nพิชัย\nพิชาน\nพิชิต\nพิเชฐ\nพิเชียร\nพิฑูรย์\nพิณ\nพิดทูล\nพิดาน\nพิโดร\nพิตร\nพิถี\nพิถีพิถัน\nพิทย\nพิทย์\nพิทยา\nพิทยาคม\nพิทยาคาร\nพิทยาธร\nพิทยาลัย\nพิทักษ์\nพิทูร\nพิเทศ\nพิธาน\nพิธี\nพิธุ\nพินทุ\nพินอบพิเทา\nพินัย\nพินาศ\nพินิจ\nพินิต\nพินิศ\nพินิศจัย\nพิเนต\nพิบัติ\nพิบุล\nพิบูล\nพิปริต\nพิปลาส\nพิพรรธ\nพิพรรธน์\nพิพักพิพ่วน\nพิพัฒ\nพิพัฒน์\nพิพากษ์\nพิพากษา\nพิพาท\nพิพิธ\nพิพิธภัณฑ์\nพิพิธภัณฑสถาน\nพิภพ\nพิภัช\nพิภาค\nพิภูษณะ\nพิเภก\nพิมปะการัง\nพิมพ์\nพิมพการัง\nพิมพา\nพิมพาภรณ์\nพิมล\nพิมเสน\nพิมาน\nพิมุข\nพิโมกข์\nพิโมกษ์\nพิโยกพิเกน\nพิโยค\nพิรอด\nพิระ\nพิรากล\nพิราบ\nพิราม\nพิราลัย\nพิริยะ\nพิรี้พิไร\nพิรุณ\nพิรุธ\nพิรุฬห์\nพิเรนทร์\nพิเราะ\nพิโรธ\nพิไร\nพิลังกาสา\nพิลาป\nพิลาส\nพิลิปดา\nพิลึก\nพิลึกกึกกือ\nพิลึกพิลั่น\nพิโลน\nพิไล\nพิศ\nพิศวง\nพิศวาส\nพิศาล\nพิศุทธ์\nพิศุทธิ์\nพิเศษ\nพิษ\nพิษฐาน\nพิษนาศน์\nพิสดาร\nพิสมร\nพิสมัย\nพิสัง\nพิสัช\nพิสัย\nพิสิฐ\nพิสุทธิ์\nพิสูจน์\nพิหค\nพิหาร\nพิฬาร\nพี\nพี่\nพี้\nพีชคณิต\nพีระมิด\nพึง\nพึ่ง\nพึ่บ\nพึ่บพั่บ\nพึม\nพึมพำ\nพืช\nพืด\nพื้น\nพุ\nพุก\nพุกาม\nพุง\nพุ่ง\nพุงดอ\nพุฒ\nพุฒิ\nพุด\nพุดตาน\nพุทธ\nพุทธะ\nพุทธังกูร\nพุทธางกูร\nพุทธันดร\nพุทธาภิเษก\nพุทธาวาส\nพุทธิ\nพุทโธ่\nพุทรา\nพุธ\nพุ่ม\nพุมเรียง\nพุ้ย\nพู\nพูพอน\nพู่\nพูด\nพูน\nพู้น\nพู่ระหง\nเพ\nเพ็ก\nเพกา\nเพคะ\nเพ็ง\nเพ่ง\nเพ็จ\nเพชฉลูกรรม\nเพชฌฆาต\nเพชร\nเพชรดา\nเพชรปาณี\nเพชรฤกษ์\nเพชรายุธ\nเพชรกลับ\nเพชรสังฆาต\nเพชรหลีก\nเพชรหึง\nเพ็ญ\nเพฑูริย์\nเพณี\nเพ็ดทูล\nเพดาน\nเพท\nเพทนา\nเพทาย\nเพทุบาย\nเพโทบาย\nเพ่นพ่าน\nเพนียด\nเพไนย\nเพ้ย\nเพรง\nเพรซีโอดิเมียม\nเพรา\nเพราะ\nเพริด\nเพริศ\nเพรียก\nเพรียง\nเพรียบ\nเพรี้ยม\nเพรียว\nเพรื่อ\nเพรือง\nเพล\nเพลง\nเพล็ด\nเพล้โพล้\nเพลา\nเพลาะ\nเพลิง\nเพลิดเพลิน\nเพลิน\nเพลีย\nเพลี้ย\nเพลี่ยง\nเพศ\nเพส\nเพสลาด\nเพ่อ\nเพ้อ\nเพ้อเจ้อ\nเพอิญ\nเพะ\nเพา\nเพาะ\nเพิก\nเพิง\nเพิ่ง\nเพิดเพ้ย\nเพิ่ม\nเพี้ย\nเพียง\nเพี้ยง\nเพียงออ\nเพี้ยน\nเพียบ\nเพียร\nเพื่อ\nเพื่อน\nแพ\nแพ้\nแพง\nแพ่ง\nแพงพวย\nแพทย์\nแพทยศาสตร์\nแพน\nแพ่น\nแพนก\nแพนงเชิง\nแพร\nแพร่\nแพรก\nแพร่ง\nแพรว\nแพร้ว\nแพลง\nแพลทินัม\nแพล็บ\nแพลม\nแพลเลเดียม\nแพละ\nแพละโลม\nแพว\nแพ้ว\nแพศย์\nแพศยา\nแพะ\nโพ\nโพก\nโพกพาย\nโพง\nโพงพาง\nโพชฌงค์\nโพซิตรอน\nโพด\nโพทะเล\nโพแทสเซียม\nโพธ\nโพธิ\nโพธิ์\nโพน\nโพ้น\nโพนทะนา\nโพบาย\nโพย\nโพยก๊วน\nโพยม\nโพรก\nโพรง\nโพรโทแอกทิเนียม\nโพรมีเทียม\nโพระดก\nโพล่\nโพลง\nโพล่ง\nโพล้ง\nโพลน\nโพล้เพล้\nโพละ\nโพสพ\nไพ\nไพ่\nไพจิตร\nไพชน\nไพชยนต์\nไพฑูรย์\nไพที\nไพบูลย์\nไพพรรณ\nไพร\nไพร่\nไพรจิตร\nไพรชน\nไพรชยนต์\nไพรฑูรย์\nไพรที\nไพรบูลย์\nไพรเราะ\nไพรัช\nไพรำ\nไพริน\nไพรินทร์\nไพรี\nไพเราะ\nไพโรจน์\nไพล\nไพล่\nไพศาขะ\nไพศาล\nไพเศษ\nไพสพ\nไพสิฐ\nไพหาร\nฟก\nฟ้ง\nฟรักโทส\nฟรี\nฟลูออรีน\nฟ่อ\nฟ้อ\nฟอก\nฟอง\nฟ่อง\nฟ้อง\nฟอด\nฟอน\nฟ่อน\nฟ้อน\nฟ้อแฟ้\nฟอร์มาลดีไฮด์\nฟอร์มาลิน\nฟอสฟอรัส\nฟอสเฟต\nฟัก\nฟักฟุ้น\nฟัง\nฟังก์ชัน\nฟัด\nฟัน\nฟั่น\nฟั้น\nฟ้า\nฟาก\nฟาง\nฟ่าง\nฟาด\nฟาทอม\nฟาน\nฟ่าม\nฟาย\nฟาร์ม\nฟาสซิสต์\nฟิด\nฟิต\nฟิบ\nฟิล์ม\nฟิวส์\nฟิสิกส์\nฟี่\nฟี้\nฟืดฟาด\nฟืน\nฟื้น\nฟืม\nฟุ\nฟุ้ง\nฟุต\nฟุน\nฟุบ\nฟุ่บ\nฟุ่มเฟือย\nฟุลสแก๊ป\nฟู\nฟู่\nฟูก\nฟูด\nฟูม\nเฟ็ด\nเฟ้น\nเฟลด์สปาร์\nเฟ้อ\nเฟอร์เมียม\nเฟอะ\nเฟอะฟะ\nเฟะ\nเฟะฟะ\nเฟิน\nเฟี้ยม\nเฟี้ยว\nเฟือ\nเฟื้อ\nเฟือง\nเฟื่อง\nเฟื้อง\nเฟือน\nเฟือย\nเฟื้อย\nแฟ่\nแฟง\nแฟชั่น\nแฟน\nแฟบ\nแฟ้ม\nแฟรนเซียม\nแฟลกซ์\nแฟลต\nแฟะ\nโฟกัส\nไฟ\nภควดี\nภควัต\nภควันต์\nภควัม\nภควา\nภควาน\nภคะ\nภคันทลา\nภคินี\nภณะ\nภณิดา\nภพ\nภมร\nภมริน\nภมรี\nภมุกา\nภยันตราย\nภยาคติ\nภระ\nภรณี\nภรต\nภรรดร\nภรรดา\nภรรยา\nภระมร\nภระมรี\nภราดร\nภราดรภาพ\nภราดา\nภริยา\nภฤศ\nภวะ\nภวตัณหา\nภวนะ\nภวังค์\nภวังคจิต\nภักดี\nภักตะ\nภักติ\nภักษ์\nภักษา\nภักษาหาร\nภัค\nภัคน์\nภังคะ\nภังคี\nภัจ\nภัณฑ์\nภัณฑาคาร\nภัณฑาคาริก\nภัณฑารักษ์\nภัณฑนะ\nภัณฑู\nภัต\nภัตตาคาร\nภัตตาหาร\nภัตร\nภัทระ\nภัทรกัป\nภัพ\nภัย\nภัสดา\nภัสตรา\nภัสมะ\nภัสสร\nภา\nภาค\nภาคย์\nภาคยานุวัติ\nภาคินี\nภาคิไนย\nภาคี\nภาคียะ\nภาชนะ\nภาชี\nภาณ\nภาณวาร\nภาณกะ\nภาณี\nภาณุ\nภาดร\nภาดา\nภาตระ\nภาตา\nภาตุ\nภาติกะ\nภาติยะ\nภาพ\nภาพย์\nภาม\nภาย\nภาร\nภาระ\nภารดี\nภารต\nภารตี\nภารยทรัพย์\nภารยา\nภารา\nภาวนา\nภาวะ\nภาษ\nภาษณ์\nภาษา\nภาษิต\nภาษี\nภาส\nภาสน์\nภาสวร\nภาสา\nภาสุระ\nภิกขา\nภิกขาจาร\nภิกขุ\nภิกขุนี\nภิกษา\nภิกษาจาร\nภิกษาหาร\nภิกษุ\nภิกษุณี\nภิงคาร\nภิญโญ\nภิตติ\nภินท์\nภินทนาการ\nภิยโย\nภิรมย์\nภิรมย์สุรางค์\nภิษัช\nภิสัก\nภีตะ\nภีมะ\nภีรุ\nภุกต์\nภุขัน\nภุช\nภุชงค์\nภุต\nภุมมะ\nภุมรัตน์\nภุมวาร\nภุมรา\nภุมริน\nภุมรี\nภุมเรศ\nภู\nภู่\nภูต\nภูติ\nภูม\nภูมิ\nภูมี\nภูริ\nภูรี\nภูวดล\nภูวนาถ\nภูวเนตร\nภูวไนย\nภูษา\nภูษิต\nเภกะ\nเภตรา\nเภท\nเภทุบาย\nเภรี\nเภสัช\nโภค\nโภคะ\nโภคิน\nโภคี\nโภไคย\nโภไคศวรรย์\nโภช\nโภชย์\nโภชก\nโภชนะ\nโภชนา\nโภชนาหาร\nโภชนียะ\nไภริน\nไภรี\nไภษัชคุรุ\nไภษัชย์\nมกร\nมกราคม\nมกุฎ\nมคธ\nมฆวัน\nมฆะ\nมฆา\nม่ง\nมงกุฎ\nมงโกรย\nมงคล\nมงคลวาร\nมณฑ์\nมณฑก\nมณฑนะ\nมณฑป\nมณฑล\nมณฑา\nมณฑารพ\nมณฑิระ\nมณเฑียร\nมณี\nมด\nมตะ\nมตกภัต\nมติ\nมทนะ\nมทะ\nมธุ\nมธุกร\nมธุการี\nมธุลีห์\nมธุระ\nมธุรพจน์\nมน\nมนินทรีย์\nม่น\nมนต์\nมนตร์\nมนตรี\nมนท์\nมนทิราลัย\nมนเทียร\nมนสิการ\nมนัส\nมนัสวี\nมนินทรีย์\nมนิมนา\nมนิลา\nมนุญ\nมนุษย์\nมนุษยชาติ\nมนุษยธรรม\nมนุษย์มนา\nมนุษยโลก\nมนุษยศาสตร์\nมนุษยสัมพันธ์\nมนุสาร\nมนู\nมนูสาร\nมโน\nมโนช\nมโนชญ์\nมโนราห์\nมโนสาเร่\nมโนห์รา\nมมังการ\nมยุรฉัตร\nมยุระ\nมยุรา\nมยุรี\nมยุเรศ\nมยูร\nมรกต\nมรคา\nมรฑป\nมรณ์\nมรณะ\nมรณกรรม\nมรณบัตร\nมรณภัย\nมรณภาพ\nมรดก\nมรรค\nมรรคา\nมรรตัย\nมรรยาท\nมรรษ\nมรสุม\nมริจ\nมริยาท\nมรีจิ\nมรุต\nมฤค\nมฤคย์\nมฤคศิระ\nมฤคศิรมาส\nมฤคเศียร\nมฤคินทร์\nมฤเคนทร์\nมฤดก\nมฤต\nมฤตยู\nมฤทุ\nมล\nมละ\nมลัก\nมลังเมลือง\nมล้าง\nมลาย\nมลายู\nมวก\nม่วง\nมวน\nม่วน\nม้วน\nม้วนต้วน\nมวย\nม้วย\nมวล\nมหกรรม\nมหรณพ\nมหรรณพ\nมหรสพ\nมหัจฉริยะ\nมหัต\nมหัทธนะ\nมหันต์\nมหันตโทษ\nมหัพภาค\nมหัศจรรย์\nมหา\nมหากฐิน\nมหากาฬ\nมหาขันธกะ\nมหาจักร\nมหาชน\nมหาชัย\nมหาชาติ\nมหาโชตรัต\nมหาดไทย\nมหาดเล็ก\nมหาตมะ\nมหาไถ่\nมหาเทพ\nมหาเทพี\nมหาเทวี\nมหาธาตุ\nมหานิกาย\nมหานิล\nมหาบพิตร\nมหาบัณฑิต\nมหาพน\nมหาพรหม\nมหาภารตะ\nมหาภิเนษกรมณ์\nมหาภูต\nมหาเมฆ\nมหายาน\nมหายุค\nมหาราช\nมหาฤกษ์\nมหาละลวย\nมหาละลาย\nมหาวงศ์\nมหาวรรค\nมหาวิทยาลัย\nมหาศักราช\nมหาศาล\nมหาสงกรานต์\nมหาสดมภ์\nมหาสดำ\nมหาสมุทร\nมหาสาวก\nมหาหงส์\nมหาหิงคุ์\nมหาอำนาจ\nมหาอุจ\nมหาอุด\nมหาอุปรากร\nมหาอุปราช\nมหิ\nมหิดล\nมหิธร\nมหิป\nมหิงส์\nมหิทธิ\nมหินท์\nมหิมา\nมหิศร\nมหิศวร\nมหิษ\nมหิษี\nมหึมา\nมเหยงค์\nมเหศ\nมเหศวร\nมเหศักดิ์\nมเหสักข์\nมเหสิ\nมเหสี\nมเหาฬาร\nมโหรสพ\nมโหระทึก\nมโหรี\nมโหฬาร\nมไหศวรรย์\nมอ\nมอง\nมองโกลอยด์\nมองโกเลีย\nมองคร่อ\nมอญ\nมอด\nม่อต้อ\nมอเตอร์\nมอเตอร์ไซค์\nมอน\nม่อน\nมอบ\nมอม\nมอมแมม\nม่อย\nมอร์ฟีน\nมอระกู่\nมอลโทส\nม่อลอกม่อแลก\nม่อห้อม\nม่อฮ่อม\nมะ\nมะกรูด\nมะกล่ำ\nมะกอก\nมะก่อง\nมะกะโรนี\nมะกา\nมะเกลือ\nมะเกี๋ยง\nมะข่วง\nมะขวิด\nมะขาม\nมะเขือ\nมะแข่น\nมะคังแดง\nมะค่า\nมะคำไก่\nมะคำดีควาย\nมะงั่ว\nมะงุมมะงาหรา\nมะซัก\nมะซาง\nมะดัน\nมะดีหวี\nมะดูก\nมะเดหวี\nมะเดื่อ\nมะต้อง\nมะตะบะ\nมะตาด\nมะตาหะรี\nมะตึ่ง\nมะตื๋น\nมะตูม\nมะแตก\nมะโต\nมะนาว\nมะปราง\nมะปริง\nมะฝ่อ\nมะพร้าว\nมะพลับ\nมะพูด\nมะแพน\nมะแพร้ว\nมะเฟือง\nมะแฟน\nมะไฟ\nมะม่วง\nมะม่าว\nมะมี่\nมะมื่น\nมะมุด\nมะเมอ\nมะเมีย\nมะเมื่อย\nมะแม\nมะยง\nมะยม\nมะระ\nมะริด\nมะรืน\nมะรุม\nมะรุมมะตุ้ม\nมะเร็ง\nมะเรื่อง\nมะโรง\nมะลอกมะแลก\nมะละกอ\nมะลิ\nมะลื่น\nมะลืมดำ\nมะลุลี\nมะแว้ง\nมะสัง\nมะเส็ง\nมะหวด\nมะหะหมัด\nมะหาด\nมะหิ่ง\nมะเหงก\nมะอึก\nมะฮอกกานี\nมัก\nมักกะโรนี\nมักกะลีผล\nมักกะสัน\nมักขะ\nมั่กขั้ก\nมักขิกา\nมัค\nมัคคะ\nมัคคุเทศก์\nมัคนายก\nมัฆวาน\nมั่ง\nมังกง\nมังกร\nมังกุ\nมังคละ\nมังค่า\nมังคุด\nมังตาน\nมังสวิรัติ\nมังสะ\nมังสี\nมัจจะ\nมัจจุ\nมัจฉริยะ\nมัจฉรี\nมัจฉะ\nมัจฉา\nมัชชะ\nมัชวิรัติ\nมัชชาระ\nมัชฌันติกสมัย\nมัชฌิม\nมัชฌิมา\nมัญจา\nมัญชิษฐา\nมัญชุ\nมัญชุสา\nมัญชูสา\nมัญเชฏฐะ\nมัฏฐะ\nมัณฑนศิลป์\nมัณฑนา\nมัด\nมัตตะ\nมัตตัญญู\nมัตตา\nมัตติกา\nมัตถกะ\nมัตถลุงค์\nมัตสยะ\nมัตสยา\nมัตสระ\nมัตสริน\nมัททวะ\nมัทนะ\nมัทยะ\nมัธยฐาน\nมัธยม\nมัธยันห์\nมัธยัสถ์\nมัน\nมั่น\nมันตา\nมันถะ\nมันทิระ\nมันทิราลัย\nมับ\nมั้ม\nมัมมี่\nมัย\nมัลละ\nมัลลิกา\nมัว\nมัวซัว\nมั่ว\nมัศยา\nมัสตุ\nมัสตาร์ด\nมัสมั่น\nมัสยิด\nมัสรู่\nมัสลิน\nมัสสุ\nมา\nม้า\nมาก\nมาคสิระ\nมาฆบูชา\nมาฆะ\nม้าง\nมางสะ\nมาณพ\nมาณวิกา\nมาด\nมาดา\nมาตงค์\nมาตร\nมาตรา\nมาตฤ\nมาตังคะ\nมาตา\nมาตามหัยกะ\nมาตามหัยกา\nมาตามหัยยิกา\nมาติกะ\nมาติกา\nมาตุ\nมาตุจฉา\nมาตุรงค์\nมาตุเรศ\nมาตุละ\nมาตุลา\nมาตุลานี\nมาทะ\nมาธยมิก\nมาธยมิกะ\nมาธุระ\nมาธุสร\nมาธูระ\nมาน\nม่าน\nม้าน\nมานพ\nมานะ\nมานัต\nมานัส\nมานิต\nมานี\nมานุษ\nมานุษยวิทยา\nมาโนชญ์\nมาบ\nมาภา\nม้าม\nม่าย\nมายา\nมาร\nมาราธิราช\nมารค\nมารดร\nมารดา\nมารยา\nมารยาท\nมารศรี\nมารษา\nมาริต\nมารุต\nมาลย์\nมาลัย\nมาลา\nมาลาตี\nมาลาเรีย\nมาลินี\nมาลี\nมาลุต\nมาศ\nมาส\nมาสก\nมาห์\nม่าห์\nมาหิส\nม่าเหมี่ยว\nมาฬก\nมิ\nมิค\nมิคสัญญี\nมิ่ง\nมิจฉา\nมิด\nมิตร\nมิติ\nมิเตอร์\nมิถยา\nมิถุน\nมิถุนายน\nมิทธะ\nมินตรา\nมินตา\nมินหม้อ\nมิ่ม\nมิ้ม\nมิไย\nมิรันตี\nมิลลิกรัม\nมิลลิบาร์\nมิลลิเมตร\nมิลลิลิตร\nมิลักขะ\nมิลักขู\nมิส\nมิสกรี\nมิสกวัน\nมิสซา\nมี\nมี่\nมีด\nมีเทน\nมีน\nมีนาคม\nมี่สั้ว\nมึง\nมึน\nมืด\nมืน\nมื่น\nมือ\nมื้อ\nมุ\nมุก\nมุกดา\nมุกดาหาร\nมุกุระ\nมุข\nมุขเด็จ\nมุขยประโยค\nมุโขโลกนะ\nมุคคะ\nมุง\nมุ่ง\nมุ้ง\nมุจฉา\nมุจนะ\nมุจลินท์\nมุญจนะ\nมุญชะ\nมุฐิ\nมุณฑกะ\nมุณฑะ\nมุด\nมุตกิด\nมุตฆาต\nมุตตะ\nมุตตา\nมุตติ\nมุตะ\nมุติ\nมุททา\nมุทธชะ\nมุทธา\nมุทธาภิเษก\nมุทรา\nมุทริกา\nมุทะลุ\nมุทา\nมุทิกา\nมุทิงค์\nมุทิตา\nมุทุ\nมุทุตา\nมุ่น\nมุนิ\nมุนินทร์\nมุนี\nมุบ\nมุบมิบ\nมุม\nมุ้ม\nมุ่ย\nมุรธา\nมุรธาภิเษก\nมุสละ\nมุสลิม\nมุสา\nมุสิก\nมุหงิด\nมุหน่าย\nมุหุต\nมุฮัมมัด\nมูก\nมูเซอ\nมูตร\nมู่ทู่\nมูน\nมูมมาม\nมูรติ\nมูรธา\nมูรธาภิเษก\nมูล\nมูละ\nมูลา\nมูลิกากร\nมู่ลี่\nมู่เล่\nมูสัง\nมูสิก\nมูสิกะ\nมูสิกทันต์\nเม\nเม็ก\nเมกะเฮิรตซ์\nเมขลา\nเมฆ\nเมฆา\nเมฆินทร์\nเมฆี\nเม็ง\nเม็ด\nเมตตา\nเมตไตรย\nเมตร\nเมตริก\nเมตริกตัน\nเมถุน\nเมท\nเมโท\nเมทนี\nเมทินี\nเมทนีดล\nเมทานอล\nเมทิลแอลกอฮอล์\nเมธ\nเมธา\nเมธาวี\nเมธี\nเมน\nเม่น\nเม้น\nเมนเดลีเวียม\nเมนทอล\nเม้ม\nเมรัย\nเมริเดียน\nเมรุ\nเมล์\nเมล็ด\nเมลือง\nเมษ\nเมษายน\nเมห์\nเมหนะ\nเมหะ\nเมะ\nเมา\nเม่า\nเม้า\nเมารี\nเมาลี\nเมาฬี\nเมาะ\nเมิง\nเมิน\nเมิล\nเมีย\nเมียง\nเมี่ยง\nเมี้ยน\nเมือ\nเมื้อ\nเมื่อ\nเมือก\nเมือง\nเมือบ\nเมื่อย\nแม่\nแม้\nแมก\nแมกนีเซียม\nแมง\nแมงกะพรุน\nแมงกานิน\nแมงกานีส\nแมงคา\nแมงคาเรือง\nแมงช้าง\nแมงดา\nแมงลัก\nแม่ตะงาว\nแมน\nแม่น\nแม้น\nแมลง\nแมลบ\nแมว\nแม้ว\nแมะ\nโม\nโม่\nโม้\nโมก\nโมกข์\nโมกษะ\nโมฆกรรม\nโมฆสัญญา\nโมฆะ\nโมฆียกรรม\nโมฆียะ\nโมง\nโม่ง\nโมงครุ่ม\nโมทนา\nโมโนแซ็กคาไรด์\nโมไนย\nโมเม\nโมเมนต์\nโมเย\nโมรา\nโมรี\nโมเรส\nโมลิบดีนัม\nโมลี\nโมเลกุล\nโมเสก\nโมเสส\nโม่ห์\nโมหะ\nโมหันธ์\nโมหาคติ\nโมโห\nไม่\nไม้\nไมกา\nไมครอน\nไมโครกรัม\nไมโครฟิล์ม\nไมโครโฟน\nไมโครมิเตอร์\nไมโครเมตร\nไมโครลิตร\nไมโครเวฟ\nไมตรี\nไมยราบ\nไมล์\nยก\nยกกระบัตร\nยกนะ\nยง\nยงโย่\nยชุรเวท\nยติ\nยติภังค์\nยถากรรม\nยถาภูตญาณ\nย่น\nยนต์\nยนตร์\nยม\nยมก\nยมโดย\nยมนา\nยมล\nยมะ\nยรรยง\nยล\nยวง\nยวด\nยวน\nยวบ\nย้วย\nยวรยาตร\nยศ\nยโส\nยอ\nย่อ\nยอก\nย็อกแย็ก\nยอง\nย่อง\nย้อง\nยอด\nยอน\nย้อน\nยอบ\nยอม\nย่อม\nย้อม\nย่อย\nย้อย\nย้อแย้\nยะ\nย่ะ\nยะยอบ\nยะยับ\nยัก\nยักข์\nยักขินี\nยักษ์\nยักษา\nยักษิณี\nยักษี\nยัง\nยั้ง\nยั่งยืน\nยัชโญปวีต\nยัญ\nยัญญะ\nยัด\nยัติภังค์\nยัน\nยั่น\nยันต์\nยันตร\nยันตร์\nยันตรกรรม\nยั่นตะนี\nยับ\nยั่ว\nยั้ว\nยั้วเยี้ย\nยัวรยาตร\nยัวะ\nยัษฏิ\nยา\nย่า\nยาก\nยาคุ\nยาคู\nยาง\nย่าง\nยางพารา\nยาจก\nยาจนา\nยาไฉน\nยาด\nยาดา\nยาตร\nยาตรา\nยาน\nย่าน\nย่านพาโหม\nยานมาศ\nยานุมาศ\nยานี\nยาม\nย่าม\nยามะ\nยามักการ\nยามา\nยาย\nย้าย\nยายี\nยาว\nย้าว\nยาวกาลิก\nยาวชีวิก\nยาสูบ\nย่าหยา\nยาหยี\nยำ\nย่ำ\nย้ำ\nยำเยีย\nยิก\nยิง\nยิ่ง\nยิฏฐะ\nยิน\nยิบ\nยิบหยี\nยิปซัม\nยิปซี\nยิ้ม\nยิมนาสติก\nยิหวา\nยี\nยี่\nยี้\nยี่ก่า\nยี่เก\nยี่เข่ง\nยี่โถ\nยีน\nยี่โป้\nยี่ภู่\nยีราฟ\nยี่สก\nยี่สง\nยี่สน\nยี่สาน\nยี่สุ่น\nยี่หระ\nยี่หร่า\nยี่ห้อ\nยี่หุบ\nยึกยัก\nยึกยือ\nยึด\nยืด\nยืน\nยื่น\nยืม\nยื้อ\nยุ\nยุกกระบัตร\nยุกดิ\nยุกติ\nยุกติธรรม\nยุกต์\nยุค\nยุคนธร\nยุคล\nยุคันต์\nยุคันธร\nยุคุนธร\nยุง\nยุ่ง\nยุ้ง\nยุด\nยุต\nยุติ\nยุทธ\nยุทธ์\nยุทธนา\nยุทโธปกรณ์\nยุบ\nยุ่บ\nยุ่บยั่บ\nยุบล\nยุพดี\nยุพเรศ\nยุพา\nยุพาน\nยุพาพาล\nยุพาพิน\nยุ่มย่าม\nยุ่ย\nยุ้ย\nยุรยาตร\nยูรยาตร\nยุวชน\nยุวดี\nยุวราช\nยุวา\nยุวาน\nยู\nยู่\nยูง\nยูโด\nยูถะ\nยูถิกา\nยูริก\nยูเรนัส\nยูเรเนียม\nยูโรเพียม\nเย\nเย้\nเยง\nเยซู\nเย็ด\nเย็น\nเย็นตาโฟ\nเย็นเตาโฟ\nเย็บ\nเย้ย\nเยอ\nเย่อ\nเยอรมัน\nเยอว\nเย่อหยิ่ง\nเยอะ\nเยอะแยะ\nเยา\nเย้า\nเยาว์\nเยาวชน\nเยาวมาลย์\nเยาวยอด\nเยาวราช\nเยาวเรศ\nเยาวลักษณ์\nเยาวพา\nเยาวพาณี\nเยาวพาน\nเยาะ\nเยิง\nเยิน\nเยิ่น\nเยิ่นเย้อ\nเยินยอ\nเยิบ\nเยิบยาบ\nเยิ้ม\nเยีย\nเยี่ยง\nเยี่ยงอย่าง\nเยียงผา\nเยียดยัด\nเยียน\nเยียบ\nเยี่ยม\nเยียรบับ\nเยียรยง\nเยียว\nเยี่ยว\nเยียวยา\nเยือ\nเยื่อ\nเยื้อ\nเยือก\nเยือง\nเยื่อง\nเยื้อง\nเยือน\nเยื้อน\nแย่\nแย้\nแยก\nแยง\nแย่ง\nแย้ง\nแยงแย่\nแยงแย้\nแยบ\nแย็บ\nแยม\nแย้ม\nแยแส\nแยะ\nโย\nโย้\nโยก\nโยกเยก\nโยคาพจร\nโยคาวจร\nโยคเกณฑ์\nโยคยะ\nโยคะ\nโยคิน\nโยคี\nโยง\nโย่ง\nโย่งเย่ง\nโยงโย่\nโยชน์\nโยชนา\nโยถิกะ\nโยทะกา\nโยธวาทิต\nโยธา\nโยธิน\nโยน\nโยนก\nโยนิโส\nโยนี\nโยม\nโยโส\nใย\nไย\nไย่\nไยดี\nไยไพ\nรก\nรง\nรงค์\nรงควัตถุ\nรงรอง\nรจนา\nรจเรข\nรจเลข\nรจิต\nรชตะ\nรชนิ\nรชนี\nรชะ\nรณรงค์\nรด\nรดี\nรตนะ\nรตะ\nรติ\nรถ\nรน\nร่น\nรบ\nรบาญ\nรพี\nรม\nร่ม\nรมณี\nรมณีย์\nรมณียสถาน\nรมย์\nรมเยศ\nรยางค์\nรวก\nรวง\nร่วง\nรวด\nรวน\nรวนเร\nร่วน\nรวบ\nรวม\nร่วม\nรวย\nรวิ\nรวิวาร\nรวี\nรศนา\nรส\nรสนา\nรสสุคนธ์\nรสายนเวท\nรสิก\nรหัท\nรหัส\nรโห\nรโหฐาน\nรอ\nร่อ\nรอก\nรอง\nร่อง\nร้อง\nรองเง็ง\nร่องแร่ง\nรอด\nรอน\nร่อน\nร้อน\nรอบ\nรอบคอบ\nรอม\nรอมชอม\nรอมร่อ\nรอย\nร่อย\nร้อย\nร่อแร่\nระ\nระกะ\nระกา\nระกำ\nระเกะระกะ\nระคน\nระคาง\nระคาย\nระแคะ\nระฆัง\nระงม\nระงับ\nระแง้\nระโงกหิน\nระชวย\nระดม\nระดะ\nระดับ\nระดา\nระด่าว\nระดู\nระเด่น\nระเดียง\nระแด\nระตู\nระทก\nระทด\nระทม\nระทวย\nระทา\nระทึก\nระแทะ\nระนาด\nระนาบ\nระนาม\nระนาว\nระเนน\nระเนระนาด\nระเนียด\nระแนง\nระแนะ\nระบบ\nระบม\nระบอบ\nระบัด\nระบับ\nระบาด\nระบาย\nระบำ\nระบิล\nระบือ\nระบุ\nระเบง\nระเบ็ง\nระเบิด\nระเบียง\nระเบียน\nระเบียบ\nระแบบ\nระมัดระวัง\nระมาด\nระเมียร\nระย่อ\nระย่อม\nระยะ\nระยั้ง\nระยับ\nระย้า\nระยาบ\nระยำ\nระยิบระยับ\nระโยง\nระโยงระยาง\nระรวย\nระรอง\nระร่อน\nระรัว\nระราน\nระร่าย\nระริก\nระรี่\nระรึง\nระรื่น\nระรื้น\nระเร้ง\nระเริง\nระเรียง\nระเรื่อย\nระแรง\nระลวง\nระลอก\nระลึก\nระวัง\nระวาง\nระวาย\nระวิง\nระแวง\nระแวดระวัง\nระไว\nระส่ำระสาย\nระหกระเหิน\nระหง\nระหวย\nระหว่าง\nระหองระแหง\nระหัด\nระหาย\nระเห็จ\nระเหย\nระเหระหน\nระเหหน\nระเหิด\nระเหินระหก\nระแหง\nระโหย\nระอา\nระอิดระอา\nระอุ\nรัก\nรักข์\nรักขิต\nรักตะ\nรักบี้\nรักเร่\nรักแร้\nรักษ์\nรักษา\nรัง\nรั้ง\nรังเกียจ\nรังแก\nรังค์\nรังควาน\nรังแค\nรังรอง\nรังวัด\nรังสิ\nรังสี\nรังสิมันตุ์\nรังสิมา\nรัจฉา\nรัช\nรัชชูปการ\nรัชมังคลาภิเษก\nรัชชุ\nรัชฎาภิเษก\nรัชดาภิเษก\nรัชนะ\nรัชนี\nรัญจวน\nรัฏฐาภิปาลโนบาย\nรัฐ\nรัฐประศาสโนบาย\nรัฐประศาสนศาสตร์\nรัด\nรัต\nรัตกัมพล\nรัตมณี\nรัตคน\nรัตจันทน์\nรัตตัญญู\nรัตติ\nรัตน์\nรัตนะ\nรัตนโกสินทร์\nรัตนโกสินทรศก\nรัตนชาติ\nรัตนตรัย\nรัตนบัลลังก์\nรัตนวราภรณ์\nรัตนสิงหาสน์\nรัตนา\nรัตนากร\nรัตนาภรณ์\nรัตนาวลี\nรัตมา\nรัถ\nรัถยา\nรัทเทอร์ฟอร์เดียม\nรัน\nรั้น\nรันทด\nรันทวย\nรับ\nรัมณียสถาน\nรัมภา\nรัมมี่\nรัมย์\nรัย\nรัว\nรั่ว\nรั้ว\nรัศมิมัต\nรัศมิมาน\nรัศมี\nรัษฎากร\nรัสเซีย\nรัสสะ\nรัสสระ\nรา\nร่า\nร้า\nราก\nรากษส\nรากสาด\nราคะ\nราคจริต\nราคา\nราคิน\nราคี\nราง\nร่าง\nร้าง\nรางจืด\nรางชาง\nรางวัล\nราช\nราชกิจจานุเบกษา\nราชนิกุล\nราชวโรงการ\nราชญี\nราชดัด\nราชพฤกษ์\nราชมาณพ\nราชมาษ\nราชมาส\nราชย์\nราชสีห์\nราชะ\nราชัน\nราชันย์\nราชัย\nราชา\nราชาธิปไตย\nราชาธิราช\nราชาภิเษก\nราชายตนะ\nราชาวดี\nราชี\nราชินิกุล\nราชินีกุล\nราชินี\nราชินูปถัมภ์\nราชูปถัมภ์\nราชูปโภค\nราเชน\nราเชนทร์\nราเชนทรยาน\nราโชวาท\nราไชศวรรย์\nราญ\nราญรอน\nราด\nราต\nราตร\nราตรี\nราน\nร่าน\nร้าน\nราบ\nราพณ์\nราพณาสูร\nราม\nรามเกียรติ์\nรามสูร\nรามัญ\nรามา\nราย\nร่าย\nร้าย\nราว\nร้าว\nราวี\nราศี\nราษฎร\nราษฎร์\nราษตรี\nราษราตรี\nราหุ\nราหู\nรำ\nร่ำ\nรำคาญ\nรำงับ\nรำจวน\nรำบาญ\nรำพัน\nรำพาย\nรำพึง\nรำเพย\nรำไพ\nรำมะนา\nรำมะนาด\nรำมะร่อ\nร่ำรวย\nร่ำร่ำ\nรำไร\nรำลึก\nรำหัด\nรำหัส\nริ\nริก\nริดสีดวง\nริน\nริ้น\nริบ\nริบบิ้น\nริบรี่\nริบหรี่\nริปุ\nริปู\nริม\nริ้ว\nริษยา\nรี\nรี่\nรี้พล\nรีด\nรีดักชัน\nรีต\nรีเนียม\nรีบ\nรีม\nรีรอ\nรี้ริก\nรึง\nรึ้ง\nรื่น\nรื้น\nรื้อ\nรุ\nรุก\nรุกข์\nรุกขชาติ\nรุกขเทวดา\nรุกขมูล\nรุกขา\nรุกรุย\nรุ่ง\nรุ้ง\nรุงรัง\nรุ่งริ่ง\nรุจ\nรุจา\nรุจนะ\nรุจิ\nรุจี\nรุจิระ\nรุจิรา\nรุด\nรุต\nรุทธ์\nรุทระ\nรุธิร\nรุธิระ\nรุเธียร\nรุน\nรุ่น\nรุบรู่\nรุม\nรุ่ม\nรุ่มร่าม\nรุย\nรุ่ย\nรุรุ\nรุหะ\nรู\nรู่\nรู้\nรูจี\nรูด\nรูทีเนียม\nรูบิเดียม\nรูป\nรูปิยะ\nรูปี\nรูเล็ตต์\nเร่\nเรข\nเรขา\nเรขาคณิต\nเร็ง\nเร่ง\nเร้ง\nเรณุ\nเรณู\nเรดอน\nเรดาร์\nเรเดียม\nเร้น\nเรรวน\nเรไร\nเร็ว\nเร่ว\nเรวดี\nเรอ\nเร่อ\nเรา\nเร่า\nเร้า\nเราะ\nเริง\nเริด\nเริม\nเริ่ม\nเริ้ม\nเริศร้าง\nเรี่ย\nเรี้ย\nเรียก\nเรียง\nเรียด\nเรียน\nเรียบ\nเรียม\nเรี่ยม\nเรียว\nเรี่ยว\nเรี้ยวรก\nเรือ\nเรื่อ\nเรื้อ\nเรือก\nเรือง\nเรื่อง\nเรื้อง\nเรืองรอง\nเรือด\nเรือน\nเรื้อน\nเรื่อย\nแร\nแร่\nแรก\nแร็กเกต\nแรง\nแร่ง\nแร้ง\nแรด\nแร้นแค้น\nแรม\nแร้ว\nแระ\nโร\nโร่\nโรค\nโรคา\nโรคาพาธ\nโรง\nโรจ\nโรจน์\nโรเดียม\nโรตี\nโรท\nโรธ\nโรม\nโรมัน\nโรเมอร์\nโรย\nโรเร\nโรหิณี\nโรหิต\nไร\nไร่\nไร้\nไรย์\nฤกษ์\nฤกษณะ\nฤคเวท\nฤชา\nฤชุ\nฤณ\nฤดี\nฤดียา\nฤดู\nฤต\nฤติยา\nฤตุ\nฤทธา\nฤทธิ์\nฤทัย\nฤษภ\nฤษยา\nฤษี\nฤๅ\nฤๅดี\nฤๅทัย\nฤๅษี\nฤๅสาย\nลก\nล่ก\nลฆุ\nลง\nล่ง\nลงกา\nล้งเล้ง\nลด\nลดา\nลดาวัลย์\nลน\nล้น\nลบ\nลบอง\nลพ\nลพุช\nลม\nล่ม\nล้ม\nลมาด\nลรรลุง\nลลนา\nลลิต\nลวก\nลวง\nล่วง\nล้วง\nลวณะ\nลวด\nล้วน\nลวนลาม\nลวนะ\nล่วม\nลวะ\nลวิตร\nลหุ\nลหุกาบัติ\nล่อ\nล้อ\nลอก\nล็อก\nล็อกเกต\nลอกแลก\nลอการิทึม\nลอง\nล่อง\nลองกอง\nลองจิจูด\nลองไน\nลอด\nลอตเตอรี่\nลอน\nล่อน\nลอบ\nลอม\nล้อม\nลอมชอม\nลอมพอก\nลอย\nล่อย\nล่อแล่\nลอว์เรนเซียม\nลออ\nละ\nล่ะ\nละคร\nละติจูด\nละบม\nละบอง\nละบือ\nละเบ็ง\nละโบม\nละม่อม\nละมั่ง\nละมาน\nละม้าย\nละมุ\nละมุด\nละมุน\nละเมอ\nละเมาะ\nละเมิด\nละเมียด\nละแมะ\nละโมก\nละโมบ\nละไม\nละลวย\nละลอก\nละล้า\nละล้าละลัง\nละลาน\nละลาบละล้วง\nละลาย\nละล้าว\nละล่ำละลัก\nละลิบ\nละลุม\nละเลง\nละเล้า\nละเลาะ\nละเลิง\nละเลียด\nละเลียบ\nละไล้\nละว้า\nละวาด\nละเวง\nละแวก\nละโว้\nละหมาด\nละห้อย\nละหาน\nละหาร\nละหุ่ง\nละเหย\nละเหี่ย\nละอง\nละออง\nละอาย\nละเอียด\nละแอน\nลัก\nลักขณะ\nลักขณา\nลักขะ\nลักขี\nลักจั่น\nลักปิดลักเปิด\nลักษณ์\nลักษณนาม\nลักษณะ\nลักษณาการ\nลักษมณ์\nลักษมาณา\nลักษมี\nลักษะ\nลัคคะ\nลัคน์\nลัคนา\nลัง\nลั่ง\nลังกา\nลังคี\nลังถึง\nลังลอง\nลังเล\nลังสาด\nลัชชา\nลัชชี\nลัญจ์\nลัญจกร\nลัญฉกร\nลัญฉน์\nลัฐิ\nลัฐิกา\nลัด\nลัดา\nลัทธ์\nลัทธิ\nลัน\nลั่น\nลันเต\nลันเตา\nลันไต\nลั่นทม\nลันโทม\nลับ\nลัพธ์\nลัพธิ\nลัภ\nลัภนะ\nลัภย์\nลัมพ์\nลัย\nลา\nล่า\nล้า\nลาก\nลาง\nล่าง\nล้าง\nลางลิง\nลางสาด\nลาช\nลาชะ\nลาชา\nลาญ\nลาด\nลาดเลา\nล้าต้า\nล่าเตียง\nลาน\nล่าน\nล้าน\nลาบ\nลาพอน\nลาภ\nลาม\nล่าม\nลามก\nลาย\nล้าย\nลายสือ\nลาลา\nลาว\nลาวัณย์\nลาวา\nลำ\nล่ำ\nล้ำ\nลำเข็ญ\nลำแข\nลำเค็ญ\nลำเจียก\nลำดวน\nลำดับ\nลำเนา\nลำบอง\nลำบาก\nลำปำ\nลำพวน\nลำพอง\nลำพัง\nลำพู\nลำเพ็ญ\nลำเพา\nลำแพน\nลำโพง\nลำไพ่\nลำภุขัน\nลำมะลอก\nลำยอง\nลำไย\nลำลอง\nล่ำลา\nลำลาบ\nลำลึก\nลำเลาะ\nลำเลิก\nลำเลียง\nลำเวียง\nลำเอียก\nลำเอียง\nลิ\nลิกขา\nลิกไนต์\nลิกู\nลิเก\nลิขนะ\nลิขสิทธิ์\nลิขิต\nลิง\nลิงค์\nลิด\nลิต\nลิตมัส\nลิตร\nลิเทียม\nลิ่น\nลิ้น\nลินจง\nลิ้นจี่\nลินลา\nลินสีด\nลิ่นฮื้อ\nลินิน\nลิบ\nลิปดา\nลิปสติก\nลิปิ\nลิฟต์\nลิเภา\nลิ่ม\nลิ้ม\nลิมป์\nลิมปนะ\nลิลิต\nลิว\nลิ่ว\nลิสง\nลี\nลี่\nลี้\nลีซอ\nลีบ\nลีลา\nลีลาศ\nลีฬหา\nลึก\nลึงค์\nลืด\nลื่น\nลื้น\nลืบ\nลืม\nลือ\nลื่อ\nลื้อ\nลุ\nลุก\nลุง\nลุ้ง\nลุ่น\nลุ้น\nลุพธ์\nลุ่ม\nลุมพี\nลุมพู\nลุย\nลุ่ย\nลุ้ย\nลู่\nลูก\nลูกระมาศ\nลูกเอ็น\nลูขะ\nลูทีเชียม\nลูบ\nเลก\nเล็ก\nเลข\nเลขา\nเลขาธิการ\nเลขานุการ\nเล็ง\nเล้ง\nเล่งฮื้อ\nเลเซอร์\nเลฑฑุ\nเลณฑุ\nเลณะ\nเล็ด\nเลน\nเล็น\nเล่น\nเลนส์\nเล็บ\nเลบง\nเลปกร\nเลปน์\nเลเป\nเลเพ\nเล็ม\nเล่ม\nเลย\nเลว\nเลวง\nเลวูโลส\nเลศ\nเลษฏุ\nเล่ห์\nเล่ห์กระเท่ห์\nเลหลัง\nเลหะ\nเลอ\nเล่อ\nเลอะ\nเลอะเทอะ\nเละ\nเละเทะ\nเลา\nเล่า\nเล้า\nเลากัย\nเล้าโลม\nเลาะ\nเลิก\nเลิ่กลั่ก\nเลิง\nเลิ้ง\nเลินเล่อ\nเลิศ\nเลีย\nเลียง\nเลี่ยง\nเลี้ยง\nเลียงผา\nเลียงฝ้าย\nเลียงมัน\nเลียน\nเลี่ยน\nเลียนไฟ\nเลียบ\nเลี่ยม\nเลียว\nเลี้ยว\nเลือก\nเลือง\nเลื่อง\nเลือด\nเลือน\nเลื่อน\nเลื่อม\nเลื่อย\nเลื้อย\nเลื่อยล้า\nแล\nแล่\nแล้\nแลก\nแล็กเกอร์\nแล็กโทส\nแลง\nแล่ง\nแล้ง\nแลน\nแล่น\nแลนทานัม\nแลบ\nแล้ว\nและ\nโล่\nโล้\nโลก\nโลกเชษฐ์\nโลกธรรม\nโลกธาตุ\nโลกนาถ\nโลกบาล\nโลกย์\nโลกัย\nโลกวัชชะ\nโลกวิทู\nโลกัตถจริยา\nโลกันตร์\nโลกา\nโลกาธิบดี\nโลกาธิปไตย\nโลกานุวัตร\nโลกาภิวัตน์\nโลกามิส\nโลกายัต\nโลกาวินาศ\nโลกิยะ\nโลกีย์\nโลกียวัตร\nโลกียวิสัย\nโลกียสุข\nโลกุตระ\nโลกุตรธรรม\nโลกุตรภูมิ\nโลง\nโล่ง\nโล้ง\nโล่งโจ้ง\nโล่งโต้ง\nโล้งโต้ง\nโลจนะ\nโลณะ\nโลด\nโล่ติ๊น\nโลโต\nโลท\nโลน\nโล้น\nโลภ\nโลม\nโลมเล้า\nโลมะ\nโลมา\nโลลุป\nโลเล\nโลโล\nโลโล้\nโลหะ\nโลหกุมภี\nโลหัช\nโลหิต\nไล่\nไล้\nไลย\nไลลา\nไล่เลี่ย\nฦๅ\nฦๅชา\nฦๅสาย\nวก\nวง\nวงก์\nวงกต\nวงศ์\nวงศกร\nวงศา\nวงษ์\nวจนะ\nวจี\nวชิระ\nวชิรปาณี\nวชิรหัตถ์\nวชิราวุธ\nวฏะ\nวฏาการ\nวณิช\nวณิชชา\nวณิชย์\nวณิชยา\nวณิพก\nวดี\nวทนะ\nวทัญญุตา\nวทัญญู\nวธุกา\nวธู\nวน\nวนศาสตร์\nวนสณฑ์\nวนสัณฑ์\nวนอุทยาน\nวนัส\nวนัสบดี\nวนา\nวนาดร\nวนาดอน\nวนานต์\nวนาลัย\nวนาลี\nวนาวาส\nวนาศรม\nวนาสณฑ์\nวนาสัณฑ์\nวนิดา\nวนิพก\nวเนจร\nวโนทยาน\nวยัคฆ์\nวยากรณ์\nวรดนู\nวรทาน\nวรมหาวิหาร\nวรงค์\nวรณะ\nวรรค\nวรรคย์\nวรรช\nวรรชย์\nวรรณะ\nวรรณกรรม\nวรรณคดี\nวรรณยุกต์\nวรรณยุต\nวรรณศิลป์\nวรรณนา\nวรรณพฤติ\nวรรณึก\nวรรธกะ\nวรรธนะ\nวรรษ\nวรรษา\nวรวิหาร\nวรัญญู\nวรางคณา\nวรางคนา\nวราห์\nวราหะ\nวรุณ\nวโรดม\nวฤก\nวลัช\nวลัญช์\nวลัญชน์\nวลัย\nวลาหก\nวลี\nวศค\nวศะ\nวศิน\nวสนะ\nวสภะ\nวสละ\nวสวัดดี\nวสวัตตี\nวสะ\nวสันต์\nวสันตดิลก\nวสันตฤดู\nวสันตวิษุวัต\nวสา\nวสี\nวสุ\nวสุธา\nวสุนธรา\nวสุมดี\nวหะ\nวอ\nวอก\nวอกแวก\nว่องไว\nวอด\nวอน\nว่อน\nว็อบ\nวอมแวม\nวอลเลย์บอล\nวอแว\nวะ\nวัก\nวักกะ\nวัคคีย์\nวัคคุ\nวัคซีน\nวัง\nวังก์\nวังชา\nวังเวง\nวังศะ\nวังสะ\nวัจจะ\nวัจกุฎี\nวัจฉละ\nวัจน์\nวัช\nวัชชะ\nวัชพืช\nวัชฌ์\nวัชระ\nวัชรปาณี\nวัชรยาน\nวัชรอาสน์\nวัชราสน์\nวัชรินทร์\nวัชรี\nวัชเรนทร์\nวัฏ\nวัฏฏะ\nวัฏจักร\nวัฏทุกข์\nวัฏสงสาร\nวัฏกะ\nวัฏฏิ\nวัฒกะ\nวัฒกี\nวัฒนธรรม\nวัฒนะ\nวัฒนา\nวัณ\nวัณโรค\nวัณฏ์\nวัณณะ\nวัณนา\nวัด\nวัต\nวัตต์\nวัตตา\nวัตถ์\nวัตถาภรณ์\nวัตถาลังการ\nวัตถุ\nวัตนะ\nวัตร\nวัตสดร\nวัตสะ\nวัติ\nวัทน์\nวัน\nวันต์\nวันทนา\nวันทนาการ\nวันทนีย์\nวันทยหัตถ์\nวันทยาวุธ\nวันทา\nวันทิ\nวับ\nวับวาบ\nวับวาม\nวับแวบ\nวับแวม\nวัปปะ\nวัมมิกะ\nวัย\nวัลก์\nวัลคุ\nวัลย์\nวัลลภ\nวัลลี\nวัว\nวัสสะ\nวัสโสทก\nวัสดุ\nวัสตร์\nวัสน์\nวัสนะ\nวัสสานะ\nวัสสานฤดู\nวา\nว่า\nว้า\nว้าเหว่\nวาก\nว้าก\nวากยสัมพันธ์\nวากยะ\nวาง\nว่าง\nว้าง\nวาจก\nวาจา\nวาจาไปยะ\nวาจาล\nวาชเปยะ\nวาณิช\nวาณิชกะ\nวาณิชย์\nวาณี\nวาด\nวาต\nวาตะ\nวาตภัย\nวาท\nวาทศาสตร์\nวาทศิลป์\nวาทกะ\nวาทนะ\nวาทย์\nวาทยกร\nวาทิต\nวาทิน\nวาที\nวาน\nวานซืน\nว่าน\nวานร\nวานรินทร์\nวาเนเดียม\nวาบ\nวาปี\nวาม\nวามน\nวามนาวตาร\nวามะ\nวาย\nว่าย\nว้าย\nวายะ\nวาโย\nวายามะ\nวายุ\nวายุกูล\nวาร\nวาระ\nวารสาร\nวารสารศาสตร์\nวาริ\nวารี\nวาริช\nวารีช\nวาริท\nวาริธร\nวารุณ\nวารุณี\nวาล\nวาลวีชนี\nวาล์ว\nวาลิกา\nวาลุกา\nวาว\nว่าว\nว้าว่อน\nว้าวุ่น\nวาสนะ\nวาสนา\nวาสพ\nวาสะ\nวาสิน\nวาสี\nวาสุกรี\nวาสุกี\nวาสุเทพ\nวาหนะ\nวาหะ\nวาหินี\nวาฬ\nวิกขัมภ์\nวิกขัมภนะ\nวิกเขป\nวิกรม\nวิกรัย\nวิกรานต์\nวิกฤต\nวิกฤติ\nวิกล\nวิกสิต\nวิกัต\nวิกัติ\nวิกัติการก\nวิกัป\nวิกัย\nวิการ\nวิกาล\nวิกาลโภชน์\nวิคหะ\nวิเคราะห์\nวิฆเนศ\nวิฆเนศวร\nวิฆาต\nวิง\nวิ่ง\nวิ่งเปี้ยว\nวิงวอน\nวิจฉิกะ\nวิจล\nวิจักขณ์\nวิจักษ์\nวิจักษณ์\nวิจัย\nวิจาร\nวิจารณ์\nวิจารณญาณ\nวิจิ\nวิจิกิจฉา\nวิจิต\nวิจิตร\nวิจิน\nวิจุณ\nวิจุรณ\nวิชชา\nวิชชุ\nวิชชุดา\nวิชชุตา\nวิชชุลดา\nวิชญะ\nวิชน\nวิชนี\nวิชย\nวิชัย\nวิชา\nวิชานนะ\nวิชิต\nวิเชียร\nวิญญัตติ\nวิญญาณ\nวิญญาณกทรัพย์\nวิญญู\nวิฑูรย์\nวิด\nวิตก\nวิตถาร\nวิตามิน\nวิถี\nวิทธะ\nวิทยฐานะ\nวิทยา\nวิทยาคม\nวิทยาคาร\nวิทยาลัย\nวิทยุ\nวิทยุต\nวิทวัส\nวิทัตถิ\nวิทัศน์\nวิทารณ์\nวิทิต\nวิทู\nวิทูร\nวิเทศ\nวิเทโศบาย\nวิธ\nวิธวา\nวิธาน\nวิธี\nวิธุระ\nวิธู\nวิธูปนะ\nวิ่น\nวินตกะ\nวินัย\nวินาที\nวินายก\nวินาศ\nวินิจ\nวินิจฉัย\nวินิต\nวินิบาต\nวินิปาติก\nวิเนต\nวิบัติ\nวิบาก\nวิบุล\nวิบุลย์\nวิบูล\nวิบูลย์\nวิปการ\nวิปฏิสาร\nวิปโยค\nวิประโยค\nวิปริต\nวิปลาส\nวิปวาส\nวิปักษ์\nวิปัสสก\nวิปัสสนา\nวิปัสสนายานิก\nวิพากษ์\nวิพิธทัศนา\nวิพุธ\nวิภว\nวิภวตัณหา\nวิภังค์\nวิภัช\nวิภัตติ\nวิภา\nวิภาค\nวิภาช\nวิภาดา\nวิภาวี\nวิภาษ\nวิภาส\nวิภู\nวิภูษณะ\nวิภูษา\nวิภูษิต\nวิมน\nวิมล\nวิมลัก\nวิมังสา\nวิมัติ\nวิมาน\nวิมุข\nวิมุต\nวิมุตติ\nวิเมลือง\nวิโมกข์\nวิโยค\nวิระ\nวิรงรอง\nวิรังรอง\nวิรัช\nวิรัต\nวิรัติ\nวิราคะ\nวิราม\nวิริยภาพ\nวิริยะ\nวิรุธ\nวิรุฬห์\nวิรุฬหก\nวิรูป\nวิรูปักษ์\nวิเรนทร์\nวิโรจ\nวิโรจน์\nวิโรฒ\nวิโรธ\nวิลันดา\nวิลัย\nวิลาด\nวิลาศ\nวิลาป\nวิลาวัณย์\nวิลาส\nวิลาสินี\nวิลิปดา\nวิลิศมาหรา\nวิเลป\nวิเลปนะ\nวิโลกนะ\nวิโลม\nวิไล\nวิไลวรรณ\nวิวรณ์\nวิวรรธน์\nวิวัฏ\nวิวัฒน์\nวิวัฒนาการ\nวิวัน\nวิวาท\nวิวาห์\nวิวาหมงคล\nวิวาหะ\nวิวิต\nวิวิธ\nวิเวก\nวิศรุต\nวิศว\nวิศวกร\nวิศวกรรม\nวิศวกรรมศาสตร์\nวิศัลย์\nวิศาขบูชา\nวิศาขา\nวิศาล\nวิศิษฏ์\nวิศุทธ์\nวิศุทธิ์\nวิเศษ\nวิเศษณ์\nวิษณุ\nวิษณุกรรม\nวิษธร\nวิษัย\nวิษาณ\nวิษุวัต\nวิสกี้\nวิสรรชนีย์\nวิสฤต\nวิสสุกรรม\nวิสัชนา\nวิสัญญี\nวิสัย\nวิสัยทัศน์\nวิสาขบูชา\nวิสาขะ\nวิสาขา\nวิสามัญ\nวิสามานยนาม\nวิสาร\nวิสารทะ\nวิสาล\nวิสาสะ\nวิสาหกิจ\nวิสิฐ\nวิสุงคามสีมา\nวิสุทธ์\nวิสุทธิ์\nวิสูตร\nวิเสท\nวิหค\nวิหลั่น\nวิหาร\nวิหิงสา\nวิเหสา\nวิฬาร\nวิฬาร์\nวี\nวีจิ\nวีชนี\nวีณา\nวี้ด\nวีรกรรม\nวีรชน\nวีรบุรุษ\nวีรสตรี\nวี่วัน\nวี่แวว\nวีสะ\nวุ้ง\nวุฐิ\nวุฒ\nวุฒิ\nวุด\nวุ่น\nวุ้น\nวุบ\nวุ้ย\nวุลแฟรม\nวู้\nวูดวาด\nวูบ\nวู่วาม\nเว้\nเวค\nเวคิน\nเวคี\nเวจ\nเวช\nเวชยันต์\nเวฐน์\nเวณิ\nเวณิก\nเวณุ\nเวตน์\nเวตร\nเวตาล\nเวท\nเวทคู\nเวทนา\nเวทย์\nเวทัลละ\nเวทางค์\nเวทางคศาสตร์\nเวทานต์\nเวทานตะ\nเวทิ\nเวที\nเวธะ\nเวน\nเว้น\nเวนไตย\nเวไนย\nเวมัต\nเว้ย\nเวยยากรณะ\nเวร\nเวรมณี\nเวรี\nเวโรจน์\nเวลา\nเวเลนซี\nเวศม์\nเวศย์\nเวศยา\nเวสน์\nเวสภู\nเวสม์\nเวสวัณ\nเวสสะ\nเวสสันดร\nเวสสุกรรม\nเวสสุวัณ\nเวสารัช\nเวสิยา\nเวหน\nเวหะ\nเวหา\nเวหาส\nเวฬุ\nเวฬุริยะ\nเว่อ\nเว้า\nเวิก\nเวิ้ง\nเวี่ย\nเวียง\nเวียด\nเวียดนาม\nเวียน\nเวียร\nเวี่ยว\nแว้\nแวง\nแว้ง\nแวด\nแว้ด\nแวน\nแว่น\nแวนดา\nแวบ\nแว็บ\nแวม\nแว็ม\nแวว\nแว่ว\nแวะ\nโว\nโว่\nโวการ\nโว่ง\nโวทาน\nโวย\nโว้ย\nโว้เว้\nโวหาร\nไว\nไว้\nไวกูณฐ์\nไวฑูรย์\nไวทย์\nไวน์\nไวพจน์\nไวยากรณ์\nไวยาวัจกร\nไวยาวัจมัย\nไวรัส\nไววรรณ\nไวษณพ\nไวโอลิน\nศก\nศกุน\nศกุนต์\nศกุนิ\nศกุนี\nศจี\nศตะ\nศตภิษัช\nศตวรรษ\nศตพรรษ\nศตกะ\nศนิ\nศพ\nศมนะ\nศมะ\nศยาม\nศยามล\nศร\nศรายุธ\nศราวรณ์\nศรรกรา\nศรวณะ\nศรวณีย์\nศรวิษฐา\nศรัณย์\nศรัณยู\nศรัท\nศรัทธา\nศรัย\nศราทธ์\nศราทธพรต\nศราพก\nศราวก\nศราวณะ\nศรี\nศรีตรัง\nศรุติ\nศฤคาล\nศฤงค์\nศฤงคาร\nศฤงคาริน\nศฤงคารี\nศลิษฏ์\nศลิษา\nศวะ\nศวัส\nศวา\nศวาน\nศศะ\nศศธร\nศศพินทุ์\nศศลักษณ์\nศศิ\nศศิน\nศศี\nศศิขัณฑ์\nศศิธร\nศศิมณฑล\nศศิวิมล\nศอ\nศอก\nศักดา\nศักดิ\nศักดิ์\nศักดินา\nศักติ\nศักย\nศักยภาพ\nศักย์\nศักยะ\nศักร\nศักรินทร์\nศักเรนทร์\nศักราช\nศังกร\nศัตรู\nศันสนะ\nศันสนีย์\nศัพท์\nศัยยา\nศัล\nศัลย์\nศัลยกรรม\nศัลยแพทย์\nศัลยศาสตร์\nศัสดร\nศัสตร\nศัสตรศาสตร์\nศัสตรา\nศัสตราวุธ\nศากตะ\nศากย\nศากยะ\nศากยพุทธ\nศากยมุนี\nศาฎก\nศาณ\nศานต์\nศานติ\nศาป\nศารท\nศารทูล\nศาริกา\nศาล\nศาลา\nศาศวัต\nศาสดา\nศาสตร์\nศาสตรา\nศาสตราจารย์\nศาสนา\nศาสนกิจ\nศาสนจักร\nศาสนธรรม\nศาสนบุคคล\nศาสนพิธี\nศาสนวัตถุ\nศาสนศาสตร์\nศาสนสถาน\nศาสนสมบัติ\nศาสนิกชน\nศาสนีย์\nศาสนูปถัมภก\nศาสน์\nศิกษก\nศิการ\nศิขร\nศิขริน\nศิขรี\nศิขัณฑ์\nศิคาล\nศิงขร\nศิงขริน\nศิตะ\nศิถี\nศิพิระ\nศิระ\nศิรประภา\nศิราภรณ์\nศิโรรัตน์\nศิโรเวฐน์\nศิรา\nศิรามพุช\nศิโรราบ\nศิลป\nศิลป์\nศิลปะ\nศิลปกร\nศิลปกรรม\nศิลปกิจ\nศิลปวัตถุ\nศิลปวิทยา\nศิลปศาสตร์\nศิลปศึกษา\nศิลปหัตถกรรม\nศิลปิน\nศิลปี\nศิลา\nศิวะ\nศิวโมกข์\nศิวลึงค์\nศิวเวท\nศิวาลัย\nศิศีระ\nศิษฎิ\nศิษฏ์\nศิษย์\nศิษยานุศิษย์\nศีขร\nศีต\nศีตกาล\nศีรษะ\nศีล\nศึก\nศึกษา\nศึกษาธิการ\nศึกษานิเทศก์\nศุกร์\nศุกรวรรณ\nศุกรวาร\nศุกระ\nศุกล\nศุกลปักษ์\nศุจิ\nศุทธะ\nศุทธิ\nศุนะ\nศุนิ\nศุภกร\nศุภเคราะห์\nศุภนิมิต\nศุภมัสดุ\nศุภมาตรา\nศุภมาส\nศุภอักษร\nศุภางค์\nศูกร\nศุลกากร\nศุลการักษ์\nศุลี\nศุษิร\nศูทร\nศูนย์\nศูนยวาท\nศูละ\nศูลิน\nเศรณี\nเศรษฐ\nเศรษฐ์\nเศรษฐกิจ\nเศรษฐศาสตร์\nเศรษฐี\nเศร้า\nเศลษ\nเศวต\nเศวตร\nเศวตัมพร\nเศษ\nเศาจ\nเศาร์\nเศารยะ\nเศิก\nเศียร\nโศก\nโศกา\nโศกาดูร\nโศกาลัย\nโศกี\nโศจิ\nโศธนะ\nโศภน\nโศภะ\nโศภา\nโศภิต\nโศภิน\nโศภิษฐ์\nโศภี\nโศรดา\nโศรตร\nโศลก\nไศล\nไศวะ\nษมา\nษัฏ\nษัฑ\nษัณ\nษัษ\nษัษฐะ\nษัษฐี\nโษฑศัน\nสก\nสกวาที\nสกฏะ\nสกทาคามิผล\nสกิทาคามิผล\nสกทาคามิมรรค\nสกิทาคามิมรรค\nสกทาคามี\nสกิทาคามี\nสกนธ์\nสกปรก\nสกรณีย์\nสกรรจ์\nสกรรมกริยา\nสกล\nสกลมหาสังฆปริณายก\nสกัด\nสกา\nสกาว\nสกี\nสกุณ\nสกุณา\nสกุณี\nสกุน\nสกุนต์\nสกุล\nสเกต\nสแกนเดียม\nสขะ\nสง\nส่ง\nสงกร\nสงกรานต์\nสงกา\nสงค์\nสงคร\nสงคราม\nสงเคราะห์\nสงฆ์\nสงบ\nสงวน\nส่งสการ\nสงสัย\nสงสาร\nสงสารวัฏ\nสงัด\nสง่า\nสฐะ\nสณฑ์\nสด\nสดมภ์\nสดับ\nสดับปกรณ์\nสดำ\nสดุดี\nสตะ\nสตน\nสตภิสชะ\nสตรอนเชียม\nสตริกนิน\nสตรี\nสตัฟฟ์\nสตัมภ์\nสตางค์\nสติ\nสติปัฏฐาน\nสตี\nสตู\nสตูป\nสเต๊ก\nสถบดี\nสถล\nสถวีระ\nสถาน\nสถานะ\nสถานี\nสถาบัน\nสถาปนา\nสถาปนิก\nสถาปัตยกรรม\nสถาปัตยกรรมศาสตร์\nสถาปัตยเรขา\nสถาปัตยเวท\nสถาพร\nสถาวร\nสถิต\nสถิตยศาสตร์\nสถิติ\nสถิร\nสถีรวาท\nสถุล\nสถูป\nสทิง\nสทึง\nสทุม\nสธนะ\nสาธุสะ\nสน\nส้น\nสนทนา\nสนทรรศ\nสนทรรศน์\nสนเทศ\nสนเท่ห์\nสนธยา\nสนธิ\nสนน\nสนม\nสนวน\nสนอง\nสนอบ\nสนอม\nสนะ\nสนัด\nสนั่น\nสนับ\nสนับทึบ\nสนับสนุน\nสนาน\nสนาม\nสนายุ\nสนิกะ\nสนิท\nสนิธ\nสนิม\nสนุก\nสนุกเกอร์\nสนุข\nสนุต\nสนุ่น\nสบ\nสบง\nสบถ\nสบัน\nสบาย\nสบู่\nสไบ\nสปริง\nสปอร์\nสปาเกตตี\nสเปกตรัม\nสเปกโทรสโกป\nสไปริลลัม\nสพาบ\nสภา\nสภาพ\nสภาวการณ์\nสภาวะ\nสม\nสมการ\nสมจารี\nสมดุล\nสมมูล\nส้ม\nสมญา\nสมณะ\nสมณบริขาร\nสมณศักดิ์\nสมณสารูป\nสมเด็จ\nสมถะ\nสมถยานิก\nสมถวิปัสสนา\nสมนาคุณ\nสมบัติ\nสมบุกสมบัน\nสมบูรณ์\nสมบูรณาญาสิทธิราชย์\nสมประดี\nสมปฤดี\nสมปฤๅดี\nส้มป่อย\nสมปัก\nสมผุส\nสมพง\nสมพงศ์\nสมพล\nสมพัตสร\nสมพาส\nสมเพช\nสมโพธน์\nสมโพธิ\nสมภพ\nสมภาร\nสมโภค\nสมโภช\nสมมต\nสมมติ\nสมมุติ\nสมมาตร\nส้มมือ\nสมโมท\nสมโยค\nสมร\nสมรด\nสมรรถ\nสมรรถนะ\nสมรรถภาพ\nสมรส\nสมฤดี\nสมฤติ\nสมวายะ\nสมเสร็จ\nสมอ\nสมอง\nสมะ\nสมัคร\nสมังคี\nสมัช\nสมัชชา\nสมัญญา\nสมัต\nสมัน\nสมันต์\nสมัย\nสมา\nสมาคม\nสมาจาร\nสมาชิก\nสมาทาน\nสมาธิ\nสมาน\nสมานฉันท์\nสมาบัติ\nสมาพันธรัฐ\nสมาส\nสม่ำเสมอ\nสมิง\nสมิต\nสมิติ\nสมิทธ์\nสมิทธิ\nสมี\nสมุก\nสมุจจัย\nสมุจเฉท\nสมุฏฐาน\nสมุด\nสมุทร\nสมุทรโคดม\nสมุทัย\nสมุน\nสมุนไพร\nสมุลแว้ง\nสมุห\nสมุห์\nสมุหกลาโหม\nสมุหเทศาภิบาล\nสมุหนาม\nสมุหนายก\nสโมธาน\nสโมสร\nสยด\nสยนะ\nสยบ\nสยมพร\nสยมภู\nสยอง\nสยอน\nสยัมวรา\nสยาม\nสยามานุสติ\nสยามินทร์\nสยาย\nสยิว\nสยิ้ว\nสยุมพร\nสยุมภู\nสร\nสรง\nสร่ง\nสรณะ\nสรณคมน์\nสรณาคมน์\nสรณตรัย\nสรตะ\nสรทะ\nสรนุก\nสรเนาะ\nสรไน\nสรเพชญ\nสรภะ\nสรภัญญะ\nสรภู\nสรม\nสรร\nสรรค์\nสรรพ\nสรรพคุณ\nสรรพนาม\nสรรพสามิต\nสรรพัชญ\nสรรพากร\nสรรพางค์\nสรรเพชญ\nสรรเพชุดา\nสรรเสริญ\nสรลอน\nสรเลข\nสรวง\nสรวม\nสรวล\nสรเสริญ\nสร้อย\nสระ\nสระกอ\nสระท้อน\nสระพรั่ง\nสระอาด\nสรั่ง\nสรัสวดี\nสร่าง\nสร้าง\nสราญ\nสรี้\nสรีระ\nสรีรกิจ\nสรีรธาตุ\nสรีรวิทยา\nสรีรศาสตร์\nสรีรังคาร\nสรีรางคาร\nสรุป\nสโรช\nสโรชะ\nสฤก\nสฤต\nสฤษฎิ\nสฤษฎี\nสฤษฏ์\nสฤษดิ์\nสลด\nสลบ\nสลวน\nสลวย\nสลอด\nสลอน\nสลอย\nสละ\nสลัก\nสลัด\nสลัดได\nสลับ\nสลัว\nสลา\nสลาก\nสลาง\nสล้าง\nสลาด\nสลาตัน\nสลาบ\nสลาย\nสลิด\nสลิล\nสลึก\nสลึง\nสลุต\nสลุบ\nสลุมพร\nสแลง\nสวการย์\nสวภาพ\nสวราชย์\nสวก\nส้วง\nสวด\nสวน\nสวนะ\nสวนาการ\nส่วน\nสวนิต\nสวบ\nสวม\nส้วม\nสวย\nส่วย\nส้วย\nสวยม\nสวรรค\nสวรรค์\nสวรรคต\nสวรรคาลัย\nสวรรยา\nสวระ\nสวะ\nสวัสดิ\nสวัสดิ์\nสวัสดิการ\nสวัสดิภาพ\nสวัสดิมงคล\nสวัสดี\nสวัสติ\nสวาตี\nสวัสติกะ\nสวา\nสวาปาม\nสวาคตะ\nสวาง\nสว่าง\nสวาด\nสวาดิ\nสวาท\nสว่าน\nสว้าน\nสวาบ\nสวามิ\nสวามี\nสวามินี\nสวาย\nสวาสดิ์\nสวาหะ\nสวิง\nสวิญญาณกทรัพย์\nสวิตช์\nสสาร\nสสุระ\nสสุรี\nสหกรณ์\nสหการ\nสหจร\nสหชาต\nสหชาติ\nสหธรรม\nสหธรรมิก\nสหประชาชาติ\nสหพันธ์\nสหพันธรัฐ\nสหภาพ\nสหศึกษา\nสหัช\nสหัมบดี\nสหัส\nสหัสสะ\nสหัสธารา\nสหัสนัยน์\nสหัสเนตร\nสหัสรังสี\nสหัสา\nสหาย\nสอ\nส่อ\nสอง\nส่อง\nส้อง\nสอด\nสอน\nส่อน\nสอบ\nสอพลอ\nส้อม\nสอย\nสะ\nสะกด\nสะกอ\nสะกาง\nสะการะ\nสะกิด\nสะกิดสะเกา\nสะเก็ด\nสะแก\nสะคร้อ\nสะคราญ\nสะค้าน\nสะเงาะสะแงะ\nสะดม\nสะดวก\nสะดิ้ง\nสะดึง\nสะดือ\nสะดุ้ง\nสะดุด\nสะเด็ด\nสะเดา\nสะเดาะ\nสะตอ\nสะตาหมัน\nสะตึ\nสะตือ\nสะตุ\nสะเต๊ะ\nสะโตก\nสะทก\nสะท้อน\nสะท้าน\nสะทึก\nสะเทิน\nสะเทิ้น\nสะเทือน\nสะเทื้อน\nสะบะ\nสะบัก\nสะบักสะบอม\nสะบัด\nสะบัดสะบิ้ง\nสะบั้น\nสะบันงา\nสะบ้า\nสะบู\nสะแบง\nสะเปะสะปะ\nสะพรั่ง\nสะพรึงกลัว\nสะพรึบ\nสะพรึ่บ\nสะพัก\nสะพัง\nสะพัด\nสะพั้น\nสะพาน\nสะพาย\nสะเพร่า\nสะโพก\nสะเภา\nสะใภ้\nสะโมง\nสะระตะ\nสะระแหน่\nสะลาง\nสะลาบ\nสะลึมสะลือ\nสะวี้ดสะว้าด\nสะสม\nสะสวย\nสะสาง\nสะเหล่อ\nสะอาง\nสะอาด\nสะอ้าน\nสะอิ้ง\nสะอิดสะเอียน\nสะอึก\nสะอื้น\nสะเอ้ง\nสะเอว\nสะเออะ\nสะโอดสะอง\nสะไอ\nสัก\nสักกะ\nสักยะ\nสักกัจจะ\nสักกายทิฐิ\nสักการ\nสักการะ\nสักขี\nสักวา\nสักหลาด\nสัค\nสัคคะ\nสั่ง\nสังกร\nสังกรณี\nสังกรประโยค\nสังกะตัง\nสังกะวัง\nสังกะวาด\nสังกะสี\nสังกัด\nสังกัปปะ\nสังกา\nสังการ\nสังกาศ\nสังกิเลส\nสังเกต\nสังข์\nสังขกร\nสังขตธรรม\nสังขตะ\nสังขยา\nสังขลิก\nสังขลิกา\nสังขาร\nสังขารา\nสังเขป\nสังค์\nสังคญาติ\nสังคม\nสังคหะ\nสังคัง\nสังคายนา\nสังคายนาย\nสังคีต\nสังคีติ\nสังเค็ด\nสังเคราะห์\nสังฆกรรม\nสังฆการี\nสังฆเถระ\nสังฆทาน\nสังฆนายก\nสังฆปาโมกข์\nสังฆภัต\nสังฆเภท\nสังฆมณฑล\nสังฆมนตรี\nสังฆราช\nสังฆสภา\nสังฆาณัติ\nสังฆาฏิ\nสังฆาทิเสส\nสังฆาธิการ\nสังฆานุสติ\nสังฆาวาส\nสังยุตนิกาย\nสังโยค\nสังโยชน์\nสังวร\nสังวัจฉระ\nสังวัธยาย\nสังวาล\nสังวาส\nสังเวคะ\nสังเวช\nสังเวชนียสถาน\nสังเวย\nสังเวียน\nสังสกฤต\nสังสการ\nสังสนทนา\nสั่งสนทนา\nสังสรรค์\nสังสารวัฏ\nสังสิทธิ\nสังสุทธ์\nสังสุทธิ\nสังหร\nสังหรณ์\nสังหาร\nสังหาริมทรัพย์\nสังหาริมะ\nสังหิต\nสัจ\nสัจกิริยา\nสัจจะ\nสัจญาณ\nสัจธรรม\nสัจนิยม\nสัจพจน์\nสัชฌะ\nสัชฌุ\nสัญจร\nสัญเจตนา\nสัญชาตญาณ\nสัญชาติ\nสัญฌา\nสัญญา\nสัญญาณ\nสัญญี\nสัญโญชน์\nสัญนิยม\nสัญประกาศ\nสัญลักษณ์\nสัฐิ\nสัณฐาน\nสัณฐิติ\nสัณฑ์\nสัณห์\nสัด\nสัดจอง\nสัต\nสัตตะ\nสัตตาหกรณียะ\nสัตตาหกาลิก\nสัตมวาร\nสัตสดก\nสัตตบงกช\nสัตตบรรณ\nสัตตบุษย์\nสัตตู\nสัตถันดร\nสัตถา\nสัตถิ\nสัตถุ\nสัตถุศาสนา\nสัตบรรณ\nสัตย์\nสัตยพรต\nสัตยวาที\nสัตยาเคราะห์\nสัตยาธิษฐาน\nสัตยาบัน\nสัตว์\nสัตวชาติ\nสัตวบาล\nสัตวแพทย์\nสัตววิทยา\nสัตวา\nสัทธรรม\nสัทธา\nสัทธาจริต\nสัทธาธิกะ\nสัทธินทรีย์\nสัทธิงวิหาริก\nสัทธิวิหาริก\nสัทวิทยา\nสัทศาสตร์\nสัทอักษร\nสัน\nสั่น\nสั้น\nสันดาน\nสันดาป\nสันโดษ\nสันต์\nสันตติ\nสันตะปาปา\nสันตะวา\nสันติ\nสันตุฏฐี\nสันถวไมตรี\nสันถวะ\nสันถัต\nสันถาร\nสันทนะ\nสันทะ\nสันทัด\nสันทัสนะ\nสันทาน\nสันทิฐิก\nสันทิส\nสันเทหะ\nสันธาน\nสันนิธิ\nสันนิบาต\nสันนิวาส\nสันนิษฐาน\nสันสกฤต\nสับ\nสับปลับ\nสับปลี้\nสับปะรด\nสัปคับ\nสัปดาห์\nสัปดาหะ\nสัปดน\nสัปตศก\nสัปทน\nสัปปะ\nสัปปิ\nสัปปุริส\nสัปปุรุษ\nสัประยุทธ์\nสัปหงก\nสัปเหร่อ\nสัพ\nสัพพะ\nสัพพัญญู\nสัพเพเหระ\nสัพยอก\nสัมบูรณ์\nสัมปชัญญะ\nสัมปทา\nสัมปทาน\nสัมปยุต\nสัมปโยค\nสัมประสิทธิ์\nสัมประหาร\nสัมปรายภพ\nสัมปรายิกภพ\nสัมปัตติ\nสัมผัปลาป\nสัมผัปลาปะ\nสัมผัส\nสัมพล\nสัมพหุลา\nสัมพัจฉรฉินท์\nสัมพัตสร\nสัมพัทธ์\nสัมพันธ์\nสัมพันธน์\nสัมพันธภาพ\nสัมพันธมิตร\nสัมพันธไมตรี\nสัมพาหะ\nสัมพุทธ\nสัมพุทธะ\nสัมโพธิ\nสัมภวะ\nสัมภเวสี\nสัมภัต\nสัมภัตตะ\nสัมภาระ\nสัมภาษณ์\nสัมโภคกาย\nสัมมนา\nสัมมัปธาน\nสัมมา\nสัมโมทนียกถา\nสัมฤทธิ\nสัมฤทธิ์\nสัมฤทธิศก\nสัยน์\nสัลเลข\nสัสดี\nสัสตทิฐิ\nสัสสะ\nสัสสุ\nสัสสู\nสา\nส่า\nสาก\nสากรรจ์\nสากล\nสากัจฉา\nสากัลย์\nสากิยะ\nสาเก\nสาขา\nสาคร\nสาคเรศ\nสาคู\nสาง\nส้าง\nสาชล\nสาฎก\nสาฏิก\nสาณี\nสาด\nสาไถย\nสาทร\nสาทิส\nสาทุ\nสาโท\nสาธก\nสาธยะ\nสาธยาย\nสาธารณะ\nสาธารณชน\nสาธารณประโยชน์\nสาธารณภัย\nสาธารณรัฐ\nสาธารณสถาน\nสาธารณสมบัติ\nสาธารณสุข\nสาธารณูปการ\nสาธารณูปโภค\nสาธารณ์\nสาธิต\nสาธุ\nสาน\nส่าน\nสานุ\nสานู\nสานุศิษย์\nสาบ\nสาบสูญ\nสาบาน\nสาป\nสาปไตย\nสาม\nสามชุก\nสามเณร\nสามเณรี\nสามนต์\nสามนตราช\nสามยทรัพย์\nสามล\nสามหาว\nสามะ\nสามัคคี\nสามัญ\nสามัตถิยะ\nสามานย์\nสามานยนาม\nสามารถ\nสามิต\nสามินี\nสามิภักดิ์\nสามี\nสามีจิกรรม\nสาย\nส่าย\nส้าย\nสายชู\nสายัณห์\nสายาห์\nสาร\nสารคดี\nสารธรรม\nสารนิเทศ\nสารบบ\nสารบรรณ\nสารบัญ\nสารบาญ\nสารบาญชี\nสารประโยชน์\nสารสนเทศ\nสารทุกข์\nสารถี\nสารท\nสารพัด\nสารพัน\nสารพางค์\nสารภาพ\nสารภี\nสารวัตร\nสาระ\nสาระแน\nสาระพา\nสาระยำ\nสาระวารี\nสาระสะมา\nสารัตถประโยชน์\nสารัตถศึกษา\nสารัตถะ\nสารัทธ์\nสารัมภ์\nสาราณียกร\nสาราณียธรรม\nสาราณียะ\nสารานุกรม\nสารีริกธาตุ\nสารูป\nสาโรช\nสาละ\nสาละวน\nสาลิ\nสาลิกา\nสาลินี\nสาลี\nสาลี่\nสาลู\nสาโลหิต\nสาว\nสาวก\nสาวิกา\nสาวิตร\nสาวิตรี\nสาสน\nสาสน์\nสาส์น\nสาสนา\nสาสม\nสาหร่าย\nสาหรี\nส่าหรี\nสาหัส\nสาเหตุ\nสาแหรก\nสำ\nสำส่อน\nส่ำ\nสำคัญ\nสำซ่าง\nสำแดง\nสำทับ\nสำนวน\nสำนอง\nสำนัก\nสำนาน\nสำนึก\nสำนึง\nสำเนา\nสำเนียง\nสำบัด\nสำปะลอ\nสำปะหลัง\nสำปั้น\nสำปันนี\nสำเภา\nสำมะงา\nสำมะโน\nสำมะลอ\nสำมะเลเทเมา\nสำมะหา\nสำรด\nสำรวจ\nสำรวม\nสำรวย\nสำรวล\nสำรอก\nสำรอง\nสำรับ\nสำราก\nสำราญ\nสำริด\nสำเร็จ\nสำเรา\nสำเริง\nสำโรง\nสำลัก\nสำลาน\nสำลี\nสำแลง\nสำหรวด\nสำหรับ\nสำหา\nสำเหนียก\nสำเหร่\nสำออย\nสำอาง\nสิ\nสิกข์\nสิข\nสิกขมานา\nสิกขา\nสิขร\nสิขรี\nสิขเรศ\nสิขา\nสิขานล\nสิขี\nสิคาล\nสิง\nสิ่ง\nสิงขร\nสิงค์\nสิงคลิ้ง\nสิงคลี\nสิงคาร\nสิงคาล\nสิงคี\nสิงโต\nสิงห์\nสิงหนาท\nสิงหบัญชร\nสิงหรา\nสิงหราช\nสิงหาคม\nสิงหาสน์\nสิงหล\nสิญจน์\nสิตะ\nสิตางศุ์\nสิถิล\nสิทธ์\nสิทธัตถะ\nสิทธา\nสิทธาจารย์\nสิทธารถ\nสิทธิ\nสิทธิ์\nสิทธิการิยะ\nสิธยะ\nสิน\nสิ้น\nสินเทา\nสินธพ\nสินธุ\nสินธุ์\nสินธุระ\nสินธู\nสินเธาว์\nสินาด\nสินิทธ์\nสินี\nสิเนรุ\nสิเนหก\nสิเนหะ\nสิเนหา\nสิเน่หา\nสิบ\nสิปปะ\nสิมพลี\nสิระ\nสิโรดม\nสิโรตม์\nสิริ\nสิรี\nสิลา\nสิว\nสิ่ว\nสิวะ\nสิวาลัย\nสิวิกา\nสี\nสี่\nสี้\nสีกา\nสีกุน\nสีข้าง\nสีด\nสีดอ\nสีดา\nสีตลรัศมี\nสีตโลทก\nสีโตทก\nสีทันดร\nสีมันต์\nสีมา\nสีละมัน\nสีวิกา\nสีสอ\nสีสะ\nสีสา\nสีสุก\nสีเสียด\nสีห์\nสีหนาท\nสีหบัญชร\nสีหราช\nสีหไสยา\nสีหไสยาสน์\nสีหะ\nสึก\nสึง\nสืบ\nสื่อ\nสุ\nสุก\nสุกข์\nสุกร\nสุกรม\nสุกำศพ\nสุกียากี้\nสุข\nสุขา\nสุขาภิบาล\nสุขารมณ์\nสุขาวดี\nสุขิน\nสุขี\nสุขุม\nสุขุมาล\nสุโข\nสุคต\nสุคติ\nสุคนธ\nสุคนธ์\nสุคนธชาติ\nสุคนธรส\nสุคันธ์\nสุคันธรส\nสุงกะ\nสุงกากร\nสุงสิง\nสุงสุมาร\nสุจริต\nสุจหนี่\nสุจิ\nสุจิต\nสุจิตร\nสุชน\nสุชัมบดี\nสุชา\nสุชาดา\nสุญ\nสุญญากาศ\nสุญตา\nสุญนิยม\nสุณ\nสุณิสา\nสุด\nสุดา\nสุต\nสุตตนิบาต\nสุตตะ\nสุตตันตปิฎก\nสุตตันตะ\nสุติ\nสุทธ\nสุทธ์\nสุทธาวาส\nสุทธิ\nสุทรรศน์\nสุทัศน์\nสุธา\nสุธาโภชน์\nสุธารส\nสุธาสินี\nสุธาสี\nสุธี\nสุนทร\nสุนทรี\nสุนทรียภาพ\nสุนทรียศาสตร์\nสุนทรียะ\nสุนัข\nสุนันท์\nสุโนก\nสุบดี\nสุบรรณ\nสุบิน\nสุปรีดิ์\nสุปรีย์\nสุปาณี\nสุพพัต\nสุพรรณ\nสุพรรณบัฏ\nสุพรรณภาชน์\nสุพรรณราช\nสุพรรณศรี\nสุพรรณถัน\nสุพรรณิการ์\nสุภร\nสุภัค\nสุภา\nสุภาพ\nสุภาษิต\nสุม\nสุ่ม\nสุมทุม\nสุมน\nสุมนะ\nสุมนัส\nสุมนา\nสุ้มเสียง\nสุมะ\nสุมาลี\nสุเมธ\nสุเมรุ\nสุรคต\nสุรเชษฐ์\nสุรบดี\nสุรภาพ\nสุรโลก\nสุรสีหนาท\nสุรเสียง\nสุรงค์\nสุรังค์\nสุรภี\nสุรัติ\nสุรัสวดี\nสุรา\nสุรางค์จำเรียง\nสุรางคนา\nสุรางคนางค์\nสุรารักษ์\nสุราลัย\nสุรินทร์\nสุรินทราหู\nสุริยะ\nสุริยกันต์\nสุริยกานต์\nสุริยการ\nสุริยกาล\nสุริยคติ\nสุริยคราส\nสุริยมณฑล\nสุริยวงศ์\nสุริยง\nสุริยา\nสุริเยนทร์\nสุริเยศ\nสุริโย\nสุริยน\nสุริยัน\nสุริยุปราคา\nสุรีย์\nสุรุ่ยสุร่าย\nสุลต่าน\nสุวคนธ์\nสุวภาพ\nสุวรรณ\nสุวรรณภูมิ\nสุวะ\nสุวาน\nสุวินัย\nสุวิมล\nสุษิระ\nสุสาน\nสุหนัต\nสุหร่ง\nสุหร่าย\nสุหฤท\nสุหัท\nสุเหร่า\nสู\nสู่\nสู้\nสูง\nสูจิ\nสูจิบัตร\nสูญ\nสูด\nสูต\nสูตร\nสูติ\nสูติกรรม\nสูตินรีเวช\nสูติบัตร\nสูติแพทย์\nสูติศาสตร์\nสูท\nสูทกรรม\nสูทศาสตร์\nสูบ\nสูปะ\nสูร\nสูรย์\nสูรยกานต์\nสูริ\nสูสี\nเส\nเสก\nเสกขบุคคล\nเสกขะ\nเสขบุคคล\nเสขะ\nเส็ง\nเส้ง\nเส็งเคร็ง\nเสงี่ยม\nเสฏฐี\nเสณี\nเสด\nเสด็จ\nเสตุ\nเสถียร\nเสทะ\nเสโท\nเสน\nเส้น\nเสนง\nเสน่ง\nเสน่ห์\nเสนหา\nเสน่หา\nเสนอ\nเสนะ\nเสนา\nเสนาธิการ\nเสนาบดี\nเสน่า\nเสนากุฎ\nเสนางค์\nเสนางคนิกร\nเสนานี\nเสนาสนะ\nเสนาะ\nเสนี\nเสนีย์\nเสนียะ\nเสนียด\nเสบย\nเสบียง\nเสพ\nเสพย์\nเสเพล\nเสภา\nเสม็ด\nเสมหะ\nเสมอ\nเสมา\nเสมียน\nเสมือน\nเสย\nเสร็จ\nเสริด\nเสริม\nเสรี\nเสลด\nเสลบรรพต\nเสลา\nเสลี่ยง\nเสลือกสลน\nเสโล\nเสวก\nเสวกามาตย์\nเสวนะ\nเสวนา\nเสวย\nเสวียน\nเสสรวง\nเสสรวล\nเสา\nเส้า\nเสาร์\nเสารภย์\nเสารี\nเสาวคนธ์\nเสาวธาร\nเสาวภา\nเสาวภาคย์\nเสาวภาพ\nเสาวรภย์\nเสาวรส\nเสาวลักษณ์\nเสาวณิต\nเสาวนะ\nเสาวนา\nเสาวนีย์\nเสาหฤท\nเสาะ\nเสาะแสะ\nเสิร์จ\nเสิร์ฟ\nเสีย\nเสียง\nเสี่ยง\nเสียด\nเสี้ยน\nเสียบ\nเสียม\nเสี่ยม\nเสี้ยม\nเสียว\nเสี่ยว\nเสี้ยว\nเสือ\nเสื่อ\nเสื้อ\nเสือก\nเสื่อม\nแส\nแส่\nแส้\nแสก\nแสง\nแสด\nแสดง\nแสตมป์\nแสน\nแสนย์\nแสนยากร\nแสนยานุภาพ\nแสบ\nแสม\nแสยก\nแสยง\nแสยะ\nแสรก\nแสร้ง\nแสลง\nแสล้ม\nแสวง\nแสะ\nโสก\nโสกโดก\nโสกันต์\nโสโครก\nโสณฑ์\nโสณิ\nโสณี\nโสด\nโสดก\nโสดม\nโสดา\nโสดาบัน\nโสดาปัตติผล\nโสดาปัตติมรรค\nโสต\nโสตทัศนวัสดุ\nโสตทัศนอุปกรณ์\nโสตทัศนูปกรณ์\nโสตินทรีย์\nโสตถิ\nโสทก\nโสทร\nโสธก\nโสธนะ\nโสน\nโสภณ\nโสภา\nโสภี\nโสภิณี\nโสเภณี\nโสม\nโสมนัส\nโสมม\nโสมย์\nโสร่ง\nโสรจ\nโสรวาร\nโสโร\nโสวรรณ\nโสหุ้ย\nโสฬส\nใส\nใส่\nไส\nไส้\nไสย\nไสยา\nไสยาสน์\nไสร้\nไสว\nหก\nหกคะเมน\nหง\nหงก\nหงส์\nหงสบาท\nหงสรถ\nหงอ\nหงอก\nหง่อง\nหงองแหงง\nหงอด\nหงอน\nหง่อม\nหงอย\nหง่อย\nหงัก\nหงับ\nหง่าง\nหงาย\nหง่าว\nหงำ\nหงิก\nหงิง\nหงิม\nหงึก\nหงุงหงิง\nหงุดหงิด\nหงุบ\nหงุ่ย\nหญ้า\nหญ้าฝรั่น\nหญ้ายายเภา\nหญิง\nหญิบ\nหด\nหตะ\nหทัย\nหน\nหนวก\nหน่วง\nหนวด\nหน่วย\nหน่วยกิต\nหนอ\nหน่อ\nหนอก\nหนอง\nหนอน\nหนอนตายหยาก\nหน่อย\nหน็อยแน่\nหนัก\nหนัง\nหนังสติ๊ก\nหนังสือ\nหนั่น\nหนับ\nหนา\nหน้า\nหน่าง\nหนาด\nหนาน\nหนาม\nหน่าย\nหนาว\nหนำ\nหนำเลี้ยบ\nหนี\nหนี้\nหนีบ\nหนึก\nหนึ่ง\nหนึบ\nหนืด\nหนุ\nหนุน\nหนุบ\nหนุ่ม\nหนุ่ย\nหนู\nห่ม\nหมก\nหมด\nหม่น\nหมวก\nหมวด\nหมวน\nหมอ\nหม่อ\nหม้อ\nหมอก\nหมอง\nหม่อง\nหมอน\nหม่อน\nหมอบ\nหม่อม\nหมอย\nหม้อห้อม\nหมัก\nหมักหมม\nหมัด\nหมัน\nหมั่น\nหมั้น\nหมับ\nหมา\nหม่า\nหมาก\nหมากฮอส\nหมาง\nหมาด\nหมามุ่ย\nหมามุ้ย\nหมาย\nหม้าย\nหมาร่า\nหม่ำ\nหม้ำ\nหมิ่น\nหมี\nหมี่\nหมึก\nหมืน\nหมื่น\nหมุด\nหมุน\nหมุบ\nหมุบหมับ\nหมุบหมิบ\nหมุ่ย\nหมุยขาว\nหมู\nหมู่\nหมูหริ่ง\nหยก\nหย่ง\nหยด\nหยวก\nหยวบ\nหยอก\nหยอกเอิน\nหย็อกหย็อย\nหยอง\nหย็อง\nหย่อง\nหย็องกรอด\nหย็องแหย็ง\nหยอด\nหยอน\nหย่อน\nหย่อม\nหย็อมแหย็ม\nหย็อย\nหย่อย\nหยัก\nหยักไย่\nหยักเหยา\nหยัง\nหยั่ง\nหยังหยัง\nหยัด\nหยัน\nหยับ\nหยั่วเมือง\nหย่า\nหยากเยื่อ\nหยากไย่\nหยาด\nหยาบ\nหยาม\nหยาว\nหย้าว\nหยำเป\nหยำเหยอะ\nหยำแหยะ\nหยิก\nหยิ่ง\nหยิบ\nหยิม\nหยี\nหยี่\nหยุกหยิก\nหยุด\nหยุ่น\nหยุบ\nหยุมหยิม\nหยูกยา\nหโยดม\nหรคุณ\nหรณะ\nหรดาล\nหรดี\nหรรษ์\nหรรษา\nหรอ\nหรอก\nหร็อมแหร็ม\nหรอย\nหระ\nหรับ\nหรา\nหริ\nหริ่ง\nหริณะ\nหริต\nหริตกี\nหรีตกี\nหรี่\nหรีด\nหรือ\nหรุบ\nหรุบรู่\nหรุบหรู่\nหรุ่ม\nหรู\nหรูหรา\nหฤทัย\nหฤทย์\nหฤษฎ์\nหฤษฎี\nหฤหรรษ์\nหฤโหด\nหลง\nหลงใหล\nหลงจู๊\nหลด\nหลน\nหล่น\nหลบ\nหล่ม\nหลวง\nหลวม\nหลอ\nหล่อ\nหลอก\nหลอด\nหลอน\nหล็อน\nหล่อน\nหลอม\nหละ\nหละหลวม\nหลัก\nหลัง\nหลั่ง\nหลัด\nหลั่น\nหลับ\nหลัว\nหลา\nหล้า\nหลาก\nหลาน\nหลาบ\nหลาม\nหลาย\nหลาว\nหลิ่ง\nหลิท\nหลิน\nหลิม\nหลิว\nหลิ่ว\nหลี\nหลีก\nหลีโก\nหลีบ\nหลีฮื้อ\nหลืบ\nหลุกหลิก\nหลุด\nหลุน\nหลุบ\nหลุม\nหลุมพอ\nหลุมพี\nหลู่\nหวง\nห่วง\nห้วง\nหวด\nหวน\nห้วน\nหวย\nห้วย\nหวอ\nหวอด\nหวะ\nหวัง\nหวัด\nหวั่น\nหวันยิหวา\nหวัว\nหวัวร่อ\nหวัวเราะ\nหวา\nหว่า\nหว้า\nหวาก\nหว่าง\nหวาด\nหวาน\nหว่าน\nหวาม\nหวาย\nหวำ\nหวิด\nหวิว\nหวี\nหวี่\nหวีด\nหวือ\nหวุดหวิด\nหวูด\nหอ\nห่อ\nห้อ\nหอก\nหอง\nห้อง\nหอน\nห่อน\nหอบ\nหอม\nห้อม\nหอย\nห้อย\nหะ\nหะยี\nหะหาย\nหัก\nหัจญ์\nหัจญี\nหัช\nหัฏฐะ\nหัด\nหัต\nหัตถ์\nหัตถกรรม\nหัตถการ\nหัตถกิจ\nหัตถบาส\nหัตถพันธ์\nหัตถาภรณ์\nหัตถศาสตร์\nหัตถศิลป์\nหัตถศึกษา\nหัตถาจารย์\nหัตถินี\nหัตถี\nหัน\nหั่น\nหั้น\nหันตรา\nหับ\nหัย\nหัว\nหัวร่อ\nหัวเราะ\nหัส\nหัสดิน\nหัสดี\nหัสต์\nหัสตะ\nหา\nห่า\nห้า\nหาก\nหาง\nห่าง\nห้าง\nหาญ\nหาด\nห่าน\nหาบ\nหาม\nห่าม\nห้าม\nหาย\nหายใจ\nหายนะ\nหาร\nหารือ\nหาว\nห้าว\nหาสะ\nหำ\nห้ำ\nหิ้ง\nหิงคุ\nหิงสา\nหิงห้อย\nหิ่งห้อย\nหิ่งหาย\nหิด\nหิต\nหิตานุหิตประโยชน์\nหิน\nหิมพาน\nหิมพานต์\nหิมวัต\nหิมวันต์\nหิมวา\nหิมะ\nหิมาลัย\nหิรัญ\nหิรัญญิการ์\nหิรัญบัฏ\nหิรัณย์\nหิรัณยรัศมี\nหิริ\nหิว\nหิ้ว\nหี\nหีด\nหีนยาน\nหีบ\nหึ\nหึง\nหึ่ง\nหึงสา\nหืด\nหืน\nหื่น\nหือ\nหื้อ\nหุง\nหุน\nหุ่น\nหุ้น\nหุนหัน\nหุบ\nหุ้ม\nหุยฮา\nหู\nหู่\nหูก\nหูด\nเห\nเห่\nเหง\nเหง่ง\nเหงา\nเหง้า\nเหงื่อ\nเหงือก\nเห็จ\nเห็ด\nเหติ\nเหตุ\nเห็น\nเหน่ง\nเหนงนายพราน\nเหน็ดเหนื่อย\nเหน็บ\nเหน่อ\nเห็นอ้ม\nเหนอะ\nเหนอะหนะ\nเหน้า\nเหนาะ\nเหนียง\nเหนี่ยง\nเหนี่ยน\nเหนียม\nเหนียว\nเหนี่ยว\nเหนือ\nเหนื่อย\nเห็บ\nเหม\nเหม่\nเหม็ง\nเหม่ง\nเหม็น\nเหมวดี\nเหม่อ\nเหมันต์\nเหมันตฤดู\nเหมา\nเหมายัน\nเหมาะ\nเหมียว\nเหมี่ยว\nเหมือง\nเหมือด\nเหมือน\nเหมื่อย\nเหย\nเหยง\nเหย่อย\nเหยา\nเหย่า\nเหย้า\nเหยาะ\nเหยาะแหยะ\nเหยิง\nเหยิบ\nเหยียด\nเหยียบ\nเหยี่ยว\nเหยื่อ\nเหยือก\nเหรอ\nเหรอะ\nเหรัญญิก\nเหรา\nเหราะ\nเหรียญ\nเหล่\nเหล็ก\nเหลน\nเหลว\nเหลอ\nเหลา\nเหล่า\nเหล้า\nเหลาะแหละ\nเหลิง\nเหลิงเจิ้ง\nเหลียน\nเหลี่ยม\nเหลียว\nเหลือ\nเหลือก\nเหลือง\nเหลือบ\nเหลือม\nเหลื่อม\nเหว\nเหว่\nเหวง\nเหวย\nเหวอะ\nเหวอะหวะ\nเหวี่ยง\nเห่อ\nเหอะ\nเหะ\nเหะหะ\nเหา\nเห่า\nเหาะ\nเหิน\nเหิม\nเหี้ย\nเหียง\nเหียน\nเหี้ยน\nเหี้ยม\nเหี่ยว\nเหื่อ\nเหือด\nแห\nแห่\nแห้\nแหก\nแหง\nแหง่\nแห่ง\nแห้ง\nแหงแก๋\nแหง่ง\nแหงน\nแหน\nแห้น\nแหนง\nแหนบ\nแหนม\nแหบ\nแหม\nแหม่\nแหม่ม\nแหมะ\nแหย\nแหย่\nแหยง\nแหย่ง\nแหยม\nแหย็ม\nแหยะ\nแหล่\nแหลก\nแหล่ง\nแหลน\nแหลม\nแหละ\nแหว\nแห้ว\nแหวก\nแหว่ง\nแหวด\nแหวน\nแหวะ\nแหะ\nโห่\nโหง\nโหด\nโหน\nโหนก\nโหน่ง\nโหม\nโหม่ง\nโหมด\nโหย\nโหยกเหยก\nโหยง\nโหย่ง\nโหร\nโหรง\nโหรงเหรง\nโหรดาจารย์\nโหระพา\nโหรา\nโหราจารย์\nโหราศาสตร์\nโหล\nโหล่\nโหลงโจ้ง\nโหว\nโหว่\nโหว้\nโหวกเหวก\nโหวง\nโหวด\nโหวต\nให้\nใหญ่\nใหม่\nไห\nไห่\nไห้\nไหน\nไหม\nไหม้\nไหรณย์\nไหล\nไหล่\nไหว\nไหว้\nไหหลำ\nอก\nอกตเวทิตา\nอกตเวที\nอกตัญญุตา\nอกตัญญู\nอกนิษฐ์\nอกรณีย์\nอกรรมกริยา\nอกัปปิยวัตถุ\nอกัปปิยะ\nอกุศล\nอคติ\nอคาธ\nอโฆษะ\nองก์\nองค์\nองคชาต\nองคมนตรี\nองครักษ์\nองคาพยพ\nองคุลี\nองศ์\nองศา\nองอาจ\nองุ่น\nอจลา\nอจินตา\nอจินไตย\nอจิระ\nอเจลก\nอเจละ\nอชะ\nอชิน\nอชินี\nอชิระ\nอฏวี\nอณิ\nอณู\nอโณทัย\nอด\nอดิถี\nอดิเทพ\nอดิเรก\nอดิศร\nอดิศวร\nอดิศัย\nอดีต\nอดุล\nอดุลย์\nอติ\nอติชาต\nอติมานะ\nอติราช\nอติเรก\nอติสาร\nอถรรพเวท\nอาถรรพเวท\nอทระ\nอทินนาทาน\nอธรรม\nอธิ\nอธิกมาส\nอธิกรณ์\nอธิกวาร\nอธิกสุรทิน\nอธิการ\nอธิคม\nอธิฏฐาน\nอธิบดี\nอธิบาย\nอธิป\nอธิปไตย\nอธิมาตร\nอธิมุตติ\nอธิโมกข์\nอธิราช\nอธิวาส\nอธิวาสนะ\nอธิศีล\nอธิษฐาน\nอธึก\nอ้น\nอนงค์\nอนงคณะ\nอนงคเลขา\nอนธการ\nอนนต์\nอนยะ\nอนรรฆ\nอนรรถ\nอนล\nอนวัช\nอนัญ\nอนัตตา\nอนันต์\nอนันตริยกรรม\nอนัม\nอนาคต\nอนาคามิผล\nอนาคามิมรรค\nอนาคามี\nอนาจาร\nอนาถ\nอนาถา\nอนาทร\nอนาธิปไตย\nอนามัย\nอนามิกา\nอนารยชน\nอนารยธรรม\nอนารยะ\nอนาลัย\nอนำ\nอนิจ\nอนิจจัง\nอนิจจา\nอนิฏฐารมณ์\nอนิยต\nอนิยม\nอนิล\nอนิวรรต\nอนิวรรตน์\nอนีกะ\nอนีจะ\nอนึก\nอนึ่ง\nอนุ\nอนุกร\nอนุกรม\nอนุกรรมการ\nอนุกระเบียด\nอนุกาชาด\nอนุการ\nอนุกูล\nอนุคามิก\nอนุเคราะห์\nอนุจร\nอนุช\nอนุชน\nอนุชา\nอนุชาต\nอนุชิต\nอนุญาต\nอนุญาโตตุลาการ\nอนุตร\nอนุเถระ\nอนุทิน\nอนุบท\nอนุบาล\nอนุประโยค\nอนุปริญญา\nอนุปสัมบัน\nอนุปัสนา\nอนุพงศ์\nอนุพัทธ์\nอนุพันธ์\nอนุโพธ\nอนุภรรยา\nอนุภริยา\nอนุภาค\nอนุภาษ\nอนุมัติ\nอนุมาตรา\nอนุมาน\nอนุมูล\nอนุโมทนา\nอนุโยค\nอนุรักษ์\nอนุรักษนิยม\nอนุราช\nอนุราธ\nอนุราธะ\nอนุราธา\nอนุรูป\nอนุโลม\nอนุวงศ์\nอนุวรรตน์\nอนุวัต\nอนุวัตน์\nอนุวัตร\nอนุวัติ\nอนุวาต\nอนุศาสก\nอนุศาสน์\nอนุศาสนาจารย์\nอนุศิษฏ์\nอนุสติ\nอนุสนธิ\nอนุสร\nอนุสรณ์\nอนุสัญญา\nอนุสัย\nอนุสาวรีย์\nอนุสาสนี\nอเนก\nอเนกคุณ\nอเนกรรถประโยค\nอเนจอนาถ\nอโนชา\nอโนดาต\nอบ\nอบเชย\nอบาย\nอปจายนธรรม\nอปจายนมัย\nอปมงคล\nอปยศ\nอประไมย\nอปรัณณชาติ\nอปรา\nอปราชัย\nอปราชิต\nอปริมาณ\nอปลักษณ์\nอปโลกน์\nอปวาท\nอเปหิ\nอพพะ\nอพยพ\nอภัพ\nอภัย\nอภิ\nอภิฆาต\nอภิชฌา\nอภิชน\nอภิชนาธิปไตย\nอภิชัย\nอภิชาต\nอภิชิต\nอภิญญา\nอภิญญาณ\nอภิธรรม\nอภิธาน\nอภิไธย\nอภินันท์\nอภินันทนาการ\nอภินัย\nอภินิหาร\nอภิเนษกรมณ์\nอภิบาล\nอภิปรัชญา\nอภิปราย\nอภิมหาอำนาจ\nอภิมานะ\nอภิมุข\nอภิรดี\nอภิรติ\nอภิรมย์\nอภิรักษ์\nอภิราม\nอภิรุต\nอภิรุม\nอภิรูป\nอภิลักขิต\nอภิลักขิตสมัย\nอภิเลปน์\nอภิวันท์\nอภิวาท\nอภิวาทน์\nอภิเษก\nอภิสมโพธิ\nอภิสมัย\nอภิสมาจาร\nอภิสัมโพธิ\nอภิสัมโพธิญาณ\nอภิสิต\nอภิสิทธิ์\nอภูตะ\nอม\nอมพะนำ\nอ้ม\nอมตธรรม\nอมตบท\nอมตะ\nอมนุษย์\nอมร\nอมรา\nอมราวดี\nอมรินทร์\nอมเรนทร์\nอมเรศ\nอมฤต\nอมัตร\nอมาตย์\nอมาวสี\nอมาวสุ\nอมาวาสี\nอมิตร\nอเมริกัน\nอย่า\nอยาก\nอย่าง\nอยุทธ์\nอยู่\nอร\nอรชร\nอรชุน\nอรดี\nอรติ\nอรทัย\nอรไท\nอรนุช\nอรพินท์\nอรพิม\nอรรค\nอรรฆ\nอรรฆย์\nอรรจน์\nอรรณพ\nอรรถ\nอรรถกถา\nอรรถกถาจารย์\nอรรถาธิบาย\nอรรธ\nอรสุม\nอรหะ\nอรหัง\nอรหัต\nอรหัตผล\nอรหัตมรรค\nอรหัน\nอรหันต์\nอรหันตฆาต\nอร่อย\nอรัญ\nอรัญญิก\nอรัญวาส\nอรัญวาสี\nอรัณย์\nอราดี\nอร่าม\nอริ\nอรินทร์\nอริน\nอริยกะ\nอริยทรัพย์\nอริยบุคคล\nอริยผล\nอริยมรรค\nอริยสัจ\nอริยะ\nอรุณ\nอรุโณทัย\nอรุ่ม\nอรูป\nอลงกต\nอลงกรณ์\nอลงการ\nอลวน\nอลเวง\nอลหม่าน\nอล่องฉ่อง\nอลักเอลื่อ\nอลังการ\nอลัชชี\nอล่างฉ่าง\nอลิงค์\nอลึงค์\nอลึ่งฉึ่ง\nอโลหะ\nอ้วก\nอวกาศ\nอวจร\nอวชัย\nอวชาต\nอวด\nอวตาร\nอวน\nอ้วน\nอวบ\nอวมงคล\nอวย\nอวยวะ\nอวรรค\nอวรุทธ์\nอวรุทธก\nอวล\nอวสาน\nอวหาร\nอวัยวะ\nอวัสดา\nอวาจี\nอวิจี\nอวิชชา\nอวิญญาณกทรัพย์\nอวิญญู\nอวิรุทธ์\nอวิโรธน์\nอวิโรธนะ\nอวิหิงสา\nอวีจิ\nอเวจี\nอโศก\nอสงไขย\nอสนี\nอัสนี\nอสนีบาต\nอสภะ\nอสมการ\nอสมมาตร\nอสรพิษ\nอสังหาริมทรัพย์\nอสังหาริมะ\nอสัญกรรม\nอสัญญี\nอสัญแดหวา\nอสัตถพฤกษ์\nอัสสัตถพฤกษ์\nอสัตย์\nอสัมภิน\nอสัมภินพงศ์\nอสัมภินวงศ์\nอสิ\nอสิธารา\nอสิต\nอสิเลสะ\nอสีตยานุพยัญชนะ\nอสีติ\nอสุ\nอสุจิ\nอสุนีบาต\nอสุภ\nอสุรกาย\nอสุรา\nอสุรี\nอสุเรศ\nอสูร\nอเสกขบุคคล\nอเสกขะ\nอเสขบุคคล\nอเสขะ\nอหังการ\nอหิ\nอหิงสา\nอหิวาต์\nอหิวาตกโรค\nอหึงสา\nอเหตุกทิฐิ\nอโหสิ\nออ\nอ้อ\nอ๋อ\nออก\nออกซิเจน\nออกซิเดชัน\nออกไซด์\nออกญา\nอ่อง\nอ๋อง\nอ้องแอ้ง\nออเซาะ\nออด\nอ๊อด\nอ๊อดแอ๊ด\nอ่อน\nอ้อน\nออนซ์\nออนซอน\nอ้อนแอ้น\nออฟฟิศ\nออม\nอ่อม\nอ้อม\nออมชอม\nออมซอม\nอ้อมแอ้ม\nอ่อย\nอ้อย\nอ๋อย\nอ้อยส้อย\nอ้อยอิ่ง\nออสเมียม\nอ้อแอ้\nอ๊ะ\nอะคร้าว\nอะเคื้อ\nอะแจ\nอะเซทิลีน\nอะดรีนาลิน\nอะดุง\nอะตอม\nอะมีบา\nอะเมริเซียม\nอะร้าอร่าม\nอะไร\nอะลุ่มอล่วย\nอะลุ้มอล่วย\nอะลูมิเนียม\nอะหม\nอะไหล่\nอัก\nอั้ก\nอั๊ก\nอักกะ\nอักโกธะ\nอักขรวิธี\nอักขรวิบัติ\nอักขรสมัย\nอักขระ\nอักขรานุกรม\nอักขะ\nอักโข\nอักโขภิณี\nอักโขเภณี\nอักษร\nอักษะ\nอักเษาหิณี\nอักเสบ\nอักอ่วน\nอัคคะ\nอัคคิ\nอัคคี\nอัคนิ\nอัคนี\nอัคร\nอัครชายา\nอัครมเหสี\nอัครราชทูต\nอัครสมณทูต\nอัง\nอังก์\nอังกนะ\nอังกฤษ\nอังกะลุง\nอังกา\nอังกาบ\nอังกุระ\nอังกุศ\nอังกูร\nอังคณะ\nอังคณา\nอังคาร\nอังคาส\nอังคีรส\nอังคุฐ\nอังคุตรนิกาย\nอังฆาต\nอังแพลม\nอั้งยี่\nอั้งโล่\nอังศุ\nอังศุก\nอังศุธร\nอังศุมาลี\nอังสกุฏ\nอังสตรอม\nอังสนา\nอังสภาระ\nอังสะ\nอังสา\nอัจกลับ\nอัจจิ\nอัจจิมา\nอัจจุตะ\nอัจฉรา\nอัจฉริยบุคคล\nอัจฉริยภาพ\nอัจฉริยลักษณ์\nอัจฉริยลักษณะ\nอัจฉริยะ\nอัจนา\nอัชฌัตติก\nอัชฌา\nอัชฌาจาร\nอัชฌาศัย\nอัชฌาสัย\nอัญเดียรถีย์\nอัญมณี\nอัญขยม\nอัญชนะ\nอัญชลี\nอัญชัน\nอัญชุลี\nอัญเชิญ\nอัญญะ\nอัญดิตถีย์\nอัญเดียรถีย์\nอัญประกาศ\nอัญรูป\nอัฏ\nอัฏฐบาน\nอัฏฐะ\nอัฏฐังคิกมรรค\nอัฏนา\nอัฐ\nอัฐฬส\nอัฐเคราะห์\nอัฐทิศ\nอัฐบริขาร\nอัฐบาน\nอัฐม\nอัฐมี\nอัฐศก\nอัฐิ\nอัฒจันทร์\nอัฒภาค\nอัฒมาส\nอัฒรัตติ\nอัณฑโกส\nอัณฑชะ\nอัณฑะ\nอัณณพ\nอัด\nอัดแจ\nอัต\nอัตชีวประวัติ\nอัตนัย\nอัตภาพ\nอัตวินิบาตกรรม\nอัตคัด\nอัตตโนบท\nอัตตา\nอัตตาธิปไตย\nอัตถ์\nอัตถะ\nอัตโนมัติ\nอัตรชะ\nอัตรา\nอัตลัด\nอัททา\nอัทธ์\nอัทธา\nอัทธาน\nอัทธายุ\nอัธยาตมวิทยา\nอัธยาย\nอัธยาศัย\nอัน\nอั้น\nอั๋น\nอันดร\nอันดับ\nอันตกะ\nอันตกาล\nอันตะ\nอันตคุณ\nอันตรภาค\nอันตรวาสก\nอันตรธาน\nอันตรา\nอันตราย\nอันตรายิกธรรม\nอันติกะ\nอันติมสัจ\nอันติมะ\nอันเต\nอันโต\nอันเตปุริก\nอันเตวาสิก\nอันแถ้ง\nอันโทล\nอันธการ\nอันธพาล\nอันธิกา\nอันเวส\nอับ\nอับปาง\nอัปปะ\nอัปเปหิ\nอัปภาคย์\nอัปมงคล\nอัปยศ\nอัประมาณ\nอัประไมย\nอัปราชัย\nอัปรีย์\nอัปลักษณ์\nอัปสร\nอัพพุท\nอัพโพหาริก\nอัพภันดร\nอัพภาน\nอัพภาส\nอัพภูตธรรม\nอัพยากฤต\nอัมพฤกษ์\nอัมพาต\nอัมพวัน\nอัมพวา\nอัมพร\nอัมพา\nอัมพิละ\nอัมพุ\nอัมพุช\nอัมพุชินี\nอัมพุท\nอัยกา\nอัยการ\nอัยกี\nอัยยะ\nอัยยิกา\nอัลกุรอาน\nอัลตราไวโอเลต\nอั่ว\nอัศจรรย์\nอัศเจรีย์\nอัศว\nอัศวเมธ\nอัศวยุช\nอัศวานึก\nอัศวิน\nอัศวินี\nอัษฎมงคล\nอัษฏมงคล\nอัษฎางคิกมรรค\nอัษฎายุธ\nอัษฎาวุธ\nอัสสะ\nอัสดร\nอัสกัณ\nอัสดง\nอัสดงคต\nอัสมิมานะ\nอัสสนี\nอัสสานึก\nอัสสาสะ\nอัสสุ\nอา\nอ่า\nอ้า\nอ๋า\nอากร\nอากังขา\nอากัป\nอาการ\nอากาศ\nอากูล\nอาเกียรณ์\nอาขยาต\nอาขยาน\nอาคเนย์\nอาคม\nอาครหายณี\nอาคันตุกะ\nอาคันตุกภัต\nอาคันตุกวัตร\nอาคาร\nอาฆาต\nอ่าง\nอ้าง\nอางขนาง\nอ้างว้าง\nอาจ\nอาจม\nอาจริยวัตร\nอาจริยวาท\nอาจาด\nอาจาร\nอาจารย์\nอาจารี\nอาจิณ\nอาเจียน\nอาชญา\nอาชวะ\nอาชา\nอาชาไนย\nอาชีพ\nอาชีวศึกษา\nอาชีวะ\nอาชีวก\nอาญา\nอาฏานา\nอาณัติ\nอาณา\nอาด\nอาดูร\nอาดุลย์\nอาดูลย์\nอาเด๊ะ\nอาตมภาพ\nอาตมัน\nอาตมา\nอาถรรพ์\nอาถรรพณ์\nอาทร\nอาทิ\nอาทิจจวาร\nอาทิตย์\nอาทิตยมณฑล\nอาทิตยวาร\nอาทีนพ\nอาทีนวะ\nอาทึก\nอาเทศ\nอาเทสนา\nอาธรรม\nอาธรรม์\nอาธาน\nอาธาร\nอาน\nอ่าน\nอานน\nอานนท์\nอานันท์\nอานันทนะ\nอานัม\nอานาปานะ\nอานาปานัสสติ\nอานิสงส์\nอานุภาพ\nอานุภาวะ\nอาบ\nอาบัติ\nอาบัน\nอาปณกะ\nอาปณะ\nอาปะ\nอาโป\nอาปานะ\nอาพัทธ์\nอาพันธ์\nอาพันธนะ\nอาพาธ\nอาเพศ\nอาภรณ์\nอาภัพ\nอาภัสระ\nอาภา\nอาภาส\nอามลกะ\nอามัย\nอามิษ\nอามิส\nอาย\nอ้าย\nอายตนะ\nอายตะ\nอายน\nอายัด\nอายัต\nอายัน\nอายาจนะ\nอายานะ\nอายุ\nอายุตกะ\nอายุธ\nอายุรกรรม\nอายุรแพทย์\nอายุรเวช\nอายุรเวท\nอายุศาสตร์\nอายุษ\nอาร์กอน\nอารดี\nอารติ\nอาร์ต\nอารทรา\nอาร์ม\nอารมณ์\nอารยชน\nอารยชาติ\nอารยธรรม\nอารยประเทศ\nอารยะ\nอารยัน\nอาระ\nอารักขา\nอารักษ์\nอารัญ\nอารัณย์\nอารัญญิก\nอารัณยกะ\nอารัติ\nอารัมภ์\nอารัมภกถา\nอารัมภบท\nอารัมภะ\nอาราธน์\nอาราธนา\nอาราม\nอารามิก\nอารี\nอารุม\nอาลปนะ\nอาละวาด\nอาลักษณ์\nอาลัย\nอาลัว\nอาลี\nอาโลก\nอาว\nอ่าว\nอ้าว\nอาวรณ์\nอาวัชนาการ\nอาวัล\nอาวาส\nอาวาสิก\nอาวาหมงคล\nอาวาหะ\nอาวุต\nอาวุธ\nอาวุโส\nอาเวค\nอาศรม\nอาศรมบท\nอาศเลษา\nอาศัย\nอาศิรพจน์\nอาศิรพาท\nอาศิรวาท\nอาศุ\nอาเศียรพจน์\nอาเศียรพาท\nอาเศียรวาท\nอาษาฒ\nอาสน\nอาสน์\nอาสนะ\nอาสนศาลา\nอาสัญ\nอาสัตย์\nอาสา\nอาสาฬห์\nอาสาฬหบูชา\nอาสาฬหะ\nอาสิญจ์\nอาสิน\nอาหม\nอาหรับ\nอาหาร\nอาฬหก\nอำ\nอ่ำ\nอ้ำ\nอำแดง\nอำนนต์\nอำนรรฆ\nอำนวย\nอำนาจ\nอำนาถ\nอำนิฐ\nอำนิษฐ์\nอำปลัง\nอำพน\nอำพล\nอำพะนำ\nอำพัน\nอำไพ\nอำเภอ\nอำมร\nอำมฤคโชค\nอำมฤต\nอำมหิต\nอำมาตย์\nอำมาตยาธิปไตย\nอำยวน\nอำรุง\nอำลา\nอำอวม\nอ้ำอึ้ง\nอิก\nอิง\nอิงค์\nอิงอร\nอิจฉา\nอิฉัน\nอิชยา\nอิฏฐารมณ์\nอิฐ\nอิฐผล\nอิด\nอิตถี\nอิตเทรียม\nอิตเทอร์เบียม\nอิติวุตตกะ\nอิทธิ\nอิน\nอินซูลิน\nอินเดีย\nอินเดียนแดง\nอินเดียม\nอินท์\nอินทขีล\nอินทนิล\nอินทผลัม\nอินทร์\nอินทรธนู\nอินทรวงศ์\nอินทรวิเชียร\nอินทรศักดิ์\nอินทราณี\nอินทราภิเษก\nอินทรายุธ\nอินทรี\nอินทรีย์\nอินทรียสังวร\nอินทีวร\nอินทุ\nอินฟราเรด\nอินัง\nอิ่ม\nอิมัลชัน\nอิริเดียม\nอิริยา\nอิริยาบถ\nอิรุพเพท\nอิเล็กตรอน\nอิเล็กทรอนิกส์\nอิเล็กโทน\nอิศร\nอิศวร\nอิษฏ์\nอิษฏี\nอิส\nอิสตรี\nอิสัตรี\nอิสรภาพ\nอิสระ\nอิสริยยศ\nอิสริยะ\nอิสริยาภรณ์\nอิสลาม\nอิสสา\nอิสิ\nอิสี\nอิหม่าม\nอิหลักอิเหลื่อ\nอี\nอี่\nอี้\nอี๊\nอี๋\nอี๋อ๋อ\nอีก\nอีก้อ\nอีก๋อย\nอีโก้ง\nอีจู้\nอี๊ด\nอีเต้อ\nอีโต้\nอีทุบ\nอีเทอร์\nอีนุงตุงนัง\nอีนูน\nอีโน\nอีแปะ\nอีโปง\nอีเพา\nอีมู\nอีรม\nอีลุ้ม\nอีลุ่ยฉุยแฉก\nอีเลิ้ง\nอีศ\nอีศวร\nอีส\nอีสาน\nอีสุกอีใส\nอีหรอบ\nอีหลักอีเหลื่อ\nอีหลี\nอีหลุกขลุกขลัก\nอีหลุกขลุกขลุ่ย\nอีเห็น\nอีเหน็บ\nอีเหนียว\nอีเหละเขละขละ\nอีเหละเขะขะ\nอีโหน่อีเหน่\nอีโหลกโขลกเขลก\nอีแอ่น\nอึ\nอึก\nอึ้ก\nอึ๊ก\nอึกทึก\nอึกอัก\nอึง\nอึ่ง\nอึ้ง\nอึด\nอึดตะปือ\nอึ้ดทึ่ด\nอึน\nอืด\nอื่น\nอื้น\nอือ\nอื้อ\nอื้อฮือ\nอุ\nอุก\nอุกกา\nอุกกาบาต\nอุกฤษฏ์\nอุกลาบาต\nอุค\nอุคระ\nอุคหนิมิต\nอุโฆษ\nอุ้ง\nอุจ\nอุจจาระ\nอุจฉุ\nอุจเฉท\nอุจเฉททิฐิ\nอุจาด\nอุชุ\nอุฏฐาการ\nอุณหภูมิ\nอุณหะ\nอุณหาหาร\nอุณหิส\nอุณา\nอุณาโลม\nอุด\nอุดเตา\nอุดม\nอุดมการณ์\nอุดมคติ\nอุดมศึกษา\nอุดร\nอุดหนุน\nอุตดม\nอุตตมะ\nอุตมภาพ\nอุตมางค์\nอุตดร\nอุตรกุรุทวีป\nอุตตรายัน\nอุตรนิกาย\nอุตรผลคุนี\nอุตตรผลคุนี\nอุตรภัทรบท\nอุตตรภัทรบท\nอุตตรภัททะ\nอุตราภิมุข\nอุตราวรรต\nอุตราวัฏ\nอุตราษาฒ\nอุตตราสาฬหะ\nอุตราสงค์\nอุตตานภาพ\nอุตพิด\nอุตรา\nอุตริ\nอุตริมนุสธรรม\nอุตลุด\nอุตส่าห์\nอุตสาหกรรม\nอุตสาหะ\nอุตุ\nอุตุนิยม\nอุตุนิยมวิทยา\nอุทก\nอุทกธาร\nอุทกธารา\nอุทกภัย\nอุทกวิทยา\nอุทกศาสตร์\nอุทธรณ์\nอุทธัจ\nอุทยาน\nอุทร\nอุทริยะ\nอุทลุม\nอุทัช\nอุทัย\nอุทาน\nอุทาร\nอุทาหรณ์\nอุทิศ\nอุทุมพร\nอุเทศ\nอุเทสิกเจดีย์\nอุธัจ\nอุ่น\nอุบ\nอุบล\nอุบะ\nอุบ๊ะ\nอุบัติ\nอุบาท\nอุบาทว์\nอุบาย\nอุบาสก\nอุบาสิกา\nอุเบกขา\nอุโบสถ\nอุปกรณ์\nอุปกรม\nอุปการ\nอุปการะ\nอุปการี\nอุปกิเลส\nอุปจาร\nอุปถัมภ์\nอุปถัมภก\nอุปทม\nอุปทูต\nอุปเทศ\nอุปเท่ห์\nอุปธิ\nอุปนัย\nอุปนิกขิต\nอุปนิษัท\nอุปนิสัย\nอุปบัติ\nอุปปาติกะ\nอุปพัทธ์\nอุปพันธ์\nอุปโภค\nอุปมา\nอุปมาน\nอุปไมย\nอุปยุวราช\nอุปรากร\nอุปราคา\nอุปราช\nอุปริ\nอุปริมปริยาย\nอุปโลกน์\nอุปเวท\nอุปสมบท\nอุปสมบัน\nอุปสัมบัน\nอุปสรรค\nอุปสัมปทา\nอุปฮาด\nอุปัชฌาย์\nอุปัชฌายวัตร\nอุปัชฌายะ\nอุปัฏฐาก\nอุปัฏฐานะ\nอุปัทวะ\nอุปัทวันตราย\nอุปาทาน\nอุปาหนา\nอุภัย\nอุ้ม\nอุมงค์\nอุโมงค์\nอุย\nอุ่ย\nอุ้ย\nอุ๊ย\nอุยยาน\nอุยยาม\nอุรณะ\nอุรพี\nอุระ\nอุรังอุตัง\nอุรัจฉัท\nอุรัจฉทะ\nอุรา\nอุรุ\nอุไร\nอุลกมณี\nอุลโลจ\nอุลามก\nอุลิด\nอุโลก\nอุแว้\nอุษณกร\nอุษณกาล\nอุษณรัศมี\nอุษณรุจี\nอุษณาการ\nอุษณีษ์\nอุษมะ\nอุษมัน\nอุษา\nอุษาโยค\nอุสภ\nอุสส่าห์\nอุสสาหะ\nอุสา\nอุสุ\nอุสุภ\nอุสุภราช\nอุสุม\nอุหรับ\nอุหลบ\nอุเหม่\nอุฬาร\nอู\nอู่\nอู้\nอูฐ\nอูด\nอูม\nอูย\nอูรุ\nอู๋อี๋\nเอ\nเอ้\nเอ๊\nเอก\nเอกเขนก\nเอกซเรย์\nเอกรรถประโยค\nเอกัคตา\nเอกังสพยากรณ์\nเอกังสวาที\nเอกา\nเอ้กา\nเอกาธิปไตย\nเอเคอร์\nเอง\nเอ็ง\nเอ๋ง\nเอ็ด\nเอ็ดตะโร\nเอดส์\nเอตทัคคะ\nเอ้เต\nเอทิล\nเอน\nเอ็น\nเอนไซม์\nเอ็นดู\nเอ็นอ่อน\nเอม\nเอ็มบริโอ\nเอย\nเอ่ย\nเอ๊ย\nเอ๋ย\nเอร็ดอร่อย\nเอราวัณ\nเอว\nเอ๊ว\nเอวัง\nเอฬกะ\nเอฬา\nเออ\nเอ่อ\nเออร์เบียม\nเอ้อระเหย\nเอ้อเร้อ\nเอ้อเฮอ\nเอ๊ะ\nเอะใจ\nเอะอะ\nเอะอะมะเทิ่ง\nเอา\nเอาทาร\nเอาทารย์\nเอารส\nเอาฬาร\nเอาะลาย\nเอิก\nเอิกเกริก\nเอิ้น\nเอิบ\nเอียง\nเอี้ยง\nเอียด\nเอี๊ยด\nเอียน\nเอี่ยน\nเอี่ยม\nเอี๊ยม\nเอี้ยมจุ๊น\nเอี้ยมเฟี้ยม\nเอี่ยว\nเอี้ยว\nเอื้อ\nเอื๊อก\nเอื้อง\nเอือด\nเอือน\nเอื้อน\nเอือม\nเอื้อม\nเอื่อย\nเอื้อย\nแอ\nแอ้\nแอ๋\nแอก\nแอกทิเนียม\nแอ่ง\nแอ้งแม้ง\nแอด\nแอ้ด\nแอ๊ด\nแอ่น\nแอนติเจน\nแอนติบอดี\nแอนติอิเล็กตรอน\nแอโนด\nแอบ\nแอม\nแอ้ม\nแอมแปร์\nแอมมิเตอร์\nแอมโมเนีย\nแอร่ม\nแอลกอฮอล์\nแอลฟา\nแอว\nแอ่ว\nแอ้วแซ่ว\nแอสทาทีน\nแอสไพริน\nแอสฟัลต์\nแอหนัง\nแออัด\nโอ\nโอ่\nโอ้\nโอ๋\nโอก\nโอ้ก\nโอ้กอ้าก\nโอ๊ก\nโอกาส\nโอฆชล\nโอฆสงสาร\nโอฆะ\nโอ่ง\nโองการ\nโองโขดง\nโอชะ\nโอชา\nโอโซน\nโอฐ\nโอด\nโอ๊ต\nโอตตัปปะ\nโอทนะ\nโอน\nโอบ\nโอปปาติกะ\nโอภา\nโอภาส\nโอม\nโอย\nโอ๊ย\nโอรส\nโอละพ่อ\nโอลิมปิก\nโอวาท\nโอษฐ์\nโอษฐชะ\nโอษฐภัย\nโอสถ\nโอห์ม\nโอหัง\nโอฬาร\nโอฬาริก\nโอฬารึก\nโอ้เอ้\nโอเอซิส\nโอ้โฮ\nไอ\nไอ้\nไอโซโทป\nไอน์สไตเนียม\nไอยรา\nไอยเรศ\nไอราพต\nไอราวัณ\nไอราวัต\nไอศกรีม\nไอศวรรย์\nไอศุริยสมบัติ\nไอศูรย์\nไอออน\nไอโอดีน\nฮกเกี้ยน\nฮด\nฮวงซุ้ย\nฮวน\nฮ้วนหมู\nฮวบ\nฮ่อ\nฮ้อ\nฮอกกี้\nฮอด\nฮ่อม\nฮ่อยจ๊อ\nฮอร์โมน\nฮอลแลนด์\nฮอลันดา\nฮะ\nฮะเบส\nฮะเรีย\nฮัก\nฮังเล\nฮัจญ์\nฮัจญะฮ์\nฮัจญี\nฮั่น\nฮั้ว\nฮา\nฮ้า\nฮ่างหลวง\nฮาจญ์\nฮาม\nฮาเร็ม\nฮาห์เนียม\nฮิจเราะห์\nฮินดู\nฮิปโปโปเตมัส\nฮิสทีเรีย\nฮีเลียม\nฮึ\nฮึก\nฮึด\nฮึดฮัด\nฮึ่ม\nฮึย\nฮึ่ย\nฮืดฮาด\nฮือ\nฮื่อ\nฮื้อ\nฮื้อฉี่\nฮุด\nฮุบ\nฮุยเลฮุย\nฮู้\nฮูก\nฮูม\nเฮ\nเฮฮา\nเฮกตาร์\nเฮกโตกรัม\nเฮกโตเมตร\nเฮกโตลิตร\nเฮง\nเฮ็ด\nเฮโมโกลบิน\nเฮย\nเฮ่ย\nเฮ้ย\nเฮโรอีน\nเฮลิคอปเตอร์\nเฮโล\nเฮละโล\nเฮ้ว\nเฮอ\nเฮ่อ\nเฮ้อ\nเฮอริเคน\nเฮิรตซ์\nเฮี้ยน\nเฮี้ยบ\nเฮี้ยว\nเฮือก\nเฮือน\nแฮ\nแฮ่\nแฮก\nแฮ่กึ๊น\nแฮนด์บอล\nแฮฟเนียม\nแฮม\nแฮะ\nโฮ\nโฮก\nโฮ่ง\nโฮ้ง\nโฮเต็ล\nโฮลเมียม\nโฮะ\nไฮ้\nไฮโกรมิเตอร์\nไฮดรา\nไฮโดร\nไฮโดรคาร์บอน\nไฮโดรเจน\nไฮโดรมิเตอร์\nไฮไฟ\nไฮโล\nไฮฮี\n"
-              .split(/[\r\n]+/)
-              .filter(function (w) {
-                return w.length > 1;
-              })
-      this.addWords(words, false)
-    }
-    if(finalize){
-      this.finalizeDict();
-    }
-  },
-
-  dictSeek: function (l, r, ch, strOffset, pos) {
-    var ans = null;
-    while (l <= r) {
-      var m = Math.floor((l + r) / 2),
-        dict_item = this.dict[m],
-        len = dict_item.length;
-      if (len <= strOffset) {
-        l = m + 1;
-      } else {
-        var ch_ = dict_item[strOffset];
-        if (ch_ < ch) {
-          l = m + 1;
-        } else if (ch_ > ch) {
-          r = m - 1;
-        } else {
-          ans = m;
-          if (pos == LEFT) {
-            r = m - 1;
-          } else {
-            l = m + 1;
-          }
-        }
-      }
-    }
-    return ans;
-  },
-
-  isFinal: function (acceptor) {
-    return this.dict[acceptor.l].length == acceptor.strOffset;
-  },
-
-  createAcceptor: function () {
-    return {
-      l: 0,
-      r: this.dict.length - 1,
-      strOffset: 0,
-      isFinal: false,
-      dict: this,
-      transit: function (ch) {
-        return this.dict.transit(this, ch);
-      },
-      isError: false,
-      tag: "DICT",
-      w: 1,
-      type: "DICT"
-    };
-  },
-
-  transit: function (acceptor, ch) {
-    var l = this.dictSeek(acceptor.l,
-      acceptor.r,
-      ch,
-      acceptor.strOffset,
-      LEFT);
-    if (l !== null) {
-      var r = this.dictSeek(l,
-        acceptor.r,
-        ch,
-        acceptor.strOffset,
-        RIGHT);
-      acceptor.l = l;
-      acceptor.r = r;
-      acceptor.strOffset++;
-      acceptor.isFinal = this.isFinal(acceptor);
-    } else {
-      acceptor.isError = true;
-    }
-    return acceptor;
-  },
-
-  sortuniq: function(a){
-    return a.sort().filter(function(item, pos, arr){
-      return !pos || item != arr[pos - 1];
-    })
-  },
-
-  flatten: function(a){
-    //[[1,2],[3]] -> [1,2,3]
-    return [].concat.apply([], a);
-  }
-};
-module.exports = WordcutDict;
-
-}).call(this,"/dist/tmp")
-},{"glob":16,"path":22}],3:[function(require,module,exports){
-var WordRule = {
-  createAcceptor: function(tag) {
-    if (tag["WORD_RULE"])
-      return null;
-
-    return {strOffset: 0,
-            isFinal: false,
-            transit: function(ch) {
-              var lch = ch.toLowerCase();
-              if (lch >= "a" && lch <= "z") {
-                this.isFinal = true;
-                this.strOffset++;
-              } else {
-                this.isError = true;
-              }
-              return this;
-            },
-            isError: false,
-            tag: "WORD_RULE",
-            type: "WORD_RULE",
-            w: 1};
-  }
-};
-
-var NumberRule = {
-  createAcceptor: function(tag) {
-    if (tag["NUMBER_RULE"])
-      return null;
-
-    return {strOffset: 0,
-            isFinal: false,
-            transit: function(ch) {
-              if (ch >= "0" && ch <= "9") {
-                this.isFinal = true;
-                this.strOffset++;
-              } else {
-                this.isError = true;
-              }
-              return this;
-            },
-            isError: false,
-            tag: "NUMBER_RULE",
-            type: "NUMBER_RULE",
-            w: 1};
-  }
-};
-
-var SpaceRule = {
-  tag: "SPACE_RULE",
-  createAcceptor: function(tag) {
-
-    if (tag["SPACE_RULE"])
-      return null;
-
-    return {strOffset: 0,
-            isFinal: false,
-            transit: function(ch) {
-              if (ch == " " || ch == "\t" || ch == "\r" || ch == "\n" ||
-                  ch == "\u00A0" || ch=="\u2003"//nbsp and emsp
-                 ) {
-                this.isFinal = true;
-                this.strOffset++;
-              } else {
-                this.isError = true;
-              }
-              return this;
-            },
-            isError: false,
-            tag: SpaceRule.tag,
-            w: 1,
-            type: "SPACE_RULE"};
-  }
-}
-
-var SingleSymbolRule = {
-  tag: "SINSYM",
-  createAcceptor: function(tag) {
-    return {strOffset: 0,
-            isFinal: false,
-            transit: function(ch) {
-              if (this.strOffset == 0 && ch.match(/^[\@\(\)\/\,\-\."`]$/)) {
-                this.isFinal = true;
-                this.strOffset++;
-              } else {
-                this.isError = true;
-              }
-              return this;
-            },
-            isError: false,
-            tag: "SINSYM",
-            w: 1,
-            type: "SINSYM"};
-  }
-}
-
-
-var LatinRules = [WordRule, SpaceRule, SingleSymbolRule, NumberRule];
-
-module.exports = LatinRules;
-
-},{}],4:[function(require,module,exports){
-var _ = require("underscore")
-  , WordcutCore = require("./wordcut_core");
-var PathInfoBuilder = {
-
-  /*
-    buildByPartAcceptors: function(path, acceptors, i) {
-    var 
-    var genInfos = partAcceptors.reduce(function(genInfos, acceptor) {
-      
-    }, []);
-    
-    return genInfos;
-  } 
-  */
-
-  buildByAcceptors: function(path, finalAcceptors, i) {
-    var self = this;
-    var infos = finalAcceptors.map(function(acceptor) {
-      var p = i - acceptor.strOffset + 1
-        , _info = path[p];            
-      
-      var info = {p: p, 
-                  mw: _info.mw + (acceptor.mw === undefined ? 0 : acceptor.mw),
-                  w: acceptor.w + _info.w,
-                  unk: (acceptor.unk ? acceptor.unk : 0) + _info.unk, 
-                  type: acceptor.type};
-
-      if (acceptor.type == "PART") {
-        for(var j = p + 1; j <= i; j++) {
-          path[j].merge = p;
-        }
-        info.merge = p;
-      }
-
-      return info;
-    });
-    return infos.filter(function(info) { return info; });
-  },
-  
-  fallback: function(path, leftBoundary, text, i) {
-    var _info = path[leftBoundary];
-    if (text[i].match(/[\u0E48-\u0E4E]/)) {
-      if (leftBoundary != 0) 
-        leftBoundary = path[leftBoundary].p;
-      return {p: leftBoundary,
-              mw: 0,
-              w: 1 + _info.w,
-              unk: 1 + _info.unk,
-              type: "UNK"};      
-/*    } else if(leftBoundary > 0 && path[leftBoundary].type !== "UNK") {
-      leftBoundary = path[leftBoundary].p;
-      return {p: leftBoundary,
-              w: 1 + _info.w,
-              unk: 1 + _info.unk,
-              type: "UNK"};            */
-    } else {      
-      return {p: leftBoundary,
-              mw: _info.mw,
-              w: 1 + _info.w,
-              unk: 1 + _info.unk,
-              type: "UNK"};
-    }
-  },
-  
-  build: function(path, finalAcceptors, i, leftBoundary, text) {
-    var basicPathInfos = this.buildByAcceptors(path, finalAcceptors, i);
-    if (basicPathInfos.length > 0) {
-      return basicPathInfos;
-    } else {
-      return [this.fallback(path, leftBoundary, text, i)];
-    }
-  }
-};
-
-module.exports = function() {
-  return _.clone(PathInfoBuilder);
-}
-
-},{"./wordcut_core":8,"underscore":25}],5:[function(require,module,exports){
-var _ = require("underscore");
-
-
-var PathSelector = {
-  selectPath: function(paths) {
-    var path = paths.reduce(function(selectedPath, path) {
-      if (selectedPath == null) {        
-        return path;
-      } else {
-        if (path.unk < selectedPath.unk) 
-          return path;        
-        if (path.unk == selectedPath.unk) {
-          if (path.mw < selectedPath.mw)
-            return path
-          if (path.mw == selectedPath.mw) {
-            if (path.w < selectedPath.w) 
-              return path;
-          }
-        }
-        return selectedPath;
-      }
-    }, null);
-    return path;
-  },
-  
-  createPath: function() {
-    return [{p:null, w:0, unk:0, type: "INIT", mw:0}];
-  }
-};
-
-module.exports = function() {
-  return _.clone(PathSelector);
-};
-
-},{"underscore":25}],6:[function(require,module,exports){
-function isMatch(pat, offset, ch) {
-  if (pat.length <= offset)
-    return false;
-  var _ch = pat[offset];
-  return _ch == ch ||
-         (_ch.match(/[กข]/) && ch.match(/[ก-ฮ]/)) ||
-         (_ch.match(/[มบ]/) && ch.match(/[ก-ฮ]/)) ||
-         (_ch.match(/\u0E49/) && ch.match(/[\u0E48-\u0E4B]/));
-}
-
-var Rule0 = {
-  pat: "เหก็ม",
-  createAcceptor: function(tag) {
-    return {strOffset: 0,
-            isFinal: false,
-            transit: function(ch) {
-              if (isMatch(Rule0.pat, this.strOffset,ch)) {                 
-                this.isFinal = (this.strOffset + 1 == Rule0.pat.length);                
-                this.strOffset++;
-              } else {              
-                this.isError = true;             
-              }
-              return this;
-            },
-            isError: false,
-            tag: "THAI_RULE",
-            type: "THAI_RULE", 
-            w: 1};                        
-  }
-};
-
-var PartRule = {
-  createAcceptor: function(tag) {
-    return {strOffset: 0,
-            patterns: [
-              "แก", "เก", "ก้", "กก์", "กา", "กี", "กิ", "กืก"  
-            ],
-            isFinal: false,
-            transit: function(ch) {
-              var offset = this.strOffset;
-              this.patterns = this.patterns.filter(function(pat) {
-                return isMatch(pat, offset, ch);
-              });
-              
-              if (this.patterns.length > 0) {
-                var len = 1 + offset;
-                this.isFinal = this.patterns.some(function(pat) {
-                  return pat.length == len; 
-                });
-                this.strOffset++;
-              } else {              
-                this.isError = true;             
-              }
-              return this;
-            },
-            isError: false,
-            tag: "PART",
-            type: "PART", 
-            unk: 1,
-            w: 1};                        
-  }
-};
-
-var ThaiRules = [Rule0, PartRule];
-
-module.exports = ThaiRules;
-
-},{}],7:[function(require,module,exports){
-var sys = require("sys")
-  , WordcutDict = require("./dict")
-  , WordcutCore = require("./wordcut_core")
-  , PathInfoBuilder = require("./path_info_builder")
-  , PathSelector = require("./path_selector")
-  , Acceptors = require("./acceptors")
-  , latinRules = require("./latin_rules")
-  , thaiRules = require("./thai_rules")
-  , _ = require("underscore");
-
-
-var Wordcut = Object.create(WordcutCore);
-Wordcut.defaultPathInfoBuilder = PathInfoBuilder;
-Wordcut.defaultPathSelector = PathSelector;
-Wordcut.defaultAcceptors = Acceptors;
-Wordcut.defaultLatinRules = latinRules;
-Wordcut.defaultThaiRules = thaiRules;
-Wordcut.defaultDict = WordcutDict;
-
-
-Wordcut.initNoDict = function(dict_path) {
-  var self = this;
-  self.pathInfoBuilder = new self.defaultPathInfoBuilder;
-  self.pathSelector = new self.defaultPathSelector;
-  self.acceptors = new self.defaultAcceptors;
-  self.defaultLatinRules.forEach(function(rule) {
-    self.acceptors.creators.push(rule);
-  });
-  self.defaultThaiRules.forEach(function(rule) {
-    self.acceptors.creators.push(rule);
-  });
-};
-
-Wordcut.init = function(dict_path, withDefault, additionalWords) {
-  withDefault = withDefault || false;
-  this.initNoDict();
-  var dict = _.clone(this.defaultDict);
-  dict.init(dict_path, withDefault, additionalWords);
-  this.acceptors.creators.push(dict);
-};
-
-module.exports = Wordcut;
-
-},{"./acceptors":1,"./dict":2,"./latin_rules":3,"./path_info_builder":4,"./path_selector":5,"./thai_rules":6,"./wordcut_core":8,"sys":28,"underscore":25}],8:[function(require,module,exports){
-var WordcutCore = {
-
-  buildPath: function(text) {
-    var self = this
-      , path = self.pathSelector.createPath()
-      , leftBoundary = 0;
-    self.acceptors.reset();
-    for (var i = 0; i < text.length; i++) {
-      var ch = text[i];
-      self.acceptors.transit(ch);
-
-      var possiblePathInfos = self
-        .pathInfoBuilder
-        .build(path,
-               self.acceptors.getFinalAcceptors(),
-               i,
-               leftBoundary,
-               text);
-      var selectedPath = self.pathSelector.selectPath(possiblePathInfos)
-
-      path.push(selectedPath);
-      if (selectedPath.type !== "UNK") {
-        leftBoundary = i;
-      }
-    }
-    return path;
-  },
-
-  pathToRanges: function(path) {
-    var e = path.length - 1
-     , ranges = [];
-
-    while (e > 0) {
-      var info = path[e]
-       , s = info.p;
-
-      if (info.merge !== undefined && ranges.length > 0) {
-        var r = ranges[ranges.length - 1];
-        r.s = info.merge;
-        s = r.s;
-      } else {
-        ranges.push({s:s, e:e});
-      }
-      e = s;
-    }
-    return ranges.reverse();
-  },
-
-  rangesToText: function(text, ranges, delimiter) {
-    return ranges.map(function(r) {
-      return text.substring(r.s, r.e);
-    }).join(delimiter);
-  },
-
-  cut: function(text, delimiter) {
-    var path = this.buildPath(text)
-      , ranges = this.pathToRanges(path);
-    return this
-      .rangesToText(text, ranges,
-                    (delimiter === undefined ? "|" : delimiter));
-  },
-
-  cutIntoRanges: function(text, noText) {
-    var path = this.buildPath(text)
-      , ranges = this.pathToRanges(path);
-
-    if (!noText) {
-      ranges.forEach(function(r) {
-        r.text = text.substring(r.s, r.e);
-      });
-    }
-    return ranges;
-  },
-
-  cutIntoArray: function(text) {
-    var path = this.buildPath(text)
-      , ranges = this.pathToRanges(path);
-    
-    return ranges.map(function(r) {
-      return text.substring(r.s, r.e)
-    });
-  }
-};
-
-module.exports = WordcutCore;
-
-},{}],9:[function(require,module,exports){
-// http://wiki.commonjs.org/wiki/Unit_Testing/1.0
-//
-// THIS IS NOT TESTED NOR LIKELY TO WORK OUTSIDE V8!
-//
-// Originally from narwhal.js (http://narwhaljs.org)
-// Copyright (c) 2009 Thomas Robinson <280north.com>
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the 'Software'), to
-// deal in the Software without restriction, including without limitation the
-// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-// sell copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
-// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-// when used in node, this will actually load the util module we depend on
-// versus loading the builtin util module as happens otherwise
-// this is a bug in node module loading as far as I am concerned
-var util = require('util/');
-
-var pSlice = Array.prototype.slice;
-var hasOwn = Object.prototype.hasOwnProperty;
-
-// 1. The assert module provides functions that throw
-// AssertionError's when particular conditions are not met. The
-// assert module must conform to the following interface.
-
-var assert = module.exports = ok;
-
-// 2. The AssertionError is defined in assert.
-// new assert.AssertionError({ message: message,
-//                             actual: actual,
-//                             expected: expected })
-
-assert.AssertionError = function AssertionError(options) {
-  this.name = 'AssertionError';
-  this.actual = options.actual;
-  this.expected = options.expected;
-  this.operator = options.operator;
-  if (options.message) {
-    this.message = options.message;
-    this.generatedMessage = false;
-  } else {
-    this.message = getMessage(this);
-    this.generatedMessage = true;
-  }
-  var stackStartFunction = options.stackStartFunction || fail;
-
-  if (Error.captureStackTrace) {
-    Error.captureStackTrace(this, stackStartFunction);
-  }
-  else {
-    // non v8 browsers so we can have a stacktrace
-    var err = new Error();
-    if (err.stack) {
-      var out = err.stack;
-
-      // try to strip useless frames
-      var fn_name = stackStartFunction.name;
-      var idx = out.indexOf('\n' + fn_name);
-      if (idx >= 0) {
-        // once we have located the function frame
-        // we need to strip out everything before it (and its line)
-        var next_line = out.indexOf('\n', idx + 1);
-        out = out.substring(next_line + 1);
-      }
-
-      this.stack = out;
-    }
-  }
-};
-
-// assert.AssertionError instanceof Error
-util.inherits(assert.AssertionError, Error);
-
-function replacer(key, value) {
-  if (util.isUndefined(value)) {
-    return '' + value;
-  }
-  if (util.isNumber(value) && !isFinite(value)) {
-    return value.toString();
-  }
-  if (util.isFunction(value) || util.isRegExp(value)) {
-    return value.toString();
-  }
-  return value;
-}
-
-function truncate(s, n) {
-  if (util.isString(s)) {
-    return s.length < n ? s : s.slice(0, n);
-  } else {
-    return s;
-  }
-}
-
-function getMessage(self) {
-  return truncate(JSON.stringify(self.actual, replacer), 128) + ' ' +
-         self.operator + ' ' +
-         truncate(JSON.stringify(self.expected, replacer), 128);
-}
-
-// At present only the three keys mentioned above are used and
-// understood by the spec. Implementations or sub modules can pass
-// other keys to the AssertionError's constructor - they will be
-// ignored.
-
-// 3. All of the following functions must throw an AssertionError
-// when a corresponding condition is not met, with a message that
-// may be undefined if not provided.  All assertion methods provide
-// both the actual and expected values to the assertion error for
-// display purposes.
-
-function fail(actual, expected, message, operator, stackStartFunction) {
-  throw new assert.AssertionError({
-    message: message,
-    actual: actual,
-    expected: expected,
-    operator: operator,
-    stackStartFunction: stackStartFunction
-  });
-}
-
-// EXTENSION! allows for well behaved errors defined elsewhere.
-assert.fail = fail;
-
-// 4. Pure assertion tests whether a value is truthy, as determined
-// by !!guard.
-// assert.ok(guard, message_opt);
-// This statement is equivalent to assert.equal(true, !!guard,
-// message_opt);. To test strictly for the value true, use
-// assert.strictEqual(true, guard, message_opt);.
-
-function ok(value, message) {
-  if (!value) fail(value, true, message, '==', assert.ok);
-}
-assert.ok = ok;
-
-// 5. The equality assertion tests shallow, coercive equality with
-// ==.
-// assert.equal(actual, expected, message_opt);
-
-assert.equal = function equal(actual, expected, message) {
-  if (actual != expected) fail(actual, expected, message, '==', assert.equal);
-};
-
-// 6. The non-equality assertion tests for whether two objects are not equal
-// with != assert.notEqual(actual, expected, message_opt);
-
-assert.notEqual = function notEqual(actual, expected, message) {
-  if (actual == expected) {
-    fail(actual, expected, message, '!=', assert.notEqual);
-  }
-};
-
-// 7. The equivalence assertion tests a deep equality relation.
-// assert.deepEqual(actual, expected, message_opt);
-
-assert.deepEqual = function deepEqual(actual, expected, message) {
-  if (!_deepEqual(actual, expected)) {
-    fail(actual, expected, message, 'deepEqual', assert.deepEqual);
-  }
-};
-
-function _deepEqual(actual, expected) {
-  // 7.1. All identical values are equivalent, as determined by ===.
-  if (actual === expected) {
-    return true;
-
-  } else if (util.isBuffer(actual) && util.isBuffer(expected)) {
-    if (actual.length != expected.length) return false;
-
-    for (var i = 0; i < actual.length; i++) {
-      if (actual[i] !== expected[i]) return false;
-    }
-
-    return true;
-
-  // 7.2. If the expected value is a Date object, the actual value is
-  // equivalent if it is also a Date object that refers to the same time.
-  } else if (util.isDate(actual) && util.isDate(expected)) {
-    return actual.getTime() === expected.getTime();
-
-  // 7.3 If the expected value is a RegExp object, the actual value is
-  // equivalent if it is also a RegExp object with the same source and
-  // properties (`global`, `multiline`, `lastIndex`, `ignoreCase`).
-  } else if (util.isRegExp(actual) && util.isRegExp(expected)) {
-    return actual.source === expected.source &&
-           actual.global === expected.global &&
-           actual.multiline === expected.multiline &&
-           actual.lastIndex === expected.lastIndex &&
-           actual.ignoreCase === expected.ignoreCase;
-
-  // 7.4. Other pairs that do not both pass typeof value == 'object',
-  // equivalence is determined by ==.
-  } else if (!util.isObject(actual) && !util.isObject(expected)) {
-    return actual == expected;
-
-  // 7.5 For all other Object pairs, including Array objects, equivalence is
-  // determined by having the same number of owned properties (as verified
-  // with Object.prototype.hasOwnProperty.call), the same set of keys
-  // (although not necessarily the same order), equivalent values for every
-  // corresponding key, and an identical 'prototype' property. Note: this
-  // accounts for both named and indexed properties on Arrays.
-  } else {
-    return objEquiv(actual, expected);
-  }
-}
-
-function isArguments(object) {
-  return Object.prototype.toString.call(object) == '[object Arguments]';
-}
-
-function objEquiv(a, b) {
-  if (util.isNullOrUndefined(a) || util.isNullOrUndefined(b))
-    return false;
-  // an identical 'prototype' property.
-  if (a.prototype !== b.prototype) return false;
-  // if one is a primitive, the other must be same
-  if (util.isPrimitive(a) || util.isPrimitive(b)) {
-    return a === b;
-  }
-  var aIsArgs = isArguments(a),
-      bIsArgs = isArguments(b);
-  if ((aIsArgs && !bIsArgs) || (!aIsArgs && bIsArgs))
-    return false;
-  if (aIsArgs) {
-    a = pSlice.call(a);
-    b = pSlice.call(b);
-    return _deepEqual(a, b);
-  }
-  var ka = objectKeys(a),
-      kb = objectKeys(b),
-      key, i;
-  // having the same number of owned properties (keys incorporates
-  // hasOwnProperty)
-  if (ka.length != kb.length)
-    return false;
-  //the same set of keys (although not necessarily the same order),
-  ka.sort();
-  kb.sort();
-  //~~~cheap key test
-  for (i = ka.length - 1; i >= 0; i--) {
-    if (ka[i] != kb[i])
-      return false;
-  }
-  //equivalent values for every corresponding key, and
-  //~~~possibly expensive deep test
-  for (i = ka.length - 1; i >= 0; i--) {
-    key = ka[i];
-    if (!_deepEqual(a[key], b[key])) return false;
-  }
-  return true;
-}
-
-// 8. The non-equivalence assertion tests for any deep inequality.
-// assert.notDeepEqual(actual, expected, message_opt);
-
-assert.notDeepEqual = function notDeepEqual(actual, expected, message) {
-  if (_deepEqual(actual, expected)) {
-    fail(actual, expected, message, 'notDeepEqual', assert.notDeepEqual);
-  }
-};
-
-// 9. The strict equality assertion tests strict equality, as determined by ===.
-// assert.strictEqual(actual, expected, message_opt);
-
-assert.strictEqual = function strictEqual(actual, expected, message) {
-  if (actual !== expected) {
-    fail(actual, expected, message, '===', assert.strictEqual);
-  }
-};
-
-// 10. The strict non-equality assertion tests for strict inequality, as
-// determined by !==.  assert.notStrictEqual(actual, expected, message_opt);
-
-assert.notStrictEqual = function notStrictEqual(actual, expected, message) {
-  if (actual === expected) {
-    fail(actual, expected, message, '!==', assert.notStrictEqual);
-  }
-};
-
-function expectedException(actual, expected) {
-  if (!actual || !expected) {
-    return false;
-  }
-
-  if (Object.prototype.toString.call(expected) == '[object RegExp]') {
-    return expected.test(actual);
-  } else if (actual instanceof expected) {
-    return true;
-  } else if (expected.call({}, actual) === true) {
-    return true;
-  }
-
-  return false;
-}
-
-function _throws(shouldThrow, block, expected, message) {
-  var actual;
-
-  if (util.isString(expected)) {
-    message = expected;
-    expected = null;
-  }
-
-  try {
-    block();
-  } catch (e) {
-    actual = e;
-  }
-
-  message = (expected && expected.name ? ' (' + expected.name + ').' : '.') +
-            (message ? ' ' + message : '.');
-
-  if (shouldThrow && !actual) {
-    fail(actual, expected, 'Missing expected exception' + message);
-  }
-
-  if (!shouldThrow && expectedException(actual, expected)) {
-    fail(actual, expected, 'Got unwanted exception' + message);
-  }
-
-  if ((shouldThrow && actual && expected &&
-      !expectedException(actual, expected)) || (!shouldThrow && actual)) {
-    throw actual;
-  }
-}
-
-// 11. Expected to throw an error:
-// assert.throws(block, Error_opt, message_opt);
-
-assert.throws = function(block, /*optional*/error, /*optional*/message) {
-  _throws.apply(this, [true].concat(pSlice.call(arguments)));
-};
-
-// EXTENSION! This is annoying to write outside this module.
-assert.doesNotThrow = function(block, /*optional*/message) {
-  _throws.apply(this, [false].concat(pSlice.call(arguments)));
-};
-
-assert.ifError = function(err) { if (err) {throw err;}};
-
-var objectKeys = Object.keys || function (obj) {
-  var keys = [];
-  for (var key in obj) {
-    if (hasOwn.call(obj, key)) keys.push(key);
-  }
-  return keys;
-};
-
-},{"util/":28}],10:[function(require,module,exports){
-'use strict';
-module.exports = balanced;
-function balanced(a, b, str) {
-  if (a instanceof RegExp) a = maybeMatch(a, str);
-  if (b instanceof RegExp) b = maybeMatch(b, str);
-
-  var r = range(a, b, str);
-
-  return r && {
-    start: r[0],
-    end: r[1],
-    pre: str.slice(0, r[0]),
-    body: str.slice(r[0] + a.length, r[1]),
-    post: str.slice(r[1] + b.length)
-  };
-}
-
-function maybeMatch(reg, str) {
-  var m = str.match(reg);
-  return m ? m[0] : null;
-}
-
-balanced.range = range;
-function range(a, b, str) {
-  var begs, beg, left, right, result;
-  var ai = str.indexOf(a);
-  var bi = str.indexOf(b, ai + 1);
-  var i = ai;
-
-  if (ai >= 0 && bi > 0) {
-    begs = [];
-    left = str.length;
-
-    while (i >= 0 && !result) {
-      if (i == ai) {
-        begs.push(i);
-        ai = str.indexOf(a, i + 1);
-      } else if (begs.length == 1) {
-        result = [ begs.pop(), bi ];
-      } else {
-        beg = begs.pop();
-        if (beg < left) {
-          left = beg;
-          right = bi;
-        }
-
-        bi = str.indexOf(b, i + 1);
-      }
-
-      i = ai < bi && ai >= 0 ? ai : bi;
-    }
-
-    if (begs.length) {
-      result = [ left, right ];
-    }
-  }
-
-  return result;
-}
-
-},{}],11:[function(require,module,exports){
-var concatMap = require('concat-map');
-var balanced = require('balanced-match');
-
-module.exports = expandTop;
-
-var escSlash = '\0SLASH'+Math.random()+'\0';
-var escOpen = '\0OPEN'+Math.random()+'\0';
-var escClose = '\0CLOSE'+Math.random()+'\0';
-var escComma = '\0COMMA'+Math.random()+'\0';
-var escPeriod = '\0PERIOD'+Math.random()+'\0';
-
-function numeric(str) {
-  return parseInt(str, 10) == str
-    ? parseInt(str, 10)
-    : str.charCodeAt(0);
-}
-
-function escapeBraces(str) {
-  return str.split('\\\\').join(escSlash)
-            .split('\\{').join(escOpen)
-            .split('\\}').join(escClose)
-            .split('\\,').join(escComma)
-            .split('\\.').join(escPeriod);
-}
-
-function unescapeBraces(str) {
-  return str.split(escSlash).join('\\')
-            .split(escOpen).join('{')
-            .split(escClose).join('}')
-            .split(escComma).join(',')
-            .split(escPeriod).join('.');
-}
-
-
-// Basically just str.split(","), but handling cases
-// where we have nested braced sections, which should be
-// treated as individual members, like {a,{b,c},d}
-function parseCommaParts(str) {
-  if (!str)
-    return [''];
-
-  var parts = [];
-  var m = balanced('{', '}', str);
-
-  if (!m)
-    return str.split(',');
-
-  var pre = m.pre;
-  var body = m.body;
-  var post = m.post;
-  var p = pre.split(',');
-
-  p[p.length-1] += '{' + body + '}';
-  var postParts = parseCommaParts(post);
-  if (post.length) {
-    p[p.length-1] += postParts.shift();
-    p.push.apply(p, postParts);
-  }
-
-  parts.push.apply(parts, p);
-
-  return parts;
-}
-
-function expandTop(str) {
-  if (!str)
-    return [];
-
-  // I don't know why Bash 4.3 does this, but it does.
-  // Anything starting with {} will have the first two bytes preserved
-  // but *only* at the top level, so {},a}b will not expand to anything,
-  // but a{},b}c will be expanded to [a}c,abc].
-  // One could argue that this is a bug in Bash, but since the goal of
-  // this module is to match Bash's rules, we escape a leading {}
-  if (str.substr(0, 2) === '{}') {
-    str = '\\{\\}' + str.substr(2);
-  }
-
-  return expand(escapeBraces(str), true).map(unescapeBraces);
-}
-
-function identity(e) {
-  return e;
-}
-
-function embrace(str) {
-  return '{' + str + '}';
-}
-function isPadded(el) {
-  return /^-?0\d/.test(el);
-}
-
-function lte(i, y) {
-  return i <= y;
-}
-function gte(i, y) {
-  return i >= y;
-}
-
-function expand(str, isTop) {
-  var expansions = [];
-
-  var m = balanced('{', '}', str);
-  if (!m || /\$$/.test(m.pre)) return [str];
-
-  var isNumericSequence = /^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(m.body);
-  var isAlphaSequence = /^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(m.body);
-  var isSequence = isNumericSequence || isAlphaSequence;
-  var isOptions = m.body.indexOf(',') >= 0;
-  if (!isSequence && !isOptions) {
-    // {a},b}
-    if (m.post.match(/,.*\}/)) {
-      str = m.pre + '{' + m.body + escClose + m.post;
-      return expand(str);
-    }
-    return [str];
-  }
-
-  var n;
-  if (isSequence) {
-    n = m.body.split(/\.\./);
-  } else {
-    n = parseCommaParts(m.body);
-    if (n.length === 1) {
-      // x{{a,b}}y ==> x{a}y x{b}y
-      n = expand(n[0], false).map(embrace);
-      if (n.length === 1) {
-        var post = m.post.length
-          ? expand(m.post, false)
-          : [''];
-        return post.map(function(p) {
-          return m.pre + n[0] + p;
-        });
-      }
-    }
-  }
-
-  // at this point, n is the parts, and we know it's not a comma set
-  // with a single entry.
-
-  // no need to expand pre, since it is guaranteed to be free of brace-sets
-  var pre = m.pre;
-  var post = m.post.length
-    ? expand(m.post, false)
-    : [''];
-
-  var N;
-
-  if (isSequence) {
-    var x = numeric(n[0]);
-    var y = numeric(n[1]);
-    var width = Math.max(n[0].length, n[1].length)
-    var incr = n.length == 3
-      ? Math.abs(numeric(n[2]))
-      : 1;
-    var test = lte;
-    var reverse = y < x;
-    if (reverse) {
-      incr *= -1;
-      test = gte;
-    }
-    var pad = n.some(isPadded);
-
-    N = [];
-
-    for (var i = x; test(i, y); i += incr) {
-      var c;
-      if (isAlphaSequence) {
-        c = String.fromCharCode(i);
-        if (c === '\\')
-          c = '';
-      } else {
-        c = String(i);
-        if (pad) {
-          var need = width - c.length;
-          if (need > 0) {
-            var z = new Array(need + 1).join('0');
-            if (i < 0)
-              c = '-' + z + c.slice(1);
-            else
-              c = z + c;
-          }
-        }
-      }
-      N.push(c);
-    }
-  } else {
-    N = concatMap(n, function(el) { return expand(el, false) });
-  }
-
-  for (var j = 0; j < N.length; j++) {
-    for (var k = 0; k < post.length; k++) {
-      var expansion = pre + N[j] + post[k];
-      if (!isTop || isSequence || expansion)
-        expansions.push(expansion);
-    }
-  }
-
-  return expansions;
-}
-
-
-},{"balanced-match":10,"concat-map":13}],12:[function(require,module,exports){
-
-},{}],13:[function(require,module,exports){
-module.exports = function (xs, fn) {
-    var res = [];
-    for (var i = 0; i < xs.length; i++) {
-        var x = fn(xs[i], i);
-        if (isArray(x)) res.push.apply(res, x);
-        else res.push(x);
-    }
-    return res;
-};
-
-var isArray = Array.isArray || function (xs) {
-    return Object.prototype.toString.call(xs) === '[object Array]';
-};
-
-},{}],14:[function(require,module,exports){
-// Copyright Joyent, Inc. and other Node contributors.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a
-// copy of this software and associated documentation files (the
-// "Software"), to deal in the Software without restriction, including
-// without limitation the rights to use, copy, modify, merge, publish,
-// distribute, sublicense, and/or sell copies of the Software, and to permit
-// persons to whom the Software is furnished to do so, subject to the
-// following conditions:
-//
-// The above copyright notice and this permission notice shall be included
-// in all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
-// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
-// USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-function EventEmitter() {
-  this._events = this._events || {};
-  this._maxListeners = this._maxListeners || undefined;
-}
-module.exports = EventEmitter;
-
-// Backwards-compat with node 0.10.x
-EventEmitter.EventEmitter = EventEmitter;
-
-EventEmitter.prototype._events = undefined;
-EventEmitter.prototype._maxListeners = undefined;
-
-// By default EventEmitters will print a warning if more than 10 listeners are
-// added to it. This is a useful default which helps finding memory leaks.
-EventEmitter.defaultMaxListeners = 10;
-
-// Obviously not all Emitters should be limited to 10. This function allows
-// that to be increased. Set to zero for unlimited.
-EventEmitter.prototype.setMaxListeners = function(n) {
-  if (!isNumber(n) || n < 0 || isNaN(n))
-    throw TypeError('n must be a positive number');
-  this._maxListeners = n;
-  return this;
-};
-
-EventEmitter.prototype.emit = function(type) {
-  var er, handler, len, args, i, listeners;
-
-  if (!this._events)
-    this._events = {};
-
-  // If there is no 'error' event listener then throw.
-  if (type === 'error') {
-    if (!this._events.error ||
-        (isObject(this._events.error) && !this._events.error.length)) {
-      er = arguments[1];
-      if (er instanceof Error) {
-        throw er; // Unhandled 'error' event
-      }
-      throw TypeError('Uncaught, unspecified "error" event.');
-    }
-  }
-
-  handler = this._events[type];
-
-  if (isUndefined(handler))
-    return false;
-
-  if (isFunction(handler)) {
-    switch (arguments.length) {
-      // fast cases
-      case 1:
-        handler.call(this);
-        break;
-      case 2:
-        handler.call(this, arguments[1]);
-        break;
-      case 3:
-        handler.call(this, arguments[1], arguments[2]);
-        break;
-      // slower
-      default:
-        len = arguments.length;
-        args = new Array(len - 1);
-        for (i = 1; i < len; i++)
-          args[i - 1] = arguments[i];
-        handler.apply(this, args);
-    }
-  } else if (isObject(handler)) {
-    len = arguments.length;
-    args = new Array(len - 1);
-    for (i = 1; i < len; i++)
-      args[i - 1] = arguments[i];
-
-    listeners = handler.slice();
-    len = listeners.length;
-    for (i = 0; i < len; i++)
-      listeners[i].apply(this, args);
-  }
-
-  return true;
-};
-
-EventEmitter.prototype.addListener = function(type, listener) {
-  var m;
-
-  if (!isFunction(listener))
-    throw TypeError('listener must be a function');
-
-  if (!this._events)
-    this._events = {};
-
-  // To avoid recursion in the case that type === "newListener"! Before
-  // adding it to the listeners, first emit "newListener".
-  if (this._events.newListener)
-    this.emit('newListener', type,
-              isFunction(listener.listener) ?
-              listener.listener : listener);
-
-  if (!this._events[type])
-    // Optimize the case of one listener. Don't need the extra array object.
-    this._events[type] = listener;
-  else if (isObject(this._events[type]))
-    // If we've already got an array, just append.
-    this._events[type].push(listener);
-  else
-    // Adding the second element, need to change to array.
-    this._events[type] = [this._events[type], listener];
-
-  // Check for listener leak
-  if (isObject(this._events[type]) && !this._events[type].warned) {
-    var m;
-    if (!isUndefined(this._maxListeners)) {
-      m = this._maxListeners;
-    } else {
-      m = EventEmitter.defaultMaxListeners;
-    }
-
-    if (m && m > 0 && this._events[type].length > m) {
-      this._events[type].warned = true;
-      console.error('(node) warning: possible EventEmitter memory ' +
-                    'leak detected. %d listeners added. ' +
-                    'Use emitter.setMaxListeners() to increase limit.',
-                    this._events[type].length);
-      if (typeof console.trace === 'function') {
-        // not supported in IE 10
-        console.trace();
-      }
-    }
-  }
-
-  return this;
-};
-
-EventEmitter.prototype.on = EventEmitter.prototype.addListener;
-
-EventEmitter.prototype.once = function(type, listener) {
-  if (!isFunction(listener))
-    throw TypeError('listener must be a function');
-
-  var fired = false;
-
-  function g() {
-    this.removeListener(type, g);
-
-    if (!fired) {
-      fired = true;
-      listener.apply(this, arguments);
-    }
-  }
-
-  g.listener = listener;
-  this.on(type, g);
-
-  return this;
-};
-
-// emits a 'removeListener' event iff the listener was removed
-EventEmitter.prototype.removeListener = function(type, listener) {
-  var list, position, length, i;
-
-  if (!isFunction(listener))
-    throw TypeError('listener must be a function');
-
-  if (!this._events || !this._events[type])
-    return this;
-
-  list = this._events[type];
-  length = list.length;
-  position = -1;
-
-  if (list === listener ||
-      (isFunction(list.listener) && list.listener === listener)) {
-    delete this._events[type];
-    if (this._events.removeListener)
-      this.emit('removeListener', type, listener);
-
-  } else if (isObject(list)) {
-    for (i = length; i-- > 0;) {
-      if (list[i] === listener ||
-          (list[i].listener && list[i].listener === listener)) {
-        position = i;
-        break;
-      }
-    }
-
-    if (position < 0)
-      return this;
-
-    if (list.length === 1) {
-      list.length = 0;
-      delete this._events[type];
-    } else {
-      list.splice(position, 1);
-    }
-
-    if (this._events.removeListener)
-      this.emit('removeListener', type, listener);
-  }
-
-  return this;
-};
-
-EventEmitter.prototype.removeAllListeners = function(type) {
-  var key, listeners;
-
-  if (!this._events)
-    return this;
-
-  // not listening for removeListener, no need to emit
-  if (!this._events.removeListener) {
-    if (arguments.length === 0)
-      this._events = {};
-    else if (this._events[type])
-      delete this._events[type];
-    return this;
-  }
-
-  // emit removeListener for all listeners on all events
-  if (arguments.length === 0) {
-    for (key in this._events) {
-      if (key === 'removeListener') continue;
-      this.removeAllListeners(key);
-    }
-    this.removeAllListeners('removeListener');
-    this._events = {};
-    return this;
-  }
-
-  listeners = this._events[type];
-
-  if (isFunction(listeners)) {
-    this.removeListener(type, listeners);
-  } else {
-    // LIFO order
-    while (listeners.length)
-      this.removeListener(type, listeners[listeners.length - 1]);
-  }
-  delete this._events[type];
-
-  return this;
-};
-
-EventEmitter.prototype.listeners = function(type) {
-  var ret;
-  if (!this._events || !this._events[type])
-    ret = [];
-  else if (isFunction(this._events[type]))
-    ret = [this._events[type]];
-  else
-    ret = this._events[type].slice();
-  return ret;
-};
-
-EventEmitter.listenerCount = function(emitter, type) {
-  var ret;
-  if (!emitter._events || !emitter._events[type])
-    ret = 0;
-  else if (isFunction(emitter._events[type]))
-    ret = 1;
-  else
-    ret = emitter._events[type].length;
-  return ret;
-};
-
-function isFunction(arg) {
-  return typeof arg === 'function';
-}
-
-function isNumber(arg) {
-  return typeof arg === 'number';
-}
-
-function isObject(arg) {
-  return typeof arg === 'object' && arg !== null;
-}
-
-function isUndefined(arg) {
-  return arg === void 0;
-}
-
-},{}],15:[function(require,module,exports){
-(function (process){
-exports.alphasort = alphasort
-exports.alphasorti = alphasorti
-exports.setopts = setopts
-exports.ownProp = ownProp
-exports.makeAbs = makeAbs
-exports.finish = finish
-exports.mark = mark
-exports.isIgnored = isIgnored
-exports.childrenIgnored = childrenIgnored
-
-function ownProp (obj, field) {
-  return Object.prototype.hasOwnProperty.call(obj, field)
-}
-
-var path = require("path")
-var minimatch = require("minimatch")
-var isAbsolute = require("path-is-absolute")
-var Minimatch = minimatch.Minimatch
-
-function alphasorti (a, b) {
-  return a.toLowerCase().localeCompare(b.toLowerCase())
-}
-
-function alphasort (a, b) {
-  return a.localeCompare(b)
-}
-
-function setupIgnores (self, options) {
-  self.ignore = options.ignore || []
-
-  if (!Array.isArray(self.ignore))
-    self.ignore = [self.ignore]
-
-  if (self.ignore.length) {
-    self.ignore = self.ignore.map(ignoreMap)
-  }
-}
-
-function ignoreMap (pattern) {
-  var gmatcher = null
-  if (pattern.slice(-3) === '/**') {
-    var gpattern = pattern.replace(/(\/\*\*)+$/, '')
-    gmatcher = new Minimatch(gpattern)
-  }
-
-  return {
-    matcher: new Minimatch(pattern),
-    gmatcher: gmatcher
-  }
-}
-
-function setopts (self, pattern, options) {
-  if (!options)
-    options = {}
-
-  // base-matching: just use globstar for that.
-  if (options.matchBase && -1 === pattern.indexOf("/")) {
-    if (options.noglobstar) {
-      throw new Error("base matching requires globstar")
-    }
-    pattern = "**/" + pattern
-  }
-
-  self.silent = !!options.silent
-  self.pattern = pattern
-  self.strict = options.strict !== false
-  self.realpath = !!options.realpath
-  self.realpathCache = options.realpathCache || Object.create(null)
-  self.follow = !!options.follow
-  self.dot = !!options.dot
-  self.mark = !!options.mark
-  self.nodir = !!options.nodir
-  if (self.nodir)
-    self.mark = true
-  self.sync = !!options.sync
-  self.nounique = !!options.nounique
-  self.nonull = !!options.nonull
-  self.nosort = !!options.nosort
-  self.nocase = !!options.nocase
-  self.stat = !!options.stat
-  self.noprocess = !!options.noprocess
-
-  self.maxLength = options.maxLength || Infinity
-  self.cache = options.cache || Object.create(null)
-  self.statCache = options.statCache || Object.create(null)
-  self.symlinks = options.symlinks || Object.create(null)
-
-  setupIgnores(self, options)
-
-  self.changedCwd = false
-  var cwd = process.cwd()
-  if (!ownProp(options, "cwd"))
-    self.cwd = cwd
-  else {
-    self.cwd = options.cwd
-    self.changedCwd = path.resolve(options.cwd) !== cwd
-  }
-
-  self.root = options.root || path.resolve(self.cwd, "/")
-  self.root = path.resolve(self.root)
-  if (process.platform === "win32")
-    self.root = self.root.replace(/\\/g, "/")
-
-  self.nomount = !!options.nomount
-
-  // disable comments and negation unless the user explicitly
-  // passes in false as the option.
-  options.nonegate = options.nonegate === false ? false : true
-  options.nocomment = options.nocomment === false ? false : true
-  deprecationWarning(options)
-
-  self.minimatch = new Minimatch(pattern, options)
-  self.options = self.minimatch.options
-}
-
-// TODO(isaacs): remove entirely in v6
-// exported to reset in tests
-exports.deprecationWarned
-function deprecationWarning(options) {
-  if (!options.nonegate || !options.nocomment) {
-    if (process.noDeprecation !== true && !exports.deprecationWarned) {
-      var msg = 'glob WARNING: comments and negation will be disabled in v6'
-      if (process.throwDeprecation)
-        throw new Error(msg)
-      else if (process.traceDeprecation)
-        console.trace(msg)
-      else
-        console.error(msg)
-
-      exports.deprecationWarned = true
-    }
-  }
-}
-
-function finish (self) {
-  var nou = self.nounique
-  var all = nou ? [] : Object.create(null)
-
-  for (var i = 0, l = self.matches.length; i < l; i ++) {
-    var matches = self.matches[i]
-    if (!matches || Object.keys(matches).length === 0) {
-      if (self.nonull) {
-        // do like the shell, and spit out the literal glob
-        var literal = self.minimatch.globSet[i]
-        if (nou)
-          all.push(literal)
-        else
-          all[literal] = true
-      }
-    } else {
-      // had matches
-      var m = Object.keys(matches)
-      if (nou)
-        all.push.apply(all, m)
-      else
-        m.forEach(function (m) {
-          all[m] = true
-        })
-    }
-  }
-
-  if (!nou)
-    all = Object.keys(all)
-
-  if (!self.nosort)
-    all = all.sort(self.nocase ? alphasorti : alphasort)
-
-  // at *some* point we statted all of these
-  if (self.mark) {
-    for (var i = 0; i < all.length; i++) {
-      all[i] = self._mark(all[i])
-    }
-    if (self.nodir) {
-      all = all.filter(function (e) {
-        return !(/\/$/.test(e))
-      })
-    }
-  }
-
-  if (self.ignore.length)
-    all = all.filter(function(m) {
-      return !isIgnored(self, m)
-    })
-
-  self.found = all
-}
-
-function mark (self, p) {
-  var abs = makeAbs(self, p)
-  var c = self.cache[abs]
-  var m = p
-  if (c) {
-    var isDir = c === 'DIR' || Array.isArray(c)
-    var slash = p.slice(-1) === '/'
-
-    if (isDir && !slash)
-      m += '/'
-    else if (!isDir && slash)
-      m = m.slice(0, -1)
-
-    if (m !== p) {
-      var mabs = makeAbs(self, m)
-      self.statCache[mabs] = self.statCache[abs]
-      self.cache[mabs] = self.cache[abs]
-    }
-  }
-
-  return m
-}
-
-// lotta situps...
-function makeAbs (self, f) {
-  var abs = f
-  if (f.charAt(0) === '/') {
-    abs = path.join(self.root, f)
-  } else if (isAbsolute(f) || f === '') {
-    abs = f
-  } else if (self.changedCwd) {
-    abs = path.resolve(self.cwd, f)
-  } else {
-    abs = path.resolve(f)
-  }
-  return abs
-}
-
-
-// Return true, if pattern ends with globstar '**', for the accompanying parent directory.
-// Ex:- If node_modules/** is the pattern, add 'node_modules' to ignore list along with it's contents
-function isIgnored (self, path) {
-  if (!self.ignore.length)
-    return false
-
-  return self.ignore.some(function(item) {
-    return item.matcher.match(path) || !!(item.gmatcher && item.gmatcher.match(path))
-  })
-}
-
-function childrenIgnored (self, path) {
-  if (!self.ignore.length)
-    return false
-
-  return self.ignore.some(function(item) {
-    return !!(item.gmatcher && item.gmatcher.match(path))
-  })
-}
-
-}).call(this,require('_process'))
-},{"_process":24,"minimatch":20,"path":22,"path-is-absolute":23}],16:[function(require,module,exports){
-(function (process){
-// Approach:
-//
-// 1. Get the minimatch set
-// 2. For each pattern in the set, PROCESS(pattern, false)
-// 3. Store matches per-set, then uniq them
-//
-// PROCESS(pattern, inGlobStar)
-// Get the first [n] items from pattern that are all strings
-// Join these together.  This is PREFIX.
-//   If there is no more remaining, then stat(PREFIX) and
-//   add to matches if it succeeds.  END.
-//
-// If inGlobStar and PREFIX is symlink and points to dir
-//   set ENTRIES = []
-// else readdir(PREFIX) as ENTRIES
-//   If fail, END
-//
-// with ENTRIES
-//   If pattern[n] is GLOBSTAR
-//     // handle the case where the globstar match is empty
-//     // by pruning it out, and testing the resulting pattern
-//     PROCESS(pattern[0..n] + pattern[n+1 .. $], false)
-//     // handle other cases.
-//     for ENTRY in ENTRIES (not dotfiles)
-//       // attach globstar + tail onto the entry
-//       // Mark that this entry is a globstar match
-//       PROCESS(pattern[0..n] + ENTRY + pattern[n .. $], true)
-//
-//   else // not globstar
-//     for ENTRY in ENTRIES (not dotfiles, unless pattern[n] is dot)
-//       Test ENTRY against pattern[n]
-//       If fails, continue
-//       If passes, PROCESS(pattern[0..n] + item + pattern[n+1 .. $])
-//
-// Caveat:
-//   Cache all stats and readdirs results to minimize syscall.  Since all
-//   we ever care about is existence and directory-ness, we can just keep
-//   `true` for files, and [children,...] for directories, or `false` for
-//   things that don't exist.
-
-module.exports = glob
-
-var fs = require('fs')
-var minimatch = require('minimatch')
-var Minimatch = minimatch.Minimatch
-var inherits = require('inherits')
-var EE = require('events').EventEmitter
-var path = require('path')
-var assert = require('assert')
-var isAbsolute = require('path-is-absolute')
-var globSync = require('./sync.js')
-var common = require('./common.js')
-var alphasort = common.alphasort
-var alphasorti = common.alphasorti
-var setopts = common.setopts
-var ownProp = common.ownProp
-var inflight = require('inflight')
-var util = require('util')
-var childrenIgnored = common.childrenIgnored
-var isIgnored = common.isIgnored
-
-var once = require('once')
-
-function glob (pattern, options, cb) {
-  if (typeof options === 'function') cb = options, options = {}
-  if (!options) options = {}
-
-  if (options.sync) {
-    if (cb)
-      throw new TypeError('callback provided to sync glob')
-    return globSync(pattern, options)
-  }
-
-  return new Glob(pattern, options, cb)
-}
-
-glob.sync = globSync
-var GlobSync = glob.GlobSync = globSync.GlobSync
-
-// old api surface
-glob.glob = glob
-
-glob.hasMagic = function (pattern, options_) {
-  var options = util._extend({}, options_)
-  options.noprocess = true
-
-  var g = new Glob(pattern, options)
-  var set = g.minimatch.set
-  if (set.length > 1)
-    return true
-
-  for (var j = 0; j < set[0].length; j++) {
-    if (typeof set[0][j] !== 'string')
-      return true
-  }
-
-  return false
-}
-
-glob.Glob = Glob
-inherits(Glob, EE)
-function Glob (pattern, options, cb) {
-  if (typeof options === 'function') {
-    cb = options
-    options = null
-  }
-
-  if (options && options.sync) {
-    if (cb)
-      throw new TypeError('callback provided to sync glob')
-    return new GlobSync(pattern, options)
-  }
-
-  if (!(this instanceof Glob))
-    return new Glob(pattern, options, cb)
-
-  setopts(this, pattern, options)
-  this._didRealPath = false
-
-  // process each pattern in the minimatch set
-  var n = this.minimatch.set.length
-
-  // The matches are stored as {<filename>: true,...} so that
-  // duplicates are automagically pruned.
-  // Later, we do an Object.keys() on these.
-  // Keep them as a list so we can fill in when nonull is set.
-  this.matches = new Array(n)
-
-  if (typeof cb === 'function') {
-    cb = once(cb)
-    this.on('error', cb)
-    this.on('end', function (matches) {
-      cb(null, matches)
-    })
-  }
-
-  var self = this
-  var n = this.minimatch.set.length
-  this._processing = 0
-  this.matches = new Array(n)
-
-  this._emitQueue = []
-  this._processQueue = []
-  this.paused = false
-
-  if (this.noprocess)
-    return this
-
-  if (n === 0)
-    return done()
-
-  for (var i = 0; i < n; i ++) {
-    this._process(this.minimatch.set[i], i, false, done)
-  }
-
-  function done () {
-    --self._processing
-    if (self._processing <= 0)
-      self._finish()
-  }
-}
-
-Glob.prototype._finish = function () {
-  assert(this instanceof Glob)
-  if (this.aborted)
-    return
-
-  if (this.realpath && !this._didRealpath)
-    return this._realpath()
-
-  common.finish(this)
-  this.emit('end', this.found)
-}
-
-Glob.prototype._realpath = function () {
-  if (this._didRealpath)
-    return
-
-  this._didRealpath = true
-
-  var n = this.matches.length
-  if (n === 0)
-    return this._finish()
-
-  var self = this
-  for (var i = 0; i < this.matches.length; i++)
-    this._realpathSet(i, next)
-
-  function next () {
-    if (--n === 0)
-      self._finish()
-  }
-}
-
-Glob.prototype._realpathSet = function (index, cb) {
-  var matchset = this.matches[index]
-  if (!matchset)
-    return cb()
-
-  var found = Object.keys(matchset)
-  var self = this
-  var n = found.length
-
-  if (n === 0)
-    return cb()
-
-  var set = this.matches[index] = Object.create(null)
-  found.forEach(function (p, i) {
-    // If there's a problem with the stat, then it means that
-    // one or more of the links in the realpath couldn't be
-    // resolved.  just return the abs value in that case.
-    p = self._makeAbs(p)
-    fs.realpath(p, self.realpathCache, function (er, real) {
-      if (!er)
-        set[real] = true
-      else if (er.syscall === 'stat')
-        set[p] = true
-      else
-        self.emit('error', er) // srsly wtf right here
-
-      if (--n === 0) {
-        self.matches[index] = set
-        cb()
-      }
-    })
-  })
-}
-
-Glob.prototype._mark = function (p) {
-  return common.mark(this, p)
-}
-
-Glob.prototype._makeAbs = function (f) {
-  return common.makeAbs(this, f)
-}
-
-Glob.prototype.abort = function () {
-  this.aborted = true
-  this.emit('abort')
-}
-
-Glob.prototype.pause = function () {
-  if (!this.paused) {
-    this.paused = true
-    this.emit('pause')
-  }
-}
-
-Glob.prototype.resume = function () {
-  if (this.paused) {
-    this.emit('resume')
-    this.paused = false
-    if (this._emitQueue.length) {
-      var eq = this._emitQueue.slice(0)
-      this._emitQueue.length = 0
-      for (var i = 0; i < eq.length; i ++) {
-        var e = eq[i]
-        this._emitMatch(e[0], e[1])
-      }
-    }
-    if (this._processQueue.length) {
-      var pq = this._processQueue.slice(0)
-      this._processQueue.length = 0
-      for (var i = 0; i < pq.length; i ++) {
-        var p = pq[i]
-        this._processing--
-        this._process(p[0], p[1], p[2], p[3])
-      }
-    }
-  }
-}
-
-Glob.prototype._process = function (pattern, index, inGlobStar, cb) {
-  assert(this instanceof Glob)
-  assert(typeof cb === 'function')
-
-  if (this.aborted)
-    return
-
-  this._processing++
-  if (this.paused) {
-    this._processQueue.push([pattern, index, inGlobStar, cb])
-    return
-  }
-
-  //console.error('PROCESS %d', this._processing, pattern)
-
-  // Get the first [n] parts of pattern that are all strings.
-  var n = 0
-  while (typeof pattern[n] === 'string') {
-    n ++
-  }
-  // now n is the index of the first one that is *not* a string.
-
-  // see if there's anything else
-  var prefix
-  switch (n) {
-    // if not, then this is rather simple
-    case pattern.length:
-      this._processSimple(pattern.join('/'), index, cb)
-      return
-
-    case 0:
-      // pattern *starts* with some non-trivial item.
-      // going to readdir(cwd), but not include the prefix in matches.
-      prefix = null
-      break
-
-    default:
-      // pattern has some string bits in the front.
-      // whatever it starts with, whether that's 'absolute' like /foo/bar,
-      // or 'relative' like '../baz'
-      prefix = pattern.slice(0, n).join('/')
-      break
-  }
-
-  var remain = pattern.slice(n)
-
-  // get the list of entries.
-  var read
-  if (prefix === null)
-    read = '.'
-  else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) {
-    if (!prefix || !isAbsolute(prefix))
-      prefix = '/' + prefix
-    read = prefix
-  } else
-    read = prefix
-
-  var abs = this._makeAbs(read)
-
-  //if ignored, skip _processing
-  if (childrenIgnored(this, read))
-    return cb()
-
-  var isGlobStar = remain[0] === minimatch.GLOBSTAR
-  if (isGlobStar)
-    this._processGlobStar(prefix, read, abs, remain, index, inGlobStar, cb)
-  else
-    this._processReaddir(prefix, read, abs, remain, index, inGlobStar, cb)
-}
-
-Glob.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar, cb) {
-  var self = this
-  this._readdir(abs, inGlobStar, function (er, entries) {
-    return self._processReaddir2(prefix, read, abs, remain, index, inGlobStar, entries, cb)
-  })
-}
-
-Glob.prototype._processReaddir2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) {
-
-  // if the abs isn't a dir, then nothing can match!
-  if (!entries)
-    return cb()
-
-  // It will only match dot entries if it starts with a dot, or if
-  // dot is set.  Stuff like @(.foo|.bar) isn't allowed.
-  var pn = remain[0]
-  var negate = !!this.minimatch.negate
-  var rawGlob = pn._glob
-  var dotOk = this.dot || rawGlob.charAt(0) === '.'
-
-  var matchedEntries = []
-  for (var i = 0; i < entries.length; i++) {
-    var e = entries[i]
-    if (e.charAt(0) !== '.' || dotOk) {
-      var m
-      if (negate && !prefix) {
-        m = !e.match(pn)
-      } else {
-        m = e.match(pn)
-      }
-      if (m)
-        matchedEntries.push(e)
-    }
-  }
-
-  //console.error('prd2', prefix, entries, remain[0]._glob, matchedEntries)
-
-  var len = matchedEntries.length
-  // If there are no matched entries, then nothing matches.
-  if (len === 0)
-    return cb()
-
-  // if this is the last remaining pattern bit, then no need for
-  // an additional stat *unless* the user has specified mark or
-  // stat explicitly.  We know they exist, since readdir returned
-  // them.
-
-  if (remain.length === 1 && !this.mark && !this.stat) {
-    if (!this.matches[index])
-      this.matches[index] = Object.create(null)
-
-    for (var i = 0; i < len; i ++) {
-      var e = matchedEntries[i]
-      if (prefix) {
-        if (prefix !== '/')
-          e = prefix + '/' + e
-        else
-          e = prefix + e
-      }
-
-      if (e.charAt(0) === '/' && !this.nomount) {
-        e = path.join(this.root, e)
-      }
-      this._emitMatch(index, e)
-    }
-    // This was the last one, and no stats were needed
-    return cb()
-  }
-
-  // now test all matched entries as stand-ins for that part
-  // of the pattern.
-  remain.shift()
-  for (var i = 0; i < len; i ++) {
-    var e = matchedEntries[i]
-    var newPattern
-    if (prefix) {
-      if (prefix !== '/')
-        e = prefix + '/' + e
-      else
-        e = prefix + e
-    }
-    this._process([e].concat(remain), index, inGlobStar, cb)
-  }
-  cb()
-}
-
-Glob.prototype._emitMatch = function (index, e) {
-  if (this.aborted)
-    return
-
-  if (this.matches[index][e])
-    return
-
-  if (isIgnored(this, e))
-    return
-
-  if (this.paused) {
-    this._emitQueue.push([index, e])
-    return
-  }
-
-  var abs = this._makeAbs(e)
-
-  if (this.nodir) {
-    var c = this.cache[abs]
-    if (c === 'DIR' || Array.isArray(c))
-      return
-  }
-
-  if (this.mark)
-    e = this._mark(e)
-
-  this.matches[index][e] = true
-
-  var st = this.statCache[abs]
-  if (st)
-    this.emit('stat', e, st)
-
-  this.emit('match', e)
-}
-
-Glob.prototype._readdirInGlobStar = function (abs, cb) {
-  if (this.aborted)
-    return
-
-  // follow all symlinked directories forever
-  // just proceed as if this is a non-globstar situation
-  if (this.follow)
-    return this._readdir(abs, false, cb)
-
-  var lstatkey = 'lstat\0' + abs
-  var self = this
-  var lstatcb = inflight(lstatkey, lstatcb_)
-
-  if (lstatcb)
-    fs.lstat(abs, lstatcb)
-
-  function lstatcb_ (er, lstat) {
-    if (er)
-      return cb()
-
-    var isSym = lstat.isSymbolicLink()
-    self.symlinks[abs] = isSym
-
-    // If it's not a symlink or a dir, then it's definitely a regular file.
-    // don't bother doing a readdir in that case.
-    if (!isSym && !lstat.isDirectory()) {
-      self.cache[abs] = 'FILE'
-      cb()
-    } else
-      self._readdir(abs, false, cb)
-  }
-}
-
-Glob.prototype._readdir = function (abs, inGlobStar, cb) {
-  if (this.aborted)
-    return
-
-  cb = inflight('readdir\0'+abs+'\0'+inGlobStar, cb)
-  if (!cb)
-    return
-
-  //console.error('RD %j %j', +inGlobStar, abs)
-  if (inGlobStar && !ownProp(this.symlinks, abs))
-    return this._readdirInGlobStar(abs, cb)
-
-  if (ownProp(this.cache, abs)) {
-    var c = this.cache[abs]
-    if (!c || c === 'FILE')
-      return cb()
-
-    if (Array.isArray(c))
-      return cb(null, c)
-  }
-
-  var self = this
-  fs.readdir(abs, readdirCb(this, abs, cb))
-}
-
-function readdirCb (self, abs, cb) {
-  return function (er, entries) {
-    if (er)
-      self._readdirError(abs, er, cb)
-    else
-      self._readdirEntries(abs, entries, cb)
-  }
-}
-
-Glob.prototype._readdirEntries = function (abs, entries, cb) {
-  if (this.aborted)
-    return
-
-  // if we haven't asked to stat everything, then just
-  // assume that everything in there exists, so we can avoid
-  // having to stat it a second time.
-  if (!this.mark && !this.stat) {
-    for (var i = 0; i < entries.length; i ++) {
-      var e = entries[i]
-      if (abs === '/')
-        e = abs + e
-      else
-        e = abs + '/' + e
-      this.cache[e] = true
-    }
-  }
-
-  this.cache[abs] = entries
-  return cb(null, entries)
-}
-
-Glob.prototype._readdirError = function (f, er, cb) {
-  if (this.aborted)
-    return
-
-  // handle errors, and cache the information
-  switch (er.code) {
-    case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205
-    case 'ENOTDIR': // totally normal. means it *does* exist.
-      this.cache[this._makeAbs(f)] = 'FILE'
-      break
-
-    case 'ENOENT': // not terribly unusual
-    case 'ELOOP':
-    case 'ENAMETOOLONG':
-    case 'UNKNOWN':
-      this.cache[this._makeAbs(f)] = false
-      break
-
-    default: // some unusual error.  Treat as failure.
-      this.cache[this._makeAbs(f)] = false
-      if (this.strict) {
-        this.emit('error', er)
-        // If the error is handled, then we abort
-        // if not, we threw out of here
-        this.abort()
-      }
-      if (!this.silent)
-        console.error('glob error', er)
-      break
-  }
-
-  return cb()
-}
-
-Glob.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar, cb) {
-  var self = this
-  this._readdir(abs, inGlobStar, function (er, entries) {
-    self._processGlobStar2(prefix, read, abs, remain, index, inGlobStar, entries, cb)
-  })
-}
-
-
-Glob.prototype._processGlobStar2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) {
-  //console.error('pgs2', prefix, remain[0], entries)
-
-  // no entries means not a dir, so it can never have matches
-  // foo.txt/** doesn't match foo.txt
-  if (!entries)
-    return cb()
-
-  // test without the globstar, and with every child both below
-  // and replacing the globstar.
-  var remainWithoutGlobStar = remain.slice(1)
-  var gspref = prefix ? [ prefix ] : []
-  var noGlobStar = gspref.concat(remainWithoutGlobStar)
-
-  // the noGlobStar pattern exits the inGlobStar state
-  this._process(noGlobStar, index, false, cb)
-
-  var isSym = this.symlinks[abs]
-  var len = entries.length
-
-  // If it's a symlink, and we're in a globstar, then stop
-  if (isSym && inGlobStar)
-    return cb()
-
-  for (var i = 0; i < len; i++) {
-    var e = entries[i]
-    if (e.charAt(0) === '.' && !this.dot)
-      continue
-
-    // these two cases enter the inGlobStar state
-    var instead = gspref.concat(entries[i], remainWithoutGlobStar)
-    this._process(instead, index, true, cb)
-
-    var below = gspref.concat(entries[i], remain)
-    this._process(below, index, true, cb)
-  }
-
-  cb()
-}
-
-Glob.prototype._processSimple = function (prefix, index, cb) {
-  // XXX review this.  Shouldn't it be doing the mounting etc
-  // before doing stat?  kinda weird?
-  var self = this
-  this._stat(prefix, function (er, exists) {
-    self._processSimple2(prefix, index, er, exists, cb)
-  })
-}
-Glob.prototype._processSimple2 = function (prefix, index, er, exists, cb) {
-
-  //console.error('ps2', prefix, exists)
-
-  if (!this.matches[index])
-    this.matches[index] = Object.create(null)
-
-  // If it doesn't exist, then just mark the lack of results
-  if (!exists)
-    return cb()
-
-  if (prefix && isAbsolute(prefix) && !this.nomount) {
-    var trail = /[\/\\]$/.test(prefix)
-    if (prefix.charAt(0) === '/') {
-      prefix = path.join(this.root, prefix)
-    } else {
-      prefix = path.resolve(this.root, prefix)
-      if (trail)
-        prefix += '/'
-    }
-  }
-
-  if (process.platform === 'win32')
-    prefix = prefix.replace(/\\/g, '/')
-
-  // Mark this as a match
-  this._emitMatch(index, prefix)
-  cb()
-}
-
-// Returns either 'DIR', 'FILE', or false
-Glob.prototype._stat = function (f, cb) {
-  var abs = this._makeAbs(f)
-  var needDir = f.slice(-1) === '/'
-
-  if (f.length > this.maxLength)
-    return cb()
-
-  if (!this.stat && ownProp(this.cache, abs)) {
-    var c = this.cache[abs]
-
-    if (Array.isArray(c))
-      c = 'DIR'
-
-    // It exists, but maybe not how we need it
-    if (!needDir || c === 'DIR')
-      return cb(null, c)
-
-    if (needDir && c === 'FILE')
-      return cb()
-
-    // otherwise we have to stat, because maybe c=true
-    // if we know it exists, but not what it is.
-  }
-
-  var exists
-  var stat = this.statCache[abs]
-  if (stat !== undefined) {
-    if (stat === false)
-      return cb(null, stat)
-    else {
-      var type = stat.isDirectory() ? 'DIR' : 'FILE'
-      if (needDir && type === 'FILE')
-        return cb()
-      else
-        return cb(null, type, stat)
-    }
-  }
-
-  var self = this
-  var statcb = inflight('stat\0' + abs, lstatcb_)
-  if (statcb)
-    fs.lstat(abs, statcb)
-
-  function lstatcb_ (er, lstat) {
-    if (lstat && lstat.isSymbolicLink()) {
-      // If it's a symlink, then treat it as the target, unless
-      // the target does not exist, then treat it as a file.
-      return fs.stat(abs, function (er, stat) {
-        if (er)
-          self._stat2(f, abs, null, lstat, cb)
-        else
-          self._stat2(f, abs, er, stat, cb)
-      })
-    } else {
-      self._stat2(f, abs, er, lstat, cb)
-    }
-  }
-}
-
-Glob.prototype._stat2 = function (f, abs, er, stat, cb) {
-  if (er) {
-    this.statCache[abs] = false
-    return cb()
-  }
-
-  var needDir = f.slice(-1) === '/'
-  this.statCache[abs] = stat
-
-  if (abs.slice(-1) === '/' && !stat.isDirectory())
-    return cb(null, false, stat)
-
-  var c = stat.isDirectory() ? 'DIR' : 'FILE'
-  this.cache[abs] = this.cache[abs] || c
-
-  if (needDir && c !== 'DIR')
-    return cb()
-
-  return cb(null, c, stat)
-}
-
-}).call(this,require('_process'))
-},{"./common.js":15,"./sync.js":17,"_process":24,"assert":9,"events":14,"fs":12,"inflight":18,"inherits":19,"minimatch":20,"once":21,"path":22,"path-is-absolute":23,"util":28}],17:[function(require,module,exports){
-(function (process){
-module.exports = globSync
-globSync.GlobSync = GlobSync
-
-var fs = require('fs')
-var minimatch = require('minimatch')
-var Minimatch = minimatch.Minimatch
-var Glob = require('./glob.js').Glob
-var util = require('util')
-var path = require('path')
-var assert = require('assert')
-var isAbsolute = require('path-is-absolute')
-var common = require('./common.js')
-var alphasort = common.alphasort
-var alphasorti = common.alphasorti
-var setopts = common.setopts
-var ownProp = common.ownProp
-var childrenIgnored = common.childrenIgnored
-
-function globSync (pattern, options) {
-  if (typeof options === 'function' || arguments.length === 3)
-    throw new TypeError('callback provided to sync glob\n'+
-                        'See: https://github.com/isaacs/node-glob/issues/167')
-
-  return new GlobSync(pattern, options).found
-}
-
-function GlobSync (pattern, options) {
-  if (!pattern)
-    throw new Error('must provide pattern')
-
-  if (typeof options === 'function' || arguments.length === 3)
-    throw new TypeError('callback provided to sync glob\n'+
-                        'See: https://github.com/isaacs/node-glob/issues/167')
-
-  if (!(this instanceof GlobSync))
-    return new GlobSync(pattern, options)
-
-  setopts(this, pattern, options)
-
-  if (this.noprocess)
-    return this
-
-  var n = this.minimatch.set.length
-  this.matches = new Array(n)
-  for (var i = 0; i < n; i ++) {
-    this._process(this.minimatch.set[i], i, false)
-  }
-  this._finish()
-}
-
-GlobSync.prototype._finish = function () {
-  assert(this instanceof GlobSync)
-  if (this.realpath) {
-    var self = this
-    this.matches.forEach(function (matchset, index) {
-      var set = self.matches[index] = Object.create(null)
-      for (var p in matchset) {
-        try {
-          p = self._makeAbs(p)
-          var real = fs.realpathSync(p, self.realpathCache)
-          set[real] = true
-        } catch (er) {
-          if (er.syscall === 'stat')
-            set[self._makeAbs(p)] = true
-          else
-            throw er
-        }
-      }
-    })
-  }
-  common.finish(this)
-}
-
-
-GlobSync.prototype._process = function (pattern, index, inGlobStar) {
-  assert(this instanceof GlobSync)
-
-  // Get the first [n] parts of pattern that are all strings.
-  var n = 0
-  while (typeof pattern[n] === 'string') {
-    n ++
-  }
-  // now n is the index of the first one that is *not* a string.
-
-  // See if there's anything else
-  var prefix
-  switch (n) {
-    // if not, then this is rather simple
-    case pattern.length:
-      this._processSimple(pattern.join('/'), index)
-      return
-
-    case 0:
-      // pattern *starts* with some non-trivial item.
-      // going to readdir(cwd), but not include the prefix in matches.
-      prefix = null
-      break
-
-    default:
-      // pattern has some string bits in the front.
-      // whatever it starts with, whether that's 'absolute' like /foo/bar,
-      // or 'relative' like '../baz'
-      prefix = pattern.slice(0, n).join('/')
-      break
-  }
-
-  var remain = pattern.slice(n)
-
-  // get the list of entries.
-  var read
-  if (prefix === null)
-    read = '.'
-  else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) {
-    if (!prefix || !isAbsolute(prefix))
-      prefix = '/' + prefix
-    read = prefix
-  } else
-    read = prefix
-
-  var abs = this._makeAbs(read)
-
-  //if ignored, skip processing
-  if (childrenIgnored(this, read))
-    return
-
-  var isGlobStar = remain[0] === minimatch.GLOBSTAR
-  if (isGlobStar)
-    this._processGlobStar(prefix, read, abs, remain, index, inGlobStar)
-  else
-    this._processReaddir(prefix, read, abs, remain, index, inGlobStar)
-}
-
-
-GlobSync.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar) {
-  var entries = this._readdir(abs, inGlobStar)
-
-  // if the abs isn't a dir, then nothing can match!
-  if (!entries)
-    return
-
-  // It will only match dot entries if it starts with a dot, or if
-  // dot is set.  Stuff like @(.foo|.bar) isn't allowed.
-  var pn = remain[0]
-  var negate = !!this.minimatch.negate
-  var rawGlob = pn._glob
-  var dotOk = this.dot || rawGlob.charAt(0) === '.'
-
-  var matchedEntries = []
-  for (var i = 0; i < entries.length; i++) {
-    var e = entries[i]
-    if (e.charAt(0) !== '.' || dotOk) {
-      var m
-      if (negate && !prefix) {
-        m = !e.match(pn)
-      } else {
-        m = e.match(pn)
-      }
-      if (m)
-        matchedEntries.push(e)
-    }
-  }
-
-  var len = matchedEntries.length
-  // If there are no matched entries, then nothing matches.
-  if (len === 0)
-    return
-
-  // if this is the last remaining pattern bit, then no need for
-  // an additional stat *unless* the user has specified mark or
-  // stat explicitly.  We know they exist, since readdir returned
-  // them.
-
-  if (remain.length === 1 && !this.mark && !this.stat) {
-    if (!this.matches[index])
-      this.matches[index] = Object.create(null)
-
-    for (var i = 0; i < len; i ++) {
-      var e = matchedEntries[i]
-      if (prefix) {
-        if (prefix.slice(-1) !== '/')
-          e = prefix + '/' + e
-        else
-          e = prefix + e
-      }
-
-      if (e.charAt(0) === '/' && !this.nomount) {
-        e = path.join(this.root, e)
-      }
-      this.matches[index][e] = true
-    }
-    // This was the last one, and no stats were needed
-    return
-  }
-
-  // now test all matched entries as stand-ins for that part
-  // of the pattern.
-  remain.shift()
-  for (var i = 0; i < len; i ++) {
-    var e = matchedEntries[i]
-    var newPattern
-    if (prefix)
-      newPattern = [prefix, e]
-    else
-      newPattern = [e]
-    this._process(newPattern.concat(remain), index, inGlobStar)
-  }
-}
-
-
-GlobSync.prototype._emitMatch = function (index, e) {
-  var abs = this._makeAbs(e)
-  if (this.mark)
-    e = this._mark(e)
-
-  if (this.matches[index][e])
-    return
-
-  if (this.nodir) {
-    var c = this.cache[this._makeAbs(e)]
-    if (c === 'DIR' || Array.isArray(c))
-      return
-  }
-
-  this.matches[index][e] = true
-  if (this.stat)
-    this._stat(e)
-}
-
-
-GlobSync.prototype._readdirInGlobStar = function (abs) {
-  // follow all symlinked directories forever
-  // just proceed as if this is a non-globstar situation
-  if (this.follow)
-    return this._readdir(abs, false)
-
-  var entries
-  var lstat
-  var stat
-  try {
-    lstat = fs.lstatSync(abs)
-  } catch (er) {
-    // lstat failed, doesn't exist
-    return null
-  }
-
-  var isSym = lstat.isSymbolicLink()
-  this.symlinks[abs] = isSym
-
-  // If it's not a symlink or a dir, then it's definitely a regular file.
-  // don't bother doing a readdir in that case.
-  if (!isSym && !lstat.isDirectory())
-    this.cache[abs] = 'FILE'
-  else
-    entries = this._readdir(abs, false)
-
-  return entries
-}
-
-GlobSync.prototype._readdir = function (abs, inGlobStar) {
-  var entries
-
-  if (inGlobStar && !ownProp(this.symlinks, abs))
-    return this._readdirInGlobStar(abs)
-
-  if (ownProp(this.cache, abs)) {
-    var c = this.cache[abs]
-    if (!c || c === 'FILE')
-      return null
-
-    if (Array.isArray(c))
-      return c
-  }
-
-  try {
-    return this._readdirEntries(abs, fs.readdirSync(abs))
-  } catch (er) {
-    this._readdirError(abs, er)
-    return null
-  }
-}
-
-GlobSync.prototype._readdirEntries = function (abs, entries) {
-  // if we haven't asked to stat everything, then just
-  // assume that everything in there exists, so we can avoid
-  // having to stat it a second time.
-  if (!this.mark && !this.stat) {
-    for (var i = 0; i < entries.length; i ++) {
-      var e = entries[i]
-      if (abs === '/')
-        e = abs + e
-      else
-        e = abs + '/' + e
-      this.cache[e] = true
-    }
-  }
-
-  this.cache[abs] = entries
-
-  // mark and cache dir-ness
-  return entries
-}
-
-GlobSync.prototype._readdirError = function (f, er) {
-  // handle errors, and cache the information
-  switch (er.code) {
-    case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205
-    case 'ENOTDIR': // totally normal. means it *does* exist.
-      this.cache[this._makeAbs(f)] = 'FILE'
-      break
-
-    case 'ENOENT': // not terribly unusual
-    case 'ELOOP':
-    case 'ENAMETOOLONG':
-    case 'UNKNOWN':
-      this.cache[this._makeAbs(f)] = false
-      break
-
-    default: // some unusual error.  Treat as failure.
-      this.cache[this._makeAbs(f)] = false
-      if (this.strict)
-        throw er
-      if (!this.silent)
-        console.error('glob error', er)
-      break
-  }
-}
-
-GlobSync.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar) {
-
-  var entries = this._readdir(abs, inGlobStar)
-
-  // no entries means not a dir, so it can never have matches
-  // foo.txt/** doesn't match foo.txt
-  if (!entries)
-    return
-
-  // test without the globstar, and with every child both below
-  // and replacing the globstar.
-  var remainWithoutGlobStar = remain.slice(1)
-  var gspref = prefix ? [ prefix ] : []
-  var noGlobStar = gspref.concat(remainWithoutGlobStar)
-
-  // the noGlobStar pattern exits the inGlobStar state
-  this._process(noGlobStar, index, false)
-
-  var len = entries.length
-  var isSym = this.symlinks[abs]
-
-  // If it's a symlink, and we're in a globstar, then stop
-  if (isSym && inGlobStar)
-    return
-
-  for (var i = 0; i < len; i++) {
-    var e = entries[i]
-    if (e.charAt(0) === '.' && !this.dot)
-      continue
-
-    // these two cases enter the inGlobStar state
-    var instead = gspref.concat(entries[i], remainWithoutGlobStar)
-    this._process(instead, index, true)
-
-    var below = gspref.concat(entries[i], remain)
-    this._process(below, index, true)
-  }
-}
-
-GlobSync.prototype._processSimple = function (prefix, index) {
-  // XXX review this.  Shouldn't it be doing the mounting etc
-  // before doing stat?  kinda weird?
-  var exists = this._stat(prefix)
-
-  if (!this.matches[index])
-    this.matches[index] = Object.create(null)
-
-  // If it doesn't exist, then just mark the lack of results
-  if (!exists)
-    return
-
-  if (prefix && isAbsolute(prefix) && !this.nomount) {
-    var trail = /[\/\\]$/.test(prefix)
-    if (prefix.charAt(0) === '/') {
-      prefix = path.join(this.root, prefix)
-    } else {
-      prefix = path.resolve(this.root, prefix)
-      if (trail)
-        prefix += '/'
-    }
-  }
-
-  if (process.platform === 'win32')
-    prefix = prefix.replace(/\\/g, '/')
-
-  // Mark this as a match
-  this.matches[index][prefix] = true
-}
-
-// Returns either 'DIR', 'FILE', or false
-GlobSync.prototype._stat = function (f) {
-  var abs = this._makeAbs(f)
-  var needDir = f.slice(-1) === '/'
-
-  if (f.length > this.maxLength)
-    return false
-
-  if (!this.stat && ownProp(this.cache, abs)) {
-    var c = this.cache[abs]
-
-    if (Array.isArray(c))
-      c = 'DIR'
-
-    // It exists, but maybe not how we need it
-    if (!needDir || c === 'DIR')
-      return c
-
-    if (needDir && c === 'FILE')
-      return false
-
-    // otherwise we have to stat, because maybe c=true
-    // if we know it exists, but not what it is.
-  }
-
-  var exists
-  var stat = this.statCache[abs]
-  if (!stat) {
-    var lstat
-    try {
-      lstat = fs.lstatSync(abs)
-    } catch (er) {
-      return false
-    }
-
-    if (lstat.isSymbolicLink()) {
-      try {
-        stat = fs.statSync(abs)
-      } catch (er) {
-        stat = lstat
-      }
-    } else {
-      stat = lstat
-    }
-  }
-
-  this.statCache[abs] = stat
-
-  var c = stat.isDirectory() ? 'DIR' : 'FILE'
-  this.cache[abs] = this.cache[abs] || c
-
-  if (needDir && c !== 'DIR')
-    return false
-
-  return c
-}
-
-GlobSync.prototype._mark = function (p) {
-  return common.mark(this, p)
-}
-
-GlobSync.prototype._makeAbs = function (f) {
-  return common.makeAbs(this, f)
-}
-
-}).call(this,require('_process'))
-},{"./common.js":15,"./glob.js":16,"_process":24,"assert":9,"fs":12,"minimatch":20,"path":22,"path-is-absolute":23,"util":28}],18:[function(require,module,exports){
-(function (process){
-var wrappy = require('wrappy')
-var reqs = Object.create(null)
-var once = require('once')
-
-module.exports = wrappy(inflight)
-
-function inflight (key, cb) {
-  if (reqs[key]) {
-    reqs[key].push(cb)
-    return null
-  } else {
-    reqs[key] = [cb]
-    return makeres(key)
-  }
-}
-
-function makeres (key) {
-  return once(function RES () {
-    var cbs = reqs[key]
-    var len = cbs.length
-    var args = slice(arguments)
-
-    // XXX It's somewhat ambiguous whether a new callback added in this
-    // pass should be queued for later execution if something in the
-    // list of callbacks throws, or if it should just be discarded.
-    // However, it's such an edge case that it hardly matters, and either
-    // choice is likely as surprising as the other.
-    // As it happens, we do go ahead and schedule it for later execution.
-    try {
-      for (var i = 0; i < len; i++) {
-        cbs[i].apply(null, args)
-      }
-    } finally {
-      if (cbs.length > len) {
-        // added more in the interim.
-        // de-zalgo, just in case, but don't call again.
-        cbs.splice(0, len)
-        process.nextTick(function () {
-          RES.apply(null, args)
-        })
-      } else {
-        delete reqs[key]
-      }
-    }
-  })
-}
-
-function slice (args) {
-  var length = args.length
-  var array = []
-
-  for (var i = 0; i < length; i++) array[i] = args[i]
-  return array
-}
-
-}).call(this,require('_process'))
-},{"_process":24,"once":21,"wrappy":29}],19:[function(require,module,exports){
-if (typeof Object.create === 'function') {
-  // implementation from standard node.js 'util' module
-  module.exports = function inherits(ctor, superCtor) {
-    ctor.super_ = superCtor
-    ctor.prototype = Object.create(superCtor.prototype, {
-      constructor: {
-        value: ctor,
-        enumerable: false,
-        writable: true,
-        configurable: true
-      }
-    });
-  };
-} else {
-  // old school shim for old browsers
-  module.exports = function inherits(ctor, superCtor) {
-    ctor.super_ = superCtor
-    var TempCtor = function () {}
-    TempCtor.prototype = superCtor.prototype
-    ctor.prototype = new TempCtor()
-    ctor.prototype.constructor = ctor
-  }
-}
-
-},{}],20:[function(require,module,exports){
-module.exports = minimatch
-minimatch.Minimatch = Minimatch
-
-var path = { sep: '/' }
-try {
-  path = require('path')
-} catch (er) {}
-
-var GLOBSTAR = minimatch.GLOBSTAR = Minimatch.GLOBSTAR = {}
-var expand = require('brace-expansion')
-
-var plTypes = {
-  '!': { open: '(?:(?!(?:', close: '))[^/]*?)'},
-  '?': { open: '(?:', close: ')?' },
-  '+': { open: '(?:', close: ')+' },
-  '*': { open: '(?:', close: ')*' },
-  '@': { open: '(?:', close: ')' }
-}
-
-// any single thing other than /
-// don't need to escape / when using new RegExp()
-var qmark = '[^/]'
-
-// * => any number of characters
-var star = qmark + '*?'
-
-// ** when dots are allowed.  Anything goes, except .. and .
-// not (^ or / followed by one or two dots followed by $ or /),
-// followed by anything, any number of times.
-var twoStarDot = '(?:(?!(?:\\\/|^)(?:\\.{1,2})($|\\\/)).)*?'
-
-// not a ^ or / followed by a dot,
-// followed by anything, any number of times.
-var twoStarNoDot = '(?:(?!(?:\\\/|^)\\.).)*?'
-
-// characters that need to be escaped in RegExp.
-var reSpecials = charSet('().*{}+?[]^$\\!')
-
-// "abc" -> { a:true, b:true, c:true }
-function charSet (s) {
-  return s.split('').reduce(function (set, c) {
-    set[c] = true
-    return set
-  }, {})
-}
-
-// normalizes slashes.
-var slashSplit = /\/+/
-
-minimatch.filter = filter
-function filter (pattern, options) {
-  options = options || {}
-  return function (p, i, list) {
-    return minimatch(p, pattern, options)
-  }
-}
-
-function ext (a, b) {
-  a = a || {}
-  b = b || {}
-  var t = {}
-  Object.keys(b).forEach(function (k) {
-    t[k] = b[k]
-  })
-  Object.keys(a).forEach(function (k) {
-    t[k] = a[k]
-  })
-  return t
-}
-
-minimatch.defaults = function (def) {
-  if (!def || !Object.keys(def).length) return minimatch
-
-  var orig = minimatch
-
-  var m = function minimatch (p, pattern, options) {
-    return orig.minimatch(p, pattern, ext(def, options))
-  }
-
-  m.Minimatch = function Minimatch (pattern, options) {
-    return new orig.Minimatch(pattern, ext(def, options))
-  }
-
-  return m
-}
-
-Minimatch.defaults = function (def) {
-  if (!def || !Object.keys(def).length) return Minimatch
-  return minimatch.defaults(def).Minimatch
-}
-
-function minimatch (p, pattern, options) {
-  if (typeof pattern !== 'string') {
-    throw new TypeError('glob pattern string required')
-  }
-
-  if (!options) options = {}
-
-  // shortcut: comments match nothing.
-  if (!options.nocomment && pattern.charAt(0) === '#') {
-    return false
-  }
-
-  // "" only matches ""
-  if (pattern.trim() === '') return p === ''
-
-  return new Minimatch(pattern, options).match(p)
-}
-
-function Minimatch (pattern, options) {
-  if (!(this instanceof Minimatch)) {
-    return new Minimatch(pattern, options)
-  }
-
-  if (typeof pattern !== 'string') {
-    throw new TypeError('glob pattern string required')
-  }
-
-  if (!options) options = {}
-  pattern = pattern.trim()
-
-  // windows support: need to use /, not \
-  if (path.sep !== '/') {
-    pattern = pattern.split(path.sep).join('/')
-  }
-
-  this.options = options
-  this.set = []
-  this.pattern = pattern
-  this.regexp = null
-  this.negate = false
-  this.comment = false
-  this.empty = false
-
-  // make the set of regexps etc.
-  this.make()
-}
-
-Minimatch.prototype.debug = function () {}
-
-Minimatch.prototype.make = make
-function make () {
-  // don't do it more than once.
-  if (this._made) return
-
-  var pattern = this.pattern
-  var options = this.options
-
-  // empty patterns and comments match nothing.
-  if (!options.nocomment && pattern.charAt(0) === '#') {
-    this.comment = true
-    return
-  }
-  if (!pattern) {
-    this.empty = true
-    return
-  }
-
-  // step 1: figure out negation, etc.
-  this.parseNegate()
-
-  // step 2: expand braces
-  var set = this.globSet = this.braceExpand()
-
-  if (options.debug) this.debug = console.error
-
-  this.debug(this.pattern, set)
-
-  // step 3: now we have a set, so turn each one into a series of path-portion
-  // matching patterns.
-  // These will be regexps, except in the case of "**", which is
-  // set to the GLOBSTAR object for globstar behavior,
-  // and will not contain any / characters
-  set = this.globParts = set.map(function (s) {
-    return s.split(slashSplit)
-  })
-
-  this.debug(this.pattern, set)
-
-  // glob --> regexps
-  set = set.map(function (s, si, set) {
-    return s.map(this.parse, this)
-  }, this)
-
-  this.debug(this.pattern, set)
-
-  // filter out everything that didn't compile properly.
-  set = set.filter(function (s) {
-    return s.indexOf(false) === -1
-  })
-
-  this.debug(this.pattern, set)
-
-  this.set = set
-}
-
-Minimatch.prototype.parseNegate = parseNegate
-function parseNegate () {
-  var pattern = this.pattern
-  var negate = false
-  var options = this.options
-  var negateOffset = 0
-
-  if (options.nonegate) return
-
-  for (var i = 0, l = pattern.length
-    ; i < l && pattern.charAt(i) === '!'
-    ; i++) {
-    negate = !negate
-    negateOffset++
-  }
-
-  if (negateOffset) this.pattern = pattern.substr(negateOffset)
-  this.negate = negate
-}
-
-// Brace expansion:
-// a{b,c}d -> abd acd
-// a{b,}c -> abc ac
-// a{0..3}d -> a0d a1d a2d a3d
-// a{b,c{d,e}f}g -> abg acdfg acefg
-// a{b,c}d{e,f}g -> abdeg acdeg abdeg abdfg
-//
-// Invalid sets are not expanded.
-// a{2..}b -> a{2..}b
-// a{b}c -> a{b}c
-minimatch.braceExpand = function (pattern, options) {
-  return braceExpand(pattern, options)
-}
-
-Minimatch.prototype.braceExpand = braceExpand
-
-function braceExpand (pattern, options) {
-  if (!options) {
-    if (this instanceof Minimatch) {
-      options = this.options
-    } else {
-      options = {}
-    }
-  }
-
-  pattern = typeof pattern === 'undefined'
-    ? this.pattern : pattern
-
-  if (typeof pattern === 'undefined') {
-    throw new TypeError('undefined pattern')
-  }
-
-  if (options.nobrace ||
-    !pattern.match(/\{.*\}/)) {
-    // shortcut. no need to expand.
-    return [pattern]
-  }
-
-  return expand(pattern)
-}
-
-// parse a component of the expanded set.
-// At this point, no pattern may contain "/" in it
-// so we're going to return a 2d array, where each entry is the full
-// pattern, split on '/', and then turned into a regular expression.
-// A regexp is made at the end which joins each array with an
-// escaped /, and another full one which joins each regexp with |.
-//
-// Following the lead of Bash 4.1, note that "**" only has special meaning
-// when it is the *only* thing in a path portion.  Otherwise, any series
-// of * is equivalent to a single *.  Globstar behavior is enabled by
-// default, and can be disabled by setting options.noglobstar.
-Minimatch.prototype.parse = parse
-var SUBPARSE = {}
-function parse (pattern, isSub) {
-  if (pattern.length > 1024 * 64) {
-    throw new TypeError('pattern is too long')
-  }
-
-  var options = this.options
-
-  // shortcuts
-  if (!options.noglobstar && pattern === '**') return GLOBSTAR
-  if (pattern === '') return ''
-
-  var re = ''
-  var hasMagic = !!options.nocase
-  var escaping = false
-  // ? => one single character
-  var patternListStack = []
-  var negativeLists = []
-  var stateChar
-  var inClass = false
-  var reClassStart = -1
-  var classStart = -1
-  // . and .. never match anything that doesn't start with .,
-  // even when options.dot is set.
-  var patternStart = pattern.charAt(0) === '.' ? '' // anything
-  // not (start or / followed by . or .. followed by / or end)
-  : options.dot ? '(?!(?:^|\\\/)\\.{1,2}(?:$|\\\/))'
-  : '(?!\\.)'
-  var self = this
-
-  function clearStateChar () {
-    if (stateChar) {
-      // we had some state-tracking character
-      // that wasn't consumed by this pass.
-      switch (stateChar) {
-        case '*':
-          re += star
-          hasMagic = true
-        break
-        case '?':
-          re += qmark
-          hasMagic = true
-        break
-        default:
-          re += '\\' + stateChar
-        break
-      }
-      self.debug('clearStateChar %j %j', stateChar, re)
-      stateChar = false
-    }
-  }
-
-  for (var i = 0, len = pattern.length, c
-    ; (i < len) && (c = pattern.charAt(i))
-    ; i++) {
-    this.debug('%s\t%s %s %j', pattern, i, re, c)
-
-    // skip over any that are escaped.
-    if (escaping && reSpecials[c]) {
-      re += '\\' + c
-      escaping = false
-      continue
-    }
-
-    switch (c) {
-      case '/':
-        // completely not allowed, even escaped.
-        // Should already be path-split by now.
-        return false
-
-      case '\\':
-        clearStateChar()
-        escaping = true
-      continue
-
-      // the various stateChar values
-      // for the "extglob" stuff.
-      case '?':
-      case '*':
-      case '+':
-      case '@':
-      case '!':
-        this.debug('%s\t%s %s %j <-- stateChar', pattern, i, re, c)
-
-        // all of those are literals inside a class, except that
-        // the glob [!a] means [^a] in regexp
-        if (inClass) {
-          this.debug('  in class')
-          if (c === '!' && i === classStart + 1) c = '^'
-          re += c
-          continue
-        }
-
-        // if we already have a stateChar, then it means
-        // that there was something like ** or +? in there.
-        // Handle the stateChar, then proceed with this one.
-        self.debug('call clearStateChar %j', stateChar)
-        clearStateChar()
-        stateChar = c
-        // if extglob is disabled, then +(asdf|foo) isn't a thing.
-        // just clear the statechar *now*, rather than even diving into
-        // the patternList stuff.
-        if (options.noext) clearStateChar()
-      continue
-
-      case '(':
-        if (inClass) {
-          re += '('
-          continue
-        }
-
-        if (!stateChar) {
-          re += '\\('
-          continue
-        }
-
-        patternListStack.push({
-          type: stateChar,
-          start: i - 1,
-          reStart: re.length,
-          open: plTypes[stateChar].open,
-          close: plTypes[stateChar].close
-        })
-        // negation is (?:(?!js)[^/]*)
-        re += stateChar === '!' ? '(?:(?!(?:' : '(?:'
-        this.debug('plType %j %j', stateChar, re)
-        stateChar = false
-      continue
-
-      case ')':
-        if (inClass || !patternListStack.length) {
-          re += '\\)'
-          continue
-        }
-
-        clearStateChar()
-        hasMagic = true
-        var pl = patternListStack.pop()
-        // negation is (?:(?!js)[^/]*)
-        // The others are (?:<pattern>)<type>
-        re += pl.close
-        if (pl.type === '!') {
-          negativeLists.push(pl)
-        }
-        pl.reEnd = re.length
-      continue
-
-      case '|':
-        if (inClass || !patternListStack.length || escaping) {
-          re += '\\|'
-          escaping = false
-          continue
-        }
-
-        clearStateChar()
-        re += '|'
-      continue
-
-      // these are mostly the same in regexp and glob
-      case '[':
-        // swallow any state-tracking char before the [
-        clearStateChar()
-
-        if (inClass) {
-          re += '\\' + c
-          continue
-        }
-
-        inClass = true
-        classStart = i
-        reClassStart = re.length
-        re += c
-      continue
-
-      case ']':
-        //  a right bracket shall lose its special
-        //  meaning and represent itself in
-        //  a bracket expression if it occurs
-        //  first in the list.  -- POSIX.2 2.8.3.2
-        if (i === classStart + 1 || !inClass) {
-          re += '\\' + c
-          escaping = false
-          continue
-        }
-
-        // handle the case where we left a class open.
-        // "[z-a]" is valid, equivalent to "\[z-a\]"
-        if (inClass) {
-          // split where the last [ was, make sure we don't have
-          // an invalid re. if so, re-walk the contents of the
-          // would-be class to re-translate any characters that
-          // were passed through as-is
-          // TODO: It would probably be faster to determine this
-          // without a try/catch and a new RegExp, but it's tricky
-          // to do safely.  For now, this is safe and works.
-          var cs = pattern.substring(classStart + 1, i)
-          try {
-            RegExp('[' + cs + ']')
-          } catch (er) {
-            // not a valid class!
-            var sp = this.parse(cs, SUBPARSE)
-            re = re.substr(0, reClassStart) + '\\[' + sp[0] + '\\]'
-            hasMagic = hasMagic || sp[1]
-            inClass = false
-            continue
-          }
-        }
-
-        // finish up the class.
-        hasMagic = true
-        inClass = false
-        re += c
-      continue
-
-      default:
-        // swallow any state char that wasn't consumed
-        clearStateChar()
-
-        if (escaping) {
-          // no need
-          escaping = false
-        } else if (reSpecials[c]
-          && !(c === '^' && inClass)) {
-          re += '\\'
-        }
-
-        re += c
-
-    } // switch
-  } // for
-
-  // handle the case where we left a class open.
-  // "[abc" is valid, equivalent to "\[abc"
-  if (inClass) {
-    // split where the last [ was, and escape it
-    // this is a huge pita.  We now have to re-walk
-    // the contents of the would-be class to re-translate
-    // any characters that were passed through as-is
-    cs = pattern.substr(classStart + 1)
-    sp = this.parse(cs, SUBPARSE)
-    re = re.substr(0, reClassStart) + '\\[' + sp[0]
-    hasMagic = hasMagic || sp[1]
-  }
-
-  // handle the case where we had a +( thing at the *end*
-  // of the pattern.
-  // each pattern list stack adds 3 chars, and we need to go through
-  // and escape any | chars that were passed through as-is for the regexp.
-  // Go through and escape them, taking care not to double-escape any
-  // | chars that were already escaped.
-  for (pl = patternListStack.pop(); pl; pl = patternListStack.pop()) {
-    var tail = re.slice(pl.reStart + pl.open.length)
-    this.debug('setting tail', re, pl)
-    // maybe some even number of \, then maybe 1 \, followed by a |
-    tail = tail.replace(/((?:\\{2}){0,64})(\\?)\|/g, function (_, $1, $2) {
-      if (!$2) {
-        // the | isn't already escaped, so escape it.
-        $2 = '\\'
-      }
-
-      // need to escape all those slashes *again*, without escaping the
-      // one that we need for escaping the | character.  As it works out,
-      // escaping an even number of slashes can be done by simply repeating
-      // it exactly after itself.  That's why this trick works.
-      //
-      // I am sorry that you have to see this.
-      return $1 + $1 + $2 + '|'
-    })
-
-    this.debug('tail=%j\n   %s', tail, tail, pl, re)
-    var t = pl.type === '*' ? star
-      : pl.type === '?' ? qmark
-      : '\\' + pl.type
-
-    hasMagic = true
-    re = re.slice(0, pl.reStart) + t + '\\(' + tail
-  }
-
-  // handle trailing things that only matter at the very end.
-  clearStateChar()
-  if (escaping) {
-    // trailing \\
-    re += '\\\\'
-  }
-
-  // only need to apply the nodot start if the re starts with
-  // something that could conceivably capture a dot
-  var addPatternStart = false
-  switch (re.charAt(0)) {
-    case '.':
-    case '[':
-    case '(': addPatternStart = true
-  }
-
-  // Hack to work around lack of negative lookbehind in JS
-  // A pattern like: *.!(x).!(y|z) needs to ensure that a name
-  // like 'a.xyz.yz' doesn't match.  So, the first negative
-  // lookahead, has to look ALL the way ahead, to the end of
-  // the pattern.
-  for (var n = negativeLists.length - 1; n > -1; n--) {
-    var nl = negativeLists[n]
-
-    var nlBefore = re.slice(0, nl.reStart)
-    var nlFirst = re.slice(nl.reStart, nl.reEnd - 8)
-    var nlLast = re.slice(nl.reEnd - 8, nl.reEnd)
-    var nlAfter = re.slice(nl.reEnd)
-
-    nlLast += nlAfter
-
-    // Handle nested stuff like *(*.js|!(*.json)), where open parens
-    // mean that we should *not* include the ) in the bit that is considered
-    // "after" the negated section.
-    var openParensBefore = nlBefore.split('(').length - 1
-    var cleanAfter = nlAfter
-    for (i = 0; i < openParensBefore; i++) {
-      cleanAfter = cleanAfter.replace(/\)[+*?]?/, '')
-    }
-    nlAfter = cleanAfter
-
-    var dollar = ''
-    if (nlAfter === '' && isSub !== SUBPARSE) {
-      dollar = '$'
-    }
-    var newRe = nlBefore + nlFirst + nlAfter + dollar + nlLast
-    re = newRe
-  }
-
-  // if the re is not "" at this point, then we need to make sure
-  // it doesn't match against an empty path part.
-  // Otherwise a/* will match a/, which it should not.
-  if (re !== '' && hasMagic) {
-    re = '(?=.)' + re
-  }
-
-  if (addPatternStart) {
-    re = patternStart + re
-  }
-
-  // parsing just a piece of a larger pattern.
-  if (isSub === SUBPARSE) {
-    return [re, hasMagic]
-  }
-
-  // skip the regexp for non-magical patterns
-  // unescape anything in it, though, so that it'll be
-  // an exact match against a file etc.
-  if (!hasMagic) {
-    return globUnescape(pattern)
-  }
-
-  var flags = options.nocase ? 'i' : ''
-  try {
-    var regExp = new RegExp('^' + re + '$', flags)
-  } catch (er) {
-    // If it was an invalid regular expression, then it can't match
-    // anything.  This trick looks for a character after the end of
-    // the string, which is of course impossible, except in multi-line
-    // mode, but it's not a /m regex.
-    return new RegExp('$.')
-  }
-
-  regExp._glob = pattern
-  regExp._src = re
-
-  return regExp
-}
-
-minimatch.makeRe = function (pattern, options) {
-  return new Minimatch(pattern, options || {}).makeRe()
-}
-
-Minimatch.prototype.makeRe = makeRe
-function makeRe () {
-  if (this.regexp || this.regexp === false) return this.regexp
-
-  // at this point, this.set is a 2d array of partial
-  // pattern strings, or "**".
-  //
-  // It's better to use .match().  This function shouldn't
-  // be used, really, but it's pretty convenient sometimes,
-  // when you just want to work with a regex.
-  var set = this.set
-
-  if (!set.length) {
-    this.regexp = false
-    return this.regexp
-  }
-  var options = this.options
-
-  var twoStar = options.noglobstar ? star
-    : options.dot ? twoStarDot
-    : twoStarNoDot
-  var flags = options.nocase ? 'i' : ''
-
-  var re = set.map(function (pattern) {
-    return pattern.map(function (p) {
-      return (p === GLOBSTAR) ? twoStar
-      : (typeof p === 'string') ? regExpEscape(p)
-      : p._src
-    }).join('\\\/')
-  }).join('|')
-
-  // must match entire pattern
-  // ending in a * or ** will make it less strict.
-  re = '^(?:' + re + ')$'
-
-  // can match anything, as long as it's not this.
-  if (this.negate) re = '^(?!' + re + ').*$'
-
-  try {
-    this.regexp = new RegExp(re, flags)
-  } catch (ex) {
-    this.regexp = false
-  }
-  return this.regexp
-}
-
-minimatch.match = function (list, pattern, options) {
-  options = options || {}
-  var mm = new Minimatch(pattern, options)
-  list = list.filter(function (f) {
-    return mm.match(f)
-  })
-  if (mm.options.nonull && !list.length) {
-    list.push(pattern)
-  }
-  return list
-}
-
-Minimatch.prototype.match = match
-function match (f, partial) {
-  this.debug('match', f, this.pattern)
-  // short-circuit in the case of busted things.
-  // comments, etc.
-  if (this.comment) return false
-  if (this.empty) return f === ''
-
-  if (f === '/' && partial) return true
-
-  var options = this.options
-
-  // windows: need to use /, not \
-  if (path.sep !== '/') {
-    f = f.split(path.sep).join('/')
-  }
-
-  // treat the test path as a set of pathparts.
-  f = f.split(slashSplit)
-  this.debug(this.pattern, 'split', f)
-
-  // just ONE of the pattern sets in this.set needs to match
-  // in order for it to be valid.  If negating, then just one
-  // match means that we have failed.
-  // Either way, return on the first hit.
-
-  var set = this.set
-  this.debug(this.pattern, 'set', set)
-
-  // Find the basename of the path by looking for the last non-empty segment
-  var filename
-  var i
-  for (i = f.length - 1; i >= 0; i--) {
-    filename = f[i]
-    if (filename) break
-  }
-
-  for (i = 0; i < set.length; i++) {
-    var pattern = set[i]
-    var file = f
-    if (options.matchBase && pattern.length === 1) {
-      file = [filename]
-    }
-    var hit = this.matchOne(file, pattern, partial)
-    if (hit) {
-      if (options.flipNegate) return true
-      return !this.negate
-    }
-  }
-
-  // didn't get any hits.  this is success if it's a negative
-  // pattern, failure otherwise.
-  if (options.flipNegate) return false
-  return this.negate
-}
-
-// set partial to true to test if, for example,
-// "/a/b" matches the start of "/*/b/*/d"
-// Partial means, if you run out of file before you run
-// out of pattern, then that's fine, as long as all
-// the parts match.
-Minimatch.prototype.matchOne = function (file, pattern, partial) {
-  var options = this.options
-
-  this.debug('matchOne',
-    { 'this': this, file: file, pattern: pattern })
-
-  this.debug('matchOne', file.length, pattern.length)
-
-  for (var fi = 0,
-      pi = 0,
-      fl = file.length,
-      pl = pattern.length
-      ; (fi < fl) && (pi < pl)
-      ; fi++, pi++) {
-    this.debug('matchOne loop')
-    var p = pattern[pi]
-    var f = file[fi]
-
-    this.debug(pattern, p, f)
-
-    // should be impossible.
-    // some invalid regexp stuff in the set.
-    if (p === false) return false
-
-    if (p === GLOBSTAR) {
-      this.debug('GLOBSTAR', [pattern, p, f])
-
-      // "**"
-      // a/**/b/**/c would match the following:
-      // a/b/x/y/z/c
-      // a/x/y/z/b/c
-      // a/b/x/b/x/c
-      // a/b/c
-      // To do this, take the rest of the pattern after
-      // the **, and see if it would match the file remainder.
-      // If so, return success.
-      // If not, the ** "swallows" a segment, and try again.
-      // This is recursively awful.
-      //
-      // a/**/b/**/c matching a/b/x/y/z/c
-      // - a matches a
-      // - doublestar
-      //   - matchOne(b/x/y/z/c, b/**/c)
-      //     - b matches b
-      //     - doublestar
-      //       - matchOne(x/y/z/c, c) -> no
-      //       - matchOne(y/z/c, c) -> no
-      //       - matchOne(z/c, c) -> no
-      //       - matchOne(c, c) yes, hit
-      var fr = fi
-      var pr = pi + 1
-      if (pr === pl) {
-        this.debug('** at the end')
-        // a ** at the end will just swallow the rest.
-        // We have found a match.
-        // however, it will not swallow /.x, unless
-        // options.dot is set.
-        // . and .. are *never* matched by **, for explosively
-        // exponential reasons.
-        for (; fi < fl; fi++) {
-          if (file[fi] === '.' || file[fi] === '..' ||
-            (!options.dot && file[fi].charAt(0) === '.')) return false
-        }
-        return true
-      }
-
-      // ok, let's see if we can swallow whatever we can.
-      while (fr < fl) {
-        var swallowee = file[fr]
-
-        this.debug('\nglobstar while', file, fr, pattern, pr, swallowee)
-
-        // XXX remove this slice.  Just pass the start index.
-        if (this.matchOne(file.slice(fr), pattern.slice(pr), partial)) {
-          this.debug('globstar found match!', fr, fl, swallowee)
-          // found a match.
-          return true
-        } else {
-          // can't swallow "." or ".." ever.
-          // can only swallow ".foo" when explicitly asked.
-          if (swallowee === '.' || swallowee === '..' ||
-            (!options.dot && swallowee.charAt(0) === '.')) {
-            this.debug('dot detected!', file, fr, pattern, pr)
-            break
-          }
-
-          // ** swallows a segment, and continue.
-          this.debug('globstar swallow a segment, and continue')
-          fr++
-        }
-      }
-
-      // no match was found.
-      // However, in partial mode, we can't say this is necessarily over.
-      // If there's more *pattern* left, then
-      if (partial) {
-        // ran out of file
-        this.debug('\n>>> no match, partial?', file, fr, pattern, pr)
-        if (fr === fl) return true
-      }
-      return false
-    }
-
-    // something other than **
-    // non-magic patterns just have to match exactly
-    // patterns with magic have been turned into regexps.
-    var hit
-    if (typeof p === 'string') {
-      if (options.nocase) {
-        hit = f.toLowerCase() === p.toLowerCase()
-      } else {
-        hit = f === p
-      }
-      this.debug('string match', p, f, hit)
-    } else {
-      hit = f.match(p)
-      this.debug('pattern match', p, f, hit)
-    }
-
-    if (!hit) return false
-  }
-
-  // Note: ending in / means that we'll get a final ""
-  // at the end of the pattern.  This can only match a
-  // corresponding "" at the end of the file.
-  // If the file ends in /, then it can only match a
-  // a pattern that ends in /, unless the pattern just
-  // doesn't have any more for it. But, a/b/ should *not*
-  // match "a/b/*", even though "" matches against the
-  // [^/]*? pattern, except in partial mode, where it might
-  // simply not be reached yet.
-  // However, a/b/ should still satisfy a/*
-
-  // now either we fell off the end of the pattern, or we're done.
-  if (fi === fl && pi === pl) {
-    // ran out of pattern and filename at the same time.
-    // an exact hit!
-    return true
-  } else if (fi === fl) {
-    // ran out of file, but still had pattern left.
-    // this is ok if we're doing the match as part of
-    // a glob fs traversal.
-    return partial
-  } else if (pi === pl) {
-    // ran out of pattern, still have file left.
-    // this is only acceptable if we're on the very last
-    // empty segment of a file with a trailing slash.
-    // a/* should match a/b/
-    var emptyFileEnd = (fi === fl - 1) && (file[fi] === '')
-    return emptyFileEnd
-  }
-
-  // should be unreachable.
-  throw new Error('wtf?')
-}
-
-// replace stuff like \* with *
-function globUnescape (s) {
-  return s.replace(/\\(.)/g, '$1')
-}
-
-function regExpEscape (s) {
-  return s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&')
-}
-
-},{"brace-expansion":11,"path":22}],21:[function(require,module,exports){
-var wrappy = require('wrappy')
-module.exports = wrappy(once)
-module.exports.strict = wrappy(onceStrict)
-
-once.proto = once(function () {
-  Object.defineProperty(Function.prototype, 'once', {
-    value: function () {
-      return once(this)
-    },
-    configurable: true
-  })
-
-  Object.defineProperty(Function.prototype, 'onceStrict', {
-    value: function () {
-      return onceStrict(this)
-    },
-    configurable: true
-  })
-})
-
-function once (fn) {
-  var f = function () {
-    if (f.called) return f.value
-    f.called = true
-    return f.value = fn.apply(this, arguments)
-  }
-  f.called = false
-  return f
-}
-
-function onceStrict (fn) {
-  var f = function () {
-    if (f.called)
-      throw new Error(f.onceError)
-    f.called = true
-    return f.value = fn.apply(this, arguments)
-  }
-  var name = fn.name || 'Function wrapped with `once`'
-  f.onceError = name + " shouldn't be called more than once"
-  f.called = false
-  return f
-}
-
-},{"wrappy":29}],22:[function(require,module,exports){
-(function (process){
-// Copyright Joyent, Inc. and other Node contributors.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a
-// copy of this software and associated documentation files (the
-// "Software"), to deal in the Software without restriction, including
-// without limitation the rights to use, copy, modify, merge, publish,
-// distribute, sublicense, and/or sell copies of the Software, and to permit
-// persons to whom the Software is furnished to do so, subject to the
-// following conditions:
-//
-// The above copyright notice and this permission notice shall be included
-// in all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
-// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
-// USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-// resolves . and .. elements in a path array with directory names there
-// must be no slashes, empty elements, or device names (c:\) in the array
-// (so also no leading and trailing slashes - it does not distinguish
-// relative and absolute paths)
-function normalizeArray(parts, allowAboveRoot) {
-  // if the path tries to go above the root, `up` ends up > 0
-  var up = 0;
-  for (var i = parts.length - 1; i >= 0; i--) {
-    var last = parts[i];
-    if (last === '.') {
-      parts.splice(i, 1);
-    } else if (last === '..') {
-      parts.splice(i, 1);
-      up++;
-    } else if (up) {
-      parts.splice(i, 1);
-      up--;
-    }
-  }
-
-  // if the path is allowed to go above the root, restore leading ..s
-  if (allowAboveRoot) {
-    for (; up--; up) {
-      parts.unshift('..');
-    }
-  }
-
-  return parts;
-}
-
-// Split a filename into [root, dir, basename, ext], unix version
-// 'root' is just a slash, or nothing.
-var splitPathRe =
-    /^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/;
-var splitPath = function(filename) {
-  return splitPathRe.exec(filename).slice(1);
-};
-
-// path.resolve([from ...], to)
-// posix version
-exports.resolve = function() {
-  var resolvedPath = '',
-      resolvedAbsolute = false;
-
-  for (var i = arguments.length - 1; i >= -1 && !resolvedAbsolute; i--) {
-    var path = (i >= 0) ? arguments[i] : process.cwd();
-
-    // Skip empty and invalid entries
-    if (typeof path !== 'string') {
-      throw new TypeError('Arguments to path.resolve must be strings');
-    } else if (!path) {
-      continue;
-    }
-
-    resolvedPath = path + '/' + resolvedPath;
-    resolvedAbsolute = path.charAt(0) === '/';
-  }
-
-  // At this point the path should be resolved to a full absolute path, but
-  // handle relative paths to be safe (might happen when process.cwd() fails)
-
-  // Normalize the path
-  resolvedPath = normalizeArray(filter(resolvedPath.split('/'), function(p) {
-    return !!p;
-  }), !resolvedAbsolute).join('/');
-
-  return ((resolvedAbsolute ? '/' : '') + resolvedPath) || '.';
-};
-
-// path.normalize(path)
-// posix version
-exports.normalize = function(path) {
-  var isAbsolute = exports.isAbsolute(path),
-      trailingSlash = substr(path, -1) === '/';
-
-  // Normalize the path
-  path = normalizeArray(filter(path.split('/'), function(p) {
-    return !!p;
-  }), !isAbsolute).join('/');
-
-  if (!path && !isAbsolute) {
-    path = '.';
-  }
-  if (path && trailingSlash) {
-    path += '/';
-  }
-
-  return (isAbsolute ? '/' : '') + path;
-};
-
-// posix version
-exports.isAbsolute = function(path) {
-  return path.charAt(0) === '/';
-};
-
-// posix version
-exports.join = function() {
-  var paths = Array.prototype.slice.call(arguments, 0);
-  return exports.normalize(filter(paths, function(p, index) {
-    if (typeof p !== 'string') {
-      throw new TypeError('Arguments to path.join must be strings');
-    }
-    return p;
-  }).join('/'));
-};
-
-
-// path.relative(from, to)
-// posix version
-exports.relative = function(from, to) {
-  from = exports.resolve(from).substr(1);
-  to = exports.resolve(to).substr(1);
-
-  function trim(arr) {
-    var start = 0;
-    for (; start < arr.length; start++) {
-      if (arr[start] !== '') break;
-    }
-
-    var end = arr.length - 1;
-    for (; end >= 0; end--) {
-      if (arr[end] !== '') break;
-    }
-
-    if (start > end) return [];
-    return arr.slice(start, end - start + 1);
-  }
-
-  var fromParts = trim(from.split('/'));
-  var toParts = trim(to.split('/'));
-
-  var length = Math.min(fromParts.length, toParts.length);
-  var samePartsLength = length;
-  for (var i = 0; i < length; i++) {
-    if (fromParts[i] !== toParts[i]) {
-      samePartsLength = i;
-      break;
-    }
-  }
-
-  var outputParts = [];
-  for (var i = samePartsLength; i < fromParts.length; i++) {
-    outputParts.push('..');
-  }
-
-  outputParts = outputParts.concat(toParts.slice(samePartsLength));
-
-  return outputParts.join('/');
-};
-
-exports.sep = '/';
-exports.delimiter = ':';
-
-exports.dirname = function(path) {
-  var result = splitPath(path),
-      root = result[0],
-      dir = result[1];
-
-  if (!root && !dir) {
-    // No dirname whatsoever
-    return '.';
-  }
-
-  if (dir) {
-    // It has a dirname, strip trailing slash
-    dir = dir.substr(0, dir.length - 1);
-  }
-
-  return root + dir;
-};
-
-
-exports.basename = function(path, ext) {
-  var f = splitPath(path)[2];
-  // TODO: make this comparison case-insensitive on windows?
-  if (ext && f.substr(-1 * ext.length) === ext) {
-    f = f.substr(0, f.length - ext.length);
-  }
-  return f;
-};
-
-
-exports.extname = function(path) {
-  return splitPath(path)[3];
-};
-
-function filter (xs, f) {
-    if (xs.filter) return xs.filter(f);
-    var res = [];
-    for (var i = 0; i < xs.length; i++) {
-        if (f(xs[i], i, xs)) res.push(xs[i]);
-    }
-    return res;
-}
-
-// String.prototype.substr - negative index don't work in IE8
-var substr = 'ab'.substr(-1) === 'b'
-    ? function (str, start, len) { return str.substr(start, len) }
-    : function (str, start, len) {
-        if (start < 0) start = str.length + start;
-        return str.substr(start, len);
-    }
-;
-
-}).call(this,require('_process'))
-},{"_process":24}],23:[function(require,module,exports){
-(function (process){
-'use strict';
-
-function posix(path) {
-	return path.charAt(0) === '/';
-}
-
-function win32(path) {
-	// https://github.com/nodejs/node/blob/b3fcc245fb25539909ef1d5eaa01dbf92e168633/lib/path.js#L56
-	var splitDeviceRe = /^([a-zA-Z]:|[\\\/]{2}[^\\\/]+[\\\/]+[^\\\/]+)?([\\\/])?([\s\S]*?)$/;
-	var result = splitDeviceRe.exec(path);
-	var device = result[1] || '';
-	var isUnc = Boolean(device && device.charAt(1) !== ':');
-
-	// UNC paths are always absolute
-	return Boolean(result[2] || isUnc);
-}
-
-module.exports = process.platform === 'win32' ? win32 : posix;
-module.exports.posix = posix;
-module.exports.win32 = win32;
-
-}).call(this,require('_process'))
-},{"_process":24}],24:[function(require,module,exports){
-// shim for using process in browser
-var process = module.exports = {};
-
-// cached from whatever global is present so that test runners that stub it
-// don't break things.  But we need to wrap it in a try catch in case it is
-// wrapped in strict mode code which doesn't define any globals.  It's inside a
-// function because try/catches deoptimize in certain engines.
-
-var cachedSetTimeout;
-var cachedClearTimeout;
-
-function defaultSetTimout() {
-    throw new Error('setTimeout has not been defined');
-}
-function defaultClearTimeout () {
-    throw new Error('clearTimeout has not been defined');
-}
-(function () {
-    try {
-        if (typeof setTimeout === 'function') {
-            cachedSetTimeout = setTimeout;
-        } else {
-            cachedSetTimeout = defaultSetTimout;
-        }
-    } catch (e) {
-        cachedSetTimeout = defaultSetTimout;
-    }
-    try {
-        if (typeof clearTimeout === 'function') {
-            cachedClearTimeout = clearTimeout;
-        } else {
-            cachedClearTimeout = defaultClearTimeout;
-        }
-    } catch (e) {
-        cachedClearTimeout = defaultClearTimeout;
-    }
-} ())
-function runTimeout(fun) {
-    if (cachedSetTimeout === setTimeout) {
-        //normal enviroments in sane situations
-        return setTimeout(fun, 0);
-    }
-    // if setTimeout wasn't available but was latter defined
-    if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) {
-        cachedSetTimeout = setTimeout;
-        return setTimeout(fun, 0);
-    }
-    try {
-        // when when somebody has screwed with setTimeout but no I.E. maddness
-        return cachedSetTimeout(fun, 0);
-    } catch(e){
-        try {
-            // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally
-            return cachedSetTimeout.call(null, fun, 0);
-        } catch(e){
-            // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error
-            return cachedSetTimeout.call(this, fun, 0);
-        }
-    }
-
-
-}
-function runClearTimeout(marker) {
-    if (cachedClearTimeout === clearTimeout) {
-        //normal enviroments in sane situations
-        return clearTimeout(marker);
-    }
-    // if clearTimeout wasn't available but was latter defined
-    if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) {
-        cachedClearTimeout = clearTimeout;
-        return clearTimeout(marker);
-    }
-    try {
-        // when when somebody has screwed with setTimeout but no I.E. maddness
-        return cachedClearTimeout(marker);
-    } catch (e){
-        try {
-            // When we are in I.E. but the script has been evaled so I.E. doesn't  trust the global object when called normally
-            return cachedClearTimeout.call(null, marker);
-        } catch (e){
-            // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error.
-            // Some versions of I.E. have different rules for clearTimeout vs setTimeout
-            return cachedClearTimeout.call(this, marker);
-        }
-    }
-
-
-
-}
-var queue = [];
-var draining = false;
-var currentQueue;
-var queueIndex = -1;
-
-function cleanUpNextTick() {
-    if (!draining || !currentQueue) {
-        return;
-    }
-    draining = false;
-    if (currentQueue.length) {
-        queue = currentQueue.concat(queue);
-    } else {
-        queueIndex = -1;
-    }
-    if (queue.length) {
-        drainQueue();
-    }
-}
-
-function drainQueue() {
-    if (draining) {
-        return;
-    }
-    var timeout = runTimeout(cleanUpNextTick);
-    draining = true;
-
-    var len = queue.length;
-    while(len) {
-        currentQueue = queue;
-        queue = [];
-        while (++queueIndex < len) {
-            if (currentQueue) {
-                currentQueue[queueIndex].run();
-            }
-        }
-        queueIndex = -1;
-        len = queue.length;
-    }
-    currentQueue = null;
-    draining = false;
-    runClearTimeout(timeout);
-}
-
-process.nextTick = function (fun) {
-    var args = new Array(arguments.length - 1);
-    if (arguments.length > 1) {
-        for (var i = 1; i < arguments.length; i++) {
-            args[i - 1] = arguments[i];
-        }
-    }
-    queue.push(new Item(fun, args));
-    if (queue.length === 1 && !draining) {
-        runTimeout(drainQueue);
-    }
-};
-
-// v8 likes predictible objects
-function Item(fun, array) {
-    this.fun = fun;
-    this.array = array;
-}
-Item.prototype.run = function () {
-    this.fun.apply(null, this.array);
-};
-process.title = 'browser';
-process.browser = true;
-process.env = {};
-process.argv = [];
-process.version = ''; // empty string to avoid regexp issues
-process.versions = {};
-
-function noop() {}
-
-process.on = noop;
-process.addListener = noop;
-process.once = noop;
-process.off = noop;
-process.removeListener = noop;
-process.removeAllListeners = noop;
-process.emit = noop;
-process.prependListener = noop;
-process.prependOnceListener = noop;
-
-process.listeners = function (name) { return [] }
-
-process.binding = function (name) {
-    throw new Error('process.binding is not supported');
-};
-
-process.cwd = function () { return '/' };
-process.chdir = function (dir) {
-    throw new Error('process.chdir is not supported');
-};
-process.umask = function() { return 0; };
-
-},{}],25:[function(require,module,exports){
-//     Underscore.js 1.8.3
-//     http://underscorejs.org
-//     (c) 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
-//     Underscore may be freely distributed under the MIT license.
-
-(function() {
-
-  // Baseline setup
-  // --------------
-
-  // Establish the root object, `window` in the browser, or `exports` on the server.
-  var root = this;
-
-  // Save the previous value of the `_` variable.
-  var previousUnderscore = root._;
-
-  // Save bytes in the minified (but not gzipped) version:
-  var ArrayProto = Array.prototype, ObjProto = Object.prototype, FuncProto = Function.prototype;
-
-  // Create quick reference variables for speed access to core prototypes.
-  var
-    push             = ArrayProto.push,
-    slice            = ArrayProto.slice,
-    toString         = ObjProto.toString,
-    hasOwnProperty   = ObjProto.hasOwnProperty;
-
-  // All **ECMAScript 5** native function implementations that we hope to use
-  // are declared here.
-  var
-    nativeIsArray      = Array.isArray,
-    nativeKeys         = Object.keys,
-    nativeBind         = FuncProto.bind,
-    nativeCreate       = Object.create;
-
-  // Naked function reference for surrogate-prototype-swapping.
-  var Ctor = function(){};
-
-  // Create a safe reference to the Underscore object for use below.
-  var _ = function(obj) {
-    if (obj instanceof _) return obj;
-    if (!(this instanceof _)) return new _(obj);
-    this._wrapped = obj;
-  };
-
-  // Export the Underscore object for **Node.js**, with
-  // backwards-compatibility for the old `require()` API. If we're in
-  // the browser, add `_` as a global object.
-  if (typeof exports !== 'undefined') {
-    if (typeof module !== 'undefined' && module.exports) {
-      exports = module.exports = _;
-    }
-    exports._ = _;
-  } else {
-    root._ = _;
-  }
-
-  // Current version.
-  _.VERSION = '1.8.3';
-
-  // Internal function that returns an efficient (for current engines) version
-  // of the passed-in callback, to be repeatedly applied in other Underscore
-  // functions.
-  var optimizeCb = function(func, context, argCount) {
-    if (context === void 0) return func;
-    switch (argCount == null ? 3 : argCount) {
-      case 1: return function(value) {
-        return func.call(context, value);
-      };
-      case 2: return function(value, other) {
-        return func.call(context, value, other);
-      };
-      case 3: return function(value, index, collection) {
-        return func.call(context, value, index, collection);
-      };
-      case 4: return function(accumulator, value, index, collection) {
-        return func.call(context, accumulator, value, index, collection);
-      };
-    }
-    return function() {
-      return func.apply(context, arguments);
-    };
-  };
-
-  // A mostly-internal function to generate callbacks that can be applied
-  // to each element in a collection, returning the desired result — either
-  // identity, an arbitrary callback, a property matcher, or a property accessor.
-  var cb = function(value, context, argCount) {
-    if (value == null) return _.identity;
-    if (_.isFunction(value)) return optimizeCb(value, context, argCount);
-    if (_.isObject(value)) return _.matcher(value);
-    return _.property(value);
-  };
-  _.iteratee = function(value, context) {
-    return cb(value, context, Infinity);
-  };
-
-  // An internal function for creating assigner functions.
-  var createAssigner = function(keysFunc, undefinedOnly) {
-    return function(obj) {
-      var length = arguments.length;
-      if (length < 2 || obj == null) return obj;
-      for (var index = 1; index < length; index++) {
-        var source = arguments[index],
-            keys = keysFunc(source),
-            l = keys.length;
-        for (var i = 0; i < l; i++) {
-          var key = keys[i];
-          if (!undefinedOnly || obj[key] === void 0) obj[key] = source[key];
-        }
-      }
-      return obj;
-    };
-  };
-
-  // An internal function for creating a new object that inherits from another.
-  var baseCreate = function(prototype) {
-    if (!_.isObject(prototype)) return {};
-    if (nativeCreate) return nativeCreate(prototype);
-    Ctor.prototype = prototype;
-    var result = new Ctor;
-    Ctor.prototype = null;
-    return result;
-  };
-
-  var property = function(key) {
-    return function(obj) {
-      return obj == null ? void 0 : obj[key];
-    };
-  };
-
-  // Helper for collection methods to determine whether a collection
-  // should be iterated as an array or as an object
-  // Related: http://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength
-  // Avoids a very nasty iOS 8 JIT bug on ARM-64. #2094
-  var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1;
-  var getLength = property('length');
-  var isArrayLike = function(collection) {
-    var length = getLength(collection);
-    return typeof length == 'number' && length >= 0 && length <= MAX_ARRAY_INDEX;
-  };
-
-  // Collection Functions
-  // --------------------
-
-  // The cornerstone, an `each` implementation, aka `forEach`.
-  // Handles raw objects in addition to array-likes. Treats all
-  // sparse array-likes as if they were dense.
-  _.each = _.forEach = function(obj, iteratee, context) {
-    iteratee = optimizeCb(iteratee, context);
-    var i, length;
-    if (isArrayLike(obj)) {
-      for (i = 0, length = obj.length; i < length; i++) {
-        iteratee(obj[i], i, obj);
-      }
-    } else {
-      var keys = _.keys(obj);
-      for (i = 0, length = keys.length; i < length; i++) {
-        iteratee(obj[keys[i]], keys[i], obj);
-      }
-    }
-    return obj;
-  };
-
-  // Return the results of applying the iteratee to each element.
-  _.map = _.collect = function(obj, iteratee, context) {
-    iteratee = cb(iteratee, context);
-    var keys = !isArrayLike(obj) && _.keys(obj),
-        length = (keys || obj).length,
-        results = Array(length);
-    for (var index = 0; index < length; index++) {
-      var currentKey = keys ? keys[index] : index;
-      results[index] = iteratee(obj[currentKey], currentKey, obj);
-    }
-    return results;
-  };
-
-  // Create a reducing function iterating left or right.
-  function createReduce(dir) {
-    // Optimized iterator function as using arguments.length
-    // in the main function will deoptimize the, see #1991.
-    function iterator(obj, iteratee, memo, keys, index, length) {
-      for (; index >= 0 && index < length; index += dir) {
-        var currentKey = keys ? keys[index] : index;
-        memo = iteratee(memo, obj[currentKey], currentKey, obj);
-      }
-      return memo;
-    }
-
-    return function(obj, iteratee, memo, context) {
-      iteratee = optimizeCb(iteratee, context, 4);
-      var keys = !isArrayLike(obj) && _.keys(obj),
-          length = (keys || obj).length,
-          index = dir > 0 ? 0 : length - 1;
-      // Determine the initial value if none is provided.
-      if (arguments.length < 3) {
-        memo = obj[keys ? keys[index] : index];
-        index += dir;
-      }
-      return iterator(obj, iteratee, memo, keys, index, length);
-    };
-  }
-
-  // **Reduce** builds up a single result from a list of values, aka `inject`,
-  // or `foldl`.
-  _.reduce = _.foldl = _.inject = createReduce(1);
-
-  // The right-associative version of reduce, also known as `foldr`.
-  _.reduceRight = _.foldr = createReduce(-1);
-
-  // Return the first value which passes a truth test. Aliased as `detect`.
-  _.find = _.detect = function(obj, predicate, context) {
-    var key;
-    if (isArrayLike(obj)) {
-      key = _.findIndex(obj, predicate, context);
-    } else {
-      key = _.findKey(obj, predicate, context);
-    }
-    if (key !== void 0 && key !== -1) return obj[key];
-  };
-
-  // Return all the elements that pass a truth test.
-  // Aliased as `select`.
-  _.filter = _.select = function(obj, predicate, context) {
-    var results = [];
-    predicate = cb(predicate, context);
-    _.each(obj, function(value, index, list) {
-      if (predicate(value, index, list)) results.push(value);
-    });
-    return results;
-  };
-
-  // Return all the elements for which a truth test fails.
-  _.reject = function(obj, predicate, context) {
-    return _.filter(obj, _.negate(cb(predicate)), context);
-  };
-
-  // Determine whether all of the elements match a truth test.
-  // Aliased as `all`.
-  _.every = _.all = function(obj, predicate, context) {
-    predicate = cb(predicate, context);
-    var keys = !isArrayLike(obj) && _.keys(obj),
-        length = (keys || obj).length;
-    for (var index = 0; index < length; index++) {
-      var currentKey = keys ? keys[index] : index;
-      if (!predicate(obj[currentKey], currentKey, obj)) return false;
-    }
-    return true;
-  };
-
-  // Determine if at least one element in the object matches a truth test.
-  // Aliased as `any`.
-  _.some = _.any = function(obj, predicate, context) {
-    predicate = cb(predicate, context);
-    var keys = !isArrayLike(obj) && _.keys(obj),
-        length = (keys || obj).length;
-    for (var index = 0; index < length; index++) {
-      var currentKey = keys ? keys[index] : index;
-      if (predicate(obj[currentKey], currentKey, obj)) return true;
-    }
-    return false;
-  };
-
-  // Determine if the array or object contains a given item (using `===`).
-  // Aliased as `includes` and `include`.
-  _.contains = _.includes = _.include = function(obj, item, fromIndex, guard) {
-    if (!isArrayLike(obj)) obj = _.values(obj);
-    if (typeof fromIndex != 'number' || guard) fromIndex = 0;
-    return _.indexOf(obj, item, fromIndex) >= 0;
-  };
-
-  // Invoke a method (with arguments) on every item in a collection.
-  _.invoke = function(obj, method) {
-    var args = slice.call(arguments, 2);
-    var isFunc = _.isFunction(method);
-    return _.map(obj, function(value) {
-      var func = isFunc ? method : value[method];
-      return func == null ? func : func.apply(value, args);
-    });
-  };
-
-  // Convenience version of a common use case of `map`: fetching a property.
-  _.pluck = function(obj, key) {
-    return _.map(obj, _.property(key));
-  };
-
-  // Convenience version of a common use case of `filter`: selecting only objects
-  // containing specific `key:value` pairs.
-  _.where = function(obj, attrs) {
-    return _.filter(obj, _.matcher(attrs));
-  };
-
-  // Convenience version of a common use case of `find`: getting the first object
-  // containing specific `key:value` pairs.
-  _.findWhere = function(obj, attrs) {
-    return _.find(obj, _.matcher(attrs));
-  };
-
-  // Return the maximum element (or element-based computation).
-  _.max = function(obj, iteratee, context) {
-    var result = -Infinity, lastComputed = -Infinity,
-        value, computed;
-    if (iteratee == null && obj != null) {
-      obj = isArrayLike(obj) ? obj : _.values(obj);
-      for (var i = 0, length = obj.length; i < length; i++) {
-        value = obj[i];
-        if (value > result) {
-          result = value;
-        }
-      }
-    } else {
-      iteratee = cb(iteratee, context);
-      _.each(obj, function(value, index, list) {
-        computed = iteratee(value, index, list);
-        if (computed > lastComputed || computed === -Infinity && result === -Infinity) {
-          result = value;
-          lastComputed = computed;
-        }
-      });
-    }
-    return result;
-  };
-
-  // Return the minimum element (or element-based computation).
-  _.min = function(obj, iteratee, context) {
-    var result = Infinity, lastComputed = Infinity,
-        value, computed;
-    if (iteratee == null && obj != null) {
-      obj = isArrayLike(obj) ? obj : _.values(obj);
-      for (var i = 0, length = obj.length; i < length; i++) {
-        value = obj[i];
-        if (value < result) {
-          result = value;
-        }
-      }
-    } else {
-      iteratee = cb(iteratee, context);
-      _.each(obj, function(value, index, list) {
-        computed = iteratee(value, index, list);
-        if (computed < lastComputed || computed === Infinity && result === Infinity) {
-          result = value;
-          lastComputed = computed;
-        }
-      });
-    }
-    return result;
-  };
-
-  // Shuffle a collection, using the modern version of the
-  // [Fisher-Yates shuffle](http://en.wikipedia.org/wiki/Fisher–Yates_shuffle).
-  _.shuffle = function(obj) {
-    var set = isArrayLike(obj) ? obj : _.values(obj);
-    var length = set.length;
-    var shuffled = Array(length);
-    for (var index = 0, rand; index < length; index++) {
-      rand = _.random(0, index);
-      if (rand !== index) shuffled[index] = shuffled[rand];
-      shuffled[rand] = set[index];
-    }
-    return shuffled;
-  };
-
-  // Sample **n** random values from a collection.
-  // If **n** is not specified, returns a single random element.
-  // The internal `guard` argument allows it to work with `map`.
-  _.sample = function(obj, n, guard) {
-    if (n == null || guard) {
-      if (!isArrayLike(obj)) obj = _.values(obj);
-      return obj[_.random(obj.length - 1)];
-    }
-    return _.shuffle(obj).slice(0, Math.max(0, n));
-  };
-
-  // Sort the object's values by a criterion produced by an iteratee.
-  _.sortBy = function(obj, iteratee, context) {
-    iteratee = cb(iteratee, context);
-    return _.pluck(_.map(obj, function(value, index, list) {
-      return {
-        value: value,
-        index: index,
-        criteria: iteratee(value, index, list)
-      };
-    }).sort(function(left, right) {
-      var a = left.criteria;
-      var b = right.criteria;
-      if (a !== b) {
-        if (a > b || a === void 0) return 1;
-        if (a < b || b === void 0) return -1;
-      }
-      return left.index - right.index;
-    }), 'value');
-  };
-
-  // An internal function used for aggregate "group by" operations.
-  var group = function(behavior) {
-    return function(obj, iteratee, context) {
-      var result = {};
-      iteratee = cb(iteratee, context);
-      _.each(obj, function(value, index) {
-        var key = iteratee(value, index, obj);
-        behavior(result, value, key);
-      });
-      return result;
-    };
-  };
-
-  // Groups the object's values by a criterion. Pass either a string attribute
-  // to group by, or a function that returns the criterion.
-  _.groupBy = group(function(result, value, key) {
-    if (_.has(result, key)) result[key].push(value); else result[key] = [value];
-  });
-
-  // Indexes the object's values by a criterion, similar to `groupBy`, but for
-  // when you know that your index values will be unique.
-  _.indexBy = group(function(result, value, key) {
-    result[key] = value;
-  });
-
-  // Counts instances of an object that group by a certain criterion. Pass
-  // either a string attribute to count by, or a function that returns the
-  // criterion.
-  _.countBy = group(function(result, value, key) {
-    if (_.has(result, key)) result[key]++; else result[key] = 1;
-  });
-
-  // Safely create a real, live array from anything iterable.
-  _.toArray = function(obj) {
-    if (!obj) return [];
-    if (_.isArray(obj)) return slice.call(obj);
-    if (isArrayLike(obj)) return _.map(obj, _.identity);
-    return _.values(obj);
-  };
-
-  // Return the number of elements in an object.
-  _.size = function(obj) {
-    if (obj == null) return 0;
-    return isArrayLike(obj) ? obj.length : _.keys(obj).length;
-  };
-
-  // Split a collection into two arrays: one whose elements all satisfy the given
-  // predicate, and one whose elements all do not satisfy the predicate.
-  _.partition = function(obj, predicate, context) {
-    predicate = cb(predicate, context);
-    var pass = [], fail = [];
-    _.each(obj, function(value, key, obj) {
-      (predicate(value, key, obj) ? pass : fail).push(value);
-    });
-    return [pass, fail];
-  };
-
-  // Array Functions
-  // ---------------
-
-  // Get the first element of an array. Passing **n** will return the first N
-  // values in the array. Aliased as `head` and `take`. The **guard** check
-  // allows it to work with `_.map`.
-  _.first = _.head = _.take = function(array, n, guard) {
-    if (array == null) return void 0;
-    if (n == null || guard) return array[0];
-    return _.initial(array, array.length - n);
-  };
-
-  // Returns everything but the last entry of the array. Especially useful on
-  // the arguments object. Passing **n** will return all the values in
-  // the array, excluding the last N.
-  _.initial = function(array, n, guard) {
-    return slice.call(array, 0, Math.max(0, array.length - (n == null || guard ? 1 : n)));
-  };
-
-  // Get the last element of an array. Passing **n** will return the last N
-  // values in the array.
-  _.last = function(array, n, guard) {
-    if (array == null) return void 0;
-    if (n == null || guard) return array[array.length - 1];
-    return _.rest(array, Math.max(0, array.length - n));
-  };
-
-  // Returns everything but the first entry of the array. Aliased as `tail` and `drop`.
-  // Especially useful on the arguments object. Passing an **n** will return
-  // the rest N values in the array.
-  _.rest = _.tail = _.drop = function(array, n, guard) {
-    return slice.call(array, n == null || guard ? 1 : n);
-  };
-
-  // Trim out all falsy values from an array.
-  _.compact = function(array) {
-    return _.filter(array, _.identity);
-  };
-
-  // Internal implementation of a recursive `flatten` function.
-  var flatten = function(input, shallow, strict, startIndex) {
-    var output = [], idx = 0;
-    for (var i = startIndex || 0, length = getLength(input); i < length; i++) {
-      var value = input[i];
-      if (isArrayLike(value) && (_.isArray(value) || _.isArguments(value))) {
-        //flatten current level of array or arguments object
-        if (!shallow) value = flatten(value, shallow, strict);
-        var j = 0, len = value.length;
-        output.length += len;
-        while (j < len) {
-          output[idx++] = value[j++];
-        }
-      } else if (!strict) {
-        output[idx++] = value;
-      }
-    }
-    return output;
-  };
-
-  // Flatten out an array, either recursively (by default), or just one level.
-  _.flatten = function(array, shallow) {
-    return flatten(array, shallow, false);
-  };
-
-  // Return a version of the array that does not contain the specified value(s).
-  _.without = function(array) {
-    return _.difference(array, slice.call(arguments, 1));
-  };
-
-  // Produce a duplicate-free version of the array. If the array has already
-  // been sorted, you have the option of using a faster algorithm.
-  // Aliased as `unique`.
-  _.uniq = _.unique = function(array, isSorted, iteratee, context) {
-    if (!_.isBoolean(isSorted)) {
-      context = iteratee;
-      iteratee = isSorted;
-      isSorted = false;
-    }
-    if (iteratee != null) iteratee = cb(iteratee, context);
-    var result = [];
-    var seen = [];
-    for (var i = 0, length = getLength(array); i < length; i++) {
-      var value = array[i],
-          computed = iteratee ? iteratee(value, i, array) : value;
-      if (isSorted) {
-        if (!i || seen !== computed) result.push(value);
-        seen = computed;
-      } else if (iteratee) {
-        if (!_.contains(seen, computed)) {
-          seen.push(computed);
-          result.push(value);
-        }
-      } else if (!_.contains(result, value)) {
-        result.push(value);
-      }
-    }
-    return result;
-  };
-
-  // Produce an array that contains the union: each distinct element from all of
-  // the passed-in arrays.
-  _.union = function() {
-    return _.uniq(flatten(arguments, true, true));
-  };
-
-  // Produce an array that contains every item shared between all the
-  // passed-in arrays.
-  _.intersection = function(array) {
-    var result = [];
-    var argsLength = arguments.length;
-    for (var i = 0, length = getLength(array); i < length; i++) {
-      var item = array[i];
-      if (_.contains(result, item)) continue;
-      for (var j = 1; j < argsLength; j++) {
-        if (!_.contains(arguments[j], item)) break;
-      }
-      if (j === argsLength) result.push(item);
-    }
-    return result;
-  };
-
-  // Take the difference between one array and a number of other arrays.
-  // Only the elements present in just the first array will remain.
-  _.difference = function(array) {
-    var rest = flatten(arguments, true, true, 1);
-    return _.filter(array, function(value){
-      return !_.contains(rest, value);
-    });
-  };
-
-  // Zip together multiple lists into a single array -- elements that share
-  // an index go together.
-  _.zip = function() {
-    return _.unzip(arguments);
-  };
-
-  // Complement of _.zip. Unzip accepts an array of arrays and groups
-  // each array's elements on shared indices
-  _.unzip = function(array) {
-    var length = array && _.max(array, getLength).length || 0;
-    var result = Array(length);
-
-    for (var index = 0; index < length; index++) {
-      result[index] = _.pluck(array, index);
-    }
-    return result;
-  };
-
-  // Converts lists into objects. Pass either a single array of `[key, value]`
-  // pairs, or two parallel arrays of the same length -- one of keys, and one of
-  // the corresponding values.
-  _.object = function(list, values) {
-    var result = {};
-    for (var i = 0, length = getLength(list); i < length; i++) {
-      if (values) {
-        result[list[i]] = values[i];
-      } else {
-        result[list[i][0]] = list[i][1];
-      }
-    }
-    return result;
-  };
-
-  // Generator function to create the findIndex and findLastIndex functions
-  function createPredicateIndexFinder(dir) {
-    return function(array, predicate, context) {
-      predicate = cb(predicate, context);
-      var length = getLength(array);
-      var index = dir > 0 ? 0 : length - 1;
-      for (; index >= 0 && index < length; index += dir) {
-        if (predicate(array[index], index, array)) return index;
-      }
-      return -1;
-    };
-  }
-
-  // Returns the first index on an array-like that passes a predicate test
-  _.findIndex = createPredicateIndexFinder(1);
-  _.findLastIndex = createPredicateIndexFinder(-1);
-
-  // Use a comparator function to figure out the smallest index at which
-  // an object should be inserted so as to maintain order. Uses binary search.
-  _.sortedIndex = function(array, obj, iteratee, context) {
-    iteratee = cb(iteratee, context, 1);
-    var value = iteratee(obj);
-    var low = 0, high = getLength(array);
-    while (low < high) {
-      var mid = Math.floor((low + high) / 2);
-      if (iteratee(array[mid]) < value) low = mid + 1; else high = mid;
-    }
-    return low;
-  };
-
-  // Generator function to create the indexOf and lastIndexOf functions
-  function createIndexFinder(dir, predicateFind, sortedIndex) {
-    return function(array, item, idx) {
-      var i = 0, length = getLength(array);
-      if (typeof idx == 'number') {
-        if (dir > 0) {
-            i = idx >= 0 ? idx : Math.max(idx + length, i);
-        } else {
-            length = idx >= 0 ? Math.min(idx + 1, length) : idx + length + 1;
-        }
-      } else if (sortedIndex && idx && length) {
-        idx = sortedIndex(array, item);
-        return array[idx] === item ? idx : -1;
-      }
-      if (item !== item) {
-        idx = predicateFind(slice.call(array, i, length), _.isNaN);
-        return idx >= 0 ? idx + i : -1;
-      }
-      for (idx = dir > 0 ? i : length - 1; idx >= 0 && idx < length; idx += dir) {
-        if (array[idx] === item) return idx;
-      }
-      return -1;
-    };
-  }
-
-  // Return the position of the first occurrence of an item in an array,
-  // or -1 if the item is not included in the array.
-  // If the array is large and already in sort order, pass `true`
-  // for **isSorted** to use binary search.
-  _.indexOf = createIndexFinder(1, _.findIndex, _.sortedIndex);
-  _.lastIndexOf = createIndexFinder(-1, _.findLastIndex);
-
-  // Generate an integer Array containing an arithmetic progression. A port of
-  // the native Python `range()` function. See
-  // [the Python documentation](http://docs.python.org/library/functions.html#range).
-  _.range = function(start, stop, step) {
-    if (stop == null) {
-      stop = start || 0;
-      start = 0;
-    }
-    step = step || 1;
-
-    var length = Math.max(Math.ceil((stop - start) / step), 0);
-    var range = Array(length);
-
-    for (var idx = 0; idx < length; idx++, start += step) {
-      range[idx] = start;
-    }
-
-    return range;
-  };
-
-  // Function (ahem) Functions
-  // ------------------
-
-  // Determines whether to execute a function as a constructor
-  // or a normal function with the provided arguments
-  var executeBound = function(sourceFunc, boundFunc, context, callingContext, args) {
-    if (!(callingContext instanceof boundFunc)) return sourceFunc.apply(context, args);
-    var self = baseCreate(sourceFunc.prototype);
-    var result = sourceFunc.apply(self, args);
-    if (_.isObject(result)) return result;
-    return self;
-  };
-
-  // Create a function bound to a given object (assigning `this`, and arguments,
-  // optionally). Delegates to **ECMAScript 5**'s native `Function.bind` if
-  // available.
-  _.bind = function(func, context) {
-    if (nativeBind && func.bind === nativeBind) return nativeBind.apply(func, slice.call(arguments, 1));
-    if (!_.isFunction(func)) throw new TypeError('Bind must be called on a function');
-    var args = slice.call(arguments, 2);
-    var bound = function() {
-      return executeBound(func, bound, context, this, args.concat(slice.call(arguments)));
-    };
-    return bound;
-  };
-
-  // Partially apply a function by creating a version that has had some of its
-  // arguments pre-filled, without changing its dynamic `this` context. _ acts
-  // as a placeholder, allowing any combination of arguments to be pre-filled.
-  _.partial = function(func) {
-    var boundArgs = slice.call(arguments, 1);
-    var bound = function() {
-      var position = 0, length = boundArgs.length;
-      var args = Array(length);
-      for (var i = 0; i < length; i++) {
-        args[i] = boundArgs[i] === _ ? arguments[position++] : boundArgs[i];
-      }
-      while (position < arguments.length) args.push(arguments[position++]);
-      return executeBound(func, bound, this, this, args);
-    };
-    return bound;
-  };
-
-  // Bind a number of an object's methods to that object. Remaining arguments
-  // are the method names to be bound. Useful for ensuring that all callbacks
-  // defined on an object belong to it.
-  _.bindAll = function(obj) {
-    var i, length = arguments.length, key;
-    if (length <= 1) throw new Error('bindAll must be passed function names');
-    for (i = 1; i < length; i++) {
-      key = arguments[i];
-      obj[key] = _.bind(obj[key], obj);
-    }
-    return obj;
-  };
-
-  // Memoize an expensive function by storing its results.
-  _.memoize = function(func, hasher) {
-    var memoize = function(key) {
-      var cache = memoize.cache;
-      var address = '' + (hasher ? hasher.apply(this, arguments) : key);
-      if (!_.has(cache, address)) cache[address] = func.apply(this, arguments);
-      return cache[address];
-    };
-    memoize.cache = {};
-    return memoize;
-  };
-
-  // Delays a function for the given number of milliseconds, and then calls
-  // it with the arguments supplied.
-  _.delay = function(func, wait) {
-    var args = slice.call(arguments, 2);
-    return setTimeout(function(){
-      return func.apply(null, args);
-    }, wait);
-  };
-
-  // Defers a function, scheduling it to run after the current call stack has
-  // cleared.
-  _.defer = _.partial(_.delay, _, 1);
-
-  // Returns a function, that, when invoked, will only be triggered at most once
-  // during a given window of time. Normally, the throttled function will run
-  // as much as it can, without ever going more than once per `wait` duration;
-  // but if you'd like to disable the execution on the leading edge, pass
-  // `{leading: false}`. To disable execution on the trailing edge, ditto.
-  _.throttle = function(func, wait, options) {
-    var context, args, result;
-    var timeout = null;
-    var previous = 0;
-    if (!options) options = {};
-    var later = function() {
-      previous = options.leading === false ? 0 : _.now();
-      timeout = null;
-      result = func.apply(context, args);
-      if (!timeout) context = args = null;
-    };
-    return function() {
-      var now = _.now();
-      if (!previous && options.leading === false) previous = now;
-      var remaining = wait - (now - previous);
-      context = this;
-      args = arguments;
-      if (remaining <= 0 || remaining > wait) {
-        if (timeout) {
-          clearTimeout(timeout);
-          timeout = null;
-        }
-        previous = now;
-        result = func.apply(context, args);
-        if (!timeout) context = args = null;
-      } else if (!timeout && options.trailing !== false) {
-        timeout = setTimeout(later, remaining);
-      }
-      return result;
-    };
-  };
-
-  // Returns a function, that, as long as it continues to be invoked, will not
-  // be triggered. The function will be called after it stops being called for
-  // N milliseconds. If `immediate` is passed, trigger the function on the
-  // leading edge, instead of the trailing.
-  _.debounce = function(func, wait, immediate) {
-    var timeout, args, context, timestamp, result;
-
-    var later = function() {
-      var last = _.now() - timestamp;
-
-      if (last < wait && last >= 0) {
-        timeout = setTimeout(later, wait - last);
-      } else {
-        timeout = null;
-        if (!immediate) {
-          result = func.apply(context, args);
-          if (!timeout) context = args = null;
-        }
-      }
-    };
-
-    return function() {
-      context = this;
-      args = arguments;
-      timestamp = _.now();
-      var callNow = immediate && !timeout;
-      if (!timeout) timeout = setTimeout(later, wait);
-      if (callNow) {
-        result = func.apply(context, args);
-        context = args = null;
-      }
-
-      return result;
-    };
-  };
-
-  // Returns the first function passed as an argument to the second,
-  // allowing you to adjust arguments, run code before and after, and
-  // conditionally execute the original function.
-  _.wrap = function(func, wrapper) {
-    return _.partial(wrapper, func);
-  };
-
-  // Returns a negated version of the passed-in predicate.
-  _.negate = function(predicate) {
-    return function() {
-      return !predicate.apply(this, arguments);
-    };
-  };
-
-  // Returns a function that is the composition of a list of functions, each
-  // consuming the return value of the function that follows.
-  _.compose = function() {
-    var args = arguments;
-    var start = args.length - 1;
-    return function() {
-      var i = start;
-      var result = args[start].apply(this, arguments);
-      while (i--) result = args[i].call(this, result);
-      return result;
-    };
-  };
-
-  // Returns a function that will only be executed on and after the Nth call.
-  _.after = function(times, func) {
-    return function() {
-      if (--times < 1) {
-        return func.apply(this, arguments);
-      }
-    };
-  };
-
-  // Returns a function that will only be executed up to (but not including) the Nth call.
-  _.before = function(times, func) {
-    var memo;
-    return function() {
-      if (--times > 0) {
-        memo = func.apply(this, arguments);
-      }
-      if (times <= 1) func = null;
-      return memo;
-    };
-  };
-
-  // Returns a function that will be executed at most one time, no matter how
-  // often you call it. Useful for lazy initialization.
-  _.once = _.partial(_.before, 2);
-
-  // Object Functions
-  // ----------------
-
-  // Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed.
-  var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString');
-  var nonEnumerableProps = ['valueOf', 'isPrototypeOf', 'toString',
-                      'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString'];
-
-  function collectNonEnumProps(obj, keys) {
-    var nonEnumIdx = nonEnumerableProps.length;
-    var constructor = obj.constructor;
-    var proto = (_.isFunction(constructor) && constructor.prototype) || ObjProto;
-
-    // Constructor is a special case.
-    var prop = 'constructor';
-    if (_.has(obj, prop) && !_.contains(keys, prop)) keys.push(prop);
-
-    while (nonEnumIdx--) {
-      prop = nonEnumerableProps[nonEnumIdx];
-      if (prop in obj && obj[prop] !== proto[prop] && !_.contains(keys, prop)) {
-        keys.push(prop);
-      }
-    }
-  }
-
-  // Retrieve the names of an object's own properties.
-  // Delegates to **ECMAScript 5**'s native `Object.keys`
-  _.keys = function(obj) {
-    if (!_.isObject(obj)) return [];
-    if (nativeKeys) return nativeKeys(obj);
-    var keys = [];
-    for (var key in obj) if (_.has(obj, key)) keys.push(key);
-    // Ahem, IE < 9.
-    if (hasEnumBug) collectNonEnumProps(obj, keys);
-    return keys;
-  };
-
-  // Retrieve all the property names of an object.
-  _.allKeys = function(obj) {
-    if (!_.isObject(obj)) return [];
-    var keys = [];
-    for (var key in obj) keys.push(key);
-    // Ahem, IE < 9.
-    if (hasEnumBug) collectNonEnumProps(obj, keys);
-    return keys;
-  };
-
-  // Retrieve the values of an object's properties.
-  _.values = function(obj) {
-    var keys = _.keys(obj);
-    var length = keys.length;
-    var values = Array(length);
-    for (var i = 0; i < length; i++) {
-      values[i] = obj[keys[i]];
-    }
-    return values;
-  };
-
-  // Returns the results of applying the iteratee to each element of the object
-  // In contrast to _.map it returns an object
-  _.mapObject = function(obj, iteratee, context) {
-    iteratee = cb(iteratee, context);
-    var keys =  _.keys(obj),
-          length = keys.length,
-          results = {},
-          currentKey;
-      for (var index = 0; index < length; index++) {
-        currentKey = keys[index];
-        results[currentKey] = iteratee(obj[currentKey], currentKey, obj);
-      }
-      return results;
-  };
-
-  // Convert an object into a list of `[key, value]` pairs.
-  _.pairs = function(obj) {
-    var keys = _.keys(obj);
-    var length = keys.length;
-    var pairs = Array(length);
-    for (var i = 0; i < length; i++) {
-      pairs[i] = [keys[i], obj[keys[i]]];
-    }
-    return pairs;
-  };
-
-  // Invert the keys and values of an object. The values must be serializable.
-  _.invert = function(obj) {
-    var result = {};
-    var keys = _.keys(obj);
-    for (var i = 0, length = keys.length; i < length; i++) {
-      result[obj[keys[i]]] = keys[i];
-    }
-    return result;
-  };
-
-  // Return a sorted list of the function names available on the object.
-  // Aliased as `methods`
-  _.functions = _.methods = function(obj) {
-    var names = [];
-    for (var key in obj) {
-      if (_.isFunction(obj[key])) names.push(key);
-    }
-    return names.sort();
-  };
-
-  // Extend a given object with all the properties in passed-in object(s).
-  _.extend = createAssigner(_.allKeys);
-
-  // Assigns a given object with all the own properties in the passed-in object(s)
-  // (https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign)
-  _.extendOwn = _.assign = createAssigner(_.keys);
-
-  // Returns the first key on an object that passes a predicate test
-  _.findKey = function(obj, predicate, context) {
-    predicate = cb(predicate, context);
-    var keys = _.keys(obj), key;
-    for (var i = 0, length = keys.length; i < length; i++) {
-      key = keys[i];
-      if (predicate(obj[key], key, obj)) return key;
-    }
-  };
-
-  // Return a copy of the object only containing the whitelisted properties.
-  _.pick = function(object, oiteratee, context) {
-    var result = {}, obj = object, iteratee, keys;
-    if (obj == null) return result;
-    if (_.isFunction(oiteratee)) {
-      keys = _.allKeys(obj);
-      iteratee = optimizeCb(oiteratee, context);
-    } else {
-      keys = flatten(arguments, false, false, 1);
-      iteratee = function(value, key, obj) { return key in obj; };
-      obj = Object(obj);
-    }
-    for (var i = 0, length = keys.length; i < length; i++) {
-      var key = keys[i];
-      var value = obj[key];
-      if (iteratee(value, key, obj)) result[key] = value;
-    }
-    return result;
-  };
-
-   // Return a copy of the object without the blacklisted properties.
-  _.omit = function(obj, iteratee, context) {
-    if (_.isFunction(iteratee)) {
-      iteratee = _.negate(iteratee);
-    } else {
-      var keys = _.map(flatten(arguments, false, false, 1), String);
-      iteratee = function(value, key) {
-        return !_.contains(keys, key);
-      };
-    }
-    return _.pick(obj, iteratee, context);
-  };
-
-  // Fill in a given object with default properties.
-  _.defaults = createAssigner(_.allKeys, true);
-
-  // Creates an object that inherits from the given prototype object.
-  // If additional properties are provided then they will be added to the
-  // created object.
-  _.create = function(prototype, props) {
-    var result = baseCreate(prototype);
-    if (props) _.extendOwn(result, props);
-    return result;
-  };
-
-  // Create a (shallow-cloned) duplicate of an object.
-  _.clone = function(obj) {
-    if (!_.isObject(obj)) return obj;
-    return _.isArray(obj) ? obj.slice() : _.extend({}, obj);
-  };
-
-  // Invokes interceptor with the obj, and then returns obj.
-  // The primary purpose of this method is to "tap into" a method chain, in
-  // order to perform operations on intermediate results within the chain.
-  _.tap = function(obj, interceptor) {
-    interceptor(obj);
-    return obj;
-  };
-
-  // Returns whether an object has a given set of `key:value` pairs.
-  _.isMatch = function(object, attrs) {
-    var keys = _.keys(attrs), length = keys.length;
-    if (object == null) return !length;
-    var obj = Object(object);
-    for (var i = 0; i < length; i++) {
-      var key = keys[i];
-      if (attrs[key] !== obj[key] || !(key in obj)) return false;
-    }
-    return true;
-  };
-
-
-  // Internal recursive comparison function for `isEqual`.
-  var eq = function(a, b, aStack, bStack) {
-    // Identical objects are equal. `0 === -0`, but they aren't identical.
-    // See the [Harmony `egal` proposal](http://wiki.ecmascript.org/doku.php?id=harmony:egal).
-    if (a === b) return a !== 0 || 1 / a === 1 / b;
-    // A strict comparison is necessary because `null == undefined`.
-    if (a == null || b == null) return a === b;
-    // Unwrap any wrapped objects.
-    if (a instanceof _) a = a._wrapped;
-    if (b instanceof _) b = b._wrapped;
-    // Compare `[[Class]]` names.
-    var className = toString.call(a);
-    if (className !== toString.call(b)) return false;
-    switch (className) {
-      // Strings, numbers, regular expressions, dates, and booleans are compared by value.
-      case '[object RegExp]':
-      // RegExps are coerced to strings for comparison (Note: '' + /a/i === '/a/i')
-      case '[object String]':
-        // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is
-        // equivalent to `new String("5")`.
-        return '' + a === '' + b;
-      case '[object Number]':
-        // `NaN`s are equivalent, but non-reflexive.
-        // Object(NaN) is equivalent to NaN
-        if (+a !== +a) return +b !== +b;
-        // An `egal` comparison is performed for other numeric values.
-        return +a === 0 ? 1 / +a === 1 / b : +a === +b;
-      case '[object Date]':
-      case '[object Boolean]':
-        // Coerce dates and booleans to numeric primitive values. Dates are compared by their
-        // millisecond representations. Note that invalid dates with millisecond representations
-        // of `NaN` are not equivalent.
-        return +a === +b;
-    }
-
-    var areArrays = className === '[object Array]';
-    if (!areArrays) {
-      if (typeof a != 'object' || typeof b != 'object') return false;
-
-      // Objects with different constructors are not equivalent, but `Object`s or `Array`s
-      // from different frames are.
-      var aCtor = a.constructor, bCtor = b.constructor;
-      if (aCtor !== bCtor && !(_.isFunction(aCtor) && aCtor instanceof aCtor &&
-                               _.isFunction(bCtor) && bCtor instanceof bCtor)
-                          && ('constructor' in a && 'constructor' in b)) {
-        return false;
-      }
-    }
-    // Assume equality for cyclic structures. The algorithm for detecting cyclic
-    // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`.
-
-    // Initializing stack of traversed objects.
-    // It's done here since we only need them for objects and arrays comparison.
-    aStack = aStack || [];
-    bStack = bStack || [];
-    var length = aStack.length;
-    while (length--) {
-      // Linear search. Performance is inversely proportional to the number of
-      // unique nested structures.
-      if (aStack[length] === a) return bStack[length] === b;
-    }
-
-    // Add the first object to the stack of traversed objects.
-    aStack.push(a);
-    bStack.push(b);
-
-    // Recursively compare objects and arrays.
-    if (areArrays) {
-      // Compare array lengths to determine if a deep comparison is necessary.
-      length = a.length;
-      if (length !== b.length) return false;
-      // Deep compare the contents, ignoring non-numeric properties.
-      while (length--) {
-        if (!eq(a[length], b[length], aStack, bStack)) return false;
-      }
-    } else {
-      // Deep compare objects.
-      var keys = _.keys(a), key;
-      length = keys.length;
-      // Ensure that both objects contain the same number of properties before comparing deep equality.
-      if (_.keys(b).length !== length) return false;
-      while (length--) {
-        // Deep compare each member
-        key = keys[length];
-        if (!(_.has(b, key) && eq(a[key], b[key], aStack, bStack))) return false;
-      }
-    }
-    // Remove the first object from the stack of traversed objects.
-    aStack.pop();
-    bStack.pop();
-    return true;
-  };
-
-  // Perform a deep comparison to check if two objects are equal.
-  _.isEqual = function(a, b) {
-    return eq(a, b);
-  };
-
-  // Is a given array, string, or object empty?
-  // An "empty" object has no enumerable own-properties.
-  _.isEmpty = function(obj) {
-    if (obj == null) return true;
-    if (isArrayLike(obj) && (_.isArray(obj) || _.isString(obj) || _.isArguments(obj))) return obj.length === 0;
-    return _.keys(obj).length === 0;
-  };
-
-  // Is a given value a DOM element?
-  _.isElement = function(obj) {
-    return !!(obj && obj.nodeType === 1);
-  };
-
-  // Is a given value an array?
-  // Delegates to ECMA5's native Array.isArray
-  _.isArray = nativeIsArray || function(obj) {
-    return toString.call(obj) === '[object Array]';
-  };
-
-  // Is a given variable an object?
-  _.isObject = function(obj) {
-    var type = typeof obj;
-    return type === 'function' || type === 'object' && !!obj;
-  };
-
-  // Add some isType methods: isArguments, isFunction, isString, isNumber, isDate, isRegExp, isError.
-  _.each(['Arguments', 'Function', 'String', 'Number', 'Date', 'RegExp', 'Error'], function(name) {
-    _['is' + name] = function(obj) {
-      return toString.call(obj) === '[object ' + name + ']';
-    };
-  });
-
-  // Define a fallback version of the method in browsers (ahem, IE < 9), where
-  // there isn't any inspectable "Arguments" type.
-  if (!_.isArguments(arguments)) {
-    _.isArguments = function(obj) {
-      return _.has(obj, 'callee');
-    };
-  }
-
-  // Optimize `isFunction` if appropriate. Work around some typeof bugs in old v8,
-  // IE 11 (#1621), and in Safari 8 (#1929).
-  if (typeof /./ != 'function' && typeof Int8Array != 'object') {
-    _.isFunction = function(obj) {
-      return typeof obj == 'function' || false;
-    };
-  }
-
-  // Is a given object a finite number?
-  _.isFinite = function(obj) {
-    return isFinite(obj) && !isNaN(parseFloat(obj));
-  };
-
-  // Is the given value `NaN`? (NaN is the only number which does not equal itself).
-  _.isNaN = function(obj) {
-    return _.isNumber(obj) && obj !== +obj;
-  };
-
-  // Is a given value a boolean?
-  _.isBoolean = function(obj) {
-    return obj === true || obj === false || toString.call(obj) === '[object Boolean]';
-  };
-
-  // Is a given value equal to null?
-  _.isNull = function(obj) {
-    return obj === null;
-  };
-
-  // Is a given variable undefined?
-  _.isUndefined = function(obj) {
-    return obj === void 0;
-  };
-
-  // Shortcut function for checking if an object has a given property directly
-  // on itself (in other words, not on a prototype).
-  _.has = function(obj, key) {
-    return obj != null && hasOwnProperty.call(obj, key);
-  };
-
-  // Utility Functions
-  // -----------------
-
-  // Run Underscore.js in *noConflict* mode, returning the `_` variable to its
-  // previous owner. Returns a reference to the Underscore object.
-  _.noConflict = function() {
-    root._ = previousUnderscore;
-    return this;
-  };
-
-  // Keep the identity function around for default iteratees.
-  _.identity = function(value) {
-    return value;
-  };
-
-  // Predicate-generating functions. Often useful outside of Underscore.
-  _.constant = function(value) {
-    return function() {
-      return value;
-    };
-  };
-
-  _.noop = function(){};
-
-  _.property = property;
-
-  // Generates a function for a given object that returns a given property.
-  _.propertyOf = function(obj) {
-    return obj == null ? function(){} : function(key) {
-      return obj[key];
-    };
-  };
-
-  // Returns a predicate for checking whether an object has a given set of
-  // `key:value` pairs.
-  _.matcher = _.matches = function(attrs) {
-    attrs = _.extendOwn({}, attrs);
-    return function(obj) {
-      return _.isMatch(obj, attrs);
-    };
-  };
-
-  // Run a function **n** times.
-  _.times = function(n, iteratee, context) {
-    var accum = Array(Math.max(0, n));
-    iteratee = optimizeCb(iteratee, context, 1);
-    for (var i = 0; i < n; i++) accum[i] = iteratee(i);
-    return accum;
-  };
-
-  // Return a random integer between min and max (inclusive).
-  _.random = function(min, max) {
-    if (max == null) {
-      max = min;
-      min = 0;
-    }
-    return min + Math.floor(Math.random() * (max - min + 1));
-  };
-
-  // A (possibly faster) way to get the current timestamp as an integer.
-  _.now = Date.now || function() {
-    return new Date().getTime();
-  };
-
-   // List of HTML entities for escaping.
-  var escapeMap = {
-    '&': '&amp;',
-    '<': '&lt;',
-    '>': '&gt;',
-    '"': '&quot;',
-    "'": '&#x27;',
-    '`': '&#x60;'
-  };
-  var unescapeMap = _.invert(escapeMap);
-
-  // Functions for escaping and unescaping strings to/from HTML interpolation.
-  var createEscaper = function(map) {
-    var escaper = function(match) {
-      return map[match];
-    };
-    // Regexes for identifying a key that needs to be escaped
-    var source = '(?:' + _.keys(map).join('|') + ')';
-    var testRegexp = RegExp(source);
-    var replaceRegexp = RegExp(source, 'g');
-    return function(string) {
-      string = string == null ? '' : '' + string;
-      return testRegexp.test(string) ? string.replace(replaceRegexp, escaper) : string;
-    };
-  };
-  _.escape = createEscaper(escapeMap);
-  _.unescape = createEscaper(unescapeMap);
-
-  // If the value of the named `property` is a function then invoke it with the
-  // `object` as context; otherwise, return it.
-  _.result = function(object, property, fallback) {
-    var value = object == null ? void 0 : object[property];
-    if (value === void 0) {
-      value = fallback;
-    }
-    return _.isFunction(value) ? value.call(object) : value;
-  };
-
-  // Generate a unique integer id (unique within the entire client session).
-  // Useful for temporary DOM ids.
-  var idCounter = 0;
-  _.uniqueId = function(prefix) {
-    var id = ++idCounter + '';
-    return prefix ? prefix + id : id;
-  };
-
-  // By default, Underscore uses ERB-style template delimiters, change the
-  // following template settings to use alternative delimiters.
-  _.templateSettings = {
-    evaluate    : /<%([\s\S]+?)%>/g,
-    interpolate : /<%=([\s\S]+?)%>/g,
-    escape      : /<%-([\s\S]+?)%>/g
-  };
-
-  // When customizing `templateSettings`, if you don't want to define an
-  // interpolation, evaluation or escaping regex, we need one that is
-  // guaranteed not to match.
-  var noMatch = /(.)^/;
-
-  // Certain characters need to be escaped so that they can be put into a
-  // string literal.
-  var escapes = {
-    "'":      "'",
-    '\\':     '\\',
-    '\r':     'r',
-    '\n':     'n',
-    '\u2028': 'u2028',
-    '\u2029': 'u2029'
-  };
-
-  var escaper = /\\|'|\r|\n|\u2028|\u2029/g;
-
-  var escapeChar = function(match) {
-    return '\\' + escapes[match];
-  };
-
-  // JavaScript micro-templating, similar to John Resig's implementation.
-  // Underscore templating handles arbitrary delimiters, preserves whitespace,
-  // and correctly escapes quotes within interpolated code.
-  // NB: `oldSettings` only exists for backwards compatibility.
-  _.template = function(text, settings, oldSettings) {
-    if (!settings && oldSettings) settings = oldSettings;
-    settings = _.defaults({}, settings, _.templateSettings);
-
-    // Combine delimiters into one regular expression via alternation.
-    var matcher = RegExp([
-      (settings.escape || noMatch).source,
-      (settings.interpolate || noMatch).source,
-      (settings.evaluate || noMatch).source
-    ].join('|') + '|$', 'g');
-
-    // Compile the template source, escaping string literals appropriately.
-    var index = 0;
-    var source = "__p+='";
-    text.replace(matcher, function(match, escape, interpolate, evaluate, offset) {
-      source += text.slice(index, offset).replace(escaper, escapeChar);
-      index = offset + match.length;
-
-      if (escape) {
-        source += "'+\n((__t=(" + escape + "))==null?'':_.escape(__t))+\n'";
-      } else if (interpolate) {
-        source += "'+\n((__t=(" + interpolate + "))==null?'':__t)+\n'";
-      } else if (evaluate) {
-        source += "';\n" + evaluate + "\n__p+='";
-      }
-
-      // Adobe VMs need the match returned to produce the correct offest.
-      return match;
-    });
-    source += "';\n";
-
-    // If a variable is not specified, place data values in local scope.
-    if (!settings.variable) source = 'with(obj||{}){\n' + source + '}\n';
-
-    source = "var __t,__p='',__j=Array.prototype.join," +
-      "print=function(){__p+=__j.call(arguments,'');};\n" +
-      source + 'return __p;\n';
-
-    try {
-      var render = new Function(settings.variable || 'obj', '_', source);
-    } catch (e) {
-      e.source = source;
-      throw e;
-    }
-
-    var template = function(data) {
-      return render.call(this, data, _);
-    };
-
-    // Provide the compiled source as a convenience for precompilation.
-    var argument = settings.variable || 'obj';
-    template.source = 'function(' + argument + '){\n' + source + '}';
-
-    return template;
-  };
-
-  // Add a "chain" function. Start chaining a wrapped Underscore object.
-  _.chain = function(obj) {
-    var instance = _(obj);
-    instance._chain = true;
-    return instance;
-  };
-
-  // OOP
-  // ---------------
-  // If Underscore is called as a function, it returns a wrapped object that
-  // can be used OO-style. This wrapper holds altered versions of all the
-  // underscore functions. Wrapped objects may be chained.
-
-  // Helper function to continue chaining intermediate results.
-  var result = function(instance, obj) {
-    return instance._chain ? _(obj).chain() : obj;
-  };
-
-  // Add your own custom functions to the Underscore object.
-  _.mixin = function(obj) {
-    _.each(_.functions(obj), function(name) {
-      var func = _[name] = obj[name];
-      _.prototype[name] = function() {
-        var args = [this._wrapped];
-        push.apply(args, arguments);
-        return result(this, func.apply(_, args));
-      };
-    });
-  };
-
-  // Add all of the Underscore functions to the wrapper object.
-  _.mixin(_);
-
-  // Add all mutator Array functions to the wrapper.
-  _.each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) {
-    var method = ArrayProto[name];
-    _.prototype[name] = function() {
-      var obj = this._wrapped;
-      method.apply(obj, arguments);
-      if ((name === 'shift' || name === 'splice') && obj.length === 0) delete obj[0];
-      return result(this, obj);
-    };
-  });
-
-  // Add all accessor Array functions to the wrapper.
-  _.each(['concat', 'join', 'slice'], function(name) {
-    var method = ArrayProto[name];
-    _.prototype[name] = function() {
-      return result(this, method.apply(this._wrapped, arguments));
-    };
-  });
-
-  // Extracts the result from a wrapped and chained object.
-  _.prototype.value = function() {
-    return this._wrapped;
-  };
-
-  // Provide unwrapping proxy for some methods used in engine operations
-  // such as arithmetic and JSON stringification.
-  _.prototype.valueOf = _.prototype.toJSON = _.prototype.value;
-
-  _.prototype.toString = function() {
-    return '' + this._wrapped;
-  };
-
-  // AMD registration happens at the end for compatibility with AMD loaders
-  // that may not enforce next-turn semantics on modules. Even though general
-  // practice for AMD registration is to be anonymous, underscore registers
-  // as a named module because, like jQuery, it is a base library that is
-  // popular enough to be bundled in a third party lib, but not be part of
-  // an AMD load request. Those cases could generate an error when an
-  // anonymous define() is called outside of a loader request.
-  if (typeof define === 'function' && define.amd) {
-    define('underscore', [], function() {
-      return _;
-    });
-  }
-}.call(this));
-
-},{}],26:[function(require,module,exports){
-arguments[4][19][0].apply(exports,arguments)
-},{"dup":19}],27:[function(require,module,exports){
-module.exports = function isBuffer(arg) {
-  return arg && typeof arg === 'object'
-    && typeof arg.copy === 'function'
-    && typeof arg.fill === 'function'
-    && typeof arg.readUInt8 === 'function';
-}
-},{}],28:[function(require,module,exports){
-(function (process,global){
-// Copyright Joyent, Inc. and other Node contributors.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a
-// copy of this software and associated documentation files (the
-// "Software"), to deal in the Software without restriction, including
-// without limitation the rights to use, copy, modify, merge, publish,
-// distribute, sublicense, and/or sell copies of the Software, and to permit
-// persons to whom the Software is furnished to do so, subject to the
-// following conditions:
-//
-// The above copyright notice and this permission notice shall be included
-// in all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
-// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
-// USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-var formatRegExp = /%[sdj%]/g;
-exports.format = function(f) {
-  if (!isString(f)) {
-    var objects = [];
-    for (var i = 0; i < arguments.length; i++) {
-      objects.push(inspect(arguments[i]));
-    }
-    return objects.join(' ');
-  }
-
-  var i = 1;
-  var args = arguments;
-  var len = args.length;
-  var str = String(f).replace(formatRegExp, function(x) {
-    if (x === '%%') return '%';
-    if (i >= len) return x;
-    switch (x) {
-      case '%s': return String(args[i++]);
-      case '%d': return Number(args[i++]);
-      case '%j':
-        try {
-          return JSON.stringify(args[i++]);
-        } catch (_) {
-          return '[Circular]';
-        }
-      default:
-        return x;
-    }
-  });
-  for (var x = args[i]; i < len; x = args[++i]) {
-    if (isNull(x) || !isObject(x)) {
-      str += ' ' + x;
-    } else {
-      str += ' ' + inspect(x);
-    }
-  }
-  return str;
-};
-
-
-// Mark that a method should not be used.
-// Returns a modified function which warns once by default.
-// If --no-deprecation is set, then it is a no-op.
-exports.deprecate = function(fn, msg) {
-  // Allow for deprecating things in the process of starting up.
-  if (isUndefined(global.process)) {
-    return function() {
-      return exports.deprecate(fn, msg).apply(this, arguments);
-    };
-  }
-
-  if (process.noDeprecation === true) {
-    return fn;
-  }
-
-  var warned = false;
-  function deprecated() {
-    if (!warned) {
-      if (process.throwDeprecation) {
-        throw new Error(msg);
-      } else if (process.traceDeprecation) {
-        console.trace(msg);
-      } else {
-        console.error(msg);
-      }
-      warned = true;
-    }
-    return fn.apply(this, arguments);
-  }
-
-  return deprecated;
-};
-
-
-var debugs = {};
-var debugEnviron;
-exports.debuglog = function(set) {
-  if (isUndefined(debugEnviron))
-    debugEnviron = process.env.NODE_DEBUG || '';
-  set = set.toUpperCase();
-  if (!debugs[set]) {
-    if (new RegExp('\\b' + set + '\\b', 'i').test(debugEnviron)) {
-      var pid = process.pid;
-      debugs[set] = function() {
-        var msg = exports.format.apply(exports, arguments);
-        console.error('%s %d: %s', set, pid, msg);
-      };
-    } else {
-      debugs[set] = function() {};
-    }
-  }
-  return debugs[set];
-};
-
-
-/**
- * Echos the value of a value. Trys to print the value out
- * in the best way possible given the different types.
- *
- * @param {Object} obj The object to print out.
- * @param {Object} opts Optional options object that alters the output.
- */
-/* legacy: obj, showHidden, depth, colors*/
-function inspect(obj, opts) {
-  // default options
-  var ctx = {
-    seen: [],
-    stylize: stylizeNoColor
-  };
-  // legacy...
-  if (arguments.length >= 3) ctx.depth = arguments[2];
-  if (arguments.length >= 4) ctx.colors = arguments[3];
-  if (isBoolean(opts)) {
-    // legacy...
-    ctx.showHidden = opts;
-  } else if (opts) {
-    // got an "options" object
-    exports._extend(ctx, opts);
-  }
-  // set default options
-  if (isUndefined(ctx.showHidden)) ctx.showHidden = false;
-  if (isUndefined(ctx.depth)) ctx.depth = 2;
-  if (isUndefined(ctx.colors)) ctx.colors = false;
-  if (isUndefined(ctx.customInspect)) ctx.customInspect = true;
-  if (ctx.colors) ctx.stylize = stylizeWithColor;
-  return formatValue(ctx, obj, ctx.depth);
-}
-exports.inspect = inspect;
-
-
-// http://en.wikipedia.org/wiki/ANSI_escape_code#graphics
-inspect.colors = {
-  'bold' : [1, 22],
-  'italic' : [3, 23],
-  'underline' : [4, 24],
-  'inverse' : [7, 27],
-  'white' : [37, 39],
-  'grey' : [90, 39],
-  'black' : [30, 39],
-  'blue' : [34, 39],
-  'cyan' : [36, 39],
-  'green' : [32, 39],
-  'magenta' : [35, 39],
-  'red' : [31, 39],
-  'yellow' : [33, 39]
-};
-
-// Don't use 'blue' not visible on cmd.exe
-inspect.styles = {
-  'special': 'cyan',
-  'number': 'yellow',
-  'boolean': 'yellow',
-  'undefined': 'grey',
-  'null': 'bold',
-  'string': 'green',
-  'date': 'magenta',
-  // "name": intentionally not styling
-  'regexp': 'red'
-};
-
-
-function stylizeWithColor(str, styleType) {
-  var style = inspect.styles[styleType];
-
-  if (style) {
-    return '\u001b[' + inspect.colors[style][0] + 'm' + str +
-           '\u001b[' + inspect.colors[style][1] + 'm';
-  } else {
-    return str;
-  }
-}
-
-
-function stylizeNoColor(str, styleType) {
-  return str;
-}
-
-
-function arrayToHash(array) {
-  var hash = {};
-
-  array.forEach(function(val, idx) {
-    hash[val] = true;
-  });
-
-  return hash;
-}
-
-
-function formatValue(ctx, value, recurseTimes) {
-  // Provide a hook for user-specified inspect functions.
-  // Check that value is an object with an inspect function on it
-  if (ctx.customInspect &&
-      value &&
-      isFunction(value.inspect) &&
-      // Filter out the util module, it's inspect function is special
-      value.inspect !== exports.inspect &&
-      // Also filter out any prototype objects using the circular check.
-      !(value.constructor && value.constructor.prototype === value)) {
-    var ret = value.inspect(recurseTimes, ctx);
-    if (!isString(ret)) {
-      ret = formatValue(ctx, ret, recurseTimes);
-    }
-    return ret;
-  }
-
-  // Primitive types cannot have properties
-  var primitive = formatPrimitive(ctx, value);
-  if (primitive) {
-    return primitive;
-  }
-
-  // Look up the keys of the object.
-  var keys = Object.keys(value);
-  var visibleKeys = arrayToHash(keys);
-
-  if (ctx.showHidden) {
-    keys = Object.getOwnPropertyNames(value);
-  }
-
-  // IE doesn't make error fields non-enumerable
-  // http://msdn.microsoft.com/en-us/library/ie/dww52sbt(v=vs.94).aspx
-  if (isError(value)
-      && (keys.indexOf('message') >= 0 || keys.indexOf('description') >= 0)) {
-    return formatError(value);
-  }
-
-  // Some type of object without properties can be shortcutted.
-  if (keys.length === 0) {
-    if (isFunction(value)) {
-      var name = value.name ? ': ' + value.name : '';
-      return ctx.stylize('[Function' + name + ']', 'special');
-    }
-    if (isRegExp(value)) {
-      return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp');
-    }
-    if (isDate(value)) {
-      return ctx.stylize(Date.prototype.toString.call(value), 'date');
-    }
-    if (isError(value)) {
-      return formatError(value);
-    }
-  }
-
-  var base = '', array = false, braces = ['{', '}'];
-
-  // Make Array say that they are Array
-  if (isArray(value)) {
-    array = true;
-    braces = ['[', ']'];
-  }
-
-  // Make functions say that they are functions
-  if (isFunction(value)) {
-    var n = value.name ? ': ' + value.name : '';
-    base = ' [Function' + n + ']';
-  }
-
-  // Make RegExps say that they are RegExps
-  if (isRegExp(value)) {
-    base = ' ' + RegExp.prototype.toString.call(value);
-  }
-
-  // Make dates with properties first say the date
-  if (isDate(value)) {
-    base = ' ' + Date.prototype.toUTCString.call(value);
-  }
-
-  // Make error with message first say the error
-  if (isError(value)) {
-    base = ' ' + formatError(value);
-  }
-
-  if (keys.length === 0 && (!array || value.length == 0)) {
-    return braces[0] + base + braces[1];
-  }
-
-  if (recurseTimes < 0) {
-    if (isRegExp(value)) {
-      return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp');
-    } else {
-      return ctx.stylize('[Object]', 'special');
-    }
-  }
-
-  ctx.seen.push(value);
-
-  var output;
-  if (array) {
-    output = formatArray(ctx, value, recurseTimes, visibleKeys, keys);
-  } else {
-    output = keys.map(function(key) {
-      return formatProperty(ctx, value, recurseTimes, visibleKeys, key, array);
-    });
-  }
-
-  ctx.seen.pop();
-
-  return reduceToSingleString(output, base, braces);
-}
-
-
-function formatPrimitive(ctx, value) {
-  if (isUndefined(value))
-    return ctx.stylize('undefined', 'undefined');
-  if (isString(value)) {
-    var simple = '\'' + JSON.stringify(value).replace(/^"|"$/g, '')
-                                             .replace(/'/g, "\\'")
-                                             .replace(/\\"/g, '"') + '\'';
-    return ctx.stylize(simple, 'string');
-  }
-  if (isNumber(value))
-    return ctx.stylize('' + value, 'number');
-  if (isBoolean(value))
-    return ctx.stylize('' + value, 'boolean');
-  // For some reason typeof null is "object", so special case here.
-  if (isNull(value))
-    return ctx.stylize('null', 'null');
-}
-
-
-function formatError(value) {
-  return '[' + Error.prototype.toString.call(value) + ']';
-}
-
-
-function formatArray(ctx, value, recurseTimes, visibleKeys, keys) {
-  var output = [];
-  for (var i = 0, l = value.length; i < l; ++i) {
-    if (hasOwnProperty(value, String(i))) {
-      output.push(formatProperty(ctx, value, recurseTimes, visibleKeys,
-          String(i), true));
-    } else {
-      output.push('');
-    }
-  }
-  keys.forEach(function(key) {
-    if (!key.match(/^\d+$/)) {
-      output.push(formatProperty(ctx, value, recurseTimes, visibleKeys,
-          key, true));
-    }
-  });
-  return output;
-}
-
-
-function formatProperty(ctx, value, recurseTimes, visibleKeys, key, array) {
-  var name, str, desc;
-  desc = Object.getOwnPropertyDescriptor(value, key) || { value: value[key] };
-  if (desc.get) {
-    if (desc.set) {
-      str = ctx.stylize('[Getter/Setter]', 'special');
-    } else {
-      str = ctx.stylize('[Getter]', 'special');
-    }
-  } else {
-    if (desc.set) {
-      str = ctx.stylize('[Setter]', 'special');
-    }
-  }
-  if (!hasOwnProperty(visibleKeys, key)) {
-    name = '[' + key + ']';
-  }
-  if (!str) {
-    if (ctx.seen.indexOf(desc.value) < 0) {
-      if (isNull(recurseTimes)) {
-        str = formatValue(ctx, desc.value, null);
-      } else {
-        str = formatValue(ctx, desc.value, recurseTimes - 1);
-      }
-      if (str.indexOf('\n') > -1) {
-        if (array) {
-          str = str.split('\n').map(function(line) {
-            return '  ' + line;
-          }).join('\n').substr(2);
-        } else {
-          str = '\n' + str.split('\n').map(function(line) {
-            return '   ' + line;
-          }).join('\n');
-        }
-      }
-    } else {
-      str = ctx.stylize('[Circular]', 'special');
-    }
-  }
-  if (isUndefined(name)) {
-    if (array && key.match(/^\d+$/)) {
-      return str;
-    }
-    name = JSON.stringify('' + key);
-    if (name.match(/^"([a-zA-Z_][a-zA-Z_0-9]*)"$/)) {
-      name = name.substr(1, name.length - 2);
-      name = ctx.stylize(name, 'name');
-    } else {
-      name = name.replace(/'/g, "\\'")
-                 .replace(/\\"/g, '"')
-                 .replace(/(^"|"$)/g, "'");
-      name = ctx.stylize(name, 'string');
-    }
-  }
-
-  return name + ': ' + str;
-}
-
-
-function reduceToSingleString(output, base, braces) {
-  var numLinesEst = 0;
-  var length = output.reduce(function(prev, cur) {
-    numLinesEst++;
-    if (cur.indexOf('\n') >= 0) numLinesEst++;
-    return prev + cur.replace(/\u001b\[\d\d?m/g, '').length + 1;
-  }, 0);
-
-  if (length > 60) {
-    return braces[0] +
-           (base === '' ? '' : base + '\n ') +
-           ' ' +
-           output.join(',\n  ') +
-           ' ' +
-           braces[1];
-  }
-
-  return braces[0] + base + ' ' + output.join(', ') + ' ' + braces[1];
-}
-
-
-// NOTE: These type checking functions intentionally don't use `instanceof`
-// because it is fragile and can be easily faked with `Object.create()`.
-function isArray(ar) {
-  return Array.isArray(ar);
-}
-exports.isArray = isArray;
-
-function isBoolean(arg) {
-  return typeof arg === 'boolean';
-}
-exports.isBoolean = isBoolean;
-
-function isNull(arg) {
-  return arg === null;
-}
-exports.isNull = isNull;
-
-function isNullOrUndefined(arg) {
-  return arg == null;
-}
-exports.isNullOrUndefined = isNullOrUndefined;
-
-function isNumber(arg) {
-  return typeof arg === 'number';
-}
-exports.isNumber = isNumber;
-
-function isString(arg) {
-  return typeof arg === 'string';
-}
-exports.isString = isString;
-
-function isSymbol(arg) {
-  return typeof arg === 'symbol';
-}
-exports.isSymbol = isSymbol;
-
-function isUndefined(arg) {
-  return arg === void 0;
-}
-exports.isUndefined = isUndefined;
-
-function isRegExp(re) {
-  return isObject(re) && objectToString(re) === '[object RegExp]';
-}
-exports.isRegExp = isRegExp;
-
-function isObject(arg) {
-  return typeof arg === 'object' && arg !== null;
-}
-exports.isObject = isObject;
-
-function isDate(d) {
-  return isObject(d) && objectToString(d) === '[object Date]';
-}
-exports.isDate = isDate;
-
-function isError(e) {
-  return isObject(e) &&
-      (objectToString(e) === '[object Error]' || e instanceof Error);
-}
-exports.isError = isError;
-
-function isFunction(arg) {
-  return typeof arg === 'function';
-}
-exports.isFunction = isFunction;
-
-function isPrimitive(arg) {
-  return arg === null ||
-         typeof arg === 'boolean' ||
-         typeof arg === 'number' ||
-         typeof arg === 'string' ||
-         typeof arg === 'symbol' ||  // ES6 symbol
-         typeof arg === 'undefined';
-}
-exports.isPrimitive = isPrimitive;
-
-exports.isBuffer = require('./support/isBuffer');
-
-function objectToString(o) {
-  return Object.prototype.toString.call(o);
-}
-
-
-function pad(n) {
-  return n < 10 ? '0' + n.toString(10) : n.toString(10);
-}
-
-
-var months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep',
-              'Oct', 'Nov', 'Dec'];
-
-// 26 Feb 16:19:34
-function timestamp() {
-  var d = new Date();
-  var time = [pad(d.getHours()),
-              pad(d.getMinutes()),
-              pad(d.getSeconds())].join(':');
-  return [d.getDate(), months[d.getMonth()], time].join(' ');
-}
-
-
-// log is just a thin wrapper to console.log that prepends a timestamp
-exports.log = function() {
-  console.log('%s - %s', timestamp(), exports.format.apply(exports, arguments));
-};
-
-
-/**
- * Inherit the prototype methods from one constructor into another.
- *
- * The Function.prototype.inherits from lang.js rewritten as a standalone
- * function (not on Function.prototype). NOTE: If this file is to be loaded
- * during bootstrapping this function needs to be rewritten using some native
- * functions as prototype setup using normal JavaScript does not work as
- * expected during bootstrapping (see mirror.js in r114903).
- *
- * @param {function} ctor Constructor function which needs to inherit the
- *     prototype.
- * @param {function} superCtor Constructor function to inherit prototype from.
- */
-exports.inherits = require('inherits');
-
-exports._extend = function(origin, add) {
-  // Don't do anything if add isn't an object
-  if (!add || !isObject(add)) return origin;
-
-  var keys = Object.keys(add);
-  var i = keys.length;
-  while (i--) {
-    origin[keys[i]] = add[keys[i]];
-  }
-  return origin;
-};
-
-function hasOwnProperty(obj, prop) {
-  return Object.prototype.hasOwnProperty.call(obj, prop);
-}
-
-}).call(this,require('_process'),typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {})
-},{"./support/isBuffer":27,"_process":24,"inherits":26}],29:[function(require,module,exports){
-// Returns a wrapper function that returns a wrapped callback
-// The wrapper function should do some stuff, and return a
-// presumably different callback function.
-// This makes sure that own properties are retained, so that
-// decorations and such are not lost along the way.
-module.exports = wrappy
-function wrappy (fn, cb) {
-  if (fn && cb) return wrappy(fn)(cb)
-
-  if (typeof fn !== 'function')
-    throw new TypeError('need wrapper function')
-
-  Object.keys(fn).forEach(function (k) {
-    wrapper[k] = fn[k]
-  })
-
-  return wrapper
-
-  function wrapper() {
-    var args = new Array(arguments.length)
-    for (var i = 0; i < args.length; i++) {
-      args[i] = arguments[i]
-    }
-    var ret = fn.apply(this, args)
-    var cb = args[args.length-1]
-    if (typeof ret === 'function' && ret !== cb) {
-      Object.keys(cb).forEach(function (k) {
-        ret[k] = cb[k]
-      })
-    }
-    return ret
-  }
-}
-
-},{}]},{},[7])(7)
-});
\ No newline at end of file
diff --git a/0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js b/0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js
deleted file mode 100644
index c8a1ec8d8..000000000
--- a/0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js
+++ /dev/null
@@ -1,42 +0,0 @@
-"use strict";(()=>{var xe=Object.create;var U=Object.defineProperty,ve=Object.defineProperties,Se=Object.getOwnPropertyDescriptor,Te=Object.getOwnPropertyDescriptors,Qe=Object.getOwnPropertyNames,Y=Object.getOwnPropertySymbols,Ee=Object.getPrototypeOf,X=Object.prototype.hasOwnProperty,be=Object.prototype.propertyIsEnumerable;var Z=Math.pow,J=(t,e,r)=>e in t?U(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r,A=(t,e)=>{for(var r in e||(e={}))X.call(e,r)&&J(t,r,e[r]);if(Y)for(var r of Y(e))be.call(e,r)&&J(t,r,e[r]);return t},G=(t,e)=>ve(t,Te(e));var Le=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var we=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of Qe(e))!X.call(t,i)&&i!==r&&U(t,i,{get:()=>e[i],enumerable:!(n=Se(e,i))||n.enumerable});return t};var Pe=(t,e,r)=>(r=t!=null?xe(Ee(t)):{},we(e||!t||!t.__esModule?U(r,"default",{value:t,enumerable:!0}):r,t));var B=(t,e,r)=>new Promise((n,i)=>{var s=u=>{try{a(r.next(u))}catch(c){i(c)}},o=u=>{try{a(r.throw(u))}catch(c){i(c)}},a=u=>u.done?n(u.value):Promise.resolve(u.value).then(s,o);a((r=r.apply(t,e)).next())});var te=Le((K,ee)=>{/**
- * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9
- * Copyright (C) 2020 Oliver Nightingale
- * @license MIT
- */(function(){var t=function(e){var r=new t.Builder;return r.pipeline.add(t.trimmer,t.stopWordFilter,t.stemmer),r.searchPipeline.add(t.stemmer),e.call(r,r),r.build()};t.version="2.3.9";/*!
- * lunr.utils
- * Copyright (C) 2020 Oliver Nightingale
- */t.utils={},t.utils.warn=function(e){return function(r){e.console&&console.warn&&console.warn(r)}}(this),t.utils.asString=function(e){return e==null?"":e.toString()},t.utils.clone=function(e){if(e==null)return e;for(var r=Object.create(null),n=Object.keys(e),i=0;i<n.length;i++){var s=n[i],o=e[s];if(Array.isArray(o)){r[s]=o.slice();continue}if(typeof o=="string"||typeof o=="number"||typeof o=="boolean"){r[s]=o;continue}throw new TypeError("clone is not deep and does not support nested objects")}return r},t.FieldRef=function(e,r,n){this.docRef=e,this.fieldName=r,this._stringValue=n},t.FieldRef.joiner="/",t.FieldRef.fromString=function(e){var r=e.indexOf(t.FieldRef.joiner);if(r===-1)throw"malformed field ref string";var n=e.slice(0,r),i=e.slice(r+1);return new t.FieldRef(i,n,e)},t.FieldRef.prototype.toString=function(){return this._stringValue==null&&(this._stringValue=this.fieldName+t.FieldRef.joiner+this.docRef),this._stringValue};/*!
- * lunr.Set
- * Copyright (C) 2020 Oliver Nightingale
- */t.Set=function(e){if(this.elements=Object.create(null),e){this.length=e.length;for(var r=0;r<this.length;r++)this.elements[e[r]]=!0}else this.length=0},t.Set.complete={intersect:function(e){return e},union:function(){return this},contains:function(){return!0}},t.Set.empty={intersect:function(){return this},union:function(e){return e},contains:function(){return!1}},t.Set.prototype.contains=function(e){return!!this.elements[e]},t.Set.prototype.intersect=function(e){var r,n,i,s=[];if(e===t.Set.complete)return this;if(e===t.Set.empty)return e;this.length<e.length?(r=this,n=e):(r=e,n=this),i=Object.keys(r.elements);for(var o=0;o<i.length;o++){var a=i[o];a in n.elements&&s.push(a)}return new t.Set(s)},t.Set.prototype.union=function(e){return e===t.Set.complete?t.Set.complete:e===t.Set.empty?this:new t.Set(Object.keys(this.elements).concat(Object.keys(e.elements)))},t.idf=function(e,r){var n=0;for(var i in e)i!="_index"&&(n+=Object.keys(e[i]).length);var s=(r-n+.5)/(n+.5);return Math.log(1+Math.abs(s))},t.Token=function(e,r){this.str=e||"",this.metadata=r||{}},t.Token.prototype.toString=function(){return this.str},t.Token.prototype.update=function(e){return this.str=e(this.str,this.metadata),this},t.Token.prototype.clone=function(e){return e=e||function(r){return r},new t.Token(e(this.str,this.metadata),this.metadata)};/*!
- * lunr.tokenizer
- * Copyright (C) 2020 Oliver Nightingale
- */t.tokenizer=function(e,r){if(e==null||e==null)return[];if(Array.isArray(e))return e.map(function(g){return new t.Token(t.utils.asString(g).toLowerCase(),t.utils.clone(r))});for(var n=e.toString().toLowerCase(),i=n.length,s=[],o=0,a=0;o<=i;o++){var u=n.charAt(o),c=o-a;if(u.match(t.tokenizer.separator)||o==i){if(c>0){var f=t.utils.clone(r)||{};f.position=[a,c],f.index=s.length,s.push(new t.Token(n.slice(a,o),f))}a=o+1}}return s},t.tokenizer.separator=/[\s\-]+/;/*!
- * lunr.Pipeline
- * Copyright (C) 2020 Oliver Nightingale
- */t.Pipeline=function(){this._stack=[]},t.Pipeline.registeredFunctions=Object.create(null),t.Pipeline.registerFunction=function(e,r){r in this.registeredFunctions&&t.utils.warn("Overwriting existing registered function: "+r),e.label=r,t.Pipeline.registeredFunctions[e.label]=e},t.Pipeline.warnIfFunctionNotRegistered=function(e){var r=e.label&&e.label in this.registeredFunctions;r||t.utils.warn(`Function is not registered with pipeline. This may cause problems when serialising the index.
-`,e)},t.Pipeline.load=function(e){var r=new t.Pipeline;return e.forEach(function(n){var i=t.Pipeline.registeredFunctions[n];if(i)r.add(i);else throw new Error("Cannot load unregistered function: "+n)}),r},t.Pipeline.prototype.add=function(){var e=Array.prototype.slice.call(arguments);e.forEach(function(r){t.Pipeline.warnIfFunctionNotRegistered(r),this._stack.push(r)},this)},t.Pipeline.prototype.after=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");n=n+1,this._stack.splice(n,0,r)},t.Pipeline.prototype.before=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");this._stack.splice(n,0,r)},t.Pipeline.prototype.remove=function(e){var r=this._stack.indexOf(e);r!=-1&&this._stack.splice(r,1)},t.Pipeline.prototype.run=function(e){for(var r=this._stack.length,n=0;n<r;n++){for(var i=this._stack[n],s=[],o=0;o<e.length;o++){var a=i(e[o],o,e);if(!(a==null||a===""))if(Array.isArray(a))for(var u=0;u<a.length;u++)s.push(a[u]);else s.push(a)}e=s}return e},t.Pipeline.prototype.runString=function(e,r){var n=new t.Token(e,r);return this.run([n]).map(function(i){return i.toString()})},t.Pipeline.prototype.reset=function(){this._stack=[]},t.Pipeline.prototype.toJSON=function(){return this._stack.map(function(e){return t.Pipeline.warnIfFunctionNotRegistered(e),e.label})};/*!
- * lunr.Vector
- * Copyright (C) 2020 Oliver Nightingale
- */t.Vector=function(e){this._magnitude=0,this.elements=e||[]},t.Vector.prototype.positionForIndex=function(e){if(this.elements.length==0)return 0;for(var r=0,n=this.elements.length/2,i=n-r,s=Math.floor(i/2),o=this.elements[s*2];i>1&&(o<e&&(r=s),o>e&&(n=s),o!=e);)i=n-r,s=r+Math.floor(i/2),o=this.elements[s*2];if(o==e||o>e)return s*2;if(o<e)return(s+1)*2},t.Vector.prototype.insert=function(e,r){this.upsert(e,r,function(){throw"duplicate index"})},t.Vector.prototype.upsert=function(e,r,n){this._magnitude=0;var i=this.positionForIndex(e);this.elements[i]==e?this.elements[i+1]=n(this.elements[i+1],r):this.elements.splice(i,0,e,r)},t.Vector.prototype.magnitude=function(){if(this._magnitude)return this._magnitude;for(var e=0,r=this.elements.length,n=1;n<r;n+=2){var i=this.elements[n];e+=i*i}return this._magnitude=Math.sqrt(e)},t.Vector.prototype.dot=function(e){for(var r=0,n=this.elements,i=e.elements,s=n.length,o=i.length,a=0,u=0,c=0,f=0;c<s&&f<o;)a=n[c],u=i[f],a<u?c+=2:a>u?f+=2:a==u&&(r+=n[c+1]*i[f+1],c+=2,f+=2);return r},t.Vector.prototype.similarity=function(e){return this.dot(e)/this.magnitude()||0},t.Vector.prototype.toArray=function(){for(var e=new Array(this.elements.length/2),r=1,n=0;r<this.elements.length;r+=2,n++)e[n]=this.elements[r];return e},t.Vector.prototype.toJSON=function(){return this.elements};/*!
- * lunr.stemmer
- * Copyright (C) 2020 Oliver Nightingale
- * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt
- */t.stemmer=function(){var e={ational:"ate",tional:"tion",enci:"ence",anci:"ance",izer:"ize",bli:"ble",alli:"al",entli:"ent",eli:"e",ousli:"ous",ization:"ize",ation:"ate",ator:"ate",alism:"al",iveness:"ive",fulness:"ful",ousness:"ous",aliti:"al",iviti:"ive",biliti:"ble",logi:"log"},r={icate:"ic",ative:"",alize:"al",iciti:"ic",ical:"ic",ful:"",ness:""},n="[^aeiou]",i="[aeiouy]",s=n+"[^aeiouy]*",o=i+"[aeiou]*",a="^("+s+")?"+o+s,u="^("+s+")?"+o+s+"("+o+")?$",c="^("+s+")?"+o+s+o+s,f="^("+s+")?"+i,g=new RegExp(a),l=new RegExp(c),m=new RegExp(u),x=new RegExp(f),v=/^(.+?)(ss|i)es$/,d=/^(.+?)([^s])s$/,y=/^(.+?)eed$/,b=/^(.+?)(ed|ing)$/,E=/.$/,w=/(at|bl|iz)$/,R=new RegExp("([^aeiouylsz])\\1$"),j=new RegExp("^"+s+i+"[^aeiouwxy]$"),_=/^(.+?[^aeiou])y$/,D=/^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/,N=/^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/,C=/^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/,V=/^(.+?)(s|t)(ion)$/,P=/^(.+?)e$/,z=/ll$/,$=new RegExp("^"+s+i+"[^aeiouwxy]$"),M=function(h){var S,k,L,p,T,O,F;if(h.length<3)return h;if(L=h.substr(0,1),L=="y"&&(h=L.toUpperCase()+h.substr(1)),p=v,T=d,p.test(h)?h=h.replace(p,"$1$2"):T.test(h)&&(h=h.replace(T,"$1$2")),p=y,T=b,p.test(h)){var Q=p.exec(h);p=g,p.test(Q[1])&&(p=E,h=h.replace(p,""))}else if(T.test(h)){var Q=T.exec(h);S=Q[1],T=x,T.test(S)&&(h=S,T=w,O=R,F=j,T.test(h)?h=h+"e":O.test(h)?(p=E,h=h.replace(p,"")):F.test(h)&&(h=h+"e"))}if(p=_,p.test(h)){var Q=p.exec(h);S=Q[1],h=S+"i"}if(p=D,p.test(h)){var Q=p.exec(h);S=Q[1],k=Q[2],p=g,p.test(S)&&(h=S+e[k])}if(p=N,p.test(h)){var Q=p.exec(h);S=Q[1],k=Q[2],p=g,p.test(S)&&(h=S+r[k])}if(p=C,T=V,p.test(h)){var Q=p.exec(h);S=Q[1],p=l,p.test(S)&&(h=S)}else if(T.test(h)){var Q=T.exec(h);S=Q[1]+Q[2],T=l,T.test(S)&&(h=S)}if(p=P,p.test(h)){var Q=p.exec(h);S=Q[1],p=l,T=m,O=$,(p.test(S)||T.test(S)&&!O.test(S))&&(h=S)}return p=z,T=l,p.test(h)&&T.test(h)&&(p=E,h=h.replace(p,"")),L=="y"&&(h=L.toLowerCase()+h.substr(1)),h};return function(I){return I.update(M)}}(),t.Pipeline.registerFunction(t.stemmer,"stemmer");/*!
- * lunr.stopWordFilter
- * Copyright (C) 2020 Oliver Nightingale
- */t.generateStopWordFilter=function(e){var r=e.reduce(function(n,i){return n[i]=i,n},{});return function(n){if(n&&r[n.toString()]!==n.toString())return n}},t.stopWordFilter=t.generateStopWordFilter(["a","able","about","across","after","all","almost","also","am","among","an","and","any","are","as","at","be","because","been","but","by","can","cannot","could","dear","did","do","does","either","else","ever","every","for","from","get","got","had","has","have","he","her","hers","him","his","how","however","i","if","in","into","is","it","its","just","least","let","like","likely","may","me","might","most","must","my","neither","no","nor","not","of","off","often","on","only","or","other","our","own","rather","said","say","says","she","should","since","so","some","than","that","the","their","them","then","there","these","they","this","tis","to","too","twas","us","wants","was","we","were","what","when","where","which","while","who","whom","why","will","with","would","yet","you","your"]),t.Pipeline.registerFunction(t.stopWordFilter,"stopWordFilter");/*!
- * lunr.trimmer
- * Copyright (C) 2020 Oliver Nightingale
- */t.trimmer=function(e){return e.update(function(r){return r.replace(/^\W+/,"").replace(/\W+$/,"")})},t.Pipeline.registerFunction(t.trimmer,"trimmer");/*!
- * lunr.TokenSet
- * Copyright (C) 2020 Oliver Nightingale
- */t.TokenSet=function(){this.final=!1,this.edges={},this.id=t.TokenSet._nextId,t.TokenSet._nextId+=1},t.TokenSet._nextId=1,t.TokenSet.fromArray=function(e){for(var r=new t.TokenSet.Builder,n=0,i=e.length;n<i;n++)r.insert(e[n]);return r.finish(),r.root},t.TokenSet.fromClause=function(e){return"editDistance"in e?t.TokenSet.fromFuzzyString(e.term,e.editDistance):t.TokenSet.fromString(e.term)},t.TokenSet.fromFuzzyString=function(e,r){for(var n=new t.TokenSet,i=[{node:n,editsRemaining:r,str:e}];i.length;){var s=i.pop();if(s.str.length>0){var o=s.str.charAt(0),a;o in s.node.edges?a=s.node.edges[o]:(a=new t.TokenSet,s.node.edges[o]=a),s.str.length==1&&(a.final=!0),i.push({node:a,editsRemaining:s.editsRemaining,str:s.str.slice(1)})}if(s.editsRemaining!=0){if("*"in s.node.edges)var u=s.node.edges["*"];else{var u=new t.TokenSet;s.node.edges["*"]=u}if(s.str.length==0&&(u.final=!0),i.push({node:u,editsRemaining:s.editsRemaining-1,str:s.str}),s.str.length>1&&i.push({node:s.node,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)}),s.str.length==1&&(s.node.final=!0),s.str.length>=1){if("*"in s.node.edges)var c=s.node.edges["*"];else{var c=new t.TokenSet;s.node.edges["*"]=c}s.str.length==1&&(c.final=!0),i.push({node:c,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)})}if(s.str.length>1){var f=s.str.charAt(0),g=s.str.charAt(1),l;g in s.node.edges?l=s.node.edges[g]:(l=new t.TokenSet,s.node.edges[g]=l),s.str.length==1&&(l.final=!0),i.push({node:l,editsRemaining:s.editsRemaining-1,str:f+s.str.slice(2)})}}}return n},t.TokenSet.fromString=function(e){for(var r=new t.TokenSet,n=r,i=0,s=e.length;i<s;i++){var o=e[i],a=i==s-1;if(o=="*")r.edges[o]=r,r.final=a;else{var u=new t.TokenSet;u.final=a,r.edges[o]=u,r=u}}return n},t.TokenSet.prototype.toArray=function(){for(var e=[],r=[{prefix:"",node:this}];r.length;){var n=r.pop(),i=Object.keys(n.node.edges),s=i.length;n.node.final&&(n.prefix.charAt(0),e.push(n.prefix));for(var o=0;o<s;o++){var a=i[o];r.push({prefix:n.prefix.concat(a),node:n.node.edges[a]})}}return e},t.TokenSet.prototype.toString=function(){if(this._str)return this._str;for(var e=this.final?"1":"0",r=Object.keys(this.edges).sort(),n=r.length,i=0;i<n;i++){var s=r[i],o=this.edges[s];e=e+s+o.id}return e},t.TokenSet.prototype.intersect=function(e){for(var r=new t.TokenSet,n=void 0,i=[{qNode:e,output:r,node:this}];i.length;){n=i.pop();for(var s=Object.keys(n.qNode.edges),o=s.length,a=Object.keys(n.node.edges),u=a.length,c=0;c<o;c++)for(var f=s[c],g=0;g<u;g++){var l=a[g];if(l==f||f=="*"){var m=n.node.edges[l],x=n.qNode.edges[f],v=m.final&&x.final,d=void 0;l in n.output.edges?(d=n.output.edges[l],d.final=d.final||v):(d=new t.TokenSet,d.final=v,n.output.edges[l]=d),i.push({qNode:x,output:d,node:m})}}}return r},t.TokenSet.Builder=function(){this.previousWord="",this.root=new t.TokenSet,this.uncheckedNodes=[],this.minimizedNodes={}},t.TokenSet.Builder.prototype.insert=function(e){var r,n=0;if(e<this.previousWord)throw new Error("Out of order word insertion");for(var i=0;i<e.length&&i<this.previousWord.length&&e[i]==this.previousWord[i];i++)n++;this.minimize(n),this.uncheckedNodes.length==0?r=this.root:r=this.uncheckedNodes[this.uncheckedNodes.length-1].child;for(var i=n;i<e.length;i++){var s=new t.TokenSet,o=e[i];r.edges[o]=s,this.uncheckedNodes.push({parent:r,char:o,child:s}),r=s}r.final=!0,this.previousWord=e},t.TokenSet.Builder.prototype.finish=function(){this.minimize(0)},t.TokenSet.Builder.prototype.minimize=function(e){for(var r=this.uncheckedNodes.length-1;r>=e;r--){var n=this.uncheckedNodes[r],i=n.child.toString();i in this.minimizedNodes?n.parent.edges[n.char]=this.minimizedNodes[i]:(n.child._str=i,this.minimizedNodes[i]=n.child),this.uncheckedNodes.pop()}};/*!
- * lunr.Index
- * Copyright (C) 2020 Oliver Nightingale
- */t.Index=function(e){this.invertedIndex=e.invertedIndex,this.fieldVectors=e.fieldVectors,this.tokenSet=e.tokenSet,this.fields=e.fields,this.pipeline=e.pipeline},t.Index.prototype.search=function(e){return this.query(function(r){var n=new t.QueryParser(e,r);n.parse()})},t.Index.prototype.query=function(e){for(var r=new t.Query(this.fields),n=Object.create(null),i=Object.create(null),s=Object.create(null),o=Object.create(null),a=Object.create(null),u=0;u<this.fields.length;u++)i[this.fields[u]]=new t.Vector;e.call(r,r);for(var u=0;u<r.clauses.length;u++){var c=r.clauses[u],f=null,g=t.Set.empty;c.usePipeline?f=this.pipeline.runString(c.term,{fields:c.fields}):f=[c.term];for(var l=0;l<f.length;l++){var m=f[l];c.term=m;var x=t.TokenSet.fromClause(c),v=this.tokenSet.intersect(x).toArray();if(v.length===0&&c.presence===t.Query.presence.REQUIRED){for(var d=0;d<c.fields.length;d++){var y=c.fields[d];o[y]=t.Set.empty}break}for(var b=0;b<v.length;b++)for(var E=v[b],w=this.invertedIndex[E],R=w._index,d=0;d<c.fields.length;d++){var y=c.fields[d],j=w[y],_=Object.keys(j),D=E+"/"+y,N=new t.Set(_);if(c.presence==t.Query.presence.REQUIRED&&(g=g.union(N),o[y]===void 0&&(o[y]=t.Set.complete)),c.presence==t.Query.presence.PROHIBITED){a[y]===void 0&&(a[y]=t.Set.empty),a[y]=a[y].union(N);continue}if(i[y].upsert(R,c.boost,function(ye,me){return ye+me}),!s[D]){for(var C=0;C<_.length;C++){var V=_[C],P=new t.FieldRef(V,y),z=j[V],$;($=n[P])===void 0?n[P]=new t.MatchData(E,y,z):$.add(E,y,z)}s[D]=!0}}}if(c.presence===t.Query.presence.REQUIRED)for(var d=0;d<c.fields.length;d++){var y=c.fields[d];o[y]=o[y].intersect(g)}}for(var M=t.Set.complete,I=t.Set.empty,u=0;u<this.fields.length;u++){var y=this.fields[u];o[y]&&(M=M.intersect(o[y])),a[y]&&(I=I.union(a[y]))}var h=Object.keys(n),S=[],k=Object.create(null);if(r.isNegated()){h=Object.keys(this.fieldVectors);for(var u=0;u<h.length;u++){var P=h[u],L=t.FieldRef.fromString(P);n[P]=new t.MatchData}}for(var u=0;u<h.length;u++){var L=t.FieldRef.fromString(h[u]),p=L.docRef;if(M.contains(p)&&!I.contains(p)){var T=this.fieldVectors[L],O=i[L.fieldName].similarity(T),F;if((F=k[p])!==void 0)F.score+=O,F.matchData.combine(n[L]);else{var Q={ref:p,score:O,matchData:n[L]};k[p]=Q,S.push(Q)}}}return S.sort(function(pe,ge){return ge.score-pe.score})},t.Index.prototype.toJSON=function(){var e=Object.keys(this.invertedIndex).sort().map(function(n){return[n,this.invertedIndex[n]]},this),r=Object.keys(this.fieldVectors).map(function(n){return[n,this.fieldVectors[n].toJSON()]},this);return{version:t.version,fields:this.fields,fieldVectors:r,invertedIndex:e,pipeline:this.pipeline.toJSON()}},t.Index.load=function(e){var r={},n={},i=e.fieldVectors,s=Object.create(null),o=e.invertedIndex,a=new t.TokenSet.Builder,u=t.Pipeline.load(e.pipeline);e.version!=t.version&&t.utils.warn("Version mismatch when loading serialised index. Current version of lunr '"+t.version+"' does not match serialized index '"+e.version+"'");for(var c=0;c<i.length;c++){var f=i[c],g=f[0],l=f[1];n[g]=new t.Vector(l)}for(var c=0;c<o.length;c++){var f=o[c],m=f[0],x=f[1];a.insert(m),s[m]=x}return a.finish(),r.fields=e.fields,r.fieldVectors=n,r.invertedIndex=s,r.tokenSet=a.root,r.pipeline=u,new t.Index(r)};/*!
- * lunr.Builder
- * Copyright (C) 2020 Oliver Nightingale
- */t.Builder=function(){this._ref="id",this._fields=Object.create(null),this._documents=Object.create(null),this.invertedIndex=Object.create(null),this.fieldTermFrequencies={},this.fieldLengths={},this.tokenizer=t.tokenizer,this.pipeline=new t.Pipeline,this.searchPipeline=new t.Pipeline,this.documentCount=0,this._b=.75,this._k1=1.2,this.termIndex=0,this.metadataWhitelist=[]},t.Builder.prototype.ref=function(e){this._ref=e},t.Builder.prototype.field=function(e,r){if(/\//.test(e))throw new RangeError("Field '"+e+"' contains illegal character '/'");this._fields[e]=r||{}},t.Builder.prototype.b=function(e){e<0?this._b=0:e>1?this._b=1:this._b=e},t.Builder.prototype.k1=function(e){this._k1=e},t.Builder.prototype.add=function(e,r){var n=e[this._ref],i=Object.keys(this._fields);this._documents[n]=r||{},this.documentCount+=1;for(var s=0;s<i.length;s++){var o=i[s],a=this._fields[o].extractor,u=a?a(e):e[o],c=this.tokenizer(u,{fields:[o]}),f=this.pipeline.run(c),g=new t.FieldRef(n,o),l=Object.create(null);this.fieldTermFrequencies[g]=l,this.fieldLengths[g]=0,this.fieldLengths[g]+=f.length;for(var m=0;m<f.length;m++){var x=f[m];if(l[x]==null&&(l[x]=0),l[x]+=1,this.invertedIndex[x]==null){var v=Object.create(null);v._index=this.termIndex,this.termIndex+=1;for(var d=0;d<i.length;d++)v[i[d]]=Object.create(null);this.invertedIndex[x]=v}this.invertedIndex[x][o][n]==null&&(this.invertedIndex[x][o][n]=Object.create(null));for(var y=0;y<this.metadataWhitelist.length;y++){var b=this.metadataWhitelist[y],E=x.metadata[b];this.invertedIndex[x][o][n][b]==null&&(this.invertedIndex[x][o][n][b]=[]),this.invertedIndex[x][o][n][b].push(E)}}}},t.Builder.prototype.calculateAverageFieldLengths=function(){for(var e=Object.keys(this.fieldLengths),r=e.length,n={},i={},s=0;s<r;s++){var o=t.FieldRef.fromString(e[s]),a=o.fieldName;i[a]||(i[a]=0),i[a]+=1,n[a]||(n[a]=0),n[a]+=this.fieldLengths[o]}for(var u=Object.keys(this._fields),s=0;s<u.length;s++){var c=u[s];n[c]=n[c]/i[c]}this.averageFieldLength=n},t.Builder.prototype.createFieldVectors=function(){for(var e={},r=Object.keys(this.fieldTermFrequencies),n=r.length,i=Object.create(null),s=0;s<n;s++){for(var o=t.FieldRef.fromString(r[s]),a=o.fieldName,u=this.fieldLengths[o],c=new t.Vector,f=this.fieldTermFrequencies[o],g=Object.keys(f),l=g.length,m=this._fields[a].boost||1,x=this._documents[o.docRef].boost||1,v=0;v<l;v++){var d=g[v],y=f[d],b=this.invertedIndex[d]._index,E,w,R;i[d]===void 0?(E=t.idf(this.invertedIndex[d],this.documentCount),i[d]=E):E=i[d],w=E*((this._k1+1)*y)/(this._k1*(1-this._b+this._b*(u/this.averageFieldLength[a]))+y),w*=m,w*=x,R=Math.round(w*1e3)/1e3,c.insert(b,R)}e[o]=c}this.fieldVectors=e},t.Builder.prototype.createTokenSet=function(){this.tokenSet=t.TokenSet.fromArray(Object.keys(this.invertedIndex).sort())},t.Builder.prototype.build=function(){return this.calculateAverageFieldLengths(),this.createFieldVectors(),this.createTokenSet(),new t.Index({invertedIndex:this.invertedIndex,fieldVectors:this.fieldVectors,tokenSet:this.tokenSet,fields:Object.keys(this._fields),pipeline:this.searchPipeline})},t.Builder.prototype.use=function(e){var r=Array.prototype.slice.call(arguments,1);r.unshift(this),e.apply(this,r)},t.MatchData=function(e,r,n){for(var i=Object.create(null),s=Object.keys(n||{}),o=0;o<s.length;o++){var a=s[o];i[a]=n[a].slice()}this.metadata=Object.create(null),e!==void 0&&(this.metadata[e]=Object.create(null),this.metadata[e][r]=i)},t.MatchData.prototype.combine=function(e){for(var r=Object.keys(e.metadata),n=0;n<r.length;n++){var i=r[n],s=Object.keys(e.metadata[i]);this.metadata[i]==null&&(this.metadata[i]=Object.create(null));for(var o=0;o<s.length;o++){var a=s[o],u=Object.keys(e.metadata[i][a]);this.metadata[i][a]==null&&(this.metadata[i][a]=Object.create(null));for(var c=0;c<u.length;c++){var f=u[c];this.metadata[i][a][f]==null?this.metadata[i][a][f]=e.metadata[i][a][f]:this.metadata[i][a][f]=this.metadata[i][a][f].concat(e.metadata[i][a][f])}}}},t.MatchData.prototype.add=function(e,r,n){if(!(e in this.metadata)){this.metadata[e]=Object.create(null),this.metadata[e][r]=n;return}if(!(r in this.metadata[e])){this.metadata[e][r]=n;return}for(var i=Object.keys(n),s=0;s<i.length;s++){var o=i[s];o in this.metadata[e][r]?this.metadata[e][r][o]=this.metadata[e][r][o].concat(n[o]):this.metadata[e][r][o]=n[o]}},t.Query=function(e){this.clauses=[],this.allFields=e},t.Query.wildcard=new String("*"),t.Query.wildcard.NONE=0,t.Query.wildcard.LEADING=1,t.Query.wildcard.TRAILING=2,t.Query.presence={OPTIONAL:1,REQUIRED:2,PROHIBITED:3},t.Query.prototype.clause=function(e){return"fields"in e||(e.fields=this.allFields),"boost"in e||(e.boost=1),"usePipeline"in e||(e.usePipeline=!0),"wildcard"in e||(e.wildcard=t.Query.wildcard.NONE),e.wildcard&t.Query.wildcard.LEADING&&e.term.charAt(0)!=t.Query.wildcard&&(e.term="*"+e.term),e.wildcard&t.Query.wildcard.TRAILING&&e.term.slice(-1)!=t.Query.wildcard&&(e.term=""+e.term+"*"),"presence"in e||(e.presence=t.Query.presence.OPTIONAL),this.clauses.push(e),this},t.Query.prototype.isNegated=function(){for(var e=0;e<this.clauses.length;e++)if(this.clauses[e].presence!=t.Query.presence.PROHIBITED)return!1;return!0},t.Query.prototype.term=function(e,r){if(Array.isArray(e))return e.forEach(function(i){this.term(i,t.utils.clone(r))},this),this;var n=r||{};return n.term=e.toString(),this.clause(n),this},t.QueryParseError=function(e,r,n){this.name="QueryParseError",this.message=e,this.start=r,this.end=n},t.QueryParseError.prototype=new Error,t.QueryLexer=function(e){this.lexemes=[],this.str=e,this.length=e.length,this.pos=0,this.start=0,this.escapeCharPositions=[]},t.QueryLexer.prototype.run=function(){for(var e=t.QueryLexer.lexText;e;)e=e(this)},t.QueryLexer.prototype.sliceString=function(){for(var e=[],r=this.start,n=this.pos,i=0;i<this.escapeCharPositions.length;i++)n=this.escapeCharPositions[i],e.push(this.str.slice(r,n)),r=n+1;return e.push(this.str.slice(r,this.pos)),this.escapeCharPositions.length=0,e.join("")},t.QueryLexer.prototype.emit=function(e){this.lexemes.push({type:e,str:this.sliceString(),start:this.start,end:this.pos}),this.start=this.pos},t.QueryLexer.prototype.escapeCharacter=function(){this.escapeCharPositions.push(this.pos-1),this.pos+=1},t.QueryLexer.prototype.next=function(){if(this.pos>=this.length)return t.QueryLexer.EOS;var e=this.str.charAt(this.pos);return this.pos+=1,e},t.QueryLexer.prototype.width=function(){return this.pos-this.start},t.QueryLexer.prototype.ignore=function(){this.start==this.pos&&(this.pos+=1),this.start=this.pos},t.QueryLexer.prototype.backup=function(){this.pos-=1},t.QueryLexer.prototype.acceptDigitRun=function(){var e,r;do e=this.next(),r=e.charCodeAt(0);while(r>47&&r<58);e!=t.QueryLexer.EOS&&this.backup()},t.QueryLexer.prototype.more=function(){return this.pos<this.length},t.QueryLexer.EOS="EOS",t.QueryLexer.FIELD="FIELD",t.QueryLexer.TERM="TERM",t.QueryLexer.EDIT_DISTANCE="EDIT_DISTANCE",t.QueryLexer.BOOST="BOOST",t.QueryLexer.PRESENCE="PRESENCE",t.QueryLexer.lexField=function(e){return e.backup(),e.emit(t.QueryLexer.FIELD),e.ignore(),t.QueryLexer.lexText},t.QueryLexer.lexTerm=function(e){if(e.width()>1&&(e.backup(),e.emit(t.QueryLexer.TERM)),e.ignore(),e.more())return t.QueryLexer.lexText},t.QueryLexer.lexEditDistance=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.EDIT_DISTANCE),t.QueryLexer.lexText},t.QueryLexer.lexBoost=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.BOOST),t.QueryLexer.lexText},t.QueryLexer.lexEOS=function(e){e.width()>0&&e.emit(t.QueryLexer.TERM)},t.QueryLexer.termSeparator=t.tokenizer.separator,t.QueryLexer.lexText=function(e){for(;;){var r=e.next();if(r==t.QueryLexer.EOS)return t.QueryLexer.lexEOS;if(r.charCodeAt(0)==92){e.escapeCharacter();continue}if(r==":")return t.QueryLexer.lexField;if(r=="~")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexEditDistance;if(r=="^")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexBoost;if(r=="+"&&e.width()===1||r=="-"&&e.width()===1)return e.emit(t.QueryLexer.PRESENCE),t.QueryLexer.lexText;if(r.match(t.QueryLexer.termSeparator))return t.QueryLexer.lexTerm}},t.QueryParser=function(e,r){this.lexer=new t.QueryLexer(e),this.query=r,this.currentClause={},this.lexemeIdx=0},t.QueryParser.prototype.parse=function(){this.lexer.run(),this.lexemes=this.lexer.lexemes;for(var e=t.QueryParser.parseClause;e;)e=e(this);return this.query},t.QueryParser.prototype.peekLexeme=function(){return this.lexemes[this.lexemeIdx]},t.QueryParser.prototype.consumeLexeme=function(){var e=this.peekLexeme();return this.lexemeIdx+=1,e},t.QueryParser.prototype.nextClause=function(){var e=this.currentClause;this.query.clause(e),this.currentClause={}},t.QueryParser.parseClause=function(e){var r=e.peekLexeme();if(r!=null)switch(r.type){case t.QueryLexer.PRESENCE:return t.QueryParser.parsePresence;case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expected either a field or a term, found "+r.type;throw r.str.length>=1&&(n+=" with value '"+r.str+"'"),new t.QueryParseError(n,r.start,r.end)}},t.QueryParser.parsePresence=function(e){var r=e.consumeLexeme();if(r!=null){switch(r.str){case"-":e.currentClause.presence=t.Query.presence.PROHIBITED;break;case"+":e.currentClause.presence=t.Query.presence.REQUIRED;break;default:var n="unrecognised presence operator'"+r.str+"'";throw new t.QueryParseError(n,r.start,r.end)}var i=e.peekLexeme();if(i==null){var n="expecting term or field, found nothing";throw new t.QueryParseError(n,r.start,r.end)}switch(i.type){case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expecting term or field, found '"+i.type+"'";throw new t.QueryParseError(n,i.start,i.end)}}},t.QueryParser.parseField=function(e){var r=e.consumeLexeme();if(r!=null){if(e.query.allFields.indexOf(r.str)==-1){var n=e.query.allFields.map(function(o){return"'"+o+"'"}).join(", "),i="unrecognised field '"+r.str+"', possible fields: "+n;throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.fields=[r.str];var s=e.peekLexeme();if(s==null){var i="expecting term, found nothing";throw new t.QueryParseError(i,r.start,r.end)}switch(s.type){case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var i="expecting term, found '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseTerm=function(e){var r=e.consumeLexeme();if(r!=null){e.currentClause.term=r.str.toLowerCase(),r.str.indexOf("*")!=-1&&(e.currentClause.usePipeline=!1);var n=e.peekLexeme();if(n==null){e.nextClause();return}switch(n.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+n.type+"'";throw new t.QueryParseError(i,n.start,n.end)}}},t.QueryParser.parseEditDistance=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="edit distance must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.editDistance=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseBoost=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="boost must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.boost=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},function(e,r){typeof define=="function"&&define.amd?define(r):typeof K=="object"?ee.exports=r():e.lunr=r()}(this,function(){return t})})()});var de=Pe(te());function re(t,e=document){let r=ke(t,e);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${t}" to be present`);return r}function ke(t,e=document){return e.querySelector(t)||void 0}Object.entries||(Object.entries=function(t){let e=[];for(let r of Object.keys(t))e.push([r,t[r]]);return e});Object.values||(Object.values=function(t){let e=[];for(let r of Object.keys(t))e.push(t[r]);return e});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(t,e){typeof t=="object"?(this.scrollLeft=t.left,this.scrollTop=t.top):(this.scrollLeft=t,this.scrollTop=e)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...t){let e=this.parentNode;if(e){t.length===0&&e.removeChild(this);for(let r=t.length-1;r>=0;r--){let n=t[r];typeof n=="string"?n=document.createTextNode(n):n.parentNode&&n.parentNode.removeChild(n),r?e.insertBefore(this.previousSibling,n):e.replaceChild(n,this)}}}));function ne(t){let e=new Map;for(let r of t){let[n]=r.location.split("#"),i=e.get(n);typeof i=="undefined"?e.set(n,r):(e.set(r.location,r),r.parent=i)}return e}function W(t,e,r){var s;e=new RegExp(e,"g");let n,i=0;do{n=e.exec(t);let o=(s=n==null?void 0:n.index)!=null?s:t.length;if(i<o&&r(i,o),n){let[a]=n;i=n.index+a.length,a.length===0&&(e.lastIndex=n.index+1)}}while(n)}function ie(t,e){let r=0,n=0,i=0;for(let s=0;i<t.length;i++)t.charAt(i)==="<"&&i>n?e(r,1,n,n=i):t.charAt(i)===">"&&(t.charAt(n+1)==="/"?--s===0&&e(r++,2,n,i+1):t.charAt(i-1)!=="/"&&s++===0&&e(r,0,n,i+1),n=i+1);i>n&&e(r,1,n,i)}function se(t,e,r,n=!1){return q([t],e,r,n).pop()}function q(t,e,r,n=!1){let i=[0];for(let s=1;s<e.length;s++){let o=e[s-1],a=e[s],u=o[o.length-1]>>>2&1023,c=a[0]>>>12;i.push(+(u>c)+i[i.length-1])}return t.map((s,o)=>{let a=0,u=new Map;for(let f of r.sort((g,l)=>g-l)){let g=f&1048575,l=f>>>20;if(i[l]!==o)continue;let m=u.get(l);typeof m=="undefined"&&u.set(l,m=[]),m.push(g)}if(u.size===0)return s;let c=[];for(let[f,g]of u){let l=e[f],m=l[0]>>>12,x=l[l.length-1]>>>12,v=l[l.length-1]>>>2&1023;n&&m>a&&c.push(s.slice(a,m));let d=s.slice(m,x+v);for(let y of g.sort((b,E)=>E-b)){let b=(l[y]>>>12)-m,E=(l[y]>>>2&1023)+b;d=[d.slice(0,b),"<mark>",d.slice(b,E),"</mark>",d.slice(E)].join("")}if(a=x+v,c.push(d)===2)break}return n&&a<s.length&&c.push(s.slice(a)),c.join("")})}function oe(t){let e=[];if(typeof t=="undefined")return e;let r=Array.isArray(t)?t:[t];for(let n=0;n<r.length;n++){let i=lunr.tokenizer.table,s=i.length;ie(r[n],(o,a,u,c)=>{var f;switch(i[f=o+=s]||(i[f]=[]),a){case 0:case 2:i[o].push(u<<12|c-u<<2|a);break;case 1:let g=r[n].slice(u,c);W(g,lunr.tokenizer.separator,(l,m)=>{if(typeof lunr.segmenter!="undefined"){let x=g.slice(l,m);if(/^[MHIK]$/.test(lunr.segmenter.ctype_(x))){let v=lunr.segmenter.segment(x);for(let d=0,y=0;d<v.length;d++)i[o]||(i[o]=[]),i[o].push(u+l+y<<12|v[d].length<<2|a),e.push(new lunr.Token(v[d].toLowerCase(),{position:o<<20|i[o].length-1})),y+=v[d].length;return}}i[o].push(u+l<<12|m-l<<2|a),e.push(new lunr.Token(g.slice(l,m).toLowerCase(),{position:o<<20|i[o].length-1}))})}})}return e}function ae(t,e=r=>r){return t.trim().split(/"([^"]+)"/g).map((r,n)=>n&1?r.replace(/^\b|^(?![^\x00-\x7F]|$)|\s+/g," +"):r).join("").replace(/"|(?:^|\s+)[*+\-:^~]+(?=\s+|$)/g,"").split(/\s+/g).reduce((r,n)=>{let i=e(n);return[...r,...Array.isArray(i)?i:[i]]},[]).map(r=>/([~^]$)/.test(r)?`${r}1`:r).map(r=>/(^[+-]|[~^]\d+$)/.test(r)?r:`${r}*`).join(" ")}function ue(t){return ae(t,e=>{let r=[],n=new lunr.QueryLexer(e);n.run();for(let{type:i,str:s,start:o,end:a}of n.lexemes)switch(i){case"FIELD":["title","text","tags"].includes(s)||(e=[e.slice(0,a)," ",e.slice(a+1)].join(""));break;case"TERM":W(s,lunr.tokenizer.separator,(...u)=>{r.push([e.slice(0,o),s.slice(...u),e.slice(a)].join(""))})}return r})}function ce(t){let e=new lunr.Query(["title","text","tags"]);new lunr.QueryParser(t,e).parse();for(let n of e.clauses)n.usePipeline=!0,n.term.startsWith("*")&&(n.wildcard=lunr.Query.wildcard.LEADING,n.term=n.term.slice(1)),n.term.endsWith("*")&&(n.wildcard=lunr.Query.wildcard.TRAILING,n.term=n.term.slice(0,-1));return e.clauses}function le(t,e){var i;let r=new Set(t),n={};for(let s=0;s<e.length;s++)for(let o of r)e[s].startsWith(o.term)&&(n[o.term]=!0,r.delete(o));for(let s of r)(i=lunr.stopWordFilter)!=null&&i.call(lunr,s.term)&&(n[s.term]=!1);return n}function he(t,e){let r=new Set,n=new Uint16Array(t.length);for(let s=0;s<t.length;s++)for(let o=s+1;o<t.length;o++)t.slice(s,o)in e&&(n[s]=o-s);let i=[0];for(let s=i.length;s>0;){let o=i[--s];for(let u=1;u<n[o];u++)n[o+u]>n[o]-u&&(r.add(t.slice(o,o+u)),i[s++]=o+u);let a=o+n[o];n[a]&&a<t.length-1&&(i[s++]=a),r.add(t.slice(o,a))}return r.has("")?new Set([t]):r}function Oe(t){return e=>r=>{if(typeof r[e]=="undefined")return;let n=[r.location,e].join(":");return t.set(n,lunr.tokenizer.table=[]),r[e]}}function Re(t,e){let[r,n]=[new Set(t),new Set(e)];return[...new Set([...r].filter(i=>!n.has(i)))]}var H=class{constructor({config:e,docs:r,options:n}){let i=Oe(this.table=new Map);this.map=ne(r),this.options=n,this.index=lunr(function(){this.metadataWhitelist=["position"],this.b(0),e.lang.length===1&&e.lang[0]!=="en"?this.use(lunr[e.lang[0]]):e.lang.length>1&&this.use(lunr.multiLanguage(...e.lang)),this.tokenizer=oe,lunr.tokenizer.separator=new RegExp(e.separator),lunr.segmenter="TinySegmenter"in lunr?new lunr.TinySegmenter:void 0;let s=Re(["trimmer","stopWordFilter","stemmer"],e.pipeline);for(let o of e.lang.map(a=>a==="en"?lunr:lunr[a]))for(let a of s)this.pipeline.remove(o[a]),this.searchPipeline.remove(o[a]);this.ref("location"),this.field("title",{boost:1e3,extractor:i("title")}),this.field("text",{boost:1,extractor:i("text")}),this.field("tags",{boost:1e6,extractor:i("tags")});for(let o of r)this.add(o,{boost:o.boost})})}search(e){if(e=e.replace(new RegExp("\\p{sc=Han}+","gu"),s=>[...he(s,this.index.invertedIndex)].join("* ")),e=ue(e),!e)return{items:[]};let r=ce(e).filter(s=>s.presence!==lunr.Query.presence.PROHIBITED),n=this.index.search(e).reduce((s,{ref:o,score:a,matchData:u})=>{let c=this.map.get(o);if(typeof c!="undefined"){c=A({},c),c.tags&&(c.tags=[...c.tags]);let f=le(r,Object.keys(u.metadata));for(let l of this.index.fields){if(typeof c[l]=="undefined")continue;let m=[];for(let d of Object.values(u.metadata))typeof d[l]!="undefined"&&m.push(...d[l].position);if(!m.length)continue;let x=this.table.get([c.location,l].join(":")),v=Array.isArray(c[l])?q:se;c[l]=v(c[l],x,m,l!=="text")}let g=+!c.parent+Object.values(f).filter(l=>l).length/Object.keys(f).length;s.push(G(A({},c),{score:a*(1+Z(g,2)),terms:f}))}return s},[]).sort((s,o)=>o.score-s.score).reduce((s,o)=>{let a=this.map.get(o.location);if(typeof a!="undefined"){let u=a.parent?a.parent.location:a.location;s.set(u,[...s.get(u)||[],o])}return s},new Map);for(let[s,o]of n)if(!o.find(a=>a.location===s)){let a=this.map.get(s);o.push(G(A({},a),{score:0,terms:{}}))}let i;if(this.options.suggest){let s=this.index.query(o=>{for(let a of r)o.term(a.term,{fields:["title"],presence:lunr.Query.presence.REQUIRED,wildcard:lunr.Query.wildcard.TRAILING})});i=s.length?Object.keys(s[0].matchData.metadata):[]}return A({items:[...n.values()]},typeof i!="undefined"&&{suggest:i})}};var fe;function Ie(t){return B(this,null,function*(){let e="../lunr";if(typeof parent!="undefined"&&"IFrameWorker"in parent){let n=re("script[src]"),[i]=n.src.split("/worker");e=e.replace("..",i)}let r=[];for(let n of t.lang){switch(n){case"ja":r.push(`${e}/tinyseg.js`);break;case"hi":case"th":r.push(`${e}/wordcut.js`);break}n!=="en"&&r.push(`${e}/min/lunr.${n}.min.js`)}t.lang.length>1&&r.push(`${e}/min/lunr.multi.min.js`),r.length&&(yield importScripts(`${e}/min/lunr.stemmer.support.min.js`,...r))})}function Fe(t){return B(this,null,function*(){switch(t.type){case 0:return yield Ie(t.data.config),fe=new H(t.data),{type:1};case 2:let e=t.data;try{return{type:3,data:fe.search(e)}}catch(r){return console.warn(`Invalid query: ${e} \u2013 see https://bit.ly/2s3ChXG`),console.warn(r),{type:3,data:{items:[]}}}default:throw new TypeError("Invalid message type")}})}self.lunr=de.default;addEventListener("message",t=>B(void 0,null,function*(){postMessage(yield Fe(t.data))}));})();
-//# sourceMappingURL=search.b8dbb3d2.min.js.map
-
diff --git a/0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js.map b/0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js.map
deleted file mode 100644
index 7ef0846c0..000000000
--- a/0.10.0/assets/javascripts/workers/search.b8dbb3d2.min.js.map
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["node_modules/lunr/lunr.js", "src/templates/assets/javascripts/integrations/search/worker/main/index.ts", "src/templates/assets/javascripts/browser/element/_/index.ts", "src/templates/assets/javascripts/polyfills/index.ts", "src/templates/assets/javascripts/integrations/search/config/index.ts", "src/templates/assets/javascripts/integrations/search/internal/_/index.ts", "src/templates/assets/javascripts/integrations/search/internal/extract/index.ts", "src/templates/assets/javascripts/integrations/search/internal/highlight/index.ts", "src/templates/assets/javascripts/integrations/search/internal/tokenize/index.ts", "src/templates/assets/javascripts/integrations/search/query/transform/index.ts", "src/templates/assets/javascripts/integrations/search/query/_/index.ts", "src/templates/assets/javascripts/integrations/search/query/segment/index.ts", "src/templates/assets/javascripts/integrations/search/_/index.ts"],
-  "sourcesContent": ["/**\n * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9\n * Copyright (C) 2020 Oliver Nightingale\n * @license MIT\n */\n\n;(function(){\n\n/**\n * A convenience function for configuring and constructing\n * a new lunr Index.\n *\n * A lunr.Builder instance is created and the pipeline setup\n * with a trimmer, stop word filter and stemmer.\n *\n * This builder object is yielded to the configuration function\n * that is passed as a parameter, allowing the list of fields\n * and other builder parameters to be customised.\n *\n * All documents _must_ be added within the passed config function.\n *\n * @example\n * var idx = lunr(function () {\n *   this.field('title')\n *   this.field('body')\n *   this.ref('id')\n *\n *   documents.forEach(function (doc) {\n *     this.add(doc)\n *   }, this)\n * })\n *\n * @see {@link lunr.Builder}\n * @see {@link lunr.Pipeline}\n * @see {@link lunr.trimmer}\n * @see {@link lunr.stopWordFilter}\n * @see {@link lunr.stemmer}\n * @namespace {function} lunr\n */\nvar lunr = function (config) {\n  var builder = new lunr.Builder\n\n  builder.pipeline.add(\n    lunr.trimmer,\n    lunr.stopWordFilter,\n    lunr.stemmer\n  )\n\n  builder.searchPipeline.add(\n    lunr.stemmer\n  )\n\n  config.call(builder, builder)\n  return builder.build()\n}\n\nlunr.version = \"2.3.9\"\n/*!\n * lunr.utils\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A namespace containing utils for the rest of the lunr library\n * @namespace lunr.utils\n */\nlunr.utils = {}\n\n/**\n * Print a warning message to the console.\n *\n * @param {String} message The message to be printed.\n * @memberOf lunr.utils\n * @function\n */\nlunr.utils.warn = (function (global) {\n  /* eslint-disable no-console */\n  return function (message) {\n    if (global.console && console.warn) {\n      console.warn(message)\n    }\n  }\n  /* eslint-enable no-console */\n})(this)\n\n/**\n * Convert an object to a string.\n *\n * In the case of `null` and `undefined` the function returns\n * the empty string, in all other cases the result of calling\n * `toString` on the passed object is returned.\n *\n * @param {Any} obj The object to convert to a string.\n * @return {String} string representation of the passed object.\n * @memberOf lunr.utils\n */\nlunr.utils.asString = function (obj) {\n  if (obj === void 0 || obj === null) {\n    return \"\"\n  } else {\n    return obj.toString()\n  }\n}\n\n/**\n * Clones an object.\n *\n * Will create a copy of an existing object such that any mutations\n * on the copy cannot affect the original.\n *\n * Only shallow objects are supported, passing a nested object to this\n * function will cause a TypeError.\n *\n * Objects with primitives, and arrays of primitives are supported.\n *\n * @param {Object} obj The object to clone.\n * @return {Object} a clone of the passed object.\n * @throws {TypeError} when a nested object is passed.\n * @memberOf Utils\n */\nlunr.utils.clone = function (obj) {\n  if (obj === null || obj === undefined) {\n    return obj\n  }\n\n  var clone = Object.create(null),\n      keys = Object.keys(obj)\n\n  for (var i = 0; i < keys.length; i++) {\n    var key = keys[i],\n        val = obj[key]\n\n    if (Array.isArray(val)) {\n      clone[key] = val.slice()\n      continue\n    }\n\n    if (typeof val === 'string' ||\n        typeof val === 'number' ||\n        typeof val === 'boolean') {\n      clone[key] = val\n      continue\n    }\n\n    throw new TypeError(\"clone is not deep and does not support nested objects\")\n  }\n\n  return clone\n}\nlunr.FieldRef = function (docRef, fieldName, stringValue) {\n  this.docRef = docRef\n  this.fieldName = fieldName\n  this._stringValue = stringValue\n}\n\nlunr.FieldRef.joiner = \"/\"\n\nlunr.FieldRef.fromString = function (s) {\n  var n = s.indexOf(lunr.FieldRef.joiner)\n\n  if (n === -1) {\n    throw \"malformed field ref string\"\n  }\n\n  var fieldRef = s.slice(0, n),\n      docRef = s.slice(n + 1)\n\n  return new lunr.FieldRef (docRef, fieldRef, s)\n}\n\nlunr.FieldRef.prototype.toString = function () {\n  if (this._stringValue == undefined) {\n    this._stringValue = this.fieldName + lunr.FieldRef.joiner + this.docRef\n  }\n\n  return this._stringValue\n}\n/*!\n * lunr.Set\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A lunr set.\n *\n * @constructor\n */\nlunr.Set = function (elements) {\n  this.elements = Object.create(null)\n\n  if (elements) {\n    this.length = elements.length\n\n    for (var i = 0; i < this.length; i++) {\n      this.elements[elements[i]] = true\n    }\n  } else {\n    this.length = 0\n  }\n}\n\n/**\n * A complete set that contains all elements.\n *\n * @static\n * @readonly\n * @type {lunr.Set}\n */\nlunr.Set.complete = {\n  intersect: function (other) {\n    return other\n  },\n\n  union: function () {\n    return this\n  },\n\n  contains: function () {\n    return true\n  }\n}\n\n/**\n * An empty set that contains no elements.\n *\n * @static\n * @readonly\n * @type {lunr.Set}\n */\nlunr.Set.empty = {\n  intersect: function () {\n    return this\n  },\n\n  union: function (other) {\n    return other\n  },\n\n  contains: function () {\n    return false\n  }\n}\n\n/**\n * Returns true if this set contains the specified object.\n *\n * @param {object} object - Object whose presence in this set is to be tested.\n * @returns {boolean} - True if this set contains the specified object.\n */\nlunr.Set.prototype.contains = function (object) {\n  return !!this.elements[object]\n}\n\n/**\n * Returns a new set containing only the elements that are present in both\n * this set and the specified set.\n *\n * @param {lunr.Set} other - set to intersect with this set.\n * @returns {lunr.Set} a new set that is the intersection of this and the specified set.\n */\n\nlunr.Set.prototype.intersect = function (other) {\n  var a, b, elements, intersection = []\n\n  if (other === lunr.Set.complete) {\n    return this\n  }\n\n  if (other === lunr.Set.empty) {\n    return other\n  }\n\n  if (this.length < other.length) {\n    a = this\n    b = other\n  } else {\n    a = other\n    b = this\n  }\n\n  elements = Object.keys(a.elements)\n\n  for (var i = 0; i < elements.length; i++) {\n    var element = elements[i]\n    if (element in b.elements) {\n      intersection.push(element)\n    }\n  }\n\n  return new lunr.Set (intersection)\n}\n\n/**\n * Returns a new set combining the elements of this and the specified set.\n *\n * @param {lunr.Set} other - set to union with this set.\n * @return {lunr.Set} a new set that is the union of this and the specified set.\n */\n\nlunr.Set.prototype.union = function (other) {\n  if (other === lunr.Set.complete) {\n    return lunr.Set.complete\n  }\n\n  if (other === lunr.Set.empty) {\n    return this\n  }\n\n  return new lunr.Set(Object.keys(this.elements).concat(Object.keys(other.elements)))\n}\n/**\n * A function to calculate the inverse document frequency for\n * a posting. This is shared between the builder and the index\n *\n * @private\n * @param {object} posting - The posting for a given term\n * @param {number} documentCount - The total number of documents.\n */\nlunr.idf = function (posting, documentCount) {\n  var documentsWithTerm = 0\n\n  for (var fieldName in posting) {\n    if (fieldName == '_index') continue // Ignore the term index, its not a field\n    documentsWithTerm += Object.keys(posting[fieldName]).length\n  }\n\n  var x = (documentCount - documentsWithTerm + 0.5) / (documentsWithTerm + 0.5)\n\n  return Math.log(1 + Math.abs(x))\n}\n\n/**\n * A token wraps a string representation of a token\n * as it is passed through the text processing pipeline.\n *\n * @constructor\n * @param {string} [str=''] - The string token being wrapped.\n * @param {object} [metadata={}] - Metadata associated with this token.\n */\nlunr.Token = function (str, metadata) {\n  this.str = str || \"\"\n  this.metadata = metadata || {}\n}\n\n/**\n * Returns the token string that is being wrapped by this object.\n *\n * @returns {string}\n */\nlunr.Token.prototype.toString = function () {\n  return this.str\n}\n\n/**\n * A token update function is used when updating or optionally\n * when cloning a token.\n *\n * @callback lunr.Token~updateFunction\n * @param {string} str - The string representation of the token.\n * @param {Object} metadata - All metadata associated with this token.\n */\n\n/**\n * Applies the given function to the wrapped string token.\n *\n * @example\n * token.update(function (str, metadata) {\n *   return str.toUpperCase()\n * })\n *\n * @param {lunr.Token~updateFunction} fn - A function to apply to the token string.\n * @returns {lunr.Token}\n */\nlunr.Token.prototype.update = function (fn) {\n  this.str = fn(this.str, this.metadata)\n  return this\n}\n\n/**\n * Creates a clone of this token. Optionally a function can be\n * applied to the cloned token.\n *\n * @param {lunr.Token~updateFunction} [fn] - An optional function to apply to the cloned token.\n * @returns {lunr.Token}\n */\nlunr.Token.prototype.clone = function (fn) {\n  fn = fn || function (s) { return s }\n  return new lunr.Token (fn(this.str, this.metadata), this.metadata)\n}\n/*!\n * lunr.tokenizer\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A function for splitting a string into tokens ready to be inserted into\n * the search index. Uses `lunr.tokenizer.separator` to split strings, change\n * the value of this property to change how strings are split into tokens.\n *\n * This tokenizer will convert its parameter to a string by calling `toString` and\n * then will split this string on the character in `lunr.tokenizer.separator`.\n * Arrays will have their elements converted to strings and wrapped in a lunr.Token.\n *\n * Optional metadata can be passed to the tokenizer, this metadata will be cloned and\n * added as metadata to every token that is created from the object to be tokenized.\n *\n * @static\n * @param {?(string|object|object[])} obj - The object to convert into tokens\n * @param {?object} metadata - Optional metadata to associate with every token\n * @returns {lunr.Token[]}\n * @see {@link lunr.Pipeline}\n */\nlunr.tokenizer = function (obj, metadata) {\n  if (obj == null || obj == undefined) {\n    return []\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(function (t) {\n      return new lunr.Token(\n        lunr.utils.asString(t).toLowerCase(),\n        lunr.utils.clone(metadata)\n      )\n    })\n  }\n\n  var str = obj.toString().toLowerCase(),\n      len = str.length,\n      tokens = []\n\n  for (var sliceEnd = 0, sliceStart = 0; sliceEnd <= len; sliceEnd++) {\n    var char = str.charAt(sliceEnd),\n        sliceLength = sliceEnd - sliceStart\n\n    if ((char.match(lunr.tokenizer.separator) || sliceEnd == len)) {\n\n      if (sliceLength > 0) {\n        var tokenMetadata = lunr.utils.clone(metadata) || {}\n        tokenMetadata[\"position\"] = [sliceStart, sliceLength]\n        tokenMetadata[\"index\"] = tokens.length\n\n        tokens.push(\n          new lunr.Token (\n            str.slice(sliceStart, sliceEnd),\n            tokenMetadata\n          )\n        )\n      }\n\n      sliceStart = sliceEnd + 1\n    }\n\n  }\n\n  return tokens\n}\n\n/**\n * The separator used to split a string into tokens. Override this property to change the behaviour of\n * `lunr.tokenizer` behaviour when tokenizing strings. By default this splits on whitespace and hyphens.\n *\n * @static\n * @see lunr.tokenizer\n */\nlunr.tokenizer.separator = /[\\s\\-]+/\n/*!\n * lunr.Pipeline\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.Pipelines maintain an ordered list of functions to be applied to all\n * tokens in documents entering the search index and queries being ran against\n * the index.\n *\n * An instance of lunr.Index created with the lunr shortcut will contain a\n * pipeline with a stop word filter and an English language stemmer. Extra\n * functions can be added before or after either of these functions or these\n * default functions can be removed.\n *\n * When run the pipeline will call each function in turn, passing a token, the\n * index of that token in the original list of all tokens and finally a list of\n * all the original tokens.\n *\n * The output of functions in the pipeline will be passed to the next function\n * in the pipeline. To exclude a token from entering the index the function\n * should return undefined, the rest of the pipeline will not be called with\n * this token.\n *\n * For serialisation of pipelines to work, all functions used in an instance of\n * a pipeline should be registered with lunr.Pipeline. Registered functions can\n * then be loaded. If trying to load a serialised pipeline that uses functions\n * that are not registered an error will be thrown.\n *\n * If not planning on serialising the pipeline then registering pipeline functions\n * is not necessary.\n *\n * @constructor\n */\nlunr.Pipeline = function () {\n  this._stack = []\n}\n\nlunr.Pipeline.registeredFunctions = Object.create(null)\n\n/**\n * A pipeline function maps lunr.Token to lunr.Token. A lunr.Token contains the token\n * string as well as all known metadata. A pipeline function can mutate the token string\n * or mutate (or add) metadata for a given token.\n *\n * A pipeline function can indicate that the passed token should be discarded by returning\n * null, undefined or an empty string. This token will not be passed to any downstream pipeline\n * functions and will not be added to the index.\n *\n * Multiple tokens can be returned by returning an array of tokens. Each token will be passed\n * to any downstream pipeline functions and all will returned tokens will be added to the index.\n *\n * Any number of pipeline functions may be chained together using a lunr.Pipeline.\n *\n * @interface lunr.PipelineFunction\n * @param {lunr.Token} token - A token from the document being processed.\n * @param {number} i - The index of this token in the complete list of tokens for this document/field.\n * @param {lunr.Token[]} tokens - All tokens for this document/field.\n * @returns {(?lunr.Token|lunr.Token[])}\n */\n\n/**\n * Register a function with the pipeline.\n *\n * Functions that are used in the pipeline should be registered if the pipeline\n * needs to be serialised, or a serialised pipeline needs to be loaded.\n *\n * Registering a function does not add it to a pipeline, functions must still be\n * added to instances of the pipeline for them to be used when running a pipeline.\n *\n * @param {lunr.PipelineFunction} fn - The function to check for.\n * @param {String} label - The label to register this function with\n */\nlunr.Pipeline.registerFunction = function (fn, label) {\n  if (label in this.registeredFunctions) {\n    lunr.utils.warn('Overwriting existing registered function: ' + label)\n  }\n\n  fn.label = label\n  lunr.Pipeline.registeredFunctions[fn.label] = fn\n}\n\n/**\n * Warns if the function is not registered as a Pipeline function.\n *\n * @param {lunr.PipelineFunction} fn - The function to check for.\n * @private\n */\nlunr.Pipeline.warnIfFunctionNotRegistered = function (fn) {\n  var isRegistered = fn.label && (fn.label in this.registeredFunctions)\n\n  if (!isRegistered) {\n    lunr.utils.warn('Function is not registered with pipeline. This may cause problems when serialising the index.\\n', fn)\n  }\n}\n\n/**\n * Loads a previously serialised pipeline.\n *\n * All functions to be loaded must already be registered with lunr.Pipeline.\n * If any function from the serialised data has not been registered then an\n * error will be thrown.\n *\n * @param {Object} serialised - The serialised pipeline to load.\n * @returns {lunr.Pipeline}\n */\nlunr.Pipeline.load = function (serialised) {\n  var pipeline = new lunr.Pipeline\n\n  serialised.forEach(function (fnName) {\n    var fn = lunr.Pipeline.registeredFunctions[fnName]\n\n    if (fn) {\n      pipeline.add(fn)\n    } else {\n      throw new Error('Cannot load unregistered function: ' + fnName)\n    }\n  })\n\n  return pipeline\n}\n\n/**\n * Adds new functions to the end of the pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction[]} functions - Any number of functions to add to the pipeline.\n */\nlunr.Pipeline.prototype.add = function () {\n  var fns = Array.prototype.slice.call(arguments)\n\n  fns.forEach(function (fn) {\n    lunr.Pipeline.warnIfFunctionNotRegistered(fn)\n    this._stack.push(fn)\n  }, this)\n}\n\n/**\n * Adds a single function after a function that already exists in the\n * pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.\n * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.\n */\nlunr.Pipeline.prototype.after = function (existingFn, newFn) {\n  lunr.Pipeline.warnIfFunctionNotRegistered(newFn)\n\n  var pos = this._stack.indexOf(existingFn)\n  if (pos == -1) {\n    throw new Error('Cannot find existingFn')\n  }\n\n  pos = pos + 1\n  this._stack.splice(pos, 0, newFn)\n}\n\n/**\n * Adds a single function before a function that already exists in the\n * pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.\n * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.\n */\nlunr.Pipeline.prototype.before = function (existingFn, newFn) {\n  lunr.Pipeline.warnIfFunctionNotRegistered(newFn)\n\n  var pos = this._stack.indexOf(existingFn)\n  if (pos == -1) {\n    throw new Error('Cannot find existingFn')\n  }\n\n  this._stack.splice(pos, 0, newFn)\n}\n\n/**\n * Removes a function from the pipeline.\n *\n * @param {lunr.PipelineFunction} fn The function to remove from the pipeline.\n */\nlunr.Pipeline.prototype.remove = function (fn) {\n  var pos = this._stack.indexOf(fn)\n  if (pos == -1) {\n    return\n  }\n\n  this._stack.splice(pos, 1)\n}\n\n/**\n * Runs the current list of functions that make up the pipeline against the\n * passed tokens.\n *\n * @param {Array} tokens The tokens to run through the pipeline.\n * @returns {Array}\n */\nlunr.Pipeline.prototype.run = function (tokens) {\n  var stackLength = this._stack.length\n\n  for (var i = 0; i < stackLength; i++) {\n    var fn = this._stack[i]\n    var memo = []\n\n    for (var j = 0; j < tokens.length; j++) {\n      var result = fn(tokens[j], j, tokens)\n\n      if (result === null || result === void 0 || result === '') continue\n\n      if (Array.isArray(result)) {\n        for (var k = 0; k < result.length; k++) {\n          memo.push(result[k])\n        }\n      } else {\n        memo.push(result)\n      }\n    }\n\n    tokens = memo\n  }\n\n  return tokens\n}\n\n/**\n * Convenience method for passing a string through a pipeline and getting\n * strings out. This method takes care of wrapping the passed string in a\n * token and mapping the resulting tokens back to strings.\n *\n * @param {string} str - The string to pass through the pipeline.\n * @param {?object} metadata - Optional metadata to associate with the token\n * passed to the pipeline.\n * @returns {string[]}\n */\nlunr.Pipeline.prototype.runString = function (str, metadata) {\n  var token = new lunr.Token (str, metadata)\n\n  return this.run([token]).map(function (t) {\n    return t.toString()\n  })\n}\n\n/**\n * Resets the pipeline by removing any existing processors.\n *\n */\nlunr.Pipeline.prototype.reset = function () {\n  this._stack = []\n}\n\n/**\n * Returns a representation of the pipeline ready for serialisation.\n *\n * Logs a warning if the function has not been registered.\n *\n * @returns {Array}\n */\nlunr.Pipeline.prototype.toJSON = function () {\n  return this._stack.map(function (fn) {\n    lunr.Pipeline.warnIfFunctionNotRegistered(fn)\n\n    return fn.label\n  })\n}\n/*!\n * lunr.Vector\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A vector is used to construct the vector space of documents and queries. These\n * vectors support operations to determine the similarity between two documents or\n * a document and a query.\n *\n * Normally no parameters are required for initializing a vector, but in the case of\n * loading a previously dumped vector the raw elements can be provided to the constructor.\n *\n * For performance reasons vectors are implemented with a flat array, where an elements\n * index is immediately followed by its value. E.g. [index, value, index, value]. This\n * allows the underlying array to be as sparse as possible and still offer decent\n * performance when being used for vector calculations.\n *\n * @constructor\n * @param {Number[]} [elements] - The flat list of element index and element value pairs.\n */\nlunr.Vector = function (elements) {\n  this._magnitude = 0\n  this.elements = elements || []\n}\n\n\n/**\n * Calculates the position within the vector to insert a given index.\n *\n * This is used internally by insert and upsert. If there are duplicate indexes then\n * the position is returned as if the value for that index were to be updated, but it\n * is the callers responsibility to check whether there is a duplicate at that index\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @returns {Number}\n */\nlunr.Vector.prototype.positionForIndex = function (index) {\n  // For an empty vector the tuple can be inserted at the beginning\n  if (this.elements.length == 0) {\n    return 0\n  }\n\n  var start = 0,\n      end = this.elements.length / 2,\n      sliceLength = end - start,\n      pivotPoint = Math.floor(sliceLength / 2),\n      pivotIndex = this.elements[pivotPoint * 2]\n\n  while (sliceLength > 1) {\n    if (pivotIndex < index) {\n      start = pivotPoint\n    }\n\n    if (pivotIndex > index) {\n      end = pivotPoint\n    }\n\n    if (pivotIndex == index) {\n      break\n    }\n\n    sliceLength = end - start\n    pivotPoint = start + Math.floor(sliceLength / 2)\n    pivotIndex = this.elements[pivotPoint * 2]\n  }\n\n  if (pivotIndex == index) {\n    return pivotPoint * 2\n  }\n\n  if (pivotIndex > index) {\n    return pivotPoint * 2\n  }\n\n  if (pivotIndex < index) {\n    return (pivotPoint + 1) * 2\n  }\n}\n\n/**\n * Inserts an element at an index within the vector.\n *\n * Does not allow duplicates, will throw an error if there is already an entry\n * for this index.\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @param {Number} val - The value to be inserted into the vector.\n */\nlunr.Vector.prototype.insert = function (insertIdx, val) {\n  this.upsert(insertIdx, val, function () {\n    throw \"duplicate index\"\n  })\n}\n\n/**\n * Inserts or updates an existing index within the vector.\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @param {Number} val - The value to be inserted into the vector.\n * @param {function} fn - A function that is called for updates, the existing value and the\n * requested value are passed as arguments\n */\nlunr.Vector.prototype.upsert = function (insertIdx, val, fn) {\n  this._magnitude = 0\n  var position = this.positionForIndex(insertIdx)\n\n  if (this.elements[position] == insertIdx) {\n    this.elements[position + 1] = fn(this.elements[position + 1], val)\n  } else {\n    this.elements.splice(position, 0, insertIdx, val)\n  }\n}\n\n/**\n * Calculates the magnitude of this vector.\n *\n * @returns {Number}\n */\nlunr.Vector.prototype.magnitude = function () {\n  if (this._magnitude) return this._magnitude\n\n  var sumOfSquares = 0,\n      elementsLength = this.elements.length\n\n  for (var i = 1; i < elementsLength; i += 2) {\n    var val = this.elements[i]\n    sumOfSquares += val * val\n  }\n\n  return this._magnitude = Math.sqrt(sumOfSquares)\n}\n\n/**\n * Calculates the dot product of this vector and another vector.\n *\n * @param {lunr.Vector} otherVector - The vector to compute the dot product with.\n * @returns {Number}\n */\nlunr.Vector.prototype.dot = function (otherVector) {\n  var dotProduct = 0,\n      a = this.elements, b = otherVector.elements,\n      aLen = a.length, bLen = b.length,\n      aVal = 0, bVal = 0,\n      i = 0, j = 0\n\n  while (i < aLen && j < bLen) {\n    aVal = a[i], bVal = b[j]\n    if (aVal < bVal) {\n      i += 2\n    } else if (aVal > bVal) {\n      j += 2\n    } else if (aVal == bVal) {\n      dotProduct += a[i + 1] * b[j + 1]\n      i += 2\n      j += 2\n    }\n  }\n\n  return dotProduct\n}\n\n/**\n * Calculates the similarity between this vector and another vector.\n *\n * @param {lunr.Vector} otherVector - The other vector to calculate the\n * similarity with.\n * @returns {Number}\n */\nlunr.Vector.prototype.similarity = function (otherVector) {\n  return this.dot(otherVector) / this.magnitude() || 0\n}\n\n/**\n * Converts the vector to an array of the elements within the vector.\n *\n * @returns {Number[]}\n */\nlunr.Vector.prototype.toArray = function () {\n  var output = new Array (this.elements.length / 2)\n\n  for (var i = 1, j = 0; i < this.elements.length; i += 2, j++) {\n    output[j] = this.elements[i]\n  }\n\n  return output\n}\n\n/**\n * A JSON serializable representation of the vector.\n *\n * @returns {Number[]}\n */\nlunr.Vector.prototype.toJSON = function () {\n  return this.elements\n}\n/* eslint-disable */\n/*!\n * lunr.stemmer\n * Copyright (C) 2020 Oliver Nightingale\n * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt\n */\n\n/**\n * lunr.stemmer is an english language stemmer, this is a JavaScript\n * implementation of the PorterStemmer taken from http://tartarus.org/~martin\n *\n * @static\n * @implements {lunr.PipelineFunction}\n * @param {lunr.Token} token - The string to stem\n * @returns {lunr.Token}\n * @see {@link lunr.Pipeline}\n * @function\n */\nlunr.stemmer = (function(){\n  var step2list = {\n      \"ational\" : \"ate\",\n      \"tional\" : \"tion\",\n      \"enci\" : \"ence\",\n      \"anci\" : \"ance\",\n      \"izer\" : \"ize\",\n      \"bli\" : \"ble\",\n      \"alli\" : \"al\",\n      \"entli\" : \"ent\",\n      \"eli\" : \"e\",\n      \"ousli\" : \"ous\",\n      \"ization\" : \"ize\",\n      \"ation\" : \"ate\",\n      \"ator\" : \"ate\",\n      \"alism\" : \"al\",\n      \"iveness\" : \"ive\",\n      \"fulness\" : \"ful\",\n      \"ousness\" : \"ous\",\n      \"aliti\" : \"al\",\n      \"iviti\" : \"ive\",\n      \"biliti\" : \"ble\",\n      \"logi\" : \"log\"\n    },\n\n    step3list = {\n      \"icate\" : \"ic\",\n      \"ative\" : \"\",\n      \"alize\" : \"al\",\n      \"iciti\" : \"ic\",\n      \"ical\" : \"ic\",\n      \"ful\" : \"\",\n      \"ness\" : \"\"\n    },\n\n    c = \"[^aeiou]\",          // consonant\n    v = \"[aeiouy]\",          // vowel\n    C = c + \"[^aeiouy]*\",    // consonant sequence\n    V = v + \"[aeiou]*\",      // vowel sequence\n\n    mgr0 = \"^(\" + C + \")?\" + V + C,               // [C]VC... is m>0\n    meq1 = \"^(\" + C + \")?\" + V + C + \"(\" + V + \")?$\",  // [C]VC[V] is m=1\n    mgr1 = \"^(\" + C + \")?\" + V + C + V + C,       // [C]VCVC... is m>1\n    s_v = \"^(\" + C + \")?\" + v;                   // vowel in stem\n\n  var re_mgr0 = new RegExp(mgr0);\n  var re_mgr1 = new RegExp(mgr1);\n  var re_meq1 = new RegExp(meq1);\n  var re_s_v = new RegExp(s_v);\n\n  var re_1a = /^(.+?)(ss|i)es$/;\n  var re2_1a = /^(.+?)([^s])s$/;\n  var re_1b = /^(.+?)eed$/;\n  var re2_1b = /^(.+?)(ed|ing)$/;\n  var re_1b_2 = /.$/;\n  var re2_1b_2 = /(at|bl|iz)$/;\n  var re3_1b_2 = new RegExp(\"([^aeiouylsz])\\\\1$\");\n  var re4_1b_2 = new RegExp(\"^\" + C + v + \"[^aeiouwxy]$\");\n\n  var re_1c = /^(.+?[^aeiou])y$/;\n  var re_2 = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;\n\n  var re_3 = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;\n\n  var re_4 = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;\n  var re2_4 = /^(.+?)(s|t)(ion)$/;\n\n  var re_5 = /^(.+?)e$/;\n  var re_5_1 = /ll$/;\n  var re3_5 = new RegExp(\"^\" + C + v + \"[^aeiouwxy]$\");\n\n  var porterStemmer = function porterStemmer(w) {\n    var stem,\n      suffix,\n      firstch,\n      re,\n      re2,\n      re3,\n      re4;\n\n    if (w.length < 3) { return w; }\n\n    firstch = w.substr(0,1);\n    if (firstch == \"y\") {\n      w = firstch.toUpperCase() + w.substr(1);\n    }\n\n    // Step 1a\n    re = re_1a\n    re2 = re2_1a;\n\n    if (re.test(w)) { w = w.replace(re,\"$1$2\"); }\n    else if (re2.test(w)) { w = w.replace(re2,\"$1$2\"); }\n\n    // Step 1b\n    re = re_1b;\n    re2 = re2_1b;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      re = re_mgr0;\n      if (re.test(fp[1])) {\n        re = re_1b_2;\n        w = w.replace(re,\"\");\n      }\n    } else if (re2.test(w)) {\n      var fp = re2.exec(w);\n      stem = fp[1];\n      re2 = re_s_v;\n      if (re2.test(stem)) {\n        w = stem;\n        re2 = re2_1b_2;\n        re3 = re3_1b_2;\n        re4 = re4_1b_2;\n        if (re2.test(w)) { w = w + \"e\"; }\n        else if (re3.test(w)) { re = re_1b_2; w = w.replace(re,\"\"); }\n        else if (re4.test(w)) { w = w + \"e\"; }\n      }\n    }\n\n    // Step 1c - replace suffix y or Y by i if preceded by a non-vowel which is not the first letter of the word (so cry -> cri, by -> by, say -> say)\n    re = re_1c;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      w = stem + \"i\";\n    }\n\n    // Step 2\n    re = re_2;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      suffix = fp[2];\n      re = re_mgr0;\n      if (re.test(stem)) {\n        w = stem + step2list[suffix];\n      }\n    }\n\n    // Step 3\n    re = re_3;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      suffix = fp[2];\n      re = re_mgr0;\n      if (re.test(stem)) {\n        w = stem + step3list[suffix];\n      }\n    }\n\n    // Step 4\n    re = re_4;\n    re2 = re2_4;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      re = re_mgr1;\n      if (re.test(stem)) {\n        w = stem;\n      }\n    } else if (re2.test(w)) {\n      var fp = re2.exec(w);\n      stem = fp[1] + fp[2];\n      re2 = re_mgr1;\n      if (re2.test(stem)) {\n        w = stem;\n      }\n    }\n\n    // Step 5\n    re = re_5;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      re = re_mgr1;\n      re2 = re_meq1;\n      re3 = re3_5;\n      if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) {\n        w = stem;\n      }\n    }\n\n    re = re_5_1;\n    re2 = re_mgr1;\n    if (re.test(w) && re2.test(w)) {\n      re = re_1b_2;\n      w = w.replace(re,\"\");\n    }\n\n    // and turn initial Y back to y\n\n    if (firstch == \"y\") {\n      w = firstch.toLowerCase() + w.substr(1);\n    }\n\n    return w;\n  };\n\n  return function (token) {\n    return token.update(porterStemmer);\n  }\n})();\n\nlunr.Pipeline.registerFunction(lunr.stemmer, 'stemmer')\n/*!\n * lunr.stopWordFilter\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.generateStopWordFilter builds a stopWordFilter function from the provided\n * list of stop words.\n *\n * The built in lunr.stopWordFilter is built using this generator and can be used\n * to generate custom stopWordFilters for applications or non English languages.\n *\n * @function\n * @param {Array} token The token to pass through the filter\n * @returns {lunr.PipelineFunction}\n * @see lunr.Pipeline\n * @see lunr.stopWordFilter\n */\nlunr.generateStopWordFilter = function (stopWords) {\n  var words = stopWords.reduce(function (memo, stopWord) {\n    memo[stopWord] = stopWord\n    return memo\n  }, {})\n\n  return function (token) {\n    if (token && words[token.toString()] !== token.toString()) return token\n  }\n}\n\n/**\n * lunr.stopWordFilter is an English language stop word list filter, any words\n * contained in the list will not be passed through the filter.\n *\n * This is intended to be used in the Pipeline. If the token does not pass the\n * filter then undefined will be returned.\n *\n * @function\n * @implements {lunr.PipelineFunction}\n * @params {lunr.Token} token - A token to check for being a stop word.\n * @returns {lunr.Token}\n * @see {@link lunr.Pipeline}\n */\nlunr.stopWordFilter = lunr.generateStopWordFilter([\n  'a',\n  'able',\n  'about',\n  'across',\n  'after',\n  'all',\n  'almost',\n  'also',\n  'am',\n  'among',\n  'an',\n  'and',\n  'any',\n  'are',\n  'as',\n  'at',\n  'be',\n  'because',\n  'been',\n  'but',\n  'by',\n  'can',\n  'cannot',\n  'could',\n  'dear',\n  'did',\n  'do',\n  'does',\n  'either',\n  'else',\n  'ever',\n  'every',\n  'for',\n  'from',\n  'get',\n  'got',\n  'had',\n  'has',\n  'have',\n  'he',\n  'her',\n  'hers',\n  'him',\n  'his',\n  'how',\n  'however',\n  'i',\n  'if',\n  'in',\n  'into',\n  'is',\n  'it',\n  'its',\n  'just',\n  'least',\n  'let',\n  'like',\n  'likely',\n  'may',\n  'me',\n  'might',\n  'most',\n  'must',\n  'my',\n  'neither',\n  'no',\n  'nor',\n  'not',\n  'of',\n  'off',\n  'often',\n  'on',\n  'only',\n  'or',\n  'other',\n  'our',\n  'own',\n  'rather',\n  'said',\n  'say',\n  'says',\n  'she',\n  'should',\n  'since',\n  'so',\n  'some',\n  'than',\n  'that',\n  'the',\n  'their',\n  'them',\n  'then',\n  'there',\n  'these',\n  'they',\n  'this',\n  'tis',\n  'to',\n  'too',\n  'twas',\n  'us',\n  'wants',\n  'was',\n  'we',\n  'were',\n  'what',\n  'when',\n  'where',\n  'which',\n  'while',\n  'who',\n  'whom',\n  'why',\n  'will',\n  'with',\n  'would',\n  'yet',\n  'you',\n  'your'\n])\n\nlunr.Pipeline.registerFunction(lunr.stopWordFilter, 'stopWordFilter')\n/*!\n * lunr.trimmer\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.trimmer is a pipeline function for trimming non word\n * characters from the beginning and end of tokens before they\n * enter the index.\n *\n * This implementation may not work correctly for non latin\n * characters and should either be removed or adapted for use\n * with languages with non-latin characters.\n *\n * @static\n * @implements {lunr.PipelineFunction}\n * @param {lunr.Token} token The token to pass through the filter\n * @returns {lunr.Token}\n * @see lunr.Pipeline\n */\nlunr.trimmer = function (token) {\n  return token.update(function (s) {\n    return s.replace(/^\\W+/, '').replace(/\\W+$/, '')\n  })\n}\n\nlunr.Pipeline.registerFunction(lunr.trimmer, 'trimmer')\n/*!\n * lunr.TokenSet\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A token set is used to store the unique list of all tokens\n * within an index. Token sets are also used to represent an\n * incoming query to the index, this query token set and index\n * token set are then intersected to find which tokens to look\n * up in the inverted index.\n *\n * A token set can hold multiple tokens, as in the case of the\n * index token set, or it can hold a single token as in the\n * case of a simple query token set.\n *\n * Additionally token sets are used to perform wildcard matching.\n * Leading, contained and trailing wildcards are supported, and\n * from this edit distance matching can also be provided.\n *\n * Token sets are implemented as a minimal finite state automata,\n * where both common prefixes and suffixes are shared between tokens.\n * This helps to reduce the space used for storing the token set.\n *\n * @constructor\n */\nlunr.TokenSet = function () {\n  this.final = false\n  this.edges = {}\n  this.id = lunr.TokenSet._nextId\n  lunr.TokenSet._nextId += 1\n}\n\n/**\n * Keeps track of the next, auto increment, identifier to assign\n * to a new tokenSet.\n *\n * TokenSets require a unique identifier to be correctly minimised.\n *\n * @private\n */\nlunr.TokenSet._nextId = 1\n\n/**\n * Creates a TokenSet instance from the given sorted array of words.\n *\n * @param {String[]} arr - A sorted array of strings to create the set from.\n * @returns {lunr.TokenSet}\n * @throws Will throw an error if the input array is not sorted.\n */\nlunr.TokenSet.fromArray = function (arr) {\n  var builder = new lunr.TokenSet.Builder\n\n  for (var i = 0, len = arr.length; i < len; i++) {\n    builder.insert(arr[i])\n  }\n\n  builder.finish()\n  return builder.root\n}\n\n/**\n * Creates a token set from a query clause.\n *\n * @private\n * @param {Object} clause - A single clause from lunr.Query.\n * @param {string} clause.term - The query clause term.\n * @param {number} [clause.editDistance] - The optional edit distance for the term.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.fromClause = function (clause) {\n  if ('editDistance' in clause) {\n    return lunr.TokenSet.fromFuzzyString(clause.term, clause.editDistance)\n  } else {\n    return lunr.TokenSet.fromString(clause.term)\n  }\n}\n\n/**\n * Creates a token set representing a single string with a specified\n * edit distance.\n *\n * Insertions, deletions, substitutions and transpositions are each\n * treated as an edit distance of 1.\n *\n * Increasing the allowed edit distance will have a dramatic impact\n * on the performance of both creating and intersecting these TokenSets.\n * It is advised to keep the edit distance less than 3.\n *\n * @param {string} str - The string to create the token set from.\n * @param {number} editDistance - The allowed edit distance to match.\n * @returns {lunr.Vector}\n */\nlunr.TokenSet.fromFuzzyString = function (str, editDistance) {\n  var root = new lunr.TokenSet\n\n  var stack = [{\n    node: root,\n    editsRemaining: editDistance,\n    str: str\n  }]\n\n  while (stack.length) {\n    var frame = stack.pop()\n\n    // no edit\n    if (frame.str.length > 0) {\n      var char = frame.str.charAt(0),\n          noEditNode\n\n      if (char in frame.node.edges) {\n        noEditNode = frame.node.edges[char]\n      } else {\n        noEditNode = new lunr.TokenSet\n        frame.node.edges[char] = noEditNode\n      }\n\n      if (frame.str.length == 1) {\n        noEditNode.final = true\n      }\n\n      stack.push({\n        node: noEditNode,\n        editsRemaining: frame.editsRemaining,\n        str: frame.str.slice(1)\n      })\n    }\n\n    if (frame.editsRemaining == 0) {\n      continue\n    }\n\n    // insertion\n    if (\"*\" in frame.node.edges) {\n      var insertionNode = frame.node.edges[\"*\"]\n    } else {\n      var insertionNode = new lunr.TokenSet\n      frame.node.edges[\"*\"] = insertionNode\n    }\n\n    if (frame.str.length == 0) {\n      insertionNode.final = true\n    }\n\n    stack.push({\n      node: insertionNode,\n      editsRemaining: frame.editsRemaining - 1,\n      str: frame.str\n    })\n\n    // deletion\n    // can only do a deletion if we have enough edits remaining\n    // and if there are characters left to delete in the string\n    if (frame.str.length > 1) {\n      stack.push({\n        node: frame.node,\n        editsRemaining: frame.editsRemaining - 1,\n        str: frame.str.slice(1)\n      })\n    }\n\n    // deletion\n    // just removing the last character from the str\n    if (frame.str.length == 1) {\n      frame.node.final = true\n    }\n\n    // substitution\n    // can only do a substitution if we have enough edits remaining\n    // and if there are characters left to substitute\n    if (frame.str.length >= 1) {\n      if (\"*\" in frame.node.edges) {\n        var substitutionNode = frame.node.edges[\"*\"]\n      } else {\n        var substitutionNode = new lunr.TokenSet\n        frame.node.edges[\"*\"] = substitutionNode\n      }\n\n      if (frame.str.length == 1) {\n        substitutionNode.final = true\n      }\n\n      stack.push({\n        node: substitutionNode,\n        editsRemaining: frame.editsRemaining - 1,\n        str: frame.str.slice(1)\n      })\n    }\n\n    // transposition\n    // can only do a transposition if there are edits remaining\n    // and there are enough characters to transpose\n    if (frame.str.length > 1) {\n      var charA = frame.str.charAt(0),\n          charB = frame.str.charAt(1),\n          transposeNode\n\n      if (charB in frame.node.edges) {\n        transposeNode = frame.node.edges[charB]\n      } else {\n        transposeNode = new lunr.TokenSet\n        frame.node.edges[charB] = transposeNode\n      }\n\n      if (frame.str.length == 1) {\n        transposeNode.final = true\n      }\n\n      stack.push({\n        node: transposeNode,\n        editsRemaining: frame.editsRemaining - 1,\n        str: charA + frame.str.slice(2)\n      })\n    }\n  }\n\n  return root\n}\n\n/**\n * Creates a TokenSet from a string.\n *\n * The string may contain one or more wildcard characters (*)\n * that will allow wildcard matching when intersecting with\n * another TokenSet.\n *\n * @param {string} str - The string to create a TokenSet from.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.fromString = function (str) {\n  var node = new lunr.TokenSet,\n      root = node\n\n  /*\n   * Iterates through all characters within the passed string\n   * appending a node for each character.\n   *\n   * When a wildcard character is found then a self\n   * referencing edge is introduced to continually match\n   * any number of any characters.\n   */\n  for (var i = 0, len = str.length; i < len; i++) {\n    var char = str[i],\n        final = (i == len - 1)\n\n    if (char == \"*\") {\n      node.edges[char] = node\n      node.final = final\n\n    } else {\n      var next = new lunr.TokenSet\n      next.final = final\n\n      node.edges[char] = next\n      node = next\n    }\n  }\n\n  return root\n}\n\n/**\n * Converts this TokenSet into an array of strings\n * contained within the TokenSet.\n *\n * This is not intended to be used on a TokenSet that\n * contains wildcards, in these cases the results are\n * undefined and are likely to cause an infinite loop.\n *\n * @returns {string[]}\n */\nlunr.TokenSet.prototype.toArray = function () {\n  var words = []\n\n  var stack = [{\n    prefix: \"\",\n    node: this\n  }]\n\n  while (stack.length) {\n    var frame = stack.pop(),\n        edges = Object.keys(frame.node.edges),\n        len = edges.length\n\n    if (frame.node.final) {\n      /* In Safari, at this point the prefix is sometimes corrupted, see:\n       * https://github.com/olivernn/lunr.js/issues/279 Calling any\n       * String.prototype method forces Safari to \"cast\" this string to what\n       * it's supposed to be, fixing the bug. */\n      frame.prefix.charAt(0)\n      words.push(frame.prefix)\n    }\n\n    for (var i = 0; i < len; i++) {\n      var edge = edges[i]\n\n      stack.push({\n        prefix: frame.prefix.concat(edge),\n        node: frame.node.edges[edge]\n      })\n    }\n  }\n\n  return words\n}\n\n/**\n * Generates a string representation of a TokenSet.\n *\n * This is intended to allow TokenSets to be used as keys\n * in objects, largely to aid the construction and minimisation\n * of a TokenSet. As such it is not designed to be a human\n * friendly representation of the TokenSet.\n *\n * @returns {string}\n */\nlunr.TokenSet.prototype.toString = function () {\n  // NOTE: Using Object.keys here as this.edges is very likely\n  // to enter 'hash-mode' with many keys being added\n  //\n  // avoiding a for-in loop here as it leads to the function\n  // being de-optimised (at least in V8). From some simple\n  // benchmarks the performance is comparable, but allowing\n  // V8 to optimize may mean easy performance wins in the future.\n\n  if (this._str) {\n    return this._str\n  }\n\n  var str = this.final ? '1' : '0',\n      labels = Object.keys(this.edges).sort(),\n      len = labels.length\n\n  for (var i = 0; i < len; i++) {\n    var label = labels[i],\n        node = this.edges[label]\n\n    str = str + label + node.id\n  }\n\n  return str\n}\n\n/**\n * Returns a new TokenSet that is the intersection of\n * this TokenSet and the passed TokenSet.\n *\n * This intersection will take into account any wildcards\n * contained within the TokenSet.\n *\n * @param {lunr.TokenSet} b - An other TokenSet to intersect with.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.prototype.intersect = function (b) {\n  var output = new lunr.TokenSet,\n      frame = undefined\n\n  var stack = [{\n    qNode: b,\n    output: output,\n    node: this\n  }]\n\n  while (stack.length) {\n    frame = stack.pop()\n\n    // NOTE: As with the #toString method, we are using\n    // Object.keys and a for loop instead of a for-in loop\n    // as both of these objects enter 'hash' mode, causing\n    // the function to be de-optimised in V8\n    var qEdges = Object.keys(frame.qNode.edges),\n        qLen = qEdges.length,\n        nEdges = Object.keys(frame.node.edges),\n        nLen = nEdges.length\n\n    for (var q = 0; q < qLen; q++) {\n      var qEdge = qEdges[q]\n\n      for (var n = 0; n < nLen; n++) {\n        var nEdge = nEdges[n]\n\n        if (nEdge == qEdge || qEdge == '*') {\n          var node = frame.node.edges[nEdge],\n              qNode = frame.qNode.edges[qEdge],\n              final = node.final && qNode.final,\n              next = undefined\n\n          if (nEdge in frame.output.edges) {\n            // an edge already exists for this character\n            // no need to create a new node, just set the finality\n            // bit unless this node is already final\n            next = frame.output.edges[nEdge]\n            next.final = next.final || final\n\n          } else {\n            // no edge exists yet, must create one\n            // set the finality bit and insert it\n            // into the output\n            next = new lunr.TokenSet\n            next.final = final\n            frame.output.edges[nEdge] = next\n          }\n\n          stack.push({\n            qNode: qNode,\n            output: next,\n            node: node\n          })\n        }\n      }\n    }\n  }\n\n  return output\n}\nlunr.TokenSet.Builder = function () {\n  this.previousWord = \"\"\n  this.root = new lunr.TokenSet\n  this.uncheckedNodes = []\n  this.minimizedNodes = {}\n}\n\nlunr.TokenSet.Builder.prototype.insert = function (word) {\n  var node,\n      commonPrefix = 0\n\n  if (word < this.previousWord) {\n    throw new Error (\"Out of order word insertion\")\n  }\n\n  for (var i = 0; i < word.length && i < this.previousWord.length; i++) {\n    if (word[i] != this.previousWord[i]) break\n    commonPrefix++\n  }\n\n  this.minimize(commonPrefix)\n\n  if (this.uncheckedNodes.length == 0) {\n    node = this.root\n  } else {\n    node = this.uncheckedNodes[this.uncheckedNodes.length - 1].child\n  }\n\n  for (var i = commonPrefix; i < word.length; i++) {\n    var nextNode = new lunr.TokenSet,\n        char = word[i]\n\n    node.edges[char] = nextNode\n\n    this.uncheckedNodes.push({\n      parent: node,\n      char: char,\n      child: nextNode\n    })\n\n    node = nextNode\n  }\n\n  node.final = true\n  this.previousWord = word\n}\n\nlunr.TokenSet.Builder.prototype.finish = function () {\n  this.minimize(0)\n}\n\nlunr.TokenSet.Builder.prototype.minimize = function (downTo) {\n  for (var i = this.uncheckedNodes.length - 1; i >= downTo; i--) {\n    var node = this.uncheckedNodes[i],\n        childKey = node.child.toString()\n\n    if (childKey in this.minimizedNodes) {\n      node.parent.edges[node.char] = this.minimizedNodes[childKey]\n    } else {\n      // Cache the key for this node since\n      // we know it can't change anymore\n      node.child._str = childKey\n\n      this.minimizedNodes[childKey] = node.child\n    }\n\n    this.uncheckedNodes.pop()\n  }\n}\n/*!\n * lunr.Index\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * An index contains the built index of all documents and provides a query interface\n * to the index.\n *\n * Usually instances of lunr.Index will not be created using this constructor, instead\n * lunr.Builder should be used to construct new indexes, or lunr.Index.load should be\n * used to load previously built and serialized indexes.\n *\n * @constructor\n * @param {Object} attrs - The attributes of the built search index.\n * @param {Object} attrs.invertedIndex - An index of term/field to document reference.\n * @param {Object<string, lunr.Vector>} attrs.fieldVectors - Field vectors\n * @param {lunr.TokenSet} attrs.tokenSet - An set of all corpus tokens.\n * @param {string[]} attrs.fields - The names of indexed document fields.\n * @param {lunr.Pipeline} attrs.pipeline - The pipeline to use for search terms.\n */\nlunr.Index = function (attrs) {\n  this.invertedIndex = attrs.invertedIndex\n  this.fieldVectors = attrs.fieldVectors\n  this.tokenSet = attrs.tokenSet\n  this.fields = attrs.fields\n  this.pipeline = attrs.pipeline\n}\n\n/**\n * A result contains details of a document matching a search query.\n * @typedef {Object} lunr.Index~Result\n * @property {string} ref - The reference of the document this result represents.\n * @property {number} score - A number between 0 and 1 representing how similar this document is to the query.\n * @property {lunr.MatchData} matchData - Contains metadata about this match including which term(s) caused the match.\n */\n\n/**\n * Although lunr provides the ability to create queries using lunr.Query, it also provides a simple\n * query language which itself is parsed into an instance of lunr.Query.\n *\n * For programmatically building queries it is advised to directly use lunr.Query, the query language\n * is best used for human entered text rather than program generated text.\n *\n * At its simplest queries can just be a single term, e.g. `hello`, multiple terms are also supported\n * and will be combined with OR, e.g `hello world` will match documents that contain either 'hello'\n * or 'world', though those that contain both will rank higher in the results.\n *\n * Wildcards can be included in terms to match one or more unspecified characters, these wildcards can\n * be inserted anywhere within the term, and more than one wildcard can exist in a single term. Adding\n * wildcards will increase the number of documents that will be found but can also have a negative\n * impact on query performance, especially with wildcards at the beginning of a term.\n *\n * Terms can be restricted to specific fields, e.g. `title:hello`, only documents with the term\n * hello in the title field will match this query. Using a field not present in the index will lead\n * to an error being thrown.\n *\n * Modifiers can also be added to terms, lunr supports edit distance and boost modifiers on terms. A term\n * boost will make documents matching that term score higher, e.g. `foo^5`. Edit distance is also supported\n * to provide fuzzy matching, e.g. 'hello~2' will match documents with hello with an edit distance of 2.\n * Avoid large values for edit distance to improve query performance.\n *\n * Each term also supports a presence modifier. By default a term's presence in document is optional, however\n * this can be changed to either required or prohibited. For a term's presence to be required in a document the\n * term should be prefixed with a '+', e.g. `+foo bar` is a search for documents that must contain 'foo' and\n * optionally contain 'bar'. Conversely a leading '-' sets the terms presence to prohibited, i.e. it must not\n * appear in a document, e.g. `-foo bar` is a search for documents that do not contain 'foo' but may contain 'bar'.\n *\n * To escape special characters the backslash character '\\' can be used, this allows searches to include\n * characters that would normally be considered modifiers, e.g. `foo\\~2` will search for a term \"foo~2\" instead\n * of attempting to apply a boost of 2 to the search term \"foo\".\n *\n * @typedef {string} lunr.Index~QueryString\n * @example <caption>Simple single term query</caption>\n * hello\n * @example <caption>Multiple term query</caption>\n * hello world\n * @example <caption>term scoped to a field</caption>\n * title:hello\n * @example <caption>term with a boost of 10</caption>\n * hello^10\n * @example <caption>term with an edit distance of 2</caption>\n * hello~2\n * @example <caption>terms with presence modifiers</caption>\n * -foo +bar baz\n */\n\n/**\n * Performs a search against the index using lunr query syntax.\n *\n * Results will be returned sorted by their score, the most relevant results\n * will be returned first.  For details on how the score is calculated, please see\n * the {@link https://lunrjs.com/guides/searching.html#scoring|guide}.\n *\n * For more programmatic querying use lunr.Index#query.\n *\n * @param {lunr.Index~QueryString} queryString - A string containing a lunr query.\n * @throws {lunr.QueryParseError} If the passed query string cannot be parsed.\n * @returns {lunr.Index~Result[]}\n */\nlunr.Index.prototype.search = function (queryString) {\n  return this.query(function (query) {\n    var parser = new lunr.QueryParser(queryString, query)\n    parser.parse()\n  })\n}\n\n/**\n * A query builder callback provides a query object to be used to express\n * the query to perform on the index.\n *\n * @callback lunr.Index~queryBuilder\n * @param {lunr.Query} query - The query object to build up.\n * @this lunr.Query\n */\n\n/**\n * Performs a query against the index using the yielded lunr.Query object.\n *\n * If performing programmatic queries against the index, this method is preferred\n * over lunr.Index#search so as to avoid the additional query parsing overhead.\n *\n * A query object is yielded to the supplied function which should be used to\n * express the query to be run against the index.\n *\n * Note that although this function takes a callback parameter it is _not_ an\n * asynchronous operation, the callback is just yielded a query object to be\n * customized.\n *\n * @param {lunr.Index~queryBuilder} fn - A function that is used to build the query.\n * @returns {lunr.Index~Result[]}\n */\nlunr.Index.prototype.query = function (fn) {\n  // for each query clause\n  // * process terms\n  // * expand terms from token set\n  // * find matching documents and metadata\n  // * get document vectors\n  // * score documents\n\n  var query = new lunr.Query(this.fields),\n      matchingFields = Object.create(null),\n      queryVectors = Object.create(null),\n      termFieldCache = Object.create(null),\n      requiredMatches = Object.create(null),\n      prohibitedMatches = Object.create(null)\n\n  /*\n   * To support field level boosts a query vector is created per\n   * field. An empty vector is eagerly created to support negated\n   * queries.\n   */\n  for (var i = 0; i < this.fields.length; i++) {\n    queryVectors[this.fields[i]] = new lunr.Vector\n  }\n\n  fn.call(query, query)\n\n  for (var i = 0; i < query.clauses.length; i++) {\n    /*\n     * Unless the pipeline has been disabled for this term, which is\n     * the case for terms with wildcards, we need to pass the clause\n     * term through the search pipeline. A pipeline returns an array\n     * of processed terms. Pipeline functions may expand the passed\n     * term, which means we may end up performing multiple index lookups\n     * for a single query term.\n     */\n    var clause = query.clauses[i],\n        terms = null,\n        clauseMatches = lunr.Set.empty\n\n    if (clause.usePipeline) {\n      terms = this.pipeline.runString(clause.term, {\n        fields: clause.fields\n      })\n    } else {\n      terms = [clause.term]\n    }\n\n    for (var m = 0; m < terms.length; m++) {\n      var term = terms[m]\n\n      /*\n       * Each term returned from the pipeline needs to use the same query\n       * clause object, e.g. the same boost and or edit distance. The\n       * simplest way to do this is to re-use the clause object but mutate\n       * its term property.\n       */\n      clause.term = term\n\n      /*\n       * From the term in the clause we create a token set which will then\n       * be used to intersect the indexes token set to get a list of terms\n       * to lookup in the inverted index\n       */\n      var termTokenSet = lunr.TokenSet.fromClause(clause),\n          expandedTerms = this.tokenSet.intersect(termTokenSet).toArray()\n\n      /*\n       * If a term marked as required does not exist in the tokenSet it is\n       * impossible for the search to return any matches. We set all the field\n       * scoped required matches set to empty and stop examining any further\n       * clauses.\n       */\n      if (expandedTerms.length === 0 && clause.presence === lunr.Query.presence.REQUIRED) {\n        for (var k = 0; k < clause.fields.length; k++) {\n          var field = clause.fields[k]\n          requiredMatches[field] = lunr.Set.empty\n        }\n\n        break\n      }\n\n      for (var j = 0; j < expandedTerms.length; j++) {\n        /*\n         * For each term get the posting and termIndex, this is required for\n         * building the query vector.\n         */\n        var expandedTerm = expandedTerms[j],\n            posting = this.invertedIndex[expandedTerm],\n            termIndex = posting._index\n\n        for (var k = 0; k < clause.fields.length; k++) {\n          /*\n           * For each field that this query term is scoped by (by default\n           * all fields are in scope) we need to get all the document refs\n           * that have this term in that field.\n           *\n           * The posting is the entry in the invertedIndex for the matching\n           * term from above.\n           */\n          var field = clause.fields[k],\n              fieldPosting = posting[field],\n              matchingDocumentRefs = Object.keys(fieldPosting),\n              termField = expandedTerm + \"/\" + field,\n              matchingDocumentsSet = new lunr.Set(matchingDocumentRefs)\n\n          /*\n           * if the presence of this term is required ensure that the matching\n           * documents are added to the set of required matches for this clause.\n           *\n           */\n          if (clause.presence == lunr.Query.presence.REQUIRED) {\n            clauseMatches = clauseMatches.union(matchingDocumentsSet)\n\n            if (requiredMatches[field] === undefined) {\n              requiredMatches[field] = lunr.Set.complete\n            }\n          }\n\n          /*\n           * if the presence of this term is prohibited ensure that the matching\n           * documents are added to the set of prohibited matches for this field,\n           * creating that set if it does not yet exist.\n           */\n          if (clause.presence == lunr.Query.presence.PROHIBITED) {\n            if (prohibitedMatches[field] === undefined) {\n              prohibitedMatches[field] = lunr.Set.empty\n            }\n\n            prohibitedMatches[field] = prohibitedMatches[field].union(matchingDocumentsSet)\n\n            /*\n             * Prohibited matches should not be part of the query vector used for\n             * similarity scoring and no metadata should be extracted so we continue\n             * to the next field\n             */\n            continue\n          }\n\n          /*\n           * The query field vector is populated using the termIndex found for\n           * the term and a unit value with the appropriate boost applied.\n           * Using upsert because there could already be an entry in the vector\n           * for the term we are working with. In that case we just add the scores\n           * together.\n           */\n          queryVectors[field].upsert(termIndex, clause.boost, function (a, b) { return a + b })\n\n          /**\n           * If we've already seen this term, field combo then we've already collected\n           * the matching documents and metadata, no need to go through all that again\n           */\n          if (termFieldCache[termField]) {\n            continue\n          }\n\n          for (var l = 0; l < matchingDocumentRefs.length; l++) {\n            /*\n             * All metadata for this term/field/document triple\n             * are then extracted and collected into an instance\n             * of lunr.MatchData ready to be returned in the query\n             * results\n             */\n            var matchingDocumentRef = matchingDocumentRefs[l],\n                matchingFieldRef = new lunr.FieldRef (matchingDocumentRef, field),\n                metadata = fieldPosting[matchingDocumentRef],\n                fieldMatch\n\n            if ((fieldMatch = matchingFields[matchingFieldRef]) === undefined) {\n              matchingFields[matchingFieldRef] = new lunr.MatchData (expandedTerm, field, metadata)\n            } else {\n              fieldMatch.add(expandedTerm, field, metadata)\n            }\n\n          }\n\n          termFieldCache[termField] = true\n        }\n      }\n    }\n\n    /**\n     * If the presence was required we need to update the requiredMatches field sets.\n     * We do this after all fields for the term have collected their matches because\n     * the clause terms presence is required in _any_ of the fields not _all_ of the\n     * fields.\n     */\n    if (clause.presence === lunr.Query.presence.REQUIRED) {\n      for (var k = 0; k < clause.fields.length; k++) {\n        var field = clause.fields[k]\n        requiredMatches[field] = requiredMatches[field].intersect(clauseMatches)\n      }\n    }\n  }\n\n  /**\n   * Need to combine the field scoped required and prohibited\n   * matching documents into a global set of required and prohibited\n   * matches\n   */\n  var allRequiredMatches = lunr.Set.complete,\n      allProhibitedMatches = lunr.Set.empty\n\n  for (var i = 0; i < this.fields.length; i++) {\n    var field = this.fields[i]\n\n    if (requiredMatches[field]) {\n      allRequiredMatches = allRequiredMatches.intersect(requiredMatches[field])\n    }\n\n    if (prohibitedMatches[field]) {\n      allProhibitedMatches = allProhibitedMatches.union(prohibitedMatches[field])\n    }\n  }\n\n  var matchingFieldRefs = Object.keys(matchingFields),\n      results = [],\n      matches = Object.create(null)\n\n  /*\n   * If the query is negated (contains only prohibited terms)\n   * we need to get _all_ fieldRefs currently existing in the\n   * index. This is only done when we know that the query is\n   * entirely prohibited terms to avoid any cost of getting all\n   * fieldRefs unnecessarily.\n   *\n   * Additionally, blank MatchData must be created to correctly\n   * populate the results.\n   */\n  if (query.isNegated()) {\n    matchingFieldRefs = Object.keys(this.fieldVectors)\n\n    for (var i = 0; i < matchingFieldRefs.length; i++) {\n      var matchingFieldRef = matchingFieldRefs[i]\n      var fieldRef = lunr.FieldRef.fromString(matchingFieldRef)\n      matchingFields[matchingFieldRef] = new lunr.MatchData\n    }\n  }\n\n  for (var i = 0; i < matchingFieldRefs.length; i++) {\n    /*\n     * Currently we have document fields that match the query, but we\n     * need to return documents. The matchData and scores are combined\n     * from multiple fields belonging to the same document.\n     *\n     * Scores are calculated by field, using the query vectors created\n     * above, and combined into a final document score using addition.\n     */\n    var fieldRef = lunr.FieldRef.fromString(matchingFieldRefs[i]),\n        docRef = fieldRef.docRef\n\n    if (!allRequiredMatches.contains(docRef)) {\n      continue\n    }\n\n    if (allProhibitedMatches.contains(docRef)) {\n      continue\n    }\n\n    var fieldVector = this.fieldVectors[fieldRef],\n        score = queryVectors[fieldRef.fieldName].similarity(fieldVector),\n        docMatch\n\n    if ((docMatch = matches[docRef]) !== undefined) {\n      docMatch.score += score\n      docMatch.matchData.combine(matchingFields[fieldRef])\n    } else {\n      var match = {\n        ref: docRef,\n        score: score,\n        matchData: matchingFields[fieldRef]\n      }\n      matches[docRef] = match\n      results.push(match)\n    }\n  }\n\n  /*\n   * Sort the results objects by score, highest first.\n   */\n  return results.sort(function (a, b) {\n    return b.score - a.score\n  })\n}\n\n/**\n * Prepares the index for JSON serialization.\n *\n * The schema for this JSON blob will be described in a\n * separate JSON schema file.\n *\n * @returns {Object}\n */\nlunr.Index.prototype.toJSON = function () {\n  var invertedIndex = Object.keys(this.invertedIndex)\n    .sort()\n    .map(function (term) {\n      return [term, this.invertedIndex[term]]\n    }, this)\n\n  var fieldVectors = Object.keys(this.fieldVectors)\n    .map(function (ref) {\n      return [ref, this.fieldVectors[ref].toJSON()]\n    }, this)\n\n  return {\n    version: lunr.version,\n    fields: this.fields,\n    fieldVectors: fieldVectors,\n    invertedIndex: invertedIndex,\n    pipeline: this.pipeline.toJSON()\n  }\n}\n\n/**\n * Loads a previously serialized lunr.Index\n *\n * @param {Object} serializedIndex - A previously serialized lunr.Index\n * @returns {lunr.Index}\n */\nlunr.Index.load = function (serializedIndex) {\n  var attrs = {},\n      fieldVectors = {},\n      serializedVectors = serializedIndex.fieldVectors,\n      invertedIndex = Object.create(null),\n      serializedInvertedIndex = serializedIndex.invertedIndex,\n      tokenSetBuilder = new lunr.TokenSet.Builder,\n      pipeline = lunr.Pipeline.load(serializedIndex.pipeline)\n\n  if (serializedIndex.version != lunr.version) {\n    lunr.utils.warn(\"Version mismatch when loading serialised index. Current version of lunr '\" + lunr.version + \"' does not match serialized index '\" + serializedIndex.version + \"'\")\n  }\n\n  for (var i = 0; i < serializedVectors.length; i++) {\n    var tuple = serializedVectors[i],\n        ref = tuple[0],\n        elements = tuple[1]\n\n    fieldVectors[ref] = new lunr.Vector(elements)\n  }\n\n  for (var i = 0; i < serializedInvertedIndex.length; i++) {\n    var tuple = serializedInvertedIndex[i],\n        term = tuple[0],\n        posting = tuple[1]\n\n    tokenSetBuilder.insert(term)\n    invertedIndex[term] = posting\n  }\n\n  tokenSetBuilder.finish()\n\n  attrs.fields = serializedIndex.fields\n\n  attrs.fieldVectors = fieldVectors\n  attrs.invertedIndex = invertedIndex\n  attrs.tokenSet = tokenSetBuilder.root\n  attrs.pipeline = pipeline\n\n  return new lunr.Index(attrs)\n}\n/*!\n * lunr.Builder\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.Builder performs indexing on a set of documents and\n * returns instances of lunr.Index ready for querying.\n *\n * All configuration of the index is done via the builder, the\n * fields to index, the document reference, the text processing\n * pipeline and document scoring parameters are all set on the\n * builder before indexing.\n *\n * @constructor\n * @property {string} _ref - Internal reference to the document reference field.\n * @property {string[]} _fields - Internal reference to the document fields to index.\n * @property {object} invertedIndex - The inverted index maps terms to document fields.\n * @property {object} documentTermFrequencies - Keeps track of document term frequencies.\n * @property {object} documentLengths - Keeps track of the length of documents added to the index.\n * @property {lunr.tokenizer} tokenizer - Function for splitting strings into tokens for indexing.\n * @property {lunr.Pipeline} pipeline - The pipeline performs text processing on tokens before indexing.\n * @property {lunr.Pipeline} searchPipeline - A pipeline for processing search terms before querying the index.\n * @property {number} documentCount - Keeps track of the total number of documents indexed.\n * @property {number} _b - A parameter to control field length normalization, setting this to 0 disabled normalization, 1 fully normalizes field lengths, the default value is 0.75.\n * @property {number} _k1 - A parameter to control how quickly an increase in term frequency results in term frequency saturation, the default value is 1.2.\n * @property {number} termIndex - A counter incremented for each unique term, used to identify a terms position in the vector space.\n * @property {array} metadataWhitelist - A list of metadata keys that have been whitelisted for entry in the index.\n */\nlunr.Builder = function () {\n  this._ref = \"id\"\n  this._fields = Object.create(null)\n  this._documents = Object.create(null)\n  this.invertedIndex = Object.create(null)\n  this.fieldTermFrequencies = {}\n  this.fieldLengths = {}\n  this.tokenizer = lunr.tokenizer\n  this.pipeline = new lunr.Pipeline\n  this.searchPipeline = new lunr.Pipeline\n  this.documentCount = 0\n  this._b = 0.75\n  this._k1 = 1.2\n  this.termIndex = 0\n  this.metadataWhitelist = []\n}\n\n/**\n * Sets the document field used as the document reference. Every document must have this field.\n * The type of this field in the document should be a string, if it is not a string it will be\n * coerced into a string by calling toString.\n *\n * The default ref is 'id'.\n *\n * The ref should _not_ be changed during indexing, it should be set before any documents are\n * added to the index. Changing it during indexing can lead to inconsistent results.\n *\n * @param {string} ref - The name of the reference field in the document.\n */\nlunr.Builder.prototype.ref = function (ref) {\n  this._ref = ref\n}\n\n/**\n * A function that is used to extract a field from a document.\n *\n * Lunr expects a field to be at the top level of a document, if however the field\n * is deeply nested within a document an extractor function can be used to extract\n * the right field for indexing.\n *\n * @callback fieldExtractor\n * @param {object} doc - The document being added to the index.\n * @returns {?(string|object|object[])} obj - The object that will be indexed for this field.\n * @example <caption>Extracting a nested field</caption>\n * function (doc) { return doc.nested.field }\n */\n\n/**\n * Adds a field to the list of document fields that will be indexed. Every document being\n * indexed should have this field. Null values for this field in indexed documents will\n * not cause errors but will limit the chance of that document being retrieved by searches.\n *\n * All fields should be added before adding documents to the index. Adding fields after\n * a document has been indexed will have no effect on already indexed documents.\n *\n * Fields can be boosted at build time. This allows terms within that field to have more\n * importance when ranking search results. Use a field boost to specify that matches within\n * one field are more important than other fields.\n *\n * @param {string} fieldName - The name of a field to index in all documents.\n * @param {object} attributes - Optional attributes associated with this field.\n * @param {number} [attributes.boost=1] - Boost applied to all terms within this field.\n * @param {fieldExtractor} [attributes.extractor] - Function to extract a field from a document.\n * @throws {RangeError} fieldName cannot contain unsupported characters '/'\n */\nlunr.Builder.prototype.field = function (fieldName, attributes) {\n  if (/\\//.test(fieldName)) {\n    throw new RangeError (\"Field '\" + fieldName + \"' contains illegal character '/'\")\n  }\n\n  this._fields[fieldName] = attributes || {}\n}\n\n/**\n * A parameter to tune the amount of field length normalisation that is applied when\n * calculating relevance scores. A value of 0 will completely disable any normalisation\n * and a value of 1 will fully normalise field lengths. The default is 0.75. Values of b\n * will be clamped to the range 0 - 1.\n *\n * @param {number} number - The value to set for this tuning parameter.\n */\nlunr.Builder.prototype.b = function (number) {\n  if (number < 0) {\n    this._b = 0\n  } else if (number > 1) {\n    this._b = 1\n  } else {\n    this._b = number\n  }\n}\n\n/**\n * A parameter that controls the speed at which a rise in term frequency results in term\n * frequency saturation. The default value is 1.2. Setting this to a higher value will give\n * slower saturation levels, a lower value will result in quicker saturation.\n *\n * @param {number} number - The value to set for this tuning parameter.\n */\nlunr.Builder.prototype.k1 = function (number) {\n  this._k1 = number\n}\n\n/**\n * Adds a document to the index.\n *\n * Before adding fields to the index the index should have been fully setup, with the document\n * ref and all fields to index already having been specified.\n *\n * The document must have a field name as specified by the ref (by default this is 'id') and\n * it should have all fields defined for indexing, though null or undefined values will not\n * cause errors.\n *\n * Entire documents can be boosted at build time. Applying a boost to a document indicates that\n * this document should rank higher in search results than other documents.\n *\n * @param {object} doc - The document to add to the index.\n * @param {object} attributes - Optional attributes associated with this document.\n * @param {number} [attributes.boost=1] - Boost applied to all terms within this document.\n */\nlunr.Builder.prototype.add = function (doc, attributes) {\n  var docRef = doc[this._ref],\n      fields = Object.keys(this._fields)\n\n  this._documents[docRef] = attributes || {}\n  this.documentCount += 1\n\n  for (var i = 0; i < fields.length; i++) {\n    var fieldName = fields[i],\n        extractor = this._fields[fieldName].extractor,\n        field = extractor ? extractor(doc) : doc[fieldName],\n        tokens = this.tokenizer(field, {\n          fields: [fieldName]\n        }),\n        terms = this.pipeline.run(tokens),\n        fieldRef = new lunr.FieldRef (docRef, fieldName),\n        fieldTerms = Object.create(null)\n\n    this.fieldTermFrequencies[fieldRef] = fieldTerms\n    this.fieldLengths[fieldRef] = 0\n\n    // store the length of this field for this document\n    this.fieldLengths[fieldRef] += terms.length\n\n    // calculate term frequencies for this field\n    for (var j = 0; j < terms.length; j++) {\n      var term = terms[j]\n\n      if (fieldTerms[term] == undefined) {\n        fieldTerms[term] = 0\n      }\n\n      fieldTerms[term] += 1\n\n      // add to inverted index\n      // create an initial posting if one doesn't exist\n      if (this.invertedIndex[term] == undefined) {\n        var posting = Object.create(null)\n        posting[\"_index\"] = this.termIndex\n        this.termIndex += 1\n\n        for (var k = 0; k < fields.length; k++) {\n          posting[fields[k]] = Object.create(null)\n        }\n\n        this.invertedIndex[term] = posting\n      }\n\n      // add an entry for this term/fieldName/docRef to the invertedIndex\n      if (this.invertedIndex[term][fieldName][docRef] == undefined) {\n        this.invertedIndex[term][fieldName][docRef] = Object.create(null)\n      }\n\n      // store all whitelisted metadata about this token in the\n      // inverted index\n      for (var l = 0; l < this.metadataWhitelist.length; l++) {\n        var metadataKey = this.metadataWhitelist[l],\n            metadata = term.metadata[metadataKey]\n\n        if (this.invertedIndex[term][fieldName][docRef][metadataKey] == undefined) {\n          this.invertedIndex[term][fieldName][docRef][metadataKey] = []\n        }\n\n        this.invertedIndex[term][fieldName][docRef][metadataKey].push(metadata)\n      }\n    }\n\n  }\n}\n\n/**\n * Calculates the average document length for this index\n *\n * @private\n */\nlunr.Builder.prototype.calculateAverageFieldLengths = function () {\n\n  var fieldRefs = Object.keys(this.fieldLengths),\n      numberOfFields = fieldRefs.length,\n      accumulator = {},\n      documentsWithField = {}\n\n  for (var i = 0; i < numberOfFields; i++) {\n    var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),\n        field = fieldRef.fieldName\n\n    documentsWithField[field] || (documentsWithField[field] = 0)\n    documentsWithField[field] += 1\n\n    accumulator[field] || (accumulator[field] = 0)\n    accumulator[field] += this.fieldLengths[fieldRef]\n  }\n\n  var fields = Object.keys(this._fields)\n\n  for (var i = 0; i < fields.length; i++) {\n    var fieldName = fields[i]\n    accumulator[fieldName] = accumulator[fieldName] / documentsWithField[fieldName]\n  }\n\n  this.averageFieldLength = accumulator\n}\n\n/**\n * Builds a vector space model of every document using lunr.Vector\n *\n * @private\n */\nlunr.Builder.prototype.createFieldVectors = function () {\n  var fieldVectors = {},\n      fieldRefs = Object.keys(this.fieldTermFrequencies),\n      fieldRefsLength = fieldRefs.length,\n      termIdfCache = Object.create(null)\n\n  for (var i = 0; i < fieldRefsLength; i++) {\n    var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),\n        fieldName = fieldRef.fieldName,\n        fieldLength = this.fieldLengths[fieldRef],\n        fieldVector = new lunr.Vector,\n        termFrequencies = this.fieldTermFrequencies[fieldRef],\n        terms = Object.keys(termFrequencies),\n        termsLength = terms.length\n\n\n    var fieldBoost = this._fields[fieldName].boost || 1,\n        docBoost = this._documents[fieldRef.docRef].boost || 1\n\n    for (var j = 0; j < termsLength; j++) {\n      var term = terms[j],\n          tf = termFrequencies[term],\n          termIndex = this.invertedIndex[term]._index,\n          idf, score, scoreWithPrecision\n\n      if (termIdfCache[term] === undefined) {\n        idf = lunr.idf(this.invertedIndex[term], this.documentCount)\n        termIdfCache[term] = idf\n      } else {\n        idf = termIdfCache[term]\n      }\n\n      score = idf * ((this._k1 + 1) * tf) / (this._k1 * (1 - this._b + this._b * (fieldLength / this.averageFieldLength[fieldName])) + tf)\n      score *= fieldBoost\n      score *= docBoost\n      scoreWithPrecision = Math.round(score * 1000) / 1000\n      // Converts 1.23456789 to 1.234.\n      // Reducing the precision so that the vectors take up less\n      // space when serialised. Doing it now so that they behave\n      // the same before and after serialisation. Also, this is\n      // the fastest approach to reducing a number's precision in\n      // JavaScript.\n\n      fieldVector.insert(termIndex, scoreWithPrecision)\n    }\n\n    fieldVectors[fieldRef] = fieldVector\n  }\n\n  this.fieldVectors = fieldVectors\n}\n\n/**\n * Creates a token set of all tokens in the index using lunr.TokenSet\n *\n * @private\n */\nlunr.Builder.prototype.createTokenSet = function () {\n  this.tokenSet = lunr.TokenSet.fromArray(\n    Object.keys(this.invertedIndex).sort()\n  )\n}\n\n/**\n * Builds the index, creating an instance of lunr.Index.\n *\n * This completes the indexing process and should only be called\n * once all documents have been added to the index.\n *\n * @returns {lunr.Index}\n */\nlunr.Builder.prototype.build = function () {\n  this.calculateAverageFieldLengths()\n  this.createFieldVectors()\n  this.createTokenSet()\n\n  return new lunr.Index({\n    invertedIndex: this.invertedIndex,\n    fieldVectors: this.fieldVectors,\n    tokenSet: this.tokenSet,\n    fields: Object.keys(this._fields),\n    pipeline: this.searchPipeline\n  })\n}\n\n/**\n * Applies a plugin to the index builder.\n *\n * A plugin is a function that is called with the index builder as its context.\n * Plugins can be used to customise or extend the behaviour of the index\n * in some way. A plugin is just a function, that encapsulated the custom\n * behaviour that should be applied when building the index.\n *\n * The plugin function will be called with the index builder as its argument, additional\n * arguments can also be passed when calling use. The function will be called\n * with the index builder as its context.\n *\n * @param {Function} plugin The plugin to apply.\n */\nlunr.Builder.prototype.use = function (fn) {\n  var args = Array.prototype.slice.call(arguments, 1)\n  args.unshift(this)\n  fn.apply(this, args)\n}\n/**\n * Contains and collects metadata about a matching document.\n * A single instance of lunr.MatchData is returned as part of every\n * lunr.Index~Result.\n *\n * @constructor\n * @param {string} term - The term this match data is associated with\n * @param {string} field - The field in which the term was found\n * @param {object} metadata - The metadata recorded about this term in this field\n * @property {object} metadata - A cloned collection of metadata associated with this document.\n * @see {@link lunr.Index~Result}\n */\nlunr.MatchData = function (term, field, metadata) {\n  var clonedMetadata = Object.create(null),\n      metadataKeys = Object.keys(metadata || {})\n\n  // Cloning the metadata to prevent the original\n  // being mutated during match data combination.\n  // Metadata is kept in an array within the inverted\n  // index so cloning the data can be done with\n  // Array#slice\n  for (var i = 0; i < metadataKeys.length; i++) {\n    var key = metadataKeys[i]\n    clonedMetadata[key] = metadata[key].slice()\n  }\n\n  this.metadata = Object.create(null)\n\n  if (term !== undefined) {\n    this.metadata[term] = Object.create(null)\n    this.metadata[term][field] = clonedMetadata\n  }\n}\n\n/**\n * An instance of lunr.MatchData will be created for every term that matches a\n * document. However only one instance is required in a lunr.Index~Result. This\n * method combines metadata from another instance of lunr.MatchData with this\n * objects metadata.\n *\n * @param {lunr.MatchData} otherMatchData - Another instance of match data to merge with this one.\n * @see {@link lunr.Index~Result}\n */\nlunr.MatchData.prototype.combine = function (otherMatchData) {\n  var terms = Object.keys(otherMatchData.metadata)\n\n  for (var i = 0; i < terms.length; i++) {\n    var term = terms[i],\n        fields = Object.keys(otherMatchData.metadata[term])\n\n    if (this.metadata[term] == undefined) {\n      this.metadata[term] = Object.create(null)\n    }\n\n    for (var j = 0; j < fields.length; j++) {\n      var field = fields[j],\n          keys = Object.keys(otherMatchData.metadata[term][field])\n\n      if (this.metadata[term][field] == undefined) {\n        this.metadata[term][field] = Object.create(null)\n      }\n\n      for (var k = 0; k < keys.length; k++) {\n        var key = keys[k]\n\n        if (this.metadata[term][field][key] == undefined) {\n          this.metadata[term][field][key] = otherMatchData.metadata[term][field][key]\n        } else {\n          this.metadata[term][field][key] = this.metadata[term][field][key].concat(otherMatchData.metadata[term][field][key])\n        }\n\n      }\n    }\n  }\n}\n\n/**\n * Add metadata for a term/field pair to this instance of match data.\n *\n * @param {string} term - The term this match data is associated with\n * @param {string} field - The field in which the term was found\n * @param {object} metadata - The metadata recorded about this term in this field\n */\nlunr.MatchData.prototype.add = function (term, field, metadata) {\n  if (!(term in this.metadata)) {\n    this.metadata[term] = Object.create(null)\n    this.metadata[term][field] = metadata\n    return\n  }\n\n  if (!(field in this.metadata[term])) {\n    this.metadata[term][field] = metadata\n    return\n  }\n\n  var metadataKeys = Object.keys(metadata)\n\n  for (var i = 0; i < metadataKeys.length; i++) {\n    var key = metadataKeys[i]\n\n    if (key in this.metadata[term][field]) {\n      this.metadata[term][field][key] = this.metadata[term][field][key].concat(metadata[key])\n    } else {\n      this.metadata[term][field][key] = metadata[key]\n    }\n  }\n}\n/**\n * A lunr.Query provides a programmatic way of defining queries to be performed\n * against a {@link lunr.Index}.\n *\n * Prefer constructing a lunr.Query using the {@link lunr.Index#query} method\n * so the query object is pre-initialized with the right index fields.\n *\n * @constructor\n * @property {lunr.Query~Clause[]} clauses - An array of query clauses.\n * @property {string[]} allFields - An array of all available fields in a lunr.Index.\n */\nlunr.Query = function (allFields) {\n  this.clauses = []\n  this.allFields = allFields\n}\n\n/**\n * Constants for indicating what kind of automatic wildcard insertion will be used when constructing a query clause.\n *\n * This allows wildcards to be added to the beginning and end of a term without having to manually do any string\n * concatenation.\n *\n * The wildcard constants can be bitwise combined to select both leading and trailing wildcards.\n *\n * @constant\n * @default\n * @property {number} wildcard.NONE - The term will have no wildcards inserted, this is the default behaviour\n * @property {number} wildcard.LEADING - Prepend the term with a wildcard, unless a leading wildcard already exists\n * @property {number} wildcard.TRAILING - Append a wildcard to the term, unless a trailing wildcard already exists\n * @see lunr.Query~Clause\n * @see lunr.Query#clause\n * @see lunr.Query#term\n * @example <caption>query term with trailing wildcard</caption>\n * query.term('foo', { wildcard: lunr.Query.wildcard.TRAILING })\n * @example <caption>query term with leading and trailing wildcard</caption>\n * query.term('foo', {\n *   wildcard: lunr.Query.wildcard.LEADING | lunr.Query.wildcard.TRAILING\n * })\n */\n\nlunr.Query.wildcard = new String (\"*\")\nlunr.Query.wildcard.NONE = 0\nlunr.Query.wildcard.LEADING = 1\nlunr.Query.wildcard.TRAILING = 2\n\n/**\n * Constants for indicating what kind of presence a term must have in matching documents.\n *\n * @constant\n * @enum {number}\n * @see lunr.Query~Clause\n * @see lunr.Query#clause\n * @see lunr.Query#term\n * @example <caption>query term with required presence</caption>\n * query.term('foo', { presence: lunr.Query.presence.REQUIRED })\n */\nlunr.Query.presence = {\n  /**\n   * Term's presence in a document is optional, this is the default value.\n   */\n  OPTIONAL: 1,\n\n  /**\n   * Term's presence in a document is required, documents that do not contain\n   * this term will not be returned.\n   */\n  REQUIRED: 2,\n\n  /**\n   * Term's presence in a document is prohibited, documents that do contain\n   * this term will not be returned.\n   */\n  PROHIBITED: 3\n}\n\n/**\n * A single clause in a {@link lunr.Query} contains a term and details on how to\n * match that term against a {@link lunr.Index}.\n *\n * @typedef {Object} lunr.Query~Clause\n * @property {string[]} fields - The fields in an index this clause should be matched against.\n * @property {number} [boost=1] - Any boost that should be applied when matching this clause.\n * @property {number} [editDistance] - Whether the term should have fuzzy matching applied, and how fuzzy the match should be.\n * @property {boolean} [usePipeline] - Whether the term should be passed through the search pipeline.\n * @property {number} [wildcard=lunr.Query.wildcard.NONE] - Whether the term should have wildcards appended or prepended.\n * @property {number} [presence=lunr.Query.presence.OPTIONAL] - The terms presence in any matching documents.\n */\n\n/**\n * Adds a {@link lunr.Query~Clause} to this query.\n *\n * Unless the clause contains the fields to be matched all fields will be matched. In addition\n * a default boost of 1 is applied to the clause.\n *\n * @param {lunr.Query~Clause} clause - The clause to add to this query.\n * @see lunr.Query~Clause\n * @returns {lunr.Query}\n */\nlunr.Query.prototype.clause = function (clause) {\n  if (!('fields' in clause)) {\n    clause.fields = this.allFields\n  }\n\n  if (!('boost' in clause)) {\n    clause.boost = 1\n  }\n\n  if (!('usePipeline' in clause)) {\n    clause.usePipeline = true\n  }\n\n  if (!('wildcard' in clause)) {\n    clause.wildcard = lunr.Query.wildcard.NONE\n  }\n\n  if ((clause.wildcard & lunr.Query.wildcard.LEADING) && (clause.term.charAt(0) != lunr.Query.wildcard)) {\n    clause.term = \"*\" + clause.term\n  }\n\n  if ((clause.wildcard & lunr.Query.wildcard.TRAILING) && (clause.term.slice(-1) != lunr.Query.wildcard)) {\n    clause.term = \"\" + clause.term + \"*\"\n  }\n\n  if (!('presence' in clause)) {\n    clause.presence = lunr.Query.presence.OPTIONAL\n  }\n\n  this.clauses.push(clause)\n\n  return this\n}\n\n/**\n * A negated query is one in which every clause has a presence of\n * prohibited. These queries require some special processing to return\n * the expected results.\n *\n * @returns boolean\n */\nlunr.Query.prototype.isNegated = function () {\n  for (var i = 0; i < this.clauses.length; i++) {\n    if (this.clauses[i].presence != lunr.Query.presence.PROHIBITED) {\n      return false\n    }\n  }\n\n  return true\n}\n\n/**\n * Adds a term to the current query, under the covers this will create a {@link lunr.Query~Clause}\n * to the list of clauses that make up this query.\n *\n * The term is used as is, i.e. no tokenization will be performed by this method. Instead conversion\n * to a token or token-like string should be done before calling this method.\n *\n * The term will be converted to a string by calling `toString`. Multiple terms can be passed as an\n * array, each term in the array will share the same options.\n *\n * @param {object|object[]} term - The term(s) to add to the query.\n * @param {object} [options] - Any additional properties to add to the query clause.\n * @returns {lunr.Query}\n * @see lunr.Query#clause\n * @see lunr.Query~Clause\n * @example <caption>adding a single term to a query</caption>\n * query.term(\"foo\")\n * @example <caption>adding a single term to a query and specifying search fields, term boost and automatic trailing wildcard</caption>\n * query.term(\"foo\", {\n *   fields: [\"title\"],\n *   boost: 10,\n *   wildcard: lunr.Query.wildcard.TRAILING\n * })\n * @example <caption>using lunr.tokenizer to convert a string to tokens before using them as terms</caption>\n * query.term(lunr.tokenizer(\"foo bar\"))\n */\nlunr.Query.prototype.term = function (term, options) {\n  if (Array.isArray(term)) {\n    term.forEach(function (t) { this.term(t, lunr.utils.clone(options)) }, this)\n    return this\n  }\n\n  var clause = options || {}\n  clause.term = term.toString()\n\n  this.clause(clause)\n\n  return this\n}\nlunr.QueryParseError = function (message, start, end) {\n  this.name = \"QueryParseError\"\n  this.message = message\n  this.start = start\n  this.end = end\n}\n\nlunr.QueryParseError.prototype = new Error\nlunr.QueryLexer = function (str) {\n  this.lexemes = []\n  this.str = str\n  this.length = str.length\n  this.pos = 0\n  this.start = 0\n  this.escapeCharPositions = []\n}\n\nlunr.QueryLexer.prototype.run = function () {\n  var state = lunr.QueryLexer.lexText\n\n  while (state) {\n    state = state(this)\n  }\n}\n\nlunr.QueryLexer.prototype.sliceString = function () {\n  var subSlices = [],\n      sliceStart = this.start,\n      sliceEnd = this.pos\n\n  for (var i = 0; i < this.escapeCharPositions.length; i++) {\n    sliceEnd = this.escapeCharPositions[i]\n    subSlices.push(this.str.slice(sliceStart, sliceEnd))\n    sliceStart = sliceEnd + 1\n  }\n\n  subSlices.push(this.str.slice(sliceStart, this.pos))\n  this.escapeCharPositions.length = 0\n\n  return subSlices.join('')\n}\n\nlunr.QueryLexer.prototype.emit = function (type) {\n  this.lexemes.push({\n    type: type,\n    str: this.sliceString(),\n    start: this.start,\n    end: this.pos\n  })\n\n  this.start = this.pos\n}\n\nlunr.QueryLexer.prototype.escapeCharacter = function () {\n  this.escapeCharPositions.push(this.pos - 1)\n  this.pos += 1\n}\n\nlunr.QueryLexer.prototype.next = function () {\n  if (this.pos >= this.length) {\n    return lunr.QueryLexer.EOS\n  }\n\n  var char = this.str.charAt(this.pos)\n  this.pos += 1\n  return char\n}\n\nlunr.QueryLexer.prototype.width = function () {\n  return this.pos - this.start\n}\n\nlunr.QueryLexer.prototype.ignore = function () {\n  if (this.start == this.pos) {\n    this.pos += 1\n  }\n\n  this.start = this.pos\n}\n\nlunr.QueryLexer.prototype.backup = function () {\n  this.pos -= 1\n}\n\nlunr.QueryLexer.prototype.acceptDigitRun = function () {\n  var char, charCode\n\n  do {\n    char = this.next()\n    charCode = char.charCodeAt(0)\n  } while (charCode > 47 && charCode < 58)\n\n  if (char != lunr.QueryLexer.EOS) {\n    this.backup()\n  }\n}\n\nlunr.QueryLexer.prototype.more = function () {\n  return this.pos < this.length\n}\n\nlunr.QueryLexer.EOS = 'EOS'\nlunr.QueryLexer.FIELD = 'FIELD'\nlunr.QueryLexer.TERM = 'TERM'\nlunr.QueryLexer.EDIT_DISTANCE = 'EDIT_DISTANCE'\nlunr.QueryLexer.BOOST = 'BOOST'\nlunr.QueryLexer.PRESENCE = 'PRESENCE'\n\nlunr.QueryLexer.lexField = function (lexer) {\n  lexer.backup()\n  lexer.emit(lunr.QueryLexer.FIELD)\n  lexer.ignore()\n  return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexTerm = function (lexer) {\n  if (lexer.width() > 1) {\n    lexer.backup()\n    lexer.emit(lunr.QueryLexer.TERM)\n  }\n\n  lexer.ignore()\n\n  if (lexer.more()) {\n    return lunr.QueryLexer.lexText\n  }\n}\n\nlunr.QueryLexer.lexEditDistance = function (lexer) {\n  lexer.ignore()\n  lexer.acceptDigitRun()\n  lexer.emit(lunr.QueryLexer.EDIT_DISTANCE)\n  return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexBoost = function (lexer) {\n  lexer.ignore()\n  lexer.acceptDigitRun()\n  lexer.emit(lunr.QueryLexer.BOOST)\n  return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexEOS = function (lexer) {\n  if (lexer.width() > 0) {\n    lexer.emit(lunr.QueryLexer.TERM)\n  }\n}\n\n// This matches the separator used when tokenising fields\n// within a document. These should match otherwise it is\n// not possible to search for some tokens within a document.\n//\n// It is possible for the user to change the separator on the\n// tokenizer so it _might_ clash with any other of the special\n// characters already used within the search string, e.g. :.\n//\n// This means that it is possible to change the separator in\n// such a way that makes some words unsearchable using a search\n// string.\nlunr.QueryLexer.termSeparator = lunr.tokenizer.separator\n\nlunr.QueryLexer.lexText = function (lexer) {\n  while (true) {\n    var char = lexer.next()\n\n    if (char == lunr.QueryLexer.EOS) {\n      return lunr.QueryLexer.lexEOS\n    }\n\n    // Escape character is '\\'\n    if (char.charCodeAt(0) == 92) {\n      lexer.escapeCharacter()\n      continue\n    }\n\n    if (char == \":\") {\n      return lunr.QueryLexer.lexField\n    }\n\n    if (char == \"~\") {\n      lexer.backup()\n      if (lexer.width() > 0) {\n        lexer.emit(lunr.QueryLexer.TERM)\n      }\n      return lunr.QueryLexer.lexEditDistance\n    }\n\n    if (char == \"^\") {\n      lexer.backup()\n      if (lexer.width() > 0) {\n        lexer.emit(lunr.QueryLexer.TERM)\n      }\n      return lunr.QueryLexer.lexBoost\n    }\n\n    // \"+\" indicates term presence is required\n    // checking for length to ensure that only\n    // leading \"+\" are considered\n    if (char == \"+\" && lexer.width() === 1) {\n      lexer.emit(lunr.QueryLexer.PRESENCE)\n      return lunr.QueryLexer.lexText\n    }\n\n    // \"-\" indicates term presence is prohibited\n    // checking for length to ensure that only\n    // leading \"-\" are considered\n    if (char == \"-\" && lexer.width() === 1) {\n      lexer.emit(lunr.QueryLexer.PRESENCE)\n      return lunr.QueryLexer.lexText\n    }\n\n    if (char.match(lunr.QueryLexer.termSeparator)) {\n      return lunr.QueryLexer.lexTerm\n    }\n  }\n}\n\nlunr.QueryParser = function (str, query) {\n  this.lexer = new lunr.QueryLexer (str)\n  this.query = query\n  this.currentClause = {}\n  this.lexemeIdx = 0\n}\n\nlunr.QueryParser.prototype.parse = function () {\n  this.lexer.run()\n  this.lexemes = this.lexer.lexemes\n\n  var state = lunr.QueryParser.parseClause\n\n  while (state) {\n    state = state(this)\n  }\n\n  return this.query\n}\n\nlunr.QueryParser.prototype.peekLexeme = function () {\n  return this.lexemes[this.lexemeIdx]\n}\n\nlunr.QueryParser.prototype.consumeLexeme = function () {\n  var lexeme = this.peekLexeme()\n  this.lexemeIdx += 1\n  return lexeme\n}\n\nlunr.QueryParser.prototype.nextClause = function () {\n  var completedClause = this.currentClause\n  this.query.clause(completedClause)\n  this.currentClause = {}\n}\n\nlunr.QueryParser.parseClause = function (parser) {\n  var lexeme = parser.peekLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  switch (lexeme.type) {\n    case lunr.QueryLexer.PRESENCE:\n      return lunr.QueryParser.parsePresence\n    case lunr.QueryLexer.FIELD:\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.TERM:\n      return lunr.QueryParser.parseTerm\n    default:\n      var errorMessage = \"expected either a field or a term, found \" + lexeme.type\n\n      if (lexeme.str.length >= 1) {\n        errorMessage += \" with value '\" + lexeme.str + \"'\"\n      }\n\n      throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n}\n\nlunr.QueryParser.parsePresence = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  switch (lexeme.str) {\n    case \"-\":\n      parser.currentClause.presence = lunr.Query.presence.PROHIBITED\n      break\n    case \"+\":\n      parser.currentClause.presence = lunr.Query.presence.REQUIRED\n      break\n    default:\n      var errorMessage = \"unrecognised presence operator'\" + lexeme.str + \"'\"\n      throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    var errorMessage = \"expecting term or field, found nothing\"\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.FIELD:\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.TERM:\n      return lunr.QueryParser.parseTerm\n    default:\n      var errorMessage = \"expecting term or field, found '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\nlunr.QueryParser.parseField = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  if (parser.query.allFields.indexOf(lexeme.str) == -1) {\n    var possibleFields = parser.query.allFields.map(function (f) { return \"'\" + f + \"'\" }).join(', '),\n        errorMessage = \"unrecognised field '\" + lexeme.str + \"', possible fields: \" + possibleFields\n\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  parser.currentClause.fields = [lexeme.str]\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    var errorMessage = \"expecting term, found nothing\"\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.TERM:\n      return lunr.QueryParser.parseTerm\n    default:\n      var errorMessage = \"expecting term, found '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\nlunr.QueryParser.parseTerm = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  parser.currentClause.term = lexeme.str.toLowerCase()\n\n  if (lexeme.str.indexOf(\"*\") != -1) {\n    parser.currentClause.usePipeline = false\n  }\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    parser.nextClause()\n    return\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.TERM:\n      parser.nextClause()\n      return lunr.QueryParser.parseTerm\n    case lunr.QueryLexer.FIELD:\n      parser.nextClause()\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.EDIT_DISTANCE:\n      return lunr.QueryParser.parseEditDistance\n    case lunr.QueryLexer.BOOST:\n      return lunr.QueryParser.parseBoost\n    case lunr.QueryLexer.PRESENCE:\n      parser.nextClause()\n      return lunr.QueryParser.parsePresence\n    default:\n      var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\nlunr.QueryParser.parseEditDistance = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  var editDistance = parseInt(lexeme.str, 10)\n\n  if (isNaN(editDistance)) {\n    var errorMessage = \"edit distance must be numeric\"\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  parser.currentClause.editDistance = editDistance\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    parser.nextClause()\n    return\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.TERM:\n      parser.nextClause()\n      return lunr.QueryParser.parseTerm\n    case lunr.QueryLexer.FIELD:\n      parser.nextClause()\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.EDIT_DISTANCE:\n      return lunr.QueryParser.parseEditDistance\n    case lunr.QueryLexer.BOOST:\n      return lunr.QueryParser.parseBoost\n    case lunr.QueryLexer.PRESENCE:\n      parser.nextClause()\n      return lunr.QueryParser.parsePresence\n    default:\n      var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\nlunr.QueryParser.parseBoost = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  var boost = parseInt(lexeme.str, 10)\n\n  if (isNaN(boost)) {\n    var errorMessage = \"boost must be numeric\"\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  parser.currentClause.boost = boost\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    parser.nextClause()\n    return\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.TERM:\n      parser.nextClause()\n      return lunr.QueryParser.parseTerm\n    case lunr.QueryLexer.FIELD:\n      parser.nextClause()\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.EDIT_DISTANCE:\n      return lunr.QueryParser.parseEditDistance\n    case lunr.QueryLexer.BOOST:\n      return lunr.QueryParser.parseBoost\n    case lunr.QueryLexer.PRESENCE:\n      parser.nextClause()\n      return lunr.QueryParser.parsePresence\n    default:\n      var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\n  /**\n   * export the module via AMD, CommonJS or as a browser global\n   * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js\n   */\n  ;(function (root, factory) {\n    if (typeof define === 'function' && define.amd) {\n      // AMD. Register as an anonymous module.\n      define(factory)\n    } else if (typeof exports === 'object') {\n      /**\n       * Node. Does not work with strict CommonJS, but\n       * only CommonJS-like enviroments that support module.exports,\n       * like Node.\n       */\n      module.exports = factory()\n    } else {\n      // Browser globals (root is window)\n      root.lunr = factory()\n    }\n  }(this, function () {\n    /**\n     * Just return a value to define the module export.\n     * This example returns an object, but the module\n     * can return a function as the exported value.\n     */\n    return lunr\n  }))\n})();\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport lunr from \"lunr\"\n\nimport { getElement } from \"~/browser/element/_\"\nimport \"~/polyfills\"\n\nimport { Search } from \"../../_\"\nimport { SearchConfig } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Add support for `iframe-worker` shim\n *\n * While `importScripts` is synchronous when executed inside of a web worker,\n * it's not possible to provide a synchronous shim implementation. The cool\n * thing is that awaiting a non-Promise will convert it into a Promise, so\n * extending the type definition to return a `Promise` shouldn't break anything.\n *\n * @see https://bit.ly/2PjDnXi - GitHub comment\n *\n * @param urls - Scripts to load\n *\n * @returns Promise resolving with no result\n */\ndeclare global {\n  function importScripts(...urls: string[]): Promise<void> | void\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nlet index: Search\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch (= import) multi-language support through `lunr-languages`\n *\n * This function automatically imports the stemmers necessary to process the\n * languages which are defined as part of the search configuration.\n *\n * If the worker runs inside of an `iframe` (when using `iframe-worker` as\n * a shim), the base URL for the stemmers to be loaded must be determined by\n * searching for the first `script` element with a `src` attribute, which will\n * contain the contents of this script.\n *\n * @param config - Search configuration\n *\n * @returns Promise resolving with no result\n */\nasync function setupSearchLanguages(\n  config: SearchConfig\n): Promise<void> {\n  let base = \"../lunr\"\n\n  /* Detect `iframe-worker` and fix base URL */\n  if (typeof parent !== \"undefined\" && \"IFrameWorker\" in parent) {\n    const worker = getElement<HTMLScriptElement>(\"script[src]\")!\n    const [path] = worker.src.split(\"/worker\")\n\n    /* Prefix base with path */\n    base = base.replace(\"..\", path)\n  }\n\n  /* Add scripts for languages */\n  const scripts = []\n  for (const lang of config.lang) {\n    switch (lang) {\n\n      /* Add segmenter for Japanese */\n      case \"ja\":\n        scripts.push(`${base}/tinyseg.js`)\n        break\n\n      /* Add segmenter for Hindi and Thai */\n      case \"hi\":\n      case \"th\":\n        scripts.push(`${base}/wordcut.js`)\n        break\n    }\n\n    /* Add language support */\n    if (lang !== \"en\")\n      scripts.push(`${base}/min/lunr.${lang}.min.js`)\n  }\n\n  /* Add multi-language support */\n  if (config.lang.length > 1)\n    scripts.push(`${base}/min/lunr.multi.min.js`)\n\n  /* Load scripts synchronously */\n  if (scripts.length)\n    await importScripts(\n      `${base}/min/lunr.stemmer.support.min.js`,\n      ...scripts\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Message handler\n *\n * @param message - Source message\n *\n * @returns Target message\n */\nexport async function handler(\n  message: SearchMessage\n): Promise<SearchMessage> {\n  switch (message.type) {\n\n    /* Search setup message */\n    case SearchMessageType.SETUP:\n      await setupSearchLanguages(message.data.config)\n      index = new Search(message.data)\n      return {\n        type: SearchMessageType.READY\n      }\n\n    /* Search query message */\n    case SearchMessageType.QUERY:\n      const query = message.data\n      try {\n        return {\n          type: SearchMessageType.RESULT,\n          data: index.search(query)\n        }\n\n      /* Return empty result in case of error */\n      } catch (err) {\n        console.warn(`Invalid query: ${query} \u2013 see https://bit.ly/2s3ChXG`)\n        console.warn(err)\n        return {\n          type: SearchMessageType.RESULT,\n          data: { items: [] }\n        }\n      }\n\n    /* All other messages */\n    default:\n      throw new TypeError(\"Invalid message type\")\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Worker\n * ------------------------------------------------------------------------- */\n\n/* Expose Lunr.js in global scope, or stemmers won't work */\nself.lunr = lunr\n\n/* Handle messages */\naddEventListener(\"message\", async ev => {\n  postMessage(await handler(ev.data))\n})\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search configuration\n */\nexport interface SearchConfig {\n  lang: string[]                       /* Search languages */\n  separator: string                    /* Search separator */\n  pipeline: SearchPipelineFn[]         /* Search pipeline */\n}\n\n/**\n * Search document\n */\nexport interface SearchDocument {\n  location: string                     /* Document location */\n  title: string                        /* Document title */\n  text: string                         /* Document text */\n  tags?: string[]                      /* Document tags */\n  boost?: number                       /* Document boost */\n  parent?: SearchDocument              /* Document parent */\n}\n\n/**\n * Search options\n */\nexport interface SearchOptions {\n  suggest: boolean                     /* Search suggestions */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nexport interface SearchIndex {\n  config: SearchConfig                 /* Search configuration */\n  docs: SearchDocument[]               /* Search documents */\n  options: SearchOptions               /* Search options */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search pipeline function\n */\ntype SearchPipelineFn =\n  | \"trimmer\"                          /* Trimmer */\n  | \"stopWordFilter\"                   /* Stop word filter */\n  | \"stemmer\"                          /* Stemmer */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search document map\n *\n * This function creates a mapping of URLs (including anchors) to the actual\n * articles and sections. It relies on the invariant that the search index is\n * ordered with the main article appearing before all sections with anchors.\n * If this is not the case, the logic music be changed.\n *\n * @param docs - Search documents\n *\n * @returns Search document map\n */\nexport function setupSearchDocumentMap(\n  docs: SearchDocument[]\n): Map<string, SearchDocument> {\n  const map = new Map<string, SearchDocument>()\n  for (const doc of docs) {\n    const [path] = doc.location.split(\"#\")\n\n    /* Add document article */\n    const article = map.get(path)\n    if (typeof article === \"undefined\") {\n      map.set(path, doc)\n\n      /* Add document section */\n    } else {\n      map.set(doc.location, doc)\n      doc.parent = article\n    }\n  }\n\n  /* Return search document map */\n  return map\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Visitor function\n *\n * @param start - Start offset\n * @param end - End offset\n */\ntype VisitorFn = (\n  start: number, end: number\n) => void\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Split a string using the given separator\n *\n * @param input - Input value\n * @param separator - Separator\n * @param fn - Visitor function\n */\nexport function split(\n  input: string, separator: RegExp, fn: VisitorFn\n): void {\n  separator = new RegExp(separator, \"g\")\n\n  /* Split string using separator */\n  let match: RegExpExecArray | null\n  let index = 0\n  do {\n    match = separator.exec(input)\n\n    /* Emit non-empty range */\n    const until = match?.index ?? input.length\n    if (index < until)\n      fn(index, until)\n\n    /* Update last index */\n    if (match) {\n      const [term] = match\n      index = match.index + term.length\n\n      /* Support zero-length lookaheads */\n      if (term.length === 0)\n        separator.lastIndex = match.index + 1\n    }\n  } while (match)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Extraction type\n *\n * This type defines the possible values that are encoded into the first two\n * bits of a section that is part of the blocks of a tokenization table. There\n * are three types of interest: HTML opening and closing tags, as well as the\n * actual text content we need to extract for indexing.\n */\nexport const enum Extract {\n  TAG_OPEN  = 0,                       /* HTML opening tag */\n  TEXT      = 1,                       /* Text content */\n  TAG_CLOSE = 2                        /* HTML closing tag */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Visitor function\n *\n * @param block - Block index\n * @param type - Extraction type\n * @param start - Start offset\n * @param end - End offset\n */\ntype VisitorFn = (\n  block: number, type: Extract, start: number, end: number\n) => void\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Split a string into markup and text sections\n *\n * This function scans a string and divides it up into sections of markup and\n * text. For each section, it invokes the given visitor function with the block\n * index, extraction type, as well as start and end offsets. Using a visitor\n * function (= streaming data) is ideal for minimizing pressure on the GC.\n *\n * @param input - Input value\n * @param fn - Visitor function\n */\nexport function extract(\n  input: string, fn: VisitorFn\n): void {\n\n  let block = 0                        /* Current block */\n  let start = 0                        /* Current start offset */\n  let end = 0                          /* Current end offset */\n\n  /* Split string into sections */\n  for (let stack = 0; end < input.length; end++) {\n\n    /* Opening tag after non-empty section */\n    if (input.charAt(end) === \"<\" && end > start) {\n      fn(block, Extract.TEXT, start, start = end)\n\n    /* Closing tag */\n    } else if (input.charAt(end) === \">\") {\n      if (input.charAt(start + 1) === \"/\") {\n        if (--stack === 0)\n          fn(block++, Extract.TAG_CLOSE, start, end + 1)\n\n      /* Tag is not self-closing */\n      } else if (input.charAt(end - 1) !== \"/\") {\n        if (stack++ === 0)\n          fn(block, Extract.TAG_OPEN, start, end + 1)\n      }\n\n      /* New section */\n      start = end + 1\n    }\n  }\n\n  /* Add trailing section */\n  if (end > start)\n    fn(block, Extract.TEXT, start, end)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Position table\n */\nexport type PositionTable = number[][]\n\n/**\n * Position\n */\nexport type Position = number\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Highlight all occurrences in a string\n *\n * This function receives a field's value (e.g. like `title` or `text`), it's\n * position table that was generated during indexing, and the positions found\n * when executing the query. It then highlights all occurrences, and returns\n * their concatenation. In case of multiple blocks, two are returned.\n *\n * @param input - Input value\n * @param table - Table for indexing\n * @param positions - Occurrences\n * @param full - Full results\n *\n * @returns Highlighted string value\n */\nexport function highlight(\n  input: string, table: PositionTable, positions: Position[], full = false\n): string {\n  return highlightAll([input], table, positions, full).pop()!\n}\n\n/**\n * Highlight all occurrences in a set of strings\n *\n * @param inputs - Input values\n * @param table - Table for indexing\n * @param positions - Occurrences\n * @param full - Full results\n *\n * @returns Highlighted string values\n */\nexport function highlightAll(\n  inputs: string[], table: PositionTable, positions: Position[], full = false\n): string[] {\n\n  /* Map blocks to input values */\n  const mapping = [0]\n  for (let t = 1; t < table.length; t++) {\n    const prev = table[t - 1]\n    const next = table[t]\n\n    /* Check if table points to new block */\n    const p = prev[prev.length - 1] >>> 2 & 0x3FF\n    const q = next[0]               >>> 12\n\n    /* Add block to mapping */\n    mapping.push(+(p > q) + mapping[mapping.length - 1])\n  }\n\n  /* Highlight strings one after another */\n  return inputs.map((input, i) => {\n    let cursor = 0\n\n    /* Map occurrences to blocks */\n    const blocks = new Map<number, number[]>()\n    for (const p of positions.sort((a, b) => a - b)) {\n      const index = p & 0xFFFFF\n      const block = p >>> 20\n      if (mapping[block] !== i)\n        continue\n\n      /* Ensure presence of block group */\n      let group = blocks.get(block)\n      if (typeof group === \"undefined\")\n        blocks.set(block, group = [])\n\n      /* Add index to group */\n      group.push(index)\n    }\n\n    /* Just return string, if no occurrences */\n    if (blocks.size === 0)\n      return input\n\n    /* Compute slices */\n    const slices: string[] = []\n    for (const [block, indexes] of blocks) {\n      const t = table[block]\n\n      /* Extract positions and length */\n      const start  = t[0]            >>> 12\n      const end    = t[t.length - 1] >>> 12\n      const length = t[t.length - 1] >>> 2 & 0x3FF\n\n      /* Add prefix, if full results are desired */\n      if (full && start > cursor)\n        slices.push(input.slice(cursor, start))\n\n      /* Extract and highlight slice */\n      let slice = input.slice(start, end + length)\n      for (const j of indexes.sort((a, b) => b - a)) {\n\n        /* Retrieve offset and length of match */\n        const p = (t[j] >>> 12) - start\n        const q = (t[j] >>> 2 & 0x3FF) + p\n\n        /* Wrap occurrence */\n        slice = [\n          slice.slice(0, p),\n          \"<mark>\",\n          slice.slice(p, q),\n          \"</mark>\",\n          slice.slice(q)\n        ].join(\"\")\n      }\n\n      /* Update cursor */\n      cursor = end + length\n\n      /* Append slice and abort if we have two */\n      if (slices.push(slice) === 2)\n        break\n    }\n\n    /* Add suffix, if full results are desired */\n    if (full && cursor < input.length)\n      slices.push(input.slice(cursor))\n\n    /* Return highlighted slices */\n    return slices.join(\"\")\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { split } from \"../_\"\nimport {\n  Extract,\n  extract\n} from \"../extract\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Split a string or set of strings into tokens\n *\n * This tokenizer supersedes the default tokenizer that is provided by Lunr.js,\n * as it is aware of HTML tags and allows for multi-character splitting.\n *\n * It takes the given inputs, splits each of them into markup and text sections,\n * tokenizes and segments (if necessary) each of them, and then indexes them in\n * a table by using a compact bit representation. Bitwise techniques are used\n * to write and read from the table during indexing and querying.\n *\n * @see https://bit.ly/3W3Xw4J - Search: better, faster, smaller\n *\n * @param input - Input value(s)\n *\n * @returns Tokens\n */\nexport function tokenize(\n  input?: string | string[]\n): lunr.Token[] {\n  const tokens: lunr.Token[] = []\n  if (typeof input === \"undefined\")\n    return tokens\n\n  /* Tokenize strings one after another */\n  const inputs = Array.isArray(input) ? input : [input]\n  for (let i = 0; i < inputs.length; i++) {\n    const table = lunr.tokenizer.table\n    const total = table.length\n\n    /* Split string into sections and tokenize content blocks */\n    extract(inputs[i], (block, type, start, end) => {\n      table[block += total] ||= []\n      switch (type) {\n\n        /* Handle markup */\n        case Extract.TAG_OPEN:\n        case Extract.TAG_CLOSE:\n          table[block].push(\n            start       << 12 |\n            end - start <<  2 |\n            type\n          )\n          break\n\n        /* Handle text content */\n        case Extract.TEXT:\n          const section = inputs[i].slice(start, end)\n          split(section, lunr.tokenizer.separator, (index, until) => {\n\n            /**\n             * Apply segmenter after tokenization. Note that the segmenter will\n             * also split words at word boundaries, which is not what we want,\n             * so we need to check if we can somehow mitigate this behavior.\n             */\n            if (typeof lunr.segmenter !== \"undefined\") {\n              const subsection = section.slice(index, until)\n              if (/^[MHIK]$/.test(lunr.segmenter.ctype_(subsection))) {\n                const segments = lunr.segmenter.segment(subsection)\n                for (let s = 0, l = 0; s < segments.length; s++) {\n\n                  /* Add block to section */\n                  table[block] ||= []\n                  table[block].push(\n                    start + index + l  << 12 |\n                    segments[s].length <<  2 |\n                    type\n                  )\n\n                  /* Add token with position */\n                  tokens.push(new lunr.Token(\n                    segments[s].toLowerCase(), {\n                      position: block << 20 | table[block].length - 1\n                    }\n                  ))\n\n                  /* Keep track of length */\n                  l += segments[s].length\n                }\n                return\n              }\n            }\n\n            /* Add block to section */\n            table[block].push(\n              start + index << 12 |\n              until - index <<  2 |\n              type\n            )\n\n            /* Add token with position */\n            tokens.push(new lunr.Token(\n              section.slice(index, until).toLowerCase(), {\n                position: block << 20 | table[block].length - 1\n              }\n            ))\n          })\n      }\n    })\n  }\n\n  /* Return tokens */\n  return tokens\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Visitor function\n *\n * @param value - String value\n *\n * @returns String term(s)\n */\ntype VisitorFn = (\n  value: string\n) => string | string[]\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Default transformation function\n *\n * 1. Trim excess whitespace from left and right.\n *\n * 2. Search for parts in quotation marks and prepend a `+` modifier to denote\n *    that the resulting document must contain all parts, converting the query\n *    to an `AND` query (as opposed to the default `OR` behavior). While users\n *    may expect parts enclosed in quotation marks to map to span queries, i.e.\n *    for which order is important, Lunr.js doesn't support them, so the best\n *    we can do is to convert the parts to an `AND` query.\n *\n * 3. Replace control characters which are not located at the beginning of the\n *    query or preceded by white space, or are not followed by a non-whitespace\n *    character or are at the end of the query string. Furthermore, filter\n *    unmatched quotation marks.\n *\n * 4. Split the query string at whitespace, then pass each part to the visitor\n *    function for tokenization, and append a wildcard to every resulting term\n *    that is not explicitly marked with a `+`, `-`, `~` or `^` modifier, since\n *    it ensures consistent and stable ranking when multiple terms are entered.\n *    Also, if a fuzzy or boost modifier are given, but no numeric value has\n *    been entered, default to 1 to not induce a query error.\n *\n * @param query - Query value\n * @param fn - Visitor function\n *\n * @returns Transformed query value\n */\nexport function transform(\n  query: string, fn: VisitorFn = term => term\n): string {\n  return query\n\n    /* => 1 */\n    .trim()\n\n    /* => 2 */\n    .split(/\"([^\"]+)\"/g)\n      .map((parts, index) => index & 1\n        ? parts.replace(/^\\b|^(?![^\\x00-\\x7F]|$)|\\s+/g, \" +\")\n        : parts\n      )\n      .join(\"\")\n\n    /* => 3 */\n    .replace(/\"|(?:^|\\s+)[*+\\-:^~]+(?=\\s+|$)/g, \"\")\n\n    /* => 4 */\n    .split(/\\s+/g)\n      .reduce((prev, term) => {\n        const next = fn(term)\n        return [...prev, ...Array.isArray(next) ? next : [next]]\n      }, [] as string[])\n      .map(term => /([~^]$)/.test(term) ? `${term}1` : term)\n      .map(term => /(^[+-]|[~^]\\d+$)/.test(term) ? term : `${term}*`)\n      .join(\" \")\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { split } from \"../../internal\"\nimport { transform } from \"../transform\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query clause\n */\nexport interface SearchQueryClause {\n  presence: lunr.Query.presence        /* Clause presence */\n  term: string                         /* Clause term */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search query terms\n */\nexport type SearchQueryTerms = Record<string, boolean>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Transform search query\n *\n * This function lexes the given search query and applies the transformation\n * function to each term, preserving markup like `+` and `-` modifiers.\n *\n * @param query - Search query\n *\n * @returns Search query\n */\nexport function transformSearchQuery(\n  query: string\n): string {\n\n  /* Split query terms with tokenizer */\n  return transform(query, part => {\n    const terms: string[] = []\n\n    /* Initialize lexer and analyze part */\n    const lexer = new lunr.QueryLexer(part)\n    lexer.run()\n\n    /* Extract and tokenize term from lexeme */\n    for (const { type, str: term, start, end } of lexer.lexemes)\n      switch (type) {\n\n        /* Hack: remove colon - see https://bit.ly/3wD3T3I */\n        case \"FIELD\":\n          if (![\"title\", \"text\", \"tags\"].includes(term))\n            part = [\n              part.slice(0, end),\n              \" \",\n              part.slice(end + 1)\n            ].join(\"\")\n          break\n\n        /* Tokenize term */\n        case \"TERM\":\n          split(term, lunr.tokenizer.separator, (...range) => {\n            terms.push([\n              part.slice(0, start),\n              term.slice(...range),\n              part.slice(end)\n            ].join(\"\"))\n          })\n      }\n\n    /* Return terms */\n    return terms\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Parse a search query for analysis\n *\n * Lunr.js itself has a bug where it doesn't detect or remove wildcards for\n * query clauses, so we must do this here.\n *\n * @see https://bit.ly/3DpTGtz - GitHub issue\n *\n * @param value - Query value\n *\n * @returns Search query clauses\n */\nexport function parseSearchQuery(\n  value: string\n): SearchQueryClause[] {\n  const query  = new lunr.Query([\"title\", \"text\", \"tags\"])\n  const parser = new lunr.QueryParser(value, query)\n\n  /* Parse Search query */\n  parser.parse()\n  for (const clause of query.clauses) {\n    clause.usePipeline = true\n\n    /* Handle leading wildcard */\n    if (clause.term.startsWith(\"*\")) {\n      clause.wildcard = lunr.Query.wildcard.LEADING\n      clause.term = clause.term.slice(1)\n    }\n\n    /* Handle trailing wildcard */\n    if (clause.term.endsWith(\"*\")) {\n      clause.wildcard = lunr.Query.wildcard.TRAILING\n      clause.term = clause.term.slice(0, -1)\n    }\n  }\n\n  /* Return query clauses */\n  return query.clauses\n}\n\n/**\n * Analyze the search query clauses in regard to the search terms found\n *\n * @param query - Search query clauses\n * @param terms - Search terms\n *\n * @returns Search query terms\n */\nexport function getSearchQueryTerms(\n  query: SearchQueryClause[], terms: string[]\n): SearchQueryTerms {\n  const clauses = new Set<SearchQueryClause>(query)\n\n  /* Match query clauses against terms */\n  const result: SearchQueryTerms = {}\n  for (let t = 0; t < terms.length; t++)\n    for (const clause of clauses)\n      if (terms[t].startsWith(clause.term)) {\n        result[clause.term] = true\n        clauses.delete(clause)\n      }\n\n  /* Annotate unmatched non-stopword query clauses */\n  for (const clause of clauses)\n    if (lunr.stopWordFilter?.(clause.term))\n      result[clause.term] = false\n\n  /* Return query terms */\n  return result\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Segment a search query using the inverted index\n *\n * This function implements a clever approach to text segmentation for Asian\n * languages, as it used the information already available in the search index.\n * The idea is to greedily segment the search query based on the tokens that are\n * already part of the index, as described in the linked issue.\n *\n * @see https://bit.ly/3lwjrk7 - GitHub issue\n *\n * @param query - Query value\n * @param index - Inverted index\n *\n * @returns Segmented query value\n */\nexport function segment(\n  query: string, index: object\n): Iterable<string> {\n  const segments = new Set<string>()\n\n  /* Segment search query */\n  const wordcuts = new Uint16Array(query.length)\n  for (let i = 0; i < query.length; i++)\n    for (let j = i + 1; j < query.length; j++) {\n      const value = query.slice(i, j)\n      if (value in index)\n        wordcuts[i] = j - i\n    }\n\n  /* Compute longest matches with minimum overlap */\n  const stack = [0]\n  for (let s = stack.length; s > 0;) {\n    const p = stack[--s]\n    for (let q = 1; q < wordcuts[p]; q++)\n      if (wordcuts[p + q] > wordcuts[p] - q) {\n        segments.add(query.slice(p, p + q))\n        stack[s++] = p + q\n      }\n\n    /* Continue at end of query string */\n    const q = p + wordcuts[p]\n    if (wordcuts[q] && q < query.length - 1)\n      stack[s++] = q\n\n    /* Add current segment */\n    segments.add(query.slice(p, q))\n  }\n\n  // @todo fix this case in the code block above, this is a hotfix\n  if (segments.has(\"\"))\n    return new Set([query])\n\n  /* Return segmented query value */\n  return segments\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  SearchDocument,\n  SearchIndex,\n  SearchOptions,\n  setupSearchDocumentMap\n} from \"../config\"\nimport {\n  Position,\n  PositionTable,\n  highlight,\n  highlightAll,\n  tokenize\n} from \"../internal\"\nimport {\n  SearchQueryTerms,\n  getSearchQueryTerms,\n  parseSearchQuery,\n  segment,\n  transformSearchQuery\n} from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search item\n */\nexport interface SearchItem\n  extends SearchDocument\n{\n  score: number                        /* Score (relevance) */\n  terms: SearchQueryTerms              /* Search query terms */\n}\n\n/**\n * Search result\n */\nexport interface SearchResult {\n  items: SearchItem[][]                /* Search items */\n  suggest?: string[]                   /* Search suggestions */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create field extractor factory\n *\n * @param table - Position table map\n *\n * @returns Extractor factory\n */\nfunction extractor(table: Map<string, PositionTable>) {\n  return (name: keyof SearchDocument) => {\n    return (doc: SearchDocument) => {\n      if (typeof doc[name] === \"undefined\")\n        return undefined\n\n      /* Compute identifier and initialize table */\n      const id = [doc.location, name].join(\":\")\n      table.set(id, lunr.tokenizer.table = [])\n\n      /* Return field value */\n      return doc[name]\n    }\n  }\n}\n\n/**\n * Compute the difference of two lists of strings\n *\n * @param a - 1st list of strings\n * @param b - 2nd list of strings\n *\n * @returns Difference\n */\nfunction difference(a: string[], b: string[]): string[] {\n  const [x, y] = [new Set(a), new Set(b)]\n  return [\n    ...new Set([...x].filter(value => !y.has(value)))\n  ]\n}\n\n/* ----------------------------------------------------------------------------\n * Class\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nexport class Search {\n\n  /**\n   * Search document map\n   */\n  protected map: Map<string, SearchDocument>\n\n  /**\n   * Search options\n   */\n  protected options: SearchOptions\n\n  /**\n   * The underlying Lunr.js search index\n   */\n  protected index: lunr.Index\n\n  /**\n   * Internal position table map\n   */\n  protected table: Map<string, PositionTable>\n\n  /**\n   * Create the search integration\n   *\n   * @param data - Search index\n   */\n  public constructor({ config, docs, options }: SearchIndex) {\n    const field = extractor(this.table = new Map())\n\n    /* Set up document map and options */\n    this.map = setupSearchDocumentMap(docs)\n    this.options = options\n\n    /* Set up document index */\n    this.index = lunr(function () {\n      this.metadataWhitelist = [\"position\"]\n      this.b(0)\n\n      /* Set up (multi-)language support */\n      if (config.lang.length === 1 && config.lang[0] !== \"en\") {\n        // @ts-expect-error - namespace indexing not supported\n        this.use(lunr[config.lang[0]])\n      } else if (config.lang.length > 1) {\n        this.use(lunr.multiLanguage(...config.lang))\n      }\n\n      /* Set up custom tokenizer (must be after language setup) */\n      this.tokenizer = tokenize as typeof lunr.tokenizer\n      lunr.tokenizer.separator = new RegExp(config.separator)\n\n      /* Set up custom segmenter, if loaded */\n      lunr.segmenter = \"TinySegmenter\" in lunr\n        ? new lunr.TinySegmenter()\n        : undefined\n\n      /* Compute functions to be removed from the pipeline */\n      const fns = difference([\n        \"trimmer\", \"stopWordFilter\", \"stemmer\"\n      ], config.pipeline)\n\n      /* Remove functions from the pipeline for registered languages */\n      for (const lang of config.lang.map(language => (\n        // @ts-expect-error - namespace indexing not supported\n        language === \"en\" ? lunr : lunr[language]\n      )))\n        for (const fn of fns) {\n          this.pipeline.remove(lang[fn])\n          this.searchPipeline.remove(lang[fn])\n        }\n\n      /* Set up index reference */\n      this.ref(\"location\")\n\n      /* Set up index fields */\n      this.field(\"title\", { boost: 1e3, extractor: field(\"title\") })\n      this.field(\"text\",  { boost: 1e0, extractor: field(\"text\") })\n      this.field(\"tags\",  { boost: 1e6, extractor: field(\"tags\") })\n\n      /* Add documents to index */\n      for (const doc of docs)\n        this.add(doc, { boost: doc.boost })\n    })\n  }\n\n  /**\n   * Search for matching documents\n   *\n   * @param query - Search query\n   *\n   * @returns Search result\n   */\n  public search(query: string): SearchResult {\n\n    // Experimental Chinese segmentation\n    query = query.replace(/\\p{sc=Han}+/gu, value => {\n      return [...segment(value, this.index.invertedIndex)]\n        .join(\"* \")\n    })\n\n    // @todo: move segmenter (above) into transformSearchQuery\n    query = transformSearchQuery(query)\n    if (!query)\n      return { items: [] }\n\n    /* Parse query to extract clauses for analysis */\n    const clauses = parseSearchQuery(query)\n      .filter(clause => (\n        clause.presence !== lunr.Query.presence.PROHIBITED\n      ))\n\n    /* Perform search and post-process results */\n    const groups = this.index.search(query)\n\n      /* Apply post-query boosts based on title and search query terms */\n      .reduce<SearchItem[]>((item, { ref, score, matchData }) => {\n        let doc = this.map.get(ref)\n        if (typeof doc !== \"undefined\") {\n\n          /* Shallow copy document */\n          doc = { ...doc }\n          if (doc.tags)\n            doc.tags = [...doc.tags]\n\n          /* Compute and analyze search query terms */\n          const terms = getSearchQueryTerms(\n            clauses,\n            Object.keys(matchData.metadata)\n          )\n\n          /* Highlight matches in fields */\n          for (const field of this.index.fields) {\n            if (typeof doc[field] === \"undefined\")\n              continue\n\n            /* Collect positions from matches */\n            const positions: Position[] = []\n            for (const match of Object.values(matchData.metadata))\n              if (typeof match[field] !== \"undefined\")\n                positions.push(...match[field].position)\n\n            /* Skip highlighting, if no positions were collected */\n            if (!positions.length)\n              continue\n\n            /* Load table and determine highlighting method */\n            const table = this.table.get([doc.location, field].join(\":\"))!\n            const fn = Array.isArray(doc[field])\n              ? highlightAll\n              : highlight\n\n            // @ts-expect-error - stop moaning, TypeScript!\n            doc[field] = fn(doc[field], table, positions, field !== \"text\")\n          }\n\n          /* Highlight title and text and apply post-query boosts */\n          const boost = +!doc.parent +\n            Object.values(terms)\n              .filter(t => t).length /\n            Object.keys(terms).length\n\n          /* Append item */\n          item.push({\n            ...doc,\n            score: score * (1 + boost ** 2),\n            terms\n          })\n        }\n        return item\n      }, [])\n\n      /* Sort search results again after applying boosts */\n      .sort((a, b) => b.score - a.score)\n\n      /* Group search results by article */\n      .reduce((items, result) => {\n        const doc = this.map.get(result.location)\n        if (typeof doc !== \"undefined\") {\n          const ref = doc.parent\n            ? doc.parent.location\n            : doc.location\n          items.set(ref, [...items.get(ref) || [], result])\n        }\n        return items\n      }, new Map<string, SearchItem[]>())\n\n    /* Ensure that every item set has an article */\n    for (const [ref, items] of groups)\n      if (!items.find(item => item.location === ref)) {\n        const doc = this.map.get(ref)!\n        items.push({ ...doc, score: 0, terms: {} })\n      }\n\n    /* Generate search suggestions, if desired */\n    let suggest: string[] | undefined\n    if (this.options.suggest) {\n      const titles = this.index.query(builder => {\n        for (const clause of clauses)\n          builder.term(clause.term, {\n            fields: [\"title\"],\n            presence: lunr.Query.presence.REQUIRED,\n            wildcard: lunr.Query.wildcard.TRAILING\n          })\n      })\n\n      /* Retrieve suggestions for best match */\n      suggest = titles.length\n        ? Object.keys(titles[0].matchData.metadata)\n        : []\n    }\n\n    /* Return search result */\n    return {\n      items: [...groups.values()],\n      ...typeof suggest !== \"undefined\" && { suggest }\n    }\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["require_lunr", "__commonJSMin", "exports", "module", "lunr", "config", "builder", "global", "message", "obj", "clone", "keys", "key", "val", "docRef", "fieldName", "stringValue", "s", "n", "fieldRef", "elements", "i", "other", "object", "a", "b", "intersection", "element", "posting", "documentCount", "documentsWithTerm", "x", "str", "metadata", "fn", "t", "len", "tokens", "sliceEnd", "sliceStart", "char", "sliceLength", "tokenMetadata", "label", "isRegistered", "serialised", "pipeline", "fnName", "fns", "existingFn", "newFn", "pos", "stackLength", "memo", "j", "result", "k", "token", "index", "start", "end", "pivotPoint", "pivotIndex", "insertIdx", "position", "sumOfSquares", "elementsLength", "otherVector", "dotProduct", "aLen", "bLen", "aVal", "bVal", "output", "step2list", "step3list", "c", "v", "C", "V", "mgr0", "meq1", "mgr1", "s_v", "re_mgr0", "re_mgr1", "re_meq1", "re_s_v", "re_1a", "re2_1a", "re_1b", "re2_1b", "re_1b_2", "re2_1b_2", "re3_1b_2", "re4_1b_2", "re_1c", "re_2", "re_3", "re_4", "re2_4", "re_5", "re_5_1", "re3_5", "porterStemmer", "w", "stem", "suffix", "firstch", "re", "re2", "re3", "re4", "fp", "stopWords", "words", "stopWord", "arr", "clause", "editDistance", "root", "stack", "frame", "noEditNode", "insertionNode", "substitutionNode", "charA", "charB", "transposeNode", "node", "final", "next", "edges", "edge", "labels", "qEdges", "qLen", "nEdges", "nLen", "q", "qEdge", "nEdge", "qNode", "word", "commonPrefix", "nextNode", "downTo", "childKey", "attrs", "queryString", "query", "parser", "matchingFields", "queryVectors", "termFieldCache", "requiredMatches", "prohibitedMatches", "terms", "clauseMatches", "m", "term", "termTokenSet", "expandedTerms", "field", "expandedTerm", "termIndex", "fieldPosting", "matchingDocumentRefs", "termField", "matchingDocumentsSet", "l", "matchingDocumentRef", "matchingFieldRef", "fieldMatch", "allRequiredMatches", "allProhibitedMatches", "matchingFieldRefs", "results", "matches", "fieldVector", "score", "docMatch", "match", "invertedIndex", "fieldVectors", "ref", "serializedIndex", "serializedVectors", "serializedInvertedIndex", "tokenSetBuilder", "tuple", "attributes", "number", "doc", "fields", "extractor", "fieldTerms", "metadataKey", "fieldRefs", "numberOfFields", "accumulator", "documentsWithField", "fieldRefsLength", "termIdfCache", "fieldLength", "termFrequencies", "termsLength", "fieldBoost", "docBoost", "tf", "idf", "scoreWithPrecision", "args", "clonedMetadata", "metadataKeys", "otherMatchData", "allFields", "options", "state", "subSlices", "type", "charCode", "lexer", "lexeme", "completedClause", "errorMessage", "nextLexeme", "possibleFields", "f", "boost", "factory", "import_lunr", "getElement", "selector", "node", "el", "getOptionalElement", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "setupSearchDocumentMap", "docs", "map", "doc", "path", "article", "split", "input", "separator", "fn", "_a", "match", "index", "until", "term", "extract", "input", "fn", "block", "start", "end", "stack", "highlight", "input", "table", "positions", "full", "highlightAll", "inputs", "mapping", "t", "prev", "next", "p", "q", "i", "cursor", "blocks", "a", "b", "index", "block", "group", "slices", "indexes", "start", "end", "length", "slice", "j", "tokenize", "input", "tokens", "inputs", "i", "table", "total", "extract", "block", "type", "start", "end", "_a", "section", "split", "index", "until", "subsection", "segments", "s", "l", "transform", "query", "fn", "term", "parts", "index", "prev", "next", "transformSearchQuery", "query", "transform", "part", "terms", "lexer", "type", "term", "start", "end", "split", "range", "parseSearchQuery", "value", "clause", "getSearchQueryTerms", "_a", "clauses", "result", "t", "segment", "query", "index", "segments", "wordcuts", "i", "j", "stack", "p", "q", "extractor", "table", "name", "doc", "id", "difference", "a", "b", "x", "y", "value", "Search", "config", "docs", "options", "field", "setupSearchDocumentMap", "tokenize", "fns", "lang", "language", "fn", "query", "segment", "transformSearchQuery", "clauses", "parseSearchQuery", "clause", "groups", "item", "ref", "score", "matchData", "__spreadValues", "terms", "getSearchQueryTerms", "positions", "match", "highlightAll", "highlight", "boost", "t", "__spreadProps", "__pow", "items", "result", "suggest", "titles", "builder", "index", "setupSearchLanguages", "config", "__async", "base", "worker", "getElement", "path", "scripts", "lang", "handler", "message", "Search", "query", "err", "lunr", "ev"]
-}
diff --git a/0.10.0/assets/stylesheets/extra.css b/0.10.0/assets/stylesheets/extra.css
deleted file mode 100644
index bd97b0809..000000000
--- a/0.10.0/assets/stylesheets/extra.css
+++ /dev/null
@@ -1,32 +0,0 @@
-.md-header--shadow, .md-header  {
-  background-color: #37517e;
-  padding: 1em;
-}
-
-#footer {
-  background: #37517e;
-	color: #fff;
-	padding: 2.3em;
-}
-
-#footer .copyright {
-	font-size: 1.4em;
-	float: left;
-}
-
-#footer .sponsored-by {
-  float: right;
-  margin-top: 24px;
-}
-
-#footer .sponsored-by p {
-	font-size: 1em;
-  line-height: 2em;
-  margin: 0;
-}
-
-#footer .sponsored-by .logo {
-  height: auto;
-  max-width: 20em;
-  vertical-align: middle;
-}
diff --git a/0.10.0/assets/stylesheets/main.10ba22f1.min.css b/0.10.0/assets/stylesheets/main.10ba22f1.min.css
deleted file mode 100644
index 1659959e4..000000000
--- a/0.10.0/assets/stylesheets/main.10ba22f1.min.css
+++ /dev/null
@@ -1 +0,0 @@
-@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m18 21-4-4h3V7h-3l4-4 4 4h-3v10h3M2 19v-2h10v2M2 13v-2h7v2M2 7V5h4v2H2Z"/></svg>');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 17h3l-4 4-4-4h3V3h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2v-2Z"/></svg>');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7h3l-4-4-4 4h3v14h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2v-2Z"/></svg>')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent)}.md-typeset a code{color:currentcolor;transition:background-color 125ms}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-webkit-fit-content;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{color-scheme:light;max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12V1Z"/></svg>')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 9h14V7H3v2m0 4h14v-2H3v2m0 4h14v-2H3v2m16 0h2v-2h-2v2m0-10v2h2V7h-2m0 6h2v-2h-2v2Z"/></svg>')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h7c-.41-.25-.8-.56-1.14-.9-.33-.33-.61-.7-.86-1.1H6V4h7v5h5v1.18c.71.16 1.39.43 2 .82V8l-6-6m6.31 16.9c1.33-2.11.69-4.9-1.4-6.22-2.11-1.33-4.91-.68-6.22 1.4-1.34 2.11-.69 4.89 1.4 6.22 1.46.93 3.32.93 4.79.02L22 23.39 23.39 22l-3.08-3.1m-3.81.1a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5Z"/></svg>')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0ZM5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Zm6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"/></svg>');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.495 2.495 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.486 2.486 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.249.249 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z"/></svg>');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Zm0 2.445L6.615 5.5a.75.75 0 0 1-.564.41l-3.097.45 2.24 2.184a.75.75 0 0 1 .216.664l-.528 3.084 2.769-1.456a.75.75 0 0 1 .698 0l2.77 1.456-.53-3.084a.75.75 0 0 1 .216-.664l2.24-2.183-3.096-.45a.75.75 0 0 1-.564-.41L8 2.694Z"/></svg>');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M1 7.775V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.752 1.752 0 0 1 1 7.775Zm1.5 0c0 .066.026.13.073.177l6.25 6.25a.25.25 0 0 0 .354 0l5.025-5.025a.25.25 0 0 0 0-.354l-6.25-6.25a.25.25 0 0 0-.177-.073H2.75a.25.25 0 0 0-.25.25ZM6 5a1 1 0 1 1 0 2 1 1 0 0 1 0-2Z"/></svg>')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 9h2V7h-2m1 13c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8m0-18A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2m-1 15h2v-6h-2v6Z"/></svg>');--md-status--new:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m23 12-2.44-2.78.34-3.68-3.61-.82-1.89-3.18L12 3 8.6 1.54 6.71 4.72l-3.61.81.34 3.68L1 12l2.44 2.78-.34 3.69 3.61.82 1.89 3.18L12 21l3.4 1.46 1.89-3.18 3.61-.82-.34-3.68L23 12m-10 5h-2v-2h2v2m0-4h-2V7h2v6Z"/></svg>');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9 3v1H4v2h1v13a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6h1V4h-5V3H9m0 5h2v9H9V8m4 0h2v9h-2V8Z"/></svg>');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 1 3 5v6c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V5l-9-4m0 6c1.4 0 2.8 1.1 2.8 2.5V11c.6 0 1.2.6 1.2 1.3v3.5c0 .6-.6 1.2-1.3 1.2H9.2c-.6 0-1.2-.6-1.2-1.3v-3.5c0-.6.6-1.2 1.2-1.2V9.5C9.2 8.1 10.6 7 12 7m0 1.2c-.8 0-1.5.5-1.5 1.3V11h3V9.5c0-.8-.7-1.3-1.5-1.3Z"/></svg>')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m5.41 21 .71-4h-4l.35-2h4l1.06-6h-4l.35-2h4l.71-4h2l-.71 4h6l.71-4h2l-.71 4h4l-.35 2h-4l-1.06 6h4l-.35 2h-4l-.71 4h-2l.71-4h-6l-.71 4h-2M9.53 9l-1.06 6h6l1.06-6h-6Z"/></svg>')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 13h-4v4h-2v-4H7v-2h4V7h2v4h4m-5-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-tooltip-width:20rem}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-weight:400;outline:none;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M137.4 374.6c12.5 12.5 32.8 12.5 45.3 0l128-128c9.2-9.2 11.9-22.9 6.9-34.9S301 191.9 288 191.9L32 192c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9l128 128z"/></svg>')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2C6.47 2 2 6.47 2 12s4.47 10 10 10 10-4.47 10-10S17.53 2 12 2m3.1 5.07c.14 0 .28.05.4.16l1.27 1.27c.23.22.23.57 0 .78l-1 1-2.05-2.05 1-1c.1-.11.24-.16.38-.16m-1.97 1.74 2.06 2.06-6.06 6.06H7.07v-2.06l6.06-6.06Z"/></svg>');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 9H7V7h10m0 6H7v-2h10m-3 6H7v-2h7M12 3a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m7 0h-4.18C14.4 1.84 13.3 1 12 1c-1.3 0-2.4.84-2.82 2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V5a2 2 0 0 0-2-2Z"/></svg>');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2Z"/></svg>');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.66 11.2c-.23-.3-.51-.56-.77-.82-.67-.6-1.43-1.03-2.07-1.66C13.33 7.26 13 4.85 13.95 3c-.95.23-1.78.75-2.49 1.32-2.59 2.08-3.61 5.75-2.39 8.9.04.1.08.2.08.33 0 .22-.15.42-.35.5-.23.1-.47.04-.66-.12a.58.58 0 0 1-.14-.17c-1.13-1.43-1.31-3.48-.55-5.12C5.78 10 4.87 12.3 5 14.47c.06.5.12 1 .29 1.5.14.6.41 1.2.71 1.73 1.08 1.73 2.95 2.97 4.96 3.22 2.14.27 4.43-.12 6.07-1.6 1.83-1.66 2.47-4.32 1.53-6.6l-.13-.26c-.21-.46-.77-1.26-.77-1.26m-3.16 6.3c-.28.24-.74.5-1.1.6-1.12.4-2.24-.16-2.9-.82 1.19-.28 1.9-1.16 2.11-2.05.17-.8-.15-1.46-.28-2.23-.12-.74-.1-1.37.17-2.06.19.38.39.76.63 1.06.77 1 1.98 1.44 2.24 2.8.04.14.06.28.06.43.03.82-.33 1.72-.93 2.27Z"/></svg>');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 7 9 19l-5.5-5.5 1.41-1.41L9 16.17 19.59 5.59 21 7Z"/></svg>');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m15.07 11.25-.9.92C13.45 12.89 13 13.5 13 15h-2v-.5c0-1.11.45-2.11 1.17-2.83l1.24-1.26c.37-.36.59-.86.59-1.41a2 2 0 0 0-2-2 2 2 0 0 0-2 2H8a4 4 0 0 1 4-4 4 4 0 0 1 4 4 3.2 3.2 0 0 1-.93 2.25M13 19h-2v-2h2M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10c0-5.53-4.5-10-10-10Z"/></svg>');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 14h-2V9h2m0 9h-2v-2h2M1 21h22L12 2 1 21Z"/></svg>');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m11.5 20 4.86-9.73H13V4l-5 9.73h3.5V20M12 2c2.75 0 5.1 1 7.05 2.95C21 6.9 22 9.25 22 12s-1 5.1-2.95 7.05C17.1 21 14.75 22 12 22s-5.1-1-7.05-2.95C3 17.1 2 14.75 2 12s1-5.1 2.95-7.05C6.9 3 9.25 2 12 2Z"/></svg>');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 13h2v1h-2v-1m10-8v6c0 5.5-3.8 10.7-9 12-5.2-1.3-9-6.5-9-12V5l9-4 9 4m-4 5h-2.2c-.2-.6-.6-1.1-1.1-1.5l1.2-1.2-.7-.7L12.8 8H12c-.2 0-.5 0-.7.1L9.9 6.6l-.8.8 1.2 1.2c-.5.3-.9.8-1.1 1.4H7v1h2v1H7v1h2v1H7v1h2.2c.4 1.2 1.5 2 2.8 2s2.4-.8 2.8-2H17v-1h-2v-1h2v-1h-2v-1h2v-1m-6 2h2v-1h-2v1Z"/></svg>');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M7 2v2h1v14a4 4 0 0 0 4 4 4 4 0 0 0 4-4V4h1V2H7m4 14c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m2-4c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m1-5h-4V4h4v3Z"/></svg>');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 17h3l2-4V7h-6v6h3M6 17h3l2-4V7H5v6h3l-2 4Z"/></svg>')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7v4H5.83l3.58-3.59L8 6l-6 6 6 6 1.41-1.42L5.83 13H21V7h-2Z"/></svg>')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:-webkit-min-content;width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.41 16.58 10.83 12l4.58-4.59L14 6l-6 6 6 6 1.41-1.42Z"/></svg>');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6-1.41-1.42Z"/></svg>')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm16.28-2.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm16.28-2.72a.751.751 0 0 0-.018-1.042.751.751 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.751.751 0 0 0-1.042.018.751.751 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}}
\ No newline at end of file
diff --git a/0.10.0/assets/stylesheets/main.10ba22f1.min.css.map b/0.10.0/assets/stylesheets/main.10ba22f1.min.css.map
deleted file mode 100644
index 087936565..000000000
--- a/0.10.0/assets/stylesheets/main.10ba22f1.min.css.map
+++ /dev/null
@@ -1 +0,0 @@
-{"version":3,"sources":["src/templates/assets/stylesheets/main/components/_meta.scss","../../../../src/templates/assets/stylesheets/main.scss","src/templates/assets/stylesheets/main/_resets.scss","src/templates/assets/stylesheets/main/_colors.scss","src/templates/assets/stylesheets/main/_icons.scss","src/templates/assets/stylesheets/main/_typeset.scss","src/templates/assets/stylesheets/utilities/_break.scss","src/templates/assets/stylesheets/main/components/_author.scss","src/templates/assets/stylesheets/main/components/_banner.scss","src/templates/assets/stylesheets/main/components/_base.scss","src/templates/assets/stylesheets/main/components/_clipboard.scss","src/templates/assets/stylesheets/main/components/_consent.scss","src/templates/assets/stylesheets/main/components/_content.scss","src/templates/assets/stylesheets/main/components/_dialog.scss","src/templates/assets/stylesheets/main/components/_feedback.scss","src/templates/assets/stylesheets/main/components/_footer.scss","src/templates/assets/stylesheets/main/components/_form.scss","src/templates/assets/stylesheets/main/components/_header.scss","node_modules/material-design-color/material-color.scss","src/templates/assets/stylesheets/main/components/_nav.scss","src/templates/assets/stylesheets/main/components/_pagination.scss","src/templates/assets/stylesheets/main/components/_post.scss","src/templates/assets/stylesheets/main/components/_progress.scss","src/templates/assets/stylesheets/main/components/_search.scss","src/templates/assets/stylesheets/main/components/_select.scss","src/templates/assets/stylesheets/main/components/_sidebar.scss","src/templates/assets/stylesheets/main/components/_source.scss","src/templates/assets/stylesheets/main/components/_status.scss","src/templates/assets/stylesheets/main/components/_tabs.scss","src/templates/assets/stylesheets/main/components/_tag.scss","src/templates/assets/stylesheets/main/components/_tooltip.scss","src/templates/assets/stylesheets/main/components/_top.scss","src/templates/assets/stylesheets/main/components/_version.scss","src/templates/assets/stylesheets/main/extensions/markdown/_admonition.scss","src/templates/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/templates/assets/stylesheets/main/extensions/markdown/_toc.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_keys.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/templates/assets/stylesheets/main/integrations/_mermaid.scss","src/templates/assets/stylesheets/main/modifiers/_grid.scss","src/templates/assets/stylesheets/main/modifiers/_inline.scss"],"names":[],"mappings":"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hCswGN,CgCjwGE,oEACE,0BhCowGJ,CgCjwGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChCmwGN,CgC/vGI,gFACE,ahCiwGN,CgCtxGE,8DACE,oBhCyxGJ,CgCtxGI,wFACE,gChCwxGN,CgCnxGE,sEACE,0BhCsxGJ,CgCnxGI,oFACE,wBAlBG,CAmBH,sDAAA,CAAA,8ChCqxGN,CgCjxGI,kFACE,ahCmxGN,CgCxyGE,4DACE,oBhC2yGJ,CgCxyGI,sFACE,gChC0yGN,CgCryGE,oEACE,0BhCwyGJ,CgCryGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChCuyGN,CgCnyGI,gFACE,ahCqyGN,CgC1zGE,4DACE,oBhC6zGJ,CgC1zGI,sFACE,gChC4zGN,CgCvzGE,oEACE,0BhC0zGJ,CgCvzGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChCyzGN,CgCrzGI,gFACE,ahCuzGN,CgC50GE,0DACE,oBhC+0GJ,CgC50GI,oFACE,gChC80GN,CgCz0GE,kEACE,0BhC40GJ,CgCz0GI,gFACE,wBAlBG,CAmBH,oDAAA,CAAA,4ChC20GN,CgCv0GI,8EACE,ahCy0GN,CgC91GE,oDACE,oBhCi2GJ,CgC91GI,8EACE,gChCg2GN,CgC31GE,4DACE,0BhC81GJ,CgC31GI,0EACE,wBAlBG,CAmBH,iDAAA,CAAA,yChC61GN,CgCz1GI,wEACE,ahC21GN,CgCh3GE,4DACE,oBhCm3GJ,CgCh3GI,sFACE,gChCk3GN,CgC72GE,oEACE,0BhCg3GJ,CgC72GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChC+2GN,CgC32GI,gFACE,ahC62GN,CgCl4GE,wDACE,oBhCq4GJ,CgCl4GI,kFACE,gChCo4GN,CgC/3GE,gEACE,0BhCk4GJ,CgC/3GI,8EACE,wBAlBG,CAmBH,mDAAA,CAAA,2ChCi4GN,CgC73GI,4EACE,ahC+3GN,CiCniHA,MACE,wMjCsiHF,CiC7hHE,sBAEE,uCAAA,CADA,gBjCiiHJ,CiC7hHI,mCACE,ajC+hHN,CiChiHI,mCACE,cjC+hHN,CiC3hHM,4BACE,sBjC6hHR,CiC1hHQ,mCAC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","file":"main.css"}
\ No newline at end of file
diff --git a/0.10.0/assets/stylesheets/palette.06af60db.min.css b/0.10.0/assets/stylesheets/palette.06af60db.min.css
deleted file mode 100644
index a640d38ab..000000000
--- a/0.10.0/assets/stylesheets/palette.06af60db.min.css
+++ /dev/null
@@ -1 +0,0 @@
-@media screen{[data-md-color-scheme=slate]{--md-default-fg-color:hsla(var(--md-hue),15%,90%,0.82);--md-default-fg-color--light:hsla(var(--md-hue),15%,90%,0.56);--md-default-fg-color--lighter:hsla(var(--md-hue),15%,90%,0.32);--md-default-fg-color--lightest:hsla(var(--md-hue),15%,90%,0.12);--md-default-bg-color:hsla(var(--md-hue),15%,14%,1);--md-default-bg-color--light:hsla(var(--md-hue),15%,14%,0.54);--md-default-bg-color--lighter:hsla(var(--md-hue),15%,14%,0.26);--md-default-bg-color--lightest:hsla(var(--md-hue),15%,14%,0.07);--md-code-fg-color:hsla(var(--md-hue),18%,86%,0.82);--md-code-bg-color:hsla(var(--md-hue),15%,18%,1);--md-code-hl-color:#2977ff;--md-code-hl-color--light:#2977ff1a;--md-code-hl-number-color:#e6695b;--md-code-hl-special-color:#f06090;--md-code-hl-function-color:#c973d9;--md-code-hl-constant-color:#9383e2;--md-code-hl-keyword-color:#6791e0;--md-code-hl-string-color:#2fb170;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-kbd-color:hsla(var(--md-hue),15%,90%,0.12);--md-typeset-kbd-accent-color:hsla(var(--md-hue),15%,90%,0.2);--md-typeset-kbd-border-color:hsla(var(--md-hue),15%,14%,1);--md-typeset-mark-color:#4287ff4d;--md-typeset-table-color:hsla(var(--md-hue),15%,95%,0.12);--md-typeset-table-color--light:hsla(var(--md-hue),15%,95%,0.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-footer-bg-color:hsla(var(--md-hue),15%,10%,0.87);--md-footer-bg-color--dark:hsla(var(--md-hue),15%,8%,1);--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #00000040,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0006,0 0 0.05rem #00000059;color-scheme:dark}[data-md-color-scheme=slate] img[src$="#gh-light-mode-only"],[data-md-color-scheme=slate] img[src$="#only-light"]{display:none}[data-md-color-scheme=slate][data-md-color-primary=pink]{--md-typeset-a-color:#ed5487}[data-md-color-scheme=slate][data-md-color-primary=purple]{--md-typeset-a-color:#c46fd3}[data-md-color-scheme=slate][data-md-color-primary=deep-purple]{--md-typeset-a-color:#a47bea}[data-md-color-scheme=slate][data-md-color-primary=indigo]{--md-typeset-a-color:#5488e8}[data-md-color-scheme=slate][data-md-color-primary=teal]{--md-typeset-a-color:#00ccb8}[data-md-color-scheme=slate][data-md-color-primary=green]{--md-typeset-a-color:#71c174}[data-md-color-scheme=slate][data-md-color-primary=deep-orange]{--md-typeset-a-color:#ff764d}[data-md-color-scheme=slate][data-md-color-primary=brown]{--md-typeset-a-color:#c1775c}[data-md-color-scheme=slate][data-md-color-primary=black],[data-md-color-scheme=slate][data-md-color-primary=blue-grey],[data-md-color-scheme=slate][data-md-color-primary=grey],[data-md-color-scheme=slate][data-md-color-primary=white]{--md-typeset-a-color:#5e8bde}[data-md-color-switching] *,[data-md-color-switching] :after,[data-md-color-switching] :before{transition-duration:0ms!important}}[data-md-color-accent=red]{--md-accent-fg-color:#ff1947;--md-accent-fg-color--transparent:#ff19471a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=pink]{--md-accent-fg-color:#f50056;--md-accent-fg-color--transparent:#f500561a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=purple]{--md-accent-fg-color:#df41fb;--md-accent-fg-color--transparent:#df41fb1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=deep-purple]{--md-accent-fg-color:#7c4dff;--md-accent-fg-color--transparent:#7c4dff1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=indigo]{--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=blue]{--md-accent-fg-color:#4287ff;--md-accent-fg-color--transparent:#4287ff1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=light-blue]{--md-accent-fg-color:#0091eb;--md-accent-fg-color--transparent:#0091eb1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=cyan]{--md-accent-fg-color:#00bad6;--md-accent-fg-color--transparent:#00bad61a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=teal]{--md-accent-fg-color:#00bda4;--md-accent-fg-color--transparent:#00bda41a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=green]{--md-accent-fg-color:#00c753;--md-accent-fg-color--transparent:#00c7531a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=light-green]{--md-accent-fg-color:#63de17;--md-accent-fg-color--transparent:#63de171a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=lime]{--md-accent-fg-color:#b0eb00;--md-accent-fg-color--transparent:#b0eb001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=yellow]{--md-accent-fg-color:#ffd500;--md-accent-fg-color--transparent:#ffd5001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=amber]{--md-accent-fg-color:#fa0;--md-accent-fg-color--transparent:#ffaa001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=orange]{--md-accent-fg-color:#ff9100;--md-accent-fg-color--transparent:#ff91001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=deep-orange]{--md-accent-fg-color:#ff6e42;--md-accent-fg-color--transparent:#ff6e421a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-primary=red]{--md-primary-fg-color:#ef5552;--md-primary-fg-color--light:#e57171;--md-primary-fg-color--dark:#e53734;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=pink]{--md-primary-fg-color:#e92063;--md-primary-fg-color--light:#ec417a;--md-primary-fg-color--dark:#c3185d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=purple]{--md-primary-fg-color:#ab47bd;--md-primary-fg-color--light:#bb69c9;--md-primary-fg-color--dark:#8c24a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=deep-purple]{--md-primary-fg-color:#7e56c2;--md-primary-fg-color--light:#9574cd;--md-primary-fg-color--dark:#673ab6;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=indigo]{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=blue]{--md-primary-fg-color:#2094f3;--md-primary-fg-color--light:#42a5f5;--md-primary-fg-color--dark:#1975d2;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=light-blue]{--md-primary-fg-color:#02a6f2;--md-primary-fg-color--light:#28b5f6;--md-primary-fg-color--dark:#0287cf;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=cyan]{--md-primary-fg-color:#00bdd6;--md-primary-fg-color--light:#25c5da;--md-primary-fg-color--dark:#0097a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=teal]{--md-primary-fg-color:#009485;--md-primary-fg-color--light:#26a699;--md-primary-fg-color--dark:#007a6c;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=green]{--md-primary-fg-color:#4cae4f;--md-primary-fg-color--light:#68bb6c;--md-primary-fg-color--dark:#398e3d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=light-green]{--md-primary-fg-color:#8bc34b;--md-primary-fg-color--light:#9ccc66;--md-primary-fg-color--dark:#689f38;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=lime]{--md-primary-fg-color:#cbdc38;--md-primary-fg-color--light:#d3e156;--md-primary-fg-color--dark:#b0b52c;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=yellow]{--md-primary-fg-color:#ffec3d;--md-primary-fg-color--light:#ffee57;--md-primary-fg-color--dark:#fbc02d;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=amber]{--md-primary-fg-color:#ffc105;--md-primary-fg-color--light:#ffc929;--md-primary-fg-color--dark:#ffa200;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=orange]{--md-primary-fg-color:#ffa724;--md-primary-fg-color--light:#ffa724;--md-primary-fg-color--dark:#fa8900;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=deep-orange]{--md-primary-fg-color:#ff6e42;--md-primary-fg-color--light:#ff8a66;--md-primary-fg-color--dark:#f4511f;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=brown]{--md-primary-fg-color:#795649;--md-primary-fg-color--light:#8d6e62;--md-primary-fg-color--dark:#5d4037;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=grey]{--md-primary-fg-color:#757575;--md-primary-fg-color--light:#9e9e9e;--md-primary-fg-color--dark:#616161;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-typeset-a-color:#4051b5}[data-md-color-primary=blue-grey]{--md-primary-fg-color:#546d78;--md-primary-fg-color--light:#607c8a;--md-primary-fg-color--dark:#455a63;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-typeset-a-color:#4051b5}[data-md-color-primary=light-green]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#72ad2e}[data-md-color-primary=lime]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#8b990a}[data-md-color-primary=yellow]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#b8a500}[data-md-color-primary=amber]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#d19d00}[data-md-color-primary=orange]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#e68a00}[data-md-color-primary=white]{--md-primary-fg-color:hsla(var(--md-hue),0%,100%,1);--md-primary-fg-color--light:hsla(var(--md-hue),0%,100%,0.7);--md-primary-fg-color--dark:hsla(var(--md-hue),0%,0%,0.07);--md-primary-bg-color:hsla(var(--md-hue),0%,0%,0.87);--md-primary-bg-color--light:hsla(var(--md-hue),0%,0%,0.54);--md-typeset-a-color:#4051b5}[data-md-color-primary=white] .md-button{color:var(--md-typeset-a-color)}[data-md-color-primary=white] .md-button--primary{background-color:var(--md-typeset-a-color);border-color:var(--md-typeset-a-color);color:hsla(var(--md-hue),0%,100%,1)}@media screen and (min-width:60em){[data-md-color-primary=white] .md-search__form{background-color:hsla(var(--md-hue),0%,0%,.07)}[data-md-color-primary=white] .md-search__form:hover{background-color:hsla(var(--md-hue),0%,0%,.32)}[data-md-color-primary=white] .md-search__input+.md-search__icon{color:hsla(var(--md-hue),0%,0%,.87)}}@media screen and (min-width:76.25em){[data-md-color-primary=white] .md-tabs{border-bottom:.05rem solid #00000012}}[data-md-color-primary=black]{--md-primary-fg-color:hsla(var(--md-hue),15%,9%,1);--md-primary-fg-color--light:hsla(var(--md-hue),15%,9%,0.54);--md-primary-fg-color--dark:hsla(var(--md-hue),15%,9%,1);--md-primary-bg-color:hsla(var(--md-hue),15%,100%,1);--md-primary-bg-color--light:hsla(var(--md-hue),15%,100%,0.7);--md-typeset-a-color:#4051b5}[data-md-color-primary=black] .md-button{color:var(--md-typeset-a-color)}[data-md-color-primary=black] .md-button--primary{background-color:var(--md-typeset-a-color);border-color:var(--md-typeset-a-color);color:hsla(var(--md-hue),0%,100%,1)}[data-md-color-primary=black] .md-header{background-color:hsla(var(--md-hue),15%,9%,1)}@media screen and (max-width:59.984375em){[data-md-color-primary=black] .md-nav__source{background-color:hsla(var(--md-hue),15%,11%,.87)}}@media screen and (max-width:76.234375em){html [data-md-color-primary=black] .md-nav--primary .md-nav__title[for=__drawer]{background-color:hsla(var(--md-hue),15%,9%,1)}}@media screen and (min-width:76.25em){[data-md-color-primary=black] .md-tabs{background-color:hsla(var(--md-hue),15%,9%,1)}}
\ No newline at end of file
diff --git a/0.10.0/assets/stylesheets/palette.06af60db.min.css.map b/0.10.0/assets/stylesheets/palette.06af60db.min.css.map
deleted file mode 100644
index efb568c52..000000000
--- a/0.10.0/assets/stylesheets/palette.06af60db.min.css.map
+++ /dev/null
@@ -1 +0,0 @@
-{"version":3,"sources":["src/templates/assets/stylesheets/palette/_scheme.scss","../../../../src/templates/assets/stylesheets/palette.scss","src/templates/assets/stylesheets/palette/_accent.scss","src/templates/assets/stylesheets/palette/_primary.scss","src/templates/assets/stylesheets/utilities/_break.scss"],"names":[],"mappings":"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","file":"palette.css"}
\ No newline at end of file
diff --git a/0.10.0/authorino-operator/index.html b/0.10.0/authorino-operator/index.html
deleted file mode 100644
index ca7ff3947..000000000
--- a/0.10.0/authorino-operator/index.html
+++ /dev/null
@@ -1,4439 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino-operator/">
-      
-      
-        <link rel="prev" href="../authorino/">
-      
-      
-        <link rel="next" href="../authorino/docs/getting-started/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Authorino Operator - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#authorino-operator" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Authorino Operator
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#installation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Installation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#applying-the-manifests-to-the-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Applying the manifests to the cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#installing-via-olm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing via OLM
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino-operator-using-operator-sdk" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy authorino operator using operator-sdk
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#requesting-an-authorino-instance" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requesting an Authorino instance
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#the-authorino-custom-resource-definition-crd" class="md-nav__link">
-    <span class="md-ellipsis">
-      The Authorino Custom Resource Definition (CRD)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The Authorino Custom Resource Definition (CRD)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      API Specification
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="API Specification">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#authorinospec" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthorinoSpec
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#listener" class="md-nav__link">
-    <span class="md-ellipsis">
-      Listener
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#oidcserver" class="md-nav__link">
-    <span class="md-ellipsis">
-      OIDCServer
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tls" class="md-nav__link">
-    <span class="md-ellipsis">
-      TLS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#ports" class="md-nav__link">
-    <span class="md-ellipsis">
-      Ports
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tracing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Tracing
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Metrics
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#healthz" class="md-nav__link">
-    <span class="md-ellipsis">
-      Healthz
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#volumesspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      VolumesSpec
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#volumespec" class="md-nav__link">
-    <span class="md-ellipsis">
-      VolumeSpec
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#full-example" class="md-nav__link">
-    <span class="md-ellipsis">
-      Full example
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#removal" class="md-nav__link">
-    <span class="md-ellipsis">
-      Removal
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Removal">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#removing-the-operator-installed-via-manifests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Removing the operator installed via manifests
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Removing the operator installed via manifests">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#remove-dependencies-optional" class="md-nav__link">
-    <span class="md-ellipsis">
-      Remove dependencies (Optional)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#license" class="md-nav__link">
-    <span class="md-ellipsis">
-      License
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#installation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Installation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#applying-the-manifests-to-the-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Applying the manifests to the cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#installing-via-olm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing via OLM
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino-operator-using-operator-sdk" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy authorino operator using operator-sdk
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#requesting-an-authorino-instance" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requesting an Authorino instance
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#the-authorino-custom-resource-definition-crd" class="md-nav__link">
-    <span class="md-ellipsis">
-      The Authorino Custom Resource Definition (CRD)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The Authorino Custom Resource Definition (CRD)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      API Specification
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="API Specification">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#authorinospec" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthorinoSpec
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#listener" class="md-nav__link">
-    <span class="md-ellipsis">
-      Listener
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#oidcserver" class="md-nav__link">
-    <span class="md-ellipsis">
-      OIDCServer
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tls" class="md-nav__link">
-    <span class="md-ellipsis">
-      TLS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#ports" class="md-nav__link">
-    <span class="md-ellipsis">
-      Ports
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tracing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Tracing
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Metrics
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#healthz" class="md-nav__link">
-    <span class="md-ellipsis">
-      Healthz
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#volumesspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      VolumesSpec
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#volumespec" class="md-nav__link">
-    <span class="md-ellipsis">
-      VolumeSpec
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#full-example" class="md-nav__link">
-    <span class="md-ellipsis">
-      Full example
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#removal" class="md-nav__link">
-    <span class="md-ellipsis">
-      Removal
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Removal">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#removing-the-operator-installed-via-manifests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Removing the operator installed via manifests
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Removing the operator installed via manifests">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#remove-dependencies-optional" class="md-nav__link">
-    <span class="md-ellipsis">
-      Remove dependencies (Optional)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#license" class="md-nav__link">
-    <span class="md-ellipsis">
-      License
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino-operator/blob/main/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="authorino-operator">Authorino Operator<a class="headerlink" href="#authorino-operator" title="Permanent link">&para;</a></h1>
-<p>A Kubernetes Operator to manage <a href="https://github.com/Kuadrant/authorino">Authorino</a> instances.</p>
-<p><a href="http://www.apache.org/licenses/LICENSE-2.0"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" /></a>
-<a href="https://codecov.io/gh/Kuadrant/authorino-operator"><img alt="codecov" src="https://codecov.io/gh/Kuadrant/authorino-operator/branch/main/graph/badge.svg?token=3O9IUKS642" /></a>
-<a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Fauthorino-operator?ref=badge_shield"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Fauthorino-operator.svg?type=shield" /></a></p>
-<h2 id="installation">Installation<a class="headerlink" href="#installation" title="Permanent link">&para;</a></h2>
-<p>The Operator can be installed by applying the manifests to the Kubernetes cluster or using <a href="https://olm.operatorframework.io/">Operator Lifecycle Manager (OLM)</a></p>
-<h3 id="applying-the-manifests-to-the-cluster">Applying the manifests to the cluster<a class="headerlink" href="#applying-the-manifests-to-the-cluster" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Install the Operator manifests</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>make<span class="w"> </span>install
-</span></code></pre></div>
-<ol>
-<li>Deploy the Operator</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>deploy
-</span></code></pre></div>
-<details>
-  <summary><i>Tip:</i> Deploy a custom image of the Operator</summary>
-  <br/>
-  To deploy an image of the Operator other than the default <code>quay.io/kuadrant/authorino-operator:latest</code>, specify by setting the <code>OPERATOR_IMAGE</code> parameter. E.g.:
-
-  <div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>make<span class="w"> </span>deploy<span class="w"> </span><span class="nv">OPERATOR_IMAGE</span><span class="o">=</span>authorino-operator:local
-</span></code></pre></div>
-</details>
-
-<h3 id="installing-via-olm">Installing via OLM<a class="headerlink" href="#installing-via-olm" title="Permanent link">&para;</a></h3>
-<p>To install the Operator using the <a href="https://olm.operatorframework.io/">Operator Lifecycle Manager</a>, you need to make the
-Operator CSVs available in the cluster by creating a <code>CatalogSource</code> resource.</p>
-<p>The bundle and catalog images of the Operator are available in Quay.io:</p>
-<table>
-  <tbody>
-    <tr>
-      <th>Bundle</th>
-      <td><a href="https://quay.io/kuadrant/authorino-operator-bundle">quay.io/kuadrant/authorino-operator-bundle</a></td>
-    </tr>
-    <tr>
-      <th>Catalog</th>
-      <td><a href="https://quay.io/kuadrant/authorino-operator-catalog">quay.io/kuadrant/authorino-operator-catalog</a></td>
-    </tr>
-  </tbody>
-</table>
-
-<ol>
-<li>Create the namespace for the Operator</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>authorino-operator
-</span></code></pre></div>
-<ol>
-<li>Create the <a href="https://olm.operatorframework.io/docs/concepts/crds/catalogsource">CatalogSource</a> resource pointing to
-   one of the images from in the Operator's catalog repo:</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino-operator<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: operators.coreos.com/v1alpha1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: CatalogSource</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: operatorhubio-catalog</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">  namespace: authorino-operator</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">spec:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">  sourceType: grpc</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">  image: quay.io/kuadrant/authorino-operator-catalog:latest</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">  displayName: Authorino Operator</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-authorino-operator-using-operator-sdk">Deploy authorino operator using operator-sdk<a class="headerlink" href="#deploy-authorino-operator-using-operator-sdk" title="Permanent link">&para;</a></h2>
-<ol>
-<li>Install operator-sdk bin
-   <div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>make<span class="w"> </span>operator-sdk
-</span></code></pre></div></li>
-<li>Run operator-sdk bundle command 
-   <div class="language-text highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>./bin/operator-sdk run bundle quay.io/kuadrant/authorino-operator-bundle:latest
-</span></code></pre></div>
-Note: For s390x &amp; ppc64le , use operator-sdk to install authorino-operator </li>
-</ol>
-<h2 id="requesting-an-authorino-instance">Requesting an Authorino instance<a class="headerlink" href="#requesting-an-authorino-instance" title="Permanent link">&para;</a></h2>
-<p>Once the Operator is up and running, you can request instances of Authorino by creating <code>Authorino</code> CRs. E.g.:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>default<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  listener:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    tls:</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">    tls:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="the-authorino-custom-resource-definition-crd">The <code>Authorino</code> Custom Resource Definition (CRD)<a class="headerlink" href="#the-authorino-custom-resource-definition-crd" title="Permanent link">&para;</a></h2>
-<p>API to install, manage and configure Authorino authorization services .</p>
-<p>Each <a href="https://github.com/Kuadrant/authorino-operator/tree/main/config/crd/bases/operator.authorino.kuadrant.io_authorinos.yaml"><code>Authorino</code></a>
-Custom Resource (CR) represents an instance of Authorino deployed to the cluster. The Authorino Operator will reconcile
-the state of the Kubernetes Deployment and associated resources, based on the state of the CR.</p>
-<h3 id="api-specification">API Specification<a class="headerlink" href="#api-specification" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>spec</td>
-<td style="text-align: center;"><a href="#authorinospec">AuthorinoSpec</a></td>
-<td>Specification of the Authorino deployment.</td>
-<td>Required</td>
-</tr>
-</tbody>
-</table>
-<h4 id="authorinospec">AuthorinoSpec<a class="headerlink" href="#authorinospec" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>clusterWide</td>
-<td style="text-align: center;">Boolean</td>
-<td>Sets the Authorino instance's <a href="https://docs.kuadrant.io/authorino/docs/architecture/#cluster-wide-vs-namespaced-instances">watching scope</a> – cluster-wide or namespaced.</td>
-<td>Default: <code>true</code> (cluster-wide)</td>
-</tr>
-<tr>
-<td>authConfigLabelSelectors</td>
-<td style="text-align: center;">String</td>
-<td><a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors">Label selectors</a> used by the Authorino instance to filter <code>AuthConfig</code>-related reconciliation events.</td>
-<td>Default: empty (all AuthConfigs are watched)</td>
-</tr>
-<tr>
-<td>secretLabelSelectors</td>
-<td style="text-align: center;">String</td>
-<td><a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors">Label selectors</a> used by the Authorino instance to filter <code>Secret</code>-related reconciliation events (API key and mTLS authentication methods).</td>
-<td>Default: <code>authorino.kuadrant.io/managed-by=authorino</code></td>
-</tr>
-<tr>
-<td>supersedingHostSubsets</td>
-<td style="text-align: center;">Boolean</td>
-<td>Enable/disable allowing AuthConfigs to supersede strict subsets of hosts already taken.</td>
-<td>Default: <code>false</code></td>
-</tr>
-<tr>
-<td>replicas</td>
-<td style="text-align: center;">Integer</td>
-<td>Number of replicas desired for the Authorino instance. Values greater than 1 enable leader election in the Authorino service, where the leader updates the statuses of the <code>AuthConfig</code> CRs).</td>
-<td>Default: 1</td>
-</tr>
-<tr>
-<td>evaluatorCacheSize</td>
-<td style="text-align: center;">Integer</td>
-<td>Cache size (in megabytes) of each Authorino evaluator (when enabled in an <a href="https://docs.kuadrant.io/authorino/docs/features/#common-feature-caching-cache"><code>AuthConfig</code></a>).</td>
-<td>Default: 1</td>
-</tr>
-<tr>
-<td>image</td>
-<td style="text-align: center;">String</td>
-<td>Authorino image to be deployed (for dev/testing purpose only).</td>
-<td>Default: <code>quay.io/kuadrant/authorino:latest</code></td>
-</tr>
-<tr>
-<td>imagePullPolicy</td>
-<td style="text-align: center;">String</td>
-<td>Sets the <a href="https://kubernetes.io/docs/concepts/containers/images">imagePullPolicy</a> of the Authorino Deployment (for dev/testing purpose only).</td>
-<td>Default: k8s default</td>
-</tr>
-<tr>
-<td>logLevel</td>
-<td style="text-align: center;">String</td>
-<td>Defines the level of log you want to enable in Authorino (<code>debug</code>, <code>info</code> and <code>error</code>).</td>
-<td>Default: <code>info</code></td>
-</tr>
-<tr>
-<td>logMode</td>
-<td style="text-align: center;">String</td>
-<td>Defines the log mode in Authorino (<code>development</code> or <code>production</code>).</td>
-<td>Default: <code>production</code></td>
-</tr>
-<tr>
-<td>listener</td>
-<td style="text-align: center;"><a href="#listener">Listener</a></td>
-<td>Specification of the authorization service (gRPC interface).</td>
-<td>Required</td>
-</tr>
-<tr>
-<td>oidcServer</td>
-<td style="text-align: center;"><a href="#oidcserver">OIDCServer</a></td>
-<td>Specification of the OIDC service.</td>
-<td>Required</td>
-</tr>
-<tr>
-<td>tracing</td>
-<td style="text-align: center;"><a href="#tracing">Tracing</a></td>
-<td>Configuration of the OpenTelemetry tracing exporter.</td>
-<td>Optional</td>
-</tr>
-<tr>
-<td>metrics</td>
-<td style="text-align: center;"><a href="#metrics">Metrics</a></td>
-<td>Configuration of the metrics server (port, level).</td>
-<td>Optional</td>
-</tr>
-<tr>
-<td>healthz</td>
-<td style="text-align: center;"><a href="#healthz">Healthz</a></td>
-<td>Configuration of the health/readiness probe (port).</td>
-<td>Optional</td>
-</tr>
-<tr>
-<td>volumes</td>
-<td style="text-align: center;"><a href="#volumesspec">VolumesSpec</a></td>
-<td>Additional volumes to be mounted in the Authorino pods.</td>
-<td>Optional</td>
-</tr>
-</tbody>
-</table>
-<h4 id="listener">Listener<a class="headerlink" href="#listener" title="Permanent link">&para;</a></h4>
-<p>Configuration of the authorization server – <a href="https://docs.kuadrant.io/authorino/docs/architecture/#overview">gRPC</a>
-and <a href="https://docs.kuadrant.io/authorino/docs/architecture/#raw-http-authorization-interface">raw HTTP</a>
-interfaces</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>port</td>
-<td style="text-align: center;">Integer</td>
-<td>Port number of authorization server (gRPC interface).</td>
-<td><em><strong>DEPRECATED</strong></em><br/>Use <code>ports</code> instead</td>
-</tr>
-<tr>
-<td>ports</td>
-<td style="text-align: center;"><a href="#ports">Ports</a></td>
-<td>Port numbers of the authorization server (gRPC and raw HTTPinterfaces).</td>
-<td>Optional</td>
-</tr>
-<tr>
-<td>tls</td>
-<td style="text-align: center;"><a href="#tls">TLS</a></td>
-<td>TLS configuration of the authorization server (GRPC and HTTP interfaces).</td>
-<td>Required</td>
-</tr>
-<tr>
-<td>timeout</td>
-<td style="text-align: center;">Integer</td>
-<td>Timeout of external authorization request (in milliseconds), controlled internally by the authorization server.</td>
-<td>Default: <code>0</code> (disabled)</td>
-</tr>
-</tbody>
-</table>
-<h4 id="oidcserver">OIDCServer<a class="headerlink" href="#oidcserver" title="Permanent link">&para;</a></h4>
-<p>Configuration of the OIDC Discovery server for <a href="https://docs.kuadrant.io/authorino/docs/features/#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristband</a>
-tokens.</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>port</td>
-<td style="text-align: center;">Integer</td>
-<td>Port number of OIDC Discovery server for Festival Wristband tokens.</td>
-<td>Default: <code>8083</code></td>
-</tr>
-<tr>
-<td>tls</td>
-<td style="text-align: center;"><a href="#tls">TLS</a></td>
-<td>TLS configuration of the OIDC Discovery server for Festival Wristband tokens</td>
-<td>Required</td>
-</tr>
-</tbody>
-</table>
-<h4 id="tls">TLS<a class="headerlink" href="#tls" title="Permanent link">&para;</a></h4>
-<p>TLS configuration of server. Appears in <a href="#listener"><code>listener</code></a> and <a href="#oidcserver"><code>oidcServer</code></a>.</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>enabled</td>
-<td style="text-align: center;">Boolean</td>
-<td>Whether TLS is enabled or disabled for the server.</td>
-<td>Default: <code>true</code></td>
-</tr>
-<tr>
-<td>certSecretRef</td>
-<td style="text-align: center;"><a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#localobjectreference-v1-core">LocalObjectReference</a></td>
-<td>The reference to the secret that contains the TLS certificates <code>tls.crt</code> and <code>tls.key</code>.</td>
-<td>Required when <code>enabled: true</code></td>
-</tr>
-</tbody>
-</table>
-<h4 id="ports">Ports<a class="headerlink" href="#ports" title="Permanent link">&para;</a></h4>
-<p>Port numbers of the authorization server.</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>grpc</td>
-<td style="text-align: center;">Integer</td>
-<td>Port number of the gRPC interface of the authorization server. Set to 0 to disable this interface.</td>
-<td>Default: <code>50001</code></td>
-</tr>
-<tr>
-<td>http</td>
-<td style="text-align: center;">Integer</td>
-<td>Port number of the raw HTTP interface of the authorization server. Set to 0 to disable this interface.</td>
-<td>Default: <code>5001</code></td>
-</tr>
-</tbody>
-</table>
-<h4 id="tracing">Tracing<a class="headerlink" href="#tracing" title="Permanent link">&para;</a></h4>
-<p>Configuration of the OpenTelemetry tracing exporter.</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>endpoint</td>
-<td style="text-align: center;">String</td>
-<td>Full endpoint of the OpenTelemetry tracing collector service (e.g. http://jaeger:14268/api/traces).</td>
-<td>Required</td>
-</tr>
-<tr>
-<td>tags</td>
-<td style="text-align: center;">Map</td>
-<td>Key-value map of fixed tags to add to all OpenTelemetry traces emitted by Authorino.</td>
-<td>Optional</td>
-</tr>
-<tr>
-<td>insecure</td>
-<td style="text-align: center;">Boolean</td>
-<td>Enable/disable insecure connection to the tracing endpoint</td>
-<td>Default: <code>false</code></td>
-</tr>
-</tbody>
-</table>
-<h4 id="metrics">Metrics<a class="headerlink" href="#metrics" title="Permanent link">&para;</a></h4>
-<p>Configuration of the metrics server.</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>port</td>
-<td style="text-align: center;">Integer</td>
-<td>Port number of the metrics server.</td>
-<td>Default: <code>8080</code></td>
-</tr>
-<tr>
-<td>deep</td>
-<td style="text-align: center;">Boolean</td>
-<td>Enable/disable metrics at the level of each evaluator config (if requested in the <a href="https://docs.kuadrant.io/authorino/docs/features/#common-feature-metrics-metrics"><code>AuthConfig</code></a>) exported by the metrics server.</td>
-<td>Default: <code>false</code></td>
-</tr>
-</tbody>
-</table>
-<h4 id="healthz">Healthz<a class="headerlink" href="#healthz" title="Permanent link">&para;</a></h4>
-<p>Configuration of the health/readiness probe (port).</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>port</td>
-<td style="text-align: center;">Integer</td>
-<td>Port number of the health/readiness probe.</td>
-<td>Default: <code>8081</code></td>
-</tr>
-</tbody>
-</table>
-<h4 id="volumesspec">VolumesSpec<a class="headerlink" href="#volumesspec" title="Permanent link">&para;</a></h4>
-<p>Additional volumes to project in the Authorino pods. Useful for validation of TLS self-signed certificates of external
-services known to have to be contacted by Authorino at runtime.</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>items</td>
-<td style="text-align: center;"><a href="#volumespec">[]VolumeSpec</a></td>
-<td>List of additional volume items to project.</td>
-<td>Optional</td>
-</tr>
-<tr>
-<td>defaultMode</td>
-<td style="text-align: center;">Integer</td>
-<td>Mode bits used to set permissions on the files. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511.</td>
-<td>Optional</td>
-</tr>
-</tbody>
-</table>
-<h4 id="volumespec">VolumeSpec<a class="headerlink" href="#volumespec" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th style="text-align: center;">Type</th>
-<th>Description</th>
-<th>Required/Default</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>name</td>
-<td style="text-align: center;">String</td>
-<td>Name of the volume and volume mount within the Deployment. It must be unique in the CR.</td>
-<td>Optional</td>
-</tr>
-<tr>
-<td>mountPath</td>
-<td style="text-align: center;">String</td>
-<td>Absolute path where to mount all the items.</td>
-<td>Required</td>
-</tr>
-<tr>
-<td>configMaps</td>
-<td style="text-align: center;">[]String</td>
-<td>List of of Kubernetes ConfigMap names to mount.</td>
-<td>Required exactly one of: <code>confiMaps</code>, <code>secrets</code>.</td>
-</tr>
-<tr>
-<td>secrets</td>
-<td style="text-align: center;">[]String</td>
-<td>List of of Kubernetes Secret names to mount.</td>
-<td>Required exactly one of: <code>confiMaps</code>, <code>secrets</code>.</td>
-</tr>
-<tr>
-<td>items</td>
-<td style="text-align: center;"><a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#keytopath-v1-core">[]KeyToPath</a></td>
-<td>Mount details for selecting specific ConfigMap or Secret entries.</td>
-<td>Optional</td>
-</tr>
-</tbody>
-</table>
-<h3 id="full-example">Full example<a class="headerlink" href="#full-example" title="Permanent link">&para;</a></h3>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Authorino</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w">  </span><span class="nt">clusterWide</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w">  </span><span class="nt">authConfigLabelSelectors</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">environment=production</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">  </span><span class="nt">secretLabelSelectors</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/component=authorino,environment=production</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">  </span><span class="nt">replicas</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w">  </span><span class="nt">evaluatorCacheSize</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span><span class="w"> </span><span class="c1"># mb</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="w">  </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">quay.io/kuadrant/authorino:latest</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="w">  </span><span class="nt">imagePullPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Always</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="w">  </span><span class="nt">logLevel</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">debug</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="w">  </span><span class="nt">logMode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">production</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="w">  </span><span class="nt">listener</span><span class="p">:</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="w">    </span><span class="nt">ports</span><span class="p">:</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="w">      </span><span class="nt">grpc</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50001</span>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5001</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="w">    </span><span class="nt">tls</span><span class="p">:</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="w">      </span><span class="nt">enabled</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-8-26"><a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="w">      </span><span class="nt">certSecretRef</span><span class="p">:</span>
-</span><span id="__span-8-27"><a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino-server-cert</span><span class="w"> </span><span class="c1"># secret must contain `tls.crt` and `tls.key` entries</span>
-</span><span id="__span-8-28"><a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a>
-</span><span id="__span-8-29"><a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a><span class="w">  </span><span class="nt">oidcServer</span><span class="p">:</span>
-</span><span id="__span-8-30"><a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="w">    </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8083</span>
-</span><span id="__span-8-31"><a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="w">    </span><span class="nt">tls</span><span class="p">:</span>
-</span><span id="__span-8-32"><a id="__codelineno-8-32" name="__codelineno-8-32" href="#__codelineno-8-32"></a><span class="w">      </span><span class="nt">enabled</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-8-33"><a id="__codelineno-8-33" name="__codelineno-8-33" href="#__codelineno-8-33"></a><span class="w">      </span><span class="nt">certSecretRef</span><span class="p">:</span>
-</span><span id="__span-8-34"><a id="__codelineno-8-34" name="__codelineno-8-34" href="#__codelineno-8-34"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino-oidc-server-cert</span><span class="w"> </span><span class="c1"># secret must contain `tls.crt` and `tls.key` entries</span>
-</span><span id="__span-8-35"><a id="__codelineno-8-35" name="__codelineno-8-35" href="#__codelineno-8-35"></a>
-</span><span id="__span-8-36"><a id="__codelineno-8-36" name="__codelineno-8-36" href="#__codelineno-8-36"></a><span class="w">  </span><span class="nt">metrics</span><span class="p">:</span>
-</span><span id="__span-8-37"><a id="__codelineno-8-37" name="__codelineno-8-37" href="#__codelineno-8-37"></a><span class="w">    </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-8-38"><a id="__codelineno-8-38" name="__codelineno-8-38" href="#__codelineno-8-38"></a><span class="w">    </span><span class="nt">deep</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-8-39"><a id="__codelineno-8-39" name="__codelineno-8-39" href="#__codelineno-8-39"></a>
-</span><span id="__span-8-40"><a id="__codelineno-8-40" name="__codelineno-8-40" href="#__codelineno-8-40"></a><span class="w">  </span><span class="nt">volumes</span><span class="p">:</span>
-</span><span id="__span-8-41"><a id="__codelineno-8-41" name="__codelineno-8-41" href="#__codelineno-8-41"></a><span class="w">    </span><span class="nt">items</span><span class="p">:</span>
-</span><span id="__span-8-42"><a id="__codelineno-8-42" name="__codelineno-8-42" href="#__codelineno-8-42"></a>
-</span><span id="__span-8-43"><a id="__codelineno-8-43" name="__codelineno-8-43" href="#__codelineno-8-43"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">keycloak-tls-cert</span>
-</span><span id="__span-8-44"><a id="__codelineno-8-44" name="__codelineno-8-44" href="#__codelineno-8-44"></a><span class="w">        </span><span class="nt">mountPath</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/etc/ssl/certs</span>
-</span><span id="__span-8-45"><a id="__codelineno-8-45" name="__codelineno-8-45" href="#__codelineno-8-45"></a><span class="w">        </span><span class="nt">configMaps</span><span class="p">:</span>
-</span><span id="__span-8-46"><a id="__codelineno-8-46" name="__codelineno-8-46" href="#__codelineno-8-46"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">keycloak-tls-cert</span>
-</span><span id="__span-8-47"><a id="__codelineno-8-47" name="__codelineno-8-47" href="#__codelineno-8-47"></a><span class="w">        </span><span class="nt">items</span><span class="p">:</span><span class="w"> </span><span class="c1"># details to mount the k8s configmap in the authorino pods</span>
-</span><span id="__span-8-48"><a id="__codelineno-8-48" name="__codelineno-8-48" href="#__codelineno-8-48"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">keycloak.crt</span>
-</span><span id="__span-8-49"><a id="__codelineno-8-49" name="__codelineno-8-49" href="#__codelineno-8-49"></a><span class="w">            </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">keycloak.crt</span>
-</span><span id="__span-8-50"><a id="__codelineno-8-50" name="__codelineno-8-50" href="#__codelineno-8-50"></a><span class="w">    </span><span class="nt">defaultMode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">420</span>
-</span></code></pre></div>
-<h2 id="removal">Removal<a class="headerlink" href="#removal" title="Permanent link">&para;</a></h2>
-<h3 id="removing-the-operator-installed-via-manifests">Removing the operator installed via manifests<a class="headerlink" href="#removing-the-operator-installed-via-manifests" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Undeploy the Operator</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>make<span class="w"> </span>undeploy
-</span></code></pre></div>
-<ol>
-<li>Remove the Operator manifests</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>make<span class="w"> </span>uninstall
-</span></code></pre></div>
-<h4 id="remove-dependencies-optional">Remove dependencies (Optional)<a class="headerlink" href="#remove-dependencies-optional" title="Permanent link">&para;</a></h4>
-<ol>
-<li>
-<p>Remove operator namespace
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>make<span class="w"> </span>delete-namespace
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Uninstall cert manager
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>make<span class="w"> </span>uninstall-cert-manager
-</span></code></pre></div></p>
-</li>
-</ol>
-<h2 id="license">License<a class="headerlink" href="#license" title="Permanent link">&para;</a></h2>
-<p><a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Fauthorino-operator?ref=badge_large"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Fauthorino-operator.svg?type=large" /></a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/architecture.gif b/0.10.0/authorino/docs/architecture.gif
deleted file mode 100644
index ee5f30fe3c278401da0ce1bb2330a043c6499f9c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 439345
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%0A7Eeh;>U-1LB=h>r+pqadcQJ2mzRkx;bD$C4ns
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

diff --git a/0.10.0/authorino/docs/architecture/index.html b/0.10.0/authorino/docs/architecture/index.html
deleted file mode 100644
index 1adca322d..000000000
--- a/0.10.0/authorino/docs/architecture/index.html
+++ /dev/null
@@ -1,4203 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/architecture/">
-      
-      
-        <link rel="prev" href="../user-guides/hello-world/">
-      
-      
-        <link rel="next" href="../features/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Architecture - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#architecture" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Architecture
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#topologies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Topologies
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Topologies">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#centralized-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Centralized gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#centralized-authorization-service" class="md-nav__link">
-    <span class="md-ellipsis">
-      Centralized authorization service
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#sidecars" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sidecars
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cluster-wide-vs-namespaced-instances" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cluster-wide vs. Namespaced instances
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#the-authorino-authconfig-custom-resource-definition-crd" class="md-nav__link">
-    <span class="md-ellipsis">
-      The Authorino AuthConfig Custom Resource Definition (CRD)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#resource-reconciliation-and-status-update" class="md-nav__link">
-    <span class="md-ellipsis">
-      Resource reconciliation and status update
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#the-auth-pipeline-aka-enforcing-protection-in-request-time" class="md-nav__link">
-    <span class="md-ellipsis">
-      The "Auth Pipeline" (aka: enforcing protection in request-time)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#host-lookup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Host lookup
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Host lookup">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#avoiding-host-name-collision" class="md-nav__link">
-    <span class="md-ellipsis">
-      Avoiding host name collision
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#the-authorization-json" class="md-nav__link">
-    <span class="md-ellipsis">
-      The Authorization JSON
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#raw-http-authorization-interface" class="md-nav__link">
-    <span class="md-ellipsis">
-      Raw HTTP Authorization interface
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#caching" class="md-nav__link">
-    <span class="md-ellipsis">
-      Caching
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Caching">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openid-connect-and-user-managed-access-configs" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenID Connect and User-Managed Access configs
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#json-web-keys-jwks-and-json-web-key-sets-jwks" class="md-nav__link">
-    <span class="md-ellipsis">
-      JSON Web Keys (JWKs) and JSON Web Key Sets (JWKS)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#revoked-access-tokens" class="md-nav__link">
-    <span class="md-ellipsis">
-      Revoked access tokens
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#external-metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      External metadata
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#compiled-rego-policies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Compiled Rego policies
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#repeated-requests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Repeated requests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#sharding" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sharding
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#rbac" class="md-nav__link">
-    <span class="md-ellipsis">
-      RBAC
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#observability" class="md-nav__link">
-    <span class="md-ellipsis">
-      Observability
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#topologies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Topologies
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Topologies">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#centralized-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Centralized gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#centralized-authorization-service" class="md-nav__link">
-    <span class="md-ellipsis">
-      Centralized authorization service
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#sidecars" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sidecars
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cluster-wide-vs-namespaced-instances" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cluster-wide vs. Namespaced instances
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#the-authorino-authconfig-custom-resource-definition-crd" class="md-nav__link">
-    <span class="md-ellipsis">
-      The Authorino AuthConfig Custom Resource Definition (CRD)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#resource-reconciliation-and-status-update" class="md-nav__link">
-    <span class="md-ellipsis">
-      Resource reconciliation and status update
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#the-auth-pipeline-aka-enforcing-protection-in-request-time" class="md-nav__link">
-    <span class="md-ellipsis">
-      The "Auth Pipeline" (aka: enforcing protection in request-time)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#host-lookup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Host lookup
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Host lookup">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#avoiding-host-name-collision" class="md-nav__link">
-    <span class="md-ellipsis">
-      Avoiding host name collision
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#the-authorization-json" class="md-nav__link">
-    <span class="md-ellipsis">
-      The Authorization JSON
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#raw-http-authorization-interface" class="md-nav__link">
-    <span class="md-ellipsis">
-      Raw HTTP Authorization interface
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#caching" class="md-nav__link">
-    <span class="md-ellipsis">
-      Caching
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Caching">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openid-connect-and-user-managed-access-configs" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenID Connect and User-Managed Access configs
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#json-web-keys-jwks-and-json-web-key-sets-jwks" class="md-nav__link">
-    <span class="md-ellipsis">
-      JSON Web Keys (JWKs) and JSON Web Key Sets (JWKS)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#revoked-access-tokens" class="md-nav__link">
-    <span class="md-ellipsis">
-      Revoked access tokens
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#external-metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      External metadata
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#compiled-rego-policies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Compiled Rego policies
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#repeated-requests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Repeated requests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#sharding" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sharding
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#rbac" class="md-nav__link">
-    <span class="md-ellipsis">
-      RBAC
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#observability" class="md-nav__link">
-    <span class="md-ellipsis">
-      Observability
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/architecture.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="architecture">Architecture<a class="headerlink" href="#architecture" title="Permanent link">&para;</a></h1>
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p><img alt="Architecture" src="../architecture.gif" /></p>
-<p>There are a few concepts to understand Authorino's architecture. The main components are: <strong>Authorino</strong>, <strong>Envoy</strong> and the <strong>Upstream</strong> service to be protected. Envoy proxies requests to the configured <strong>virtual host</strong> upstream service, first contacting with Authorino to decide on authN/authZ.</p>
-<p>The topology can vary from centralized proxy and centralized authorization service, to dedicated sidecars, with the nuances in between. Read more about the topologies in the <a href="#topologies">Topologies</a> section below.</p>
-<p>Authorino is deployed using the <a href="https://github.com/kuadrant/authorino-operator"><strong>Authorino Operator</strong></a>, from an <a href="https://github.com/Kuadrant/authorino-operator/blob/main/config/crd/bases/operator.authorino.kuadrant.io_authorinos.yaml"><strong><code>Authorino</code></strong></a> Kubernetes custom resource. Then, from another kind of custom resource, the <strong><a href="#the-authorino-authconfig-custom-resource-definition-crd"><code>AuthConfig</code></a></strong> CRs, each Authorino instance reads and adds to the <strong>index</strong> the exact rules of authN/authZ to enforce for each protected host ("index reconciliation").</p>
-<p>Everything that the AuthConfig <strong>reconciler</strong> can fetch in reconciliation-time is stored in the index. This is the case of static parameters such as signing keys, authentication secrets and authorization policies from external <strong>policy registries</strong>.</p>
-<p><code>AuthConfig</code>s can refer to identity providers (IdP) and trusted <strong>auth servers</strong> whose access tokens will be accepted to authenticate to the protected host. <strong>Consumers</strong> obtain an authentication token (short-lived access token or long-lived <strong>API key</strong>) and send those in the requests to the protected service.</p>
-<p>When Authorino is triggered by Envoy via the <strong>gRPC</strong> interface, it starts evaluating the <a href="#the-auth-pipeline-aka-enforcing-protection-in-request-time"><strong>Auth Pipeline</strong></a>, i.e. it applies to the request the parameters to verify the identity and to enforce authorization, as found in the index for the requested host (See <a href="#host-lookup">host lookup</a> for details).</p>
-<p>Apart from static rules, these parameters can include instructions to contact online with external identity verifiers, external sources of <strong>metadata</strong> and policy decision points (<strong>PDPs</strong>).</p>
-<p>On every request, Authorino's "working memory" is called <a href="#the-authorization-json"><strong>Authorization JSON</strong></a>, a data structure that holds information about the context (the HTTP request) and objects from each phase of the auth pipeline: i.e., authentication verification (phase i), ad-hoc metadata fetching (phase ii), authorization policy enforcement (phase iii), dynamic response (phase iv), and callbacks (phase v). The evaluators in each of these phases can both read and write from the Authorization JSON for dynamic steps and decisions of authN/authZ.</p>
-<h2 id="topologies">Topologies<a class="headerlink" href="#topologies" title="Permanent link">&para;</a></h2>
-<p>Typically, upstream APIs are deployed to the same Kubernetes cluster and namespace where the Envoy proxy and Authorino is running (although not necessarily). Whatever is the case, Envoy must be proxying to the upstream API (see Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/route/v3/route_components.proto">HTTP route components</a> and virtual hosts) and pointing to Authorino in the external authorization filter.</p>
-<p>This can be achieved with different topologies:</p>
-<ul>
-<li>Envoy can be a <a href="#centralized-gateway">centralized gateway</a> with one dedicated instance of Authorino, proxying to one or more upstream services</li>
-<li>Envoy can be deployed as a sidecar of each protected service, but still contacting from a <a href="#centralized-authorization-service">centralized Authorino authorization service</a></li>
-<li>Both Envoy and Authorino deployed as <a href="#sidecars">sidecars</a> of the protected service, restricting all communication between them to localhost</li>
-</ul>
-<p>Each topology above induces different measures for security.</p>
-<h3 id="centralized-gateway">Centralized gateway<a class="headerlink" href="#centralized-gateway" title="Permanent link">&para;</a></h3>
-<p><img alt="Centralized gateway topology" src="http://www.plantuml.com/plantuml/png/XOynJiKm343tdCBw0rk75aQ4_XyOsBY2rPWc-eaTEGa88Gu26pkduYJyfYf2KCJav5alJzddWbfg32OVFITKZ125PNGgaQ1e9MCIZaUS299Om3oF7fuCWD9OaAT0iFjuVO73xSrktcFolNdUqeP_j65RE_-blR_1DT_BOnDfFlrHlFYfNfvbvodOApZKuaGzor9VR-qXpuNq3iUJ06tj-nFieLjZou2kfcxvxmgiF713mnTIFxdIVI_iYMsDuHC0" /></p>
-<p>Recommended in the protected services to validate the origin of the traffic. It must have been proxied by Envoy. See Authorino <a href="../features/#json-injection-responsesuccessheadersdynamicmetadatajson">JSON injection</a> for an extra validation option using a shared secret passed in HTTP header.</p>
-<h3 id="centralized-authorization-service">Centralized authorization service<a class="headerlink" href="#centralized-authorization-service" title="Permanent link">&para;</a></h3>
-<p><img alt="Centralized Authorino topology" src="http://www.plantuml.com/plantuml/png/XO-xIiSm58VtFCMXWrk7n5Ma7HpSV8L3Ucn3Smcv228-Y6xkFfLFOjFIyASKEftBBz-Nf8i9Gyf6ipWhwp6W0UEiarDmXY25J8nvb3EE1DuDWB4K3XyC891CQ4TDqFnzVq7_yjoK7BtYX_Jt1vxictjVSoeTPvzdOd4X5fTYSIw-FueVxkAaI0-FqESqkQ2isoxPf_M5oYOAhoWN0DPOyPETM0voQFUVeIzJ7RS2xQswjXKJ1HCL4nksB8g-8pjae_y1" /></p>
-<p>Protected service should only listen on <code>localhost</code> and all traffic can be considered safe.</p>
-<h3 id="sidecars">Sidecars<a class="headerlink" href="#sidecars" title="Permanent link">&para;</a></h3>
-<p><img alt="Sidecars topology" src="http://www.plantuml.com/plantuml/png/bOyzJWCn48NxESKe1TqMdXgXfA2WumgZtM5tbFMFPcqaX3W8TFISYfE0ipAW42bAzUpt_AplRPVCbekVOTbhI6piqSSG-ycY5ynM121nl-THCCK1UQdYy1aGJVhCOPm5DvzlhxYxlzlKd9Ewe_JZ7M_3Otmwv59FHo-khvP9PHvkS5Vo54r3NFzgDmSlfq3e30YT1Q4BGQY2QCXY3zn_5_0GgplX4O0wxDhWLR0hgQjeluRfEENkxrPGQZs2LNvwpVZV8zXA68gVlm00" /></p>
-<p>Recommended <a href="#cluster-wide-vs-namespaced-instances"><code>namespaced</code> instances of Authorino</a> with <a href="#sharding">fine-grained label selectors</a> to avoid unnecessary caching of <code>AuthConfig</code>s.</p>
-<p>Apart from that, protected service should only listen on <code>localhost</code> and all traffic can be considered safe.</p>
-<h2 id="cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances<a class="headerlink" href="#cluster-wide-vs-namespaced-instances" title="Permanent link">&para;</a></h2>
-<p>Authorino instances can run in either <strong>cluster-wide</strong> or <strong>namespaced</strong> mode.</p>
-<p>Namespace-scoped instances only watch resources (<code>AuthConfig</code>s and <code>Secret</code>s) created in a given namespace. This deployment mode does not require admin privileges over the Kubernetes cluster to deploy the instance of the service (given Authorino's CRDs have been installed beforehand, such as when Authorino is installed using the <a href="https://github.com/kuadrant/authorino-operator">Authorino Operator</a>).</p>
-<p>Cluster-wide deployment mode, in contraposition, deploys instances of Authorino that watch resources across the entire cluster, consolidating all resources into a multi-namespace index of auth configs. Admin privileges over the Kubernetes cluster is required to deploy Authorino in cluster-wide mode.</p>
-<p>Be careful to avoid superposition when combining multiple Authorino instances and instance modes in the same Kubernetes cluster. Apart from caching unnecessary auth config data in the instances depending on your routing settings, the leaders of each instance (set of replicas) may compete for updating the status of the custom resources that are reconciled. See <a href="#resource-reconciliation-and-status-update">Resource reconciliation and status update</a> for more information.</p>
-<p>If necessary, use label selectors to narrow down the space of resources watched and reconciled by each Authorino instance. Check out the <a href="#sharding">Sharding</a> section below for details.</p>
-<h2 id="the-authorino-authconfig-custom-resource-definition-crd">The Authorino <code>AuthConfig</code> Custom Resource Definition (CRD)<a class="headerlink" href="#the-authorino-authconfig-custom-resource-definition-crd" title="Permanent link">&para;</a></h2>
-<p>The desired protection for a service is declaratively stated by applying an <code>AuthConfig</code> <a href="https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources">Custom Resource</a> to the Kubernetes cluster running Authorino.</p>
-<p>An <code>AuthConfig</code> resource typically looks like the following:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api-protection</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">    </span><span class="c1"># The list of public host names of the services protected by this AuthConfig resource.</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">    </span><span class="c1"># Authorino uses the host name provided in the payload of external authorization request to lookup for the corresponding AuthConfig to enforce.</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span><span class="c1"># Hostname collisions are prevented by rejecting to index a hostname already taken by another AuthConfig.</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span><span class="c1"># Format: hostname[:port]</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api.io:443</span><span class="w"> </span><span class="c1"># north-south traffic</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api.ns.svc.cluster.local</span><span class="w"> </span><span class="c1"># east-west traffic</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">  </span><span class="c1"># Set of stored named patterns to be reused in conditions and pattern-matching authorization rules</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">  </span><span class="nt">patterns</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="s">&quot;name&quot;</span><span class="w"> </span><span class="nv">→</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">selector</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">operator</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">value</span><span class="p p-Indicator">},</span><span class="w"> </span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">  </span><span class="c1"># Top-level conditions for the AuthConfig to be enforced.</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">  </span><span class="c1"># If omitted, the AuthConfig will be enforced at all requests.</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">  </span><span class="c1"># If present, all conditions must match for the AuthConfig to be enforced; otherwise, Authorino skips the AuthConfig and returns to the auth request with status OK.</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">  </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[{</span><span class="nv">selector</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">operator</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">value | named pattern ref</span><span class="p p-Indicator">},</span><span class="w"> </span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">  </span><span class="c1"># List of one or more trusted sources of identity:</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">  </span><span class="c1"># - Configurations to verify JSON Web Tokens (JWTs) issued by an OpenID Connect (OIDC) server</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="w">  </span><span class="c1"># - Endpoints for OAuth 2.0 token introspection</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="w">  </span><span class="c1"># - Attributes for the Kubernetes `TokenReview` API</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="w">  </span><span class="c1"># - Label selectors for API keys (stored in Kubernetes `Secret`s)</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="w">  </span><span class="c1"># - Label selectors trusted x509 issuer certificates (stored in Kubernetes `Secret`s)</span>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="w">  </span><span class="c1"># - Selectors for plain identity objects supplied in the payload of the authorization request</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="w">  </span><span class="c1"># - Anonymous access configs</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="s">&quot;name&quot;</span><span class="w"> </span><span class="nv">→</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">},</span><span class="w"> </span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a><span class="w">  </span><span class="c1"># List of sources of external metadata for the authorization (optional):</span>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a><span class="w">  </span><span class="c1"># - Endpoints for HTTP GET or GET-by-POST requests</span>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a><span class="w">  </span><span class="c1"># - OIDC UserInfo endpoints (associated with an OIDC token issuer specified in the authentication configs)</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a><span class="w">  </span><span class="c1"># - User-Managed Access (UMA) resource registries</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a><span class="w">  </span><span class="nt">metadata</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="s">&quot;name&quot;</span><span class="w"> </span><span class="nv">→</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">},</span><span class="w"> </span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a><span class="w">  </span><span class="c1"># List of authorization policies to be enforced (optional):</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a><span class="w">  </span><span class="c1"># - Pattern-matching rules (e.g. `context.request.http.path eq &#39;/pets&#39;`)</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a><span class="w">  </span><span class="c1"># - Open Policy Agent (OPA) inline or external Rego policies</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a><span class="w">  </span><span class="c1"># - Attributes for the Kubernetes `SubjectAccessReview` API</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a><span class="w">  </span><span class="c1"># – Attributes for authorization with an external SpiceDB server</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="s">&quot;name&quot;</span><span class="w"> </span><span class="nv">→</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">},</span><span class="w"> </span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a><span class="w">  </span><span class="c1"># Customization to the response to the external authorization request (optional)</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a><span class="w">  </span><span class="nt">response</span><span class="p">:</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a><span class="w">    </span><span class="c1"># List of dynamic response elements into the request on success authoization (optional):</span>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49" href="#__codelineno-0-49"></a><span class="w">    </span><span class="c1"># - Plain text</span>
-</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50" href="#__codelineno-0-50"></a><span class="w">    </span><span class="c1"># - JSON objects</span>
-</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51" href="#__codelineno-0-51"></a><span class="w">    </span><span class="c1"># - Festival Wristbands (signed JWTs issued by Authorino)</span>
-</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52" href="#__codelineno-0-52"></a><span class="w">    </span><span class="nt">success</span><span class="p">:</span>
-</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53" href="#__codelineno-0-53"></a><span class="w">      </span><span class="c1"># List of HTTP headers to inject into the request post-authorization (optional):</span>
-</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54" href="#__codelineno-0-54"></a><span class="w">      </span><span class="nt">headers</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="s">&quot;name&quot;</span><span class="w"> </span><span class="nv">→</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">},</span><span class="w"> </span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55" href="#__codelineno-0-55"></a>
-</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56" href="#__codelineno-0-56"></a><span class="w">      </span><span class="c1"># List of Envoy Dynamic Metadata to inject into the request post-authorization (optional):</span>
-</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57" href="#__codelineno-0-57"></a><span class="w">      </span><span class="nt">dynamicMetadata</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="s">&quot;name&quot;</span><span class="w"> </span><span class="nv">→</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">},</span><span class="w"> </span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58" href="#__codelineno-0-58"></a>
-</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59" href="#__codelineno-0-59"></a><span class="w">    </span><span class="c1"># Custom HTTP status code, message and headers to replace the default `401 Unauthorized` response (optional)</span>
-</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60" href="#__codelineno-0-60"></a><span class="w">    </span><span class="nt">unauthenticated</span><span class="p">:</span>
-</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61" href="#__codelineno-0-61"></a><span class="w">      </span><span class="nt">code</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">302</span>
-</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62" href="#__codelineno-0-62"></a><span class="w">      </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Redirecting to login</span>
-</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63" href="#__codelineno-0-63"></a><span class="w">      </span><span class="nt">headers</span><span class="p">:</span>
-</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64" href="#__codelineno-0-64"></a><span class="w">        </span><span class="s">&quot;Location&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65" href="#__codelineno-0-65"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://my-app.io/login</span>
-</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66" href="#__codelineno-0-66"></a>
-</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67" href="#__codelineno-0-67"></a><span class="w">    </span><span class="c1"># Custom HTTP status code, message and headers to replace the default `and `403 Forbidden` response (optional)</span>
-</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68" href="#__codelineno-0-68"></a><span class="w">    </span><span class="nt">unauthorized</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">code</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">message</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">headers</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">body</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69" href="#__codelineno-0-69"></a>
-</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70" href="#__codelineno-0-70"></a><span class="w">  </span><span class="c1"># List of callback targets:</span>
-</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71" href="#__codelineno-0-71"></a><span class="w">  </span><span class="c1"># - Endpoints for HTTP requests</span>
-</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72" href="#__codelineno-0-72"></a><span class="w">  </span><span class="nt">callbacks</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="s">&quot;name&quot;</span><span class="w"> </span><span class="nv">→</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">},</span><span class="w"> </span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<p>Check out the <a href="../../install/crd/authorino.kuadrant.io_authconfigs.yaml">OAS</a> of the <code>AuthConfig</code> CRD for a formal specification of the options for <code>authentication</code> verification, external <code>metadata</code> fetching, <code>authorization</code> policies, and dynamic <code>response</code>, as well as any other host protection capability implemented by Authorino.</p>
-<p>You can also read the specification from the CLI using the <a href="https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#explain"><code>kubectl explain</code></a> command. The Authorino CRD is required to have been installed in Kubernetes cluster. E.g. <code>kubectl explain authconfigs.spec.authentication.overrides</code>.</p>
-<p>A complete description of supported features and corresponding configuration options within an <code>AuthConfig</code> CR can be found in the <a href="../features/">Features</a> page.</p>
-<p>More concrete examples of <code>AuthConfig</code>s for specific use-cases can be found in the <a href="../user-guides/">User guides</a>.</p>
-<h2 id="resource-reconciliation-and-status-update">Resource reconciliation and status update<a class="headerlink" href="#resource-reconciliation-and-status-update" title="Permanent link">&para;</a></h2>
-<p>The instances of the Authorino authorization service workload, following the <a href="https://kubernetes.io/docs/concepts/extend-kubernetes/operator">Operator pattern</a>, watch events related to the <code>AuthConfig</code> custom resources, to build and reconcile an in-memory index of configs. Whenever a replica receives traffic for authorization request, it <a href="#host-lookup">looks up in the index</a> of <code>AuthConfig</code>s and then <a href="#the-auth-pipeline-aka-enforcing-protection-in-request-time">triggers the "Auth Pipeline"</a>, i.e. enforces the associated auth spec onto the request.</p>
-<p>An instance can be a single authorization service workload or a set of replicas. All replicas watch and reconcile the same set of resources that match the <code>--auth-config-label-selector</code> and <code>--secret-label-selector</code> configuration options. (See both <a href="#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a> and <a href="#sharding">Sharding</a>, for details about defining the reconciliation space of Authorino instances.)</p>
-<p>The above means that all replicas of an Authorino instance should be able to receive traffic for authorization requests.</p>
-<p>Among the multiple replicas of an instance, Authorino elects one replica to be leader. The leader is responsible for updating the status of reconciled <code>AuthConfig</code>s. If the leader eventually becomes unavailable, the instance will automatically elect another replica take its place as the new leader.</p>
-<p>The status of an <code>AuthConfig</code> tells whether the resource is "ready" (i.e. indexed). It also includes summary information regarding the numbers of authentication configs, metadata configs, authorization configs and response configs within the spec, as well as whether <a href="../features/#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristband</a> tokens are being issued by the Authorino instance as by spec.</p>
-<p>Apart from watching events related to <code>AuthConfig</code> custom resources, Authorino also watches events related to Kubernetes <code>Secret</code>s, as part of Authorino's <a href="../features/#api-key-authenticationapikey">API key authentication</a> feature. <code>Secret</code> resources that store API keys are linked to their corresponding <code>AuthConfig</code>s in the index. Whenever the Authorino instance detects a change in the set of API key <code>Secret</code>s linked to an <code>AuthConfig</code>s, the instance reconciles the index.</p>
-<p>Authorino only watches events related to <code>Secret</code>s whose <code>metadata.labels</code> match the label selector <code>--secret-label-selector</code> of the Authorino instance. The default values of the label selector for Kubernetes <code>Secret</code>s representing Authorino API keys is <code>authorino.kuadrant.io/managed-by=authorino</code>.</p>
-<h2 id="the-auth-pipeline-aka-enforcing-protection-in-request-time">The "Auth Pipeline" (<em>aka:</em> enforcing protection in request-time)<a class="headerlink" href="#the-auth-pipeline-aka-enforcing-protection-in-request-time" title="Permanent link">&para;</a></h2>
-<p><img alt="Authorino Auth Pipeline" src="../auth-pipeline.gif" /></p>
-<p>In each request to the protected API, Authorino triggers the so-called "Auth Pipeline", a set of configured <em>evaluators</em> that are organized in a 5-phase pipeline:</p>
-<ul>
-<li><strong>(i) Authentication phase:</strong> at least one source of identity (i.e., one authentication config) must resolve the supplied credential in the request into a valid identity or Authorino will otherwise reject the request as unauthenticated (401 HTTP response status).</li>
-<li><strong>(ii) Metadata phase:</strong> optional fetching of additional data from external sources, to add up to context and identity information, and used in authorization policies, dynamic responses and callback requests (phases iii to v).</li>
-<li><strong>(iii) Authorization phase:</strong> all unskipped policies must evaluate to a positive result ("authorized"), or Authorino will otherwise reject the request as unauthorized (403 HTTP response code).</li>
-<li><strong>(iv) Response phase</strong> – Authorino builds all user-defined response items (dynamic JSON objects and/or <em>Festival Wristband</em> OIDC tokens), which are supplied back to the external authorization client within added HTTP headers or as Envoy Dynamic Metadata</li>
-<li><strong>(v) Callbacks phase</strong> – Authorino sends callbacks to specified HTTP endpoints.</li>
-</ul>
-<p>Each phase is sequential to the other, from (i) to (v), while the evaluators within each phase are triggered concurrently or as prioritized. The <strong>Authentication</strong> phase (i) is the only one required to list at least one evaluator (i.e. 1+ authentication configs); <strong>Metadata</strong>, <strong>Authorization</strong> and <strong>Response</strong> phases can have any number of evaluators (including zero, and even be omitted in this case).</p>
-<h2 id="host-lookup">Host lookup<a class="headerlink" href="#host-lookup" title="Permanent link">&para;</a></h2>
-<p>Authorino reads the request host from <code>Attributes.Http.Host</code> of Envoy's <a href="https://pkg.go.dev/github.com/envoyproxy/go-control-plane/envoy/service/auth/v3?utm_source=gopls#CheckRequest"><code>CheckRequest</code></a> type, and uses it as key to lookup in the <a href="#resource-reconciliation-and-status-update">index</a> of <code>AuthConfig</code>s, matched against <code>spec.hosts</code>.</p>
-<p>Alternatively to <code>Attributes.Http.Host</code>, a <code>host</code> entry can be supplied in the <code>Attributes.ContextExtensions</code> map of the external authorino request. This will take precedence before the host attribute of the HTTP request.</p>
-<p>The <code>host</code> context extension is useful to support use cases such as of <strong>path prefix-based lookup</strong> and <strong>wildcard subdomains lookup</strong> with lookup strongly dictated by the external authorization client (e.g. Envoy), which often knows about routing and the expected <code>AuthConfig</code> to enforce beyond what Authorino can infer strictly based on the host name.</p>
-<p>Wildcards can also be used in the host names specified in the <code>AuthConfig</code>, resolved by Authorino. E.g. if <code>*.pets.com</code> is in <code>spec.hosts</code>, Authorino will match the concrete host names <code>dogs.pets.com</code>, <code>cats.pets.com</code>, etc. In case, of multiple possible matches, Authorino will try the longest match first (in terms of host name labels) and fall back to the closest wildcard upwards in the domain tree (if any).</p>
-<p>When more than one host name is specified in the <code>AuthConfig</code>, all of them can be used as key, i.e. all of them can be requested in the authorization request and will be mapped to the same config.</p>
-<p><strong>Example.</strong> Host lookup with wildcards.</p>
-<p><img alt="Domain tree" src="http://www.plantuml.com/plantuml/png/RP71ReCm38RlVWhKuoGcjN2U-YPLb6MTDS0e9E-_v8zgNC4fyVU5nFo-Ryd5bEU9Ol39BSyfT9VFI-UsBeeaijZB355MYzUGDl2wiU93wQE-OfNpSu2jcpUnil97AOxtmU0-wrWWMOuVi1oUNtY5Agl5oKr_8VQl7bg9BiXpzEWlfrylomy_-oiELN0zqpVLjpCzg1xEzAXw92g1TtrU-pQI6YXA3AB6iLSQTaEOo2lAXX2uPcWOiPX7M8ndePAKxlTSW90Y4O80-DB8yVUDsJGjrev1XqPr_82ZXJXw3yjtdgT_" /></p>
-<p>The domain tree above induces the following relation:</p>
-<ul>
-<li><code>foo.nip.io</code> → <code>authconfig-1</code> (matches <code>*.io</code>)</li>
-<li><code>talker-api.nip.io</code> → <code>authconfig-2</code> (matches <code>talker-api.nip.io</code>)</li>
-<li><code>dogs.pets.com</code> → <code>authconfig-2</code> (matches <code>*.pets.com</code>)</li>
-<li><code>api.acme.com</code> → <code>authconfig-3</code> (matches <code>api.acme.com</code>)</li>
-<li><code>www.acme.com</code> → <code>authconfig-4</code> (matches <code>*.acme.com</code>)</li>
-<li><code>foo.org</code> → <code>404 Not found</code></li>
-</ul>
-<p><br/></p>
-<p>The host can include the port number (i.e. <code>hostname:port</code>) or it can be just the name of the host name. Authorino will first try finding in the index a config associated to <code>hostname:port</code>, as supplied in the authorization request; if the index misses an entry for <code>hostname:port</code>, Authorino will then remove the <code>:port</code> suffix and repeat the lookup using just <code>hostname</code> as key. This provides implicit support for multiple port numbers for a same host without having to list all combinations in the <code>AuthConfig</code>.</p>
-<h3 id="avoiding-host-name-collision">Avoiding host name collision<a class="headerlink" href="#avoiding-host-name-collision" title="Permanent link">&para;</a></h3>
-<p>Authorino tries to prevent host name collision between <code>AuthConfig</code>s by rejecting to link in the index any <code>AuthConfig</code> and host name if the host name is already linked to a different <code>AuthConfig</code> in the index. This was intentionally designed to prevent users from superseding each other's <code>AuthConfig</code>s, partially or fully, by just picking the same host names or overlapping host names as others.</p>
-<p>When wildcards are involved, a host name that matches a host wildcard already linked in the index to another <code>AuthConfig</code> will be considered taken, and therefore the newest <code>AuthConfig</code> will be rejected to be linked to that host.</p>
-<p>This behavior can be disabled to allow <code>AuthConfig</code>s to partially supersede each others' host names (limited to strict host subsets), by supplying the <code>--allow-superseding-host-subsets</code> command-line flag when running the Authorino instance.</p>
-<h2 id="the-authorization-json">The Authorization JSON<a class="headerlink" href="#the-authorization-json" title="Permanent link">&para;</a></h2>
-<p>On every Auth Pipeline, Authorino builds the <strong>Authorization JSON</strong>, a "working-memory" data structure composed of <code>context</code> (information about the request, as supplied by the Envoy proxy to Authorino) and <code>auth</code> (objects resolved in phases (i) to (v) of the pipeline). The evaluators of each phase can read from the Authorization JSON and implement dynamic properties and decisions based on its values.</p>
-<p>At phase (iii), the authorization evaluators count on an Authorization JSON payload that looks like the following:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>// The authorization JSON combined along Authorino&#39;s auth pipeline for each request
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>{
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>  &quot;context&quot;: { // the input from the proxy
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a>    &quot;origin&quot;: {…},
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>    &quot;request&quot;: {
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>      &quot;http&quot;: {
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>        &quot;method&quot;: &quot;…&quot;,
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a>        &quot;headers&quot;: {…},
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>        &quot;path&quot;: &quot;/…&quot;,
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a>        &quot;host&quot;: &quot;…&quot;,
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a>        …
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a>      }
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a>    }
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a>  },
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a>  &quot;auth&quot;: {
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a>    &quot;identity&quot;: {
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a>      // the identity resolved, from the supplied credentials, by one of the evaluators of phase (i)
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a>    },
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a>    &quot;metadata&quot;: {
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a>      // each metadata object/collection resolved by the evaluators of phase (ii), by name of the evaluator
-</span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a>    }
-</span><span id="__span-1-22"><a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a>  }
-</span><span id="__span-1-23"><a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a>}
-</span></code></pre></div>
-<p>The policies evaluated can use any data from the authorization JSON to define authorization rules.</p>
-<p>After phase (iii), Authorino appends to the authorization JSON the results of this phase as well, and the payload available for phase (iv) becomes:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>// The authorization JSON combined along Authorino&#39;s auth pipeline for each request
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>{
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>  &quot;context&quot;: { // the input from the proxy
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a>    &quot;origin&quot;: {…},
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>    &quot;request&quot;: {
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a>      &quot;http&quot;: {
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a>        &quot;method&quot;: &quot;…&quot;,
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a>        &quot;headers&quot;: {…},
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>        &quot;path&quot;: &quot;/…&quot;,
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a>        &quot;host&quot;: &quot;…&quot;,
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a>        …
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a>      }
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a>    }
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a>  },
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a>  &quot;auth&quot;: {
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a>    &quot;identity&quot;: {
-</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a>      // the identity resolved, from the supplied credentials, by one of the evaluators of phase (i)
-</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a>    },
-</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a>    &quot;metadata&quot;: {
-</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a>      // each metadata object/collection resolved by the evaluators of phase (ii), by name of the evaluator
-</span><span id="__span-2-21"><a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a>    },
-</span><span id="__span-2-22"><a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a>    &quot;authorization&quot;: {
-</span><span id="__span-2-23"><a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a>      // each authorization policy result resolved by the evaluators of phase (iii), by name of the evaluator
-</span><span id="__span-2-24"><a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a>    }
-</span><span id="__span-2-25"><a id="__codelineno-2-25" name="__codelineno-2-25" href="#__codelineno-2-25"></a>  }
-</span><span id="__span-2-26"><a id="__codelineno-2-26" name="__codelineno-2-26" href="#__codelineno-2-26"></a>}
-</span></code></pre></div>
-<p><a href="../features/#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristbands</a> and <a href="../features/#json-injection-responsesuccessheadersdynamicmetadatajson">Dynamic JSON</a> responses can include dynamic values (custom claims/properties) fetched from the authorization JSON. These can be returned to the external authorization client in added HTTP headers or as Envoy <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/advanced/well_known_dynamic_metadata">Well Known Dynamic Metadata</a>. Check out <a href="../features/#custom-response-features-response">Custom response features</a> for details.</p>
-<p>For information about reading and fetching data from the Authorization JSON (syntax, functions, etc), check out <a href="../features/#common-feature-json-paths-selector">JSON paths</a>.</p>
-<h2 id="raw-http-authorization-interface">Raw HTTP Authorization interface<a class="headerlink" href="#raw-http-authorization-interface" title="Permanent link">&para;</a></h2>
-<p>Besides providing the gRPC authorization interface – that implements the Envoy gRPC authorization server –, Authorino also provides another interface for <strong>raw HTTP authorization</strong>. This second interface responds to <code>GET</code> and <code>POST</code> HTTP requests sent to <code>:5001/check</code>, and is suitable for other forms of integration, such as:</p>
-<ul>
-<li>using Authorino as Kubernetes ValidatingWebhook service (<a href="../user-guides/validating-webhook/">example</a>);</li>
-<li>other HTTP proxies and API gateways;</li>
-<li>old versions of Envoy incompatible with the latest version of gRPC external authorization protocol (Authorino is based on v3.19.1 of Envoy external authorization API)</li>
-</ul>
-<p>In the raw HTTP interface, the host used to <a href="#host-lookup">lookup</a> for an <code>AuthConfig</code> must be supplied in the <code>Host</code> HTTP header of the request. Other attributes of the HTTP request are also passed in the context to evaluate the <code>AuthConfig</code>, including the body of the request.</p>
-<h2 id="caching">Caching<a class="headerlink" href="#caching" title="Permanent link">&para;</a></h2>
-<h3 id="openid-connect-and-user-managed-access-configs">OpenID Connect and User-Managed Access configs<a class="headerlink" href="#openid-connect-and-user-managed-access-configs" title="Permanent link">&para;</a></h3>
-<p>OpenID Connect and User-Managed Access configurations, discovered usually at reconciliation-time from well-known discovery endpoints.</p>
-<p>Cached individual OpenID Connect configurations discovered by Authorino can be configured to be auto-refreshed, by setting the corresponding <code>spec.authentication.jwt.ttl</code> field in the AuthConfig (given in seconds, default: <code>0</code> – i.e. no cache update).</p>
-<h3 id="json-web-keys-jwks-and-json-web-key-sets-jwks">JSON Web Keys (JWKs) and JSON Web Key Sets (JWKS)<a class="headerlink" href="#json-web-keys-jwks-and-json-web-key-sets-jwks" title="Permanent link">&para;</a></h3>
-<p>JSON signature verification certificates linked by discovered OpenID Connect configurations, fetched usually at reconciliation-time.</p>
-<h3 id="revoked-access-tokens">Revoked access tokens<a class="headerlink" href="#revoked-access-tokens" title="Permanent link">&para;</a></h3>
-<table>
-  <tr>
-    <td><small>Not implemented - In analysis (<a href="https://github.com/kuadrant/authorino/issues/19">#19</a>)</small></td>
-  </tr>
-</table>
-
-<p>Caching of access tokens identified and or notified as revoked prior to expiration.</p>
-<h3 id="external-metadata">External metadata<a class="headerlink" href="#external-metadata" title="Permanent link">&para;</a></h3>
-<table>
-  <tr>
-    <td><small>Not implemented - Planned (<a href="https://github.com/kuadrant/authorino/issues/21">#21</a>)</small></td>
-  </tr>
-</table>
-
-<p>Caching of resource data obtained in previous requests.</p>
-<h3 id="compiled-rego-policies">Compiled Rego policies<a class="headerlink" href="#compiled-rego-policies" title="Permanent link">&para;</a></h3>
-<p>Performed automatically by Authorino at reconciliation-time for the authorization policies based on the built-in OPA module.</p>
-<p>Precompiled and cached individual Rego policies originally pulled by Authorino from external registries can be configured to be auto-refreshed, by setting the corresponding <code>spec.authorization.opa.externalRegistry.ttl</code> field in the AuthConfig (given in seconds, default: <code>0</code> – i.e. no cache update).</p>
-<h3 id="repeated-requests">Repeated requests<a class="headerlink" href="#repeated-requests" title="Permanent link">&para;</a></h3>
-<table>
-  <tr>
-    <td><small>Not implemented - In analysis (<a href="https://github.com/kuadrant/authorino/issues/20">#20</a>)</small></td>
-  </tr>
-</table>
-
-<p>For consecutive requests performed, within a given period of time, by a same user that request for a same resource, such that the result of the auth pipeline can be proven that would not change.</p>
-<h2 id="sharding">Sharding<a class="headerlink" href="#sharding" title="Permanent link">&para;</a></h2>
-<p>By default, Authorino instances will watch <code>AuthConfig</code> CRs in the entire space (namespace or entire cluster; see <a href="#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a> for details). To support combining multiple Authorino instances and instance modes in the same Kubernetes cluster, and yet avoiding superposition between the instances (i.e. multiple instances reconciling the same <code>AuthConfig</code>s), Authorino offers support for data sharding, i.e. to horizontally narrow down the space of reconciliation of an Authorino instance to a subset of that space.</p>
-<p>The benefits of limiting the space of reconciliation of an Authorino instance include avoiding unnecessary caching and workload in instances that do not receive corresponding traffic (according to your routing settings) and preventing leaders of multiple instances (sets of replicas) to compete on resource status updates (see <a href="#resource-reconciliation-and-status-update">Resource reconciliation and status update</a> for details).</p>
-<p>Use-cases for sharding of <code>AuthConfig</code>s:</p>
-<ul>
-<li>Horizontal load balancing of traffic of authorization requests</li>
-<li>Supporting for managed centralized instances of Authorino to API owners who create and maintain their own <code>AuthConfig</code>s within their own user namespaces.</li>
-</ul>
-<p>Authorino's custom controllers filter the <code>AuthConfig</code>-related events to be reconciled using <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/labels#Parse">Kubernetes label selectors</a>, defined for the Authorino instance via <code>--auth-config-label-selector</code> command-line flag. By default, <code>--auth-config-label-selector</code> is empty, meaning all <code>AuthConfig</code>s in the space are watched; this variable can be set to any value parseable as a valid label selector, causing Authorino to then watch only events of <code>AuthConfig</code>s whose <code>metadata.labels</code> match the selector.</p>
-<p>The following are all valid examples of <code>AuthConfig</code> label selector filters:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>--auth-config-label-selector=&quot;authorino.kuadrant.io/managed-by=authorino&quot;
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>--auth-config-label-selector=&quot;authorino.kuadrant.io/managed-by=authorino,other-label=other-value&quot;
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a>--auth-config-label-selector=&quot;authorino.kuadrant.io/managed-by in (authorino,kuadrant)&quot;
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a>--auth-config-label-selector=&quot;authorino.kuadrant.io/managed-by!=authorino-v0.4&quot;
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>--auth-config-label-selector=&quot;!disabled&quot;
-</span></code></pre></div>
-<h2 id="rbac">RBAC<a class="headerlink" href="#rbac" title="Permanent link">&para;</a></h2>
-<p>The table below describes the roles and role bindings defined by the Authorino service:</p>
-<table>
-<thead>
-<tr>
-<th>Role</th>
-<th>Kind</th>
-<th style="text-align: center;">Scope(*)</th>
-<th>Description</th>
-<th>Permissions</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>authorino-manager-role</code></td>
-<td><code>ClusterRole</code></td>
-<td style="text-align: center;">C/N</td>
-<td>Role of the Authorino manager service</td>
-<td>Watch and reconcile <code>AuthConfig</code>s and <code>Secret</code>s</td>
-</tr>
-<tr>
-<td><code>authorino-manager-k8s-auth-role</code></td>
-<td><code>ClusterRole</code></td>
-<td style="text-align: center;">C/N</td>
-<td>Role for the Kubernetes auth features</td>
-<td>Create <code>TokenReview</code>s and <code>SubjectAccessReview</code>s (Kubernetes auth)</td>
-</tr>
-<tr>
-<td><code>authorino-leader-election-role</code></td>
-<td><code>Role</code></td>
-<td style="text-align: center;">N</td>
-<td>Leader election role</td>
-<td>Create/update the <code>ConfigMap</code> used to coordinate which replica of Authorino is the leader</td>
-</tr>
-<tr>
-<td><code>authorino-authconfig-editor-role</code></td>
-<td><code>ClusterRole</code></td>
-<td style="text-align: center;">-</td>
-<td><code>AuthConfig</code> editor</td>
-<td>R/W <code>AuthConfig</code>s; Read <code>AuthConfig/status</code></td>
-</tr>
-<tr>
-<td><code>authorino-authconfig-viewer-role</code></td>
-<td><code>ClusterRole</code></td>
-<td style="text-align: center;">-</td>
-<td><code>AuthConfig</code> viewer</td>
-<td>Read <code>AuthConfig</code>s and <code>AuthConfig/status</code></td>
-</tr>
-<tr>
-<td><code>authorino-proxy-role</code></td>
-<td><code>ClusterRole</code></td>
-<td style="text-align: center;">C/N</td>
-<td>Kube-rbac-proxy-role (sidecar)'s role</td>
-<td>Create <code>TokenReview</code>s and <code>SubjectAccessReview</code>s to check permissions to the <code>/metrics</code> endpoint</td>
-</tr>
-<tr>
-<td><code>authorino-metrics-reader</code></td>
-<td><code>ClusterRole</code></td>
-<td style="text-align: center;">-</td>
-<td>Metrics reader</td>
-<td><code>GET /metrics</code></td>
-</tr>
-</tbody>
-</table>
-<p><small>(*) C - Cluster-wide | N - Authorino namespace | C/N - Cluster-wide or Authorino namespace (depending on the <a href="#cluster-wide-vs-namespaced-instances">deployment mode</a>).</small></p>
-<h2 id="observability">Observability<a class="headerlink" href="#observability" title="Permanent link">&para;</a></h2>
-<p>Please refer to the <a href="../user-guides/observability/">Observability</a> user guide for info on Prometheus metrics exported by Authorino, readiness probe, logging, tracing, etc.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/auth-pipeline.gif b/0.10.0/authorino/docs/auth-pipeline.gif
deleted file mode 100644
index 98ef6b750a626b0c1719bd90744752314a521ef6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 568634
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
DiSrT{

diff --git a/0.10.0/authorino/docs/code_of_conduct/index.html b/0.10.0/authorino/docs/code_of_conduct/index.html
deleted file mode 100644
index 378f0a33f..000000000
--- a/0.10.0/authorino/docs/code_of_conduct/index.html
+++ /dev/null
@@ -1,3377 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/code_of_conduct/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Code of conduct - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#code-of-conduct" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Code of conduct
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#code-of-conduct" class="md-nav__link">
-    <span class="md-ellipsis">
-      Code of Conduct
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/code_of_conduct.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Code of conduct</h1>
-
-<h2 id="code-of-conduct">Code of Conduct<a class="headerlink" href="#code-of-conduct" title="Permanent link">&para;</a></h2>
-<p>Autorino follows the <a href="https://github.com/Kuadrant/governance/blob/main/CODE_OF_CONDUCT.md"><strong>Kuadrant Community Code of Conduct</strong></a>, which is based on the <a href="https://github.com/cncf/foundation/blob/main/code-of-conduct.md">CNCF Code of Conduct</a>.</p>
-<p>Please refer to <a href="https://github.com/Kuadrant/governance/blob/main/CODE_OF_CONDUCT.md">this</a> page for a description of the standards and values we stand for in our relationship with the community.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/contributing/index.html b/0.10.0/authorino/docs/contributing/index.html
deleted file mode 100644
index 97034b924..000000000
--- a/0.10.0/authorino/docs/contributing/index.html
+++ /dev/null
@@ -1,3913 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/contributing/">
-      
-      
-        <link rel="prev" href="../user-guides/sharding/">
-      
-      
-        <link rel="next" href="../../../limitador/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Developer's Guide - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#developers-guide" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Developer's Guide
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#technology-stack-for-developers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Technology stack for developers
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#workflow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Workflow
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Workflow">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#check-the-issues" class="md-nav__link">
-    <span class="md-ellipsis">
-      Check the issues
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clone-the-repo-and-setup-the-local-environment" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clone the repo and setup the local environment
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#make-your-changes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Make your changes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#run-the-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the tests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#try-locally" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try locally
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Try locally">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#build-deploy-and-try-authorino-in-a-local-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build, deploy and try Authorino in a local cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#additional-tools-for-specific-use-cases" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional tools (for specific use-cases)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#re-build-and-rollout-latest" class="md-nav__link">
-    <span class="md-ellipsis">
-      Re-build and rollout latest
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clean-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean-up
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#sign-your-commits" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sign your commits
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#logging-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Logging policy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#additional-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional resources
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#reach-out" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reach out
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#technology-stack-for-developers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Technology stack for developers
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#workflow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Workflow
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Workflow">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#check-the-issues" class="md-nav__link">
-    <span class="md-ellipsis">
-      Check the issues
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clone-the-repo-and-setup-the-local-environment" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clone the repo and setup the local environment
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#make-your-changes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Make your changes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#run-the-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the tests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#try-locally" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try locally
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Try locally">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#build-deploy-and-try-authorino-in-a-local-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build, deploy and try Authorino in a local cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#additional-tools-for-specific-use-cases" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional tools (for specific use-cases)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#re-build-and-rollout-latest" class="md-nav__link">
-    <span class="md-ellipsis">
-      Re-build and rollout latest
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clean-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean-up
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#sign-your-commits" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sign your commits
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#logging-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Logging policy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#additional-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional resources
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#reach-out" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reach out
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/contributing.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="developers-guide">Developer's Guide<a class="headerlink" href="#developers-guide" title="Permanent link">&para;</a></h1>
-<h2 id="technology-stack-for-developers">Technology stack for developers<a class="headerlink" href="#technology-stack-for-developers" title="Permanent link">&para;</a></h2>
-<p>Minimum requirements to contribute to Authorino are:</p>
-<ul>
-<li><a href="https://golang.org">Golang v1.21+</a></li>
-<li><a href="https://docker.com">Docker</a></li>
-</ul>
-<p>Authorino's code was originally bundled using the <a href="https://sdk.operatorframework.io/">Operator SDK</a> (v1.9.0).</p>
-<p>The following tools can be installed as part of the development workflow:</p>
-<ul>
-<li>
-<p><em>Installed with <code>go install</code> to the <code>$PROJECT_DIR/bin</code> directory:</em></p>
-<ul>
-<li><a href="https://book.kubebuilder.io/reference/controller-gen.html">controller-gen</a>: for building custom types and manifests</li>
-<li><a href="https://kustomize.io/">Kustomize</a>: for assembling flavoured manifests and installing/deploying</li>
-<li><a href="https://book.kubebuilder.io/reference/envtest.html">setup-envtest</a>: for running the tests – extra tools installed to <code>./testbin</code></li>
-<li><a href="https://cs.opensource.google/go/x/perf">benchstat</a>: for human-friendly test benchmark reports</li>
-<li><a href="https://github.com/golang/mock">mockgen</a>: to generate mocks for tests – e.g. <code>./bin/mockgen -source=pkg/auth/auth.go -destination=pkg/auth/mocks/mock_auth.go</code></li>
-<li><a href="https://kind.sigs.k8s.io">Kind</a>: for deploying a containerized Kubernetes cluster for integration testing purposes</li>
-</ul>
-</li>
-<li>
-<p><em>Other recommended tools to have installed:</em></p>
-<ul>
-<li><a href="https://stedolan.github.io/jq/">jq</a></li>
-<li><a href="https://mikefarah.github.io/yq/">yq</a></li>
-<li><a href="https://www.gnu.org/software/sed/">gnu-sed</a></li>
-</ul>
-</li>
-</ul>
-<h2 id="workflow">Workflow<a class="headerlink" href="#workflow" title="Permanent link">&para;</a></h2>
-<p><img alt="Development workflow" src="http://www.plantuml.com/plantuml/png/LKz1QiGm3Bpx5MBlfJye2uNU2alR3nXNn26s5IJvaD_NKbBm7gBCQ0RD-2uQMNijGRQrxP5ZXKgDKcQg2CeTGs1C6jjI46xl6TC6cX5MaOvoWoWdd5qVnDjhAjJGhOmxkT40pCRFk24Sr1bI7glhteLdum-AkgO3F0byGA4KIpbEdOzP_bwNTWLGhQkU0JAsi-lH9NlJnvVh--0X-BFWvSrh1nj6_ijTVrjv9nj6hC3u37gC3ID-yuxjjzVo1m00" /></p>
-<h3 id="check-the-issues">Check the issues<a class="headerlink" href="#check-the-issues" title="Permanent link">&para;</a></h3>
-<p>Start by checking the list of <a href="https://github.com/kuadrant/authorino/issues">issues</a> in GitHub.</p>
-<p>In case you want to contribute with an idea for enhancement, a bug fix, or question, please make sure to <a href="https://github.com/kuadrant/authorino/issues/new">describe the issue</a> so we can start a conversation together and help you find the best way to get your contribution merged.</p>
-<h3 id="clone-the-repo-and-setup-the-local-environment">Clone the repo and setup the local environment<a class="headerlink" href="#clone-the-repo-and-setup-the-local-environment" title="Permanent link">&para;</a></h3>
-<p>Fork/clone the repo:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>git@github.com:kuadrant/authorino.git<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>authorino
-</span></code></pre></div>
-<p>Download the Golang dependencies:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>vendor
-</span></code></pre></div></p>
-<p>For additional automation provided, check:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>make<span class="w"> </span><span class="nb">help</span>
-</span></code></pre></div>
-<h3 id="make-your-changes">Make your changes<a class="headerlink" href="#make-your-changes" title="Permanent link">&para;</a></h3>
-<p>Good changes...</p>
-<ul>
-<li>follow the <a href="https://golang.org/doc/effective_go">Golang conventions</a></li>
-<li>have proper test coverage</li>
-<li>address corresponding updates to the <a href="../">docs</a></li>
-<li>help us fix wherever we failed to do the above 😜</li>
-</ul>
-<h3 id="run-the-tests">Run the tests<a class="headerlink" href="#run-the-tests" title="Permanent link">&para;</a></h3>
-<p>To run the tests:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>make<span class="w"> </span><span class="nb">test</span>
-</span></code></pre></div>
-<h3 id="try-locally">Try locally<a class="headerlink" href="#try-locally" title="Permanent link">&para;</a></h3>
-<h4 id="build-deploy-and-try-authorino-in-a-local-cluster">Build, deploy and try Authorino in a local cluster<a class="headerlink" href="#build-deploy-and-try-authorino-in-a-local-cluster" title="Permanent link">&para;</a></h4>
-<p>The following command will:</p>
-<ul>
-<li>Start a local Kubernetes cluster (using Kind)</li>
-<li>Install <a href="https://github.com/jetstack/cert-manager">cert-manager</a> in the cluster</li>
-<li>Install the <a href="https://github.com/kuadrant/authorino-operator">Authorino Operator</a> and Authorino CRDs</li>
-<li>Build an image of Authorino based on the current branch</li>
-<li>Push the freshly built image to the cluster's registry</li>
-<li>Generate TLS certificates for the Authorino service</li>
-<li>Deploy an instance of Authorino</li>
-<li>Deploy the example application <a href="https://github.com/kuadrant/authorino-examples#talker-api"><strong>Talker API</strong></a>, a simple HTTP API that echoes back whatever it gets in the request</li>
-<li>Setup Envoy for proxying to the Talker API and using Authorino for external authorization</li>
-</ul>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>You will be prompted to edit the <code>Authorino</code> custom resource.</p>
-<p>The main workload composed of Authorino instance and user apps (Envoy, Talker API) will be deployed to the <code>default</code> Kubernetes namespace.</p>
-<p>Once the deployment is ready, you can forward the requests on port 8000 to the Envoy service</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<details>
-<summary>Pro tips</summary>
-<ol>
-<li>Change the default workload namespace by supplying the <code>NAMESPACE</code> argument to your <code>make local-setup</code> and other deployment, apps and local cluster related targets. If the namespace does not exist, it will be created.</li>
-<li>Switch to TLS disabled by default when deploying locally by supplying <code>TLS_ENABLED=0</code> to your <code>make local-setup</code> and <code>make deploy</code> commands. E.g. <code>make local-setup TLS_ENABLED=0</code>.</li>
-<li>Skip being prompted to edit the <code>Authorino</code> CR and default to an Authorino deployment with TLS enabled, debug/development log level/mode, and standard name 'authorino', by supplying <code>FF=1</code> to your <code>make local-setup</code> and <code>make deploy</code> commands. E.g. <code>make local-setup FF=1</code></li>
-<li>Supply <code>DEPLOY_IDPS=1</code> to <code>make local-setup</code> and <code>make user-apps</code> to deploy Keycloak and Dex to the cluster. <code>DEPLOY_KEYCLOAK</code> and <code>DEPLOY_DEX</code> are also available. Read more about additional tools for specific use cases in the section below.</li>
-<li>Saving the ID of the process (PID) of the port-forward command spawned in the background can be useful to later kill and restart the process. E.g. <code>kubectl port-forward deployment/envoy 8000:8000 &amp;;PID=$!</code>; then <code>kill $PID</code>.</li>
-</ol>
-</details>
-<h4 id="additional-tools-for-specific-use-cases">Additional tools (for specific use-cases)<a class="headerlink" href="#additional-tools-for-specific-use-cases" title="Permanent link">&para;</a></h4>
-<details>
-<summary><strong>Limitador</strong></summary>
-<p>To deploy <a href="https://github.com/kuadrant/limitador">Limitador</a> – pre-configured in Envoy for rate-limiting the Talker API to 5 hits per minute per <code>user_id</code> when available in the cluster workload –, run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/limitador/limitador-deploy.yaml
-</span></code></pre></div>
-</details>
-<details>
-<summary><strong>Keycloak</strong></summary>
-<p>Authorino examples include a bundle of <a href="https://www.keycloak.org">Keycloak</a> preloaded with the following realm setup:</p>
-<ul>
-<li>Admin console: <a href="http://localhost:8080/admin">http://localhost:8080/admin</a>  (admin/p)</li>
-<li>Preloaded realm: <strong>kuadrant</strong></li>
-<li>Preloaded clients:<ul>
-<li><strong>demo</strong>: to which API consumers delegate access and therefore the one which access tokens are issued to</li>
-<li><strong>authorino</strong>: used by Authorino to fetch additional user info with <code>client_credentials</code> grant type</li>
-<li><strong>talker-api</strong>: used by Authorino to fetch UMA-protected resource data associated with the Talker API</li>
-</ul>
-</li>
-<li>Preloaded resources:<ul>
-<li><code>/hello</code></li>
-<li><code>/greetings/1</code> (owned by user john)</li>
-<li><code>/greetings/2</code> (owned by user jane)</li>
-<li><code>/goodbye</code></li>
-</ul>
-</li>
-<li>Realm roles:<ul>
-<li>member (default to all users)</li>
-<li>admin</li>
-</ul>
-</li>
-<li>Preloaded users:<ul>
-<li>john/p (member)</li>
-<li>jane/p (admin)</li>
-<li>peter/p (member, email not verified)</li>
-</ul>
-</li>
-</ul>
-<p>To deploy, run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p>Forward local requests to the instance of Keycloak running in the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/keycloak<span class="w"> </span><span class="m">8080</span>:8080<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-</details>
-<details>
-<summary><strong>Dex</strong></summary>
-<p>Authorino examples include a bundle of <a href="https://dexidp.io">Dex</a> preloaded with the following setup:</p>
-<ul>
-<li>Preloaded clients:<br/><ul>
-<li><strong>demo</strong>: to which API consumers delegate access and therefore the one which access tokens are issued to (Client secret: aaf88e0e-d41d-4325-a068-57c4b0d61d8e)</li>
-</ul>
-</li>
-<li>Preloaded users:<br/><ul>
-<li>marta@localhost/password</li>
-</ul>
-</li>
-</ul>
-<p>To deploy, run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/dex/dex-deploy.yaml
-</span></code></pre></div>
-<p>Forward local requests to the instance of Dex running in the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/dex<span class="w"> </span><span class="m">5556</span>:5556<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-</details>
-<details>
-<summary><strong>a12n-server</strong></summary>
-<p>Authorino examples include a bundle of <a href="https://github.com/curveball/a12n-server"><strong>a12n-server</strong></a> and corresponding MySQL database, preloaded with the following setup:</p>
-<ul>
-<li>Admin console: http://a12n-server:8531 (admin/123456)</li>
-<li>Preloaded clients:<br/><ul>
-<li><strong>service-account-1</strong>: to obtain access tokens via <code>client_credentials</code> OAuth2 grant type, to consume the Talker API (Client secret: DbgXROi3uhWYCxNUq_U1ZXjGfLHOIM8X3C2bJLpeEdE); includes metadata privilege: <code>{ "talker-api": ["read"] }</code> that can be used to write authorization policies</li>
-<li><strong>talker-api</strong>: to authenticate to the token introspect endpoint (Client secret: V6g-2Eq2ALB1_WHAswzoeZofJ_e86RI4tdjClDDDb4g)</li>
-</ul>
-</li>
-</ul>
-<p>To deploy, run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/a12n-server/a12n-server-deploy.yaml
-</span></code></pre></div>
-<p>Forward local requests to the instance of a12n-server running in the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/a12n-server<span class="w"> </span><span class="m">8531</span>:8531<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-</details>
-<h4 id="re-build-and-rollout-latest">Re-build and rollout latest<a class="headerlink" href="#re-build-and-rollout-latest" title="Permanent link">&para;</a></h4>
-<p>Re-build and rollout latest Authorino image:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>make<span class="w"> </span>local-rollout
-</span></code></pre></div>
-<p>If you made changes to the CRD between iterations, re-install by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>make<span class="w"> </span>install
-</span></code></pre></div>
-<h4 id="clean-up">Clean-up<a class="headerlink" href="#clean-up" title="Permanent link">&para;</a></h4>
-<p>The following command deletes the entire Kubernetes cluster started with Kind:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-<h3 id="sign-your-commits">Sign your commits<a class="headerlink" href="#sign-your-commits" title="Permanent link">&para;</a></h3>
-<p>All commits to be accepted to Authorino's code are required to be signed. Refer to <a href="https://docs.github.com/en/authentication/managing-commit-signature-verification/signing-commits">this page</a> about signing your commits.</p>
-<h2 id="logging-policy">Logging policy<a class="headerlink" href="#logging-policy" title="Permanent link">&para;</a></h2>
-<p>A few guidelines for adding logging messages in your code:</p>
-<ol>
-<li>Make sure you understand Authorino's <a href="../user-guides/observability/#logging">Logging</a> architecture and policy regarding log levels, log modes, tracing IDs, etc.</li>
-<li>Respect controller-runtime's <a href="https://github.com/kubernetes-sigs/controller-runtime/blob/master/TMP-LOGGING.md">Logging Guidelines</a>.</li>
-<li>Do not add sensitive data to your <code>info</code> log messages; instead, redact all sensitive data in your log messages or use <code>debug</code> log level by mutating the logger with <code>V(1)</code> before outputting the message.</li>
-</ol>
-<h2 id="additional-resources">Additional resources<a class="headerlink" href="#additional-resources" title="Permanent link">&para;</a></h2>
-<p>Here in the repo:</p>
-<ul>
-<li><a href="../getting-started/">Getting started</a></li>
-<li><a href="../terminology/">Terminology</a></li>
-<li><a href="../architecture/">Architecture</a></li>
-<li><a href="../features/">Feature description</a></li>
-</ul>
-<p>Other repos:</p>
-<ul>
-<li><a href="https://github.com/kuadrant/authorino-operator">Authorino Operator</a></li>
-<li><a href="https://github.com/kuadrant/authorino-examples">Authorino examples</a></li>
-</ul>
-<h2 id="reach-out">Reach out<a class="headerlink" href="#reach-out" title="Permanent link">&para;</a></h2>
-<p><a href="https://kubernetes.slack.com/archives/C05J0D0V525">#kuadrant</a> channel on kubernetes.slack.com.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/features/index.html b/0.10.0/authorino/docs/features/index.html
deleted file mode 100644
index 6f33d3cf3..000000000
--- a/0.10.0/authorino/docs/features/index.html
+++ /dev/null
@@ -1,5241 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/features/">
-      
-      
-        <link rel="prev" href="../architecture/">
-      
-      
-        <link rel="next" href="../user-guides/host-override/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Reference - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#features" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Reference
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-json-paths-selector" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: JSON paths (selector)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Common feature: JSON paths (selector)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#syntax" class="md-nav__link">
-    <span class="md-ellipsis">
-      Syntax
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#string-modifiers" class="md-nav__link">
-    <span class="md-ellipsis">
-      String modifiers
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#interpolation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Interpolation
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#identity-verification-authentication-features-authentication" class="md-nav__link">
-    <span class="md-ellipsis">
-      Identity verification &amp; authentication features (authentication)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Identity verification & authentication features (authentication)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-key-authenticationapikey" class="md-nav__link">
-    <span class="md-ellipsis">
-      API key (authentication.apiKey)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kubernetes-tokenreview-authenticationkubernetestokenreview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kubernetes TokenReview (authentication.kubernetesTokenReview)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#jwt-verification-authenticationjwt" class="md-nav__link">
-    <span class="md-ellipsis">
-      JWT verification (authentication.jwt)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#oauth-20-introspection-authenticationoauth2introspection" class="md-nav__link">
-    <span class="md-ellipsis">
-      OAuth 2.0 introspection (authentication.oauth2Introspection)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#x509-client-certificate-authentication-authenticationx509" class="md-nav__link">
-    <span class="md-ellipsis">
-      X.509 client certificate authentication (authentication.x509)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#plain-authenticationplain" class="md-nav__link">
-    <span class="md-ellipsis">
-      Plain (authentication.plain)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#anonymous-access-authenticationanonymous" class="md-nav__link">
-    <span class="md-ellipsis">
-      Anonymous access (authentication.anonymous)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#festival-wristband-authentication" class="md-nav__link">
-    <span class="md-ellipsis">
-      Festival Wristband authentication
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#extra-auth-credentials-authenticationcredentials" class="md-nav__link">
-    <span class="md-ellipsis">
-      Extra: Auth credentials (authentication.credentials)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#extra-identity-extension-authenticationdefaults-and-authenticationoverrides" class="md-nav__link">
-    <span class="md-ellipsis">
-      Extra: Identity extension (authentication.defaults and authentication.overrides)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#external-auth-metadata-features-metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      External auth metadata features (metadata)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="External auth metadata features (metadata)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#http-getget-by-post-metadatahttp" class="md-nav__link">
-    <span class="md-ellipsis">
-      HTTP GET/GET-by-POST (metadata.http)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#oidc-userinfo-metadatauserinfo" class="md-nav__link">
-    <span class="md-ellipsis">
-      OIDC UserInfo (metadata.userInfo)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#user-managed-access-uma-resource-registry-metadatauma" class="md-nav__link">
-    <span class="md-ellipsis">
-      User-Managed Access (UMA) resource registry (metadata.uma)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#authorization-features-authorization" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authorization features (authorization)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Authorization features (authorization)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#pattern-matching-authorization-authorizationpatternmatching" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pattern-matching authorization (authorization.patternMatching)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#open-policy-agent-opa-rego-policies-authorizationopa" class="md-nav__link">
-    <span class="md-ellipsis">
-      Open Policy Agent (OPA) Rego policies (authorization.opa)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kubernetes SubjectAccessReview (authorization.kubernetesSubjectAccessReview)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spicedb-authorizationspicedb" class="md-nav__link">
-    <span class="md-ellipsis">
-      SpiceDB (authorization.spicedb)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#custom-response-features-response" class="md-nav__link">
-    <span class="md-ellipsis">
-      Custom response features (response)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Custom response features (response)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#custom-response-forms-successful-authorization-vs-custom-denial-status" class="md-nav__link">
-    <span class="md-ellipsis">
-      Custom response forms: successful authorization vs custom denial status
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Custom response forms: successful authorization vs custom denial status">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#added-http-headers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Added HTTP headers
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#envoy-dynamic-metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      Envoy Dynamic Metadata
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#custom-denial-status-responseunauthenticated-and-responseunauthorized" class="md-nav__link">
-    <span class="md-ellipsis">
-      Custom denial status (response.unauthenticated and response.unauthorized)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#custom-response-methods" class="md-nav__link">
-    <span class="md-ellipsis">
-      Custom response methods
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Custom response methods">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#plain-text-responsesuccessheadersdynamicmetadataplain" class="md-nav__link">
-    <span class="md-ellipsis">
-      Plain text (response.success.&lt;headers|dynamicMetadata&gt;.plain)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#json-injection-responsesuccessheadersdynamicmetadatajson" class="md-nav__link">
-    <span class="md-ellipsis">
-      JSON injection (response.success.&lt;headers|dynamicMetadata&gt;.json)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband" class="md-nav__link">
-    <span class="md-ellipsis">
-      Festival Wristband tokens (response.success.&lt;headers|dynamicMetadata&gt;.wristband)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#callbacks-callbacks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Callbacks (callbacks)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Callbacks (callbacks)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#http-endpoints-callbackshttp" class="md-nav__link">
-    <span class="md-ellipsis">
-      HTTP endpoints (callbacks.http)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-priorities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: Priorities
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-conditions-when" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: Conditions (when)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-caching-cache" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: Caching (cache)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-metrics-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: Metrics (metrics)
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-json-paths-selector" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: JSON paths (selector)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Common feature: JSON paths (selector)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#syntax" class="md-nav__link">
-    <span class="md-ellipsis">
-      Syntax
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#string-modifiers" class="md-nav__link">
-    <span class="md-ellipsis">
-      String modifiers
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#interpolation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Interpolation
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#identity-verification-authentication-features-authentication" class="md-nav__link">
-    <span class="md-ellipsis">
-      Identity verification &amp; authentication features (authentication)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Identity verification & authentication features (authentication)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-key-authenticationapikey" class="md-nav__link">
-    <span class="md-ellipsis">
-      API key (authentication.apiKey)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kubernetes-tokenreview-authenticationkubernetestokenreview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kubernetes TokenReview (authentication.kubernetesTokenReview)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#jwt-verification-authenticationjwt" class="md-nav__link">
-    <span class="md-ellipsis">
-      JWT verification (authentication.jwt)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#oauth-20-introspection-authenticationoauth2introspection" class="md-nav__link">
-    <span class="md-ellipsis">
-      OAuth 2.0 introspection (authentication.oauth2Introspection)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#x509-client-certificate-authentication-authenticationx509" class="md-nav__link">
-    <span class="md-ellipsis">
-      X.509 client certificate authentication (authentication.x509)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#plain-authenticationplain" class="md-nav__link">
-    <span class="md-ellipsis">
-      Plain (authentication.plain)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#anonymous-access-authenticationanonymous" class="md-nav__link">
-    <span class="md-ellipsis">
-      Anonymous access (authentication.anonymous)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#festival-wristband-authentication" class="md-nav__link">
-    <span class="md-ellipsis">
-      Festival Wristband authentication
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#extra-auth-credentials-authenticationcredentials" class="md-nav__link">
-    <span class="md-ellipsis">
-      Extra: Auth credentials (authentication.credentials)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#extra-identity-extension-authenticationdefaults-and-authenticationoverrides" class="md-nav__link">
-    <span class="md-ellipsis">
-      Extra: Identity extension (authentication.defaults and authentication.overrides)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#external-auth-metadata-features-metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      External auth metadata features (metadata)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="External auth metadata features (metadata)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#http-getget-by-post-metadatahttp" class="md-nav__link">
-    <span class="md-ellipsis">
-      HTTP GET/GET-by-POST (metadata.http)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#oidc-userinfo-metadatauserinfo" class="md-nav__link">
-    <span class="md-ellipsis">
-      OIDC UserInfo (metadata.userInfo)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#user-managed-access-uma-resource-registry-metadatauma" class="md-nav__link">
-    <span class="md-ellipsis">
-      User-Managed Access (UMA) resource registry (metadata.uma)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#authorization-features-authorization" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authorization features (authorization)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Authorization features (authorization)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#pattern-matching-authorization-authorizationpatternmatching" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pattern-matching authorization (authorization.patternMatching)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#open-policy-agent-opa-rego-policies-authorizationopa" class="md-nav__link">
-    <span class="md-ellipsis">
-      Open Policy Agent (OPA) Rego policies (authorization.opa)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kubernetes SubjectAccessReview (authorization.kubernetesSubjectAccessReview)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#spicedb-authorizationspicedb" class="md-nav__link">
-    <span class="md-ellipsis">
-      SpiceDB (authorization.spicedb)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#custom-response-features-response" class="md-nav__link">
-    <span class="md-ellipsis">
-      Custom response features (response)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Custom response features (response)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#custom-response-forms-successful-authorization-vs-custom-denial-status" class="md-nav__link">
-    <span class="md-ellipsis">
-      Custom response forms: successful authorization vs custom denial status
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Custom response forms: successful authorization vs custom denial status">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#added-http-headers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Added HTTP headers
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#envoy-dynamic-metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      Envoy Dynamic Metadata
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#custom-denial-status-responseunauthenticated-and-responseunauthorized" class="md-nav__link">
-    <span class="md-ellipsis">
-      Custom denial status (response.unauthenticated and response.unauthorized)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#custom-response-methods" class="md-nav__link">
-    <span class="md-ellipsis">
-      Custom response methods
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Custom response methods">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#plain-text-responsesuccessheadersdynamicmetadataplain" class="md-nav__link">
-    <span class="md-ellipsis">
-      Plain text (response.success.&lt;headers|dynamicMetadata&gt;.plain)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#json-injection-responsesuccessheadersdynamicmetadatajson" class="md-nav__link">
-    <span class="md-ellipsis">
-      JSON injection (response.success.&lt;headers|dynamicMetadata&gt;.json)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband" class="md-nav__link">
-    <span class="md-ellipsis">
-      Festival Wristband tokens (response.success.&lt;headers|dynamicMetadata&gt;.wristband)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#callbacks-callbacks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Callbacks (callbacks)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Callbacks (callbacks)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#http-endpoints-callbackshttp" class="md-nav__link">
-    <span class="md-ellipsis">
-      HTTP endpoints (callbacks.http)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-priorities" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: Priorities
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-conditions-when" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: Conditions (when)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-caching-cache" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: Caching (cache)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#common-feature-metrics-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common feature: Metrics (metrics)
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/features.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="features">Features<a class="headerlink" href="#features" title="Permanent link">&para;</a></h1>
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>We call <em>features</em> of Authorino the different things one can do to enforce identity verification &amp; authentication and authorization on requests to protected services. These can be a specific identity verification method based on a supported authentication protocol, or a method to fetch additional auth metadata in request-time, etc.</p>
-<p>Most features of Authorino relate to the different phases of the <a href="../architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a> and therefore are configured in the Authorino <a href="../architecture/#the-authorino-authconfig-custom-resource-definition-crd"><code>AuthConfig</code></a>. An <em>identity verification/authentication feature</em> usually refers to a functionality of Authorino such as the <a href="#api-key-authenticationapikey">API key-based authentication</a>, the <a href="#jwt-verification-authenticationjwt">validation of JWTs/OIDC ID tokens</a>, and authentication based on <a href="#kubernetes-tokenreview-authenticationkubernetestokenreview">Kubernetes TokenReviews</a>. Analogously, <a href="#open-policy-agent-opa-rego-policies-authorizationopa">OPA</a>, <a href="#pattern-matching-authorization-authorizationpatternmatching">pattern-matching</a> and <a href="#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview">Kubernetes SubjectAccessReview</a> are examples of <em>authorization features</em> of Authorino.</p>
-<p>At a deeper level, a <em>feature</em> can also be an additional functionality within a bigger feature, usually applicable to the whole class the bigger feature belongs to. For instance, the configuration of how <a href="#extra-auth-credentials-authenticationcredentials">auth credentials</a> expected to be carried in the request, which is broadly available for any identity verification method. Other examples are: <a href="#extra-identity-extension-authenticationdefaults-and-authenticationoverrides"><em>Identity extension</em></a> and <a href="#common-feature-priorities">Priorities</a>.</p>
-<p>A full specification of all features of Authorino that can be configured in an <code>AuthConfig</code> can be found in the official <a href="https://github.com/Kuadrant/authorino/blob/main/install/crd/authorino.kuadrant.io_authconfigs.yaml">spec</a> of the custom resource definition.</p>
-<p>You can also learn about Authorino features by using the <a href="https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#explain"><code>kubectl explain</code></a> command in a Kubernetes cluster where the Authorino CRD has been installed. E.g. <code>kubectl explain authconfigs.spec.authentication.credentials</code>.</p>
-<h2 id="common-feature-json-paths-selector">Common feature: JSON paths (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#ValueOrSelector"><code>selector</code></a>)<a class="headerlink" href="#common-feature-json-paths-selector" title="Permanent link">&para;</a></h2>
-<p>The first feature of Authorino to learn about is a common functionality used in the specification of many other features. <em>JSON paths</em> are selectors of data from the <a href="../architecture/#the-authorization-json">Authorization JSON</a> used in parts of an AuthConfig for referring to dynamic values of each authorization request.</p>
-<p>Usage examples of JSON paths are: dynamic URLs and request parameters when fetching metadata from external sources, dynamic authorization policy rules, and dynamic authorization response attributes (e.g. injected HTTP headers, Festival Wristband token claims, etc).</p>
-<h3 id="syntax">Syntax<a class="headerlink" href="#syntax" title="Permanent link">&para;</a></h3>
-<p>The syntax to fetch data from the Authorization JSON with JSON paths is based on <a href="https://pkg.go.dev/github.com/tidwall/gjson">GJSON</a>. Refer to <a href="https://github.com/tidwall/gjson/blob/master/SYNTAX.md">GJSON Path Syntax</a> page for more information.</p>
-<h3 id="string-modifiers">String modifiers<a class="headerlink" href="#string-modifiers" title="Permanent link">&para;</a></h3>
-<p>On top of GJSON, Authorino defines a few <a href="https://github.com/tidwall/gjson/blob/master/SYNTAX.md#modifiers">string modifiers</a>.</p>
-<p>Examples below provided for the following Authorization JSON:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>{
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>  &quot;context&quot;: {
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>    &quot;request&quot;: {
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>      &quot;http&quot;: {
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>        &quot;path&quot;: &quot;/pets/123&quot;,
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>        &quot;headers&quot;: {
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>          &quot;authorization&quot;: &quot;Basic amFuZTpzZWNyZXQK&quot; // jane:secret
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>          &quot;baggage&quot;: &quot;eyJrZXkxIjoidmFsdWUxIn0=&quot; // {&quot;key1&quot;:&quot;value1&quot;}
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>        }
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>      }
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>    }
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>  },
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>  &quot;auth&quot;: {
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>    &quot;identity&quot;: {
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>      &quot;username&quot;: &quot;jane&quot;,
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>      &quot;fullname&quot;: &quot;Jane Smith&quot;,
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>      &quot;email&quot;: &quot;\u0006jane\u0012@petcorp.com\n&quot;
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>    },
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>  },
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>}
-</span></code></pre></div>
-<p><strong><code>@strip</code></strong><br/>
-Strips out any non-printable characters such as carriage return. E.g. <code>auth.identity.email.@strip</code> → <code>"jane@petcorp.com"</code>.</p>
-<p><strong><code>@case:upper|lower</code></strong><br/>
-Changes the case of a string. E.g. <code>auth.identity.username.@case:upper</code> → <code>"JANE"</code>.</p>
-<p><strong><code>@replace:{"old":string,"new":string}</code></strong><br/>
-Replaces a substring within a string. E.g. <code>auth.identity.username.@replace:{"old":"Smith","new":"Doe"}</code> → <code>"Jane Doe"</code>.</p>
-<p><strong><code>@extract:{"sep":string,"pos":int}</code></strong><br/>
-Splits a string at occurrences of a separator (default: <code>" "</code>) and selects the substring at the <code>pos</code>-th position (default: <code>0</code>). E.g. <code>context.request.path.@extract:{"sep":"/","pos":2}</code> → <code>123</code>.</p>
-<p><strong><code>@base64:encode|decode</code></strong><br/>
-base64-encodes or decodes a string value. E.g. <code>auth.identity.username.decoded.@base64:encode</code> → <code>"amFuZQo="</code>.<br/></p>
-<p>In combination with <code>@extract</code>, <code>@base64</code> can be used to extract the username in an HTTP Basic Authentication request. E.g. <code>context.request.headers.authorization.@extract:{"pos":1}|@base64:decode|@extract:{"sep":":","pos":1}</code> → <code>"jane"</code>.</p>
-<h3 id="interpolation">Interpolation<a class="headerlink" href="#interpolation" title="Permanent link">&para;</a></h3>
-<p><em>JSON paths</em> can be interpolated into strings to build template-like dynamic values. E.g. <code>"Hello, {auth.identity.name}!"</code>.</p>
-<h2 id="identity-verification-authentication-features-authentication">Identity verification &amp; authentication features (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#AuthenticationSpec"><code>authentication</code></a>)<a class="headerlink" href="#identity-verification-authentication-features-authentication" title="Permanent link">&para;</a></h2>
-<h3 id="api-key-authenticationapikey">API key (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#ApiKeyAuthenticationSpec"><code>authentication.apiKey</code></a>)<a class="headerlink" href="#api-key-authenticationapikey" title="Permanent link">&para;</a></h3>
-<p>Authorino relies on Kubernetes <code>Secret</code> resources to represent API keys.</p>
-<p>To define an API key, create a <code>Secret</code> in the cluster containing an <code>api_key</code> entry that holds the value of the API key.</p>
-<p>API key secrets must be created in the same namespace of the <code>AuthConfig</code> (default) or <code>spec.authentication.apiKey.allNamespaces</code> must be set to <code>true</code> (only works with <a href="../architecture/#cluster-wide-vs-namespaced-instances">cluster-wide Authorino instances</a>).</p>
-<p>API key secrets must be labeled with the labels that match the selectors specified in <code>spec.authentication.apiKey.selector</code> in the <code>AuthConfig</code>.</p>
-<p>Whenever an <code>AuthConfig</code> is indexed, Authorino will also index all matching API key secrets. In order for Authorino to also watch events related to API key secrets individually (e.g. new <code>Secret</code> created, updates, deletion/revocation), <code>Secret</code>s must also include a label that matches Authorino's bootstrap configuration <code>--secret-label-selector</code> (default: <code>authorino.kuadrant.io/managed-by=authorino</code>). This label may or may not be present to <code>spec.authentication.apiKey.selector</code> in the <code>AuthConfig</code> without implications for the caching of the API keys when triggered by the reconciliation of the <code>AuthConfig</code>; however, if not present, individual changes related to the API key secret (i.e. without touching the <code>AuthConfig</code>) will be ignored by the reconciler.</p>
-<p><strong>Example.</strong> For the following <code>AuthConfig</code>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api-protection</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino-system</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api.io</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">    </span><span class="s">&quot;api-key-users&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">      </span><span class="nt">apiKey</span><span class="p">:</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">        </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w">          </span><span class="nt">matchLabels</span><span class="p">:</span><span class="w"> </span><span class="c1"># the key-value set used to select the matching `Secret`s; resources including these labels will be accepted as valid API keys to authenticate to this service</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w">            </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">friends</span><span class="w"> </span><span class="c1"># some custom label</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w">        </span><span class="nt">allNamespaces</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span><span class="w"> </span><span class="c1"># only works with cluster-wide Authorino instances; otherwise, create the API key secrets in the same namespace of the AuthConfig</span>
-</span></code></pre></div>
-<p>The following Kubernetes <code>Secret</code> represents a valid API key:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">user-1-api-key-1</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">    </span><span class="nt">authorino.kuadrant.io/managed-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span><span class="w"> </span><span class="c1"># so the Authorino controller reconciles events related to this secret</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">friends</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="nt">stringData</span><span class="p">:</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">  </span><span class="nt">api_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;some-randomly-generated-api-key-value&gt;</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span>
-</span></code></pre></div>
-<p>The resolved identity object, added to the authorization JSON following an API key identity source evaluation, is the Kubernetes <code>Secret</code> resource (as JSON).</p>
-<h3 id="kubernetes-tokenreview-authenticationkubernetestokenreview">Kubernetes TokenReview (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#KubernetesTokenReviewSpec"><code>authentication.kubernetesTokenReview</code></a>)<a class="headerlink" href="#kubernetes-tokenreview-authenticationkubernetestokenreview" title="Permanent link">&para;</a></h3>
-<p>Authorino can verify Kubernetes-valid access tokens (using Kubernetes <a href="https://kubernetes.io/docs/reference/kubernetes-api/authentication-resources/token-review-v1">TokenReview</a> API).</p>
-<p>These tokens can be either <code>ServiceAccount</code> tokens such as the ones issued by kubelet as part of Kubernetes <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection">Service Account Token Volume Projection</a>, or any valid user access tokens issued to users of the Kubernetes server API.</p>
-<p>The list of <code>audiences</code> of the token must include the requested host and port of the protected API (default), or all audiences specified in the Authorino <code>AuthConfig</code> custom resource. For example:</p>
-<p>For the following <code>AuthConfig</code> CR, the Kubernetes token must include the audience <code>my-api.io</code>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api-protection</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api.io</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">    </span><span class="s">&quot;cluster-users&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">      </span><span class="nt">kubernetesTokenReview</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span></code></pre></div>
-<p>Whereas for the following <code>AuthConfig</code> CR, the Kubernetes token audiences must include <strong>foo</strong> and <strong>bar</strong>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api-protection</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api.io</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="w">    </span><span class="s">&quot;cluster-users&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="w">      </span><span class="nt">kubernetesTokenReview</span><span class="p">:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="w">        </span><span class="nt">audiences</span><span class="p">:</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">foo</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">bar</span>
-</span></code></pre></div>
-<p>The resolved identity object added to the authorization JSON following a successful Kubernetes authentication identity evaluation is the <code>status</code> field of TokenReview response (see <a href="https://kubernetes.io/docs/reference/kubernetes-api/authentication-resources/token-review-v1/#TokenReviewStatus">TokenReviewStatus</a> for reference).</p>
-<h3 id="jwt-verification-authenticationjwt">JWT verification (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#JwtAuthenticationSpec"><code>authentication.jwt</code></a>)<a class="headerlink" href="#jwt-verification-authenticationjwt" title="Permanent link">&para;</a></h3>
-<p>In reconciliation-time, using <a href="https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfig">OpenID Connect Discovery well-known endpoint</a>, Authorino automatically discovers and caches OpenID Connect configurations and associated JSON Web Key Sets (JWKS) for all OpenID Connect issuers declared in an <code>AuthConfig</code>. Then, in request-time, Authorino verifies the JSON Web Signature (JWS) and check the time validity of signed JSON Web Tokens (JWT) supplied on each request.</p>
-<p><em>Important!</em> Authorino does <strong>not</strong> implement <a href="https://datatracker.ietf.org/doc/html/rfc6749#section-4">OAuth2 grants</a> nor <a href="https://openid.net/specs/openid-connect-core-1_0.html#Authentication">OIDC authentication flows</a>. As a common recommendation of good practice, obtaining and refreshing access tokens is for clients to negotiate directly with the auth servers and token issuers. Authorino will only validate those tokens using the parameters provided by the trusted issuer authorities.</p>
-<p><img alt="OIDC" src="http://www.plantuml.com/plantuml/png/XO_1IWD138RlynIX9mLt7s1XfQANseDGnPx7sMmtE9EqcOpQjtUeWego7aF-__lubzcyMadHvMVYlLUV80bBc5GIWcb1v_eUDXY40qNoHiADKNtslRigDeaI2pINiBXRtLp3AkU2ke0EJkT0ESWBwj7zV3UryDNkO8inDckMLuPg6cddM0mXucWT11ycd9TjyF0X3AYM_v7TRjVtl_ckRTlFiOU2sVvU-PtpY4hZiU8U8DEElHN5cRIFD7Z3K_uCt_ONm4_ZkLiY3oN5Tm00" /></p>
-<p>The <code>kid</code> claim stated in the JWT header must match one of the keys cached by Authorino during OpenID Connect Discovery, therefore supporting JWK rotation.</p>
-<p>The decoded payload of the validated JWT is appended to the authorization JSON as the resolved identity.</p>
-<p>OpenID Connect configurations and linked JSON Web Key Sets can be configured to be automatically refreshed (pull again from the OpenID Connect Discovery well-known endpoints), by setting the <code>authentication.jwt.ttl</code> field (given in seconds, default: <code>0</code> – i.e. auto-refresh disabled).</p>
-<p>For an excellent summary of the underlying concepts and standards that relate OpenID Connect and JSON Object Signing and Encryption (JOSE), see this <a href="https://access.redhat.com/blogs/766093/posts/1976593">article</a> by Jan Rusnacko. For official specification and RFCs, see <a href="https://openid.net/specs/openid-connect-core-1_0.html">OpenID Connect Core</a>, <a href="https://openid.net/specs/openid-connect-discovery-1_0.html">OpenID Connect Discovery</a>, <a href="https://datatracker.ietf.org/doc/html/rfc7519">JSON Web Token (JWT) (RFC7519)</a>, and <a href="http://www.iana.org/assignments/jose/jose.xhtml">JSON Object Signing and Encryption (JOSE)</a>.</p>
-<h3 id="oauth-20-introspection-authenticationoauth2introspection">OAuth 2.0 introspection (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#OAuth2TokenIntrospectionSpec"><code>authentication.oauth2Introspection</code></a>)<a class="headerlink" href="#oauth-20-introspection-authenticationoauth2introspection" title="Permanent link">&para;</a></h3>
-<p>For bare OAuth 2.0 implementations, Authorino can perform token introspection on the access tokens supplied in the requests to protected APIs.</p>
-<p>Authorino does not implement any of OAuth 2.0 grants for the applications to obtain the token. However, it can verify supplied tokens with the OAuth server, including opaque tokens, as long as the server exposes the <code>token_introspect</code> endpoint (<a href="https://tools.ietf.org/html/rfc7662">RFC 7662</a>).</p>
-<p>Developers must set the token introspection endpoint in the <code>AuthConfig</code>, as well as a reference to the Kubernetes secret storing the credentials of the OAuth client to be used by Authorino when requesting the introspect.</p>
-<p><img alt="OAuth 2.0 Token Introspect" src="http://www.plantuml.com/plantuml/png/NP1DJiD038NtSmehQuQgsr4R5TZ0gXLaHwHgD779g8aTF1xAZv0u3GVZ9BHH18YbttkodxzLKY-Q-ywaVQJ1Y--XP-BG2lS8AXcDkRSbN6HjMIAnWrjyp9ZK_4Xmz8lrQOI4yeHIW8CRKk4qO51GtYCPOaMG-D2gWytwhe9P_8rSLzLcDZ-VrtJ5f4XggvS17VXXw6Bm6fbcp_PmEDWTIs-pT4Y16sngccgyZY47b-W51HQJRqCNJ-k2O9FAcceQsomNsgBr8M1ATbJAoTdgyV2sZQJBHKueji5T96nAy-z5-vSAE7Y38gbNBDo8xGo-FZxXtQoGcYFVRm00" /></p>
-<p>The response returned by the OAuth2 server to the token introspection request is the resolved identity appended to the authorization JSON.</p>
-<h3 id="x509-client-certificate-authentication-authenticationx509">X.509 client certificate authentication (<code>authentication.x509</code>)<a class="headerlink" href="#x509-client-certificate-authentication-authenticationx509" title="Permanent link">&para;</a></h3>
-<p>Authorino can verify X.509 certificates presented by clients for authentication on the request to the protected APIs, at application level.</p>
-<p>Trusted root Certificate Authorities (CA) are stored in Kubernetes Secrets labeled according to selectors specified in the AuthConfig, watched and indexed by Authorino. Make sure to create proper <code>kubernetes.io/tls</code>-typed Kubernetes Secrets, containing the public certificates of the CA stored in either a <code>tls.crt</code> or <code>ca.crt</code> entry inside the secret.</p>
-<p>Trusted root CA secrets must be created in the same namespace of the <code>AuthConfig</code> (default) or <code>spec.authentication.x509.allNamespaces</code> must be set to <code>true</code> (only works with <a href="../architecture/#cluster-wide-vs-namespaced-instances">cluster-wide Authorino instances</a>).</p>
-<p>Client certificates must include x509 v3 extension specifying 'Client Authentication' extended key usage.</p>
-<p>The identity object resolved out of a client x509 certificate is equal to the subject field of the certificate, and it serializes as JSON within the Authorization JSON usually as follows:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>{
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>    &quot;auth&quot;: {
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>        &quot;identity&quot;: {
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>            &quot;CommonName&quot;: &quot;aisha&quot;,
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a>            &quot;Country&quot;: [&quot;PK&quot;],
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>            &quot;ExtraNames&quot;: null,
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a>            &quot;Locality&quot;: [&quot;Islamabad&quot;],
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a>            &quot;Names&quot;: [
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a>                { &quot;Type&quot;: [2, 5, 4, 3], &quot;Value&quot;: &quot;aisha&quot; },
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a>                { &quot;Type&quot;: [2, 5, 4, 6], &quot;Value&quot;: &quot;PK&quot; },
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a>                { &quot;Type&quot;: [2, 5, 4, 7], &quot;Value&quot;: &quot;Islamabad&quot; },
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>                { &quot;Type&quot;: [2, 5, 4,10], &quot;Value&quot;: &quot;ACME Inc.&quot; },
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a>                { &quot;Type&quot;: [2, 5, 4,11], &quot;Value&quot;: &quot;Engineering&quot; }
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a>            ],
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a>            &quot;Organization&quot;: [&quot;ACME Inc.&quot;],
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a>            &quot;OrganizationalUnit&quot;: [&quot;Engineering&quot;],
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a>            &quot;PostalCode&quot;: null,
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a>            &quot;Province&quot;: null,
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a>            &quot;SerialNumber&quot;: &quot;&quot;,
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a>            &quot;StreetAddress&quot;: null
-</span><span id="__span-5-21"><a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a>        }
-</span><span id="__span-5-22"><a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a>  }
-</span><span id="__span-5-23"><a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></a>}
-</span></code></pre></div>
-<h3 id="plain-authenticationplain">Plain (<code>authentication.plain</code>)<a class="headerlink" href="#plain-authenticationplain" title="Permanent link">&para;</a></h3>
-<p>Authorino can read plain identity objects, based on authentication tokens provided and verified beforehand using other means (e.g. Envoy <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/jwt_authn_filter#config-http-filters-jwt-authn">JWT Authentication filter</a>, Kubernetes API server authentication), and injected into the payload to the external authorization service.</p>
-<p>The plain identity object is retrieved from the Authorization JSON based on a <a href="#common-feature-json-paths-selector">JSON path</a> specified in the <code>AuthConfig</code>.</p>
-<p>This feature is particularly useful in cases where authentication/identity verification is handled before invoking the authorization service and its resolved value injected in the payload can be trusted. Examples of applications for this feature include:</p>
-<ul>
-<li>Authentication handled in Envoy leveraging the Envoy JWT Authentication filter (decoded JWT injected as 'metadata_context')</li>
-<li>Use of Authorino as Kubernetes ValidatingWebhook service (Kubernetes 'userInfo' injected in the body of the <code>AdmissionReview</code> request)</li>
-</ul>
-<p>Example of <code>AuthConfig</code> to retrieve plain identity object from the Authorization JSON.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w">    </span><span class="s">&quot;pre-validated-jwt&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">      </span><span class="nt">plain</span><span class="p">:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">        </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.metadata_context.filter_metadata.envoy\.filters\.http\.jwt_authn|verified_jwt</span>
-</span></code></pre></div>
-<p>If the specified JSON path does not exist in the Authorization JSON or the value is <code>null</code>, the identity verification will fail and, unless other identity config succeeds, Authorino will halt the Auth Pipeline with the usual <code>401 Unauthorized</code>.</p>
-<h3 id="anonymous-access-authenticationanonymous">Anonymous access (<code>authentication.anonymous</code>)<a class="headerlink" href="#anonymous-access-authenticationanonymous" title="Permanent link">&para;</a></h3>
-<p>Literally a no-op evaluator for the identity verification phase that returns a static identity object <code>{"anonymous":true}</code>.</p>
-<p>It allows to implement <code>AuthConfigs</code> that bypasses the identity verification phase of Authorino, to such as:</p>
-<ul>
-<li>enable anonymous access to protected services (always or combined with <a href="#common-feature-priorities">Priorities</a>)</li>
-<li>postpone authentication in the Auth Pipeline to be resolved as part of an OPA policy</li>
-</ul>
-<p>Example of <code>AuthConfig</code> spec that falls back to anonymous access when OIDC authentication fails, enforcing read-only access to the protected service in such cases:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w">    </span><span class="s">&quot;jwt&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w">      </span><span class="nt">jwt</span><span class="p">:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w">        </span><span class="nt">issuerUrl</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;…&quot;</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="w">    </span><span class="s">&quot;anonymous&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w">      </span><span class="nt">priority</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span><span class="w"> </span><span class="c1"># expired oidc token, missing creds, etc. default to anonymous access</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w">      </span><span class="nt">anonymous</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w">    </span><span class="s">&quot;read-only-access-if-authn-fails&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.anonymous</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="w">          </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;true&quot;</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="w">      </span><span class="nt">patternMatching</span><span class="p">:</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="w">        </span><span class="nt">patterns</span><span class="p">:</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="w">          </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span></code></pre></div>
-<h3 id="festival-wristband-authentication">Festival Wristband authentication<a class="headerlink" href="#festival-wristband-authentication" title="Permanent link">&para;</a></h3>
-<p>Authorino-issued <a href="#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristband</a> tokens can be validated as any other signed JWT using Authorino's <a href="#jwt-verification-authenticationjwt">JWT verification</a>.</p>
-<p>The value of the issuer must be the same issuer specified in the custom resource for the protected API originally issuing wristband. Eventually, this can be the same custom resource where the wristband is configured as a valid source of identity, but not necessarily.</p>
-<h3 id="extra-auth-credentials-authenticationcredentials"><em>Extra:</em> Auth credentials (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#Credentials"><code>authentication.credentials</code></a>)<a class="headerlink" href="#extra-auth-credentials-authenticationcredentials" title="Permanent link">&para;</a></h3>
-<p>All the identity verification methods supported by Authorino can be configured regarding the location where access tokens and credentials (i.e. authentication secrets) fly within the request.</p>
-<p>By default, authentication secrets are expected to be supplied in the <code>Authorization</code> HTTP header, with the default <code>Bearer</code> prefix and the plain authentication secret separated by space.</p>
-<p>The full list of supported options is exemplified below:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="w">    </span><span class="s">&quot;creds-in-the-authz-header&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w">      </span><span class="nt">credentials</span><span class="p">:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w">        </span><span class="nt">authorizationHeader</span><span class="p">:</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w">          </span><span class="nt">prefix</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">JWT</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">    </span><span class="s">&quot;creds-in-a-custom-header&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">      </span><span class="nt">credentials</span><span class="p">:</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">        </span><span class="nt">customHeader</span><span class="p">:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w">          </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">X-MY-CUSTOM-HEADER</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w">          </span><span class="nt">prefix</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;&quot;</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="w">    </span><span class="s">&quot;creds-in-a-query-param&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="w">      </span><span class="nt">queryString</span><span class="p">:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my_param</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="w">    </span><span class="s">&quot;creds-in-a-cookie-entry&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="w">      </span><span class="nt">cookie</span><span class="p">:</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cookie-key</span>
-</span></code></pre></div>
-<h3 id="extra-identity-extension-authenticationdefaults-and-authenticationoverrides"><em>Extra:</em> Identity extension (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#ExtendedProperties"><code>authentication.defaults</code></a> and <a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#ExtendedProperties"><code>authentication.overrides</code></a>)<a class="headerlink" href="#extra-identity-extension-authenticationdefaults-and-authenticationoverrides" title="Permanent link">&para;</a></h3>
-<p>Resolved identity objects can be extended with user-defined JSON properties. Values can be static or fetched from the Authorization JSON.</p>
-<p>A typical use-case for this feature is token normalization. Say you have more than one identity source listed in your <code>AuthConfig</code> but each source issues an access token with a different JSON structure – e.g. two OIDC issuers that use different names for custom JWT claims of similar meaning; when two different identity verification/authentication methods are combined, such as API keys (whose identity objects are the corresponding Kubernetes <code>Secret</code>s) and Kubernetes tokens (whose identity objects are Kubernetes UserInfo data).</p>
-<p>In such cases, identity extension can be used to normalize the token to always include the same set of JSON properties of interest, regardless of the source of identity that issued the original token verified by Authorino. This simplifies the writing of authorization policies and configuration of dynamic responses.</p>
-<p>In case of extending an existing property of the identity object (replacing), the API allows to control whether to overwrite the value or not. This is particularly useful for normalizing tokens of a same identity source that nonetheless may occasionally differ in structure, such as in the case of JWT claims that sometimes may not be present but can be safely replaced with another (e.g. <code>username</code> or <code>sub</code>).</p>
-<h2 id="external-auth-metadata-features-metadata">External auth metadata features (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#Metadata"><code>metadata</code></a>)<a class="headerlink" href="#external-auth-metadata-features-metadata" title="Permanent link">&para;</a></h2>
-<h3 id="http-getget-by-post-metadatahttp">HTTP GET/GET-by-POST (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#HttpEndpointSpec"><code>metadata.http</code></a>)<a class="headerlink" href="#http-getget-by-post-metadatahttp" title="Permanent link">&para;</a></h3>
-<p>Generic HTTP adapter that sends a request to an external service. It can be used to fetch external metadata for the authorization policies (phase ii of the Authorino <a href="../architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a>), or as a web hook.</p>
-<p>The adapter allows issuing requests either by GET or POST methods; in both cases with URL and parameters defined by the user in the spec. Dynamic values fetched from the Authorization JSON can be used.</p>
-<p>POST request parameters as well as the encoding of the content can be controlled using the <code>bodyParameters</code> and <code>contentType</code> fields of the config, respectively. The Content-Type of POST requests can be either <code>application/x-www-form-urlencoded</code> (default) or <code>application/json</code>.</p>
-<p>Authentication of Authorino with the external metadata server can be set either via long-lived shared secret stored in a Kubernetes Secret or via OAuth2 client credentials grant. For long-lived shared secret, set the <code>sharedSecretRef</code> field. For OAuth2 client credentials grant, use the <code>oauth2</code> option.</p>
-<p>In both cases, the location where the secret (long-lived or OAuth2 access token) travels in the request performed to the external HTTP service can be specified in the <a href="#extra-auth-credentials-authenticationcredentials"><code>credentials</code></a> field. By default, the authentication secret is supplied in the <code>Authorization</code> header with the <code>Bearer</code> prefix.</p>
-<p>Custom headers can be set with the <code>headers</code> field. Nevertheless, headers such as <code>Content-Type</code> and <code>Authorization</code> (or eventual custom header used for carrying the authentication secret, set instead via the <code>credentials</code> option) will be superseded by the respective values defined for the fields <code>contentType</code> and <code>sharedSecretRef</code>.</p>
-<h3 id="oidc-userinfo-metadatauserinfo">OIDC UserInfo (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#UserInfoMetadataSpec"><code>metadata.userInfo</code></a>)<a class="headerlink" href="#oidc-userinfo-metadatauserinfo" title="Permanent link">&para;</a></h3>
-<p>Online fetching of OpenID Connect (OIDC) UserInfo data (phase ii of the Authorino <a href="../architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a>), associated with an OIDC identity source configured and resolved in phase (i).</p>
-<p>Apart from possibly complementing information of the JWT, fetching OpenID Connect UserInfo in request-time can be particularly useful for remote checking the state of the session, as opposed to only verifying the JWT/JWS offline.</p>
-<p>Implementation requires a JWT verification authentication config (<a href="#jwt-verification-authenticationjwt"><code>spec.authentication.jwt</code></a>) in the same <code>AuthConfig</code>, so the well-known configuration of the OpenId Connect (OIDC) issuer can be reused.</p>
-<p>The response returned by the OIDC server to the UserInfo request is appended (as JSON) to <code>auth.metadata</code> in the authorization JSON.</p>
-<h3 id="user-managed-access-uma-resource-registry-metadatauma">User-Managed Access (UMA) resource registry (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#UmaMetadataSpec"><code>metadata.uma</code></a>)<a class="headerlink" href="#user-managed-access-uma-resource-registry-metadatauma" title="Permanent link">&para;</a></h3>
-<p>User-Managed Access (UMA) is an OAuth-based protocol for resource owners to allow other users to access their resources. Since the UMA-compliant server is expected to know about the resources, Authorino includes a client that fetches resource data from the server and adds that as metadata of the authorization payload.</p>
-<p>This enables the implementation of resource-level Attribute-Based Access Control (ABAC) policies. Attributes of the resource fetched in a UMA flow can be, e.g., the owner of the resource, or any business-level attributes stored in the UMA-compliant server.</p>
-<p>A UMA-compliant server is an external authorization server (e.g., Keycloak) where the protected resources are registered. It can be as well the upstream API itself, as long as it implements the UMA protocol, with initial authentication by <code>client_credentials</code> grant to exchange for a Protected API Token (PAT).</p>
-<p><img alt="UMA" src="http://www.plantuml.com/plantuml/png/ZOx1IWCn48RlUOgX9pri7w0GxOBYGGGj5G_Y8QHJTp2PgPE9qhStmhBW9NWSvll__ziM2ser9rS-Y4z1GuOiB75IoGYc5Ptp7dOOXICb2aR2Wr5xUk_6QfCeiS1m1QldXn4AwXVg2ZRmUzrGYTBki_lp71gzH1lwWYaDzopV357uIE-EnH0I7cq3CSG9dLklrxF9PyLY_rAOMNWSzts11dIBdYhg6HIBL8rOuEAwAlbJiEcoN_pQj9VOMtVZxdQ_BFHBTpC5Xs31RP4FDQSV" /></p>
-<p>It's important to notice that Authorino does NOT manage resources in the UMA-compliant server. As shown in the flow above, Authorino's UMA client is only to fetch data about the requested resources. Authorino exchanges client credentials for a Protected API Token (PAT), then queries for resources whose URI match the path of the HTTP request (as passed to Authorino by the Envoy proxy) and fetches data of each matching resource.</p>
-<p>The resources data is added as metadata of the authorization payload and passed as input for the configured authorization policies. All resources returned by the UMA-compliant server in the query by URI are passed along. They are available in the PDPs (authorization payload) as <code>input.auth.metadata.custom-name =&gt; Array</code>. (See <a href="../architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">The "Auth Pipeline"</a> for details.)</p>
-<h2 id="authorization-features-authorization">Authorization features (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#Authorization"><code>authorization</code></a>)<a class="headerlink" href="#authorization-features-authorization" title="Permanent link">&para;</a></h2>
-<h3 id="pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#PatternMatchingAuthorizationSpec"><code>authorization.patternMatching</code></a>)<a class="headerlink" href="#pattern-matching-authorization-authorizationpatternmatching" title="Permanent link">&para;</a></h3>
-<p>Grant/deny access based on simple pattern-matching expressions ("patterns") compared against values selected from the Authorization JSON.</p>
-<p>Each expression is a tuple composed of:</p>
-<ul>
-<li>a <code>selector</code>, to fetch from the Authorization JSON – see <a href="#common-feature-json-paths-selector">Common feature: JSON paths</a> for details about syntax;</li>
-<li>an <code>operator</code> – <code>eq</code> (<em>equals</em>), <code>neq</code> (<em>not equal</em>); <code>incl</code> (<em>includes</em>) and <code>excl</code> (<em>excludes</em>), for arrays; and <code>matches</code>, for regular expressions;</li>
-<li>a fixed comparable <code>value</code></li>
-</ul>
-<p>Rules can mix and combine literal expressions and references to expression sets ("named patterns") defined at the upper level of the <code>AuthConfig</code> spec. (See <a href="#common-feature-conditions-when">Common feature: Conditions</a>)</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w">    </span><span class="s">&quot;my-simple-json-pattern-matching-policy&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">      </span><span class="nt">patternMatching</span><span class="p">:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w">        </span><span class="nt">patterns</span><span class="p">:</span><span class="w"> </span><span class="c1"># All patterns must match for access to be granted</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.email_verified</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w">          </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;true&quot;</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">patternRef</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="w">  </span><span class="nt">patterns</span><span class="p">:</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="w">    </span><span class="nt">admin</span><span class="p">:</span><span class="w"> </span><span class="c1"># a named pattern that can be reused in other sets of rules or conditions</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a>
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.roles</span>
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">incl</span>
-</span><span id="__span-9-17"><a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span></code></pre></div>
-<h3 id="open-policy-agent-opa-rego-policies-authorizationopa">Open Policy Agent (OPA) Rego policies (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#OpaAuthorizationSpec"><code>authorization.opa</code></a>)<a class="headerlink" href="#open-policy-agent-opa-rego-policies-authorizationopa" title="Permanent link">&para;</a></h3>
-<p>You can model authorization policies in <a href="https://www.openpolicyagent.org/docs/latest/policy-language/">Rego language</a> and add them as part of the protection of your APIs.</p>
-<p>Policies can be either declared in-line in Rego language (<code>rego</code>) or as an HTTP endpoint where Authorino will fetch the source code of the policy in reconciliation-time (<code>externalPolicy</code>).</p>
-<p>Policies pulled from external registries can be configured to be automatically refreshed (pulled again from the external registry), by setting the <code>authorization.opa.externalPolicy.ttl</code> field (given in seconds, default: <code>0</code> – i.e. auto-refresh disabled).</p>
-<p>Authorino's built-in OPA module precompiles the policies during reconciliation of the AuthConfig and caches the precompiled policies for fast evaluation in runtime, where they receive the Authorization JSON as input.</p>
-<p><img alt="OPA" src="http://www.plantuml.com/plantuml/png/TP71IWD138RlynHXJmfklHTMMaKyMle6OPgwmKoopcQiHNntjqjTc8F79D__vm_PZ8xPIv8mlhCEc351ChNOPqi4dWk5CBMT8m-e3jlYlMLM0nm1_ueAQHuBYxUiyBhRDXVE1go9dGd7CsHwuz7p-G8jHGXT1tkAff65qTcqTKu4NHUMXT0-B09OmmrzEML5WM5sleLT4GaBqKxuegrTfcoJmNucAL_ruT9TXa-M1XQgPfMXcXC87NqD4MDF8QnMg-iT7uL6hm-eLx-Gmy5YIQGE9_OUM8VYTOJdJvI2_d-6YVc61aNirApdlzqVKKQwWoaA_8GDwQ4a-GK0" /></p>
-<p>An optional field <code>allValues: boolean</code> makes the values of all rules declared in the Rego document to be returned in the OPA output after policy evaluation. When disabled (default), only the boolean value <code>allow</code> is returned. Values of internal rules of the Rego document can be referenced in subsequent policies/phases of the Auth Pipeline.</p>
-<h3 id="kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview">Kubernetes SubjectAccessReview (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#KubernetesSubjectAccessReviewAuthorizationSpec"><code>authorization.kubernetesSubjectAccessReview</code></a>)<a class="headerlink" href="#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview" title="Permanent link">&para;</a></h3>
-<p>Access control enforcement based on rules defined in the Kubernetes authorization system, i.e. <code>Role</code>, <code>ClusterRole</code>, <code>RoleBinding</code> and <code>ClusterRoleBinding</code> resources of Kubernetes RBAC.</p>
-<p>Authorino issues a <a href="https://kubernetes.io/docs/reference/kubernetes-api/authorization-resources/subject-access-review-v1">SubjectAccessReview</a> (SAR) inquiry that checks with the underlying Kubernetes server whether the user can access a particular resource, resource kind or generic URL.</p>
-<p>It supports <strong>resource attributes authorization check</strong> (parameters defined in the <code>AuthConfig</code>) and <strong>non-resource attributes authorization check</strong> (HTTP endpoint inferred from the original request).</p>
-<ul>
-<li>Resource attributes: adequate for permissions set at namespace level, defined in terms of common attributes of operations on Kubernetes resources (namespace, API group, kind, name, subresource, verb)</li>
-<li>Non-resource attributes: adequate for permissions set at cluster scope, defined for protected endpoints of a generic HTTP API (URL path + verb)</li>
-</ul>
-<p>Example of Kubernetes role for resource attributes authorization:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Role</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pet-reader</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">apiGroups</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;pets.io&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="w">  </span><span class="nt">resources</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;pets&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="w">  </span><span class="nt">verbs</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;get&quot;</span><span class="p p-Indicator">]</span>
-</span></code></pre></div>
-<p>Example of Kubernetes cluster role for non-resource attributes authorization:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ClusterRole</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pet-editor</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">nonResourceURLs</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/pets/*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="w">  </span><span class="nt">verbs</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;put&quot;</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">&quot;delete&quot;</span><span class="p p-Indicator">]</span>
-</span></code></pre></div>
-<p>Kubernetes' authorization policy configs look like the following in an Authorino <code>AuthConfig</code>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="w">  </span><span class="s">&quot;kubernetes-rbac&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="w">    </span><span class="nt">kubernetesSubjectAccessReview</span><span class="p">:</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="w">      </span><span class="nt">user</span><span class="p">:</span><span class="w"> </span><span class="c1"># values of the parameter can be fixed (`value`) or fetched from the Authorization JSON (`selector`)</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="w">        </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.metadata.annotations.userid</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="w">      </span><span class="nt">groups</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span><span class="w"> </span><span class="c1"># user groups to test for.</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="w">      </span><span class="c1"># for resource attributes permission checks; omit it to perform a non-resource attributes SubjectAccessReview with path and method/verb assumed from the original request</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="w">      </span><span class="c1"># if included, use the resource attributes, where the values for each parameter can be fixed (`value`) or fetched from the Authorization JSON (`selector`)</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="w">      </span><span class="nt">resourceAttributes</span><span class="p">:</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="w">        </span><span class="nt">group</span><span class="p">:</span>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pets.io</span><span class="w"> </span><span class="c1"># the api group of the protected resource to be checked for permissions for the user</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="w">        </span><span class="nt">resource</span><span class="p">:</span>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pets</span><span class="w"> </span><span class="c1"># the resource kind</span>
-</span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span>
-</span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path.@extract:{&quot;sep&quot;:&quot;/&quot;,&quot;pos&quot;:2}</span><span class="w"> </span><span class="c1"># resource name – e.g., the {id} in `/pets/{id}`</span>
-</span><span id="__span-12-20"><a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a><span class="w">        </span><span class="nt">verb</span><span class="p">:</span>
-</span><span id="__span-12-21"><a id="__codelineno-12-21" name="__codelineno-12-21" href="#__codelineno-12-21"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method.@case:lower</span><span class="w"> </span><span class="c1"># api operation – e.g., copying from the context to use the same http method of the request</span>
-</span></code></pre></div>
-<p><code>user</code> and properties of <code>resourceAttributes</code> can be defined from fixed values or patterns of the Authorization JSON.</p>
-<p>An array of <code>groups</code> (optional) can as well be set. When defined, it will be used in the <code>SubjectAccessReview</code> request.</p>
-<h3 id="spicedb-authorizationspicedb">SpiceDB (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#SpiceDBAuthorizationSpec"><code>authorization.spicedb</code></a>)<a class="headerlink" href="#spicedb-authorizationspicedb" title="Permanent link">&para;</a></h3>
-<p>Check permission requests via gRPC with an external Google Zanzibar-inspired <a href="https://authzed.com">SpiceDB</a> server, by Authzed.</p>
-<p>Subject, resource and permission parameters can be set to static values or read from the Authorization JSON.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="w">    </span><span class="s">&quot;spicedb&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="w">      </span><span class="nt">spicedb</span><span class="p">:</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="w">        </span><span class="nt">endpoint</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">spicedb:50051</span>
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="w">        </span><span class="nt">insecure</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span><span class="w"> </span><span class="c1"># disables TLS</span>
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="w">        </span><span class="nt">sharedSecretRef</span><span class="p">:</span>
-</span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="w">          </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">spicedb</span>
-</span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="w">          </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">token</span>
-</span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="w">        </span><span class="nt">subject</span><span class="p">:</span>
-</span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="w">          </span><span class="nt">kind</span><span class="p">:</span>
-</span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">blog/user</span>
-</span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="w">          </span><span class="nt">name</span><span class="p">:</span>
-</span><span id="__span-13-14"><a id="__codelineno-13-14" name="__codelineno-13-14" href="#__codelineno-13-14"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.sub</span>
-</span><span id="__span-13-15"><a id="__codelineno-13-15" name="__codelineno-13-15" href="#__codelineno-13-15"></a><span class="w">        </span><span class="nt">resource</span><span class="p">:</span>
-</span><span id="__span-13-16"><a id="__codelineno-13-16" name="__codelineno-13-16" href="#__codelineno-13-16"></a><span class="w">          </span><span class="nt">kind</span><span class="p">:</span>
-</span><span id="__span-13-17"><a id="__codelineno-13-17" name="__codelineno-13-17" href="#__codelineno-13-17"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">blog/post</span>
-</span><span id="__span-13-18"><a id="__codelineno-13-18" name="__codelineno-13-18" href="#__codelineno-13-18"></a><span class="w">          </span><span class="nt">name</span><span class="p">:</span>
-</span><span id="__span-13-19"><a id="__codelineno-13-19" name="__codelineno-13-19" href="#__codelineno-13-19"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path.@extract:{&quot;sep&quot;:&quot;/&quot;,&quot;pos&quot;:2}</span><span class="w"> </span><span class="c1"># /posts/{id}</span>
-</span><span id="__span-13-20"><a id="__codelineno-13-20" name="__codelineno-13-20" href="#__codelineno-13-20"></a><span class="w">        </span><span class="nt">permission</span><span class="p">:</span>
-</span><span id="__span-13-21"><a id="__codelineno-13-21" name="__codelineno-13-21" href="#__codelineno-13-21"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span></code></pre></div>
-<h2 id="custom-response-features-response">Custom response features (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#Response"><code>response</code></a>)<a class="headerlink" href="#custom-response-features-response" title="Permanent link">&para;</a></h2>
-<h3 id="custom-response-forms-successful-authorization-vs-custom-denial-status">Custom response forms: successful authorization vs custom denial status<a class="headerlink" href="#custom-response-forms-successful-authorization-vs-custom-denial-status" title="Permanent link">&para;</a></h3>
-<p>The response to the external authorization request can be customized in the following fashion:</p>
-<ul>
-<li>Successful authorization (<code>response.success</code>)</li>
-<li>Added HTTP headers (<code>response.success.headers</code>)</li>
-<li>Envoy Dynamic Metadata (<code>response.success.dynamicMetadata</code>)</li>
-<li>Custom denial status</li>
-<li>Unauthenticated (<code>response.unauthenticated</code>)</li>
-<li>Unauthorized (<code>response.unauthorized</code>)</li>
-</ul>
-<p>Successful authorization custom responses can be set based on any of the supported custom authorization methods:</p>
-<ul>
-<li>Plain text value</li>
-<li>JSON injection</li>
-<li>Festival Wristband Tokens</li>
-</ul>
-<h4 id="added-http-headers">Added HTTP headers<a class="headerlink" href="#added-http-headers" title="Permanent link">&para;</a></h4>
-<p>Set custom responses as HTTP headers injected in the request post-successful authorization by specifying one of the supported methods under <code>response.success.headers</code>.</p>
-<p>The name of the response config (default) or the value of the <code>key</code> option (if provided) will used as the name of the header.</p>
-<h4 id="envoy-dynamic-metadata">Envoy Dynamic Metadata<a class="headerlink" href="#envoy-dynamic-metadata" title="Permanent link">&para;</a></h4>
-<p>Authorino custom response methods can also be used to propagate <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/advanced/well_known_dynamic_metadata">Envoy Dynamic Metadata</a>. To do so, set one of the supported methods under <code>response.success.dynamicMetadata</code>.</p>
-<p>The name of the response config (default) or the value of the <code>key</code> option (if provided) will used as the name of the root property of the dynamic metadata content.</p>
-<p>A custom response exported as Envoy Dynamic Metadata can be set in the Envoy route or virtual host configuration as input to a consecutive filter in the filter chain.</p>
-<p>E.g., to read metadata emitted by the authorization service with scheme <code>{ "auth-data": { "api-key-ns": string, "api-key-name": string } }</code>, as input in a rate limit configuration placed in the filter chain after the external authorization, the Envoy config may look like the following:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="c1"># Envoy config snippet to inject `user_namespace` and `username` rate limit descriptors from metadata emitted by Authorino</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="nt">rate_limits</span><span class="p">:</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="w">      </span><span class="nt">metadata_key</span><span class="p">:</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;envoy.filters.http.ext_authz&quot;</span>
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="w">        </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth-data</span><span class="w"> </span><span class="c1"># root of the dynamic metadata object, as declared in a custom response config of the AuthConfig (name or key)</span>
-</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api-key-ns</span>
-</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">user_namespace</span>
-</span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="w">      </span><span class="nt">metadata_key</span><span class="p">:</span>
-</span><span id="__span-14-14"><a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;envoy.filters.http.ext_authz&quot;</span>
-</span><span id="__span-14-15"><a id="__codelineno-14-15" name="__codelineno-14-15" href="#__codelineno-14-15"></a><span class="w">        </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-14-16"><a id="__codelineno-14-16" name="__codelineno-14-16" href="#__codelineno-14-16"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth-data</span><span class="w"> </span><span class="c1"># root of the dynamic metadata object, as declared in a custom response config of the AuthConfig (name or key)</span>
-</span><span id="__span-14-17"><a id="__codelineno-14-17" name="__codelineno-14-17" href="#__codelineno-14-17"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api-key-name</span>
-</span><span id="__span-14-18"><a id="__codelineno-14-18" name="__codelineno-14-18" href="#__codelineno-14-18"></a><span class="w">      </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">username</span>
-</span></code></pre></div>
-<h4 id="custom-denial-status-responseunauthenticated-and-responseunauthorized">Custom denial status (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#DenyWithSpec"><code>response.unauthenticated</code></a> and <a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#DenyWithSpec"><code>response.unauthorized</code></a>)<a class="headerlink" href="#custom-denial-status-responseunauthenticated-and-responseunauthorized" title="Permanent link">&para;</a></h4>
-<p>By default, Authorino will inform Envoy to respond with <code>401 Unauthorized</code> or <code>403 Forbidden</code> respectively when the identity verification (phase i of the <a href="../architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a>) or authorization (phase ii) fail. These can be customized respectively by specifying <code>spec.response.unauthanticated</code> and <code>spec.response.unauthorized</code> in the <code>AuthConfig</code>.</p>
-<h3 id="custom-response-methods">Custom response methods<a class="headerlink" href="#custom-response-methods" title="Permanent link">&para;</a></h3>
-<h4 id="plain-text-responsesuccessheadersdynamicmetadataplain">Plain text (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#PlainAuthResponseSpec"><code>response.success.&lt;headers|dynamicMetadata&gt;.plain</code></a>)<a class="headerlink" href="#plain-text-responsesuccessheadersdynamicmetadataplain" title="Permanent link">&para;</a></h4>
-<p>Simpler, yet more generalized form, for extending the authorization response for header mutation and Envoy Dynamic Metadata, based on plain text values.</p>
-<p>The value can be static:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="nt">response</span><span class="p">:</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="w">  </span><span class="nt">success</span><span class="p">:</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="w">    </span><span class="nt">headers</span><span class="p">:</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="w">      </span><span class="s">&quot;x-auth-service&quot;</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="w">        </span><span class="nt">plain</span><span class="p">:</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Authorino</span>
-</span></code></pre></div>
-<p>or fetched dynamically from the <a href="../architecture/#the-authorization-json">Authorization JSON</a> (which includes support for <a href="#interpolation">interpolation</a>):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nt">response</span><span class="p">:</span>
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="w">  </span><span class="nt">success</span><span class="p">:</span>
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="w">    </span><span class="nt">headers</span><span class="p">:</span>
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="w">      </span><span class="s">&quot;x-username&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a><span class="w">        </span><span class="nt">plain</span><span class="p">:</span>
-</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span></code></pre></div>
-<h4 id="json-injection-responsesuccessheadersdynamicmetadatajson">JSON injection (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#JsonAuthResponseSpec"><code>response.success.&lt;headers|dynamicMetadata&gt;.json</code></a>)<a class="headerlink" href="#json-injection-responsesuccessheadersdynamicmetadatajson" title="Permanent link">&para;</a></h4>
-<p>User-defined dynamic JSON objects generated by Authorino in the response phase, from static or dynamic data of the auth pipeline, and passed back to the external authorization client within added HTTP headers or Dynamic Metadata.</p>
-<p>The following Authorino <code>AuthConfig</code> custom resource is an example that defines 3 dynamic JSON response items, where two items are returned to the client, stringified, in added HTTP headers, and the third as Envoy Dynamic Metadata. Envoy proxy can be configured to propagate the dynamic metadata emitted by Authorino into another filter – e.g. the rate limit filter.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-namespace</span>
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api-protection</span>
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a>
-</span><span id="__span-17-9"><a id="__codelineno-17-9" name="__codelineno-17-9" href="#__codelineno-17-9"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api.io</span>
-</span><span id="__span-17-10"><a id="__codelineno-17-10" name="__codelineno-17-10" href="#__codelineno-17-10"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-17-11"><a id="__codelineno-17-11" name="__codelineno-17-11" href="#__codelineno-17-11"></a><span class="w">    </span><span class="s">&quot;edge&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-12"><a id="__codelineno-17-12" name="__codelineno-17-12" href="#__codelineno-17-12"></a><span class="w">      </span><span class="nt">apiKey</span><span class="p">:</span>
-</span><span id="__span-17-13"><a id="__codelineno-17-13" name="__codelineno-17-13" href="#__codelineno-17-13"></a><span class="w">        </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-17-14"><a id="__codelineno-17-14" name="__codelineno-17-14" href="#__codelineno-17-14"></a><span class="w">          </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-17-15"><a id="__codelineno-17-15" name="__codelineno-17-15" href="#__codelineno-17-15"></a><span class="w">            </span><span class="nt">authorino.kuadrant.io/managed-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-17-16"><a id="__codelineno-17-16" name="__codelineno-17-16" href="#__codelineno-17-16"></a><span class="w">      </span><span class="nt">credentials</span><span class="p">:</span>
-</span><span id="__span-17-17"><a id="__codelineno-17-17" name="__codelineno-17-17" href="#__codelineno-17-17"></a><span class="w">        </span><span class="nt">authorizationHeader</span><span class="p">:</span>
-</span><span id="__span-17-18"><a id="__codelineno-17-18" name="__codelineno-17-18" href="#__codelineno-17-18"></a><span class="w">          </span><span class="nt">prefix</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">APIKEY</span>
-</span><span id="__span-17-19"><a id="__codelineno-17-19" name="__codelineno-17-19" href="#__codelineno-17-19"></a><span class="w">  </span><span class="nt">response</span><span class="p">:</span>
-</span><span id="__span-17-20"><a id="__codelineno-17-20" name="__codelineno-17-20" href="#__codelineno-17-20"></a><span class="w">    </span><span class="nt">success</span><span class="p">:</span>
-</span><span id="__span-17-21"><a id="__codelineno-17-21" name="__codelineno-17-21" href="#__codelineno-17-21"></a><span class="w">      </span><span class="nt">headers</span><span class="p">:</span>
-</span><span id="__span-17-22"><a id="__codelineno-17-22" name="__codelineno-17-22" href="#__codelineno-17-22"></a><span class="w">        </span><span class="s">&quot;x-my-custom-header&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-23"><a id="__codelineno-17-23" name="__codelineno-17-23" href="#__codelineno-17-23"></a><span class="w">          </span><span class="nt">json</span><span class="p">:</span>
-</span><span id="__span-17-24"><a id="__codelineno-17-24" name="__codelineno-17-24" href="#__codelineno-17-24"></a><span class="w">            </span><span class="nt">properties</span><span class="p">:</span>
-</span><span id="__span-17-25"><a id="__codelineno-17-25" name="__codelineno-17-25" href="#__codelineno-17-25"></a><span class="w">              </span><span class="s">&quot;prop1&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-26"><a id="__codelineno-17-26" name="__codelineno-17-26" href="#__codelineno-17-26"></a><span class="w">                </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">value1</span>
-</span><span id="__span-17-27"><a id="__codelineno-17-27" name="__codelineno-17-27" href="#__codelineno-17-27"></a><span class="w">              </span><span class="s">&quot;prop2&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-28"><a id="__codelineno-17-28" name="__codelineno-17-28" href="#__codelineno-17-28"></a><span class="w">                </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">some.path.within.auth.json</span>
-</span><span id="__span-17-29"><a id="__codelineno-17-29" name="__codelineno-17-29" href="#__codelineno-17-29"></a><span class="w">        </span><span class="s">&quot;x-ext-auth-other-json&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-30"><a id="__codelineno-17-30" name="__codelineno-17-30" href="#__codelineno-17-30"></a><span class="w">          </span><span class="nt">json</span><span class="p">:</span>
-</span><span id="__span-17-31"><a id="__codelineno-17-31" name="__codelineno-17-31" href="#__codelineno-17-31"></a><span class="w">            </span><span class="nt">properties</span><span class="p">:</span>
-</span><span id="__span-17-32"><a id="__codelineno-17-32" name="__codelineno-17-32" href="#__codelineno-17-32"></a><span class="w">              </span><span class="s">&quot;propX&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-33"><a id="__codelineno-17-33" name="__codelineno-17-33" href="#__codelineno-17-33"></a><span class="w">                </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">valueX</span>
-</span><span id="__span-17-34"><a id="__codelineno-17-34" name="__codelineno-17-34" href="#__codelineno-17-34"></a>
-</span><span id="__span-17-35"><a id="__codelineno-17-35" name="__codelineno-17-35" href="#__codelineno-17-35"></a><span class="w">      </span><span class="nt">dynamicMetadata</span><span class="p">:</span>
-</span><span id="__span-17-36"><a id="__codelineno-17-36" name="__codelineno-17-36" href="#__codelineno-17-36"></a><span class="w">        </span><span class="s">&quot;auth-data&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-37"><a id="__codelineno-17-37" name="__codelineno-17-37" href="#__codelineno-17-37"></a><span class="w">          </span><span class="nt">json</span><span class="p">:</span>
-</span><span id="__span-17-38"><a id="__codelineno-17-38" name="__codelineno-17-38" href="#__codelineno-17-38"></a><span class="w">            </span><span class="nt">properties</span><span class="p">:</span>
-</span><span id="__span-17-39"><a id="__codelineno-17-39" name="__codelineno-17-39" href="#__codelineno-17-39"></a><span class="w">              </span><span class="s">&quot;api-key-ns&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-40"><a id="__codelineno-17-40" name="__codelineno-17-40" href="#__codelineno-17-40"></a><span class="w">                </span><span class="nt">seletor</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.metadata.namespace</span>
-</span><span id="__span-17-41"><a id="__codelineno-17-41" name="__codelineno-17-41" href="#__codelineno-17-41"></a><span class="w">              </span><span class="s">&quot;api-key-name&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-17-42"><a id="__codelineno-17-42" name="__codelineno-17-42" href="#__codelineno-17-42"></a><span class="w">                </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.metadata.name</span>
-</span></code></pre></div>
-<h4 id="festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristband tokens (<a href="https://pkg.go.dev/github.com/kuadrant/authorino/api/v1beta2?utm_source=gopls#WristbandAuthResponseSpec"><code>response.success.&lt;headers|dynamicMetadata&gt;.wristband</code></a>)<a class="headerlink" href="#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband" title="Permanent link">&para;</a></h4>
-<p>Festival Wristbands are signed OpenID Connect JSON Web Tokens (JWTs) issued by Authorino at the end of the auth pipeline and passed back to the client, typically in added HTTP response header. It is an opt-in feature that can be used to implement Edge Authentication Architecture (EAA) and enable token normalization. Authorino wristbands include minimal standard JWT claims such as <code>iss</code>, <code>iat</code>, and <code>exp</code>, and optional user-defined custom claims, whose values can be static or dynamically fetched from the authorization JSON.</p>
-<p>The Authorino <code>AuthConfig</code> custom resource below sets an API protection that issues a wristband after a successful authentication via API key. Apart from standard JWT claims, the wristband contains 2 custom claims: a static value <code>aud=internal</code> and a dynamic value <code>born</code> that fetches from the authorization JSON the date/time of creation of the secret that represents the API key used to authenticate.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-namespace</span>
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api-protection</span>
-</span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a>
-</span><span id="__span-18-9"><a id="__codelineno-18-9" name="__codelineno-18-9" href="#__codelineno-18-9"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api.io</span>
-</span><span id="__span-18-10"><a id="__codelineno-18-10" name="__codelineno-18-10" href="#__codelineno-18-10"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-18-11"><a id="__codelineno-18-11" name="__codelineno-18-11" href="#__codelineno-18-11"></a><span class="w">    </span><span class="s">&quot;edge&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-18-12"><a id="__codelineno-18-12" name="__codelineno-18-12" href="#__codelineno-18-12"></a><span class="w">      </span><span class="nt">apiKey</span><span class="p">:</span>
-</span><span id="__span-18-13"><a id="__codelineno-18-13" name="__codelineno-18-13" href="#__codelineno-18-13"></a><span class="w">        </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-18-14"><a id="__codelineno-18-14" name="__codelineno-18-14" href="#__codelineno-18-14"></a><span class="w">          </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-18-15"><a id="__codelineno-18-15" name="__codelineno-18-15" href="#__codelineno-18-15"></a><span class="w">            </span><span class="nt">authorino.kuadrant.io/managed-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-18-16"><a id="__codelineno-18-16" name="__codelineno-18-16" href="#__codelineno-18-16"></a><span class="w">      </span><span class="nt">credentials</span><span class="p">:</span>
-</span><span id="__span-18-17"><a id="__codelineno-18-17" name="__codelineno-18-17" href="#__codelineno-18-17"></a><span class="w">        </span><span class="nt">authorizationHeader</span><span class="p">:</span>
-</span><span id="__span-18-18"><a id="__codelineno-18-18" name="__codelineno-18-18" href="#__codelineno-18-18"></a><span class="w">          </span><span class="nt">prefix</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">APIKEY</span>
-</span><span id="__span-18-19"><a id="__codelineno-18-19" name="__codelineno-18-19" href="#__codelineno-18-19"></a><span class="w">  </span><span class="nt">response</span><span class="p">:</span>
-</span><span id="__span-18-20"><a id="__codelineno-18-20" name="__codelineno-18-20" href="#__codelineno-18-20"></a><span class="w">    </span><span class="nt">success</span><span class="p">:</span>
-</span><span id="__span-18-21"><a id="__codelineno-18-21" name="__codelineno-18-21" href="#__codelineno-18-21"></a><span class="w">      </span><span class="nt">headers</span><span class="p">:</span>
-</span><span id="__span-18-22"><a id="__codelineno-18-22" name="__codelineno-18-22" href="#__codelineno-18-22"></a><span class="w">        </span><span class="s">&quot;x-wristband&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-18-23"><a id="__codelineno-18-23" name="__codelineno-18-23" href="#__codelineno-18-23"></a><span class="w">          </span><span class="nt">wristband</span><span class="p">:</span>
-</span><span id="__span-18-24"><a id="__codelineno-18-24" name="__codelineno-18-24" href="#__codelineno-18-24"></a><span class="w">            </span><span class="nt">issuer</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://authorino-oidc.default.svc:8083/my-namespace/my-api-protection/x-wristband</span>
-</span><span id="__span-18-25"><a id="__codelineno-18-25" name="__codelineno-18-25" href="#__codelineno-18-25"></a><span class="w">            </span><span class="nt">customClaims</span><span class="p">:</span>
-</span><span id="__span-18-26"><a id="__codelineno-18-26" name="__codelineno-18-26" href="#__codelineno-18-26"></a><span class="w">              </span><span class="s">&quot;aud&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-18-27"><a id="__codelineno-18-27" name="__codelineno-18-27" href="#__codelineno-18-27"></a><span class="w">                </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">internal</span>
-</span><span id="__span-18-28"><a id="__codelineno-18-28" name="__codelineno-18-28" href="#__codelineno-18-28"></a><span class="w">              </span><span class="s">&quot;born&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-18-29"><a id="__codelineno-18-29" name="__codelineno-18-29" href="#__codelineno-18-29"></a><span class="w">                </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.metadata.creationTimestamp</span>
-</span><span id="__span-18-30"><a id="__codelineno-18-30" name="__codelineno-18-30" href="#__codelineno-18-30"></a><span class="w">            </span><span class="nt">tokenDuration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-18-31"><a id="__codelineno-18-31" name="__codelineno-18-31" href="#__codelineno-18-31"></a><span class="w">            </span><span class="nt">signingKeyRefs</span><span class="p">:</span>
-</span><span id="__span-18-32"><a id="__codelineno-18-32" name="__codelineno-18-32" href="#__codelineno-18-32"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-signing-key</span>
-</span><span id="__span-18-33"><a id="__codelineno-18-33" name="__codelineno-18-33" href="#__codelineno-18-33"></a><span class="w">              </span><span class="nt">algorithm</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ES256</span>
-</span><span id="__span-18-34"><a id="__codelineno-18-34" name="__codelineno-18-34" href="#__codelineno-18-34"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-old-signing-key</span>
-</span><span id="__span-18-35"><a id="__codelineno-18-35" name="__codelineno-18-35" href="#__codelineno-18-35"></a><span class="w">              </span><span class="nt">algorithm</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RS256</span>
-</span></code></pre></div>
-<p>The signing key names listed in <code>signingKeyRefs</code> must match the names of Kubernetes <code>Secret</code> resources created in the same namespace, where each secret contains a <code>key.pem</code> entry that holds the value of the private key that will be used to sign the wristbands issued, formatted as <a href="https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail">PEM</a>. The first key in this list will be used to sign the wristbands, while the others are kept to support key rotation.</p>
-<p>For each protected API configured for the Festival Wristband issuing, Authorino exposes the following OpenID Connect Discovery well-known endpoints (available for requests within the cluster):</p>
-<ul>
-<li><strong>OpenID Connect configuration:</strong><br/>
-  https://authorino-oidc.default.svc:8083/{namespace}/{api-protection-name}/{response-config-name}/.well-known/openid-configuration</li>
-<li><strong>JSON Web Key Set (JWKS) well-known endpoint:</strong><br/>
-  https://authorino-oidc.default.svc:8083/{namespace}/{api-protection-name}/{response-config-name}/.well-known/openid-connect/certs</li>
-</ul>
-<h2 id="callbacks-callbacks">Callbacks (<code>callbacks</code>)<a class="headerlink" href="#callbacks-callbacks" title="Permanent link">&para;</a></h2>
-<h3 id="http-endpoints-callbackshttp">HTTP endpoints (<code>callbacks.http</code>)<a class="headerlink" href="#http-endpoints-callbackshttp" title="Permanent link">&para;</a></h3>
-<p>Sends requests to specified HTTP endpoints at the end of the auth pipeline.</p>
-<p>The scheme of the <code>http</code> field is the same as of <a href="#http-getget-by-post-metadatahttp"><code>metadata.http</code></a>.</p>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a>
-</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a><span class="w">  </span><span class="nt">callbacks</span><span class="p">:</span>
-</span><span id="__span-19-6"><a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a><span class="w">    </span><span class="s">&quot;log&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-19-7"><a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-19-8"><a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a><span class="w">        </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">http://logsys</span>
-</span><span id="__span-19-9"><a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a><span class="w">        </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-19-10"><a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a><span class="w">        </span><span class="nt">body</span><span class="p">:</span>
-</span><span id="__span-19-11"><a id="__codelineno-19-11" name="__codelineno-19-11" href="#__codelineno-19-11"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">|</span>
-</span><span id="__span-19-12"><a id="__codelineno-19-12" name="__codelineno-19-12" href="#__codelineno-19-12"></a><span class="w">              </span><span class="no">\{&quot;requestId&quot;:context.request.http.id,&quot;username&quot;:&quot;{auth.identity.username}&quot;,&quot;authorizationResult&quot;:{auth.authorization}\}</span>
-</span><span id="__span-19-13"><a id="__codelineno-19-13" name="__codelineno-19-13" href="#__codelineno-19-13"></a><span class="w">    </span><span class="s">&quot;important-forbidden&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-19-14"><a id="__codelineno-19-14" name="__codelineno-19-14" href="#__codelineno-19-14"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-19-15"><a id="__codelineno-19-15" name="__codelineno-19-15" href="#__codelineno-19-15"></a>
-</span><span id="__span-19-16"><a id="__codelineno-19-16" name="__codelineno-19-16" href="#__codelineno-19-16"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.authorization.important-policy</span>
-</span><span id="__span-19-17"><a id="__codelineno-19-17" name="__codelineno-19-17" href="#__codelineno-19-17"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-19-18"><a id="__codelineno-19-18" name="__codelineno-19-18" href="#__codelineno-19-18"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;false&quot;</span>
-</span><span id="__span-19-19"><a id="__codelineno-19-19" name="__codelineno-19-19" href="#__codelineno-19-19"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-19-20"><a id="__codelineno-19-20" name="__codelineno-19-20" href="#__codelineno-19-20"></a><span class="w">        </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;http://monitoring/important?forbidden-user={auth.identity.username}&quot;</span>
-</span></code></pre></div>
-<h2 id="common-feature-priorities">Common feature: Priorities<a class="headerlink" href="#common-feature-priorities" title="Permanent link">&para;</a></h2>
-<p><em>Priorities</em> allow to set sequence of execution for blocks of concurrent evaluators within phases of the <a href="../architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a>.</p>
-<p>Evaluators of same priority execute concurrently to each other "in a block". After syncing that block (i.e. after all evaluators of the block have returned), the next block of evaluator configs of consecutive priority is triggered.</p>
-<p>Use cases for priorities are:</p>
-<ol>
-<li>Saving expensive tasks to be triggered when there's a high chance of returning immediately after finishing executing a less expensive one – e.g.<ul>
-<li>an identity config that calls an external IdP to verify a token that is rarely used, compared to verifying JWTs preferred by most users of the service;</li>
-<li>an authorization policy that performs some quick checks first, such as verifying allowed paths, and only if it passes, moves to the evaluation of a more expensive policy.</li>
-</ul>
-</li>
-<li>Establishing dependencies between evaluators - e.g.<ul>
-<li>an external metadata request that needs to wait until a previous metadata responds first (in order to use data from the response)</li>
-</ul>
-</li>
-</ol>
-<p>Priorities can be set using the <code>priority</code> property available in all evaluator configs of all phases of the Auth Pipeline (identity, metadata, authorization and response). The lower the number, the highest the priority. By default, all evaluators have priority 0 (i.e. highest priority).</p>
-<p>Consider the following example to understand how priorities work:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">talker-api-protection</span>
-</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-20-7"><a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a>
-</span><span id="__span-20-8"><a id="__codelineno-20-8" name="__codelineno-20-8" href="#__codelineno-20-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">talker-api</span>
-</span><span id="__span-20-9"><a id="__codelineno-20-9" name="__codelineno-20-9" href="#__codelineno-20-9"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-20-10"><a id="__codelineno-20-10" name="__codelineno-20-10" href="#__codelineno-20-10"></a><span class="w">    </span><span class="s">&quot;tier-1&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-11"><a id="__codelineno-20-11" name="__codelineno-20-11" href="#__codelineno-20-11"></a><span class="w">      </span><span class="nt">priority</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">0</span>
-</span><span id="__span-20-12"><a id="__codelineno-20-12" name="__codelineno-20-12" href="#__codelineno-20-12"></a><span class="w">      </span><span class="nt">apiKey</span><span class="p">:</span>
-</span><span id="__span-20-13"><a id="__codelineno-20-13" name="__codelineno-20-13" href="#__codelineno-20-13"></a><span class="w">        </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-20-14"><a id="__codelineno-20-14" name="__codelineno-20-14" href="#__codelineno-20-14"></a><span class="w">          </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-20-15"><a id="__codelineno-20-15" name="__codelineno-20-15" href="#__codelineno-20-15"></a><span class="w">            </span><span class="nt">tier</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-20-16"><a id="__codelineno-20-16" name="__codelineno-20-16" href="#__codelineno-20-16"></a><span class="w">    </span><span class="s">&quot;tier-2&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-17"><a id="__codelineno-20-17" name="__codelineno-20-17" href="#__codelineno-20-17"></a><span class="w">      </span><span class="nt">priority</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-20-18"><a id="__codelineno-20-18" name="__codelineno-20-18" href="#__codelineno-20-18"></a><span class="w">      </span><span class="nt">apiKey</span><span class="p">:</span>
-</span><span id="__span-20-19"><a id="__codelineno-20-19" name="__codelineno-20-19" href="#__codelineno-20-19"></a><span class="w">        </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-20-20"><a id="__codelineno-20-20" name="__codelineno-20-20" href="#__codelineno-20-20"></a><span class="w">          </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-20-21"><a id="__codelineno-20-21" name="__codelineno-20-21" href="#__codelineno-20-21"></a><span class="w">            </span><span class="nt">tier</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2&quot;</span>
-</span><span id="__span-20-22"><a id="__codelineno-20-22" name="__codelineno-20-22" href="#__codelineno-20-22"></a><span class="w">    </span><span class="s">&quot;tier-3&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-23"><a id="__codelineno-20-23" name="__codelineno-20-23" href="#__codelineno-20-23"></a><span class="w">      </span><span class="nt">priority</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-20-24"><a id="__codelineno-20-24" name="__codelineno-20-24" href="#__codelineno-20-24"></a><span class="w">      </span><span class="nt">apiKey</span><span class="p">:</span>
-</span><span id="__span-20-25"><a id="__codelineno-20-25" name="__codelineno-20-25" href="#__codelineno-20-25"></a><span class="w">        </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-20-26"><a id="__codelineno-20-26" name="__codelineno-20-26" href="#__codelineno-20-26"></a><span class="w">          </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-20-27"><a id="__codelineno-20-27" name="__codelineno-20-27" href="#__codelineno-20-27"></a><span class="w">            </span><span class="nt">tier</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;3&quot;</span>
-</span><span id="__span-20-28"><a id="__codelineno-20-28" name="__codelineno-20-28" href="#__codelineno-20-28"></a><span class="w">  </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-20-29"><a id="__codelineno-20-29" name="__codelineno-20-29" href="#__codelineno-20-29"></a><span class="w">    </span><span class="s">&quot;first&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-30"><a id="__codelineno-20-30" name="__codelineno-20-30" href="#__codelineno-20-30"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-20-31"><a id="__codelineno-20-31" name="__codelineno-20-31" href="#__codelineno-20-31"></a><span class="w">        </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">http://talker-api:3000</span>
-</span><span id="__span-20-32"><a id="__codelineno-20-32" name="__codelineno-20-32" href="#__codelineno-20-32"></a><span class="w">    </span><span class="s">&quot;second&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-33"><a id="__codelineno-20-33" name="__codelineno-20-33" href="#__codelineno-20-33"></a><span class="w">      </span><span class="nt">priority</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-20-34"><a id="__codelineno-20-34" name="__codelineno-20-34" href="#__codelineno-20-34"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-20-35"><a id="__codelineno-20-35" name="__codelineno-20-35" href="#__codelineno-20-35"></a><span class="w">        </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">http://talker-api:3000/first_uuid={auth.metadata.first.uuid}</span>
-</span><span id="__span-20-36"><a id="__codelineno-20-36" name="__codelineno-20-36" href="#__codelineno-20-36"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-20-37"><a id="__codelineno-20-37" name="__codelineno-20-37" href="#__codelineno-20-37"></a><span class="w">    </span><span class="s">&quot;allowed-endpoints&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-38"><a id="__codelineno-20-38" name="__codelineno-20-38" href="#__codelineno-20-38"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-20-39"><a id="__codelineno-20-39" name="__codelineno-20-39" href="#__codelineno-20-39"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-20-40"><a id="__codelineno-20-40" name="__codelineno-20-40" href="#__codelineno-20-40"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-20-41"><a id="__codelineno-20-41" name="__codelineno-20-41" href="#__codelineno-20-41"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/hi</span>
-</span><span id="__span-20-42"><a id="__codelineno-20-42" name="__codelineno-20-42" href="#__codelineno-20-42"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-20-43"><a id="__codelineno-20-43" name="__codelineno-20-43" href="#__codelineno-20-43"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-20-44"><a id="__codelineno-20-44" name="__codelineno-20-44" href="#__codelineno-20-44"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/hello</span>
-</span><span id="__span-20-45"><a id="__codelineno-20-45" name="__codelineno-20-45" href="#__codelineno-20-45"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-20-46"><a id="__codelineno-20-46" name="__codelineno-20-46" href="#__codelineno-20-46"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-20-47"><a id="__codelineno-20-47" name="__codelineno-20-47" href="#__codelineno-20-47"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/aloha</span>
-</span><span id="__span-20-48"><a id="__codelineno-20-48" name="__codelineno-20-48" href="#__codelineno-20-48"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-20-49"><a id="__codelineno-20-49" name="__codelineno-20-49" href="#__codelineno-20-49"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-20-50"><a id="__codelineno-20-50" name="__codelineno-20-50" href="#__codelineno-20-50"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/ciao</span>
-</span><span id="__span-20-51"><a id="__codelineno-20-51" name="__codelineno-20-51" href="#__codelineno-20-51"></a><span class="w">      </span><span class="nt">patternMatching</span><span class="p">:</span>
-</span><span id="__span-20-52"><a id="__codelineno-20-52" name="__codelineno-20-52" href="#__codelineno-20-52"></a><span class="w">        </span><span class="nt">patterns</span><span class="p">:</span>
-</span><span id="__span-20-53"><a id="__codelineno-20-53" name="__codelineno-20-53" href="#__codelineno-20-53"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">deny</span>
-</span><span id="__span-20-54"><a id="__codelineno-20-54" name="__codelineno-20-54" href="#__codelineno-20-54"></a><span class="w">          </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-20-55"><a id="__codelineno-20-55" name="__codelineno-20-55" href="#__codelineno-20-55"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;true&quot;</span>
-</span><span id="__span-20-56"><a id="__codelineno-20-56" name="__codelineno-20-56" href="#__codelineno-20-56"></a><span class="w">    </span><span class="s">&quot;more-expensive-policy&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="c1"># no point in evaluating this one if it&#39;s not an allowed endpoint</span>
-</span><span id="__span-20-57"><a id="__codelineno-20-57" name="__codelineno-20-57" href="#__codelineno-20-57"></a><span class="w">      </span><span class="nt">priority</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-20-58"><a id="__codelineno-20-58" name="__codelineno-20-58" href="#__codelineno-20-58"></a><span class="w">      </span><span class="nt">opa</span><span class="p">:</span>
-</span><span id="__span-20-59"><a id="__codelineno-20-59" name="__codelineno-20-59" href="#__codelineno-20-59"></a><span class="w">        </span><span class="nt">rego</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">|</span>
-</span><span id="__span-20-60"><a id="__codelineno-20-60" name="__codelineno-20-60" href="#__codelineno-20-60"></a><span class="w">          </span><span class="no">allow { true }</span>
-</span><span id="__span-20-61"><a id="__codelineno-20-61" name="__codelineno-20-61" href="#__codelineno-20-61"></a><span class="w">  </span><span class="nt">response</span><span class="p">:</span>
-</span><span id="__span-20-62"><a id="__codelineno-20-62" name="__codelineno-20-62" href="#__codelineno-20-62"></a><span class="w">    </span><span class="nt">success</span><span class="p">:</span>
-</span><span id="__span-20-63"><a id="__codelineno-20-63" name="__codelineno-20-63" href="#__codelineno-20-63"></a><span class="w">      </span><span class="nt">headers</span><span class="p">:</span>
-</span><span id="__span-20-64"><a id="__codelineno-20-64" name="__codelineno-20-64" href="#__codelineno-20-64"></a><span class="w">        </span><span class="s">&quot;x-auth-data&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-65"><a id="__codelineno-20-65" name="__codelineno-20-65" href="#__codelineno-20-65"></a><span class="w">          </span><span class="nt">json</span><span class="p">:</span>
-</span><span id="__span-20-66"><a id="__codelineno-20-66" name="__codelineno-20-66" href="#__codelineno-20-66"></a><span class="w">            </span><span class="nt">properties</span><span class="p">:</span>
-</span><span id="__span-20-67"><a id="__codelineno-20-67" name="__codelineno-20-67" href="#__codelineno-20-67"></a><span class="w">              </span><span class="s">&quot;tier&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-68"><a id="__codelineno-20-68" name="__codelineno-20-68" href="#__codelineno-20-68"></a><span class="w">                </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.metadata.labels.tier</span>
-</span><span id="__span-20-69"><a id="__codelineno-20-69" name="__codelineno-20-69" href="#__codelineno-20-69"></a><span class="w">              </span><span class="s">&quot;first-uuid&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-70"><a id="__codelineno-20-70" name="__codelineno-20-70" href="#__codelineno-20-70"></a><span class="w">                </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.metadata.first.uuid</span>
-</span><span id="__span-20-71"><a id="__codelineno-20-71" name="__codelineno-20-71" href="#__codelineno-20-71"></a><span class="w">              </span><span class="s">&quot;second-uuid&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-72"><a id="__codelineno-20-72" name="__codelineno-20-72" href="#__codelineno-20-72"></a><span class="w">                </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.metadata.second.uuid</span>
-</span><span id="__span-20-73"><a id="__codelineno-20-73" name="__codelineno-20-73" href="#__codelineno-20-73"></a><span class="w">              </span><span class="s">&quot;second-path&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-20-74"><a id="__codelineno-20-74" name="__codelineno-20-74" href="#__codelineno-20-74"></a><span class="w">                </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.metadata.second.path</span>
-</span></code></pre></div>
-<p>For the <code>AuthConfig</code> above,</p>
-<ul>
-<li>
-<p>Identity configs <code>tier-2</code> and <code>tier-3</code> (priority 1) will only trigger (concurrently) in case <code>tier-1</code> (priority 0) fails to validate the authentication token first. (This behavior happens without prejudice of context canceling between concurrent evaluators – i.e. evaluators that <em>are</em> triggered concurrently to another, such as <code>tier-2</code> and <code>tier-3</code>, continue to cancel the context of each other if any of them succeeds validating the token first.)</p>
-</li>
-<li>
-<p>Metadata source <code>second</code> (priority 1) uses the response of the request issued by metadata source <code>first</code> (priority 0), so it will wait for <code>first</code> to finish by triggering only in the second block.</p>
-</li>
-<li>
-<p>Authorization policy <code>allowed-endpoints</code> (priority 0) is considered to be a lot less expensive than <code>more-expensive-policy</code> (priority 1) and has a high chance of denying access to the protected service (if the path is not one of the allowed endpoints). By setting different priorities to these policies we ensure the more expensive policy if triggered in sequence of the less expensive one, instead of concurrently.</p>
-</li>
-</ul>
-<h2 id="common-feature-conditions-when">Common feature: Conditions (<code>when</code>)<a class="headerlink" href="#common-feature-conditions-when" title="Permanent link">&para;</a></h2>
-<p><em>Conditions</em>, named <code>when</code> in the AuthConfig API, are logical expressions, composed of patterns and logical operator AND and OR, that can be used to condition the evaluation of a particular auth rule within an AuthConfig, as well as of the AuthConfig altogether ("top-level conditions").</p>
-<p>The patterns are evaluated against the <a href="../architecture/#the-authorization-json">Authorization JSON</a>, where each pattern is a tuple composed of:</p>
-<ul>
-<li><code>selector</code>: a <a href="#common-feature-json-paths-selector">JSON path</a> to fetch a value from the Authorization JSON</li>
-<li><code>operator</code>: one of: <code>eq</code> (<em>equals</em>); <code>neq</code> (<em>not equal</em>); <code>incl</code> (<em>includes</em>) and <code>excl</code> (<em>excludes</em>), for when the value fetched from the Authorization JSON is expected to be an array; <code>matches</code>, for regular expressions</li>
-<li><code>value</code>: a static string value to compare the value selected from the Authorization JSON with.</li>
-</ul>
-<p>An expression contains one or more patterns and they must either all evaluate to true ("AND" operator, declared by grouping the patterns within an <code>all</code> block) or at least one of the patterns must be true ("OR" operator, when grouped within an <code>any</code> block.) Patterns not explicitly grouped are AND'ed by default.</p>
-<p>To avoid repetitions when listing patterns, any set of literal <code>{ pattern, operator, value }</code> tuples can be stored at the top-level of the AuthConfig spec, indexed by name, and later referred within an expression by including a <code>patternRef</code> in the block of conditions.</p>
-<p><strong>Examples of <code>when</code> conditions</strong></p>
-<p>i) to skip an entire <code>AuthConfig</code> based on the context (AND operator assumed by default):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a><span class="w">  </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="c1"># auth enforced only on requests to POST /resources/*</span>
-</span><span id="__span-21-3"><a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a>
-</span><span id="__span-21-4"><a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-21-5"><a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a><span class="w">    </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-21-6"><a id="__codelineno-21-6" name="__codelineno-21-6" href="#__codelineno-21-6"></a><span class="w">    </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-21-7"><a id="__codelineno-21-7" name="__codelineno-21-7" href="#__codelineno-21-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-21-8"><a id="__codelineno-21-8" name="__codelineno-21-8" href="#__codelineno-21-8"></a><span class="w">    </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-21-9"><a id="__codelineno-21-9" name="__codelineno-21-9" href="#__codelineno-21-9"></a><span class="w">    </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">^/resources/.*</span>
-</span></code></pre></div>
-<p>ii) equivalent to the above with explicit AND operator (i.e., <code>all</code> block):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-22-2"><a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a><span class="w">  </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="c1"># auth enforced only on requests to POST /resources/*</span>
-</span><span id="__span-22-3"><a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a>
-</span><span id="__span-22-4"><a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">all</span><span class="p">:</span>
-</span><span id="__span-22-5"><a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-22-6"><a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-22-7"><a id="__codelineno-22-7" name="__codelineno-22-7" href="#__codelineno-22-7"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-22-8"><a id="__codelineno-22-8" name="__codelineno-22-8" href="#__codelineno-22-8"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-22-9"><a id="__codelineno-22-9" name="__codelineno-22-9" href="#__codelineno-22-9"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-22-10"><a id="__codelineno-22-10" name="__codelineno-22-10" href="#__codelineno-22-10"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">^/resources/.*</span>
-</span></code></pre></div>
-<p>iii) OR condition (i.e., <code>any</code> block):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a><span class="w">  </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="c1"># auth enforced only on requests with HTTP method equals to POST or PUT</span>
-</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a>
-</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">any</span><span class="p">:</span>
-</span><span id="__span-23-5"><a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-23-6"><a id="__codelineno-23-6" name="__codelineno-23-6" href="#__codelineno-23-6"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-23-7"><a id="__codelineno-23-7" name="__codelineno-23-7" href="#__codelineno-23-7"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-23-8"><a id="__codelineno-23-8" name="__codelineno-23-8" href="#__codelineno-23-8"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-23-9"><a id="__codelineno-23-9" name="__codelineno-23-9" href="#__codelineno-23-9"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-23-10"><a id="__codelineno-23-10" name="__codelineno-23-10" href="#__codelineno-23-10"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PUT</span>
-</span></code></pre></div>
-<p>iv) complex expression with nested operations:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-24-2"><a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a><span class="w">  </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="c1"># auth enforced only on requests to POST /resources/* or PUT /resources/*</span>
-</span><span id="__span-24-3"><a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a>
-</span><span id="__span-24-4"><a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">any</span><span class="p">:</span>
-</span><span id="__span-24-5"><a id="__codelineno-24-5" name="__codelineno-24-5" href="#__codelineno-24-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">all</span><span class="p">:</span>
-</span><span id="__span-24-6"><a id="__codelineno-24-6" name="__codelineno-24-6" href="#__codelineno-24-6"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-24-7"><a id="__codelineno-24-7" name="__codelineno-24-7" href="#__codelineno-24-7"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-24-8"><a id="__codelineno-24-8" name="__codelineno-24-8" href="#__codelineno-24-8"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-24-9"><a id="__codelineno-24-9" name="__codelineno-24-9" href="#__codelineno-24-9"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-24-10"><a id="__codelineno-24-10" name="__codelineno-24-10" href="#__codelineno-24-10"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-24-11"><a id="__codelineno-24-11" name="__codelineno-24-11" href="#__codelineno-24-11"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">^/resources/.*</span>
-</span><span id="__span-24-12"><a id="__codelineno-24-12" name="__codelineno-24-12" href="#__codelineno-24-12"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">all</span><span class="p">:</span>
-</span><span id="__span-24-13"><a id="__codelineno-24-13" name="__codelineno-24-13" href="#__codelineno-24-13"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-24-14"><a id="__codelineno-24-14" name="__codelineno-24-14" href="#__codelineno-24-14"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-24-15"><a id="__codelineno-24-15" name="__codelineno-24-15" href="#__codelineno-24-15"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PUT</span>
-</span><span id="__span-24-16"><a id="__codelineno-24-16" name="__codelineno-24-16" href="#__codelineno-24-16"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-24-17"><a id="__codelineno-24-17" name="__codelineno-24-17" href="#__codelineno-24-17"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-24-18"><a id="__codelineno-24-18" name="__codelineno-24-18" href="#__codelineno-24-18"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">^/resources/.*</span>
-</span></code></pre></div>
-<p>v) more concise equivalent of the above (with implicit AND operator at the top level):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-25-1"><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-25-2"><a id="__codelineno-25-2" name="__codelineno-25-2" href="#__codelineno-25-2"></a><span class="w">  </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="c1"># auth enforced only on requests to /resources/* path with method equals to POST or PUT</span>
-</span><span id="__span-25-3"><a id="__codelineno-25-3" name="__codelineno-25-3" href="#__codelineno-25-3"></a>
-</span><span id="__span-25-4"><a id="__codelineno-25-4" name="__codelineno-25-4" href="#__codelineno-25-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-25-5"><a id="__codelineno-25-5" name="__codelineno-25-5" href="#__codelineno-25-5"></a><span class="w">    </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-25-6"><a id="__codelineno-25-6" name="__codelineno-25-6" href="#__codelineno-25-6"></a><span class="w">    </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">^/resources/.*</span>
-</span><span id="__span-25-7"><a id="__codelineno-25-7" name="__codelineno-25-7" href="#__codelineno-25-7"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">any</span><span class="p">:</span>
-</span><span id="__span-25-8"><a id="__codelineno-25-8" name="__codelineno-25-8" href="#__codelineno-25-8"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-25-9"><a id="__codelineno-25-9" name="__codelineno-25-9" href="#__codelineno-25-9"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-25-10"><a id="__codelineno-25-10" name="__codelineno-25-10" href="#__codelineno-25-10"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-25-11"><a id="__codelineno-25-11" name="__codelineno-25-11" href="#__codelineno-25-11"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-25-12"><a id="__codelineno-25-12" name="__codelineno-25-12" href="#__codelineno-25-12"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-25-13"><a id="__codelineno-25-13" name="__codelineno-25-13" href="#__codelineno-25-13"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PUT</span>
-</span></code></pre></div>
-<p>vi) to skip part of an AuthConfig (i.e., a specific auth rule):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-26-1"><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-26-2"><a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a><span class="w">  </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-26-3"><a id="__codelineno-26-3" name="__codelineno-26-3" href="#__codelineno-26-3"></a><span class="w">    </span><span class="s">&quot;metadata-source&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-26-4"><a id="__codelineno-26-4" name="__codelineno-26-4" href="#__codelineno-26-4"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-26-5"><a id="__codelineno-26-5" name="__codelineno-26-5" href="#__codelineno-26-5"></a><span class="w">        </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://my-metadata-source.io</span>
-</span><span id="__span-26-6"><a id="__codelineno-26-6" name="__codelineno-26-6" href="#__codelineno-26-6"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="c1"># only fetch the external metadata if the context is HTTP method other than OPTIONS</span>
-</span><span id="__span-26-7"><a id="__codelineno-26-7" name="__codelineno-26-7" href="#__codelineno-26-7"></a>
-</span><span id="__span-26-8"><a id="__codelineno-26-8" name="__codelineno-26-8" href="#__codelineno-26-8"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-26-9"><a id="__codelineno-26-9" name="__codelineno-26-9" href="#__codelineno-26-9"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-26-10"><a id="__codelineno-26-10" name="__codelineno-26-10" href="#__codelineno-26-10"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">OPTIONS</span>
-</span></code></pre></div>
-<p>vii) skipping part of an AuthConfig will not affect other auth rules:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-27-1"><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-27-2"><a id="__codelineno-27-2" name="__codelineno-27-2" href="#__codelineno-27-2"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-27-3"><a id="__codelineno-27-3" name="__codelineno-27-3" href="#__codelineno-27-3"></a><span class="w">    </span><span class="s">&quot;authn-meth-1&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-27-4"><a id="__codelineno-27-4" name="__codelineno-27-4" href="#__codelineno-27-4"></a><span class="w">      </span><span class="nt">apiKey</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span><span class="w"> </span><span class="c1"># this auth rule only triggers for POST requests to /foo[/*]</span>
-</span><span id="__span-27-5"><a id="__codelineno-27-5" name="__codelineno-27-5" href="#__codelineno-27-5"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-27-6"><a id="__codelineno-27-6" name="__codelineno-27-6" href="#__codelineno-27-6"></a>
-</span><span id="__span-27-7"><a id="__codelineno-27-7" name="__codelineno-27-7" href="#__codelineno-27-7"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-27-8"><a id="__codelineno-27-8" name="__codelineno-27-8" href="#__codelineno-27-8"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-27-9"><a id="__codelineno-27-9" name="__codelineno-27-9" href="#__codelineno-27-9"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-27-10"><a id="__codelineno-27-10" name="__codelineno-27-10" href="#__codelineno-27-10"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-27-11"><a id="__codelineno-27-11" name="__codelineno-27-11" href="#__codelineno-27-11"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-27-12"><a id="__codelineno-27-12" name="__codelineno-27-12" href="#__codelineno-27-12"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">^/foo(/.*)?$</span>
-</span><span id="__span-27-13"><a id="__codelineno-27-13" name="__codelineno-27-13" href="#__codelineno-27-13"></a>
-</span><span id="__span-27-14"><a id="__codelineno-27-14" name="__codelineno-27-14" href="#__codelineno-27-14"></a><span class="w">    </span><span class="s">&quot;authn-meth-2&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="c1"># this auth rule triggerred regardless</span>
-</span><span id="__span-27-15"><a id="__codelineno-27-15" name="__codelineno-27-15" href="#__codelineno-27-15"></a><span class="w">      </span><span class="nt">jwt</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<p>viii) concrete use-case: evaluating only the necessary identity checks based on the user's indication of the preferred authentication method (prefix of the value supplied in the HTTP <code>Authorization</code> request header):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-28-1"><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-28-2"><a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-28-3"><a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a><span class="w">    </span><span class="s">&quot;jwt&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-28-4"><a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-28-5"><a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a>
-</span><span id="__span-28-6"><a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.headers.authorization</span>
-</span><span id="__span-28-7"><a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-28-8"><a id="__codelineno-28-8" name="__codelineno-28-8" href="#__codelineno-28-8"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">JWT .+</span>
-</span><span id="__span-28-9"><a id="__codelineno-28-9" name="__codelineno-28-9" href="#__codelineno-28-9"></a><span class="w">      </span><span class="nt">jwt</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-28-10"><a id="__codelineno-28-10" name="__codelineno-28-10" href="#__codelineno-28-10"></a>
-</span><span id="__span-28-11"><a id="__codelineno-28-11" name="__codelineno-28-11" href="#__codelineno-28-11"></a><span class="w">    </span><span class="s">&quot;api-key&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-28-12"><a id="__codelineno-28-12" name="__codelineno-28-12" href="#__codelineno-28-12"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-28-13"><a id="__codelineno-28-13" name="__codelineno-28-13" href="#__codelineno-28-13"></a>
-</span><span id="__span-28-14"><a id="__codelineno-28-14" name="__codelineno-28-14" href="#__codelineno-28-14"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.headers.authorization</span>
-</span><span id="__span-28-15"><a id="__codelineno-28-15" name="__codelineno-28-15" href="#__codelineno-28-15"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-28-16"><a id="__codelineno-28-16" name="__codelineno-28-16" href="#__codelineno-28-16"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">APIKEY .+</span>
-</span><span id="__span-28-17"><a id="__codelineno-28-17" name="__codelineno-28-17" href="#__codelineno-28-17"></a><span class="w">      </span><span class="nt">apiKey</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<p>ix) to avoid repetition while defining patterns for conditions:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-29-1"><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-29-2"><a id="__codelineno-29-2" name="__codelineno-29-2" href="#__codelineno-29-2"></a><span class="w">  </span><span class="nt">patterns</span><span class="p">:</span>
-</span><span id="__span-29-3"><a id="__codelineno-29-3" name="__codelineno-29-3" href="#__codelineno-29-3"></a><span class="w">    </span><span class="nt">a-pet</span><span class="p">:</span><span class="w"> </span><span class="c1"># a named pattern that can be reused in sets of conditions</span>
-</span><span id="__span-29-4"><a id="__codelineno-29-4" name="__codelineno-29-4" href="#__codelineno-29-4"></a>
-</span><span id="__span-29-5"><a id="__codelineno-29-5" name="__codelineno-29-5" href="#__codelineno-29-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-29-6"><a id="__codelineno-29-6" name="__codelineno-29-6" href="#__codelineno-29-6"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-29-7"><a id="__codelineno-29-7" name="__codelineno-29-7" href="#__codelineno-29-7"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">^/pets/\d+(/.*)$</span>
-</span><span id="__span-29-8"><a id="__codelineno-29-8" name="__codelineno-29-8" href="#__codelineno-29-8"></a>
-</span><span id="__span-29-9"><a id="__codelineno-29-9" name="__codelineno-29-9" href="#__codelineno-29-9"></a><span class="w">  </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-29-10"><a id="__codelineno-29-10" name="__codelineno-29-10" href="#__codelineno-29-10"></a><span class="w">    </span><span class="s">&quot;pets-info&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-29-11"><a id="__codelineno-29-11" name="__codelineno-29-11" href="#__codelineno-29-11"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-29-12"><a id="__codelineno-29-12" name="__codelineno-29-12" href="#__codelineno-29-12"></a>
-</span><span id="__span-29-13"><a id="__codelineno-29-13" name="__codelineno-29-13" href="#__codelineno-29-13"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">patternRef</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">a-pet</span>
-</span><span id="__span-29-14"><a id="__codelineno-29-14" name="__codelineno-29-14" href="#__codelineno-29-14"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-29-15"><a id="__codelineno-29-15" name="__codelineno-29-15" href="#__codelineno-29-15"></a><span class="w">        </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://pets-info.io?petId={context.request.http.path.@extract:{&quot;sep&quot;:&quot;/&quot;,&quot;pos&quot;:2}}</span>
-</span><span id="__span-29-16"><a id="__codelineno-29-16" name="__codelineno-29-16" href="#__codelineno-29-16"></a>
-</span><span id="__span-29-17"><a id="__codelineno-29-17" name="__codelineno-29-17" href="#__codelineno-29-17"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-29-18"><a id="__codelineno-29-18" name="__codelineno-29-18" href="#__codelineno-29-18"></a><span class="w">    </span><span class="s">&quot;pets-owners-only&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-29-19"><a id="__codelineno-29-19" name="__codelineno-29-19" href="#__codelineno-29-19"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-29-20"><a id="__codelineno-29-20" name="__codelineno-29-20" href="#__codelineno-29-20"></a>
-</span><span id="__span-29-21"><a id="__codelineno-29-21" name="__codelineno-29-21" href="#__codelineno-29-21"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">patternRef</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">a-pet</span>
-</span><span id="__span-29-22"><a id="__codelineno-29-22" name="__codelineno-29-22" href="#__codelineno-29-22"></a><span class="w">      </span><span class="nt">opa</span><span class="p">:</span>
-</span><span id="__span-29-23"><a id="__codelineno-29-23" name="__codelineno-29-23" href="#__codelineno-29-23"></a><span class="w">        </span><span class="nt">rego</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">|</span>
-</span><span id="__span-29-24"><a id="__codelineno-29-24" name="__codelineno-29-24" href="#__codelineno-29-24"></a><span class="w">          </span><span class="no">allow { input.metadata[&quot;pets-info&quot;].ownerid == input.auth.identity.userid }</span>
-</span></code></pre></div>
-<p>x) combining literals and refs – concrete case: authentication required for selected operations:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-30-1"><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-30-2"><a id="__codelineno-30-2" name="__codelineno-30-2" href="#__codelineno-30-2"></a><span class="w">  </span><span class="nt">patterns</span><span class="p">:</span>
-</span><span id="__span-30-3"><a id="__codelineno-30-3" name="__codelineno-30-3" href="#__codelineno-30-3"></a><span class="w">    </span><span class="nt">api-base-path</span><span class="p">:</span>
-</span><span id="__span-30-4"><a id="__codelineno-30-4" name="__codelineno-30-4" href="#__codelineno-30-4"></a>
-</span><span id="__span-30-5"><a id="__codelineno-30-5" name="__codelineno-30-5" href="#__codelineno-30-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-30-6"><a id="__codelineno-30-6" name="__codelineno-30-6" href="#__codelineno-30-6"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">matches</span>
-</span><span id="__span-30-7"><a id="__codelineno-30-7" name="__codelineno-30-7" href="#__codelineno-30-7"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">^/api/.*</span>
-</span><span id="__span-30-8"><a id="__codelineno-30-8" name="__codelineno-30-8" href="#__codelineno-30-8"></a>
-</span><span id="__span-30-9"><a id="__codelineno-30-9" name="__codelineno-30-9" href="#__codelineno-30-9"></a><span class="w">    </span><span class="nt">authenticated-user</span><span class="p">:</span>
-</span><span id="__span-30-10"><a id="__codelineno-30-10" name="__codelineno-30-10" href="#__codelineno-30-10"></a>
-</span><span id="__span-30-11"><a id="__codelineno-30-11" name="__codelineno-30-11" href="#__codelineno-30-11"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.anonymous</span>
-</span><span id="__span-30-12"><a id="__codelineno-30-12" name="__codelineno-30-12" href="#__codelineno-30-12"></a><span class="w">      </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">neq</span>
-</span><span id="__span-30-13"><a id="__codelineno-30-13" name="__codelineno-30-13" href="#__codelineno-30-13"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;true&quot;</span>
-</span><span id="__span-30-14"><a id="__codelineno-30-14" name="__codelineno-30-14" href="#__codelineno-30-14"></a>
-</span><span id="__span-30-15"><a id="__codelineno-30-15" name="__codelineno-30-15" href="#__codelineno-30-15"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-30-16"><a id="__codelineno-30-16" name="__codelineno-30-16" href="#__codelineno-30-16"></a><span class="w">    </span><span class="nt">api-users</span><span class="p">:</span><span class="w"> </span><span class="c1"># tries to authenticate all requests to path /api/*</span>
-</span><span id="__span-30-17"><a id="__codelineno-30-17" name="__codelineno-30-17" href="#__codelineno-30-17"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-30-18"><a id="__codelineno-30-18" name="__codelineno-30-18" href="#__codelineno-30-18"></a>
-</span><span id="__span-30-19"><a id="__codelineno-30-19" name="__codelineno-30-19" href="#__codelineno-30-19"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">patternRef</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api-base-path</span>
-</span><span id="__span-30-20"><a id="__codelineno-30-20" name="__codelineno-30-20" href="#__codelineno-30-20"></a><span class="w">      </span><span class="nt">jwt</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-30-21"><a id="__codelineno-30-21" name="__codelineno-30-21" href="#__codelineno-30-21"></a>
-</span><span id="__span-30-22"><a id="__codelineno-30-22" name="__codelineno-30-22" href="#__codelineno-30-22"></a><span class="w">    </span><span class="nt">others</span><span class="p">:</span><span class="w"> </span><span class="c1"># defaults to anonymous access when authentication fails or not /api/* path</span>
-</span><span id="__span-30-23"><a id="__codelineno-30-23" name="__codelineno-30-23" href="#__codelineno-30-23"></a><span class="w">      </span><span class="nt">anonymous</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span><span id="__span-30-24"><a id="__codelineno-30-24" name="__codelineno-30-24" href="#__codelineno-30-24"></a><span class="w">      </span><span class="nt">priority</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-30-25"><a id="__codelineno-30-25" name="__codelineno-30-25" href="#__codelineno-30-25"></a>
-</span><span id="__span-30-26"><a id="__codelineno-30-26" name="__codelineno-30-26" href="#__codelineno-30-26"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-30-27"><a id="__codelineno-30-27" name="__codelineno-30-27" href="#__codelineno-30-27"></a><span class="w">    </span><span class="nt">api-write-access-requires-authentication</span><span class="p">:</span><span class="w"> </span><span class="c1"># POST/PUT/DELETE requests to /api/* path cannot be anonymous</span>
-</span><span id="__span-30-28"><a id="__codelineno-30-28" name="__codelineno-30-28" href="#__codelineno-30-28"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-30-29"><a id="__codelineno-30-29" name="__codelineno-30-29" href="#__codelineno-30-29"></a>
-</span><span id="__span-30-30"><a id="__codelineno-30-30" name="__codelineno-30-30" href="#__codelineno-30-30"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">all</span><span class="p">:</span>
-</span><span id="__span-30-31"><a id="__codelineno-30-31" name="__codelineno-30-31" href="#__codelineno-30-31"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">patternRef</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api-base-path</span>
-</span><span id="__span-30-32"><a id="__codelineno-30-32" name="__codelineno-30-32" href="#__codelineno-30-32"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">any</span><span class="p">:</span>
-</span><span id="__span-30-33"><a id="__codelineno-30-33" name="__codelineno-30-33" href="#__codelineno-30-33"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-30-34"><a id="__codelineno-30-34" name="__codelineno-30-34" href="#__codelineno-30-34"></a><span class="w">            </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-30-35"><a id="__codelineno-30-35" name="__codelineno-30-35" href="#__codelineno-30-35"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-30-36"><a id="__codelineno-30-36" name="__codelineno-30-36" href="#__codelineno-30-36"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-30-37"><a id="__codelineno-30-37" name="__codelineno-30-37" href="#__codelineno-30-37"></a><span class="w">            </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-30-38"><a id="__codelineno-30-38" name="__codelineno-30-38" href="#__codelineno-30-38"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PUT</span>
-</span><span id="__span-30-39"><a id="__codelineno-30-39" name="__codelineno-30-39" href="#__codelineno-30-39"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.method</span>
-</span><span id="__span-30-40"><a id="__codelineno-30-40" name="__codelineno-30-40" href="#__codelineno-30-40"></a><span class="w">            </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-30-41"><a id="__codelineno-30-41" name="__codelineno-30-41" href="#__codelineno-30-41"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DELETE</span>
-</span><span id="__span-30-42"><a id="__codelineno-30-42" name="__codelineno-30-42" href="#__codelineno-30-42"></a><span class="w">      </span><span class="nt">opa</span><span class="p">:</span>
-</span><span id="__span-30-43"><a id="__codelineno-30-43" name="__codelineno-30-43" href="#__codelineno-30-43"></a><span class="w">        </span><span class="nt">patternMatching</span><span class="p">:</span>
-</span><span id="__span-30-44"><a id="__codelineno-30-44" name="__codelineno-30-44" href="#__codelineno-30-44"></a><span class="w">          </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-30-45"><a id="__codelineno-30-45" name="__codelineno-30-45" href="#__codelineno-30-45"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">patternRef</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authenticated-user</span>
-</span><span id="__span-30-46"><a id="__codelineno-30-46" name="__codelineno-30-46" href="#__codelineno-30-46"></a>
-</span><span id="__span-30-47"><a id="__codelineno-30-47" name="__codelineno-30-47" href="#__codelineno-30-47"></a><span class="w">  </span><span class="nt">response</span><span class="p">:</span><span class="w"> </span><span class="c1"># bonus: export user data if available</span>
-</span><span id="__span-30-48"><a id="__codelineno-30-48" name="__codelineno-30-48" href="#__codelineno-30-48"></a><span class="w">    </span><span class="nt">success</span><span class="p">:</span>
-</span><span id="__span-30-49"><a id="__codelineno-30-49" name="__codelineno-30-49" href="#__codelineno-30-49"></a><span class="w">      </span><span class="nt">dynamicMetadata</span><span class="p">:</span>
-</span><span id="__span-30-50"><a id="__codelineno-30-50" name="__codelineno-30-50" href="#__codelineno-30-50"></a><span class="w">        </span><span class="s">&quot;user-data&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-30-51"><a id="__codelineno-30-51" name="__codelineno-30-51" href="#__codelineno-30-51"></a><span class="w">          </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-30-52"><a id="__codelineno-30-52" name="__codelineno-30-52" href="#__codelineno-30-52"></a>
-</span><span id="__span-30-53"><a id="__codelineno-30-53" name="__codelineno-30-53" href="#__codelineno-30-53"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">patternRef</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authenticated-user</span>
-</span><span id="__span-30-54"><a id="__codelineno-30-54" name="__codelineno-30-54" href="#__codelineno-30-54"></a><span class="w">          </span><span class="nt">json</span><span class="p">:</span>
-</span><span id="__span-30-55"><a id="__codelineno-30-55" name="__codelineno-30-55" href="#__codelineno-30-55"></a><span class="w">            </span><span class="nt">properties</span><span class="p">:</span>
-</span><span id="__span-30-56"><a id="__codelineno-30-56" name="__codelineno-30-56" href="#__codelineno-30-56"></a><span class="w">              </span><span class="nt">jwt-claims</span><span class="p">:</span>
-</span><span id="__span-30-57"><a id="__codelineno-30-57" name="__codelineno-30-57" href="#__codelineno-30-57"></a><span class="w">                </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity</span>
-</span></code></pre></div>
-<h2 id="common-feature-caching-cache">Common feature: Caching (<code>cache</code>)<a class="headerlink" href="#common-feature-caching-cache" title="Permanent link">&para;</a></h2>
-<p>Objects resolved at runtime in an <a href="../architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a> can be cached "in-memory", and avoided being evaluated again at a subsequent request, until it expires. A lookup cache key and a TTL can be set individually for any evaluator config in an AuthConfig.</p>
-<p>Each cache config induces a completely independent cache table (or "cache namespace"). Consequently, different evaluator configs can use the same cache key and there will be no collision between entries from different evaluators.</p>
-<p>E.g.:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-31-1"><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-31-2"><a id="__codelineno-31-2" name="__codelineno-31-2" href="#__codelineno-31-2"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-31-3"><a id="__codelineno-31-3" name="__codelineno-31-3" href="#__codelineno-31-3"></a>
-</span><span id="__span-31-4"><a id="__codelineno-31-4" name="__codelineno-31-4" href="#__codelineno-31-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-api.io</span>
-</span><span id="__span-31-5"><a id="__codelineno-31-5" name="__codelineno-31-5" href="#__codelineno-31-5"></a>
-</span><span id="__span-31-6"><a id="__codelineno-31-6" name="__codelineno-31-6" href="#__codelineno-31-6"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-31-7"><a id="__codelineno-31-7" name="__codelineno-31-7" href="#__codelineno-31-7"></a>
-</span><span id="__span-31-8"><a id="__codelineno-31-8" name="__codelineno-31-8" href="#__codelineno-31-8"></a><span class="w">  </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-31-9"><a id="__codelineno-31-9" name="__codelineno-31-9" href="#__codelineno-31-9"></a><span class="w">    </span><span class="s">&quot;external-metadata&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-31-10"><a id="__codelineno-31-10" name="__codelineno-31-10" href="#__codelineno-31-10"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-31-11"><a id="__codelineno-31-11" name="__codelineno-31-11" href="#__codelineno-31-11"></a><span class="w">        </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">http://my-external-source?search={context.request.http.path}</span>
-</span><span id="__span-31-12"><a id="__codelineno-31-12" name="__codelineno-31-12" href="#__codelineno-31-12"></a><span class="w">      </span><span class="nt">cache</span><span class="p">:</span>
-</span><span id="__span-31-13"><a id="__codelineno-31-13" name="__codelineno-31-13" href="#__codelineno-31-13"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span>
-</span><span id="__span-31-14"><a id="__codelineno-31-14" name="__codelineno-31-14" href="#__codelineno-31-14"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">context.request.http.path</span>
-</span><span id="__span-31-15"><a id="__codelineno-31-15" name="__codelineno-31-15" href="#__codelineno-31-15"></a><span class="w">        </span><span class="nt">ttl</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-31-16"><a id="__codelineno-31-16" name="__codelineno-31-16" href="#__codelineno-31-16"></a>
-</span><span id="__span-31-17"><a id="__codelineno-31-17" name="__codelineno-31-17" href="#__codelineno-31-17"></a><span class="w">  </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-31-18"><a id="__codelineno-31-18" name="__codelineno-31-18" href="#__codelineno-31-18"></a><span class="w">    </span><span class="s">&quot;complex-policy&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-31-19"><a id="__codelineno-31-19" name="__codelineno-31-19" href="#__codelineno-31-19"></a><span class="w">      </span><span class="nt">opa</span><span class="p">:</span>
-</span><span id="__span-31-20"><a id="__codelineno-31-20" name="__codelineno-31-20" href="#__codelineno-31-20"></a><span class="w">        </span><span class="nt">externalPolicy</span><span class="p">:</span>
-</span><span id="__span-31-21"><a id="__codelineno-31-21" name="__codelineno-31-21" href="#__codelineno-31-21"></a><span class="w">          </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">http://my-policy-registry</span>
-</span><span id="__span-31-22"><a id="__codelineno-31-22" name="__codelineno-31-22" href="#__codelineno-31-22"></a><span class="w">      </span><span class="nt">cache</span><span class="p">:</span>
-</span><span id="__span-31-23"><a id="__codelineno-31-23" name="__codelineno-31-23" href="#__codelineno-31-23"></a><span class="w">        </span><span class="nt">key</span><span class="p">:</span>
-</span><span id="__span-31-24"><a id="__codelineno-31-24" name="__codelineno-31-24" href="#__codelineno-31-24"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;{auth.identity.group}-{context.request.http.method}-{context.request.http.path}&quot;</span>
-</span><span id="__span-31-25"><a id="__codelineno-31-25" name="__codelineno-31-25" href="#__codelineno-31-25"></a><span class="w">        </span><span class="nt">ttl</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span></code></pre></div>
-<p>The example above sets caching for the 'external-metadata' metadata config and for the 'complex-policy' authorization policy. In the case of 'external-metadata', the cache key is the path of the original HTTP request being authorized by Authorino (fetched dynamically from the <a href="../architecture/#the-authorization-json">Authorization JSON</a>); i.e., after obtaining a metadata object from the external source for a given contextual HTTP path one first time, whenever that same HTTP path repeats in a subsequent request, Authorino will use the cached object instead of sending a request again to the external source of metadata. After 5 minutes (300 seconds), the cache entry will expire and Authorino will fetch again from the source if requested.</p>
-<p>As for the 'complex-policy' authorization policy, the cache key is a string composed the 'group' the identity belongs to, the method of the HTTP request and the path of the HTTP request. Whenever these repeat, Authorino will use the result of the policy that was evaluated and cached priorly. Cache entries in this namespace expire after 60 seconds.</p>
-<p><strong>Notes on evaluator caching</strong></p>
-<p><em>Capacity</em> - By default, each cache namespace is limited to 1 mb. Entries will be evicted following First-In-First-Out (FIFO) policy to release space. The individual capacity of cache namespaces is set at the level of the Authorino instance (via <code>--evaluator-cache-size</code> command-line flag or <code>spec.evaluatorCacheSize</code> field of the <code>Authorino</code> CR).</p>
-<p><em>Usage</em> - Avoid caching objects whose evaluation is considered to be relatively cheap. Examples of operations associated to Authorino auth features that are usually NOT worth caching: validation of JSON Web Tokens (JWT), Kubernetes TokenReviews and SubjectAccessReviews, API key validation, simple JSON pattern-matching authorization rules, simple OPA policies. Examples of operations where caching may be desired: OAuth2 token introspection, fetching of metadata from external sources (via HTTP request), complex OPA policies.</p>
-<h2 id="common-feature-metrics-metrics">Common feature: Metrics (<code>metrics</code>)<a class="headerlink" href="#common-feature-metrics-metrics" title="Permanent link">&para;</a></h2>
-<p>By default, Authorino will only export metrics down to the level of the AuthConfig. Deeper metrics at the level of each evaluator within an AuthConfig can be activated by setting the common field <code>metrics: true</code> of the evaluator config.</p>
-<p>E.g.:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-32-1"><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-32-2"><a id="__codelineno-32-2" name="__codelineno-32-2" href="#__codelineno-32-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-32-3"><a id="__codelineno-32-3" name="__codelineno-32-3" href="#__codelineno-32-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-32-4"><a id="__codelineno-32-4" name="__codelineno-32-4" href="#__codelineno-32-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-authconfig</span>
-</span><span id="__span-32-5"><a id="__codelineno-32-5" name="__codelineno-32-5" href="#__codelineno-32-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-ns</span>
-</span><span id="__span-32-6"><a id="__codelineno-32-6" name="__codelineno-32-6" href="#__codelineno-32-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-32-7"><a id="__codelineno-32-7" name="__codelineno-32-7" href="#__codelineno-32-7"></a><span class="w">  </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-32-8"><a id="__codelineno-32-8" name="__codelineno-32-8" href="#__codelineno-32-8"></a><span class="w">    </span><span class="s">&quot;my-external-metadata&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-32-9"><a id="__codelineno-32-9" name="__codelineno-32-9" href="#__codelineno-32-9"></a><span class="w">      </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-32-10"><a id="__codelineno-32-10" name="__codelineno-32-10" href="#__codelineno-32-10"></a><span class="w">        </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">http://my-external-source?search={context.request.http.path}</span>
-</span><span id="__span-32-11"><a id="__codelineno-32-11" name="__codelineno-32-11" href="#__codelineno-32-11"></a><span class="w">      </span><span class="nt">metrics</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span></code></pre></div>
-<p>The above will enable the metrics <code>auth_server_evaluator_duration_seconds</code> (histogram) and <code>auth_server_evaluator_total</code> (counter) with labels <code>namespace="my-ns"</code>, <code>authconfig="my-authconfig"</code>, <code>evaluator_type="METADATA_GENERIC_HTTP"</code> and <code>evaluator_name="my-external-metadata"</code>.</p>
-<p>The same pattern works for other types of evaluators. Find below the list of all types and corresponding label constant used in the metric:</p>
-<table>
-<thead>
-<tr>
-<th>Evaluator type</th>
-<th>Metric's <code>evaluator_type</code> label</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>authentication.apiKey</code></td>
-<td>IDENTITY_APIKEY</td>
-</tr>
-<tr>
-<td><code>authentication.kubernetesTokenReview</code></td>
-<td>IDENTITY_KUBERNETES</td>
-</tr>
-<tr>
-<td><code>authentication.jwt</code></td>
-<td>IDENTITY_OIDC</td>
-</tr>
-<tr>
-<td><code>authentication.oauth2Introspection</code></td>
-<td>IDENTITY_OAUTH2</td>
-</tr>
-<tr>
-<td><code>authentication.x509</code></td>
-<td>IDENTITY_MTLS</td>
-</tr>
-<tr>
-<td><code>authentication.plain</code></td>
-<td>IDENTITY_PLAIN</td>
-</tr>
-<tr>
-<td><code>authentication.anonymous</code></td>
-<td>IDENTITY_NOOP</td>
-</tr>
-<tr>
-<td><code>metadata.http</code></td>
-<td>METADATA_GENERIC_HTTP</td>
-</tr>
-<tr>
-<td><code>metadata.userInfo</code></td>
-<td>METADATA_USERINFO</td>
-</tr>
-<tr>
-<td><code>metadata.uma</code></td>
-<td>METADATA_UMA</td>
-</tr>
-<tr>
-<td><code>authorization.patternMatching</code></td>
-<td>AUTHORIZATION_JSON</td>
-</tr>
-<tr>
-<td><code>authorization.opa</code></td>
-<td>AUTHORIZATION_OPA</td>
-</tr>
-<tr>
-<td><code>authorization.kubernetesSubjectAccessReview</code></td>
-<td>AUTHORIZATION_KUBERNETES</td>
-</tr>
-<tr>
-<td><code>authorization.spicedb</code></td>
-<td>AUTHORIZATION_AUTHZED</td>
-</tr>
-<tr>
-<td><code>response.success..plain</code></td>
-<td>RESPONSE_PLAIN</td>
-</tr>
-<tr>
-<td><code>response.success..json</code></td>
-<td>RESPONSE_JSON</td>
-</tr>
-<tr>
-<td><code>response.success..wristband</code></td>
-<td>RESPONSE_WRISTBAND</td>
-</tr>
-</tbody>
-</table>
-<p>Metrics at the level of the evaluators can also be enforced to an entire Authorino instance, by setting the <code>--deep-metrics-enabled</code> command-line flag. In this case, regardless of the value of the field <code>spec.(authentication|metadata|authorization|response).metrics</code> in the AuthConfigs, individual metrics for all evaluators of all AuthConfigs will be exported.</p>
-<p>For more information about metrics exported by Authorino, see <a href="../user-guides/observability/#metrics">Observability</a>.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/getting-started/index.html b/0.10.0/authorino/docs/getting-started/index.html
deleted file mode 100644
index a6cc3f729..000000000
--- a/0.10.0/authorino/docs/getting-started/index.html
+++ /dev/null
@@ -1,4034 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/getting-started/">
-      
-      
-        <link rel="prev" href="../../../authorino-operator/">
-      
-      
-        <link rel="next" href="../user-guides/hello-world/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Getting Started - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#getting-started" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Getting Started
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Requirements">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#platform-requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Platform requirements
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#feature-specific-requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Feature-specific requirements
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#installation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Installation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-install-the-authorino-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step: Install the Authorino Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-request-an-authorino-instance" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step: Request an Authorino instance
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#protect-a-service" class="md-nav__link">
-    <span class="md-ellipsis">
-      Protect a service
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Protect a service">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#life-cycle" class="md-nav__link">
-    <span class="md-ellipsis">
-      Life cycle
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step: Setup Envoy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-apply-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step: Apply an AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#clean-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean-up
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Clean-up">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#remove-protection" class="md-nav__link">
-    <span class="md-ellipsis">
-      Remove protection
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#uninstall" class="md-nav__link">
-    <span class="md-ellipsis">
-      Uninstall
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#next-steps" class="md-nav__link">
-    <span class="md-ellipsis">
-      Next steps
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Requirements">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#platform-requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Platform requirements
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#feature-specific-requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Feature-specific requirements
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#installation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Installation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-install-the-authorino-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step: Install the Authorino Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-request-an-authorino-instance" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step: Request an Authorino instance
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#protect-a-service" class="md-nav__link">
-    <span class="md-ellipsis">
-      Protect a service
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Protect a service">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#life-cycle" class="md-nav__link">
-    <span class="md-ellipsis">
-      Life cycle
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step: Setup Envoy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-apply-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step: Apply an AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#clean-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean-up
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Clean-up">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#remove-protection" class="md-nav__link">
-    <span class="md-ellipsis">
-      Remove protection
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#uninstall" class="md-nav__link">
-    <span class="md-ellipsis">
-      Uninstall
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#next-steps" class="md-nav__link">
-    <span class="md-ellipsis">
-      Next steps
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/getting-started.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="getting-started">Getting started<a class="headerlink" href="#getting-started" title="Permanent link">&para;</a></h1>
-<p>This page covers requirements and instructions to deploy Authorino on a Kubernetes cluster, as well as the steps to declare, apply and try out a protection layer of authentication and authorization over your service, clean-up and complete uninstallation.</p>
-<p>If you prefer learning with an example, check out our <a href="../user-guides/hello-world/">Hello World</a>.</p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<h3 id="platform-requirements">Platform requirements<a class="headerlink" href="#platform-requirements" title="Permanent link">&para;</a></h3>
-<p>These are the platform requirements to use Authorino:</p>
-<ul>
-<li>
-<p><a href="https://kubernetes.io"><strong>Kubernetes</strong></a> server (recommended v1.21 or later), with permission to create Kubernetes Custom Resource Definitions (CRDs) (for bootstrapping Authorino and Authorino Operator)</p>
-<p><details markdown="1">
-<summary>Alternative: K8s distros and platforms</summary></p>
-<p>Alternatively to upstream Kubernetes, you should be able to use any other Kubernetes distribution or Kubernetes Management Platform (KMP) with support for Kubernetes Custom Resources Definitions (CRD) and custom controllers, such as <a href="https://www.openshift.com">Red Hat OpenShift</a>, <a href="https://www.ibm.com/cloud/kubernetes-service">IBM Cloud Kubernetes Service (IKS)</a>, <a href="http://cloud.google.com/kubernetes-engine">Google Kubernetes Engine (GKE)</a>, <a href="https://aws.amazon.com/eks">Amazon Elastic Kubernetes Service (EKS)</a> and <a href="https://azure.microsoft.com/en-us/services/kubernetes-service">Azure Kubernetes Service (AKS)</a>.
-</details></p>
-</li>
-<li>
-<p><a href="https://www.envoyproxy.io"><strong>Envoy</strong></a> proxy (recommended v1.19 or later), to wire up Upstream services (i.e. the services to be protected with Authorino) and external authorization filter (Authorino) for integrations based on the reverse-proxy architecture - <a href="https://github.com/kuadrant/authorino-examples#envoy">example</a></p>
-<p><details markdown="1">
-<summary>Alternative: Non-reverse-proxy integration</summary></p>
-<p>Technically, any client that implements Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/start/sandboxes/ext_authz">external authorization</a> gRPC protocol should be compatible with Authorino. For integrations based on the reverse-proxy architecture nevertheless, we strongly recommended that you leverage Envoy alongside Authorino.
-</details></p>
-</li>
-</ul>
-<h3 id="feature-specific-requirements">Feature-specific requirements<a class="headerlink" href="#feature-specific-requirements" title="Permanent link">&para;</a></h3>
-<p>A few examples are:</p>
-<ul>
-<li>
-<p>For <strong>OpenID Connect</strong>, make sure you have access to an identity provider (IdP) and an authority that can issue ID tokens (JWTs). Check out <a href="https://www.keycloak.org">Keycloak</a> which can solve both and connect to external identity sources and user federation like LDAP.</p>
-</li>
-<li>
-<p>For <strong>Kubernetes authentication</strong> tokens, platform support for the TokenReview and SubjectAccessReview APIs of Kubernetes shall be required. In case you want to be able to requests access tokens for clients running outside the custer, you may also want to check out the requisites for using Kubernetes <a href="https://kubernetes.io/docs/reference/kubernetes-api/authentication-resources/token-request-v1/">TokenRequest API</a> (GA in v1.20).</p>
-</li>
-<li>
-<p>For <strong>User-Managed Access (UMA)</strong> resource data, you will need a UMA-compliant server running as well. This can be an implementation of the UMA protocol by each upstream API itself or (more typically) an external server that knows about the resources. Again, Keycloak can be a good fit here as well. Just keep in mind that, whatever resource server you choose, changing-state actions commanded in the upstream APIs or other parties will have to be reflected in the resource server. Authorino will not do that for you.</p>
-</li>
-</ul>
-<p>Check out the <a href="../features/">Feature specification</a> page for more feature-specific requirements.</p>
-<h2 id="installation">Installation<a class="headerlink" href="#installation" title="Permanent link">&para;</a></h2>
-<h3 id="step-install-the-authorino-operator">Step: Install the Authorino Operator<a class="headerlink" href="#step-install-the-authorino-operator" title="Permanent link">&para;</a></h3>
-<p>The simplest way to install the Authorino Operator is by applying the manifest bundle:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<p>The above will install the latest build of the Authorino Operator and latest version of the manifests (CRDs and RBAC), which by default points as well to the latest build of Authorino, both based on the <code>main</code> branches of each component. To install a stable released version of the Operator and therefore also defaults to its latest compatible stable release of Authorino, replace <code>main</code> with another tag of a proper release of the Operator, e.g. 'v0.2.0'.</p>
-<p>This step will also install <a href="https://github.com/jetstack/cert-manager">cert-manager</a> in the cluster (required).</p>
-<p>Alternatively, you can deploy the Authorino Operator using the Operator Lifecycle Manager bundles. For instructions, check out <a href="https://docs.kuadrant.io/authorino-operator/#installing-via-olm">Installing via OLM</a>.</p>
-<h3 id="step-request-an-authorino-instance">Step: Request an Authorino instance<a class="headerlink" href="#step-request-an-authorino-instance" title="Permanent link">&para;</a></h3>
-<p>Choose either <a href="../architecture/#cluster-wide-vs-namespaced-instances">cluster-wide or namespaced deployment mode</a> and whether you want TLS termination enabled for the Authorino endpoints (gRPC authorization, raw HTTP authorization, and OIDC Festival Wristband Discovery listeners), and follow the corresponding instructions below.</p>
-<p>The instructions here are for centralized gateway or centralized authorization service architecture. Check out the <a href="../architecture/#topologies">Topologies</a> section of the docs for alternatively running Authorino in a sidecar container.</p>
-<details>
-<summary><strong>Cluster-wide (with TLS)</strong></summary>
-<p>Create the namespace:
-  <div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>authorino
-</span></code></pre></div></p>
-<p>Create the TLS certificates <small>(requires <a href="https://github.com/jetstack/cert-manager">cert-manager</a>; skip if you already have certificates and certificate keys created and stored in Kubernetes <code>Secret</code>s in the namespace)</small>:
-  <div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sSL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino/main/deploy/certs.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span><span class="s2">&quot;s/\$(AUTHORINO_INSTANCE)/authorino/g;s/\$(NAMESPACE)/authorino/g&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div></p>
-<p>Deploy Authorino:
-  <div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  replicas: 1</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">  clusterWide: true</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">  listener:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">    tls:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">      enabled: true</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      certSecretRef:</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">        name: authorino-server-cert</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="s">    tls:</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="s">      enabled: true</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="s">      certSecretRef:</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="s">        name: authorino-oidc-server-cert</span>
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-</details>
-<details>
-<summary><strong>Cluster-wide (without TLS)</strong></summary>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>authorino
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">metadata:</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">  name: authorino</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">spec:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">  image: quay.io/kuadrant/authorino:latest</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">  replicas: 1</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">  clusterWide: true</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">  listener:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">    tls:</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">      enabled: false</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="s">    tls:</span>
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a><span class="s">      enabled: false</span>
-</span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a><span class="s">EOF</span>
-</span></code></pre></div>
-</details>
-<details>
-<summary><strong>Namespaced (with TLS)</strong></summary>
-<p>Create the namespace:
-  <div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>myapp
-</span></code></pre></div></p>
-<p>Create the TLS certificates <small>(requires <a href="https://github.com/jetstack/cert-manager">cert-manager</a>; skip if you already have certificates and certificate keys created and stored in Kubernetes <code>Secret</code>s in the namespace)</small>:
-  <div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl<span class="w"> </span>-sSL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino/main/deploy/certs.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span><span class="s2">&quot;s/\$(AUTHORINO_INSTANCE)/authorino/g;s/\$(NAMESPACE)/myapp/g&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div></p>
-<p>Deploy Authorino:
-  <div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  image: quay.io/kuadrant/authorino:latest</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">  replicas: 1</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  clusterWide: false</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  listener:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">    tls:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">      enabled: true</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">      certSecretRef:</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">        name: authorino-server-cert</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="s">    tls:</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="s">      enabled: true</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="s">      certSecretRef:</span>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="s">        name: authorino-oidc-server-cert</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-</details>
-<details>
-<summary><strong>Namespaced (without TLS)</strong></summary>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>myapp
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">metadata:</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  name: authorino</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">spec:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">  image: quay.io/kuadrant/authorino:latest</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  replicas: 1</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  clusterWide: false</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">  listener:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">    tls:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">      enabled: false</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">    tls:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">      enabled: false</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">EOF</span>
-</span></code></pre></div>
-</details>
-<h2 id="protect-a-service">Protect a service<a class="headerlink" href="#protect-a-service" title="Permanent link">&para;</a></h2>
-<p>The most typical integration to protect services with Authorino is by putting the service (<em>upstream</em>) behind a reverse-proxy or API gateway, enabled with an authorization filter that ensures all requests to the service are first checked with the authorization server (Authorino).</p>
-<p>To do that, make sure you have your <strong>upstream service deployed and running</strong>, usually in the same Kubernetes server where you installed Authorino. Then, setup an <a href="https://www.envoyproxy.io">Envoy</a> proxy and create an Authorino <code>AuthConfig</code> for your service.</p>
-<p>Authorino exposes 2 interfaces to serve the authorization requests:</p>
-<ul>
-<li>a gRPC interface that implements Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/start/sandboxes/ext_authz">External Authorization protocol</a>;</li>
-<li>a raw HTTP authorization interface, suitable for using Authorino with Kubernetes ValidatingWebhook, for Envoy external authorization via HTTP, and other integrations (e.g. other proxies).</li>
-</ul>
-<p>To use Authorino as a simple satellite (sidecar) Policy Decision Point (PDP), applications can integrate directly via any of these interfaces. By integrating via a proxy or API gateway, the combination makes Authorino to perform as an external Policy Enforcement Point (PEP) completely decoupled from the application.</p>
-<h3 id="life-cycle">Life cycle<a class="headerlink" href="#life-cycle" title="Permanent link">&para;</a></h3>
-<p><img alt="API protection life cycle" src="http://www.plantuml.com/plantuml/png/jPBVIyD03CVV-rU4FZbasFru76DZA8YWWlfMa6kRjiUkkP7BYVElzzg2QujlOllI95_o_IJDpebYyOs98dVKT5Ai6YYmLDx8AtxAtkYA6YI174cG1ogsdeg3PKA6HH95ZBaegWn2lCcsYyrDjarf_tmFse6d4ri90YnIwjzvU59Q9WayFSIWHff9h-MeLuQrfj3cbZxi-NhlfRQioQPqrMZdD5KGnstsOAdKLHpFBcxhP0sFLk2kHUzCoSfx6QAfvQgtVC7SivOpkBp61g6q358Z19IKdAZ02ff0qSGpm7Y73ANIne5OKA6893fNWYEW1RoHwcVumfx9qr0z9Ll_cSnWfGKwFgFoeuCJShSwIoEqLTWJPxeea0PSBUW_G7Kuexc3h82Bu-pNex77A1eS3iotWr_wyzMcfrkTn44o7d0OX6Bdj4CgV6E-0G00" /></p>
-<h3 id="step-setup-envoy">Step: Setup Envoy<a class="headerlink" href="#step-setup-envoy" title="Permanent link">&para;</a></h3>
-<p>To configure Envoy for proxying requests targeting the upstream service and authorizing with Authorino, setup an Envoy configuration that enables Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/start/sandboxes/ext_authz">external authorization</a> HTTP filter. Store the configuration in a <code>ConfigMap</code>.</p>
-<p>These are the important bits in the Envoy configuration to activate Authorino:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nt">static_resources</span><span class="p">:</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">  </span><span class="nt">listeners</span><span class="p">:</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">address</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span><span class="w"> </span><span class="c1"># TCP socket address and port of the proxy</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w">    </span><span class="nt">filter_chains</span><span class="p">:</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">filters</span><span class="p">:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">envoy.http_connection_manager</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w">        </span><span class="nt">typed_config</span><span class="p">:</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="w">          </span><span class="s">&quot;@type&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="w">          </span><span class="nt">route_config</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span><span class="w"> </span><span class="c1"># routing configs - virtual host domain and endpoint matching patterns and corresponding upstream services to redirect the traffic</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="w">          </span><span class="nt">http_filters</span><span class="p">:</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">envoy.filters.http.ext_authz</span><span class="w"> </span><span class="c1"># the external authorization filter</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="w">            </span><span class="nt">typed_config</span><span class="p">:</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="w">              </span><span class="s">&quot;@type&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthz</span>
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a><span class="w">              </span><span class="nt">transport_api_version</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">V3</span>
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a><span class="w">              </span><span class="nt">failure_mode_allow</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">false</span><span class="w"> </span><span class="c1"># ensures only authenticated and authorized traffic goes through</span>
-</span><span id="__span-9-17"><a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a><span class="w">              </span><span class="nt">grpc_service</span><span class="p">:</span>
-</span><span id="__span-9-18"><a id="__codelineno-9-18" name="__codelineno-9-18" href="#__codelineno-9-18"></a><span class="w">                </span><span class="nt">envoy_grpc</span><span class="p">:</span>
-</span><span id="__span-9-19"><a id="__codelineno-9-19" name="__codelineno-9-19" href="#__codelineno-9-19"></a><span class="w">                  </span><span class="nt">cluster_name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-9-20"><a id="__codelineno-9-20" name="__codelineno-9-20" href="#__codelineno-9-20"></a><span class="w">                </span><span class="nt">timeout</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1s</span>
-</span><span id="__span-9-21"><a id="__codelineno-9-21" name="__codelineno-9-21" href="#__codelineno-9-21"></a><span class="w">  </span><span class="nt">clusters</span><span class="p">:</span>
-</span><span id="__span-9-22"><a id="__codelineno-9-22" name="__codelineno-9-22" href="#__codelineno-9-22"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-9-23"><a id="__codelineno-9-23" name="__codelineno-9-23" href="#__codelineno-9-23"></a><span class="w">    </span><span class="nt">connect_timeout</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">0.25s</span>
-</span><span id="__span-9-24"><a id="__codelineno-9-24" name="__codelineno-9-24" href="#__codelineno-9-24"></a><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">strict_dns</span>
-</span><span id="__span-9-25"><a id="__codelineno-9-25" name="__codelineno-9-25" href="#__codelineno-9-25"></a><span class="w">    </span><span class="nt">lb_policy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">round_robin</span>
-</span><span id="__span-9-26"><a id="__codelineno-9-26" name="__codelineno-9-26" href="#__codelineno-9-26"></a><span class="w">    </span><span class="nt">http2_protocol_options</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span><span id="__span-9-27"><a id="__codelineno-9-27" name="__codelineno-9-27" href="#__codelineno-9-27"></a><span class="w">    </span><span class="nt">load_assignment</span><span class="p">:</span>
-</span><span id="__span-9-28"><a id="__codelineno-9-28" name="__codelineno-9-28" href="#__codelineno-9-28"></a><span class="w">      </span><span class="nt">cluster_name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-9-29"><a id="__codelineno-9-29" name="__codelineno-9-29" href="#__codelineno-9-29"></a><span class="w">      </span><span class="nt">endpoints</span><span class="p">:</span>
-</span><span id="__span-9-30"><a id="__codelineno-9-30" name="__codelineno-9-30" href="#__codelineno-9-30"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lb_endpoints</span><span class="p">:</span>
-</span><span id="__span-9-31"><a id="__codelineno-9-31" name="__codelineno-9-31" href="#__codelineno-9-31"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">endpoint</span><span class="p">:</span>
-</span><span id="__span-9-32"><a id="__codelineno-9-32" name="__codelineno-9-32" href="#__codelineno-9-32"></a><span class="w">            </span><span class="nt">address</span><span class="p">:</span>
-</span><span id="__span-9-33"><a id="__codelineno-9-33" name="__codelineno-9-33" href="#__codelineno-9-33"></a><span class="w">              </span><span class="nt">socket_address</span><span class="p">:</span>
-</span><span id="__span-9-34"><a id="__codelineno-9-34" name="__codelineno-9-34" href="#__codelineno-9-34"></a><span class="w">                </span><span class="nt">address</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino-authorino-authorization</span><span class="w"> </span><span class="c1"># name of the Authorino service deployed – it can be the fully qualified name with `.&lt;namespace&gt;.svc.cluster.local` suffix (e.g. `authorino-authorino-authorization.myapp.svc.cluster.local`)</span>
-</span><span id="__span-9-35"><a id="__codelineno-9-35" name="__codelineno-9-35" href="#__codelineno-9-35"></a><span class="w">                </span><span class="nt">port_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50051</span>
-</span><span id="__span-9-36"><a id="__codelineno-9-36" name="__codelineno-9-36" href="#__codelineno-9-36"></a><span class="w">    </span><span class="nt">transport_socket</span><span class="p">:</span><span class="w"> </span><span class="c1"># in case TLS termination is enabled in Authorino; omit it otherwise</span>
-</span><span id="__span-9-37"><a id="__codelineno-9-37" name="__codelineno-9-37" href="#__codelineno-9-37"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">envoy.transport_sockets.tls</span>
-</span><span id="__span-9-38"><a id="__codelineno-9-38" name="__codelineno-9-38" href="#__codelineno-9-38"></a><span class="w">      </span><span class="nt">typed_config</span><span class="p">:</span>
-</span><span id="__span-9-39"><a id="__codelineno-9-39" name="__codelineno-9-39" href="#__codelineno-9-39"></a><span class="w">        </span><span class="s">&quot;@type&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">type.googleapis.com/envoy.extensions.transport_sockets.tls.v3.UpstreamTlsContext</span>
-</span><span id="__span-9-40"><a id="__codelineno-9-40" name="__codelineno-9-40" href="#__codelineno-9-40"></a><span class="w">        </span><span class="nt">common_tls_context</span><span class="p">:</span>
-</span><span id="__span-9-41"><a id="__codelineno-9-41" name="__codelineno-9-41" href="#__codelineno-9-41"></a><span class="w">          </span><span class="nt">validation_context</span><span class="p">:</span>
-</span><span id="__span-9-42"><a id="__codelineno-9-42" name="__codelineno-9-42" href="#__codelineno-9-42"></a><span class="w">            </span><span class="nt">trusted_ca</span><span class="p">:</span>
-</span><span id="__span-9-43"><a id="__codelineno-9-43" name="__codelineno-9-43" href="#__codelineno-9-43"></a><span class="w">              </span><span class="nt">filename</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/etc/ssl/certs/authorino-ca-cert.crt</span>
-</span></code></pre></div>
-<p>For a complete Envoy <code>ConfigMap</code> containing an upstream API protected with Authorino, with TLS enabled and option for rate limiting with <a href="https://docs.kuadrant.io/limitador/">Limitador</a>, plus a webapp served with under the same domain of the protected API, check out this <a href="https://github.com/Kuadrant/authorino-examples/blob/main/envoy/envoy-tls-deploy.yaml">example</a>.</p>
-<p>After creating the <code>ConfigMap</code> with the Envoy configuration, create an Envoy <code>Deployment</code> and <code>Service</code>. E.g.:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">apiVersion: apps/v1</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">kind: Deployment</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">metadata:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">  name: envoy</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">  labels:</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">    app: envoy</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="s">spec:</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">  selector:</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">    matchLabels:</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">      app: envoy</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">  template:</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">    metadata:</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">      labels:</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="s">        app: envoy</span>
-</span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="s">    spec:</span>
-</span><span id="__span-10-17"><a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a><span class="s">      containers:</span>
-</span><span id="__span-10-18"><a id="__codelineno-10-18" name="__codelineno-10-18" href="#__codelineno-10-18"></a>
-</span><span id="__span-10-19"><a id="__codelineno-10-19" name="__codelineno-10-19" href="#__codelineno-10-19"></a><span class="s">        - name: envoy</span>
-</span><span id="__span-10-20"><a id="__codelineno-10-20" name="__codelineno-10-20" href="#__codelineno-10-20"></a><span class="s">          image: envoyproxy/envoy:v1.19-latest</span>
-</span><span id="__span-10-21"><a id="__codelineno-10-21" name="__codelineno-10-21" href="#__codelineno-10-21"></a><span class="s">          command: [&quot;/usr/local/bin/envoy&quot;]</span>
-</span><span id="__span-10-22"><a id="__codelineno-10-22" name="__codelineno-10-22" href="#__codelineno-10-22"></a><span class="s">          args:</span>
-</span><span id="__span-10-23"><a id="__codelineno-10-23" name="__codelineno-10-23" href="#__codelineno-10-23"></a><span class="s">            - --config-path /usr/local/etc/envoy/envoy.yaml</span>
-</span><span id="__span-10-24"><a id="__codelineno-10-24" name="__codelineno-10-24" href="#__codelineno-10-24"></a><span class="s">            - --service-cluster front-proxy</span>
-</span><span id="__span-10-25"><a id="__codelineno-10-25" name="__codelineno-10-25" href="#__codelineno-10-25"></a><span class="s">            - --log-level info</span>
-</span><span id="__span-10-26"><a id="__codelineno-10-26" name="__codelineno-10-26" href="#__codelineno-10-26"></a><span class="s">            - --component-log-level filter:trace,http:debug,router:debug</span>
-</span><span id="__span-10-27"><a id="__codelineno-10-27" name="__codelineno-10-27" href="#__codelineno-10-27"></a><span class="s">          ports:</span>
-</span><span id="__span-10-28"><a id="__codelineno-10-28" name="__codelineno-10-28" href="#__codelineno-10-28"></a><span class="s">            - name: web</span>
-</span><span id="__span-10-29"><a id="__codelineno-10-29" name="__codelineno-10-29" href="#__codelineno-10-29"></a><span class="s">              containerPort: 8000 # matches the address of the listener in the envoy config</span>
-</span><span id="__span-10-30"><a id="__codelineno-10-30" name="__codelineno-10-30" href="#__codelineno-10-30"></a><span class="s">          volumeMounts:</span>
-</span><span id="__span-10-31"><a id="__codelineno-10-31" name="__codelineno-10-31" href="#__codelineno-10-31"></a><span class="s">            - name: config</span>
-</span><span id="__span-10-32"><a id="__codelineno-10-32" name="__codelineno-10-32" href="#__codelineno-10-32"></a><span class="s">              mountPath: /usr/local/etc/envoy</span>
-</span><span id="__span-10-33"><a id="__codelineno-10-33" name="__codelineno-10-33" href="#__codelineno-10-33"></a><span class="s">              readOnly: true</span>
-</span><span id="__span-10-34"><a id="__codelineno-10-34" name="__codelineno-10-34" href="#__codelineno-10-34"></a><span class="s">            - name: authorino-ca-cert # in case TLS termination is enabled in Authorino; omit it otherwise</span>
-</span><span id="__span-10-35"><a id="__codelineno-10-35" name="__codelineno-10-35" href="#__codelineno-10-35"></a><span class="s">              subPath: ca.crt</span>
-</span><span id="__span-10-36"><a id="__codelineno-10-36" name="__codelineno-10-36" href="#__codelineno-10-36"></a><span class="s">              mountPath: /etc/ssl/certs/authorino-ca-cert.crt</span>
-</span><span id="__span-10-37"><a id="__codelineno-10-37" name="__codelineno-10-37" href="#__codelineno-10-37"></a><span class="s">              readOnly: true</span>
-</span><span id="__span-10-38"><a id="__codelineno-10-38" name="__codelineno-10-38" href="#__codelineno-10-38"></a><span class="s">      volumes:</span>
-</span><span id="__span-10-39"><a id="__codelineno-10-39" name="__codelineno-10-39" href="#__codelineno-10-39"></a><span class="s">        - name: config</span>
-</span><span id="__span-10-40"><a id="__codelineno-10-40" name="__codelineno-10-40" href="#__codelineno-10-40"></a><span class="s">          configMap:</span>
-</span><span id="__span-10-41"><a id="__codelineno-10-41" name="__codelineno-10-41" href="#__codelineno-10-41"></a><span class="s">            name: envoy</span>
-</span><span id="__span-10-42"><a id="__codelineno-10-42" name="__codelineno-10-42" href="#__codelineno-10-42"></a><span class="s">            items:</span>
-</span><span id="__span-10-43"><a id="__codelineno-10-43" name="__codelineno-10-43" href="#__codelineno-10-43"></a><span class="s">              - key: envoy.yaml</span>
-</span><span id="__span-10-44"><a id="__codelineno-10-44" name="__codelineno-10-44" href="#__codelineno-10-44"></a><span class="s">                path: envoy.yaml</span>
-</span><span id="__span-10-45"><a id="__codelineno-10-45" name="__codelineno-10-45" href="#__codelineno-10-45"></a><span class="s">        - name: authorino-ca-cert # in case TLS termination is enabled in Authorino; omit it otherwise</span>
-</span><span id="__span-10-46"><a id="__codelineno-10-46" name="__codelineno-10-46" href="#__codelineno-10-46"></a><span class="s">          secret:</span>
-</span><span id="__span-10-47"><a id="__codelineno-10-47" name="__codelineno-10-47" href="#__codelineno-10-47"></a><span class="s">            defaultMode: 420</span>
-</span><span id="__span-10-48"><a id="__codelineno-10-48" name="__codelineno-10-48" href="#__codelineno-10-48"></a><span class="s">            secretName: authorino-ca-cert</span>
-</span><span id="__span-10-49"><a id="__codelineno-10-49" name="__codelineno-10-49" href="#__codelineno-10-49"></a><span class="s">  replicas: 1</span>
-</span><span id="__span-10-50"><a id="__codelineno-10-50" name="__codelineno-10-50" href="#__codelineno-10-50"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="s">kind: Service</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="s">metadata:</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="s">  name: envoy</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="s">spec:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="s">  selector:</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="s">    app: envoy</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="s">  ports:</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="s">    - name: web</span>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="s">      port: 8000</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="s">      protocol: TCP</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="step-apply-an-authconfig">Step: Apply an <code>AuthConfig</code><a class="headerlink" href="#step-apply-an-authconfig" title="Permanent link">&para;</a></h3>
-<p>Check out the <a href="../">docs</a> for a full description of Authorino's <a href="../architecture/#the-authorino-authconfig-custom-resource-definition-crd"><code>AuthConfig</code></a> Custom Resource Definition (CRD) and its <a href="../features/">features</a>.</p>
-<p>For examples based on specific use-cases, check out the <a href="../user-guides/">User guides</a>.</p>
-<p>For authentication based on OpenID Connect (OIDC) JSON Web Tokens (JWT), plus one simple JWT claim authorization check, a typical <code>AuthConfig</code> custom resource looks like the following:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: my-api-protection</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">spec:</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">  hosts: # any hosts that resolve to the envoy service and envoy routing config where the external authorization filter is enabled</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">  - my-api.io # north-south traffic through a Kubernetes `Ingress` or OpenShift `Route`</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">  - my-api.myapp.svc.cluster.local # east-west traffic (between applications within the cluster)</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="s">  authentication:</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">    &quot;idp-users&quot;:</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">      jwt:</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="s">        issuerUrl: https://my-idp.com/auth/realm</span>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="s">  authorization:</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="s">    &quot;check-claim&quot;:</span>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="s">        patterns:</span>
-</span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a><span class="s">        - selector: auth.identity.group</span>
-</span><span id="__span-12-20"><a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a><span class="s">          operator: eq</span>
-</span><span id="__span-12-21"><a id="__codelineno-12-21" name="__codelineno-12-21" href="#__codelineno-12-21"></a><span class="s">          value: allowed-users</span>
-</span><span id="__span-12-22"><a id="__codelineno-12-22" name="__codelineno-12-22" href="#__codelineno-12-22"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>After applying the <code>AuthConfig</code>, consumers of the protected service should be able to start sending requests.</p>
-<h2 id="clean-up">Clean-up<a class="headerlink" href="#clean-up" title="Permanent link">&para;</a></h2>
-<h3 id="remove-protection">Remove protection<a class="headerlink" href="#remove-protection" title="Permanent link">&para;</a></h3>
-<p>Delete the <code>AuthConfig</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>delete<span class="w"> </span>authconfig/my-api-protection
-</span></code></pre></div>
-<p>Decommission the Authorino instance:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<h3 id="uninstall">Uninstall<a class="headerlink" href="#uninstall" title="Permanent link">&para;</a></h3>
-<p>To completely remove Authorino CRDs, run from the Authorino Operator directory:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>make<span class="w"> </span>uninstall
-</span></code></pre></div>
-<h2 id="next-steps">Next steps<a class="headerlink" href="#next-steps" title="Permanent link">&para;</a></h2>
-<ol>
-<li>Read the <a href="../">docs</a>. The <a href="../architecture/">Architecture</a> page and the <a href="../features/">Features</a> page are good starting points to learn more about how Authorino works and its functionalities.</li>
-<li>Check out the <a href="../user-guides/">User guides</a> for several examples of <code>AuthConfig</code>s based on specific use-cases</li>
-</ol>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/index.html b/0.10.0/authorino/docs/index.html
deleted file mode 100644
index 6962ddadf..000000000
--- a/0.10.0/authorino/docs/index.html
+++ /dev/null
@@ -1,3426 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/">
-      
-      
-      
-      
-      <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Documentation - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#documentation" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Documentation
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting started
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#terminology" class="md-nav__link">
-    <span class="md-ellipsis">
-      Terminology
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#architecture" class="md-nav__link">
-    <span class="md-ellipsis">
-      Architecture
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#feature-description" class="md-nav__link">
-    <span class="md-ellipsis">
-      Feature description
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#user-guides" class="md-nav__link">
-    <span class="md-ellipsis">
-      User guides
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#developers-guide" class="md-nav__link">
-    <span class="md-ellipsis">
-      Developer’s guide
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="documentation">Documentation<a class="headerlink" href="#documentation" title="Permanent link">&para;</a></h1>
-<h2 id="getting-started"><a href="getting-started/">Getting started</a><a class="headerlink" href="#getting-started" title="Permanent link">&para;</a></h2>
-<h2 id="terminology"><a href="terminology/">Terminology</a><a class="headerlink" href="#terminology" title="Permanent link">&para;</a></h2>
-<h2 id="architecture"><a href="architecture/">Architecture</a><a class="headerlink" href="#architecture" title="Permanent link">&para;</a></h2>
-<h2 id="feature-description"><a href="features/">Feature description</a><a class="headerlink" href="#feature-description" title="Permanent link">&para;</a></h2>
-<h2 id="user-guides"><a href="user-guides/">User guides</a><a class="headerlink" href="#user-guides" title="Permanent link">&para;</a></h2>
-<h2 id="developers-guide"><a href="contributing/">Developer’s guide</a><a class="headerlink" href="#developers-guide" title="Permanent link">&para;</a></h2>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/terminology/index.html b/0.10.0/authorino/docs/terminology/index.html
deleted file mode 100644
index 65c14bbac..000000000
--- a/0.10.0/authorino/docs/terminology/index.html
+++ /dev/null
@@ -1,3478 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/terminology/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Terminology - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#terminology" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Terminology
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#terms" class="md-nav__link">
-    <span class="md-ellipsis">
-      Terms
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/terminology.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="terminology">Terminology<a class="headerlink" href="#terminology" title="Permanent link">&para;</a></h1>
-<p>Here we define some terms that are used in the project, with the goal of avoiding confusion and facilitating more
-accurate conversations related to <code>Authorino</code>.</p>
-<p>If you see terms used that are not here (or are used in place of terms here) please consider contributing a definition
-to this doc with a PR, or modifying the use elsewhere to align with these terms.</p>
-<h2 id="terms">Terms<a class="headerlink" href="#terms" title="Permanent link">&para;</a></h2>
-<p><strong>Access token</strong><br/>
-Type of temporary password (security token), tied to an authenticated identity, issued by an auth server as of request from either the identity subject itself or a registered auth client known by the auth server, and that delegates to a party powers to operate on behalf of that identity before a resource server; it can be formatted  as an opaque data string or as an encoded JSON Web Token (JWT).</p>
-<p><strong>Application Programming Interface (API)</strong><br/>
-Interface that defines interactions between multiple software applications; <em>(in HTTP communication)</em> set of endpoints and specification to expose resources hosted by a resource server, to be consumed by client applications; the access facade of a resource server.</p>
-<p><strong>Attribute-based Access Control (ABAC)</strong><br/>
-Authorization model that grants/denies access to resources based on evaluation of authorization policies which combine attributes together (from claims, from the request, from the resource, etc).</p>
-<p><strong>Auth</strong><br/>
-Usually employed as a short for authentication and authorization together (AuthN/AuthZ).</p>
-<p><strong>Auth client</strong><br/>
-Application client (software) that uses an auth server, either in the process of authenticating and/or authorizing identity subjects (including self) who want to consume resources from a resources server or auth server.</p>
-<p><strong>Auth server</strong><br/>
-Server where auth clients, users, roles, scopes, resources, policies and permissions can be stored and managed.</p>
-<p><strong>Authentication (AuthN)</strong><br/>
-Process of verifying that a given credential belongs to a claimed-to-be identity; usually resulting in the issuing of an access token.</p>
-<p><strong>Authorization (AuthZ)</strong><br/>
-Process of granting (or denying) access over a resource to a party based on the set of authorization rules, policies and/or permissions enforced.</p>
-<p><strong>Authorization header</strong><br/>
-HTTP request header frequently used to carry credentials to authenticate a user in an HTTP communication, like in requests sent to an API; alternatives usually include credentials carried in another (custom) HTTP header, query string parameter or HTTP cookie.</p>
-<p><strong>Capability</strong><br/>
-Usually employed to refer to a management feature of a Kubernetes-native system, based on the definition and use of Kubernetes Custom Resources (CRDs and CRs), that enables that system to one of the following “capability levels”: Basic Install, Seamless Upgrades, Full Lifecycle, Deep Insights, Auto Pilot.</p>
-<p><strong>Claim</strong><br/>
-Attribute packed in a security token which represents a claim that one who bears the token is making about an entity, usually an identity subject.</p>
-<p><strong>Client ID</strong><br/>
-Unique identifier of an auth client within an auth server domain (or auth server realm).</p>
-<p><strong>Client secret</strong><br/>
-Password presented by auth clients together with their Client IDs while authenticating with an auth server, either when requesting access tokens to be issued or when consuming services from the auth servers in general.</p>
-<p><strong>Delegation</strong><br/>
-Process of granting a party (usually an auth client) with powers to act, often with limited scope, on behalf of an identity, to access resources from a resource server. See also <em>OAuth2</em>.</p>
-<p><strong>Hash-based Message Authentication Code (HMAC)</strong><br/>
-Specific type of message authentication code (MAC) that involves a cryptographic hash function and a shared secret cryptographic key; it can be used to verify the authenticity of a message and therefore as an authentication method.</p>
-<p><strong>Identity</strong><br/>
-Set of properties that qualifies a subject as a strong identifiable entity (usually a user), who can be authenticated by an auth server. See also <em>Claims</em>.</p>
-<p><strong>Identity and Access Management (IAM) system</strong><br/>
-Auth system that implements and/or connects with sources of identity (IdP) and offers interfaces for managing access (authorization policies and permissions). See also <em>Auth server</em>.</p>
-<p><strong>Identity Provider (IdP)</strong><br/>
-Source of identity; it can be a feature of an auth server or external source connected to an auth server.</p>
-<p><strong>ID token</strong><br/>
-Special type of access token; an encoded JSON Web Token (JWT) that packs claims about an identity.</p>
-<p><strong><a href="https://tools.ietf.org/html/rfc7519">JSON Web Token (JWT)</a></strong><br/>
-JSON Web Tokens are an open, industry standard RFC 7519 method for representing claims securely between two parties.</p>
-<p><strong><a href="https://tools.ietf.org/html/rfc7515">JSON Web Signature (JWS)</a></strong><br/>
-Standard for signing arbitrary data, especially JSON Web Tokens (JWT).</p>
-<p><strong>JSON Web Key Set (JWKS)</strong><br/>
-Set of keys containing the public keys used to verify any JSON Web Token (JWT).</p>
-<p><strong><a href="https://www.keycloak.org">Keycloak</a></strong><br/>
-Open source auth server to allow single sign-on with identity and access management.</p>
-<p><strong>Lightweight Directory Access Protocol (LDAP)</strong><br/>
-Open standard for distributed directory information services for sharing of information about users, systems, networks, services and applications.</p>
-<p><strong>Mutual Transport Layer Security (mTLS)</strong><br/>
-Protocol for the mutual authentication of client-server communication, i.e., the client authenticates the server and the server authenticates the client, based on the acceptance of the X.509 certificates of each party.</p>
-<p><strong><a href="https://oauth.net/2">OAuth 2.0 (OAuth2)</a></strong><br/>
-Industry-standard protocol for delegation.</p>
-<p><strong><a href="https://openid.net/connect">OpenID Connect (OIDC)</a></strong><br/>
-Simple identity verification (authentication) layer built on top of the OAuth2 protocol.</p>
-<p><strong><a href="https://www.openpolicyagent.org">Open Policy Agent (OPA)</a></strong><br/>
-Authorization policy agent that enables the usage of declarative authorization policies written in Rego language.</p>
-<p><strong>Opaque token</strong><br/>
-Security token devoid of explicit meaning (e.g. random string); it requires the usage of lookup mechanism to be translated into a meaningful set claims representing an identity.</p>
-<p><strong>Permission</strong><br/>
-Association between a protected resource the authorization policies that must be evaluated whether access should be granted; e.g. <em><code>&lt;user|group|role&gt;</code> CAN DO <code>&lt;action&gt;</code> ON RESOURCE <code>&lt;X&gt;</code></em>.</p>
-<p><strong>Policy</strong><br/>
-Rule or condition (authorization policy) that must be satisfied to grant access to a resource; strongly related to the different access control mechanisms (ACMs) and strategies one can use to protect resources, e.g. attribute-based access control (ABAC), role-based access control (RBAC), context-based access control, user-based access control (UBAC).</p>
-<p><strong>Policy Administration Point (PAP)</strong><br/>
-Set of UIs and APIs to manage resources servers, resources, scopes, policies and permissions; it is where the auth system is configured.</p>
-<p><strong>Policy Decision Point (PDP)</strong><br/>
-Where the authorization requests are sent, with permissions being requested, and authorization policies are evaluated accordingly.</p>
-<p><strong>Policy Enforcement Point (PEP)</strong><br/>
-Where the authorization is effectively enforced, usually at the resource server or at a proxy, based on a response provided by the Policy Decision Point (PDP).</p>
-<p><strong>Policy storage</strong><br/>
-Where policies are stored and from where they can be fetched, perhaps to be cached.</p>
-<p><strong>Red Hat SSO</strong><br/>
-Auth server; downstream product created from the Keycloak Open Source project.</p>
-<p><strong><a href="https://tools.ietf.org/html/rfc6749#section-1.5">Refresh token</a></strong><br/>
-Special type of security token, often provided together with an access token in an OAuth2 flow, used to renew the duration of an access token before it expires; it requires client authentication.</p>
-<p><strong><a href="https://www.keycloak.org/docs/5.0/authorization_services/#_service_rpt_overview">Request Party Token (RPT)</a></strong><br/>
-JSON Web Token (JWT) digitally signed using JSON Web Signature (JWS), issued by the Keycloak auth server.</p>
-<p><strong>Resource</strong><br/>
-One or more endpoints of a system, API or server, that can be protected.</p>
-<p><strong>Resource-level Access Control (RLAC)</strong><br/>
-Authorization model that takes into consideration attributes of each specific request resource to grant/deny access to those resources (e.g. the resource's owner).</p>
-<p><strong>Resource server</strong><br/>
-Server that hosts protected resources.</p>
-<p><strong>Role</strong><br/>
-Aspect of a user’s identity assigned to the user to indicate the level of access they should have to the system; essentially, roles represent collections of permissions</p>
-<p><strong>Role-based Access Control (RBAC)</strong><br/>
-Authorization model that grants/denies access to resources based on the roles of authenticated users (rather than on complex attributes/policy rules).</p>
-<p><strong>Scope</strong><br/>
-Mechanism that defines the specific operations that applications can be allowed to do or information that they can request on an identity’s behalf; often presented as a parameter when access is requested as a way to communicate what access is needed, and used by auth server to respond what actual access is granted.</p>
-<p><strong><a href="https://en.wikipedia.org/wiki/Single-page_application">Single Page Application (SPA)</a></strong><br/>
-Web application or website that interacts with the user by dynamically rewriting the current web page with new data from the web server.</p>
-<p><strong><a href="https://en.wikipedia.org/wiki/Single_sign-on">Single Sign-on (SSO)</a></strong><br/>
-Authentication scheme that allows a user to log in with a single ID and password to any of several related, yet independent, software systems.</p>
-<p><strong>Upstream</strong><br/>
-<em>(In the context of authentication/authorization)</em> API whose endpoints must be protected by the auth system; the unprotected service in front of which a protection layer is added (by connecting with a Policy Decision Point).</p>
-<p><strong>User-based Access Control (UBAC)</strong><br/>
-Authorization model that grants/denies access to resources based on claims of the identity (attributes of the user).</p>
-<p><strong><a href="https://en.wikipedia.org/wiki/User-Managed_Access">User-Managed Access (UMA)</a></strong><br/>
-OAuth2-based access management protocol, used for users of an auth server to control the authorization process, i.e. directly granting/denying access to user-owned resources to other requesting parties.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/anonymous-access/index.html b/0.10.0/authorino/docs/user-guides/anonymous-access/index.html
deleted file mode 100644
index 16d1f7cac..000000000
--- a/0.10.0/authorino/docs/user-guides/anonymous-access/index.html
+++ /dev/null
@@ -1,3692 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/anonymous-access/">
-      
-      
-        <link rel="prev" href="../http-basic-authentication/">
-      
-      
-        <link rel="next" href="../token-normalization/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Anonymous access - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-anonymous-access" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Anonymous access
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/anonymous-access.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-anonymous-access">User guide: Anonymous access<a class="headerlink" href="#user-guide-anonymous-access" title="Permanent link">&para;</a></h1>
-<p>Bypass identity verification or fall back to anonymous access when credentials fail to validate</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="./../features.md#anonymous-access-authenticationanonymous">Anonymous access</a></li>
-    </ul>
-  </summary>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;public&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      anonymous: {}</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>The example above enables anonymous access (i.e. removes authentication), without adding any extra layer of protection to the API. This is virtually equivalent to setting a top-level <a href="../../features/#common-feature-conditions-when">condition</a> to the <code>AuthConfig</code> that always skips the configuration, or to switching authentication/authorization off completely in the route to the API.</p>
-<p>For more sophisticated use cases of anonymous access with Authorino, consider combining this feature with other identity sources in the <code>AuthConfig</code> while playing with the <a href="../../features/#common-feature-priorities">priorities</a> of each source, as well as combination with <code>when</code> <a href="../../features/#common-feature-conditions-when">conditions</a>, and/or adding authorization policies that either cover authentication or address anonymous access with proper rules (e.g. enforcing read-only access).</p>
-<p>Check out the docs for the <a href="../../features/#anonymous-access-authenticationanonymous">Anonymous access</a> feature for an example of an <code>AuthConfig</code> that falls back to anonymous access when a priority OIDC/JWT-based authentication fails, and enforces a read-only policy in such cases.</p>
-<h2 id="consume-the-api">❻ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/api-key-authentication/index.html b/0.10.0/authorino/docs/user-guides/api-key-authentication/index.html
deleted file mode 100644
index 4866acd38..000000000
--- a/0.10.0/authorino/docs/user-guides/api-key-authentication/index.html
+++ /dev/null
@@ -1,3757 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/api-key-authentication/">
-      
-      
-        <link rel="prev" href="../kubernetes-tokenreview/">
-      
-      
-        <link rel="next" href="../mtls-authentication/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Authentication with API keys - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-authentication-with-api-keys" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Authentication with API keys
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#delete-an-api-key-revoke-access-to-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Delete an API key (revoke access to the API)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#delete-an-api-key-revoke-access-to-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Delete an API key (revoke access to the API)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/api-key-authentication.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-authentication-with-api-keys">User guide: Authentication with API keys<a class="headerlink" href="#user-guide-authentication-with-api-keys" title="Permanent link">&para;</a></h1>
-<p>Issue API keys stored in Kubernetes <code>Secret</code>s for clients to authenticate with your protected hosts.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-    </ul>
-  </summary>
-<p>In Authorino, API keys are stored as Kubernetes <code>Secret</code>s. Each resource must contain an <code>api_key</code> entry with the value of the API key, and labeled to match the selectors specified in <code>spec.identity.apiKey.selector</code> of the <code>AuthConfig</code>.</p>
-<p>API key <code>Secret</code>s must also include labels that match the <code>secretLabelSelector</code> field of the Authorino instance. See <a href="../../architecture/#resource-reconciliation-and-status-update">Resource reconciliation and status update</a> for details.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;friends&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">        selector:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">            group: friends</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">          prefix: APIKEY</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-an-api-key">❻ Create an API key<a class="headerlink" href="#create-an-api-key" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">  labels:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    group: friends</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">stringData:</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>With a valid API key:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>With missing or invalid API key:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY invalid&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="c1"># www-authenticate: APIKEY realm=&quot;friends&quot;</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="c1"># x-ext-auth-reason: the API Key provided is invalid</span>
-</span></code></pre></div>
-<h2 id="delete-an-api-key-revoke-access-to-the-api">❽ Delete an API key (revoke access to the API)<a class="headerlink" href="#delete-an-api-key-revoke-access-to-the-api" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-1
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/index.html b/0.10.0/authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/index.html
deleted file mode 100644
index 4268914d4..000000000
--- a/0.10.0/authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/index.html
+++ /dev/null
@@ -1,3793 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/">
-      
-      
-        <link rel="prev" href="../injecting-data/">
-      
-      
-        <link rel="next" href="../deny-with-redirect-to-login/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Emitting Envoy Dynamic Metadata - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-authenticated-rate-limiting-with-envoy-dynamic-metadata" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Emitting Envoy Dynamic Metadata
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-limitador" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy Limitador
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-api-keys" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Create the API keys
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-limitador" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy Limitador
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-api-keys" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Create the API keys
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-authenticated-rate-limiting-with-envoy-dynamic-metadata">User guide: Authenticated rate limiting (with Envoy Dynamic Metadata)<a class="headerlink" href="#user-guide-authenticated-rate-limiting-with-envoy-dynamic-metadata" title="Permanent link">&para;</a></h1>
-<p>Provide Envoy with dynamic metadata about the external authorization process to be injected into the rate limiting filter.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Dynamic response → Response wrappers → <a href="../features.md#envoy-dynamic-metadata">Envoy Dynamic Metadata</a></li>
-      <li>Dynamic response → <a href="../features.md#json-injection-responsesuccessheadersdynamicmetadatajson">JSON injection</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-    </ul>
-  </summary>
-<p>Dynamic JSON objects built out of static values and values fetched from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a> can be wrapped to be returned to the reverse-proxy as Envoy Well Known Dynamic Metadata content. Envoy can use those to inject data returned by the external authorization service into the other filters, such as the rate limiting filter.</p>
-<p>Check out as well the user guides about <a href="../injecting-data/">Injecting data in the request</a> and <a href="../api-key-authentication/">Authentication with API keys</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❻.</p>
-        <p>At step ❻, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-limitador">❸ Deploy Limitador<a class="headerlink" href="#deploy-limitador" title="Permanent link">&para;</a></h2>
-<p><a href="https://github.com/kuadrant/limitador">Limitador</a> is a lightweight rate limiting service that can be used with Envoy.</p>
-<p>On this bundle, we will deploy Limitador pre-configured to limit requests to the <code>talker-api</code> domain up to 5 requests per interval of 60 seconds per <code>user_id</code>. Envoy will be configured to recognize the presence of Limitador and activate it on requests to the Talker API.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/limitador/limitador-deploy.yaml
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❹ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❺ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❻ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>An annotation <code>auth-data/username</code> will be read from the Kubernetes API Key secret and passed as dynamic metadata <code>{ "ext_auth_data": { "username": «annotations.auth-data/username» } }</code>.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">    &quot;friends&quot;:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">        selector:</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="s">            group: friends</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="s">          prefix: APIKEY</span>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="s">  response:</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="s">    success:</span>
-</span><span id="__span-7-21"><a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="s">      dynamicMetadata:</span>
-</span><span id="__span-7-22"><a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="s">        &quot;rate-limit&quot;:</span>
-</span><span id="__span-7-23"><a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a><span class="s">          json:</span>
-</span><span id="__span-7-24"><a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a><span class="s">            properties:</span>
-</span><span id="__span-7-25"><a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a><span class="s">              &quot;username&quot;:</span>
-</span><span id="__span-7-26"><a id="__codelineno-7-26" name="__codelineno-7-26" href="#__codelineno-7-26"></a><span class="s">                selector: auth.identity.metadata.annotations.auth-data\/username</span>
-</span><span id="__span-7-27"><a id="__codelineno-7-27" name="__codelineno-7-27" href="#__codelineno-7-27"></a><span class="s">          key: ext_auth_data # how this bit of dynamic metadata from the ext authz service is named in the Envoy config</span>
-</span><span id="__span-7-28"><a id="__codelineno-7-28" name="__codelineno-7-28" href="#__codelineno-7-28"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check out the docs for information about the common feature <a href="../../features/#common-feature-json-paths-selector">JSON paths</a> for reading from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>.</p>
-<h2 id="create-the-api-keys">❼ Create the API keys<a class="headerlink" href="#create-the-api-keys" title="Permanent link">&para;</a></h2>
-<p>For user John:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  labels:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">    group: friends</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  annotations:</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">    auth-data/username: john</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">stringData:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">type: Opaque</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>For user Jane:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: api-key-2</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">  labels:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">    group: friends</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">  annotations:</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">    auth-data/username: jane</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">stringData:</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">  api_key: 7BNaTmYGItSzXiwQLNHu82+x52p1XHgY</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="s">type: Opaque</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❽ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>As John:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Repeat the request a few more times within the 60-second time window, until the response status is <code>429 Too Many Requests</code>.</p>
-<p>While the API is still limited to John, send requests as Jane:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY 7BNaTmYGItSzXiwQLNHu82+x52p1XHgY&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-1
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-2
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/limitador/limitador-deploy.yaml
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/authzed/index.html b/0.10.0/authorino/docs/user-guides/authzed/index.html
deleted file mode 100644
index 5f3a67f99..000000000
--- a/0.10.0/authorino/docs/user-guides/authzed/index.html
+++ /dev/null
@@ -1,3930 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/authzed/">
-      
-      
-        <link rel="prev" href="../keycloak-authorization-services/">
-      
-      
-        <link rel="next" href="../injecting-data/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Integration with Authzed/SpiceDB - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-integration-with-authzedspicedb" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Integration with Authzed/SpiceDB
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-permission-database" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create the permission database
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-api-keys" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Create the API keys
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-permission-database" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create the permission database
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-api-keys" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Create the API keys
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/authzed.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-integration-with-authzedspicedb">User guide: Integration with Authzed/SpiceDB<a class="headerlink" href="#user-guide-integration-with-authzedspicedb" title="Permanent link">&para;</a></h1>
-<p>Permission requests sent to a Google Zanzibar-based <a href="https://authzed.com">Authzed/SpiceDB</a> instance, via gRPC.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Authorization → <a href="../features.md#spicedb-authorizationspicedb">SpiceDB</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-    </ul>
-  </summary>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❻.</p>
-        <p>At step ❻, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-the-permission-database">❺ Create the permission database<a class="headerlink" href="#create-the-permission-database" title="Permanent link">&para;</a></h2>
-<p>Create the namespace:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>spicedb
-</span></code></pre></div>
-<p>Create the SpiceDB instance:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>spicedb<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: apps/v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Deployment</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: spicedb</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">  labels:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">    app: spicedb</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">spec:</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  selector:</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">    matchLabels:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">      app: spicedb</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">  template:</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">    metadata:</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">      labels:</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="s">        app: spicedb</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="s">    spec:</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="s">      containers:</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="s">      - name: spicedb</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="s">        image: authzed/spicedb</span>
-</span><span id="__span-7-21"><a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="s">        args:</span>
-</span><span id="__span-7-22"><a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="s">        - serve</span>
-</span><span id="__span-7-23"><a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a><span class="s">        - &quot;--grpc-preshared-key&quot;</span>
-</span><span id="__span-7-24"><a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a><span class="s">        - secret</span>
-</span><span id="__span-7-25"><a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a><span class="s">        - &quot;--http-enabled&quot;</span>
-</span><span id="__span-7-26"><a id="__codelineno-7-26" name="__codelineno-7-26" href="#__codelineno-7-26"></a><span class="s">        ports:</span>
-</span><span id="__span-7-27"><a id="__codelineno-7-27" name="__codelineno-7-27" href="#__codelineno-7-27"></a><span class="s">        - containerPort: 50051</span>
-</span><span id="__span-7-28"><a id="__codelineno-7-28" name="__codelineno-7-28" href="#__codelineno-7-28"></a><span class="s">        - containerPort: 8443</span>
-</span><span id="__span-7-29"><a id="__codelineno-7-29" name="__codelineno-7-29" href="#__codelineno-7-29"></a><span class="s">  replicas: 1</span>
-</span><span id="__span-7-30"><a id="__codelineno-7-30" name="__codelineno-7-30" href="#__codelineno-7-30"></a><span class="s">---</span>
-</span><span id="__span-7-31"><a id="__codelineno-7-31" name="__codelineno-7-31" href="#__codelineno-7-31"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-32"><a id="__codelineno-7-32" name="__codelineno-7-32" href="#__codelineno-7-32"></a><span class="s">kind: Service</span>
-</span><span id="__span-7-33"><a id="__codelineno-7-33" name="__codelineno-7-33" href="#__codelineno-7-33"></a><span class="s">metadata:</span>
-</span><span id="__span-7-34"><a id="__codelineno-7-34" name="__codelineno-7-34" href="#__codelineno-7-34"></a><span class="s">  name: spicedb</span>
-</span><span id="__span-7-35"><a id="__codelineno-7-35" name="__codelineno-7-35" href="#__codelineno-7-35"></a><span class="s">spec:</span>
-</span><span id="__span-7-36"><a id="__codelineno-7-36" name="__codelineno-7-36" href="#__codelineno-7-36"></a><span class="s">  selector:</span>
-</span><span id="__span-7-37"><a id="__codelineno-7-37" name="__codelineno-7-37" href="#__codelineno-7-37"></a><span class="s">    app: spicedb</span>
-</span><span id="__span-7-38"><a id="__codelineno-7-38" name="__codelineno-7-38" href="#__codelineno-7-38"></a><span class="s">  ports:</span>
-</span><span id="__span-7-39"><a id="__codelineno-7-39" name="__codelineno-7-39" href="#__codelineno-7-39"></a><span class="s">    - name: grpc</span>
-</span><span id="__span-7-40"><a id="__codelineno-7-40" name="__codelineno-7-40" href="#__codelineno-7-40"></a><span class="s">      port: 50051</span>
-</span><span id="__span-7-41"><a id="__codelineno-7-41" name="__codelineno-7-41" href="#__codelineno-7-41"></a><span class="s">      protocol: TCP</span>
-</span><span id="__span-7-42"><a id="__codelineno-7-42" name="__codelineno-7-42" href="#__codelineno-7-42"></a><span class="s">    - name: http</span>
-</span><span id="__span-7-43"><a id="__codelineno-7-43" name="__codelineno-7-43" href="#__codelineno-7-43"></a><span class="s">      port: 8443</span>
-</span><span id="__span-7-44"><a id="__codelineno-7-44" name="__codelineno-7-44" href="#__codelineno-7-44"></a><span class="s">      protocol: TCP</span>
-</span><span id="__span-7-45"><a id="__codelineno-7-45" name="__codelineno-7-45" href="#__codelineno-7-45"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Forward local request to the SpiceDB service inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>spicedb<span class="w"> </span>port-forward<span class="w"> </span>service/spicedb<span class="w"> </span><span class="m">8443</span>:8443<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<p>Create the permission schema:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>http://localhost:8443/v1/schema/write<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">  </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: Bearer secret&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w">  </span>-H<span class="w"> </span><span class="s1">&#39;Content-Type: application/json&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">  </span>-d<span class="w"> </span>@-<span class="w"> </span><span class="s">&lt;&lt; EOF</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">{</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">  &quot;schema&quot;: &quot;definition blog/user {}\ndefinition blog/post {\n\trelation reader: blog/user\n\trelation writer: blog/user\n\n\tpermission read = reader + writer\n\tpermission write = writer\n}&quot;</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">}</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create the relationships:</p>
-<ul>
-<li><code>blog/user:emilia</code> → <code>writer</code> of <code>blog/post:1</code></li>
-<li><code>blog/user:beatrice</code> → <code>reader</code> of <code>blog/post:1</code></li>
-</ul>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>http://localhost:8443/v1/relationships/write<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">  </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: Bearer secret&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">  </span>-H<span class="w"> </span><span class="s1">&#39;Content-Type: application/json&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w">  </span>-d<span class="w"> </span>@-<span class="w"> </span><span class="s">&lt;&lt; EOF</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">{</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">  &quot;updates&quot;: [</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">    {</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="s">      &quot;operation&quot;: &quot;OPERATION_CREATE&quot;,</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">      &quot;relationship&quot;: {</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">        &quot;resource&quot;: {</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">          &quot;objectType&quot;: &quot;blog/post&quot;,</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">          &quot;objectId&quot;: &quot;1&quot;</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">        },</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">        &quot;relation&quot;: &quot;writer&quot;,</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="s">        &quot;subject&quot;: {</span>
-</span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="s">          &quot;object&quot;: {</span>
-</span><span id="__span-10-17"><a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a><span class="s">            &quot;objectType&quot;: &quot;blog/user&quot;,</span>
-</span><span id="__span-10-18"><a id="__codelineno-10-18" name="__codelineno-10-18" href="#__codelineno-10-18"></a><span class="s">            &quot;objectId&quot;: &quot;emilia&quot;</span>
-</span><span id="__span-10-19"><a id="__codelineno-10-19" name="__codelineno-10-19" href="#__codelineno-10-19"></a><span class="s">          }</span>
-</span><span id="__span-10-20"><a id="__codelineno-10-20" name="__codelineno-10-20" href="#__codelineno-10-20"></a><span class="s">        }</span>
-</span><span id="__span-10-21"><a id="__codelineno-10-21" name="__codelineno-10-21" href="#__codelineno-10-21"></a><span class="s">      }</span>
-</span><span id="__span-10-22"><a id="__codelineno-10-22" name="__codelineno-10-22" href="#__codelineno-10-22"></a><span class="s">    },</span>
-</span><span id="__span-10-23"><a id="__codelineno-10-23" name="__codelineno-10-23" href="#__codelineno-10-23"></a><span class="s">    {</span>
-</span><span id="__span-10-24"><a id="__codelineno-10-24" name="__codelineno-10-24" href="#__codelineno-10-24"></a><span class="s">      &quot;operation&quot;: &quot;OPERATION_CREATE&quot;,</span>
-</span><span id="__span-10-25"><a id="__codelineno-10-25" name="__codelineno-10-25" href="#__codelineno-10-25"></a><span class="s">      &quot;relationship&quot;: {</span>
-</span><span id="__span-10-26"><a id="__codelineno-10-26" name="__codelineno-10-26" href="#__codelineno-10-26"></a><span class="s">        &quot;resource&quot;: {</span>
-</span><span id="__span-10-27"><a id="__codelineno-10-27" name="__codelineno-10-27" href="#__codelineno-10-27"></a><span class="s">          &quot;objectType&quot;: &quot;blog/post&quot;,</span>
-</span><span id="__span-10-28"><a id="__codelineno-10-28" name="__codelineno-10-28" href="#__codelineno-10-28"></a><span class="s">          &quot;objectId&quot;: &quot;1&quot;</span>
-</span><span id="__span-10-29"><a id="__codelineno-10-29" name="__codelineno-10-29" href="#__codelineno-10-29"></a><span class="s">        },</span>
-</span><span id="__span-10-30"><a id="__codelineno-10-30" name="__codelineno-10-30" href="#__codelineno-10-30"></a><span class="s">        &quot;relation&quot;: &quot;reader&quot;,</span>
-</span><span id="__span-10-31"><a id="__codelineno-10-31" name="__codelineno-10-31" href="#__codelineno-10-31"></a><span class="s">        &quot;subject&quot;: {</span>
-</span><span id="__span-10-32"><a id="__codelineno-10-32" name="__codelineno-10-32" href="#__codelineno-10-32"></a><span class="s">          &quot;object&quot;: {</span>
-</span><span id="__span-10-33"><a id="__codelineno-10-33" name="__codelineno-10-33" href="#__codelineno-10-33"></a><span class="s">            &quot;objectType&quot;: &quot;blog/user&quot;,</span>
-</span><span id="__span-10-34"><a id="__codelineno-10-34" name="__codelineno-10-34" href="#__codelineno-10-34"></a><span class="s">            &quot;objectId&quot;: &quot;beatrice&quot;</span>
-</span><span id="__span-10-35"><a id="__codelineno-10-35" name="__codelineno-10-35" href="#__codelineno-10-35"></a><span class="s">          }</span>
-</span><span id="__span-10-36"><a id="__codelineno-10-36" name="__codelineno-10-36" href="#__codelineno-10-36"></a><span class="s">        }</span>
-</span><span id="__span-10-37"><a id="__codelineno-10-37" name="__codelineno-10-37" href="#__codelineno-10-37"></a><span class="s">      }</span>
-</span><span id="__span-10-38"><a id="__codelineno-10-38" name="__codelineno-10-38" href="#__codelineno-10-38"></a><span class="s">    }</span>
-</span><span id="__span-10-39"><a id="__codelineno-10-39" name="__codelineno-10-39" href="#__codelineno-10-39"></a><span class="s">  ]</span>
-</span><span id="__span-10-40"><a id="__codelineno-10-40" name="__codelineno-10-40" href="#__codelineno-10-40"></a><span class="s">}</span>
-</span><span id="__span-10-41"><a id="__codelineno-10-41" name="__codelineno-10-41" href="#__codelineno-10-41"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p>Store the shared token for Authorino to authenticate with the SpiceDB instance in a Service:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="s">metadata:</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="s">  name: spicedb</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="s">  labels:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="s">    app: spicedb</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="s">stringData:</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="s">  grpc-preshared-key: secret</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create the AuthConfig:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">spec:</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="s">    &quot;blog-users&quot;:</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">        selector:</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="s">            app: talker-api</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="s">          prefix: APIKEY</span>
-</span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a><span class="s">  authorization:</span>
-</span><span id="__span-12-20"><a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a><span class="s">    &quot;authzed-spicedb&quot;:</span>
-</span><span id="__span-12-21"><a id="__codelineno-12-21" name="__codelineno-12-21" href="#__codelineno-12-21"></a><span class="s">      spicedb:</span>
-</span><span id="__span-12-22"><a id="__codelineno-12-22" name="__codelineno-12-22" href="#__codelineno-12-22"></a><span class="s">        endpoint: spicedb.spicedb.svc.cluster.local:50051</span>
-</span><span id="__span-12-23"><a id="__codelineno-12-23" name="__codelineno-12-23" href="#__codelineno-12-23"></a><span class="s">        insecure: true</span>
-</span><span id="__span-12-24"><a id="__codelineno-12-24" name="__codelineno-12-24" href="#__codelineno-12-24"></a><span class="s">        sharedSecretRef:</span>
-</span><span id="__span-12-25"><a id="__codelineno-12-25" name="__codelineno-12-25" href="#__codelineno-12-25"></a><span class="s">          name: spicedb</span>
-</span><span id="__span-12-26"><a id="__codelineno-12-26" name="__codelineno-12-26" href="#__codelineno-12-26"></a><span class="s">          key: grpc-preshared-key</span>
-</span><span id="__span-12-27"><a id="__codelineno-12-27" name="__codelineno-12-27" href="#__codelineno-12-27"></a><span class="s">        subject:</span>
-</span><span id="__span-12-28"><a id="__codelineno-12-28" name="__codelineno-12-28" href="#__codelineno-12-28"></a><span class="s">          kind:</span>
-</span><span id="__span-12-29"><a id="__codelineno-12-29" name="__codelineno-12-29" href="#__codelineno-12-29"></a><span class="s">            value: blog/user</span>
-</span><span id="__span-12-30"><a id="__codelineno-12-30" name="__codelineno-12-30" href="#__codelineno-12-30"></a><span class="s">          name:</span>
-</span><span id="__span-12-31"><a id="__codelineno-12-31" name="__codelineno-12-31" href="#__codelineno-12-31"></a><span class="s">            selector: auth.identity.metadata.annotations.username</span>
-</span><span id="__span-12-32"><a id="__codelineno-12-32" name="__codelineno-12-32" href="#__codelineno-12-32"></a><span class="s">        resource:</span>
-</span><span id="__span-12-33"><a id="__codelineno-12-33" name="__codelineno-12-33" href="#__codelineno-12-33"></a><span class="s">          kind:</span>
-</span><span id="__span-12-34"><a id="__codelineno-12-34" name="__codelineno-12-34" href="#__codelineno-12-34"></a><span class="s">            value: blog/post</span>
-</span><span id="__span-12-35"><a id="__codelineno-12-35" name="__codelineno-12-35" href="#__codelineno-12-35"></a><span class="s">          name:</span>
-</span><span id="__span-12-36"><a id="__codelineno-12-36" name="__codelineno-12-36" href="#__codelineno-12-36"></a><span class="s">            selector: context.request.http.path.@extract:{&quot;sep&quot;:&quot;/&quot;,&quot;pos&quot;:2}</span>
-</span><span id="__span-12-37"><a id="__codelineno-12-37" name="__codelineno-12-37" href="#__codelineno-12-37"></a><span class="s">        permission:</span>
-</span><span id="__span-12-38"><a id="__codelineno-12-38" name="__codelineno-12-38" href="#__codelineno-12-38"></a><span class="s">          selector: context.request.http.method.@replace:{&quot;old&quot;:&quot;GET&quot;,&quot;new&quot;:&quot;read&quot;}.@replace:{&quot;old&quot;:&quot;POST&quot;,&quot;new&quot;:&quot;write&quot;}</span>
-</span><span id="__span-12-39"><a id="__codelineno-12-39" name="__codelineno-12-39" href="#__codelineno-12-39"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-the-api-keys">❼ Create the API keys<a class="headerlink" href="#create-the-api-keys" title="Permanent link">&para;</a></h2>
-<p>For Emilia (writer):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="s">metadata:</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="s">  name: api-key-writer</span>
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="s">  labels:</span>
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="s">    app: talker-api</span>
-</span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="s">  annotations:</span>
-</span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="s">    username: emilia</span>
-</span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="s">stringData:</span>
-</span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="s">  api_key: IAMEMILIA</span>
-</span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>For Beatrice (reader):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="s">metadata:</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="s">  name: api-key-reader</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="s">  labels:</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="s">    app: talker-api</span>
-</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="s">  annotations:</span>
-</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="s">    username: beatrice</span>
-</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="s">stringData:</span>
-</span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="s">  api_key: IAMBEATRICE</span>
-</span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❽ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>As Emilia, send a GET request:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMEMILIA&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="w">     </span>-X<span class="w"> </span>GET<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/posts/1<span class="w"> </span>-i
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Emilia, send a POST request:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMEMILIA&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="w">     </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/posts/1<span class="w"> </span>-i
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Beatrice, send a GET request:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMBEATRICE&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="w">     </span>-X<span class="w"> </span>GET<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/posts/1<span class="w"> </span>-i
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Beatrice, send a POST request:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMBEATRICE&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="w">     </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/posts/1<span class="w"> </span>-i
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="c1"># x-ext-auth-reason: PERMISSIONSHIP_NO_PERMISSION;token=GhUKEzE2NzU3MDE3MjAwMDAwMDAwMDA=</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-1
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>spicedb
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/caching/index.html b/0.10.0/authorino/docs/user-guides/caching/index.html
deleted file mode 100644
index ebab8bb37..000000000
--- a/0.10.0/authorino/docs/user-guides/caching/index.html
+++ /dev/null
@@ -1,3769 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/caching/">
-      
-      
-        <link rel="prev" href="../validating-webhook/">
-      
-      
-        <link rel="next" href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Caching - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-caching" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Caching
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/caching.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-caching">User guide: Caching<a class="headerlink" href="#user-guide-caching" title="Permanent link">&para;</a></h1>
-<p>Cache auth objects resolved at runtime for any configuration bit of an AuthConfig (i.e. any evaluator), of any phase (identity, metadata, authorization and dynamic response), for easy access in subsequent requests, whenever an arbitrary (user-defined) cache key repeats, until the cache entry expires.</p>
-<p>This is particularly useful for configuration bits whose evaluation is significantly more expensive than accessing the cache. E.g.:</p>
-<ul>
-<li>Caching of metadata fetched from external sources in general</li>
-<li>Caching of previously validated identity access tokens (e.g. for OAuth2 opaque tokens that involve consuming the token introspection endpoint of an external auth server)</li>
-<li>Caching of complex Rego policies that involve sending requests to external services</li>
-</ul>
-<p>Cases where one will <strong>NOT</strong> want to enable caching, due to relatively cheap compared to accessing and managing the cache:</p>
-<ul>
-<li>Validation of OIDC/JWT access tokens</li>
-<li>OPA/Rego policies that do not involve external requests</li>
-<li>JSON pattern-matching authorization</li>
-<li>Dynamic JSON responses</li>
-<li>Anonymous access</li>
-</ul>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Common feature → <a href="../features.md#common-feature-caching-cache">Caching</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#anonymous-access-authenticationanonymous">Anonymous access</a></li>
-      <li>External auth metadata → <a href="../features.md#http-getget-by-post-metadatahttp">HTTP GET/GET-by-POST</a></li>
-      <li>Authorization → <a href="../features.md#open-policy-agent-opa-rego-policies-authorizationopa">Open Policy Agent (OPA) Rego policies</a></li>
-      <li>Dynamic response → <a href="../features.md#json-injection-responsesuccessheadersdynamicmetadatajson">JSON injection</a></li>
-    </ul>
-  </summary>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>The example below enables caching for the external source of metadata, which in this case, for convenience, is the same upstream API protected by Authorino (i.e. the Talker API), though consumed directly by Authorino, without passing through the proxy. This API generates a <code>uuid</code> random hash that it injects in the JSON response. This value is different in every request processed by the API.</p>
-<p>The example also enables caching of returned OPA virtual documents. <code>cached-authz</code> is a trivial Rego policy that always grants access, but generates a timestamp, which Authorino will cache.</p>
-<p>In both cases, the path of the HTTP request is used as cache key. I.e., whenever the path repeats, Authorino reuse the values stored previously in each cache table (<code>cached-metadata</code> and <code>cached-authz</code>), respectively saving a request to the external source of metadata and the evaluation of the OPA policy. Cache entries will expire in both cases after 60 seconds they were stored in the cache.</p>
-<p>The cached values will be visible in the response returned by the Talker API in <code>x-authz-data</code> header injected by Authorino. This way, we can tell when an existing value in the cache was used and when a new one was generated and stored.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;anonymous&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      anonymous: {}</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">  metadata:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">    &quot;cached-metadata&quot;:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">      http:</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">        url: &quot;http://talker-api.default.svc.cluster.local:3000/metadata/{context.request.http.path}&quot;</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">      cache:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">        key:</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">          selector: context.request.http.path</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">        ttl: 60</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="s">  authorization:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="s">    &quot;cached-authz&quot;:</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="s">      opa:</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="s">        rego: |</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="s">          now = time.now_ns()</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="s">          allow = true</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="s">        allValues: true</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="s">      cache:</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="s">        key:</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="s">          selector: context.request.http.path</span>
-</span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a><span class="s">        ttl: 60</span>
-</span><span id="__span-6-32"><a id="__codelineno-6-32" name="__codelineno-6-32" href="#__codelineno-6-32"></a><span class="s">  response:</span>
-</span><span id="__span-6-33"><a id="__codelineno-6-33" name="__codelineno-6-33" href="#__codelineno-6-33"></a><span class="s">    success:</span>
-</span><span id="__span-6-34"><a id="__codelineno-6-34" name="__codelineno-6-34" href="#__codelineno-6-34"></a><span class="s">      headers:</span>
-</span><span id="__span-6-35"><a id="__codelineno-6-35" name="__codelineno-6-35" href="#__codelineno-6-35"></a><span class="s">        &quot;x-authz-data&quot;:</span>
-</span><span id="__span-6-36"><a id="__codelineno-6-36" name="__codelineno-6-36" href="#__codelineno-6-36"></a><span class="s">          json:</span>
-</span><span id="__span-6-37"><a id="__codelineno-6-37" name="__codelineno-6-37" href="#__codelineno-6-37"></a><span class="s">            properties:</span>
-</span><span id="__span-6-38"><a id="__codelineno-6-38" name="__codelineno-6-38" href="#__codelineno-6-38"></a><span class="s">              &quot;cached-metadata&quot;:</span>
-</span><span id="__span-6-39"><a id="__codelineno-6-39" name="__codelineno-6-39" href="#__codelineno-6-39"></a><span class="s">                selector: auth.metadata.cached-metadata.uuid</span>
-</span><span id="__span-6-40"><a id="__codelineno-6-40" name="__codelineno-6-40" href="#__codelineno-6-40"></a><span class="s">              &quot;cached-authz&quot;:</span>
-</span><span id="__span-6-41"><a id="__codelineno-6-41" name="__codelineno-6-41" href="#__codelineno-6-41"></a><span class="s">                selector: auth.authorization.cached-authz.now</span>
-</span><span id="__span-6-42"><a id="__codelineno-6-42" name="__codelineno-6-42" href="#__codelineno-6-42"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❻ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<ol>
-<li>To <code>/hello</code></li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="c1"># […]</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="c1">#  &quot;X-Authz-Data&quot;: &quot;{\&quot;cached-authz\&quot;:\&quot;1649343067462380300\&quot;,\&quot;cached-metadata\&quot;:\&quot;92c111cd-a10f-4e86-8bf0-e0cd646c6f79\&quot;}&quot;,</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="c1"># […]</span>
-</span></code></pre></div>
-<ol>
-<li>To a different path</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/goodbye
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># […]</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="c1">#  &quot;X-Authz-Data&quot;: &quot;{\&quot;cached-authz\&quot;:\&quot;1649343097860450300\&quot;,\&quot;cached-metadata\&quot;:\&quot;37fce386-1ee8-40a7-aed1-bf8a208f283c\&quot;}&quot;,</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="c1"># […]</span>
-</span></code></pre></div>
-<ol>
-<li>To <code>/hello</code> again <em>before</em> the cache entry expires (60 seconds from the first request sent to this path)</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="c1"># […]</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="c1">#  &quot;X-Authz-Data&quot;: &quot;{\&quot;cached-authz\&quot;:\&quot;1649343067462380300\&quot;,\&quot;cached-metadata\&quot;:\&quot;92c111cd-a10f-4e86-8bf0-e0cd646c6f79\&quot;}&quot;,  &lt;=== same cache-id as before</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="c1"># […]</span>
-</span></code></pre></div>
-<ol>
-<li>To <code>/hello</code> again <em>after</em> the cache entry expires (60 seconds from the first request sent to this path)</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># […]</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="c1">#  &quot;X-Authz-Data&quot;: &quot;{\&quot;cached-authz\&quot;:\&quot;1649343135702743800\&quot;,\&quot;cached-metadata\&quot;:\&quot;e708a3a6-5caf-4028-ab5c-573ad9be7188\&quot;}&quot;,  &lt;=== different cache-id</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># […]</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/deny-with-redirect-to-login/index.html b/0.10.0/authorino/docs/user-guides/deny-with-redirect-to-login/index.html
deleted file mode 100644
index cce2061fc..000000000
--- a/0.10.0/authorino/docs/user-guides/deny-with-redirect-to-login/index.html
+++ /dev/null
@@ -1,3913 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/deny-with-redirect-to-login/">
-      
-      
-        <link rel="prev" href="../authenticated-rate-limiting-envoy-dynamic-metadata/">
-      
-      
-        <link rel="next" href="../envoy-jwt-authn-and-authorino/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Redirecting to a login page - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-redirecting-to-a-login-page" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Redirecting to a login page
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-matrix-quotes-web-application" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Matrix Quotes web application
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-application" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the application
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#optional-modify-the-authconfig-to-authenticate-with-oidc" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ (Optional) Modify the AuthConfig to authenticate with OIDC
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❽ (Optional) Modify the AuthConfig to authenticate with OIDC">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setup-a-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup a Keycloak server
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#reconfigure-the-matrix-quotes-app-to-use-keycloaks-login-page" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reconfigure the Matrix Quotes app to use Keycloak's login page
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#apply-the-changes-to-the-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      Apply the changes to the AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-application-again" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the application again
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-matrix-quotes-web-application" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Matrix Quotes web application
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-application" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the application
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#optional-modify-the-authconfig-to-authenticate-with-oidc" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ (Optional) Modify the AuthConfig to authenticate with OIDC
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❽ (Optional) Modify the AuthConfig to authenticate with OIDC">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setup-a-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup a Keycloak server
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#reconfigure-the-matrix-quotes-app-to-use-keycloaks-login-page" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reconfigure the Matrix Quotes app to use Keycloak's login page
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#apply-the-changes-to-the-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      Apply the changes to the AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-application-again" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the application again
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/deny-with-redirect-to-login.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-redirecting-to-a-login-page">User guide: Redirecting to a login page<a class="headerlink" href="#user-guide-redirecting-to-a-login-page" title="Permanent link">&para;</a></h1>
-<p>Customize response status code and headers on failed requests to redirect users of a web application protected with Authorino to a login page instead of a <code>401 Unauthorized</code>.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Dynamic response → <a href="../features.md#custom-denial-status-responseunauthenticated-and-responseunauthorized">Custom denial status</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-    </ul>
-  </summary>
-<p>Authorino's default response status codes, messages and headers for unauthenticated (<code>401</code>) and unauthorized (<code>403</code>) requests can be customized with static values and values fetched from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>.</p>
-<p>Check out as well the user guides about <a href="../http-basic-authentication/">HTTP "Basic" Authentication (RFC 7235)</a> and <a href="../oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample web application called <strong>Matrix Quotes</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-matrix-quotes-web-application">❸ Deploy the Matrix Quotes web application<a class="headerlink" href="#deploy-the-matrix-quotes-web-application" title="Permanent link">&para;</a></h2>
-<p>The <strong>Matrix Quotes</strong> is a static web application that contains quotes from the film <em>The Matrix</em>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/matrix-quotes/matrix-quotes-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Matrix Quotes webapp behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/matrix-quotes/envoy-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>matrix-quotes.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: matrix-quotes-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - matrix-quotes.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;browser-users&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">        selector:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">            group: users</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">        cookie:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">          name: TOKEN</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">    &quot;http-basic-auth&quot;:</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="s">        selector:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="s">            group: users</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="s">          prefix: Basic</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="s">  response:</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="s">    unauthenticated:</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="s">      code: 302</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="s">      headers:</span>
-</span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a><span class="s">        &quot;Location&quot;:</span>
-</span><span id="__span-6-32"><a id="__codelineno-6-32" name="__codelineno-6-32" href="#__codelineno-6-32"></a><span class="s">          selector: &quot;http://matrix-quotes.127.0.0.1.nip.io:8000/login.html?redirect_to={request.path}&quot;</span>
-</span><span id="__span-6-33"><a id="__codelineno-6-33" name="__codelineno-6-33" href="#__codelineno-6-33"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check out the docs for information about the common feature <a href="../../features/#common-feature-json-paths-selector">JSON paths</a> for reading from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>.</p>
-<h2 id="create-an-api-key">❻ Create an API key<a class="headerlink" href="#create-an-api-key" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: user-credential-1</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">  labels:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    group: users</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">stringData:</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  api_key: am9objpw # john:p</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-application">❼ Consume the application<a class="headerlink" href="#consume-the-application" title="Permanent link">&para;</a></h2>
-<p>On a web browser, navigate to http://matrix-quotes.127.0.0.1.nip.io:8000.</p>
-<p>Click on the cards to read quotes from characters of the movie. You should be redirected to login page.</p>
-<p>Log in using John's credentials:</p>
-<ul>
-<li><strong>Username:</strong> john</li>
-<li><strong>Password:</strong> p</li>
-</ul>
-<p>Click again on the cards and check that now you are able to access the inner pages.</p>
-<p>You can also consume a protected endpoint of the application using HTTP Basic Authentication:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-u<span class="w"> </span>john:p<span class="w"> </span>http://matrix-quotes.127.0.0.1.nip.io:8000/neo.html
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="optional-modify-the-authconfig-to-authenticate-with-oidc">❽ (Optional) Modify the <code>AuthConfig</code> to authenticate with OIDC<a class="headerlink" href="#optional-modify-the-authconfig-to-authenticate-with-oidc" title="Permanent link">&para;</a></h2>
-<h3 id="setup-a-keycloak-server">Setup a Keycloak server<a class="headerlink" href="#setup-a-keycloak-server" title="Permanent link">&para;</a></h3>
-<p>Deploy a Keycloak server preloaded with a realm named <code>kuadrant</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p>Resolve local Keycloak domain so it can be accessed from the local host and inside the cluster with the name: (This will be needed to redirect to Keycloak's login page and at the same time validate issued tokens.)</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;127.0.0.1 keycloak&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>/etc/hosts
-</span></code></pre></div>
-<p>Forward local requests to the instance of Keycloak running in the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/keycloak<span class="w"> </span><span class="m">8080</span>:8080<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<p>Create a client:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="k">$(</span>curl<span class="w"> </span>http://keycloak:8080/realms/master/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=admin-cli&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=admin&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;Content-type: application/json&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="w">     </span>-d<span class="w"> </span><span class="s1">&#39;{ &quot;name&quot;: &quot;matrix-quotes&quot;, &quot;clientId&quot;: &quot;matrix-quotes&quot;, &quot;publicClient&quot;: true, &quot;redirectUris&quot;: [&quot;http://matrix-quotes.127.0.0.1.nip.io:8000/auth*&quot;], &quot;enabled&quot;: true }&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="w">     </span>http://keycloak:8080/admin/realms/kuadrant/clients
-</span></code></pre></div>
-<h3 id="reconfigure-the-matrix-quotes-app-to-use-keycloaks-login-page">Reconfigure the Matrix Quotes app to use Keycloak's login page<a class="headerlink" href="#reconfigure-the-matrix-quotes-app-to-use-keycloaks-login-page" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span><span class="nb">set</span><span class="w"> </span>env<span class="w"> </span>deployment/matrix-quotes<span class="w"> </span><span class="nv">KEYCLOAK_REALM</span><span class="o">=</span>http://keycloak:8080/realms/kuadrant<span class="w"> </span><span class="nv">CLIENT_ID</span><span class="o">=</span>matrix-quotes
-</span></code></pre></div>
-<h3 id="apply-the-changes-to-the-authconfig">Apply the changes to the <code>AuthConfig</code><a class="headerlink" href="#apply-the-changes-to-the-authconfig" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="s">metadata:</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="s">  name: matrix-quotes-protection</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="s">spec:</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a>
-</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="s">  - matrix-quotes.127.0.0.1.nip.io</span>
-</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="s">    &quot;idp-users&quot;:</span>
-</span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="s">        issuerUrl: http://keycloak:8080/realms/kuadrant</span>
-</span><span id="__span-14-14"><a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="s">      credentials:</span>
-</span><span id="__span-14-15"><a id="__codelineno-14-15" name="__codelineno-14-15" href="#__codelineno-14-15"></a><span class="s">        cookie:</span>
-</span><span id="__span-14-16"><a id="__codelineno-14-16" name="__codelineno-14-16" href="#__codelineno-14-16"></a><span class="s">          name: TOKEN</span>
-</span><span id="__span-14-17"><a id="__codelineno-14-17" name="__codelineno-14-17" href="#__codelineno-14-17"></a><span class="s">  response:</span>
-</span><span id="__span-14-18"><a id="__codelineno-14-18" name="__codelineno-14-18" href="#__codelineno-14-18"></a><span class="s">    unauthenticated:</span>
-</span><span id="__span-14-19"><a id="__codelineno-14-19" name="__codelineno-14-19" href="#__codelineno-14-19"></a><span class="s">      code: 302</span>
-</span><span id="__span-14-20"><a id="__codelineno-14-20" name="__codelineno-14-20" href="#__codelineno-14-20"></a><span class="s">      headers:</span>
-</span><span id="__span-14-21"><a id="__codelineno-14-21" name="__codelineno-14-21" href="#__codelineno-14-21"></a><span class="s">        &quot;Location&quot;:</span>
-</span><span id="__span-14-22"><a id="__codelineno-14-22" name="__codelineno-14-22" href="#__codelineno-14-22"></a><span class="s">          selector: &quot;http://keycloak:8080/realms/kuadrant/protocol/openid-connect/auth?client_id=matrix-quotes&amp;redirect_uri=http://matrix-quotes.127.0.0.1.nip.io:8000/auth?redirect_to={request.path}&amp;scope=openid&amp;response_type=code&quot;</span>
-</span><span id="__span-14-23"><a id="__codelineno-14-23" name="__codelineno-14-23" href="#__codelineno-14-23"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="consume-the-application-again">Consume the application again<a class="headerlink" href="#consume-the-application-again" title="Permanent link">&para;</a></h3>
-<p>Refresh the browser window or navigate again to http://matrix-quotes.127.0.0.1.nip.io:8000.</p>
-<p>Click on the cards to read quotes from characters of the movie. You should be redirected to login page this time served by the Keycloak server.</p>
-<p>Log in as Jane (a user of the Keycloak realm):</p>
-<ul>
-<li><strong>Username:</strong> jane</li>
-<li><strong>Password:</strong> p</li>
-</ul>
-<p>Click again on the cards and check that now you are able to access the inner pages.</p>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/user-credential-1
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/matrix-quotes-protection
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/matrix-quotes/matrix-quotes-deploy.yaml
-</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/index.html b/0.10.0/authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/index.html
deleted file mode 100644
index f36f9c3c8..000000000
--- a/0.10.0/authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/index.html
+++ /dev/null
@@ -1,4061 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/">
-      
-      
-        <link rel="prev" href="../token-normalization/">
-      
-      
-        <link rel="next" href="../external-metadata/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Edge Authentication Architecture (EAA) - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-edge-authentication-architecture-eaa" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Edge Authentication Architecture (EAA)
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-namespaces" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Create the namespaces
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-the-edge" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup the Edge
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❹ Setup the Edge">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup Envoy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-the-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create the AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-the-internal-workload" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Setup the internal workload
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❺ Setup the internal workload">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#setup-envoy_1" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup Envoy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-the-authconfig_1" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create the AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❼ Consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#using-the-api-key-to-authenticate" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the API key to authenticate
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authenticating-with-the-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authenticating with the Keycloak server
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-namespaces" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Create the namespaces
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-the-edge" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup the Edge
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❹ Setup the Edge">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup Envoy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-the-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create the AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-the-internal-workload" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Setup the internal workload
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❺ Setup the internal workload">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#setup-envoy_1" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup Envoy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-the-authconfig_1" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create the AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❼ Consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#using-the-api-key-to-authenticate" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the API key to authenticate
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authenticating-with-the-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      Authenticating with the Keycloak server
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/edge-authentication-architecture-festival-wristbands.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-edge-authentication-architecture-eaa">User guide: Edge Authentication Architecture (EAA)<a class="headerlink" href="#user-guide-edge-authentication-architecture-eaa" title="Permanent link">&para;</a></h1>
-<p>Edge Authentication Architecture (EAA) is a pattern where more than extracting authentication logics and specifics from the application codebase to a proper authN/authZ layer, this is pushed to the edge of your cloud network, without violating the Zero Trust principle nevertheless.</p>
-<p>The very definition of "edge" is subject to discussion, but the underlying idea is that clients (e.g. API clients, IoT devices, etc.) authenticate with a layer that, before moving traffic to inside the network:</p>
-<ul>
-<li>understands the complexity of all the different methods of authentication supported;</li>
-<li>sometimes some token normalization is involved;</li>
-<li>eventually enforces some preliminary authorization policies; and</li>
-<li>possibly filters data bits that are sensitive to privacy concerns (e.g. to comply with local legislation such as GRPD, CCPA, etc)</li>
-</ul>
-<p>As a minimum, EAA allows to simplify authentication between applications and microservices inside the network, as well as to reduce authorization to domain-specific rules and policies, rather than having to deal all the complexity to support all types of clients in every node.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Dynamic response → <a href="../features.md#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristband tokens</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#extra-identity-extension-authenticationdefaults-and-authenticationoverrides">Identity extension</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-    </ul>
-  </summary>
-<p>Festival Wristbands are OpenID Connect ID tokens (signed JWTs) issued by Authorino by the end of the Auth Pipeline, for authorized requests. It can be configured to include claims based on static values and values fetched from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>.</p>
-<p>Check out as well the user guides about <a href="../token-normalization/">Token normalization</a>, <a href="../api-key-authentication/">Authentication with API keys</a> and <a href="../oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-<li><a href="https://github.com/mike-engel/jwt-cli">jwt</a>, to inspect JWTs (optional)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino and configuring 2 environments of an architecture, <code>edge</code> and <code>internal</code>.</p>
-<p>The first environment is a facade for handling the first layer of authentication and exchanging any valid presented authentication token for a Festival Wristband token. In the second, we will deploy a sample service called <strong>Talker API</strong> that the authorization service will ensure to receive only authenticated traffic presented with a valid Festival Wristband.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❹.</p>
-        <p>At steps ❹ and ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="create-the-namespaces">❷ Create the namespaces<a class="headerlink" href="#create-the-namespaces" title="Permanent link">&para;</a></h2>
-<p>For simplicity, this examples will set up edge and internal nodes in different namespaces of the same Kubernetes cluster. Those will share a same single cluster-wide Authorino instance. In real-life scenarios, it does not have to be like that.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>authorino
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>edge
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>internal
-</span></code></pre></div>
-<h2 id="deploy-authorino">❸ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources cluster-wide<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">spec:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">  clusterWide: true</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">  listener:</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">    tls:</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">      enabled: false</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">    tls:</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">      enabled: false</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="setup-the-edge">❹ Setup the Edge<a class="headerlink" href="#setup-the-edge" title="Permanent link">&para;</a></h2>
-<h3 id="setup-envoy">Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h3>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up external authorization with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>edge<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/eaa/envoy-edge-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>edge.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 9000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>edge<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">9000</span>:9000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h3 id="create-the-authconfig">Create the <code>AuthConfig</code><a class="headerlink" href="#create-the-authconfig" title="Permanent link">&para;</a></h3>
-<p>Create a required secret that will be used by Authorino to sign the Festival Wristband tokens:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>edge<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: wristband-signing-key</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">stringData:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  key.pem: |</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    -----BEGIN EC PRIVATE KEY-----</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">    MHcCAQEEIDHvuf81gVlWGo0hmXGTAnA/HVxGuH8vOc7/8jewcVvqoAoGCCqGSM49</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">    AwEHoUQDQgAETJf5NLVKplSYp95TOfhVPqvxvEibRyjrUZwwtpDuQZxJKDysoGwn</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">    cnUvHIu23SgW+Ee9lxSmZGhO4eTdQeKxMA==</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">    -----END EC PRIVATE KEY-----</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">type: Opaque</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create the config:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>edge<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: edge-auth</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">spec:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  - edge.127.0.0.1.nip.io</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">    &quot;api-clients&quot;:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">        selector:</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">            authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">        allNamespaces: true</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">      credentials:</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">          prefix: APIKEY</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="s">      overrides:</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="s">        &quot;username&quot;:</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="s">          selector: auth.identity.metadata.annotations.authorino\.kuadrant\.io/username</span>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="s">    &quot;idp-users&quot;:</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="s">      jwt:</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-8-26"><a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="s">      defaults:</span>
-</span><span id="__span-8-27"><a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="s">        &quot;username&quot;:</span>
-</span><span id="__span-8-28"><a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a><span class="s">          selector: auth.identity.preferred_username</span>
-</span><span id="__span-8-29"><a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a><span class="s">  response:</span>
-</span><span id="__span-8-30"><a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="s">    success:</span>
-</span><span id="__span-8-31"><a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="s">      dynamicMetadata:</span>
-</span><span id="__span-8-32"><a id="__codelineno-8-32" name="__codelineno-8-32" href="#__codelineno-8-32"></a><span class="s">        &quot;wristband&quot;:</span>
-</span><span id="__span-8-33"><a id="__codelineno-8-33" name="__codelineno-8-33" href="#__codelineno-8-33"></a><span class="s">          wristband:</span>
-</span><span id="__span-8-34"><a id="__codelineno-8-34" name="__codelineno-8-34" href="#__codelineno-8-34"></a><span class="s">            issuer: http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/edge/edge-auth/wristband</span>
-</span><span id="__span-8-35"><a id="__codelineno-8-35" name="__codelineno-8-35" href="#__codelineno-8-35"></a><span class="s">            customClaims:</span>
-</span><span id="__span-8-36"><a id="__codelineno-8-36" name="__codelineno-8-36" href="#__codelineno-8-36"></a><span class="s">              &quot;username&quot;:</span>
-</span><span id="__span-8-37"><a id="__codelineno-8-37" name="__codelineno-8-37" href="#__codelineno-8-37"></a><span class="s">                selector: auth.identity.username</span>
-</span><span id="__span-8-38"><a id="__codelineno-8-38" name="__codelineno-8-38" href="#__codelineno-8-38"></a><span class="s">            tokenDuration: 300</span>
-</span><span id="__span-8-39"><a id="__codelineno-8-39" name="__codelineno-8-39" href="#__codelineno-8-39"></a><span class="s">            signingKeyRefs:</span>
-</span><span id="__span-8-40"><a id="__codelineno-8-40" name="__codelineno-8-40" href="#__codelineno-8-40"></a><span class="s">            - name: wristband-signing-key</span>
-</span><span id="__span-8-41"><a id="__codelineno-8-41" name="__codelineno-8-41" href="#__codelineno-8-41"></a><span class="s">              algorithm: ES256</span>
-</span><span id="__span-8-42"><a id="__codelineno-8-42" name="__codelineno-8-42" href="#__codelineno-8-42"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="setup-the-internal-workload">❺ Setup the internal workload<a class="headerlink" href="#setup-the-internal-workload" title="Permanent link">&para;</a></h2>
-<h3 id="deploy-the-talker-api">Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h3>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>internal<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h3 id="setup-envoy_1">Setup Envoy<a class="headerlink" href="#setup-envoy_1" title="Permanent link">&para;</a></h3>
-<p>This other bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>internal<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/eaa/envoy-node-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>internal<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h3 id="create-the-authconfig_1">Create the <code>AuthConfig</code><a class="headerlink" href="#create-the-authconfig_1" title="Permanent link">&para;</a></h3>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>internal<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">spec:</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="s">    &quot;edge-authenticated&quot;:</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">        issuerUrl: http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/edge/edge-auth/wristband</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-an-api-key">❻ Create an API key<a class="headerlink" href="#create-an-api-key" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>edge<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="s">metadata:</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="s">  labels:</span>
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="s">  annotations:</span>
-</span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="s">    authorino.kuadrant.io/username: alice</span>
-</span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="s">    authorino.kuadrant.io/email: alice@host</span>
-</span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="s">stringData:</span>
-</span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="s">type: Opaque</span>
-</span><span id="__span-13-14"><a id="__codelineno-13-14" name="__codelineno-13-14" href="#__codelineno-13-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<h3 id="using-the-api-key-to-authenticate">Using the API key to authenticate<a class="headerlink" href="#using-the-api-key-to-authenticate" title="Permanent link">&para;</a></h3>
-<p>Authenticate at the edge:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="nv">WRISTBAND_TOKEN</span><span class="o">=</span><span class="k">$(</span>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span>http://edge.127.0.0.1.nip.io:9000/auth<span class="w"> </span>-is<span class="w"> </span><span class="p">|</span><span class="w"> </span>tr<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;\r&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span>-En<span class="w"> </span><span class="s1">&#39;s/^x-wristband-token: (.*)/\1/p&#39;</span><span class="k">)</span>
-</span></code></pre></div>
-<p>Consume the API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$WRISTBAND_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Try to consume the API with authentication token that is only accepted in the edge:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="c1"># www-authenticate: Bearer realm=&quot;edge-authenticated&quot;</span>
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="c1"># x-ext-auth-reason: credential not found</span>
-</span></code></pre></div>
-<p>(Optional) Inspect the wristband token and verify that it only contains restricted info to authenticate and authorize with internal apps.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>jwt<span class="w"> </span>decode<span class="w"> </span><span class="nv">$WRISTBAND_TOKEN</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="c1"># [...]</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="c1">#</span>
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="c1"># Token claims</span>
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="c1"># ------------</span>
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="c1"># {</span>
-</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="c1">#   &quot;exp&quot;: 1638452051,</span>
-</span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a><span class="c1">#   &quot;iat&quot;: 1638451751,</span>
-</span><span id="__span-17-9"><a id="__codelineno-17-9" name="__codelineno-17-9" href="#__codelineno-17-9"></a><span class="c1">#   &quot;iss&quot;: &quot;http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/edge/edge-auth/wristband&quot;,</span>
-</span><span id="__span-17-10"><a id="__codelineno-17-10" name="__codelineno-17-10" href="#__codelineno-17-10"></a><span class="c1">#   &quot;sub&quot;: &quot;02cb51ea0e1c9f3c0960197a2518c8eb4f47e1b9222a968ffc8d4c8e783e4d19&quot;,</span>
-</span><span id="__span-17-11"><a id="__codelineno-17-11" name="__codelineno-17-11" href="#__codelineno-17-11"></a><span class="c1">#   &quot;username&quot;: &quot;alice&quot;</span>
-</span><span id="__span-17-12"><a id="__codelineno-17-12" name="__codelineno-17-12" href="#__codelineno-17-12"></a><span class="c1"># }</span>
-</span></code></pre></div>
-<h3 id="authenticating-with-the-keycloak-server">Authenticating with the Keycloak server<a class="headerlink" href="#authenticating-with-the-keycloak-server" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for Jane:</p>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster for the user Jane, whose e-mail has been verified:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>-n<span class="w"> </span>edge<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<p>(Optional) Inspect the access token issue by Keycloak and verify and how it contains more details about the identity than required to authenticate and authorize with internal apps.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>jwt<span class="w"> </span>decode<span class="w"> </span><span class="nv">$ACCESS_TOKEN</span>
-</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="c1"># [...]</span>
-</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a><span class="c1">#</span>
-</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a><span class="c1"># Token claims</span>
-</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a><span class="c1"># ------------</span>
-</span><span id="__span-19-6"><a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a><span class="c1"># { [...]</span>
-</span><span id="__span-19-7"><a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a><span class="c1">#   &quot;email&quot;: &quot;jane@kuadrant.io&quot;,</span>
-</span><span id="__span-19-8"><a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a><span class="c1">#   &quot;email_verified&quot;: true,</span>
-</span><span id="__span-19-9"><a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a><span class="c1">#   &quot;exp&quot;: 1638452220,</span>
-</span><span id="__span-19-10"><a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a><span class="c1">#   &quot;family_name&quot;: &quot;Smith&quot;,</span>
-</span><span id="__span-19-11"><a id="__codelineno-19-11" name="__codelineno-19-11" href="#__codelineno-19-11"></a><span class="c1">#   &quot;given_name&quot;: &quot;Jane&quot;,</span>
-</span><span id="__span-19-12"><a id="__codelineno-19-12" name="__codelineno-19-12" href="#__codelineno-19-12"></a><span class="c1">#   &quot;iat&quot;: 1638451920,</span>
-</span><span id="__span-19-13"><a id="__codelineno-19-13" name="__codelineno-19-13" href="#__codelineno-19-13"></a><span class="c1">#   &quot;iss&quot;: &quot;http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant&quot;,</span>
-</span><span id="__span-19-14"><a id="__codelineno-19-14" name="__codelineno-19-14" href="#__codelineno-19-14"></a><span class="c1">#   &quot;jti&quot;: &quot;699f6e49-dea4-4f29-ae2a-929a3a18c94b&quot;,</span>
-</span><span id="__span-19-15"><a id="__codelineno-19-15" name="__codelineno-19-15" href="#__codelineno-19-15"></a><span class="c1">#   &quot;name&quot;: &quot;Jane Smith&quot;,</span>
-</span><span id="__span-19-16"><a id="__codelineno-19-16" name="__codelineno-19-16" href="#__codelineno-19-16"></a><span class="c1">#   &quot;preferred_username&quot;: &quot;jane&quot;,</span>
-</span><span id="__span-19-17"><a id="__codelineno-19-17" name="__codelineno-19-17" href="#__codelineno-19-17"></a><span class="c1">#   &quot;realm_access&quot;: {</span>
-</span><span id="__span-19-18"><a id="__codelineno-19-18" name="__codelineno-19-18" href="#__codelineno-19-18"></a><span class="c1">#     &quot;roles&quot;: [</span>
-</span><span id="__span-19-19"><a id="__codelineno-19-19" name="__codelineno-19-19" href="#__codelineno-19-19"></a><span class="c1">#       &quot;offline_access&quot;,</span>
-</span><span id="__span-19-20"><a id="__codelineno-19-20" name="__codelineno-19-20" href="#__codelineno-19-20"></a><span class="c1">#       &quot;member&quot;,</span>
-</span><span id="__span-19-21"><a id="__codelineno-19-21" name="__codelineno-19-21" href="#__codelineno-19-21"></a><span class="c1">#       &quot;admin&quot;,</span>
-</span><span id="__span-19-22"><a id="__codelineno-19-22" name="__codelineno-19-22" href="#__codelineno-19-22"></a><span class="c1">#       &quot;uma_authorization&quot;</span>
-</span><span id="__span-19-23"><a id="__codelineno-19-23" name="__codelineno-19-23" href="#__codelineno-19-23"></a><span class="c1">#     ]</span>
-</span><span id="__span-19-24"><a id="__codelineno-19-24" name="__codelineno-19-24" href="#__codelineno-19-24"></a><span class="c1">#   },</span>
-</span><span id="__span-19-25"><a id="__codelineno-19-25" name="__codelineno-19-25" href="#__codelineno-19-25"></a><span class="c1"># [...]</span>
-</span></code></pre></div>
-<p>As Jane, obtain a limited wristband token at the edge:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="nv">WRISTBAND_TOKEN</span><span class="o">=</span><span class="k">$(</span>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://edge.127.0.0.1.nip.io:9000/auth<span class="w"> </span>-is<span class="w"> </span><span class="p">|</span><span class="w"> </span>tr<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;\r&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span>-En<span class="w"> </span><span class="s1">&#39;s/^x-wristband-token: (.*)/\1/p&#39;</span><span class="k">)</span>
-</span></code></pre></div>
-<p>Consume the API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$WRISTBAND_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>edge
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>internal
-</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>authorino
-</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino and Authorino Operator manifests, run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>cluster-wide</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/envoy-jwt-authn-and-authorino/index.html b/0.10.0/authorino/docs/user-guides/envoy-jwt-authn-and-authorino/index.html
deleted file mode 100644
index f7aa4409e..000000000
--- a/0.10.0/authorino/docs/user-guides/envoy-jwt-authn-and-authorino/index.html
+++ /dev/null
@@ -1,4040 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/envoy-jwt-authn-and-authorino/">
-      
-      
-        <link rel="prev" href="../deny-with-redirect-to-login/">
-      
-      
-        <link rel="next" href="../validating-webhook/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Reusing Envoy built-in authentication filter result - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-mixing-envoy-built-in-filter-for-auth-and-authorino" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Reusing Envoy built-in authentication filter result
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-ip-location-service" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Deploy the IP Location service
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-a-token-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Obtain a token and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❼ Obtain a token and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-john-member" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as John (member)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-jane-admin" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Jane (admin)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-ip-location-service" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Deploy the IP Location service
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-a-token-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Obtain a token and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❼ Obtain a token and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-john-member" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as John (member)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-jane-admin" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Jane (admin)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/envoy-jwt-authn-and-authorino.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-mixing-envoy-built-in-filter-for-auth-and-authorino">User guide: Mixing Envoy built-in filter for auth and Authorino<a class="headerlink" href="#user-guide-mixing-envoy-built-in-filter-for-auth-and-authorino" title="Permanent link">&para;</a></h1>
-<p>Have JWT validation handled by Envoy beforehand and the JWT payload injected into the request to Authorino, to be used in custom authorization policies defined in a AuthConfig.</p>
-<p>In this user guide, we will set up Envoy and Authorino to protect a service called the <em>Talker API</em> service, with JWT authentication handled in Envoy and a more complex authorization policy enforced in Authorino.</p>
-<p>The policy defines a geo-fence by which only requests originated in Great Britain (country code: GB) will be accepted, unless the user is bound to a role called 'admin' in the auth server, in which case no geofence is enforced.</p>
-<p>All requests to the Talker API will be authenticated in Envoy. However, requests to <code>/global</code> will <strong>not</strong> trigger the external authorization.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#plain-authenticationplain">Plain</a></li>
-      <li>External auth metadata → <a href="../features.md#http-getget-by-post-metadatahttp">HTTP GET/GET-by-POST</a></li>
-      <li>Authorization → <a href="../features.md#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization</a></li>
-      <li>Dynamic response → <a href="../features.md#custom-denial-status-responseunauthenticated-and-responseunauthorized">Custom denial status</a></li>
-    </ul>
-  </summary>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❻.</p>
-        <p>At step ❻, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  listener:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    tls:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    tls:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following command deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: ConfigMap</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  labels:</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">    app: authorino</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">  name: envoy</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">data:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="s">  envoy.yaml: |</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="s">    static_resources:</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="s">      clusters:</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">      - name: talker-api</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="s">        connect_timeout: 0.25s</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="s">        type: strict_dns</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="s">        lb_policy: round_robin</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="s">        load_assignment:</span>
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a><span class="s">          cluster_name: talker-api</span>
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a><span class="s">          endpoints:</span>
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a><span class="s">          - lb_endpoints:</span>
-</span><span id="__span-5-21"><a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a><span class="s">            - endpoint:</span>
-</span><span id="__span-5-22"><a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a><span class="s">                address:</span>
-</span><span id="__span-5-23"><a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></a><span class="s">                  socket_address:</span>
-</span><span id="__span-5-24"><a id="__codelineno-5-24" name="__codelineno-5-24" href="#__codelineno-5-24"></a><span class="s">                    address: talker-api</span>
-</span><span id="__span-5-25"><a id="__codelineno-5-25" name="__codelineno-5-25" href="#__codelineno-5-25"></a><span class="s">                    port_value: 3000</span>
-</span><span id="__span-5-26"><a id="__codelineno-5-26" name="__codelineno-5-26" href="#__codelineno-5-26"></a><span class="s">      - name: keycloak</span>
-</span><span id="__span-5-27"><a id="__codelineno-5-27" name="__codelineno-5-27" href="#__codelineno-5-27"></a><span class="s">        connect_timeout: 0.25s</span>
-</span><span id="__span-5-28"><a id="__codelineno-5-28" name="__codelineno-5-28" href="#__codelineno-5-28"></a><span class="s">        type: logical_dns</span>
-</span><span id="__span-5-29"><a id="__codelineno-5-29" name="__codelineno-5-29" href="#__codelineno-5-29"></a><span class="s">        lb_policy: round_robin</span>
-</span><span id="__span-5-30"><a id="__codelineno-5-30" name="__codelineno-5-30" href="#__codelineno-5-30"></a><span class="s">        load_assignment:</span>
-</span><span id="__span-5-31"><a id="__codelineno-5-31" name="__codelineno-5-31" href="#__codelineno-5-31"></a><span class="s">          cluster_name: keycloak</span>
-</span><span id="__span-5-32"><a id="__codelineno-5-32" name="__codelineno-5-32" href="#__codelineno-5-32"></a><span class="s">          endpoints:</span>
-</span><span id="__span-5-33"><a id="__codelineno-5-33" name="__codelineno-5-33" href="#__codelineno-5-33"></a><span class="s">          - lb_endpoints:</span>
-</span><span id="__span-5-34"><a id="__codelineno-5-34" name="__codelineno-5-34" href="#__codelineno-5-34"></a><span class="s">            - endpoint:</span>
-</span><span id="__span-5-35"><a id="__codelineno-5-35" name="__codelineno-5-35" href="#__codelineno-5-35"></a><span class="s">                address:</span>
-</span><span id="__span-5-36"><a id="__codelineno-5-36" name="__codelineno-5-36" href="#__codelineno-5-36"></a><span class="s">                  socket_address:</span>
-</span><span id="__span-5-37"><a id="__codelineno-5-37" name="__codelineno-5-37" href="#__codelineno-5-37"></a><span class="s">                    address: keycloak.keycloak.svc.cluster.local</span>
-</span><span id="__span-5-38"><a id="__codelineno-5-38" name="__codelineno-5-38" href="#__codelineno-5-38"></a><span class="s">                    port_value: 8080</span>
-</span><span id="__span-5-39"><a id="__codelineno-5-39" name="__codelineno-5-39" href="#__codelineno-5-39"></a><span class="s">      - name: authorino</span>
-</span><span id="__span-5-40"><a id="__codelineno-5-40" name="__codelineno-5-40" href="#__codelineno-5-40"></a><span class="s">        connect_timeout: 0.25s</span>
-</span><span id="__span-5-41"><a id="__codelineno-5-41" name="__codelineno-5-41" href="#__codelineno-5-41"></a><span class="s">        type: strict_dns</span>
-</span><span id="__span-5-42"><a id="__codelineno-5-42" name="__codelineno-5-42" href="#__codelineno-5-42"></a><span class="s">        lb_policy: round_robin</span>
-</span><span id="__span-5-43"><a id="__codelineno-5-43" name="__codelineno-5-43" href="#__codelineno-5-43"></a><span class="s">        http2_protocol_options: {}</span>
-</span><span id="__span-5-44"><a id="__codelineno-5-44" name="__codelineno-5-44" href="#__codelineno-5-44"></a><span class="s">        load_assignment:</span>
-</span><span id="__span-5-45"><a id="__codelineno-5-45" name="__codelineno-5-45" href="#__codelineno-5-45"></a><span class="s">          cluster_name: authorino</span>
-</span><span id="__span-5-46"><a id="__codelineno-5-46" name="__codelineno-5-46" href="#__codelineno-5-46"></a><span class="s">          endpoints:</span>
-</span><span id="__span-5-47"><a id="__codelineno-5-47" name="__codelineno-5-47" href="#__codelineno-5-47"></a><span class="s">          - lb_endpoints:</span>
-</span><span id="__span-5-48"><a id="__codelineno-5-48" name="__codelineno-5-48" href="#__codelineno-5-48"></a><span class="s">            - endpoint:</span>
-</span><span id="__span-5-49"><a id="__codelineno-5-49" name="__codelineno-5-49" href="#__codelineno-5-49"></a><span class="s">                address:</span>
-</span><span id="__span-5-50"><a id="__codelineno-5-50" name="__codelineno-5-50" href="#__codelineno-5-50"></a><span class="s">                  socket_address:</span>
-</span><span id="__span-5-51"><a id="__codelineno-5-51" name="__codelineno-5-51" href="#__codelineno-5-51"></a><span class="s">                    address: authorino-authorino-authorization</span>
-</span><span id="__span-5-52"><a id="__codelineno-5-52" name="__codelineno-5-52" href="#__codelineno-5-52"></a><span class="s">                    port_value: 50051</span>
-</span><span id="__span-5-53"><a id="__codelineno-5-53" name="__codelineno-5-53" href="#__codelineno-5-53"></a><span class="s">      listeners:</span>
-</span><span id="__span-5-54"><a id="__codelineno-5-54" name="__codelineno-5-54" href="#__codelineno-5-54"></a><span class="s">      - address:</span>
-</span><span id="__span-5-55"><a id="__codelineno-5-55" name="__codelineno-5-55" href="#__codelineno-5-55"></a><span class="s">          socket_address:</span>
-</span><span id="__span-5-56"><a id="__codelineno-5-56" name="__codelineno-5-56" href="#__codelineno-5-56"></a><span class="s">            address: 0.0.0.0</span>
-</span><span id="__span-5-57"><a id="__codelineno-5-57" name="__codelineno-5-57" href="#__codelineno-5-57"></a><span class="s">            port_value: 8000</span>
-</span><span id="__span-5-58"><a id="__codelineno-5-58" name="__codelineno-5-58" href="#__codelineno-5-58"></a><span class="s">        filter_chains:</span>
-</span><span id="__span-5-59"><a id="__codelineno-5-59" name="__codelineno-5-59" href="#__codelineno-5-59"></a><span class="s">        - filters:</span>
-</span><span id="__span-5-60"><a id="__codelineno-5-60" name="__codelineno-5-60" href="#__codelineno-5-60"></a><span class="s">          - name: envoy.http_connection_manager</span>
-</span><span id="__span-5-61"><a id="__codelineno-5-61" name="__codelineno-5-61" href="#__codelineno-5-61"></a><span class="s">            typed_config:</span>
-</span><span id="__span-5-62"><a id="__codelineno-5-62" name="__codelineno-5-62" href="#__codelineno-5-62"></a><span class="s">              &quot;@type&quot;: type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager</span>
-</span><span id="__span-5-63"><a id="__codelineno-5-63" name="__codelineno-5-63" href="#__codelineno-5-63"></a><span class="s">              stat_prefix: local</span>
-</span><span id="__span-5-64"><a id="__codelineno-5-64" name="__codelineno-5-64" href="#__codelineno-5-64"></a><span class="s">              route_config:</span>
-</span><span id="__span-5-65"><a id="__codelineno-5-65" name="__codelineno-5-65" href="#__codelineno-5-65"></a><span class="s">                name: local_route</span>
-</span><span id="__span-5-66"><a id="__codelineno-5-66" name="__codelineno-5-66" href="#__codelineno-5-66"></a><span class="s">                virtual_hosts:</span>
-</span><span id="__span-5-67"><a id="__codelineno-5-67" name="__codelineno-5-67" href="#__codelineno-5-67"></a><span class="s">                - name: local_service</span>
-</span><span id="__span-5-68"><a id="__codelineno-5-68" name="__codelineno-5-68" href="#__codelineno-5-68"></a><span class="s">                  domains: [&#39;*&#39;]</span>
-</span><span id="__span-5-69"><a id="__codelineno-5-69" name="__codelineno-5-69" href="#__codelineno-5-69"></a><span class="s">                  routes:</span>
-</span><span id="__span-5-70"><a id="__codelineno-5-70" name="__codelineno-5-70" href="#__codelineno-5-70"></a><span class="s">                  - match: { path_separated_prefix: /global }</span>
-</span><span id="__span-5-71"><a id="__codelineno-5-71" name="__codelineno-5-71" href="#__codelineno-5-71"></a><span class="s">                    route: { cluster: talker-api }</span>
-</span><span id="__span-5-72"><a id="__codelineno-5-72" name="__codelineno-5-72" href="#__codelineno-5-72"></a><span class="s">                    typed_per_filter_config:</span>
-</span><span id="__span-5-73"><a id="__codelineno-5-73" name="__codelineno-5-73" href="#__codelineno-5-73"></a><span class="s">                      envoy.filters.http.ext_authz:</span>
-</span><span id="__span-5-74"><a id="__codelineno-5-74" name="__codelineno-5-74" href="#__codelineno-5-74"></a><span class="s">                        &quot;@type&quot;: type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute</span>
-</span><span id="__span-5-75"><a id="__codelineno-5-75" name="__codelineno-5-75" href="#__codelineno-5-75"></a><span class="s">                        disabled: true</span>
-</span><span id="__span-5-76"><a id="__codelineno-5-76" name="__codelineno-5-76" href="#__codelineno-5-76"></a><span class="s">                  - match: { prefix: / }</span>
-</span><span id="__span-5-77"><a id="__codelineno-5-77" name="__codelineno-5-77" href="#__codelineno-5-77"></a><span class="s">                    route: { cluster: talker-api }</span>
-</span><span id="__span-5-78"><a id="__codelineno-5-78" name="__codelineno-5-78" href="#__codelineno-5-78"></a><span class="s">              http_filters:</span>
-</span><span id="__span-5-79"><a id="__codelineno-5-79" name="__codelineno-5-79" href="#__codelineno-5-79"></a><span class="s">              - name: envoy.filters.http.jwt_authn</span>
-</span><span id="__span-5-80"><a id="__codelineno-5-80" name="__codelineno-5-80" href="#__codelineno-5-80"></a><span class="s">                typed_config:</span>
-</span><span id="__span-5-81"><a id="__codelineno-5-81" name="__codelineno-5-81" href="#__codelineno-5-81"></a><span class="s">                  &quot;@type&quot;: type.googleapis.com/envoy.extensions.filters.http.jwt_authn.v3.JwtAuthentication</span>
-</span><span id="__span-5-82"><a id="__codelineno-5-82" name="__codelineno-5-82" href="#__codelineno-5-82"></a><span class="s">                  providers:</span>
-</span><span id="__span-5-83"><a id="__codelineno-5-83" name="__codelineno-5-83" href="#__codelineno-5-83"></a><span class="s">                    keycloak:</span>
-</span><span id="__span-5-84"><a id="__codelineno-5-84" name="__codelineno-5-84" href="#__codelineno-5-84"></a><span class="s">                      issuer: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-5-85"><a id="__codelineno-5-85" name="__codelineno-5-85" href="#__codelineno-5-85"></a><span class="s">                      remote_jwks:</span>
-</span><span id="__span-5-86"><a id="__codelineno-5-86" name="__codelineno-5-86" href="#__codelineno-5-86"></a><span class="s">                        http_uri:</span>
-</span><span id="__span-5-87"><a id="__codelineno-5-87" name="__codelineno-5-87" href="#__codelineno-5-87"></a><span class="s">                          uri: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/certs</span>
-</span><span id="__span-5-88"><a id="__codelineno-5-88" name="__codelineno-5-88" href="#__codelineno-5-88"></a><span class="s">                          cluster: keycloak</span>
-</span><span id="__span-5-89"><a id="__codelineno-5-89" name="__codelineno-5-89" href="#__codelineno-5-89"></a><span class="s">                          timeout: 5s</span>
-</span><span id="__span-5-90"><a id="__codelineno-5-90" name="__codelineno-5-90" href="#__codelineno-5-90"></a><span class="s">                        cache_duration:</span>
-</span><span id="__span-5-91"><a id="__codelineno-5-91" name="__codelineno-5-91" href="#__codelineno-5-91"></a><span class="s">                          seconds: 300</span>
-</span><span id="__span-5-92"><a id="__codelineno-5-92" name="__codelineno-5-92" href="#__codelineno-5-92"></a><span class="s">                      payload_in_metadata: verified_jwt</span>
-</span><span id="__span-5-93"><a id="__codelineno-5-93" name="__codelineno-5-93" href="#__codelineno-5-93"></a><span class="s">                  rules:</span>
-</span><span id="__span-5-94"><a id="__codelineno-5-94" name="__codelineno-5-94" href="#__codelineno-5-94"></a><span class="s">                  - match: { prefix: / }</span>
-</span><span id="__span-5-95"><a id="__codelineno-5-95" name="__codelineno-5-95" href="#__codelineno-5-95"></a><span class="s">                    requires: { provider_name: keycloak }</span>
-</span><span id="__span-5-96"><a id="__codelineno-5-96" name="__codelineno-5-96" href="#__codelineno-5-96"></a><span class="s">              - name: envoy.filters.http.ext_authz</span>
-</span><span id="__span-5-97"><a id="__codelineno-5-97" name="__codelineno-5-97" href="#__codelineno-5-97"></a><span class="s">                typed_config:</span>
-</span><span id="__span-5-98"><a id="__codelineno-5-98" name="__codelineno-5-98" href="#__codelineno-5-98"></a><span class="s">                  &quot;@type&quot;: type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthz</span>
-</span><span id="__span-5-99"><a id="__codelineno-5-99" name="__codelineno-5-99" href="#__codelineno-5-99"></a><span class="s">                  transport_api_version: V3</span>
-</span><span id="__span-5-100"><a id="__codelineno-5-100" name="__codelineno-5-100" href="#__codelineno-5-100"></a><span class="s">                  failure_mode_allow: false</span>
-</span><span id="__span-5-101"><a id="__codelineno-5-101" name="__codelineno-5-101" href="#__codelineno-5-101"></a><span class="s">                  metadata_context_namespaces:</span>
-</span><span id="__span-5-102"><a id="__codelineno-5-102" name="__codelineno-5-102" href="#__codelineno-5-102"></a><span class="s">                  - envoy.filters.http.jwt_authn</span>
-</span><span id="__span-5-103"><a id="__codelineno-5-103" name="__codelineno-5-103" href="#__codelineno-5-103"></a><span class="s">                  grpc_service:</span>
-</span><span id="__span-5-104"><a id="__codelineno-5-104" name="__codelineno-5-104" href="#__codelineno-5-104"></a><span class="s">                    envoy_grpc:</span>
-</span><span id="__span-5-105"><a id="__codelineno-5-105" name="__codelineno-5-105" href="#__codelineno-5-105"></a><span class="s">                      cluster_name: authorino</span>
-</span><span id="__span-5-106"><a id="__codelineno-5-106" name="__codelineno-5-106" href="#__codelineno-5-106"></a><span class="s">                    timeout: 1s</span>
-</span><span id="__span-5-107"><a id="__codelineno-5-107" name="__codelineno-5-107" href="#__codelineno-5-107"></a><span class="s">              - name: envoy.filters.http.router</span>
-</span><span id="__span-5-108"><a id="__codelineno-5-108" name="__codelineno-5-108" href="#__codelineno-5-108"></a><span class="s">                typed_config:</span>
-</span><span id="__span-5-109"><a id="__codelineno-5-109" name="__codelineno-5-109" href="#__codelineno-5-109"></a><span class="s">                  &quot;@type&quot;: type.googleapis.com/envoy.extensions.filters.http.router.v3.Router</span>
-</span><span id="__span-5-110"><a id="__codelineno-5-110" name="__codelineno-5-110" href="#__codelineno-5-110"></a><span class="s">              use_remote_address: true</span>
-</span><span id="__span-5-111"><a id="__codelineno-5-111" name="__codelineno-5-111" href="#__codelineno-5-111"></a><span class="s">    admin:</span>
-</span><span id="__span-5-112"><a id="__codelineno-5-112" name="__codelineno-5-112" href="#__codelineno-5-112"></a><span class="s">      access_log_path: &quot;/tmp/admin_access.log&quot;</span>
-</span><span id="__span-5-113"><a id="__codelineno-5-113" name="__codelineno-5-113" href="#__codelineno-5-113"></a><span class="s">      address:</span>
-</span><span id="__span-5-114"><a id="__codelineno-5-114" name="__codelineno-5-114" href="#__codelineno-5-114"></a><span class="s">        socket_address:</span>
-</span><span id="__span-5-115"><a id="__codelineno-5-115" name="__codelineno-5-115" href="#__codelineno-5-115"></a><span class="s">          address: 0.0.0.0</span>
-</span><span id="__span-5-116"><a id="__codelineno-5-116" name="__codelineno-5-116" href="#__codelineno-5-116"></a><span class="s">          port_value: 8001</span>
-</span><span id="__span-5-117"><a id="__codelineno-5-117" name="__codelineno-5-117" href="#__codelineno-5-117"></a><span class="s">---</span>
-</span><span id="__span-5-118"><a id="__codelineno-5-118" name="__codelineno-5-118" href="#__codelineno-5-118"></a><span class="s">apiVersion: apps/v1</span>
-</span><span id="__span-5-119"><a id="__codelineno-5-119" name="__codelineno-5-119" href="#__codelineno-5-119"></a><span class="s">kind: Deployment</span>
-</span><span id="__span-5-120"><a id="__codelineno-5-120" name="__codelineno-5-120" href="#__codelineno-5-120"></a><span class="s">metadata:</span>
-</span><span id="__span-5-121"><a id="__codelineno-5-121" name="__codelineno-5-121" href="#__codelineno-5-121"></a><span class="s">  labels:</span>
-</span><span id="__span-5-122"><a id="__codelineno-5-122" name="__codelineno-5-122" href="#__codelineno-5-122"></a><span class="s">    app: authorino</span>
-</span><span id="__span-5-123"><a id="__codelineno-5-123" name="__codelineno-5-123" href="#__codelineno-5-123"></a><span class="s">    svc: envoy</span>
-</span><span id="__span-5-124"><a id="__codelineno-5-124" name="__codelineno-5-124" href="#__codelineno-5-124"></a><span class="s">  name: envoy</span>
-</span><span id="__span-5-125"><a id="__codelineno-5-125" name="__codelineno-5-125" href="#__codelineno-5-125"></a><span class="s">spec:</span>
-</span><span id="__span-5-126"><a id="__codelineno-5-126" name="__codelineno-5-126" href="#__codelineno-5-126"></a><span class="s">  replicas: 1</span>
-</span><span id="__span-5-127"><a id="__codelineno-5-127" name="__codelineno-5-127" href="#__codelineno-5-127"></a><span class="s">  selector:</span>
-</span><span id="__span-5-128"><a id="__codelineno-5-128" name="__codelineno-5-128" href="#__codelineno-5-128"></a><span class="s">    matchLabels:</span>
-</span><span id="__span-5-129"><a id="__codelineno-5-129" name="__codelineno-5-129" href="#__codelineno-5-129"></a><span class="s">      app: authorino</span>
-</span><span id="__span-5-130"><a id="__codelineno-5-130" name="__codelineno-5-130" href="#__codelineno-5-130"></a><span class="s">      svc: envoy</span>
-</span><span id="__span-5-131"><a id="__codelineno-5-131" name="__codelineno-5-131" href="#__codelineno-5-131"></a><span class="s">  template:</span>
-</span><span id="__span-5-132"><a id="__codelineno-5-132" name="__codelineno-5-132" href="#__codelineno-5-132"></a><span class="s">    metadata:</span>
-</span><span id="__span-5-133"><a id="__codelineno-5-133" name="__codelineno-5-133" href="#__codelineno-5-133"></a><span class="s">      labels:</span>
-</span><span id="__span-5-134"><a id="__codelineno-5-134" name="__codelineno-5-134" href="#__codelineno-5-134"></a><span class="s">        app: authorino</span>
-</span><span id="__span-5-135"><a id="__codelineno-5-135" name="__codelineno-5-135" href="#__codelineno-5-135"></a><span class="s">        svc: envoy</span>
-</span><span id="__span-5-136"><a id="__codelineno-5-136" name="__codelineno-5-136" href="#__codelineno-5-136"></a><span class="s">    spec:</span>
-</span><span id="__span-5-137"><a id="__codelineno-5-137" name="__codelineno-5-137" href="#__codelineno-5-137"></a><span class="s">      containers:</span>
-</span><span id="__span-5-138"><a id="__codelineno-5-138" name="__codelineno-5-138" href="#__codelineno-5-138"></a><span class="s">      - args:</span>
-</span><span id="__span-5-139"><a id="__codelineno-5-139" name="__codelineno-5-139" href="#__codelineno-5-139"></a><span class="s">        - --config-path /usr/local/etc/envoy/envoy.yaml</span>
-</span><span id="__span-5-140"><a id="__codelineno-5-140" name="__codelineno-5-140" href="#__codelineno-5-140"></a><span class="s">        - --service-cluster front-proxy</span>
-</span><span id="__span-5-141"><a id="__codelineno-5-141" name="__codelineno-5-141" href="#__codelineno-5-141"></a><span class="s">        - --log-level info</span>
-</span><span id="__span-5-142"><a id="__codelineno-5-142" name="__codelineno-5-142" href="#__codelineno-5-142"></a><span class="s">        - --component-log-level filter:trace,http:debug,router:debug</span>
-</span><span id="__span-5-143"><a id="__codelineno-5-143" name="__codelineno-5-143" href="#__codelineno-5-143"></a><span class="s">        command:</span>
-</span><span id="__span-5-144"><a id="__codelineno-5-144" name="__codelineno-5-144" href="#__codelineno-5-144"></a><span class="s">        - /usr/local/bin/envoy</span>
-</span><span id="__span-5-145"><a id="__codelineno-5-145" name="__codelineno-5-145" href="#__codelineno-5-145"></a><span class="s">        image: envoyproxy/envoy:v1.22-latest</span>
-</span><span id="__span-5-146"><a id="__codelineno-5-146" name="__codelineno-5-146" href="#__codelineno-5-146"></a><span class="s">        name: envoy</span>
-</span><span id="__span-5-147"><a id="__codelineno-5-147" name="__codelineno-5-147" href="#__codelineno-5-147"></a><span class="s">        ports:</span>
-</span><span id="__span-5-148"><a id="__codelineno-5-148" name="__codelineno-5-148" href="#__codelineno-5-148"></a><span class="s">        - containerPort: 8000</span>
-</span><span id="__span-5-149"><a id="__codelineno-5-149" name="__codelineno-5-149" href="#__codelineno-5-149"></a><span class="s">          name: web</span>
-</span><span id="__span-5-150"><a id="__codelineno-5-150" name="__codelineno-5-150" href="#__codelineno-5-150"></a><span class="s">        - containerPort: 8001</span>
-</span><span id="__span-5-151"><a id="__codelineno-5-151" name="__codelineno-5-151" href="#__codelineno-5-151"></a><span class="s">          name: admin</span>
-</span><span id="__span-5-152"><a id="__codelineno-5-152" name="__codelineno-5-152" href="#__codelineno-5-152"></a><span class="s">        volumeMounts:</span>
-</span><span id="__span-5-153"><a id="__codelineno-5-153" name="__codelineno-5-153" href="#__codelineno-5-153"></a><span class="s">        - mountPath: /usr/local/etc/envoy</span>
-</span><span id="__span-5-154"><a id="__codelineno-5-154" name="__codelineno-5-154" href="#__codelineno-5-154"></a><span class="s">          name: config</span>
-</span><span id="__span-5-155"><a id="__codelineno-5-155" name="__codelineno-5-155" href="#__codelineno-5-155"></a><span class="s">          readOnly: true</span>
-</span><span id="__span-5-156"><a id="__codelineno-5-156" name="__codelineno-5-156" href="#__codelineno-5-156"></a><span class="s">      volumes:</span>
-</span><span id="__span-5-157"><a id="__codelineno-5-157" name="__codelineno-5-157" href="#__codelineno-5-157"></a><span class="s">      - configMap:</span>
-</span><span id="__span-5-158"><a id="__codelineno-5-158" name="__codelineno-5-158" href="#__codelineno-5-158"></a><span class="s">          items:</span>
-</span><span id="__span-5-159"><a id="__codelineno-5-159" name="__codelineno-5-159" href="#__codelineno-5-159"></a><span class="s">          - key: envoy.yaml</span>
-</span><span id="__span-5-160"><a id="__codelineno-5-160" name="__codelineno-5-160" href="#__codelineno-5-160"></a><span class="s">            path: envoy.yaml</span>
-</span><span id="__span-5-161"><a id="__codelineno-5-161" name="__codelineno-5-161" href="#__codelineno-5-161"></a><span class="s">          name: envoy</span>
-</span><span id="__span-5-162"><a id="__codelineno-5-162" name="__codelineno-5-162" href="#__codelineno-5-162"></a><span class="s">        name: config</span>
-</span><span id="__span-5-163"><a id="__codelineno-5-163" name="__codelineno-5-163" href="#__codelineno-5-163"></a><span class="s">---</span>
-</span><span id="__span-5-164"><a id="__codelineno-5-164" name="__codelineno-5-164" href="#__codelineno-5-164"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-5-165"><a id="__codelineno-5-165" name="__codelineno-5-165" href="#__codelineno-5-165"></a><span class="s">kind: Service</span>
-</span><span id="__span-5-166"><a id="__codelineno-5-166" name="__codelineno-5-166" href="#__codelineno-5-166"></a><span class="s">metadata:</span>
-</span><span id="__span-5-167"><a id="__codelineno-5-167" name="__codelineno-5-167" href="#__codelineno-5-167"></a><span class="s">  labels:</span>
-</span><span id="__span-5-168"><a id="__codelineno-5-168" name="__codelineno-5-168" href="#__codelineno-5-168"></a><span class="s">    app: authorino</span>
-</span><span id="__span-5-169"><a id="__codelineno-5-169" name="__codelineno-5-169" href="#__codelineno-5-169"></a><span class="s">  name: envoy</span>
-</span><span id="__span-5-170"><a id="__codelineno-5-170" name="__codelineno-5-170" href="#__codelineno-5-170"></a><span class="s">spec:</span>
-</span><span id="__span-5-171"><a id="__codelineno-5-171" name="__codelineno-5-171" href="#__codelineno-5-171"></a><span class="s">  ports:</span>
-</span><span id="__span-5-172"><a id="__codelineno-5-172" name="__codelineno-5-172" href="#__codelineno-5-172"></a><span class="s">  - name: web</span>
-</span><span id="__span-5-173"><a id="__codelineno-5-173" name="__codelineno-5-173" href="#__codelineno-5-173"></a><span class="s">    port: 8000</span>
-</span><span id="__span-5-174"><a id="__codelineno-5-174" name="__codelineno-5-174" href="#__codelineno-5-174"></a><span class="s">    protocol: TCP</span>
-</span><span id="__span-5-175"><a id="__codelineno-5-175" name="__codelineno-5-175" href="#__codelineno-5-175"></a><span class="s">  selector:</span>
-</span><span id="__span-5-176"><a id="__codelineno-5-176" name="__codelineno-5-176" href="#__codelineno-5-176"></a><span class="s">    app: authorino</span>
-</span><span id="__span-5-177"><a id="__codelineno-5-177" name="__codelineno-5-177" href="#__codelineno-5-177"></a><span class="s">    svc: envoy</span>
-</span><span id="__span-5-178"><a id="__codelineno-5-178" name="__codelineno-5-178" href="#__codelineno-5-178"></a><span class="s">---</span>
-</span><span id="__span-5-179"><a id="__codelineno-5-179" name="__codelineno-5-179" href="#__codelineno-5-179"></a><span class="s">apiVersion: networking.k8s.io/v1</span>
-</span><span id="__span-5-180"><a id="__codelineno-5-180" name="__codelineno-5-180" href="#__codelineno-5-180"></a><span class="s">kind: Ingress</span>
-</span><span id="__span-5-181"><a id="__codelineno-5-181" name="__codelineno-5-181" href="#__codelineno-5-181"></a><span class="s">metadata:</span>
-</span><span id="__span-5-182"><a id="__codelineno-5-182" name="__codelineno-5-182" href="#__codelineno-5-182"></a><span class="s">  name: ingress-wildcard-host</span>
-</span><span id="__span-5-183"><a id="__codelineno-5-183" name="__codelineno-5-183" href="#__codelineno-5-183"></a><span class="s">spec:</span>
-</span><span id="__span-5-184"><a id="__codelineno-5-184" name="__codelineno-5-184" href="#__codelineno-5-184"></a><span class="s">  rules:</span>
-</span><span id="__span-5-185"><a id="__codelineno-5-185" name="__codelineno-5-185" href="#__codelineno-5-185"></a><span class="s">  - host: talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-5-186"><a id="__codelineno-5-186" name="__codelineno-5-186" href="#__codelineno-5-186"></a><span class="s">    http:</span>
-</span><span id="__span-5-187"><a id="__codelineno-5-187" name="__codelineno-5-187" href="#__codelineno-5-187"></a><span class="s">      paths:</span>
-</span><span id="__span-5-188"><a id="__codelineno-5-188" name="__codelineno-5-188" href="#__codelineno-5-188"></a><span class="s">      - backend:</span>
-</span><span id="__span-5-189"><a id="__codelineno-5-189" name="__codelineno-5-189" href="#__codelineno-5-189"></a><span class="s">          service:</span>
-</span><span id="__span-5-190"><a id="__codelineno-5-190" name="__codelineno-5-190" href="#__codelineno-5-190"></a><span class="s">            name: envoy</span>
-</span><span id="__span-5-191"><a id="__codelineno-5-191" name="__codelineno-5-191" href="#__codelineno-5-191"></a><span class="s">            port:</span>
-</span><span id="__span-5-192"><a id="__codelineno-5-192" name="__codelineno-5-192" href="#__codelineno-5-192"></a><span class="s">              number: 8000</span>
-</span><span id="__span-5-193"><a id="__codelineno-5-193" name="__codelineno-5-193" href="#__codelineno-5-193"></a><span class="s">        path: /</span>
-</span><span id="__span-5-194"><a id="__codelineno-5-194" name="__codelineno-5-194" href="#__codelineno-5-194"></a><span class="s">        pathType: Prefix</span>
-</span><span id="__span-5-195"><a id="__codelineno-5-195" name="__codelineno-5-195" href="#__codelineno-5-195"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="deploy-the-ip-location-service">❺ Deploy the IP Location service<a class="headerlink" href="#deploy-the-ip-location-service" title="Permanent link">&para;</a></h2>
-<p>The <strong>IP Location service</strong> is a simple service that resolves an IPv4 address into geo location info.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-examples/main/ip-location/ip-location-deploy.yaml
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❻ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">spec:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">    &quot;jwt&quot;:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">      plain:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">        selector: context.metadata_context.filter_metadata.envoy\.filters\.http\.jwt_authn|verified_jwt</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">  metadata:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">    &quot;geoinfo&quot;:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">      http:</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">        url: &#39;http://ip-location.default.svc.cluster.local:3000/{context.request.http.headers.x-forwarded-for.@extract:{&quot;sep&quot;:&quot;,&quot;}}&#39;</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">        headers:</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">          &quot;Accept&quot;:</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="s">            value: application/json</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="s">      cache:</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="s">        key:</span>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="s">          selector: &quot;context.request.http.headers.x-forwarded-for.@extract:{\&quot;sep\&quot;:\&quot;,\&quot;}&quot;</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="s">  authorization:</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="s">    &quot;geofence&quot;:</span>
-</span><span id="__span-8-26"><a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="s">      when:</span>
-</span><span id="__span-8-27"><a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="s">      - selector: auth.identity.realm_access.roles</span>
-</span><span id="__span-8-28"><a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a><span class="s">        operator: excl</span>
-</span><span id="__span-8-29"><a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a><span class="s">        value: admin</span>
-</span><span id="__span-8-30"><a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-8-31"><a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="s">        patterns:</span>
-</span><span id="__span-8-32"><a id="__codelineno-8-32" name="__codelineno-8-32" href="#__codelineno-8-32"></a><span class="s">        - selector: auth.metadata.geoinfo.country_iso_code</span>
-</span><span id="__span-8-33"><a id="__codelineno-8-33" name="__codelineno-8-33" href="#__codelineno-8-33"></a><span class="s">          operator: eq</span>
-</span><span id="__span-8-34"><a id="__codelineno-8-34" name="__codelineno-8-34" href="#__codelineno-8-34"></a><span class="s">          value: &quot;GB&quot;</span>
-</span><span id="__span-8-35"><a id="__codelineno-8-35" name="__codelineno-8-35" href="#__codelineno-8-35"></a><span class="s">  response:</span>
-</span><span id="__span-8-36"><a id="__codelineno-8-36" name="__codelineno-8-36" href="#__codelineno-8-36"></a><span class="s">    unauthorized:</span>
-</span><span id="__span-8-37"><a id="__codelineno-8-37" name="__codelineno-8-37" href="#__codelineno-8-37"></a><span class="s">      message:</span>
-</span><span id="__span-8-38"><a id="__codelineno-8-38" name="__codelineno-8-38" href="#__codelineno-8-38"></a><span class="s">        selector: &quot;The requested resource is not available in {auth.metadata.geoinfo.country_name}&quot;</span>
-</span><span id="__span-8-39"><a id="__codelineno-8-39" name="__codelineno-8-39" href="#__codelineno-8-39"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="obtain-a-token-and-consume-the-api">❼ Obtain a token and consume the API<a class="headerlink" href="#obtain-a-token-and-consume-the-api" title="Permanent link">&para;</a></h2>
-<h3 id="obtain-an-access-token-and-consume-the-api-as-john-member">Obtain an access token and consume the API as John (member)<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api-as-john-member" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for John:</p>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster for the user John, a non-admin (member) user:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=john&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<p>As John, consume the API inside the area where the policy applies:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 79.123.45.67&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000<span class="w"> </span>-i
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As John, consume the API outside the area where the policy applies:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 109.69.200.56&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000<span class="w"> </span>-i
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="c1"># x-ext-auth-reason: The requested resource is not available in Italy</span>
-</span></code></pre></div>
-<p>As John, consume a path of the API that will cause Envoy to skip external authorization:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 109.69.200.56&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/global<span class="w"> </span>-i
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h3 id="obtain-an-access-token-and-consume-the-api-as-jane-admin">Obtain an access token and consume the API as Jane (admin)<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api-as-jane-admin" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for Jane, an admin user:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>As Jane, consume the API inside the area where the policy applies:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 79.123.45.67&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000<span class="w"> </span>-i
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Jane, consume the API outside the area where the policy applies:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 109.69.200.56&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000<span class="w"> </span>-i
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Jane, consume a path of the API that will cause Envoy to skip external authorization:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 109.69.200.56&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/global<span class="w"> </span>-i
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>ingress/ingress-wildcard-host
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>service/envoy
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>deployment/envoy
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>configmap/envoy
-</span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/external-metadata/index.html b/0.10.0/authorino/docs/user-guides/external-metadata/index.html
deleted file mode 100644
index b661aca49..000000000
--- a/0.10.0/authorino/docs/user-guides/external-metadata/index.html
+++ /dev/null
@@ -1,3773 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/external-metadata/">
-      
-      
-        <link rel="prev" href="../edge-authentication-architecture-festival-wristbands/">
-      
-      
-        <link rel="next" href="../oidc-user-info/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Fetching auth metadata from external sources - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-fetching-auth-metadata-from-external-sources" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Fetching auth metadata from external sources
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/external-metadata.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-fetching-auth-metadata-from-external-sources">User guide: Fetching auth metadata from external sources<a class="headerlink" href="#user-guide-fetching-auth-metadata-from-external-sources" title="Permanent link">&para;</a></h1>
-<p>Get online data from remote HTTP services to enhance authorization rules.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>External auth metadata → <a href="../features.md#http-getget-by-post-metadatahttp">HTTP GET/GET-by-POST</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-      <li>Authorization → <a href="../features.md#open-policy-agent-opa-rego-policies-authorizationopa">Open Policy Agent (OPA) Rego policies</a></li>
-    </ul>
-  </summary>
-<p>You can configure Authorino to fetch additional metadata from external sources in request-time, by sending either GET or POST request to an HTTP service. The service is expected to return a JSON content which is appended to the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>, thus becoming available for usage in other configs of the Auth Pipeline, such as in authorization policies or custom responses.</p>
-<p>URL, parameters and headers of the request to the external source of metadata can be configured, including with dynamic values. Authentication between Authorino and the service can be set as part of these configuration options, or based on shared authentication token stored in a Kubernetes <code>Secret</code>.</p>
-<p>Check out as well the user guides about <a href="../api-key-authentication/">Authentication with API keys</a> and <a href="../opa-authorization/">Open Policy Agent (OPA) Rego policies</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>In this example, we will implement a geofence policy for the API, using OPA and metadata fetching from an external service that returns geolocalization JSON data for a given IP address. The policy establishes that only <code>GET</code> requests are allowed and the path of the request should be in the form <code>/{country-code}/*</code>, where <code>{country-code}</code> is the 2-character code of the country where the client is identified as being physically present.</p>
-<p>The implementation relies on the <a href="https://datatracker.ietf.org/doc/html/rfc7239"><code>X-Forwarded-For</code></a> HTTP header to read the client's IP address.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;friends&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">        selector:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">            group: friends</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">          prefix: APIKEY</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">  metadata:</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">    &quot;geo&quot;:</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="s">      http:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="s">        url: &#39;http://ip-api.com/json/{context.request.http.headers.x-forwarded-for.@extract:{&quot;sep&quot;:&quot;,&quot;}}?fields=countryCode&#39;</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="s">        headers:</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="s">          &quot;Accept&quot;:</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="s">            value: application/json</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="s">  authorization:</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="s">    &quot;geofence&quot;:</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="s">      opa:</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="s">        rego: |</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="s">          import input.context.request.http</span>
-</span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a>
-</span><span id="__span-6-32"><a id="__codelineno-6-32" name="__codelineno-6-32" href="#__codelineno-6-32"></a><span class="s">          allow {</span>
-</span><span id="__span-6-33"><a id="__codelineno-6-33" name="__codelineno-6-33" href="#__codelineno-6-33"></a><span class="s">            http.method = &quot;GET&quot;</span>
-</span><span id="__span-6-34"><a id="__codelineno-6-34" name="__codelineno-6-34" href="#__codelineno-6-34"></a><span class="s">            split(http.path, &quot;/&quot;) = [_, requested_country, _]</span>
-</span><span id="__span-6-35"><a id="__codelineno-6-35" name="__codelineno-6-35" href="#__codelineno-6-35"></a><span class="s">            lower(requested_country) == lower(object.get(input.auth.metadata.geo, &quot;countryCode&quot;, &quot;&quot;))</span>
-</span><span id="__span-6-36"><a id="__codelineno-6-36" name="__codelineno-6-36" href="#__codelineno-6-36"></a><span class="s">          }</span>
-</span><span id="__span-6-37"><a id="__codelineno-6-37" name="__codelineno-6-37" href="#__codelineno-6-37"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check out the docs for information about the common feature <a href="../../features/#common-feature-json-paths-selector">JSON paths</a> for reading from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>, including the description of the <code>@extract</code> string modifier.</p>
-<h2 id="create-an-api-key">❻ Create an API key<a class="headerlink" href="#create-an-api-key" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">  labels:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    group: friends</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">stringData:</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>From an IP address assigned to the United Kingdom of Great Britain and Northern Ireland (country code GB):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 79.123.45.67&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/gb/hello<span class="w"> </span>-i
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 79.123.45.67&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/it/hello<span class="w"> </span>-i
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<p>From an IP address assigned to Italy (country code IT):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 109.112.34.56&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/gb/hello<span class="w"> </span>-i
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 109.112.34.56&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/it/hello<span class="w"> </span>-i
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-1
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/hello-world/index.html b/0.10.0/authorino/docs/user-guides/hello-world/index.html
deleted file mode 100644
index 237b7036b..000000000
--- a/0.10.0/authorino/docs/user-guides/hello-world/index.html
+++ /dev/null
@@ -1,3788 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/hello-world/">
-      
-      
-        <link rel="prev" href="../../getting-started/">
-      
-      
-        <link rel="next" href="../../architecture/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Hello World - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-hello-world" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Hello World
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-namespace" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Create the namespace
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api-unprotected" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Consume the API (unprotected)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#protect-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Protect the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❺ Protect the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-the-authorino-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install the Authorino Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api-behind-envoy-and-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Consume the API behind Envoy and Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#apply-the-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Apply the AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api-without-credentials" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Consume the API without credentials
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#grant-access-to-the-api-with-a-tailor-made-security-scheme" class="md-nav__link">
-    <span class="md-ellipsis">
-      Grant access to the API with a tailor-made security scheme
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-namespace" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Create the namespace
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api-unprotected" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Consume the API (unprotected)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#protect-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Protect the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❺ Protect the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-the-authorino-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install the Authorino Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api-behind-envoy-and-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Consume the API behind Envoy and Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#apply-the-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Apply the AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api-without-credentials" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Consume the API without credentials
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#grant-access-to-the-api-with-a-tailor-made-security-scheme" class="md-nav__link">
-    <span class="md-ellipsis">
-      Grant access to the API with a tailor-made security scheme
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/hello-world.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-hello-world">User guide: Hello World<a class="headerlink" href="#user-guide-hello-world" title="Permanent link">&para;</a></h1>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a>, you can skip step ❸. You may already have Authorino installed and running as well. In this case, skip also step ❺. If you even have your workload cluster configured, with sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, go straight to step ❼.</p>
-        <p>At step ❼, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<h2 id="create-the-namespace">❶ Create the namespace<a class="headerlink" href="#create-the-namespace" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>hello-world
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="c1"># namespace/hello-world created</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❷ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>hello-world<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="c1"># deployment.apps/talker-api created</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="c1"># service/talker-api created</span>
-</span></code></pre></div>
-<h2 id="setup-envoy">❸ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">1</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>hello-world<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/hello-world/envoy-deploy.yaml
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="c1"># configmap/envoy created</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="c1"># deployment.apps/envoy created</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="c1"># service/envoy created</span>
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>hello-world<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="consume-the-api-unprotected">❹ Consume the API (unprotected)<a class="headerlink" href="#consume-the-api-unprotected" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="protect-the-api">❺ Protect the API<a class="headerlink" href="#protect-the-api" title="Permanent link">&para;</a></h2>
-<h3 id="install-the-authorino-operator">Install the Authorino Operator<a class="headerlink" href="#install-the-authorino-operator" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h3 id="deploy-authorino">Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h3>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">2</a></sup> that watches for <code>AuthConfig</code> resources in the <code>hello-world</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">3</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">4</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>hello-world<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/hello-world/authorino.yaml
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="c1"># authorino.operator.authorino.kuadrant.io/authorino created</span>
-</span></code></pre></div>
-<h2 id="consume-the-api-behind-envoy-and-authorino">❻ Consume the API behind Envoy and Authorino<a class="headerlink" href="#consume-the-api-behind-envoy-and-authorino" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># HTTP/1.1 404 Not Found</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="c1"># x-ext-auth-reason: Service not found</span>
-</span></code></pre></div>
-<p>Authorino does not know about the <code>talker-api.127.0.0.1.nip.io</code> host, hence the <code>404 Not Found</code>. Let's teach Authorino about this host by applying an <code>AuthConfig</code>.</p>
-<h2 id="apply-the-authconfig">❼ Apply the <code>AuthConfig</code><a class="headerlink" href="#apply-the-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>hello-world<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/hello-world/authconfig.yaml
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="c1"># authconfig.authorino.kuadrant.io/talker-api-protection created</span>
-</span></code></pre></div>
-<h2 id="consume-the-api-without-credentials">❽ Consume the API without credentials<a class="headerlink" href="#consume-the-api-without-credentials" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="c1"># www-authenticate: APIKEY realm=&quot;api-clients&quot;</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># x-ext-auth-reason: credential not found</span>
-</span></code></pre></div>
-<h2 id="grant-access-to-the-api-with-a-tailor-made-security-scheme">Grant access to the API with a tailor-made security scheme<a class="headerlink" href="#grant-access-to-the-api-with-a-tailor-made-security-scheme" title="Permanent link">&para;</a></h2>
-<p>Check out other <a href="../">user guides</a> for several use-cases of authentication and authorization, and the instructions to implement them using Authorino.</p>
-<p>A few examples of available ser guides:</p>
-<ul>
-<li><a href="../api-key-authentication/">Authentication with API keys</a></li>
-<li><a href="../oidc-jwt-authentication/">Authentication with JWTs and OpenID Connect Discovery</a></li>
-<li><a href="../kubernetes-tokenreview/">Authentication with Kubernetes tokens (TokenReview API)</a></li>
-<li><a href="../opa-authorization/">Authorization with Open Policy Agent (OPA) Rego policies</a></li>
-<li><a href="../json-pattern-matching-authorization/">Authorization with simple JSON pattern-matching rules (e.g. JWT claims)</a></li>
-<li><a href="../kubernetes-subjectaccessreview/">Authorization with Kubernetes RBAC (SubjectAccessReview API)</a></li>
-<li><a href="../external-metadata/">Fetching auth metadata from external sources</a></li>
-<li><a href="../token-normalization/">Token normalization</a></li>
-</ul>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the namespaces created in step 1 and 5:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>hello-world
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>authorino-operator
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/host-override/index.html b/0.10.0/authorino/docs/user-guides/host-override/index.html
deleted file mode 100644
index 182714d64..000000000
--- a/0.10.0/authorino/docs/user-guides/host-override/index.html
+++ /dev/null
@@ -1,3574 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/host-override/">
-      
-      
-        <link rel="prev" href="../../features/">
-      
-      
-        <link rel="next" href="../sharding/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Host override via context extension - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#host-override-via-context-extension" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Host override via context extension
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#example-of-host-override-for-path-prefix-based-lookup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example of host override for path prefix-based lookup
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#example-of-host-override-for-wildcard-subdomain-lookup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example of host override for wildcard subdomain lookup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#example-of-host-override-for-path-prefix-based-lookup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example of host override for path prefix-based lookup
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#example-of-host-override-for-wildcard-subdomain-lookup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example of host override for wildcard subdomain lookup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/host-override.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="host-override-via-context-extension">Host override via context extension<a class="headerlink" href="#host-override-via-context-extension" title="Permanent link">&para;</a></h1>
-<p>By default, Authorino uses the host information of the HTTP request (<a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/auth/v3/attribute_context.proto#service-auth-v3-attributecontext-httprequest"><code>Attributes.Http.Host</code></a>) to lookup for an indexed AuthConfig to be enforced<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup>. The host info be overridden by supplying a <code>host</code> entry as a (per-route) context extension (<a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/auth/v3/attribute_context.proto#envoy-v3-api-field-service-auth-v3-attributecontext-context-extensions"><code>Attributes.ContextExtensions</code></a>), which takes precedence whenever present.</p>
-<p>Overriding the host attribute of the HTTP request can be useful to support use cases such as of <strong>path prefix-based lookup</strong> and <strong>wildcard subdomains lookup</strong>.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b>⚠️ <i>Important:</i></b>
-        This feature may not be available to users of Authorino via <a href="https://kuadrant.io">Kuadrant</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<p>In this guide:</p>
-<ul>
-<li><a href="#example-of-host-override-for-path-prefix-based-lookup">Example of host override for path prefix-based lookup</a></li>
-<li><a href="#example-of-host-override-for-wildcard-subdomain-lookup">Example of host override for wildcard subdomain lookup</a></li>
-</ul>
-<h2 id="example-of-host-override-for-path-prefix-based-lookup">Example of host override for path prefix-based lookup<a class="headerlink" href="#example-of-host-override-for-path-prefix-based-lookup" title="Permanent link">&para;</a></h2>
-<p>In this use case, 2 different APIs (i.e. <strong>Dogs API</strong> and <strong>Cats API</strong>) are served under the same base domain, and differentiated by the path prefix:</p>
-<ul>
-<li><code>pets.com/dogs</code> →  Dogs API</li>
-<li><code>pets.com/cats</code> →  Cats API</li>
-</ul>
-<p>Edit the Envoy config to extend the external authorization settings at the level of the routes, with the <code>host</code> value that will be favored by Authorino before the actual host attribute of the HTTP request:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">virtual_hosts</span><span class="p">:</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pets-api</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">domains</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&#39;pets.com&#39;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">routes</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">match</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">      </span><span class="nt">prefix</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/dogs</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">    </span><span class="nt">route</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">      </span><span class="nt">cluster</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dogs-api</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">typed_per_filter_config</span><span class="p">:</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">      </span><span class="nt">envoy.filters.http.ext_authz</span><span class="p">:</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">        </span><span class="l l-Scalar l-Scalar-Plain">\&quot;@type\&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">        </span><span class="nt">check_settings</span><span class="p">:</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">          </span><span class="nt">context_extensions</span><span class="p">:</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">            </span><span class="nt">host</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dogs.pets.com</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">match</span><span class="p">:</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">      </span><span class="nt">prefix</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/cats</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">    </span><span class="nt">route</span><span class="p">:</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">      </span><span class="nt">cluster</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cats-api</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">    </span><span class="nt">typed_per_filter_config</span><span class="p">:</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">      </span><span class="nt">envoy.filters.http.ext_authz</span><span class="p">:</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">        </span><span class="l l-Scalar l-Scalar-Plain">\&quot;@type\&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">        </span><span class="nt">check_settings</span><span class="p">:</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">          </span><span class="nt">context_extensions</span><span class="p">:</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="w">            </span><span class="nt">host</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cats.pets.com</span>
-</span></code></pre></div>
-<p>Create the AuthConfig for the <strong>Pets API</strong>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dogs-api-protection</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dogs.pets.com</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">...</span><span class="p p-Indicator">]</span>
-</span></code></pre></div>
-<p>Create the AuthConfig for the <strong>Cats API</strong>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cats-api-protection</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cats.pets.com</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">...</span><span class="p p-Indicator">]</span>
-</span></code></pre></div>
-<p>Notice that the host subdomains <code>dogs.pets.com</code> and <code>cats.pets.com</code> are not really requested by the API consumers. Rather, users send requests to <code>pets.com/dogs</code> and <code>pets.com/cats</code>. When routing those requests, Envoy makes sure to inject the corresponding context extensions that will induce the right lookup in Authorino.</p>
-<h2 id="example-of-host-override-for-wildcard-subdomain-lookup">Example of host override for wildcard subdomain lookup<a class="headerlink" href="#example-of-host-override-for-wildcard-subdomain-lookup" title="Permanent link">&para;</a></h2>
-<p>In this use case, a single <strong>Pets API</strong> serves requests for any subdomain that matches <code>*.pets.com</code>, e.g.:</p>
-<ul>
-<li><code>dogs.pets.com</code> →  Pets API</li>
-<li><code>cats.pets.com</code> →  Pets API</li>
-</ul>
-<p>Edit the Envoy config to extend the external authorization settings at the level of the virtual host, with the <code>host</code> value that will be favored by Authorino before the actual host attribute of the HTTP request:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">virtual_hosts</span><span class="p">:</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pets-api</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">  </span><span class="nt">domains</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&#39;*.pets.com&#39;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">  </span><span class="nt">typed_per_filter_config</span><span class="p">:</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">    </span><span class="nt">envoy.filters.http.ext_authz</span><span class="p">:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">      </span><span class="l l-Scalar l-Scalar-Plain">\&quot;@type\&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">      </span><span class="nt">check_settings</span><span class="p">:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">        </span><span class="nt">context_extensions</span><span class="p">:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">          </span><span class="nt">host</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pets.com</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">  </span><span class="nt">routes</span><span class="p">:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">match</span><span class="p">:</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="w">      </span><span class="nt">prefix</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="w">    </span><span class="nt">route</span><span class="p">:</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="w">      </span><span class="nt">cluster</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pets-api</span>
-</span></code></pre></div>
-<p>The <code>host</code> context extension used above is any key that matches one of the hosts listed in the targeted AuthConfig.</p>
-<p>Create the AuthConfig for the <strong>Pets API</strong>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthConfig</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pets-api-protection</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="w">  </span><span class="nt">hosts</span><span class="p">:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pets.com</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="w">  </span><span class="nt">authentication</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">...</span><span class="p p-Indicator">]</span>
-</span></code></pre></div>
-<p>Notice that requests to <code>dogs.pets.com</code> and to <code>cats.pets.com</code> are all routed by Envoy to the same API, with same external authorization configuration. in all the cases, Authorino will lookup for the indexed AuthConfig associated with <code>pets.com</code>. The same is valid for a request sent, e.g., to <code>birds.pets.com</code>.</p>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>For further details about Authorino lookup of AuthConfig, check out <a href="../../architecture/#host-lookup">Host lookup</a>.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/http-basic-authentication/index.html b/0.10.0/authorino/docs/user-guides/http-basic-authentication/index.html
deleted file mode 100644
index 81f5b5634..000000000
--- a/0.10.0/authorino/docs/user-guides/http-basic-authentication/index.html
+++ /dev/null
@@ -1,3802 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/http-basic-authentication/">
-      
-      
-        <link rel="prev" href="../passing-credentials/">
-      
-      
-        <link rel="next" href="../anonymous-access/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>HTTP "Basic" Authentication (RFC 7235) - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-http-basic-authentication-rfc-7235" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              HTTP "Basic" Authentication (RFC 7235)
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-user-credentials" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create user credentials
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#revoke-access-to-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Revoke access to the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-user-credentials" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create user credentials
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#revoke-access-to-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Revoke access to the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/http-basic-authentication.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-http-basic-authentication-rfc-7235">User guide: HTTP "Basic" Authentication (RFC 7235)<a class="headerlink" href="#user-guide-http-basic-authentication-rfc-7235" title="Permanent link">&para;</a></h1>
-<p>Turn Authorino API key <code>Secret</code>s settings into HTTP basic auth.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-        <li>Authorization → <a href="../features.md#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization</a></li>
-    </ul>
-  </summary>
-<p>HTTP "Basic" Authentication (<a href="https://datatracker.ietf.org/doc/html/rfc7235">RFC 7235</a>) is not recommended if you can afford other more secure methods such as OpenID Connect. To support legacy nonetheless it is sometimes necessary to implement it.</p>
-<p>In Authorino, HTTP "Basic" Authentication can be modeled leveraging the API key authentication feature (stored as Kubernetes <code>Secret</code>s with an <code>api_key</code> entry and labeled to match selectors specified in <code>spec.identity.apiKey.selector</code> of the <code>AuthConfig</code>).</p>
-<p>Check out as well the user guide about <a href="../api-key-authentication/">Authentication with API keys</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>The config uses API Key secrets to store base64-encoded <code>username:password</code> HTTP "Basic" authentication credentials. The config also specifies an Access Control List (ACL) by which only user <code>john</code> is authorized to consume the <code>/bye</code> endpoint of the API.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;http-basic-auth&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">        selector:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">            group: users</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">          prefix: Basic</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">  authorization:</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">    &quot;acl&quot;:</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="s">      when:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="s">      - selector: context.request.http.path</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="s">        operator: eq</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="s">        value: /bye</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="s">        patterns:</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="s">        - selector: context.request.http.headers.authorization.@extract:{&quot;pos&quot;:1}|@base64:decode|@extract:{&quot;sep&quot;:&quot;:&quot;}</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="s">          operator: eq</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="s">          value: john</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check out the docs for information about the common feature <a href="../../features/#common-feature-json-paths-selector">JSON paths</a> for reading from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>, including the description of the string modifiers <code>@extract</code> and <code>@case</code> used above. Check out as well the common feature <a href="../../features/#common-feature-conditions-when">Conditions</a> about skipping parts of an <code>AuthConfig</code> in the auth pipeline based on context.</p>
-<h2 id="create-user-credentials">❻ Create user credentials<a class="headerlink" href="#create-user-credentials" title="Permanent link">&para;</a></h2>
-<p>To create credentials for HTTP "Basic" Authentication, store each <code>username:password</code>, base64-encoded, in the <code>api_key</code> value of the Kubernetes <code>Secret</code> resources. E.g.:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nb">printf</span><span class="w"> </span><span class="s2">&quot;john:ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>base64
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="c1"># am9objpuZHlCenJlVXpGNHpxRFFzcVNQTUhrUmhyaUVPdGNSeA==</span>
-</span></code></pre></div>
-<p>Create credentials for user John:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: basic-auth-1</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  labels:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">    group: users</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">stringData:</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  api_key: am9objpuZHlCenJlVXpGNHpxRFFzcVNQTUhrUmhyaUVPdGNSeA== # john:ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create credentials for user Jane:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: basic-auth-2</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">  labels:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">    group: users</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">stringData:</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">  api_key: amFuZTpkTnNScnNhcHkwbk5Dd210NTM3ZkhGcHl4MGNCc0xFcA== # jane:dNsRrsapy0nNCwmt537fHFpyx0cBsLEp</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>As John (authorized in the ACL):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-u<span class="w"> </span>john:ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-u<span class="w"> </span>john:ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/bye
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Jane (NOT authorized in the ACL):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-u<span class="w"> </span>jane:dNsRrsapy0nNCwmt537fHFpyx0cBsLEp<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-u<span class="w"> </span>jane:dNsRrsapy0nNCwmt537fHFpyx0cBsLEp<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/bye<span class="w"> </span>-i
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<p>With an invalid user/password:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>-u<span class="w"> </span>unknown:invalid<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="c1"># www-authenticate: Basic realm=&quot;http-basic-auth&quot;</span>
-</span></code></pre></div>
-<h2 id="revoke-access-to-the-api">❽ Revoke access to the API<a class="headerlink" href="#revoke-access-to-the-api" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/basic-auth-1
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/basic-auth-1
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/basic-auth-2
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-1.png b/0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-1.png
deleted file mode 100644
index 2532c47f03de85444dd6b390e425907943a0b6f8..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 265966
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
Y{(Kw-edm+I0`PTUpVQvlJ?C!y9}-_!S^xk5

diff --git a/0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-2.png b/0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-2.png
deleted file mode 100644
index 1d533cddec035d374ce67d778ca5c0111e941c3b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 257670
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
Ab^rhX

diff --git a/0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-3.png b/0.10.0/authorino/docs/user-guides/images/keycloak-authorization-services-3.png
deleted file mode 100644
index 9cd5fc28fc339572543e04143fac40675904048d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 278584
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%0D+%V9Fc2M@W_p5)xhm>Tf<;$?&1QiuLY@r3<|
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
G&-^!R)}y2V

diff --git a/0.10.0/authorino/docs/user-guides/index.html b/0.10.0/authorino/docs/user-guides/index.html
deleted file mode 100644
index 7eed60ea6..000000000
--- a/0.10.0/authorino/docs/user-guides/index.html
+++ /dev/null
@@ -1,3476 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>User guides - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guides" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              User guides
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guides">User guides<a class="headerlink" href="#user-guides" title="Permanent link">&para;</a></h1>
-<ul>
-<li>
-<p><strong><a href="hello-world/">Hello World</a></strong><br/>
-The basics of protecting an API with Authorino.</p>
-</li>
-<li>
-<p><strong><a href="kubernetes-tokenreview/">Authentication with Kubernetes tokens (TokenReview API)</a></strong><br/>
-Validate Kubernetes Service Account tokens to authenticate requests to your protected hosts.</p>
-</li>
-<li>
-<p><strong><a href="api-key-authentication/">Authentication with API keys</a></strong><br/>
-Issue API keys stored in Kubernetes <code>Secret</code>s for clients to authenticate with your protected hosts.</p>
-</li>
-<li>
-<p><strong><a href="mtls-authentication/">Authentication with X.509 certificates and mTLS</a></strong><br/>
-Verify client X.509 certificates against trusted root CAs.</p>
-</li>
-<li>
-<p><strong><a href="oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a></strong><br/>
-Validate JSON Web Tokens (JWT) issued and signed by an OpenID Connect server; leverage OpenID Connect Discovery to automatically fetch JSON Web Key Sets (JWKS).</p>
-</li>
-<li>
-<p><strong><a href="oauth2-token-introspection/">OAuth 2.0 token introspection (RFC 7662)</a></strong><br/>
-Introspect OAuth 2.0 access tokens (e.g. opaque tokens) for online user data and token validation in request-time.</p>
-</li>
-<li>
-<p><strong><a href="passing-credentials/">Passing credentials (<code>Authorization</code> header, cookie headers and others)</a></strong><br/>
-Customize where credentials are supplied in the request by each trusted source of identity.</p>
-</li>
-<li>
-<p><strong><a href="http-basic-authentication/">HTTP "Basic" Authentication (RFC 7235)</a></strong><br/>
-Turn Authorino API key <code>Secret</code>s settings into HTTP basic auth.</p>
-</li>
-<li>
-<p><strong><a href="anonymous-access/">Anonymous access</a></strong><br/>
-Bypass identity verification or fall back to anonymous access when credentials fail to validate</p>
-</li>
-<li>
-<p><strong><a href="token-normalization/">Token normalization</a></strong><br/>
-Normalize identity claims from trusted sources and reduce complexity in your policies.</p>
-</li>
-<li>
-<p><strong><a href="edge-authentication-architecture-festival-wristbands/">Edge Authentication Architecture (EAA)</a></strong><br/>
-Exchange satellite (outer-layer) authentication tokens for "Festival Wristbands" accepted ubiquitously at the inside of your network. Normalize from multiple and varied sources of identity and authentication methods in the edge of your architecture; filter privacy data, limit the scope of permissions, and simplify authorization rules to your internal microservices.</p>
-</li>
-<li>
-<p><strong><a href="external-metadata/">Fetching auth metadata from external sources</a></strong><br/>
-Get online data from remote HTTP services to enhance authorization rules.</p>
-</li>
-<li>
-<p><strong><a href="oidc-user-info/">OpenID Connect UserInfo</a></strong><br/>
-Fetch user info for OpenID Connect ID tokens in request-time for extra metadata for your policies and online verification of token validity.</p>
-</li>
-<li>
-<p><strong><a href="resource-level-authorization-uma/">Resource-level authorization with User-Managed Access (UMA) resource registry</a></strong><br/>
-Fetch resource attributes relevant for authorization from a User-Managed Access (UMA) resource registry such as Keycloak resource server clients.</p>
-</li>
-<li>
-<p><strong><a href="json-pattern-matching-authorization/">Simple pattern-matching authorization policies</a></strong><br/>
-Write simple authorization rules based on JSON patterns matched against Authorino's Authorization JSON; check contextual information of the request, validate JWT claims, cross metadata fetched from external sources, etc.</p>
-</li>
-<li>
-<p><strong><a href="oidc-rbac/">OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Authorino and Keycloak</a></strong><br/>
-Combine OpenID Connect (OIDC) authentication and Role-Based Access Control (RBAC) authorization rules leveraging Keycloak and Authorino working together.</p>
-</li>
-<li>
-<p><strong><a href="opa-authorization/">Open Policy Agent (OPA) Rego policies</a></strong><br/>
-Leverage the power of Open Policy Agent (OPA) policies, evaluated against Authorino's Authorization JSON in a built-in runtime compiled together with Authorino; pre-cache policies defined in Rego language inline or fetched from an external policy registry.</p>
-</li>
-<li>
-<p><strong><a href="kubernetes-subjectaccessreview/">Kubernetes RBAC for service authorization (SubjectAccessReview API)</a></strong><br/>
-Manage permissions in the Kubernetes RBAC and let Authorino to check them in request-time with the authorization system of the cluster.</p>
-</li>
-<li>
-<p><strong><a href="keycloak-authorization-services/">Authorization with Keycloak Authorization Services</a></strong><br/>
-Use Authorino as an adapter for Keycloak Authorization Services without importing any library or rebuilding your application code.</p>
-</li>
-<li>
-<p><strong><a href="authzed/">Integration with Authzed/SpiceDB</a></strong><br/>
-Permission requests sent to a Google Zanzibar-based <a href="https://authzed.com">Authzed/SpiceDB</a> instance, via gRPC.</p>
-</li>
-<li>
-<p><strong><a href="injecting-data/">Injecting data in the request</a></strong><br/>
-Inject HTTP headers with serialized JSON content.</p>
-</li>
-<li>
-<p><strong><a href="authenticated-rate-limiting-envoy-dynamic-metadata/">Authenticated rate limiting (with Envoy Dynamic Metadata)</a></strong><br/>
-Provide Envoy with dynamic metadata from the external authorization process to be injected and used by consecutive filters, such as by a rate limiting service.</p>
-</li>
-<li>
-<p><strong><a href="deny-with-redirect-to-login/">Redirecting to a login page</a></strong><br/>
-Customize response status code and headers on failed requests. E.g. redirect users of a web application protected with Authorino to a login page instead of a <code>401 Unauthorized</code>; mask resources on access denied behind a <code>404 Not Found</code> response instead of <code>403 Forbidden</code>.</p>
-</li>
-<li>
-<p><strong><a href="envoy-jwt-authn-and-authorino/">Mixing Envoy built-in filter for auth and Authorino</a></strong><br/>
-Have JWT validation handled by Envoy beforehand and the JWT payload injected into the request to Authorino, to be used in custom authorization policies defined in a AuthConfig.</p>
-</li>
-<li>
-<p><strong><a href="host-override/">Host override via context extension</a></strong><br/>
-Induce the lookup of an AuthConfig by supplying extended host context, for use cases such as of path prefix-based lookup and wildcard subdomains lookup.</p>
-</li>
-<li>
-<p><strong><a href="validating-webhook/">Using Authorino as ValidatingWebhook service</a></strong><br/>
-Use Authorino as a generic Kubernetes ValidatingWebhook service where the rules to validate a request to the Kubernetes API are written in an AuthConfig.</p>
-</li>
-<li>
-<p><strong><a href="sharding/">Reducing the operational space: sharding, noise and multi-tenancy</a></strong><br/>
-Have multiple instances of Authorino running in the same space (Kubernetes namespace or cluster-scoped), yet watching particular sets of resources.</p>
-</li>
-<li>
-<p><strong><a href="caching/">Caching</a></strong><br/>
-Cache auth objects resolved at runtime for any configuration bit of an AuthConfig, for easy access in subsequent requests whenever an arbitrary cache key repeats, until the cache entry expires.</p>
-</li>
-<li>
-<p><strong><a href="observability/">Observability</a></strong><br/>
-Prometheus metrics exported by Authorino, readiness probe, logging, tracing, etc.</p>
-</li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/injecting-data/index.html b/0.10.0/authorino/docs/user-guides/injecting-data/index.html
deleted file mode 100644
index 5b9570c58..000000000
--- a/0.10.0/authorino/docs/user-guides/injecting-data/index.html
+++ /dev/null
@@ -1,3762 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/injecting-data/">
-      
-      
-        <link rel="prev" href="../authzed/">
-      
-      
-        <link rel="next" href="../authenticated-rate-limiting-envoy-dynamic-metadata/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Injecting data in the request - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-injecting-data-in-the-request" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Injecting data in the request
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/injecting-data.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-injecting-data-in-the-request">User guide: Injecting data in the request<a class="headerlink" href="#user-guide-injecting-data-in-the-request" title="Permanent link">&para;</a></h1>
-<p>Inject HTTP headers with serialized JSON content.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Dynamic response → <a href="../features.md#json-injection-responsesuccessheadersdynamicmetadatajson">JSON injection</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-    </ul>
-  </summary>
-<p>Inject serialized custom JSON objects as HTTP request headers. Values can be static or fetched from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>.</p>
-<p>Check out as well the user guide about <a href="../api-key-authentication/">Authentication with API keys</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>The following defines a JSON object to be injected as an added HTTP header into the request, named after the response config <code>x-ext-auth-data</code>. The object includes 3 properties:</p>
-<ol>
-<li>a static value <code>authorized: true</code>;</li>
-<li>a dynamic value <code>request-time</code>, from Envoy-supplied contextual data present in the Authorization JSON; and</li>
-<li>a greeting message <code>geeting-message</code> that interpolates a dynamic value read from an annotation of the Kubernetes <code>Secret</code> resource that represents the API key used to authenticate into a static string.</li>
-</ol>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;friends&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">        selector:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">            group: friends</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">          prefix: APIKEY</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">  response:</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">    success:</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="s">      headers:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="s">        &quot;x-ext-auth-data&quot;:</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="s">          json:</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="s">            properties:</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="s">              &quot;authorized&quot;:</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="s">                value: true</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="s">              &quot;request-time&quot;:</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="s">                selector: context.request.time.seconds</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="s">              &quot;greeting-message&quot;:</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="s">                selector: Hello, {auth.identity.metadata.annotations.auth-data\/name}!</span>
-</span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check out the docs for information about the common feature <a href="../../features/#common-feature-json-paths-selector">JSON paths</a> for reading from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>.</p>
-<h2 id="create-an-api-key">❻ Create an API key<a class="headerlink" href="#create-an-api-key" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">  labels:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    group: friends</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  annotations:</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">    auth-data/name: Rita</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">stringData:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">type: Opaque</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># {</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="c1">#   &quot;method&quot;: &quot;GET&quot;,</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="c1">#   &quot;path&quot;: &quot;/hello&quot;,</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="c1">#   &quot;query_string&quot;: null,</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="c1">#   &quot;body&quot;: &quot;&quot;,</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="c1">#   &quot;headers&quot;: {</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="c1">#     …</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="c1">#     &quot;X-Ext-Auth-Data&quot;: &quot;{\&quot;authorized\&quot;:true,\&quot;greeting-message\&quot;:\&quot;Hello, Rita!\&quot;,\&quot;request-time\&quot;:1637954644}&quot;,</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="c1">#   },</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="c1">#   …</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="c1"># }</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-1
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/json-pattern-matching-authorization/index.html b/0.10.0/authorino/docs/user-guides/json-pattern-matching-authorization/index.html
deleted file mode 100644
index 405d48617..000000000
--- a/0.10.0/authorino/docs/user-guides/json-pattern-matching-authorization/index.html
+++ /dev/null
@@ -1,3796 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/json-pattern-matching-authorization/">
-      
-      
-        <link rel="prev" href="../resource-level-authorization-uma/">
-      
-      
-        <link rel="next" href="../oidc-rbac/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Simple pattern-matching authorization policies - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-simple-pattern-matching-authorization-policies" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Simple pattern-matching authorization policies
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Obtain an access token and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-jane-email-verified" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Jane (email verified)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-peter-email-not-verified" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Peter (email NOT verified)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Obtain an access token and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-jane-email-verified" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Jane (email verified)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-peter-email-not-verified" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Peter (email NOT verified)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/json-pattern-matching-authorization.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-simple-pattern-matching-authorization-policies">User guide: Simple pattern-matching authorization policies<a class="headerlink" href="#user-guide-simple-pattern-matching-authorization-policies" title="Permanent link">&para;</a></h1>
-<p>Write simple authorization rules based on JSON patterns matched against Authorino's Authorization JSON; check contextual information of the request, validate JWT claims, cross metadata fetched from external sources, etc.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Authorization → <a href="../features.md#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-    </ul>
-  </summary>
-<p>Authorino provides a built-in authorization module to check simple pattern-matching rules against the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>. This is an alternative to <a href="../../features/#open-policy-agent-opa-rego-policies-authorizationopa">OPA</a> when all you want is to check for some simple rules, without complex logics, such as match the value of a JWT claim.</p>
-<p>Check out as well the user guide about <a href="../oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  listener:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    tls:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    tls:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>The <code>email-verified-only</code> authorization policy ensures that users consuming the API from a given network (IP range 192.168.1/24) must have their emails verified.</p>
-<p>The <code>email_verified</code> claim is a property of the identity added to the JWT by the OpenID Connect issuer.</p>
-<p>The implementation relies on the <a href="https://datatracker.ietf.org/doc/html/rfc7239"><code>X-Forwarded-For</code></a> HTTP header to read the client's IP address.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">    &quot;keycloak-kuadrant-realm&quot;:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">  authorization:</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="s">    &quot;email-verified-only&quot;:</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="s">      when:</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="s">      - selector: &quot;context.request.http.headers.x-forwarded-for.@extract:{\&quot;sep\&quot;: \&quot;,\&quot;}&quot;</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="s">        operator: matches</span>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="s">        value: 192\\.168\\.1\\.\\d+</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-7-21"><a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="s">        patterns:</span>
-</span><span id="__span-7-22"><a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="s">        - selector: auth.identity.email_verified</span>
-</span><span id="__span-7-23"><a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a><span class="s">          operator: eq</span>
-</span><span id="__span-7-24"><a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a><span class="s">          value: &quot;true&quot;</span>
-</span><span id="__span-7-25"><a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check out the docs for information about semantics and operators supported by the <a href="../../features/#pattern-matching-authorization-authorizationpatternmatching">JSON pattern-matching authorization</a> feature, as well the common feature <a href="../../features/#common-feature-json-paths-selector">JSON paths</a> for reading from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>, including the description of the string modifier <code>@extract</code> used above. Check out as well the common feature <a href="../../features/#common-feature-conditions-when">Conditions</a> about skipping parts of an <code>AuthConfig</code> in the auth pipeline based on context.</p>
-<h2 id="obtain-an-access-token-and-consume-the-api">❻ Obtain an access token and consume the API<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api" title="Permanent link">&para;</a></h2>
-<h3 id="obtain-an-access-token-and-consume-the-api-as-jane-email-verified">Obtain an access token and consume the API as Jane (email verified)<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api-as-jane-email-verified" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for Jane:</p>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster for the user Jane, whose e-mail has been verified:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<p>As Jane, consume the API outside the area where the policy applies:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 123.45.6.78&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Jane, consume the API inside the area where the policy applies:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 192.168.1.10&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h3 id="obtain-an-access-token-and-consume-the-api-as-peter-email-not-verified">Obtain an access token and consume the API as Peter (email NOT verified)<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api-as-peter-email-not-verified" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for Peter:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=peter&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>As Peter, consume the API outside the area where the policy applies:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 123.45.6.78&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Peter, consume the API inside the area where the policy applies:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 192.168.1.10&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="c1"># x-ext-auth-reason: Unauthorized</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/keycloak-authorization-services/index.html b/0.10.0/authorino/docs/user-guides/keycloak-authorization-services/index.html
deleted file mode 100644
index 16944e904..000000000
--- a/0.10.0/authorino/docs/user-guides/keycloak-authorization-services/index.html
+++ /dev/null
@@ -1,3784 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/keycloak-authorization-services/">
-      
-      
-        <link rel="prev" href="../kubernetes-subjectaccessreview/">
-      
-      
-        <link rel="next" href="../authzed/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Authorization with Keycloak Authorization Services - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-authorization-with-keycloak-authorization-services" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Authorization with Keycloak Authorization Services
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-the-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token with the Keycloak server
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-the-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token with the Keycloak server
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/keycloak-authorization-services.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-authorization-with-keycloak-authorization-services">User guide: Authorization with Keycloak Authorization Services<a class="headerlink" href="#user-guide-authorization-with-keycloak-authorization-services" title="Permanent link">&para;</a></h1>
-<p>Keycloak provides a powerful set of tools (REST endpoints and administrative UIs), also known as <a href="https://www.keycloak.org/docs/latest/authorization_services/index.html">Keycloak Authorization Services</a>, to manage and enforce authorization, workflows for multiple access control mechanisms, including discretionary user access control and user-managed permissions.</p>
-<p>This user guide is an example of how to use Authorino as an adapter to Keycloak Authorization Services while still relying on the reverse-proxy integration pattern, thus not involving importing an authorization library nor rebuilding the application's code.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-      <li>Authorization → <a href="../features.md#open-policy-agent-opa-rego-policies-authorizationopa">Open Policy Agent (OPA) Rego policies</a></li>
-    </ul>
-  </summary>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li><a href="https://www.keycloak.org">Keycloak</a> server</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p>Forward local requests to Keycloak running inside the cluster (if using Kind):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>port-forward<span class="w"> </span>deployment/keycloak<span class="w"> </span><span class="m">8080</span>:8080<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">spec:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">  listener:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">    tls:</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">    tls:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>In this example, Authorino will accept access tokens (JWTs) issued by the Keycloak server. These JWTs can be either normal Keycloak ID tokens or Requesting Party Tokens (RPT).</p>
-<p>RPTs include claims about the permissions of the user regarding protected resources and scopes associated with a Keycloak authorization client that the user can access.</p>
-<p>When the supplied access token is an RPT, Authorino will just validate whether the user's granted permissions present in the token include the requested resource ID (translated from the path) and scope (inferred from the HTTP method). If the token does not contain a <code>permissions</code> claim (i.e. it is not an RPT), Authorino will negotiate a User-Managed Access (UMA) ticket on behalf of the user and try to obtain an RPT on that UMA ticket.</p>
-<p>In cases of asynchronous user-managed permission control, the first request to the API using a normal Keycloak ID token is denied by Authorino. The user that owns the resource acknowledges the access request in the Keycloak UI. If access is granted, the new permissions will be reflected in subsequent RPTs obtained by Authorino on behalf of the requesting party.</p>
-<p>Whenever an RPT with proper permissions is obtained by Authorino, the RPT is supplied back to the API consumer, so it can be used in subsequent requests thus skipping new negotiations of UMA tickets.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">spec:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">    &quot;keycloak-kuadrant-realm&quot;:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">  authorization:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">    &quot;uma&quot;:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">      opa:</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">        rego: |</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">          pat := http.send({&quot;url&quot;:&quot;http://talker-api:523b92b6-625d-4e1e-a313-77e7a8ae4e88@keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token&quot;,&quot;method&quot;: &quot;post&quot;,&quot;headers&quot;:{&quot;Content-Type&quot;:&quot;application/x-www-form-urlencoded&quot;},&quot;raw_body&quot;:&quot;grant_type=client_credentials&quot;}).body.access_token</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">          resource_id := http.send({&quot;url&quot;:concat(&quot;&quot;,[&quot;http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/authz/protection/resource_set?uri=&quot;,input.context.request.http.path]),&quot;method&quot;:&quot;get&quot;,&quot;headers&quot;:{&quot;Authorization&quot;:concat(&quot; &quot;,[&quot;Bearer &quot;,pat])}}).body[0]</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="s">          scope := lower(input.context.request.http.method)</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="s">          access_token := trim_prefix(input.context.request.http.headers.authorization, &quot;Bearer &quot;)</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="s">          default rpt = &quot;&quot;</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="s">          rpt = access_token { object.get(input.auth.identity, &quot;authorization&quot;, {}).permissions }</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="s">          else = rpt_str {</span>
-</span><span id="__span-8-26"><a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="s">            ticket := http.send({&quot;url&quot;:&quot;http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/authz/protection/permission&quot;,&quot;method&quot;:&quot;post&quot;,&quot;headers&quot;:{&quot;Authorization&quot;:concat(&quot; &quot;,[&quot;Bearer &quot;,pat]),&quot;Content-Type&quot;:&quot;application/json&quot;},&quot;raw_body&quot;:concat(&quot;&quot;,[&quot;[{\&quot;resource_id\&quot;:\&quot;&quot;,resource_id,&quot;\&quot;,\&quot;resource_scopes\&quot;:[\&quot;&quot;,scope,&quot;\&quot;]}]&quot;])}).body.ticket</span>
-</span><span id="__span-8-27"><a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="s">            rpt_str := object.get(http.send({&quot;url&quot;:&quot;http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token&quot;,&quot;method&quot;:&quot;post&quot;,&quot;headers&quot;:{&quot;Authorization&quot;:concat(&quot; &quot;,[&quot;Bearer &quot;,access_token]),&quot;Content-Type&quot;:&quot;application/x-www-form-urlencoded&quot;},&quot;raw_body&quot;:concat(&quot;&quot;,[&quot;grant_type=urn:ietf:params:oauth:grant-type:uma-ticket&amp;ticket=&quot;,ticket,&quot;&amp;submit_request=true&quot;])}).body, &quot;access_token&quot;, &quot;&quot;)</span>
-</span><span id="__span-8-28"><a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a><span class="s">          }</span>
-</span><span id="__span-8-29"><a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a>
-</span><span id="__span-8-30"><a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="s">          allow {</span>
-</span><span id="__span-8-31"><a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="s">            permissions := object.get(io.jwt.decode(rpt)[1], &quot;authorization&quot;, { &quot;permissions&quot;: [] }).permissions</span>
-</span><span id="__span-8-32"><a id="__codelineno-8-32" name="__codelineno-8-32" href="#__codelineno-8-32"></a><span class="s">            permissions[i]</span>
-</span><span id="__span-8-33"><a id="__codelineno-8-33" name="__codelineno-8-33" href="#__codelineno-8-33"></a><span class="s">            permissions[i].rsid = resource_id</span>
-</span><span id="__span-8-34"><a id="__codelineno-8-34" name="__codelineno-8-34" href="#__codelineno-8-34"></a><span class="s">            permissions[i].scopes[_] = scope</span>
-</span><span id="__span-8-35"><a id="__codelineno-8-35" name="__codelineno-8-35" href="#__codelineno-8-35"></a><span class="s">          }</span>
-</span><span id="__span-8-36"><a id="__codelineno-8-36" name="__codelineno-8-36" href="#__codelineno-8-36"></a><span class="s">        allValues: true</span>
-</span><span id="__span-8-37"><a id="__codelineno-8-37" name="__codelineno-8-37" href="#__codelineno-8-37"></a><span class="s">  response:</span>
-</span><span id="__span-8-38"><a id="__codelineno-8-38" name="__codelineno-8-38" href="#__codelineno-8-38"></a><span class="s">    success:</span>
-</span><span id="__span-8-39"><a id="__codelineno-8-39" name="__codelineno-8-39" href="#__codelineno-8-39"></a><span class="s">      headers:</span>
-</span><span id="__span-8-40"><a id="__codelineno-8-40" name="__codelineno-8-40" href="#__codelineno-8-40"></a><span class="s">        &quot;x-keycloak&quot;:</span>
-</span><span id="__span-8-41"><a id="__codelineno-8-41" name="__codelineno-8-41" href="#__codelineno-8-41"></a><span class="s">          when:</span>
-</span><span id="__span-8-42"><a id="__codelineno-8-42" name="__codelineno-8-42" href="#__codelineno-8-42"></a>
-</span><span id="__span-8-43"><a id="__codelineno-8-43" name="__codelineno-8-43" href="#__codelineno-8-43"></a><span class="s">          - selector: auth.identity.authorization.permissions</span>
-</span><span id="__span-8-44"><a id="__codelineno-8-44" name="__codelineno-8-44" href="#__codelineno-8-44"></a><span class="s">            operator: eq</span>
-</span><span id="__span-8-45"><a id="__codelineno-8-45" name="__codelineno-8-45" href="#__codelineno-8-45"></a><span class="s">            value: &quot;&quot;</span>
-</span><span id="__span-8-46"><a id="__codelineno-8-46" name="__codelineno-8-46" href="#__codelineno-8-46"></a><span class="s">          json:</span>
-</span><span id="__span-8-47"><a id="__codelineno-8-47" name="__codelineno-8-47" href="#__codelineno-8-47"></a><span class="s">            properties:</span>
-</span><span id="__span-8-48"><a id="__codelineno-8-48" name="__codelineno-8-48" href="#__codelineno-8-48"></a><span class="s">              &quot;rpt&quot;:</span>
-</span><span id="__span-8-49"><a id="__codelineno-8-49" name="__codelineno-8-49" href="#__codelineno-8-49"></a><span class="s">                selector: auth.authorization.uma.rpt</span>
-</span><span id="__span-8-50"><a id="__codelineno-8-50" name="__codelineno-8-50" href="#__codelineno-8-50"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="obtain-an-access-token-with-the-keycloak-server">❻ Obtain an access token with the Keycloak server<a class="headerlink" href="#obtain-an-access-token-with-the-keycloak-server" title="Permanent link">&para;</a></h2>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster for user Jane:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>As Jane, try to send a <code>GET</code> request to the protected resource <code>/greetings/1</code>, owned by user John.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1<span class="w"> </span>-i
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<p>As John, log in to http://localhost:8080/realms/kuadrant/account in the web browser (username: <code>john</code> / password: <code>p</code>), and grant access to the resource <code>greeting-1</code> for Jane. A pending permission request by Jane shall exist in the list of John's <em>Resources</em>.</p>
-<p><img alt="Keycloak Authorization Services" src="../images/keycloak-authorization-services-1.png" />
-<img alt="Keycloak Authorization Services - pending request" src="../images/keycloak-authorization-services-2.png" />
-<img alt="Keycloak Authorization Services - approve" src="../images/keycloak-authorization-services-3.png" /></p>
-<p>As Jane, try to consume the protected resource <code>/greetings/1</code> again:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1<span class="w"> </span>-i
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="c1">#</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="c1"># {…</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="c1">#   &quot;headers&quot;: {…</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="c1">#     &quot;X-Keycloak&quot;: &quot;{\&quot;rpt\&quot;:\&quot;&lt;RPT&gt;&quot;, …</span>
-</span></code></pre></div>
-<p>Copy the RPT from the response and repeat the request now using the RPT to authenticate:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer &lt;RPT&gt;&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1<span class="w"> </span>-i
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/kubernetes-subjectaccessreview/index.html b/0.10.0/authorino/docs/user-guides/kubernetes-subjectaccessreview/index.html
deleted file mode 100644
index b8b47af8e..000000000
--- a/0.10.0/authorino/docs/user-guides/kubernetes-subjectaccessreview/index.html
+++ /dev/null
@@ -1,3884 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/kubernetes-subjectaccessreview/">
-      
-      
-        <link rel="prev" href="../opa-authorization/">
-      
-      
-        <link rel="next" href="../keycloak-authorization-services/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Kubernetes RBAC for service authorization (SubjectAccessReview API) - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-kubernetes-rbac-for-service-authorization-subjectaccessreview-api" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Kubernetes RBAC for service authorization (SubjectAccessReview API)
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-roles-associated-with-endpoints-of-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create roles associated with endpoints of the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-serviceaccounts-and-permissions-to-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Create the ServiceAccounts and permissions to consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-roles-associated-with-endpoints-of-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create roles associated with endpoints of the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-serviceaccounts-and-permissions-to-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Create the ServiceAccounts and permissions to consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/kubernetes-subjectaccessreview.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-kubernetes-rbac-for-service-authorization-subjectaccessreview-api">User guide: Kubernetes RBAC for service authorization (SubjectAccessReview API)<a class="headerlink" href="#user-guide-kubernetes-rbac-for-service-authorization-subjectaccessreview-api" title="Permanent link">&para;</a></h1>
-<p>Manage permissions in the Kubernetes RBAC and let Authorino to check them in request-time with the authorization system of the cluster.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Authorization → <a href="../features.md#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview">Kubernetes SubjectAccessReview</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#kubernetes-tokenreview-authenticationkubernetestokenreview">Kubernetes TokenReview</a></li>
-    </ul>
-  </summary>
-<p>Authorino can delegate authorization decision to the Kubernetes authorization system, allowing permissions to be stored and managed using the Kubernetes Role-Based Access Control (RBAC) for example. The feature is based on the <code>SubjectAccessReview</code> API and can be used for <code>resourceAttributes</code> (parameters defined in the <code>AuthConfig</code>) or <code>nonResourceAttributes</code> (inferring HTTP path and verb from the original request).</p>
-<p>Check out as well the user guide about <a href="../kubernetes-tokenreview/">Authentication with Kubernetes tokens (TokenReview API)</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC) and to create <code>TokenRequest</code>s (to consume the protected service from outside the cluster)</li>
-<li><a href="https://jqlang.github.io/jq/">jq</a></li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>The <code>AuthConfig</code> below sets all Kubernetes service accounts as trusted users of the API, and relies on the Kubernetes RBAC to enforce authorization using Kubernetes SubjectAccessReview API for non-resource endpoints:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  - envoy.default.svc.cluster.local</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">    &quot;service-accounts&quot;:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">      kubernetesTokenReview:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">        audiences: [&quot;https://kubernetes.default.svc.cluster.local&quot;]</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">  authorization:</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">    &quot;k8s-rbac&quot;:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">      kubernetesSubjectAccessReview:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">        user:</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">          selector: auth.identity.user.username</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check out the <a href="../../features/#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview">spec</a> for the Authorino Kubernetes SubjectAccessReview authorization feature, for resource attributes permission checks where SubjectAccessReviews issued by Authorino are modeled in terms of common attributes of operations on Kubernetes resources (namespace, API group, kind, name, subresource, verb).</p>
-<h2 id="create-roles-associated-with-endpoints-of-the-api">❻ Create roles associated with endpoints of the API<a class="headerlink" href="#create-roles-associated-with-endpoints-of-the-api" title="Permanent link">&para;</a></h2>
-<p>Because the <code>k8s-rbac</code> policy defined in the <code>AuthConfig</code> in the previous step is for non-resource access review requests, the corresponding roles and role bindings have to be defined at cluster scope.</p>
-<p>Create a <code>talker-api-greeter</code> role whose users and service accounts bound to this role can consume the non-resource endpoints <code>POST /hello</code> and <code>POST /hi</code> of the API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: ClusterRole</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: talker-api-greeter</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">rules:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">- nonResourceURLs: [&quot;/hello&quot;]</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  verbs: [&quot;post&quot;]</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">- nonResourceURLs: [&quot;/hi&quot;]</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">  verbs: [&quot;post&quot;]</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create a <code>talker-api-speaker</code> role whose users and service accounts bound to this role can consume the non-resource endpoints <code>POST /say/*</code> of the API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: ClusterRole</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: talker-api-speaker</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">rules:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">- nonResourceURLs: [&quot;/say/*&quot;]</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  verbs: [&quot;post&quot;]</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-the-serviceaccounts-and-permissions-to-consume-the-api">❼ Create the <code>ServiceAccount</code>s and permissions to consume the API<a class="headerlink" href="#create-the-serviceaccounts-and-permissions-to-consume-the-api" title="Permanent link">&para;</a></h2>
-<p>Create service accounts <code>api-consumer-1</code> and <code>api-consumer-2</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: ServiceAccount</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: api-consumer-1</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">kind: ServiceAccount</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">metadata:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">  name: api-consumer-2</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Bind both service accounts to the <code>talker-api-greeter</code> role:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="s">kind: ClusterRoleBinding</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="s">metadata:</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="s">  name: talker-api-greeter-rolebinding</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="s">roleRef:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="s">  apiGroup: rbac.authorization.k8s.io</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="s">  kind: ClusterRole</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="s">  name: talker-api-greeter</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="s">subjects:</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="s">- kind: ServiceAccount</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="s">  name: api-consumer-1</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="s">  namespace: default</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="s">- kind: ServiceAccount</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="s">  name: api-consumer-2</span>
-</span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="s">  namespace: default</span>
-</span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Bind service account <code>api-consumer-1</code> to the <code>talker-api-speaker</code> role:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: ClusterRoleBinding</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: talker-api-speaker-rolebinding</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">roleRef:</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">  apiGroup: rbac.authorization.k8s.io</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="s">  kind: ClusterRole</span>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">  name: talker-api-speaker</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">subjects:</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">- kind: ServiceAccount</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">  name: api-consumer-1</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="s">  namespace: default</span>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❽ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>Run a pod that consumes one of the greeting endpoints of the API from inside the cluster, as service account <code>api-consumer-1</code>, bound to the <code>talker-api-greeter</code> and <code>talker-api-speaker</code> cluster roles in the Kubernetes RBAC:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>run<span class="w"> </span>greeter<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>quay.io/kuadrant/authorino-examples:api-consumer<span class="w"> </span>--overrides<span class="o">=</span><span class="s1">&#39;{</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="s1">  &quot;apiVersion&quot;: &quot;v1&quot;,</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="s1">  &quot;spec&quot;: {</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="s1">    &quot;containers&quot;: [{</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="s1">      &quot;name&quot;: &quot;api-consumer&quot;, &quot;image&quot;: &quot;quay.io/kuadrant/authorino-examples:api-consumer&quot;, &quot;command&quot;: [&quot;./run&quot;],</span>
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="s1">      &quot;args&quot;:[&quot;--endpoint=http://envoy.default.svc.cluster.local:8000/hi&quot;,&quot;--method=POST&quot;,&quot;--interval=0&quot;,&quot;--token-path=/var/run/secrets/tokens/api-token&quot;],</span>
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="s1">      &quot;volumeMounts&quot;: [{&quot;mountPath&quot;: &quot;/var/run/secrets/tokens&quot;,&quot;name&quot;: &quot;access-token&quot;}]</span>
-</span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="s1">    }],</span>
-</span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="s1">    &quot;serviceAccountName&quot;: &quot;api-consumer-1&quot;,</span>
-</span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="s1">    &quot;volumes&quot;: [{&quot;name&quot;: &quot;access-token&quot;,&quot;projected&quot;: {&quot;sources&quot;: [{&quot;serviceAccountToken&quot;: {&quot;path&quot;: &quot;api-token&quot;,&quot;expirationSeconds&quot;: 7200}}]}}]</span>
-</span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="s1">  }</span>
-</span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="s1">}&#39;</span><span class="w"> </span>--<span class="w"> </span>sh
-</span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="c1"># Sending...</span>
-</span><span id="__span-13-14"><a id="__codelineno-13-14" name="__codelineno-13-14" href="#__codelineno-13-14"></a><span class="c1"># 200</span>
-</span></code></pre></div>
-<p>Run a pod that sends a <code>POST</code> request to <code>/say/blah</code> from within the cluster, as service account <code>api-consumer-1</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>run<span class="w"> </span>speaker<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>quay.io/kuadrant/authorino-examples:api-consumer<span class="w"> </span>--overrides<span class="o">=</span><span class="s1">&#39;{</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="s1">  &quot;apiVersion&quot;: &quot;v1&quot;,</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="s1">  &quot;spec&quot;: {</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="s1">    &quot;containers&quot;: [{</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="s1">      &quot;name&quot;: &quot;api-consumer&quot;, &quot;image&quot;: &quot;quay.io/kuadrant/authorino-examples:api-consumer&quot;, &quot;command&quot;: [&quot;./run&quot;],</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="s1">      &quot;args&quot;:[&quot;--endpoint=http://envoy.default.svc.cluster.local:8000/say/blah&quot;,&quot;--method=POST&quot;,&quot;--interval=0&quot;,&quot;--token-path=/var/run/secrets/tokens/api-token&quot;],</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="s1">      &quot;volumeMounts&quot;: [{&quot;mountPath&quot;: &quot;/var/run/secrets/tokens&quot;,&quot;name&quot;: &quot;access-token&quot;}]</span>
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="s1">    }],</span>
-</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="s1">    &quot;serviceAccountName&quot;: &quot;api-consumer-1&quot;,</span>
-</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="s1">    &quot;volumes&quot;: [{&quot;name&quot;: &quot;access-token&quot;,&quot;projected&quot;: {&quot;sources&quot;: [{&quot;serviceAccountToken&quot;: {&quot;path&quot;: &quot;api-token&quot;,&quot;expirationSeconds&quot;: 7200}}]}}]</span>
-</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="s1">  }</span>
-</span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="s1">}&#39;</span><span class="w"> </span>--<span class="w"> </span>sh
-</span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="c1"># Sending...</span>
-</span><span id="__span-14-14"><a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="c1"># 200</span>
-</span></code></pre></div>
-<p>Run a pod that sends a <code>POST</code> request to <code>/say/blah</code> from within the cluster, as service account <code>api-consumer-2</code>, bound only to the <code>talker-api-greeter</code> cluster role in the Kubernetes RBAC:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>run<span class="w"> </span>speaker<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>quay.io/kuadrant/authorino-examples:api-consumer<span class="w"> </span>--overrides<span class="o">=</span><span class="s1">&#39;{</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="s1">  &quot;apiVersion&quot;: &quot;v1&quot;,</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="s1">  &quot;spec&quot;: {</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="s1">    &quot;containers&quot;: [{</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="s1">      &quot;name&quot;: &quot;api-consumer&quot;, &quot;image&quot;: &quot;quay.io/kuadrant/authorino-examples:api-consumer&quot;, &quot;command&quot;: [&quot;./run&quot;],</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="s1">      &quot;args&quot;:[&quot;--endpoint=http://envoy.default.svc.cluster.local:8000/say/blah&quot;,&quot;--method=POST&quot;,&quot;--interval=0&quot;,&quot;--token-path=/var/run/secrets/tokens/api-token&quot;],</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="s1">      &quot;volumeMounts&quot;: [{&quot;mountPath&quot;: &quot;/var/run/secrets/tokens&quot;,&quot;name&quot;: &quot;access-token&quot;}]</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="s1">    }],</span>
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="s1">    &quot;serviceAccountName&quot;: &quot;api-consumer-2&quot;,</span>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="s1">    &quot;volumes&quot;: [{&quot;name&quot;: &quot;access-token&quot;,&quot;projected&quot;: {&quot;sources&quot;: [{&quot;serviceAccountToken&quot;: {&quot;path&quot;: &quot;api-token&quot;,&quot;expirationSeconds&quot;: 7200}}]}}]</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="s1">  }</span>
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="s1">}&#39;</span><span class="w"> </span>--<span class="w"> </span>sh
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="c1"># Sending...</span>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a><span class="c1"># 403</span>
-</span></code></pre></div>
-<details>
-<summary>Extra: consume the API as service account <code>api-consumer-2</code> from <i>outside</i> the cluster</summary>
-<p><br/></p>
-<p>Obtain a short-lived access token for service account <code>api-consumer-2</code>, bound to the <code>talker-api-greeter</code> cluster role in the Kubernetes RBAC, using the Kubernetes TokenRequest API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span><span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;{ &quot;apiVersion&quot;: &quot;authentication.k8s.io/v1&quot;, &quot;kind&quot;: &quot;TokenRequest&quot;, &quot;spec&quot;: { &quot;expirationSeconds&quot;: 600 } }&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>create<span class="w"> </span>--raw<span class="w"> </span>/api/v1/namespaces/default/serviceaccounts/api-consumer-2/token<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.status.token<span class="k">)</span>
-</span></code></pre></div>
-<p>Consume the API as <code>api-consumer-2</code> from outside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/say/something<span class="w"> </span>-i
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-</details>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>serviceaccount/api-consumer-1
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>serviceaccount/api-consumer-2
-</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>clusterrolebinding/talker-api-greeter-rolebinding
-</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>clusterrolebinding/talker-api-speaker-rolebinding
-</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>clusterrole/talker-api-greeter
-</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>clusterrole/talker-api-speaker
-</span><span id="__span-20-7"><a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-20-8"><a id="__codelineno-20-8" name="__codelineno-20-8" href="#__codelineno-20-8"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-20-9"><a id="__codelineno-20-9" name="__codelineno-20-9" href="#__codelineno-20-9"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-20-10"><a id="__codelineno-20-10" name="__codelineno-20-10" href="#__codelineno-20-10"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/kubernetes-tokenreview/index.html b/0.10.0/authorino/docs/user-guides/kubernetes-tokenreview/index.html
deleted file mode 100644
index f460e6c3a..000000000
--- a/0.10.0/authorino/docs/user-guides/kubernetes-tokenreview/index.html
+++ /dev/null
@@ -1,3824 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/kubernetes-tokenreview/">
-      
-      
-        <link rel="prev" href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/">
-      
-      
-        <link rel="next" href="../api-key-authentication/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Authentication with Kubernetes tokens (TokenReview API) - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-authentication-with-kubernetes-tokens-tokenreview-api" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Authentication with Kubernetes tokens (TokenReview API)
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api-protected-by-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Consume the API protected by Authorino
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Consume the API protected by Authorino">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#create-a-serviceaccount" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create a ServiceAccount
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-api-from-outside-the-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the API from outside the cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-api-from-inside-the-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the API from inside the cluster
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api-protected-by-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Consume the API protected by Authorino
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Consume the API protected by Authorino">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#create-a-serviceaccount" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create a ServiceAccount
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-api-from-outside-the-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the API from outside the cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-api-from-inside-the-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the API from inside the cluster
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/kubernetes-tokenreview.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-authentication-with-kubernetes-tokens-tokenreview-api">User guide: Authentication with Kubernetes tokens (TokenReview API)<a class="headerlink" href="#user-guide-authentication-with-kubernetes-tokens-tokenreview-api" title="Permanent link">&para;</a></h1>
-<p>Validate Kubernetes Service Account tokens to authenticate requests to your protected hosts.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#kubernetes-tokenreview-authenticationkubernetestokenreview">Kubernetes TokenReview</a></li>
-    </ul>
-  </summary>
-<p>Authorino can verify Kubernetes-valid access tokens (using Kubernetes <a href="https://kubernetes.io/docs/reference/kubernetes-api/authentication-resources/token-review-v1">TokenReview</a> API).</p>
-<p>These tokens can be either <code>ServiceAccount</code> tokens or any valid user access tokens issued to users of the Kubernetes server API.</p>
-<p>The <code>audiences</code> claim of the token must include the requested host and port of the protected API (default), or all audiences specified in <code>spec.identity.kubernetes.audiences</code> of the <code>AuthConfig</code>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC) and to create <code>TokenRequest</code>s (to consume the protected service from outside the cluster)</li>
-<li><a href="https://jqlang.github.io/jq/">jq</a></li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  - envoy.default.svc.cluster.local</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">    &quot;authorized-service-accounts&quot;:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">      kubernetesTokenReview:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">        audiences:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">        - talker-api</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api-protected-by-authorino">❻ Consume the API protected by Authorino<a class="headerlink" href="#consume-the-api-protected-by-authorino" title="Permanent link">&para;</a></h2>
-<h3 id="create-a-serviceaccount">Create a <code>ServiceAccount</code><a class="headerlink" href="#create-a-serviceaccount" title="Permanent link">&para;</a></h3>
-<p>Create a Kubernetes <code>ServiceAccount</code> to identify the consumer application that will send requests to the protected API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: ServiceAccount</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: api-consumer-1</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="consume-the-api-from-outside-the-cluster">Consume the API from outside the cluster<a class="headerlink" href="#consume-the-api-from-outside-the-cluster" title="Permanent link">&para;</a></h3>
-<p>Obtain a short-lived access token for the <code>api-consumer-1</code> service account:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span><span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;{ &quot;apiVersion&quot;: &quot;authentication.k8s.io/v1&quot;, &quot;kind&quot;: &quot;TokenRequest&quot;, &quot;spec&quot;: { &quot;audiences&quot;: [&quot;talker-api&quot;], &quot;expirationSeconds&quot;: 600 } }&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>create<span class="w"> </span>--raw<span class="w"> </span>/api/v1/namespaces/default/serviceaccounts/api-consumer-1/token<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.status.token<span class="k">)</span>
-</span></code></pre></div>
-<p>Consume the API with a valid Kubernetes token:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Consume the API with the Kubernetes token expired (10 minutes):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="c1"># www-authenticate: Bearer realm=&quot;authorized-service-accounts&quot;</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># x-ext-auth-reason: Not authenticated</span>
-</span></code></pre></div>
-<h3 id="consume-the-api-from-inside-the-cluster">Consume the API from inside the cluster<a class="headerlink" href="#consume-the-api-from-inside-the-cluster" title="Permanent link">&para;</a></h3>
-<p>Deploy an application that consumes an endpoint of the Talker API, in a loop, every 10 seconds. The application uses a short-lived service account token mounted inside the container using Kubernetes <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection">Service Account Token Volume Projection</a> to authenticate.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="s">kind: Pod</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="s">metadata:</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="s">  name: api-consumer</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="s">spec:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="s">  containers:</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="s">  - name: api-consumer</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="s">    image: quay.io/kuadrant/authorino-examples:api-consumer</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="s">    command: [&quot;./run&quot;]</span>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="s">    args:</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="s">      - --endpoint=http://envoy.default.svc.cluster.local:8000/hello</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="s">      - --token-path=/var/run/secrets/tokens/api-token</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="s">      - --interval=10</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="s">    volumeMounts:</span>
-</span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="s">    - mountPath: /var/run/secrets/tokens</span>
-</span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="s">      name: talker-api-access-token</span>
-</span><span id="__span-11-19"><a id="__codelineno-11-19" name="__codelineno-11-19" href="#__codelineno-11-19"></a><span class="s">  serviceAccountName: api-consumer-1</span>
-</span><span id="__span-11-20"><a id="__codelineno-11-20" name="__codelineno-11-20" href="#__codelineno-11-20"></a><span class="s">  volumes:</span>
-</span><span id="__span-11-21"><a id="__codelineno-11-21" name="__codelineno-11-21" href="#__codelineno-11-21"></a><span class="s">  - name: talker-api-access-token</span>
-</span><span id="__span-11-22"><a id="__codelineno-11-22" name="__codelineno-11-22" href="#__codelineno-11-22"></a><span class="s">    projected:</span>
-</span><span id="__span-11-23"><a id="__codelineno-11-23" name="__codelineno-11-23" href="#__codelineno-11-23"></a><span class="s">      sources:</span>
-</span><span id="__span-11-24"><a id="__codelineno-11-24" name="__codelineno-11-24" href="#__codelineno-11-24"></a><span class="s">      - serviceAccountToken:</span>
-</span><span id="__span-11-25"><a id="__codelineno-11-25" name="__codelineno-11-25" href="#__codelineno-11-25"></a><span class="s">          path: api-token</span>
-</span><span id="__span-11-26"><a id="__codelineno-11-26" name="__codelineno-11-26" href="#__codelineno-11-26"></a><span class="s">          expirationSeconds: 7200</span>
-</span><span id="__span-11-27"><a id="__codelineno-11-27" name="__codelineno-11-27" href="#__codelineno-11-27"></a><span class="s">          audience: talker-api</span>
-</span><span id="__span-11-28"><a id="__codelineno-11-28" name="__codelineno-11-28" href="#__codelineno-11-28"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check the logs of <code>api-consumer</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>logs<span class="w"> </span>-f<span class="w"> </span>api-consumer
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># Sending...</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="c1"># 200</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="c1"># 200</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="c1"># 200</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="c1"># 200</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="c1"># ...</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>pod/api-consumer
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>serviceaccount/api-consumer-1
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/mtls-authentication/index.html b/0.10.0/authorino/docs/user-guides/mtls-authentication/index.html
deleted file mode 100644
index de8b94ab8..000000000
--- a/0.10.0/authorino/docs/user-guides/mtls-authentication/index.html
+++ /dev/null
@@ -1,4007 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/mtls-authentication/">
-      
-      
-        <link rel="prev" href="../api-key-authentication/">
-      
-      
-        <link rel="next" href="../oidc-jwt-authentication/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Authentication with X.509 certificates and mTLS - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-authentication-with-x509-certificates-and-mutual-transport-layer-security-mtls" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Authentication with X.509 certificates and mTLS
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-a-ca" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Create a CA
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create the AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#try-the-authconfig-via-raw-http-authorization-interface" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Try the AuthConfig via raw HTTP authorization interface
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#revoke-an-entire-chain-of-certificates" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❾ Revoke an entire chain of certificates
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-a-ca" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Create a CA
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create the AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#try-the-authconfig-via-raw-http-authorization-interface" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Try the AuthConfig via raw HTTP authorization interface
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#revoke-an-entire-chain-of-certificates" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❾ Revoke an entire chain of certificates
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/mtls-authentication.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-authentication-with-x509-certificates-and-mutual-transport-layer-security-mtls">User guide: Authentication with X.509 certificates and Mutual Transport Layer Security (mTLS)<a class="headerlink" href="#user-guide-authentication-with-x509-certificates-and-mutual-transport-layer-security-mtls" title="Permanent link">&para;</a></h1>
-<p>Verify client X.509 certificates against trusted root CAs stored in Kubernetes <code>Secret</code>s to authenticate access to APIs protected with Authorino.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#x509-client-certificate-authentication-authenticationx509">X.509 client certificate authentication</a></li>
-      <li>Authorization → <a href="../features.md#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization</a></li>
-    </ul>
-  </summary>
-<p>Authorino can verify x509 certificates presented by clients for authentication on the request to the protected APIs, at application level.</p>
-<p>Trusted root Certificate Authorities (CA) are stored as Kubernetes <code>kubernetes.io/tls</code> Secrets labeled according to selectors specified in the AuthConfig, watched and cached by Authorino.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❻.</p>
-        <p>At step ❻, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following commands will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS enabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<p>Create the TLS certificates for the Authorino service:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sSL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino/main/deploy/certs.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span><span class="s2">&quot;s/\$(AUTHORINO_INSTANCE)/authorino/g;s/\$(NAMESPACE)/default/g&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div>
-<p>Request the Authorino instance:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  listener:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    tls:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">      certSecretRef:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">        name: authorino-server-cert</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">    tls:</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">      certSecretRef:</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="s">        name: authorino-oidc-server-cert</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="create-a-ca">❹ Create a CA<a class="headerlink" href="#create-a-ca" title="Permanent link">&para;</a></h2>
-<p>Create a CA (Certificate Authority) certificate to issue the client certificates that will be used to authenticate clients that send requests to the Talker API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>openssl<span class="w"> </span>req<span class="w"> </span>-x509<span class="w"> </span>-sha512<span class="w"> </span>-nodes<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="w">  </span>-days<span class="w"> </span><span class="m">365</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="w">  </span>-newkey<span class="w"> </span>rsa:4096<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">  </span>-subj<span class="w"> </span><span class="s2">&quot;/CN=talker-api-ca&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">  </span>-addext<span class="w"> </span><span class="nv">basicConstraints</span><span class="o">=</span>CA:TRUE<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w">  </span>-addext<span class="w"> </span><span class="nv">keyUsage</span><span class="o">=</span>digitalSignature,keyCertSign<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="w">  </span>-keyout<span class="w"> </span>/tmp/ca.key<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="w">  </span>-out<span class="w"> </span>/tmp/ca.crt
-</span></code></pre></div>
-<p>Store the CA cert in a Kubernetes <code>Secret</code>, labeled to be discovered by Authorino and to be mounted in the file system of the Envoy container:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>tls<span class="w"> </span>talker-api-ca<span class="w"> </span>--cert<span class="o">=</span>/tmp/ca.crt<span class="w"> </span>--key<span class="o">=</span>/tmp/ca.key
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>kubectl<span class="w"> </span>label<span class="w"> </span>secret<span class="w"> </span>talker-api-ca<span class="w"> </span>authorino.kuadrant.io/managed-by<span class="o">=</span>authorino<span class="w"> </span><span class="nv">app</span><span class="o">=</span>talker-api
-</span></code></pre></div>
-<p>Prepare an extension file for the client certificate signing requests:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>cat<span class="w"> </span>&gt;<span class="w"> </span>/tmp/x509v3.ext<span class="w"> </span><span class="s">&lt;&lt; EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">authorityKeyIdentifier=keyid,issuer</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">basicConstraints=CA:FALSE</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">keyUsage=digitalSignature,nonRepudiation,keyEncipherment,dataEncipherment</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">extendedKeyUsage=clientAuth</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="setup-envoy">❺ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following command deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: ConfigMap</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  labels:</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">    app: envoy</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">  name: envoy</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">data:</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  envoy.yaml: |</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">    static_resources:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">      listeners:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">      - address:</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">          socket_address:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">            address: 0.0.0.0</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">            port_value: 8443</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">        filter_chains:</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">        - transport_socket:</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">            name: envoy.transport_sockets.tls</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="s">            typed_config:</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="s">              &quot;@type&quot;: type.googleapis.com/envoy.extensions.transport_sockets.tls.v3.DownstreamTlsContext</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="s">              common_tls_context:</span>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="s">                tls_certificates:</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="s">                - certificate_chain: {filename: &quot;/etc/ssl/certs/talker-api/tls.crt&quot;}</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="s">                  private_key: {filename: &quot;/etc/ssl/certs/talker-api/tls.key&quot;}</span>
-</span><span id="__span-8-26"><a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="s">                validation_context:</span>
-</span><span id="__span-8-27"><a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="s">                  trusted_ca:</span>
-</span><span id="__span-8-28"><a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a><span class="s">                    filename: /etc/ssl/certs/talker-api/tls.crt</span>
-</span><span id="__span-8-29"><a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a><span class="s">          filters:</span>
-</span><span id="__span-8-30"><a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="s">          - name: envoy.http_connection_manager</span>
-</span><span id="__span-8-31"><a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="s">            typed_config:</span>
-</span><span id="__span-8-32"><a id="__codelineno-8-32" name="__codelineno-8-32" href="#__codelineno-8-32"></a><span class="s">              &quot;@type&quot;: type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager</span>
-</span><span id="__span-8-33"><a id="__codelineno-8-33" name="__codelineno-8-33" href="#__codelineno-8-33"></a><span class="s">              stat_prefix: local</span>
-</span><span id="__span-8-34"><a id="__codelineno-8-34" name="__codelineno-8-34" href="#__codelineno-8-34"></a><span class="s">              route_config:</span>
-</span><span id="__span-8-35"><a id="__codelineno-8-35" name="__codelineno-8-35" href="#__codelineno-8-35"></a><span class="s">                name: local_route</span>
-</span><span id="__span-8-36"><a id="__codelineno-8-36" name="__codelineno-8-36" href="#__codelineno-8-36"></a><span class="s">                virtual_hosts:</span>
-</span><span id="__span-8-37"><a id="__codelineno-8-37" name="__codelineno-8-37" href="#__codelineno-8-37"></a><span class="s">                - name: local_service</span>
-</span><span id="__span-8-38"><a id="__codelineno-8-38" name="__codelineno-8-38" href="#__codelineno-8-38"></a><span class="s">                  domains: [&#39;*&#39;]</span>
-</span><span id="__span-8-39"><a id="__codelineno-8-39" name="__codelineno-8-39" href="#__codelineno-8-39"></a><span class="s">                  routes:</span>
-</span><span id="__span-8-40"><a id="__codelineno-8-40" name="__codelineno-8-40" href="#__codelineno-8-40"></a><span class="s">                  - match: { prefix: / }</span>
-</span><span id="__span-8-41"><a id="__codelineno-8-41" name="__codelineno-8-41" href="#__codelineno-8-41"></a><span class="s">                    route: { cluster: talker-api }</span>
-</span><span id="__span-8-42"><a id="__codelineno-8-42" name="__codelineno-8-42" href="#__codelineno-8-42"></a><span class="s">              http_filters:</span>
-</span><span id="__span-8-43"><a id="__codelineno-8-43" name="__codelineno-8-43" href="#__codelineno-8-43"></a><span class="s">              - name: envoy.filters.http.ext_authz</span>
-</span><span id="__span-8-44"><a id="__codelineno-8-44" name="__codelineno-8-44" href="#__codelineno-8-44"></a><span class="s">                typed_config:</span>
-</span><span id="__span-8-45"><a id="__codelineno-8-45" name="__codelineno-8-45" href="#__codelineno-8-45"></a><span class="s">                  &quot;@type&quot;: type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthz</span>
-</span><span id="__span-8-46"><a id="__codelineno-8-46" name="__codelineno-8-46" href="#__codelineno-8-46"></a><span class="s">                  transport_api_version: V3</span>
-</span><span id="__span-8-47"><a id="__codelineno-8-47" name="__codelineno-8-47" href="#__codelineno-8-47"></a><span class="s">                  failure_mode_allow: false</span>
-</span><span id="__span-8-48"><a id="__codelineno-8-48" name="__codelineno-8-48" href="#__codelineno-8-48"></a><span class="s">                  include_peer_certificate: true</span>
-</span><span id="__span-8-49"><a id="__codelineno-8-49" name="__codelineno-8-49" href="#__codelineno-8-49"></a><span class="s">                  grpc_service:</span>
-</span><span id="__span-8-50"><a id="__codelineno-8-50" name="__codelineno-8-50" href="#__codelineno-8-50"></a><span class="s">                    envoy_grpc: { cluster_name: authorino }</span>
-</span><span id="__span-8-51"><a id="__codelineno-8-51" name="__codelineno-8-51" href="#__codelineno-8-51"></a><span class="s">                    timeout: 1s</span>
-</span><span id="__span-8-52"><a id="__codelineno-8-52" name="__codelineno-8-52" href="#__codelineno-8-52"></a><span class="s">              - name: envoy.filters.http.router</span>
-</span><span id="__span-8-53"><a id="__codelineno-8-53" name="__codelineno-8-53" href="#__codelineno-8-53"></a><span class="s">                typed_config: {}</span>
-</span><span id="__span-8-54"><a id="__codelineno-8-54" name="__codelineno-8-54" href="#__codelineno-8-54"></a><span class="s">              use_remote_address: true</span>
-</span><span id="__span-8-55"><a id="__codelineno-8-55" name="__codelineno-8-55" href="#__codelineno-8-55"></a><span class="s">      clusters:</span>
-</span><span id="__span-8-56"><a id="__codelineno-8-56" name="__codelineno-8-56" href="#__codelineno-8-56"></a><span class="s">      - name: authorino</span>
-</span><span id="__span-8-57"><a id="__codelineno-8-57" name="__codelineno-8-57" href="#__codelineno-8-57"></a><span class="s">        connect_timeout: 0.25s</span>
-</span><span id="__span-8-58"><a id="__codelineno-8-58" name="__codelineno-8-58" href="#__codelineno-8-58"></a><span class="s">        type: strict_dns</span>
-</span><span id="__span-8-59"><a id="__codelineno-8-59" name="__codelineno-8-59" href="#__codelineno-8-59"></a><span class="s">        lb_policy: round_robin</span>
-</span><span id="__span-8-60"><a id="__codelineno-8-60" name="__codelineno-8-60" href="#__codelineno-8-60"></a><span class="s">        http2_protocol_options: {}</span>
-</span><span id="__span-8-61"><a id="__codelineno-8-61" name="__codelineno-8-61" href="#__codelineno-8-61"></a><span class="s">        load_assignment:</span>
-</span><span id="__span-8-62"><a id="__codelineno-8-62" name="__codelineno-8-62" href="#__codelineno-8-62"></a><span class="s">          cluster_name: authorino</span>
-</span><span id="__span-8-63"><a id="__codelineno-8-63" name="__codelineno-8-63" href="#__codelineno-8-63"></a><span class="s">          endpoints:</span>
-</span><span id="__span-8-64"><a id="__codelineno-8-64" name="__codelineno-8-64" href="#__codelineno-8-64"></a><span class="s">          - lb_endpoints:</span>
-</span><span id="__span-8-65"><a id="__codelineno-8-65" name="__codelineno-8-65" href="#__codelineno-8-65"></a><span class="s">            - endpoint:</span>
-</span><span id="__span-8-66"><a id="__codelineno-8-66" name="__codelineno-8-66" href="#__codelineno-8-66"></a><span class="s">                address:</span>
-</span><span id="__span-8-67"><a id="__codelineno-8-67" name="__codelineno-8-67" href="#__codelineno-8-67"></a><span class="s">                  socket_address:</span>
-</span><span id="__span-8-68"><a id="__codelineno-8-68" name="__codelineno-8-68" href="#__codelineno-8-68"></a><span class="s">                    address: authorino-authorino-authorization</span>
-</span><span id="__span-8-69"><a id="__codelineno-8-69" name="__codelineno-8-69" href="#__codelineno-8-69"></a><span class="s">                    port_value: 50051</span>
-</span><span id="__span-8-70"><a id="__codelineno-8-70" name="__codelineno-8-70" href="#__codelineno-8-70"></a><span class="s">        transport_socket:</span>
-</span><span id="__span-8-71"><a id="__codelineno-8-71" name="__codelineno-8-71" href="#__codelineno-8-71"></a><span class="s">          name: envoy.transport_sockets.tls</span>
-</span><span id="__span-8-72"><a id="__codelineno-8-72" name="__codelineno-8-72" href="#__codelineno-8-72"></a><span class="s">          typed_config:</span>
-</span><span id="__span-8-73"><a id="__codelineno-8-73" name="__codelineno-8-73" href="#__codelineno-8-73"></a><span class="s">            &quot;@type&quot;: type.googleapis.com/envoy.extensions.transport_sockets.tls.v3.UpstreamTlsContext</span>
-</span><span id="__span-8-74"><a id="__codelineno-8-74" name="__codelineno-8-74" href="#__codelineno-8-74"></a><span class="s">            common_tls_context:</span>
-</span><span id="__span-8-75"><a id="__codelineno-8-75" name="__codelineno-8-75" href="#__codelineno-8-75"></a><span class="s">              validation_context:</span>
-</span><span id="__span-8-76"><a id="__codelineno-8-76" name="__codelineno-8-76" href="#__codelineno-8-76"></a><span class="s">                trusted_ca:</span>
-</span><span id="__span-8-77"><a id="__codelineno-8-77" name="__codelineno-8-77" href="#__codelineno-8-77"></a><span class="s">                  filename: /etc/ssl/certs/authorino-ca-cert.crt</span>
-</span><span id="__span-8-78"><a id="__codelineno-8-78" name="__codelineno-8-78" href="#__codelineno-8-78"></a><span class="s">      - name: talker-api</span>
-</span><span id="__span-8-79"><a id="__codelineno-8-79" name="__codelineno-8-79" href="#__codelineno-8-79"></a><span class="s">        connect_timeout: 0.25s</span>
-</span><span id="__span-8-80"><a id="__codelineno-8-80" name="__codelineno-8-80" href="#__codelineno-8-80"></a><span class="s">        type: strict_dns</span>
-</span><span id="__span-8-81"><a id="__codelineno-8-81" name="__codelineno-8-81" href="#__codelineno-8-81"></a><span class="s">        lb_policy: round_robin</span>
-</span><span id="__span-8-82"><a id="__codelineno-8-82" name="__codelineno-8-82" href="#__codelineno-8-82"></a><span class="s">        load_assignment:</span>
-</span><span id="__span-8-83"><a id="__codelineno-8-83" name="__codelineno-8-83" href="#__codelineno-8-83"></a><span class="s">          cluster_name: talker-api</span>
-</span><span id="__span-8-84"><a id="__codelineno-8-84" name="__codelineno-8-84" href="#__codelineno-8-84"></a><span class="s">          endpoints:</span>
-</span><span id="__span-8-85"><a id="__codelineno-8-85" name="__codelineno-8-85" href="#__codelineno-8-85"></a><span class="s">          - lb_endpoints:</span>
-</span><span id="__span-8-86"><a id="__codelineno-8-86" name="__codelineno-8-86" href="#__codelineno-8-86"></a><span class="s">            - endpoint:</span>
-</span><span id="__span-8-87"><a id="__codelineno-8-87" name="__codelineno-8-87" href="#__codelineno-8-87"></a><span class="s">                address:</span>
-</span><span id="__span-8-88"><a id="__codelineno-8-88" name="__codelineno-8-88" href="#__codelineno-8-88"></a><span class="s">                  socket_address:</span>
-</span><span id="__span-8-89"><a id="__codelineno-8-89" name="__codelineno-8-89" href="#__codelineno-8-89"></a><span class="s">                    address: talker-api</span>
-</span><span id="__span-8-90"><a id="__codelineno-8-90" name="__codelineno-8-90" href="#__codelineno-8-90"></a><span class="s">                    port_value: 3000</span>
-</span><span id="__span-8-91"><a id="__codelineno-8-91" name="__codelineno-8-91" href="#__codelineno-8-91"></a><span class="s">    admin:</span>
-</span><span id="__span-8-92"><a id="__codelineno-8-92" name="__codelineno-8-92" href="#__codelineno-8-92"></a><span class="s">      access_log_path: &quot;/tmp/admin_access.log&quot;</span>
-</span><span id="__span-8-93"><a id="__codelineno-8-93" name="__codelineno-8-93" href="#__codelineno-8-93"></a><span class="s">      address:</span>
-</span><span id="__span-8-94"><a id="__codelineno-8-94" name="__codelineno-8-94" href="#__codelineno-8-94"></a><span class="s">        socket_address:</span>
-</span><span id="__span-8-95"><a id="__codelineno-8-95" name="__codelineno-8-95" href="#__codelineno-8-95"></a><span class="s">          address: 0.0.0.0</span>
-</span><span id="__span-8-96"><a id="__codelineno-8-96" name="__codelineno-8-96" href="#__codelineno-8-96"></a><span class="s">          port_value: 8001</span>
-</span><span id="__span-8-97"><a id="__codelineno-8-97" name="__codelineno-8-97" href="#__codelineno-8-97"></a><span class="s">---</span>
-</span><span id="__span-8-98"><a id="__codelineno-8-98" name="__codelineno-8-98" href="#__codelineno-8-98"></a><span class="s">apiVersion: apps/v1</span>
-</span><span id="__span-8-99"><a id="__codelineno-8-99" name="__codelineno-8-99" href="#__codelineno-8-99"></a><span class="s">kind: Deployment</span>
-</span><span id="__span-8-100"><a id="__codelineno-8-100" name="__codelineno-8-100" href="#__codelineno-8-100"></a><span class="s">metadata:</span>
-</span><span id="__span-8-101"><a id="__codelineno-8-101" name="__codelineno-8-101" href="#__codelineno-8-101"></a><span class="s">  labels:</span>
-</span><span id="__span-8-102"><a id="__codelineno-8-102" name="__codelineno-8-102" href="#__codelineno-8-102"></a><span class="s">    app: envoy</span>
-</span><span id="__span-8-103"><a id="__codelineno-8-103" name="__codelineno-8-103" href="#__codelineno-8-103"></a><span class="s">  name: envoy</span>
-</span><span id="__span-8-104"><a id="__codelineno-8-104" name="__codelineno-8-104" href="#__codelineno-8-104"></a><span class="s">spec:</span>
-</span><span id="__span-8-105"><a id="__codelineno-8-105" name="__codelineno-8-105" href="#__codelineno-8-105"></a><span class="s">  selector:</span>
-</span><span id="__span-8-106"><a id="__codelineno-8-106" name="__codelineno-8-106" href="#__codelineno-8-106"></a><span class="s">    matchLabels:</span>
-</span><span id="__span-8-107"><a id="__codelineno-8-107" name="__codelineno-8-107" href="#__codelineno-8-107"></a><span class="s">      app: envoy</span>
-</span><span id="__span-8-108"><a id="__codelineno-8-108" name="__codelineno-8-108" href="#__codelineno-8-108"></a><span class="s">  template:</span>
-</span><span id="__span-8-109"><a id="__codelineno-8-109" name="__codelineno-8-109" href="#__codelineno-8-109"></a><span class="s">    metadata:</span>
-</span><span id="__span-8-110"><a id="__codelineno-8-110" name="__codelineno-8-110" href="#__codelineno-8-110"></a><span class="s">      labels:</span>
-</span><span id="__span-8-111"><a id="__codelineno-8-111" name="__codelineno-8-111" href="#__codelineno-8-111"></a><span class="s">        app: envoy</span>
-</span><span id="__span-8-112"><a id="__codelineno-8-112" name="__codelineno-8-112" href="#__codelineno-8-112"></a><span class="s">    spec:</span>
-</span><span id="__span-8-113"><a id="__codelineno-8-113" name="__codelineno-8-113" href="#__codelineno-8-113"></a><span class="s">      containers:</span>
-</span><span id="__span-8-114"><a id="__codelineno-8-114" name="__codelineno-8-114" href="#__codelineno-8-114"></a><span class="s">      - args:</span>
-</span><span id="__span-8-115"><a id="__codelineno-8-115" name="__codelineno-8-115" href="#__codelineno-8-115"></a><span class="s">        - --config-path /usr/local/etc/envoy/envoy.yaml</span>
-</span><span id="__span-8-116"><a id="__codelineno-8-116" name="__codelineno-8-116" href="#__codelineno-8-116"></a><span class="s">        - --service-cluster front-proxy</span>
-</span><span id="__span-8-117"><a id="__codelineno-8-117" name="__codelineno-8-117" href="#__codelineno-8-117"></a><span class="s">        - --log-level info</span>
-</span><span id="__span-8-118"><a id="__codelineno-8-118" name="__codelineno-8-118" href="#__codelineno-8-118"></a><span class="s">        - --component-log-level filter:trace,http:debug,router:debug</span>
-</span><span id="__span-8-119"><a id="__codelineno-8-119" name="__codelineno-8-119" href="#__codelineno-8-119"></a><span class="s">        command:</span>
-</span><span id="__span-8-120"><a id="__codelineno-8-120" name="__codelineno-8-120" href="#__codelineno-8-120"></a><span class="s">        - /usr/local/bin/envoy</span>
-</span><span id="__span-8-121"><a id="__codelineno-8-121" name="__codelineno-8-121" href="#__codelineno-8-121"></a><span class="s">        image: envoyproxy/envoy:v1.19-latest</span>
-</span><span id="__span-8-122"><a id="__codelineno-8-122" name="__codelineno-8-122" href="#__codelineno-8-122"></a><span class="s">        name: envoy</span>
-</span><span id="__span-8-123"><a id="__codelineno-8-123" name="__codelineno-8-123" href="#__codelineno-8-123"></a><span class="s">        ports:</span>
-</span><span id="__span-8-124"><a id="__codelineno-8-124" name="__codelineno-8-124" href="#__codelineno-8-124"></a><span class="s">        - containerPort: 8443</span>
-</span><span id="__span-8-125"><a id="__codelineno-8-125" name="__codelineno-8-125" href="#__codelineno-8-125"></a><span class="s">          name: web</span>
-</span><span id="__span-8-126"><a id="__codelineno-8-126" name="__codelineno-8-126" href="#__codelineno-8-126"></a><span class="s">        - containerPort: 8001</span>
-</span><span id="__span-8-127"><a id="__codelineno-8-127" name="__codelineno-8-127" href="#__codelineno-8-127"></a><span class="s">          name: admin</span>
-</span><span id="__span-8-128"><a id="__codelineno-8-128" name="__codelineno-8-128" href="#__codelineno-8-128"></a><span class="s">        volumeMounts:</span>
-</span><span id="__span-8-129"><a id="__codelineno-8-129" name="__codelineno-8-129" href="#__codelineno-8-129"></a><span class="s">        - mountPath: /usr/local/etc/envoy</span>
-</span><span id="__span-8-130"><a id="__codelineno-8-130" name="__codelineno-8-130" href="#__codelineno-8-130"></a><span class="s">          name: config</span>
-</span><span id="__span-8-131"><a id="__codelineno-8-131" name="__codelineno-8-131" href="#__codelineno-8-131"></a><span class="s">          readOnly: true</span>
-</span><span id="__span-8-132"><a id="__codelineno-8-132" name="__codelineno-8-132" href="#__codelineno-8-132"></a><span class="s">        - mountPath: /etc/ssl/certs/authorino-ca-cert.crt</span>
-</span><span id="__span-8-133"><a id="__codelineno-8-133" name="__codelineno-8-133" href="#__codelineno-8-133"></a><span class="s">          name: authorino-ca-cert</span>
-</span><span id="__span-8-134"><a id="__codelineno-8-134" name="__codelineno-8-134" href="#__codelineno-8-134"></a><span class="s">          readOnly: true</span>
-</span><span id="__span-8-135"><a id="__codelineno-8-135" name="__codelineno-8-135" href="#__codelineno-8-135"></a><span class="s">          subPath: ca.crt</span>
-</span><span id="__span-8-136"><a id="__codelineno-8-136" name="__codelineno-8-136" href="#__codelineno-8-136"></a><span class="s">        - mountPath: /etc/ssl/certs/talker-api</span>
-</span><span id="__span-8-137"><a id="__codelineno-8-137" name="__codelineno-8-137" href="#__codelineno-8-137"></a><span class="s">          name: talker-api-ca</span>
-</span><span id="__span-8-138"><a id="__codelineno-8-138" name="__codelineno-8-138" href="#__codelineno-8-138"></a><span class="s">          readOnly: true</span>
-</span><span id="__span-8-139"><a id="__codelineno-8-139" name="__codelineno-8-139" href="#__codelineno-8-139"></a><span class="s">      volumes:</span>
-</span><span id="__span-8-140"><a id="__codelineno-8-140" name="__codelineno-8-140" href="#__codelineno-8-140"></a><span class="s">      - configMap:</span>
-</span><span id="__span-8-141"><a id="__codelineno-8-141" name="__codelineno-8-141" href="#__codelineno-8-141"></a><span class="s">          items:</span>
-</span><span id="__span-8-142"><a id="__codelineno-8-142" name="__codelineno-8-142" href="#__codelineno-8-142"></a><span class="s">          - key: envoy.yaml</span>
-</span><span id="__span-8-143"><a id="__codelineno-8-143" name="__codelineno-8-143" href="#__codelineno-8-143"></a><span class="s">            path: envoy.yaml</span>
-</span><span id="__span-8-144"><a id="__codelineno-8-144" name="__codelineno-8-144" href="#__codelineno-8-144"></a><span class="s">          name: envoy</span>
-</span><span id="__span-8-145"><a id="__codelineno-8-145" name="__codelineno-8-145" href="#__codelineno-8-145"></a><span class="s">        name: config</span>
-</span><span id="__span-8-146"><a id="__codelineno-8-146" name="__codelineno-8-146" href="#__codelineno-8-146"></a><span class="s">      - name: authorino-ca-cert</span>
-</span><span id="__span-8-147"><a id="__codelineno-8-147" name="__codelineno-8-147" href="#__codelineno-8-147"></a><span class="s">        secret:</span>
-</span><span id="__span-8-148"><a id="__codelineno-8-148" name="__codelineno-8-148" href="#__codelineno-8-148"></a><span class="s">          defaultMode: 420</span>
-</span><span id="__span-8-149"><a id="__codelineno-8-149" name="__codelineno-8-149" href="#__codelineno-8-149"></a><span class="s">          secretName: authorino-ca-cert</span>
-</span><span id="__span-8-150"><a id="__codelineno-8-150" name="__codelineno-8-150" href="#__codelineno-8-150"></a><span class="s">      - name: talker-api-ca</span>
-</span><span id="__span-8-151"><a id="__codelineno-8-151" name="__codelineno-8-151" href="#__codelineno-8-151"></a><span class="s">        secret:</span>
-</span><span id="__span-8-152"><a id="__codelineno-8-152" name="__codelineno-8-152" href="#__codelineno-8-152"></a><span class="s">          defaultMode: 420</span>
-</span><span id="__span-8-153"><a id="__codelineno-8-153" name="__codelineno-8-153" href="#__codelineno-8-153"></a><span class="s">          secretName: talker-api-ca</span>
-</span><span id="__span-8-154"><a id="__codelineno-8-154" name="__codelineno-8-154" href="#__codelineno-8-154"></a><span class="s">---</span>
-</span><span id="__span-8-155"><a id="__codelineno-8-155" name="__codelineno-8-155" href="#__codelineno-8-155"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-8-156"><a id="__codelineno-8-156" name="__codelineno-8-156" href="#__codelineno-8-156"></a><span class="s">kind: Service</span>
-</span><span id="__span-8-157"><a id="__codelineno-8-157" name="__codelineno-8-157" href="#__codelineno-8-157"></a><span class="s">metadata:</span>
-</span><span id="__span-8-158"><a id="__codelineno-8-158" name="__codelineno-8-158" href="#__codelineno-8-158"></a><span class="s">  name: envoy</span>
-</span><span id="__span-8-159"><a id="__codelineno-8-159" name="__codelineno-8-159" href="#__codelineno-8-159"></a><span class="s">spec:</span>
-</span><span id="__span-8-160"><a id="__codelineno-8-160" name="__codelineno-8-160" href="#__codelineno-8-160"></a><span class="s">  selector:</span>
-</span><span id="__span-8-161"><a id="__codelineno-8-161" name="__codelineno-8-161" href="#__codelineno-8-161"></a><span class="s">    app: envoy</span>
-</span><span id="__span-8-162"><a id="__codelineno-8-162" name="__codelineno-8-162" href="#__codelineno-8-162"></a><span class="s">  ports:</span>
-</span><span id="__span-8-163"><a id="__codelineno-8-163" name="__codelineno-8-163" href="#__codelineno-8-163"></a><span class="s">  - name: web</span>
-</span><span id="__span-8-164"><a id="__codelineno-8-164" name="__codelineno-8-164" href="#__codelineno-8-164"></a><span class="s">    port: 8443</span>
-</span><span id="__span-8-165"><a id="__codelineno-8-165" name="__codelineno-8-165" href="#__codelineno-8-165"></a><span class="s">    protocol: TCP</span>
-</span><span id="__span-8-166"><a id="__codelineno-8-166" name="__codelineno-8-166" href="#__codelineno-8-166"></a><span class="s">---</span>
-</span><span id="__span-8-167"><a id="__codelineno-8-167" name="__codelineno-8-167" href="#__codelineno-8-167"></a><span class="s">apiVersion: networking.k8s.io/v1</span>
-</span><span id="__span-8-168"><a id="__codelineno-8-168" name="__codelineno-8-168" href="#__codelineno-8-168"></a><span class="s">kind: Ingress</span>
-</span><span id="__span-8-169"><a id="__codelineno-8-169" name="__codelineno-8-169" href="#__codelineno-8-169"></a><span class="s">metadata:</span>
-</span><span id="__span-8-170"><a id="__codelineno-8-170" name="__codelineno-8-170" href="#__codelineno-8-170"></a><span class="s">  name: ingress-wildcard-host</span>
-</span><span id="__span-8-171"><a id="__codelineno-8-171" name="__codelineno-8-171" href="#__codelineno-8-171"></a><span class="s">spec:</span>
-</span><span id="__span-8-172"><a id="__codelineno-8-172" name="__codelineno-8-172" href="#__codelineno-8-172"></a><span class="s">  rules:</span>
-</span><span id="__span-8-173"><a id="__codelineno-8-173" name="__codelineno-8-173" href="#__codelineno-8-173"></a><span class="s">  - host: talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-8-174"><a id="__codelineno-8-174" name="__codelineno-8-174" href="#__codelineno-8-174"></a><span class="s">    http:</span>
-</span><span id="__span-8-175"><a id="__codelineno-8-175" name="__codelineno-8-175" href="#__codelineno-8-175"></a><span class="s">      paths:</span>
-</span><span id="__span-8-176"><a id="__codelineno-8-176" name="__codelineno-8-176" href="#__codelineno-8-176"></a><span class="s">      - backend:</span>
-</span><span id="__span-8-177"><a id="__codelineno-8-177" name="__codelineno-8-177" href="#__codelineno-8-177"></a><span class="s">          service:</span>
-</span><span id="__span-8-178"><a id="__codelineno-8-178" name="__codelineno-8-178" href="#__codelineno-8-178"></a><span class="s">            name: envoy</span>
-</span><span id="__span-8-179"><a id="__codelineno-8-179" name="__codelineno-8-179" href="#__codelineno-8-179"></a><span class="s">            port: { number: 8443 }</span>
-</span><span id="__span-8-180"><a id="__codelineno-8-180" name="__codelineno-8-180" href="#__codelineno-8-180"></a><span class="s">        path: /</span>
-</span><span id="__span-8-181"><a id="__codelineno-8-181" name="__codelineno-8-181" href="#__codelineno-8-181"></a><span class="s">        pathType: Prefix</span>
-</span><span id="__span-8-182"><a id="__codelineno-8-182" name="__codelineno-8-182" href="#__codelineno-8-182"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8443 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8443</span>:8443<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-the-authconfig">❻ Create the <code>AuthConfig</code><a class="headerlink" href="#create-the-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">metadata:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">spec:</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">    &quot;mtls&quot;:</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">      x509:</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">        selector:</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="s">            app: talker-api</span>
-</span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="s">  authorization:</span>
-</span><span id="__span-10-17"><a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a><span class="s">    &quot;acme&quot;:</span>
-</span><span id="__span-10-18"><a id="__codelineno-10-18" name="__codelineno-10-18" href="#__codelineno-10-18"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-10-19"><a id="__codelineno-10-19" name="__codelineno-10-19" href="#__codelineno-10-19"></a><span class="s">        patterns:</span>
-</span><span id="__span-10-20"><a id="__codelineno-10-20" name="__codelineno-10-20" href="#__codelineno-10-20"></a><span class="s">        - selector: auth.identity.Organization</span>
-</span><span id="__span-10-21"><a id="__codelineno-10-21" name="__codelineno-10-21" href="#__codelineno-10-21"></a><span class="s">          operator: incl</span>
-</span><span id="__span-10-22"><a id="__codelineno-10-22" name="__codelineno-10-22" href="#__codelineno-10-22"></a><span class="s">          value: ACME Inc.</span>
-</span><span id="__span-10-23"><a id="__codelineno-10-23" name="__codelineno-10-23" href="#__codelineno-10-23"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>With a TLS certificate signed by the trusted CA:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>openssl<span class="w"> </span>genrsa<span class="w"> </span>-out<span class="w"> </span>/tmp/aisha.key<span class="w"> </span><span class="m">4096</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>openssl<span class="w"> </span>req<span class="w"> </span>-new<span class="w"> </span>-subj<span class="w"> </span><span class="s2">&quot;/CN=aisha/C=PK/L=Islamabad/O=ACME Inc./OU=Engineering&quot;</span><span class="w"> </span>-key<span class="w"> </span>/tmp/aisha.key<span class="w"> </span>-out<span class="w"> </span>/tmp/aisha.csr
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a>openssl<span class="w"> </span>x509<span class="w"> </span>-req<span class="w"> </span>-sha512<span class="w"> </span>-days<span class="w"> </span><span class="m">1</span><span class="w"> </span>-CA<span class="w"> </span>/tmp/ca.crt<span class="w"> </span>-CAkey<span class="w"> </span>/tmp/ca.key<span class="w"> </span>-CAcreateserial<span class="w"> </span>-extfile<span class="w"> </span>/tmp/x509v3.ext<span class="w"> </span>-in<span class="w"> </span>/tmp/aisha.csr<span class="w"> </span>-out<span class="w"> </span>/tmp/aisha.crt
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a>curl<span class="w"> </span>-k<span class="w"> </span>--cert<span class="w"> </span>/tmp/aisha.crt<span class="w"> </span>--key<span class="w"> </span>/tmp/aisha.key<span class="w"> </span>https://talker-api.127.0.0.1.nip.io:8443<span class="w"> </span>-i
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>With a TLS certificate signed by the trusted CA, though missing an authorized Organization:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>openssl<span class="w"> </span>genrsa<span class="w"> </span>-out<span class="w"> </span>/tmp/john.key<span class="w"> </span><span class="m">4096</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>openssl<span class="w"> </span>req<span class="w"> </span>-new<span class="w"> </span>-subj<span class="w"> </span><span class="s2">&quot;/CN=john/C=UK/L=London&quot;</span><span class="w"> </span>-key<span class="w"> </span>/tmp/john.key<span class="w"> </span>-out<span class="w"> </span>/tmp/john.csr
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>openssl<span class="w"> </span>x509<span class="w"> </span>-req<span class="w"> </span>-sha512<span class="w"> </span>-days<span class="w"> </span><span class="m">1</span><span class="w"> </span>-CA<span class="w"> </span>/tmp/ca.crt<span class="w"> </span>-CAkey<span class="w"> </span>/tmp/ca.key<span class="w"> </span>-CAcreateserial<span class="w"> </span>-extfile<span class="w"> </span>/tmp/x509v3.ext<span class="w"> </span>-in<span class="w"> </span>/tmp/john.csr<span class="w"> </span>-out<span class="w"> </span>/tmp/john.crt
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a>curl<span class="w"> </span>-k<span class="w"> </span>--cert<span class="w"> </span>/tmp/john.crt<span class="w"> </span>--key<span class="w"> </span>/tmp/john.key<span class="w"> </span>https://talker-api.127.0.0.1.nip.io:8443<span class="w"> </span>-i
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="c1"># x-ext-auth-reason: Unauthorized</span>
-</span></code></pre></div>
-<h2 id="try-the-authconfig-via-raw-http-authorization-interface">❽ Try the AuthConfig via raw HTTP authorization interface<a class="headerlink" href="#try-the-authconfig-via-raw-http-authorization-interface" title="Permanent link">&para;</a></h2>
-<p>Expose Authorino's raw HTTP authorization to the local host:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>service/authorino-authorino-authorization<span class="w"> </span><span class="m">5001</span>:5001<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<p>With a TLS certificate signed by the trusted CA:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>-k<span class="w"> </span>--cert<span class="w"> </span>/tmp/aisha.crt<span class="w"> </span>--key<span class="w"> </span>/tmp/aisha.key<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Content-Type: application/json&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;{}&#39;</span><span class="w"> </span>https://talker-api.127.0.0.1.nip.io:5001/check<span class="w"> </span>-i
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="c1"># HTTP/2 200</span>
-</span></code></pre></div>
-<p>With a TLS certificate signed by an unknown authority:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>openssl<span class="w"> </span>req<span class="w"> </span>-x509<span class="w"> </span>-sha512<span class="w"> </span>-nodes<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="w">  </span>-days<span class="w"> </span><span class="m">365</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="w">  </span>-newkey<span class="w"> </span>rsa:4096<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="w">  </span>-subj<span class="w"> </span><span class="s2">&quot;/CN=untrusted&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="w">  </span>-addext<span class="w"> </span><span class="nv">basicConstraints</span><span class="o">=</span>CA:TRUE<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="w">  </span>-addext<span class="w"> </span><span class="nv">keyUsage</span><span class="o">=</span>digitalSignature,keyCertSign<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="w">  </span>-keyout<span class="w"> </span>/tmp/untrusted-ca.key<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="w">  </span>-out<span class="w"> </span>/tmp/untrusted-ca.crt
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a>openssl<span class="w"> </span>genrsa<span class="w"> </span>-out<span class="w"> </span>/tmp/niko.key<span class="w"> </span><span class="m">4096</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a>openssl<span class="w"> </span>req<span class="w"> </span>-new<span class="w"> </span>-subj<span class="w"> </span><span class="s2">&quot;/CN=niko/C=JP/L=Osaka&quot;</span><span class="w"> </span>-key<span class="w"> </span>/tmp/niko.key<span class="w"> </span>-out<span class="w"> </span>/tmp/niko.csr
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a>openssl<span class="w"> </span>x509<span class="w"> </span>-req<span class="w"> </span>-sha512<span class="w"> </span>-days<span class="w"> </span><span class="m">1</span><span class="w"> </span>-CA<span class="w"> </span>/tmp/untrusted-ca.crt<span class="w"> </span>-CAkey<span class="w"> </span>/tmp/untrusted-ca.key<span class="w"> </span>-CAcreateserial<span class="w"> </span>-extfile<span class="w"> </span>/tmp/x509v3.ext<span class="w"> </span>-in<span class="w"> </span>/tmp/niko.csr<span class="w"> </span>-out<span class="w"> </span>/tmp/niko.crt
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a>curl<span class="w"> </span>-k<span class="w"> </span>--cert<span class="w"> </span>/tmp/niko.crt<span class="w"> </span>--key<span class="w"> </span>/tmp/niko.key<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Content-Type: application/json&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;{}&#39;</span><span class="w"> </span>https://talker-api.127.0.0.1.nip.io:5001/check<span class="w"> </span>-i
-</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="c1"># HTTP/2 401</span>
-</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="c1"># www-authenticate: Basic realm=&quot;mtls&quot;</span>
-</span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a><span class="c1"># x-ext-auth-reason: x509: certificate signed by unknown authority</span>
-</span></code></pre></div>
-<h2 id="revoke-an-entire-chain-of-certificates">❾ Revoke an entire chain of certificates<a class="headerlink" href="#revoke-an-entire-chain-of-certificates" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/talker-api-ca
-</span></code></pre></div>
-<p>Even if the deleted root certificate is still cached and accepted at the gateway, Authorino will revoke access at application level immediately.</p>
-<p>Try with a previously accepted certificate:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>curl<span class="w"> </span>-k<span class="w"> </span>--cert<span class="w"> </span>/tmp/aisha.crt<span class="w"> </span>--key<span class="w"> </span>/tmp/aisha.key<span class="w"> </span>https://talker-api.127.0.0.1.nip.io:8443<span class="w"> </span>-i
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="c1"># www-authenticate: Basic realm=&quot;mtls&quot;</span>
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="c1"># x-ext-auth-reason: x509: certificate signed by unknown authority</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/oauth2-token-introspection/index.html b/0.10.0/authorino/docs/user-guides/oauth2-token-introspection/index.html
deleted file mode 100644
index ab3071b57..000000000
--- a/0.10.0/authorino/docs/user-guides/oauth2-token-introspection/index.html
+++ /dev/null
@@ -1,3867 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/oauth2-token-introspection/">
-      
-      
-        <link rel="prev" href="../oidc-jwt-authentication/">
-      
-      
-        <link rel="next" href="../passing-credentials/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>OAuth 2.0 token introspection (RFC 7662) - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-oauth-20-token-introspection-rfc-7662" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              OAuth 2.0 token introspection (RFC 7662)
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Obtain an access token and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-keycloak-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token with Keycloak and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-a12n-server-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token with a12n-server and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-api-with-a-missing-or-invalid-access-token" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the API with a missing or invalid access token
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Obtain an access token and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-keycloak-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token with Keycloak and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-a12n-server-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token with a12n-server and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-api-with-a-missing-or-invalid-access-token" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the API with a missing or invalid access token
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/oauth2-token-introspection.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-oauth-20-token-introspection-rfc-7662">User guide: OAuth 2.0 token introspection (RFC 7662)<a class="headerlink" href="#user-guide-oauth-20-token-introspection-rfc-7662" title="Permanent link">&para;</a></h1>
-<p>Introspect OAuth 2.0 access tokens (e.g. opaque tokens) for online user data and token validation in request-time.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#oauth-20-introspection-authenticationoauth2introspection">OAuth 2.0 introspection</a></li>
-      <li>Authorization → <a href="../features.md#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization</a></li>
-    </ul>
-  </summary>
-<p>Authorino can perform OAuth 2.0 token introspection (<a href="https://tools.ietf.org/html/rfc7662">RFC 7662</a>) on the access tokens supplied in the requests to protected APIs. This is particularly useful when using opaque tokens, for remote checking the token validity and resolving the identity object.</p>
-<p><em>Important!</em> Authorino does <strong>not</strong> implement <a href="https://datatracker.ietf.org/doc/html/rfc6749#section-4">OAuth2 grants</a> nor <a href="https://openid.net/specs/openid-connect-core-1_0.html#Authentication">OIDC authentication flows</a>. As a common recommendation of good practice, obtaining and refreshing access tokens is for clients to negotiate directly with the auth servers and token issuers. Authorino will only validate those tokens using the parameters provided by the trusted issuer authorities.</p>
-<p>Check out as well the user guides about <a href="../oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a> and <a href="../json-pattern-matching-authorization/">Simple pattern-matching authorization policies</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>OAuth 2.0 server that implements the token introspection endpoint (<a href="https://tools.ietf.org/html/rfc7662">RFC 7662</a>) (e.g. <a href="https://www.keycloak.org">Keycloak</a> or <a href="https://github.com/curveball/a12n-server">a12n-server</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy a Keycloak server preloaded with the realm settings required for this guide:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p>Deploy an a12n-server server preloaded with all settings required for this guide:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>a12n-server
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>a12n-server<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/a12n-server/a12n-server-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">spec:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">  listener:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">    tls:</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">    tls:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create the required secrets that will be used by Authorino to authenticate with Keycloak and a12n-server during the introspection request:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: oauth2-token-introspection-credentials-keycloak</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">stringData:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">  clientID: talker-api</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">  clientSecret: 523b92b6-625d-4e1e-a313-77e7a8ae4e88</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">type: Opaque</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">---</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">kind: Secret</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">metadata:</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">  name: oauth2-token-introspection-credentials-a12n-server</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">stringData:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">  clientID: talker-api</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">  clientSecret: V6g-2Eq2ALB1_WHAswzoeZofJ_e86RI4tdjClDDDb4g</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">type: Opaque</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create the Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">spec:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">    &quot;keycloak&quot;:</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">      oauth2Introspection:</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="s">        endpoint: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token/introspect</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="s">        tokenTypeHint: requesting_party_token</span>
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a><span class="s">        credentialsRef:</span>
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a><span class="s">          name: oauth2-token-introspection-credentials-keycloak</span>
-</span><span id="__span-9-17"><a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a><span class="s">    &quot;a12n-server&quot;:</span>
-</span><span id="__span-9-18"><a id="__codelineno-9-18" name="__codelineno-9-18" href="#__codelineno-9-18"></a><span class="s">      oauth2Introspection:</span>
-</span><span id="__span-9-19"><a id="__codelineno-9-19" name="__codelineno-9-19" href="#__codelineno-9-19"></a><span class="s">        endpoint: http://a12n-server.a12n-server.svc.cluster.local:8531/introspect</span>
-</span><span id="__span-9-20"><a id="__codelineno-9-20" name="__codelineno-9-20" href="#__codelineno-9-20"></a><span class="s">        credentialsRef:</span>
-</span><span id="__span-9-21"><a id="__codelineno-9-21" name="__codelineno-9-21" href="#__codelineno-9-21"></a><span class="s">          name: oauth2-token-introspection-credentials-a12n-server</span>
-</span><span id="__span-9-22"><a id="__codelineno-9-22" name="__codelineno-9-22" href="#__codelineno-9-22"></a><span class="s">  authorization:</span>
-</span><span id="__span-9-23"><a id="__codelineno-9-23" name="__codelineno-9-23" href="#__codelineno-9-23"></a><span class="s">    &quot;can-read&quot;:</span>
-</span><span id="__span-9-24"><a id="__codelineno-9-24" name="__codelineno-9-24" href="#__codelineno-9-24"></a><span class="s">      when:</span>
-</span><span id="__span-9-25"><a id="__codelineno-9-25" name="__codelineno-9-25" href="#__codelineno-9-25"></a><span class="s">      - selector: auth.identity.privileges</span>
-</span><span id="__span-9-26"><a id="__codelineno-9-26" name="__codelineno-9-26" href="#__codelineno-9-26"></a><span class="s">        operator: neq</span>
-</span><span id="__span-9-27"><a id="__codelineno-9-27" name="__codelineno-9-27" href="#__codelineno-9-27"></a><span class="s">        value: &quot;&quot;</span>
-</span><span id="__span-9-28"><a id="__codelineno-9-28" name="__codelineno-9-28" href="#__codelineno-9-28"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-9-29"><a id="__codelineno-9-29" name="__codelineno-9-29" href="#__codelineno-9-29"></a><span class="s">        patterns:</span>
-</span><span id="__span-9-30"><a id="__codelineno-9-30" name="__codelineno-9-30" href="#__codelineno-9-30"></a><span class="s">        - selector: auth.identity.privileges.talker-api</span>
-</span><span id="__span-9-31"><a id="__codelineno-9-31" name="__codelineno-9-31" href="#__codelineno-9-31"></a><span class="s">          operator: incl</span>
-</span><span id="__span-9-32"><a id="__codelineno-9-32" name="__codelineno-9-32" href="#__codelineno-9-32"></a><span class="s">          value: read</span>
-</span><span id="__span-9-33"><a id="__codelineno-9-33" name="__codelineno-9-33" href="#__codelineno-9-33"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>On every request, Authorino will try to verify the token remotely with the Keycloak server and the a12n-server server.</p>
-<p>For authorization, whenever the introspected token data includes a <code>privileges</code> property (returned by a12n-server), Authorino will enforce only consumers whose <code>privileges.talker-api</code> includes the <code>"read"</code> permission are granted access.</p>
-<p>Check out the docs for information about the common feature <a href="../../features/#common-feature-conditions-when">Conditions</a> about skipping parts of an <code>AuthConfig</code> in the auth pipeline based on context.</p>
-<h2 id="obtain-an-access-token-and-consume-the-api">❻ Obtain an access token and consume the API<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api" title="Permanent link">&para;</a></h2>
-<h3 id="obtain-an-access-token-with-keycloak-and-consume-the-api">Obtain an access token with Keycloak and consume the API<a class="headerlink" href="#obtain-an-access-token-with-keycloak-and-consume-the-api" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for user Jane:</p>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster for the user Jane, whose e-mail has been verified:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="nb">export</span><span class="w"> </span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span><span class="s1">&#39;&quot;ACCESS_TOKEN=&quot;+.access_token,&quot;REFRESH_TOKEN=&quot;+.refresh_token&#39;</span><span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<p>As user Jane, consume the API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Revoke the access token and try to consume the API again:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/logout<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Content-Type: application/x-www-form-urlencoded&quot;</span><span class="w"> </span>-d<span class="w"> </span><span class="s2">&quot;refresh_token=</span><span class="nv">$REFRESH_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;token_type_hint=requesting_party_token&#39;</span><span class="w"> </span>-u<span class="w"> </span>demo:
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="c1"># www-authenticate: Bearer realm=&quot;keycloak&quot;</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="c1"># www-authenticate: Bearer realm=&quot;a12n-server&quot;</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="c1"># x-ext-auth-reason: {&quot;a12n-server&quot;:&quot;token is not active&quot;,&quot;keycloak&quot;:&quot;token is not active&quot;}</span>
-</span></code></pre></div>
-<h3 id="obtain-an-access-token-with-a12n-server-and-consume-the-api">Obtain an access token with a12n-server and consume the API<a class="headerlink" href="#obtain-an-access-token-with-a12n-server-and-consume-the-api" title="Permanent link">&para;</a></h3>
-<p>Forward local requests to a12n-server instance running in the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>a12n-server<span class="w"> </span>port-forward<span class="w"> </span>deployment/a12n-server<span class="w"> </span><span class="m">8531</span>:8531<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<p>Obtain an access token with the a12n-server server for service account <code>service-account-1</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>curl<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=client_credentials&#39;</span><span class="w"> </span>-u<span class="w"> </span>service-account-1:FO6LgoMKA8TBDDHgSXZ5-iq1wKNwqdDkyeEGIl6gp0s<span class="w"> </span><span class="s2">&quot;http://localhost:8531/token&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>You can as well obtain an access token from within the cluster, in case your a12n-server is not reachable from the outside:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://a12n-server.a12n-server.svc.cluster.local:8531/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=client_credentials&#39;</span><span class="w"> </span>-u<span class="w"> </span>service-account-1:FO6LgoMKA8TBDDHgSXZ5-iq1wKNwqdDkyeEGIl6gp0s<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>Verify the issued token is an opaque access token in this case:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="nb">echo</span><span class="w"> </span><span class="nv">$ACCESS_TOKEN</span>
-</span></code></pre></div>
-<p>As <code>service-account-1</code>, consumer the API with a valid access token:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Revoke the access token and try to consume the API again:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>curl<span class="w"> </span>-d<span class="w"> </span><span class="s2">&quot;token=</span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-u<span class="w"> </span>service-account-1:FO6LgoMKA8TBDDHgSXZ5-iq1wKNwqdDkyeEGIl6gp0s<span class="w"> </span><span class="s2">&quot;http://localhost:8531/revoke&quot;</span><span class="w"> </span>-i
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a><span class="c1"># www-authenticate: Bearer realm=&quot;keycloak&quot;</span>
-</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="c1"># www-authenticate: Bearer realm=&quot;a12n-server&quot;</span>
-</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a><span class="c1"># x-ext-auth-reason: {&quot;a12n-server&quot;:&quot;token is not active&quot;,&quot;keycloak&quot;:&quot;token is not active&quot;}</span>
-</span></code></pre></div>
-<h3 id="consume-the-api-with-a-missing-or-invalid-access-token">Consume the API with a missing or invalid access token<a class="headerlink" href="#consume-the-api-with-a-missing-or-invalid-access-token" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer invalid&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-21-3"><a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a><span class="c1"># www-authenticate: Bearer realm=&quot;keycloak&quot;</span>
-</span><span id="__span-21-4"><a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a><span class="c1"># www-authenticate: Bearer realm=&quot;a12n-server&quot;</span>
-</span><span id="__span-21-5"><a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a><span class="c1"># x-ext-auth-reason: {&quot;a12n-server&quot;:&quot;token is not active&quot;,&quot;keycloak&quot;:&quot;token is not active&quot;}</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/oauth2-token-introspection-credentials-keycloak
-</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/oauth2-token-introspection-credentials-a12n-server
-</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-23-5"><a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-23-6"><a id="__codelineno-23-6" name="__codelineno-23-6" href="#__codelineno-23-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-23-7"><a id="__codelineno-23-7" name="__codelineno-23-7" href="#__codelineno-23-7"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-23-8"><a id="__codelineno-23-8" name="__codelineno-23-8" href="#__codelineno-23-8"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>a12n-server
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/observability/index.html b/0.10.0/authorino/docs/user-guides/observability/index.html
deleted file mode 100644
index ff7fb1d02..000000000
--- a/0.10.0/authorino/docs/user-guides/observability/index.html
+++ /dev/null
@@ -1,5440 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/observability/">
-      
-      
-        <link rel="prev" href="../../../../kuadrant-operator/doc/observability/tracing/">
-      
-      
-        <link rel="next" href="../../../../api-quickstart/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Authentication and Authorization - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#observability" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Authentication and Authorization
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Metrics
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#readiness-check" class="md-nav__link">
-    <span class="md-ellipsis">
-      Readiness check
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#logging" class="md-nav__link">
-    <span class="md-ellipsis">
-      Logging
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Logging">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#log-levels-and-log-modes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Log levels and log modes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#sensitive-data-output-to-the-logs" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sensitive data output to the logs
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#log-messages-printed-by-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      Log messages printed by Authorino
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Log messages printed by Authorino">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#tracing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Tracing
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Tracing">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#request-id" class="md-nav__link">
-    <span class="md-ellipsis">
-      Request ID
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#propagation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Propagation
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#log-tracing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Log tracing
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#opentelemetry-integration" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenTelemetry integration
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Metrics
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#readiness-check" class="md-nav__link">
-    <span class="md-ellipsis">
-      Readiness check
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#logging" class="md-nav__link">
-    <span class="md-ellipsis">
-      Logging
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Logging">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#log-levels-and-log-modes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Log levels and log modes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#sensitive-data-output-to-the-logs" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sensitive data output to the logs
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#log-messages-printed-by-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      Log messages printed by Authorino
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Log messages printed by Authorino">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#tracing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Tracing
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Tracing">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#request-id" class="md-nav__link">
-    <span class="md-ellipsis">
-      Request ID
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#propagation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Propagation
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#log-tracing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Log tracing
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#opentelemetry-integration" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenTelemetry integration
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/observability.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="observability">Observability<a class="headerlink" href="#observability" title="Permanent link">&para;</a></h1>
-<h2 id="metrics">Metrics<a class="headerlink" href="#metrics" title="Permanent link">&para;</a></h2>
-<p>Authorino exports metrics at 2 endpoints:</p>
-<table>
-  <tr>
-    <td><strong>/metrics</strong></td>
-    <td>Metrics of the controller-runtime about reconciliation (caching) of AuthConfigs and API key Secrets</td>
-  </tr>
-  <tr>
-    <td><strong>/server-metrics</strong></td>
-    <td>Metrics of the external authorization gRPC and OIDC/Festival Wristband validation built-in HTTP servers</td>
-  </tr>
-</table>
-
-<p>The <a href="https://github.com/kuadrant/authorino-operator">Authorino Operator</a> creates a Kubernetes <code>Service</code> named <code>&lt;authorino-cr-name&gt;-controller-metrics</code> that exposes the endpoints on port 8080. The Authorino instance allows to modify the port number of the metrics endpoints, by setting the <code>--metrics-addr</code> command-line flag (default: <code>:8080</code>).</p>
-<p><strong>Main metrics exported by endpoint<sup>1</sup>:</strong></p>
-<table>
-  <thead>
-    <tr>
-      <td colspan="4"><br/><strong>Endpoint: <code>/metrics</code></strong><br/><br/></td>
-    </tr>
-    <tr>
-      <th>Metric name</th>
-      <th>Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</th>
-      <th>Labels</th>
-      <th>Type</th>
-    <tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>controller_runtime_reconcile_total</td>
-      <td>Total number of reconciliations per controller</td>
-      <td><code>controller=authconfig|secret</code>, <code>result=success|error|requeue</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>controller_runtime_reconcile_errors_total</td>
-      <td>Total number of reconciliation errors per controller</td>
-      <td><code>controller=authconfig|secret</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>controller_runtime_reconcile_time_seconds</td>
-      <td>Length of time per reconciliation per controller</td>
-      <td><code>controller=authconfig|secret</code></td>
-      <td>histogram</td>
-    </tr>
-    <tr>
-      <td>controller_runtime_max_concurrent_reconciles</td>
-      <td>Maximum number of concurrent reconciles per controller</td>
-      <td><code>controller=authconfig|secret</code></td>
-      <td>gauge</td>
-    </tr>
-    <tr>
-      <td>workqueue_adds_total</td>
-      <td>Total number of adds handled by workqueue</td>
-      <td><code>name=authconfig|secret</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>workqueue_depth</td>
-      <td>Current depth of workqueue</td>
-      <td><code>name=authconfig|secret</code></td>
-      <td>gauge</td>
-    </tr>
-    <tr>
-      <td>workqueue_queue_duration_seconds</td>
-      <td>How long in seconds an item stays in workqueue before being requested</td>
-      <td><code>name=authconfig|secret</code></td>
-      <td>histogram</td>
-    </tr>
-    <tr>
-      <td>workqueue_longest_running_processor_seconds</td>
-      <td>How many seconds has the longest running processor for workqueue been running.</td>
-      <td><code>name=authconfig|secret</code></td>
-      <td>gauge</td>
-    </tr>
-    <tr>
-      <td>workqueue_retries_total</td>
-      <td>Total number of retries handled by workqueue</td>
-      <td><code>name=authconfig|secret</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>workqueue_unfinished_work_seconds</td>
-      <td>How many seconds of work has been done that is in progress and hasn't been observed by work_duration.</td>
-      <td><code>name=authconfig|secret</code></td>
-      <td>gauge</td>
-    </tr>
-    <tr>
-      <td>workqueue_work_duration_seconds</td>
-      <td>How long in seconds processing an item from workqueue takes.</td>
-      <td><code>name=authconfig|secret</code></td>
-      <td>histogram</td>
-    </tr>
-    <tr>
-      <td>rest_client_requests_total</td>
-      <td>Number of HTTP requests, partitioned by status code, method, and host.</td>
-      <td><code>code=200|404</code>, <code>method=GET|PUT|POST</code></td>
-      <td>counter</td>
-    </tr>
-  </tbody>
-  <thead>
-    <tr>
-      <td colspan="4"><br/><br/><strong>Endpoint: <code>/server-metrics</code></strong><br/><br/></td>
-    </tr>
-    <tr>
-      <th>Metric name</th>
-      <th>Description</th>
-      <th>Labels</th>
-      <th>Type</th>
-    <tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>auth_server_evaluator_total<sup>2</sup></td>
-      <td>Total number of evaluations of individual authconfig rule performed by the auth server.</td>
-      <td><code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>auth_server_evaluator_cancelled<sup>2</sup></td>
-      <td>Number of evaluations of individual authconfig rule cancelled by the auth server.</td>
-      <td><code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>auth_server_evaluator_ignored<sup>2</sup></td>
-      <td>Number of evaluations of individual authconfig rule ignored by the auth server.</td>
-      <td><code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>auth_server_evaluator_denied<sup>2</sup></td>
-      <td>Number of denials from individual authconfig rule evaluated by the auth server.</td>
-      <td><code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>auth_server_evaluator_duration_seconds<sup>2</sup></td>
-      <td>Response latency of individual authconfig rule evaluated by the auth server (in seconds).</td>
-      <td><code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code></td>
-      <td>histogram</td>
-    </tr>
-    <tr>
-      <td>auth_server_authconfig_total</td>
-      <td>Total number of authconfigs enforced by the auth server, partitioned by authconfig.</td>
-      <td><code>namespace</code>, <code>authconfig</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>auth_server_authconfig_response_status</td>
-      <td>Response status of authconfigs sent by the auth server, partitioned by authconfig.</td>
-      <td><code>namespace</code>, <code>authconfig</code>, <code>status=OK|UNAUTHENTICATED,PERMISSION_DENIED</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>auth_server_authconfig_duration_seconds</td>
-      <td>Response latency of authconfig enforced by the auth server (in seconds).</td>
-      <td><code>namespace</code>, <code>authconfig</code></td>
-      <td>histogram</td>
-    </tr>
-    <tr>
-      <td>auth_server_response_status</td>
-      <td>Response status of authconfigs sent by the auth server.</td>
-      <td><code>status=OK|UNAUTHENTICATED,PERMISSION_DENIED|NOT_FOUND</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>grpc_server_handled_total</td>
-      <td>Total number of RPCs completed on the server, regardless of success or failure.</td>
-      <td><code>grpc_code=OK|Aborted|Canceled|DeadlineExceeded|Internal|ResourceExhausted|Unknown</code>, <code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>grpc_server_handling_seconds</td>
-      <td>Response latency (seconds) of gRPC that had been application-level handled by the server.</td>
-      <td><code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code></td>
-      <td>histogram</td>
-    </tr>
-    <tr>
-      <td>grpc_server_msg_received_total</td>
-      <td>Total number of RPC stream messages received on the server.</td>
-      <td><code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>grpc_server_msg_sent_total</td>
-      <td>Total number of gRPC stream messages sent by the server.</td>
-      <td><code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>grpc_server_started_total</td>
-      <td>Total number of RPCs started on the server.</td>
-      <td><code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>http_server_handled_total</td>
-      <td>Total number of calls completed on the raw HTTP authorization server, regardless of success or failure.</td>
-      <td><code>http_code</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>http_server_handling_seconds</td>
-      <td>Response latency (seconds) of raw HTTP authorization request that had been application-level handled by the server.</td>
-      <td></td>
-      <td>histogram</td>
-    </tr>
-    <tr>
-      <td>oidc_server_requests_total</td>
-      <td>Number of get requests received on the OIDC (Festival Wristband) server.</td>
-      <td><code>namespace</code>, <code>authconfig</code>, <code>wristband</code>, <code>path=oidc-config|jwks</code></td>
-      <td>counter</td>
-    </tr>
-    <tr>
-      <td>oidc_server_response_status</td>
-      <td>Status of HTTP response sent by the OIDC (Festival Wristband) server.</td>
-      <td><code>status=200|404</code></td>
-      <td>counter</td>
-    </tr>
-  </tbody>
-</table>
-
-<p><sup>1</sup> Both endpoints export metrics about the Go runtime, such as number of goroutines (go_goroutines) and threads (go_threads), usage of CPU, memory and GC stats.</p>
-<p><sup>2</sup> Opt-in metrics: <code>auth_server_evaluator_*</code> metrics require <code>authconfig.spec.(identity|metadata|authorization|response).metrics: true</code> (default: <code>false</code>). This can be enforced for the entire instance (all AuthConfigs and evaluators), by setting the <code>--deep-metrics-enabled</code> command-line flag in the Authorino deployment.</p>
-<details>
-<summary><b>Example of metrics exported at the <code>/metrics</code> endpoint</b></summary>
-<div class="language-ini highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="c1"># HELP controller_runtime_active_workers Number of currently used workers per controller</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="c1"># TYPE controller_runtime_active_workers gauge</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="na">controller_runtime_active_workers{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 0</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="na">controller_runtime_active_workers{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;} 0</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="c1"># HELP controller_runtime_max_concurrent_reconciles Maximum number of concurrent reconciles per controller</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="c1"># TYPE controller_runtime_max_concurrent_reconciles gauge</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="na">controller_runtime_max_concurrent_reconciles{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 1</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="na">controller_runtime_max_concurrent_reconciles{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;} 1</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="c1"># HELP controller_runtime_reconcile_errors_total Total number of reconciliation errors per controller</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="c1"># TYPE controller_runtime_reconcile_errors_total counter</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="na">controller_runtime_reconcile_errors_total{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 12</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="na">controller_runtime_reconcile_errors_total{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;} 0</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="c1"># HELP controller_runtime_reconcile_time_seconds Length of time per reconciliation per controller</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="c1"># TYPE controller_runtime_reconcile_time_seconds histogram</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.005&quot;} 1</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.01&quot;} 11</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.025&quot;} 17</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.05&quot;} 18</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.1&quot;} 18</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.15&quot;} 18</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.2&quot;} 18</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.25&quot;} 18</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.3&quot;} 18</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.35&quot;} 18</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.4&quot;} 18</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.45&quot;} 18</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.5&quot;} 18</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.6&quot;} 18</span>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.7&quot;} 18</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.8&quot;} 18</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.9&quot;} 18</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1&quot;} 18</span>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1.25&quot;} 18</span>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1.5&quot;} 18</span>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1.75&quot;} 18</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;2&quot;} 18</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;2.5&quot;} 18</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;3&quot;} 18</span>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;3.5&quot;} 18</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;4&quot;} 18</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;4.5&quot;} 18</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;5&quot;} 19</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;6&quot;} 19</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;7&quot;} 19</span>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;8&quot;} 19</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;9&quot;} 19</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;10&quot;} 19</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;15&quot;} 19</span>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49" href="#__codelineno-0-49"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;20&quot;} 19</span>
-</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50" href="#__codelineno-0-50"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;25&quot;} 19</span>
-</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51" href="#__codelineno-0-51"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;30&quot;} 19</span>
-</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52" href="#__codelineno-0-52"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;40&quot;} 19</span>
-</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53" href="#__codelineno-0-53"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;50&quot;} 19</span>
-</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54" href="#__codelineno-0-54"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;60&quot;} 19</span>
-</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55" href="#__codelineno-0-55"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;+Inf&quot;} 19</span>
-</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56" href="#__codelineno-0-56"></a><span class="na">controller_runtime_reconcile_time_seconds_sum{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 5.171108321999999</span>
-</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57" href="#__codelineno-0-57"></a><span class="na">controller_runtime_reconcile_time_seconds_count{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 19</span>
-</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58" href="#__codelineno-0-58"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.005&quot;} 1</span>
-</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59" href="#__codelineno-0-59"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.01&quot;} 1</span>
-</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60" href="#__codelineno-0-60"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.025&quot;} 1</span>
-</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61" href="#__codelineno-0-61"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.05&quot;} 1</span>
-</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62" href="#__codelineno-0-62"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.1&quot;} 1</span>
-</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63" href="#__codelineno-0-63"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.15&quot;} 1</span>
-</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64" href="#__codelineno-0-64"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.2&quot;} 1</span>
-</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65" href="#__codelineno-0-65"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.25&quot;} 1</span>
-</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66" href="#__codelineno-0-66"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.3&quot;} 1</span>
-</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67" href="#__codelineno-0-67"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.35&quot;} 1</span>
-</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68" href="#__codelineno-0-68"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.4&quot;} 1</span>
-</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69" href="#__codelineno-0-69"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.45&quot;} 1</span>
-</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70" href="#__codelineno-0-70"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.5&quot;} 1</span>
-</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71" href="#__codelineno-0-71"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.6&quot;} 1</span>
-</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72" href="#__codelineno-0-72"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.7&quot;} 1</span>
-</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73" href="#__codelineno-0-73"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.8&quot;} 1</span>
-</span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74" href="#__codelineno-0-74"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.9&quot;} 1</span>
-</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75" href="#__codelineno-0-75"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1&quot;} 1</span>
-</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76" href="#__codelineno-0-76"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1.25&quot;} 1</span>
-</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77" href="#__codelineno-0-77"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1.5&quot;} 1</span>
-</span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78" href="#__codelineno-0-78"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1.75&quot;} 1</span>
-</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79" href="#__codelineno-0-79"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;2&quot;} 1</span>
-</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80" href="#__codelineno-0-80"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;2.5&quot;} 1</span>
-</span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81" href="#__codelineno-0-81"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;3&quot;} 1</span>
-</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82" href="#__codelineno-0-82"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;3.5&quot;} 1</span>
-</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83" href="#__codelineno-0-83"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;4&quot;} 1</span>
-</span><span id="__span-0-84"><a id="__codelineno-0-84" name="__codelineno-0-84" href="#__codelineno-0-84"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;4.5&quot;} 1</span>
-</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85" href="#__codelineno-0-85"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;5&quot;} 1</span>
-</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86" href="#__codelineno-0-86"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;6&quot;} 1</span>
-</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87" href="#__codelineno-0-87"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;7&quot;} 1</span>
-</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88" href="#__codelineno-0-88"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;8&quot;} 1</span>
-</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89" href="#__codelineno-0-89"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;9&quot;} 1</span>
-</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90" href="#__codelineno-0-90"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;10&quot;} 1</span>
-</span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91" href="#__codelineno-0-91"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;15&quot;} 1</span>
-</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92" href="#__codelineno-0-92"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;20&quot;} 1</span>
-</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93" href="#__codelineno-0-93"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;25&quot;} 1</span>
-</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94" href="#__codelineno-0-94"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;30&quot;} 1</span>
-</span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95" href="#__codelineno-0-95"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;40&quot;} 1</span>
-</span><span id="__span-0-96"><a id="__codelineno-0-96" name="__codelineno-0-96" href="#__codelineno-0-96"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;50&quot;} 1</span>
-</span><span id="__span-0-97"><a id="__codelineno-0-97" name="__codelineno-0-97" href="#__codelineno-0-97"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;60&quot;} 1</span>
-</span><span id="__span-0-98"><a id="__codelineno-0-98" name="__codelineno-0-98" href="#__codelineno-0-98"></a><span class="na">controller_runtime_reconcile_time_seconds_bucket{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;+Inf&quot;} 1</span>
-</span><span id="__span-0-99"><a id="__codelineno-0-99" name="__codelineno-0-99" href="#__codelineno-0-99"></a><span class="na">controller_runtime_reconcile_time_seconds_sum{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;} 0.000138025</span>
-</span><span id="__span-0-100"><a id="__codelineno-0-100" name="__codelineno-0-100" href="#__codelineno-0-100"></a><span class="na">controller_runtime_reconcile_time_seconds_count{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;} 1</span>
-</span><span id="__span-0-101"><a id="__codelineno-0-101" name="__codelineno-0-101" href="#__codelineno-0-101"></a><span class="c1"># HELP controller_runtime_reconcile_total Total number of reconciliations per controller</span>
-</span><span id="__span-0-102"><a id="__codelineno-0-102" name="__codelineno-0-102" href="#__codelineno-0-102"></a><span class="c1"># TYPE controller_runtime_reconcile_total counter</span>
-</span><span id="__span-0-103"><a id="__codelineno-0-103" name="__codelineno-0-103" href="#__codelineno-0-103"></a><span class="na">controller_runtime_reconcile_total{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,result=&quot;error&quot;} 12</span>
-</span><span id="__span-0-104"><a id="__codelineno-0-104" name="__codelineno-0-104" href="#__codelineno-0-104"></a><span class="na">controller_runtime_reconcile_total{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,result=&quot;requeue&quot;} 0</span>
-</span><span id="__span-0-105"><a id="__codelineno-0-105" name="__codelineno-0-105" href="#__codelineno-0-105"></a><span class="na">controller_runtime_reconcile_total{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,result=&quot;requeue_after&quot;} 0</span>
-</span><span id="__span-0-106"><a id="__codelineno-0-106" name="__codelineno-0-106" href="#__codelineno-0-106"></a><span class="na">controller_runtime_reconcile_total{controller</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,result=&quot;success&quot;} 7</span>
-</span><span id="__span-0-107"><a id="__codelineno-0-107" name="__codelineno-0-107" href="#__codelineno-0-107"></a><span class="na">controller_runtime_reconcile_total{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,result=&quot;error&quot;} 0</span>
-</span><span id="__span-0-108"><a id="__codelineno-0-108" name="__codelineno-0-108" href="#__codelineno-0-108"></a><span class="na">controller_runtime_reconcile_total{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,result=&quot;requeue&quot;} 0</span>
-</span><span id="__span-0-109"><a id="__codelineno-0-109" name="__codelineno-0-109" href="#__codelineno-0-109"></a><span class="na">controller_runtime_reconcile_total{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,result=&quot;requeue_after&quot;} 0</span>
-</span><span id="__span-0-110"><a id="__codelineno-0-110" name="__codelineno-0-110" href="#__codelineno-0-110"></a><span class="na">controller_runtime_reconcile_total{controller</span><span class="o">=</span><span class="s">&quot;secret&quot;,result=&quot;success&quot;} 1</span>
-</span><span id="__span-0-111"><a id="__codelineno-0-111" name="__codelineno-0-111" href="#__codelineno-0-111"></a><span class="c1"># HELP go_gc_cycles_automatic_gc_cycles_total Count of completed GC cycles generated by the Go runtime.</span>
-</span><span id="__span-0-112"><a id="__codelineno-0-112" name="__codelineno-0-112" href="#__codelineno-0-112"></a><span class="c1"># TYPE go_gc_cycles_automatic_gc_cycles_total counter</span>
-</span><span id="__span-0-113"><a id="__codelineno-0-113" name="__codelineno-0-113" href="#__codelineno-0-113"></a><span class="na">go_gc_cycles_automatic_gc_cycles_total 13</span>
-</span><span id="__span-0-114"><a id="__codelineno-0-114" name="__codelineno-0-114" href="#__codelineno-0-114"></a><span class="c1"># HELP go_gc_cycles_forced_gc_cycles_total Count of completed GC cycles forced by the application.</span>
-</span><span id="__span-0-115"><a id="__codelineno-0-115" name="__codelineno-0-115" href="#__codelineno-0-115"></a><span class="c1"># TYPE go_gc_cycles_forced_gc_cycles_total counter</span>
-</span><span id="__span-0-116"><a id="__codelineno-0-116" name="__codelineno-0-116" href="#__codelineno-0-116"></a><span class="na">go_gc_cycles_forced_gc_cycles_total 0</span>
-</span><span id="__span-0-117"><a id="__codelineno-0-117" name="__codelineno-0-117" href="#__codelineno-0-117"></a><span class="c1"># HELP go_gc_cycles_total_gc_cycles_total Count of all completed GC cycles.</span>
-</span><span id="__span-0-118"><a id="__codelineno-0-118" name="__codelineno-0-118" href="#__codelineno-0-118"></a><span class="c1"># TYPE go_gc_cycles_total_gc_cycles_total counter</span>
-</span><span id="__span-0-119"><a id="__codelineno-0-119" name="__codelineno-0-119" href="#__codelineno-0-119"></a><span class="na">go_gc_cycles_total_gc_cycles_total 13</span>
-</span><span id="__span-0-120"><a id="__codelineno-0-120" name="__codelineno-0-120" href="#__codelineno-0-120"></a><span class="c1"># HELP go_gc_duration_seconds A summary of the pause duration of garbage collection cycles.</span>
-</span><span id="__span-0-121"><a id="__codelineno-0-121" name="__codelineno-0-121" href="#__codelineno-0-121"></a><span class="c1"># TYPE go_gc_duration_seconds summary</span>
-</span><span id="__span-0-122"><a id="__codelineno-0-122" name="__codelineno-0-122" href="#__codelineno-0-122"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;0&quot;} 4.5971e-05</span>
-</span><span id="__span-0-123"><a id="__codelineno-0-123" name="__codelineno-0-123" href="#__codelineno-0-123"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;0.25&quot;} 5.69e-05</span>
-</span><span id="__span-0-124"><a id="__codelineno-0-124" name="__codelineno-0-124" href="#__codelineno-0-124"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;0.5&quot;} 0.000140699</span>
-</span><span id="__span-0-125"><a id="__codelineno-0-125" name="__codelineno-0-125" href="#__codelineno-0-125"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;0.75&quot;} 0.000313162</span>
-</span><span id="__span-0-126"><a id="__codelineno-0-126" name="__codelineno-0-126" href="#__codelineno-0-126"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;1&quot;} 0.001692423</span>
-</span><span id="__span-0-127"><a id="__codelineno-0-127" name="__codelineno-0-127" href="#__codelineno-0-127"></a><span class="na">go_gc_duration_seconds_sum 0.003671076</span>
-</span><span id="__span-0-128"><a id="__codelineno-0-128" name="__codelineno-0-128" href="#__codelineno-0-128"></a><span class="na">go_gc_duration_seconds_count 13</span>
-</span><span id="__span-0-129"><a id="__codelineno-0-129" name="__codelineno-0-129" href="#__codelineno-0-129"></a><span class="c1"># HELP go_gc_heap_allocs_by_size_bytes_total Distribution of heap allocations by approximate size. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.</span>
-</span><span id="__span-0-130"><a id="__codelineno-0-130" name="__codelineno-0-130" href="#__codelineno-0-130"></a><span class="c1"># TYPE go_gc_heap_allocs_by_size_bytes_total histogram</span>
-</span><span id="__span-0-131"><a id="__codelineno-0-131" name="__codelineno-0-131" href="#__codelineno-0-131"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;8.999999999999998&quot;} 6357</span>
-</span><span id="__span-0-132"><a id="__codelineno-0-132" name="__codelineno-0-132" href="#__codelineno-0-132"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;16.999999999999996&quot;} 45065</span>
-</span><span id="__span-0-133"><a id="__codelineno-0-133" name="__codelineno-0-133" href="#__codelineno-0-133"></a><span class="k">[...]</span>
-</span><span id="__span-0-134"><a id="__codelineno-0-134" name="__codelineno-0-134" href="#__codelineno-0-134"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;32768.99999999999&quot;} 128306</span>
-</span><span id="__span-0-135"><a id="__codelineno-0-135" name="__codelineno-0-135" href="#__codelineno-0-135"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;+Inf&quot;} 128327</span>
-</span><span id="__span-0-136"><a id="__codelineno-0-136" name="__codelineno-0-136" href="#__codelineno-0-136"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_sum 1.5021512e+07</span>
-</span><span id="__span-0-137"><a id="__codelineno-0-137" name="__codelineno-0-137" href="#__codelineno-0-137"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_count 128327</span>
-</span><span id="__span-0-138"><a id="__codelineno-0-138" name="__codelineno-0-138" href="#__codelineno-0-138"></a><span class="c1"># HELP go_gc_heap_allocs_bytes_total Cumulative sum of memory allocated to the heap by the application.</span>
-</span><span id="__span-0-139"><a id="__codelineno-0-139" name="__codelineno-0-139" href="#__codelineno-0-139"></a><span class="c1"># TYPE go_gc_heap_allocs_bytes_total counter</span>
-</span><span id="__span-0-140"><a id="__codelineno-0-140" name="__codelineno-0-140" href="#__codelineno-0-140"></a><span class="na">go_gc_heap_allocs_bytes_total 1.5021512e+07</span>
-</span><span id="__span-0-141"><a id="__codelineno-0-141" name="__codelineno-0-141" href="#__codelineno-0-141"></a><span class="c1"># HELP go_gc_heap_allocs_objects_total Cumulative count of heap allocations triggered by the application. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.</span>
-</span><span id="__span-0-142"><a id="__codelineno-0-142" name="__codelineno-0-142" href="#__codelineno-0-142"></a><span class="c1"># TYPE go_gc_heap_allocs_objects_total counter</span>
-</span><span id="__span-0-143"><a id="__codelineno-0-143" name="__codelineno-0-143" href="#__codelineno-0-143"></a><span class="na">go_gc_heap_allocs_objects_total 128327</span>
-</span><span id="__span-0-144"><a id="__codelineno-0-144" name="__codelineno-0-144" href="#__codelineno-0-144"></a><span class="c1"># HELP go_gc_heap_frees_by_size_bytes_total Distribution of freed heap allocations by approximate size. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.</span>
-</span><span id="__span-0-145"><a id="__codelineno-0-145" name="__codelineno-0-145" href="#__codelineno-0-145"></a><span class="c1"># TYPE go_gc_heap_frees_by_size_bytes_total histogram</span>
-</span><span id="__span-0-146"><a id="__codelineno-0-146" name="__codelineno-0-146" href="#__codelineno-0-146"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;8.999999999999998&quot;} 3885</span>
-</span><span id="__span-0-147"><a id="__codelineno-0-147" name="__codelineno-0-147" href="#__codelineno-0-147"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;16.999999999999996&quot;} 33418</span>
-</span><span id="__span-0-148"><a id="__codelineno-0-148" name="__codelineno-0-148" href="#__codelineno-0-148"></a><span class="k">[...]</span>
-</span><span id="__span-0-149"><a id="__codelineno-0-149" name="__codelineno-0-149" href="#__codelineno-0-149"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;32768.99999999999&quot;} 96417</span>
-</span><span id="__span-0-150"><a id="__codelineno-0-150" name="__codelineno-0-150" href="#__codelineno-0-150"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;+Inf&quot;} 96425</span>
-</span><span id="__span-0-151"><a id="__codelineno-0-151" name="__codelineno-0-151" href="#__codelineno-0-151"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_sum 9.880944e+06</span>
-</span><span id="__span-0-152"><a id="__codelineno-0-152" name="__codelineno-0-152" href="#__codelineno-0-152"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_count 96425</span>
-</span><span id="__span-0-153"><a id="__codelineno-0-153" name="__codelineno-0-153" href="#__codelineno-0-153"></a><span class="c1"># HELP go_gc_heap_frees_bytes_total Cumulative sum of heap memory freed by the garbage collector.</span>
-</span><span id="__span-0-154"><a id="__codelineno-0-154" name="__codelineno-0-154" href="#__codelineno-0-154"></a><span class="c1"># TYPE go_gc_heap_frees_bytes_total counter</span>
-</span><span id="__span-0-155"><a id="__codelineno-0-155" name="__codelineno-0-155" href="#__codelineno-0-155"></a><span class="na">go_gc_heap_frees_bytes_total 9.880944e+06</span>
-</span><span id="__span-0-156"><a id="__codelineno-0-156" name="__codelineno-0-156" href="#__codelineno-0-156"></a><span class="c1"># HELP go_gc_heap_frees_objects_total Cumulative count of heap allocations whose storage was freed by the garbage collector. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.</span>
-</span><span id="__span-0-157"><a id="__codelineno-0-157" name="__codelineno-0-157" href="#__codelineno-0-157"></a><span class="c1"># TYPE go_gc_heap_frees_objects_total counter</span>
-</span><span id="__span-0-158"><a id="__codelineno-0-158" name="__codelineno-0-158" href="#__codelineno-0-158"></a><span class="na">go_gc_heap_frees_objects_total 96425</span>
-</span><span id="__span-0-159"><a id="__codelineno-0-159" name="__codelineno-0-159" href="#__codelineno-0-159"></a><span class="c1"># HELP go_gc_heap_goal_bytes Heap size target for the end of the GC cycle.</span>
-</span><span id="__span-0-160"><a id="__codelineno-0-160" name="__codelineno-0-160" href="#__codelineno-0-160"></a><span class="c1"># TYPE go_gc_heap_goal_bytes gauge</span>
-</span><span id="__span-0-161"><a id="__codelineno-0-161" name="__codelineno-0-161" href="#__codelineno-0-161"></a><span class="na">go_gc_heap_goal_bytes 9.356624e+06</span>
-</span><span id="__span-0-162"><a id="__codelineno-0-162" name="__codelineno-0-162" href="#__codelineno-0-162"></a><span class="c1"># HELP go_gc_heap_objects_objects Number of objects, live or unswept, occupying heap memory.</span>
-</span><span id="__span-0-163"><a id="__codelineno-0-163" name="__codelineno-0-163" href="#__codelineno-0-163"></a><span class="c1"># TYPE go_gc_heap_objects_objects gauge</span>
-</span><span id="__span-0-164"><a id="__codelineno-0-164" name="__codelineno-0-164" href="#__codelineno-0-164"></a><span class="na">go_gc_heap_objects_objects 31902</span>
-</span><span id="__span-0-165"><a id="__codelineno-0-165" name="__codelineno-0-165" href="#__codelineno-0-165"></a><span class="c1"># HELP go_gc_heap_tiny_allocs_objects_total Count of small allocations that are packed together into blocks. These allocations are counted separately from other allocations because each individual allocation is not tracked by the runtime, only their block. Each block is already accounted for in allocs-by-size and frees-by-size.</span>
-</span><span id="__span-0-166"><a id="__codelineno-0-166" name="__codelineno-0-166" href="#__codelineno-0-166"></a><span class="c1"># TYPE go_gc_heap_tiny_allocs_objects_total counter</span>
-</span><span id="__span-0-167"><a id="__codelineno-0-167" name="__codelineno-0-167" href="#__codelineno-0-167"></a><span class="na">go_gc_heap_tiny_allocs_objects_total 11750</span>
-</span><span id="__span-0-168"><a id="__codelineno-0-168" name="__codelineno-0-168" href="#__codelineno-0-168"></a><span class="c1"># HELP go_gc_pauses_seconds_total Distribution individual GC-related stop-the-world pause latencies.</span>
-</span><span id="__span-0-169"><a id="__codelineno-0-169" name="__codelineno-0-169" href="#__codelineno-0-169"></a><span class="c1"># TYPE go_gc_pauses_seconds_total histogram</span>
-</span><span id="__span-0-170"><a id="__codelineno-0-170" name="__codelineno-0-170" href="#__codelineno-0-170"></a><span class="na">go_gc_pauses_seconds_total_bucket{le</span><span class="o">=</span><span class="s">&quot;9.999999999999999e-10&quot;} 0</span>
-</span><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171" href="#__codelineno-0-171"></a><span class="na">go_gc_pauses_seconds_total_bucket{le</span><span class="o">=</span><span class="s">&quot;1.9999999999999997e-09&quot;} 0</span>
-</span><span id="__span-0-172"><a id="__codelineno-0-172" name="__codelineno-0-172" href="#__codelineno-0-172"></a><span class="k">[...]</span>
-</span><span id="__span-0-173"><a id="__codelineno-0-173" name="__codelineno-0-173" href="#__codelineno-0-173"></a><span class="na">go_gc_pauses_seconds_total_bucket{le</span><span class="o">=</span><span class="s">&quot;206708.18602188796&quot;} 26</span>
-</span><span id="__span-0-174"><a id="__codelineno-0-174" name="__codelineno-0-174" href="#__codelineno-0-174"></a><span class="na">go_gc_pauses_seconds_total_bucket{le</span><span class="o">=</span><span class="s">&quot;+Inf&quot;} 26</span>
-</span><span id="__span-0-175"><a id="__codelineno-0-175" name="__codelineno-0-175" href="#__codelineno-0-175"></a><span class="na">go_gc_pauses_seconds_total_sum 0.003151488</span>
-</span><span id="__span-0-176"><a id="__codelineno-0-176" name="__codelineno-0-176" href="#__codelineno-0-176"></a><span class="na">go_gc_pauses_seconds_total_count 26</span>
-</span><span id="__span-0-177"><a id="__codelineno-0-177" name="__codelineno-0-177" href="#__codelineno-0-177"></a><span class="c1"># HELP go_goroutines Number of goroutines that currently exist.</span>
-</span><span id="__span-0-178"><a id="__codelineno-0-178" name="__codelineno-0-178" href="#__codelineno-0-178"></a><span class="c1"># TYPE go_goroutines gauge</span>
-</span><span id="__span-0-179"><a id="__codelineno-0-179" name="__codelineno-0-179" href="#__codelineno-0-179"></a><span class="na">go_goroutines 80</span>
-</span><span id="__span-0-180"><a id="__codelineno-0-180" name="__codelineno-0-180" href="#__codelineno-0-180"></a><span class="c1"># HELP go_info Information about the Go environment.</span>
-</span><span id="__span-0-181"><a id="__codelineno-0-181" name="__codelineno-0-181" href="#__codelineno-0-181"></a><span class="c1"># TYPE go_info gauge</span>
-</span><span id="__span-0-182"><a id="__codelineno-0-182" name="__codelineno-0-182" href="#__codelineno-0-182"></a><span class="na">go_info{version</span><span class="o">=</span><span class="s">&quot;go1.18.7&quot;} 1</span>
-</span><span id="__span-0-183"><a id="__codelineno-0-183" name="__codelineno-0-183" href="#__codelineno-0-183"></a><span class="c1"># HELP go_memory_classes_heap_free_bytes Memory that is completely free and eligible to be returned to the underlying system, but has not been. This metric is the runtime&#39;s estimate of free address space that is backed by physical memory.</span>
-</span><span id="__span-0-184"><a id="__codelineno-0-184" name="__codelineno-0-184" href="#__codelineno-0-184"></a><span class="c1"># TYPE go_memory_classes_heap_free_bytes gauge</span>
-</span><span id="__span-0-185"><a id="__codelineno-0-185" name="__codelineno-0-185" href="#__codelineno-0-185"></a><span class="na">go_memory_classes_heap_free_bytes 589824</span>
-</span><span id="__span-0-186"><a id="__codelineno-0-186" name="__codelineno-0-186" href="#__codelineno-0-186"></a><span class="c1"># HELP go_memory_classes_heap_objects_bytes Memory occupied by live objects and dead objects that have not yet been marked free by the garbage collector.</span>
-</span><span id="__span-0-187"><a id="__codelineno-0-187" name="__codelineno-0-187" href="#__codelineno-0-187"></a><span class="c1"># TYPE go_memory_classes_heap_objects_bytes gauge</span>
-</span><span id="__span-0-188"><a id="__codelineno-0-188" name="__codelineno-0-188" href="#__codelineno-0-188"></a><span class="na">go_memory_classes_heap_objects_bytes 5.140568e+06</span>
-</span><span id="__span-0-189"><a id="__codelineno-0-189" name="__codelineno-0-189" href="#__codelineno-0-189"></a><span class="c1"># HELP go_memory_classes_heap_released_bytes Memory that is completely free and has been returned to the underlying system. This metric is the runtime&#39;s estimate of free address space that is still mapped into the process, but is not backed by physical memory.</span>
-</span><span id="__span-0-190"><a id="__codelineno-0-190" name="__codelineno-0-190" href="#__codelineno-0-190"></a><span class="c1"># TYPE go_memory_classes_heap_released_bytes gauge</span>
-</span><span id="__span-0-191"><a id="__codelineno-0-191" name="__codelineno-0-191" href="#__codelineno-0-191"></a><span class="na">go_memory_classes_heap_released_bytes 4.005888e+06</span>
-</span><span id="__span-0-192"><a id="__codelineno-0-192" name="__codelineno-0-192" href="#__codelineno-0-192"></a><span class="c1"># HELP go_memory_classes_heap_stacks_bytes Memory allocated from the heap that is reserved for stack space, whether or not it is currently in-use.</span>
-</span><span id="__span-0-193"><a id="__codelineno-0-193" name="__codelineno-0-193" href="#__codelineno-0-193"></a><span class="c1"># TYPE go_memory_classes_heap_stacks_bytes gauge</span>
-</span><span id="__span-0-194"><a id="__codelineno-0-194" name="__codelineno-0-194" href="#__codelineno-0-194"></a><span class="na">go_memory_classes_heap_stacks_bytes 786432</span>
-</span><span id="__span-0-195"><a id="__codelineno-0-195" name="__codelineno-0-195" href="#__codelineno-0-195"></a><span class="c1"># HELP go_memory_classes_heap_unused_bytes Memory that is reserved for heap objects but is not currently used to hold heap objects.</span>
-</span><span id="__span-0-196"><a id="__codelineno-0-196" name="__codelineno-0-196" href="#__codelineno-0-196"></a><span class="c1"># TYPE go_memory_classes_heap_unused_bytes gauge</span>
-</span><span id="__span-0-197"><a id="__codelineno-0-197" name="__codelineno-0-197" href="#__codelineno-0-197"></a><span class="na">go_memory_classes_heap_unused_bytes 2.0602e+06</span>
-</span><span id="__span-0-198"><a id="__codelineno-0-198" name="__codelineno-0-198" href="#__codelineno-0-198"></a><span class="c1"># HELP go_memory_classes_metadata_mcache_free_bytes Memory that is reserved for runtime mcache structures, but not in-use.</span>
-</span><span id="__span-0-199"><a id="__codelineno-0-199" name="__codelineno-0-199" href="#__codelineno-0-199"></a><span class="c1"># TYPE go_memory_classes_metadata_mcache_free_bytes gauge</span>
-</span><span id="__span-0-200"><a id="__codelineno-0-200" name="__codelineno-0-200" href="#__codelineno-0-200"></a><span class="na">go_memory_classes_metadata_mcache_free_bytes 13984</span>
-</span><span id="__span-0-201"><a id="__codelineno-0-201" name="__codelineno-0-201" href="#__codelineno-0-201"></a><span class="c1"># HELP go_memory_classes_metadata_mcache_inuse_bytes Memory that is occupied by runtime mcache structures that are currently being used.</span>
-</span><span id="__span-0-202"><a id="__codelineno-0-202" name="__codelineno-0-202" href="#__codelineno-0-202"></a><span class="c1"># TYPE go_memory_classes_metadata_mcache_inuse_bytes gauge</span>
-</span><span id="__span-0-203"><a id="__codelineno-0-203" name="__codelineno-0-203" href="#__codelineno-0-203"></a><span class="na">go_memory_classes_metadata_mcache_inuse_bytes 2400</span>
-</span><span id="__span-0-204"><a id="__codelineno-0-204" name="__codelineno-0-204" href="#__codelineno-0-204"></a><span class="c1"># HELP go_memory_classes_metadata_mspan_free_bytes Memory that is reserved for runtime mspan structures, but not in-use.</span>
-</span><span id="__span-0-205"><a id="__codelineno-0-205" name="__codelineno-0-205" href="#__codelineno-0-205"></a><span class="c1"># TYPE go_memory_classes_metadata_mspan_free_bytes gauge</span>
-</span><span id="__span-0-206"><a id="__codelineno-0-206" name="__codelineno-0-206" href="#__codelineno-0-206"></a><span class="na">go_memory_classes_metadata_mspan_free_bytes 17104</span>
-</span><span id="__span-0-207"><a id="__codelineno-0-207" name="__codelineno-0-207" href="#__codelineno-0-207"></a><span class="c1"># HELP go_memory_classes_metadata_mspan_inuse_bytes Memory that is occupied by runtime mspan structures that are currently being used.</span>
-</span><span id="__span-0-208"><a id="__codelineno-0-208" name="__codelineno-0-208" href="#__codelineno-0-208"></a><span class="c1"># TYPE go_memory_classes_metadata_mspan_inuse_bytes gauge</span>
-</span><span id="__span-0-209"><a id="__codelineno-0-209" name="__codelineno-0-209" href="#__codelineno-0-209"></a><span class="na">go_memory_classes_metadata_mspan_inuse_bytes 113968</span>
-</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210" href="#__codelineno-0-210"></a><span class="c1"># HELP go_memory_classes_metadata_other_bytes Memory that is reserved for or used to hold runtime metadata.</span>
-</span><span id="__span-0-211"><a id="__codelineno-0-211" name="__codelineno-0-211" href="#__codelineno-0-211"></a><span class="c1"># TYPE go_memory_classes_metadata_other_bytes gauge</span>
-</span><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212" href="#__codelineno-0-212"></a><span class="na">go_memory_classes_metadata_other_bytes 5.544408e+06</span>
-</span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213" href="#__codelineno-0-213"></a><span class="c1"># HELP go_memory_classes_os_stacks_bytes Stack memory allocated by the underlying operating system.</span>
-</span><span id="__span-0-214"><a id="__codelineno-0-214" name="__codelineno-0-214" href="#__codelineno-0-214"></a><span class="c1"># TYPE go_memory_classes_os_stacks_bytes gauge</span>
-</span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215" href="#__codelineno-0-215"></a><span class="na">go_memory_classes_os_stacks_bytes 0</span>
-</span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216" href="#__codelineno-0-216"></a><span class="c1"># HELP go_memory_classes_other_bytes Memory used by execution trace buffers, structures for debugging the runtime, finalizer and profiler specials, and more.</span>
-</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217" href="#__codelineno-0-217"></a><span class="c1"># TYPE go_memory_classes_other_bytes gauge</span>
-</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218" href="#__codelineno-0-218"></a><span class="na">go_memory_classes_other_bytes 537777</span>
-</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219" href="#__codelineno-0-219"></a><span class="c1"># HELP go_memory_classes_profiling_buckets_bytes Memory that is used by the stack trace hash map used for profiling.</span>
-</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220" href="#__codelineno-0-220"></a><span class="c1"># TYPE go_memory_classes_profiling_buckets_bytes gauge</span>
-</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221" href="#__codelineno-0-221"></a><span class="na">go_memory_classes_profiling_buckets_bytes 1.455487e+06</span>
-</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222" href="#__codelineno-0-222"></a><span class="c1"># HELP go_memory_classes_total_bytes All memory mapped by the Go runtime into the current process as read-write. Note that this does not include memory mapped by code called via cgo or via the syscall package. Sum of all metrics in /memory/classes.</span>
-</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223" href="#__codelineno-0-223"></a><span class="c1"># TYPE go_memory_classes_total_bytes gauge</span>
-</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224" href="#__codelineno-0-224"></a><span class="na">go_memory_classes_total_bytes 2.026804e+07</span>
-</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225" href="#__codelineno-0-225"></a><span class="c1"># HELP go_memstats_alloc_bytes Number of bytes allocated and still in use.</span>
-</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226" href="#__codelineno-0-226"></a><span class="c1"># TYPE go_memstats_alloc_bytes gauge</span>
-</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227" href="#__codelineno-0-227"></a><span class="na">go_memstats_alloc_bytes 5.140568e+06</span>
-</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228" href="#__codelineno-0-228"></a><span class="c1"># HELP go_memstats_alloc_bytes_total Total number of bytes allocated, even if freed.</span>
-</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229" href="#__codelineno-0-229"></a><span class="c1"># TYPE go_memstats_alloc_bytes_total counter</span>
-</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230" href="#__codelineno-0-230"></a><span class="na">go_memstats_alloc_bytes_total 1.5021512e+07</span>
-</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231" href="#__codelineno-0-231"></a><span class="c1"># HELP go_memstats_buck_hash_sys_bytes Number of bytes used by the profiling bucket hash table.</span>
-</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232" href="#__codelineno-0-232"></a><span class="c1"># TYPE go_memstats_buck_hash_sys_bytes gauge</span>
-</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233" href="#__codelineno-0-233"></a><span class="na">go_memstats_buck_hash_sys_bytes 1.455487e+06</span>
-</span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234" href="#__codelineno-0-234"></a><span class="c1"># HELP go_memstats_frees_total Total number of frees.</span>
-</span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235" href="#__codelineno-0-235"></a><span class="c1"># TYPE go_memstats_frees_total counter</span>
-</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236" href="#__codelineno-0-236"></a><span class="na">go_memstats_frees_total 108175</span>
-</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237" href="#__codelineno-0-237"></a><span class="c1"># HELP go_memstats_gc_cpu_fraction The fraction of this program&#39;s available CPU time used by the GC since the program started.</span>
-</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238" href="#__codelineno-0-238"></a><span class="c1"># TYPE go_memstats_gc_cpu_fraction gauge</span>
-</span><span id="__span-0-239"><a id="__codelineno-0-239" name="__codelineno-0-239" href="#__codelineno-0-239"></a><span class="na">go_memstats_gc_cpu_fraction 0</span>
-</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240" href="#__codelineno-0-240"></a><span class="c1"># HELP go_memstats_gc_sys_bytes Number of bytes used for garbage collection system metadata.</span>
-</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241" href="#__codelineno-0-241"></a><span class="c1"># TYPE go_memstats_gc_sys_bytes gauge</span>
-</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242" href="#__codelineno-0-242"></a><span class="na">go_memstats_gc_sys_bytes 5.544408e+06</span>
-</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243" href="#__codelineno-0-243"></a><span class="c1"># HELP go_memstats_heap_alloc_bytes Number of heap bytes allocated and still in use.</span>
-</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244" href="#__codelineno-0-244"></a><span class="c1"># TYPE go_memstats_heap_alloc_bytes gauge</span>
-</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245" href="#__codelineno-0-245"></a><span class="na">go_memstats_heap_alloc_bytes 5.140568e+06</span>
-</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246" href="#__codelineno-0-246"></a><span class="c1"># HELP go_memstats_heap_idle_bytes Number of heap bytes waiting to be used.</span>
-</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247" href="#__codelineno-0-247"></a><span class="c1"># TYPE go_memstats_heap_idle_bytes gauge</span>
-</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248" href="#__codelineno-0-248"></a><span class="na">go_memstats_heap_idle_bytes 4.595712e+06</span>
-</span><span id="__span-0-249"><a id="__codelineno-0-249" name="__codelineno-0-249" href="#__codelineno-0-249"></a><span class="c1"># HELP go_memstats_heap_inuse_bytes Number of heap bytes that are in use.</span>
-</span><span id="__span-0-250"><a id="__codelineno-0-250" name="__codelineno-0-250" href="#__codelineno-0-250"></a><span class="c1"># TYPE go_memstats_heap_inuse_bytes gauge</span>
-</span><span id="__span-0-251"><a id="__codelineno-0-251" name="__codelineno-0-251" href="#__codelineno-0-251"></a><span class="na">go_memstats_heap_inuse_bytes 7.200768e+06</span>
-</span><span id="__span-0-252"><a id="__codelineno-0-252" name="__codelineno-0-252" href="#__codelineno-0-252"></a><span class="c1"># HELP go_memstats_heap_objects Number of allocated objects.</span>
-</span><span id="__span-0-253"><a id="__codelineno-0-253" name="__codelineno-0-253" href="#__codelineno-0-253"></a><span class="c1"># TYPE go_memstats_heap_objects gauge</span>
-</span><span id="__span-0-254"><a id="__codelineno-0-254" name="__codelineno-0-254" href="#__codelineno-0-254"></a><span class="na">go_memstats_heap_objects 31902</span>
-</span><span id="__span-0-255"><a id="__codelineno-0-255" name="__codelineno-0-255" href="#__codelineno-0-255"></a><span class="c1"># HELP go_memstats_heap_released_bytes Number of heap bytes released to OS.</span>
-</span><span id="__span-0-256"><a id="__codelineno-0-256" name="__codelineno-0-256" href="#__codelineno-0-256"></a><span class="c1"># TYPE go_memstats_heap_released_bytes gauge</span>
-</span><span id="__span-0-257"><a id="__codelineno-0-257" name="__codelineno-0-257" href="#__codelineno-0-257"></a><span class="na">go_memstats_heap_released_bytes 4.005888e+06</span>
-</span><span id="__span-0-258"><a id="__codelineno-0-258" name="__codelineno-0-258" href="#__codelineno-0-258"></a><span class="c1"># HELP go_memstats_heap_sys_bytes Number of heap bytes obtained from system.</span>
-</span><span id="__span-0-259"><a id="__codelineno-0-259" name="__codelineno-0-259" href="#__codelineno-0-259"></a><span class="c1"># TYPE go_memstats_heap_sys_bytes gauge</span>
-</span><span id="__span-0-260"><a id="__codelineno-0-260" name="__codelineno-0-260" href="#__codelineno-0-260"></a><span class="na">go_memstats_heap_sys_bytes 1.179648e+07</span>
-</span><span id="__span-0-261"><a id="__codelineno-0-261" name="__codelineno-0-261" href="#__codelineno-0-261"></a><span class="c1"># HELP go_memstats_last_gc_time_seconds Number of seconds since 1970 of last garbage collection.</span>
-</span><span id="__span-0-262"><a id="__codelineno-0-262" name="__codelineno-0-262" href="#__codelineno-0-262"></a><span class="c1"># TYPE go_memstats_last_gc_time_seconds gauge</span>
-</span><span id="__span-0-263"><a id="__codelineno-0-263" name="__codelineno-0-263" href="#__codelineno-0-263"></a><span class="na">go_memstats_last_gc_time_seconds 1.6461572121033354e+09</span>
-</span><span id="__span-0-264"><a id="__codelineno-0-264" name="__codelineno-0-264" href="#__codelineno-0-264"></a><span class="c1"># HELP go_memstats_lookups_total Total number of pointer lookups.</span>
-</span><span id="__span-0-265"><a id="__codelineno-0-265" name="__codelineno-0-265" href="#__codelineno-0-265"></a><span class="c1"># TYPE go_memstats_lookups_total counter</span>
-</span><span id="__span-0-266"><a id="__codelineno-0-266" name="__codelineno-0-266" href="#__codelineno-0-266"></a><span class="na">go_memstats_lookups_total 0</span>
-</span><span id="__span-0-267"><a id="__codelineno-0-267" name="__codelineno-0-267" href="#__codelineno-0-267"></a><span class="c1"># HELP go_memstats_mallocs_total Total number of mallocs.</span>
-</span><span id="__span-0-268"><a id="__codelineno-0-268" name="__codelineno-0-268" href="#__codelineno-0-268"></a><span class="c1"># TYPE go_memstats_mallocs_total counter</span>
-</span><span id="__span-0-269"><a id="__codelineno-0-269" name="__codelineno-0-269" href="#__codelineno-0-269"></a><span class="na">go_memstats_mallocs_total 140077</span>
-</span><span id="__span-0-270"><a id="__codelineno-0-270" name="__codelineno-0-270" href="#__codelineno-0-270"></a><span class="c1"># HELP go_memstats_mcache_inuse_bytes Number of bytes in use by mcache structures.</span>
-</span><span id="__span-0-271"><a id="__codelineno-0-271" name="__codelineno-0-271" href="#__codelineno-0-271"></a><span class="c1"># TYPE go_memstats_mcache_inuse_bytes gauge</span>
-</span><span id="__span-0-272"><a id="__codelineno-0-272" name="__codelineno-0-272" href="#__codelineno-0-272"></a><span class="na">go_memstats_mcache_inuse_bytes 2400</span>
-</span><span id="__span-0-273"><a id="__codelineno-0-273" name="__codelineno-0-273" href="#__codelineno-0-273"></a><span class="c1"># HELP go_memstats_mcache_sys_bytes Number of bytes used for mcache structures obtained from system.</span>
-</span><span id="__span-0-274"><a id="__codelineno-0-274" name="__codelineno-0-274" href="#__codelineno-0-274"></a><span class="c1"># TYPE go_memstats_mcache_sys_bytes gauge</span>
-</span><span id="__span-0-275"><a id="__codelineno-0-275" name="__codelineno-0-275" href="#__codelineno-0-275"></a><span class="na">go_memstats_mcache_sys_bytes 16384</span>
-</span><span id="__span-0-276"><a id="__codelineno-0-276" name="__codelineno-0-276" href="#__codelineno-0-276"></a><span class="c1"># HELP go_memstats_mspan_inuse_bytes Number of bytes in use by mspan structures.</span>
-</span><span id="__span-0-277"><a id="__codelineno-0-277" name="__codelineno-0-277" href="#__codelineno-0-277"></a><span class="c1"># TYPE go_memstats_mspan_inuse_bytes gauge</span>
-</span><span id="__span-0-278"><a id="__codelineno-0-278" name="__codelineno-0-278" href="#__codelineno-0-278"></a><span class="na">go_memstats_mspan_inuse_bytes 113968</span>
-</span><span id="__span-0-279"><a id="__codelineno-0-279" name="__codelineno-0-279" href="#__codelineno-0-279"></a><span class="c1"># HELP go_memstats_mspan_sys_bytes Number of bytes used for mspan structures obtained from system.</span>
-</span><span id="__span-0-280"><a id="__codelineno-0-280" name="__codelineno-0-280" href="#__codelineno-0-280"></a><span class="c1"># TYPE go_memstats_mspan_sys_bytes gauge</span>
-</span><span id="__span-0-281"><a id="__codelineno-0-281" name="__codelineno-0-281" href="#__codelineno-0-281"></a><span class="na">go_memstats_mspan_sys_bytes 131072</span>
-</span><span id="__span-0-282"><a id="__codelineno-0-282" name="__codelineno-0-282" href="#__codelineno-0-282"></a><span class="c1"># HELP go_memstats_next_gc_bytes Number of heap bytes when next garbage collection will take place.</span>
-</span><span id="__span-0-283"><a id="__codelineno-0-283" name="__codelineno-0-283" href="#__codelineno-0-283"></a><span class="c1"># TYPE go_memstats_next_gc_bytes gauge</span>
-</span><span id="__span-0-284"><a id="__codelineno-0-284" name="__codelineno-0-284" href="#__codelineno-0-284"></a><span class="na">go_memstats_next_gc_bytes 9.356624e+06</span>
-</span><span id="__span-0-285"><a id="__codelineno-0-285" name="__codelineno-0-285" href="#__codelineno-0-285"></a><span class="c1"># HELP go_memstats_other_sys_bytes Number of bytes used for other system allocations.</span>
-</span><span id="__span-0-286"><a id="__codelineno-0-286" name="__codelineno-0-286" href="#__codelineno-0-286"></a><span class="c1"># TYPE go_memstats_other_sys_bytes gauge</span>
-</span><span id="__span-0-287"><a id="__codelineno-0-287" name="__codelineno-0-287" href="#__codelineno-0-287"></a><span class="na">go_memstats_other_sys_bytes 537777</span>
-</span><span id="__span-0-288"><a id="__codelineno-0-288" name="__codelineno-0-288" href="#__codelineno-0-288"></a><span class="c1"># HELP go_memstats_stack_inuse_bytes Number of bytes in use by the stack allocator.</span>
-</span><span id="__span-0-289"><a id="__codelineno-0-289" name="__codelineno-0-289" href="#__codelineno-0-289"></a><span class="c1"># TYPE go_memstats_stack_inuse_bytes gauge</span>
-</span><span id="__span-0-290"><a id="__codelineno-0-290" name="__codelineno-0-290" href="#__codelineno-0-290"></a><span class="na">go_memstats_stack_inuse_bytes 786432</span>
-</span><span id="__span-0-291"><a id="__codelineno-0-291" name="__codelineno-0-291" href="#__codelineno-0-291"></a><span class="c1"># HELP go_memstats_stack_sys_bytes Number of bytes obtained from system for stack allocator.</span>
-</span><span id="__span-0-292"><a id="__codelineno-0-292" name="__codelineno-0-292" href="#__codelineno-0-292"></a><span class="c1"># TYPE go_memstats_stack_sys_bytes gauge</span>
-</span><span id="__span-0-293"><a id="__codelineno-0-293" name="__codelineno-0-293" href="#__codelineno-0-293"></a><span class="na">go_memstats_stack_sys_bytes 786432</span>
-</span><span id="__span-0-294"><a id="__codelineno-0-294" name="__codelineno-0-294" href="#__codelineno-0-294"></a><span class="c1"># HELP go_memstats_sys_bytes Number of bytes obtained from system.</span>
-</span><span id="__span-0-295"><a id="__codelineno-0-295" name="__codelineno-0-295" href="#__codelineno-0-295"></a><span class="c1"># TYPE go_memstats_sys_bytes gauge</span>
-</span><span id="__span-0-296"><a id="__codelineno-0-296" name="__codelineno-0-296" href="#__codelineno-0-296"></a><span class="na">go_memstats_sys_bytes 2.026804e+07</span>
-</span><span id="__span-0-297"><a id="__codelineno-0-297" name="__codelineno-0-297" href="#__codelineno-0-297"></a><span class="c1"># HELP go_sched_goroutines_goroutines Count of live goroutines.</span>
-</span><span id="__span-0-298"><a id="__codelineno-0-298" name="__codelineno-0-298" href="#__codelineno-0-298"></a><span class="c1"># TYPE go_sched_goroutines_goroutines gauge</span>
-</span><span id="__span-0-299"><a id="__codelineno-0-299" name="__codelineno-0-299" href="#__codelineno-0-299"></a><span class="na">go_sched_goroutines_goroutines 80</span>
-</span><span id="__span-0-300"><a id="__codelineno-0-300" name="__codelineno-0-300" href="#__codelineno-0-300"></a><span class="c1"># HELP go_sched_latencies_seconds Distribution of the time goroutines have spent in the scheduler in a runnable state before actually running.</span>
-</span><span id="__span-0-301"><a id="__codelineno-0-301" name="__codelineno-0-301" href="#__codelineno-0-301"></a><span class="c1"># TYPE go_sched_latencies_seconds histogram</span>
-</span><span id="__span-0-302"><a id="__codelineno-0-302" name="__codelineno-0-302" href="#__codelineno-0-302"></a><span class="na">go_sched_latencies_seconds_bucket{le</span><span class="o">=</span><span class="s">&quot;9.999999999999999e-10&quot;} 244</span>
-</span><span id="__span-0-303"><a id="__codelineno-0-303" name="__codelineno-0-303" href="#__codelineno-0-303"></a><span class="na">go_sched_latencies_seconds_bucket{le</span><span class="o">=</span><span class="s">&quot;1.9999999999999997e-09&quot;} 244</span>
-</span><span id="__span-0-304"><a id="__codelineno-0-304" name="__codelineno-0-304" href="#__codelineno-0-304"></a><span class="k">[...]</span>
-</span><span id="__span-0-305"><a id="__codelineno-0-305" name="__codelineno-0-305" href="#__codelineno-0-305"></a><span class="na">go_sched_latencies_seconds_bucket{le</span><span class="o">=</span><span class="s">&quot;206708.18602188796&quot;} 2336</span>
-</span><span id="__span-0-306"><a id="__codelineno-0-306" name="__codelineno-0-306" href="#__codelineno-0-306"></a><span class="na">go_sched_latencies_seconds_bucket{le</span><span class="o">=</span><span class="s">&quot;+Inf&quot;} 2336</span>
-</span><span id="__span-0-307"><a id="__codelineno-0-307" name="__codelineno-0-307" href="#__codelineno-0-307"></a><span class="na">go_sched_latencies_seconds_sum 0.18509832400000004</span>
-</span><span id="__span-0-308"><a id="__codelineno-0-308" name="__codelineno-0-308" href="#__codelineno-0-308"></a><span class="na">go_sched_latencies_seconds_count 2336</span>
-</span><span id="__span-0-309"><a id="__codelineno-0-309" name="__codelineno-0-309" href="#__codelineno-0-309"></a><span class="c1"># HELP go_threads Number of OS threads created.</span>
-</span><span id="__span-0-310"><a id="__codelineno-0-310" name="__codelineno-0-310" href="#__codelineno-0-310"></a><span class="c1"># TYPE go_threads gauge</span>
-</span><span id="__span-0-311"><a id="__codelineno-0-311" name="__codelineno-0-311" href="#__codelineno-0-311"></a><span class="na">go_threads 8</span>
-</span><span id="__span-0-312"><a id="__codelineno-0-312" name="__codelineno-0-312" href="#__codelineno-0-312"></a><span class="c1"># HELP process_cpu_seconds_total Total user and system CPU time spent in seconds.</span>
-</span><span id="__span-0-313"><a id="__codelineno-0-313" name="__codelineno-0-313" href="#__codelineno-0-313"></a><span class="c1"># TYPE process_cpu_seconds_total counter</span>
-</span><span id="__span-0-314"><a id="__codelineno-0-314" name="__codelineno-0-314" href="#__codelineno-0-314"></a><span class="na">process_cpu_seconds_total 1.84</span>
-</span><span id="__span-0-315"><a id="__codelineno-0-315" name="__codelineno-0-315" href="#__codelineno-0-315"></a><span class="c1"># HELP process_max_fds Maximum number of open file descriptors.</span>
-</span><span id="__span-0-316"><a id="__codelineno-0-316" name="__codelineno-0-316" href="#__codelineno-0-316"></a><span class="c1"># TYPE process_max_fds gauge</span>
-</span><span id="__span-0-317"><a id="__codelineno-0-317" name="__codelineno-0-317" href="#__codelineno-0-317"></a><span class="na">process_max_fds 1.048576e+06</span>
-</span><span id="__span-0-318"><a id="__codelineno-0-318" name="__codelineno-0-318" href="#__codelineno-0-318"></a><span class="c1"># HELP process_open_fds Number of open file descriptors.</span>
-</span><span id="__span-0-319"><a id="__codelineno-0-319" name="__codelineno-0-319" href="#__codelineno-0-319"></a><span class="c1"># TYPE process_open_fds gauge</span>
-</span><span id="__span-0-320"><a id="__codelineno-0-320" name="__codelineno-0-320" href="#__codelineno-0-320"></a><span class="na">process_open_fds 14</span>
-</span><span id="__span-0-321"><a id="__codelineno-0-321" name="__codelineno-0-321" href="#__codelineno-0-321"></a><span class="c1"># HELP process_resident_memory_bytes Resident memory size in bytes.</span>
-</span><span id="__span-0-322"><a id="__codelineno-0-322" name="__codelineno-0-322" href="#__codelineno-0-322"></a><span class="c1"># TYPE process_resident_memory_bytes gauge</span>
-</span><span id="__span-0-323"><a id="__codelineno-0-323" name="__codelineno-0-323" href="#__codelineno-0-323"></a><span class="na">process_resident_memory_bytes 4.3728896e+07</span>
-</span><span id="__span-0-324"><a id="__codelineno-0-324" name="__codelineno-0-324" href="#__codelineno-0-324"></a><span class="c1"># HELP process_start_time_seconds Start time of the process since unix epoch in seconds.</span>
-</span><span id="__span-0-325"><a id="__codelineno-0-325" name="__codelineno-0-325" href="#__codelineno-0-325"></a><span class="c1"># TYPE process_start_time_seconds gauge</span>
-</span><span id="__span-0-326"><a id="__codelineno-0-326" name="__codelineno-0-326" href="#__codelineno-0-326"></a><span class="na">process_start_time_seconds 1.64615612779e+09</span>
-</span><span id="__span-0-327"><a id="__codelineno-0-327" name="__codelineno-0-327" href="#__codelineno-0-327"></a><span class="c1"># HELP process_virtual_memory_bytes Virtual memory size in bytes.</span>
-</span><span id="__span-0-328"><a id="__codelineno-0-328" name="__codelineno-0-328" href="#__codelineno-0-328"></a><span class="c1"># TYPE process_virtual_memory_bytes gauge</span>
-</span><span id="__span-0-329"><a id="__codelineno-0-329" name="__codelineno-0-329" href="#__codelineno-0-329"></a><span class="na">process_virtual_memory_bytes 7.65362176e+08</span>
-</span><span id="__span-0-330"><a id="__codelineno-0-330" name="__codelineno-0-330" href="#__codelineno-0-330"></a><span class="c1"># HELP process_virtual_memory_max_bytes Maximum amount of virtual memory available in bytes.</span>
-</span><span id="__span-0-331"><a id="__codelineno-0-331" name="__codelineno-0-331" href="#__codelineno-0-331"></a><span class="c1"># TYPE process_virtual_memory_max_bytes gauge</span>
-</span><span id="__span-0-332"><a id="__codelineno-0-332" name="__codelineno-0-332" href="#__codelineno-0-332"></a><span class="na">process_virtual_memory_max_bytes 1.8446744073709552e+19</span>
-</span><span id="__span-0-333"><a id="__codelineno-0-333" name="__codelineno-0-333" href="#__codelineno-0-333"></a><span class="c1"># HELP rest_client_requests_total Number of HTTP requests, partitioned by status code, method, and host.</span>
-</span><span id="__span-0-334"><a id="__codelineno-0-334" name="__codelineno-0-334" href="#__codelineno-0-334"></a><span class="c1"># TYPE rest_client_requests_total counter</span>
-</span><span id="__span-0-335"><a id="__codelineno-0-335" name="__codelineno-0-335" href="#__codelineno-0-335"></a><span class="na">rest_client_requests_total{code</span><span class="o">=</span><span class="s">&quot;200&quot;,host=&quot;10.96.0.1:443&quot;,method=&quot;GET&quot;} 114</span>
-</span><span id="__span-0-336"><a id="__codelineno-0-336" name="__codelineno-0-336" href="#__codelineno-0-336"></a><span class="na">rest_client_requests_total{code</span><span class="o">=</span><span class="s">&quot;200&quot;,host=&quot;10.96.0.1:443&quot;,method=&quot;PUT&quot;} 4</span>
-</span><span id="__span-0-337"><a id="__codelineno-0-337" name="__codelineno-0-337" href="#__codelineno-0-337"></a><span class="c1"># HELP workqueue_adds_total Total number of adds handled by workqueue</span>
-</span><span id="__span-0-338"><a id="__codelineno-0-338" name="__codelineno-0-338" href="#__codelineno-0-338"></a><span class="c1"># TYPE workqueue_adds_total counter</span>
-</span><span id="__span-0-339"><a id="__codelineno-0-339" name="__codelineno-0-339" href="#__codelineno-0-339"></a><span class="na">workqueue_adds_total{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 19</span>
-</span><span id="__span-0-340"><a id="__codelineno-0-340" name="__codelineno-0-340" href="#__codelineno-0-340"></a><span class="na">workqueue_adds_total{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 1</span>
-</span><span id="__span-0-341"><a id="__codelineno-0-341" name="__codelineno-0-341" href="#__codelineno-0-341"></a><span class="c1"># HELP workqueue_depth Current depth of workqueue</span>
-</span><span id="__span-0-342"><a id="__codelineno-0-342" name="__codelineno-0-342" href="#__codelineno-0-342"></a><span class="c1"># TYPE workqueue_depth gauge</span>
-</span><span id="__span-0-343"><a id="__codelineno-0-343" name="__codelineno-0-343" href="#__codelineno-0-343"></a><span class="na">workqueue_depth{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 0</span>
-</span><span id="__span-0-344"><a id="__codelineno-0-344" name="__codelineno-0-344" href="#__codelineno-0-344"></a><span class="na">workqueue_depth{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 0</span>
-</span><span id="__span-0-345"><a id="__codelineno-0-345" name="__codelineno-0-345" href="#__codelineno-0-345"></a><span class="c1"># HELP workqueue_longest_running_processor_seconds How many seconds has the longest running processor for workqueue been running.</span>
-</span><span id="__span-0-346"><a id="__codelineno-0-346" name="__codelineno-0-346" href="#__codelineno-0-346"></a><span class="c1"># TYPE workqueue_longest_running_processor_seconds gauge</span>
-</span><span id="__span-0-347"><a id="__codelineno-0-347" name="__codelineno-0-347" href="#__codelineno-0-347"></a><span class="na">workqueue_longest_running_processor_seconds{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 0</span>
-</span><span id="__span-0-348"><a id="__codelineno-0-348" name="__codelineno-0-348" href="#__codelineno-0-348"></a><span class="na">workqueue_longest_running_processor_seconds{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 0</span>
-</span><span id="__span-0-349"><a id="__codelineno-0-349" name="__codelineno-0-349" href="#__codelineno-0-349"></a><span class="c1"># HELP workqueue_queue_duration_seconds How long in seconds an item stays in workqueue before being requested</span>
-</span><span id="__span-0-350"><a id="__codelineno-0-350" name="__codelineno-0-350" href="#__codelineno-0-350"></a><span class="c1"># TYPE workqueue_queue_duration_seconds histogram</span>
-</span><span id="__span-0-351"><a id="__codelineno-0-351" name="__codelineno-0-351" href="#__codelineno-0-351"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1e-08&quot;} 0</span>
-</span><span id="__span-0-352"><a id="__codelineno-0-352" name="__codelineno-0-352" href="#__codelineno-0-352"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1e-07&quot;} 0</span>
-</span><span id="__span-0-353"><a id="__codelineno-0-353" name="__codelineno-0-353" href="#__codelineno-0-353"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1e-06&quot;} 0</span>
-</span><span id="__span-0-354"><a id="__codelineno-0-354" name="__codelineno-0-354" href="#__codelineno-0-354"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;9.999999999999999e-06&quot;} 8</span>
-</span><span id="__span-0-355"><a id="__codelineno-0-355" name="__codelineno-0-355" href="#__codelineno-0-355"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;9.999999999999999e-05&quot;} 17</span>
-</span><span id="__span-0-356"><a id="__codelineno-0-356" name="__codelineno-0-356" href="#__codelineno-0-356"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.001&quot;} 17</span>
-</span><span id="__span-0-357"><a id="__codelineno-0-357" name="__codelineno-0-357" href="#__codelineno-0-357"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.01&quot;} 17</span>
-</span><span id="__span-0-358"><a id="__codelineno-0-358" name="__codelineno-0-358" href="#__codelineno-0-358"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.1&quot;} 18</span>
-</span><span id="__span-0-359"><a id="__codelineno-0-359" name="__codelineno-0-359" href="#__codelineno-0-359"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1&quot;} 18</span>
-</span><span id="__span-0-360"><a id="__codelineno-0-360" name="__codelineno-0-360" href="#__codelineno-0-360"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;10&quot;} 19</span>
-</span><span id="__span-0-361"><a id="__codelineno-0-361" name="__codelineno-0-361" href="#__codelineno-0-361"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;+Inf&quot;} 19</span>
-</span><span id="__span-0-362"><a id="__codelineno-0-362" name="__codelineno-0-362" href="#__codelineno-0-362"></a><span class="na">workqueue_queue_duration_seconds_sum{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 4.969016371</span>
-</span><span id="__span-0-363"><a id="__codelineno-0-363" name="__codelineno-0-363" href="#__codelineno-0-363"></a><span class="na">workqueue_queue_duration_seconds_count{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 19</span>
-</span><span id="__span-0-364"><a id="__codelineno-0-364" name="__codelineno-0-364" href="#__codelineno-0-364"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1e-08&quot;} 0</span>
-</span><span id="__span-0-365"><a id="__codelineno-0-365" name="__codelineno-0-365" href="#__codelineno-0-365"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1e-07&quot;} 0</span>
-</span><span id="__span-0-366"><a id="__codelineno-0-366" name="__codelineno-0-366" href="#__codelineno-0-366"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1e-06&quot;} 0</span>
-</span><span id="__span-0-367"><a id="__codelineno-0-367" name="__codelineno-0-367" href="#__codelineno-0-367"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;9.999999999999999e-06&quot;} 1</span>
-</span><span id="__span-0-368"><a id="__codelineno-0-368" name="__codelineno-0-368" href="#__codelineno-0-368"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;9.999999999999999e-05&quot;} 1</span>
-</span><span id="__span-0-369"><a id="__codelineno-0-369" name="__codelineno-0-369" href="#__codelineno-0-369"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.001&quot;} 1</span>
-</span><span id="__span-0-370"><a id="__codelineno-0-370" name="__codelineno-0-370" href="#__codelineno-0-370"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.01&quot;} 1</span>
-</span><span id="__span-0-371"><a id="__codelineno-0-371" name="__codelineno-0-371" href="#__codelineno-0-371"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.1&quot;} 1</span>
-</span><span id="__span-0-372"><a id="__codelineno-0-372" name="__codelineno-0-372" href="#__codelineno-0-372"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1&quot;} 1</span>
-</span><span id="__span-0-373"><a id="__codelineno-0-373" name="__codelineno-0-373" href="#__codelineno-0-373"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;10&quot;} 1</span>
-</span><span id="__span-0-374"><a id="__codelineno-0-374" name="__codelineno-0-374" href="#__codelineno-0-374"></a><span class="na">workqueue_queue_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;+Inf&quot;} 1</span>
-</span><span id="__span-0-375"><a id="__codelineno-0-375" name="__codelineno-0-375" href="#__codelineno-0-375"></a><span class="na">workqueue_queue_duration_seconds_sum{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 4.67e-06</span>
-</span><span id="__span-0-376"><a id="__codelineno-0-376" name="__codelineno-0-376" href="#__codelineno-0-376"></a><span class="na">workqueue_queue_duration_seconds_count{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 1</span>
-</span><span id="__span-0-377"><a id="__codelineno-0-377" name="__codelineno-0-377" href="#__codelineno-0-377"></a><span class="c1"># HELP workqueue_retries_total Total number of retries handled by workqueue</span>
-</span><span id="__span-0-378"><a id="__codelineno-0-378" name="__codelineno-0-378" href="#__codelineno-0-378"></a><span class="c1"># TYPE workqueue_retries_total counter</span>
-</span><span id="__span-0-379"><a id="__codelineno-0-379" name="__codelineno-0-379" href="#__codelineno-0-379"></a><span class="na">workqueue_retries_total{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 12</span>
-</span><span id="__span-0-380"><a id="__codelineno-0-380" name="__codelineno-0-380" href="#__codelineno-0-380"></a><span class="na">workqueue_retries_total{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 0</span>
-</span><span id="__span-0-381"><a id="__codelineno-0-381" name="__codelineno-0-381" href="#__codelineno-0-381"></a><span class="c1"># HELP workqueue_unfinished_work_seconds How many seconds of work has been done that is in progress and hasn&#39;t been observed by work_duration. Large values indicate stuck threads. One can deduce the number of stuck threads by observing the rate at which this increases.</span>
-</span><span id="__span-0-382"><a id="__codelineno-0-382" name="__codelineno-0-382" href="#__codelineno-0-382"></a><span class="c1"># TYPE workqueue_unfinished_work_seconds gauge</span>
-</span><span id="__span-0-383"><a id="__codelineno-0-383" name="__codelineno-0-383" href="#__codelineno-0-383"></a><span class="na">workqueue_unfinished_work_seconds{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 0</span>
-</span><span id="__span-0-384"><a id="__codelineno-0-384" name="__codelineno-0-384" href="#__codelineno-0-384"></a><span class="na">workqueue_unfinished_work_seconds{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 0</span>
-</span><span id="__span-0-385"><a id="__codelineno-0-385" name="__codelineno-0-385" href="#__codelineno-0-385"></a><span class="c1"># HELP workqueue_work_duration_seconds How long in seconds processing an item from workqueue takes.</span>
-</span><span id="__span-0-386"><a id="__codelineno-0-386" name="__codelineno-0-386" href="#__codelineno-0-386"></a><span class="c1"># TYPE workqueue_work_duration_seconds histogram</span>
-</span><span id="__span-0-387"><a id="__codelineno-0-387" name="__codelineno-0-387" href="#__codelineno-0-387"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1e-08&quot;} 0</span>
-</span><span id="__span-0-388"><a id="__codelineno-0-388" name="__codelineno-0-388" href="#__codelineno-0-388"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1e-07&quot;} 0</span>
-</span><span id="__span-0-389"><a id="__codelineno-0-389" name="__codelineno-0-389" href="#__codelineno-0-389"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1e-06&quot;} 0</span>
-</span><span id="__span-0-390"><a id="__codelineno-0-390" name="__codelineno-0-390" href="#__codelineno-0-390"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;9.999999999999999e-06&quot;} 0</span>
-</span><span id="__span-0-391"><a id="__codelineno-0-391" name="__codelineno-0-391" href="#__codelineno-0-391"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;9.999999999999999e-05&quot;} 0</span>
-</span><span id="__span-0-392"><a id="__codelineno-0-392" name="__codelineno-0-392" href="#__codelineno-0-392"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.001&quot;} 0</span>
-</span><span id="__span-0-393"><a id="__codelineno-0-393" name="__codelineno-0-393" href="#__codelineno-0-393"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.01&quot;} 11</span>
-</span><span id="__span-0-394"><a id="__codelineno-0-394" name="__codelineno-0-394" href="#__codelineno-0-394"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;0.1&quot;} 18</span>
-</span><span id="__span-0-395"><a id="__codelineno-0-395" name="__codelineno-0-395" href="#__codelineno-0-395"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;1&quot;} 18</span>
-</span><span id="__span-0-396"><a id="__codelineno-0-396" name="__codelineno-0-396" href="#__codelineno-0-396"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;10&quot;} 19</span>
-</span><span id="__span-0-397"><a id="__codelineno-0-397" name="__codelineno-0-397" href="#__codelineno-0-397"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;,le=&quot;+Inf&quot;} 19</span>
-</span><span id="__span-0-398"><a id="__codelineno-0-398" name="__codelineno-0-398" href="#__codelineno-0-398"></a><span class="na">workqueue_work_duration_seconds_sum{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 5.171738079000001</span>
-</span><span id="__span-0-399"><a id="__codelineno-0-399" name="__codelineno-0-399" href="#__codelineno-0-399"></a><span class="na">workqueue_work_duration_seconds_count{name</span><span class="o">=</span><span class="s">&quot;authconfig&quot;} 19</span>
-</span><span id="__span-0-400"><a id="__codelineno-0-400" name="__codelineno-0-400" href="#__codelineno-0-400"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1e-08&quot;} 0</span>
-</span><span id="__span-0-401"><a id="__codelineno-0-401" name="__codelineno-0-401" href="#__codelineno-0-401"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1e-07&quot;} 0</span>
-</span><span id="__span-0-402"><a id="__codelineno-0-402" name="__codelineno-0-402" href="#__codelineno-0-402"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1e-06&quot;} 0</span>
-</span><span id="__span-0-403"><a id="__codelineno-0-403" name="__codelineno-0-403" href="#__codelineno-0-403"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;9.999999999999999e-06&quot;} 0</span>
-</span><span id="__span-0-404"><a id="__codelineno-0-404" name="__codelineno-0-404" href="#__codelineno-0-404"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;9.999999999999999e-05&quot;} 0</span>
-</span><span id="__span-0-405"><a id="__codelineno-0-405" name="__codelineno-0-405" href="#__codelineno-0-405"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.001&quot;} 1</span>
-</span><span id="__span-0-406"><a id="__codelineno-0-406" name="__codelineno-0-406" href="#__codelineno-0-406"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.01&quot;} 1</span>
-</span><span id="__span-0-407"><a id="__codelineno-0-407" name="__codelineno-0-407" href="#__codelineno-0-407"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;0.1&quot;} 1</span>
-</span><span id="__span-0-408"><a id="__codelineno-0-408" name="__codelineno-0-408" href="#__codelineno-0-408"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;1&quot;} 1</span>
-</span><span id="__span-0-409"><a id="__codelineno-0-409" name="__codelineno-0-409" href="#__codelineno-0-409"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;10&quot;} 1</span>
-</span><span id="__span-0-410"><a id="__codelineno-0-410" name="__codelineno-0-410" href="#__codelineno-0-410"></a><span class="na">workqueue_work_duration_seconds_bucket{name</span><span class="o">=</span><span class="s">&quot;secret&quot;,le=&quot;+Inf&quot;} 1</span>
-</span><span id="__span-0-411"><a id="__codelineno-0-411" name="__codelineno-0-411" href="#__codelineno-0-411"></a><span class="na">workqueue_work_duration_seconds_sum{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 0.000150956</span>
-</span><span id="__span-0-412"><a id="__codelineno-0-412" name="__codelineno-0-412" href="#__codelineno-0-412"></a><span class="na">workqueue_work_duration_seconds_count{name</span><span class="o">=</span><span class="s">&quot;secret&quot;} 1</span>
-</span></code></pre></div>
-</details>
-<details>
-<summary><b>Example of metrics exported at the <code>/server-metrics</code> endpoint</b></summary>
-<div class="language-ini highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="c1"># HELP auth_server_authconfig_duration_seconds Response latency of authconfig enforced by the auth server (in seconds).</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="c1"># TYPE auth_server_authconfig_duration_seconds histogram</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.001&quot;} 0</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.051000000000000004&quot;} 1</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.101&quot;} 1</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.15100000000000002&quot;} 1</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.201&quot;} 1</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.251&quot;} 1</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.301&quot;} 1</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.351&quot;} 1</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.40099999999999997&quot;} 1</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.45099999999999996&quot;} 1</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.501&quot;} 1</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.551&quot;} 1</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.6010000000000001&quot;} 1</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.6510000000000001&quot;} 1</span>
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.7010000000000002&quot;} 1</span>
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.7510000000000002&quot;} 1</span>
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.8010000000000003&quot;} 1</span>
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.8510000000000003&quot;} 1</span>
-</span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.9010000000000004&quot;} 1</span>
-</span><span id="__span-1-22"><a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;0.9510000000000004&quot;} 1</span>
-</span><span id="__span-1-23"><a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,le=&quot;+Inf&quot;} 1</span>
-</span><span id="__span-1-24"><a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a><span class="na">auth_server_authconfig_duration_seconds_sum{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;} 0.001701795</span>
-</span><span id="__span-1-25"><a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a><span class="na">auth_server_authconfig_duration_seconds_count{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;} 1</span>
-</span><span id="__span-1-26"><a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.001&quot;} 1</span>
-</span><span id="__span-1-27"><a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.051000000000000004&quot;} 4</span>
-</span><span id="__span-1-28"><a id="__codelineno-1-28" name="__codelineno-1-28" href="#__codelineno-1-28"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.101&quot;} 4</span>
-</span><span id="__span-1-29"><a id="__codelineno-1-29" name="__codelineno-1-29" href="#__codelineno-1-29"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.15100000000000002&quot;} 5</span>
-</span><span id="__span-1-30"><a id="__codelineno-1-30" name="__codelineno-1-30" href="#__codelineno-1-30"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.201&quot;} 5</span>
-</span><span id="__span-1-31"><a id="__codelineno-1-31" name="__codelineno-1-31" href="#__codelineno-1-31"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.251&quot;} 5</span>
-</span><span id="__span-1-32"><a id="__codelineno-1-32" name="__codelineno-1-32" href="#__codelineno-1-32"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.301&quot;} 5</span>
-</span><span id="__span-1-33"><a id="__codelineno-1-33" name="__codelineno-1-33" href="#__codelineno-1-33"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.351&quot;} 5</span>
-</span><span id="__span-1-34"><a id="__codelineno-1-34" name="__codelineno-1-34" href="#__codelineno-1-34"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.40099999999999997&quot;} 5</span>
-</span><span id="__span-1-35"><a id="__codelineno-1-35" name="__codelineno-1-35" href="#__codelineno-1-35"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.45099999999999996&quot;} 5</span>
-</span><span id="__span-1-36"><a id="__codelineno-1-36" name="__codelineno-1-36" href="#__codelineno-1-36"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.501&quot;} 5</span>
-</span><span id="__span-1-37"><a id="__codelineno-1-37" name="__codelineno-1-37" href="#__codelineno-1-37"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.551&quot;} 5</span>
-</span><span id="__span-1-38"><a id="__codelineno-1-38" name="__codelineno-1-38" href="#__codelineno-1-38"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.6010000000000001&quot;} 5</span>
-</span><span id="__span-1-39"><a id="__codelineno-1-39" name="__codelineno-1-39" href="#__codelineno-1-39"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.6510000000000001&quot;} 5</span>
-</span><span id="__span-1-40"><a id="__codelineno-1-40" name="__codelineno-1-40" href="#__codelineno-1-40"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.7010000000000002&quot;} 5</span>
-</span><span id="__span-1-41"><a id="__codelineno-1-41" name="__codelineno-1-41" href="#__codelineno-1-41"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.7510000000000002&quot;} 5</span>
-</span><span id="__span-1-42"><a id="__codelineno-1-42" name="__codelineno-1-42" href="#__codelineno-1-42"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.8010000000000003&quot;} 5</span>
-</span><span id="__span-1-43"><a id="__codelineno-1-43" name="__codelineno-1-43" href="#__codelineno-1-43"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.8510000000000003&quot;} 5</span>
-</span><span id="__span-1-44"><a id="__codelineno-1-44" name="__codelineno-1-44" href="#__codelineno-1-44"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.9010000000000004&quot;} 5</span>
-</span><span id="__span-1-45"><a id="__codelineno-1-45" name="__codelineno-1-45" href="#__codelineno-1-45"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;0.9510000000000004&quot;} 5</span>
-</span><span id="__span-1-46"><a id="__codelineno-1-46" name="__codelineno-1-46" href="#__codelineno-1-46"></a><span class="na">auth_server_authconfig_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,le=&quot;+Inf&quot;} 5</span>
-</span><span id="__span-1-47"><a id="__codelineno-1-47" name="__codelineno-1-47" href="#__codelineno-1-47"></a><span class="na">auth_server_authconfig_duration_seconds_sum{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;} 0.26967658299999997</span>
-</span><span id="__span-1-48"><a id="__codelineno-1-48" name="__codelineno-1-48" href="#__codelineno-1-48"></a><span class="na">auth_server_authconfig_duration_seconds_count{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;} 5</span>
-</span><span id="__span-1-49"><a id="__codelineno-1-49" name="__codelineno-1-49" href="#__codelineno-1-49"></a><span class="c1"># HELP auth_server_authconfig_response_status Response status of authconfigs sent by the auth server, partitioned by authconfig.</span>
-</span><span id="__span-1-50"><a id="__codelineno-1-50" name="__codelineno-1-50" href="#__codelineno-1-50"></a><span class="c1"># TYPE auth_server_authconfig_response_status counter</span>
-</span><span id="__span-1-51"><a id="__codelineno-1-51" name="__codelineno-1-51" href="#__codelineno-1-51"></a><span class="na">auth_server_authconfig_response_status{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,status=&quot;OK&quot;} 1</span>
-</span><span id="__span-1-52"><a id="__codelineno-1-52" name="__codelineno-1-52" href="#__codelineno-1-52"></a><span class="na">auth_server_authconfig_response_status{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,status=&quot;OK&quot;} 2</span>
-</span><span id="__span-1-53"><a id="__codelineno-1-53" name="__codelineno-1-53" href="#__codelineno-1-53"></a><span class="na">auth_server_authconfig_response_status{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,status=&quot;PERMISSION_DENIED&quot;} 2</span>
-</span><span id="__span-1-54"><a id="__codelineno-1-54" name="__codelineno-1-54" href="#__codelineno-1-54"></a><span class="na">auth_server_authconfig_response_status{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;,status=&quot;UNAUTHENTICATED&quot;} 1</span>
-</span><span id="__span-1-55"><a id="__codelineno-1-55" name="__codelineno-1-55" href="#__codelineno-1-55"></a><span class="c1"># HELP auth_server_authconfig_total Total number of authconfigs enforced by the auth server, partitioned by authconfig.</span>
-</span><span id="__span-1-56"><a id="__codelineno-1-56" name="__codelineno-1-56" href="#__codelineno-1-56"></a><span class="c1"># TYPE auth_server_authconfig_total counter</span>
-</span><span id="__span-1-57"><a id="__codelineno-1-57" name="__codelineno-1-57" href="#__codelineno-1-57"></a><span class="na">auth_server_authconfig_total{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;} 1</span>
-</span><span id="__span-1-58"><a id="__codelineno-1-58" name="__codelineno-1-58" href="#__codelineno-1-58"></a><span class="na">auth_server_authconfig_total{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,namespace=&quot;authorino&quot;} 5</span>
-</span><span id="__span-1-59"><a id="__codelineno-1-59" name="__codelineno-1-59" href="#__codelineno-1-59"></a><span class="c1"># HELP auth_server_evaluator_duration_seconds Response latency of individual authconfig rule evaluated by the auth server (in seconds).</span>
-</span><span id="__span-1-60"><a id="__codelineno-1-60" name="__codelineno-1-60" href="#__codelineno-1-60"></a><span class="c1"># TYPE auth_server_evaluator_duration_seconds histogram</span>
-</span><span id="__span-1-61"><a id="__codelineno-1-61" name="__codelineno-1-61" href="#__codelineno-1-61"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.001&quot;} 0</span>
-</span><span id="__span-1-62"><a id="__codelineno-1-62" name="__codelineno-1-62" href="#__codelineno-1-62"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.051000000000000004&quot;} 3</span>
-</span><span id="__span-1-63"><a id="__codelineno-1-63" name="__codelineno-1-63" href="#__codelineno-1-63"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.101&quot;} 3</span>
-</span><span id="__span-1-64"><a id="__codelineno-1-64" name="__codelineno-1-64" href="#__codelineno-1-64"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.15100000000000002&quot;} 4</span>
-</span><span id="__span-1-65"><a id="__codelineno-1-65" name="__codelineno-1-65" href="#__codelineno-1-65"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.201&quot;} 4</span>
-</span><span id="__span-1-66"><a id="__codelineno-1-66" name="__codelineno-1-66" href="#__codelineno-1-66"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.251&quot;} 4</span>
-</span><span id="__span-1-67"><a id="__codelineno-1-67" name="__codelineno-1-67" href="#__codelineno-1-67"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.301&quot;} 4</span>
-</span><span id="__span-1-68"><a id="__codelineno-1-68" name="__codelineno-1-68" href="#__codelineno-1-68"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.351&quot;} 4</span>
-</span><span id="__span-1-69"><a id="__codelineno-1-69" name="__codelineno-1-69" href="#__codelineno-1-69"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.40099999999999997&quot;} 4</span>
-</span><span id="__span-1-70"><a id="__codelineno-1-70" name="__codelineno-1-70" href="#__codelineno-1-70"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.45099999999999996&quot;} 4</span>
-</span><span id="__span-1-71"><a id="__codelineno-1-71" name="__codelineno-1-71" href="#__codelineno-1-71"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.501&quot;} 4</span>
-</span><span id="__span-1-72"><a id="__codelineno-1-72" name="__codelineno-1-72" href="#__codelineno-1-72"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.551&quot;} 4</span>
-</span><span id="__span-1-73"><a id="__codelineno-1-73" name="__codelineno-1-73" href="#__codelineno-1-73"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.6010000000000001&quot;} 4</span>
-</span><span id="__span-1-74"><a id="__codelineno-1-74" name="__codelineno-1-74" href="#__codelineno-1-74"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.6510000000000001&quot;} 4</span>
-</span><span id="__span-1-75"><a id="__codelineno-1-75" name="__codelineno-1-75" href="#__codelineno-1-75"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.7010000000000002&quot;} 4</span>
-</span><span id="__span-1-76"><a id="__codelineno-1-76" name="__codelineno-1-76" href="#__codelineno-1-76"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.7510000000000002&quot;} 4</span>
-</span><span id="__span-1-77"><a id="__codelineno-1-77" name="__codelineno-1-77" href="#__codelineno-1-77"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.8010000000000003&quot;} 4</span>
-</span><span id="__span-1-78"><a id="__codelineno-1-78" name="__codelineno-1-78" href="#__codelineno-1-78"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.8510000000000003&quot;} 4</span>
-</span><span id="__span-1-79"><a id="__codelineno-1-79" name="__codelineno-1-79" href="#__codelineno-1-79"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.9010000000000004&quot;} 4</span>
-</span><span id="__span-1-80"><a id="__codelineno-1-80" name="__codelineno-1-80" href="#__codelineno-1-80"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;0.9510000000000004&quot;} 4</span>
-</span><span id="__span-1-81"><a id="__codelineno-1-81" name="__codelineno-1-81" href="#__codelineno-1-81"></a><span class="na">auth_server_evaluator_duration_seconds_bucket{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;,le=&quot;+Inf&quot;} 4</span>
-</span><span id="__span-1-82"><a id="__codelineno-1-82" name="__codelineno-1-82" href="#__codelineno-1-82"></a><span class="na">auth_server_evaluator_duration_seconds_sum{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;} 0.25800055</span>
-</span><span id="__span-1-83"><a id="__codelineno-1-83" name="__codelineno-1-83" href="#__codelineno-1-83"></a><span class="na">auth_server_evaluator_duration_seconds_count{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;} 4</span>
-</span><span id="__span-1-84"><a id="__codelineno-1-84" name="__codelineno-1-84" href="#__codelineno-1-84"></a><span class="c1"># HELP auth_server_evaluator_total Total number of evaluations of individual authconfig rule performed by the auth server.</span>
-</span><span id="__span-1-85"><a id="__codelineno-1-85" name="__codelineno-1-85" href="#__codelineno-1-85"></a><span class="c1"># TYPE auth_server_evaluator_total counter</span>
-</span><span id="__span-1-86"><a id="__codelineno-1-86" name="__codelineno-1-86" href="#__codelineno-1-86"></a><span class="na">auth_server_evaluator_total{authconfig</span><span class="o">=</span><span class="s">&quot;talker-api-protection&quot;,evaluator_name=&quot;geo&quot;,evaluator_type=&quot;METADATA_GENERIC_HTTP&quot;,namespace=&quot;authorino&quot;} 4</span>
-</span><span id="__span-1-87"><a id="__codelineno-1-87" name="__codelineno-1-87" href="#__codelineno-1-87"></a><span class="c1"># HELP auth_server_response_status Response status of authconfigs sent by the auth server.</span>
-</span><span id="__span-1-88"><a id="__codelineno-1-88" name="__codelineno-1-88" href="#__codelineno-1-88"></a><span class="c1"># TYPE auth_server_response_status counter</span>
-</span><span id="__span-1-89"><a id="__codelineno-1-89" name="__codelineno-1-89" href="#__codelineno-1-89"></a><span class="na">auth_server_response_status{status</span><span class="o">=</span><span class="s">&quot;NOT_FOUND&quot;} 1</span>
-</span><span id="__span-1-90"><a id="__codelineno-1-90" name="__codelineno-1-90" href="#__codelineno-1-90"></a><span class="na">auth_server_response_status{status</span><span class="o">=</span><span class="s">&quot;OK&quot;} 3</span>
-</span><span id="__span-1-91"><a id="__codelineno-1-91" name="__codelineno-1-91" href="#__codelineno-1-91"></a><span class="na">auth_server_response_status{status</span><span class="o">=</span><span class="s">&quot;PERMISSION_DENIED&quot;} 2</span>
-</span><span id="__span-1-92"><a id="__codelineno-1-92" name="__codelineno-1-92" href="#__codelineno-1-92"></a><span class="na">auth_server_response_status{status</span><span class="o">=</span><span class="s">&quot;UNAUTHENTICATED&quot;} 1</span>
-</span><span id="__span-1-93"><a id="__codelineno-1-93" name="__codelineno-1-93" href="#__codelineno-1-93"></a><span class="c1"># HELP go_gc_cycles_automatic_gc_cycles_total Count of completed GC cycles generated by the Go runtime.</span>
-</span><span id="__span-1-94"><a id="__codelineno-1-94" name="__codelineno-1-94" href="#__codelineno-1-94"></a><span class="c1"># TYPE go_gc_cycles_automatic_gc_cycles_total counter</span>
-</span><span id="__span-1-95"><a id="__codelineno-1-95" name="__codelineno-1-95" href="#__codelineno-1-95"></a><span class="na">go_gc_cycles_automatic_gc_cycles_total 11</span>
-</span><span id="__span-1-96"><a id="__codelineno-1-96" name="__codelineno-1-96" href="#__codelineno-1-96"></a><span class="c1"># HELP go_gc_cycles_forced_gc_cycles_total Count of completed GC cycles forced by the application.</span>
-</span><span id="__span-1-97"><a id="__codelineno-1-97" name="__codelineno-1-97" href="#__codelineno-1-97"></a><span class="c1"># TYPE go_gc_cycles_forced_gc_cycles_total counter</span>
-</span><span id="__span-1-98"><a id="__codelineno-1-98" name="__codelineno-1-98" href="#__codelineno-1-98"></a><span class="na">go_gc_cycles_forced_gc_cycles_total 0</span>
-</span><span id="__span-1-99"><a id="__codelineno-1-99" name="__codelineno-1-99" href="#__codelineno-1-99"></a><span class="c1"># HELP go_gc_cycles_total_gc_cycles_total Count of all completed GC cycles.</span>
-</span><span id="__span-1-100"><a id="__codelineno-1-100" name="__codelineno-1-100" href="#__codelineno-1-100"></a><span class="c1"># TYPE go_gc_cycles_total_gc_cycles_total counter</span>
-</span><span id="__span-1-101"><a id="__codelineno-1-101" name="__codelineno-1-101" href="#__codelineno-1-101"></a><span class="na">go_gc_cycles_total_gc_cycles_total 11</span>
-</span><span id="__span-1-102"><a id="__codelineno-1-102" name="__codelineno-1-102" href="#__codelineno-1-102"></a><span class="c1"># HELP go_gc_duration_seconds A summary of the pause duration of garbage collection cycles.</span>
-</span><span id="__span-1-103"><a id="__codelineno-1-103" name="__codelineno-1-103" href="#__codelineno-1-103"></a><span class="c1"># TYPE go_gc_duration_seconds summary</span>
-</span><span id="__span-1-104"><a id="__codelineno-1-104" name="__codelineno-1-104" href="#__codelineno-1-104"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;0&quot;} 4.5971e-05</span>
-</span><span id="__span-1-105"><a id="__codelineno-1-105" name="__codelineno-1-105" href="#__codelineno-1-105"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;0.25&quot;} 5.69e-05</span>
-</span><span id="__span-1-106"><a id="__codelineno-1-106" name="__codelineno-1-106" href="#__codelineno-1-106"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;0.5&quot;} 0.000158594</span>
-</span><span id="__span-1-107"><a id="__codelineno-1-107" name="__codelineno-1-107" href="#__codelineno-1-107"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;0.75&quot;} 0.000324091</span>
-</span><span id="__span-1-108"><a id="__codelineno-1-108" name="__codelineno-1-108" href="#__codelineno-1-108"></a><span class="na">go_gc_duration_seconds{quantile</span><span class="o">=</span><span class="s">&quot;1&quot;} 0.001692423</span>
-</span><span id="__span-1-109"><a id="__codelineno-1-109" name="__codelineno-1-109" href="#__codelineno-1-109"></a><span class="na">go_gc_duration_seconds_sum 0.003546711</span>
-</span><span id="__span-1-110"><a id="__codelineno-1-110" name="__codelineno-1-110" href="#__codelineno-1-110"></a><span class="na">go_gc_duration_seconds_count 11</span>
-</span><span id="__span-1-111"><a id="__codelineno-1-111" name="__codelineno-1-111" href="#__codelineno-1-111"></a><span class="c1"># HELP go_gc_heap_allocs_by_size_bytes_total Distribution of heap allocations by approximate size. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.</span>
-</span><span id="__span-1-112"><a id="__codelineno-1-112" name="__codelineno-1-112" href="#__codelineno-1-112"></a><span class="c1"># TYPE go_gc_heap_allocs_by_size_bytes_total histogram</span>
-</span><span id="__span-1-113"><a id="__codelineno-1-113" name="__codelineno-1-113" href="#__codelineno-1-113"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;8.999999999999998&quot;} 6261</span>
-</span><span id="__span-1-114"><a id="__codelineno-1-114" name="__codelineno-1-114" href="#__codelineno-1-114"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;16.999999999999996&quot;} 42477</span>
-</span><span id="__span-1-115"><a id="__codelineno-1-115" name="__codelineno-1-115" href="#__codelineno-1-115"></a><span class="k">[...]</span>
-</span><span id="__span-1-116"><a id="__codelineno-1-116" name="__codelineno-1-116" href="#__codelineno-1-116"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;32768.99999999999&quot;} 122133</span>
-</span><span id="__span-1-117"><a id="__codelineno-1-117" name="__codelineno-1-117" href="#__codelineno-1-117"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;+Inf&quot;} 122154</span>
-</span><span id="__span-1-118"><a id="__codelineno-1-118" name="__codelineno-1-118" href="#__codelineno-1-118"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_sum 1.455944e+07</span>
-</span><span id="__span-1-119"><a id="__codelineno-1-119" name="__codelineno-1-119" href="#__codelineno-1-119"></a><span class="na">go_gc_heap_allocs_by_size_bytes_total_count 122154</span>
-</span><span id="__span-1-120"><a id="__codelineno-1-120" name="__codelineno-1-120" href="#__codelineno-1-120"></a><span class="c1"># HELP go_gc_heap_allocs_bytes_total Cumulative sum of memory allocated to the heap by the application.</span>
-</span><span id="__span-1-121"><a id="__codelineno-1-121" name="__codelineno-1-121" href="#__codelineno-1-121"></a><span class="c1"># TYPE go_gc_heap_allocs_bytes_total counter</span>
-</span><span id="__span-1-122"><a id="__codelineno-1-122" name="__codelineno-1-122" href="#__codelineno-1-122"></a><span class="na">go_gc_heap_allocs_bytes_total 1.455944e+07</span>
-</span><span id="__span-1-123"><a id="__codelineno-1-123" name="__codelineno-1-123" href="#__codelineno-1-123"></a><span class="c1"># HELP go_gc_heap_allocs_objects_total Cumulative count of heap allocations triggered by the application. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.</span>
-</span><span id="__span-1-124"><a id="__codelineno-1-124" name="__codelineno-1-124" href="#__codelineno-1-124"></a><span class="c1"># TYPE go_gc_heap_allocs_objects_total counter</span>
-</span><span id="__span-1-125"><a id="__codelineno-1-125" name="__codelineno-1-125" href="#__codelineno-1-125"></a><span class="na">go_gc_heap_allocs_objects_total 122154</span>
-</span><span id="__span-1-126"><a id="__codelineno-1-126" name="__codelineno-1-126" href="#__codelineno-1-126"></a><span class="c1"># HELP go_gc_heap_frees_by_size_bytes_total Distribution of freed heap allocations by approximate size. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.</span>
-</span><span id="__span-1-127"><a id="__codelineno-1-127" name="__codelineno-1-127" href="#__codelineno-1-127"></a><span class="c1"># TYPE go_gc_heap_frees_by_size_bytes_total histogram</span>
-</span><span id="__span-1-128"><a id="__codelineno-1-128" name="__codelineno-1-128" href="#__codelineno-1-128"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;8.999999999999998&quot;} 3789</span>
-</span><span id="__span-1-129"><a id="__codelineno-1-129" name="__codelineno-1-129" href="#__codelineno-1-129"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;16.999999999999996&quot;} 31067</span>
-</span><span id="__span-1-130"><a id="__codelineno-1-130" name="__codelineno-1-130" href="#__codelineno-1-130"></a><span class="k">[...]</span>
-</span><span id="__span-1-131"><a id="__codelineno-1-131" name="__codelineno-1-131" href="#__codelineno-1-131"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;32768.99999999999&quot;} 91013</span>
-</span><span id="__span-1-132"><a id="__codelineno-1-132" name="__codelineno-1-132" href="#__codelineno-1-132"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_bucket{le</span><span class="o">=</span><span class="s">&quot;+Inf&quot;} 91021</span>
-</span><span id="__span-1-133"><a id="__codelineno-1-133" name="__codelineno-1-133" href="#__codelineno-1-133"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_sum 9.399936e+06</span>
-</span><span id="__span-1-134"><a id="__codelineno-1-134" name="__codelineno-1-134" href="#__codelineno-1-134"></a><span class="na">go_gc_heap_frees_by_size_bytes_total_count 91021</span>
-</span><span id="__span-1-135"><a id="__codelineno-1-135" name="__codelineno-1-135" href="#__codelineno-1-135"></a><span class="c1"># HELP go_gc_heap_frees_bytes_total Cumulative sum of heap memory freed by the garbage collector.</span>
-</span><span id="__span-1-136"><a id="__codelineno-1-136" name="__codelineno-1-136" href="#__codelineno-1-136"></a><span class="c1"># TYPE go_gc_heap_frees_bytes_total counter</span>
-</span><span id="__span-1-137"><a id="__codelineno-1-137" name="__codelineno-1-137" href="#__codelineno-1-137"></a><span class="na">go_gc_heap_frees_bytes_total 9.399936e+06</span>
-</span><span id="__span-1-138"><a id="__codelineno-1-138" name="__codelineno-1-138" href="#__codelineno-1-138"></a><span class="c1"># HELP go_gc_heap_frees_objects_total Cumulative count of heap allocations whose storage was freed by the garbage collector. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.</span>
-</span><span id="__span-1-139"><a id="__codelineno-1-139" name="__codelineno-1-139" href="#__codelineno-1-139"></a><span class="c1"># TYPE go_gc_heap_frees_objects_total counter</span>
-</span><span id="__span-1-140"><a id="__codelineno-1-140" name="__codelineno-1-140" href="#__codelineno-1-140"></a><span class="na">go_gc_heap_frees_objects_total 91021</span>
-</span><span id="__span-1-141"><a id="__codelineno-1-141" name="__codelineno-1-141" href="#__codelineno-1-141"></a><span class="c1"># HELP go_gc_heap_goal_bytes Heap size target for the end of the GC cycle.</span>
-</span><span id="__span-1-142"><a id="__codelineno-1-142" name="__codelineno-1-142" href="#__codelineno-1-142"></a><span class="c1"># TYPE go_gc_heap_goal_bytes gauge</span>
-</span><span id="__span-1-143"><a id="__codelineno-1-143" name="__codelineno-1-143" href="#__codelineno-1-143"></a><span class="na">go_gc_heap_goal_bytes 9.601744e+06</span>
-</span><span id="__span-1-144"><a id="__codelineno-1-144" name="__codelineno-1-144" href="#__codelineno-1-144"></a><span class="c1"># HELP go_gc_heap_objects_objects Number of objects, live or unswept, occupying heap memory.</span>
-</span><span id="__span-1-145"><a id="__codelineno-1-145" name="__codelineno-1-145" href="#__codelineno-1-145"></a><span class="c1"># TYPE go_gc_heap_objects_objects gauge</span>
-</span><span id="__span-1-146"><a id="__codelineno-1-146" name="__codelineno-1-146" href="#__codelineno-1-146"></a><span class="na">go_gc_heap_objects_objects 31133</span>
-</span><span id="__span-1-147"><a id="__codelineno-1-147" name="__codelineno-1-147" href="#__codelineno-1-147"></a><span class="c1"># HELP go_gc_heap_tiny_allocs_objects_total Count of small allocations that are packed together into blocks. These allocations are counted separately from other allocations because each individual allocation is not tracked by the runtime, only their block. Each block is already accounted for in allocs-by-size and frees-by-size.</span>
-</span><span id="__span-1-148"><a id="__codelineno-1-148" name="__codelineno-1-148" href="#__codelineno-1-148"></a><span class="c1"># TYPE go_gc_heap_tiny_allocs_objects_total counter</span>
-</span><span id="__span-1-149"><a id="__codelineno-1-149" name="__codelineno-1-149" href="#__codelineno-1-149"></a><span class="na">go_gc_heap_tiny_allocs_objects_total 9866</span>
-</span><span id="__span-1-150"><a id="__codelineno-1-150" name="__codelineno-1-150" href="#__codelineno-1-150"></a><span class="c1"># HELP go_gc_pauses_seconds_total Distribution individual GC-related stop-the-world pause latencies.</span>
-</span><span id="__span-1-151"><a id="__codelineno-1-151" name="__codelineno-1-151" href="#__codelineno-1-151"></a><span class="c1"># TYPE go_gc_pauses_seconds_total histogram</span>
-</span><span id="__span-1-152"><a id="__codelineno-1-152" name="__codelineno-1-152" href="#__codelineno-1-152"></a><span class="na">go_gc_pauses_seconds_total_bucket{le</span><span class="o">=</span><span class="s">&quot;9.999999999999999e-10&quot;} 0</span>
-</span><span id="__span-1-153"><a id="__codelineno-1-153" name="__codelineno-1-153" href="#__codelineno-1-153"></a><span class="na">go_gc_pauses_seconds_total_bucket{le</span><span class="o">=</span><span class="s">&quot;1.9999999999999997e-09&quot;} 0</span>
-</span><span id="__span-1-154"><a id="__codelineno-1-154" name="__codelineno-1-154" href="#__codelineno-1-154"></a><span class="k">[...]</span>
-</span><span id="__span-1-155"><a id="__codelineno-1-155" name="__codelineno-1-155" href="#__codelineno-1-155"></a><span class="na">go_gc_pauses_seconds_total_bucket{le</span><span class="o">=</span><span class="s">&quot;206708.18602188796&quot;} 22</span>
-</span><span id="__span-1-156"><a id="__codelineno-1-156" name="__codelineno-1-156" href="#__codelineno-1-156"></a><span class="na">go_gc_pauses_seconds_total_bucket{le</span><span class="o">=</span><span class="s">&quot;+Inf&quot;} 22</span>
-</span><span id="__span-1-157"><a id="__codelineno-1-157" name="__codelineno-1-157" href="#__codelineno-1-157"></a><span class="na">go_gc_pauses_seconds_total_sum 0.0030393599999999996</span>
-</span><span id="__span-1-158"><a id="__codelineno-1-158" name="__codelineno-1-158" href="#__codelineno-1-158"></a><span class="na">go_gc_pauses_seconds_total_count 22</span>
-</span><span id="__span-1-159"><a id="__codelineno-1-159" name="__codelineno-1-159" href="#__codelineno-1-159"></a><span class="c1"># HELP go_goroutines Number of goroutines that currently exist.</span>
-</span><span id="__span-1-160"><a id="__codelineno-1-160" name="__codelineno-1-160" href="#__codelineno-1-160"></a><span class="c1"># TYPE go_goroutines gauge</span>
-</span><span id="__span-1-161"><a id="__codelineno-1-161" name="__codelineno-1-161" href="#__codelineno-1-161"></a><span class="na">go_goroutines 79</span>
-</span><span id="__span-1-162"><a id="__codelineno-1-162" name="__codelineno-1-162" href="#__codelineno-1-162"></a><span class="c1"># HELP go_info Information about the Go environment.</span>
-</span><span id="__span-1-163"><a id="__codelineno-1-163" name="__codelineno-1-163" href="#__codelineno-1-163"></a><span class="c1"># TYPE go_info gauge</span>
-</span><span id="__span-1-164"><a id="__codelineno-1-164" name="__codelineno-1-164" href="#__codelineno-1-164"></a><span class="na">go_info{version</span><span class="o">=</span><span class="s">&quot;go1.18.7&quot;} 1</span>
-</span><span id="__span-1-165"><a id="__codelineno-1-165" name="__codelineno-1-165" href="#__codelineno-1-165"></a><span class="c1"># HELP go_memory_classes_heap_free_bytes Memory that is completely free and eligible to be returned to the underlying system, but has not been. This metric is the runtime&#39;s estimate of free address space that is backed by physical memory.</span>
-</span><span id="__span-1-166"><a id="__codelineno-1-166" name="__codelineno-1-166" href="#__codelineno-1-166"></a><span class="c1"># TYPE go_memory_classes_heap_free_bytes gauge</span>
-</span><span id="__span-1-167"><a id="__codelineno-1-167" name="__codelineno-1-167" href="#__codelineno-1-167"></a><span class="na">go_memory_classes_heap_free_bytes 630784</span>
-</span><span id="__span-1-168"><a id="__codelineno-1-168" name="__codelineno-1-168" href="#__codelineno-1-168"></a><span class="c1"># HELP go_memory_classes_heap_objects_bytes Memory occupied by live objects and dead objects that have not yet been marked free by the garbage collector.</span>
-</span><span id="__span-1-169"><a id="__codelineno-1-169" name="__codelineno-1-169" href="#__codelineno-1-169"></a><span class="c1"># TYPE go_memory_classes_heap_objects_bytes gauge</span>
-</span><span id="__span-1-170"><a id="__codelineno-1-170" name="__codelineno-1-170" href="#__codelineno-1-170"></a><span class="na">go_memory_classes_heap_objects_bytes 5.159504e+06</span>
-</span><span id="__span-1-171"><a id="__codelineno-1-171" name="__codelineno-1-171" href="#__codelineno-1-171"></a><span class="c1"># HELP go_memory_classes_heap_released_bytes Memory that is completely free and has been returned to the underlying system. This metric is the runtime&#39;s estimate of free address space that is still mapped into the process, but is not backed by physical memory.</span>
-</span><span id="__span-1-172"><a id="__codelineno-1-172" name="__codelineno-1-172" href="#__codelineno-1-172"></a><span class="c1"># TYPE go_memory_classes_heap_released_bytes gauge</span>
-</span><span id="__span-1-173"><a id="__codelineno-1-173" name="__codelineno-1-173" href="#__codelineno-1-173"></a><span class="na">go_memory_classes_heap_released_bytes 3.858432e+06</span>
-</span><span id="__span-1-174"><a id="__codelineno-1-174" name="__codelineno-1-174" href="#__codelineno-1-174"></a><span class="c1"># HELP go_memory_classes_heap_stacks_bytes Memory allocated from the heap that is reserved for stack space, whether or not it is currently in-use.</span>
-</span><span id="__span-1-175"><a id="__codelineno-1-175" name="__codelineno-1-175" href="#__codelineno-1-175"></a><span class="c1"># TYPE go_memory_classes_heap_stacks_bytes gauge</span>
-</span><span id="__span-1-176"><a id="__codelineno-1-176" name="__codelineno-1-176" href="#__codelineno-1-176"></a><span class="na">go_memory_classes_heap_stacks_bytes 786432</span>
-</span><span id="__span-1-177"><a id="__codelineno-1-177" name="__codelineno-1-177" href="#__codelineno-1-177"></a><span class="c1"># HELP go_memory_classes_heap_unused_bytes Memory that is reserved for heap objects but is not currently used to hold heap objects.</span>
-</span><span id="__span-1-178"><a id="__codelineno-1-178" name="__codelineno-1-178" href="#__codelineno-1-178"></a><span class="c1"># TYPE go_memory_classes_heap_unused_bytes gauge</span>
-</span><span id="__span-1-179"><a id="__codelineno-1-179" name="__codelineno-1-179" href="#__codelineno-1-179"></a><span class="na">go_memory_classes_heap_unused_bytes 2.14776e+06</span>
-</span><span id="__span-1-180"><a id="__codelineno-1-180" name="__codelineno-1-180" href="#__codelineno-1-180"></a><span class="c1"># HELP go_memory_classes_metadata_mcache_free_bytes Memory that is reserved for runtime mcache structures, but not in-use.</span>
-</span><span id="__span-1-181"><a id="__codelineno-1-181" name="__codelineno-1-181" href="#__codelineno-1-181"></a><span class="c1"># TYPE go_memory_classes_metadata_mcache_free_bytes gauge</span>
-</span><span id="__span-1-182"><a id="__codelineno-1-182" name="__codelineno-1-182" href="#__codelineno-1-182"></a><span class="na">go_memory_classes_metadata_mcache_free_bytes 13984</span>
-</span><span id="__span-1-183"><a id="__codelineno-1-183" name="__codelineno-1-183" href="#__codelineno-1-183"></a><span class="c1"># HELP go_memory_classes_metadata_mcache_inuse_bytes Memory that is occupied by runtime mcache structures that are currently being used.</span>
-</span><span id="__span-1-184"><a id="__codelineno-1-184" name="__codelineno-1-184" href="#__codelineno-1-184"></a><span class="c1"># TYPE go_memory_classes_metadata_mcache_inuse_bytes gauge</span>
-</span><span id="__span-1-185"><a id="__codelineno-1-185" name="__codelineno-1-185" href="#__codelineno-1-185"></a><span class="na">go_memory_classes_metadata_mcache_inuse_bytes 2400</span>
-</span><span id="__span-1-186"><a id="__codelineno-1-186" name="__codelineno-1-186" href="#__codelineno-1-186"></a><span class="c1"># HELP go_memory_classes_metadata_mspan_free_bytes Memory that is reserved for runtime mspan structures, but not in-use.</span>
-</span><span id="__span-1-187"><a id="__codelineno-1-187" name="__codelineno-1-187" href="#__codelineno-1-187"></a><span class="c1"># TYPE go_memory_classes_metadata_mspan_free_bytes gauge</span>
-</span><span id="__span-1-188"><a id="__codelineno-1-188" name="__codelineno-1-188" href="#__codelineno-1-188"></a><span class="na">go_memory_classes_metadata_mspan_free_bytes 16696</span>
-</span><span id="__span-1-189"><a id="__codelineno-1-189" name="__codelineno-1-189" href="#__codelineno-1-189"></a><span class="c1"># HELP go_memory_classes_metadata_mspan_inuse_bytes Memory that is occupied by runtime mspan structures that are currently being used.</span>
-</span><span id="__span-1-190"><a id="__codelineno-1-190" name="__codelineno-1-190" href="#__codelineno-1-190"></a><span class="c1"># TYPE go_memory_classes_metadata_mspan_inuse_bytes gauge</span>
-</span><span id="__span-1-191"><a id="__codelineno-1-191" name="__codelineno-1-191" href="#__codelineno-1-191"></a><span class="na">go_memory_classes_metadata_mspan_inuse_bytes 114376</span>
-</span><span id="__span-1-192"><a id="__codelineno-1-192" name="__codelineno-1-192" href="#__codelineno-1-192"></a><span class="c1"># HELP go_memory_classes_metadata_other_bytes Memory that is reserved for or used to hold runtime metadata.</span>
-</span><span id="__span-1-193"><a id="__codelineno-1-193" name="__codelineno-1-193" href="#__codelineno-1-193"></a><span class="c1"># TYPE go_memory_classes_metadata_other_bytes gauge</span>
-</span><span id="__span-1-194"><a id="__codelineno-1-194" name="__codelineno-1-194" href="#__codelineno-1-194"></a><span class="na">go_memory_classes_metadata_other_bytes 5.544408e+06</span>
-</span><span id="__span-1-195"><a id="__codelineno-1-195" name="__codelineno-1-195" href="#__codelineno-1-195"></a><span class="c1"># HELP go_memory_classes_os_stacks_bytes Stack memory allocated by the underlying operating system.</span>
-</span><span id="__span-1-196"><a id="__codelineno-1-196" name="__codelineno-1-196" href="#__codelineno-1-196"></a><span class="c1"># TYPE go_memory_classes_os_stacks_bytes gauge</span>
-</span><span id="__span-1-197"><a id="__codelineno-1-197" name="__codelineno-1-197" href="#__codelineno-1-197"></a><span class="na">go_memory_classes_os_stacks_bytes 0</span>
-</span><span id="__span-1-198"><a id="__codelineno-1-198" name="__codelineno-1-198" href="#__codelineno-1-198"></a><span class="c1"># HELP go_memory_classes_other_bytes Memory used by execution trace buffers, structures for debugging the runtime, finalizer and profiler specials, and more.</span>
-</span><span id="__span-1-199"><a id="__codelineno-1-199" name="__codelineno-1-199" href="#__codelineno-1-199"></a><span class="c1"># TYPE go_memory_classes_other_bytes gauge</span>
-</span><span id="__span-1-200"><a id="__codelineno-1-200" name="__codelineno-1-200" href="#__codelineno-1-200"></a><span class="na">go_memory_classes_other_bytes 537777</span>
-</span><span id="__span-1-201"><a id="__codelineno-1-201" name="__codelineno-1-201" href="#__codelineno-1-201"></a><span class="c1"># HELP go_memory_classes_profiling_buckets_bytes Memory that is used by the stack trace hash map used for profiling.</span>
-</span><span id="__span-1-202"><a id="__codelineno-1-202" name="__codelineno-1-202" href="#__codelineno-1-202"></a><span class="c1"># TYPE go_memory_classes_profiling_buckets_bytes gauge</span>
-</span><span id="__span-1-203"><a id="__codelineno-1-203" name="__codelineno-1-203" href="#__codelineno-1-203"></a><span class="na">go_memory_classes_profiling_buckets_bytes 1.455487e+06</span>
-</span><span id="__span-1-204"><a id="__codelineno-1-204" name="__codelineno-1-204" href="#__codelineno-1-204"></a><span class="c1"># HELP go_memory_classes_total_bytes All memory mapped by the Go runtime into the current process as read-write. Note that this does not include memory mapped by code called via cgo or via the syscall package. Sum of all metrics in /memory/classes.</span>
-</span><span id="__span-1-205"><a id="__codelineno-1-205" name="__codelineno-1-205" href="#__codelineno-1-205"></a><span class="c1"># TYPE go_memory_classes_total_bytes gauge</span>
-</span><span id="__span-1-206"><a id="__codelineno-1-206" name="__codelineno-1-206" href="#__codelineno-1-206"></a><span class="na">go_memory_classes_total_bytes 2.026804e+07</span>
-</span><span id="__span-1-207"><a id="__codelineno-1-207" name="__codelineno-1-207" href="#__codelineno-1-207"></a><span class="c1"># HELP go_memstats_alloc_bytes Number of bytes allocated and still in use.</span>
-</span><span id="__span-1-208"><a id="__codelineno-1-208" name="__codelineno-1-208" href="#__codelineno-1-208"></a><span class="c1"># TYPE go_memstats_alloc_bytes gauge</span>
-</span><span id="__span-1-209"><a id="__codelineno-1-209" name="__codelineno-1-209" href="#__codelineno-1-209"></a><span class="na">go_memstats_alloc_bytes 5.159504e+06</span>
-</span><span id="__span-1-210"><a id="__codelineno-1-210" name="__codelineno-1-210" href="#__codelineno-1-210"></a><span class="c1"># HELP go_memstats_alloc_bytes_total Total number of bytes allocated, even if freed.</span>
-</span><span id="__span-1-211"><a id="__codelineno-1-211" name="__codelineno-1-211" href="#__codelineno-1-211"></a><span class="c1"># TYPE go_memstats_alloc_bytes_total counter</span>
-</span><span id="__span-1-212"><a id="__codelineno-1-212" name="__codelineno-1-212" href="#__codelineno-1-212"></a><span class="na">go_memstats_alloc_bytes_total 1.455944e+07</span>
-</span><span id="__span-1-213"><a id="__codelineno-1-213" name="__codelineno-1-213" href="#__codelineno-1-213"></a><span class="c1"># HELP go_memstats_buck_hash_sys_bytes Number of bytes used by the profiling bucket hash table.</span>
-</span><span id="__span-1-214"><a id="__codelineno-1-214" name="__codelineno-1-214" href="#__codelineno-1-214"></a><span class="c1"># TYPE go_memstats_buck_hash_sys_bytes gauge</span>
-</span><span id="__span-1-215"><a id="__codelineno-1-215" name="__codelineno-1-215" href="#__codelineno-1-215"></a><span class="na">go_memstats_buck_hash_sys_bytes 1.455487e+06</span>
-</span><span id="__span-1-216"><a id="__codelineno-1-216" name="__codelineno-1-216" href="#__codelineno-1-216"></a><span class="c1"># HELP go_memstats_frees_total Total number of frees.</span>
-</span><span id="__span-1-217"><a id="__codelineno-1-217" name="__codelineno-1-217" href="#__codelineno-1-217"></a><span class="c1"># TYPE go_memstats_frees_total counter</span>
-</span><span id="__span-1-218"><a id="__codelineno-1-218" name="__codelineno-1-218" href="#__codelineno-1-218"></a><span class="na">go_memstats_frees_total 100887</span>
-</span><span id="__span-1-219"><a id="__codelineno-1-219" name="__codelineno-1-219" href="#__codelineno-1-219"></a><span class="c1"># HELP go_memstats_gc_cpu_fraction The fraction of this program&#39;s available CPU time used by the GC since the program started.</span>
-</span><span id="__span-1-220"><a id="__codelineno-1-220" name="__codelineno-1-220" href="#__codelineno-1-220"></a><span class="c1"># TYPE go_memstats_gc_cpu_fraction gauge</span>
-</span><span id="__span-1-221"><a id="__codelineno-1-221" name="__codelineno-1-221" href="#__codelineno-1-221"></a><span class="na">go_memstats_gc_cpu_fraction 0</span>
-</span><span id="__span-1-222"><a id="__codelineno-1-222" name="__codelineno-1-222" href="#__codelineno-1-222"></a><span class="c1"># HELP go_memstats_gc_sys_bytes Number of bytes used for garbage collection system metadata.</span>
-</span><span id="__span-1-223"><a id="__codelineno-1-223" name="__codelineno-1-223" href="#__codelineno-1-223"></a><span class="c1"># TYPE go_memstats_gc_sys_bytes gauge</span>
-</span><span id="__span-1-224"><a id="__codelineno-1-224" name="__codelineno-1-224" href="#__codelineno-1-224"></a><span class="na">go_memstats_gc_sys_bytes 5.544408e+06</span>
-</span><span id="__span-1-225"><a id="__codelineno-1-225" name="__codelineno-1-225" href="#__codelineno-1-225"></a><span class="c1"># HELP go_memstats_heap_alloc_bytes Number of heap bytes allocated and still in use.</span>
-</span><span id="__span-1-226"><a id="__codelineno-1-226" name="__codelineno-1-226" href="#__codelineno-1-226"></a><span class="c1"># TYPE go_memstats_heap_alloc_bytes gauge</span>
-</span><span id="__span-1-227"><a id="__codelineno-1-227" name="__codelineno-1-227" href="#__codelineno-1-227"></a><span class="na">go_memstats_heap_alloc_bytes 5.159504e+06</span>
-</span><span id="__span-1-228"><a id="__codelineno-1-228" name="__codelineno-1-228" href="#__codelineno-1-228"></a><span class="c1"># HELP go_memstats_heap_idle_bytes Number of heap bytes waiting to be used.</span>
-</span><span id="__span-1-229"><a id="__codelineno-1-229" name="__codelineno-1-229" href="#__codelineno-1-229"></a><span class="c1"># TYPE go_memstats_heap_idle_bytes gauge</span>
-</span><span id="__span-1-230"><a id="__codelineno-1-230" name="__codelineno-1-230" href="#__codelineno-1-230"></a><span class="na">go_memstats_heap_idle_bytes 4.489216e+06</span>
-</span><span id="__span-1-231"><a id="__codelineno-1-231" name="__codelineno-1-231" href="#__codelineno-1-231"></a><span class="c1"># HELP go_memstats_heap_inuse_bytes Number of heap bytes that are in use.</span>
-</span><span id="__span-1-232"><a id="__codelineno-1-232" name="__codelineno-1-232" href="#__codelineno-1-232"></a><span class="c1"># TYPE go_memstats_heap_inuse_bytes gauge</span>
-</span><span id="__span-1-233"><a id="__codelineno-1-233" name="__codelineno-1-233" href="#__codelineno-1-233"></a><span class="na">go_memstats_heap_inuse_bytes 7.307264e+06</span>
-</span><span id="__span-1-234"><a id="__codelineno-1-234" name="__codelineno-1-234" href="#__codelineno-1-234"></a><span class="c1"># HELP go_memstats_heap_objects Number of allocated objects.</span>
-</span><span id="__span-1-235"><a id="__codelineno-1-235" name="__codelineno-1-235" href="#__codelineno-1-235"></a><span class="c1"># TYPE go_memstats_heap_objects gauge</span>
-</span><span id="__span-1-236"><a id="__codelineno-1-236" name="__codelineno-1-236" href="#__codelineno-1-236"></a><span class="na">go_memstats_heap_objects 31133</span>
-</span><span id="__span-1-237"><a id="__codelineno-1-237" name="__codelineno-1-237" href="#__codelineno-1-237"></a><span class="c1"># HELP go_memstats_heap_released_bytes Number of heap bytes released to OS.</span>
-</span><span id="__span-1-238"><a id="__codelineno-1-238" name="__codelineno-1-238" href="#__codelineno-1-238"></a><span class="c1"># TYPE go_memstats_heap_released_bytes gauge</span>
-</span><span id="__span-1-239"><a id="__codelineno-1-239" name="__codelineno-1-239" href="#__codelineno-1-239"></a><span class="na">go_memstats_heap_released_bytes 3.858432e+06</span>
-</span><span id="__span-1-240"><a id="__codelineno-1-240" name="__codelineno-1-240" href="#__codelineno-1-240"></a><span class="c1"># HELP go_memstats_heap_sys_bytes Number of heap bytes obtained from system.</span>
-</span><span id="__span-1-241"><a id="__codelineno-1-241" name="__codelineno-1-241" href="#__codelineno-1-241"></a><span class="c1"># TYPE go_memstats_heap_sys_bytes gauge</span>
-</span><span id="__span-1-242"><a id="__codelineno-1-242" name="__codelineno-1-242" href="#__codelineno-1-242"></a><span class="na">go_memstats_heap_sys_bytes 1.179648e+07</span>
-</span><span id="__span-1-243"><a id="__codelineno-1-243" name="__codelineno-1-243" href="#__codelineno-1-243"></a><span class="c1"># HELP go_memstats_last_gc_time_seconds Number of seconds since 1970 of last garbage collection.</span>
-</span><span id="__span-1-244"><a id="__codelineno-1-244" name="__codelineno-1-244" href="#__codelineno-1-244"></a><span class="c1"># TYPE go_memstats_last_gc_time_seconds gauge</span>
-</span><span id="__span-1-245"><a id="__codelineno-1-245" name="__codelineno-1-245" href="#__codelineno-1-245"></a><span class="na">go_memstats_last_gc_time_seconds 1.6461569717723043e+09</span>
-</span><span id="__span-1-246"><a id="__codelineno-1-246" name="__codelineno-1-246" href="#__codelineno-1-246"></a><span class="c1"># HELP go_memstats_lookups_total Total number of pointer lookups.</span>
-</span><span id="__span-1-247"><a id="__codelineno-1-247" name="__codelineno-1-247" href="#__codelineno-1-247"></a><span class="c1"># TYPE go_memstats_lookups_total counter</span>
-</span><span id="__span-1-248"><a id="__codelineno-1-248" name="__codelineno-1-248" href="#__codelineno-1-248"></a><span class="na">go_memstats_lookups_total 0</span>
-</span><span id="__span-1-249"><a id="__codelineno-1-249" name="__codelineno-1-249" href="#__codelineno-1-249"></a><span class="c1"># HELP go_memstats_mallocs_total Total number of mallocs.</span>
-</span><span id="__span-1-250"><a id="__codelineno-1-250" name="__codelineno-1-250" href="#__codelineno-1-250"></a><span class="c1"># TYPE go_memstats_mallocs_total counter</span>
-</span><span id="__span-1-251"><a id="__codelineno-1-251" name="__codelineno-1-251" href="#__codelineno-1-251"></a><span class="na">go_memstats_mallocs_total 132020</span>
-</span><span id="__span-1-252"><a id="__codelineno-1-252" name="__codelineno-1-252" href="#__codelineno-1-252"></a><span class="c1"># HELP go_memstats_mcache_inuse_bytes Number of bytes in use by mcache structures.</span>
-</span><span id="__span-1-253"><a id="__codelineno-1-253" name="__codelineno-1-253" href="#__codelineno-1-253"></a><span class="c1"># TYPE go_memstats_mcache_inuse_bytes gauge</span>
-</span><span id="__span-1-254"><a id="__codelineno-1-254" name="__codelineno-1-254" href="#__codelineno-1-254"></a><span class="na">go_memstats_mcache_inuse_bytes 2400</span>
-</span><span id="__span-1-255"><a id="__codelineno-1-255" name="__codelineno-1-255" href="#__codelineno-1-255"></a><span class="c1"># HELP go_memstats_mcache_sys_bytes Number of bytes used for mcache structures obtained from system.</span>
-</span><span id="__span-1-256"><a id="__codelineno-1-256" name="__codelineno-1-256" href="#__codelineno-1-256"></a><span class="c1"># TYPE go_memstats_mcache_sys_bytes gauge</span>
-</span><span id="__span-1-257"><a id="__codelineno-1-257" name="__codelineno-1-257" href="#__codelineno-1-257"></a><span class="na">go_memstats_mcache_sys_bytes 16384</span>
-</span><span id="__span-1-258"><a id="__codelineno-1-258" name="__codelineno-1-258" href="#__codelineno-1-258"></a><span class="c1"># HELP go_memstats_mspan_inuse_bytes Number of bytes in use by mspan structures.</span>
-</span><span id="__span-1-259"><a id="__codelineno-1-259" name="__codelineno-1-259" href="#__codelineno-1-259"></a><span class="c1"># TYPE go_memstats_mspan_inuse_bytes gauge</span>
-</span><span id="__span-1-260"><a id="__codelineno-1-260" name="__codelineno-1-260" href="#__codelineno-1-260"></a><span class="na">go_memstats_mspan_inuse_bytes 114376</span>
-</span><span id="__span-1-261"><a id="__codelineno-1-261" name="__codelineno-1-261" href="#__codelineno-1-261"></a><span class="c1"># HELP go_memstats_mspan_sys_bytes Number of bytes used for mspan structures obtained from system.</span>
-</span><span id="__span-1-262"><a id="__codelineno-1-262" name="__codelineno-1-262" href="#__codelineno-1-262"></a><span class="c1"># TYPE go_memstats_mspan_sys_bytes gauge</span>
-</span><span id="__span-1-263"><a id="__codelineno-1-263" name="__codelineno-1-263" href="#__codelineno-1-263"></a><span class="na">go_memstats_mspan_sys_bytes 131072</span>
-</span><span id="__span-1-264"><a id="__codelineno-1-264" name="__codelineno-1-264" href="#__codelineno-1-264"></a><span class="c1"># HELP go_memstats_next_gc_bytes Number of heap bytes when next garbage collection will take place.</span>
-</span><span id="__span-1-265"><a id="__codelineno-1-265" name="__codelineno-1-265" href="#__codelineno-1-265"></a><span class="c1"># TYPE go_memstats_next_gc_bytes gauge</span>
-</span><span id="__span-1-266"><a id="__codelineno-1-266" name="__codelineno-1-266" href="#__codelineno-1-266"></a><span class="na">go_memstats_next_gc_bytes 9.601744e+06</span>
-</span><span id="__span-1-267"><a id="__codelineno-1-267" name="__codelineno-1-267" href="#__codelineno-1-267"></a><span class="c1"># HELP go_memstats_other_sys_bytes Number of bytes used for other system allocations.</span>
-</span><span id="__span-1-268"><a id="__codelineno-1-268" name="__codelineno-1-268" href="#__codelineno-1-268"></a><span class="c1"># TYPE go_memstats_other_sys_bytes gauge</span>
-</span><span id="__span-1-269"><a id="__codelineno-1-269" name="__codelineno-1-269" href="#__codelineno-1-269"></a><span class="na">go_memstats_other_sys_bytes 537777</span>
-</span><span id="__span-1-270"><a id="__codelineno-1-270" name="__codelineno-1-270" href="#__codelineno-1-270"></a><span class="c1"># HELP go_memstats_stack_inuse_bytes Number of bytes in use by the stack allocator.</span>
-</span><span id="__span-1-271"><a id="__codelineno-1-271" name="__codelineno-1-271" href="#__codelineno-1-271"></a><span class="c1"># TYPE go_memstats_stack_inuse_bytes gauge</span>
-</span><span id="__span-1-272"><a id="__codelineno-1-272" name="__codelineno-1-272" href="#__codelineno-1-272"></a><span class="na">go_memstats_stack_inuse_bytes 786432</span>
-</span><span id="__span-1-273"><a id="__codelineno-1-273" name="__codelineno-1-273" href="#__codelineno-1-273"></a><span class="c1"># HELP go_memstats_stack_sys_bytes Number of bytes obtained from system for stack allocator.</span>
-</span><span id="__span-1-274"><a id="__codelineno-1-274" name="__codelineno-1-274" href="#__codelineno-1-274"></a><span class="c1"># TYPE go_memstats_stack_sys_bytes gauge</span>
-</span><span id="__span-1-275"><a id="__codelineno-1-275" name="__codelineno-1-275" href="#__codelineno-1-275"></a><span class="na">go_memstats_stack_sys_bytes 786432</span>
-</span><span id="__span-1-276"><a id="__codelineno-1-276" name="__codelineno-1-276" href="#__codelineno-1-276"></a><span class="c1"># HELP go_memstats_sys_bytes Number of bytes obtained from system.</span>
-</span><span id="__span-1-277"><a id="__codelineno-1-277" name="__codelineno-1-277" href="#__codelineno-1-277"></a><span class="c1"># TYPE go_memstats_sys_bytes gauge</span>
-</span><span id="__span-1-278"><a id="__codelineno-1-278" name="__codelineno-1-278" href="#__codelineno-1-278"></a><span class="na">go_memstats_sys_bytes 2.026804e+07</span>
-</span><span id="__span-1-279"><a id="__codelineno-1-279" name="__codelineno-1-279" href="#__codelineno-1-279"></a><span class="c1"># HELP go_sched_goroutines_goroutines Count of live goroutines.</span>
-</span><span id="__span-1-280"><a id="__codelineno-1-280" name="__codelineno-1-280" href="#__codelineno-1-280"></a><span class="c1"># TYPE go_sched_goroutines_goroutines gauge</span>
-</span><span id="__span-1-281"><a id="__codelineno-1-281" name="__codelineno-1-281" href="#__codelineno-1-281"></a><span class="na">go_sched_goroutines_goroutines 79</span>
-</span><span id="__span-1-282"><a id="__codelineno-1-282" name="__codelineno-1-282" href="#__codelineno-1-282"></a><span class="c1"># HELP go_sched_latencies_seconds Distribution of the time goroutines have spent in the scheduler in a runnable state before actually running.</span>
-</span><span id="__span-1-283"><a id="__codelineno-1-283" name="__codelineno-1-283" href="#__codelineno-1-283"></a><span class="c1"># TYPE go_sched_latencies_seconds histogram</span>
-</span><span id="__span-1-284"><a id="__codelineno-1-284" name="__codelineno-1-284" href="#__codelineno-1-284"></a><span class="na">go_sched_latencies_seconds_bucket{le</span><span class="o">=</span><span class="s">&quot;9.999999999999999e-10&quot;} 225</span>
-</span><span id="__span-1-285"><a id="__codelineno-1-285" name="__codelineno-1-285" href="#__codelineno-1-285"></a><span class="na">go_sched_latencies_seconds_bucket{le</span><span class="o">=</span><span class="s">&quot;1.9999999999999997e-09&quot;} 225</span>
-</span><span id="__span-1-286"><a id="__codelineno-1-286" name="__codelineno-1-286" href="#__codelineno-1-286"></a><span class="k">[...]</span>
-</span><span id="__span-1-287"><a id="__codelineno-1-287" name="__codelineno-1-287" href="#__codelineno-1-287"></a><span class="na">go_sched_latencies_seconds_bucket{le</span><span class="o">=</span><span class="s">&quot;206708.18602188796&quot;} 1916</span>
-</span><span id="__span-1-288"><a id="__codelineno-1-288" name="__codelineno-1-288" href="#__codelineno-1-288"></a><span class="na">go_sched_latencies_seconds_bucket{le</span><span class="o">=</span><span class="s">&quot;+Inf&quot;} 1916</span>
-</span><span id="__span-1-289"><a id="__codelineno-1-289" name="__codelineno-1-289" href="#__codelineno-1-289"></a><span class="na">go_sched_latencies_seconds_sum 0.18081453600000003</span>
-</span><span id="__span-1-290"><a id="__codelineno-1-290" name="__codelineno-1-290" href="#__codelineno-1-290"></a><span class="na">go_sched_latencies_seconds_count 1916</span>
-</span><span id="__span-1-291"><a id="__codelineno-1-291" name="__codelineno-1-291" href="#__codelineno-1-291"></a><span class="c1"># HELP go_threads Number of OS threads created.</span>
-</span><span id="__span-1-292"><a id="__codelineno-1-292" name="__codelineno-1-292" href="#__codelineno-1-292"></a><span class="c1"># TYPE go_threads gauge</span>
-</span><span id="__span-1-293"><a id="__codelineno-1-293" name="__codelineno-1-293" href="#__codelineno-1-293"></a><span class="na">go_threads 8</span>
-</span><span id="__span-1-294"><a id="__codelineno-1-294" name="__codelineno-1-294" href="#__codelineno-1-294"></a><span class="c1"># HELP grpc_server_handled_total Total number of RPCs completed on the server, regardless of success or failure.</span>
-</span><span id="__span-1-295"><a id="__codelineno-1-295" name="__codelineno-1-295" href="#__codelineno-1-295"></a><span class="c1"># TYPE grpc_server_handled_total counter</span>
-</span><span id="__span-1-296"><a id="__codelineno-1-296" name="__codelineno-1-296" href="#__codelineno-1-296"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Aborted&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-297"><a id="__codelineno-1-297" name="__codelineno-1-297" href="#__codelineno-1-297"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Aborted&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-298"><a id="__codelineno-1-298" name="__codelineno-1-298" href="#__codelineno-1-298"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Aborted&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-299"><a id="__codelineno-1-299" name="__codelineno-1-299" href="#__codelineno-1-299"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;AlreadyExists&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-300"><a id="__codelineno-1-300" name="__codelineno-1-300" href="#__codelineno-1-300"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;AlreadyExists&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-301"><a id="__codelineno-1-301" name="__codelineno-1-301" href="#__codelineno-1-301"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;AlreadyExists&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-302"><a id="__codelineno-1-302" name="__codelineno-1-302" href="#__codelineno-1-302"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Canceled&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-303"><a id="__codelineno-1-303" name="__codelineno-1-303" href="#__codelineno-1-303"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Canceled&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-304"><a id="__codelineno-1-304" name="__codelineno-1-304" href="#__codelineno-1-304"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Canceled&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-305"><a id="__codelineno-1-305" name="__codelineno-1-305" href="#__codelineno-1-305"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;DataLoss&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-306"><a id="__codelineno-1-306" name="__codelineno-1-306" href="#__codelineno-1-306"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;DataLoss&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-307"><a id="__codelineno-1-307" name="__codelineno-1-307" href="#__codelineno-1-307"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;DataLoss&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-308"><a id="__codelineno-1-308" name="__codelineno-1-308" href="#__codelineno-1-308"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;DeadlineExceeded&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-309"><a id="__codelineno-1-309" name="__codelineno-1-309" href="#__codelineno-1-309"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;DeadlineExceeded&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-310"><a id="__codelineno-1-310" name="__codelineno-1-310" href="#__codelineno-1-310"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;DeadlineExceeded&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-311"><a id="__codelineno-1-311" name="__codelineno-1-311" href="#__codelineno-1-311"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;FailedPrecondition&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-312"><a id="__codelineno-1-312" name="__codelineno-1-312" href="#__codelineno-1-312"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;FailedPrecondition&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-313"><a id="__codelineno-1-313" name="__codelineno-1-313" href="#__codelineno-1-313"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;FailedPrecondition&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-314"><a id="__codelineno-1-314" name="__codelineno-1-314" href="#__codelineno-1-314"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Internal&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-315"><a id="__codelineno-1-315" name="__codelineno-1-315" href="#__codelineno-1-315"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Internal&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-316"><a id="__codelineno-1-316" name="__codelineno-1-316" href="#__codelineno-1-316"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Internal&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-317"><a id="__codelineno-1-317" name="__codelineno-1-317" href="#__codelineno-1-317"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;InvalidArgument&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-318"><a id="__codelineno-1-318" name="__codelineno-1-318" href="#__codelineno-1-318"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;InvalidArgument&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-319"><a id="__codelineno-1-319" name="__codelineno-1-319" href="#__codelineno-1-319"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;InvalidArgument&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-320"><a id="__codelineno-1-320" name="__codelineno-1-320" href="#__codelineno-1-320"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;NotFound&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-321"><a id="__codelineno-1-321" name="__codelineno-1-321" href="#__codelineno-1-321"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;NotFound&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-322"><a id="__codelineno-1-322" name="__codelineno-1-322" href="#__codelineno-1-322"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;NotFound&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-323"><a id="__codelineno-1-323" name="__codelineno-1-323" href="#__codelineno-1-323"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;OK&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 7</span>
-</span><span id="__span-1-324"><a id="__codelineno-1-324" name="__codelineno-1-324" href="#__codelineno-1-324"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;OK&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-325"><a id="__codelineno-1-325" name="__codelineno-1-325" href="#__codelineno-1-325"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;OK&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-326"><a id="__codelineno-1-326" name="__codelineno-1-326" href="#__codelineno-1-326"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;OutOfRange&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-327"><a id="__codelineno-1-327" name="__codelineno-1-327" href="#__codelineno-1-327"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;OutOfRange&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-328"><a id="__codelineno-1-328" name="__codelineno-1-328" href="#__codelineno-1-328"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;OutOfRange&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-329"><a id="__codelineno-1-329" name="__codelineno-1-329" href="#__codelineno-1-329"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;PermissionDenied&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-330"><a id="__codelineno-1-330" name="__codelineno-1-330" href="#__codelineno-1-330"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;PermissionDenied&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-331"><a id="__codelineno-1-331" name="__codelineno-1-331" href="#__codelineno-1-331"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;PermissionDenied&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-332"><a id="__codelineno-1-332" name="__codelineno-1-332" href="#__codelineno-1-332"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;ResourceExhausted&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-333"><a id="__codelineno-1-333" name="__codelineno-1-333" href="#__codelineno-1-333"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;ResourceExhausted&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-334"><a id="__codelineno-1-334" name="__codelineno-1-334" href="#__codelineno-1-334"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;ResourceExhausted&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-335"><a id="__codelineno-1-335" name="__codelineno-1-335" href="#__codelineno-1-335"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unauthenticated&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-336"><a id="__codelineno-1-336" name="__codelineno-1-336" href="#__codelineno-1-336"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unauthenticated&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-337"><a id="__codelineno-1-337" name="__codelineno-1-337" href="#__codelineno-1-337"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unauthenticated&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-338"><a id="__codelineno-1-338" name="__codelineno-1-338" href="#__codelineno-1-338"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unavailable&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-339"><a id="__codelineno-1-339" name="__codelineno-1-339" href="#__codelineno-1-339"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unavailable&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-340"><a id="__codelineno-1-340" name="__codelineno-1-340" href="#__codelineno-1-340"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unavailable&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-341"><a id="__codelineno-1-341" name="__codelineno-1-341" href="#__codelineno-1-341"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unimplemented&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-342"><a id="__codelineno-1-342" name="__codelineno-1-342" href="#__codelineno-1-342"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unimplemented&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-343"><a id="__codelineno-1-343" name="__codelineno-1-343" href="#__codelineno-1-343"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unimplemented&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-344"><a id="__codelineno-1-344" name="__codelineno-1-344" href="#__codelineno-1-344"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unknown&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-345"><a id="__codelineno-1-345" name="__codelineno-1-345" href="#__codelineno-1-345"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unknown&quot;,grpc_method=&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-346"><a id="__codelineno-1-346" name="__codelineno-1-346" href="#__codelineno-1-346"></a><span class="na">grpc_server_handled_total{grpc_code</span><span class="o">=</span><span class="s">&quot;Unknown&quot;,grpc_method=&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-347"><a id="__codelineno-1-347" name="__codelineno-1-347" href="#__codelineno-1-347"></a><span class="c1"># HELP grpc_server_handling_seconds Histogram of response latency (seconds) of gRPC that had been application-level handled by the server.</span>
-</span><span id="__span-1-348"><a id="__codelineno-1-348" name="__codelineno-1-348" href="#__codelineno-1-348"></a><span class="c1"># TYPE grpc_server_handling_seconds histogram</span>
-</span><span id="__span-1-349"><a id="__codelineno-1-349" name="__codelineno-1-349" href="#__codelineno-1-349"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;0.005&quot;} 3</span>
-</span><span id="__span-1-350"><a id="__codelineno-1-350" name="__codelineno-1-350" href="#__codelineno-1-350"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;0.01&quot;} 3</span>
-</span><span id="__span-1-351"><a id="__codelineno-1-351" name="__codelineno-1-351" href="#__codelineno-1-351"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;0.025&quot;} 3</span>
-</span><span id="__span-1-352"><a id="__codelineno-1-352" name="__codelineno-1-352" href="#__codelineno-1-352"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;0.05&quot;} 6</span>
-</span><span id="__span-1-353"><a id="__codelineno-1-353" name="__codelineno-1-353" href="#__codelineno-1-353"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;0.1&quot;} 6</span>
-</span><span id="__span-1-354"><a id="__codelineno-1-354" name="__codelineno-1-354" href="#__codelineno-1-354"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;0.25&quot;} 7</span>
-</span><span id="__span-1-355"><a id="__codelineno-1-355" name="__codelineno-1-355" href="#__codelineno-1-355"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;0.5&quot;} 7</span>
-</span><span id="__span-1-356"><a id="__codelineno-1-356" name="__codelineno-1-356" href="#__codelineno-1-356"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;1&quot;} 7</span>
-</span><span id="__span-1-357"><a id="__codelineno-1-357" name="__codelineno-1-357" href="#__codelineno-1-357"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;2.5&quot;} 7</span>
-</span><span id="__span-1-358"><a id="__codelineno-1-358" name="__codelineno-1-358" href="#__codelineno-1-358"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;5&quot;} 7</span>
-</span><span id="__span-1-359"><a id="__codelineno-1-359" name="__codelineno-1-359" href="#__codelineno-1-359"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;10&quot;} 7</span>
-</span><span id="__span-1-360"><a id="__codelineno-1-360" name="__codelineno-1-360" href="#__codelineno-1-360"></a><span class="na">grpc_server_handling_seconds_bucket{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;,le=&quot;+Inf&quot;} 7</span>
-</span><span id="__span-1-361"><a id="__codelineno-1-361" name="__codelineno-1-361" href="#__codelineno-1-361"></a><span class="na">grpc_server_handling_seconds_sum{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 0.277605516</span>
-</span><span id="__span-1-362"><a id="__codelineno-1-362" name="__codelineno-1-362" href="#__codelineno-1-362"></a><span class="na">grpc_server_handling_seconds_count{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 7</span>
-</span><span id="__span-1-363"><a id="__codelineno-1-363" name="__codelineno-1-363" href="#__codelineno-1-363"></a><span class="c1"># HELP grpc_server_msg_received_total Total number of RPC stream messages received on the server.</span>
-</span><span id="__span-1-364"><a id="__codelineno-1-364" name="__codelineno-1-364" href="#__codelineno-1-364"></a><span class="c1"># TYPE grpc_server_msg_received_total counter</span>
-</span><span id="__span-1-365"><a id="__codelineno-1-365" name="__codelineno-1-365" href="#__codelineno-1-365"></a><span class="na">grpc_server_msg_received_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 7</span>
-</span><span id="__span-1-366"><a id="__codelineno-1-366" name="__codelineno-1-366" href="#__codelineno-1-366"></a><span class="na">grpc_server_msg_received_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-367"><a id="__codelineno-1-367" name="__codelineno-1-367" href="#__codelineno-1-367"></a><span class="na">grpc_server_msg_received_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-368"><a id="__codelineno-1-368" name="__codelineno-1-368" href="#__codelineno-1-368"></a><span class="c1"># HELP grpc_server_msg_sent_total Total number of gRPC stream messages sent by the server.</span>
-</span><span id="__span-1-369"><a id="__codelineno-1-369" name="__codelineno-1-369" href="#__codelineno-1-369"></a><span class="c1"># TYPE grpc_server_msg_sent_total counter</span>
-</span><span id="__span-1-370"><a id="__codelineno-1-370" name="__codelineno-1-370" href="#__codelineno-1-370"></a><span class="na">grpc_server_msg_sent_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 7</span>
-</span><span id="__span-1-371"><a id="__codelineno-1-371" name="__codelineno-1-371" href="#__codelineno-1-371"></a><span class="na">grpc_server_msg_sent_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-372"><a id="__codelineno-1-372" name="__codelineno-1-372" href="#__codelineno-1-372"></a><span class="na">grpc_server_msg_sent_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-373"><a id="__codelineno-1-373" name="__codelineno-1-373" href="#__codelineno-1-373"></a><span class="c1"># HELP grpc_server_started_total Total number of RPCs started on the server.</span>
-</span><span id="__span-1-374"><a id="__codelineno-1-374" name="__codelineno-1-374" href="#__codelineno-1-374"></a><span class="c1"># TYPE grpc_server_started_total counter</span>
-</span><span id="__span-1-375"><a id="__codelineno-1-375" name="__codelineno-1-375" href="#__codelineno-1-375"></a><span class="na">grpc_server_started_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;envoy.service.auth.v3.Authorization&quot;,grpc_type=&quot;unary&quot;} 7</span>
-</span><span id="__span-1-376"><a id="__codelineno-1-376" name="__codelineno-1-376" href="#__codelineno-1-376"></a><span class="na">grpc_server_started_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Check&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;unary&quot;} 0</span>
-</span><span id="__span-1-377"><a id="__codelineno-1-377" name="__codelineno-1-377" href="#__codelineno-1-377"></a><span class="na">grpc_server_started_total{grpc_method</span><span class="o">=</span><span class="s">&quot;Watch&quot;,grpc_service=&quot;grpc.health.v1.Health&quot;,grpc_type=&quot;server_stream&quot;} 0</span>
-</span><span id="__span-1-378"><a id="__codelineno-1-378" name="__codelineno-1-378" href="#__codelineno-1-378"></a><span class="c1"># HELP oidc_server_requests_total Number of get requests received on the OIDC (Festival Wristband) server.</span>
-</span><span id="__span-1-379"><a id="__codelineno-1-379" name="__codelineno-1-379" href="#__codelineno-1-379"></a><span class="c1"># TYPE oidc_server_requests_total counter</span>
-</span><span id="__span-1-380"><a id="__codelineno-1-380" name="__codelineno-1-380" href="#__codelineno-1-380"></a><span class="na">oidc_server_requests_total{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,path=&quot;/.well-known/openid-configuration&quot;,wristband=&quot;wristband&quot;} 1</span>
-</span><span id="__span-1-381"><a id="__codelineno-1-381" name="__codelineno-1-381" href="#__codelineno-1-381"></a><span class="na">oidc_server_requests_total{authconfig</span><span class="o">=</span><span class="s">&quot;edge-auth&quot;,namespace=&quot;authorino&quot;,path=&quot;/.well-known/openid-connect/certs&quot;,wristband=&quot;wristband&quot;} 1</span>
-</span><span id="__span-1-382"><a id="__codelineno-1-382" name="__codelineno-1-382" href="#__codelineno-1-382"></a><span class="c1"># HELP oidc_server_response_status Status of HTTP response sent by the OIDC (Festival Wristband) server.</span>
-</span><span id="__span-1-383"><a id="__codelineno-1-383" name="__codelineno-1-383" href="#__codelineno-1-383"></a><span class="c1"># TYPE oidc_server_response_status counter</span>
-</span><span id="__span-1-384"><a id="__codelineno-1-384" name="__codelineno-1-384" href="#__codelineno-1-384"></a><span class="na">oidc_server_response_status{status</span><span class="o">=</span><span class="s">&quot;200&quot;} 2</span>
-</span><span id="__span-1-385"><a id="__codelineno-1-385" name="__codelineno-1-385" href="#__codelineno-1-385"></a><span class="c1"># HELP process_cpu_seconds_total Total user and system CPU time spent in seconds.</span>
-</span><span id="__span-1-386"><a id="__codelineno-1-386" name="__codelineno-1-386" href="#__codelineno-1-386"></a><span class="c1"># TYPE process_cpu_seconds_total counter</span>
-</span><span id="__span-1-387"><a id="__codelineno-1-387" name="__codelineno-1-387" href="#__codelineno-1-387"></a><span class="na">process_cpu_seconds_total 1.42</span>
-</span><span id="__span-1-388"><a id="__codelineno-1-388" name="__codelineno-1-388" href="#__codelineno-1-388"></a><span class="c1"># HELP process_max_fds Maximum number of open file descriptors.</span>
-</span><span id="__span-1-389"><a id="__codelineno-1-389" name="__codelineno-1-389" href="#__codelineno-1-389"></a><span class="c1"># TYPE process_max_fds gauge</span>
-</span><span id="__span-1-390"><a id="__codelineno-1-390" name="__codelineno-1-390" href="#__codelineno-1-390"></a><span class="na">process_max_fds 1.048576e+06</span>
-</span><span id="__span-1-391"><a id="__codelineno-1-391" name="__codelineno-1-391" href="#__codelineno-1-391"></a><span class="c1"># HELP process_open_fds Number of open file descriptors.</span>
-</span><span id="__span-1-392"><a id="__codelineno-1-392" name="__codelineno-1-392" href="#__codelineno-1-392"></a><span class="c1"># TYPE process_open_fds gauge</span>
-</span><span id="__span-1-393"><a id="__codelineno-1-393" name="__codelineno-1-393" href="#__codelineno-1-393"></a><span class="na">process_open_fds 14</span>
-</span><span id="__span-1-394"><a id="__codelineno-1-394" name="__codelineno-1-394" href="#__codelineno-1-394"></a><span class="c1"># HELP process_resident_memory_bytes Resident memory size in bytes.</span>
-</span><span id="__span-1-395"><a id="__codelineno-1-395" name="__codelineno-1-395" href="#__codelineno-1-395"></a><span class="c1"># TYPE process_resident_memory_bytes gauge</span>
-</span><span id="__span-1-396"><a id="__codelineno-1-396" name="__codelineno-1-396" href="#__codelineno-1-396"></a><span class="na">process_resident_memory_bytes 4.370432e+07</span>
-</span><span id="__span-1-397"><a id="__codelineno-1-397" name="__codelineno-1-397" href="#__codelineno-1-397"></a><span class="c1"># HELP process_start_time_seconds Start time of the process since unix epoch in seconds.</span>
-</span><span id="__span-1-398"><a id="__codelineno-1-398" name="__codelineno-1-398" href="#__codelineno-1-398"></a><span class="c1"># TYPE process_start_time_seconds gauge</span>
-</span><span id="__span-1-399"><a id="__codelineno-1-399" name="__codelineno-1-399" href="#__codelineno-1-399"></a><span class="na">process_start_time_seconds 1.64615612779e+09</span>
-</span><span id="__span-1-400"><a id="__codelineno-1-400" name="__codelineno-1-400" href="#__codelineno-1-400"></a><span class="c1"># HELP process_virtual_memory_bytes Virtual memory size in bytes.</span>
-</span><span id="__span-1-401"><a id="__codelineno-1-401" name="__codelineno-1-401" href="#__codelineno-1-401"></a><span class="c1"># TYPE process_virtual_memory_bytes gauge</span>
-</span><span id="__span-1-402"><a id="__codelineno-1-402" name="__codelineno-1-402" href="#__codelineno-1-402"></a><span class="na">process_virtual_memory_bytes 7.65362176e+08</span>
-</span><span id="__span-1-403"><a id="__codelineno-1-403" name="__codelineno-1-403" href="#__codelineno-1-403"></a><span class="c1"># HELP process_virtual_memory_max_bytes Maximum amount of virtual memory available in bytes.</span>
-</span><span id="__span-1-404"><a id="__codelineno-1-404" name="__codelineno-1-404" href="#__codelineno-1-404"></a><span class="c1"># TYPE process_virtual_memory_max_bytes gauge</span>
-</span><span id="__span-1-405"><a id="__codelineno-1-405" name="__codelineno-1-405" href="#__codelineno-1-405"></a><span class="na">process_virtual_memory_max_bytes 1.8446744073709552e+19</span>
-</span><span id="__span-1-406"><a id="__codelineno-1-406" name="__codelineno-1-406" href="#__codelineno-1-406"></a><span class="c1"># HELP promhttp_metric_handler_requests_in_flight Current number of scrapes being served.</span>
-</span><span id="__span-1-407"><a id="__codelineno-1-407" name="__codelineno-1-407" href="#__codelineno-1-407"></a><span class="c1"># TYPE promhttp_metric_handler_requests_in_flight gauge</span>
-</span><span id="__span-1-408"><a id="__codelineno-1-408" name="__codelineno-1-408" href="#__codelineno-1-408"></a><span class="na">promhttp_metric_handler_requests_in_flight 1</span>
-</span><span id="__span-1-409"><a id="__codelineno-1-409" name="__codelineno-1-409" href="#__codelineno-1-409"></a><span class="c1"># HELP promhttp_metric_handler_requests_total Total number of scrapes by HTTP status code.</span>
-</span><span id="__span-1-410"><a id="__codelineno-1-410" name="__codelineno-1-410" href="#__codelineno-1-410"></a><span class="c1"># TYPE promhttp_metric_handler_requests_total counter</span>
-</span><span id="__span-1-411"><a id="__codelineno-1-411" name="__codelineno-1-411" href="#__codelineno-1-411"></a><span class="na">promhttp_metric_handler_requests_total{code</span><span class="o">=</span><span class="s">&quot;200&quot;} 1</span>
-</span><span id="__span-1-412"><a id="__codelineno-1-412" name="__codelineno-1-412" href="#__codelineno-1-412"></a><span class="na">promhttp_metric_handler_requests_total{code</span><span class="o">=</span><span class="s">&quot;500&quot;} 0</span>
-</span><span id="__span-1-413"><a id="__codelineno-1-413" name="__codelineno-1-413" href="#__codelineno-1-413"></a><span class="na">promhttp_metric_handler_requests_total{code</span><span class="o">=</span><span class="s">&quot;503&quot;} 0</span>
-</span></code></pre></div>
-</details>
-<h2 id="readiness-check">Readiness check<a class="headerlink" href="#readiness-check" title="Permanent link">&para;</a></h2>
-<p>Authorino exposes two main endpoints for health and readiness check of the AuthConfig controller:</p>
-<ul>
-<li><code>/healthz</code>: Health probe (ping) – reports "ok" if the controller is healthy.</li>
-<li><code>/readyz</code>: Readiness probe – reports "ok" if the controller is ready to reconcile AuthConfig-related events.</li>
-</ul>
-<p>In general, the endpoints return either <code>200</code> ("ok", i.e. all checks have passed) or <code>500</code> (when one or more checks failed).</p>
-<p>The default binding network address is <code>:8081</code>, which can be changed by setting the command-line flag <code>--health-probe-addr</code>.</p>
-<p>The following additional subpath is available and its corresponding check can be aggregated into the response from the main readiness probe:</p>
-<ul>
-<li><code>/readyz/authconfigs</code>: Aggregated readiness status of the AuthConfigs – reports "ok" if all AuthConfigs watched by the reconciler have been marked as ready.</li>
-</ul>
-<table>
-  <tbody>
-    <tr>
-      <td><b><i>Important!</i></b><br/>The AuthConfig readiness check within the scope of the aggregated readiness probe endpoint is deactivated by default – i.e. this check is an opt-in check. Sending a request to the <code>/readyz</code> endpoint without explicitly opting-in for the AuthConfigs check, by using the <code>include</code> parameter, will result in a response message that disregards the actual status of the watched AuthConfigs, possibly an "ok" message. To read the aggregated status of the watched AuthConfigs, either use the specific endpoint <code>/readyz/authconfigs</code> or opt-in for the check in the aggregated endpoint by sending a request to <code>/readyz?include=authconfigs</code></td>
-    </tr>
-  </tbody>
-</table>
-
-<p>Apart from <code>include</code> to add the aggregated status of the AuthConfigs, the following additional query string parameters are available:</p>
-<ul>
-<li><code>verbose=true|false</code> - provides more verbose response messages;</li>
-<li><code>exclude=(check name)</code> – to exclude a particular readiness check (for future usage).</li>
-</ul>
-<h2 id="logging">Logging<a class="headerlink" href="#logging" title="Permanent link">&para;</a></h2>
-<p>Authorino provides structured log messages ("production") or more log messages output to stdout in a more user-friendly format ("development" mode) and different level of logging.</p>
-<h3 id="log-levels-and-log-modes">Log levels and log modes<a class="headerlink" href="#log-levels-and-log-modes" title="Permanent link">&para;</a></h3>
-<p>Authorino outputs 3 levels of log messages: (from lowest to highest level)</p>
-<ol>
-<li><code>debug</code></li>
-<li><code>info</code> (default)</li>
-<li><code>error</code></li>
-</ol>
-<p><code>info</code> logging is restricted to high-level information of the gRPC and HTTP authorization services, limiting messages to incoming request and respective outgoing response logs, with reduced details about the corresponding objects (request payload and authorization result), and without any further detailed logs of the steps in between, except for errors.</p>
-<p>Only <code>debug</code> logging will include processing details of each <a href="../../architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a>, such as intermediary requests to validate identities with external auth servers, requests to external sources of auth metadata or authorization policies.</p>
-<p>To configure the desired log level, set the <code>spec.logLevel</code> field of the <a href="https://github.com/Kuadrant/authorino-operator/blob/main/config/crd/bases/operator.authorino.kuadrant.io_authorinos.yaml"><code>Authorino</code></a> custom resource (or <code>--log-level</code> command-line flag in the Authorino deployment), to one of the supported values listed above. Default log level is <code>info</code>.</p>
-<p>Apart from log level, Authorino can output messages to the logs in 2 different formats:</p>
-<ul>
-<li><code>production</code> (default): each line is a parseable JSON object with properties <code>{"level":string, "ts":int, "msg":string, "logger":string, extra values...}</code></li>
-<li><code>development</code>: more human-readable outputs, extra stack traces and logging info, plus extra values output as JSON, in the format: <code>&lt;timestamp-iso-8601&gt;\t&lt;log-level&gt;\t&lt;logger&gt;\t&lt;message&gt;\t{extra-values-as-json}</code></li>
-</ul>
-<p>To configure the desired log mode, set the <code>spec.logMode</code> field of the <a href="https://github.com/Kuadrant/authorino-operator/blob/main/config/crd/bases/operator.authorino.kuadrant.io_authorinos.yaml"><code>Authorino</code></a> custom resource (or <code>--log-mode</code> command-line flag in the Authorino deployment), to one of the supported values listed above. Default log level is <code>production</code>.</p>
-<p>Example of <code>Authorino</code> custom resource with log level <code>debug</code> and log mode <code>production</code>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Authorino</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="nt">logLevel</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">debug</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">  </span><span class="nt">logMode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">production</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">  </span><span class="nt">listener</span><span class="p">:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">    </span><span class="nt">tls</span><span class="p">:</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">      </span><span class="nt">enabled</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">false</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">  </span><span class="nt">oidcServer</span><span class="p">:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">    </span><span class="nt">tls</span><span class="p">:</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">      </span><span class="nt">enabled</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">false</span>
-</span></code></pre></div>
-<h3 id="sensitive-data-output-to-the-logs">Sensitive data output to the logs<a class="headerlink" href="#sensitive-data-output-to-the-logs" title="Permanent link">&para;</a></h3>
-<p>Authorino will never output HTTP headers and query string parameters to <code>info</code> log messages, as such values usually include sensitive data (e.g. access tokens, API keys and Authorino Festival Wristbands). However, <code>debug</code> log messages may include such sensitive information and those are not redacted.</p>
-<p>Therefore, <strong>DO NOT USE <code>debug</code> LOG LEVEL IN PRODUCTION</strong>! Instead, use either <code>info</code> or <code>error</code>.</p>
-<h3 id="log-messages-printed-by-authorino">Log messages printed by Authorino<a class="headerlink" href="#log-messages-printed-by-authorino" title="Permanent link">&para;</a></h3>
-<p>Some log messages printed by Authorino and corresponding extra values included:</p>
-<table>
-<thead>
-<tr>
-<th>logger</th>
-<th>level</th>
-<th>message</th>
-<th>extra values</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"setting instance base logger"</td>
-<td><code>min level=info\|debug</code>, <code>mode=production\|development</code></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"booting up authorino"</td>
-<td><code>version</code></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>debug</code></td>
-<td>"setting up with options"</td>
-<td><code>auth-config-label-selector</code>, <code>deep-metrics-enabled</code>, <code>enable-leader-election</code>, <code>evaluator-cache-size</code>, <code>ext-auth-grpc-port</code>, <code>ext-auth-http-port</code>, <code>health-probe-addr</code>, <code>log-level</code>, <code>log-mode</code>, <code>max-http-request-body-size</code>, <code>metrics-addr</code>, <code>oidc-http-port</code>, <code>oidc-tls-cert</code>, <code>oidc-tls-cert-key</code>, <code>secret-label-selector</code>, <code>timeout</code>, <code>tls-cert</code>, <code>tls-cert-key</code>, <code>watch-namespace</code></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"attempting to acquire leader lease &lt;namespace&gt;/cb88a58a.authorino.kuadrant.io...\n"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"successfully acquired lease &lt;namespace&gt;/cb88a58a.authorino.kuadrant.io\n"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"disabling grpc auth service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"starting grpc auth service"</td>
-<td><code>port</code>, <code>tls</code></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"failed to obtain port for the grpc auth service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"failed to load tls cert for the grpc auth"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"failed to start grpc auth service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"disabling http auth service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"starting http auth service"</td>
-<td><code>port</code>, <code>tls</code></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"failed to obtain port for the http auth service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"failed to start http auth service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"disabling http oidc service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"starting http oidc service"</td>
-<td><code>port</code>, <code>tls</code></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"failed to obtain port for the http oidc service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"failed to start http oidc service"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"starting manager"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"unable to start manager"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"unable to create controller"</td>
-<td><code>controller=authconfig\|secret\|authconfigstatusupdate</code></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"problem running manager"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>info</code></td>
-<td>"starting status update manager"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"unable to start status update manager"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino</code></td>
-<td><code>error</code></td>
-<td>"problem running status update manager"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.metrics</code></td>
-<td><code>info</code></td>
-<td>"metrics server is starting to listen"</td>
-<td><code>addr</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager</code></td>
-<td><code>info</code></td>
-<td>"starting metrics server"</td>
-<td><code>path</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.events</code></td>
-<td><code>debug</code></td>
-<td>"Normal"</td>
-<td><code>object={kind=ConfigMap, apiVersion=v1}</code>, <code>reauthorino.ason=LeaderElection</code>, <code>message="authorino-controller-manager-* became leader"</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.events</code></td>
-<td><code>debug</code></td>
-<td>"Normal"</td>
-<td><code>object={kind=Lease, apiVersion=coordination.k8s.io/v1}</code>, <code>reauthorino.ason=LeaderElection</code>, <code>message="authorino-controller-manager-* became leader"</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.controller.authconfig</code></td>
-<td><code>info</code></td>
-<td>"resource reconciled"</td>
-<td><code>authconfig</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.controller.authconfig</code></td>
-<td><code>info</code></td>
-<td>"host already taken"</td>
-<td><code>authconfig</code>, <code>host</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.controller.authconfig.statusupdater</code></td>
-<td><code>debug</code></td>
-<td>"resource status did not change"</td>
-<td><code>authconfig</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.controller.authconfig.statusupdater</code></td>
-<td><code>debug</code></td>
-<td>"resource status changed"</td>
-<td><code>authconfig</code>, <code>authconfig/status</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.controller.authconfig.statusupdater</code></td>
-<td><code>error</code></td>
-<td>"failed to update the resource"</td>
-<td><code>authconfig</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.controller.authconfig.statusupdater</code></td>
-<td><code>info</code></td>
-<td>"resource status updated"</td>
-<td><code>authconfig</code></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.controller.secret</code></td>
-<td><code>info</code></td>
-<td>"resource reconciled"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino.controller-runtime.manager.controller.secret</code></td>
-<td><code>info</code></td>
-<td>"could not reconcile authconfigs using api key authorino.authentication"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino.service.oidc</code></td>
-<td><code>info</code></td>
-<td>"request received"</td>
-<td><code>request id</code>, <code>url</code>, <code>realm</code>, <code>config</code>, <code>path</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.oidc</code></td>
-<td><code>info</code></td>
-<td>"response sent"</td>
-<td><code>request id</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.oidc</code></td>
-<td><code>error</code></td>
-<td>"failed to serve oidc request"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth</code></td>
-<td><code>info</code></td>
-<td>"incoming authorization request"</td>
-<td><code>request id</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth</code></td>
-<td><code>debug</code></td>
-<td>"incoming authorization request"</td>
-<td><code>request id</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth</code></td>
-<td><code>info</code></td>
-<td>"outgoing authorization response"</td>
-<td><code>request id</code>, <code>authorized</code>, <code>response</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth</code></td>
-<td><code>debug</code></td>
-<td>"outgoing authorization response"</td>
-<td><code>request id</code>, <code>authorized</code>, <code>response</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth</code></td>
-<td><code>error</code></td>
-<td>"failed to create dynamic metadata"</td>
-<td><code>request id</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline</code></td>
-<td><code>debug</code></td>
-<td>"skipping config"</td>
-<td><code>request id</code>, <code>config</code>, <code>reason</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity</code></td>
-<td><code>debug</code></td>
-<td>"identity validated"</td>
-<td><code>request id</code>, <code>config</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity</code></td>
-<td><code>debug</code></td>
-<td>"cannot validate identity"</td>
-<td><code>request id</code>, <code>config</code>, <code>reason</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity</code></td>
-<td><code>error</code></td>
-<td>"failed to extend identity object"</td>
-<td><code>request id</code>, <code>config</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity.oidc</code></td>
-<td><code>error</code></td>
-<td>"failed to discovery openid connect configuration"</td>
-<td><code>endpoint</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity.oidc</code></td>
-<td><code>debug</code></td>
-<td>"auto-refresh of openid connect configuration disabled"</td>
-<td><code>endpoint</code>, <code>reason</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity.oidc</code></td>
-<td><code>debug</code></td>
-<td>"openid connect configuration updated"</td>
-<td><code>endpoint</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity.oauth2</code></td>
-<td><code>debug</code></td>
-<td>"sending token introspection request"</td>
-<td><code>request id</code>, <code>url</code>, <code>data</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity.kubernetesauth</code></td>
-<td><code>debug</code></td>
-<td>"calling kubernetes token review api"</td>
-<td><code>request id</code>, <code>tokenreview</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.identity.apikey</code></td>
-<td><code>error</code></td>
-<td>"Something went wrong fetching the authorized credentials"</td>
-<td></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.metadata</code></td>
-<td><code>debug</code></td>
-<td>"fetched auth metadata"</td>
-<td><code>request id</code>, <code>config</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.metadata</code></td>
-<td><code>debug</code></td>
-<td>"cannot fetch metadata"</td>
-<td><code>request id</code>, <code>config</code>, <code>reason</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.metadata.http</code></td>
-<td><code>debug</code></td>
-<td>"sending request"</td>
-<td><code>request id</code>, <code>method</code>, <code>url</code>, <code>headers</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.metadata.userinfo</code></td>
-<td><code>debug</code></td>
-<td>"fetching user info"</td>
-<td><code>request id</code>, <code>endpoint</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.metadata.uma</code></td>
-<td><code>debug</code></td>
-<td>"requesting pat"</td>
-<td><code>request id</code>, <code>url</code>, <code>data</code>, <code>headers</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.metadata.uma</code></td>
-<td><code>debug</code></td>
-<td>"querying resources by uri"</td>
-<td><code>request id</code>, <code>url</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.metadata.uma</code></td>
-<td><code>debug</code></td>
-<td>"getting resource data"</td>
-<td><code>request id</code>, <code>url</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization</code></td>
-<td><code>debug</code></td>
-<td>"evaluating for input"</td>
-<td><code>request id</code>, <code>input</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization</code></td>
-<td><code>debug</code></td>
-<td>"access granted"</td>
-<td><code>request id</code>, <code>config</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization</code></td>
-<td><code>debug</code></td>
-<td>"access denied"</td>
-<td><code>request id</code>, <code>config</code>, <code>reason</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization.opa</code></td>
-<td><code>error</code></td>
-<td>"invalid response from policy evaluation"</td>
-<td><code>policy</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization.opa</code></td>
-<td><code>error</code></td>
-<td>"failed to precompile policy"</td>
-<td><code>policy</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization.opa</code></td>
-<td><code>error</code></td>
-<td>"failed to download policy from external registry"</td>
-<td><code>policy</code>, <code>endpoint</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization.opa</code></td>
-<td><code>error</code></td>
-<td>"failed to refresh policy from external registry"</td>
-<td><code>policy</code>, <code>endpoint</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization.opa</code></td>
-<td><code>debug</code></td>
-<td>"external policy unchanged"</td>
-<td><code>policy</code>, <code>endpoint</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization.opa</code></td>
-<td><code>debug</code></td>
-<td>"auto-refresh  of external policy disabled"</td>
-<td><code>policy</code>, <code>endpoint</code>, <code>reason</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization.opa</code></td>
-<td><code>info</code></td>
-<td>"policy updated from external registry"</td>
-<td><code>policy</code>, <code>endpoint</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.authorization.kubernetesauthz</code></td>
-<td><code>debug</code></td>
-<td>"calling kubernetes subject access review api"</td>
-<td><code>request id</code>, <code>subjectaccessreview</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.response</code></td>
-<td><code>debug</code></td>
-<td>"dynamic response built"</td>
-<td><code>request id</code>, <code>config</code>, <code>object</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.authpipeline.response</code></td>
-<td><code>debug</code></td>
-<td>"cannot build dynamic response"</td>
-<td><code>request id</code>, <code>config</code>, <code>reason</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.http</code></td>
-<td><code>debug</code></td>
-<td>"bad request"</td>
-<td><code>request id</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.http</code></td>
-<td><code>debug</code></td>
-<td>"not found"</td>
-<td><code>request id</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.http</code></td>
-<td><code>debug</code></td>
-<td>"request body too large"</td>
-<td><code>request id</code></td>
-</tr>
-<tr>
-<td><code>authorino.service.auth.http</code></td>
-<td><code>debug</code></td>
-<td>"service unavailable"</td>
-<td><code>request id</code></td>
-</tr>
-</tbody>
-</table>
-<h4 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent link">&para;</a></h4>
-<p>The examples below are all with <code>--log-level=debug</code> and <code>--log-mode=production</code>.</p>
-<details>
-<summary>Booting up the service</summary>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220526.929678,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;setting instance base logger&quot;,&quot;min level&quot;:&quot;debug&quot;,&quot;mode&quot;:&quot;production&quot;}
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220526.929718,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;booting up authorino&quot;,&quot;version&quot;:&quot;7688cfa32317a49f0461414e741c980e9c05dba3&quot;}
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669220526.9297278,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;setting up with options&quot;,&quot;auth-config-label-selector&quot;:&quot;&quot;,&quot;deep-metrics-enabled&quot;:&quot;false&quot;,&quot;enable-leader-election&quot;:&quot;false&quot;,&quot;evaluator-cache-size&quot;:&quot;1&quot;,&quot;ext-auth-grpc-port&quot;:&quot;50051&quot;,&quot;ext-auth-http-port&quot;:&quot;5001&quot;,&quot;health-probe-addr&quot;:&quot;:8081&quot;,&quot;log-level&quot;:&quot;debug&quot;,&quot;log-mode&quot;:&quot;production&quot;,&quot;max-http-request-body-size&quot;:&quot;8192&quot;,&quot;metrics-addr&quot;:&quot;:8080&quot;,&quot;oidc-http-port&quot;:&quot;8083&quot;,&quot;oidc-tls-cert&quot;:&quot;/etc/ssl/certs/oidc.crt&quot;,&quot;oidc-tls-cert-key&quot;:&quot;/etc/ssl/private/oidc.key&quot;,&quot;secret-label-selector&quot;:&quot;authorino.kuadrant.io/managed-by=authorino&quot;,&quot;timeout&quot;:&quot;0&quot;,&quot;tls-cert&quot;:&quot;/etc/ssl/certs/tls.crt&quot;,&quot;tls-cert-key&quot;:&quot;/etc/ssl/private/tls.key&quot;,&quot;watch-namespace&quot;:&quot;default&quot;}
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9816976,&quot;logger&quot;:&quot;authorino.controller-runtime.metrics&quot;,&quot;msg&quot;:&quot;Metrics server is starting to listen&quot;,&quot;addr&quot;:&quot;:8080&quot;}
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9823213,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;starting grpc auth service&quot;,&quot;port&quot;:50051,&quot;tls&quot;:true}
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9823658,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;starting http auth service&quot;,&quot;port&quot;:5001,&quot;tls&quot;:true}
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9824295,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;starting http oidc service&quot;,&quot;port&quot;:8083,&quot;tls&quot;:true}
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9825335,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;starting manager&quot;}
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.982721,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Starting server&quot;,&quot;path&quot;:&quot;/metrics&quot;,&quot;kind&quot;:&quot;metrics&quot;,&quot;addr&quot;:&quot;[::]:8080&quot;}
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.982766,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Starting server&quot;,&quot;kind&quot;:&quot;health probe&quot;,&quot;addr&quot;:&quot;[::]:8081&quot;}
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9829438,&quot;logger&quot;:&quot;authorino.controller.secret&quot;,&quot;msg&quot;:&quot;Starting EventSource&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;,&quot;source&quot;:&quot;kind source: *v1.Secret&quot;}
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9829693,&quot;logger&quot;:&quot;authorino.controller.secret&quot;,&quot;msg&quot;:&quot;Starting Controller&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;}
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9829714,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;Starting EventSource&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;,&quot;source&quot;:&quot;kind source: *v1beta1.AuthConfig&quot;}
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220527.9830208,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;Starting Controller&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;}
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220528.0834699,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;Starting workers&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;,&quot;worker count&quot;:1}
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220528.0836608,&quot;logger&quot;:&quot;authorino.controller.secret&quot;,&quot;msg&quot;:&quot;Starting workers&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;,&quot;worker count&quot;:1}
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220529.041266,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;starting status update manager&quot;}
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220529.0418258,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;Starting EventSource&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;,&quot;source&quot;:&quot;kind source: *v1beta1.AuthConfig&quot;}
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220529.0418813,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;Starting Controller&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;}
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669220529.1432905,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;Starting workers&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;,&quot;worker count&quot;:1}
-</span></code></pre></div>
-</details>
-<details>
-<summary>Reconciling an AuthConfig and 2 related API key secrets</summary>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669221208.7473805,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig.statusupdater&quot;,&quot;msg&quot;:&quot;resource status changed&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;,&quot;authconfig/status&quot;:{&quot;conditions&quot;:[{&quot;type&quot;:&quot;Available&quot;,&quot;status&quot;:&quot;False&quot;,&quot;lastTransitionTime&quot;:&quot;2022-11-23T16:33:28Z&quot;,&quot;reason&quot;:&quot;HostsNotLinked&quot;,&quot;message&quot;:&quot;No hosts linked to the resource&quot;},{&quot;type&quot;:&quot;Ready&quot;,&quot;status&quot;:&quot;False&quot;,&quot;lastTransitionTime&quot;:&quot;2022-11-23T16:33:28Z&quot;,&quot;reason&quot;:&quot;Unknown&quot;}],&quot;summary&quot;:{&quot;ready&quot;:false,&quot;hostsReady&quot;:[],&quot;numHostsReady&quot;:&quot;0/1&quot;,&quot;numIdentitySources&quot;:1,&quot;numMetadataSources&quot;:0,&quot;numAuthorizationPolicies&quot;:0,&quot;numResponseItems&quot;:0,&quot;festivalWristbandEnabled&quot;:false}}}
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221208.7496614,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;}
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221208.7532616,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;}
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669221208.7535005,&quot;logger&quot;:&quot;authorino.controller.secret&quot;,&quot;msg&quot;:&quot;adding k8s secret to the index&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;,&quot;name&quot;:&quot;api-key-1&quot;,&quot;namespace&quot;:&quot;default&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;,&quot;config&quot;:&quot;friends&quot;}
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669221208.7535596,&quot;logger&quot;:&quot;authorino.controller.secret.apikey&quot;,&quot;msg&quot;:&quot;api key added&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;,&quot;name&quot;:&quot;api-key-1&quot;,&quot;namespace&quot;:&quot;default&quot;}
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221208.7536132,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.secret&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;secret&quot;:&quot;default/api-key-1&quot;}
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221208.753772,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig.statusupdater&quot;,&quot;msg&quot;:&quot;resource status updated&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;}
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669221208.753835,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig.statusupdater&quot;,&quot;msg&quot;:&quot;resource status changed&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;,&quot;authconfig/status&quot;:{&quot;conditions&quot;:[{&quot;type&quot;:&quot;Available&quot;,&quot;status&quot;:&quot;True&quot;,&quot;lastTransitionTime&quot;:&quot;2022-11-23T16:33:28Z&quot;,&quot;reason&quot;:&quot;HostsLinked&quot;},{&quot;type&quot;:&quot;Ready&quot;,&quot;status&quot;:&quot;True&quot;,&quot;lastTransitionTime&quot;:&quot;2022-11-23T16:33:28Z&quot;,&quot;reason&quot;:&quot;Reconciled&quot;}],&quot;summary&quot;:{&quot;ready&quot;:true,&quot;hostsReady&quot;:[&quot;talker-api.127.0.0.1.nip.io&quot;],&quot;numHostsReady&quot;:&quot;1/1&quot;,&quot;numIdentitySources&quot;:1,&quot;numMetadataSources&quot;:0,&quot;numAuthorizationPolicies&quot;:0,&quot;numResponseItems&quot;:0,&quot;festivalWristbandEnabled&quot;:false}}}
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221208.7571108,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;}
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221208.7573664,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig.statusupdater&quot;,&quot;msg&quot;:&quot;resource status updated&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;}
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669221208.757429,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig.statusupdater&quot;,&quot;msg&quot;:&quot;resource status did not change&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;}
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669221208.7586699,&quot;logger&quot;:&quot;authorino.controller.secret&quot;,&quot;msg&quot;:&quot;adding k8s secret to the index&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;,&quot;name&quot;:&quot;api-key-2&quot;,&quot;namespace&quot;:&quot;default&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;,&quot;config&quot;:&quot;friends&quot;}
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669221208.7586884,&quot;logger&quot;:&quot;authorino.controller.secret.apikey&quot;,&quot;msg&quot;:&quot;api key added&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;,&quot;name&quot;:&quot;api-key-2&quot;,&quot;namespace&quot;:&quot;default&quot;}
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221208.7586913,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.secret&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;secret&quot;:&quot;default/api-key-2&quot;}
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1669221208.7597604,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig.statusupdater&quot;,&quot;msg&quot;:&quot;resource status did not change&quot;,&quot;authconfig&quot;:&quot;default/talker-api-protection&quot;}
-</span></code></pre></div>
-</details>
-<details>
-<summary>Enforcing an AuthConfig with authentication based on Kubernetes tokens:</summary>
-<p><br/></p>
-<ul>
-<li>identity: k8s-auth, oidc, oauth2, apikey</li>
-<li>metadata: http, oidc userinfo</li>
-<li>authorization: opa, k8s-authz</li>
-<li>response: wristband</li>
-</ul>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1634830460.1486168,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;incoming authorization request&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;object&quot;:{&quot;source&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:53144}}}}},&quot;destination&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:8000}}}}},&quot;request&quot;:{&quot;http&quot;:{&quot;id&quot;:&quot;8157480586935853928&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;path&quot;:&quot;/hello&quot;,&quot;host&quot;:&quot;talker-api&quot;,&quot;scheme&quot;:&quot;http&quot;}}}}
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.1491194,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;incoming authorization request&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;object&quot;:{&quot;source&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:53144}}}}},&quot;destination&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:8000}}}}},&quot;request&quot;:{&quot;time&quot;:{&quot;seconds&quot;:1634830460,&quot;nanos&quot;:147259000},&quot;http&quot;:{&quot;id&quot;:&quot;8157480586935853928&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;headers&quot;:{&quot;:authority&quot;:&quot;talker-api&quot;,&quot;:method&quot;:&quot;GET&quot;,&quot;:path&quot;:&quot;/hello&quot;,&quot;:scheme&quot;:&quot;http&quot;,&quot;accept&quot;:&quot;*/*&quot;,&quot;authorization&quot;:&quot;Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IkRsVWJZMENyVy1sZ0tFMVRMd19pcTFUWGtTYUl6T0hyWks0VHhKYnpEZUUifQ.eyJhdWQiOlsidGFsa2VyLWFwaSJdLCJleHAiOjE2MzQ4MzEwNTEsImlhdCI6MTYzNDgzMDQ1MSwiaXNzIjoiaHR0cHM6Ly9rdWJlcm5ldGVzLmRlZmF1bHQuc3ZjLmNsdXN0ZXIubG9jYWwiLCJrdWJlcm5ldGVzLmlvIjp7Im5hbWVzcGFjZSI6ImF1dGhvcmlubyIsInNlcnZpY2VhY2NvdW50Ijp7Im5hbWUiOiJhcGktY29uc3VtZXItMSIsInVpZCI6ImI0MGY1MzFjLWVjYWItNGYzMS1hNDk2LTJlYmM3MmFkZDEyMSJ9fSwibmJmIjoxNjM0ODMwNDUxLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6YXV0aG9yaW5vOmFwaS1jb25zdW1lci0xIn0.PaP0vqdl5DPfErr84KfVhPdlsGAPgsw0NkDaA9rne1zXjzcO7KPPbXhFwZC-oIjSGG1HfRMSoQeCXbQz24PSATmX8l1T52a9IFeXgP7sQmXZIDbiPfTm3X09kIIlfPKHhK_f-jQwRIpMRqNgLntlZ-xXX3P1fOBBUYR8obTPAQ6NDDaLHxw2SAmHFTQWjM_DInPDemXX0mEm7nCPKifsNxHaQH4wx4CD3LCLGbCI9FHNf2Crid8mmGJXf4wzcH1VuKkpUlsmnlUgTG2bfT2lbhSF2lBmrrhTJyYk6_aA09DwL4Bf4kvG-JtCq0Bkd_XynViIsOtOnAhgmdSPkfr-oA&quot;,&quot;user-agent&quot;:&quot;curl/7.65.3&quot;,&quot;x-envoy-internal&quot;:&quot;true&quot;,&quot;x-forwarded-for&quot;:&quot;10.244.0.11&quot;,&quot;x-forwarded-proto&quot;:&quot;http&quot;,&quot;x-request-id&quot;:&quot;4c5d5c97-e15b-46a3-877a-d8188e09e08f&quot;},&quot;path&quot;:&quot;/hello&quot;,&quot;host&quot;:&quot;talker-api&quot;,&quot;scheme&quot;:&quot;http&quot;,&quot;protocol&quot;:&quot;HTTP/1.1&quot;}},&quot;context_extensions&quot;:{&quot;virtual_host&quot;:&quot;local_service&quot;},&quot;metadata_context&quot;:{}}}
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.150506,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity.kubernetesauth&quot;,&quot;msg&quot;:&quot;calling kubernetes token review api&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;tokenreview&quot;:{&quot;metadata&quot;:{&quot;creationTimestamp&quot;:null},&quot;spec&quot;:{&quot;token&quot;:&quot;eyJhbGciOiJSUzI1NiIsImtpZCI6IkRsVWJZMENyVy1sZ0tFMVRMd19pcTFUWGtTYUl6T0hyWks0VHhKYnpEZUUifQ.eyJhdWQiOlsidGFsa2VyLWFwaSJdLCJleHAiOjE2MzQ4MzEwNTEsImlhdCI6MTYzNDgzMDQ1MSwiaXNzIjoiaHR0cHM6Ly9rdWJlcm5ldGVzLmRlZmF1bHQuc3ZjLmNsdXN0ZXIubG9jYWwiLCJrdWJlcm5ldGVzLmlvIjp7Im5hbWVzcGFjZSI6ImF1dGhvcmlubyIsInNlcnZpY2VhY2NvdW50Ijp7Im5hbWUiOiJhcGktY29uc3VtZXItMSIsInVpZCI6ImI0MGY1MzFjLWVjYWItNGYzMS1hNDk2LTJlYmM3MmFkZDEyMSJ9fSwibmJmIjoxNjM0ODMwNDUxLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6YXV0aG9yaW5vOmFwaS1jb25zdW1lci0xIn0.PaP0vqdl5DPfErr84KfVhPdlsGAPgsw0NkDaA9rne1zXjzcO7KPPbXhFwZC-oIjSGG1HfRMSoQeCXbQz24PSATmX8l1T52a9IFeXgP7sQmXZIDbiPfTm3X09kIIlfPKHhK_f-jQwRIpMRqNgLntlZ-xXX3P1fOBBUYR8obTPAQ6NDDaLHxw2SAmHFTQWjM_DInPDemXX0mEm7nCPKifsNxHaQH4wx4CD3LCLGbCI9FHNf2Crid8mmGJXf4wzcH1VuKkpUlsmnlUgTG2bfT2lbhSF2lBmrrhTJyYk6_aA09DwL4Bf4kvG-JtCq0Bkd_XynViIsOtOnAhgmdSPkfr-oA&quot;,&quot;audiences&quot;:[&quot;talker-api&quot;]},&quot;status&quot;:{&quot;user&quot;:{}}}}
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.1509938,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity&quot;,&quot;msg&quot;:&quot;cannot validate identity&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;api-keys&quot;,&quot;ExtendedProperties&quot;:[{&quot;Name&quot;:&quot;sub&quot;,&quot;Value&quot;:{&quot;Static&quot;:null,&quot;Pattern&quot;:&quot;auth.identity.metadata.annotations.userid&quot;}}],&quot;OAuth2&quot;:null,&quot;OIDC&quot;:null,&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;APIKEY&quot;,&quot;In&quot;:&quot;authorization_header&quot;},&quot;Name&quot;:&quot;api-keys&quot;,&quot;LabelSelectors&quot;:{&quot;audience&quot;:&quot;talker-api&quot;,&quot;authorino.kuadrant.io/managed-by&quot;:&quot;authorino&quot;}},&quot;KubernetesAuth&quot;:null},&quot;reason&quot;:&quot;credential not found&quot;}
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.1517606,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity.oauth2&quot;,&quot;msg&quot;:&quot;sending token introspection request&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;url&quot;:&quot;http://talker-api:523b92b6-625d-4e1e-a313-77e7a8ae4e88@keycloak:8080/realms/kuadrant/protocol/openid-connect/token/introspect&quot;,&quot;data&quot;:&quot;token=eyJhbGciOiJSUzI1NiIsImtpZCI6IkRsVWJZMENyVy1sZ0tFMVRMd19pcTFUWGtTYUl6T0hyWks0VHhKYnpEZUUifQ.eyJhdWQiOlsidGFsa2VyLWFwaSJdLCJleHAiOjE2MzQ4MzEwNTEsImlhdCI6MTYzNDgzMDQ1MSwiaXNzIjoiaHR0cHM6Ly9rdWJlcm5ldGVzLmRlZmF1bHQuc3ZjLmNsdXN0ZXIubG9jYWwiLCJrdWJlcm5ldGVzLmlvIjp7Im5hbWVzcGFjZSI6ImF1dGhvcmlubyIsInNlcnZpY2VhY2NvdW50Ijp7Im5hbWUiOiJhcGktY29uc3VtZXItMSIsInVpZCI6ImI0MGY1MzFjLWVjYWItNGYzMS1hNDk2LTJlYmM3MmFkZDEyMSJ9fSwibmJmIjoxNjM0ODMwNDUxLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6YXV0aG9yaW5vOmFwaS1jb25zdW1lci0xIn0.PaP0vqdl5DPfErr84KfVhPdlsGAPgsw0NkDaA9rne1zXjzcO7KPPbXhFwZC-oIjSGG1HfRMSoQeCXbQz24PSATmX8l1T52a9IFeXgP7sQmXZIDbiPfTm3X09kIIlfPKHhK_f-jQwRIpMRqNgLntlZ-xXX3P1fOBBUYR8obTPAQ6NDDaLHxw2SAmHFTQWjM_DInPDemXX0mEm7nCPKifsNxHaQH4wx4CD3LCLGbCI9FHNf2Crid8mmGJXf4wzcH1VuKkpUlsmnlUgTG2bfT2lbhSF2lBmrrhTJyYk6_aA09DwL4Bf4kvG-JtCq0Bkd_XynViIsOtOnAhgmdSPkfr-oA&amp;token_type_hint=requesting_party_token&quot;}
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.1620777,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity&quot;,&quot;msg&quot;:&quot;identity validated&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;k8s-service-accounts&quot;,&quot;ExtendedProperties&quot;:[],&quot;OAuth2&quot;:null,&quot;OIDC&quot;:null,&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:null,&quot;KubernetesAuth&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;}}},&quot;object&quot;:{&quot;aud&quot;:[&quot;talker-api&quot;],&quot;exp&quot;:1634831051,&quot;iat&quot;:1634830451,&quot;iss&quot;:&quot;https://kubernetes.default.svc.cluster.local&quot;,&quot;kubernetes.io&quot;:{&quot;namespace&quot;:&quot;authorino&quot;,&quot;serviceaccount&quot;:{&quot;name&quot;:&quot;api-consumer-1&quot;,&quot;uid&quot;:&quot;b40f531c-ecab-4f31-a496-2ebc72add121&quot;}},&quot;nbf&quot;:1634830451,&quot;sub&quot;:&quot;system:serviceaccount:authorino:api-consumer-1&quot;}}
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.1622565,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata.uma&quot;,&quot;msg&quot;:&quot;requesting pat&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;url&quot;:&quot;http://talker-api:523b92b6-625d-4e1e-a313-77e7a8ae4e88@keycloak:8080/realms/kuadrant/protocol/openid-connect/token&quot;,&quot;data&quot;:&quot;grant_type=client_credentials&quot;,&quot;headers&quot;:{&quot;Content-Type&quot;:[&quot;application/x-www-form-urlencoded&quot;]}}
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.1670353,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata.http&quot;,&quot;msg&quot;:&quot;sending request&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;url&quot;:&quot;http://talker-api.default.svc.cluster.local:3000/metadata?encoding=text/plain&amp;original_path=/hello&quot;,&quot;headers&quot;:{&quot;Content-Type&quot;:[&quot;text/plain&quot;]}}
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.169326,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata&quot;,&quot;msg&quot;:&quot;cannot fetch metadata&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;oidc-userinfo&quot;,&quot;UserInfo&quot;:{&quot;OIDC&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;},&quot;Endpoint&quot;:&quot;http://keycloak:8080/realms/kuadrant&quot;}},&quot;UMA&quot;:null,&quot;GenericHTTP&quot;:null},&quot;reason&quot;:&quot;Missing identity for OIDC issuer http://keycloak:8080/realms/kuadrant. Skipping related UserInfo metadata.&quot;}
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.1753876,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata&quot;,&quot;msg&quot;:&quot;fetched auth metadata&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;http-metadata&quot;,&quot;UserInfo&quot;:null,&quot;UMA&quot;:null,&quot;GenericHTTP&quot;:{&quot;Endpoint&quot;:&quot;http://talker-api.default.svc.cluster.local:3000/metadata?encoding=text/plain&amp;original_path={context.request.http.path}&quot;,&quot;Method&quot;:&quot;GET&quot;,&quot;Parameters&quot;:[],&quot;ContentType&quot;:&quot;application/x-www-form-urlencoded&quot;,&quot;SharedSecret&quot;:&quot;&quot;,&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;}}},&quot;object&quot;:{&quot;body&quot;:&quot;&quot;,&quot;headers&quot;:{&quot;Accept-Encoding&quot;:&quot;gzip&quot;,&quot;Content-Type&quot;:&quot;text/plain&quot;,&quot;Host&quot;:&quot;talker-api.default.svc.cluster.local:3000&quot;,&quot;User-Agent&quot;:&quot;Go-http-client/1.1&quot;,&quot;Version&quot;:&quot;HTTP/1.1&quot;},&quot;method&quot;:&quot;GET&quot;,&quot;path&quot;:&quot;/metadata&quot;,&quot;query_string&quot;:&quot;encoding=text/plain&amp;original_path=/hello&quot;,&quot;uuid&quot;:&quot;1aa6ac66-3179-4351-b1a7-7f6a761d5b61&quot;}}
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.2331996,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata.uma&quot;,&quot;msg&quot;:&quot;querying resources by uri&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;url&quot;:&quot;http://keycloak:8080/realms/kuadrant/authz/protection/resource_set?uri=/hello&quot;}
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.2495668,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata.uma&quot;,&quot;msg&quot;:&quot;getting resource data&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;url&quot;:&quot;http://keycloak:8080/realms/kuadrant/authz/protection/resource_set/e20d194c-274c-4845-8c02-0ca413c9bf18&quot;}
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.2927864,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata&quot;,&quot;msg&quot;:&quot;fetched auth metadata&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;uma-resource-registry&quot;,&quot;UserInfo&quot;:null,&quot;UMA&quot;:{&quot;Endpoint&quot;:&quot;http://keycloak:8080/realms/kuadrant&quot;,&quot;ClientID&quot;:&quot;talker-api&quot;,&quot;ClientSecret&quot;:&quot;523b92b6-625d-4e1e-a313-77e7a8ae4e88&quot;},&quot;GenericHTTP&quot;:null},&quot;object&quot;:[{&quot;_id&quot;:&quot;e20d194c-274c-4845-8c02-0ca413c9bf18&quot;,&quot;attributes&quot;:{},&quot;displayName&quot;:&quot;hello&quot;,&quot;name&quot;:&quot;hello&quot;,&quot;owner&quot;:{&quot;id&quot;:&quot;57a645a5-fb67-438b-8be5-dfb971666dbc&quot;},&quot;ownerManagedAccess&quot;:false,&quot;resource_scopes&quot;:[],&quot;uris&quot;:[&quot;/hi&quot;,&quot;/hello&quot;]}]}
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.2930083,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.authorization&quot;,&quot;msg&quot;:&quot;evaluating for input&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;input&quot;:{&quot;context&quot;:{&quot;source&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:53144}}}}},&quot;destination&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:8000}}}}},&quot;request&quot;:{&quot;time&quot;:{&quot;seconds&quot;:1634830460,&quot;nanos&quot;:147259000},&quot;http&quot;:{&quot;id&quot;:&quot;8157480586935853928&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;headers&quot;:{&quot;:authority&quot;:&quot;talker-api&quot;,&quot;:method&quot;:&quot;GET&quot;,&quot;:path&quot;:&quot;/hello&quot;,&quot;:scheme&quot;:&quot;http&quot;,&quot;accept&quot;:&quot;*/*&quot;,&quot;authorization&quot;:&quot;Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IkRsVWJZMENyVy1sZ0tFMVRMd19pcTFUWGtTYUl6T0hyWks0VHhKYnpEZUUifQ.eyJhdWQiOlsidGFsa2VyLWFwaSJdLCJleHAiOjE2MzQ4MzEwNTEsImlhdCI6MTYzNDgzMDQ1MSwiaXNzIjoiaHR0cHM6Ly9rdWJlcm5ldGVzLmRlZmF1bHQuc3ZjLmNsdXN0ZXIubG9jYWwiLCJrdWJlcm5ldGVzLmlvIjp7Im5hbWVzcGFjZSI6ImF1dGhvcmlubyIsInNlcnZpY2VhY2NvdW50Ijp7Im5hbWUiOiJhcGktY29uc3VtZXItMSIsInVpZCI6ImI0MGY1MzFjLWVjYWItNGYzMS1hNDk2LTJlYmM3MmFkZDEyMSJ9fSwibmJmIjoxNjM0ODMwNDUxLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6YXV0aG9yaW5vOmFwaS1jb25zdW1lci0xIn0.PaP0vqdl5DPfErr84KfVhPdlsGAPgsw0NkDaA9rne1zXjzcO7KPPbXhFwZC-oIjSGG1HfRMSoQeCXbQz24PSATmX8l1T52a9IFeXgP7sQmXZIDbiPfTm3X09kIIlfPKHhK_f-jQwRIpMRqNgLntlZ-xXX3P1fOBBUYR8obTPAQ6NDDaLHxw2SAmHFTQWjM_DInPDemXX0mEm7nCPKifsNxHaQH4wx4CD3LCLGbCI9FHNf2Crid8mmGJXf4wzcH1VuKkpUlsmnlUgTG2bfT2lbhSF2lBmrrhTJyYk6_aA09DwL4Bf4kvG-JtCq0Bkd_XynViIsOtOnAhgmdSPkfr-oA&quot;,&quot;user-agent&quot;:&quot;curl/7.65.3&quot;,&quot;x-envoy-internal&quot;:&quot;true&quot;,&quot;x-forwarded-for&quot;:&quot;10.244.0.11&quot;,&quot;x-forwarded-proto&quot;:&quot;http&quot;,&quot;x-request-id&quot;:&quot;4c5d5c97-e15b-46a3-877a-d8188e09e08f&quot;},&quot;path&quot;:&quot;/hello&quot;,&quot;host&quot;:&quot;talker-api&quot;,&quot;scheme&quot;:&quot;http&quot;,&quot;protocol&quot;:&quot;HTTP/1.1&quot;}},&quot;context_extensions&quot;:{&quot;virtual_host&quot;:&quot;local_service&quot;},&quot;metadata_context&quot;:{}},&quot;auth&quot;:{&quot;identity&quot;:{&quot;aud&quot;:[&quot;talker-api&quot;],&quot;exp&quot;:1634831051,&quot;iat&quot;:1634830451,&quot;iss&quot;:&quot;https://kubernetes.default.svc.cluster.local&quot;,&quot;kubernetes.io&quot;:{&quot;namespace&quot;:&quot;authorino&quot;,&quot;serviceaccount&quot;:{&quot;name&quot;:&quot;api-consumer-1&quot;,&quot;uid&quot;:&quot;b40f531c-ecab-4f31-a496-2ebc72add121&quot;}},&quot;nbf&quot;:1634830451,&quot;sub&quot;:&quot;system:serviceaccount:authorino:api-consumer-1&quot;},&quot;metadata&quot;:{&quot;http-metadata&quot;:{&quot;body&quot;:&quot;&quot;,&quot;headers&quot;:{&quot;Accept-Encoding&quot;:&quot;gzip&quot;,&quot;Content-Type&quot;:&quot;text/plain&quot;,&quot;Host&quot;:&quot;talker-api.default.svc.cluster.local:3000&quot;,&quot;User-Agent&quot;:&quot;Go-http-client/1.1&quot;,&quot;Version&quot;:&quot;HTTP/1.1&quot;},&quot;method&quot;:&quot;GET&quot;,&quot;path&quot;:&quot;/metadata&quot;,&quot;query_string&quot;:&quot;encoding=text/plain&amp;original_path=/hello&quot;,&quot;uuid&quot;:&quot;1aa6ac66-3179-4351-b1a7-7f6a761d5b61&quot;},&quot;uma-resource-registry&quot;:[{&quot;_id&quot;:&quot;e20d194c-274c-4845-8c02-0ca413c9bf18&quot;,&quot;attributes&quot;:{},&quot;displayName&quot;:&quot;hello&quot;,&quot;name&quot;:&quot;hello&quot;,&quot;owner&quot;:{&quot;id&quot;:&quot;57a645a5-fb67-438b-8be5-dfb971666dbc&quot;},&quot;ownerManagedAccess&quot;:false,&quot;resource_scopes&quot;:[],&quot;uris&quot;:[&quot;/hi&quot;,&quot;/hello&quot;]}]}}}}
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.2955465,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.authorization.kubernetesauthz&quot;,&quot;msg&quot;:&quot;calling kubernetes subject access review api&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;subjectaccessreview&quot;:{&quot;metadata&quot;:{&quot;creationTimestamp&quot;:null},&quot;spec&quot;:{&quot;nonResourceAttributes&quot;:{&quot;path&quot;:&quot;/hello&quot;,&quot;verb&quot;:&quot;get&quot;},&quot;user&quot;:&quot;system:serviceaccount:authorino:api-consumer-1&quot;},&quot;status&quot;:{&quot;allowed&quot;:false}}}
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.2986183,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.authorization&quot;,&quot;msg&quot;:&quot;access granted&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;my-policy&quot;,&quot;OPA&quot;:{&quot;Rego&quot;:&quot;fail := input.context.request.http.headers[\&quot;x-ext-auth-mock\&quot;] == \&quot;FAIL\&quot;\nallow { not fail }\n&quot;,&quot;OPAExternalSource&quot;:{&quot;Endpoint&quot;:&quot;&quot;,&quot;SharedSecret&quot;:&quot;&quot;,&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;}}},&quot;JSON&quot;:null,&quot;KubernetesAuthz&quot;:null},&quot;object&quot;:true}
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.3044975,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.authorization&quot;,&quot;msg&quot;:&quot;access granted&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;kubernetes-rbac&quot;,&quot;OPA&quot;:null,&quot;JSON&quot;:null,&quot;KubernetesAuthz&quot;:{&quot;Conditions&quot;:[],&quot;User&quot;:{&quot;Static&quot;:&quot;&quot;,&quot;Pattern&quot;:&quot;auth.identity.user.username&quot;},&quot;Groups&quot;:null,&quot;ResourceAttributes&quot;:null}},&quot;object&quot;:true}
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.3052874,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.response&quot;,&quot;msg&quot;:&quot;dynamic response built&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;wristband&quot;,&quot;Wrapper&quot;:&quot;httpHeader&quot;,&quot;WrapperKey&quot;:&quot;x-ext-auth-wristband&quot;,&quot;Wristband&quot;:{&quot;Issuer&quot;:&quot;https://authorino-oidc.default.svc:8083/default/talker-api-protection/wristband&quot;,&quot;CustomClaims&quot;:[],&quot;TokenDuration&quot;:300,&quot;SigningKeys&quot;:[{&quot;use&quot;:&quot;sig&quot;,&quot;kty&quot;:&quot;EC&quot;,&quot;kid&quot;:&quot;wristband-signing-key&quot;,&quot;crv&quot;:&quot;P-256&quot;,&quot;alg&quot;:&quot;ES256&quot;,&quot;x&quot;:&quot;TJf5NLVKplSYp95TOfhVPqvxvEibRyjrUZwwtpDuQZw&quot;,&quot;y&quot;:&quot;SSg8rKBsJ3J1LxyLtt0oFvhHvZcUpmRoTuHk3UHisTA&quot;,&quot;d&quot;:&quot;Me-5_zWBWVYajSGZcZMCcD8dXEa4fy85zv_yN7BxW-o&quot;}]},&quot;DynamicJSON&quot;:null},&quot;object&quot;:&quot;eyJhbGciOiJFUzI1NiIsImtpZCI6IndyaXN0YmFuZC1zaWduaW5nLWtleSIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MzQ4MzA3NjAsImlhdCI6MTYzNDgzMDQ2MCwiaXNzIjoiaHR0cHM6Ly9hdXRob3Jpbm8tb2lkYy5hdXRob3Jpbm8uc3ZjOjgwODMvYXV0aG9yaW5vL3RhbGtlci1hcGktcHJvdGVjdGlvbi93cmlzdGJhbmQiLCJzdWIiOiI4NDliMDk0ZDA4MzU0ZjM0MjA4ZGI3MjBmYWZmODlmNmM3NmYyOGY3MTcxOWI4NTQ3ZDk5NWNlNzAwMjU2ZGY4In0.Jn-VB5Q_0EX1ed1ji4KvhO4DlMqZeIl5H0qlukbTyYkp-Pgb4SnPGSbYWp5_uvG8xllsFAA5nuyBIXeba-dbkw&quot;}
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1634830460.3054585,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;outgoing authorization response&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;authorized&quot;:true,&quot;response&quot;:&quot;OK&quot;}
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830460.305476,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;outgoing authorization response&quot;,&quot;request id&quot;:&quot;8157480586935853928&quot;,&quot;authorized&quot;:true,&quot;response&quot;:&quot;OK&quot;}
-</span></code></pre></div>
-</details>
-<details>
-<summary>Enforcing an AuthConfig with authentication based on API keys</summary>
-<p><br/></p>
-<ul>
-<li>identity: k8s-auth, oidc, oauth2, apikey</li>
-<li>metadata: http, oidc userinfo</li>
-<li>authorization: opa, k8s-authz</li>
-<li>response: wristband</li>
-</ul>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1634830413.2425854,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;incoming authorization request&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;object&quot;:{&quot;source&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:52702}}}}},&quot;destination&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:8000}}}}},&quot;request&quot;:{&quot;http&quot;:{&quot;id&quot;:&quot;7199257136822741594&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;path&quot;:&quot;/hello&quot;,&quot;host&quot;:&quot;talker-api&quot;,&quot;scheme&quot;:&quot;http&quot;}}}}
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.2426975,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;incoming authorization request&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;object&quot;:{&quot;source&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:52702}}}}},&quot;destination&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:8000}}}}},&quot;request&quot;:{&quot;time&quot;:{&quot;seconds&quot;:1634830413,&quot;nanos&quot;:240094000},&quot;http&quot;:{&quot;id&quot;:&quot;7199257136822741594&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;headers&quot;:{&quot;:authority&quot;:&quot;talker-api&quot;,&quot;:method&quot;:&quot;GET&quot;,&quot;:path&quot;:&quot;/hello&quot;,&quot;:scheme&quot;:&quot;http&quot;,&quot;accept&quot;:&quot;*/*&quot;,&quot;authorization&quot;:&quot;APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&quot;,&quot;user-agent&quot;:&quot;curl/7.65.3&quot;,&quot;x-envoy-internal&quot;:&quot;true&quot;,&quot;x-forwarded-for&quot;:&quot;10.244.0.11&quot;,&quot;x-forwarded-proto&quot;:&quot;http&quot;,&quot;x-request-id&quot;:&quot;d38f5e66-bd72-4733-95d1-3179315cdd60&quot;},&quot;path&quot;:&quot;/hello&quot;,&quot;host&quot;:&quot;talker-api&quot;,&quot;scheme&quot;:&quot;http&quot;,&quot;protocol&quot;:&quot;HTTP/1.1&quot;}},&quot;context_extensions&quot;:{&quot;virtual_host&quot;:&quot;local_service&quot;},&quot;metadata_context&quot;:{}}}
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.2428744,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity&quot;,&quot;msg&quot;:&quot;cannot validate identity&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;k8s-service-accounts&quot;,&quot;ExtendedProperties&quot;:[],&quot;OAuth2&quot;:null,&quot;OIDC&quot;:null,&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:null,&quot;KubernetesAuth&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;}}},&quot;reason&quot;:&quot;credential not found&quot;}
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.2434332,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline&quot;,&quot;msg&quot;:&quot;skipping config&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;keycloak-jwts&quot;,&quot;ExtendedProperties&quot;:[],&quot;OAuth2&quot;:null,&quot;OIDC&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;},&quot;Endpoint&quot;:&quot;http://keycloak:8080/realms/kuadrant&quot;},&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:null,&quot;KubernetesAuth&quot;:null},&quot;reason&quot;:&quot;context canceled&quot;}
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.2479305,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity&quot;,&quot;msg&quot;:&quot;identity validated&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;api-keys&quot;,&quot;ExtendedProperties&quot;:[{&quot;Name&quot;:&quot;sub&quot;,&quot;Value&quot;:{&quot;Static&quot;:null,&quot;Pattern&quot;:&quot;auth.identity.metadata.annotations.userid&quot;}}],&quot;OAuth2&quot;:null,&quot;OIDC&quot;:null,&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;APIKEY&quot;,&quot;In&quot;:&quot;authorization_header&quot;},&quot;Name&quot;:&quot;api-keys&quot;,&quot;LabelSelectors&quot;:{&quot;audience&quot;:&quot;talker-api&quot;,&quot;authorino.kuadrant.io/managed-by&quot;:&quot;authorino&quot;}},&quot;KubernetesAuth&quot;:null},&quot;object&quot;:{&quot;apiVersion&quot;:&quot;v1&quot;,&quot;data&quot;:{&quot;api_key&quot;:&quot;bmR5QnpyZVV6RjR6cURRc3FTUE1Ia1JocmlFT3RjUng=&quot;},&quot;kind&quot;:&quot;Secret&quot;,&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;v1\&quot;,\&quot;kind\&quot;:\&quot;Secret\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{\&quot;userid\&quot;:\&quot;john\&quot;},\&quot;labels\&quot;:{\&quot;audience\&quot;:\&quot;talker-api\&quot;,\&quot;authorino.kuadrant.io/managed-by\&quot;:\&quot;authorino\&quot;},\&quot;name\&quot;:\&quot;api-key-1\&quot;,\&quot;namespace\&quot;:\&quot;authorino\&quot;},\&quot;stringData\&quot;:{\&quot;api_key\&quot;:\&quot;ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\&quot;},\&quot;type\&quot;:\&quot;Opaque\&quot;}\n&quot;,&quot;userid&quot;:&quot;john&quot;},&quot;creationTimestamp&quot;:&quot;2021-10-21T14:45:54Z&quot;,&quot;labels&quot;:{&quot;audience&quot;:&quot;talker-api&quot;,&quot;authorino.kuadrant.io/managed-by&quot;:&quot;authorino&quot;},&quot;managedFields&quot;:[{&quot;apiVersion&quot;:&quot;v1&quot;,&quot;fieldsType&quot;:&quot;FieldsV1&quot;,&quot;fieldsV1&quot;:{&quot;f:data&quot;:{&quot;.&quot;:{},&quot;f:api_key&quot;:{}},&quot;f:metadata&quot;:{&quot;f:annotations&quot;:{&quot;.&quot;:{},&quot;f:kubectl.kubernetes.io/last-applied-configuration&quot;:{},&quot;f:userid&quot;:{}},&quot;f:labels&quot;:{&quot;.&quot;:{},&quot;f:audience&quot;:{},&quot;f:authorino.kuadrant.io/managed-by&quot;:{}}},&quot;f:type&quot;:{}},&quot;manager&quot;:&quot;kubectl-client-side-apply&quot;,&quot;operation&quot;:&quot;Update&quot;,&quot;time&quot;:&quot;2021-10-21T14:45:54Z&quot;}],&quot;name&quot;:&quot;api-key-1&quot;,&quot;namespace&quot;:&quot;authorino&quot;,&quot;resourceVersion&quot;:&quot;8979&quot;,&quot;uid&quot;:&quot;c369852a-7e1a-43bd-94ca-e2b3f617052e&quot;},&quot;sub&quot;:&quot;john&quot;,&quot;type&quot;:&quot;Opaque&quot;}}
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.248768,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata.http&quot;,&quot;msg&quot;:&quot;sending request&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;url&quot;:&quot;http://talker-api.default.svc.cluster.local:3000/metadata?encoding=text/plain&amp;original_path=/hello&quot;,&quot;headers&quot;:{&quot;Content-Type&quot;:[&quot;text/plain&quot;]}}
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.2496722,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata&quot;,&quot;msg&quot;:&quot;cannot fetch metadata&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;oidc-userinfo&quot;,&quot;UserInfo&quot;:{&quot;OIDC&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;},&quot;Endpoint&quot;:&quot;http://keycloak:8080/realms/kuadrant&quot;}},&quot;UMA&quot;:null,&quot;GenericHTTP&quot;:null},&quot;reason&quot;:&quot;Missing identity for OIDC issuer http://keycloak:8080/realms/kuadrant. Skipping related UserInfo metadata.&quot;}
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.2497928,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata.uma&quot;,&quot;msg&quot;:&quot;requesting pat&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;url&quot;:&quot;http://talker-api:523b92b6-625d-4e1e-a313-77e7a8ae4e88@keycloak:8080/realms/kuadrant/protocol/openid-connect/token&quot;,&quot;data&quot;:&quot;grant_type=client_credentials&quot;,&quot;headers&quot;:{&quot;Content-Type&quot;:[&quot;application/x-www-form-urlencoded&quot;]}}
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.258932,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata&quot;,&quot;msg&quot;:&quot;fetched auth metadata&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;http-metadata&quot;,&quot;UserInfo&quot;:null,&quot;UMA&quot;:null,&quot;GenericHTTP&quot;:{&quot;Endpoint&quot;:&quot;http://talker-api.default.svc.cluster.local:3000/metadata?encoding=text/plain&amp;original_path={context.request.http.path}&quot;,&quot;Method&quot;:&quot;GET&quot;,&quot;Parameters&quot;:[],&quot;ContentType&quot;:&quot;application/x-www-form-urlencoded&quot;,&quot;SharedSecret&quot;:&quot;&quot;,&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;}}},&quot;object&quot;:{&quot;body&quot;:&quot;&quot;,&quot;headers&quot;:{&quot;Accept-Encoding&quot;:&quot;gzip&quot;,&quot;Content-Type&quot;:&quot;text/plain&quot;,&quot;Host&quot;:&quot;talker-api.default.svc.cluster.local:3000&quot;,&quot;User-Agent&quot;:&quot;Go-http-client/1.1&quot;,&quot;Version&quot;:&quot;HTTP/1.1&quot;},&quot;method&quot;:&quot;GET&quot;,&quot;path&quot;:&quot;/metadata&quot;,&quot;query_string&quot;:&quot;encoding=text/plain&amp;original_path=/hello&quot;,&quot;uuid&quot;:&quot;97529f8c-587b-4121-a4db-cd90c63871fd&quot;}}
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.2945344,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata.uma&quot;,&quot;msg&quot;:&quot;querying resources by uri&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;url&quot;:&quot;http://keycloak:8080/realms/kuadrant/authz/protection/resource_set?uri=/hello&quot;}
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.3123596,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata.uma&quot;,&quot;msg&quot;:&quot;getting resource data&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;url&quot;:&quot;http://keycloak:8080/realms/kuadrant/authz/protection/resource_set/e20d194c-274c-4845-8c02-0ca413c9bf18&quot;}
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.3340268,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.metadata&quot;,&quot;msg&quot;:&quot;fetched auth metadata&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;uma-resource-registry&quot;,&quot;UserInfo&quot;:null,&quot;UMA&quot;:{&quot;Endpoint&quot;:&quot;http://keycloak:8080/realms/kuadrant&quot;,&quot;ClientID&quot;:&quot;talker-api&quot;,&quot;ClientSecret&quot;:&quot;523b92b6-625d-4e1e-a313-77e7a8ae4e88&quot;},&quot;GenericHTTP&quot;:null},&quot;object&quot;:[{&quot;_id&quot;:&quot;e20d194c-274c-4845-8c02-0ca413c9bf18&quot;,&quot;attributes&quot;:{},&quot;displayName&quot;:&quot;hello&quot;,&quot;name&quot;:&quot;hello&quot;,&quot;owner&quot;:{&quot;id&quot;:&quot;57a645a5-fb67-438b-8be5-dfb971666dbc&quot;},&quot;ownerManagedAccess&quot;:false,&quot;resource_scopes&quot;:[],&quot;uris&quot;:[&quot;/hi&quot;,&quot;/hello&quot;]}]}
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.3367748,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.authorization&quot;,&quot;msg&quot;:&quot;evaluating for input&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;input&quot;:{&quot;context&quot;:{&quot;source&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:52702}}}}},&quot;destination&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:8000}}}}},&quot;request&quot;:{&quot;time&quot;:{&quot;seconds&quot;:1634830413,&quot;nanos&quot;:240094000},&quot;http&quot;:{&quot;id&quot;:&quot;7199257136822741594&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;headers&quot;:{&quot;:authority&quot;:&quot;talker-api&quot;,&quot;:method&quot;:&quot;GET&quot;,&quot;:path&quot;:&quot;/hello&quot;,&quot;:scheme&quot;:&quot;http&quot;,&quot;accept&quot;:&quot;*/*&quot;,&quot;authorization&quot;:&quot;APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&quot;,&quot;user-agent&quot;:&quot;curl/7.65.3&quot;,&quot;x-envoy-internal&quot;:&quot;true&quot;,&quot;x-forwarded-for&quot;:&quot;10.244.0.11&quot;,&quot;x-forwarded-proto&quot;:&quot;http&quot;,&quot;x-request-id&quot;:&quot;d38f5e66-bd72-4733-95d1-3179315cdd60&quot;},&quot;path&quot;:&quot;/hello&quot;,&quot;host&quot;:&quot;talker-api&quot;,&quot;scheme&quot;:&quot;http&quot;,&quot;protocol&quot;:&quot;HTTP/1.1&quot;}},&quot;context_extensions&quot;:{&quot;virtual_host&quot;:&quot;local_service&quot;},&quot;metadata_context&quot;:{}},&quot;auth&quot;:{&quot;identity&quot;:{&quot;apiVersion&quot;:&quot;v1&quot;,&quot;data&quot;:{&quot;api_key&quot;:&quot;bmR5QnpyZVV6RjR6cURRc3FTUE1Ia1JocmlFT3RjUng=&quot;},&quot;kind&quot;:&quot;Secret&quot;,&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;v1\&quot;,\&quot;kind\&quot;:\&quot;Secret\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{\&quot;userid\&quot;:\&quot;john\&quot;},\&quot;labels\&quot;:{\&quot;audience\&quot;:\&quot;talker-api\&quot;,\&quot;authorino.kuadrant.io/managed-by\&quot;:\&quot;authorino\&quot;},\&quot;name\&quot;:\&quot;api-key-1\&quot;,\&quot;namespace\&quot;:\&quot;authorino\&quot;},\&quot;stringData\&quot;:{\&quot;api_key\&quot;:\&quot;ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\&quot;},\&quot;type\&quot;:\&quot;Opaque\&quot;}\n&quot;,&quot;userid&quot;:&quot;john&quot;},&quot;creationTimestamp&quot;:&quot;2021-10-21T14:45:54Z&quot;,&quot;labels&quot;:{&quot;audience&quot;:&quot;talker-api&quot;,&quot;authorino.kuadrant.io/managed-by&quot;:&quot;authorino&quot;},&quot;managedFields&quot;:[{&quot;apiVersion&quot;:&quot;v1&quot;,&quot;fieldsType&quot;:&quot;FieldsV1&quot;,&quot;fieldsV1&quot;:{&quot;f:data&quot;:{&quot;.&quot;:{},&quot;f:api_key&quot;:{}},&quot;f:metadata&quot;:{&quot;f:annotations&quot;:{&quot;.&quot;:{},&quot;f:kubectl.kubernetes.io/last-applied-configuration&quot;:{},&quot;f:userid&quot;:{}},&quot;f:labels&quot;:{&quot;.&quot;:{},&quot;f:audience&quot;:{},&quot;f:authorino.kuadrant.io/managed-by&quot;:{}}},&quot;f:type&quot;:{}},&quot;manager&quot;:&quot;kubectl-client-side-apply&quot;,&quot;operation&quot;:&quot;Update&quot;,&quot;time&quot;:&quot;2021-10-21T14:45:54Z&quot;}],&quot;name&quot;:&quot;api-key-1&quot;,&quot;namespace&quot;:&quot;authorino&quot;,&quot;resourceVersion&quot;:&quot;8979&quot;,&quot;uid&quot;:&quot;c369852a-7e1a-43bd-94ca-e2b3f617052e&quot;},&quot;sub&quot;:&quot;john&quot;,&quot;type&quot;:&quot;Opaque&quot;},&quot;metadata&quot;:{&quot;http-metadata&quot;:{&quot;body&quot;:&quot;&quot;,&quot;headers&quot;:{&quot;Accept-Encoding&quot;:&quot;gzip&quot;,&quot;Content-Type&quot;:&quot;text/plain&quot;,&quot;Host&quot;:&quot;talker-api.default.svc.cluster.local:3000&quot;,&quot;User-Agent&quot;:&quot;Go-http-client/1.1&quot;,&quot;Version&quot;:&quot;HTTP/1.1&quot;},&quot;method&quot;:&quot;GET&quot;,&quot;path&quot;:&quot;/metadata&quot;,&quot;query_string&quot;:&quot;encoding=text/plain&amp;original_path=/hello&quot;,&quot;uuid&quot;:&quot;97529f8c-587b-4121-a4db-cd90c63871fd&quot;},&quot;uma-resource-registry&quot;:[{&quot;_id&quot;:&quot;e20d194c-274c-4845-8c02-0ca413c9bf18&quot;,&quot;attributes&quot;:{},&quot;displayName&quot;:&quot;hello&quot;,&quot;name&quot;:&quot;hello&quot;,&quot;owner&quot;:{&quot;id&quot;:&quot;57a645a5-fb67-438b-8be5-dfb971666dbc&quot;},&quot;ownerManagedAccess&quot;:false,&quot;resource_scopes&quot;:[],&quot;uris&quot;:[&quot;/hi&quot;,&quot;/hello&quot;]}]}}}}
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.339894,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.authorization&quot;,&quot;msg&quot;:&quot;access granted&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;my-policy&quot;,&quot;OPA&quot;:{&quot;Rego&quot;:&quot;fail := input.context.request.http.headers[\&quot;x-ext-auth-mock\&quot;] == \&quot;FAIL\&quot;\nallow { not fail }\n&quot;,&quot;OPAExternalSource&quot;:{&quot;Endpoint&quot;:&quot;&quot;,&quot;SharedSecret&quot;:&quot;&quot;,&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;}}},&quot;JSON&quot;:null,&quot;KubernetesAuthz&quot;:null},&quot;object&quot;:true}
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.3444238,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.authorization.kubernetesauthz&quot;,&quot;msg&quot;:&quot;calling kubernetes subject access review api&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;subjectaccessreview&quot;:{&quot;metadata&quot;:{&quot;creationTimestamp&quot;:null},&quot;spec&quot;:{&quot;nonResourceAttributes&quot;:{&quot;path&quot;:&quot;/hello&quot;,&quot;verb&quot;:&quot;get&quot;},&quot;user&quot;:&quot;john&quot;},&quot;status&quot;:{&quot;allowed&quot;:false}}}
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.3547812,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.authorization&quot;,&quot;msg&quot;:&quot;access granted&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;kubernetes-rbac&quot;,&quot;OPA&quot;:null,&quot;JSON&quot;:null,&quot;KubernetesAuthz&quot;:{&quot;Conditions&quot;:[],&quot;User&quot;:{&quot;Static&quot;:&quot;&quot;,&quot;Pattern&quot;:&quot;auth.identity.user.username&quot;},&quot;Groups&quot;:null,&quot;ResourceAttributes&quot;:null}},&quot;object&quot;:true}
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.3558292,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.response&quot;,&quot;msg&quot;:&quot;dynamic response built&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;wristband&quot;,&quot;Wrapper&quot;:&quot;httpHeader&quot;,&quot;WrapperKey&quot;:&quot;x-ext-auth-wristband&quot;,&quot;Wristband&quot;:{&quot;Issuer&quot;:&quot;https://authorino-oidc.default.svc:8083/default/talker-api-protection/wristband&quot;,&quot;CustomClaims&quot;:[],&quot;TokenDuration&quot;:300,&quot;SigningKeys&quot;:[{&quot;use&quot;:&quot;sig&quot;,&quot;kty&quot;:&quot;EC&quot;,&quot;kid&quot;:&quot;wristband-signing-key&quot;,&quot;crv&quot;:&quot;P-256&quot;,&quot;alg&quot;:&quot;ES256&quot;,&quot;x&quot;:&quot;TJf5NLVKplSYp95TOfhVPqvxvEibRyjrUZwwtpDuQZw&quot;,&quot;y&quot;:&quot;SSg8rKBsJ3J1LxyLtt0oFvhHvZcUpmRoTuHk3UHisTA&quot;,&quot;d&quot;:&quot;Me-5_zWBWVYajSGZcZMCcD8dXEa4fy85zv_yN7BxW-o&quot;}]},&quot;DynamicJSON&quot;:null},&quot;object&quot;:&quot;eyJhbGciOiJFUzI1NiIsImtpZCI6IndyaXN0YmFuZC1zaWduaW5nLWtleSIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MzQ4MzA3MTMsImlhdCI6MTYzNDgzMDQxMywiaXNzIjoiaHR0cHM6Ly9hdXRob3Jpbm8tb2lkYy5hdXRob3Jpbm8uc3ZjOjgwODMvYXV0aG9yaW5vL3RhbGtlci1hcGktcHJvdGVjdGlvbi93cmlzdGJhbmQiLCJzdWIiOiI5NjhiZjViZjk3MDM3NWRiNjE0ZDFhMDgzZTg2NTBhYTVhMGVhMzAyOTdiYmJjMTBlNWVlMWZmYTkxYTYwZmY4In0.7G440sWgi2TIaxrGJf5KWR9UOFpNTjwVYeaJXFLzsLhVNICoMLbYzBAEo4M3ym1jipxxTVeE7anm4qDDc7cnVQ&quot;}
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1634830413.3569078,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;outgoing authorization response&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;authorized&quot;:true,&quot;response&quot;:&quot;OK&quot;}
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830413.3569596,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;outgoing authorization response&quot;,&quot;request id&quot;:&quot;7199257136822741594&quot;,&quot;authorized&quot;:true,&quot;response&quot;:&quot;OK&quot;}
-</span></code></pre></div>
-</details>
-<details>
-<summary>Enforcing an AuthConfig with authentication based on API keys (invalid API key)</summary>
-<p><br/></p>
-<ul>
-<li>identity: k8s-auth, oidc, oauth2, apikey</li>
-<li>metadata: http, oidc userinfo</li>
-<li>authorization: opa, k8s-authz</li>
-<li>response: wristband</li>
-</ul>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1634830373.2066543,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;incoming authorization request&quot;,&quot;request id&quot;:&quot;12947265773116138711&quot;,&quot;object&quot;:{&quot;source&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:52288}}}}},&quot;destination&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:8000}}}}},&quot;request&quot;:{&quot;http&quot;:{&quot;id&quot;:&quot;12947265773116138711&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;path&quot;:&quot;/hello&quot;,&quot;host&quot;:&quot;talker-api&quot;,&quot;scheme&quot;:&quot;http&quot;}}}}
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830373.2068064,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;incoming authorization request&quot;,&quot;request id&quot;:&quot;12947265773116138711&quot;,&quot;object&quot;:{&quot;source&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:52288}}}}},&quot;destination&quot;:{&quot;address&quot;:{&quot;Address&quot;:{&quot;SocketAddress&quot;:{&quot;address&quot;:&quot;127.0.0.1&quot;,&quot;PortSpecifier&quot;:{&quot;PortValue&quot;:8000}}}}},&quot;request&quot;:{&quot;time&quot;:{&quot;seconds&quot;:1634830373,&quot;nanos&quot;:198329000},&quot;http&quot;:{&quot;id&quot;:&quot;12947265773116138711&quot;,&quot;method&quot;:&quot;GET&quot;,&quot;headers&quot;:{&quot;:authority&quot;:&quot;talker-api&quot;,&quot;:method&quot;:&quot;GET&quot;,&quot;:path&quot;:&quot;/hello&quot;,&quot;:scheme&quot;:&quot;http&quot;,&quot;accept&quot;:&quot;*/*&quot;,&quot;authorization&quot;:&quot;APIKEY invalid&quot;,&quot;user-agent&quot;:&quot;curl/7.65.3&quot;,&quot;x-envoy-internal&quot;:&quot;true&quot;,&quot;x-forwarded-for&quot;:&quot;10.244.0.11&quot;,&quot;x-forwarded-proto&quot;:&quot;http&quot;,&quot;x-request-id&quot;:&quot;9e391846-afe4-489a-8716-23a2e1c1aa77&quot;},&quot;path&quot;:&quot;/hello&quot;,&quot;host&quot;:&quot;talker-api&quot;,&quot;scheme&quot;:&quot;http&quot;,&quot;protocol&quot;:&quot;HTTP/1.1&quot;}},&quot;context_extensions&quot;:{&quot;virtual_host&quot;:&quot;local_service&quot;},&quot;metadata_context&quot;:{}}}
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830373.2070816,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity&quot;,&quot;msg&quot;:&quot;cannot validate identity&quot;,&quot;request id&quot;:&quot;12947265773116138711&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;keycloak-opaque&quot;,&quot;ExtendedProperties&quot;:[],&quot;OAuth2&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;},&quot;TokenIntrospectionUrl&quot;:&quot;http://keycloak:8080/realms/kuadrant/protocol/openid-connect/token/introspect&quot;,&quot;TokenTypeHint&quot;:&quot;requesting_party_token&quot;,&quot;ClientID&quot;:&quot;talker-api&quot;,&quot;ClientSecret&quot;:&quot;523b92b6-625d-4e1e-a313-77e7a8ae4e88&quot;},&quot;OIDC&quot;:null,&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:null,&quot;KubernetesAuth&quot;:null},&quot;reason&quot;:&quot;credential not found&quot;}
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830373.207225,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity&quot;,&quot;msg&quot;:&quot;cannot validate identity&quot;,&quot;request id&quot;:&quot;12947265773116138711&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;api-keys&quot;,&quot;ExtendedProperties&quot;:[{&quot;Name&quot;:&quot;sub&quot;,&quot;Value&quot;:{&quot;Static&quot;:null,&quot;Pattern&quot;:&quot;auth.identity.metadata.annotations.userid&quot;}}],&quot;OAuth2&quot;:null,&quot;OIDC&quot;:null,&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;APIKEY&quot;,&quot;In&quot;:&quot;authorization_header&quot;},&quot;Name&quot;:&quot;api-keys&quot;,&quot;LabelSelectors&quot;:{&quot;audience&quot;:&quot;talker-api&quot;,&quot;authorino.kuadrant.io/managed-by&quot;:&quot;authorino&quot;}},&quot;KubernetesAuth&quot;:null},&quot;reason&quot;:&quot;the API Key provided is invalid&quot;}
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830373.2072473,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity&quot;,&quot;msg&quot;:&quot;cannot validate identity&quot;,&quot;request id&quot;:&quot;12947265773116138711&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;k8s-service-accounts&quot;,&quot;ExtendedProperties&quot;:[],&quot;OAuth2&quot;:null,&quot;OIDC&quot;:null,&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:null,&quot;KubernetesAuth&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;}}},&quot;reason&quot;:&quot;credential not found&quot;}
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830373.2072592,&quot;logger&quot;:&quot;authorino.service.auth.authpipeline.identity&quot;,&quot;msg&quot;:&quot;cannot validate identity&quot;,&quot;request id&quot;:&quot;12947265773116138711&quot;,&quot;config&quot;:{&quot;Name&quot;:&quot;keycloak-jwts&quot;,&quot;ExtendedProperties&quot;:[],&quot;OAuth2&quot;:null,&quot;OIDC&quot;:{&quot;AuthCredentials&quot;:{&quot;KeySelector&quot;:&quot;Bearer&quot;,&quot;In&quot;:&quot;authorization_header&quot;},&quot;Endpoint&quot;:&quot;http://keycloak:8080/realms/kuadrant&quot;},&quot;MTLS&quot;:null,&quot;HMAC&quot;:null,&quot;APIKey&quot;:null,&quot;KubernetesAuth&quot;:null},&quot;reason&quot;:&quot;credential not found&quot;}
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1634830373.2073083,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;outgoing authorization response&quot;,&quot;request id&quot;:&quot;12947265773116138711&quot;,&quot;authorized&quot;:false,&quot;response&quot;:&quot;UNAUTHENTICATED&quot;,&quot;object&quot;:{&quot;code&quot;:16,&quot;status&quot;:302,&quot;message&quot;:&quot;Redirecting to login&quot;}}
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>{&quot;level&quot;:&quot;debug&quot;,&quot;ts&quot;:1634830373.2073889,&quot;logger&quot;:&quot;authorino.service.auth&quot;,&quot;msg&quot;:&quot;outgoing authorization response&quot;,&quot;request id&quot;:&quot;12947265773116138711&quot;,&quot;authorized&quot;:false,&quot;response&quot;:&quot;UNAUTHENTICATED&quot;,&quot;object&quot;:{&quot;code&quot;:16,&quot;status&quot;:302,&quot;message&quot;:&quot;Redirecting to login&quot;,&quot;headers&quot;:[{&quot;Location&quot;:&quot;https://my-app.io/login&quot;}]}}
-</span></code></pre></div>
-</details>
-<details>
-<summary>Deleting an AuthConfig and 2 related API key secrets</summary>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221361.5032296,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.secret&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;secret&quot;:&quot;default/api-key-1&quot;}
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221361.5057878,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.secret&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;secret&quot;:&quot;default/api-key-2&quot;}
-</span></code></pre></div>
-</details>
-<details>
-<summary>Shutting down the service</summary>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0135982,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Stopping and waiting for non leader election runnables&quot;}
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0136683,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Stopping and waiting for leader election runnables&quot;}
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0135982,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Stopping and waiting for non leader election runnables&quot;}
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0136883,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Stopping and waiting for leader election runnables&quot;}
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0137057,&quot;logger&quot;:&quot;authorino.controller.secret&quot;,&quot;msg&quot;:&quot;Shutdown signal received, waiting for all workers to finish&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;}
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.013724,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;Shutdown signal received, waiting for all workers to finish&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;}
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.01375,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;All workers finished&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;}
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.013752,&quot;logger&quot;:&quot;authorino.controller.secret&quot;,&quot;msg&quot;:&quot;All workers finished&quot;,&quot;reconciler group&quot;:&quot;&quot;,&quot;reconciler kind&quot;:&quot;Secret&quot;}
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0137632,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Stopping and waiting for caches&quot;}
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.013751,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;Shutdown signal received, waiting for all workers to finish&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;}
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0137684,&quot;logger&quot;:&quot;authorino.controller.authconfig&quot;,&quot;msg&quot;:&quot;All workers finished&quot;,&quot;reconciler group&quot;:&quot;authorino.kuadrant.io&quot;,&quot;reconciler kind&quot;:&quot;AuthConfig&quot;}
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0137722,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Stopping and waiting for caches&quot;}
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0138857,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Stopping and waiting for webhooks&quot;}
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0138955,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Wait completed, proceeding to shutdown the manager&quot;}
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0138893,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Stopping and waiting for webhooks&quot;}
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1669221635.0139785,&quot;logger&quot;:&quot;authorino&quot;,&quot;msg&quot;:&quot;Wait completed, proceeding to shutdown the manager&quot;}
-</span></code></pre></div>
-</details>
-<h2 id="tracing">Tracing<a class="headerlink" href="#tracing" title="Permanent link">&para;</a></h2>
-<h3 id="request-id">Request ID<a class="headerlink" href="#request-id" title="Permanent link">&para;</a></h3>
-<p>Processes related to the authorization request are identified and linked together by a <em>request ID</em>. The request ID can be:</p>
-<ul>
-<li>generated outside Authorino and passed in the authorization request – this is essentially the case of requests via GRPC authorization interface initiated by the Envoy;</li>
-<li>generated by Authorino – requests via <a href="../../architecture/#raw-http-authorization-interface">Raw HTTP Authorization interface</a>.</li>
-</ul>
-<h3 id="propagation">Propagation<a class="headerlink" href="#propagation" title="Permanent link">&para;</a></h3>
-<p>Authorino propagates trace identifiers compatible with the W3C Trace Context format <a href="https://www.w3.org/TR/trace-context/">https://www.w3.org/TR/trace-context/</a> and user-defined baggage data in the W3C Baggage format <a href="https://www.w3.org/TR/baggage">https://www.w3.org/TR/baggage</a>.</p>
-<h3 id="log-tracing">Log tracing<a class="headerlink" href="#log-tracing" title="Permanent link">&para;</a></h3>
-<p>Most log messages associated with an authorization request include the <a href="#request-id"><code>request id</code></a> value. This value can be used to match incoming request and corresponding outgoing response log messages, including at deep level when more fine-grained log details are enabled (<a href="#log-levels-and-log-modes"><code>debug</code> level level</a>).</p>
-<h3 id="opentelemetry-integration">OpenTelemetry integration<a class="headerlink" href="#opentelemetry-integration" title="Permanent link">&para;</a></h3>
-<p>Integration with an OpenTelemetry collector can be enabled by supplying the <code>--tracing-service-endpoint</code> command-line flag (e.g. <code>authorino server --tracing-service-endpoint=http://jaeger:14268/api/traces</code>).</p>
-<p>The additional <code>--tracing-service-tags</code> command-line flag allow to specify fixed agent-level key-value tags for the trace signals emitted by Authorino (e.g. <code>authorino server --tracing-service-endpoint=... --tracing-service-tag=key1=value1 --tracing-service-tag=key2=value2</code>).</p>
-<p>Traces related to authorization requests are additionally tagged with the <a href="#request-id"><code>authorino.request_id</code></a> attribute.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/oidc-jwt-authentication/index.html b/0.10.0/authorino/docs/user-guides/oidc-jwt-authentication/index.html
deleted file mode 100644
index 1fc8a68c6..000000000
--- a/0.10.0/authorino/docs/user-guides/oidc-jwt-authentication/index.html
+++ /dev/null
@@ -1,3730 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/oidc-jwt-authentication/">
-      
-      
-        <link rel="prev" href="../mtls-authentication/">
-      
-      
-        <link rel="next" href="../oauth2-token-introspection/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>OpenID Connect Discovery and authentication with JWTs - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-openid-connect-discovery-and-authentication-with-jwts" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              OpenID Connect Discovery and authentication with JWTs
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-the-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token with the Keycloak server
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-the-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token with the Keycloak server
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/oidc-jwt-authentication.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-openid-connect-discovery-and-authentication-with-jwts">User guide: OpenID Connect Discovery and authentication with JWTs<a class="headerlink" href="#user-guide-openid-connect-discovery-and-authentication-with-jwts" title="Permanent link">&para;</a></h1>
-<p>Validate JSON Web Tokens (JWT) issued and signed by an OpenID Connect server; leverage OpenID Connect Discovery to automatically fetch JSON Web Key Sets (JWKS).</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-    </ul>
-  </summary>
-<p>Authorino validates JSON Web Tokens (JWT) issued by an OpenID Connect server that implements OpenID Connect Discovery. Authorino fetches the OpenID Connect configuration and JSON Web Key Set (JWKS) from the issuer endpoint, and verifies the JSON Web Signature (JWS) and time validity of the token.</p>
-<p><em>Important!</em> Authorino does <strong>not</strong> implement <a href="https://datatracker.ietf.org/doc/html/rfc6749#section-4">OAuth2 grants</a> nor <a href="https://openid.net/specs/openid-connect-core-1_0.html#Authentication">OIDC authentication flows</a>. As a common recommendation of good practice, obtaining and refreshing access tokens is for clients to negotiate directly with the auth servers and token issuers. Authorino will only validate those tokens using the parameters provided by the trusted issuer authorities.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  listener:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    tls:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    tls:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">    &quot;keycloak-kuadrant-realm&quot;:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="obtain-an-access-token-with-the-keycloak-server">❻ Obtain an access token with the Keycloak server<a class="headerlink" href="#obtain-an-access-token-with-the-keycloak-server" title="Permanent link">&para;</a></h2>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=john&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>With a valid access token:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>With missing or invalid access token:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="c1"># www-authenticate: Bearer realm=&quot;keycloak-kuadrant-realm&quot;</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># x-ext-auth-reason: credential not found</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/oidc-rbac/index.html b/0.10.0/authorino/docs/user-guides/oidc-rbac/index.html
deleted file mode 100644
index 8213948f6..000000000
--- a/0.10.0/authorino/docs/user-guides/oidc-rbac/index.html
+++ /dev/null
@@ -1,3857 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/oidc-rbac/">
-      
-      
-        <link rel="prev" href="../json-pattern-matching-authorization/">
-      
-      
-        <link rel="next" href="../opa-authorization/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-openid-connect-oidc-and-role-based-access-control-rbac-with-authorino-and-keycloak" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Obtain an access token and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-john-member" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as John (member)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-jane-memberadmin" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Jane (member/admin)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Obtain an access token and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-john-member" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as John (member)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-jane-memberadmin" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Jane (member/admin)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/oidc-rbac.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-openid-connect-oidc-and-role-based-access-control-rbac-with-authorino-and-keycloak">User guide: OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Authorino and Keycloak<a class="headerlink" href="#user-guide-openid-connect-oidc-and-role-based-access-control-rbac-with-authorino-and-keycloak" title="Permanent link">&para;</a></h1>
-<p>Combine OpenID Connect (OIDC) authentication and Role-Based Access Control (RBAC) authorization rules leveraging Keycloak and Authorino working together.</p>
-<p>In this user guide, you will learn via example how to implement a simple Role-Based Access Control (RBAC) system to protect endpoints of an API, with roles assigned to users of an Identity Provider (Keycloak) and carried within the access tokens as JSON Web Token (JWT) claims. Users authenticate with the IdP via OAuth2/OIDC flow and get their access tokens verified and validated by Authorino on every request. Moreover, Authorino reads the role bindings of the user and enforces the proper RBAC rules based upon the context.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-      <li>Authorization → <a href="../features.md#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization</a></li>
-    </ul>
-  </summary>
-<p>Check out as well the user guides about <a href="../oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a> and <a href="../json-pattern-matching-authorization/">Simple pattern-matching authorization policies</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  listener:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    tls:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    tls:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>In this example, the Keycloak realm defines a few users and 2 realm roles: 'member' and 'admin'. When users authenticate to the Keycloak server by any of the supported OAuth2/OIDC flows, Keycloak adds to the access token JWT a claim <code>"realm_access": { "roles": array }</code> that holds the list of roles assigned to the user. Authorino will verify the JWT on requests to the API and read from that claim to enforce the following RBAC rules:</p>
-<table>
-<thead>
-<tr>
-<th>Path</th>
-<th>Method</th>
-<th style="text-align: center;">Role</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>/resources[/*]</td>
-<td>GET / POST / PUT</td>
-<td style="text-align: center;">member</td>
-</tr>
-<tr>
-<td>/resources/{id}</td>
-<td>DELETE</td>
-<td style="text-align: center;">admin</td>
-</tr>
-<tr>
-<td>/admin[/*]</td>
-<td>*</td>
-<td style="text-align: center;">admin</td>
-</tr>
-</tbody>
-</table>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p>Apply the AuthConfig:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">  authentication:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">    &quot;keycloak-kuadrant-realm&quot;:</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">      jwt:</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="s">  patterns:</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="s">    &quot;member-role&quot;:</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="s">    - selector: auth.identity.realm_access.roles</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="s">      operator: incl</span>
-</span><span id="__span-7-21"><a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="s">      value: member</span>
-</span><span id="__span-7-22"><a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="s">    &quot;admin-role&quot;:</span>
-</span><span id="__span-7-23"><a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a><span class="s">    - selector: auth.identity.realm_access.roles</span>
-</span><span id="__span-7-24"><a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a><span class="s">      operator: incl</span>
-</span><span id="__span-7-25"><a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a><span class="s">      value: admin</span>
-</span><span id="__span-7-26"><a id="__codelineno-7-26" name="__codelineno-7-26" href="#__codelineno-7-26"></a>
-</span><span id="__span-7-27"><a id="__codelineno-7-27" name="__codelineno-7-27" href="#__codelineno-7-27"></a><span class="s">  authorization:</span>
-</span><span id="__span-7-28"><a id="__codelineno-7-28" name="__codelineno-7-28" href="#__codelineno-7-28"></a><span class="s">    # RBAC rule: &#39;member&#39; role required for requests to /resources[/*]</span>
-</span><span id="__span-7-29"><a id="__codelineno-7-29" name="__codelineno-7-29" href="#__codelineno-7-29"></a><span class="s">    &quot;rbac-resources-api&quot;:</span>
-</span><span id="__span-7-30"><a id="__codelineno-7-30" name="__codelineno-7-30" href="#__codelineno-7-30"></a><span class="s">      when:</span>
-</span><span id="__span-7-31"><a id="__codelineno-7-31" name="__codelineno-7-31" href="#__codelineno-7-31"></a>
-</span><span id="__span-7-32"><a id="__codelineno-7-32" name="__codelineno-7-32" href="#__codelineno-7-32"></a><span class="s">      - selector: context.request.http.path</span>
-</span><span id="__span-7-33"><a id="__codelineno-7-33" name="__codelineno-7-33" href="#__codelineno-7-33"></a><span class="s">        operator: matches</span>
-</span><span id="__span-7-34"><a id="__codelineno-7-34" name="__codelineno-7-34" href="#__codelineno-7-34"></a><span class="s">        value: ^/resources(/.*)?$</span>
-</span><span id="__span-7-35"><a id="__codelineno-7-35" name="__codelineno-7-35" href="#__codelineno-7-35"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-7-36"><a id="__codelineno-7-36" name="__codelineno-7-36" href="#__codelineno-7-36"></a><span class="s">        patterns:</span>
-</span><span id="__span-7-37"><a id="__codelineno-7-37" name="__codelineno-7-37" href="#__codelineno-7-37"></a><span class="s">        - patternRef: member-role</span>
-</span><span id="__span-7-38"><a id="__codelineno-7-38" name="__codelineno-7-38" href="#__codelineno-7-38"></a>
-</span><span id="__span-7-39"><a id="__codelineno-7-39" name="__codelineno-7-39" href="#__codelineno-7-39"></a><span class="s">    # RBAC rule: &#39;admin&#39; role required for DELETE requests to /resources/{id}</span>
-</span><span id="__span-7-40"><a id="__codelineno-7-40" name="__codelineno-7-40" href="#__codelineno-7-40"></a><span class="s">    &quot;rbac-delete-resource&quot;:</span>
-</span><span id="__span-7-41"><a id="__codelineno-7-41" name="__codelineno-7-41" href="#__codelineno-7-41"></a><span class="s">      when:</span>
-</span><span id="__span-7-42"><a id="__codelineno-7-42" name="__codelineno-7-42" href="#__codelineno-7-42"></a>
-</span><span id="__span-7-43"><a id="__codelineno-7-43" name="__codelineno-7-43" href="#__codelineno-7-43"></a><span class="s">      - selector: context.request.http.path</span>
-</span><span id="__span-7-44"><a id="__codelineno-7-44" name="__codelineno-7-44" href="#__codelineno-7-44"></a><span class="s">        operator: matches</span>
-</span><span id="__span-7-45"><a id="__codelineno-7-45" name="__codelineno-7-45" href="#__codelineno-7-45"></a><span class="s">        value: ^/resources/\d+$</span>
-</span><span id="__span-7-46"><a id="__codelineno-7-46" name="__codelineno-7-46" href="#__codelineno-7-46"></a><span class="s">      - selector: context.request.http.method</span>
-</span><span id="__span-7-47"><a id="__codelineno-7-47" name="__codelineno-7-47" href="#__codelineno-7-47"></a><span class="s">        operator: eq</span>
-</span><span id="__span-7-48"><a id="__codelineno-7-48" name="__codelineno-7-48" href="#__codelineno-7-48"></a><span class="s">        value: DELETE</span>
-</span><span id="__span-7-49"><a id="__codelineno-7-49" name="__codelineno-7-49" href="#__codelineno-7-49"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-7-50"><a id="__codelineno-7-50" name="__codelineno-7-50" href="#__codelineno-7-50"></a><span class="s">        patterns:</span>
-</span><span id="__span-7-51"><a id="__codelineno-7-51" name="__codelineno-7-51" href="#__codelineno-7-51"></a><span class="s">        - patternRef: admin-role</span>
-</span><span id="__span-7-52"><a id="__codelineno-7-52" name="__codelineno-7-52" href="#__codelineno-7-52"></a>
-</span><span id="__span-7-53"><a id="__codelineno-7-53" name="__codelineno-7-53" href="#__codelineno-7-53"></a><span class="s">    # RBAC rule: &#39;admin&#39; role required for requests to /admin[/*]</span>
-</span><span id="__span-7-54"><a id="__codelineno-7-54" name="__codelineno-7-54" href="#__codelineno-7-54"></a><span class="s">    &quot;rbac-admin-api&quot;:</span>
-</span><span id="__span-7-55"><a id="__codelineno-7-55" name="__codelineno-7-55" href="#__codelineno-7-55"></a><span class="s">      when:</span>
-</span><span id="__span-7-56"><a id="__codelineno-7-56" name="__codelineno-7-56" href="#__codelineno-7-56"></a>
-</span><span id="__span-7-57"><a id="__codelineno-7-57" name="__codelineno-7-57" href="#__codelineno-7-57"></a><span class="s">      - selector: context.request.http.path</span>
-</span><span id="__span-7-58"><a id="__codelineno-7-58" name="__codelineno-7-58" href="#__codelineno-7-58"></a><span class="s">        operator: matches</span>
-</span><span id="__span-7-59"><a id="__codelineno-7-59" name="__codelineno-7-59" href="#__codelineno-7-59"></a><span class="s">        value: ^/admin(/.*)?$</span>
-</span><span id="__span-7-60"><a id="__codelineno-7-60" name="__codelineno-7-60" href="#__codelineno-7-60"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-7-61"><a id="__codelineno-7-61" name="__codelineno-7-61" href="#__codelineno-7-61"></a><span class="s">        patterns:</span>
-</span><span id="__span-7-62"><a id="__codelineno-7-62" name="__codelineno-7-62" href="#__codelineno-7-62"></a><span class="s">        - patternRef: admin-role</span>
-</span><span id="__span-7-63"><a id="__codelineno-7-63" name="__codelineno-7-63" href="#__codelineno-7-63"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="obtain-an-access-token-and-consume-the-api">❻ Obtain an access token and consume the API<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api" title="Permanent link">&para;</a></h2>
-<h3 id="obtain-an-access-token-and-consume-the-api-as-john-member">Obtain an access token and consume the API as John (member)<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api-as-john-member" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for John:</p>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster for the user John, who is assigned to the 'member' role:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=john&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<p>As John, send a <code>GET</code> request to <strong>/resources</strong>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/resources<span class="w"> </span>-i
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As John, send a <code>DELETE</code> request to <strong>/resources/123</strong>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/resources/123<span class="w"> </span>-i
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<p>As John, send a <code>GET</code> request to <strong>/admin/settings</strong>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/admin/settings<span class="w"> </span>-i
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<h3 id="obtain-an-access-token-and-consume-the-api-as-jane-memberadmin">Obtain an access token and consume the API as Jane (member/admin)<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api-as-jane-memberadmin" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token from within the cluster for the user Jane, who is assigned to the 'member' and 'admin' roles:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>As Jane, send a <code>GET</code> request to <strong>/resources</strong>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/resources<span class="w"> </span>-i
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Jane, send a <code>DELETE</code> request to <strong>/resources/123</strong>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/resources/123<span class="w"> </span>-i
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As Jane, send a <code>GET</code> request to <strong>/admin/settings</strong>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/admin/settings<span class="w"> </span>-i
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/oidc-user-info/index.html b/0.10.0/authorino/docs/user-guides/oidc-user-info/index.html
deleted file mode 100644
index 6d7d06ee8..000000000
--- a/0.10.0/authorino/docs/user-guides/oidc-user-info/index.html
+++ /dev/null
@@ -1,3743 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/oidc-user-info/">
-      
-      
-        <link rel="prev" href="../external-metadata/">
-      
-      
-        <link rel="next" href="../resource-level-authorization-uma/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>OpenID Connect UserInfo - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-openid-connect-userinfo" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              OpenID Connect UserInfo
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-the-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token with the Keycloak server
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-an-access-token-with-the-keycloak-server" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain an access token with the Keycloak server
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/oidc-user-info.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-openid-connect-userinfo">User guide: OpenID Connect UserInfo<a class="headerlink" href="#user-guide-openid-connect-userinfo" title="Permanent link">&para;</a></h1>
-<p>Fetch user info for OpenID Connect ID tokens in request-time for extra metadata for your policies and online verification of token validity.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>External auth metadata → <a href="../features.md#oidc-userinfo-metadatauserinfo">OIDC UserInfo</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-      <li>Authorization → <a href="../features.md#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization</a></li>
-    </ul>
-  </summary>
-<p>Apart from possibly complementing information of the JWT, fetching OpenID Connect UserInfo in request-time can be particularly useful for remote checking the state of the session, as opposed to only verifying the JWT/JWS offline. Implementation requires an OpenID Connect issuer (<a href="#openid-connect-oidc-jwtjose-verification-and-validation-identityoidc"><code>spec.identity.oidc</code></a>) configured in the same <code>AuthConfig</code>.</p>
-<p>Check out as well the user guide about <a href="../oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  listener:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    tls:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    tls:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">    &quot;keycloak-kuadrant-realm&quot;:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">  metadata:</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="s">    &quot;userinfo&quot;:</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="s">      userInfo:</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="s">        identitySource: keycloak-kuadrant-realm</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="s">  authorization:</span>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="s">    &quot;active-tokens-only&quot;:</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-7-21"><a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="s">        patterns:</span>
-</span><span id="__span-7-22"><a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="s">        - selector: &quot;auth.metadata.userinfo.email&quot; # user email expected from the userinfo instead of the jwt</span>
-</span><span id="__span-7-23"><a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a><span class="s">          operator: neq</span>
-</span><span id="__span-7-24"><a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a><span class="s">          value: &quot;&quot;</span>
-</span><span id="__span-7-25"><a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="obtain-an-access-token-with-the-keycloak-server">❻ Obtain an access token with the Keycloak server<a class="headerlink" href="#obtain-an-access-token-with-the-keycloak-server" title="Permanent link">&para;</a></h2>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nb">export</span><span class="w"> </span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span><span class="s1">&#39;&quot;ACCESS_TOKEN=&quot;+.access_token,&quot;REFRESH_TOKEN=&quot;+.refresh_token&#39;</span><span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>With a valid access token:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Revoke the access token and try to consume the API again:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/logout<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Content-Type: application/x-www-form-urlencoded&quot;</span><span class="w"> </span>-d<span class="w"> </span><span class="s2">&quot;refresh_token=</span><span class="nv">$REFRESH_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;token_type_hint=requesting_party_token&#39;</span><span class="w"> </span>-u<span class="w"> </span>demo:
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/opa-authorization/index.html b/0.10.0/authorino/docs/user-guides/opa-authorization/index.html
deleted file mode 100644
index 1fed8afc0..000000000
--- a/0.10.0/authorino/docs/user-guides/opa-authorization/index.html
+++ /dev/null
@@ -1,3768 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/opa-authorization/">
-      
-      
-        <link rel="prev" href="../oidc-rbac/">
-      
-      
-        <link rel="next" href="../kubernetes-subjectaccessreview/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Open Policy Agent (OPA) Rego policies - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-open-policy-agent-opa-rego-policies" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Open Policy Agent (OPA) Rego policies
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create the API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create the API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/opa-authorization.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-open-policy-agent-opa-rego-policies">User guide: Open Policy Agent (OPA) Rego policies<a class="headerlink" href="#user-guide-open-policy-agent-opa-rego-policies" title="Permanent link">&para;</a></h1>
-<p>Leverage the power of Open Policy Agent (OPA) policies, evaluated against Authorino's Authorization JSON in a built-in runtime compiled together with Authorino; pre-cache policies defined in Rego language inline or fetched from an external policy registry.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Authorization → <a href="../features.md#open-policy-agent-opa-rego-policies-authorizationopa">Open Policy Agent (OPA) Rego policies</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-    </ul>
-  </summary>
-<p>Authorino supports <a href="https://www.openpolicyagent.org">Open Policy Agent</a> policies, either inline defined in <a href="https://www.openpolicyagent.org/docs/latest/policy-language">Rego language</a> as part of the <code>AuthConfig</code> or fetched from an external endpoint, such as an OPA Policy Registry.</p>
-<p>Authorino's built-in OPA module precompiles the policies in reconciliation-time and cache them for fast evaluation in request-time, where they receive the Authorization JSON as input.</p>
-<p>Check out as well the user guide about <a href="../api-key-authentication/">Authentication with API keys</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>In this example, we will use OPA to implement a read-only policy for requests coming from outside a trusted network (IP range 192.168.1/24).</p>
-<p>The implementation relies on the <a href="https://datatracker.ietf.org/doc/html/rfc7239"><code>X-Forwarded-For</code></a> HTTP header to read the client's IP address.<sup id="fnref:5"><a class="footnote-ref" href="#fn:5">5</a></sup></p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;friends&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">        selector:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">            group: friends</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">          prefix: APIKEY</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">  authorization:</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">    &quot;read-only-outside&quot;:</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="s">      opa:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="s">        rego: |</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="s">          ips := split(input.context.request.http.headers[&quot;x-forwarded-for&quot;], &quot;,&quot;)</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="s">          trusted_network { net.cidr_contains(&quot;192.168.1.1/24&quot;, ips[0]) }</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="s">          allow { trusted_network }</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="s">          allow { not trusted_network; input.context.request.http.method == &quot;GET&quot; }</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-the-api-key">❻ Create the API key<a class="headerlink" href="#create-the-api-key" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">  labels:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    group: friends</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">stringData:</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>Inside the trusted network:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 192.168.1.10&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 192.168.1.10&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w">     </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Outside the trusted network:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 123.45.6.78&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="w">     </span>-H<span class="w"> </span><span class="s1">&#39;X-Forwarded-For: 123.45.6.78&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w">     </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w">     </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="c1"># x-ext-auth-reason: Unauthorized</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-1
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-<li id="fn:5">
-<p>You can also set <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/network/http_connection_manager/v3/http_connection_manager.proto#envoy-v3-api-field-extensions-filters-network-http-connection-manager-v3-httpconnectionmanager-use-remote-address"><code>use_remote_address: true</code></a> in the Envoy route configuration, so the proxy will append its IP address instead of run in transparent mode. This setting will also ensure real remote address of the client connection passed in the <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_conn_man/headers#config-http-conn-man-headers-x-envoy-external-address"><code>x-envoy-external-address</code></a> HTTP header, which can be used to simplify the read-only policy in remote environment.&#160;<a class="footnote-backref" href="#fnref:5" title="Jump back to footnote 5 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/passing-credentials/index.html b/0.10.0/authorino/docs/user-guides/passing-credentials/index.html
deleted file mode 100644
index 0bb6470d9..000000000
--- a/0.10.0/authorino/docs/user-guides/passing-credentials/index.html
+++ /dev/null
@@ -1,3811 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/passing-credentials/">
-      
-      
-        <link rel="prev" href="../oauth2-token-introspection/">
-      
-      
-        <link rel="next" href="../http-basic-authentication/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Passing credentials (`Authorization` header, cookie headers and others) - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-passing-credentials-authorization-header-cookie-headers-and-others" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Passing credentials (`Authorization` header, cookie headers and others)
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-api-keys" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create the API keys
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-api-keys" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create the API keys
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/passing-credentials.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-passing-credentials-authorization-header-cookie-headers-and-others">User guide: Passing credentials (<code>Authorization</code> header, cookie headers and others)<a class="headerlink" href="#user-guide-passing-credentials-authorization-header-cookie-headers-and-others" title="Permanent link">&para;</a></h1>
-<p>Customize where credentials are supplied in the request by each trusted source of identity.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#extra-auth-credentials-authenticationcredentials">Auth credentials</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-    </ul>
-  </summary>
-<p>Authentication tokens can be supplied in the <code>Authorization</code> header, in a custom header, cookie or query string parameter.</p>
-<p>Check out as well the user guide about <a href="../api-key-authentication/">Authentication with API keys</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  listener:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">    tls:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>In this example, <code>member</code> users can authenticate supplying the API key in any of 4 different ways:</p>
-<ul>
-<li>HTTP header <code>Authorization: APIKEY &lt;api-key&gt;</code></li>
-<li>HTTP header <code>X-API-Key: &lt;api-key&gt;</code></li>
-<li>Query string parameter <code>api_key=&lt;api-key&gt;</code></li>
-<li>Cookie <code>Cookie: APIKEY=&lt;api-key&gt;;</code></li>
-</ul>
-<p><code>admin</code> API keys are only accepted in the (default) HTTP header <code>Authorization: Bearer &lt;api-key&gt;</code>.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">    &quot;members-authorization-header&quot;:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">        selector:</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="s">            group: members</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">          prefix: APIKEY # instead of the default prefix &#39;Bearer&#39;</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="s">    &quot;members-custom-header&quot;:</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="s">        selector:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="s">            group: members</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="s">        customHeader:</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="s">          name: X-API-Key</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="s">    &quot;members-query-string-param&quot;:</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="s">        selector:</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a><span class="s">            group: members</span>
-</span><span id="__span-6-32"><a id="__codelineno-6-32" name="__codelineno-6-32" href="#__codelineno-6-32"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-33"><a id="__codelineno-6-33" name="__codelineno-6-33" href="#__codelineno-6-33"></a><span class="s">        queryString:</span>
-</span><span id="__span-6-34"><a id="__codelineno-6-34" name="__codelineno-6-34" href="#__codelineno-6-34"></a><span class="s">          name: api_key</span>
-</span><span id="__span-6-35"><a id="__codelineno-6-35" name="__codelineno-6-35" href="#__codelineno-6-35"></a><span class="s">    &quot;members-cookie&quot;:</span>
-</span><span id="__span-6-36"><a id="__codelineno-6-36" name="__codelineno-6-36" href="#__codelineno-6-36"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-37"><a id="__codelineno-6-37" name="__codelineno-6-37" href="#__codelineno-6-37"></a><span class="s">        selector:</span>
-</span><span id="__span-6-38"><a id="__codelineno-6-38" name="__codelineno-6-38" href="#__codelineno-6-38"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-39"><a id="__codelineno-6-39" name="__codelineno-6-39" href="#__codelineno-6-39"></a><span class="s">            group: members</span>
-</span><span id="__span-6-40"><a id="__codelineno-6-40" name="__codelineno-6-40" href="#__codelineno-6-40"></a><span class="s">      credentials:</span>
-</span><span id="__span-6-41"><a id="__codelineno-6-41" name="__codelineno-6-41" href="#__codelineno-6-41"></a><span class="s">        cookie:</span>
-</span><span id="__span-6-42"><a id="__codelineno-6-42" name="__codelineno-6-42" href="#__codelineno-6-42"></a><span class="s">          name: APIKEY</span>
-</span><span id="__span-6-43"><a id="__codelineno-6-43" name="__codelineno-6-43" href="#__codelineno-6-43"></a><span class="s">    &quot;admins&quot;:</span>
-</span><span id="__span-6-44"><a id="__codelineno-6-44" name="__codelineno-6-44" href="#__codelineno-6-44"></a><span class="s">      apiKey:</span>
-</span><span id="__span-6-45"><a id="__codelineno-6-45" name="__codelineno-6-45" href="#__codelineno-6-45"></a><span class="s">        selector:</span>
-</span><span id="__span-6-46"><a id="__codelineno-6-46" name="__codelineno-6-46" href="#__codelineno-6-46"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-6-47"><a id="__codelineno-6-47" name="__codelineno-6-47" href="#__codelineno-6-47"></a><span class="s">            group: admins</span>
-</span><span id="__span-6-48"><a id="__codelineno-6-48" name="__codelineno-6-48" href="#__codelineno-6-48"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-the-api-keys">❻ Create the API keys<a class="headerlink" href="#create-the-api-keys" title="Permanent link">&para;</a></h2>
-<p>For a member user:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">  labels:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    group: members</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">stringData:</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>For an admin user:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: api-key-2</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  labels:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">    group: admins</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">stringData:</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  api_key: 7BNaTmYGItSzXiwQLNHu82+x52p1XHgY</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<p>As member user, passing the API key in the <code>Authorization</code> header:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As member user, passing the API key in the custom <code>X-API-Key</code> header:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;X-API-Key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As member user, passing the API key in the query string parameter <code>api_key</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span><span class="s2">&quot;http://talker-api.127.0.0.1.nip.io:8000/hello?api_key=ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&quot;</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As member user, passing the API key in the <code>APIKEY</code> cookie header:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Cookie: APIKEY=ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx;foo=bar&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>As admin user:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: Bearer 7BNaTmYGItSzXiwQLNHu82+x52p1XHgY&#39;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Missing the API key:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="c1"># www-authenticate: APIKEY realm=&quot;members-authorization-header&quot;</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="c1"># www-authenticate: X-API-Key realm=&quot;members-custom-header&quot;</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="c1"># www-authenticate: api_key realm=&quot;members-query-string-param&quot;</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="c1"># www-authenticate: APIKEY realm=&quot;members-cookie&quot;</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="c1"># www-authenticate: Bearer realm=&quot;admins&quot;</span>
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="c1"># x-ext-auth-reason: {&quot;admins&quot;:&quot;credential not found&quot;,&quot;members-authorization-header&quot;:&quot;credential not found&quot;,&quot;members-cookie&quot;:&quot;credential not found&quot;,&quot;members-custom-header&quot;:&quot;credential not found&quot;,&quot;members-query-string-param&quot;:&quot;credential not found&quot;}</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-1
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-2
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/resource-level-authorization-uma/index.html b/0.10.0/authorino/docs/user-guides/resource-level-authorization-uma/index.html
deleted file mode 100644
index 7ff0c0884..000000000
--- a/0.10.0/authorino/docs/user-guides/resource-level-authorization-uma/index.html
+++ /dev/null
@@ -1,3880 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/resource-level-authorization-uma/">
-      
-      
-        <link rel="prev" href="../oidc-user-info/">
-      
-      
-        <link rel="next" href="../json-pattern-matching-authorization/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Resource-level authorization with User-Managed Access (UMA) resource registry - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-resource-level-authorization-with-user-managed-access-uma-resource-registry" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Resource-level authorization with User-Managed Access (UMA) resource registry
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-access-tokens-with-the-keycloak-server-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain access tokens with the Keycloak server and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Obtain access tokens with the Keycloak server and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-as-john-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token as John and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-as-jane-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token as Jane and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-as-peter-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token as Peter and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#obtain-access-tokens-with-the-keycloak-server-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Obtain access tokens with the Keycloak server and consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❻ Obtain access tokens with the Keycloak server and consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-as-john-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token as John and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-as-jane-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token as Jane and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-as-peter-and-consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token as Peter and consume the API
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/resource-level-authorization-uma.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-resource-level-authorization-with-user-managed-access-uma-resource-registry">User guide: Resource-level authorization with User-Managed Access (UMA) resource registry<a class="headerlink" href="#user-guide-resource-level-authorization-with-user-managed-access-uma-resource-registry" title="Permanent link">&para;</a></h1>
-<p>Fetch resource metadata relevant for your authorization policies from Keycloak authorization clients, using User-Managed Access (UMA) protocol.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>External auth metadata → <a href="../features.md#user-managed-access-uma-resource-registry-metadatauma">User-Managed Access (UMA) resource registry</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-      <li>Authorization → <a href="../features.md#open-policy-agent-opa-rego-policies-authorizationopa">Open Policy Agent (OPA) Rego policies</a></li>
-    </ul>
-  </summary>
-<p>Check out as well the user guides about <a href="../oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a> and <a href="../opa-authorization/">Open Policy Agent (OPA) Rego policies</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  listener:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    tls:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    tls:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p>
-<p>This example of resource-level authorization leverages part of Keycloak's User-Managed Access (UMA) support. Authorino will fetch resource attributes stored in a Keycloak resource server client.</p>
-<p>The Keycloak server also provides the identities. The <code>sub</code> claim of the Keycloak-issued ID tokens must match the owner of the requested resource, identified by the URI of the request.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p>Create a required secret that will be used by Authorino to initiate the authentication with the UMA registry.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: talker-api-uma-credentials</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">stringData:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  clientID: talker-api</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">  clientSecret: 523b92b6-625d-4e1e-a313-77e7a8ae4e88</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">type: Opaque</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create the config:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">spec:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">    &quot;keycloak-kuadrant-realm&quot;:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">  metadata:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">    &quot;resource-data&quot;:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">      uma:</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">        endpoint: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">        credentialsRef:</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">          name: talker-api-uma-credentials</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="s">  authorization:</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="s">    &quot;owned-resources&quot;:</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="s">      opa:</span>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="s">        rego: |</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="s">          COLLECTIONS = [&quot;greetings&quot;]</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a>
-</span><span id="__span-8-26"><a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="s">          http_request = input.context.request.http</span>
-</span><span id="__span-8-27"><a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="s">          http_method = http_request.method</span>
-</span><span id="__span-8-28"><a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a><span class="s">          requested_path_sections = split(trim_left(trim_right(http_request.path, &quot;/&quot;), &quot;/&quot;), &quot;/&quot;)</span>
-</span><span id="__span-8-29"><a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a>
-</span><span id="__span-8-30"><a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="s">          get { http_method == &quot;GET&quot; }</span>
-</span><span id="__span-8-31"><a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="s">          post { http_method == &quot;POST&quot; }</span>
-</span><span id="__span-8-32"><a id="__codelineno-8-32" name="__codelineno-8-32" href="#__codelineno-8-32"></a><span class="s">          put { http_method == &quot;PUT&quot; }</span>
-</span><span id="__span-8-33"><a id="__codelineno-8-33" name="__codelineno-8-33" href="#__codelineno-8-33"></a><span class="s">          delete { http_method == &quot;DELETE&quot; }</span>
-</span><span id="__span-8-34"><a id="__codelineno-8-34" name="__codelineno-8-34" href="#__codelineno-8-34"></a>
-</span><span id="__span-8-35"><a id="__codelineno-8-35" name="__codelineno-8-35" href="#__codelineno-8-35"></a><span class="s">          valid_collection { COLLECTIONS[_] == requested_path_sections[0] }</span>
-</span><span id="__span-8-36"><a id="__codelineno-8-36" name="__codelineno-8-36" href="#__codelineno-8-36"></a>
-</span><span id="__span-8-37"><a id="__codelineno-8-37" name="__codelineno-8-37" href="#__codelineno-8-37"></a><span class="s">          collection_endpoint {</span>
-</span><span id="__span-8-38"><a id="__codelineno-8-38" name="__codelineno-8-38" href="#__codelineno-8-38"></a><span class="s">            valid_collection</span>
-</span><span id="__span-8-39"><a id="__codelineno-8-39" name="__codelineno-8-39" href="#__codelineno-8-39"></a><span class="s">            count(requested_path_sections) == 1</span>
-</span><span id="__span-8-40"><a id="__codelineno-8-40" name="__codelineno-8-40" href="#__codelineno-8-40"></a><span class="s">          }</span>
-</span><span id="__span-8-41"><a id="__codelineno-8-41" name="__codelineno-8-41" href="#__codelineno-8-41"></a>
-</span><span id="__span-8-42"><a id="__codelineno-8-42" name="__codelineno-8-42" href="#__codelineno-8-42"></a><span class="s">          resource_endpoint {</span>
-</span><span id="__span-8-43"><a id="__codelineno-8-43" name="__codelineno-8-43" href="#__codelineno-8-43"></a><span class="s">            valid_collection</span>
-</span><span id="__span-8-44"><a id="__codelineno-8-44" name="__codelineno-8-44" href="#__codelineno-8-44"></a><span class="s">            some resource_id</span>
-</span><span id="__span-8-45"><a id="__codelineno-8-45" name="__codelineno-8-45" href="#__codelineno-8-45"></a><span class="s">            requested_path_sections[1] = resource_id</span>
-</span><span id="__span-8-46"><a id="__codelineno-8-46" name="__codelineno-8-46" href="#__codelineno-8-46"></a><span class="s">          }</span>
-</span><span id="__span-8-47"><a id="__codelineno-8-47" name="__codelineno-8-47" href="#__codelineno-8-47"></a>
-</span><span id="__span-8-48"><a id="__codelineno-8-48" name="__codelineno-8-48" href="#__codelineno-8-48"></a><span class="s">          identity_owns_the_resource {</span>
-</span><span id="__span-8-49"><a id="__codelineno-8-49" name="__codelineno-8-49" href="#__codelineno-8-49"></a><span class="s">            identity := input.auth.identity</span>
-</span><span id="__span-8-50"><a id="__codelineno-8-50" name="__codelineno-8-50" href="#__codelineno-8-50"></a><span class="s">            resource_attrs := object.get(input.auth.metadata, &quot;resource-data&quot;, [])[0]</span>
-</span><span id="__span-8-51"><a id="__codelineno-8-51" name="__codelineno-8-51" href="#__codelineno-8-51"></a><span class="s">            resource_owner := object.get(object.get(resource_attrs, &quot;owner&quot;, {}), &quot;id&quot;, &quot;&quot;)</span>
-</span><span id="__span-8-52"><a id="__codelineno-8-52" name="__codelineno-8-52" href="#__codelineno-8-52"></a><span class="s">            resource_owner == identity.sub</span>
-</span><span id="__span-8-53"><a id="__codelineno-8-53" name="__codelineno-8-53" href="#__codelineno-8-53"></a><span class="s">          }</span>
-</span><span id="__span-8-54"><a id="__codelineno-8-54" name="__codelineno-8-54" href="#__codelineno-8-54"></a>
-</span><span id="__span-8-55"><a id="__codelineno-8-55" name="__codelineno-8-55" href="#__codelineno-8-55"></a><span class="s">          allow { get;    collection_endpoint }</span>
-</span><span id="__span-8-56"><a id="__codelineno-8-56" name="__codelineno-8-56" href="#__codelineno-8-56"></a><span class="s">          allow { post;   collection_endpoint }</span>
-</span><span id="__span-8-57"><a id="__codelineno-8-57" name="__codelineno-8-57" href="#__codelineno-8-57"></a><span class="s">          allow { get;    resource_endpoint; identity_owns_the_resource }</span>
-</span><span id="__span-8-58"><a id="__codelineno-8-58" name="__codelineno-8-58" href="#__codelineno-8-58"></a><span class="s">          allow { put;    resource_endpoint; identity_owns_the_resource }</span>
-</span><span id="__span-8-59"><a id="__codelineno-8-59" name="__codelineno-8-59" href="#__codelineno-8-59"></a><span class="s">          allow { delete; resource_endpoint; identity_owns_the_resource }</span>
-</span><span id="__span-8-60"><a id="__codelineno-8-60" name="__codelineno-8-60" href="#__codelineno-8-60"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>The OPA policy <code>owned-resource</code> above enforces that all users can send GET and POST requests to <code>/greetings</code>, while only resource owners can send GET, PUT and DELETE requests to <code>/greetings/{resource-id}</code>.</p>
-<h2 id="obtain-access-tokens-with-the-keycloak-server-and-consume-the-api">❻ Obtain access tokens with the Keycloak server and consume the API<a class="headerlink" href="#obtain-access-tokens-with-the-keycloak-server-and-consume-the-api" title="Permanent link">&para;</a></h2>
-<h3 id="obtain-an-access-token-as-john-and-consume-the-api">Obtain an access token as John and consume the API<a class="headerlink" href="#obtain-an-access-token-as-john-and-consume-the-api" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token for user John (owner of the resource <code>/greetings/1</code> in the UMA registry):</p>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=john&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<p>As John, send requests to the API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/2<span class="w"> </span>-i
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<h3 id="obtain-an-access-token-as-jane-and-consume-the-api">Obtain an access token as Jane and consume the API<a class="headerlink" href="#obtain-an-access-token-as-jane-and-consume-the-api" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token for user Jane (owner of the resource <code>/greetings/2</code> in the UMA registry):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>As Jane, send requests to the API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1<span class="w"> </span>-i
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1<span class="w"> </span>-i
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/2
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h3 id="obtain-an-access-token-as-peter-and-consume-the-api">Obtain an access token as Peter and consume the API<a class="headerlink" href="#obtain-an-access-token-as-peter-and-consume-the-api" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token for user Peter (does not own any resource in the UMA registry):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=peter&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>As Jane, send requests to the API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1<span class="w"> </span>-i
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/1<span class="w"> </span>-i
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a>
-</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/greetings/2<span class="w"> </span>-i
-</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/talker-api-uma-credentials
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/sharding/index.html b/0.10.0/authorino/docs/user-guides/sharding/index.html
deleted file mode 100644
index 7a46f5cad..000000000
--- a/0.10.0/authorino/docs/user-guides/sharding/index.html
+++ /dev/null
@@ -1,3789 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/sharding/">
-      
-      
-        <link rel="prev" href="../host-override/">
-      
-      
-        <link rel="next" href="../../contributing/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Reducing the operational space: sharding, noise and multi-tenancy - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-reducing-the-operational-space" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Reducing the operational space: sharding, noise and multi-tenancy
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-instances-of-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy instances of Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-a-namespace-for-user-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Create a namespace for user resources
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-authconfigs-and-api-key-secrets-for-both-instances" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Create AuthConfigs and API key Secrets for both instances
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❹ Create AuthConfigs and API key Secrets for both instances">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#create-resources-for-authorino-staging" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create resources for authorino-staging
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-resources-for-authorino-production" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create resources for authorino-production
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#remove-a-resource-from-scope" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Remove a resource from scope
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-instances-of-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy instances of Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-a-namespace-for-user-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Create a namespace for user resources
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-authconfigs-and-api-key-secrets-for-both-instances" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Create AuthConfigs and API key Secrets for both instances
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❹ Create AuthConfigs and API key Secrets for both instances">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#create-resources-for-authorino-staging" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create resources for authorino-staging
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-resources-for-authorino-production" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create resources for authorino-production
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#remove-a-resource-from-scope" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Remove a resource from scope
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/sharding.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-reducing-the-operational-space">User guide: Reducing the operational space<a class="headerlink" href="#user-guide-reducing-the-operational-space" title="Permanent link">&para;</a></h1>
-<p>By default, Authorino will watch events related to all <code>AuthConfig</code> custom resources in the reconciliation space (namespace or entire cluster). Instances can be configured though to only watch a subset of the resources, thus allowing such as:</p>
-<ul>
-<li>to reduce noise and lower memory usage inside instances meant for restricted scope (e.g. Authorino deployed as a dedicated sidecar to protect only one host);</li>
-<li>sharding auth config data across multiple instances;</li>
-<li>multiple environments (e.g. staging, production) inside of a same cluster/namespace;</li>
-<li>providing managed instances of Authorino that all watch CRs cluster-wide, yet dedicated to organizations allowed to create and operate their own <code>AuthConfig</code>s across multiple namespaces.</li>
-</ul>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b>⚠️ <i>Important:</i></b>
-        This feature may not be available to users of Authorino via <a href="https://kuadrant.io">Kuadrant</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li><a href="https://docs.kuadrant.io/authorino/docs/architecture#sharding">Sharding</a></li>
-      <li>Identity verification &amp; authentication → <a href="https://docs.kuadrant.io/authorino/docs/features#api-key-authenticationapikey">API key</a></li>
-    </ul>
-  </summary>
-<p>Check out as well the user guide about <a href="../api-key-authentication/">Authentication with API keys</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-instances-of-authorino">❷ Deploy instances of Authorino<a class="headerlink" href="#deploy-instances-of-authorino" title="Permanent link">&para;</a></h2>
-<p>Deploy an instance of Authorino dedicated to <code>AuthConfig</code>s and API key <code>Secrets</code> labeled with <code>authorino/environment=staging</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: authorino-staging</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">  clusterWide: true</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">  authConfigLabelSelectors: authorino/environment=staging</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">  secretLabelSelectors: authorino/environment=staging</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">  listener:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">    tls:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="s">    tls:</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="s">      enabled: false</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Deploy an instance of Authorino dedicated to <code>AuthConfig</code>s and API key <code>Secrets</code> labeled with <code>authorino/environment=production</code>, ans NOT labeled <code>disabled</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino-production</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  clusterWide: true</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">  authConfigLabelSelectors: authorino/environment=production,!disabled</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">  secretLabelSelectors: authorino/environment=production,!disabled</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  listener:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    tls:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="s">    tls:</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>The commands above will both request instances of Authorino that watch for <code>AuthConfig</code> resources cluster-wide<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup>, with TLS disabled<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>.</p>
-<h2 id="create-a-namespace-for-user-resources">❸ Create a namespace for user resources<a class="headerlink" href="#create-a-namespace-for-user-resources" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>myapp
-</span></code></pre></div>
-<h2 id="create-authconfigs-and-api-key-secrets-for-both-instances">❹ Create <code>AuthConfig</code>s and API key <code>Secret</code>s for both instances<a class="headerlink" href="#create-authconfigs-and-api-key-secrets-for-both-instances" title="Permanent link">&para;</a></h2>
-<h3 id="create-resources-for-authorino-staging">Create resources for <code>authorino-staging</code><a class="headerlink" href="#create-resources-for-authorino-staging" title="Permanent link">&para;</a></h3>
-<p>Create an <code>AuthConfig</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  name: auth-config-1</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">  labels:</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">    authorino/environment: staging</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">spec:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="s">  hosts:</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="s">  - my-host.staging.io</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="s">  authentication:</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">    &quot;api-key&quot;:</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="s">      apiKey:</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="s">        selector:</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="s">            authorino/api-key: &quot;true&quot;</span>
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a><span class="s">            authorino/environment: staging</span>
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create an API key <code>Secret</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">  labels:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">    authorino/api-key: &quot;true&quot;</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="s">    authorino/environment: staging</span>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="s">stringData:</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Verify in the logs that only the <code>authorino-staging</code> instance adds the resources to the index:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>logs<span class="w"> </span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>pods<span class="w"> </span>-l<span class="w"> </span>authorino-resource<span class="o">=</span>authorino-staging<span class="w"> </span>-o<span class="w"> </span>name<span class="k">)</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="c1"># {&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1638382989.8327162,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;authconfig&quot;:&quot;myapp/auth-config-1&quot;}</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="c1"># {&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1638382989.837424,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig.statusupdater&quot;,&quot;msg&quot;:&quot;resource status updated&quot;,&quot;authconfig/status&quot;:&quot;myapp/auth-config-1&quot;}</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="c1"># {&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1638383144.9486837,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.secret&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;secret&quot;:&quot;myapp/api-key-1&quot;}</span>
-</span></code></pre></div>
-<h3 id="create-resources-for-authorino-production">Create resources for <code>authorino-production</code><a class="headerlink" href="#create-resources-for-authorino-production" title="Permanent link">&para;</a></h3>
-<p>Create an <code>AuthConfig</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: auth-config-2</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  labels:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">    authorino/environment: production</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">spec:</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  hosts:</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">  - my-host.io</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">  authentication:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">    &quot;api-key&quot;:</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">      apiKey:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">        selector:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">            authorino/api-key: &quot;true&quot;</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">            authorino/environment: production</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create an API key <code>Secret</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: api-key-2</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">  labels:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">    authorino/api-key: &quot;true&quot;</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">    authorino/environment: production</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">stringData:</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">  api_key: MUWdeBte7AbSWxl6CcvYNJ+3yEIm5CaL</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Verify in the logs that only the <code>authorino-production</code> instance adds the resources to the index:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>logs<span class="w"> </span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>pods<span class="w"> </span>-l<span class="w"> </span>authorino-resource<span class="o">=</span>authorino-production<span class="w"> </span>-o<span class="w"> </span>name<span class="k">)</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># {&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1638383423.86086,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig.statusupdater&quot;,&quot;msg&quot;:&quot;resource status updated&quot;,&quot;authconfig/status&quot;:&quot;myapp/auth-config-2&quot;}</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="c1"># {&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1638383423.8608105,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;authconfig&quot;:&quot;myapp/auth-config-2&quot;}</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># {&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1638383460.3515081,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.secret&quot;,&quot;msg&quot;:&quot;resource reconciled&quot;,&quot;secret&quot;:&quot;myapp/api-key-2&quot;}</span>
-</span></code></pre></div>
-<h2 id="remove-a-resource-from-scope">❺ Remove a resource from scope<a class="headerlink" href="#remove-a-resource-from-scope" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>label<span class="w"> </span>authconfig/auth-config-2<span class="w"> </span><span class="nv">disabled</span><span class="o">=</span><span class="nb">true</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># authconfig.authorino.kuadrant.io/auth-config-2 labeled</span>
-</span></code></pre></div>
-<p>Verify in the logs that the <code>authorino-production</code> instance removes the authconfig from the index:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>logs<span class="w"> </span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>pods<span class="w"> </span>-l<span class="w"> </span>authorino-resource<span class="o">=</span>authorino-production<span class="w"> </span>-o<span class="w"> </span>name<span class="k">)</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># {&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:1638383515.6428752,&quot;logger&quot;:&quot;authorino.controller-runtime.manager.controller.authconfig&quot;,&quot;msg&quot;:&quot;resource de-indexed&quot;,&quot;authconfig&quot;:&quot;myapp/auth-config-2&quot;}</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino-staging
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino-production
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>myapp
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p><code>cluster-wide</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/token-normalization/index.html b/0.10.0/authorino/docs/user-guides/token-normalization/index.html
deleted file mode 100644
index c0b3f7ac2..000000000
--- a/0.10.0/authorino/docs/user-guides/token-normalization/index.html
+++ /dev/null
@@ -1,3851 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/token-normalization/">
-      
-      
-        <link rel="prev" href="../anonymous-access/">
-      
-      
-        <link rel="next" href="../edge-authentication-architecture-festival-wristbands/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Token normalization - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-token-normalization" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Token normalization
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❼ Consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-jane-admin" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Jane (admin)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-john-member" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as John (member)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-api-using-the-api-key-to-authenticate-admin" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the API using the API key to authenticate (admin)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-talker-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Deploy the Talker API
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#setup-envoy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Setup Envoy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Create an AuthConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-an-api-key" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Create an API key
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#consume-the-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Consume the API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❼ Consume the API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-jane-admin" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as Jane (admin)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#obtain-an-access-token-and-consume-the-api-as-john-member" class="md-nav__link">
-    <span class="md-ellipsis">
-      Obtain an access token and consume the API as John (member)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#consume-the-api-using-the-api-key-to-authenticate-admin" class="md-nav__link">
-    <span class="md-ellipsis">
-      Consume the API using the API key to authenticate (admin)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/token-normalization.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-token-normalization">User guide: Token normalization<a class="headerlink" href="#user-guide-token-normalization" title="Permanent link">&para;</a></h1>
-<p>Broadly, the term token normalization in authentication systems usually implies the exchange of an authentication token, as provided by the user in a given format, and/or its associated identity claims, for another freshly issued token/set of claims, of a given (normalized) structure or format.</p>
-<p>The most typical use-case for token normalization involves accepting tokens issued by multiple trusted sources and of often varied authentication protocols, while ensuring that the eventual different data structures adopted by each of those sources are normalized, thus allowing to simplify policies and authorization checks that depend on those values. In general, however, any modification to the identity claims can be for the purpose of normalization.</p>
-<p>This user guide focuses on the aspect of mutation of the identity claims resolved from an authentication token, to a certain data format and/or by extending them, so that required attributes can thereafter be trusted to be present among the claims, in a desired form. For such, Authorino allows to extend resolved identity objects with custom attributes (custom claims) of either static values or with values fetched from the <a href="../../architecture/#the-authorization-json">Authorization JSON</a>.</p>
-<p>For not only normalizing the identity claims for purpose of writing simpler authorization checks and policies, but also getting Authorino to issue a new token in a normalized format, check the <a href="../../features/#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristband tokens</a> feature.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#extra-identity-extension-authenticationdefaults-and-authenticationoverrides">Identity extension</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#jwt-verification-authenticationjwt">JWT verification</a></li>
-      <li>Authorization → <a href="../features.md#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization</a></li>
-    </ul>
-  </summary>
-<p>Check out as well the user guides about <a href="../api-key-authentication/">Authentication with API keys</a>, <a href="../oidc-jwt-authentication/">OpenID Connect Discovery and authentication with JWTs</a> and <a href="../json-pattern-matching-authorization/">Simple pattern-matching authorization policies</a>.</p>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-<li><a href="https://stedolan.github.io/jq">jq</a>, to extract parts of JSON responses</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step ❺.</p>
-        <p>At step ❺, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS disabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  listener:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    tls:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    tls:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      enabled: false</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="deploy-the-talker-api">❸ Deploy the Talker API<a class="headerlink" href="#deploy-the-talker-api" title="Permanent link">&para;</a></h2>
-<p>The <strong>Talker API</strong> is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span></code></pre></div>
-<h2 id="setup-envoy">❹ Setup Envoy<a class="headerlink" href="#setup-envoy" title="Permanent link">&para;</a></h2>
-<p>The following bundle from the Authorino examples deploys the <a href="https://envoyproxy.io/">Envoy</a> proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup id="fnref:4"><a class="footnote-ref" href="#fn:4">4</a></sup></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span></code></pre></div>
-<p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>deployment/envoy<span class="w"> </span><span class="m">8000</span>:8000<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<h2 id="create-an-authconfig">❺ Create an <code>AuthConfig</code><a class="headerlink" href="#create-an-authconfig" title="Permanent link">&para;</a></h2>
-<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p>
-<p>This example implements a policy that only users bound to the <code>admin</code> role can send <code>DELETE</code> requests.</p>
-<p>The config trusts access tokens issued by a Keycloak realm as well as API keys labeled specifically to a selected group (<code>friends</code>). The roles of the identities handled by Keycloak are managed in Keycloak, as <em>realm roles</em>. Particularly, users <code>john</code> and <code>peter</code> are bound to the <code>member</code> role, while user <code>jane</code> is bound to roles <code>member</code> and <code>admin</code>. As for the users authenticating with API key, they are all bound to the <code>admin</code> role.</p>
-<p>Without normalizing identity claims from these two different sources, the policy would have to handle the differences of data formats with additional ifs-and-elses. Instead, the config here uses the <code>identity.extendedProperties</code> option to ensure a custom <code>roles</code> (Array) claim is always present in the identity object. In the case of Keycloak ID tokens, the value is extracted from the <code>realm_access.roles</code> claim; for API key-resolved objects, the custom claim is set to the static value <code>["admin"]</code>.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        Remember to create an <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead of an AuthConfig.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: talker-api-protection</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  - talker-api.127.0.0.1.nip.io</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">    &quot;keycloak-kuadrant-realm&quot;:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">      overrides:</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="s">        &quot;roles&quot;:</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="s">          selector: auth.identity.realm_access.roles</span>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="s">    &quot;api-key-friends&quot;:</span>
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="s">      apiKey:</span>
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="s">        selector:</span>
-</span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="s">          matchLabels:</span>
-</span><span id="__span-7-21"><a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="s">            group: friends</span>
-</span><span id="__span-7-22"><a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="s">      credentials:</span>
-</span><span id="__span-7-23"><a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a><span class="s">        authorizationHeader:</span>
-</span><span id="__span-7-24"><a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a><span class="s">          prefix: APIKEY</span>
-</span><span id="__span-7-25"><a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a><span class="s">      defaults:</span>
-</span><span id="__span-7-26"><a id="__codelineno-7-26" name="__codelineno-7-26" href="#__codelineno-7-26"></a><span class="s">        &quot;roles&quot;:</span>
-</span><span id="__span-7-27"><a id="__codelineno-7-27" name="__codelineno-7-27" href="#__codelineno-7-27"></a><span class="s">          value: [&quot;admin&quot;]</span>
-</span><span id="__span-7-28"><a id="__codelineno-7-28" name="__codelineno-7-28" href="#__codelineno-7-28"></a><span class="s">  authorization:</span>
-</span><span id="__span-7-29"><a id="__codelineno-7-29" name="__codelineno-7-29" href="#__codelineno-7-29"></a><span class="s">    &quot;only-admins-can-delete&quot;:</span>
-</span><span id="__span-7-30"><a id="__codelineno-7-30" name="__codelineno-7-30" href="#__codelineno-7-30"></a><span class="s">      when:</span>
-</span><span id="__span-7-31"><a id="__codelineno-7-31" name="__codelineno-7-31" href="#__codelineno-7-31"></a><span class="s">      - selector: context.request.http.method</span>
-</span><span id="__span-7-32"><a id="__codelineno-7-32" name="__codelineno-7-32" href="#__codelineno-7-32"></a><span class="s">        operator: eq</span>
-</span><span id="__span-7-33"><a id="__codelineno-7-33" name="__codelineno-7-33" href="#__codelineno-7-33"></a><span class="s">        value: DELETE</span>
-</span><span id="__span-7-34"><a id="__codelineno-7-34" name="__codelineno-7-34" href="#__codelineno-7-34"></a><span class="s">      patternMatching:</span>
-</span><span id="__span-7-35"><a id="__codelineno-7-35" name="__codelineno-7-35" href="#__codelineno-7-35"></a><span class="s">        patterns:</span>
-</span><span id="__span-7-36"><a id="__codelineno-7-36" name="__codelineno-7-36" href="#__codelineno-7-36"></a><span class="s">        - selector: auth.identity.roles</span>
-</span><span id="__span-7-37"><a id="__codelineno-7-37" name="__codelineno-7-37" href="#__codelineno-7-37"></a><span class="s">          operator: incl</span>
-</span><span id="__span-7-38"><a id="__codelineno-7-38" name="__codelineno-7-38" href="#__codelineno-7-38"></a><span class="s">          value: admin</span>
-</span><span id="__span-7-39"><a id="__codelineno-7-39" name="__codelineno-7-39" href="#__codelineno-7-39"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-an-api-key">❻ Create an API key<a class="headerlink" href="#create-an-api-key" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: api-key-1</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  labels:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">    group: friends</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">stringData:</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">type: Opaque</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="consume-the-api">❼ Consume the API<a class="headerlink" href="#consume-the-api" title="Permanent link">&para;</a></h2>
-<h3 id="obtain-an-access-token-and-consume-the-api-as-jane-admin">Obtain an access token and consume the API as Jane (admin)<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api-as-jane-admin" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for Jane:</p>
-<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p>
-<p>Obtain an access token from within the cluster for the user Jane, whose e-mail has been verified:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=jane&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>
-<p>Consume the API as Jane:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h3 id="obtain-an-access-token-and-consume-the-api-as-john-member">Obtain an access token and consume the API as John (member)<a class="headerlink" href="#obtain-an-access-token-and-consume-the-api-as-john-member" title="Permanent link">&para;</a></h3>
-<p>Obtain an access token with the Keycloak server for John:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=john&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>Consume the API as John:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<h3 id="consume-the-api-using-the-api-key-to-authenticate-admin">Consume the API using the API key to authenticate (admin)<a class="headerlink" href="#consume-the-api-using-the-api-key-to-authenticate-admin" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx&quot;</span><span class="w"> </span>-X<span class="w"> </span>DELETE<span class="w"> </span>http://talker-api.127.0.0.1.nip.io:8000/hello<span class="w"> </span>-i
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>secret/api-key-1
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authconfig/talker-api-protection
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>authorino/authorino
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>namespaced</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-<li id="fn:4">
-<p>For details and instructions to setup Envoy manually, see <em>Protect a service &gt; Setup Envoy</em> in the <a href="../../getting-started/#step-setup-envoy">Getting Started</a> page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out <a href="https://kuadrant.io">Kuadrant</a>.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 4 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/docs/user-guides/validating-webhook/index.html b/0.10.0/authorino/docs/user-guides/validating-webhook/index.html
deleted file mode 100644
index 2b2b2b2b7..000000000
--- a/0.10.0/authorino/docs/user-guides/validating-webhook/index.html
+++ /dev/null
@@ -1,4161 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/validating-webhook/">
-      
-      
-        <link rel="prev" href="../envoy-jwt-authn-and-authorino/">
-      
-      
-        <link rel="next" href="../caching/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Setting up Kuadrant authorization service as a Validating Webhook - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#user-guide-using-authorino-as-validatingwebhook-service" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Setting up Kuadrant authorization service as a Validating Webhook
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-authconfig-and-related-clusterrole" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Create the AuthConfig and related ClusterRole
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-validatingwebhookconfiguration" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Create the ValidatingWebhookConfiguration
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#try-it-out" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Try it out
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❺ Try it out">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#with-a-valid-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      With a valid AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#with-forbidden-features" class="md-nav__link">
-    <span class="md-ellipsis">
-      With forbidden features
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#with-features-that-require-additional-permissions" class="md-nav__link">
-    <span class="md-ellipsis">
-      With features that require additional permissions
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#with-features-that-require-specific-property-validation" class="md-nav__link">
-    <span class="md-ellipsis">
-      With features that require specific property validation
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#install-the-authorino-operator-cluster-admin-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Install the Authorino Operator (cluster admin required)
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-authorino" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Deploy Authorino
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-authconfig-and-related-clusterrole" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Create the AuthConfig and related ClusterRole
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#create-the-validatingwebhookconfiguration" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Create the ValidatingWebhookConfiguration
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#try-it-out" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Try it out
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="❺ Try it out">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#with-a-valid-authconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      With a valid AuthConfig
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#with-forbidden-features" class="md-nav__link">
-    <span class="md-ellipsis">
-      With forbidden features
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#with-features-that-require-additional-permissions" class="md-nav__link">
-    <span class="md-ellipsis">
-      With features that require additional permissions
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#with-features-that-require-specific-property-validation" class="md-nav__link">
-    <span class="md-ellipsis">
-      With features that require specific property validation
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/docs/user-guides/validating-webhook.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="user-guide-using-authorino-as-validatingwebhook-service">User guide: Using Authorino as ValidatingWebhook service<a class="headerlink" href="#user-guide-using-authorino-as-validatingwebhook-service" title="Permanent link">&para;</a></h1>
-<p>Authorino provides an interface for raw HTTP external authorization requests. This interface can be used for integrations other than the typical Envoy gRPC protocol, such as (though not limited to) using Authorino as a generic Kubernetes ValidatingWebhook service.</p>
-<p>The rules to validate a request to the Kubernetes API – typically a <code>POST</code>, <code>PUT</code> or <code>DELETE</code> request targeting a particular Kubernetes resource or collection –, according to which either the change will be deemed accepted or not, are written in an Authorino <code>AuthConfig</code> custom resource. Authentication and authorization are performed by the Kubernetes API server as usual, with auth features of Authorino implementing the additional validation within the scope of an <code>AdmissionReview</code> request.</p>
-<p>This user guide provides an example of using Authorino as a Kubernetes ValidatingWebhook service that validates requests to <code>CREATE</code> and <code>UPDATE</code> Authorino <code>AuthConfig</code> resources. In other words, we will use Authorino as a validator inside the cluster that decides what is a valid AuthConfig for any application which wants to rely on Authorino to protect itself.</p>
-<details>
-<summary>
-    <strong>Authorino capabilities featured in this guide:</strong>
-    <ul>
-      <li>Identity verification &amp; authentication → <a href="../features.md#plain-authenticationplain">Plain</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#kubernetes-tokenreview-authenticationkubernetestokenreview">Kubernetes TokenReview</a></li>
-      <li>Identity verification &amp; authentication → <a href="../features.md#api-key-authenticationapikey">API key</a></li>
-      <li>External auth metadata → <a href="../features.md#http-getget-by-post-metadatahttp">HTTP GET/GET-by-POST</a></li>
-      <li>Authorization → <a href="../features.md#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview">Kubernetes SubjectAccessReview</a></li>
-      <li>Authorization → <a href="../features.md#open-policy-agent-opa-rego-policies-authorizationopa">Open Policy Agent (OPA) Rego policies</a></li>
-      <li>Dynamic response → <a href="../features.md#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristband tokens</a></li>
-      <li>Common feature → <a href="../features.md#common-feature-conditions-when">Conditions</a></li>
-      <li>Common feature → <a href="../features.md#common-feature-priorities">Priorities</a></li>
-    </ul>
-  </summary>
-<p>For further details about Authorino features in general, check the <a href="../../features/">docs</a>.</p>
-</details>
-<p><br/></p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li>
-<li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. <a href="https://www.keycloak.org">Keycloak</a>)</li>
-</ul>
-<p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having <a href="https://kind.sigs.k8s.io">Kind</a> installed, with either <a href="https://www.docker.com/">Docker</a> or <a href="https://podman.io/">Podman</a>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kind<span class="w"> </span>create<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Deploy the identity provider and authentication server. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p>
-<p>The Keycloak server is only needed for trying out validating AuthConfig resources that use the authentication server.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<p><br/></p>
-<p>The next steps walk you through installing Authorino, deploying and configuring a sample service called <strong>Talker API</strong> to be protected by the authorization service.</p>
-<table>
-  <thead>
-    <tr>
-      <th>Using Kuadrant</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p>If you are a user of <a href="https://kuadrant.io">Kuadrant</a> you may already have Authorino installed and running. In this case, skip straight to step ❸.</p>
-        <p>At step ❺, alternatively to creating an <code>AuthConfig</code> custom resource, you may create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p>
-        <p>For more about using Kuadrant to enforce authorization, check out <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<p><br/></p>
-<h2 id="install-the-authorino-operator-cluster-admin-required">❶ Install the Authorino Operator (cluster admin required)<a class="headerlink" href="#install-the-authorino-operator-cluster-admin-required" title="Permanent link">&para;</a></h2>
-<p>The following command will install the <a href="http://github.com/kuadrant/authorino-operator">Authorino Operator</a> in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s
-</span></code></pre></div>
-<h2 id="deploy-authorino">❷ Deploy Authorino<a class="headerlink" href="#deploy-authorino" title="Permanent link">&para;</a></h2>
-<p>Create the namespace:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>authorino
-</span></code></pre></div>
-<p>Create the TLS certificates:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>curl<span class="w"> </span>-sSL<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino/main/deploy/certs.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span><span class="s2">&quot;s/\$(AUTHORINO_INSTANCE)/authorino/g;s/\$(NAMESPACE)/authorino/g&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div>
-<p>Create the Authorino instance:</p>
-<p>The following command will request an instance of Authorino as a separate service<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup> that watches for <code>AuthConfig</code> resources cluster-wide<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup>, with TLS enabled<sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: Authorino</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  name: authorino</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">spec:</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">  clusterWide: true</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">  listener:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="s">    ports:</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="s">      grpc: 50051</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="s">      http: 5001 # for admissionreview requests sent by the kubernetes api server</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="s">    tls:</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">      certSecretRef:</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="s">        name: authorino-server-cert</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="s">  oidcServer:</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="s">    tls:</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="s">      certSecretRef:</span>
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a><span class="s">        name: authorino-oidc-server-cert</span>
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>For convenience, the same instance of Authorino pointed as the validating webhook will also be targeted for the sample AuthConfigs created to test the validation. For using different instances of Authorino for the validating webhook and for protecting applications behind a proxy, check out the section about <a href="../../architecture/#sharding">sharding</a> in the docs. There is also a <a href="../sharding/">user guide</a> on the topic, with concrete examples.</p>
-<h2 id="create-the-authconfig-and-related-clusterrole">❸ Create the <code>AuthConfig</code> and related <code>ClusterRole</code><a class="headerlink" href="#create-the-authconfig-and-related-clusterrole" title="Permanent link">&para;</a></h2>
-<p>Create the <code>AuthConfig</code> with the auth rules to validate other AuthConfig resources applied to the cluster.</p>
-<p>The AuthConfig to validate other AuthConfigs will enforce the following rules:</p>
-<ul>
-<li>Authorino features that cannot be used by any application in their security schemes:</li>
-<li>Anonymous Access</li>
-<li>Plain identity object extracted from context</li>
-<li>Kubernetes authentication (TokenReview)</li>
-<li>Kubernetes authorization (SubjectAccessReview)</li>
-<li>Festival Wristband tokens</li>
-<li>Authorino features that require a RoleBinding to a specific ClusterRole in the 'authorino' namespace, to be used in a AuthConfig:</li>
-<li>Authorino API key authentication</li>
-<li>All metadata pulled from external sources must be cached for precisely 5 minutes (300 seconds)</li>
-</ul>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: authconfig-validator</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  # admissionreview requests will be sent to this host name</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="s">  hosts:</span>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="s">  - authorino-authorino-authorization.authorino.svc</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="s">  # because we&#39;re using a single authorino instance for the validating webhook and to protect the user applications,</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="s">  # skip operations related to this one authconfig in the &#39;authorino&#39; namespace</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="s">  when:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="s">  - selector: context.request.http.body.@fromstr|request.object.metadata.namespace</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="s">    operator: neq</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="s">    value: authorino</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="s">  # kubernetes admissionreviews carry info about the authenticated user</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="s">  authentication:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="s">    &quot;k8s-userinfo&quot;:</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="s">      plain:</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="s">        selector: context.request.http.body.@fromstr|request.userInfo</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="s">  authorization:</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="s">    &quot;features&quot;:</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="s">      opa:</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="s">        rego: |</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="s">          authconfig = json.unmarshal(input.context.request.http.body).request.object</span>
-</span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a>
-</span><span id="__span-6-32"><a id="__codelineno-6-32" name="__codelineno-6-32" href="#__codelineno-6-32"></a><span class="s">          forbidden { count(object.get(authconfig.spec, &quot;authentication&quot;, [])) == 0 }</span>
-</span><span id="__span-6-33"><a id="__codelineno-6-33" name="__codelineno-6-33" href="#__codelineno-6-33"></a><span class="s">          forbidden { authconfig.spec.authentication[_].anonymous }</span>
-</span><span id="__span-6-34"><a id="__codelineno-6-34" name="__codelineno-6-34" href="#__codelineno-6-34"></a><span class="s">          forbidden { authconfig.spec.authentication[_].kubernetesTokenReview }</span>
-</span><span id="__span-6-35"><a id="__codelineno-6-35" name="__codelineno-6-35" href="#__codelineno-6-35"></a><span class="s">          forbidden { authconfig.spec.authentication[_].plain }</span>
-</span><span id="__span-6-36"><a id="__codelineno-6-36" name="__codelineno-6-36" href="#__codelineno-6-36"></a><span class="s">          forbidden { authconfig.spec.authorization[_].kubernetesSubjectAccessReview }</span>
-</span><span id="__span-6-37"><a id="__codelineno-6-37" name="__codelineno-6-37" href="#__codelineno-6-37"></a><span class="s">          forbidden { authconfig.spec.response.success.headers[_].wristband }</span>
-</span><span id="__span-6-38"><a id="__codelineno-6-38" name="__codelineno-6-38" href="#__codelineno-6-38"></a>
-</span><span id="__span-6-39"><a id="__codelineno-6-39" name="__codelineno-6-39" href="#__codelineno-6-39"></a><span class="s">          apiKey { authconfig.spec.authentication[_].apiKey }</span>
-</span><span id="__span-6-40"><a id="__codelineno-6-40" name="__codelineno-6-40" href="#__codelineno-6-40"></a>
-</span><span id="__span-6-41"><a id="__codelineno-6-41" name="__codelineno-6-41" href="#__codelineno-6-41"></a><span class="s">          allow { count(authconfig.spec.authentication) &gt; 0; not forbidden }</span>
-</span><span id="__span-6-42"><a id="__codelineno-6-42" name="__codelineno-6-42" href="#__codelineno-6-42"></a><span class="s">        allValues: true</span>
-</span><span id="__span-6-43"><a id="__codelineno-6-43" name="__codelineno-6-43" href="#__codelineno-6-43"></a>
-</span><span id="__span-6-44"><a id="__codelineno-6-44" name="__codelineno-6-44" href="#__codelineno-6-44"></a><span class="s">    &quot;apikey-authn-requires-k8s-role-binding&quot;:</span>
-</span><span id="__span-6-45"><a id="__codelineno-6-45" name="__codelineno-6-45" href="#__codelineno-6-45"></a><span class="s">      priority: 1</span>
-</span><span id="__span-6-46"><a id="__codelineno-6-46" name="__codelineno-6-46" href="#__codelineno-6-46"></a><span class="s">      when:</span>
-</span><span id="__span-6-47"><a id="__codelineno-6-47" name="__codelineno-6-47" href="#__codelineno-6-47"></a>
-</span><span id="__span-6-48"><a id="__codelineno-6-48" name="__codelineno-6-48" href="#__codelineno-6-48"></a><span class="s">      - selector: auth.authorization.features.apiKey</span>
-</span><span id="__span-6-49"><a id="__codelineno-6-49" name="__codelineno-6-49" href="#__codelineno-6-49"></a><span class="s">        operator: eq</span>
-</span><span id="__span-6-50"><a id="__codelineno-6-50" name="__codelineno-6-50" href="#__codelineno-6-50"></a><span class="s">        value: &quot;true&quot;</span>
-</span><span id="__span-6-51"><a id="__codelineno-6-51" name="__codelineno-6-51" href="#__codelineno-6-51"></a><span class="s">      kubernetesSubjectAccessReview:</span>
-</span><span id="__span-6-52"><a id="__codelineno-6-52" name="__codelineno-6-52" href="#__codelineno-6-52"></a><span class="s">        user:</span>
-</span><span id="__span-6-53"><a id="__codelineno-6-53" name="__codelineno-6-53" href="#__codelineno-6-53"></a><span class="s">          selector: auth.identity.username</span>
-</span><span id="__span-6-54"><a id="__codelineno-6-54" name="__codelineno-6-54" href="#__codelineno-6-54"></a><span class="s">        resourceAttributes:</span>
-</span><span id="__span-6-55"><a id="__codelineno-6-55" name="__codelineno-6-55" href="#__codelineno-6-55"></a><span class="s">          namespace: { value: authorino }</span>
-</span><span id="__span-6-56"><a id="__codelineno-6-56" name="__codelineno-6-56" href="#__codelineno-6-56"></a><span class="s">          group: { value: authorino.kuadrant.io }</span>
-</span><span id="__span-6-57"><a id="__codelineno-6-57" name="__codelineno-6-57" href="#__codelineno-6-57"></a><span class="s">          resource: { value: authconfigs-with-apikeys }</span>
-</span><span id="__span-6-58"><a id="__codelineno-6-58" name="__codelineno-6-58" href="#__codelineno-6-58"></a><span class="s">          verb: { value: create }</span>
-</span><span id="__span-6-59"><a id="__codelineno-6-59" name="__codelineno-6-59" href="#__codelineno-6-59"></a>
-</span><span id="__span-6-60"><a id="__codelineno-6-60" name="__codelineno-6-60" href="#__codelineno-6-60"></a><span class="s">    &quot;metadata-cache-ttl&quot;:</span>
-</span><span id="__span-6-61"><a id="__codelineno-6-61" name="__codelineno-6-61" href="#__codelineno-6-61"></a><span class="s">      priority: 1</span>
-</span><span id="__span-6-62"><a id="__codelineno-6-62" name="__codelineno-6-62" href="#__codelineno-6-62"></a><span class="s">      opa:</span>
-</span><span id="__span-6-63"><a id="__codelineno-6-63" name="__codelineno-6-63" href="#__codelineno-6-63"></a><span class="s">        rego: |</span>
-</span><span id="__span-6-64"><a id="__codelineno-6-64" name="__codelineno-6-64" href="#__codelineno-6-64"></a><span class="s">          invalid_ttl = input.auth.authorization.features.authconfig.spec.metadata[_].cache.ttl != 300</span>
-</span><span id="__span-6-65"><a id="__codelineno-6-65" name="__codelineno-6-65" href="#__codelineno-6-65"></a><span class="s">          allow { not invalid_ttl }</span>
-</span><span id="__span-6-66"><a id="__codelineno-6-66" name="__codelineno-6-66" href="#__codelineno-6-66"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Define a <code>ClusterRole</code> to control the usage of protected features of Authorino:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: ClusterRole</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: authorino-apikey</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">rules:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">- apiGroups: [&quot;authorino.kuadrant.io&quot;]</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">  resources: [&quot;authconfigs-with-apikeys&quot;] # not a real k8s resource</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">  verbs: [&quot;create&quot;]</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="create-the-validatingwebhookconfiguration">❹ Create the <code>ValidatingWebhookConfiguration</code><a class="headerlink" href="#create-the-validatingwebhookconfiguration" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: admissionregistration.k8s.io/v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: ValidatingWebhookConfiguration</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: authconfig-authz</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  annotations:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">    cert-manager.io/inject-ca-from: authorino/authorino-ca-cert</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">webhooks:</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">- name: check-authconfig.authorino.kuadrant.io</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">  clientConfig:</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">    service:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">      namespace: authorino</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">      name: authorino-authorino-authorization</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">      port: 5001</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">      path: /check</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">  rules:</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">  - apiGroups: [&quot;authorino.kuadrant.io&quot;]</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">    apiVersions: [&quot;v1beta2&quot;]</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="s">    resources: [&quot;authconfigs&quot;]</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="s">    operations: [&quot;CREATE&quot;, &quot;UPDATE&quot;]</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="s">    scope: Namespaced</span>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="s">  sideEffects: None</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="s">  admissionReviewVersions: [&quot;v1&quot;]</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="try-it-out">❺ Try it out<a class="headerlink" href="#try-it-out" title="Permanent link">&para;</a></h2>
-<p>Create a namespace:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>myapp
-</span></code></pre></div>
-<h3 id="with-a-valid-authconfig">With a valid <code>AuthConfig</code><a class="headerlink" href="#with-a-valid-authconfig" title="Permanent link">&para;</a></h3>
-<table>
-  <tbody>
-    <tr>
-      <td>
-        <b><i>Kuadrant users –</i></b>
-        For this and other example AuthConfigs below, if you create a Kuadrant <a href="https://docs.kuadrant.io/kuadrant-operator/doc/reference/authpolicy"><code>AuthPolicy</code></a> instead, the output of the commands shall differ. The requested AuthPolicy may be initially accepted, but its state will turn ready or not ready depending on whether the corresponding AuthConfig requested by Kuadrant is accepted or rejected, according to the validating webhook rules. Check the state of the resources to confirm.
-        For more, see <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth">Kuadrant auth</a>.
-      </td>
-    </tr>
-  </tbody>
-</table>
-
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">metadata:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">spec:</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">    &quot;keycloak&quot;:</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">EOF</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="c1"># authconfig.authorino.kuadrant.io/myapp-protection created</span>
-</span></code></pre></div>
-<h3 id="with-forbidden-features">With forbidden features<a class="headerlink" href="#with-forbidden-features" title="Permanent link">&para;</a></h3>
-<p>Anonymous access:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="s">metadata:</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="s">spec:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="s">EOF</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="c1"># Error from server: error when applying patch:</span>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="c1"># {&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;authorino.kuadrant.io/v1beta2\&quot;,\&quot;kind\&quot;:\&quot;AuthConfig\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{},\&quot;name\&quot;:\&quot;myapp-protection\&quot;,\&quot;namespace\&quot;:\&quot;myapp\&quot;},\&quot;spec\&quot;:{\&quot;hosts\&quot;:[\&quot;myapp.io\&quot;]}}\n&quot;}},&quot;spec&quot;:{&quot;authentication&quot;:null}}</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="c1"># to:</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="c1"># Resource: &quot;authorino.kuadrant.io/v1beta2, Resource=authconfigs&quot;, GroupVersionKind: &quot;authorino.kuadrant.io/v1beta2, Kind=AuthConfig&quot;</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="c1"># Name: &quot;myapp-protection&quot;, Namespace: &quot;myapp&quot;</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="c1"># for: &quot;STDIN&quot;: error when patching &quot;STDIN&quot;: admission webhook &quot;check-authconfig.authorino.kuadrant.io&quot; denied the request: Unauthorized</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">spec:</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="s">    &quot;anonymous-access&quot;:</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">      anonymous: {}</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">EOF</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="c1"># Error from server: error when applying patch:</span>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="c1"># {&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;authorino.kuadrant.io/v1beta2\&quot;,\&quot;kind\&quot;:\&quot;AuthConfig\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{},\&quot;name\&quot;:\&quot;myapp-protection\&quot;,\&quot;namespace\&quot;:\&quot;myapp\&quot;},\&quot;spec\&quot;:{\&quot;authentication\&quot;:{\&quot;anonymous-access\&quot;:{\&quot;anonymous\&quot;:{}}},\&quot;hosts\&quot;:[\&quot;myapp.io\&quot;]}}\n&quot;}},&quot;spec&quot;:{&quot;authentication&quot;:{&quot;anonymous-access&quot;:{&quot;anonymous&quot;:{}},&quot;keycloak&quot;:null}}}</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="c1"># to:</span>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="c1"># Resource: &quot;authorino.kuadrant.io/v1beta2, Resource=authconfigs&quot;, GroupVersionKind: &quot;authorino.kuadrant.io/v1beta2, Kind=AuthConfig&quot;</span>
-</span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="c1"># Name: &quot;myapp-protection&quot;, Namespace: &quot;myapp&quot;</span>
-</span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a><span class="c1"># for: &quot;STDIN&quot;: error when patching &quot;STDIN&quot;: admission webhook &quot;check-authconfig.authorino.kuadrant.io&quot; denied the request: Unauthorized</span>
-</span></code></pre></div>
-<p>Kubernetes TokenReview:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="s">metadata:</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="s">spec:</span>
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a>
-</span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="s">    &quot;k8s-tokenreview&quot;:</span>
-</span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="s">      kubernetesTokenReview:</span>
-</span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="s">        audiences: [&quot;myapp&quot;]</span>
-</span><span id="__span-13-14"><a id="__codelineno-13-14" name="__codelineno-13-14" href="#__codelineno-13-14"></a><span class="s">EOF</span>
-</span><span id="__span-13-15"><a id="__codelineno-13-15" name="__codelineno-13-15" href="#__codelineno-13-15"></a><span class="c1"># Error from server: error when applying patch:</span>
-</span><span id="__span-13-16"><a id="__codelineno-13-16" name="__codelineno-13-16" href="#__codelineno-13-16"></a><span class="c1"># {&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;authorino.kuadrant.io/v1beta2\&quot;,\&quot;kind\&quot;:\&quot;AuthConfig\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{},\&quot;name\&quot;:\&quot;myapp-protection\&quot;,\&quot;namespace\&quot;:\&quot;myapp\&quot;},\&quot;spec\&quot;:{\&quot;authentication\&quot;:{\&quot;k8s-tokenreview\&quot;:{\&quot;kubernetesTokenReview\&quot;:{\&quot;audiences\&quot;:[\&quot;myapp\&quot;]}}},\&quot;hosts\&quot;:[\&quot;myapp.io\&quot;]}}\n&quot;}},&quot;spec&quot;:{&quot;authentication&quot;:{&quot;k8s-tokenreview&quot;:{&quot;kubernetesTokenReview&quot;:{&quot;audiences&quot;:[&quot;myapp&quot;]}},&quot;keycloak&quot;:null}}}</span>
-</span><span id="__span-13-17"><a id="__codelineno-13-17" name="__codelineno-13-17" href="#__codelineno-13-17"></a><span class="c1"># to:</span>
-</span><span id="__span-13-18"><a id="__codelineno-13-18" name="__codelineno-13-18" href="#__codelineno-13-18"></a><span class="c1"># Resource: &quot;authorino.kuadrant.io/v1beta2, Resource=authconfigs&quot;, GroupVersionKind: &quot;authorino.kuadrant.io/v1beta2, Kind=AuthConfig&quot;</span>
-</span><span id="__span-13-19"><a id="__codelineno-13-19" name="__codelineno-13-19" href="#__codelineno-13-19"></a><span class="c1"># Name: &quot;myapp-protection&quot;, Namespace: &quot;myapp&quot;</span>
-</span><span id="__span-13-20"><a id="__codelineno-13-20" name="__codelineno-13-20" href="#__codelineno-13-20"></a><span class="c1"># for: &quot;STDIN&quot;: error when patching &quot;STDIN&quot;: admission webhook &quot;check-authconfig.authorino.kuadrant.io&quot; denied the request: Unauthorized</span>
-</span></code></pre></div>
-<p>Plain identity extracted from context:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="s">metadata:</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="s">spec:</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a>
-</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="s">    &quot;envoy-jwt-authn&quot;:</span>
-</span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="s">      plain:</span>
-</span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="s">        selector: context.metadata_context.filter_metadata.envoy\.filters\.http\.jwt_authn|verified_jwt</span>
-</span><span id="__span-14-14"><a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="s">EOF</span>
-</span><span id="__span-14-15"><a id="__codelineno-14-15" name="__codelineno-14-15" href="#__codelineno-14-15"></a><span class="c1"># Error from server: error when applying patch:</span>
-</span><span id="__span-14-16"><a id="__codelineno-14-16" name="__codelineno-14-16" href="#__codelineno-14-16"></a><span class="c1"># {&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;authorino.kuadrant.io/v1beta2\&quot;,\&quot;kind\&quot;:\&quot;AuthConfig\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{},\&quot;name\&quot;:\&quot;myapp-protection\&quot;,\&quot;namespace\&quot;:\&quot;myapp\&quot;},\&quot;spec\&quot;:{\&quot;authentication\&quot;:{\&quot;envoy-jwt-authn\&quot;:{\&quot;plain\&quot;:{\&quot;selector\&quot;:\&quot;context.metadata_context.filter_metadata.envoy\\\\.filters\\\\.http\\\\.jwt_authn|verified_jwt\&quot;}}},\&quot;hosts\&quot;:[\&quot;myapp.io\&quot;]}}\n&quot;}},&quot;spec&quot;:{&quot;authentication&quot;:{&quot;envoy-jwt-authn&quot;:{&quot;plain&quot;:{&quot;selector&quot;:&quot;context.metadata_context.filter_metadata.envoy\\.filters\\.http\\.jwt_authn|verified_jwt&quot;}},&quot;keycloak&quot;:null}}}</span>
-</span><span id="__span-14-17"><a id="__codelineno-14-17" name="__codelineno-14-17" href="#__codelineno-14-17"></a><span class="c1"># to:</span>
-</span><span id="__span-14-18"><a id="__codelineno-14-18" name="__codelineno-14-18" href="#__codelineno-14-18"></a><span class="c1"># Resource: &quot;authorino.kuadrant.io/v1beta2, Resource=authconfigs&quot;, GroupVersionKind: &quot;authorino.kuadrant.io/v1beta2, Kind=AuthConfig&quot;</span>
-</span><span id="__span-14-19"><a id="__codelineno-14-19" name="__codelineno-14-19" href="#__codelineno-14-19"></a><span class="c1"># Name: &quot;myapp-protection&quot;, Namespace: &quot;myapp&quot;</span>
-</span><span id="__span-14-20"><a id="__codelineno-14-20" name="__codelineno-14-20" href="#__codelineno-14-20"></a><span class="c1"># for: &quot;STDIN&quot;: error when patching &quot;STDIN&quot;: admission webhook &quot;check-authconfig.authorino.kuadrant.io&quot; denied the request: Unauthorized</span>
-</span></code></pre></div>
-<p>Kubernetes SubjectAccessReview:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="s">metadata:</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="s">spec:</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a>
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="s">    &quot;keycloak&quot;:</span>
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a><span class="s">  authorization:</span>
-</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="s">    &quot;k8s-subjectaccessreview&quot;:</span>
-</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="s">      kubernetesSubjectAccessReview:</span>
-</span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a><span class="s">        user:</span>
-</span><span id="__span-15-18"><a id="__codelineno-15-18" name="__codelineno-15-18" href="#__codelineno-15-18"></a><span class="s">          selector: auth.identity.sub</span>
-</span><span id="__span-15-19"><a id="__codelineno-15-19" name="__codelineno-15-19" href="#__codelineno-15-19"></a><span class="s">EOF</span>
-</span><span id="__span-15-20"><a id="__codelineno-15-20" name="__codelineno-15-20" href="#__codelineno-15-20"></a><span class="c1"># Error from server: error when applying patch:</span>
-</span><span id="__span-15-21"><a id="__codelineno-15-21" name="__codelineno-15-21" href="#__codelineno-15-21"></a><span class="c1"># {&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;authorino.kuadrant.io/v1beta2\&quot;,\&quot;kind\&quot;:\&quot;AuthConfig\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{},\&quot;name\&quot;:\&quot;myapp-protection\&quot;,\&quot;namespace\&quot;:\&quot;myapp\&quot;},\&quot;spec\&quot;:{\&quot;authentication\&quot;:{\&quot;keycloak\&quot;:{\&quot;jwt\&quot;:{\&quot;issuerUrl\&quot;:\&quot;http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\&quot;}}},\&quot;authorization\&quot;:{\&quot;k8s-subjectaccessreview\&quot;:{\&quot;kubernetesSubjectAccessReview\&quot;:{\&quot;user\&quot;:{\&quot;selector\&quot;:\&quot;auth.identity.sub\&quot;}}}},\&quot;hosts\&quot;:[\&quot;myapp.io\&quot;]}}\n&quot;}},&quot;spec&quot;:{&quot;authorization&quot;:{&quot;k8s-subjectaccessreview&quot;:{&quot;kubernetesSubjectAccessReview&quot;:{&quot;user&quot;:{&quot;selector&quot;:&quot;auth.identity.sub&quot;}}}}}}</span>
-</span><span id="__span-15-22"><a id="__codelineno-15-22" name="__codelineno-15-22" href="#__codelineno-15-22"></a><span class="c1"># to:</span>
-</span><span id="__span-15-23"><a id="__codelineno-15-23" name="__codelineno-15-23" href="#__codelineno-15-23"></a><span class="c1"># Resource: &quot;authorino.kuadrant.io/v1beta2, Resource=authconfigs&quot;, GroupVersionKind: &quot;authorino.kuadrant.io/v1beta2, Kind=AuthConfig&quot;</span>
-</span><span id="__span-15-24"><a id="__codelineno-15-24" name="__codelineno-15-24" href="#__codelineno-15-24"></a><span class="c1"># Name: &quot;myapp-protection&quot;, Namespace: &quot;myapp&quot;</span>
-</span><span id="__span-15-25"><a id="__codelineno-15-25" name="__codelineno-15-25" href="#__codelineno-15-25"></a><span class="c1"># for: &quot;STDIN&quot;: error when patching &quot;STDIN&quot;: admission webhook &quot;check-authconfig.authorino.kuadrant.io&quot; denied the request: Unauthorized</span>
-</span></code></pre></div>
-<p>Festival Wristband tokens:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="s">metadata:</span>
-</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a><span class="s">  name: wristband-signing-key</span>
-</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a><span class="s">stringData:</span>
-</span><span id="__span-16-7"><a id="__codelineno-16-7" name="__codelineno-16-7" href="#__codelineno-16-7"></a><span class="s">  key.pem: |</span>
-</span><span id="__span-16-8"><a id="__codelineno-16-8" name="__codelineno-16-8" href="#__codelineno-16-8"></a><span class="s">    -----BEGIN EC PRIVATE KEY-----</span>
-</span><span id="__span-16-9"><a id="__codelineno-16-9" name="__codelineno-16-9" href="#__codelineno-16-9"></a><span class="s">    MHcCAQEEIDHvuf81gVlWGo0hmXGTAnA/HVxGuH8vOc7/8jewcVvqoAoGCCqGSM49</span>
-</span><span id="__span-16-10"><a id="__codelineno-16-10" name="__codelineno-16-10" href="#__codelineno-16-10"></a><span class="s">    AwEHoUQDQgAETJf5NLVKplSYp95TOfhVPqvxvEibRyjrUZwwtpDuQZxJKDysoGwn</span>
-</span><span id="__span-16-11"><a id="__codelineno-16-11" name="__codelineno-16-11" href="#__codelineno-16-11"></a><span class="s">    cnUvHIu23SgW+Ee9lxSmZGhO4eTdQeKxMA==</span>
-</span><span id="__span-16-12"><a id="__codelineno-16-12" name="__codelineno-16-12" href="#__codelineno-16-12"></a><span class="s">    -----END EC PRIVATE KEY-----</span>
-</span><span id="__span-16-13"><a id="__codelineno-16-13" name="__codelineno-16-13" href="#__codelineno-16-13"></a><span class="s">type: Opaque</span>
-</span><span id="__span-16-14"><a id="__codelineno-16-14" name="__codelineno-16-14" href="#__codelineno-16-14"></a><span class="s">---</span>
-</span><span id="__span-16-15"><a id="__codelineno-16-15" name="__codelineno-16-15" href="#__codelineno-16-15"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-16-16"><a id="__codelineno-16-16" name="__codelineno-16-16" href="#__codelineno-16-16"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-16-17"><a id="__codelineno-16-17" name="__codelineno-16-17" href="#__codelineno-16-17"></a><span class="s">metadata:</span>
-</span><span id="__span-16-18"><a id="__codelineno-16-18" name="__codelineno-16-18" href="#__codelineno-16-18"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-16-19"><a id="__codelineno-16-19" name="__codelineno-16-19" href="#__codelineno-16-19"></a><span class="s">spec:</span>
-</span><span id="__span-16-20"><a id="__codelineno-16-20" name="__codelineno-16-20" href="#__codelineno-16-20"></a><span class="s">  hosts:</span>
-</span><span id="__span-16-21"><a id="__codelineno-16-21" name="__codelineno-16-21" href="#__codelineno-16-21"></a>
-</span><span id="__span-16-22"><a id="__codelineno-16-22" name="__codelineno-16-22" href="#__codelineno-16-22"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-16-23"><a id="__codelineno-16-23" name="__codelineno-16-23" href="#__codelineno-16-23"></a><span class="s">  authentication:</span>
-</span><span id="__span-16-24"><a id="__codelineno-16-24" name="__codelineno-16-24" href="#__codelineno-16-24"></a><span class="s">    &quot;keycloak&quot;:</span>
-</span><span id="__span-16-25"><a id="__codelineno-16-25" name="__codelineno-16-25" href="#__codelineno-16-25"></a><span class="s">      jwt:</span>
-</span><span id="__span-16-26"><a id="__codelineno-16-26" name="__codelineno-16-26" href="#__codelineno-16-26"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-16-27"><a id="__codelineno-16-27" name="__codelineno-16-27" href="#__codelineno-16-27"></a><span class="s">  response:</span>
-</span><span id="__span-16-28"><a id="__codelineno-16-28" name="__codelineno-16-28" href="#__codelineno-16-28"></a><span class="s">    success:</span>
-</span><span id="__span-16-29"><a id="__codelineno-16-29" name="__codelineno-16-29" href="#__codelineno-16-29"></a><span class="s">      headers:</span>
-</span><span id="__span-16-30"><a id="__codelineno-16-30" name="__codelineno-16-30" href="#__codelineno-16-30"></a><span class="s">        &quot;wristband&quot;:</span>
-</span><span id="__span-16-31"><a id="__codelineno-16-31" name="__codelineno-16-31" href="#__codelineno-16-31"></a><span class="s">          wristband:</span>
-</span><span id="__span-16-32"><a id="__codelineno-16-32" name="__codelineno-16-32" href="#__codelineno-16-32"></a><span class="s">            issuer: http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/myapp/myapp-protection/wristband</span>
-</span><span id="__span-16-33"><a id="__codelineno-16-33" name="__codelineno-16-33" href="#__codelineno-16-33"></a><span class="s">            signingKeyRefs:</span>
-</span><span id="__span-16-34"><a id="__codelineno-16-34" name="__codelineno-16-34" href="#__codelineno-16-34"></a><span class="s">            - algorithm: ES256</span>
-</span><span id="__span-16-35"><a id="__codelineno-16-35" name="__codelineno-16-35" href="#__codelineno-16-35"></a><span class="s">              name: wristband-signing-key</span>
-</span><span id="__span-16-36"><a id="__codelineno-16-36" name="__codelineno-16-36" href="#__codelineno-16-36"></a><span class="s">EOF</span>
-</span><span id="__span-16-37"><a id="__codelineno-16-37" name="__codelineno-16-37" href="#__codelineno-16-37"></a><span class="c1"># secret/wristband-signing-key created</span>
-</span><span id="__span-16-38"><a id="__codelineno-16-38" name="__codelineno-16-38" href="#__codelineno-16-38"></a><span class="c1"># Error from server: error when applying patch:</span>
-</span><span id="__span-16-39"><a id="__codelineno-16-39" name="__codelineno-16-39" href="#__codelineno-16-39"></a><span class="c1"># {&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;authorino.kuadrant.io/v1beta2\&quot;,\&quot;kind\&quot;:\&quot;AuthConfig\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{},\&quot;name\&quot;:\&quot;myapp-protection\&quot;,\&quot;namespace\&quot;:\&quot;myapp\&quot;},\&quot;spec\&quot;:{\&quot;authentication\&quot;:{\&quot;keycloak\&quot;:{\&quot;jwt\&quot;:{\&quot;issuerUrl\&quot;:\&quot;http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\&quot;}}},\&quot;hosts\&quot;:[\&quot;myapp.io\&quot;],\&quot;response\&quot;:{\&quot;success\&quot;:{\&quot;headers\&quot;:{\&quot;wristband\&quot;:{\&quot;wristband\&quot;:{\&quot;issuer\&quot;:\&quot;http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/myapp/myapp-protection/wristband\&quot;,\&quot;signingKeyRefs\&quot;:[{\&quot;algorithm\&quot;:\&quot;ES256\&quot;,\&quot;name\&quot;:\&quot;wristband-signing-key\&quot;}]}}}}}}}\n&quot;}},&quot;spec&quot;:{&quot;response&quot;:{&quot;success&quot;:{&quot;headers&quot;:{&quot;wristband&quot;:{&quot;wristband&quot;:{&quot;issuer&quot;:&quot;http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/myapp/myapp-protection/wristband&quot;,&quot;signingKeyRefs&quot;:[{&quot;algorithm&quot;:&quot;ES256&quot;,&quot;name&quot;:&quot;wristband-signing-key&quot;}]}}}}}}}</span>
-</span><span id="__span-16-40"><a id="__codelineno-16-40" name="__codelineno-16-40" href="#__codelineno-16-40"></a><span class="c1"># to:</span>
-</span><span id="__span-16-41"><a id="__codelineno-16-41" name="__codelineno-16-41" href="#__codelineno-16-41"></a><span class="c1"># Resource: &quot;authorino.kuadrant.io/v1beta2, Resource=authconfigs&quot;, GroupVersionKind: &quot;authorino.kuadrant.io/v1beta2, Kind=AuthConfig&quot;</span>
-</span><span id="__span-16-42"><a id="__codelineno-16-42" name="__codelineno-16-42" href="#__codelineno-16-42"></a><span class="c1"># Name: &quot;myapp-protection&quot;, Namespace: &quot;myapp&quot;</span>
-</span><span id="__span-16-43"><a id="__codelineno-16-43" name="__codelineno-16-43" href="#__codelineno-16-43"></a><span class="c1"># for: &quot;STDIN&quot;: error when patching &quot;STDIN&quot;: admission webhook &quot;check-authconfig.authorino.kuadrant.io&quot; denied the request: Unauthorized</span>
-</span></code></pre></div>
-<h3 id="with-features-that-require-additional-permissions">With features that require additional permissions<a class="headerlink" href="#with-features-that-require-additional-permissions" title="Permanent link">&para;</a></h3>
-<p>Before adding the required permissions:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="s">metadata:</span>
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="s">spec:</span>
-</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a>
-</span><span id="__span-17-9"><a id="__codelineno-17-9" name="__codelineno-17-9" href="#__codelineno-17-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-17-10"><a id="__codelineno-17-10" name="__codelineno-17-10" href="#__codelineno-17-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-17-11"><a id="__codelineno-17-11" name="__codelineno-17-11" href="#__codelineno-17-11"></a><span class="s">    &quot;api-key&quot;:</span>
-</span><span id="__span-17-12"><a id="__codelineno-17-12" name="__codelineno-17-12" href="#__codelineno-17-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-17-13"><a id="__codelineno-17-13" name="__codelineno-17-13" href="#__codelineno-17-13"></a><span class="s">        selector:</span>
-</span><span id="__span-17-14"><a id="__codelineno-17-14" name="__codelineno-17-14" href="#__codelineno-17-14"></a><span class="s">          matchLabels: { app: myapp }</span>
-</span><span id="__span-17-15"><a id="__codelineno-17-15" name="__codelineno-17-15" href="#__codelineno-17-15"></a><span class="s">EOF</span>
-</span><span id="__span-17-16"><a id="__codelineno-17-16" name="__codelineno-17-16" href="#__codelineno-17-16"></a><span class="c1"># Error from server: error when applying patch:</span>
-</span><span id="__span-17-17"><a id="__codelineno-17-17" name="__codelineno-17-17" href="#__codelineno-17-17"></a><span class="c1"># {&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;authorino.kuadrant.io/v1beta2\&quot;,\&quot;kind\&quot;:\&quot;AuthConfig\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{},\&quot;name\&quot;:\&quot;myapp-protection\&quot;,\&quot;namespace\&quot;:\&quot;myapp\&quot;},\&quot;spec\&quot;:{\&quot;authentication\&quot;:{\&quot;api-key\&quot;:{\&quot;apiKey\&quot;:{\&quot;selector\&quot;:{\&quot;matchLabels\&quot;:{\&quot;app\&quot;:\&quot;myapp\&quot;}}}}},\&quot;hosts\&quot;:[\&quot;myapp.io\&quot;]}}\n&quot;}},&quot;spec&quot;:{&quot;authentication&quot;:{&quot;api-key&quot;:{&quot;apiKey&quot;:{&quot;selector&quot;:{&quot;matchLabels&quot;:{&quot;app&quot;:&quot;myapp&quot;}}}},&quot;keycloak&quot;:null}}}</span>
-</span><span id="__span-17-18"><a id="__codelineno-17-18" name="__codelineno-17-18" href="#__codelineno-17-18"></a><span class="c1"># to:</span>
-</span><span id="__span-17-19"><a id="__codelineno-17-19" name="__codelineno-17-19" href="#__codelineno-17-19"></a><span class="c1"># Resource: &quot;authorino.kuadrant.io/v1beta2, Resource=authconfigs&quot;, GroupVersionKind: &quot;authorino.kuadrant.io/v1beta2, Kind=AuthConfig&quot;</span>
-</span><span id="__span-17-20"><a id="__codelineno-17-20" name="__codelineno-17-20" href="#__codelineno-17-20"></a><span class="c1"># Name: &quot;myapp-protection&quot;, Namespace: &quot;myapp&quot;</span>
-</span><span id="__span-17-21"><a id="__codelineno-17-21" name="__codelineno-17-21" href="#__codelineno-17-21"></a><span class="c1"># for: &quot;STDIN&quot;: error when patching &quot;STDIN&quot;: admission webhook &quot;check-authconfig.authorino.kuadrant.io&quot; denied the request: Not authorized: unknown reason</span>
-</span></code></pre></div>
-<p>Add the required permissions:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>authorino<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="s">kind: RoleBinding</span>
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="s">metadata:</span>
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="s">  name: authorino-apikey</span>
-</span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="s">roleRef:</span>
-</span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a><span class="s">  apiGroup: rbac.authorization.k8s.io</span>
-</span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a><span class="s">  kind: ClusterRole</span>
-</span><span id="__span-18-9"><a id="__codelineno-18-9" name="__codelineno-18-9" href="#__codelineno-18-9"></a><span class="s">  name: authorino-apikey</span>
-</span><span id="__span-18-10"><a id="__codelineno-18-10" name="__codelineno-18-10" href="#__codelineno-18-10"></a><span class="s">subjects:</span>
-</span><span id="__span-18-11"><a id="__codelineno-18-11" name="__codelineno-18-11" href="#__codelineno-18-11"></a>
-</span><span id="__span-18-12"><a id="__codelineno-18-12" name="__codelineno-18-12" href="#__codelineno-18-12"></a><span class="s">- kind: User</span>
-</span><span id="__span-18-13"><a id="__codelineno-18-13" name="__codelineno-18-13" href="#__codelineno-18-13"></a><span class="s">  name: kubernetes-admin</span>
-</span><span id="__span-18-14"><a id="__codelineno-18-14" name="__codelineno-18-14" href="#__codelineno-18-14"></a><span class="s">EOF</span>
-</span><span id="__span-18-15"><a id="__codelineno-18-15" name="__codelineno-18-15" href="#__codelineno-18-15"></a><span class="c1"># rolebinding.rbac.authorization.k8s.io/authorino-apikey created</span>
-</span></code></pre></div>
-<p>After adding the required permissions:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a><span class="s">metadata:</span>
-</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-19-6"><a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a><span class="s">spec:</span>
-</span><span id="__span-19-7"><a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-19-8"><a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a>
-</span><span id="__span-19-9"><a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-19-10"><a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-19-11"><a id="__codelineno-19-11" name="__codelineno-19-11" href="#__codelineno-19-11"></a><span class="s">    &quot;api-key&quot;:</span>
-</span><span id="__span-19-12"><a id="__codelineno-19-12" name="__codelineno-19-12" href="#__codelineno-19-12"></a><span class="s">      apiKey:</span>
-</span><span id="__span-19-13"><a id="__codelineno-19-13" name="__codelineno-19-13" href="#__codelineno-19-13"></a><span class="s">        selector:</span>
-</span><span id="__span-19-14"><a id="__codelineno-19-14" name="__codelineno-19-14" href="#__codelineno-19-14"></a><span class="s">          matchLabels: { app: myapp }</span>
-</span><span id="__span-19-15"><a id="__codelineno-19-15" name="__codelineno-19-15" href="#__codelineno-19-15"></a><span class="s">EOF</span>
-</span><span id="__span-19-16"><a id="__codelineno-19-16" name="__codelineno-19-16" href="#__codelineno-19-16"></a><span class="c1"># authconfig.authorino.kuadrant.io/myapp-protection configured</span>
-</span></code></pre></div>
-<h2 id="with-features-that-require-specific-property-validation">With features that require specific property validation<a class="headerlink" href="#with-features-that-require-specific-property-validation" title="Permanent link">&para;</a></h2>
-<p>Invalid:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="s">metadata:</span>
-</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a><span class="s">spec:</span>
-</span><span id="__span-20-7"><a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-20-8"><a id="__codelineno-20-8" name="__codelineno-20-8" href="#__codelineno-20-8"></a>
-</span><span id="__span-20-9"><a id="__codelineno-20-9" name="__codelineno-20-9" href="#__codelineno-20-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-20-10"><a id="__codelineno-20-10" name="__codelineno-20-10" href="#__codelineno-20-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-20-11"><a id="__codelineno-20-11" name="__codelineno-20-11" href="#__codelineno-20-11"></a><span class="s">    &quot;keycloak&quot;:</span>
-</span><span id="__span-20-12"><a id="__codelineno-20-12" name="__codelineno-20-12" href="#__codelineno-20-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-20-13"><a id="__codelineno-20-13" name="__codelineno-20-13" href="#__codelineno-20-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-20-14"><a id="__codelineno-20-14" name="__codelineno-20-14" href="#__codelineno-20-14"></a><span class="s">  metadata:</span>
-</span><span id="__span-20-15"><a id="__codelineno-20-15" name="__codelineno-20-15" href="#__codelineno-20-15"></a><span class="s">    &quot;external-source&quot;:</span>
-</span><span id="__span-20-16"><a id="__codelineno-20-16" name="__codelineno-20-16" href="#__codelineno-20-16"></a><span class="s">      http:</span>
-</span><span id="__span-20-17"><a id="__codelineno-20-17" name="__codelineno-20-17" href="#__codelineno-20-17"></a><span class="s">        url: http://metadata.io</span>
-</span><span id="__span-20-18"><a id="__codelineno-20-18" name="__codelineno-20-18" href="#__codelineno-20-18"></a><span class="s">      cache:</span>
-</span><span id="__span-20-19"><a id="__codelineno-20-19" name="__codelineno-20-19" href="#__codelineno-20-19"></a><span class="s">        key: { value: global }</span>
-</span><span id="__span-20-20"><a id="__codelineno-20-20" name="__codelineno-20-20" href="#__codelineno-20-20"></a><span class="s">        ttl: 60</span>
-</span><span id="__span-20-21"><a id="__codelineno-20-21" name="__codelineno-20-21" href="#__codelineno-20-21"></a><span class="s">EOF</span>
-</span><span id="__span-20-22"><a id="__codelineno-20-22" name="__codelineno-20-22" href="#__codelineno-20-22"></a><span class="c1"># Error from server: error when applying patch:</span>
-</span><span id="__span-20-23"><a id="__codelineno-20-23" name="__codelineno-20-23" href="#__codelineno-20-23"></a><span class="c1"># {&quot;metadata&quot;:{&quot;annotations&quot;:{&quot;kubectl.kubernetes.io/last-applied-configuration&quot;:&quot;{\&quot;apiVersion\&quot;:\&quot;authorino.kuadrant.io/v1beta2\&quot;,\&quot;kind\&quot;:\&quot;AuthConfig\&quot;,\&quot;metadata\&quot;:{\&quot;annotations\&quot;:{},\&quot;name\&quot;:\&quot;myapp-protection\&quot;,\&quot;namespace\&quot;:\&quot;myapp\&quot;},\&quot;spec\&quot;:{\&quot;authentication\&quot;:{\&quot;keycloak\&quot;:{\&quot;jwt\&quot;:{\&quot;issuerUrl\&quot;:\&quot;http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\&quot;}}},\&quot;hosts\&quot;:[\&quot;myapp.io\&quot;],\&quot;metadata\&quot;:{\&quot;external-source\&quot;:{\&quot;cache\&quot;:{\&quot;key\&quot;:{\&quot;value\&quot;:\&quot;global\&quot;},\&quot;ttl\&quot;:60},\&quot;http\&quot;:{\&quot;url\&quot;:\&quot;http://metadata.io\&quot;}}}}}\n&quot;}},&quot;spec&quot;:{&quot;authentication&quot;:{&quot;api-key&quot;:null,&quot;keycloak&quot;:{&quot;jwt&quot;:{&quot;issuerUrl&quot;:&quot;http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant&quot;}}},&quot;metadata&quot;:{&quot;external-source&quot;:{&quot;cache&quot;:{&quot;key&quot;:{&quot;value&quot;:&quot;global&quot;},&quot;ttl&quot;:60},&quot;http&quot;:{&quot;url&quot;:&quot;http://metadata.io&quot;}}}}}</span>
-</span><span id="__span-20-24"><a id="__codelineno-20-24" name="__codelineno-20-24" href="#__codelineno-20-24"></a><span class="c1"># to:</span>
-</span><span id="__span-20-25"><a id="__codelineno-20-25" name="__codelineno-20-25" href="#__codelineno-20-25"></a><span class="c1"># Resource: &quot;authorino.kuadrant.io/v1beta2, Resource=authconfigs&quot;, GroupVersionKind: &quot;authorino.kuadrant.io/v1beta2, Kind=AuthConfig&quot;</span>
-</span><span id="__span-20-26"><a id="__codelineno-20-26" name="__codelineno-20-26" href="#__codelineno-20-26"></a><span class="c1"># Name: &quot;myapp-protection&quot;, Namespace: &quot;myapp&quot;</span>
-</span><span id="__span-20-27"><a id="__codelineno-20-27" name="__codelineno-20-27" href="#__codelineno-20-27"></a><span class="c1"># for: &quot;STDIN&quot;: error when patching &quot;STDIN&quot;: admission webhook &quot;check-authconfig.authorino.kuadrant.io&quot; denied the request: Unauthorized</span>
-</span></code></pre></div>
-<p>Valid:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>myapp<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a><span class="s">apiVersion: authorino.kuadrant.io/v1beta2</span>
-</span><span id="__span-21-3"><a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a><span class="s">kind: AuthConfig</span>
-</span><span id="__span-21-4"><a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a><span class="s">metadata:</span>
-</span><span id="__span-21-5"><a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a><span class="s">  name: myapp-protection</span>
-</span><span id="__span-21-6"><a id="__codelineno-21-6" name="__codelineno-21-6" href="#__codelineno-21-6"></a><span class="s">spec:</span>
-</span><span id="__span-21-7"><a id="__codelineno-21-7" name="__codelineno-21-7" href="#__codelineno-21-7"></a><span class="s">  hosts:</span>
-</span><span id="__span-21-8"><a id="__codelineno-21-8" name="__codelineno-21-8" href="#__codelineno-21-8"></a>
-</span><span id="__span-21-9"><a id="__codelineno-21-9" name="__codelineno-21-9" href="#__codelineno-21-9"></a><span class="s">  - myapp.io</span>
-</span><span id="__span-21-10"><a id="__codelineno-21-10" name="__codelineno-21-10" href="#__codelineno-21-10"></a><span class="s">  authentication:</span>
-</span><span id="__span-21-11"><a id="__codelineno-21-11" name="__codelineno-21-11" href="#__codelineno-21-11"></a><span class="s">    &quot;keycloak&quot;:</span>
-</span><span id="__span-21-12"><a id="__codelineno-21-12" name="__codelineno-21-12" href="#__codelineno-21-12"></a><span class="s">      jwt:</span>
-</span><span id="__span-21-13"><a id="__codelineno-21-13" name="__codelineno-21-13" href="#__codelineno-21-13"></a><span class="s">        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-21-14"><a id="__codelineno-21-14" name="__codelineno-21-14" href="#__codelineno-21-14"></a><span class="s">  metadata:</span>
-</span><span id="__span-21-15"><a id="__codelineno-21-15" name="__codelineno-21-15" href="#__codelineno-21-15"></a><span class="s">    &quot;external-source&quot;:</span>
-</span><span id="__span-21-16"><a id="__codelineno-21-16" name="__codelineno-21-16" href="#__codelineno-21-16"></a><span class="s">      http:</span>
-</span><span id="__span-21-17"><a id="__codelineno-21-17" name="__codelineno-21-17" href="#__codelineno-21-17"></a><span class="s">        url: http://metadata.io</span>
-</span><span id="__span-21-18"><a id="__codelineno-21-18" name="__codelineno-21-18" href="#__codelineno-21-18"></a><span class="s">      cache:</span>
-</span><span id="__span-21-19"><a id="__codelineno-21-19" name="__codelineno-21-19" href="#__codelineno-21-19"></a><span class="s">        key: { value: global }</span>
-</span><span id="__span-21-20"><a id="__codelineno-21-20" name="__codelineno-21-20" href="#__codelineno-21-20"></a><span class="s">        ttl: 300</span>
-</span><span id="__span-21-21"><a id="__codelineno-21-21" name="__codelineno-21-21" href="#__codelineno-21-21"></a><span class="s">EOF</span>
-</span><span id="__span-21-22"><a id="__codelineno-21-22" name="__codelineno-21-22" href="#__codelineno-21-22"></a><span class="c1"># authconfig.authorino.kuadrant.io/myapp-protection configured</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>kind<span class="w"> </span>delete<span class="w"> </span>cluster<span class="w"> </span>--name<span class="w"> </span>authorino-tutorial
-</span></code></pre></div>
-<p>Otherwise, delete the resources created in each step:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>myapp
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>authorino
-</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>clusterrole<span class="w"> </span>authorino-apikey
-</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>kubectl<span class="w"> </span>delete<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out <strong>Architecture &gt; <a href="../../architecture/#topologies">Topologies</a></strong> for all options.&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p><code>cluster-wide</code> reconciliation mode. See <a href="../../architecture/#cluster-wide-vs-namespaced-instances">Cluster-wide vs. Namespaced instances</a>.&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>For other variants and deployment options, check out <a href="../../getting-started/#step-request-an-authorino-instance">Getting Started</a>, as well as the <a href="https://github.com/kuadrant/authorino-operator#the-authorino-custom-resource-definition-crd"><code>Authorino</code></a> CRD specification.&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/index.html b/0.10.0/authorino/index.html
deleted file mode 100644
index 3ecca150e..000000000
--- a/0.10.0/authorino/index.html
+++ /dev/null
@@ -1,3969 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/authorino/">
-      
-      
-        <link rel="prev" href="../kuadrant-operator/doc/logging/">
-      
-      
-        <link rel="next" href="../authorino-operator/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#authorino" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting started
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#use-cases" class="md-nav__link">
-    <span class="md-ellipsis">
-      Use-cases
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#list-of-features" class="md-nav__link">
-    <span class="md-ellipsis">
-      List of features
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#faq" class="md-nav__link">
-    <span class="md-ellipsis">
-      FAQ
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#benchmarks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Benchmarks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#license" class="md-nav__link">
-    <span class="md-ellipsis">
-      License
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting started
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#use-cases" class="md-nav__link">
-    <span class="md-ellipsis">
-      Use-cases
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#list-of-features" class="md-nav__link">
-    <span class="md-ellipsis">
-      List of features
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#faq" class="md-nav__link">
-    <span class="md-ellipsis">
-      FAQ
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#benchmarks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Benchmarks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#license" class="md-nav__link">
-    <span class="md-ellipsis">
-      License
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/authorino/blob/main/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="authorino">Authorino<a class="headerlink" href="#authorino" title="Permanent link">&para;</a></h1>
-<p><strong>Kubernetes-native authorization service for tailor-made Zero Trust API security.</strong><br/></p>
-<p>A lightweight Envoy external authorization server fully manageable via Kubernetes Custom Resources.<br/>
-JWT authentication, API key, mTLS, pattern-matching authz, OPA, K8s SA tokens, K8s RBAC, external metadata fetching, and <a href="#list-of-features">more</a>, with minimum to no coding at all, no rebuilding of your applications.</p>
-<p>Authorino is not about inventing anything new. It's about making the best things about auth out there easy and simple to use. Authorino is multi-tenant, it's cloud-native and it's open source.</p>
-<p><a href="http://www.apache.org/licenses/LICENSE-2.0"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" /></a>
-<a href="https://github.com/Kuadrant/authorino/actions/workflows/go-test.yaml"><img alt="Unit Tests" src="https://github.com/Kuadrant/authorino/actions/workflows/go-test.yaml/badge.svg" /></a>
-<a href="https://github.com/Kuadrant/authorino/actions/workflows/e2e-test.yaml"><img alt="End-to-end Tests" src="https://github.com/Kuadrant/authorino/actions/workflows/e2e-test.yaml/badge.svg" /></a>
-<a href="https://github.com/Kuadrant/authorino/actions/workflows/integration-test.yaml"><img alt="Smoke Tests" src="https://github.com/Kuadrant/authorino/actions/workflows/integration-test.yaml/badge.svg" /></a>
-<a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Fauthorino?ref=badge_shield"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Fauthorino.svg?type=shield" /></a></p>
-<h2 id="getting-started">Getting started<a class="headerlink" href="#getting-started" title="Permanent link">&para;</a></h2>
-<ol>
-<li>Deploy with the <a href="https://github.com/kuadrant/authorino-operator">Authorino Operator</a></li>
-<li>Setup Envoy proxy and the <a href="https://www.envoyproxy.io/docs/envoy/latest/start/sandboxes/ext_authz">external authorization</a> filter</li>
-<li>Apply an Authorino <a href="docs/architecture/#the-authorino-authconfig-custom-resource-definition-crd"><code>AuthConfig</code></a> custom resource</li>
-<li>Obtain an authentication token and start sending requests</li>
-</ol>
-<p>The full <a href="docs/getting-started/">Getting started</a> page of the docs provides details for the steps above, as well as information about requirements and next steps.</p>
-<p>Or try out our <a href="docs/user-guides/hello-world/">Hello World</a> example.</p>
-<p>For general information about protecting your service using Authorino, check out the <a href="docs/">docs</a>.</p>
-<h2 id="use-cases">Use-cases<a class="headerlink" href="#use-cases" title="Permanent link">&para;</a></h2>
-<p>The <a href="docs/user-guides/">User guides</a> section of the docs gathers several AuthN/AuthZ use-cases as well as the instructions to implement them using Authorino. A few examples are:</p>
-<ul>
-<li><a href="docs/user-guides/oidc-jwt-authentication/">Authentication with JWTs and OpenID Connect Discovery</a></li>
-<li><a href="docs/user-guides/api-key-authentication/">Authentication with API keys</a></li>
-<li><a href="docs/user-guides/kubernetes-tokenreview/">Authentication with Kubernetes SA tokens (TokenReview API)</a></li>
-<li><a href="docs/user-guides/mtls-authentication/">Authentication with X.509 certificates and mTLS</a></li>
-<li><a href="docs/user-guides/json-pattern-matching-authorization/">Authorization with JSON pattern-matching rules (e.g. JWT claims, request attributes, etc)</a></li>
-<li><a href="docs/user-guides/opa-authorization/">Authorization with Open Policy Agent (OPA) Rego policies</a></li>
-<li><a href="docs/user-guides/kubernetes-subjectaccessreview/">Authorization using the Kubernetes RBAC (rules stated in K8s <code>Role</code> and <code>RoleBinding</code> resources)</a></li>
-<li><a href="docs/user-guides/external-metadata/">Authorization using auth metadata fetched from external sources</a></li>
-<li><a href="docs/user-guides/oidc-rbac/">OIDC authentication and RBAC with Keycloak JWTs</a></li>
-<li><a href="docs/user-guides/injecting-data/">Injecting auth data into the request (HTTP headers, Wristband tokens, rate-limit metadata, etc)</a></li>
-<li><a href="docs/user-guides/validating-webhook/">Authorino for the Kubernetes control plane (aka Authorino as ValidatingWebhook service)</a></li>
-</ul>
-<h2 id="how-it-works">How it works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h2>
-<p>Authorino enables hybrid API security, with usually no code changes required to your application, tailor-made for your own combination of authentication standards and protocols and authorization policies of choice.</p>
-<p>Authorino implements <a href="https://www.envoyproxy.io">Envoy Proxy</a>'s <a href="https://www.envoyproxy.io/docs/envoy/latest/start/sandboxes/ext_authz">external authorization</a> gRPC protocol, and is a part of Red Hat <a href="https://github.com/kuadrant">Kuadrant</a> architecture.</p>
-<p>Under the hood, Authorino is based on Kubernetes <a href="https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources">Custom Resource Definitions</a> and the <a href="https://kubernetes.io/docs/concepts/extend-kubernetes/operator">Operator pattern</a>.</p>
-<p><strong>Bootstrap and configuration:</strong></p>
-<ol>
-<li>Deploy the service/API to be protected (<em>"Upstream"</em>), Authorino and Envoy</li>
-<li>Write and apply an Authorino <code>AuthConfig</code> Custom Resource associated to the public host of the service</li>
-</ol>
-<p><strong>Request-time:</strong></p>
-<p><picture>
-  <source media="(prefers-color-scheme: light)" srcset="http://www.plantuml.com/plantuml/png/VP51IyH038NlyojoNyIx1rbTLeI2NMJreXwodRGTx4ngaX7ghtTGALMXrvVllS1xMpKKot5mc8rJZYSIj-EaEPB0sINiqpjFS06tn-C1XDuogRbliLolilKi8N4Xkll3pdN2UVoIIqWREWS02-gFvP4aj1C4Jyc2JUlm3LdJGoH3ZuRhx3wrB0q15kq3HXv24qZNFTSv31wQhCOHX7JafBHksU4mdB1vLKV9kmMsAAwkpk_g2fxJvb_sNEF3g2Q4iU1FTVNogspO07fF7df2Jw9kXiiNcAVwMMZEtbBoPTPF">
-  <img alt="How it works" src="http://www.plantuml.com/plantuml/dpng/VP51IyH038NlyojoNyIx1rbTLeI2NMJreXwodRGTx4ngaX7ghtTGALMXrvVllS1xMpKKot5mc8rJZYSIj-EaEPB0sINiqpjFS06tn-C1XDuogRbliLolilKi8N4Xkll3pdN2UVoIIqWREWS02-gFvP4aj1C4Jyc2JUlm3LdJGoH3ZuRhx3wrB0q15kq3HXv24qZNFTSv31wQhCOHX7JafBHksU4mdB1vLKV9kmMsAAwkpk_g2fxJvb_sNEF3g2Q4iU1FTVNogspO07fF7df2Jw9kXiiNcAVwMMZEtbBoPTPF">
-</picture></p>
-<ol>
-<li>A user or service account (<em>"Consumer"</em>) obtains an access token to consume resources of the <em>Upstream</em> service, and sends a request to the <em>Envoy</em> ingress endpoint</li>
-<li>The Envoy proxy establishes fast gRPC connection with <em>Authorino</em> carrying data of the HTTP request (context info), which causes Authorino to lookup for an <code>AuthConfig</code> Custom Resource to enforce (pre-cached)</li>
-<li><strong>Identity verification (authentication) phase</strong> - Authorino verifies the identity of the consumer, where at least one authentication method/identity provider must go through</li>
-<li><strong>External metadata phase</strong> - Authorino fetches additional metadata for the authorization from external sources (optional)</li>
-<li><strong>Policy enforcement (authorization) phase</strong> - Authorino takes as input a JSON composed out of context data, resolved identity object and fetched additional metadata from previous phases, and triggers the evaluation of user-defined authorization policies</li>
-<li><strong>Response (metadata-out) phase</strong> – Authorino builds user-defined custom responses (dynamic JSON objects and/or <em>Festival Wristband</em> OIDC tokens), to be supplied back to the client and/or upstream service within added HTTP headers or as Envoy Dynamic Metadata (optional)</li>
-<li><strong>Callbacks phase</strong> – Authorino sends callbacks to specified HTTP endpoints (optional)</li>
-<li>Authorino and Envoy settle the authorization protocol with either OK/NOK response</li>
-<li>If authorized, Envoy triggers other HTTP filters in the chain (if any), pre-injecting eventual dynamic metadata returned by Authorino, and ultimately redirects the request to the <em>Upstream</em></li>
-<li>The <em>Upstream</em> serves the requested resource to the consumer</li>
-</ol>
-<details>
-<summary>More</summary>
-<p>The <a href="docs/architecture/">Architecture</a> section of the docs covers details of protecting your APIs with Envoy and Authorino, including information about topology (centralized gateway, centralized authorization service or sidecars), deployment modes (cluster-wide reconciliation vs. namespaced instances), an specification of Authorino's <a href="docs/architecture/#the-authorino-authconfig-custom-resource-definition-crd"><code>AuthConfig</code></a> Custom Resource Definition (CRD) and more.</p>
-<p>You will also find in that section information about what happens in request-time (aka Authorino's <a href="docs/architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time">Auth Pipeline</a>) and how to leverage the <a href="docs/architecture/#the-authorization-json">Authorization JSON</a> for writing policies, dynamic responses and other features of Authorino.</p>
-</details>
-<h2 id="list-of-features">List of features<a class="headerlink" href="#list-of-features" title="Permanent link">&para;</a></h2>
-<table>
-  <thead>
-    <tr>
-      <th colspan="2">Feature</th>
-      <th>Stage</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td rowspan="9">Identity verification & authentication</td>
-      <td>JOSE/JWT validation <small>(OpenID Connect)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>OAuth 2.0 Token Introspection <small>(opaque tokens)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Kubernetes TokenReview <small>(SA tokens)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>OpenShift User-echo endpoint</td>
-      <td>In analysis</td>
-    </tr>
-    <tr>
-      <td>API key authentication</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>mTLS authentication</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>HMAC authentication</td>
-      <td>Planned (<a href="https://github.com/kuadrant/authorino/issues/9">#9</a>)</td>
-    </tr>
-    <tr>
-      <td>Plain (resolved beforehand and injected in the payload)</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Anonymous access</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td rowspan="3">Ad hoc external metadata fetching</td>
-      <td>OpenID Connect User Info</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>UMA-protected resource attributes</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>HTTP GET/GET-by-POST</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td rowspan="5">Policy enforcement/authorization</td>
-      <td>JSON pattern matching <small>(e.g. JWT claims, request attributes checking)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>OPA/Rego policies <small>(inline and pull from registry)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Kubernetes SubjectAccessReview <small>(resource and non-resource attributes)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Authzed/SpiceDB</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Keycloak Authorization Services (UMA-compliant Authorization API)</td>
-      <td>In analysis</td>
-    </tr>
-    <tr>
-      <td rowspan="4">Custom responses</td>
-      <td>Festival Wristbands tokens <small>(token normalization, Edge Authentication Architecture)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>JSON injection <small>(header injection, Envoy Dynamic Metadata)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Plain text value <small>(header injection)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Custom response status code/messages <small>(e.g. redirect)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Callbacks</td>
-      <td>HTTP endpoints</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td rowspan="6">Caching</td>
-      <td>OpenID Connect and User-Managed Access configs</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>JSON Web Keys (JWKs) and JSON Web Key Sets (JWKS)</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Access tokens</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>External metadata</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Precompiled Rego policies</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td>Policy evaluation</td>
-      <td><i>Ready</i></td>
-    </tr>
-    <tr>
-      <td colspan="2">Sharding <small>(lookup performance, multitenancy)</small></td>
-      <td><i>Ready</i></td>
-    </tr>
-  </tbody>
-</table>
-
-<p>For a detailed description of the features above, refer to the <a href="docs/features/">Features</a> page.</p>
-<h2 id="faq">FAQ<a class="headerlink" href="#faq" title="Permanent link">&para;</a></h2>
-<details>
-<summary><strong>Do I need to deploy Envoy?</strong></summary>
-<p>Authorino is built from the ground up to work well with Envoy. It is strongly recommended that you leverage Envoy along side Authorino. That said, it is possible to use Authorino without Envoy.</p>
-<p>Authorino implements Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/start/sandboxes/ext_authz">external authorization</a> gRPC protocol and therefore will accept any client request that complies.</p>
-<p>Authorino also provides a second interface for <a href="docs/architecture/#raw-http-authorization-interface">raw HTTP authorization</a>, suitable for using with Kubernetes ValidatingWebhook and other integrations (e.g. other proxies).</p>
-<p>The only attribute of the authorization request that is strictly required is the host name. (See <a href="docs/architecture/#host-lookup">Host lookup</a> for more information.) The other attributes, such as method, path, headers, etc, might as well be required, depending on each <code>AuthConfig</code>. In the case of the gRPC <a href="https://pkg.go.dev/github.com/envoyproxy/go-control-plane/envoy/service/auth/v3?utm_source=gopls#CheckRequest"><code>CheckRequest</code></a> method, the host is supplied in <code>Attributes.Request.Http.Host</code> and alternatively in <code>Attributes.ContextExtensions["host"]</code>. For raw HTTP authorization requests, the host must be supplied in <code>Host</code> HTTP header.</p>
-<p>Check out <a href="https://docs.kuadrant.io/kuadrant-operator">Kuadrant</a> for easy-to-use Envoy and Authorino deployment &amp; configuration for API management use-cases, using Kubernetes Custom Resources.</p>
-</details>
-<details>
-<summary><strong>Is Authorino an Identity Provider (IdP)?</strong></summary>
-<p>No, Authorino is not an Identity Provider (IdP). Neither it is an auth server of any kind, such as an OAuth2 server, an OpenID Connect (OIDC) server, a Single Sign On (SSO) server.</p>
-<p>Authorino is not an identity broker either. It can verify access tokens from multiple trusted sources of identity and protocols, but it will not negotiate authentication flows for non-authenticated access requests. Some tricks nonetheless can be done, for example, to <a href="docs/user-guides/deny-with-redirect-to-login/">redirect unauthenticated users to a login page</a>.</p>
-<p>For an excellent auth server that checks all the boxes above, check out <a href="https://www.keycloak.org">Keycloak</a>.</p>
-</details>
-<details>
-<summary><strong>How does Authorino compare to Keycloak?</strong></summary>
-<p>Keycloak is a proper auth server and identity provider (IdP). It offers a huge set of features for managing identities, identity sources with multiple user federation options, and a platform for authentication and authorization services.</p>
-<p>Keycloak exposes authenticators that implement protocols such as OpenID Connect. The is a one-time flow that establishes the delegation of power to a client, for a short period of time. To be consistent with Zero Trust security, you want a validator to verify the short-lived tokens in every request that tries to reach your protected service/resource. This step that will repeat everytime could save heavy looking up into big tables of tokens and leverage cached authorization policies for fast in-memory evaluation. This is where Authorino comes in.</p>
-<p>Authorino verifies and validates Keycloak-issued ID tokens. OpenID Connect Discovery is used to request and cache JSON Web Key Sets (JWKS), used to verify the signature of the tokens without having to contact again with the Keycloak server, or looking in a table of credentials. Moreover, user long-lived credentials are safe, rather than spread in hops across the network.</p>
-<p>You can also use Keycloak for storing auth-relevant resource metadata. These can be fetched by Authorino in request-time, to be combined into your authorization policies. See Keycloak Authorization Services and User-Managed Access (UMA) support, as well as Authorino <a href="docs/features/#user-managed-access-uma-resource-registry-metadatauma">UMA external metadata</a> counter-part.</p>
-</details>
-<details>
-<summary><strong>Why doesn't Authorino handle OAuth flows?</strong></summary>
-<p>It has to do with trust. OAuth grants are supposed to be negotiated directly between whoever owns the long-lived credentials in one hand (user, service accounts), and the trustworthy auth server that receives those credentials – ideally with minimum number of hops in the middle – and exchanges them for short-lived access tokens, on the other end.</p>
-<p>There are use-cases for Authorino running in the edge (e.g. Edge Authentication Architecture and token normalization), but in most cases Authorino should be seen as a last-mile component that provides decoupled identity verification and authorization policy enforcement to protected services in request-time. In this sense, the OAuth grant is a pre-flight exchange that happens once and as direct and safe as possible, whereas auth enforcement is kept lightweight and efficient.</p>
-</details>
-<details>
-<summary><strong>Where does Authorino store users and roles?</strong></summary>
-<p>Authorino does not store users, roles, role bindings, access control lists, or any raw authorization data. Authorino handles policies, where even these policies can be stored elsewhere (as opposed to stated inline inside of an Authorino <code>AuthConfig</code> CR).</p>
-<p>Authorino evaluates policies for stateless authorization requests. Any additional context is either resolved from the provided payload or static definitions inside the policies. That includes extracting user information from a JWT or client TLS certificate, requesting user metadata from opaque authentication tokens (e.g. API keys) to the trusted sources actually storing that content, obtaining synchronous HTTP metadata from services, etc.</p>
-<p>In the case of authentication with API keys, as well as its derivative to model HTTP Basic Auth, user data are stored in Kubernetes <code>Secret</code>s. The secret's keys, annotations and labels are usually the structures used to organize the data that later a policy evaluated in Authorino may require. Strictly, those are not Authorino data structures.</p>
-</details>
-<details>
-<summary><strong>Can't I just use Envoy JWT Authentication and RBAC filters?</strong></summary>
-<p>Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/http/jwt_authn/v3/config.proto.html">JWT Authentication</a> works pretty much similar to Authorino's <a href="docs/features/#jwt-verification-authenticationjwt">JOSE/JWT verification and validation for OpenID Connect</a>. In both cases, the JSON Web Key Sets (JWKS) to verify the JWTs are auto-loaded and cached to be used in request-time. Moreover, you can configure for details such as where to extract the JWT from the HTTP request (header, param or cookie) and do some cool tricks regarding how dynamic metadata based on JWT claims can be injected to consecutive filters in the chain.</p>
-<p>However, in terms of authorization, while Envoy's implementation essentially allows to check for the list of audiences (<code>aud</code> JWT claim), Authorino opens up for a lot more options such as pattern-matching rules with operators and conditionals, built-in OPA and other methods of evaluating authorization policies.</p>
-<p>Authorino also allows to combine JWT authentication with other types of authentication to support different sources of identity and groups of users such as API keys, Kubernetes tokens, OAuth opaque tokens , etc.</p>
-<p>In summary, Envoy's JWT Authentication and Envoy RBAC filter are excellent solutions for simple use-cases where JWTs from one single issuer is the only authentication method you are planning to support and limited to no authorization rules suffice. On the other hand, if you need to integrate more identity sources, different types of authentication, authorization policies, etc, you might to consider Authorino.</p>
-</details>
-<details>
-<summary><strong>Should I use Authorino if I already have Istio configured?</strong></summary>
-<p>Istio is a great solution for managing service meshes. It delivers an excellent platform with an interesting layer of abstraction on top of Envoy proxy's virtual omnipresence within the mesh.</p>
-<p>There are lots of similarities, but also complementarity between Authorino and Istio and <a href="https://istio.io/latest/docs/concepts/security/#authorization">Istio Authorization</a> in special.</p>
-<p>Istio provides a simple way to enable features that are, in many cases, features of Envoy, such as authorization based on JWTs, authorization based on attributes of the request, and activation of external authorization services, without having to deal with complex Envoy config files. See <a href="https://doc.kuadrant.io/kuadrant-operator">Kuadrant</a> for a similar approach, nonetheless leveraging features of Istio as well.</p>
-<p>Authorino is an Envoy-compatible external authorization service. One can use Authorino with or without Istio.</p>
-<p>In particular, <a href="https://istio.io/latest/docs/reference/config/security/authorization-policy/">Istio Authorization Policies</a> can be seen, in terms of functionality and expressiveness, as a subset of one type of authorization policies supported by Authorino, the <a href="docs/features/#pattern-matching-authorization-authorizationpatternmatching">pattern-matching authorization</a> policies. While Istio, however, is heavily focused on specific use cases of API Management, offering a relatively limited list of <a href="https://istio.io/latest/docs/reference/config/security/conditions/">supported attribute conditions</a>, Authorino is more generic, allowing to express authorization rules for a wider spectrum of use cases – ACLs, RBAC, ABAC, etc, pretty much counting on any attribute of the Envoy payload, identity object and external metadata available.</p>
-<p>Authorino also provides built-in OPA authorization, several other methods of authentication and identity verification (e.g. Kubernetes token validation, API key-based authentication, OAuth token introspection, OIDC-discoverable JWT verification, etc), and features like fetching of external metadata (HTTP services, OIDC userinfo, UMA resource data), token normalization, wristband tokens and dynamic responses. These all can be used independently or combined, in a simple and straightforward Kubernetes-native fashion.</p>
-<p>In summary, one might value Authorino when looking for a policy enforcer that offers:</p>
-<ol>
-<li>multiple supported methods and protocols for rather hybrid authentication, encompassing future and legacy auth needs;</li>
-<li>broader expressiveness and more functionalities for the authorization rules;</li>
-<li>authentication and authorization in one single declarative manifest;</li>
-<li>capability to fetch auth metadata from external sources on-the-fly;</li>
-<li>built-in OPA module;</li>
-<li>easy token normalization and/or aiming for Edge Authentication Architecture (EAA).</li>
-</ol>
-<p>The good news is that, if you have Istio configured, then you have Envoy and the whole platform for wiring Authorino up if you want to. 😉</p>
-</details>
-<details>
-<summary><strong>Do I have to learn OPA/Rego language to use Authorino?</strong></summary>
-<p>No, you do not. However, if you are comfortable with <a href="https://www.openpolicyagent.org/docs/latest/policy-language/">Rego</a> from Open Policy Agent (OPA), there are some quite interesting things you can do in Authorino, just as you would in any OPA server or OPA plugin, but leveraging Authorino's <a href="docs/features/#open-policy-agent-opa-rego-policies-authorizationopa">built-in OPA module</a> instead. Authorino's OPA module is compiled as part of Authorino's code directly from the Golang packages, and imposes no extra latency to the evaluation of your authorization policies. Even the policies themselves are pre-compiled in reconciliation-time, for fast evaluation afterwards, in request-time.</p>
-<p>On the other hand, if you do not want to learn Rego or in any case would like to combine it with declarative and Kubernetes-native authN/authZ spec for your services, Authorino does complement OPA with at least two other methods for expressing authorization policies – i.e. <a href="docs/features/#pattern-matching-authorization-authorizationpatternmatching">pattern-matching authorization</a> and <a href="docs/features/#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview">Kubernetes SubjectAccessReview</a>, the latter allowing to rely completely on the Kubernetes RBAC.</p>
-<p>You break down, mix and combine these methods and technolgies in as many authorization policies as you want, potentially applying them according to specific conditions. Authorino will trigger the evaluation of concurrent policies in parallel, aborting the context if any of the processes denies access.</p>
-<p>Authorino also packages well-established industry standards and protocols for identity verification (JOSE/JWT validation, OAuth token introspection, Kubernetes TokenReview) and ad-hoc request-time metadata fetching (OIDC userinfo, User-Managed Access (UMA)), and corresponding layers of caching, without which such functionalities would have to be implemented by code.</p>
-</details>
-<details>
-<summary><strong>Can I use Authorino to protect non-REST APIs?</strong></summary>
-<p>Yes, you can. In principle, the API format (REST, gRPC, GraphQL, etc) should not matter for the authN/authZ enforcer. There are a couple points to consider though.</p>
-<p>While REST APIs are designed in a way that, in most cases, information usually needed for the evaluation of authorization policies are available in the metadata of the HTTP request (method, path, headers), other API formats quite often will require processing of the HTTP body. By default, Envoy's external authorization HTTP filter will not forward the body of the request to Authorino; to change that, enable the <code>with_request_body</code> option in the Envoy configuration for the external authorization filter. E.g.:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">with_request_body</span><span class="p">:</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">  </span><span class="nt">max_request_bytes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1024</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">  </span><span class="nt">allow_partial_message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">pack_as_bytes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span></code></pre></div>
-<p>Additionally, when enabling the request body passed in the payload to Authorino, parsing of the content should be of concern as well. Authorino provides easy access to attributes of the HTTP request, parsed as part of the <a href="docs/architecture/#the-authorization-json">Authorization JSON</a>, however the body of the request is passed as string and should be parsed by the user according to each case.</p>
-<p>Check out Authorino <a href="docs/features/#open-policy-agent-opa-rego-policies-authorizationopa">OPA authorization</a> and the Rego <a href="https://www.openpolicyagent.org/docs/latest/policy-reference/#encoding">Encoding</a> functions for options to parse serialized JSON, YAML and URL-encoded params. For XML transformation, an external parsing service connected via Authorino's <a href="docs/features/#http-getget-by-post-metadatahttp">HTTP GET/GET-by-POST external metadata</a> might be required.</p>
-</details>
-<details>
-<summary><strong>Can I run Authorino other than on Kubernetes?</strong></summary>
-<p>As of today, no, you cannot, or at least it wouldn't suit production requirements.</p>
-</details>
-<details>
-<summary><strong>Do I have to be admin of the cluster to install Authorino?</strong></summary>
-<p>To install the Authorino Custom Resource Definition (CRD) and to define cluster roles required by the Authorino service, admin privilege to the Kubernetes cluster is required. This step happens only once per cluster and is usually equivalent to installing the <a href="https://docs.kuadrant.io/authorino-operator">Authorino Operator</a>.</p>
-<p>Thereafter, deploying instances of the Authorino service and applying <code>AuthConfig</code> custom resources to a namespace depend on the permissions set by the cluster administrator – either directly by editing the bindings in the cluster's RBAC, or via options of the operator. In most cases, developers will be granted permissions to create and manage <code>AuthConfig</code>s, and sometimes to deploy their own instances of Authorino.</p>
-</details>
-<details>
-<summary><strong>Is it OK to store AuthN/AuthZ configs as Kubernetes objects?</strong></summary>
-<p>Authorino's API checks all the bullets to be <a href="https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/#should-i-add-a-custom-resource-to-my-kubernetes-cluster">aggregated to the Kubernetes cluster APIs</a>, and therefore using Custom Resource Definition (CRD) and the <a href="https://kubernetes.io/docs/concepts/extend-kubernetes/operator">Operator pattern</a> has always been an easy design decision.</p>
-<p>By merging the definitions of service authN/authZ to the control plane, Authorino <code>AuthConfig</code> resources can be thought as extensions of the specs of the desired state of services regarding the data flow security. The Authorino custom controllers, built-in into the authorization service, are the agents that read from that desired state and reconcile the processes operating in the data plane.</p>
-<p>Authorino is declarative and seamless for developers and cluster administrators managing the state of security of the applications running in the server, used to tools such as <code>kubectl</code>, the Kubernetes UI and its dashboards. Instead of learning about yet another configuration API format, Authorino users can jump straight to applying and editing YAML or JSON structures they already know, in a way that things such as <code>spec</code>, <code>status</code>, <code>namespace</code> and <code>labels</code> have the meaning they are expected to have, and docs are as close as <code>kubectl explain</code>. Moreover, Authorino does not pile up any other redundant layers of APIs, event-processing, RBAC, transformation and validation webhooks, etc. It is Kubernetes in its best.</p>
-<p>In terms of scale, Authorino <code>AuthConfig</code>s should grow proportionally to the number of protected services, virtually limited by nothing but the Kubernetes API data storage, while <a href="docs/architecture/#cluster-wide-vs-namespaced-instances">namespace division</a> and <a href="docs/architecture/#sharding">label selectors</a> help adjust horizontally and keep distributed.</p>
-<p>In other words, there are lots of benefits of using Kubernetes custom resources and custom controllers, and unless you are planning on bursting your server with more services than it can keep record, it is totally 👍 to store your AuthN/AuthZ configs as cluster API objects.</p>
-</details>
-<details>
-<summary><strong>Can I use Authorino for rate limiting?</strong></summary>
-<p>You can, but you shouldn't. Check out instead <a href="https://github.com/kuadrant/limitador">Limitador</a>, for simple and efficient global rate limiting. Combine it with Authorino and Authorino's support for <a href="docs/features/#envoy-dynamic-metadata">Envoy Dynamic Metadata</a> for authenticated rate limiting.</p>
-</details>
-<h2 id="benchmarks">Benchmarks<a class="headerlink" href="#benchmarks" title="Permanent link">&para;</a></h2>
-<p><strong>Configuration of the tests (Authorino features):</strong></p>
-<table>
-<thead>
-<tr>
-<th>Performance test</th>
-<th style="text-align: center;">Identity</th>
-<th style="text-align: center;">Metadata</th>
-<th style="text-align: center;">Authorization</th>
-<th style="text-align: center;">Response</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>ReconcileAuthConfig</code></td>
-<td style="text-align: center;">OIDC/JWT</td>
-<td style="text-align: center;">UserInfo, UMA</td>
-<td style="text-align: center;">OPA<br/><sup>(inline Rego)</sup></td>
-<td style="text-align: center;">-</td>
-</tr>
-<tr>
-<td><code>AuthPipeline</code></td>
-<td style="text-align: center;">OIDC/JWT</td>
-<td style="text-align: center;">-</td>
-<td style="text-align: center;">JSON pattern-matching<br/><sup>(JWT claim check)</sup></td>
-<td style="text-align: center;">-</td>
-</tr>
-<tr>
-<td><code>APIKeyAuthn</code></td>
-<td style="text-align: center;">API key</td>
-<td style="text-align: center;">N/A</td>
-<td style="text-align: center;">N/A</td>
-<td style="text-align: center;">N/A</td>
-</tr>
-<tr>
-<td><code>JSONPatternMatchingAuthz</code></td>
-<td style="text-align: center;">N/A</td>
-<td style="text-align: center;">N/A</td>
-<td style="text-align: center;">JSON pattern-matching</td>
-<td style="text-align: center;">N/A</td>
-</tr>
-<tr>
-<td><code>OPAAuthz</code></td>
-<td style="text-align: center;">N/A</td>
-<td style="text-align: center;">N/A</td>
-<td style="text-align: center;">OPA<br/><sup>(inline Rego)</sup></td>
-<td style="text-align: center;">N/A</td>
-</tr>
-</tbody>
-</table>
-<p><strong>Platform:</strong> linux/amd64<br/>
-<strong>CPU:</strong> Intel® Xeon® Platinum 8370C 2.80GHz<br/>
-<strong>Cores:</strong> 1, 4, 10<br/></p>
-<p><strong>Results:</strong>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>ReconcileAuthConfig:
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>        │   sec/op    │     B/op     │  allocs/op  │
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>*         1.533m ± 2%   264.4Ki ± 0%   6.470k ± 0%
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>*-4       1.381m ± 6%   264.5Ki ± 0%   6.471k ± 0%
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>*-10      1.563m ± 5%   270.2Ki ± 0%   6.426k ± 0%
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a>geomean   1.491m        266.4Ki        6.456k
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a>AuthPipeline:
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a>        │   sec/op    │     B/op     │ allocs/op  │
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a>*         388.0µ ± 2%   80.70Ki ± 0%   894.0 ± 0%
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a>*-4       348.4µ ± 5%   80.67Ki ± 2%   894.0 ± 3%
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a>*-10      356.4µ ± 2%   78.97Ki ± 0%   860.0 ± 0%
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a>geomean   363.9µ        80.11Ki        882.5
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a>
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a>APIKeyAuthn:
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a>
-</span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a>        │   sec/op    │    B/op      │ allocs/op  │
-</span><span id="__span-1-22"><a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a>
-</span><span id="__span-1-23"><a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a>*         3.246µ ± 1%   480.0 ± 0%     6.000 ± 0%
-</span><span id="__span-1-24"><a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a>*-4       3.111µ ± 0%   480.0 ± 0%     6.000 ± 0%
-</span><span id="__span-1-25"><a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a>*-10      3.091µ ± 1%   480.0 ± 0%     6.000 ± 0%
-</span><span id="__span-1-26"><a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a>geomean   3.148µ        480.0          6.000
-</span><span id="__span-1-27"><a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a>
-</span><span id="__span-1-28"><a id="__codelineno-1-28" name="__codelineno-1-28" href="#__codelineno-1-28"></a>OPAAuthz vs JSONPatternMatchingAuthz:
-</span><span id="__span-1-29"><a id="__codelineno-1-29" name="__codelineno-1-29" href="#__codelineno-1-29"></a>
-</span><span id="__span-1-30"><a id="__codelineno-1-30" name="__codelineno-1-30" href="#__codelineno-1-30"></a>        │   OPAAuthz   │      JSONPatternMatchingAuthz       │
-</span><span id="__span-1-31"><a id="__codelineno-1-31" name="__codelineno-1-31" href="#__codelineno-1-31"></a>        │    sec/op    │   sec/op     vs base                │
-</span><span id="__span-1-32"><a id="__codelineno-1-32" name="__codelineno-1-32" href="#__codelineno-1-32"></a>
-</span><span id="__span-1-33"><a id="__codelineno-1-33" name="__codelineno-1-33" href="#__codelineno-1-33"></a>*         87.469µ ± 1%   1.797µ ± 1%  -97.95% (p=0.000 n=10)
-</span><span id="__span-1-34"><a id="__codelineno-1-34" name="__codelineno-1-34" href="#__codelineno-1-34"></a>*-4       95.954µ ± 3%   1.766µ ± 0%  -98.16% (p=0.000 n=10)
-</span><span id="__span-1-35"><a id="__codelineno-1-35" name="__codelineno-1-35" href="#__codelineno-1-35"></a>*-10      96.789µ ± 4%   1.763µ ± 0%  -98.18% (p=0.000 n=10)
-</span><span id="__span-1-36"><a id="__codelineno-1-36" name="__codelineno-1-36" href="#__codelineno-1-36"></a>geomean    93.31µ        1.775µ       -98.10%
-</span><span id="__span-1-37"><a id="__codelineno-1-37" name="__codelineno-1-37" href="#__codelineno-1-37"></a>
-</span><span id="__span-1-38"><a id="__codelineno-1-38" name="__codelineno-1-38" href="#__codelineno-1-38"></a>        │   OPAAuthz    │      JSONPatternMatchingAuthz      │
-</span><span id="__span-1-39"><a id="__codelineno-1-39" name="__codelineno-1-39" href="#__codelineno-1-39"></a>        │     B/op      │    B/op     vs base                │
-</span><span id="__span-1-40"><a id="__codelineno-1-40" name="__codelineno-1-40" href="#__codelineno-1-40"></a>
-</span><span id="__span-1-41"><a id="__codelineno-1-41" name="__codelineno-1-41" href="#__codelineno-1-41"></a>*         28826.00 ± 0%   64.00 ± 0%  -99.78% (p=0.000 n=10)
-</span><span id="__span-1-42"><a id="__codelineno-1-42" name="__codelineno-1-42" href="#__codelineno-1-42"></a>*-4       28844.00 ± 0%   64.00 ± 0%  -99.78% (p=0.000 n=10)
-</span><span id="__span-1-43"><a id="__codelineno-1-43" name="__codelineno-1-43" href="#__codelineno-1-43"></a>*-10      28862.00 ± 0%   64.00 ± 0%  -99.78% (p=0.000 n=10)
-</span><span id="__span-1-44"><a id="__codelineno-1-44" name="__codelineno-1-44" href="#__codelineno-1-44"></a>geomean    28.17Ki        64.00       -99.78%
-</span><span id="__span-1-45"><a id="__codelineno-1-45" name="__codelineno-1-45" href="#__codelineno-1-45"></a>
-</span><span id="__span-1-46"><a id="__codelineno-1-46" name="__codelineno-1-46" href="#__codelineno-1-46"></a>        │   OPAAuthz   │      JSONPatternMatchingAuthz      │
-</span><span id="__span-1-47"><a id="__codelineno-1-47" name="__codelineno-1-47" href="#__codelineno-1-47"></a>        │  allocs/op   │ allocs/op   vs base                │
-</span><span id="__span-1-48"><a id="__codelineno-1-48" name="__codelineno-1-48" href="#__codelineno-1-48"></a>
-</span><span id="__span-1-49"><a id="__codelineno-1-49" name="__codelineno-1-49" href="#__codelineno-1-49"></a>*         569.000 ± 0%   2.000 ± 0%  -99.65% (p=0.000 n=10)
-</span><span id="__span-1-50"><a id="__codelineno-1-50" name="__codelineno-1-50" href="#__codelineno-1-50"></a>*-4       569.000 ± 0%   2.000 ± 0%  -99.65% (p=0.000 n=10)
-</span><span id="__span-1-51"><a id="__codelineno-1-51" name="__codelineno-1-51" href="#__codelineno-1-51"></a>*-10      569.000 ± 0%   2.000 ± 0%  -99.65% (p=0.000 n=10)
-</span><span id="__span-1-52"><a id="__codelineno-1-52" name="__codelineno-1-52" href="#__codelineno-1-52"></a>geomean     569.0        2.000       -99.65%
-</span></code></pre></div></p>
-<h2 id="contributing">Contributing<a class="headerlink" href="#contributing" title="Permanent link">&para;</a></h2>
-<p>If you are interested in contributing to Authorino, please refer to the <a href="docs/contributing/">Developer's guide</a> for info about the stack and requirements, workflow, policies and Code of Conduct.</p>
-<p>Join us on the <a href="https://kubernetes.slack.com/archives/C05J0D0V525">#kuadrant</a> channel in the Kubernetes Slack workspace, for live discussions about the roadmap and more.</p>
-<h2 id="license">License<a class="headerlink" href="#license" title="Permanent link">&para;</a></h2>
-<p><a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Fauthorino?ref=badge_large"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Fauthorino.svg?type=large" /></a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/authorino/install/crd/authorino.kuadrant.io_authconfigs.yaml b/0.10.0/authorino/install/crd/authorino.kuadrant.io_authconfigs.yaml
deleted file mode 100644
index 84a61661b..000000000
--- a/0.10.0/authorino/install/crd/authorino.kuadrant.io_authconfigs.yaml
+++ /dev/null
@@ -1,4488 +0,0 @@
----
-apiVersion: apiextensions.k8s.io/v1
-kind: CustomResourceDefinition
-metadata:
-  annotations:
-    controller-gen.kubebuilder.io/version: v0.15.0
-  name: authconfigs.authorino.kuadrant.io
-spec:
-  group: authorino.kuadrant.io
-  names:
-    kind: AuthConfig
-    listKind: AuthConfigList
-    plural: authconfigs
-    singular: authconfig
-  scope: Namespaced
-  versions:
-  - additionalPrinterColumns:
-    - description: Ready for all hosts
-      jsonPath: .status.summary.ready
-      name: Ready
-      type: string
-    - description: Number of hosts ready
-      jsonPath: .status.summary.numHostsReady
-      name: Hosts
-      type: string
-    - description: Number of trusted identity sources
-      jsonPath: .status.summary.numIdentitySources
-      name: Authentication
-      priority: 2
-      type: integer
-    - description: Number of external metadata sources
-      jsonPath: .status.summary.numMetadataSources
-      name: Metadata
-      priority: 2
-      type: integer
-    - description: Number of authorization policies
-      jsonPath: .status.summary.numAuthorizationPolicies
-      name: Authorization
-      priority: 2
-      type: integer
-    - description: Number of items added to the authorization response
-      jsonPath: .status.summary.numResponseItems
-      name: Response
-      priority: 2
-      type: integer
-    - description: Whether issuing Festival Wristbands
-      jsonPath: .status.summary.festivalWristbandEnabled
-      name: Wristband
-      priority: 2
-      type: boolean
-    name: v1beta1
-    schema:
-      openAPIV3Schema:
-        description: AuthConfig is the schema for Authorino's AuthConfig API
-        properties:
-          apiVersion:
-            description: |-
-              APIVersion defines the versioned schema of this representation of an object.
-              Servers should convert recognized schemas to the latest internal value, and
-              may reject unrecognized values.
-              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
-            type: string
-          kind:
-            description: |-
-              Kind is a string value representing the REST resource this object represents.
-              Servers may infer this from the endpoint the client submits requests to.
-              Cannot be updated.
-              In CamelCase.
-              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
-            type: string
-          metadata:
-            type: object
-          spec:
-            description: Specifies the desired state of the AuthConfig resource, i.e.
-              the authencation/authorization scheme to be applied to protect the matching
-              service hosts.
-            properties:
-              authorization:
-                description: |-
-                  Authorization is the list of authorization policies.
-                  All policies in this list MUST evaluate to "true" for a request be successful in the authorization phase.
-                items:
-                  description: |-
-                    Authorization policy to be enforced.
-                    Apart from "name", one of the following parameters is required and only one of the following parameters is allowed: "opa", "json" or "kubernetes".
-                  properties:
-                    authzed:
-                      description: Authzed authorization
-                      properties:
-                        endpoint:
-                          description: Endpoint of the Authzed service.
-                          type: string
-                        insecure:
-                          description: Insecure HTTP connection (i.e. disables TLS
-                            verification)
-                          type: boolean
-                        permission:
-                          description: The name of the permission (or relation) on
-                            which to execute the check.
-                          properties:
-                            value:
-                              description: Static value
-                              type: string
-                            valueFrom:
-                              description: Dynamic value
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          type: object
-                        resource:
-                          description: The resource on which to check the permission
-                            or relation.
-                          properties:
-                            kind:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                            name:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                          type: object
-                        sharedSecretRef:
-                          description: Reference to a Secret key whose value will
-                            be used by Authorino to authenticate with the Authzed
-                            service.
-                          properties:
-                            key:
-                              description: The key of the secret to select from.  Must
-                                be a valid secret key.
-                              type: string
-                            name:
-                              description: The name of the secret in the Authorino's
-                                namespace to select from.
-                              type: string
-                          required:
-                          - key
-                          - name
-                          type: object
-                        subject:
-                          description: The subject that will be checked for the permission
-                            or relation.
-                          properties:
-                            kind:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                            name:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                          type: object
-                      required:
-                      - endpoint
-                      type: object
-                    cache:
-                      description: |-
-                        Caching options for the policy evaluation results when enforcing this config.
-                        Omit it to avoid caching policy evaluation results for this config.
-                      properties:
-                        key:
-                          description: |-
-                            Key used to store the entry in the cache.
-                            Cache entries from different metadata configs are stored and managed separately regardless of the key.
-                          properties:
-                            value:
-                              description: Static value
-                              type: string
-                            valueFrom:
-                              description: Dynamic value
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          type: object
-                        ttl:
-                          default: 60
-                          description: Duration (in seconds) of the external data
-                            in the cache before pulled again from the source.
-                          type: integer
-                      required:
-                      - key
-                      type: object
-                    json:
-                      description: JSON pattern matching authorization policy.
-                      properties:
-                        rules:
-                          description: The rules that must all evaluate to "true"
-                            for the request to be authorized.
-                          items:
-                            properties:
-                              all:
-                                description: A list of pattern expressions to be evaluated
-                                  as a logical AND.
-                                items:
-                                  type: object
-                                  x-kubernetes-preserve-unknown-fields: true
-                                type: array
-                              any:
-                                description: A list of pattern expressions to be evaluated
-                                  as a logical OR.
-                                items:
-                                  type: object
-                                  x-kubernetes-preserve-unknown-fields: true
-                                type: array
-                              operator:
-                                description: |-
-                                  The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                                  Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                                enum:
-                                - eq
-                                - neq
-                                - incl
-                                - excl
-                                - matches
-                                type: string
-                              patternRef:
-                                description: Name of a named pattern
-                                type: string
-                              selector:
-                                description: |-
-                                  Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson.
-                                  The value is used to fetch content from the input authorization JSON built by Authorino along the identity and metadata phases.
-                                type: string
-                              value:
-                                description: |-
-                                  The value of reference for the comparison with the content fetched from the authorization JSON.
-                                  If used with the "matches" operator, the value must compile to a valid Golang regex.
-                                type: string
-                            type: object
-                          type: array
-                      required:
-                      - rules
-                      type: object
-                    kubernetes:
-                      description: |-
-                        Kubernetes authorization policy based on `SubjectAccessReview`
-                        Path and Verb are inferred from the request.
-                      properties:
-                        groups:
-                          description: Groups to test for.
-                          items:
-                            type: string
-                          type: array
-                        resourceAttributes:
-                          description: |-
-                            Use ResourceAttributes for checking permissions on Kubernetes resources
-                            If omitted, it performs a non-resource `SubjectAccessReview`, with verb and path inferred from the request.
-                          properties:
-                            group:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                            name:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                            namespace:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                            resource:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                            subresource:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                            verb:
-                              description: StaticOrDynamicValue is either a constant
-                                static string value or a config for fetching a value
-                                from a dynamic source (e.g. a path pattern of authorization
-                                JSON)
-                              properties:
-                                value:
-                                  description: Static value
-                                  type: string
-                                valueFrom:
-                                  description: Dynamic value
-                                  properties:
-                                    authJSON:
-                                      description: |-
-                                        Selector to fetch a value from the authorization JSON.
-                                        It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                        or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                  type: object
-                              type: object
-                          type: object
-                        user:
-                          description: |-
-                            User to test for.
-                            If without "Groups", then is it interpreted as "What if User were not a member of any groups"
-                          properties:
-                            value:
-                              description: Static value
-                              type: string
-                            valueFrom:
-                              description: Dynamic value
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          type: object
-                      required:
-                      - user
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this authorization config should generate
-                        individual observability metrics
-                      type: boolean
-                    name:
-                      description: |-
-                        Name of the authorization policy.
-                        It can be used to refer to the resolved authorization object in other configs.
-                      type: string
-                    opa:
-                      description: Open Policy Agent (OPA) authorization policy.
-                      properties:
-                        allValues:
-                          default: false
-                          description: |-
-                            Returns the value of all Rego rules in the virtual document. Values can be read in subsequent evaluators/phases of the Auth Pipeline.
-                            Otherwise, only the default `allow` rule will be exposed.
-                            Returning all Rego rules can affect performance of OPA policies during reconciliation (policy precompile) and at runtime.
-                          type: boolean
-                        externalRegistry:
-                          description: External registry of OPA policies.
-                          properties:
-                            credentials:
-                              description: |-
-                                Defines where client credentials will be passed in the request to the service.
-                                If omitted, it defaults to client credentials passed in the HTTP Authorization header and the "Bearer" prefix expected prepended to the secret value.
-                              properties:
-                                in:
-                                  default: authorization_header
-                                  description: The location in the request where client
-                                    credentials shall be passed on requests authenticating
-                                    with this identity source/authentication mode.
-                                  enum:
-                                  - authorization_header
-                                  - custom_header
-                                  - query
-                                  - cookie
-                                  type: string
-                                keySelector:
-                                  description: |-
-                                    Used in conjunction with the `in` parameter.
-                                    When used with `authorization_header`, the value is the prefix of the client credentials string, separated by a white-space, in the HTTP Authorization header (e.g. "Bearer", "Basic").
-                                    When used with `custom_header`, `query` or `cookie`, the value is the name of the HTTP header, query string parameter or cookie key, respectively.
-                                  type: string
-                              required:
-                              - keySelector
-                              type: object
-                            endpoint:
-                              description: |-
-                                Endpoint of the HTTP external registry.
-                                The endpoint must respond with either plain/text or application/json content-type.
-                                In the latter case, the JSON returned in the body must include a path `result.raw`, where the raw Rego policy will be extracted from. This complies with the specification of the OPA REST API (https://www.openpolicyagent.org/docs/latest/rest-api/#get-a-policy).
-                              type: string
-                            sharedSecretRef:
-                              description: |-
-                                Reference to a Secret key whose value will be passed by Authorino in the request.
-                                The HTTP service can use the shared secret to authenticate the origin of the request.
-                              properties:
-                                key:
-                                  description: The key of the secret to select from.  Must
-                                    be a valid secret key.
-                                  type: string
-                                name:
-                                  description: The name of the secret in the Authorino's
-                                    namespace to select from.
-                                  type: string
-                              required:
-                              - key
-                              - name
-                              type: object
-                            ttl:
-                              description: Duration (in seconds) of the external data
-                                in the cache before pulled again from the source.
-                              type: integer
-                          type: object
-                        inlineRego:
-                          description: |-
-                            Authorization policy as a Rego language document.
-                            The Rego document must include the "allow" condition, set by Authorino to "false" by default (i.e. requests are unauthorized unless changed).
-                            The Rego document must NOT include the "package" declaration in line 1.
-                          type: string
-                      type: object
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    when:
-                      description: |-
-                        Conditions for Authorino to enforce this authorization policy.
-                        If omitted, the config will be enforced for all requests.
-                        If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Name of a named pattern
-                            type: string
-                          selector:
-                            description: |-
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson.
-                              The value is used to fetch content from the input authorization JSON built by Authorino along the identity and metadata phases.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                  required:
-                  - name
-                  type: object
-                type: array
-              callbacks:
-                description: |-
-                  List of callback configs.
-                  Authorino sends callbacks to specified endpoints at the end of the auth pipeline.
-                items:
-                  description: Endpoints to callback at the end of each auth pipeline.
-                  properties:
-                    http:
-                      description: Generic HTTP interface to obtain authorization
-                        metadata from a HTTP service.
-                      properties:
-                        body:
-                          description: |-
-                            Raw body of the HTTP request.
-                            Supersedes 'bodyParameters'; use either one or the other.
-                            Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                          properties:
-                            value:
-                              description: Static value
-                              type: string
-                            valueFrom:
-                              description: Dynamic value
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          type: object
-                        bodyParameters:
-                          description: |-
-                            Custom parameters to encode in the body of the HTTP request.
-                            Superseded by 'body'; use either one or the other.
-                            Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                          items:
-                            properties:
-                              name:
-                                description: The name of the JSON property
-                                type: string
-                              value:
-                                description: Static value of the JSON property
-                                x-kubernetes-preserve-unknown-fields: true
-                              valueFrom:
-                                description: Dynamic value of the JSON property
-                                properties:
-                                  authJSON:
-                                    description: |-
-                                      Selector to fetch a value from the authorization JSON.
-                                      It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                      or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                      Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                    type: string
-                                type: object
-                            required:
-                            - name
-                            type: object
-                          type: array
-                        contentType:
-                          default: application/x-www-form-urlencoded
-                          description: |-
-                            Content-Type of the request body. Shapes how 'bodyParameters' are encoded.
-                            Use it with method=POST; for GET requests, Content-Type is automatically set to 'text/plain'.
-                          enum:
-                          - application/x-www-form-urlencoded
-                          - application/json
-                          type: string
-                        credentials:
-                          description: |-
-                            Defines where client credentials will be passed in the request to the service.
-                            If omitted, it defaults to client credentials passed in the HTTP Authorization header and the "Bearer" prefix expected prepended to the secret value.
-                          properties:
-                            in:
-                              default: authorization_header
-                              description: The location in the request where client
-                                credentials shall be passed on requests authenticating
-                                with this identity source/authentication mode.
-                              enum:
-                              - authorization_header
-                              - custom_header
-                              - query
-                              - cookie
-                              type: string
-                            keySelector:
-                              description: |-
-                                Used in conjunction with the `in` parameter.
-                                When used with `authorization_header`, the value is the prefix of the client credentials string, separated by a white-space, in the HTTP Authorization header (e.g. "Bearer", "Basic").
-                                When used with `custom_header`, `query` or `cookie`, the value is the name of the HTTP header, query string parameter or cookie key, respectively.
-                              type: string
-                          required:
-                          - keySelector
-                          type: object
-                        endpoint:
-                          description: |-
-                            Endpoint of the HTTP service.
-                            The endpoint accepts variable placeholders in the format "{selector}", where "selector" is any pattern supported
-                            by https://pkg.go.dev/github.com/tidwall/gjson and selects value from the authorization JSON.
-                            E.g. https://ext-auth-server.io/metadata?p={context.request.http.path}
-                          type: string
-                        headers:
-                          description: Custom headers in the HTTP request.
-                          items:
-                            properties:
-                              name:
-                                description: The name of the JSON property
-                                type: string
-                              value:
-                                description: Static value of the JSON property
-                                x-kubernetes-preserve-unknown-fields: true
-                              valueFrom:
-                                description: Dynamic value of the JSON property
-                                properties:
-                                  authJSON:
-                                    description: |-
-                                      Selector to fetch a value from the authorization JSON.
-                                      It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                      or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                      Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                    type: string
-                                type: object
-                            required:
-                            - name
-                            type: object
-                          type: array
-                        method:
-                          default: GET
-                          description: |-
-                            HTTP verb used in the request to the service. Accepted values: GET (default), POST.
-                            When the request method is POST, the authorization JSON is passed in the body of the request.
-                          enum:
-                          - GET
-                          - POST
-                          type: string
-                        oauth2:
-                          description: Authentication with the HTTP service by OAuth2
-                            Client Credentials grant.
-                          properties:
-                            cache:
-                              default: true
-                              description: |-
-                                Caches and reuses the token until expired.
-                                Set it to false to force fetch the token at every authorization request regardless of expiration.
-                              type: boolean
-                            clientId:
-                              description: OAuth2 Client ID.
-                              type: string
-                            clientSecretRef:
-                              description: Reference to a Kubernetes Secret key that
-                                stores that OAuth2 Client Secret.
-                              properties:
-                                key:
-                                  description: The key of the secret to select from.  Must
-                                    be a valid secret key.
-                                  type: string
-                                name:
-                                  description: The name of the secret in the Authorino's
-                                    namespace to select from.
-                                  type: string
-                              required:
-                              - key
-                              - name
-                              type: object
-                            extraParams:
-                              additionalProperties:
-                                type: string
-                              description: Optional extra parameters for the requests
-                                to the token URL.
-                              type: object
-                            scopes:
-                              description: Optional scopes for the client credentials
-                                grant, if supported by he OAuth2 server.
-                              items:
-                                type: string
-                              type: array
-                            tokenUrl:
-                              description: Token endpoint URL of the OAuth2 resource
-                                server.
-                              type: string
-                          required:
-                          - clientId
-                          - clientSecretRef
-                          - tokenUrl
-                          type: object
-                        sharedSecretRef:
-                          description: |-
-                            Reference to a Secret key whose value will be passed by Authorino in the request.
-                            The HTTP service can use the shared secret to authenticate the origin of the request.
-                            Ignored if used together with oauth2.
-                          properties:
-                            key:
-                              description: The key of the secret to select from.  Must
-                                be a valid secret key.
-                              type: string
-                            name:
-                              description: The name of the secret in the Authorino's
-                                namespace to select from.
-                              type: string
-                          required:
-                          - key
-                          - name
-                          type: object
-                      required:
-                      - endpoint
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this callback config should generate individual
-                        observability metrics
-                      type: boolean
-                    name:
-                      description: |-
-                        Name of the callback.
-                        It can be used to refer to the resolved callback response in other configs.
-                      type: string
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    when:
-                      description: |-
-                        Conditions for Authorino to perform this callback.
-                        If omitted, the callback will be attempted for all requests.
-                        If present, all conditions must match for the callback to be attempted; otherwise, the callback will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Name of a named pattern
-                            type: string
-                          selector:
-                            description: |-
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson.
-                              The value is used to fetch content from the input authorization JSON built by Authorino along the identity and metadata phases.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                  required:
-                  - http
-                  - name
-                  type: object
-                type: array
-              denyWith:
-                description: Custom denial response codes, statuses and headers to
-                  override default 40x's.
-                properties:
-                  unauthenticated:
-                    description: Denial status customization when the request is unauthenticated.
-                    properties:
-                      body:
-                        description: HTTP response body to override the default denial
-                          body.
-                        properties:
-                          value:
-                            description: Static value
-                            type: string
-                          valueFrom:
-                            description: Dynamic value
-                            properties:
-                              authJSON:
-                                description: |-
-                                  Selector to fetch a value from the authorization JSON.
-                                  It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                  or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                            type: object
-                        type: object
-                      code:
-                        description: HTTP status code to override the default denial
-                          status code.
-                        format: int64
-                        maximum: 599
-                        minimum: 300
-                        type: integer
-                      headers:
-                        description: HTTP response headers to override the default
-                          denial headers.
-                        items:
-                          properties:
-                            name:
-                              description: The name of the JSON property
-                              type: string
-                            value:
-                              description: Static value of the JSON property
-                              x-kubernetes-preserve-unknown-fields: true
-                            valueFrom:
-                              description: Dynamic value of the JSON property
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          required:
-                          - name
-                          type: object
-                        type: array
-                      message:
-                        description: HTTP message to override the default denial message.
-                        properties:
-                          value:
-                            description: Static value
-                            type: string
-                          valueFrom:
-                            description: Dynamic value
-                            properties:
-                              authJSON:
-                                description: |-
-                                  Selector to fetch a value from the authorization JSON.
-                                  It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                  or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                            type: object
-                        type: object
-                    type: object
-                  unauthorized:
-                    description: Denial status customization when the request is unauthorized.
-                    properties:
-                      body:
-                        description: HTTP response body to override the default denial
-                          body.
-                        properties:
-                          value:
-                            description: Static value
-                            type: string
-                          valueFrom:
-                            description: Dynamic value
-                            properties:
-                              authJSON:
-                                description: |-
-                                  Selector to fetch a value from the authorization JSON.
-                                  It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                  or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                            type: object
-                        type: object
-                      code:
-                        description: HTTP status code to override the default denial
-                          status code.
-                        format: int64
-                        maximum: 599
-                        minimum: 300
-                        type: integer
-                      headers:
-                        description: HTTP response headers to override the default
-                          denial headers.
-                        items:
-                          properties:
-                            name:
-                              description: The name of the JSON property
-                              type: string
-                            value:
-                              description: Static value of the JSON property
-                              x-kubernetes-preserve-unknown-fields: true
-                            valueFrom:
-                              description: Dynamic value of the JSON property
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          required:
-                          - name
-                          type: object
-                        type: array
-                      message:
-                        description: HTTP message to override the default denial message.
-                        properties:
-                          value:
-                            description: Static value
-                            type: string
-                          valueFrom:
-                            description: Dynamic value
-                            properties:
-                              authJSON:
-                                description: |-
-                                  Selector to fetch a value from the authorization JSON.
-                                  It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                  or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                            type: object
-                        type: object
-                    type: object
-                type: object
-              hosts:
-                description: |-
-                  The list of public host names of the services protected by this authentication/authorization scheme.
-                  Authorino uses the requested host to lookup for the corresponding authentication/authorization configs to enforce.
-                items:
-                  type: string
-                type: array
-              identity:
-                description: |-
-                  List of identity sources/authentication modes.
-                  At least one config of this list MUST evaluate to a valid identity for a request to be successful in the identity verification phase.
-                items:
-                  description: |-
-                    The identity source/authentication mode config.
-                    Apart from "name", one of the following parameters is required and only one of the following parameters is allowed: "oicd", "apiKey" or "kubernetes".
-                  properties:
-                    anonymous:
-                      type: object
-                    apiKey:
-                      properties:
-                        allNamespaces:
-                          default: false
-                          description: |-
-                            Whether Authorino should look for API key secrets in all namespaces or only in the same namespace as the AuthConfig.
-                            Enabling this option in namespaced Authorino instances has no effect.
-                          type: boolean
-                        selector:
-                          description: Label selector used by Authorino to match secrets
-                            from the cluster storing valid credentials to authenticate
-                            to this service
-                          properties:
-                            matchExpressions:
-                              description: matchExpressions is a list of label selector
-                                requirements. The requirements are ANDed.
-                              items:
-                                description: |-
-                                  A label selector requirement is a selector that contains values, a key, and an operator that
-                                  relates the key and values.
-                                properties:
-                                  key:
-                                    description: key is the label key that the selector
-                                      applies to.
-                                    type: string
-                                  operator:
-                                    description: |-
-                                      operator represents a key's relationship to a set of values.
-                                      Valid operators are In, NotIn, Exists and DoesNotExist.
-                                    type: string
-                                  values:
-                                    description: |-
-                                      values is an array of string values. If the operator is In or NotIn,
-                                      the values array must be non-empty. If the operator is Exists or DoesNotExist,
-                                      the values array must be empty. This array is replaced during a strategic
-                                      merge patch.
-                                    items:
-                                      type: string
-                                    type: array
-                                required:
-                                - key
-                                - operator
-                                type: object
-                              type: array
-                            matchLabels:
-                              additionalProperties:
-                                type: string
-                              description: |-
-                                matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
-                                map is equivalent to an element of matchExpressions, whose key field is "key", the
-                                operator is "In", and the values array contains only "value". The requirements are ANDed.
-                              type: object
-                          type: object
-                          x-kubernetes-map-type: atomic
-                      required:
-                      - selector
-                      type: object
-                    cache:
-                      description: |-
-                        Caching options for the identity resolved when applying this config.
-                        Omit it to avoid caching identity objects for this config.
-                      properties:
-                        key:
-                          description: |-
-                            Key used to store the entry in the cache.
-                            Cache entries from different metadata configs are stored and managed separately regardless of the key.
-                          properties:
-                            value:
-                              description: Static value
-                              type: string
-                            valueFrom:
-                              description: Dynamic value
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          type: object
-                        ttl:
-                          default: 60
-                          description: Duration (in seconds) of the external data
-                            in the cache before pulled again from the source.
-                          type: integer
-                      required:
-                      - key
-                      type: object
-                    credentials:
-                      description: |-
-                        Defines where client credentials are required to be passed in the request for this identity source/authentication mode.
-                        If omitted, it defaults to client credentials passed in the HTTP Authorization header and the "Bearer" prefix expected prepended to the credentials value (token, API key, etc).
-                      properties:
-                        in:
-                          default: authorization_header
-                          description: The location in the request where client credentials
-                            shall be passed on requests authenticating with this identity
-                            source/authentication mode.
-                          enum:
-                          - authorization_header
-                          - custom_header
-                          - query
-                          - cookie
-                          type: string
-                        keySelector:
-                          description: |-
-                            Used in conjunction with the `in` parameter.
-                            When used with `authorization_header`, the value is the prefix of the client credentials string, separated by a white-space, in the HTTP Authorization header (e.g. "Bearer", "Basic").
-                            When used with `custom_header`, `query` or `cookie`, the value is the name of the HTTP header, query string parameter or cookie key, respectively.
-                          type: string
-                      required:
-                      - keySelector
-                      type: object
-                    extendedProperties:
-                      description: |-
-                        Extends the resolved identity object with additional custom properties before appending to the authorization JSON.
-                        It requires the resolved identity object to always be of the JSON type 'object'. Other JSON types (array, string, etc) will break.
-                      items:
-                        properties:
-                          name:
-                            description: The name of the JSON property
-                            type: string
-                          overwrite:
-                            default: false
-                            description: Whether the value should overwrite the value
-                              of an existing property with the same name.
-                            type: boolean
-                          value:
-                            description: Static value of the JSON property
-                            x-kubernetes-preserve-unknown-fields: true
-                          valueFrom:
-                            description: Dynamic value of the JSON property
-                            properties:
-                              authJSON:
-                                description: |-
-                                  Selector to fetch a value from the authorization JSON.
-                                  It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                  or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                            type: object
-                        required:
-                        - name
-                        type: object
-                      type: array
-                    kubernetes:
-                      properties:
-                        audiences:
-                          description: |-
-                            The list of audiences (scopes) that must be claimed in a Kubernetes authentication token supplied in the request, and reviewed by Authorino.
-                            If omitted, Authorino will review tokens expecting the host name of the requested protected service amongst the audiences.
-                          items:
-                            type: string
-                          type: array
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this identity config should generate individual
-                        observability metrics
-                      type: boolean
-                    mtls:
-                      properties:
-                        allNamespaces:
-                          default: false
-                          description: |-
-                            Whether Authorino should look for TLS secrets in all namespaces or only in the same namespace as the AuthConfig.
-                            Enabling this option in namespaced Authorino instances has no effect.
-                          type: boolean
-                        selector:
-                          description: Label selector used by Authorino to match secrets
-                            from the cluster storing trusted CA certificates to validate
-                            clients trying to authenticate to this service
-                          properties:
-                            matchExpressions:
-                              description: matchExpressions is a list of label selector
-                                requirements. The requirements are ANDed.
-                              items:
-                                description: |-
-                                  A label selector requirement is a selector that contains values, a key, and an operator that
-                                  relates the key and values.
-                                properties:
-                                  key:
-                                    description: key is the label key that the selector
-                                      applies to.
-                                    type: string
-                                  operator:
-                                    description: |-
-                                      operator represents a key's relationship to a set of values.
-                                      Valid operators are In, NotIn, Exists and DoesNotExist.
-                                    type: string
-                                  values:
-                                    description: |-
-                                      values is an array of string values. If the operator is In or NotIn,
-                                      the values array must be non-empty. If the operator is Exists or DoesNotExist,
-                                      the values array must be empty. This array is replaced during a strategic
-                                      merge patch.
-                                    items:
-                                      type: string
-                                    type: array
-                                required:
-                                - key
-                                - operator
-                                type: object
-                              type: array
-                            matchLabels:
-                              additionalProperties:
-                                type: string
-                              description: |-
-                                matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
-                                map is equivalent to an element of matchExpressions, whose key field is "key", the
-                                operator is "In", and the values array contains only "value". The requirements are ANDed.
-                              type: object
-                          type: object
-                          x-kubernetes-map-type: atomic
-                      required:
-                      - selector
-                      type: object
-                    name:
-                      description: |-
-                        The name of this identity source/authentication mode.
-                        It usually identifies a source of identities or group of users/clients of the protected service.
-                        It can be used to refer to the resolved identity object in other configs.
-                      type: string
-                    oauth2:
-                      properties:
-                        credentialsRef:
-                          description: Reference to a Kubernetes secret in the same
-                            namespace, that stores client credentials to the OAuth2
-                            server.
-                          properties:
-                            name:
-                              description: |-
-                                Name of the referent.
-                                More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
-                                TODO: Add other useful fields. apiVersion, kind, uid?
-                              type: string
-                          type: object
-                          x-kubernetes-map-type: atomic
-                        tokenIntrospectionUrl:
-                          description: The full URL of the token introspection endpoint.
-                          type: string
-                        tokenTypeHint:
-                          description: |-
-                            The token type hint for the token introspection.
-                            If omitted, it defaults to "access_token".
-                          type: string
-                      required:
-                      - credentialsRef
-                      - tokenIntrospectionUrl
-                      type: object
-                    oidc:
-                      properties:
-                        endpoint:
-                          description: |-
-                            Endpoint of the OIDC issuer.
-                            Authorino will append to this value the well-known path to the OpenID Connect discovery endpoint (i.e. "/.well-known/openid-configuration"), used to automatically discover the OpenID Connect configuration, whose set of claims is expected to include (among others) the "jkws_uri" claim.
-                            The value must coincide with the value of  the "iss" (issuer) claim of the discovered OpenID Connect configuration.
-                          type: string
-                        ttl:
-                          description: Decides how long to wait before refreshing
-                            the OIDC configuration (in seconds).
-                          type: integer
-                      required:
-                      - endpoint
-                      type: object
-                    plain:
-                      properties:
-                        authJSON:
-                          description: |-
-                            Selector to fetch a value from the authorization JSON.
-                            It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                            or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                            Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                            The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                          type: string
-                      type: object
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    when:
-                      description: |-
-                        Conditions for Authorino to enforce this identity config.
-                        If omitted, the config will be enforced for all requests.
-                        If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Name of a named pattern
-                            type: string
-                          selector:
-                            description: |-
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson.
-                              The value is used to fetch content from the input authorization JSON built by Authorino along the identity and metadata phases.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                  required:
-                  - name
-                  type: object
-                type: array
-              metadata:
-                description: |-
-                  List of metadata source configs.
-                  Authorino fetches JSON content from sources on this list on every request.
-                items:
-                  description: |-
-                    The metadata config.
-                    Apart from "name", one of the following parameters is required and only one of the following parameters is allowed: "http", userInfo" or "uma".
-                  properties:
-                    cache:
-                      description: |-
-                        Caching options for the external metadata fetched when applying this config.
-                        Omit it to avoid caching metadata from this source.
-                      properties:
-                        key:
-                          description: |-
-                            Key used to store the entry in the cache.
-                            Cache entries from different metadata configs are stored and managed separately regardless of the key.
-                          properties:
-                            value:
-                              description: Static value
-                              type: string
-                            valueFrom:
-                              description: Dynamic value
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          type: object
-                        ttl:
-                          default: 60
-                          description: Duration (in seconds) of the external data
-                            in the cache before pulled again from the source.
-                          type: integer
-                      required:
-                      - key
-                      type: object
-                    http:
-                      description: Generic HTTP interface to obtain authorization
-                        metadata from a HTTP service.
-                      properties:
-                        body:
-                          description: |-
-                            Raw body of the HTTP request.
-                            Supersedes 'bodyParameters'; use either one or the other.
-                            Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                          properties:
-                            value:
-                              description: Static value
-                              type: string
-                            valueFrom:
-                              description: Dynamic value
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          type: object
-                        bodyParameters:
-                          description: |-
-                            Custom parameters to encode in the body of the HTTP request.
-                            Superseded by 'body'; use either one or the other.
-                            Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                          items:
-                            properties:
-                              name:
-                                description: The name of the JSON property
-                                type: string
-                              value:
-                                description: Static value of the JSON property
-                                x-kubernetes-preserve-unknown-fields: true
-                              valueFrom:
-                                description: Dynamic value of the JSON property
-                                properties:
-                                  authJSON:
-                                    description: |-
-                                      Selector to fetch a value from the authorization JSON.
-                                      It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                      or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                      Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                    type: string
-                                type: object
-                            required:
-                            - name
-                            type: object
-                          type: array
-                        contentType:
-                          default: application/x-www-form-urlencoded
-                          description: |-
-                            Content-Type of the request body. Shapes how 'bodyParameters' are encoded.
-                            Use it with method=POST; for GET requests, Content-Type is automatically set to 'text/plain'.
-                          enum:
-                          - application/x-www-form-urlencoded
-                          - application/json
-                          type: string
-                        credentials:
-                          description: |-
-                            Defines where client credentials will be passed in the request to the service.
-                            If omitted, it defaults to client credentials passed in the HTTP Authorization header and the "Bearer" prefix expected prepended to the secret value.
-                          properties:
-                            in:
-                              default: authorization_header
-                              description: The location in the request where client
-                                credentials shall be passed on requests authenticating
-                                with this identity source/authentication mode.
-                              enum:
-                              - authorization_header
-                              - custom_header
-                              - query
-                              - cookie
-                              type: string
-                            keySelector:
-                              description: |-
-                                Used in conjunction with the `in` parameter.
-                                When used with `authorization_header`, the value is the prefix of the client credentials string, separated by a white-space, in the HTTP Authorization header (e.g. "Bearer", "Basic").
-                                When used with `custom_header`, `query` or `cookie`, the value is the name of the HTTP header, query string parameter or cookie key, respectively.
-                              type: string
-                          required:
-                          - keySelector
-                          type: object
-                        endpoint:
-                          description: |-
-                            Endpoint of the HTTP service.
-                            The endpoint accepts variable placeholders in the format "{selector}", where "selector" is any pattern supported
-                            by https://pkg.go.dev/github.com/tidwall/gjson and selects value from the authorization JSON.
-                            E.g. https://ext-auth-server.io/metadata?p={context.request.http.path}
-                          type: string
-                        headers:
-                          description: Custom headers in the HTTP request.
-                          items:
-                            properties:
-                              name:
-                                description: The name of the JSON property
-                                type: string
-                              value:
-                                description: Static value of the JSON property
-                                x-kubernetes-preserve-unknown-fields: true
-                              valueFrom:
-                                description: Dynamic value of the JSON property
-                                properties:
-                                  authJSON:
-                                    description: |-
-                                      Selector to fetch a value from the authorization JSON.
-                                      It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                      or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                      Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                    type: string
-                                type: object
-                            required:
-                            - name
-                            type: object
-                          type: array
-                        method:
-                          default: GET
-                          description: |-
-                            HTTP verb used in the request to the service. Accepted values: GET (default), POST.
-                            When the request method is POST, the authorization JSON is passed in the body of the request.
-                          enum:
-                          - GET
-                          - POST
-                          type: string
-                        oauth2:
-                          description: Authentication with the HTTP service by OAuth2
-                            Client Credentials grant.
-                          properties:
-                            cache:
-                              default: true
-                              description: |-
-                                Caches and reuses the token until expired.
-                                Set it to false to force fetch the token at every authorization request regardless of expiration.
-                              type: boolean
-                            clientId:
-                              description: OAuth2 Client ID.
-                              type: string
-                            clientSecretRef:
-                              description: Reference to a Kubernetes Secret key that
-                                stores that OAuth2 Client Secret.
-                              properties:
-                                key:
-                                  description: The key of the secret to select from.  Must
-                                    be a valid secret key.
-                                  type: string
-                                name:
-                                  description: The name of the secret in the Authorino's
-                                    namespace to select from.
-                                  type: string
-                              required:
-                              - key
-                              - name
-                              type: object
-                            extraParams:
-                              additionalProperties:
-                                type: string
-                              description: Optional extra parameters for the requests
-                                to the token URL.
-                              type: object
-                            scopes:
-                              description: Optional scopes for the client credentials
-                                grant, if supported by he OAuth2 server.
-                              items:
-                                type: string
-                              type: array
-                            tokenUrl:
-                              description: Token endpoint URL of the OAuth2 resource
-                                server.
-                              type: string
-                          required:
-                          - clientId
-                          - clientSecretRef
-                          - tokenUrl
-                          type: object
-                        sharedSecretRef:
-                          description: |-
-                            Reference to a Secret key whose value will be passed by Authorino in the request.
-                            The HTTP service can use the shared secret to authenticate the origin of the request.
-                            Ignored if used together with oauth2.
-                          properties:
-                            key:
-                              description: The key of the secret to select from.  Must
-                                be a valid secret key.
-                              type: string
-                            name:
-                              description: The name of the secret in the Authorino's
-                                namespace to select from.
-                              type: string
-                          required:
-                          - key
-                          - name
-                          type: object
-                      required:
-                      - endpoint
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this metadata config should generate individual
-                        observability metrics
-                      type: boolean
-                    name:
-                      description: |-
-                        The name of the metadata source.
-                        It can be used to refer to the resolved metadata object in other configs.
-                      type: string
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    uma:
-                      description: User-Managed Access (UMA) source of resource data.
-                      properties:
-                        credentialsRef:
-                          description: Reference to a Kubernetes secret in the same
-                            namespace, that stores client credentials to the resource
-                            registration API of the UMA server.
-                          properties:
-                            name:
-                              description: |-
-                                Name of the referent.
-                                More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
-                                TODO: Add other useful fields. apiVersion, kind, uid?
-                              type: string
-                          type: object
-                          x-kubernetes-map-type: atomic
-                        endpoint:
-                          description: |-
-                            The endpoint of the UMA server.
-                            The value must coincide with the "issuer" claim of the UMA config discovered from the well-known uma configuration endpoint.
-                          type: string
-                      required:
-                      - credentialsRef
-                      - endpoint
-                      type: object
-                    userInfo:
-                      description: OpendID Connect UserInfo linked to an OIDC identity
-                        config of this same spec.
-                      properties:
-                        identitySource:
-                          description: The name of an OIDC identity source included
-                            in the "identity" section and whose OpenID Connect configuration
-                            discovered includes the OIDC "userinfo_endpoint" claim.
-                          type: string
-                      required:
-                      - identitySource
-                      type: object
-                    when:
-                      description: |-
-                        Conditions for Authorino to apply this metadata config.
-                        If omitted, the config will be applied for all requests.
-                        If present, all conditions must match for the config to be applied; otherwise, the config will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Name of a named pattern
-                            type: string
-                          selector:
-                            description: |-
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson.
-                              The value is used to fetch content from the input authorization JSON built by Authorino along the identity and metadata phases.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                  required:
-                  - name
-                  type: object
-                type: array
-              patterns:
-                additionalProperties:
-                  items:
-                    properties:
-                      operator:
-                        description: |-
-                          The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                          Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                        enum:
-                        - eq
-                        - neq
-                        - incl
-                        - excl
-                        - matches
-                        type: string
-                      selector:
-                        description: |-
-                          Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson.
-                          The value is used to fetch content from the input authorization JSON built by Authorino along the identity and metadata phases.
-                        type: string
-                      value:
-                        description: |-
-                          The value of reference for the comparison with the content fetched from the authorization JSON.
-                          If used with the "matches" operator, the value must compile to a valid Golang regex.
-                        type: string
-                    type: object
-                  type: array
-                description: Named sets of JSON patterns that can be referred in `when`
-                  conditionals and in JSON-pattern matching policy rules.
-                type: object
-              response:
-                description: |-
-                  List of response configs.
-                  Authorino gathers data from the auth pipeline to build custom responses for the client.
-                items:
-                  description: |-
-                    Dynamic response to return to the client.
-                    Apart from "name", one of the following parameters is required and only one of the following parameters is allowed: "wristband" or "json".
-                  properties:
-                    cache:
-                      description: |-
-                        Caching options for dynamic responses built when applying this config.
-                        Omit it to avoid caching dynamic responses for this config.
-                      properties:
-                        key:
-                          description: |-
-                            Key used to store the entry in the cache.
-                            Cache entries from different metadata configs are stored and managed separately regardless of the key.
-                          properties:
-                            value:
-                              description: Static value
-                              type: string
-                            valueFrom:
-                              description: Dynamic value
-                              properties:
-                                authJSON:
-                                  description: |-
-                                    Selector to fetch a value from the authorization JSON.
-                                    It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                    or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                              type: object
-                          type: object
-                        ttl:
-                          default: 60
-                          description: Duration (in seconds) of the external data
-                            in the cache before pulled again from the source.
-                          type: integer
-                      required:
-                      - key
-                      type: object
-                    json:
-                      properties:
-                        properties:
-                          description: List of JSON property-value pairs to be added
-                            to the dynamic response.
-                          items:
-                            properties:
-                              name:
-                                description: The name of the JSON property
-                                type: string
-                              value:
-                                description: Static value of the JSON property
-                                x-kubernetes-preserve-unknown-fields: true
-                              valueFrom:
-                                description: Dynamic value of the JSON property
-                                properties:
-                                  authJSON:
-                                    description: |-
-                                      Selector to fetch a value from the authorization JSON.
-                                      It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                      or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                      Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                    type: string
-                                type: object
-                            required:
-                            - name
-                            type: object
-                          type: array
-                      required:
-                      - properties
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this response config should generate individual
-                        observability metrics
-                      type: boolean
-                    name:
-                      description: |-
-                        Name of the custom response.
-                        It can be used to refer to the resolved response object in other configs.
-                      type: string
-                    plain:
-                      description: StaticOrDynamicValue is either a constant static
-                        string value or a config for fetching a value from a dynamic
-                        source (e.g. a path pattern of authorization JSON)
-                      properties:
-                        value:
-                          description: Static value
-                          type: string
-                        valueFrom:
-                          description: Dynamic value
-                          properties:
-                            authJSON:
-                              description: |-
-                                Selector to fetch a value from the authorization JSON.
-                                It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                          type: object
-                      type: object
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    when:
-                      description: |-
-                        Conditions for Authorino to enforce this custom response config.
-                        If omitted, the config will be enforced for all requests.
-                        If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Name of a named pattern
-                            type: string
-                          selector:
-                            description: |-
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson.
-                              The value is used to fetch content from the input authorization JSON built by Authorino along the identity and metadata phases.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                    wrapper:
-                      default: httpHeader
-                      description: |-
-                        How Authorino wraps the response.
-                        Use "httpHeader" (default) to wrap the response in an HTTP header; or "envoyDynamicMetadata" to wrap the response as Envoy Dynamic Metadata
-                      enum:
-                      - httpHeader
-                      - envoyDynamicMetadata
-                      type: string
-                    wrapperKey:
-                      description: |-
-                        The name of key used in the wrapped response (name of the HTTP header or property of the Envoy Dynamic Metadata JSON).
-                        If omitted, it will be set to the name of the configuration.
-                      type: string
-                    wristband:
-                      properties:
-                        customClaims:
-                          description: Any claims to be added to the wristband token
-                            apart from the standard JWT claims (iss, iat, exp) added
-                            by default.
-                          items:
-                            properties:
-                              name:
-                                description: The name of the JSON property
-                                type: string
-                              value:
-                                description: Static value of the JSON property
-                                x-kubernetes-preserve-unknown-fields: true
-                              valueFrom:
-                                description: Dynamic value of the JSON property
-                                properties:
-                                  authJSON:
-                                    description: |-
-                                      Selector to fetch a value from the authorization JSON.
-                                      It can be any path pattern to fetch from the authorization JSON (e.g. 'context.request.http.host')
-                                      or a string template with variable placeholders that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                      Any patterns supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      The following string modifiers are available: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                    type: string
-                                type: object
-                            required:
-                            - name
-                            type: object
-                          type: array
-                        issuer:
-                          description: 'The endpoint to the Authorino service that
-                            issues the wristband (format: <scheme>://<host>:<port>/<realm>,
-                            where <realm> = <namespace>/<authorino-auth-config-resource-name/wristband-config-name)'
-                          type: string
-                        signingKeyRefs:
-                          description: |-
-                            Reference by name to Kubernetes secrets and corresponding signing algorithms.
-                            The secrets must contain a `key.pem` entry whose value is the signing key formatted as PEM.
-                          items:
-                            properties:
-                              algorithm:
-                                description: Algorithm to sign the wristband token
-                                  using the signing key provided
-                                enum:
-                                - ES256
-                                - ES384
-                                - ES512
-                                - RS256
-                                - RS384
-                                - RS512
-                                type: string
-                              name:
-                                description: |-
-                                  Name of the signing key.
-                                  The value is used to reference the Kubernetes secret that stores the key and in the `kid` claim of the wristband token header.
-                                type: string
-                            required:
-                            - algorithm
-                            - name
-                            type: object
-                          type: array
-                        tokenDuration:
-                          description: Time span of the wristband token, in seconds.
-                          format: int64
-                          type: integer
-                      required:
-                      - issuer
-                      - signingKeyRefs
-                      type: object
-                  required:
-                  - name
-                  type: object
-                type: array
-              when:
-                description: |-
-                  Conditions for the AuthConfig to be enforced.
-                  If omitted, the AuthConfig will be enforced for all requests.
-                  If present, all conditions must match for the AuthConfig to be enforced; otherwise, Authorino skips the AuthConfig and returns immediately with status OK.
-                items:
-                  properties:
-                    all:
-                      description: A list of pattern expressions to be evaluated as
-                        a logical AND.
-                      items:
-                        type: object
-                        x-kubernetes-preserve-unknown-fields: true
-                      type: array
-                    any:
-                      description: A list of pattern expressions to be evaluated as
-                        a logical OR.
-                      items:
-                        type: object
-                        x-kubernetes-preserve-unknown-fields: true
-                      type: array
-                    operator:
-                      description: |-
-                        The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                        Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                      enum:
-                      - eq
-                      - neq
-                      - incl
-                      - excl
-                      - matches
-                      type: string
-                    patternRef:
-                      description: Name of a named pattern
-                      type: string
-                    selector:
-                      description: |-
-                        Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson.
-                        The value is used to fetch content from the input authorization JSON built by Authorino along the identity and metadata phases.
-                      type: string
-                    value:
-                      description: |-
-                        The value of reference for the comparison with the content fetched from the authorization JSON.
-                        If used with the "matches" operator, the value must compile to a valid Golang regex.
-                      type: string
-                  type: object
-                type: array
-            required:
-            - hosts
-            type: object
-          status:
-            description: AuthConfigStatus defines the observed state of AuthConfig
-            properties:
-              conditions:
-                items:
-                  properties:
-                    lastTransitionTime:
-                      description: Last time the condition transit from one status
-                        to another.
-                      format: date-time
-                      type: string
-                    lastUpdatedTime:
-                      description: Last time the condition was updated
-                      format: date-time
-                      type: string
-                    message:
-                      description: Human readable message indicating details about
-                        last transition.
-                      type: string
-                    reason:
-                      description: (brief) reason for the condition's last transition.
-                      type: string
-                    status:
-                      description: Status of the condition, one of True, False, Unknown.
-                      type: string
-                    type:
-                      description: Type of condition
-                      type: string
-                  required:
-                  - status
-                  - type
-                  type: object
-                type: array
-              summary:
-                properties:
-                  festivalWristbandEnabled:
-                    description: Indicator of whether the AuthConfig issues Festival
-                      Wristband tokens on successful evaluation of the AuthConfig
-                      (access granted)
-                    type: boolean
-                  hostsReady:
-                    description: Lists the hosts from spec.hosts linked to the resource
-                      in the index
-                    items:
-                      type: string
-                    type: array
-                  numAuthorizationPolicies:
-                    description: Number of authorization policies in the AuthConfig
-                    format: int64
-                    type: integer
-                  numHostsReady:
-                    description: Number of hosts from spec.hosts linked to the resource
-                      in the index, compared to the total number of hosts in spec.hosts
-                    type: string
-                  numIdentitySources:
-                    description: Number of trusted sources of identity for authentication
-                      in the AuthConfig
-                    format: int64
-                    type: integer
-                  numMetadataSources:
-                    description: Number of sources of external metadata in the AuthConfig
-                    format: int64
-                    type: integer
-                  numResponseItems:
-                    description: Number of custom authorization response items in
-                      the AuthConfig
-                    format: int64
-                    type: integer
-                  ready:
-                    description: Whether all hosts from spec.hosts have been linked
-                      to the resource in the index
-                    type: boolean
-                required:
-                - festivalWristbandEnabled
-                - hostsReady
-                - numAuthorizationPolicies
-                - numHostsReady
-                - numIdentitySources
-                - numMetadataSources
-                - numResponseItems
-                - ready
-                type: object
-            type: object
-        type: object
-    served: true
-    storage: false
-    subresources:
-      status: {}
-  - additionalPrinterColumns:
-    - description: Ready for all hosts
-      jsonPath: .status.summary.ready
-      name: Ready
-      type: string
-    - description: Number of hosts ready
-      jsonPath: .status.summary.numHostsReady
-      name: Hosts
-      type: string
-    - description: Number of trusted identity sources
-      jsonPath: .status.summary.numIdentitySources
-      name: Authentication
-      priority: 2
-      type: integer
-    - description: Number of external metadata sources
-      jsonPath: .status.summary.numMetadataSources
-      name: Metadata
-      priority: 2
-      type: integer
-    - description: Number of authorization policies
-      jsonPath: .status.summary.numAuthorizationPolicies
-      name: Authorization
-      priority: 2
-      type: integer
-    - description: Number of items added to the authorization response
-      jsonPath: .status.summary.numResponseItems
-      name: Response
-      priority: 2
-      type: integer
-    - description: Whether issuing Festival Wristbands
-      jsonPath: .status.summary.festivalWristbandEnabled
-      name: Wristband
-      priority: 2
-      type: boolean
-    name: v1beta2
-    schema:
-      openAPIV3Schema:
-        description: AuthConfig is the schema for Authorino's AuthConfig API
-        properties:
-          apiVersion:
-            description: |-
-              APIVersion defines the versioned schema of this representation of an object.
-              Servers should convert recognized schemas to the latest internal value, and
-              may reject unrecognized values.
-              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
-            type: string
-          kind:
-            description: |-
-              Kind is a string value representing the REST resource this object represents.
-              Servers may infer this from the endpoint the client submits requests to.
-              Cannot be updated.
-              In CamelCase.
-              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
-            type: string
-          metadata:
-            type: object
-          spec:
-            description: Specifies the desired state of the AuthConfig resource, i.e.
-              the authencation/authorization scheme to be applied to protect the matching
-              service hosts.
-            properties:
-              authentication:
-                additionalProperties:
-                  properties:
-                    anonymous:
-                      description: Anonymous access.
-                      type: object
-                    apiKey:
-                      description: Authentication based on API keys stored in Kubernetes
-                        secrets.
-                      properties:
-                        allNamespaces:
-                          default: false
-                          description: |-
-                            Whether Authorino should look for API key secrets in all namespaces or only in the same namespace as the AuthConfig.
-                            Enabling this option in namespaced Authorino instances has no effect.
-                          type: boolean
-                        selector:
-                          description: Label selector used by Authorino to match secrets
-                            from the cluster storing valid credentials to authenticate
-                            to this service
-                          properties:
-                            matchExpressions:
-                              description: matchExpressions is a list of label selector
-                                requirements. The requirements are ANDed.
-                              items:
-                                description: |-
-                                  A label selector requirement is a selector that contains values, a key, and an operator that
-                                  relates the key and values.
-                                properties:
-                                  key:
-                                    description: key is the label key that the selector
-                                      applies to.
-                                    type: string
-                                  operator:
-                                    description: |-
-                                      operator represents a key's relationship to a set of values.
-                                      Valid operators are In, NotIn, Exists and DoesNotExist.
-                                    type: string
-                                  values:
-                                    description: |-
-                                      values is an array of string values. If the operator is In or NotIn,
-                                      the values array must be non-empty. If the operator is Exists or DoesNotExist,
-                                      the values array must be empty. This array is replaced during a strategic
-                                      merge patch.
-                                    items:
-                                      type: string
-                                    type: array
-                                required:
-                                - key
-                                - operator
-                                type: object
-                              type: array
-                            matchLabels:
-                              additionalProperties:
-                                type: string
-                              description: |-
-                                matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
-                                map is equivalent to an element of matchExpressions, whose key field is "key", the
-                                operator is "In", and the values array contains only "value". The requirements are ANDed.
-                              type: object
-                          type: object
-                          x-kubernetes-map-type: atomic
-                      required:
-                      - selector
-                      type: object
-                    cache:
-                      description: |-
-                        Caching options for the resolved object returned when applying this config.
-                        Omit it to avoid caching objects for this config.
-                      properties:
-                        key:
-                          description: |-
-                            Key used to store the entry in the cache.
-                            The resolved key must be unique within the scope of this particular config.
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        ttl:
-                          default: 60
-                          description: Duration (in seconds) of the external data
-                            in the cache before pulled again from the source.
-                          type: integer
-                      required:
-                      - key
-                      type: object
-                    credentials:
-                      description: |-
-                        Defines where credentials are required to be passed in the request for authentication based on this config.
-                        If omitted, it defaults to credentials passed in the HTTP Authorization header and the "Bearer" prefix prepended to the secret credential value.
-                      properties:
-                        authorizationHeader:
-                          properties:
-                            prefix:
-                              type: string
-                          type: object
-                        cookie:
-                          properties:
-                            name:
-                              type: string
-                          required:
-                          - name
-                          type: object
-                        customHeader:
-                          properties:
-                            name:
-                              type: string
-                          required:
-                          - name
-                          type: object
-                        queryString:
-                          properties:
-                            name:
-                              type: string
-                          required:
-                          - name
-                          type: object
-                      type: object
-                    defaults:
-                      additionalProperties:
-                        properties:
-                          selector:
-                            description: |-
-                              Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                            type: string
-                          value:
-                            description: Static value
-                            x-kubernetes-preserve-unknown-fields: true
-                        type: object
-                      description: |-
-                        Set default property values (claims) for the resolved identity object, that are set before appending the object to
-                        the authorization JSON. If the property is already present in the resolved identity object, the default value is ignored.
-                        It requires the resolved identity object to always be a JSON object.
-                        Do not use this option with identity objects of other JSON types (array, string, etc).
-                      type: object
-                    jwt:
-                      description: Authentication based on JWT tokens.
-                      properties:
-                        issuerUrl:
-                          description: |-
-                            URL of the issuer of the JWT.
-                            If `jwksUrl` is omitted, Authorino will append the path to the OpenID Connect Well-Known Discovery endpoint
-                            (i.e. "/.well-known/openid-configuration") to this URL, to discover the OIDC configuration where to obtain
-                            the "jkws_uri" claim from.
-                            The value must coincide with the value of  the "iss" (issuer) claim of the discovered OpenID Connect configuration.
-                          type: string
-                        ttl:
-                          description: |-
-                            Decides how long to wait before refreshing the JWKS (in seconds).
-                            If omitted, Authorino will never refresh the JWKS.
-                          type: integer
-                      type: object
-                    kubernetesTokenReview:
-                      description: Authentication by Kubernetes token review.
-                      properties:
-                        audiences:
-                          description: |-
-                            The list of audiences (scopes) that must be claimed in a Kubernetes authentication token supplied in the request, and reviewed by Authorino.
-                            If omitted, Authorino will review tokens expecting the host name of the requested protected service amongst the audiences.
-                          items:
-                            type: string
-                          type: array
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this config should generate individual
-                        observability metrics
-                      type: boolean
-                    oauth2Introspection:
-                      description: Authentication by OAuth2 token introspection.
-                      properties:
-                        credentialsRef:
-                          description: Reference to a Kubernetes secret in the same
-                            namespace, that stores client credentials to the OAuth2
-                            server.
-                          properties:
-                            name:
-                              description: |-
-                                Name of the referent.
-                                More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
-                                TODO: Add other useful fields. apiVersion, kind, uid?
-                              type: string
-                          type: object
-                          x-kubernetes-map-type: atomic
-                        endpoint:
-                          description: The full URL of the token introspection endpoint.
-                          type: string
-                        tokenTypeHint:
-                          description: |-
-                            The token type hint for the token introspection.
-                            If omitted, it defaults to "access_token".
-                          type: string
-                      required:
-                      - credentialsRef
-                      - endpoint
-                      type: object
-                    overrides:
-                      additionalProperties:
-                        properties:
-                          selector:
-                            description: |-
-                              Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                            type: string
-                          value:
-                            description: Static value
-                            x-kubernetes-preserve-unknown-fields: true
-                        type: object
-                      description: |-
-                        Overrides the resolved identity object by setting the additional properties (claims) specified in this config,
-                        before appending the object to the authorization JSON.
-                        It requires the resolved identity object to always be a JSON object.
-                        Do not use this option with identity objects of other JSON types (array, string, etc).
-                      type: object
-                    plain:
-                      description: |-
-                        Identity object extracted from the context.
-                        Use this method when authentication is performed beforehand by a proxy and the resulting object passed to Authorino as JSON in the auth request.
-                      properties:
-                        selector:
-                          description: |-
-                            Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                            Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                            The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                          type: string
-                      required:
-                      - selector
-                      type: object
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    when:
-                      description: |-
-                        Conditions for Authorino to enforce this config.
-                        If omitted, the config will be enforced for all requests.
-                        If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Reference to a named set of pattern expressions
-                            type: string
-                          selector:
-                            description: |-
-                              Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              Authorino custom JSON path modifiers are also supported.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                    x509:
-                      description: |-
-                        Authentication based on client X.509 certificates.
-                        The certificates presented by the clients must be signed by a trusted CA whose certificates are stored in Kubernetes secrets.
-                      properties:
-                        allNamespaces:
-                          default: false
-                          description: |-
-                            Whether Authorino should look for TLS secrets in all namespaces or only in the same namespace as the AuthConfig.
-                            Enabling this option in namespaced Authorino instances has no effect.
-                          type: boolean
-                        selector:
-                          description: |-
-                            Label selector used by Authorino to match secrets from the cluster storing trusted CA certificates to validate
-                            clients trying to authenticate to this service
-                          properties:
-                            matchExpressions:
-                              description: matchExpressions is a list of label selector
-                                requirements. The requirements are ANDed.
-                              items:
-                                description: |-
-                                  A label selector requirement is a selector that contains values, a key, and an operator that
-                                  relates the key and values.
-                                properties:
-                                  key:
-                                    description: key is the label key that the selector
-                                      applies to.
-                                    type: string
-                                  operator:
-                                    description: |-
-                                      operator represents a key's relationship to a set of values.
-                                      Valid operators are In, NotIn, Exists and DoesNotExist.
-                                    type: string
-                                  values:
-                                    description: |-
-                                      values is an array of string values. If the operator is In or NotIn,
-                                      the values array must be non-empty. If the operator is Exists or DoesNotExist,
-                                      the values array must be empty. This array is replaced during a strategic
-                                      merge patch.
-                                    items:
-                                      type: string
-                                    type: array
-                                required:
-                                - key
-                                - operator
-                                type: object
-                              type: array
-                            matchLabels:
-                              additionalProperties:
-                                type: string
-                              description: |-
-                                matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
-                                map is equivalent to an element of matchExpressions, whose key field is "key", the
-                                operator is "In", and the values array contains only "value". The requirements are ANDed.
-                              type: object
-                          type: object
-                          x-kubernetes-map-type: atomic
-                      required:
-                      - selector
-                      type: object
-                  type: object
-                description: |-
-                  Authentication configs.
-                  At least one config MUST evaluate to a valid identity object for the auth request to be successful.
-                type: object
-              authorization:
-                additionalProperties:
-                  properties:
-                    cache:
-                      description: |-
-                        Caching options for the resolved object returned when applying this config.
-                        Omit it to avoid caching objects for this config.
-                      properties:
-                        key:
-                          description: |-
-                            Key used to store the entry in the cache.
-                            The resolved key must be unique within the scope of this particular config.
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        ttl:
-                          default: 60
-                          description: Duration (in seconds) of the external data
-                            in the cache before pulled again from the source.
-                          type: integer
-                      required:
-                      - key
-                      type: object
-                    kubernetesSubjectAccessReview:
-                      description: Authorization by Kubernetes SubjectAccessReview
-                      properties:
-                        groups:
-                          description: Groups the user must be a member of or, if
-                            `user` is omitted, the groups to check for authorization
-                            in the Kubernetes RBAC.
-                          items:
-                            type: string
-                          type: array
-                        resourceAttributes:
-                          description: |-
-                            Use resourceAttributes to check permissions on Kubernetes resources.
-                            If omitted, it performs a non-resource SubjectAccessReview, with verb and path inferred from the request.
-                          properties:
-                            group:
-                              description: |-
-                                API group of the resource.
-                                Use '*' for all API groups.
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            name:
-                              description: |-
-                                Resource name
-                                Omit it to check for authorization on all resources of the specified kind.
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            namespace:
-                              description: Namespace where the user must have permissions
-                                on the resource.
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            resource:
-                              description: |-
-                                Resource kind
-                                Use '*' for all resource kinds.
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            subresource:
-                              description: Subresource kind
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            verb:
-                              description: |-
-                                Verb to check for authorization on the resource.
-                                Use '*' for all verbs.
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                          type: object
-                        user:
-                          description: |-
-                            User to check for authorization in the Kubernetes RBAC.
-                            Omit it to check for group authorization only.
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this config should generate individual
-                        observability metrics
-                      type: boolean
-                    opa:
-                      description: Open Policy Agent (OPA) Rego policy.
-                      properties:
-                        allValues:
-                          default: false
-                          description: |-
-                            Returns the value of all Rego rules in the virtual document. Values can be read in subsequent evaluators/phases of the Auth Pipeline.
-                            Otherwise, only the default `allow` rule will be exposed.
-                            Returning all Rego rules can affect performance of OPA policies during reconciliation (policy precompile) and at runtime.
-                          type: boolean
-                        externalPolicy:
-                          description: |-
-                            Settings for fetching the OPA policy from an external registry.
-                            Use it alternatively to 'rego'.
-                            For the configurations of the HTTP request, the following options are not implemented: 'method', 'body', 'bodyParameters',
-                            'contentType', 'headers', 'oauth2'. Use it only with: 'url', 'sharedSecret', 'credentials'.
-                          properties:
-                            body:
-                              description: |-
-                                Raw body of the HTTP request.
-                                Supersedes 'bodyParameters'; use either one or the other.
-                                Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            bodyParameters:
-                              additionalProperties:
-                                properties:
-                                  selector:
-                                    description: |-
-                                      Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                      Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                    type: string
-                                  value:
-                                    description: Static value
-                                    x-kubernetes-preserve-unknown-fields: true
-                                type: object
-                              description: |-
-                                Custom parameters to encode in the body of the HTTP request.
-                                Superseded by 'body'; use either one or the other.
-                                Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                              type: object
-                            contentType:
-                              default: application/x-www-form-urlencoded
-                              description: |-
-                                Content-Type of the request body. Shapes how 'bodyParameters' are encoded.
-                                Use it with method=POST; for GET requests, Content-Type is automatically set to 'text/plain'.
-                              enum:
-                              - application/x-www-form-urlencoded
-                              - application/json
-                              type: string
-                            credentials:
-                              description: |-
-                                Defines where client credentials will be passed in the request to the service.
-                                If omitted, it defaults to client credentials passed in the HTTP Authorization header and the "Bearer" prefix expected prepended to the secret value.
-                              properties:
-                                authorizationHeader:
-                                  properties:
-                                    prefix:
-                                      type: string
-                                  type: object
-                                cookie:
-                                  properties:
-                                    name:
-                                      type: string
-                                  required:
-                                  - name
-                                  type: object
-                                customHeader:
-                                  properties:
-                                    name:
-                                      type: string
-                                  required:
-                                  - name
-                                  type: object
-                                queryString:
-                                  properties:
-                                    name:
-                                      type: string
-                                  required:
-                                  - name
-                                  type: object
-                              type: object
-                            headers:
-                              additionalProperties:
-                                properties:
-                                  selector:
-                                    description: |-
-                                      Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                      Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                    type: string
-                                  value:
-                                    description: Static value
-                                    x-kubernetes-preserve-unknown-fields: true
-                                type: object
-                              description: Custom headers in the HTTP request.
-                              type: object
-                            method:
-                              default: GET
-                              description: |-
-                                HTTP verb used in the request to the service. Accepted values: GET (default), POST.
-                                When the request method is POST, the authorization JSON is passed in the body of the request.
-                              enum:
-                              - GET
-                              - POST
-                              - PUT
-                              - PATCH
-                              - DELETE
-                              - HEAD
-                              - OPTIONS
-                              - CONNECT
-                              - TRACE
-                              type: string
-                            oauth2:
-                              description: Authentication with the HTTP service by
-                                OAuth2 Client Credentials grant.
-                              properties:
-                                cache:
-                                  default: true
-                                  description: |-
-                                    Caches and reuses the token until expired.
-                                    Set it to false to force fetch the token at every authorization request regardless of expiration.
-                                  type: boolean
-                                clientId:
-                                  description: OAuth2 Client ID.
-                                  type: string
-                                clientSecretRef:
-                                  description: Reference to a Kuberentes Secret key
-                                    that stores that OAuth2 Client Secret.
-                                  properties:
-                                    key:
-                                      description: The key of the secret to select
-                                        from.  Must be a valid secret key.
-                                      type: string
-                                    name:
-                                      description: The name of the secret in the Authorino's
-                                        namespace to select from.
-                                      type: string
-                                  required:
-                                  - key
-                                  - name
-                                  type: object
-                                extraParams:
-                                  additionalProperties:
-                                    type: string
-                                  description: Optional extra parameters for the requests
-                                    to the token URL.
-                                  type: object
-                                scopes:
-                                  description: Optional scopes for the client credentials
-                                    grant, if supported by he OAuth2 server.
-                                  items:
-                                    type: string
-                                  type: array
-                                tokenUrl:
-                                  description: Token endpoint URL of the OAuth2 resource
-                                    server.
-                                  type: string
-                              required:
-                              - clientId
-                              - clientSecretRef
-                              - tokenUrl
-                              type: object
-                            sharedSecretRef:
-                              description: |-
-                                Reference to a Secret key whose value will be passed by Authorino in the request.
-                                The HTTP service can use the shared secret to authenticate the origin of the request.
-                                Ignored if used together with oauth2.
-                              properties:
-                                key:
-                                  description: The key of the secret to select from.  Must
-                                    be a valid secret key.
-                                  type: string
-                                name:
-                                  description: The name of the secret in the Authorino's
-                                    namespace to select from.
-                                  type: string
-                              required:
-                              - key
-                              - name
-                              type: object
-                            ttl:
-                              description: Duration (in seconds) of the external data
-                                in the cache before pulled again from the source.
-                              type: integer
-                            url:
-                              description: |-
-                                Endpoint URL of the HTTP service.
-                                The value can include variable placeholders in the format "{selector}", where "selector" is any pattern supported
-                                by https://pkg.go.dev/github.com/tidwall/gjson and selects value from the authorization JSON.
-                                E.g. https://ext-auth-server.io/metadata?p={request.path}
-                              type: string
-                          required:
-                          - url
-                          type: object
-                        rego:
-                          description: |-
-                            Authorization policy as a Rego language document.
-                            The Rego document must include the "allow" condition, set by Authorino to "false" by default (i.e. requests are unauthorized unless changed).
-                            The Rego document must NOT include the "package" declaration in line 1.
-                          type: string
-                      type: object
-                    patternMatching:
-                      description: Pattern-matching authorization rules.
-                      properties:
-                        patterns:
-                          items:
-                            properties:
-                              all:
-                                description: A list of pattern expressions to be evaluated
-                                  as a logical AND.
-                                items:
-                                  type: object
-                                  x-kubernetes-preserve-unknown-fields: true
-                                type: array
-                              any:
-                                description: A list of pattern expressions to be evaluated
-                                  as a logical OR.
-                                items:
-                                  type: object
-                                  x-kubernetes-preserve-unknown-fields: true
-                                type: array
-                              operator:
-                                description: |-
-                                  The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                                  Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                                enum:
-                                - eq
-                                - neq
-                                - incl
-                                - excl
-                                - matches
-                                type: string
-                              patternRef:
-                                description: Reference to a named set of pattern expressions
-                                type: string
-                              selector:
-                                description: |-
-                                  Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                                  Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  Authorino custom JSON path modifiers are also supported.
-                                type: string
-                              value:
-                                description: |-
-                                  The value of reference for the comparison with the content fetched from the authorization JSON.
-                                  If used with the "matches" operator, the value must compile to a valid Golang regex.
-                                type: string
-                            type: object
-                          type: array
-                      required:
-                      - patterns
-                      type: object
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    spicedb:
-                      description: Authorization decision delegated to external Authzed/SpiceDB
-                        server.
-                      properties:
-                        endpoint:
-                          description: Hostname and port number to the GRPC interface
-                            of the SpiceDB server (e.g. spicedb:50051).
-                          type: string
-                        insecure:
-                          description: Insecure HTTP connection (i.e. disables TLS
-                            verification)
-                          type: boolean
-                        permission:
-                          description: The name of the permission (or relation) on
-                            which to execute the check.
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        resource:
-                          description: The resource on which to check the permission
-                            or relation.
-                          properties:
-                            kind:
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            name:
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                          type: object
-                        sharedSecretRef:
-                          description: Reference to a Secret key whose value will
-                            be used by Authorino to authenticate with the Authzed
-                            service.
-                          properties:
-                            key:
-                              description: The key of the secret to select from.  Must
-                                be a valid secret key.
-                              type: string
-                            name:
-                              description: The name of the secret in the Authorino's
-                                namespace to select from.
-                              type: string
-                          required:
-                          - key
-                          - name
-                          type: object
-                        subject:
-                          description: The subject that will be checked for the permission
-                            or relation.
-                          properties:
-                            kind:
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            name:
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                          type: object
-                      required:
-                      - endpoint
-                      type: object
-                    when:
-                      description: |-
-                        Conditions for Authorino to enforce this config.
-                        If omitted, the config will be enforced for all requests.
-                        If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Reference to a named set of pattern expressions
-                            type: string
-                          selector:
-                            description: |-
-                              Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              Authorino custom JSON path modifiers are also supported.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                  type: object
-                description: |-
-                  Authorization policies.
-                  All policies MUST evaluate to "allowed = true" for the auth request be successful.
-                type: object
-              callbacks:
-                additionalProperties:
-                  properties:
-                    cache:
-                      description: |-
-                        Caching options for the resolved object returned when applying this config.
-                        Omit it to avoid caching objects for this config.
-                      properties:
-                        key:
-                          description: |-
-                            Key used to store the entry in the cache.
-                            The resolved key must be unique within the scope of this particular config.
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        ttl:
-                          default: 60
-                          description: Duration (in seconds) of the external data
-                            in the cache before pulled again from the source.
-                          type: integer
-                      required:
-                      - key
-                      type: object
-                    http:
-                      description: Settings of the external HTTP request
-                      properties:
-                        body:
-                          description: |-
-                            Raw body of the HTTP request.
-                            Supersedes 'bodyParameters'; use either one or the other.
-                            Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        bodyParameters:
-                          additionalProperties:
-                            properties:
-                              selector:
-                                description: |-
-                                  Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                              value:
-                                description: Static value
-                                x-kubernetes-preserve-unknown-fields: true
-                            type: object
-                          description: |-
-                            Custom parameters to encode in the body of the HTTP request.
-                            Superseded by 'body'; use either one or the other.
-                            Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                          type: object
-                        contentType:
-                          default: application/x-www-form-urlencoded
-                          description: |-
-                            Content-Type of the request body. Shapes how 'bodyParameters' are encoded.
-                            Use it with method=POST; for GET requests, Content-Type is automatically set to 'text/plain'.
-                          enum:
-                          - application/x-www-form-urlencoded
-                          - application/json
-                          type: string
-                        credentials:
-                          description: |-
-                            Defines where client credentials will be passed in the request to the service.
-                            If omitted, it defaults to client credentials passed in the HTTP Authorization header and the "Bearer" prefix expected prepended to the secret value.
-                          properties:
-                            authorizationHeader:
-                              properties:
-                                prefix:
-                                  type: string
-                              type: object
-                            cookie:
-                              properties:
-                                name:
-                                  type: string
-                              required:
-                              - name
-                              type: object
-                            customHeader:
-                              properties:
-                                name:
-                                  type: string
-                              required:
-                              - name
-                              type: object
-                            queryString:
-                              properties:
-                                name:
-                                  type: string
-                              required:
-                              - name
-                              type: object
-                          type: object
-                        headers:
-                          additionalProperties:
-                            properties:
-                              selector:
-                                description: |-
-                                  Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                              value:
-                                description: Static value
-                                x-kubernetes-preserve-unknown-fields: true
-                            type: object
-                          description: Custom headers in the HTTP request.
-                          type: object
-                        method:
-                          default: GET
-                          description: |-
-                            HTTP verb used in the request to the service. Accepted values: GET (default), POST.
-                            When the request method is POST, the authorization JSON is passed in the body of the request.
-                          enum:
-                          - GET
-                          - POST
-                          - PUT
-                          - PATCH
-                          - DELETE
-                          - HEAD
-                          - OPTIONS
-                          - CONNECT
-                          - TRACE
-                          type: string
-                        oauth2:
-                          description: Authentication with the HTTP service by OAuth2
-                            Client Credentials grant.
-                          properties:
-                            cache:
-                              default: true
-                              description: |-
-                                Caches and reuses the token until expired.
-                                Set it to false to force fetch the token at every authorization request regardless of expiration.
-                              type: boolean
-                            clientId:
-                              description: OAuth2 Client ID.
-                              type: string
-                            clientSecretRef:
-                              description: Reference to a Kuberentes Secret key that
-                                stores that OAuth2 Client Secret.
-                              properties:
-                                key:
-                                  description: The key of the secret to select from.  Must
-                                    be a valid secret key.
-                                  type: string
-                                name:
-                                  description: The name of the secret in the Authorino's
-                                    namespace to select from.
-                                  type: string
-                              required:
-                              - key
-                              - name
-                              type: object
-                            extraParams:
-                              additionalProperties:
-                                type: string
-                              description: Optional extra parameters for the requests
-                                to the token URL.
-                              type: object
-                            scopes:
-                              description: Optional scopes for the client credentials
-                                grant, if supported by he OAuth2 server.
-                              items:
-                                type: string
-                              type: array
-                            tokenUrl:
-                              description: Token endpoint URL of the OAuth2 resource
-                                server.
-                              type: string
-                          required:
-                          - clientId
-                          - clientSecretRef
-                          - tokenUrl
-                          type: object
-                        sharedSecretRef:
-                          description: |-
-                            Reference to a Secret key whose value will be passed by Authorino in the request.
-                            The HTTP service can use the shared secret to authenticate the origin of the request.
-                            Ignored if used together with oauth2.
-                          properties:
-                            key:
-                              description: The key of the secret to select from.  Must
-                                be a valid secret key.
-                              type: string
-                            name:
-                              description: The name of the secret in the Authorino's
-                                namespace to select from.
-                              type: string
-                          required:
-                          - key
-                          - name
-                          type: object
-                        url:
-                          description: |-
-                            Endpoint URL of the HTTP service.
-                            The value can include variable placeholders in the format "{selector}", where "selector" is any pattern supported
-                            by https://pkg.go.dev/github.com/tidwall/gjson and selects value from the authorization JSON.
-                            E.g. https://ext-auth-server.io/metadata?p={request.path}
-                          type: string
-                      required:
-                      - url
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this config should generate individual
-                        observability metrics
-                      type: boolean
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    when:
-                      description: |-
-                        Conditions for Authorino to enforce this config.
-                        If omitted, the config will be enforced for all requests.
-                        If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Reference to a named set of pattern expressions
-                            type: string
-                          selector:
-                            description: |-
-                              Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              Authorino custom JSON path modifiers are also supported.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                  required:
-                  - http
-                  type: object
-                description: |-
-                  Callback functions.
-                  Authorino sends callbacks at the end of the auth pipeline to the endpoints specified in this config.
-                type: object
-              hosts:
-                description: |-
-                  The list of public host names of the services protected by this authentication/authorization scheme.
-                  Authorino uses the requested host to lookup for the corresponding authentication/authorization configs to enforce.
-                items:
-                  type: string
-                type: array
-              metadata:
-                additionalProperties:
-                  properties:
-                    cache:
-                      description: |-
-                        Caching options for the resolved object returned when applying this config.
-                        Omit it to avoid caching objects for this config.
-                      properties:
-                        key:
-                          description: |-
-                            Key used to store the entry in the cache.
-                            The resolved key must be unique within the scope of this particular config.
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        ttl:
-                          default: 60
-                          description: Duration (in seconds) of the external data
-                            in the cache before pulled again from the source.
-                          type: integer
-                      required:
-                      - key
-                      type: object
-                    http:
-                      description: External source of auth metadata via HTTP request
-                      properties:
-                        body:
-                          description: |-
-                            Raw body of the HTTP request.
-                            Supersedes 'bodyParameters'; use either one or the other.
-                            Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        bodyParameters:
-                          additionalProperties:
-                            properties:
-                              selector:
-                                description: |-
-                                  Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                              value:
-                                description: Static value
-                                x-kubernetes-preserve-unknown-fields: true
-                            type: object
-                          description: |-
-                            Custom parameters to encode in the body of the HTTP request.
-                            Superseded by 'body'; use either one or the other.
-                            Use it with method=POST; for GET requests, set parameters as query string in the 'endpoint' (placeholders can be used).
-                          type: object
-                        contentType:
-                          default: application/x-www-form-urlencoded
-                          description: |-
-                            Content-Type of the request body. Shapes how 'bodyParameters' are encoded.
-                            Use it with method=POST; for GET requests, Content-Type is automatically set to 'text/plain'.
-                          enum:
-                          - application/x-www-form-urlencoded
-                          - application/json
-                          type: string
-                        credentials:
-                          description: |-
-                            Defines where client credentials will be passed in the request to the service.
-                            If omitted, it defaults to client credentials passed in the HTTP Authorization header and the "Bearer" prefix expected prepended to the secret value.
-                          properties:
-                            authorizationHeader:
-                              properties:
-                                prefix:
-                                  type: string
-                              type: object
-                            cookie:
-                              properties:
-                                name:
-                                  type: string
-                              required:
-                              - name
-                              type: object
-                            customHeader:
-                              properties:
-                                name:
-                                  type: string
-                              required:
-                              - name
-                              type: object
-                            queryString:
-                              properties:
-                                name:
-                                  type: string
-                              required:
-                              - name
-                              type: object
-                          type: object
-                        headers:
-                          additionalProperties:
-                            properties:
-                              selector:
-                                description: |-
-                                  Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                  Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                  The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                type: string
-                              value:
-                                description: Static value
-                                x-kubernetes-preserve-unknown-fields: true
-                            type: object
-                          description: Custom headers in the HTTP request.
-                          type: object
-                        method:
-                          default: GET
-                          description: |-
-                            HTTP verb used in the request to the service. Accepted values: GET (default), POST.
-                            When the request method is POST, the authorization JSON is passed in the body of the request.
-                          enum:
-                          - GET
-                          - POST
-                          - PUT
-                          - PATCH
-                          - DELETE
-                          - HEAD
-                          - OPTIONS
-                          - CONNECT
-                          - TRACE
-                          type: string
-                        oauth2:
-                          description: Authentication with the HTTP service by OAuth2
-                            Client Credentials grant.
-                          properties:
-                            cache:
-                              default: true
-                              description: |-
-                                Caches and reuses the token until expired.
-                                Set it to false to force fetch the token at every authorization request regardless of expiration.
-                              type: boolean
-                            clientId:
-                              description: OAuth2 Client ID.
-                              type: string
-                            clientSecretRef:
-                              description: Reference to a Kuberentes Secret key that
-                                stores that OAuth2 Client Secret.
-                              properties:
-                                key:
-                                  description: The key of the secret to select from.  Must
-                                    be a valid secret key.
-                                  type: string
-                                name:
-                                  description: The name of the secret in the Authorino's
-                                    namespace to select from.
-                                  type: string
-                              required:
-                              - key
-                              - name
-                              type: object
-                            extraParams:
-                              additionalProperties:
-                                type: string
-                              description: Optional extra parameters for the requests
-                                to the token URL.
-                              type: object
-                            scopes:
-                              description: Optional scopes for the client credentials
-                                grant, if supported by he OAuth2 server.
-                              items:
-                                type: string
-                              type: array
-                            tokenUrl:
-                              description: Token endpoint URL of the OAuth2 resource
-                                server.
-                              type: string
-                          required:
-                          - clientId
-                          - clientSecretRef
-                          - tokenUrl
-                          type: object
-                        sharedSecretRef:
-                          description: |-
-                            Reference to a Secret key whose value will be passed by Authorino in the request.
-                            The HTTP service can use the shared secret to authenticate the origin of the request.
-                            Ignored if used together with oauth2.
-                          properties:
-                            key:
-                              description: The key of the secret to select from.  Must
-                                be a valid secret key.
-                              type: string
-                            name:
-                              description: The name of the secret in the Authorino's
-                                namespace to select from.
-                              type: string
-                          required:
-                          - key
-                          - name
-                          type: object
-                        url:
-                          description: |-
-                            Endpoint URL of the HTTP service.
-                            The value can include variable placeholders in the format "{selector}", where "selector" is any pattern supported
-                            by https://pkg.go.dev/github.com/tidwall/gjson and selects value from the authorization JSON.
-                            E.g. https://ext-auth-server.io/metadata?p={request.path}
-                          type: string
-                      required:
-                      - url
-                      type: object
-                    metrics:
-                      default: false
-                      description: Whether this config should generate individual
-                        observability metrics
-                      type: boolean
-                    priority:
-                      default: 0
-                      description: |-
-                        Priority group of the config.
-                        All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                      type: integer
-                    uma:
-                      description: User-Managed Access (UMA) source of resource data.
-                      properties:
-                        credentialsRef:
-                          description: Reference to a Kubernetes secret in the same
-                            namespace, that stores client credentials to the resource
-                            registration API of the UMA server.
-                          properties:
-                            name:
-                              description: |-
-                                Name of the referent.
-                                More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
-                                TODO: Add other useful fields. apiVersion, kind, uid?
-                              type: string
-                          type: object
-                          x-kubernetes-map-type: atomic
-                        endpoint:
-                          description: |-
-                            The endpoint of the UMA server.
-                            The value must coincide with the "issuer" claim of the UMA config discovered from the well-known uma configuration endpoint.
-                          type: string
-                      required:
-                      - credentialsRef
-                      - endpoint
-                      type: object
-                    userInfo:
-                      description: OpendID Connect UserInfo linked to an OIDC authentication
-                        config specified in this same AuthConfig.
-                      properties:
-                        identitySource:
-                          description: The name of an OIDC-enabled JWT authentication
-                            config whose OpenID Connect configuration discovered includes
-                            the OIDC "userinfo_endpoint" claim.
-                          type: string
-                      required:
-                      - identitySource
-                      type: object
-                    when:
-                      description: |-
-                        Conditions for Authorino to enforce this config.
-                        If omitted, the config will be enforced for all requests.
-                        If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                      items:
-                        properties:
-                          all:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical AND.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          any:
-                            description: A list of pattern expressions to be evaluated
-                              as a logical OR.
-                            items:
-                              type: object
-                              x-kubernetes-preserve-unknown-fields: true
-                            type: array
-                          operator:
-                            description: |-
-                              The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                              Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                            enum:
-                            - eq
-                            - neq
-                            - incl
-                            - excl
-                            - matches
-                            type: string
-                          patternRef:
-                            description: Reference to a named set of pattern expressions
-                            type: string
-                          selector:
-                            description: |-
-                              Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              Authorino custom JSON path modifiers are also supported.
-                            type: string
-                          value:
-                            description: |-
-                              The value of reference for the comparison with the content fetched from the authorization JSON.
-                              If used with the "matches" operator, the value must compile to a valid Golang regex.
-                            type: string
-                        type: object
-                      type: array
-                  type: object
-                description: |-
-                  Metadata sources.
-                  Authorino fetches auth metadata as JSON from sources specified in this config.
-                type: object
-              patterns:
-                additionalProperties:
-                  items:
-                    properties:
-                      operator:
-                        description: |-
-                          The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                          Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                        enum:
-                        - eq
-                        - neq
-                        - incl
-                        - excl
-                        - matches
-                        type: string
-                      selector:
-                        description: |-
-                          Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                          Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                          Authorino custom JSON path modifiers are also supported.
-                        type: string
-                      value:
-                        description: |-
-                          The value of reference for the comparison with the content fetched from the authorization JSON.
-                          If used with the "matches" operator, the value must compile to a valid Golang regex.
-                        type: string
-                    type: object
-                  type: array
-                description: Named sets of patterns that can be referred in `when`
-                  conditions and in pattern-matching authorization policy rules.
-                type: object
-              response:
-                description: |-
-                  Response items.
-                  Authorino builds custom responses to the client of the auth request.
-                properties:
-                  success:
-                    description: |-
-                      Response items to be included in the auth response when the request is authenticated and authorized.
-                      For integration of Authorino via proxy, the proxy must use these settings to propagate dynamic metadata and/or inject data in the request.
-                    properties:
-                      dynamicMetadata:
-                        additionalProperties:
-                          description: Settings of the success custom response item.
-                          properties:
-                            cache:
-                              description: |-
-                                Caching options for the resolved object returned when applying this config.
-                                Omit it to avoid caching objects for this config.
-                              properties:
-                                key:
-                                  description: |-
-                                    Key used to store the entry in the cache.
-                                    The resolved key must be unique within the scope of this particular config.
-                                  properties:
-                                    selector:
-                                      description: |-
-                                        Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                    value:
-                                      description: Static value
-                                      x-kubernetes-preserve-unknown-fields: true
-                                  type: object
-                                ttl:
-                                  default: 60
-                                  description: Duration (in seconds) of the external
-                                    data in the cache before pulled again from the
-                                    source.
-                                  type: integer
-                              required:
-                              - key
-                              type: object
-                            json:
-                              description: |-
-                                JSON object
-                                Specify it as the list of properties of the object, whose values can combine static values and values selected from the authorization JSON.
-                              properties:
-                                properties:
-                                  additionalProperties:
-                                    properties:
-                                      selector:
-                                        description: |-
-                                          Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                          Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                          The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                        type: string
-                                      value:
-                                        description: Static value
-                                        x-kubernetes-preserve-unknown-fields: true
-                                    type: object
-                                  type: object
-                              required:
-                              - properties
-                              type: object
-                            key:
-                              description: |-
-                                The key used to add the custom response item (name of the HTTP header or root property of the Dynamic Metadata object).
-                                If omitted, it will be set to the name of the response config.
-                              type: string
-                            metrics:
-                              default: false
-                              description: Whether this config should generate individual
-                                observability metrics
-                              type: boolean
-                            plain:
-                              description: Plain text content
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            priority:
-                              default: 0
-                              description: |-
-                                Priority group of the config.
-                                All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                              type: integer
-                            when:
-                              description: |-
-                                Conditions for Authorino to enforce this config.
-                                If omitted, the config will be enforced for all requests.
-                                If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                              items:
-                                properties:
-                                  all:
-                                    description: A list of pattern expressions to
-                                      be evaluated as a logical AND.
-                                    items:
-                                      type: object
-                                      x-kubernetes-preserve-unknown-fields: true
-                                    type: array
-                                  any:
-                                    description: A list of pattern expressions to
-                                      be evaluated as a logical OR.
-                                    items:
-                                      type: object
-                                      x-kubernetes-preserve-unknown-fields: true
-                                    type: array
-                                  operator:
-                                    description: |-
-                                      The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                                      Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                                    enum:
-                                    - eq
-                                    - neq
-                                    - incl
-                                    - excl
-                                    - matches
-                                    type: string
-                                  patternRef:
-                                    description: Reference to a named set of pattern
-                                      expressions
-                                    type: string
-                                  selector:
-                                    description: |-
-                                      Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                                      Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      Authorino custom JSON path modifiers are also supported.
-                                    type: string
-                                  value:
-                                    description: |-
-                                      The value of reference for the comparison with the content fetched from the authorization JSON.
-                                      If used with the "matches" operator, the value must compile to a valid Golang regex.
-                                    type: string
-                                type: object
-                              type: array
-                            wristband:
-                              description: Authorino Festival Wristband token
-                              properties:
-                                customClaims:
-                                  additionalProperties:
-                                    properties:
-                                      selector:
-                                        description: |-
-                                          Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                          Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                          The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                        type: string
-                                      value:
-                                        description: Static value
-                                        x-kubernetes-preserve-unknown-fields: true
-                                    type: object
-                                  description: Any claims to be added to the wristband
-                                    token apart from the standard JWT claims (iss,
-                                    iat, exp) added by default.
-                                  type: object
-                                issuer:
-                                  description: 'The endpoint to the Authorino service
-                                    that issues the wristband (format: <scheme>://<host>:<port>/<realm>,
-                                    where <realm> = <namespace>/<authorino-auth-config-resource-name/wristband-config-name)'
-                                  type: string
-                                signingKeyRefs:
-                                  description: |-
-                                    Reference by name to Kubernetes secrets and corresponding signing algorithms.
-                                    The secrets must contain a `key.pem` entry whose value is the signing key formatted as PEM.
-                                  items:
-                                    properties:
-                                      algorithm:
-                                        description: Algorithm to sign the wristband
-                                          token using the signing key provided
-                                        enum:
-                                        - ES256
-                                        - ES384
-                                        - ES512
-                                        - RS256
-                                        - RS384
-                                        - RS512
-                                        type: string
-                                      name:
-                                        description: |-
-                                          Name of the signing key.
-                                          The value is used to reference the Kubernetes secret that stores the key and in the `kid` claim of the wristband token header.
-                                        type: string
-                                    required:
-                                    - algorithm
-                                    - name
-                                    type: object
-                                  type: array
-                                tokenDuration:
-                                  description: Time span of the wristband token, in
-                                    seconds.
-                                  format: int64
-                                  type: integer
-                              required:
-                              - issuer
-                              - signingKeyRefs
-                              type: object
-                          type: object
-                        description: |-
-                          Custom success response items wrapped as HTTP headers.
-                          For integration of Authorino via proxy, the proxy must use these settings to propagate dynamic metadata.
-                          See https://www.envoyproxy.io/docs/envoy/latest/configuration/advanced/well_known_dynamic_metadata
-                        type: object
-                      headers:
-                        additionalProperties:
-                          properties:
-                            cache:
-                              description: |-
-                                Caching options for the resolved object returned when applying this config.
-                                Omit it to avoid caching objects for this config.
-                              properties:
-                                key:
-                                  description: |-
-                                    Key used to store the entry in the cache.
-                                    The resolved key must be unique within the scope of this particular config.
-                                  properties:
-                                    selector:
-                                      description: |-
-                                        Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                        Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                        The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                      type: string
-                                    value:
-                                      description: Static value
-                                      x-kubernetes-preserve-unknown-fields: true
-                                  type: object
-                                ttl:
-                                  default: 60
-                                  description: Duration (in seconds) of the external
-                                    data in the cache before pulled again from the
-                                    source.
-                                  type: integer
-                              required:
-                              - key
-                              type: object
-                            json:
-                              description: |-
-                                JSON object
-                                Specify it as the list of properties of the object, whose values can combine static values and values selected from the authorization JSON.
-                              properties:
-                                properties:
-                                  additionalProperties:
-                                    properties:
-                                      selector:
-                                        description: |-
-                                          Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                          Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                          The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                        type: string
-                                      value:
-                                        description: Static value
-                                        x-kubernetes-preserve-unknown-fields: true
-                                    type: object
-                                  type: object
-                              required:
-                              - properties
-                              type: object
-                            key:
-                              description: |-
-                                The key used to add the custom response item (name of the HTTP header or root property of the Dynamic Metadata object).
-                                If omitted, it will be set to the name of the response config.
-                              type: string
-                            metrics:
-                              default: false
-                              description: Whether this config should generate individual
-                                observability metrics
-                              type: boolean
-                            plain:
-                              description: Plain text content
-                              properties:
-                                selector:
-                                  description: |-
-                                    Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                    Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                    The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                  type: string
-                                value:
-                                  description: Static value
-                                  x-kubernetes-preserve-unknown-fields: true
-                              type: object
-                            priority:
-                              default: 0
-                              description: |-
-                                Priority group of the config.
-                                All configs in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially.
-                              type: integer
-                            when:
-                              description: |-
-                                Conditions for Authorino to enforce this config.
-                                If omitted, the config will be enforced for all requests.
-                                If present, all conditions must match for the config to be enforced; otherwise, the config will be skipped.
-                              items:
-                                properties:
-                                  all:
-                                    description: A list of pattern expressions to
-                                      be evaluated as a logical AND.
-                                    items:
-                                      type: object
-                                      x-kubernetes-preserve-unknown-fields: true
-                                    type: array
-                                  any:
-                                    description: A list of pattern expressions to
-                                      be evaluated as a logical OR.
-                                    items:
-                                      type: object
-                                      x-kubernetes-preserve-unknown-fields: true
-                                    type: array
-                                  operator:
-                                    description: |-
-                                      The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                                      Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                                    enum:
-                                    - eq
-                                    - neq
-                                    - incl
-                                    - excl
-                                    - matches
-                                    type: string
-                                  patternRef:
-                                    description: Reference to a named set of pattern
-                                      expressions
-                                    type: string
-                                  selector:
-                                    description: |-
-                                      Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                                      Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                      Authorino custom JSON path modifiers are also supported.
-                                    type: string
-                                  value:
-                                    description: |-
-                                      The value of reference for the comparison with the content fetched from the authorization JSON.
-                                      If used with the "matches" operator, the value must compile to a valid Golang regex.
-                                    type: string
-                                type: object
-                              type: array
-                            wristband:
-                              description: Authorino Festival Wristband token
-                              properties:
-                                customClaims:
-                                  additionalProperties:
-                                    properties:
-                                      selector:
-                                        description: |-
-                                          Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                          Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                          The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                                        type: string
-                                      value:
-                                        description: Static value
-                                        x-kubernetes-preserve-unknown-fields: true
-                                    type: object
-                                  description: Any claims to be added to the wristband
-                                    token apart from the standard JWT claims (iss,
-                                    iat, exp) added by default.
-                                  type: object
-                                issuer:
-                                  description: 'The endpoint to the Authorino service
-                                    that issues the wristband (format: <scheme>://<host>:<port>/<realm>,
-                                    where <realm> = <namespace>/<authorino-auth-config-resource-name/wristband-config-name)'
-                                  type: string
-                                signingKeyRefs:
-                                  description: |-
-                                    Reference by name to Kubernetes secrets and corresponding signing algorithms.
-                                    The secrets must contain a `key.pem` entry whose value is the signing key formatted as PEM.
-                                  items:
-                                    properties:
-                                      algorithm:
-                                        description: Algorithm to sign the wristband
-                                          token using the signing key provided
-                                        enum:
-                                        - ES256
-                                        - ES384
-                                        - ES512
-                                        - RS256
-                                        - RS384
-                                        - RS512
-                                        type: string
-                                      name:
-                                        description: |-
-                                          Name of the signing key.
-                                          The value is used to reference the Kubernetes secret that stores the key and in the `kid` claim of the wristband token header.
-                                        type: string
-                                    required:
-                                    - algorithm
-                                    - name
-                                    type: object
-                                  type: array
-                                tokenDuration:
-                                  description: Time span of the wristband token, in
-                                    seconds.
-                                  format: int64
-                                  type: integer
-                              required:
-                              - issuer
-                              - signingKeyRefs
-                              type: object
-                          type: object
-                        description: |-
-                          Custom success response items wrapped as HTTP headers.
-                          For integration of Authorino via proxy, the proxy must use these settings to inject data in the request.
-                        type: object
-                    type: object
-                  unauthenticated:
-                    description: |-
-                      Customizations on the denial status attributes when the request is unauthenticated.
-                      For integration of Authorino via proxy, the proxy must honour the response status attributes specified in this config.
-                      Default: 401 Unauthorized
-                    properties:
-                      body:
-                        description: HTTP response body to override the default denial
-                          body.
-                        properties:
-                          selector:
-                            description: |-
-                              Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                            type: string
-                          value:
-                            description: Static value
-                            x-kubernetes-preserve-unknown-fields: true
-                        type: object
-                      code:
-                        description: HTTP status code to override the default denial
-                          status code.
-                        format: int64
-                        maximum: 599
-                        minimum: 300
-                        type: integer
-                      headers:
-                        additionalProperties:
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        description: HTTP response headers to override the default
-                          denial headers.
-                        type: object
-                      message:
-                        description: HTTP message to override the default denial message.
-                        properties:
-                          selector:
-                            description: |-
-                              Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                            type: string
-                          value:
-                            description: Static value
-                            x-kubernetes-preserve-unknown-fields: true
-                        type: object
-                    type: object
-                  unauthorized:
-                    description: |-
-                      Customizations on the denial status attributes when the request is unauthorized.
-                      For integration of Authorino via proxy, the proxy must honour the response status attributes specified in this config.
-                      Default: 403 Forbidden
-                    properties:
-                      body:
-                        description: HTTP response body to override the default denial
-                          body.
-                        properties:
-                          selector:
-                            description: |-
-                              Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                            type: string
-                          value:
-                            description: Static value
-                            x-kubernetes-preserve-unknown-fields: true
-                        type: object
-                      code:
-                        description: HTTP status code to override the default denial
-                          status code.
-                        format: int64
-                        maximum: 599
-                        minimum: 300
-                        type: integer
-                      headers:
-                        additionalProperties:
-                          properties:
-                            selector:
-                              description: |-
-                                Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                                Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                                The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                              type: string
-                            value:
-                              description: Static value
-                              x-kubernetes-preserve-unknown-fields: true
-                          type: object
-                        description: HTTP response headers to override the default
-                          denial headers.
-                        type: object
-                      message:
-                        description: HTTP message to override the default denial message.
-                        properties:
-                          selector:
-                            description: |-
-                              Simple path selector to fetch content from the authorization JSON (e.g. 'request.method') or a string template with variables that resolve to patterns (e.g. "Hello, {auth.identity.name}!").
-                              Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                              The following Authorino custom modifiers are supported: @extract:{sep:" ",pos:0}, @replace{old:"",new:""}, @case:upper|lower, @base64:encode|decode and @strip.
-                            type: string
-                          value:
-                            description: Static value
-                            x-kubernetes-preserve-unknown-fields: true
-                        type: object
-                    type: object
-                type: object
-              when:
-                description: |-
-                  Overall conditions for the AuthConfig to be enforced.
-                  If omitted, the AuthConfig will be enforced at all requests.
-                  If present, all conditions must match for the AuthConfig to be enforced; otherwise, Authorino skips the AuthConfig and returns to the auth request with status OK.
-                items:
-                  properties:
-                    all:
-                      description: A list of pattern expressions to be evaluated as
-                        a logical AND.
-                      items:
-                        type: object
-                        x-kubernetes-preserve-unknown-fields: true
-                      type: array
-                    any:
-                      description: A list of pattern expressions to be evaluated as
-                        a logical OR.
-                      items:
-                        type: object
-                        x-kubernetes-preserve-unknown-fields: true
-                      type: array
-                    operator:
-                      description: |-
-                        The binary operator to be applied to the content fetched from the authorization JSON, for comparison with "value".
-                        Possible values are: "eq" (equal to), "neq" (not equal to), "incl" (includes; for arrays), "excl" (excludes; for arrays), "matches" (regex)
-                      enum:
-                      - eq
-                      - neq
-                      - incl
-                      - excl
-                      - matches
-                      type: string
-                    patternRef:
-                      description: Reference to a named set of pattern expressions
-                      type: string
-                    selector:
-                      description: |-
-                        Path selector to fetch content from the authorization JSON (e.g. 'request.method').
-                        Any pattern supported by https://pkg.go.dev/github.com/tidwall/gjson can be used.
-                        Authorino custom JSON path modifiers are also supported.
-                      type: string
-                    value:
-                      description: |-
-                        The value of reference for the comparison with the content fetched from the authorization JSON.
-                        If used with the "matches" operator, the value must compile to a valid Golang regex.
-                      type: string
-                  type: object
-                type: array
-            required:
-            - hosts
-            type: object
-          status:
-            description: AuthConfigStatus defines the observed state of AuthConfig
-            properties:
-              conditions:
-                items:
-                  properties:
-                    lastTransitionTime:
-                      description: Last time the condition transit from one status
-                        to another.
-                      format: date-time
-                      type: string
-                    lastUpdatedTime:
-                      description: Last time the condition was updated
-                      format: date-time
-                      type: string
-                    message:
-                      description: Human readable message indicating details about
-                        last transition.
-                      type: string
-                    reason:
-                      description: (brief) reason for the condition's last transition.
-                      type: string
-                    status:
-                      description: Status of the condition, one of True, False, Unknown.
-                      type: string
-                    type:
-                      description: Type of condition
-                      type: string
-                  required:
-                  - status
-                  - type
-                  type: object
-                type: array
-              summary:
-                properties:
-                  festivalWristbandEnabled:
-                    description: Indicator of whether the AuthConfig issues Festival
-                      Wristband tokens on successful evaluation of the AuthConfig
-                      (access granted)
-                    type: boolean
-                  hostsReady:
-                    description: Lists the hosts from spec.hosts linked to the resource
-                      in the index
-                    items:
-                      type: string
-                    type: array
-                  numAuthorizationPolicies:
-                    description: Number of authorization policies in the AuthConfig
-                    format: int64
-                    type: integer
-                  numHostsReady:
-                    description: Number of hosts from spec.hosts linked to the resource
-                      in the index, compared to the total number of hosts in spec.hosts
-                    type: string
-                  numIdentitySources:
-                    description: Number of trusted sources of identity for authentication
-                      in the AuthConfig
-                    format: int64
-                    type: integer
-                  numMetadataSources:
-                    description: Number of sources of external metadata in the AuthConfig
-                    format: int64
-                    type: integer
-                  numResponseItems:
-                    description: Number of custom authorization response items in
-                      the AuthConfig
-                    format: int64
-                    type: integer
-                  ready:
-                    description: Whether all hosts from spec.hosts have been linked
-                      to the resource in the index
-                    type: boolean
-                required:
-                - festivalWristbandEnabled
-                - hostsReady
-                - numAuthorizationPolicies
-                - numHostsReady
-                - numIdentitySources
-                - numMetadataSources
-                - numResponseItems
-                - ready
-                type: object
-            type: object
-        type: object
-    served: true
-    storage: true
-    subresources:
-      status: {}
diff --git a/0.10.0/authorino/install/crd/kustomization.yaml b/0.10.0/authorino/install/crd/kustomization.yaml
deleted file mode 100644
index 6eb9f8999..000000000
--- a/0.10.0/authorino/install/crd/kustomization.yaml
+++ /dev/null
@@ -1,18 +0,0 @@
-apiVersion: kustomize.config.k8s.io/v1beta1
-kind: Kustomization
-
-resources:
-- authorino.kuadrant.io_authconfigs.yaml
-# +kubebuilder:scaffold:crdkustomizeresource
-
-patchesStrategicMerge:
-- patches/webhook_in_authconfigs.yaml
-# +kubebuilder:scaffold:crdkustomizewebhookpatch
-
-patchesJson6902:
-- path: patches/oneof_in_authconfigs.yaml
-  target:
-    group: apiextensions.k8s.io
-    version: v1
-    kind: CustomResourceDefinition
-    name: authconfigs.authorino.kuadrant.io
diff --git a/0.10.0/authorino/install/crd/patches/oneof_in_authconfigs.yaml b/0.10.0/authorino/install/crd/patches/oneof_in_authconfigs.yaml
deleted file mode 100644
index 0334253e2..000000000
--- a/0.10.0/authorino/install/crd/patches/oneof_in_authconfigs.yaml
+++ /dev/null
@@ -1,415 +0,0 @@
-# Enables oneOf validation for the identity/authentication, metadata, authorization, and response fields.
-
-# v1beta1
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/identity/items/oneOf
-  value:
-    - properties:
-        name: {}
-        credentials: {}
-        oauth2: {}
-      required: [name, oauth2]
-    - properties:
-        name: {}
-        credentials: {}
-        oidc: {}
-      required: [name, oidc]
-    - properties:
-        name: {}
-        credentials: {}
-        apiKey: {}
-      required: [name, apiKey]
-    - properties:
-        name: {}
-        credentials: {}
-        mtls: {}
-      required: [name, mtls]
-    - properties:
-        name: {}
-        credentials: {}
-        kubernetes: {}
-      required: [name, kubernetes]
-    - properties:
-        name: {}
-        credentials: {}
-        anonymous: {}
-      required: [name, anonymous]
-    - properties:
-        name: {}
-        credentials: {}
-        plain: {}
-      required: [name, plain]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/metadata/items/oneOf
-  value:
-    - properties:
-        name: {}
-        userInfo: {}
-      required: [name, userInfo]
-    - properties:
-        name: {}
-        uma: {}
-      required: [name, uma]
-    - properties:
-        name: {}
-        http: {}
-      required: [name, http]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/authorization/items/oneOf
-  value:
-    - properties:
-        name: {}
-        opa: {}
-      required: [name, opa]
-    - properties:
-        name: {}
-        json: {}
-      required: [name, json]
-    - properties:
-        name: {}
-        kubernetes: {}
-      required: [name, kubernetes]
-    - properties:
-        name: {}
-        authzed: {}
-      required: [name, authzed]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/response/items/oneOf
-  value:
-    - properties:
-        name: {}
-        wristband: {}
-      required: [name, wristband]
-    - properties:
-        name: {}
-        json: {}
-      required: [name, json]
-    - properties:
-        name: {}
-        plain: {}
-      required: [name, plain]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/authorization/items/properties/json/properties/rules/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/identity/items/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/metadata/items/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/authorization/items/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/0/schema/openAPIV3Schema/properties/spec/properties/response/items/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-# v1beta2
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/authentication/additionalProperties/oneOf
-  value:
-    - properties:
-        credentials: {}
-        oauth2Introspection: {}
-      required: [oauth2Introspection]
-    - properties:
-        credentials: {}
-        jwt: {}
-      required: [jwt]
-    - properties:
-        credentials: {}
-        apiKey: {}
-      required: [apiKey]
-    - properties:
-        credentials: {}
-        x509: {}
-      required: [x509]
-    - properties:
-        credentials: {}
-        kubernetesTokenReview: {}
-      required: [kubernetesTokenReview]
-    - properties:
-        credentials: {}
-        anonymous: {}
-      required: [anonymous]
-    - properties:
-        credentials: {}
-        plain: {}
-      required: [plain]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/metadata/additionalProperties/oneOf
-  value:
-    - properties:
-        userInfo: {}
-      required: [userInfo]
-    - properties:
-        uma: {}
-      required: [uma]
-    - properties:
-        http: {}
-      required: [http]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/authorization/additionalProperties/oneOf
-  value:
-    - properties:
-        opa: {}
-      required: [opa]
-    - properties:
-        patternMatching: {}
-      required: [patternMatching]
-    - properties:
-        kubernetesSubjectAccessReview: {}
-      required: [kubernetesSubjectAccessReview]
-    - properties:
-        spicedb: {}
-      required: [spicedb]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/response/properties/success/properties/headers/additionalProperties/oneOf
-  value:
-    - properties:
-        wristband: {}
-      required: [wristband]
-    - properties:
-        json: {}
-      required: [json]
-    - properties:
-        plain: {}
-      required: [plain]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/response/properties/success/properties/dynamicMetadata/additionalProperties/oneOf
-  value:
-    - properties:
-        wristband: {}
-      required: [wristband]
-    - properties:
-        json: {}
-      required: [json]
-    - properties:
-        plain: {}
-      required: [plain]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/authorization/additionalProperties/properties/patternMatching/properties/patterns/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/authentication/additionalProperties/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/metadata/additionalProperties/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/authorization/additionalProperties/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/response/properties/success/properties/headers/additionalProperties/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
-
-- op: add
-  path: /spec/versions/1/schema/openAPIV3Schema/properties/spec/properties/response/properties/success/properties/dynamicMetadata/additionalProperties/properties/when/items/oneOf
-  value:
-    - properties:
-        patternRef: {}
-      required: [patternRef]
-    - properties:
-        operator: {}
-        selector: {}
-        value: {}
-      required: [operator, selector]
-    - properties:
-        all: {}
-      required: [all]
-    - properties:
-        any: {}
-      required: [any]
diff --git a/0.10.0/authorino/install/crd/patches/webhook_in_authconfigs.yaml b/0.10.0/authorino/install/crd/patches/webhook_in_authconfigs.yaml
deleted file mode 100644
index d4fc07923..000000000
--- a/0.10.0/authorino/install/crd/patches/webhook_in_authconfigs.yaml
+++ /dev/null
@@ -1,20 +0,0 @@
-# The following patch applies the default strategy to convert between versions of the CRD
-# The conversion webhook service is managed by the Authorino Operator
-apiVersion: apiextensions.k8s.io/v1
-kind: CustomResourceDefinition
-metadata:
-  name: authconfigs.authorino.kuadrant.io
-  annotations:
-    cert-manager.io/inject-ca-from: ${WEBHOOK_NAMESPACE}/authorino-webhook-server-cert
-spec:
-  conversion:
-    strategy: Webhook
-    webhook:
-      clientConfig:
-        service:
-          namespace: ${WEBHOOK_NAMESPACE}
-          name: authorino-webhooks
-          path: /convert
-      conversionReviewVersions:
-      - v1beta1
-      - v1beta2
diff --git a/0.10.0/dns-operator/config/samples/kuadrant.io_v1alpha1_dnsrecord.yaml b/0.10.0/dns-operator/config/samples/kuadrant.io_v1alpha1_dnsrecord.yaml
deleted file mode 100644
index 588aecff9..000000000
--- a/0.10.0/dns-operator/config/samples/kuadrant.io_v1alpha1_dnsrecord.yaml
+++ /dev/null
@@ -1,20 +0,0 @@
-apiVersion: kuadrant.io/v1alpha1
-kind: DNSRecord
-metadata:
-  labels:
-    app.kubernetes.io/name: dnsrecord
-    app.kubernetes.io/instance: dnsrecord-sample
-    app.kubernetes.io/part-of: dns-operator
-    app.kubernetes.io/managed-by: kustomize
-    app.kubernetes.io/created-by: dns-operator
-  name: dnsrecord-sample
-spec:
-  providerRef:
-    name: dns-provider-creds
-  endpoints:
-    - dnsName: dnsrecord-simple.example.com
-      recordTTL: 60
-      recordType: A
-      targets:
-        - 52.215.108.61
-        - 52.30.101.221
diff --git a/0.10.0/dns-operator/config/samples/kustomization.yaml b/0.10.0/dns-operator/config/samples/kustomization.yaml
deleted file mode 100644
index c65ac237d..000000000
--- a/0.10.0/dns-operator/config/samples/kustomization.yaml
+++ /dev/null
@@ -1,4 +0,0 @@
-## Append samples of your project ##
-resources:
-- kuadrant.io_v1alpha1_dnsrecord.yaml
-#+kubebuilder:scaffold:manifestskustomizesamples
diff --git a/0.10.0/dns-operator/docs/RELEASE/index.html b/0.10.0/dns-operator/docs/RELEASE/index.html
deleted file mode 100644
index 6884bc641..000000000
--- a/0.10.0/dns-operator/docs/RELEASE/index.html
+++ /dev/null
@@ -1,3517 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/dns-operator/docs/RELEASE/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RELEASE - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#release" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RELEASE
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#release" class="md-nav__link">
-    <span class="md-ellipsis">
-      Release
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Release">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#new-majorminor-version" class="md-nav__link">
-    <span class="md-ellipsis">
-      New Major.Minor version
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#new-patch-version" class="md-nav__link">
-    <span class="md-ellipsis">
-      New Patch version
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#verify-olm-deployment" class="md-nav__link">
-    <span class="md-ellipsis">
-      Verify OLM Deployment
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#community-operator-index-catalogs" class="md-nav__link">
-    <span class="md-ellipsis">
-      Community Operator Index Catalogs
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/dns-operator/blob/main/docs/RELEASE.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>RELEASE</h1>
-
-<h2 id="release">Release<a class="headerlink" href="#release" title="Permanent link">&para;</a></h2>
-<h3 id="new-majorminor-version">New Major.Minor version<a class="headerlink" href="#new-majorminor-version" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Create a new minor release branch from the HEAD of main:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>checkout<span class="w"> </span>-b<span class="w"> </span>release-0.2
-</span></code></pre></div></li>
-<li>Run prepare release:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>prepare-release<span class="w"> </span><span class="nv">IMG_TAG</span><span class="o">=</span>release-0.2<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">0</span>.2.0-dev<span class="w"> </span><span class="nv">CHANNELS</span><span class="o">=</span>alpha<span class="w"> </span><span class="nv">REPLACES_VERSION</span><span class="o">=</span><span class="m">0</span>.1.0
-</span></code></pre></div></li>
-<li>Verify local changes, commit and push:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>git<span class="w"> </span>add<span class="w"> </span>.
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>git<span class="w"> </span>commit<span class="w"> </span>-m<span class="w"> </span><span class="s2">&quot;prepare-release: release-0.2&quot;</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>git<span class="w"> </span>push<span class="w"> </span>upstream<span class="w"> </span>release-0.2
-</span></code></pre></div></li>
-<li>
-<p>Verify that the build <a href="https://github.com/Kuadrant/dns-operator/actions/workflows/build-images.yaml">image workflow</a> is triggered and completes for the new branch</p>
-</li>
-<li>
-<p>Do any final testing and bug fixing against the release branch, see <a href="#verify-olm-deployment">Verify OLM Deployment</a></p>
-</li>
-<li>
-<p>Run prepare release for final version
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>make<span class="w"> </span>prepare-release<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">0</span>.2.0<span class="w"> </span><span class="nv">CHANNELS</span><span class="o">=</span>stable<span class="w"> </span><span class="nv">REPLACES_VERSION</span><span class="o">=</span><span class="m">0</span>.1.0
-</span></code></pre></div></p>
-</li>
-<li>Verify local changes, commit, push and tag:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>git<span class="w"> </span>add<span class="w"> </span>.
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>git<span class="w"> </span>commit<span class="w"> </span>-m<span class="w"> </span><span class="s2">&quot;prepare-release: v0.2.0&quot;</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>git<span class="w"> </span>tag<span class="w"> </span>v0.2.0
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>git<span class="w"> </span>push<span class="w"> </span>upstream<span class="w"> </span>release-0.2
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>git<span class="w"> </span>push<span class="w"> </span>upstream<span class="w"> </span>v0.2.0
-</span></code></pre></div></li>
-<li>
-<p>Verify that the build <a href="https://github.com/Kuadrant/dns-operator/actions/workflows/build-images.yaml">image workflow</a> is triggered and completes for the new tag</p>
-</li>
-<li>
-<p>Verify the new version can be installed from the catalog image, see <a href="#verify-olm-deployment">Verify OLM Deployment</a></p>
-</li>
-<li>
-<p>Release to the <a href="#community-operator-index-catalogs">community operator index catalogs</a>.</p>
-</li>
-</ol>
-<h3 id="new-patch-version">New Patch version<a class="headerlink" href="#new-patch-version" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Checkout minor release branch:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>git<span class="w"> </span>checkout<span class="w"> </span>release-0.2
-</span></code></pre></div></li>
-<li>Run prepare release:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>make<span class="w"> </span>prepare-release<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">0</span>.2.1<span class="w"> </span><span class="nv">CHANNELS</span><span class="o">=</span>stable<span class="w"> </span><span class="nv">REPLACES_VERSION</span><span class="o">=</span><span class="m">0</span>.2.0
-</span></code></pre></div></li>
-<li>Verify local changes, commit and push:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>git<span class="w"> </span>add<span class="w"> </span>.
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>git<span class="w"> </span>commit<span class="w"> </span>-m<span class="w"> </span><span class="s2">&quot;prepare-release: v0.2.1&quot;</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>git<span class="w"> </span>tag<span class="w"> </span>v0.2.1
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>git<span class="w"> </span>push<span class="w"> </span>upstream<span class="w"> </span>release-0.2
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a>git<span class="w"> </span>push<span class="w"> </span>upstream<span class="w"> </span>v0.2.1
-</span></code></pre></div></li>
-<li>
-<p>Verify that the build <a href="https://github.com/Kuadrant/dns-operator/actions/workflows/build-images.yaml">image workflow</a> is triggered and completes for the new tag</p>
-</li>
-<li>
-<p>Verify the new version can be installed from the catalog image, see <a href="#verify-olm-deployment">Verify OLM Deployment</a></p>
-</li>
-<li>
-<p>Release to the <a href="#community-operator-index-catalogs">community operator index catalogs</a>.</p>
-</li>
-</ol>
-<h3 id="verify-olm-deployment">Verify OLM Deployment<a class="headerlink" href="#verify-olm-deployment" title="Permanent link">&para;</a></h3>
-<ol>
-<li>
-<p>Deploy the OLM catalog image:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>make<span class="w"> </span>local-setup<span class="w"> </span>install-olm<span class="w"> </span>deploy-catalog
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Wait for deployment:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>dns-operator-system<span class="w"> </span><span class="nb">wait</span><span class="w"> </span>--timeout<span class="o">=</span>60s<span class="w"> </span>--for<span class="o">=</span><span class="nv">condition</span><span class="o">=</span>Available<span class="w"> </span>deployments<span class="w"> </span>--all
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>deployment.apps/dns-operator-controller-manager<span class="w"> </span>condition<span class="w"> </span>met
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Check the logs:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>dns-operator-system<span class="w"> </span>logs<span class="w"> </span>-f<span class="w"> </span>deployment/dns-operator-controller-manager
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Check the version:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>$<span class="w"> </span>kubectl<span class="w"> </span>-n<span class="w"> </span>dns-operator-system<span class="w"> </span>get<span class="w"> </span>deployment<span class="w"> </span>dns-operator-controller-manager<span class="w"> </span>--show-labels
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>NAME<span class="w">                              </span>READY<span class="w">   </span>UP-TO-DATE<span class="w">   </span>AVAILABLE<span class="w">   </span>AGE<span class="w">     </span>LABELS
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a>dns-operator-controller-manager<span class="w">   </span><span class="m">1</span>/1<span class="w">     </span><span class="m">1</span><span class="w">            </span><span class="m">1</span><span class="w">           </span>5m42s<span class="w">   </span>app.kubernetes.io/component<span class="o">=</span>manager,app.kubernetes.io/created-by<span class="o">=</span>dns-operator,
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a>app.kubernetes.io/instance<span class="o">=</span>controller-manager,app.kubernetes.io/managed-by<span class="o">=</span>kustomize,app.kubernetes.io/name<span class="o">=</span>deployment,app.kubernetes.io/part-of<span class="o">=</span>dns-operator,
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a>control-plane<span class="o">=</span>dns-operator-controller-manager,olm.deployment-spec-hash<span class="o">=</span>1jPe8AuMpSKHh51nnDs4j25ZgoUrKhF45EP0Wa,olm.managed<span class="o">=</span>true,olm.owner.kind<span class="o">=</span>ClusterServiceVersion,
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a>olm.owner.namespace<span class="o">=</span>dns-operator-system,olm.owner<span class="o">=</span>dns-operator.v0.2.0-dev,operators.coreos.com/dns-operator.dns-operator-system<span class="o">=</span>
-</span></code></pre></div></p>
-</li>
-</ol>
-<h3 id="community-operator-index-catalogs">Community Operator Index Catalogs<a class="headerlink" href="#community-operator-index-catalogs" title="Permanent link">&para;</a></h3>
-<ul>
-<li><a href="https://github.com/k8s-operatorhub/community-operators/tree/main/operators/dns-operator">Operatorhub Community Operators</a></li>
-<li><a href="https://github.com/redhat-openshift-ecosystem/community-operators-prod/tree/main/operators/dns-operator">Openshift Community Operators</a></li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/index.html b/0.10.0/dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/index.html
deleted file mode 100644
index e03576611..000000000
--- a/0.10.0/dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/index.html
+++ /dev/null
@@ -1,3389 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>List of issues - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#list-of-issues" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              List of issues
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/dns-operator/blob/main/docs/RFC/distributed-dns/dnsrecord-lifecycle.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="list-of-issues">List of issues<a class="headerlink" href="#list-of-issues" title="Permanent link">&para;</a></h1>
-<ul>
-<li><a href="https://github.com/Kuadrant/dns-operator/issues/36">Re-queue validation intermittently GH-36</a></li>
-<li><a href="https://github.com/Kuadrant/dns-operator/issues/35">Re-queue DNS Record whenever a write to the Cloud Provider occurs GH-35</a></li>
-<li><a href="https://github.com/Kuadrant/dns-operator/issues/38">Schedule removal of finalizer from DNS Records GH-38</a></li>
-<li><a href="https://github.com/Kuadrant/dns-operator/issues/34">Record write attempts in status for current generation GH-34</a></li>
-</ul>
-<h1 id="the-idea">The idea<a class="headerlink" href="#the-idea" title="Permanent link">&para;</a></h1>
-<p>We now will constantly reconcile DNS records. The reasoning is that other controllers may override/change records in the DNS provider so there is a need to requeue the DNS Record from time to time even when no local changes are introduced.</p>
-<h1 id="details">Details<a class="headerlink" href="#details" title="Permanent link">&para;</a></h1>
-<p>There are a few new fields on the DNS Record status:</p>
-<ul>
-<li>QueuedAt is a time when the DNS record was received for the reconciliation</li>
-<li>QueuedFor is a time when we expect a DNS record to be reconciled again</li>
-<li>ValidFor indicates the duration since the last reconciliation we consider data in the record to be valid</li>
-<li>WriteCounter represents a number of consecutive write attempts on the same generation of the record. It is being reset to 0 when the generation changes or there are no changes to write.</li>
-</ul>
-<p>There is an option to override the <code>ValidFor</code> and <code>DefaultRequeueTime</code> with <code>valid-for</code> and <code>requeue-time</code> flags respectively.</p>
-<p>The <code>DefaultRequeueTime</code> is the duration between successful validation and the next reconciliation to ensure that the record is still up-to-date.</p>
-<p>The <code>ValidFor</code> is used to determine if we should do a full reconciliation when we get the record. If the record is still valid we will only update finalizers and validate the record itself. It will not perform anything that involves a DNS provider.</p>
-<h2 id="dns-record-normal-lifecycle">DNS Record normal lifecycle<a class="headerlink" href="#dns-record-normal-lifecycle" title="Permanent link">&para;</a></h2>
-<p>Once we enqueue the DNS record, controller will compile a list of changes to the DNS provider and will apply it. After this, the record is enqueued with the <code>validationRequeueTime</code> and the <code>Ready</code> condition will be marked as <code>false</code> with a message <code>Awaiting Validation</code>. When the record is received again and the controller ensures there are no changes needed (the ones applied are present in the DNS Provider) it sets the <code>Ready</code> condition to <code>true</code> and enqueues it with the <code>defaultRequeueTime</code>.</p>
-<p>At any time when the record is requeued we also set the <code>record.Status.QueuedFor</code> field with a timestamp for when we expect to receive the record again. And on every reconciliation we set the <code>record.Status.QueuedAt</code> to be the time of the reconciliation.</p>
-<p>Upon deletion, the process will be similar. The controller will determine the changes needed to the DNS provider and will apply them. The record will be requeued with the <code>validationRequeueTime</code>. Once we receive it back and ensure that there are no changes needed for the DNS provider we remove the finalizer from the record.</p>
-<p>The <code>validationRequeueTime</code> duration is randomized +/- 50%.</p>
-<h2 id="when-things-go-south">When things go south<a class="headerlink" href="#when-things-go-south" title="Permanent link">&para;</a></h2>
-<p>If the record is received prematurely - the <code>ValidFor</code> + <code>QueuedAt</code> is more than the current time - we requeue it again for the <code>ValidFor</code> duration.</p>
-<p>When we encounter an error during the reconciliation we will not requeue the record and will put in an appropriate error message in the log and on the record. In order for it to reconcile again there must be a change to the DNS Record CR.</p>
-<p>It is possible for a user to mess with the timestamps field or the <code>ValidFor</code> field. Kubernetes will not let setting an invalid value to the timestamp fields. Once the timestamp fields are set manually it will trigger reconciliation since there is a change in the record CR. The only one that could impact the controller is the <code>QueuedAt</code> field and the controller will believe that to be the last time the record was reconciled. As for the <code>ValidFor</code>: since it is a simple string it is possible to set an incorrect value. If we fail to parse it we treat the <code>ValidFor</code> as 0. This means that the controller will believe that the information in the record is expired and will probe the DNS provider for an update. If a valid value is provided controller will obey it. Eventually, the controller will naturally enqueue the record and those values will be overridden.</p>
-<p>In case the controller fails to retain changes in the DNS Provider: write are successful, but the validation fails again and the <code>WriteCounter</code> reaches the <code>WriteCounterLimit</code> we give up on the reconciliation. The appropriate message will be put under the <code>Ready - false</code> condition as well as in the logs of the controller. The reconciliation will resume once the generation of the DNS Record is changed.</p>
-<h2 id="metrics">Metrics<a class="headerlink" href="#metrics" title="Permanent link">&para;</a></h2>
-<p>There is a metric emitted from the controller: <code>dns_provider_write_counter</code>. It reflects the <code>WriteCounter</code> field in the status of the record.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/dns-operator/docs/provider/index.html b/0.10.0/dns-operator/docs/provider/index.html
deleted file mode 100644
index f17e06223..000000000
--- a/0.10.0/dns-operator/docs/provider/index.html
+++ /dev/null
@@ -1,3617 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/dns-operator/docs/provider/">
-      
-      
-        <link rel="prev" href="../../../kuadrant-operator/doc/dnshealthchecks/">
-      
-      
-        <link rel="next" href="../../../kuadrant-operator/doc/user-guides/gateway-tls/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>DNS Providers - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#configuring-a-dns-provider" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              DNS Providers
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#supported-providers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Supported Providers
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Supported Providers">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#aws-route-53-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS Route 53 Provider
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AWS Route 53 Provider">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#aws-iam-permissions-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS IAM Permissions Required
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#google-cloud-dns-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      Google Cloud DNS Provider
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Google Cloud DNS Provider">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#google-cloud-dns-access-permissions-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Google Cloud DNS Access permissions required
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#supported-providers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Supported Providers
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Supported Providers">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#aws-route-53-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS Route 53 Provider
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AWS Route 53 Provider">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#aws-iam-permissions-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS IAM Permissions Required
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#google-cloud-dns-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      Google Cloud DNS Provider
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Google Cloud DNS Provider">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#google-cloud-dns-access-permissions-required" class="md-nav__link">
-    <span class="md-ellipsis">
-      Google Cloud DNS Access permissions required
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/dns-operator/blob/main/docs/provider.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="configuring-a-dns-provider">Configuring a DNS Provider<a class="headerlink" href="#configuring-a-dns-provider" title="Permanent link">&para;</a></h1>
-<p>In order to be able to interact with supported DNS providers, Kuadrant needs a credential that it can use.</p>
-<h2 id="supported-providers">Supported Providers<a class="headerlink" href="#supported-providers" title="Permanent link">&para;</a></h2>
-<p>Kuadrant Supports the following DNS providers currently</p>
-<ul>
-<li>AWS Route 53 (AWS)</li>
-<li>Google Cloud DNS (GCP)</li>
-</ul>
-<h3 id="aws-route-53-provider">AWS Route 53 Provider<a class="headerlink" href="#aws-route-53-provider" title="Permanent link">&para;</a></h3>
-<p>Kuadrant expects a <code>Secret</code> with a credential. Below is an example for AWS Route 53. It is important to set the secret type to <code>aws</code>:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>my-aws-credentials<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">  </span>--namespace<span class="o">=</span>kuadrant-dns-system<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">  </span>--type<span class="o">=</span>kuadrant.io/aws<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span>XXXX<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_REGION</span><span class="o">=</span>eu-west-1<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span>XXX
-</span></code></pre></div>
-<table>
-<thead>
-<tr>
-<th>Key</th>
-<th>Example Value</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>AWS_REGION</code></td>
-<td><code>eu-west-1</code></td>
-<td>AWS Region</td>
-</tr>
-<tr>
-<td><code>AWS_ACCESS_KEY_ID</code></td>
-<td><code>XXXX</code></td>
-<td>AWS Access Key ID (see note on permissions below)</td>
-</tr>
-<tr>
-<td><code>AWS_SECRET_ACCESS_KEY</code></td>
-<td><code>XXXX</code></td>
-<td>AWS Secret Access Key</td>
-</tr>
-</tbody>
-</table>
-<h4 id="aws-iam-permissions-required">AWS IAM Permissions Required<a class="headerlink" href="#aws-iam-permissions-required" title="Permanent link">&para;</a></h4>
-<p>We have tested using the available policy <code>AmazonRoute53FullAccess</code> however it should also be possible to restrict the credential down to a particular zone. More info can be found in the AWS docs:</p>
-<p><a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/access-control-managing-permissions.html">https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/access-control-managing-permissions.html</a></p>
-<h3 id="google-cloud-dns-provider">Google Cloud DNS Provider<a class="headerlink" href="#google-cloud-dns-provider" title="Permanent link">&para;</a></h3>
-<p>Kuadant expects a secret with a credential. Below is an example for Google DNS. It is important to set the secret type to <code>gcp</code>:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>my-test-gcp-credentials<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w">  </span>--namespace<span class="o">=</span>kuadrant-dns-system<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w">  </span>--type<span class="o">=</span>kuadrant.io/gcp<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">PROJECT_ID</span><span class="o">=</span>xxx<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">  </span>--from-file<span class="o">=</span><span class="nv">GOOGLE</span><span class="o">=</span><span class="nv">$HOME</span>/.config/gcloud/application_default_credentials.json
-</span></code></pre></div>
-<table>
-<thead>
-<tr>
-<th>Env Var</th>
-<th>Example Value</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>GOOGLE</code></td>
-<td><code>{"client_id": "***","client_secret": "***","refresh_token": "***","type": "authorized_user"}</code></td>
-<td>This is the JSON created from either the credential created by the <code>gcloud</code> CLI, or the JSON from the Service account</td>
-</tr>
-<tr>
-<td><code>PROJECT_ID</code></td>
-<td><code>my_project_id</code></td>
-<td>ID to the Google project</td>
-</tr>
-</tbody>
-</table>
-<h4 id="google-cloud-dns-access-permissions-required">Google Cloud DNS Access permissions required<a class="headerlink" href="#google-cloud-dns-access-permissions-required" title="Permanent link">&para;</a></h4>
-<p>See: </p>
-<p><a href="https://cloud.google.com/dns/docs/access-control#dns.admin">https://cloud.google.com/dns/docs/access-control#dns.admin</a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/dns-operator/docs/reference/dnsrecord/index.html b/0.10.0/dns-operator/docs/reference/dnsrecord/index.html
deleted file mode 100644
index 7c418181a..000000000
--- a/0.10.0/dns-operator/docs/reference/dnsrecord/index.html
+++ /dev/null
@@ -1,3674 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/dns-operator/docs/reference/dnsrecord/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>The DNSRecord Custom Resource Definition (CRD) - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#the-dnsrecord-custom-resource-definition-crd" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              The DNSRecord Custom Resource Definition (CRD)
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#dnsrecord" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSRecord
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#dnsrecordspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSRecordSpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#providerref" class="md-nav__link">
-    <span class="md-ellipsis">
-      ProviderRef
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#healthcheckspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      HealthCheckSpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#dnsrecordstatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSRecordStatus
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#healthcheckstatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      HealthCheckStatus
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#healthcheckstatusprobe" class="md-nav__link">
-    <span class="md-ellipsis">
-      HealthCheckStatusProbe
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/dns-operator/blob/main/docs/reference/dnsrecord.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="the-dnsrecord-custom-resource-definition-crd">The DNSRecord Custom Resource Definition (CRD)<a class="headerlink" href="#the-dnsrecord-custom-resource-definition-crd" title="Permanent link">&para;</a></h1>
-<ul>
-<li><a href="#DNSRecord">DNSRecord</a></li>
-<li><a href="#dnsrecordspec">DNSRecordSpec</a></li>
-<li><a href="#dnsrecordstatus">DNSRecordStatus</a></li>
-</ul>
-<h2 id="dnsrecord">DNSRecord<a class="headerlink" href="#dnsrecord" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>spec</code></td>
-<td><a href="#dnsrecordspec">DNSRecordSpec</a></td>
-<td style="text-align: center;">Yes</td>
-<td>The specification for DNSRecord custom resource</td>
-</tr>
-<tr>
-<td><code>status</code></td>
-<td><a href="#dnsrecordstatus">DNSRecordStatus</a></td>
-<td style="text-align: center;">No</td>
-<td>The status for the custom resource</td>
-</tr>
-</tbody>
-</table>
-<h2 id="dnsrecordspec">DNSRecordSpec<a class="headerlink" href="#dnsrecordspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>ownerID</code></td>
-<td>String</td>
-<td style="text-align: center;">No</td>
-<td>Unique string used to identify the owner of this record. If unset an ownerID will be generated based on the record UID</td>
-</tr>
-<tr>
-<td><code>rootHost</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Single root host of all endpoints in a DNSRecord</td>
-</tr>
-<tr>
-<td><code>providerRef</code></td>
-<td><a href="#providerRef">ProviderRef</a></td>
-<td style="text-align: center;">Yes</td>
-<td>Reference to a DNS Provider Secret</td>
-</tr>
-<tr>
-<td><code>endpoints</code></td>
-<td>[]<a href="https://pkg.go.dev/sigs.k8s.io/external-dns/endpoint#Endpoint">ExternalDNS Endpoint</a></td>
-<td style="text-align: center;">No</td>
-<td>Endpoints to manage in the dns provider</td>
-</tr>
-<tr>
-<td><code>healthCheck</code></td>
-<td><a href="#healthcheckspec">HealthCheckSpec</a></td>
-<td style="text-align: center;">No</td>
-<td>Health check configuration</td>
-</tr>
-</tbody>
-</table>
-<h2 id="providerref">ProviderRef<a class="headerlink" href="#providerref" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>name</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Name of a dns provider secret</td>
-</tr>
-</tbody>
-</table>
-<h2 id="healthcheckspec">HealthCheckSpec<a class="headerlink" href="#healthcheckspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>endpoint</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Endpoint is the path to append to the host to reach the expected health check</td>
-</tr>
-<tr>
-<td><code>port</code></td>
-<td>Number</td>
-<td style="text-align: center;">Yes</td>
-<td>Port to connect to the host on</td>
-</tr>
-<tr>
-<td><code>protocol</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Protocol to use when connecting to the host, valid values are "HTTP" or "HTTPS"</td>
-</tr>
-<tr>
-<td><code>failureThreshold</code></td>
-<td>Number</td>
-<td style="text-align: center;">Yes</td>
-<td>FailureThreshold is a limit of consecutive failures that must occur for a host to be considered unhealthy</td>
-</tr>
-</tbody>
-</table>
-<h2 id="dnsrecordstatus">DNSRecordStatus<a class="headerlink" href="#dnsrecordstatus" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>observedGeneration</code></td>
-<td>String</td>
-<td>Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec</td>
-</tr>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Condition">Kubernetes meta/v1.Condition</a></td>
-<td>List of conditions that define the status of the resource</td>
-</tr>
-<tr>
-<td><code>queuedAt</code></td>
-<td><a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Time">Kubernetes meta/v1.Time</a></td>
-<td>QueuedAt is a time when DNS record was received for the reconciliation</td>
-</tr>
-<tr>
-<td><code>queuedFor</code></td>
-<td><a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Time">Kubernetes meta/v1.Time</a></td>
-<td>QueuedFor is a time when we expect a DNS record to be reconciled again</td>
-</tr>
-<tr>
-<td><code>validFor</code></td>
-<td>String</td>
-<td>ValidFor indicates duration since the last reconciliation we consider data in the record to be valid</td>
-</tr>
-<tr>
-<td><code>writeCounter</code></td>
-<td>Number</td>
-<td>WriteCounter represent a number of consecutive write attempts on the same generation of the record</td>
-</tr>
-<tr>
-<td><code>endpoints</code></td>
-<td>[]<a href="https://pkg.go.dev/sigs.k8s.io/external-dns/endpoint#Endpoint">ExternalDNS Endpoint</a></td>
-<td>Endpoints are the last endpoints that were successfully published by the provider</td>
-</tr>
-<tr>
-<td><code>healthCheck</code></td>
-<td><a href="#healthcheckstatus">HealthCheckStatus</a></td>
-<td>Health check status</td>
-</tr>
-<tr>
-<td><code>ownerID</code></td>
-<td>String</td>
-<td>Unique string used to identify the owner of this record</td>
-</tr>
-</tbody>
-</table>
-<h2 id="healthcheckstatus">HealthCheckStatus<a class="headerlink" href="#healthcheckstatus" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Condition">Kubernetes meta/v1.Condition</a></td>
-<td>List of conditions that define that status of the health checks</td>
-</tr>
-<tr>
-<td><code>probes</code></td>
-<td>[]<a href="#healthcheckstatusprobe">HealthCheckStatusProbe</a></td>
-<td>Health check Probe status</td>
-</tr>
-</tbody>
-</table>
-<h2 id="healthcheckstatusprobe">HealthCheckStatusProbe<a class="headerlink" href="#healthcheckstatusprobe" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>id</code></td>
-<td>String</td>
-<td>The health check id</td>
-</tr>
-<tr>
-<td><code>ipAddress</code></td>
-<td>String</td>
-<td>The ip address being monitored</td>
-</tr>
-<tr>
-<td><code>host</code></td>
-<td>String</td>
-<td>The host being monitored</td>
-</tr>
-<tr>
-<td><code>synced</code></td>
-<td>Boolean</td>
-<td>Synced</td>
-</tr>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Condition">Kubernetes meta/v1.Condition</a></td>
-<td>List of conditions that define that status of the probe</td>
-</tr>
-</tbody>
-</table>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/dns-operator/index.html b/0.10.0/dns-operator/index.html
deleted file mode 100644
index 7b3e68514..000000000
--- a/0.10.0/dns-operator/index.html
+++ /dev/null
@@ -1,3697 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/dns-operator/">
-      
-      
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>DNS Operator - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#dns-operator" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              DNS Operator
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting Started
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Getting Started">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#pre-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pre Setup
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Pre Setup">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#add-dns-provider-configuration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Add DNS provider configuration
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Add DNS provider configuration">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#aws-provider-route53" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS Provider (Route53)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#gcp-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      GCP Provider
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#azure-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      AZURE Provider
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#running-controller-locally-default" class="md-nav__link">
-    <span class="md-ellipsis">
-      Running controller locally (default)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#running-controller-on-the-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Running controller on the cluster
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#running-controller-on-existing-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Running controller on existing cluster
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#development" class="md-nav__link">
-    <span class="md-ellipsis">
-      Development
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Development">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#e2e-test-suite" class="md-nav__link">
-    <span class="md-ellipsis">
-      E2E Test Suite
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#modifying-the-api-definitions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Modifying the API definitions
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#logging" class="md-nav__link">
-    <span class="md-ellipsis">
-      Logging
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Logging">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#common-metadata" class="md-nav__link">
-    <span class="md-ellipsis">
-      Common metadata
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#license" class="md-nav__link">
-    <span class="md-ellipsis">
-      License
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/dns-operator/blob/main/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="dns-operator">DNS Operator<a class="headerlink" href="#dns-operator" title="Permanent link">&para;</a></h1>
-<p><a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Fdns-operator?ref=badge_shield"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Fdns-operator.svg?type=shield" /></a></p>
-<p>The DNS Operator is a kubernetes based controller responsible for reconciling DNS Record custom resources. It interfaces with cloud DNS providers such as AWS and Google to bring the DNS zone into the state declared in these CRDs.
-One of the key use cases the DNS operator solves, is allowing complex DNS routing strategies such as Geo and Weighted to be expressed allowing you to leverage DNS as the first layer of traffic management. In order to make these strategies valuable, it also works across multiple clusters allowing you to use a shared domain name balance traffic based on your requirements.</p>
-<h2 id="getting-started">Getting Started<a class="headerlink" href="#getting-started" title="Permanent link">&para;</a></h2>
-<h3 id="pre-setup">Pre Setup<a class="headerlink" href="#pre-setup" title="Permanent link">&para;</a></h3>
-<h4 id="add-dns-provider-configuration">Add DNS provider configuration<a class="headerlink" href="#add-dns-provider-configuration" title="Permanent link">&para;</a></h4>
-<p><strong>NOTE:</strong> You can optionally skip this step but at least one DNS Provider Secret will need to be configured with valid credentials to use the DNS Operator.</p>
-<h5 id="aws-provider-route53">AWS Provider (Route53)<a class="headerlink" href="#aws-provider-route53" title="Permanent link">&para;</a></h5>
-<p><div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>make<span class="w"> </span>local-setup-aws-clean<span class="w"> </span>local-setup-aws-generate<span class="w"> </span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span>&lt;My<span class="w"> </span>AWS<span class="w"> </span>ACCESS<span class="w"> </span>KEY&gt;<span class="w"> </span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span>&lt;My<span class="w"> </span>AWS<span class="w"> </span>Secret<span class="w"> </span>Access<span class="w"> </span>Key&gt;
-</span></code></pre></div>
-More details about the AWS provider can be found <a href="docs/provider/#aws-route-53-provider">here</a></p>
-<h5 id="gcp-provider">GCP Provider<a class="headerlink" href="#gcp-provider" title="Permanent link">&para;</a></h5>
-<p><div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-setup-gcp-clean<span class="w"> </span>local-setup-gcp-generate<span class="w"> </span><span class="nv">GCP_GOOGLE_CREDENTIALS</span><span class="o">=</span><span class="s1">&#39;&lt;My GCP Credentials.json&gt;&#39;</span><span class="w"> </span><span class="nv">GCP_PROJECT_ID</span><span class="o">=</span>&lt;My<span class="w"> </span>GCP<span class="w"> </span>PROJECT<span class="w"> </span>ID&gt;
-</span></code></pre></div>
-More details about the GCP provider can be found <a href="docs/provider/#google-cloud-dns-provider">here</a></p>
-<h5 id="azure-provider">AZURE Provider<a class="headerlink" href="#azure-provider" title="Permanent link">&para;</a></h5>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>make<span class="w"> </span>local-setup-azure-clean<span class="w"> </span>local-setup-azure-generate<span class="w"> </span><span class="nv">KUADRANT_AZURE_CREDENTIALS</span><span class="o">=</span><span class="s1">&#39;&lt;My Azure Credentials.json&gt;&#39;</span>
-</span></code></pre></div>
-<p>Info on generating service principal credentials <a href="https://github.com/kubernetes-sigs/external-dns/blob/master/docs/tutorials/azure.md">here</a></p>
-<p>Get your resource group ID like so:
-<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>az group show --resource-group &lt;resource group name&gt; | jq &quot;.id&quot; -r
-</span></code></pre></div></p>
-<p>Also give traffic manager contributor role:
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>az role assignment create --role &quot;Traffic Manager Contributor&quot; --assignee $EXTERNALDNS_SP_APP_ID --scope &lt;RESOURCE_GROUP_ID&gt;
-</span></code></pre></div></p>
-<p>Getting the zone ID can be achieved using the below command:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>az<span class="w"> </span>network<span class="w"> </span>dns<span class="w"> </span>zone<span class="w"> </span>show<span class="w"> </span>--name<span class="w"> </span>&lt;my<span class="w"> </span>domain<span class="w"> </span>name&gt;<span class="w"> </span>--resource-group<span class="w"> </span>&lt;my<span class="w"> </span>resource<span class="w"> </span>group&gt;<span class="w"> </span>--query<span class="w"> </span><span class="s2">&quot;{id:id,domain:name}&quot;</span>
-</span></code></pre></div></p>
-<h3 id="running-controller-locally-default">Running controller locally (default)<a class="headerlink" href="#running-controller-locally-default" title="Permanent link">&para;</a></h3>
-<ol>
-<li>
-<p>Create local environment(creates kind cluster)
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Run your controller (this will run in the foreground, so switch to a new terminal if you want to leave it running):</p>
-</li>
-</ol>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>make<span class="w"> </span>run
-</span></code></pre></div>
-<h3 id="running-controller-on-the-cluster">Running controller on the cluster<a class="headerlink" href="#running-controller-on-the-cluster" title="Permanent link">&para;</a></h3>
-<ol>
-<li>
-<p>Create local environment(creates kind cluster)
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>make<span class="w"> </span>local-setup<span class="w"> </span><span class="nv">DEPLOY</span><span class="o">=</span><span class="nb">true</span>
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Verify controller deployment
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>logs<span class="w"> </span>-f<span class="w"> </span>deployments/dns-operator-controller-manager<span class="w"> </span>-n<span class="w"> </span>dns-operator-system
-</span></code></pre></div></p>
-</li>
-</ol>
-<h3 id="running-controller-on-existing-cluster">Running controller on existing cluster<a class="headerlink" href="#running-controller-on-existing-cluster" title="Permanent link">&para;</a></h3>
-<p>You’ll need a Kubernetes cluster to run against. You can use <a href="https://sigs.k8s.io/kind">KIND</a> to get a local cluster for testing, or run against a remote cluster.
-<strong>Note:</strong> Your controller will automatically use the current context in your kubeconfig file (i.e. whatever cluster <code>kubectl cluster-info</code> shows).</p>
-<ol>
-<li>
-<p>Apply Operator manifests
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kustomize<span class="w"> </span>build<span class="w"> </span>config/default<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Verify controller deployment
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>logs<span class="w"> </span>-f<span class="w"> </span>deployments/dns-operator-controller-manager<span class="w"> </span>-n<span class="w"> </span>dns-operator-system
-</span></code></pre></div></p>
-</li>
-</ol>
-<h2 id="development">Development<a class="headerlink" href="#development" title="Permanent link">&para;</a></h2>
-<h3 id="e2e-test-suite">E2E Test Suite<a class="headerlink" href="#e2e-test-suite" title="Permanent link">&para;</a></h3>
-<p>The e2e test suite can be executed against any cluster running the DNS Operator with configuration added for any supported provider.</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>make test-e2e TEST_DNS_ZONE_DOMAIN_NAME=&lt;My domain name&gt; TEST_DNS_PROVIDER_SECRET_NAME=&lt;My provider secret name&gt; TEST_DNS_NAMESPACES=&lt;My test namespace(s)&gt;
-</span></code></pre></div>
-<table>
-<thead>
-<tr>
-<th>Environment Variable</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>TEST_DNS_PROVIDER_SECRET_NAME</td>
-<td>Name of the provider secret to use. If using local-setup provider secrets zones, one of [dns-provider-credentials-aws; dns-provider-credentials-gcp;dns-provider-credentials-azure]</td>
-</tr>
-<tr>
-<td>TEST_DNS_ZONE_DOMAIN_NAME</td>
-<td>The Domain name to use in the test. Must be a zone accessible with the (TEST_DNS_PROVIDER_SECRET_NAME) credentials with the same domain name</td>
-</tr>
-<tr>
-<td>TEST_DNS_NAMESPACES</td>
-<td>The namespace(s) where the provider secret(s) can be found</td>
-</tr>
-</tbody>
-</table>
-<h3 id="modifying-the-api-definitions">Modifying the API definitions<a class="headerlink" href="#modifying-the-api-definitions" title="Permanent link">&para;</a></h3>
-<p>If you are editing the API definitions, generate the manifests such as CRs or CRDs using:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>make<span class="w"> </span>manifests
-</span></code></pre></div>
-<p><strong>NOTE:</strong> Run <code>make --help</code> for more information on all potential <code>make</code> targets</p>
-<p>More information can be found via the <a href="https://book.kubebuilder.io/introduction.html">Kubebuilder Documentation</a></p>
-<h2 id="logging">Logging<a class="headerlink" href="#logging" title="Permanent link">&para;</a></h2>
-<p>Logs are following the general guidelines: </p>
-<ul>
-<li><code>logger.Info()</code> describe a high-level state of the resource such as creation, deletion and which reconciliation path was taken.  </li>
-<li><code>logger.Error()</code> describe only those errors that are not returned in the result of the reconciliation. If error is occurred there should be only one error message. </li>
-<li><code>logger.V(1).Info()</code> debug level logs to give information about every change or event caused by the resource as well as every update of the resource.</li>
-</ul>
-<p>The <code>--zap-devel</code> argument will enable debug level logs for the output. Otherwise, all <code>V()</code> logs are ignored.</p>
-<h3 id="common-metadata">Common metadata<a class="headerlink" href="#common-metadata" title="Permanent link">&para;</a></h3>
-<p>Not exhaustive list of metadata for DNSRecord controller:</p>
-<ul>
-<li><code>level</code> - logging level. Values are: <code>info</code>,<code>debug</code> or <code>error</code></li>
-<li><code>ts</code> - timestamp</li>
-<li><code>logger</code> - logger name</li>
-<li><code>msg</code></li>
-<li><code>controller</code> and <code>controllerKind</code> - controller name, and it's kind respectively to output the log</li>
-<li><code>DNSRecord</code> - name and namespace of the DNS Record CR that is being reconciled</li>
-<li><code>reconcileID</code></li>
-<li><code>ownerID</code> - ID the of owner of the DNS Record </li>
-<li><code>txtPrefix</code>/<code>txtSuffix</code> - prefix and suffix of the TXT record in provider. </li>
-<li><code>zoneEndpoints</code> - endpoints that exist in the provider</li>
-<li><code>specEdnoinds</code> - endpoints defined in the spec</li>
-<li><code>statusEndpoints</code> - endpoints that were processed previously</li>
-</ul>
-<blockquote>
-<p>Note that not all the metadata values are present at each of the logs statements. </p>
-</blockquote>
-<h3 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent link">&para;</a></h3>
-<p>To query logs locally you can use <code>jq</code>. For example:
-Retrieve logs by 
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>deployments<span class="w"> </span>-l<span class="w"> </span>app.kubernetes.io/part-of<span class="o">=</span>dns-operator<span class="w"> </span>-A
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>NAMESPACE<span class="w">             </span>NAME<span class="w">                              </span>READY<span class="w"> </span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a>dns-operator-system<span class="w">   </span>dns-operator-controller-manager<span class="w">   </span><span class="m">1</span>/1<span class="w">   </span>
-</span></code></pre></div>
-And query them. For example:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>logs<span class="w"> </span>-l<span class="w"> </span>control-plane<span class="o">=</span>dns-operator-controller-manager<span class="w"> </span>-n<span class="w"> </span>dns-operator-system<span class="w"> </span>--tail<span class="w"> </span>-1<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span><span class="s1">&#39;/^{/!d&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span><span class="s1">&#39;select(.controller==&quot;dnsrecord&quot; and .level==&quot;info&quot;)&#39;</span>
-</span></code></pre></div>
-or 
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>logs<span class="w"> </span>-l<span class="w"> </span>control-plane<span class="o">=</span>dns-operator-controller-manager<span class="w"> </span>-n<span class="w"> </span>dns-operator-system<span class="w"> </span>--tail<span class="w"> </span>-1<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span><span class="s1">&#39;/^{/!d&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span><span class="s1">&#39;select(.controller==&quot;dnsrecord&quot; and .DNSRecord.name==&quot;test&quot; and .reconcileID==&quot;2be16b6d-b90f-430e-9996-8b5ec4855d53&quot;)&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span><span class="s1">&#39;.level, .msg, .zoneEndpoints, .specEndpoints, .statusEndpoints &#39;</span>
-</span></code></pre></div>
-You could use selector in the <code>jq</code> with <code>and</code>/<code>not</code>/<code>or</code> to restrict.</p>
-<h2 id="license">License<a class="headerlink" href="#license" title="Permanent link">&para;</a></h2>
-<p>Copyright 2024.</p>
-<p>Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at</p>
-<div class="language-text highlight"><pre><span></span><code>http://www.apache.org/licenses/LICENSE-2.0
-</code></pre></div>
-<p>Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.</p>
-<p><a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Fdns-operator?ref=badge_large"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Fdns-operator.svg?type=large" /></a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/getting-started-multi-cluster/index.html b/0.10.0/getting-started-multi-cluster/index.html
deleted file mode 100644
index 56760c305..000000000
--- a/0.10.0/getting-started-multi-cluster/index.html
+++ /dev/null
@@ -1,3571 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/getting-started-multi-cluster/">
-      
-      
-        <link rel="prev" href="../getting-started-single-cluster/">
-      
-      
-        <link rel="next" href="../architecture/docs/design/architectural-overview-v1/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Multi-Cluster - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-getting-started-multi-cluster" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Multi-Cluster
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrant-getting-started-multi-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Getting Started - Multi Cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Overview">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#environmental-variables" class="md-nav__link">
-    <span class="md-ellipsis">
-      Environmental Variables
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-up-a-kind-cluster-and-install-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set Up a kind cluster and install Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clean-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean Up
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#whats-next" class="md-nav__link">
-    <span class="md-ellipsis">
-      What's Next
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrant-getting-started-multi-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Getting Started - Multi Cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Overview">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#environmental-variables" class="md-nav__link">
-    <span class="md-ellipsis">
-      Environmental Variables
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-up-a-kind-cluster-and-install-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set Up a kind cluster and install Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clean-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean Up
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#whats-next" class="md-nav__link">
-    <span class="md-ellipsis">
-      What's Next
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/docs.kuadrant.io/edit/main/docs/getting-started-multi-cluster.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Multi-Cluster</h1>
-
-<h2 id="kuadrant-getting-started-multi-cluster">Kuadrant Getting Started - Multi Cluster<a class="headerlink" href="#kuadrant-getting-started-multi-cluster" title="Permanent link">&para;</a></h2>
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>In this quick start, we will cover the setup of Kuadrant in multiple local kind clusters.
-This document is intended as a follow on to the single cluster guide.
-It can be used for adding 1 or more clusters to your local setup.</p>
-<h3 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h3>
-<ul>
-<li>Completed the <a href="../getting-started-single-cluster/">Single-cluster Quick Start</a></li>
-</ul>
-<h3 id="environmental-variables">Environmental Variables<a class="headerlink" href="#environmental-variables" title="Permanent link">&para;</a></h3>
-<p>The same environment variable requirements from the <a href="../getting-started-single-cluster/">Single-cluster Quick Start</a> apply to this document,
-including the <code>KUADRANT_REF</code> variable.</p>
-<h3 id="set-up-a-kind-cluster-and-install-kuadrant">Set Up a kind cluster and install Kuadrant<a class="headerlink" href="#set-up-a-kind-cluster-and-install-kuadrant" title="Permanent link">&para;</a></h3>
-<p>Run the same quickstart script from the single cluster quick start:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>curl<span class="w"> </span><span class="s2">&quot;https://raw.githubusercontent.com/kuadrant/kuadrant-operator/</span><span class="si">${</span><span class="nv">KUADRANT_REF</span><span class="si">}</span><span class="s2">/hack/quickstart-setup.sh&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>bash
-</span></code></pre></div>
-<p>The script will detect if you already have a cluster from the single cluster setup running, and prompt you for a multi cluster setup.
-This will setup an additional kind cluster, install Istio and install Kuadrant.
-You can re-run the script multiple times to add more clusters.
-Each cluster will have a number suffix in the name. For example: <code>kuadrant-local-1</code>, <code>kuadrant-local-2</code>, <code>kuadrant-local-3</code>.
-The original cluster from the single cluster setup will keep its name of just <code>kuadrant-local</code>.</p>
-<h3 id="clean-up">Clean Up<a class="headerlink" href="#clean-up" title="Permanent link">&para;</a></h3>
-<p>To ensure that any DNS records are removed, you should remove any <code>DNSPolicy</code> and <code>TLSPolicy</code> resources before deleting the local cluster.</p>
-<h3 id="whats-next">What's Next<a class="headerlink" href="#whats-next" title="Permanent link">&para;</a></h3>
-<p>The next step is to setup and use the policies provided by Kuadrant. </p>
-<p><a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/">Secure, Protect and Connect your Gateway</a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/getting-started-single-cluster/index.html b/0.10.0/getting-started-single-cluster/index.html
deleted file mode 100644
index 0eb6b2381..000000000
--- a/0.10.0/getting-started-single-cluster/index.html
+++ /dev/null
@@ -1,3742 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/getting-started-single-cluster/">
-      
-      
-        <link rel="prev" href="..">
-      
-      
-        <link rel="next" href="../getting-started-multi-cluster/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Single-Cluster - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-getting-started-single-cluster" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Single-Cluster
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrant-getting-started-single-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Getting Started - Single Cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Overview">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#environmental-variables" class="md-nav__link">
-    <span class="md-ellipsis">
-      Environmental Variables
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#general" class="md-nav__link">
-    <span class="md-ellipsis">
-      General
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#aws" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#gcp" class="md-nav__link">
-    <span class="md-ellipsis">
-      GCP
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-the-release-you-want-to-use" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the release you want to use
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-up-a-kind-cluster-and-install-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set Up a kind cluster and install Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clean-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean Up
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#whats-next" class="md-nav__link">
-    <span class="md-ellipsis">
-      What's Next
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrant-getting-started-single-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Getting Started - Single Cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Overview">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#environmental-variables" class="md-nav__link">
-    <span class="md-ellipsis">
-      Environmental Variables
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#general" class="md-nav__link">
-    <span class="md-ellipsis">
-      General
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#aws" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#gcp" class="md-nav__link">
-    <span class="md-ellipsis">
-      GCP
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-the-release-you-want-to-use" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the release you want to use
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-up-a-kind-cluster-and-install-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set Up a kind cluster and install Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clean-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean Up
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#whats-next" class="md-nav__link">
-    <span class="md-ellipsis">
-      What's Next
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/docs.kuadrant.io/edit/main/docs/getting-started-single-cluster.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Single-Cluster</h1>
-
-<h2 id="kuadrant-getting-started-single-cluster">Kuadrant Getting Started - Single Cluster<a class="headerlink" href="#kuadrant-getting-started-single-cluster" title="Permanent link">&para;</a></h2>
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>In this quick start, we will cover: </p>
-<ul>
-<li>setup of Kuadrant in a singe local kind cluster</li>
-</ul>
-<h3 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h3>
-<ul>
-<li><a href="https://docs.docker.com/engine/install/">Docker</a></li>
-<li><a href="https://kind.sigs.k8s.io/">Kind</a></li>
-<li><a href="https://kubernetes.io/docs/tasks/tools/">Kubectl</a></li>
-<li>OpenSSL &gt;= 3</li>
-<li>AWS account with Route 53 enabled or GCP with Cloud DNS enabled</li>
-<li><a href="https://github.com/chipmk/docker-mac-net-connect">Docker Mac Net Connect</a> (macOS users only)</li>
-</ul>
-<h3 id="environmental-variables">Environmental Variables<a class="headerlink" href="#environmental-variables" title="Permanent link">&para;</a></h3>
-<h3 id="general">General<a class="headerlink" href="#general" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>Env Var</th>
-<th>Example Value</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>ISTIO_INSTALL_SAIL</code></td>
-<td><code>true</code></td>
-<td>Whether to install istio through project sail, default <code>false</code></td>
-</tr>
-</tbody>
-</table>
-<p>If you want to make use of the Kuadrant <code>DNSPolicy</code> you should setup the following environmental variables depending on your DNS Provider:</p>
-<h3 id="aws">AWS<a class="headerlink" href="#aws" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>Env Var</th>
-<th>Example Value</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>KUADRANT_ZONE_ROOT_DOMAIN</code></td>
-<td><code>jbloggs.hcpapps.net</code></td>
-<td>Hostname for the root Domain</td>
-</tr>
-<tr>
-<td><code>KUADRANT_AWS_DNS_PUBLIC_ZONE_ID</code></td>
-<td><code>Z01234567US0IQE3YLO00</code></td>
-<td>AWS Route 53 Zone ID for specified <code>KUADRANT_ZONE_ROOT_DOMAIN</code></td>
-</tr>
-<tr>
-<td><code>KUADRANT_AWS_ACCESS_KEY_ID</code></td>
-<td><code>AKIA1234567890000000</code></td>
-<td>Access Key ID, for user with permissions to Route 53 in the account where root domain is created</td>
-</tr>
-<tr>
-<td><code>KUADRANT_AWS_SECRET_ACCESS_KEY</code></td>
-<td><code>Z01234567US0000000</code></td>
-<td>Access Secret Access Key, for user with permissions to Route 53 in the account where root domain is created</td>
-</tr>
-<tr>
-<td><code>KUADRANT_AWS_REGION</code></td>
-<td><code>eu-west-1</code></td>
-<td>AWS Region</td>
-</tr>
-</tbody>
-</table>
-<h3 id="gcp">GCP<a class="headerlink" href="#gcp" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>Env Var</th>
-<th>Example Value</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>GOOGLE</code></td>
-<td><code>{"client_id": "00000000-00000000000000.apps.googleusercontent.com","client_secret": "d-FL95Q00000000000000","refresh_token": "00000aaaaa00000000-AAAAAAAAAAAAKFGJFJDFKDK","type": "authorized_user"}</code></td>
-<td>This is the JSON created from either the JSON credentials created by the Google Cloud CLI or a Service account</td>
-</tr>
-<tr>
-<td><code>PROJECT_ID</code></td>
-<td><code>my_project_id</code></td>
-<td>ID to the google project</td>
-</tr>
-<tr>
-<td><code>ZONE_NAME</code></td>
-<td><code>jbloggs-google</code></td>
-<td>Zone name</td>
-</tr>
-<tr>
-<td><code>ZONE_DNS_NAME</code></td>
-<td><code>jbloggs.google.hcpapps.net</code></td>
-<td>DNS name</td>
-</tr>
-<tr>
-<td><code>LOG_LEVEL</code></td>
-<td><code>1</code></td>
-<td>Log level for the Controller</td>
-</tr>
-</tbody>
-</table>
-<blockquote>
-<p>Alternatively, to set defaults, add the above environment variables to your <code>.zshrc</code> or <code>.bash_profile</code>.</p>
-</blockquote>
-<h3 id="set-the-release-you-want-to-use">Set the release you want to use<a class="headerlink" href="#set-the-release-you-want-to-use" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">KUADRANT_REF</span><span class="o">=</span>v0.10.0
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ISTIO_INSTALL_SAIL</span><span class="o">=</span><span class="nb">true</span>
-</span></code></pre></div>
-<h3 id="set-up-a-kind-cluster-and-install-kuadrant">Set Up a kind cluster and install Kuadrant<a class="headerlink" href="#set-up-a-kind-cluster-and-install-kuadrant" title="Permanent link">&para;</a></h3>
-<p>Run the following:</p>
-<p><div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span><span class="s2">&quot;https://raw.githubusercontent.com/kuadrant/kuadrant-operator/</span><span class="si">${</span><span class="nv">KUADRANT_REF</span><span class="si">}</span><span class="s2">/hack/quickstart-setup.sh&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>bash
-</span></code></pre></div>
-This will setup a single kind cluster, install Istio and install Kuadrant. Once this completes you should be able to move on to using the various policy apis offered by Kuadrant.</p>
-<h3 id="clean-up">Clean Up<a class="headerlink" href="#clean-up" title="Permanent link">&para;</a></h3>
-<p>To ensure that any DNS records are removed, you should remove any <code>DNSPolicy</code> and <code>TLSPolicy</code> resources before deleting the local cluster.</p>
-<h3 id="whats-next">What's Next<a class="headerlink" href="#whats-next" title="Permanent link">&para;</a></h3>
-<p>The next step is to setup and use the policies provided by Kuadrant. </p>
-<p><a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/">Secure, Protect and Connect your Gateway</a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/index.html b/0.10.0/index.html
deleted file mode 100644
index 554de23c8..000000000
--- a/0.10.0/index.html
+++ /dev/null
@@ -1,3432 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/">
-      
-      
-      
-        <link rel="next" href="getting-started-single-cluster/">
-      
-      
-      <link rel="icon" href="assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL(".",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#overview" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="." class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting Started
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting Started
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/docs.kuadrant.io/edit/main/docs/index.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h1>
-<p>Kuadrant combines <a href="https://gateway-api.sigs.k8s.io/">Gateway API</a> and <a href="https://istio.io/latest/docs/tasks/traffic-management/ingress/gateway-api/">Istio</a>-based gateway controllers to enhance application connectivity. It enables platform engineers and application developers to easily connect, secure, and protect their services and infrastructure across multiple clusters with policies for <a href="kuadrant-operator/doc/tls/">TLS</a>, <a href="kuadrant-operator/doc/reference/dnspolicy/">DNS</a>, application <a href="kuadrant-operator/doc/auth/">authentication &amp; authorization</a>, and <a href="kuadrant-operator/doc/rate-limiting/">rate limiting</a>. Additionally, Kuadrant offers <a href="kuadrant-operator/doc/observability/examples/">observability templates</a> to further support infrastructure management.</p>
-<iframe width="100%" height="400" src="https://www.youtube.com/embed/euWAMvQojP4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
-
-<h2 id="getting-started">Getting Started<a class="headerlink" href="#getting-started" title="Permanent link">&para;</a></h2>
-<p>For a quick local setup of Kuadrant, see our <a href="getting-started-single-cluster/">Single Cluster</a> or <a href="getting-started-multi-cluster/">Multi Cluster</a> guides.
-Explore the single and multi-cluster architecture in our <a href="architecture/docs/design/architectural-overview-v1/">Architectural Overview</a>.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="./assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": ".", "features": ["content.action.edit", "content.code.copy"], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1alpha1_dnspolicy.yaml b/0.10.0/kuadrant-operator/config/samples/kuadrant_v1alpha1_dnspolicy.yaml
deleted file mode 100644
index 10dc274ce..000000000
--- a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1alpha1_dnspolicy.yaml
+++ /dev/null
@@ -1,13 +0,0 @@
----
-apiVersion: kuadrant.io/v1alpha1
-kind: DNSPolicy
-metadata:
-  name: dnspolicy-sample
-spec:
-  targetRef:
-    name: example-gateway
-    group: gateway.networking.k8s.io
-    kind: Gateway
-  healthCheck:
-    endpoint: /
-    protocol: HTTP
diff --git a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1alpha1_tlspolicy.yaml b/0.10.0/kuadrant-operator/config/samples/kuadrant_v1alpha1_tlspolicy.yaml
deleted file mode 100644
index 89dc838d0..000000000
--- a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1alpha1_tlspolicy.yaml
+++ /dev/null
@@ -1,14 +0,0 @@
----
-apiVersion: kuadrant.io/v1alpha1
-kind: TLSPolicy
-metadata:
-  name: tlspolicy-sample
-spec:
-  targetRef:
-    name: example-gateway
-    group: gateway.networking.k8s.io
-    kind: Gateway
-  issuerRef:
-    group: cert-manager.io
-    kind: ClusterIssuer
-    name: self-signed-ca
diff --git a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta1_kuadrant.yaml b/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta1_kuadrant.yaml
deleted file mode 100644
index 29de2d9a1..000000000
--- a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta1_kuadrant.yaml
+++ /dev/null
@@ -1,6 +0,0 @@
----
-apiVersion: kuadrant.io/v1beta1
-kind: Kuadrant
-metadata:
-  name: kuadrant-sample
-spec: {}
diff --git a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta2_authpolicy.yaml b/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta2_authpolicy.yaml
deleted file mode 100644
index 23954bbd9..000000000
--- a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta2_authpolicy.yaml
+++ /dev/null
@@ -1,18 +0,0 @@
----
-apiVersion: kuadrant.io/v1beta2
-kind: AuthPolicy
-metadata:
-  name: toystore
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: toystore
-  rules:
-    authentication:
-      "apikey":
-        apiKey:
-          selector: {}
-      credentials:
-        authorizationHeader:
-          prefix: APIKEY
diff --git a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta2_ratelimitpolicy.yaml b/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta2_ratelimitpolicy.yaml
deleted file mode 100644
index 6fa97658a..000000000
--- a/0.10.0/kuadrant-operator/config/samples/kuadrant_v1beta2_ratelimitpolicy.yaml
+++ /dev/null
@@ -1,16 +0,0 @@
----
-apiVersion: kuadrant.io/v1beta2
-kind: RateLimitPolicy
-metadata:
-  name: toystore
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: toystore
-  limits:
-    toys:
-      rates:
-      - limit: 50
-        duration: 1
-        unit: minute
diff --git a/0.10.0/kuadrant-operator/config/samples/kustomization.yaml b/0.10.0/kuadrant-operator/config/samples/kustomization.yaml
deleted file mode 100644
index da3dca9b6..000000000
--- a/0.10.0/kuadrant-operator/config/samples/kustomization.yaml
+++ /dev/null
@@ -1,8 +0,0 @@
-## Append samples you want in your CSV to this file as resources ##
-resources:
-- kuadrant_v1beta1_kuadrant.yaml
-- kuadrant_v1beta2_authpolicy.yaml
-- kuadrant_v1beta2_ratelimitpolicy.yaml
-- kuadrant_v1alpha1_dnspolicy.yaml
-- kuadrant_v1alpha1_tlspolicy.yaml
-#+kubebuilder:scaffold:manifestskustomizesamples
diff --git a/0.10.0/kuadrant-operator/doc/auth/index.html b/0.10.0/kuadrant-operator/doc/auth/index.html
deleted file mode 100644
index e8b103aa1..000000000
--- a/0.10.0/kuadrant-operator/doc/auth/index.html
+++ /dev/null
@@ -1,4210 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/auth/">
-      
-      
-        <link rel="prev" href="../reference/tlspolicy/">
-      
-      
-        <link rel="next" href="../reference/authpolicy/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-auth" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How it works">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#envoys-external-authorization-protocol" class="md-nav__link">
-    <span class="md-ellipsis">
-      Envoy's External Authorization Protocol
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#the-authpolicy-custom-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      The AuthPolicy custom resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The AuthPolicy custom resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#high-level-example-and-field-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      High-level example and field definition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-the-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the AuthPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Using the AuthPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-httproute-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a HTTPRoute networking resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Targeting a HTTPRoute networking resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#hostnames-and-wildcards" class="md-nav__link">
-    <span class="md-ellipsis">
-      Hostnames and wildcards
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-gateway-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a Gateway networking resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Targeting a Gateway networking resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overlapping-gateway-and-httproute-authpolicies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overlapping Gateway and HTTPRoute AuthPolicies
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#route-selectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Route selectors
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Route selectors">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#when-conditions" class="md-nav__link">
-    <span class="md-ellipsis">
-      when conditions
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#known-limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Known limitations
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Known limitations">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitation-multiple-network-resources-with-identical-hostnames" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitation: Multiple network resources with identical hostnames
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#implementation-details" class="md-nav__link">
-    <span class="md-ellipsis">
-      Implementation details
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Implementation details">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#internal-custom-resources-and-namespaces" class="md-nav__link">
-    <span class="md-ellipsis">
-      Internal custom resources and namespaces
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How it works">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#envoys-external-authorization-protocol" class="md-nav__link">
-    <span class="md-ellipsis">
-      Envoy's External Authorization Protocol
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#the-authpolicy-custom-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      The AuthPolicy custom resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The AuthPolicy custom resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#high-level-example-and-field-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      High-level example and field definition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-the-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the AuthPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Using the AuthPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-httproute-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a HTTPRoute networking resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Targeting a HTTPRoute networking resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#hostnames-and-wildcards" class="md-nav__link">
-    <span class="md-ellipsis">
-      Hostnames and wildcards
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-gateway-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a Gateway networking resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Targeting a Gateway networking resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overlapping-gateway-and-httproute-authpolicies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overlapping Gateway and HTTPRoute AuthPolicies
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#route-selectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Route selectors
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Route selectors">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#when-conditions" class="md-nav__link">
-    <span class="md-ellipsis">
-      when conditions
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#known-limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Known limitations
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Known limitations">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitation-multiple-network-resources-with-identical-hostnames" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitation: Multiple network resources with identical hostnames
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#implementation-details" class="md-nav__link">
-    <span class="md-ellipsis">
-      Implementation details
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Implementation details">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#internal-custom-resources-and-namespaces" class="md-nav__link">
-    <span class="md-ellipsis">
-      Internal custom resources and namespaces
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/auth.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrant-auth">Kuadrant Auth<a class="headerlink" href="#kuadrant-auth" title="Permanent link">&para;</a></h1>
-<p>A Kuadrant AuthPolicy custom resource:</p>
-<ol>
-<li>Targets Gateway API networking resources such as <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.HTTPRoute">HTTPRoutes</a> and <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.Gateway">Gateways</a>, using these resources to obtain additional context, i.e., which traffic workload (HTTP attributes, hostnames, user attributes, etc) to enforce auth.</li>
-<li>Supports targeting subsets (sections) of a network resource to apply the auth rules to.</li>
-<li>Abstracts the details of the underlying external authorization protocol and configuration resources, that have a much broader remit and surface area.</li>
-<li>Enables cluster operators to set defaults that govern behavior at the lower levels of the network, until a more specific policy is applied.</li>
-</ol>
-<h2 id="how-it-works">How it works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h2>
-<h3 id="envoys-external-authorization-protocol">Envoy's External Authorization Protocol<a class="headerlink" href="#envoys-external-authorization-protocol" title="Permanent link">&para;</a></h3>
-<p>Kuadrant's Auth implementation relies on the Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/ext_authz_filter">External Authorization</a> protocol. The workflow per request goes:</p>
-<ol>
-<li>On incoming request, the gateway checks the matching rules for enforcing the auth rules, as stated in the AuthPolicy custom resources and targeted Gateway API networking objects</li>
-<li>If the request matches, the gateway sends one <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/auth/v3/external_auth.proto#envoy-v3-api-msg-service-auth-v3-checkrequest">CheckRequest</a> to the external auth service ("Authorino").</li>
-<li>The external auth service responds with a <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/auth/v3/external_auth.proto#service-auth-v3-checkresponse">CheckResponse</a> back to the gateway with either an <code>OK</code> or <code>DENIED</code> response code.</li>
-</ol>
-<p>An AuthPolicy and its targeted Gateway API networking resource contain all the statements to configure both the ingress gateway and the external auth service.</p>
-<h3 id="the-authpolicy-custom-resource">The AuthPolicy custom resource<a class="headerlink" href="#the-authpolicy-custom-resource" title="Permanent link">&para;</a></h3>
-<h4 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h4>
-<p>The <code>AuthPolicy</code> spec includes the following parts:</p>
-<ul>
-<li>A reference to an existing Gateway API resource (<code>spec.targetRef</code>)</li>
-<li>Authentication/authorization scheme (<code>spec.rules</code>)</li>
-<li>Top-level route selectors (<code>spec.routeSelectors</code>)</li>
-<li>Top-level additional conditions (<code>spec.when</code>)</li>
-<li>List of named patterns (<code>spec.patterns</code>)</li>
-</ul>
-<p>The auth scheme specify rules for:</p>
-<ul>
-<li>Authentication (<code>spec.rules.authentication</code>)</li>
-<li>External auth metadata fetching (<code>spec.rules.metadata</code>)</li>
-<li>Authorization (<code>spec.rules.authorization</code>)</li>
-<li>Custom response items (<code>spec.rules.response</code>)</li>
-<li>Callbacks (<code>spec.rules.callbacks</code>)</li>
-</ul>
-<p>Each auth rule can declare specific <code>routeSelectors</code> and <code>when</code> conditions for the rule to apply.</p>
-<p>The auth scheme (<code>rules</code>), as well as conditions and named patterns can be declared at the top-level level of the spec (with the semantics of <em>defaults</em>) or alternatively within explicit <code>defaults</code> or <code>overrides</code> blocks.</p>
-<h4 id="high-level-example-and-field-definition">High-level example and field definition<a class="headerlink" href="#high-level-example-and-field-definition" title="Permanent link">&para;</a></h4>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-auth-policy</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="c1"># Reference to an existing networking resource to attach the policy to. REQUIRED.</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="c1"># It can be a Gateway API HTTPRoute or Gateway resource.</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span><span class="c1"># It can only refer to objects in the same namespace as the AuthPolicy.</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute / Gateway</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myroute / mygateway</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">  </span><span class="c1"># Selectors of HTTPRouteRules within the targeted HTTPRoute that activate the AuthPolicy.</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">  </span><span class="c1"># Each element contains a HTTPRouteMatch object that will be used to select HTTPRouteRules that include at least</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">  </span><span class="c1"># one identical HTTPRouteMatch.</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">  </span><span class="c1"># The HTTPRouteMatch part does not have to be fully identical, but the what&#39;s stated in the selector must be</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">  </span><span class="c1"># identically stated in the HTTPRouteRule.</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">  </span><span class="c1"># Do not use it on AuthPolicies that target a Gateway.</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">  </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PathPrefix</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;/admin&quot;</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="w">  </span><span class="c1"># Additional dynamic conditions to trigger the AuthPolicy.</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="w">  </span><span class="c1"># Use it for filtering attributes not supported by HTTPRouteRule or with AuthPolicies that target a Gateway.</span>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="w">  </span><span class="c1"># Check out https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md to learn more</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="w">  </span><span class="c1"># about the Well-known Attributes that can be used in this field.</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="w">  </span><span class="c1"># Equivalent to if otherwise declared within `defaults`.</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="w">  </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a><span class="w">  </span><span class="c1"># Sets of common patterns of selector-operator-value triples, to be referred by name in `when` conditions</span>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a><span class="w">  </span><span class="c1"># and pattern-matching rules. Often employed to avoid repetition in the policy.</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a><span class="w">  </span><span class="c1"># Equivalent to if otherwise declared within `defaults`.</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a><span class="w">  </span><span class="nt">patterns</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a><span class="w">  </span><span class="c1"># The auth rules to apply to the network traffic routed through the targeted resource.</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a><span class="w">  </span><span class="c1"># Equivalent to if otherwise declared within `defaults`.</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a><span class="w">    </span><span class="c1"># Authentication rules to enforce.</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a><span class="w">    </span><span class="c1"># At least one config must evaluate to a valid identity object for the auth request to be successful.</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a><span class="w">    </span><span class="c1"># If omitted or empty, anonymous access is assumed.</span>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a><span class="w">    </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a><span class="w">      </span><span class="s">&quot;my-authn-rule&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a><span class="w">        </span><span class="c1"># The authentication method of this rule.</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a><span class="w">        </span><span class="c1"># One-of: apiKey, jwt, oauth2Introspection, kubernetesTokenReview, x509, plain, anonymous.</span>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49" href="#__codelineno-0-49"></a><span class="w">        </span><span class="nt">apiKey</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50" href="#__codelineno-0-50"></a>
-</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51" href="#__codelineno-0-51"></a><span class="w">        </span><span class="c1"># Where credentials are required to be passed in the request for authentication based on this rule.</span>
-</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52" href="#__codelineno-0-52"></a><span class="w">        </span><span class="c1"># One-of: authorizationHeader, customHeader, queryString, cookie.</span>
-</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53" href="#__codelineno-0-53"></a><span class="w">        </span><span class="nt">credentials</span><span class="p">:</span>
-</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54" href="#__codelineno-0-54"></a><span class="w">          </span><span class="nt">authorizationHeader</span><span class="p">:</span>
-</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55" href="#__codelineno-0-55"></a><span class="w">            </span><span class="nt">prefix</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">APIKEY</span>
-</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56" href="#__codelineno-0-56"></a>
-</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57" href="#__codelineno-0-57"></a><span class="w">        </span><span class="c1"># Rule-level route selectors.</span>
-</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58" href="#__codelineno-0-58"></a><span class="w">        </span><span class="nt">routeSelectors</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59" href="#__codelineno-0-59"></a>
-</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60" href="#__codelineno-0-60"></a><span class="w">        </span><span class="c1"># Rule-level additional conditions.</span>
-</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61" href="#__codelineno-0-61"></a><span class="w">        </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62" href="#__codelineno-0-62"></a>
-</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63" href="#__codelineno-0-63"></a><span class="w">        </span><span class="c1"># Configs for caching the resolved object returned out of evaluating this auth rule.</span>
-</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64" href="#__codelineno-0-64"></a><span class="w">        </span><span class="nt">cache</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65" href="#__codelineno-0-65"></a>
-</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66" href="#__codelineno-0-66"></a><span class="w">    </span><span class="c1"># Rules for fetching auth metadata from external sources.</span>
-</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67" href="#__codelineno-0-67"></a><span class="w">    </span><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68" href="#__codelineno-0-68"></a><span class="w">      </span><span class="s">&quot;my-external-source&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69" href="#__codelineno-0-69"></a><span class="w">        </span><span class="c1"># The method for fetching metadata from the external source.</span>
-</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70" href="#__codelineno-0-70"></a><span class="w">        </span><span class="c1"># One-of: http: userInfo, uma.</span>
-</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71" href="#__codelineno-0-71"></a><span class="w">        </span><span class="nt">http</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72" href="#__codelineno-0-72"></a>
-</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73" href="#__codelineno-0-73"></a><span class="w">    </span><span class="c1"># Authorization rules to enforce.</span>
-</span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74" href="#__codelineno-0-74"></a><span class="w">    </span><span class="c1"># All policies must allow access for the auth request be successful.</span>
-</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75" href="#__codelineno-0-75"></a><span class="w">    </span><span class="nt">authorization</span><span class="p">:</span>
-</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76" href="#__codelineno-0-76"></a><span class="w">      </span><span class="s">&quot;my-authz-rule&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77" href="#__codelineno-0-77"></a><span class="w">        </span><span class="c1"># The authorization method of this rule.</span>
-</span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78" href="#__codelineno-0-78"></a><span class="w">        </span><span class="c1"># One-of: patternMatching, opa, kubernetesSubjectAccessReview, spicedb.</span>
-</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79" href="#__codelineno-0-79"></a><span class="w">        </span><span class="nt">opa</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80" href="#__codelineno-0-80"></a>
-</span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81" href="#__codelineno-0-81"></a><span class="w">    </span><span class="c1"># Customizations to the authorization response.</span>
-</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82" href="#__codelineno-0-82"></a><span class="w">    </span><span class="nt">response</span><span class="p">:</span>
-</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83" href="#__codelineno-0-83"></a><span class="w">      </span><span class="c1"># Custom denial status and other HTTP attributes for unauthenticated requests.</span>
-</span><span id="__span-0-84"><a id="__codelineno-0-84" name="__codelineno-0-84" href="#__codelineno-0-84"></a><span class="w">      </span><span class="nt">unauthenticated</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85" href="#__codelineno-0-85"></a>
-</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86" href="#__codelineno-0-86"></a><span class="w">      </span><span class="c1"># Custom denial status and other HTTP attributes for unauhtorized requests.</span>
-</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87" href="#__codelineno-0-87"></a><span class="w">      </span><span class="nt">unauthorized</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88" href="#__codelineno-0-88"></a>
-</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89" href="#__codelineno-0-89"></a><span class="w">      </span><span class="c1"># Custom response items when access is granted.</span>
-</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90" href="#__codelineno-0-90"></a><span class="w">      </span><span class="nt">success</span><span class="p">:</span>
-</span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91" href="#__codelineno-0-91"></a><span class="w">        </span><span class="c1"># Custom response items wrapped as HTTP headers to be injected in the request</span>
-</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92" href="#__codelineno-0-92"></a><span class="w">        </span><span class="nt">headers</span><span class="p">:</span>
-</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93" href="#__codelineno-0-93"></a><span class="w">          </span><span class="s">&quot;my-custom-header&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94" href="#__codelineno-0-94"></a><span class="w">            </span><span class="c1"># One-of: plain, json, wristband.</span>
-</span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95" href="#__codelineno-0-95"></a><span class="w">            </span><span class="nt">plain</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-96"><a id="__codelineno-0-96" name="__codelineno-0-96" href="#__codelineno-0-96"></a>
-</span><span id="__span-0-97"><a id="__codelineno-0-97" name="__codelineno-0-97" href="#__codelineno-0-97"></a><span class="w">        </span><span class="c1"># Custom response items wrapped as envoy dynamic metadata.</span>
-</span><span id="__span-0-98"><a id="__codelineno-0-98" name="__codelineno-0-98" href="#__codelineno-0-98"></a><span class="w">        </span><span class="nt">dynamicMetadata</span><span class="p">:</span>
-</span><span id="__span-0-99"><a id="__codelineno-0-99" name="__codelineno-0-99" href="#__codelineno-0-99"></a><span class="w">          </span><span class="c1"># One-of: plain, json, wristband.</span>
-</span><span id="__span-0-100"><a id="__codelineno-0-100" name="__codelineno-0-100" href="#__codelineno-0-100"></a><span class="w">          </span><span class="s">&quot;my-custom-dyn-metadata&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-0-101"><a id="__codelineno-0-101" name="__codelineno-0-101" href="#__codelineno-0-101"></a><span class="w">            </span><span class="nt">json</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-102"><a id="__codelineno-0-102" name="__codelineno-0-102" href="#__codelineno-0-102"></a>
-</span><span id="__span-0-103"><a id="__codelineno-0-103" name="__codelineno-0-103" href="#__codelineno-0-103"></a><span class="w">    </span><span class="c1"># Rules for post-authorization callback requests to external services.</span>
-</span><span id="__span-0-104"><a id="__codelineno-0-104" name="__codelineno-0-104" href="#__codelineno-0-104"></a><span class="w">    </span><span class="c1"># Triggered regardless of the result of the authorization request.</span>
-</span><span id="__span-0-105"><a id="__codelineno-0-105" name="__codelineno-0-105" href="#__codelineno-0-105"></a><span class="w">    </span><span class="nt">callbacks</span><span class="p">:</span>
-</span><span id="__span-0-106"><a id="__codelineno-0-106" name="__codelineno-0-106" href="#__codelineno-0-106"></a><span class="w">      </span><span class="s">&quot;my-webhook&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-0-107"><a id="__codelineno-0-107" name="__codelineno-0-107" href="#__codelineno-0-107"></a><span class="w">        </span><span class="nt">http</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-108"><a id="__codelineno-0-108" name="__codelineno-0-108" href="#__codelineno-0-108"></a>
-</span><span id="__span-0-109"><a id="__codelineno-0-109" name="__codelineno-0-109" href="#__codelineno-0-109"></a><span class="w">    </span><span class="c1"># Explicit defaults. Used in policies that target a Gateway object to express default rules to be enforced on</span>
-</span><span id="__span-0-110"><a id="__codelineno-0-110" name="__codelineno-0-110" href="#__codelineno-0-110"></a><span class="w">    </span><span class="c1"># routes that lack a more specific policy attached to.</span>
-</span><span id="__span-0-111"><a id="__codelineno-0-111" name="__codelineno-0-111" href="#__codelineno-0-111"></a><span class="w">    </span><span class="c1"># Mutually exclusive with `overrides` and with declaring the `rules`, `when` and `patterns` at the top-level of</span>
-</span><span id="__span-0-112"><a id="__codelineno-0-112" name="__codelineno-0-112" href="#__codelineno-0-112"></a><span class="w">    </span><span class="c1"># the spec.</span>
-</span><span id="__span-0-113"><a id="__codelineno-0-113" name="__codelineno-0-113" href="#__codelineno-0-113"></a><span class="w">    </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-0-114"><a id="__codelineno-0-114" name="__codelineno-0-114" href="#__codelineno-0-114"></a><span class="w">      </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-0-115"><a id="__codelineno-0-115" name="__codelineno-0-115" href="#__codelineno-0-115"></a><span class="w">        </span><span class="nt">authentication</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-116"><a id="__codelineno-0-116" name="__codelineno-0-116" href="#__codelineno-0-116"></a><span class="w">        </span><span class="nt">metadata</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-117"><a id="__codelineno-0-117" name="__codelineno-0-117" href="#__codelineno-0-117"></a><span class="w">        </span><span class="nt">authorization</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-118"><a id="__codelineno-0-118" name="__codelineno-0-118" href="#__codelineno-0-118"></a><span class="w">        </span><span class="nt">response</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-119"><a id="__codelineno-0-119" name="__codelineno-0-119" href="#__codelineno-0-119"></a><span class="w">        </span><span class="nt">callbacks</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-120"><a id="__codelineno-0-120" name="__codelineno-0-120" href="#__codelineno-0-120"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-121"><a id="__codelineno-0-121" name="__codelineno-0-121" href="#__codelineno-0-121"></a><span class="w">      </span><span class="nt">patterns</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-122"><a id="__codelineno-0-122" name="__codelineno-0-122" href="#__codelineno-0-122"></a>
-</span><span id="__span-0-123"><a id="__codelineno-0-123" name="__codelineno-0-123" href="#__codelineno-0-123"></a><span class="w">    </span><span class="c1"># Overrides. Used in policies that target a Gateway object to be enforced on all routes linked to the gateway,</span>
-</span><span id="__span-0-124"><a id="__codelineno-0-124" name="__codelineno-0-124" href="#__codelineno-0-124"></a><span class="w">    </span><span class="c1"># thus also overriding any more specific policy occasionally attached to any of those routes.</span>
-</span><span id="__span-0-125"><a id="__codelineno-0-125" name="__codelineno-0-125" href="#__codelineno-0-125"></a><span class="w">    </span><span class="c1"># Mutually exclusive with `defaults` and with declaring `rules`, `when` and `patterns` at the top-level of</span>
-</span><span id="__span-0-126"><a id="__codelineno-0-126" name="__codelineno-0-126" href="#__codelineno-0-126"></a><span class="w">    </span><span class="c1"># the spec.</span>
-</span><span id="__span-0-127"><a id="__codelineno-0-127" name="__codelineno-0-127" href="#__codelineno-0-127"></a><span class="w">    </span><span class="nt">overrides</span><span class="p">:</span>
-</span><span id="__span-0-128"><a id="__codelineno-0-128" name="__codelineno-0-128" href="#__codelineno-0-128"></a><span class="w">      </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-0-129"><a id="__codelineno-0-129" name="__codelineno-0-129" href="#__codelineno-0-129"></a><span class="w">        </span><span class="nt">authentication</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-130"><a id="__codelineno-0-130" name="__codelineno-0-130" href="#__codelineno-0-130"></a><span class="w">        </span><span class="nt">metadata</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-131"><a id="__codelineno-0-131" name="__codelineno-0-131" href="#__codelineno-0-131"></a><span class="w">        </span><span class="nt">authorization</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-132"><a id="__codelineno-0-132" name="__codelineno-0-132" href="#__codelineno-0-132"></a><span class="w">        </span><span class="nt">response</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-133"><a id="__codelineno-0-133" name="__codelineno-0-133" href="#__codelineno-0-133"></a><span class="w">        </span><span class="nt">callbacks</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-134"><a id="__codelineno-0-134" name="__codelineno-0-134" href="#__codelineno-0-134"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-135"><a id="__codelineno-0-135" name="__codelineno-0-135" href="#__codelineno-0-135"></a><span class="w">      </span><span class="nt">patterns</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<p>Check out the <a href="../reference/authpolicy/">API reference</a> for a full specification of the AuthPolicy CRD.</p>
-<h2 id="using-the-authpolicy">Using the AuthPolicy<a class="headerlink" href="#using-the-authpolicy" title="Permanent link">&para;</a></h2>
-<h3 id="targeting-a-httproute-networking-resource">Targeting a HTTPRoute networking resource<a class="headerlink" href="#targeting-a-httproute-networking-resource" title="Permanent link">&para;</a></h3>
-<p>When an AuthPolicy targets a HTTPRoute, the policy is enforced to all traffic routed according to the rules and hostnames specified in the HTTPRoute, across all Gateways referenced in the <code>spec.parentRefs</code> field of the HTTPRoute.</p>
-<p>The targeted HTTPRoute's rules and/or hostnames to which the policy must be enforced can be filtered to specific subsets, by specifying the <a href="../reference/route-selectors/#the-routeselectors-field"><code>routeSelectors</code></a> field of the AuthPolicy spec.</p>
-<p>Target a HTTPRoute by setting the <code>spec.targetRef</code> field of the AuthPolicy as follows:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-route-auth</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;HTTPRoute Name&gt;</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>┌───────────────────┐             ┌────────────────────┐
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>│ (Infra namespace) │             │   (App namespace)  │
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>│                   │             │                    │
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a>│  ┌─────────┐      │  parentRefs │  ┌───────────┐     │
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>│  │ Gateway │◄─────┼─────────────┼──┤ HTTPRoute │     │
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a>│  └─────────┘      │             │  └───────────┘     │
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a>│                   │             │        ▲           │
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a>│                   │             │        │           │
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>│                   │             │        │           │
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a>│                   │             │        │ targetRef │
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a>│                   │             │        │           │
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a>│                   │             │  ┌─────┴──────┐    │
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a>│                   │             │  │ AuthPolicy │    │
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a>│                   │             │  └────────────┘    │
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a>│                   │             │                    │
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a>└───────────────────┘             └────────────────────┘
-</span></code></pre></div>
-<h4 id="hostnames-and-wildcards">Hostnames and wildcards<a class="headerlink" href="#hostnames-and-wildcards" title="Permanent link">&para;</a></h4>
-<p>If an AuthPolicy targets a route defined for <code>*.com</code> and another AuthPolicy targets another route for <code>api.com</code>, the Kuadrant control plane will not merge these two AuthPolicies. Rather, it will mimic the behavior of gateway implementation by which the "most specific hostname wins", thus enforcing only the corresponding applicable policies and auth rules.</p>
-<p>E.g., a request coming for <code>api.com</code> will be protected according to the rules from the AuthPolicy that targets the route for <code>api.com</code>; while a request for <code>other.com</code> will be protected with the rules from the AuthPolicy targeting the route for <code>*.com</code>.</p>
-<p>Example with 3 AuthPolicies and 3 HTTPRoutes:</p>
-<ul>
-<li>AuthPolicy A → HTTPRoute A (<code>a.toystore.com</code>)</li>
-<li>AuthPolicy B → HTTPRoute B (<code>b.toystore.com</code>)</li>
-<li>AuthPolicy W → HTTPRoute W (<code>*.toystore.com</code>)</li>
-</ul>
-<p>Expected behavior:</p>
-<ul>
-<li>Request to <code>a.toystore.com</code> → AuthPolicy A will be enforced</li>
-<li>Request to <code>b.toystore.com</code> → AuthPolicy B will be enforced</li>
-<li>Request to <code>other.toystore.com</code> → AuthPolicy W will be enforced</li>
-</ul>
-<h3 id="targeting-a-gateway-networking-resource">Targeting a Gateway networking resource<a class="headerlink" href="#targeting-a-gateway-networking-resource" title="Permanent link">&para;</a></h3>
-<p>An AuthPolicy that targets a Gateway can declare a block of <em>defaults</em> (<code>spec.defaults</code>) or a block of <em>overrides</em> (<code>spec.overrides</code>). As a standard, gateway policies that do not specify neither defaults nor overrides, act as defaults.</p>
-<p>When declaring <em>defaults</em>, an AuthPolicy which targets a Gateway will be enforced to all HTTP traffic hitting the gateway, unless a more specific AuthPolicy targeting a matching HTTPRoute exists. Any new HTTPRoute referrencing the gateway as parent will be automatically covered by the default AuthPolicy, as well as changes in the existing HTTPRoutes.</p>
-<p><em>Defaults</em> provide cluster operators with the ability to protect the infrastructure against unplanned and malicious network traffic attempt, such as by setting preemptive "deny-all" policies on hostnames and hostname wildcards.</p>
-<p>Inversely, a gateway policy that specify <em>overrides</em> declares a set of rules to be enforced on <em>all routes attached to the gateway</em>, thus atomically replacing any more specific policy occasionally attached to any of those routes.</p>
-<p>Target a Gateway HTTPRoute by setting the <code>spec.targetRef</code> field of the AuthPolicy as follows:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-gw-auth</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;Gateway Name&gt;</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span><span class="w"> </span><span class="c1"># alternatively: `overrides`</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>┌───────────────────┐             ┌────────────────────┐
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>│ (Infra namespace) │             │   (App namespace)  │
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>│                   │             │                    │
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>│  ┌─────────┐      │  parentRefs │  ┌───────────┐     │
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>│  │ Gateway │◄─────┼─────────────┼──┤ HTTPRoute │     │
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a>│  └─────────┘      │             │  └───────────┘     │
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>│       ▲           │             │        ▲           │
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a>│       │           │             │        │           │
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a>│       │           │             │        │           │
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>│       │ targetRef │             │        │ targetRef │
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a>│       │           │             │        │           │
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a>│ ┌─────┴──────┐    │             │  ┌─────┴──────┐    │
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a>│ │ AuthPolicy │    │             │  │ AuthPolicy │    │
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a>│ └────────────┘    │             │  └────────────┘    │
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a>│                   │             │                    │
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a>└───────────────────┘             └────────────────────┘
-</span></code></pre></div>
-<h4 id="overlapping-gateway-and-httproute-authpolicies">Overlapping Gateway and HTTPRoute AuthPolicies<a class="headerlink" href="#overlapping-gateway-and-httproute-authpolicies" title="Permanent link">&para;</a></h4>
-<p>Two possible semantics are to be considered here – gateway policy <em>defaults</em> vs gateway policy <em>overrides</em>.</p>
-<p>Gateway AuthPolicies that declare <em>defaults</em> (or alternatively neither defaults nor overrides) protect all traffic routed through the gateway except where a more specific HTTPRoute AuthPolicy exists, in which case the HTTPRoute AuthPolicy prevails.</p>
-<p>Example with 4 AuthPolicies, 3 HTTPRoutes and 1 Gateway <em>default</em> (plus 2 HTTPRoute and 2 Gateways without AuthPolicies attached):</p>
-<ul>
-<li>AuthPolicy A → HTTPRoute A (<code>a.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>AuthPolicy B → HTTPRoute B (<code>b.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>AuthPolicy W → HTTPRoute W (<code>*.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>AuthPolicy G (defaults) → Gateway G (<code>*.com</code>)</li>
-</ul>
-<p>Expected behavior:</p>
-<ul>
-<li>Request to <code>a.toystore.com</code> → AuthPolicy A will be enforced</li>
-<li>Request to <code>b.toystore.com</code> → AuthPolicy B will be enforced</li>
-<li>Request to <code>other.toystore.com</code> → AuthPolicy W will be enforced</li>
-<li>Request to <code>other.com</code> (suppose a route exists) → AuthPolicy G will be enforced</li>
-<li>Request to <code>yet-another.net</code> (suppose a route and gateway exist) → No AuthPolicy will be enforced</li>
-</ul>
-<p>Gateway AuthPolicies that declare <em>overrides</em> protect all traffic routed through the gateway, regardless of existence of any more specific HTTPRoute AuthPolicy.</p>
-<p>Example with 4 AuthPolicies, 3 HTTPRoutes and 1 Gateway <em>override</em> (plus 2 HTTPRoute and 2 Gateways without AuthPolicies attached):</p>
-<ul>
-<li>AuthPolicy A → HTTPRoute A (<code>a.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>AuthPolicy B → HTTPRoute B (<code>b.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>AuthPolicy W → HTTPRoute W (<code>*.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>AuthPolicy G (overrides) → Gateway G (<code>*.com</code>)</li>
-</ul>
-<p>Expected behavior:</p>
-<ul>
-<li>Request to <code>a.toystore.com</code> → AuthPolicy G will be enforced</li>
-<li>Request to <code>b.toystore.com</code> → AuthPolicy G will be enforced</li>
-<li>Request to <code>other.toystore.com</code> → AuthPolicy G will be enforced</li>
-<li>Request to <code>other.com</code> (suppose a route exists) → AuthPolicy G will be enforced</li>
-<li>Request to <code>yet-another.net</code> (suppose a route and gateway exist) → No AuthPolicy will be enforced</li>
-</ul>
-<h3 id="route-selectors">Route selectors<a class="headerlink" href="#route-selectors" title="Permanent link">&para;</a></h3>
-<p>Route selectors allow targeting sections of a HTTPRoute, by specifying sets of HTTPRouteMatches and/or hostnames that make the policy controller look up within the HTTPRoute spec for compatible declarations, and select the corresponding HTTPRouteRules and hostnames, to then build conditions that activate the policy or policy rule.</p>
-<p>Check out <a href="../reference/route-selectors/">Route selectors</a> for a full description, semantics and API reference.</p>
-<h4 id="when-conditions"><code>when</code> conditions<a class="headerlink" href="#when-conditions" title="Permanent link">&para;</a></h4>
-<p><code>when</code> conditions can be used to scope an AuthPolicy or auth rule within an AuthPolicy (i.e. to filter the traffic to which a policy or policy rule applies) without any coupling to the underlying network topology, i.e. without making direct references to HTTPRouteRules via <a href="../reference/route-selectors/#the-routeselectors-field"><code>routeSelectors</code></a>.</p>
-<p>Use <code>when</code> conditions to conditionally activate policies and policy rules based on attributes that cannot be expressed in the HTTPRoutes' <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or in general in AuthPolicies that target a Gateway.</p>
-<p><code>when</code> conditions in an AuthPolicy are compatible with Authorino <a href="https://docs.kuadrant.io/latest/authorino/docs/features/#common-feature-conditions-when">conditions</a>, thus supporting complex boolean expressions with AND and OR operators, as well as grouping.</p>
-<p>The selectors within the <code>when</code> conditions of an AuthPolicy are a subset of Kuadrant's Well-known Attributes (<a href="https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md">RFC 0002</a>). Check out the reference for the full list of supported selectors.</p>
-<p>Authorino <a href="https://docs.kuadrant.io/latest/authorino/docs/features/#string-modifiers">JSON path string modifiers</a> can also be applied to the selectors within the <code>when</code> conditions of an AuthPolicy.</p>
-<h3 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent link">&para;</a></h3>
-<p>Check out the following user guides for examples of protecting services with Kuadrant:</p>
-<ul>
-<li><a href="../user-guides/auth-for-app-devs-and-platform-engineers/">Enforcing authentication &amp; authorization with Kuadrant AuthPolicy, for app developers and platform engineers</a></li>
-<li><a href="../user-guides/authenticated-rl-for-app-developers/">Authenticated Rate Limiting for Application Developers</a></li>
-<li><a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/">Authenticated Rate Limiting with JWTs and Kubernetes RBAC</a></li>
-</ul>
-<h3 id="known-limitations">Known limitations<a class="headerlink" href="#known-limitations" title="Permanent link">&para;</a></h3>
-<ul>
-<li>One HTTPRoute can only be targeted by one AuthPolicy.</li>
-<li>One Gateway can only be targeted by one AuthPolicy.</li>
-<li>AuthPolicies can only target HTTPRoutes/Gateways defined within the same namespace of the AuthPolicy.</li>
-<li>2+ AuthPolicies cannot target network resources that define/inherit the same exact hostname.</li>
-</ul>
-<h4 id="limitation-multiple-network-resources-with-identical-hostnames">Limitation: Multiple network resources with identical hostnames<a class="headerlink" href="#limitation-multiple-network-resources-with-identical-hostnames" title="Permanent link">&para;</a></h4>
-<p>Kuadrant currently does not support multiple AuthPolicies simultaneously targeting network resources that declare identical hostnames. This includes multiple HTTPRoutes that specify the same hostnames in the <code>spec.hostnames</code> field, as well as HTTPRoutes that specify a hostname that is identical to a hostname specified in a listener of one of the route's parent gateways or HTTPRoutes that don't specify any hostname at all thus inheriting the hostnames from the parent gateways. In any of these cases, <strong>a maximum of one AuthPolicy targeting any of those resources that specify identical hostnames is allowed</strong>.</p>
-<p>Moreover, having <strong>multiple resources that declare identical hostnames</strong> may lead to unexpected behavior and therefore <strong>should be avoided</strong>.</p>
-<p>This limitation is rooted at the underlying components configured by Kuadrant for the implementation of its policies and the lack of information in the data plane regarding the exact route that is honored by the API gateway at each specific request, in cases of conflicting hostnames.</p>
-<p>To exemplify one way this limitation can impact deployments, consider the following topology:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>                 ┌──────────────┐
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>                 │   Gateway    │
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>                 ├──────────────┤
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>          ┌─────►│ listeners:   │◄──────┐
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a>          │      │ - host: *.io │       │
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>          │      └──────────────┘       │
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a>          │                             │
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a>          │                             │
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a>┌─────────┴─────────┐        ┌──────────┴────────┐
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a>│     HTTPRoute     │        │     HTTPRoute     │
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a>│     (route-a)     │        │     (route-b)     │
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>├───────────────────┤        ├───────────────────┤
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a>│ hostnames:        │        │ hostnames:        │
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a>│ - app.io          │        │ - app.io          │
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a>│ rules:            │        │ rules:            │
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a>│ - matches:        │        │ - matches:        │
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a>│   - path:         │        │   - path:         │
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a>│       value: /foo │        │       value: /bar │
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a>└───────────────────┘        └───────────────────┘
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a>          ▲                            ▲
-</span><span id="__span-5-21"><a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a>          │                            │
-</span><span id="__span-5-22"><a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a>    ┌─────┴──────┐               ┌─────┴──────┐
-</span><span id="__span-5-23"><a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></a>    │ AuthPolicy │               │ AuthPolicy │
-</span><span id="__span-5-24"><a id="__codelineno-5-24" name="__codelineno-5-24" href="#__codelineno-5-24"></a>    │ (policy-1) │               │ (policy-2) │
-</span><span id="__span-5-25"><a id="__codelineno-5-25" name="__codelineno-5-25" href="#__codelineno-5-25"></a>    └────────────┘               └────────────┘
-</span></code></pre></div>
-<p>In the example above, with the <code>policy-1</code> resource created before <code>policy-2</code>, <code>policy-1</code> will be enforced on all requests to <code>app.io/foo</code> while <code>policy-2</code> will be rejected. I.e. <code>app.io/bar</code> will not be secured. In fact, the status conditions of <code>policy-2</code> shall reflect <code>Enforced=false</code> with message <em>"AuthPolicy has encountered some issues: AuthScheme is not ready yet"</em>.</p>
-<p>Notice the enforcement of <code>policy-1</code> and no enforcement of <code>policy-2</code> is the opposite behavior as the <a href="../rate-limiting/#limitation-multiple-network-resources-with-identical-hostnames">analogous problem with the Kuadrant RateLimitPolicy</a>.</p>
-<p>A slightly different way the limitation applies is when two or more routes of a gateway declare the exact same hostname and a gateway policy is defined with expectation to set default rules for the cases not covered by more specific policies. E.g.:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>                                    ┌────────────┐
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>                         ┌──────────┤ AuthPolicy │
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>                         │          │ (policy-2) │
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>                         ▼          └────────────┘
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>                 ┌──────────────┐
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>                 │   Gateway    │
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a>                 ├──────────────┤
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>          ┌─────►│ listeners:   │◄──────┐
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>          │      │ - host: *.io │       │
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a>          │      └──────────────┘       │
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a>          │                             │
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a>          │                             │
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a>┌─────────┴─────────┐        ┌──────────┴────────┐
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a>│     HTTPRoute     │        │     HTTPRoute     │
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a>│     (route-a)     │        │     (route-b)     │
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a>├───────────────────┤        ├───────────────────┤
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a>│ hostnames:        │        │ hostnames:        │
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a>│ - app.io          │        │ - app.io          │
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a>│ rules:            │        │ rules:            │
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a>│ - matches:        │        │ - matches:        │
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a>│   - path:         │        │   - path:         │
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a>│       value: /foo │        │       value: /bar │
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a>└───────────────────┘        └───────────────────┘
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a>          ▲
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a>          │
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a>    ┌─────┴──────┐
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a>    │ AuthPolicy │
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a>    │ (policy-1) │
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a>    └────────────┘
-</span></code></pre></div>
-<p>Once again, requests to <code>app.io/foo</code> will be protected under AuthPolicy <code>policy-1</code>, while requests to <code>app.io/bar</code> will <strong>not</strong> be protected under any policy at all, unlike expected gateway policy <code>policy-2</code> enforced as default. Both policies will report status condition as <code>Enforced</code> nonetheless.</p>
-<p>To avoid these problems, use different hostnames in each route.</p>
-<h2 id="implementation-details">Implementation details<a class="headerlink" href="#implementation-details" title="Permanent link">&para;</a></h2>
-<p>Under the hood, for each AuthPolicy, Kuadrant creates an Istio <a href="https://istio.io/latest/docs/reference/config/security/authorization-policy"><code>AuthorizationPolicy</code></a> and an Authorino <a href="https://docs.kuadrant.io/latest/authorino/docs/architecture/#the-authorino-authconfig-custom-resource-definition-crd"><code>AuthConfig</code></a> custom resources.</p>
-<p>Only requests that matches the rules in the Istio <code>AuthorizationPolicy</code> cause an authorization request to be sent to the external authorization service ("Authorino"), i.e., only requests directed to the HTTPRouteRules targeted by the AuthPolicy (directly or indirectly), according to the declared top-level route selectors (if present), or all requests for which a matching HTTPRouteRule exists (otherwise).</p>
-<p>Authorino looks up for the auth scheme (<code>AuthConfig</code> custom resource) to enforce using the provided hostname of the original request as key. It then checks again if the request matches at least one of the selected HTTPRouteRules, in which case it enforces the auth scheme.</p>
-<details>
-  <summary>Exception to the rule</summary>
-
-  Due to limitations imposed by the Istio `AuthorizationPolicy`, there are a few patterns of HTTPRouteRules that cannot be translated to filters for the external authorization request. Therefore, the following patterns used in HTTPRouteMatches of top-level route selectors of an AuthPolicy will not be included in the Istio AuthorizationPolicy rules that trigger the check request with Authorino: `PathMatchRegularExpression`, `HeaderMatchRegularExpression`, and `HTTPQueryParamMatch`.
-
-  As a consequence to the above, requests that do not match these rules and otherwise would not be checked with Authorino will result in a request to the external authorization service. Authorino nonetheless will still verify those patterns and ensure the auth scheme is enforced only when it matches a selected HTTPRouteRule. Users of Kuadrant may observe an unnecessary call to the authorization service in those cases where the request is out of the scope of the AuthPolicy and therefore always authorized.
-</details>
-
-<h3 id="internal-custom-resources-and-namespaces">Internal custom resources and namespaces<a class="headerlink" href="#internal-custom-resources-and-namespaces" title="Permanent link">&para;</a></h3>
-<p>While the Istio <code>AuthorizationPolicy</code> needs to be created in the same namespace as the gateway workload, the Authorino <code>AuthConfig</code> is created in the namespace of the <code>AuthPolicy</code> itself. This allows to simplify references such as to Kubernetes Secrets referred in the AuthPolicy, as well as the RBAC to support the architecture.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/development/index.html b/0.10.0/kuadrant-operator/doc/development/index.html
deleted file mode 100644
index 0246e185f..000000000
--- a/0.10.0/kuadrant-operator/doc/development/index.html
+++ /dev/null
@@ -1,4060 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/development/">
-      
-      
-        <link rel="prev" href="../../">
-      
-      
-        <link rel="next" href="../logging/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Developer's Guide - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#development-guide" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Developer's Guide
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#technology-stack-required-for-development" class="md-nav__link">
-    <span class="md-ellipsis">
-      Technology stack required for development
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-on-local-kubernetes-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy on local kubernetes cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-as-a-local-process" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run as a local process
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-on-existing-kubernetes-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy on existing kubernetes cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-kuadrant-operator-using-olm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy kuadrant operator using OLM
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build-custom-olm-catalog" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build custom OLM catalog
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Build custom OLM catalog">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#build-kuadrant-operator-bundle-image" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build kuadrant operator bundle image
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#build-custom-catalog" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build custom catalog
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleaning-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleaning up
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run tests
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run tests">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#unittests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Unittests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#integration-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Integration tests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#lint-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Lint tests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#uninstall-kuadrant-crds" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Un)Install Kuadrant CRDs
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#technology-stack-required-for-development" class="md-nav__link">
-    <span class="md-ellipsis">
-      Technology stack required for development
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-on-local-kubernetes-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy on local kubernetes cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-as-a-local-process" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run as a local process
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-on-existing-kubernetes-cluster" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy on existing kubernetes cluster
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-kuadrant-operator-using-olm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy kuadrant operator using OLM
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build-custom-olm-catalog" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build custom OLM catalog
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Build custom OLM catalog">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#build-kuadrant-operator-bundle-image" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build kuadrant operator bundle image
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#build-custom-catalog" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build custom catalog
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleaning-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleaning up
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run tests
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run tests">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#unittests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Unittests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#integration-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Integration tests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#lint-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Lint tests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#uninstall-kuadrant-crds" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Un)Install Kuadrant CRDs
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/development.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="development-guide">Development Guide<a class="headerlink" href="#development-guide" title="Permanent link">&para;</a></h1>
-<h2 id="technology-stack-required-for-development">Technology stack required for development<a class="headerlink" href="#technology-stack-required-for-development" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="https://github.com/operator-framework/operator-sdk">operator-sdk</a> version v1.32.0</li>
-<li><a href="https://kind.sigs.k8s.io/">kind</a> version v0.23.0</li>
-<li><a href="https://git-scm.com/downloads">git</a></li>
-<li><a href="https://golang.org/">go</a> version 1.22+</li>
-<li><a href="https://kubernetes.io/">kubernetes</a> version v1.19+</li>
-<li><a href="https://kubernetes.io/docs/tasks/tools/#kubectl">kubectl</a> version v1.19+</li>
-</ul>
-<h2 id="build">Build<a class="headerlink" href="#build" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>make<span class="w"> </span>build
-</span></code></pre></div>
-<h2 id="deploy-on-local-kubernetes-cluster">Deploy on local kubernetes cluster<a class="headerlink" href="#deploy-on-local-kubernetes-cluster" title="Permanent link">&para;</a></h2>
-<p>Run local Kubernetes cluster using Docker container using <a href="https://kind.sigs.k8s.io/">Kind</a> and deploy kuadrant operator (and <em>all</em> dependencies) in a single command.</p>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>The <code>make local-setup</code> target accepts the following variables:</p>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>GATEWAYAPI_PROVIDER</code></td>
-<td>GatewayAPI provider name. Accepted values: [<em>istio</em>]</td>
-<td><em>istio</em></td>
-</tr>
-</tbody>
-</table>
-<h2 id="run-as-a-local-process">Run as a local process<a class="headerlink" href="#run-as-a-local-process" title="Permanent link">&para;</a></h2>
-<p>Run local Kubernetes cluster using Docker container using <a href="https://kind.sigs.k8s.io/">Kind</a> and deploy <em>all</em> dependencies in a single command.</p>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>make<span class="w"> </span>local-env-setup
-</span></code></pre></div>
-<p>The <code>make local-env-setup</code> target accepts the following variables:</p>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>GATEWAYAPI_PROVIDER</code></td>
-<td>GatewayAPI provider name. Accepted values: [<em>istio</em>]</td>
-<td><em>istio</em></td>
-</tr>
-</tbody>
-</table>
-<p>Then, run the operator locally</p>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>make<span class="w"> </span>run
-</span></code></pre></div>
-<h2 id="deploy-on-existing-kubernetes-cluster">Deploy on existing kubernetes cluster<a class="headerlink" href="#deploy-on-existing-kubernetes-cluster" title="Permanent link">&para;</a></h2>
-<p><strong>Requirements</strong>:</p>
-<ul>
-<li>Active session open to the kubernetes cluster.</li>
-<li>GatewayAPI installed</li>
-<li>GatewayAPI provider installed. Currently only Istio supported.</li>
-<li><a href="https://cert-manager.io/">Cert Manager</a> installed</li>
-</ul>
-<p>Before running the kuadrant operator, some dependencies needs to be deployed.</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>make install
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>make deploy-dependencies
-</span></code></pre></div>
-<p>Then, deploy the operator</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>make<span class="w"> </span>deploy
-</span></code></pre></div>
-<h2 id="deploy-kuadrant-operator-using-olm">Deploy kuadrant operator using OLM<a class="headerlink" href="#deploy-kuadrant-operator-using-olm" title="Permanent link">&para;</a></h2>
-<p>You can deploy kuadrant using OLM just running few commands.
-No need to build any image. Kuadrant engineering team provides <code>latest</code> and
-release version tagged images. They are available in
-the <a href="https://quay.io/organization/kuadrant">Quay.io/Kuadrant</a> image repository.</p>
-<p>Create kind cluster</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>make<span class="w"> </span>kind-create-cluster
-</span></code></pre></div>
-<p>Deploy OLM system</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>make<span class="w"> </span>install-olm
-</span></code></pre></div>
-<p>Deploy kuadrant using OLM. The <code>make deploy-catalog</code> target accepts the following variables:</p>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>CATALOG_IMG</code></td>
-<td>Kuadrant operator catalog image URL</td>
-<td><code>quay.io/kuadrant/kuadrant-operator-catalog:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>make<span class="w"> </span>deploy-catalog<span class="w"> </span><span class="o">[</span><span class="nv">CATALOG_IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator-catalog:latest<span class="o">]</span>
-</span></code></pre></div>
-<h2 id="build-custom-olm-catalog">Build custom OLM catalog<a class="headerlink" href="#build-custom-olm-catalog" title="Permanent link">&para;</a></h2>
-<p>If you want to deploy (using OLM) a custom kuadrant operator, you need to build your own catalog.
-Furthermore, if you want to deploy a custom limitador or authorino operator, you also need
-to build your own catalog. The kuadrant operator bundle includes the authorino or limtador operator
-dependency version, hence using other than <code>latest</code> version requires a custom kuadrant operator
-bundle and a custom catalog including the custom bundle.</p>
-<h3 id="build-kuadrant-operator-bundle-image">Build kuadrant operator bundle image<a class="headerlink" href="#build-kuadrant-operator-bundle-image" title="Permanent link">&para;</a></h3>
-<p>The <code>make bundle</code> target accepts the following variables:</p>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-<th><strong>Notes</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>IMG</code></td>
-<td>Kuadrant operator image URL</td>
-<td><code>quay.io/kuadrant/kuadrant-operator:latest</code></td>
-<td><code>TAG</code> var could be use to build this URL, defaults to <em>latest</em>  if not provided</td>
-</tr>
-<tr>
-<td><code>VERSION</code></td>
-<td>Bundle version</td>
-<td><code>0.0.0</code></td>
-<td></td>
-</tr>
-<tr>
-<td><code>LIMITADOR_OPERATOR_BUNDLE_IMG</code></td>
-<td>Limitador operator bundle URL</td>
-<td><code>quay.io/kuadrant/limitador-operator-bundle:latest</code></td>
-<td><code>LIMITADOR_OPERATOR_VERSION</code> var could be used to build this, defaults to <em>latest</em> if not provided</td>
-</tr>
-<tr>
-<td><code>AUTHORINO_OPERATOR_BUNDLE_IMG</code></td>
-<td>Authorino operator bundle URL</td>
-<td><code>quay.io/kuadrant/authorino-operator-bundle:latest</code></td>
-<td><code>AUTHORINO_OPERATOR_VERSION</code> var could be used to build this, defaults to <em>latest</em> if not provided</td>
-</tr>
-<tr>
-<td><code>DNS_OPERATOR_BUNDLE_IMG</code></td>
-<td>DNS operator bundle URL</td>
-<td><code>quay.io/kuadrant/dns-operator-bundle:latest</code></td>
-<td><code>DNS_OPERATOR_BUNDLE_IMG</code> var could be used to build this, defaults to <em>latest</em> if not provided</td>
-</tr>
-<tr>
-<td><code>RELATED_IMAGE_WASMSHIM</code></td>
-<td>WASM shim image URL</td>
-<td><code>oci://quay.io/kuadrant/wasm-shim:latest</code></td>
-<td><code>WASM_SHIM_VERSION</code> var could be used to build this, defaults to <em>latest</em> if not provided</td>
-</tr>
-</tbody>
-</table>
-<ul>
-<li>Build the bundle manifests</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>make<span class="w"> </span>bundle<span class="w"> </span><span class="o">[</span><span class="nv">IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">            </span><span class="o">[</span><span class="nv">VERSION</span><span class="o">=</span><span class="m">0</span>.0.0<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w">            </span><span class="o">[</span><span class="nv">LIMITADOR_OPERATOR_BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator-bundle:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">            </span><span class="o">[</span><span class="nv">AUTHORINO_OPERATOR_BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/authorino-operator-bundle:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w">            </span><span class="o">[</span><span class="nv">DNS_OPERATOR_BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/dns-operator-bundle:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w">            </span><span class="o">[</span><span class="nv">RELATED_IMAGE_WASMSHIM</span><span class="o">=</span>oci://quay.io/kuadrant/wasm-shim:latest<span class="o">]</span>
-</span></code></pre></div>
-<ul>
-<li>Build the bundle image from the manifests</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>BUNDLE_IMG</code></td>
-<td>Kuadrant operator bundle image URL</td>
-<td><code>quay.io/kuadrant/kuadrant-operator-bundle:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>make<span class="w"> </span>bundle-build<span class="w"> </span><span class="o">[</span><span class="nv">BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator-bundle:latest<span class="o">]</span>
-</span></code></pre></div>
-<ul>
-<li>Push the bundle image to a registry</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>BUNDLE_IMG</code></td>
-<td>Kuadrant operator bundle image URL</td>
-<td><code>quay.io/kuadrant/kuadrant-operator-bundle:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>make<span class="w"> </span>bundle-push<span class="w"> </span><span class="o">[</span><span class="nv">BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator-bundle:latest<span class="o">]</span>
-</span></code></pre></div>
-<p>Frequently, you may need to build custom kuadrant bundle with the default (<code>latest</code>) Limitador and
-Authorino bundles. These are the example commands to build the manifests, build the bundle image
-and push to the registry.</p>
-<p>In the example, a new kuadrant operator bundle version <code>0.8.0</code> will be created that references
-the kuadrant operator image <code>quay.io/kuadrant/kuadrant-operator:v0.5.0</code> and latest Limitador and
-Authorino bundles.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="c1"># manifests</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a>make<span class="w"> </span>bundle<span class="w"> </span><span class="nv">IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator:v0.5.0<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span><span class="m">0</span>.8.0
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="c1"># bundle image</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a>make<span class="w"> </span>bundle-build<span class="w"> </span><span class="nv">BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator-bundle:my-bundle
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="c1"># push bundle image</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>make<span class="w"> </span>bundle-push<span class="w"> </span><span class="nv">BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator-bundle:my-bundle
-</span></code></pre></div>
-<h3 id="build-custom-catalog">Build custom catalog<a class="headerlink" href="#build-custom-catalog" title="Permanent link">&para;</a></h3>
-<p>The catalog's format will be <a href="https://olm.operatorframework.io/docs/reference/file-based-catalogs/">File-based Catalog</a>.</p>
-<p>Make sure all the required bundles are pushed to the registry. It is required by the <code>opm</code> tool.</p>
-<p>The <code>make catalog</code> target accepts the following variables:</p>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>BUNDLE_IMG</code></td>
-<td>Kuadrant operator bundle image URL</td>
-<td><code>quay.io/kuadrant/kuadrant-operator-bundle:latest</code></td>
-</tr>
-<tr>
-<td><code>LIMITADOR_OPERATOR_BUNDLE_IMG</code></td>
-<td>Limitador operator bundle URL</td>
-<td><code>quay.io/kuadrant/limitador-operator-bundle:latest</code></td>
-</tr>
-<tr>
-<td><code>AUTHORINO_OPERATOR_BUNDLE_IMG</code></td>
-<td>Authorino operator bundle URL</td>
-<td><code>quay.io/kuadrant/authorino-operator-bundle:latest</code></td>
-</tr>
-<tr>
-<td><code>DNS_OPERATOR_BUNDLE_IMG</code></td>
-<td>DNS operator bundle URL</td>
-<td><code>quay.io/kuadrant/dns-operator-bundle:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>make<span class="w"> </span>catalog<span class="w"> </span><span class="o">[</span><span class="nv">BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator-bundle:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="w">            </span><span class="o">[</span><span class="nv">LIMITADOR_OPERATOR_BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator-bundle:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="w">            </span><span class="o">[</span><span class="nv">AUTHORINO_OPERATOR_BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/authorino-operator-bundle:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="w">            </span><span class="o">[</span><span class="nv">DNS_OPERATOR_BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/dns-operator-bundle:latest<span class="o">]</span>
-</span></code></pre></div>
-<ul>
-<li>Build the catalog image from the manifests</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>CATALOG_IMG</code></td>
-<td>Kuadrant operator catalog image URL</td>
-<td><code>quay.io/kuadrant/kuadrant-operator-catalog:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>make<span class="w"> </span>catalog-build<span class="w"> </span><span class="o">[</span><span class="nv">CATALOG_IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator-catalog:latest<span class="o">]</span>
-</span></code></pre></div>
-<ul>
-<li>Push the catalog image to a registry</li>
-</ul>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>make<span class="w"> </span>catalog-push<span class="w"> </span><span class="o">[</span><span class="nv">CATALOG_IMG</span><span class="o">=</span>quay.io/kuadrant/kuadrant-operator-bundle:latest<span class="o">]</span>
-</span></code></pre></div>
-<p>You can try out your custom catalog image following the steps of the
-<a href="#deploy-kuadrant-operator-using-olm">Deploy kuadrant operator using OLM</a> section.</p>
-<h2 id="cleaning-up">Cleaning up<a class="headerlink" href="#cleaning-up" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-<h2 id="run-tests">Run tests<a class="headerlink" href="#run-tests" title="Permanent link">&para;</a></h2>
-<h3 id="unittests">Unittests<a class="headerlink" href="#unittests" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>make<span class="w"> </span>test-unit
-</span></code></pre></div>
-<p>Optionally, add <code>TEST_NAME</code> makefile variable to run specific test</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>make<span class="w"> </span>test-unit<span class="w"> </span><span class="nv">TEST_NAME</span><span class="o">=</span>TestLimitIndexEquals
-</span></code></pre></div>
-<p>or even subtest</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>make<span class="w"> </span>test-unit<span class="w"> </span><span class="nv">TEST_NAME</span><span class="o">=</span>TestLimitIndexEquals/empty_indexes_are_equal
-</span></code></pre></div>
-<h3 id="integration-tests">Integration tests<a class="headerlink" href="#integration-tests" title="Permanent link">&para;</a></h3>
-<p>Multiple controller integration tests are defined</p>
-<table>
-<thead>
-<tr>
-<th>Golang package</th>
-<th>Required environment</th>
-<th>Makefile env setup target</th>
-<th>Makefile test run target</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>github.com/kuadrant/kuadrant-operator/tests/bare_k8s</code></td>
-<td>no gateway provider, no GatewayAPI CRDs. Just Kuadrant API and Kuadrant dependencies.</td>
-<td><code>make local-k8s-env-setup</code></td>
-<td><code>make test-bare-k8s-integration</code></td>
-</tr>
-<tr>
-<td><code>github.com/kuadrant/kuadrant-operator/tests/gatewayapi</code></td>
-<td>no gateway provider. GatewayAPI CRDs, Kuadrant API and Kuadrant dependencies.</td>
-<td><code>make local-gatewayapi-env-setup</code></td>
-<td><code>make test-gatewayapi-env-integration</code></td>
-</tr>
-<tr>
-<td><code>github.com/kuadrant/kuadrant-operator/controllers</code></td>
-<td>at least one gatewayapi provider. It can be any: istio, envoygateway, ...</td>
-<td><code>make local-env-setup GATEWAYAPI_PROVIDER=[istio]</code> (Default <em>istio</em>)</td>
-<td><code>make test-integration</code></td>
-</tr>
-<tr>
-<td><code>github.com/kuadrant/kuadrant-operator/tests/istio</code></td>
-<td>GatewayAPI CRDs, Istio, Kuadrant API and Kuadrant dependencies.</td>
-<td><code>make local-env-setup GATEWAYAPI_PROVIDER=istio</code></td>
-<td><code>make test-istio-env-integration</code></td>
-</tr>
-</tbody>
-</table>
-<h3 id="lint-tests">Lint tests<a class="headerlink" href="#lint-tests" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>make<span class="w"> </span>run-lint
-</span></code></pre></div>
-<h2 id="uninstall-kuadrant-crds">(Un)Install Kuadrant CRDs<a class="headerlink" href="#uninstall-kuadrant-crds" title="Permanent link">&para;</a></h2>
-<p>You need an active session open to a kubernetes cluster.</p>
-<p>Remove CRDs</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>make<span class="w"> </span>uninstall
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/dns/index.html b/0.10.0/kuadrant-operator/doc/dns/index.html
deleted file mode 100644
index f29fed74b..000000000
--- a/0.10.0/kuadrant-operator/doc/dns/index.html
+++ /dev/null
@@ -1,3940 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/dns/">
-      
-      
-        <link rel="prev" href="../install/install-openshift/">
-      
-      
-        <link rel="next" href="../reference/dnspolicy/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-dns" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How it works">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#the-dnspolicy-custom-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      The DNSPolicy custom resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The DNSPolicy custom resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#high-level-example-and-field-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      High-level example and field definition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-the-dnspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the DNSPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Using the DNSPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#dns-provider-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNS Provider Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-gateway-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a Gateway networking resource
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#dnsrecord-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSRecord Resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="DNSRecord Resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#loadbalanced" class="md-nav__link">
-    <span class="md-ellipsis">
-      loadbalanced
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#simple" class="md-nav__link">
-    <span class="md-ellipsis">
-      simple
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#known-limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Known limitations
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How it works">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#the-dnspolicy-custom-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      The DNSPolicy custom resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The DNSPolicy custom resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#high-level-example-and-field-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      High-level example and field definition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-the-dnspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the DNSPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Using the DNSPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#dns-provider-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNS Provider Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-gateway-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a Gateway networking resource
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#dnsrecord-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSRecord Resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="DNSRecord Resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#loadbalanced" class="md-nav__link">
-    <span class="md-ellipsis">
-      loadbalanced
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#simple" class="md-nav__link">
-    <span class="md-ellipsis">
-      simple
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#known-limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Known limitations
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/dns.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrant-dns">Kuadrant DNS<a class="headerlink" href="#kuadrant-dns" title="Permanent link">&para;</a></h1>
-<p>A Kuadrant DNSPolicy custom resource:</p>
-<ol>
-<li>Targets Gateway API networking resources <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.Gateway">Gateways</a> to provide dns management by managing the lifecycle of dns records in external dns providers such as AWS Route53 and Google DNS.</li>
-</ol>
-<h2 id="how-it-works">How it works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h2>
-<p>A DNSPolicy and its targeted Gateway API networking resource contain all the statements to configure both the ingress gateway and the external DNS service. 
-The needed dns names are gathered from the listener definitions and the IPAdresses | CNAME hosts are gathered from the status block of the gateway resource.</p>
-<h3 id="the-dnspolicy-custom-resource">The DNSPolicy custom resource<a class="headerlink" href="#the-dnspolicy-custom-resource" title="Permanent link">&para;</a></h3>
-<h4 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h4>
-<p>The <code>DNSPolicy</code> spec includes the following parts:</p>
-<ul>
-<li>A reference to an existing Gateway API resource (<code>spec.targetRef</code>)</li>
-<li>DNS Routing Strategy (<code>spec.routingStrategy</code>)</li>
-<li>LoadBalancing specification (<code>spec.loadBalancing</code>)</li>
-<li>HealthCheck specification (<code>spec.healthCheck</code>)</li>
-</ul>
-<h4 id="high-level-example-and-field-definition">High-level example and field definition<a class="headerlink" href="#high-level-example-and-field-definition" title="Permanent link">&para;</a></h4>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-dns-policy</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="c1"># reference to an existing networking resource to attach the policy to</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="c1"># it can only be a Gateway API Gateway resource</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span><span class="c1"># it can only refer to objects in the same namespace as the DNSPolicy</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">mygateway</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w"> </span><span class="c1"># reference to an existing secret resource containing provider credentials and configuration</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w"> </span><span class="c1"># it can only refer to Secrets in the same namespace as the DNSPolicy that have the type kuadrant.io/(provider) e.g kuadrant.io/aws</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">  </span><span class="nt">providerRefs</span><span class="p">:</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">   </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-aws-credentials</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">  </span><span class="c1"># (optional) routing strategy to use when creating DNS records, defaults to `loadbalanced`</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">  </span><span class="c1"># determines what DNS records are created in the DNS provider</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">  </span><span class="c1"># check out Kuadrant RFC 0005 https://github.com/Kuadrant/architecture/blob/main/rfcs/0005-single-cluster-dnspolicy.md to learn more about the Routing Strategy field</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">  </span><span class="c1"># One-of: simple, loadbalanced.</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">  </span><span class="nt">routingStrategy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">loadbalanced</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="w">  </span><span class="c1"># (optional) loadbalancing specification</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="w">  </span><span class="c1"># use it for providing the specification of how dns will be configured in order to provide balancing of load across multiple clusters when using the `loadbalanced` routing strategy</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="w">  </span><span class="c1"># Primary use of this is for multi cluster deployments</span>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="w">  </span><span class="c1"># check out Kuadrant RFC 0003 https://github.com/Kuadrant/architecture/blob/main/rfcs/0003-dns-policy.md to learn more about the options that can be used in this field</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="w">  </span><span class="nt">loadBalancing</span><span class="p">:</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="w">    </span><span class="c1"># (optional) weighted specification</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="w">    </span><span class="c1"># use it to control the weight value applied to records</span>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a><span class="w">    </span><span class="nt">weighted</span><span class="p">:</span>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a><span class="w">      </span><span class="c1"># use it to change the weight of a record based on labels applied to the target meta resource i.e. Gateway in a single cluster context or ManagedCluster in multi cluster with OCM</span>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a><span class="w">      </span><span class="nt">custom</span><span class="p">:</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">200</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a><span class="w">            </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a><span class="w">              </span><span class="nt">kuadrant.io/lb-attribute-custom-weight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AWS</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a><span class="w">      </span><span class="c1"># (optional) weight value that will be applied to weighted dns records by default. Integer greater than 0 and no larger than the maximum value accepted by the target dns provider, defaults to `120` </span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a><span class="w">      </span><span class="nt">defaultWeight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">100</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a><span class="w">    </span><span class="c1"># (optional) geo specification</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a><span class="w">    </span><span class="c1"># use it to control the geo value applied to records </span>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a><span class="w">    </span><span class="nt">geo</span><span class="p">:</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a><span class="w">      </span><span class="c1"># (optional) default geo to be applied to records </span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a><span class="w">      </span><span class="nt">defaultGeo</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">IE</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49" href="#__codelineno-0-49"></a><span class="w">  </span><span class="c1"># (optional) health check specification</span>
-</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50" href="#__codelineno-0-50"></a><span class="w">  </span><span class="c1"># health check probes with the following specification will be created for each DNS target</span>
-</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51" href="#__codelineno-0-51"></a><span class="w">  </span><span class="nt">healthCheck</span><span class="p">:</span>
-</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52" href="#__codelineno-0-52"></a><span class="w">    </span><span class="nt">allowInsecureCertificates</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53" href="#__codelineno-0-53"></a><span class="w">    </span><span class="nt">endpoint</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/</span>
-</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54" href="#__codelineno-0-54"></a><span class="w">    </span><span class="nt">expectedResponses</span><span class="p">:</span>
-</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55" href="#__codelineno-0-55"></a>
-</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56" href="#__codelineno-0-56"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">200</span>
-</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57" href="#__codelineno-0-57"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">201</span>
-</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58" href="#__codelineno-0-58"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">301</span>
-</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59" href="#__codelineno-0-59"></a><span class="w">    </span><span class="nt">failureThreshold</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
-</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60" href="#__codelineno-0-60"></a><span class="w">    </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">443</span>
-</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61" href="#__codelineno-0-61"></a><span class="w">    </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https</span>
-</span></code></pre></div>
-<p>Check out the <a href="../reference/dnspolicy/">API reference</a> for a full specification of the DNSPolicy CRD.</p>
-<h2 id="using-the-dnspolicy">Using the DNSPolicy<a class="headerlink" href="#using-the-dnspolicy" title="Permanent link">&para;</a></h2>
-<h3 id="dns-provider-setup">DNS Provider Setup<a class="headerlink" href="#dns-provider-setup" title="Permanent link">&para;</a></h3>
-<p>A DNSPolicy acts against a target Gateway by processing its listeners for hostnames that it can create dns records for. 
-In order for it to do this, it must know about the dns provider.
-This is done through the creation of dns provider secrets containing the credentials and configuration for the dns provider account.</p>
-<p>If for example a Gateway is created with a listener with a hostname of <code>echo.apps.hcpapps.net</code>:
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-gw</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="nt">listeners</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allowedRoutes</span><span class="p">:</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">        </span><span class="nt">namespaces</span><span class="p">:</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">          </span><span class="nt">from</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">All</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">      </span><span class="nt">hostname</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">echo.apps.hcpapps.net</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w">      </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTP</span>
-</span></code></pre></div></p>
-<p>In order for the DNSPolicy to act upon that listener, a DNS provider Secret must exist for that hostnames' domain.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-aws-credentials</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;Gateway Namespace&gt;</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="nt">data</span><span class="p">:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">  </span><span class="nt">AWS_ACCESS_KEY_ID</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;AWS_ACCESS_KEY_ID&gt;</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">  </span><span class="nt">AWS_REGION</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;AWS_REGION&gt;</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">  </span><span class="nt">AWS_SECRET_ACCESS_KEY</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;AWS_SECRET_ACCESS_KEY&gt;</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/aws</span>
-</span></code></pre></div>
-<p>By default, Kuadrant will list the available zones and find the matching zone based on the listener host in the gateway listener. If it finds more than one matching zone for a given listener host, it will not update any of those zones. 
-When providing a credential you should limit that credential down to just have write access to the zones you want Kuadrant to manage. Below is an example of a an AWS policy for doing this type of thing:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>{
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>    &quot;Version&quot;: &quot;2012-10-17&quot;,
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a>    &quot;Statement&quot;: [
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a>        {
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>            &quot;Sid&quot;: &quot;VisualEditor0&quot;,
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a>            &quot;Effect&quot;: &quot;Allow&quot;,
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a>            &quot;Action&quot;: [
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a>                &quot;route53:ListTagsForResources&quot;,
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a>                &quot;route53:GetHealthCheckLastFailureReason&quot;,
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a>                &quot;route53:GetHealthCheckStatus&quot;,
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a>                &quot;route53:GetChange&quot;,
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a>                &quot;route53:GetHostedZone&quot;,
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a>                &quot;route53:ChangeResourceRecordSets&quot;,
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a>                &quot;route53:ListResourceRecordSets&quot;,
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a>                &quot;route53:GetHealthCheck&quot;,
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a>                &quot;route53:UpdateHostedZoneComment&quot;,
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a>                &quot;route53:UpdateHealthCheck&quot;,
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a>                &quot;route53:CreateHealthCheck&quot;,
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a>                &quot;route53:DeleteHealthCheck&quot;,
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a>                &quot;route53:ListTagsForResource&quot;,
-</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a>                &quot;route53:ListHealthChecks&quot;,
-</span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a>                &quot;route53:GetGeoLocation&quot;,
-</span><span id="__span-3-23"><a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a>                &quot;route53:ListGeoLocations&quot;,
-</span><span id="__span-3-24"><a id="__codelineno-3-24" name="__codelineno-3-24" href="#__codelineno-3-24"></a>                &quot;route53:ListHostedZonesByName&quot;,
-</span><span id="__span-3-25"><a id="__codelineno-3-25" name="__codelineno-3-25" href="#__codelineno-3-25"></a>                &quot;route53:GetHealthCheckCount&quot;
-</span><span id="__span-3-26"><a id="__codelineno-3-26" name="__codelineno-3-26" href="#__codelineno-3-26"></a>            ],
-</span><span id="__span-3-27"><a id="__codelineno-3-27" name="__codelineno-3-27" href="#__codelineno-3-27"></a>            &quot;Resource&quot;: [
-</span><span id="__span-3-28"><a id="__codelineno-3-28" name="__codelineno-3-28" href="#__codelineno-3-28"></a>                &quot;arn:aws:route53:::hostedzone/Z08187901Y93585DDGM6K&quot;,
-</span><span id="__span-3-29"><a id="__codelineno-3-29" name="__codelineno-3-29" href="#__codelineno-3-29"></a>                &quot;arn:aws:route53:::healthcheck/*&quot;,
-</span><span id="__span-3-30"><a id="__codelineno-3-30" name="__codelineno-3-30" href="#__codelineno-3-30"></a>                &quot;arn:aws:route53:::change/*&quot;
-</span><span id="__span-3-31"><a id="__codelineno-3-31" name="__codelineno-3-31" href="#__codelineno-3-31"></a>            ]
-</span><span id="__span-3-32"><a id="__codelineno-3-32" name="__codelineno-3-32" href="#__codelineno-3-32"></a>        },
-</span><span id="__span-3-33"><a id="__codelineno-3-33" name="__codelineno-3-33" href="#__codelineno-3-33"></a>        {
-</span><span id="__span-3-34"><a id="__codelineno-3-34" name="__codelineno-3-34" href="#__codelineno-3-34"></a>            &quot;Sid&quot;: &quot;VisualEditor1&quot;,
-</span><span id="__span-3-35"><a id="__codelineno-3-35" name="__codelineno-3-35" href="#__codelineno-3-35"></a>            &quot;Effect&quot;: &quot;Allow&quot;,
-</span><span id="__span-3-36"><a id="__codelineno-3-36" name="__codelineno-3-36" href="#__codelineno-3-36"></a>            &quot;Action&quot;: [
-</span><span id="__span-3-37"><a id="__codelineno-3-37" name="__codelineno-3-37" href="#__codelineno-3-37"></a>                &quot;route53:ListHostedZones&quot;
-</span><span id="__span-3-38"><a id="__codelineno-3-38" name="__codelineno-3-38" href="#__codelineno-3-38"></a>            ],
-</span><span id="__span-3-39"><a id="__codelineno-3-39" name="__codelineno-3-39" href="#__codelineno-3-39"></a>            &quot;Resource&quot;: &quot;*&quot;
-</span><span id="__span-3-40"><a id="__codelineno-3-40" name="__codelineno-3-40" href="#__codelineno-3-40"></a>        }
-</span><span id="__span-3-41"><a id="__codelineno-3-41" name="__codelineno-3-41" href="#__codelineno-3-41"></a>    ]
-</span><span id="__span-3-42"><a id="__codelineno-3-42" name="__codelineno-3-42" href="#__codelineno-3-42"></a>}
-</span></code></pre></div>
-<h3 id="targeting-a-gateway-networking-resource">Targeting a Gateway networking resource<a class="headerlink" href="#targeting-a-gateway-networking-resource" title="Permanent link">&para;</a></h3>
-<p>When a DNSPolicy targets a Gateway, the policy will be enforced on all gateway listeners.</p>
-<p>Target a Gateway by setting the <code>spec.targetRef</code> field of the DNSPolicy as follows:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSPolicy</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;DNSPolicy name&gt;</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;Gateway Name&gt;</span>
-</span></code></pre></div>
-<h3 id="dnsrecord-resource">DNSRecord Resource<a class="headerlink" href="#dnsrecord-resource" title="Permanent link">&para;</a></h3>
-<p>The DNSPolicy will create a DNSRecord resource for each listener hostname. The DNSPolicy resource uses the status of the Gateway to determine what dns records need to be created based on the clusters it has been placed onto.</p>
-<p>Given the following multi cluster gateway status:
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">status</span><span class="p">:</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="w">  </span><span class="nt">addresses</span><span class="p">:</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/MultiClusterIPAddress</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kind-mgc-workload-1/172.31.201.1</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/MultiClusterIPAddress</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="w">      </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kind-mgc-workload-2/172.31.202.1</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="w">  </span><span class="nt">listeners</span><span class="p">:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">attachedRoutes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="w">      </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kind-mgc-workload-1.api</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="w">      </span><span class="nt">supportedKinds</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">attachedRoutes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="w">      </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kind-mgc-workload-2.api</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="w">      </span><span class="nt">supportedKinds</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span><span class="w">        </span>
-</span></code></pre></div></p>
-<p>A DNSPolicy targeting this gateway would create an appropriate DNSRecord based on the routing strategy selected.</p>
-<h4 id="loadbalanced">loadbalanced<a class="headerlink" href="#loadbalanced" title="Permanent link">&para;</a></h4>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSRecord</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">echo.apps.hcpapps.net</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;Gateway Namespace&gt;</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w">  </span><span class="nt">endpoints</span><span class="p">:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">24osuu.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.202.1</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="w">      </span><span class="nt">providerSpecific</span><span class="p">:</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">weight</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;120&quot;</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="w">      </span><span class="nt">setIdentifier</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">24osuu.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">24osuu.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="w">      </span><span class="nt">providerSpecific</span><span class="p">:</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">weight</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;120&quot;</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="w">      </span><span class="nt">setIdentifier</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lrnse3.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lrnse3.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-32"><a id="__codelineno-6-32" name="__codelineno-6-32" href="#__codelineno-6-32"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">echo.apps.hcpapps.net</span>
-</span><span id="__span-6-33"><a id="__codelineno-6-33" name="__codelineno-6-33" href="#__codelineno-6-33"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-6-34"><a id="__codelineno-6-34" name="__codelineno-6-34" href="#__codelineno-6-34"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-6-35"><a id="__codelineno-6-35" name="__codelineno-6-35" href="#__codelineno-6-35"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-6-36"><a id="__codelineno-6-36" name="__codelineno-6-36" href="#__codelineno-6-36"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-37"><a id="__codelineno-6-37" name="__codelineno-6-37" href="#__codelineno-6-37"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-38"><a id="__codelineno-6-38" name="__codelineno-6-38" href="#__codelineno-6-38"></a><span class="w">      </span><span class="nt">providerSpecific</span><span class="p">:</span>
-</span><span id="__span-6-39"><a id="__codelineno-6-39" name="__codelineno-6-39" href="#__codelineno-6-39"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">geo-country-code</span>
-</span><span id="__span-6-40"><a id="__codelineno-6-40" name="__codelineno-6-40" href="#__codelineno-6-40"></a><span class="w">          </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&#39;*&#39;</span>
-</span><span id="__span-6-41"><a id="__codelineno-6-41" name="__codelineno-6-41" href="#__codelineno-6-41"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
-</span><span id="__span-6-42"><a id="__codelineno-6-42" name="__codelineno-6-42" href="#__codelineno-6-42"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">CNAME</span>
-</span><span id="__span-6-43"><a id="__codelineno-6-43" name="__codelineno-6-43" href="#__codelineno-6-43"></a><span class="w">      </span><span class="nt">setIdentifier</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span>
-</span><span id="__span-6-44"><a id="__codelineno-6-44" name="__codelineno-6-44" href="#__codelineno-6-44"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-6-45"><a id="__codelineno-6-45" name="__codelineno-6-45" href="#__codelineno-6-45"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-46"><a id="__codelineno-6-46" name="__codelineno-6-46" href="#__codelineno-6-46"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">lrnse3.lb-2903yb.echo.apps.hcpapps.net</span>
-</span><span id="__span-6-47"><a id="__codelineno-6-47" name="__codelineno-6-47" href="#__codelineno-6-47"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-6-48"><a id="__codelineno-6-48" name="__codelineno-6-48" href="#__codelineno-6-48"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A</span>
-</span><span id="__span-6-49"><a id="__codelineno-6-49" name="__codelineno-6-49" href="#__codelineno-6-49"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-6-50"><a id="__codelineno-6-50" name="__codelineno-6-50" href="#__codelineno-6-50"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.201.1</span>
-</span><span id="__span-6-51"><a id="__codelineno-6-51" name="__codelineno-6-51" href="#__codelineno-6-51"></a><span class="w">  </span><span class="nt">providerRefs</span><span class="p">:</span>
-</span><span id="__span-6-52"><a id="__codelineno-6-52" name="__codelineno-6-52" href="#__codelineno-6-52"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-aws-credentials</span>
-</span></code></pre></div>
-<p>After DNSRecord reconciliation the listener hostname should be resolvable through dns:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>dig<span class="w"> </span>echo.apps.hcpapps.net<span class="w"> </span>+short
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>lb-2903yb.echo.apps.hcpapps.net.
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>default.lb-2903yb.echo.apps.hcpapps.net.
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>lrnse3.lb-2903yb.echo.apps.hcpapps.net.
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="m">172</span>.31.201.1
-</span></code></pre></div>
-<h4 id="simple">simple<a class="headerlink" href="#simple" title="Permanent link">&para;</a></h4>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DNSRecord</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">echo.apps.hcpapps.net</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;Gateway Namespace&gt;</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w">  </span><span class="nt">endpoints</span><span class="p">:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">dnsName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">echo.apps.hcpapps.net</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">      </span><span class="nt">recordTTL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w">      </span><span class="nt">recordType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w">      </span><span class="nt">targets</span><span class="p">:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.201.1</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">172.31.202.1</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="w">  </span><span class="nt">providerRefs</span><span class="p">:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="w">   </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-aws-credentials</span><span class="w"> </span>
-</span></code></pre></div>
-<p>After DNSRecord reconciliation the listener hostname should be resolvable through dns:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>dig<span class="w"> </span>echo.apps.hcpapps.net<span class="w"> </span>+short
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="m">172</span>.31.201.1
-</span></code></pre></div>
-<h3 id="known-limitations">Known limitations<a class="headerlink" href="#known-limitations" title="Permanent link">&para;</a></h3>
-<ul>
-<li>One Gateway can only be targeted by one DNSPolicy.</li>
-<li>DNSPolicies can only target Gateways defined within the same namespace of the DNSPolicy.</li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/dnshealthchecks/index.html b/0.10.0/kuadrant-operator/doc/dnshealthchecks/index.html
deleted file mode 100644
index 4170546c0..000000000
--- a/0.10.0/kuadrant-operator/doc/dnshealthchecks/index.html
+++ /dev/null
@@ -1,3580 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/dnshealthchecks/">
-      
-      
-        <link rel="prev" href="../user-guides/secure-protect-connect-single-multi-cluster/">
-      
-      
-        <link rel="next" href="../../../dns-operator/docs/provider/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>DNS Health Checks - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#dns-health-checks" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              DNS Health Checks
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#supported-providers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Supported Providers
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#configuration-of-health-checks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configuration of Health Checks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#reviewing-the-status-of-health-checks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reviewing the status of Health Checks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#reconfiguring-health-checks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reconfiguring Health Checks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#removing-health-checks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Removing Health Checks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitations
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#other-providers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Other Providers
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#supported-providers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Supported Providers
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#configuration-of-health-checks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configuration of Health Checks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#reviewing-the-status-of-health-checks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reviewing the status of Health Checks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#reconfiguring-health-checks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reconfiguring Health Checks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#removing-health-checks" class="md-nav__link">
-    <span class="md-ellipsis">
-      Removing Health Checks
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitations
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#other-providers" class="md-nav__link">
-    <span class="md-ellipsis">
-      Other Providers
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/dnshealthchecks.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="dns-health-checks">DNS Health Checks<a class="headerlink" href="#dns-health-checks" title="Permanent link">&para;</a></h1>
-<p>DNS Health Checks are a tool provided by some DNS Providers for ensuring the availability and reliability of your DNS Records and only publishing DNS Records that resolve to healthy workloads. Kuadrant offers a powerful feature known as DNSPolicy, which allows you to configure these health checks for all the managed DNS endpoints created as a result of that policy. This guide provides a comprehensive overview of how to set up, utilize, and understand these DNS health checks.</p>
-<h2 id="supported-providers">Supported Providers<a class="headerlink" href="#supported-providers" title="Permanent link">&para;</a></h2>
-<p>we currently only support <a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/health-checks-types.html">AWS Route53 DNS Health checks</a>.</p>
-<h2 id="configuration-of-health-checks">Configuration of Health Checks<a class="headerlink" href="#configuration-of-health-checks" title="Permanent link">&para;</a></h2>
-<p>To configure a DNS health check, you need to specify the <code>healthCheck</code> section of the DNSPolicy, which includes important properties such as:</p>
-<ul>
-<li><code>endpoint</code>: This is the path where the health checks take place, usually represented as '/healthz' or something similar.</li>
-<li><code>port</code>: Specific port for the connection to be checked.</li>
-<li><code>protocol</code>: Type of protocol being used, like HTTP or HTTPS.</li>
-<li><code>FailureThreshold</code>: How many times we can tolerate a failure on this endpoint, before removing the related DNS entry.</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>apiVersion:<span class="w"> </span>kuadrant.io/v1alpha1
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>kind:<span class="w"> </span>DNSPolicy
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>metadata:
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span>name:<span class="w"> </span>prod-web
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span>namespace:<span class="w"> </span>multi-cluster-gateways
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>spec:
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span>targetRef:
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">    </span>name:<span class="w"> </span>prod-web
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">    </span>group:<span class="w"> </span>gateway.networking.k8s.io
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span>kind:<span class="w"> </span>Gateway
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">  </span>loadBalancing:<span class="w"> </span>simple
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">  </span>healthCheck:
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">    </span>endpoint:<span class="w"> </span><span class="s2">&quot;/health&quot;</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">    </span>port:<span class="w"> </span><span class="m">443</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">    </span>protocol:<span class="w"> </span><span class="s2">&quot;HTTPS&quot;</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">    </span>failureThreshold:<span class="w"> </span><span class="m">5</span>
-</span></code></pre></div>
-<p>This configuration sets up a DNS health check in AWS Route53 which will connect by HTTPS on port 443 and request the path /health.</p>
-<h2 id="reviewing-the-status-of-health-checks">Reviewing the status of Health Checks<a class="headerlink" href="#reviewing-the-status-of-health-checks" title="Permanent link">&para;</a></h2>
-<p>The DNS Record CR will show whether the health check has been created or not in the DNS Provider, and will also show any errors encountered when trying to create or update the health check configuration.</p>
-<p>To see the status of the executing health check requires logging in to the Route53 console to view the current probe results.</p>
-<h2 id="reconfiguring-health-checks">Reconfiguring Health Checks<a class="headerlink" href="#reconfiguring-health-checks" title="Permanent link">&para;</a></h2>
-<p>To reconfigure the health checks,  update the HealthCheck section of the DNS Policy, this will be reflected into all the health checks created as a result of this policy.</p>
-<h2 id="removing-health-checks">Removing Health Checks<a class="headerlink" href="#removing-health-checks" title="Permanent link">&para;</a></h2>
-<p>To remove the health checks created in AWS, delete the healthcheck section of the DNS Policy. All health checks will be deleted automatically, if the DNS Policy is deleted.</p>
-<h2 id="limitations">Limitations<a class="headerlink" href="#limitations" title="Permanent link">&para;</a></h2>
-<p>As Route53 will only perform health checks on an IP address, currently do not create health checks on DNS Policies that target gateways with hostname addresses.</p>
-<h2 id="other-providers">Other Providers<a class="headerlink" href="#other-providers" title="Permanent link">&para;</a></h2>
-<p>Although we intend to support integrating with the DNS Health checks provided by other DNS Providers in the future, we currently only support AWS Route53.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/images/kuadrant-architecture.svg b/0.10.0/kuadrant-operator/doc/images/kuadrant-architecture.svg
deleted file mode 100644
index 43e68124f..000000000
--- a/0.10.0/kuadrant-operator/doc/images/kuadrant-architecture.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1462.79" height="1200"><g transform="translate(-138.68043131791035 100)" lucid:page-tab-id="0_0"><path d="M158.68-74a6 6 0 0 1 6-6H1314a6 6 0 0 1 6 6v1148a6 6 0 0 1-6 6H164.68a6 6 0 0 1-6-6z" fill="#fff"/><path d="M193.24-79.93h29.5m14.74 0h29.5m14.74 0h29.5m14.74 0h29.5m14.74 0h29.5m14.74 0h29.5m14.74-.02h29.5m14.74 0h29.5m14.74 0h29.5m14.74 0h29.5m14.74 0h29.5m14.74 0h29.5m14.74 0h29.5m14.74 0l29.5-.02m14.75 0h29.5m14.75 0h29.5m14.74 0h29.48m14.75 0h29.5m14.74 0h29.5m14.74 0h29.5m14.75 0l29.5-.02m14.74 0h29.48m14.75 0h29.5m14.74 0h29.5m14.74 0h29.5m14.75 0H1314l.94.07.9.22.88.35.8.5.72.6.6.72.5.8.37.88.23.9v14.74m0 14.72v29.46m0 14.73v29.47m0 14.73v29.46m0 14.73v29.45m0 14.73v29.46m0 14.73v29.46m.02 14.73v29.46m0 14.73v29.46m0 14.74v29.46m0 14.73v29.46m0 14.72v29.46m0 14.73v29.47m0 14.73v29.46m0 14.73l.02 29.45m0 14.73v29.46m0 14.73v29.46m0 14.73v29.46m0 14.73v29.46m0 14.74v29.46m0 14.73v29.46m0 14.72l.02 29.46m0 14.73v29.47m0 14.73v29.46m0 14.73v29.45m0 14.73v29.46m0 14.73V1074l-.07.94-.22.9-.35.88-.5.8-.6.72-.72.6-.8.5-.88.37-.9.23h-14.76m-14.76 0h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74.02h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74 0h-29.5m-14.74 0l-29.5.02m-14.74 0h-29.5m-14.75 0h-29.5m-14.74 0h-29.5m-14.75 0h-29.5m-14.74 0h-29.48m-14.75 0h-29.5m-14.74 0l-29.5.02m-14.74 0h-29.5m-14.75 0h-29.5m-14.74 0h-29.5m-14.73 0h-29.5m-14.74 0h-14.75l-.94-.07-.9-.22-.88-.35-.8-.5-.72-.6-.6-.72-.5-.8-.37-.88-.22-.9v-14.74m0-14.72v-29.46m0-14.73v-29.47m0-14.73v-29.46m0-14.73v-29.45m0-14.73v-29.46m0-14.73v-29.46m0-14.73l-.02-29.46m0-14.73V706.7m0-14.74V662.5m0-14.73V618.3m0-14.72v-29.46m0-14.73v-29.47m0-14.73v-29.46m0-14.73l-.02-29.45m0-14.73v-29.46m0-14.73v-29.46m0-14.73v-29.46m0-14.73V264.8m0-14.74V220.6m0-14.73V176.4m0-14.72v-29.46m0-14.73V88.02m0-14.73V43.84m0-14.73V-.34m-.02-14.73v-29.46m0-14.73V-74l.07-.94.22-.9.36-.88.5-.8.6-.72.72-.6.8-.5.88-.37.9-.23h14.76" stroke="#5e5e5e" stroke-width="3" fill="none"/><use xlink:href="#a" transform="matrix(1,0,0,1,163.68043131791035,-75) translate(478.62345679012344 17.77777777777778)"/><use xlink:href="#b" transform="matrix(1,0,0,1,163.68043131791035,-75) translate(516.895061728395 17.77777777777778)"/><use xlink:href="#c" transform="matrix(1,0,0,1,163.68043131791035,-75) translate(603.1913580246913 17.77777777777778)"/><path d="M178.68-34a6 6 0 0 1 6-6H1274a6 6 0 0 1 6 6v494a6 6 0 0 1-6 6H184.68a6 6 0 0 1-6-6z" fill="#e5e5e5"/><path d="M214.03-39.93h30.28m15.15 0h30.3m15.13 0h30.3m15.13 0h30.3m15.14 0h30.28m15.14 0l30.3-.02m15.13 0h30.28m15.14 0h30.28m15.15 0h30.28m15.14 0h30.3m15.13 0h30.3m15.13 0H744m15.16-.02h30.28m15.14 0h30.3m15.13 0h30.3m15.14 0h30.28m15.15 0h30.28m15.14 0h30.28m15.14 0l30.3-.02m15.13 0h30.28m15.15 0h30.28m15.14 0h30.3m15.13 0h30.3m15.13 0H1274l.94.07.9.22.88.35.8.5.72.6.6.72.5.8.37.88.23.9v15m0 15v30m0 15v30m0 15l.02 30m0 15v30m0 15v29.98m0 15l.02 30m0 15v30m0 15v30m0 15L1280 385m0 15v30m0 15v15l-.07.94-.22.92-.35.87-.5.8-.6.72-.72.6-.8.5-.88.36-.9.23h-15.15m-15.15 0h-30.28m-15.14 0h-30.3m-15.13 0h-30.3m-15.13 0h-30.28m-15.16 0l-30.28.02m-15.14 0h-30.3m-15.13 0h-30.3m-15.14 0h-30.28m-15.15 0h-30.28m-15.14 0h-30.28m-15.14 0h-30.3m-15.13.02h-30.28m-15.15 0h-30.28m-15.14 0h-30.3m-15.13 0h-30.3m-15.13 0h-30.28m-15.15 0h-30.27m-15.14 0l-30.3.02m-15.14 0h-30.28m-15.15 0h-30.28m-15.14 0h-30.28m-15.14 0h-30.3m-15.13 0h-30.28m-15.15 0h-15.14l-.94-.07-.9-.22-.88-.35-.8-.5-.72-.6-.6-.72-.5-.8-.37-.87-.22-.92v-15m0-15v-30m0-15v-30m0-14.98l-.02-30m0-15v-30m0-15v-30m0-15L178.7 176m0-15v-30m0-15v-30m0-15V41m0-15L178.67-4m0-15v-15l.07-.94.22-.9.36-.88.5-.8.6-.72.72-.6.8-.5.88-.37.9-.23h15.15" stroke="#5e5e5e" stroke-width="3" fill="none"/><use xlink:href="#d" transform="matrix(1,0,0,1,183.68043131791035,-35) translate(484.91975308641975 17.77777777777778)"/><use xlink:href="#e" transform="matrix(1,0,0,1,183.68043131791035,-35) translate(583.6234567901234 17.77777777777778)"/><path d="M220 106a6 6 0 0 1 6-6h128a6 6 0 0 1 6 6v68a6 6 0 0 1-6 6H226a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#f" transform="matrix(1,0,0,1,225.01376465124372,105) translate(48.7283950617284 14.222222222222221)"/><use xlink:href="#g" transform="matrix(1,0,0,1,225.01376465124372,105) translate(23.074074074074083 35.55555555555556)"/><use xlink:href="#h" transform="matrix(1,0,0,1,225.01376465124372,105) translate(53.41975308641976 49.77777777777777)"/><path d="M300 186a6 6 0 0 1 6-6h108a6 6 0 0 1 6 6v85.83a6 6 0 0 1-6 6H306a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#f" transform="matrix(1,0,0,1,305.0137646512437,185) translate(38.7283950617284 14.222222222222221)"/><use xlink:href="#i" transform="matrix(1,0,0,1,305.0137646512437,185) translate(27.716049382716054 35.55555555555556)"/><use xlink:href="#j" transform="matrix(1,0,0,1,305.0137646512437,185) translate(30.358024691358032 56.888888888888886)"/><use xlink:href="#k" transform="matrix(1,0,0,1,305.0137646512437,185) translate(35.33333333333334 71.11111111111111)"/><use xlink:href="#l" transform="matrix(1,0,0,1,305.0137646512437,185) translate(56.02469135802469 71.11111111111111)"/><path d="M200 180.5a6 6 0 0 1 6-6h88a6 6 0 0 1 6 6v68a6 6 0 0 1-6 6h-88a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c3f7c8"/><use xlink:href="#m" transform="matrix(1,0,0,1,205.01376465124372,179.50365242179748) translate(18.98765432098766 39.65277777777778)"/><path d="M158.68 324.5a6 6 0 0 1 6-6H254a6 6 0 0 1 6 6v131.34a6 6 0 0 1-6 6H164.7a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c3f7c8"/><use xlink:href="#n" transform="matrix(1,0,0,1,163.68043131791035,323.5036524217975) translate(27.694444444444446 45.3125)"/><use xlink:href="#o" transform="matrix(1,0,0,1,163.68043131791035,323.5036524217975) translate(13.250000000000007 69.3125)"/><use xlink:href="#p" transform="matrix(1,0,0,1,163.68043131791035,323.5036524217975) translate(6.583333333333336 93.3125)"/><path d="M500 180.5a6 6 0 0 1 6-6h118a6 6 0 0 1 6 6v55.34a6 6 0 0 1-6 6H506a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#q" transform="matrix(1,0,0,1,505.0137646512437,179.50365242179748) translate(25.4567901234568 21.47222222222222)"/><use xlink:href="#r" transform="matrix(1,0,0,1,505.0137646512437,179.50365242179748) translate(16.09876543209878 42.80555555555556)"/><path d="M608.68 217.17a6 6 0 0 1 6-6h108a6 6 0 0 1 6 6v48a6 6 0 0 1-6 6h-108a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c1e4f7"/><use xlink:href="#s" transform="matrix(1,0,0,1,613.6804313179105,216.17031908846417) translate(7.53086419753086 30.27777777777778)"/><path d="M880 180.5a6 6 0 0 1 6-6h118a6 6 0 0 1 6 6v55.34a6 6 0 0 1-6 6H886a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#q" transform="matrix(1,0,0,1,885,179.50365242179748) translate(25.4567901234568 21.47222222222222)"/><use xlink:href="#t" transform="matrix(1,0,0,1,885,179.50365242179748) translate(22.567901234567913 42.80555555555556)"/><path d="M780 218.34a6 6 0 0 1 6-6h108a6 6 0 0 1 6 6v48a6 6 0 0 1-6 6H786a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c1e4f7"/><use xlink:href="#u" transform="matrix(1,0,0,1,785,217.33698575513074) translate(9.444444444444436 30.27777777777778)"/><path d="M946.5 376.5h-3v-44.66h3zm0-66h-3v-46.58h3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M946.5 378h-3v-1.54h3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M949.64 262.42h-9.28l4.64-14.27z" fill="#5e5e5e"/><path d="M951.7 263.92h-13.4l6.7-20.62zm-9.27-3h5.14l-2.57-7.9z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#v" transform="matrix(1,0,0,1,918.8518518518518,310.5068975759714) translate(0 14.222222222222223)"/><path d="M491.5 376.5h-3v-1.67h3zm-6.38-149l1.2.28 1.1.45 1 .62.9.76.75.9.62 1 .44 1.1.27 1.14.1 1.12V353.5h-3V234.98l-.06-.77-.16-.67-.27-.65-.36-.6-.46-.54-.54-.46-.6-.37-.65-.26-.64-.15-42.68-.08v-3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M491.5 378h-3v-1.54h3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M440.58 233.55l-14.26-4.63 14.26-4.64z" fill="#5e5e5e"/><path d="M442.08 235.62l-20.62-6.7 20.62-6.7zm-10.9-6.7l7.9 2.57v-5.15z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M492.82 375.18l.54.46.6.37.65.28.7.16.76.06h569.8v3H495.94l-1.1-.1-1.16-.26-1.1-.45-1-.63-.9-.76-.75-.9-.62-1-.23-.57h3.45zm-7.7-236.6l1.2.28 1.1.45 1 .63.9.76.75.9.62 1 .44 1.08.27 1.15.1 1.1.07 207.57h-3l-.07-207.44-.06-.76-.16-.7-.27-.64-.36-.6-.46-.54-.54-.46-.6-.37-.65-.28-.64-.15-102.66-.07v-3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1067.36 379.5h-1.54v-3h1.53z" fill="#5e5e5e"/><path d="M1067.38 379.52h-1.6v-3.04h1.6zm-1.54-3v2.96h1.5v-2.96z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M380.6 144.64L366.33 140l14.27-4.64z" fill="#5e5e5e"/><path d="M382.1 146.7l-20.62-6.7 20.62-6.7zm-10.9-6.7l7.9 2.57v-5.14z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#w" transform="matrix(1,0,0,1,458.91358024691357,353.49728803851696) translate(0 14.222222222222223)"/><path d="M245.13 287.93l-29.72.07-.76.06-.68.17-.65.27-.6.37-.53.45-.46.54-.36.6-.27.65-.15.65-.07 4.7-3-.05.07-5.02.3-1.2.44-1.08.62-1 .23-.28h36.1zm6.38-21.45h-3v-9h3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M251.5 257.5h-3v-1.53h3z" fill="#5e5e5e"/><path d="M251.54 257.53h-3.05v-1.6h3.04zm-3-1.54v1.48h2.95v-1.5z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M209.35 312.2l-4.64-14.28H214z" fill="#5e5e5e"/><path d="M209.35 317.04l-6.7-20.62h13.4zm-2.57-17.62l2.57 7.9 2.57-7.9z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#x" transform="matrix(1,0,0,1,204.70512267593506,266.4823013611441) translate(0 14.222222222222223)"/><path d="M178.68 492a6 6 0 0 1 6-6H1274a6 6 0 0 1 6 6v562a6 6 0 0 1-6 6H184.68a6 6 0 0 1-6-6z" fill="#e5e5e5"/><path d="M214.03 486.08h30.28m15.15 0h30.3m15.13 0h30.3m15.13 0l30.3-.02m15.14 0h30.28m15.14 0h30.3m15.13 0h30.28m15.14 0h30.28m15.15 0h30.28m15.14 0h30.3m15.13-.02h30.3m15.13 0H744m15.16 0h30.28m15.14 0h30.3m15.13 0h30.3m15.14 0h30.28m15.15 0l30.28-.02m15.14 0h30.28m15.14 0h30.3m15.13 0h30.28m15.15 0h30.28m15.14 0h30.3m15.13 0h30.3m15.13-.02H1274l.94.08.9.22.88.36.8.5.72.6.6.72.5.8.37.87.23.92v14.43m0 14.43v28.87m0 14.44v28.86m0 14.44l.02 28.87m0 14.44v28.87m0 14.44V722m0 14.45v28.87m0 14.43l.02 28.87m0 14.43v28.87m0 14.44v28.86m0 14.44v28.87m.02 14.43v28.87m0 14.43v28.87m0 14.44V1054l-.07.94-.22.9-.35.88-.5.8-.6.72-.72.6-.8.5-.88.37-.9.23h-15.15m-15.15 0h-30.28m-15.14 0h-30.3m-15.13 0h-30.3m-15.13 0h-30.28m-15.16 0h-30.28m-15.14 0l-30.3.02m-15.13 0h-30.3m-15.14 0h-30.28m-15.15 0h-30.28m-15.14 0h-30.28m-15.14 0h-30.3m-15.13 0h-30.28m-15.15.02h-30.28m-15.14 0h-30.3m-15.13 0h-30.3m-15.13 0h-30.28m-15.15 0h-30.27m-15.14 0h-30.3m-15.14 0l-30.28.02m-15.15 0h-30.28m-15.14 0h-30.28m-15.14 0h-30.3m-15.13 0h-30.28m-15.15 0h-15.14l-.94-.07-.9-.22-.88-.35-.8-.5-.72-.6-.6-.72-.5-.8-.37-.88-.22-.9v-14.45m0-14.43V997.2m0-14.43V953.9m0-14.44V910.6m-.02-14.44V867.3m0-14.44V824m0-14.44V780.7m0-14.45l-.02-28.86m0-14.45v-28.87m0-14.43v-28.87m0-14.43v-28.87m0-14.44v-28.87m0-14.43l-.02-28.87m0-14.43V492l.07-.93.22-.92.36-.87.5-.8.6-.72.72-.6.8-.5.88-.36.9-.22h15.15" stroke="#5e5e5e" stroke-width="3" fill="none"/><use xlink:href="#y" transform="matrix(1,0,0,1,183.6804313179104,491.0036524217976) translate(427.0185185185185 17.77777777777778)"/><use xlink:href="#z" transform="matrix(1,0,0,1,183.6804313179104,491.0036524217976) translate(524.4259259259259 17.77777777777778)"/><path d="M840.65 526a6 6 0 0 1 6-6h244.06a6 6 0 0 1 6 6v203.9a6 6 0 0 1-6 6H846.66a6 6 0 0 1-6-6z" fill="#f2f3f5"/><path d="M878.38 520.06h32.67m16.33 0l32.66-.02m16.34 0l32.66-.02m16.34 0h32.66m16.34-.02h16.33l.95.07.9.22.88.35.8.5.72.6.6.72.5.8.37.88.22.9v13.67m0 13.65l.02 27.32m0 13.64v27.3m.02 13.67v27.32m0 13.66l.02 27.3m0 13.67v13.65l-.06.94-.22.92-.36.87-.5.8-.6.72-.72.6-.8.5-.88.36-.9.23h-16.34m-16.34 0l-32.66.02m-16.34 0h-32.66m-16.34.02h-32.66m-16.34 0l-32.66.02m-16.34 0h-16.33l-.94-.07-.9-.22-.87-.35-.8-.5-.72-.6-.6-.72-.5-.8-.36-.87-.2-.92-.02-13.65m0-13.67v-27.3m-.02-13.67v-27.3m0-13.67l-.02-27.32m0-13.66l-.02-27.3m0-13.66V526l.07-.94.2-.9.38-.88.5-.8.6-.72.72-.6.8-.5.88-.37.9-.23h16.35" stroke="#5e5e5e" stroke-width="3" fill="none"/><use xlink:href="#A" transform="matrix(1,0,0,1,845.6511925390628,525) translate(66.75925925925927 14.222222222222221)"/><use xlink:href="#B" transform="matrix(1,0,0,1,845.6511925390628,525) translate(100.3395061728395 14.222222222222221)"/><path d="M1580 627.5c0 27.62-22.4 50-50 50s-50-22.38-50-50c0-27.6 22.4-50 50-50s50 22.4 50 50z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#C" transform="matrix(1,0,0,1,1485,582.5036524217976) translate(27.098765432098766 36.111111111111114)"/><use xlink:href="#D" transform="matrix(1,0,0,1,1485,582.5036524217976) translate(-5.524691358024697 62.77777777777778)"/><path d="M836.7 830.16a6 6 0 0 1 6-6h248a6 6 0 0 1 6 6v154.17a6 6 0 0 1-6 6h-248a6 6 0 0 1-6-6z" fill="#f2f3f5"/><path d="M869.43 824.23h27.66m13.82 0l27.66-.02m13.83 0h27.67m13.83 0l27.66-.02m13.83 0h27.65m13.83 0l13.83-.02.95.08.9.22.88.36.8.5.72.6.6.72.5.8.37.87.22.92v17.24m0 17.23l.03 34.46m0 17.23l.02 34.46m0 17.23v17.23l-.06.93-.22.92-.36.87-.5.8-.6.72-.72.6-.8.5-.88.36-.9.22h-13.84m-13.83 0l-27.67.02m-13.83 0h-27.66m-13.83 0l-27.65.02m-13.83 0h-27.66m-13.83 0l-27.66.02m-13.83 0H842.7l-.93-.07-.9-.22-.88-.36-.82-.5-.7-.6-.62-.72-.5-.8-.36-.87-.22-.92v-17.23m0-17.23l-.03-34.47m0-17.23l-.02-34.47m0-17.23l-.02-17.24.08-.94.22-.9.36-.88.5-.8.6-.72.72-.6.8-.5.88-.36.9-.22h13.84" stroke="#5e5e5e" stroke-width="3" fill="none"/><use xlink:href="#E" transform="matrix(1,0,0,1,841.7096700967577,829.1630142448691) translate(49.543209876543216 14.222222222222221)"/><use xlink:href="#F" transform="matrix(1,0,0,1,841.7096700967577,829.1630142448691) translate(115.61728395061728 14.222222222222221)"/><path d="M904.93 886a6 6 0 0 1 6-6h103a6 6 0 0 1 6 6v50.67a6 6 0 0 1-6 6h-103a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#G" transform="matrix(1,0,0,1,909.9304313179102,885) translate(7.611111111111121 20.84722222222222)"/><use xlink:href="#H" transform="matrix(1,0,0,1,909.9304313179102,885) translate(5.6851851851851976 42.18055555555556)"/><path d="M942.15 441.47l-136.1.03-.75.06-.7.16-.64.27-.6.36-.54.46-.46.54-.37.6-.28.65-.15.64-.07 460.03.06.77.16.68.27.65.36.6.46.54.54.47.6.37.65.27.64.16 77.6.07v3l-77.96-.07-1.2-.3-1.1-.44-1-.62-.9-.76-.75-.9-.62-1-.44-1.1-.27-1.13-.1-1.1.07-460.52.3-1.2.44-1.1.63-1 .76-.9.9-.75 1-.62 1.08-.44 1.15-.27 1.1-.1 136.22-.03zm198.17-7.4l-.1 1.1-.26 1.15-.45 1.1-.6 1-.77.9-.9.75-1 .62-1.1.44-1.2.3H1012.2v-3h121.4l.63-.16.66-.27.6-.36.54-.46.46-.54.36-.6.27-.65.16-.7.06-.76v-14.98h3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1140.32 419h-3v-1.54h3z" fill="#5e5e5e"/><path d="M1140.34 419.03h-3.05v-1.6h3.04zm-3-1.54v1.48h2.95v-1.5z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M898.6 911.33l-14.25 4.64v-9.27z" fill="#5e5e5e"/><path d="M903.47 911.33l-20.62 6.7v-13.4zm-17.62 2.57l7.9-2.57-7.9-2.57zM1359.95 629h-163.9l-.75.06-.7.17-.64.27-.6.37-.54.45-.46.54-.37.6-.28.65-.15.64-.07 268.56-.1 1.12-.26 1.14-.45 1.1-.63 1-.76.9-.9.76-1 .6-1.08.46-1.2.3-66.33.06v-3l65.96-.07.63-.15.64-.27.6-.37.54-.46.46-.53.37-.6.28-.67.16-.68.06-.76.07-268.8.3-1.22.44-1.08.63-1 .76-.9.9-.77 1-.6 1.08-.46 1.15-.28 1.1-.1h164.02zm117.05 0h-51.96v-3H1477z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1478.5 627.5l.05 1.5h-1.6v-3h1.62z" fill="#5e5e5e"/><path d="M1478.52 627.5l.06 1.53h-1.64v-3.05h1.66zm-1.53-1.47v2.95h1.53l-.06-1.5.08-1.45z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1117.3 911.88l-14.27-4.64 14.26-4.63z" fill="#5e5e5e"/><path d="M1118.8 913.94l-20.63-6.7 20.62-6.7zm-10.92-6.7l7.9 2.58v-5.15z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M486 67.17a6 6 0 0 1 6-6h118a6 6 0 0 1 6 6v48a6 6 0 0 1-6 6H492a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#q" transform="matrix(1,0,0,1,491.01376465124326,66.17031908846417) translate(25.4567901234568 14.222222222222221)"/><use xlink:href="#I" transform="matrix(1,0,0,1,491.01376465124326,66.17031908846417) translate(22.024691358024697 35.55555555555556)"/><path d="M1360 .5a6 6 0 0 1 6-6h208a6 6 0 0 1 6 6v168a6 6 0 0 1-6 6h-208a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#e5e5e5" fill-opacity=".48"/><use xlink:href="#J" transform="matrix(1,0,0,1,1365,-0.49634757820251707) translate(67.96296296296296 17.77777777777778)"/><path d="M1390 37.17a6 6 0 0 1 6-6h148a6 6 0 0 1 6 6v8a6 6 0 0 1-6 6h-148a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c3f7c8"/><use xlink:href="#K" transform="matrix(1,0,0,1,1395,36.17031908846417) translate(61.21604938271605 12.444444444444443)"/><path d="M1390 67.17a6 6 0 0 1 6-6h148a6 6 0 0 1 6 6v8a6 6 0 0 1-6 6h-148a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c1e4f7"/><use xlink:href="#L" transform="matrix(1,0,0,1,1395,66.17031908846417) translate(43.4783950617284 12.444444444444443)"/><path d="M1390 106a6 6 0 0 1 6-6h148a6 6 0 0 1 6 6v8a6 6 0 0 1-6 6h-148a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#M" transform="matrix(1,0,0,1,1395,105) translate(12.864197530864217 12.444444444444443)"/><use xlink:href="#N" transform="matrix(1,0,0,1,1395,105) translate(70.67901234567901 12.444444444444443)"/><path d="M608.68 75.5a6 6 0 0 1 6-6h108a6 6 0 0 1 6 6v51.34a6 6 0 0 1-6 6h-108a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c1e4f7"/><use xlink:href="#O" transform="matrix(1,0,0,1,613.6804313179102,74.50365242179751) translate(7.53086419753086 21.15277777777778)"/><use xlink:href="#P" transform="matrix(1,0,0,1,613.6804313179102,74.50365242179751) translate(11.23456790123457 47.81944444444444)"/><path d="M670.18 189.1h-3v-22.6h3zm0-43.93h-3v-9.37h3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M670.18 135.84h-3v-1.54h3z" fill="#5e5e5e"/><path d="M670.2 135.86h-3.04v-1.58h3.05zm-3-1.53v1.48h2.96v-1.48z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M668.68 204.85l-4.63-14.26h9.27z" fill="#5e5e5e"/><path d="M668.68 209.7l-6.7-20.6h13.4zm-2.57-17.6l2.58 7.9 2.57-7.9z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#Q" transform="matrix(1,0,0,1,630.2112955154411,145.16535433070916) translate(0 14.222222222222223)"/><path d="M880 57.17a6 6 0 0 1 6-6h118a6 6 0 0 1 6 6v48a6 6 0 0 1-6 6H886a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#q" transform="matrix(1,0,0,1,885,56.17031908846417) translate(25.4567901234568 17.34722222222222)"/><use xlink:href="#R" transform="matrix(1,0,0,1,885,56.17031908846417) translate(23.555555555555557 38.68055555555556)"/><path d="M780 75.5a6 6 0 0 1 6-6h108a6 6 0 0 1 6 6v51.34a6 6 0 0 1-6 6H786a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c1e4f7"/><use xlink:href="#S" transform="matrix(1,0,0,1,785,74.50365242179754) translate(9.444444444444436 21.15277777777778)"/><use xlink:href="#T" transform="matrix(1,0,0,1,785,74.50365242179754) translate(11.23456790123457 47.81944444444444)"/><path d="M841.5 190.25h-3v-18.42h3zm0-39.75h-3v-14.7h3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M841.5 135.84h-3v-1.54h3z" fill="#5e5e5e"/><path d="M841.52 135.86h-3.04v-1.58h3.04zm-3-1.53v1.48h2.96v-1.48z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M840 206.02l-4.64-14.27h9.28z" fill="#5e5e5e"/><path d="M840 210.87l-6.7-20.62h13.4zm-2.57-17.62l2.57 7.92 2.57-7.92z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#Q" transform="matrix(1,0,0,1,801.5308641975308,150.49868766404242) translate(0 14.222222222222223)"/><path d="M900 566a6 6 0 0 1 6-6h156.82a6 6 0 0 1 6 6v50.67a6 6 0 0 1-6 6H906a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#U" transform="matrix(1,0,0,1,905,565) translate(35.59876543209878 20.84722222222222)"/><use xlink:href="#V" transform="matrix(1,0,0,1,905,565) translate(37.57407407407408 42.18055555555556)"/><g transform="matrix(1,0,0,1,905,565)"><a xlink:href="http://Kuadrant.io" target="_blank"><path class="lucid-link lucid-hotspot lucid-overlay-hotspot" fill-opacity="0" d="M35.6 6.63h8.9v21.33h-8.9z"/></a><a xlink:href="http://Kuadrant.io" target="_blank"><path class="lucid-link lucid-hotspot lucid-overlay-hotspot" fill-opacity="0" d="M44.5 6.63h78.9v21.33H44.5z"/></a></g><path d="M900 646a6 6 0 0 1 6-6h156.82a6 6 0 0 1 6 6v62a6 6 0 0 1-6 6H906a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><use xlink:href="#W" transform="matrix(1,0,0,1,905,645) translate(35.59876543209878 26.22222222222222)"/><use xlink:href="#X" transform="matrix(1,0,0,1,905,645) translate(18.413580246913604 47.55555555555555)"/><path d="M1359.95 629H1118.8v-3h241.15zm117.05 0h-51.96v-3H1477z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1478.5 627.5l.05 1.5h-1.6v-3h1.62z" fill="#5e5e5e"/><path d="M1478.52 627.5l.06 1.53h-1.64v-3.05h1.66zm-1.53-1.47v2.95h1.53l-.06-1.5.08-1.45z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1117.3 632.14l-14.27-4.64 14.26-4.63z" fill="#5e5e5e"/><path d="M1118.8 634.2l-20.63-6.7 20.62-6.7zm-10.92-6.7l7.9 2.57v-5.14z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#Y" transform="matrix(1,0,0,1,1359.9517358090638,616.836985755131) translate(0 14.222222222222223)"/><path d="M942.15 441.5h-136.1l-.75.06-.7.16-.64.27-.6.36-.54.46-.46.54-.37.6-.28.65-.15.64-.07 225.7.06.76.16.7.27.64.36.6.46.54.54.46.6.37.65.28.64.15 72.68.07v3l-73.04-.07-1.2-.3-1.1-.44-1-.63-.9-.76-.75-.9-.62-1-.44-1.08-.27-1.15-.1-1.1.07-226.2.3-1.2.44-1.08.63-1 .76-.9.9-.77 1-.62 1.08-.44 1.15-.27 1.1-.1h136.22zm174.13 0h-104.1v-3h104.1z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1117.78 441.5h-1.54v-3h1.54z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M893.68 677l-14.26 4.64v-9.28z" fill="#5e5e5e"/><path d="M898.54 677l-20.62 6.7v-13.4zm-17.62 2.57l7.9-2.57-7.9-2.57z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#Z" transform="matrix(1,0,0,1,942.1514821367849,429.3333333333333) translate(0 14.222222222222223)"/><path d="M651.57 964.76l.15.63.27.64.36.6.46.54.54.46.6.37.65.28.7.16.76.06 301.13-.07.62-.15.65-.27.6-.36.54-.46.47-.54.37-.6.27-.65.17-.7.06-.76v-18.3h3v18.42l-.1 1.1-.26 1.16-.45 1.1-.62 1-.76.9-.9.75-1 .62-1.1.44-1.2.3-301.6.06-1.1-.1-1.16-.26-1.1-.45-1-.63-.9-.76-.75-.9-.62-1-.44-1.08-.3-1.2-.05-299.47h3zm-354.95-576l1.2.27 1.1.45 1 .62.9.76.75.9.62 1 .44 1.1.27 1.14.1 1.1.1 217.16.14.63.27.64.38.6.45.54.54.46.6.37.65.28.7.16.75.06 337.55.08 1.2.3 1.1.44 1 .6.9.78.75.9.62 1 .44 1.08.27 1.15.1 1.1v19.88h-3v-19.74l-.06-.76-.16-.7-.27-.64-.36-.6-.46-.54-.54-.45-.6-.37-.65-.27-.64-.15-337.3-.08-1.12-.08-1.15-.28-1.1-.45-1-.62-.9-.77-.76-.9-.6-1-.46-1.08-.3-1.2-.08-217.4-.06-.75-.16-.7-.27-.64-.36-.6-.46-.54-.54-.47-.6-.37-.65-.27-.64-.16-14.17-.07v-3z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M963.93 945.67h-3v-1.54h3z" fill="#5e5e5e"/><path d="M963.96 945.7h-3.05v-1.6h3.06zm-3-1.54v1.48h2.95v-1.5z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M280.6 394.8l-14.27-4.63 14.27-4.63z" fill="#5e5e5e"/><path d="M282.1 396.87l-20.62-6.7 20.62-6.7zm-10.9-6.7l7.9 2.57v-5.14z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#aa" transform="matrix(1,0,0,1,613.5555555555555,644.3139320071568) translate(0 14.222222222222223)"/><path d="M566.1 372.82l.16.72.3.73.4.67.52.6.6.5.67.4.72.3.76.2.82.06h495.3v2H570.98l-1.05-.08-1.07-.26-1.02-.42-.93-.57-.84-.72-.7-.83-.6-.94-.4-1.02-.27-1.1-.02-16.72h2zm-.04-37.8h-2L564 261.8h2z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1067.36 379h-1.03v-2h1.02z" fill="#5e5e5e"/><path d="M1067.38 379.02h-1.07v-2.04h1.08zm-1.02-2v1.96h.97v-1.96z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M569.65 260.8h-9.27l4.63-14.26z" fill="#5e5e5e"/><path d="M571.03 261.8H559l6-18.5zm-9.28-2h6.52L565 249.77z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><use xlink:href="#v" transform="matrix(1,0,0,1,538.8656165030956,335.0105709064862) translate(0 14.222222222222223)"/><path d="M942.15 440.97l-136.1.03-.83.06-.76.2-.73.3-.67.4-.6.5-.5.6-.4.67-.3.73-.2.72-.06 140.1.06.84.2.76.3.72.4.67.5.6.6.5.67.42.73.3.72.16 74.86.07v2l-75.1-.07-1.1-.27-1.02-.43-.94-.57-.83-.7-.72-.85-.57-.94-.42-1-.26-1.07-.08-1.06.07-140.43.27-1.1.42-1.02.57-.94.72-.83.83-.72.94-.57 1.02-.42 1.06-.26 1.06-.08 136.2-.03zm197.67-6.93l-.08 1.06-.26 1.06-.42 1.02-.57.94-.73.83-.83.72-.94.57-1.02.42-1.1.27-121.7.02v-2l121.46-.02.72-.18.73-.3.66-.4.6-.52.5-.6.4-.66.3-.73.2-.76.06-.82v-15.5h2z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1139.82 418.5h-2v-1.04h2z" fill="#5e5e5e"/><path d="M1139.84 418.5h-2.05v-1.06h2.04zm-2-1v.96h1.95v-.97z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M895.3 591.33l-14.27 4.64v-9.27z" fill="#5e5e5e"/><path d="M898.54 591.33l-18.5 6.02v-12.03zm-16.5 3.26l10.02-3.27-10.03-3.26z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1140 306a6 6 0 0 1 6-6h118a6 6 0 0 1 6 6v48a6 6 0 0 1-6 6h-118a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#fff"/><g><use xlink:href="#ab" transform="matrix(1,0,0,1,1145,305) translate(23.975308641975317 29.84722222222222)"/></g><path d="M1068.82 346a6 6 0 0 1 6-6h128a6 6 0 0 1 6 6v64a6 6 0 0 1-6 6h-128a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#c1e4f7"/><g><use xlink:href="#ac" transform="matrix(1,0,0,1,1073.8195686820898,345) translate(19.96913580246914 24.05902777777778)"/><use xlink:href="#P" transform="matrix(1,0,0,1,1073.8195686820898,345) translate(21.23456790123457 50.72569444444445)"/></g><path d="M1051.07 372.82l.18.72.3.73.4.67.52.6.6.5.66.4.73.3.76.2.82.06h10.32v2h-10.4l-1.06-.08-1.06-.26-1.02-.42-.94-.57-.83-.72-.72-.83-.57-.94-.42-1.02-.27-1.1V339.5h2zm-6-292.58l1.1.27 1 .43.95.57.83.72.72.83.57.94.42 1 .26 1.07.08 1.06.06 231.04h-2L1049 87.2l-.06-.8-.2-.77-.3-.73-.4-.67-.5-.6-.6-.5-.67-.4-.73-.3-.72-.2-14.86-.06v-2z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1067.36 379h-1.03v-2h1.02z" fill="#5e5e5e"/><path d="M1067.38 379.02h-1.07v-2.04h1.08zm-1.02-2v1.96h.97v-1.96z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1028.97 85.8l-14.27-4.63 14.27-4.63z" fill="#5e5e5e"/><path d="M1029.97 87.18l-18.5-6 18.5-6.02zm-12.03-6l10.03 3.25V77.9z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1051.07 372.82l.18.72.3.73.4.67.52.6.6.5.66.4.73.3.76.2.82.06h10.32v2h-10.4l-1.06-.08-1.06-.26-1.02-.42-.94-.57-.83-.72-.72-.83-.57-.94-.42-1.02-.27-1.1V339.5h2zm-6-354.04l1.1.27 1 .42.95.57.83.72.72.83.57.93.42 1 .26 1.08.08 1.07.06 292.5h-2L1049 25.75l-.06-.82-.2-.77-.3-.72-.4-.67-.5-.6-.6-.5-.67-.42-.73-.3-.72-.17-487.77-.07-.82.07-.76.18-.72.3-.67.4-.6.52-.5.6-.42.67-.3.72-.17.73-.1 16.3h-2l.1-16.55.25-1.1.42-1.02.58-.94.7-.84.85-.72.93-.57 1.02-.42 1.07-.26 1.05-.1z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M1067.36 379h-1.03v-2h1.02z" fill="#5e5e5e"/><path d="M1067.38 379.02h-1.07v-2.04h1.08zm-1.02-2v1.96h.97v-1.96z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M551 56.47L546.4 42.2h9.27z" fill="#5e5e5e"/><path d="M551 59.7l-6-18.5h12.03zm-3.25-16.5L551 53.24l3.27-10.02z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><g><use xlink:href="#Q" transform="matrix(1,0,0,1,1011.5308641975308,318.1722221444755) translate(0 14.222222222222223)"/></g><path d="M969.68 804.2h-2v-19.03h2zm0-40.37h-2v-25.46h2z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M969.68 738.4h-2v-1.03h2z" fill="#5e5e5e"/><path d="M969.7 738.42h-2.04v-1.08h2.05zm-2-1.03v.97h1.96v-.98z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><path d="M968.68 819.46l-4.63-14.26h9.27z" fill="#5e5e5e"/><path d="M968.68 822.7l-6-18.5h12zm-3.26-16.5l3.26 10.03 3.26-10.03z" stroke="#5e5e5e" stroke-width=".05" fill="#5e5e5e"/><g><use xlink:href="#ad" transform="matrix(1,0,0,1,905.1495672093286,763.8320209973762) translate(0 14.222222222222223)"/></g><path d="M1390 138.84a6 6 0 0 1 6-6h148a6 6 0 0 1 6 6v8a6 6 0 0 1-6 6h-148a6 6 0 0 1-6-6z" stroke="#5e5e5e" stroke-width="3" fill="#979ea8"/><g><use xlink:href="#ae" transform="matrix(1,0,0,1,1395,137.83698575513085) translate(20.14506172839507 12.444444444444443)"/></g><defs><path fill="#333" d="M140-251c81 0 123 46 123 126C263-46 219 4 140 4 59 4 17-45 17-125s42-126 123-126zm0 227c63 0 89-41 89-101s-29-99-89-99c-61 0-89 39-89 99S79-25 140-24" id="af"/><path fill="#333" d="M185-189c-5-48-123-54-124 2 14 75 158 14 163 119 3 78-121 87-175 55-17-10-28-26-33-46l33-7c5 56 141 63 141-1 0-78-155-14-162-118-5-82 145-84 179-34 5 7 8 16 11 25" id="ag"/><g id="a"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#af"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,17.28395061728395,0)" xlink:href="#ag"/></g><path fill="#333" d="M115-194c55 1 70 41 70 98S169 2 115 4C84 4 66-9 55-30l1 105H24l-1-265h31l2 30c10-21 28-34 59-34zm-8 174c40 0 45-34 45-75s-6-73-45-74c-42 0-51 32-51 76 0 43 10 73 51 73" id="ah"/><path fill="#333" d="M106-169C34-169 62-67 57 0H25v-261h32l-1 103c12-21 28-36 61-36 89 0 53 116 60 194h-32v-121c2-32-8-49-39-48" id="ai"/><path fill="#333" d="M179-190L93 31C79 59 56 82 12 73V49c39 6 53-20 64-50L1-190h34L92-34l54-156h33" id="aj"/><path fill="#333" d="M135-143c-3-34-86-38-87 0 15 53 115 12 119 90S17 21 10-45l28-5c4 36 97 45 98 0-10-56-113-15-118-90-4-57 82-63 122-42 12 7 21 19 24 35" id="ak"/><path fill="#333" d="M24-231v-30h32v30H24zM24 0v-190h32V0H24" id="al"/><path fill="#333" d="M96-169c-40 0-48 33-48 73s9 75 48 75c24 0 41-14 43-38l32 2c-6 37-31 61-74 61-59 0-76-41-82-99-10-93 101-131 147-64 4 7 5 14 7 22l-32 3c-4-21-16-35-41-35" id="am"/><path fill="#333" d="M141-36C126-15 110 5 73 4 37 3 15-17 15-53c-1-64 63-63 125-63 3-35-9-54-41-54-24 1-41 7-42 31l-33-3c5-37 33-52 76-52 45 0 72 20 72 64v82c-1 20 7 32 28 27v20c-31 9-61-2-59-35zM48-53c0 20 12 33 32 33 41-3 63-29 60-74-43 2-92-5-92 41" id="an"/><path fill="#333" d="M24 0v-261h32V0H24" id="ao"/><g id="b"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#ah"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,12.345679012345679,0)" xlink:href="#ai"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,24.691358024691358,0)" xlink:href="#aj"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,35.80246913580247,0)" xlink:href="#ak"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,46.91358024691358,0)" xlink:href="#al"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,51.79012345679013,0)" xlink:href="#am"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,62.90123456790124,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,75.24691358024693,0)" xlink:href="#ao"/></g><path fill="#333" d="M212-179c-10-28-35-45-73-45-59 0-87 40-87 99 0 60 29 101 89 101 43 0 62-24 78-52l27 14C228-24 195 4 139 4 59 4 22-46 18-125c-6-104 99-153 187-111 19 9 31 26 39 46" id="ap"/><path fill="#333" d="M84 4C-5 8 30-112 23-190h32v120c0 31 7 50 39 49 72-2 45-101 50-169h31l1 190h-30c-1-10 1-25-2-33-11 22-28 36-60 37" id="aq"/><path fill="#333" d="M59-47c-2 24 18 29 38 22v24C64 9 27 4 27-40v-127H5v-23h24l9-43h21v43h35v23H59v120" id="ar"/><path fill="#333" d="M100-194c63 0 86 42 84 106H49c0 40 14 67 53 68 26 1 43-12 49-29l28 8c-11 28-37 45-77 45C44 4 14-33 15-96c1-61 26-98 85-98zm52 81c6-60-76-77-97-28-3 7-6 17-6 28h103" id="as"/><path fill="#333" d="M114-163C36-179 61-72 57 0H25l-1-190h30c1 12-1 29 2 39 6-27 23-49 58-41v29" id="at"/><g id="c"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#ap"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,15.987654320987653,0)" xlink:href="#ao"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,20.864197530864196,0)" xlink:href="#aq"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,33.20987654320987,0)" xlink:href="#ak"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,44.32098765432099,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,50.49382716049383,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,62.839506172839506,0)" xlink:href="#at"/></g><path fill="#333" d="M210-169c-67 3-38 105-44 169h-31v-121c0-29-5-50-35-48C34-165 62-65 56 0H25l-1-190h30c1 10-1 24 2 32 10-44 99-50 107 0 11-21 27-35 58-36 85-2 47 119 55 194h-31v-121c0-29-5-49-35-48" id="au"/><path fill="#333" d="M117-194c89-4 53 116 60 194h-32v-121c0-31-8-49-39-48C34-167 62-67 57 0H25l-1-190h30c1 10-1 24 2 32 11-22 29-35 61-36" id="av"/><path fill="#333" d="M177-190C167-65 218 103 67 71c-23-6-38-20-44-43l32-5c15 47 100 32 89-28v-30C133-14 115 1 83 1 29 1 15-40 15-95c0-56 16-97 71-98 29-1 48 16 59 35 1-10 0-23 2-32h30zM94-22c36 0 50-32 50-73 0-42-14-75-50-75-39 0-46 34-46 75s6 73 46 73" id="aw"/><path fill="#333" d="M85-194c31 0 48 13 60 33l-1-100h32l1 261h-30c-2-10 0-23-3-31C134-8 116 4 85 4 32 4 16-35 15-94c0-66 23-100 70-100zm9 24c-40 0-46 34-46 75 0 40 6 74 45 74 42 0 51-32 51-76 0-42-9-74-50-73" id="ax"/><g id="d"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#au"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,18.456790123456788,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,30.80246913580247,0)" xlink:href="#av"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,43.148148148148145,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,55.49382716049382,0)" xlink:href="#aw"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,67.8395061728395,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,80.18518518518519,0)" xlink:href="#ax"/></g><g id="e"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#av"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,12.345679012345679,0)" xlink:href="#ak"/></g><path fill="#333" d="M33 0v-248h34V0H33" id="ay"/><path fill="#333" d="M100-194c62-1 85 37 85 99 1 63-27 99-86 99S16-35 15-95c0-66 28-99 85-99zM99-20c44 1 53-31 53-75 0-43-8-75-51-75s-53 32-53 75 10 74 51 75" id="az"/><g id="f"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#ay"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,4.93827160493827,0)" xlink:href="#ak"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,13.827160493827158,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,18.76543209876543,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,22.666666666666664,0)" xlink:href="#az"/></g><path fill="#333" d="M205 0l-28-72H64L36 0H1l101-248h38L239 0h-34zm-38-99l-47-123c-12 45-31 82-46 123h93" id="aA"/><path fill="#333" d="M30-248c87 1 191-15 191 75 0 78-77 80-158 76V0H30v-248zm33 125c57 0 124 11 124-50 0-59-68-47-124-48v98" id="aB"/><g id="g"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aA"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,11.85185185185185,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,21.728395061728392,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,26.666666666666668,0)" xlink:href="#ai"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,36.5432098765432,0)" xlink:href="#aB"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,48.39506172839505,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,58.271604938271594,0)" xlink:href="#ao"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,62.17283950617283,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,66.07407407407406,0)" xlink:href="#am"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,74.96296296296295,0)" xlink:href="#aj"/></g><path fill="#333" d="M87 75C49 33 22-17 22-94c0-76 28-126 65-167h31c-38 41-64 92-64 168S80 34 118 75H87" id="aC"/><path fill="#333" d="M33-261c38 41 65 92 65 168S71 34 33 75H2C39 34 66-17 66-93S39-220 2-261h31" id="aD"/><g id="h"><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,0,0)" xlink:href="#aC"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,2.93827160493827,0)" xlink:href="#an"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,7.87654320987654,0)" xlink:href="#aq"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,12.814814814814808,0)" xlink:href="#ar"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,15.28395061728394,0)" xlink:href="#ai"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,20.22222222222221,0)" xlink:href="#aD"/></g><path fill="#333" d="M266 0h-40l-56-210L115 0H75L2-248h35L96-30l15-64 43-154h32l59 218 59-218h35" id="aE"/><path fill="#333" d="M240 0l2-218c-23 76-54 145-80 218h-23L58-218 59 0H30v-248h44l77 211c21-75 51-140 76-211h43V0h-30" id="aF"/><g id="i"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aE"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,16.098765432098762,0)" xlink:href="#aA"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,27.950617283950614,0)" xlink:href="#ag"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,39.80246913580246,0)" xlink:href="#aF"/></g><g id="j"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aB"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,11.85185185185185,0)" xlink:href="#ao"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,15.753086419753084,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,25.629629629629626,0)" xlink:href="#aw"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,35.50617283950616,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,39.4074074074074,0)" xlink:href="#av"/></g><g id="k"><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,0,0)" xlink:href="#aC"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,2.93827160493827,0)" xlink:href="#at"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,5.87654320987654,0)" xlink:href="#an"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,10.81481481481481,0)" xlink:href="#ar"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,13.283950617283946,0)" xlink:href="#as"/></g><g id="l"><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,0,0)" xlink:href="#ao"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,1.9506172839506162,0)" xlink:href="#al"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,3.9012345679012324,0)" xlink:href="#au"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,11.283950617283944,0)" xlink:href="#al"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,13.23456790123456,0)" xlink:href="#ar"/><use transform="matrix(0.024691358024691343,0,0,0.024691358024691343,15.703703703703694,0)" xlink:href="#aD"/></g><g id="m"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#ay"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,6.172839506172839,0)" xlink:href="#ak"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,17.28395061728395,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,23.456790123456788,0)" xlink:href="#al"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,28.33333333333333,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,40.679012345679006,0)" xlink:href="#ax"/></g><g id="n"><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,0,0)" xlink:href="#ay"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,5.5555555555555545,0)" xlink:href="#ak"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,15.555555555555554,0)" xlink:href="#ar"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,21.111111111111107,0)" xlink:href="#al"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,25.499999999999996,0)" xlink:href="#az"/></g><g id="o"><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,0,0)" xlink:href="#ay"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,5.5555555555555545,0)" xlink:href="#av"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,16.666666666666664,0)" xlink:href="#aw"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,27.77777777777777,0)" xlink:href="#at"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,34.38888888888888,0)" xlink:href="#as"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,45.499999999999986,0)" xlink:href="#ak"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,55.499999999999986,0)" xlink:href="#ak"/></g><path fill="#333" d="M143 4C61 4 22-44 18-125c-5-107 100-154 193-111 17 8 29 25 37 43l-32 9c-13-25-37-40-76-40-61 0-88 39-88 99 0 61 29 100 91 101 35 0 62-11 79-27v-45h-74v-28h105v86C228-13 192 4 143 4" id="aG"/><path fill="#333" d="M206 0h-36l-40-164L89 0H53L-1-190h32L70-26l43-164h34l41 164 42-164h31" id="aH"/><g id="p"><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,0,0)" xlink:href="#aG"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,15.555555555555554,0)" xlink:href="#an"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,26.666666666666664,0)" xlink:href="#ar"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,32.22222222222222,0)" xlink:href="#as"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,43.33333333333333,0)" xlink:href="#aH"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,57.722222222222214,0)" xlink:href="#an"/><use transform="matrix(0.055555555555555546,0,0,0.055555555555555546,68.83333333333333,0)" xlink:href="#aj"/></g><path fill="#333" d="M143 0L79-87 56-68V0H24v-261h32v163l83-92h37l-77 82L181 0h-38" id="aI"/><g id="q"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aI"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,8.888888888888888,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,18.76543209876543,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,28.64197530864197,0)" xlink:href="#ax"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,38.51851851851851,0)" xlink:href="#at"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,44.395061728395056,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,54.271604938271594,0)" xlink:href="#av"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,64.14814814814814,0)" xlink:href="#ar"/></g><path fill="#333" d="M101-234c-31-9-42 10-38 44h38v23H63V0H32v-167H5v-23h27c-7-52 17-82 69-68v24" id="aJ"/><g id="r"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aA"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,11.85185185185185,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,21.728395061728392,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,26.666666666666668,0)" xlink:href="#ai"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,36.5432098765432,0)" xlink:href="#ap"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,49.33333333333332,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,59.20987654320985,0)" xlink:href="#av"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,69.0864197530864,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,72.98765432098763,0)" xlink:href="#aJ"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,77.9259259259259,0)" xlink:href="#aw"/></g><g id="s"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#aA"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,14.814814814814813,0)" xlink:href="#aq"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,27.160493827160494,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,33.333333333333336,0)" xlink:href="#ai"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,45.67901234567901,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,58.02469135802469,0)" xlink:href="#at"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,65.37037037037037,0)" xlink:href="#al"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,70.24691358024691,0)" xlink:href="#av"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,82.5925925925926,0)" xlink:href="#az"/></g><path fill="#333" d="M233-177c-1 41-23 64-60 70L243 0h-38l-65-103H63V0H30v-248c88 3 205-21 203 71zM63-129c60-2 137 13 137-47 0-61-80-42-137-45v92" id="aK"/><path fill="#333" d="M30 0v-248h33v221h125V0H30" id="aL"/><g id="t"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aK"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,12.790123456790122,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,22.666666666666664,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,27.60493827160494,0)" xlink:href="#as"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,37.48148148148148,0)" xlink:href="#aL"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,47.358024691358025,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,51.25925925925926,0)" xlink:href="#au"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,66.02469135802468,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,69.92592592592591,0)" xlink:href="#ar"/></g><g id="u"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#aL"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,12.345679012345679,0)" xlink:href="#al"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,17.22222222222222,0)" xlink:href="#au"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,35.67901234567901,0)" xlink:href="#al"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,40.55555555555556,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,46.7283950617284,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,59.074074074074076,0)" xlink:href="#ax"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,71.41975308641976,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,83.76543209876544,0)" xlink:href="#at"/></g><path fill="#333" d="M190-63c-7 42-38 67-86 67-59 0-84-38-90-98-12-110 154-137 174-36l-49 2c-2-19-15-32-35-32-30 0-35 28-38 64-6 74 65 87 74 30" id="aM"/><path fill="#333" d="M135-150c-39-12-60 13-60 57V0H25l-1-190h47c2 13-1 29 3 40 6-28 27-53 61-41v41" id="aN"/><path fill="#333" d="M185-48c-13 30-37 53-82 52C43 2 14-33 14-96s30-98 90-98c62 0 83 45 84 108H66c0 31 8 55 39 56 18 0 30-7 34-22zm-45-69c5-46-57-63-70-21-2 6-4 13-4 21h74" id="aO"/><path fill="#333" d="M133-34C117-15 103 5 69 4 32 3 11-16 11-54c-1-60 55-63 116-61 1-26-3-47-28-47-18 1-26 9-28 27l-52-2c7-38 36-58 82-57s74 22 75 68l1 82c-1 14 12 18 25 15v27c-30 8-71 5-69-32zm-48 3c29 0 43-24 42-57-32 0-66-3-65 30 0 17 8 27 23 27" id="aP"/><path fill="#333" d="M115-3C79 11 28 4 28-45v-112H4v-33h27l15-45h31v45h36v33H77v99c-1 23 16 31 38 25v30" id="aQ"/><g id="v"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aM"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,9.876543209876544,0)" xlink:href="#aN"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,16.790123456790127,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,26.666666666666668,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,36.543209876543216,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,42.41975308641976,0)" xlink:href="#aO"/></g><path fill="#333" d="M137-138c1-29-70-34-71-4 15 46 118 7 119 86 1 83-164 76-172 9l43-7c4 19 20 25 44 25 33 8 57-30 24-41C81-84 22-81 20-136c-2-80 154-74 161-7" id="aR"/><g id="w"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aM"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,9.876543209876544,0)" xlink:href="#aN"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,16.790123456790127,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,26.666666666666668,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,36.543209876543216,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,42.41975308641976,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,52.2962962962963,0)" xlink:href="#aR"/></g><path fill="#333" d="M110-194c64 0 96 36 96 99 0 64-35 99-97 99-61 0-95-36-95-99 0-62 34-99 96-99zm-1 164c35 0 45-28 45-65 0-40-10-65-43-65-34 0-45 26-45 65 0 36 10 65 43 65" id="aS"/><path fill="#333" d="M135-194c87-1 58 113 63 194h-50c-7-57 23-157-34-157-59 0-34 97-39 157H25l-1-190h47c2 12-1 28 3 38 12-26 28-41 61-42" id="aT"/><path fill="#333" d="M121-226c-27-7-43 5-38 36h38v33H83V0H34v-157H6v-33h28c-9-59 32-81 87-68v32" id="aU"/><path fill="#333" d="M25-224v-37h50v37H25zM25 0v-190h50V0H25" id="aV"/><path fill="#333" d="M195-6C206 82 75 100 31 46c-4-6-6-13-8-21l49-6c3 16 16 24 34 25 40 0 42-37 40-79-11 22-30 35-61 35-53 0-70-43-70-97 0-56 18-96 73-97 30 0 46 14 59 34l2-30h47zm-90-29c32 0 41-27 41-63 0-35-9-62-40-62-32 0-39 29-40 63 0 36 9 62 39 62" id="aW"/><path fill="#333" d="M85 4C-2 5 27-109 22-190h50c7 57-23 150 33 157 60-5 35-97 40-157h50l1 190h-47c-2-12 1-28-3-38-12 25-28 42-61 42" id="aX"/><g id="x"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aM"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,9.876543209876544,0)" xlink:href="#aS"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,20.69135802469136,0)" xlink:href="#aT"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,31.506172839506174,0)" xlink:href="#aU"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,37.38271604938272,0)" xlink:href="#aV"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,42.320987654320994,0)" xlink:href="#aW"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,53.135802469135804,0)" xlink:href="#aX"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,63.95061728395062,0)" xlink:href="#aN"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,70.8641975308642,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,80.74074074074075,0)" xlink:href="#aR"/></g><g id="y"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#am"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,11.11111111111111,0)" xlink:href="#aq"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,23.45679012345679,0)" xlink:href="#ak"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,34.5679012345679,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,40.74074074074074,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,53.08641975308642,0)" xlink:href="#au"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,71.5432098765432,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,83.88888888888889,0)" xlink:href="#at"/></g><g id="z"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#av"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,12.345679012345679,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,24.691358024691358,0)" xlink:href="#au"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,43.148148148148145,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,55.49382716049382,0)" xlink:href="#ak"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,66.60493827160494,0)" xlink:href="#ah"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,78.95061728395062,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,91.2962962962963,0)" xlink:href="#am"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,102.40740740740742,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,114.7530864197531,0)" xlink:href="#aC"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,122.09876543209879,0)" xlink:href="#ak"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,133.2098765432099,0)" xlink:href="#aD"/></g><g id="A"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aA"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,11.85185185185185,0)" xlink:href="#aB"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,23.7037037037037,0)" xlink:href="#ay"/></g><g id="B"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aB"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,11.85185185185185,0)" xlink:href="#at"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,17.728395061728392,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,27.604938271604933,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,32.5432098765432,0)" xlink:href="#as"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,42.419753086419746,0)" xlink:href="#am"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,51.30864197530863,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,56.246913580246904,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,60.14814814814814,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,70.02469135802468,0)" xlink:href="#av"/></g><g id="C"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#aA"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,14.814814814814813,0)" xlink:href="#aB"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,29.629629629629626,0)" xlink:href="#ay"/></g><path fill="#333" d="M30-248c118-7 216 8 213 122C240-48 200 0 122 0H30v-248zM63-27c89 8 146-16 146-99s-60-101-146-95v194" id="aY"/><path fill="#333" d="M108 0H70L1-190h34L89-25l56-165h34" id="aZ"/><g id="D"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#aY"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,15.987654320987653,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,28.333333333333332,0)" xlink:href="#aZ"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,39.44444444444444,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,51.79012345679012,0)" xlink:href="#ao"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,56.666666666666664,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,69.01234567901234,0)" xlink:href="#ah"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,81.35802469135803,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,93.70370370370371,0)" xlink:href="#at"/></g><g id="E"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aK"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,12.790123456790122,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,22.666666666666664,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,32.5432098765432,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,37.481481481481474,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,41.38271604938271,0)" xlink:href="#av"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,51.25925925925925,0)" xlink:href="#aw"/></g><g id="F"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aK"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,12.790123456790122,0)" xlink:href="#as"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,22.666666666666664,0)" xlink:href="#ak"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,31.55555555555555,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,41.43209876543209,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,51.30864197530863,0)" xlink:href="#at"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,57.185185185185176,0)" xlink:href="#am"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,66.07407407407406,0)" xlink:href="#as"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,75.9506172839506,0)" xlink:href="#ak"/></g><g id="G"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aw"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,9.87654320987654,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,19.75308641975308,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,24.691358024691354,0)" xlink:href="#as"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,34.5679012345679,0)" xlink:href="#aH"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,47.35802469135802,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,57.234567901234556,0)" xlink:href="#aj"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,66.12345679012344,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,75.99999999999999,0)" xlink:href="#ah"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,85.87654320987653,0)" xlink:href="#al"/></g><path fill="#333" d="M197 0v-115H63V0H30v-248h33v105h134v-105h34V0h-34" id="ba"/><path fill="#333" d="M127-220V0H93v-220H8v-28h204v28h-85" id="bb"/><g id="H"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#ba"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,12.790123456790122,0)" xlink:href="#bb"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,23.604938271604937,0)" xlink:href="#bb"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,34.419753086419746,0)" xlink:href="#aB"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,46.271604938271594,0)" xlink:href="#aK"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,59.061728395061714,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,68.93827160493825,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,78.8148148148148,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,83.75308641975306,0)" xlink:href="#as"/></g><g id="I"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aA"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,11.85185185185185,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,21.728395061728392,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,26.666666666666668,0)" xlink:href="#ai"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,36.5432098765432,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,46.419753086419746,0)" xlink:href="#at"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,52.29629629629628,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,56.19753086419752,0)" xlink:href="#av"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,66.07407407407406,0)" xlink:href="#az"/></g><g id="J"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#aL"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,12.345679012345679,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,24.691358024691358,0)" xlink:href="#aw"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,37.03703703703704,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,49.382716049382715,0)" xlink:href="#av"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,61.72839506172839,0)" xlink:href="#ax"/></g><g id="K"><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,0,0)" xlink:href="#al"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,3.4135802469135794,0)" xlink:href="#ak"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,11.191358024691356,0)" xlink:href="#ar"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,15.512345679012343,0)" xlink:href="#al"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,18.92592592592592,0)" xlink:href="#az"/></g><path fill="#333" d="M194 0L95-120 63-95V0H30v-248h33v124l119-124h40L117-140 236 0h-42" id="bc"/><g id="L"><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,0,0)" xlink:href="#bc"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,10.370370370370368,0)" xlink:href="#aq"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,19.01234567901234,0)" xlink:href="#ax"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,27.654320987654316,0)" xlink:href="#an"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,36.29629629629629,0)" xlink:href="#at"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,41.438271604938265,0)" xlink:href="#an"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,50.08024691358023,0)" xlink:href="#av"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,58.72222222222221,0)" xlink:href="#ar"/></g><g id="M"><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,0,0)" xlink:href="#ap"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,11.191358024691356,0)" xlink:href="#aq"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,19.83333333333333,0)" xlink:href="#ak"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,27.611111111111104,0)" xlink:href="#ar"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,31.93209876543209,0)" xlink:href="#az"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,40.57407407407406,0)" xlink:href="#au"/></g><g id="N"><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,0,0)" xlink:href="#aK"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,11.191358024691356,0)" xlink:href="#as"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,19.83333333333333,0)" xlink:href="#ak"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,27.611111111111104,0)" xlink:href="#az"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,36.253086419753075,0)" xlink:href="#aq"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,44.89506172839505,0)" xlink:href="#at"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,50.037037037037024,0)" xlink:href="#am"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,57.8148148148148,0)" xlink:href="#as"/></g><g id="O"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#aA"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,14.814814814814813,0)" xlink:href="#aq"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,27.160493827160494,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,33.333333333333336,0)" xlink:href="#ai"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,45.67901234567901,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,58.02469135802469,0)" xlink:href="#at"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,65.37037037037037,0)" xlink:href="#al"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,70.24691358024691,0)" xlink:href="#av"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,82.5925925925926,0)" xlink:href="#az"/></g><g id="P"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#af"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,17.28395061728395,0)" xlink:href="#ah"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,29.629629629629626,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,41.9753086419753,0)" xlink:href="#at"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,49.32098765432098,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,61.66666666666666,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,67.83950617283949,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,80.18518518518518,0)" xlink:href="#at"/></g><path fill="#333" d="M220-157c-53 9-28 100-34 157h-49v-107c1-27-5-49-29-50C55-147 81-57 75 0H25l-1-190h47c2 12-1 28 3 38 10-53 101-56 108 0 13-22 24-43 59-42 82 1 51 116 57 194h-49v-107c-1-25-5-48-29-50" id="bd"/><g id="Q"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#bd"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,15.80246913580247,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,25.679012345679016,0)" xlink:href="#aT"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,36.49382716049383,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,46.370370370370374,0)" xlink:href="#aW"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,57.18518518518519,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,67.06172839506173,0)" xlink:href="#aR"/></g><g id="R"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aL"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,9.87654320987654,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,13.777777777777775,0)" xlink:href="#au"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,28.543209876543205,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,32.444444444444436,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,37.38271604938271,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,47.25925925925925,0)" xlink:href="#ax"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,57.13580246913579,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,67.01234567901234,0)" xlink:href="#at"/></g><g id="S"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#aL"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,12.345679012345679,0)" xlink:href="#al"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,17.22222222222222,0)" xlink:href="#au"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,35.67901234567901,0)" xlink:href="#al"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,40.55555555555556,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,46.7283950617284,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,59.074074074074076,0)" xlink:href="#ax"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,71.41975308641976,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,83.76543209876544,0)" xlink:href="#at"/></g><g id="T"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#af"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,17.28395061728395,0)" xlink:href="#ah"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,29.629629629629626,0)" xlink:href="#as"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,41.9753086419753,0)" xlink:href="#at"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,49.32098765432098,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,61.66666666666666,0)" xlink:href="#ar"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,67.83950617283949,0)" xlink:href="#az"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,80.18518518518518,0)" xlink:href="#at"/></g><path fill="#333" d="M33 0v-38h34V0H33" id="be"/><g id="U"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aI"/><path fill="#8080ff" d="M-.9 1.23H9.8v1.3H-.9z"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,8.888888888888888,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,18.76543209876543,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,28.64197530864197,0)" xlink:href="#ax"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,38.51851851851851,0)" xlink:href="#at"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,44.395061728395056,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,54.271604938271594,0)" xlink:href="#av"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,64.14814814814814,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,69.0864197530864,0)" xlink:href="#be"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,74.02469135802467,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,77.9259259259259,0)" xlink:href="#az"/><path fill="#8080ff" d="M8 1.23h80.7v1.3H8z"/></g><g id="V"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aA"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,11.85185185185185,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,21.728395061728392,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,26.666666666666668,0)" xlink:href="#ai"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,36.5432098765432,0)" xlink:href="#aB"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,48.39506172839505,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,58.271604938271594,0)" xlink:href="#ao"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,62.17283950617283,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,66.07407407407406,0)" xlink:href="#am"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,74.96296296296295,0)" xlink:href="#aj"/></g><g id="W"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aI"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,8.888888888888888,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,18.76543209876543,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,28.64197530864197,0)" xlink:href="#ax"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,38.51851851851851,0)" xlink:href="#at"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,44.395061728395056,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,54.271604938271594,0)" xlink:href="#av"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,64.14814814814814,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,69.0864197530864,0)" xlink:href="#be"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,74.02469135802467,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,77.9259259259259,0)" xlink:href="#az"/></g><g id="X"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#aK"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,12.790123456790122,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,22.666666666666664,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,27.60493827160494,0)" xlink:href="#as"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,37.48148148148148,0)" xlink:href="#aL"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,47.358024691358025,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,51.25925925925926,0)" xlink:href="#au"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,66.02469135802468,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,69.92592592592591,0)" xlink:href="#ar"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,74.86419753086417,0)" xlink:href="#aB"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,86.71604938271602,0)" xlink:href="#az"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,96.59259259259257,0)" xlink:href="#ao"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,100.4938271604938,0)" xlink:href="#al"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,104.39506172839502,0)" xlink:href="#am"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,113.2839506172839,0)" xlink:href="#aj"/></g><path fill="#333" d="M67-125c0 53 21 87 73 88 37 1 54-22 65-47l45 17C233-25 199 4 140 4 58 4 20-42 15-125 8-235 124-281 211-232c18 10 29 29 36 50l-46 12c-8-25-30-41-62-41-52 0-71 34-72 86" id="bf"/><g id="Y"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#bf"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,12.790123456790125,0)" xlink:href="#aN"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,19.703703703703706,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,29.58024691358025,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,39.4567901234568,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,45.33333333333334,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,55.209876543209894,0)" xlink:href="#aR"/></g><path fill="#333" d="M231 0h-52l-39-155L100 0H48L-1-190h46L77-45c9-52 24-97 36-145h53l37 145 32-145h46" id="bg"/><path fill="#333" d="M114-157C55-157 80-60 75 0H25v-261h50l-1 109c12-26 28-41 61-42 86-1 58 113 63 194h-50c-7-57 23-157-34-157" id="bh"/><g id="Z"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#bg"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,13.827160493827162,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,23.703703703703706,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,29.58024691358025,0)" xlink:href="#aM"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,39.4567901234568,0)" xlink:href="#bh"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,50.271604938271615,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,60.14814814814817,0)" xlink:href="#aR"/></g><path fill="#333" d="M88-194c31-1 46 15 58 34l-1-101h50l1 261h-48c-2-10 0-23-3-31C134-8 116 4 84 4 32 4 16-41 15-95c0-56 19-97 73-99zm17 164c33 0 40-30 41-66 1-37-9-64-41-64s-38 30-39 65c0 43 13 65 39 65" id="bi"/><g id="aa"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,9.876543209876544,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,15.753086419753087,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,21.629629629629633,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,31.506172839506174,0)" xlink:href="#aM"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,41.38271604938272,0)" xlink:href="#bh"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,52.19753086419754,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,62.074074074074076,0)" xlink:href="#bi"/></g><g id="ab"><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,0,0)" xlink:href="#bc"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,11.85185185185185,0)" xlink:href="#aq"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,21.728395061728392,0)" xlink:href="#ax"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,31.604938271604933,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,41.481481481481474,0)" xlink:href="#at"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,47.35802469135802,0)" xlink:href="#an"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,57.234567901234556,0)" xlink:href="#av"/><use transform="matrix(0.049382716049382706,0,0,0.049382716049382706,67.1111111111111,0)" xlink:href="#ar"/></g><g id="ac"><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,0,0)" xlink:href="#bc"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,14.814814814814813,0)" xlink:href="#aq"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,27.160493827160494,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,39.50617283950617,0)" xlink:href="#ax"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,51.85185185185185,0)" xlink:href="#at"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,59.197530864197525,0)" xlink:href="#an"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,71.5432098765432,0)" xlink:href="#av"/><use transform="matrix(0.06172839506172839,0,0,0.06172839506172839,83.88888888888889,0)" xlink:href="#ar"/></g><path fill="#333" d="M4 7l51-268h42L46 7H4" id="bj"/><g id="ad"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,9.876543209876544,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,15.753086419753087,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,21.629629629629633,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,31.506172839506174,0)" xlink:href="#aM"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,41.38271604938272,0)" xlink:href="#bh"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,52.19753086419754,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,62.074074074074076,0)" xlink:href="#bi"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,72.8888888888889,0)" xlink:href="#bj"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,77.82716049382717,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,83.70370370370371,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,93.58024691358025,0)" xlink:href="#aN"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,100.49382716049384,0)" xlink:href="#aW"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,111.30864197530865,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,121.18518518518519,0)" xlink:href="#aQ"/></g><path fill="#333" d="M115-194c53 0 69 39 70 98 0 66-23 100-70 100C84 3 66-7 56-30L54 0H23l1-261h32v101c10-23 28-34 59-34zm-8 174c40 0 45-34 45-75 0-40-5-75-45-74-42 0-51 32-51 76 0 43 10 73 51 73" id="bk"/><path fill="#333" d="M0 4l72-265h28L28 4H0" id="bl"/><g id="ae"><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,0,0)" xlink:href="#bc"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,10.370370370370368,0)" xlink:href="#aq"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,19.01234567901234,0)" xlink:href="#bk"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,27.654320987654316,0)" xlink:href="#as"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,36.29629629629629,0)" xlink:href="#bl"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,40.61728395061728,0)" xlink:href="#af"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,52.71604938271604,0)" xlink:href="#ah"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,61.35802469135801,0)" xlink:href="#as"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,69.99999999999999,0)" xlink:href="#av"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,78.64197530864196,0)" xlink:href="#ag"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,89.01234567901233,0)" xlink:href="#ai"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,97.6543209876543,0)" xlink:href="#al"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,101.06790123456788,0)" xlink:href="#aJ"/><use transform="matrix(0.04320987654320987,0,0,0.04320987654320987,105.38888888888887,0)" xlink:href="#ar"/></g></defs></g></svg>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/install/install-kubernetes/index.html b/0.10.0/kuadrant-operator/doc/install/install-kubernetes/index.html
deleted file mode 100644
index 961eeae23..000000000
--- a/0.10.0/kuadrant-operator/doc/install/install-kubernetes/index.html
+++ /dev/null
@@ -1,3703 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/install/install-kubernetes/">
-      
-      
-        <link rel="prev" href="../../../../architecture/docs/design/architectural-overview-v1/">
-      
-      
-        <link rel="next" href="../install-openshift/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Kubernetes - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#install-kuadrant-on-a-kubernetes-cluster" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Kubernetes
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-gateway-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install Gateway API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#install-olm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install OLM
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#install-istio-as-a-gateway-api-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install Istio as a Gateway API provider
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#install-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#request-a-kuadrant-instance" class="md-nav__link">
-    <span class="md-ellipsis">
-      Request a Kuadrant instance
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional-dnspolicy-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Optional) DNSPolicy setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional-multi-cluster-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Optional) Multi-cluster RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#next-steps" class="md-nav__link">
-    <span class="md-ellipsis">
-      Next Steps
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-gateway-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install Gateway API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#install-olm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install OLM
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#install-istio-as-a-gateway-api-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install Istio as a Gateway API provider
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#install-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#request-a-kuadrant-instance" class="md-nav__link">
-    <span class="md-ellipsis">
-      Request a Kuadrant instance
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional-dnspolicy-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Optional) DNSPolicy setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional-multi-cluster-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Optional) Multi-cluster RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#next-steps" class="md-nav__link">
-    <span class="md-ellipsis">
-      Next Steps
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/install/install-kubernetes.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="install-kuadrant-on-a-kubernetes-cluster">Install Kuadrant on a Kubernetes cluster<a class="headerlink" href="#install-kuadrant-on-a-kubernetes-cluster" title="Permanent link">&para;</a></h1>
-<div class="admonition note">
-<p class="admonition-title">Note</p>
-<p>You must perform these steps on each Kubernetes cluster where you want to use Kuadrant.</p>
-</div>
-<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Access to a Kubernetes cluster, with <code>kubeadmin</code> or an account with similar permissions</li>
-<li><code>cert-manager</code> <a href="https://cert-manager.io/docs/installation/">installed</a></li>
-</ul>
-<h2 id="procedure">Procedure<a class="headerlink" href="#procedure" title="Permanent link">&para;</a></h2>
-<p>This guide will show you how to install Kuadrant onto a bare Kubernetes cluster.</p>
-<p>Alternatively, if you are looking instead for a way to set up Kuadrant locally to evaluate or develop, consider running the kind &amp; Kubernetes <a href="https://docs.kuadrant.io/latest/getting-started-single-cluster/">quickstart script</a>.</p>
-<h3 id="install-gateway-api">Install Gateway API<a class="headerlink" href="#install-gateway-api" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.1.0/standard-install.yaml
-</span></code></pre></div>
-<h3 id="install-olm">Install <a href="https://olm.operatorframework.io/">OLM</a><a class="headerlink" href="#install-olm" title="Permanent link">&para;</a></h3>
-<div class="admonition note">
-<p class="admonition-title">Note</p>
-<p>Currently, we recommend installing our operator via OLM. We plan to support Helm soon.</p>
-</div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://github.com/operator-framework/operator-lifecycle-manager/releases/download/v0.28.0/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s<span class="w"> </span>v0.28.0
-</span></code></pre></div>
-<h3 id="install-istio-as-a-gateway-api-provider">Install Istio as a Gateway API provider<a class="headerlink" href="#install-istio-as-a-gateway-api-provider" title="Permanent link">&para;</a></h3>
-<div class="admonition note">
-<p class="admonition-title">Note</p>
-<p>There are several ways to install Istio (via <code>istioctl</code>, Helm chart or Operator) - this is just an example for starting from a bare Kubernetes cluster.</p>
-</div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>curl<span class="w"> </span>-L<span class="w"> </span>https://istio.io/downloadIstio<span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nv">ISTIO_VERSION</span><span class="o">=</span><span class="m">1</span>.21.4<span class="w"> </span>sh<span class="w"> </span>-
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>./istio-1.21.4/bin/istioctl<span class="w"> </span>install<span class="w"> </span>--set<span class="w"> </span><span class="nv">profile</span><span class="o">=</span>minimal
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>./istio-1.21.4/bin/istioctl<span class="w"> </span>operator<span class="w"> </span>init
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/config/dependencies/istio/istio-operator.yaml
-</span></code></pre></div>
-<h3 id="install-kuadrant">Install Kuadrant<a class="headerlink" href="#install-kuadrant" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>-f<span class="w"> </span>https://operatorhub.io/install/kuadrant-operator.yaml
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>kubectl<span class="w"> </span>get<span class="w"> </span>crd<span class="w"> </span>--watch<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-m<span class="w"> </span><span class="m">1</span><span class="w"> </span><span class="s2">&quot;kuadrants.kuadrant.io&quot;</span>
-</span></code></pre></div>
-<h3 id="request-a-kuadrant-instance">Request a Kuadrant instance<a class="headerlink" href="#request-a-kuadrant-instance" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>kuadrant-system
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">metadata:</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">spec: {}</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Kuadrant should now install. You can check the operator's install status with:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span><span class="nb">wait</span><span class="w"> </span>--for<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.state}&#39;</span><span class="o">=</span>AtLatestKnown<span class="w"> </span>subscription/my-kuadrant-operator<span class="w"> </span>-n<span class="w"> </span>operators<span class="w"> </span>--timeout<span class="o">=</span>600s
-</span></code></pre></div>
-<p>Kuadrant is now ready to use.</p>
-<h3 id="optional-dnspolicy-setup">(Optional) <code>DNSPolicy</code> setup<a class="headerlink" href="#optional-dnspolicy-setup" title="Permanent link">&para;</a></h3>
-<p>If you plan to use <code>DNSPolicy</code>, you will need an AWS Account with access to Route 53 (more providers coming soon), and a hosted zone.</p>
-<p>Export the following environment variables for setup:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span>xxxxxxx<span class="w"> </span><span class="c1"># Key ID from AWS with Route 53 access</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span>xxxxxxx<span class="w"> </span><span class="c1"># Access key from AWS with Route 53 access</span>
-</span></code></pre></div>
-<p>Create an AWS credentials secret:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>aws-credentials<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="w">  </span>--type<span class="o">=</span>kuadrant.io/aws<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span><span class="nv">$AWS_ACCESS_KEY_ID</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span><span class="nv">$AWS_SECRET_ACCESS_KEY</span>
-</span></code></pre></div>
-<h3 id="optional-multi-cluster-ratelimitpolicy">(Optional) Multi-cluster <code>RateLimitPolicy</code><a class="headerlink" href="#optional-multi-cluster-ratelimitpolicy" title="Permanent link">&para;</a></h3>
-<p>To enable <code>RateLimitPolicy</code> to use shared, multi-cluster counters for Kuadrant's Limitador component, you need to configure Kuadrant with a Redis cluster URL. Redis URIs can be either <code>redis://</code> for standard connections or <code>rediss://</code> for secure connections.</p>
-<p>Follow these steps to create the necessary secret:</p>
-<ol>
-<li>
-<p>Replace <code>some-redis.com:6379</code> with the URL of your accessible Redis cluster. Ensure you include the appropriate URI scheme (<code>redis://</code> or <code>rediss://</code>).</p>
-</li>
-<li>
-<p>Execute the following commands:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="c1"># Replace this with an accessible Redis cluster URL</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">REDIS_URL</span><span class="o">=</span>redis://user:xxxxxx@some-redis.com:6379
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>redis-config<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">URL</span><span class="o">=</span><span class="nv">$REDIS_URL</span>
-</span></code></pre></div>
-</li>
-</ol>
-<p>This will create a secret named <code>redis-config</code> in the <code>kuadrant-system</code> namespace containing your Redis cluster URL, which Kuadrant will use for multi-cluster rate limiting.</p>
-<p>You'll also need to update your earlier created <code>Kuadrant</code> instance to reconfigure Kuadrant to use Redis:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">spec:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">  limitador:</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">    storage:</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">      redis-cached:</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">        configSecretRef:</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">          name: redis-config </span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="next-steps">Next Steps<a class="headerlink" href="#next-steps" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="../../user-guides/secure-protect-connect/">Secure, protect, and connect APIs with Kuadrant on Kubernetes</a></li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/install/install-openshift/index.html b/0.10.0/kuadrant-operator/doc/install/install-openshift/index.html
deleted file mode 100644
index 1e8961d48..000000000
--- a/0.10.0/kuadrant-operator/doc/install/install-openshift/index.html
+++ /dev/null
@@ -1,3980 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/install/install-openshift/">
-      
-      
-        <link rel="prev" href="../install-kubernetes/">
-      
-      
-        <link rel="next" href="../../dns/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>OpenShift - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#install-kuadrant-on-an-openshift-cluster" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              OpenShift
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-set-up-your-environment" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Set up your environment
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-install-gateway-api-v1" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Install Gateway API v1
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-3-install-cert-manager" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Install cert-manager
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 3 - Install cert-manager">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-community-version-of-the-cert-manager" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install community version of the cert-manager
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#install-cert-manager-operator-for-red-hat-openshift" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install cert-manager Operator for Red Hat OpenShift
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-install-and-configure-istio-with-the-sail-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Install and configure Istio with the Sail Operator
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 4 - Install and configure Istio with the Sail Operator">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-istio" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install Istio
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#configure-istio" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configure Istio
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-5-optional-configure-observability-and-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Optional: Configure observability and metrics
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-6-create-secrets-for-your-credentials" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 6 - Create secrets for your credentials
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 6 - Create secrets for your credentials">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#aws-route-53-credentials-for-tls" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS Route 53 credentials for TLS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#redis-credentials-for-rate-limiting-counters" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis credentials for rate limiting counters
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#aws-route-53-credentials-for-dns" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS Route 53 credentials for DNS
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-7-install-the-kuadrant-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 7 - Install the Kuadrant Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-8-configure-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 8 - Configure Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#next-steps" class="md-nav__link">
-    <span class="md-ellipsis">
-      Next steps
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-set-up-your-environment" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Set up your environment
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-install-gateway-api-v1" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Install Gateway API v1
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-3-install-cert-manager" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Install cert-manager
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 3 - Install cert-manager">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-community-version-of-the-cert-manager" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install community version of the cert-manager
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#install-cert-manager-operator-for-red-hat-openshift" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install cert-manager Operator for Red Hat OpenShift
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-install-and-configure-istio-with-the-sail-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Install and configure Istio with the Sail Operator
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 4 - Install and configure Istio with the Sail Operator">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-istio" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install Istio
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#configure-istio" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configure Istio
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-5-optional-configure-observability-and-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Optional: Configure observability and metrics
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-6-create-secrets-for-your-credentials" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 6 - Create secrets for your credentials
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 6 - Create secrets for your credentials">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#aws-route-53-credentials-for-tls" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS Route 53 credentials for TLS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#redis-credentials-for-rate-limiting-counters" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis credentials for rate limiting counters
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#aws-route-53-credentials-for-dns" class="md-nav__link">
-    <span class="md-ellipsis">
-      AWS Route 53 credentials for DNS
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-7-install-the-kuadrant-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 7 - Install the Kuadrant Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-8-configure-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 8 - Configure Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#next-steps" class="md-nav__link">
-    <span class="md-ellipsis">
-      Next steps
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/install/install-openshift.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="install-kuadrant-on-an-openshift-cluster">Install Kuadrant on an OpenShift cluster<a class="headerlink" href="#install-kuadrant-on-an-openshift-cluster" title="Permanent link">&para;</a></h1>
-<div class="admonition note">
-<p class="admonition-title">Note</p>
-<p>You must perform these steps on each OpenShift cluster that you want to use Kuadrant on.</p>
-</div>
-<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li>OpenShift Container Platform 4.14.x or later with community Operator catalog available.</li>
-<li>AWS account with Route 53 and zone.</li>
-<li>Accessible Redis instance.</li>
-</ul>
-<h2 id="procedure">Procedure<a class="headerlink" href="#procedure" title="Permanent link">&para;</a></h2>
-<h3 id="step-1-set-up-your-environment">Step 1 - Set up your environment<a class="headerlink" href="#step-1-set-up-your-environment" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span>xxxxxxx<span class="w"> </span><span class="c1"># Key ID from AWS with Route 53 access</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span>xxxxxxx<span class="w"> </span><span class="c1"># Access key from AWS with Route 53 access</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">REDIS_URL</span><span class="o">=</span>redis://user:xxxxxx@some-redis.com:10340<span class="w"> </span><span class="c1"># A Redis cluster URL</span>
-</span></code></pre></div>
-<h3 id="step-2-install-gateway-api-v1">Step 2 - Install Gateway API v1<a class="headerlink" href="#step-2-install-gateway-api-v1" title="Permanent link">&para;</a></h3>
-<p>Before you can use Kuadrant, you must install Gateway API v1 as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.0.0/standard-install.yaml
-</span></code></pre></div>
-<h3 id="step-3-install-cert-manager">Step 3 - Install cert-manager<a class="headerlink" href="#step-3-install-cert-manager" title="Permanent link">&para;</a></h3>
-<p>Before you can use Kuadrant, you must install cert-manager.</p>
-<blockquote>
-<p>The minimum supported version of cert-manager is v1.12.1.</p>
-</blockquote>
-<p>Install one of the different flavours of the Cert-Manager.</p>
-<h4 id="install-community-version-of-the-cert-manager">Install community version of the cert-manager<a class="headerlink" href="#install-community-version-of-the-cert-manager" title="Permanent link">&para;</a></h4>
-<p>Consider <a href="https://cert-manager.io/docs/installation/operator-lifecycle-manager/">installing cert-manager via OperatorHub</a>,
-which you can do from the OpenShift web console.</p>
-<p>More installation options at <a href="https://cert-manager.io/docs/installation/">cert-manager.io</a></p>
-<h4 id="install-cert-manager-operator-for-red-hat-openshift">Install cert-manager Operator for Red Hat OpenShift<a class="headerlink" href="#install-cert-manager-operator-for-red-hat-openshift" title="Permanent link">&para;</a></h4>
-<p>You can install the <a href="https://docs.openshift.com/container-platform/4.16/security/cert_manager_operator/cert-manager-operator-install.html">cert-manager Operator for Red Hat OpenShift</a>
-by using the web console.</p>
-<h3 id="step-4-install-and-configure-istio-with-the-sail-operator">Step 4 - Install and configure Istio with the Sail Operator<a class="headerlink" href="#step-4-install-and-configure-istio-with-the-sail-operator" title="Permanent link">&para;</a></h3>
-<p>Kuadrant integrates with Istio as a Gateway API provider. You can set up an Istio-based Gateway API provider by using the Sail Operator.</p>
-<h4 id="install-istio">Install Istio<a class="headerlink" href="#install-istio" title="Permanent link">&para;</a></h4>
-<p>To install the Istio Gateway provider, run the following commands:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>ns<span class="w"> </span>istio-system
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w">  </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">kind: OperatorGroup</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">apiVersion: operators.coreos.com/v1</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: sail</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">  namespace: istio-system</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">spec:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">  upgradeStrategy: Default</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">---</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">apiVersion: operators.coreos.com/v1alpha1</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">kind: Subscription</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">metadata:</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">  name: sailoperator</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="s">  namespace: istio-system</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="s">spec:</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="s">  channel: 3.0-dp1</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="s">  installPlanApproval: Automatic</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="s">  name: sailoperator</span>
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="s">  source: community-operators</span>
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="s">  sourceNamespace: openshift-marketplace</span>
-</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check the status of the installation as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>installplan<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.items[0].status.phase}&#39;</span>
-</span></code></pre></div>
-<p>When ready, the status will change from <code>installing</code> to <code>complete</code>.</p>
-<h4 id="configure-istio">Configure Istio<a class="headerlink" href="#configure-istio" title="Permanent link">&para;</a></h4>
-<p>To configure the Istio Gateway API provider, run the following command:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: operator.istio.io/v1alpha1</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: Istio</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  name: default</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">spec:</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">  version: v1.21.0</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">  namespace: istio-system</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="s">  # Disable autoscaling to reduce dev resources</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="s">  values:</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="s">    pilot:</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="s">      autoscaleEnabled: false</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Wait for Istio to be ready as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span><span class="nb">wait</span><span class="w"> </span>istio/default<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>--for<span class="o">=</span><span class="s2">&quot;condition=Ready=true&quot;</span>
-</span></code></pre></div>
-<h3 id="step-5-optional-configure-observability-and-metrics">Step 5 - Optional: Configure observability and metrics<a class="headerlink" href="#step-5-optional-configure-observability-and-metrics" title="Permanent link">&para;</a></h3>
-<p>Kuadrant provides a set of example dashboards that use known metrics exported by Kuadrant and Gateway components to provide insight into different components of your APIs and Gateways. While not essential, it is best to set up an OpenShift monitoring stack. This section provides links to OpenShift and Thanos documentation on configuring monitoring and metrics storage.</p>
-<p>You can set up user-facing monitoring by following the steps in the OpenShift documentation on <a href="https://docs.openshift.com/container-platform/latest/observability/monitoring/configuring-the-monitoring-stack.html">configuring the monitoring stack</a>.</p>
-<p>If you have user workload monitoring enabled, it is best to configure remote writes to a central storage system such as Thanos:</p>
-<ul>
-<li><a href="https://docs.openshift.com/container-platform/latest/observability/monitoring/configuring-the-monitoring-stack.html#configuring_remote_write_storage_configuring-the-monitoring-stack">OpenShift remote write configuration</a></li>
-<li><a href="https://github.com/thanos-io/kube-thanos">Kube Thanos</a></li>
-</ul>
-<p>The <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/observability/examples/">example dashboards and alerts</a> for observing Kuadrant functionality use low-level CPU metrics and network metrics available from the user monitoring stack in OpenShift. They also use resource state metrics from Gateway API and Kuadrant resources. </p>
-<p>To scrape these additional metrics, you can install a <code>kube-state-metrics instance</code>, with a custom resource configuration as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/config/observability/openshift/kube-state-metrics.yaml
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-k<span class="w"> </span>https://github.com/Kuadrant/gateway-api-state-metrics?ref<span class="o">=</span>main
-</span></code></pre></div>
-<p>To enable request metrics in Istio, you must create a <code>telemetry</code> resource as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/config/observability/openshift/telemetry.yaml
-</span></code></pre></div>
-<p>If you have Grafana installed in your cluster, you can import the <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/observability/examples">example dashboards and alerts</a>.</p>
-<p>For example installation details, see <a href="https://cloud.redhat.com/experts/o11y/ocp-grafana/">installing Grafana on OpenShift</a>. When installed, you must add your Thanos instance as a data source to Grafana. Alternatively, if you are using only the user workload monitoring stack in your OpenShift cluster, and not writing metrics to an external Thanos instance, you can <a href="https://docs.openshift.com/container-platform/4.15/observability/monitoring/accessing-third-party-monitoring-apis.html#accessing-metrics-from-outside-cluster_accessing-monitoring-apis-by-using-the-cli">set up a data source to the thanos-querier route in the OpenShift cluster</a>.</p>
-<h3 id="step-6-create-secrets-for-your-credentials">Step 6 - Create secrets for your credentials<a class="headerlink" href="#step-6-create-secrets-for-your-credentials" title="Permanent link">&para;</a></h3>
-<p>Before installing the Kuadrant Operator, you must enter the following commands to set up secrets that you will use later:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>ns<span class="w"> </span>kuadrant-system
-</span></code></pre></div>
-<p>Set up a <code>CatalogSource</code> as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">apiVersion: operators.coreos.com/v1alpha1</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">kind: CatalogSource</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">metadata:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">  name: kuadrant-operator-catalog</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">spec:</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="s">  sourceType: grpc</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">  image: quay.io/kuadrant/kuadrant-operator-catalog:v0.7.1</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">  displayName: Kuadrant Operators</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">  publisher: grpc</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">  updateStrategy:</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">    registryPoll:</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">      interval: 45m</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h4 id="aws-route-53-credentials-for-tls">AWS Route 53 credentials for TLS<a class="headerlink" href="#aws-route-53-credentials-for-tls" title="Permanent link">&para;</a></h4>
-<p>Set the AWS Route 53 credentials for TLS verification as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>aws-credentials<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="w">  </span>--type<span class="o">=</span>kuadrant.io/aws<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span><span class="nv">$AWS_ACCESS_KEY_ID</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span><span class="nv">$AWS_SECRET_ACCESS_KEY</span>
-</span></code></pre></div>
-<h4 id="redis-credentials-for-rate-limiting-counters">Redis credentials for rate limiting counters<a class="headerlink" href="#redis-credentials-for-rate-limiting-counters" title="Permanent link">&para;</a></h4>
-<p>Set the Redis credentials for shared multicluster counters for the Kuadrant Limitador component as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>redis-config<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">URL</span><span class="o">=</span><span class="nv">$REDIS_URL</span>
-</span></code></pre></div>
-<h4 id="aws-route-53-credentials-for-dns">AWS Route 53 credentials for DNS<a class="headerlink" href="#aws-route-53-credentials-for-dns" title="Permanent link">&para;</a></h4>
-<p>Set the AWS Route 53 credentials for managing DNS records as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>ns<span class="w"> </span>ingress-gateway
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>ingress-gateway<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>aws-credentials<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="w">  </span>--type<span class="o">=</span>kuadrant.io/aws<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span><span class="nv">$AWS_ACCESS_KEY_ID</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span><span class="nv">$AWS_SECRET_ACCESS_KEY</span>
-</span></code></pre></div>
-<h3 id="step-7-install-the-kuadrant-operator">Step 7 - Install the Kuadrant Operator<a class="headerlink" href="#step-7-install-the-kuadrant-operator" title="Permanent link">&para;</a></h3>
-<p>To install the Kuadrant Operator, enter the following command:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="s">apiVersion: operators.coreos.com/v1alpha1</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="s">kind: Subscription</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="s">metadata:</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="s">  name: kuadrant-operator</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="s">spec:</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="s">  channel: preview</span>
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="s">  installPlanApproval: Automatic</span>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="s">  name: kuadrant-operator</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="s">  source: kuadrant-operator-catalog</span>
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="s">  sourceNamespace: kuadrant-system</span>
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="s">---</span>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a><span class="s">kind: OperatorGroup</span>
-</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="s">apiVersion: operators.coreos.com/v1</span>
-</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="s">metadata:</span>
-</span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-15-18"><a id="__codelineno-15-18" name="__codelineno-15-18" href="#__codelineno-15-18"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-15-19"><a id="__codelineno-15-19" name="__codelineno-15-19" href="#__codelineno-15-19"></a><span class="s">spec:</span>
-</span><span id="__span-15-20"><a id="__codelineno-15-20" name="__codelineno-15-20" href="#__codelineno-15-20"></a><span class="s">  upgradeStrategy: Default</span>
-</span><span id="__span-15-21"><a id="__codelineno-15-21" name="__codelineno-15-21" href="#__codelineno-15-21"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Wait for the Kuadrant Operators to be installed as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>installplan<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.items[0].status.phase}&#39;</span>
-</span></code></pre></div>
-<p>After some time, this command should return <code>complete</code>.</p>
-<h3 id="step-8-configure-kuadrant">Step 8 - Configure Kuadrant<a class="headerlink" href="#step-8-configure-kuadrant" title="Permanent link">&para;</a></h3>
-<p>To configure your Kuadrant deployment, enter the following command:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="s">metadata:</span>
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="s">spec:</span>
-</span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a><span class="s">  limitador:</span>
-</span><span id="__span-17-9"><a id="__codelineno-17-9" name="__codelineno-17-9" href="#__codelineno-17-9"></a><span class="s">    storage:</span>
-</span><span id="__span-17-10"><a id="__codelineno-17-10" name="__codelineno-17-10" href="#__codelineno-17-10"></a><span class="s">      redis-cached:</span>
-</span><span id="__span-17-11"><a id="__codelineno-17-11" name="__codelineno-17-11" href="#__codelineno-17-11"></a><span class="s">        configSecretRef:</span>
-</span><span id="__span-17-12"><a id="__codelineno-17-12" name="__codelineno-17-12" href="#__codelineno-17-12"></a><span class="s">          name: redis-config</span>
-</span><span id="__span-17-13"><a id="__codelineno-17-13" name="__codelineno-17-13" href="#__codelineno-17-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Wait for Kuadrant to be ready as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kubectl<span class="w"> </span><span class="nb">wait</span><span class="w"> </span>kuadrant/kuadrant<span class="w"> </span>--for<span class="o">=</span><span class="s2">&quot;condition=Ready=true&quot;</span><span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>--timeout<span class="o">=</span>300s
-</span></code></pre></div>
-<p>Kuadrant is now ready to use.</p>
-<h2 id="next-steps">Next steps<a class="headerlink" href="#next-steps" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="../../user-guides/secure-protect-connect-single-multi-cluster/">Secure, protect, and connect APIs with Kuadrant on OpenShift</a></li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/logging/index.html b/0.10.0/kuadrant-operator/doc/logging/index.html
deleted file mode 100644
index 30f0a6be3..000000000
--- a/0.10.0/kuadrant-operator/doc/logging/index.html
+++ /dev/null
@@ -1,3391 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/logging/">
-      
-      
-        <link rel="prev" href="../development/">
-      
-      
-        <link rel="next" href="../../../authorino/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Logging - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#logging" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Logging
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/logging.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="logging">Logging<a class="headerlink" href="#logging" title="Permanent link">&para;</a></h1>
-<p>The kuadrant operator outputs 3 levels of log messages: (from lowest to highest level)</p>
-<ol>
-<li><code>debug</code></li>
-<li><code>info</code> (default)</li>
-<li><code>error</code></li>
-</ol>
-<p><code>info</code> logging is restricted to high-level information. Actions like creating, deleteing or updating kubernetes resources will be logged with reduced details about the corresponding objects, and without any further detailed logs of the steps in between, except for errors.</p>
-<p>Only <code>debug</code> logging will include processing details.</p>
-<p>To configure the desired log level, set the environment variable <code>LOG_LEVEL</code> to one of the supported values listed above. Default log level is <code>info</code>.</p>
-<p>Apart from log level, the operator can output messages to the logs in 2 different formats:</p>
-<ul>
-<li><code>production</code> (default): each line is a parseable JSON object with properties <code>{"level":string, "ts":int, "msg":string, "logger":string, extra values...}</code></li>
-<li><code>development</code>: more human-readable outputs, extra stack traces and logging info, plus extra values output as JSON, in the format: <code>&lt;timestamp-iso-8601&gt;\t&lt;log-level&gt;\t&lt;logger&gt;\t&lt;message&gt;\t{extra-values-as-json}</code></li>
-</ul>
-<p>To configure the desired log mode, set the environment variable <code>LOG_MODE</code> to one of the supported values listed above. Default log level is <code>production</code>.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/observability/examples/index.html b/0.10.0/kuadrant-operator/doc/observability/examples/index.html
deleted file mode 100644
index e011b8a15..000000000
--- a/0.10.0/kuadrant-operator/doc/observability/examples/index.html
+++ /dev/null
@@ -1,3551 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/observability/examples/">
-      
-      
-        <link rel="prev" href="../metrics/">
-      
-      
-        <link rel="next" href="../tracing/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Dashboards and Alerts - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#example-dashboards-and-alerts" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Dashboards and Alerts
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#dashboards" class="md-nav__link">
-    <span class="md-ellipsis">
-      Dashboards
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Dashboards">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#importing-dashboards-into-grafana" class="md-nav__link">
-    <span class="md-ellipsis">
-      Importing Dashboards into Grafana
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#alerts" class="md-nav__link">
-    <span class="md-ellipsis">
-      Alerts
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Alerts">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setting-up-alerts-in-prometheus" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setting Up Alerts in Prometheus
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#dashboards" class="md-nav__link">
-    <span class="md-ellipsis">
-      Dashboards
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Dashboards">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#importing-dashboards-into-grafana" class="md-nav__link">
-    <span class="md-ellipsis">
-      Importing Dashboards into Grafana
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#alerts" class="md-nav__link">
-    <span class="md-ellipsis">
-      Alerts
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Alerts">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setting-up-alerts-in-prometheus" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setting Up Alerts in Prometheus
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/observability/examples.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="example-dashboards-and-alerts">Example Dashboards and Alerts<a class="headerlink" href="#example-dashboards-and-alerts" title="Permanent link">&para;</a></h1>
-<p>Explore a variety of starting points for monitoring your Kuadrant installation with our <a href="https://github.com/Kuadrant/kuadrant-operator/tree/main/examples">examples</a> folder. These dashboards and alerts are ready-to-use and easily customizable to fit your environment.</p>
-<p>There are some example dashboards uploaded to <a href="https://grafana.com/grafana/dashboards/">Grafana.com</a> . You can use the ID's listed below to import these dashboards into Grafana:</p>
-<table>
-<thead>
-<tr>
-<th>Name</th>
-<th>ID</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><a href="https://grafana.com/grafana/dashboards/21538">App Developer Dashboard</a></td>
-<td><code>21538</code></td>
-</tr>
-<tr>
-<td><a href="https://grafana.com/grafana/dashboards/20981">Business User Dashboard</a></td>
-<td><code>20981</code></td>
-</tr>
-<tr>
-<td><a href="https://grafana.com/grafana/dashboards/20982">Platform Engineer Dashboard</a></td>
-<td><code>20982</code></td>
-</tr>
-</tbody>
-</table>
-<h2 id="dashboards">Dashboards<a class="headerlink" href="#dashboards" title="Permanent link">&para;</a></h2>
-<h3 id="importing-dashboards-into-grafana">Importing Dashboards into Grafana<a class="headerlink" href="#importing-dashboards-into-grafana" title="Permanent link">&para;</a></h3>
-<p>For more details on how to import dashboards into Grafana, visit the <a href="https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/import-dashboards/">import dashboards</a> page. </p>
-<ul>
-<li><strong>UI Method:</strong><ul>
-<li><strong>JSON</strong> -  Use the 'Import' feature in the Grafana UI to upload dashboard JSON files directly.</li>
-<li><strong>ID</strong> - Use the 'Import' feature in the Grafana UI to import via <a href="https://grafana.com/grafana/dashboards/">Grafana.com</a> using a Dashboard ID. </li>
-</ul>
-</li>
-<li><strong>ConfigMap Method:</strong> Automate dashboard provisioning by adding files to a ConfigMap, which should be mounted at <code>/etc/grafana/provisioning/dashboards</code>.</li>
-</ul>
-<p>Datasources are configured as template variables, automatically integrating with your existing data sources. Metrics for these dashboards are sourced from <a href="https://github.com/prometheus/prometheus">Prometheus</a>. For more details on the metrics used, visit the <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/observability/metrics/">metrics</a> documentation page.</p>
-<h2 id="alerts">Alerts<a class="headerlink" href="#alerts" title="Permanent link">&para;</a></h2>
-<h3 id="setting-up-alerts-in-prometheus">Setting Up Alerts in Prometheus<a class="headerlink" href="#setting-up-alerts-in-prometheus" title="Permanent link">&para;</a></h3>
-<p>You can integrate the <a href="https://github.com/Kuadrant/kuadrant-operator/tree/main/examples">example alerts</a> into Prometheus as <code>PrometheusRule</code> resources. Feel free to adjust alert thresholds to suit your specific operational needs.</p>
-<p>Additionally, <a href="https://sre.google/sre-book/service-level-objectives/">Service Level Objective (SLO)</a> alerts generated with <a href="https://sloth.dev/">Sloth</a> are included. A benefit of these alerts is the ability to integrate them with this <a href="https://grafana.com/grafana/dashboards/14348-slo-detail/">SLO dashboard</a>, which utilizes generated labels to comprehensively overview your SLOs.</p>
-<p>Further information on the metrics used for these alerts can be found on the <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/observability/metrics/">metrics</a> page.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/observability/grafana_trace.png b/0.10.0/kuadrant-operator/doc/observability/grafana_trace.png
deleted file mode 100644
index bc9d32a4f37c22e20f051d7d7ebc429ee071dd77..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 222423
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%0Akd2Ob24%G`VG93Qn$k!|rVuTxQ5{)IMXkI)j
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
EFXD8%W&i*H

diff --git a/0.10.0/kuadrant-operator/doc/observability/grafana_tracing_loki.png b/0.10.0/kuadrant-operator/doc/observability/grafana_tracing_loki.png
deleted file mode 100644
index ab02c91f744c9aa84245b493c1e8b4d46014091c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 131715
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

diff --git a/0.10.0/kuadrant-operator/doc/observability/metrics/index.html b/0.10.0/kuadrant-operator/doc/observability/metrics/index.html
deleted file mode 100644
index c8322b27d..000000000
--- a/0.10.0/kuadrant-operator/doc/observability/metrics/index.html
+++ /dev/null
@@ -1,3622 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/observability/metrics/">
-      
-      
-        <link rel="prev" href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/">
-      
-      
-        <link rel="next" href="../examples/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Metrics - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#metrics" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Metrics
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#metrics-sources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Metrics sources
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#resource-usage-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Resource usage metrics
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#networking-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Networking metrics
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#state-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      State metrics
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#joining-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Joining metrics
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#metrics-sources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Metrics sources
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#resource-usage-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Resource usage metrics
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#networking-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Networking metrics
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#state-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      State metrics
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#joining-metrics" class="md-nav__link">
-    <span class="md-ellipsis">
-      Joining metrics
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/observability/metrics.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="metrics">Metrics<a class="headerlink" href="#metrics" title="Permanent link">&para;</a></h1>
-<p>This is a reference page for some of the different metrics used in example
-dashboards and alerts. It is not an exhaustive list. The documentation for each
-component may provide more details on a per-component basis. Some of the metrics
-are sourced from components outside the Kuadrant project, for example, Envoy.
-The value of this reference is showing some of the more widely desired metrics,
-and how to join the metrics from different sources together in a meaningful way.</p>
-<h2 id="metrics-sources">Metrics sources<a class="headerlink" href="#metrics-sources" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kuadrant components</li>
-<li><a href="https://istio.io/latest/docs/reference/config/metrics/">Istio</a></li>
-<li><a href="https://www.envoyproxy.io/docs/envoy/latest/operations/admin.html#get--stats">Envoy</a></li>
-<li><a href="https://github.com/kubernetes/kube-state-metrics">Kube State Metrics</a></li>
-<li><a href="https://github.com/Kuadrant/gateway-api-state-metrics">Gateway API State Metrics</a></li>
-<li><a href="https://kubernetes.io/docs/concepts/cluster-administration/system-metrics/#metrics-in-kubernetes">Kubernetes metrics</a></li>
-</ul>
-<h2 id="resource-usage-metrics">Resource usage metrics<a class="headerlink" href="#resource-usage-metrics" title="Permanent link">&para;</a></h2>
-<p>Resource metrics, like CPU, memory and disk usage, primarily come from the Kubernetes
-metrics components. These include <code>container_cpu_usage_seconds_total</code>, <code>container_memory_working_set_bytes</code>
-and <code>kubelet_volume_stats_used_bytes</code>. A <a href="https://github.com/kubernetes/kubernetes/blob/master/test/instrumentation/testdata/stable-metrics-list.yaml">stable list of metrics</a> is maintained in
-the Kubernetes repository. These low-level metrics typically have a set of
-<a href="https://prometheus.io/docs/practices/rules/#aggregation">recording rules</a> that
-aggregate values by labels and time ranges.
-For example, <code>node_namespace_pod_container:container_cpu_usage_seconds_total:sum_irate</code> or <code>namespace_workload_pod:kube_pod_owner:relabel</code>.
-If you have deployed the <a href="https://github.com/prometheus-operator/kube-prometheus">kube-prometheus</a> project, you should have the majority of 
-these metrics being scraped.</p>
-<h2 id="networking-metrics">Networking metrics<a class="headerlink" href="#networking-metrics" title="Permanent link">&para;</a></h2>
-<p>Low-level networking metrics like <code>container_network_receive_bytes_total</code> are also
-available from the Kubernetes metrics components.
-HTTP &amp; GRPC traffic metrics with higher level labels are <a href="https://istio.io/latest/docs/reference/config/metrics/">available from Istio</a>.
-One of the main metrics would be <code>istio_requests_total</code>, which is a counter incremented for every request handled by an Istio proxy.
-Latency metrics are available via the <code>istio_request_duration_milliseconds</code> metric, with buckets for varying response times.</p>
-<p>Some example dashboards have panels that make use of the request URL path.
-The path is <em>not</em> added as a label to Istio metrics by default, as it has the potential
-to increase metric cardinality, and thus storage requirements.
-If you want to make use of the path in your queries or visualisations, you can enable
-the request path metric via the <a href="https://istio.io/latest/docs/reference/config/telemetry/#MetricSelector-IstioMetric">Telemetry resource</a> in istio:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>apiVersion: telemetry.istio.io/v1alpha1
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>kind: Telemetry
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>metadata:
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>  name: namespace-metrics
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>  namespace: istio-system
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>spec:
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>  metrics:
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>  - providers:
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>    - name: prometheus
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>    overrides:
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>    - match:
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>        metric: REQUEST_COUNT
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>      tagOverrides:
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>        request_url_path:
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>          value: &quot;request.url_path&quot;
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>    - match:      
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>        metric: REQUEST_DURATION
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>      tagOverrides:
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>        request_url_path:
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>          value: &quot;request.url_path&quot;
-</span></code></pre></div>
-<h2 id="state-metrics">State metrics<a class="headerlink" href="#state-metrics" title="Permanent link">&para;</a></h2>
-<p>The <a href="https://github.com/kubernetes/kube-state-metrics/tree/main/docs#default-resources">kube-state-metrics</a>
-project exposes the state of various kuberenetes resources
-as metrics and labels. For example, the ready <code>status</code> of a <code>Pod</code> is available as
-<code>kube_pod_status_ready</code>, with labels for the pod <code>name</code> and <code>namespace</code>. This can
-be useful for linking lower level container metrics back to a meaningful resource
-in the Kubernetes world.</p>
-<h2 id="joining-metrics">Joining metrics<a class="headerlink" href="#joining-metrics" title="Permanent link">&para;</a></h2>
-<p>Metric queries can be as simple as just the name of the metric, or can be complex
-with joining &amp; grouping. A lot of the time it can be useful to tie back low level
-metrics to more meaningful Kubernetes resources. For example, if the memory usage
-is maxed out on a container and that container is constantly being OOMKilled, it
-can be useful to get the Deployment and Namespace of that container for debugging.
-Prometheus query language (or promql) allows <a href="https://prometheus.io/docs/prometheus/latest/querying/operators/#vector-matching">vector matching</a>
-or results (sometimes called joining).</p>
-<p>When using Gateway API and Kuadrant resources like HTTPRoute and RateLimitPolicy,
-the state metrics can be joined to Istio metrics to give a meaningful result set.
-Here's an example that queries the number of requests per second, and includes
-the name of the HTTPRoute that the traffic is for.</p>
-<div class="language-promql highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="k">sum</span><span class="o">(</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w">    </span><span class="kr">rate</span><span class="o">(</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w">        </span><span class="nv">istio_requests_total</span><span class="p">{}[</span><span class="s">5m</span><span class="p">]</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">    </span><span class="o">)</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="o">)</span><span class="w"> </span><span class="k">by</span><span class="w"> </span><span class="o">(</span><span class="nv">destination_service_name</span><span class="o">)</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="o">*</span><span class="w"> </span><span class="k">on</span><span class="o">(</span><span class="nv">destination_service_name</span><span class="o">)</span><span class="w"> </span><span class="k">group_right</span><span class="w"> </span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">    </span><span class="kr">label_replace</span><span class="o">(</span><span class="nv">gatewayapi_httproute_labels</span><span class="p">{},</span><span class="w"> </span><span class="err">\</span><span class="p">&quot;</span><span class="s">destination_service_name\</span><span class="p">&quot;,</span><span class="w"> </span><span class="err">\</span><span class="p">&quot;</span><span class="s">$1\</span><span class="p">&quot;,</span><span class="err">\</span><span class="p">&quot;</span><span class="s">service\</span><span class="p">&quot;,</span><span class="w"> </span><span class="err">\</span><span class="p">&quot;</span><span class="s">(.+)\</span><span class="p">&quot;</span><span class="o">)</span>
-</span></code></pre></div>
-<p>Breaking this query down, there are 2 parts.
-The first part is getting the rate of requests hitting the Istio gateway, aggregated
-to 5m intervals:</p>
-<div class="language-promql highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="k">sum</span><span class="o">(</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="w">    </span><span class="kr">rate</span><span class="o">(</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="w">        </span><span class="nv">destination_service_name</span><span class="p">{}[</span><span class="s">5m</span><span class="p">]</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">    </span><span class="o">)</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="o">)</span><span class="w"> </span><span class="k">by</span><span class="w"> </span><span class="o">(</span><span class="nv">destination_service_name</span><span class="o">)</span>
-</span></code></pre></div>
-<p>The result set here will include a label for the destination service name (i.e.
-the Service in Kubernetes). This label is key to looking up the HTTPRoute this
-traffic belongs to.</p>
-<p>The 2nd part of the query uses the <code>gatewayapi_httproute_labels</code> metric and the
-<code>label_replace</code> function. The <code>gatewayapi_httproute_labels</code> metric gives a list
-of all httproutes, including any labels on them. The HTTPRoute in this example
-has a label called 'service', set to be the same as the Istio service name.
-This allows us to join the 2 results set.
-However, because the label doesn't match exactly (<code>destination_service_name</code> and <code>service</code>),
-we can replace the label so that it does match. That's what the <code>label_replace</code>
-does.</p>
-<div class="language-promql highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="w">    </span><span class="kr">label_replace</span><span class="o">(</span><span class="nv">gatewayapi_httproute_labels</span><span class="p">{},</span><span class="w"> </span><span class="err">\</span><span class="p">&quot;</span><span class="s">destination_service_name\</span><span class="p">&quot;,</span><span class="w"> </span><span class="err">\</span><span class="p">&quot;</span><span class="s">$1\</span><span class="p">&quot;,</span><span class="err">\</span><span class="p">&quot;</span><span class="s">service\</span><span class="p">&quot;,</span><span class="w"> </span><span class="err">\</span><span class="p">&quot;</span><span class="s">(.+)\</span><span class="p">&quot;</span><span class="o">)</span>
-</span></code></pre></div>
-<p>The 2 parts are joined together using vector matching.</p>
-<div class="language-promql highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="o">*</span><span class="w"> </span><span class="k">on</span><span class="o">(</span><span class="nv">destination_service_name</span><span class="o">)</span><span class="w"> </span><span class="k">group_right</span><span class="w"> </span>
-</span></code></pre></div>
-<ul>
-<li><code>*</code> is the binary operator i.e. multiplication (gives join like behaviour)</li>
-<li><code>on()</code> specifies which labels to "join" the 2 results with</li>
-<li><code>group_right</code> enables a one to many matching.</li>
-</ul>
-<p>See the <a href="https://prometheus.io/docs/prometheus/latest/querying/operators/#vector-matching">Prometheus documentation</a> for further details on matching.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/observability/tracing/index.html b/0.10.0/kuadrant-operator/doc/observability/tracing/index.html
deleted file mode 100644
index 14c6c79f5..000000000
--- a/0.10.0/kuadrant-operator/doc/observability/tracing/index.html
+++ /dev/null
@@ -1,3629 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/observability/tracing/">
-      
-      
-        <link rel="prev" href="../examples/">
-      
-      
-        <link rel="next" href="../../../../authorino/docs/user-guides/observability/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Tracing - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#enabling-tracing-with-a-central-collector" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Tracing
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#introduction" class="md-nav__link">
-    <span class="md-ellipsis">
-      Introduction
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#configuration-steps" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configuration Steps
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Configuration Steps">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#istio-tracing-configuration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Istio Tracing Configuration
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-tracing-configuration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Tracing Configuration
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#troubleshooting-flow-using-traces-and-logs" class="md-nav__link">
-    <span class="md-ellipsis">
-      Troubleshooting Flow Using Traces and Logs
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#introduction" class="md-nav__link">
-    <span class="md-ellipsis">
-      Introduction
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#configuration-steps" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configuration Steps
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Configuration Steps">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#istio-tracing-configuration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Istio Tracing Configuration
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-tracing-configuration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Tracing Configuration
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#troubleshooting-flow-using-traces-and-logs" class="md-nav__link">
-    <span class="md-ellipsis">
-      Troubleshooting Flow Using Traces and Logs
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/observability/tracing.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="enabling-tracing-with-a-central-collector">Enabling tracing with a central collector<a class="headerlink" href="#enabling-tracing-with-a-central-collector" title="Permanent link">&para;</a></h1>
-<h2 id="introduction">Introduction<a class="headerlink" href="#introduction" title="Permanent link">&para;</a></h2>
-<p>This guide outlines the steps to enable tracing in Istio and Kuadrant components (Authorino and Limitador), directing traces to a central collector for improved observability and troubleshooting. We'll also explore a typical troubleshooting flow using traces and logs.</p>
-<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li>A Kubernetes cluster with Istio and Kuadrant installed.</li>
-<li>A trace collector (e.g., Jaeger or Tempo) configured to support <a href="https://opentelemetry.io/">OpenTelemetry</a> (OTel).</li>
-</ul>
-<h2 id="configuration-steps">Configuration Steps<a class="headerlink" href="#configuration-steps" title="Permanent link">&para;</a></h2>
-<h3 id="istio-tracing-configuration">Istio Tracing Configuration<a class="headerlink" href="#istio-tracing-configuration" title="Permanent link">&para;</a></h3>
-<p>Enable tracing in Istio by using the <a href="https://istio.io/v1.20/docs/tasks/observability/distributed-tracing/telemetry-api/">Telemetry API</a>.
-Depending on your method for installing Istio, you will need to configure a tracing <code>extensionProvider</code> in your MeshConfig, Istio or IstioOperator resource as well.
-Here is an example Telemetry and Istio config to sample 100% of requests, if using the Istio Sail Operator.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">telemetry.istio.io/v1alpha1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Telemetry</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">mesh-default</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="nt">tracing</span><span class="p">:</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">providers</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">tempo-otlp</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">    </span><span class="nt">randomSamplingPercentage</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">100</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="nn">---</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">operator.istio.io/v1alpha1</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Istio</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">  </span><span class="nt">values</span><span class="p">:</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">    </span><span class="nt">meshConfig</span><span class="p">:</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">      </span><span class="nt">defaultConfig</span><span class="p">:</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">        </span><span class="nt">tracing</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">      </span><span class="nt">enableTracing</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">      </span><span class="nt">extensionProviders</span><span class="p">:</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">tempo-otlp</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="w">        </span><span class="nt">opentelemetry</span><span class="p">:</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">4317</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="w">          </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">tempo.tempo.svc.cluster.local</span>
-</span></code></pre></div>
-<p><strong>Important:</strong></p>
-<p>The OpenTelemetry collector protocol should be explicitly set in the service port <code>name</code> or <code>appProtocol</code> fields as per the <a href="https://istio.io/latest/docs/ops/configuration/traffic-management/protocol-selection/#explicit-protocol-selection">Istio documentation</a>. For example, when using gRPC, the port <code>name</code> should begin with <code>grpc-</code> or the <code>appProtocol</code> should be <code>grpc</code>.</p>
-<h3 id="kuadrant-tracing-configuration">Kuadrant Tracing Configuration<a class="headerlink" href="#kuadrant-tracing-configuration" title="Permanent link">&para;</a></h3>
-<p>The Authorino and Limitador components have request tracing capabilities.
-Here is an example configuration to enable and send traces to a central collector.
-Ensure the collector is the same one that Istio is sending traces so that they can be correlated later.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">operator.authorino.kuadrant.io/v1beta1</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Authorino</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="nt">tracing</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">    </span><span class="nt">endpoint</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rpc://tempo.tempo.svc.cluster.local:4317</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="nt">insecure</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="nn">---</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w">  </span><span class="nt">tracing</span><span class="p">:</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w">    </span><span class="nt">endpoint</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rpc://tempo.tempo.svc.cluster.local:4317</span>
-</span></code></pre></div>
-<p>Once the changes are applied, the authorino and limitador components will be redeployed tracing enabled.</p>
-<p><strong>Note:</strong></p>
-<p>There are <a href="https://github.com/Kuadrant/architecture/issues/48">plans</a> to consolidate the tracing configuration to a single location i.e. the Kuadrant CR.
-This will eventually eliminate the need to configure tracing in both the Authorino and Limitador CRs.</p>
-<p><strong>Important:</strong></p>
-<p>Currently, trace IDs <a href="https://github.com/envoyproxy/envoy/issues/22028">do not propagate</a> to wasm modules in Istio/Envoy, affecting trace continuity in Limitador.
-This means that requests passed to limitador will not have the relavant 'parent' trace ID in its trace information.
-If however the trace initiation point is outside of Envoy/Istio, the 'parent' trace ID will be available to limitador and included in traces passed to the collector.
-This has an impact on correlating traces from limitador with traces from authorino, the gateway and any other components in the path of requests.</p>
-<h2 id="troubleshooting-flow-using-traces-and-logs">Troubleshooting Flow Using Traces and Logs<a class="headerlink" href="#troubleshooting-flow-using-traces-and-logs" title="Permanent link">&para;</a></h2>
-<p>Using a tracing interface like the Jaeger UI or Grafana, you can search for trace information by the trace ID.
-You may get the trace ID from logs, or from a header in a sample request you want to troubleshoot.
-You can also search for recent traces, filtering by the service you want to focus on.</p>
-<p>Here is an example trace in the Grafana UI showing the total request time from the gateway (Istio), the time to check the curent rate limit count (and update it) in limitador and the time to check auth in Authorino:</p>
-<p><img alt="Trace in Grafana UI" src="../grafana_trace.png" /></p>
-<p>In limitador, it is possible to enable request logging with trace IDs to get more information on requests.
-This requires the log level to be increased to at least debug, so the verbosity must be set to 3 or higher in the Limitador CR. For example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="nt">verbosity</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">3</span>
-</span></code></pre></div>
-<p>A log entry will look something like this, with the <code>traceparent</code> field holding the trace ID:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>&quot;Request received: Request { metadata: MetadataMap { headers: {&quot;te&quot;: &quot;trailers&quot;, &quot;grpc-timeout&quot;: &quot;5000m&quot;, &quot;content-type&quot;: &quot;application/grpc&quot;, &quot;traceparent&quot;: &quot;00-4a2a933a23df267aed612f4694b32141-00f067aa0ba902b7-01&quot;, &quot;x-envoy-internal&quot;: &quot;true&quot;, &quot;x-envoy-expected-rq-timeout-ms&quot;: &quot;5000&quot;} }, message: RateLimitRequest { domain: &quot;default/toystore&quot;, descriptors: [RateLimitDescriptor { entries: [Entry { key: &quot;limit.general_user__f5646550&quot;, value: &quot;1&quot; }, Entry { key: &quot;metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid&quot;, value: &quot;alice&quot; }], limit: None }], hits_addend: 1 }, extensions: Extensions }&quot;
-</span></code></pre></div>
-<p>If you centrally aggregate logs using something like promtail and loki, you can jump between trace information and the relevant logs for that service:</p>
-<p><img alt="Trace and logs in Grafana UI" src="../grafana_tracing_loki.png" /></p>
-<p>Using a combination of tracing and logs, you can visualise and troubleshoot reuqest timing issues and drill down to specific services.
-This method becomes even more powerful when combined with <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/observability/metrics/">metrics</a> and <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/observability/examples/">dashboards</a> to get a more complete picture of your users traffic.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/proposals/images/authpolicy-control-structure.png b/0.10.0/kuadrant-operator/doc/proposals/images/authpolicy-control-structure.png
deleted file mode 100644
index ee6e621ef585aa959d1307102111ccc3fe167529..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 60035
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
Ah5!Hn

diff --git a/0.10.0/kuadrant-operator/doc/proposals/rlp-target-gateway-resource/index.html b/0.10.0/kuadrant-operator/doc/proposals/rlp-target-gateway-resource/index.html
deleted file mode 100644
index 33fccccd2..000000000
--- a/0.10.0/kuadrant-operator/doc/proposals/rlp-target-gateway-resource/index.html
+++ /dev/null
@@ -1,3793 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/proposals/rlp-target-gateway-resource/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RLP can target a Gateway resource - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#rlp-can-target-a-gateway-resource" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RLP can target a Gateway resource
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#introduction" class="md-nav__link">
-    <span class="md-ellipsis">
-      Introduction
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#use-cases-targeting-a-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Use Cases targeting a gateway
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#goals" class="md-nav__link">
-    <span class="md-ellipsis">
-      Goals
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#envoys-rate-limit-service-protocol" class="md-nav__link">
-    <span class="md-ellipsis">
-      Envoy's Rate Limit Service Protocol
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#schema-crd-of-the-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Schema (CRD) of the RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrant-operators-behavior" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant-operator's behavior
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Kuadrant-operator's behavior">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#virtualhosting-ratelimitpolicies" class="md-nav__link">
-    <span class="md-ellipsis">
-      "VirtualHosting" RateLimitPolicies
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#multiple-httproutes-with-the-same-hostname" class="md-nav__link">
-    <span class="md-ellipsis">
-      Multiple HTTPRoutes with the same hostname
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#overlapping-httproutes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overlapping HTTPRoutes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      examples
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="examples">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#rate-limit-domain-limitador-namespace" class="md-nav__link">
-    <span class="md-ellipsis">
-      rate limit domain / limitador namespace
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#schema-of-the-wasm-filter-configuration-object-the-pluginconfig" class="md-nav__link">
-    <span class="md-ellipsis">
-      Schema of the WASM filter configuration object: the PluginConfig
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#wasm-shim" class="md-nav__link">
-    <span class="md-ellipsis">
-      WASM-SHIM
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="WASM-SHIM">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#rate-limit-configurations" class="md-nav__link">
-    <span class="md-ellipsis">
-      rate limit configurations
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#example" class="md-nav__link">
-    <span class="md-ellipsis">
-      example
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/proposals/rlp-target-gateway-resource.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="rlp-can-target-a-gateway-resource">RLP can target a Gateway resource<a class="headerlink" href="#rlp-can-target-a-gateway-resource" title="Permanent link">&para;</a></h1>
-<p>Previous version: https://hackmd.io/IKEYD6NrSzuGQG1nVhwbcw</p>
-<p>Based on: https://hackmd.io/_1k6eLCNR2eb9RoSzOZetg</p>
-<h2 id="introduction">Introduction<a class="headerlink" href="#introduction" title="Permanent link">&para;</a></h2>
-<p>The <a href="https://github.com/Kuadrant/kuadrant-operator/blob/fa2b52967409b7c4ea2c2e3412ecf80a8ad2b802/apis/apim/v1alpha1/ratelimitpolicy_types.go#L132">current RateLimitPolicy CRD</a> already implements a <code>targetRef</code> with a reference to <a href="https://gateway-api.sigs.k8s.io/v1alpha2/references/spec/#gateway.networking.k8s.io/v1alpha2.HTTPRoute">Gateway API's HTTPRoute</a>. This doc  captures the design and some implementation details of allowing the <code>targetRef</code> to reference a <a href="https://gateway-api.sigs.k8s.io/v1alpha2/references/spec/#gateway.networking.k8s.io/v1alpha2.Gateway">Gateway API's Gateway</a>.</p>
-<p>Having in place this HTTPRoute - Gateway hierarchy, we are also considering to apply <a href="https://gateway-api.sigs.k8s.io/v1alpha2/references/policy-attachment/">Policy Attachment's</a> defaults/overrides approach to the RateLimitPolicy CRD. But for now, it will only be about targeting the Gateway resource.</p>
-<p><img alt="" src="https://i.imgur.com/UkivAqA.png" /></p>
-<p>On designing Kuadrant's rate limiting and considering Istio/Envoy's rate limiting offering, we hit two limitations (<a href="https://docs.google.com/document/d/1ve_8ZBq8TK_wnAZHg69M6-f_q1w-mX4vuP1BC1EuEO8/edit#bookmark=id.5wyq2fj56u94">described here</a>). Therefore, not giving up entirely in existing <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/network/ratelimit/v3/rate_limit.proto#extension-envoy-filters-network-ratelimit">Envoy's RateLimit Filter</a>, we decided to move on and leverage the Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/listeners/network_filters/wasm_filter">Wasm Network Filter</a> and implement rate limiting <a href="https://github.com/Kuadrant/wasm-shim">wasm-shim</a> module compliant with the Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/ratelimit/v3/rls.proto">Rate Limit Service (RLS)</a>. This wasm-shim module accepts a <a href="https://github.com/Kuadrant/kuadrant-operator/blob/fa2b52967409b7c4ea2c2e3412ecf80a8ad2b802/pkg/istio/wasm.go#L24">PluginConfig</a> struct object as input configuration object.</p>
-<h2 id="use-cases-targeting-a-gateway">Use Cases targeting a gateway<a class="headerlink" href="#use-cases-targeting-a-gateway" title="Permanent link">&para;</a></h2>
-<p>A key use case is being able to provide governance over what service providers can and cannot do when exposing a service via a shared ingress gateway. As well as providing certainty that no service is exposed without my ability as a cluster administrator to protect my infrastructure from unplanned load from badly behaving clients etc.</p>
-<h2 id="goals">Goals<a class="headerlink" href="#goals" title="Permanent link">&para;</a></h2>
-<p>The goal of this document is to define:</p>
-<ul>
-<li>The schema of this <code>PluginConfig</code> struct.</li>
-<li>The kuadrant-operator behavior filling the <code>PluginConfig</code> struct having as input the RateLimitPolicy k8s objects</li>
-<li>The behavior of the wasm-shim having the <code>PluginConfig</code> struct as input.</li>
-</ul>
-<h2 id="envoys-rate-limit-service-protocol">Envoy's Rate Limit Service Protocol<a class="headerlink" href="#envoys-rate-limit-service-protocol" title="Permanent link">&para;</a></h2>
-<p>Kuadrant's rate limit relies on the <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/ratelimit/v3/rls.proto">Rate Limit Service (RLS)</a>
-protocol, hence the gateway generates, based on a set of
-<a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/route/v3/route_components.proto#envoy-v3-api-msg-config-route-v3-ratelimit-action">actions</a>,
-a set of <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/common/ratelimit/v3/ratelimit.proto#envoy-v3-api-msg-extensions-common-ratelimit-v3-ratelimitdescriptor">descriptors</a>
-(one descriptor is a set of descriptor entries). Those descriptors are send to the external rate limit service provider.
-When multiple descriptors are provided, the external service provider will limit on ALL of them and
-return an OVER_LIMIT response if any of them are over limit.</p>
-<h2 id="schema-crd-of-the-ratelimitpolicy">Schema (CRD) of the RateLimitPolicy<a class="headerlink" href="#schema-crd-of-the-ratelimitpolicy" title="Permanent link">&para;</a></h2>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nn">---</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta1</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-rate-limit-policy</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute / Gateway</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myroute / mygateway</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">  </span><span class="nt">rateLimits</span><span class="p">:</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/admin/*&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">          </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">          </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;example.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">      </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">              </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">              </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;yes&quot;</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">      </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;admin</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">yes&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">          </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">500</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="w">          </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="w">          </span><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span></code></pre></div>
-<p><code>.spec.rateLimits</code> holds a list of rate limit configurations represented by the object <code>RateLimit</code>.
-Each <code>RateLimit</code> object represents a complete rate limit configuration. It contains three fields:</p>
-<ul>
-<li>
-<p><code>rules</code> (optional): Rules allow matching <code>hosts</code> and/or <code>methods</code> and/or <code>paths</code>.
-Matching occurs when at least one rule applies against the incoming request.
-If rules are not set, it is equivalent to matching all the requests.</p>
-</li>
-<li>
-<p><code>configurations</code> (required): Specifies a set of rate limit configurations that could be applied.
-The rate limit configuration object is the equivalent of the
-<a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/route/v3/route_components.proto#envoy-v3-api-msg-config-route-v3-ratelimit">config.route.v3.RateLimit</a> envoy object.
-One configuration is, in turn, a list of <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/route/v3/route_components.proto#envoy-v3-api-msg-config-route-v3-ratelimit-action">rate limit actions</a>.
-Each action populates a descriptor entry. A vector of descriptor entries compose a descriptor.
-Each configuration produces, at most, one descriptor.
-Depending on the incoming request, one configuration may or may not produce a rate limit descriptor.
-These rate limiting configuration rules provide flexibility to produce multiple descriptors.
-For example, you may want to define one generic rate limit descriptor and another descriptor
-depending on some header.
-If the header does not exist, the second descriptor is not generated, but traffic keeps being rate
-limited based on the generic descriptor.</p>
-</li>
-</ul>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">request_headers</span><span class="p">:</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">        </span><span class="nt">header_name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;X-MY-CUSTOM-HEADER&quot;</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">        </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;custom-header&quot;</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">        </span><span class="nt">skip_if_absent</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">        </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">        </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-<ul>
-<li><code>limits</code> (optional): configuration of the rate limiting service (<a href="https://github.com/Kuadrant/limitador">Limitador</a>).
-Check out limitador documentation for more information about the fields of each <code>Limit</code> object.</li>
-</ul>
-<p><strong>Note:</strong> No <code>namespace</code>/<code>domain</code> defined. Kuadrant operator will figure out.</p>
-<p><strong>Note:</strong> There is no <code>PREAUTH</code>, <code>POSTAUTH</code> stage defined. Ratelimiting filter should be placed after authorization filter to enable authenticated rate limiting. In the future, <code>stage</code> can be implemented.</p>
-<h2 id="kuadrant-operators-behavior">Kuadrant-operator's behavior<a class="headerlink" href="#kuadrant-operators-behavior" title="Permanent link">&para;</a></h2>
-<p>One HTTPRoute can only be targeted by one rate limit policy.</p>
-<p>Similarly, one Gateway can only be targeted by one rate limit policy.</p>
-<p>However, indirectly, one gateway will be affected by multiple rate limit policies.
-It is by design of the Gateway API, one gateway can be referenced by multiple HTTPRoute objects.
-Furthermore, one HTTPRoute can reference multiple gateways.</p>
-<p>The kuadrant operator will aggregate all the rate
-limit policies that apply for each gateway, including RLP targeting HTTPRoutes and Gateways.</p>
-<h4 id="virtualhosting-ratelimitpolicies">"VirtualHosting" RateLimitPolicies<a class="headerlink" href="#virtualhosting-ratelimitpolicies" title="Permanent link">&para;</a></h4>
-<p>Rate limit policies are scoped by the domains defined at the referenced HTTPRoute's
-<a href="https://gateway-api.sigs.k8s.io/v1alpha2/references/spec/#gateway.networking.k8s.io/v1alpha2.HTTPRouteSpec">hostnames</a>
-and Gateway's Listener's <a href="https://gateway-api.sigs.k8s.io/v1alpha2/references/spec/#gateway.networking.k8s.io%2fv1alpha2.Listener">Hostname</a>.</p>
-<h4 id="multiple-httproutes-with-the-same-hostname">Multiple HTTPRoutes with the same hostname<a class="headerlink" href="#multiple-httproutes-with-the-same-hostname" title="Permanent link">&para;</a></h4>
-<p>When there are multiple HTTPRoutes with the same hostname, HTTPRoutes are all admitted and
-envoy merge the routing configuration in the same virtualhost. In these cases, the control plane
-has to "merge" the rate limit configuration into a single entry for the wasm filter.</p>
-<h4 id="overlapping-httproutes">Overlapping HTTPRoutes<a class="headerlink" href="#overlapping-httproutes" title="Permanent link">&para;</a></h4>
-<p>If some RLP targets a route for <code>*.com</code> and other RLP targets another route for <code>api.com</code>,
-the control plane does not do any <em>merging</em>.
-A request coming for <code>api.com</code> will be rate limited with the rules from the RLP targeting
-the route <code>api.com</code>.
-Also, a request coming for <code>other.com</code> will be rate limited with the rules from the RLP targeting
-the route <code>*.com</code>.</p>
-<h3 id="examples">examples<a class="headerlink" href="#examples" title="Permanent link">&para;</a></h3>
-<p>RLP A -&gt; HTTPRoute A (<code>api.toystore.com</code>) -&gt; Gateway G (<code>*.com</code>)</p>
-<p>RLP B -&gt; HTTPRoute B (<code>other.toystore.com</code>) -&gt; Gateway G (<code>*.com</code>)</p>
-<p>RLP H -&gt; HTTPRoute H (<code>*.toystore.com</code>) -&gt; Gateway G (<code>*.com</code>)</p>
-<p>RLP G -&gt; Gateway G (<code>*.com</code>)</p>
-<p>Request 1 (<code>api.toystore.com</code>) -&gt; apply RLP A and RLP G</p>
-<p>Request 2 (<code>other.toystore.com</code>) -&gt; apply RLP B and RLP G</p>
-<p>Request 3 (<code>unknown.toystore.com</code>) -&gt; apply RLP H and RLP G</p>
-<p>Request 4 (<code>other.com</code>) -&gt; apply RLP G</p>
-<h4 id="rate-limit-domain-limitador-namespace">rate limit domain / limitador namespace<a class="headerlink" href="#rate-limit-domain-limitador-namespace" title="Permanent link">&para;</a></h4>
-<p>The kuadrant operator will add <code>domain</code> attribute of the Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/ratelimit/v3/rls.proto">Rate Limit Service (RLS)</a>. It will also add the <code>namespace</code> attribute of the Limitador's rate limit config. The operator will ensure that the associated actions and rate limits have a common domain/namespace.</p>
-<p>The value of this domain/namespace seems to be related to the virtualhost for which rate limit applies.</p>
-<h2 id="schema-of-the-wasm-filter-configuration-object-the-pluginconfig">Schema of the WASM filter configuration object: the <code>PluginConfig</code><a class="headerlink" href="#schema-of-the-wasm-filter-configuration-object-the-pluginconfig" title="Permanent link">&para;</a></h2>
-<p>Currently the PluginConfig looks like this:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="c1">#  The filter’s behaviour in case the rate limiting service does not respond back. When it is set to true, Envoy will not allow traffic in case of communication failure between rate limiting service and the proxy.</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">failure_mode_deny</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">ratelimitpolicies</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">default/toystore</span><span class="p">:</span><span class="w"> </span><span class="c1"># rate limit policy {NAMESPACE/NAME}</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">    </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="c1"># HTTPRoute hostnames</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;*.toystore.com&#39;</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">    </span><span class="nt">rules</span><span class="p">:</span><span class="w"> </span><span class="c1"># route level actions</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operations</span><span class="p">:</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/admin/toy</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">            </span><span class="nt">methods</span><span class="p">:</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DELETE</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="w">        </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a><span class="w">              </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">yes</span>
-</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a><span class="w">              </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a><span class="w">    </span><span class="nt">global_actions</span><span class="p">:</span><span class="w"> </span><span class="c1"># virtualHost level actions</span>
-</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-2-21"><a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a><span class="w">          </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">yes</span>
-</span><span id="__span-2-22"><a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a><span class="w">          </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">vhaction</span>
-</span><span id="__span-2-23"><a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a><span class="w">    </span><span class="nt">upstream_cluster</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rate-limit-cluster</span><span class="w"> </span><span class="c1"># Limitador address reference</span>
-</span><span id="__span-2-24"><a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a><span class="w">    </span><span class="nt">domain</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span><span class="w"> </span><span class="c1"># RLS protocol domain value</span>
-</span></code></pre></div>
-<p>Proposed new design for the WASM filter configuration object (<code>PluginConfig</code> struct):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="c1">#  The filter’s behaviour in case the rate limiting service does not respond back. When it is set to true, Envoy will not allow traffic in case of communication failure between rate limiting service and the proxy.</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">failure_mode_deny</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="nt">rate_limit_policies</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">    </span><span class="nt">rate_limit_domain</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">    </span><span class="nt">upstream_cluster</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rate-limit-cluster</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">    </span><span class="nt">hostnames</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">    </span><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">paths</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;/admin/toy&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="w">            </span><span class="nt">methods</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;GET&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="w">            </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;pets.toystore.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="w">        </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="w">                </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="w">                </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-<p>Update highlights:</p>
-<ul>
-<li>[<em>minor</em>] <code>rate_limit_policies</code> is a list instead of a map indexed by the name/namespace.</li>
-<li>[<em>major</em>] no distinction between "rules" and global actions</li>
-<li>[<em>major</em>] more aligned with RLS: <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/route/v3/route_components.proto#envoy-v3-api-field-config-route-v3-virtualhost-rate-limits">multiple descriptors</a> structured by "rate limit configurations" with matching rules</li>
-</ul>
-<h2 id="wasm-shim">WASM-SHIM<a class="headerlink" href="#wasm-shim" title="Permanent link">&para;</a></h2>
-<p>WASM filter rate limit policies are not exactly the same as user managed RateLimitPolicy
-custom resources. The WASM filter rate limit policies is part of the  internal configuration
-and therefore not exposed to the end user.</p>
-<p>At the WASM filter level, there are no route level or gateway level rate limit policies.
-The rate limit policies in the wasm plugin configuration may not map 1:1 to
-user managed RateLimitPolicy custom resources. WASM rate limit policies have an internal logical
-name and a set of hostnames to activate it based on the incoming request’s host header.</p>
-<p>The WASM filter builds a tree based data structure holding the rate limit policies.
-The longest (sub)domain match is used to select the policy to be applied.
-Only one policy is being applied per invocation.</p>
-<h4 id="rate-limit-configurations">rate limit configurations<a class="headerlink" href="#rate-limit-configurations" title="Permanent link">&para;</a></h4>
-<p>The WASM filter configuration object contains a list of rate limit configurations
-to build a list of Envoy's RLS descriptors. These configurations are defined at</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>rate_limit_policies[*].gateway_actions[*].configurations
-</span></code></pre></div>
-<p>For example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">   </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">        </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w">        </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-<p>How to read the policy:</p>
-<ul>
-<li>
-<p>Each configuration produces, at most, one descriptor. Depending on the incoming request, one configuration may or may not produce a rate limit descriptor.</p>
-</li>
-<li>
-<p>Each policy configuration has associated, optionally, a set of rules to match. Rules allow matching <code>hosts</code> and/or <code>methods</code> and/or <code>paths</code>. Matching occurs when at least one rule applies against the incoming request. If rules are not set, it is equivalent to matching all the requests.</p>
-</li>
-<li>
-<p>Each configuration object defines a list of actions. Each action may (or may not) produce a descriptor entry (descriptor list item). If an action cannot append a descriptor entry, no descriptor is generated for the configuration.</p>
-</li>
-</ul>
-<p><em>Note</em>: The external rate limit service will be called when the <code>gateway_actions</code> object produces at least one not empty descriptor.</p>
-<h4 id="example">example<a class="headerlink" href="#example" title="Permanent link">&para;</a></h4>
-<p>WASM filter rate limit policy for <code>*.toystore.com</code>. I want some rate limit descriptors configuration
-only for <code>api.toystore.com</code> and another set of descriptors for <code>admin.toystore.com</code>.
-The wasm filter config would look like this:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">failure_mode_deny</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nt">rate_limit_policies</span><span class="p">:</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">    </span><span class="nt">rate_limit_domain</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w">    </span><span class="nt">upstream_cluster</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rate-limit-cluster</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w">    </span><span class="nt">hostnames</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;*.toystore.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="w">    </span><span class="nt">gateway_actions</span><span class="p">:</span>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">configurations</span><span class="p">:</span><span class="w">  </span><span class="c1"># no rules. Applies to all *.toystore.com traffic</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="w">                  </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="w">                  </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;api.toystore.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="w">        </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="w">                  </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="w">                  </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">hosts</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;admin.toystore.com&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="w">        </span><span class="nt">configurations</span><span class="p">:</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">actions</span><span class="p">:</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">generic_key</span><span class="p">:</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="w">                  </span><span class="nt">descriptor_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="w">                  </span><span class="nt">descriptor_value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span></code></pre></div>
-<ul>
-<li>When a request for <code>api.toystore.com</code> hits the filter, the descriptors generated would be:</li>
-</ul>
-<p>descriptor 1
-<div class="language-text highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>(&quot;toystore-app&quot;, &quot;1&quot;)
-</span></code></pre></div>
-descriptor 2
-<div class="language-text highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>(&quot;api&quot;, &quot;1&quot;)
-</span></code></pre></div></p>
-<ul>
-<li>When a request for <code>admin.toystore.com</code> hits the filter, the descriptors generated would be:</li>
-</ul>
-<p>descriptor 1
-<div class="language-text highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>(&quot;toystore-app&quot;, &quot;1&quot;)
-</span></code></pre></div>
-descriptor 2
-<div class="language-text highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>(&quot;admin&quot;, &quot;1&quot;)
-</span></code></pre></div></p>
-<ul>
-<li>When a request for <code>other.toystore.com</code> hits the filter, the descriptors generated would be:
-descriptor 1
-<div class="language-text highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>(&quot;toystore-app&quot;, &quot;1&quot;)
-</span></code></pre></div></li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/rate-limiting/index.html b/0.10.0/kuadrant-operator/doc/rate-limiting/index.html
deleted file mode 100644
index 193a67077..000000000
--- a/0.10.0/kuadrant-operator/doc/rate-limiting/index.html
+++ /dev/null
@@ -1,4255 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/rate-limiting/">
-      
-      
-        <link rel="prev" href="../reference/authpolicy/">
-      
-      
-        <link rel="next" href="../reference/ratelimitpolicy/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-rate-limiting" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How it works">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#envoys-rate-limit-service-protocol" class="md-nav__link">
-    <span class="md-ellipsis">
-      Envoy's Rate Limit Service Protocol
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#the-ratelimitpolicy-custom-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      The RateLimitPolicy custom resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The RateLimitPolicy custom resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#high-level-example-and-field-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      High-level example and field definition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-the-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the RateLimitPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Using the RateLimitPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-httproute-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a HTTPRoute networking resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Targeting a HTTPRoute networking resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#hostnames-and-wildcards" class="md-nav__link">
-    <span class="md-ellipsis">
-      Hostnames and wildcards
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-gateway-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a Gateway networking resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Targeting a Gateway networking resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overlapping-gateway-and-httproute-ratelimitpolicies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overlapping Gateway and HTTPRoute RateLimitPolicies
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limit-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limit definition
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#route-selectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Route selectors
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Route selectors">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#when-conditions" class="md-nav__link">
-    <span class="md-ellipsis">
-      when conditions
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#known-limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Known limitations
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Known limitations">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitation-multiple-network-resources-with-identical-hostnames" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitation: Multiple network resources with identical hostnames
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#implementation-details" class="md-nav__link">
-    <span class="md-ellipsis">
-      Implementation details
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How it works">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#envoys-rate-limit-service-protocol" class="md-nav__link">
-    <span class="md-ellipsis">
-      Envoy's Rate Limit Service Protocol
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#the-ratelimitpolicy-custom-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      The RateLimitPolicy custom resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The RateLimitPolicy custom resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#high-level-example-and-field-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      High-level example and field definition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-the-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the RateLimitPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Using the RateLimitPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-httproute-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a HTTPRoute networking resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Targeting a HTTPRoute networking resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#hostnames-and-wildcards" class="md-nav__link">
-    <span class="md-ellipsis">
-      Hostnames and wildcards
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-gateway-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a Gateway networking resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Targeting a Gateway networking resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overlapping-gateway-and-httproute-ratelimitpolicies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overlapping Gateway and HTTPRoute RateLimitPolicies
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limit-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limit definition
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#route-selectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Route selectors
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Route selectors">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#when-conditions" class="md-nav__link">
-    <span class="md-ellipsis">
-      when conditions
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#known-limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Known limitations
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Known limitations">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitation-multiple-network-resources-with-identical-hostnames" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitation: Multiple network resources with identical hostnames
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#implementation-details" class="md-nav__link">
-    <span class="md-ellipsis">
-      Implementation details
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/rate-limiting.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrant-rate-limiting">Kuadrant Rate Limiting<a class="headerlink" href="#kuadrant-rate-limiting" title="Permanent link">&para;</a></h1>
-<p>A Kuadrant RateLimitPolicy custom resource, often abbreviated "RateLimitPolicy":</p>
-<ol>
-<li>Targets Gateway API networking resources such as <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.HTTPRoute">HTTPRoutes</a> and <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.Gateway">Gateways</a>, using these resources to obtain additional context, i.e., which traffic workload (HTTP attributes, hostnames, user attributes, etc) to rate limit.</li>
-<li>Supports targeting subsets (sections) of a network resource to apply the limits to.</li>
-<li>Abstracts the details of the underlying Rate Limit protocol and configuration resources, that have a much broader remit and surface area.</li>
-<li>Enables cluster operators to set defaults that govern behavior at the lower levels of the network, until a more specific policy is applied.</li>
-</ol>
-<h2 id="how-it-works">How it works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h2>
-<h3 id="envoys-rate-limit-service-protocol">Envoy's Rate Limit Service Protocol<a class="headerlink" href="#envoys-rate-limit-service-protocol" title="Permanent link">&para;</a></h3>
-<p>Kuadrant's Rate Limit implementation relies on the Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/ratelimit/v3/rls.proto">Rate Limit Service (RLS)</a> protocol. The workflow per request goes:</p>
-<ol>
-<li>On incoming request, the gateway checks the matching rules for enforcing rate limits, as stated in the RateLimitPolicy custom resources and targeted Gateway API networking objects</li>
-<li>If the request matches, the gateway sends one <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/ratelimit/v3/rls.proto#service-ratelimit-v3-ratelimitrequest">RateLimitRequest</a> to the external rate limiting service ("Limitador").</li>
-<li>The external rate limiting service responds with a <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/ratelimit/v3/rls.proto#service-ratelimit-v3-ratelimitresponse">RateLimitResponse</a> back to the gateway with either an <code>OK</code> or <code>OVER_LIMIT</code> response code.</li>
-</ol>
-<p>A RateLimitPolicy and its targeted Gateway API networking resource contain all the statements to configure both the ingress gateway and the external rate limiting service.</p>
-<h3 id="the-ratelimitpolicy-custom-resource">The RateLimitPolicy custom resource<a class="headerlink" href="#the-ratelimitpolicy-custom-resource" title="Permanent link">&para;</a></h3>
-<h4 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h4>
-<p>The <code>RateLimitPolicy</code> spec includes, basically, two parts:</p>
-<ul>
-<li>A reference to an existing Gateway API resource (<code>spec.targetRef</code>)</li>
-<li>Limit definitions (<code>spec.limits</code>)</li>
-</ul>
-<p>Each limit definition includes:</p>
-<ul>
-<li>A set of rate limits (<code>spec.limits.&lt;limit-name&gt;.rates[]</code>)</li>
-<li>(Optional) A set of dynamic counter qualifiers (<code>spec.limits.&lt;limit-name&gt;.counters[]</code>)</li>
-<li>(Optional) A set of route selectors, to further qualify the specific routing rules when to activate the limit (<code>spec.limits.&lt;limit-name&gt;.routeSelectors[]</code>)</li>
-<li>(Optional) A set of additional dynamic conditions to activate the limit (<code>spec.limits.&lt;limit-name&gt;.when[]</code>)</li>
-</ul>
-<p>The limit definitions (<code>limits</code>) can be declared at the top-level level of the spec (with the semantics of <em>defaults</em>) or alternatively within explicit <code>defaults</code> or <code>overrides</code> blocks.</p>
-<table>
-  <tbody>
-    <tr>
-      <td>Check out Kuadrant <a href="https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md">RFC 0002</a> to learn more about the Well-known Attributes that can be used to define counter qualifiers (<code>counters</code>) and conditions (<code>when</code>).</td>
-    </tr>
-  </tbody>
-</table>
-
-<h4 id="high-level-example-and-field-definition">High-level example and field definition<a class="headerlink" href="#high-level-example-and-field-definition" title="Permanent link">&para;</a></h4>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-rate-limit-policy</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="c1"># Reference to an existing networking resource to attach the policy to. REQUIRED.</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="c1"># It can be a Gateway API HTTPRoute or Gateway resource.</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span><span class="c1"># It can only refer to objects in the same namespace as the RateLimitPolicy.</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute / Gateway</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myroute / mygateway</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">  </span><span class="c1"># The limits definitions to apply to the network traffic routed through the targeted resource.</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">  </span><span class="c1"># Equivalent to if otherwise declared within `defaults`.</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">    </span><span class="s">&quot;my_limit&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">      </span><span class="c1"># The rate limits associated with this limit definition. REQUIRED.</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">      </span><span class="c1"># E.g., to specify a 50rps rate limit, add `{ limit: 50, duration: 1, unit: secod }`</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="w">      </span><span class="c1"># Counter qualifiers.</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="w">      </span><span class="c1"># Each dynamic value in the data plane starts a separate counter, combined with each rate limit.</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="w">      </span><span class="c1"># E.g., to define a separate rate limit for each user name detected by the auth layer, add `metadata.filter_metadata.envoy\.filters\.http\.ext_authz.username`.</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="w">      </span><span class="c1"># Check out Kuadrant RFC 0002 (https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md) to learn more about the Well-known Attributes that can be used in this field.</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="w">      </span><span class="nt">counters</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="w">      </span><span class="c1"># Further qualification of the scpecific HTTPRouteRules within the targeted HTTPRoute that should trigger the limit.</span>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="w">      </span><span class="c1"># Each element contains a HTTPRouteMatch object that will be used to select HTTPRouteRules that include at least one identical HTTPRouteMatch.</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="w">      </span><span class="c1"># The HTTPRouteMatch part does not have to be fully identical, but the what&#39;s stated in the selector must be identically stated in the HTTPRouteRule.</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="w">      </span><span class="c1"># Do not use it on RateLimitPolicies that target a Gateway.</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a><span class="w">      </span><span class="c1"># Additional dynamic conditions to trigger the limit.</span>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a><span class="w">      </span><span class="c1"># Use it for filtering attributes not supported by HTTPRouteRule or with RateLimitPolicies that target a Gateway.</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a><span class="w">      </span><span class="c1"># Check out Kuadrant RFC 0002 (https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md) to learn more about the Well-known Attributes that can be used in this field.</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">…</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a><span class="w">    </span><span class="c1"># Explicit defaults. Used in policies that target a Gateway object to express default rules to be enforced on</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a><span class="w">    </span><span class="c1"># routes that lack a more specific policy attached to.</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a><span class="w">    </span><span class="c1"># Mutually exclusive with `overrides` and with declaring `limits` at the top-level of the spec.</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a><span class="w">    </span><span class="nt">defaults</span><span class="p">:</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a><span class="w">      </span><span class="nt">limits</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a><span class="w">    </span><span class="c1"># Overrides. Used in policies that target a Gateway object to be enforced on all routes linked to the gateway,</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a><span class="w">    </span><span class="c1"># thus also overriding any more specific policy occasionally attached to any of those routes.</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a><span class="w">    </span><span class="c1"># Mutually exclusive with `defaults` and with declaring `limits` at the top-level of the spec.</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a><span class="w">    </span><span class="nt">overrides</span><span class="p">:</span>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49" href="#__codelineno-0-49"></a><span class="w">      </span><span class="nt">limits</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<h2 id="using-the-ratelimitpolicy">Using the RateLimitPolicy<a class="headerlink" href="#using-the-ratelimitpolicy" title="Permanent link">&para;</a></h2>
-<h3 id="targeting-a-httproute-networking-resource">Targeting a HTTPRoute networking resource<a class="headerlink" href="#targeting-a-httproute-networking-resource" title="Permanent link">&para;</a></h3>
-<p>When a RateLimitPolicy targets a HTTPRoute, the policy is enforced to all traffic routed according to the rules and hostnames specified in the HTTPRoute, across all Gateways referenced in the <code>spec.parentRefs</code> field of the HTTPRoute.</p>
-<p>The targeted HTTPRoute's rules and/or hostnames to which the policy must be enforced can be filtered to specific subsets, by specifying the <a href="../reference/route-selectors/#the-routeselectors-field"><code>routeSelectors</code></a> field of the limit definition.</p>
-<p>Target a HTTPRoute by setting the <code>spec.targetRef</code> field of the RateLimitPolicy as follows:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;RateLimitPolicy name&gt;</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;HTTPRoute Name&gt;</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<p><img alt="Rate limit policy targeting a HTTPRoute resource" src="https://i.imgur.com/ObfOp9u.png" /></p>
-<h4 id="hostnames-and-wildcards">Hostnames and wildcards<a class="headerlink" href="#hostnames-and-wildcards" title="Permanent link">&para;</a></h4>
-<p>If a RateLimitPolicy targets a route defined for <code>*.com</code> and another RateLimitPolicy targets another route for <code>api.com</code>, the Kuadrant control plane will not merge these two RateLimitPolicies. Unless one of the policies declare an <em>overrides</em> set of limites, the control plane will configure to mimic the behavior of gateway implementation by which the "most specific hostname wins", thus enforcing only the corresponding applicable policies and limit definitions.</p>
-<p>E.g., by default, a request coming for <code>api.com</code> will be rate limited according to the rules from the RateLimitPolicy that targets the route for <code>api.com</code>; while a request for <code>other.com</code> will be rate limited with the rules from the RateLimitPolicy targeting the route for <code>*.com</code>.</p>
-<p>See more examples in <a href="#overlapping-gateway-and-httproute-ratelimitpolicies">Overlapping Gateway and HTTPRoute RateLimitPolicies</a>.</p>
-<h3 id="targeting-a-gateway-networking-resource">Targeting a Gateway networking resource<a class="headerlink" href="#targeting-a-gateway-networking-resource" title="Permanent link">&para;</a></h3>
-<p>A RateLimitPolicy that targets a Gateway can declare a block of <em>defaults</em> (<code>spec.defaults</code>) or a block of <em>overrides</em> (<code>spec.overrides</code>). As a standard, gateway policies that do not specify neither defaults nor overrides, act as defaults.</p>
-<p>When declaring <em>defaults</em>, a RateLimitPolicy which targets a Gateway will be enforced to all HTTP traffic hitting the gateway, unless a more specific RateLimitPolicy targeting a matching HTTPRoute exists. Any new HTTPRoute referrencing the gateway as parent will be automatically covered by the default RateLimitPolicy, as well as changes in the existing HTTPRoutes.</p>
-<p><em>Defaults</em> provide cluster operators with the ability to protect the infrastructure against unplanned and malicious network traffic attempt, such as by setting safe default limits on hostnames and hostname wildcards.</p>
-<p>Inversely, a gateway policy that specify <em>overrides</em> declares a set of rules to be enforced on <em>all routes attached to the gateway</em>, thus atomically replacing any more specific policy occasionally attached to any of those routes.</p>
-<p>Target a Gateway HTTPRoute by setting the <code>spec.targetRef</code> field of the RateLimitPolicy as follows:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;RateLimitPolicy name&gt;</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;Gateway Name&gt;</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">  </span><span class="nt">defaults</span><span class="p">:</span><span class="w"> </span><span class="c1"># alternatively: `overrides`</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">    </span><span class="nt">limits</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nv">…</span><span class="p p-Indicator">}</span>
-</span></code></pre></div>
-<p><img alt="rate limit policy targeting a Gateway resource" src="https://i.imgur.com/UkivAqA.png" /></p>
-<h4 id="overlapping-gateway-and-httproute-ratelimitpolicies">Overlapping Gateway and HTTPRoute RateLimitPolicies<a class="headerlink" href="#overlapping-gateway-and-httproute-ratelimitpolicies" title="Permanent link">&para;</a></h4>
-<p>Two possible semantics are to be considered here – gateway policy <em>defaults</em> vs gateway policy <em>overrides</em>.</p>
-<p>Gateway RateLimitPolicies that declare <em>defaults</em> (or alternatively neither defaults nor overrides) protect all traffic routed through the gateway except where a more specific HTTPRoute RateLimitPolicy exists, in which case the HTTPRoute RateLimitPolicy prevails.</p>
-<p>Example with 4 RateLimitPolicies, 3 HTTPRoutes and 1 Gateway <em>default</em> (plus 2 HTTPRoute and 2 Gateways without RateLimitPolicies attached):</p>
-<ul>
-<li>RateLimitPolicy A → HTTPRoute A (<code>a.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>RateLimitPolicy B → HTTPRoute B (<code>b.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>RateLimitPolicy W → HTTPRoute W (<code>*.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>RateLimitPolicy G (defaults) → Gateway G (<code>*.com</code>)</li>
-</ul>
-<p>Expected behavior:</p>
-<ul>
-<li>Request to <code>a.toystore.com</code> → RateLimitPolicy A will be enforced</li>
-<li>Request to <code>b.toystore.com</code> → RateLimitPolicy B will be enforced</li>
-<li>Request to <code>other.toystore.com</code> → RateLimitPolicy W will be enforced</li>
-<li>Request to <code>other.com</code> (suppose a route exists) → RateLimitPolicy G will be enforced</li>
-<li>Request to <code>yet-another.net</code> (suppose a route and gateway exist) → No RateLimitPolicy will be enforced</li>
-</ul>
-<p>Gateway RateLimitPolicies that declare <em>overrides</em> protect all traffic routed through the gateway, regardless of existence of any more specific HTTPRoute RateLimitPolicy.</p>
-<p>Example with 4 RateLimitPolicies, 3 HTTPRoutes and 1 Gateway <em>override</em> (plus 2 HTTPRoute and 2 Gateways without RateLimitPolicies attached):</p>
-<ul>
-<li>RateLimitPolicy A → HTTPRoute A (<code>a.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>RateLimitPolicy B → HTTPRoute B (<code>b.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>RateLimitPolicy W → HTTPRoute W (<code>*.toystore.com</code>) → Gateway G (<code>*.com</code>)</li>
-<li>RateLimitPolicy G (overrides) → Gateway G (<code>*.com</code>)</li>
-</ul>
-<p>Expected behavior:</p>
-<ul>
-<li>Request to <code>a.toystore.com</code> → RateLimitPolicy G will be enforced</li>
-<li>Request to <code>b.toystore.com</code> → RateLimitPolicy G will be enforced</li>
-<li>Request to <code>other.toystore.com</code> → RateLimitPolicy G will be enforced</li>
-<li>Request to <code>other.com</code> (suppose a route exists) → RateLimitPolicy G will be enforced</li>
-<li>Request to <code>yet-another.net</code> (suppose a route and gateway exist) → No RateLimitPolicy will be enforced</li>
-</ul>
-<h3 id="limit-definition">Limit definition<a class="headerlink" href="#limit-definition" title="Permanent link">&para;</a></h3>
-<p>A limit will be activated whenever a request comes in and the request matches:</p>
-<ul>
-<li>any of the route rules selected by the limit (via <a href="../reference/route-selectors/#the-routeselectors-field"><code>routeSelectors</code></a> or implicit "catch-all" selector), and</li>
-<li>all of the <code>when</code> conditions specified in the limit.</li>
-</ul>
-<p>A limit can define:</p>
-<ul>
-<li>counters that are qualified based on dynamic values fetched from the request, or</li>
-<li>global counters (implicitly, when no qualified counter is specified)</li>
-</ul>
-<p>A limit is composed of one or more rate limits.</p>
-<p>E.g.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w">    </span><span class="s">&quot;toystore-all&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5000</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">    </span><span class="s">&quot;toystore-api-per-username&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">100</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1000</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">minute</span>
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="w">      </span><span class="nt">counters</span><span class="p">:</span>
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a><span class="w">        </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-3-23"><a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api.toystore.com</span>
-</span><span id="__span-3-24"><a id="__codelineno-3-24" name="__codelineno-3-24" href="#__codelineno-3-24"></a>
-</span><span id="__span-3-25"><a id="__codelineno-3-25" name="__codelineno-3-25" href="#__codelineno-3-25"></a><span class="w">    </span><span class="s">&quot;toystore-admin-unverified-users&quot;</span><span class="p p-Indicator">:</span>
-</span><span id="__span-3-26"><a id="__codelineno-3-26" name="__codelineno-3-26" href="#__codelineno-3-26"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-3-27"><a id="__codelineno-3-27" name="__codelineno-3-27" href="#__codelineno-3-27"></a>
-</span><span id="__span-3-28"><a id="__codelineno-3-28" name="__codelineno-3-28" href="#__codelineno-3-28"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">250</span>
-</span><span id="__span-3-29"><a id="__codelineno-3-29" name="__codelineno-3-29" href="#__codelineno-3-29"></a><span class="w">        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-3-30"><a id="__codelineno-3-30" name="__codelineno-3-30" href="#__codelineno-3-30"></a><span class="w">        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-3-31"><a id="__codelineno-3-31" name="__codelineno-3-31" href="#__codelineno-3-31"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-3-32"><a id="__codelineno-3-32" name="__codelineno-3-32" href="#__codelineno-3-32"></a><span class="w">        </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-3-33"><a id="__codelineno-3-33" name="__codelineno-3-33" href="#__codelineno-3-33"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">admin.toystore.com</span>
-</span><span id="__span-3-34"><a id="__codelineno-3-34" name="__codelineno-3-34" href="#__codelineno-3-34"></a><span class="w">      </span><span class="nt">when</span><span class="p">:</span>
-</span><span id="__span-3-35"><a id="__codelineno-3-35" name="__codelineno-3-35" href="#__codelineno-3-35"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.email_verified</span>
-</span><span id="__span-3-36"><a id="__codelineno-3-36" name="__codelineno-3-36" href="#__codelineno-3-36"></a><span class="w">        </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-3-37"><a id="__codelineno-3-37" name="__codelineno-3-37" href="#__codelineno-3-37"></a><span class="w">        </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;false&quot;</span>
-</span></code></pre></div>
-<table>
-<thead>
-<tr>
-<th>Request to</th>
-<th>Rate limits enforced</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>api.toystore.com</code></td>
-<td>100rps/username or 1000rpm/username (whatever happens first)</td>
-</tr>
-<tr>
-<td><code>admin.toystore.com</code></td>
-<td>250rps</td>
-</tr>
-<tr>
-<td><code>other.toystore.com</code></td>
-<td>5000rps</td>
-</tr>
-</tbody>
-</table>
-<h3 id="route-selectors">Route selectors<a class="headerlink" href="#route-selectors" title="Permanent link">&para;</a></h3>
-<p>Route selectors allow targeting sections of a HTTPRoute, by specifying sets of HTTPRouteMatches and/or hostnames that make the policy controller look up within the HTTPRoute spec for compatible declarations, and select the corresponding HTTPRouteRules and hostnames, to then build conditions that activate the policy or policy rule.</p>
-<p>Check out <a href="../reference/route-selectors/">Route selectors</a> for a full description, semantics and API reference.</p>
-<h4 id="when-conditions"><code>when</code> conditions<a class="headerlink" href="#when-conditions" title="Permanent link">&para;</a></h4>
-<p><code>when</code> conditions can be used to scope a limit (i.e. to filter the traffic to which a limit definition applies) without any coupling to the underlying network topology, i.e. without making direct references to HTTPRouteRules via <a href="../reference/route-selectors/#the-routeselectors-field"><code>routeSelectors</code></a>.</p>
-<p>Use <code>when</code> conditions to conditionally activate limits based on attributes that cannot be expressed in the HTTPRoutes' <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or in general in RateLimitPolicies that target a Gateway.</p>
-<p>The selectors within the <code>when</code> conditions of a RateLimitPolicy are a subset of Kuadrant's Well-known Attributes (<a href="https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md">RFC 0002</a>). Check out the reference for the full list of supported selectors.</p>
-<h3 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent link">&para;</a></h3>
-<p>Check out the following user guides for examples of rate limiting services with Kuadrant:</p>
-<ul>
-<li><a href="../user-guides/simple-rl-for-app-developers/">Simple Rate Limiting for Application Developers</a></li>
-<li><a href="../user-guides/authenticated-rl-for-app-developers/">Authenticated Rate Limiting for Application Developers</a></li>
-<li><a href="../user-guides/gateway-rl-for-cluster-operators/">Gateway Rate Limiting for Cluster Operators</a></li>
-<li><a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/">Authenticated Rate Limiting with JWTs and Kubernetes RBAC</a></li>
-</ul>
-<h3 id="known-limitations">Known limitations<a class="headerlink" href="#known-limitations" title="Permanent link">&para;</a></h3>
-<ul>
-<li>One HTTPRoute can only be targeted by one RateLimitPolicy.</li>
-<li>One Gateway can only be targeted by one RateLimitPolicy.</li>
-<li>RateLimitPolicies can only target HTTPRoutes/Gateways defined within the same namespace of the RateLimitPolicy.</li>
-<li>2+ RateLimitPolicies cannot target network resources that define/inherit the same exact hostname.</li>
-</ul>
-<h4 id="limitation-multiple-network-resources-with-identical-hostnames">Limitation: Multiple network resources with identical hostnames<a class="headerlink" href="#limitation-multiple-network-resources-with-identical-hostnames" title="Permanent link">&para;</a></h4>
-<p>Kuadrant currently does not support multiple RateLimitPolicies simultaneously targeting network resources that declare identical hostnames. This includes multiple HTTPRoutes that specify the same hostnames in the <code>spec.hostnames</code> field, as well as HTTPRoutes that specify a hostname that is identical to a hostname specified in a listener of one of the route's parent gateways or HTTPRoutes that don't specify any hostname at all thus inheriting the hostnames from the parent gateways. In any of these cases, <strong>a maximum of one RateLimitPolicy targeting any of those resources that specify identical hostnames is allowed</strong>.</p>
-<p>Moreover, having <strong>multiple resources that declare identical hostnames</strong> may lead to unexpected behavior and therefore <strong>should be avoided</strong>.</p>
-<p>This limitation is rooted at the underlying components configured by Kuadrant for the implementation of its policies and the lack of information in the data plane regarding the exact route that honored by the API gateway in cases of conflicting hostnames.</p>
-<p>To exemplify one way this limitation can impact deployments, consider the following topology:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>                 ┌──────────────┐
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>                 │   Gateway    │
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>                 ├──────────────┤
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>          ┌─────►│ listeners:   │◄──────┐
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>          │      │ - host: *.io │       │
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a>          │      └──────────────┘       │
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>          │                             │
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a>          │                             │
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a>┌─────────┴─────────┐        ┌──────────┴────────┐
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>│     HTTPRoute     │        │     HTTPRoute     │
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a>│     (route-a)     │        │     (route-b)     │
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a>├───────────────────┤        ├───────────────────┤
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a>│ hostnames:        │        │ hostnames:        │
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a>│ - app.io          │        │ - app.io          │
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a>│ rules:            │        │ rules:            │
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a>│ - matches:        │        │ - matches:        │
-</span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a>│   - path:         │        │   - path:         │
-</span><span id="__span-4-18"><a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a>│       value: /foo │        │       value: /bar │
-</span><span id="__span-4-19"><a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a>└───────────────────┘        └───────────────────┘
-</span><span id="__span-4-20"><a id="__codelineno-4-20" name="__codelineno-4-20" href="#__codelineno-4-20"></a>          ▲                            ▲
-</span><span id="__span-4-21"><a id="__codelineno-4-21" name="__codelineno-4-21" href="#__codelineno-4-21"></a>          │                            │
-</span><span id="__span-4-22"><a id="__codelineno-4-22" name="__codelineno-4-22" href="#__codelineno-4-22"></a> ┌────────┴────────┐           ┌───────┴─────────┐
-</span><span id="__span-4-23"><a id="__codelineno-4-23" name="__codelineno-4-23" href="#__codelineno-4-23"></a> │ RateLimitPolicy │           │ RateLimitPolicy │
-</span><span id="__span-4-24"><a id="__codelineno-4-24" name="__codelineno-4-24" href="#__codelineno-4-24"></a> │   (policy-1)    │           │   (policy-2)    │
-</span><span id="__span-4-25"><a id="__codelineno-4-25" name="__codelineno-4-25" href="#__codelineno-4-25"></a> └─────────────────┘           └─────────────────┘
-</span></code></pre></div>
-<p>In the example above, with the <code>policy-1</code> resource created before <code>policy-2</code>, <code>policy-2</code> will be enforced on all requests to <code>app.io/bar</code> while <code>policy-1</code> will <strong>not</strong> be enforced at all. I.e. <code>app.io/foo</code> will not be rate-limited. Nevertheless, both policies will report status condition as <code>Enforced</code>.</p>
-<p>Notice the enforcement of <code>policy-2</code> and no enforcement of <code>policy-1</code> is the opposite behavior as the <a href="../auth/#limitation-multiple-network-resources-with-identical-hostnames">analogous problem with the Kuadrant AuthPolicy</a>.</p>
-<p>A different way the limitation applies is when two or more routes of a gateway declare the exact same hostname and a gateway policy is defined with expectation to set default rules for the cases not covered by more specific policies. E.g.:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>                                    ┌─────────────────┐
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>                         ┌──────────┤ RateLimitPolicy │
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>                         │          │    (policy-2)   │
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>                         ▼          └─────────────────┘
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a>                 ┌──────────────┐
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>                 │   Gateway    │
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a>                 ├──────────────┤
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a>          ┌─────►│ listeners:   │◄──────┐
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a>          │      │ - host: *.io │       │
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a>          │      └──────────────┘       │
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a>          │                             │
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>          │                             │
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a>┌─────────┴─────────┐        ┌──────────┴────────┐
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a>│     HTTPRoute     │        │     HTTPRoute     │
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a>│     (route-a)     │        │     (route-b)     │
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a>├───────────────────┤        ├───────────────────┤
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a>│ hostnames:        │        │ hostnames:        │
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a>│ - app.io          │        │ - app.io          │
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a>│ rules:            │        │ rules:            │
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a>│ - matches:        │        │ - matches:        │
-</span><span id="__span-5-21"><a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a>│   - path:         │        │   - path:         │
-</span><span id="__span-5-22"><a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a>│       value: /foo │        │       value: /bar │
-</span><span id="__span-5-23"><a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></a>└───────────────────┘        └───────────────────┘
-</span><span id="__span-5-24"><a id="__codelineno-5-24" name="__codelineno-5-24" href="#__codelineno-5-24"></a>          ▲
-</span><span id="__span-5-25"><a id="__codelineno-5-25" name="__codelineno-5-25" href="#__codelineno-5-25"></a>          │
-</span><span id="__span-5-26"><a id="__codelineno-5-26" name="__codelineno-5-26" href="#__codelineno-5-26"></a> ┌────────┴────────┐
-</span><span id="__span-5-27"><a id="__codelineno-5-27" name="__codelineno-5-27" href="#__codelineno-5-27"></a> │ RateLimitPolicy │
-</span><span id="__span-5-28"><a id="__codelineno-5-28" name="__codelineno-5-28" href="#__codelineno-5-28"></a> │   (policy-1)    │
-</span><span id="__span-5-29"><a id="__codelineno-5-29" name="__codelineno-5-29" href="#__codelineno-5-29"></a> └─────────────────┘
-</span></code></pre></div>
-<p>Once again, both policies will report status condition as <code>Enforced</code>. However, in this case, only <code>policy-1</code> will be enforced on requests to <code>app.io/foo</code>, while <code>policy-2</code> will <strong>not</strong> be enforced at all. I.e. <code>app.io/bar</code> will not be not rate-limited. This is same behavior as the <a href="../auth/#limitation-multiple-network-resources-with-identical-hostnames">analogous problem with the Kuadrant AuthPolicy</a>.</p>
-<p>To avoid these problems, use different hostnames in each route.</p>
-<h2 id="implementation-details">Implementation details<a class="headerlink" href="#implementation-details" title="Permanent link">&para;</a></h2>
-<p>Driven by limitations related to how Istio injects configuration in the filter chains of the ingress gateways, Kuadrant relies on Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/listeners/network_filters/wasm_filter">Wasm Network</a> filter in the data plane, to manage the integration with rate limiting service ("Limitador"), instead of the <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter">Rate Limit</a> filter.</p>
-<p><strong>Motivation:</strong> <em>Multiple rate limit domains</em><br/>
-The first limitation comes from having only one filter chain per listener. This often leads to one single global rate limiting filter configuration per gateway, and therefore to a shared rate limit <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/http/ratelimit/v3/rate_limit.proto#envoy-v3-api-msg-extensions-filters-http-ratelimit-v3-ratelimit">domain</a> across applications and policies. Even though, in a rate limit filter, the triggering of rate limit calls, via <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter#composing-actions">actions to build so-called "descriptors"</a>, can be defined at the level of the virtual host and/or specific route rule, the overall rate limit configuration is only one, i.e., always the same rate limit domain for all calls to Limitador.</p>
-<p>On the other hand, the possibility to configure and invoke the rate limit service for multiple domains depending on the context allows to isolate groups of policy rules, as well as to optimize performance in the rate limit service, which can rely on the domain for indexation.</p>
-<p><strong>Motivation:</strong> <em>Fine-grained matching rules</em><br/>
-A second limitation of configuring the rate limit filter via Istio, particularly from <a href="https://gateway-api.sigs.k8s.io">Gateway API</a> resources, is that <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter#composing-actions">rate limit descriptors</a> at the level of a specific HTTP route rule require "named routes" – defined only in an Istio <a href="https://istio.io/latest/docs/reference/config/networking/virtual-service/#HTTPRoute">VirtualService</a> resource and referred in an <a href="https://istio.io/latest/docs/reference/config/networking/envoy-filter/#EnvoyFilter-RouteConfigurationMatch-RouteMatch">EnvoyFilter</a> one. Because Gateway API HTTPRoute rules lack a "name" property<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup>, as well as the Istio VirtualService resources are only ephemeral data structures handled by Istio in-memory in its implementation of gateway configuration for Gateway API, where the names of individual route rules are auto-generated and not referable by users in a policy<sup id="fnref:2"><a class="footnote-ref" href="#fn:2">2</a></sup><sup id="fnref:3"><a class="footnote-ref" href="#fn:3">3</a></sup>, rate limiting by attributes of the HTTP request (e.g., path, method, headers, etc) would be very limited while depending only on Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/rate_limit_filter">Rate Limit</a> filter.</p>
-<p>Motivated by the desire to support multiple rate limit domains per ingress gateway, as well as fine-grained HTTP route matching rules for rate limiting, Kuadrant implements a <a href="https://github.com/Kuadrant/wasm-shim">wasm-shim</a> that handles the rules to invoke the rate limiting service, complying with Envoy's <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/ratelimit/v3/rls.proto">Rate Limit Service (RLS)</a> protocol.</p>
-<p>The wasm module integrates with the gateway in the data plane via <a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/listeners/network_filters/wasm_filter">Wasm Network</a> filter, and parses a configuration composed out of user-defined RateLimitPolicy resources by the Kuadrant control plane. Whereas the rate limiting service ("Limitador") remains an implementation of Envoy's RLS protocol, capable of being integrated directly via <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/network/ratelimit/v3/rate_limit.proto#extension-envoy-filters-network-ratelimit">Rate Limit</a> extension or by Kuadrant, via wasm module for the <a href="https://gateway-api.sigs.k8s.io/implementations/#istio">Istio Gateway API implementation</a>.</p>
-<p>As a consequence of this design:</p>
-<ul>
-<li>Users can define fine-grained rate limit rules that match their Gateway and HTTPRoute definitions including for subsections of these.</li>
-<li>Rate limit definitions are insulated, not leaking across unrelated policies or applications.</li>
-<li>Conditions to activate limits are evaluated in the context of the gateway process, reducing the gRPC calls to the external rate limiting service only to the cases where rate limit counters are known in advance to have to be checked/incremented.</li>
-<li>The rate limiting service can rely on the indexation to look up for groups of limit definitions and counters.</li>
-<li>Components remain compliant with industry protocols and flexible for different integration options.</li>
-</ul>
-<p>A Kuadrant wasm-shim configuration for 2 RateLimitPolicy custom resources (a Gateway default RateLimitPolicy and a HTTPRoute RateLimitPolicy) looks like the following and it is generated automatically by the Kuadrant control plane:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">extensions.istio.io/v1alpha1</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">WasmPlugin</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-istio-ingressgateway</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w">  </span><span class="l l-Scalar l-Scalar-Plain">…</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="w">  </span><span class="nt">phase</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">STATS</span>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">  </span><span class="nt">pluginConfig</span><span class="p">:</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="w">    </span><span class="nt">failureMode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">deny</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="w">    </span><span class="nt">rateLimitPolicies</span><span class="p">:</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a>
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">domain</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system/gw-rlp</span><span class="w"> </span><span class="c1"># allows isolating policy rules and improve performance of the rate limit service</span>
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="w">      </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;*.website&#39;</span>
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;*.io&#39;</span>
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system/gw-rlp</span>
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="w">      </span><span class="nt">rules</span><span class="p">:</span><span class="w"> </span><span class="c1"># match rules from the gateway and according to conditions specified in the policy</span>
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allOf</span><span class="p">:</span>
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">startswith</span>
-</span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.url_path</span>
-</span><span id="__span-6-23"><a id="__codelineno-6-23" name="__codelineno-6-23" href="#__codelineno-6-23"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/</span>
-</span><span id="__span-6-24"><a id="__codelineno-6-24" name="__codelineno-6-24" href="#__codelineno-6-24"></a><span class="w">        </span><span class="nt">data</span><span class="p">:</span>
-</span><span id="__span-6-25"><a id="__codelineno-6-25" name="__codelineno-6-25" href="#__codelineno-6-25"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">static</span><span class="p">:</span><span class="w"> </span><span class="c1"># tells which rate limit definitions and counters to activate</span>
-</span><span id="__span-6-26"><a id="__codelineno-6-26" name="__codelineno-6-26" href="#__codelineno-6-26"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limit.internet_traffic_all__593de456</span>
-</span><span id="__span-6-27"><a id="__codelineno-6-27" name="__codelineno-6-27" href="#__codelineno-6-27"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-6-28"><a id="__codelineno-6-28" name="__codelineno-6-28" href="#__codelineno-6-28"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-6-29"><a id="__codelineno-6-29" name="__codelineno-6-29" href="#__codelineno-6-29"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allOf</span><span class="p">:</span>
-</span><span id="__span-6-30"><a id="__codelineno-6-30" name="__codelineno-6-30" href="#__codelineno-6-30"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">startswith</span>
-</span><span id="__span-6-31"><a id="__codelineno-6-31" name="__codelineno-6-31" href="#__codelineno-6-31"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.url_path</span>
-</span><span id="__span-6-32"><a id="__codelineno-6-32" name="__codelineno-6-32" href="#__codelineno-6-32"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/</span>
-</span><span id="__span-6-33"><a id="__codelineno-6-33" name="__codelineno-6-33" href="#__codelineno-6-33"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">endswith</span>
-</span><span id="__span-6-34"><a id="__codelineno-6-34" name="__codelineno-6-34" href="#__codelineno-6-34"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.host</span>
-</span><span id="__span-6-35"><a id="__codelineno-6-35" name="__codelineno-6-35" href="#__codelineno-6-35"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">.io</span>
-</span><span id="__span-6-36"><a id="__codelineno-6-36" name="__codelineno-6-36" href="#__codelineno-6-36"></a><span class="w">        </span><span class="nt">data</span><span class="p">:</span>
-</span><span id="__span-6-37"><a id="__codelineno-6-37" name="__codelineno-6-37" href="#__codelineno-6-37"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">static</span><span class="p">:</span>
-</span><span id="__span-6-38"><a id="__codelineno-6-38" name="__codelineno-6-38" href="#__codelineno-6-38"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limit.internet_traffic_apis_per_host__a2b149d2</span>
-</span><span id="__span-6-39"><a id="__codelineno-6-39" name="__codelineno-6-39" href="#__codelineno-6-39"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-6-40"><a id="__codelineno-6-40" name="__codelineno-6-40" href="#__codelineno-6-40"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-6-41"><a id="__codelineno-6-41" name="__codelineno-6-41" href="#__codelineno-6-41"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.host</span>
-</span><span id="__span-6-42"><a id="__codelineno-6-42" name="__codelineno-6-42" href="#__codelineno-6-42"></a><span class="w">      </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-rate-limiting-service</span>
-</span><span id="__span-6-43"><a id="__codelineno-6-43" name="__codelineno-6-43" href="#__codelineno-6-43"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">domain</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default/app-rlp</span>
-</span><span id="__span-6-44"><a id="__codelineno-6-44" name="__codelineno-6-44" href="#__codelineno-6-44"></a><span class="w">      </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-6-45"><a id="__codelineno-6-45" name="__codelineno-6-45" href="#__codelineno-6-45"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;*.toystore.website&#39;</span>
-</span><span id="__span-6-46"><a id="__codelineno-6-46" name="__codelineno-6-46" href="#__codelineno-6-46"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;*.toystore.io&#39;</span>
-</span><span id="__span-6-47"><a id="__codelineno-6-47" name="__codelineno-6-47" href="#__codelineno-6-47"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default/app-rlp</span>
-</span><span id="__span-6-48"><a id="__codelineno-6-48" name="__codelineno-6-48" href="#__codelineno-6-48"></a><span class="w">      </span><span class="nt">rules</span><span class="p">:</span><span class="w"> </span><span class="c1"># matches rules from a httproute and additional specified in the policy</span>
-</span><span id="__span-6-49"><a id="__codelineno-6-49" name="__codelineno-6-49" href="#__codelineno-6-49"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-6-50"><a id="__codelineno-6-50" name="__codelineno-6-50" href="#__codelineno-6-50"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allOf</span><span class="p">:</span>
-</span><span id="__span-6-51"><a id="__codelineno-6-51" name="__codelineno-6-51" href="#__codelineno-6-51"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">startswith</span>
-</span><span id="__span-6-52"><a id="__codelineno-6-52" name="__codelineno-6-52" href="#__codelineno-6-52"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.url_path</span>
-</span><span id="__span-6-53"><a id="__codelineno-6-53" name="__codelineno-6-53" href="#__codelineno-6-53"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/assets/</span>
-</span><span id="__span-6-54"><a id="__codelineno-6-54" name="__codelineno-6-54" href="#__codelineno-6-54"></a><span class="w">        </span><span class="nt">data</span><span class="p">:</span>
-</span><span id="__span-6-55"><a id="__codelineno-6-55" name="__codelineno-6-55" href="#__codelineno-6-55"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">static</span><span class="p">:</span>
-</span><span id="__span-6-56"><a id="__codelineno-6-56" name="__codelineno-6-56" href="#__codelineno-6-56"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limit.toystore_assets_all_domains__8cfb7371</span>
-</span><span id="__span-6-57"><a id="__codelineno-6-57" name="__codelineno-6-57" href="#__codelineno-6-57"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-6-58"><a id="__codelineno-6-58" name="__codelineno-6-58" href="#__codelineno-6-58"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-6-59"><a id="__codelineno-6-59" name="__codelineno-6-59" href="#__codelineno-6-59"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allOf</span><span class="p">:</span>
-</span><span id="__span-6-60"><a id="__codelineno-6-60" name="__codelineno-6-60" href="#__codelineno-6-60"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">startswith</span>
-</span><span id="__span-6-61"><a id="__codelineno-6-61" name="__codelineno-6-61" href="#__codelineno-6-61"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.url_path</span>
-</span><span id="__span-6-62"><a id="__codelineno-6-62" name="__codelineno-6-62" href="#__codelineno-6-62"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/v1/</span>
-</span><span id="__span-6-63"><a id="__codelineno-6-63" name="__codelineno-6-63" href="#__codelineno-6-63"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-6-64"><a id="__codelineno-6-64" name="__codelineno-6-64" href="#__codelineno-6-64"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.method</span>
-</span><span id="__span-6-65"><a id="__codelineno-6-65" name="__codelineno-6-65" href="#__codelineno-6-65"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-6-66"><a id="__codelineno-6-66" name="__codelineno-6-66" href="#__codelineno-6-66"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">endswith</span>
-</span><span id="__span-6-67"><a id="__codelineno-6-67" name="__codelineno-6-67" href="#__codelineno-6-67"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.host</span>
-</span><span id="__span-6-68"><a id="__codelineno-6-68" name="__codelineno-6-68" href="#__codelineno-6-68"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">.toystore.website</span>
-</span><span id="__span-6-69"><a id="__codelineno-6-69" name="__codelineno-6-69" href="#__codelineno-6-69"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-6-70"><a id="__codelineno-6-70" name="__codelineno-6-70" href="#__codelineno-6-70"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-6-71"><a id="__codelineno-6-71" name="__codelineno-6-71" href="#__codelineno-6-71"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;&quot;</span>
-</span><span id="__span-6-72"><a id="__codelineno-6-72" name="__codelineno-6-72" href="#__codelineno-6-72"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">allOf</span><span class="p">:</span>
-</span><span id="__span-6-73"><a id="__codelineno-6-73" name="__codelineno-6-73" href="#__codelineno-6-73"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">startswith</span>
-</span><span id="__span-6-74"><a id="__codelineno-6-74" name="__codelineno-6-74" href="#__codelineno-6-74"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.url_path</span>
-</span><span id="__span-6-75"><a id="__codelineno-6-75" name="__codelineno-6-75" href="#__codelineno-6-75"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/v1/</span>
-</span><span id="__span-6-76"><a id="__codelineno-6-76" name="__codelineno-6-76" href="#__codelineno-6-76"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-6-77"><a id="__codelineno-6-77" name="__codelineno-6-77" href="#__codelineno-6-77"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.method</span>
-</span><span id="__span-6-78"><a id="__codelineno-6-78" name="__codelineno-6-78" href="#__codelineno-6-78"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">POST</span>
-</span><span id="__span-6-79"><a id="__codelineno-6-79" name="__codelineno-6-79" href="#__codelineno-6-79"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">endswith</span>
-</span><span id="__span-6-80"><a id="__codelineno-6-80" name="__codelineno-6-80" href="#__codelineno-6-80"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.host</span>
-</span><span id="__span-6-81"><a id="__codelineno-6-81" name="__codelineno-6-81" href="#__codelineno-6-81"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">.toystore.website</span>
-</span><span id="__span-6-82"><a id="__codelineno-6-82" name="__codelineno-6-82" href="#__codelineno-6-82"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-6-83"><a id="__codelineno-6-83" name="__codelineno-6-83" href="#__codelineno-6-83"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-6-84"><a id="__codelineno-6-84" name="__codelineno-6-84" href="#__codelineno-6-84"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;&quot;</span>
-</span><span id="__span-6-85"><a id="__codelineno-6-85" name="__codelineno-6-85" href="#__codelineno-6-85"></a><span class="w">        </span><span class="nt">data</span><span class="p">:</span>
-</span><span id="__span-6-86"><a id="__codelineno-6-86" name="__codelineno-6-86" href="#__codelineno-6-86"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">static</span><span class="p">:</span>
-</span><span id="__span-6-87"><a id="__codelineno-6-87" name="__codelineno-6-87" href="#__codelineno-6-87"></a><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limit.toystore_v1_website_unauthenticated__3f9c40c6</span>
-</span><span id="__span-6-88"><a id="__codelineno-6-88" name="__codelineno-6-88" href="#__codelineno-6-88"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1&quot;</span>
-</span><span id="__span-6-89"><a id="__codelineno-6-89" name="__codelineno-6-89" href="#__codelineno-6-89"></a><span class="w">      </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-rate-limiting-service</span>
-</span><span id="__span-6-90"><a id="__codelineno-6-90" name="__codelineno-6-90" href="#__codelineno-6-90"></a><span class="w">  </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-6-91"><a id="__codelineno-6-91" name="__codelineno-6-91" href="#__codelineno-6-91"></a><span class="w">    </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-6-92"><a id="__codelineno-6-92" name="__codelineno-6-92" href="#__codelineno-6-92"></a><span class="w">      </span><span class="nt">istio.io/gateway-name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-6-93"><a id="__codelineno-6-93" name="__codelineno-6-93" href="#__codelineno-6-93"></a><span class="w">  </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">oci://quay.io/kuadrant/wasm-shim:v0.3.0</span>
-</span></code></pre></div>
-<div class="footnote">
-<hr />
-<ol>
-<li id="fn:1">
-<p>https://github.com/kubernetes-sigs/gateway-api/pull/996&#160;<a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">&#8617;</a></p>
-</li>
-<li id="fn:2">
-<p>https://github.com/istio/istio/issues/36790&#160;<a class="footnote-backref" href="#fnref:2" title="Jump back to footnote 2 in the text">&#8617;</a></p>
-</li>
-<li id="fn:3">
-<p>https://github.com/istio/istio/issues/37346&#160;<a class="footnote-backref" href="#fnref:3" title="Jump back to footnote 3 in the text">&#8617;</a></p>
-</li>
-</ol>
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/reference/authpolicy/index.html b/0.10.0/kuadrant-operator/doc/reference/authpolicy/index.html
deleted file mode 100644
index 252f7646c..000000000
--- a/0.10.0/kuadrant-operator/doc/reference/authpolicy/index.html
+++ /dev/null
@@ -1,4343 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/authpolicy/">
-      
-      
-        <link rel="prev" href="../../auth/">
-      
-      
-        <link rel="next" href="../../rate-limiting/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Reference - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#the-authpolicy-custom-resource-definition-crd" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Reference
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#authpolicyspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicySpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#authpolicycommonspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicyCommonSpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AuthPolicyCommonSpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#authscheme" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthScheme
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AuthScheme">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#authrulecommon" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthRuleCommon
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authenticationrule" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthenticationRule
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#metadatarule" class="md-nav__link">
-    <span class="md-ellipsis">
-      MetadataRule
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authorizationrule" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthorizationRule
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#responsespec" class="md-nav__link">
-    <span class="md-ellipsis">
-      ResponseSpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="ResponseSpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#successresponsespec" class="md-nav__link">
-    <span class="md-ellipsis">
-      SuccessResponseSpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="SuccessResponseSpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#successresponseitem" class="md-nav__link">
-    <span class="md-ellipsis">
-      SuccessResponseItem
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#callbackrule" class="md-nav__link">
-    <span class="md-ellipsis">
-      CallbackRule
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#namedpattern" class="md-nav__link">
-    <span class="md-ellipsis">
-      NamedPattern
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#authpolicystatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicyStatus
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AuthPolicyStatus">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#conditionspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      ConditionSpec
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#authpolicyspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicySpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#authpolicycommonspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicyCommonSpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AuthPolicyCommonSpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#authscheme" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthScheme
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AuthScheme">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#authrulecommon" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthRuleCommon
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authenticationrule" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthenticationRule
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#metadatarule" class="md-nav__link">
-    <span class="md-ellipsis">
-      MetadataRule
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#authorizationrule" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthorizationRule
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#responsespec" class="md-nav__link">
-    <span class="md-ellipsis">
-      ResponseSpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="ResponseSpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#successresponsespec" class="md-nav__link">
-    <span class="md-ellipsis">
-      SuccessResponseSpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="SuccessResponseSpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#successresponseitem" class="md-nav__link">
-    <span class="md-ellipsis">
-      SuccessResponseItem
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#callbackrule" class="md-nav__link">
-    <span class="md-ellipsis">
-      CallbackRule
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#namedpattern" class="md-nav__link">
-    <span class="md-ellipsis">
-      NamedPattern
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#authpolicystatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      AuthPolicyStatus
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="AuthPolicyStatus">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#conditionspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      ConditionSpec
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/reference/authpolicy.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="the-authpolicy-custom-resource-definition-crd">The AuthPolicy Custom Resource Definition (CRD)<a class="headerlink" href="#the-authpolicy-custom-resource-definition-crd" title="Permanent link">&para;</a></h1>
-<ul>
-<li><a href="#authpolicy">AuthPolicy</a></li>
-<li><a href="#authpolicyspec">AuthPolicySpec</a></li>
-<li><a href="#authscheme">AuthScheme</a><ul>
-<li><a href="#authrulecommon">AuthRuleCommon</a></li>
-<li><a href="#authenticationrule">AuthenticationRule</a></li>
-<li><a href="#metadatarule">MetadataRule</a></li>
-<li><a href="#authorizationrule">AuthorizationRule</a></li>
-<li><a href="#responsespec">ResponseSpec</a></li>
-<li><a href="#successresponsespec">SuccessResponseSpec</a><ul>
-<li><a href="#successresponseitem">SuccessResponseItem</a></li>
-</ul>
-</li>
-<li><a href="#callbackrule">CallbackRule</a></li>
-</ul>
-</li>
-<li><a href="#namedpattern">NamedPattern</a></li>
-<li><a href="#authPolicyCommonSpec">AuthPolicyCommonSpec</a></li>
-<li><a href="#authpolicystatus">AuthPolicyStatus</a></li>
-<li><a href="#conditionspec">ConditionSpec</a></li>
-</ul>
-<h2 id="authpolicy">AuthPolicy<a class="headerlink" href="#authpolicy" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>spec</code></td>
-<td><a href="#authpolicyspec">AuthPolicySpec</a></td>
-<td style="text-align: center;">Yes</td>
-<td>The specification for AuthPolicy custom resource</td>
-</tr>
-<tr>
-<td><code>status</code></td>
-<td><a href="#authpolicystatus">AuthPolicyStatus</a></td>
-<td style="text-align: center;">No</td>
-<td>The status for the custom resource</td>
-</tr>
-</tbody>
-</table>
-<h2 id="authpolicyspec">AuthPolicySpec<a class="headerlink" href="#authpolicyspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>targetRef</code></td>
-<td><a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1alpha2.LocalPolicyTargetReference">LocalPolicyTargetReference</a></td>
-<td>Yes</td>
-<td>Reference to a Kubernetes resource that the policy attaches to</td>
-</tr>
-<tr>
-<td><code>rules</code></td>
-<td><a href="#authscheme">AuthScheme</a></td>
-<td>No</td>
-<td>Implicit default authentication/authorization rules</td>
-</tr>
-<tr>
-<td><code>routeSelectors</code></td>
-<td>[]<a href="../route-selectors/#routeselector">RouteSelector</a></td>
-<td>No</td>
-<td>List of implicit default selectors of HTTPRouteRules whose matching rules activate the policy. At least one HTTPRouteRule must be selected to activate the policy. If omitted, all HTTPRouteRules of the targeted HTTPRoute activate the policy. Do not use it in policies targeting a Gateway.</td>
-</tr>
-<tr>
-<td><code>patterns</code></td>
-<td>Map<String: <a href="#namedpattern">NamedPattern</a>></td>
-<td>No</td>
-<td>Implicit default named patterns of lists of <code>selector</code>, <code>operator</code> and <code>value</code> tuples, to be reused in <code>when</code> conditions and pattern-matching authorization rules.</td>
-</tr>
-<tr>
-<td><code>when</code></td>
-<td>[]<a href="https://docs.kuadrant.io/latest/authorino/docs/features/#common-feature-conditions-when">PatternExpressionOrRef</a></td>
-<td>No</td>
-<td>List of implicit default additional dynamic conditions (expressions) to activate the policy. Use it for filtering attributes that cannot be expressed in the targeted HTTPRoute's <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or when targeting a Gateway.</td>
-</tr>
-<tr>
-<td><code>defaults</code></td>
-<td><a href="#authPolicyCommonSpec">AuthPolicyCommonSpec</a></td>
-<td>No</td>
-<td>Explicit default definitions. This field is mutually exclusive with any of the implicit default definitions: <code>spec.rules</code>, <code>spec.routeSelectors</code>, <code>spec.patterns</code>, <code>spec.when</code></td>
-</tr>
-<tr>
-<td><code>overrides</code></td>
-<td><a href="#authPolicyCommonSpec">AuthPolicyCommonSpec</a></td>
-<td>No</td>
-<td>Atomic overrides definitions. This field is mutually exclusive with any of the implicit or explicit default definitions: <code>spec.rules</code>, <code>spec.routeSelectors</code>, <code>spec.patterns</code>, <code>spec.when</code>, <code>spec.default</code></td>
-</tr>
-</tbody>
-</table>
-<h2 id="authpolicycommonspec">AuthPolicyCommonSpec<a class="headerlink" href="#authpolicycommonspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>rules</code></td>
-<td><a href="#authscheme">AuthScheme</a></td>
-<td>No</td>
-<td>Authentication/authorization rules</td>
-</tr>
-<tr>
-<td><code>routeSelectors</code></td>
-<td>[]<a href="../route-selectors/#routeselector">RouteSelector</a></td>
-<td>No</td>
-<td>List of selectors of HTTPRouteRules whose matching rules activate the policy. At least one HTTPRouteRule must be selected to activate the policy. If omitted, all HTTPRouteRules of the targeted HTTPRoute activate the policy. Do not use it in policies targeting a Gateway.</td>
-</tr>
-<tr>
-<td><code>patterns</code></td>
-<td>Map<String: <a href="#namedpattern">NamedPattern</a>></td>
-<td>No</td>
-<td>Named patterns of lists of <code>selector</code>, <code>operator</code> and <code>value</code> tuples, to be reused in <code>when</code> conditions and pattern-matching authorization rules.</td>
-</tr>
-<tr>
-<td><code>when</code></td>
-<td>[]<a href="https://docs.kuadrant.io/latest/authorino/docs/features/#common-feature-conditions-when">PatternExpressionOrRef</a></td>
-<td>No</td>
-<td>List of additional dynamic conditions (expressions) to activate the policy. Use it for filtering attributes that cannot be expressed in the targeted HTTPRoute's <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or when targeting a Gateway.</td>
-</tr>
-</tbody>
-</table>
-<h3 id="authscheme">AuthScheme<a class="headerlink" href="#authscheme" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>authentication</code></td>
-<td>Map<String: <a href="#authenticationrule">AuthenticationRule</a>></td>
-<td style="text-align: center;">No</td>
-<td>Authentication rules. At least one config MUST evaluate to a valid identity object for the auth request to be successful. If omitted or empty, anonymous access is assumed.</td>
-</tr>
-<tr>
-<td><code>metadata</code></td>
-<td>Map<String: <a href="#metadatarule">MetadataRule</a>></td>
-<td style="text-align: center;">No</td>
-<td>Rules for fetching auth metadata from external sources.</td>
-</tr>
-<tr>
-<td><code>authorization</code></td>
-<td>Map<String: <a href="#authorizationrule">AuthorizationRule</a>></td>
-<td style="text-align: center;">No</td>
-<td>Authorization rules. All policies MUST allow access for the auth request be successful.</td>
-</tr>
-<tr>
-<td><code>response</code></td>
-<td><a href="#responsespec">ResponseSpec</a></td>
-<td style="text-align: center;">No</td>
-<td>Customizations to the response to the authorization request. Use it to set custom values for unauthenticated, unauthorized, and/or success access request.</td>
-</tr>
-<tr>
-<td><code>callbacks</code></td>
-<td>Map<String: <a href="#callbackrule">CallbackRule</a>></td>
-<td style="text-align: center;">No</td>
-<td>Rules for post-authorization callback requests to external services. Triggered regardless of the result of the authorization request.</td>
-</tr>
-</tbody>
-</table>
-<h4 id="authrulecommon">AuthRuleCommon<a class="headerlink" href="#authrulecommon" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>routeSelectors</code></td>
-<td>[]<a href="../route-selectors/#routeselector">RouteSelector</a></td>
-<td style="text-align: center;">No</td>
-<td>List of selectors of HTTPRouteRules whose matching rules activate the auth rule. At least one HTTPRouteRule must be selected to activate the auth rule. If omitted, the auth rule is activated at all requests where the policy is enforced. Do not use it in policies targeting a Gateway.</td>
-</tr>
-<tr>
-<td><code>when</code></td>
-<td>[]<a href="https://docs.kuadrant.io/latest/authorino/docs/features/#common-feature-conditions-when">PatternExpressionOrRef</a></td>
-<td style="text-align: center;">No</td>
-<td>List of additional dynamic conditions (expressions) to activate the auth rule. Use it for filtering attributes that cannot be expressed in the targeted HTTPRoute's <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or when targeting a Gateway.</td>
-</tr>
-<tr>
-<td><code>cache</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#common-feature-caching-cache">Caching spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Caching options for the resolved object returned when applying this auth rule. (Default: disabled)</td>
-</tr>
-<tr>
-<td><code>priority</code></td>
-<td>Integer</td>
-<td style="text-align: center;">No</td>
-<td>Priority group of the auth rule. All rules in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially. (Default: <code>0</code>)</td>
-</tr>
-<tr>
-<td><code>metrics</code></td>
-<td>Boolean</td>
-<td style="text-align: center;">No</td>
-<td>Whether the auth rule emits individual observability metrics. (Default: <code>false</code>)</td>
-</tr>
-</tbody>
-</table>
-<h4 id="authenticationrule">AuthenticationRule<a class="headerlink" href="#authenticationrule" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>apiKey</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#api-key-authenticationapikey">API Key authentication spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Authentication based on API keys stored in Kubernetes secrets. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>.</td>
-</tr>
-<tr>
-<td><code>kubernetesTokenReview</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#kubernetes-tokenreview-authenticationkubernetestokenreview">KubernetesTokenReview spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Authentication by Kubernetes token review. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>.</td>
-</tr>
-<tr>
-<td><code>jwt</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#jwt-verification-authenticationjwt">JWT verification spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Authentication based on JSON Web Tokens (JWT). Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>.</td>
-</tr>
-<tr>
-<td><code>oauth2Introspection</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#oauth-20-introspection-authenticationoauth2introspection">OAuth2 Token Introscpection spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Authentication by OAuth2 token introspection. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>.</td>
-</tr>
-<tr>
-<td><code>x509</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#x509-client-certificate-authentication-authenticationx509">X.509 authentication spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Authentication based on client X.509 certificates. The certificates presented by the clients must be signed by a trusted CA whose certificates are stored in Kubernetes secrets. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>.</td>
-</tr>
-<tr>
-<td><code>plain</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#plain-authenticationplain">Plain identity object spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Identity object extracted from the context. Use this method when authentication is performed beforehand by a proxy and the resulting object passed to Authorino as JSON in the auth request. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>.</td>
-</tr>
-<tr>
-<td><code>anonymous</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#anonymous-access-authenticationanonymous">Anonymous access</a></td>
-<td style="text-align: center;">No</td>
-<td>Anonymous access. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>.</td>
-</tr>
-<tr>
-<td><code>credentials</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#extra-auth-credentials-authenticationcredentials">Auth credentials spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Customizations to where credentials are required to be passed in the request for authentication based on this auth rule. Defaults to HTTP Authorization header with prefix "Bearer".</td>
-</tr>
-<tr>
-<td><code>overrides</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#extra-identity-extension-authenticationdefaults-and-authenticationoverrides">Identity extension spec</a></td>
-<td style="text-align: center;">No</td>
-<td>JSON overrides to set to the resolved identity object. Do not use it with identity objects of other JSON types (array, string, etc).</td>
-</tr>
-<tr>
-<td><code>defaults</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#extra-identity-extension-authenticationdefaults-and-authenticationoverrides">Identity extension spec</a></td>
-<td style="text-align: center;">No</td>
-<td>JSON defaults to set to the resolved identity object. Do not use it with identity objects of other JSON types (array, string, etc).</td>
-</tr>
-<tr>
-<td><em>(inline)</em></td>
-<td><a href="#authrulecommon">AuthRuleCommon</a></td>
-<td style="text-align: center;">No</td>
-<td></td>
-</tr>
-</tbody>
-</table>
-<h4 id="metadatarule">MetadataRule<a class="headerlink" href="#metadatarule" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>http</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#http-getget-by-post-metadatahttp">HTTP GET/GET-by-POST external metadata spec</a></td>
-<td style="text-align: center;">No</td>
-<td>External source of auth metadata via HTTP request. Use one of: <code>http</code>, <code>userInfo</code>, <code>uma</code>.</td>
-</tr>
-<tr>
-<td><code>userInfo</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#oidc-userinfo-metadatauserinfo">OIDC UserInfo spec</a></td>
-<td style="text-align: center;">No</td>
-<td>OpendID Connect UserInfo linked to an OIDC authentication rule declared in this same AuthPolicy. Use one of: <code>http</code>, <code>userInfo</code>, <code>uma</code>.</td>
-</tr>
-<tr>
-<td><code>uma</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#user-managed-access-uma-resource-registry-metadatauma">UMA metadata spec</a></td>
-<td style="text-align: center;">No</td>
-<td>User-Managed Access (UMA) source of resource data.  Use one of: <code>http</code>, <code>userInfo</code>, <code>uma</code>.</td>
-</tr>
-<tr>
-<td><em>(inline)</em></td>
-<td><a href="#authrulecommon">AuthRuleCommon</a></td>
-<td style="text-align: center;">No</td>
-<td></td>
-</tr>
-</tbody>
-</table>
-<h4 id="authorizationrule">AuthorizationRule<a class="headerlink" href="#authorizationrule" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>patternMatching</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#pattern-matching-authorization-authorizationpatternmatching">Pattern-matching authorization spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Pattern-matching authorization rules. Use one of: <code>patternMatching</code>, <code>opa</code>, <code>kubernetesSubjectAccessReview</code>, <code>spicedb</code>.</td>
-</tr>
-<tr>
-<td><code>opa</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#open-policy-agent-opa-rego-policies-authorizationopa">OPA authorization spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Open Policy Agent (OPA) Rego policy. Use one of: <code>patternMatching</code>, <code>opa</code>, <code>kubernetesSubjectAccessReview</code>, <code>spicedb</code>.</td>
-</tr>
-<tr>
-<td><code>kubernetesSubjectAccessReview</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview">Kubernetes SubjectAccessReview spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Authorization by Kubernetes SubjectAccessReview. Use one of: <code>patternMatching</code>, <code>opa</code>, <code>kubernetesSubjectAccessReview</code>, <code>spicedb</code>.</td>
-</tr>
-<tr>
-<td><code>spicedb</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#spicedb-authorizationspicedb">SpiceDB authorization spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Authorization decision delegated to external Authzed/SpiceDB server. Use one of: <code>patternMatching</code>, <code>opa</code>, <code>kubernetesSubjectAccessReview</code>, <code>spicedb</code>.</td>
-</tr>
-<tr>
-<td><em>(inline)</em></td>
-<td><a href="#authrulecommon">AuthRuleCommon</a></td>
-<td style="text-align: center;">No</td>
-<td></td>
-</tr>
-</tbody>
-</table>
-<h4 id="responsespec">ResponseSpec<a class="headerlink" href="#responsespec" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>unauthenticated</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#custom-denial-status-responseunauthenticated-and-responseunauthorized">Custom denial status spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Customizations on the denial status and other HTTP attributes when the request is unauthenticated. (Default: <code>401 Unauthorized</code>)</td>
-</tr>
-<tr>
-<td><code>unauthorized</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#custom-denial-status-responseunauthenticated-and-responseunauthorized">Custom denial status spec</a></td>
-<td style="text-align: center;">No</td>
-<td>Customizations on the denial status and other HTTP attributes when the request is unauthorized. (Default: <code>403 Forbidden</code>)</td>
-</tr>
-<tr>
-<td><code>success</code></td>
-<td><a href="#successresponsespec">SuccessResponseSpec</a></td>
-<td style="text-align: center;">No</td>
-<td>Response items to be included in the auth response when the request is authenticated and authorized.</td>
-</tr>
-</tbody>
-</table>
-<h5 id="successresponsespec">SuccessResponseSpec<a class="headerlink" href="#successresponsespec" title="Permanent link">&para;</a></h5>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>headers</code></td>
-<td>Map<String: <a href="#successresponseitem">SuccessResponseItem</a>></td>
-<td style="text-align: center;">No</td>
-<td>Custom success response items wrapped as HTTP headers to be injected in the request.</td>
-</tr>
-<tr>
-<td><code>dynamicMetadata</code></td>
-<td>Map<String: <a href="#successresponseitem">SuccessResponseItem</a>></td>
-<td style="text-align: center;">No</td>
-<td>Custom success response items wrapped as Envoy Dynamic Metadata. Use it to pass data along to other proxy filters, such as the rate-limit filter.</td>
-</tr>
-</tbody>
-</table>
-<h6 id="successresponseitem">SuccessResponseItem<a class="headerlink" href="#successresponseitem" title="Permanent link">&para;</a></h6>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>plain</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#plain-text-responsesuccessheadersdynamicmetadataplain">Plain text response item</a></td>
-<td style="text-align: center;">No</td>
-<td>Plain text content. Use one of: <code>plain</code>, <code>json</code>, <code>wristband</code>.</td>
-</tr>
-<tr>
-<td><code>json</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#json-injection-responsesuccessheadersdynamicmetadatajson">JSON injection response item</a></td>
-<td style="text-align: center;">No</td>
-<td>Specification of a JSON object. Use one of: <code>plain</code>, <code>json</code>, <code>wristband</code>.</td>
-</tr>
-<tr>
-<td><code>wristband</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband">Festival Wristband token response item</a></td>
-<td style="text-align: center;">No</td>
-<td>Specification of a JSON object. Use one of: <code>plain</code>, <code>json</code>, <code>wristband</code>.</td>
-</tr>
-<tr>
-<td><code>key</code></td>
-<td>String</td>
-<td style="text-align: center;">No</td>
-<td>The key used to add the custom response item (name of the HTTP header or root property of the Dynamic Metadata object). Defaults to the name of the response item if omitted.</td>
-</tr>
-</tbody>
-</table>
-<h4 id="callbackrule">CallbackRule<a class="headerlink" href="#callbackrule" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>http</code></td>
-<td><a href="https://docs.kuadrant.io/latest/authorino/docs/features/#http-endpoints-callbackshttp">HTTP endpoints callback spec</a></td>
-<td style="text-align: center;">No</td>
-<td>HTTP endpoint settings to build the callback request (webhook).</td>
-</tr>
-<tr>
-<td><em>(inline)</em></td>
-<td><a href="#authrulecommon">AuthRuleCommon</a></td>
-<td style="text-align: center;">No</td>
-<td></td>
-</tr>
-</tbody>
-</table>
-<h3 id="namedpattern">NamedPattern<a class="headerlink" href="#namedpattern" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>selector</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>A valid <a href="https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md">Well-known attribute</a> whose resolved value in the data plane will be compared to <code>value</code>, using the <code>operator</code>.</td>
-</tr>
-<tr>
-<td><code>operator</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>The binary operator to be applied to the resolved value specified by the selector. One of: <code>eq</code> (equal to), <code>neq</code> (not equal to), <code>incl</code> (includes; for arrays), <code>excl</code> (excludes; for arrays), <code>matches</code> (regex).</td>
-</tr>
-<tr>
-<td><code>value</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>The static value to be compared to the one resolved from the selector.</td>
-</tr>
-</tbody>
-</table>
-<h2 id="authpolicystatus">AuthPolicyStatus<a class="headerlink" href="#authpolicystatus" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>observedGeneration</code></td>
-<td>String</td>
-<td>Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec.</td>
-</tr>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="#conditionspec">ConditionSpec</a></td>
-<td>List of conditions that define that status of the resource.</td>
-</tr>
-</tbody>
-</table>
-<h3 id="conditionspec">ConditionSpec<a class="headerlink" href="#conditionspec" title="Permanent link">&para;</a></h3>
-<ul>
-<li>The <em>lastTransitionTime</em> field provides a timestamp for when the entity last transitioned from one status to another.</li>
-<li>The <em>message</em> field is a human-readable message indicating details about the transition.</li>
-<li>The <em>reason</em> field is a unique, one-word, CamelCase reason for the condition’s last transition.</li>
-<li>The <em>status</em> field is a string, with possible values <strong>True</strong>, <strong>False</strong>, and <strong>Unknown</strong>.</li>
-<li>The <em>type</em> field is a string with the following possible values:</li>
-<li>Available: the resource has successfully configured;</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>type</code></td>
-<td>String</td>
-<td>Condition Type</td>
-</tr>
-<tr>
-<td><code>status</code></td>
-<td>String</td>
-<td>Status: True, False, Unknown</td>
-</tr>
-<tr>
-<td><code>reason</code></td>
-<td>String</td>
-<td>Condition state reason</td>
-</tr>
-<tr>
-<td><code>message</code></td>
-<td>String</td>
-<td>Condition state description</td>
-</tr>
-<tr>
-<td><code>lastTransitionTime</code></td>
-<td>Timestamp</td>
-<td>Last transition timestamp</td>
-</tr>
-</tbody>
-</table>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/reference/dnspolicy/index.html b/0.10.0/kuadrant-operator/doc/reference/dnspolicy/index.html
deleted file mode 100644
index 944efdfeb..000000000
--- a/0.10.0/kuadrant-operator/doc/reference/dnspolicy/index.html
+++ /dev/null
@@ -1,3913 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/dnspolicy/">
-      
-      
-        <link rel="prev" href="../../dns/">
-      
-      
-        <link rel="next" href="../../user-guides/gateway-dns/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Reference - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#the-dnspolicy-custom-resource-definition-crd" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Reference
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#dnspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#dnspolicyspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSPolicySpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#providerrefs" class="md-nav__link">
-    <span class="md-ellipsis">
-      ProviderRefs
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#providerref" class="md-nav__link">
-    <span class="md-ellipsis">
-      ProviderRef
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#healthcheckspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      HealthCheckSpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#loadbalancingspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      LoadBalancingSpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#loadbalancingweighted" class="md-nav__link">
-    <span class="md-ellipsis">
-      LoadBalancingWeighted
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#customweight" class="md-nav__link">
-    <span class="md-ellipsis">
-      CustomWeight
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#loadbalancinggeo" class="md-nav__link">
-    <span class="md-ellipsis">
-      LoadBalancingGeo
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#dnspolicystatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSPolicyStatus
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#healthcheckstatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      HealthCheckStatus
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#dnspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#dnspolicyspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSPolicySpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#providerrefs" class="md-nav__link">
-    <span class="md-ellipsis">
-      ProviderRefs
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#providerref" class="md-nav__link">
-    <span class="md-ellipsis">
-      ProviderRef
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#healthcheckspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      HealthCheckSpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#loadbalancingspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      LoadBalancingSpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#loadbalancingweighted" class="md-nav__link">
-    <span class="md-ellipsis">
-      LoadBalancingWeighted
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#customweight" class="md-nav__link">
-    <span class="md-ellipsis">
-      CustomWeight
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#loadbalancinggeo" class="md-nav__link">
-    <span class="md-ellipsis">
-      LoadBalancingGeo
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#dnspolicystatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      DNSPolicyStatus
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#healthcheckstatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      HealthCheckStatus
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/reference/dnspolicy.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="the-dnspolicy-custom-resource-definition-crd">The DNSPolicy Custom Resource Definition (CRD)<a class="headerlink" href="#the-dnspolicy-custom-resource-definition-crd" title="Permanent link">&para;</a></h1>
-<ul>
-<li><a href="#DNSPolicy">DNSPolicy</a></li>
-<li><a href="#dnspolicyspec">DNSPolicySpec</a><ul>
-<li><a href="#providerRefs">ProviderRefs</a></li>
-<li><a href="#healthcheckspec">HealthCheckSpec</a></li>
-<li><a href="#loadbalancingspec">LoadBalancingSpec</a></li>
-<li><a href="#loadbalancingweighted">LoadBalancingWeighted</a><ul>
-<li><a href="#customweight">CustomWeight</a></li>
-</ul>
-</li>
-<li><a href="#loadbalancinggeo">LoadBalancingGeo</a></li>
-</ul>
-</li>
-<li><a href="#dnspolicystatus">DNSPolicyStatus</a><ul>
-<li><a href="#healthcheckstatus">HealthCheckStatus</a></li>
-</ul>
-</li>
-</ul>
-<h2 id="dnspolicy">DNSPolicy<a class="headerlink" href="#dnspolicy" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>spec</code></td>
-<td><a href="#dnspolicyspec">DNSPolicySpec</a></td>
-<td style="text-align: center;">Yes</td>
-<td>The specification for DNSPolicy custom resource</td>
-</tr>
-<tr>
-<td><code>status</code></td>
-<td><a href="#dnspolicystatus">DNSPolicyStatus</a></td>
-<td style="text-align: center;">No</td>
-<td>The status for the custom resource</td>
-</tr>
-</tbody>
-</table>
-<h2 id="dnspolicyspec">DNSPolicySpec<a class="headerlink" href="#dnspolicyspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>targetRef</code></td>
-<td><a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1alpha2.LocalPolicyTargetReference">Gateway API LocalPolicyTargetReference</a></td>
-<td style="text-align: center;">Yes</td>
-<td>Reference to a Kubernetes resource that the policy attaches to</td>
-</tr>
-<tr>
-<td><code>healthCheck</code></td>
-<td><a href="#healthcheckspec">HealthCheckSpec</a></td>
-<td style="text-align: center;">No</td>
-<td>HealthCheck spec</td>
-</tr>
-<tr>
-<td><code>loadBalancing</code></td>
-<td><a href="#loadbalancingspec">LoadBalancingSpec</a></td>
-<td style="text-align: center;">Yes(loadbalanced only)</td>
-<td>LoadBalancing Spec, required when routingStrategy is "loadbalanced"</td>
-</tr>
-<tr>
-<td><code>routingStrategy</code></td>
-<td>String (immutable)</td>
-<td style="text-align: center;">Yes</td>
-<td><strong>Immutable!</strong> Routing Strategy to use, one of "simple" or "loadbalanced"</td>
-</tr>
-<tr>
-<td><code>providerRefs</code></td>
-<td><a href="#providerrefs">ProviderRefs</a></td>
-<td style="text-align: center;">Yes</td>
-<td>array of references to providers. (currently limited to max 1)</td>
-</tr>
-</tbody>
-</table>
-<h2 id="providerrefs">ProviderRefs<a class="headerlink" href="#providerrefs" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>providerRefs</code></td>
-<td>[]<a href="#providerref">ProviderRef</a></td>
-<td style="text-align: center;">Yes</td>
-<td>max 1 reference. This is an array of providerRef that points to a local secret(s) that contains the required provider auth values</td>
-</tr>
-</tbody>
-</table>
-<h2 id="providerref">ProviderRef<a class="headerlink" href="#providerref" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>name</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Name of the secret in the same namespace that contains the provider credentials</td>
-</tr>
-</tbody>
-</table>
-<h2 id="healthcheckspec">HealthCheckSpec<a class="headerlink" href="#healthcheckspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>endpoint</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Endpoint is the path to append to the host to reach the expected health check</td>
-</tr>
-<tr>
-<td><code>port</code></td>
-<td>Number</td>
-<td style="text-align: center;">Yes</td>
-<td>Port to connect to the host on</td>
-</tr>
-<tr>
-<td><code>protocol</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Protocol to use when connecting to the host, valid values are "HTTP" or "HTTPS"</td>
-</tr>
-<tr>
-<td><code>failureThreshold</code></td>
-<td>Number</td>
-<td style="text-align: center;">Yes</td>
-<td>FailureThreshold is a limit of consecutive failures that must occur for a host to be considered unhealthy</td>
-</tr>
-</tbody>
-</table>
-<h2 id="loadbalancingspec">LoadBalancingSpec<a class="headerlink" href="#loadbalancingspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>weighted</code></td>
-<td><a href="#loadbalancingweighted">LoadBalancingWeighted</a></td>
-<td style="text-align: center;">Yes</td>
-<td>Weighted routing spec</td>
-</tr>
-<tr>
-<td><code>geo</code></td>
-<td><a href="#loadbalancinggeo">LoadBalancingGeo</a></td>
-<td style="text-align: center;">Yes</td>
-<td>Geo routing spec</td>
-</tr>
-</tbody>
-</table>
-<h2 id="loadbalancingweighted">LoadBalancingWeighted<a class="headerlink" href="#loadbalancingweighted" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>defaultWeight</code></td>
-<td>Number</td>
-<td style="text-align: center;">Yes</td>
-<td>Default weight to apply to created records</td>
-</tr>
-<tr>
-<td><code>custom</code></td>
-<td>[]<a href="#customweight">CustomWeight</a></td>
-<td style="text-align: center;">No</td>
-<td>Custom weights to manipulate records weights based on label selectors</td>
-</tr>
-</tbody>
-</table>
-<h2 id="customweight">CustomWeight<a class="headerlink" href="#customweight" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>selector</code></td>
-<td>metav1.LabelSelector</td>
-<td>Label Selector to specify resources that should have this weight applied</td>
-</tr>
-<tr>
-<td><code>weight</code></td>
-<td>Number</td>
-<td>Weight value to apply for matching resources</td>
-</tr>
-</tbody>
-</table>
-<h2 id="loadbalancinggeo">LoadBalancingGeo<a class="headerlink" href="#loadbalancinggeo" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>defaultGeo</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Default geo to apply to records</td>
-</tr>
-</tbody>
-</table>
-<h2 id="dnspolicystatus">DNSPolicyStatus<a class="headerlink" href="#dnspolicystatus" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>observedGeneration</code></td>
-<td>String</td>
-<td>Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec.</td>
-</tr>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Condition">Kubernetes meta/v1.Condition</a></td>
-<td>List of conditions that define that status of the resource.</td>
-</tr>
-<tr>
-<td><code>healthCheck</code></td>
-<td><a href="#healthcheckstatus">HealthCheckStatus</a></td>
-<td>HealthCheck status.</td>
-</tr>
-<tr>
-<td><code>recordConditions</code></td>
-<td>[String][]<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Condition">Kubernetes meta/v1.Condition</a></td>
-<td>Status of individual DNSRecords owned by this policy.</td>
-</tr>
-</tbody>
-</table>
-<h2 id="healthcheckstatus">HealthCheckStatus<a class="headerlink" href="#healthcheckstatus" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Condition">Kubernetes meta/v1.Condition</a></td>
-<td>List of conditions that define that status of the resource.</td>
-</tr>
-</tbody>
-</table>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/reference/kuadrant/index.html b/0.10.0/kuadrant-operator/doc/reference/kuadrant/index.html
deleted file mode 100644
index 15433db44..000000000
--- a/0.10.0/kuadrant-operator/doc/reference/kuadrant/index.html
+++ /dev/null
@@ -1,3442 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/kuadrant/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>The Kuadrant Custom Resource Definition (CRD) - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#the-kuadrant-custom-resource-definition-crd" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              The Kuadrant Custom Resource Definition (CRD)
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      kuadrant
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrantspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      KuadrantSpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrantstatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      KuadrantStatus
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/reference/kuadrant.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="the-kuadrant-custom-resource-definition-crd">The Kuadrant Custom Resource Definition (CRD)<a class="headerlink" href="#the-kuadrant-custom-resource-definition-crd" title="Permanent link">&para;</a></h1>
-<h2 id="kuadrant">kuadrant<a class="headerlink" href="#kuadrant" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>spec</code></td>
-<td><a href="#kuadrantspec">KuadrantSpec</a></td>
-<td style="text-align: center;">No</td>
-<td>Blank specification</td>
-</tr>
-<tr>
-<td><code>status</code></td>
-<td><a href="#kuadrantstatus">KuadrantStatus</a></td>
-<td style="text-align: center;">No</td>
-<td>The status for the custom resources.</td>
-</tr>
-</tbody>
-</table>
-<h2 id="kuadrantspec">KuadrantSpec<a class="headerlink" href="#kuadrantspec" title="Permanent link">&para;</a></h2>
-<p>Currently blank specification.</p>
-<h2 id="kuadrantstatus">KuadrantStatus<a class="headerlink" href="#kuadrantstatus" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>observedGeneration</code></td>
-<td>String</td>
-<td>Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec.</td>
-</tr>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="https://pkg.go.dev/k8s.io/apimachinery@v0.28.4/pkg/apis/meta/v1#Condition">ConditionSpec</a></td>
-<td>List of conditions that define that status of the resource.</td>
-</tr>
-</tbody>
-</table>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/reference/ratelimitpolicy/index.html b/0.10.0/kuadrant-operator/doc/reference/ratelimitpolicy/index.html
deleted file mode 100644
index 7fc53f50c..000000000
--- a/0.10.0/kuadrant-operator/doc/reference/ratelimitpolicy/index.html
+++ /dev/null
@@ -1,3859 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/ratelimitpolicy/">
-      
-      
-        <link rel="prev" href="../../rate-limiting/">
-      
-      
-        <link rel="next" href="../../user-guides/secure-protect-connect/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Reference - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#the-ratelimitpolicy-custom-resource-definition-crd" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Reference
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#ratelimitpolicyspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicySpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="RateLimitPolicySpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#ratelimitpolicycommonspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicyCommonSpec
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limit" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limit
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Limit">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#ratelimit" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimit
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#whencondition" class="md-nav__link">
-    <span class="md-ellipsis">
-      WhenCondition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#ratelimitpolicystatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicyStatus
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="RateLimitPolicyStatus">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#conditionspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      ConditionSpec
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#ratelimitpolicyspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicySpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="RateLimitPolicySpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#ratelimitpolicycommonspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicyCommonSpec
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limit" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limit
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Limit">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#ratelimit" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimit
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#whencondition" class="md-nav__link">
-    <span class="md-ellipsis">
-      WhenCondition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#ratelimitpolicystatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      RateLimitPolicyStatus
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="RateLimitPolicyStatus">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#conditionspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      ConditionSpec
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/reference/ratelimitpolicy.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="the-ratelimitpolicy-custom-resource-definition-crd">The RateLimitPolicy Custom Resource Definition (CRD)<a class="headerlink" href="#the-ratelimitpolicy-custom-resource-definition-crd" title="Permanent link">&para;</a></h1>
-<ul>
-<li><a href="#ratelimitpolicy">RateLimitPolicy</a></li>
-<li><a href="#ratelimitpolicyspec">RateLimitPolicySpec</a><ul>
-<li><a href="#rateLimitPolicyCommonSpec">RateLimitPolicyCommonSpec</a></li>
-<li><a href="#limit">Limit</a><ul>
-<li><a href="#ratelimit">RateLimit</a></li>
-<li><a href="#whencondition">WhenCondition</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#ratelimitpolicystatus">RateLimitPolicyStatus</a><ul>
-<li><a href="#conditionspec">ConditionSpec</a></li>
-</ul>
-</li>
-</ul>
-<h2 id="ratelimitpolicy">RateLimitPolicy<a class="headerlink" href="#ratelimitpolicy" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>spec</code></td>
-<td><a href="#ratelimitpolicyspec">RateLimitPolicySpec</a></td>
-<td style="text-align: center;">Yes</td>
-<td>The specification for RateLimitPolicy custom resource</td>
-</tr>
-<tr>
-<td><code>status</code></td>
-<td><a href="#ratelimitpolicystatus">RateLimitPolicyStatus</a></td>
-<td style="text-align: center;">No</td>
-<td>The status for the custom resource</td>
-</tr>
-</tbody>
-</table>
-<h2 id="ratelimitpolicyspec">RateLimitPolicySpec<a class="headerlink" href="#ratelimitpolicyspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>targetRef</code></td>
-<td><a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1alpha2.LocalPolicyTargetReference">LocalPolicyTargetReference</a></td>
-<td>Yes</td>
-<td>Reference to a Kubernetes resource that the policy attaches to</td>
-</tr>
-<tr>
-<td><code>defaults</code></td>
-<td><a href="#rateLimitPolicyCommonSpec">RateLimitPolicyCommonSpec</a></td>
-<td>No</td>
-<td>Default limit definitions. This field is mutually exclusive with the <code>limits</code> field</td>
-</tr>
-<tr>
-<td><code>overrides</code></td>
-<td><a href="#rateLimitPolicyCommonSpec">RateLimitPolicyCommonSpec</a></td>
-<td>No</td>
-<td>Overrides limit definitions. This field is mutually exclusive with the <code>limits</code> field and <code>defaults</code> field. This field is only allowed for policies targeting <code>Gateway</code> in <code>targetRef.kind</code></td>
-</tr>
-<tr>
-<td><code>limits</code></td>
-<td>Map<String: <a href="#limit">Limit</a>></td>
-<td>No</td>
-<td>Limit definitions. This field is mutually exclusive with the <a href="#rateLimitPolicyCommonSpec"><code>defaults</code></a> field</td>
-</tr>
-</tbody>
-</table>
-<h3 id="ratelimitpolicycommonspec">RateLimitPolicyCommonSpec<a class="headerlink" href="#ratelimitpolicycommonspec" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>limits</code></td>
-<td>Map<String: <a href="#limit">Limit</a>></td>
-<td>No</td>
-<td>Explicit Limit definitions. This field is mutually exclusive with <a href="#ratelimitpolicyspec">RateLimitPolicySpec</a> <code>limits</code> field</td>
-</tr>
-</tbody>
-</table>
-<h3 id="limit">Limit<a class="headerlink" href="#limit" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>rates</code></td>
-<td>[]<a href="#ratelimit">RateLimit</a></td>
-<td style="text-align: center;">No</td>
-<td>List of rate limits associated with the limit definition</td>
-</tr>
-<tr>
-<td><code>counters</code></td>
-<td>[]String</td>
-<td style="text-align: center;">No</td>
-<td>List of rate limit counter qualifiers. Items must be a valid <a href="https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md">Well-known attribute</a>. Each distinct value resolved in the data plane starts a separate counter for each rate limit.</td>
-</tr>
-<tr>
-<td><code>routeSelectors</code></td>
-<td>[]<a href="../route-selectors/#routeselector">RouteSelector</a></td>
-<td style="text-align: center;">No</td>
-<td>List of selectors of HTTPRouteRules whose matching rules activate the limit. At least one HTTPRouteRule must be selected to activate the limit. If omitted, all HTTPRouteRules of the targeted HTTPRoute activate the limit. Do not use it in policies targeting a Gateway.</td>
-</tr>
-<tr>
-<td><code>when</code></td>
-<td>[]<a href="#whencondition">WhenCondition</a></td>
-<td style="text-align: center;">No</td>
-<td>List of additional dynamic conditions (expressions) to activate the limit. All expression must evaluate to true for the limit to be applied. Use it for filtering attributes that cannot be expressed in the targeted HTTPRoute's <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or when targeting a Gateway.</td>
-</tr>
-</tbody>
-</table>
-<h4 id="ratelimit">RateLimit<a class="headerlink" href="#ratelimit" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>limit</code></td>
-<td>Number</td>
-<td style="text-align: center;">Yes</td>
-<td>Maximum value allowed within the given period of time (duration)</td>
-</tr>
-<tr>
-<td><code>duration</code></td>
-<td>Number</td>
-<td style="text-align: center;">Yes</td>
-<td>The period of time in the specified unit that the limit applies</td>
-</tr>
-<tr>
-<td><code>unit</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>Unit of time for the duration of the limit. One-of: "second", "minute", "hour", "day".</td>
-</tr>
-</tbody>
-</table>
-<h4 id="whencondition">WhenCondition<a class="headerlink" href="#whencondition" title="Permanent link">&para;</a></h4>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>selector</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>A valid <a href="https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md">Well-known attribute</a> whose resolved value in the data plane will be compared to <code>value</code>, using the <code>operator</code>.</td>
-</tr>
-<tr>
-<td><code>operator</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>The binary operator to be applied to the resolved value specified by the selector. One-of: "eq" (equal to), "neq" (not equal to)</td>
-</tr>
-<tr>
-<td><code>value</code></td>
-<td>String</td>
-<td style="text-align: center;">Yes</td>
-<td>The static value to be compared to the one resolved from the selector.</td>
-</tr>
-</tbody>
-</table>
-<h2 id="ratelimitpolicystatus">RateLimitPolicyStatus<a class="headerlink" href="#ratelimitpolicystatus" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>observedGeneration</code></td>
-<td>String</td>
-<td>Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec.</td>
-</tr>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="#conditionspec">ConditionSpec</a></td>
-<td>List of conditions that define that status of the resource.</td>
-</tr>
-</tbody>
-</table>
-<h3 id="conditionspec">ConditionSpec<a class="headerlink" href="#conditionspec" title="Permanent link">&para;</a></h3>
-<ul>
-<li>The <em>lastTransitionTime</em> field provides a timestamp for when the entity last transitioned from one status to another.</li>
-<li>The <em>message</em> field is a human-readable message indicating details about the transition.</li>
-<li>The <em>reason</em> field is a unique, one-word, CamelCase reason for the condition’s last transition.</li>
-<li>The <em>status</em> field is a string, with possible values <strong>True</strong>, <strong>False</strong>, and <strong>Unknown</strong>.</li>
-<li>The <em>type</em> field is a string with the following possible values:<ul>
-<li>Available: the resource has successfully configured;</li>
-</ul>
-</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>type</code></td>
-<td>String</td>
-<td>Condition Type</td>
-</tr>
-<tr>
-<td><code>status</code></td>
-<td>String</td>
-<td>Status: True, False, Unknown</td>
-</tr>
-<tr>
-<td><code>reason</code></td>
-<td>String</td>
-<td>Condition state reason</td>
-</tr>
-<tr>
-<td><code>message</code></td>
-<td>String</td>
-<td>Condition state description</td>
-</tr>
-<tr>
-<td><code>lastTransitionTime</code></td>
-<td>Timestamp</td>
-<td>Last transition timestamp</td>
-</tr>
-</tbody>
-</table>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/reference/route-selectors/index.html b/0.10.0/kuadrant-operator/doc/reference/route-selectors/index.html
deleted file mode 100644
index 63ebcaa2f..000000000
--- a/0.10.0/kuadrant-operator/doc/reference/route-selectors/index.html
+++ /dev/null
@@ -1,3473 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/route-selectors/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Route selectors - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#route-selectors" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Route selectors
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#the-routeselectors-field" class="md-nav__link">
-    <span class="md-ellipsis">
-      The routeSelectors field
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The routeSelectors field">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#routeselector" class="md-nav__link">
-    <span class="md-ellipsis">
-      RouteSelector
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#mechanics-of-the-route-selectors" class="md-nav__link">
-    <span class="md-ellipsis">
-      Mechanics of the route selectors
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#golden-rules-and-corner-cases" class="md-nav__link">
-    <span class="md-ellipsis">
-      Golden rules and corner cases
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/reference/route-selectors.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="route-selectors">Route selectors<a class="headerlink" href="#route-selectors" title="Permanent link">&para;</a></h1>
-<p>The route selectors of a policy spec or policy rule (limit definition or auth rule) allow to specify <strong>selectors of routes</strong> or parts of a route, that <em>transitively induce a set of conditions for a policy or policy rule to be enforced</em>. It is defined as a set of HTTP route matching rules, where these matching rules must exist, partially or identically stated within the HTTPRouteRules of the HTTPRoute that is targeted by the policy.</p>
-<h2 id="the-routeselectors-field">The <code>routeSelectors</code> field<a class="headerlink" href="#the-routeselectors-field" title="Permanent link">&para;</a></h2>
-<p>The <code>routeSelectors</code> field can be found in policy specs and policy rules (limit definition or auth rule).</p>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>routeSelectors</code></td>
-<td>[]<a href="#routeselector">RouteSelector</a></td>
-<td style="text-align: center;">No</td>
-<td>List of route selectors of HTTPRouteRules whose HTTPRouteMatches activate the policy or policy rule.</td>
-</tr>
-</tbody>
-</table>
-<h3 id="routeselector">RouteSelector<a class="headerlink" href="#routeselector" title="Permanent link">&para;</a></h3>
-<p>Each <code>RouteSelector</code> is an object composed of a set of <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.HTTPPathMatch">HTTPRouteMatch</a> objects (from Gateway API), and an additional <code>hostnames</code> field.</p>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>matches</code></td>
-<td>[]<a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.HTTPRouteMatch">HTTPRouteMatch</a></td>
-<td style="text-align: center;">No</td>
-<td>List of selectors of HTTPRouteRules whose matching rules activate the policy or policy rule</td>
-</tr>
-<tr>
-<td><code>hostnames</code></td>
-<td>[]<a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.Hostname">Hostname</a></td>
-<td style="text-align: center;">No</td>
-<td>List of hostnames of the HTTPRoute that activate the policy or policy rule</td>
-</tr>
-</tbody>
-</table>
-<h2 id="mechanics-of-the-route-selectors">Mechanics of the route selectors<a class="headerlink" href="#mechanics-of-the-route-selectors" title="Permanent link">&para;</a></h2>
-<p>Route selectors matches and the HTTPRoute's HTTPRouteMatches are pairwise compared to select or not select HTTPRouteRules that should activate a policy rule. To decide whether the route selector selects a HTTPRouteRule or not, for each pair of route selector HTTPRouteMatch and HTTPRoute HTTPRouteMatch:</p>
-<ol>
-<li>The route selector selects the HTTPRoute's HTTPRouteRule if the HTTPRouteRule contains at least one HTTPRouteMatch that specifies fields that are literally identical to all the fields specified by at least one HTTPRouteMatch of the route selector.</li>
-<li>A HTTPRouteMatch within a HTTPRouteRule may include other fields that are not specified in a route selector match, and yet the route selector match selects the HTTPRouteRule if all fields of the route selector match are identically included in the HTTPRouteRule's HTTPRouteMatch; the opposite is NOT true.</li>
-<li>Each field <code>path</code> of a HTTPRouteMatch, as well as each field <code>method</code> of a HTTPRouteMatch, as well as each element of the fields <code>headers</code> and <code>queryParams</code> of a HTTPRouteMatch, is atomic – this is true for the HTTPRouteMatches within a HTTPRouteRule, as well as for HTTPRouteMatches of a route selector.</li>
-</ol>
-<p>Additionally, at least one hostname specified in a route selector must identically match one of the hostnames specified (or inherited, when omitted) by the targeted HTTPRoute.</p>
-<p>The semantics of the route selectors allows to assertively relate policy rule definitions to routing rules, with benefits for identifying the subsets of the network that are covered by a policy rule, while preventing unreachable definitions, as well as the overhead associated with the maintenance of such rules across multiple resources throughout time, according to network topology beneath. Moreover, the requirement of not having to be a full copy of the targeted HTTPRouteRule matches, but only partially identical, helps prevent repetition to some degree, as well as it enables to more easily define policy rules that scope across multiple HTTPRouteRules (by specifying less rules in the selector).</p>
-<h2 id="golden-rules-and-corner-cases">Golden rules and corner cases<a class="headerlink" href="#golden-rules-and-corner-cases" title="Permanent link">&para;</a></h2>
-<p>A few rules and corner cases to keep in mind while using the RLP's <code>routeSelectors</code>:</p>
-<ol>
-<li><strong>The golden rule –</strong> The route selectors in a policy or policy rule are <strong>not</strong> to be interpreted as the route matching rules that activate the policy or policy rule, but as <strong>selectors of the route rules</strong> that activate the policy or policy rule.</li>
-<li>Due to (1) above, this can lead to cases, e.g., where a route selector that states <code>matches: [{ method: POST }]</code> selects a HTTPRouteRule that defines <code>matches: [{ method: POST },  { method: GET }]</code>, effectively causing the policy or policy rule to be activated on requests to the HTTP method <code>POST</code>, but <strong>also</strong> to the HTTP method <code>GET</code>.</li>
-<li>The requirement for the route selector match to state patterns that are identical to the patterns stated by the HTTPRouteRule (partially or entirely) makes, e.g., a route selector such as <code>matches: { path: { type: PathPrefix, value: /foo } }</code> to select a HTTPRouteRule that defines <code>matches: { path: { type: PathPrefix, value: /foo }, method: GET }</code>, but <strong>not</strong> to select a HTTPRouteRule that only defines <code>matches: { method: GET }</code>, even though the latter includes technically all HTTP paths; <strong>nor</strong> it selects a HTTPRouteRule that only defines <code>matches: { path: { type: Exact, value: /foo } }</code>, even though all requests to the exact path <code>/foo</code> are also technically requests to <code>/foo*</code>.</li>
-<li>The atomicity property of fields of the route selectors makes, e.g., a route selector such as <code>matches: { path: { value: /foo } }</code> to select a HTTPRouteRule that defines <code>matches: { path: { value: /foo } }</code>, but <strong>not</strong> to select a HTTPRouteRule that only defines <code>matches: { path: { type: PathPrefix, value: /foo } }</code>. (This case may actually never happen because <code>PathPrefix</code> is the default value for <code>path.type</code> and will be set automatically by the Kubernetes API server.)</li>
-</ol>
-<p>Due to the nature of route selectors of defining pointers to HTTPRouteRules, the <code>routeSelectors</code> field is not supported in a RLP that targets a Gateway resource.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/reference/tlspolicy/index.html b/0.10.0/kuadrant-operator/doc/reference/tlspolicy/index.html
deleted file mode 100644
index aaec98cc7..000000000
--- a/0.10.0/kuadrant-operator/doc/reference/tlspolicy/index.html
+++ /dev/null
@@ -1,3582 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/tlspolicy/">
-      
-      
-        <link rel="prev" href="../../tls/">
-      
-      
-        <link rel="next" href="../../auth/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Reference - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#the-tlspolicy-custom-resource-definition-crd" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Reference
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#tlspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      TLSPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#tlspolicyspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      TLSPolicySpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#tlspolicystatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      TLSPolicyStatus
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#tlspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      TLSPolicy
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#tlspolicyspec" class="md-nav__link">
-    <span class="md-ellipsis">
-      TLSPolicySpec
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#tlspolicystatus" class="md-nav__link">
-    <span class="md-ellipsis">
-      TLSPolicyStatus
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/reference/tlspolicy.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="the-tlspolicy-custom-resource-definition-crd">The TLSPolicy Custom Resource Definition (CRD)<a class="headerlink" href="#the-tlspolicy-custom-resource-definition-crd" title="Permanent link">&para;</a></h1>
-<ul>
-<li><a href="#TLSPolicy">TLSPolicy</a></li>
-<li><a href="#tlspolicyspec">TLSPolicySpec</a></li>
-<li><a href="#tlspolicystatus">TLSPolicyStatus</a></li>
-</ul>
-<h2 id="tlspolicy">TLSPolicy<a class="headerlink" href="#tlspolicy" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>spec</code></td>
-<td><a href="#tlspolicyspec">TLSPolicySpec</a></td>
-<td style="text-align: center;">Yes</td>
-<td>The specification for TLSPolicy custom resource</td>
-</tr>
-<tr>
-<td><code>status</code></td>
-<td><a href="#tlspolicystatus">TLSPolicyStatus</a></td>
-<td style="text-align: center;">No</td>
-<td>The status for the custom resource</td>
-</tr>
-</tbody>
-</table>
-<h2 id="tlspolicyspec">TLSPolicySpec<a class="headerlink" href="#tlspolicyspec" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th style="text-align: center;"><strong>Required</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>targetRef</code></td>
-<td><a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1alpha2.LocalPolicyTargetReference">Gateway API LocalPolicyTargetReference</a></td>
-<td style="text-align: center;">Yes</td>
-<td>Reference to a Kuberentes resource that the policy attaches to</td>
-</tr>
-<tr>
-<td><code>issuerRef</code></td>
-<td><a href="https://cert-manager.io/v1.13-docs/reference/api-docs/#meta.cert-manager.io/v1.ObjectReference">CertManager meta/v1.ObjectReference</a></td>
-<td style="text-align: center;">Yes</td>
-<td>IssuerRef is a reference to the issuer for the created certificate</td>
-</tr>
-<tr>
-<td><code>commonName</code></td>
-<td>String</td>
-<td style="text-align: center;">No</td>
-<td>CommonName is a common name to be used on the created certificate</td>
-</tr>
-<tr>
-<td><code>duration</code></td>
-<td><a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">Kubernetes meta/v1.Duration</a></td>
-<td style="text-align: center;">No</td>
-<td>The requested 'duration' (i.e. lifetime) of the created certificate.</td>
-</tr>
-<tr>
-<td><code>renewBefore</code></td>
-<td><a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">Kubernetes meta/v1.Duration</a></td>
-<td style="text-align: center;">No</td>
-<td>How long before the currently issued certificate's expiry cert-manager should renew the certificate.</td>
-</tr>
-<tr>
-<td><code>usages</code></td>
-<td>[]<a href="https://cert-manager.io/v1.13-docs/reference/api-docs/#cert-manager.io/v1.KeyUsage">CertManager v1.KeyUsage</a></td>
-<td style="text-align: center;">No</td>
-<td>Usages is the set of x509 usages that are requested for the certificate. Defaults to <code>digital signature</code> and <code>key encipherment</code> if not specified</td>
-</tr>
-<tr>
-<td><code>revisionHistoryLimit</code></td>
-<td>Number</td>
-<td style="text-align: center;">No</td>
-<td>RevisionHistoryLimit is the maximum number of CertificateRequest revisions that are maintained in the Certificate's history</td>
-</tr>
-<tr>
-<td><code>privateKey</code></td>
-<td><a href="https://cert-manager.io/v1.13-docs/reference/api-docs/#cert-manager.io/v1.CertificatePrivateKey">CertManager meta/v1.CertificatePrivateKey</a></td>
-<td style="text-align: center;">No</td>
-<td>Options to control private keys used for the Certificate</td>
-</tr>
-</tbody>
-</table>
-<p><strong>IssuerRef certmanmetav1.ObjectReference</strong></p>
-<h2 id="tlspolicystatus">TLSPolicyStatus<a class="headerlink" href="#tlspolicystatus" title="Permanent link">&para;</a></h2>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>observedGeneration</code></td>
-<td>String</td>
-<td>Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec.</td>
-</tr>
-<tr>
-<td><code>conditions</code></td>
-<td>[]<a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Condition">Kubernetes meta/v1.Condition</a></td>
-<td>List of conditions that define that status of the resource.</td>
-</tr>
-</tbody>
-</table>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/tls/index.html b/0.10.0/kuadrant-operator/doc/tls/index.html
deleted file mode 100644
index 6a5efd095..000000000
--- a/0.10.0/kuadrant-operator/doc/tls/index.html
+++ /dev/null
@@ -1,3637 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/tls/">
-      
-      
-        <link rel="prev" href="../user-guides/gateway-dns/">
-      
-      
-        <link rel="next" href="../reference/tlspolicy/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#tls" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How it works">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#the-tlspolicy-custom-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      The TLSPolicy custom resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The TLSPolicy custom resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#high-level-example-and-field-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      High-level example and field definition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-the-tlspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the TLSPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Using the TLSPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-gateway-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a Gateway networking resource
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#known-limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Known limitations
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="How it works">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#the-tlspolicy-custom-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      The TLSPolicy custom resource
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="The TLSPolicy custom resource">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#high-level-example-and-field-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      High-level example and field definition
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-the-tlspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using the TLSPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Using the TLSPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#targeting-a-gateway-networking-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Targeting a Gateway networking resource
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#examples" class="md-nav__link">
-    <span class="md-ellipsis">
-      Examples
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#known-limitations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Known limitations
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/tls.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="tls">TLS<a class="headerlink" href="#tls" title="Permanent link">&para;</a></h1>
-<p>A Kuadrant TLSPolicy custom resource:</p>
-<ol>
-<li>Targets Gateway API networking resources <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.Gateway">Gateways</a> to provide tls for gateway listeners by managing the lifecycle of tls certificates using <a href="https://cert-manager.io"><code>CertManager</code></a>.</li>
-</ol>
-<h2 id="how-it-works">How it works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h2>
-<h3 id="the-tlspolicy-custom-resource">The TLSPolicy custom resource<a class="headerlink" href="#the-tlspolicy-custom-resource" title="Permanent link">&para;</a></h3>
-<h4 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h4>
-<p>The <code>TLSPolicy</code> spec includes the following parts:</p>
-<ul>
-<li>A reference to an existing Gateway API resource (<code>spec.targetRef</code>)</li>
-</ul>
-<h4 id="high-level-example-and-field-definition">High-level example and field definition<a class="headerlink" href="#high-level-example-and-field-definition" title="Permanent link">&para;</a></h4>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">TLSPolicy</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-tls-policy</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="c1"># reference to an existing networking resource to attach the policy to</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="c1"># it can only be a Gateway API Gateway resource</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span><span class="c1"># it can only refer to objects in the same namespace as the TLSPolicy</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">mygateway</span>
-</span></code></pre></div>
-<p>Check out the <a href="../reference/tlspolicy/">API reference</a> for a full specification of the TLSPolicy CRD.</p>
-<h2 id="using-the-tlspolicy">Using the TLSPolicy<a class="headerlink" href="#using-the-tlspolicy" title="Permanent link">&para;</a></h2>
-<h3 id="targeting-a-gateway-networking-resource">Targeting a Gateway networking resource<a class="headerlink" href="#targeting-a-gateway-networking-resource" title="Permanent link">&para;</a></h3>
-<p>When a TLSPolicy targets a Gateway, the policy will be enforced on all gateway listeners that have a valid TLS section.</p>
-<p>Target a Gateway by setting the <code>spec.targetRef</code> field of the TLSPolicy as follows:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">TLSPolicy</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;TLSPolicy name&gt;</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;Gateway Name&gt;</span>
-</span></code></pre></div>
-<h3 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent link">&para;</a></h3>
-<p>Check out the following user guides for examples of using the Kuadrant TLSPolicy:</p>
-<h3 id="known-limitations">Known limitations<a class="headerlink" href="#known-limitations" title="Permanent link">&para;</a></h3>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/index.html b/0.10.0/kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/index.html
deleted file mode 100644
index e3f9aaa17..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/index.html
+++ /dev/null
@@ -1,3803 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/">
-      
-      
-        <link rel="prev" href="../gateway-tls/">
-      
-      
-        <link rel="next" href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>AuthPolicy for Application Developers and Platform Engineers - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#enforcing-authentication-authorization-with-kuadrant-authpolicy" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              AuthPolicy for Application Developers and Platform Engineers
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-guide-1-4" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the guide ① → ④
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the guide ① → ④">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup-persona-cluster-admin" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup (Persona: Cluster admin)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-deploy-the-toy-store-sample-application-persona-app-developer" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Deploy the Toy Store sample application (Persona: App developer)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-protect-the-toy-store-application-persona-app-developer" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Protect the Toy Store application (Persona: App developer)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-create-a-default-deny-all-policy-at-the-level-of-the-gateway-persona-platform-engineer" class="md-nav__link">
-    <span class="md-ellipsis">
-      ④ Create a default "deny-all" policy at the level of the gateway (Persona: Platform engineer)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-guide-1-4" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the guide ① → ④
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the guide ① → ④">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup-persona-cluster-admin" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup (Persona: Cluster admin)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-deploy-the-toy-store-sample-application-persona-app-developer" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Deploy the Toy Store sample application (Persona: App developer)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-protect-the-toy-store-application-persona-app-developer" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Protect the Toy Store application (Persona: App developer)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-create-a-default-deny-all-policy-at-the-level-of-the-gateway-persona-platform-engineer" class="md-nav__link">
-    <span class="md-ellipsis">
-      ④ Create a default "deny-all" policy at the level of the gateway (Persona: Platform engineer)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/auth-for-app-devs-and-platform-engineers.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="enforcing-authentication-authorization-with-kuadrant-authpolicy">Enforcing authentication &amp; authorization with Kuadrant AuthPolicy<a class="headerlink" href="#enforcing-authentication-authorization-with-kuadrant-authpolicy" title="Permanent link">&para;</a></h1>
-<p>This guide walks you through the process of setting up a local Kubernetes cluster with Kuadrant where you will protect <a href="https://gateway-api.sigs.k8s.io/">Gateway API</a> endpoints by declaring Kuadrant AuthPolicy custom resources.</p>
-<p>Two AuthPolicies will be declared:</p>
-<table>
-<thead>
-<tr>
-<th>Use case</th>
-<th>AuthPolicy</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><strong>App developer</strong></td>
-<td>1 AuthPolicy targeting a HTTPRoute that routes traffic to a sample Toy Store application, and enforces API key authentication to all requests in this route, as well as requires API key owners to be mapped to <code>groups:admins</code> metadata to access a specific HTTPRouteRule of the route.</td>
-</tr>
-<tr>
-<td><strong>Platform engineer use-case</strong></td>
-<td>1 AuthPolicy targeting the <code>istio-ingressgateway</code> Gateway that enforces a trivial "deny-all" policy that locks down any other HTTPRoute attached to the Gateway.</td>
-</tr>
-</tbody>
-</table>
-<p>Topology:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>                   ┌───────────────┐
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>                   │ (AuthPolicy)  │
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>                   │    gw-auth    │
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>                   └───────┬───────┘
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>                           │
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>                           ▼
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>                ┌──────────────────────┐
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>                │     (Gateway)        │
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>                │ istio-ingressgateway │
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>          ┌────►│                      │◄───┐
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>          │     │          *           │    │
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>          │     └──────────────────────┘    │
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>          │                                 │
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a> ┌────────┴─────────┐              ┌────────┴─────────┐
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a> │   (HTTPRoute)    │              │   (HTTPRoute)    │
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a> │    toystore      │              │      other       │
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a> │                  │              │                  │
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a> │ api.toystore.com │              │ *.other-apps.com │
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a> └──────────────────┘              └──────────────────┘
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>          ▲
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>          │
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a>  ┌───────┴───────┐
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a>  │ (AuthPolicy)  │
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a>  │    toystore   │
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a>  └───────────────┘
-</span></code></pre></div>
-<h2 id="requisites">Requisites<a class="headerlink" href="#requisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="https://docker.io">Docker</a></li>
-</ul>
-<h2 id="run-the-guide-1-4">Run the guide ① → ④<a class="headerlink" href="#run-the-guide-1-4" title="Permanent link">&para;</a></h2>
-<h3 id="1-setup-persona-cluster-admin">①  Setup (Persona: <em>Cluster admin</em>)<a class="headerlink" href="#1-setup-persona-cluster-admin" title="Permanent link">&para;</a></h3>
-<p>Clone the repo:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>git<span class="w"> </span>clone<span class="w"> </span>git@github.com:Kuadrant/kuadrant-operator.git<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>kuadrant-operator
-</span></code></pre></div>
-<p>Run the following command to create a local Kubernetes cluster with <a href="https://kind.sigs.k8s.io/">Kind</a>, install &amp; deploy Kuadrant:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>Request an instance of Kuadrant in the <code>kuadrant-system</code> namespace:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec: {}</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="2-deploy-the-toy-store-sample-application-persona-app-developer">② Deploy the Toy Store sample application (Persona: <em>App developer</em>)<a class="headerlink" href="#2-deploy-the-toy-store-sample-application-persona-app-developer" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/toystore/toystore.yaml
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">metadata:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">  name: toystore</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">spec:</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">  - name: istio-ingressgateway</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">    namespace: istio-system</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">  hostnames:</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="s">  - api.toystore.com</span>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="s">  rules:</span>
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a><span class="s">  - matches:</span>
-</span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a><span class="s">    - method: GET</span>
-</span><span id="__span-4-18"><a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a><span class="s">      path:</span>
-</span><span id="__span-4-19"><a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a><span class="s">        type: PathPrefix</span>
-</span><span id="__span-4-20"><a id="__codelineno-4-20" name="__codelineno-4-20" href="#__codelineno-4-20"></a><span class="s">        value: &quot;/cars&quot;</span>
-</span><span id="__span-4-21"><a id="__codelineno-4-21" name="__codelineno-4-21" href="#__codelineno-4-21"></a><span class="s">    - method: GET</span>
-</span><span id="__span-4-22"><a id="__codelineno-4-22" name="__codelineno-4-22" href="#__codelineno-4-22"></a><span class="s">      path:</span>
-</span><span id="__span-4-23"><a id="__codelineno-4-23" name="__codelineno-4-23" href="#__codelineno-4-23"></a><span class="s">        type: PathPrefix</span>
-</span><span id="__span-4-24"><a id="__codelineno-4-24" name="__codelineno-4-24" href="#__codelineno-4-24"></a><span class="s">        value: &quot;/dolls&quot;</span>
-</span><span id="__span-4-25"><a id="__codelineno-4-25" name="__codelineno-4-25" href="#__codelineno-4-25"></a><span class="s">    backendRefs:</span>
-</span><span id="__span-4-26"><a id="__codelineno-4-26" name="__codelineno-4-26" href="#__codelineno-4-26"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-4-27"><a id="__codelineno-4-27" name="__codelineno-4-27" href="#__codelineno-4-27"></a><span class="s">      port: 80</span>
-</span><span id="__span-4-28"><a id="__codelineno-4-28" name="__codelineno-4-28" href="#__codelineno-4-28"></a><span class="s">  - matches:</span>
-</span><span id="__span-4-29"><a id="__codelineno-4-29" name="__codelineno-4-29" href="#__codelineno-4-29"></a><span class="s">    - path:</span>
-</span><span id="__span-4-30"><a id="__codelineno-4-30" name="__codelineno-4-30" href="#__codelineno-4-30"></a><span class="s">        type: PathPrefix</span>
-</span><span id="__span-4-31"><a id="__codelineno-4-31" name="__codelineno-4-31" href="#__codelineno-4-31"></a><span class="s">        value: &quot;/admin&quot;</span>
-</span><span id="__span-4-32"><a id="__codelineno-4-32" name="__codelineno-4-32" href="#__codelineno-4-32"></a><span class="s">    backendRefs:</span>
-</span><span id="__span-4-33"><a id="__codelineno-4-33" name="__codelineno-4-33" href="#__codelineno-4-33"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-4-34"><a id="__codelineno-4-34" name="__codelineno-4-34" href="#__codelineno-4-34"></a><span class="s">      port: 80</span>
-</span><span id="__span-4-35"><a id="__codelineno-4-35" name="__codelineno-4-35" href="#__codelineno-4-35"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Export the gateway hostname and port:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_HOST</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>istio-ingressgateway<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.addresses[0].value}&#39;</span><span class="k">)</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_PORT</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>istio-ingressgateway<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.listeners[?(@.name==&quot;http&quot;)].port}&#39;</span><span class="k">)</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">GATEWAY_URL</span><span class="o">=</span><span class="nv">$INGRESS_HOST</span>:<span class="nv">$INGRESS_PORT</span>
-</span></code></pre></div>
-<p>Send requests to the application unprotected:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/cars<span class="w"> </span>-i
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/dolls<span class="w"> </span>-i
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/admin<span class="w"> </span>-i
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h3 id="3-protect-the-toy-store-application-persona-app-developer">③ Protect the Toy Store application (Persona: <em>App developer</em>)<a class="headerlink" href="#3-protect-the-toy-store-application-persona-app-developer" title="Permanent link">&para;</a></h3>
-<p>Create the AuthPolicy to enforce the following auth rules:</p>
-<ul>
-<li><strong>Authentication:</strong></li>
-<li>All users must present a valid API key</li>
-<li><strong>Authorization:</strong></li>
-<li><code>/admin*</code> routes require user mapped to the <code>admins</code> group (<code>kuadrant.io/groups=admins</code> annotation added to the Kubernetes API key Secret)</li>
-</ul>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: AuthPolicy</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">spec:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">    kind: HTTPRoute</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">    name: toystore</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">  rules:</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">    authentication:</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="s">      &quot;api-key-authn&quot;:</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="s">        apiKey:</span>
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a><span class="s">          selector: {}</span>
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a><span class="s">        credentials:</span>
-</span><span id="__span-9-17"><a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a><span class="s">          authorizationHeader:</span>
-</span><span id="__span-9-18"><a id="__codelineno-9-18" name="__codelineno-9-18" href="#__codelineno-9-18"></a><span class="s">            prefix: APIKEY</span>
-</span><span id="__span-9-19"><a id="__codelineno-9-19" name="__codelineno-9-19" href="#__codelineno-9-19"></a><span class="s">    authorization:</span>
-</span><span id="__span-9-20"><a id="__codelineno-9-20" name="__codelineno-9-20" href="#__codelineno-9-20"></a><span class="s">      &quot;only-admins&quot;:</span>
-</span><span id="__span-9-21"><a id="__codelineno-9-21" name="__codelineno-9-21" href="#__codelineno-9-21"></a><span class="s">        opa:</span>
-</span><span id="__span-9-22"><a id="__codelineno-9-22" name="__codelineno-9-22" href="#__codelineno-9-22"></a><span class="s">          rego: |</span>
-</span><span id="__span-9-23"><a id="__codelineno-9-23" name="__codelineno-9-23" href="#__codelineno-9-23"></a><span class="s">            groups := split(object.get(input.auth.identity.metadata.annotations, &quot;kuadrant.io/groups&quot;, &quot;&quot;), &quot;,&quot;)</span>
-</span><span id="__span-9-24"><a id="__codelineno-9-24" name="__codelineno-9-24" href="#__codelineno-9-24"></a><span class="s">            allow { groups[_] == &quot;admins&quot; }</span>
-</span><span id="__span-9-25"><a id="__codelineno-9-25" name="__codelineno-9-25" href="#__codelineno-9-25"></a><span class="s">        routeSelectors:</span>
-</span><span id="__span-9-26"><a id="__codelineno-9-26" name="__codelineno-9-26" href="#__codelineno-9-26"></a>
-</span><span id="__span-9-27"><a id="__codelineno-9-27" name="__codelineno-9-27" href="#__codelineno-9-27"></a><span class="s">        - matches:</span>
-</span><span id="__span-9-28"><a id="__codelineno-9-28" name="__codelineno-9-28" href="#__codelineno-9-28"></a><span class="s">          - path:</span>
-</span><span id="__span-9-29"><a id="__codelineno-9-29" name="__codelineno-9-29" href="#__codelineno-9-29"></a><span class="s">              type: PathPrefix</span>
-</span><span id="__span-9-30"><a id="__codelineno-9-30" name="__codelineno-9-30" href="#__codelineno-9-30"></a><span class="s">              value: &quot;/admin&quot;</span>
-</span><span id="__span-9-31"><a id="__codelineno-9-31" name="__codelineno-9-31" href="#__codelineno-9-31"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Create the API keys:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">metadata:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">  name: api-key-regular-user</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">  labels:</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="s">stringData:</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">  api_key: iamaregularuser</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">type: Opaque</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">---</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">kind: Secret</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">metadata:</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="s">  name: api-key-admin-user</span>
-</span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="s">  labels:</span>
-</span><span id="__span-10-17"><a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-10-18"><a id="__codelineno-10-18" name="__codelineno-10-18" href="#__codelineno-10-18"></a><span class="s">  annotations:</span>
-</span><span id="__span-10-19"><a id="__codelineno-10-19" name="__codelineno-10-19" href="#__codelineno-10-19"></a><span class="s">    kuadrant.io/groups: admins</span>
-</span><span id="__span-10-20"><a id="__codelineno-10-20" name="__codelineno-10-20" href="#__codelineno-10-20"></a><span class="s">stringData:</span>
-</span><span id="__span-10-21"><a id="__codelineno-10-21" name="__codelineno-10-21" href="#__codelineno-10-21"></a><span class="s">  api_key: iamanadmin</span>
-</span><span id="__span-10-22"><a id="__codelineno-10-22" name="__codelineno-10-22" href="#__codelineno-10-22"></a><span class="s">type: Opaque</span>
-</span><span id="__span-10-23"><a id="__codelineno-10-23" name="__codelineno-10-23" href="#__codelineno-10-23"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Send requests to the application protected by Kuadrant:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/cars<span class="w"> </span>-i
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY iamaregularuser&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/cars<span class="w"> </span>-i
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY iamaregularuser&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/admin<span class="w"> </span>-i
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY iamanadmin&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/admin<span class="w"> </span>-i
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<h3 id="4-create-a-default-deny-all-policy-at-the-level-of-the-gateway-persona-platform-engineer">④ Create a default "deny-all" policy at the level of the gateway (Persona: <em>Platform engineer</em>)<a class="headerlink" href="#4-create-a-default-deny-all-policy-at-the-level-of-the-gateway-persona-platform-engineer" title="Permanent link">&para;</a></h3>
-<p>Create the policy:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="s">kind: AuthPolicy</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="s">metadata:</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="s">  name: gw-auth</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="s">spec:</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="s">    name: istio-ingressgateway</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="s">  rules:</span>
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="s">    authorization:</span>
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="s">      deny-all:</span>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a><span class="s">        opa:</span>
-</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="s">          rego: &quot;allow = false&quot;</span>
-</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="s">    response:</span>
-</span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a><span class="s">      unauthorized:</span>
-</span><span id="__span-15-18"><a id="__codelineno-15-18" name="__codelineno-15-18" href="#__codelineno-15-18"></a><span class="s">        headers:</span>
-</span><span id="__span-15-19"><a id="__codelineno-15-19" name="__codelineno-15-19" href="#__codelineno-15-19"></a><span class="s">          &quot;content-type&quot;:</span>
-</span><span id="__span-15-20"><a id="__codelineno-15-20" name="__codelineno-15-20" href="#__codelineno-15-20"></a><span class="s">            value: application/json</span>
-</span><span id="__span-15-21"><a id="__codelineno-15-21" name="__codelineno-15-21" href="#__codelineno-15-21"></a><span class="s">        body:</span>
-</span><span id="__span-15-22"><a id="__codelineno-15-22" name="__codelineno-15-22" href="#__codelineno-15-22"></a><span class="s">          value: |</span>
-</span><span id="__span-15-23"><a id="__codelineno-15-23" name="__codelineno-15-23" href="#__codelineno-15-23"></a><span class="s">            {</span>
-</span><span id="__span-15-24"><a id="__codelineno-15-24" name="__codelineno-15-24" href="#__codelineno-15-24"></a><span class="s">              &quot;error&quot;: &quot;Forbidden&quot;,</span>
-</span><span id="__span-15-25"><a id="__codelineno-15-25" name="__codelineno-15-25" href="#__codelineno-15-25"></a><span class="s">              &quot;message&quot;: &quot;Access denied by default by the gateway operator. If you are the administrator of the service, create a specific auth policy for the route.&quot;</span>
-</span><span id="__span-15-26"><a id="__codelineno-15-26" name="__codelineno-15-26" href="#__codelineno-15-26"></a><span class="s">            }</span>
-</span><span id="__span-15-27"><a id="__codelineno-15-27" name="__codelineno-15-27" href="#__codelineno-15-27"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>The policy won't be effective until there is at least one accepted route not yet protected by another more specific policy attached to it.</p>
-<p>Create a route that will inherit the default policy attached to the gateway:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="s">metadata:</span>
-</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a><span class="s">  name: other</span>
-</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a><span class="s">spec:</span>
-</span><span id="__span-16-7"><a id="__codelineno-16-7" name="__codelineno-16-7" href="#__codelineno-16-7"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-16-8"><a id="__codelineno-16-8" name="__codelineno-16-8" href="#__codelineno-16-8"></a>
-</span><span id="__span-16-9"><a id="__codelineno-16-9" name="__codelineno-16-9" href="#__codelineno-16-9"></a><span class="s">  - name: istio-ingressgateway</span>
-</span><span id="__span-16-10"><a id="__codelineno-16-10" name="__codelineno-16-10" href="#__codelineno-16-10"></a><span class="s">    namespace: istio-system</span>
-</span><span id="__span-16-11"><a id="__codelineno-16-11" name="__codelineno-16-11" href="#__codelineno-16-11"></a><span class="s">  hostnames:</span>
-</span><span id="__span-16-12"><a id="__codelineno-16-12" name="__codelineno-16-12" href="#__codelineno-16-12"></a><span class="s">  - &quot;*.other-apps.com&quot;</span>
-</span><span id="__span-16-13"><a id="__codelineno-16-13" name="__codelineno-16-13" href="#__codelineno-16-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Send requests to the route protected by the default policy set at the level of the gateway:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: foo.other-apps.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/<span class="w"> </span>-i
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/index.html b/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/index.html
deleted file mode 100644
index acc1dc7ca..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/index.html
+++ /dev/null
@@ -1,3749 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/">
-      
-      
-        <link rel="prev" href="../gateway-rl-for-cluster-operators/">
-      
-      
-        <link rel="next" href="../authenticated-rl-with-jwt-and-k8s-authnz/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Authenticated Rate Limiting for Application Developers - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#authenticated-rate-limiting-for-application-developers" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Authenticated Rate Limiting for Application Developers
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-steps-1-4" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the steps ① → ④
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the steps ① → ④">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-deploy-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Deploy the Toy Store API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-enforce-authentication-on-requests-to-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Enforce authentication on requests to the Toy Store API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-enforce-authenticated-rate-limiting-on-requests-to-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ④ Enforce authenticated rate limiting on requests to the Toy Store API
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-steps-1-4" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the steps ① → ④
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the steps ① → ④">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-deploy-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Deploy the Toy Store API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-enforce-authentication-on-requests-to-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Enforce authentication on requests to the Toy Store API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-enforce-authenticated-rate-limiting-on-requests-to-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ④ Enforce authenticated rate limiting on requests to the Toy Store API
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/authenticated-rl-for-app-developers.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="authenticated-rate-limiting-for-application-developers">Authenticated Rate Limiting for Application Developers<a class="headerlink" href="#authenticated-rate-limiting-for-application-developers" title="Permanent link">&para;</a></h1>
-<p>This user guide walks you through an example of how to configure authenticated rate limiting for an application using Kuadrant.</p>
-<p>Authenticated rate limiting rate limits the traffic directed to an application based on attributes of the client user, who is authenticated by some authentication method. A few examples of authenticated rate limiting use cases are:</p>
-<ul>
-<li>User A can send up to 50rps ("requests per second"), while User B can send up to 100rps.</li>
-<li>Each user can send up to 20rpm ("request per minute").</li>
-<li>Admin users (members of the 'admin' group) can send up to 100rps, while regular users (non-admins) can send up to 20rpm and no more than 5rps.</li>
-</ul>
-<p>In this guide, we will rate limit a sample REST API called <strong>Toy Store</strong>. In reality, this API is just an echo service that echoes back to the user whatever attributes it gets in the request. The API exposes an endpoint at <code>GET http://api.toystore.com/toy</code>, to mimic an operation of reading toy records.</p>
-<p>We will define 2 users of the API, which can send requests to the API at different rates, based on their user IDs. The authentication method used is <strong>API key</strong>.</p>
-<table>
-<thead>
-<tr>
-<th>User ID</th>
-<th>Rate limit</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>alice</td>
-<td>5rp10s ("5 requests every 10 seconds")</td>
-</tr>
-<tr>
-<td>bob</td>
-<td>2rp10s ("2 requests every 10 seconds")</td>
-</tr>
-</tbody>
-</table>
-<h2 id="run-the-steps-1-4">Run the steps ① → ④<a class="headerlink" href="#run-the-steps-1-4" title="Permanent link">&para;</a></h2>
-<h3 id="1-setup">① Setup<a class="headerlink" href="#1-setup" title="Permanent link">&para;</a></h3>
-<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using <a href="https://kind.sigs.k8s.io">Kind</a>,
-where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p>
-<blockquote>
-<p><strong>Note:</strong> In production environment, these steps are usually performed by a cluster operator with administrator privileges over the Kubernetes cluster.</p>
-</blockquote>
-<p>Clone the project:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/kuadrant-operator<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>kuadrant-operator
-</span></code></pre></div>
-<p>Setup the environment:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>Request an instance of Kuadrant:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec: {}</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="2-deploy-the-toy-store-api">② Deploy the Toy Store API<a class="headerlink" href="#2-deploy-the-toy-store-api" title="Permanent link">&para;</a></h3>
-<p>Create the deployment:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/toystore/toystore.yaml
-</span></code></pre></div>
-<p>Create a HTTPRoute to route traffic to the service via Istio Ingress Gateway:</p>
-<p><img alt="" src="https://i.imgur.com/rdN8lo3.png" /></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">spec:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">  - name: istio-ingressgateway</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">    namespace: istio-system</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">  hostnames:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">  - api.toystore.com</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">  rules:</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="s">  - matches:</span>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="s">    - path:</span>
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a><span class="s">        type: Exact</span>
-</span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a><span class="s">        value: &quot;/toy&quot;</span>
-</span><span id="__span-4-18"><a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a><span class="s">      method: GET</span>
-</span><span id="__span-4-19"><a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a><span class="s">    backendRefs:</span>
-</span><span id="__span-4-20"><a id="__codelineno-4-20" name="__codelineno-4-20" href="#__codelineno-4-20"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-4-21"><a id="__codelineno-4-21" name="__codelineno-4-21" href="#__codelineno-4-21"></a><span class="s">      port: 80</span>
-</span><span id="__span-4-22"><a id="__codelineno-4-22" name="__codelineno-4-22" href="#__codelineno-4-22"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Export the gateway hostname and port:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_HOST</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>istio-ingressgateway<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.addresses[0].value}&#39;</span><span class="k">)</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_PORT</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>istio-ingressgateway<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.listeners[?(@.name==&quot;http&quot;)].port}&#39;</span><span class="k">)</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">GATEWAY_URL</span><span class="o">=</span><span class="nv">$INGRESS_HOST</span>:<span class="nv">$INGRESS_PORT</span>
-</span></code></pre></div>
-<p>Verify the route works:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note</strong>: If the command above fails to hit the Toy Store API on your environment, try forwarding requests to the service and accessing over localhost:</p>
-<p><div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>service/istio-ingressgateway-istio<span class="w"> </span><span class="m">9080</span>:80<span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span><span class="p">&amp;</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">GATEWAY_URL</span><span class="o">=</span>localhost:9080
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div></p>
-</blockquote>
-<h3 id="3-enforce-authentication-on-requests-to-the-toy-store-api">③ Enforce authentication on requests to the Toy Store API<a class="headerlink" href="#3-enforce-authentication-on-requests-to-the-toy-store-api" title="Permanent link">&para;</a></h3>
-<p>Create a Kuadrant <code>AuthPolicy</code> to configure the authentication:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: AuthPolicy</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">spec:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">    kind: HTTPRoute</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">    name: toystore</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">  rules:</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">    authentication:</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="s">      &quot;api-key-users&quot;:</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="s">        apiKey:</span>
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a><span class="s">          selector:</span>
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a><span class="s">            matchLabels:</span>
-</span><span id="__span-9-17"><a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a><span class="s">              app: toystore</span>
-</span><span id="__span-9-18"><a id="__codelineno-9-18" name="__codelineno-9-18" href="#__codelineno-9-18"></a><span class="s">          allNamespaces: true</span>
-</span><span id="__span-9-19"><a id="__codelineno-9-19" name="__codelineno-9-19" href="#__codelineno-9-19"></a><span class="s">        credentials:</span>
-</span><span id="__span-9-20"><a id="__codelineno-9-20" name="__codelineno-9-20" href="#__codelineno-9-20"></a><span class="s">          authorizationHeader:</span>
-</span><span id="__span-9-21"><a id="__codelineno-9-21" name="__codelineno-9-21" href="#__codelineno-9-21"></a><span class="s">            prefix: APIKEY</span>
-</span><span id="__span-9-22"><a id="__codelineno-9-22" name="__codelineno-9-22" href="#__codelineno-9-22"></a><span class="s">    response:</span>
-</span><span id="__span-9-23"><a id="__codelineno-9-23" name="__codelineno-9-23" href="#__codelineno-9-23"></a><span class="s">      success:</span>
-</span><span id="__span-9-24"><a id="__codelineno-9-24" name="__codelineno-9-24" href="#__codelineno-9-24"></a><span class="s">        dynamicMetadata:</span>
-</span><span id="__span-9-25"><a id="__codelineno-9-25" name="__codelineno-9-25" href="#__codelineno-9-25"></a><span class="s">          &quot;identity&quot;:</span>
-</span><span id="__span-9-26"><a id="__codelineno-9-26" name="__codelineno-9-26" href="#__codelineno-9-26"></a><span class="s">            json:</span>
-</span><span id="__span-9-27"><a id="__codelineno-9-27" name="__codelineno-9-27" href="#__codelineno-9-27"></a><span class="s">              properties:</span>
-</span><span id="__span-9-28"><a id="__codelineno-9-28" name="__codelineno-9-28" href="#__codelineno-9-28"></a><span class="s">                &quot;userid&quot;:</span>
-</span><span id="__span-9-29"><a id="__codelineno-9-29" name="__codelineno-9-29" href="#__codelineno-9-29"></a><span class="s">                  selector: auth.identity.metadata.annotations.secret\.kuadrant\.io/user-id</span>
-</span><span id="__span-9-30"><a id="__codelineno-9-30" name="__codelineno-9-30" href="#__codelineno-9-30"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Verify the authentication works by sending a request to the Toy Store API without API key:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="c1"># www-authenticate: APIKEY realm=&quot;api-key-users&quot;</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="c1"># x-ext-auth-reason: &quot;credential not found&quot;</span>
-</span></code></pre></div>
-<p>Create API keys for users <code>alice</code> and <code>bob</code> to authenticate:</p>
-<blockquote>
-<p><strong>Note:</strong> Kuadrant stores API keys as Kubernetes Secret resources. User metadata can be stored in the annotations of the resource.</p>
-</blockquote>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="s">metadata:</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="s">  name: bob-key</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="s">  labels:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="s">    app: toystore</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="s">  annotations:</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="s">    secret.kuadrant.io/user-id: bob</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="s">stringData:</span>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="s">  api_key: IAMBOB</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="s">type: Opaque</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="s">---</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="s">kind: Secret</span>
-</span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="s">metadata:</span>
-</span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="s">  name: alice-key</span>
-</span><span id="__span-11-19"><a id="__codelineno-11-19" name="__codelineno-11-19" href="#__codelineno-11-19"></a><span class="s">  labels:</span>
-</span><span id="__span-11-20"><a id="__codelineno-11-20" name="__codelineno-11-20" href="#__codelineno-11-20"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-11-21"><a id="__codelineno-11-21" name="__codelineno-11-21" href="#__codelineno-11-21"></a><span class="s">    app: toystore</span>
-</span><span id="__span-11-22"><a id="__codelineno-11-22" name="__codelineno-11-22" href="#__codelineno-11-22"></a><span class="s">  annotations:</span>
-</span><span id="__span-11-23"><a id="__codelineno-11-23" name="__codelineno-11-23" href="#__codelineno-11-23"></a><span class="s">    secret.kuadrant.io/user-id: alice</span>
-</span><span id="__span-11-24"><a id="__codelineno-11-24" name="__codelineno-11-24" href="#__codelineno-11-24"></a><span class="s">stringData:</span>
-</span><span id="__span-11-25"><a id="__codelineno-11-25" name="__codelineno-11-25" href="#__codelineno-11-25"></a><span class="s">  api_key: IAMALICE</span>
-</span><span id="__span-11-26"><a id="__codelineno-11-26" name="__codelineno-11-26" href="#__codelineno-11-26"></a><span class="s">type: Opaque</span>
-</span><span id="__span-11-27"><a id="__codelineno-11-27" name="__codelineno-11-27" href="#__codelineno-11-27"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="4-enforce-authenticated-rate-limiting-on-requests-to-the-toy-store-api">④ Enforce authenticated rate limiting on requests to the Toy Store API<a class="headerlink" href="#4-enforce-authenticated-rate-limiting-on-requests-to-the-toy-store-api" title="Permanent link">&para;</a></h3>
-<p>Create a Kuadrant <code>RateLimitPolicy</code> to configure rate limiting:</p>
-<p><img alt="" src="https://i.imgur.com/2A9sXXs.png" /></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: RateLimitPolicy</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">spec:</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">    kind: HTTPRoute</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">    name: toystore</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="s">  limits:</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">    &quot;alice-limit&quot;:</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">      rates:</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="s">      - limit: 5</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="s">        duration: 10</span>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="s">        unit: second</span>
-</span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="s">      when:</span>
-</span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a><span class="s">      - selector: metadata.filter_metadata.envoy\.filters\.http\.ext_authz.identity.userid</span>
-</span><span id="__span-12-20"><a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a><span class="s">        operator: eq</span>
-</span><span id="__span-12-21"><a id="__codelineno-12-21" name="__codelineno-12-21" href="#__codelineno-12-21"></a><span class="s">        value: alice</span>
-</span><span id="__span-12-22"><a id="__codelineno-12-22" name="__codelineno-12-22" href="#__codelineno-12-22"></a><span class="s">    &quot;bob-limit&quot;:</span>
-</span><span id="__span-12-23"><a id="__codelineno-12-23" name="__codelineno-12-23" href="#__codelineno-12-23"></a><span class="s">      rates:</span>
-</span><span id="__span-12-24"><a id="__codelineno-12-24" name="__codelineno-12-24" href="#__codelineno-12-24"></a><span class="s">      - limit: 2</span>
-</span><span id="__span-12-25"><a id="__codelineno-12-25" name="__codelineno-12-25" href="#__codelineno-12-25"></a><span class="s">        duration: 10</span>
-</span><span id="__span-12-26"><a id="__codelineno-12-26" name="__codelineno-12-26" href="#__codelineno-12-26"></a><span class="s">        unit: second</span>
-</span><span id="__span-12-27"><a id="__codelineno-12-27" name="__codelineno-12-27" href="#__codelineno-12-27"></a><span class="s">      when:</span>
-</span><span id="__span-12-28"><a id="__codelineno-12-28" name="__codelineno-12-28" href="#__codelineno-12-28"></a><span class="s">      - selector: metadata.filter_metadata.envoy\.filters\.http\.ext_authz.identity.userid</span>
-</span><span id="__span-12-29"><a id="__codelineno-12-29" name="__codelineno-12-29" href="#__codelineno-12-29"></a><span class="s">        operator: eq</span>
-</span><span id="__span-12-30"><a id="__codelineno-12-30" name="__codelineno-12-30" href="#__codelineno-12-30"></a><span class="s">        value: bob</span>
-</span><span id="__span-12-31"><a id="__codelineno-12-31" name="__codelineno-12-31" href="#__codelineno-12-31"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p>
-</blockquote>
-<p>Verify the rate limiting works by sending requests as Alice and Bob.</p>
-<p>Up to 5 successful (<code>200 OK</code>) requests every 10 seconds allowed for Alice, then <code>429 Too Many Requests</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMALICE&#39;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<p>Up to 2 successful (<code>200 OK</code>) requests every 10 seconds allowed for Bob, then <code>429 Too Many Requests</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMBOB&#39;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/index.html b/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/index.html
deleted file mode 100644
index a8cee3450..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/index.html
+++ /dev/null
@@ -1,4054 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/">
-      
-      
-        <link rel="prev" href="../authenticated-rl-for-app-developers/">
-      
-      
-        <link rel="next" href="../../observability/metrics/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Authenticated Rate Limiting with JWTs and Kubernetes RBAC - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#authenticated-rate-limiting-with-jwts-and-kubernetes-rbac" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-guide-1-6" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the guide ① → ⑥
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the guide ① → ⑥">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup-a-cluster-with-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup a cluster with Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-deploy-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Deploy the Toy Store API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="② Deploy the Toy Store API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-lifecycle" class="md-nav__link">
-    <span class="md-ellipsis">
-      API lifecycle
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-unprotected" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API unprotected
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-deploy-keycloak" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Deploy Keycloak
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-enforce-authentication-and-authorization-for-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ④ Enforce authentication and authorization for the Toy Store API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="④ Enforce authentication and authorization for the Toy Store API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-missing-authentication" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API missing authentication
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-without-permission" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API without permission
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#5-grant-access-to-the-toy-store-api-for-user-and-service-account" class="md-nav__link">
-    <span class="md-ellipsis">
-      ⑤ Grant access to the Toy Store API for user and service account
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="⑤ Grant access to the Toy Store API for user and service account">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-with-permission" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API with permission
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#6-enforce-rate-limiting-on-requests-to-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ⑥ Enforce rate limiting on requests to the Toy Store API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="⑥ Enforce rate limiting on requests to the Toy Store API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-rate-limited" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API rate limited
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-guide-1-6" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the guide ① → ⑥
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the guide ① → ⑥">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup-a-cluster-with-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup a cluster with Kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-deploy-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Deploy the Toy Store API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="② Deploy the Toy Store API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-lifecycle" class="md-nav__link">
-    <span class="md-ellipsis">
-      API lifecycle
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-unprotected" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API unprotected
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-deploy-keycloak" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Deploy Keycloak
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-enforce-authentication-and-authorization-for-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ④ Enforce authentication and authorization for the Toy Store API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="④ Enforce authentication and authorization for the Toy Store API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-missing-authentication" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API missing authentication
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-without-permission" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API without permission
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#5-grant-access-to-the-toy-store-api-for-user-and-service-account" class="md-nav__link">
-    <span class="md-ellipsis">
-      ⑤ Grant access to the Toy Store API for user and service account
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="⑤ Grant access to the Toy Store API for user and service account">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-with-permission" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API with permission
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#6-enforce-rate-limiting-on-requests-to-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ⑥ Enforce rate limiting on requests to the Toy Store API
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="⑥ Enforce rate limiting on requests to the Toy Store API">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#try-the-api-rate-limited" class="md-nav__link">
-    <span class="md-ellipsis">
-      Try the API rate limited
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="authenticated-rate-limiting-with-jwts-and-kubernetes-rbac">Authenticated Rate Limiting with JWTs and Kubernetes RBAC<a class="headerlink" href="#authenticated-rate-limiting-with-jwts-and-kubernetes-rbac" title="Permanent link">&para;</a></h1>
-<p>This user guide walks you through an example of how to use Kuadrant to protect an application with policies to enforce:</p>
-<ul>
-<li>authentication based OpenId Connect (OIDC) ID tokens (signed JWTs), issued by a Keycloak server;</li>
-<li>alternative authentication method by Kubernetes Service Account tokens;</li>
-<li>authorization delegated to Kubernetes RBAC system;</li>
-<li>rate limiting by user ID.</li>
-</ul>
-<p>In this example, we will protect a sample REST API called <strong>Toy Store</strong>. In reality, this API is just an echo service that echoes back to the user whatever attributes it gets in the request.</p>
-<p>The API listens to requests at the hostnames <code>*.toystore.com</code>, where it exposes the endpoints <code>GET /toy*</code>, <code>POST /admin/toy</code> and <code>DELETE /amind/toy</code>, respectively, to mimic operations of reading, creating, and deleting toy records.</p>
-<p>Any authenticated user/service account can send requests to the Toy Store API, by providing either a valid Keycloak-issued access token or Kubernetes token.</p>
-<p>Privileges to execute the requested operation (read, create or delete) will be granted according to the following RBAC rules, stored in the Kubernetes authorization system:</p>
-<table>
-<thead>
-<tr>
-<th>Operation</th>
-<th>Endpoint</th>
-<th>Required role</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>Read</td>
-<td><code>GET /toy*</code></td>
-<td><code>toystore-reader</code></td>
-</tr>
-<tr>
-<td>Create</td>
-<td><code>POST /admin/toy</code></td>
-<td><code>toystore-write</code></td>
-</tr>
-<tr>
-<td>Delete</td>
-<td><code>DELETE /admin/toy</code></td>
-<td><code>toystore-write</code></td>
-</tr>
-</tbody>
-</table>
-<p>Each user will be entitled to a maximum of 5rp10s (5 requests every 10 seconds).</p>
-<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="https://www.docker.com/">Docker</a></li>
-<li><a href="https://kubernetes.io/docs/reference/kubectl/">kubectl</a> command-line tool</li>
-<li><a href="https://stedolan.github.io/jq/">jq</a></li>
-</ul>
-<h2 id="run-the-guide-1-6">Run the guide ① → ⑥<a class="headerlink" href="#run-the-guide-1-6" title="Permanent link">&para;</a></h2>
-<h3 id="1-setup-a-cluster-with-kuadrant">① Setup a cluster with Kuadrant<a class="headerlink" href="#1-setup-a-cluster-with-kuadrant" title="Permanent link">&para;</a></h3>
-<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using <a href="https://kind.sigs.k8s.io">Kind</a>,
-where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p>
-<blockquote>
-<p><strong>Note:</strong> In production environment, these steps are usually performed by a cluster operator with administrator privileges over the Kubernetes cluster.</p>
-</blockquote>
-<p>Clone the project:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/kuadrant-operator<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>kuadrant-operator
-</span></code></pre></div>
-<p>Setup the environment:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>Request an instance of Kuadrant:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec: {}</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="2-deploy-the-toy-store-api">② Deploy the Toy Store API<a class="headerlink" href="#2-deploy-the-toy-store-api" title="Permanent link">&para;</a></h3>
-<p>Deploy the application in the <code>default</code> namespace:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/toystore/toystore.yaml
-</span></code></pre></div>
-<p>Route traffic to the application:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/toystore/httproute.yaml
-</span></code></pre></div>
-<h4 id="api-lifecycle">API lifecycle<a class="headerlink" href="#api-lifecycle" title="Permanent link">&para;</a></h4>
-<p><img alt="Lifecycle" src="http://www.plantuml.com/plantuml/png/hP7DIWD1383l-nHXJ_PGtFuSIsaH1F5WGRtjPJgJjg6pcPB9WFNf7LrXV_Ickp0Gyf5yIJPHZMXgV17Fn1SZfW671vEylk2RRZqTkK5MiFb1wL4I4hkx88m2iwee1AqQFdg4ShLVprQt-tNDszq3K8J45mcQ0NGrj_yqVpNFgmgU7aim0sPKQzxMUaQRXFGAqPwmGJW40JqXv1urHpMA3eZ1C9JbDkbf5ppPQrdMV9CY2XmC-GWQmEGaif8rYfFEPLdDu9K_aq7e7TstLPyUcot-RERnI0fVVjxOSuGBIaCnKk21sWBkW-p9EUJMgnCTIot_Prs3kJFceEiu-VM2uLmKlIl2TFrZVQCu8yD9kg1Dvf8RP9SQ_m40" /></p>
-<h4 id="try-the-api-unprotected">Try the API unprotected<a class="headerlink" href="#try-the-api-unprotected" title="Permanent link">&para;</a></h4>
-<p>Export the gateway hostname and port:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_HOST</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>istio-ingressgateway<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.addresses[0].value}&#39;</span><span class="k">)</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_PORT</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>istio-ingressgateway<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.listeners[?(@.name==&quot;http&quot;)].port}&#39;</span><span class="k">)</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">GATEWAY_URL</span><span class="o">=</span><span class="nv">$INGRESS_HOST</span>:<span class="nv">$INGRESS_PORT</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>It should return <code>200 OK</code>.</p>
-<blockquote>
-<p><strong>Note</strong>: If the command above fails to hit the Toy Store API on your environment, try forwarding requests to the service and accessing over localhost:</p>
-<p><div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>service/istio-ingressgateway-istio<span class="w"> </span><span class="m">9080</span>:80<span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span><span class="p">&amp;</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">GATEWAY_URL</span><span class="o">=</span>localhost:9080
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div></p>
-</blockquote>
-<h3 id="3-deploy-keycloak">③ Deploy Keycloak<a class="headerlink" href="#3-deploy-keycloak" title="Permanent link">&para;</a></h3>
-<p>Create the namesapce:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>keycloak
-</span></code></pre></div>
-<p>Deploy Keycloak with a <a href="https://github.com/kuadrant/authorino-examples#keycloak">bootstrap</a> realm, users, and clients:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>keycloak<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> The Keycloak server may take a couple of minutes to be ready.</p>
-</blockquote>
-<h3 id="4-enforce-authentication-and-authorization-for-the-toy-store-api">④ Enforce authentication and authorization for the Toy Store API<a class="headerlink" href="#4-enforce-authentication-and-authorization-for-the-toy-store-api" title="Permanent link">&para;</a></h3>
-<p>Create a Kuadrant <code>AuthPolicy</code> to configure authentication and authorization:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="s">kind: AuthPolicy</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="s">metadata:</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="s">  name: toystore-protection</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="s">spec:</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="s">    kind: HTTPRoute</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="s">    name: toystore</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="s">  rules:</span>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="s">    authentication:</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="s">      &quot;keycloak-users&quot;:</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="s">        jwt:</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="s">          issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="s">      &quot;k8s-service-accounts&quot;:</span>
-</span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="s">        kubernetesTokenReview:</span>
-</span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="s">          audiences:</span>
-</span><span id="__span-11-19"><a id="__codelineno-11-19" name="__codelineno-11-19" href="#__codelineno-11-19"></a>
-</span><span id="__span-11-20"><a id="__codelineno-11-20" name="__codelineno-11-20" href="#__codelineno-11-20"></a><span class="s">          - https://kubernetes.default.svc.cluster.local</span>
-</span><span id="__span-11-21"><a id="__codelineno-11-21" name="__codelineno-11-21" href="#__codelineno-11-21"></a><span class="s">        overrides:</span>
-</span><span id="__span-11-22"><a id="__codelineno-11-22" name="__codelineno-11-22" href="#__codelineno-11-22"></a><span class="s">          &quot;sub&quot;:</span>
-</span><span id="__span-11-23"><a id="__codelineno-11-23" name="__codelineno-11-23" href="#__codelineno-11-23"></a><span class="s">            selector: auth.identity.user.username</span>
-</span><span id="__span-11-24"><a id="__codelineno-11-24" name="__codelineno-11-24" href="#__codelineno-11-24"></a><span class="s">    authorization:</span>
-</span><span id="__span-11-25"><a id="__codelineno-11-25" name="__codelineno-11-25" href="#__codelineno-11-25"></a><span class="s">      &quot;k8s-rbac&quot;:</span>
-</span><span id="__span-11-26"><a id="__codelineno-11-26" name="__codelineno-11-26" href="#__codelineno-11-26"></a><span class="s">        kubernetesSubjectAccessReview:</span>
-</span><span id="__span-11-27"><a id="__codelineno-11-27" name="__codelineno-11-27" href="#__codelineno-11-27"></a><span class="s">          user:</span>
-</span><span id="__span-11-28"><a id="__codelineno-11-28" name="__codelineno-11-28" href="#__codelineno-11-28"></a><span class="s">            selector: auth.identity.sub</span>
-</span><span id="__span-11-29"><a id="__codelineno-11-29" name="__codelineno-11-29" href="#__codelineno-11-29"></a><span class="s">    response:</span>
-</span><span id="__span-11-30"><a id="__codelineno-11-30" name="__codelineno-11-30" href="#__codelineno-11-30"></a><span class="s">      success:</span>
-</span><span id="__span-11-31"><a id="__codelineno-11-31" name="__codelineno-11-31" href="#__codelineno-11-31"></a><span class="s">        dynamicMetadata:</span>
-</span><span id="__span-11-32"><a id="__codelineno-11-32" name="__codelineno-11-32" href="#__codelineno-11-32"></a><span class="s">          &quot;identity&quot;:</span>
-</span><span id="__span-11-33"><a id="__codelineno-11-33" name="__codelineno-11-33" href="#__codelineno-11-33"></a><span class="s">            json:</span>
-</span><span id="__span-11-34"><a id="__codelineno-11-34" name="__codelineno-11-34" href="#__codelineno-11-34"></a><span class="s">              properties:</span>
-</span><span id="__span-11-35"><a id="__codelineno-11-35" name="__codelineno-11-35" href="#__codelineno-11-35"></a><span class="s">                &quot;userid&quot;:</span>
-</span><span id="__span-11-36"><a id="__codelineno-11-36" name="__codelineno-11-36" href="#__codelineno-11-36"></a><span class="s">                  selector: auth.identity.sub</span>
-</span><span id="__span-11-37"><a id="__codelineno-11-37" name="__codelineno-11-37" href="#__codelineno-11-37"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h4 id="try-the-api-missing-authentication">Try the API missing authentication<a class="headerlink" href="#try-the-api-missing-authentication" title="Permanent link">&para;</a></h4>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="c1"># HTTP/1.1 401 Unauthorized</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="c1"># www-authenticate: Bearer realm=&quot;keycloak-users&quot;</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="c1"># www-authenticate: Bearer realm=&quot;k8s-service-accounts&quot;</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="c1"># x-ext-auth-reason: {&quot;k8s-service-accounts&quot;:&quot;credential not found&quot;,&quot;keycloak-users&quot;:&quot;credential not found&quot;}</span>
-</span></code></pre></div>
-<h4 id="try-the-api-without-permission">Try the API without permission<a class="headerlink" href="#try-the-api-without-permission" title="Permanent link">&para;</a></h4>
-<p>Obtain an access token with the Keycloak server:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>run<span class="w"> </span>token<span class="w"> </span>--attach<span class="w"> </span>--rm<span class="w"> </span>--restart<span class="o">=</span>Never<span class="w"> </span>-q<span class="w"> </span>--image<span class="o">=</span>curlimages/curl<span class="w"> </span>--<span class="w"> </span>http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token<span class="w"> </span>-s<span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;client_id=demo&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;username=john&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span>.access_token<span class="k">)</span>
-</span></code></pre></div>
-<p>Send a request to the API as the Keycloak-authenticated user while still missing permissions:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<p>Create a Kubernetes Service Account to represent a consumer of the API associated with the alternative source of identities <code>k8s-service-accounts</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="s">kind: ServiceAccount</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="s">metadata:</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="s">  name: client-app-1</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Obtain an access token for the <code>client-app-1</code> service account:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nv">SA_TOKEN</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>create<span class="w"> </span>token<span class="w"> </span>client-app-1<span class="k">)</span>
-</span></code></pre></div>
-<p>Send a request to the API as the service account while still missing permissions:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$SA_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<h3 id="5-grant-access-to-the-toy-store-api-for-user-and-service-account">⑤ Grant access to the Toy Store API for user and service account<a class="headerlink" href="#5-grant-access-to-the-toy-store-api-for-user-and-service-account" title="Permanent link">&para;</a></h3>
-<p>Create the <code>toystore-reader</code> and <code>toystore-writer</code> roles:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="s">kind: ClusterRole</span>
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="s">metadata:</span>
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="s">  name: toystore-reader</span>
-</span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="s">rules:</span>
-</span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a>
-</span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a><span class="s">- nonResourceURLs: [&quot;/toy*&quot;]</span>
-</span><span id="__span-18-9"><a id="__codelineno-18-9" name="__codelineno-18-9" href="#__codelineno-18-9"></a><span class="s">  verbs: [&quot;get&quot;]</span>
-</span><span id="__span-18-10"><a id="__codelineno-18-10" name="__codelineno-18-10" href="#__codelineno-18-10"></a><span class="s">---</span>
-</span><span id="__span-18-11"><a id="__codelineno-18-11" name="__codelineno-18-11" href="#__codelineno-18-11"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-18-12"><a id="__codelineno-18-12" name="__codelineno-18-12" href="#__codelineno-18-12"></a><span class="s">kind: ClusterRole</span>
-</span><span id="__span-18-13"><a id="__codelineno-18-13" name="__codelineno-18-13" href="#__codelineno-18-13"></a><span class="s">metadata:</span>
-</span><span id="__span-18-14"><a id="__codelineno-18-14" name="__codelineno-18-14" href="#__codelineno-18-14"></a><span class="s">  name: toystore-writer</span>
-</span><span id="__span-18-15"><a id="__codelineno-18-15" name="__codelineno-18-15" href="#__codelineno-18-15"></a><span class="s">rules:</span>
-</span><span id="__span-18-16"><a id="__codelineno-18-16" name="__codelineno-18-16" href="#__codelineno-18-16"></a><span class="s">- nonResourceURLs: [&quot;/admin/toy&quot;]</span>
-</span><span id="__span-18-17"><a id="__codelineno-18-17" name="__codelineno-18-17" href="#__codelineno-18-17"></a><span class="s">  verbs: [&quot;post&quot;, &quot;delete&quot;]</span>
-</span><span id="__span-18-18"><a id="__codelineno-18-18" name="__codelineno-18-18" href="#__codelineno-18-18"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Add permissions to the user and service account:</p>
-<table>
-<thead>
-<tr>
-<th>User</th>
-<th>Kind</th>
-<th>Roles</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>john</td>
-<td>User registered in Keycloak</td>
-<td><code>toystore-reader</code>, <code>toystore-writer</code></td>
-</tr>
-<tr>
-<td>client-app-1</td>
-<td>Kuberentes Service Account</td>
-<td><code>toystore-reader</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a><span class="s">kind: ClusterRoleBinding</span>
-</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a><span class="s">metadata:</span>
-</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a><span class="s">  name: toystore-readers</span>
-</span><span id="__span-19-6"><a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a><span class="s">roleRef:</span>
-</span><span id="__span-19-7"><a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a><span class="s">  apiGroup: rbac.authorization.k8s.io</span>
-</span><span id="__span-19-8"><a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a><span class="s">  kind: ClusterRole</span>
-</span><span id="__span-19-9"><a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a><span class="s">  name: toystore-reader</span>
-</span><span id="__span-19-10"><a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a><span class="s">subjects:</span>
-</span><span id="__span-19-11"><a id="__codelineno-19-11" name="__codelineno-19-11" href="#__codelineno-19-11"></a>
-</span><span id="__span-19-12"><a id="__codelineno-19-12" name="__codelineno-19-12" href="#__codelineno-19-12"></a><span class="s">- kind: User</span>
-</span><span id="__span-19-13"><a id="__codelineno-19-13" name="__codelineno-19-13" href="#__codelineno-19-13"></a><span class="s">  name: $(jq -R -r &#39;split(&quot;.&quot;) | .[1] | @base64d | fromjson | .sub&#39; &lt;&lt;&lt; &quot;$ACCESS_TOKEN&quot;)</span>
-</span><span id="__span-19-14"><a id="__codelineno-19-14" name="__codelineno-19-14" href="#__codelineno-19-14"></a><span class="s">- kind: ServiceAccount</span>
-</span><span id="__span-19-15"><a id="__codelineno-19-15" name="__codelineno-19-15" href="#__codelineno-19-15"></a><span class="s">  name: client-app-1</span>
-</span><span id="__span-19-16"><a id="__codelineno-19-16" name="__codelineno-19-16" href="#__codelineno-19-16"></a><span class="s">  namespace: default</span>
-</span><span id="__span-19-17"><a id="__codelineno-19-17" name="__codelineno-19-17" href="#__codelineno-19-17"></a><span class="s">---</span>
-</span><span id="__span-19-18"><a id="__codelineno-19-18" name="__codelineno-19-18" href="#__codelineno-19-18"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-19-19"><a id="__codelineno-19-19" name="__codelineno-19-19" href="#__codelineno-19-19"></a><span class="s">kind: ClusterRoleBinding</span>
-</span><span id="__span-19-20"><a id="__codelineno-19-20" name="__codelineno-19-20" href="#__codelineno-19-20"></a><span class="s">metadata:</span>
-</span><span id="__span-19-21"><a id="__codelineno-19-21" name="__codelineno-19-21" href="#__codelineno-19-21"></a><span class="s">  name: toystore-writers</span>
-</span><span id="__span-19-22"><a id="__codelineno-19-22" name="__codelineno-19-22" href="#__codelineno-19-22"></a><span class="s">roleRef:</span>
-</span><span id="__span-19-23"><a id="__codelineno-19-23" name="__codelineno-19-23" href="#__codelineno-19-23"></a><span class="s">  apiGroup: rbac.authorization.k8s.io</span>
-</span><span id="__span-19-24"><a id="__codelineno-19-24" name="__codelineno-19-24" href="#__codelineno-19-24"></a><span class="s">  kind: ClusterRole</span>
-</span><span id="__span-19-25"><a id="__codelineno-19-25" name="__codelineno-19-25" href="#__codelineno-19-25"></a><span class="s">  name: toystore-writer</span>
-</span><span id="__span-19-26"><a id="__codelineno-19-26" name="__codelineno-19-26" href="#__codelineno-19-26"></a><span class="s">subjects:</span>
-</span><span id="__span-19-27"><a id="__codelineno-19-27" name="__codelineno-19-27" href="#__codelineno-19-27"></a><span class="s">- kind: User</span>
-</span><span id="__span-19-28"><a id="__codelineno-19-28" name="__codelineno-19-28" href="#__codelineno-19-28"></a><span class="s">  name: $(jq -R -r &#39;split(&quot;.&quot;) | .[1] | @base64d | fromjson | .sub&#39; &lt;&lt;&lt; &quot;$ACCESS_TOKEN&quot;)</span>
-</span><span id="__span-19-29"><a id="__codelineno-19-29" name="__codelineno-19-29" href="#__codelineno-19-29"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<details>
-<summary><i>Q:</i> Can I use <code>Roles</code> and <code>RoleBindings</code> instead of <code>ClusterRoles</code> and <code>ClusterRoleBindings</code>?</summary>
-<p>Yes, you can.</p>
-<p>The example above is for non-resource URL Kubernetes roles. For using <code>Roles</code> and <code>RoleBindings</code> instead of
-  <code>ClusterRoles</code> and <code>ClusterRoleBindings</code>, thus more flexible resource-based permissions to protect the API,
-  see the spec for <a href="https://docs.kuadrant.io/latest/authorino/docs/features/#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview">Kubernetes SubjectAccessReview authorization</a>
-  in the Authorino docs.</p>
-</details>
-<h4 id="try-the-api-with-permission">Try the API with permission<a class="headerlink" href="#try-the-api-with-permission" title="Permanent link">&para;</a></h4>
-<p>Send requests to the API as the Keycloak-authenticated user:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/admin/toy<span class="w"> </span>-i
-</span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<p>Send requests to the API as the Kubernetes service account:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$SA_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span>-i
-</span><span id="__span-22-2"><a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$SA_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/admin/toy<span class="w"> </span>-i
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a><span class="c1"># HTTP/1.1 403 Forbidden</span>
-</span></code></pre></div>
-<h3 id="6-enforce-rate-limiting-on-requests-to-the-toy-store-api">⑥ Enforce rate limiting on requests to the Toy Store API<a class="headerlink" href="#6-enforce-rate-limiting-on-requests-to-the-toy-store-api" title="Permanent link">&para;</a></h3>
-<p>Create a Kuadrant <code>RateLimitPolicy</code> to configure rate limiting:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-24-2"><a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-24-3"><a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a><span class="s">kind: RateLimitPolicy</span>
-</span><span id="__span-24-4"><a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a><span class="s">metadata:</span>
-</span><span id="__span-24-5"><a id="__codelineno-24-5" name="__codelineno-24-5" href="#__codelineno-24-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-24-6"><a id="__codelineno-24-6" name="__codelineno-24-6" href="#__codelineno-24-6"></a><span class="s">spec:</span>
-</span><span id="__span-24-7"><a id="__codelineno-24-7" name="__codelineno-24-7" href="#__codelineno-24-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-24-8"><a id="__codelineno-24-8" name="__codelineno-24-8" href="#__codelineno-24-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-24-9"><a id="__codelineno-24-9" name="__codelineno-24-9" href="#__codelineno-24-9"></a><span class="s">    kind: HTTPRoute</span>
-</span><span id="__span-24-10"><a id="__codelineno-24-10" name="__codelineno-24-10" href="#__codelineno-24-10"></a><span class="s">    name: toystore</span>
-</span><span id="__span-24-11"><a id="__codelineno-24-11" name="__codelineno-24-11" href="#__codelineno-24-11"></a><span class="s">  limits:</span>
-</span><span id="__span-24-12"><a id="__codelineno-24-12" name="__codelineno-24-12" href="#__codelineno-24-12"></a><span class="s">    &quot;per-user&quot;:</span>
-</span><span id="__span-24-13"><a id="__codelineno-24-13" name="__codelineno-24-13" href="#__codelineno-24-13"></a><span class="s">      rates:</span>
-</span><span id="__span-24-14"><a id="__codelineno-24-14" name="__codelineno-24-14" href="#__codelineno-24-14"></a>
-</span><span id="__span-24-15"><a id="__codelineno-24-15" name="__codelineno-24-15" href="#__codelineno-24-15"></a><span class="s">      - limit: 5</span>
-</span><span id="__span-24-16"><a id="__codelineno-24-16" name="__codelineno-24-16" href="#__codelineno-24-16"></a><span class="s">        duration: 10</span>
-</span><span id="__span-24-17"><a id="__codelineno-24-17" name="__codelineno-24-17" href="#__codelineno-24-17"></a><span class="s">        unit: second</span>
-</span><span id="__span-24-18"><a id="__codelineno-24-18" name="__codelineno-24-18" href="#__codelineno-24-18"></a><span class="s">      counters:</span>
-</span><span id="__span-24-19"><a id="__codelineno-24-19" name="__codelineno-24-19" href="#__codelineno-24-19"></a><span class="s">      - metadata.filter_metadata.envoy\.filters\.http\.ext_authz.identity.userid</span>
-</span><span id="__span-24-20"><a id="__codelineno-24-20" name="__codelineno-24-20" href="#__codelineno-24-20"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p>
-</blockquote>
-<h4 id="try-the-api-rate-limited">Try the API rate limited<a class="headerlink" href="#try-the-api-rate-limited" title="Permanent link">&para;</a></h4>
-<p>Each user should be entitled to a maximum of 5 requests every 10 seconds.</p>
-<blockquote>
-<p><strong>Note:</strong> If the tokens have expired, you may need to refresh them first.</p>
-</blockquote>
-<p>Send requests as the Keycloak-authenticated user:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-25-1"><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<p>Send requests as the Kubernetes service account:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-26-1"><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$SA_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toy<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-27-1"><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/gateway-dns/index.html b/0.10.0/kuadrant-operator/doc/user-guides/gateway-dns/index.html
deleted file mode 100644
index 3cd2dc009..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/gateway-dns/index.html
+++ /dev/null
@@ -1,3721 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/gateway-dns/">
-      
-      
-        <link rel="prev" href="../../reference/dnspolicy/">
-      
-      
-        <link rel="next" href="../../tls/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Gateway DNS for Cluster Operators - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#gateway-dns-for-cluster-operators" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Gateway DNS for Cluster Operators
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requisites
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Requisites">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-a-dns-provider-secret" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create a dns provider secret
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-an-ingress-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create an ingress gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#enable-dns-on-the-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Enable DNS on the gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deploy-a-sample-api-to-test-dns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy a sample API to test DNS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#verify-dns-works-by-sending-requests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Verify DNS works by sending requests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requisites
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Requisites">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-a-dns-provider-secret" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create a dns provider secret
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-an-ingress-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create an ingress gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#enable-dns-on-the-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Enable DNS on the gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deploy-a-sample-api-to-test-dns" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy a sample API to test DNS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#verify-dns-works-by-sending-requests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Verify DNS works by sending requests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/gateway-dns.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="gateway-dns-for-cluster-operators">Gateway DNS for Cluster Operators<a class="headerlink" href="#gateway-dns-for-cluster-operators" title="Permanent link">&para;</a></h1>
-<p>This user guide walks you through an example of how to configure DNS for all routes attached to an ingress gateway.</p>
-<p><br/></p>
-<h2 id="requisites">Requisites<a class="headerlink" href="#requisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="https://docker.io">Docker</a></li>
-<li><a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/CreatingHostedZone.html">Rout53 Hosted Zone</a></li>
-</ul>
-<h3 id="setup">Setup<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h3>
-<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using <a href="https://kind.sigs.k8s.io">Kind</a>,
-where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p>
-<p>Clone the project:</p>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/kuadrant-operator<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>kuadrant-operator
-</span></code></pre></div>
-<p>Setup the environment:</p>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>Create a namespace:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>my-gateways
-</span></code></pre></div></p>
-<p>Export a root domain and hosted zone id:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ROOT_DOMAIN</span><span class="o">=</span>&lt;ROOT_DOMAIN&gt;
-</span></code></pre></div></p>
-<blockquote>
-<p><strong>Note:</strong> ROOT_DOMAIN should be set to your AWS hosted zone <em>name</em>.</p>
-</blockquote>
-<h3 id="create-a-dns-provider-secret">Create a dns provider secret<a class="headerlink" href="#create-a-dns-provider-secret" title="Permanent link">&para;</a></h3>
-<p>Create AWS provider secret. You should limit the permissions of this credential to only the zones you want us to access. </p>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span>&lt;AWS_ACCESS_KEY_ID&gt;<span class="w"> </span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span>&lt;AWS_SECRET_ACCESS_KEY&gt;
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>aws-credentials<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">  </span>--type<span class="o">=</span>kuadrant.io/aws<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span><span class="nv">$AWS_ACCESS_KEY_ID</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span><span class="nv">$AWS_SECRET_ACCESS_KEY</span>
-</span></code></pre></div>
-<h3 id="create-an-ingress-gateway">Create an ingress gateway<a class="headerlink" href="#create-an-ingress-gateway" title="Permanent link">&para;</a></h3>
-<p>Create a gateway using your ROOT_DOMAIN as part of a listener hostname:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: Gateway</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  name: prod-web</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">spec:</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">  gatewayClassName: istio</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">  listeners:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="s">    - allowedRoutes:</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="s">        namespaces:</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="s">          from: All</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">      name: api</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="s">      hostname: &quot;*.$ROOT_DOMAIN&quot;</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="s">      port: 80</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="s">      protocol: HTTP</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-<p>Check gateway status:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>gateway<span class="w"> </span>prod-web<span class="w"> </span>-n<span class="w"> </span>my-gateways
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>NAME<span class="w">       </span>CLASS<span class="w">   </span>ADDRESS<span class="w">        </span>PROGRAMMED<span class="w">   </span>AGE
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>prod-web<span class="w">   </span>istio<span class="w">   </span><span class="m">172</span>.18.200.1<span class="w">   </span>True<span class="w">         </span>25s
-</span></code></pre></div></p>
-<h3 id="enable-dns-on-the-gateway">Enable DNS on the gateway<a class="headerlink" href="#enable-dns-on-the-gateway" title="Permanent link">&para;</a></h3>
-<p>Create a Kuadrant <code>DNSPolicy</code> to configure DNS:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: kuadrant.io/v1alpha1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: DNSPolicy</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: prod-web</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">spec:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">    name: prod-web</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">  routingStrategy: simple</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-<p>Check policy status:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>dnspolicy<span class="w"> </span>-o<span class="w"> </span>wide<span class="w"> </span>-n<span class="w"> </span>my-gateways
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>NAME<span class="w">       </span>STATUS<span class="w">     </span>TARGETREFKIND<span class="w">   </span>TARGETREFNAME<span class="w">   </span>AGE
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a>prod-web<span class="w">   </span>Accepted<span class="w">   </span>Gateway<span class="w">         </span>prod-web<span class="w">        </span>26s
-</span></code></pre></div></p>
-<h3 id="deploy-a-sample-api-to-test-dns">Deploy a sample API to test DNS<a class="headerlink" href="#deploy-a-sample-api-to-test-dns" title="Permanent link">&para;</a></h3>
-<p>Deploy the sample API:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/toystore/toystore.yaml
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span><span class="nb">wait</span><span class="w"> </span>--for<span class="o">=</span><span class="nv">condition</span><span class="o">=</span>Available<span class="w"> </span>deployments<span class="w"> </span>toystore<span class="w"> </span>--timeout<span class="o">=</span>60s
-</span></code></pre></div></p>
-<p>Route traffic to the API from our gateway:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">spec:</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">  - name: prod-web</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">    namespace: my-gateways</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="s">  hostnames:</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">  - &quot;*.$ROOT_DOMAIN&quot;</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">  rules:</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="s">  - backendRefs:</span>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="s">      port: 80</span>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-<p>Verify a DNSRecord resource is created:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>dnsrecords<span class="w"> </span>-n<span class="w"> </span>my-gateways
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>NAME<span class="w">           </span>READY
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>prod-web-api<span class="w">   </span>True
-</span></code></pre></div></p>
-<h3 id="verify-dns-works-by-sending-requests">Verify DNS works by sending requests<a class="headerlink" href="#verify-dns-works-by-sending-requests" title="Permanent link">&para;</a></h3>
-<p>Verify DNS using dig:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>dig<span class="w"> </span>foo.<span class="nv">$ROOT_DOMAIN</span><span class="w"> </span>+short
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="m">172</span>.18.200.1
-</span></code></pre></div></p>
-<p>Verify DNS using curl:</p>
-<p><div class="language-shell highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>curl<span class="w"> </span>http://api.<span class="nv">$ROOT_DOMAIN</span>
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="o">{</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="w">  </span><span class="s2">&quot;method&quot;</span>:<span class="w"> </span><span class="s2">&quot;GET&quot;</span>,
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="w">  </span><span class="s2">&quot;path&quot;</span>:<span class="w"> </span><span class="s2">&quot;/&quot;</span>,
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="w">  </span><span class="s2">&quot;query_string&quot;</span>:<span class="w"> </span>null,
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="w">  </span><span class="s2">&quot;body&quot;</span>:<span class="w"> </span><span class="s2">&quot;&quot;</span>,
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="w">  </span><span class="s2">&quot;headers&quot;</span>:<span class="w"> </span><span class="o">{</span>
-</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="w">    </span><span class="s2">&quot;HTTP_HOST&quot;</span>:<span class="w"> </span><span class="s2">&quot;api.</span><span class="nv">$ROOT_DOMAIN</span><span class="s2">&quot;</span>,
-</span><span id="__span-17-8"><a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a><span class="w">    </span><span class="s2">&quot;HTTP_USER_AGENT&quot;</span>:<span class="w"> </span><span class="s2">&quot;curl/7.85.0&quot;</span>,
-</span><span id="__span-17-9"><a id="__codelineno-17-9" name="__codelineno-17-9" href="#__codelineno-17-9"></a><span class="w">    </span><span class="s2">&quot;HTTP_ACCEPT&quot;</span>:<span class="w"> </span><span class="s2">&quot;*/*&quot;</span>,
-</span><span id="__span-17-10"><a id="__codelineno-17-10" name="__codelineno-17-10" href="#__codelineno-17-10"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_FORWARDED_FOR&quot;</span>:<span class="w"> </span><span class="s2">&quot;10.244.0.1&quot;</span>,
-</span><span id="__span-17-11"><a id="__codelineno-17-11" name="__codelineno-17-11" href="#__codelineno-17-11"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_FORWARDED_PROTO&quot;</span>:<span class="w"> </span><span class="s2">&quot;http&quot;</span>,
-</span><span id="__span-17-12"><a id="__codelineno-17-12" name="__codelineno-17-12" href="#__codelineno-17-12"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_ENVOY_INTERNAL&quot;</span>:<span class="w"> </span><span class="s2">&quot;true&quot;</span>,
-</span><span id="__span-17-13"><a id="__codelineno-17-13" name="__codelineno-17-13" href="#__codelineno-17-13"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_REQUEST_ID&quot;</span>:<span class="w"> </span><span class="s2">&quot;9353dd3d-0fe5-4404-86f4-a9732a9c119c&quot;</span>,
-</span><span id="__span-17-14"><a id="__codelineno-17-14" name="__codelineno-17-14" href="#__codelineno-17-14"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_ENVOY_DECORATOR_OPERATION&quot;</span>:<span class="w"> </span><span class="s2">&quot;toystore.my-gateways.svc.cluster.local:80/*&quot;</span>,
-</span><span id="__span-17-15"><a id="__codelineno-17-15" name="__codelineno-17-15" href="#__codelineno-17-15"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_ENVOY_PEER_METADATA&quot;</span>:<span class="w"> </span><span class="s2">&quot;ChQKDkFQUF9DT05UQUlORVJTEgIaAAoaCgpDTFVTVEVSX0lEEgwaCkt1YmVybmV0ZXMKHQoMSU5TVEFOQ0VfSVBTEg0aCzEwLjI0NC4wLjIyChkKDUlTVElPX1ZFUlNJT04SCBoGMS4xNy4yCtcBCgZMQUJFTFMSzAEqyQEKIwoVaXN0aW8uaW8vZ2F0ZXdheS1uYW1lEgoaCHByb2Qtd2ViChkKDGlzdGlvLmlvL3JldhIJGgdkZWZhdWx0CjMKH3NlcnZpY2UuaXN0aW8uaW8vY2Fub25pY2FsLW5hbWUSEBoOcHJvZC13ZWItaXN0aW8KLwojc2VydmljZS5pc3Rpby5pby9jYW5vbmljYWwtcmV2aXNpb24SCBoGbGF0ZXN0CiEKF3NpZGVjYXIuaXN0aW8uaW8vaW5qZWN0EgYaBHRydWUKGgoHTUVTSF9JRBIPGg1jbHVzdGVyLmxvY2FsCigKBE5BTUUSIBoecHJvZC13ZWItaXN0aW8tYzU0NWQ4ZjY4LTdjcjg2ChoKCU5BTUVTUEFDRRINGgtteS1nYXRld2F5cwpWCgVPV05FUhJNGktrdWJlcm5ldGVzOi8vYXBpcy9hcHBzL3YxL25hbWVzcGFjZXMvbXktZ2F0ZXdheXMvZGVwbG95bWVudHMvcHJvZC13ZWItaXN0aW8KFwoRUExBVEZPUk1fTUVUQURBVEESAioACiEKDVdPUktMT0FEX05BTUUSEBoOcHJvZC13ZWItaXN0aW8=&quot;</span>,
-</span><span id="__span-17-16"><a id="__codelineno-17-16" name="__codelineno-17-16" href="#__codelineno-17-16"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_ENVOY_PEER_METADATA_ID&quot;</span>:<span class="w"> </span><span class="s2">&quot;router~10.244.0.22~prod-web-istio-c545d8f68-7cr86.my-gateways~my-gateways.svc.cluster.local&quot;</span>,
-</span><span id="__span-17-17"><a id="__codelineno-17-17" name="__codelineno-17-17" href="#__codelineno-17-17"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_ENVOY_ATTEMPT_COUNT&quot;</span>:<span class="w"> </span><span class="s2">&quot;1&quot;</span>,
-</span><span id="__span-17-18"><a id="__codelineno-17-18" name="__codelineno-17-18" href="#__codelineno-17-18"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_B3_TRACEID&quot;</span>:<span class="w"> </span><span class="s2">&quot;d65f580db9c6a50c471cdb534771c61a&quot;</span>,
-</span><span id="__span-17-19"><a id="__codelineno-17-19" name="__codelineno-17-19" href="#__codelineno-17-19"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_B3_SPANID&quot;</span>:<span class="w"> </span><span class="s2">&quot;471cdb534771c61a&quot;</span>,
-</span><span id="__span-17-20"><a id="__codelineno-17-20" name="__codelineno-17-20" href="#__codelineno-17-20"></a><span class="w">    </span><span class="s2">&quot;HTTP_X_B3_SAMPLED&quot;</span>:<span class="w"> </span><span class="s2">&quot;0&quot;</span>,
-</span><span id="__span-17-21"><a id="__codelineno-17-21" name="__codelineno-17-21" href="#__codelineno-17-21"></a><span class="w">    </span><span class="s2">&quot;HTTP_VERSION&quot;</span>:<span class="w"> </span><span class="s2">&quot;HTTP/1.1&quot;</span>
-</span><span id="__span-17-22"><a id="__codelineno-17-22" name="__codelineno-17-22" href="#__codelineno-17-22"></a><span class="w">  </span><span class="o">}</span>,
-</span><span id="__span-17-23"><a id="__codelineno-17-23" name="__codelineno-17-23" href="#__codelineno-17-23"></a><span class="w">  </span><span class="s2">&quot;uuid&quot;</span>:<span class="w"> </span><span class="s2">&quot;0ecb9f84-db30-4289-a3b8-e22d4021122f&quot;</span>
-</span><span id="__span-17-24"><a id="__codelineno-17-24" name="__codelineno-17-24" href="#__codelineno-17-24"></a><span class="o">}</span>
-</span></code></pre></div></p>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/index.html b/0.10.0/kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/index.html
deleted file mode 100644
index 62dc9d79e..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/index.html
+++ /dev/null
@@ -1,3715 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/">
-      
-      
-        <link rel="prev" href="../../../../authorino/docs/user-guides/caching/">
-      
-      
-        <link rel="next" href="../authenticated-rl-for-app-developers/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RateLimitPolicy for Platform Engineers - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#gateway-rate-limiting-for-cluster-operators" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RateLimitPolicy for Platform Engineers
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-steps-1-5" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the steps ① → ⑤
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the steps ① → ⑤">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-create-the-ingress-gateways" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Create the ingress gateways
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-enforce-rate-limiting-on-requests-incoming-through-the-external-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Enforce rate limiting on requests incoming through the external gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-deploy-a-sample-api-to-test-rate-limiting-enforced-at-the-level-of-the-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      ④ Deploy a sample API to test rate limiting enforced at the level of the gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#5-verify-the-rate-limiting-works-by-sending-requests-in-a-loop" class="md-nav__link">
-    <span class="md-ellipsis">
-      ⑤ Verify the rate limiting works by sending requests in a loop
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-steps-1-5" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the steps ① → ⑤
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the steps ① → ⑤">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-create-the-ingress-gateways" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Create the ingress gateways
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-enforce-rate-limiting-on-requests-incoming-through-the-external-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Enforce rate limiting on requests incoming through the external gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-deploy-a-sample-api-to-test-rate-limiting-enforced-at-the-level-of-the-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      ④ Deploy a sample API to test rate limiting enforced at the level of the gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#5-verify-the-rate-limiting-works-by-sending-requests-in-a-loop" class="md-nav__link">
-    <span class="md-ellipsis">
-      ⑤ Verify the rate limiting works by sending requests in a loop
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/gateway-rl-for-cluster-operators.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="gateway-rate-limiting-for-cluster-operators">Gateway Rate Limiting for Cluster Operators<a class="headerlink" href="#gateway-rate-limiting-for-cluster-operators" title="Permanent link">&para;</a></h1>
-<p>This user guide walks you through an example of how to configure rate limiting for all routes attached to an ingress gateway.</p>
-<p><br/></p>
-<h2 id="run-the-steps-1-5">Run the steps ① → ⑤<a class="headerlink" href="#run-the-steps-1-5" title="Permanent link">&para;</a></h2>
-<h3 id="1-setup">① Setup<a class="headerlink" href="#1-setup" title="Permanent link">&para;</a></h3>
-<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using <a href="https://kind.sigs.k8s.io">Kind</a>,
-where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p>
-<blockquote>
-<p><strong>Note:</strong> In production environment, these steps are usually performed by a cluster operator with administrator privileges over the Kubernetes cluster.</p>
-</blockquote>
-<p>Clone the project:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/kuadrant-operator<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>kuadrant-operator
-</span></code></pre></div>
-<p>Setup the environment:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>Request an instance of Kuadrant:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec: {}</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="2-create-the-ingress-gateways">② Create the ingress gateways<a class="headerlink" href="#2-create-the-ingress-gateways" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Gateway</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: external</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">  annotations:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">    kuadrant.io/namespace: kuadrant-system</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    networking.istio.io/service-type: ClusterIP</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">spec:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">  gatewayClassName: istio</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">  listeners:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">  - name: external</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="s">    port: 80</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="s">    protocol: HTTP</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="s">    hostname: &#39;*.io&#39;</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="s">    allowedRoutes:</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="s">      namespaces:</span>
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="s">        from: All</span>
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="s">---</span>
-</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a><span class="s">kind: Gateway</span>
-</span><span id="__span-3-23"><a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a><span class="s">metadata:</span>
-</span><span id="__span-3-24"><a id="__codelineno-3-24" name="__codelineno-3-24" href="#__codelineno-3-24"></a><span class="s">  name: internal</span>
-</span><span id="__span-3-25"><a id="__codelineno-3-25" name="__codelineno-3-25" href="#__codelineno-3-25"></a><span class="s">  annotations:</span>
-</span><span id="__span-3-26"><a id="__codelineno-3-26" name="__codelineno-3-26" href="#__codelineno-3-26"></a><span class="s">    kuadrant.io/namespace: kuadrant-system</span>
-</span><span id="__span-3-27"><a id="__codelineno-3-27" name="__codelineno-3-27" href="#__codelineno-3-27"></a><span class="s">    networking.istio.io/service-type: ClusterIP</span>
-</span><span id="__span-3-28"><a id="__codelineno-3-28" name="__codelineno-3-28" href="#__codelineno-3-28"></a><span class="s">spec:</span>
-</span><span id="__span-3-29"><a id="__codelineno-3-29" name="__codelineno-3-29" href="#__codelineno-3-29"></a><span class="s">  gatewayClassName: istio</span>
-</span><span id="__span-3-30"><a id="__codelineno-3-30" name="__codelineno-3-30" href="#__codelineno-3-30"></a><span class="s">  listeners:</span>
-</span><span id="__span-3-31"><a id="__codelineno-3-31" name="__codelineno-3-31" href="#__codelineno-3-31"></a><span class="s">  - name: local</span>
-</span><span id="__span-3-32"><a id="__codelineno-3-32" name="__codelineno-3-32" href="#__codelineno-3-32"></a><span class="s">    port: 80</span>
-</span><span id="__span-3-33"><a id="__codelineno-3-33" name="__codelineno-3-33" href="#__codelineno-3-33"></a><span class="s">    protocol: HTTP</span>
-</span><span id="__span-3-34"><a id="__codelineno-3-34" name="__codelineno-3-34" href="#__codelineno-3-34"></a><span class="s">    hostname: &#39;*.local&#39;</span>
-</span><span id="__span-3-35"><a id="__codelineno-3-35" name="__codelineno-3-35" href="#__codelineno-3-35"></a><span class="s">    allowedRoutes:</span>
-</span><span id="__span-3-36"><a id="__codelineno-3-36" name="__codelineno-3-36" href="#__codelineno-3-36"></a><span class="s">      namespaces:</span>
-</span><span id="__span-3-37"><a id="__codelineno-3-37" name="__codelineno-3-37" href="#__codelineno-3-37"></a><span class="s">        from: All</span>
-</span><span id="__span-3-38"><a id="__codelineno-3-38" name="__codelineno-3-38" href="#__codelineno-3-38"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="3-enforce-rate-limiting-on-requests-incoming-through-the-external-gateway">③ Enforce rate limiting on requests incoming through the <code>external</code> gateway<a class="headerlink" href="#3-enforce-rate-limiting-on-requests-incoming-through-the-external-gateway" title="Permanent link">&para;</a></h3>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>    ┌───────────┐      ┌───────────┐
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>    │ (Gateway) │      │ (Gateway) │
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>    │  external │      │  internal │
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>    │           │      │           │
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>    │   *.io    │      │  *.local  │
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a>    └───────────┘      └───────────┘
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>          ▲
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a>          │
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a>┌─────────┴─────────┐
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>│ (RateLimitPolicy) │
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a>│       gw-rlp      │
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a>└───────────────────┘
-</span></code></pre></div>
-<p>Create a Kuadrant <code>RateLimitPolicy</code> to configure rate limiting:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: RateLimitPolicy</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  name: gw-rlp</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">spec:</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="s">    name: external</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="s">  limits:</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="s">    &quot;global&quot;:</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">      rates:</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="s">      - limit: 5</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="s">        duration: 10</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="s">        unit: second</span>
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p>
-</blockquote>
-<h3 id="4-deploy-a-sample-api-to-test-rate-limiting-enforced-at-the-level-of-the-gateway">④ Deploy a sample API to test rate limiting enforced at the level of the gateway<a class="headerlink" href="#4-deploy-a-sample-api-to-test-rate-limiting-enforced-at-the-level-of-the-gateway" title="Permanent link">&para;</a></h3>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>                           ┌───────────┐      ┌───────────┐
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>┌───────────────────┐      │ (Gateway) │      │ (Gateway) │
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>│ (RateLimitPolicy) │      │  external │      │  internal │
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>│       gw-rlp      ├─────►│           │      │           │
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>└───────────────────┘      │   *.io    │      │  *.local  │
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>                           └─────┬─────┘      └─────┬─────┘
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a>                                 │                  │
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>                                 └─────────┬────────┘
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>                                           │
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a>                                 ┌─────────┴────────┐
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a>                                 │   (HTTPRoute)    │
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a>                                 │     toystore     │
-</span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a>                                 │                  │
-</span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a>                                 │ *.toystore.io    │
-</span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a>                                 │ *.toystore.local │
-</span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a>                                 └────────┬─────────┘
-</span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a>                                          │
-</span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a>                                   ┌──────┴───────┐
-</span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a>                                   │   (Service)  │
-</span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a>                                   │   toystore   │
-</span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a>                                   └──────────────┘
-</span></code></pre></div>
-<p>Deploy the sample API:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/toystore/toystore.yaml
-</span></code></pre></div>
-<p>Route traffic to the API from both gateways:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">spec:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">  - name: external</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">    namespace: istio-system</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">  - name: internal</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">    namespace: istio-system</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">  hostnames:</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">  - &quot;*.toystore.io&quot;</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">  - &quot;*.toystore.local&quot;</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">  rules:</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">  - backendRefs:</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">      port: 80</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="5-verify-the-rate-limiting-works-by-sending-requests-in-a-loop">⑤ Verify the rate limiting works by sending requests in a loop<a class="headerlink" href="#5-verify-the-rate-limiting-works-by-sending-requests-in-a-loop" title="Permanent link">&para;</a></h3>
-<p>Expose the gateways, respectively at the port numbers <code>9081</code> and <code>9082</code> of the local host:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>service/external-istio<span class="w"> </span><span class="m">9081</span>:80<span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span><span class="p">&amp;</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>service/internal-istio<span class="w"> </span><span class="m">9082</span>:80<span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span><span class="p">&amp;</span>
-</span></code></pre></div>
-<p>Up to 5 successful (<code>200 OK</code>) requests every 10 seconds through the <code>external</code> ingress gateway (<code>*.io</code>), then <code>429 Too Many Requests</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.io&#39;</span><span class="w"> </span>http://localhost:9081<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<p>Unlimited successful (<code>200 OK</code>) through the <code>internal</code> ingress gateway (<code>*.local</code>):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.local&#39;</span><span class="w"> </span>http://localhost:9082<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/gateway-tls/index.html b/0.10.0/kuadrant-operator/doc/user-guides/gateway-tls/index.html
deleted file mode 100644
index bdcbc793e..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/gateway-tls/index.html
+++ /dev/null
@@ -1,3762 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/gateway-tls/">
-      
-      
-        <link rel="prev" href="../../../../dns-operator/docs/provider/">
-      
-      
-        <link rel="next" href="../auth-for-app-devs-and-platform-engineers/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Gateway TLS for Cluster Operators - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#gateway-tls-for-cluster-operators" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Gateway TLS for Cluster Operators
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requisites
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Requisites">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-an-ingress-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create an ingress gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#enable-tls-on-the-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Enable TLS on the gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deploy-a-sample-api-to-test-tls" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy a sample API to test TLS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#verify-tls-works-by-sending-requests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Verify TLS works by sending requests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requisites
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Requisites">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-an-ingress-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create an ingress gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#enable-tls-on-the-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Enable TLS on the gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deploy-a-sample-api-to-test-tls" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy a sample API to test TLS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#verify-tls-works-by-sending-requests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Verify TLS works by sending requests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/gateway-tls.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="gateway-tls-for-cluster-operators">Gateway TLS for Cluster Operators<a class="headerlink" href="#gateway-tls-for-cluster-operators" title="Permanent link">&para;</a></h1>
-<p>This user guide walks you through an example of how to configure TLS for all routes attached to an ingress gateway.</p>
-<p><br/></p>
-<h2 id="requisites">Requisites<a class="headerlink" href="#requisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="https://docker.io">Docker</a></li>
-</ul>
-<h3 id="setup">Setup<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h3>
-<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using <a href="https://kind.sigs.k8s.io">Kind</a>,
-where it installs Istio, Kubernetes Gateway API, CertManager and Kuadrant itself.</p>
-<p>Clone the project:</p>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/kuadrant-operator<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>kuadrant-operator
-</span></code></pre></div>
-<p>Setup the environment:</p>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>Create a namespace:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>my-gateways
-</span></code></pre></div></p>
-<h3 id="create-an-ingress-gateway">Create an ingress gateway<a class="headerlink" href="#create-an-ingress-gateway" title="Permanent link">&para;</a></h3>
-<p>Create a gateway:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Gateway</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: prod-web</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  gatewayClassName: istio</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">  listeners:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">    - allowedRoutes:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">        namespaces:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">          from: All</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">      name: api</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="s">      hostname: &quot;*.toystore.local&quot;</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="s">      port: 443</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="s">      protocol: HTTPS</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="s">      tls:</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="s">        mode: Terminate</span>
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="s">        certificateRefs:</span>
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="s">          - name: toystore-local-tls</span>
-</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="s">            kind: Secret</span>
-</span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-<h3 id="enable-tls-on-the-gateway">Enable TLS on the gateway<a class="headerlink" href="#enable-tls-on-the-gateway" title="Permanent link">&para;</a></h3>
-<p>The TLSPolicy requires a reference to an existing <a href="https://cert-manager.io/docs/configuration/">CertManager Issuer</a>.</p>
-<p>Create a CertManager Issuer:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: cert-manager.io/v1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: Issuer</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: selfsigned-issuer</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">spec:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">  selfSigned: {}</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-<blockquote>
-<p><strong>Note:</strong> We are using a <a href="https://cert-manager.io/docs/configuration/selfsigned/">self-signed</a> issuer here but any supported CerManager issuer or cluster issuer can be used.</p>
-</blockquote>
-<p><div class="language-shell highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>issuer<span class="w"> </span>selfsigned-issuer<span class="w"> </span>-n<span class="w"> </span>my-gateways
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>NAME<span class="w">                        </span>READY<span class="w">   </span>AGE
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>selfsigned-issuer<span class="w">   </span>True<span class="w">    </span>18s
-</span></code></pre></div></p>
-<p>Create a Kuadrant <code>TLSPolicy</code> to configure TLS:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="s">apiVersion: kuadrant.io/v1alpha1</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="s">kind: TLSPolicy</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="s">metadata:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="s">  name: prod-web</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="s">spec:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="s">    name: prod-web</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="s">  issuerRef:</span>
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="s">    group: cert-manager.io</span>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="s">    kind: Issuer</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="s">    name: selfsigned-issuer</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-<p>Check policy status:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>tlspolicy<span class="w"> </span>-o<span class="w"> </span>wide<span class="w"> </span>-n<span class="w"> </span>my-gateways
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>NAME<span class="w">       </span>STATUS<span class="w">     </span>TARGETREFKIND<span class="w">   </span>TARGETREFNAME<span class="w">   </span>AGE
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>prod-web<span class="w">   </span>Accepted<span class="w">   </span>Gateway<span class="w">         </span>prod-web<span class="w">        </span>13s
-</span></code></pre></div></p>
-<p>Check a Certificate resource was created:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>certificates<span class="w"> </span>-n<span class="w"> </span>my-gateways
-</span></code></pre></div>
-Response
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>NAME<span class="w">                 </span>READY<span class="w">   </span>SECRET<span class="w">               </span>AGE
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>toystore-local-tls<span class="w">   </span>True<span class="w">    </span>toystore-local-tls<span class="w">   </span>7m30s
-</span></code></pre></div></p>
-<p>Check a TLS Secret resource was created:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>secrets<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>--field-selector<span class="o">=</span><span class="s2">&quot;type=kubernetes.io/tls&quot;</span>
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>NAME<span class="w">                 </span>TYPE<span class="w">                </span>DATA<span class="w">   </span>AGE
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>toystore-local-tls<span class="w">   </span>kubernetes.io/tls<span class="w">   </span><span class="m">3</span><span class="w">      </span>7m42s
-</span></code></pre></div></p>
-<h3 id="deploy-a-sample-api-to-test-tls">Deploy a sample API to test TLS<a class="headerlink" href="#deploy-a-sample-api-to-test-tls" title="Permanent link">&para;</a></h3>
-<p>Deploy the sample API:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/toystore/toystore.yaml
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span><span class="nb">wait</span><span class="w"> </span>--for<span class="o">=</span><span class="nv">condition</span><span class="o">=</span>Available<span class="w"> </span>deployments<span class="w"> </span>toystore<span class="w"> </span>--timeout<span class="o">=</span>60s
-</span></code></pre></div></p>
-<p>Route traffic to the API from our gateway:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="s">metadata:</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="s">spec:</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a>
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="s">  - name: prod-web</span>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="s">    namespace: my-gateways</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="s">  hostnames:</span>
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="s">  - &quot;*.toystore.local&quot;</span>
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="s">  rules:</span>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a><span class="s">  - backendRefs:</span>
-</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="s">      port: 80</span>
-</span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a><span class="s">EOF</span>
-</span></code></pre></div></p>
-<h3 id="verify-tls-works-by-sending-requests">Verify TLS works by sending requests<a class="headerlink" href="#verify-tls-works-by-sending-requests" title="Permanent link">&para;</a></h3>
-<p>Get the gateway address@
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nv">GWADDRESS</span><span class="o">=</span><span class="sb">`</span>kubectl<span class="w"> </span>get<span class="w"> </span>gateway/prod-web<span class="w"> </span>-n<span class="w"> </span>my-gateways<span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.addresses[?(@.type==&quot;IPAddress&quot;)].value}&#39;</span><span class="sb">`</span>
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="nb">echo</span><span class="w"> </span><span class="nv">$GWADDRESS</span>
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="m">172</span>.18.200.1
-</span></code></pre></div></p>
-<p>Verify we can access the service via TLS:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>curl<span class="w"> </span>-vkI<span class="w"> </span>https://api.toystore.local<span class="w"> </span>--resolve<span class="w"> </span><span class="s2">&quot;api.toystore.local:443:</span><span class="nv">$GWADDRESS</span><span class="s2">&quot;</span>
-</span></code></pre></div>
-Response:
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>*<span class="w"> </span>Added<span class="w"> </span>api.toystore.local:443:172.18.200.1<span class="w"> </span>to<span class="w"> </span>DNS<span class="w"> </span>cache
-</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a>*<span class="w"> </span>Hostname<span class="w"> </span>api.toystore.local<span class="w"> </span>was<span class="w"> </span>found<span class="w"> </span><span class="k">in</span><span class="w"> </span>DNS<span class="w"> </span>cache
-</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a>*<span class="w">   </span>Trying<span class="w"> </span><span class="m">172</span>.18.200.1:443...
-</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a>*<span class="w"> </span>Connected<span class="w"> </span>to<span class="w"> </span>api.toystore.local<span class="w"> </span><span class="o">(</span><span class="m">172</span>.18.200.1<span class="o">)</span><span class="w"> </span>port<span class="w"> </span><span class="m">443</span><span class="w"> </span><span class="o">(</span><span class="c1">#0)</span>
-</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a>*<span class="w"> </span>ALPN:<span class="w"> </span>offers<span class="w"> </span>h2
-</span><span id="__span-19-6"><a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a>*<span class="w"> </span>ALPN:<span class="w"> </span>offers<span class="w"> </span>http/1.1
-</span><span id="__span-19-7"><a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a>*<span class="w"> </span>TLSv1.0<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Certificate<span class="w"> </span>Status<span class="w"> </span><span class="o">(</span><span class="m">22</span><span class="o">)</span>:
-</span><span id="__span-19-8"><a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>Client<span class="w"> </span>hello<span class="w"> </span><span class="o">(</span><span class="m">1</span><span class="o">)</span>:
-</span><span id="__span-19-9"><a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Certificate<span class="w"> </span>Status<span class="w"> </span><span class="o">(</span><span class="m">22</span><span class="o">)</span>:
-</span><span id="__span-19-10"><a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>Server<span class="w"> </span>hello<span class="w"> </span><span class="o">(</span><span class="m">2</span><span class="o">)</span>:
-</span><span id="__span-19-11"><a id="__codelineno-19-11" name="__codelineno-19-11" href="#__codelineno-19-11"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Finished<span class="w"> </span><span class="o">(</span><span class="m">20</span><span class="o">)</span>:
-</span><span id="__span-19-12"><a id="__codelineno-19-12" name="__codelineno-19-12" href="#__codelineno-19-12"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-13"><a id="__codelineno-19-13" name="__codelineno-19-13" href="#__codelineno-19-13"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>Encrypted<span class="w"> </span>Extensions<span class="w"> </span><span class="o">(</span><span class="m">8</span><span class="o">)</span>:
-</span><span id="__span-19-14"><a id="__codelineno-19-14" name="__codelineno-19-14" href="#__codelineno-19-14"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>Certificate<span class="w"> </span><span class="o">(</span><span class="m">11</span><span class="o">)</span>:
-</span><span id="__span-19-15"><a id="__codelineno-19-15" name="__codelineno-19-15" href="#__codelineno-19-15"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>CERT<span class="w"> </span>verify<span class="w"> </span><span class="o">(</span><span class="m">15</span><span class="o">)</span>:
-</span><span id="__span-19-16"><a id="__codelineno-19-16" name="__codelineno-19-16" href="#__codelineno-19-16"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>Finished<span class="w"> </span><span class="o">(</span><span class="m">20</span><span class="o">)</span>:
-</span><span id="__span-19-17"><a id="__codelineno-19-17" name="__codelineno-19-17" href="#__codelineno-19-17"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Finished<span class="w"> </span><span class="o">(</span><span class="m">20</span><span class="o">)</span>:
-</span><span id="__span-19-18"><a id="__codelineno-19-18" name="__codelineno-19-18" href="#__codelineno-19-18"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>change<span class="w"> </span>cipher,<span class="w"> </span>Change<span class="w"> </span>cipher<span class="w"> </span>spec<span class="w"> </span><span class="o">(</span><span class="m">1</span><span class="o">)</span>:
-</span><span id="__span-19-19"><a id="__codelineno-19-19" name="__codelineno-19-19" href="#__codelineno-19-19"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-20"><a id="__codelineno-19-20" name="__codelineno-19-20" href="#__codelineno-19-20"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>Finished<span class="w"> </span><span class="o">(</span><span class="m">20</span><span class="o">)</span>:
-</span><span id="__span-19-21"><a id="__codelineno-19-21" name="__codelineno-19-21" href="#__codelineno-19-21"></a>*<span class="w"> </span>SSL<span class="w"> </span>connection<span class="w"> </span>using<span class="w"> </span>TLSv1.3<span class="w"> </span>/<span class="w"> </span>TLS_AES_256_GCM_SHA384
-</span><span id="__span-19-22"><a id="__codelineno-19-22" name="__codelineno-19-22" href="#__codelineno-19-22"></a>*<span class="w"> </span>ALPN:<span class="w"> </span>server<span class="w"> </span>accepted<span class="w"> </span>h2
-</span><span id="__span-19-23"><a id="__codelineno-19-23" name="__codelineno-19-23" href="#__codelineno-19-23"></a>*<span class="w"> </span>Server<span class="w"> </span>certificate:
-</span><span id="__span-19-24"><a id="__codelineno-19-24" name="__codelineno-19-24" href="#__codelineno-19-24"></a>*<span class="w">  </span>subject:<span class="w"> </span><span class="o">[</span>NONE<span class="o">]</span>
-</span><span id="__span-19-25"><a id="__codelineno-19-25" name="__codelineno-19-25" href="#__codelineno-19-25"></a>*<span class="w">  </span>start<span class="w"> </span>date:<span class="w"> </span>Feb<span class="w"> </span><span class="m">15</span><span class="w"> </span><span class="m">11</span>:46:50<span class="w"> </span><span class="m">2024</span><span class="w"> </span>GMT
-</span><span id="__span-19-26"><a id="__codelineno-19-26" name="__codelineno-19-26" href="#__codelineno-19-26"></a>*<span class="w">  </span>expire<span class="w"> </span>date:<span class="w"> </span>May<span class="w"> </span><span class="m">15</span><span class="w"> </span><span class="m">11</span>:46:50<span class="w"> </span><span class="m">2024</span><span class="w"> </span>GMT
-</span><span id="__span-19-27"><a id="__codelineno-19-27" name="__codelineno-19-27" href="#__codelineno-19-27"></a>*<span class="w"> </span>Using<span class="w"> </span>HTTP2,<span class="w"> </span>server<span class="w"> </span>supports<span class="w"> </span>multiplexing
-</span><span id="__span-19-28"><a id="__codelineno-19-28" name="__codelineno-19-28" href="#__codelineno-19-28"></a>*<span class="w"> </span>Copying<span class="w"> </span>HTTP/2<span class="w"> </span>data<span class="w"> </span><span class="k">in</span><span class="w"> </span>stream<span class="w"> </span>buffer<span class="w"> </span>to<span class="w"> </span>connection<span class="w"> </span>buffer<span class="w"> </span>after<span class="w"> </span>upgrade:<span class="w"> </span><span class="nv">len</span><span class="o">=</span><span class="m">0</span>
-</span><span id="__span-19-29"><a id="__codelineno-19-29" name="__codelineno-19-29" href="#__codelineno-19-29"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-30"><a id="__codelineno-19-30" name="__codelineno-19-30" href="#__codelineno-19-30"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-31"><a id="__codelineno-19-31" name="__codelineno-19-31" href="#__codelineno-19-31"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-32"><a id="__codelineno-19-32" name="__codelineno-19-32" href="#__codelineno-19-32"></a>*<span class="w"> </span>h2h3<span class="w"> </span><span class="o">[</span>:method:<span class="w"> </span>HEAD<span class="o">]</span>
-</span><span id="__span-19-33"><a id="__codelineno-19-33" name="__codelineno-19-33" href="#__codelineno-19-33"></a>*<span class="w"> </span>h2h3<span class="w"> </span><span class="o">[</span>:path:<span class="w"> </span>/<span class="o">]</span>
-</span><span id="__span-19-34"><a id="__codelineno-19-34" name="__codelineno-19-34" href="#__codelineno-19-34"></a>*<span class="w"> </span>h2h3<span class="w"> </span><span class="o">[</span>:scheme:<span class="w"> </span>https<span class="o">]</span>
-</span><span id="__span-19-35"><a id="__codelineno-19-35" name="__codelineno-19-35" href="#__codelineno-19-35"></a>*<span class="w"> </span>h2h3<span class="w"> </span><span class="o">[</span>:authority:<span class="w"> </span>api.toystore.local<span class="o">]</span>
-</span><span id="__span-19-36"><a id="__codelineno-19-36" name="__codelineno-19-36" href="#__codelineno-19-36"></a>*<span class="w"> </span>h2h3<span class="w"> </span><span class="o">[</span>user-agent:<span class="w"> </span>curl/7.85.0<span class="o">]</span>
-</span><span id="__span-19-37"><a id="__codelineno-19-37" name="__codelineno-19-37" href="#__codelineno-19-37"></a>*<span class="w"> </span>h2h3<span class="w"> </span><span class="o">[</span>accept:<span class="w"> </span>*/*<span class="o">]</span>
-</span><span id="__span-19-38"><a id="__codelineno-19-38" name="__codelineno-19-38" href="#__codelineno-19-38"></a>*<span class="w"> </span>Using<span class="w"> </span>Stream<span class="w"> </span>ID:<span class="w"> </span><span class="m">1</span><span class="w"> </span><span class="o">(</span>easy<span class="w"> </span>handle<span class="w"> </span>0x5623e4fe5bf0<span class="o">)</span>
-</span><span id="__span-19-39"><a id="__codelineno-19-39" name="__codelineno-19-39" href="#__codelineno-19-39"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-40"><a id="__codelineno-19-40" name="__codelineno-19-40" href="#__codelineno-19-40"></a>&gt;<span class="w"> </span>HEAD<span class="w"> </span>/<span class="w"> </span>HTTP/2
-</span><span id="__span-19-41"><a id="__codelineno-19-41" name="__codelineno-19-41" href="#__codelineno-19-41"></a>&gt;<span class="w"> </span>Host:<span class="w"> </span>api.toystore.local
-</span><span id="__span-19-42"><a id="__codelineno-19-42" name="__codelineno-19-42" href="#__codelineno-19-42"></a>&gt;<span class="w"> </span>user-agent:<span class="w"> </span>curl/7.85.0
-</span><span id="__span-19-43"><a id="__codelineno-19-43" name="__codelineno-19-43" href="#__codelineno-19-43"></a>&gt;<span class="w"> </span>accept:<span class="w"> </span>*/*
-</span><span id="__span-19-44"><a id="__codelineno-19-44" name="__codelineno-19-44" href="#__codelineno-19-44"></a>&gt;<span class="w"> </span>
-</span><span id="__span-19-45"><a id="__codelineno-19-45" name="__codelineno-19-45" href="#__codelineno-19-45"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-46"><a id="__codelineno-19-46" name="__codelineno-19-46" href="#__codelineno-19-46"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>Newsession<span class="w"> </span>Ticket<span class="w"> </span><span class="o">(</span><span class="m">4</span><span class="o">)</span>:
-</span><span id="__span-19-47"><a id="__codelineno-19-47" name="__codelineno-19-47" href="#__codelineno-19-47"></a>*<span class="w"> </span>TLSv1.3<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>handshake,<span class="w"> </span>Newsession<span class="w"> </span>Ticket<span class="w"> </span><span class="o">(</span><span class="m">4</span><span class="o">)</span>:
-</span><span id="__span-19-48"><a id="__codelineno-19-48" name="__codelineno-19-48" href="#__codelineno-19-48"></a>*<span class="w"> </span>old<span class="w"> </span>SSL<span class="w"> </span>session<span class="w"> </span>ID<span class="w"> </span>is<span class="w"> </span>stale,<span class="w"> </span>removing
-</span><span id="__span-19-49"><a id="__codelineno-19-49" name="__codelineno-19-49" href="#__codelineno-19-49"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-50"><a id="__codelineno-19-50" name="__codelineno-19-50" href="#__codelineno-19-50"></a>*<span class="w"> </span>Connection<span class="w"> </span>state<span class="w"> </span>changed<span class="w"> </span><span class="o">(</span><span class="nv">MAX_CONCURRENT_STREAMS</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="m">2147483647</span><span class="o">)</span>!
-</span><span id="__span-19-51"><a id="__codelineno-19-51" name="__codelineno-19-51" href="#__codelineno-19-51"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>OUT<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-52"><a id="__codelineno-19-52" name="__codelineno-19-52" href="#__codelineno-19-52"></a>*<span class="w"> </span>TLSv1.2<span class="w"> </span><span class="o">(</span>IN<span class="o">)</span>,<span class="w"> </span>TLS<span class="w"> </span>header,<span class="w"> </span>Supplemental<span class="w"> </span>data<span class="w"> </span><span class="o">(</span><span class="m">23</span><span class="o">)</span>:
-</span><span id="__span-19-53"><a id="__codelineno-19-53" name="__codelineno-19-53" href="#__codelineno-19-53"></a>&lt;<span class="w"> </span>HTTP/2<span class="w"> </span><span class="m">200</span><span class="w"> </span>
-</span><span id="__span-19-54"><a id="__codelineno-19-54" name="__codelineno-19-54" href="#__codelineno-19-54"></a>HTTP/2<span class="w"> </span><span class="m">200</span><span class="w"> </span>
-</span><span id="__span-19-55"><a id="__codelineno-19-55" name="__codelineno-19-55" href="#__codelineno-19-55"></a>&lt;<span class="w"> </span>content-type:<span class="w"> </span>application/json
-</span><span id="__span-19-56"><a id="__codelineno-19-56" name="__codelineno-19-56" href="#__codelineno-19-56"></a>content-type:<span class="w"> </span>application/json
-</span><span id="__span-19-57"><a id="__codelineno-19-57" name="__codelineno-19-57" href="#__codelineno-19-57"></a>&lt;<span class="w"> </span>server:<span class="w"> </span>istio-envoy
-</span><span id="__span-19-58"><a id="__codelineno-19-58" name="__codelineno-19-58" href="#__codelineno-19-58"></a>server:<span class="w"> </span>istio-envoy
-</span><span id="__span-19-59"><a id="__codelineno-19-59" name="__codelineno-19-59" href="#__codelineno-19-59"></a>&lt;<span class="w"> </span>date:<span class="w"> </span>Thu,<span class="w"> </span><span class="m">15</span><span class="w"> </span>Feb<span class="w"> </span><span class="m">2024</span><span class="w"> </span><span class="m">12</span>:13:27<span class="w"> </span>GMT
-</span><span id="__span-19-60"><a id="__codelineno-19-60" name="__codelineno-19-60" href="#__codelineno-19-60"></a>date:<span class="w"> </span>Thu,<span class="w"> </span><span class="m">15</span><span class="w"> </span>Feb<span class="w"> </span><span class="m">2024</span><span class="w"> </span><span class="m">12</span>:13:27<span class="w"> </span>GMT
-</span><span id="__span-19-61"><a id="__codelineno-19-61" name="__codelineno-19-61" href="#__codelineno-19-61"></a>&lt;<span class="w"> </span>content-length:<span class="w"> </span><span class="m">1658</span>
-</span><span id="__span-19-62"><a id="__codelineno-19-62" name="__codelineno-19-62" href="#__codelineno-19-62"></a>content-length:<span class="w"> </span><span class="m">1658</span>
-</span><span id="__span-19-63"><a id="__codelineno-19-63" name="__codelineno-19-63" href="#__codelineno-19-63"></a>&lt;<span class="w"> </span>x-envoy-upstream-service-time:<span class="w"> </span><span class="m">1</span>
-</span><span id="__span-19-64"><a id="__codelineno-19-64" name="__codelineno-19-64" href="#__codelineno-19-64"></a>x-envoy-upstream-service-time:<span class="w"> </span><span class="m">1</span>
-</span><span id="__span-19-65"><a id="__codelineno-19-65" name="__codelineno-19-65" href="#__codelineno-19-65"></a>
-</span><span id="__span-19-66"><a id="__codelineno-19-66" name="__codelineno-19-66" href="#__codelineno-19-66"></a>&lt;<span class="w"> </span>
-</span><span id="__span-19-67"><a id="__codelineno-19-67" name="__codelineno-19-67" href="#__codelineno-19-67"></a>
-</span><span id="__span-19-68"><a id="__codelineno-19-68" name="__codelineno-19-68" href="#__codelineno-19-68"></a>*<span class="w"> </span>Connection<span class="w"> </span><span class="c1">#0 to host api.toystore.local left intact</span>
-</span></code></pre></div></p>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/index.html b/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/index.html
deleted file mode 100644
index 602306da5..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/index.html
+++ /dev/null
@@ -1,4602 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/">
-      
-      
-        <link rel="prev" href="../secure-protect-connect/">
-      
-      
-        <link rel="next" href="../../dnshealthchecks/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Secure, connect and protect - OpenShift - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#secure-protect-and-connect-apis-with-kuadrant-on-openshift" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Secure, connect and protect - OpenShift
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Overview">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#what-kuadrant-can-do-for-you-in-a-multicluster-environment" class="md-nav__link">
-    <span class="md-ellipsis">
-      What Kuadrant can do for you in a multicluster environment
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#user-roles" class="md-nav__link">
-    <span class="md-ellipsis">
-      User roles
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deployment-management-tooling" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deployment management tooling
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#platform-engineer-workflow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Platform engineer workflow
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Platform engineer workflow">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-set-your-environment-variables" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Set your environment variables
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-set-up-a-dns-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Set up a DNS Provider
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 2 - Set up a DNS Provider">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#create-the-dns-provider-secret-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create the DNS Provider Secret resource
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-3-add-a-tls-issuer" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Add a TLS issuer
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-set-up-a-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Set up a Gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-5-secure-and-protect-the-gateway-with-auth-tls-rate-limit-and-dns-policies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Secure and protect the Gateway with auth, TLS, rate limit, and DNS policies
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 5 - Secure and protect the Gateway with auth, TLS, rate limit, and DNS policies">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#set-the-auth-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the Auth policy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-the-tls-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the TLS policy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-the-rate-limit-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the rate limit policy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-the-dns-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the DNS policy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-an-http-route" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create an HTTP route
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-6-test-connectivity-and-deny-all-auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 6 - Test connectivity and deny all auth
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-7-opening-up-the-gateway-for-other-namespaces" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 7 - Opening up the Gateway for other namespaces
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-8-extending-this-gateway-to-multiple-clusters-and-configuring-geo-based-routing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 8 - Extending this Gateway to multiple clusters and configuring geo-based routing
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#application-developer-workflow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Application developer workflow
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Application developer workflow">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prerequisites_1" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-1-deploy-the-toystore-app" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Deploy the toystore app
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-set-up-httproute-and-backend" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Set up HTTPRoute and backend
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-3-use-oas-to-define-your-httproute-rules" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Use OAS to define your HTTPRoute rules
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-test-connectivity-and-deny-all-auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Test connectivity and deny-all auth
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-5-set-up-api-key-auth-flow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Set up API key auth flow
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional-step-6-set-up-openid-connect-auth-flow-skip-if-using-api-key-only" class="md-nav__link">
-    <span class="md-ellipsis">
-      Optional: Step 6 - Set up OpenID Connect auth flow (skip if using API key only)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Optional: Step 6 - Set up OpenID Connect auth flow (skip if using API key only)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prerequisites_2" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-up-an-openid-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set up an OpenID AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#test-your-openid-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Test your OpenID AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-7-set-up-rate-limiting" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 7 - Set up rate limiting
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 7 - Set up rate limiting">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#test-your-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Test your RateLimitPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Test your RateLimitPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-key-auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      API Key auth
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#openid-connect-auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenID Connect auth
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#conclusion" class="md-nav__link">
-    <span class="md-ellipsis">
-      Conclusion
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Overview">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#what-kuadrant-can-do-for-you-in-a-multicluster-environment" class="md-nav__link">
-    <span class="md-ellipsis">
-      What Kuadrant can do for you in a multicluster environment
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#user-roles" class="md-nav__link">
-    <span class="md-ellipsis">
-      User roles
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deployment-management-tooling" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deployment management tooling
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#platform-engineer-workflow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Platform engineer workflow
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Platform engineer workflow">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-set-your-environment-variables" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Set your environment variables
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-set-up-a-dns-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Set up a DNS Provider
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 2 - Set up a DNS Provider">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#create-the-dns-provider-secret-resource" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create the DNS Provider Secret resource
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-3-add-a-tls-issuer" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Add a TLS issuer
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-set-up-a-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Set up a Gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-5-secure-and-protect-the-gateway-with-auth-tls-rate-limit-and-dns-policies" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Secure and protect the Gateway with auth, TLS, rate limit, and DNS policies
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 5 - Secure and protect the Gateway with auth, TLS, rate limit, and DNS policies">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#set-the-auth-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the Auth policy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-the-tls-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the TLS policy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-the-rate-limit-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the rate limit policy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-the-dns-policy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set the DNS policy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#create-an-http-route" class="md-nav__link">
-    <span class="md-ellipsis">
-      Create an HTTP route
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-6-test-connectivity-and-deny-all-auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 6 - Test connectivity and deny all auth
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-7-opening-up-the-gateway-for-other-namespaces" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 7 - Opening up the Gateway for other namespaces
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-8-extending-this-gateway-to-multiple-clusters-and-configuring-geo-based-routing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 8 - Extending this Gateway to multiple clusters and configuring geo-based routing
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#application-developer-workflow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Application developer workflow
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Application developer workflow">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prerequisites_1" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-1-deploy-the-toystore-app" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Deploy the toystore app
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-set-up-httproute-and-backend" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Set up HTTPRoute and backend
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-3-use-oas-to-define-your-httproute-rules" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Use OAS to define your HTTPRoute rules
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-test-connectivity-and-deny-all-auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Test connectivity and deny-all auth
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-5-set-up-api-key-auth-flow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Set up API key auth flow
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional-step-6-set-up-openid-connect-auth-flow-skip-if-using-api-key-only" class="md-nav__link">
-    <span class="md-ellipsis">
-      Optional: Step 6 - Set up OpenID Connect auth flow (skip if using API key only)
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Optional: Step 6 - Set up OpenID Connect auth flow (skip if using API key only)">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prerequisites_2" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-up-an-openid-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set up an OpenID AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#test-your-openid-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Test your OpenID AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-7-set-up-rate-limiting" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 7 - Set up rate limiting
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 7 - Set up rate limiting">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#test-your-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Test your RateLimitPolicy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Test your RateLimitPolicy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#api-key-auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      API Key auth
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#openid-connect-auth" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenID Connect auth
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#conclusion" class="md-nav__link">
-    <span class="md-ellipsis">
-      Conclusion
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/secure-protect-connect-single-multi-cluster.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="secure-protect-and-connect-apis-with-kuadrant-on-openshift">Secure, protect, and connect APIs with Kuadrant on OpenShift<a class="headerlink" href="#secure-protect-and-connect-apis-with-kuadrant-on-openshift" title="Permanent link">&para;</a></h1>
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>This guide walks you through using Kuadrant on OpenShift to secure, protect, and connect an API exposed by a Gateway that is based on Kubernetes Gateway API. You can use this walkthrough for a Gateway deployed on a single OpenShift cluster or a Gateway distributed across multiple OpenShift clusters with a shared listener hostname. This guide shows how the platform engineer and application developer user roles can each use Kuadrant to achieve their goals.</p>
-<h3 id="what-kuadrant-can-do-for-you-in-a-multicluster-environment">What Kuadrant can do for you in a multicluster environment<a class="headerlink" href="#what-kuadrant-can-do-for-you-in-a-multicluster-environment" title="Permanent link">&para;</a></h3>
-<p>You can leverage Kuadrant's capabilities in single or multiple clusters. The following features are designed to work across multiple clusters as well as in a single-cluster environment.</p>
-<ul>
-<li><strong>Multicluster ingress:</strong> Kuadrant provides multicluster ingress connectivity using DNS to bring traffic to your Gateways by using a strategy defined in a <code>DNSPolicy</code>. </li>
-<li><strong>Global rate limiting:</strong> Kuadrant can enable global rate limiting use cases when configured to use a shared Redis store for counters based on limits defined by a <code>RateLimitPolicy</code>.</li>
-<li><strong>Global auth:</strong> You can configure a Kuadrant <code>AuthPolicy</code> to leverage external auth providers to ensure that different clusters exposing the same API authenticate and authorize in the same way. </li>
-<li><strong>Integration with federated metrics stores:</strong> Kuadrant has example dashboards and metrics for visualizing your Gateways and observing traffic hitting those Gateways across multiple clusters. </li>
-</ul>
-<h3 id="user-roles">User roles<a class="headerlink" href="#user-roles" title="Permanent link">&para;</a></h3>
-<ul>
-<li>
-<p><strong>Platform engineer</strong>: This guide walks you through deploying a Gateway that provides secure communication and is protected and ready for use by application development teams to deploy an API. It then walks through using this Gateway in clusters in different geographic regions, leveraging Kuadrant to bring specific traffic to your geo-located Gateways to reduce latency and distribute load, while still being protected and secured with global rate limiting and auth. </p>
-</li>
-<li>
-<p><strong>Application developer</strong>: This guide walks through how you can use the Kuadrant OpenAPI Specification (OAS) extensions and <code>kuadrantctl</code> CLI to generate an <code>HTTPRoute</code> for your API and to add specific auth and rate limiting requirements.</p>
-</li>
-</ul>
-<p>As an optional extra, this guide highlights how both user roles can observe and monitor these Gateways when the OpenShift user workload monitoring and observability stack is deployed. </p>
-<h3 id="deployment-management-tooling">Deployment management tooling<a class="headerlink" href="#deployment-management-tooling" title="Permanent link">&para;</a></h3>
-<p>While this document uses <code>kubectl</code> commands for simplicity, working with multiple clusters is complex, and it is best to use a tool such as Argo CD to manage the deployment of resources to multiple clusters.</p>
-<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<p>This guide expects that you have successfully installed Kuadrant on at least one OpenShift cluster:</p>
-<ul>
-<li>You have completed the steps in <a href="../../install/install-openshift/">Install Kuadrant on an OpenShift cluster</a> for one or more clusters.</li>
-<li>For multicluster scenarios, you have installed Kuadrant on at least two different OpenShift clusters, and have a shared accessible Redis store.</li>
-<li>You have the <code>kubectl</code> command line installed.</li>
-<li>Optional: User workload monitoring is configured to remote write to a central storage system such as Thanos, as described in <a href="../../install/install-openshift/">Install Kuadrant on an OpenShift cluster</a>.</li>
-</ul>
-<h2 id="platform-engineer-workflow">Platform engineer workflow<a class="headerlink" href="#platform-engineer-workflow" title="Permanent link">&para;</a></h2>
-<p>NOTE: You must perform the following steps in each cluster individually, unless specifically excluded. </p>
-<h3 id="step-1-set-your-environment-variables">Step 1 - Set your environment variables<a class="headerlink" href="#step-1-set-your-environment-variables" title="Permanent link">&para;</a></h3>
-<p>Set the following environment variables used for convenience in this guide:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">zid</span><span class="o">=</span>change-this-to-your-zone-id
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">rootDomain</span><span class="o">=</span>example.com
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">gatewayNS</span><span class="o">=</span>api-gateway
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="nb">export</span><span class="w"> </span><span class="nv">gatewayName</span><span class="o">=</span>external
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nb">export</span><span class="w"> </span><span class="nv">devNS</span><span class="o">=</span>toystore
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span>xxxx
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span>xxxx
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_REGION</span><span class="o">=</span>us-east-1
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="nb">export</span><span class="w"> </span><span class="nv">clusterIssuerName</span><span class="o">=</span>lets-encrypt
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="nb">export</span><span class="w"> </span><span class="nv">EMAIL</span><span class="o">=</span>foo@example.com
-</span></code></pre></div></p>
-<h3 id="step-2-set-up-a-dns-provider">Step 2 - Set up a DNS Provider<a class="headerlink" href="#step-2-set-up-a-dns-provider" title="Permanent link">&para;</a></h3>
-<p>The DNS provider declares a credential to access the zone(s) that Kuadrant can use to set up DNS configuration. You should ensure that this credential only has access to the zones you want managed.</p>
-<h4 id="create-the-dns-provider-secret-resource">Create the DNS Provider Secret resource<a class="headerlink" href="#create-the-dns-provider-secret-resource" title="Permanent link">&para;</a></h4>
-<p>Apply the following <code>Secret</code> resource to each cluster. Alternatively, if you are adding an additional cluster, add it to the new cluster:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>ns<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span>
-</span></code></pre></div>
-<p>Create the secret credentials as follows:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl -n ${gatewayNS} create secret generic aws-credentials \
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>  --type=kuadrant.io/aws \
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>  --from-literal=AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a>  --from-literal=AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY
-</span></code></pre></div>
-<h3 id="step-3-add-a-tls-issuer">Step 3 - Add a TLS issuer<a class="headerlink" href="#step-3-add-a-tls-issuer" title="Permanent link">&para;</a></h3>
-<p>To secure communication to the Gateways, you will define a TLS issuer for TLS certificates. This example uses Let's Encrypt, but you can use any issuer supported by <code>cert-manager</code>.</p>
-<p>The following example uses Let's Encrypt staging, which you must also apply to all clusters:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: cert-manager.io/v1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: ClusterIssuer</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: ${clusterIssuerName}</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">spec:</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">  acme:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">    email: ${EMAIL} </span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">    privateKeySecretRef:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="s">      name: le-secret</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">    server: https://acme-staging-v02.api.letsencrypt.org/directory</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">    solvers:</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="s">      - dns01:</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="s">          route53:</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="s">            hostedZoneID: ${zid}</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="s">            region: ${AWS_REGION}</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="s">            accessKeyIDSecretRef:</span>
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="s">              key: AWS_ACCESS_KEY_ID</span>
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="s">              name: aws-credentials</span>
-</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="s">            secretAccessKeySecretRef:</span>
-</span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a><span class="s">              key: AWS_SECRET_ACCESS_KEY</span>
-</span><span id="__span-3-23"><a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a><span class="s">              name: aws-credentials</span>
-</span><span id="__span-3-24"><a id="__codelineno-3-24" name="__codelineno-3-24" href="#__codelineno-3-24"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Then wait for the <code>ClusterIssuer</code> to become ready as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span><span class="nb">wait</span><span class="w"> </span>clusterissuer/<span class="si">${</span><span class="nv">clusterIssuerName</span><span class="si">}</span><span class="w"> </span>--for<span class="o">=</span><span class="nv">condition</span><span class="o">=</span><span class="nv">ready</span><span class="o">=</span><span class="nb">true</span>
-</span></code></pre></div>
-<h3 id="step-4-set-up-a-gateway">Step 4 - Set up a Gateway<a class="headerlink" href="#step-4-set-up-a-gateway" title="Permanent link">&para;</a></h3>
-<p>For Kuadrant to balance traffic using DNS across two or more clusters, you must define a Gateway with a shared host. You will define this by using an HTTPS listener with a wildcard hostname based on the root domain. As mentioned earlier, you must apply these resources to all clusters. </p>
-<p>NOTE: For now, the Gateway is set to accept an <code>HTTPRoute</code> from the same namespace only. This allows you to restrict who can use the Gateway until it is ready for general use.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: Gateway</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  name: ${gatewayName}</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">  namespace: ${gatewayNS}</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">  labels:</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">    kuadrant.io/gateway: &quot;true&quot;</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="s">spec:</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="s">    gatewayClassName: istio</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="s">    listeners:</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">    - allowedRoutes:</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="s">        namespaces:</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="s">          from: Same</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="s">      hostname: &quot;*.${rootDomain}&quot;</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="s">      name: api</span>
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a><span class="s">      port: 443</span>
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a><span class="s">      protocol: HTTPS</span>
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a><span class="s">      tls:</span>
-</span><span id="__span-5-21"><a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a><span class="s">        certificateRefs:</span>
-</span><span id="__span-5-22"><a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a><span class="s">        - group: &quot;&quot;</span>
-</span><span id="__span-5-23"><a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></a><span class="s">          kind: Secret</span>
-</span><span id="__span-5-24"><a id="__codelineno-5-24" name="__codelineno-5-24" href="#__codelineno-5-24"></a><span class="s">          name: api-${gatewayName}-tls</span>
-</span><span id="__span-5-25"><a id="__codelineno-5-25" name="__codelineno-5-25" href="#__codelineno-5-25"></a><span class="s">        mode: Terminate</span>
-</span><span id="__span-5-26"><a id="__codelineno-5-26" name="__codelineno-5-26" href="#__codelineno-5-26"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check the status of your Gateway as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>gateway<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span><span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Accepted&quot;)].message}&#39;</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>kubectl<span class="w"> </span>get<span class="w"> </span>gateway<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span><span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Programmed&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<p>Your Gateway should be accepted and programmed (valid and assigned an external address). However, if you check your listener status as follows, you will see that it is not yet programmed or ready to accept traffic due to bad TLS configuration:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>gateway<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span><span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.listeners[0].conditions[?(@.type==&quot;Programmed&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<p>Kuadrant can help with this by using a TLSPolicy.</p>
-<h3 id="step-5-secure-and-protect-the-gateway-with-auth-tls-rate-limit-and-dns-policies">Step 5 - Secure and protect the Gateway with auth, TLS, rate limit, and DNS policies<a class="headerlink" href="#step-5-secure-and-protect-the-gateway-with-auth-tls-rate-limit-and-dns-policies" title="Permanent link">&para;</a></h3>
-<p>While your Gateway is now deployed, it has no exposed endpoints and your listener is not programmed. Next, you can set up a <code>TLSPolicy</code> that leverages your CertificateIssuer to set up your listener certificates. </p>
-<p>You will also define an <code>AuthPolicy</code> that will set up a default <code>403</code> response for any unprotected endpoints, as well as a <code>RateLimitPolicy</code> that will set up a default artificially low global limit to further protect any endpoints exposed by this Gateway.</p>
-<h4 id="set-the-auth-policy">Set the Auth policy<a class="headerlink" href="#set-the-auth-policy" title="Permanent link">&para;</a></h4>
-<p>Set a default, deny-all <code>AuthPolicy</code> for your Gateway as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: AuthPolicy</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: ${gatewayName}-auth</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  namespace: ${gatewayNS}</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">spec:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">  targetRef:</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="s">    name: ${gatewayName}</span>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">  defaults:</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">    rules:</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">      authorization:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">        &quot;deny&quot;:</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">          opa:</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">            rego: &quot;allow = false&quot;</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check that your auth policy was accepted by the controller as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>authpolicy<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span>-auth<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Accepted&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<h4 id="set-the-tls-policy">Set the TLS policy<a class="headerlink" href="#set-the-tls-policy" title="Permanent link">&para;</a></h4>
-<p>Set the <code>TLSPolicy</code> for your Gateway as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">apiVersion: kuadrant.io/v1alpha1</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">kind: TLSPolicy</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">metadata:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">  name: ${gatewayName}-tls</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">  namespace: ${gatewayNS}</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">spec:</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="s">  targetRef:</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">    name: ${gatewayName}</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">  issuerRef:</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">    group: cert-manager.io</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">    kind: ClusterIssuer</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="s">    name: ${clusterIssuerName}</span>
-</span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check that your TLS policy was accepted by the controller as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>tlspolicy<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span>-tls<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Accepted&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<h4 id="set-the-rate-limit-policy">Set the rate limit policy<a class="headerlink" href="#set-the-rate-limit-policy" title="Permanent link">&para;</a></h4>
-<p>Set the default <code>RateLimitPolicy</code> for your Gateway as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w">  </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: RateLimitPolicy</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: ${gatewayName}-rlp</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">  namespace: ${gatewayNS}</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">spec:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="s">  targetRef:</span>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="s">    name: ${gatewayName}</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">  defaults:</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">    limits:</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="s">      &quot;low-limit&quot;:</span>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="s">        rates:</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="s">        - limit: 2</span>
-</span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="s">          duration: 10</span>
-</span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a><span class="s">          unit: second</span>
-</span><span id="__span-12-20"><a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>To check your rate limits have been accepted, enter the following command:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>ratelimitpolicy<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span>-rlp<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Accepted&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<h4 id="set-the-dns-policy">Set the DNS policy<a class="headerlink" href="#set-the-dns-policy" title="Permanent link">&para;</a></h4>
-<p>Set the <code>DNSPolicy</code> for your Gateway as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="s">apiVersion: kuadrant.io/v1alpha1</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="s">kind: DNSPolicy</span>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="s">metadata:</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="s">  name: ${gatewayName}-dnspolicy</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="s">  namespace: ${gatewayNS}</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="s">spec:</span>
-</span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="s">  routingStrategy: loadbalanced</span>
-</span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="s">  loadBalancing:</span>
-</span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="s">    geo: </span>
-</span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="s">      defaultGeo: US </span>
-</span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="s">    weighted:</span>
-</span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="s">      defaultWeight: 120 </span>
-</span><span id="__span-14-14"><a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="s">  targetRef:</span>
-</span><span id="__span-14-15"><a id="__codelineno-14-15" name="__codelineno-14-15" href="#__codelineno-14-15"></a><span class="s">    name: ${gatewayName}</span>
-</span><span id="__span-14-16"><a id="__codelineno-14-16" name="__codelineno-14-16" href="#__codelineno-14-16"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-14-17"><a id="__codelineno-14-17" name="__codelineno-14-17" href="#__codelineno-14-17"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-14-18"><a id="__codelineno-14-18" name="__codelineno-14-18" href="#__codelineno-14-18"></a><span class="s">  providerRefs:</span>
-</span><span id="__span-14-19"><a id="__codelineno-14-19" name="__codelineno-14-19" href="#__codelineno-14-19"></a>
-</span><span id="__span-14-20"><a id="__codelineno-14-20" name="__codelineno-14-20" href="#__codelineno-14-20"></a><span class="s">  - name: aws-credentials</span>
-</span><span id="__span-14-21"><a id="__codelineno-14-21" name="__codelineno-14-21" href="#__codelineno-14-21"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>NOTE:  The <code>DNSPolicy</code> will use the DNS Provider <code>Secret</code> that you defined earlier.</p>
-<p>Check that your <code>DNSPolicy</code> has been accepted as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>dnspolicy<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span>-dnspolicy<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Accepted&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<h4 id="create-an-http-route">Create an HTTP route<a class="headerlink" href="#create-an-http-route" title="Permanent link">&para;</a></h4>
-<p>Create an <code>HTTPRoute</code> for your Gateway as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-16-4"><a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="s">metadata:</span>
-</span><span id="__span-16-5"><a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a><span class="s">  name: test</span>
-</span><span id="__span-16-6"><a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a><span class="s">  namespace: ${gatewayNS}</span>
-</span><span id="__span-16-7"><a id="__codelineno-16-7" name="__codelineno-16-7" href="#__codelineno-16-7"></a><span class="s">spec:</span>
-</span><span id="__span-16-8"><a id="__codelineno-16-8" name="__codelineno-16-8" href="#__codelineno-16-8"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-16-9"><a id="__codelineno-16-9" name="__codelineno-16-9" href="#__codelineno-16-9"></a>
-</span><span id="__span-16-10"><a id="__codelineno-16-10" name="__codelineno-16-10" href="#__codelineno-16-10"></a><span class="s">  - name: ${gatewayName}</span>
-</span><span id="__span-16-11"><a id="__codelineno-16-11" name="__codelineno-16-11" href="#__codelineno-16-11"></a><span class="s">    namespace: ${gatewayNS}</span>
-</span><span id="__span-16-12"><a id="__codelineno-16-12" name="__codelineno-16-12" href="#__codelineno-16-12"></a><span class="s">  hostnames:</span>
-</span><span id="__span-16-13"><a id="__codelineno-16-13" name="__codelineno-16-13" href="#__codelineno-16-13"></a><span class="s">  - &quot;test.${rootDomain}&quot;</span>
-</span><span id="__span-16-14"><a id="__codelineno-16-14" name="__codelineno-16-14" href="#__codelineno-16-14"></a><span class="s">  rules:</span>
-</span><span id="__span-16-15"><a id="__codelineno-16-15" name="__codelineno-16-15" href="#__codelineno-16-15"></a><span class="s">  - backendRefs:</span>
-</span><span id="__span-16-16"><a id="__codelineno-16-16" name="__codelineno-16-16" href="#__codelineno-16-16"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-16-17"><a id="__codelineno-16-17" name="__codelineno-16-17" href="#__codelineno-16-17"></a><span class="s">      port: 80</span>
-</span><span id="__span-16-18"><a id="__codelineno-16-18" name="__codelineno-16-18" href="#__codelineno-16-18"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Check your Gateway policies are enforced as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>dnspolicy<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span>-dnspolicy<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Enforced&quot;)].message}&#39;</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a>kubectl<span class="w"> </span>get<span class="w"> </span>authpolicy<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span>-auth<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Enforced&quot;)].message}&#39;</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a>kubectl<span class="w"> </span>get<span class="w"> </span>ratelimitpolicy<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span>-rlp<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions[?(@.type==&quot;Enforced&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<p>Check your listener is ready as follows:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kubectl get gateway ${gatewayName} -n ${gatewayNS} -o=jsonpath=&#39;{.status.listeners[0].conditions[?(@.type==&quot;Programmed&quot;)].message}&#39;
-</span></code></pre></div>
-<h3 id="step-6-test-connectivity-and-deny-all-auth">Step 6 - Test connectivity and deny all auth<a class="headerlink" href="#step-6-test-connectivity-and-deny-all-auth" title="Permanent link">&para;</a></h3>
-<p>You can use <code>curl</code> to hit your endpoint. You should see a <code>403</code>. Because this example uses Let's Encrypt staging, you can pass the <code>-k</code> flag:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>curl<span class="w"> </span>-k<span class="w"> </span>-w<span class="w"> </span><span class="s2">&quot;%{http_code}&quot;</span><span class="w"> </span>https://<span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span><span class="nb">test</span><span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span>
-</span></code></pre></div>
-<h3 id="step-7-opening-up-the-gateway-for-other-namespaces">Step 7 - Opening up the Gateway for other namespaces<a class="headerlink" href="#step-7-opening-up-the-gateway-for-other-namespaces" title="Permanent link">&para;</a></h3>
-<p>Because you have configured the Gateway, secured it with Kuadrant policies, and tested it, you can now open it up for use by other teams in other namespaces:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>kubectl<span class="w"> </span>patch<span class="w"> </span>gateway<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span><span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span><span class="w"> </span>--type<span class="o">=</span><span class="s1">&#39;json&#39;</span><span class="w"> </span>-p<span class="o">=</span><span class="s1">&#39;[{&quot;op&quot;: &quot;replace&quot;, &quot;path&quot;: &quot;/spec/listeners/0/allowedRoutes/namespaces/from&quot;, &quot;value&quot;:&quot;All&quot;}]&#39;</span>
-</span></code></pre></div>
-<h3 id="step-8-extending-this-gateway-to-multiple-clusters-and-configuring-geo-based-routing">Step 8 - Extending this Gateway to multiple clusters and configuring geo-based routing<a class="headerlink" href="#step-8-extending-this-gateway-to-multiple-clusters-and-configuring-geo-based-routing" title="Permanent link">&para;</a></h3>
-<p>To distribute this Gateway across multiple clusters, repeat this setup process for each cluster. By default, this will implement a round-robin DNS strategy to distribute traffic evenly across the different clusters. Setting up your Gateways to serve clients based on their geographic location is straightforward with your current configuration.</p>
-<p>Assuming that you have deployed Gateway instances across multiple clusters as per this guide, the next step involves updating the DNS controller with the geographic regions of the visible Gateways.</p>
-<p>For instance, if you have one cluster in North America and another in the EU, you can direct traffic to these Gateways based on their location by applying the appropriate labels:</p>
-<p>For your North American cluster, enter the following command:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>kubectl<span class="w"> </span>label<span class="w"> </span>--overwrite<span class="w"> </span>gateway<span class="w"> </span><span class="si">${</span><span class="nv">gatewayName</span><span class="si">}</span><span class="w"> </span>kuadrant.io/lb-attribute-geo-code<span class="o">=</span>US<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">gatewayNS</span><span class="si">}</span>
-</span></code></pre></div>
-<h2 id="application-developer-workflow">Application developer workflow<a class="headerlink" href="#application-developer-workflow" title="Permanent link">&para;</a></h2>
-<p>This section of the walkthrough focuses on using an OpenAPI Specification (OAS) to define an API. You will use Kuadrant OAS extensions to specify the routing, authentication, and rate limiting requirements. Next, you will use the <code>kuadrantctl</code> tool to generate an <code>AuthPolicy</code>, an <code>HTTPRoute</code>, and a <code>RateLimitPolicy</code>, which you will then apply to your cluster to enforce the settings defined in your OAS.</p>
-<p>NOTE: While this section uses the <code>kuadrantctl</code> tool, this is not essential. You can also create and apply an <code>AuthPolicy</code>, <code>RateLimitPolicy</code>, and <code>HTTPRoute</code> by using the <code>oc</code> or <code>kubectl</code> commands.</p>
-<h3 id="prerequisites_1">Prerequisites<a class="headerlink" href="#prerequisites_1" title="Permanent link">&para;</a></h3>
-<ul>
-<li>You have installed <code>kuadrantctl</code>. You can find a compatible binary and download it from the <a href="https://github.com/Kuadrant/kuadrantctl/releases/tag/v0.2.2">kuadrantctl releases page</a>.</li>
-<li>You have the ability to distribute resources generated by <code>kuadrantctl</code> to multiple clusters, as though you are a platform engineer.</li>
-</ul>
-<h3 id="step-1-deploy-the-toystore-app">Step 1 - Deploy the toystore app<a class="headerlink" href="#step-1-deploy-the-toystore-app" title="Permanent link">&para;</a></h3>
-<p>To begin, deploy a new version of the <code>toystore</code> app to a developer namespace as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/Kuadrant-operator/main/examples/toystore/toystore.yaml<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span>
-</span></code></pre></div>
-<h3 id="step-2-set-up-httproute-and-backend">Step 2 - Set up HTTPRoute and backend<a class="headerlink" href="#step-2-set-up-httproute-and-backend" title="Permanent link">&para;</a></h3>
-<p>Copy at least one of the following example OAS to a local location:</p>
-<ul>
-<li>
-<p><a href="../../../examples/oas-apikey.yaml">Sample OAS for rate limiting with API key</a></p>
-</li>
-<li>
-<p><a href="../../../examples/oas-oidc.yaml">Sample OAS for rate limiting with OIDC</a></p>
-</li>
-</ul>
-<p>Set up some new environment variables as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">oasPath</span><span class="o">=</span>examples/oas-apikey.yaml
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a><span class="c1"># Ensure you still have these environment variables setup from the start of this guide:</span>
-</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">rootDomain</span><span class="o">=</span>example.com
-</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a><span class="nb">export</span><span class="w"> </span><span class="nv">gatewayNS</span><span class="o">=</span>api-gateway
-</span></code></pre></div>
-<h3 id="step-3-use-oas-to-define-your-httproute-rules">Step 3 - Use OAS to define your HTTPRoute rules<a class="headerlink" href="#step-3-use-oas-to-define-your-httproute-rules" title="Permanent link">&para;</a></h3>
-<p>You can generate Kuadrant and Gateway API resources directly from OAS documents by using an <code>x-kuadrant</code> extension.</p>
-<p>NOTE: For a more in-depth look at the OAS extension, see the <a href="https://docs.kuadrant.io/latest/kuadrantctl/">kuadrantctl documentation</a>.</p>
-<p>You will use <code>kuadrantctl</code> to generate your <code>HTTPRoute</code>.</p>
-<p>NOTE: The sample OAS has some placeholders for namespaces and domains. You will inject valid values into these placeholders based on your previous environment variables.</p>
-<p>Generate the resource from your OAS as follows, (<code>envsubst</code> will replace the placeholders):</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>cat<span class="w"> </span><span class="nv">$oasPath</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>envsubst<span class="w"> </span><span class="p">|</span><span class="w"> </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>gatewayapi<span class="w"> </span>httproute<span class="w"> </span>--oas<span class="w"> </span>-<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-25-1"><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span>yaml
-</span></code></pre></div>
-<p>You should see that this route is affected by the <code>AuthPolicy</code> and <code>RateLimitPolicy</code> defined as defaults on the Gateway in the Gateway namespace.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-26-1"><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-04-26T13:37:43Z&quot;</span>
-</span><span id="__span-26-2"><a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Object affected by AuthPolicy demo/external</span>
-</span><span id="__span-26-3"><a id="__codelineno-26-3" name="__codelineno-26-3" href="#__codelineno-26-3"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-26-4"><a id="__codelineno-26-4" name="__codelineno-26-4" href="#__codelineno-26-4"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Accepted</span>
-</span><span id="__span-26-5"><a id="__codelineno-26-5" name="__codelineno-26-5" href="#__codelineno-26-5"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-26-6"><a id="__codelineno-26-6" name="__codelineno-26-6" href="#__codelineno-26-6"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/AuthPolicyAffected</span>
-</span><span id="__span-26-7"><a id="__codelineno-26-7" name="__codelineno-26-7" href="#__codelineno-26-7"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">lastTransitionTime</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-04-26T14:07:28Z&quot;</span>
-</span><span id="__span-26-8"><a id="__codelineno-26-8" name="__codelineno-26-8" href="#__codelineno-26-8"></a><span class="w">        </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Object affected by RateLimitPolicy demo/external</span>
-</span><span id="__span-26-9"><a id="__codelineno-26-9" name="__codelineno-26-9" href="#__codelineno-26-9"></a><span class="w">        </span><span class="nt">observedGeneration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-26-10"><a id="__codelineno-26-10" name="__codelineno-26-10" href="#__codelineno-26-10"></a><span class="w">        </span><span class="nt">reason</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Accepted</span>
-</span><span id="__span-26-11"><a id="__codelineno-26-11" name="__codelineno-26-11" href="#__codelineno-26-11"></a><span class="w">        </span><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;True&quot;</span>
-</span><span id="__span-26-12"><a id="__codelineno-26-12" name="__codelineno-26-12" href="#__codelineno-26-12"></a><span class="w">        </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/RateLimitPolicyAffected</span><span class="w">        </span>
-</span></code></pre></div>
-<h3 id="step-4-test-connectivity-and-deny-all-auth">Step 4 - Test connectivity and deny-all auth<a class="headerlink" href="#step-4-test-connectivity-and-deny-all-auth" title="Permanent link">&para;</a></h3>
-<p>You can use <code>curl</code> to hit an endpoint in the toystore app. Because you are using Let's Encrypt staging in this example, you can pass the <code>-k</code> flag as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-27-1"><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>curl<span class="w"> </span>-s<span class="w"> </span>-k<span class="w"> </span>-o<span class="w"> </span>/dev/null<span class="w"> </span>-w<span class="w"> </span><span class="s2">&quot;%{http_code}&quot;</span><span class="w"> </span><span class="s2">&quot;https://</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span><span class="s2">/v1/toys&quot;</span>
-</span></code></pre></div>
-<p>You are getting a <code>403</code> because of the existing default, deny-all <code>AuthPolicy</code> applied at the Gateway. You can override this for your <code>HTTPRoute</code>.</p>
-<p>Choose one of the following options:</p>
-<ul>
-<li>API key auth flow</li>
-<li>OpenID Connect auth flow </li>
-</ul>
-<h3 id="step-5-set-up-api-key-auth-flow">Step 5 - Set up API key auth flow<a class="headerlink" href="#step-5-set-up-api-key-auth-flow" title="Permanent link">&para;</a></h3>
-<p>Set up an example API key in each cluster as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-28-1"><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-28-2"><a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-28-3"><a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-28-4"><a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a><span class="s">metadata:</span>
-</span><span id="__span-28-5"><a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a><span class="s">  name: toystore-api-key</span>
-</span><span id="__span-28-6"><a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a><span class="s">  namespace: ${devNS}</span>
-</span><span id="__span-28-7"><a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a><span class="s">  labels:</span>
-</span><span id="__span-28-8"><a id="__codelineno-28-8" name="__codelineno-28-8" href="#__codelineno-28-8"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-28-9"><a id="__codelineno-28-9" name="__codelineno-28-9" href="#__codelineno-28-9"></a><span class="s">    kuadrant.io/apikeys-by: api_key</span>
-</span><span id="__span-28-10"><a id="__codelineno-28-10" name="__codelineno-28-10" href="#__codelineno-28-10"></a><span class="s">stringData:</span>
-</span><span id="__span-28-11"><a id="__codelineno-28-11" name="__codelineno-28-11" href="#__codelineno-28-11"></a><span class="s">  api_key: secret</span>
-</span><span id="__span-28-12"><a id="__codelineno-28-12" name="__codelineno-28-12" href="#__codelineno-28-12"></a><span class="s">type: Opaque</span>
-</span><span id="__span-28-13"><a id="__codelineno-28-13" name="__codelineno-28-13" href="#__codelineno-28-13"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Next, generate an <code>AuthPolicy</code> that uses secrets in your cluster as API keys as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-29-1"><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a>cat<span class="w"> </span><span class="nv">$oasPath</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>envsubst<span class="w"> </span><span class="p">|</span><span class="w"> </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span>--oas<span class="w"> </span>-
-</span></code></pre></div>
-<p>From this, you can see an <code>AuthPolicy</code> generated based on your OAS that will look for API keys in secrets labeled <code>api_key</code> and look for that key in the header <code>api_key</code>. You can now apply this to the Gateway as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-30-1"><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a>cat<span class="w"> </span><span class="nv">$oasPath</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>envsubst<span class="w"> </span><span class="p">|</span><span class="w"> </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span>--oas<span class="w"> </span>-<span class="w">  </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div>
-<p>You should get a <code>200</code> from the following <code>GET</code> because it has no auth requirement:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-31-1"><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a>curl<span class="w"> </span>-s<span class="w"> </span>-k<span class="w"> </span>-o<span class="w"> </span>/dev/null<span class="w"> </span>-w<span class="w"> </span><span class="s2">&quot;%{http_code}&quot;</span><span class="w"> </span><span class="s2">&quot;https://</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span><span class="s2">/v1/toys&quot;</span>
-</span></code></pre></div>
-<p>You should get a <code>401</code> for the following <code>POST</code> request because it does not have any auth requirements:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-32-1"><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a>curl<span class="w"> </span>-XPOST<span class="w"> </span>-s<span class="w"> </span>-k<span class="w"> </span>-o<span class="w"> </span>/dev/null<span class="w"> </span>-w<span class="w"> </span><span class="s2">&quot;%{http_code}&quot;</span><span class="w"> </span><span class="s2">&quot;https://</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span><span class="s2">/v1/toys&quot;</span>
-</span></code></pre></div>
-<p>Finally, if you add your API key header, with a valid key as follows, you should get a <code>200</code> response:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-33-1"><a id="__codelineno-33-1" name="__codelineno-33-1" href="#__codelineno-33-1"></a>curl<span class="w"> </span>-XPOST<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;api_key: secret&#39;</span><span class="w"> </span>-s<span class="w"> </span>-k<span class="w"> </span>-o<span class="w"> </span>/dev/null<span class="w"> </span>-w<span class="w"> </span><span class="s2">&quot;%{http_code}&quot;</span><span class="w"> </span><span class="s2">&quot;https://</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span><span class="s2">/v1/toys&quot;</span>
-</span></code></pre></div>
-<h3 id="optional-step-6-set-up-openid-connect-auth-flow-skip-if-using-api-key-only">Optional: Step 6 - Set up OpenID Connect auth flow (skip if using API key only)<a class="headerlink" href="#optional-step-6-set-up-openid-connect-auth-flow-skip-if-using-api-key-only" title="Permanent link">&para;</a></h3>
-<p>This section of the walkthrough uses the <code>kuadrantctl</code> tool to create an <code>AuthPolicy</code> that integrates with an OpenID provider and a <code>RateLimitPolicy</code> that leverages JWT values for per-user rate limiting. It is important to note that OpenID requires an external provider. Therefore, you should adapt the following example to suit your specific needs and provider.</p>
-<p>The platform engineer workflow established default policies for authentication and rate limiting at your Gateway. The new developer-defined policies, which you will create, are intended to target your HTTPRoute and will supersede the existing policies for requests to your API endpoints, similar to your previous API key example.</p>
-<p>The example OAS uses Kuadrant-based extensions. These extensions enable you to define routing and service protection requirements. For more details, see <a href="https://docs.kuadrant.io/latest/kuadrantctl/doc/openapi-kuadrant-extensions/">OpenAPI Kuadrant extensions</a>.</p>
-<h4 id="prerequisites_2">Prerequisites<a class="headerlink" href="#prerequisites_2" title="Permanent link">&para;</a></h4>
-<ul>
-<li>You have installed and configured an OpenID Connect provider, such as <a href="https://www.keycloak.org/">https://www.keycloak.org/</a>. </li>
-<li>You have a realm, client, and users set up. This example assumes a realm in a Keycloak instance called <code>toystore</code>.</li>
-<li>Copy the OAS from <a href="../../../examples/oas-oidc.yaml">sample OAS for rate-limiting and OIDC</a> to a local location.</li>
-</ul>
-<h4 id="set-up-an-openid-authpolicy">Set up an OpenID AuthPolicy<a class="headerlink" href="#set-up-an-openid-authpolicy" title="Permanent link">&para;</a></h4>
-<p>Set the following environment variables:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-34-1"><a id="__codelineno-34-1" name="__codelineno-34-1" href="#__codelineno-34-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">openIDHost</span><span class="o">=</span>some.keycloak.com
-</span><span id="__span-34-2"><a id="__codelineno-34-2" name="__codelineno-34-2" href="#__codelineno-34-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">oasPath</span><span class="o">=</span>examples/oas-oidc.yaml
-</span></code></pre></div>
-<p>NOTE: The sample OAS has some placeholders for namespaces and domains. You will inject valid values into these placeholders based on your previous environment variables.</p>
-<p>You can use your OAS and <code>kuadrantctl</code> to generate an <code>AuthPolicy</code> to replace the default on the Gateway as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-35-1"><a id="__codelineno-35-1" name="__codelineno-35-1" href="#__codelineno-35-1"></a>cat<span class="w"> </span><span class="nv">$oasPath</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>envsubst<span class="w"> </span><span class="p">|</span><span class="w"> </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span>--oas<span class="w"> </span>-
-</span></code></pre></div>
-<p>If you are happy with the generated resource, you can apply it to the cluster as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-36-1"><a id="__codelineno-36-1" name="__codelineno-36-1" href="#__codelineno-36-1"></a>cat<span class="w"> </span><span class="nv">$oasPath</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>envsubst<span class="w"> </span><span class="p">|</span><span class="w"> </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span>--oas<span class="w"> </span>-<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div>
-<p>You should see in the status of the <code>AuthPolicy</code> that it has been accepted and enforced:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-37-1"><a id="__codelineno-37-1" name="__codelineno-37-1" href="#__codelineno-37-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>authpolicy<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>toystore<span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions}&#39;</span>
-</span></code></pre></div>
-<p>On your <code>HTTPRoute</code>, you should also see it now affected by this <code>AuthPolicy</code> in the toystore namespace:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-38-1"><a id="__codelineno-38-1" name="__codelineno-38-1" href="#__codelineno-38-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.parents[0].conditions[?(@.type==&quot;kuadrant.io/AuthPolicyAffected&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<h4 id="test-your-openid-authpolicy">Test your OpenID AuthPolicy<a class="headerlink" href="#test-your-openid-authpolicy" title="Permanent link">&para;</a></h4>
-<p>You can test your <code>AuthPolicy</code> as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-39-1"><a id="__codelineno-39-1" name="__codelineno-39-1" href="#__codelineno-39-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>curl<span class="w"> </span>-k<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Content-Type: application/x-www-form-urlencoded&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-39-2"><a id="__codelineno-39-2" name="__codelineno-39-2" href="#__codelineno-39-2"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-39-3"><a id="__codelineno-39-3" name="__codelineno-39-3" href="#__codelineno-39-3"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;client_id=toystore&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-39-4"><a id="__codelineno-39-4" name="__codelineno-39-4" href="#__codelineno-39-4"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-39-5"><a id="__codelineno-39-5" name="__codelineno-39-5" href="#__codelineno-39-5"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;username=bob&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-39-6"><a id="__codelineno-39-6" name="__codelineno-39-6" href="#__codelineno-39-6"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span><span class="s2">&quot;https://</span><span class="si">${</span><span class="nv">openIDHost</span><span class="si">}</span><span class="s2">/auth/realms/toystore/protocol/openid-connect/token&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span><span class="s1">&#39;.access_token&#39;</span><span class="k">)</span>
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-40-1"><a id="__codelineno-40-1" name="__codelineno-40-1" href="#__codelineno-40-1"></a>curl<span class="w"> </span>-k<span class="w"> </span>-XPOST<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span><span class="s2">&quot;https://</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span><span class="s2">/v1/toys&quot;</span>
-</span></code></pre></div>
-<p>You should see a <code>401</code> response code. Make a request with a valid bearer token as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-41-1"><a id="__codelineno-41-1" name="__codelineno-41-1" href="#__codelineno-41-1"></a>curl<span class="w"> </span>-k<span class="w"> </span>-XPOST<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span><span class="s2">&quot;https://</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span><span class="s2">/v1/toys&quot;</span>
-</span></code></pre></div>
-<p>You should see a <code>200</code> response code.</p>
-<h3 id="step-7-set-up-rate-limiting">Step 7 - Set up rate limiting<a class="headerlink" href="#step-7-set-up-rate-limiting" title="Permanent link">&para;</a></h3>
-<p>Lastly, you can generate your <code>RateLimitPolicy</code> to add your rate limits, based on your OAS file. Rate limiting is simplified for this walkthrough and is based on either the bearer token or the API key value. There are more advanced examples in the How-to guides on the Kuadrant documentation site, for example: <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/">Authenticated rate limiting with JWTs and Kubernetes RBAC</a>.</p>
-<p>You can continue to use this sample OAS document, which includes both authentication and a rate limit:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-42-1"><a id="__codelineno-42-1" name="__codelineno-42-1" href="#__codelineno-42-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">oasPath</span><span class="o">=</span>examples/oas-oidc.yaml
-</span></code></pre></div>
-<p>Again, you should see the rate limit policy accepted and enforced:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-43-1"><a id="__codelineno-43-1" name="__codelineno-43-1" href="#__codelineno-43-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>ratelimitpolicy<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>toystore<span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.conditions}&#39;</span>
-</span></code></pre></div>
-<p>On your <code>HTTRoute</code>, you should now see it is affected by the <code>RateLimitPolicy</code> in the same namespace:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-44-1"><a id="__codelineno-44-1" name="__codelineno-44-1" href="#__codelineno-44-1"></a>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.parents[0].conditions[?(@.type==&quot;kuadrant.io/RateLimitPolicyAffected&quot;)].message}&#39;</span>
-</span></code></pre></div>
-<h4 id="test-your-ratelimitpolicy">Test your RateLimitPolicy<a class="headerlink" href="#test-your-ratelimitpolicy" title="Permanent link">&para;</a></h4>
-<p>You can now test your rate limiting as follows:</p>
-<p>NOTE: You might need to wait a minute for the new rate limits to be applied. With the following requests, you should see a number of 429 responses.</p>
-<h5 id="api-key-auth">API Key auth<a class="headerlink" href="#api-key-auth" title="Permanent link">&para;</a></h5>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-45-1"><a id="__codelineno-45-1" name="__codelineno-45-1" href="#__codelineno-45-1"></a><span class="k">for</span><span class="w"> </span>i<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="o">{</span><span class="m">1</span>..3<span class="o">}</span>
-</span><span id="__span-45-2"><a id="__codelineno-45-2" name="__codelineno-45-2" href="#__codelineno-45-2"></a><span class="k">do</span>
-</span><span id="__span-45-3"><a id="__codelineno-45-3" name="__codelineno-45-3" href="#__codelineno-45-3"></a><span class="nb">printf</span><span class="w"> </span><span class="s2">&quot;request </span><span class="nv">$i</span><span class="s2"> &quot;</span>
-</span><span id="__span-45-4"><a id="__codelineno-45-4" name="__codelineno-45-4" href="#__codelineno-45-4"></a>curl<span class="w"> </span>-XPOST<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;api_key:secret&#39;</span><span class="w"> </span>-s<span class="w"> </span>-k<span class="w"> </span>-o<span class="w"> </span>/dev/null<span class="w"> </span>-w<span class="w"> </span><span class="s2">&quot;%{http_code}&quot;</span><span class="w">  </span><span class="s2">&quot;https://</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span><span class="w"> </span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span><span class="s2">/v1/toys&quot;</span>
-</span><span id="__span-45-5"><a id="__codelineno-45-5" name="__codelineno-45-5" href="#__codelineno-45-5"></a><span class="nb">printf</span><span class="w"> </span><span class="s2">&quot;\n -- \n&quot;</span>
-</span><span id="__span-45-6"><a id="__codelineno-45-6" name="__codelineno-45-6" href="#__codelineno-45-6"></a><span class="k">done</span><span class="w"> </span>
-</span></code></pre></div>
-<h5 id="openid-connect-auth">OpenID Connect auth<a class="headerlink" href="#openid-connect-auth" title="Permanent link">&para;</a></h5>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-46-1"><a id="__codelineno-46-1" name="__codelineno-46-1" href="#__codelineno-46-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ACCESS_TOKEN</span><span class="o">=</span><span class="k">$(</span>curl<span class="w"> </span>-k<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Content-Type: application/x-www-form-urlencoded&quot;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-46-2"><a id="__codelineno-46-2" name="__codelineno-46-2" href="#__codelineno-46-2"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;grant_type=password&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-46-3"><a id="__codelineno-46-3" name="__codelineno-46-3" href="#__codelineno-46-3"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;client_id=toystore&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-46-4"><a id="__codelineno-46-4" name="__codelineno-46-4" href="#__codelineno-46-4"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;scope=openid&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-46-5"><a id="__codelineno-46-5" name="__codelineno-46-5" href="#__codelineno-46-5"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;username=bob&#39;</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-46-6"><a id="__codelineno-46-6" name="__codelineno-46-6" href="#__codelineno-46-6"></a><span class="w">        </span>-d<span class="w"> </span><span class="s1">&#39;password=p&#39;</span><span class="w"> </span><span class="s2">&quot;https://</span><span class="si">${</span><span class="nv">openIDHost</span><span class="si">}</span><span class="s2">/auth/realms/toystore/protocol/openid-connect/token&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span><span class="s1">&#39;.access_token&#39;</span><span class="k">)</span>
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-47-1"><a id="__codelineno-47-1" name="__codelineno-47-1" href="#__codelineno-47-1"></a><span class="k">for</span><span class="w"> </span>i<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="o">{</span><span class="m">1</span>..3<span class="o">}</span>
-</span><span id="__span-47-2"><a id="__codelineno-47-2" name="__codelineno-47-2" href="#__codelineno-47-2"></a><span class="k">do</span>
-</span><span id="__span-47-3"><a id="__codelineno-47-3" name="__codelineno-47-3" href="#__codelineno-47-3"></a>curl<span class="w"> </span>-k<span class="w"> </span>-XPOST<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>https://<span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>httproute<span class="w"> </span>toystore<span class="w"> </span>-n<span class="w"> </span><span class="si">${</span><span class="nv">devNS</span><span class="si">}</span>-o<span class="o">=</span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.hostnames[0]}&#39;</span><span class="k">)</span>/v1/toys
-</span><span id="__span-47-4"><a id="__codelineno-47-4" name="__codelineno-47-4" href="#__codelineno-47-4"></a><span class="k">done</span>
-</span></code></pre></div>
-<h2 id="conclusion">Conclusion<a class="headerlink" href="#conclusion" title="Permanent link">&para;</a></h2>
-<p>You have completed the secure, protect, and connect walkthrough. To learn more about Kuadrant, visit <a href="https://docs.kuadrant.io">https://docs.kuadrant.io</a>.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect/index.html b/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect/index.html
deleted file mode 100644
index 0e81d7faf..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect/index.html
+++ /dev/null
@@ -1,3968 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect/">
-      
-      
-        <link rel="prev" href="../../reference/ratelimitpolicy/">
-      
-      
-        <link rel="next" href="../secure-protect-connect-single-multi-cluster/">
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Secure, connect and protect - Kubernetes - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#secure-protect-and-connect-services-with-kuadrant-on-kubernetes" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Secure, connect and protect - Kubernetes
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Overview">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#deploy-the-example-app-we-will-serve-via-our-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Deploy the example app we will serve via our gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-a-new-istio-managed-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Define a new Istio-managed gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-the-tlspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Define the TLSPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-infrastructure-rate-limiting" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Define Infrastructure Rate Limiting
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-the-gateway-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Define the Gateway AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-the-dnspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Define the DNSPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#override-the-gateways-deny-all-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Override the Gateway's deny-all AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#override-the-gateways-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Override the Gateway's RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Overview">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#deploy-the-example-app-we-will-serve-via-our-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❶ Deploy the example app we will serve via our gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-a-new-istio-managed-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❷ Define a new Istio-managed gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-the-tlspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❸ Define the TLSPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-infrastructure-rate-limiting" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❹ Define Infrastructure Rate Limiting
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-the-gateway-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❺ Define the Gateway AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#define-the-dnspolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❻ Define the DNSPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#override-the-gateways-deny-all-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❼ Override the Gateway's deny-all AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#override-the-gateways-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      ❽ Override the Gateway's RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/secure-protect-connect.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="secure-protect-and-connect-services-with-kuadrant-on-kubernetes">Secure, protect, and connect services with Kuadrant on Kubernetes<a class="headerlink" href="#secure-protect-and-connect-services-with-kuadrant-on-kubernetes" title="Permanent link">&para;</a></h1>
-<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li>You have completed the <a href="https://docs.kuadrant.io/latest/getting-started-single-cluster/">Single-cluster Quick Start</a> or <a href="https://docs.kuadrant.io/latest/getting-started-multi-cluster/">Multi-cluster Quick Start</a>.</li>
-</ul>
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>In this guide, we will cover the different policies from Kuadrant and how you can use them to secure, protect and connect an Istio-controlled gateway in a single cluster, and how you can set more refined protection on the HTTPRoutes exposed by that gateway.</p>
-<p>Here are the steps we will go through:</p>
-<p>1) <a href="#deploy-the-example-app-we-will-serve-via-our-gateway">Deploy a sample application</a></p>
-<p>2) <a href="#define-a-new-istio-managed-gateway">Define a new Gateway</a></p>
-<p>3) <a href="#define-the-tlspolicy">Ensure TLS-based secure connectivity to the gateway with a TLSPolicy</a></p>
-<p>4) <a href="#define-infrastructure-rate-limiting">Define a default RateLimitPolicy to set some infrastructure limits on your gateway</a></p>
-<p>5) <a href="#define-the-gateway-authpolicy">Define a default AuthPolicy to deny all access to the gateway</a></p>
-<p>6) <a href="#define-the-dnspolicy">Define a DNSPolicy to bring traffic to the gateway</a></p>
-<p>7) <a href="#override-the-gateways-deny-all-authpolicy">Override the Gateway's deny-all AuthPolicy with an endpoint-specific policy</a></p>
-<p>8) <a href="#override-the-gateways-ratelimitpolicy">Override the Gateway rate limits with an endpoint-specific policy</a></p>
-<p>You will need to set the <code>KUBECTL_CONTEXT</code> environment variable for the kubectl context of the cluster you are targeting.
-If you have followed the single cluster setup, it should be something like below.
-Adjust the name of the cluster accordingly to match the kubernetes cluster you are targeting.
-You can get the current context with <code>kubectl config current-context</code></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="c1"># Typical single cluster context</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">KUBECTL_CONTEXT</span><span class="o">=</span>kind-kuadrant-local
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="c1"># Example context for additional &#39;multi cluster&#39; clusters</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="c1"># export KUBECTL_CONTEXT=kind-kuadrant-local-1</span>
-</span></code></pre></div>
-<p>To help with this walk through, you should also set a <code>KUADRANT_ZONE_ROOT_DOMAIN</code> environment variable to a domain you want to use. If you want to try DNSPolicy, this should also be a domain you have access to the DNS for in AWS Route53 or GCP. E.g.:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">KUADRANT_ZONE_ROOT_DOMAIN</span><span class="o">=</span>my.domain.iown
-</span></code></pre></div>
-<h3 id="deploy-the-example-app-we-will-serve-via-our-gateway">❶ Deploy the example app we will serve via our gateway<a class="headerlink" href="#deploy-the-example-app-we-will-serve-via-our-gateway" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/examples/toystore/toystore.yaml
-</span></code></pre></div>
-<h3 id="define-a-new-istio-managed-gateway">❷ Define a new Istio-managed gateway<a class="headerlink" href="#define-a-new-istio-managed-gateway" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="s">kind: Gateway</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="s">metadata:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="s">  name: api-gateway</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="s">spec:</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="s">  gatewayClassName: istio</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="s">  listeners:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="s">  - allowedRoutes:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="s">      namespaces:</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="s">        from: All</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="s">    name: api</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="s">    hostname: &quot;*.$KUADRANT_ZONE_ROOT_DOMAIN&quot;</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="s">    port: 443</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="s">    protocol: HTTPS</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="s">    tls:</span>
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="s">      mode: Terminate</span>
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="s">      certificateRefs:</span>
-</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="s">        - name: apps-hcpapps-tls</span>
-</span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a><span class="s">          kind: Secret</span>
-</span><span id="__span-3-23"><a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>If you take a look at the gateway status, you will see a TLS status error similar to the following:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>message: invalid certificate reference /Secret/apps-hcpapps-tls. secret kuadrant-system/apps-hcpapps-tls not found
-</span></code></pre></div>
-<p>This is because currently there is not a TLS secret in place. Let's fix that by creating a TLSPolicy.</p>
-<h3 id="define-the-tlspolicy">❸ Define the TLSPolicy<a class="headerlink" href="#define-the-tlspolicy" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: kuadrant.io/v1alpha1</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: TLSPolicy</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  name: api-gateway-tls</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">spec:</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">  targetRef:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="s">    name: api-gateway</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="s">  issuerRef:</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">    group: cert-manager.io</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="s">    kind: ClusterIssuer</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="s">    name: kuadrant-operator-glbc-ca</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> You may have to create a cluster issuer in the Kubernetes cluster, depending on if one was created during your initial cluster setup or not. Here is an example of how to create a self-signed CA as a cluster issuer.</p>
-</blockquote>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="s">apiVersion: cert-manager.io/v1</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="s">kind: ClusterIssuer</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="s">metadata:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="s">  name: kuadrant-operator-glbc-ca</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="s">spec:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="s">  selfSigned: {}</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>The TLSPolicy should eventually have an <code>Accepted</code> condition.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span><span class="nb">wait</span><span class="w"> </span>tlspolicy<span class="w"> </span>api-gateway-tls<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>--for<span class="o">=</span><span class="nv">condition</span><span class="o">=</span>accepted
-</span></code></pre></div>
-<p>Now, if you look at the status of the gateway, you will see the error is gone, and the status of the policy will report the listener as now secured with a TLS certificate and the gateway as affected by the TLS policy.</p>
-<p>Our communication with our gateway is now secured via TLS. Note that any new listeners will also be handled by the TLSPolicy.</p>
-<p>Let's define a HTTPRoute and test our policy. We will re-use this later on with some of the other policies as well.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1beta1</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="s">metadata:</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="s">  labels:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="s">    deployment: toystore</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="s">    service: toystore</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="s">spec:</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a>
-</span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="s">  - name: api-gateway</span>
-</span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="s">    namespace: kuadrant-system</span>
-</span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="s">  hostnames:</span>
-</span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="s">  - &quot;api.$KUADRANT_ZONE_ROOT_DOMAIN&quot;</span>
-</span><span id="__span-8-16"><a id="__codelineno-8-16" name="__codelineno-8-16" href="#__codelineno-8-16"></a><span class="s">  rules:</span>
-</span><span id="__span-8-17"><a id="__codelineno-8-17" name="__codelineno-8-17" href="#__codelineno-8-17"></a><span class="s">  - matches:</span>
-</span><span id="__span-8-18"><a id="__codelineno-8-18" name="__codelineno-8-18" href="#__codelineno-8-18"></a><span class="s">    - method: GET</span>
-</span><span id="__span-8-19"><a id="__codelineno-8-19" name="__codelineno-8-19" href="#__codelineno-8-19"></a><span class="s">      path:</span>
-</span><span id="__span-8-20"><a id="__codelineno-8-20" name="__codelineno-8-20" href="#__codelineno-8-20"></a><span class="s">        type: PathPrefix</span>
-</span><span id="__span-8-21"><a id="__codelineno-8-21" name="__codelineno-8-21" href="#__codelineno-8-21"></a><span class="s">        value: &quot;/cars&quot;</span>
-</span><span id="__span-8-22"><a id="__codelineno-8-22" name="__codelineno-8-22" href="#__codelineno-8-22"></a><span class="s">    - method: GET</span>
-</span><span id="__span-8-23"><a id="__codelineno-8-23" name="__codelineno-8-23" href="#__codelineno-8-23"></a><span class="s">      path:</span>
-</span><span id="__span-8-24"><a id="__codelineno-8-24" name="__codelineno-8-24" href="#__codelineno-8-24"></a><span class="s">        type: PathPrefix</span>
-</span><span id="__span-8-25"><a id="__codelineno-8-25" name="__codelineno-8-25" href="#__codelineno-8-25"></a><span class="s">        value: &quot;/dolls&quot;</span>
-</span><span id="__span-8-26"><a id="__codelineno-8-26" name="__codelineno-8-26" href="#__codelineno-8-26"></a><span class="s">    backendRefs:</span>
-</span><span id="__span-8-27"><a id="__codelineno-8-27" name="__codelineno-8-27" href="#__codelineno-8-27"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-8-28"><a id="__codelineno-8-28" name="__codelineno-8-28" href="#__codelineno-8-28"></a><span class="s">      port: 80</span>
-</span><span id="__span-8-29"><a id="__codelineno-8-29" name="__codelineno-8-29" href="#__codelineno-8-29"></a><span class="s">  - matches:</span>
-</span><span id="__span-8-30"><a id="__codelineno-8-30" name="__codelineno-8-30" href="#__codelineno-8-30"></a><span class="s">    - path:</span>
-</span><span id="__span-8-31"><a id="__codelineno-8-31" name="__codelineno-8-31" href="#__codelineno-8-31"></a><span class="s">        type: PathPrefix</span>
-</span><span id="__span-8-32"><a id="__codelineno-8-32" name="__codelineno-8-32" href="#__codelineno-8-32"></a><span class="s">        value: &quot;/admin&quot;</span>
-</span><span id="__span-8-33"><a id="__codelineno-8-33" name="__codelineno-8-33" href="#__codelineno-8-33"></a><span class="s">    backendRefs:</span>
-</span><span id="__span-8-34"><a id="__codelineno-8-34" name="__codelineno-8-34" href="#__codelineno-8-34"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-8-35"><a id="__codelineno-8-35" name="__codelineno-8-35" href="#__codelineno-8-35"></a><span class="s">      port: 80</span>
-</span><span id="__span-8-36"><a id="__codelineno-8-36" name="__codelineno-8-36" href="#__codelineno-8-36"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>With this HTTPRoute in place, the service we deployed is exposed via the gateway. We should be able to access our endpoint via HTTPS:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_HOST</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>api-gateway<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.addresses[0].value}&#39;</span><span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="k">)</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>curl<span class="w"> </span>-k<span class="w"> </span>--resolve<span class="w"> </span>api.<span class="si">${</span><span class="nv">KUADRANT_ZONE_ROOT_DOMAIN</span><span class="si">}</span>:443:<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="w"> </span><span class="s2">&quot;https://api.</span><span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span><span class="s2">/cars&quot;</span>
-</span></code></pre></div>
-<h3 id="define-infrastructure-rate-limiting">❹ Define Infrastructure Rate Limiting<a class="headerlink" href="#define-infrastructure-rate-limiting" title="Permanent link">&para;</a></h3>
-<p>We have a secure communication in place. However, there is nothing limiting users from overloading our infrastructure and service components that will sit behind this gateway. Let's add a rate limiting layer to protect our services and infrastructure.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">kind: RateLimitPolicy</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">metadata:</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">  name: infra-ratelimit</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">spec:</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="s">  targetRef:</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">    name: api-gateway</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">  limits:</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">    &quot;global&quot;:</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">      rates:</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a>
-</span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="s">      - limit: 5</span>
-</span><span id="__span-10-17"><a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a><span class="s">        duration: 10</span>
-</span><span id="__span-10-18"><a id="__codelineno-10-18" name="__codelineno-10-18" href="#__codelineno-10-18"></a><span class="s">        unit: second</span>
-</span><span id="__span-10-19"><a id="__codelineno-10-19" name="__codelineno-10-19" href="#__codelineno-10-19"></a><span class="s">EOF</span>
-</span><span id="__span-10-20"><a id="__codelineno-10-20" name="__codelineno-10-20" href="#__codelineno-10-20"></a>
-</span><span id="__span-10-21"><a id="__codelineno-10-21" name="__codelineno-10-21" href="#__codelineno-10-21"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span><span class="nb">wait</span><span class="w"> </span>ratelimitpolicy<span class="w"> </span>infra-ratelimit<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>--for<span class="o">=</span><span class="nv">condition</span><span class="o">=</span>accepted
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p>
-</blockquote>
-<p>The limit here is artificially low in order for us to show it working easily. Let's test it with our endpoint:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="k">for</span><span class="w"> </span>i<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="o">{</span><span class="m">1</span>..10<span class="o">}</span><span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>-k<span class="w"> </span>--resolve<span class="w"> </span>api.<span class="si">${</span><span class="nv">KUADRANT_ZONE_ROOT_DOMAIN</span><span class="si">}</span>:443:<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="w"> </span><span class="s2">&quot;https://api.</span><span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span><span class="s2">/cars&quot;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<p>We should see <code>409 Too Many Requests</code>s start returning after the 5th request.</p>
-<h3 id="define-the-gateway-authpolicy">❺ Define the Gateway AuthPolicy<a class="headerlink" href="#define-the-gateway-authpolicy" title="Permanent link">&para;</a></h3>
-<p>Communication is secured and we have some protection for our infrastructure, but we do not trust any client to access our endpoints. By default, we want to allow only authenticated access. To protect our gateway, we will add a <em>deny-all</em> AuthPolicy. Later, we will override this with a more specific AuthPolicy for the API.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="s">kind: AuthPolicy</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="s">metadata:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="s">  name: deny-all</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="s">spec:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="s">  targetRef:</span>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="s">    name: api-gateway</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="s">  rules:</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="s">    authorization:</span>
-</span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="s">      deny-all:</span>
-</span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a><span class="s">        opa:</span>
-</span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="s">          rego: &quot;allow = false&quot;</span>
-</span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="s">    response:</span>
-</span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="s">      unauthorized:</span>
-</span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a><span class="s">        headers:</span>
-</span><span id="__span-12-20"><a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a><span class="s">          &quot;content-type&quot;:</span>
-</span><span id="__span-12-21"><a id="__codelineno-12-21" name="__codelineno-12-21" href="#__codelineno-12-21"></a><span class="s">            value: application/json</span>
-</span><span id="__span-12-22"><a id="__codelineno-12-22" name="__codelineno-12-22" href="#__codelineno-12-22"></a><span class="s">        body:</span>
-</span><span id="__span-12-23"><a id="__codelineno-12-23" name="__codelineno-12-23" href="#__codelineno-12-23"></a><span class="s">          value: |</span>
-</span><span id="__span-12-24"><a id="__codelineno-12-24" name="__codelineno-12-24" href="#__codelineno-12-24"></a><span class="s">            {</span>
-</span><span id="__span-12-25"><a id="__codelineno-12-25" name="__codelineno-12-25" href="#__codelineno-12-25"></a><span class="s">              &quot;error&quot;: &quot;Forbidden&quot;,</span>
-</span><span id="__span-12-26"><a id="__codelineno-12-26" name="__codelineno-12-26" href="#__codelineno-12-26"></a><span class="s">              &quot;message&quot;: &quot;Access denied by default by the gateway operator. If you are the administrator of the service, create a specific auth policy for the route.&quot;</span>
-</span><span id="__span-12-27"><a id="__codelineno-12-27" name="__codelineno-12-27" href="#__codelineno-12-27"></a><span class="s">            }</span>
-</span><span id="__span-12-28"><a id="__codelineno-12-28" name="__codelineno-12-28" href="#__codelineno-12-28"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Let's test it again. This time we expect a <code>403 Forbidden</code>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl<span class="w"> </span>-k<span class="w"> </span>--resolve<span class="w"> </span>api.<span class="si">${</span><span class="nv">KUADRANT_ZONE_ROOT_DOMAIN</span><span class="si">}</span>:443:<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="w">  </span><span class="s2">&quot;https://api.</span><span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span><span class="s2">/cars&quot;</span>
-</span></code></pre></div>
-<h3 id="define-the-dnspolicy">❻ Define the DNSPolicy<a class="headerlink" href="#define-the-dnspolicy" title="Permanent link">&para;</a></h3>
-<p>(Skip this step if you did not configure a DNS provider during the setup.)</p>
-<p>Now, we have our gateway protected and communications secured. We are ready to configure DNS, so it is easy for clients to connect and access the APIs we intend to expose via this gateway.</p>
-<blockquote>
-<p><strong>Note:</strong> You may need to create a DNS Provider Secret resource depending on if one was created during your initial cluster setup or not. You should have an <code>aws-credentials</code> Secret already created in the <code>kuadrant-system</code> namespace. However, if it doesn't exist, you can follow these commands to create one:</p>
-</blockquote>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span>xxxxxxx<span class="w"> </span><span class="c1"># Key ID from AWS with Route 53 access</span>
-</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span>xxxxxxx<span class="w"> </span><span class="c1"># Access key from AWS with Route 53 access</span>
-</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>
-</span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>aws-credentials<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="w">  </span>--type<span class="o">=</span>kuadrant.io/aws<span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_ACCESS_KEY_ID</span><span class="o">=</span><span class="nv">$AWS_ACCESS_KEY_ID</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="w">  </span>--from-literal<span class="o">=</span><span class="nv">AWS_SECRET_ACCESS_KEY</span><span class="o">=</span><span class="nv">$AWS_SECRET_ACCESS_KEY</span>
-</span></code></pre></div>
-<p>Next, create the DNSPolicy:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="s">apiVersion: kuadrant.io/v1alpha1</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="s">kind: DNSPolicy</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="s">metadata:</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="s">  name: simple-dnspolicy</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="s">  namespace: kuadrant-system</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="s">spec:</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="s">  routingStrategy: simple</span>
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="s">  targetRef:</span>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="s">    name: api-gateway</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="s">    kind: Gateway</span>
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="s">  providerRefs:</span>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a>
-</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="s">  - name: aws-credentials</span>
-</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="s">EOF</span>
-</span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a>
-</span><span id="__span-15-18"><a id="__codelineno-15-18" name="__codelineno-15-18" href="#__codelineno-15-18"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span><span class="nb">wait</span><span class="w"> </span>dnspolicy<span class="w"> </span>simple-dnspolicy<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>--for<span class="o">=</span><span class="nv">condition</span><span class="o">=</span>enforced
-</span></code></pre></div>
-<p>If you want to see the DNSRecord created by the this policy, execute the following command:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>get<span class="w"> </span>dnsrecord.kuadrant.io<span class="w"> </span>api-gateway-api<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>-o<span class="o">=</span>yaml
-</span></code></pre></div>
-<p>So now we have a wildcard DNS record to bring traffic to our gateway.</p>
-<p>Let's test it again. This time we expect a <code>403</code> still as the <em>deny-all</em> policy is still in effect. Notice we no longer need to set the Host header directly.</p>
-<blockquote>
-<p><strong>Note:</strong> If you have followed through this guide on more than 1 cluster, the DNS record for the HTTPRoute hostname will have multiple IP addresses. This means that requests will be made in a round robin pattern across clusters as your DNS provider sends different responses to lookups. You may need to send multiple requests before one hits the cluster you are currently configuring.</p>
-</blockquote>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>curl<span class="w"> </span>-k<span class="w"> </span><span class="s2">&quot;https://api.</span><span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span><span class="s2">/cars&quot;</span><span class="w"> </span>-i
-</span></code></pre></div>
-<h3 id="override-the-gateways-deny-all-authpolicy">❼ Override the Gateway's deny-all AuthPolicy<a class="headerlink" href="#override-the-gateways-deny-all-authpolicy" title="Permanent link">&para;</a></h3>
-<p>Next, we are going to allow authenticated access to our Toystore API. To do this, we will define an AuthPolicy that targets the HTTPRoute. Note that any new HTTPRoutes will still be affected by the gateway-level policy, but as we want users to now access this API, we need to override that policy. For simplicity, we will use API keys to authenticate the requests, though many other options are available.</p>
-<p>Let's define an API Key for users <strong>bob</strong> and <strong>alice</strong>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="s">kind: Secret</span>
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="s">metadata:</span>
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="s">  name: bob-key</span>
-</span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="s">  labels:</span>
-</span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a><span class="s">    app: toystore</span>
-</span><span id="__span-18-9"><a id="__codelineno-18-9" name="__codelineno-18-9" href="#__codelineno-18-9"></a><span class="s">  annotations:</span>
-</span><span id="__span-18-10"><a id="__codelineno-18-10" name="__codelineno-18-10" href="#__codelineno-18-10"></a><span class="s">    secret.kuadrant.io/user-id: bob</span>
-</span><span id="__span-18-11"><a id="__codelineno-18-11" name="__codelineno-18-11" href="#__codelineno-18-11"></a><span class="s">stringData:</span>
-</span><span id="__span-18-12"><a id="__codelineno-18-12" name="__codelineno-18-12" href="#__codelineno-18-12"></a><span class="s">  api_key: IAMBOB</span>
-</span><span id="__span-18-13"><a id="__codelineno-18-13" name="__codelineno-18-13" href="#__codelineno-18-13"></a><span class="s">type: Opaque</span>
-</span><span id="__span-18-14"><a id="__codelineno-18-14" name="__codelineno-18-14" href="#__codelineno-18-14"></a><span class="s">---</span>
-</span><span id="__span-18-15"><a id="__codelineno-18-15" name="__codelineno-18-15" href="#__codelineno-18-15"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-18-16"><a id="__codelineno-18-16" name="__codelineno-18-16" href="#__codelineno-18-16"></a><span class="s">kind: Secret</span>
-</span><span id="__span-18-17"><a id="__codelineno-18-17" name="__codelineno-18-17" href="#__codelineno-18-17"></a><span class="s">metadata:</span>
-</span><span id="__span-18-18"><a id="__codelineno-18-18" name="__codelineno-18-18" href="#__codelineno-18-18"></a><span class="s">  name: alice-key</span>
-</span><span id="__span-18-19"><a id="__codelineno-18-19" name="__codelineno-18-19" href="#__codelineno-18-19"></a><span class="s">  labels:</span>
-</span><span id="__span-18-20"><a id="__codelineno-18-20" name="__codelineno-18-20" href="#__codelineno-18-20"></a><span class="s">    authorino.kuadrant.io/managed-by: authorino</span>
-</span><span id="__span-18-21"><a id="__codelineno-18-21" name="__codelineno-18-21" href="#__codelineno-18-21"></a><span class="s">    app: toystore</span>
-</span><span id="__span-18-22"><a id="__codelineno-18-22" name="__codelineno-18-22" href="#__codelineno-18-22"></a><span class="s">  annotations:</span>
-</span><span id="__span-18-23"><a id="__codelineno-18-23" name="__codelineno-18-23" href="#__codelineno-18-23"></a><span class="s">    secret.kuadrant.io/user-id: alice</span>
-</span><span id="__span-18-24"><a id="__codelineno-18-24" name="__codelineno-18-24" href="#__codelineno-18-24"></a><span class="s">stringData:</span>
-</span><span id="__span-18-25"><a id="__codelineno-18-25" name="__codelineno-18-25" href="#__codelineno-18-25"></a><span class="s">  api_key: IAMALICE</span>
-</span><span id="__span-18-26"><a id="__codelineno-18-26" name="__codelineno-18-26" href="#__codelineno-18-26"></a><span class="s">type: Opaque</span>
-</span><span id="__span-18-27"><a id="__codelineno-18-27" name="__codelineno-18-27" href="#__codelineno-18-27"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Now, we will override the AuthPolicy to start accepting the API keys:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a><span class="s">kind: AuthPolicy</span>
-</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a><span class="s">metadata:</span>
-</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-19-6"><a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a><span class="s">spec:</span>
-</span><span id="__span-19-7"><a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-19-8"><a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-19-9"><a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a><span class="s">    kind: HTTPRoute</span>
-</span><span id="__span-19-10"><a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a><span class="s">    name: toystore</span>
-</span><span id="__span-19-11"><a id="__codelineno-19-11" name="__codelineno-19-11" href="#__codelineno-19-11"></a><span class="s">  rules:</span>
-</span><span id="__span-19-12"><a id="__codelineno-19-12" name="__codelineno-19-12" href="#__codelineno-19-12"></a><span class="s">    authentication:</span>
-</span><span id="__span-19-13"><a id="__codelineno-19-13" name="__codelineno-19-13" href="#__codelineno-19-13"></a><span class="s">      &quot;api-key-users&quot;:</span>
-</span><span id="__span-19-14"><a id="__codelineno-19-14" name="__codelineno-19-14" href="#__codelineno-19-14"></a><span class="s">        apiKey:</span>
-</span><span id="__span-19-15"><a id="__codelineno-19-15" name="__codelineno-19-15" href="#__codelineno-19-15"></a><span class="s">          selector:</span>
-</span><span id="__span-19-16"><a id="__codelineno-19-16" name="__codelineno-19-16" href="#__codelineno-19-16"></a><span class="s">            matchLabels:</span>
-</span><span id="__span-19-17"><a id="__codelineno-19-17" name="__codelineno-19-17" href="#__codelineno-19-17"></a><span class="s">              app: toystore</span>
-</span><span id="__span-19-18"><a id="__codelineno-19-18" name="__codelineno-19-18" href="#__codelineno-19-18"></a><span class="s">        credentials:</span>
-</span><span id="__span-19-19"><a id="__codelineno-19-19" name="__codelineno-19-19" href="#__codelineno-19-19"></a><span class="s">          authorizationHeader:</span>
-</span><span id="__span-19-20"><a id="__codelineno-19-20" name="__codelineno-19-20" href="#__codelineno-19-20"></a><span class="s">            prefix: APIKEY</span>
-</span><span id="__span-19-21"><a id="__codelineno-19-21" name="__codelineno-19-21" href="#__codelineno-19-21"></a><span class="s">    response:</span>
-</span><span id="__span-19-22"><a id="__codelineno-19-22" name="__codelineno-19-22" href="#__codelineno-19-22"></a><span class="s">      success:</span>
-</span><span id="__span-19-23"><a id="__codelineno-19-23" name="__codelineno-19-23" href="#__codelineno-19-23"></a><span class="s">        dynamicMetadata:</span>
-</span><span id="__span-19-24"><a id="__codelineno-19-24" name="__codelineno-19-24" href="#__codelineno-19-24"></a><span class="s">          &quot;identity&quot;:</span>
-</span><span id="__span-19-25"><a id="__codelineno-19-25" name="__codelineno-19-25" href="#__codelineno-19-25"></a><span class="s">            json:</span>
-</span><span id="__span-19-26"><a id="__codelineno-19-26" name="__codelineno-19-26" href="#__codelineno-19-26"></a><span class="s">              properties:</span>
-</span><span id="__span-19-27"><a id="__codelineno-19-27" name="__codelineno-19-27" href="#__codelineno-19-27"></a><span class="s">                &quot;userid&quot;:</span>
-</span><span id="__span-19-28"><a id="__codelineno-19-28" name="__codelineno-19-28" href="#__codelineno-19-28"></a><span class="s">                  selector: auth.identity.metadata.annotations.secret\.kuadrant\.io/user-id</span>
-</span><span id="__span-19-29"><a id="__codelineno-19-29" name="__codelineno-19-29" href="#__codelineno-19-29"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="override-the-gateways-ratelimitpolicy">❽ Override the Gateway's RateLimitPolicy<a class="headerlink" href="#override-the-gateways-ratelimitpolicy" title="Permanent link">&para;</a></h3>
-<p>The gateway limits are a good set of limits for the general case, but as the developers of this API we know that we only want to allow a certain number of requests to specific users, and a general limit for all other users.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>kubectl<span class="w"> </span>--context<span class="w"> </span><span class="nv">$KUBECTL_CONTEXT</span><span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a><span class="s">kind: RateLimitPolicy</span>
-</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="s">metadata:</span>
-</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a><span class="s">spec:</span>
-</span><span id="__span-20-7"><a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-20-8"><a id="__codelineno-20-8" name="__codelineno-20-8" href="#__codelineno-20-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-20-9"><a id="__codelineno-20-9" name="__codelineno-20-9" href="#__codelineno-20-9"></a><span class="s">    kind: HTTPRoute</span>
-</span><span id="__span-20-10"><a id="__codelineno-20-10" name="__codelineno-20-10" href="#__codelineno-20-10"></a><span class="s">    name: toystore</span>
-</span><span id="__span-20-11"><a id="__codelineno-20-11" name="__codelineno-20-11" href="#__codelineno-20-11"></a><span class="s">  limits:</span>
-</span><span id="__span-20-12"><a id="__codelineno-20-12" name="__codelineno-20-12" href="#__codelineno-20-12"></a><span class="s">    &quot;general-user&quot;:</span>
-</span><span id="__span-20-13"><a id="__codelineno-20-13" name="__codelineno-20-13" href="#__codelineno-20-13"></a><span class="s">      rates:</span>
-</span><span id="__span-20-14"><a id="__codelineno-20-14" name="__codelineno-20-14" href="#__codelineno-20-14"></a>
-</span><span id="__span-20-15"><a id="__codelineno-20-15" name="__codelineno-20-15" href="#__codelineno-20-15"></a><span class="s">      - limit: 1</span>
-</span><span id="__span-20-16"><a id="__codelineno-20-16" name="__codelineno-20-16" href="#__codelineno-20-16"></a><span class="s">        duration: 3</span>
-</span><span id="__span-20-17"><a id="__codelineno-20-17" name="__codelineno-20-17" href="#__codelineno-20-17"></a><span class="s">        unit: second</span>
-</span><span id="__span-20-18"><a id="__codelineno-20-18" name="__codelineno-20-18" href="#__codelineno-20-18"></a><span class="s">      counters:</span>
-</span><span id="__span-20-19"><a id="__codelineno-20-19" name="__codelineno-20-19" href="#__codelineno-20-19"></a><span class="s">      - metadata.filter_metadata.envoy\.filters\.http\.ext_authz.identity.userid</span>
-</span><span id="__span-20-20"><a id="__codelineno-20-20" name="__codelineno-20-20" href="#__codelineno-20-20"></a><span class="s">      when:</span>
-</span><span id="__span-20-21"><a id="__codelineno-20-21" name="__codelineno-20-21" href="#__codelineno-20-21"></a><span class="s">      - selector: metadata.filter_metadata.envoy\.filters\.http\.ext_authz.identity.userid</span>
-</span><span id="__span-20-22"><a id="__codelineno-20-22" name="__codelineno-20-22" href="#__codelineno-20-22"></a><span class="s">        operator: neq</span>
-</span><span id="__span-20-23"><a id="__codelineno-20-23" name="__codelineno-20-23" href="#__codelineno-20-23"></a><span class="s">        value: bob</span>
-</span><span id="__span-20-24"><a id="__codelineno-20-24" name="__codelineno-20-24" href="#__codelineno-20-24"></a><span class="s">    &quot;bob-limit&quot;:</span>
-</span><span id="__span-20-25"><a id="__codelineno-20-25" name="__codelineno-20-25" href="#__codelineno-20-25"></a><span class="s">      rates:</span>
-</span><span id="__span-20-26"><a id="__codelineno-20-26" name="__codelineno-20-26" href="#__codelineno-20-26"></a><span class="s">      - limit: 2</span>
-</span><span id="__span-20-27"><a id="__codelineno-20-27" name="__codelineno-20-27" href="#__codelineno-20-27"></a><span class="s">        duration: 3</span>
-</span><span id="__span-20-28"><a id="__codelineno-20-28" name="__codelineno-20-28" href="#__codelineno-20-28"></a><span class="s">        unit: second</span>
-</span><span id="__span-20-29"><a id="__codelineno-20-29" name="__codelineno-20-29" href="#__codelineno-20-29"></a><span class="s">      when:</span>
-</span><span id="__span-20-30"><a id="__codelineno-20-30" name="__codelineno-20-30" href="#__codelineno-20-30"></a><span class="s">      - selector: metadata.filter_metadata.envoy\.filters\.http\.ext_authz.identity.userid</span>
-</span><span id="__span-20-31"><a id="__codelineno-20-31" name="__codelineno-20-31" href="#__codelineno-20-31"></a><span class="s">        operator: eq</span>
-</span><span id="__span-20-32"><a id="__codelineno-20-32" name="__codelineno-20-32" href="#__codelineno-20-32"></a><span class="s">        value: bob</span>
-</span><span id="__span-20-33"><a id="__codelineno-20-33" name="__codelineno-20-33" href="#__codelineno-20-33"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p>
-</blockquote>
-<p>As just another example, we have given <strong>bob</strong> twice as many requests to use compared to everyone else.</p>
-<p>Let's test this new setup.</p>
-<p>By sending requests as <strong>alice</strong>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>-k<span class="w"> </span>--resolve<span class="w"> </span>api.<span class="si">${</span><span class="nv">KUADRANT_ZONE_ROOT_DOMAIN</span><span class="si">}</span>:443:<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMALICE&#39;</span><span class="w"> </span><span class="s2">&quot;https://api.</span><span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span><span class="s2">/cars&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<p>By sending requests as <strong>bob</strong>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>-k<span class="w"> </span>--resolve<span class="w"> </span>api.<span class="si">${</span><span class="nv">KUADRANT_ZONE_ROOT_DOMAIN</span><span class="si">}</span>:443:<span class="si">${</span><span class="nv">INGRESS_HOST</span><span class="si">}</span><span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMBOB&#39;</span><span class="w"> </span><span class="s2">&quot;https://api.</span><span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span><span class="s2">/cars&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> If you configured a DNS provider during the setup and defined the DNSPolicy as described in one of the previous chapters you can omit the <code>--resolve api.${KUADRANT_ZONE_ROOT_DOMAIN}:443:${INGRESS_HOST}</code> flag.</p>
-<p><strong>Note:</strong> If you have followed through this guide on more than 1 cluster, the DNS record for the HTTPRoute hostname will have multiple IP addresses. This means that requests will be made in a round robin pattern across clusters as your DNS provider sends different responses to lookups.</p>
-</blockquote>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>-k<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMALICE&#39;</span><span class="w"> </span><span class="s2">&quot;https://api.</span><span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span><span class="s2">/cars&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>-k<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Authorization: APIKEY IAMBOB&#39;</span><span class="w"> </span><span class="s2">&quot;https://api.</span><span class="nv">$KUADRANT_ZONE_ROOT_DOMAIN</span><span class="s2">/cars&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/index.html b/0.10.0/kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/index.html
deleted file mode 100644
index 6e4664247..000000000
--- a/0.10.0/kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/index.html
+++ /dev/null
@@ -1,3541 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Simple Rate Limiting for Application Developers - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#simple-rate-limiting-for-application-developers" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Simple Rate Limiting for Application Developers
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#run-the-steps-1-3" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the steps ① → ③
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run the steps ① → ③">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      ① Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-deploy-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ② Deploy the Toy Store API
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-enforce-rate-limiting-on-requests-to-the-toy-store-api" class="md-nav__link">
-    <span class="md-ellipsis">
-      ③ Enforce rate limiting on requests to the Toy Store API
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleanup
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/doc/user-guides/simple-rl-for-app-developers.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="simple-rate-limiting-for-application-developers">Simple Rate Limiting for Application Developers<a class="headerlink" href="#simple-rate-limiting-for-application-developers" title="Permanent link">&para;</a></h1>
-<p>This user guide walks you through an example of how to configure rate limiting for an endpoint of an application using Kuadrant.</p>
-<p><br/></p>
-<p>In this guide, we will rate limit a sample REST API called <strong>Toy Store</strong>. In reality, this API is just an echo service that echoes back to the user whatever attributes it gets in the request. The API listens to requests at the hostname <code>api.toystore.com</code>, where it exposes the endpoints <code>GET /toys*</code> and <code>POST /toys</code>, respectively, to mimic a operations of reading and writing toy records.</p>
-<p>We will rate limit the <code>POST /toys</code> endpoint to a maximum of 5rp10s ("5 requests every 10 seconds").</p>
-<p><br/></p>
-<h2 id="run-the-steps-1-3">Run the steps ① → ③<a class="headerlink" href="#run-the-steps-1-3" title="Permanent link">&para;</a></h2>
-<h3 id="1-setup">① Setup<a class="headerlink" href="#1-setup" title="Permanent link">&para;</a></h3>
-<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using <a href="https://kind.sigs.k8s.io">Kind</a>,
-where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p>
-<blockquote>
-<p><strong>Note:</strong> In production environment, these steps are usually performed by a cluster operator with administrator privileges over the Kubernetes cluster.</p>
-</blockquote>
-<p>Clone the project:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/kuadrant-operator<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>kuadrant-operator
-</span></code></pre></div>
-<p>Setup the environment:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<p>Request an instance of Kuadrant:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant-system<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: kuadrant</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">spec: {}</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="2-deploy-the-toy-store-api">② Deploy the Toy Store API<a class="headerlink" href="#2-deploy-the-toy-store-api" title="Permanent link">&para;</a></h3>
-<p>Create the deployment:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>examples/toystore/toystore.yaml
-</span></code></pre></div>
-<p>Create a HTTPRoute to route traffic to the service via Istio Ingress Gateway:</p>
-<p><img alt="" src="https://i.imgur.com/rdN8lo3.png" /></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: gateway.networking.k8s.io/v1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: HTTPRoute</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">spec:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="s">  parentRefs:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">  - name: istio-ingressgateway</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">    namespace: istio-system</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">  hostnames:</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">  - api.toystore.com</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">  rules:</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="s">  - matches:</span>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="s">    - method: GET</span>
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a><span class="s">      path:</span>
-</span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a><span class="s">        type: PathPrefix</span>
-</span><span id="__span-4-18"><a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a><span class="s">        value: &quot;/toys&quot;</span>
-</span><span id="__span-4-19"><a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a><span class="s">    backendRefs:</span>
-</span><span id="__span-4-20"><a id="__codelineno-4-20" name="__codelineno-4-20" href="#__codelineno-4-20"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-4-21"><a id="__codelineno-4-21" name="__codelineno-4-21" href="#__codelineno-4-21"></a><span class="s">      port: 80</span>
-</span><span id="__span-4-22"><a id="__codelineno-4-22" name="__codelineno-4-22" href="#__codelineno-4-22"></a><span class="s">  - matches: # it has to be a separate HTTPRouteRule so we do not rate limit other endpoints</span>
-</span><span id="__span-4-23"><a id="__codelineno-4-23" name="__codelineno-4-23" href="#__codelineno-4-23"></a><span class="s">    - method: POST</span>
-</span><span id="__span-4-24"><a id="__codelineno-4-24" name="__codelineno-4-24" href="#__codelineno-4-24"></a><span class="s">      path:</span>
-</span><span id="__span-4-25"><a id="__codelineno-4-25" name="__codelineno-4-25" href="#__codelineno-4-25"></a><span class="s">        type: Exact</span>
-</span><span id="__span-4-26"><a id="__codelineno-4-26" name="__codelineno-4-26" href="#__codelineno-4-26"></a><span class="s">        value: &quot;/toys&quot;</span>
-</span><span id="__span-4-27"><a id="__codelineno-4-27" name="__codelineno-4-27" href="#__codelineno-4-27"></a><span class="s">    backendRefs:</span>
-</span><span id="__span-4-28"><a id="__codelineno-4-28" name="__codelineno-4-28" href="#__codelineno-4-28"></a><span class="s">    - name: toystore</span>
-</span><span id="__span-4-29"><a id="__codelineno-4-29" name="__codelineno-4-29" href="#__codelineno-4-29"></a><span class="s">      port: 80</span>
-</span><span id="__span-4-30"><a id="__codelineno-4-30" name="__codelineno-4-30" href="#__codelineno-4-30"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>Export the gateway hostname and port:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_HOST</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>istio-ingressgateway<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.status.addresses[0].value}&#39;</span><span class="k">)</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">INGRESS_PORT</span><span class="o">=</span><span class="k">$(</span>kubectl<span class="w"> </span>get<span class="w"> </span>gtw<span class="w"> </span>istio-ingressgateway<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>-o<span class="w"> </span><span class="nv">jsonpath</span><span class="o">=</span><span class="s1">&#39;{.spec.listeners[?(@.name==&quot;http&quot;)].port}&#39;</span><span class="k">)</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">GATEWAY_URL</span><span class="o">=</span><span class="nv">$INGRESS_HOST</span>:<span class="nv">$INGRESS_PORT</span>
-</span></code></pre></div>
-<p>Verify the route works:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toys<span class="w"> </span>-i
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note</strong>: If the command above fails to hit the Toy Store API on your environment, try forwarding requests to the service and accessing over localhost:</p>
-<p><div class="language-sh highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span>port-forward<span class="w"> </span>-n<span class="w"> </span>istio-system<span class="w"> </span>service/istio-ingressgateway-istio<span class="w"> </span><span class="m">9080</span>:80<span class="w"> </span>&gt;/dev/null<span class="w"> </span><span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span><span class="w"> </span><span class="p">&amp;</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">GATEWAY_URL</span><span class="o">=</span>localhost:9080
-</span></code></pre></div>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toys<span class="w"> </span>-i
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="c1"># HTTP/1.1 200 OK</span>
-</span></code></pre></div></p>
-</blockquote>
-<h3 id="3-enforce-rate-limiting-on-requests-to-the-toy-store-api">③ Enforce rate limiting on requests to the Toy Store API<a class="headerlink" href="#3-enforce-rate-limiting-on-requests-to-the-toy-store-api" title="Permanent link">&para;</a></h3>
-<p>Create a Kuadrant <code>RateLimitPolicy</code> to configure rate limiting:</p>
-<p><img alt="" src="https://i.imgur.com/2A9sXXs.png" /></p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">apiVersion: kuadrant.io/v1beta2</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">kind: RateLimitPolicy</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">metadata:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">  name: toystore</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">spec:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">  targetRef:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">    group: gateway.networking.k8s.io</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">    kind: HTTPRoute</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">    name: toystore</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">  limits:</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">    &quot;create-toy&quot;:</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="s">      rates:</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a>
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a><span class="s">      - limit: 5</span>
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a><span class="s">        duration: 10</span>
-</span><span id="__span-9-17"><a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a><span class="s">        unit: second</span>
-</span><span id="__span-9-18"><a id="__codelineno-9-18" name="__codelineno-9-18" href="#__codelineno-9-18"></a><span class="s">      routeSelectors:</span>
-</span><span id="__span-9-19"><a id="__codelineno-9-19" name="__codelineno-9-19" href="#__codelineno-9-19"></a><span class="s">      - matches: # selects the 2nd HTTPRouteRule of the targeted route</span>
-</span><span id="__span-9-20"><a id="__codelineno-9-20" name="__codelineno-9-20" href="#__codelineno-9-20"></a><span class="s">        - method: POST</span>
-</span><span id="__span-9-21"><a id="__codelineno-9-21" name="__codelineno-9-21" href="#__codelineno-9-21"></a><span class="s">          path:</span>
-</span><span id="__span-9-22"><a id="__codelineno-9-22" name="__codelineno-9-22" href="#__codelineno-9-22"></a><span class="s">            type: Exact</span>
-</span><span id="__span-9-23"><a id="__codelineno-9-23" name="__codelineno-9-23" href="#__codelineno-9-23"></a><span class="s">            value: &quot;/toys&quot;</span>
-</span><span id="__span-9-24"><a id="__codelineno-9-24" name="__codelineno-9-24" href="#__codelineno-9-24"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note:</strong> It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p>
-</blockquote>
-<p><br/></p>
-<p>Verify the rate limiting works by sending requests in a loop.</p>
-<p>Up to 5 successful (<code>200 OK</code>) requests every 10 seconds to <code>POST /toys</code>, then <code>429 Too Many Requests</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toys<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<p>Unlimited successful (<code>200 OK</code>) to <code>GET /toys</code>:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>curl<span class="w"> </span>--write-out<span class="w"> </span><span class="s1">&#39;%{http_code}\n&#39;</span><span class="w"> </span>--silent<span class="w"> </span>--output<span class="w"> </span>/dev/null<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: api.toystore.com&#39;</span><span class="w"> </span>http://<span class="nv">$GATEWAY_URL</span>/toys<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-E<span class="w"> </span>--color<span class="w"> </span><span class="s2">&quot;\b(429)\b|</span>$<span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span>sleep<span class="w"> </span><span class="m">1</span><span class="p">;</span><span class="w"> </span><span class="k">done</span>
-</span></code></pre></div>
-<h2 id="cleanup">Cleanup<a class="headerlink" href="#cleanup" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/examples/alerts/index.html b/0.10.0/kuadrant-operator/examples/alerts/index.html
deleted file mode 100644
index c8a75c5b7..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/index.html
+++ /dev/null
@@ -1,3492 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/examples/alerts/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Index - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#slo-multi-burn-rate-multi-window-alerts" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Index
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#slo-multi-burn-rate-multi-window-alerts" class="md-nav__link">
-    <span class="md-ellipsis">
-      SLO Multi burn rate multi window alerts
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="SLO Multi burn rate multi window alerts">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#sloth" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sloth
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Sloth">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#metrics-used-for-the-alerts" class="md-nav__link">
-    <span class="md-ellipsis">
-      Metrics used for the alerts
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#availability" class="md-nav__link">
-    <span class="md-ellipsis">
-      Availability
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#latency" class="md-nav__link">
-    <span class="md-ellipsis">
-      Latency
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#sloth-generation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Sloth generation
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#prometheus-unit-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prometheus unit tests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/examples/alerts/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Index</h1>
-
-<h2 id="slo-multi-burn-rate-multi-window-alerts">SLO Multi burn rate multi window alerts<a class="headerlink" href="#slo-multi-burn-rate-multi-window-alerts" title="Permanent link">&para;</a></h2>
-<p>Kuadrant have created two example SLO alerts to help give ideas on the types of SLO alerts that could be used with the operator. We have created one alert for latency and one for availability, both are Multiwindow, Multi-Burn-Rate Alerts. The alerts show a scenario where a 28d rolling window is used and a uptime of 99.95% i.e only 0.05% error budget margin is desired. This in real world time would be downtime of around: </p>
-<table>
-<thead>
-<tr>
-<th>Time Frame</th>
-<th>Duration</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>Daily:</td>
-<td>43s</td>
-</tr>
-<tr>
-<td>Weekly:</td>
-<td>5m 2.4s</td>
-</tr>
-<tr>
-<td>Monthly:</td>
-<td>21m 44s</td>
-</tr>
-<tr>
-<td>Quarterly:</td>
-<td>1h 5m 12s</td>
-</tr>
-<tr>
-<td>Yearly:</td>
-<td>4h 20m 49s</td>
-</tr>
-</tbody>
-</table>
-<p>These values can be changed to suit different scenarios</p>
-<h3 id="sloth">Sloth<a class="headerlink" href="#sloth" title="Permanent link">&para;</a></h3>
-<p>Sloth is a tool to aid in the creation of multi burn rate and multi window SLO alerts and was used to create both the availability and latency alerts. It follows the common standard set out by <a href="https://sre.google/workbook/implementing-slos/">Google's SRE book</a>. Sloth generates alerts based on specific specs given. The specs for our example alerts can be found in the example/sloth folder.</p>
-<h4 id="metrics-used-for-the-alerts">Metrics used for the alerts<a class="headerlink" href="#metrics-used-for-the-alerts" title="Permanent link">&para;</a></h4>
-<h4 id="availability">Availability<a class="headerlink" href="#availability" title="Permanent link">&para;</a></h4>
-<p>For the availability SLO alerts the Istio metric <code>istio_requests_total</code> was used as its a counter type metric meaning the values can only increase as well as it gives information on all requests handled by the Istio proxy.</p>
-<h4 id="latency">Latency<a class="headerlink" href="#latency" title="Permanent link">&para;</a></h4>
-<p>For the availability SLO alerts the Istio metric <code>istio_request_duration_milliseconds</code> was used as its a <a href="https://prometheus.io/docs/concepts/metric_types/#histogram">Histogram</a>.</p>
-<h3 id="sloth-generation">Sloth generation<a class="headerlink" href="#sloth-generation" title="Permanent link">&para;</a></h3>
-<p>You can modify the examples Sloth specs we have and regenerate the prometheus rules using the Sloth CLI and the generate command. For more information please the <a href="https://sloth.dev/usage/cli/">Sloth website</a></p>
-<p><div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>sloth generate -i examples/alerts/sloth/latency.yaml --default-slo-period=28d
-</span></code></pre></div>
-You can also use the make target to generate the rules to.</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make sloth-generate
-</span></code></pre></div>
-<h3 id="prometheus-unit-tests">Prometheus unit tests<a class="headerlink" href="#prometheus-unit-tests" title="Permanent link">&para;</a></h3>
-<p>There are also two matching unit tests to verify and test the alerts that Sloth has generated. These can be run using the make target:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>make test-alerts
-</span></code></pre></div>
-<p>Note: The prometheus unit tests will also run via Github actions when a change is made in the alerts file.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrant-operator/examples/alerts/kustomization.yaml b/0.10.0/kuadrant-operator/examples/alerts/kustomization.yaml
deleted file mode 100644
index bbdda37bd..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/kustomization.yaml
+++ /dev/null
@@ -1,7 +0,0 @@
-apiVersion: kustomize.config.k8s.io/v1beta1
-kind: Kustomization
-
-resources:
-  - prometheusrules_policies_missing.yaml
-  - slo-availability.yaml
-  - slo-latency.yaml
diff --git a/0.10.0/kuadrant-operator/examples/alerts/prometheusrules_policies_missing.yaml b/0.10.0/kuadrant-operator/examples/alerts/prometheusrules_policies_missing.yaml
deleted file mode 100644
index 3622b7962..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/prometheusrules_policies_missing.yaml
+++ /dev/null
@@ -1,57 +0,0 @@
-apiVersion: monitoring.coreos.com/v1
-kind: PrometheusRule
-metadata:
-  name: policies-missing
-  namespace: monitoring
-spec:
-  groups:
-  - name: policy-rules
-    rules:
-    - alert: GatewayWithoutDnsPolicy
-      expr: |
-        label_replace(gatewayapi_gateway_info, "gateway_name", "$1", "name", "(.*)") unless 
-        (label_replace(gatewayapi_gateway_info, "gateway_name", "$1", "name", "(.*)") 
-        * on(gateway_name) group_left 
-        label_replace(gatewayapi_dnspolicy_target_info{target_kind="Gateway"}, "gateway_name", "$1", "target_name", "(.*)"))
-      for: 5m
-      labels:
-        severity: warning
-      annotations:
-        summary: "No DNSPolicy targeting Gateway '{{ $labels.gateway_name }}'"
-        description: "This alert fires if a gateway does not have an associated DNSPolicy."
-    - alert: GatewayWithoutTlsPolicy
-      expr: |
-        label_replace(gatewayapi_gateway_info, "gateway_name", "$1", "name", "(.*)") unless 
-        (label_replace(gatewayapi_gateway_info, "gateway_name", "$1", "name", "(.*)") 
-        * on(gateway_name) group_left 
-        label_replace(gatewayapi_tlspolicy_target_info{target_kind="Gateway"}, "gateway_name", "$1", "target_name", "(.*)"))
-      for: 5m
-      labels:
-        severity: warning
-      annotations:
-        summary: "No TLSPolicy targeting Gateway '{{ $labels.gateway_name }}'"
-        description: "This alert fires if a gateway does not have an associated TLSPolicy."
-    - alert: HTTPRouteWithoutAuthPolicy
-      expr: |
-        label_replace(gatewayapi_httproute_created, "httproute_name", "$1", "name", "(.*)") unless 
-        (label_replace(gatewayapi_httproute_created, "httproute_name", "$1", "name", "(.*)") 
-        * on(httproute_name) group_left 
-        label_replace(gatewayapi_authpolicy_target_info{target_kind="HTTPRoute"}, "httproute_name", "$1", "target_name", "(.*)"))
-      for: 5m
-      labels:
-        severity: warning
-      annotations:
-        summary: "No AuthPolicy targeting HTTPRoute '{{ $labels.httproute_name }}'"
-        description: "This alert fires if a HTTPRoute does not have an associated AuthPolicy."
-    - alert: HTTPRouteWithoutRateLimitPolicy
-      expr: |
-        label_replace(gatewayapi_httproute_created, "httproute_name", "$1", "name", "(.*)") unless 
-        (label_replace(gatewayapi_httproute_created, "httproute_name", "$1", "name", "(.*)") 
-        * on(httproute_name) group_left 
-        label_replace(gatewayapi_ratelimitpolicy_target_info{target_kind="HTTPRoute"}, "httproute_name", "$1", "target_name", "(.*)"))
-      for: 5m
-      labels:
-        severity: warning
-      annotations:
-        summary: "No RateLimitPolicy targeting HTTPRoute '{{ $labels.httproute_name }}'"
-        description: "This alert fires if a HTTPRoute does not have an associated RateLimitPolicy."
diff --git a/0.10.0/kuadrant-operator/examples/alerts/slo-availability.yaml b/0.10.0/kuadrant-operator/examples/alerts/slo-availability.yaml
deleted file mode 100644
index 3263bc611..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/slo-availability.yaml
+++ /dev/null
@@ -1,212 +0,0 @@
-
----
-# Code generated by Sloth (v0.11.0): https://github.com/slok/sloth.
-# DO NOT EDIT.
-
-apiVersion: monitoring.coreos.com/v1
-kind: PrometheusRule
-metadata:
-  creationTimestamp: null
-  labels:
-    app.kubernetes.io/component: SLO
-    app.kubernetes.io/managed-by: sloth
-  name: availability-slo
-  namespace: monitoring
-spec:
-  groups:
-  - name: sloth-slo-sli-recordings-kuadrant-requests-availability
-    rules:
-    - expr: |
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy",response_code=~"5.*"}[5m])) by (request_host))
-        /
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy"}[5m]) )by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_window: 5m
-      record: slo:sli_error:ratio_rate5m
-    - expr: |
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy",response_code=~"5.*"}[30m])) by (request_host))
-        /
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy"}[30m]) )by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_window: 30m
-      record: slo:sli_error:ratio_rate30m
-    - expr: |
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy",response_code=~"5.*"}[1h])) by (request_host))
-        /
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy"}[1h]) )by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_window: 1h
-      record: slo:sli_error:ratio_rate1h
-    - expr: |
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy",response_code=~"5.*"}[2h])) by (request_host))
-        /
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy"}[2h]) )by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_window: 2h
-      record: slo:sli_error:ratio_rate2h
-    - expr: |
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy",response_code=~"5.*"}[6h])) by (request_host))
-        /
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy"}[6h]) )by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_window: 6h
-      record: slo:sli_error:ratio_rate6h
-    - expr: |
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy",response_code=~"5.*"}[1d])) by (request_host))
-        /
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy"}[1d]) )by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_window: 1d
-      record: slo:sli_error:ratio_rate1d
-    - expr: |
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy",response_code=~"5.*"}[3d])) by (request_host))
-        /
-        (sum(rate(istio_requests_total{job="ingress-metrics-proxy"}[3d]) )by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_window: 3d
-      record: slo:sli_error:ratio_rate3d
-    - expr: |
-        sum_over_time(slo:sli_error:ratio_rate5m{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"}[4w])
-        / ignoring (sloth_window)
-        count_over_time(slo:sli_error:ratio_rate5m{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"}[4w])
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_window: 4w
-      record: slo:sli_error:ratio_rate4w
-  - name: sloth-slo-meta-recordings-kuadrant-requests-availability
-    rules:
-    - expr: vector(0.9995)
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-      record: slo:objective:ratio
-    - expr: vector(1-0.9995)
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-      record: slo:error_budget:ratio
-    - expr: vector(28)
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-      record: slo:time_period:days
-    - expr: |
-        slo:sli_error:ratio_rate5m{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"}
-        / on(sloth_id, sloth_slo, sloth_service) group_left
-        slo:error_budget:ratio{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"}
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-      record: slo:current_burn_rate:ratio
-    - expr: |
-        slo:sli_error:ratio_rate4w{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"}
-        / on(sloth_id, sloth_slo, sloth_service) group_left
-        slo:error_budget:ratio{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"}
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-      record: slo:period_burn_rate:ratio
-    - expr: 1 - slo:period_burn_rate:ratio{sloth_id="kuadrant-requests-availability",
-        sloth_service="kuadrant", sloth_slo="requests-availability"}
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-      record: slo:period_error_budget_remaining:ratio
-    - expr: vector(1)
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-availability
-        sloth_mode: cli-gen-k8s
-        sloth_objective: "99.95"
-        sloth_service: kuadrant
-        sloth_slo: requests-availability
-        sloth_spec: sloth.slok.dev/v1
-        sloth_version: v0.11.0
-      record: sloth_slo_info
-  - name: sloth-slo-alerts-kuadrant-requests-availability
-    rules:
-    - alert: KuadrantAvailabilityHighErrorRate
-      annotations:
-        summary: High error rate on HTTPRoute requests responses
-        title: (page) {{$labels.sloth_service}} {{$labels.sloth_slo}} SLO error budget
-          burn rate is too fast.
-      expr: |
-        (
-            max(slo:sli_error:ratio_rate5m{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"} > (13.44 * 0.0004999999999999716)) without (sloth_window)
-            and
-            max(slo:sli_error:ratio_rate1h{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"} > (13.44 * 0.0004999999999999716)) without (sloth_window)
-        )
-        or
-        (
-            max(slo:sli_error:ratio_rate30m{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"} > (5.6000000000000005 * 0.0004999999999999716)) without (sloth_window)
-            and
-            max(slo:sli_error:ratio_rate6h{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"} > (5.6000000000000005 * 0.0004999999999999716)) without (sloth_window)
-        )
-      labels:
-        category: availability
-        severity: critical
-        sloth_severity: page
-    - alert: KuadrantAvailabilityHighErrorRate
-      annotations:
-        summary: High error rate on HTTPRoute requests responses
-        title: (ticket) {{$labels.sloth_service}} {{$labels.sloth_slo}} SLO error
-          budget burn rate is too fast.
-      expr: |
-        (
-            max(slo:sli_error:ratio_rate2h{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"} > (2.8000000000000003 * 0.0004999999999999716)) without (sloth_window)
-            and
-            max(slo:sli_error:ratio_rate1d{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"} > (2.8000000000000003 * 0.0004999999999999716)) without (sloth_window)
-        )
-        or
-        (
-            max(slo:sli_error:ratio_rate6h{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"} > (0.9333333333333333 * 0.0004999999999999716)) without (sloth_window)
-            and
-            max(slo:sli_error:ratio_rate3d{sloth_id="kuadrant-requests-availability", sloth_service="kuadrant", sloth_slo="requests-availability"} > (0.9333333333333333 * 0.0004999999999999716)) without (sloth_window)
-        )
-      labels:
-        category: availability
-        severity: warning
-        sloth_severity: ticket
diff --git a/0.10.0/kuadrant-operator/examples/alerts/slo-latency.yaml b/0.10.0/kuadrant-operator/examples/alerts/slo-latency.yaml
deleted file mode 100644
index 63e61c2cd..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/slo-latency.yaml
+++ /dev/null
@@ -1,212 +0,0 @@
-
----
-# Code generated by Sloth (v0.11.0): https://github.com/slok/sloth.
-# DO NOT EDIT.
-
-apiVersion: monitoring.coreos.com/v1
-kind: PrometheusRule
-metadata:
-  creationTimestamp: null
-  labels:
-    app.kubernetes.io/component: SLO
-    app.kubernetes.io/managed-by: sloth
-  name: latency-slo
-  namespace: monitoring
-spec:
-  groups:
-  - name: sloth-slo-sli-recordings-kuadrant-requests-latency
-    rules:
-    - expr: |
-        (( sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[5m]))by (request_host) - sum(rate(istio_request_duration_milliseconds_bucket{le="250", job="ingress-metrics-proxy", response_code="200" }[5m]) )by (request_host) ))
-        /
-        (sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[5m]))by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_window: 5m
-      record: slo:sli_error:ratio_rate5m
-    - expr: |
-        (( sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[30m]))by (request_host) - sum(rate(istio_request_duration_milliseconds_bucket{le="250", job="ingress-metrics-proxy", response_code="200" }[30m]) )by (request_host) ))
-        /
-        (sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[30m]))by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_window: 30m
-      record: slo:sli_error:ratio_rate30m
-    - expr: |
-        (( sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[1h]))by (request_host) - sum(rate(istio_request_duration_milliseconds_bucket{le="250", job="ingress-metrics-proxy", response_code="200" }[1h]) )by (request_host) ))
-        /
-        (sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[1h]))by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_window: 1h
-      record: slo:sli_error:ratio_rate1h
-    - expr: |
-        (( sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[2h]))by (request_host) - sum(rate(istio_request_duration_milliseconds_bucket{le="250", job="ingress-metrics-proxy", response_code="200" }[2h]) )by (request_host) ))
-        /
-        (sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[2h]))by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_window: 2h
-      record: slo:sli_error:ratio_rate2h
-    - expr: |
-        (( sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[6h]))by (request_host) - sum(rate(istio_request_duration_milliseconds_bucket{le="250", job="ingress-metrics-proxy", response_code="200" }[6h]) )by (request_host) ))
-        /
-        (sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[6h]))by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_window: 6h
-      record: slo:sli_error:ratio_rate6h
-    - expr: |
-        (( sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[1d]))by (request_host) - sum(rate(istio_request_duration_milliseconds_bucket{le="250", job="ingress-metrics-proxy", response_code="200" }[1d]) )by (request_host) ))
-        /
-        (sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[1d]))by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_window: 1d
-      record: slo:sli_error:ratio_rate1d
-    - expr: |
-        (( sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[3d]))by (request_host) - sum(rate(istio_request_duration_milliseconds_bucket{le="250", job="ingress-metrics-proxy", response_code="200" }[3d]) )by (request_host) ))
-        /
-        (sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[3d]))by (request_host))
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_window: 3d
-      record: slo:sli_error:ratio_rate3d
-    - expr: |
-        sum_over_time(slo:sli_error:ratio_rate5m{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"}[4w])
-        / ignoring (sloth_window)
-        count_over_time(slo:sli_error:ratio_rate5m{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"}[4w])
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_window: 4w
-      record: slo:sli_error:ratio_rate4w
-  - name: sloth-slo-meta-recordings-kuadrant-requests-latency
-    rules:
-    - expr: vector(0.9995)
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-      record: slo:objective:ratio
-    - expr: vector(1-0.9995)
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-      record: slo:error_budget:ratio
-    - expr: vector(28)
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-      record: slo:time_period:days
-    - expr: |
-        slo:sli_error:ratio_rate5m{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"}
-        / on(sloth_id, sloth_slo, sloth_service) group_left
-        slo:error_budget:ratio{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"}
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-      record: slo:current_burn_rate:ratio
-    - expr: |
-        slo:sli_error:ratio_rate4w{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"}
-        / on(sloth_id, sloth_slo, sloth_service) group_left
-        slo:error_budget:ratio{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"}
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-      record: slo:period_burn_rate:ratio
-    - expr: 1 - slo:period_burn_rate:ratio{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant",
-        sloth_slo="requests-latency"}
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-      record: slo:period_error_budget_remaining:ratio
-    - expr: vector(1)
-      labels:
-        owner: kuadrant-org
-        sloth_id: kuadrant-requests-latency
-        sloth_mode: cli-gen-k8s
-        sloth_objective: "99.95"
-        sloth_service: kuadrant
-        sloth_slo: requests-latency
-        sloth_spec: sloth.slok.dev/v1
-        sloth_version: v0.11.0
-      record: sloth_slo_info
-  - name: sloth-slo-alerts-kuadrant-requests-latency
-    rules:
-    - alert: KuadrantlatencyHighErrorRate
-      annotations:
-        summary: High latency on HTTPRoute requests responses
-        title: (page) {{$labels.sloth_service}} {{$labels.sloth_slo}} SLO error budget
-          burn rate is too fast.
-      expr: |
-        (
-            max(slo:sli_error:ratio_rate5m{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"} > (13.44 * 0.0004999999999999716)) without (sloth_window)
-            and
-            max(slo:sli_error:ratio_rate1h{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"} > (13.44 * 0.0004999999999999716)) without (sloth_window)
-        )
-        or
-        (
-            max(slo:sli_error:ratio_rate30m{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"} > (5.6000000000000005 * 0.0004999999999999716)) without (sloth_window)
-            and
-            max(slo:sli_error:ratio_rate6h{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"} > (5.6000000000000005 * 0.0004999999999999716)) without (sloth_window)
-        )
-      labels:
-        category: latency
-        severity: critical
-        sloth_severity: page
-    - alert: KuadrantlatencyHighErrorRate
-      annotations:
-        summary: High latency on HTTPRoute requests responses
-        title: (ticket) {{$labels.sloth_service}} {{$labels.sloth_slo}} SLO error
-          budget burn rate is too fast.
-      expr: |
-        (
-            max(slo:sli_error:ratio_rate2h{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"} > (2.8000000000000003 * 0.0004999999999999716)) without (sloth_window)
-            and
-            max(slo:sli_error:ratio_rate1d{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"} > (2.8000000000000003 * 0.0004999999999999716)) without (sloth_window)
-        )
-        or
-        (
-            max(slo:sli_error:ratio_rate6h{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"} > (0.9333333333333333 * 0.0004999999999999716)) without (sloth_window)
-            and
-            max(slo:sli_error:ratio_rate3d{sloth_id="kuadrant-requests-latency", sloth_service="kuadrant", sloth_slo="requests-latency"} > (0.9333333333333333 * 0.0004999999999999716)) without (sloth_window)
-        )
-      labels:
-        category: latency
-        severity: warning
-        sloth_severity: ticket
diff --git a/0.10.0/kuadrant-operator/examples/alerts/sloth/slo-availability.yaml b/0.10.0/kuadrant-operator/examples/alerts/sloth/slo-availability.yaml
deleted file mode 100644
index 65768e265..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/sloth/slo-availability.yaml
+++ /dev/null
@@ -1,31 +0,0 @@
-apiVersion: sloth.slok.dev/v1
-kind: PrometheusServiceLevel
-metadata:
-  name: availability-slo
-  namespace: monitoring
-spec:
-  service: "kuadrant"
-  labels:
-    owner: "kuadrant-org"
-  slos:
-    - name: "requests-availability"
-      objective: 99.95
-      description: "Multi window multi burn rate SLO based on availability for HTTP request responses."
-      sli:
-        events:
-          errorQuery: sum(rate(istio_requests_total{job="ingress-metrics-proxy",response_code=~"5.*"}[{{.window}}])) by (request_host)
-          totalQuery: sum(rate(istio_requests_total{job="ingress-metrics-proxy"}[{{.window}}]) )by (request_host)
-      alerting:
-        name: KuadrantAvailabilityHighErrorRate
-        labels:
-          category: "availability"
-        annotations:
-          # Overwrite default Sloth SLO alert summmary on ticket and page alerts.
-          summary: "High error rate on HTTPRoute requests responses"
-        pageAlert:
-          labels:
-            severity: critical
-        ticketAlert:
-          labels:
-            severity: warning
-    
diff --git a/0.10.0/kuadrant-operator/examples/alerts/sloth/slo-latency.yaml b/0.10.0/kuadrant-operator/examples/alerts/sloth/slo-latency.yaml
deleted file mode 100644
index 6f526dc82..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/sloth/slo-latency.yaml
+++ /dev/null
@@ -1,34 +0,0 @@
-apiVersion: sloth.slok.dev/v1
-kind: PrometheusServiceLevel
-metadata:
-  name: latency-slo
-  namespace: monitoring
-spec:
-  service: "kuadrant"
-  labels:
-    owner: "kuadrant-org"
-  slos:
-    - name: "requests-latency"
-      objective: 99.95
-      description: "Multi window multi burn rate SLO based on latency for HTTP request responses."
-      sli:
-        events:
-          errorQuery:  (
-                        sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[{{.window}}]))by (request_host) 
-                        - 
-                        sum(rate(istio_request_duration_milliseconds_bucket{le="250", job="ingress-metrics-proxy", response_code="200" }[{{.window}}]) )by (request_host)
-                        )
-          totalQuery: sum(rate(istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}[{{.window}}]))by (request_host)
-      alerting:
-        name: KuadrantlatencyHighErrorRate
-        labels:
-          category: "latency"
-        annotations:
-          # Overwrite default Sloth SLO alert summmary on ticket and page alerts.
-          summary: "High latency on HTTPRoute requests responses"
-        pageAlert:
-          labels:
-            severity: critical
-        ticketAlert:
-          labels:
-            severity: warning
diff --git a/0.10.0/kuadrant-operator/examples/alerts/tests/slo-availability-test.yaml b/0.10.0/kuadrant-operator/examples/alerts/tests/slo-availability-test.yaml
deleted file mode 100644
index 9b8a33526..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/tests/slo-availability-test.yaml
+++ /dev/null
@@ -1,47 +0,0 @@
-rule_files:
-  - /prometheus/availability-rules.yaml
-
-evaluation_interval: 1m
-
-tests:
-  - interval: 1m
-    input_series:
-    # Promtool uses expanding notation as its way of creating time series (https://prometheus.io/docs/prometheus/latest/configuration/unit_testing_rules/#series)
-    # 0+0x30 = 0, 0, 0, ...0 For a total of 31 times THEN 0+10x30 = 0, 10 ,20,  ... 300 For a total of 31 times
-      - series: istio_requests_total{job="ingress-metrics-proxy",response_code="500"}
-        values: "0+0x30 0+10x30"
-    # 0+1x30 = 0, 1, 2, ...30 For a total of 31 times THEN 31+100x30 = 31, 131 ,231, 331 ... 3031 For a total of 31 times
-      - series: istio_requests_total{job="ingress-metrics-proxy"}
-        values: "0+1x30 31+100x30"
-    alert_rule_test:
-      - eval_time: 30m
-        alertname: KuadrantAvailabilityHighErrorRate
-        exp_alerts: []
-      - eval_time: 60m
-        alertname: KuadrantAvailabilityHighErrorRate
-        exp_alerts:
-            - exp_labels:
-                  alertname: KuadrantAvailabilityHighErrorRate
-                  category: availability
-                  owner: kuadrant-org
-                  severity: critical
-                  sloth_id: kuadrant-requests-availability
-                  sloth_service: kuadrant
-                  sloth_severity: page
-                  sloth_slo: requests-availability
-              exp_annotations:
-                  summary: High error rate on HTTPRoute requests responses
-                  title: (page) kuadrant requests-availability SLO error budget burn rate is too fast.
-            - exp_labels:
-                  alertname: KuadrantAvailabilityHighErrorRate
-                  category: availability
-                  owner: kuadrant-org
-                  severity: warning
-                  sloth_id: kuadrant-requests-availability
-                  sloth_service: kuadrant
-                  sloth_severity: ticket
-                  sloth_slo: requests-availability
-              exp_annotations:
-                  summary: High error rate on HTTPRoute requests responses
-                  title: (ticket) kuadrant requests-availability SLO error budget burn rate is too fast.
-
diff --git a/0.10.0/kuadrant-operator/examples/alerts/tests/slo-latency-test.yaml b/0.10.0/kuadrant-operator/examples/alerts/tests/slo-latency-test.yaml
deleted file mode 100644
index de331c0de..000000000
--- a/0.10.0/kuadrant-operator/examples/alerts/tests/slo-latency-test.yaml
+++ /dev/null
@@ -1,47 +0,0 @@
-rule_files:
-  - /prometheus/latency-rules.yaml
-
-evaluation_interval: 1m
-
-tests:
-  - interval: 1m
-    input_series:
-      # Promtool uses expanding notation as its way of creating time series (https://prometheus.io/docs/prometheus/latest/configuration/unit_testing_rules/#series)
-      # 0+1x30 = 0, 1, 2, ...30 For a total of 31 times THEN 31+10x30 = 31, 41 ,51,  ... 331 For a total of 31 times
-      - series: istio_request_duration_milliseconds_bucket{le="250",job="ingress-metrics-proxy",response_code="200"}
-        values: "0+1x30 31+10x30"
-      # 0+1x30 = 0, 1, 2, ...30 For a total of 31 times THEN 31+100x30 = 31, 131 ,231, 331  ... 3031 For a total of 31 times
-      - series: istio_request_duration_milliseconds_count{job="ingress-metrics-proxy",response_code="200"}
-        values: "0+1x30 31+100x30"
-    alert_rule_test:
-      - eval_time: 30m
-        alertname: KuadrantlatencyHighErrorRate
-        exp_alerts: []
-      - eval_time: 60m
-        alertname: KuadrantlatencyHighErrorRate
-        exp_alerts:
-            - exp_labels:
-                  alertname: KuadrantlatencyHighErrorRate
-                  category: latency
-                  owner: kuadrant-org
-                  severity: critical
-                  sloth_id: kuadrant-requests-latency
-                  sloth_service: kuadrant
-                  sloth_severity: page
-                  sloth_slo: requests-latency
-              exp_annotations:
-                  summary: High latency on HTTPRoute requests responses 
-                  title: (page) kuadrant requests-latency SLO error budget burn rate is too fast.
-            - exp_labels:
-                  alertname: KuadrantlatencyHighErrorRate
-                  category: latency
-                  owner: kuadrant-org
-                  severity: warning
-                  sloth_id: kuadrant-requests-latency
-                  sloth_service: kuadrant
-                  sloth_severity: ticket
-                  sloth_slo: requests-latency
-              exp_annotations:
-                  summary: High latency on HTTPRoute requests responses 
-                  title: (ticket) kuadrant requests-latency SLO error budget burn rate is too fast.
-
diff --git a/0.10.0/kuadrant-operator/examples/dashboards/app_developer.json b/0.10.0/kuadrant-operator/examples/dashboards/app_developer.json
deleted file mode 100644
index aa7f03ebe..000000000
--- a/0.10.0/kuadrant-operator/examples/dashboards/app_developer.json
+++ /dev/null
@@ -1,1693 +0,0 @@
-{
-  "__requires": [
-    {
-      "type": "panel",
-      "id": "dashlist",
-      "name": "Dashboard list",
-      "version": ""
-    },
-    {
-      "type": "grafana",
-      "id": "grafana",
-      "name": "Grafana",
-      "version": "9.5.3"
-    },
-    {
-      "type": "datasource",
-      "id": "prometheus",
-      "name": "Prometheus",
-      "version": "1.0.0"
-    },
-    {
-      "type": "panel",
-      "id": "stat",
-      "name": "Stat",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "table",
-      "name": "Table",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "text",
-      "name": "Text",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "timeseries",
-      "name": "Time series",
-      "version": ""
-    }
-  ],
-  "annotations": {
-    "list": [
-      {
-        "builtIn": 1,
-        "datasource": {
-          "type": "datasource",
-          "uid": "grafana"
-        },
-        "enable": true,
-        "hide": true,
-        "iconColor": "rgba(0, 211, 255, 1)",
-        "name": "Annotations & Alerts",
-        "target": {
-          "limit": 100,
-          "matchAny": false,
-          "tags": [],
-          "type": "dashboard"
-        },
-        "type": "dashboard"
-      }
-    ]
-  },
-  "description": "App Developer Dashboard",
-  "editable": true,
-  "fiscalYearStartMonth": 0,
-  "gnetId": 7630,
-  "graphTooltip": 1,
-  "id": null,
-  "links": [],
-  "liveNow": false,
-  "panels": [
-    {
-      "datasource": {
-        "type": "datasource",
-        "uid": "grafana"
-      },
-      "description": "",
-      "gridPos": {
-        "h": 7,
-        "w": 6,
-        "x": 0,
-        "y": 0
-      },
-      "id": 155,
-      "options": {
-        "maxItems": 10,
-        "query": "",
-        "showHeadings": false,
-        "showRecentlyViewed": false,
-        "showSearch": true,
-        "showStarred": false,
-        "tags": [
-          "kuadrant"
-        ]
-      },
-      "pluginVersion": "9.5.3",
-      "title": "Kuadrant Dashboards",
-      "type": "dashlist"
-    },
-    {
-      "datasource": {
-        "type": "datasource",
-        "uid": "grafana"
-      },
-      "description": "",
-      "gridPos": {
-        "h": 7,
-        "w": 18,
-        "x": 6,
-        "y": 0
-      },
-      "id": 153,
-      "options": {
-        "code": {
-          "language": "plaintext",
-          "showLineNumbers": false,
-          "showMiniMap": false
-        },
-        "content": "#### Overview of API/HTTPRoute Metrics\n\nThe row of panels below is repeated for each HTTPRoute resource in your cluster.\nThey provide real-time & historical insights into the performance and health of each API.\nMetrics displayed include request rates, success/error breakdown, and latency percentiles, giving a snapshot of API efficiency and reliability.\nUse this dashboard to monitor traffic patterns, identify potential issues, and ensure optimal performance of your services.\n\n*Important: HTTPRoutes must include a \"service\" and \"deployment\" label with a value that matches the name of the service & deployment being routed to. eg. \"service=myapp, deployment=myapp\"*",
-        "mode": "markdown"
-      },
-      "pluginVersion": "9.5.3",
-      "title": "App Developer Dashboard",
-      "type": "text"
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 7
-      },
-      "id": 141,
-      "panels": [],
-      "repeat": "api",
-      "title": "\"$api\" API - Requests, latency and errors",
-      "type": "row"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Hostname: \"Domain name for the API server.\" | API Namespace: \"Kubernetes namespace where the API is deployed.\" | Gateway name: \"Name of the Gateway API gateway the HTTPRoute is targeting\" | Gateway name: \"Name of the Gateway API gateway namespace\"\n",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "align": "center",
-            "cellOptions": {
-              "type": "auto"
-            },
-            "inspect": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 3,
-        "w": 24,
-        "x": 0,
-        "y": 8
-      },
-      "id": 97,
-      "options": {
-        "cellHeight": "sm",
-        "footer": {
-          "countRows": false,
-          "fields": "",
-          "reducer": [
-            "sum"
-          ],
-          "show": false
-        },
-        "showHeader": true
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_httproute_hostname_info{name=~\"$api\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_httproute_labels{name=~\"$api\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "B"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_httproute_parent_info{name=~\"$api\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "transformations": [
-        {
-          "id": "seriesToColumns",
-          "options": {
-            "byField": "name"
-          }
-        },
-        {
-          "id": "organize",
-          "options": {
-            "excludeByName": {
-              "Time 1": true,
-              "Time 2": true,
-              "Value #A": true,
-              "Value #B": true,
-              "__name__ 1": true,
-              "__name__ 2": true,
-              "cluster_id 1": false,
-              "container 1": true,
-              "container 2": true,
-              "customresource_group 1": true,
-              "customresource_group 2": true,
-              "customresource_kind 1": true,
-              "customresource_kind 2": true,
-              "customresource_version 1": true,
-              "customresource_version 2": true,
-              "deployment": false,
-              "exported_namespace 2": true,
-              "instance 1": true,
-              "instance 2": true,
-              "job 1": true,
-              "job 2": true,
-              "name": true,
-              "namespace 1": false,
-              "namespace 2": true,
-              "namespace 3": false,
-              "parent_name": false,
-              "parent_namespace": false,
-              "prometheus 1": true,
-              "prometheus 2": true,
-              "service": false
-            },
-            "indexByName": {
-              "Time 1": 1,
-              "Time 2": 13,
-              "Time 3": 33,
-              "Value #A": 12,
-              "Value #B": 24,
-              "Value #C": 51,
-              "__name__ 1": 2,
-              "__name__ 2": 14,
-              "__name__ 3": 34,
-              "cluster_id 1": 52,
-              "cluster_id 2": 28,
-              "cluster_id 3": 35,
-              "container 1": 3,
-              "container 2": 15,
-              "container 3": 36,
-              "customresource_group 1": 4,
-              "customresource_group 2": 16,
-              "customresource_group 3": 37,
-              "customresource_kind 1": 5,
-              "customresource_kind 2": 17,
-              "customresource_kind 3": 38,
-              "customresource_version 1": 6,
-              "customresource_version 2": 18,
-              "customresource_version 3": 39,
-              "deployment": 19,
-              "hostname": 7,
-              "instance 1": 8,
-              "instance 2": 20,
-              "instance 3": 40,
-              "job 1": 9,
-              "job 2": 21,
-              "job 3": 41,
-              "name": 0,
-              "namespace 1": 10,
-              "namespace 2": 22,
-              "namespace 3": 42,
-              "parent_group": 43,
-              "parent_kind": 44,
-              "parent_name": 45,
-              "parent_namespace": 46,
-              "prometheus 1": 11,
-              "prometheus 2": 23,
-              "prometheus 3": 47,
-              "receive 1": 25,
-              "receive 2": 29,
-              "receive 3": 48,
-              "replica 1": 26,
-              "replica 2": 30,
-              "replica 3": 49,
-              "service": 31,
-              "tenant_id 1": 27,
-              "tenant_id 2": 32,
-              "tenant_id 3": 50
-            },
-            "renameByName": {
-              "Time 2": "",
-              "Value #C": "",
-              "cluster_id 1": "Cluster ID",
-              "customresource_kind 2": "",
-              "deployment": "API Workload (Deployment)",
-              "exported_namespace 1": "API Namespace",
-              "exported_namespace 2": "",
-              "hostname": "Hostname",
-              "name": "API Name (HTTPRoute)",
-              "namespace 1": "Namespace",
-              "owner": "Owner",
-              "parent_name": "Gateway name",
-              "parent_namespace": "Gateway namespace",
-              "service": "Service"
-            }
-          }
-        },
-        {
-          "id": "filterFieldsByName",
-          "options": {
-            "include": {
-              "names": [
-                "Hostname",
-                "Gateway name",
-                "Gateway namespace",
-                "Cluster ID"
-              ]
-            }
-          }
-        }
-      ],
-      "type": "table"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Requests per second, broken down by response code e.g. 200, 302, 403, 500",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "palette-classic"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineWidth": 1,
-            "pointSize": 1,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": [
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "A"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "blue",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "B"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "light-yellow",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "C"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "light-green",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          }
-        ]
-      },
-      "gridPos": {
-        "h": 6,
-        "w": 9,
-        "x": 0,
-        "y": 11
-      },
-      "id": 156,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{destination_service_name=~\"$api\"}[5m])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "total",
-          "range": true,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{destination_service_name=~\"$api\"}[5m])) by (destination_service_name, response_code) * on(destination_service_name) group_left(name) (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "legendFormat": "{{response_code}}",
-          "range": true,
-          "refId": "B"
-        }
-      ],
-      "title": "request breakdown by code (req/s)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total requests per second",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 9,
-        "y": 11
-      },
-      "id": 137,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum(rate(istio_requests_total{destination_service_name=~\"$api\"}[5m])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "total",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of responses.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "decimals": 0,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "none"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 11,
-        "y": 11
-      },
-      "id": 149,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum(increase(istio_requests_total{destination_service_name=~\"$api\"}[$__range])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{service=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "total",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Time it takes to process a request",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "palette-classic"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineStyle": {
-              "fill": "solid"
-            },
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "ms"
-        },
-        "overrides": [
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "A"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "super-light-blue",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "C"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "light-blue",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "B"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "blue",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          }
-        ]
-      },
-      "gridPos": {
-        "h": 6,
-        "w": 9,
-        "x": 13,
-        "y": 11
-      },
-      "id": 129,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "histogram_quantile(0.95, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name)) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "legendFormat": "P95",
-          "range": true,
-          "refId": "C"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "histogram_quantile(0.90, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name)) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "P90",
-          "range": true,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "histogram_quantile(0.99, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name)) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "legendFormat": "P99",
-          "range": true,
-          "refId": "B"
-        }
-      ],
-      "title": "request latency (percentiles)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "99% of API requests were completed inside this value, while the remaining 1% took longer.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "ms"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 22,
-        "y": 11
-      },
-      "id": 139,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "histogram_quantile(0.99, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name)) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "P99 {{destination_service_name}}",
-          "range": false,
-          "refId": "B"
-        }
-      ],
-      "title": "P99",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Requests per second that resulted in a success (2xx, 3xx).",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "light-green",
-            "mode": "fixed"
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 9,
-        "y": 13
-      },
-      "id": 147,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum(rate(istio_requests_total{response_code=~\"2.*|3.*\",destination_service_name=~\"$api\"}[5m])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "success",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of success response (2xx, 3xx).",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "light-green",
-            "mode": "fixed"
-          },
-          "decimals": 0,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "none"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 11,
-        "y": 13
-      },
-      "id": 150,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum(increase(istio_requests_total{response_code=~\"2.*|3.*\",destination_service_name=~\"$api\"}[$__range])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{service=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "success",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "95% of API requests were completed inside this value, while the remaining 5% took longer.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "light-blue",
-            "mode": "fixed"
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "ms"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 22,
-        "y": 13
-      },
-      "id": 146,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "histogram_quantile(0.95, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name)) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "P95",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Requests per second that resulted in an error (4xx, 5xx).",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "light-yellow",
-            "mode": "fixed"
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 9,
-        "y": 15
-      },
-      "id": 148,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum(rate(istio_requests_total{response_code=~\"4.*|5.*\",destination_service_name=~\"$api\"}[5m])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "error",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of error response (4xx, 5xx).",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "light-yellow",
-            "mode": "fixed"
-          },
-          "decimals": 0,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "none"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 11,
-        "y": 15
-      },
-      "id": 151,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum(increase(istio_requests_total{response_code=~\"4.*|5.*\",destination_service_name=~\"$api\"}[$__range])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{service=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "error",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Shows that 90% of API requests were completed inside this value, while the remaining 10% took longer.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "super-light-blue",
-            "mode": "fixed"
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "ms"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 2,
-        "w": 2,
-        "x": 22,
-        "y": 15
-      },
-      "id": 138,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "histogram_quantile(0.90, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name)) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "instant": true,
-          "legendFormat": "P90 {{destination_service_name}}",
-          "range": false,
-          "refId": "A"
-        }
-      ],
-      "title": "P90",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Requests per second, broken down by response code e.g. 200, 302, 403, 500",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "palette-classic"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineWidth": 1,
-            "pointSize": 1,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": [
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "A"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "blue",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "B"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "light-yellow",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "C"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "light-green",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          }
-        ]
-      },
-      "gridPos": {
-        "h": 9,
-        "w": 9,
-        "x": 0,
-        "y": 17
-      },
-      "id": 99,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{destination_service_name=~\"$api\"}[5m])) by (cluster_id, destination_service_name) * on(cluster_id, destination_service_name) group_right() (group without(instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "\"{{cluster_id}}\" total",
-          "range": true,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{destination_service_name=~\"$api\"}[5m])) by (cluster_id, destination_service_name, response_code) * on(cluster_id, destination_service_name) group_left(name) (group without(instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "legendFormat": "\"{{cluster_id}}\" {{response_code}}",
-          "range": true,
-          "refId": "B"
-        }
-      ],
-      "title": "request breakdown by cluster and code (req/s)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Time it takes to process a request",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "palette-classic"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineStyle": {
-              "fill": "solid"
-            },
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "ms"
-        },
-        "overrides": [
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "A"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "super-light-blue",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "C"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "light-blue",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byFrameRefID",
-              "options": "B"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "blue",
-                  "mode": "fixed"
-                }
-              }
-            ]
-          }
-        ]
-      },
-      "gridPos": {
-        "h": 9,
-        "w": 9,
-        "x": 13,
-        "y": 17
-      },
-      "id": 157,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "histogram_quantile(0.95, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name, cluster_id)) * on(destination_service_name, cluster_id) group_right() (group without(instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "legendFormat": "\"{{cluster_id}}\" P95",
-          "range": true,
-          "refId": "C"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "histogram_quantile(0.90, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name, cluster_id)) * on(destination_service_name, cluster_id) group_right() (group without(instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "\"{{cluster_id}}\" P90",
-          "range": true,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "histogram_quantile(0.99, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$api\"}[5m])) by (le, destination_service_name, cluster_id)) * on(destination_service_name, cluster_id) group_right() (group without(instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{deployment=~\"$api\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "legendFormat": "\"{{cluster_id}}\" P99",
-          "range": true,
-          "refId": "B"
-        }
-      ],
-      "title": "request latency by cluster (percentiles)",
-      "type": "timeseries"
-    }
-  ],
-  "refresh": "30s",
-  "schemaVersion": 38,
-  "style": "dark",
-  "tags": [
-    "kuadrant"
-  ],
-  "templating": {
-    "list": [
-      {
-        "current": {
-          "selected": false,
-          "text": "Kuadrant-Thanos-Hub",
-          "value": "Kuadrant-Thanos-Hub"
-        },
-        "hide": 0,
-        "includeAll": false,
-        "label": "Datasource",
-        "multi": false,
-        "name": "datasource",
-        "options": [],
-        "query": "prometheus",
-        "queryValue": "",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "type": "datasource"
-      },
-      {
-        "current": {},
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(gatewayapi_httproute_labels, name)",
-        "description": "Name of the API",
-        "hide": 0,
-        "includeAll": true,
-        "label": "API name",
-        "multi": true,
-        "name": "api",
-        "options": [],
-        "query": {
-          "query": "label_values(gatewayapi_httproute_labels, name)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      }
-    ]
-  },
-  "time": {
-    "from": "now-15m",
-    "to": "now"
-  },
-  "timepicker": {
-    "refresh_intervals": [
-      "30s",
-      "5m",
-      "15m",
-      "30m",
-      "1h",
-      "2h",
-      "1d"
-    ],
-    "time_options": [
-      "5m",
-      "15m",
-      "1h",
-      "6h",
-      "12h",
-      "24h",
-      "2d",
-      "7d",
-      "30d"
-    ]
-  },
-  "timezone": "",
-  "title": "App Developer Dashboard",
-  "uid": "J_sdY4-Ik",
-  "version": 1,
-  "weekStart": ""
-}
diff --git a/0.10.0/kuadrant-operator/examples/dashboards/business_user.json b/0.10.0/kuadrant-operator/examples/dashboards/business_user.json
deleted file mode 100644
index a5cc60788..000000000
--- a/0.10.0/kuadrant-operator/examples/dashboards/business_user.json
+++ /dev/null
@@ -1,768 +0,0 @@
-{
-  "__requires": [
-    {
-      "type": "panel",
-      "id": "dashlist",
-      "name": "Dashboard list",
-      "version": ""
-    },
-    {
-      "type": "grafana",
-      "id": "grafana",
-      "name": "Grafana",
-      "version": "9.5.3"
-    },
-    {
-      "type": "datasource",
-      "id": "prometheus",
-      "name": "Prometheus",
-      "version": "1.0.0"
-    },
-    {
-      "type": "panel",
-      "id": "state-timeline",
-      "name": "State timeline",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "table",
-      "name": "Table",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "text",
-      "name": "Text",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "timeseries",
-      "name": "Time series",
-      "version": ""
-    }
-  ],
-  "annotations": {
-    "list": [
-      {
-        "builtIn": 1,
-        "datasource": {
-          "type": "datasource",
-          "uid": "grafana"
-        },
-        "enable": true,
-        "hide": true,
-        "iconColor": "rgba(0, 211, 255, 1)",
-        "name": "Annotations & Alerts",
-        "target": {
-          "limit": 100,
-          "matchAny": false,
-          "tags": [],
-          "type": "dashboard"
-        },
-        "type": "dashboard"
-      }
-    ]
-  },
-  "editable": true,
-  "fiscalYearStartMonth": 0,
-  "graphTooltip": 1,
-  "id": null,
-  "links": [],
-  "liveNow": false,
-  "panels": [
-    {
-      "datasource": {
-        "type": "datasource",
-        "uid": "grafana"
-      },
-      "description": "",
-      "gridPos": {
-        "h": 7,
-        "w": 6,
-        "x": 0,
-        "y": 0
-      },
-      "id": 162,
-      "options": {
-        "maxItems": 10,
-        "query": "",
-        "showHeadings": false,
-        "showRecentlyViewed": false,
-        "showSearch": true,
-        "showStarred": false,
-        "tags": [
-          "kuadrant"
-        ]
-      },
-      "pluginVersion": "9.5.3",
-      "title": "Kuadrant Dashboards",
-      "type": "dashlist"
-    },
-    {
-      "datasource": {
-        "type": "datasource",
-        "uid": "grafana"
-      },
-      "description": "",
-      "gridPos": {
-        "h": 7,
-        "w": 18,
-        "x": 6,
-        "y": 0
-      },
-      "id": 150,
-      "options": {
-        "code": {
-          "language": "plaintext",
-          "showLineNumbers": false,
-          "showMiniMap": false
-        },
-        "content": "#### Business Overview of APIs\n\nThe panels below are grouped by APIs, realized by a [Gateway API HTTPRoute](https://gateway-api.sigs.k8s.io/concepts/api-overview/#httproute). Each panel provides a comprehensive overview of request and error metrics associated with each API. Additionally, these panels include a heatmap that visualizes requests per second, offering real-time insights into the traffic patterns and operational status of your services.\n\n*Important: HTTPRoutes must include a \"service\" and \"deployment\" label with a value that matches the name of the service & deployment being routed to. eg. \"service=myapp, deployment=myapp\"*\n",
-        "mode": "markdown"
-      },
-      "pluginVersion": "9.5.3",
-      "title": "Business User Dashboard",
-      "type": "text"
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 7
-      },
-      "id": 6,
-      "panels": [],
-      "repeat": "route_name",
-      "title": "\"$route_name\" API",
-      "type": "row"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Aggregated rate of requests per API (HTTPRoute). The API name can be cross referenced with the API list to see additional details.\n\nNote: HTTPRoutes require a label `deployment` with the name of the corresponding Deployment so that istio request metrics can be paired with HTTPRoute metrics.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineStyle": {
-              "fill": "solid"
-            },
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 0,
-        "y": 8
-      },
-      "id": 4,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": false
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{}[5m])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"${route_name}\",exported_namespace=~\"${api_namespace}\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "API: {{name}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "Traffic summary (req/sec)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "req/s Heatmap",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "continuous-blues"
-          },
-          "custom": {
-            "fillOpacity": 70,
-            "lineWidth": 0,
-            "spanNulls": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 12,
-        "y": 8
-      },
-      "id": 22,
-      "options": {
-        "alignValue": "center",
-        "legend": {
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "mergeValues": false,
-        "rowHeight": 0.9,
-        "showValue": "never",
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum(rate(istio_requests_total{}[5m])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"${route_name}\",exported_namespace=~\"${api_namespace}\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "format": "time_series",
-          "instant": false,
-          "legendFormat": "most recent",
-          "range": true,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{}[5m] offset $__range)) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"${route_name}\",exported_namespace=~\"${api_namespace}\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "format": "time_series",
-          "hide": false,
-          "legendFormat": "previous",
-          "range": true,
-          "refId": "B"
-        }
-      ],
-      "title": "Historical request comparison (req/sec)",
-      "type": "state-timeline"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Aggregated rate of requests per endpoint/path.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "palette-classic"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineStyle": {
-              "fill": "solid"
-            },
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 0,
-        "y": 15
-      },
-      "id": 7,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{}[5m])) by (destination_service_name, request_url_path) * on(destination_service_name) group_left() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"${route_name}\",exported_namespace=~\"${api_namespace}\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "{{request_url_path}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "Breakdown by path (req/sec)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "align": "auto",
-            "cellOptions": {
-              "type": "auto"
-            },
-            "inspect": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 12,
-        "y": 15
-      },
-      "id": 155,
-      "options": {
-        "cellHeight": "sm",
-        "footer": {
-          "countRows": false,
-          "fields": "",
-          "reducer": [
-            "sum"
-          ],
-          "show": false
-        },
-        "showHeader": true
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum by(request_url_path) (increase(istio_requests_total{}[$__range]) * on(destination_service_name) group_left() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"$route_name\",exported_namespace=~\"$api_namespace\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\"))))",
-          "format": "table",
-          "instant": true,
-          "range": false,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum by(request_url_path) (increase(istio_requests_total{}[$__range] offset $__range) * on(destination_service_name) group_left() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"$route_name\",exported_namespace=~\"$api_namespace\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\"))))",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "B"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum by(request_url_path) (increase(istio_requests_total{}[$__range]) * on(destination_service_name) group_left() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"$route_name\",exported_namespace=~\"$api_namespace\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))) - sum by(request_url_path) (increase(istio_requests_total{}[$__range] offset $__range) * on(destination_service_name) group_left() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"$route_name\",exported_namespace=~\"$api_namespace\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\"))))",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "Total requests for selected range",
-      "transformations": [
-        {
-          "id": "seriesToColumns",
-          "options": {
-            "byField": "request_url_path"
-          }
-        },
-        {
-          "id": "organize",
-          "options": {
-            "excludeByName": {
-              "Time": true,
-              "Time 1": true,
-              "Time 2": true,
-              "Time 3": true,
-              "connection_security_policy 1": true,
-              "connection_security_policy 2": true,
-              "connection_security_policy 3": true,
-              "destination_app 1": true,
-              "destination_app 2": true,
-              "destination_app 3": true,
-              "destination_canonical_revision 1": true,
-              "destination_canonical_revision 2": true,
-              "destination_canonical_revision 3": true,
-              "destination_canonical_service 1": true,
-              "destination_canonical_service 2": true,
-              "destination_canonical_service 3": true,
-              "destination_cluster 1": true,
-              "destination_cluster 2": true,
-              "destination_cluster 3": true,
-              "destination_port 1": true,
-              "destination_port 2": true,
-              "destination_port 3": true,
-              "destination_principal 1": true,
-              "destination_principal 2": true,
-              "destination_principal 3": true,
-              "destination_service 1": true,
-              "destination_service 2": true,
-              "destination_service 3": true,
-              "destination_service_name 1": true,
-              "destination_service_name 2": true,
-              "destination_service_name 3": true,
-              "destination_service_namespace 1": true,
-              "destination_service_namespace 2": true,
-              "destination_service_namespace 3": true,
-              "destination_version 1": true,
-              "destination_version 2": true,
-              "destination_version 3": true,
-              "destination_workload 1": true,
-              "destination_workload 2": true,
-              "destination_workload 3": true,
-              "destination_workload_namespace 1": true,
-              "destination_workload_namespace 2": true,
-              "destination_workload_namespace 3": true,
-              "endpoint 1": true,
-              "endpoint 2": true,
-              "endpoint 3": true,
-              "instance 1": true,
-              "instance 2": true,
-              "instance 3": true,
-              "istio_io_gateway_name 1": true,
-              "istio_io_gateway_name 2": true,
-              "istio_io_gateway_name 3": true,
-              "job 1": true,
-              "job 2": true,
-              "job 3": true,
-              "namespace 1": true,
-              "namespace 2": true,
-              "namespace 3": true,
-              "pod 1": true,
-              "pod 2": true,
-              "pod 3": true,
-              "pod_template_hash 1": true,
-              "pod_template_hash 2": true,
-              "pod_template_hash 3": true,
-              "prometheus 1": true,
-              "prometheus 2": true,
-              "prometheus 3": true,
-              "receive 1": true,
-              "receive 2": true,
-              "receive 3": true,
-              "replica 1": true,
-              "replica 2": true,
-              "replica 3": true,
-              "reporter 1": true,
-              "reporter 2": true,
-              "reporter 3": true,
-              "request_host 1": true,
-              "request_host 2": true,
-              "request_host 3": true,
-              "request_protocol 1": true,
-              "request_protocol 2": true,
-              "request_protocol 3": true,
-              "response_code 1": true,
-              "response_code 2": true,
-              "response_code 3": true,
-              "response_flags 1": true,
-              "response_flags 2": true,
-              "response_flags 3": true,
-              "service 1": true,
-              "service 2": true,
-              "service 3": true,
-              "service_istio_io_canonical_name 1": true,
-              "service_istio_io_canonical_name 2": true,
-              "service_istio_io_canonical_name 3": true,
-              "service_istio_io_canonical_revision 1": true,
-              "service_istio_io_canonical_revision 2": true,
-              "service_istio_io_canonical_revision 3": true,
-              "sidecar_istio_io_inject 1": true,
-              "sidecar_istio_io_inject 2": true,
-              "sidecar_istio_io_inject 3": true,
-              "source_canonical_revision 1": true,
-              "source_canonical_revision 2": true,
-              "source_canonical_revision 3": true,
-              "source_canonical_service 1": true,
-              "source_canonical_service 2": true,
-              "source_canonical_service 3": true,
-              "source_cluster 1": true,
-              "source_cluster 2": true,
-              "source_cluster 3": true,
-              "source_principal 1": true,
-              "source_principal 2": true,
-              "source_principal 3": true,
-              "source_workload 1": true,
-              "source_workload 2": true,
-              "source_workload 3": true,
-              "source_workload_namespace 1": true,
-              "source_workload_namespace 2": true,
-              "source_workload_namespace 3": true,
-              "tenant_id 1": true,
-              "tenant_id 2": true,
-              "tenant_id 3": true
-            },
-            "indexByName": {},
-            "renameByName": {
-              "Value #A": "Most recent",
-              "Value #B": "Previous",
-              "Value #C": "Increase/Decrease",
-              "request_url_path": "Request path"
-            }
-          }
-        }
-      ],
-      "type": "table"
-    }
-  ],
-  "refresh": "30s",
-  "schemaVersion": 38,
-  "style": "dark",
-  "tags": [
-    "kuadrant"
-  ],
-  "templating": {
-    "list": [
-      {
-        "current": {
-          "selected": false,
-          "text": "Kuadrant-Thanos-Hub",
-          "value": "Kuadrant-Thanos-Hub"
-        },
-        "hide": 0,
-        "includeAll": false,
-        "multi": false,
-        "name": "datasource",
-        "options": [],
-        "query": "prometheus",
-        "queryValue": "",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "type": "datasource"
-      },
-      {
-        "current": {},
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(kube_namespace_created, exported_namespace)",
-        "description": "Namespace of HTTPRoute resources",
-        "hide": 0,
-        "includeAll": true,
-        "label": "API/HTTPRoute Namespace",
-        "multi": true,
-        "name": "api_namespace",
-        "options": [],
-        "query": {
-          "query": "label_values(kube_namespace_created, exported_namespace)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      },
-      {
-        "current": {},
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(gatewayapi_httproute_labels, name)",
-        "description": "Name of the HTTPRoute resource",
-        "hide": 0,
-        "includeAll": true,
-        "label": "API/Route Name",
-        "multi": true,
-        "name": "route_name",
-        "options": [],
-        "query": {
-          "query": "label_values(gatewayapi_httproute_labels, name)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      }
-    ]
-  },
-  "time": {
-    "from": "now-30m",
-    "to": "now"
-  },
-  "timepicker": {
-    "refresh_intervals": [
-      "30s",
-      "5m",
-      "15m",
-      "30m",
-      "1h",
-      "2h",
-      "1d"
-    ],
-    "time_options": [
-      "5m",
-      "15m",
-      "1h",
-      "6h",
-      "12h",
-      "24h",
-      "2d",
-      "7d",
-      "30d"
-    ]
-  },
-  "timezone": "",
-  "title": "Business User Dashboard",
-  "uid": "jA3LDk-Iz",
-  "version": 1,
-  "weekStart": ""
-}
diff --git a/0.10.0/kuadrant-operator/examples/dashboards/controller-resources-metrics.json b/0.10.0/kuadrant-operator/examples/dashboards/controller-resources-metrics.json
deleted file mode 100644
index 1658cc8e0..000000000
--- a/0.10.0/kuadrant-operator/examples/dashboards/controller-resources-metrics.json
+++ /dev/null
@@ -1,339 +0,0 @@
-{
-  "__requires": [
-    {
-      "type": "datasource",
-      "id": "prometheus",
-      "name": "Prometheus",
-      "version": "1.0.0"
-    }
-  ],
-  "annotations": {
-    "list": [
-      {
-        "builtIn": 1,
-        "datasource": {
-          "type": "datasource",
-          "uid": "grafana"
-        },
-        "enable": true,
-        "hide": true,
-        "iconColor": "rgba(0, 211, 255, 1)",
-        "name": "Annotations & Alerts",
-        "target": {
-          "limit": 100,
-          "matchAny": false,
-          "tags": [],
-          "type": "dashboard"
-        },
-        "type": "dashboard"
-      }
-    ]
-  },
-  "editable": true,
-  "fiscalYearStartMonth": 0,
-  "graphTooltip": 0,
-  "links": [],
-  "liveNow": false,
-  "panels": [
-    {
-      "datasource": {
-        "type": "datasource",
-        "uid": "grafana"
-      },
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "continuous-GrYlRd"
-          },
-          "custom": {
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 20,
-            "gradientMode": "scheme",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "smooth",
-            "lineWidth": 3,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "percent"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 8,
-        "w": 12,
-        "x": 0,
-        "y": 0
-      },
-      "id": 2,
-      "interval": "1m",
-      "links": [],
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom"
-        },
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "pluginVersion": "8.4.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "rate(process_cpu_seconds_total{job=\"$job\", namespace=\"$namespace\", pod=\"$pod\"}[5m]) * 100",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 2,
-          "legendFormat": "Pod: {{pod}} | Container: {{container}}",
-          "refId": "A",
-          "step": 10
-        }
-      ],
-      "title": "Controller CPU Usage",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "continuous-GrYlRd"
-          },
-          "custom": {
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 20,
-            "gradientMode": "scheme",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "smooth",
-            "lineWidth": 3,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "bytes"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 8,
-        "w": 12,
-        "x": 12,
-        "y": 0
-      },
-      "id": 4,
-      "interval": "1m",
-      "links": [],
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom"
-        },
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "pluginVersion": "8.4.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "process_resident_memory_bytes{job=\"$job\", namespace=\"$namespace\", pod=\"$pod\"}",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 2,
-          "legendFormat": "Pod: {{pod}} | Container: {{container}}",
-          "refId": "A",
-          "step": 10
-        }
-      ],
-      "title": "Controller Memory Usage",
-      "type": "timeseries"
-    }
-  ],
-  "refresh": "",
-  "style": "dark",
-  "tags": [],
-  "templating": {
-    "list": [
-      {
-        "current": {
-          "selected": false,
-          "text": "Kuadrant-Thanos-Hub",
-          "value": "Kuadrant-Thanos-Hub"
-        },
-        "hide": 0,
-        "includeAll": false,
-        "label": "Datasource",
-        "multi": false,
-        "name": "datasource",
-        "options": [],
-        "query": "prometheus",
-        "queryValue": "",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "type": "datasource"
-      },
-      {
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(controller_runtime_reconcile_total{namespace=~\"$namespace\"}, job)",
-        "hide": 0,
-        "includeAll": false,
-        "multi": false,
-        "name": "job",
-        "options": [],
-        "query": {
-          "query": "label_values(controller_runtime_reconcile_total{namespace=~\"$namespace\"}, job)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 2,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      },
-      {
-        "current": {
-          "selected": false,
-          "text": "observability",
-          "value": "observability"
-        },
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(controller_runtime_reconcile_total, namespace)",
-        "hide": 0,
-        "includeAll": false,
-        "multi": false,
-        "name": "namespace",
-        "options": [],
-        "query": {
-          "query": "label_values(controller_runtime_reconcile_total, namespace)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      },
-      {
-        "current": {
-          "selected": false,
-          "text": "All",
-          "value": "$__all"
-        },
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(controller_runtime_reconcile_total{namespace=~\"$namespace\", job=\"$job\"}, pod)",
-        "hide": 2,
-        "includeAll": true,
-        "label": "pod",
-        "multi": true,
-        "name": "pod",
-        "options": [],
-        "query": {
-          "query": "label_values(controller_runtime_reconcile_total{namespace=~\"$namespace\", job=\"$job\"}, pod)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 2,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      }
-    ]
-  },
-  "time": {
-    "from": "now-15m",
-    "to": "now"
-  },
-  "timepicker": {},
-  "timezone": "",
-  "title": "Controller-Resources-Metrics",
-  "weekStart": ""
-}
diff --git a/0.10.0/kuadrant-operator/examples/dashboards/controller-runtime-metrics.json b/0.10.0/kuadrant-operator/examples/dashboards/controller-runtime-metrics.json
deleted file mode 100644
index e2c8ec6e5..000000000
--- a/0.10.0/kuadrant-operator/examples/dashboards/controller-runtime-metrics.json
+++ /dev/null
@@ -1,776 +0,0 @@
-{
-  "__requires": [
-    {
-      "type": "datasource",
-      "id": "prometheus",
-      "name": "Prometheus",
-      "version": "1.0.0"
-    }
-  ],
-  "annotations": {
-    "list": [
-      {
-        "builtIn": 1,
-        "datasource": {
-          "type": "datasource",
-          "uid": "grafana"
-        },
-        "enable": true,
-        "hide": true,
-        "iconColor": "rgba(0, 211, 255, 1)",
-        "name": "Annotations & Alerts",
-        "target": {
-          "limit": 100,
-          "matchAny": false,
-          "tags": [],
-          "type": "dashboard"
-        },
-        "type": "dashboard"
-      }
-    ]
-  },
-  "editable": true,
-  "fiscalYearStartMonth": 0,
-  "graphTooltip": 0,
-  "links": [],
-  "liveNow": false,
-  "panels": [
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 0
-      },
-      "id": 9,
-      "panels": [],
-      "title": "Reconciliation Metrics",
-      "type": "row"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of reconciliations per controller",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "continuous-GrYlRd"
-          },
-          "custom": {
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 20,
-            "gradientMode": "scheme",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "smooth",
-            "lineWidth": 3,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "cpm"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 0,
-        "y": 1
-      },
-      "id": 7,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom"
-        },
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": true,
-          "expr": "sum(rate(controller_runtime_reconcile_total{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, pod)",
-          "interval": "",
-          "legendFormat": "{{instance}} {{pod}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "Total Reconciliation Count Per Controller",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of reconciliation errors per controller",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "continuous-GrYlRd"
-          },
-          "custom": {
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 20,
-            "gradientMode": "scheme",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "smooth",
-            "lineWidth": 3,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "cpm"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 12,
-        "y": 1
-      },
-      "id": 6,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom"
-        },
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": true,
-          "expr": "sum(rate(controller_runtime_reconcile_errors_total{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, pod)",
-          "interval": "",
-          "legendFormat": "{{instance}} {{pod}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "Reconciliation Error Count Per Controller",
-      "type": "timeseries"
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 8
-      },
-      "id": 11,
-      "panels": [],
-      "title": "Work Queue Metrics",
-      "type": "row"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "How long in seconds an item stays in workqueue before being requested",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "palette-classic"
-          },
-          "custom": {
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 10,
-            "gradientMode": "none",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "normal"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "s"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 0,
-        "y": 9
-      },
-      "id": 13,
-      "options": {
-        "legend": {
-          "calcs": [
-            "max",
-            "mean"
-          ],
-          "displayMode": "list",
-          "placement": "right"
-        },
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "histogram_quantile(0.50, sum(rate(workqueue_queue_duration_seconds_bucket{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, name, le))",
-          "interval": "",
-          "legendFormat": "P50 {{name}} {{instance}} ",
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "histogram_quantile(0.90, sum(rate(workqueue_queue_duration_seconds_bucket{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, name, le))",
-          "hide": false,
-          "interval": "",
-          "legendFormat": "P90 {{name}} {{instance}} ",
-          "refId": "B"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "histogram_quantile(0.99, sum(rate(workqueue_queue_duration_seconds_bucket{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, name, le))",
-          "hide": false,
-          "interval": "",
-          "legendFormat": "P99 {{name}} {{instance}} ",
-          "refId": "C"
-        }
-      ],
-      "title": "Seconds For Items Stay In Queue (before being requested) (P50, P90, P99)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "continuous-GrYlRd"
-          },
-          "custom": {
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 20,
-            "gradientMode": "scheme",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "smooth",
-            "lineWidth": 3,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "ops"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 12,
-        "y": 9
-      },
-      "id": 15,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom"
-        },
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "pluginVersion": "8.4.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "sum(rate(workqueue_adds_total{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, name)",
-          "interval": "",
-          "legendFormat": "{{name}} {{instance}}",
-          "refId": "A"
-        }
-      ],
-      "title": "Work Queue Add Rate",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "How long in seconds processing an item from workqueue takes.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "palette-classic"
-          },
-          "custom": {
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 10,
-            "gradientMode": "none",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "s"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 0,
-        "y": 16
-      },
-      "id": 19,
-      "options": {
-        "legend": {
-          "calcs": [
-            "max",
-            "mean"
-          ],
-          "displayMode": "table",
-          "placement": "right"
-        },
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "histogram_quantile(0.50, sum(rate(workqueue_work_duration_seconds_bucket{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, name, le))",
-          "interval": "",
-          "legendFormat": "P50 {{name}} {{instance}} ",
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "histogram_quantile(0.90, sum(rate(workqueue_work_duration_seconds_bucket{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, name, le))",
-          "hide": false,
-          "interval": "",
-          "legendFormat": "P90 {{name}} {{instance}} ",
-          "refId": "B"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "histogram_quantile(0.99, sum(rate(workqueue_work_duration_seconds_bucket{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, name, le))",
-          "hide": false,
-          "interval": "",
-          "legendFormat": "P99 {{name}} {{instance}} ",
-          "refId": "C"
-        }
-      ],
-      "title": "Seconds Processing Items From WorkQueue (P50, P90, P99)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of retries handled by workqueue",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "continuous-GrYlRd"
-          },
-          "custom": {
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 20,
-            "gradientMode": "scheme",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "smooth",
-            "lineWidth": 3,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "ops"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 12,
-        "x": 12,
-        "y": 16
-      },
-      "id": 17,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom"
-        },
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "exemplar": true,
-          "expr": "sum(rate(workqueue_retries_total{job=\"$job\", namespace=\"$namespace\"}[5m])) by (instance, name)",
-          "interval": "",
-          "legendFormat": "{{name}} {{instance}} ",
-          "refId": "A"
-        }
-      ],
-      "title": "Work Queue Retries Rate",
-      "type": "timeseries"
-    }
-  ],
-  "refresh": "",
-  "style": "dark",
-  "tags": [],
-  "templating": {
-    "list": [
-      {
-        "current": {
-          "selected": false,
-          "text": "Kuadrant-Thanos-Hub",
-          "value": "Kuadrant-Thanos-Hub"
-        },
-        "hide": 0,
-        "includeAll": false,
-        "label": "Datasource",
-        "multi": false,
-        "name": "datasource",
-        "options": [],
-        "query": "prometheus",
-        "queryValue": "",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "type": "datasource"
-      },
-      {
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(controller_runtime_reconcile_total{namespace=~\"$namespace\"}, job)",
-        "hide": 0,
-        "includeAll": false,
-        "multi": false,
-        "name": "job",
-        "options": [],
-        "query": {
-          "query": "label_values(controller_runtime_reconcile_total{namespace=~\"$namespace\"}, job)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 2,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      },
-      {
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(controller_runtime_reconcile_total, namespace)",
-        "hide": 0,
-        "includeAll": false,
-        "multi": false,
-        "name": "namespace",
-        "options": [],
-        "query": {
-          "query": "label_values(controller_runtime_reconcile_total, namespace)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      },
-      {
-        "current": {
-          "selected": true,
-          "text": [
-            "All"
-          ],
-          "value": [
-            "$__all"
-          ]
-        },
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(controller_runtime_reconcile_total{namespace=~\"$namespace\", job=~\"$job\"}, pod)",
-        "hide": 2,
-        "includeAll": true,
-        "label": "pod",
-        "multi": true,
-        "name": "pod",
-        "options": [],
-        "query": {
-          "query": "label_values(controller_runtime_reconcile_total{namespace=~\"$namespace\", job=~\"$job\"}, pod)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 2,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      }
-    ]
-  },
-  "time": {
-    "from": "now-15m",
-    "to": "now"
-  },
-  "timepicker": {},
-  "timezone": "",
-  "title": "Controller-Runtime-Metrics",
-  "weekStart": ""
-}
diff --git a/0.10.0/kuadrant-operator/examples/dashboards/kustomization.yaml b/0.10.0/kuadrant-operator/examples/dashboards/kustomization.yaml
deleted file mode 100644
index 96a64d330..000000000
--- a/0.10.0/kuadrant-operator/examples/dashboards/kustomization.yaml
+++ /dev/null
@@ -1,28 +0,0 @@
-apiVersion: kustomize.config.k8s.io/v1beta1
-kind: Kustomization
-
-# grafana-dashboard dashboards as configmaps
-configMapGenerator:
-- name: grafana-app-developer
-  namespace: monitoring
-  files:
-  - ./app_developer.json
-- name: grafana-business-user
-  namespace: monitoring
-  files:
-  - ./business_user.json
-- name: grafana-platform-engineer
-  namespace: monitoring
-  files:
-  - ./platform_engineer.json
-- name: grafana-controller-runtime
-  namespace: monitoring
-  files:
-  - ./controller-runtime-metrics.json
-- name: grafana-controller-resources
-  namespace: monitoring
-  files:
-  - ./controller-resources-metrics.json    
-
-generatorOptions:
-  disableNameSuffixHash: true
diff --git a/0.10.0/kuadrant-operator/examples/dashboards/platform_engineer.json b/0.10.0/kuadrant-operator/examples/dashboards/platform_engineer.json
deleted file mode 100644
index 24589a3a7..000000000
--- a/0.10.0/kuadrant-operator/examples/dashboards/platform_engineer.json
+++ /dev/null
@@ -1,2616 +0,0 @@
-{
-  "__requires": [
-    {
-      "type": "panel",
-      "id": "dashlist",
-      "name": "Dashboard list",
-      "version": ""
-    },
-    {
-      "type": "grafana",
-      "id": "grafana",
-      "name": "Grafana",
-      "version": "9.5.3"
-    },
-    {
-      "type": "datasource",
-      "id": "prometheus",
-      "name": "Prometheus",
-      "version": "1.0.0"
-    },
-    {
-      "type": "panel",
-      "id": "stat",
-      "name": "Stat",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "state-timeline",
-      "name": "State timeline",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "table",
-      "name": "Table",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "text",
-      "name": "Text",
-      "version": ""
-    },
-    {
-      "type": "panel",
-      "id": "timeseries",
-      "name": "Time series",
-      "version": ""
-    }
-  ],
-  "annotations": {
-    "list": [
-      {
-        "builtIn": 1,
-        "datasource": {
-          "type": "datasource",
-          "uid": "grafana"
-        },
-        "enable": true,
-        "hide": true,
-        "iconColor": "rgba(0, 211, 255, 1)",
-        "name": "Annotations & Alerts",
-        "target": {
-          "limit": 100,
-          "matchAny": false,
-          "tags": [],
-          "type": "dashboard"
-        },
-        "type": "dashboard"
-      }
-    ]
-  },
-  "description": "APIs",
-  "editable": true,
-  "fiscalYearStartMonth": 0,
-  "gnetId": 7630,
-  "graphTooltip": 1,
-  "id": null,
-  "links": [],
-  "liveNow": false,
-  "panels": [
-    {
-      "datasource": {
-        "type": "datasource",
-        "uid": "grafana"
-      },
-      "description": "",
-      "gridPos": {
-        "h": 7,
-        "w": 6,
-        "x": 0,
-        "y": 0
-      },
-      "id": 152,
-      "options": {
-        "maxItems": 10,
-        "query": "",
-        "showHeadings": false,
-        "showRecentlyViewed": false,
-        "showSearch": true,
-        "showStarred": false,
-        "tags": [
-          "kuadrant"
-        ]
-      },
-      "pluginVersion": "9.5.3",
-      "title": "Kuadrant Dashboards",
-      "type": "dashlist"
-    },
-    {
-      "datasource": {
-        "type": "datasource",
-        "uid": "grafana"
-      },
-      "description": "",
-      "gridPos": {
-        "h": 7,
-        "w": 18,
-        "x": 6,
-        "y": 0
-      },
-      "id": 150,
-      "options": {
-        "code": {
-          "language": "plaintext",
-          "showLineNumbers": false,
-          "showMiniMap": false
-        },
-        "content": "#### Overview of Gateways, Policies and APIs\n\nThe panels below are grouped by Gateways and APIs. A Gateway is a [Gateway API defined gateway](https://gateway-api.sigs.k8s.io/concepts/api-overview/#gateway) resource. An API is realised by a [Gateway API HTTPRoute](https://gateway-api.sigs.k8s.io/concepts/api-overview/#httproute).\nAny policies [attached to the Gateways and APIs](https://gateway-api.sigs.k8s.io/geps/gep-713/) will be shown, as well as summary request and error metrics for APIs.\n\n*Important: HTTPRoutes must include a \"service\" and \"deployment\" label with a value that matches the name of the service & deployment being routed to. eg. \"service=myapp, deployment=myapp\"*",
-        "mode": "markdown"
-      },
-      "pluginVersion": "9.5.3",
-      "title": "Platform Engineer Dashboard",
-      "type": "text"
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 7
-      },
-      "id": 128,
-      "panels": [],
-      "title": "Gateways",
-      "type": "row"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of Gateway API gateways",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "mappings": [],
-          "noValue": "0",
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 3,
-        "w": 3,
-        "x": 0,
-        "y": 8
-      },
-      "id": 146,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "count(gatewayapi_gateway_info{exported_namespace=~\"${gateway_namespace}\"})",
-          "instant": true,
-          "range": false,
-          "refId": "A"
-        }
-      ],
-      "title": "Total",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "List of all Gateways, their class and status.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "align": "center",
-            "cellOptions": {
-              "type": "auto"
-            },
-            "inspect": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          }
-        },
-        "overrides": [
-          {
-            "matcher": {
-              "id": "byName",
-              "options": "Programmed"
-            },
-            "properties": [
-              {
-                "id": "unit",
-                "value": "bool"
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byName",
-              "options": "Accepted"
-            },
-            "properties": [
-              {
-                "id": "unit",
-                "value": "bool"
-              }
-            ]
-          }
-        ]
-      },
-      "gridPos": {
-        "h": 9,
-        "w": 21,
-        "x": 3,
-        "y": 8
-      },
-      "id": 115,
-      "options": {
-        "cellHeight": "sm",
-        "footer": {
-          "countRows": false,
-          "fields": "",
-          "reducer": [
-            "sum"
-          ],
-          "show": false
-        },
-        "frameIndex": 0,
-        "showHeader": true,
-        "sortBy": []
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_gateway_info{exported_namespace=~\"${gateway_namespace}\"}",
-          "format": "table",
-          "instant": true,
-          "range": false,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_gateway_status{exported_namespace=~\"${gateway_namespace}\",type=\"Programmed\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "B"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_gateway_status{exported_namespace=~\"${gateway_namespace}\",type=\"Accepted\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "C"
-        }
-      ],
-      "title": "Gateways",
-      "transformations": [
-        {
-          "id": "concatenate",
-          "options": {
-            "frameNameLabel": "frame",
-            "frameNameMode": "drop"
-          }
-        },
-        {
-          "id": "organize",
-          "options": {
-            "excludeByName": {
-              "Time": true,
-              "Value #A": true,
-              "__name__ 1": true,
-              "__name__ 2": true,
-              "__name__ 3": true,
-              "cluster_id 2": true,
-              "cluster_id 3": true,
-              "container 1": true,
-              "container 2": true,
-              "container 3": true,
-              "customresource_group 1": true,
-              "customresource_group 2": true,
-              "customresource_group 3": true,
-              "customresource_kind 1": true,
-              "customresource_kind 2": true,
-              "customresource_kind 3": true,
-              "customresource_version 1": true,
-              "customresource_version 2": true,
-              "customresource_version 3": true,
-              "exported_namespace 1": false,
-              "exported_namespace 2": true,
-              "exported_namespace 3": true,
-              "instance 1": true,
-              "instance 2": true,
-              "instance 3": true,
-              "job 1": true,
-              "job 2": true,
-              "job 3": true,
-              "name 1": false,
-              "name 2": true,
-              "name 3": true,
-              "namespace 1": true,
-              "namespace 2": true,
-              "namespace 3": true,
-              "prometheus 1": true,
-              "prometheus 2": true,
-              "prometheus 3": true,
-              "receive 1": true,
-              "receive 2": true,
-              "receive 3": true,
-              "replica 1": true,
-              "replica 2": true,
-              "replica 3": true,
-              "tenant_id 1": true,
-              "tenant_id 2": true,
-              "tenant_id 3": true,
-              "type 1": true,
-              "type 2": true
-            },
-            "indexByName": {
-              "Time": 1,
-              "Value #A": 13,
-              "Value #B": 26,
-              "Value #C": 39,
-              "__name__ 1": 2,
-              "__name__ 2": 14,
-              "__name__ 3": 27,
-              "container 1": 3,
-              "container 2": 15,
-              "container 3": 28,
-              "customresource_group 1": 4,
-              "customresource_group 2": 16,
-              "customresource_group 3": 29,
-              "customresource_kind 1": 5,
-              "customresource_kind 2": 17,
-              "customresource_kind 3": 30,
-              "customresource_version 1": 6,
-              "customresource_version 2": 18,
-              "customresource_version 3": 31,
-              "exported_namespace 1": 8,
-              "exported_namespace 2": 19,
-              "exported_namespace 3": 32,
-              "gatewayclass_name": 0,
-              "instance 1": 9,
-              "instance 2": 20,
-              "instance 3": 33,
-              "job 1": 10,
-              "job 2": 21,
-              "job 3": 34,
-              "name 1": 7,
-              "name 2": 22,
-              "name 3": 35,
-              "namespace 1": 11,
-              "namespace 2": 23,
-              "namespace 3": 36,
-              "prometheus 1": 12,
-              "prometheus 2": 24,
-              "prometheus 3": 37,
-              "type 1": 25,
-              "type 2": 38
-            },
-            "renameByName": {
-              "Time": "",
-              "Value #B": "Programmed",
-              "Value #C": "Accepted",
-              "__name__ 3": "",
-              "cluster_id 1": "Cluster ID",
-              "exported_namespace 1": "Namespace",
-              "gatewayclass_name": "Gateway Class",
-              "job 1": "",
-              "name 1": "Name"
-            }
-          }
-        }
-      ],
-      "type": "table"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total Gateways with an [Accepted and Programmed](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io%2fv1.GatewayConditionType) state of True",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "light-green",
-            "mode": "fixed"
-          },
-          "mappings": [],
-          "noValue": "0",
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 3,
-        "w": 3,
-        "x": 0,
-        "y": 11
-      },
-      "id": 147,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "count(gatewayapi_gateway_status{exported_namespace=~\"${gateway_namespace}\",type=\"Accepted\"} > 0 and ignoring(type) gatewayapi_gateway_status{exported_namespace=~\"${gateway_namespace}\",type=\"Programmed\"} > 0)",
-          "instant": true,
-          "range": false,
-          "refId": "A"
-        }
-      ],
-      "title": "Healthy",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total Gateways with a False or missing [Accepted or Programmed](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io%2fv1.GatewayConditionType) state.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "light-yellow",
-            "mode": "fixed"
-          },
-          "mappings": [],
-          "noValue": "0",
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 3,
-        "w": 3,
-        "x": 0,
-        "y": 14
-      },
-      "id": 148,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "count(\n(gatewayapi_gateway_info{exported_namespace=~\"${gateway_namespace}\"} * on(name, exported_namespace, instance) group_left gatewayapi_gateway_status{exported_namespace=~\"${gateway_namespace}\",type=\"Programmed\"} < 1)\nor ignoring(type) \n(gatewayapi_gateway_info{exported_namespace=~\"${gateway_namespace}\"} * on(name, exported_namespace, instance) group_left gatewayapi_gateway_status{exported_namespace=~\"${gateway_namespace}\",type=\"Accepted\"} < 1)\n)",
-          "instant": true,
-          "range": false,
-          "refId": "A"
-        }
-      ],
-      "title": "Unhealthy",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "List of all listeners in Gateways",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "align": "center",
-            "cellOptions": {
-              "type": "auto"
-            },
-            "inspect": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 9,
-        "w": 12,
-        "x": 0,
-        "y": 17
-      },
-      "id": 154,
-      "options": {
-        "cellHeight": "sm",
-        "footer": {
-          "countRows": false,
-          "fields": "",
-          "reducer": [
-            "sum"
-          ],
-          "show": false
-        },
-        "frameIndex": 0,
-        "showHeader": true,
-        "sortBy": []
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_gateway_listener_info{exported_namespace=~\"${gateway_namespace}\"}",
-          "format": "table",
-          "instant": true,
-          "range": false,
-          "refId": "A"
-        }
-      ],
-      "title": "Gateway Listeners",
-      "transformations": [
-        {
-          "id": "organize",
-          "options": {
-            "excludeByName": {
-              "Time": true,
-              "Value": true,
-              "Value #A": true,
-              "Value #B": true,
-              "Value #C": true,
-              "Value #D": true,
-              "__name__": true,
-              "container": true,
-              "customresource_group": true,
-              "customresource_kind": true,
-              "customresource_version": true,
-              "instance": true,
-              "job": true,
-              "namespace": false,
-              "prometheus": true,
-              "receive": true,
-              "replica": true,
-              "target_group": true,
-              "tenant_id": true
-            },
-            "indexByName": {
-              "Time": 0,
-              "Value": 21,
-              "__name__": 1,
-              "allowed_routes_namespaces_from": 19,
-              "cluster_id": 20,
-              "container": 2,
-              "customresource_group": 3,
-              "customresource_kind": 4,
-              "customresource_version": 5,
-              "hostname": 11,
-              "instance": 7,
-              "job": 8,
-              "listener_name": 12,
-              "name": 6,
-              "namespace": 9,
-              "port": 13,
-              "prometheus": 10,
-              "protocol": 14,
-              "receive": 15,
-              "replica": 16,
-              "tenant_id": 17,
-              "tls_mode": 18
-            },
-            "renameByName": {
-              "Value #A": "",
-              "allowed_routes_namespaces_from": "Allowed Routes NS",
-              "cluster_id": "Cluster ID",
-              "customresource_kind": "Kind",
-              "exported_namespace": "Namespace",
-              "hostname": "Hostname",
-              "listener_name": "Listener",
-              "name": "Gateway",
-              "namespace": "Gateway NS",
-              "port": "Port",
-              "protocol": "Protocol",
-              "receive": "",
-              "target_kind": "Target Kind",
-              "target_name": "Target Name",
-              "tls_mode": "TLS Mode"
-            }
-          }
-        }
-      ],
-      "type": "table"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "List of all Policies targeting a Gateway",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "align": "center",
-            "cellOptions": {
-              "type": "auto"
-            },
-            "inspect": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 9,
-        "w": 12,
-        "x": 12,
-        "y": 17
-      },
-      "id": 117,
-      "options": {
-        "cellHeight": "sm",
-        "footer": {
-          "countRows": false,
-          "fields": "",
-          "reducer": [
-            "sum"
-          ],
-          "show": false
-        },
-        "frameIndex": 0,
-        "showHeader": true,
-        "sortBy": []
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_tlspolicy_target_info{exported_namespace=~\"${gateway_namespace}\",target_kind=\"Gateway\"}",
-          "format": "table",
-          "instant": true,
-          "range": false,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_ratelimitpolicy_target_info{exported_namespace=~\"${gateway_namespace}\",target_kind=\"Gateway\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "B"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_authpolicy_target_info{exported_namespace=~\"${gateway_namespace}\",target_kind=\"Gateway\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "C"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_dnspolicy_target_info{exported_namespace=~\"${gateway_namespace}\",target_kind=\"Gateway\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "D"
-        }
-      ],
-      "title": "Gateway Policies",
-      "transformations": [
-        {
-          "id": "merge",
-          "options": {}
-        },
-        {
-          "id": "organize",
-          "options": {
-            "excludeByName": {
-              "Time": true,
-              "Value": true,
-              "Value #A": true,
-              "Value #B": true,
-              "Value #C": true,
-              "Value #D": true,
-              "__name__": true,
-              "container": true,
-              "customresource_group": true,
-              "customresource_version": true,
-              "instance": true,
-              "job": true,
-              "namespace": true,
-              "prometheus": true,
-              "receive": true,
-              "replica": true,
-              "target_group": true,
-              "tenant_id": true
-            },
-            "indexByName": {
-              "Time": 0,
-              "Value #A": 15,
-              "Value #B": 16,
-              "__name__": 1,
-              "container": 2,
-              "customresource_group": 3,
-              "customresource_kind": 4,
-              "customresource_version": 5,
-              "exported_namespace": 7,
-              "instance": 8,
-              "job": 9,
-              "name": 6,
-              "namespace": 10,
-              "prometheus": 11,
-              "target_group": 12,
-              "target_kind": 13,
-              "target_name": 14
-            },
-            "renameByName": {
-              "Value #A": "",
-              "cluster_id": "Cluster ID",
-              "customresource_kind": "Kind",
-              "exported_namespace": "Namespace",
-              "name": "Name",
-              "namespace": "Namespace",
-              "receive": "",
-              "target_kind": "Target Kind",
-              "target_name": "Target Name"
-            }
-          }
-        }
-      ],
-      "type": "table"
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 26
-      },
-      "id": 145,
-      "panels": [],
-      "title": "APIs/HTTPRoutes",
-      "type": "row"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "List of all APIs (HTTPRoutes) and their hostnames & corresponding Deployment names.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "align": "center",
-            "cellOptions": {
-              "type": "auto"
-            },
-            "inspect": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 6,
-        "w": 12,
-        "x": 0,
-        "y": 27
-      },
-      "id": 97,
-      "options": {
-        "cellHeight": "sm",
-        "footer": {
-          "countRows": false,
-          "fields": "",
-          "reducer": [
-            "sum"
-          ],
-          "show": false
-        },
-        "showHeader": true
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_httproute_hostname_info{name=~\"${route_name}\",exported_namespace=~\"${api_policy_namespace}\"}",
-          "format": "table",
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_httproute_labels{name=~\"${route_name}\",exported_namespace=~\"${api_policy_namespace}\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "B"
-        }
-      ],
-      "title": "APIs/HTTPRoutes",
-      "transformations": [
-        {
-          "id": "concatenate",
-          "options": {
-            "frameNameLabel": "frame",
-            "frameNameMode": "drop"
-          }
-        },
-        {
-          "id": "organize",
-          "options": {
-            "excludeByName": {
-              "Time": true,
-              "Value #A": true,
-              "Value #B": true,
-              "__name__ 1": true,
-              "__name__ 2": true,
-              "cluster_id 2": true,
-              "container 1": true,
-              "container 2": true,
-              "customresource_group 1": true,
-              "customresource_group 2": true,
-              "customresource_kind 1": true,
-              "customresource_kind 2": true,
-              "customresource_version 1": true,
-              "customresource_version 2": true,
-              "instance 1": true,
-              "instance 2": true,
-              "job 1": true,
-              "job 2": true,
-              "name 1": true,
-              "name 2": true,
-              "namespace 1": false,
-              "namespace 2": true,
-              "prometheus 1": true,
-              "prometheus 2": true,
-              "receive 1": true,
-              "receive 2": true,
-              "replica 1": true,
-              "replica 2": true,
-              "service": true,
-              "tenant_id 1": true,
-              "tenant_id 2": true
-            },
-            "indexByName": {
-              "Time": 0,
-              "Value #A": 17,
-              "Value #B": 33,
-              "__name__ 1": 1,
-              "__name__ 2": 18,
-              "cluster_id 1": 9,
-              "cluster_id 2": 19,
-              "container 1": 2,
-              "container 2": 20,
-              "customresource_group 1": 3,
-              "customresource_group 2": 21,
-              "customresource_kind 1": 4,
-              "customresource_kind 2": 22,
-              "customresource_version 1": 5,
-              "customresource_version 2": 23,
-              "deployment": 6,
-              "hostname": 7,
-              "instance 1": 10,
-              "instance 2": 24,
-              "job 1": 11,
-              "job 2": 25,
-              "name 1": 12,
-              "name 2": 26,
-              "namespace 1": 8,
-              "namespace 2": 27,
-              "prometheus 1": 13,
-              "prometheus 2": 28,
-              "receive 1": 14,
-              "receive 2": 29,
-              "replica 1": 15,
-              "replica 2": 30,
-              "service": 31,
-              "tenant_id 1": 16,
-              "tenant_id 2": 32
-            },
-            "renameByName": {
-              "cluster_id 1": "Cluster ID",
-              "deployment": "Deployment",
-              "hostname": "Hostname",
-              "namespace 1": "Namespace",
-              "prometheus 2": ""
-            }
-          }
-        }
-      ],
-      "type": "table"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "List of all Policies targeting HTTPRoutes",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "align": "center",
-            "cellOptions": {
-              "type": "auto"
-            },
-            "inspect": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 6,
-        "w": 12,
-        "x": 12,
-        "y": 27
-      },
-      "id": 118,
-      "options": {
-        "cellHeight": "sm",
-        "footer": {
-          "countRows": false,
-          "fields": "",
-          "reducer": [
-            "sum"
-          ],
-          "show": false
-        },
-        "frameIndex": 0,
-        "showHeader": true,
-        "sortBy": []
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_tlspolicy_target_info{exported_namespace=~\"${api_policy_namespace}\",target_kind!=\"Gateway\",target_name=~\"${route_name}\"}",
-          "format": "table",
-          "instant": true,
-          "range": false,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_ratelimitpolicy_target_info{exported_namespace=~\"${api_policy_namespace}\",target_kind!=\"Gateway\",target_name=~\"${route_name}\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "B"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_authpolicy_target_info{exported_namespace=~\"${api_policy_namespace}\",target_kind!=\"Gateway\",target_name=~\"${route_name}\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "C"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "gatewayapi_dnspolicy_target_info{exported_namespace=~\"${api_policy_namespace}\",target_kind!=\"Gateway\",target_name=~\"${route_name}\"}",
-          "format": "table",
-          "hide": false,
-          "instant": true,
-          "range": false,
-          "refId": "D"
-        }
-      ],
-      "title": "HTTPRoute Policies",
-      "transformations": [
-        {
-          "id": "merge",
-          "options": {}
-        },
-        {
-          "id": "organize",
-          "options": {
-            "excludeByName": {
-              "Time": true,
-              "Value": true,
-              "Value #A": true,
-              "Value #B": true,
-              "Value #C": true,
-              "Value #D": true,
-              "__name__": true,
-              "container": true,
-              "customresource_group": true,
-              "customresource_version": true,
-              "instance": true,
-              "job": true,
-              "namespace": false,
-              "prometheus": true,
-              "receive": true,
-              "replica": true,
-              "target_group": true,
-              "tenant_id": true
-            },
-            "indexByName": {
-              "Time": 0,
-              "Value #A": 15,
-              "Value #B": 16,
-              "__name__": 1,
-              "container": 2,
-              "customresource_group": 3,
-              "customresource_kind": 4,
-              "customresource_version": 5,
-              "exported_namespace": 7,
-              "instance": 8,
-              "job": 9,
-              "name": 6,
-              "namespace": 10,
-              "prometheus": 11,
-              "target_group": 12,
-              "target_kind": 13,
-              "target_name": 14
-            },
-            "renameByName": {
-              "Value #A": "",
-              "cluster_id": "Cluster ID",
-              "customresource_kind": "Kind",
-              "exported_namespace": "Namespace",
-              "name": "Name",
-              "namespace": "Namespace",
-              "target_kind": "Target Kind",
-              "target_name": "Target Name",
-              "target_namespace": "Target Namespace"
-            }
-          }
-        }
-      ],
-      "type": "table"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Aggregated rate of requests per API (HTTPRoute). The API name can be cross referenced with the API list to see additional details.\n\nNote: HTTPRoutes require a label `deployment` with the name of the corresponding Deployment so that istio request metrics can be paired with HTTPRoute metrics.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineStyle": {
-              "fill": "solid"
-            },
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 8,
-        "x": 0,
-        "y": 33
-      },
-      "id": 120,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{}[5m])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"${route_name}\",exported_namespace=~\"${api_policy_namespace}\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "API: {{name}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "Total requests (req/sec)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Aggregated rate of requests per API (HTTPRoute). The API name can be cross referenced with the API list to see additional details.\n\nNote: HTTPRoutes require a label `deployment` with the name of the corresponding Deployment so that istio request metrics can be paired with HTTPRoute metrics.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineStyle": {
-              "fill": "solid"
-            },
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 8,
-        "x": 8,
-        "y": 33
-      },
-      "id": 153,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{}[5m])) by (destination_service_name) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{name=~\"${route_name}\",exported_namespace=~\"${api_policy_namespace}\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "API: {{name}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "Total requests (req/sec)",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Aggregated request latencies per API (HTTPRoute). 99th and 95th percentiles are shown. The API name can be cross referenced with the API list to see additional details.\n\nNote: HTTPRoutes require a label `deployment` with the name of the corresponding Deployment so that istio request metrics can be paired with HTTPRoute metrics.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineStyle": {
-              "fill": "solid"
-            },
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "ms"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 8,
-        "x": 16,
-        "y": 33
-      },
-      "id": 137,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "histogram_quantile(0.99, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$route_name\"}[5m])) by (le, destination_service_name)) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{service=~\"$route_name\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "{{service}} - 99th %ile",
-          "range": true,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "histogram_quantile(0.95, sum(irate(istio_request_duration_milliseconds_bucket{destination_service_name=~\"$route_name\"}[5m])) by (le, destination_service_name)) * on(destination_service_name) group_right() (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{service=~\"$route_name\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "legendFormat": "{{service}} - 95th %ile",
-          "range": true,
-          "refId": "C"
-        }
-      ],
-      "title": "Request latency",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "$datasource"
-      },
-      "description": "CPU Usage of all workloads (Deployments) linked to a HTTPRoute. That is, they have a corresponding HTTPRoute with a deployment label.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "normal"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "min": 0,
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "short"
-        },
-        "overrides": [
-          {
-            "matcher": {
-              "id": "byName",
-              "options": "quota - requests"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "#F2495C",
-                  "mode": "fixed"
-                }
-              },
-              {
-                "id": "custom.fillOpacity",
-                "value": 0
-              },
-              {
-                "id": "custom.lineWidth",
-                "value": 2
-              },
-              {
-                "id": "custom.stacking",
-                "value": {
-                  "group": false,
-                  "mode": "normal"
-                }
-              },
-              {
-                "id": "custom.lineStyle",
-                "value": {
-                  "dash": [
-                    10,
-                    10
-                  ],
-                  "fill": "dash"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byName",
-              "options": "quota - limits"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "#FF9830",
-                  "mode": "fixed"
-                }
-              },
-              {
-                "id": "custom.fillOpacity",
-                "value": 0
-              },
-              {
-                "id": "custom.lineWidth",
-                "value": 2
-              },
-              {
-                "id": "custom.stacking",
-                "value": {
-                  "group": false,
-                  "mode": "normal"
-                }
-              },
-              {
-                "id": "custom.lineStyle",
-                "value": {
-                  "dash": [
-                    10,
-                    10
-                  ],
-                  "fill": "dash"
-                }
-              }
-            ]
-          }
-        ]
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 8,
-        "x": 0,
-        "y": 40
-      },
-      "id": 141,
-      "interval": "1m",
-      "links": [],
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "pluginVersion": "8.5.5",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(\n  node_namespace_pod_container:container_cpu_usage_seconds_total:sum_irate{exported_namespace=~\"$api_policy_namespace\"}\n* on(namespace, exported_namespace,pod)\n  group_left(workload, workload_type) namespace_workload_pod:kube_pod_owner:relabel{exported_namespace=~\"$api_policy_namespace\", workload_type=\"deployment\"}\n) by (workload, workload_type)\n* on(workload) (group by(workload) (label_replace(gatewayapi_httproute_labels{exported_namespace=~\"$api_policy_namespace\",name=~\"$route_name\"}, \"workload\", \"$1\",\"deployment\", \"(.+)\")))",
-          "format": "time_series",
-          "legendFormat": "API: {{workload}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "CPU Usage",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "$datasource"
-      },
-      "description": "Memory Usage of all workloads (Deployments) linked to a HTTPRoute. That is, they have a corresponding HTTPRoute with a deployment label.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "blue",
-            "mode": "fixed"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineWidth": 1,
-            "pointSize": 5,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "never",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "normal"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "mappings": [],
-          "min": 0,
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              },
-              {
-                "color": "red",
-                "value": 80
-              }
-            ]
-          },
-          "unit": "bytes"
-        },
-        "overrides": [
-          {
-            "matcher": {
-              "id": "byName",
-              "options": "quota - requests"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "#F2495C",
-                  "mode": "fixed"
-                }
-              },
-              {
-                "id": "custom.fillOpacity",
-                "value": 0
-              },
-              {
-                "id": "custom.lineWidth",
-                "value": 2
-              },
-              {
-                "id": "custom.stacking",
-                "value": {
-                  "group": false,
-                  "mode": "normal"
-                }
-              },
-              {
-                "id": "custom.lineStyle",
-                "value": {
-                  "dash": [
-                    10,
-                    10
-                  ],
-                  "fill": "dash"
-                }
-              }
-            ]
-          },
-          {
-            "matcher": {
-              "id": "byName",
-              "options": "quota - limits"
-            },
-            "properties": [
-              {
-                "id": "color",
-                "value": {
-                  "fixedColor": "#FF9830",
-                  "mode": "fixed"
-                }
-              },
-              {
-                "id": "custom.fillOpacity",
-                "value": 0
-              },
-              {
-                "id": "custom.lineWidth",
-                "value": 2
-              },
-              {
-                "id": "custom.stacking",
-                "value": {
-                  "group": false,
-                  "mode": "normal"
-                }
-              },
-              {
-                "id": "custom.lineStyle",
-                "value": {
-                  "dash": [
-                    10,
-                    10
-                  ],
-                  "fill": "dash"
-                }
-              }
-            ]
-          }
-        ]
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 8,
-        "x": 8,
-        "y": 40
-      },
-      "id": 143,
-      "interval": "1m",
-      "links": [],
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "table",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "pluginVersion": "8.5.5",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(\n    container_memory_working_set_bytes{metrics_path=\"/metrics/cadvisor\", exported_namespace=~\"$api_policy_namespace\", container!=\"\", image!=\"\"}\n  * on(namespace, exported_namespace,pod)\n    group_left(workload, workload_type) namespace_workload_pod:kube_pod_owner:relabel{exported_namespace=~\"$api_policy_namespace\", workload_type=\"deployment\"}\n) by (workload, workload_type)\n* on(workload) (group by(workload) (label_replace(gatewayapi_httproute_labels{exported_namespace=~\"$api_policy_namespace\",name=~\"$route_name\"}, \"workload\", \"$1\",\"deployment\", \"(.+)\")))",
-          "format": "time_series",
-          "legendFormat": "API: {{workload}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "Memory Usage",
-      "type": "timeseries"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Rate of 4xx & 5xx response codes and total HTTP response code errors by API/HTTPRoute",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "fixedColor": "light-yellow",
-            "mode": "continuous-YlRd"
-          },
-          "custom": {
-            "axisCenteredZero": false,
-            "axisColorMode": "text",
-            "axisLabel": "",
-            "axisPlacement": "auto",
-            "axisSoftMin": 0,
-            "barAlignment": 0,
-            "drawStyle": "line",
-            "fillOpacity": 5,
-            "gradientMode": "opacity",
-            "hideFrom": {
-              "legend": false,
-              "tooltip": false,
-              "viz": false
-            },
-            "lineInterpolation": "linear",
-            "lineWidth": 1,
-            "pointSize": 1,
-            "scaleDistribution": {
-              "type": "linear"
-            },
-            "showPoints": "auto",
-            "spanNulls": false,
-            "stacking": {
-              "group": "A",
-              "mode": "none"
-            },
-            "thresholdsStyle": {
-              "mode": "off"
-            }
-          },
-          "decimals": 2,
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          },
-          "unit": "reqps"
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 7,
-        "w": 8,
-        "x": 16,
-        "y": 40
-      },
-      "id": 139,
-      "options": {
-        "legend": {
-          "calcs": [],
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": true
-        },
-        "tooltip": {
-          "mode": "multi",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{response_code=~\"4.*|5.*\"}[5m])) by (destination_service_name, response_code) * on(destination_service_name) group_left(name) (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{exported_namespace=~\"${api_policy_namespace}\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "legendFormat": "{{name}} - {{response_code}}",
-          "range": true,
-          "refId": "A"
-        },
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "expr": "sum(rate(istio_requests_total{response_code=~\"4.*|5.*\"}[5m])) by (destination_service_name) * on(destination_service_name) group_left(name) (group without(cluster_id, instance, app_kubernetes_io_instance) (label_replace(gatewayapi_httproute_labels{exported_namespace=~\"${api_policy_namespace}\"}, \"destination_service_name\", \"$1\",\"service\", \"(.+)\")))",
-          "hide": false,
-          "legendFormat": "{{name}} - Total Errors",
-          "range": true,
-          "refId": "B"
-        }
-      ],
-      "title": "Errors (req/s)",
-      "type": "timeseries"
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 47
-      },
-      "id": 155,
-      "panels": [],
-      "title": "Alerts",
-      "type": "row"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of firing alerts, grouped by Alert Name. Note that there may be more than 1 instance of an alert active based on different labels (like pods or namespace). These will only be counted once here if the alertname is the same for each one.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "mappings": [],
-          "noValue": "0",
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "semi-dark-red",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 4,
-        "w": 3,
-        "x": 0,
-        "y": 48
-      },
-      "id": 156,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "count(sum by(alertname, alertstate, severity, cluster_id) (ALERTS{alertstate=\"firing\"}))",
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "A"
-        }
-      ],
-      "title": "Total Firing",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Currently pending or firing alerts, grouped by Alert Name. Note that there may be more than 1 instance of an alert active based on different labels (like pods or namespace). The total number of instances of an alert in that state is shown in the '# Active` column. For further details on the individual alert instances, check your alerting system.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "align": "center",
-            "cellOptions": {
-              "type": "auto"
-            },
-            "filterable": true,
-            "inspect": false
-          },
-          "mappings": [],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "green",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": [
-          {
-            "matcher": {
-              "id": "byName",
-              "options": "alertstate"
-            },
-            "properties": [
-              {
-                "id": "mappings",
-                "value": [
-                  {
-                    "options": {
-                      "firing": {
-                        "color": "semi-dark-red",
-                        "index": 1,
-                        "text": "Firing"
-                      },
-                      "pending": {
-                        "color": "orange",
-                        "index": 0,
-                        "text": "Pending"
-                      }
-                    },
-                    "type": "value"
-                  }
-                ]
-              },
-              {
-                "id": "custom.cellOptions",
-                "value": {
-                  "mode": "basic",
-                  "type": "color-background"
-                }
-              }
-            ]
-          }
-        ]
-      },
-      "gridPos": {
-        "h": 8,
-        "w": 21,
-        "x": 3,
-        "y": 48
-      },
-      "id": 157,
-      "options": {
-        "cellHeight": "sm",
-        "footer": {
-          "countRows": false,
-          "fields": "",
-          "reducer": [
-            "sum"
-          ],
-          "show": false
-        },
-        "showHeader": true,
-        "sortBy": []
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum by(alertname, alertstate, severity, cluster_id) (ALERTS{alertstate=\"firing\"} or ALERTS{alertstate=\"pending\"})",
-          "format": "table",
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "A"
-        }
-      ],
-      "title": "Currently Active",
-      "transformations": [
-        {
-          "id": "organize",
-          "options": {
-            "excludeByName": {
-              "Time": true,
-              "Value": false,
-              "__name__": true,
-              "container": true,
-              "endpoint": true,
-              "instance": true,
-              "job": true,
-              "namespace": true,
-              "pod": true,
-              "prometheus": true,
-              "receive": true,
-              "replica": true,
-              "rule_group": true,
-              "service": true,
-              "tenant_id": true
-            },
-            "indexByName": {
-              "Time": 0,
-              "Value": 2,
-              "alertname": 1,
-              "alertstate": 3,
-              "cluster_id": 4,
-              "severity": 5
-            },
-            "renameByName": {
-              "Value": "# Active",
-              "alertname": "Name",
-              "alertstate": "State",
-              "cluster_id": "Cluster ID",
-              "severity": "Severity"
-            }
-          }
-        },
-        {
-          "id": "sortBy",
-          "options": {
-            "fields": {},
-            "sort": [
-              {
-                "field": "Name"
-              }
-            ]
-          }
-        }
-      ],
-      "type": "table"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Total number of pending alerts, grouped by Alert Name. Note that there may be more than 1 instance of an alert active based on different labels (like pods or namespace). These will only be counted once here if the alertname is the same for each one.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "mappings": [],
-          "noValue": "0",
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "orange",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 4,
-        "w": 3,
-        "x": 0,
-        "y": 52
-      },
-      "id": 159,
-      "options": {
-        "colorMode": "value",
-        "graphMode": "none",
-        "justifyMode": "auto",
-        "orientation": "auto",
-        "reduceOptions": {
-          "calcs": [
-            "lastNotNull"
-          ],
-          "fields": "",
-          "values": false
-        },
-        "textMode": "auto"
-      },
-      "pluginVersion": "9.5.3",
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "count(sum by(alertname, alertstate, severity, cluster_id) (ALERTS{alertstate=\"pending\"}))",
-          "instant": true,
-          "legendFormat": "__auto",
-          "range": false,
-          "refId": "A"
-        }
-      ],
-      "title": "Total Pending",
-      "type": "stat"
-    },
-    {
-      "datasource": {
-        "type": "prometheus",
-        "uid": "${datasource}"
-      },
-      "description": "Historical state of any alerts that were pending or firing, grouped by Alert Name. Note that more than 1 instance of an alert may have been active based on different labels (like pods or namespace). For further details on the individual alert instances, check your alerting system.",
-      "fieldConfig": {
-        "defaults": {
-          "color": {
-            "mode": "thresholds"
-          },
-          "custom": {
-            "fillOpacity": 100,
-            "lineWidth": 0,
-            "spanNulls": false
-          },
-          "mappings": [
-            {
-              "options": {
-                "firing": {
-                  "color": "semi-dark-red",
-                  "index": 1,
-                  "text": "Firing"
-                },
-                "pending": {
-                  "color": "orange",
-                  "index": 0,
-                  "text": "Pending"
-                }
-              },
-              "type": "value"
-            },
-            {
-              "options": {
-                "match": "empty",
-                "result": {
-                  "color": "light-green",
-                  "index": 2,
-                  "text": "Inactive"
-                }
-              },
-              "type": "special"
-            }
-          ],
-          "thresholds": {
-            "mode": "absolute",
-            "steps": [
-              {
-                "color": "light-green",
-                "value": null
-              }
-            ]
-          }
-        },
-        "overrides": []
-      },
-      "gridPos": {
-        "h": 10,
-        "w": 24,
-        "x": 0,
-        "y": 56
-      },
-      "id": 158,
-      "options": {
-        "alignValue": "center",
-        "legend": {
-          "displayMode": "list",
-          "placement": "bottom",
-          "showLegend": false
-        },
-        "mergeValues": true,
-        "rowHeight": 0.9,
-        "showValue": "auto",
-        "tooltip": {
-          "mode": "single",
-          "sort": "none"
-        }
-      },
-      "targets": [
-        {
-          "datasource": {
-            "type": "prometheus",
-            "uid": "${datasource}"
-          },
-          "editorMode": "code",
-          "exemplar": false,
-          "expr": "sum by(alertname, alertstate, severity, cluster_id) (ALERTS{alertstate=\"firing\"} or ALERTS{alertstate=\"pending\"})",
-          "format": "table",
-          "instant": false,
-          "legendFormat": "{{alertname}}",
-          "range": true,
-          "refId": "A"
-        }
-      ],
-      "title": "Active State Timeline",
-      "transformations": [
-        {
-          "id": "groupingToMatrix",
-          "options": {
-            "columnField": "alertname",
-            "emptyValue": "empty",
-            "rowField": "Time",
-            "valueField": "alertstate"
-          }
-        },
-        {
-          "id": "convertFieldType",
-          "options": {
-            "conversions": [
-              {
-                "destinationType": "time",
-                "targetField": "Time\\alertname"
-              }
-            ],
-            "fields": {}
-          }
-        },
-        {
-          "id": "sortBy",
-          "options": {
-            "fields": {},
-            "sort": [
-              {
-                "desc": false,
-                "field": "Time\\alertname"
-              }
-            ]
-          }
-        }
-      ],
-      "type": "state-timeline"
-    }
-  ],
-  "refresh": "30s",
-  "schemaVersion": 38,
-  "style": "dark",
-  "tags": [
-    "kuadrant"
-  ],
-  "templating": {
-    "list": [
-      {
-        "current": {
-          "selected": false,
-          "text": "Kuadrant-Thanos-Hub",
-          "value": "Kuadrant-Thanos-Hub"
-        },
-        "hide": 0,
-        "includeAll": false,
-        "multi": false,
-        "name": "datasource",
-        "options": [],
-        "query": "prometheus",
-        "queryValue": "",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "type": "datasource"
-      },
-      {
-        "current": {
-          "selected": false,
-          "text": "All",
-          "value": "$__all"
-        },
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(gatewayapi_gateway_info, exported_namespace)",
-        "description": "",
-        "hide": 0,
-        "includeAll": true,
-        "label": "Gateway Namespace",
-        "multi": true,
-        "name": "gateway_namespace",
-        "options": [],
-        "query": {
-          "query": "label_values(gatewayapi_gateway_info, exported_namespace)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      },
-      {
-        "current": {},
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(kube_namespace_created, exported_namespace)",
-        "description": "Namespace of HTTPRoute & Policy resources",
-        "hide": 0,
-        "includeAll": true,
-        "label": "API/Route & Policy Namespace",
-        "multi": true,
-        "name": "api_policy_namespace",
-        "options": [],
-        "query": {
-          "query": "label_values(kube_namespace_created, exported_namespace)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      },
-      {
-        "current": {},
-        "datasource": {
-          "type": "prometheus",
-          "uid": "${datasource}"
-        },
-        "definition": "label_values(gatewayapi_httproute_labels, name)",
-        "description": "Name of the HTTPRoute resource",
-        "hide": 0,
-        "includeAll": true,
-        "label": "API/Route Name",
-        "multi": true,
-        "name": "route_name",
-        "options": [],
-        "query": {
-          "query": "label_values(gatewayapi_httproute_labels, name)",
-          "refId": "StandardVariableQuery"
-        },
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "type": "query"
-      }
-    ]
-  },
-  "time": {
-    "from": "now-1h",
-    "to": "now"
-  },
-  "timepicker": {
-    "refresh_intervals": [
-      "30s",
-      "5m",
-      "15m",
-      "30m",
-      "1h",
-      "2h",
-      "1d"
-    ],
-    "time_options": [
-      "5m",
-      "15m",
-      "1h",
-      "6h",
-      "12h",
-      "24h",
-      "2d",
-      "7d",
-      "30d"
-    ]
-  },
-  "timezone": "",
-  "title": "Platform Engineer Dashboard",
-  "uid": "djqDaDISk",
-  "version": 1,
-  "weekStart": ""
-}
diff --git a/0.10.0/kuadrant-operator/examples/dnspolicy/application.yaml b/0.10.0/kuadrant-operator/examples/dnspolicy/application.yaml
deleted file mode 100644
index 33764d89a..000000000
--- a/0.10.0/kuadrant-operator/examples/dnspolicy/application.yaml
+++ /dev/null
@@ -1,50 +0,0 @@
-apiVersion: gateway.networking.k8s.io/v1
-kind: HTTPRoute
-metadata:
-  name: my-route-${DNSPOLICY_NAMESPACE}
-spec:
-  parentRefs:
-    - kind: Gateway
-      name: prod-web-istio
-      namespace: ${DNSPOLICY_NAMESPACE}
-  hostnames:
-    - "app.${KUADRANT_ZONE_ROOT_DOMAIN}"
-  rules:
-    - backendRefs:
-        - name: echo
-          port: 8080
----
-apiVersion: v1
-kind: Service
-metadata:
-  name: echo
-spec:
-  ports:
-    - name: http-port
-      port: 8080
-      targetPort: http-port
-      protocol: TCP
-  selector:
-    app: echo
----
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: echo
-spec:
-  replicas: 1
-  selector:
-    matchLabels:
-      app: echo
-  template:
-    metadata:
-      labels:
-        app: echo
-    spec:
-      containers:
-        - name: echo
-          image: docker.io/jmalloc/echo-server
-          ports:
-            - name: http-port
-              containerPort: 8080
-              protocol: TCP
diff --git a/0.10.0/kuadrant-operator/examples/dnspolicy/aws-dns-provider-secret.yaml b/0.10.0/kuadrant-operator/examples/dnspolicy/aws-dns-provider-secret.yaml
deleted file mode 100644
index 82a488d50..000000000
--- a/0.10.0/kuadrant-operator/examples/dnspolicy/aws-dns-provider-secret.yaml
+++ /dev/null
@@ -1,10 +0,0 @@
-apiVersion: v1
-kind: Secret
-metadata:
-  name: aws-credentials
-  namespace: ${DNSPOLICY_NAMESPACE}
-type: "kuadrant.io/aws"
-stringData:
-  AWS_ACCESS_KEY_ID: ${KUADRANT_AWS_ACCESS_KEY_ID}
-  AWS_SECRET_ACCESS_KEY: ${KUADRANT_AWS_SECRET_ACCESS_KEY}
-  AWS_REGION: ${KUADRANT_AWS_REGION}
diff --git a/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy-bad-strategy.yaml b/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy-bad-strategy.yaml
deleted file mode 100644
index 33e4606cc..000000000
--- a/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy-bad-strategy.yaml
+++ /dev/null
@@ -1,13 +0,0 @@
-apiVersion: kuadrant.io/v1alpha1
-kind: DNSPolicy
-metadata:
-  name: prod-web
-  namespace: ${DNSPOLICY_NAMESPACE}
-spec:
-  targetRef:
-    name: prod-web-istio
-    group: gateway.networking.k8s.io
-    kind: Gateway
-  providerRefs:
-    - name: aws-credentials
-  routingStrategy: simple
diff --git a/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy-healthchecks.yaml b/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy-healthchecks.yaml
deleted file mode 100644
index 2682fb6ea..000000000
--- a/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy-healthchecks.yaml
+++ /dev/null
@@ -1,23 +0,0 @@
-apiVersion: kuadrant.io/v1alpha1
-kind: DNSPolicy
-metadata:
-  name: prod-web
-  namespace: ${DNSPOLICY_NAMESPACE}
-spec:
-  targetRef:
-    name: prod-web-istio
-    group: gateway.networking.k8s.io
-    kind: Gateway
-  providerRefs:
-    - name: aws-credentials
-  routingStrategy: loadbalanced
-  loadBalancing:
-    weighted:
-      defaultWeight: 120
-    geo:
-      defaultGeo: EU
-  healthCheck:
-    endpoint: /healthz
-    port: 1111111
-    protocol: HTTP
-    failureThreshold: 3
diff --git a/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy.yaml b/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy.yaml
deleted file mode 100644
index 8d8194385..000000000
--- a/0.10.0/kuadrant-operator/examples/dnspolicy/dnspolicy.yaml
+++ /dev/null
@@ -1,18 +0,0 @@
-apiVersion: kuadrant.io/v1alpha1
-kind: DNSPolicy
-metadata:
-  name: prod-web
-  namespace: ${DNSPOLICY_NAMESPACE}
-spec:
-  targetRef:
-    name: prod-web-istio
-    group: gateway.networking.k8s.io
-    kind: Gateway
-  providerRefs:
-    - name: aws-credentials
-  routingStrategy: loadbalanced
-  loadBalancing:
-    weighted:
-      defaultWeight: 120
-    geo:
-      defaultGeo: EU
diff --git a/0.10.0/kuadrant-operator/examples/dnspolicy/gateway.yaml b/0.10.0/kuadrant-operator/examples/dnspolicy/gateway.yaml
deleted file mode 100644
index e5db812be..000000000
--- a/0.10.0/kuadrant-operator/examples/dnspolicy/gateway.yaml
+++ /dev/null
@@ -1,20 +0,0 @@
-apiVersion: gateway.networking.k8s.io/v1
-kind: Gateway
-metadata:
-  name: prod-web-istio
-  namespace: ${DNSPOLICY_NAMESPACE}
-spec:
-  gatewayClassName: istio
-  listeners:
-    - allowedRoutes:
-        namespaces:
-          from: All
-      name: api
-      hostname: app.${KUADRANT_ZONE_ROOT_DOMAIN}
-      port: 443
-      protocol: HTTPS
-      tls:
-        mode: Terminate
-        certificateRefs:
-          - name: example-app-tls
-            kind: Secret
diff --git a/0.10.0/kuadrant-operator/examples/dnspolicy/script.sh b/0.10.0/kuadrant-operator/examples/dnspolicy/script.sh
deleted file mode 100644
index ffa5c5b35..000000000
--- a/0.10.0/kuadrant-operator/examples/dnspolicy/script.sh
+++ /dev/null
@@ -1,27 +0,0 @@
-export DNSPOLICY_NAMESPACE=gateway
-kubectl create ns gateway
-envsubst < examples/dnspolicy/aws-dns-provider-secret.yaml | kubectl apply -f -
-envsubst < examples/dnspolicy/gateway.yaml | kubectl apply -f -
-envsubst < examples/dnspolicy/dnspolicy.yaml | kubectl apply -f -
-envsubst < examples/dnspolicy/application.yaml | kubectl apply -f -
-
-read -r -p "press enter to cause conflict"
-export DNSPOLICY_NAMESPACE=gateway-2
-kubectl create ns gateway-2
-envsubst < examples/dnspolicy/aws-dns-provider-secret.yaml | kubectl apply -f -
-envsubst < examples/dnspolicy/gateway.yaml | kubectl apply -f -
-envsubst < examples/dnspolicy/dnspolicy-bad-strategy.yaml | kubectl apply -f -
-envsubst < examples/dnspolicy/application.yaml | kubectl apply -f -
-
-read -r -p "press enter to delete conflict"
-kubectl delete ns gateway-2
-
-read -r -p "press enter to configure bad health checks"
-export DNSPOLICY_NAMESPACE=gateway
-envsubst < examples/dnspolicy/dnspolicy-healthchecks.yaml | kubectl apply -f -
-
-read -r -p "press enter to configure good health checks"
-kubectl patch dnspolicy prod-web -n ${DNSPOLICY_NAMESPACE} --type='json' -p='[{"op": "replace", "path": "/spec/healthCheck/port", "value":80}]'
-
-read -r -p "press enter to clean up sample"
-kubectl delete ns ${DNSPOLICY_NAMESPACE}
diff --git a/0.10.0/kuadrant-operator/examples/metal-lb.yaml b/0.10.0/kuadrant-operator/examples/metal-lb.yaml
deleted file mode 100644
index a2e5e41d8..000000000
--- a/0.10.0/kuadrant-operator/examples/metal-lb.yaml
+++ /dev/null
@@ -1,14 +0,0 @@
-apiVersion: metallb.io/v1beta1
-kind: IPAddressPool
-metadata:
-  name: example
-  namespace: metallb-system
-spec:
-  addresses:
-  - 172.31.200.0/24
----
-apiVersion: metallb.io/v1beta1
-kind: L2Advertisement
-metadata:
-  name: empty
-  namespace: metallb-system
diff --git a/0.10.0/kuadrant-operator/examples/oas-apikey.yaml b/0.10.0/kuadrant-operator/examples/oas-apikey.yaml
deleted file mode 100644
index 524dfb0fa..000000000
--- a/0.10.0/kuadrant-operator/examples/oas-apikey.yaml
+++ /dev/null
@@ -1,48 +0,0 @@
----
-openapi: "3.1.0"
-info:
-  title: "Pet Store API"
-  version: "1.0.0"
-  x-kuadrant:
-    route:
-      name: "toystore"
-      namespace: $devNS
-      hostnames:
-        - toystore.$rootDomain
-      parentRefs:
-        - name: $gatewayName
-          namespace: $gatewayNS
-servers:
-  - url: https://toystore.$rootDomain/v1
-paths:
-  /toys:
-    get:  # No sec requirements
-      operationId: "getToy"
-      responses:
-        405:
-          description: "invalid input"
-    post:  # API key
-      operationId: "postToy"
-      security:
-        - api_key: []
-      responses:
-        405:
-          description: "invalid input"
-    x-kuadrant:
-      backendRefs:
-      - name: toystore
-        namespace: $devNS
-        port: 80 
-      rate_limit:
-        rates:
-          - limit: 1
-            duration: 10
-            unit: second
-        counters:
-          - request.headers.api_key
-components:
-  securitySchemes:
-    api_key:
-      type: apiKey
-      name: api_key
-      in: header
diff --git a/0.10.0/kuadrant-operator/examples/oas-oidc.yaml b/0.10.0/kuadrant-operator/examples/oas-oidc.yaml
deleted file mode 100644
index 0e9199e71..000000000
--- a/0.10.0/kuadrant-operator/examples/oas-oidc.yaml
+++ /dev/null
@@ -1,55 +0,0 @@
----
-openapi: "3.1.0"
-info:
-  title: "Pet Store API"
-  version: "1.0.0"
-  x-kuadrant:
-    route:
-      name: "toystore"
-      namespace: $devNS
-      hostnames:
-        - toystore.$rootDomain
-      parentRefs:
-        - name: $gatewayName
-          namespace: $gatewayNS
-servers:
-  - url: https://toystore.$rootDomain/v1
-paths:
-  /toys:
-    get:  # No sec requirements
-      operationId: "getToy"
-      responses:
-        405:
-          description: "invalid input"
-      x-kuadrant:  
-        rate_limit:
-          rates:
-            - limit: 1
-              duration: 5
-              unit: second
-          counters:
-            - request.headers.Authorization
-    post:  # OIDC protected
-      operationId: "postToy"
-      security:
-        - oidc: []
-      responses:
-        405:
-          description: "invalid input"
-    x-kuadrant:
-      backendRefs:
-      - name: toystore
-        namespace: $devNS
-        port: 80 
-      rate_limit:
-        rates:
-          - limit: 1
-            duration: 10
-            unit: second
-        counters:
-          - request.headers.Authorization
-components:
-  securitySchemes:
-    oidc:
-      type: openIdConnect
-      openIdConnectUrl: https://$openIDHost/auth/realms/toystore
diff --git a/0.10.0/kuadrant-operator/examples/toystore/admin-key-secret.yaml b/0.10.0/kuadrant-operator/examples/toystore/admin-key-secret.yaml
deleted file mode 100644
index 7893c1e29..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/admin-key-secret.yaml
+++ /dev/null
@@ -1,15 +0,0 @@
----
-apiVersion: v1
-kind: Secret
-metadata:
-  annotations:
-    secret.kuadrant.io/user-id: alice
-  creationTimestamp: null
-  labels:
-    app: toystore
-    admin: "yes"
-    authorino.kuadrant.io/managed-by: authorino
-  name: toystore-admin-apikey
-stringData:
-  api_key: IAMADMIN
-type: Opaque
diff --git a/0.10.0/kuadrant-operator/examples/toystore/alice-api-key-secret.yaml b/0.10.0/kuadrant-operator/examples/toystore/alice-api-key-secret.yaml
deleted file mode 100644
index 744e029b8..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/alice-api-key-secret.yaml
+++ /dev/null
@@ -1,14 +0,0 @@
----
-apiVersion: v1
-kind: Secret
-metadata:
-  annotations:
-    secret.kuadrant.io/user-id: alice
-  creationTimestamp: null
-  labels:
-    app: toystore
-    authorino.kuadrant.io/managed-by: authorino
-  name: toystore-alice-apikey
-stringData:
-  api_key: ALICEKEYFORDEMO
-type: Opaque
diff --git a/0.10.0/kuadrant-operator/examples/toystore/authpolicy.yaml b/0.10.0/kuadrant-operator/examples/toystore/authpolicy.yaml
deleted file mode 100644
index a7a404b71..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/authpolicy.yaml
+++ /dev/null
@@ -1,56 +0,0 @@
----
-apiVersion: kuadrant.io/v1beta2
-kind: AuthPolicy
-metadata:
-  name: toystore
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: toystore
-  routeSelectors:
-  - matches:
-    - path:
-        type: Exact
-        value: "/admin/toy"
-      method: DELETE
-  rules:
-    authentication:
-      "apikey":
-        apiKey:
-          selector:
-            matchLabels:
-              app: toystore
-      credentials:
-        authorizationHeader:
-          prefix: APIKEY
-    response:
-      success:
-        dynamicMetadata:
-          "ext_auth_data":
-            json:
-              properties:
-                "user-id":
-                  selector: auth.identity.metadata.annotations.secret\.kuadrant\.io/user-id
----
-apiVersion: kuadrant.io/v1beta1
-kind: AuthPolicy
-metadata:
-  name: toystore
-  namespace: istio-system
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: Gateway
-    name: istio-ingressgateway
-  rules:
-    authentication:
-      "apikey":
-        apiKey:
-          selector:
-            matchLabels:
-              app: toystore
-              admin: "yes"
-        credentials:
-          authorizationHeader:
-            prefix: APIKEY
diff --git a/0.10.0/kuadrant-operator/examples/toystore/authpolicy_jwt-k8s-authnz.yaml b/0.10.0/kuadrant-operator/examples/toystore/authpolicy_jwt-k8s-authnz.yaml
deleted file mode 100644
index 87b2c8fdf..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/authpolicy_jwt-k8s-authnz.yaml
+++ /dev/null
@@ -1,44 +0,0 @@
-# A Kuadrant AuthPolicy to protect an API with authentication based on OpenId Connect (OIDC) ID tokens (signed JWTs)
-# and Kubernetes Service Account tokens combined, and authorization with permissions (bindings) stored in the
-# Kubernetes RBAC, enforced by Authorino, Kuadrant's authorization service.
-apiVersion: kuadrant.io/v1beta2
-kind: AuthPolicy
-metadata:
-  name: toystore-protection
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: toystore
-  rules:
-    # The list of trusted identity sources which can send requests the protected API.
-    authentication:
-      # An OIDC authentication server listed as a trusted source of identities which can send requests the protected API.
-      # Authorino will prefetch the JWKS using OpenId Connect Discovery, and verify ID tokens (JWTs) issued by the server
-      # as valid authentication tokens to consume the protected API.
-      # Read more about this feature at https://github.com/Kuadrant/authorino/blob/v0.11.0/docs/user-guides/oidc-jwt-authentication.md.
-      "keycloak-users":
-        jwt:
-          issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant
-
-      # Authorino will verify Kubernetes Service Account tokens, using Kubernetes TokenReview API,
-      # as valid authentication tokens to consume the protected API.
-      # Read more about this feature at https://github.com/Kuadrant/authorino/blob/v0.11.0/docs/user-guides/kubernetes-tokenreview.md.
-      "k8s-service-accounts":
-        kubernetesTokenReview:
-          audiences:
-            - https://kubernetes.default.svc.cluster.local
-
-    # Authorino will enforce authorization using Kubernetes SubjectAccessReview API.
-    # Permissions to consume the API are stored in the Kubernetes cluster as ClusterRoles and ClusterRoleBindings.
-    # The path and the method of the request to the protected API will be implicitly used as the rules to check for
-    # an existing binding in the Kubernetes RBAC system.
-    # Read more about this feature at https://github.com/Kuadrant/authorino/blob/v0.11.0/docs/user-guides/kubernetes-subjectaccessreview.md.
-    # For using Roles and RoleBindings instead of ClusterRoles and ClusterRoleBindings, thus more flexible attribute-based
-    # permissions to protect the API, see the spec for `resourceAttributes` in the Authorino docs at
-    # https://github.com/Kuadrant/authorino/blob/v0.11.0/docs/features.md#kubernetes-subjectaccessreview-authorizationkubernetes.
-    authorization:
-      "k8s-rbac":
-        kubernetesSubjectAccessReview:
-          user:
-            selector: auth.identity.sub
diff --git a/0.10.0/kuadrant-operator/examples/toystore/bob-api-key-secret.yaml b/0.10.0/kuadrant-operator/examples/toystore/bob-api-key-secret.yaml
deleted file mode 100644
index e4edd01a1..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/bob-api-key-secret.yaml
+++ /dev/null
@@ -1,14 +0,0 @@
----
-apiVersion: v1
-kind: Secret
-metadata:
-  annotations:
-    secret.kuadrant.io/user-id: bob
-  creationTimestamp: null
-  labels:
-    app: toystore
-    authorino.kuadrant.io/managed-by: authorino
-  name: toystore-bob-apikey
-stringData:
-  api_key: BOBKEYFORDEMO
-type: Opaque
diff --git a/0.10.0/kuadrant-operator/examples/toystore/httproute.yaml b/0.10.0/kuadrant-operator/examples/toystore/httproute.yaml
deleted file mode 100644
index f44f9f9e5..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/httproute.yaml
+++ /dev/null
@@ -1,29 +0,0 @@
----
-apiVersion: gateway.networking.k8s.io/v1
-kind: HTTPRoute
-metadata:
-  name: toystore
-  labels:
-    app: toystore
-spec:
-  parentRefs:
-    - name: istio-ingressgateway
-      namespace: istio-system
-  hostnames: ["*.toystore.com"]
-  rules:
-    - matches:
-        - path:
-            type: PathPrefix
-            value: "/toy"
-          method: GET
-        - path:
-            type: Exact
-            value: "/admin/toy"
-          method: POST
-        - path:
-            type: Exact
-            value: "/admin/toy"
-          method: DELETE
-      backendRefs:
-        - name: toystore
-          port: 80
diff --git a/0.10.0/kuadrant-operator/examples/toystore/kuadrant.yaml b/0.10.0/kuadrant-operator/examples/toystore/kuadrant.yaml
deleted file mode 100644
index 29de2d9a1..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/kuadrant.yaml
+++ /dev/null
@@ -1,6 +0,0 @@
----
-apiVersion: kuadrant.io/v1beta1
-kind: Kuadrant
-metadata:
-  name: kuadrant-sample
-spec: {}
diff --git a/0.10.0/kuadrant-operator/examples/toystore/ratelimitpolicy_gateway.yaml b/0.10.0/kuadrant-operator/examples/toystore/ratelimitpolicy_gateway.yaml
deleted file mode 100644
index 57b53002b..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/ratelimitpolicy_gateway.yaml
+++ /dev/null
@@ -1,30 +0,0 @@
-apiVersion: kuadrant.io/v1beta2
-kind: RateLimitPolicy
-metadata:
-  name: toystore-gw
-  namespace: istio-system
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: Gateway
-    name: istio-ingressgateway
-  limits:
-    "expensive-operation":
-      rates:
-      - limit: 2
-        duration: 30
-        unit: second
-      when:
-      - selector: request.method
-        operator: eq
-        value: POST
-
-    "limit-per-ip":
-      rates:
-      - limit: 5
-        duration: 30
-        unit: second
-      when:
-      - selector: source.ip
-        operator: eq
-        value: source.address
diff --git a/0.10.0/kuadrant-operator/examples/toystore/ratelimitpolicy_httproute.yaml b/0.10.0/kuadrant-operator/examples/toystore/ratelimitpolicy_httproute.yaml
deleted file mode 100644
index de10f7143..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/ratelimitpolicy_httproute.yaml
+++ /dev/null
@@ -1,50 +0,0 @@
-apiVersion: kuadrant.io/v1beta2
-kind: RateLimitPolicy
-metadata:
-  name: toystore-httproute
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: toystore
-  limits:
-    "global":
-      rates:
-      - limit: 6
-        duration: 30
-        unit: second
-
-    "get-toy":
-      rates:
-      - limit: 5
-        duration: 30
-        unit: second
-      routeSelectors:
-      - matches:
-        - path:
-            type: Exact
-            value: "/toy"
-          method: GET
-
-    "admin-post-or-delete-toy-per-user":
-      rates:
-      - limit: 2
-        duration: 30
-        unit: second
-      counters:
-      - metadata.filter_metadata.envoy\.filters\.http\.ext_authz.username
-      routeSelectors:
-      - matches:
-        - path:
-            type: Exact
-            value: "/admin/toy"
-          method: POST
-      - matches:
-        - path:
-            type: Exact
-            value: "/admin/toy"
-          method: DELETE
-      when:
-      - selector: metadata.filter_metadata.envoy\.filters\.http\.ext_authz.admin
-        operator: eq
-        value: "true"
diff --git a/0.10.0/kuadrant-operator/examples/toystore/toystore.yaml b/0.10.0/kuadrant-operator/examples/toystore/toystore.yaml
deleted file mode 100644
index 58451d099..000000000
--- a/0.10.0/kuadrant-operator/examples/toystore/toystore.yaml
+++ /dev/null
@@ -1,39 +0,0 @@
----
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: toystore
-  labels:
-    app: toystore
-spec:
-  selector:
-    matchLabels:
-      app: toystore
-  template:
-    metadata:
-      labels:
-        app: toystore
-    spec:
-      containers:
-        - name: toystore
-          image: quay.io/3scale/authorino:echo-api
-          env:
-            - name: PORT
-              value: "3000"
-          ports:
-            - containerPort: 3000
-              name: http
-  replicas: 1
----
-apiVersion: v1
-kind: Service
-metadata:
-  name: toystore
-spec:
-  selector:
-    app: toystore
-  ports:
-    - name: http
-      port: 80
-      protocol: TCP
-      targetPort: 3000
diff --git a/0.10.0/kuadrant-operator/index.html b/0.10.0/kuadrant-operator/index.html
deleted file mode 100644
index 2c3495d71..000000000
--- a/0.10.0/kuadrant-operator/index.html
+++ /dev/null
@@ -1,3977 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrant-operator/">
-      
-      
-        <link rel="prev" href="../architecture/rfcs/0011-policy-machinery/">
-      
-      
-        <link rel="next" href="doc/development/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrant-operator" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#architecture" class="md-nav__link">
-    <span class="md-ellipsis">
-      Architecture
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Architecture">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-components" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant components
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#provided-apis" class="md-nav__link">
-    <span class="md-ellipsis">
-      Provided APIs
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting started
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Getting started">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#pre-requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pre-requisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#installing-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing Kuadrant
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Installing Kuadrant">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-install-the-kuadrant-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      1. Install the Kuadrant Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-request-a-kuadrant-instance" class="md-nav__link">
-    <span class="md-ellipsis">
-      2. Request a Kuadrant instance
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#protect-your-service" class="md-nav__link">
-    <span class="md-ellipsis">
-      Protect your service
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Protect your service">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#if-you-are-an-api-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      If you are an API Provider
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#if-you-are-a-cluster-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      If you are a Cluster Operator
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#user-guides" class="md-nav__link">
-    <span class="md-ellipsis">
-      User guides
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrant-rate-limiting" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Rate Limiting
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#documentation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Documentation
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#licensing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Licensing
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#architecture" class="md-nav__link">
-    <span class="md-ellipsis">
-      Architecture
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Architecture">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-components" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant components
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#provided-apis" class="md-nav__link">
-    <span class="md-ellipsis">
-      Provided APIs
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting started
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Getting started">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#pre-requisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Pre-requisites
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#installing-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing Kuadrant
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Installing Kuadrant">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-install-the-kuadrant-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      1. Install the Kuadrant Operator
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-request-a-kuadrant-instance" class="md-nav__link">
-    <span class="md-ellipsis">
-      2. Request a Kuadrant instance
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#protect-your-service" class="md-nav__link">
-    <span class="md-ellipsis">
-      Protect your service
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Protect your service">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#if-you-are-an-api-provider" class="md-nav__link">
-    <span class="md-ellipsis">
-      If you are an API Provider
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#if-you-are-a-cluster-operator" class="md-nav__link">
-    <span class="md-ellipsis">
-      If you are a Cluster Operator
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#user-guides" class="md-nav__link">
-    <span class="md-ellipsis">
-      User guides
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#kuadrant-rate-limiting" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant Rate Limiting
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#documentation" class="md-nav__link">
-    <span class="md-ellipsis">
-      Documentation
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#licensing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Licensing
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrant-operator/blob/main/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrant-operator">Kuadrant Operator<a class="headerlink" href="#kuadrant-operator" title="Permanent link">&para;</a></h1>
-<p><a href="https://github.com/Kuadrant/kuadrant-operator/actions/workflows/code-style.yaml"><img alt="Code Style" src="https://github.com/Kuadrant/kuadrant-operator/actions/workflows/code-style.yaml/badge.svg" /></a>
-<a href="https://github.com/Kuadrant/kuadrant-operator/actions/workflows/test.yaml"><img alt="Testing" src="https://github.com/Kuadrant/kuadrant-operator/actions/workflows/test.yaml/badge.svg" /></a>
-<a href="https://codecov.io/gh/Kuadrant/kuadrant-operator"><img alt="codecov" src="https://codecov.io/gh/Kuadrant/kuadrant-operator/branch/main/graph/badge.svg?token=4Z16KPS3HT" /></a>
-<a href="http://www.apache.org/licenses/LICENSE-2.0"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" /></a>
-<a href="https://www.bestpractices.dev/projects/9242"><img alt="OpenSSF Best Practices" src="https://www.bestpractices.dev/projects/9242/badge" /></a>
-<a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Fkuadrant-operator?ref=badge_shield"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Fkuadrant-operator.svg?type=shield" /></a></p>
-<p>The Operator to install and manage the lifecycle of the <a href="https://github.com/Kuadrant/">Kuadrant</a> components deployments.</p>
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>Kuadrant is a re-architecture of API Management using Cloud Native concepts and separating the components to be less coupled,
-more reusable and leverage the underlying kubernetes platform. It aims to deliver a smooth experience to providers and consumers
-of applications &amp; services when it comes to rate limiting, authentication, authorization, discoverability, change management, usage contracts, insights, etc.</p>
-<p>Kuadrant aims to produce a set of loosely coupled functionalities built directly on top of Kubernetes.
-Furthermore, it only strives to provide what Kubernetes doesn’t offer out of the box, i.e. Kuadrant won’t be designing a new Gateway/proxy,
-instead it will opt to connect with what’s there and what’s being developed (think Envoy, Istio, GatewayAPI).</p>
-<p>Kuadrant is a system of cloud-native k8s components that grows as users’ needs grow.</p>
-<ul>
-<li>From simple protection of a Service (via <strong>AuthN</strong>) that is used by teammates working on the same cluster, or “sibling” services, up to <strong>AuthZ</strong> of users using OIDC plus custom policies.</li>
-<li>From no rate-limiting to rate-limiting for global service protection on to rate-limiting by users/plans</li>
-</ul>
-<h2 id="architecture">Architecture<a class="headerlink" href="#architecture" title="Permanent link">&para;</a></h2>
-<p>Kuadrant relies on <a href="https://istio.io/">Istio</a> and the <a href="https://gateway-api.sigs.k8s.io/">Gateway API</a>
-to operate the cluster (Istio's) ingress gateway to provide API management with <strong>authentication</strong> (authN),
-<strong>authorization</strong> (authZ) and <strong>rate limiting</strong> capabilities.</p>
-<h3 id="kuadrant-components">Kuadrant components<a class="headerlink" href="#kuadrant-components" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>CRD</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>Control Plane</td>
-<td>The control plane takes the customer desired configuration (declaratively as kubernetes custom resources) as input and ensures all components are configured to obey customer's desired behavior.<br> This repository contains the source code of the kuadrant control plane</td>
-</tr>
-<tr>
-<td><a href="https://github.com/Kuadrant/kuadrant-operator">Kuadrant Operator</a></td>
-<td>A Kubernetes Operator to manage the lifecycle of the kuadrant deployment</td>
-</tr>
-<tr>
-<td><a href="https://github.com/Kuadrant/authorino">Authorino</a></td>
-<td>The AuthN/AuthZ enforcer. As the <a href="https://istio.io/latest/docs/tasks/security/authorization/authz-custom/">external istio authorizer</a> (<a href="https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/ext_authz_filter">envoy external authorization</a> serving gRPC service)</td>
-</tr>
-<tr>
-<td><a href="https://github.com/Kuadrant/limitador">Limitador</a></td>
-<td>The external rate limiting service. It exposes a gRPC service implementing the <a href="https://www.envoyproxy.io/docs/envoy/latest/api-v3/service/ratelimit/v3/rls.proto">Envoy Rate Limit protocol (v3)</a></td>
-</tr>
-<tr>
-<td><a href="https://github.com/Kuadrant/authorino-operator">Authorino Operator</a></td>
-<td>A Kubernetes Operator to manage Authorino instances</td>
-</tr>
-<tr>
-<td><a href="https://github.com/Kuadrant/limitador-operator">Limitador Operator</a></td>
-<td>A Kubernetes Operator to manage Limitador instances</td>
-</tr>
-<tr>
-<td><a href="https://github.com/Kuadrant/dns-operator">DNS Operator</a></td>
-<td>A Kubernetes Operator to manage DNS records in external providers</td>
-</tr>
-</tbody>
-</table>
-<h3 id="provided-apis">Provided APIs<a class="headerlink" href="#provided-apis" title="Permanent link">&para;</a></h3>
-<p>The kuadrant control plane owns the following <a href="https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/">Custom Resource Definitions, CRDs</a>:</p>
-<table>
-<thead>
-<tr>
-<th>CRD</th>
-<th>Description</th>
-<th>Example</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>AuthPolicy CRD <a href="doc/auth/">[doc]</a> <a href="doc/reference/authpolicy/">[reference]</a></td>
-<td>Enable AuthN and AuthZ based access control on workloads</td>
-<td><a href="https://github.com/Kuadrant/kuadrant-operator/blob/main/examples/toystore/authpolicy.yaml">AuthPolicy CR</a></td>
-</tr>
-<tr>
-<td>RateLimitPolicy CRD <a href="doc/rate-limiting/">[doc]</a> <a href="doc/reference/ratelimitpolicy/">[reference]</a></td>
-<td>Enable access control on workloads based on HTTP rate limiting</td>
-<td><a href="https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/examples/toystore/ratelimitpolicy_httproute.yaml">RateLimitPolicy CR</a></td>
-</tr>
-<tr>
-<td>DNSPolicy CRD <a href="doc/dns/">[doc]</a> <a href="doc/reference/dnspolicy/">[reference]</a></td>
-<td>Enable DNS management</td>
-<td><a href="config/samples/kuadrant_v1alpha1_dnspolicy.yaml">DNSPolicy CR</a></td>
-</tr>
-<tr>
-<td>TLSPolicy CRD <a href="doc/tls/">[doc]</a> <a href="doc/reference/tlspolicy/">[reference]</a></td>
-<td>Enable TLS management</td>
-<td><a href="config/samples/kuadrant_v1alpha1_tlspolicy.yaml">TLSPolicy CR</a></td>
-</tr>
-</tbody>
-</table>
-<p>Additionally, Kuadrant provides the following CRDs</p>
-<table>
-<thead>
-<tr>
-<th>CRD</th>
-<th>Owner</th>
-<th>Description</th>
-<th>Example</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><a href="https://github.com/Kuadrant/kuadrant-operator/blob/main/api/v1beta1/kuadrant_types.go">Kuadrant CRD</a></td>
-<td><a href="https://github.com/Kuadrant/kuadrant-operator">Kuadrant Operator</a></td>
-<td>Represents an instance of kuadrant</td>
-<td><a href="https://github.com/Kuadrant/kuadrant-operator/blob/main/config/samples/kuadrant_v1beta1_kuadrant.yaml">Kuadrant CR</a></td>
-</tr>
-<tr>
-<td><a href="https://github.com/Kuadrant/limitador-operator/blob/main/api/v1alpha1/limitador_types.go">Limitador CRD</a></td>
-<td><a href="https://github.com/Kuadrant/limitador-operator">Limitador Operator</a></td>
-<td>Represents an instance of Limitador</td>
-<td><a href="https://github.com/Kuadrant/limitador-operator/blob/main/config/samples/limitador_v1alpha1_limitador.yaml">Limitador CR</a></td>
-</tr>
-<tr>
-<td><a href="https://docs.kuadrant.io/latest/authorino-operator/#the-authorino-custom-resource-definition-crd">Authorino CRD</a></td>
-<td><a href="https://github.com/Kuadrant/authorino-operator">Authorino Operator</a></td>
-<td>Represents an instance of Authorino</td>
-<td><a href="https://github.com/Kuadrant/authorino-operator/blob/main/config/samples/authorino-operator_v1beta1_authorino.yaml">Authorino CR</a></td>
-</tr>
-</tbody>
-</table>
-<p><img alt="Kuadrant Architecture" src="doc/images/kuadrant-architecture.svg" /></p>
-<h2 id="getting-started">Getting started<a class="headerlink" href="#getting-started" title="Permanent link">&para;</a></h2>
-<h3 id="pre-requisites">Pre-requisites<a class="headerlink" href="#pre-requisites" title="Permanent link">&para;</a></h3>
-<ul>
-<li>Istio is installed in the cluster. Otherwise, refer to the
-  <a href="https://istio.io/latest/docs/setup/getting-started/">Istio getting started guide</a>.</li>
-<li>Kubernetes Gateway API is installed in the cluster. Otherwise,
-  <a href="https://istio.io/latest/docs/tasks/traffic-management/ingress/gateway-api/">configure Istio to expose a service using the Kubernetes Gateway API</a>.</li>
-<li>cert-manager is installed in the cluster. Otherwise, refer to the 
-  <a href="https://cert-manager.io/docs/installation/">cert-manager installation guide</a>.</li>
-</ul>
-<h3 id="installing-kuadrant">Installing Kuadrant<a class="headerlink" href="#installing-kuadrant" title="Permanent link">&para;</a></h3>
-<p>Installing Kuadrant is a two-step procedure. Firstly, install the Kuadrant Operator and secondly,
-request a Kuadrant instance by creating a <em>Kuadrant</em> custom resource.</p>
-<h4 id="1-install-the-kuadrant-operator">1. Install the Kuadrant Operator<a class="headerlink" href="#1-install-the-kuadrant-operator" title="Permanent link">&para;</a></h4>
-<p>The Kuadrant Operator is available in public community operator catalogs, such as the Kubernetes <a href="https://operatorhub.io/operator/kuadrant-operator">OperatorHub.io</a> and the <a href="https://redhat-openshift-ecosystem.github.io/community-operators-prod">Openshift Container Platform and OKD OperatorHub</a>.</p>
-<p><strong>Kubernetes</strong></p>
-<p>The operator is available from <a href="https://operatorhub.io/operator/kuadrant-operator">OperatorHub.io</a>.
-Just go to the linked page and follow installation steps (or just run these two commands):</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="c1"># Install Operator Lifecycle Manager (OLM), a tool to help manage the operators running on your cluster.</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>curl<span class="w"> </span>-sL<span class="w"> </span>https://github.com/operator-framework/operator-lifecycle-manager/releases/download/v0.23.1/install.sh<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash<span class="w"> </span>-s<span class="w"> </span>v0.23.1
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="c1"># Install the operator by running the following command:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>kubectl<span class="w"> </span>create<span class="w"> </span>-f<span class="w"> </span>https://operatorhub.io/install/kuadrant-operator.yaml
-</span></code></pre></div>
-<p><strong>Openshift</strong></p>
-<p>The operator is available from the <a href="https://docs.openshift.com/container-platform/4.11/operators/user/olm-installing-operators-in-namespace.html#olm-installing-from-operatorhub-using-web-console_olm-installing-operators-in-namespace">Openshift Console OperatorHub</a>.
-Just follow installation steps choosing the "Kuadrant Operator" from the catalog:</p>
-<p><img alt="Kuadrant Operator in OperatorHub" src="https://content.cloud.redhat.com/hs-fs/hubfs/ogFyppY.png?width=449&amp;height=380&amp;name=ogFyppY.png" /></p>
-<h4 id="2-request-a-kuadrant-instance">2. Request a Kuadrant instance<a class="headerlink" href="#2-request-a-kuadrant-instance" title="Permanent link">&para;</a></h4>
-<p>Create the namespace:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>kuadrant
-</span></code></pre></div>
-<p>Apply the <code>Kuadrant</code> custom resource:</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>-n<span class="w"> </span>kuadrant<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">---</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">apiVersion: kuadrant.io/v1beta1</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">kind: Kuadrant</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">metadata:</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">  name: kuadrant-sample</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">spec: {}</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="protect-your-service">Protect your service<a class="headerlink" href="#protect-your-service" title="Permanent link">&para;</a></h3>
-<h4 id="if-you-are-an-api-provider">If you are an <em>API Provider</em><a class="headerlink" href="#if-you-are-an-api-provider" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Deploy the service/API to be protected ("Upstream")</li>
-<li>Expose the service/API using the kubernetes Gateway API, ie
-  <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.HTTPRoute">HTTPRoute</a> object.</li>
-<li>Write and apply the Kuadrant's <a href="doc/rate-limiting/">RateLimitPolicy</a> and/or
-  <a href="doc/auth/">AuthPolicy</a> custom resources targeting the HTTPRoute resource
-  to have your API protected.</li>
-</ul>
-<h4 id="if-you-are-a-cluster-operator">If you are a <em>Cluster Operator</em><a class="headerlink" href="#if-you-are-a-cluster-operator" title="Permanent link">&para;</a></h4>
-<ul>
-<li>(Optionally) deploy istio ingress gateway using the
-  <a href="https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.Gateway">Gateway</a> resource.</li>
-<li>Write and apply the Kuadrant's <a href="doc/rate-limiting/">RateLimitPolicy</a> and/or
-  <a href="doc/auth/">AuthPolicy</a> custom resources targeting the Gateway resource
-  to have your gateway traffic protected.</li>
-</ul>
-<h2 id="user-guides">User guides<a class="headerlink" href="#user-guides" title="Permanent link">&para;</a></h2>
-<p>The user guides section of the docs gathers several use-cases as well as the instructions to implement them using kuadrant.</p>
-<ul>
-<li><a href="doc/user-guides/simple-rl-for-app-developers/">Simple Rate Limiting for Application Developers</a></li>
-<li><a href="doc/user-guides/authenticated-rl-for-app-developers/">Authenticated Rate Limiting for Application Developers</a></li>
-<li><a href="doc/user-guides/gateway-rl-for-cluster-operators/">Gateway Rate Limiting for Cluster Operators</a></li>
-<li><a href="doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/">Authenticated Rate Limiting with JWTs and Kubernetes RBAC</a></li>
-</ul>
-<h2 id="kuadrant-rate-limiting"><a href="doc/rate-limiting/">Kuadrant Rate Limiting</a><a class="headerlink" href="#kuadrant-rate-limiting" title="Permanent link">&para;</a></h2>
-<h2 id="documentation">Documentation<a class="headerlink" href="#documentation" title="Permanent link">&para;</a></h2>
-<p>Docs can be found on the <a href="https://kuadrant.io/">Kuadrant website</a>.</p>
-<h2 id="contributing">Contributing<a class="headerlink" href="#contributing" title="Permanent link">&para;</a></h2>
-<p>The <a href="doc/development/">Development guide</a> describes how to build the kuadrant operator and
-how to test your changes before submitting a patch or opening a PR.</p>
-<p>Join us on the <a href="https://kubernetes.slack.com/archives/C05J0D0V525">#kuadrant</a> channel in the Kubernetes Slack workspace,
-for live discussions about the roadmap and more.</p>
-<h2 id="licensing">Licensing<a class="headerlink" href="#licensing" title="Permanent link">&para;</a></h2>
-<p>This software is licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 license</a>.</p>
-<p>See the LICENSE and NOTICE files that should have been provided along with this software for details.</p>
-<p><a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Fkuadrant-operator?ref=badge_large"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Fkuadrant-operator.svg?type=large" /></a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/RELEASE/index.html b/0.10.0/kuadrantctl/doc/RELEASE/index.html
deleted file mode 100644
index c95b6d261..000000000
--- a/0.10.0/kuadrantctl/doc/RELEASE/index.html
+++ /dev/null
@@ -1,3452 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/RELEASE/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>RELEASE - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#release" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              RELEASE
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#release" class="md-nav__link">
-    <span class="md-ellipsis">
-      Release
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Release">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#new-majorminorpatch-version" class="md-nav__link">
-    <span class="md-ellipsis">
-      New Major.Minor.Patch version
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#verify-new-release-is-available" class="md-nav__link">
-    <span class="md-ellipsis">
-      Verify new release is available
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/RELEASE.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>RELEASE</h1>
-
-<h2 id="release">Release<a class="headerlink" href="#release" title="Permanent link">&para;</a></h2>
-<p>The release process follows a streamlined approach, no release branches involved.
-New releases can be major, minor or patch based releases, but always incrementing digits
-regarding the latest release version.</p>
-<h3 id="new-majorminorpatch-version">New Major.Minor.Patch version<a class="headerlink" href="#new-majorminorpatch-version" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Create a new minor release branch from the HEAD of main:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>checkout<span class="w"> </span>-b<span class="w"> </span>release-vX.Y.Z
-</span></code></pre></div></li>
-<li>Update version (prefixed with <strong>"v"</strong>):
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>prepare-release<span class="w"> </span><span class="nv">VERSION</span><span class="o">=</span>vX.Y.Z
-</span></code></pre></div></li>
-<li>Verify local changes:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>make<span class="w"> </span>install
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>bin/kuadrantctl<span class="w"> </span>version
-</span></code></pre></div>
-The output should be the new version, for example :
-<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kuadrantctl v0.3.0 (ff779a1-dirty)
-</span></code></pre></div></li>
-<li>Commit and push:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>git<span class="w"> </span>add<span class="w"> </span>.
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>git<span class="w"> </span>commit<span class="w"> </span>-m<span class="w"> </span><span class="s2">&quot;prepare-release: release-vX.Y.Z&quot;</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>git<span class="w"> </span>push<span class="w"> </span>origin<span class="w"> </span>release-vX.Y.Z
-</span></code></pre></div></li>
-<li>Create git tag:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>git<span class="w"> </span>tag<span class="w"> </span>-s<span class="w"> </span>-m<span class="w"> </span>vX.Y.Z<span class="w"> </span>vX.Y.Z
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>git<span class="w"> </span>push<span class="w"> </span>origin<span class="w"> </span>vX.Y.Z
-</span></code></pre></div></li>
-<li>
-<p>In Github, <a href="https://github.com/Kuadrant/kuadrantctl/releases/new">create release</a>.</p>
-</li>
-<li>
-<p>Pick recently pushed git tag</p>
-</li>
-<li>Automatically generate release notes from previous released tag</li>
-<li>
-<p>Set as the latest release</p>
-</li>
-<li>
-<p>Verify that the build <a href="https://github.com/Kuadrant/kuadrantctl/actions/workflows/release.yaml">Release workflow</a> is triggered and completes for the new tag</p>
-</li>
-</ol>
-<h3 id="verify-new-release-is-available">Verify new release is available<a class="headerlink" href="#verify-new-release-is-available" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Download the latest binary for your platform from the <a href="https://github.com/Kuadrant/kuadrantctl/releases/latest"><code>kuadrantctl</code> Latest Releases</a> page.</li>
-<li>Unpack the binary.</li>
-<li>Move it to a directory in your <code>$PATH</code> so that it can be executed from anywhere.</li>
-<li>Check the version:
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kuadrantctl<span class="w"> </span>version
-</span></code></pre></div>
-The output should be the new version, for example :
-<div class="language-text highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kuadrantctl v0.3.0 (eec318b2e11e7ea5add5e550ff872bde64555d8f)
-</span></code></pre></div></li>
-</ol>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/development/index.html b/0.10.0/kuadrantctl/doc/development/index.html
deleted file mode 100644
index 7a1587bd3..000000000
--- a/0.10.0/kuadrantctl/doc/development/index.html
+++ /dev/null
@@ -1,3415 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/development/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Development Guide - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#development-guide" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Development Guide
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#technology-stack-required-for-development" class="md-nav__link">
-    <span class="md-ellipsis">
-      Technology stack required for development
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build-the-cli" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build the CLI
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#quick-steps-to-contribute" class="md-nav__link">
-    <span class="md-ellipsis">
-      Quick steps to contribute
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/development.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="development-guide">Development Guide<a class="headerlink" href="#development-guide" title="Permanent link">&para;</a></h1>
-<h2 id="technology-stack-required-for-development">Technology stack required for development<a class="headerlink" href="#technology-stack-required-for-development" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="https://git-scm.com/downloads">git</a></li>
-<li><a href="https://golang.org/">go</a> version 1.21+</li>
-</ul>
-<h2 id="build-the-cli">Build the CLI<a class="headerlink" href="#build-the-cli" title="Permanent link">&para;</a></h2>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>$ git clone https://github.com/kuadrant/kuadrantctl.git
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>$ cd kuadrantctl &amp;&amp; make install
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>$ bin/kuadrantctl version
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>{&quot;level&quot;:&quot;info&quot;,&quot;ts&quot;:&quot;2023-11-08T23:44:57+01:00&quot;,&quot;msg&quot;:&quot;kuadrantctl version: latest&quot;}
-</span></code></pre></div>
-<h2 id="quick-steps-to-contribute">Quick steps to contribute<a class="headerlink" href="#quick-steps-to-contribute" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Fork the project.</li>
-<li>Download your fork to your PC (<code>git clone https://github.com/your_username/kuadrantctl &amp;&amp; cd kuadrantctl</code>)</li>
-<li>Create your feature branch (<code>git checkout -b my-new-feature</code>)</li>
-<li>Make changes and run tests (<code>make test</code>)</li>
-<li>Add them to staging (<code>git add .</code>)</li>
-<li>Commit your changes (<code>git commit -m 'Add some feature'</code>)</li>
-<li>Push to the branch (<code>git push origin my-new-feature</code>)</li>
-<li>Create new pull request</li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/generate-gateway-api-httproute/index.html b/0.10.0/kuadrantctl/doc/generate-gateway-api-httproute/index.html
deleted file mode 100644
index 0d9646175..000000000
--- a/0.10.0/kuadrantctl/doc/generate-gateway-api-httproute/index.html
+++ /dev/null
@@ -1,3509 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/generate-gateway-api-httproute/">
-      
-      
-        <link rel="prev" href="../../">
-      
-      
-        <link rel="next" href="../generate-kuadrant-auth-policy/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Generating Gateway API HTTPRoutes - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#generate-gateway-api-httproute-object-from-openapi-3" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Generating Gateway API HTTPRoutes
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#generate-gateway-api-httproute-object-from-openapi-3" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate Gateway API HTTPRoute object from OpenAPI 3
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Generate Gateway API HTTPRoute object from OpenAPI 3">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openapi-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenAPI specification
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#usage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Usage
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#generate-gateway-api-httproute-object-from-openapi-3" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate Gateway API HTTPRoute object from OpenAPI 3
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Generate Gateway API HTTPRoute object from OpenAPI 3">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openapi-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenAPI specification
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#usage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Usage
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/generate-gateway-api-httproute.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Generating Gateway API HTTPRoutes</h1>
-
-<h2 id="generate-gateway-api-httproute-object-from-openapi-3">Generate Gateway API HTTPRoute object from OpenAPI 3<a class="headerlink" href="#generate-gateway-api-httproute-object-from-openapi-3" title="Permanent link">&para;</a></h2>
-<p>The <code>kuadrantctl generate gatewayapi httproute</code> command generates an <a href="https://gateway-api.sigs.k8s.io/api-types/httproute/">Gateway API HTTPRoute</a>
-from your <a href="https://spec.openapis.org/oas/latest.html">OpenAPI Specification (OAS) 3.x</a> powered with <a href="../openapi-kuadrant-extensions/">kuadrant extensions</a>.</p>
-<h3 id="openapi-specification">OpenAPI specification<a class="headerlink" href="#openapi-specification" title="Permanent link">&para;</a></h3>
-<p>An OpenAPI document resource can be provided to the cli by one of the following channels:</p>
-<ul>
-<li>Filename in the available path.</li>
-<li>URL format (supported schemes are HTTP and HTTPS). The CLI will try to download from the given address.</li>
-<li>Read from stdin standard input stream.</li>
-</ul>
-<h3 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">&para;</a></h3>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>$<span class="w"> </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>gatewayapi<span class="w"> </span>httproute<span class="w"> </span>-h
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>Generate<span class="w"> </span>Gateway<span class="w"> </span>API<span class="w"> </span>HTTPRoute<span class="w"> </span>from<span class="w"> </span>OpenAPI<span class="w"> </span><span class="m">3</span>.0.X
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>Usage:
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>gatewayapi<span class="w"> </span>httproute<span class="w"> </span><span class="o">[</span>flags<span class="o">]</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>Flags:
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span>-h,<span class="w"> </span>--help<span class="w">          </span><span class="nb">help</span><span class="w"> </span><span class="k">for</span><span class="w"> </span>httproute
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span>--oas<span class="w"> </span>string<span class="w">        </span>Path<span class="w"> </span>to<span class="w"> </span>OpenAPI<span class="w"> </span>spec<span class="w"> </span>file<span class="w"> </span><span class="o">(</span><span class="k">in</span><span class="w"> </span>JSON<span class="w"> </span>or<span class="w"> </span>YAML<span class="w"> </span>format<span class="o">)</span>,<span class="w"> </span>URL,<span class="w"> </span>or<span class="w"> </span><span class="s1">&#39;-&#39;</span><span class="w"> </span>to<span class="w"> </span><span class="nb">read</span><span class="w"> </span>from<span class="w"> </span>standard<span class="w"> </span>input<span class="w"> </span><span class="o">(</span>required<span class="o">)</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">  </span>-o<span class="w"> </span>Output<span class="w"> </span>format:<span class="w">   </span><span class="s1">&#39;yaml&#39;</span><span class="w"> </span>or<span class="w"> </span><span class="s1">&#39;json&#39;</span>.<span class="w"> </span><span class="o">(</span>default<span class="w"> </span><span class="s2">&quot;yaml&quot;</span><span class="o">)</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>Global<span class="w"> </span>Flags:
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">  </span>-v,<span class="w"> </span>--verbose<span class="w">   </span>verbose<span class="w"> </span>output
-</span></code></pre></div>
-<blockquote>
-<p>Under the example folder there are examples of OAS 3 that can be used to generate the resources</p>
-</blockquote>
-<p>As an AuthPolicy and RateLimitPolicy both require a HTTPRoute to target, the user guides for generating those policies include examples of running the <code>kuadrantctl generate gatewayapi httproute</code> command.</p>
-<p>You can find those guides here:</p>
-<ul>
-<li><a href="../generate-kuadrant-auth-policy/">Generate Kuadrant AuthPolicy</a></li>
-<li><a href="../generate-kuadrant-rate-limit-policy/">Generate Kuadrant RateLimitPolicy</a></li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/generate-kuadrant-auth-policy/index.html b/0.10.0/kuadrantctl/doc/generate-kuadrant-auth-policy/index.html
deleted file mode 100644
index 34c0052e2..000000000
--- a/0.10.0/kuadrantctl/doc/generate-kuadrant-auth-policy/index.html
+++ /dev/null
@@ -1,3997 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/generate-kuadrant-auth-policy/">
-      
-      
-        <link rel="prev" href="../generate-gateway-api-httproute/">
-      
-      
-        <link rel="next" href="../generate-kuadrant-rate-limit-policy/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Generating Kuadrant AuthPolicies - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#generate-kuadrant-authpolicy-object-from-openapi-3" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Generating Kuadrant AuthPolicies
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#generate-kuadrant-authpolicy-object-from-openapi-3" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate Kuadrant AuthPolicy object from OpenAPI 3
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Generate Kuadrant AuthPolicy object from OpenAPI 3">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openapi-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenAPI specification
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#openidconnect-type-description" class="md-nav__link">
-    <span class="md-ellipsis">
-      openIdConnect Type Description
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#apikey-type-description" class="md-nav__link">
-    <span class="md-ellipsis">
-      apiKey Type Description
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#usage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Usage
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#user-guide" class="md-nav__link">
-    <span class="md-ellipsis">
-      User Guide
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#generate-kuadrant-authpolicy-object-from-openapi-3" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate Kuadrant AuthPolicy object from OpenAPI 3
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Generate Kuadrant AuthPolicy object from OpenAPI 3">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openapi-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenAPI specification
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#openidconnect-type-description" class="md-nav__link">
-    <span class="md-ellipsis">
-      openIdConnect Type Description
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#apikey-type-description" class="md-nav__link">
-    <span class="md-ellipsis">
-      apiKey Type Description
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#usage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Usage
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#user-guide" class="md-nav__link">
-    <span class="md-ellipsis">
-      User Guide
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/generate-kuadrant-auth-policy.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Generating Kuadrant AuthPolicies</h1>
-
-<h2 id="generate-kuadrant-authpolicy-object-from-openapi-3">Generate Kuadrant AuthPolicy object from OpenAPI 3<a class="headerlink" href="#generate-kuadrant-authpolicy-object-from-openapi-3" title="Permanent link">&para;</a></h2>
-<p>The <code>kuadrantctl generate kuadrant authpolicy</code> command generates an <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/auth/">Kuadrant AuthPolicy</a>
-from your <a href="https://spec.openapis.org/oas/latest.html">OpenAPI Specification (OAS) 3.x</a> powered with <a href="../openapi-kuadrant-extensions/">kuadrant extensions</a>.</p>
-<h3 id="openapi-specification">OpenAPI specification<a class="headerlink" href="#openapi-specification" title="Permanent link">&para;</a></h3>
-<p>An OpenAPI document resource can be provided to the cli by one of the following channels:</p>
-<ul>
-<li>Filename in the available path.</li>
-<li>URL format (supported schemes are HTTP and HTTPS). The CLI will try to download from the given address.</li>
-<li>Read from stdin standard input stream.</li>
-</ul>
-<p>OpenAPI <a href="https://spec.openapis.org/oas/latest.html#security-scheme-object">Security Scheme Object</a> types</p>
-<table>
-<thead>
-<tr>
-<th>Types</th>
-<th>Implemented</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>openIdConnect</code></td>
-<td><strong>YES</strong></td>
-</tr>
-<tr>
-<td><code>apiKey</code></td>
-<td><strong>YES</strong></td>
-</tr>
-<tr>
-<td><code>http</code></td>
-<td>NO</td>
-</tr>
-<tr>
-<td><code>oauth2</code></td>
-<td>NO</td>
-</tr>
-</tbody>
-</table>
-<h3 id="openidconnect-type-description"><code>openIdConnect</code> Type Description<a class="headerlink" href="#openidconnect-type-description" title="Permanent link">&para;</a></h3>
-<p>The following OAS example has one protected endpoint <code>GET /dog</code> with <code>openIdConnect</code> security scheme type.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">paths</span><span class="p">:</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">  </span><span class="nt">/dog</span><span class="p">:</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;getDog&quot;</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">      </span><span class="nt">security</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">securedDog</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="nt">components</span><span class="p">:</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">  </span><span class="nt">securitySchemes</span><span class="p">:</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">    </span><span class="nt">securedDog</span><span class="p">:</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">      </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">openIdConnect</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">      </span><span class="nt">openIdConnectUrl</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://example.com/.well-known/openid-configuration</span>
-</span></code></pre></div>
-<p>Running the command</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kuadrantctl generate kuadrant authpolicy --oas ./petstore-openapi.yaml  | yq -P
-</span></code></pre></div>
-<p>The generated authpolicy (only relevan fields shown here):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="nt">creationTimestamp</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">  </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/api/v1/dog</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="w">    </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a><span class="w">      </span><span class="nt">getDog_securedDog</span><span class="p">:</span>
-</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a><span class="w">        </span><span class="nt">credentials</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a><span class="w">        </span><span class="nt">jwt</span><span class="p">:</span>
-</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a><span class="w">          </span><span class="nt">issuerUrl</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://example.com/.well-known/openid-configuration</span>
-</span><span id="__span-2-21"><a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a><span class="w">        </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-2-22"><a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-2-23"><a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-2-24"><a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a><span class="w">                  </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-2-25"><a id="__codelineno-2-25" name="__codelineno-2-25" href="#__codelineno-2-25"></a><span class="w">                  </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/api/v1/dog</span>
-</span><span id="__span-2-26"><a id="__codelineno-2-26" name="__codelineno-2-26" href="#__codelineno-2-26"></a><span class="w">                </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span></code></pre></div>
-<h3 id="apikey-type-description"><code>apiKey</code> Type Description<a class="headerlink" href="#apikey-type-description" title="Permanent link">&para;</a></h3>
-<p>The following OAS example has one protected endpoint <code>GET /dog</code> with <code>apiKey</code> security scheme type.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">paths</span><span class="p">:</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w">  </span><span class="nt">/dog</span><span class="p">:</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;getDog&quot;</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">      </span><span class="nt">security</span><span class="p">:</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">securedDog</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="nt">components</span><span class="p">:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="w">  </span><span class="nt">securitySchemes</span><span class="p">:</span>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="w">    </span><span class="nt">securedDog</span><span class="p">:</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="w">      </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiKey</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dog_token</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="w">      </span><span class="nt">in</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">query</span>
-</span></code></pre></div>
-<p>Running the command</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kuadrantctl generate kuadrant authpolicy --oas ./petstore-openapi.yaml  | yq -P
-</span></code></pre></div>
-<p>The generated authpolicy (only relevan fields shown here):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w">  </span><span class="nt">creationTimestamp</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="w">  </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/dog</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="w">    </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="w">      </span><span class="nt">getDog_securedDog</span><span class="p">:</span>
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a><span class="w">        </span><span class="nt">credentials</span><span class="p">:</span>
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a><span class="w">          </span><span class="nt">queryString</span><span class="p">:</span>
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a><span class="w">            </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dog_token</span>
-</span><span id="__span-5-21"><a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a><span class="w">          </span><span class="nt">apiKey</span><span class="p">:</span>
-</span><span id="__span-5-22"><a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a><span class="w">            </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-5-23"><a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></a><span class="w">              </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-5-24"><a id="__codelineno-5-24" name="__codelineno-5-24" href="#__codelineno-5-24"></a><span class="w">                </span><span class="nt">kuadrant.io/apikeys-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">securedDog</span>
-</span><span id="__span-5-25"><a id="__codelineno-5-25" name="__codelineno-5-25" href="#__codelineno-5-25"></a><span class="w">        </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-5-26"><a id="__codelineno-5-26" name="__codelineno-5-26" href="#__codelineno-5-26"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-5-27"><a id="__codelineno-5-27" name="__codelineno-5-27" href="#__codelineno-5-27"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-5-28"><a id="__codelineno-5-28" name="__codelineno-5-28" href="#__codelineno-5-28"></a><span class="w">                  </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-5-29"><a id="__codelineno-5-29" name="__codelineno-5-29" href="#__codelineno-5-29"></a><span class="w">                  </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/dog</span>
-</span><span id="__span-5-30"><a id="__codelineno-5-30" name="__codelineno-5-30" href="#__codelineno-5-30"></a><span class="w">                </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span></code></pre></div>
-<p>In this particular example, the endpoint <code>GET /dog</code> will be protected.
-The token needs to be in the query string of the request included in a parameter named <code>dog_token</code>.
-Kuadrant will validate received tokens against tokens found in kubernetes secrets with label <code>kuadrant.io/apikeys-by: ${sec scheme name}</code>.
-In this particular example the label selector will be: <code>kuadrant.io/apikeys-by: securedDog</code>.</p>
-<p>Like the following example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api-key-1</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="w">  </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w">    </span><span class="nt">authorino.kuadrant.io/managed-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w">    </span><span class="nt">kuadrant.io/apikeys-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">securedDog</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="nt">stringData</span><span class="p">:</span>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">  </span><span class="nt">api_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">MYSECRETTOKENVALUE</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note</strong>: Kuadrant validates tokens against api keys found in secrets. The label selector format <code>kuadrant.io/apikeys-by: ${sec scheme name}</code> is arbitrary and designed for this CLI command.</p>
-</blockquote>
-<p>For more information about Kuadrant auth based on api key: https://docs.kuadrant.io/latest/authorino/docs/user-guides/api-key-authentication/</p>
-<h3 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">&para;</a></h3>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>Generate<span class="w"> </span>Kuadrant<span class="w"> </span>AuthPolicy<span class="w"> </span>from<span class="w"> </span>OpenAPI<span class="w"> </span><span class="m">3</span>.0.X
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>Usage:
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w">  </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span><span class="o">[</span>flags<span class="o">]</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>Flags:
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w">  </span>-h,<span class="w"> </span>--help<span class="w">         </span><span class="nb">help</span><span class="w"> </span><span class="k">for</span><span class="w"> </span>authpolicy
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w">  </span>--oas<span class="w"> </span>string<span class="w">        </span>Path<span class="w"> </span>to<span class="w"> </span>OpenAPI<span class="w"> </span>spec<span class="w"> </span>file<span class="w"> </span><span class="o">(</span><span class="k">in</span><span class="w"> </span>JSON<span class="w"> </span>or<span class="w"> </span>YAML<span class="w"> </span>format<span class="o">)</span>,<span class="w"> </span>URL,<span class="w"> </span>or<span class="w"> </span><span class="s1">&#39;-&#39;</span><span class="w"> </span>to<span class="w"> </span><span class="nb">read</span><span class="w"> </span>from<span class="w"> </span>standard<span class="w"> </span>input<span class="w"> </span><span class="o">(</span>required<span class="o">)</span>
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w">  </span>-o<span class="w"> </span>Output<span class="w"> </span>format:<span class="w">   </span><span class="s1">&#39;yaml&#39;</span><span class="w"> </span>or<span class="w"> </span><span class="s1">&#39;json&#39;</span>.<span class="w"> </span><span class="o">(</span>default<span class="w"> </span><span class="s2">&quot;yaml&quot;</span><span class="o">)</span>
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a>Global<span class="w"> </span>Flags:
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="w">  </span>-v,<span class="w"> </span>--verbose<span class="w">   </span>verbose<span class="w"> </span>output
-</span></code></pre></div>
-<blockquote>
-<p>Under the example folder there are examples of OAS 3 that can be used to generate the resources</p>
-</blockquote>
-<h3 id="user-guide">User Guide<a class="headerlink" href="#user-guide" title="Permanent link">&para;</a></h3>
-<p>The verification steps will lead you to the process of deploying and testing the following api with
-endpoints protected using different security schemes:</p>
-<table>
-<thead>
-<tr>
-<th>Operation</th>
-<th>Security Scheme</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>GET /api/v1/cat</code></td>
-<td>public (not auth)</td>
-</tr>
-<tr>
-<td><code>POST /api/v1/cat</code></td>
-<td>ApiKey in header</td>
-</tr>
-<tr>
-<td><code>GET /api/v1/dog</code></td>
-<td>OpenIdConnect</td>
-</tr>
-<tr>
-<td><code>GET /api/v1/snake</code></td>
-<td>OpenIdConnect <strong>OR</strong> ApiKey in query string</td>
-</tr>
-</tbody>
-</table>
-<ul>
-<li>[Optional] Setup SSO service supporting OIDC. For this example, we will be using <a href="https://www.keycloak.org">keycloak</a>.</li>
-<li>Create a new realm <code>petstore</code></li>
-<li>Create a client <code>petstore</code>. In the Client Protocol field, select <code>openid-connect</code>.</li>
-<li>Configure client settings. Access Type to public. Direct Access Grants Enabled to ON (for this example password will be used directly to generate the token).</li>
-<li>Add a user to the realm<ul>
-<li>Click the Users menu on the left side of the window.  Click Add user.</li>
-<li>Type the username <code>bob</code>, set the Email Verified switch to ON, and click Save.</li>
-<li>On the Credentials tab, set the password <code>p</code>. Enter the password in both the fields, set the Temporary switch to OFF to avoid the password reset at the next login, and click <code>Set Password</code>.</li>
-</ul>
-</li>
-</ul>
-<p>Now, let's run local cluster to test the kuadrantctl new command to generate authpolicy.</p>
-<ul>
-<li>Clone the repo</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/kuadrantctl.git
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nb">cd</span><span class="w"> </span>kuadrantctl
-</span></code></pre></div>
-<ul>
-<li>Setup a cluster, Istio and Gateway API CRDs and Kuadrant</li>
-</ul>
-<p>Use our single-cluster quick start script - this will install Kuadrant in a local <code>kind</code> cluster: https://docs.kuadrant.io/latest/getting-started-single-cluster/</p>
-<ul>
-<li>Build and install CLI in <code>bin/kuadrantctl</code> path</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>make<span class="w"> </span>install
-</span></code></pre></div>
-<ul>
-<li>Deploy petstore backend API</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>petstore
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>examples/petstore/petstore.yaml
-</span></code></pre></div>
-<ul>
-<li>Let's create Petstore's OpenAPI spec</li>
-</ul>
-<details>
-
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="l l-Scalar l-Scalar-Plain">cat &lt;&lt;EOF &gt;petstore-openapi.yaml</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="nn">---</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="nt">openapi</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;3.1.0&quot;</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="nt">info</span><span class="p">:</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="w">  </span><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;Pet</span><span class="nv"> </span><span class="s">Store</span><span class="nv"> </span><span class="s">API&quot;</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="w">  </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1.0.0&quot;</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="w">  </span><span class="nt">route</span><span class="p">:</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;petstore&quot;</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;petstore&quot;</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="w">    </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.com</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="w">    </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="nt">servers</span><span class="p">:</span>
-</span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://example.io/api/v1</span>
-</span><span id="__span-11-19"><a id="__codelineno-11-19" name="__codelineno-11-19" href="#__codelineno-11-19"></a><span class="nt">paths</span><span class="p">:</span>
-</span><span id="__span-11-20"><a id="__codelineno-11-20" name="__codelineno-11-20" href="#__codelineno-11-20"></a><span class="w">  </span><span class="nt">/cat</span><span class="p">:</span>
-</span><span id="__span-11-21"><a id="__codelineno-11-21" name="__codelineno-11-21" href="#__codelineno-11-21"></a><span class="w">    </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-11-22"><a id="__codelineno-11-22" name="__codelineno-11-22" href="#__codelineno-11-22"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-23"><a id="__codelineno-11-23" name="__codelineno-11-23" href="#__codelineno-11-23"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-24"><a id="__codelineno-11-24" name="__codelineno-11-24" href="#__codelineno-11-24"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-11-25"><a id="__codelineno-11-25" name="__codelineno-11-25" href="#__codelineno-11-25"></a><span class="w">          </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-26"><a id="__codelineno-11-26" name="__codelineno-11-26" href="#__codelineno-11-26"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span><span class="w">  </span><span class="c1"># No sec requirements</span>
-</span><span id="__span-11-27"><a id="__codelineno-11-27" name="__codelineno-11-27" href="#__codelineno-11-27"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;getCat&quot;</span>
-</span><span id="__span-11-28"><a id="__codelineno-11-28" name="__codelineno-11-28" href="#__codelineno-11-28"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-11-29"><a id="__codelineno-11-29" name="__codelineno-11-29" href="#__codelineno-11-29"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-11-30"><a id="__codelineno-11-30" name="__codelineno-11-30" href="#__codelineno-11-30"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-11-31"><a id="__codelineno-11-31" name="__codelineno-11-31" href="#__codelineno-11-31"></a><span class="w">    </span><span class="nt">post</span><span class="p">:</span><span class="w">  </span><span class="c1"># API key</span>
-</span><span id="__span-11-32"><a id="__codelineno-11-32" name="__codelineno-11-32" href="#__codelineno-11-32"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;postCat&quot;</span>
-</span><span id="__span-11-33"><a id="__codelineno-11-33" name="__codelineno-11-33" href="#__codelineno-11-33"></a><span class="w">      </span><span class="nt">security</span><span class="p">:</span>
-</span><span id="__span-11-34"><a id="__codelineno-11-34" name="__codelineno-11-34" href="#__codelineno-11-34"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">cat_api_key</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-11-35"><a id="__codelineno-11-35" name="__codelineno-11-35" href="#__codelineno-11-35"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-11-36"><a id="__codelineno-11-36" name="__codelineno-11-36" href="#__codelineno-11-36"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-11-37"><a id="__codelineno-11-37" name="__codelineno-11-37" href="#__codelineno-11-37"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-11-38"><a id="__codelineno-11-38" name="__codelineno-11-38" href="#__codelineno-11-38"></a><span class="w">  </span><span class="nt">/dog</span><span class="p">:</span>
-</span><span id="__span-11-39"><a id="__codelineno-11-39" name="__codelineno-11-39" href="#__codelineno-11-39"></a><span class="w">    </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-11-40"><a id="__codelineno-11-40" name="__codelineno-11-40" href="#__codelineno-11-40"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-41"><a id="__codelineno-11-41" name="__codelineno-11-41" href="#__codelineno-11-41"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-42"><a id="__codelineno-11-42" name="__codelineno-11-42" href="#__codelineno-11-42"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-11-43"><a id="__codelineno-11-43" name="__codelineno-11-43" href="#__codelineno-11-43"></a><span class="w">          </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-44"><a id="__codelineno-11-44" name="__codelineno-11-44" href="#__codelineno-11-44"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span><span class="w">  </span><span class="c1"># OIDC</span>
-</span><span id="__span-11-45"><a id="__codelineno-11-45" name="__codelineno-11-45" href="#__codelineno-11-45"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;getDog&quot;</span>
-</span><span id="__span-11-46"><a id="__codelineno-11-46" name="__codelineno-11-46" href="#__codelineno-11-46"></a><span class="w">      </span><span class="nt">security</span><span class="p">:</span>
-</span><span id="__span-11-47"><a id="__codelineno-11-47" name="__codelineno-11-47" href="#__codelineno-11-47"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">oidc</span><span class="p">:</span>
-</span><span id="__span-11-48"><a id="__codelineno-11-48" name="__codelineno-11-48" href="#__codelineno-11-48"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">read:dogs</span>
-</span><span id="__span-11-49"><a id="__codelineno-11-49" name="__codelineno-11-49" href="#__codelineno-11-49"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-11-50"><a id="__codelineno-11-50" name="__codelineno-11-50" href="#__codelineno-11-50"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-11-51"><a id="__codelineno-11-51" name="__codelineno-11-51" href="#__codelineno-11-51"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-11-52"><a id="__codelineno-11-52" name="__codelineno-11-52" href="#__codelineno-11-52"></a><span class="w">  </span><span class="nt">/snake</span><span class="p">:</span>
-</span><span id="__span-11-53"><a id="__codelineno-11-53" name="__codelineno-11-53" href="#__codelineno-11-53"></a><span class="w">    </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-11-54"><a id="__codelineno-11-54" name="__codelineno-11-54" href="#__codelineno-11-54"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-55"><a id="__codelineno-11-55" name="__codelineno-11-55" href="#__codelineno-11-55"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-56"><a id="__codelineno-11-56" name="__codelineno-11-56" href="#__codelineno-11-56"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-11-57"><a id="__codelineno-11-57" name="__codelineno-11-57" href="#__codelineno-11-57"></a><span class="w">          </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-58"><a id="__codelineno-11-58" name="__codelineno-11-58" href="#__codelineno-11-58"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span><span class="w">  </span><span class="c1"># OIDC or API key</span>
-</span><span id="__span-11-59"><a id="__codelineno-11-59" name="__codelineno-11-59" href="#__codelineno-11-59"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;getSnake&quot;</span>
-</span><span id="__span-11-60"><a id="__codelineno-11-60" name="__codelineno-11-60" href="#__codelineno-11-60"></a><span class="w">      </span><span class="nt">security</span><span class="p">:</span>
-</span><span id="__span-11-61"><a id="__codelineno-11-61" name="__codelineno-11-61" href="#__codelineno-11-61"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">oidc</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;read:snakes&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-11-62"><a id="__codelineno-11-62" name="__codelineno-11-62" href="#__codelineno-11-62"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">snakes_api_key</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-11-63"><a id="__codelineno-11-63" name="__codelineno-11-63" href="#__codelineno-11-63"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-11-64"><a id="__codelineno-11-64" name="__codelineno-11-64" href="#__codelineno-11-64"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-11-65"><a id="__codelineno-11-65" name="__codelineno-11-65" href="#__codelineno-11-65"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-11-66"><a id="__codelineno-11-66" name="__codelineno-11-66" href="#__codelineno-11-66"></a><span class="nt">components</span><span class="p">:</span>
-</span><span id="__span-11-67"><a id="__codelineno-11-67" name="__codelineno-11-67" href="#__codelineno-11-67"></a><span class="w">  </span><span class="nt">securitySchemes</span><span class="p">:</span>
-</span><span id="__span-11-68"><a id="__codelineno-11-68" name="__codelineno-11-68" href="#__codelineno-11-68"></a><span class="w">    </span><span class="nt">cat_api_key</span><span class="p">:</span>
-</span><span id="__span-11-69"><a id="__codelineno-11-69" name="__codelineno-11-69" href="#__codelineno-11-69"></a><span class="w">      </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiKey</span>
-</span><span id="__span-11-70"><a id="__codelineno-11-70" name="__codelineno-11-70" href="#__codelineno-11-70"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
-</span><span id="__span-11-71"><a id="__codelineno-11-71" name="__codelineno-11-71" href="#__codelineno-11-71"></a><span class="w">      </span><span class="nt">in</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">header</span>
-</span><span id="__span-11-72"><a id="__codelineno-11-72" name="__codelineno-11-72" href="#__codelineno-11-72"></a><span class="w">    </span><span class="nt">oidc</span><span class="p">:</span>
-</span><span id="__span-11-73"><a id="__codelineno-11-73" name="__codelineno-11-73" href="#__codelineno-11-73"></a><span class="w">      </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">openIdConnect</span>
-</span><span id="__span-11-74"><a id="__codelineno-11-74" name="__codelineno-11-74" href="#__codelineno-11-74"></a><span class="w">      </span><span class="nt">openIdConnectUrl</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://${KEYCLOAK_PUBLIC_DOMAIN}/auth/realms/petstore</span>
-</span><span id="__span-11-75"><a id="__codelineno-11-75" name="__codelineno-11-75" href="#__codelineno-11-75"></a><span class="w">    </span><span class="nt">snakes_api_key</span><span class="p">:</span>
-</span><span id="__span-11-76"><a id="__codelineno-11-76" name="__codelineno-11-76" href="#__codelineno-11-76"></a><span class="w">      </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiKey</span>
-</span><span id="__span-11-77"><a id="__codelineno-11-77" name="__codelineno-11-77" href="#__codelineno-11-77"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">snake_token</span>
-</span><span id="__span-11-78"><a id="__codelineno-11-78" name="__codelineno-11-78" href="#__codelineno-11-78"></a><span class="w">      </span><span class="nt">in</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">query</span>
-</span><span id="__span-11-79"><a id="__codelineno-11-79" name="__codelineno-11-79" href="#__codelineno-11-79"></a><span class="l l-Scalar l-Scalar-Plain">EOF</span>
-</span></code></pre></div>
-
-</details>
-
-<blockquote>
-<p>Replace <code>${KEYCLOAK_PUBLIC_DOMAIN}</code> with your SSO instance domain</p>
-</blockquote>
-<ul>
-<li>
-<p>Create an API key only valid for <code>POST /api/v1/cat</code> endpoint
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="l l-Scalar l-Scalar-Plain">kubectl apply -f -&lt;&lt;EOF</span>
-</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="l l-Scalar l-Scalar-Plain">apiVersion</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cat-api-key-1</span>
-</span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="w">  </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="w">    </span><span class="nt">authorino.kuadrant.io/managed-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="w">    </span><span class="nt">kuadrant.io/apikeys-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cat_api_key</span>
-</span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="nt">stringData</span><span class="p">:</span>
-</span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="w">  </span><span class="nt">api_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">I_LIKE_CATS</span>
-</span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span>
-</span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="l l-Scalar l-Scalar-Plain">EOF</span>
-</span></code></pre></div></p>
-<blockquote>
-<p><strong>Note</strong>: the label's value of <code>kuadrant.io/apikeys-by: cat_api_key</code> is the name of the sec scheme of the OpenAPI spec.</p>
-</blockquote>
-</li>
-<li>
-<p>Create an API key only valid for <code>GET /api/v1/snake</code> endpoint</p>
-</li>
-</ul>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="l l-Scalar l-Scalar-Plain">kubectl apply -f -&lt;&lt;EOF</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="l l-Scalar l-Scalar-Plain">apiVersion</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">snake-api-key-1</span>
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="w">  </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="w">    </span><span class="nt">authorino.kuadrant.io/managed-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="w">    </span><span class="nt">kuadrant.io/apikeys-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">snakes_api_key</span>
-</span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="nt">stringData</span><span class="p">:</span>
-</span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="w">  </span><span class="nt">api_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">I_LIKE_SNAKES</span>
-</span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span>
-</span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="l l-Scalar l-Scalar-Plain">EOF</span>
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note</strong>: the label's value of <code>kuadrant.io/apikeys-by: snakes_api_key</code> is the name of the sec scheme of the OpenAPI spec.</p>
-</blockquote>
-<ul>
-<li>Create the HTTPRoute using the CLI</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>bin/kuadrantctl<span class="w"> </span>generate<span class="w"> </span>gatewayapi<span class="w"> </span>httproute<span class="w"> </span>--oas<span class="w"> </span>petstore-openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div>
-<ul>
-<li>Create Kuadrant's Auth Policy</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>bin/kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span>--oas<span class="w"> </span>petstore-openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div>
-<p>Now, we are ready to test OpenAPI endpoints <img alt="❗" class="twemoji" src="https://cdn.jsdelivr.net/gh/jdecked/twemoji@15.0.3/assets/svg/2757.svg" title=":exclamation:" /></p>
-<ul>
-<li><code>GET /api/v1/cat</code> -&gt; It's a public endpoint, hence should return 200 Ok</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>curl<span class="w">  </span>-H<span class="w"> </span><span class="s2">&quot;Host: example.com&quot;</span><span class="w"> </span>-i<span class="w"> </span><span class="s2">&quot;http://127.0.0.1:9080/api/v1/cat&quot;</span>
-</span></code></pre></div>
-<ul>
-<li><code>POST /api/v1/cat</code> -&gt; It's a protected endpoint with apikey</li>
-</ul>
-<p>Without any credentials, it should return <code>401 Unauthorized</code></p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>curl<span class="w">  </span>-H<span class="w"> </span><span class="s2">&quot;Host: example.com&quot;</span><span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>-i<span class="w"> </span><span class="s2">&quot;http://127.0.0.1:9080/api/v1/cat&quot;</span>
-</span></code></pre></div>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>HTTP/1.1 401 Unauthorized
-</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a>www-authenticate: Bearer realm=&quot;getDog_oidc&quot;
-</span><span id="__span-18-3"><a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a>www-authenticate: Bearer realm=&quot;getSnake_oidc&quot;
-</span><span id="__span-18-4"><a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a>www-authenticate: snake_token realm=&quot;getSnake_snakes_api_key&quot;
-</span><span id="__span-18-5"><a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a>www-authenticate: api_key realm=&quot;postCat_cat_api_key&quot;
-</span><span id="__span-18-6"><a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a>x-ext-auth-reason: {&quot;postCat_cat_api_key&quot;:&quot;credential not found&quot;}
-</span><span id="__span-18-7"><a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a>date: Tue, 28 Nov 2023 22:28:44 GMT
-</span><span id="__span-18-8"><a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a>server: istio-envoy
-</span><span id="__span-18-9"><a id="__codelineno-18-9" name="__codelineno-18-9" href="#__codelineno-18-9"></a>content-length: 0
-</span></code></pre></div>
-<p>The <em>reason</em> headers tell that <code>credential not found</code>.
-Credentials satisfying <code>postCat_cat_api_key</code> authentication is needed.</p>
-<p>According to the OpenAPI spec, it should be a header named <code>api_key</code>.
-What if we try a wrong token? one token assigned to other endpoint,
-i.e. <code>I_LIKE_SNAKES</code> instead of the valid one <code>I_LIKE_CATS</code>. It should return <code>401 Unauthorized</code>.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>curl<span class="w">  </span>-H<span class="w"> </span><span class="s2">&quot;Host: example.com&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;api_key: I_LIKE_SNAKES&quot;</span><span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>-i<span class="w"> </span><span class="s2">&quot;http://127.0.0.1:9080/api/v1/cat&quot;</span>
-</span></code></pre></div>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>HTTP/1.1 401 Unauthorized
-</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a>www-authenticate: Bearer realm=&quot;getDog_oidc&quot;
-</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a>www-authenticate: Bearer realm=&quot;getSnake_oidc&quot;
-</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a>www-authenticate: snake_token realm=&quot;getSnake_snakes_api_key&quot;
-</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a>www-authenticate: api_key realm=&quot;postCat_cat_api_key&quot;
-</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a>x-ext-auth-reason: {&quot;postCat_cat_api_key&quot;:&quot;the API Key provided is invalid&quot;}
-</span><span id="__span-20-7"><a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a>date: Tue, 28 Nov 2023 22:32:55 GMT
-</span><span id="__span-20-8"><a id="__codelineno-20-8" name="__codelineno-20-8" href="#__codelineno-20-8"></a>server: istio-envoy
-</span><span id="__span-20-9"><a id="__codelineno-20-9" name="__codelineno-20-9" href="#__codelineno-20-9"></a>content-length: 0
-</span></code></pre></div>
-<p>The <em>reason</em> headers tell that <code>the API Key provided is invalid</code>.
-Using valid token (from the secret <code>cat-api-key-1</code> assigned to <code>POST /api/v1/cats</code>)
-in the <code>api_key</code> header should return 200 Ok</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>curl  -H &quot;Host: example.com&quot; -H &quot;api_key: I_LIKE_CATS&quot; -X POST -i &quot;http://127.0.0.1:9080/api/v1/cat&quot;
-</span></code></pre></div>
-<ul>
-<li><code>GET /api/v1/dog</code> -&gt; It's a protected endpoint with oidc (assigned to our keycloak instance and <code>petstore</code> realm)</li>
-</ul>
-<p>without credentials, it should return <code>401 Unauthorized</code></p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Host: example.com&quot;</span><span class="w"> </span>-i<span class="w"> </span><span class="s2">&quot;http://127.0.0.1:9080/api/v1/dog&quot;</span>
-</span></code></pre></div>
-<p>To get the authentication token, this example is using Direct Access Grants oauth2 grant type
-(also known as Client Credentials grant type). When configuring the Keycloak (OIDC provider) client
-settings, we enabled Direct Access Grants to enable this procedure.
-We will be authenticating as <code>bob</code> user with <code>p</code> password.
-We previously created <code>bob</code> user in Keycloak in the <code>petstore</code> realm.</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>export ACCESS_TOKEN=$(curl -k -H &quot;Content-Type: application/x-www-form-urlencoded&quot; \
-</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>        -d &#39;grant_type=password&#39; \
-</span><span id="__span-23-3"><a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a>        -d &#39;client_id=petstore&#39; \
-</span><span id="__span-23-4"><a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a>        -d &#39;scope=openid&#39; \
-</span><span id="__span-23-5"><a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a>        -d &#39;username=bob&#39; \
-</span><span id="__span-23-6"><a id="__codelineno-23-6" name="__codelineno-23-6" href="#__codelineno-23-6"></a>        -d &#39;password=p&#39; &quot;https://${KEYCLOAK_PUBLIC_DOMAIN}/auth/realms/petstore/protocol/openid-connect/token&quot; | jq -r &#39;.access_token&#39;)
-</span></code></pre></div>
-<blockquote>
-<p>Replace <code>${KEYCLOAK_PUBLIC_DOMAIN}</code> with your SSO instance domain</p>
-</blockquote>
-<p>With the access token in place, let's try to get those puppies</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: example.com&#39;</span><span class="w"> </span>http://127.0.0.1:9080/api/v1/dog<span class="w"> </span>-i
-</span></code></pre></div>
-<p>it should return 200 OK</p>
-<ul>
-<li><code>GET /api/v1/snake</code> -&gt; It's a protected endpoint with oidc (assigned to our keycloak instance and <code>petstore</code> realm) <strong>OR</strong> with apiKey</li>
-</ul>
-<p>This example is to show that multiple security requirements (with <em>OR</em> semantics) can be specified
-for an OpenAPI operation.</p>
-<p>Without credentials, it should return <code>401 Unauthorized</code></p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-25-1"><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Host: example.com&quot;</span><span class="w"> </span>-i<span class="w"> </span><span class="s2">&quot;http://127.0.0.1:9080/api/v1/snake&quot;</span>
-</span></code></pre></div>
-<p>With the access token in place, it should return 200 OK (unless the token has expired).</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-26-1"><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$ACCESS_TOKEN</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: example.com&#39;</span><span class="w"> </span>http://127.0.0.1:9080/api/v1/snake<span class="w"> </span>-i
-</span></code></pre></div>
-<p>With apiKey it should also work. According to the OpenAPI spec security scheme,
-it should be a query string named <code>snake_token</code> and the token needs to be valid token
-(from the secret <code>snake-api-key-1</code> assigned to <code>GET /api/v1/snake</code>)</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-27-1"><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s1">&#39;Host: example.com&#39;</span><span class="w"> </span>-i<span class="w"> </span><span class="s2">&quot;http://127.0.0.1:9080/api/v1/snake?snake_token=I_LIKE_SNAKES&quot;</span>
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/generate-kuadrant-rate-limit-policy/index.html b/0.10.0/kuadrantctl/doc/generate-kuadrant-rate-limit-policy/index.html
deleted file mode 100644
index 46baf5d0d..000000000
--- a/0.10.0/kuadrantctl/doc/generate-kuadrant-rate-limit-policy/index.html
+++ /dev/null
@@ -1,3686 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/generate-kuadrant-rate-limit-policy/">
-      
-      
-        <link rel="prev" href="../generate-kuadrant-auth-policy/">
-      
-      
-        <link rel="next" href="../kuadrantctl-ci-cd/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Generating Kuadrant RateLimitPolicies - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#generate-kuadrant-ratelimitpolicy-object-from-openapi-3" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Generating Kuadrant RateLimitPolicies
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#generate-kuadrant-ratelimitpolicy-object-from-openapi-3" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate Kuadrant RateLimitPolicy object from OpenAPI 3
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Generate Kuadrant RateLimitPolicy object from OpenAPI 3">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openapi-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenAPI specification
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#usage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Usage
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#generate-kuadrant-ratelimitpolicy-object-from-openapi-3" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate Kuadrant RateLimitPolicy object from OpenAPI 3
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Generate Kuadrant RateLimitPolicy object from OpenAPI 3">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openapi-specification" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenAPI specification
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#usage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Usage
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/generate-kuadrant-rate-limit-policy.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Generating Kuadrant RateLimitPolicies</h1>
-
-<h2 id="generate-kuadrant-ratelimitpolicy-object-from-openapi-3">Generate Kuadrant RateLimitPolicy object from OpenAPI 3<a class="headerlink" href="#generate-kuadrant-ratelimitpolicy-object-from-openapi-3" title="Permanent link">&para;</a></h2>
-<p>The <code>kuadrantctl generate kuadrant ratelimitpolicy</code> command generates a <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/rate-limiting/">Kuadrant RateLimitPolicy</a>
-from your <a href="https://spec.openapis.org/oas/latest.html">OpenAPI Specification (OAS) 3.x document</a> powered with <a href="../openapi-kuadrant-extensions/">Kuadrant extensions</a>.</p>
-<h3 id="openapi-specification">OpenAPI specification<a class="headerlink" href="#openapi-specification" title="Permanent link">&para;</a></h3>
-<p>An OpenAPI document resource can be provided to the Kuadrant CLI in one of the following ways:</p>
-<ul>
-<li>Filename in the available path.</li>
-<li>URL format (supported schemes are HTTP and HTTPS). The CLI will try to download from the given address.</li>
-<li>Read from <code>stdin</code> standard input stream.</li>
-</ul>
-<h3 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">&para;</a></h3>
-<div class="language-shell highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>Generate<span class="w"> </span>Kuadrant<span class="w"> </span>RateLimitPolicy<span class="w"> </span>from<span class="w"> </span>OpenAPI<span class="w"> </span><span class="m">3</span>.0.x
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>Usage:
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>ratelimitpolicy<span class="w"> </span><span class="o">[</span>flags<span class="o">]</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>Flags:
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span>-h,<span class="w"> </span>--help<span class="w">         </span><span class="nb">help</span><span class="w"> </span><span class="k">for</span><span class="w"> </span>ratelimitpolicy
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">  </span>--oas<span class="w"> </span>string<span class="w">        </span>Path<span class="w"> </span>to<span class="w"> </span>OpenAPI<span class="w"> </span>spec<span class="w"> </span>file<span class="w"> </span><span class="o">(</span><span class="k">in</span><span class="w"> </span>JSON<span class="w"> </span>or<span class="w"> </span>YAML<span class="w"> </span>format<span class="o">)</span>,<span class="w"> </span>URL,<span class="w"> </span>or<span class="w"> </span><span class="s1">&#39;-&#39;</span><span class="w"> </span>to<span class="w"> </span><span class="nb">read</span><span class="w"> </span>from<span class="w"> </span>standard<span class="w"> </span>input<span class="w"> </span><span class="o">(</span>required<span class="o">)</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">  </span>-o<span class="w"> </span>Output<span class="w"> </span>format:<span class="w">   </span><span class="s1">&#39;yaml&#39;</span><span class="w"> </span>or<span class="w"> </span><span class="s1">&#39;json&#39;</span>.<span class="w"> </span><span class="o">(</span>default<span class="w"> </span><span class="s2">&quot;yaml&quot;</span><span class="o">)</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>Global<span class="w"> </span>Flags:
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">  </span>-v,<span class="w"> </span>--verbose<span class="w">   </span>verbose<span class="w"> </span>output
-</span></code></pre></div>
-<blockquote>
-<p><strong>Note</strong>: The <code>kuadrantctl/examples</code> directory in GitHub includes sample OAS 3 files that you can use to generate the resources.</p>
-</blockquote>
-<h3 id="procedure">Procedure<a class="headerlink" href="#procedure" title="Permanent link">&para;</a></h3>
-<ol>
-<li>
-<p>Clone the Git repository as follows: 
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/kuadrantctl.git
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nb">cd</span><span class="w"> </span>kuadrantctl
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w"> </span><span class="sb">```</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="m">2</span>.<span class="w"> </span>Set<span class="w"> </span>up<span class="w"> </span>a<span class="w"> </span>cluster,<span class="w"> </span>Istio<span class="w"> </span>and<span class="w"> </span>Gateway<span class="w"> </span>API<span class="w"> </span>CRDs,<span class="w"> </span>and<span class="w"> </span>Kuadrant<span class="w"> </span>as<span class="w"> </span>follows:<span class="w"> </span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>*<span class="w"> </span>Use<span class="w"> </span>the<span class="w"> </span>single-cluster<span class="w"> </span>quick<span class="w"> </span>start<span class="w"> </span>script<span class="w"> </span>to<span class="w"> </span>install<span class="w"> </span>Kuadrant<span class="w"> </span><span class="k">in</span><span class="w"> </span>a<span class="w"> </span><span class="nb">local</span><span class="w"> </span><span class="sb">`</span>kind<span class="sb">`</span><span class="w"> </span>cluster:<span class="w"> </span>https://docs.kuadrant.io/latest/getting-started-single-cluster/.
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="m">3</span>.<span class="w"> </span>Build<span class="w"> </span>and<span class="w"> </span>install<span class="w"> </span>the<span class="w"> </span>CLI<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="sb">`</span>bin/kuadrantctl<span class="sb">`</span><span class="w"> </span>path<span class="w"> </span>as<span class="w"> </span>follows:
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="sb">```</span>bash
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a>make<span class="w"> </span>install
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Deploy the Petstore backend API as follows:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>petstore
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>examples/petstore/petstore.yaml
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Create the Petstore OpenAPI definition as follows:</p>
-</li>
-</ol>
-<details>
-
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="l l-Scalar l-Scalar-Plain">cat &lt;&lt;EOF &gt;petstore-openapi.yaml</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nn">---</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="nt">openapi</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;3.0.3&quot;</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="nt">info</span><span class="p">:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">  </span><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;Pet</span><span class="nv"> </span><span class="s">Store</span><span class="nv"> </span><span class="s">API&quot;</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">  </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1.0.0&quot;</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="nt">x-kuadrant</span><span class="p">:</span><span class="w">  </span><span class="c1">## Root-level Kuadrant extension</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">  </span><span class="nt">route</span><span class="p">:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;petstore&quot;</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;petstore&quot;</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">    </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a>
-</span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.com</span>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="w">    </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-ingressgateway</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">istio-system</span>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="nt">servers</span><span class="p">:</span>
-</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://example.io/v1</span>
-</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="nt">paths</span><span class="p">:</span>
-</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="w">  </span><span class="nt">/cat</span><span class="p">:</span>
-</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="w">    </span><span class="nt">x-kuadrant</span><span class="p">:</span><span class="w">  </span><span class="c1">## Path-level Kuadrant extension</span>
-</span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-3-23"><a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-3-24"><a id="__codelineno-3-24" name="__codelineno-3-24" href="#__codelineno-3-24"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-3-25"><a id="__codelineno-3-25" name="__codelineno-3-25" href="#__codelineno-3-25"></a><span class="w">          </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-3-26"><a id="__codelineno-3-26" name="__codelineno-3-26" href="#__codelineno-3-26"></a><span class="w">      </span><span class="nt">rate_limit</span><span class="p">:</span>
-</span><span id="__span-3-27"><a id="__codelineno-3-27" name="__codelineno-3-27" href="#__codelineno-3-27"></a><span class="w">        </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-3-28"><a id="__codelineno-3-28" name="__codelineno-3-28" href="#__codelineno-3-28"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-3-29"><a id="__codelineno-3-29" name="__codelineno-3-29" href="#__codelineno-3-29"></a><span class="w">            </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-3-30"><a id="__codelineno-3-30" name="__codelineno-3-30" href="#__codelineno-3-30"></a><span class="w">            </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-3-31"><a id="__codelineno-3-31" name="__codelineno-3-31" href="#__codelineno-3-31"></a><span class="w">        </span><span class="nt">counters</span><span class="p">:</span>
-</span><span id="__span-3-32"><a id="__codelineno-3-32" name="__codelineno-3-32" href="#__codelineno-3-32"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.headers.x-forwarded-for</span>
-</span><span id="__span-3-33"><a id="__codelineno-3-33" name="__codelineno-3-33" href="#__codelineno-3-33"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span><span class="w">  </span><span class="c1"># Added to the route and rate limited</span>
-</span><span id="__span-3-34"><a id="__codelineno-3-34" name="__codelineno-3-34" href="#__codelineno-3-34"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;getCat&quot;</span>
-</span><span id="__span-3-35"><a id="__codelineno-3-35" name="__codelineno-3-35" href="#__codelineno-3-35"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-3-36"><a id="__codelineno-3-36" name="__codelineno-3-36" href="#__codelineno-3-36"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-3-37"><a id="__codelineno-3-37" name="__codelineno-3-37" href="#__codelineno-3-37"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-3-38"><a id="__codelineno-3-38" name="__codelineno-3-38" href="#__codelineno-3-38"></a><span class="w">    </span><span class="nt">post</span><span class="p">:</span><span class="w">  </span><span class="c1"># NOT added to the route</span>
-</span><span id="__span-3-39"><a id="__codelineno-3-39" name="__codelineno-3-39" href="#__codelineno-3-39"></a><span class="w">      </span><span class="nt">x-kuadrant</span><span class="p">:</span><span class="w"> </span>
-</span><span id="__span-3-40"><a id="__codelineno-3-40" name="__codelineno-3-40" href="#__codelineno-3-40"></a><span class="w">        </span><span class="nt">disable</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
-</span><span id="__span-3-41"><a id="__codelineno-3-41" name="__codelineno-3-41" href="#__codelineno-3-41"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;postCat&quot;</span>
-</span><span id="__span-3-42"><a id="__codelineno-3-42" name="__codelineno-3-42" href="#__codelineno-3-42"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-3-43"><a id="__codelineno-3-43" name="__codelineno-3-43" href="#__codelineno-3-43"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-3-44"><a id="__codelineno-3-44" name="__codelineno-3-44" href="#__codelineno-3-44"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-3-45"><a id="__codelineno-3-45" name="__codelineno-3-45" href="#__codelineno-3-45"></a><span class="w">  </span><span class="nt">/dog</span><span class="p">:</span>
-</span><span id="__span-3-46"><a id="__codelineno-3-46" name="__codelineno-3-46" href="#__codelineno-3-46"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span><span class="w">  </span><span class="c1"># Added to the route and rate limited</span>
-</span><span id="__span-3-47"><a id="__codelineno-3-47" name="__codelineno-3-47" href="#__codelineno-3-47"></a><span class="w">      </span><span class="nt">x-kuadrant</span><span class="p">:</span><span class="w">  </span><span class="c1">## Operation-level Kuadrant extension</span>
-</span><span id="__span-3-48"><a id="__codelineno-3-48" name="__codelineno-3-48" href="#__codelineno-3-48"></a><span class="w">        </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-3-49"><a id="__codelineno-3-49" name="__codelineno-3-49" href="#__codelineno-3-49"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-3-50"><a id="__codelineno-3-50" name="__codelineno-3-50" href="#__codelineno-3-50"></a><span class="w">            </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-3-51"><a id="__codelineno-3-51" name="__codelineno-3-51" href="#__codelineno-3-51"></a><span class="w">            </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-3-52"><a id="__codelineno-3-52" name="__codelineno-3-52" href="#__codelineno-3-52"></a><span class="w">        </span><span class="nt">rate_limit</span><span class="p">:</span>
-</span><span id="__span-3-53"><a id="__codelineno-3-53" name="__codelineno-3-53" href="#__codelineno-3-53"></a><span class="w">          </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-3-54"><a id="__codelineno-3-54" name="__codelineno-3-54" href="#__codelineno-3-54"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">3</span>
-</span><span id="__span-3-55"><a id="__codelineno-3-55" name="__codelineno-3-55" href="#__codelineno-3-55"></a><span class="w">              </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-3-56"><a id="__codelineno-3-56" name="__codelineno-3-56" href="#__codelineno-3-56"></a><span class="w">              </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-3-57"><a id="__codelineno-3-57" name="__codelineno-3-57" href="#__codelineno-3-57"></a><span class="w">          </span><span class="nt">counters</span><span class="p">:</span>
-</span><span id="__span-3-58"><a id="__codelineno-3-58" name="__codelineno-3-58" href="#__codelineno-3-58"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">request.headers.x-forwarded-for</span>
-</span><span id="__span-3-59"><a id="__codelineno-3-59" name="__codelineno-3-59" href="#__codelineno-3-59"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;getDog&quot;</span>
-</span><span id="__span-3-60"><a id="__codelineno-3-60" name="__codelineno-3-60" href="#__codelineno-3-60"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-3-61"><a id="__codelineno-3-61" name="__codelineno-3-61" href="#__codelineno-3-61"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-3-62"><a id="__codelineno-3-62" name="__codelineno-3-62" href="#__codelineno-3-62"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-3-63"><a id="__codelineno-3-63" name="__codelineno-3-63" href="#__codelineno-3-63"></a><span class="w">    </span><span class="nt">post</span><span class="p">:</span><span class="w">  </span><span class="c1"># Added to the route and NOT rate limited</span>
-</span><span id="__span-3-64"><a id="__codelineno-3-64" name="__codelineno-3-64" href="#__codelineno-3-64"></a><span class="w">      </span><span class="nt">x-kuadrant</span><span class="p">:</span><span class="w">  </span><span class="c1">## Operation-level Kuadrant extension</span>
-</span><span id="__span-3-65"><a id="__codelineno-3-65" name="__codelineno-3-65" href="#__codelineno-3-65"></a><span class="w">        </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-3-66"><a id="__codelineno-3-66" name="__codelineno-3-66" href="#__codelineno-3-66"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-3-67"><a id="__codelineno-3-67" name="__codelineno-3-67" href="#__codelineno-3-67"></a><span class="w">            </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-3-68"><a id="__codelineno-3-68" name="__codelineno-3-68" href="#__codelineno-3-68"></a><span class="w">            </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-3-69"><a id="__codelineno-3-69" name="__codelineno-3-69" href="#__codelineno-3-69"></a><span class="w">      </span><span class="nt">operationId</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;postDog&quot;</span>
-</span><span id="__span-3-70"><a id="__codelineno-3-70" name="__codelineno-3-70" href="#__codelineno-3-70"></a><span class="w">      </span><span class="nt">responses</span><span class="p">:</span>
-</span><span id="__span-3-71"><a id="__codelineno-3-71" name="__codelineno-3-71" href="#__codelineno-3-71"></a><span class="w">        </span><span class="nt">405</span><span class="p">:</span>
-</span><span id="__span-3-72"><a id="__codelineno-3-72" name="__codelineno-3-72" href="#__codelineno-3-72"></a><span class="w">          </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;invalid</span><span class="nv"> </span><span class="s">input&quot;</span>
-</span><span id="__span-3-73"><a id="__codelineno-3-73" name="__codelineno-3-73" href="#__codelineno-3-73"></a><span class="l l-Scalar l-Scalar-Plain">EOF</span>
-</span></code></pre></div>
-</details>
-
-<blockquote>
-<p><strong>Note</strong>: The <code>servers</code> base path is not included. This is work-in-progress in follow-up PRs.</p>
-</blockquote>
-<table>
-<thead>
-<tr>
-<th>Operation</th>
-<th>Applied configuration</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>GET /cat</code></td>
-<td>Should return 200 OK and be rate limited (1 req / 10 seconds).</td>
-</tr>
-<tr>
-<td><code>POST /cat</code></td>
-<td>Not added to the HTTPRoute. Should return 404 Not Found.</td>
-</tr>
-<tr>
-<td><code>GET /dog</code></td>
-<td>Should return 200 OK and be rate limited (3 req / 10 seconds).</td>
-</tr>
-<tr>
-<td><code>POST /dog</code></td>
-<td>Should return 200 OK and NOT rate limited.</td>
-</tr>
-</tbody>
-</table>
-<ol>
-<li>
-<p>Create the HTTPRoute by using the CLI as follows:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>bin/kuadrantctl<span class="w"> </span>generate<span class="w"> </span>gatewayapi<span class="w"> </span>httproute<span class="w"> </span>--oas<span class="w"> </span>petstore-openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Create the rate limit policy as follows:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>bin/kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>ratelimitpolicy<span class="w"> </span>--oas<span class="w"> </span>petstore-openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Test the OpenAPI endpoints as follows:</p>
-</li>
-<li>
-<p><code>GET /cat</code> - Should return 200 OK and be rate limited (1 req / 10 seconds).
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl<span class="w"> </span>--resolve<span class="w"> </span>example.com:9080:127.0.0.1<span class="w"> </span>-v<span class="w"> </span><span class="s2">&quot;http://example.com:9080/cat&quot;</span>
-</span></code></pre></div></p>
-</li>
-<li><code>POST /cat</code> - Not added to the HTTPRoute. Should return 404 Not Found.
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>curl<span class="w"> </span>--resolve<span class="w"> </span>example.com:9080:127.0.0.1<span class="w"> </span>-v<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="s2">&quot;http://example.com:9080/cat&quot;</span>
-</span></code></pre></div></li>
-<li><code>GET /dog</code> - Should return 200 OK and be rate limited (3 req / 10 seconds).</li>
-</ol>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>curl<span class="w"> </span>--resolve<span class="w"> </span>example.com:9080:127.0.0.1<span class="w"> </span>-v<span class="w"> </span><span class="s2">&quot;http://example.com:9080/dog&quot;</span>
-</span></code></pre></div>
-<ul>
-<li><code>POST /dog</code> - Should return 200 OK and NOT rate limited.</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>curl<span class="w"> </span>--resolve<span class="w"> </span>example.com:9080:127.0.0.1<span class="w"> </span>-v<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="s2">&quot;http://example.com:9080/dog&quot;</span>
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/images/apicurio-security-scheme-apikey.png b/0.10.0/kuadrantctl/doc/images/apicurio-security-scheme-apikey.png
deleted file mode 100644
index 0da63fc05154c49b077c510f1c40ddeff30ae168..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 9423
zcmcI~cQl-B_pVeeK@fr<L`2l+qUIenx<Pc_5F~mTC2EQi5fKr+MHq}e#ONe?h~A<{
z?<E+$ob5a7{C(Cs=l4Bp#WPE0J@@_Wd+%#s*R_Rcsw-Y4p(i0AAh`NSNe)RsaN#R_
zenoU1e(EZJ?1vk%lahfe0RdUV*}rp9Tx1Lc1h)tt$^E0_nYcRUp|7J?C$k|Kc+Toy
z4rIC`g_fpf#7kBYp@z34Ss_6SQ<WE0*cvHCZMdHe?1knu(e#!4%lhnn(|Hp8YZe#G
z<q?F6OI;)1sjd9{M?KahB&Z3gg*|FhWac7VJEe9L&oS2|KG-#mRz|bJRtN}w)%lGv
z{^yhDK85Q!`1JDCf9qaWP<i2Osg2B-loVY(J=x=gwthOXE;T*90wbO*o$S%kUw1W_
z-Zomcx2v6h_0L3&$eYVoU0vvZ7xQ9uICVQaeDb5Cqp9wyv)#E96&+oq&#j`;_M|?j
z`f#mMHkj;A0QL3j?THVHj}4fZm=1T>Gi!A?qxABPL&C#5J39+77=95E92QF_<9C$)
zC{k5T%~BvPJe-_mCYaf8V{;SfIKMmLZ&vv4ITlzTuydXYp`Ij;UoD+DSuZr;_Vx8;
zU`V)jTj5unV5UZj^mfR}$%(MA@bW-jg1DOv3bnm9R#|yt`e=V^cYT77nq+!v>f-rx
zCcH6iZ(hIV<m5yk5YfCQ!zT^z-o2|2CeO^wjERaOzIfi&)|Qz$Wp~`Wv!g@34Qq?i
zt^S*snE3G{1)?R8l$M*DTc|0&`*eS6K1c7*)_x4HNl$-&e-<4TRk81(JAx>@xzcT!
zMt5)2ikO9tj;_1AduV6~zTtbYjV&(Tf@^n|mL!m|25n$qkeZs>(b1v!;pUU#)Ain<
z^z`&F22mUicd|Dfo}Ztuld8lPFKinf7N%xr#~t3hT=);1*n+*NqiI;^p+R-S@Gvi{
zdDKC{X1<j7W6wENyGJ2e$1L97&0oGy*xFX^1Xm0g6_@ky@NCVsw{>=As?akqY;A6~
zwzXkmReEp81lOmYn&|13y3DqI`zBN&$4wL3I0a`V@!-Mp8N*fVkX@AWod_it*R!iL
zMTVJ?(ca#E>`jJMd%W9HA7*K3$)fp#@6q38)c#^`CKo5?l`B{3>gtA5qGDobX=nyU
zM^%0AMJe0b*a!#+?D?D|K5)&d8)v9Ih~cJDNqa5FTJAjE)DS`?+{$NM*7e2;PD#Y>
z_rueBx{uGU==gZ?XI)>&Eb<Yl`n7)5NX*gU#Ho7e(7*r=7XJPF_YQt_byenIA#Gt{
zq1t=bZ)eEbWSat_<Q0NosrACwZA{*N^G4>Ya<UZHaOrxAMzW-n>sD7rU@&>F-~JuL
zR869bm+OPVoKPqlqAT(7^rR$3>tmI-DX+`P`_fWUu1!si=Y7CG{w3u)r|Rcd^Wj5B
zh1;@182z1?wiIdK_)nh%TxME!geBg`az?#teQ}e_dc5kzxpU{{=H@IdEg=KQnIspS
zJBo{n-i3y0b4IzjxeXSWO%z$GsHwI8ctbdtYtUQc^6c5dXt^uK|1LXwzENpMOUuGk
zV<_qpSuhn7Q_YL5x!Bm)p<-)>8#gErPX!E6C?S@ou#AF&!fL`;rH7-dYjH^lKIke#
zVp7ub@-iG&WMt%p^XE-}{I1N`ggAcwoPN!fl$5l%xHu^($<@W>o8x1Q&f0IREE>7L
zx5sUS`!zaRm7To=JA%CA<>h5`|I>q3dGX@KZAec^&-=PaZSAdoJu_IY^XE^@moE=7
zIyQ-$gS98ZA|g9`f2Sdr8EZx$@?8vMjKdhs7GjpXJf8OUu*OCWa>n6D%(G5n^Bs(}
zzK8VqS&4O3@8!G`Mx3^OtoKyIB;@>Ly`p-8h><U*{>wkIchwWU4p6_+6c@4BLt0+r
zCl(e3zU1Cqb2KzGln5UmA9l5Pxv1FqcrpeN)kB(3pFU-k|H3a1)<WUxq^6x+)8C%=
znihK7iH!9135kip4x8sYlG<8ZmkQ}a8^2n|EYd0C_pK00PEJm$s=tb@JIyUD7B3N)
zV}IAxP1TdjtP~n7wZ}<$iwI-e=eP25bDQ4N$?7fiV?BPfwQ=$D|D9`3P*YRWd78<_
z#zui?3S$_2@@rKU3dF>Ok%f(wweH7{R}|)sXV*j{h2P1(_1R*DUOypGeSCe-(!lRS
z90e;i$??$<B^6a?;sYvr`fT4_2;v|48+38h)KB&F^pIwcbw1nZJhRJnw9B=|>dOXu
zEiRy{aD{n!t9=;ek>TNSzY&k7_vNcx3(H$FM;jJ2q4<p_!#^Vxr4Lt@cT(g%GD_VI
z3%`A13!tW<;iP_-T=LLYd2MY?eZFe^VLMs2V#V5&lUOJX4{Ja}Q<I2@h%y>!!|5?u
z7r3fdhRhPZD=J!AEMnIFTSCZd`&pc-`|7Z8g&Z1rhn;<M-^bB$-9gyW+#Hb?(=Tun
z0ObAqD@@^{@Xd<*l9E2Ntx+R5``+GV6y2f3dX+3uxy!6_X$2v?B%e9#8Y-$YugM&1
z)qaqWmnR#n$SkRpmrcn)7kBY;M+PaR&VIihsk!-1H;-zHbo2M`g}J$VKO+f;cMBQ#
z^-?uavA^OI669Ii@pVvkl1v(Gl<g@pr{mS$!)Ady8<Vn#w+A=p+xmxx>1k<WK7W=Y
zio5@$E>sBLA+dhtrdS~cbB~>UF2>9clb`R7LL~}VDqG{BrKl5ygoYZGI+!>+J0Fr%
zOYL;D%)0pd`y+_(xUQsoJUon|4v9@dJFeKFmG9plB3d%k63Cb&e|L3txg7(BQXz~@
zOx#eY1q5%5ghkU8k%Te7^7Hl!U8&qOTwGi#tP!Z3U<kqnG9Z{QPUv22qj{b|aeupg
z85-^ObcRe&ux&nhZ|0{jq9seq&v@<hcqh|uG3Rt?u)lw6he?I#XUl>@_Da*&z))H~
zzpZvr*sHFY8Du;4wQE0SUC3{WeK9R}oT!=b-5nb)v1OL>67oMeI(Ol+&vv(BB)gi8
ze|=Ju;%_tmV>eArO%)YVx8TQ}Ygd*LFJA1IIZuC9zQY(|)sZ+fnM^)xfz?m(J6Hrz
z3TKp1X#WGBGfhSf#hj-a<U?szCu&cj(Gn9A*VNRw&Uc{oP$-X;i2q!}ecW7JTie?@
zd=GpNz8#E{kp$Ka4(i>aNYBU^=<Cxwe4xoi1J&F&FfcG?C3AYTm7Se!JD4voFV86L
z<JtQ89z3uFi(M>av{@vo4t>4z{{8#hygU_U<)Y%^%98t+A%><TzP_(&q*EHri7#IE
z^74{QhVGesP^D{~m3KWciSQbN?bBR(x?lhWw(LCx((qtqd+`QMsPK!;D@+=LLqqu1
zsJ)&Z>*3vOhT`(byBcI9B!)P<q1BO63?=6@?CdPQtILN62gwgyt$w_|1n3TJ9k!VS
zz1Y$ctspEVCFLt@%o{_2;B)Kp+YgKej-;(kmE=5_Z*mB@`Mh>S-ny!~y1J?g(iIw_
zq@-k@jQhH#zW(nJs=FB)DIL>)kw|1+eLVn!Mp(sele&FchPuTc02E0k$D_T!%IM9_
z*)|<(Ub7lIbMvXy)v=**R}-O}%*;~DwrFO*y&n)*_Q)j37n{es6PYxBaC$~YDnzM8
zZXQ}jby_?SsP8HA+S<2S<T!-b1B66H$Ep)tb{&*uWf@u0akzuEvCk47`K35qms@;%
z^44Tw#oE|woOvS&qNT{P4d*bnG&iSUIqG`|U3a9k{s55*1%BjzGVkA!BvA_I^y}BJ
z65Bxqd3ns>1LrBZ!{;g&E?nS^$<gF!Fvp58+NOM8pbRTiawIK$-kSl5hu>c8)y`D+
zz4yxH<Y*s*!30p?lNu}j{P|O8)1UqJ?OPy{jSUSA&CP&ven2zE7`<r^=WG^6N*xC!
zcr+d3Yis?X8z7NAgv>rpz;X@_4#=hVzJy*U?X(|gJG+*Fm;eA(LKltZF*?{?U!P1Z
zuO}+WPAxu0Ra)8EsS;rd3f6y=pVeZ;!qSp58wuuHR41)dx$&#-FDZJ4hkFJFnkJnv
z60TVktWh{hL<PPj#G%tXUmyEAzV|9A>9Y8APnq!=yo_FfsT$EE6&3F_dNl-5Xrqg}
zJA1%rwRdT#jkvgYU(1LFrJjzC=5_H(x90$_KGLVqmP{0dR<+2@Z=EI^^nKFgIGPIO
zv-%bL&xtQpRJ6sq)cE)~J3D(glN2W(U#1>+m1i*-85sn?!^MR)z_{A0#P`xt+SPL7
z@i$Fq<UN*)8gJoE_FNZxn-eKER}5HK8XD3&<Asd|bB7KFj5-27zPdoDZANl22*sFP
z6YaJ6L@EkpWMowGvrGtXOUyc~FL;-5g|GsUVvoncjpoo;!zo;*o34h*LT=s-5EB=7
z7tw|sR$i5X^X9ex<WcZ-{N_PYx7A8@aQ&oe?EQbx$m4_Mf_wMwLG`Syjg5qr3qmVy
zZGDH@6nwbqHBwAxu*AKRKng*h7jXK*z``bsFP$GyRjGV5IEW-4Oo!-B{l;3DJRQBt
zAaYaMM@&$#xTeN5RdZ&3-v9J?H-G|AR8UaRo|oUE>3xmwVYW{89hGRv79AZO4(fNn
zO#y|O#ZhnbX{f2?&e~2ZC<;ExkaXlCbbFlrh(bH9yRYLAkW!%aHnz6AYhyXH-_49c
z1IWoW#0grH01g-$rX!yl8q(w6@`;w79(O!{urn^ZTIw{@axG4EU>Y;Jy}d1LJ78St
zo>x|;pQ<S&ES&VfHONczz7*0;=lq(}a!5W#C%dNyiFmu?j{;TqJ>k!4sjnN#^Ti8)
zNxvfr6R{_V@3{v441!H5ypJ?$?@?ZdMlK~O#4I!rm@LEex^v#c8LD*`D5Cey%6@pL
zb2*n@eqXF9+J)18Z)37=%H+a@H})eqU!cFby1H<56E(gPCc*7ir>l<sX(vEle@#Hp
zTBEoWA(6bcv%IvmGgP(wyB>O1R8&9%F)ei%`x$u`v{4rNe6<=zXS^KhIZ1+k78qCG
zNu}H})<e(0Ag+n34-g8jk-?iHcCmqhmrBI;%K1x+t&9u}DJdzlEXkLG$eGn;*44&7
zvdFg7ifS)MgCYnDx-2UztEkw#mJCNuP!OT{OwxJkb3lNZ|NiXT4`ku-x&5A|!_&>X
z9f=`#0`?9GH}}u4GOXuiehCZ?Zf<V2wzeJ|7-*e!fg>j;4~N|$RRsH=uLNh;*hYb{
z0u24YEaL}B8ll7%`4gIioxQ!{`y2lZJ}Dkb5Oq{nQWEo6GgepsAjirtAV4qX^zXm_
zeo0B0a6NqRVsi%61kiQ+@v8klKi=^9y1v<gV~yrBOHNGWrVN2x(&q*lcC{okHY9}D
zL@fck`?9HWtZ|MQWG93aI$*8H5Vqcm@G3oUEO(Hhpeqj!yriV6{f-aLG_j!7uZ4{u
z91v_^=)glhM@4A~RvLayzA?YJxIZOf1z~we&c>eX;NSpC`L6m+UXGUM&m$5g_irD+
z{FWa^H*JPw_1fk*Zi$ep4|;L9_rA2`n3M&07>K{U5l1~HnG+K<^2LiVrUx#@rCyCo
z+zSL%UhwYH@Pf_E{#8zsh}BLKV&b1ae-4$qW`>7rtmCi3vO=(`y1M#G#Rtu2RW|*n
z%M~A#(aNflNuOLITG8U-lG0|kB80R=Gm3}oWNKd$Q=PAnU<?`J^L*p8HyM1BY<^{^
zSRhWdO`A#5^J8S>^uj{cNgpLV*z*!l)0pAQsib~>ktri&p^aYa)r)36Sob|AW_V~!
z+tRY_tV{W;SCb=-hrA{gep3zir1n}Ei_15xhAKVQ0jeO~Xu0(_Mq8E90zyJU5)y~s
zUtQp{l^}xWcO@J1=3p>OD;z0&_k~u*rIk3NvN0Ge8Xeb3OLQ@aujmUkKkYa-N#GRl
ze>;&wp!Gg$8tx!#%+0?hB{7y<0>20BA%5Dk+YKVy|4-LNJggi{2+u|?)4%WZs-~_N
zcs4FG91aUhUOJ02ED%a_cK`3$I{z)Z=>PWI6C?9AI4l}&{VunpBngiWux0crSt68P
zzkUt6%B+wPKdGaq=k4unR_zrfosGl{<Qa+D4}XI)NiI3v>Xae8d|5<TxcXliv#;>G
zwirHZOUvh<MTLZnYkbPl=vlP!od*vL*eI(%XC$le#!QqsrvY?XXVOwrr)Or?j`9Ms
z-v7BAQV!yUHKMAOs|G({1T?T<^Bv<bWP57rB&4ZXVN!lDI5j(vTx-K6Z9P3j)~mIr
zCx=Z<O%m=a3(pC?Re<o@+pjLKHMRkb4txLJQ!-g33J3_Wvp$uJ=U-`ZtR&^1t@Z;}
z<LBoG<qM!&u=0+IU3KqhtJ7>~R$NC{_c}8(GbLr6Rqevac%u_YgB#4uwHD1}goMFN
zrJYvAvIs;+iVPo3sP|}#N@hWUqm4~`TpU;%I~9kUl!f}-9v&Wmnf9D|j~{bJDdQ<s
zR8*|3=f@Z6A%m!#%-VDTt$_<xJ?s9OmBj(LxT^6!JiHdF{GWeb>2QMfFs|~%1_u+m
zaR>>az^*aJ?$rg7f&&583JVL%j~_q!y5X$Gp?N~5H8fR1Bjptoq(Qks`v8g?@DT`|
zl=sflr%!<lfh`986*TvFg`4fqPj|3b?C}9Ut<$8|@0i*D=r5dM>3S8&xd37+FGsOV
zu<O7Y`M@Y~`O1wirpd9fU~0*{lViPoJMHDmmzPLsoWv5rO-PaPmzI`JuAl5m1KLe5
zY}5DdI@i(BQ4L^bSy@?O;eDQoZ{r!793ZElttBNSNI3oZ-jS`Vqaz850)q)@w_;#m
z0LzN*#tqcKzYY%h`rHn-wt_-JD}c&PX18W%XF*L+hR8wtX>H9mtMvn)OPrsNub`+1
z$s4o0us{@ufc^rWBH}F)!wv2r7gwY*+L(6`9Hz0cY7p8Wpwbk=C_@`rBb0b!!s&(I
zwauDVy0?#wjn&n?ruY;eZ)0hBCrTOog&CLf<mBWxZ{9$^U}2MxfVa>`BTZ_2;?B%~
z^_7*xgajj9U166QrR*GmIBwWScD6F?V|f|)mxP#@W;Hrr+GlU0sHh0E5Dq6IopL&0
z<ft`xiGbkW>_Nc<+h@<pymuX>Q)=Pp9oiS6MMId~n?Eof?yL&lzpsxqmv?m)^hJU8
z$ji$E4-y*u6=LEcaGlJ}%{#ryKreXjuB{Fg2e+017?RTR3i0!YK*ySwIW;ggu0ky$
zqm+fs8;ERemw_ww+{J-=aQCi8f=Hfk!s6m0m<LPD$lB3K;|kQ`;d<=^m@S1*>igO{
zlcgBw=pH<&3jjk7R)O?#fZqjt1WrFZJj@{K&?US+QEO&uD($wUgLwPl!-vYsLxz$A
zZH&&+;vydY4-P#eBcootv9S^CGb<}Ah$gHDs+osJ?bt+j7ofbgwH46D%iDWoXh`bC
zrkrnbS$g^m5EuxBsj2CO%U3vfc-q_A(#W8z3kwNdfzH(M_8K_YltdQ+Hu_S*q=-;@
z3iUKO$?x>%;nIBYr^v|LG@*o7Zrp#`LQzpuQB@_0MlR0I3cIi9L(S&q=5B7fAe2r|
zj*}7-f$pC<O5x1wGc)PVUlFNF8XAsvb|^PD{N`p+X(=BkXODjK5!er@nqp7}z)@op
z62R-;3p4bFUa-+qjWg=<iblyCZ}%D$TV1_z|NGF;ekfnfGdsIqVAY0$O7#ERNDJ@p
zBP}B)CU)!AAG6Z~J@Nybb!YO-%na0}zJY<(9XRr09B#bu$(x*<WjF&7htb%mD7WJS
zH<1KJYU<A)Ki-P`nH3K`Um$L!dUxD*!VV0<rkgV=H#?yGfY3WySWK_3=9%Vea(w;z
z_56hk^>uY%c|#4-@R|BdHH3gI3Kho3$A^EP{PAN~ftd^~E$xyD*eN@uKGh0fd{USL
zXErzQne4fQM#iP2I6`0-7C5L$z#xMX!EbN(P3Rf|nz^}^<mBX_(ddV_K*SY<hLVnD
zD5G0DJ3)1V`yzDzeqmvulZ%Vj&I%nq%)!o12<#|+{>iO<$O+&meL_yMvTyXc-Qhu{
zrJ^uGC@lQqA3(%H8S)gEFdRP^?Tbz?;f%qA0jmUDM|c7N-la>I0w_ch)Y{uz#BP!W
z_xg3KJbLs9@*83XFn8tZ)idYL*jQOvx$jMGd3iZh&W8_V!S&846qIz*F$Q4w`;`LM
z%uBMe^?636(J?WOqh(maOzm@DQ&V5@Lfg>NAb{+H#7%0SaeG@o31TEs@`VeOp}V^~
z>V=or0T?R_O_+3f`R^F*Ol7uDGc!+@G(pT~X{EskMA#63%ht}$&g`TpDDv~??Vop3
zfGMtwR~uDJ0#4v?1D&1Wyw2e7w$1i6Jaux~fC9_9R0c=8)St7o)dfnCG9*BK!;uV}
z!*b)~$jCIU@xDH`n701Ang-m_fr0YDFY;l#jpmrU>J}CjoNAN^I9(XN97y?qp{$Jl
zMDhW43q^Yfc->cP7VvR+*pMa^J$}v&w44cF8x2Vyijar}0u5A~B=BpfHV2R%dXHiQ
zeSK(K_*Z}cn3THdzaX?+jliGT+wzjKb-jng2nh%vIjDJ!aH?$wXJ`e}9Ay<1VTb0_
zXQQ5Q*dWETv!Ox_-7(+3ZEsB0!{`Fgd)vh*PL(}E39t(|zWN|Ad$42K0-zTG?(INZ
z|KGzOFc84(GC7O}93^I1V%7zK;x?=C0TT)G!3byfcYFIL*kHP*dU}dP`<rcii$`+p
zA;=_VL96%R1C|i%mQMHq@`F3}b)>JiH_a=5)`6hleNBxYG&vU+7j7P&GfU5<+*ti&
zON~8X!&5R4k&49hQL(YeaYk)=O5zcaW6he`m|${d8{_zQL11kM1qHE2oB`7J@87$-
zBi`ZqkS1ZI-C4WEq{eIhNB-$S?2$i(T1T`wsOiIs^|^UtRKi|wX82M8$?zJn4J}7v
zQ2U#+kilA7T01*C!-<r1ba4?8Soc*!n?PG%-|E`hTCYHm8+blU3B_1NV_5y<O>xvh
zW{RI7Y+OU;xUbaF>})vI+uxrgZ2K6bkC&ymgL;az6f5i3s;Z*{{4y{gXvC{Vb6fj2
z$rP)D`8>pYq*EvaKsyqWGs!6^fN=c0B<XhB|LN28rq}8=rg8O?7cXBnEpuW4{mjqb
zJvbOc(u*SeZRc*i>sW0HS#<sS^|-h=KyMUF)J!_^9^OGSEB3dv*IA&bm58)Bqqe_Z
z;xs3t7gDm=Lj{Ql2*9i<^5;|N*W}F7+Z!AAg@w_dEDx2`7P(J)gbrloZS1G+!E3~#
z^e{Rkfrw+rGdg`LQefSUAQ#{T7eUyqC;bt$j6S}Toi+t#NzX4Q#OqO9dMhg{-%?ud
z1jNS085kMy85A|Nwt~r|i(1*(-uBsEhzJV{%cG~FqFP#j#9Lii$u}-{S?obWQ|V=(
z%}SG&;^X34UY*P}tsd^{+g>iH&7e$xd5R{-uZ|Afu?C6)W?zsW$KbsIPswwhHwL|2
zUcMjd=s&;!@)2-Pl|Aio0TRCFDaj<PrIwSMyW*7h7Wg9)qjRcncDzmkei<WUQd5({
ziGR=D9E1sY$*YGCSLXl~a*-IXDs5AkE(i~*Ukh!7(}`~dd}CDK*9OqjHZv<oMm3sa
zmC;}Q<tj6DI58S$>Lzvu&lU@<%0qOT5&`~K%BN48&?={<ra<?fY}Av}$EB5&xHZ1J
z4k3ruGXdiX7(>o=rcAt9`|DYymLLMh*xjkPHxsD=o@?#VW*d0Tme$trO;K_2ct2wp
z8-i8x4ko)TEnjf=7P`7pWucQ#jMPI;obHS`!o&$$3lR&LVArl)gNYL8&v{r!Ku}N{
ziOfo(;ec5(WFI{DI!WMdh4-3{ODD&N^a&zWTEMtroa2@86sr%zQUKS$z(8m#csxFw
zS;pb{bHHai{|YRYzl78gtXMf#2n{41D#N;X2s#F&5`cM0Ny*i#SEHh$w$(}Z_xJk@
z09o$bxdT7@xXZ9uXPD)|Ucgk&G8(PGtCrw!(WK>12na5^o&7BU4vKl8zaLO;c5V)O
zNsm+}V!t<218`<U5ebkjo#GF?AU-}GSToSJ+*~ldxp+ip+dDeW#&=wP=HPlfbo7=A
zrGdfo`Sa&1N)lgE6nWv7c#Lpza&j<lPn8XJ7%g*#ammtk=)wCwC%`##va^AAJkB@9
zV6Qy%1}Mn^hq1(_AL0umvW1x$)W)A5(C7+GDx+J4WP`2{6A^t`)`%0ZTpzD~Lr8wo
zW_HqJkN^hRBPAt@5ILQ)_3Fv(<v~X{?FpZ)u;AceZ~*`fFqlO^2@nY|t+lkW%E0ED
zLrST{@IusdQ_6T?BFMqv=_=B``Vp9|KKJ8V@?6MrW8PBe*I8L_8_nq$7`(l_+;MAl
z?d?3GqA|nY{<%dVCLtl?d+=G>#=@e0`fswdukxw^)Pc%rLy>;&=%}%c)~koNoZQ^d
zj+P7pPnG=q{GL2X)#2>#?p|DR|3)_S`!|RLplV>Cfk!(vg~*d+2>`Z!_wL;YrO&`K
z932a=7X#a^VClKp*)uB09=W)@JTfxk@i#5&Rr9o##QkRzx_}X)%qqvSJu)R-U79e?
znr(}zjm}YF`vm0;SRiL{oG*?>K7c@Vrz!H8RBV@Dt!bT1N2BHC<e-HkeO*I<VT0Rx
zW?4JVeZ4gI2->xPK#yns*(7WG_wwlTNpvrJ5wn=nmwM||aIL!pt)(bvX`5$VDwFLk
zi-+34eg+c~*m40Ahs0Lv$$2oI(qm#`ykcN9tdS&M;ykVJ)EJ(&7iq5ZtG_ANptz5g
zp{oKvDUb(ZtENU;Lc$xA*^?(v`ld}Q|12*b?$(|rc_}|8=iPOIiMcYm2TFRp%-I6I
zwG=GJ+6`l^2ktAs2m3|OV3Ky*jMfznw4{npk>UCC=L{lt@Fxtw@5zXXyXQXN)6S^M
z&8hv8rWk$#-Yw+$>0YzU=;&x4xm(%YGu8P$g~)Ya?(ENJ2)YV4&m11GH2#lw@;`Kc
zJEF1*#K_c!?mv%z**U*!bI2W~+@JFwkA}b#U-%6A;(uY~|LHgRe|_G<>4ndNOxWx9
S_?FM!^O3x|Tt4F8*Z&KFz3J%y

diff --git a/0.10.0/kuadrantctl/doc/images/apicurio-vendor-extension-backend-rate-limit.png b/0.10.0/kuadrantctl/doc/images/apicurio-vendor-extension-backend-rate-limit.png
deleted file mode 100644
index 8d18f023f2ea1fed483092f266c9feda6f6ac6bc..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 40320
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

diff --git a/0.10.0/kuadrantctl/doc/kuadrantctl-ci-cd/index.html b/0.10.0/kuadrantctl/doc/kuadrantctl-ci-cd/index.html
deleted file mode 100644
index 5491c5fd0..000000000
--- a/0.10.0/kuadrantctl/doc/kuadrantctl-ci-cd/index.html
+++ /dev/null
@@ -1,3775 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/kuadrantctl-ci-cd/">
-      
-      
-        <link rel="prev" href="../generate-kuadrant-rate-limit-policy/">
-      
-      
-        <link rel="next" href="../openapi-apicurio/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>CI/CD with kuadrantctl & Tekton - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrantctl-cicd-with-tekton-and-argo-cd" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              CI/CD with kuadrantctl & Tekton
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-set-up-your-namespace" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Set up your namespace
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-create-a-persistent-volume-claim" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Create a Persistent Volume Claim
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#step-3-define-the-tekton-task" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Define the Tekton Task
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#step-4-create-a-kubeconfig-secret" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Create a Kubeconfig secret
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 4 - Create a Kubeconfig secret">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-5-trigger-the-taskrun" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Trigger the TaskRun
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-6-cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 6 - Cleanup
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-set-up-your-namespace" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Set up your namespace
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-create-a-persistent-volume-claim" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Create a Persistent Volume Claim
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#step-3-define-the-tekton-task" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Define the Tekton Task
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#step-4-create-a-kubeconfig-secret" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Create a Kubeconfig secret
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 4 - Create a Kubeconfig secret">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-5-trigger-the-taskrun" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Trigger the TaskRun
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-6-cleanup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 6 - Cleanup
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/kuadrantctl-ci-cd.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrantctl-cicd-with-tekton-and-argo-cd">kuadrantctl - CI/CD with Tekton and Argo CD<a class="headerlink" href="#kuadrantctl-cicd-with-tekton-and-argo-cd" title="Permanent link">&para;</a></h1>
-<p>This guide demonstrates setting up a CI/CD pipeline by using Tekton to deploy Kubernetes Gateway API and Kuadrant resources generated by <code>kuadrantctl</code>, from an OpenAPI definition. In this example, these resources are applied directly to the cluster where Tekton is running.</p>
-<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li>Kuadrant, and all of its prerequisites, installed on a Kubernetes or OpenShift cluster.</li>
-<li><a href="https://tekton.dev/">Tekton Pipelines</a> installed on your cluster.</li>
-<li><a href="https://kubernetes.io/docs/reference/kubectl/"><code>kubectl</code></a> configured with access to communicate with your cluster.</li>
-<li>Optional: <a href="https://tekton.dev/docs/cli/">Tekton CLI <code>tkn</code></a> for easier interaction with Tekton resources.</li>
-</ul>
-<h2 id="procedure">Procedure<a class="headerlink" href="#procedure" title="Permanent link">&para;</a></h2>
-<h3 id="step-1-set-up-your-namespace">Step 1 - Set up your namespace<a class="headerlink" href="#step-1-set-up-your-namespace" title="Permanent link">&para;</a></h3>
-<p>Create a dedicated namespace as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>namespace<span class="w"> </span>petstore
-</span></code></pre></div>
-<h3 id="step-2-create-a-persistent-volume-claim">Step 2 - Create a Persistent Volume Claim<a class="headerlink" href="#step-2-create-a-persistent-volume-claim" title="Permanent link">&para;</a></h3>
-<p>For this example, to store associated Tekton build artifacts, create a Persistent Volume Claim (PVC) in the <code>petstore</code> namespace as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="s">apiVersion: v1</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="s">kind: PersistentVolumeClaim</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="s">metadata:</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="s">  name: tekton-kuadrantctl-pvc</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="s">  namespace: petstore</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="s">spec:</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="s">  accessModes:</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="s">    - ReadWriteOnce</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="s">  resources:</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="s">    requests:</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="s">      storage: 1Gi</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h2 id="step-3-define-the-tekton-task">Step 3 - Define the Tekton Task<a class="headerlink" href="#step-3-define-the-tekton-task" title="Permanent link">&para;</a></h2>
-<p>Define the task that outlines steps to clone a repository, generate Kuadrant and Kubernetes resources by using <code>kuadrantctl</code>, and apply them directly to the cluster as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;&#39;EOF&#39;</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">apiVersion: tekton.dev/v1beta1</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">kind: Task</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">metadata:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">  name: run-kuadrantctl</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">  namespace: petstore</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">spec:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">  params:</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">    - name: gitRepoUrl</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">      description: URL of the git repository to clone</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">    - name: gitRevision</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">      description: Git revision to checkout (branch, tag, sha)</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="s">  workspaces:</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="s">    - name: source</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="s">      description: Workspace to checkout the git repo</span>
-</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a><span class="s">    - name: kubeconfig</span>
-</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a><span class="s">      description: Workspace containing kubeconfig for Kubernetes cluster access</span>
-</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a><span class="s">  steps:</span>
-</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a><span class="s">    - name: clean-workspace</span>
-</span><span id="__span-2-21"><a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a><span class="s">      image: alpine:latest</span>
-</span><span id="__span-2-22"><a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a><span class="s">      script: |</span>
-</span><span id="__span-2-23"><a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a><span class="s">        sh -c &#39;rm -rf $(workspaces.source.path)/* $(workspaces.source.path)/.[!.]* $(workspaces.source.path)/..?*&#39;</span>
-</span><span id="__span-2-24"><a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a><span class="s">    - name: clone</span>
-</span><span id="__span-2-25"><a id="__codelineno-2-25" name="__codelineno-2-25" href="#__codelineno-2-25"></a><span class="s">      image: alpine/git:latest</span>
-</span><span id="__span-2-26"><a id="__codelineno-2-26" name="__codelineno-2-26" href="#__codelineno-2-26"></a><span class="s">      script: |</span>
-</span><span id="__span-2-27"><a id="__codelineno-2-27" name="__codelineno-2-27" href="#__codelineno-2-27"></a><span class="s">        git clone $(params.gitRepoUrl) $(workspaces.source.path)</span>
-</span><span id="__span-2-28"><a id="__codelineno-2-28" name="__codelineno-2-28" href="#__codelineno-2-28"></a><span class="s">        cd $(workspaces.source.path)</span>
-</span><span id="__span-2-29"><a id="__codelineno-2-29" name="__codelineno-2-29" href="#__codelineno-2-29"></a><span class="s">        git checkout $(params.gitRevision)</span>
-</span><span id="__span-2-30"><a id="__codelineno-2-30" name="__codelineno-2-30" href="#__codelineno-2-30"></a><span class="s">    - name: download-kuadrantctl</span>
-</span><span id="__span-2-31"><a id="__codelineno-2-31" name="__codelineno-2-31" href="#__codelineno-2-31"></a><span class="s">      image: curlimages/curl:latest</span>
-</span><span id="__span-2-32"><a id="__codelineno-2-32" name="__codelineno-2-32" href="#__codelineno-2-32"></a><span class="s">      script: |</span>
-</span><span id="__span-2-33"><a id="__codelineno-2-33" name="__codelineno-2-33" href="#__codelineno-2-33"></a><span class="s">        ARCH=$(uname -m)</span>
-</span><span id="__span-2-34"><a id="__codelineno-2-34" name="__codelineno-2-34" href="#__codelineno-2-34"></a><span class="s">        case $ARCH in</span>
-</span><span id="__span-2-35"><a id="__codelineno-2-35" name="__codelineno-2-35" href="#__codelineno-2-35"></a><span class="s">        x86_64) BIN_ARCH=&quot;amd64&quot;;;</span>
-</span><span id="__span-2-36"><a id="__codelineno-2-36" name="__codelineno-2-36" href="#__codelineno-2-36"></a><span class="s">        arm64) BIN_ARCH=&quot;arm64&quot;;;</span>
-</span><span id="__span-2-37"><a id="__codelineno-2-37" name="__codelineno-2-37" href="#__codelineno-2-37"></a><span class="s">        aarch64) BIN_ARCH=&quot;arm64&quot;;;</span>
-</span><span id="__span-2-38"><a id="__codelineno-2-38" name="__codelineno-2-38" href="#__codelineno-2-38"></a><span class="s">        *) echo &quot;Unsupported architecture: $ARCH&quot; &amp;&amp; exit 1 ;;</span>
-</span><span id="__span-2-39"><a id="__codelineno-2-39" name="__codelineno-2-39" href="#__codelineno-2-39"></a><span class="s">        esac</span>
-</span><span id="__span-2-40"><a id="__codelineno-2-40" name="__codelineno-2-40" href="#__codelineno-2-40"></a><span class="s">        cd $(workspaces.source.path)</span>
-</span><span id="__span-2-41"><a id="__codelineno-2-41" name="__codelineno-2-41" href="#__codelineno-2-41"></a><span class="s">        curl -LO &quot;https://github.com/Kuadrant/kuadrantctl/releases/download/v0.2.3/kuadrantctl-v0.2.3-linux-$BIN_ARCH.tar.gz&quot;</span>
-</span><span id="__span-2-42"><a id="__codelineno-2-42" name="__codelineno-2-42" href="#__codelineno-2-42"></a><span class="s">        tar -xzf kuadrantctl-v0.2.3-linux-$BIN_ARCH.tar.gz</span>
-</span><span id="__span-2-43"><a id="__codelineno-2-43" name="__codelineno-2-43" href="#__codelineno-2-43"></a><span class="s">    - name: run-kuadrantctl</span>
-</span><span id="__span-2-44"><a id="__codelineno-2-44" name="__codelineno-2-44" href="#__codelineno-2-44"></a><span class="s">      image: alpine:latest</span>
-</span><span id="__span-2-45"><a id="__codelineno-2-45" name="__codelineno-2-45" href="#__codelineno-2-45"></a><span class="s">      script: |</span>
-</span><span id="__span-2-46"><a id="__codelineno-2-46" name="__codelineno-2-46" href="#__codelineno-2-46"></a><span class="s">        cd $(workspaces.source.path)</span>
-</span><span id="__span-2-47"><a id="__codelineno-2-47" name="__codelineno-2-47" href="#__codelineno-2-47"></a><span class="s">        mkdir -p generated-resources</span>
-</span><span id="__span-2-48"><a id="__codelineno-2-48" name="__codelineno-2-48" href="#__codelineno-2-48"></a><span class="s">        ./kuadrantctl generate kuadrant authpolicy --oas openapi.yaml | tee generated-resources/authpolicy.yaml</span>
-</span><span id="__span-2-49"><a id="__codelineno-2-49" name="__codelineno-2-49" href="#__codelineno-2-49"></a><span class="s">        ./kuadrantctl generate kuadrant ratelimitpolicy --oas openapi.yaml |  tee generated-resources/ratelimitpolicy.yaml</span>
-</span><span id="__span-2-50"><a id="__codelineno-2-50" name="__codelineno-2-50" href="#__codelineno-2-50"></a><span class="s">        ./kuadrantctl generate gatewayapi httproute --oas openapi.yaml | tee generated-resources/httproute.yaml</span>
-</span><span id="__span-2-51"><a id="__codelineno-2-51" name="__codelineno-2-51" href="#__codelineno-2-51"></a><span class="s">    - name: apply-resources</span>
-</span><span id="__span-2-52"><a id="__codelineno-2-52" name="__codelineno-2-52" href="#__codelineno-2-52"></a><span class="s">      image: bitnami/kubectl</span>
-</span><span id="__span-2-53"><a id="__codelineno-2-53" name="__codelineno-2-53" href="#__codelineno-2-53"></a><span class="s">      script: |</span>
-</span><span id="__span-2-54"><a id="__codelineno-2-54" name="__codelineno-2-54" href="#__codelineno-2-54"></a><span class="s">        cd $(workspaces.source.path)</span>
-</span><span id="__span-2-55"><a id="__codelineno-2-55" name="__codelineno-2-55" href="#__codelineno-2-55"></a><span class="s">        export KUADRANT_ZONE_ROOT_DOMAIN=example.com # domain name used in the HTTPRoute for the petstore sample app</span>
-</span><span id="__span-2-56"><a id="__codelineno-2-56" name="__codelineno-2-56" href="#__codelineno-2-56"></a><span class="s">        for file in ./generated-resources/*.yaml; do</span>
-</span><span id="__span-2-57"><a id="__codelineno-2-57" name="__codelineno-2-57" href="#__codelineno-2-57"></a><span class="s">          envsubst &lt; &quot;$file&quot; | kubectl apply -n petstore -f - </span>
-</span><span id="__span-2-58"><a id="__codelineno-2-58" name="__codelineno-2-58" href="#__codelineno-2-58"></a><span class="s">        done</span>
-</span><span id="__span-2-59"><a id="__codelineno-2-59" name="__codelineno-2-59" href="#__codelineno-2-59"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p><strong>Note:</strong> This example uses Tekton with <code>kubectl</code> to apply resources to a cluster. It is best to use a tool such as <a href="https://argo-cd.readthedocs.io/en/stable/">Argo CD</a> to implement continuous delivery by using a GitOps approach. In this scenario, you would do the following:</p>
-<ul>
-<li>Use <code>kuadrantctl</code> to generate Kubernetes and Kuadrant resources as part a Tekton pipeline.</li>
-<li>Commit these new resources to a Git repository.</li>
-<li>Use ArgoCD to sync these changes from the Git repository to a Kubernetes or OpenShift cluster.</li>
-</ul>
-<h2 id="step-4-create-a-kubeconfig-secret">Step 4 - Create a Kubeconfig secret<a class="headerlink" href="#step-4-create-a-kubeconfig-secret" title="Permanent link">&para;</a></h2>
-<blockquote>
-<p><strong>Important:</strong> While this guide uses a <code>kubeconfig</code> secret for simplicity, do not use this in production environments. Instead, use a service account for enhanced security.</p>
-</blockquote>
-<p>This example uses a <code>kubeconfig</code> secret and role bindings to demonstrate how to provide access for pushing generated resources to a cluster. However, for production setups, employing a service account is best.</p>
-<p>To proceed, create a <code>kubeconfig</code> secret in the <code>petstore</code> namespace to provide Tekton with access to your Kubernetes cluster as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>kubectl<span class="w"> </span>create<span class="w"> </span>secret<span class="w"> </span>generic<span class="w"> </span>kubeconfig-secret<span class="w"> </span>--from-file<span class="o">=</span><span class="nv">kubeconfig</span><span class="o">=</span>/path/to/.kube/config<span class="w"> </span>-n<span class="w"> </span>petstore
-</span></code></pre></div>
-<p>Create an associated <code>ClusterRole</code> and <code>ClusterRoleBinding</code> as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="s">kind: ClusterRole</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="s">metadata:</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="s">  name: kuadrant-ci-example-full-access</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="s">rules:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="s">- apiGroups: [&quot;*&quot;]</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="s">  resources: [&quot;*&quot;]</span>
-</span><span id="__span-4-10"><a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a><span class="s">  verbs: [&quot;*&quot;]</span>
-</span><span id="__span-4-11"><a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a><span class="s">---</span>
-</span><span id="__span-4-12"><a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="s">apiVersion: rbac.authorization.k8s.io/v1</span>
-</span><span id="__span-4-13"><a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a><span class="s">kind: ClusterRoleBinding</span>
-</span><span id="__span-4-14"><a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a><span class="s">metadata:</span>
-</span><span id="__span-4-15"><a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a><span class="s">  name: kuadrant-ci-example-full-access-binding</span>
-</span><span id="__span-4-16"><a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a><span class="s">subjects:</span>
-</span><span id="__span-4-17"><a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a><span class="s">- kind: ServiceAccount</span>
-</span><span id="__span-4-18"><a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a><span class="s">  name: default</span>
-</span><span id="__span-4-19"><a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a><span class="s">  namespace: petstore</span>
-</span><span id="__span-4-20"><a id="__codelineno-4-20" name="__codelineno-4-20" href="#__codelineno-4-20"></a><span class="s">roleRef:</span>
-</span><span id="__span-4-21"><a id="__codelineno-4-21" name="__codelineno-4-21" href="#__codelineno-4-21"></a><span class="s">  kind: ClusterRole</span>
-</span><span id="__span-4-22"><a id="__codelineno-4-22" name="__codelineno-4-22" href="#__codelineno-4-22"></a><span class="s">  name: kuadrant-ci-example-full-access</span>
-</span><span id="__span-4-23"><a id="__codelineno-4-23" name="__codelineno-4-23" href="#__codelineno-4-23"></a><span class="s">  apiGroup: rbac.authorization.k8s.io</span>
-</span><span id="__span-4-24"><a id="__codelineno-4-24" name="__codelineno-4-24" href="#__codelineno-4-24"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<h3 id="step-5-trigger-the-taskrun">Step 5 - Trigger the TaskRun<a class="headerlink" href="#step-5-trigger-the-taskrun" title="Permanent link">&para;</a></h3>
-<p>Execute the task from the <code>petstore</code> namespace, referencing the <code>kubeconfig</code> secret for cluster access as follows:</p>
-<p>This example runs this task with the Kuadrant Petstore app: https://github.com/kuadrant/api-petstore.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f<span class="w"> </span>-<span class="w"> </span><span class="s">&lt;&lt;EOF</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="s">apiVersion: tekton.dev/v1beta1</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="s">kind: TaskRun</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="s">metadata:</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="s">  name: run-kuadrantctl-taskrun</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="s">  namespace: petstore</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="s">spec:</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="s">  taskRef:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="s">    name: run-kuadrantctl</span>
-</span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="s">  params:</span>
-</span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a>
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="s">    - name: gitRepoUrl</span>
-</span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="s">      value: &quot;https://github.com/kuadrant/api-petstore.git&quot;</span>
-</span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="s">    - name: gitRevision</span>
-</span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="s">      value: &quot;main&quot;</span>
-</span><span id="__span-5-16"><a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="s">  workspaces:</span>
-</span><span id="__span-5-17"><a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></a><span class="s">    - name: source</span>
-</span><span id="__span-5-18"><a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a><span class="s">      persistentVolumeClaim:</span>
-</span><span id="__span-5-19"><a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a><span class="s">        claimName: tekton-kuadrantctl-pvc</span>
-</span><span id="__span-5-20"><a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></a><span class="s">    - name: kubeconfig</span>
-</span><span id="__span-5-21"><a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a><span class="s">      secret:</span>
-</span><span id="__span-5-22"><a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a><span class="s">        secretName: kubeconfig-secret</span>
-</span><span id="__span-5-23"><a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></a><span class="s">EOF</span>
-</span></code></pre></div>
-<p>If you have <code>tkn</code> installed, you can easily view the progress of the pipe run as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>tkn<span class="w"> </span>taskrun<span class="w"> </span>list<span class="w"> </span>-n<span class="w"> </span>petstore
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>NAME<span class="w">                      </span>STARTED<span class="w">          </span>DURATION<span class="w">   </span>STATUS
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>run-kuadrantctl-taskrun<span class="w">   </span><span class="m">12</span><span class="w"> </span>seconds<span class="w"> </span>ago<span class="w">   </span>---<span class="w">        </span>Running<span class="o">(</span>Pending<span class="o">)</span>
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>tkn<span class="w"> </span>taskrun<span class="w"> </span>logs<span class="w"> </span>-n<span class="w"> </span>petstore<span class="w"> </span>-f
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="o">[</span>clone<span class="o">]</span><span class="w"> </span>Cloning<span class="w"> </span>into<span class="w"> </span><span class="s1">&#39;/workspace/source&#39;</span>...
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="o">[</span>clone<span class="o">]</span><span class="w"> </span>Already<span class="w"> </span>on<span class="w"> </span><span class="s1">&#39;main&#39;</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="o">[</span>clone<span class="o">]</span><span class="w"> </span>Your<span class="w"> </span>branch<span class="w"> </span>is<span class="w"> </span>up<span class="w"> </span>to<span class="w"> </span>date<span class="w"> </span>with<span class="w"> </span><span class="s1">&#39;origin/main&#39;</span>.
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="o">[</span>download-kuadrantctl<span class="o">]</span><span class="w">   </span>%<span class="w"> </span>Total<span class="w">    </span>%<span class="w"> </span>Received<span class="w"> </span>%<span class="w"> </span>Xferd<span class="w">  </span>Average<span class="w"> </span>Speed<span class="w">   </span>Time<span class="w">    </span>Time<span class="w">     </span>Time<span class="w">  </span>Current
-</span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="o">[</span>download-kuadrantctl<span class="o">]</span><span class="w">                                  </span>Dload<span class="w">  </span>Upload<span class="w">   </span>Total<span class="w">   </span>Spent<span class="w">    </span>Left<span class="w">  </span>Speed
-</span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w">  </span><span class="m">0</span><span class="w">     </span><span class="m">0</span><span class="w">    </span><span class="m">0</span><span class="w">     </span><span class="m">0</span><span class="w">    </span><span class="m">0</span><span class="w">     </span><span class="m">0</span><span class="w">      </span><span class="m">0</span><span class="w">      </span><span class="m">0</span><span class="w"> </span>--:--:--<span class="w"> </span>--:--:--<span class="w"> </span>--:--:--<span class="w">     </span><span class="m">0</span>
-</span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="m">100</span><span class="w"> </span><span class="m">21</span>.4M<span class="w">  </span><span class="m">100</span><span class="w"> </span><span class="m">21</span>.4M<span class="w">    </span><span class="m">0</span><span class="w">     </span><span class="m">0</span><span class="w">  </span>6601k<span class="w">      </span><span class="m">0</span><span class="w">  </span><span class="m">0</span>:00:03<span class="w">  </span><span class="m">0</span>:00:03<span class="w"> </span>--:--:--<span class="w"> </span>8756k
-</span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a>
-</span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="o">[</span>run-kuadrantctl<span class="o">]</span><span class="w"> </span><span class="o">{</span><span class="s2">&quot;kind&quot;</span>:<span class="s2">&quot;AuthPolicy&quot;</span>,<span class="s2">&quot;apiVersion&quot;</span>:<span class="s2">&quot;kuadrant.io/v1beta2&quot;</span>,<span class="s2">&quot;metadata&quot;</span>:<span class="o">{</span><span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;creationTimestamp&quot;</span>:null,<span class="s2">&quot;labels&quot;</span>:<span class="o">{</span><span class="s2">&quot;deployment&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;owner&quot;</span>:<span class="s2">&quot;jbloggs&quot;</span><span class="o">}}</span>,<span class="s2">&quot;spec&quot;</span>:<span class="o">{</span><span class="s2">&quot;targetRef&quot;</span>:<span class="o">{</span><span class="s2">&quot;group&quot;</span>:<span class="s2">&quot;gateway.networking.k8s.io&quot;</span>,<span class="s2">&quot;kind&quot;</span>:<span class="s2">&quot;HTTPRoute&quot;</span>,<span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;petstore&quot;</span><span class="o">}</span>,<span class="s2">&quot;routeSelectors&quot;</span>:<span class="o">[{</span><span class="s2">&quot;matches&quot;</span>:<span class="o">[{</span><span class="s2">&quot;path&quot;</span>:<span class="o">{</span><span class="s2">&quot;type&quot;</span>:<span class="s2">&quot;Exact&quot;</span>,<span class="s2">&quot;value&quot;</span>:<span class="s2">&quot;/api/v3/store/admin&quot;</span><span class="o">}</span>,<span class="s2">&quot;method&quot;</span>:<span class="s2">&quot;GET&quot;</span><span class="o">}]}]</span>,<span class="s2">&quot;rules&quot;</span>:<span class="o">{</span><span class="s2">&quot;authentication&quot;</span>:<span class="o">{</span><span class="s2">&quot;storeAdmin_api_key&quot;</span>:<span class="o">{</span><span class="s2">&quot;credentials&quot;</span>:<span class="o">{</span><span class="s2">&quot;customHeader&quot;</span>:<span class="o">{</span><span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;api_key&quot;</span><span class="o">}}</span>,<span class="s2">&quot;apiKey&quot;</span>:<span class="o">{</span><span class="s2">&quot;selector&quot;</span>:<span class="o">{</span><span class="s2">&quot;matchLabels&quot;</span>:<span class="o">{</span><span class="s2">&quot;kuadrant.io/apikeys-by&quot;</span>:<span class="s2">&quot;api_key&quot;</span><span class="o">}}}</span>,<span class="s2">&quot;routeSelectors&quot;</span>:<span class="o">[{</span><span class="s2">&quot;matches&quot;</span>:<span class="o">[{</span><span class="s2">&quot;path&quot;</span>:<span class="o">{</span><span class="s2">&quot;type&quot;</span>:<span class="s2">&quot;Exact&quot;</span>,<span class="s2">&quot;value&quot;</span>:<span class="s2">&quot;/api/v3/store/admin&quot;</span><span class="o">}</span>,<span class="s2">&quot;method&quot;</span>:<span class="s2">&quot;GET&quot;</span><span class="o">}]}]}}}}</span>,<span class="s2">&quot;status&quot;</span>:<span class="o">{}}</span>
-</span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="o">[</span>run-kuadrantctl<span class="o">]</span><span class="w"> </span><span class="o">{</span><span class="s2">&quot;kind&quot;</span>:<span class="s2">&quot;RateLimitPolicy&quot;</span>,<span class="s2">&quot;apiVersion&quot;</span>:<span class="s2">&quot;kuadrant.io/v1beta2&quot;</span>,<span class="s2">&quot;metadata&quot;</span>:<span class="o">{</span><span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;creationTimestamp&quot;</span>:null,<span class="s2">&quot;labels&quot;</span>:<span class="o">{</span><span class="s2">&quot;deployment&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;owner&quot;</span>:<span class="s2">&quot;jbloggs&quot;</span><span class="o">}}</span>,<span class="s2">&quot;spec&quot;</span>:<span class="o">{</span><span class="s2">&quot;targetRef&quot;</span>:<span class="o">{</span><span class="s2">&quot;group&quot;</span>:<span class="s2">&quot;gateway.networking.k8s.io&quot;</span>,<span class="s2">&quot;kind&quot;</span>:<span class="s2">&quot;HTTPRoute&quot;</span>,<span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;petstore&quot;</span><span class="o">}</span>,<span class="s2">&quot;limits&quot;</span>:<span class="o">{</span><span class="s2">&quot;getInventory&quot;</span>:<span class="o">{</span><span class="s2">&quot;routeSelectors&quot;</span>:<span class="o">[{</span><span class="s2">&quot;matches&quot;</span>:<span class="o">[{</span><span class="s2">&quot;path&quot;</span>:<span class="o">{</span><span class="s2">&quot;type&quot;</span>:<span class="s2">&quot;Exact&quot;</span>,<span class="s2">&quot;value&quot;</span>:<span class="s2">&quot;/api/v3/store/inventory&quot;</span><span class="o">}</span>,<span class="s2">&quot;method&quot;</span>:<span class="s2">&quot;GET&quot;</span><span class="o">}]}]</span>,<span class="s2">&quot;rates&quot;</span>:<span class="o">[{</span><span class="s2">&quot;limit&quot;</span>:10,<span class="s2">&quot;duration&quot;</span>:10,<span class="s2">&quot;unit&quot;</span>:<span class="s2">&quot;second&quot;</span><span class="o">}]}</span>,<span class="s2">&quot;loginUser&quot;</span>:<span class="o">{</span><span class="s2">&quot;routeSelectors&quot;</span>:<span class="o">[{</span><span class="s2">&quot;matches&quot;</span>:<span class="o">[{</span><span class="s2">&quot;path&quot;</span>:<span class="o">{</span><span class="s2">&quot;type&quot;</span>:<span class="s2">&quot;Exact&quot;</span>,<span class="s2">&quot;value&quot;</span>:<span class="s2">&quot;/api/v3/user/login&quot;</span><span class="o">}</span>,<span class="s2">&quot;method&quot;</span>:<span class="s2">&quot;GET&quot;</span><span class="o">}]}]</span>,<span class="s2">&quot;rates&quot;</span>:<span class="o">[{</span><span class="s2">&quot;limit&quot;</span>:2,<span class="s2">&quot;duration&quot;</span>:10,<span class="s2">&quot;unit&quot;</span>:<span class="s2">&quot;second&quot;</span><span class="o">}]}}}</span>,<span class="s2">&quot;status&quot;</span>:<span class="o">{}}</span>
-</span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="o">[</span>run-kuadrantctl<span class="o">]</span><span class="w"> </span><span class="o">{</span><span class="s2">&quot;kind&quot;</span>:<span class="s2">&quot;HTTPRoute&quot;</span>,<span class="s2">&quot;apiVersion&quot;</span>:<span class="s2">&quot;gateway.networking.k8s.io/v1beta1&quot;</span>,<span class="s2">&quot;metadata&quot;</span>:<span class="o">{</span><span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;creationTimestamp&quot;</span>:null,<span class="s2">&quot;labels&quot;</span>:<span class="o">{</span><span class="s2">&quot;deployment&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;owner&quot;</span>:<span class="s2">&quot;jbloggs&quot;</span><span class="o">}}</span>,<span class="s2">&quot;spec&quot;</span>:<span class="o">{</span><span class="s2">&quot;parentRefs&quot;</span>:<span class="o">[{</span><span class="s2">&quot;kind&quot;</span>:<span class="s2">&quot;Gateway&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;kuadrant-multi-cluster-gateways&quot;</span>,<span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;prod-web&quot;</span><span class="o">}]</span>,<span class="s2">&quot;hostnames&quot;</span>:<span class="o">[</span><span class="s2">&quot;petstore.</span><span class="si">${</span><span class="nv">KUADRANT_ZONE_ROOT_DOMAIN</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">]</span>,<span class="s2">&quot;rules&quot;</span>:<span class="o">[{</span><span class="s2">&quot;matches&quot;</span>:<span class="o">[{</span><span class="s2">&quot;path&quot;</span>:<span class="o">{</span><span class="s2">&quot;type&quot;</span>:<span class="s2">&quot;Exact&quot;</span>,<span class="s2">&quot;value&quot;</span>:<span class="s2">&quot;/api/v3/user/login&quot;</span><span class="o">}</span>,<span class="s2">&quot;method&quot;</span>:<span class="s2">&quot;GET&quot;</span><span class="o">}]</span>,<span class="s2">&quot;backendRefs&quot;</span>:<span class="o">[{</span><span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;port&quot;</span>:8080<span class="o">}]}</span>,<span class="o">{</span><span class="s2">&quot;matches&quot;</span>:<span class="o">[{</span><span class="s2">&quot;path&quot;</span>:<span class="o">{</span><span class="s2">&quot;type&quot;</span>:<span class="s2">&quot;Exact&quot;</span>,<span class="s2">&quot;value&quot;</span>:<span class="s2">&quot;/api/v3/store/admin&quot;</span><span class="o">}</span>,<span class="s2">&quot;method&quot;</span>:<span class="s2">&quot;GET&quot;</span><span class="o">}]</span>,<span class="s2">&quot;backendRefs&quot;</span>:<span class="o">[{</span><span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;port&quot;</span>:8080<span class="o">}]}</span>,<span class="o">{</span><span class="s2">&quot;matches&quot;</span>:<span class="o">[{</span><span class="s2">&quot;path&quot;</span>:<span class="o">{</span><span class="s2">&quot;type&quot;</span>:<span class="s2">&quot;Exact&quot;</span>,<span class="s2">&quot;value&quot;</span>:<span class="s2">&quot;/api/v3/store/inventory&quot;</span><span class="o">}</span>,<span class="s2">&quot;method&quot;</span>:<span class="s2">&quot;GET&quot;</span><span class="o">}]</span>,<span class="s2">&quot;backendRefs&quot;</span>:<span class="o">[{</span><span class="s2">&quot;name&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;namespace&quot;</span>:<span class="s2">&quot;petstore&quot;</span>,<span class="s2">&quot;port&quot;</span>:8080<span class="o">}]}]}</span>,<span class="s2">&quot;status&quot;</span>:<span class="o">{</span><span class="s2">&quot;parents&quot;</span>:null<span class="o">}}</span>
-</span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a>
-</span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="o">[</span>apply-resources<span class="o">]</span><span class="w"> </span>authpolicy.kuadrant.io/petstore<span class="w"> </span>created
-</span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="o">[</span>apply-resources<span class="o">]</span><span class="w"> </span>httproute.gateway.networking.k8s.io/petstore<span class="w"> </span>created
-</span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="o">[</span>apply-resources<span class="o">]</span><span class="w"> </span>ratelimitpolicy.kuadrant.io/petstore<span class="w"> </span>created
-</span></code></pre></div>
-<h3 id="step-6-cleanup">Step 6 - Cleanup<a class="headerlink" href="#step-6-cleanup" title="Permanent link">&para;</a></h3>
-<p>Clean up your resources as follows:</p>
-<ol>
-<li>Remove the <code>petstore</code> namespace:</li>
-<li><code>kubectl delete ns petstore</code></li>
-<li>Remove the <code>ClusterRole</code> and <code>ClusterRoleBinding</code>:</li>
-<li><code>kubectl delete clusterrole kuadrant-ci-example-full-access</code></li>
-<li><code>kubectl delete clusterrolebinding kuadrant-ci-example-full-access-binding</code></li>
-</ol>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/openapi-apicurio/index.html b/0.10.0/kuadrantctl/doc/openapi-apicurio/index.html
deleted file mode 100644
index 44251dec3..000000000
--- a/0.10.0/kuadrantctl/doc/openapi-apicurio/index.html
+++ /dev/null
@@ -1,3645 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/openapi-apicurio/">
-      
-      
-        <link rel="prev" href="../kuadrantctl-ci-cd/">
-      
-      
-        <link rel="next" href="../openapi-openshift-dev-spaces/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Using Apicurio Studio with Kuadrant OAS extensions - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#using-apicurio-studio-with-kuadrant-oas-extensions" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Using Apicurio Studio with Kuadrant OAS extensions
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-access-your-openapi-definition-in-apicurio-studio" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Access your OpenAPI definition in Apicurio Studio
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-add-kuadrant-extensions-to-your-api-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Add Kuadrant extensions to your API definition
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 2 - Add Kuadrant extensions to your API definition">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#generate-an-http-route" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate an HTTP route
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-an-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate an AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-a-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate a RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#additional-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional resources
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-access-your-openapi-definition-in-apicurio-studio" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Access your OpenAPI definition in Apicurio Studio
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-add-kuadrant-extensions-to-your-api-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Add Kuadrant extensions to your API definition
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 2 - Add Kuadrant extensions to your API definition">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#generate-an-http-route" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate an HTTP route
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-an-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate an AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-a-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate a RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#additional-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional resources
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/openapi-apicurio.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="using-apicurio-studio-with-kuadrant-oas-extensions">Using Apicurio Studio with Kuadrant OAS extensions<a class="headerlink" href="#using-apicurio-studio-with-kuadrant-oas-extensions" title="Permanent link">&para;</a></h1>
-<p>You can use <a href="https://swagger.io/docs/specification/openapi-extensions/">OpenAPI extensions</a> to define extra functionality beyond what is covered by the standard OpenAPI specification. Extensions typically start with the <code>x-</code> prefix, for example, <code>x-codegen</code>. Kuadrant OpenAPI extensions start with the <code>x-kuadrant</code> prefix, and allow you to configure Kuadrant policy information alongside your API.</p>
-<p><a href="https://www.apicur.io/studio">Apicurio Studio</a> is a UI tool for visualizing and editing OpenAPI designs and definitions, which can visualize security details and custom extensions specified in your OpenAPI definition.</p>
-<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li>You have Apicurio Studio installed and running. For more information, see the <a href="https://www.apicur.io/studio/docs">Apicurio Studio documentation</a>. </li>
-</ul>
-<h2 id="procedure">Procedure<a class="headerlink" href="#procedure" title="Permanent link">&para;</a></h2>
-<h3 id="step-1-access-your-openapi-definition-in-apicurio-studio">Step 1 - Access your OpenAPI definition in Apicurio Studio<a class="headerlink" href="#step-1-access-your-openapi-definition-in-apicurio-studio" title="Permanent link">&para;</a></h3>
-<p>Open or import your OpenAPI definition in Apicurio Studio. On the <strong>Design</strong> tab, select the <strong>VENDOR-EXTENSiONS</strong> section to add an extension. Alternatively, you can use the <strong>Source</strong> tab to edit the API definition directly.</p>
-<h3 id="step-2-add-kuadrant-extensions-to-your-api-definition">Step 2 - Add Kuadrant extensions to your API definition<a class="headerlink" href="#step-2-add-kuadrant-extensions-to-your-api-definition" title="Permanent link">&para;</a></h3>
-<p>The following configuration and extension points are supported by Apicurio Studio and the <code>kuadrantctl</code> CLI:</p>
-<h4 id="generate-an-http-route">Generate an HTTP route<a class="headerlink" href="#generate-an-http-route" title="Permanent link">&para;</a></h4>
-<p>To generate an <a href="https://gateway-api.sigs.k8s.io/api-types/httproute/">HTTPRoute</a> for the API, add the following <code>x-kuadrant</code> block to your API definition in Apicurio Studio, replacing values to match your API details and the location of your Gateway:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">    </span><span class="nt">route</span><span class="p">:</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">        </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;petstore.example.com&#39;</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">        </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w">   </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-web</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">                </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant-multi-cluster-gateways</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">                </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Gateway</span>
-</span></code></pre></div>
-<p>For more details, see <a href="../generate-gateway-api-httproute/">Generate Gateway API HTTPRoute object from OpenAPI 3</a>.</p>
-<h4 id="generate-an-authpolicy">Generate an AuthPolicy<a class="headerlink" href="#generate-an-authpolicy" title="Permanent link">&para;</a></h4>
-<p>To generate an <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/auth/">AuthPolicy</a>, add a <code>securityScheme</code> to the <code>components</code> block in your API definition. The following <code>securityScheme</code> requires that an API key header is set:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="w">    </span><span class="nt">securitySchemes</span><span class="p">:</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w">        </span><span class="nt">api_key</span><span class="p">:</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiKey</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">            </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">            </span><span class="nt">in</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">header</span>
-</span></code></pre></div>
-<p>Although <code>securityScheme</code> is not an OpenAPI extension, it is used by <code>kuadrantctl</code> like the other extensions mentioned in this document.</p>
-<p>When added, Apicurio Studio will display the following update in the <strong>SECURITY SCHEMES</strong> section:</p>
-<p><img alt="Apicurio security requirements" src="../images/apicurio-security-scheme-apikey.png" /></p>
-<p>For more details, see <a href="../generate-kuadrant-auth-policy/">Generate Kuadrant AuthPolicy object from OpenAPI 3</a>.</p>
-<h4 id="generate-a-ratelimitpolicy">Generate a RateLimitPolicy<a class="headerlink" href="#generate-a-ratelimitpolicy" title="Permanent link">&para;</a></h4>
-<p>To generate a <a href="https://docs.kuadrant.io/latest/kuadrant-operator/doc/rate-limiting/">RateLimitPolicy</a> for the API, add the following <code>x-kuadrant</code> block to a path in your API definition, replacing values to match your API details.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">paths</span><span class="p">:</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="w">    </span><span class="nt">/</span><span class="p">:</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="w">        </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">            </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">                </span><span class="p p-Indicator">-</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">                    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">                    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">                    </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">            </span><span class="nt">rate_limit</span><span class="p">:</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">                </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">                    </span><span class="p p-Indicator">-</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">                        </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">                        </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="w">                        </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span></code></pre></div>
-<p>When added, Apicurio Studio  will display the following update in the <strong>VENDOR-EXTENSiONS</strong> section for that specific path:</p>
-<p><img alt="Apicurio RateLimitPolicy Vendor Extension" src="../images/apicurio-vendor-extension-backend-rate-limit.png" /></p>
-<p>For more details, see <a href="../generate-kuadrant-rate-limit-policy/">Generate Kuadrant RateLimitPolicy object from OpenAPI 3</a>.</p>
-<h2 id="additional-resources">Additional resources<a class="headerlink" href="#additional-resources" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="../openapi-kuadrant-extensions/">OpenAPI 3.0.x Kuadrant Extensions in the kuadrantctl documentation</a>.</li>
-<li><a href="https://www.apicur.io/blog/2024/05/10/studio-vendor-extensions">Apicurio Studio - Now with OpenAPI Vendor Extensions</a>. </li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/openapi-kuadrant-extensions/index.html b/0.10.0/kuadrantctl/doc/openapi-kuadrant-extensions/index.html
deleted file mode 100644
index 398637e3c..000000000
--- a/0.10.0/kuadrantctl/doc/openapi-kuadrant-extensions/index.html
+++ /dev/null
@@ -1,3460 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/openapi-kuadrant-extensions/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>OpenAPI 3.0.x Kuadrant extensions - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#openapi-30x-kuadrant-extensions" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              OpenAPI 3.0.x Kuadrant extensions
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#root-level-kuadrant-extension" class="md-nav__link">
-    <span class="md-ellipsis">
-      Root-level Kuadrant extension
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#path-level-kuadrant-extension" class="md-nav__link">
-    <span class="md-ellipsis">
-      Path-level Kuadrant extension
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#operation-level-kuadrant-extension" class="md-nav__link">
-    <span class="md-ellipsis">
-      Operation-level Kuadrant extension
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/openapi-kuadrant-extensions.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="openapi-30x-kuadrant-extensions">OpenAPI 3.0.x Kuadrant extensions<a class="headerlink" href="#openapi-30x-kuadrant-extensions" title="Permanent link">&para;</a></h1>
-<p>This reference information shows examples of how to add Kuadrant extensions at the root, path, or operation level in an OpenAPI 3.0.x definition. </p>
-<h2 id="root-level-kuadrant-extension">Root-level Kuadrant extension<a class="headerlink" href="#root-level-kuadrant-extension" title="Permanent link">&para;</a></h2>
-<p>You can add a Kuadrant extension at the root level of an OpenAPI definition. The following example shows an extension added for a <code>petstore</code> app:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">  </span><span class="nt">route</span><span class="p">:</span><span class="w">  </span><span class="c1">## HTTPRoute metadata</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;petstore&quot;</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;petstore&quot;</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">    </span><span class="nt">labels</span><span class="p">:</span><span class="w">  </span><span class="c1">## map[string]string</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">      </span><span class="nt">deployment</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">    </span><span class="nt">hostnames</span><span class="p">:</span><span class="w">  </span><span class="c1">## []gateway.networking.k8s.io/v1beta1.Hostname</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.com</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">parentRefs</span><span class="p">:</span><span class="w">  </span><span class="c1">## []gateway.networking.k8s.io/v1beta1.ParentReference</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiGateway</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateways</span>
-</span></code></pre></div>
-<h2 id="path-level-kuadrant-extension">Path-level Kuadrant extension<a class="headerlink" href="#path-level-kuadrant-extension" title="Permanent link">&para;</a></h2>
-<p>You can add a Kuadrant extension at the path level of an OpenAPI definition.
-This configuration at the path level is the default when there is no operation-level configuration. 
-The following example shows an extension added for a <code>/cat</code> path:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">paths</span><span class="p">:</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w">  </span><span class="nt">/cat</span><span class="p">:</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w">    </span><span class="nt">x-kuadrant</span><span class="p">:</span><span class="w">  </span><span class="c1">## Path-level Kuadrant extension</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">      </span><span class="nt">disable</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span><span class="w">  </span><span class="c1">## Remove from the HTTPRoute. Optional. Default: false</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">      </span><span class="nt">pathMatchType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span><span class="w"> </span><span class="c1">## Specifies how to match against the path value. Valid values: [Exact;PathPrefix]. Optional. Default: Exact</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span><span class="w">  </span><span class="c1">## Backend references to be included in the HTTPRoute. []gateway.networking.k8s.io/v1beta1.HTTPBackendRef. Optional.</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">          </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">      </span><span class="nt">rate_limit</span><span class="p">:</span><span class="w">  </span><span class="c1">## Rate limit configuration. Optional.</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">        </span><span class="nt">rates</span><span class="p">:</span><span class="w">   </span><span class="c1">## Kuadrant API []github.com/kuadrant/kuadrant-operator/api/v1beta2.Rate</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w">            </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w">            </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w">        </span><span class="nt">counters</span><span class="p">:</span><span class="w">   </span><span class="c1">## Kuadrant API []github.com/kuadrant/kuadrant-operator/api/v1beta2.CountextSelector</span>
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a><span class="w">        </span><span class="nt">when</span><span class="p">:</span><span class="w">   </span><span class="c1">## Kuadrant API []github.com/kuadrant/kuadrant-operator/api/v1beta2.WhenCondition</span>
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">metadata.filter_metadata.envoy\.filters\.http\.ext_authz.identity.userid</span>
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a><span class="w">            </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">alice</span>
-</span></code></pre></div>
-<h2 id="operation-level-kuadrant-extension">Operation-level Kuadrant extension<a class="headerlink" href="#operation-level-kuadrant-extension" title="Permanent link">&para;</a></h2>
-<p>You can add a Kuadrant extension at the operation level of an OpenAPI definition. This extension uses the same schema as the path-level Kuadrant extension. The following example shows an extension added for a <code>get</code> operation:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">paths</span><span class="p">:</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="w">  </span><span class="nt">/cat</span><span class="p">:</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">      </span><span class="nt">x-kuadrant</span><span class="p">:</span><span class="w">  </span><span class="c1">## Operation-level Kuadrant extension</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">        </span><span class="nt">disable</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span><span class="w">  </span><span class="c1">## Remove from the HTTPRoute. Optional. Default: path level &quot;disable&quot; value.</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">        </span><span class="nt">pathMatchType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span><span class="w"> </span><span class="c1">## Specifies how to match against the path value. Valid values: [Exact;PathPrefix]. Optional. Default: Exact.</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">        </span><span class="nt">backendRefs</span><span class="p">:</span><span class="w">  </span><span class="c1">## Backend references to be included in the HTTPRoute. Optional.</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">            </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">80</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">            </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">        </span><span class="nt">rate_limit</span><span class="p">:</span><span class="w">  </span><span class="c1">## Rate limit configuration. Optional.</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">          </span><span class="nt">rates</span><span class="p">:</span><span class="w">   </span><span class="c1">## Kuadrant API github.com/kuadrant/kuadrant-operator/api/v1beta2.Rate</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="w">              </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="w">              </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a><span class="w">          </span><span class="nt">counters</span><span class="p">:</span><span class="w">   </span><span class="c1">## Kuadrant API github.com/kuadrant/kuadrant-operator/api/v1beta2.CountextSelector</span>
-</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">auth.identity.username</span>
-</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a><span class="w">          </span><span class="nt">when</span><span class="p">:</span><span class="w">   </span><span class="c1">## Kuadrant API github.com/kuadrant/kuadrant-operator/api/v1beta2.WhenCondition</span>
-</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">metadata.filter_metadata.envoy\.filters\.http\.ext_authz.identity.userid</span>
-</span><span id="__span-2-21"><a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a><span class="w">              </span><span class="nt">operator</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eq</span>
-</span><span id="__span-2-22"><a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a><span class="w">              </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">alice</span>
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/doc/openapi-openshift-dev-spaces/index.html b/0.10.0/kuadrantctl/doc/openapi-openshift-dev-spaces/index.html
deleted file mode 100644
index bca3556d5..000000000
--- a/0.10.0/kuadrantctl/doc/openapi-openshift-dev-spaces/index.html
+++ /dev/null
@@ -1,4085 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/openapi-openshift-dev-spaces/">
-      
-      
-        <link rel="prev" href="../openapi-apicurio/">
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Using OpenShift Dev Spaces with Kuadrant OAS extensions - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#integrating-kuadrant-oas-extensions-with-red-hat-openshift-dev-spaces" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Using OpenShift Dev Spaces with Kuadrant OAS extensions
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-setting-up-your-workspace" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Setting up your workspace
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-configuring-vs-code-in-dev-spaces" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Configuring VS Code in Dev Spaces
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 2 - Configuring VS Code in Dev Spaces">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-the-kuadrantctl-cli" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install the kuadrantctl CLI
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional-configuring-git" class="md-nav__link">
-    <span class="md-ellipsis">
-      Optional: Configuring Git
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-3-adding-kuadrant-policies-to-your-openapi-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Adding Kuadrant policies to your OpenAPI definition
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 3 - Adding Kuadrant policies to your OpenAPI definition">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-policies-overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant policies overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#defining-a-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Defining a Gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#specifying-httproutes-for-each-path" class="md-nav__link">
-    <span class="md-ellipsis">
-      Specifying HTTPRoutes for each path
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#implementing-authpolicy-and-security-schemes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Implementing AuthPolicy and security schemes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#applying-a-ratelimitpolicy-to-an-endpoint" class="md-nav__link">
-    <span class="md-ellipsis">
-      Applying a RateLimitPolicy to an endpoint
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-generate-kubernetes-resources-by-using-kuadrantctl" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Generate Kubernetes resources by using kuadrantctl
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 4 - Generate Kubernetes resources by using kuadrantctl">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#generate-an-httproute" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate an HTTPRoute
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-an-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate an AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-a-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate a RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-5-applying-resources-to-the-app" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Applying resources to the app
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#additional-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional resources
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#prerequisites" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prerequisites
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#procedure" class="md-nav__link">
-    <span class="md-ellipsis">
-      Procedure
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Procedure">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#step-1-setting-up-your-workspace" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 1 - Setting up your workspace
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-2-configuring-vs-code-in-dev-spaces" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 2 - Configuring VS Code in Dev Spaces
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 2 - Configuring VS Code in Dev Spaces">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#install-the-kuadrantctl-cli" class="md-nav__link">
-    <span class="md-ellipsis">
-      Install the kuadrantctl CLI
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional-configuring-git" class="md-nav__link">
-    <span class="md-ellipsis">
-      Optional: Configuring Git
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-3-adding-kuadrant-policies-to-your-openapi-definition" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 3 - Adding Kuadrant policies to your OpenAPI definition
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 3 - Adding Kuadrant policies to your OpenAPI definition">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#kuadrant-policies-overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kuadrant policies overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#defining-a-gateway" class="md-nav__link">
-    <span class="md-ellipsis">
-      Defining a Gateway
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#specifying-httproutes-for-each-path" class="md-nav__link">
-    <span class="md-ellipsis">
-      Specifying HTTPRoutes for each path
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#implementing-authpolicy-and-security-schemes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Implementing AuthPolicy and security schemes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#applying-a-ratelimitpolicy-to-an-endpoint" class="md-nav__link">
-    <span class="md-ellipsis">
-      Applying a RateLimitPolicy to an endpoint
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-4-generate-kubernetes-resources-by-using-kuadrantctl" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 4 - Generate Kubernetes resources by using kuadrantctl
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Step 4 - Generate Kubernetes resources by using kuadrantctl">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#generate-an-httproute" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate an HTTPRoute
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-an-authpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate an AuthPolicy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-a-ratelimitpolicy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generate a RateLimitPolicy
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#step-5-applying-resources-to-the-app" class="md-nav__link">
-    <span class="md-ellipsis">
-      Step 5 - Applying resources to the app
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#additional-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional resources
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/doc/openapi-openshift-dev-spaces.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="integrating-kuadrant-oas-extensions-with-red-hat-openshift-dev-spaces">Integrating Kuadrant OAS extensions with Red Hat OpenShift Dev Spaces<a class="headerlink" href="#integrating-kuadrant-oas-extensions-with-red-hat-openshift-dev-spaces" title="Permanent link">&para;</a></h1>
-<p><a href="https://swagger.io/docs/specification/openapi-extensions/">OpenAPI extensions</a> enhance the standard OpenAPI specification by adding custom functionality. Kuadrant OpenAPI extensions are identified by the <code>x-kuadrant</code> prefix. You can use OpenAPI extensions to integrate Kuadrant policies directly into your API definitions.</p>
-<p><a href="https://developers.redhat.com/developer-sandbox/ide">Red Hat OpenShift Dev Spaces</a> provides a browser-based, cloud-native IDE that supports rapid and decentralized development in container-based environments. This tutorial demonstrates how to use OpenShift Dev Spaces to modify an OpenAPI definition by incorporating Kuadrant policies, and then use the <code>kuadrantctl</code> CLI to create Kubernetes resources for both Gateway API and Kuadrant.</p>
-<h2 id="prerequisites">Prerequisites<a class="headerlink" href="#prerequisites" title="Permanent link">&para;</a></h2>
-<ul>
-<li>
-<p>You must have access to one of the following Dev Spaces instances:</p>
-</li>
-<li>
-<p>A self-hosted OpenShift Dev Spaces instance.</p>
-</li>
-<li>An OpenShift Dev Spaces instance provided by the <a href="https://developers.redhat.com/developer-sandbox/ide">Red Hat Developer Sandbox</a>.</li>
-</ul>
-<h2 id="procedure">Procedure<a class="headerlink" href="#procedure" title="Permanent link">&para;</a></h2>
-<h3 id="step-1-setting-up-your-workspace">Step 1 - Setting up your workspace<a class="headerlink" href="#step-1-setting-up-your-workspace" title="Permanent link">&para;</a></h3>
-<p>Create a workspace in Dev Spaces for your project as follows:</p>
-<ol>
-<li>Fork the following repository: <a href="https://github.com/Kuadrant/blank-petstore">https://github.com/Kuadrant/blank-petstore</a>.</li>
-<li>In Dev Spaces, select <strong>Create Workspace</strong>, and enter the URL of your forked repository. For example: <code>https://github.com/&lt;your-username&gt;/blank-petstore.git</code>.</li>
-<li>Click <strong>Create &amp; Open</strong>.</li>
-</ol>
-<h3 id="step-2-configuring-vs-code-in-dev-spaces">Step 2 - Configuring VS Code in Dev Spaces<a class="headerlink" href="#step-2-configuring-vs-code-in-dev-spaces" title="Permanent link">&para;</a></h3>
-<p>For this tutorial, you will perform the following tasks:</p>
-<ul>
-<li>Install <code>kuadrantctl</code> in your workspace to demonstrate Kubernetes resource generation from your modified OpenAPI definition.</li>
-<li>Optional: Configure Git with your username and email to enable pushing changes back to your repository.</li>
-</ul>
-<h4 id="install-the-kuadrantctl-cli">Install the kuadrantctl CLI<a class="headerlink" href="#install-the-kuadrantctl-cli" title="Permanent link">&para;</a></h4>
-<p>To install <code>kuadrantctl</code> in your Dev Spaces workspace, enter the following command:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>curl<span class="w"> </span>-sL<span class="w"> </span><span class="s2">&quot;https://github.com/kuadrant/kuadrantctl/releases/download/v0.2.3/kuadrantctl-v0.2.3-linux-amd64.tar.gz&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>tar<span class="w"> </span>xz<span class="w"> </span>-C<span class="w"> </span>/home/user/.local/bin
-</span></code></pre></div>
-<p>This command installs <code>kuadrantctl</code> in <code>/home/user/.local/bin</code>, which is included in the container's <code>$PATH</code> by default.</p>
-<h4 id="optional-configuring-git">Optional: Configuring Git<a class="headerlink" href="#optional-configuring-git" title="Permanent link">&para;</a></h4>
-<p>If you plan to push changes back to your repository, configure your Git username and email as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>git<span class="w"> </span>config<span class="w"> </span>--global<span class="w"> </span>user.email<span class="w"> </span><span class="s2">&quot;foo@example.com&quot;</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>git<span class="w"> </span>config<span class="w"> </span>--global<span class="w"> </span>user.name<span class="w"> </span><span class="s2">&quot;Foo Example&quot;</span>
-</span></code></pre></div>
-<h3 id="step-3-adding-kuadrant-policies-to-your-openapi-definition">Step 3 - Adding Kuadrant policies to your OpenAPI definition<a class="headerlink" href="#step-3-adding-kuadrant-policies-to-your-openapi-definition" title="Permanent link">&para;</a></h3>
-<p>After creating your workspace, Dev Spaces will launch VS Code loaded with your forked repository. Navigate to the <code>openapi.yaml</code> file in the sample app to begin modifications.</p>
-<h4 id="kuadrant-policies-overview">Kuadrant policies overview<a class="headerlink" href="#kuadrant-policies-overview" title="Permanent link">&para;</a></h4>
-<p>You will enhance your API definition by applying Kuadrant policies to the following endpoints:</p>
-<ul>
-<li><code>/pet/findByStatus</code></li>
-<li><code>/user/login</code></li>
-<li><code>/store/inventory</code></li>
-</ul>
-<p>In this tutorial, you will add Kuadrant policies to your API definition as follows:</p>
-<ul>
-<li>Generate an <code>HTTPRoute</code> to expose these three routes for an existing <code>Gateway</code>.</li>
-<li>Add API key authentication for the <code>/user/login</code> route, using a Kuadrant <code>AuthPolicy</code> and OAS <code>securitySchemes</code>.</li>
-<li>Add a Kuadrant <code>RateLimitPolicy</code> to the <code>/store/inventory</code> endpoint, to limit the amount of requests this endpoint can receive.</li>
-</ul>
-<h4 id="defining-a-gateway">Defining a Gateway<a class="headerlink" href="#defining-a-gateway" title="Permanent link">&para;</a></h4>
-<p>Use the <code>x-kuadrant</code> extension in the root level to specify a <code>Gateway</code>. This information will be used to generate <code>HTTPRoute</code>s at the path level. For example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="w">  </span><span class="nt">route</span><span class="p">:</span><span class="w">  </span><span class="c1">## HTTPRoute metadata</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;petstore&quot;</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;petstore&quot;</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">    </span><span class="nt">labels</span><span class="p">:</span><span class="w">  </span><span class="c1">## map[string]string</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">      </span><span class="nt">deployment</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">    </span><span class="nt">hostnames</span><span class="p">:</span><span class="w">  </span><span class="c1">## []gateway.networking.k8s.io/v1beta1.Hostname</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.com</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">    </span><span class="nt">parentRefs</span><span class="p">:</span><span class="w">  </span><span class="c1">## []gateway.networking.k8s.io/v1beta1.ParentReference</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiGateway</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateways</span>
-</span></code></pre></div>
-<h4 id="specifying-httproutes-for-each-path">Specifying HTTPRoutes for each path<a class="headerlink" href="#specifying-httproutes-for-each-path" title="Permanent link">&para;</a></h4>
-<p>For each path, add an <code>x-kuadrant</code> extension with <code>backendRefs</code> to link your routes to your paths as follows:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="w">  </span><span class="nt">/pet/findByStatus</span><span class="p">:</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w">    </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">        </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w">      </span><span class="c1"># ...</span>
-</span></code></pre></div>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="w">  </span><span class="nt">/user/login</span><span class="p">:</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="w">    </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="w">        </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="w">      </span><span class="c1"># ...</span>
-</span></code></pre></div>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="w">  </span><span class="nt">/store/inventory</span><span class="p">:</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="w">    </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w">        </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="w">        </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span>
-</span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="w">      </span><span class="c1"># ...</span>
-</span></code></pre></div>
-<p><strong>Note:</strong> The <code>x-kuadrant</code> extension at the path level applies to all HTTP methods defined in the path. For method-specific policies, move the extension inside the relevant HTTP method block, for example, <code>get</code> or <code>post</code>.</p>
-<h4 id="implementing-authpolicy-and-security-schemes">Implementing AuthPolicy and security schemes<a class="headerlink" href="#implementing-authpolicy-and-security-schemes" title="Permanent link">&para;</a></h4>
-<p>To secure the <code>/user/login</code> endpoint with API key authentication, use the following configuration:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="w">  </span><span class="nt">/user/login</span><span class="p">:</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="w">    </span><span class="c1"># ...</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">      </span><span class="nt">security</span><span class="p">:</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">api_key</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span></code></pre></div>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nt">components</span><span class="p">:</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="w">  </span><span class="nt">schemas</span><span class="p">:</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w">    </span><span class="c1"># ...</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w">  </span><span class="nt">securitySchemes</span><span class="p">:</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w">    </span><span class="nt">api_key</span><span class="p">:</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="w">      </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiKey</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
-</span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w">      </span><span class="nt">in</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">header</span>
-</span></code></pre></div>
-<p>This configuration generates an <code>AuthPolicy</code> that references an API key stored in a labeled <code>Secret</code>:</p>
-<p><div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore-api-key</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w">  </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w">    </span><span class="nt">authorino.kuadrant.io/managed-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">authorino</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">    </span><span class="nt">kuadrant.io/apikeys-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="nt">stringData</span><span class="p">:</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">  </span><span class="nt">api_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secret</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span>
-</span></code></pre></div>
-For simplicity, this example uses a simple, static API key for your app.</p>
-<h4 id="applying-a-ratelimitpolicy-to-an-endpoint">Applying a RateLimitPolicy to an endpoint<a class="headerlink" href="#applying-a-ratelimitpolicy-to-an-endpoint" title="Permanent link">&para;</a></h4>
-<p>To enforce rate limiting on the <code>/store/inventory</code> endpoint, add the following <code>x-kuadrant</code> extension:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="w">  </span><span class="nt">/store/inventory</span><span class="p">:</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w">    </span><span class="nt">get</span><span class="p">:</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w">      </span><span class="c1"># ...</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">      </span><span class="nt">x-kuadrant</span><span class="p">:</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w">        </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w">          </span><span class="c1"># ...</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w">        </span><span class="nt">rate_limit</span><span class="p">:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w">          </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="w">            </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="w">            </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span></code></pre></div>
-<p>This limits to 10 requests every 10 seconds for the <code>/store/inventory</code> endpoint.</p>
-<h3 id="step-4-generate-kubernetes-resources-by-using-kuadrantctl">Step 4 - Generate Kubernetes resources by using kuadrantctl<a class="headerlink" href="#step-4-generate-kubernetes-resources-by-using-kuadrantctl" title="Permanent link">&para;</a></h3>
-<p>With your extensions in place, you can use <code>kuadrantctl</code> to generate the follollowing Kubernetes resources:</p>
-<ul>
-<li>An <code>HTTPRoute</code> for your <code>petstore</code> app for each of your endpoints.</li>
-<li>An <code>AuthPolicy</code> with a simple, static API key from a secret for the <code>/user/login</code> endpoint.</li>
-<li>A <code>RateLimitPolicy</code> with a rate limit of 10 requests every 10 seconds for the <code>/store/inventory</code> endpoint.</li>
-</ul>
-<p>In Dev Spaces, select <strong>☰ &gt; Terminal &gt; New Terminal</strong>, and run the following commands:</p>
-<h5 id="generate-an-httproute">Generate an HTTPRoute<a class="headerlink" href="#generate-an-httproute" title="Permanent link">&para;</a></h5>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>gatewayapi<span class="w"> </span>httproute<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml
-</span></code></pre></div>
-<p>This command outputs the following <code>HTTPRoute</code>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io/v1beta1</span>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="w">  </span><span class="nt">creationTimestamp</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="w">  </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="w">    </span><span class="nt">deployment</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="w">  </span><span class="nt">parentRefs</span><span class="p">:</span>
-</span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a>
-</span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateways</span>
-</span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apiGateway</span>
-</span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="w">  </span><span class="nt">hostnames</span><span class="p">:</span>
-</span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.com</span>
-</span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-11-19"><a id="__codelineno-11-19" name="__codelineno-11-19" href="#__codelineno-11-19"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-11-20"><a id="__codelineno-11-20" name="__codelineno-11-20" href="#__codelineno-11-20"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/api/v3/pet/findByStatus</span>
-</span><span id="__span-11-21"><a id="__codelineno-11-21" name="__codelineno-11-21" href="#__codelineno-11-21"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-11-22"><a id="__codelineno-11-22" name="__codelineno-11-22" href="#__codelineno-11-22"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-23"><a id="__codelineno-11-23" name="__codelineno-11-23" href="#__codelineno-11-23"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-24"><a id="__codelineno-11-24" name="__codelineno-11-24" href="#__codelineno-11-24"></a><span class="w">          </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-25"><a id="__codelineno-11-25" name="__codelineno-11-25" href="#__codelineno-11-25"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-11-26"><a id="__codelineno-11-26" name="__codelineno-11-26" href="#__codelineno-11-26"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-11-27"><a id="__codelineno-11-27" name="__codelineno-11-27" href="#__codelineno-11-27"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-11-28"><a id="__codelineno-11-28" name="__codelineno-11-28" href="#__codelineno-11-28"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-11-29"><a id="__codelineno-11-29" name="__codelineno-11-29" href="#__codelineno-11-29"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/api/v3/store/inventory</span>
-</span><span id="__span-11-30"><a id="__codelineno-11-30" name="__codelineno-11-30" href="#__codelineno-11-30"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-11-31"><a id="__codelineno-11-31" name="__codelineno-11-31" href="#__codelineno-11-31"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-32"><a id="__codelineno-11-32" name="__codelineno-11-32" href="#__codelineno-11-32"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-33"><a id="__codelineno-11-33" name="__codelineno-11-33" href="#__codelineno-11-33"></a><span class="w">          </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-34"><a id="__codelineno-11-34" name="__codelineno-11-34" href="#__codelineno-11-34"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-11-35"><a id="__codelineno-11-35" name="__codelineno-11-35" href="#__codelineno-11-35"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-11-36"><a id="__codelineno-11-36" name="__codelineno-11-36" href="#__codelineno-11-36"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-11-37"><a id="__codelineno-11-37" name="__codelineno-11-37" href="#__codelineno-11-37"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-11-38"><a id="__codelineno-11-38" name="__codelineno-11-38" href="#__codelineno-11-38"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/api/v3/user/login</span>
-</span><span id="__span-11-39"><a id="__codelineno-11-39" name="__codelineno-11-39" href="#__codelineno-11-39"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-11-40"><a id="__codelineno-11-40" name="__codelineno-11-40" href="#__codelineno-11-40"></a><span class="w">      </span><span class="nt">backendRefs</span><span class="p">:</span>
-</span><span id="__span-11-41"><a id="__codelineno-11-41" name="__codelineno-11-41" href="#__codelineno-11-41"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-42"><a id="__codelineno-11-42" name="__codelineno-11-42" href="#__codelineno-11-42"></a><span class="w">          </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-11-43"><a id="__codelineno-11-43" name="__codelineno-11-43" href="#__codelineno-11-43"></a><span class="w">          </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-11-44"><a id="__codelineno-11-44" name="__codelineno-11-44" href="#__codelineno-11-44"></a><span class="nt">status</span><span class="p">:</span>
-</span><span id="__span-11-45"><a id="__codelineno-11-45" name="__codelineno-11-45" href="#__codelineno-11-45"></a><span class="w">  </span><span class="nt">parents</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
-</span></code></pre></div>
-<h5 id="generate-an-authpolicy">Generate an AuthPolicy<a class="headerlink" href="#generate-an-authpolicy" title="Permanent link">&para;</a></h5>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml
-</span></code></pre></div>
-<p>This command outputs the following <code>AuthPolicy</code>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">AuthPolicy</span>
-</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="w">  </span><span class="nt">creationTimestamp</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
-</span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="w">  </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="w">    </span><span class="nt">deployment</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-13-14"><a id="__codelineno-13-14" name="__codelineno-13-14" href="#__codelineno-13-14"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-13-15"><a id="__codelineno-13-15" name="__codelineno-13-15" href="#__codelineno-13-15"></a><span class="w">  </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-13-16"><a id="__codelineno-13-16" name="__codelineno-13-16" href="#__codelineno-13-16"></a>
-</span><span id="__span-13-17"><a id="__codelineno-13-17" name="__codelineno-13-17" href="#__codelineno-13-17"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-13-18"><a id="__codelineno-13-18" name="__codelineno-13-18" href="#__codelineno-13-18"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-13-19"><a id="__codelineno-13-19" name="__codelineno-13-19" href="#__codelineno-13-19"></a><span class="w">            </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-13-20"><a id="__codelineno-13-20" name="__codelineno-13-20" href="#__codelineno-13-20"></a><span class="w">            </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/api/v3/user/login</span>
-</span><span id="__span-13-21"><a id="__codelineno-13-21" name="__codelineno-13-21" href="#__codelineno-13-21"></a><span class="w">          </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-13-22"><a id="__codelineno-13-22" name="__codelineno-13-22" href="#__codelineno-13-22"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
-</span><span id="__span-13-23"><a id="__codelineno-13-23" name="__codelineno-13-23" href="#__codelineno-13-23"></a><span class="w">    </span><span class="nt">authentication</span><span class="p">:</span>
-</span><span id="__span-13-24"><a id="__codelineno-13-24" name="__codelineno-13-24" href="#__codelineno-13-24"></a><span class="w">      </span><span class="nt">GETuserlogin_api_key</span><span class="p">:</span>
-</span><span id="__span-13-25"><a id="__codelineno-13-25" name="__codelineno-13-25" href="#__codelineno-13-25"></a><span class="w">        </span><span class="nt">credentials</span><span class="p">:</span>
-</span><span id="__span-13-26"><a id="__codelineno-13-26" name="__codelineno-13-26" href="#__codelineno-13-26"></a><span class="w">          </span><span class="nt">customHeader</span><span class="p">:</span>
-</span><span id="__span-13-27"><a id="__codelineno-13-27" name="__codelineno-13-27" href="#__codelineno-13-27"></a><span class="w">            </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
-</span><span id="__span-13-28"><a id="__codelineno-13-28" name="__codelineno-13-28" href="#__codelineno-13-28"></a><span class="w">        </span><span class="nt">apiKey</span><span class="p">:</span>
-</span><span id="__span-13-29"><a id="__codelineno-13-29" name="__codelineno-13-29" href="#__codelineno-13-29"></a><span class="w">          </span><span class="nt">selector</span><span class="p">:</span>
-</span><span id="__span-13-30"><a id="__codelineno-13-30" name="__codelineno-13-30" href="#__codelineno-13-30"></a><span class="w">            </span><span class="nt">matchLabels</span><span class="p">:</span>
-</span><span id="__span-13-31"><a id="__codelineno-13-31" name="__codelineno-13-31" href="#__codelineno-13-31"></a><span class="w">              </span><span class="nt">kuadrant.io/apikeys-by</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
-</span><span id="__span-13-32"><a id="__codelineno-13-32" name="__codelineno-13-32" href="#__codelineno-13-32"></a><span class="w">        </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-13-33"><a id="__codelineno-13-33" name="__codelineno-13-33" href="#__codelineno-13-33"></a><span class="w">          </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-13-34"><a id="__codelineno-13-34" name="__codelineno-13-34" href="#__codelineno-13-34"></a><span class="w">              </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-13-35"><a id="__codelineno-13-35" name="__codelineno-13-35" href="#__codelineno-13-35"></a><span class="w">                  </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-13-36"><a id="__codelineno-13-36" name="__codelineno-13-36" href="#__codelineno-13-36"></a><span class="w">                  </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/api/v3/user/login</span>
-</span><span id="__span-13-37"><a id="__codelineno-13-37" name="__codelineno-13-37" href="#__codelineno-13-37"></a><span class="w">                </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-13-38"><a id="__codelineno-13-38" name="__codelineno-13-38" href="#__codelineno-13-38"></a><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span></code></pre></div>
-<h5 id="generate-a-ratelimitpolicy">Generate a RateLimitPolicy<a class="headerlink" href="#generate-a-ratelimitpolicy" title="Permanent link">&para;</a></h5>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>ratelimitpolicy<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml
-</span></code></pre></div>
-<p>This command outputs the following <code>RateLimitPolicy</code>:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kuadrant.io/v1beta2</span>
-</span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RateLimitPolicy</span>
-</span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="w">  </span><span class="nt">creationTimestamp</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
-</span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="w">  </span><span class="nt">labels</span><span class="p">:</span>
-</span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="w">    </span><span class="nt">deployment</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="w">  </span><span class="nt">targetRef</span><span class="p">:</span>
-</span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="w">    </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gateway.networking.k8s.io</span>
-</span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HTTPRoute</span>
-</span><span id="__span-15-13"><a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-15-14"><a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a><span class="w">    </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">petstore</span>
-</span><span id="__span-15-15"><a id="__codelineno-15-15" name="__codelineno-15-15" href="#__codelineno-15-15"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-15-16"><a id="__codelineno-15-16" name="__codelineno-15-16" href="#__codelineno-15-16"></a><span class="w">    </span><span class="nt">GETstoreinventory</span><span class="p">:</span>
-</span><span id="__span-15-17"><a id="__codelineno-15-17" name="__codelineno-15-17" href="#__codelineno-15-17"></a><span class="w">      </span><span class="nt">routeSelectors</span><span class="p">:</span>
-</span><span id="__span-15-18"><a id="__codelineno-15-18" name="__codelineno-15-18" href="#__codelineno-15-18"></a>
-</span><span id="__span-15-19"><a id="__codelineno-15-19" name="__codelineno-15-19" href="#__codelineno-15-19"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">matches</span><span class="p">:</span>
-</span><span id="__span-15-20"><a id="__codelineno-15-20" name="__codelineno-15-20" href="#__codelineno-15-20"></a><span class="w">            </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">path</span><span class="p">:</span>
-</span><span id="__span-15-21"><a id="__codelineno-15-21" name="__codelineno-15-21" href="#__codelineno-15-21"></a><span class="w">                </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Exact</span>
-</span><span id="__span-15-22"><a id="__codelineno-15-22" name="__codelineno-15-22" href="#__codelineno-15-22"></a><span class="w">                </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/api/v3/store/inventory</span>
-</span><span id="__span-15-23"><a id="__codelineno-15-23" name="__codelineno-15-23" href="#__codelineno-15-23"></a><span class="w">              </span><span class="nt">method</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GET</span>
-</span><span id="__span-15-24"><a id="__codelineno-15-24" name="__codelineno-15-24" href="#__codelineno-15-24"></a><span class="w">      </span><span class="nt">rates</span><span class="p">:</span>
-</span><span id="__span-15-25"><a id="__codelineno-15-25" name="__codelineno-15-25" href="#__codelineno-15-25"></a><span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">limit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-15-26"><a id="__codelineno-15-26" name="__codelineno-15-26" href="#__codelineno-15-26"></a><span class="w">          </span><span class="nt">duration</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-15-27"><a id="__codelineno-15-27" name="__codelineno-15-27" href="#__codelineno-15-27"></a><span class="w">          </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">second</span>
-</span><span id="__span-15-28"><a id="__codelineno-15-28" name="__codelineno-15-28" href="#__codelineno-15-28"></a><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span></code></pre></div>
-<h3 id="step-5-applying-resources-to-the-app">Step 5 - Applying resources to the app<a class="headerlink" href="#step-5-applying-resources-to-the-app" title="Permanent link">&para;</a></h3>
-<blockquote>
-<p><strong>Note:</strong> By default, the <code>oc</code> and <code>kubectl</code> commands in Dev Spaces target the cluster running Dev Spaces. If you want to apply resources to another cluster, you must log in with <code>oc</code> or <code>kubectl</code> to another cluster, and pass a different <code>--context</code> to these commands to apply resources to another cluster.</p>
-</blockquote>
-<p>You can now apply these policies to a running app by using <code>kubectl</code> or <code>oc</code>. If Dev Spaces is running on a cluster where Kuadrant is also installed, you can apply these resources as follows:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>gatewayapi<span class="w"> </span>httproute<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>authpolicy<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a>kuadrantctl<span class="w"> </span>generate<span class="w"> </span>kuadrant<span class="w"> </span>ratelimitpolicy<span class="w"> </span>--oas<span class="w"> </span>openapi.yaml<span class="w"> </span><span class="p">|</span><span class="w"> </span>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>-
-</span></code></pre></div>
-<p>Alternatively, you can use <code>kuadrantctl</code> as part of a CI/CD pipeline. For more details, see the <a href="../kuadrantctl-ci-cd/">kuadrantctl CI/CD guide</a>.</p>
-<p>If you completed the optional Git configuration step, you can enter <code>git commit</code> to commit the these changes and push them to your fork.</p>
-<h2 id="additional-resources">Additional resources<a class="headerlink" href="#additional-resources" title="Permanent link">&para;</a></h2>
-<p>For more details, see the following documentation on using <code>x-kuadrant</code> OAS extensions with <code>kuadrantctl</code>:</p>
-<ul>
-<li><a href="../openapi-kuadrant-extensions/">OpenAPI 3.0.x Kuadrant extensions</a></li>
-<li><a href="../generate-gateway-api-httproute/">Generate Gateway API HTTPRoutes with <code>kuadrantctl</code></a></li>
-<li><a href="../generate-kuadrant-auth-policy/">Generate Kuadrant AuthPolicy with <code>kuadrantctl</code></a></li>
-<li><a href="../generate-kuadrant-rate-limit-policy/">Generate Kuadrant RateLimitPolicy with <code>kuadrantctl</code></a></li>
-<li><a href="../kuadrantctl-ci-cd/">kuadrantctl CI/CD guide</a></li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/kuadrantctl/index.html b/0.10.0/kuadrantctl/index.html
deleted file mode 100644
index 935210779..000000000
--- a/0.10.0/kuadrantctl/index.html
+++ /dev/null
@@ -1,4049 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/kuadrantctl/">
-      
-      
-        <link rel="prev" href="../limitador-operator/doc/logging/">
-      
-      
-        <link rel="next" href="doc/generate-gateway-api-httproute/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Getting Started - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kuadrantctl" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Getting Started
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#installing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Installing">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#installing-pre-compiled-binaries" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing Pre-compiled Binaries
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#compiling-from-source" class="md-nav__link">
-    <span class="md-ellipsis">
-      Compiling from Source
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#usage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Usage
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Usage">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#general-syntax" class="md-nav__link">
-    <span class="md-ellipsis">
-      General Syntax
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#commands-overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Commands Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#flags" class="md-nav__link">
-    <span class="md-ellipsis">
-      Flags
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#commands-detail" class="md-nav__link">
-    <span class="md-ellipsis">
-      Commands Detail
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Commands Detail">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#completion" class="md-nav__link">
-    <span class="md-ellipsis">
-      completion
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="generate">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#generate-gatewayapi" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate gatewayapi
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#version" class="md-nav__link">
-    <span class="md-ellipsis">
-      version
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#additional-guides" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional Guides
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Additional Guides">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#generating-gateway-api-httproute-objects" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generating Gateway API HTTPRoute Objects
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generating-kuadrant-authpolicy-objects" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generating Kuadrant AuthPolicy Objects
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generating-kuadrant-ratelimitpolicy-objects" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generating Kuadrant RateLimitPolicy Objects
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-with-github-actions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using with GitHub Actions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#commands" class="md-nav__link">
-    <span class="md-ellipsis">
-      Commands
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#licensing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Licensing
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#installing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Installing">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#installing-pre-compiled-binaries" class="md-nav__link">
-    <span class="md-ellipsis">
-      Installing Pre-compiled Binaries
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#compiling-from-source" class="md-nav__link">
-    <span class="md-ellipsis">
-      Compiling from Source
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#usage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Usage
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Usage">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#general-syntax" class="md-nav__link">
-    <span class="md-ellipsis">
-      General Syntax
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#commands-overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Commands Overview
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#flags" class="md-nav__link">
-    <span class="md-ellipsis">
-      Flags
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#commands-detail" class="md-nav__link">
-    <span class="md-ellipsis">
-      Commands Detail
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Commands Detail">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#completion" class="md-nav__link">
-    <span class="md-ellipsis">
-      completion
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="generate">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#generate-gatewayapi" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate gatewayapi
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generate-kuadrant" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate kuadrant
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#version" class="md-nav__link">
-    <span class="md-ellipsis">
-      version
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#additional-guides" class="md-nav__link">
-    <span class="md-ellipsis">
-      Additional Guides
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Additional Guides">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#generating-gateway-api-httproute-objects" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generating Gateway API HTTPRoute Objects
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generating-kuadrant-authpolicy-objects" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generating Kuadrant AuthPolicy Objects
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#generating-kuadrant-ratelimitpolicy-objects" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generating Kuadrant RateLimitPolicy Objects
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#using-with-github-actions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Using with GitHub Actions
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#commands" class="md-nav__link">
-    <span class="md-ellipsis">
-      Commands
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#licensing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Licensing
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/kuadrantctl/blob/main/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kuadrantctl">kuadrantctl<a class="headerlink" href="#kuadrantctl" title="Permanent link">&para;</a></h1>
-<p><a href="http://www.apache.org/licenses/LICENSE-2.0"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" /></a></p>
-<p><code>kuadrantctl</code> is a CLI tool for managing <a href="https://kuadrant.io/">Kuadrant</a> configurations and resources.</p>
-<h2 id="installing">Installing<a class="headerlink" href="#installing" title="Permanent link">&para;</a></h2>
-<p><code>kuadrantctl</code> can be installed either by downloading pre-compiled binaries or by compiling from source. For most users, downloading the binary is the easiest and recommended method.</p>
-<h3 id="installing-pre-compiled-binaries">Installing Pre-compiled Binaries<a class="headerlink" href="#installing-pre-compiled-binaries" title="Permanent link">&para;</a></h3>
-<ol>
-<li>Download the latest binary for your platform from the <a href="https://github.com/Kuadrant/kuadrantctl/releases"><code>kuadrantctl</code> Releases</a> page.</li>
-<li>Unpack the binary.</li>
-<li>Move it to a directory in your <code>$PATH</code> so that it can be executed from anywhere.</li>
-</ol>
-<h3 id="compiling-from-source">Compiling from Source<a class="headerlink" href="#compiling-from-source" title="Permanent link">&para;</a></h3>
-<p>If you prefer to compile from source or are contributing to the project, you can install <code>kuadrantctl</code> using  <code>make install</code>. This method requires Golang 1.21 or newer.</p>
-<p>It is possible to use the make target <code>install</code> to compile from source. From root of the repository, run </p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>make<span class="w"> </span>install
-</span></code></pre></div>
-<p>This will compile <code>kuadrantctl</code> and install it in the <code>bin</code> directory at root of directory. It will also ensure the correct version of the binary is displayed . It can be ran using <code>./bin/kuadrantctl</code> .  </p>
-<h2 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">&para;</a></h2>
-<p>Below is a high-level overview of its commands, along with links to detailed documentation for more complex commands.</p>
-<h3 id="general-syntax">General Syntax<a class="headerlink" href="#general-syntax" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kuadrantctl<span class="w"> </span><span class="o">[</span>command<span class="o">]</span><span class="w"> </span><span class="o">[</span>subcommand<span class="o">]</span><span class="w"> </span><span class="o">[</span>flags<span class="o">]</span>
-</span></code></pre></div>
-<h3 id="commands-overview">Commands Overview<a class="headerlink" href="#commands-overview" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>Command</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>completion</code></td>
-<td>Generate autocompletion scripts for the specified shell</td>
-</tr>
-<tr>
-<td><code>generate</code></td>
-<td>Commands related to Kubernetes Gateway API and Kuadrant resource generation from OpenAPI 3.x specifications</td>
-</tr>
-<tr>
-<td><code>help</code></td>
-<td>Help about any command</td>
-</tr>
-<tr>
-<td><code>version</code></td>
-<td>Print the version number of <code>kuadrantctl</code></td>
-</tr>
-</tbody>
-</table>
-<h3 id="flags">Flags<a class="headerlink" href="#flags" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>Flag</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>-h</code>, <code>--help</code></td>
-<td>Help for <code>kuadrantctl</code></td>
-</tr>
-<tr>
-<td><code>-v</code>, <code>--verbose</code></td>
-<td>Enable verbose output</td>
-</tr>
-</tbody>
-</table>
-<h3 id="commands-detail">Commands Detail<a class="headerlink" href="#commands-detail" title="Permanent link">&para;</a></h3>
-<h4 id="completion"><code>completion</code><a class="headerlink" href="#completion" title="Permanent link">&para;</a></h4>
-<p>Generate an autocompletion script for the specified shell.</p>
-<table>
-<thead>
-<tr>
-<th>Subcommand</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>bash</code></td>
-<td>Generate script for Bash</td>
-</tr>
-<tr>
-<td><code>fish</code></td>
-<td>Generate script for Fish</td>
-</tr>
-<tr>
-<td><code>powershell</code></td>
-<td>Generate script for PowerShell</td>
-</tr>
-<tr>
-<td><code>zsh</code></td>
-<td>Generate script for Zsh</td>
-</tr>
-</tbody>
-</table>
-<h4 id="generate"><code>generate</code><a class="headerlink" href="#generate" title="Permanent link">&para;</a></h4>
-<p>Commands related to Kubernetes Gateway API and Kuadrant resource generation from OpenAPI 3.x specifications.</p>
-<table>
-<thead>
-<tr>
-<th>Subcommand</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>gatewayapi</code></td>
-<td>Generate Gateway API resources</td>
-</tr>
-<tr>
-<td><code>kuadrant</code></td>
-<td>Generate Kuadrant resources</td>
-</tr>
-</tbody>
-</table>
-<h5 id="generate-gatewayapi"><code>generate gatewayapi</code><a class="headerlink" href="#generate-gatewayapi" title="Permanent link">&para;</a></h5>
-<p>Generate Gateway API resources from an OpenAPI 3.x specification</p>
-<table>
-<thead>
-<tr>
-<th>Subcommand</th>
-<th>Description</th>
-<th>Flags</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>httproute</code></td>
-<td>Generate Gateway API HTTPRoute from OpenAPI 3.0.X</td>
-<td><code>--oas string</code> Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required). <code>-o</code> Output format: 'yaml' or 'json'. (default "yaml")</td>
-</tr>
-</tbody>
-</table>
-<h5 id="generate-kuadrant"><code>generate kuadrant</code><a class="headerlink" href="#generate-kuadrant" title="Permanent link">&para;</a></h5>
-<p>Generate Kuadrant resources from an OpenAPI 3.x specification</p>
-<table>
-<thead>
-<tr>
-<th>Subcommand</th>
-<th>Description</th>
-<th>Flags</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>authpolicy</code></td>
-<td>Generate a <a href="https://docs.kuadrant.io/kuadrant-operator/doc/auth/">Kuadrant AuthPolicy</a> from an OpenAPI 3.0.x specification</td>
-<td><code>--oas string</code> Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required). <code>-o</code> Output format: 'yaml' or 'json'. (default "yaml")</td>
-</tr>
-<tr>
-<td><code>ratelimitpolicy</code></td>
-<td>Generate <a href="https://docs.kuadrant.io/kuadrant-operator/doc/rate-limiting/">Kuadrant RateLimitPolicy</a> from an OpenAPI 3.0.x specification</td>
-<td><code>--oas string</code> Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required). <code>-o</code> Output format: 'yaml' or 'json'. (default "yaml")</td>
-</tr>
-</tbody>
-</table>
-<h4 id="version"><code>version</code><a class="headerlink" href="#version" title="Permanent link">&para;</a></h4>
-<p>Print the version number of <code>kuadrantctl</code>.</p>
-<p>No additional flags or subcommands.</p>
-<h3 id="additional-guides">Additional Guides<a class="headerlink" href="#additional-guides" title="Permanent link">&para;</a></h3>
-<h4 id="generating-gateway-api-httproute-objects">Generating Gateway API HTTPRoute Objects<a class="headerlink" href="#generating-gateway-api-httproute-objects" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Generates <a href="https://gateway-api.sigs.k8s.io/v1alpha2/guides/http-routing/">Gateway API HTTPRoute</a> objects from an OpenAPI Specification (OAS) 3.x.</li>
-<li>Supports reading from a file, URL, or stdin.</li>
-<li>Example usages and more information can be found in the <a href="doc/generate-gateway-api-httproute/">detailed guide</a>.</li>
-</ul>
-<h4 id="generating-kuadrant-authpolicy-objects">Generating Kuadrant AuthPolicy Objects<a class="headerlink" href="#generating-kuadrant-authpolicy-objects" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Generates <a href="https://github.com/Kuadrant/kuadrant-operator/blob/v0.4.1/doc/auth.md">Kuadrant AuthPolicy</a> objects for managing API authentication.</li>
-<li>Supports <code>openIdConnect</code> and <code>apiKey</code> types from the OpenAPI Security Scheme Object.</li>
-<li>Example usages and more information can be found in the <a href="doc/generate-kuadrant-auth-policy/">detailed guide</a>.</li>
-</ul>
-<h4 id="generating-kuadrant-ratelimitpolicy-objects">Generating Kuadrant RateLimitPolicy Objects<a class="headerlink" href="#generating-kuadrant-ratelimitpolicy-objects" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Generates <a href="https://github.com/Kuadrant/kuadrant-operator/blob/v0.4.1/doc/rate-limiting.md">Kuadrant RateLimitPolicy</a> objects for managing API rate limiting.</li>
-<li>Supports reading from a file, URL, or stdin.</li>
-<li>Example usages and more information can be found in the <a href="doc/generate-kuadrant-rate-limit-policy/">detailed guide</a>.</li>
-</ul>
-<p>For more detailed information about each command, including options and usage examples, use <code>kuadrantctl [command] --help</code>.</p>
-<h2 id="using-with-github-actions">Using with GitHub Actions<a class="headerlink" href="#using-with-github-actions" title="Permanent link">&para;</a></h2>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Install kuadrantctl</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="w">  </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">jaxxstorm/action-install-gh-release@v1.10.0</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="w">  </span><span class="nt">with</span><span class="p">:</span><span class="w"> </span><span class="c1"># Grab the latest version</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">    </span><span class="nt">repo</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Kuadrant/kuadrantctl</span>
-</span></code></pre></div>
-<h2 id="commands">Commands<a class="headerlink" href="#commands" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="doc/generate-gateway-api-httproute/">Generate Gateway API HTTPRoute objects from OpenAPI 3.X</a></li>
-<li><a href="doc/generate-kuadrant-rate-limit-policy/">Generate Kuadrant RateLimitPolicy from OpenAPI 3.X</a></li>
-<li><a href="doc/generate-kuadrant-auth-policy/">Generate Kuadrant AuthPolicy from OpenAPI 3.X</a></li>
-</ul>
-<h2 id="contributing">Contributing<a class="headerlink" href="#contributing" title="Permanent link">&para;</a></h2>
-<p>The <a href="doc/development/">Development guide</a> describes how to build the kuadrantctl CLI and how to test your changes before submitting a patch or opening a PR.</p>
-<h2 id="licensing">Licensing<a class="headerlink" href="#licensing" title="Permanent link">&para;</a></h2>
-<p>This software is licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 license</a>.</p>
-<p>See the LICENSE and NOTICE files that should have been provided along with this software for details.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador-operator/doc/development/index.html b/0.10.0/limitador-operator/doc/development/index.html
deleted file mode 100644
index 9386862e1..000000000
--- a/0.10.0/limitador-operator/doc/development/index.html
+++ /dev/null
@@ -1,3945 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador-operator/doc/development/">
-      
-      
-        <link rel="prev" href="../rate-limit-headers/">
-      
-      
-        <link rel="next" href="../logging/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Developer's Guide - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#development-guide" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Developer's Guide
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#technology-stack-required-for-development" class="md-nav__link">
-    <span class="md-ellipsis">
-      Technology stack required for development
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-locally" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run locally
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-operator-in-a-deployment-object" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy the operator in a deployment object
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-operator-using-olm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy the operator using OLM
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build-custom-olm-catalog" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build custom OLM catalog
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Build custom OLM catalog">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#build-operator-bundle-image" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build operator bundle image
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#build-custom-catalog" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build custom catalog
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleaning-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleaning up
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run tests
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run tests">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#unittests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Unittests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#integration-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Integration tests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#all-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      All tests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#lint-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Lint tests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#uninstall-limitador-crd" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Un)Install Limitador CRD
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#technology-stack-required-for-development" class="md-nav__link">
-    <span class="md-ellipsis">
-      Technology stack required for development
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-locally" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run locally
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-operator-in-a-deployment-object" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy the operator in a deployment object
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#deploy-the-operator-using-olm" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deploy the operator using OLM
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#build-custom-olm-catalog" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build custom OLM catalog
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Build custom OLM catalog">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#build-operator-bundle-image" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build operator bundle image
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#build-custom-catalog" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build custom catalog
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#cleaning-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Cleaning up
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run tests
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Run tests">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#unittests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Unittests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#integration-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Integration tests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#all-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      All tests
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#lint-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Lint tests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#uninstall-limitador-crd" class="md-nav__link">
-    <span class="md-ellipsis">
-      (Un)Install Limitador CRD
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador-operator/blob/main/doc/development.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="development-guide">Development Guide<a class="headerlink" href="#development-guide" title="Permanent link">&para;</a></h1>
-<h2 id="technology-stack-required-for-development">Technology stack required for development<a class="headerlink" href="#technology-stack-required-for-development" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="https://github.com/operator-framework/operator-sdk">operator-sdk</a> version 1.32.0</li>
-<li><a href="https://kind.sigs.k8s.io/">kind</a> version v0.22.0</li>
-<li><a href="https://git-scm.com/downloads">git</a></li>
-<li><a href="https://golang.org/">go</a> version 1.21+</li>
-<li><a href="https://kubernetes.io/">kubernetes</a> version v1.25+</li>
-<li><a href="https://kubernetes.io/docs/tasks/tools/#kubectl">kubectl</a> version v1.25+</li>
-</ul>
-<h2 id="build">Build<a class="headerlink" href="#build" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>make
-</span></code></pre></div>
-<h2 id="run-locally">Run locally<a class="headerlink" href="#run-locally" title="Permanent link">&para;</a></h2>
-<p>You need an active session open to a kubernetes cluster.</p>
-<p>Optionally, run kind with <code>local-env-setup</code>.</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>local-env-setup
-</span></code></pre></div>
-<p>Then, run the operator locally</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>make<span class="w"> </span>run
-</span></code></pre></div>
-<h2 id="deploy-the-operator-in-a-deployment-object">Deploy the operator in a deployment object<a class="headerlink" href="#deploy-the-operator-in-a-deployment-object" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>make<span class="w"> </span>local-setup
-</span></code></pre></div>
-<h2 id="deploy-the-operator-using-olm">Deploy the operator using OLM<a class="headerlink" href="#deploy-the-operator-using-olm" title="Permanent link">&para;</a></h2>
-<p>You can deploy the operator using OLM just running a few commands.
-No need to build any image. Kuadrant engineering team provides <code>latest</code> and
-released version tagged images. They are available in
-the <a href="https://quay.io/organization/kuadrant">Quay.io/Kuadrant</a> image repository.</p>
-<p>Create kind cluster</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>make<span class="w"> </span>kind-create-cluster
-</span></code></pre></div>
-<p>Deploy OLM system</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>make<span class="w"> </span>install-olm
-</span></code></pre></div>
-<p>Deploy the operator using OLM. The <code>make deploy-catalog</code> target accepts the following variables:</p>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>CATALOG_IMG</code></td>
-<td>Catalog image URL</td>
-<td><code>quay.io/kuadrant/limitador-operator-catalog:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>make<span class="w"> </span>deploy-catalog<span class="w"> </span><span class="o">[</span><span class="nv">CATALOG_IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator-catalog:latest<span class="o">]</span>
-</span></code></pre></div>
-<h2 id="build-custom-olm-catalog">Build custom OLM catalog<a class="headerlink" href="#build-custom-olm-catalog" title="Permanent link">&para;</a></h2>
-<p>If you want to deploy (using OLM) a custom limitador operator, you need to build your own catalog.</p>
-<h3 id="build-operator-bundle-image">Build operator bundle image<a class="headerlink" href="#build-operator-bundle-image" title="Permanent link">&para;</a></h3>
-<p>The <code>make bundle</code> target accepts the following variables:</p>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-<th><strong>Notes</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>IMG</code></td>
-<td>Operator image URL</td>
-<td><code>quay.io/kuadrant/limitador-operator:latest</code></td>
-<td></td>
-</tr>
-<tr>
-<td><code>VERSION</code></td>
-<td>Bundle version</td>
-<td><code>0.0.0</code></td>
-<td></td>
-</tr>
-<tr>
-<td><code>RELATED_IMAGE_LIMITADOR</code></td>
-<td>Limitador bundle URL</td>
-<td><code>quay.io/kuadrant/limitador:latest</code></td>
-<td><code>LIMITADOR_VERSION</code> var could be use to build this URL providing the tag</td>
-</tr>
-</tbody>
-</table>
-<ul>
-<li>Build the bundle manifests</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>make<span class="w"> </span>bundle<span class="w"> </span><span class="o">[</span><span class="nv">IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="w">            </span><span class="o">[</span><span class="nv">VERSION</span><span class="o">=</span><span class="m">0</span>.0.0<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w">            </span><span class="o">[</span><span class="nv">RELATED_IMAGE_LIMITADOR</span><span class="o">=</span>quay.io/kuadrant/limitador:latest<span class="o">]</span>
-</span></code></pre></div>
-<ul>
-<li>Build the bundle image from the manifests</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>BUNDLE_IMG</code></td>
-<td>Operator bundle image URL</td>
-<td><code>quay.io/kuadrant/limitador-operator-bundle:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>make<span class="w"> </span>bundle-build<span class="w"> </span><span class="o">[</span><span class="nv">BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator-bundle:latest<span class="o">]</span>
-</span></code></pre></div>
-<ul>
-<li>Push the bundle image to a registry</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>BUNDLE_IMG</code></td>
-<td>Operator bundle image URL</td>
-<td><code>quay.io/kuadrant/limitador-operator-bundle:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>make<span class="w"> </span>bundle-push<span class="w"> </span><span class="o">[</span><span class="nv">BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator-bundle:latest<span class="o">]</span>
-</span></code></pre></div>
-<h3 id="build-custom-catalog">Build custom catalog<a class="headerlink" href="#build-custom-catalog" title="Permanent link">&para;</a></h3>
-<p>The catalog format will be <a href="https://olm.operatorframework.io/docs/reference/file-based-catalogs/">File-based Catalog</a>.</p>
-<p>Make sure all the required bundles are pushed to the registry. It is required by the <code>opm</code> tool.</p>
-<p>The <code>make catalog</code> target accepts the following variables:</p>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>BUNDLE_IMG</code></td>
-<td>Operator bundle image URL</td>
-<td><code>quay.io/kuadrant/limitador-operator-bundle:latest</code></td>
-</tr>
-<tr>
-<td><code>REPLACES_VERSION</code></td>
-<td>Previous operator version</td>
-<td><code>0.0.0-alpha</code></td>
-</tr>
-<tr>
-<td><code>CHANNELS</code></td>
-<td>Catalog channels</td>
-<td><code>preview</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>make<span class="w"> </span>catalog<span class="w"> </span><span class="o">[</span><span class="nv">BUNDLE_IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator-bundle:latest<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w">             </span><span class="o">[</span><span class="nv">REPLACES_VERSION</span><span class="o">=</span><span class="m">0</span>.0.0-alpha<span class="o">]</span><span class="w"> </span><span class="se">\</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w">             </span><span class="o">[</span><span class="nv">CHANNELS</span><span class="o">=</span>preview<span class="o">]</span>
-</span></code></pre></div>
-<ul>
-<li>Build the catalog image from the manifests</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th><strong>Makefile Variable</strong></th>
-<th><strong>Description</strong></th>
-<th><strong>Default value</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>CATALOG_IMG</code></td>
-<td>Operator catalog image URL</td>
-<td><code>quay.io/kuadrant/limitador-operator-catalog:latest</code></td>
-</tr>
-</tbody>
-</table>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>make<span class="w"> </span>catalog-build<span class="w"> </span><span class="o">[</span><span class="nv">CATALOG_IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator-catalog:latest<span class="o">]</span>
-</span></code></pre></div>
-<ul>
-<li>Push the catalog image to a registry</li>
-</ul>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>make<span class="w"> </span>catalog-push<span class="w"> </span><span class="o">[</span><span class="nv">CATALOG_IMG</span><span class="o">=</span>quay.io/kuadrant/limitador-operator-bundle:latest<span class="o">]</span>
-</span></code></pre></div>
-<p>You can try out your custom catalog image following the steps of the
-<a href="#deploy-the-operator-using-olm">Deploy the operator using OLM</a> section.</p>
-<h2 id="cleaning-up">Cleaning up<a class="headerlink" href="#cleaning-up" title="Permanent link">&para;</a></h2>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>make<span class="w"> </span>local-cleanup
-</span></code></pre></div>
-<h2 id="run-tests">Run tests<a class="headerlink" href="#run-tests" title="Permanent link">&para;</a></h2>
-<h3 id="unittests">Unittests<a class="headerlink" href="#unittests" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>make<span class="w"> </span>test-unit
-</span></code></pre></div>
-<p>Optionally, add <code>TEST_NAME</code> makefile variable to run specific test</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>make<span class="w"> </span>test-unit<span class="w"> </span><span class="nv">TEST_NAME</span><span class="o">=</span>TestConstants
-</span></code></pre></div>
-<p>or even subtest</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>make<span class="w"> </span>test-unit<span class="w"> </span><span class="nv">TEST_NAME</span><span class="o">=</span>TestLimitIndexEquals/empty_indexes_are_equal
-</span></code></pre></div>
-<h3 id="integration-tests">Integration tests<a class="headerlink" href="#integration-tests" title="Permanent link">&para;</a></h3>
-<p>You need an active session open to a kubernetes cluster.</p>
-<p>Optionally, run local cluster with kind</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>make<span class="w"> </span>local-env-setup
-</span></code></pre></div>
-<p>Run integration tests</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a>make<span class="w"> </span>test-integration
-</span></code></pre></div>
-<h3 id="all-tests">All tests<a class="headerlink" href="#all-tests" title="Permanent link">&para;</a></h3>
-<p>You need an active session open to a kubernetes cluster.</p>
-<p>Optionally, run local cluster with kind</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>make<span class="w"> </span>local-env-setup
-</span></code></pre></div>
-<p>Run all tests</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a>make<span class="w"> </span><span class="nb">test</span>
-</span></code></pre></div>
-<h3 id="lint-tests">Lint tests<a class="headerlink" href="#lint-tests" title="Permanent link">&para;</a></h3>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>make<span class="w"> </span>run-lint
-</span></code></pre></div>
-<h2 id="uninstall-limitador-crd">(Un)Install Limitador CRD<a class="headerlink" href="#uninstall-limitador-crd" title="Permanent link">&para;</a></h2>
-<p>You need an active session open to a kubernetes cluster.</p>
-<p>Remove CRDs</p>
-<div class="language-sh highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a>make<span class="w"> </span>uninstall
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador-operator/doc/logging/index.html b/0.10.0/limitador-operator/doc/logging/index.html
deleted file mode 100644
index 7aaae6af4..000000000
--- a/0.10.0/limitador-operator/doc/logging/index.html
+++ /dev/null
@@ -1,3393 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador-operator/doc/logging/">
-      
-      
-        <link rel="prev" href="../development/">
-      
-      
-        <link rel="next" href="../../../kuadrantctl/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Logging - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#logging" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Logging
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador-operator/blob/main/doc/logging.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="logging">Logging<a class="headerlink" href="#logging" title="Permanent link">&para;</a></h1>
-<p>The limitador operator outputs 3 levels of log messages: (from lowest to highest level)</p>
-<ol>
-<li><code>debug</code></li>
-<li><code>info</code> (default)</li>
-<li><code>error</code></li>
-</ol>
-<p><code>info</code> logging is restricted to high-level information. Actions like creating, deleting or updating kubernetes resources will be logged with reduced details about the corresponding objects, and without any further detailed logs of the steps in between, except for errors.</p>
-<p>Only <code>debug</code> logging will include processing details.</p>
-<p>To configure the desired log level, set the environment variable <code>LOG_LEVEL</code> to one of the supported values listed above. Default log level is <code>info</code>.</p>
-<p>Apart from log level, the controller can output messages to the logs in 2 different formats:</p>
-<ul>
-<li><code>production</code> (default): each line is a parseable JSON object with properties <code>{"level":string, "ts":int, "msg":string, "logger":string, extra values...}</code></li>
-<li><code>development</code>: more human-readable outputs, extra stack traces and logging info, plus extra values output as JSON, in the format: <code>&lt;timestamp-iso-8601&gt;\t&lt;log-level&gt;\t&lt;logger&gt;\t&lt;message&gt;\t{extra-values-as-json}</code></li>
-</ul>
-<p>To configure the desired log mode, set the environment variable <code>LOG_MODE</code> to one of the supported values listed above. Default log mode is <code>production</code>.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador-operator/doc/rate-limit-headers/index.html b/0.10.0/limitador-operator/doc/rate-limit-headers/index.html
deleted file mode 100644
index cc579806d..000000000
--- a/0.10.0/limitador-operator/doc/rate-limit-headers/index.html
+++ /dev/null
@@ -1,3395 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador-operator/doc/rate-limit-headers/">
-      
-      
-        <link rel="prev" href="../storage/">
-      
-      
-        <link rel="next" href="../development/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Rate limit headers - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#rate-limit-headers" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Rate limit headers
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador-operator/blob/main/doc/rate-limit-headers.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="rate-limit-headers">Rate Limit Headers<a class="headerlink" href="#rate-limit-headers" title="Permanent link">&para;</a></h1>
-<p>It enables RateLimit Header Fields for HTTP as specified in
-<a href="https://datatracker.ietf.org/doc/id/draft-polli-ratelimit-headers-03.html">Rate Limit Headers Draft</a></p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="nt">rateLimitHeaders</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DRAFT_VERSION_03</span>
-</span></code></pre></div>
-<p>Current valid values are:</p>
-<ul>
-<li><em>DRAFT_VERSION_03</em> (ref: 
-<a href="https://datatracker.ietf.org/doc/id/draft-polli-ratelimit-headers-03.html">Rate Limit Headers Draft</a>)</li>
-<li><em>NONE</em></li>
-</ul>
-<p>By default, when <code>spec.rateLimitHeaders</code> is <em>null</em>, <code>--rate-limit-headers</code> command line arg is not
-included in the limitador's deployment.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador-operator/doc/resource-requirements/index.html b/0.10.0/limitador-operator/doc/resource-requirements/index.html
deleted file mode 100644
index a868a813d..000000000
--- a/0.10.0/limitador-operator/doc/resource-requirements/index.html
+++ /dev/null
@@ -1,3464 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador-operator/doc/resource-requirements/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Resource Requirements - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#resource-requirements" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Resource Requirements
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#example-with-resource-limits" class="md-nav__link">
-    <span class="md-ellipsis">
-      Example with resource limits
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador-operator/blob/main/doc/resource-requirements.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="resource-requirements">Resource Requirements<a class="headerlink" href="#resource-requirements" title="Permanent link">&para;</a></h1>
-<p>The default resource requirement for <em><strong>Limitador</strong></em> deployments is specified in <a href="https://github.com/Kuadrant/limitador-operator/blob/main/api/v1alpha1/limitador_types.go">Limitador v1alpha1 API reference</a>
-and will be applied if the resource requirement is not set in the spec.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="nt">listener</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">    </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">    </span><span class="nt">grpc</span><span class="p">:</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8081</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;get_toy</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;yes&#39;&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">      </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">      </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">      </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">      </span><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span><span class="w">  </span>
-</span></code></pre></div>
-<table>
-<thead>
-<tr>
-<th><strong>Field</strong></th>
-<th><strong>json/yaml field</strong></th>
-<th><strong>Type</strong></th>
-<th><strong>Required</strong></th>
-<th><strong>Default value</strong></th>
-<th><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>ResourceRequirements</td>
-<td><code>resourceRequirements</code></td>
-<td><a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#resourcerequirements-v1-core">*corev1.ResourceRequirements</a></td>
-<td>No</td>
-<td><code>{"limits": {"cpu": "500m","memory": "64Mi"},"requests": {"cpu": "250m","memory": "32Mi"}}</code></td>
-<td>Limitador deployment resource requirements</td>
-</tr>
-</tbody>
-</table>
-<h2 id="example-with-resource-limits">Example with resource limits<a class="headerlink" href="#example-with-resource-limits" title="Permanent link">&para;</a></h2>
-<p>The resource requests and limits for the deployment can be set like the following:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="nt">listener</span><span class="p">:</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">    </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">    </span><span class="nt">grpc</span><span class="p">:</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8081</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;get_toy</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;yes&#39;&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w">      </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w">      </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w">      </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a><span class="w">      </span><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a><span class="w">  </span><span class="nt">resourceRequirements</span><span class="p">:</span>
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a><span class="w">    </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a><span class="w">      </span><span class="nt">cpu</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">200m</span>
-</span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a><span class="w">      </span><span class="nt">memory</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">400Mi</span>
-</span><span id="__span-1-22"><a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a><span class="w">    </span><span class="nt">requests</span><span class="p">:</span>
-</span><span id="__span-1-23"><a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a><span class="w">      </span><span class="nt">cpu</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">101m</span><span class="w">  </span>
-</span><span id="__span-1-24"><a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a><span class="w">      </span><span class="nt">memory</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">201Mi</span><span class="w">    </span>
-</span></code></pre></div>
-<p>To specify the deployment without resource requests or limits, set an empty struct <code>{}</code> to the field:
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="nt">listener</span><span class="p">:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">    </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">    </span><span class="nt">grpc</span><span class="p">:</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8081</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="w"> </span><span class="s">&quot;get_toy</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;yes&#39;&quot;</span><span class="w"> </span><span class="p p-Indicator">]</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="w">      </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="w">      </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="w">      </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
-</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a><span class="w">      </span><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a><span class="w">  </span><span class="nt">resourceRequirements</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span></code></pre></div></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador-operator/doc/storage/index.html b/0.10.0/limitador-operator/doc/storage/index.html
deleted file mode 100644
index 7f1c11883..000000000
--- a/0.10.0/limitador-operator/doc/storage/index.html
+++ /dev/null
@@ -1,3770 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador-operator/doc/storage/">
-      
-      
-        <link rel="prev" href="../../">
-      
-      
-        <link rel="next" href="../rate-limit-headers/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Storage - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#storage" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Storage
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#in-memory" class="md-nav__link">
-    <span class="md-ellipsis">
-      In-Memory
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#redis" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#redis-cached" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis Cached
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Redis Cached">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#options" class="md-nav__link">
-    <span class="md-ellipsis">
-      Options
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#disk" class="md-nav__link">
-    <span class="md-ellipsis">
-      Disk
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Disk">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#persistent-volume-claim-options" class="md-nav__link">
-    <span class="md-ellipsis">
-      Persistent Volume Claim Options
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optimize" class="md-nav__link">
-    <span class="md-ellipsis">
-      Optimize
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#in-memory" class="md-nav__link">
-    <span class="md-ellipsis">
-      In-Memory
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#redis" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#redis-cached" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis Cached
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Redis Cached">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#options" class="md-nav__link">
-    <span class="md-ellipsis">
-      Options
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#disk" class="md-nav__link">
-    <span class="md-ellipsis">
-      Disk
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Disk">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#persistent-volume-claim-options" class="md-nav__link">
-    <span class="md-ellipsis">
-      Persistent Volume Claim Options
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optimize" class="md-nav__link">
-    <span class="md-ellipsis">
-      Optimize
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador-operator/blob/main/doc/storage.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="storage">Storage<a class="headerlink" href="#storage" title="Permanent link">&para;</a></h1>
-<p><em><strong>Limitador</strong></em> limits counters are stored in a backend storage. This is In contrast to the storage of
-the limits themselves, which are always stored in ephemeral memory. Limitador's operator
-supports several storage configurations:</p>
-<ul>
-<li>In-Memory: ephemeral and cannot be shared</li>
-<li>Redis: Persistent (depending on the redis storage configuration) and can be shared</li>
-<li>Redis Cached: Persistent (depending on the redis storage configuration) and can be shared</li>
-<li>Disk: Persistent (depending on the underlying disk persistence capabilities) and cannot be shared</li>
-</ul>
-<h2 id="in-memory">In-Memory<a class="headerlink" href="#in-memory" title="Permanent link">&para;</a></h2>
-<p>Counters are held in Limitador (ephemeral)</p>
-<p>In-Memory is the default option defined by the Limitador's Operator.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w">  </span><span class="nt">storage</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
-</span></code></pre></div>
-<p>For any of those, one should store the URL of the Redis service, inside a K8s opaque
-<a href="https://kubernetes.io/docs/concepts/configuration/secret/">Secret</a>.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redisconfig</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nt">stringData</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">  </span><span class="nt">URL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redis://127.0.0.1/a</span><span class="w"> </span><span class="c1"># Redis URL of its running instance</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span>
-</span></code></pre></div>
-<h2 id="redis">Redis<a class="headerlink" href="#redis" title="Permanent link">&para;</a></h2>
-<p>Uses Redis to store counters.</p>
-<p>Selected when <code>spec.storage.redis</code> is not <code>null</code>.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="nt">storage</span><span class="p">:</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="w">    </span><span class="nt">redis</span><span class="p">:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">      </span><span class="nt">configSecretRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># The secret reference storing the URL for Redis</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redisconfig</span>
-</span></code></pre></div>
-<p>The URL of the Redis service is provided inside a K8s opaque
-<a href="https://kubernetes.io/docs/concepts/configuration/secret/">Secret</a>.
-The secret is required to be in the same namespace as the <code>Limitador</code> CR.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redisconfig</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="nt">stringData</span><span class="p">:</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">  </span><span class="nt">URL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redis://127.0.0.1/a</span><span class="w"> </span><span class="c1"># Redis URL of its running instance</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span>
-</span></code></pre></div>
-<p><strong>Note</strong>: Limitador's Operator will only read the <code>URL</code> field of the secret.</p>
-<h2 id="redis-cached">Redis Cached<a class="headerlink" href="#redis-cached" title="Permanent link">&para;</a></h2>
-<p>Uses Redis to store counters, with an in-memory cache.</p>
-<p>Selected when <code>spec.storage.redis-cached</code> is not <code>null</code>.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="w">  </span><span class="nt">storage</span><span class="p">:</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="w">    </span><span class="nt">redis-cached</span><span class="p">:</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="w">      </span><span class="nt">configSecretRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># The secret reference storing the URL for Redis</span>
-</span><span id="__span-4-9"><a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redisconfig</span>
-</span></code></pre></div>
-<p>The URL of the Redis service is provided inside a K8s opaque
-<a href="https://kubernetes.io/docs/concepts/configuration/secret/">Secret</a>.
-The secret is required to be in the same namespace as the <code>Limitador</code> CR.
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redisconfig</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="nt">stringData</span><span class="p">:</span>
-</span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w">  </span><span class="nt">URL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redis://127.0.0.1/a</span><span class="w"> </span><span class="c1"># Redis URL of its running instance</span>
-</span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span>
-</span></code></pre></div></p>
-<p><strong>Note</strong>: Limitador's Operator will only read the <code>URL</code> field of the secret.</p>
-<p>Additionally, caching options can be specified in the <code>spec.storage.redis-cached.options</code> field.</p>
-<h3 id="options">Options<a class="headerlink" href="#options" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>Option</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>batch-size</code></td>
-<td>Size of entries to flush in as single flush [default: 100]</td>
-</tr>
-<tr>
-<td><code>flush-period</code></td>
-<td>Flushing period for counters in milliseconds [default: 1000]</td>
-</tr>
-<tr>
-<td><code>max-cached</code></td>
-<td>Maximum amount of counters cached [default: 10000]</td>
-</tr>
-<tr>
-<td><code>response-timeout</code></td>
-<td>Timeout for Redis commands in milliseconds [default: 350]</td>
-</tr>
-</tbody>
-</table>
-<p>For example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w">  </span><span class="nt">storage</span><span class="p">:</span>
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="w">    </span><span class="nt">redis-cached</span><span class="p">:</span>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="w">      </span><span class="nt">configSecretRef</span><span class="p">:</span><span class="w"> </span><span class="c1"># The secret reference storing the URL for Redis</span>
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w">        </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redisconfig</span>
-</span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="w">      </span><span class="nt">options</span><span class="p">:</span><span class="w"> </span><span class="c1"># Every option is optional</span>
-</span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="w">        </span><span class="nt">batch-size</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">50</span>
-</span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="w">        </span><span class="nt">max-cached</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5000</span>
-</span></code></pre></div>
-<h2 id="disk">Disk<a class="headerlink" href="#disk" title="Permanent link">&para;</a></h2>
-<p>Counters are held on disk (persistent).
-Kubernetes <a href="https://kubernetes.io/docs/concepts/storage/persistent-volumes/">Persistent Volumes</a>
-will be used to store counters.</p>
-<p>Selected when <code>spec.storage.disk</code> is not <code>null</code>.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="w">  </span><span class="nt">storage</span><span class="p">:</span>
-</span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w">    </span><span class="nt">disk</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{}</span>
-</span></code></pre></div>
-<p>Additionally, disk options can be specified in the <code>spec.storage.disk.persistentVolumeClaim</code>
-and <code>spec.storage.disk.optimize</code> fields.</p>
-<h3 id="persistent-volume-claim-options">Persistent Volume Claim Options<a class="headerlink" href="#persistent-volume-claim-options" title="Permanent link">&para;</a></h3>
-<p><code>spec.storage.disk.persistentVolumeClaim</code> field is an object with the following fields.</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>storageClassName</code></td>
-<td><a href="https://kubernetes.io/docs/concepts/storage/storage-classes/">StorageClass</a> of the storage offered by cluster administrators [default: default storage class of the cluster]</td>
-</tr>
-<tr>
-<td><code>resources</code></td>
-<td>The minimum <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#quantity-resource-core">resources</a> the volume should have. Resources will not take any effect when VolumeName is provided. This parameter is not updateable when the underlying PV is not resizable. [default: 1Gi]</td>
-</tr>
-<tr>
-<td><code>volumeName</code></td>
-<td>The binding reference to the existing PersistentVolume backing this claim [default: <em>null</em>]</td>
-</tr>
-</tbody>
-</table>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w">  </span><span class="nt">storage</span><span class="p">:</span>
-</span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w">    </span><span class="nt">disk</span><span class="p">:</span>
-</span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">      </span><span class="nt">persistentVolumeClaim</span><span class="p">:</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">        </span><span class="nt">storageClassName</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;customClass&quot;</span>
-</span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">        </span><span class="nt">resources</span><span class="p">:</span>
-</span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w">          </span><span class="nt">requests</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2Gi</span>
-</span></code></pre></div>
-<h3 id="optimize">Optimize<a class="headerlink" href="#optimize" title="Permanent link">&para;</a></h3>
-<p>Defines the valid optimization option of the disk persistence type.</p>
-<p><code>spec.storage.disk.optimize</code> field is a <code>string</code> type with the following valid values:</p>
-<table>
-<thead>
-<tr>
-<th>Option</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>throughput</code></td>
-<td>Optimizes for higher throughput. <strong>Default</strong></td>
-</tr>
-<tr>
-<td><code>disk</code></td>
-<td>Optimizes for disk usage</td>
-</tr>
-</tbody>
-</table>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w">  </span><span class="nt">storage</span><span class="p">:</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w">    </span><span class="nt">disk</span><span class="p">:</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w">      </span><span class="nt">optimize</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">disk</span>
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador-operator/doc/tracing/index.html b/0.10.0/limitador-operator/doc/tracing/index.html
deleted file mode 100644
index 83dbf1d36..000000000
--- a/0.10.0/limitador-operator/doc/tracing/index.html
+++ /dev/null
@@ -1,3383 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador-operator/doc/tracing/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Tracing - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#tracing" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Tracing
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador-operator/blob/main/doc/tracing.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="tracing">Tracing<a class="headerlink" href="#tracing" title="Permanent link">&para;</a></h1>
-<p>Limitador offers distributed tracing enablement using the <code>.spec.tracing</code> CR configuration:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nn">---</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="nt">listener</span><span class="p">:</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">    </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">grpc</span><span class="p">:</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8081</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;get_toy</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;yes&#39;&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">      </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">      </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">      </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">      </span><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="w">  </span><span class="nt">verbosity</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">3</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="w">  </span><span class="nt">tracing</span><span class="p">:</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="w">    </span><span class="nt">endpoint</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">rpc://my-otlp-collector:4317</span>
-</span></code></pre></div>
-<p>Currently limitador only supports collectors using the OpenTelemetry Protocol with TLS disabled. The <code>endpoint</code> configuration option should contain the scheme, host and port of the service. The quantity and level of the information provided by the spans is configured via the <code>verbosity</code> argument.</p>
-<p><img alt="Limitador tracing example" src="https://github.com/Kuadrant/limitador-operator/assets/6575004/7bdc7c17-37a5-4dfe-ac56-432efa1070c4" /></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador-operator/index.html b/0.10.0/limitador-operator/index.html
deleted file mode 100644
index b9b0e2ad7..000000000
--- a/0.10.0/limitador-operator/index.html
+++ /dev/null
@@ -1,3583 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador-operator/">
-      
-      
-        <link rel="prev" href="../limitador/limitador/">
-      
-      
-        <link rel="next" href="doc/storage/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#limitador-operator" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#customresourcedefinitions" class="md-nav__link">
-    <span class="md-ellipsis">
-      CustomResourceDefinitions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="CustomResourceDefinitions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitador-crd" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador CRD
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#features" class="md-nav__link">
-    <span class="md-ellipsis">
-      Features
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#licensing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Licensing
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#overview" class="md-nav__link">
-    <span class="md-ellipsis">
-      Overview
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#customresourcedefinitions" class="md-nav__link">
-    <span class="md-ellipsis">
-      CustomResourceDefinitions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="CustomResourceDefinitions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limitador-crd" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador CRD
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#features" class="md-nav__link">
-    <span class="md-ellipsis">
-      Features
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#licensing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Licensing
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador-operator/blob/main/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="limitador-operator">Limitador Operator<a class="headerlink" href="#limitador-operator" title="Permanent link">&para;</a></h1>
-<p><a href="http://www.apache.org/licenses/LICENSE-2.0"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" /></a> 
-<a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Flimitador-operator?ref=badge_shield"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Flimitador-operator.svg?type=shield" /></a>
-<a href="https://codecov.io/gh/Kuadrant/limitador-operator"><img alt="codecov" src="https://codecov.io/gh/Kuadrant/limitador-operator/branch/main/graph/badge.svg?token=181Q05ZJBJ" /></a></p>
-<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
-<p>The Operator to manage <a href="https://github.com/Kuadrant/limitador">Limitador</a> deployments.</p>
-<h2 id="customresourcedefinitions">CustomResourceDefinitions<a class="headerlink" href="#customresourcedefinitions" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="#limitador-crd">Limitador</a>, which defines a desired Limitador deployment.</li>
-</ul>
-<h3 id="limitador-crd">Limitador CRD<a class="headerlink" href="#limitador-crd" title="Permanent link">&para;</a></h3>
-<p><a href="https://github.com/Kuadrant/limitador-operator/tree/main/api/v1alpha1/limitador_types.go">Limitador v1alpha1 API reference</a></p>
-<p>Example:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nn">---</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador.kuadrant.io/v1alpha1</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Limitador</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="nt">metadata</span><span class="p">:</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">limitador-sample</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="nt">spec</span><span class="p">:</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w">  </span><span class="nt">listener</span><span class="p">:</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w">    </span><span class="nt">http</span><span class="p">:</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8080</span>
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w">    </span><span class="nt">grpc</span><span class="p">:</span>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">8081</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w">  </span><span class="nt">limits</span><span class="p">:</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;get_toy</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;yes&#39;&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w">      </span><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="w">      </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">toystore-app</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="w">      </span><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="w">      </span><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span></code></pre></div>
-<h2 id="features">Features<a class="headerlink" href="#features" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="doc/storage/">Storage Options</a></li>
-<li><a href="doc/rate-limit-headers/">Rate Limit Headers</a></li>
-<li><a href="doc/logging/">Logging</a></li>
-<li><a href="doc/tracing/">Tracing</a></li>
-</ul>
-<h2 id="contributing">Contributing<a class="headerlink" href="#contributing" title="Permanent link">&para;</a></h2>
-<p>The <a href="doc/development/">Development guide</a> describes how to build the operator and
-how to test your changes before submitting a patch or opening a PR.</p>
-<p>Join us on the <a href="https://kubernetes.slack.com/archives/C05J0D0V525">#kuadrant</a> channel in the Kubernetes Slack workspace, 
-for live discussions about the roadmap and more.</p>
-<h2 id="licensing">Licensing<a class="headerlink" href="#licensing" title="Permanent link">&para;</a></h2>
-<p>This software is licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 license</a>.</p>
-<p>See the LICENSE and NOTICE files that should have been provided along with this software for details.</p>
-<p><a href="https://app.fossa.com/projects/git%2Bgithub.com%2FKuadrant%2Flimitador-operator?ref=badge_large"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FKuadrant%2Flimitador-operator.svg?type=large" /></a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/LICENSE b/0.10.0/limitador/LICENSE
deleted file mode 100644
index 261eeb9e9..000000000
--- a/0.10.0/limitador/LICENSE
+++ /dev/null
@@ -1,201 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
diff --git a/0.10.0/limitador/doc/how-it-works/index.html b/0.10.0/limitador/doc/how-it-works/index.html
deleted file mode 100644
index b34fbb026..000000000
--- a/0.10.0/limitador/doc/how-it-works/index.html
+++ /dev/null
@@ -1,3502 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/doc/how-it-works/">
-      
-      
-        <link rel="prev" href="../../">
-      
-      
-        <link rel="next" href="../topologies/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>How it works - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#how-it-works" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              How it works
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#how-it-works" class="md-nav__link">
-    <span class="md-ellipsis">
-      How it works
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/doc/how-it-works.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>How it works</h1>
-
-<h2 id="how-it-works">How it works<a class="headerlink" href="#how-it-works" title="Permanent link">&para;</a></h2>
-<p>Limitador ensures that <em>the most restrictive limit configuration will apply</em>.</p>
-<p>Limitador will try to match each incoming descriptor with the same <em>namespaced</em>
-counter's conditions and variables.
-The namespace for the descriptors is defined by the <code>domain</code> field
-whereas for the rate limit configuration the <code>namespace</code> field is being used.
-For each matching counter, the counter is increased and the limits checked.</p>
-<p>One example to illustrate:</p>
-<p>Let's say we have 1 rate limit configuration (one counter per config):</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;KEY_A</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;VALUE_A&#39;&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.org</span>
-</span></code></pre></div>
-<p>Limitador receives one descriptor with two entries:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nt">domain</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.org</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nt">descriptors</span><span class="p">:</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">entries</span><span class="p">:</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">KEY_A</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">VALUE_A</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">OTHER_KEY</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">OTHER_VALUE</span>
-</span></code></pre></div>
-<p>The counter's condition will match. Then, the counter will be increased and the limit checked.
-If the limit is exceeded, the request will be rejected with <code>429 Too Many Requests</code>,
-otherwise accepted.</p>
-<p>Note that the counter is being activated even though it does not match <em>all</em> the entries of the
-descriptor. The same rule applies for the <em>variables</em> field.</p>
-<p>Currently, the implementation of <em>condition</em> only allow for <em>equal</em> (<code>==</code>) and <em>not equal</em> (<code>!=</code>) operators.
-More operators will be implemented based off the use cases for them.</p>
-<p>The <em>variables</em> field is a list of keys.
-The matching rule is defined just as the existence of the list of descriptor entries with the
-same key values. If <em>variables</em> is <code>variables: [A, B, C]</code>,
-one descriptor matches if it has <em>at least</em> three entries with the same A, B, C keys.</p>
-<p>Few examples to illustrate.</p>
-<p>Having the following descriptors:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">domain</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.org</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">descriptors</span><span class="p">:</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">entries</span><span class="p">:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">KEY_A</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">VALUE_A</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">OTHER_KEY</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">OTHER_VALUE</span>
-</span></code></pre></div>
-<p>the following counters would <strong>not</strong> be activated.</p>
-<p><div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;KEY_B</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;VALUE_B&#39;&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.org</span>
-</span></code></pre></div>
-Reason: conditions key does not exist</p>
-<p><div class="language-yaml highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;KEY_A</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;VALUE_A&#39;&quot;</span>
-</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;OTHER_KEY</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;WRONG_VALUE&#39;&quot;</span>
-</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-4-8"><a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.org</span>
-</span></code></pre></div>
-Reason: not all the conditions match</p>
-<p><div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[]</span>
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;MY_VAR&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.org</span>
-</span></code></pre></div>
-Reason: the variable name does not exist</p>
-<p><div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">conditions</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;KEY_B</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;VALUE_B&#39;&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1</span>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="nt">variables</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;MY_VAR&quot;</span><span class="p p-Indicator">]</span>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.org</span>
-</span></code></pre></div>
-Reason: Both variables and conditions must match. In this particular case, only conditions match</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/doc/migrations/conditions/index.html b/0.10.0/limitador/doc/migrations/conditions/index.html
deleted file mode 100644
index 91187982f..000000000
--- a/0.10.0/limitador/doc/migrations/conditions/index.html
+++ /dev/null
@@ -1,3447 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/doc/migrations/conditions/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>New condition syntax - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#new-condition-syntax" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              New condition syntax
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#changes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Changes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Changes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#the-new-syntax" class="md-nav__link">
-    <span class="md-ellipsis">
-      The new syntax
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#the-issue-with-the-deprecated-syntax" class="md-nav__link">
-    <span class="md-ellipsis">
-      The issue with the deprecated syntax
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#server-binary-users" class="md-nav__link">
-    <span class="md-ellipsis">
-      Server binary users
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#crate-users" class="md-nav__link">
-    <span class="md-ellipsis">
-      Crate users
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/doc/migrations/conditions.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="new-condition-syntax">New condition syntax<a class="headerlink" href="#new-condition-syntax" title="Permanent link">&para;</a></h1>
-<p>With <code>limitador-server</code> version <code>1.0.0</code> (and the <code>limitador</code> crate version <code>0.3.0</code>), the syntax for <code>condition</code>s within 
-<code>limit</code> definitions has changed.</p>
-<h2 id="changes">Changes<a class="headerlink" href="#changes" title="Permanent link">&para;</a></h2>
-<h3 id="the-new-syntax">The new syntax<a class="headerlink" href="#the-new-syntax" title="Permanent link">&para;</a></h3>
-<p>The new syntax formalizes what part of an expression is the identifier and which is the value to test against. 
-Identifiers are simple string value, while string literals are to be demarcated by single quotes (<code>'</code>) or double quotes
-(<code>"</code>) so that <code>foo == " bar"</code> now makes it explicit that the value is to be prefixed with a space character.</p>
-<p>A few remarks:</p>
-<ul>
-<li>Only <code>string</code> values are supported, as that's what they really are</li>
-<li>There is no escape character sequence supported in string literals</li>
-<li>A new operator has been added, <code>!=</code></li>
-</ul>
-<h3 id="the-issue-with-the-deprecated-syntax">The issue with the deprecated syntax<a class="headerlink" href="#the-issue-with-the-deprecated-syntax" title="Permanent link">&para;</a></h3>
-<p>The previous syntax wouldn't differentiate between values and the identifier, so that <code>foo == bar</code> was valid. In this
-case <code>foo</code> was the identifier of the variable, while <code>bar</code> was the value to evaluate it against. Whitespaces before and
-after the operator <code>==</code> would be equally important. SO that <code>foo  ==  bar</code> would test for a <code>foo</code> variable being equal
-to <code>bar</code> where the trailing whitespace after the identifier, and the one prefixing the value, would have been
-evaluated.</p>
-<h2 id="server-binary-users">Server binary users<a class="headerlink" href="#server-binary-users" title="Permanent link">&para;</a></h2>
-<p>The server still allows for the deprecated syntax, but warns about its usage. You can easily migrate your limits file, 
-using the following command:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>limitador-server --validate old_limits.yaml &gt; updated_limits.yaml
-</span></code></pre></div>
-<p>Which should output <code>Deprecated syntax for conditions corrected!</code> to <code>stderr</code> while <code>stdout</code> would be the limits using 
-the new syntax. It is recommended you manually verify the resulting <code>LIMITS_FILE</code>.</p>
-<h2 id="crate-users">Crate users<a class="headerlink" href="#crate-users" title="Permanent link">&para;</a></h2>
-<p>A feature <code>lenient_conditions</code> has been added, which lets you use the syntax used in previous version of the crate.
-The function <code>limitador::limit::check_deprecated_syntax_usages_and_reset()</code> lets you verify if the deprecated syntax 
-has been used as <code>limit::Limit</code>s are created with their condition strings using the deprecated syntax.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/doc/server/configuration/index.html b/0.10.0/limitador/doc/server/configuration/index.html
deleted file mode 100644
index 6fa92c6e0..000000000
--- a/0.10.0/limitador/doc/server/configuration/index.html
+++ /dev/null
@@ -1,3916 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/doc/server/configuration/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Limitador configuration - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#limitador-configuration" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Limitador configuration
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#command-line-configuration" class="md-nav__link">
-    <span class="md-ellipsis">
-      Command line configuration
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Command line configuration">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#limit-definitions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limit definitions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Limit definitions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#the-limits_files-format" class="md-nav__link">
-    <span class="md-ellipsis">
-      The LIMITS_FILE's format
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#condition-syntax" class="md-nav__link">
-    <span class="md-ellipsis">
-      condition syntax
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#counter-storages" class="md-nav__link">
-    <span class="md-ellipsis">
-      Counter storages
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Counter storages">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#memory" class="md-nav__link">
-    <span class="md-ellipsis">
-      memory
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#redis" class="md-nav__link">
-    <span class="md-ellipsis">
-      redis
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#redis_cached" class="md-nav__link">
-    <span class="md-ellipsis">
-      redis_cached
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#disk" class="md-nav__link">
-    <span class="md-ellipsis">
-      disk
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#configuration-using-environment-variables" class="md-nav__link">
-    <span class="md-ellipsis">
-      Configuration using environment variables
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Configuration using environment variables">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#envoy_rls_host" class="md-nav__link">
-    <span class="md-ellipsis">
-      ENVOY_RLS_HOST
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#envoy_rls_port" class="md-nav__link">
-    <span class="md-ellipsis">
-      ENVOY_RLS_PORT
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#http_api_host" class="md-nav__link">
-    <span class="md-ellipsis">
-      HTTP_API_HOST
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#http_api_port" class="md-nav__link">
-    <span class="md-ellipsis">
-      HTTP_API_PORT
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limits_file" class="md-nav__link">
-    <span class="md-ellipsis">
-      LIMITS_FILE
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limit_name_in_prometheus_labels" class="md-nav__link">
-    <span class="md-ellipsis">
-      LIMIT_NAME_IN_PROMETHEUS_LABELS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tracing_endpoint" class="md-nav__link">
-    <span class="md-ellipsis">
-      TRACING_ENDPOINT
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#redis_local_cache_enabled" class="md-nav__link">
-    <span class="md-ellipsis">
-      REDIS_LOCAL_CACHE_ENABLED
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#redis_local_cache_flushing_period_ms" class="md-nav__link">
-    <span class="md-ellipsis">
-      REDIS_LOCAL_CACHE_FLUSHING_PERIOD_MS
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#redis_local_cache_batch_size" class="md-nav__link">
-    <span class="md-ellipsis">
-      REDIS_LOCAL_CACHE_BATCH_SIZE
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#redis_url" class="md-nav__link">
-    <span class="md-ellipsis">
-      REDIS_URL
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#rust_log" class="md-nav__link">
-    <span class="md-ellipsis">
-      RUST_LOG
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#rate_limit_headers" class="md-nav__link">
-    <span class="md-ellipsis">
-      RATE_LIMIT_HEADERS
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/doc/server/configuration.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="limitador-configuration">Limitador configuration<a class="headerlink" href="#limitador-configuration" title="Permanent link">&para;</a></h1>
-<h2 id="command-line-configuration">Command line configuration<a class="headerlink" href="#command-line-configuration" title="Permanent link">&para;</a></h2>
-<p>The preferred way of starting and configuring the Limitador server is using the command line:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>Rate Limiting Server
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>Usage: limitador-server [OPTIONS] &lt;LIMITS_FILE&gt; [STORAGE]
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>STORAGES:
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>  memory        Counters are held in Limitador (ephemeral)
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>  disk          Counters are held on disk (persistent)
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>  redis         Uses Redis to store counters
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>  redis_cached  Uses Redis to store counters, with an in-memory cache
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>Arguments:
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>  &lt;LIMITS_FILE&gt;  The limit file to use
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>Options:
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>  -b, --rls-ip &lt;ip&gt;
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>          The IP to listen on for RLS [default: 0.0.0.0]
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>  -p, --rls-port &lt;port&gt;
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>          The port to listen on for RLS [default: 8081]
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>  -B, --http-ip &lt;http_ip&gt;
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>          The IP to listen on for HTTP [default: 0.0.0.0]
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>  -P, --http-port &lt;http_port&gt;
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a>          The port to listen on for HTTP [default: 8080]
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a>  -l, --limit-name-in-labels
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a>          Include the Limit Name in prometheus label
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a>  -v...
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a>          Sets the level of verbosity
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a>      --tracing-endpoint &lt;tracing_endpoint&gt;
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a>          The endpoint for the tracing service
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a>      --validate
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a>          Validates the LIMITS_FILE and exits
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a>  -H, --rate-limit-headers &lt;rate_limit_headers&gt;
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a>          Enables rate limit response headers [default: NONE] [possible values: NONE, DRAFT_VERSION_03]
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a>      --grpc-reflection-service
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a>          Enables gRPC server reflection service
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a>  -h, --help
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a>          Print help
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a>  -V, --version
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a>          Print version
-</span></code></pre></div>
-<p>The values used are authoritative over any <a href="#configuration-using-environment-variables">environment variables</a> independently set.</p>
-<h3 id="limit-definitions">Limit definitions<a class="headerlink" href="#limit-definitions" title="Permanent link">&para;</a></h3>
-<p>The <code>LIMITS_FILE</code> provided is the source of truth for all the limits that will be enforced. The file location will be
-monitored by the server for any changes and be hot reloaded. If the changes are invalid, they will be ignored on hot
-reload, or the server will fail to start.</p>
-<h4 id="the-limits_files-format">The <code>LIMITS_FILE</code>'s format<a class="headerlink" href="#the-limits_files-format" title="Permanent link">&para;</a></h4>
-<p>When starting the server, you point it to a <code>LIMITS_FILE</code>, which is expected to be a <em>yaml</em> file with an array of
-<code>limit</code> definitions, with the following format:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nn">---</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="s">&quot;$schema&quot;</span><span class="p p-Indicator">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">http://json-schema.org/draft-04/schema#</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">object</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="nt">properties</span><span class="p">:</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">  </span><span class="nt">name</span><span class="p">:</span>
-</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">string</span>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">string</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">  </span><span class="nt">seconds</span><span class="p">:</span>
-</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">integer</span>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w">  </span><span class="nt">max_value</span><span class="p">:</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">integer</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w">  </span><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">array</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w">    </span><span class="nt">items</span><span class="p">:</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a>
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">string</span>
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a><span class="w">  </span><span class="nt">variables</span><span class="p">:</span>
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">array</span>
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a><span class="w">    </span><span class="nt">items</span><span class="p">:</span>
-</span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">string</span>
-</span><span id="__span-1-22"><a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a><span class="nt">required</span><span class="p">:</span>
-</span><span id="__span-1-23"><a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">namespace</span>
-</span><span id="__span-1-24"><a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">seconds</span>
-</span><span id="__span-1-25"><a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">max_value</span>
-</span><span id="__span-1-26"><a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">conditions</span>
-</span><span id="__span-1-27"><a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">variables</span>
-</span></code></pre></div>
-<p>Here is an example of such a limit definition:</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">example.org</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nt">max_value</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nt">seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">60</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="nt">conditions</span><span class="p">:</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;req.method</span><span class="nv"> </span><span class="s">==</span><span class="nv"> </span><span class="s">&#39;GET&#39;&quot;</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="nt">variables</span><span class="p">:</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">user_id</span>
-</span></code></pre></div>
-<ul>
-<li><code>namespace</code> namespaces the limit, will generally be the domain, <a href="../../how-it-works/">see here</a></li>
-<li><code>seconds</code> is the duration for which the limit applies, in seconds: e.g. <code>60</code> is a span of time of one minute</li>
-<li><code>max_value</code> is the actual limit, e.g. <code>100</code> would limit to 100 requests</li>
-<li><code>name</code> lets the user <em>optionally</em> name the limit</li>
-<li><code>variables</code> is an array of variables, which once resolved, will be used to qualify counters for the limit,
-   e.g. <code>api_key</code> to limit per api keys</li>
-<li><code>conditions</code> is an array of conditions, which once evaluated will decide whether to apply the limit or not</li>
-</ul>
-<h4 id="condition-syntax"><code>condition</code> syntax<a class="headerlink" href="#condition-syntax" title="Permanent link">&para;</a></h4>
-<p>Each <code>condition</code> is an expression producing a boolean value (<code>true</code> or <code>false</code>). All <code>conditions</code> <em>must</em> evaluate to
-<code>true</code> for the <code>limit</code> to be applied on a request.</p>
-<p>Expressions follow the following syntax: <code>$IDENTIFIER $OP $STRING_LITERAL</code>, where:</p>
-<ul>
-<li><code>$IDENTIFIER</code> will be used to resolve the value at evaluation time, e.g. <code>role</code></li>
-<li><code>$OP</code> is an operator, either <code>==</code> or <code>!=</code></li>
-<li><code>$STRING_LITERAL</code> is a literal string value, <code>"</code> or <code>'</code> demarcated, e.g. <code>"admin"</code></li>
-</ul>
-<p>So that <code>role != "admin"</code> would apply the limit on request from all users, but <code>admin</code>'s.</p>
-<h3 id="counter-storages">Counter storages<a class="headerlink" href="#counter-storages" title="Permanent link">&para;</a></h3>
-<p>Limitador will load all the <code>limit</code> definitions from the <code>LIMITS_FILE</code> and keep these in memory. To enforce these
-limits, Limitador needs to track requests in the form of counters. There would be at least one counter per limit, but
-that number grows when <code>variables</code> are used to qualify counters per some arbitrary values.</p>
-<h4 id="memory"><code>memory</code><a class="headerlink" href="#memory" title="Permanent link">&para;</a></h4>
-<p>As the name implies, Limitador will keep all counters in memory. This yields the best results in terms of latency as
-well as accuracy. By default, only up to <code>1000</code> "concurrent" counters will be kept around, evicting the oldest entries.
-"Concurrent" in this context means counters that need to exist at the "same time", based of the period of the limit,
-as "expired" counters are discarded.</p>
-<p>This storage is ephemeral, as if the process is restarted, all the counters are lost and effectively "reset" all the
-limits as if no traffic had been rate limited, which can be fine for short-lived limits, less for longer-lived ones.</p>
-<h4 id="redis"><code>redis</code><a class="headerlink" href="#redis" title="Permanent link">&para;</a></h4>
-<p>When you want persistence of your counters, such as for disaster recovery or across restarts, using <code>redis</code> will store
-the counters in a redis instance using the provided <code>URL</code>. Increments to <em>individual</em> counters is made within redis
-itself, providing accuracy over these, races tho can occur when multiple Limitador servers are used against a single
-redis and using "stacked" limits (i.e. over different periods). Latency is also impacted, as it results in one
-additional hop to talk to redis and maintain the counters.</p>
-<p><strong>TLS Support</strong></p>
-<p>Connect to a redis instance using the <code>rediss://</code> URL scheme.</p>
-<p>To enable insecure mode, append <code>#insecure</code> at the end of the URL. For example:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>limitador-server &lt;LIMITS_FILE&gt; redis rediss://127.0.0.1/#insecure&quot;
-</span></code></pre></div>
-<p><strong>Authentication</strong></p>
-<p>To enable authentication, use the username and password properties of the URL scheme. For example:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>limitador-server &lt;LIMITS_FILE&gt; redis redis://my-username:my-password@127.0.0.1&quot;
-</span></code></pre></div>
-<p>when the username is omitted, redis assumes <code>default</code> user. For example:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>limitador-server &lt;LIMITS_FILE&gt; redis redis://:my-password@127.0.0.1&quot;
-</span></code></pre></div>
-<p><strong>Usage</strong></p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>Uses Redis to store counters
-</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>
-</span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>Usage: limitador-server &lt;LIMITS_FILE&gt; redis &lt;URL&gt;
-</span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>
-</span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>Arguments:
-</span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>  &lt;URL&gt;  Redis URL to use
-</span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a>
-</span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>Options:
-</span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>  -h, --help  Print help
-</span></code></pre></div>
-<h4 id="redis_cached"><code>redis_cached</code><a class="headerlink" href="#redis_cached" title="Permanent link">&para;</a></h4>
-<p>In order to avoid some communication overhead to redis, <code>redis_cached</code> adds an in memory caching layer within the
-Limitador servers. This lowers the latency, but sacrifices some accuracy as it will not only cache counters, but also
-coalesce counters updates to redis over time. See <a href="#redis_local_cache_enabled">this configuration</a> option for more
-information.</p>
-<p><strong>TLS Support</strong></p>
-<p>Connect to a redis instance using the <code>rediss://</code> URL scheme.</p>
-<p>To enable insecure mode, append <code>#insecure</code> at the end of the URL. For example:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>limitador-server &lt;LIMITS_FILE&gt; redis rediss://127.0.0.1/#insecure&quot;
-</span></code></pre></div>
-<p><strong>Authentication</strong></p>
-<p>To enable authentication, use the username and password properties of the URL scheme. For example:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>limitador-server &lt;LIMITS_FILE&gt; redis redis://my-username:my-password@127.0.0.1&quot;
-</span></code></pre></div>
-<p>when the username is omitted, redis assumes <code>default</code> user. For example:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>limitador-server &lt;LIMITS_FILE&gt; redis redis://:my-password@127.0.0.1&quot;
-</span></code></pre></div>
-<p><strong>Usage</strong></p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>Uses Redis to store counters, with an in-memory cache
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a>Usage: limitador-server &lt;LIMITS_FILE&gt; redis_cached [OPTIONS] &lt;URL&gt;
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a>Arguments:
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a>  &lt;URL&gt;  Redis URL to use
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a>Options:
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a>      --batch-size &lt;batch&gt;          Size of entries to flush in as single flush [default: 100]
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a>      --flush-period &lt;flush&gt;        Flushing period for counters in milliseconds [default: 1000]
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a>      --max-cached &lt;max&gt;            Maximum amount of counters cached [default: 10000]
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a>      --response-timeout &lt;timeout&gt;  Timeout for Redis commands in milliseconds [default: 350]
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a>  -h, --help                        Print help
-</span></code></pre></div>
-<h4 id="disk"><code>disk</code><a class="headerlink" href="#disk" title="Permanent link">&para;</a></h4>
-<p>Disk storage using <a href="https://rocksdb.org/">RocksDB</a>. Counters are held on disk (persistent).</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>Counters are held on disk (persistent)
-</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a>
-</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a>Usage: limitador-server &lt;LIMITS_FILE&gt; disk [OPTIONS] &lt;PATH&gt;
-</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a>
-</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a>Arguments:
-</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a>  &lt;PATH&gt;  Path to counter DB
-</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a>
-</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a>Options:
-</span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a>      --optimize &lt;OPTIMIZE&gt;  Optimizes either to save disk space or higher throughput [default: throughput] [possible values: throughput, disk]
-</span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a>  -h, --help                 Print help
-</span></code></pre></div>
-<p>For an in-depth coverage of the different topologies supported and how they affect the behavior, see the
-<a href="../../topologies/">topologies' document</a>.</p>
-<h2 id="configuration-using-environment-variables">Configuration using environment variables<a class="headerlink" href="#configuration-using-environment-variables" title="Permanent link">&para;</a></h2>
-<p>The Limitador server has some options that can be configured with environment variables. These will override the
-<em>default</em> values the server uses. <a href="#command-line-configuration">Any argument</a> used when starting the server will prevail over the
-environment variables.</p>
-<h4 id="envoy_rls_host"><code>ENVOY_RLS_HOST</code><a class="headerlink" href="#envoy_rls_host" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Host where the Envoy RLS server listens.</li>
-<li>Optional. Defaults to <code>"0.0.0.0"</code>.</li>
-<li>Format: <code>string</code>.</li>
-</ul>
-<h4 id="envoy_rls_port"><code>ENVOY_RLS_PORT</code><a class="headerlink" href="#envoy_rls_port" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Port where the Envoy RLS server listens.</li>
-<li>Optional. Defaults to <code>8081</code>.</li>
-<li>Format: <code>integer</code>.</li>
-</ul>
-<h4 id="http_api_host"><code>HTTP_API_HOST</code><a class="headerlink" href="#http_api_host" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Host where the HTTP server listens.</li>
-<li>Optional. Defaults to <code>"0.0.0.0"</code>.</li>
-<li>Format: <code>string</code>.</li>
-</ul>
-<h4 id="http_api_port"><code>HTTP_API_PORT</code><a class="headerlink" href="#http_api_port" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Port where the HTTP API listens.</li>
-<li>Optional. Defaults to <code>8080</code>.</li>
-<li>Format: <code>integer</code>.</li>
-</ul>
-<h4 id="limits_file"><code>LIMITS_FILE</code><a class="headerlink" href="#limits_file" title="Permanent link">&para;</a></h4>
-<ul>
-<li>YAML file that contains the limits to create when Limitador boots. If the
-limits specified already have counters associated, Limitador will not delete them.
-Changes to the file will be picked up by the running server.</li>
-<li><em>Required</em>. No default</li>
-<li>Format: <code>string</code>, file path.</li>
-</ul>
-<h4 id="limit_name_in_prometheus_labels"><code>LIMIT_NAME_IN_PROMETHEUS_LABELS</code><a class="headerlink" href="#limit_name_in_prometheus_labels" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Enables using limit names as labels in Prometheus metrics. This is disabled by
-default because for a few limits it should be fine, but it could become a
-problem when defining lots of limits. See the caution note in the <a href="https://prometheus.io/docs/practices/naming/#labels">Prometheus
-docs</a></li>
-<li>Optional. Disabled by default.</li>
-<li>Format: <code>bool</code>, set to <code>"1"</code> to enable.</li>
-</ul>
-<h4 id="tracing_endpoint"><code>TRACING_ENDPOINT</code><a class="headerlink" href="#tracing_endpoint" title="Permanent link">&para;</a></h4>
-<ul>
-<li>The endpoint of the OTLP tracing collector (scheme://host:port).</li>
-<li>Optional. Default to <code>""</code> (tracing disabled)</li>
-<li>Format: <code>string</code></li>
-</ul>
-<h4 id="redis_local_cache_enabled"><code>REDIS_LOCAL_CACHE_ENABLED</code><a class="headerlink" href="#redis_local_cache_enabled" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Enables a storage implementation that uses Redis, but also caches some data in
-memory. The idea is to improve throughput and latencies by caching the counters
-in memory to reduce the number of accesses to Redis. To achieve that, this mode
-sacrifices some rate-limit accuracy. This mode does two things:<ul>
-<li>Batches counter updates. Instead of updating the counters on every
-request, it updates them in memory and commits them to Redis in batches. The
-flushing interval can be configured with the
-<a href="#redis_local_cache_flushing_period_ms"><code>REDIS_LOCAL_CACHE_FLUSHING_PERIOD_MS</code></a>
-env. The trade-off is that when running several instances of Limitador,
-other instances will not become aware of the counter updates until they're
-committed to Redis.</li>
-<li>Caches counters. Instead of fetching the value of a counter every time
-it's needed, the value is cached for a configurable period. The trade-off is
-that when running several instances of Limitador, an instance will not
-become aware of the counter updates other instances do while the value is
-cached. When a counter is already at 0 (limit exceeded), it's cached until
-it expires in Redis. In this case, no matter what other instances do, we
-know that the quota will not be reestablished until the key expires in
-Redis, so in this case, rate-limit accuracy is not affected. When a counter
-has still some quota remaining the situation is different, that's why we can
-tune for how long it will be cached. The formula is as follows:
-MIN(ttl_in_redis/<a href="#redis_local_cache_ttl_ratio_cached_counters"><code>REDIS_LOCAL_CACHE_TTL_RATIO_CACHED_COUNTERS</code></a>,
-<a href="#redis_local_cache_max_ttl_cached_counters_ms"><code>REDIS_LOCAL_CACHE_MAX_TTL_CACHED_COUNTERS_MS</code></a>).
-For example, let's image that the current TTL (time remaining until the
-limit resets) in Redis for a counter is 10 seconds, and we set the ratio to
-2, and the max time for 30s. In this case, the counter will be cached for 5s
-(min(10/2, 30)). During those 5s, Limitador will not fetch the value of that
-counter from Redis, so it will answer faster, but it will also miss the
-updates done by other instances, so it can go over the limits in that 5s
-interval.</li>
-</ul>
-</li>
-<li>Optional. Disabled by default.</li>
-<li>Format: set to "1" to enable.</li>
-<li>Note: "REDIS_URL" needs to be set.</li>
-</ul>
-<h4 id="redis_local_cache_flushing_period_ms"><code>REDIS_LOCAL_CACHE_FLUSHING_PERIOD_MS</code><a class="headerlink" href="#redis_local_cache_flushing_period_ms" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Used to configure the maximum flushing period. See
-<a href="#redis_local_cache_enabled"><code>REDIS_LOCAL_CACHE_ENABLED</code></a>. This env only applies
-when <code>"REDIS_LOCAL_CACHE_ENABLED" == 1</code>.</li>
-<li>Optional. Defaults to <code>1000</code>.</li>
-<li>Format: <code>integer</code>. Duration in milliseconds.</li>
-</ul>
-<h4 id="redis_local_cache_batch_size"><code>REDIS_LOCAL_CACHE_BATCH_SIZE</code><a class="headerlink" href="#redis_local_cache_batch_size" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Used to configure the maximum number of counters to update in a flush. See
-<a href="#redis_local_cache_enabled"><code>REDIS_LOCAL_CACHE_ENABLED</code></a>. This env only applies
-when <code>"REDIS_LOCAL_CACHE_ENABLED" == 1</code>.</li>
-<li>Optional. Defaults to <code>100</code>.</li>
-<li>Format: <code>integer</code>. </li>
-</ul>
-<h4 id="redis_url"><code>REDIS_URL</code><a class="headerlink" href="#redis_url" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Redis URL. Required only when you want to use Redis to store the limits.</li>
-<li>Optional. By default, Limitador stores the limits in memory and does not
-require Redis.</li>
-<li>Format: <code>string</code>, URL in the format of <code>"redis://127.0.0.1:6379"</code>.</li>
-</ul>
-<h4 id="rust_log"><code>RUST_LOG</code><a class="headerlink" href="#rust_log" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Defines the log level.</li>
-<li>Optional. Defaults to <code>"error"</code>.</li>
-<li>Format: <code>enum</code>: <code>"debug"</code>, <code>"error"</code>, <code>"info"</code>, <code>"warn"</code>, or <code>"trace"</code>.</li>
-</ul>
-<h4 id="rate_limit_headers"><code>RATE_LIMIT_HEADERS</code><a class="headerlink" href="#rate_limit_headers" title="Permanent link">&para;</a></h4>
-<ul>
-<li>Enables rate limit response headers. Only supported by the RLS server.</li>
-<li>Optional. Defaults to <code>"NONE"</code>.</li>
-<li>Must be one of:</li>
-<li><code>"NONE"</code> - Does not add any additional headers to the http response.</li>
-<li><code>"DRAFT_VERSION_03"</code>.  Adds response headers per https://datatracker.ietf.org/doc/id/draft-polli-ratelimit-headers-03.html</li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/doc/topologies/index.html b/0.10.0/limitador/doc/topologies/index.html
deleted file mode 100644
index 985efae9e..000000000
--- a/0.10.0/limitador/doc/topologies/index.html
+++ /dev/null
@@ -1,3571 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/doc/topologies/">
-      
-      
-        <link rel="prev" href="../how-it-works/">
-      
-      
-        <link rel="next" href="../../limitador-server/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Topologies - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#deployment-topologies" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Topologies
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#in-memory" class="md-nav__link">
-    <span class="md-ellipsis">
-      In-memory
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#redis" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Redis">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#redis-active-active-storage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis active-active storage
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Redis active-active storage">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#considerations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Considerations
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set up
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#disk" class="md-nav__link">
-    <span class="md-ellipsis">
-      Disk
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#in-memory" class="md-nav__link">
-    <span class="md-ellipsis">
-      In-memory
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#redis" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Redis">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#redis-active-active-storage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Redis active-active storage
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Redis active-active storage">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#considerations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Considerations
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#set-up" class="md-nav__link">
-    <span class="md-ellipsis">
-      Set up
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#disk" class="md-nav__link">
-    <span class="md-ellipsis">
-      Disk
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/doc/topologies.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="deployment-topologies">Deployment topologies<a class="headerlink" href="#deployment-topologies" title="Permanent link">&para;</a></h1>
-<h2 id="in-memory">In-memory<a class="headerlink" href="#in-memory" title="Permanent link">&para;</a></h2>
-<h2 id="redis">Redis<a class="headerlink" href="#redis" title="Permanent link">&para;</a></h2>
-<h3 id="redis-active-active-storage">Redis active-active storage<a class="headerlink" href="#redis-active-active-storage" title="Permanent link">&para;</a></h3>
-<p>The RedisLabs version of Redis supports <a href="https://docs.redislabs.com/latest/rs/concepts/intercluster-replication/">active-active
-replication</a>.
-Limitador is compatible with that deployment mode, but there are a few things to
-take into account regarding limit accuracy.</p>
-<h4 id="considerations">Considerations<a class="headerlink" href="#considerations" title="Permanent link">&para;</a></h4>
-<p>With an active-active deployment, the data needs to be replicated between
-instances. An update in an instance takes a short time to be reflected in the
-other. That time lag depends mainly on the network speed between the Redis
-instances, and it affects the accuracy of the rate-limiting performed by
-Limitador because it can go over limits while the updates of the counters are
-being replicated.</p>
-<p>The impact of that greatly depends on the use case. With limits of a few
-seconds, and a low number of hits, we could easily go over limits. On the other
-hand, if we have defined limits with a high number of hits and a long period,
-the effect will be basically negligible. For example, if we define a limit of
-one hour, and we know that the data takes around one second to be replicated,
-the accuracy loss is going to be negligible.</p>
-<h4 id="set-up">Set up<a class="headerlink" href="#set-up" title="Permanent link">&para;</a></h4>
-<p>In order to try active-active replication, you can follow this <a href="https://docs.redislabs.com/latest/rs/databases/active-active/get-started/">tutorial from
-RedisLabs</a>.</p>
-<h2 id="disk">Disk<a class="headerlink" href="#disk" title="Permanent link">&para;</a></h2>
-<p>Disk storage using <a href="https://rocksdb.org/">RocksDB</a>. Counters are held on disk (persistent).</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/index.html b/0.10.0/limitador/index.html
deleted file mode 100644
index b6f65075d..000000000
--- a/0.10.0/limitador/index.html
+++ /dev/null
@@ -1,3643 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/">
-      
-      
-        <link rel="prev" href="../authorino/docs/contributing/">
-      
-      
-        <link rel="next" href="doc/how-it-works/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#limitador" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting started
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Getting started">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#rust-library" class="md-nav__link">
-    <span class="md-ellipsis">
-      Rust library
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#server" class="md-nav__link">
-    <span class="md-ellipsis">
-      Server
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#development" class="md-nav__link">
-    <span class="md-ellipsis">
-      Development
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Development">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#build" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#run-the-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the tests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#license" class="md-nav__link">
-    <span class="md-ellipsis">
-      License
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#getting-started" class="md-nav__link">
-    <span class="md-ellipsis">
-      Getting started
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Getting started">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#rust-library" class="md-nav__link">
-    <span class="md-ellipsis">
-      Rust library
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#server" class="md-nav__link">
-    <span class="md-ellipsis">
-      Server
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#development" class="md-nav__link">
-    <span class="md-ellipsis">
-      Development
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Development">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#build" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#run-the-tests" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run the tests
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#contributing" class="md-nav__link">
-    <span class="md-ellipsis">
-      Contributing
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#license" class="md-nav__link">
-    <span class="md-ellipsis">
-      License
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="limitador">Limitador<a class="headerlink" href="#limitador" title="Permanent link">&para;</a></h1>
-<p><a href="https://github.com/Kuadrant/limitador/actions/workflows/rust.yml"><img alt="Limitador GH Workflow" src="https://github.com/Kuadrant/limitador/actions/workflows/rust.yml/badge.svg" /></a>
-<a href="https://docs.rs/limitador"><img alt="docs.rs" src="https://docs.rs/limitador/badge.svg" /></a>
-<a href="https://crates.io/crates/limitador"><img alt="Crates.io" src="https://img.shields.io/crates/v/limitador" /></a>
-<a href="https://quay.io/repository/kuadrant/limitador"><img alt="Docker Repository on Quay" src="https://quay.io/repository/kuadrant/limitador/status" title="Docker Repository on Quay" /></a>
-<a href="https://codecov.io/gh/Kuadrant/limitador"><img alt="codecov" src="https://codecov.io/gh/Kuadrant/limitador/branch/main/graph/badge.svg?token=CE9LD3XCJT" /></a>
-<a href="https://app.fossa.com/projects/custom%2B162%2Fgit%2Bgithub.com%2FKuadrant%2Flimitador?ref=badge_shield&amp;issueType=license"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/custom%2B162%2Fgit%2Bgithub.com%2FKuadrant%2Flimitador.svg?type=shield&amp;issueType=license" /></a></p>
-<p>Limitador is a generic rate-limiter written in Rust. It can be used as a
-library, or as a service. The service exposes HTTP endpoints to apply and observe
-limits. Limitador can be used with Envoy because it also exposes a grpc service, on a different
-port, that implements the Envoy Rate Limit protocol (v3).</p>
-<ul>
-<li><a href="#getting-started"><strong>Getting started</strong></a></li>
-<li><a href="doc/how-it-works/"><strong>How it works</strong></a></li>
-<li><a href="doc/server/configuration/"><strong>Configuration</strong></a></li>
-<li><a href="#development"><strong>Development</strong></a></li>
-<li><a href="limitador-server/sandbox/"><strong>Testing Environment</strong></a></li>
-<li><a href="limitador-server/kubernetes/"><strong>Kubernetes</strong></a></li>
-<li><a href="#contributing"><strong>Contributing</strong></a></li>
-<li><a href="#license"><strong>License</strong></a></li>
-</ul>
-<p>Limitador is under active development, and its API has not been stabilized yet.</p>
-<h2 id="getting-started">Getting started<a class="headerlink" href="#getting-started" title="Permanent link">&para;</a></h2>
-<ul>
-<li><a href="#rust-library">Rust library</a></li>
-<li><a href="#server">Server</a></li>
-</ul>
-<h3 id="rust-library">Rust library<a class="headerlink" href="#rust-library" title="Permanent link">&para;</a></h3>
-<p>Add this to your <code>Cargo.toml</code>:
-<div class="language-toml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="k">[dependencies]</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="n">limitador</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">version</span><span class="w"> </span><span class="p">=</span><span class="w"> </span><span class="s2">&quot;0.3.0&quot;</span><span class="w"> </span><span class="p">}</span>
-</span></code></pre></div></p>
-<p>For more information, see the <a href="limitador/"><code>README</code> of the crate</a></p>
-<h3 id="server">Server<a class="headerlink" href="#server" title="Permanent link">&para;</a></h3>
-<p>Run with Docker (replace <code>latest</code> with the version you want):
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>docker<span class="w"> </span>run<span class="w"> </span>--rm<span class="w"> </span>--net<span class="o">=</span>host<span class="w"> </span>-it<span class="w"> </span>quay.io/kuadrant/limitador:v1.0.0
-</span></code></pre></div></p>
-<p>Run locally:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>cargo<span class="w"> </span>run<span class="w"> </span>--release<span class="w"> </span>--bin<span class="w"> </span>limitador-server<span class="w"> </span>--<span class="w"> </span>--help
-</span></code></pre></div></p>
-<p>Refer to the help message on how to start up the server. More information are available
-in the <a href="limitador-server/">server's <code>README.md</code></a></p>
-<h2 id="development">Development<a class="headerlink" href="#development" title="Permanent link">&para;</a></h2>
-<h3 id="build">Build<a class="headerlink" href="#build" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>cargo<span class="w"> </span>build
-</span></code></pre></div>
-<h3 id="run-the-tests">Run the tests<a class="headerlink" href="#run-the-tests" title="Permanent link">&para;</a></h3>
-<p>Some tests need a redis deployed in <code>localhost:6379</code>. You can run it in Docker with:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>docker<span class="w"> </span>run<span class="w"> </span>--rm<span class="w"> </span>-p<span class="w"> </span><span class="m">6379</span>:6379<span class="w"> </span>-it<span class="w"> </span>redis
-</span></code></pre></div></p>
-<p>Then, run the tests:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>cargo<span class="w"> </span><span class="nb">test</span><span class="w"> </span>--all-features
-</span></code></pre></div>
-<p>or you can run tests disabling the "redis storage" feature:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nb">cd</span><span class="w"> </span>limitador<span class="p">;</span><span class="w"> </span>cargo<span class="w"> </span><span class="nb">test</span><span class="w"> </span>--no-default-features
-</span></code></pre></div></p>
-<h2 id="contributing">Contributing<a class="headerlink" href="#contributing" title="Permanent link">&para;</a></h2>
-<p>Join us on the <a href="https://kubernetes.slack.com/archives/C05J0D0V525">#kuadrant</a> channel in the Kubernetes Slack workspace,
-for live discussions about the roadmap and more.</p>
-<h2 id="license">License<a class="headerlink" href="#license" title="Permanent link">&para;</a></h2>
-<p><a href="LICENSE">Apache 2.0 License</a></p>
-<p><a href="https://app.fossa.com/projects/custom%2B162%2Fgit%2Bgithub.com%2FKuadrant%2Flimitador?ref=badge_large&amp;issueType=license"><img alt="FOSSA Status" src="https://app.fossa.com/api/projects/custom%2B162%2Fgit%2Bgithub.com%2FKuadrant%2Flimitador.svg?type=large&amp;issueType=license" /></a></p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": ["content.action.edit", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/docs/http_server_spec.json b/0.10.0/limitador/limitador-server/docs/http_server_spec.json
deleted file mode 100644
index 4a17d7ac0..000000000
--- a/0.10.0/limitador/limitador-server/docs/http_server_spec.json
+++ /dev/null
@@ -1,305 +0,0 @@
-{
-  "swagger": "2.0",
-  "definitions": {
-    "CheckAndReportInfo": {
-      "type": "object",
-      "properties": {
-        "delta": {
-          "type": "integer",
-          "format": "int64"
-        },
-        "namespace": {
-          "type": "string"
-        },
-        "values": {
-          "type": "object",
-          "additionalProperties": {
-            "type": "string"
-          }
-        },
-        "response_headers": {
-          "type": "string",
-          "enum": ["none", "DraftVersion03"]
-        }
-      },
-      "required": [
-        "delta",
-        "namespace",
-        "values"
-      ]
-    },
-    "Counter": {
-      "type": "object",
-      "properties": {
-        "expires_in_seconds": {
-          "type": "integer",
-          "format": "int64"
-        },
-        "limit": {
-          "type": "object",
-          "properties": {
-            "conditions": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            },
-            "max_value": {
-              "type": "integer",
-              "format": "int64"
-            },
-            "name": {
-              "type": "string"
-            },
-            "namespace": {
-              "type": "string"
-            },
-            "seconds": {
-              "type": "integer",
-              "format": "int64"
-            },
-            "variables": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            }
-          },
-          "required": [
-            "conditions",
-            "max_value",
-            "namespace",
-            "seconds",
-            "variables"
-          ]
-        },
-        "remaining": {
-          "type": "integer",
-          "format": "int64"
-        },
-        "set_variables": {
-          "type": "object",
-          "additionalProperties": {
-            "type": "string"
-          }
-        }
-      },
-      "required": [
-        "limit",
-        "set_variables"
-      ]
-    },
-    "Limit": {
-      "type": "object",
-      "properties": {
-        "conditions": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "max_value": {
-          "type": "integer",
-          "format": "int64"
-        },
-        "name": {
-          "type": "string"
-        },
-        "namespace": {
-          "type": "string"
-        },
-        "seconds": {
-          "type": "integer",
-          "format": "int64"
-        },
-        "variables": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        }
-      },
-      "required": [
-        "conditions",
-        "max_value",
-        "namespace",
-        "seconds",
-        "variables"
-      ]
-    }
-  },
-  "paths": {
-    "/check": {
-      "post": {
-        "responses": {
-          "200": {
-            "description": "OK",
-            "schema": {}
-          },
-          "429": {
-            "description": "Too Many Requests"
-          },
-          "500": {
-            "description": "Internal Server Error"
-          }
-        },
-        "parameters": [
-          {
-            "in": "body",
-            "name": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/CheckAndReportInfo"
-            }
-          }
-        ]
-      }
-    },
-    "/check_and_report": {
-      "post": {
-        "responses": {
-          "200": {
-            "description": "OK",
-            "schema": {}
-          },
-          "429": {
-            "description": "Too Many Requests"
-          },
-          "500": {
-            "description": "Internal Server Error"
-          }
-        },
-        "parameters": [
-          {
-            "in": "body",
-            "name": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/CheckAndReportInfo"
-            }
-          }
-        ]
-      }
-    },
-    "/counters/{namespace}": {
-      "get": {
-        "responses": {
-          "200": {
-            "description": "OK",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Counter"
-              }
-            }
-          },
-          "429": {
-            "description": "Too Many Requests"
-          },
-          "500": {
-            "description": "Internal Server Error"
-          }
-        },
-        "parameters": [
-          {
-            "in": "path",
-            "name": "namespace",
-            "required": true,
-            "type": "string"
-          }
-        ]
-      }
-    },
-    "/limits/{namespace}": {
-      "get": {
-        "responses": {
-          "200": {
-            "description": "OK",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Limit"
-              }
-            }
-          },
-          "429": {
-            "description": "Too Many Requests"
-          },
-          "500": {
-            "description": "Internal Server Error"
-          }
-        },
-        "parameters": [
-          {
-            "in": "path",
-            "name": "namespace",
-            "required": true,
-            "type": "string"
-          }
-        ]
-      },
-      "delete": {
-        "responses": {
-          "200": {
-            "description": "OK",
-            "schema": {}
-          },
-          "429": {
-            "description": "Too Many Requests"
-          },
-          "500": {
-            "description": "Internal Server Error"
-          }
-        },
-        "parameters": [
-          {
-            "in": "path",
-            "name": "namespace",
-            "required": true,
-            "type": "string"
-          }
-        ]
-      }
-    },
-    "/report": {
-      "post": {
-        "responses": {
-          "200": {
-            "description": "OK",
-            "schema": {}
-          },
-          "429": {
-            "description": "Too Many Requests"
-          },
-          "500": {
-            "description": "Internal Server Error"
-          }
-        },
-        "parameters": [
-          {
-            "in": "body",
-            "name": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/CheckAndReportInfo"
-            }
-          }
-        ]
-      }
-    },
-    "/status": {
-      "get": {
-        "responses": {
-          "200": {
-            "description": "OK",
-            "schema": {}
-          }
-        }
-      }
-    }
-  },
-  "info": {
-    "version": "1.0.0",
-    "title": "Limitador server endpoints"
-  }
-}
diff --git a/0.10.0/limitador/limitador-server/index.html b/0.10.0/limitador/limitador-server/index.html
deleted file mode 100644
index 805393e3c..000000000
--- a/0.10.0/limitador/limitador-server/index.html
+++ /dev/null
@@ -1,3501 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/limitador-server/">
-      
-      
-        <link rel="prev" href="../doc/topologies/">
-      
-      
-        <link rel="next" href="kubernetes/">
-      
-      
-      <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Overview - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#limitador-server" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Overview
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#limits-storage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limits storage
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#limits-storage" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limits storage
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/limitador-server/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="limitador-server">Limitador (server)<a class="headerlink" href="#limitador-server" title="Permanent link">&para;</a></h1>
-<p><a href="https://quay.io/repository/kuadrant/limitador"><img alt="Docker Repository on Quay" src="https://quay.io/repository/kuadrant/limitador/status" title="Docker Repository on Quay" /></a></p>
-<p>By default, Limitador starts the HTTP server in <code>localhost:8080</code>, and the grpc
-service that implements the Envoy Rate Limit protocol in <code>localhost:8081</code>. That
-can be configured with these ENVs: <code>ENVOY_RLS_HOST</code>, <code>ENVOY_RLS_PORT</code>,
-<code>HTTP_API_HOST</code>, and <code>HTTP_API_PORT</code>.</p>
-<p>Or using the command line arguments:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>Rate Limiting Server
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>Usage: limitador-server [OPTIONS] &lt;LIMITS_FILE&gt; [STORAGE]
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>STORAGES:
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>  memory        Counters are held in Limitador (ephemeral)
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>  disk          Counters are held on disk (persistent)
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>  redis         Uses Redis to store counters
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>  redis_cached  Uses Redis to store counters, with an in-memory cache
-</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>Arguments:
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>  &lt;LIMITS_FILE&gt;  The limit file to use
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>
-</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>Options:
-</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a>  -b, --rls-ip &lt;ip&gt;
-</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>          The IP to listen on for RLS [default: 0.0.0.0]
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>  -p, --rls-port &lt;port&gt;
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>          The port to listen on for RLS [default: 8081]
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>  -B, --http-ip &lt;http_ip&gt;
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>          The IP to listen on for HTTP [default: 0.0.0.0]
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>  -P, --http-port &lt;http_port&gt;
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a>          The port to listen on for HTTP [default: 8080]
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a>  -l, --limit-name-in-labels
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a>          Include the Limit Name in prometheus label
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a>  -v...
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a>          Sets the level of verbosity
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a>      --tracing-endpoint &lt;tracing_endpoint&gt;
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a>          The endpoint for the tracing service
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a>      --validate
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a>          Validates the LIMITS_FILE and exits
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a>  -H, --rate-limit-headers &lt;rate_limit_headers&gt;
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a>          Enables rate limit response headers [default: NONE] [possible values: NONE, DRAFT_VERSION_03]
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a>  -h, --help
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a>          Print help
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a>  -V, --version
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a>          Print version
-</span></code></pre></div>
-<p>When using environment variables, these will override the defaults. While environment variable are themselves
-overridden by the command line arguments provided. See the individual <code>STORAGES</code> help for more options relative to
-each of the storages.</p>
-<p>The OpenAPI spec of the HTTP service is
-<a href="docs/http_server_spec.json">here</a>.</p>
-<p>Limitador has to be started with a YAML file that has some limits defined.
-There's an <a href="https://github.com/Kuadrant/limitador/blob/main/limitador-server/examples/limits.yaml">example file</a> that allows 10 requests per minute and per <code>user_id</code> when the HTTP method is <code>"GET"</code> and 5 when it is a <code>"POST"</code>.
-You can run it with Docker (replace <code>latest</code> with the version you want):
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>docker<span class="w"> </span>run<span class="w"> </span>--rm<span class="w"> </span>--net<span class="o">=</span>host<span class="w"> </span>-it<span class="w"> </span>-v<span class="w"> </span><span class="k">$(</span><span class="nb">pwd</span><span class="k">)</span>/examples/limits.yaml:/home/limitador/my_limits.yaml:ro<span class="w"> </span>quay.io/kuadrant/limitador:latest<span class="w"> </span>limitador-server<span class="w"> </span>/home/limitador/my_limits.yaml
-</span></code></pre></div></p>
-<p>You can also use the YAML file when running locally:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>cargo<span class="w"> </span>run<span class="w"> </span>--release<span class="w"> </span>--bin<span class="w"> </span>limitador-server<span class="w"> </span>./examples/limits.yaml
-</span></code></pre></div></p>
-<p>If you want to use Limitador with Envoy, there's a minimal Envoy config for
-testing purposes <a href="https://github.com/Kuadrant/limitador/blob/main/limitador-server/examples/envoy.yaml">here</a>. The config
-forwards the "userid" header and the request method to Limitador. It assumes
-that there's an upstream API deployed on port 1323. You can use
-<a href="https://github.com/labstack/echo">echo</a>, for example.</p>
-<p>Limitador has several options that can be configured via ENV. This
-<a href="../doc/server/configuration/">doc</a> specifies them.</p>
-<h2 id="limits-storage">Limits storage<a class="headerlink" href="#limits-storage" title="Permanent link">&para;</a></h2>
-<p>Limitador can store its limits and counters in-memory, disk or in Redis. In-memory is
-faster, but the limits are applied per instance. When using Redis, multiple
-instances of Limitador can share the same limits, but it's slower.</p>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/centos-pod.yaml b/0.10.0/limitador/limitador-server/kubernetes/centos-pod.yaml
deleted file mode 100644
index 520c91f9b..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/centos-pod.yaml
+++ /dev/null
@@ -1,15 +0,0 @@
-apiVersion: v1
-kind: Pod
-metadata:
-  name: centos
-  labels:
-    app: centos
-spec:
-  containers:
-  - image: centos
-    command:
-      - "sleep"
-      - "604800"
-    imagePullPolicy: IfNotPresent
-    name: centos
-  restartPolicy: Always
diff --git a/0.10.0/limitador/limitador-server/kubernetes/index.html b/0.10.0/limitador/limitador-server/kubernetes/index.html
deleted file mode 100644
index 16a0bbf66..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/index.html
+++ /dev/null
@@ -1,3830 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/limitador-server/kubernetes/">
-      
-      
-        <link rel="prev" href="../">
-      
-      
-        <link rel="next" href="../sandbox/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Kubernetes - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#kubernetes" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Kubernetes
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#components" class="md-nav__link">
-    <span class="md-ellipsis">
-      Components
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Components">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#mandatory" class="md-nav__link">
-    <span class="md-ellipsis">
-      Mandatory
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional" class="md-nav__link">
-    <span class="md-ellipsis">
-      Optional
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#k8s-deployment" class="md-nav__link">
-    <span class="md-ellipsis">
-      K8s deployment
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#monitoring" class="md-nav__link">
-    <span class="md-ellipsis">
-      Monitoring
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Monitoring">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prometheus" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prometheus
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#grafana-dashboard" class="md-nav__link">
-    <span class="md-ellipsis">
-      Grafana dashboard
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#benchmarking" class="md-nav__link">
-    <span class="md-ellipsis">
-      Benchmarking
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#components" class="md-nav__link">
-    <span class="md-ellipsis">
-      Components
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Components">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#mandatory" class="md-nav__link">
-    <span class="md-ellipsis">
-      Mandatory
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#optional" class="md-nav__link">
-    <span class="md-ellipsis">
-      Optional
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#k8s-deployment" class="md-nav__link">
-    <span class="md-ellipsis">
-      K8s deployment
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#monitoring" class="md-nav__link">
-    <span class="md-ellipsis">
-      Monitoring
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Monitoring">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#prometheus" class="md-nav__link">
-    <span class="md-ellipsis">
-      Prometheus
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#grafana-dashboard" class="md-nav__link">
-    <span class="md-ellipsis">
-      Grafana dashboard
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#benchmarking" class="md-nav__link">
-    <span class="md-ellipsis">
-      Benchmarking
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/limitador-server/kubernetes/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="kubernetes">Kubernetes<a class="headerlink" href="#kubernetes" title="Permanent link">&para;</a></h1>
-<p>The purpose of this documentation is to deploy a sample application published via AWS ELB, that will be ratelimited at infrastructure level, thanks to the use the envoyproxy sidecar container, that will be in charge of contacting to a  ratelimit service (limitador), that will allow the request (or not) if it is within the permitted  limits.</p>
-<p>There are mainly two recommended way of using limitador in kubernetes:</p>
-<ol>
-<li>There is an ingress based on envoyproxy that contacts with limitador ratelimit service before forwarding (or not) the request to the application</li>
-<li>There is an envoyproxy sidecar container living in the application pod that contacts with limitador ratelimit service before forwarding (or not) the request to the main application container in the same pod</li>
-</ol>
-<p>In this example it will be described the second scenario (where there is an application with an envoyproxy sidecar container contacting to limitador service).</p>
-<blockquote>
-<p><strong>NOTE</strong>
-<br /> If you don't want to manually manage the sidecar container definitions on your deployments (harcoding the container spec, loading the envoy configuration from a configmap that requires a pod restart to reload possibles configuration changes...), you can use <a href="https://github.com/3scale/marin3r">marin3r</a>, a light weight envoy control plane that allows you to inject envoyproxy sidecar containers and dynamically consume configs from Kubernetes custom resources.</p>
-</blockquote>
-<p>This is the network diagram of the deployed example:</p>
-<p><img alt="Ratelimit" src="ratelimit.svg" /></p>
-<h2 id="components">Components<a class="headerlink" href="#components" title="Permanent link">&para;</a></h2>
-<p>In order to that that ratelimit test, you need to deploy a few components. Some of them are mandatory, and a few are optional:</p>
-<h3 id="mandatory">Mandatory<a class="headerlink" href="#mandatory" title="Permanent link">&para;</a></h3>
-<ul>
-<li>Application (a sample application deployment called <code>kuard</code>):</li>
-<li>App has an <code>envoyproxy</code> sidecar container with its configuration file in a configmap, composed by:<ul>
-<li>Cluster <code>kuard</code> points to main application container (<code>127.0.0.1:8080</code>)</li>
-<li>Cluster <code>kuard_ratelimit</code> points to limitador headless service (<code>limitador:8081</code>)</li>
-<li>Listener HTTP points to envoyproxy sidecar (<code>0.0.0.0:38080</code>)</li>
-<li>When envoy contacts with the ratelimit service, you can define a timeout, and if there is no response within that timeout (because ratelimit is overloaded taking more time to process the request, or because rateliit service is down), you can choose from envoy to deny the request or pass it to the application. In this case, there is set a 1s timeout, and if there is no answer in this 1 second, request is passed to the application (<code>failure_mode_deny: false</code>), so we guarantee that the maximum overhead added by a non working ratelimit service is 1 extra second to the final response time.</li>
-</ul>
-</li>
-<li>
-<p>App service published with <code>type: LoadBalancer</code>, which creates a AWS ELB. This service has an annotation to enable proxy protocol on the AWS Load balancer in order to be able to keep the real client IP at envoy level (instead of the k8s node private IP), so it can be used to ratelimit per each real client IP if desired.</p>
-</li>
-<li>
-<p>Ratelimit application (a deployment called <code>limitador</code>):</p>
-</li>
-<li>Limitador Configmap with limits definition (1000 rps per hostname).</li>
-<li>
-<p>Limitador headless service published on <code>limitador:8081</code>. It is important to use a headless service in order to balance correctly the traffic between limitador pods, otherwise GRPC connections are not well balanced.</p>
-</li>
-<li>
-<p>Redis database to persist ratelimit configuration:</p>
-</li>
-<li>Redis service</li>
-<li>Redis statefulset with a persistent volume</li>
-</ul>
-<h3 id="optional">Optional<a class="headerlink" href="#optional" title="Permanent link">&para;</a></h3>
-<ul>
-<li>Centos pod:</li>
-<li>Used to executed <code>hey</code> tool benchmarks from the cluster, so we ensure network latency does not affect the results. Actually, to achieve better results, this pod should be on another cluster (to not share the network between client and network) and be placed on the same Region (to reduce latency). The client could be a bottle neck for the performance test.</li>
-<li>This centos is going to public AWS ELB to access the app, so simulating it is a normal client from the same Region</li>
-<li>Prometheus monitoring and grafana dashboard resources</li>
-</ul>
-<h2 id="k8s-deployment">K8s deployment<a class="headerlink" href="#k8s-deployment" title="Permanent link">&para;</a></h2>
-<ul>
-<li>
-<p>Deploy the redis instance that will keep the limits for different limitador pods:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>redis-service.yaml
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>redis-statefulset.yaml
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Deploy limitador application. It is important to create the configmap with limitador limits before the deployment, in order to load it from limitador pods. At the moment, if you update the limits configmap you need to restart the pods. Additionally, limitador has an API in order to load limits dynamically, but for simplicity for this test a configmap has been used:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>limitador-config-configmap.yaml
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>limitador-service.yaml
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>limitador-deployment.yaml
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Deploy sample kuard application with the envoyproxy sidecar container (if you do any change on the envoy configmap, remember you need to restart app pods in order to reload the config):
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>kuard-envoy-config-configmap.yaml
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>kuard-service.yaml
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>kuard-deployment.yaml
-</span></code></pre></div></p>
-</li>
-<li>
-<p>At this point you shoud see all pods running, and kuard pods should have 2 containers (the main  kuard container, and the envoyproxy sidecar container):
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>▶<span class="w"> </span>kubectl<span class="w"> </span>get<span class="w"> </span>pods
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>NAME<span class="w">                         </span>READY<span class="w">   </span>STATUS<span class="w">    </span>RESTARTS<span class="w">   </span>AGE
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a>kuard-f859bb896-gmzxn<span class="w">        </span><span class="m">2</span>/2<span class="w">     </span>Running<span class="w">   </span><span class="m">0</span><span class="w">          </span>7m
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a>kuard-f859bb896-z95w8<span class="w">        </span><span class="m">2</span>/2<span class="w">     </span>Running<span class="w">   </span><span class="m">0</span><span class="w">          </span>7m
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>limitador-68d494f54c-qv996<span class="w">   </span><span class="m">1</span>/1<span class="w">     </span>Running<span class="w">   </span><span class="m">0</span><span class="w">          </span>8m
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a>limitador-68d494f54c-zzmhn<span class="w">   </span><span class="m">1</span>/1<span class="w">     </span>Running<span class="w">   </span><span class="m">0</span><span class="w">          </span>8m
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a>redis-0<span class="w">                      </span><span class="m">1</span>/1<span class="w">     </span>Running<span class="w">   </span><span class="m">0</span><span class="w">          </span>9m
-</span></code></pre></div></p>
-</li>
-<li>
-<p>Now you should be able to access to kuard application using the load balancer DNS name:
-<div class="language-text highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>▶ kubectl get service kuard
-</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>NAME    TYPE           CLUSTER-IP       EXTERNAL-IP                                                              PORT(S)        AGE
-</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>kuard   LoadBalancer   172.30.117.198   a96d5449fbc3f4cd892e15e5b36cde48-457963259.us-east-1.elb.amazonaws.com   80:31450/TCP   4m
-</span></code></pre></div></p>
-</li>
-<li>
-<p>If you go to the browser and paste the <code>EXTERNAL-IP</code>, your request will follow the next workflow:</p>
-</li>
-<li>The requests will go from your local machine through internet to the public AWS ELB where the app is published</li>
-<li>Then it will go to the <code>NodePort</code> of your k8s cluster nodes</li>
-<li>Once on a k8s node, it will go to kuard <code>Service</code> Virtual IP, and will arrive to an envoyproxy sidecar container inside kuard pod</li>
-<li>Envoyproxy sidecar container will contact with limitador headless <code>Service</code>, to authorize the requests or not:<ul>
-<li>If the request is authorized (within the configured limits), it will send the request to the app container (<code>0.0.0.0:8080</code>) in the same pod, and request will end up with a <code>HTTP 200</code> response</li>
-<li>If the request is limited (beyond the limits), request will end up with <code>HTTP 429</code> response</li>
-</ul>
-</li>
-</ul>
-<h2 id="monitoring">Monitoring<a class="headerlink" href="#monitoring" title="Permanent link">&para;</a></h2>
-<p>Both <code>envoyproxy</code> sidecar and <code>limitador</code> applications include built-in prometheus metrics.</p>
-<h3 id="prometheus">Prometheus<a class="headerlink" href="#prometheus" title="Permanent link">&para;</a></h3>
-<p>In order to scrape that metrics within a prometheus-operator deployed in the cluster, you need to create a <code>PodMonitor</code> resource for every application:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>kuard-podmonitor.yaml
-</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>limitador-podmonitor.yaml
-</span></code></pre></div></p>
-<h3 id="grafana-dashboard">Grafana dashboard<a class="headerlink" href="#grafana-dashboard" title="Permanent link">&para;</a></h3>
-<p>Then, if you have grafana deployed in the cluster, you can import a <a href="limitador-grafanadashboard.json">Kuadrant Limitador</a> grafana dashboard that we have prepared, which includes:</p>
-<ul>
-<li>Kuard envoyproxy sidecar metrics (globally and per pod)</li>
-<li>Limitador metrics (globally and per pod)</li>
-<li>And for every deployed component (limitador, kuard, redis):</li>
-<li>Number of pods (total, available, unavaible, pod restarts...)</li>
-<li>CPU usage per pod</li>
-<li>Memory usage per pod</li>
-<li>Network usage per pod</li>
-</ul>
-<h2 id="benchmarking">Benchmarking<a class="headerlink" href="#benchmarking" title="Permanent link">&para;</a></h2>
-<ul>
-<li>In order to check that the ratelimit is working as expected, you can use any benchmarking tool, like <a href="https://github.com/rakyll/hey">hey</a></li>
-<li>You can use if you want a centos pod (better to create it on a different custer within the same Region):
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>kubectl<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>centos-pod.yaml
-</span></code></pre></div></li>
-<li>Connect to centos pod:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>kubectl<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>--stdin<span class="w"> </span>--tty<span class="w"> </span>centos<span class="w"> </span>--<span class="w"> </span>/bin/bash
-</span></code></pre></div></li>
-<li>And install <code>hey</code> with:
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="o">[</span>root@centos<span class="w"> </span>/<span class="o">]</span><span class="c1"># curl -sf https://gobinaries.com/rakyll/hey | sh</span>
-</span></code></pre></div></li>
-<li>Now you can execute the benchmark using the following escenario:</li>
-</ul>
-<table>
-<thead>
-<tr>
-<th style="text-align: center;">Item</th>
-<th style="text-align: center;">Value</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td style="text-align: center;">Target</td>
-<td style="text-align: center;">AWS ELB DNS Name</td>
-</tr>
-<tr>
-<td style="text-align: center;">App pods</td>
-<td style="text-align: center;">2</td>
-</tr>
-<tr>
-<td style="text-align: center;">Limitador pods</td>
-<td style="text-align: center;">2</td>
-</tr>
-<tr>
-<td style="text-align: center;">Limits</td>
-<td style="text-align: center;">1.000 rps per hostname</td>
-</tr>
-<tr>
-<td style="text-align: center;">Hey duration</td>
-<td style="text-align: center;">1 minute</td>
-</tr>
-<tr>
-<td style="text-align: center;">Hey Traffic</td>
-<td style="text-align: center;">-c 60 -q 20 (around 1.200 rps)</td>
-</tr>
-</tbody>
-</table>
-<ul>
-<li>Theoretically:</li>
-<li>It should let pass 1.000 requests, and limit 200 requests per second</li>
-<li>It should let pass 60 * 1.000 = 60.0000 requests, and limit 60 * 200 = 12.000 requests per minute</li>
-<li>Each limitador pod should handle half of the traffic (500 rps OK, and 200 rps limited)</li>
-</ul>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="o">[</span>root@centos<span class="w"> </span>/<span class="o">]</span><span class="c1"># hey -z 60s -c 60 -q 20 &quot;http://a96d5449fbc3f4cd892e15e5b36cde48-457963259.us-east-1.elb.amazonaws.com&quot;</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>Summary:
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w">  </span>Total:<span class="w">    </span><span class="m">60</span>.0131<span class="w"> </span>secs
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w">  </span>Slowest:<span class="w">  </span><span class="m">0</span>.1028<span class="w"> </span>secs
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w">  </span>Fastest:<span class="w">  </span><span class="m">0</span>.0023<span class="w"> </span>secs
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w">  </span>Average:<span class="w">  </span><span class="m">0</span>.0075<span class="w"> </span>secs
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w">  </span>Requests/sec:<span class="w"> </span><span class="m">1199</span>.3721
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="w">  </span>Total<span class="w"> </span>data:<span class="w">   </span><span class="m">106581650</span><span class="w"> </span>bytes
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="w">  </span>Size/request:<span class="w"> </span><span class="m">1480</span><span class="w"> </span>bytes
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a>Response<span class="w"> </span><span class="nb">time</span><span class="w"> </span>histogram:
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="w">  </span><span class="m">0</span>.002<span class="w"> </span><span class="o">[</span><span class="m">1</span><span class="o">]</span><span class="w"> </span><span class="p">|</span>
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a><span class="w">  </span><span class="m">0</span>.012<span class="w"> </span><span class="o">[</span><span class="m">70626</span><span class="o">]</span><span class="w"> </span><span class="p">|</span>■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a><span class="w">  </span><span class="m">0</span>.022<span class="w"> </span><span class="o">[</span><span class="m">1291</span><span class="o">]</span><span class="w">  </span><span class="p">|</span>■
-</span><span id="__span-9-17"><a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a><span class="w">  </span><span class="m">0</span>.032<span class="w"> </span><span class="o">[</span><span class="m">0</span><span class="o">]</span><span class="w"> </span><span class="p">|</span>
-</span><span id="__span-9-18"><a id="__codelineno-9-18" name="__codelineno-9-18" href="#__codelineno-9-18"></a><span class="w">  </span><span class="m">0</span>.043<span class="w"> </span><span class="o">[</span><span class="m">0</span><span class="o">]</span><span class="w"> </span><span class="p">|</span>
-</span><span id="__span-9-19"><a id="__codelineno-9-19" name="__codelineno-9-19" href="#__codelineno-9-19"></a><span class="w">  </span><span class="m">0</span>.053<span class="w"> </span><span class="o">[</span><span class="m">0</span><span class="o">]</span><span class="w"> </span><span class="p">|</span>
-</span><span id="__span-9-20"><a id="__codelineno-9-20" name="__codelineno-9-20" href="#__codelineno-9-20"></a><span class="w">  </span><span class="m">0</span>.063<span class="w"> </span><span class="o">[</span><span class="m">0</span><span class="o">]</span><span class="w"> </span><span class="p">|</span>
-</span><span id="__span-9-21"><a id="__codelineno-9-21" name="__codelineno-9-21" href="#__codelineno-9-21"></a><span class="w">  </span><span class="m">0</span>.073<span class="w"> </span><span class="o">[</span><span class="m">0</span><span class="o">]</span><span class="w"> </span><span class="p">|</span>
-</span><span id="__span-9-22"><a id="__codelineno-9-22" name="__codelineno-9-22" href="#__codelineno-9-22"></a><span class="w">  </span><span class="m">0</span>.083<span class="w"> </span><span class="o">[</span><span class="m">0</span><span class="o">]</span><span class="w"> </span><span class="p">|</span>
-</span><span id="__span-9-23"><a id="__codelineno-9-23" name="__codelineno-9-23" href="#__codelineno-9-23"></a><span class="w">  </span><span class="m">0</span>.093<span class="w"> </span><span class="o">[</span><span class="m">23</span><span class="o">]</span><span class="w">    </span><span class="p">|</span>
-</span><span id="__span-9-24"><a id="__codelineno-9-24" name="__codelineno-9-24" href="#__codelineno-9-24"></a><span class="w">  </span><span class="m">0</span>.103<span class="w"> </span><span class="o">[</span><span class="m">37</span><span class="o">]</span><span class="w">    </span><span class="p">|</span>
-</span><span id="__span-9-25"><a id="__codelineno-9-25" name="__codelineno-9-25" href="#__codelineno-9-25"></a>
-</span><span id="__span-9-26"><a id="__codelineno-9-26" name="__codelineno-9-26" href="#__codelineno-9-26"></a>
-</span><span id="__span-9-27"><a id="__codelineno-9-27" name="__codelineno-9-27" href="#__codelineno-9-27"></a>Latency<span class="w"> </span>distribution:
-</span><span id="__span-9-28"><a id="__codelineno-9-28" name="__codelineno-9-28" href="#__codelineno-9-28"></a><span class="w">  </span><span class="m">10</span>%<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="m">0</span>.0053<span class="w"> </span>secs
-</span><span id="__span-9-29"><a id="__codelineno-9-29" name="__codelineno-9-29" href="#__codelineno-9-29"></a><span class="w">  </span><span class="m">25</span>%<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="m">0</span>.0063<span class="w"> </span>secs
-</span><span id="__span-9-30"><a id="__codelineno-9-30" name="__codelineno-9-30" href="#__codelineno-9-30"></a><span class="w">  </span><span class="m">50</span>%<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="m">0</span>.0073<span class="w"> </span>secs
-</span><span id="__span-9-31"><a id="__codelineno-9-31" name="__codelineno-9-31" href="#__codelineno-9-31"></a><span class="w">  </span><span class="m">75</span>%<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="m">0</span>.0085<span class="w"> </span>secs
-</span><span id="__span-9-32"><a id="__codelineno-9-32" name="__codelineno-9-32" href="#__codelineno-9-32"></a><span class="w">  </span><span class="m">90</span>%<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="m">0</span>.0096<span class="w"> </span>secs
-</span><span id="__span-9-33"><a id="__codelineno-9-33" name="__codelineno-9-33" href="#__codelineno-9-33"></a><span class="w">  </span><span class="m">95</span>%<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="m">0</span>.0102<span class="w"> </span>secs
-</span><span id="__span-9-34"><a id="__codelineno-9-34" name="__codelineno-9-34" href="#__codelineno-9-34"></a><span class="w">  </span><span class="m">99</span>%<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="m">0</span>.0139<span class="w"> </span>secs
-</span><span id="__span-9-35"><a id="__codelineno-9-35" name="__codelineno-9-35" href="#__codelineno-9-35"></a>
-</span><span id="__span-9-36"><a id="__codelineno-9-36" name="__codelineno-9-36" href="#__codelineno-9-36"></a>Details<span class="w"> </span><span class="o">(</span>average,<span class="w"> </span>fastest,<span class="w"> </span>slowest<span class="o">)</span>:
-</span><span id="__span-9-37"><a id="__codelineno-9-37" name="__codelineno-9-37" href="#__codelineno-9-37"></a><span class="w">  </span>DNS+dialup:<span class="w">   </span><span class="m">0</span>.0001<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0023<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.1028<span class="w"> </span>secs
-</span><span id="__span-9-38"><a id="__codelineno-9-38" name="__codelineno-9-38" href="#__codelineno-9-38"></a><span class="w">  </span>DNS-lookup:<span class="w">   </span><span class="m">0</span>.0001<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0000<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0711<span class="w"> </span>secs
-</span><span id="__span-9-39"><a id="__codelineno-9-39" name="__codelineno-9-39" href="#__codelineno-9-39"></a><span class="w">  </span>req<span class="w"> </span>write:<span class="w">    </span><span class="m">0</span>.0000<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0000<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0014<span class="w"> </span>secs
-</span><span id="__span-9-40"><a id="__codelineno-9-40" name="__codelineno-9-40" href="#__codelineno-9-40"></a><span class="w">  </span>resp<span class="w"> </span>wait:<span class="w">    </span><span class="m">0</span>.0074<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0023<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0303<span class="w"> </span>secs
-</span><span id="__span-9-41"><a id="__codelineno-9-41" name="__codelineno-9-41" href="#__codelineno-9-41"></a><span class="w">  </span>resp<span class="w"> </span>read:<span class="w">    </span><span class="m">0</span>.0000<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0000<span class="w"> </span>secs,<span class="w"> </span><span class="m">0</span>.0049<span class="w"> </span>secs
-</span><span id="__span-9-42"><a id="__codelineno-9-42" name="__codelineno-9-42" href="#__codelineno-9-42"></a>
-</span><span id="__span-9-43"><a id="__codelineno-9-43" name="__codelineno-9-43" href="#__codelineno-9-43"></a>Status<span class="w"> </span>code<span class="w"> </span>distribution:
-</span><span id="__span-9-44"><a id="__codelineno-9-44" name="__codelineno-9-44" href="#__codelineno-9-44"></a><span class="w">  </span><span class="o">[</span><span class="m">200</span><span class="o">]</span><span class="w"> </span><span class="m">60046</span><span class="w"> </span>responses
-</span><span id="__span-9-45"><a id="__codelineno-9-45" name="__codelineno-9-45" href="#__codelineno-9-45"></a><span class="w">  </span><span class="o">[</span><span class="m">429</span><span class="o">]</span><span class="w"> </span><span class="m">11932</span><span class="w"> </span>responses
-</span></code></pre></div>
-<ul>
-<li>
-<p>We can see that:</p>
-<ul>
-<li>Client could send 1192.2171rps (about 1200rps)</li>
-<li>60046 requests (about 60000) were OK (HTTP 200)</li>
-<li>11932 requests (about 12000) were limited (HTTP 429)</li>
-<li>Average latency (since the request goes out from the client to AWS ELB, k8s node, envoyproxy container, limitador+redis, kuar app container) is 10ms</li>
-</ul>
-</li>
-<li>
-<p>In addition, if we do a longer test with 5 minutes traffic for example, you can check with the grafana dashboard how these requests are processed by envoyproxy sidecar container of kuard pods and limitador pods:</p>
-<ul>
-<li><strong>Kuard Envoyproxy Sidecar Metrics</strong>:<ul>
-<li>Globally it handles around 1200rps: it permits around 1krps and limits around 200rps  </li>
-<li>Each envoyproxy sidecar of each kuard pod handles around half of the traffic: it permits around 500rps and limits around 100rps. The balance between pods is not 100% perfect, caused by random iptables forwarding when using a k8s service
- <img alt="Kuard Envoyproxy Sidecar Metrics" src="kuard-envoyproxy-sidecar-metrics-dashboard-screenshot.png" /></li>
-</ul>
-</li>
-<li><strong>Limitador Metrics</strong>:<ul>
-<li>Globally it handles around 1200rps: it permits around 1krps and limits around 200rps  </li>
-<li>Each limitador pod handles around half of the traffic: it permits around 500rps and limits around 100rps. The balance between pods is perfect thanks to using a headless service with GRPC connections
- <img alt="Limitador Metrics" src="limitador-metrics-dashboard-screenshot.png" /></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/kuard-deployment.yaml b/0.10.0/limitador/limitador-server/kubernetes/kuard-deployment.yaml
deleted file mode 100644
index d9c152020..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/kuard-deployment.yaml
+++ /dev/null
@@ -1,42 +0,0 @@
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: kuard
-  labels:
-    app: kuard
-spec:
-  replicas: 2
-  selector:
-    matchLabels:
-      app: kuard
-  template:
-    metadata:
-      labels:
-        app: kuard
-    spec:
-      containers:
-        - name: kuard
-          image: gcr.io/kuar-demo/kuard-amd64:blue
-          ports:
-            - containerPort: 8080
-              name: http
-              protocol: TCP
-        - name: envoy
-          image: envoyproxy/envoy:v1.16.0
-          command: ["envoy"]
-          args: ["-c", "/etc/envoy.yaml", "--service-node", "kuard", "--service-cluster", "kuard"]
-          ports:
-            - name: envoy-http
-              containerPort: 38080
-              protocol: TCP
-            - name: envoy-metrics
-              containerPort: 9901
-              protocol: TCP
-          volumeMounts:
-          - name: kuard-envoy-config
-            mountPath: /etc/envoy.yaml
-            subPath: envoy.yaml
-      volumes:
-        - name: kuard-envoy-config
-          configMap:
-            name: kuard-envoy-config
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/kuard-envoy-config-configmap.yaml b/0.10.0/limitador/limitador-server/kubernetes/kuard-envoy-config-configmap.yaml
deleted file mode 100644
index 120574aa8..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/kuard-envoy-config-configmap.yaml
+++ /dev/null
@@ -1,84 +0,0 @@
-apiVersion: v1
-kind: ConfigMap
-metadata:
-  name: kuard-envoy-config
-  labels:
-    app: kuard
-data:
-  envoy.yaml: >
-    static_resources:
-      clusters:
-        - name: kuard
-          connect_timeout: 2s
-          type: STRICT_DNS
-          dns_lookup_family: V4_ONLY
-          lb_policy: ROUND_ROBIN
-          load_assignment:
-            cluster_name: kuard
-            endpoints:
-              - lb_endpoints:
-                  - endpoint:
-                      address:
-                        socket_address: { address: 127.0.0.1, port_value: 8080 }
-        - name: kuard_ratelimit
-          type: STRICT_DNS
-          connect_timeout: 1s
-          dns_lookup_family: V4_ONLY
-          lb_policy: ROUND_ROBIN
-          http2_protocol_options: {}
-          load_assignment:
-            cluster_name: kuard_ratelimit
-            endpoints:
-              - lb_endpoints:
-                  - endpoint:
-                      address:
-                        socket_address: { address: limitador, port_value: 8081 }
-      listeners:
-        - name: http
-          address:
-            socket_address:
-              address: 0.0.0.0
-              port_value: 38080
-          filter_chains:
-            - use_proxy_proto: true
-              filters:
-                - name: envoy.filters.network.http_connection_manager
-                  typed_config:
-                    "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
-                    use_remote_address: true
-                    access_log:
-                      - name: envoy.access_loggers.file
-                        typed_config:
-                          "@type": type.googleapis.com/envoy.extensions.access_loggers.file.v3.FileAccessLog
-                          path: "/dev/stdout"
-                    stat_prefix: http
-                    route_config:
-                      name: local_route
-                      virtual_hosts:
-                        - name: kuard
-                          domains: ["*"]
-                          routes:
-                            - { route: { cluster: kuard }, match: { prefix: "/" } }
-                          rate_limits:
-                            - actions:
-                                - request_headers:
-                                    header_name: :authority
-                                    descriptor_key: per_hostname_per_second_burst
-                    http_filters:
-                      - name: envoy.filters.http.ratelimit
-                        typed_config:
-                          "@type": "type.googleapis.com/envoy.extensions.filters.http.ratelimit.v3.RateLimit"
-                          domain: kuard
-                          failure_mode_deny: false
-                          timeout: 1s
-                          rate_limit_service:
-                            transport_api_version: V3
-                            grpc_service:
-                              { envoy_grpc: { cluster_name: kuard_ratelimit } }
-                      - name: envoy.filters.http.router
-    admin:
-      access_log_path: /dev/stdout
-      address:
-        socket_address:
-          address: 0.0.0.0
-          port_value: 9901
diff --git a/0.10.0/limitador/limitador-server/kubernetes/kuard-envoyproxy-sidecar-metrics-dashboard-screenshot.png b/0.10.0/limitador/limitador-server/kubernetes/kuard-envoyproxy-sidecar-metrics-dashboard-screenshot.png
deleted file mode 100644
index 0c85cc99a35ad456fd8fa895e94ad27491e4b161..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 80203
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
MAND&`eK7R$Z-lDX?*IS*

diff --git a/0.10.0/limitador/limitador-server/kubernetes/kuard-podmonitor.yaml b/0.10.0/limitador/limitador-server/kubernetes/kuard-podmonitor.yaml
deleted file mode 100644
index 631edef16..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/kuard-podmonitor.yaml
+++ /dev/null
@@ -1,15 +0,0 @@
-apiVersion: monitoring.coreos.com/v1
-kind: PodMonitor
-metadata:
-  name: kuard
-  labels:
-    app: kuard
-spec:
-  podMetricsEndpoints:
-    - interval: 10s
-      path: /stats/prometheus
-      port: envoy-metrics
-      scheme: http
-  selector:
-    matchLabels:
-      app: kuard
diff --git a/0.10.0/limitador/limitador-server/kubernetes/kuard-service.yaml b/0.10.0/limitador/limitador-server/kubernetes/kuard-service.yaml
deleted file mode 100644
index c53350507..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/kuard-service.yaml
+++ /dev/null
@@ -1,16 +0,0 @@
-apiVersion: v1
-kind: Service
-metadata:
-  name: kuard
-  labels:
-    app: kuard
-  annotations:
-    service.beta.kubernetes.io/aws-load-balancer-proxy-protocol: "*"
-spec:
-  type: LoadBalancer
-  ports:
-    - name: envoy-http
-      port: 80
-      targetPort: envoy-http
-  selector:
-    app: kuard
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/limitador-config-configmap.yaml b/0.10.0/limitador/limitador-server/kubernetes/limitador-config-configmap.yaml
deleted file mode 100644
index a14318c29..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/limitador-config-configmap.yaml
+++ /dev/null
@@ -1,16 +0,0 @@
-apiVersion: v1
-kind: ConfigMap
-metadata:
-  name: limitador-config
-  labels:
-    app: limitador
-data:
-  limits.yaml: |
-    ---
-    -
-      namespace: kuard
-      max_value: 1000
-      seconds: 1
-      conditions: []
-      variables:
-        - per_hostname_per_second_burst
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/limitador-deployment.yaml b/0.10.0/limitador/limitador-server/kubernetes/limitador-deployment.yaml
deleted file mode 100644
index 0b236b665..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/limitador-deployment.yaml
+++ /dev/null
@@ -1,62 +0,0 @@
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: limitador
-  labels:
-    app: limitador
-spec:
-  replicas: 2
-  selector:
-    matchLabels:
-      app: limitador
-  template:
-    metadata:
-      labels:
-        app: limitador
-    spec:
-      containers:
-        - name: limitador
-          image: quay.io/kuadrant/limitador:latest
-          imagePullPolicy: IfNotPresent
-          env:
-            - name: RUST_LOG
-              value: info
-            - name: REDIS_URL
-              value: "redis://redis:6379"
-            - name: LIMITS_FILE
-              value: /home/limitador/limits.yaml
-          ports:
-            - name: http
-              containerPort: 8080
-              protocol: TCP
-            - name: grpc
-              containerPort: 8081
-              protocol: TCP
-          livenessProbe:
-            httpGet:
-              path: /status
-              port: http
-              scheme: HTTP
-            initialDelaySeconds: 5
-            timeoutSeconds: 2
-            periodSeconds: 10
-            successThreshold: 1
-            failureThreshold: 3
-          readinessProbe:
-            httpGet:
-              path: /status
-              port: http
-              scheme: HTTP
-            initialDelaySeconds: 5
-            timeoutSeconds: 5
-            periodSeconds: 10
-            successThreshold: 1
-            failureThreshold: 3
-          volumeMounts:
-            - mountPath: /home/limitador/limits.yaml
-              name: runtime-config
-              subPath: limits.yaml
-      volumes:
-        - name: runtime-config
-          configMap:
-            name: limitador-config
diff --git a/0.10.0/limitador/limitador-server/kubernetes/limitador-grafanadashboard.json b/0.10.0/limitador/limitador-server/kubernetes/limitador-grafanadashboard.json
deleted file mode 100644
index f0f3b9f12..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/limitador-grafanadashboard.json
+++ /dev/null
@@ -1,2154 +0,0 @@
-{
-  "annotations": {
-    "list": [
-      {
-        "builtIn": 1,
-        "datasource": "-- Grafana --",
-        "enable": true,
-        "hide": true,
-        "iconColor": "rgba(0, 211, 255, 1)",
-        "name": "Annotations & Alerts",
-        "type": "dashboard"
-      }
-    ]
-  },
-  "editable": true,
-  "gnetId": null,
-  "graphTooltip": 0,
-  "id": 28,
-  "iteration": 1604592740368,
-  "links": [],
-  "panels": [
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 0
-      },
-      "id": 67,
-      "panels": [],
-      "title": "Kuard Envoyproxy Sidecar metrics",
-      "type": "row"
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 9,
-        "w": 24,
-        "x": 0,
-        "y": 1
-      },
-      "id": 39,
-      "interval": "",
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null",
-      "options": {},
-      "percentage": false,
-      "pointradius": 2,
-      "points": false,
-      "renderer": "flot",
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(rate(envoy_cluster_ratelimit_ok{namespace=\"$namespace\", envoy_cluster_name=\"$limitador_namespace\"}[1m]))",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 1,
-          "legendFormat": "ok",
-          "refId": "A"
-        },
-        {
-          "expr": "sum(rate(envoy_cluster_ratelimit_over_limit{namespace=\"$namespace\", envoy_cluster_name=\"$limitador_namespace\"}[1m]))",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 1,
-          "legendFormat": "overlimit",
-          "refId": "B"
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Requests per second (global)",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "decimals": 0,
-          "format": "reqps",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 9,
-        "w": 24,
-        "x": 0,
-        "y": 10
-      },
-      "id": 65,
-      "interval": "",
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null",
-      "options": {},
-      "percentage": false,
-      "pointradius": 2,
-      "points": false,
-      "renderer": "flot",
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(rate(envoy_cluster_ratelimit_ok{namespace=\"$namespace\", envoy_cluster_name=\"$limitador_namespace\"}[1m])) by (pod)",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 1,
-          "legendFormat": "{{ pod }}-ok",
-          "refId": "A"
-        },
-        {
-          "expr": "sum(rate(envoy_cluster_ratelimit_over_limit{namespace=\"$namespace\", envoy_cluster_name=\"$limitador_namespace\"}[1m])) by (pod)",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 1,
-          "legendFormat": "{{ pod }}-over-limit",
-          "refId": "B"
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Requests per second (per pod)",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "decimals": 0,
-          "format": "reqps",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 19
-      },
-      "id": 20,
-      "panels": [],
-      "title": "Limitador metrics",
-      "type": "row"
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 9,
-        "w": 24,
-        "x": 0,
-        "y": 20
-      },
-      "id": 68,
-      "interval": "",
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null",
-      "options": {},
-      "percentage": false,
-      "pointradius": 2,
-      "points": false,
-      "renderer": "flot",
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(rate(authorized_calls{namespace=\"$namespace\", limitador_namespace=\"$limitador_namespace\"}[1m]))",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 1,
-          "legendFormat": "authorized",
-          "refId": "A"
-        },
-        {
-          "expr": "sum(rate(limited_calls{namespace=\"$namespace\", limitador_namespace=\"$limitador_namespace\"}[1m]))",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 1,
-          "legendFormat": "limited",
-          "refId": "B"
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Requests per second (global)",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "decimals": 0,
-          "format": "reqps",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 9,
-        "w": 24,
-        "x": 0,
-        "y": 29
-      },
-      "id": 69,
-      "interval": "",
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null",
-      "options": {},
-      "percentage": false,
-      "pointradius": 2,
-      "points": false,
-      "renderer": "flot",
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(rate(authorized_calls{namespace=\"$namespace\", limitador_namespace=\"$limitador_namespace\"}[1m])) by (pod)",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 1,
-          "legendFormat": "{{ pod }}-authorized",
-          "refId": "A"
-        },
-        {
-          "expr": "sum(rate(limited_calls{namespace=\"$namespace\", limitador_namespace=\"$limitador_namespace\"}[1m])) by (pod)",
-          "format": "time_series",
-          "interval": "",
-          "intervalFactor": 1,
-          "legendFormat": "{{ pod }}-limited",
-          "refId": "B"
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Requests per second (per pod)",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "decimals": 0,
-          "format": "reqps",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 38
-      },
-      "id": 13,
-      "panels": [],
-      "repeat": "deployment",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "title": "Pods ($deployment)",
-      "type": "row"
-    },
-    {
-      "cacheTimeout": null,
-      "colorBackground": true,
-      "colorValue": false,
-      "colors": [
-        "#F2495C",
-        "rgba(237, 129, 40, 0.89)",
-        "#299c46"
-      ],
-      "datasource": "$datasource",
-      "decimals": 0,
-      "format": "none",
-      "gauge": {
-        "maxValue": 100,
-        "minValue": 0,
-        "show": false,
-        "thresholdLabels": false,
-        "thresholdMarkers": true
-      },
-      "gridPos": {
-        "h": 3,
-        "w": 6,
-        "x": 0,
-        "y": 39
-      },
-      "hideTimeOverride": true,
-      "id": 30,
-      "interval": "",
-      "links": [],
-      "mappingType": 1,
-      "mappingTypes": [
-        {
-          "name": "value to text",
-          "value": 1
-        },
-        {
-          "name": "range to text",
-          "value": 2
-        }
-      ],
-      "maxDataPoints": 100,
-      "nullPointMode": "connected",
-      "nullText": null,
-      "options": {},
-      "pluginVersion": "6.2.4",
-      "postfix": "",
-      "postfixFontSize": "50%",
-      "prefix": "",
-      "prefixFontSize": "50%",
-      "rangeMaps": [
-        {
-          "from": "null",
-          "text": "N/A",
-          "to": "null"
-        }
-      ],
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "sparkline": {
-        "fillColor": "rgba(31, 118, 189, 0.18)",
-        "full": false,
-        "lineColor": "rgb(31, 120, 193)",
-        "show": false
-      },
-      "tableColumn": "",
-      "targets": [
-        {
-          "expr": "sum(kube_deployment_status_replicas_available{namespace='$namespace',deployment='$deployment'}) or kube_statefulset_status_replicas {namespace='$namespace',statefulset='$deployment'}",
-          "format": "time_series",
-          "intervalFactor": 1,
-          "legendFormat": "",
-          "refId": "A"
-        }
-      ],
-      "thresholds": "1,2",
-      "timeFrom": "30s",
-      "timeShift": "30s",
-      "title": "Running pods",
-      "type": "singlestat",
-      "valueFontSize": "80%",
-      "valueMaps": [
-        {
-          "op": "=",
-          "text": "0",
-          "value": "null"
-        }
-      ],
-      "valueName": "avg"
-    },
-    {
-      "cacheTimeout": null,
-      "colorBackground": true,
-      "colorPrefix": false,
-      "colorValue": false,
-      "colors": [
-        "#299c46",
-        "rgba(237, 129, 40, 0.89)",
-        "#F2495C"
-      ],
-      "datasource": "$datasource",
-      "decimals": 0,
-      "format": "none",
-      "gauge": {
-        "maxValue": 100,
-        "minValue": 0,
-        "show": false,
-        "thresholdLabels": false,
-        "thresholdMarkers": true
-      },
-      "gridPos": {
-        "h": 3,
-        "w": 6,
-        "x": 6,
-        "y": 39
-      },
-      "hideTimeOverride": true,
-      "id": 32,
-      "interval": null,
-      "links": [],
-      "mappingType": 1,
-      "mappingTypes": [
-        {
-          "name": "value to text",
-          "value": 1
-        },
-        {
-          "name": "range to text",
-          "value": 2
-        }
-      ],
-      "maxDataPoints": 100,
-      "nullPointMode": "connected",
-      "nullText": null,
-      "options": {},
-      "postfix": "",
-      "postfixFontSize": "50%",
-      "prefix": "",
-      "prefixFontSize": "50%",
-      "rangeMaps": [
-        {
-          "from": "null",
-          "text": "N/A",
-          "to": "null"
-        }
-      ],
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "sparkline": {
-        "fillColor": "rgba(31, 118, 189, 0.18)",
-        "full": false,
-        "lineColor": "rgb(31, 120, 193)",
-        "show": false
-      },
-      "tableColumn": "",
-      "targets": [
-        {
-          "expr": "sum(kube_deployment_status_replicas_unavailable{namespace='$namespace',deployment='$deployment'}) or (kube_statefulset_status_replicas {namespace='$namespace',statefulset='$deployment'} - kube_statefulset_status_replicas_ready {namespace='$namespace',statefulset='$deployment'} )",
-          "format": "time_series",
-          "intervalFactor": 1,
-          "legendFormat": "",
-          "refId": "A"
-        }
-      ],
-      "thresholds": "1,2",
-      "timeFrom": "30s",
-      "timeShift": "30s",
-      "title": "Unavailable pods",
-      "type": "singlestat",
-      "valueFontSize": "80%",
-      "valueMaps": [
-        {
-          "op": "=",
-          "text": "0",
-          "value": "null"
-        }
-      ],
-      "valueName": "avg"
-    },
-    {
-      "cacheTimeout": null,
-      "colorBackground": true,
-      "colorValue": false,
-      "colors": [
-        "#F2495C",
-        "rgba(237, 129, 40, 0.89)",
-        "#299c46"
-      ],
-      "datasource": "$datasource",
-      "decimals": 0,
-      "format": "none",
-      "gauge": {
-        "maxValue": 100,
-        "minValue": 0,
-        "show": false,
-        "thresholdLabels": false,
-        "thresholdMarkers": true
-      },
-      "gridPos": {
-        "h": 3,
-        "w": 6,
-        "x": 12,
-        "y": 39
-      },
-      "hideTimeOverride": true,
-      "id": 37,
-      "interval": "",
-      "links": [],
-      "mappingType": 1,
-      "mappingTypes": [
-        {
-          "name": "value to text",
-          "value": 1
-        },
-        {
-          "name": "range to text",
-          "value": 2
-        }
-      ],
-      "maxDataPoints": 100,
-      "nullPointMode": "connected",
-      "nullText": null,
-      "options": {},
-      "pluginVersion": "6.2.4",
-      "postfix": "",
-      "postfixFontSize": "50%",
-      "prefix": "",
-      "prefixFontSize": "50%",
-      "rangeMaps": [
-        {
-          "from": "null",
-          "text": "N/A",
-          "to": "null"
-        }
-      ],
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "sparkline": {
-        "fillColor": "rgba(31, 118, 189, 0.18)",
-        "full": false,
-        "lineColor": "rgb(31, 120, 193)",
-        "show": false
-      },
-      "tableColumn": "",
-      "targets": [
-        {
-          "expr": "count(count(container_memory_usage_bytes{namespace='$namespace',pod=~'$deployment-.*'}) by (node))",
-          "format": "time_series",
-          "intervalFactor": 1,
-          "legendFormat": "",
-          "refId": "A"
-        }
-      ],
-      "thresholds": "1,2",
-      "timeFrom": "30s",
-      "timeShift": "30s",
-      "title": "Pods distributed on hosts",
-      "type": "singlestat",
-      "valueFontSize": "80%",
-      "valueMaps": [
-        {
-          "op": "=",
-          "text": "0",
-          "value": "null"
-        }
-      ],
-      "valueName": "avg"
-    },
-    {
-      "cacheTimeout": null,
-      "colorBackground": true,
-      "colorValue": false,
-      "colors": [
-        "#299c46",
-        "rgba(237, 129, 40, 0.89)",
-        "#d44a3a"
-      ],
-      "datasource": "$datasource",
-      "decimals": 0,
-      "format": "none",
-      "gauge": {
-        "maxValue": 100,
-        "minValue": 0,
-        "show": false,
-        "thresholdLabels": false,
-        "thresholdMarkers": true
-      },
-      "gridPos": {
-        "h": 3,
-        "w": 6,
-        "x": 18,
-        "y": 39
-      },
-      "hideTimeOverride": true,
-      "id": 36,
-      "interval": null,
-      "links": [],
-      "mappingType": 1,
-      "mappingTypes": [
-        {
-          "name": "value to text",
-          "value": 1
-        },
-        {
-          "name": "range to text",
-          "value": 2
-        }
-      ],
-      "maxDataPoints": 100,
-      "nullPointMode": "connected",
-      "nullText": null,
-      "options": {},
-      "postfix": "",
-      "postfixFontSize": "50%",
-      "prefix": "",
-      "prefixFontSize": "50%",
-      "rangeMaps": [
-        {
-          "from": "null",
-          "text": "N/A",
-          "to": "null"
-        }
-      ],
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "sparkline": {
-        "fillColor": "rgba(31, 118, 189, 0.18)",
-        "full": false,
-        "lineColor": "rgb(31, 120, 193)",
-        "show": false
-      },
-      "tableColumn": "",
-      "targets": [
-        {
-          "expr": "max(sum(delta(kube_pod_container_status_restarts_total{namespace='$namespace',pod=~'$deployment-.*'}[5m])) by (pod))",
-          "format": "time_series",
-          "intervalFactor": 1,
-          "legendFormat": "",
-          "refId": "A"
-        }
-      ],
-      "thresholds": "1,2",
-      "timeFrom": "30s",
-      "timeShift": "30s",
-      "title": "Max pods restarts (last 5 minutes)",
-      "type": "singlestat",
-      "valueFontSize": "80%",
-      "valueMaps": [
-        {
-          "op": "=",
-          "text": "0",
-          "value": "null"
-        }
-      ],
-      "valueName": "avg"
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 7,
-        "w": 24,
-        "x": 0,
-        "y": 42
-      },
-      "id": 11,
-      "legend": {
-        "avg": false,
-        "current": false,
-        "hideEmpty": true,
-        "hideZero": true,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null as zero",
-      "options": {},
-      "percentage": false,
-      "pointradius": 5,
-      "points": false,
-      "renderer": "flot",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "kube_deployment_status_replicas{namespace='$namespace',deployment='$deployment'} or kube_statefulset_status_replicas {namespace='$namespace',statefulset='$deployment'}",
-          "format": "time_series",
-          "intervalFactor": 2,
-          "legendFormat": "total-pods",
-          "legendLink": null,
-          "refId": "A",
-          "step": 10
-        },
-        {
-          "expr": "kube_deployment_status_replicas_available{namespace='$namespace',deployment='$deployment'} or kube_statefulset_status_replicas_ready {namespace='$namespace',statefulset='$deployment'}",
-          "format": "time_series",
-          "intervalFactor": 1,
-          "legendFormat": "-avail-pods",
-          "refId": "B"
-        },
-        {
-          "expr": "kube_deployment_status_replicas_unavailable{namespace='$namespace',deployment='$deployment'} or (kube_statefulset_status_replicas {namespace='$namespace',statefulset='$deployment'} - kube_statefulset_status_replicas_ready {namespace='$namespace',statefulset='$deployment'} )",
-          "format": "time_series",
-          "intervalFactor": 1,
-          "legendFormat": "unavail-pods",
-          "refId": "C"
-        },
-        {
-          "expr": "count(count(container_memory_usage_bytes{namespace='$namespace',pod=~'$deployment-.*'}) by (node))",
-          "format": "time_series",
-          "intervalFactor": 1,
-          "legendFormat": "used-hosts",
-          "refId": "D"
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Pod count (total, avail, unvail) and pods hosts distribution",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "decimals": 0,
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": 0,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": false
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 6,
-        "w": 24,
-        "x": 0,
-        "y": 49
-      },
-      "id": 9,
-      "legend": {
-        "avg": false,
-        "current": false,
-        "hideEmpty": true,
-        "hideZero": true,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null",
-      "options": {},
-      "percentage": false,
-      "pointradius": 2,
-      "points": false,
-      "renderer": "flot",
-      "repeatedByRow": false,
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(delta(kube_pod_container_status_restarts_total{namespace='$namespace',pod=~'$deployment-.*'}[5m])) by (pod)",
-          "format": "time_series",
-          "intervalFactor": 1,
-          "legendFormat": "{{pod}}",
-          "refId": "A"
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Pods restarts (last 5 minutes)",
-      "tooltip": {
-        "shared": true,
-        "sort": 0,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": true
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 55
-      },
-      "id": 4,
-      "panels": [],
-      "repeat": "deployment",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "title": "CPU Usage ($deployment)",
-      "type": "row"
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 7,
-        "w": 24,
-        "x": 0,
-        "y": 56
-      },
-      "id": 64,
-      "interval": "",
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null as zero",
-      "options": {},
-      "percentage": false,
-      "pointradius": 5,
-      "points": false,
-      "renderer": "flot",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(node_namespace_pod_container:container_cpu_usage_seconds_total:sum_rate{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "time_series",
-          "intervalFactor": 2,
-          "legendFormat": "{{pod}}",
-          "legendLink": null,
-          "refId": "A",
-          "step": 10
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "CPU Usage",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": 0,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": false
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 63
-      },
-      "id": 5,
-      "panels": [],
-      "repeat": "deployment",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "title": "CPU Quota ($deployment)",
-      "type": "row"
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "columns": [],
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "fontSize": "100%",
-      "gridPos": {
-        "h": 7,
-        "w": 24,
-        "x": 0,
-        "y": 64
-      },
-      "id": 1,
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null as zero",
-      "options": {},
-      "pageSize": null,
-      "percentage": false,
-      "pointradius": 5,
-      "points": false,
-      "renderer": "flot",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "scroll": true,
-      "seriesOverrides": [],
-      "showHeader": true,
-      "sort": {
-        "col": 1,
-        "desc": false
-      },
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "styles": [
-        {
-          "alias": "Time",
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "pattern": "Time",
-          "type": "hidden"
-        },
-        {
-          "alias": "CPU Usage",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #A",
-          "thresholds": [],
-          "type": "number",
-          "unit": "short"
-        },
-        {
-          "alias": "CPU Requests",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #B",
-          "thresholds": [],
-          "type": "number",
-          "unit": "short"
-        },
-        {
-          "alias": "CPU Requests %",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #C",
-          "thresholds": [],
-          "type": "number",
-          "unit": "percentunit"
-        },
-        {
-          "alias": "CPU Limits",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #D",
-          "thresholds": [],
-          "type": "number",
-          "unit": "short"
-        },
-        {
-          "alias": "CPU Limits %",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #E",
-          "thresholds": [],
-          "type": "number",
-          "unit": "percentunit"
-        },
-        {
-          "alias": "Pod",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": true,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "pod",
-          "thresholds": [],
-          "type": "number",
-          "unit": "short"
-        },
-        {
-          "alias": "",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "pattern": "/.*/",
-          "thresholds": [],
-          "type": "string",
-          "unit": "short"
-        }
-      ],
-      "targets": [
-        {
-          "expr": "sum(node_namespace_pod_container:container_cpu_usage_seconds_total:sum_rate{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "A",
-          "step": 10
-        },
-        {
-          "expr": "sum(kube_pod_container_resource_requests_cpu_cores{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "B",
-          "step": 10
-        },
-        {
-          "expr": "sum(node_namespace_pod_container:container_cpu_usage_seconds_total:sum_rate{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod) / sum(kube_pod_container_resource_requests_cpu_cores{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "C",
-          "step": 10
-        },
-        {
-          "expr": "sum(kube_pod_container_resource_limits_cpu_cores{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "D",
-          "step": 10
-        },
-        {
-          "expr": "sum(node_namespace_pod_container:container_cpu_usage_seconds_total:sum_rate{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod) / sum(kube_pod_container_resource_limits_cpu_cores{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "E",
-          "step": 10
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeShift": null,
-      "title": "CPU Quota",
-      "tooltip": {
-        "shared": true,
-        "sort": 0,
-        "value_type": "individual"
-      },
-      "transform": "table",
-      "type": "table",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": 0,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": false
-        }
-      ]
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 71
-      },
-      "id": 6,
-      "panels": [],
-      "repeat": "deployment",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "title": "Memory Usage ($deployment)",
-      "type": "row"
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 7,
-        "w": 24,
-        "x": 0,
-        "y": 72
-      },
-      "id": 2,
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null as zero",
-      "options": {},
-      "percentage": false,
-      "pointradius": 5,
-      "points": false,
-      "renderer": "flot",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(container_memory_usage_bytes{namespace=~'$namespace', pod=~'$deployment-.*', container!=''}) by (pod)",
-          "format": "time_series",
-          "intervalFactor": 2,
-          "legendFormat": "{{pod}}",
-          "legendLink": null,
-          "refId": "A",
-          "step": 10
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Memory Usage",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "format": "bytes",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": 0,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": false
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 79
-      },
-      "id": 7,
-      "panels": [],
-      "repeat": "deployment",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "title": "Memory Quota ($deployment)",
-      "type": "row"
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "columns": [],
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "fontSize": "100%",
-      "gridPos": {
-        "h": 7,
-        "w": 24,
-        "x": 0,
-        "y": 80
-      },
-      "id": 3,
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null as zero",
-      "options": {},
-      "pageSize": null,
-      "percentage": false,
-      "pointradius": 5,
-      "points": false,
-      "renderer": "flot",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "scroll": true,
-      "seriesOverrides": [],
-      "showHeader": true,
-      "sort": {
-        "col": 1,
-        "desc": true
-      },
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "styles": [
-        {
-          "alias": "Time",
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "pattern": "Time",
-          "type": "hidden"
-        },
-        {
-          "alias": "Memory Usage",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #A",
-          "thresholds": [],
-          "type": "number",
-          "unit": "decbytes"
-        },
-        {
-          "alias": "Memory Requests",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #B",
-          "thresholds": [],
-          "type": "number",
-          "unit": "decbytes"
-        },
-        {
-          "alias": "Memory Requests %",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #C",
-          "thresholds": [],
-          "type": "number",
-          "unit": "percentunit"
-        },
-        {
-          "alias": "Memory Limits",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #D",
-          "thresholds": [],
-          "type": "number",
-          "unit": "decbytes"
-        },
-        {
-          "alias": "Memory Limits %",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": false,
-          "linkTooltip": "Drill down",
-          "linkUrl": "",
-          "pattern": "Value #E",
-          "thresholds": [],
-          "type": "number",
-          "unit": "percentunit"
-        },
-        {
-          "alias": "Pod",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "link": true,
-          "linkTooltip": "Drill down",
-          "linkUrl": "/d/6581e46e4e5c7ba40a07646395ef7b55/kubernetes-compute-resources-pod?var-namespace=$namespace&var-pod=$__cell",
-          "pattern": "pod",
-          "thresholds": [],
-          "type": "number",
-          "unit": "short"
-        },
-        {
-          "alias": "",
-          "colorMode": null,
-          "colors": [],
-          "dateFormat": "YYYY-MM-DD HH:mm:ss",
-          "decimals": 2,
-          "pattern": "/.*/",
-          "thresholds": [],
-          "type": "string",
-          "unit": "short"
-        }
-      ],
-      "targets": [
-        {
-          "expr": "sum(container_memory_usage_bytes{namespace=~'$namespace',pod=~'$deployment-.*', container!=''}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "A",
-          "step": 10
-        },
-        {
-          "expr": "sum(kube_pod_container_resource_requests_memory_bytes{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "B",
-          "step": 10
-        },
-        {
-          "expr": "sum(container_memory_usage_bytes{namespace=~'$namespace',pod!~'.*redis.*',pod=~'$deployment-.*', container!=''}) by (pod) / sum(kube_pod_container_resource_requests_memory_bytes{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "C",
-          "step": 10
-        },
-        {
-          "expr": "sum(kube_pod_container_resource_limits_memory_bytes{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "D",
-          "step": 10
-        },
-        {
-          "expr": "sum(container_memory_usage_bytes{namespace=~'$namespace',pod=~'$deployment-.*', container!=''}) by (pod) / sum(kube_pod_container_resource_limits_memory_bytes{namespace=~'$namespace',pod=~'$deployment-.*'}) by (pod)",
-          "format": "table",
-          "instant": true,
-          "intervalFactor": 2,
-          "legendFormat": "",
-          "refId": "E",
-          "step": 10
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeShift": null,
-      "title": "Memory Quota",
-      "tooltip": {
-        "shared": true,
-        "sort": 0,
-        "value_type": "individual"
-      },
-      "transform": "table",
-      "type": "table",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": 0,
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": false
-        }
-      ]
-    },
-    {
-      "collapsed": false,
-      "gridPos": {
-        "h": 1,
-        "w": 24,
-        "x": 0,
-        "y": 87
-      },
-      "id": 15,
-      "panels": [],
-      "repeat": "deployment",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "title": "Network Usage ($deployment)",
-      "type": "row"
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 6,
-        "w": 24,
-        "x": 0,
-        "y": 88
-      },
-      "id": 17,
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null",
-      "options": {},
-      "percentage": false,
-      "pointradius": 2,
-      "points": false,
-      "renderer": "flot",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(irate(container_network_receive_bytes_total{namespace=~'$namespace',pod=~'$deployment-.*'}[5m])) by (pod)",
-          "format": "time_series",
-          "intervalFactor": 2,
-          "legendFormat": "{{pod}}",
-          "refId": "A"
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Receive Bandwidth",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "decimals": null,
-          "format": "Bps",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": "0",
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": false
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    },
-    {
-      "aliasColors": {},
-      "bars": false,
-      "dashLength": 10,
-      "dashes": false,
-      "datasource": "$datasource",
-      "fill": 1,
-      "gridPos": {
-        "h": 6,
-        "w": 24,
-        "x": 0,
-        "y": 94
-      },
-      "id": 18,
-      "legend": {
-        "avg": false,
-        "current": false,
-        "max": false,
-        "min": false,
-        "show": true,
-        "total": false,
-        "values": false
-      },
-      "lines": true,
-      "linewidth": 1,
-      "links": [],
-      "nullPointMode": "null",
-      "options": {},
-      "percentage": false,
-      "pointradius": 2,
-      "points": false,
-      "renderer": "flot",
-      "scopedVars": {
-        "deployment": {
-          "selected": true,
-          "text": "limitador",
-          "value": "limitador"
-        }
-      },
-      "seriesOverrides": [],
-      "spaceLength": 10,
-      "stack": false,
-      "steppedLine": false,
-      "targets": [
-        {
-          "expr": "sum(irate(container_network_transmit_bytes_total{namespace=~'$namespace',pod=~'$deployment-.*'}[5m])) by (pod)",
-          "format": "time_series",
-          "intervalFactor": 2,
-          "legendFormat": "{{pod}}",
-          "refId": "A"
-        }
-      ],
-      "thresholds": [],
-      "timeFrom": null,
-      "timeRegions": [],
-      "timeShift": null,
-      "title": "Transmit Bandwidth",
-      "tooltip": {
-        "shared": true,
-        "sort": 2,
-        "value_type": "individual"
-      },
-      "type": "graph",
-      "xaxis": {
-        "buckets": null,
-        "mode": "time",
-        "name": null,
-        "show": true,
-        "values": []
-      },
-      "yaxes": [
-        {
-          "format": "Bps",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": "0",
-          "show": true
-        },
-        {
-          "format": "short",
-          "label": null,
-          "logBase": 1,
-          "max": null,
-          "min": null,
-          "show": false
-        }
-      ],
-      "yaxis": {
-        "align": false,
-        "alignLevel": null
-      }
-    }
-  ],
-  "refresh": "10s",
-  "schemaVersion": 18,
-  "style": "dark",
-  "tags": [
-    "kuadrant",
-    "backend"
-  ],
-  "templating": {
-    "list": [
-      {
-        "current": {
-          "text": "Prometheus",
-          "value": "Prometheus"
-        },
-        "hide": 0,
-        "includeAll": false,
-        "label": null,
-        "multi": false,
-        "name": "datasource",
-        "options": [],
-        "query": "prometheus",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "type": "datasource"
-      },
-      {
-        "allValue": null,
-        "datasource": "$datasource",
-        "definition": "label_values(limitador_up,namespace)",
-        "hide": 0,
-        "includeAll": false,
-        "label": "namespace",
-        "multi": false,
-        "name": "namespace",
-        "options": [],
-        "query": "label_values(limitador_up,namespace)",
-        "refresh": 1,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "tagValuesQuery": "",
-        "tags": [],
-        "tagsQuery": "",
-        "type": "query",
-        "useTags": false
-      },
-      {
-        "allValue": null,
-        "current": {
-          "tags": [],
-          "text": "limitador",
-          "value": "limitador"
-        },
-        "hide": 0,
-        "includeAll": false,
-        "label": "component",
-        "multi": false,
-        "name": "deployment",
-        "options": [
-          {
-            "selected": true,
-            "text": "limitador",
-            "value": "limitador"
-          },
-          {
-            "selected": false,
-            "text": "kuard",
-            "value": "kuard"
-          },
-          {
-            "selected": false,
-            "text": "redis",
-            "value": "redis"
-          }
-        ],
-        "query": "limitador,kuard,redis",
-        "skipUrlSync": false,
-        "type": "custom"
-      },
-      {
-        "allValue": null,
-        "current": {
-          "text": "kuard",
-          "value": "kuard"
-        },
-        "datasource": "$datasource",
-        "definition": "label_values(authorized_calls{namespace=\"$namespace\"},limitador_namespace)",
-        "hide": 0,
-        "includeAll": false,
-        "label": "limitador_namespace",
-        "multi": false,
-        "name": "limitador_namespace",
-        "options": [
-          {
-            "selected": true,
-            "text": "kuard",
-            "value": "kuard"
-          }
-        ],
-        "query": "label_values(authorized_calls{namespace=\"$namespace\"},limitador_namespace)",
-        "refresh": 0,
-        "regex": "",
-        "skipUrlSync": false,
-        "sort": 0,
-        "tagValuesQuery": "",
-        "tags": [],
-        "tagsQuery": "",
-        "type": "query",
-        "useTags": false
-      }
-    ]
-  },
-  "time": {
-    "from": "now-30m",
-    "to": "now"
-  },
-  "timepicker": {
-    "refresh_intervals": [
-      "5s",
-      "10s",
-      "30s",
-      "1m",
-      "5m",
-      "15m",
-      "30m",
-      "1h",
-      "2h",
-      "1d"
-    ],
-    "time_options": [
-      "5m",
-      "15m",
-      "1h",
-      "6h",
-      "12h",
-      "24h",
-      "2d",
-      "7d",
-      "30d"
-    ]
-  },
-  "timezone": "",
-  "title": "Kuadrant Limitador",
-  "version": 8
-}
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/limitador-metrics-dashboard-screenshot.png b/0.10.0/limitador/limitador-server/kubernetes/limitador-metrics-dashboard-screenshot.png
deleted file mode 100644
index d674b48e9736b379872a2506a79bef664afd4cfc..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 70285
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

diff --git a/0.10.0/limitador/limitador-server/kubernetes/limitador-podmonitor.yaml b/0.10.0/limitador/limitador-server/kubernetes/limitador-podmonitor.yaml
deleted file mode 100644
index 6e17cc322..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/limitador-podmonitor.yaml
+++ /dev/null
@@ -1,15 +0,0 @@
-apiVersion: monitoring.coreos.com/v1
-kind: PodMonitor
-metadata:
-  name: limitador
-  labels:
-    app: limitador
-spec:
-  podMetricsEndpoints:
-    - interval: 10s
-      path: /metrics
-      port: http
-      scheme: http
-  selector:
-    matchLabels:
-      app: limitador
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/limitador-service.yaml b/0.10.0/limitador/limitador-server/kubernetes/limitador-service.yaml
deleted file mode 100644
index dff1a164e..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/limitador-service.yaml
+++ /dev/null
@@ -1,20 +0,0 @@
-apiVersion: v1
-kind: Service
-metadata:
-  name: limitador
-  labels:
-    app: limitador
-spec:
-  ports:
-    - name: http
-      protocol: TCP
-      port: 8080
-      targetPort: http
-    - name: grpc
-      protocol: TCP
-      port: 8081
-      targetPort: grpc
-  selector:
-    app: limitador
-  clusterIP: None
-  type: ClusterIP
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/ratelimit.svg b/0.10.0/limitador/limitador-server/kubernetes/ratelimit.svg
deleted file mode 100644
index 0a7b02acd..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/ratelimit.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:lucid="lucid" width="1712.92" height="1398.89"><g transform="translate(-159.54115256205523 98.8920017419074)" lucid:page-tab-id="0_0"><path d="M0-1259.2h1870.4v2582.4H0z" fill="#fff"/><path d="M560.7 88h1228.23v1012H560.7z" stroke="#000" stroke-width="2" fill="#e5e5e5" fill-opacity=".6"/><path d="M179.54-78.9h1672.92V1280H179.54z" stroke="#248814" stroke-width="2" fill="#fff" fill-opacity="0"/><path d="M179.54-78.9h56v56h-56v-56z" stroke="#fff" stroke-opacity="0" fill="#248814"/><path d="M211.3-50.6h-1.18v-1.1c-.12-1.72-1.47-3.07-3.2-3.2-1.9-.12-3.54 1.3-3.67 3.2v1.08h-1.18c-.44 0-.8.36-.8.8v6.12c0 .45.36.8.8.8h9.23c.44 0 .8-.35.8-.8v-6.08c0-.45-.36-.8-.8-.8zm-6.4-1.06c.1-1.02 1-1.76 2-1.66.9.08 1.58.76 1.67 1.66v1.07h-3.72zm5.65 7.1h-7.68V-49h7.63z" stroke="#fff" stroke-opacity="0" fill="#fff"/><path d="M221.8-53.15c-.07-2.44-1.57-4.47-3.86-5.3-1.58-.46-3.16-.13-4.4.9-.68-1.45-1.47-2.6-2.6-3.75-3.24-3.35-7.94-4.28-12.18-2.4-4.04 1.9-6.4 5.64-6.54 10.06v.7c-3.4.97-5.65 4.08-5.5 7.65v.64c.4 4.28 3.92 7.52 8.2 7.46h26.02s7.4-.63 7.4-8.1c.04-3.9-2.66-7.2-6.53-7.85zm-.95 14.4h-25.92c-3.45.04-6.28-2.54-6.58-5.97v-.52c-.16-3.05 1.92-5.7 4.9-6.3.4-.12.64-.48.6-.9-.04-.4-.04-.73 0-1.15.08-3.78 2.12-6.93 5.53-8.58 1.25-.58 2.4-.82 3.83-.85 2.63.08 4.88 1.04 6.7 2.94 1.26 1.3 2.05 2.6 2.63 4.32.04.13.13.27.25.35.37.28.87.2 1.12-.16.84-1.17 2.25-1.67 3.62-1.28 1.8.7 2.87 2.4 2.83 4.3-.08.42.2.83.63.92 3.58.35 6.2 3.54 5.82 7.1-.3 3.14-2.7 5.52-5.82 5.85z" stroke="#fff" stroke-opacity="0" fill="#fff"/><use xlink:href="#a" transform="matrix(1,0,0,1,250.54115256205523,-58.89200174190739) translate(0 14.4)"/><path d="M581.1 16.47h403.14v1239.7H581.1z" fill="#147eba" fill-opacity=".13"/><path d="M581.1 16.47h56v56h-56v-56z" stroke="#fff" stroke-opacity="0" fill="#147eba"/><path d="M624.47 38.64c-.16-.16-.34-.24-.56-.24h-5.14v-5.58c-.03-2.54-.97-4.7-2.84-6.4-1.9-1.84-4.15-2.75-6.77-2.75-2.65 0-4.9.83-6.8 2.62-1.9 1.7-2.87 3.86-2.9 6.4v5.65h-5.15c-.25 0-.44.1-.6.25-.15.17-.2.34-.2.6v25.28c0 .4.33.8.8.8h29.58c.47 0 .8-.4.8-.8v-25.3c0-.2-.05-.37-.2-.54zM601 32.74c.04-2.12.82-3.87 2.38-5.3 1.62-1.48 3.52-2.2 5.74-2.2 2.2 0 4.12.76 5.7 2.26 1.54 1.4 2.32 3.2 2.32 5.32v5.58h-16.16zm22.1 30.95h-28.02V39.97h28.02z" stroke="#fff" stroke-opacity="0" fill="#fff"/><path d="M608.28 53.78v6.24h1.6V53.8c2.14-.4 3.63-2.2 3.64-4.36 0-2.43-1.98-4.4-4.42-4.43-2.2-.02-4.05 1.5-4.42 3.7-.4 2.4 1.2 4.67 3.6 5.08zm.82-7.16c.8 0 1.45.27 2 .82.55.56.83 1.22.82 2 .02 1.55-1.2 2.8-2.75 2.82h-.07c-1.55.12-2.92-1.05-3.03-2.6-.12-1.57 1.05-2.94 2.6-3.04.16-.02.28-.02.43 0z" stroke="#fff" stroke-opacity="0" fill="#fff"/><use xlink:href="#b" transform="matrix(1,0,0,1,652.0877793007068,36.46884048559514) translate(0 12.444444444444446)"/><use xlink:href="#c" transform="matrix(1,0,0,1,652.0877793007068,36.46884048559514) translate(56.129629629629626 12.444444444444446)"/><use xlink:href="#d" transform="matrix(1,0,0,1,652.0877793007068,36.46884048559514) translate(112.99382716049382 12.444444444444446)"/><path d="M1005.4 16.47h381.18v1239.7H1005.4z" fill="#147eba" fill-opacity=".13"/><path d="M1005.4 16.47h56v56h-56v-56z" stroke="#fff" stroke-opacity="0" fill="#147eba"/><path d="M1048.8 38.64c-.16-.16-.35-.24-.57-.24h-5.15v-5.58c-.03-2.54-.96-4.7-2.83-6.4-1.9-1.84-4.15-2.75-6.78-2.75-2.65 0-4.9.83-6.8 2.62-1.9 1.7-2.87 3.86-2.9 6.4v5.65h-5.15c-.25 0-.43.1-.6.25-.15.17-.2.34-.2.6v25.28c0 .4.34.8.8.8h29.58c.47 0 .8-.4.8-.8v-25.3c0-.2-.05-.37-.2-.54zm-23.47-5.9c.03-2.12.8-3.87 2.37-5.3 1.62-1.48 3.53-2.2 5.74-2.2 2.22 0 4.12.76 5.7 2.26 1.54 1.4 2.32 3.2 2.32 5.32v5.58h-16.16zm22.1 30.95h-28.03V39.97h28.02z" stroke="#fff" stroke-opacity="0" fill="#fff"/><path d="M1032.6 53.78v6.24h1.6V53.8c2.14-.4 3.64-2.2 3.64-4.36 0-2.43-1.97-4.4-4.4-4.43-2.2-.02-4.06 1.5-4.44 3.7-.4 2.4 1.2 4.67 3.6 5.08zm.83-7.16c.78 0 1.44.27 2 .82.54.56.82 1.22.8 2 .03 1.55-1.2 2.8-2.74 2.82h-.07c-1.56.12-2.92-1.05-3.04-2.6-.12-1.57 1.04-2.94 2.6-3.04.15-.02.28-.02.43 0z" stroke="#fff" stroke-opacity="0" fill="#fff"/><use xlink:href="#b" transform="matrix(1,0,0,1,1076.4119133235702,36.468840485595024) translate(0 12.444444444444446)"/><use xlink:href="#c" transform="matrix(1,0,0,1,1076.4119133235702,36.468840485595024) translate(56.129629629629626 12.444444444444446)"/><use xlink:href="#e" transform="matrix(1,0,0,1,1076.4119133235702,36.468840485595024) translate(112.99382716049382 12.444444444444446)"/><path d="M1407.76 16.47h360v1239.7h-360z" fill="#147eba" fill-opacity=".13"/><path d="M1407.76 16.47h56v56h-56v-56z" stroke="#fff" stroke-opacity="0" fill="#147eba"/><path d="M1451.14 38.64c-.15-.16-.34-.24-.56-.24h-5.15v-5.58c-.03-2.54-.97-4.7-2.84-6.4-1.9-1.84-4.16-2.75-6.78-2.75-2.65 0-4.9.83-6.8 2.62-1.9 1.7-2.87 3.86-2.9 6.4v5.65h-5.15c-.25 0-.44.1-.6.25-.15.17-.2.34-.2.6v25.28c0 .4.33.8.8.8h29.58c.47 0 .8-.4.8-.8v-25.3c0-.2-.05-.37-.2-.54zm-23.46-5.9c.03-2.12.8-3.87 2.37-5.3 1.62-1.48 3.53-2.2 5.74-2.2 2.2 0 4.1.76 5.7 2.26 1.53 1.4 2.3 3.2 2.3 5.32v5.58h-16.15zm22.1 30.95h-28.03V39.97h28.02z" stroke="#fff" stroke-opacity="0" fill="#fff"/><path d="M1434.96 53.78v6.24h1.6V53.8c2.13-.4 3.62-2.2 3.63-4.36 0-2.43-2-4.4-4.42-4.43-2.2-.02-4.06 1.5-4.43 3.7-.4 2.4 1.2 4.67 3.6 5.08zm.82-7.16c.78 0 1.44.27 2 .82.54.56.82 1.22.8 2 .03 1.55-1.2 2.8-2.74 2.82h-.06c-1.56.12-2.92-1.05-3.04-2.6-.12-1.57 1.05-2.94 2.6-3.04.16-.02.28-.02.44 0z" stroke="#fff" stroke-opacity="0" fill="#fff"/><use xlink:href="#b" transform="matrix(1,0,0,1,1478.7592070278984,36.468840485595024) translate(0 12.444444444444446)"/><use xlink:href="#c" transform="matrix(1,0,0,1,1478.7592070278984,36.468840485595024) translate(56.129629629629626 12.444444444444446)"/><use xlink:href="#f" transform="matrix(1,0,0,1,1478.7592070278984,36.468840485595024) translate(112.99382716049382 12.444444444444446)"/><path d="M200.72 16.47h338.82v1239.7H200.72z" fill="#248814" fill-opacity=".13"/><path d="M200.72 16.47h56v56h-56v-56z" stroke="#fff" stroke-opacity="0" fill="#248814"/><path d="M244.1 38.64c-.16-.16-.34-.24-.56-.24h-5.15v-5.58c-.04-2.54-.98-4.7-2.85-6.4-1.9-1.84-4.15-2.75-6.77-2.75-2.65 0-4.9.83-6.8 2.62-1.9 1.7-2.87 3.86-2.9 6.4v5.65h-5.15c-.25 0-.44.1-.6.25-.15.17-.2.34-.2.6v25.28c0 .4.33.8.8.8h29.58c.47 0 .82-.4.82-.8v-25.3c0-.2-.06-.37-.22-.54zm-23.46-5.9c.03-2.12.8-3.87 2.37-5.3 1.63-1.48 3.53-2.2 5.75-2.2 2.2 0 4.12.76 5.7 2.26 1.54 1.4 2.32 3.2 2.32 5.32v5.58H220.6zm22.1 30.95H214.7V39.97h28.03z" stroke="#fff" stroke-opacity="0" fill="#fff"/><path d="M227.9 53.78v6.24h1.62V53.8c2.12-.4 3.62-2.2 3.63-4.36 0-2.43-1.98-4.4-4.42-4.43-2.2-.02-4.05 1.5-4.42 3.7-.4 2.4 1.2 4.67 3.6 5.08zm.83-7.16c.8 0 1.45.27 2 .82.55.56.83 1.22.82 2 0 1.55-1.2 2.8-2.75 2.82h-.07c-1.55.12-2.92-1.05-3.03-2.6-.12-1.57 1.05-2.94 2.6-3.04.16-.02.28-.02.43 0z" stroke="#fff" stroke-opacity="0" fill="#fff"/><use xlink:href="#g" transform="matrix(1,0,0,1,271.7173259149147,36.468840485595024) translate(0 14.4)"/><use xlink:href="#h" transform="matrix(1,0,0,1,271.7173259149147,36.468840485595024) translate(53.900000000000006 14.4)"/><path d="M617.35 147.98c-4.2 0-7.2-3.5-7.2-7.9s3-7.88 7.2-7.88c3.9 0 7.18 3.48 7.18 7.9 0 4.4-3.3 7.88-7.18 7.88zm0-13.63c-3 0-5.1 2.46-5.1 5.74 0 3.26 2.1 5.78 5.1 5.78 2.7 0 5.08-2.52 5.08-5.8 0-3.22-2.4-5.73-5.08-5.73zM626.32 136.6h2.1v1.08c.9-.82 1.8-1.23 3-1.23 2.68 0 5.08 2.5 5.08 5.74 0 3.16-2.4 5.72-5.1 5.72-1.2 0-2.08-.35-2.98-1.07v5.43h-2.1zm2.1 3.08v5.02c.6.82 1.5 1.33 2.7 1.33 2.1 0 3.28-1.64 3.28-3.84 0-2.17-1.2-3.86-3.3-3.86-1.2 0-2.08.47-2.68 1.34zM643.08 147.98c-3 0-5.1-2.57-5.1-5.8 0-3.22 2.1-5.73 4.8-5.73 3 0 5.1 2.56 5.1 5.84v.6h-8.1c.3 1.85 1.8 3.23 3.6 3.18.9.05 1.8-.3 2.4-.97l1.2 1.4c-1.2 1-2.4 1.48-3.9 1.48zm-3.3-6.72h6c-.3-1.74-1.5-2.97-3-2.97s-2.7 1.17-3 2.96zM649.66 136.6h1.8v1.13c.9-.92 2.1-1.38 3.3-1.33 2.1 0 3.88 1.8 3.88 4.35v6.97h-2.1v-6.6c0-1.75-.9-2.83-2.4-2.83-1.18 0-2.08.5-2.68 1.43v8h-1.8zM661.04 143.62c1.5 1.6 3 2.36 4.78 2.36 1.8 0 3.3-1.03 3.3-2.5 0-1.4-.9-2.06-2.7-2.42l-2.4-.46c-2.4-.46-3.88-1.74-3.88-3.95 0-2.66 2.1-4.4 5.08-4.4 2.1 0 3.9.66 5.7 2.05l-1.2 1.8c-1.5-1.3-3-1.9-4.5-1.9-1.8 0-3 .92-3 2.25 0 1.28.6 1.84 2.4 2.2l2.4.36c2.7.52 4.2 1.9 4.2 4.26 0 2.82-2.1 4.72-5.4 4.72-2.4 0-4.5-.93-5.98-2.77zM672.7 132.45l2.1-.5v5.78c.9-.92 1.8-1.38 3-1.33 2.4 0 3.88 1.8 3.88 4.35v6.97h-1.8v-6.6c0-1.75-1.2-2.83-2.7-2.83-.88 0-1.78.5-2.38 1.43v8h-2.1zM683.78 133.48c0-.77.6-1.33 1.2-1.4.6 0 1.2.58 1.2 1.35 0 .7-.3 1.38-1.2 1.38-.6 0-1.2-.6-1.2-1.32zm2.1 14.24h-1.8V136.6h1.8zM689.76 136.6v-1.64c0-2.35 1.2-3.58 3.3-3.58.6-.05.9.05 1.5.15v1.9c-.3-.1-.9-.2-1.2-.16-1.2 0-1.5.5-1.5 1.7v1.63h2.7v1.85h-2.7v9.27h-2.1v-9.27h-2.4v-1.85zM697.54 138.45h-2.1v-1.85h2.1v-2.82l2.1-.5v3.32h2.7v1.85h-2.7v6.04c0 1.12.3 1.53 1.5 1.53.3.05.9-.05 1.2-.26v1.85c-.6.2-1.2.3-1.8.3-1.8 0-3-1.02-3-2.92zM719.4 144.34l.9 1.13c-1.5 1.7-3.3 2.56-5.4 2.5-3.9.1-7.18-3.38-7.18-7.73 0-4.35 3-7.94 7.18-8.04 2.1 0 4.2.92 5.4 2.56l-.9 1.18c-1.2-1.44-2.7-2.16-4.5-2.16-3 0-5.4 2.77-5.4 6.36 0 3.58 2.4 6.3 5.4 6.3 1.8 0 3.6-.77 4.5-2.1zM726.57 136.6c2.7 0 5.1 2.46 5.1 5.64 0 3.17-2.4 5.74-5.1 5.74-2.7 0-5.1-2.5-5.1-5.74 0-3.18 2.4-5.64 5.1-5.64zm3.6 5.64c0-2.36-1.5-4.2-3.6-4.2s-3.6 1.84-3.6 4.2c0 2.4 1.5 4.3 3.6 4.3s3.6-1.9 3.6-4.3zM733.75 136.8h1.5v1.3c.6-1.04 1.8-1.5 3-1.5 2.08 0 3.88 1.7 3.88 4.2v6.97h-1.5v-6.6c0-1.95-1.2-3.18-2.7-3.18-1.2 0-2.38.6-2.68 1.68v8.04h-1.5zM745.12 138.2h-2.1v-1.4h2.1v-2.76l1.5-.46v3.23h3v1.4h-3v6.7c0 1.18.6 1.64 1.5 1.64.6 0 1.2-.1 1.5-.3v1.43c-.6.2-1.2.3-1.8.25-1.5 0-2.7-.92-2.7-2.6zM750.8 144.65c0-2.05 1.5-3.33 3.9-3.33.9 0 1.8.2 2.7.7v-1.42c0-1.74-.9-2.67-2.4-2.67-1.2 0-2.1.3-3.3.98l-.3-1.22c1.2-.77 2.4-1.13 3.6-1.13 2.4 0 3.9 1.38 3.9 3.84v7.32h-1.5v-1.08c-.9.93-1.8 1.34-3 1.34-2.1 0-3.6-1.4-3.6-3.33zm3.9 2.05c1.2 0 2.1-.4 2.7-1.3v-2.04c-.6-.6-1.5-.87-2.7-.87-1.5 0-2.7.8-2.7 2.1 0 1.22 1.2 2.1 2.7 2.1zM760.98 133.58c0-.56.6-1.08 1.2-1.08s.9.46.9 1.08c0 .6-.3 1.13-.9 1.13-.6 0-1.2-.5-1.2-1.12zm1.8 14.14h-1.5v-10.9h1.5zM765.17 136.8h1.5v1.3c.9-1.04 1.8-1.5 3.3-1.5 2.08 0 3.58 1.7 3.58 4.2v6.97h-1.2v-6.6c0-1.95-1.2-3.18-3-3.18-.9 0-2.08.6-2.68 1.68v8.04h-1.5zM780.73 147.98c-2.7 0-5.08-2.46-5.08-5.54v-.15c0-3.2 2.1-5.65 4.78-5.65 2.7 0 4.8 2.46 4.8 5.64v.5h-8.1c.3 2.15 1.8 3.74 3.6 3.74 1.2 0 2.1-.36 2.7-1.02l.9 1.07c-.9.97-2.1 1.38-3.6 1.38zm-3.6-6.5h6.6c-.3-1.96-1.5-3.44-3.3-3.44-1.8 0-3 1.43-3.3 3.43zM787.32 136.8h1.2v1.54c.6-1.12 1.8-1.8 3-1.8.28 0 .58.06.88.16v1.5c-.3-.16-.6-.2-1.2-.2-1.2 0-2.1.8-2.7 2.24v7.48h-1.18zM798.4 132.45h5.97c2.7 0 4.5 1.74 4.5 4.4 0 2.67-1.8 4.47-4.5 4.47h-4.5v6.4h-1.48zm1.48 1.5v5.88h4.5c1.8 0 3-1.13 3-2.92 0-1.83-1.2-2.9-3-2.9zM812.45 147.72h-1.5v-15.27l1.5-.4zM814.25 144.65c0-2.05 1.5-3.33 3.9-3.33 1.18 0 2.08.2 2.98.7v-1.42c0-1.74-.9-2.67-2.7-2.67-.9 0-1.8.3-3 .98l-.58-1.22c1.5-.77 2.7-1.13 3.9-1.13 2.38 0 3.88 1.38 3.88 3.84v7.32h-1.5v-1.08c-.9.93-1.8 1.34-3.3 1.28-2.1.06-3.58-1.33-3.58-3.27zm3.9 2.05c1.18 0 2.08-.4 2.98-1.3v-2.04c-.9-.6-1.8-.87-2.7-.87-1.8 0-2.7.8-2.7 2.1 0 1.22.9 2.1 2.4 2.1zM825.92 138.2h-2.1v-1.4h2.1v-2.76l1.2-.46v3.23h3v1.4h-3v6.7c0 1.18.6 1.64 1.8 1.64.3 0 .9-.1 1.2-.3v1.43c-.6.2-.9.3-1.5.25-1.8 0-2.7-.92-2.7-2.6zM833.4 136.8v-2.1c0-2.15 1.2-3.32 3-3.32.6 0 .9.05 1.5.2v1.44c-.6-.16-.9-.2-1.2-.2-1.2 0-1.8.6-1.8 1.94v2.05h3v1.4h-3v9.52h-1.5v-9.53H831v-1.4zM843.27 136.6c3 0 5.1 2.46 5.1 5.64 0 3.17-2.1 5.74-5.1 5.74-2.7 0-4.78-2.5-4.78-5.74 0-3.18 2.08-5.64 4.77-5.64zm3.6 5.64c0-2.36-1.5-4.2-3.6-4.2-1.8 0-3.6 1.84-3.6 4.2 0 2.4 1.8 4.3 3.6 4.3 2.1 0 3.6-1.9 3.6-4.3zM850.46 136.8h1.5v1.54c.6-1.12 1.5-1.8 2.7-1.8.28 0 .58.06.88.16v1.5c-.3-.16-.6-.2-.9-.2-1.2 0-2.1.8-2.7 2.24v7.48h-1.48zM857.34 136.8h1.5v1.2c.6-1 1.5-1.45 2.7-1.4 1.48-.05 2.38.67 3.28 1.95.6-1.28 1.8-2.05 3.3-1.95 2.1 0 3.58 1.7 3.58 4.2v6.97h-1.5v-6.6c0-1.95-.9-3.18-2.4-3.18-1.18 0-2.08.6-2.68 1.78v7.99h-1.5v-6.6c0-1.95-.9-3.18-2.4-3.18-1.2 0-1.8.55-2.38 1.57v8.15h-1.5zM677.2 121.44c0 2.46 1.5 3.7 3.88 3.7.9 0 1.5-.12 2.4-.37v-2.87c-.6.15-.9.25-1.5.2-.9 0-1.5-.3-1.5-1.38v-4.46h3v-2.97h-3v-3.8l-3 .77v3.02h-2.38v2.96h2.1zm-9.88.05c0-.78.6-1.2 1.8-1.2.6.06 1.2.1 1.8.32v1.48c-.6.4-1.2.57-1.8.57-1.2 0-1.8-.46-1.8-1.18m.9 3.68c1.2 0 2.1-.26 3-.92v.7h3.28v-7.47c0-2.88-1.8-4.4-4.8-4.4-1.48 0-2.98.4-4.77 1.27l1.2 2.6c1.2-.55 2.1-.9 2.98-.9 1.5 0 2.1.55 2.1 1.73v.56c-.9-.25-1.5-.3-2.38-.3-2.7 0-4.2 1.23-4.2 3.48 0 2.05 1.5 3.64 3.6 3.64m-17.36-.2h3.3v-6.05h5.98v6.04h3.3V109.5h-3.3v5.94h-6v-5.94h-3.28zm-13.17-5.85c0-1.7 1.2-2.97 3-2.97.58 0 1.48.26 2.08.92v4.05c-.6.67-1.5.97-2.1.97-1.8 0-3-1.28-3-2.97m5.1 5.84h3.3v-16.24l-3.3.77v4.4c-.9-.56-1.8-.76-2.7-.76-2.98 0-5.38 2.6-5.38 6v.1c0 3.27 2.4 5.9 5.4 5.9.9 0 1.78-.32 2.68-1.04zM628.12 116c1.2 0 2.1.72 2.4 1.85H626c.3-1.18 1.2-1.84 2.1-1.84m-5.4 3.13c0 3.43 2.7 6.1 5.7 6.1 1.8 0 3.3-.56 4.5-1.8l-2.1-2.1c-.6.57-1.2.88-2.1.88-1.2.06-2.1-.66-2.7-1.84h7.48v-.87c0-3.75-2.1-6.4-5.08-6.4h-.3c-3 0-5.4 2.7-5.4 6.03m-5.37-6.4c1.2 0 1.8.82 1.8 1.8 0 .9-.6 1.73-1.8 1.73h-3.6v-3.53zm-6.9 12.24h3.3v-5.63h2.7l2.7 5.63h3.88l-3.3-6.2c1.8-.7 2.7-2.4 2.7-4.35 0-2.77-1.8-4.92-4.8-4.92h-7.17zM603.28 116.93v-.46-.1-.52l-2.4.98c-.3-2.1-.6-3.9-1.5-5.8l4.5-1.8c-.3-.7-.6-1.27-.9-1.88-.3-.15-.3-.3-.3-.4l-2.1.8c-2.98-4.7-7.77-7.1-12.86-6.65-8.08.72-13.76 8.4-13.17 17.2l3-1.27-.9.4v.58c0 .77 0 1.4.3 2.1l4.8-1.9c0-.6-.3-1.07-.3-1.68v-.5-.06-.52l-2.1.82c.6-5.68 5.08-10 10.17-9.58 2.4.2 4.2 1.23 5.98 3.13l2.7-1.12-.6.26c0 .15.3.3.3.4 0 .16.3.26.3.42.3.46.6.87.9 1.38l-4.5 1.84c.9 1.85 1.2 3.7 1.2 5.84l4.8-1.94-2.4 1.02V118.57c-.3.15-.3.3-.3.46v.1c0 .4 0 .77-.3 1.13 0 .46-.3.82-.3 1.23-2.1 5.2-7.78 7.47-12.57 5-.3-.14-.6-.35-.9-.55-.3-.26-.6-.47-.9-.72v-.05c-.3-.1-.3-.2-.3-.3l-.3-.1c0-.1 0-.27-.3-.42l-2.4.97c-1.2-1.54-2.08-3.23-2.38-5.33l-4.8 1.95c.6 2.05 1.2 3.7 2.4 5.43l2.1-.97c.3.16.3.26.3.42l.3.1v.36l.3.05c0 .15 0 .26.3.36v.04c0 .1 0 .26.3.36v.05c1.2 1.54 2.7 2.56 4.18 3.48 7.18 3.7 15.86.26 19.15-7.78.9-2.26 1.5-4.36 1.5-6.87z" stroke="#000" stroke-opacity="0" stroke-width=".19"/><path d="M334.97 694.97c-30.34 0-54.97 24.63-54.97 54.97 0 30.35 24.63 54.98 54.97 54.98 30.35 0 54.97-24.63 54.97-54.98 0-30.34-24.62-54.97-54.97-54.97zm0 105.55c-27.92 0-50.57-22.65-50.57-50.58 0-27.92 22.65-50.57 50.57-50.57 27.93 0 50.58 22.65 50.58 50.57 0 27.93-22.65 50.58-50.58 50.58z" stroke="#fff" stroke-opacity="0" stroke-width="3" fill="#693cc5"/><path d="M315.2 763.14h-22.02c-1.2 0-2.2-.98-2.2-2.2v-22c0-1.2 1-2.2 2.2-2.2h22c1.22 0 2.2 1 2.2 2.2v22c0 1.22-.98 2.2-2.2 2.2zm-19.8-4.4h17.57v-17.58H295.4zM365.76 734.55h-13.2c-1.2 0-2.2-.98-2.2-2.2v-13.2c0-1.2 1-2.2 2.2-2.2h13.2c1.2 0 2.2 1 2.2 2.2v13.2c0 1.22-1 2.2-2.2 2.2zm-11-4.4h8.8v-8.8h-8.8zM365.76 758.74h-13.2c-1.2 0-2.2-.98-2.2-2.2v-13.2c0-1.2 1-2.2 2.2-2.2h13.2c1.2 0 2.2 1 2.2 2.2v13.2c0 1.22-1 2.2-2.2 2.2zm-11-4.4h8.8v-8.8h-8.8zM365.76 782.93h-13.2c-1.2 0-2.2-1-2.2-2.2v-13.2c0-1.2 1-2.2 2.2-2.2h13.2c1.2 0 2.2 1 2.2 2.2v13.2c0 1.2-1 2.2-2.2 2.2zm-11-4.4h8.8v-8.8h-8.8zM347.52 751.5l-7.4 7.4-3.1-3.1 3.63-3.65h-18.87v-4.4h18.87l-3.64-3.66 3.13-3.1 7.4 7.4c.86.85.86 2.22 0 3.1zM346.3 726.88l-2.7 10.1-4.22-1.15 1.4-5.24-19.5 10.3-2.05-3.88 19.03-10.06-4.73-1.2 1.14-4.4 10.12 2.73c1.16.3 1.87 1.5 1.54 2.67 0 .04 0 .08-.03.1zM344.8 775.73l-10.1 2.8-1.18-4.4 4.73-1.3-19.04-10.05 2.05-3.86 19.5 10.3-1.38-5.16 4.25-1.14 2.72 10.1c.32 1.16-.38 2.37-1.55 2.7z" stroke="#fff" stroke-opacity="0" stroke-width="3" fill="#693cc5"/><g><use xlink:href="#i" transform="matrix(1,0,0,1,250,813.916978222929) translate(4.400000000000006 14.4)"/><use xlink:href="#j" transform="matrix(1,0,0,1,250,813.916978222929) translate(49.7 14.4)"/><use xlink:href="#k" transform="matrix(1,0,0,1,250,813.916978222929) translate(94.7 14.4)"/></g><path d="M390.94 749.94h93.72" stroke="#248814" stroke-width="2" fill="none"/><path d="M390.97 750.94h-1.04v-1l-.03-1h1.07z" fill="#248814"/><path d="M499.93 749.94l-14.27 4.64v-9.27z" stroke="#248814" stroke-width="2" fill="#248814"/><g class="lucid-layer" lucid:layer-id="-QuS0aksvo6h" display="block"><path d="M976.23 922.55c-.92.1-1.65.27-2.38.63l-31.7 15.63c-1.73.83-2.92 2.3-3.3 4.2l-7.84 35.18c-.36 1.64-.1 3.3.83 4.75.1.18.18.27.36.46l21.92 28.12c1.2 1.55 2.83 2.38 4.75 2.38h35.26c1.92 0 3.57-.83 4.75-2.38l21.93-28.13c1.2-1.57 1.65-3.4 1.2-5.3l-7.86-35.1c-.37-1.9-1.55-3.37-3.3-4.2l-31.7-15.62c-1-.45-1.9-.73-2.9-.63z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M976.2 920c-.95.1-1.72.3-2.5.68l-33.46 16.5c-1.83.85-3.08 2.4-3.47 4.42l-8.3 37.13c-.38 1.74-.1 3.47.87 5.02.1.2.2.28.4.48l23.13 29.7c1.26 1.64 3 2.5 5.02 2.5h37.2c2.04 0 3.78-.86 5.03-2.5l23.14-29.7c1.26-1.64 1.74-3.57 1.26-5.5l-8.3-37.13c-.38-2.02-1.64-3.57-3.47-4.43l-33.46-16.5c-1.06-.48-2.03-.77-3.1-.67zm0 2.6c1.07-.1 1.94.1 2.9.58l31.83 15.63c1.64.87 2.8 2.32 3.28 4.25l7.82 35.1c.4 1.93 0 3.67-1.16 5.2l-21.98 28.17c-1.16 1.54-2.8 2.4-4.73 2.4h-35.3c-1.92 0-3.56-.86-4.72-2.4l-22-28.16c-.1-.1-.18-.3-.28-.48-.96-1.45-1.25-3-.87-4.73l7.8-35.1c.5-1.93 1.56-3.38 3.3-4.24l31.82-15.62c.77-.38 1.44-.58 2.3-.67z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M968.67 1002.03c0 1.1.16 1.9.5 2.43.33.52.84.78 1.5.78.48 0 .87-.13 1.18-.4.32-.26.52-.66.6-1.2l1.33.08c-.1.8-.42 1.43-.98 1.9-.54.46-1.24.7-2.1.7-1.1 0-1.96-.36-2.54-1.08-.6-.73-.88-1.8-.88-3.2 0-1.37.3-2.42.88-3.15.6-.73 1.44-1.1 2.53-1.1.8 0 1.5.22 2.02.66.54.43.88 1.03 1.02 1.8l-1.36.1c-.07-.45-.25-.82-.53-1.08-.28-.28-.67-.4-1.2-.4-.7 0-1.2.23-1.52.7-.3.5-.46 1.3-.46 2.45zM979.84 1006.17v-5.2c0-.8-.1-1.35-.32-1.65-.2-.3-.6-.46-1.14-.46-.56 0-1 .23-1.33.67-.34.44-.5 1.07-.5 1.88v4.77h-1.32v-6.46c0-.95 0-1.53-.04-1.74h1.23l.02.2.02.4.03.8h.02c.28-.58.6-1 .98-1.2.37-.24.82-.35 1.34-.35.6 0 1.1.13 1.44.37.35.25.6.65.73 1.2h.03c.28-.56.62-.95 1-1.2.4-.24.86-.36 1.42-.36.8 0 1.4.23 1.76.68.38.45.56 1.2.56 2.22v5.47h-1.3v-5.2c0-.8-.12-1.35-.33-1.65-.2-.3-.6-.46-1.14-.46-.6 0-1.05.23-1.37.67-.3.44-.48 1.07-.48 1.88v4.77z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M967.65 946v4.38h31.14V946zM954.2 946v4.38h7.8V946zM978.97 957.68v4.37h19.83v-4.37z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M965.53 957.68v4.37h7.8v-4.37zM978.97 969.35v4.37h19.83v-4.37zM965.53 969.35v4.37h7.8v-4.37zM967.65 981v4.37h31.14V981zM954.2 981v4.37h7.8V981z" stroke="#000" stroke-opacity="0" stroke-width="2.99" fill="#fff"/><use xlink:href="#l" transform="matrix(1,0,0,1,898.2829974677805,1025.437761558135) translate(28.025 14.4)"/><use xlink:href="#m" transform="matrix(1,0,0,1,898.2829974677805,1025.437761558135) translate(81.025 14.4)"/><path d="M860.65 618.64h525.93V887.4H860.65z" stroke="#000" stroke-width="2" fill-opacity="0"/><path d="M845.65 570.72c-1.2.12-2.15.36-3.1.84l-41.4 20.4c-2.28 1.08-3.83 3-4.3 5.5l-10.28 45.94c-.47 2.15-.1 4.3 1.08 6.2.12.25.24.37.48.6l28.64 36.76c1.55 2.03 3.7 3.1 6.2 3.1h46.07c2.5 0 4.66-1.07 6.2-3.1l28.65-36.75c1.54-2.02 2.14-4.4 1.54-6.92l-10.26-45.82c-.48-2.5-2.03-4.42-4.3-5.5l-41.4-20.4c-1.32-.6-2.52-.95-3.83-.84z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M845.63 567.4c-1.26.13-2.26.38-3.27.88l-43.72 21.54c-2.4 1.14-4.03 3.15-4.54 5.8l-10.83 48.5c-.5 2.27-.13 4.54 1.13 6.56.13.25.26.37.5.63l30.24 38.8c1.64 2.15 3.9 3.3 6.56 3.3h48.63c2.64 0 4.9-1.15 6.55-3.3l30.23-38.8c1.65-2.14 2.28-4.66 1.65-7.17l-10.83-48.5c-.5-2.66-2.14-4.67-4.54-5.8l-43.72-21.55c-1.38-.63-2.64-1-4.03-.88zm0 3.4c1.4-.13 2.52.13 3.78.76l41.6 20.4c2.13 1.14 3.64 3.03 4.27 5.55l10.2 45.87c.5 2.52 0 4.8-1.5 6.8l-28.73 36.8c-1.5 2-3.65 3.14-6.17 3.14h-46.1c-2.53 0-4.68-1.12-6.2-3.14l-28.7-36.8c-.14-.1-.26-.37-.4-.62-1.25-1.9-1.63-3.9-1.12-6.17l10.2-45.86c.63-2.5 2.02-4.4 4.28-5.53l41.58-20.4c1.02-.52 1.9-.77 3.03-.9z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M839.74 674.56c0 3.74-1.28 5.62-3.83 5.62-1.6 0-2.68-.62-3.23-1.88h-.04c.03.06.03.62.03 1.7v4.2h-1.72v-12.77c0-1.1-.03-1.84-.07-2.2h1.68l.03.3.04.75.03.68h.03c.3-.65.72-1.14 1.23-1.44.5-.32 1.18-.47 2-.47 1.3 0 2.25.44 2.88 1.33.64.88.96 2.27.96 4.18zm-1.82.03c0-1.5-.2-2.57-.58-3.2-.4-.66-1.02-.97-1.87-.97-.7 0-1.23.15-1.62.45-.4.3-.68.76-.88 1.4-.2.6-.3 1.45-.3 2.45 0 1.42.22 2.45.65 3.12.43.66 1.14 1 2.13 1 .86 0 1.48-.32 1.87-.97.4-.66.6-1.75.6-3.3zM850.7 674.6c0 1.88-.4 3.28-1.2 4.2-.8.92-1.96 1.37-3.5 1.37-1.5 0-2.65-.47-3.43-1.42-.78-.97-1.17-2.35-1.17-4.15 0-3.7 1.56-5.56 4.68-5.56 1.6 0 2.75.46 3.5 1.36.76.9 1.13 2.3 1.13 4.2zm-1.8 0c0-1.48-.23-2.56-.66-3.23-.42-.67-1.13-1-2.14-1-1 0-1.75.33-2.2 1.02-.45.67-.68 1.74-.68 3.2 0 1.4.22 2.48.67 3.2.44.7 1.14 1.05 2.1 1.05 1.03 0 1.78-.33 2.22-1.02.44-.7.68-1.77.68-3.23zM859.45 678.25c-.32.68-.75 1.18-1.28 1.48-.53.3-1.2.44-1.97.44-1.3 0-2.28-.46-2.9-1.37-.62-.9-.93-2.3-.93-4.15 0-3.74 1.28-5.6 3.83-5.6.8 0 1.45.14 1.98.44.52.3.95.77 1.27 1.4v-5.65h1.72v12.5c0 1.13.03 1.87.07 2.23h-1.66c-.02-.1-.04-.36-.06-.75-.02-.37-.04-.7-.04-.98zm-5.26-3.66c0 1.5.18 2.57.57 3.22.4.65 1 .98 1.88.98.98 0 1.7-.36 2.13-1.06.44-.7.67-1.8.67-3.27 0-1.4-.23-2.46-.67-3.1-.44-.67-1.14-1-2.12-1-.87 0-1.5.33-1.9 1-.38.66-.57 1.73-.57 3.22z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M820.73 609.6l25.28-7.56 25.3 7.56-25.3 7.56zM820.73 612.5v27.72l23.55 13.46.12-33.94zM871.3 612.5v27.72l-23.56 13.46-.12-33.94z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1200 668.1h79.47v79.46H1200zM909 647.4h200v180.85H909z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#n" transform="matrix(1,0,0,1,914.0042589517759,652.3992306088841) translate(62.407407407407405 78.33680555555556)"/><use xlink:href="#o" transform="matrix(1,0,0,1,914.0042589517759,652.3992306088841) translate(55.685185185185176 107.6701388888889)"/><path d="M973.4 782.2c-.78.08-1.42.24-2.05.56l-27.47 13.54c-1.5.7-2.53 1.97-2.85 3.64l-6.8 30.47c-.32 1.44-.08 2.86.7 4.13.1.16.17.23.33.4l19 24.37c1.02 1.35 2.45 2.06 4.1 2.06h30.56c1.67 0 3.1-.7 4.12-2.06l19-24.38c1.03-1.34 1.42-2.93 1.03-4.6l-6.8-30.38c-.33-1.67-1.36-2.93-2.86-3.64l-27.46-13.54c-.87-.4-1.66-.63-2.53-.55z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M973.4 780c-.84.08-1.5.25-2.18.58l-29 14.3c-1.58.75-2.67 2.08-3 3.84l-7.2 32.17c-.32 1.5-.07 3 .77 4.33.07.17.15.26.32.42l20.05 25.74c1.1 1.4 2.6 2.16 4.35 2.16h32.26c1.75 0 3.25-.75 4.34-2.17l20.06-25.75c1.08-1.42 1.5-3.1 1.08-4.76l-7.18-32.18c-.34-1.76-1.43-3.1-3-3.85l-29-14.3c-.93-.4-1.76-.65-2.68-.57zm0 2.26c.92-.1 1.67.08 2.5.5l27.58 13.53c1.42.75 2.42 2 2.84 3.67l6.77 30.42c.32 1.66 0 3.16-1 4.5l-19.07 24.4c-1 1.34-2.42 2.1-4.1 2.1h-30.57c-1.68 0-3.1-.76-4.1-2.1l-19.05-24.4c-.07-.08-.16-.25-.24-.42-.84-1.25-1.1-2.6-.75-4.1l6.77-30.4c.42-1.68 1.34-2.93 2.85-3.7l27.57-13.52c.66-.34 1.24-.5 2-.6z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M969.58 854.67h-1.36l-2.5-7.12h1.22l1.52 4.63.44 1.56.22-.77.25-.77 1.57-4.65h1.22zM978.92 851.1c0 1.25-.26 2.18-.8 2.78-.52.62-1.3.92-2.3.92-1.02 0-1.78-.32-2.3-.95-.5-.64-.77-1.55-.77-2.75 0-2.46 1.03-3.68 3.1-3.68 1.05 0 1.83.3 2.33.9.5.6.74 1.53.74 2.78zm-1.2 0c0-.98-.15-1.7-.43-2.14-.3-.44-.77-.66-1.43-.66-.68 0-1.16.22-1.47.67-.3.45-.45 1.16-.45 2.13 0 .94.15 1.65.45 2.12.3.47.76.7 1.4.7.68 0 1.18-.22 1.47-.68.3-.46.45-1.17.45-2.14zM980.36 854.67v-9.77h1.15v9.77z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M952.2 813.5c0 2.98 9.6 5.4 21.45 5.4 11.83 0 21.44-2.42 21.44-5.4v14.54c0 2.96-9.62 5.37-21.45 5.37-11.84 0-21.44-2.4-21.44-5.36z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M952.2 813.5c0-2.95 9.6-5.36 21.45-5.36 11.83 0 21.44 2.4 21.44 5.37 0 2.98-9.62 5.38-21.45 5.38-11.84 0-21.44-2.4-21.44-5.37z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M973.64 807.5c-5.95 0-11.33.62-15.3 1.6-2 .5-3.58 1.1-4.77 1.78-1.14.7-1.98 1.54-1.98 2.63v14.55c0 1.08.83 1.93 1.97 2.62 1.2.7 2.78 1.28 4.77 1.78 3.97.98 9.35 1.6 15.3 1.6 5.96 0 11.34-.62 15.3-1.6 2-.5 3.58-1.1 4.77-1.78 1.16-.7 2-1.54 2-2.62V813.5c0-1.08-.84-1.93-2-2.62-1.18-.7-2.77-1.27-4.75-1.78-3.97-.98-9.35-1.6-15.3-1.6zm0 1.28c5.87 0 11.2.6 15 1.54 1.94.48 3.44 1.06 4.46 1.65 1 .58 1.36 1.17 1.36 1.54 0 .4-.35.96-1.36 1.55-1.02.6-2.52 1.16-4.46 1.64-3.8.95-9.13 1.56-15 1.56-5.86 0-11.2-.6-15-1.57-1.94-.5-3.44-1.04-4.45-1.65-1.02-.6-1.38-1.15-1.38-1.54 0-.36.36-.95 1.37-1.53 1-.6 2.5-1.17 4.45-1.65 3.8-.95 9.13-1.54 15-1.54zm-20.82 6.37c.18.37.36.7.75 1 1.1.83 2.78 1.28 4.77 1.8 3.97.97 9.35 1.55 15.3 1.55 5.96 0 11.34-.58 15.3-1.56 2-.5 3.58-1.1 4.77-1.78.45-.32.63-.72.76-1v12.9c0 .36-.35.94-1.36 1.52-1.02.6-2.52 1.17-4.46 1.65-3.8.95-9.13 1.54-15 1.54-5.86 0-11.2-.6-15-1.54-1.94-.48-3.44-1.06-4.45-1.65-1.02-.58-1.38-1.16-1.38-1.53z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#326ce5"/><path d="M977.5 919.02c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4.1c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4.1c0 .54-.45 1-1 1s-1-.46-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4.12c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-4.1c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4.1c0 .54-.45 1-1 1s-1-.46-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4.12c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-4.1c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4.1c0 .54-.45 1-1 1s-1-.46-1-1c0-.56.45-1 1-1s1 .44 1 1z"/><path d="M977.5 920.1l-1.3-.1-.7.12V919h2z"/><path d="M976.5 866.8l4.64 14.26h-9.27z" stroke="#000" stroke-width="2"/><path d="M1220 688.1h79.47v79.46H1220z" stroke="#000" stroke-width="2" fill="#fff"/><path d="M1240 708.1h79.47v79.46H1240z" stroke="#000" stroke-width="2" fill="#fff"/><path d="M1260 728.1h79.47v79.46H1260z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#p" transform="matrix(1,0,0,1,1265,733.0875815632213) translate(-0.8209876543209873 38.111111111111114)"/><path d="M1451.07 320.8h200v120h-200z" stroke="#000" stroke-width="2" fill="#ffdba9"/><path d="M1427.54 363.67h240v60h-240z" stroke="#000" stroke-opacity="0" stroke-width="2" fill="#fff" fill-opacity="0"/><use xlink:href="#q" transform="matrix(1,0,0,1,1432.5369148474026,368.6683373580688) translate(52.64999999999999 30.025)"/><path d="M1455.43 282.28c-.82.1-1.48.25-2.13.58l-28.44 14c-1.56.75-2.63 2.06-2.95 3.78l-7.04 31.56c-.33 1.47-.08 2.95.74 4.26.08.16.16.24.32.4l19.67 25.25c1.06 1.4 2.54 2.14 4.26 2.14h31.63c1.7 0 3.2-.74 4.26-2.13l19.67-25.23c1.06-1.4 1.47-3.04 1.06-4.76l-7.06-31.46c-.32-1.72-1.4-3.03-2.95-3.77l-28.45-14c-.9-.42-1.72-.67-2.62-.6z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M1455.42 280c-.87.1-1.56.26-2.25.6l-30.03 14.8c-1.64.78-2.76 2.16-3.1 3.98l-7.45 33.3c-.36 1.57-.1 3.13.77 4.5.08.18.17.27.34.44l20.78 26.65c1.12 1.47 2.68 2.25 4.5 2.25h33.4c1.8 0 3.37-.78 4.5-2.25l20.76-26.65c1.12-1.47 1.56-3.2 1.12-4.93l-7.44-33.32c-.34-1.82-1.47-3.2-3.1-3.98l-30.04-14.8c-.95-.43-1.8-.7-2.76-.6zm0 2.34c.95-.1 1.73.08 2.6.52l28.54 14c1.47.8 2.5 2.1 2.95 3.82l7 31.5c.36 1.72 0 3.28-1.02 4.66l-19.73 25.27c-1.04 1.4-2.5 2.17-4.24 2.17h-31.66c-1.73 0-3.2-.78-4.24-2.16l-19.72-25.26c-.1-.08-.18-.26-.26-.43-.87-1.3-1.13-2.67-.78-4.23l7-31.5c.44-1.72 1.4-3.02 2.95-3.8l28.54-14c.7-.36 1.3-.53 2.08-.62z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M1440.97 356.13c-.22.47-.5.8-.88 1-.37.2-.82.32-1.36.32-.9 0-1.57-.32-2-.95-.4-.62-.63-1.57-.63-2.84 0-2.58.9-3.86 2.64-3.86.55 0 1 .1 1.36.3.36.22.65.54.87.98v-3.88h1.2v8.6c0 .76 0 1.27.03 1.5h-1.14l-.04-.5c-.02-.25-.02-.48-.02-.67zm-3.6-2.5c0 1.02.13 1.76.4 2.2.26.45.68.67 1.28.67.67 0 1.16-.24 1.46-.72.32-.48.47-1.23.47-2.25 0-.97-.15-1.7-.46-2.14-.3-.46-.77-.7-1.44-.7-.6 0-1.03.24-1.3.7-.26.45-.4 1.2-.4 2.22zM1444.9 353.9c0 .83.17 1.5.5 1.94.35.46.85.7 1.5.7.5 0 .93-.12 1.24-.33.3-.2.52-.47.63-.8l1.05.3c-.43 1.17-1.4 1.75-2.92 1.75-1.06 0-1.87-.32-2.42-.97-.55-.65-.83-1.62-.83-2.9 0-1.2.28-2.15.83-2.8.55-.65 1.35-.97 2.38-.97 2.1 0 3.15 1.3 3.15 3.92v.17zm3.87-.95c-.06-.78-.25-1.35-.57-1.7-.32-.36-.77-.54-1.36-.54-.58 0-1.04.2-1.38.6-.34.4-.52.95-.54 1.65zM1457.57 353.6c0 2.56-.87 3.85-2.63 3.85-1.1 0-1.84-.43-2.22-1.3h-.03c0 .05.02.44.02 1.17v2.88h-1.2v-8.76c0-.76 0-1.26-.03-1.5h1.14l.02.2c0 .1 0 .27.03.5v.48h.03c.2-.45.5-.78.84-1 .35-.2.8-.3 1.37-.3.9 0 1.54.3 1.98.9.44.6.65 1.56.65 2.87zm-1.24 0c0-1-.14-1.74-.4-2.18-.28-.45-.7-.67-1.3-.67-.46 0-.83.1-1.1.32-.27.2-.47.52-.6.95-.15.43-.2 1-.2 1.7 0 .96.14 1.67.44 2.13.3.46.78.68 1.46.68.6 0 1-.2 1.28-.66.3-.45.43-1.2.43-2.26zM1459.06 357.3v-10.1h1.2v10.1zM1468.12 353.62c0 1.3-.27 2.25-.82 2.88-.55.63-1.36.95-2.4.95-1.05 0-1.83-.33-2.37-.98-.53-.67-.8-1.6-.8-2.85 0-2.55 1.07-3.82 3.2-3.82 1.1 0 1.9.32 2.42.94.5.62.77 1.58.77 2.88zm-1.25 0c0-1.02-.15-1.76-.44-2.22-.3-.46-.78-.7-1.47-.7-.7 0-1.2.24-1.52.72-.3.46-.46 1.2-.46 2.2 0 .97.15 1.7.46 2.2.3.48.8.72 1.44.72.72 0 1.23-.23 1.53-.7.3-.48.47-1.22.47-2.22zM1469.96 360.2c-.33 0-.6-.02-.82-.07v-.92c.17.04.35.05.55.05.73 0 1.32-.56 1.75-1.68l.12-.3-2.84-7.33h1.27l1.5 4.07c.03.08.05.16.1.24 0 .1.1.4.28.9l.27.83.46-1.34 1.58-4.7h1.26l-2.75 7.38c-.3.8-.58 1.37-.84 1.76-.25.38-.54.67-.85.86-.3.2-.65.28-1.04.28z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M1453.56 342.07c-11.7.57-21.68-8.7-22.28-20.75-.64-12.1 8.3-22.42 20.03-23.13 11.72-.7 21.77 8.43 22.54 20.52l-8.43.57c-.46-7.3-6.5-12.84-13.58-12.4-7.08.4-12.5 6.64-12.1 13.93.34 7.3 6.4 12.88 13.46 12.58z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1457.94 318.73l6.7 16.9 15.47-16.9z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1504.48 542.72c-.98.1-1.76.3-2.54.68l-33.86 16.7c-1.85.87-3.12 2.43-3.5 4.48l-8.4 37.57c-.4 1.75-.1 3.5.87 5.07.1.2.2.3.4.5l23.4 30.05c1.28 1.65 3.04 2.53 5.1 2.53h37.66c2.06 0 3.8-.88 5.08-2.53l23.42-30.06c1.27-1.65 1.76-3.6 1.27-5.65l-8.4-37.47c-.38-2.05-1.65-3.6-3.5-4.5l-33.87-16.68c-1.07-.5-2.05-.78-3.12-.68z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M1504.47 540c-1.03.1-1.86.3-2.68.72l-35.76 17.62c-1.96.92-3.3 2.57-3.7 4.74l-8.87 39.66c-.4 1.85-.1 3.7.93 5.35.1.2.2.3.4.5l24.74 31.74c1.33 1.75 3.2 2.68 5.35 2.68h39.76c2.16 0 4-.93 5.35-2.68l24.74-31.73c1.34-1.74 1.85-3.8 1.34-5.86l-8.86-39.66c-.4-2.17-1.75-3.82-3.7-4.74l-35.76-17.62c-1.13-.5-2.16-.82-3.3-.72zm0 2.78c1.13-.1 2.06.1 3.1.62l33.98 16.7c1.75.92 3 2.46 3.5 4.52l8.35 37.5c.4 2.06 0 3.9-1.24 5.56l-23.5 30.08c-1.22 1.65-2.97 2.58-5.03 2.58h-37.7c-2.07 0-3.82-.93-5.06-2.58l-23.48-30.08c-.12-.1-.22-.3-.32-.5-1.03-1.56-1.34-3.2-.93-5.06l8.34-37.5c.5-2.06 1.64-3.6 3.5-4.53l34-16.7c.82-.4 1.54-.62 2.47-.72z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M1496.4 627.62c0 1.17.18 2.03.54 2.6.35.56.9.84 1.6.84.52 0 .93-.14 1.27-.42.35-.3.56-.7.64-1.3l1.43.1c-.1.84-.46 1.52-1.05 2.02-.58.5-1.32.75-2.23.75-1.2 0-2.1-.37-2.74-1.14-.62-.8-.94-1.92-.94-3.4s.32-2.6.95-3.38c.62-.78 1.53-1.17 2.7-1.17.88 0 1.6.25 2.17.7.58.48.94 1.1 1.08 1.93l-1.45.1c-.08-.47-.26-.86-.56-1.15-.3-.3-.7-.42-1.26-.42-.75 0-1.3.25-1.64.76-.33.52-.5 1.38-.5 2.6zM1508.34 632.05v-5.57c0-.84-.12-1.43-.34-1.75-.23-.33-.63-.5-1.22-.5-.6 0-1.07.25-1.42.73-.36.47-.53 1.14-.53 2v5.1h-1.42v-6.9c0-1.04 0-1.65-.03-1.9h1.33l.02.24.02.4.03.88h.02c.3-.63.65-1.06 1.04-1.3.4-.24.87-.37 1.44-.37.64 0 1.16.15 1.53.4.38.28.64.7.8 1.28.3-.6.67-1 1.08-1.27.42-.25.92-.4 1.52-.4.86 0 1.48.25 1.87.74.4.48.6 1.27.6 2.37v5.85h-1.4v-5.57c0-.84-.12-1.43-.35-1.75-.22-.33-.63-.5-1.22-.5-.62 0-1.1.25-1.44.73-.34.47-.52 1.14-.52 2v5.1z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M1495.32 567.8v4.66h33.27v-4.67zM1480.96 567.8v4.66h8.34v-4.67zM1507.4 580.25v4.67h21.2v-4.67z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1493.05 580.25v4.67h8.34v-4.67zM1507.4 592.7v4.68h21.2v-4.67zM1493.05 592.7v4.68h8.34v-4.67zM1495.32 605.16v4.67h33.27v-4.67zM1480.96 605.16v4.67h8.34v-4.67z" stroke="#000" stroke-opacity="0" stroke-width="2.99" fill="#fff"/><path d="M1504.56 406.4c-.73.07-1.3.2-1.9.5l-25.1 12.38c-1.38.65-2.32 1.8-2.6 3.33l-6.24 27.88c-.3 1.3-.07 2.6.65 3.76.08.15.15.22.3.36l17.37 22.3c.94 1.23 2.24 1.88 3.76 1.88h27.95c1.52 0 2.82-.65 3.76-1.88l17.38-22.3c.94-1.23 1.3-2.67.94-4.2l-6.22-27.8c-.3-1.5-1.23-2.67-2.6-3.32l-25.13-12.38c-.8-.36-1.52-.58-2.3-.5z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M1504.55 404.38c-.77.07-1.38.23-2 .53l-26.5 13.08c-1.46.7-2.45 1.9-2.76 3.5l-6.58 29.44c-.3 1.37-.08 2.75.7 3.97.06.14.14.22.3.37l18.33 23.54c1 1.3 2.37 2 3.98 2h29.5c1.6 0 2.97-.7 3.97-2l18.34-23.53c1-1.3 1.37-2.83 1-4.35l-6.58-29.43c-.3-1.6-1.3-2.83-2.75-3.52L1507 404.9c-.85-.37-1.6-.6-2.45-.52zm0 2.06c.84-.08 1.52.08 2.3.46l25.2 12.38c1.3.7 2.22 1.83 2.6 3.36l6.2 27.82c.3 1.53 0 2.9-.92 4.12l-17.43 22.32c-.9 1.22-2.2 1.9-3.74 1.9h-27.97c-1.54 0-2.84-.68-3.75-1.9l-17.43-22.32c-.07-.07-.15-.23-.23-.38-.77-1.14-1-2.37-.7-3.74l6.2-27.82c.38-1.53 1.22-2.67 2.6-3.36l25.2-12.38c.62-.3 1.16-.46 1.85-.54z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M1501.05 472.66h-1.24l-2.28-6.5h1.12l1.4 4.23.4 1.42.2-.7.22-.72 1.44-4.25h1.1zM1509.6 469.4c0 1.14-.24 2-.73 2.54-.5.56-1.2.84-2.12.84-.92 0-1.62-.3-2.1-.86-.46-.6-.7-1.43-.7-2.52 0-2.25.95-3.37 2.84-3.37.95 0 1.66.28 2.12.82.45.55.68 1.4.68 2.55zm-1.1 0c0-.9-.14-1.55-.4-1.96-.25-.4-.7-.6-1.3-.6-.6 0-1.06.2-1.33.6-.27.43-.42 1.07-.42 1.96 0 .86.14 1.5.4 1.94.28.43.7.64 1.3.64.62 0 1.07-.2 1.34-.62.26-.42.4-1.08.4-1.96zM1510.9 472.66v-8.93h1.06v8.93z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M1485.17 435.03c0 2.7 8.78 4.9 19.6 4.9 10.83 0 19.6-2.2 19.6-4.9v13.28c0 2.72-8.77 4.92-19.6 4.92-10.82 0-19.6-2.2-19.6-4.9z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1485.17 435.03c0-2.72 8.78-4.92 19.6-4.92 10.83 0 19.6 2.2 19.6 4.93 0 2.7-8.77 4.9-19.6 4.9-10.82 0-19.6-2.2-19.6-4.9z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1504.77 429.54c-5.45 0-10.37.55-14 1.45-1.8.45-3.27 1-4.35 1.62-1.05.63-1.82 1.4-1.82 2.4v13.3c0 1 .77 1.77 1.82 2.4 1.08.63 2.54 1.16 4.35 1.62 3.63.9 8.55 1.46 14 1.46 5.45 0 10.37-.56 14-1.46 1.8-.46 3.27-1 4.36-1.62 1.04-.63 1.8-1.4 1.8-2.4v-13.3c0-1-.76-1.77-1.8-2.4-1.1-.63-2.55-1.17-4.36-1.63-3.63-.9-8.55-1.46-14-1.46zm0 1.16c5.37 0 10.25.53 13.72 1.4 1.76.44 3.13.98 4.06 1.5.93.55 1.25 1.08 1.25 1.42 0 .36-.3.87-1.24 1.4-.93.56-2.3 1.07-4.07 1.5-3.48.88-8.36 1.44-13.73 1.44-5.37 0-10.25-.56-13.72-1.43-1.77-.44-3.14-.95-4.07-1.5-.93-.54-1.25-1.05-1.25-1.4 0-.35.32-.88 1.25-1.42.93-.52 2.3-1.06 4.07-1.5 3.47-.87 8.35-1.4 13.72-1.4zm-19.04 5.82c.16.34.32.63.7.93 1 .75 2.53 1.16 4.34 1.62 3.63.9 8.55 1.43 14 1.43 5.45 0 10.37-.53 14-1.43 1.8-.46 3.27-1 4.36-1.62.4-.3.56-.66.68-.93v11.8c0 .33-.3.87-1.24 1.4-.93.54-2.3 1.07-4.07 1.5-3.48.88-8.36 1.4-13.73 1.4-5.37 0-10.25-.52-13.72-1.4-1.77-.43-3.14-.96-4.07-1.5-.93-.53-1.25-1.07-1.25-1.4z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#326ce5"/><path d="M1505.77 481.8c0 .55-.44 1-1 1-.55 0-1-.45-1-1 0-.56.45-1 1-1 .56 0 1 .44 1 1zm0 3.97c0 .55-.44 1-1 1-.55 0-1-.45-1-1s.45-1 1-1c.56 0 1 .45 1 1zm0 3.97c0 .55-.44 1-1 1-.55 0-1-.45-1-1s.45-1 1-1c.56 0 1 .45 1 1zm0 3.97c0 .57-.44 1-1 1-.55 0-1-.43-1-1 0-.54.45-1 1-1 .56 0 1 .46 1 1zm0 4c0 .54-.44 1-1 1-.55 0-1-.46-1-1 0-.57.45-1 1-1 .56 0 1 .43 1 1zm0 3.96c0 .55-.44 1-1 1-.55 0-1-.45-1-1s.45-1 1-1c.56 0 1 .45 1 1zm0 3.97c0 .55-.44 1-1 1-.55 0-1-.45-1-1s.45-1 1-1c.56 0 1 .45 1 1zm0 3.97c0 .56-.44 1-1 1-.55 0-1-.44-1-1 0-.55.45-1 1-1 .56 0 1 .45 1 1zm0 3.98c0 .55-.44 1-1 1-.55 0-1-.45-1-1 0-.56.45-1 1-1 .56 0 1 .44 1 1zm0 3.97c0 .55-.44 1-1 1-.55 0-1-.45-1-1s.45-1 1-1c.56 0 1 .45 1 1z"/><path d="M1505.77 481.82h-2v-1.02h2z"/><path d="M1504.77 536.8l-4.63-14.28h9.27z" stroke="#000" stroke-width="2"/><path d="M1400 620h209.55v117.47H1400z" stroke="#000" stroke-opacity="0" stroke-width="2" fill="#fff" fill-opacity="0"/><use xlink:href="#r" transform="matrix(1,0,0,1,1405,625) translate(34.04938271604938 47.97222222222222)"/><use xlink:href="#s" transform="matrix(1,0,0,1,1405,625) translate(130.49382716049382 47.97222222222222)"/><use xlink:href="#t" transform="matrix(1,0,0,1,1405,625) translate(41.80246913580246 69.30555555555556)"/><use xlink:href="#u" transform="matrix(1,0,0,1,1405,625) translate(115.77777777777777 69.30555555555556)"/><path d="M1593.82 901.3c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-3.98c0 .54-.45 1-1 1s-1-.46-1-1c0-.57.45-1 1-1s1 .43 1 1zm0-4c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-3.98c0 .54-.45 1-1 1s-1-.46-1-1c0-.57.45-1 1-1s1 .43 1 1zm0-4c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .54-.45 1-1 1s-1-.46-1-1c0-.57.45-1 1-1s1 .43 1 1zm0-4c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .57-.45 1-1 1s-1-.43-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.97c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .56-.45 1-1 1s-1-.44-1-1c0-.55.45-1 1-1s1 .45 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1c0-.56.45-1 1-1s1 .44 1 1zm0-4c0 .56-.45 1-1 1s-1-.44-1-1c0-.54.45-1 1-1s1 .46 1 1zm0-3.98c0 .55-.45 1-1 1s-1-.45-1-1 .45-1 1-1 1 .45 1 1z"/><path d="M1592.82 916.56l-4.63-14.27h9.26z" stroke="#000" stroke-width="2"/><path d="M1593.82 442.82h-2v-1.02h2z"/><path d="M480 669.94h160V840H480z" stroke="#000" stroke-width="2" fill="#fff"/><path d="M559.66 693.1c-1.14.1-2.05.34-2.96.8l-39.44 19.43c-2.16 1.03-3.64 2.85-4.1 5.23l-9.77 43.77c-.47 2.04-.13 4.1 1 5.9.12.23.24.35.47.57l27.28 35c1.48 1.95 3.52 2.97 5.9 2.97h43.9c2.37 0 4.42-1.02 5.9-2.96l27.28-35c1.48-1.93 2.05-4.2 1.48-6.6l-9.77-43.64c-.45-2.38-1.93-4.2-4.1-5.23L563.3 693.9c-1.26-.57-2.4-.9-3.64-.8z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M559.64 689.94c-1.2.12-2.16.36-3.12.84l-41.64 20.52c-2.28 1.08-3.84 3-4.32 5.52l-10.32 46.2c-.48 2.16-.12 4.32 1.08 6.24.12.24.24.36.48.6l28.8 36.96c1.56 2.04 3.72 3.12 6.24 3.12h46.32c2.52 0 4.68-1.08 6.24-3.12l28.8-36.96c1.56-2.04 2.16-4.44 1.56-6.96l-10.32-46.08c-.48-2.52-2.04-4.44-4.32-5.52l-41.64-20.52c-1.32-.6-2.52-.96-3.84-.84zm0 3.24c1.32-.12 2.4.12 3.6.72l39.6 19.44c2.04 1.08 3.48 2.88 4.08 5.28l9.72 43.68c.48 2.4 0 4.56-1.44 6.48l-27.36 35.04c-1.44 1.92-3.48 3-5.88 3h-43.92c-2.4 0-4.44-1.08-5.88-3l-27.36-35.04c-.12-.12-.24-.36-.36-.6-1.2-1.8-1.56-3.72-1.08-5.88l9.72-43.68c.6-2.4 1.92-4.2 4.08-5.28l39.6-19.44c.96-.48 1.8-.72 2.88-.72z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M554.43 794.32c0 .96-.35 1.7-1.07 2.23-.7.52-1.68.78-2.96.78-1.23 0-2.18-.2-2.85-.62-.67-.4-1.1-1.07-1.3-1.96l1.45-.3c.14.56.43.96.87 1.22s1.05.38 1.83.38c.84 0 1.45-.14 1.84-.4.4-.26.58-.67.58-1.2 0-.4-.13-.72-.4-.98-.27-.24-.7-.45-1.3-.62l-1.18-.32c-.95-.25-1.63-.5-2.03-.74-.4-.24-.7-.54-.92-.9-.23-.33-.34-.76-.34-1.26 0-.93.32-1.64.96-2.12.65-.5 1.6-.74 2.83-.74 1.1 0 1.95.2 2.6.6.65.4 1.06 1.03 1.23 1.9l-1.5.2c-.08-.46-.33-.8-.73-1.05-.4-.24-.93-.35-1.6-.35-.75 0-1.3.1-1.66.35-.35.23-.53.58-.53 1.05 0 .3.07.53.22.72.15.18.36.35.65.48.3.14.9.32 1.83.55.87.22 1.5.43 1.9.63.37.2.67.4.9.64.22.23.4.5.52.8.12.3.18.66.18 1.05zM560.72 797.13h-1.95l-3.6-10.22h1.76l2.18 6.66c.08.25.3 1 .64 2.24l.32-1.1.36-1.12 2.25-6.67h1.75zM567 792c0 1.35.22 2.36.63 3 .4.67 1.05 1 1.88 1 .6 0 1.1-.17 1.47-.5.4-.33.65-.83.74-1.5l1.68.1c-.13 1-.54 1.77-1.22 2.35-.68.6-1.55.88-2.6.88-1.4 0-2.45-.44-3.18-1.34-.73-.92-1.1-2.24-1.1-3.98 0-1.7.37-3.03 1.1-3.93.73-.9 1.8-1.37 3.15-1.37 1.02 0 1.86.28 2.53.82.67.54 1.1 1.28 1.26 2.24l-1.7.1c-.08-.55-.3-1-.65-1.33-.34-.34-.84-.5-1.48-.5-.88 0-1.5.3-1.9.9-.4.6-.6 1.6-.6 3.02z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M523.93 759.07h19.35v14h-19.35zM550.32 759.07h19.35v14h-19.35zM576.73 759.07h19.34v14h-19.34zM544.67 717.6h30.65v14h-30.65z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M558.23 731.58v11.93h-24.6c-1 0-1.77.83-1.77 1.82v13.74h3.5v-11.93H560c.98 0 1.75-.8 1.75-1.8v-13.75z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M558.25 731.58v13.74c0 1.02.77 1.8 1.76 1.8h24.6v11.94h3.54v-13.74c0-1-.78-1.8-1.76-1.8h-24.64v-11.94z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M558.18 731.58v13.74c0 .22.04.44.12.63v13.1h3.52v-13.73c0-.22-.04-.4-.12-.63v-13.12z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M889.5 753.02H642" stroke="#248814" stroke-width="2" fill="none"/><path d="M904.77 753.02l-14.27 4.63v-9.27z" stroke="#248814" stroke-width="2" fill="#248814"/><path d="M642.03 754.02H641v-2h1.03z" fill="#248814"/><path d="M1040.4 645.4v-9.94m0-9.93v-19.88m0-9.93v-19.87m0-9.94v-19.86m0-9.94v-19.87m0-9.94V486.4m0-9.93v-19.9m0-9.92V426.8m0-9.93V397m0-9.94v-6.26h13.6m9.93 0h19.87m9.94 0h19.87m9.95 0h19.87m9.93 0h19.88m9.93 0h19.87m9.94 0h19.87m9.94 0h19.87m9.94 0h19.86m9.94 0h19.87m9.93 0h19.88m9.93 0h19.88m9.94 0h19.87m9.93 0h9.93" stroke="#000" stroke-width="2" fill="none"/><path d="M1041.4 646.4h-2v-1.03h2z"/><path d="M1446.83 380.8l-14.27 4.63v-9.27z" stroke="#000" stroke-width="2"/><use xlink:href="#v" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(0 14.4)"/><use xlink:href="#w" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(53 14.4)"/><use xlink:href="#x" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(117.95 14.4)"/><use xlink:href="#y" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(151.9 14.4)"/><use xlink:href="#z" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(175.9 14.4)"/><use xlink:href="#A" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(0 36)"/><use xlink:href="#B" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(30.95 36)"/><use xlink:href="#C" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(60.95 36)"/><use xlink:href="#D" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(96.9 36)"/><use xlink:href="#E" transform="matrix(1,0,0,1,1099.7666666666696,333.59509752825744) translate(133.7 36)"/><path d="M1079.5 627.9v-10.14m0-10.13v-20.26m0-10.14v-20.26m0-10.14v-20.26m0-10.14v-20.26m0-10.13v-20.27m0-10.13v-20.27m0-10.13v-5.34h14.9m10.15 0h20.26m10.14 0h20.27m10.14 0h20.27m10.14 0H1216m10.14 0h20.27m10.14 0h20.27m10.14 0h20.27m10.14 0h20.26m10.14 0H1368m10.14 0h20.26m10.13 0h20.27m10.13 0h10.14" stroke="#000" stroke-width="2" fill="none"/><path d="M1079.5 643.16l-4.65-14.26h9.27z" stroke="#000" stroke-width="2"/><path d="M1450.07 420.9h-1.03v-2h1.03z"/><use xlink:href="#F" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(0 14.4)"/><use xlink:href="#w" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(112.8 14.4)"/><use xlink:href="#G" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(177.75 14.4)"/><use xlink:href="#H" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(0 36)"/><use xlink:href="#B" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(25 36)"/><use xlink:href="#I" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(55 36)"/><use xlink:href="#B" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(98.9 36)"/><use xlink:href="#w" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(128.9 36)"/><use xlink:href="#J" transform="matrix(1,0,0,1,1123.7666666666698,423.8969914541981) translate(193.85000000000002 36)"/><path d="M1111 752.63h50.5" stroke="#248814" stroke-width="2" fill="none"/><path d="M1111.03 753.63H1110v-2h1.03z" fill="#248814"/><path d="M1176.76 752.63l-14.26 4.64V748z" stroke="#248814" stroke-width="2" fill="#248814"/><path d="M1483.48 920.8h200v120h-200z" stroke="#000" stroke-width="2" fill="#ffdba9"/><path d="M1459.95 963.67h240v60h-240z" stroke="#000" stroke-opacity="0" stroke-width="2" fill="#fff" fill-opacity="0"/><g><use xlink:href="#K" transform="matrix(1,0,0,1,1464.9520599786297,968.6683373580688) translate(57.125 30.025)"/><use xlink:href="#L" transform="matrix(1,0,0,1,1464.9520599786297,968.6683373580688) translate(124.875 30.025)"/></g><path d="M1487.84 882.28c-.82.1-1.47.25-2.13.58l-28.43 14c-1.55.75-2.62 2.06-2.95 3.78l-7.05 31.56c-.32 1.47-.08 2.95.74 4.26.1.16.17.24.34.4l19.67 25.25c1.08 1.4 2.55 2.14 4.27 2.14h31.64c1.73 0 3.2-.74 4.27-2.13l19.67-25.23c1.07-1.4 1.48-3.04 1.07-4.76l-7.04-31.46c-.33-1.72-1.4-3.03-2.95-3.77l-28.43-14c-.9-.42-1.72-.67-2.63-.6z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M1487.83 880c-.86.1-1.56.26-2.25.6l-30.02 14.8c-1.64.78-2.77 2.16-3.12 3.98l-7.44 33.3c-.34 1.57-.08 3.13.78 4.5.1.18.18.27.35.44l20.76 26.65c1.12 1.47 2.68 2.25 4.5 2.25h33.4c1.8 0 3.36-.78 4.5-2.25l20.75-26.65c1.13-1.47 1.56-3.2 1.13-4.93l-7.44-33.32c-.35-1.82-1.47-3.2-3.12-3.98l-30.02-14.8c-.95-.43-1.82-.7-2.77-.6zm0 2.34c.95-.1 1.73.08 2.6.52l28.55 14c1.47.8 2.5 2.1 2.94 3.82l7 31.5c.36 1.72 0 3.28-1.03 4.66l-19.74 25.27c-1.03 1.4-2.5 2.17-4.24 2.17h-31.66c-1.73 0-3.2-.78-4.24-2.16l-19.73-25.26c-.1-.08-.18-.26-.27-.43-.86-1.3-1.12-2.67-.78-4.23l7-31.5c.44-1.72 1.4-3.02 2.95-3.8l28.55-14c.7-.36 1.3-.53 2.08-.62z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M1473.4 956.13c-.23.47-.52.8-.9 1-.36.2-.8.32-1.34.32-.9 0-1.57-.32-2-.95-.42-.62-.63-1.57-.63-2.84 0-2.58.88-3.86 2.63-3.86.54 0 1 .1 1.36.3.36.22.65.54.87.98v-3.88h1.17v8.6c0 .76.02 1.27.05 1.5h-1.14c0-.06-.03-.23-.04-.5l-.03-.67zm-3.62-2.5c0 1.02.13 1.76.4 2.2.26.45.7.67 1.28.67.68 0 1.17-.24 1.47-.72.3-.48.46-1.23.46-2.25 0-.97-.17-1.7-.47-2.14-.3-.46-.8-.7-1.45-.7-.6 0-1.03.24-1.3.7-.27.45-.4 1.2-.4 2.22zM1477.32 953.9c0 .83.17 1.5.5 1.94.35.46.84.7 1.5.7.5 0 .92-.12 1.23-.33.32-.2.52-.47.63-.8l1.05.3c-.42 1.17-1.4 1.75-2.9 1.75-1.08 0-1.88-.32-2.43-.97-.56-.65-.83-1.62-.83-2.9 0-1.2.27-2.15.83-2.8.55-.65 1.34-.97 2.37-.97 2.1 0 3.15 1.3 3.15 3.92v.17zm3.87-.95c-.07-.78-.26-1.35-.58-1.7-.32-.36-.78-.54-1.37-.54-.58 0-1.04.2-1.38.6-.33.4-.5.95-.54 1.65zM1490 953.6c0 2.56-.9 3.85-2.64 3.85-1.1 0-1.84-.43-2.22-1.3h-.03c.03.05.03.44.03 1.17v2.88h-1.18v-8.76c0-.76-.02-1.26-.05-1.5h1.15l.02.2.03.5.02.48h.02c.22-.45.5-.78.84-1 .35-.2.8-.3 1.38-.3.88 0 1.54.3 1.97.9.44.6.66 1.56.66 2.87zm-1.26 0c0-1-.13-1.74-.4-2.18-.27-.45-.7-.67-1.28-.67-.48 0-.84.1-1.1.32-.28.2-.48.52-.62.95-.14.43-.2 1-.2 1.7 0 .96.14 1.67.44 2.13.3.46.8.68 1.46.68.6 0 1.02-.2 1.3-.66.26-.45.4-1.2.4-2.26zM1491.48 957.3v-10.1h1.2v10.1zM1500.54 953.62c0 1.3-.28 2.25-.83 2.88-.54.63-1.34.95-2.4.95-1.03 0-1.82-.33-2.36-.98-.53-.67-.8-1.6-.8-2.85 0-2.55 1.07-3.82 3.2-3.82 1.1 0 1.9.32 2.42.94.52.62.78 1.58.78 2.88zm-1.25 0c0-1.02-.16-1.76-.46-2.22-.3-.46-.78-.7-1.47-.7-.7 0-1.2.24-1.5.72-.32.46-.48 1.2-.48 2.2 0 .97.14 1.7.45 2.2.3.48.8.72 1.45.72.7 0 1.22-.23 1.52-.7.3-.48.47-1.22.47-2.22zM1502.37 960.2c-.32 0-.6-.02-.82-.07v-.92c.17.04.36.05.56.05.75 0 1.34-.56 1.77-1.68l.1-.3-2.83-7.33h1.27l1.52 4.07.08.24.3.9.26.83.47-1.34 1.57-4.7h1.25l-2.75 7.38c-.3.8-.57 1.37-.82 1.76-.26.38-.54.67-.86.86-.3.2-.65.28-1.05.28z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M1485.98 942.07c-11.72.57-21.7-8.7-22.28-20.75-.64-12.1 8.3-22.42 20.02-23.13 11.72-.7 21.77 8.43 22.54 20.52l-8.44.57c-.47-7.3-6.52-12.84-13.6-12.4-7.06.4-12.47 6.64-12.1 13.93.35 7.3 6.4 12.88 13.47 12.58z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1490.35 918.73l6.7 16.9 15.48-16.9z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1538 1002.02c-.73.07-1.3.2-1.9.5l-25.1 12.38c-1.4.65-2.33 1.8-2.62 3.33l-6.22 27.87c-.3 1.3-.07 2.6.65 3.76.08.15.15.22.3.37l17.37 22.3c.94 1.22 2.25 1.87 3.77 1.87h27.94c1.52 0 2.82-.65 3.76-1.88l17.38-22.3c.94-1.22 1.3-2.67.94-4.2l-6.23-27.8c-.3-1.5-1.23-2.67-2.6-3.32l-25.12-12.38c-.8-.36-1.5-.58-2.3-.5z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#326ce5"/><path d="M1537.98 1000c-.76.08-1.38.23-2 .53l-26.5 13.07c-1.46.7-2.45 1.9-2.76 3.52l-6.57 29.42c-.3 1.37-.07 2.75.7 3.97.07.17.14.24.3.4l18.34 23.53c.98 1.3 2.36 2 3.96 2h29.5c1.6 0 2.98-.7 3.97-2l18.34-23.54c1-1.3 1.38-2.83 1-4.36l-6.58-29.42c-.3-1.6-1.3-2.83-2.76-3.52l-26.5-13.07c-.86-.38-1.62-.6-2.46-.53zm0 2.06c.84-.07 1.53.08 2.3.46l25.2 12.38c1.3.7 2.23 1.84 2.6 3.36l6.2 27.82c.3 1.53 0 2.9-.92 4.13l-17.42 22.32c-.92 1.22-2.22 1.9-3.75 1.9h-27.98c-1.52 0-2.82-.68-3.74-1.9l-17.42-22.3c-.08-.1-.16-.24-.23-.4-.77-1.14-1-2.36-.7-3.74l6.2-27.82c.38-1.52 1.22-2.67 2.6-3.36l25.22-12.38c.6-.3 1.14-.46 1.83-.53z" stroke="#000" stroke-opacity="0" stroke-width="3.83" fill="#fff"/><path d="M1534.5 1068.28h-1.26l-2.3-6.5h1.13l1.4 4.23.4 1.44.2-.7.22-.7 1.43-4.27h1.12zM1543.03 1065.02c0 1.14-.24 2-.73 2.55-.48.56-1.2.83-2.12.83-.92 0-1.6-.3-2.1-.86-.45-.6-.7-1.42-.7-2.52 0-2.25.95-3.37 2.84-3.37.97 0 1.67.28 2.13.83.46.54.68 1.4.68 2.54zm-1.1 0c0-.9-.13-1.55-.4-1.96-.25-.4-.68-.6-1.3-.6-.6 0-1.05.2-1.33.62-.27.4-.4 1.06-.4 1.94 0 .86.12 1.5.4 1.94.27.43.7.64 1.27.64.63 0 1.1-.2 1.35-.62.27-.42.4-1.07.4-1.96zM1544.35 1068.28v-8.93h1.05v8.93z" stroke="#000" stroke-opacity="0" fill="#fff"/><path d="M1518.6 1030.65c0 2.7 8.8 4.9 19.6 4.9 10.83 0 19.62-2.2 19.62-4.9v13.28c0 2.7-8.8 4.9-19.6 4.9-10.83 0-19.62-2.2-19.62-4.9z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1518.6 1030.65c0-2.7 8.8-4.9 19.6-4.9 10.83 0 19.62 2.2 19.62 4.9s-8.8 4.9-19.6 4.9c-10.83 0-19.62-2.2-19.62-4.9z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#fff"/><path d="M1538.2 1025.16c-5.44 0-10.36.56-14 1.45-1.8.48-3.26 1-4.35 1.64-1.05.63-1.82 1.4-1.82 2.4v13.3c0 1 .77 1.77 1.82 2.4 1.1.63 2.54 1.16 4.36 1.63 3.64.9 8.56 1.45 14 1.45 5.45 0 10.37-.56 14-1.45 1.82-.47 3.27-1 4.36-1.63 1.05-.63 1.8-1.4 1.8-2.4v-13.3c0-1-.75-1.77-1.8-2.4-1.1-.63-2.54-1.16-4.36-1.63-3.63-.88-8.55-1.44-14-1.44zm0 1.16c5.37 0 10.25.54 13.72 1.4 1.78.45 3.15.98 4.07 1.5.92.55 1.25 1.08 1.25 1.42 0 .37-.33.88-1.26 1.4-.93.57-2.3 1.08-4.08 1.5-3.47.9-8.35 1.44-13.72 1.44-5.36 0-10.24-.55-13.7-1.43-1.8-.43-3.16-.94-4.1-1.5-.9-.53-1.24-1.04-1.24-1.4 0-.35.33-.88 1.25-1.42.94-.53 2.3-1.06 4.1-1.5 3.46-.87 8.34-1.4 13.7-1.4zm-19.04 5.83c.17.34.33.63.7.92 1 .75 2.53 1.16 4.35 1.62 3.64.9 8.56 1.43 14 1.43 5.45 0 10.37-.54 14-1.44 1.82-.47 3.27-1 4.36-1.63.4-.3.56-.66.7-.92v11.8c0 .33-.34.86-1.27 1.4-.93.53-2.3 1.06-4.08 1.5-3.47.87-8.35 1.4-13.72 1.4-5.36 0-10.24-.53-13.7-1.4-1.8-.44-3.16-.97-4.1-1.5-.9-.54-1.24-1.07-1.24-1.4z" stroke="#000" stroke-opacity="0" stroke-width="3.77" fill="#326ce5"/></g><defs><path fill="#248814" d="M137 0h-34L2-248h35l83 218 83-218h36" id="M"/><path fill="#248814" d="M30-248c87 1 191-15 191 75 0 78-77 80-158 76V0H30v-248zm33 125c57 0 124 11 124-50 0-59-68-47-124-48v98" id="N"/><path fill="#248814" d="M212-179c-10-28-35-45-73-45-59 0-87 40-87 99 0 60 29 101 89 101 43 0 62-24 78-52l27 14C228-24 195 4 139 4 59 4 22-46 18-125c-6-104 99-153 187-111 19 9 31 26 39 46" id="O"/><g id="a"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#N"/><use transform="matrix(0.05,0,0,0.05,24,0)" xlink:href="#O"/></g><path fill="#147eba" d="M24-248c93 1 206-16 204 79-1 75-69 88-152 82V0H24v-248zm52 121c47 0 100 7 100-41 0-47-54-39-100-39v80" id="P"/><path fill="#147eba" d="M135-150c-39-12-60 13-60 57V0H25l-1-190h47c2 13-1 29 3 40 6-28 27-53 61-41v41" id="Q"/><path fill="#147eba" d="M25-224v-37h50v37H25zM25 0v-190h50V0H25" id="R"/><path fill="#147eba" d="M128 0H69L1-190h53L99-40l48-150h52" id="S"/><path fill="#147eba" d="M133-34C117-15 103 5 69 4 32 3 11-16 11-54c-1-60 55-63 116-61 1-26-3-47-28-47-18 1-26 9-28 27l-52-2c7-38 36-58 82-57s74 22 75 68l1 82c-1 14 12 18 25 15v27c-30 8-71 5-69-32zm-48 3c29 0 43-24 42-57-32 0-66-3-65 30 0 17 8 27 23 27" id="T"/><path fill="#147eba" d="M115-3C79 11 28 4 28-45v-112H4v-33h27l15-45h31v45h36v33H77v99c-1 23 16 31 38 25v30" id="U"/><path fill="#147eba" d="M185-48c-13 30-37 53-82 52C43 2 14-33 14-96s30-98 90-98c62 0 83 45 84 108H66c0 31 8 55 39 56 18 0 30-7 34-22zm-45-69c5-46-57-63-70-21-2 6-4 13-4 21h74" id="V"/><g id="b"><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,0,0)" xlink:href="#P"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,10.370370370370372,0)" xlink:href="#Q"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,16.419753086419753,0)" xlink:href="#R"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,20.74074074074074,0)" xlink:href="#S"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,29.382716049382715,0)" xlink:href="#T"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,38.02469135802469,0)" xlink:href="#U"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,43.166666666666664,0)" xlink:href="#V"/></g><path fill="#147eba" d="M169-182c-1-43-94-46-97-3 18 66 151 10 154 114 3 95-165 93-204 36-6-8-10-19-12-30l50-8c3 46 112 56 116 5-17-69-150-10-154-114-4-87 153-88 188-35 5 8 8 18 10 28" id="W"/><path fill="#147eba" d="M85 4C-2 5 27-109 22-190h50c7 57-23 150 33 157 60-5 35-97 40-157h50l1 190h-47c-2-12 1-28-3-38-12 25-28 42-61 42" id="X"/><path fill="#147eba" d="M135-194c52 0 70 43 70 98 0 56-19 99-73 100-30 1-46-15-58-35L72 0H24l1-261h50v104c11-23 29-37 60-37zM114-30c31 0 40-27 40-66 0-37-7-63-39-63s-41 28-41 65c0 36 8 64 40 64" id="Y"/><path fill="#147eba" d="M135-194c87-1 58 113 63 194h-50c-7-57 23-157-34-157-59 0-34 97-39 157H25l-1-190h47c2 12-1 28 3 38 12-26 28-41 61-42" id="Z"/><g id="c"><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,0,0)" xlink:href="#W"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,10.370370370370372,0)" xlink:href="#X"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,19.833333333333336,0)" xlink:href="#Y"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,29.296296296296298,0)" xlink:href="#Z"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,38.75925925925926,0)" xlink:href="#V"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,47.40123456790123,0)" xlink:href="#U"/></g><path fill="#147eba" d="M12 0v-35l95-120H19v-35h142v35L67-36h103V0H12" id="aa"/><path fill="#147eba" d="M23 0v-37h61v-169l-59 37v-38l62-41h46v211h57V0H23" id="ab"/><g id="d"><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,0,0)" xlink:href="#T"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,8.641975308641976,0)" xlink:href="#aa"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,16.419753086419753,0)" xlink:href="#ab"/></g><path fill="#147eba" d="M182-182c0 78-84 86-111 141h115V0H12c-6-101 99-100 120-180 1-22-12-31-33-32-23 0-32 14-35 34l-49-3c5-45 32-70 84-70 51 0 83 22 83 69" id="ac"/><g id="e"><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,0,0)" xlink:href="#T"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,8.641975308641976,0)" xlink:href="#aa"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,16.419753086419753,0)" xlink:href="#ac"/></g><path fill="#147eba" d="M128-127c34 4 56 21 59 58 7 91-148 94-172 28-4-9-6-17-7-26l51-5c1 24 16 35 40 36 23 0 39-12 38-36-1-31-31-36-65-34v-40c32 2 59-3 59-33 0-20-13-33-34-33s-33 13-35 32l-50-3c6-44 37-68 86-68 50 0 83 20 83 66 0 35-22 52-53 58" id="ad"/><g id="f"><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,0,0)" xlink:href="#T"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,8.641975308641976,0)" xlink:href="#aa"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,16.419753086419753,0)" xlink:href="#ad"/></g><path fill="#248814" d="M84 4C-5 8 30-112 23-190h32v120c0 31 7 50 39 49 72-2 45-101 50-169h31l1 190h-30c-1-10 1-25-2-33-11 22-28 36-60 37" id="ae"/><path fill="#248814" d="M115-194c53 0 69 39 70 98 0 66-23 100-70 100C84 3 66-7 56-30L54 0H23l1-261h32v101c10-23 28-34 59-34zm-8 174c40 0 45-34 45-75 0-40-5-75-45-74-42 0-51 32-51 76 0 43 10 73 51 73" id="af"/><path fill="#248814" d="M24 0v-261h32V0H24" id="ag"/><path fill="#248814" d="M24-231v-30h32v30H24zM24 0v-190h32V0H24" id="ah"/><path fill="#248814" d="M96-169c-40 0-48 33-48 73s9 75 48 75c24 0 41-14 43-38l32 2c-6 37-31 61-74 61-59 0-76-41-82-99-10-93 101-131 147-64 4 7 5 14 7 22l-32 3c-4-21-16-35-41-35" id="ai"/><g id="g"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#N"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#ae"/><use transform="matrix(0.05,0,0,0.05,22,0)" xlink:href="#af"/><use transform="matrix(0.05,0,0,0.05,32,0)" xlink:href="#ag"/><use transform="matrix(0.05,0,0,0.05,35.95,0)" xlink:href="#ah"/><use transform="matrix(0.05,0,0,0.05,39.900000000000006,0)" xlink:href="#ai"/></g><path fill="#248814" d="M185-189c-5-48-123-54-124 2 14 75 158 14 163 119 3 78-121 87-175 55-17-10-28-26-33-46l33-7c5 56 141 63 141-1 0-78-155-14-162-118-5-82 145-84 179-34 5 7 8 16 11 25" id="aj"/><path fill="#248814" d="M117-194c89-4 53 116 60 194h-32v-121c0-31-8-49-39-48C34-167 62-67 57 0H25l-1-190h30c1 10-1 24 2 32 11-22 29-35 61-36" id="ak"/><path fill="#248814" d="M100-194c63 0 86 42 84 106H49c0 40 14 67 53 68 26 1 43-12 49-29l28 8c-11 28-37 45-77 45C44 4 14-33 15-96c1-61 26-98 85-98zm52 81c6-60-76-77-97-28-3 7-6 17-6 28h103" id="al"/><path fill="#248814" d="M59-47c-2 24 18 29 38 22v24C64 9 27 4 27-40v-127H5v-23h24l9-43h21v43h35v23H59v120" id="am"/><path fill="#248814" d="M135-143c-3-34-86-38-87 0 15 53 115 12 119 90S17 21 10-45l28-5c4 36 97 45 98 0-10-56-113-15-118-90-4-57 82-63 122-42 12 7 21 19 24 35" id="an"/><g id="h"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aj"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#ae"/><use transform="matrix(0.05,0,0,0.05,22,0)" xlink:href="#af"/><use transform="matrix(0.05,0,0,0.05,32,0)" xlink:href="#ak"/><use transform="matrix(0.05,0,0,0.05,42,0)" xlink:href="#al"/><use transform="matrix(0.05,0,0,0.05,52,0)" xlink:href="#am"/><use transform="matrix(0.05,0,0,0.05,57,0)" xlink:href="#an"/></g><path d="M205 0l-28-72H64L36 0H1l101-248h38L239 0h-34zm-38-99l-47-123c-12 45-31 82-46 123h93" id="ao"/><path d="M266 0h-40l-56-210L115 0H75L2-248h35L96-30l15-64 43-154h32l59 218 59-218h35" id="ap"/><path d="M185-189c-5-48-123-54-124 2 14 75 158 14 163 119 3 78-121 87-175 55-17-10-28-26-33-46l33-7c5 56 141 63 141-1 0-78-155-14-162-118-5-82 145-84 179-34 5 7 8 16 11 25" id="aq"/><g id="i"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ao"/><use transform="matrix(0.05,0,0,0.05,11.35,0)" xlink:href="#ap"/><use transform="matrix(0.05,0,0,0.05,28.299999999999997,0)" xlink:href="#aq"/></g><path d="M30 0v-248h33v221h125V0H30" id="ar"/><path d="M100-194c62-1 85 37 85 99 1 63-27 99-86 99S16-35 15-95c0-66 28-99 85-99zM99-20c44 1 53-31 53-75 0-43-8-75-51-75s-53 32-53 75 10 74 51 75" id="as"/><path d="M141-36C126-15 110 5 73 4 37 3 15-17 15-53c-1-64 63-63 125-63 3-35-9-54-41-54-24 1-41 7-42 31l-33-3c5-37 33-52 76-52 45 0 72 20 72 64v82c-1 20 7 32 28 27v20c-31 9-61-2-59-35zM48-53c0 20 12 33 32 33 41-3 63-29 60-74-43 2-92-5-92 41" id="at"/><path d="M85-194c31 0 48 13 60 33l-1-100h32l1 261h-30c-2-10 0-23-3-31C134-8 116 4 85 4 32 4 16-35 15-94c0-66 23-100 70-100zm9 24c-40 0-46 34-46 75 0 40 6 74 45 74 42 0 51-32 51-76 0-42-9-74-50-73" id="au"/><g id="j"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ar"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#as"/><use transform="matrix(0.05,0,0,0.05,20,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,30,0)" xlink:href="#au"/></g><path d="M160-131c35 5 61 23 61 61C221 17 115-2 30 0v-248c76 3 177-17 177 60 0 33-19 50-47 57zm-97-11c50-1 110 9 110-42 0-47-63-36-110-37v79zm0 115c55-2 124 14 124-45 0-56-70-42-124-44v89" id="av"/><path d="M24 0v-261h32V0H24" id="aw"/><path d="M117-194c89-4 53 116 60 194h-32v-121c0-31-8-49-39-48C34-167 62-67 57 0H25l-1-190h30c1 10-1 24 2 32 11-22 29-35 61-36" id="ax"/><path d="M96-169c-40 0-48 33-48 73s9 75 48 75c24 0 41-14 43-38l32 2c-6 37-31 61-74 61-59 0-76-41-82-99-10-93 101-131 147-64 4 7 5 14 7 22l-32 3c-4-21-16-35-41-35" id="ay"/><path d="M100-194c63 0 86 42 84 106H49c0 40 14 67 53 68 26 1 43-12 49-29l28 8c-11 28-37 45-77 45C44 4 14-33 15-96c1-61 26-98 85-98zm52 81c6-60-76-77-97-28-3 7-6 17-6 28h103" id="az"/><path d="M114-163C36-179 61-72 57 0H25l-1-190h30c1 12-1 29 2 39 6-27 23-49 58-41v29" id="aA"/><g id="k"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#av"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,22,0)" xlink:href="#aw"/><use transform="matrix(0.05,0,0,0.05,25.950000000000003,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,35.95,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,45.95,0)" xlink:href="#ay"/><use transform="matrix(0.05,0,0,0.05,54.95,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,64.95,0)" xlink:href="#aA"/></g><path d="M108 0H70L1-190h34L89-25l56-165h34" id="aB"/><path d="M179-190L93 31C79 59 56 82 12 73V49c39 6 53-20 64-50L1-190h34L92-34l54-156h33" id="aC"/><g id="l"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,20,0)" xlink:href="#aB"/><use transform="matrix(0.05,0,0,0.05,29,0)" xlink:href="#as"/><use transform="matrix(0.05,0,0,0.05,39,0)" xlink:href="#aC"/></g><path d="M101-234c-31-9-42 10-38 44h38v23H63V0H32v-167H5v-23h27c-7-52 17-82 69-68v24" id="aD"/><path d="M24-231v-30h32v30H24zM24 0v-190h32V0H24" id="aE"/><path d="M177-190C167-65 218 103 67 71c-23-6-38-20-44-43l32-5c15 47 100 32 89-28v-30C133-14 115 1 83 1 29 1 15-40 15-95c0-56 16-97 71-98 29-1 48 16 59 35 1-10 0-23 2-32h30zM94-22c36 0 50-32 50-73 0-42-14-75-50-75-39 0-46 34-46 75s6 73 46 73" id="aF"/><g id="m"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ay"/><use transform="matrix(0.05,0,0,0.05,9,0)" xlink:href="#as"/><use transform="matrix(0.05,0,0,0.05,19,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,29,0)" xlink:href="#aD"/><use transform="matrix(0.05,0,0,0.05,34,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,37.95,0)" xlink:href="#aF"/></g><g id="n"><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,0,0)" xlink:href="#az"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,13.580246913580249,0)" xlink:href="#ax"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,27.160493827160497,0)" xlink:href="#aB"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,39.38271604938272,0)" xlink:href="#as"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,52.96296296296297,0)" xlink:href="#aC"/></g><path d="M135-143c-3-34-86-38-87 0 15 53 115 12 119 90S17 21 10-45l28-5c4 36 97 45 98 0-10-56-113-15-118-90-4-57 82-63 122-42 12 7 21 19 24 35" id="aG"/><g id="o"><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,0,0)" xlink:href="#aG"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,12.222222222222223,0)" xlink:href="#aE"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,17.58641975308642,0)" xlink:href="#au"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,31.16666666666667,0)" xlink:href="#az"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,44.74691358024692,0)" xlink:href="#ay"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,56.96913580246914,0)" xlink:href="#at"/><use transform="matrix(0.06790123456790124,0,0,0.06790123456790124,70.5493827160494,0)" xlink:href="#aA"/></g><path d="M59-47c-2 24 18 29 38 22v24C64 9 27 4 27-40v-127H5v-23h24l9-43h21v43h35v23H59v120" id="aH"/><g id="p"><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,0,0)" xlink:href="#ay"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,7.777777777777779,0)" xlink:href="#as"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,16.419753086419753,0)" xlink:href="#ax"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,25.061728395061728,0)" xlink:href="#aH"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,29.382716049382715,0)" xlink:href="#at"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,38.02469135802469,0)" xlink:href="#aE"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,41.43827160493827,0)" xlink:href="#ax"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,50.08024691358024,0)" xlink:href="#az"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,58.72222222222222,0)" xlink:href="#aA"/><use transform="matrix(0.04320987654320988,0,0,0.04320987654320988,63.864197530864196,0)" xlink:href="#aG"/></g><path d="M126-127c33 6 58 20 58 59 0 88-139 92-164 29-3-8-5-16-6-25l32-3c6 27 21 44 54 44 32 0 52-15 52-46 0-38-36-46-79-43v-28c39 1 72-4 72-42 0-27-17-43-46-43-28 0-47 15-49 41l-32-3c6-42 35-63 81-64 48-1 79 21 79 65 0 36-21 52-52 59" id="aI"/><path d="M0 4l72-265h28L28 4H0" id="aJ"/><path d="M210-169c-67 3-38 105-44 169h-31v-121c0-29-5-50-35-48C34-165 62-65 56 0H25l-1-190h30c1 10-1 24 2 32 10-44 99-50 107 0 11-21 27-35 58-36 85-2 47 119 55 194h-31v-121c0-29-5-49-35-48" id="aK"/><g id="q"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aI"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#aG"/><use transform="matrix(0.05,0,0,0.05,19,0)" xlink:href="#ay"/><use transform="matrix(0.05,0,0,0.05,28,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,38,0)" xlink:href="#aw"/><use transform="matrix(0.05,0,0,0.05,41.95,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,51.95,0)" xlink:href="#aJ"/><use transform="matrix(0.05,0,0,0.05,56.95,0)" xlink:href="#aw"/><use transform="matrix(0.05,0,0,0.05,60.900000000000006,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,64.85000000000001,0)" xlink:href="#aK"/><use transform="matrix(0.05,0,0,0.05,79.80000000000001,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,83.75000000000001,0)" xlink:href="#aH"/><use transform="matrix(0.05,0,0,0.05,88.75000000000001,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,98.75000000000001,0)" xlink:href="#au"/><use transform="matrix(0.05,0,0,0.05,108.75,0)" xlink:href="#as"/><use transform="matrix(0.05,0,0,0.05,118.75,0)" xlink:href="#aA"/></g><path d="M67-125c0 53 21 87 73 88 37 1 54-22 65-47l45 17C233-25 199 4 140 4 58 4 20-42 15-125 8-235 124-281 211-232c18 10 29 29 36 50l-46 12c-8-25-30-41-62-41-52 0-71 34-72 86" id="aL"/><path d="M110-194c64 0 96 36 96 99 0 64-35 99-97 99-61 0-95-36-95-99 0-62 34-99 96-99zm-1 164c35 0 45-28 45-65 0-40-10-65-43-65-34 0-45 26-45 65 0 36 10 65 43 65" id="aM"/><path d="M135-194c87-1 58 113 63 194h-50c-7-57 23-157-34-157-59 0-34 97-39 157H25l-1-190h47c2 12-1 28 3 38 12-26 28-41 61-42" id="aN"/><path d="M121-226c-27-7-43 5-38 36h38v33H83V0H34v-157H6v-33h28c-9-59 32-81 87-68v32" id="aO"/><path d="M25-224v-37h50v37H25zM25 0v-190h50V0H25" id="aP"/><path d="M195-6C206 82 75 100 31 46c-4-6-6-13-8-21l49-6c3 16 16 24 34 25 40 0 42-37 40-79-11 22-30 35-61 35-53 0-70-43-70-97 0-56 18-96 73-97 30 0 46 14 59 34l2-30h47zm-90-29c32 0 41-27 41-63 0-35-9-62-40-62-32 0-39 29-40 63 0 36 9 62 39 62" id="aQ"/><path d="M230 0l2-204L168 0h-37L68-204 70 0H24v-248h70l56 185 57-185h69V0h-46" id="aR"/><path d="M133-34C117-15 103 5 69 4 32 3 11-16 11-54c-1-60 55-63 116-61 1-26-3-47-28-47-18 1-26 9-28 27l-52-2c7-38 36-58 82-57s74 22 75 68l1 82c-1 14 12 18 25 15v27c-30 8-71 5-69-32zm-48 3c29 0 43-24 42-57-32 0-66-3-65 30 0 17 8 27 23 27" id="aS"/><path d="M135-194c53 0 70 44 70 98 0 56-19 98-73 100-31 1-45-17-59-34 3 33 2 69 2 105H25l-1-265h48c2 10 0 23 3 31 11-24 29-35 60-35zM114-30c33 0 39-31 40-66 0-38-9-64-40-64-56 0-55 130 0 130" id="aT"/><g id="r"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aL"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,12.790123456790125,0)" xlink:href="#aM"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,23.60493827160494,0)" xlink:href="#aN"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,34.41975308641975,0)" xlink:href="#aO"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,40.2962962962963,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,45.23456790123457,0)" xlink:href="#aQ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,56.04938271604939,0)" xlink:href="#aR"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,70.81481481481482,0)" xlink:href="#aS"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,80.69135802469137,0)" xlink:href="#aT"/></g><path d="M231 0h-52l-39-155L100 0H48L-1-190h46L77-45c9-52 24-97 36-145h53l37 145 32-145h46" id="aU"/><path d="M115-3C79 11 28 4 28-45v-112H4v-33h27l15-45h31v45h36v33H77v99c-1 23 16 31 38 25v30" id="aV"/><path d="M114-157C55-157 80-60 75 0H25v-261h50l-1 109c12-26 28-41 61-42 86-1 58 113 63 194h-50c-7-57 23-157-34-157" id="aW"/><g id="s"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aU"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,13.827160493827162,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,18.765432098765434,0)" xlink:href="#aV"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,24.641975308641978,0)" xlink:href="#aW"/></g><path d="M135-150c-39-12-60 13-60 57V0H25l-1-190h47c2 13-1 29 3 40 6-28 27-53 61-41v41" id="aX"/><path d="M185-48c-13 30-37 53-82 52C43 2 14-33 14-96s30-98 90-98c62 0 83 45 84 108H66c0 31 8 55 39 56 18 0 30-7 34-22zm-45-69c5-46-57-63-70-21-2 6-4 13-4 21h74" id="aY"/><path d="M25 0v-261h50V0H25" id="aZ"/><path d="M220-157c-53 9-28 100-34 157h-49v-107c1-27-5-49-29-50C55-147 81-57 75 0H25l-1-190h47c2 12-1 28 3 38 10-53 101-56 108 0 13-22 24-43 59-42 82 1 51 116 57 194h-49v-107c-1-25-5-48-29-50" id="ba"/><g id="t"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aX"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,6.913580246913581,0)" xlink:href="#aS"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,16.790123456790127,0)" xlink:href="#aV"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,22.66666666666667,0)" xlink:href="#aY"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,32.543209876543216,0)" xlink:href="#aZ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,37.48148148148149,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,42.41975308641976,0)" xlink:href="#ba"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,58.22222222222223,0)" xlink:href="#aP"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,63.1604938271605,0)" xlink:href="#aV"/></g><path d="M85 4C-2 5 27-109 22-190h50c7 57-23 150 33 157 60-5 35-97 40-157h50l1 190h-47c-2-12 1-28-3-38-12 25-28 42-61 42" id="bb"/><path d="M137-138c1-29-70-34-71-4 15 46 118 7 119 86 1 83-164 76-172 9l43-7c4 19 20 25 44 25 33 8 57-30 24-41C81-84 22-81 20-136c-2-80 154-74 161-7" id="bc"/><g id="u"><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,0,0)" xlink:href="#aX"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,6.913580246913581,0)" xlink:href="#bb"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,17.728395061728396,0)" xlink:href="#aZ"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,22.666666666666668,0)" xlink:href="#aY"/><use transform="matrix(0.04938271604938272,0,0,0.04938271604938272,32.543209876543216,0)" xlink:href="#bc"/></g><g id="v"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aG"/><use transform="matrix(0.05,0,0,0.05,9,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,19,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,29,0)" xlink:href="#au"/><use transform="matrix(0.05,0,0,0.05,39,0)" xlink:href="#aG"/></g><path d="M145-31C134-9 116 4 85 4 32 4 16-35 15-94c0-59 17-99 70-100 32-1 48 14 60 33 0-11-1-24 2-32h30l-1 268h-32zM93-21c41 0 51-33 51-76s-8-73-50-73c-40 0-46 35-46 75s5 74 45 74" id="bd"/><path d="M84 4C-5 8 30-112 23-190h32v120c0 31 7 50 39 49 72-2 45-101 50-169h31l1 190h-30c-1-10 1-25-2-33-11 22-28 36-60 37" id="be"/><g id="w"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aA"/><use transform="matrix(0.05,0,0,0.05,5.95,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,15.949999999999998,0)" xlink:href="#bd"/><use transform="matrix(0.05,0,0,0.05,25.950000000000003,0)" xlink:href="#be"/><use transform="matrix(0.05,0,0,0.05,35.95,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,45.95,0)" xlink:href="#aG"/><use transform="matrix(0.05,0,0,0.05,54.95,0)" xlink:href="#aH"/></g><g id="x"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,3.95,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,13.949999999999998,0)" xlink:href="#aD"/><use transform="matrix(0.05,0,0,0.05,18.95,0)" xlink:href="#as"/></g><g id="y"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#aG"/></g><g id="z"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,3.95,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,13.949999999999998,0)" xlink:href="#aG"/><use transform="matrix(0.05,0,0,0.05,22.95,0)" xlink:href="#aH"/><use transform="matrix(0.05,0,0,0.05,27.950000000000003,0)" xlink:href="#aA"/><use transform="matrix(0.05,0,0,0.05,33.9,0)" xlink:href="#be"/><use transform="matrix(0.05,0,0,0.05,43.9,0)" xlink:href="#ay"/><use transform="matrix(0.05,0,0,0.05,52.900000000000006,0)" xlink:href="#aH"/><use transform="matrix(0.05,0,0,0.05,57.900000000000006,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,67.9,0)" xlink:href="#au"/></g><path d="M115-194c55 1 70 41 70 98S169 2 115 4C84 4 66-9 55-30l1 105H24l-1-265h31l2 30c10-21 28-34 59-34zm-8 174c40 0 45-34 45-75s-6-73-45-74c-42 0-51 32-51 76 0 43 10 73 51 73" id="bf"/><g id="A"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#bf"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,20,0)" xlink:href="#aA"/></g><path d="M106-169C34-169 62-67 57 0H25v-261h32l-1 103c12-21 28-36 61-36 89 0 53 116 60 194h-32v-121c2-32-8-49-39-48" id="bg"/><g id="B"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aH"/><use transform="matrix(0.05,0,0,0.05,5,0)" xlink:href="#bg"/><use transform="matrix(0.05,0,0,0.05,15,0)" xlink:href="#az"/></g><g id="C"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aA"/><use transform="matrix(0.05,0,0,0.05,5.95,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,15.949999999999998,0)" xlink:href="#aH"/><use transform="matrix(0.05,0,0,0.05,20.95,0)" xlink:href="#az"/></g><g id="D"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aw"/><use transform="matrix(0.05,0,0,0.05,3.95,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,7.9,0)" xlink:href="#aK"/><use transform="matrix(0.05,0,0,0.05,22.85,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,26.8,0)" xlink:href="#aH"/></g><g id="E"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#ay"/><use transform="matrix(0.05,0,0,0.05,19,0)" xlink:href="#aH"/><use transform="matrix(0.05,0,0,0.05,24,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,27.950000000000003,0)" xlink:href="#as"/><use transform="matrix(0.05,0,0,0.05,37.95,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,47.95,0)" xlink:href="#aG"/></g><path d="M206 0h-36l-40-164L89 0H53L-1-190h32L70-26l43-164h34l41 164 42-164h31" id="bh"/><g id="F"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#aw"/><use transform="matrix(0.05,0,0,0.05,13.949999999999998,0)" xlink:href="#aw"/><use transform="matrix(0.05,0,0,0.05,17.9,0)" xlink:href="#as"/><use transform="matrix(0.05,0,0,0.05,27.899999999999995,0)" xlink:href="#bh"/><use transform="matrix(0.05,0,0,0.05,40.85,0)" xlink:href="#aG"/><use transform="matrix(0.05,0,0,0.05,49.85,0)" xlink:href="#aJ"/><use transform="matrix(0.05,0,0,0.05,54.85,0)" xlink:href="#au"/><use transform="matrix(0.05,0,0,0.05,64.85,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,74.85,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,84.85,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,88.8,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,98.8,0)" xlink:href="#aG"/></g><g id="G"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#au"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,20,0)" xlink:href="#bf"/><use transform="matrix(0.05,0,0,0.05,30,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,40,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,50,0)" xlink:href="#au"/><use transform="matrix(0.05,0,0,0.05,60,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,63.95,0)" xlink:href="#ax"/><use transform="matrix(0.05,0,0,0.05,73.95,0)" xlink:href="#aF"/></g><g id="H"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#as"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#ax"/></g><g id="I"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aA"/><use transform="matrix(0.05,0,0,0.05,5.95,0)" xlink:href="#be"/><use transform="matrix(0.05,0,0,0.05,15.949999999999998,0)" xlink:href="#aw"/><use transform="matrix(0.05,0,0,0.05,19.9,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,29.899999999999995,0)" xlink:href="#aG"/></g><g id="J"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aK"/><use transform="matrix(0.05,0,0,0.05,14.950000000000001,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,24.950000000000003,0)" xlink:href="#aH"/><use transform="matrix(0.05,0,0,0.05,29.950000000000003,0)" xlink:href="#ay"/><use transform="matrix(0.05,0,0,0.05,38.95,0)" xlink:href="#bg"/><use transform="matrix(0.05,0,0,0.05,48.95,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,58.95,0)" xlink:href="#aG"/></g><g id="K"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#aA"/><use transform="matrix(0.05,0,0,0.05,5.95,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,15.949999999999998,0)" xlink:href="#aH"/><use transform="matrix(0.05,0,0,0.05,20.95,0)" xlink:href="#az"/><use transform="matrix(0.05,0,0,0.05,30.950000000000003,0)" xlink:href="#aw"/><use transform="matrix(0.05,0,0,0.05,34.9,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,38.85,0)" xlink:href="#aK"/><use transform="matrix(0.05,0,0,0.05,53.800000000000004,0)" xlink:href="#aE"/><use transform="matrix(0.05,0,0,0.05,57.75,0)" xlink:href="#aH"/></g><g id="L"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ay"/><use transform="matrix(0.05,0,0,0.05,9,0)" xlink:href="#at"/><use transform="matrix(0.05,0,0,0.05,19,0)" xlink:href="#ay"/><use transform="matrix(0.05,0,0,0.05,28,0)" xlink:href="#bg"/><use transform="matrix(0.05,0,0,0.05,38,0)" xlink:href="#az"/></g></defs></g></svg>
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/redis-service.yaml b/0.10.0/limitador/limitador-server/kubernetes/redis-service.yaml
deleted file mode 100644
index 2096d64dd..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/redis-service.yaml
+++ /dev/null
@@ -1,13 +0,0 @@
-apiVersion: v1
-kind: Service
-metadata:
-  name: redis
-spec:
-  ports:
-    - name: redis
-      port: 6379
-      protocol: TCP
-      targetPort: redis
-  selector:
-    statefulset: redis
-  type: ClusterIP
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/kubernetes/redis-statefulset.yaml b/0.10.0/limitador/limitador-server/kubernetes/redis-statefulset.yaml
deleted file mode 100644
index b344e8be4..000000000
--- a/0.10.0/limitador/limitador-server/kubernetes/redis-statefulset.yaml
+++ /dev/null
@@ -1,55 +0,0 @@
-apiVersion: apps/v1
-kind: StatefulSet
-metadata:
-  name: redis
-spec:
-  selector:
-    matchLabels:
-      statefulset: redis
-  serviceName: redis
-  replicas: 1
-  template:
-    metadata:
-      labels:
-        statefulset: redis
-    spec:
-      containers:
-        - name: redis
-          image: redis:6.0
-          ports:
-            - containerPort: 6379
-              name: redis
-          livenessProbe:
-            initialDelaySeconds: 30
-            periodSeconds: 10
-            timeoutSeconds: 5
-            successThreshold: 1
-            failureThreshold: 5
-            exec:
-              command:
-              - redis-cli
-              - ping
-          readinessProbe:
-            initialDelaySeconds: 5
-            periodSeconds: 10
-            timeoutSeconds: 2
-            successThreshold: 1
-            failureThreshold: 5
-            exec:
-              command:
-              - redis-cli
-              - ping
-          volumeMounts:
-          - name: redis-storage
-            mountPath: /data
-            subPath: data
-  volumeClaimTemplates:
-    - metadata:
-        name: redis-storage
-      spec:
-        volumeMode: Filesystem
-        accessModes:
-          - ReadWriteOnce
-        resources:
-          requests:
-            storage: 1Gi
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/sandbox/Makefile b/0.10.0/limitador/limitador-server/sandbox/Makefile
deleted file mode 100644
index 7d90b8e64..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/Makefile
+++ /dev/null
@@ -1,126 +0,0 @@
-SHELL := /bin/bash
-
-MKFILE_PATH := $(abspath $(lastword $(MAKEFILE_LIST)))
-PROJECT_PATH := $(patsubst %/,%,$(dir $(MKFILE_PATH)))
-
-DOCKER ?= $(shell which docker 2> /dev/null || echo "docker")
-
-all: help
-
-##@ General
-
-# The help target prints out all targets with their descriptions organized
-# beneath their categories. The categories are represented by '##@' and the
-# target descriptions by '##'. The awk commands is responsible for reading the
-# entire set of makefiles included in this invocation, looking for lines of the
-# file as xyz: ## something, and then pretty-format the target and help. Then,
-# if there's a line with ##@ something, that gets pretty-printed as a category.
-# More info on the usage of ANSI control characters for terminal formatting:
-# https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_parameters
-# More info on the awk command:
-# http://linuxcommand.org/lc3_adv_awk.php
-
-help: ## Display this help.
-	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_0-9-]+:.*?##/ { printf "  \033[36m%-30s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
-
-##@ Deployment Options
-
-deploy-in-memory: clean ## Counters are held in Limitador (ephemeral)
-	$(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-memory.yaml up
-
-deploy-redis: clean ## Uses Redis to store counters
-	$(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-redis.yaml up
-
-deploy-redis-tls: clean ## Uses Redis with TLS and password protected to store counters
-	$(MAKE) ca
-	$(MAKE) redis-client-certs
-	$(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-redis-tls.yaml up
-
-deploy-redis-cached: clean ## Uses Redis to store counters, with an in-memory cache
-	$(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-redis-cached.yaml up
-
-deploy-redis-otel: clean ## Uses Redis to store counters, instrumented with opentelemetry
-	$(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-redis-otel.yaml up
-
-deploy-disk: clean ## Uses disk to store counters
-	$(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-disk.yaml up
-
-deploy-distributed: clean ## Counters are held in Limitador (ephemeral) but replicated to other Limitador servers.
-	$(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-distributed.yaml up
-
-deploy-distributed-3-node: clean ## Counters are held in Limitador (ephemeral) but replicated to 3 other local Limitador servers.
-	$(DOCKER) compose -f docker-compose-envoy-3-node.yaml -f docker-compose-limitador-distributed-3-node.yaml up
-
-##@ Helper targets
-
-build: clean ## Build the "limitador-testing" image
-	$(DOCKER) compose -f docker-compose-limitador-memory.yaml build
-
-build-all-features: clean ## Build the image "limitador-testing-all-features" image
-	$(DOCKER) compose -f docker-compose-limitador-distributed.yaml build
-
-ca: ## Create CA cert
-	openssl genrsa -out ca.key 2048
-	openssl req -batch -new -x509 -nodes -key ca.key -sha256 -days 1024 -out ca.crt
-
-redis-client-certs: ## Create CSR, then sign it with CA cert
-	openssl req -subj '/CN=redis'  -newkey rsa:4096 -nodes \
-			-sha256 \
-			-days 3650 \
-			-keyout redis.key \
-			-out redis.csr
-	chmod +r redis.key
-	openssl x509 -req -in redis.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out redis.crt -days 500 -sha256
-
-##@ Cleanning targets
-
-redis-clean-certs: ## Clean certs
-	- rm *.crt *.key *.pem *.csr
-
-clean-containers: ## clean containers
-	- $(DOCKER) compose down --volumes --remove-orphans
-	- $(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-memory.yaml down --volumes --remove-orphans
-	- $(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-redis.yaml down --volumes --remove-orphans
-	- $(DOCKER)_compose -f docker-compose-envoy.yaml -f docker-compose-limitador-redis-cached.yaml down --volumes --remove-orphans
-	- $(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-disk.yaml down --volumes --remove-orphans
-	- $(DOCKER) compose -f docker-compose-envoy.yaml -f docker-compose-limitador-redis-otel.yaml down --volumes --remove-orphans
-	- $(MAKE) cleancerts
-
-clean: ## clean all
-	- $(MAKE) clean-containers
-	- $(MAKE) redis-clean-certs
-
-GRPCURL=$(PROJECT_PATH)/bin/grpcurl
-$(GRPCURL):
-	$(call go-install-tool,$(GRPCURL),github.com/fullstorydev/grpcurl/cmd/grpcurl@v1.8.9)
-
-.PHONY: grpcurl
-grpcurl: $(GRPCURL) ## Download grpcurl locally if necessary.
-
-.PHONY: ghz
-ghz:
-	$(call go-install-tool,$(PROJECT_PATH)/bin/ghz,github.com/bojand/ghz/cmd/ghz@latest) 
-
-RPS?=1000
-.PHONY: load-test
-load-test: ghz
-	# see https://ghz.sh/docs/load for usage details
-	$(PROJECT_PATH)/bin/ghz 127.0.0.1:18081 --insecure \
-	--call envoy.service.ratelimit.v3.RateLimitService.ShouldRateLimit \
-	--async --concurrency=50 \
-	--rps=$(RPS) \
-	--total=$(RPS)0 \
-	--data-file load-test.json
-
-# go-install-tool will 'go install' any package $2 and install it to $1.
-define go-install-tool
-@[ -f $(1) ] || { \
-set -e ;\
-TMP_DIR=$$(mktemp -d) ;\
-cd $$TMP_DIR ;\
-go mod init tmp ;\
-echo "Downloading $(2)" ;\
-GOBIN=$(PROJECT_PATH)/bin go install $(2) ;\
-rm -rf $$TMP_DIR ;\
-}
-endef
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-envoy-3-node.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-envoy-3-node.yaml
deleted file mode 100644
index 702fd2348..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-envoy-3-node.yaml
+++ /dev/null
@@ -1,74 +0,0 @@
----
-version: '3.8'
-services:
-  envoy:
-    image: envoyproxy/envoy:v1.20-latest
-    depends_on:
-      - upstream
-      - limitador
-    command:
-      - /usr/local/bin/envoy
-      - --config-path
-      - /etc/envoy.yaml
-      - --log-level
-      - info
-      - --component-log-level
-      - http:debug,router:debug
-      - --service-cluster
-      - proxy
-    expose:
-      - "80"
-      - "8001"
-    ports:
-      - "18000:80"
-      - "18001:8001"
-    volumes:
-      - ./envoy.yaml:/etc/envoy.yaml
-  envoy2:
-    image: envoyproxy/envoy:v1.20-latest
-    depends_on:
-      - upstream
-      - limitador
-    command:
-      - /usr/local/bin/envoy
-      - --config-path
-      - /etc/envoy.yaml
-      - --log-level
-      - info
-      - --component-log-level
-      - http:debug,router:debug
-      - --service-cluster
-      - proxy
-    expose:
-      - "80"
-      - "8001"
-    ports:
-      - "18100:80"
-      - "18101:8001"
-    volumes:
-      - ./envoy.yaml:/etc/envoy.yaml
-  envoy3:
-    image: envoyproxy/envoy:v1.20-latest
-    depends_on:
-      - upstream
-      - limitador
-    command:
-      - /usr/local/bin/envoy
-      - --config-path
-      - /etc/envoy.yaml
-      - --log-level
-      - info
-      - --component-log-level
-      - http:debug,router:debug
-      - --service-cluster
-      - proxy
-    expose:
-      - "80"
-      - "8001"
-    ports:
-      - "18200:80"
-      - "18201:8001"
-    volumes:
-      - ./envoy.yaml:/etc/envoy.yaml
-  upstream:
-    image: kennethreitz/httpbin
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-envoy.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-envoy.yaml
deleted file mode 100644
index bfbfca172..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-envoy.yaml
+++ /dev/null
@@ -1,28 +0,0 @@
----
-version: '3.8'
-services:
-  envoy:
-    image: envoyproxy/envoy:v1.20-latest
-    depends_on:
-      - upstream
-      - limitador
-    command:
-      - /usr/local/bin/envoy
-      - --config-path
-      - /etc/envoy.yaml
-      - --log-level
-      - info
-      - --component-log-level
-      - http:debug,router:debug
-      - --service-cluster
-      - proxy
-    expose:
-      - "80"
-      - "8001"
-    ports:
-      - "18000:80"
-      - "18001:8001"
-    volumes:
-      - ./envoy.yaml:/etc/envoy.yaml
-  upstream:
-    image: kennethreitz/httpbin
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-disk.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-disk.yaml
deleted file mode 100644
index f84a7c731..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-disk.yaml
+++ /dev/null
@@ -1,31 +0,0 @@
----
-version: '3.8'
-services:
-  limitador:
-    image: ${LIMITADOR_IMAGE:-limitador-testing}
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-    command:
-      - limitador-server
-      - --rls-ip
-      - 0.0.0.0
-      - --rls-port
-      - "8081"
-      - --http-ip
-      - 0.0.0.0
-      - --http-port
-      - "8080"
-      - -vvv
-      - --grpc-reflection-service
-      - /opt/kuadrant/limits/limits.yaml
-      - disk
-      - "/tmp/data"
-    expose:
-      - "8080"
-      - "8081"
-    ports:
-      - "18080:8080"
-      - "18081:8081"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-distributed-3-node.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-distributed-3-node.yaml
deleted file mode 100644
index 31aca3d92..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-distributed-3-node.yaml
+++ /dev/null
@@ -1,58 +0,0 @@
----
-version: '3.8'
-services:
-  limitador:
-    image: limitador-testing-all-features
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-      args:
-        - CARGO_ARGS=--all-features
-    command: |
-      limitador-server --rls-ip 0.0.0.0 --rls-port 8081 --http-ip 0.0.0.0 --http-port "8080" 
-      -vv --grpc-reflection-service /opt/kuadrant/limits/limits.yaml 
-      distributed limitador 0.0.0.0:5001 http://limitador2:5001 http://limitador3:5001
-    expose:
-      - "8080"
-      - "8081"
-      - "5001"
-    ports:
-      - "18080:8080"
-      - "18081:8081"
-      - "15001:5001"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
-  limitador2:
-    image: limitador-testing-all-features
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-      args:
-        - CARGO_ARGS=--all-features
-    command: |
-      limitador-server --rls-ip 0.0.0.0 --rls-port 8081 --http-ip 0.0.0.0 --http-port "8080" 
-      -vv --grpc-reflection-service /opt/kuadrant/limits/limits.yaml 
-      distributed limitador2 0.0.0.0:5001 http://limitador:5001 http://limitador3:5001
-    expose:
-      - "8080"
-      - "8081"
-      - "5001"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
-  limitador3:
-    image: limitador-testing-all-features
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-      args:
-        - CARGO_ARGS=--all-features
-    command: |
-      limitador-server --rls-ip 0.0.0.0 --rls-port 8081 --http-ip 0.0.0.0 --http-port "8080" 
-      -vv --grpc-reflection-service /opt/kuadrant/limits/limits.yaml 
-      distributed limitador3 0.0.0.0:5001 http://limitador:5001 http://limitador2:5001
-    expose:
-      - "8080"
-      - "8081"
-      - "5001"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-distributed.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-distributed.yaml
deleted file mode 100644
index c0d830380..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-distributed.yaml
+++ /dev/null
@@ -1,24 +0,0 @@
----
-version: '3.8'
-services:
-  limitador:
-    image: limitador-testing-all-features
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-      args:
-        - CARGO_ARGS=--all-features
-    command: |
-      limitador-server --rls-ip 0.0.0.0 --rls-port 8081 --http-ip 0.0.0.0 --http-port "8080" 
-      -vv --grpc-reflection-service /opt/kuadrant/limits/limits.yaml 
-      distributed ${PEER_ID:-node1} 0.0.0.0:5001 ${PEER_URLS:-}
-    expose:
-      - "8080"
-      - "8081"
-      - "5001"
-    ports:
-      - "18080:8080"
-      - "18081:8081"
-      - "15001:5001"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-memory.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-memory.yaml
deleted file mode 100644
index 133d7ffa2..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-memory.yaml
+++ /dev/null
@@ -1,30 +0,0 @@
----
-version: '3.8'
-services:
-  limitador:
-    image: ${LIMITADOR_IMAGE:-limitador-testing}
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-    command:
-      - limitador-server
-      - --rls-ip
-      - 0.0.0.0
-      - --rls-port
-      - "8081"
-      - --http-ip
-      - 0.0.0.0
-      - --http-port
-      - "8080"
-      - -vvv
-      - --grpc-reflection-service
-      - /opt/kuadrant/limits/limits.yaml
-      - memory
-    expose:
-      - "8080"
-      - "8081"
-    ports:
-      - "18080:8080"
-      - "18081:8081"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-cached.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-cached.yaml
deleted file mode 100644
index 7c257bbe5..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-cached.yaml
+++ /dev/null
@@ -1,43 +0,0 @@
----
-version: '3.8'
-services:
-  limitador:
-    image: ${LIMITADOR_IMAGE:-limitador-testing}
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-    depends_on:
-      - redis
-    command:
-      - limitador-server
-      - --rls-ip
-      - 0.0.0.0
-      - --rls-port
-      - "8081"
-      - --http-ip
-      - 0.0.0.0
-      - --http-port
-      - "8080"
-      - -vvv
-      - --grpc-reflection-service
-      - /opt/kuadrant/limits/limits.yaml
-      - redis_cached
-      - --batch-size
-      - "100"
-      - --flush-period
-      - "1000"
-      - --max-cached
-      - "10000"
-      - --response-timeout
-      - "350"
-      - redis://redis:6379
-    expose:
-      - "8080"
-      - "8081"
-    ports:
-      - "18080:8080"
-      - "18081:8081"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
-  redis:
-    image: redis:5
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-otel.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-otel.yaml
deleted file mode 100644
index 8c61f7aab..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-otel.yaml
+++ /dev/null
@@ -1,47 +0,0 @@
----
-version: '3.8'
-services:
-  limitador:
-    image: ${LIMITADOR_IMAGE:-limitador-testing}
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-    depends_on:
-      - jaeger
-      - redis
-    command:
-      - limitador-server
-      - --tracing-endpoint
-      - "rpc://jaeger:4317"
-      - --rls-ip
-      - 0.0.0.0
-      - --rls-port
-      - "8081"
-      - --http-ip
-      - 0.0.0.0
-      - --http-port
-      - "8080"
-      - -vvvv
-      - --grpc-reflection-service
-      - /opt/kuadrant/limits/limits.yaml
-      - redis
-      - redis://redis:6379
-    expose:
-      - "8080"
-      - "8081"
-    ports:
-      - "18080:8080"
-      - "18081:8081"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
-  redis:
-    image: redis:7
-  jaeger:
-    image: jaegertracing/all-in-one:latest
-    environment:
-      JAEGER_DISABLED: "false"
-      COLLECTOR_OTLP_ENABLED: "true"
-    ports:
-      - 16686:16686
-    expose:
-      - "4317"
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-tls.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-tls.yaml
deleted file mode 100644
index 5c603a5e2..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis-tls.yaml
+++ /dev/null
@@ -1,45 +0,0 @@
----
-version: '3.8'
-services:
-  limitador:
-    image: ${LIMITADOR_IMAGE:-limitador-testing}
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-    depends_on:
-      - redis
-    command:
-      - limitador-server
-      - --rls-ip
-      - 0.0.0.0
-      - --rls-port
-      - "8081"
-      - --http-ip
-      - 0.0.0.0
-      - --http-port
-      - "8080"
-      - -vvv
-      - --grpc-reflection-service
-      - /opt/kuadrant/limits/limits.yaml
-      - redis
-      - rediss://:foobared@redis:6379/#insecure
-    expose:
-      - "8080"
-      - "8081"
-    ports:
-      - "18080:8080"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
-  redis:
-    image: redis:6.2
-    restart: always
-    ports:
-      - '6379:6379'
-    command:
-      - redis-server
-      - /usr/local/etc/redis/redis.conf
-    volumes:
-      - ./redis-tls/redis-config.conf:/usr/local/etc/redis/redis.conf
-      - ./redis.crt:/usr/local/etc/redis/certs/redis.crt
-      - ./redis.key:/usr/local/etc/redis/certs/redis.key
-      - ./ca.crt:/usr/local/etc/redis/certs/ca.crt
diff --git a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis.yaml b/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis.yaml
deleted file mode 100644
index f5fc3b025..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/docker-compose-limitador-redis.yaml
+++ /dev/null
@@ -1,35 +0,0 @@
----
-version: '3.8'
-services:
-  limitador:
-    image: ${LIMITADOR_IMAGE:-limitador-testing}
-    build:
-      context: ../..
-      dockerfile: Dockerfile
-    depends_on:
-      - redis
-    command:
-      - limitador-server
-      - --rls-ip
-      - 0.0.0.0
-      - --rls-port
-      - "8081"
-      - --http-ip
-      - 0.0.0.0
-      - --http-port
-      - "8080"
-      - -vvv
-      - --grpc-reflection-service
-      - /opt/kuadrant/limits/limits.yaml
-      - redis
-      - redis://redis:6379
-    expose:
-      - "8080"
-      - "8081"
-    ports:
-      - "18080:8080"
-      - "18081:8081"
-    volumes:
-      - ./limits.yaml:/opt/kuadrant/limits/limits.yaml
-  redis:
-    image: redis:5
diff --git a/0.10.0/limitador/limitador-server/sandbox/envoy.yaml b/0.10.0/limitador/limitador-server/sandbox/envoy.yaml
deleted file mode 100644
index 7e678e10a..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/envoy.yaml
+++ /dev/null
@@ -1,84 +0,0 @@
----
-static_resources:
-  listeners:
-  - name: main
-    address:
-      socket_address:
-        address: 0.0.0.0
-        port_value: 80
-    filter_chains:
-      - filters:
-        - name: envoy.filters.network.http_connection_manager
-          typed_config:
-            "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
-            stat_prefix: ingress_http
-            route_config:
-              name: local_route
-              virtual_hosts:
-                - name: local_service
-                  domains:
-                    - "*"
-                  routes:
-                    - match:
-                        prefix: "/"
-                      route:
-                        cluster: upstream
-                        rate_limits:
-                          - actions:
-                            - request_headers:
-                                header_name: :method
-                                descriptor_key: req.method
-                            - request_headers:
-                                header_name: :path
-                                descriptor_key: req.path
-            http_filters:
-            - name: envoy.filters.http.ratelimit
-              typed_config:
-                "@type": type.googleapis.com/envoy.extensions.filters.http.ratelimit.v3.RateLimit
-                domain: "test_namespace"
-                failure_mode_deny: true
-                timeout: 3s
-                rate_limit_service:
-                  transport_api_version: "v3"
-                  grpc_service:
-                    envoy_grpc:
-                      cluster_name: limitador
-            - name: envoy.filters.http.router
-  clusters:
-    - name: upstream
-      connect_timeout: 0.25s
-      type: STRICT_DNS
-      lb_policy: round_robin
-      load_assignment:
-        cluster_name: upstream
-        endpoints:
-        - lb_endpoints:
-          - endpoint:
-              address:
-                socket_address:
-                  address: upstream
-                  port_value: 80
-    - name: limitador
-      connect_timeout: 1s
-      type: STRICT_DNS
-      lb_policy: round_robin
-      typed_extension_protocol_options:
-        envoy.extensions.upstreams.http.v3.HttpProtocolOptions:
-          "@type": type.googleapis.com/envoy.extensions.upstreams.http.v3.HttpProtocolOptions
-          explicit_http_config:
-            http2_protocol_options: {}
-      load_assignment:
-        cluster_name: limitador
-        endpoints:
-        - lb_endpoints:
-          - endpoint:
-              address:
-                socket_address:
-                  address: limitador
-                  port_value: 8081
-admin:
-  access_log_path: "/dev/null"
-  address:
-    socket_address:
-      address: 0.0.0.0
-      port_value: 8001
diff --git a/0.10.0/limitador/limitador-server/sandbox/envoy2.yaml b/0.10.0/limitador/limitador-server/sandbox/envoy2.yaml
deleted file mode 100644
index d1d159580..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/envoy2.yaml
+++ /dev/null
@@ -1,84 +0,0 @@
----
-static_resources:
-  listeners:
-  - name: main
-    address:
-      socket_address:
-        address: 0.0.0.0
-        port_value: 80
-    filter_chains:
-      - filters:
-        - name: envoy.filters.network.http_connection_manager
-          typed_config:
-            "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
-            stat_prefix: ingress_http
-            route_config:
-              name: local_route
-              virtual_hosts:
-                - name: local_service
-                  domains:
-                    - "*"
-                  routes:
-                    - match:
-                        prefix: "/"
-                      route:
-                        cluster: upstream
-                        rate_limits:
-                          - actions:
-                            - request_headers:
-                                header_name: :method
-                                descriptor_key: req.method
-                            - request_headers:
-                                header_name: :path
-                                descriptor_key: req.path
-            http_filters:
-            - name: envoy.filters.http.ratelimit
-              typed_config:
-                "@type": type.googleapis.com/envoy.extensions.filters.http.ratelimit.v3.RateLimit
-                domain: "test_namespace"
-                failure_mode_deny: true
-                timeout: 3s
-                rate_limit_service:
-                  transport_api_version: "v3"
-                  grpc_service:
-                    envoy_grpc:
-                      cluster_name: limitador
-            - name: envoy.filters.http.router
-  clusters:
-    - name: upstream
-      connect_timeout: 0.25s
-      type: STRICT_DNS
-      lb_policy: round_robin
-      load_assignment:
-        cluster_name: upstream
-        endpoints:
-        - lb_endpoints:
-          - endpoint:
-              address:
-                socket_address:
-                  address: upstream
-                  port_value: 80
-    - name: limitador
-      connect_timeout: 1s
-      type: STRICT_DNS
-      lb_policy: round_robin
-      typed_extension_protocol_options:
-        envoy.extensions.upstreams.http.v3.HttpProtocolOptions:
-          "@type": type.googleapis.com/envoy.extensions.upstreams.http.v3.HttpProtocolOptions
-          explicit_http_config:
-            http2_protocol_options: {}
-      load_assignment:
-        cluster_name: limitador
-        endpoints:
-        - lb_endpoints:
-          - endpoint:
-              address:
-                socket_address:
-                  address: limitador2
-                  port_value: 8081
-admin:
-  access_log_path: "/dev/null"
-  address:
-    socket_address:
-      address: 0.0.0.0
-      port_value: 8001
diff --git a/0.10.0/limitador/limitador-server/sandbox/envoy3.yaml b/0.10.0/limitador/limitador-server/sandbox/envoy3.yaml
deleted file mode 100644
index 03180c47b..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/envoy3.yaml
+++ /dev/null
@@ -1,84 +0,0 @@
----
-static_resources:
-  listeners:
-  - name: main
-    address:
-      socket_address:
-        address: 0.0.0.0
-        port_value: 80
-    filter_chains:
-      - filters:
-        - name: envoy.filters.network.http_connection_manager
-          typed_config:
-            "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
-            stat_prefix: ingress_http
-            route_config:
-              name: local_route
-              virtual_hosts:
-                - name: local_service
-                  domains:
-                    - "*"
-                  routes:
-                    - match:
-                        prefix: "/"
-                      route:
-                        cluster: upstream
-                        rate_limits:
-                          - actions:
-                            - request_headers:
-                                header_name: :method
-                                descriptor_key: req.method
-                            - request_headers:
-                                header_name: :path
-                                descriptor_key: req.path
-            http_filters:
-            - name: envoy.filters.http.ratelimit
-              typed_config:
-                "@type": type.googleapis.com/envoy.extensions.filters.http.ratelimit.v3.RateLimit
-                domain: "test_namespace"
-                failure_mode_deny: true
-                timeout: 3s
-                rate_limit_service:
-                  transport_api_version: "v3"
-                  grpc_service:
-                    envoy_grpc:
-                      cluster_name: limitador
-            - name: envoy.filters.http.router
-  clusters:
-    - name: upstream
-      connect_timeout: 0.25s
-      type: STRICT_DNS
-      lb_policy: round_robin
-      load_assignment:
-        cluster_name: upstream
-        endpoints:
-        - lb_endpoints:
-          - endpoint:
-              address:
-                socket_address:
-                  address: upstream
-                  port_value: 80
-    - name: limitador
-      connect_timeout: 1s
-      type: STRICT_DNS
-      lb_policy: round_robin
-      typed_extension_protocol_options:
-        envoy.extensions.upstreams.http.v3.HttpProtocolOptions:
-          "@type": type.googleapis.com/envoy.extensions.upstreams.http.v3.HttpProtocolOptions
-          explicit_http_config:
-            http2_protocol_options: {}
-      load_assignment:
-        cluster_name: limitador
-        endpoints:
-        - lb_endpoints:
-          - endpoint:
-              address:
-                socket_address:
-                  address: limitador3
-                  port_value: 8081
-admin:
-  access_log_path: "/dev/null"
-  address:
-    socket_address:
-      address: 0.0.0.0
-      port_value: 8001
diff --git a/0.10.0/limitador/limitador-server/sandbox/index.html b/0.10.0/limitador/limitador-server/sandbox/index.html
deleted file mode 100644
index 8727be641..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/index.html
+++ /dev/null
@@ -1,3801 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/limitador-server/sandbox/">
-      
-      
-        <link rel="prev" href="../kubernetes/">
-      
-      
-        <link rel="next" href="../../limitador/">
-      
-      
-      <link rel="icon" href="../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Sandbox - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#testing-environment" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Sandbox
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#testing-environment" class="md-nav__link">
-    <span class="md-ellipsis">
-      Testing Environment
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Testing Environment">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deployment-options" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deployment options
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#running-multi-node-distributed-deployments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Running Multi Node Distributed Deployments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitadors-admin-http-endpoint" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador's admin HTTP endpoint
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitadors-grpc-ratelimitservice-endpoint" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador's GRPC RateLimitService endpoint
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#downstream-traffic" class="md-nav__link">
-    <span class="md-ellipsis">
-      Downstream traffic
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#load-testing-the-grpc-ratelimitservice-directly" class="md-nav__link">
-    <span class="md-ellipsis">
-      Load Testing the GRPC RateLimitService directly
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#load-testing-via-envoy-proxy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Load Testing via Envoy Proxy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitador-image" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador Image
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clean-env" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean env
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#testing-environment" class="md-nav__link">
-    <span class="md-ellipsis">
-      Testing Environment
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Testing Environment">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#requirements" class="md-nav__link">
-    <span class="md-ellipsis">
-      Requirements
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#setup" class="md-nav__link">
-    <span class="md-ellipsis">
-      Setup
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#deployment-options" class="md-nav__link">
-    <span class="md-ellipsis">
-      Deployment options
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#running-multi-node-distributed-deployments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Running Multi Node Distributed Deployments
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitadors-admin-http-endpoint" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador's admin HTTP endpoint
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitadors-grpc-ratelimitservice-endpoint" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador's GRPC RateLimitService endpoint
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#downstream-traffic" class="md-nav__link">
-    <span class="md-ellipsis">
-      Downstream traffic
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#load-testing-the-grpc-ratelimitservice-directly" class="md-nav__link">
-    <span class="md-ellipsis">
-      Load Testing the GRPC RateLimitService directly
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#load-testing-via-envoy-proxy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Load Testing via Envoy Proxy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#limitador-image" class="md-nav__link">
-    <span class="md-ellipsis">
-      Limitador Image
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#clean-env" class="md-nav__link">
-    <span class="md-ellipsis">
-      Clean env
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/limitador-server/sandbox/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Sandbox</h1>
-
-<h2 id="testing-environment">Testing Environment<a class="headerlink" href="#testing-environment" title="Permanent link">&para;</a></h2>
-<h3 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h3>
-<ul>
-<li><em>docker</em> v24+</li>
-</ul>
-<h3 id="setup">Setup<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h3>
-<p>Clone the project</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/Kuadrant/limitador.git
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nb">cd</span><span class="w"> </span>limitador/limitador-server/sandbox
-</span></code></pre></div>
-<p>Check out <code>make help</code> for all the targets.</p>
-<h3 id="deployment-options">Deployment options<a class="headerlink" href="#deployment-options" title="Permanent link">&para;</a></h3>
-<table>
-<thead>
-<tr>
-<th>Limitador's configuration</th>
-<th>Command</th>
-<th>Info</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>In-memory configuration</td>
-<td><code>make deploy-in-memory</code></td>
-<td>Counters are held in Limitador (ephemeral)</td>
-</tr>
-<tr>
-<td>Redis</td>
-<td><code>make deploy-redis</code></td>
-<td>Uses Redis to store counters</td>
-</tr>
-<tr>
-<td>Redis Secured</td>
-<td><code>make deploy-redis-tls</code></td>
-<td>Uses Redis with TLS and password protected to store counters</td>
-</tr>
-<tr>
-<td>Redis Cached</td>
-<td><code>make deploy-redis-cached</code></td>
-<td>Uses Redis to store counters, with an in-memory cache</td>
-</tr>
-<tr>
-<td>Redis Otel Instrumented</td>
-<td><code>make deploy-redis-otel</code></td>
-<td>Uses redis to store counters, <a href="redis-otel/">instrumented with opentelemetry</a></td>
-</tr>
-<tr>
-<td>Disk</td>
-<td><code>make deploy-disk</code></td>
-<td>Uses disk to store counters</td>
-</tr>
-<tr>
-<td>Distributed</td>
-<td><code>make deploy-distributed</code></td>
-<td>Counters are held in Limitador (ephemeral) but replicated to other Limitador servers.</td>
-</tr>
-</tbody>
-</table>
-<p>| Distributed 3 Node | <code>make deploy-distributed-3-node</code> | Counters are held in Limitador (ephemeral) but replicated to 3 other Limitador servers. |</p>
-<h3 id="running-multi-node-distributed-deployments">Running Multi Node Distributed Deployments<a class="headerlink" href="#running-multi-node-distributed-deployments" title="Permanent link">&para;</a></h3>
-<p>The <code>make deploy-distributed</code> target can be connected to other Limitador servers but requires you to set the <code>PEER_ID</code> and <code>PEER_URLS</code> environment variables when you run the target.</p>
-<p>If you have 3 servers you want to replicate between, you would run the following commands:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="c1"># on server where: hostname=server1</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nv">PEER_ID</span><span class="o">=</span><span class="sb">`</span>hostname<span class="sb">`</span><span class="w"> </span><span class="nv">PEER_URLS</span><span class="o">=</span><span class="s2">&quot;http://server2:15001 http://server3:15001&quot;</span><span class="w"> </span>make<span class="w"> </span>deploy-distributed
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="c1"># on server where: hostname=server2</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nv">PEER_ID</span><span class="o">=</span><span class="sb">`</span>hostname<span class="sb">`</span><span class="w"> </span><span class="nv">PEER_URLS</span><span class="o">=</span><span class="s2">&quot;http://server1:15001 http://server3:15001&quot;</span><span class="w"> </span>make<span class="w"> </span>deploy-distributed
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="c1"># on server where: hostname=server3</span>
-</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nv">PEER_ID</span><span class="o">=</span><span class="sb">`</span>hostname<span class="sb">`</span><span class="w"> </span><span class="nv">PEER_URLS</span><span class="o">=</span><span class="s2">&quot;http://server1:15001 http://server2:15001&quot;</span><span class="w"> </span>make<span class="w"> </span>deploy-distributed
-</span></code></pre></div>
-<p>The <code>PEER_ID</code> just need to be unique between the servers, and the <code>PEER_URLS</code> should be a space-separated list of the other servers' URLs.</p>
-<h3 id="limitadors-admin-http-endpoint">Limitador's admin HTTP endpoint<a class="headerlink" href="#limitadors-admin-http-endpoint" title="Permanent link">&para;</a></h3>
-<p>Limits</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>curl<span class="w"> </span>-i<span class="w"> </span>http://127.0.0.1:18080/limits/test_namespace
-</span></code></pre></div>
-<p>Counters</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>curl<span class="w"> </span>-i<span class="w"> </span>http://127.0.0.1:18080/counters/test_namespace
-</span></code></pre></div>
-<p>Metrics</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl<span class="w"> </span>-i<span class="w"> </span>http://127.0.0.1:18080/metrics
-</span></code></pre></div>
-<h3 id="limitadors-grpc-ratelimitservice-endpoint">Limitador's GRPC RateLimitService endpoint<a class="headerlink" href="#limitadors-grpc-ratelimitservice-endpoint" title="Permanent link">&para;</a></h3>
-<p>Get <code>grpcurl</code>. You need <a href="https://golang.org/doc/install">Go SDK</a> installed.</p>
-<p>Golang version &gt;= 1.18 (from <a href="https://github.com/fullstorydev/grpcurl/blob/v1.8.9/go.mod#L3">fullstorydev/grpcurl</a>)</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>make<span class="w"> </span>grpcurl
-</span></code></pre></div>
-<p>Inspect <code>RateLimitService</code> GRPC service</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>bin/grpcurl<span class="w"> </span>-plaintext<span class="w"> </span><span class="m">127</span>.0.0.1:18081<span class="w"> </span>describe<span class="w"> </span>envoy.service.ratelimit.v3.RateLimitService
-</span></code></pre></div>
-<p>Make a custom request</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>bin/grpcurl<span class="w"> </span>-plaintext<span class="w"> </span>-d<span class="w"> </span>@<span class="w"> </span><span class="m">127</span>.0.0.1:18081<span class="w"> </span>envoy.service.ratelimit.v3.RateLimitService.ShouldRateLimit<span class="w"> </span><span class="s">&lt;&lt;EOM</span>
-</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="s">{</span>
-</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="s">    &quot;domain&quot;: &quot;test_namespace&quot;,</span>
-</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="s">    &quot;hits_addend&quot;: 1,</span>
-</span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="s">    &quot;descriptors&quot;: [</span>
-</span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="s">        {</span>
-</span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="s">            &quot;entries&quot;: [</span>
-</span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="s">                {</span>
-</span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="s">                    &quot;key&quot;: &quot;req.method&quot;,</span>
-</span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="s">                    &quot;value&quot;: &quot;POST&quot;</span>
-</span><span id="__span-9-11"><a id="__codelineno-9-11" name="__codelineno-9-11" href="#__codelineno-9-11"></a><span class="s">                },</span>
-</span><span id="__span-9-12"><a id="__codelineno-9-12" name="__codelineno-9-12" href="#__codelineno-9-12"></a><span class="s">                {</span>
-</span><span id="__span-9-13"><a id="__codelineno-9-13" name="__codelineno-9-13" href="#__codelineno-9-13"></a><span class="s">                    &quot;key&quot;: &quot;req.path&quot;,</span>
-</span><span id="__span-9-14"><a id="__codelineno-9-14" name="__codelineno-9-14" href="#__codelineno-9-14"></a><span class="s">                    &quot;value&quot;: &quot;/&quot;</span>
-</span><span id="__span-9-15"><a id="__codelineno-9-15" name="__codelineno-9-15" href="#__codelineno-9-15"></a><span class="s">                }</span>
-</span><span id="__span-9-16"><a id="__codelineno-9-16" name="__codelineno-9-16" href="#__codelineno-9-16"></a><span class="s">            ]</span>
-</span><span id="__span-9-17"><a id="__codelineno-9-17" name="__codelineno-9-17" href="#__codelineno-9-17"></a><span class="s">        }</span>
-</span><span id="__span-9-18"><a id="__codelineno-9-18" name="__codelineno-9-18" href="#__codelineno-9-18"></a><span class="s">    ]</span>
-</span><span id="__span-9-19"><a id="__codelineno-9-19" name="__codelineno-9-19" href="#__codelineno-9-19"></a><span class="s">}</span>
-</span><span id="__span-9-20"><a id="__codelineno-9-20" name="__codelineno-9-20" href="#__codelineno-9-20"></a><span class="s">EOM</span>
-</span></code></pre></div>
-<p>Do repeated requests. As the limit is set to max 5 request for 60 seconds,
-you should see <code>OVER_LIMIT</code> response after 5 requests.</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="k">while</span><span class="w"> </span>:<span class="p">;</span><span class="w"> </span><span class="k">do</span><span class="w"> </span>bin/grpcurl<span class="w"> </span>-plaintext<span class="w"> </span>-d<span class="w"> </span>@<span class="w"> </span><span class="m">127</span>.0.0.1:18081<span class="w"> </span>envoy.service.ratelimit.v3.RateLimitService.ShouldRateLimit<span class="w"> </span><span class="s">&lt;&lt;EOM; sleep 1; done</span>
-</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="s">{</span>
-</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="s">    &quot;domain&quot;: &quot;test_namespace&quot;,</span>
-</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="s">    &quot;hits_addend&quot;: 1,</span>
-</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="s">    &quot;descriptors&quot;: [</span>
-</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="s">        {</span>
-</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="s">            &quot;entries&quot;: [</span>
-</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="s">                {</span>
-</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="s">                    &quot;key&quot;: &quot;req.method&quot;,</span>
-</span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="s">                    &quot;value&quot;: &quot;POST&quot;</span>
-</span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="s">                },</span>
-</span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="s">                {</span>
-</span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="s">                    &quot;key&quot;: &quot;req.path&quot;,</span>
-</span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="s">                    &quot;value&quot;: &quot;/&quot;</span>
-</span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="s">                }</span>
-</span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="s">            ]</span>
-</span><span id="__span-10-17"><a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a><span class="s">        }</span>
-</span><span id="__span-10-18"><a id="__codelineno-10-18" name="__codelineno-10-18" href="#__codelineno-10-18"></a><span class="s">    ]</span>
-</span><span id="__span-10-19"><a id="__codelineno-10-19" name="__codelineno-10-19" href="#__codelineno-10-19"></a><span class="s">}</span>
-</span><span id="__span-10-20"><a id="__codelineno-10-20" name="__codelineno-10-20" href="#__codelineno-10-20"></a><span class="s">EOM</span>
-</span></code></pre></div>
-<h3 id="downstream-traffic">Downstream traffic<a class="headerlink" href="#downstream-traffic" title="Permanent link">&para;</a></h3>
-<p><strong>Upstream</strong> service implemented by <a href="https://httpbin.org/">httpbin.org</a></p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>curl<span class="w"> </span>-i<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Host: example.com&quot;</span><span class="w"> </span>http://127.0.0.1:18000/get
-</span></code></pre></div>
-<h3 id="load-testing-the-grpc-ratelimitservice-directly">Load Testing the GRPC RateLimitService directly<a class="headerlink" href="#load-testing-the-grpc-ratelimitservice-directly" title="Permanent link">&para;</a></h3>
-<p>This load test will use <code>grpcurl</code>. You need <a href="https://golang.org/doc/install">Go SDK</a> installed.</p>
-<p>Run a load test a 5000 requests per second (RPS) for 10 seconds:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="nv">RPS</span><span class="o">=</span><span class="m">5000</span><span class="w"> </span>make<span class="w"> </span>load-test
-</span></code></pre></div>
-<h3 id="load-testing-via-envoy-proxy">Load Testing via Envoy Proxy<a class="headerlink" href="#load-testing-via-envoy-proxy" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>cargo<span class="w"> </span>run<span class="w"> </span>--manifest-path<span class="w"> </span>loadtest/Cargo.toml<span class="w">  </span>--package<span class="w"> </span>loadtest<span class="w"> </span>--release<span class="w"> </span>--<span class="w"> </span>--report-file<span class="o">=</span>report.htm
-</span></code></pre></div>
-<p>The report will be saved in <code>report.htm</code> file.</p>
-<h3 id="limitador-image">Limitador Image<a class="headerlink" href="#limitador-image" title="Permanent link">&para;</a></h3>
-<p>By default, the sandbox will run Limitador's <code>limitador-testing:latest</code> image.</p>
-<p><strong>Building <code>limitador-testing:latest</code> image</strong></p>
-<p>You can easily build the limitador's image from the current workspace code base with:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>make<span class="w"> </span>build
-</span></code></pre></div>
-<p>The image will be tagged with <code>limitador-testing:latest</code></p>
-<p><strong>Using custom Limitador's image</strong></p>
-<p>The <code>LIMITADOR_IMAGE</code> environment variable overrides the default image. For example:</p>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>make<span class="w"> </span>deploy-in-memory<span class="w"> </span><span class="nv">LIMITADOR_IMAGE</span><span class="o">=</span>quay.io/kuadrant/limitador:latest
-</span></code></pre></div>
-<h3 id="clean-env">Clean env<a class="headerlink" href="#clean-env" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a>make<span class="w"> </span>clean
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/sandbox/limits.yaml b/0.10.0/limitador/limitador-server/sandbox/limits.yaml
deleted file mode 100644
index 68b6df8df..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/limits.yaml
+++ /dev/null
@@ -1,22 +0,0 @@
----
-- namespace: test_namespace
-  max_value: 10
-  seconds: 60
-  conditions:
-    - "req.method == 'GET'"
-    - "req.path != '/json'"
-  variables: []
-- namespace: test_namespace
-  max_value: 5
-  seconds: 60
-  conditions:
-    - "req.method == 'POST'"
-    - "req.path != '/json'"
-  variables: []
-- namespace: test_namespace
-  max_value: 50000
-  seconds: 10
-  conditions:
-    - "req.method == 'GET'"
-    - "req.path == '/json'"
-  variables: []
diff --git a/0.10.0/limitador/limitador-server/sandbox/load-test.json b/0.10.0/limitador/limitador-server/sandbox/load-test.json
deleted file mode 100644
index b23422cc9..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/load-test.json
+++ /dev/null
@@ -1,18 +0,0 @@
-{
-    "domain": "test_namespace",
-    "hits_addend": 1,
-    "descriptors": [
-        {   
-            "entries": [
-                {
-                    "key": "req.method",
-                    "value": "GET"
-                },
-                {
-                    "key": "req.path",
-                    "value": "/json"
-                }
-            ]
-        }
-    ]
-}
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/sandbox/loadtest/Cargo.lock b/0.10.0/limitador/limitador-server/sandbox/loadtest/Cargo.lock
deleted file mode 100644
index e0ca2c5f8..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/loadtest/Cargo.lock
+++ /dev/null
@@ -1,1874 +0,0 @@
-# This file is automatically @generated by Cargo.
-# It is not intended for manual editing.
-version = 3
-
-[[package]]
-name = "addr2line"
-version = "0.22.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6e4503c46a5c0c7844e948c9a4d6acd9f50cccb4de1c48eb9e291ea17470c678"
-dependencies = [
- "gimli",
-]
-
-[[package]]
-name = "adler"
-version = "1.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f26201604c87b1e01bd3d98f8d5d9a8fcbb815e8cedb41ffccbeb4bf593a35fe"
-
-[[package]]
-name = "aho-corasick"
-version = "1.1.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916"
-dependencies = [
- "memchr",
-]
-
-[[package]]
-name = "android-tzdata"
-version = "0.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e999941b234f3131b00bc13c22d06e8c5ff726d1b6318ac7eb276997bbb4fef0"
-
-[[package]]
-name = "android_system_properties"
-version = "0.1.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311"
-dependencies = [
- "libc",
-]
-
-[[package]]
-name = "arrayvec"
-version = "0.7.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711"
-
-[[package]]
-name = "async-compression"
-version = "0.4.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cd066d0b4ef8ecb03a55319dc13aa6910616d0f44008a045bb1835af830abff5"
-dependencies = [
- "flate2",
- "futures-core",
- "memchr",
- "pin-project-lite",
- "tokio",
-]
-
-[[package]]
-name = "async-trait"
-version = "0.1.80"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c6fa2087f2753a7da8cc1c0dbfcf89579dd57458e36769de5ac750b4671737ca"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.66",
-]
-
-[[package]]
-name = "autocfg"
-version = "1.3.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0c4b4d0bd25bd0b74681c0ad21497610ce1b7c91b1022cd21c80c6fbdd9476b0"
-
-[[package]]
-name = "backtrace"
-version = "0.3.72"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "17c6a35df3749d2e8bb1b7b21a976d82b15548788d2735b9d82f329268f71a11"
-dependencies = [
- "addr2line",
- "cc",
- "cfg-if",
- "libc",
- "miniz_oxide",
- "object",
- "rustc-demangle",
-]
-
-[[package]]
-name = "base64"
-version = "0.21.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
-
-[[package]]
-name = "bitflags"
-version = "1.3.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
-
-[[package]]
-name = "bitflags"
-version = "2.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cf4b9d6a944f767f8e5e0db018570623c85f3d925ac718db4e06d0187adb21c1"
-
-[[package]]
-name = "block-buffer"
-version = "0.10.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
-dependencies = [
- "generic-array",
-]
-
-[[package]]
-name = "bumpalo"
-version = "3.16.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "79296716171880943b8470b5f8d03aa55eb2e645a4874bdbb28adb49162e012c"
-
-[[package]]
-name = "byteorder"
-version = "1.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
-
-[[package]]
-name = "bytes"
-version = "1.6.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "514de17de45fdb8dc022b1a7975556c53c86f9f0aa5f534b98977b171857c2c9"
-
-[[package]]
-name = "cc"
-version = "1.0.99"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96c51067fd44124faa7f870b4b1c969379ad32b2ba805aa959430ceaa384f695"
-
-[[package]]
-name = "cfg-if"
-version = "1.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
-
-[[package]]
-name = "cfg_aliases"
-version = "0.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fd16c4719339c4530435d38e511904438d07cce7950afa3718a84ac36c10e89e"
-
-[[package]]
-name = "chrono"
-version = "0.4.38"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a21f936df1771bf62b77f047b726c4625ff2e8aa607c01ec06e5a05bd8463401"
-dependencies = [
- "android-tzdata",
- "iana-time-zone",
- "num-traits",
- "windows-targets 0.52.5",
-]
-
-[[package]]
-name = "cookie"
-version = "0.17.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7efb37c3e1ccb1ff97164ad95ac1606e8ccd35b3fa0a7d99a304c7f4a428cc24"
-dependencies = [
- "percent-encoding",
- "time",
- "version_check",
-]
-
-[[package]]
-name = "cookie_store"
-version = "0.20.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "387461abbc748185c3a6e1673d826918b450b87ff22639429c694619a83b6cf6"
-dependencies = [
- "cookie",
- "idna 0.3.0",
- "log",
- "publicsuffix",
- "serde",
- "serde_derive",
- "serde_json",
- "time",
- "url",
-]
-
-[[package]]
-name = "core-foundation"
-version = "0.9.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "91e195e091a93c46f7102ec7818a2aa394e1e1771c3ab4825963fa03e45afb8f"
-dependencies = [
- "core-foundation-sys",
- "libc",
-]
-
-[[package]]
-name = "core-foundation-sys"
-version = "0.8.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "06ea2b9bc92be3c2baa9334a323ebca2d6f074ff852cd1d7b11064035cd3868f"
-
-[[package]]
-name = "cpufeatures"
-version = "0.2.12"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "53fe5e26ff1b7aef8bca9c6080520cfb8d9333c7568e1829cef191a9723e5504"
-dependencies = [
- "libc",
-]
-
-[[package]]
-name = "crc32fast"
-version = "1.4.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a97769d94ddab943e4510d138150169a2758b5ef3eb191a9ee688de3e23ef7b3"
-dependencies = [
- "cfg-if",
-]
-
-[[package]]
-name = "crypto-common"
-version = "0.1.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
-dependencies = [
- "generic-array",
- "typenum",
-]
-
-[[package]]
-name = "ctrlc"
-version = "3.4.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "672465ae37dc1bc6380a6547a8883d5dd397b0f1faaad4f265726cc7042a5345"
-dependencies = [
- "nix",
- "windows-sys 0.52.0",
-]
-
-[[package]]
-name = "data-encoding"
-version = "2.6.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e8566979429cf69b49a5c740c60791108e86440e8be149bbea4fe54d2c32d6e2"
-
-[[package]]
-name = "deranged"
-version = "0.3.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b42b6fa04a440b495c8b04d0e71b707c585f83cb9cb28cf8cd0d976c315e31b4"
-dependencies = [
- "powerfmt",
-]
-
-[[package]]
-name = "digest"
-version = "0.10.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
-dependencies = [
- "block-buffer",
- "crypto-common",
-]
-
-[[package]]
-name = "downcast-rs"
-version = "1.2.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75b325c5dbd37f80359721ad39aca5a29fb04c89279657cffdda8736d0c0b9d2"
-
-[[package]]
-name = "either"
-version = "1.12.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3dca9240753cf90908d7e4aac30f630662b02aebaa1b58a3cadabdb23385b58b"
-
-[[package]]
-name = "encoding_rs"
-version = "0.8.34"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b45de904aa0b010bce2ab45264d0631681847fa7b6f2eaa7dab7619943bc4f59"
-dependencies = [
- "cfg-if",
-]
-
-[[package]]
-name = "equivalent"
-version = "1.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
-
-[[package]]
-name = "errno"
-version = "0.3.9"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "534c5cf6194dfab3db3242765c03bbe257cf92f22b38f6bc0c58d59108a820ba"
-dependencies = [
- "libc",
- "windows-sys 0.52.0",
-]
-
-[[package]]
-name = "fastrand"
-version = "2.1.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9fc0510504f03c51ada170672ac806f1f105a88aa97a5281117e1ddc3368e51a"
-
-[[package]]
-name = "flate2"
-version = "1.0.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5f54427cfd1c7829e2a139fcefea601bf088ebca651d2bf53ebc600eac295dae"
-dependencies = [
- "crc32fast",
- "miniz_oxide",
-]
-
-[[package]]
-name = "flume"
-version = "0.11.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "55ac459de2512911e4b674ce33cf20befaba382d05b62b008afc1c8b57cbf181"
-dependencies = [
- "futures-core",
- "futures-sink",
- "nanorand",
- "spin",
-]
-
-[[package]]
-name = "fnv"
-version = "1.0.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
-
-[[package]]
-name = "foreign-types"
-version = "0.3.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f6f339eb8adc052cd2ca78910fda869aefa38d22d5cb648e6485e4d3fc06f3b1"
-dependencies = [
- "foreign-types-shared",
-]
-
-[[package]]
-name = "foreign-types-shared"
-version = "0.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "00b0228411908ca8685dba7fc2cdd70ec9990a6e753e89b6ac91a84c40fbaf4b"
-
-[[package]]
-name = "form_urlencoded"
-version = "1.2.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e13624c2627564efccf4934284bdd98cbaa14e79b0b5a141218e507b3a823456"
-dependencies = [
- "percent-encoding",
-]
-
-[[package]]
-name = "futures"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "645c6916888f6cb6350d2550b80fb63e734897a8498abe35cfb732b6487804b0"
-dependencies = [
- "futures-channel",
- "futures-core",
- "futures-executor",
- "futures-io",
- "futures-sink",
- "futures-task",
- "futures-util",
-]
-
-[[package]]
-name = "futures-channel"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eac8f7d7865dcb88bd4373ab671c8cf4508703796caa2b1985a9ca867b3fcb78"
-dependencies = [
- "futures-core",
- "futures-sink",
-]
-
-[[package]]
-name = "futures-core"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dfc6580bb841c5a68e9ef15c77ccc837b40a7504914d52e47b8b0e9bbda25a1d"
-
-[[package]]
-name = "futures-executor"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a576fc72ae164fca6b9db127eaa9a9dda0d61316034f33a0a0d4eda41f02b01d"
-dependencies = [
- "futures-core",
- "futures-task",
- "futures-util",
-]
-
-[[package]]
-name = "futures-io"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a44623e20b9681a318efdd71c299b6b222ed6f231972bfe2f224ebad6311f0c1"
-
-[[package]]
-name = "futures-macro"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "87750cf4b7a4c0625b1529e4c543c2182106e4dedc60a2a6455e00d212c489ac"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.66",
-]
-
-[[package]]
-name = "futures-sink"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9fb8e00e87438d937621c1c6269e53f536c14d3fbd6a042bb24879e57d474fb5"
-
-[[package]]
-name = "futures-task"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "38d84fa142264698cdce1a9f9172cf383a0c82de1bddcf3092901442c4097004"
-
-[[package]]
-name = "futures-util"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3d6401deb83407ab3da39eba7e33987a73c3df0c82b4bb5813ee871c19c41d48"
-dependencies = [
- "futures-channel",
- "futures-core",
- "futures-io",
- "futures-macro",
- "futures-sink",
- "futures-task",
- "memchr",
- "pin-project-lite",
- "pin-utils",
- "slab",
-]
-
-[[package]]
-name = "generic-array"
-version = "0.14.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
-dependencies = [
- "typenum",
- "version_check",
-]
-
-[[package]]
-name = "getrandom"
-version = "0.2.15"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4567c8db10ae91089c99af84c68c38da3ec2f087c3f82960bcdbf3656b6f4d7"
-dependencies = [
- "cfg-if",
- "js-sys",
- "libc",
- "wasi",
- "wasm-bindgen",
-]
-
-[[package]]
-name = "gimli"
-version = "0.29.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "40ecd4077b5ae9fd2e9e169b102c6c330d0605168eb0e8bf79952b256dbefffd"
-
-[[package]]
-name = "goose"
-version = "0.17.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6cfeedc01d217935e1371901ea642ea6693d68893c67336d146eba23be04bf11"
-dependencies = [
- "async-trait",
- "chrono",
- "ctrlc",
- "downcast-rs",
- "flume",
- "futures",
- "gumdrop",
- "http",
- "itertools",
- "lazy_static",
- "log",
- "num-format",
- "rand",
- "regex",
- "reqwest",
- "serde",
- "serde_json",
- "simplelog",
- "strum",
- "strum_macros",
- "tokio",
- "tokio-tungstenite",
- "tungstenite",
- "url",
-]
-
-[[package]]
-name = "gumdrop"
-version = "0.8.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5bc700f989d2f6f0248546222d9b4258f5b02a171a431f8285a81c08142629e3"
-dependencies = [
- "gumdrop_derive",
-]
-
-[[package]]
-name = "gumdrop_derive"
-version = "0.8.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "729f9bd3449d77e7831a18abfb7ba2f99ee813dfd15b8c2167c9a54ba20aa99d"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 1.0.109",
-]
-
-[[package]]
-name = "h2"
-version = "0.3.26"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "81fe527a889e1532da5c525686d96d4c2e74cdd345badf8dfef9f6b39dd5f5e8"
-dependencies = [
- "bytes",
- "fnv",
- "futures-core",
- "futures-sink",
- "futures-util",
- "http",
- "indexmap",
- "slab",
- "tokio",
- "tokio-util",
- "tracing",
-]
-
-[[package]]
-name = "hashbrown"
-version = "0.14.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e5274423e17b7c9fc20b6e7e208532f9b19825d82dfd615708b70edd83df41f1"
-
-[[package]]
-name = "heck"
-version = "0.4.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8"
-
-[[package]]
-name = "hermit-abi"
-version = "0.3.9"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d231dfb89cfffdbc30e7fc41579ed6066ad03abda9e567ccafae602b97ec5024"
-
-[[package]]
-name = "http"
-version = "0.2.12"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "601cbb57e577e2f5ef5be8e7b83f0f63994f25aa94d673e54a92d5c516d101f1"
-dependencies = [
- "bytes",
- "fnv",
- "itoa",
-]
-
-[[package]]
-name = "http-body"
-version = "0.4.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7ceab25649e9960c0311ea418d17bee82c0dcec1bd053b5f9a66e265a693bed2"
-dependencies = [
- "bytes",
- "http",
- "pin-project-lite",
-]
-
-[[package]]
-name = "httparse"
-version = "1.8.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d897f394bad6a705d5f4104762e116a75639e470d80901eed05a860a95cb1904"
-
-[[package]]
-name = "httpdate"
-version = "1.0.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
-
-[[package]]
-name = "hyper"
-version = "0.14.29"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f361cde2f109281a220d4307746cdfd5ee3f410da58a70377762396775634b33"
-dependencies = [
- "bytes",
- "futures-channel",
- "futures-core",
- "futures-util",
- "h2",
- "http",
- "http-body",
- "httparse",
- "httpdate",
- "itoa",
- "pin-project-lite",
- "socket2",
- "tokio",
- "tower-service",
- "tracing",
- "want",
-]
-
-[[package]]
-name = "hyper-tls"
-version = "0.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d6183ddfa99b85da61a140bea0efc93fdf56ceaa041b37d553518030827f9905"
-dependencies = [
- "bytes",
- "hyper",
- "native-tls",
- "tokio",
- "tokio-native-tls",
-]
-
-[[package]]
-name = "iana-time-zone"
-version = "0.1.60"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e7ffbb5a1b541ea2561f8c41c087286cc091e21e556a4f09a8f6cbf17b69b141"
-dependencies = [
- "android_system_properties",
- "core-foundation-sys",
- "iana-time-zone-haiku",
- "js-sys",
- "wasm-bindgen",
- "windows-core",
-]
-
-[[package]]
-name = "iana-time-zone-haiku"
-version = "0.1.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f"
-dependencies = [
- "cc",
-]
-
-[[package]]
-name = "idna"
-version = "0.3.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e14ddfc70884202db2244c223200c204c2bda1bc6e0998d11b5e024d657209e6"
-dependencies = [
- "unicode-bidi",
- "unicode-normalization",
-]
-
-[[package]]
-name = "idna"
-version = "0.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "634d9b1461af396cad843f47fdba5597a4f9e6ddd4bfb6ff5d85028c25cb12f6"
-dependencies = [
- "unicode-bidi",
- "unicode-normalization",
-]
-
-[[package]]
-name = "indexmap"
-version = "2.2.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "168fb715dda47215e360912c096649d23d58bf392ac62f73919e831745e40f26"
-dependencies = [
- "equivalent",
- "hashbrown",
-]
-
-[[package]]
-name = "ipnet"
-version = "2.9.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f518f335dce6725a761382244631d86cf0ccb2863413590b31338feb467f9c3"
-
-[[package]]
-name = "itertools"
-version = "0.11.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1c173a5686ce8bfa551b3563d0c2170bf24ca44da99c7ca4bfdab5418c3fe57"
-dependencies = [
- "either",
-]
-
-[[package]]
-name = "itoa"
-version = "1.0.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "49f1f14873335454500d59611f1cf4a4b0f786f9ac11f4312a78e4cf2566695b"
-
-[[package]]
-name = "js-sys"
-version = "0.3.69"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "29c15563dc2726973df627357ce0c9ddddbea194836909d655df6a75d2cf296d"
-dependencies = [
- "wasm-bindgen",
-]
-
-[[package]]
-name = "lazy_static"
-version = "1.4.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
-
-[[package]]
-name = "libc"
-version = "0.2.155"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "97b3888a4aecf77e811145cadf6eef5901f4782c53886191b2f693f24761847c"
-
-[[package]]
-name = "linux-raw-sys"
-version = "0.4.14"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "78b3ae25bc7c8c38cec158d1f2757ee79e9b3740fbc7ccf0e59e4b08d793fa89"
-
-[[package]]
-name = "loadtest"
-version = "0.1.0"
-dependencies = [
- "goose",
- "tokio",
-]
-
-[[package]]
-name = "lock_api"
-version = "0.4.12"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "07af8b9cdd281b7915f413fa73f29ebd5d55d0d3f0155584dade1ff18cea1b17"
-dependencies = [
- "autocfg",
- "scopeguard",
-]
-
-[[package]]
-name = "log"
-version = "0.4.21"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "90ed8c1e510134f979dbc4f070f87d4313098b704861a105fe34231c70a3901c"
-
-[[package]]
-name = "memchr"
-version = "2.7.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6c8640c5d730cb13ebd907d8d04b52f55ac9a2eec55b440c8892f40d56c76c1d"
-
-[[package]]
-name = "mime"
-version = "0.3.17"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a"
-
-[[package]]
-name = "miniz_oxide"
-version = "0.7.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "87dfd01fe195c66b572b37921ad8803d010623c0aca821bea2302239d155cdae"
-dependencies = [
- "adler",
-]
-
-[[package]]
-name = "mio"
-version = "0.8.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a4a650543ca06a924e8b371db273b2756685faae30f8487da1b56505a8f78b0c"
-dependencies = [
- "libc",
- "wasi",
- "windows-sys 0.48.0",
-]
-
-[[package]]
-name = "nanorand"
-version = "0.7.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6a51313c5820b0b02bd422f4b44776fbf47961755c74ce64afc73bfad10226c3"
-dependencies = [
- "getrandom",
-]
-
-[[package]]
-name = "native-tls"
-version = "0.2.12"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a8614eb2c83d59d1c8cc974dd3f920198647674a0a035e1af1fa58707e317466"
-dependencies = [
- "libc",
- "log",
- "openssl",
- "openssl-probe",
- "openssl-sys",
- "schannel",
- "security-framework",
- "security-framework-sys",
- "tempfile",
-]
-
-[[package]]
-name = "nix"
-version = "0.28.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab2156c4fce2f8df6c499cc1c763e4394b7482525bf2a9701c9d79d215f519e4"
-dependencies = [
- "bitflags 2.5.0",
- "cfg-if",
- "cfg_aliases",
- "libc",
-]
-
-[[package]]
-name = "num-conv"
-version = "0.1.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
-
-[[package]]
-name = "num-format"
-version = "0.4.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a652d9771a63711fd3c3deb670acfbe5c30a4072e664d7a3bf5a9e1056ac72c3"
-dependencies = [
- "arrayvec",
- "itoa",
-]
-
-[[package]]
-name = "num-traits"
-version = "0.2.19"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
-dependencies = [
- "autocfg",
-]
-
-[[package]]
-name = "num_cpus"
-version = "1.16.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4161fcb6d602d4d2081af7c3a45852d875a03dd337a6bfdd6e06407b61342a43"
-dependencies = [
- "hermit-abi",
- "libc",
-]
-
-[[package]]
-name = "num_threads"
-version = "0.1.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5c7398b9c8b70908f6371f47ed36737907c87c52af34c268fed0bf0ceb92ead9"
-dependencies = [
- "libc",
-]
-
-[[package]]
-name = "object"
-version = "0.35.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b8ec7ab813848ba4522158d5517a6093db1ded27575b070f4177b8d12b41db5e"
-dependencies = [
- "memchr",
-]
-
-[[package]]
-name = "once_cell"
-version = "1.19.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3fdb12b2476b595f9358c5161aa467c2438859caa136dec86c26fdd2efe17b92"
-
-[[package]]
-name = "openssl"
-version = "0.10.64"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "95a0481286a310808298130d22dd1fef0fa571e05a8f44ec801801e84b216b1f"
-dependencies = [
- "bitflags 2.5.0",
- "cfg-if",
- "foreign-types",
- "libc",
- "once_cell",
- "openssl-macros",
- "openssl-sys",
-]
-
-[[package]]
-name = "openssl-macros"
-version = "0.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a948666b637a0f465e8564c73e89d4dde00d72d4d473cc972f390fc3dcee7d9c"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.66",
-]
-
-[[package]]
-name = "openssl-probe"
-version = "0.1.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ff011a302c396a5197692431fc1948019154afc178baf7d8e37367442a4601cf"
-
-[[package]]
-name = "openssl-sys"
-version = "0.9.102"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c597637d56fbc83893a35eb0dd04b2b8e7a50c91e64e9493e398b5df4fb45fa2"
-dependencies = [
- "cc",
- "libc",
- "pkg-config",
- "vcpkg",
-]
-
-[[package]]
-name = "percent-encoding"
-version = "2.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
-
-[[package]]
-name = "pin-project-lite"
-version = "0.2.14"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bda66fc9667c18cb2758a2ac84d1167245054bcf85d5d1aaa6923f45801bdd02"
-
-[[package]]
-name = "pin-utils"
-version = "0.1.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"
-
-[[package]]
-name = "pkg-config"
-version = "0.3.30"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d231b230927b5e4ad203db57bbcbee2802f6bce620b1e4a9024a07d94e2907ec"
-
-[[package]]
-name = "powerfmt"
-version = "0.2.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "439ee305def115ba05938db6eb1644ff94165c5ab5e9420d1c1bcedbba909391"
-
-[[package]]
-name = "ppv-lite86"
-version = "0.2.17"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b40af805b3121feab8a3c29f04d8ad262fa8e0561883e7653e024ae4479e6de"
-
-[[package]]
-name = "proc-macro2"
-version = "1.0.85"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "22244ce15aa966053a896d1accb3a6e68469b97c7f33f284b99f0d576879fc23"
-dependencies = [
- "unicode-ident",
-]
-
-[[package]]
-name = "psl-types"
-version = "2.0.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "33cb294fe86a74cbcf50d4445b37da762029549ebeea341421c7c70370f86cac"
-
-[[package]]
-name = "publicsuffix"
-version = "2.2.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96a8c1bda5ae1af7f99a2962e49df150414a43d62404644d98dd5c3a93d07457"
-dependencies = [
- "idna 0.3.0",
- "psl-types",
-]
-
-[[package]]
-name = "quote"
-version = "1.0.36"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0fa76aaf39101c457836aec0ce2316dbdc3ab723cdda1c6bd4e6ad4208acaca7"
-dependencies = [
- "proc-macro2",
-]
-
-[[package]]
-name = "rand"
-version = "0.8.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
-dependencies = [
- "libc",
- "rand_chacha",
- "rand_core",
-]
-
-[[package]]
-name = "rand_chacha"
-version = "0.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
-dependencies = [
- "ppv-lite86",
- "rand_core",
-]
-
-[[package]]
-name = "rand_core"
-version = "0.6.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
-dependencies = [
- "getrandom",
-]
-
-[[package]]
-name = "regex"
-version = "1.10.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c117dbdfde9c8308975b6a18d71f3f385c89461f7b3fb054288ecf2a2058ba4c"
-dependencies = [
- "aho-corasick",
- "memchr",
- "regex-automata",
- "regex-syntax",
-]
-
-[[package]]
-name = "regex-automata"
-version = "0.4.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "86b83b8b9847f9bf95ef68afb0b8e6cdb80f498442f5179a29fad448fcc1eaea"
-dependencies = [
- "aho-corasick",
- "memchr",
- "regex-syntax",
-]
-
-[[package]]
-name = "regex-syntax"
-version = "0.8.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "adad44e29e4c806119491a7f06f03de4d1af22c3a680dd47f1e6e179439d1f56"
-
-[[package]]
-name = "reqwest"
-version = "0.11.27"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dd67538700a17451e7cba03ac727fb961abb7607553461627b97de0b89cf4a62"
-dependencies = [
- "async-compression",
- "base64",
- "bytes",
- "cookie",
- "cookie_store",
- "encoding_rs",
- "futures-core",
- "futures-util",
- "h2",
- "http",
- "http-body",
- "hyper",
- "hyper-tls",
- "ipnet",
- "js-sys",
- "log",
- "mime",
- "native-tls",
- "once_cell",
- "percent-encoding",
- "pin-project-lite",
- "rustls-pemfile",
- "serde",
- "serde_json",
- "serde_urlencoded",
- "sync_wrapper",
- "system-configuration",
- "tokio",
- "tokio-native-tls",
- "tokio-util",
- "tower-service",
- "url",
- "wasm-bindgen",
- "wasm-bindgen-futures",
- "web-sys",
- "winreg",
-]
-
-[[package]]
-name = "rustc-demangle"
-version = "0.1.24"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "719b953e2095829ee67db738b3bfa9fa368c94900df327b3f07fe6e794d2fe1f"
-
-[[package]]
-name = "rustix"
-version = "0.38.34"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "70dc5ec042f7a43c4a73241207cecc9873a06d45debb38b329f8541d85c2730f"
-dependencies = [
- "bitflags 2.5.0",
- "errno",
- "libc",
- "linux-raw-sys",
- "windows-sys 0.52.0",
-]
-
-[[package]]
-name = "rustls-pemfile"
-version = "1.0.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1c74cae0a4cf6ccbbf5f359f08efdf8ee7e1dc532573bf0db71968cb56b1448c"
-dependencies = [
- "base64",
-]
-
-[[package]]
-name = "rustversion"
-version = "1.0.17"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "955d28af4278de8121b7ebeb796b6a45735dc01436d898801014aced2773a3d6"
-
-[[package]]
-name = "ryu"
-version = "1.0.18"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f3cb5ba0dc43242ce17de99c180e96db90b235b8a9fdc9543c96d2209116bd9f"
-
-[[package]]
-name = "schannel"
-version = "0.1.23"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fbc91545643bcf3a0bbb6569265615222618bdf33ce4ffbbd13c4bbd4c093534"
-dependencies = [
- "windows-sys 0.52.0",
-]
-
-[[package]]
-name = "scopeguard"
-version = "1.2.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
-
-[[package]]
-name = "security-framework"
-version = "2.11.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c627723fd09706bacdb5cf41499e95098555af3c3c29d014dc3c458ef6be11c0"
-dependencies = [
- "bitflags 2.5.0",
- "core-foundation",
- "core-foundation-sys",
- "libc",
- "security-framework-sys",
-]
-
-[[package]]
-name = "security-framework-sys"
-version = "2.11.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "317936bbbd05227752583946b9e66d7ce3b489f84e11a94a510b4437fef407d7"
-dependencies = [
- "core-foundation-sys",
- "libc",
-]
-
-[[package]]
-name = "serde"
-version = "1.0.203"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7253ab4de971e72fb7be983802300c30b5a7f0c2e56fab8abfc6a214307c0094"
-dependencies = [
- "serde_derive",
-]
-
-[[package]]
-name = "serde_derive"
-version = "1.0.203"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "500cbc0ebeb6f46627f50f3f5811ccf6bf00643be300b4c3eabc0ef55dc5b5ba"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.66",
-]
-
-[[package]]
-name = "serde_json"
-version = "1.0.117"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "455182ea6142b14f93f4bc5320a2b31c1f266b66a4a5c858b013302a5d8cbfc3"
-dependencies = [
- "itoa",
- "ryu",
- "serde",
-]
-
-[[package]]
-name = "serde_urlencoded"
-version = "0.7.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd"
-dependencies = [
- "form_urlencoded",
- "itoa",
- "ryu",
- "serde",
-]
-
-[[package]]
-name = "sha1"
-version = "0.10.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e3bf829a2d51ab4a5ddf1352d8470c140cadc8301b2ae1789db023f01cedd6ba"
-dependencies = [
- "cfg-if",
- "cpufeatures",
- "digest",
-]
-
-[[package]]
-name = "simplelog"
-version = "0.12.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "16257adbfaef1ee58b1363bdc0664c9b8e1e30aed86049635fb5f147d065a9c0"
-dependencies = [
- "log",
- "termcolor",
- "time",
-]
-
-[[package]]
-name = "slab"
-version = "0.4.9"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f92a496fb766b417c996b9c5e57daf2f7ad3b0bebe1ccfca4856390e3d3bb67"
-dependencies = [
- "autocfg",
-]
-
-[[package]]
-name = "socket2"
-version = "0.5.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ce305eb0b4296696835b71df73eb912e0f1ffd2556a501fcede6e0c50349191c"
-dependencies = [
- "libc",
- "windows-sys 0.52.0",
-]
-
-[[package]]
-name = "spin"
-version = "0.9.8"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6980e8d7511241f8acf4aebddbb1ff938df5eebe98691418c4468d0b72a96a67"
-dependencies = [
- "lock_api",
-]
-
-[[package]]
-name = "strum"
-version = "0.25.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "290d54ea6f91c969195bdbcd7442c8c2a2ba87da8bf60a7ee86a235d4bc1e125"
-
-[[package]]
-name = "strum_macros"
-version = "0.25.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "23dc1fa9ac9c169a78ba62f0b841814b7abae11bdd047b9c58f893439e309ea0"
-dependencies = [
- "heck",
- "proc-macro2",
- "quote",
- "rustversion",
- "syn 2.0.66",
-]
-
-[[package]]
-name = "syn"
-version = "1.0.109"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237"
-dependencies = [
- "proc-macro2",
- "quote",
- "unicode-ident",
-]
-
-[[package]]
-name = "syn"
-version = "2.0.66"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c42f3f41a2de00b01c0aaad383c5a45241efc8b2d1eda5661812fda5f3cdcff5"
-dependencies = [
- "proc-macro2",
- "quote",
- "unicode-ident",
-]
-
-[[package]]
-name = "sync_wrapper"
-version = "0.1.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2047c6ded9c721764247e62cd3b03c09ffc529b2ba5b10ec482ae507a4a70160"
-
-[[package]]
-name = "system-configuration"
-version = "0.5.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ba3a3adc5c275d719af8cb4272ea1c4a6d668a777f37e115f6d11ddbc1c8e0e7"
-dependencies = [
- "bitflags 1.3.2",
- "core-foundation",
- "system-configuration-sys",
-]
-
-[[package]]
-name = "system-configuration-sys"
-version = "0.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a75fb188eb626b924683e3b95e3a48e63551fcfb51949de2f06a9d91dbee93c9"
-dependencies = [
- "core-foundation-sys",
- "libc",
-]
-
-[[package]]
-name = "tempfile"
-version = "3.10.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "85b77fafb263dd9d05cbeac119526425676db3784113aa9295c88498cbf8bff1"
-dependencies = [
- "cfg-if",
- "fastrand",
- "rustix",
- "windows-sys 0.52.0",
-]
-
-[[package]]
-name = "termcolor"
-version = "1.4.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "06794f8f6c5c898b3275aebefa6b8a1cb24cd2c6c79397ab15774837a0bc5755"
-dependencies = [
- "winapi-util",
-]
-
-[[package]]
-name = "thiserror"
-version = "1.0.61"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c546c80d6be4bc6a00c0f01730c08df82eaa7a7a61f11d656526506112cc1709"
-dependencies = [
- "thiserror-impl",
-]
-
-[[package]]
-name = "thiserror-impl"
-version = "1.0.61"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "46c3384250002a6d5af4d114f2845d37b57521033f30d5c3f46c4d70e1197533"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.66",
-]
-
-[[package]]
-name = "time"
-version = "0.3.36"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5dfd88e563464686c916c7e46e623e520ddc6d79fa6641390f2e3fa86e83e885"
-dependencies = [
- "deranged",
- "itoa",
- "libc",
- "num-conv",
- "num_threads",
- "powerfmt",
- "serde",
- "time-core",
- "time-macros",
-]
-
-[[package]]
-name = "time-core"
-version = "0.1.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
-
-[[package]]
-name = "time-macros"
-version = "0.2.18"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3f252a68540fde3a3877aeea552b832b40ab9a69e318efd078774a01ddee1ccf"
-dependencies = [
- "num-conv",
- "time-core",
-]
-
-[[package]]
-name = "tinyvec"
-version = "1.6.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "87cc5ceb3875bb20c2890005a4e226a4651264a5c75edb2421b52861a0a0cb50"
-dependencies = [
- "tinyvec_macros",
-]
-
-[[package]]
-name = "tinyvec_macros"
-version = "0.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"
-
-[[package]]
-name = "tokio"
-version = "1.38.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ba4f4a02a7a80d6f274636f0aa95c7e383b912d41fe721a31f29e29698585a4a"
-dependencies = [
- "backtrace",
- "bytes",
- "libc",
- "mio",
- "num_cpus",
- "pin-project-lite",
- "socket2",
- "tokio-macros",
- "windows-sys 0.48.0",
-]
-
-[[package]]
-name = "tokio-macros"
-version = "2.3.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5f5ae998a069d4b5aba8ee9dad856af7d520c3699e6159b185c2acd48155d39a"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.66",
-]
-
-[[package]]
-name = "tokio-native-tls"
-version = "0.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bbae76ab933c85776efabc971569dd6119c580d8f5d448769dec1764bf796ef2"
-dependencies = [
- "native-tls",
- "tokio",
-]
-
-[[package]]
-name = "tokio-tungstenite"
-version = "0.20.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "212d5dcb2a1ce06d81107c3d0ffa3121fe974b73f068c8282cb1c32328113b6c"
-dependencies = [
- "futures-util",
- "log",
- "tokio",
- "tungstenite",
-]
-
-[[package]]
-name = "tokio-util"
-version = "0.7.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9cf6b47b3771c49ac75ad09a6162f53ad4b8088b76ac60e8ec1455b31a189fe1"
-dependencies = [
- "bytes",
- "futures-core",
- "futures-sink",
- "pin-project-lite",
- "tokio",
-]
-
-[[package]]
-name = "tower-service"
-version = "0.3.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b6bc1c9ce2b5135ac7f93c72918fc37feb872bdc6a5533a8b85eb4b86bfdae52"
-
-[[package]]
-name = "tracing"
-version = "0.1.40"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c3523ab5a71916ccf420eebdf5521fcef02141234bbc0b8a49f2fdc4544364ef"
-dependencies = [
- "pin-project-lite",
- "tracing-core",
-]
-
-[[package]]
-name = "tracing-core"
-version = "0.1.32"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c06d3da6113f116aaee68e4d601191614c9053067f9ab7f6edbcb161237daa54"
-dependencies = [
- "once_cell",
-]
-
-[[package]]
-name = "try-lock"
-version = "0.2.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b"
-
-[[package]]
-name = "tungstenite"
-version = "0.20.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9e3dac10fd62eaf6617d3a904ae222845979aec67c615d1c842b4002c7666fb9"
-dependencies = [
- "byteorder",
- "bytes",
- "data-encoding",
- "http",
- "httparse",
- "log",
- "rand",
- "sha1",
- "thiserror",
- "url",
- "utf-8",
-]
-
-[[package]]
-name = "typenum"
-version = "1.17.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "42ff0bf0c66b8238c6f3b578df37d0b7848e55df8577b3f74f92a69acceeb825"
-
-[[package]]
-name = "unicode-bidi"
-version = "0.3.15"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "08f95100a766bf4f8f28f90d77e0a5461bbdb219042e7679bebe79004fed8d75"
-
-[[package]]
-name = "unicode-ident"
-version = "1.0.12"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3354b9ac3fae1ff6755cb6db53683adb661634f67557942dea4facebec0fee4b"
-
-[[package]]
-name = "unicode-normalization"
-version = "0.1.23"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a56d1686db2308d901306f92a263857ef59ea39678a5458e7cb17f01415101f5"
-dependencies = [
- "tinyvec",
-]
-
-[[package]]
-name = "url"
-version = "2.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "31e6302e3bb753d46e83516cae55ae196fc0c309407cf11ab35cc51a4c2a4633"
-dependencies = [
- "form_urlencoded",
- "idna 0.5.0",
- "percent-encoding",
-]
-
-[[package]]
-name = "utf-8"
-version = "0.7.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "09cc8ee72d2a9becf2f2febe0205bbed8fc6615b7cb429ad062dc7b7ddd036a9"
-
-[[package]]
-name = "vcpkg"
-version = "0.2.15"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "accd4ea62f7bb7a82fe23066fb0957d48ef677f6eeb8215f372f52e48bb32426"
-
-[[package]]
-name = "version_check"
-version = "0.9.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "49874b5167b65d7193b8aba1567f5c7d93d001cafc34600cee003eda787e483f"
-
-[[package]]
-name = "want"
-version = "0.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bfa7760aed19e106de2c7c0b581b509f2f25d3dacaf737cb82ac61bc6d760b0e"
-dependencies = [
- "try-lock",
-]
-
-[[package]]
-name = "wasi"
-version = "0.11.0+wasi-snapshot-preview1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
-
-[[package]]
-name = "wasm-bindgen"
-version = "0.2.92"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4be2531df63900aeb2bca0daaaddec08491ee64ceecbee5076636a3b026795a8"
-dependencies = [
- "cfg-if",
- "wasm-bindgen-macro",
-]
-
-[[package]]
-name = "wasm-bindgen-backend"
-version = "0.2.92"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "614d787b966d3989fa7bb98a654e369c762374fd3213d212cfc0251257e747da"
-dependencies = [
- "bumpalo",
- "log",
- "once_cell",
- "proc-macro2",
- "quote",
- "syn 2.0.66",
- "wasm-bindgen-shared",
-]
-
-[[package]]
-name = "wasm-bindgen-futures"
-version = "0.4.42"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "76bc14366121efc8dbb487ab05bcc9d346b3b5ec0eaa76e46594cabbe51762c0"
-dependencies = [
- "cfg-if",
- "js-sys",
- "wasm-bindgen",
- "web-sys",
-]
-
-[[package]]
-name = "wasm-bindgen-macro"
-version = "0.2.92"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a1f8823de937b71b9460c0c34e25f3da88250760bec0ebac694b49997550d726"
-dependencies = [
- "quote",
- "wasm-bindgen-macro-support",
-]
-
-[[package]]
-name = "wasm-bindgen-macro-support"
-version = "0.2.92"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e94f17b526d0a461a191c78ea52bbce64071ed5c04c9ffe424dcb38f74171bb7"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.66",
- "wasm-bindgen-backend",
- "wasm-bindgen-shared",
-]
-
-[[package]]
-name = "wasm-bindgen-shared"
-version = "0.2.92"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "af190c94f2773fdb3729c55b007a722abb5384da03bc0986df4c289bf5567e96"
-
-[[package]]
-name = "web-sys"
-version = "0.3.69"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "77afa9a11836342370f4817622a2f0f418b134426d91a82dfb48f532d2ec13ef"
-dependencies = [
- "js-sys",
- "wasm-bindgen",
-]
-
-[[package]]
-name = "winapi-util"
-version = "0.1.8"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4d4cc384e1e73b93bafa6fb4f1df8c41695c8a91cf9c4c64358067d15a7b6c6b"
-dependencies = [
- "windows-sys 0.52.0",
-]
-
-[[package]]
-name = "windows-core"
-version = "0.52.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "33ab640c8d7e35bf8ba19b884ba838ceb4fba93a4e8c65a9059d08afcfc683d9"
-dependencies = [
- "windows-targets 0.52.5",
-]
-
-[[package]]
-name = "windows-sys"
-version = "0.48.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "677d2418bec65e3338edb076e806bc1ec15693c5d0104683f2efe857f61056a9"
-dependencies = [
- "windows-targets 0.48.5",
-]
-
-[[package]]
-name = "windows-sys"
-version = "0.52.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
-dependencies = [
- "windows-targets 0.52.5",
-]
-
-[[package]]
-name = "windows-targets"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9a2fa6e2155d7247be68c096456083145c183cbbbc2764150dda45a87197940c"
-dependencies = [
- "windows_aarch64_gnullvm 0.48.5",
- "windows_aarch64_msvc 0.48.5",
- "windows_i686_gnu 0.48.5",
- "windows_i686_msvc 0.48.5",
- "windows_x86_64_gnu 0.48.5",
- "windows_x86_64_gnullvm 0.48.5",
- "windows_x86_64_msvc 0.48.5",
-]
-
-[[package]]
-name = "windows-targets"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6f0713a46559409d202e70e28227288446bf7841d3211583a4b53e3f6d96e7eb"
-dependencies = [
- "windows_aarch64_gnullvm 0.52.5",
- "windows_aarch64_msvc 0.52.5",
- "windows_i686_gnu 0.52.5",
- "windows_i686_gnullvm",
- "windows_i686_msvc 0.52.5",
- "windows_x86_64_gnu 0.52.5",
- "windows_x86_64_gnullvm 0.52.5",
- "windows_x86_64_msvc 0.52.5",
-]
-
-[[package]]
-name = "windows_aarch64_gnullvm"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8"
-
-[[package]]
-name = "windows_aarch64_gnullvm"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7088eed71e8b8dda258ecc8bac5fb1153c5cffaf2578fc8ff5d61e23578d3263"
-
-[[package]]
-name = "windows_aarch64_msvc"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc"
-
-[[package]]
-name = "windows_aarch64_msvc"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9985fd1504e250c615ca5f281c3f7a6da76213ebd5ccc9561496568a2752afb6"
-
-[[package]]
-name = "windows_i686_gnu"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e"
-
-[[package]]
-name = "windows_i686_gnu"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "88ba073cf16d5372720ec942a8ccbf61626074c6d4dd2e745299726ce8b89670"
-
-[[package]]
-name = "windows_i686_gnullvm"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "87f4261229030a858f36b459e748ae97545d6f1ec60e5e0d6a3d32e0dc232ee9"
-
-[[package]]
-name = "windows_i686_msvc"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406"
-
-[[package]]
-name = "windows_i686_msvc"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "db3c2bf3d13d5b658be73463284eaf12830ac9a26a90c717b7f771dfe97487bf"
-
-[[package]]
-name = "windows_x86_64_gnu"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e"
-
-[[package]]
-name = "windows_x86_64_gnu"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4e4246f76bdeff09eb48875a0fd3e2af6aada79d409d33011886d3e1581517d9"
-
-[[package]]
-name = "windows_x86_64_gnullvm"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc"
-
-[[package]]
-name = "windows_x86_64_gnullvm"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "852298e482cd67c356ddd9570386e2862b5673c85bd5f88df9ab6802b334c596"
-
-[[package]]
-name = "windows_x86_64_msvc"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538"
-
-[[package]]
-name = "windows_x86_64_msvc"
-version = "0.52.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bec47e5bfd1bff0eeaf6d8b485cc1074891a197ab4225d504cb7a1ab88b02bf0"
-
-[[package]]
-name = "winreg"
-version = "0.50.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "524e57b2c537c0f9b1e69f1965311ec12182b4122e45035b1508cd24d2adadb1"
-dependencies = [
- "cfg-if",
- "windows-sys 0.48.0",
-]
diff --git a/0.10.0/limitador/limitador-server/sandbox/loadtest/Cargo.toml b/0.10.0/limitador/limitador-server/sandbox/loadtest/Cargo.toml
deleted file mode 100644
index 86103223e..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/loadtest/Cargo.toml
+++ /dev/null
@@ -1,10 +0,0 @@
-[package]
-name = "loadtest"
-version = "0.1.0"
-edition = "2021"
-
-[dependencies]
-goose = "^0.17"
-tokio = "^1.12"
-
-[workspace]
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/sandbox/loadtest/src/main.rs b/0.10.0/limitador/limitador-server/sandbox/loadtest/src/main.rs
deleted file mode 100644
index 41c2bd556..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/loadtest/src/main.rs
+++ /dev/null
@@ -1,26 +0,0 @@
-use goose::prelude::*;
-
-async fn loadtest_get_json(user: &mut GooseUser) -> TransactionResult {
-    let _goose_metrics = user.get("/json").await?;
-
-    Ok(())
-}
-
-#[tokio::main]
-async fn main() -> Result<(), GooseError> {
-    GooseAttack::initialize()?
-        .register_scenario(
-            scenario!("LoadtestTransactions").register_transaction(transaction!(loadtest_get_json)),
-        )
-        .set_default(GooseDefault::Host, "http://localhost:18000")?
-        .set_default(GooseDefault::HatchRate, "2")?
-        .set_default(
-            GooseDefault::CoordinatedOmissionMitigation,
-            GooseCoordinatedOmissionMitigation::Average,
-        )?
-        .set_default(GooseDefault::RunTime, 20)?
-        .execute()
-        .await?;
-
-    Ok(())
-}
diff --git a/0.10.0/limitador/limitador-server/sandbox/redis-otel/index.html b/0.10.0/limitador/limitador-server/sandbox/redis-otel/index.html
deleted file mode 100644
index 8719674df..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/redis-otel/index.html
+++ /dev/null
@@ -1,3437 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/limitador-server/sandbox/redis-otel/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Limitador instrumentation sandbox - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#limitador-instrumentation-sandbox" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Limitador instrumentation sandbox
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#run-sandbox" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run sandbox
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-some-traffic" class="md-nav__link">
-    <span class="md-ellipsis">
-      Run some traffic
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#see-the-trace-in-ui" class="md-nav__link">
-    <span class="md-ellipsis">
-      See the trace in UI
-    </span>
-  </a>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#tear-down-sandbox" class="md-nav__link">
-    <span class="md-ellipsis">
-      Tear down sandbox
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/limitador-server/sandbox/redis-otel/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="limitador-instrumentation-sandbox">Limitador instrumentation sandbox<a class="headerlink" href="#limitador-instrumentation-sandbox" title="Permanent link">&para;</a></h1>
-<p>Limitador is configured to push traces to an <a href="https://opentelemetry.io/docs/collector/">opentelemetry collector</a>.</p>
-<h3 id="run-sandbox">Run sandbox<a class="headerlink" href="#run-sandbox" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>make<span class="w"> </span>build
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>make<span class="w"> </span>deploy-redis-otel
-</span></code></pre></div>
-<h3 id="run-some-traffic">Run some traffic<a class="headerlink" href="#run-some-traffic" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>make<span class="w"> </span>grpcurl
-</span></code></pre></div>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>bin/grpcurl<span class="w"> </span>-plaintext<span class="w"> </span>-d<span class="w"> </span>@<span class="w"> </span><span class="m">127</span>.0.0.1:18081<span class="w"> </span>envoy.service.ratelimit.v3.RateLimitService.ShouldRateLimit<span class="w"> </span><span class="s">&lt;&lt;EOM</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="s">{</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="s">    &quot;domain&quot;: &quot;test_namespace&quot;,</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="s">    &quot;hits_addend&quot;: 1,</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="s">    &quot;descriptors&quot;: [</span>
-</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a><span class="s">        {</span>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="s">            &quot;entries&quot;: [</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="s">                {</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a><span class="s">                    &quot;key&quot;: &quot;req.method&quot;,</span>
-</span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a><span class="s">                    &quot;value&quot;: &quot;POST&quot;</span>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="s">                }</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="s">            ]</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="s">        }</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="s">    ]</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a><span class="s">}</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a><span class="s">EOM</span>
-</span></code></pre></div>
-<h3 id="see-the-trace-in-ui">See the trace in UI<a class="headerlink" href="#see-the-trace-in-ui" title="Permanent link">&para;</a></h3>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>firefox -private-window &quot;localhost:16686&quot;
-</span></code></pre></div>
-<p><img alt="Screenshot 2024-03-21 at 17-08-35 Jaeger UI" src="https://github.com/Kuadrant/limitador/assets/881529/585bb3bf-15e2-49ee-9ed8-423d33fe4df6" /></p>
-<blockquote>
-<p>Recommended to start looking at <code>check_and_update</code> operation.</p>
-</blockquote>
-<h3 id="tear-down-sandbox">Tear down sandbox<a class="headerlink" href="#tear-down-sandbox" title="Permanent link">&para;</a></h3>
-<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>make<span class="w"> </span>clean
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/sandbox/redis-tls/index.html b/0.10.0/limitador/limitador-server/sandbox/redis-tls/index.html
deleted file mode 100644
index deb2a328d..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/redis-tls/index.html
+++ /dev/null
@@ -1,3381 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/limitador-server/sandbox/redis-tls/">
-      
-      
-      
-      
-      <link rel="icon" href="../../../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Index - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#testing-redis-security" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Index
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../../../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../limitador/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#testing-redis-security" class="md-nav__link">
-    <span class="md-ellipsis">
-      Testing redis security
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/limitador-server/sandbox/redis-tls/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-  <h1>Index</h1>
-
-<h3 id="testing-redis-security">Testing  redis security<a class="headerlink" href="#testing-redis-security" title="Permanent link">&para;</a></h3>
-<p>Execute bash shell in redis pod</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>docker compose -p sandbox exec redis /bin/bash
-</span></code></pre></div>
-<p>Connect to this Redis server with redis-cli:</p>
-<div class="language-text highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>root@e024a29b74ba:/data# redis-cli --tls --cacert /usr/local/etc/redis/certs/ca.crt -a foobared
-</span></code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../../../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/limitador/limitador-server/sandbox/redis-tls/redis-config.conf b/0.10.0/limitador/limitador-server/sandbox/redis-tls/redis-config.conf
deleted file mode 100644
index b478e76e6..000000000
--- a/0.10.0/limitador/limitador-server/sandbox/redis-tls/redis-config.conf
+++ /dev/null
@@ -1,7 +0,0 @@
-requirepass foobared
-port 0
-tls-port 6379
-tls-cert-file /usr/local/etc/redis/certs/redis.crt
-tls-key-file /usr/local/etc/redis/certs/redis.key
-tls-ca-cert-file /usr/local/etc/redis/certs/ca.crt
-tls-auth-clients no
diff --git a/0.10.0/limitador/limitador/index.html b/0.10.0/limitador/limitador/index.html
deleted file mode 100644
index f1472bbb8..000000000
--- a/0.10.0/limitador/limitador/index.html
+++ /dev/null
@@ -1,3443 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-      
-      
-        <link rel="canonical" href="https://docs.kuadrant.io/0.10.0/limitador/limitador/">
-      
-      
-        <link rel="prev" href="../limitador-server/sandbox/">
-      
-      
-        <link rel="next" href="../../limitador-operator/">
-      
-      
-      <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.14">
-    
-    
-      
-        <title>Crate - Kuadrant Documentation</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../assets/stylesheets/main.10ba22f1.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../assets/stylesheets/extra.css">
-    
-    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    <body dir="ltr">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#limitador-library" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-          <aside class="md-banner md-banner--warning">
-            <div class="md-banner__inner md-grid md-typeset">
-              
-  These docs are unstable, from our development branches (main).
-  <a href="../../.."> 
-    <strong>Click here to go to latest, stable docs.</strong>
-  </a>
-
-            </div>
-            <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
-          </aside>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../.." title="Kuadrant Documentation" class="md-header__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../assets/images/logo.png" alt="logo">
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Kuadrant Documentation
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Crate
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-    
-      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="Kuadrant Documentation" class="md-nav__button md-logo" aria-label="Kuadrant Documentation" data-md-component="logo">
-      
-  <img src="../../assets/images/logo.png" alt="logo">
-
-    </a>
-    Kuadrant Documentation
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/kuadrant/docs.kuadrant.io" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../.." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Getting Started
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started-single-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Single-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../getting-started-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Multi-Cluster
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/docs/design/architectural-overview-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Installation
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_4">
-            <span class="md-nav__icon md-icon"></span>
-            Installation
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/install/install-kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/install/install-openshift/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Concepts and APIs
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5">
-            <span class="md-nav__icon md-icon"></span>
-            Concepts and APIs
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_1">
-            <span class="md-nav__icon md-icon"></span>
-            DNSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-dns/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway DNS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLSPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_2">
-            <span class="md-nav__icon md-icon"></span>
-            TLSPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/tlspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    AuthPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_3">
-            <span class="md-nav__icon md-icon"></span>
-            AuthPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/auth/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/authpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_5_4">
-            <span class="md-nav__icon md-icon"></span>
-            RateLimitPolicy
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/rate-limiting/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/reference/ratelimitpolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    How-to Guides
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6">
-            <span class="md-nav__icon md-icon"></span>
-            How-to Guides
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/secure-protect-connect/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Secure, connect and protect - OpenShift
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_3" id="__nav_6_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    DNS configuration and load balancing
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_3">
-            <span class="md-nav__icon md-icon"></span>
-            DNS configuration and load balancing
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/dnshealthchecks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Health Checks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../dns-operator/docs/provider/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    DNS Providers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_4" id="__nav_6_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    TLS configuration
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_4">
-            <span class="md-nav__icon md-icon"></span>
-            TLS configuration
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-tls/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Gateway TLS for Cluster Operators
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_5" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_5" id="__nav_6_5_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authentication & Authorization
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_5_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_5">
-            <span class="md-nav__icon md-icon"></span>
-            Authentication & Authorization
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    AuthPolicy for Application Developers and Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/kubernetes-tokenreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with Kubernetes tokens (TokenReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/api-key-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with API keys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/mtls-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication with X.509 certificates and mTLS
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/oidc-jwt-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect Discovery and authentication with JWTs
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/oauth2-token-introspection/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OAuth 2.0 token introspection (RFC 7662)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/passing-credentials/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Passing credentials (`Authorization` header, cookie headers and others)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/http-basic-authentication/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    HTTP "Basic" Authentication (RFC 7235)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/anonymous-access/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Anonymous access
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/token-normalization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Token normalization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Edge Authentication Architecture (EAA)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/external-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Fetching auth metadata from external sources
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/oidc-user-info/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect UserInfo
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/resource-level-authorization-uma/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Resource-level authorization with User-Managed Access (UMA) resource registry
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/json-pattern-matching-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Simple pattern-matching authorization policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/oidc-rbac/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Keycloak
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/opa-authorization/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Open Policy Agent (OPA) Rego policies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/kubernetes-subjectaccessreview/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes RBAC for service authorization (SubjectAccessReview API)
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/keycloak-authorization-services/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorization with Keycloak Authorization Services
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/authzed/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Integration with Authzed/SpiceDB
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/injecting-data/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Injecting data in the request
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Emitting Envoy Dynamic Metadata
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/deny-with-redirect-to-login/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redirecting to a login page
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/envoy-jwt-authn-and-authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reusing Envoy built-in authentication filter result
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/validating-webhook/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Setting up Kuadrant authorization service as a Validating Webhook
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/caching/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Caching
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_6" id="__nav_6_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Rate Limiting
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_6">
-            <span class="md-nav__icon md-icon"></span>
-            Rate Limiting
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RateLimitPolicy for Platform Engineers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting for Application Developers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authenticated Rate Limiting with JWTs and Kubernetes RBAC
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_6_7" id="__nav_6_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Observability
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_6_7">
-            <span class="md-nav__icon md-icon"></span>
-            Observability
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/metrics/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Metrics
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/examples/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Dashboards and Alerts
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/observability/tracing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tracing
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/observability/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authentication and Authorization
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Experimental
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_7">
-            <span class="md-nav__icon md-icon"></span>
-            Experimental
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../api-quickstart/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    API Quickstart
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
-        
-          
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Proposals
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
-            <span class="md-nav__icon md-icon"></span>
-            Proposals
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_8_1" id="__nav_8_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Request For Comments (RFC)
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_8_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8_1">
-            <span class="md-nav__icon md-icon"></span>
-            Request For Comments (RFC)
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0001-rlp-v2/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0001: RateLimitPolicy API "v2"
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0002-well-known-attributes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0002: Well-known Attributes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0003-dns-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0003: DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0004-policy-status/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0004: Policy Status
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0005-single-cluster-dnspolicy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0005: Single Cluster DNSPolicy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0006-kuadrant_sub_components_configurations/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0006: Configuration of Kuadrant Sub Components
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0007-policy-sync-v1/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0007: Policy Sync
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0008-kuadrant-release-process/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0008: Kuadrant Release Process
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0009-defaults-and-overrides/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0009: Defaults & Overrides
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0010-gateway-api-metrics-exporter/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0010: Gateway API Metrics Exporter
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../architecture/rfcs/0011-policy-machinery/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    RFC 0011: Policy Machinery for reconciliation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Components
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9">
-            <span class="md-nav__icon md-icon"></span>
-            Components
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_1" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_1" id="__nav_9_1_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Kuadrant Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_1">
-            <span class="md-nav__icon md-icon"></span>
-            Kuadrant Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrant-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Authorino
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2">
-            <span class="md-nav__icon md-icon"></span>
-            Authorino
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Authorino Operator
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/getting-started/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/hello-world/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Hello World
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/architecture/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Architecture
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/features/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2_7" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_2_7" id="__nav_9_2_7_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Advanced features
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_2_7_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_2_7">
-            <span class="md-nav__icon md-icon"></span>
-            Advanced features
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/host-override/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Host override via context extension
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/user-guides/sharding/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reducing the operational space: sharding, noise and multi-tenancy
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../authorino/docs/contributing/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_9_3" id="__nav_9_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_3_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_9_3">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../doc/how-it-works/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    How it works
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../doc/topologies/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Topologies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_4" id="__nav_9_3_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Server
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_4">
-            <span class="md-nav__icon md-icon"></span>
-            Server
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-server/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-server/kubernetes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Kubernetes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../limitador-server/sandbox/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sandbox
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Crate
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#features" class="md-nav__link">
-    <span class="md-ellipsis">
-      Features
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_3_6" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_3_6" id="__nav_9_3_6_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Limitador Operator
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_9_3_6_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_3_6">
-            <span class="md-nav__icon md-icon"></span>
-            Limitador Operator
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Overview
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/storage/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Storage
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/rate-limit-headers/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Rate limit headers
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/development/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Developer's Guide
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../limitador-operator/doc/logging/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Logging
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_4" >
-        
-          
-          <label class="md-nav__link" for="__nav_9_4" id="__nav_9_4_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    kuadrantctl
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_4_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_9_4">
-            <span class="md-nav__icon md-icon"></span>
-            kuadrantctl
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Getting Started
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-gateway-api-httproute/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Gateway API HTTPRoutes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-kuadrant-auth-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant AuthPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/generate-kuadrant-rate-limit-policy/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Generating Kuadrant RateLimitPolicies
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/kuadrantctl-ci-cd/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    CI/CD with kuadrantctl & Tekton
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/openapi-apicurio/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using Apicurio Studio with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../kuadrantctl/doc/openapi-openshift-dev-spaces/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Using OpenShift Dev Spaces with Kuadrant OAS extensions
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#features" class="md-nav__link">
-    <span class="md-ellipsis">
-      Features
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-  
-    <a href="https://github.com/kuadrant/limitador/blob/main/limitador/README.md" title="Edit this page" class="md-content__button md-icon">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
-    </a>
-  
-  
-
-
-<h1 id="limitador-library">Limitador (library)<a class="headerlink" href="#limitador-library" title="Permanent link">&para;</a></h1>
-<p><a href="https://crates.io/crates/limitador"><img alt="Crates.io" src="https://img.shields.io/crates/v/limitador" /></a>
-<a href="https://docs.rs/limitador"><img alt="docs.rs" src="https://docs.rs/limitador/badge.svg" /></a></p>
-<p>An embeddable rate-limiter library supporting in-memory, Redis and disk data stores.</p>
-<p>For the complete documentation of the crate's API, please refer to <a href="https://docs.rs/limitador/latest/limitador/">docs.rs</a></p>
-<h2 id="features">Features<a class="headerlink" href="#features" title="Permanent link">&para;</a></h2>
-<ul>
-<li><code>redis_storage</code>: support for using Redis as the data storage backend.</li>
-<li><code>disk_storage</code>: support for using RocksDB as a local disk storage backend.</li>
-<li><code>lenient_conditions</code>: support for the deprecated syntax of <code>Condition</code>s</li>
-<li><code>default</code>: <code>redis_storage</code>.</li>
-</ul>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer id="footer" class="footer">
-  <div class="copyright">
-    <p>Copyright <strong><span>The Kuadrant Contributors</span></strong>.</p>
-    <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks.</p> 
-    <p>For a list of TLF trademarks, see <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage</a></p>
-  </div>
-
-  <div class="sponsored-by">
-    <p>
-      <a href="https://www.cncf.io/sandbox-projects/"><img src="../../assets/images/cncf-color.png" class="logo" alt="CNCF logo"></a>
-    </p>
-    <p>
-      We are a Cloud Native Computing Foundation sandbox project.
-    </p>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": ["0.10.0", "latest"], "provider": "mike"}}</script>
-    
-    
-      <script src="../../assets/javascripts/bundle.bd41221c.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/0.10.0/search/search_index.json b/0.10.0/search/search_index.json
deleted file mode 100644
index f7cc1eaad..000000000
--- a/0.10.0/search/search_index.json
+++ /dev/null
@@ -1 +0,0 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Overview","text":"<p>Kuadrant combines Gateway API and Istio-based gateway controllers to enhance application connectivity. It enables platform engineers and application developers to easily connect, secure, and protect their services and infrastructure across multiple clusters with policies for TLS, DNS, application authentication &amp; authorization, and rate limiting. Additionally, Kuadrant offers observability templates to further support infrastructure management.</p>"},{"location":"#getting-started","title":"Getting Started","text":"<p>For a quick local setup of Kuadrant, see our Single Cluster or Multi Cluster guides. Explore the single and multi-cluster architecture in our Architectural Overview.</p>"},{"location":"getting-started-multi-cluster/","title":"Multi-Cluster","text":""},{"location":"getting-started-multi-cluster/#kuadrant-getting-started-multi-cluster","title":"Kuadrant Getting Started - Multi Cluster","text":""},{"location":"getting-started-multi-cluster/#overview","title":"Overview","text":"<p>In this quick start, we will cover the setup of Kuadrant in multiple local kind clusters. This document is intended as a follow on to the single cluster guide. It can be used for adding 1 or more clusters to your local setup.</p>"},{"location":"getting-started-multi-cluster/#prerequisites","title":"Prerequisites","text":"<ul> <li>Completed the Single-cluster Quick Start</li> </ul>"},{"location":"getting-started-multi-cluster/#environmental-variables","title":"Environmental Variables","text":"<p>The same environment variable requirements from the Single-cluster Quick Start apply to this document, including the <code>KUADRANT_REF</code> variable.</p>"},{"location":"getting-started-multi-cluster/#set-up-a-kind-cluster-and-install-kuadrant","title":"Set Up a kind cluster and install Kuadrant","text":"<p>Run the same quickstart script from the single cluster quick start:</p> <pre><code>curl \"https://raw.githubusercontent.com/kuadrant/kuadrant-operator/${KUADRANT_REF}/hack/quickstart-setup.sh\" | bash\n</code></pre> <p>The script will detect if you already have a cluster from the single cluster setup running, and prompt you for a multi cluster setup. This will setup an additional kind cluster, install Istio and install Kuadrant. You can re-run the script multiple times to add more clusters. Each cluster will have a number suffix in the name. For example: <code>kuadrant-local-1</code>, <code>kuadrant-local-2</code>, <code>kuadrant-local-3</code>. The original cluster from the single cluster setup will keep its name of just <code>kuadrant-local</code>.</p>"},{"location":"getting-started-multi-cluster/#clean-up","title":"Clean Up","text":"<p>To ensure that any DNS records are removed, you should remove any <code>DNSPolicy</code> and <code>TLSPolicy</code> resources before deleting the local cluster.</p>"},{"location":"getting-started-multi-cluster/#whats-next","title":"What's Next","text":"<p>The next step is to setup and use the policies provided by Kuadrant. </p> <p>Secure, Protect and Connect your Gateway</p>"},{"location":"getting-started-single-cluster/","title":"Single-Cluster","text":""},{"location":"getting-started-single-cluster/#kuadrant-getting-started-single-cluster","title":"Kuadrant Getting Started - Single Cluster","text":""},{"location":"getting-started-single-cluster/#overview","title":"Overview","text":"<p>In this quick start, we will cover: </p> <ul> <li>setup of Kuadrant in a singe local kind cluster</li> </ul>"},{"location":"getting-started-single-cluster/#prerequisites","title":"Prerequisites","text":"<ul> <li>Docker</li> <li>Kind</li> <li>Kubectl</li> <li>OpenSSL &gt;= 3</li> <li>AWS account with Route 53 enabled or GCP with Cloud DNS enabled</li> <li>Docker Mac Net Connect (macOS users only)</li> </ul>"},{"location":"getting-started-single-cluster/#environmental-variables","title":"Environmental Variables","text":""},{"location":"getting-started-single-cluster/#general","title":"General","text":"Env Var Example Value Description <code>ISTIO_INSTALL_SAIL</code> <code>true</code> Whether to install istio through project sail, default <code>false</code> <p>If you want to make use of the Kuadrant <code>DNSPolicy</code> you should setup the following environmental variables depending on your DNS Provider:</p>"},{"location":"getting-started-single-cluster/#aws","title":"AWS","text":"Env Var Example Value Description <code>KUADRANT_ZONE_ROOT_DOMAIN</code> <code>jbloggs.hcpapps.net</code> Hostname for the root Domain <code>KUADRANT_AWS_DNS_PUBLIC_ZONE_ID</code> <code>Z01234567US0IQE3YLO00</code> AWS Route 53 Zone ID for specified <code>KUADRANT_ZONE_ROOT_DOMAIN</code> <code>KUADRANT_AWS_ACCESS_KEY_ID</code> <code>AKIA1234567890000000</code> Access Key ID, for user with permissions to Route 53 in the account where root domain is created <code>KUADRANT_AWS_SECRET_ACCESS_KEY</code> <code>Z01234567US0000000</code> Access Secret Access Key, for user with permissions to Route 53 in the account where root domain is created <code>KUADRANT_AWS_REGION</code> <code>eu-west-1</code> AWS Region"},{"location":"getting-started-single-cluster/#gcp","title":"GCP","text":"Env Var Example Value Description <code>GOOGLE</code> <code>{\"client_id\": \"00000000-00000000000000.apps.googleusercontent.com\",\"client_secret\": \"d-FL95Q00000000000000\",\"refresh_token\": \"00000aaaaa00000000-AAAAAAAAAAAAKFGJFJDFKDK\",\"type\": \"authorized_user\"}</code> This is the JSON created from either the JSON credentials created by the Google Cloud CLI or a Service account <code>PROJECT_ID</code> <code>my_project_id</code> ID to the google project <code>ZONE_NAME</code> <code>jbloggs-google</code> Zone name <code>ZONE_DNS_NAME</code> <code>jbloggs.google.hcpapps.net</code> DNS name <code>LOG_LEVEL</code> <code>1</code> Log level for the Controller <p>Alternatively, to set defaults, add the above environment variables to your <code>.zshrc</code> or <code>.bash_profile</code>.</p>"},{"location":"getting-started-single-cluster/#set-the-release-you-want-to-use","title":"Set the release you want to use","text":"<pre><code>export KUADRANT_REF=v0.10.0\nexport ISTIO_INSTALL_SAIL=true\n</code></pre>"},{"location":"getting-started-single-cluster/#set-up-a-kind-cluster-and-install-kuadrant","title":"Set Up a kind cluster and install Kuadrant","text":"<p>Run the following:</p> <p><pre><code>curl \"https://raw.githubusercontent.com/kuadrant/kuadrant-operator/${KUADRANT_REF}/hack/quickstart-setup.sh\" | bash\n</code></pre> This will setup a single kind cluster, install Istio and install Kuadrant. Once this completes you should be able to move on to using the various policy apis offered by Kuadrant.</p>"},{"location":"getting-started-single-cluster/#clean-up","title":"Clean Up","text":"<p>To ensure that any DNS records are removed, you should remove any <code>DNSPolicy</code> and <code>TLSPolicy</code> resources before deleting the local cluster.</p>"},{"location":"getting-started-single-cluster/#whats-next","title":"What's Next","text":"<p>The next step is to setup and use the policies provided by Kuadrant. </p> <p>Secure, Protect and Connect your Gateway</p>"},{"location":"kuadrant-operator/","title":"Kuadrant Operator","text":"<p>The Operator to install and manage the lifecycle of the Kuadrant components deployments.</p>"},{"location":"kuadrant-operator/#overview","title":"Overview","text":"<p>Kuadrant is a re-architecture of API Management using Cloud Native concepts and separating the components to be less coupled, more reusable and leverage the underlying kubernetes platform. It aims to deliver a smooth experience to providers and consumers of applications &amp; services when it comes to rate limiting, authentication, authorization, discoverability, change management, usage contracts, insights, etc.</p> <p>Kuadrant aims to produce a set of loosely coupled functionalities built directly on top of Kubernetes. Furthermore, it only strives to provide what Kubernetes doesn\u2019t offer out of the box, i.e. Kuadrant won\u2019t be designing a new Gateway/proxy, instead it will opt to connect with what\u2019s there and what\u2019s being developed (think Envoy, Istio, GatewayAPI).</p> <p>Kuadrant is a system of cloud-native k8s components that grows as users\u2019 needs grow.</p> <ul> <li>From simple protection of a Service (via AuthN) that is used by teammates working on the same cluster, or \u201csibling\u201d services, up to AuthZ of users using OIDC plus custom policies.</li> <li>From no rate-limiting to rate-limiting for global service protection on to rate-limiting by users/plans</li> </ul>"},{"location":"kuadrant-operator/#architecture","title":"Architecture","text":"<p>Kuadrant relies on Istio and the Gateway API to operate the cluster (Istio's) ingress gateway to provide API management with authentication (authN), authorization (authZ) and rate limiting capabilities.</p>"},{"location":"kuadrant-operator/#kuadrant-components","title":"Kuadrant components","text":"CRD Description Control Plane The control plane takes the customer desired configuration (declaratively as kubernetes custom resources) as input and ensures all components are configured to obey customer's desired behavior. This repository contains the source code of the kuadrant control plane Kuadrant Operator A Kubernetes Operator to manage the lifecycle of the kuadrant deployment Authorino The AuthN/AuthZ enforcer. As the external istio authorizer (envoy external authorization serving gRPC service) Limitador The external rate limiting service. It exposes a gRPC service implementing the Envoy Rate Limit protocol (v3) Authorino Operator A Kubernetes Operator to manage Authorino instances Limitador Operator A Kubernetes Operator to manage Limitador instances DNS Operator A Kubernetes Operator to manage DNS records in external providers"},{"location":"kuadrant-operator/#provided-apis","title":"Provided APIs","text":"<p>The kuadrant control plane owns the following Custom Resource Definitions, CRDs:</p> CRD Description Example AuthPolicy CRD [doc] [reference] Enable AuthN and AuthZ based access control on workloads AuthPolicy CR RateLimitPolicy CRD [doc] [reference] Enable access control on workloads based on HTTP rate limiting RateLimitPolicy CR DNSPolicy CRD [doc] [reference] Enable DNS management DNSPolicy CR TLSPolicy CRD [doc] [reference] Enable TLS management TLSPolicy CR <p>Additionally, Kuadrant provides the following CRDs</p> CRD Owner Description Example Kuadrant CRD Kuadrant Operator Represents an instance of kuadrant Kuadrant CR Limitador CRD Limitador Operator Represents an instance of Limitador Limitador CR Authorino CRD Authorino Operator Represents an instance of Authorino Authorino CR <p></p>"},{"location":"kuadrant-operator/#getting-started","title":"Getting started","text":""},{"location":"kuadrant-operator/#pre-requisites","title":"Pre-requisites","text":"<ul> <li>Istio is installed in the cluster. Otherwise, refer to the   Istio getting started guide.</li> <li>Kubernetes Gateway API is installed in the cluster. Otherwise,   configure Istio to expose a service using the Kubernetes Gateway API.</li> <li>cert-manager is installed in the cluster. Otherwise, refer to the    cert-manager installation guide.</li> </ul>"},{"location":"kuadrant-operator/#installing-kuadrant","title":"Installing Kuadrant","text":"<p>Installing Kuadrant is a two-step procedure. Firstly, install the Kuadrant Operator and secondly, request a Kuadrant instance by creating a Kuadrant custom resource.</p>"},{"location":"kuadrant-operator/#1-install-the-kuadrant-operator","title":"1. Install the Kuadrant Operator","text":"<p>The Kuadrant Operator is available in public community operator catalogs, such as the Kubernetes OperatorHub.io and the Openshift Container Platform and OKD OperatorHub.</p> <p>Kubernetes</p> <p>The operator is available from OperatorHub.io. Just go to the linked page and follow installation steps (or just run these two commands):</p> <pre><code># Install Operator Lifecycle Manager (OLM), a tool to help manage the operators running on your cluster.\n\ncurl -sL https://github.com/operator-framework/operator-lifecycle-manager/releases/download/v0.23.1/install.sh | bash -s v0.23.1\n\n# Install the operator by running the following command:\n\nkubectl create -f https://operatorhub.io/install/kuadrant-operator.yaml\n</code></pre> <p>Openshift</p> <p>The operator is available from the Openshift Console OperatorHub. Just follow installation steps choosing the \"Kuadrant Operator\" from the catalog:</p> <p></p>"},{"location":"kuadrant-operator/#2-request-a-kuadrant-instance","title":"2. Request a Kuadrant instance","text":"<p>Create the namespace:</p> <pre><code>kubectl create namespace kuadrant\n</code></pre> <p>Apply the <code>Kuadrant</code> custom resource:</p> <pre><code>kubectl -n kuadrant apply -f - &lt;&lt;EOF\n---\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant-sample\nspec: {}\nEOF\n</code></pre>"},{"location":"kuadrant-operator/#protect-your-service","title":"Protect your service","text":""},{"location":"kuadrant-operator/#if-you-are-an-api-provider","title":"If you are an API Provider","text":"<ul> <li>Deploy the service/API to be protected (\"Upstream\")</li> <li>Expose the service/API using the kubernetes Gateway API, ie   HTTPRoute object.</li> <li>Write and apply the Kuadrant's RateLimitPolicy and/or   AuthPolicy custom resources targeting the HTTPRoute resource   to have your API protected.</li> </ul>"},{"location":"kuadrant-operator/#if-you-are-a-cluster-operator","title":"If you are a Cluster Operator","text":"<ul> <li>(Optionally) deploy istio ingress gateway using the   Gateway resource.</li> <li>Write and apply the Kuadrant's RateLimitPolicy and/or   AuthPolicy custom resources targeting the Gateway resource   to have your gateway traffic protected.</li> </ul>"},{"location":"kuadrant-operator/#user-guides","title":"User guides","text":"<p>The user guides section of the docs gathers several use-cases as well as the instructions to implement them using kuadrant.</p> <ul> <li>Simple Rate Limiting for Application Developers</li> <li>Authenticated Rate Limiting for Application Developers</li> <li>Gateway Rate Limiting for Cluster Operators</li> <li>Authenticated Rate Limiting with JWTs and Kubernetes RBAC</li> </ul>"},{"location":"kuadrant-operator/#kuadrant-rate-limiting","title":"Kuadrant Rate Limiting","text":""},{"location":"kuadrant-operator/#documentation","title":"Documentation","text":"<p>Docs can be found on the Kuadrant website.</p>"},{"location":"kuadrant-operator/#contributing","title":"Contributing","text":"<p>The Development guide describes how to build the kuadrant operator and how to test your changes before submitting a patch or opening a PR.</p> <p>Join us on the #kuadrant channel in the Kubernetes Slack workspace, for live discussions about the roadmap and more.</p>"},{"location":"kuadrant-operator/#licensing","title":"Licensing","text":"<p>This software is licensed under the Apache 2.0 license.</p> <p>See the LICENSE and NOTICE files that should have been provided along with this software for details.</p> <p></p>"},{"location":"kuadrant-operator/doc/auth/","title":"Kuadrant Auth","text":"<p>A Kuadrant AuthPolicy custom resource:</p> <ol> <li>Targets Gateway API networking resources such as HTTPRoutes and Gateways, using these resources to obtain additional context, i.e., which traffic workload (HTTP attributes, hostnames, user attributes, etc) to enforce auth.</li> <li>Supports targeting subsets (sections) of a network resource to apply the auth rules to.</li> <li>Abstracts the details of the underlying external authorization protocol and configuration resources, that have a much broader remit and surface area.</li> <li>Enables cluster operators to set defaults that govern behavior at the lower levels of the network, until a more specific policy is applied.</li> </ol>"},{"location":"kuadrant-operator/doc/auth/#how-it-works","title":"How it works","text":""},{"location":"kuadrant-operator/doc/auth/#envoys-external-authorization-protocol","title":"Envoy's External Authorization Protocol","text":"<p>Kuadrant's Auth implementation relies on the Envoy's External Authorization protocol. The workflow per request goes:</p> <ol> <li>On incoming request, the gateway checks the matching rules for enforcing the auth rules, as stated in the AuthPolicy custom resources and targeted Gateway API networking objects</li> <li>If the request matches, the gateway sends one CheckRequest to the external auth service (\"Authorino\").</li> <li>The external auth service responds with a CheckResponse back to the gateway with either an <code>OK</code> or <code>DENIED</code> response code.</li> </ol> <p>An AuthPolicy and its targeted Gateway API networking resource contain all the statements to configure both the ingress gateway and the external auth service.</p>"},{"location":"kuadrant-operator/doc/auth/#the-authpolicy-custom-resource","title":"The AuthPolicy custom resource","text":""},{"location":"kuadrant-operator/doc/auth/#overview","title":"Overview","text":"<p>The <code>AuthPolicy</code> spec includes the following parts:</p> <ul> <li>A reference to an existing Gateway API resource (<code>spec.targetRef</code>)</li> <li>Authentication/authorization scheme (<code>spec.rules</code>)</li> <li>Top-level route selectors (<code>spec.routeSelectors</code>)</li> <li>Top-level additional conditions (<code>spec.when</code>)</li> <li>List of named patterns (<code>spec.patterns</code>)</li> </ul> <p>The auth scheme specify rules for:</p> <ul> <li>Authentication (<code>spec.rules.authentication</code>)</li> <li>External auth metadata fetching (<code>spec.rules.metadata</code>)</li> <li>Authorization (<code>spec.rules.authorization</code>)</li> <li>Custom response items (<code>spec.rules.response</code>)</li> <li>Callbacks (<code>spec.rules.callbacks</code>)</li> </ul> <p>Each auth rule can declare specific <code>routeSelectors</code> and <code>when</code> conditions for the rule to apply.</p> <p>The auth scheme (<code>rules</code>), as well as conditions and named patterns can be declared at the top-level level of the spec (with the semantics of defaults) or alternatively within explicit <code>defaults</code> or <code>overrides</code> blocks.</p>"},{"location":"kuadrant-operator/doc/auth/#high-level-example-and-field-definition","title":"High-level example and field definition","text":"<pre><code>apiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: my-auth-policy\nspec:\n  # Reference to an existing networking resource to attach the policy to. REQUIRED.\n  # It can be a Gateway API HTTPRoute or Gateway resource.\n  # It can only refer to objects in the same namespace as the AuthPolicy.\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute / Gateway\n    name: myroute / mygateway\n\n  # Selectors of HTTPRouteRules within the targeted HTTPRoute that activate the AuthPolicy.\n  # Each element contains a HTTPRouteMatch object that will be used to select HTTPRouteRules that include at least\n  # one identical HTTPRouteMatch.\n  # The HTTPRouteMatch part does not have to be fully identical, but the what's stated in the selector must be\n  # identically stated in the HTTPRouteRule.\n  # Do not use it on AuthPolicies that target a Gateway.\n  routeSelectors:\n\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/admin\"\n\n  # Additional dynamic conditions to trigger the AuthPolicy.\n  # Use it for filtering attributes not supported by HTTPRouteRule or with AuthPolicies that target a Gateway.\n  # Check out https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md to learn more\n  # about the Well-known Attributes that can be used in this field.\n  # Equivalent to if otherwise declared within `defaults`.\n  when: [\u2026]\n\n  # Sets of common patterns of selector-operator-value triples, to be referred by name in `when` conditions\n  # and pattern-matching rules. Often employed to avoid repetition in the policy.\n  # Equivalent to if otherwise declared within `defaults`.\n  patterns: {\u2026}\n\n  # The auth rules to apply to the network traffic routed through the targeted resource.\n  # Equivalent to if otherwise declared within `defaults`.\n  rules:\n    # Authentication rules to enforce.\n    # At least one config must evaluate to a valid identity object for the auth request to be successful.\n    # If omitted or empty, anonymous access is assumed.\n    authentication:\n      \"my-authn-rule\":\n        # The authentication method of this rule.\n        # One-of: apiKey, jwt, oauth2Introspection, kubernetesTokenReview, x509, plain, anonymous.\n        apiKey: {\u2026}\n\n        # Where credentials are required to be passed in the request for authentication based on this rule.\n        # One-of: authorizationHeader, customHeader, queryString, cookie.\n        credentials:\n          authorizationHeader:\n            prefix: APIKEY\n\n        # Rule-level route selectors.\n        routeSelectors: [\u2026]\n\n        # Rule-level additional conditions.\n        when: [\u2026]\n\n        # Configs for caching the resolved object returned out of evaluating this auth rule.\n        cache: {\u2026}\n\n    # Rules for fetching auth metadata from external sources.\n    metadata:\n      \"my-external-source\":\n        # The method for fetching metadata from the external source.\n        # One-of: http: userInfo, uma.\n        http: {\u2026}\n\n    # Authorization rules to enforce.\n    # All policies must allow access for the auth request be successful.\n    authorization:\n      \"my-authz-rule\":\n        # The authorization method of this rule.\n        # One-of: patternMatching, opa, kubernetesSubjectAccessReview, spicedb.\n        opa: {\u2026}\n\n    # Customizations to the authorization response.\n    response:\n      # Custom denial status and other HTTP attributes for unauthenticated requests.\n      unauthenticated: {\u2026}\n\n      # Custom denial status and other HTTP attributes for unauhtorized requests.\n      unauthorized: {\u2026}\n\n      # Custom response items when access is granted.\n      success:\n        # Custom response items wrapped as HTTP headers to be injected in the request\n        headers:\n          \"my-custom-header\":\n            # One-of: plain, json, wristband.\n            plain: {\u2026}\n\n        # Custom response items wrapped as envoy dynamic metadata.\n        dynamicMetadata:\n          # One-of: plain, json, wristband.\n          \"my-custom-dyn-metadata\":\n            json: {\u2026}\n\n    # Rules for post-authorization callback requests to external services.\n    # Triggered regardless of the result of the authorization request.\n    callbacks:\n      \"my-webhook\":\n        http: {\u2026}\n\n    # Explicit defaults. Used in policies that target a Gateway object to express default rules to be enforced on\n    # routes that lack a more specific policy attached to.\n    # Mutually exclusive with `overrides` and with declaring the `rules`, `when` and `patterns` at the top-level of\n    # the spec.\n    defaults:\n      rules:\n        authentication: {\u2026}\n        metadata: {\u2026}\n        authorization: {\u2026}\n        response: {\u2026}\n        callbacks: {\u2026}\n      when: [\u2026]\n      patterns: {\u2026}\n\n    # Overrides. Used in policies that target a Gateway object to be enforced on all routes linked to the gateway,\n    # thus also overriding any more specific policy occasionally attached to any of those routes.\n    # Mutually exclusive with `defaults` and with declaring `rules`, `when` and `patterns` at the top-level of\n    # the spec.\n    overrides:\n      rules:\n        authentication: {\u2026}\n        metadata: {\u2026}\n        authorization: {\u2026}\n        response: {\u2026}\n        callbacks: {\u2026}\n      when: [\u2026]\n      patterns: {\u2026}\n</code></pre> <p>Check out the API reference for a full specification of the AuthPolicy CRD.</p>"},{"location":"kuadrant-operator/doc/auth/#using-the-authpolicy","title":"Using the AuthPolicy","text":""},{"location":"kuadrant-operator/doc/auth/#targeting-a-httproute-networking-resource","title":"Targeting a HTTPRoute networking resource","text":"<p>When an AuthPolicy targets a HTTPRoute, the policy is enforced to all traffic routed according to the rules and hostnames specified in the HTTPRoute, across all Gateways referenced in the <code>spec.parentRefs</code> field of the HTTPRoute.</p> <p>The targeted HTTPRoute's rules and/or hostnames to which the policy must be enforced can be filtered to specific subsets, by specifying the <code>routeSelectors</code> field of the AuthPolicy spec.</p> <p>Target a HTTPRoute by setting the <code>spec.targetRef</code> field of the AuthPolicy as follows:</p> <pre><code>apiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: my-route-auth\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: &lt;HTTPRoute Name&gt;\n  rules: {\u2026}\n</code></pre> <pre><code>\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510             \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 (Infra namespace) \u2502             \u2502   (App namespace)  \u2502\n\u2502                   \u2502             \u2502                    \u2502\n\u2502  \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510      \u2502  parentRefs \u2502  \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u2502\n\u2502  \u2502 Gateway \u2502\u25c4\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2524 HTTPRoute \u2502     \u2502\n\u2502  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518      \u2502             \u2502  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2502\n\u2502                   \u2502             \u2502        \u25b2           \u2502\n\u2502                   \u2502             \u2502        \u2502           \u2502\n\u2502                   \u2502             \u2502        \u2502           \u2502\n\u2502                   \u2502             \u2502        \u2502 targetRef \u2502\n\u2502                   \u2502             \u2502        \u2502           \u2502\n\u2502                   \u2502             \u2502  \u250c\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2510    \u2502\n\u2502                   \u2502             \u2502  \u2502 AuthPolicy \u2502    \u2502\n\u2502                   \u2502             \u2502  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518    \u2502\n\u2502                   \u2502             \u2502                    \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518             \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre>"},{"location":"kuadrant-operator/doc/auth/#hostnames-and-wildcards","title":"Hostnames and wildcards","text":"<p>If an AuthPolicy targets a route defined for <code>*.com</code> and another AuthPolicy targets another route for <code>api.com</code>, the Kuadrant control plane will not merge these two AuthPolicies. Rather, it will mimic the behavior of gateway implementation by which the \"most specific hostname wins\", thus enforcing only the corresponding applicable policies and auth rules.</p> <p>E.g., a request coming for <code>api.com</code> will be protected according to the rules from the AuthPolicy that targets the route for <code>api.com</code>; while a request for <code>other.com</code> will be protected with the rules from the AuthPolicy targeting the route for <code>*.com</code>.</p> <p>Example with 3 AuthPolicies and 3 HTTPRoutes:</p> <ul> <li>AuthPolicy A \u2192 HTTPRoute A (<code>a.toystore.com</code>)</li> <li>AuthPolicy B \u2192 HTTPRoute B (<code>b.toystore.com</code>)</li> <li>AuthPolicy W \u2192 HTTPRoute W (<code>*.toystore.com</code>)</li> </ul> <p>Expected behavior:</p> <ul> <li>Request to <code>a.toystore.com</code> \u2192 AuthPolicy A will be enforced</li> <li>Request to <code>b.toystore.com</code> \u2192 AuthPolicy B will be enforced</li> <li>Request to <code>other.toystore.com</code> \u2192 AuthPolicy W will be enforced</li> </ul>"},{"location":"kuadrant-operator/doc/auth/#targeting-a-gateway-networking-resource","title":"Targeting a Gateway networking resource","text":"<p>An AuthPolicy that targets a Gateway can declare a block of defaults (<code>spec.defaults</code>) or a block of overrides (<code>spec.overrides</code>). As a standard, gateway policies that do not specify neither defaults nor overrides, act as defaults.</p> <p>When declaring defaults, an AuthPolicy which targets a Gateway will be enforced to all HTTP traffic hitting the gateway, unless a more specific AuthPolicy targeting a matching HTTPRoute exists. Any new HTTPRoute referrencing the gateway as parent will be automatically covered by the default AuthPolicy, as well as changes in the existing HTTPRoutes.</p> <p>Defaults provide cluster operators with the ability to protect the infrastructure against unplanned and malicious network traffic attempt, such as by setting preemptive \"deny-all\" policies on hostnames and hostname wildcards.</p> <p>Inversely, a gateway policy that specify overrides declares a set of rules to be enforced on all routes attached to the gateway, thus atomically replacing any more specific policy occasionally attached to any of those routes.</p> <p>Target a Gateway HTTPRoute by setting the <code>spec.targetRef</code> field of the AuthPolicy as follows:</p> <pre><code>apiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: my-gw-auth\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: &lt;Gateway Name&gt;\n  defaults: # alternatively: `overrides`\n    rules: {\u2026}\n</code></pre> <pre><code>\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510             \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 (Infra namespace) \u2502             \u2502   (App namespace)  \u2502\n\u2502                   \u2502             \u2502                    \u2502\n\u2502  \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510      \u2502  parentRefs \u2502  \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u2502\n\u2502  \u2502 Gateway \u2502\u25c4\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2524 HTTPRoute \u2502     \u2502\n\u2502  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518      \u2502             \u2502  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2502\n\u2502       \u25b2           \u2502             \u2502        \u25b2           \u2502\n\u2502       \u2502           \u2502             \u2502        \u2502           \u2502\n\u2502       \u2502           \u2502             \u2502        \u2502           \u2502\n\u2502       \u2502 targetRef \u2502             \u2502        \u2502 targetRef \u2502\n\u2502       \u2502           \u2502             \u2502        \u2502           \u2502\n\u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2510    \u2502             \u2502  \u250c\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2510    \u2502\n\u2502 \u2502 AuthPolicy \u2502    \u2502             \u2502  \u2502 AuthPolicy \u2502    \u2502\n\u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518    \u2502             \u2502  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518    \u2502\n\u2502                   \u2502             \u2502                    \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518             \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre>"},{"location":"kuadrant-operator/doc/auth/#overlapping-gateway-and-httproute-authpolicies","title":"Overlapping Gateway and HTTPRoute AuthPolicies","text":"<p>Two possible semantics are to be considered here \u2013 gateway policy defaults vs gateway policy overrides.</p> <p>Gateway AuthPolicies that declare defaults (or alternatively neither defaults nor overrides) protect all traffic routed through the gateway except where a more specific HTTPRoute AuthPolicy exists, in which case the HTTPRoute AuthPolicy prevails.</p> <p>Example with 4 AuthPolicies, 3 HTTPRoutes and 1 Gateway default (plus 2 HTTPRoute and 2 Gateways without AuthPolicies attached):</p> <ul> <li>AuthPolicy A \u2192 HTTPRoute A (<code>a.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>AuthPolicy B \u2192 HTTPRoute B (<code>b.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>AuthPolicy W \u2192 HTTPRoute W (<code>*.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>AuthPolicy G (defaults) \u2192 Gateway G (<code>*.com</code>)</li> </ul> <p>Expected behavior:</p> <ul> <li>Request to <code>a.toystore.com</code> \u2192 AuthPolicy A will be enforced</li> <li>Request to <code>b.toystore.com</code> \u2192 AuthPolicy B will be enforced</li> <li>Request to <code>other.toystore.com</code> \u2192 AuthPolicy W will be enforced</li> <li>Request to <code>other.com</code> (suppose a route exists) \u2192 AuthPolicy G will be enforced</li> <li>Request to <code>yet-another.net</code> (suppose a route and gateway exist) \u2192 No AuthPolicy will be enforced</li> </ul> <p>Gateway AuthPolicies that declare overrides protect all traffic routed through the gateway, regardless of existence of any more specific HTTPRoute AuthPolicy.</p> <p>Example with 4 AuthPolicies, 3 HTTPRoutes and 1 Gateway override (plus 2 HTTPRoute and 2 Gateways without AuthPolicies attached):</p> <ul> <li>AuthPolicy A \u2192 HTTPRoute A (<code>a.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>AuthPolicy B \u2192 HTTPRoute B (<code>b.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>AuthPolicy W \u2192 HTTPRoute W (<code>*.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>AuthPolicy G (overrides) \u2192 Gateway G (<code>*.com</code>)</li> </ul> <p>Expected behavior:</p> <ul> <li>Request to <code>a.toystore.com</code> \u2192 AuthPolicy G will be enforced</li> <li>Request to <code>b.toystore.com</code> \u2192 AuthPolicy G will be enforced</li> <li>Request to <code>other.toystore.com</code> \u2192 AuthPolicy G will be enforced</li> <li>Request to <code>other.com</code> (suppose a route exists) \u2192 AuthPolicy G will be enforced</li> <li>Request to <code>yet-another.net</code> (suppose a route and gateway exist) \u2192 No AuthPolicy will be enforced</li> </ul>"},{"location":"kuadrant-operator/doc/auth/#route-selectors","title":"Route selectors","text":"<p>Route selectors allow targeting sections of a HTTPRoute, by specifying sets of HTTPRouteMatches and/or hostnames that make the policy controller look up within the HTTPRoute spec for compatible declarations, and select the corresponding HTTPRouteRules and hostnames, to then build conditions that activate the policy or policy rule.</p> <p>Check out Route selectors for a full description, semantics and API reference.</p>"},{"location":"kuadrant-operator/doc/auth/#when-conditions","title":"<code>when</code> conditions","text":"<p><code>when</code> conditions can be used to scope an AuthPolicy or auth rule within an AuthPolicy (i.e. to filter the traffic to which a policy or policy rule applies) without any coupling to the underlying network topology, i.e. without making direct references to HTTPRouteRules via <code>routeSelectors</code>.</p> <p>Use <code>when</code> conditions to conditionally activate policies and policy rules based on attributes that cannot be expressed in the HTTPRoutes' <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or in general in AuthPolicies that target a Gateway.</p> <p><code>when</code> conditions in an AuthPolicy are compatible with Authorino conditions, thus supporting complex boolean expressions with AND and OR operators, as well as grouping.</p> <p>The selectors within the <code>when</code> conditions of an AuthPolicy are a subset of Kuadrant's Well-known Attributes (RFC 0002). Check out the reference for the full list of supported selectors.</p> <p>Authorino JSON path string modifiers can also be applied to the selectors within the <code>when</code> conditions of an AuthPolicy.</p>"},{"location":"kuadrant-operator/doc/auth/#examples","title":"Examples","text":"<p>Check out the following user guides for examples of protecting services with Kuadrant:</p> <ul> <li>Enforcing authentication &amp; authorization with Kuadrant AuthPolicy, for app developers and platform engineers</li> <li>Authenticated Rate Limiting for Application Developers</li> <li>Authenticated Rate Limiting with JWTs and Kubernetes RBAC</li> </ul>"},{"location":"kuadrant-operator/doc/auth/#known-limitations","title":"Known limitations","text":"<ul> <li>One HTTPRoute can only be targeted by one AuthPolicy.</li> <li>One Gateway can only be targeted by one AuthPolicy.</li> <li>AuthPolicies can only target HTTPRoutes/Gateways defined within the same namespace of the AuthPolicy.</li> <li>2+ AuthPolicies cannot target network resources that define/inherit the same exact hostname.</li> </ul>"},{"location":"kuadrant-operator/doc/auth/#limitation-multiple-network-resources-with-identical-hostnames","title":"Limitation: Multiple network resources with identical hostnames","text":"<p>Kuadrant currently does not support multiple AuthPolicies simultaneously targeting network resources that declare identical hostnames. This includes multiple HTTPRoutes that specify the same hostnames in the <code>spec.hostnames</code> field, as well as HTTPRoutes that specify a hostname that is identical to a hostname specified in a listener of one of the route's parent gateways or HTTPRoutes that don't specify any hostname at all thus inheriting the hostnames from the parent gateways. In any of these cases, a maximum of one AuthPolicy targeting any of those resources that specify identical hostnames is allowed.</p> <p>Moreover, having multiple resources that declare identical hostnames may lead to unexpected behavior and therefore should be avoided.</p> <p>This limitation is rooted at the underlying components configured by Kuadrant for the implementation of its policies and the lack of information in the data plane regarding the exact route that is honored by the API gateway at each specific request, in cases of conflicting hostnames.</p> <p>To exemplify one way this limitation can impact deployments, consider the following topology:</p> <pre><code>                 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                 \u2502   Gateway    \u2502\n                 \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n          \u250c\u2500\u2500\u2500\u2500\u2500\u25ba\u2502 listeners:   \u2502\u25c4\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n          \u2502      \u2502 - host: *.io \u2502       \u2502\n          \u2502      \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518       \u2502\n          \u2502                             \u2502\n          \u2502                             \u2502\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510        \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502     HTTPRoute     \u2502        \u2502     HTTPRoute     \u2502\n\u2502     (route-a)     \u2502        \u2502     (route-b)     \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524        \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 hostnames:        \u2502        \u2502 hostnames:        \u2502\n\u2502 - app.io          \u2502        \u2502 - app.io          \u2502\n\u2502 rules:            \u2502        \u2502 rules:            \u2502\n\u2502 - matches:        \u2502        \u2502 - matches:        \u2502\n\u2502   - path:         \u2502        \u2502   - path:         \u2502\n\u2502       value: /foo \u2502        \u2502       value: /bar \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518        \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n          \u25b2                            \u25b2\n          \u2502                            \u2502\n    \u250c\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2510               \u250c\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 AuthPolicy \u2502               \u2502 AuthPolicy \u2502\n    \u2502 (policy-1) \u2502               \u2502 (policy-2) \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518               \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre> <p>In the example above, with the <code>policy-1</code> resource created before <code>policy-2</code>, <code>policy-1</code> will be enforced on all requests to <code>app.io/foo</code> while <code>policy-2</code> will be rejected. I.e. <code>app.io/bar</code> will not be secured. In fact, the status conditions of <code>policy-2</code> shall reflect <code>Enforced=false</code> with message \"AuthPolicy has encountered some issues: AuthScheme is not ready yet\".</p> <p>Notice the enforcement of <code>policy-1</code> and no enforcement of <code>policy-2</code> is the opposite behavior as the analogous problem with the Kuadrant RateLimitPolicy.</p> <p>A slightly different way the limitation applies is when two or more routes of a gateway declare the exact same hostname and a gateway policy is defined with expectation to set default rules for the cases not covered by more specific policies. E.g.:</p> <pre><code>                                    \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                         \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524 AuthPolicy \u2502\n                         \u2502          \u2502 (policy-2) \u2502\n                         \u25bc          \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                 \u2502   Gateway    \u2502\n                 \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n          \u250c\u2500\u2500\u2500\u2500\u2500\u25ba\u2502 listeners:   \u2502\u25c4\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n          \u2502      \u2502 - host: *.io \u2502       \u2502\n          \u2502      \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518       \u2502\n          \u2502                             \u2502\n          \u2502                             \u2502\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510        \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502     HTTPRoute     \u2502        \u2502     HTTPRoute     \u2502\n\u2502     (route-a)     \u2502        \u2502     (route-b)     \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524        \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 hostnames:        \u2502        \u2502 hostnames:        \u2502\n\u2502 - app.io          \u2502        \u2502 - app.io          \u2502\n\u2502 rules:            \u2502        \u2502 rules:            \u2502\n\u2502 - matches:        \u2502        \u2502 - matches:        \u2502\n\u2502   - path:         \u2502        \u2502   - path:         \u2502\n\u2502       value: /foo \u2502        \u2502       value: /bar \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518        \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n          \u25b2\n          \u2502\n    \u250c\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 AuthPolicy \u2502\n    \u2502 (policy-1) \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre> <p>Once again, requests to <code>app.io/foo</code> will be protected under AuthPolicy <code>policy-1</code>, while requests to <code>app.io/bar</code> will not be protected under any policy at all, unlike expected gateway policy <code>policy-2</code> enforced as default. Both policies will report status condition as <code>Enforced</code> nonetheless.</p> <p>To avoid these problems, use different hostnames in each route.</p>"},{"location":"kuadrant-operator/doc/auth/#implementation-details","title":"Implementation details","text":"<p>Under the hood, for each AuthPolicy, Kuadrant creates an Istio <code>AuthorizationPolicy</code> and an Authorino <code>AuthConfig</code> custom resources.</p> <p>Only requests that matches the rules in the Istio <code>AuthorizationPolicy</code> cause an authorization request to be sent to the external authorization service (\"Authorino\"), i.e., only requests directed to the HTTPRouteRules targeted by the AuthPolicy (directly or indirectly), according to the declared top-level route selectors (if present), or all requests for which a matching HTTPRouteRule exists (otherwise).</p> <p>Authorino looks up for the auth scheme (<code>AuthConfig</code> custom resource) to enforce using the provided hostname of the original request as key. It then checks again if the request matches at least one of the selected HTTPRouteRules, in which case it enforces the auth scheme.</p> Exception to the rule    Due to limitations imposed by the Istio `AuthorizationPolicy`, there are a few patterns of HTTPRouteRules that cannot be translated to filters for the external authorization request. Therefore, the following patterns used in HTTPRouteMatches of top-level route selectors of an AuthPolicy will not be included in the Istio AuthorizationPolicy rules that trigger the check request with Authorino: `PathMatchRegularExpression`, `HeaderMatchRegularExpression`, and `HTTPQueryParamMatch`.    As a consequence to the above, requests that do not match these rules and otherwise would not be checked with Authorino will result in a request to the external authorization service. Authorino nonetheless will still verify those patterns and ensure the auth scheme is enforced only when it matches a selected HTTPRouteRule. Users of Kuadrant may observe an unnecessary call to the authorization service in those cases where the request is out of the scope of the AuthPolicy and therefore always authorized."},{"location":"kuadrant-operator/doc/auth/#internal-custom-resources-and-namespaces","title":"Internal custom resources and namespaces","text":"<p>While the Istio <code>AuthorizationPolicy</code> needs to be created in the same namespace as the gateway workload, the Authorino <code>AuthConfig</code> is created in the namespace of the <code>AuthPolicy</code> itself. This allows to simplify references such as to Kubernetes Secrets referred in the AuthPolicy, as well as the RBAC to support the architecture.</p>"},{"location":"kuadrant-operator/doc/development/","title":"Development Guide","text":""},{"location":"kuadrant-operator/doc/development/#technology-stack-required-for-development","title":"Technology stack required for development","text":"<ul> <li>operator-sdk version v1.32.0</li> <li>kind version v0.23.0</li> <li>git</li> <li>go version 1.22+</li> <li>kubernetes version v1.19+</li> <li>kubectl version v1.19+</li> </ul>"},{"location":"kuadrant-operator/doc/development/#build","title":"Build","text":"<pre><code>make build\n</code></pre>"},{"location":"kuadrant-operator/doc/development/#deploy-on-local-kubernetes-cluster","title":"Deploy on local kubernetes cluster","text":"<p>Run local Kubernetes cluster using Docker container using Kind and deploy kuadrant operator (and all dependencies) in a single command.</p> <pre><code>make local-setup\n</code></pre> <p>The <code>make local-setup</code> target accepts the following variables:</p> Makefile Variable Description Default value <code>GATEWAYAPI_PROVIDER</code> GatewayAPI provider name. Accepted values: [istio] istio"},{"location":"kuadrant-operator/doc/development/#run-as-a-local-process","title":"Run as a local process","text":"<p>Run local Kubernetes cluster using Docker container using Kind and deploy all dependencies in a single command.</p> <pre><code>make local-env-setup\n</code></pre> <p>The <code>make local-env-setup</code> target accepts the following variables:</p> Makefile Variable Description Default value <code>GATEWAYAPI_PROVIDER</code> GatewayAPI provider name. Accepted values: [istio] istio <p>Then, run the operator locally</p> <pre><code>make run\n</code></pre>"},{"location":"kuadrant-operator/doc/development/#deploy-on-existing-kubernetes-cluster","title":"Deploy on existing kubernetes cluster","text":"<p>Requirements:</p> <ul> <li>Active session open to the kubernetes cluster.</li> <li>GatewayAPI installed</li> <li>GatewayAPI provider installed. Currently only Istio supported.</li> <li>Cert Manager installed</li> </ul> <p>Before running the kuadrant operator, some dependencies needs to be deployed.</p> <pre><code>make install\nmake deploy-dependencies\n</code></pre> <p>Then, deploy the operator</p> <pre><code>make deploy\n</code></pre>"},{"location":"kuadrant-operator/doc/development/#deploy-kuadrant-operator-using-olm","title":"Deploy kuadrant operator using OLM","text":"<p>You can deploy kuadrant using OLM just running few commands. No need to build any image. Kuadrant engineering team provides <code>latest</code> and release version tagged images. They are available in the Quay.io/Kuadrant image repository.</p> <p>Create kind cluster</p> <pre><code>make kind-create-cluster\n</code></pre> <p>Deploy OLM system</p> <pre><code>make install-olm\n</code></pre> <p>Deploy kuadrant using OLM. The <code>make deploy-catalog</code> target accepts the following variables:</p> Makefile Variable Description Default value <code>CATALOG_IMG</code> Kuadrant operator catalog image URL <code>quay.io/kuadrant/kuadrant-operator-catalog:latest</code> <pre><code>make deploy-catalog [CATALOG_IMG=quay.io/kuadrant/kuadrant-operator-catalog:latest]\n</code></pre>"},{"location":"kuadrant-operator/doc/development/#build-custom-olm-catalog","title":"Build custom OLM catalog","text":"<p>If you want to deploy (using OLM) a custom kuadrant operator, you need to build your own catalog. Furthermore, if you want to deploy a custom limitador or authorino operator, you also need to build your own catalog. The kuadrant operator bundle includes the authorino or limtador operator dependency version, hence using other than <code>latest</code> version requires a custom kuadrant operator bundle and a custom catalog including the custom bundle.</p>"},{"location":"kuadrant-operator/doc/development/#build-kuadrant-operator-bundle-image","title":"Build kuadrant operator bundle image","text":"<p>The <code>make bundle</code> target accepts the following variables:</p> Makefile Variable Description Default value Notes <code>IMG</code> Kuadrant operator image URL <code>quay.io/kuadrant/kuadrant-operator:latest</code> <code>TAG</code> var could be use to build this URL, defaults to latest  if not provided <code>VERSION</code> Bundle version <code>0.0.0</code> <code>LIMITADOR_OPERATOR_BUNDLE_IMG</code> Limitador operator bundle URL <code>quay.io/kuadrant/limitador-operator-bundle:latest</code> <code>LIMITADOR_OPERATOR_VERSION</code> var could be used to build this, defaults to latest if not provided <code>AUTHORINO_OPERATOR_BUNDLE_IMG</code> Authorino operator bundle URL <code>quay.io/kuadrant/authorino-operator-bundle:latest</code> <code>AUTHORINO_OPERATOR_VERSION</code> var could be used to build this, defaults to latest if not provided <code>DNS_OPERATOR_BUNDLE_IMG</code> DNS operator bundle URL <code>quay.io/kuadrant/dns-operator-bundle:latest</code> <code>DNS_OPERATOR_BUNDLE_IMG</code> var could be used to build this, defaults to latest if not provided <code>RELATED_IMAGE_WASMSHIM</code> WASM shim image URL <code>oci://quay.io/kuadrant/wasm-shim:latest</code> <code>WASM_SHIM_VERSION</code> var could be used to build this, defaults to latest if not provided <ul> <li>Build the bundle manifests</li> </ul> <pre><code>make bundle [IMG=quay.io/kuadrant/kuadrant-operator:latest] \\\n            [VERSION=0.0.0] \\\n            [LIMITADOR_OPERATOR_BUNDLE_IMG=quay.io/kuadrant/limitador-operator-bundle:latest] \\\n            [AUTHORINO_OPERATOR_BUNDLE_IMG=quay.io/kuadrant/authorino-operator-bundle:latest] \\\n            [DNS_OPERATOR_BUNDLE_IMG=quay.io/kuadrant/dns-operator-bundle:latest] \\\n            [RELATED_IMAGE_WASMSHIM=oci://quay.io/kuadrant/wasm-shim:latest]\n</code></pre> <ul> <li>Build the bundle image from the manifests</li> </ul> Makefile Variable Description Default value <code>BUNDLE_IMG</code> Kuadrant operator bundle image URL <code>quay.io/kuadrant/kuadrant-operator-bundle:latest</code> <pre><code>make bundle-build [BUNDLE_IMG=quay.io/kuadrant/kuadrant-operator-bundle:latest]\n</code></pre> <ul> <li>Push the bundle image to a registry</li> </ul> Makefile Variable Description Default value <code>BUNDLE_IMG</code> Kuadrant operator bundle image URL <code>quay.io/kuadrant/kuadrant-operator-bundle:latest</code> <pre><code>make bundle-push [BUNDLE_IMG=quay.io/kuadrant/kuadrant-operator-bundle:latest]\n</code></pre> <p>Frequently, you may need to build custom kuadrant bundle with the default (<code>latest</code>) Limitador and Authorino bundles. These are the example commands to build the manifests, build the bundle image and push to the registry.</p> <p>In the example, a new kuadrant operator bundle version <code>0.8.0</code> will be created that references the kuadrant operator image <code>quay.io/kuadrant/kuadrant-operator:v0.5.0</code> and latest Limitador and Authorino bundles.</p> <pre><code># manifests\nmake bundle IMG=quay.io/kuadrant/kuadrant-operator:v0.5.0 VERSION=0.8.0\n\n# bundle image\nmake bundle-build BUNDLE_IMG=quay.io/kuadrant/kuadrant-operator-bundle:my-bundle\n\n# push bundle image\nmake bundle-push BUNDLE_IMG=quay.io/kuadrant/kuadrant-operator-bundle:my-bundle\n</code></pre>"},{"location":"kuadrant-operator/doc/development/#build-custom-catalog","title":"Build custom catalog","text":"<p>The catalog's format will be File-based Catalog.</p> <p>Make sure all the required bundles are pushed to the registry. It is required by the <code>opm</code> tool.</p> <p>The <code>make catalog</code> target accepts the following variables:</p> Makefile Variable Description Default value <code>BUNDLE_IMG</code> Kuadrant operator bundle image URL <code>quay.io/kuadrant/kuadrant-operator-bundle:latest</code> <code>LIMITADOR_OPERATOR_BUNDLE_IMG</code> Limitador operator bundle URL <code>quay.io/kuadrant/limitador-operator-bundle:latest</code> <code>AUTHORINO_OPERATOR_BUNDLE_IMG</code> Authorino operator bundle URL <code>quay.io/kuadrant/authorino-operator-bundle:latest</code> <code>DNS_OPERATOR_BUNDLE_IMG</code> DNS operator bundle URL <code>quay.io/kuadrant/dns-operator-bundle:latest</code> <pre><code>make catalog [BUNDLE_IMG=quay.io/kuadrant/kuadrant-operator-bundle:latest] \\\n            [LIMITADOR_OPERATOR_BUNDLE_IMG=quay.io/kuadrant/limitador-operator-bundle:latest] \\\n            [AUTHORINO_OPERATOR_BUNDLE_IMG=quay.io/kuadrant/authorino-operator-bundle:latest] \\\n            [DNS_OPERATOR_BUNDLE_IMG=quay.io/kuadrant/dns-operator-bundle:latest]\n</code></pre> <ul> <li>Build the catalog image from the manifests</li> </ul> Makefile Variable Description Default value <code>CATALOG_IMG</code> Kuadrant operator catalog image URL <code>quay.io/kuadrant/kuadrant-operator-catalog:latest</code> <pre><code>make catalog-build [CATALOG_IMG=quay.io/kuadrant/kuadrant-operator-catalog:latest]\n</code></pre> <ul> <li>Push the catalog image to a registry</li> </ul> <pre><code>make catalog-push [CATALOG_IMG=quay.io/kuadrant/kuadrant-operator-bundle:latest]\n</code></pre> <p>You can try out your custom catalog image following the steps of the Deploy kuadrant operator using OLM section.</p>"},{"location":"kuadrant-operator/doc/development/#cleaning-up","title":"Cleaning up","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"kuadrant-operator/doc/development/#run-tests","title":"Run tests","text":""},{"location":"kuadrant-operator/doc/development/#unittests","title":"Unittests","text":"<pre><code>make test-unit\n</code></pre> <p>Optionally, add <code>TEST_NAME</code> makefile variable to run specific test</p> <pre><code>make test-unit TEST_NAME=TestLimitIndexEquals\n</code></pre> <p>or even subtest</p> <pre><code>make test-unit TEST_NAME=TestLimitIndexEquals/empty_indexes_are_equal\n</code></pre>"},{"location":"kuadrant-operator/doc/development/#integration-tests","title":"Integration tests","text":"<p>Multiple controller integration tests are defined</p> Golang package Required environment Makefile env setup target Makefile test run target <code>github.com/kuadrant/kuadrant-operator/tests/bare_k8s</code> no gateway provider, no GatewayAPI CRDs. Just Kuadrant API and Kuadrant dependencies. <code>make local-k8s-env-setup</code> <code>make test-bare-k8s-integration</code> <code>github.com/kuadrant/kuadrant-operator/tests/gatewayapi</code> no gateway provider. GatewayAPI CRDs, Kuadrant API and Kuadrant dependencies. <code>make local-gatewayapi-env-setup</code> <code>make test-gatewayapi-env-integration</code> <code>github.com/kuadrant/kuadrant-operator/controllers</code> at least one gatewayapi provider. It can be any: istio, envoygateway, ... <code>make local-env-setup GATEWAYAPI_PROVIDER=[istio]</code> (Default istio) <code>make test-integration</code> <code>github.com/kuadrant/kuadrant-operator/tests/istio</code> GatewayAPI CRDs, Istio, Kuadrant API and Kuadrant dependencies. <code>make local-env-setup GATEWAYAPI_PROVIDER=istio</code> <code>make test-istio-env-integration</code>"},{"location":"kuadrant-operator/doc/development/#lint-tests","title":"Lint tests","text":"<pre><code>make run-lint\n</code></pre>"},{"location":"kuadrant-operator/doc/development/#uninstall-kuadrant-crds","title":"(Un)Install Kuadrant CRDs","text":"<p>You need an active session open to a kubernetes cluster.</p> <p>Remove CRDs</p> <pre><code>make uninstall\n</code></pre>"},{"location":"kuadrant-operator/doc/dns/","title":"Kuadrant DNS","text":"<p>A Kuadrant DNSPolicy custom resource:</p> <ol> <li>Targets Gateway API networking resources Gateways to provide dns management by managing the lifecycle of dns records in external dns providers such as AWS Route53 and Google DNS.</li> </ol>"},{"location":"kuadrant-operator/doc/dns/#how-it-works","title":"How it works","text":"<p>A DNSPolicy and its targeted Gateway API networking resource contain all the statements to configure both the ingress gateway and the external DNS service.  The needed dns names are gathered from the listener definitions and the IPAdresses | CNAME hosts are gathered from the status block of the gateway resource.</p>"},{"location":"kuadrant-operator/doc/dns/#the-dnspolicy-custom-resource","title":"The DNSPolicy custom resource","text":""},{"location":"kuadrant-operator/doc/dns/#overview","title":"Overview","text":"<p>The <code>DNSPolicy</code> spec includes the following parts:</p> <ul> <li>A reference to an existing Gateway API resource (<code>spec.targetRef</code>)</li> <li>DNS Routing Strategy (<code>spec.routingStrategy</code>)</li> <li>LoadBalancing specification (<code>spec.loadBalancing</code>)</li> <li>HealthCheck specification (<code>spec.healthCheck</code>)</li> </ul>"},{"location":"kuadrant-operator/doc/dns/#high-level-example-and-field-definition","title":"High-level example and field definition","text":"<pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: my-dns-policy\nspec:\n  # reference to an existing networking resource to attach the policy to\n  # it can only be a Gateway API Gateway resource\n  # it can only refer to objects in the same namespace as the DNSPolicy\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: mygateway\n\n # reference to an existing secret resource containing provider credentials and configuration\n # it can only refer to Secrets in the same namespace as the DNSPolicy that have the type kuadrant.io/(provider) e.g kuadrant.io/aws\n  providerRefs:\n\n   - name: my-aws-credentials\n\n  # (optional) routing strategy to use when creating DNS records, defaults to `loadbalanced`\n  # determines what DNS records are created in the DNS provider\n  # check out Kuadrant RFC 0005 https://github.com/Kuadrant/architecture/blob/main/rfcs/0005-single-cluster-dnspolicy.md to learn more about the Routing Strategy field\n  # One-of: simple, loadbalanced.\n  routingStrategy: loadbalanced\n\n  # (optional) loadbalancing specification\n  # use it for providing the specification of how dns will be configured in order to provide balancing of load across multiple clusters when using the `loadbalanced` routing strategy\n  # Primary use of this is for multi cluster deployments\n  # check out Kuadrant RFC 0003 https://github.com/Kuadrant/architecture/blob/main/rfcs/0003-dns-policy.md to learn more about the options that can be used in this field\n  loadBalancing:\n    # (optional) weighted specification\n    # use it to control the weight value applied to records\n    weighted:\n      # use it to change the weight of a record based on labels applied to the target meta resource i.e. Gateway in a single cluster context or ManagedCluster in multi cluster with OCM\n      custom:\n\n        - weight: 200\n          selector:\n            matchLabels:\n              kuadrant.io/lb-attribute-custom-weight: AWS\n      # (optional) weight value that will be applied to weighted dns records by default. Integer greater than 0 and no larger than the maximum value accepted by the target dns provider, defaults to `120` \n      defaultWeight: 100\n    # (optional) geo specification\n    # use it to control the geo value applied to records \n    geo:\n      # (optional) default geo to be applied to records \n      defaultGeo: IE\n\n  # (optional) health check specification\n  # health check probes with the following specification will be created for each DNS target\n  healthCheck:\n    allowInsecureCertificates: true\n    endpoint: /\n    expectedResponses:\n\n      - 200\n      - 201\n      - 301\n    failureThreshold: 5\n    port: 443\n    protocol: https\n</code></pre> <p>Check out the API reference for a full specification of the DNSPolicy CRD.</p>"},{"location":"kuadrant-operator/doc/dns/#using-the-dnspolicy","title":"Using the DNSPolicy","text":""},{"location":"kuadrant-operator/doc/dns/#dns-provider-setup","title":"DNS Provider Setup","text":"<p>A DNSPolicy acts against a target Gateway by processing its listeners for hostnames that it can create dns records for.  In order for it to do this, it must know about the dns provider. This is done through the creation of dns provider secrets containing the credentials and configuration for the dns provider account.</p> <p>If for example a Gateway is created with a listener with a hostname of <code>echo.apps.hcpapps.net</code>: <pre><code>apiVersion: gateway.networking.k8s.io/v1\nkind: Gateway\nmetadata:\n  name: my-gw\nspec:\n  listeners:\n\n    - allowedRoutes:\n        namespaces:\n          from: All\n      name: api\n      hostname: echo.apps.hcpapps.net\n      port: 80\n      protocol: HTTP\n</code></pre></p> <p>In order for the DNSPolicy to act upon that listener, a DNS provider Secret must exist for that hostnames' domain.</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: my-aws-credentials\n  namespace: &lt;Gateway Namespace&gt;\ndata:\n  AWS_ACCESS_KEY_ID: &lt;AWS_ACCESS_KEY_ID&gt;\n  AWS_REGION: &lt;AWS_REGION&gt;\n  AWS_SECRET_ACCESS_KEY: &lt;AWS_SECRET_ACCESS_KEY&gt;\ntype: kuadrant.io/aws\n</code></pre> <p>By default, Kuadrant will list the available zones and find the matching zone based on the listener host in the gateway listener. If it finds more than one matching zone for a given listener host, it will not update any of those zones.  When providing a credential you should limit that credential down to just have write access to the zones you want Kuadrant to manage. Below is an example of a an AWS policy for doing this type of thing:</p> <pre><code>{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n        {\n            \"Sid\": \"VisualEditor0\",\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"route53:ListTagsForResources\",\n                \"route53:GetHealthCheckLastFailureReason\",\n                \"route53:GetHealthCheckStatus\",\n                \"route53:GetChange\",\n                \"route53:GetHostedZone\",\n                \"route53:ChangeResourceRecordSets\",\n                \"route53:ListResourceRecordSets\",\n                \"route53:GetHealthCheck\",\n                \"route53:UpdateHostedZoneComment\",\n                \"route53:UpdateHealthCheck\",\n                \"route53:CreateHealthCheck\",\n                \"route53:DeleteHealthCheck\",\n                \"route53:ListTagsForResource\",\n                \"route53:ListHealthChecks\",\n                \"route53:GetGeoLocation\",\n                \"route53:ListGeoLocations\",\n                \"route53:ListHostedZonesByName\",\n                \"route53:GetHealthCheckCount\"\n            ],\n            \"Resource\": [\n                \"arn:aws:route53:::hostedzone/Z08187901Y93585DDGM6K\",\n                \"arn:aws:route53:::healthcheck/*\",\n                \"arn:aws:route53:::change/*\"\n            ]\n        },\n        {\n            \"Sid\": \"VisualEditor1\",\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"route53:ListHostedZones\"\n            ],\n            \"Resource\": \"*\"\n        }\n    ]\n}\n</code></pre>"},{"location":"kuadrant-operator/doc/dns/#targeting-a-gateway-networking-resource","title":"Targeting a Gateway networking resource","text":"<p>When a DNSPolicy targets a Gateway, the policy will be enforced on all gateway listeners.</p> <p>Target a Gateway by setting the <code>spec.targetRef</code> field of the DNSPolicy as follows:</p> <pre><code>apiVersion: kuadrant.io/v1beta2\nkind: DNSPolicy\nmetadata:\n  name: &lt;DNSPolicy name&gt;\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: &lt;Gateway Name&gt;\n</code></pre>"},{"location":"kuadrant-operator/doc/dns/#dnsrecord-resource","title":"DNSRecord Resource","text":"<p>The DNSPolicy will create a DNSRecord resource for each listener hostname. The DNSPolicy resource uses the status of the Gateway to determine what dns records need to be created based on the clusters it has been placed onto.</p> <p>Given the following multi cluster gateway status: <pre><code>status:\n  addresses:\n\n    - type: kuadrant.io/MultiClusterIPAddress\n      value: kind-mgc-workload-1/172.31.201.1\n    - type: kuadrant.io/MultiClusterIPAddress\n      value: kind-mgc-workload-2/172.31.202.1\n  listeners:\n    - attachedRoutes: 1\n      conditions: []\n      name: kind-mgc-workload-1.api\n      supportedKinds: []\n    - attachedRoutes: 1\n      conditions: []\n      name: kind-mgc-workload-2.api\n      supportedKinds: []        \n</code></pre></p> <p>A DNSPolicy targeting this gateway would create an appropriate DNSRecord based on the routing strategy selected.</p>"},{"location":"kuadrant-operator/doc/dns/#loadbalanced","title":"loadbalanced","text":"<pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSRecord\nmetadata:\n  name: echo.apps.hcpapps.net\n  namespace: &lt;Gateway Namespace&gt;\nspec:\n  endpoints:\n\n    - dnsName: 24osuu.lb-2903yb.echo.apps.hcpapps.net\n      recordTTL: 60\n      recordType: A\n      targets:\n        - 172.31.202.1\n    - dnsName: default.lb-2903yb.echo.apps.hcpapps.net\n      providerSpecific:\n        - name: weight\n          value: \"120\"\n      recordTTL: 60\n      recordType: CNAME\n      setIdentifier: 24osuu.lb-2903yb.echo.apps.hcpapps.net\n      targets:\n        - 24osuu.lb-2903yb.echo.apps.hcpapps.net\n    - dnsName: default.lb-2903yb.echo.apps.hcpapps.net\n      providerSpecific:\n        - name: weight\n          value: \"120\"\n      recordTTL: 60\n      recordType: CNAME\n      setIdentifier: lrnse3.lb-2903yb.echo.apps.hcpapps.net\n      targets:\n        - lrnse3.lb-2903yb.echo.apps.hcpapps.net\n    - dnsName: echo.apps.hcpapps.net\n      recordTTL: 300\n      recordType: CNAME\n      targets:\n        - lb-2903yb.echo.apps.hcpapps.net\n    - dnsName: lb-2903yb.echo.apps.hcpapps.net\n      providerSpecific:\n        - name: geo-country-code\n          value: '*'\n      recordTTL: 300\n      recordType: CNAME\n      setIdentifier: default\n      targets:\n        - default.lb-2903yb.echo.apps.hcpapps.net\n    - dnsName: lrnse3.lb-2903yb.echo.apps.hcpapps.net\n      recordTTL: 60\n      recordType: A\n      targets:\n        - 172.31.201.1\n  providerRefs:\n    - name: my-aws-credentials\n</code></pre> <p>After DNSRecord reconciliation the listener hostname should be resolvable through dns:</p> <pre><code>dig echo.apps.hcpapps.net +short\nlb-2903yb.echo.apps.hcpapps.net.\ndefault.lb-2903yb.echo.apps.hcpapps.net.\nlrnse3.lb-2903yb.echo.apps.hcpapps.net.\n172.31.201.1\n</code></pre>"},{"location":"kuadrant-operator/doc/dns/#simple","title":"simple","text":"<pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSRecord\nmetadata:\n  name: echo.apps.hcpapps.net\n  namespace: &lt;Gateway Namespace&gt;\nspec:\n  endpoints:\n\n    - dnsName: echo.apps.hcpapps.net\n      recordTTL: 60\n      recordType: A\n      targets:\n        - 172.31.201.1\n        - 172.31.202.1\n  providerRefs:\n   - name: my-aws-credentials \n</code></pre> <p>After DNSRecord reconciliation the listener hostname should be resolvable through dns:</p> <pre><code>dig echo.apps.hcpapps.net +short\n172.31.201.1\n</code></pre>"},{"location":"kuadrant-operator/doc/dns/#known-limitations","title":"Known limitations","text":"<ul> <li>One Gateway can only be targeted by one DNSPolicy.</li> <li>DNSPolicies can only target Gateways defined within the same namespace of the DNSPolicy.</li> </ul>"},{"location":"kuadrant-operator/doc/dnshealthchecks/","title":"DNS Health Checks","text":"<p>DNS Health Checks are a tool provided by some DNS Providers for ensuring the availability and reliability of your DNS Records and only publishing DNS Records that resolve to healthy workloads. Kuadrant offers a powerful feature known as DNSPolicy, which allows you to configure these health checks for all the managed DNS endpoints created as a result of that policy. This guide provides a comprehensive overview of how to set up, utilize, and understand these DNS health checks.</p>"},{"location":"kuadrant-operator/doc/dnshealthchecks/#supported-providers","title":"Supported Providers","text":"<p>we currently only support AWS Route53 DNS Health checks.</p>"},{"location":"kuadrant-operator/doc/dnshealthchecks/#configuration-of-health-checks","title":"Configuration of Health Checks","text":"<p>To configure a DNS health check, you need to specify the <code>healthCheck</code> section of the DNSPolicy, which includes important properties such as:</p> <ul> <li><code>endpoint</code>: This is the path where the health checks take place, usually represented as '/healthz' or something similar.</li> <li><code>port</code>: Specific port for the connection to be checked.</li> <li><code>protocol</code>: Type of protocol being used, like HTTP or HTTPS.</li> <li><code>FailureThreshold</code>: How many times we can tolerate a failure on this endpoint, before removing the related DNS entry.</li> </ul> <pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: prod-web\n  namespace: multi-cluster-gateways\nspec:\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  loadBalancing: simple\n  healthCheck:\n    endpoint: \"/health\"\n    port: 443\n    protocol: \"HTTPS\"\n    failureThreshold: 5\n</code></pre> <p>This configuration sets up a DNS health check in AWS Route53 which will connect by HTTPS on port 443 and request the path /health.</p>"},{"location":"kuadrant-operator/doc/dnshealthchecks/#reviewing-the-status-of-health-checks","title":"Reviewing the status of Health Checks","text":"<p>The DNS Record CR will show whether the health check has been created or not in the DNS Provider, and will also show any errors encountered when trying to create or update the health check configuration.</p> <p>To see the status of the executing health check requires logging in to the Route53 console to view the current probe results.</p>"},{"location":"kuadrant-operator/doc/dnshealthchecks/#reconfiguring-health-checks","title":"Reconfiguring Health Checks","text":"<p>To reconfigure the health checks,  update the HealthCheck section of the DNS Policy, this will be reflected into all the health checks created as a result of this policy.</p>"},{"location":"kuadrant-operator/doc/dnshealthchecks/#removing-health-checks","title":"Removing Health Checks","text":"<p>To remove the health checks created in AWS, delete the healthcheck section of the DNS Policy. All health checks will be deleted automatically, if the DNS Policy is deleted.</p>"},{"location":"kuadrant-operator/doc/dnshealthchecks/#limitations","title":"Limitations","text":"<p>As Route53 will only perform health checks on an IP address, currently do not create health checks on DNS Policies that target gateways with hostname addresses.</p>"},{"location":"kuadrant-operator/doc/dnshealthchecks/#other-providers","title":"Other Providers","text":"<p>Although we intend to support integrating with the DNS Health checks provided by other DNS Providers in the future, we currently only support AWS Route53.</p>"},{"location":"kuadrant-operator/doc/logging/","title":"Logging","text":"<p>The kuadrant operator outputs 3 levels of log messages: (from lowest to highest level)</p> <ol> <li><code>debug</code></li> <li><code>info</code> (default)</li> <li><code>error</code></li> </ol> <p><code>info</code> logging is restricted to high-level information. Actions like creating, deleteing or updating kubernetes resources will be logged with reduced details about the corresponding objects, and without any further detailed logs of the steps in between, except for errors.</p> <p>Only <code>debug</code> logging will include processing details.</p> <p>To configure the desired log level, set the environment variable <code>LOG_LEVEL</code> to one of the supported values listed above. Default log level is <code>info</code>.</p> <p>Apart from log level, the operator can output messages to the logs in 2 different formats:</p> <ul> <li><code>production</code> (default): each line is a parseable JSON object with properties <code>{\"level\":string, \"ts\":int, \"msg\":string, \"logger\":string, extra values...}</code></li> <li><code>development</code>: more human-readable outputs, extra stack traces and logging info, plus extra values output as JSON, in the format: <code>&lt;timestamp-iso-8601&gt;\\t&lt;log-level&gt;\\t&lt;logger&gt;\\t&lt;message&gt;\\t{extra-values-as-json}</code></li> </ul> <p>To configure the desired log mode, set the environment variable <code>LOG_MODE</code> to one of the supported values listed above. Default log level is <code>production</code>.</p>"},{"location":"kuadrant-operator/doc/rate-limiting/","title":"Kuadrant Rate Limiting","text":"<p>A Kuadrant RateLimitPolicy custom resource, often abbreviated \"RateLimitPolicy\":</p> <ol> <li>Targets Gateway API networking resources such as HTTPRoutes and Gateways, using these resources to obtain additional context, i.e., which traffic workload (HTTP attributes, hostnames, user attributes, etc) to rate limit.</li> <li>Supports targeting subsets (sections) of a network resource to apply the limits to.</li> <li>Abstracts the details of the underlying Rate Limit protocol and configuration resources, that have a much broader remit and surface area.</li> <li>Enables cluster operators to set defaults that govern behavior at the lower levels of the network, until a more specific policy is applied.</li> </ol>"},{"location":"kuadrant-operator/doc/rate-limiting/#how-it-works","title":"How it works","text":""},{"location":"kuadrant-operator/doc/rate-limiting/#envoys-rate-limit-service-protocol","title":"Envoy's Rate Limit Service Protocol","text":"<p>Kuadrant's Rate Limit implementation relies on the Envoy's Rate Limit Service (RLS) protocol. The workflow per request goes:</p> <ol> <li>On incoming request, the gateway checks the matching rules for enforcing rate limits, as stated in the RateLimitPolicy custom resources and targeted Gateway API networking objects</li> <li>If the request matches, the gateway sends one RateLimitRequest to the external rate limiting service (\"Limitador\").</li> <li>The external rate limiting service responds with a RateLimitResponse back to the gateway with either an <code>OK</code> or <code>OVER_LIMIT</code> response code.</li> </ol> <p>A RateLimitPolicy and its targeted Gateway API networking resource contain all the statements to configure both the ingress gateway and the external rate limiting service.</p>"},{"location":"kuadrant-operator/doc/rate-limiting/#the-ratelimitpolicy-custom-resource","title":"The RateLimitPolicy custom resource","text":""},{"location":"kuadrant-operator/doc/rate-limiting/#overview","title":"Overview","text":"<p>The <code>RateLimitPolicy</code> spec includes, basically, two parts:</p> <ul> <li>A reference to an existing Gateway API resource (<code>spec.targetRef</code>)</li> <li>Limit definitions (<code>spec.limits</code>)</li> </ul> <p>Each limit definition includes:</p> <ul> <li>A set of rate limits (<code>spec.limits.&lt;limit-name&gt;.rates[]</code>)</li> <li>(Optional) A set of dynamic counter qualifiers (<code>spec.limits.&lt;limit-name&gt;.counters[]</code>)</li> <li>(Optional) A set of route selectors, to further qualify the specific routing rules when to activate the limit (<code>spec.limits.&lt;limit-name&gt;.routeSelectors[]</code>)</li> <li>(Optional) A set of additional dynamic conditions to activate the limit (<code>spec.limits.&lt;limit-name&gt;.when[]</code>)</li> </ul> <p>The limit definitions (<code>limits</code>) can be declared at the top-level level of the spec (with the semantics of defaults) or alternatively within explicit <code>defaults</code> or <code>overrides</code> blocks.</p> Check out Kuadrant RFC 0002 to learn more about the Well-known Attributes that can be used to define counter qualifiers (<code>counters</code>) and conditions (<code>when</code>)."},{"location":"kuadrant-operator/doc/rate-limiting/#high-level-example-and-field-definition","title":"High-level example and field definition","text":"<pre><code>apiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: my-rate-limit-policy\nspec:\n  # Reference to an existing networking resource to attach the policy to. REQUIRED.\n  # It can be a Gateway API HTTPRoute or Gateway resource.\n  # It can only refer to objects in the same namespace as the RateLimitPolicy.\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute / Gateway\n    name: myroute / mygateway\n\n  # The limits definitions to apply to the network traffic routed through the targeted resource.\n  # Equivalent to if otherwise declared within `defaults`.\n  limits:\n    \"my_limit\":\n      # The rate limits associated with this limit definition. REQUIRED.\n      # E.g., to specify a 50rps rate limit, add `{ limit: 50, duration: 1, unit: secod }`\n      rates: [\u2026]\n\n      # Counter qualifiers.\n      # Each dynamic value in the data plane starts a separate counter, combined with each rate limit.\n      # E.g., to define a separate rate limit for each user name detected by the auth layer, add `metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.username`.\n      # Check out Kuadrant RFC 0002 (https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md) to learn more about the Well-known Attributes that can be used in this field.\n      counters: [\u2026]\n\n      # Further qualification of the scpecific HTTPRouteRules within the targeted HTTPRoute that should trigger the limit.\n      # Each element contains a HTTPRouteMatch object that will be used to select HTTPRouteRules that include at least one identical HTTPRouteMatch.\n      # The HTTPRouteMatch part does not have to be fully identical, but the what's stated in the selector must be identically stated in the HTTPRouteRule.\n      # Do not use it on RateLimitPolicies that target a Gateway.\n      routeSelectors: [\u2026]\n\n      # Additional dynamic conditions to trigger the limit.\n      # Use it for filtering attributes not supported by HTTPRouteRule or with RateLimitPolicies that target a Gateway.\n      # Check out Kuadrant RFC 0002 (https://github.com/Kuadrant/architecture/blob/main/rfcs/0002-well-known-attributes.md) to learn more about the Well-known Attributes that can be used in this field.\n      when: [\u2026]\n\n    # Explicit defaults. Used in policies that target a Gateway object to express default rules to be enforced on\n    # routes that lack a more specific policy attached to.\n    # Mutually exclusive with `overrides` and with declaring `limits` at the top-level of the spec.\n    defaults:\n      limits: {\u2026}\n\n    # Overrides. Used in policies that target a Gateway object to be enforced on all routes linked to the gateway,\n    # thus also overriding any more specific policy occasionally attached to any of those routes.\n    # Mutually exclusive with `defaults` and with declaring `limits` at the top-level of the spec.\n    overrides:\n      limits: {\u2026}\n</code></pre>"},{"location":"kuadrant-operator/doc/rate-limiting/#using-the-ratelimitpolicy","title":"Using the RateLimitPolicy","text":""},{"location":"kuadrant-operator/doc/rate-limiting/#targeting-a-httproute-networking-resource","title":"Targeting a HTTPRoute networking resource","text":"<p>When a RateLimitPolicy targets a HTTPRoute, the policy is enforced to all traffic routed according to the rules and hostnames specified in the HTTPRoute, across all Gateways referenced in the <code>spec.parentRefs</code> field of the HTTPRoute.</p> <p>The targeted HTTPRoute's rules and/or hostnames to which the policy must be enforced can be filtered to specific subsets, by specifying the <code>routeSelectors</code> field of the limit definition.</p> <p>Target a HTTPRoute by setting the <code>spec.targetRef</code> field of the RateLimitPolicy as follows:</p> <pre><code>apiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: &lt;RateLimitPolicy name&gt;\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: &lt;HTTPRoute Name&gt;\n  limits: {\u2026}\n</code></pre> <p></p>"},{"location":"kuadrant-operator/doc/rate-limiting/#hostnames-and-wildcards","title":"Hostnames and wildcards","text":"<p>If a RateLimitPolicy targets a route defined for <code>*.com</code> and another RateLimitPolicy targets another route for <code>api.com</code>, the Kuadrant control plane will not merge these two RateLimitPolicies. Unless one of the policies declare an overrides set of limites, the control plane will configure to mimic the behavior of gateway implementation by which the \"most specific hostname wins\", thus enforcing only the corresponding applicable policies and limit definitions.</p> <p>E.g., by default, a request coming for <code>api.com</code> will be rate limited according to the rules from the RateLimitPolicy that targets the route for <code>api.com</code>; while a request for <code>other.com</code> will be rate limited with the rules from the RateLimitPolicy targeting the route for <code>*.com</code>.</p> <p>See more examples in Overlapping Gateway and HTTPRoute RateLimitPolicies.</p>"},{"location":"kuadrant-operator/doc/rate-limiting/#targeting-a-gateway-networking-resource","title":"Targeting a Gateway networking resource","text":"<p>A RateLimitPolicy that targets a Gateway can declare a block of defaults (<code>spec.defaults</code>) or a block of overrides (<code>spec.overrides</code>). As a standard, gateway policies that do not specify neither defaults nor overrides, act as defaults.</p> <p>When declaring defaults, a RateLimitPolicy which targets a Gateway will be enforced to all HTTP traffic hitting the gateway, unless a more specific RateLimitPolicy targeting a matching HTTPRoute exists. Any new HTTPRoute referrencing the gateway as parent will be automatically covered by the default RateLimitPolicy, as well as changes in the existing HTTPRoutes.</p> <p>Defaults provide cluster operators with the ability to protect the infrastructure against unplanned and malicious network traffic attempt, such as by setting safe default limits on hostnames and hostname wildcards.</p> <p>Inversely, a gateway policy that specify overrides declares a set of rules to be enforced on all routes attached to the gateway, thus atomically replacing any more specific policy occasionally attached to any of those routes.</p> <p>Target a Gateway HTTPRoute by setting the <code>spec.targetRef</code> field of the RateLimitPolicy as follows:</p> <pre><code>apiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: &lt;RateLimitPolicy name&gt;\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: &lt;Gateway Name&gt;\n  defaults: # alternatively: `overrides`\n    limits: {\u2026}\n</code></pre> <p></p>"},{"location":"kuadrant-operator/doc/rate-limiting/#overlapping-gateway-and-httproute-ratelimitpolicies","title":"Overlapping Gateway and HTTPRoute RateLimitPolicies","text":"<p>Two possible semantics are to be considered here \u2013 gateway policy defaults vs gateway policy overrides.</p> <p>Gateway RateLimitPolicies that declare defaults (or alternatively neither defaults nor overrides) protect all traffic routed through the gateway except where a more specific HTTPRoute RateLimitPolicy exists, in which case the HTTPRoute RateLimitPolicy prevails.</p> <p>Example with 4 RateLimitPolicies, 3 HTTPRoutes and 1 Gateway default (plus 2 HTTPRoute and 2 Gateways without RateLimitPolicies attached):</p> <ul> <li>RateLimitPolicy A \u2192 HTTPRoute A (<code>a.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>RateLimitPolicy B \u2192 HTTPRoute B (<code>b.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>RateLimitPolicy W \u2192 HTTPRoute W (<code>*.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>RateLimitPolicy G (defaults) \u2192 Gateway G (<code>*.com</code>)</li> </ul> <p>Expected behavior:</p> <ul> <li>Request to <code>a.toystore.com</code> \u2192 RateLimitPolicy A will be enforced</li> <li>Request to <code>b.toystore.com</code> \u2192 RateLimitPolicy B will be enforced</li> <li>Request to <code>other.toystore.com</code> \u2192 RateLimitPolicy W will be enforced</li> <li>Request to <code>other.com</code> (suppose a route exists) \u2192 RateLimitPolicy G will be enforced</li> <li>Request to <code>yet-another.net</code> (suppose a route and gateway exist) \u2192 No RateLimitPolicy will be enforced</li> </ul> <p>Gateway RateLimitPolicies that declare overrides protect all traffic routed through the gateway, regardless of existence of any more specific HTTPRoute RateLimitPolicy.</p> <p>Example with 4 RateLimitPolicies, 3 HTTPRoutes and 1 Gateway override (plus 2 HTTPRoute and 2 Gateways without RateLimitPolicies attached):</p> <ul> <li>RateLimitPolicy A \u2192 HTTPRoute A (<code>a.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>RateLimitPolicy B \u2192 HTTPRoute B (<code>b.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>RateLimitPolicy W \u2192 HTTPRoute W (<code>*.toystore.com</code>) \u2192 Gateway G (<code>*.com</code>)</li> <li>RateLimitPolicy G (overrides) \u2192 Gateway G (<code>*.com</code>)</li> </ul> <p>Expected behavior:</p> <ul> <li>Request to <code>a.toystore.com</code> \u2192 RateLimitPolicy G will be enforced</li> <li>Request to <code>b.toystore.com</code> \u2192 RateLimitPolicy G will be enforced</li> <li>Request to <code>other.toystore.com</code> \u2192 RateLimitPolicy G will be enforced</li> <li>Request to <code>other.com</code> (suppose a route exists) \u2192 RateLimitPolicy G will be enforced</li> <li>Request to <code>yet-another.net</code> (suppose a route and gateway exist) \u2192 No RateLimitPolicy will be enforced</li> </ul>"},{"location":"kuadrant-operator/doc/rate-limiting/#limit-definition","title":"Limit definition","text":"<p>A limit will be activated whenever a request comes in and the request matches:</p> <ul> <li>any of the route rules selected by the limit (via <code>routeSelectors</code> or implicit \"catch-all\" selector), and</li> <li>all of the <code>when</code> conditions specified in the limit.</li> </ul> <p>A limit can define:</p> <ul> <li>counters that are qualified based on dynamic values fetched from the request, or</li> <li>global counters (implicitly, when no qualified counter is specified)</li> </ul> <p>A limit is composed of one or more rate limits.</p> <p>E.g.</p> <pre><code>spec:\n  limits:\n    \"toystore-all\":\n      rates:\n\n      - limit: 5000\n        duration: 1\n        unit: second\n\n    \"toystore-api-per-username\":\n      rates:\n\n      - limit: 100\n        duration: 1\n        unit: second\n      - limit: 1000\n        duration: 1\n        unit: minute\n      counters:\n      - auth.identity.username\n      routeSelectors:\n        hostnames:\n        - api.toystore.com\n\n    \"toystore-admin-unverified-users\":\n      rates:\n\n      - limit: 250\n        duration: 1\n        unit: second\n      routeSelectors:\n        hostnames:\n        - admin.toystore.com\n      when:\n      - selector: auth.identity.email_verified\n        operator: eq\n        value: \"false\"\n</code></pre> Request to Rate limits enforced <code>api.toystore.com</code> 100rps/username or 1000rpm/username (whatever happens first) <code>admin.toystore.com</code> 250rps <code>other.toystore.com</code> 5000rps"},{"location":"kuadrant-operator/doc/rate-limiting/#route-selectors","title":"Route selectors","text":"<p>Route selectors allow targeting sections of a HTTPRoute, by specifying sets of HTTPRouteMatches and/or hostnames that make the policy controller look up within the HTTPRoute spec for compatible declarations, and select the corresponding HTTPRouteRules and hostnames, to then build conditions that activate the policy or policy rule.</p> <p>Check out Route selectors for a full description, semantics and API reference.</p>"},{"location":"kuadrant-operator/doc/rate-limiting/#when-conditions","title":"<code>when</code> conditions","text":"<p><code>when</code> conditions can be used to scope a limit (i.e. to filter the traffic to which a limit definition applies) without any coupling to the underlying network topology, i.e. without making direct references to HTTPRouteRules via <code>routeSelectors</code>.</p> <p>Use <code>when</code> conditions to conditionally activate limits based on attributes that cannot be expressed in the HTTPRoutes' <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or in general in RateLimitPolicies that target a Gateway.</p> <p>The selectors within the <code>when</code> conditions of a RateLimitPolicy are a subset of Kuadrant's Well-known Attributes (RFC 0002). Check out the reference for the full list of supported selectors.</p>"},{"location":"kuadrant-operator/doc/rate-limiting/#examples","title":"Examples","text":"<p>Check out the following user guides for examples of rate limiting services with Kuadrant:</p> <ul> <li>Simple Rate Limiting for Application Developers</li> <li>Authenticated Rate Limiting for Application Developers</li> <li>Gateway Rate Limiting for Cluster Operators</li> <li>Authenticated Rate Limiting with JWTs and Kubernetes RBAC</li> </ul>"},{"location":"kuadrant-operator/doc/rate-limiting/#known-limitations","title":"Known limitations","text":"<ul> <li>One HTTPRoute can only be targeted by one RateLimitPolicy.</li> <li>One Gateway can only be targeted by one RateLimitPolicy.</li> <li>RateLimitPolicies can only target HTTPRoutes/Gateways defined within the same namespace of the RateLimitPolicy.</li> <li>2+ RateLimitPolicies cannot target network resources that define/inherit the same exact hostname.</li> </ul>"},{"location":"kuadrant-operator/doc/rate-limiting/#limitation-multiple-network-resources-with-identical-hostnames","title":"Limitation: Multiple network resources with identical hostnames","text":"<p>Kuadrant currently does not support multiple RateLimitPolicies simultaneously targeting network resources that declare identical hostnames. This includes multiple HTTPRoutes that specify the same hostnames in the <code>spec.hostnames</code> field, as well as HTTPRoutes that specify a hostname that is identical to a hostname specified in a listener of one of the route's parent gateways or HTTPRoutes that don't specify any hostname at all thus inheriting the hostnames from the parent gateways. In any of these cases, a maximum of one RateLimitPolicy targeting any of those resources that specify identical hostnames is allowed.</p> <p>Moreover, having multiple resources that declare identical hostnames may lead to unexpected behavior and therefore should be avoided.</p> <p>This limitation is rooted at the underlying components configured by Kuadrant for the implementation of its policies and the lack of information in the data plane regarding the exact route that honored by the API gateway in cases of conflicting hostnames.</p> <p>To exemplify one way this limitation can impact deployments, consider the following topology:</p> <pre><code>                 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                 \u2502   Gateway    \u2502\n                 \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n          \u250c\u2500\u2500\u2500\u2500\u2500\u25ba\u2502 listeners:   \u2502\u25c4\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n          \u2502      \u2502 - host: *.io \u2502       \u2502\n          \u2502      \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518       \u2502\n          \u2502                             \u2502\n          \u2502                             \u2502\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510        \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502     HTTPRoute     \u2502        \u2502     HTTPRoute     \u2502\n\u2502     (route-a)     \u2502        \u2502     (route-b)     \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524        \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 hostnames:        \u2502        \u2502 hostnames:        \u2502\n\u2502 - app.io          \u2502        \u2502 - app.io          \u2502\n\u2502 rules:            \u2502        \u2502 rules:            \u2502\n\u2502 - matches:        \u2502        \u2502 - matches:        \u2502\n\u2502   - path:         \u2502        \u2502   - path:         \u2502\n\u2502       value: /foo \u2502        \u2502       value: /bar \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518        \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n          \u25b2                            \u25b2\n          \u2502                            \u2502\n \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510           \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n \u2502 RateLimitPolicy \u2502           \u2502 RateLimitPolicy \u2502\n \u2502   (policy-1)    \u2502           \u2502   (policy-2)    \u2502\n \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518           \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre> <p>In the example above, with the <code>policy-1</code> resource created before <code>policy-2</code>, <code>policy-2</code> will be enforced on all requests to <code>app.io/bar</code> while <code>policy-1</code> will not be enforced at all. I.e. <code>app.io/foo</code> will not be rate-limited. Nevertheless, both policies will report status condition as <code>Enforced</code>.</p> <p>Notice the enforcement of <code>policy-2</code> and no enforcement of <code>policy-1</code> is the opposite behavior as the analogous problem with the Kuadrant AuthPolicy.</p> <p>A different way the limitation applies is when two or more routes of a gateway declare the exact same hostname and a gateway policy is defined with expectation to set default rules for the cases not covered by more specific policies. E.g.:</p> <pre><code>                                    \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                         \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524 RateLimitPolicy \u2502\n                         \u2502          \u2502    (policy-2)   \u2502\n                         \u25bc          \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                 \u2502   Gateway    \u2502\n                 \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n          \u250c\u2500\u2500\u2500\u2500\u2500\u25ba\u2502 listeners:   \u2502\u25c4\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n          \u2502      \u2502 - host: *.io \u2502       \u2502\n          \u2502      \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518       \u2502\n          \u2502                             \u2502\n          \u2502                             \u2502\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510        \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502     HTTPRoute     \u2502        \u2502     HTTPRoute     \u2502\n\u2502     (route-a)     \u2502        \u2502     (route-b)     \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524        \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 hostnames:        \u2502        \u2502 hostnames:        \u2502\n\u2502 - app.io          \u2502        \u2502 - app.io          \u2502\n\u2502 rules:            \u2502        \u2502 rules:            \u2502\n\u2502 - matches:        \u2502        \u2502 - matches:        \u2502\n\u2502   - path:         \u2502        \u2502   - path:         \u2502\n\u2502       value: /foo \u2502        \u2502       value: /bar \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518        \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n          \u25b2\n          \u2502\n \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n \u2502 RateLimitPolicy \u2502\n \u2502   (policy-1)    \u2502\n \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre> <p>Once again, both policies will report status condition as <code>Enforced</code>. However, in this case, only <code>policy-1</code> will be enforced on requests to <code>app.io/foo</code>, while <code>policy-2</code> will not be enforced at all. I.e. <code>app.io/bar</code> will not be not rate-limited. This is same behavior as the analogous problem with the Kuadrant AuthPolicy.</p> <p>To avoid these problems, use different hostnames in each route.</p>"},{"location":"kuadrant-operator/doc/rate-limiting/#implementation-details","title":"Implementation details","text":"<p>Driven by limitations related to how Istio injects configuration in the filter chains of the ingress gateways, Kuadrant relies on Envoy's Wasm Network filter in the data plane, to manage the integration with rate limiting service (\"Limitador\"), instead of the Rate Limit filter.</p> <p>Motivation: Multiple rate limit domains The first limitation comes from having only one filter chain per listener. This often leads to one single global rate limiting filter configuration per gateway, and therefore to a shared rate limit domain across applications and policies. Even though, in a rate limit filter, the triggering of rate limit calls, via actions to build so-called \"descriptors\", can be defined at the level of the virtual host and/or specific route rule, the overall rate limit configuration is only one, i.e., always the same rate limit domain for all calls to Limitador.</p> <p>On the other hand, the possibility to configure and invoke the rate limit service for multiple domains depending on the context allows to isolate groups of policy rules, as well as to optimize performance in the rate limit service, which can rely on the domain for indexation.</p> <p>Motivation: Fine-grained matching rules A second limitation of configuring the rate limit filter via Istio, particularly from Gateway API resources, is that rate limit descriptors at the level of a specific HTTP route rule require \"named routes\" \u2013 defined only in an Istio VirtualService resource and referred in an EnvoyFilter one. Because Gateway API HTTPRoute rules lack a \"name\" property<sup>1</sup>, as well as the Istio VirtualService resources are only ephemeral data structures handled by Istio in-memory in its implementation of gateway configuration for Gateway API, where the names of individual route rules are auto-generated and not referable by users in a policy<sup>2</sup><sup>3</sup>, rate limiting by attributes of the HTTP request (e.g., path, method, headers, etc) would be very limited while depending only on Envoy's Rate Limit filter.</p> <p>Motivated by the desire to support multiple rate limit domains per ingress gateway, as well as fine-grained HTTP route matching rules for rate limiting, Kuadrant implements a wasm-shim that handles the rules to invoke the rate limiting service, complying with Envoy's Rate Limit Service (RLS) protocol.</p> <p>The wasm module integrates with the gateway in the data plane via Wasm Network filter, and parses a configuration composed out of user-defined RateLimitPolicy resources by the Kuadrant control plane. Whereas the rate limiting service (\"Limitador\") remains an implementation of Envoy's RLS protocol, capable of being integrated directly via Rate Limit extension or by Kuadrant, via wasm module for the Istio Gateway API implementation.</p> <p>As a consequence of this design:</p> <ul> <li>Users can define fine-grained rate limit rules that match their Gateway and HTTPRoute definitions including for subsections of these.</li> <li>Rate limit definitions are insulated, not leaking across unrelated policies or applications.</li> <li>Conditions to activate limits are evaluated in the context of the gateway process, reducing the gRPC calls to the external rate limiting service only to the cases where rate limit counters are known in advance to have to be checked/incremented.</li> <li>The rate limiting service can rely on the indexation to look up for groups of limit definitions and counters.</li> <li>Components remain compliant with industry protocols and flexible for different integration options.</li> </ul> <p>A Kuadrant wasm-shim configuration for 2 RateLimitPolicy custom resources (a Gateway default RateLimitPolicy and a HTTPRoute RateLimitPolicy) looks like the following and it is generated automatically by the Kuadrant control plane:</p> <pre><code>apiVersion: extensions.istio.io/v1alpha1\nkind: WasmPlugin\nmetadata:\n  name: kuadrant-istio-ingressgateway\n  namespace: istio-system\n  \u2026\nspec:\n  phase: STATS\n  pluginConfig:\n    failureMode: deny\n    rateLimitPolicies:\n\n    - domain: istio-system/gw-rlp # allows isolating policy rules and improve performance of the rate limit service\n      hostnames:\n      - '*.website'\n      - '*.io'\n      name: istio-system/gw-rlp\n      rules: # match rules from the gateway and according to conditions specified in the policy\n      - conditions:\n        - allOf:\n          - operator: startswith\n            selector: request.url_path\n            value: /\n        data:\n        - static: # tells which rate limit definitions and counters to activate\n            key: limit.internet_traffic_all__593de456\n            value: \"1\"\n      - conditions:\n        - allOf:\n          - operator: startswith\n            selector: request.url_path\n            value: /\n          - operator: endswith\n            selector: request.host\n            value: .io\n        data:\n        - static:\n            key: limit.internet_traffic_apis_per_host__a2b149d2\n            value: \"1\"\n        - selector:\n            selector: request.host\n      service: kuadrant-rate-limiting-service\n    - domain: default/app-rlp\n      hostnames:\n      - '*.toystore.website'\n      - '*.toystore.io'\n      name: default/app-rlp\n      rules: # matches rules from a httproute and additional specified in the policy\n      - conditions:\n        - allOf:\n          - operator: startswith\n            selector: request.url_path\n            value: /assets/\n        data:\n        - static:\n            key: limit.toystore_assets_all_domains__8cfb7371\n            value: \"1\"\n      - conditions:\n        - allOf:\n          - operator: startswith\n            selector: request.url_path\n            value: /v1/\n          - operator: eq\n            selector: request.method\n            value: GET\n          - operator: endswith\n            selector: request.host\n            value: .toystore.website\n          - operator: eq\n            selector: auth.identity.username\n            value: \"\"\n        - allOf:\n          - operator: startswith\n            selector: request.url_path\n            value: /v1/\n          - operator: eq\n            selector: request.method\n            value: POST\n          - operator: endswith\n            selector: request.host\n            value: .toystore.website\n          - operator: eq\n            selector: auth.identity.username\n            value: \"\"\n        data:\n        - static:\n            key: limit.toystore_v1_website_unauthenticated__3f9c40c6\n            value: \"1\"\n      service: kuadrant-rate-limiting-service\n  selector:\n    matchLabels:\n      istio.io/gateway-name: istio-ingressgateway\n  url: oci://quay.io/kuadrant/wasm-shim:v0.3.0\n</code></pre> <ol> <li> <p>https://github.com/kubernetes-sigs/gateway-api/pull/996\u00a0\u21a9</p> </li> <li> <p>https://github.com/istio/istio/issues/36790\u00a0\u21a9</p> </li> <li> <p>https://github.com/istio/istio/issues/37346\u00a0\u21a9</p> </li> </ol>"},{"location":"kuadrant-operator/doc/tls/","title":"TLS","text":"<p>A Kuadrant TLSPolicy custom resource:</p> <ol> <li>Targets Gateway API networking resources Gateways to provide tls for gateway listeners by managing the lifecycle of tls certificates using <code>CertManager</code>.</li> </ol>"},{"location":"kuadrant-operator/doc/tls/#how-it-works","title":"How it works","text":""},{"location":"kuadrant-operator/doc/tls/#the-tlspolicy-custom-resource","title":"The TLSPolicy custom resource","text":""},{"location":"kuadrant-operator/doc/tls/#overview","title":"Overview","text":"<p>The <code>TLSPolicy</code> spec includes the following parts:</p> <ul> <li>A reference to an existing Gateway API resource (<code>spec.targetRef</code>)</li> </ul>"},{"location":"kuadrant-operator/doc/tls/#high-level-example-and-field-definition","title":"High-level example and field definition","text":"<pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: TLSPolicy\nmetadata:\n  name: my-tls-policy\nspec:\n  # reference to an existing networking resource to attach the policy to\n  # it can only be a Gateway API Gateway resource\n  # it can only refer to objects in the same namespace as the TLSPolicy\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: mygateway\n</code></pre> <p>Check out the API reference for a full specification of the TLSPolicy CRD.</p>"},{"location":"kuadrant-operator/doc/tls/#using-the-tlspolicy","title":"Using the TLSPolicy","text":""},{"location":"kuadrant-operator/doc/tls/#targeting-a-gateway-networking-resource","title":"Targeting a Gateway networking resource","text":"<p>When a TLSPolicy targets a Gateway, the policy will be enforced on all gateway listeners that have a valid TLS section.</p> <p>Target a Gateway by setting the <code>spec.targetRef</code> field of the TLSPolicy as follows:</p> <pre><code>apiVersion: kuadrant.io/v1beta2\nkind: TLSPolicy\nmetadata:\n  name: &lt;TLSPolicy name&gt;\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: &lt;Gateway Name&gt;\n</code></pre>"},{"location":"kuadrant-operator/doc/tls/#examples","title":"Examples","text":"<p>Check out the following user guides for examples of using the Kuadrant TLSPolicy:</p>"},{"location":"kuadrant-operator/doc/tls/#known-limitations","title":"Known limitations","text":""},{"location":"kuadrant-operator/doc/install/install-kubernetes/","title":"Install Kuadrant on a Kubernetes cluster","text":"<p>Note</p> <p>You must perform these steps on each Kubernetes cluster where you want to use Kuadrant.</p>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#prerequisites","title":"Prerequisites","text":"<ul> <li>Access to a Kubernetes cluster, with <code>kubeadmin</code> or an account with similar permissions</li> <li><code>cert-manager</code> installed</li> </ul>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#procedure","title":"Procedure","text":"<p>This guide will show you how to install Kuadrant onto a bare Kubernetes cluster.</p> <p>Alternatively, if you are looking instead for a way to set up Kuadrant locally to evaluate or develop, consider running the kind &amp; Kubernetes quickstart script.</p>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#install-gateway-api","title":"Install Gateway API","text":"<pre><code>kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.1.0/standard-install.yaml\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#install-olm","title":"Install OLM","text":"<p>Note</p> <p>Currently, we recommend installing our operator via OLM. We plan to support Helm soon.</p> <pre><code>curl -sL https://github.com/operator-framework/operator-lifecycle-manager/releases/download/v0.28.0/install.sh | bash -s v0.28.0\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#install-istio-as-a-gateway-api-provider","title":"Install Istio as a Gateway API provider","text":"<p>Note</p> <p>There are several ways to install Istio (via <code>istioctl</code>, Helm chart or Operator) - this is just an example for starting from a bare Kubernetes cluster.</p> <pre><code>curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.21.4 sh -\n./istio-1.21.4/bin/istioctl install --set profile=minimal\n./istio-1.21.4/bin/istioctl operator init\nkubectl apply -f https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/config/dependencies/istio/istio-operator.yaml\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#install-kuadrant","title":"Install Kuadrant","text":"<pre><code>kubectl create -f https://operatorhub.io/install/kuadrant-operator.yaml\nkubectl get crd --watch | grep -m 1 \"kuadrants.kuadrant.io\"\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#request-a-kuadrant-instance","title":"Request a Kuadrant instance","text":"<pre><code>kubectl create namespace kuadrant-system\nkubectl -n kuadrant-system apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant\nspec: {}\nEOF\n</code></pre> <p>Kuadrant should now install. You can check the operator's install status with:</p> <pre><code>kubectl wait --for=jsonpath='{.status.state}'=AtLatestKnown subscription/my-kuadrant-operator -n operators --timeout=600s\n</code></pre> <p>Kuadrant is now ready to use.</p>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#optional-dnspolicy-setup","title":"(Optional) <code>DNSPolicy</code> setup","text":"<p>If you plan to use <code>DNSPolicy</code>, you will need an AWS Account with access to Route 53 (more providers coming soon), and a hosted zone.</p> <p>Export the following environment variables for setup:</p> <pre><code>export AWS_ACCESS_KEY_ID=xxxxxxx # Key ID from AWS with Route 53 access\nexport AWS_SECRET_ACCESS_KEY=xxxxxxx # Access key from AWS with Route 53 access\n</code></pre> <p>Create an AWS credentials secret:</p> <pre><code>kubectl -n kuadrant-system create secret generic aws-credentials \\\n  --type=kuadrant.io/aws \\\n  --from-literal=AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \\\n  --from-literal=AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#optional-multi-cluster-ratelimitpolicy","title":"(Optional) Multi-cluster <code>RateLimitPolicy</code>","text":"<p>To enable <code>RateLimitPolicy</code> to use shared, multi-cluster counters for Kuadrant's Limitador component, you need to configure Kuadrant with a Redis cluster URL. Redis URIs can be either <code>redis://</code> for standard connections or <code>rediss://</code> for secure connections.</p> <p>Follow these steps to create the necessary secret:</p> <ol> <li> <p>Replace <code>some-redis.com:6379</code> with the URL of your accessible Redis cluster. Ensure you include the appropriate URI scheme (<code>redis://</code> or <code>rediss://</code>).</p> </li> <li> <p>Execute the following commands:</p> <pre><code># Replace this with an accessible Redis cluster URL\nexport REDIS_URL=redis://user:xxxxxx@some-redis.com:6379\n\nkubectl -n kuadrant-system create secret generic redis-config \\\n  --from-literal=URL=$REDIS_URL\n</code></pre> </li> </ol> <p>This will create a secret named <code>redis-config</code> in the <code>kuadrant-system</code> namespace containing your Redis cluster URL, which Kuadrant will use for multi-cluster rate limiting.</p> <p>You'll also need to update your earlier created <code>Kuadrant</code> instance to reconfigure Kuadrant to use Redis:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant\n  namespace: kuadrant-system\nspec:\n  limitador:\n    storage:\n      redis-cached:\n        configSecretRef:\n          name: redis-config \nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-kubernetes/#next-steps","title":"Next Steps","text":"<ul> <li>Secure, protect, and connect APIs with Kuadrant on Kubernetes</li> </ul>"},{"location":"kuadrant-operator/doc/install/install-openshift/","title":"Install Kuadrant on an OpenShift cluster","text":"<p>Note</p> <p>You must perform these steps on each OpenShift cluster that you want to use Kuadrant on.</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#prerequisites","title":"Prerequisites","text":"<ul> <li>OpenShift Container Platform 4.14.x or later with community Operator catalog available.</li> <li>AWS account with Route 53 and zone.</li> <li>Accessible Redis instance.</li> </ul>"},{"location":"kuadrant-operator/doc/install/install-openshift/#procedure","title":"Procedure","text":""},{"location":"kuadrant-operator/doc/install/install-openshift/#step-1-set-up-your-environment","title":"Step 1 - Set up your environment","text":"<pre><code>export AWS_ACCESS_KEY_ID=xxxxxxx # Key ID from AWS with Route 53 access\nexport AWS_SECRET_ACCESS_KEY=xxxxxxx # Access key from AWS with Route 53 access\nexport REDIS_URL=redis://user:xxxxxx@some-redis.com:10340 # A Redis cluster URL\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-openshift/#step-2-install-gateway-api-v1","title":"Step 2 - Install Gateway API v1","text":"<p>Before you can use Kuadrant, you must install Gateway API v1 as follows:</p> <pre><code>kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.0.0/standard-install.yaml\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-openshift/#step-3-install-cert-manager","title":"Step 3 - Install cert-manager","text":"<p>Before you can use Kuadrant, you must install cert-manager.</p> <p>The minimum supported version of cert-manager is v1.12.1.</p> <p>Install one of the different flavours of the Cert-Manager.</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#install-community-version-of-the-cert-manager","title":"Install community version of the cert-manager","text":"<p>Consider installing cert-manager via OperatorHub, which you can do from the OpenShift web console.</p> <p>More installation options at cert-manager.io</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#install-cert-manager-operator-for-red-hat-openshift","title":"Install cert-manager Operator for Red Hat OpenShift","text":"<p>You can install the cert-manager Operator for Red Hat OpenShift by using the web console.</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#step-4-install-and-configure-istio-with-the-sail-operator","title":"Step 4 - Install and configure Istio with the Sail Operator","text":"<p>Kuadrant integrates with Istio as a Gateway API provider. You can set up an Istio-based Gateway API provider by using the Sail Operator.</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#install-istio","title":"Install Istio","text":"<p>To install the Istio Gateway provider, run the following commands:</p> <pre><code>kubectl create ns istio-system\n</code></pre> <pre><code>kubectl  apply -f - &lt;&lt;EOF\nkind: OperatorGroup\napiVersion: operators.coreos.com/v1\nmetadata:\n  name: sail\n  namespace: istio-system\nspec:\n  upgradeStrategy: Default\n---\napiVersion: operators.coreos.com/v1alpha1\nkind: Subscription\nmetadata:\n  name: sailoperator\n  namespace: istio-system\nspec:\n  channel: 3.0-dp1\n  installPlanApproval: Automatic\n  name: sailoperator\n  source: community-operators\n  sourceNamespace: openshift-marketplace\nEOF\n</code></pre> <p>Check the status of the installation as follows:</p> <pre><code>kubectl get installplan -n istio-system -o=jsonpath='{.items[0].status.phase}'\n</code></pre> <p>When ready, the status will change from <code>installing</code> to <code>complete</code>.</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#configure-istio","title":"Configure Istio","text":"<p>To configure the Istio Gateway API provider, run the following command:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: operator.istio.io/v1alpha1\nkind: Istio\nmetadata:\n  name: default\nspec:\n  version: v1.21.0\n  namespace: istio-system\n  # Disable autoscaling to reduce dev resources\n  values:\n    pilot:\n      autoscaleEnabled: false\nEOF\n</code></pre> <p>Wait for Istio to be ready as follows:</p> <pre><code>kubectl wait istio/default -n istio-system --for=\"condition=Ready=true\"\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-openshift/#step-5-optional-configure-observability-and-metrics","title":"Step 5 - Optional: Configure observability and metrics","text":"<p>Kuadrant provides a set of example dashboards that use known metrics exported by Kuadrant and Gateway components to provide insight into different components of your APIs and Gateways. While not essential, it is best to set up an OpenShift monitoring stack. This section provides links to OpenShift and Thanos documentation on configuring monitoring and metrics storage.</p> <p>You can set up user-facing monitoring by following the steps in the OpenShift documentation on configuring the monitoring stack.</p> <p>If you have user workload monitoring enabled, it is best to configure remote writes to a central storage system such as Thanos:</p> <ul> <li>OpenShift remote write configuration</li> <li>Kube Thanos</li> </ul> <p>The example dashboards and alerts for observing Kuadrant functionality use low-level CPU metrics and network metrics available from the user monitoring stack in OpenShift. They also use resource state metrics from Gateway API and Kuadrant resources. </p> <p>To scrape these additional metrics, you can install a <code>kube-state-metrics instance</code>, with a custom resource configuration as follows:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/config/observability/openshift/kube-state-metrics.yaml\nkubectl apply -k https://github.com/Kuadrant/gateway-api-state-metrics?ref=main\n</code></pre> <p>To enable request metrics in Istio, you must create a <code>telemetry</code> resource as follows:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/config/observability/openshift/telemetry.yaml\n</code></pre> <p>If you have Grafana installed in your cluster, you can import the example dashboards and alerts.</p> <p>For example installation details, see installing Grafana on OpenShift. When installed, you must add your Thanos instance as a data source to Grafana. Alternatively, if you are using only the user workload monitoring stack in your OpenShift cluster, and not writing metrics to an external Thanos instance, you can set up a data source to the thanos-querier route in the OpenShift cluster.</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#step-6-create-secrets-for-your-credentials","title":"Step 6 - Create secrets for your credentials","text":"<p>Before installing the Kuadrant Operator, you must enter the following commands to set up secrets that you will use later:</p> <pre><code>kubectl create ns kuadrant-system\n</code></pre> <p>Set up a <code>CatalogSource</code> as follows:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: operators.coreos.com/v1alpha1\nkind: CatalogSource\nmetadata:\n  name: kuadrant-operator-catalog\n  namespace: kuadrant-system\nspec:\n  sourceType: grpc\n  image: quay.io/kuadrant/kuadrant-operator-catalog:v0.7.1\n  displayName: Kuadrant Operators\n  publisher: grpc\n  updateStrategy:\n    registryPoll:\n      interval: 45m\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-openshift/#aws-route-53-credentials-for-tls","title":"AWS Route 53 credentials for TLS","text":"<p>Set the AWS Route 53 credentials for TLS verification as follows:</p> <pre><code>kubectl -n kuadrant-system create secret generic aws-credentials \\\n  --type=kuadrant.io/aws \\\n  --from-literal=AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \\\n  --from-literal=AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-openshift/#redis-credentials-for-rate-limiting-counters","title":"Redis credentials for rate limiting counters","text":"<p>Set the Redis credentials for shared multicluster counters for the Kuadrant Limitador component as follows:</p> <pre><code>kubectl -n kuadrant-system create secret generic redis-config \\\n  --from-literal=URL=$REDIS_URL\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-openshift/#aws-route-53-credentials-for-dns","title":"AWS Route 53 credentials for DNS","text":"<p>Set the AWS Route 53 credentials for managing DNS records as follows:</p> <pre><code>kubectl create ns ingress-gateway\n</code></pre> <pre><code>kubectl -n ingress-gateway create secret generic aws-credentials \\\n  --type=kuadrant.io/aws \\\n  --from-literal=AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \\\n  --from-literal=AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY\n</code></pre>"},{"location":"kuadrant-operator/doc/install/install-openshift/#step-7-install-the-kuadrant-operator","title":"Step 7 - Install the Kuadrant Operator","text":"<p>To install the Kuadrant Operator, enter the following command:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: operators.coreos.com/v1alpha1\nkind: Subscription\nmetadata:\n  name: kuadrant-operator\n  namespace: kuadrant-system\nspec:\n  channel: preview\n  installPlanApproval: Automatic\n  name: kuadrant-operator\n  source: kuadrant-operator-catalog\n  sourceNamespace: kuadrant-system\n---\nkind: OperatorGroup\napiVersion: operators.coreos.com/v1\nmetadata:\n  name: kuadrant\n  namespace: kuadrant-system\nspec:\n  upgradeStrategy: Default\nEOF\n</code></pre> <p>Wait for the Kuadrant Operators to be installed as follows:</p> <pre><code>kubectl get installplan -n kuadrant-system -o=jsonpath='{.items[0].status.phase}'\n</code></pre> <p>After some time, this command should return <code>complete</code>.</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#step-8-configure-kuadrant","title":"Step 8 - Configure Kuadrant","text":"<p>To configure your Kuadrant deployment, enter the following command:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant\n  namespace: kuadrant-system\nspec:\n  limitador:\n    storage:\n      redis-cached:\n        configSecretRef:\n          name: redis-config\nEOF\n</code></pre> <p>Wait for Kuadrant to be ready as follows:</p> <pre><code>kubectl wait kuadrant/kuadrant --for=\"condition=Ready=true\" -n kuadrant-system --timeout=300s\n</code></pre> <p>Kuadrant is now ready to use.</p>"},{"location":"kuadrant-operator/doc/install/install-openshift/#next-steps","title":"Next steps","text":"<ul> <li>Secure, protect, and connect APIs with Kuadrant on OpenShift</li> </ul>"},{"location":"kuadrant-operator/doc/observability/examples/","title":"Example Dashboards and Alerts","text":"<p>Explore a variety of starting points for monitoring your Kuadrant installation with our examples folder. These dashboards and alerts are ready-to-use and easily customizable to fit your environment.</p> <p>There are some example dashboards uploaded to Grafana.com . You can use the ID's listed below to import these dashboards into Grafana:</p> Name ID App Developer Dashboard <code>21538</code> Business User Dashboard <code>20981</code> Platform Engineer Dashboard <code>20982</code>"},{"location":"kuadrant-operator/doc/observability/examples/#dashboards","title":"Dashboards","text":""},{"location":"kuadrant-operator/doc/observability/examples/#importing-dashboards-into-grafana","title":"Importing Dashboards into Grafana","text":"<p>For more details on how to import dashboards into Grafana, visit the import dashboards page. </p> <ul> <li>UI Method:<ul> <li>JSON -  Use the 'Import' feature in the Grafana UI to upload dashboard JSON files directly.</li> <li>ID - Use the 'Import' feature in the Grafana UI to import via Grafana.com using a Dashboard ID. </li> </ul> </li> <li>ConfigMap Method: Automate dashboard provisioning by adding files to a ConfigMap, which should be mounted at <code>/etc/grafana/provisioning/dashboards</code>.</li> </ul> <p>Datasources are configured as template variables, automatically integrating with your existing data sources. Metrics for these dashboards are sourced from Prometheus. For more details on the metrics used, visit the metrics documentation page.</p>"},{"location":"kuadrant-operator/doc/observability/examples/#alerts","title":"Alerts","text":""},{"location":"kuadrant-operator/doc/observability/examples/#setting-up-alerts-in-prometheus","title":"Setting Up Alerts in Prometheus","text":"<p>You can integrate the example alerts into Prometheus as <code>PrometheusRule</code> resources. Feel free to adjust alert thresholds to suit your specific operational needs.</p> <p>Additionally, Service Level Objective (SLO) alerts generated with Sloth are included. A benefit of these alerts is the ability to integrate them with this SLO dashboard, which utilizes generated labels to comprehensively overview your SLOs.</p> <p>Further information on the metrics used for these alerts can be found on the metrics page.</p>"},{"location":"kuadrant-operator/doc/observability/metrics/","title":"Metrics","text":"<p>This is a reference page for some of the different metrics used in example dashboards and alerts. It is not an exhaustive list. The documentation for each component may provide more details on a per-component basis. Some of the metrics are sourced from components outside the Kuadrant project, for example, Envoy. The value of this reference is showing some of the more widely desired metrics, and how to join the metrics from different sources together in a meaningful way.</p>"},{"location":"kuadrant-operator/doc/observability/metrics/#metrics-sources","title":"Metrics sources","text":"<ul> <li>Kuadrant components</li> <li>Istio</li> <li>Envoy</li> <li>Kube State Metrics</li> <li>Gateway API State Metrics</li> <li>Kubernetes metrics</li> </ul>"},{"location":"kuadrant-operator/doc/observability/metrics/#resource-usage-metrics","title":"Resource usage metrics","text":"<p>Resource metrics, like CPU, memory and disk usage, primarily come from the Kubernetes metrics components. These include <code>container_cpu_usage_seconds_total</code>, <code>container_memory_working_set_bytes</code> and <code>kubelet_volume_stats_used_bytes</code>. A stable list of metrics is maintained in the Kubernetes repository. These low-level metrics typically have a set of recording rules that aggregate values by labels and time ranges. For example, <code>node_namespace_pod_container:container_cpu_usage_seconds_total:sum_irate</code> or <code>namespace_workload_pod:kube_pod_owner:relabel</code>. If you have deployed the kube-prometheus project, you should have the majority of  these metrics being scraped.</p>"},{"location":"kuadrant-operator/doc/observability/metrics/#networking-metrics","title":"Networking metrics","text":"<p>Low-level networking metrics like <code>container_network_receive_bytes_total</code> are also available from the Kubernetes metrics components. HTTP &amp; GRPC traffic metrics with higher level labels are available from Istio. One of the main metrics would be <code>istio_requests_total</code>, which is a counter incremented for every request handled by an Istio proxy. Latency metrics are available via the <code>istio_request_duration_milliseconds</code> metric, with buckets for varying response times.</p> <p>Some example dashboards have panels that make use of the request URL path. The path is not added as a label to Istio metrics by default, as it has the potential to increase metric cardinality, and thus storage requirements. If you want to make use of the path in your queries or visualisations, you can enable the request path metric via the Telemetry resource in istio:</p> <pre><code>apiVersion: telemetry.istio.io/v1alpha1\nkind: Telemetry\nmetadata:\n  name: namespace-metrics\n  namespace: istio-system\nspec:\n  metrics:\n\n  - providers:\n    - name: prometheus\n    overrides:\n    - match:\n        metric: REQUEST_COUNT\n      tagOverrides:\n        request_url_path:\n          value: \"request.url_path\"\n    - match:      \n        metric: REQUEST_DURATION\n      tagOverrides:\n        request_url_path:\n          value: \"request.url_path\"\n</code></pre>"},{"location":"kuadrant-operator/doc/observability/metrics/#state-metrics","title":"State metrics","text":"<p>The kube-state-metrics project exposes the state of various kuberenetes resources as metrics and labels. For example, the ready <code>status</code> of a <code>Pod</code> is available as <code>kube_pod_status_ready</code>, with labels for the pod <code>name</code> and <code>namespace</code>. This can be useful for linking lower level container metrics back to a meaningful resource in the Kubernetes world.</p>"},{"location":"kuadrant-operator/doc/observability/metrics/#joining-metrics","title":"Joining metrics","text":"<p>Metric queries can be as simple as just the name of the metric, or can be complex with joining &amp; grouping. A lot of the time it can be useful to tie back low level metrics to more meaningful Kubernetes resources. For example, if the memory usage is maxed out on a container and that container is constantly being OOMKilled, it can be useful to get the Deployment and Namespace of that container for debugging. Prometheus query language (or promql) allows vector matching or results (sometimes called joining).</p> <p>When using Gateway API and Kuadrant resources like HTTPRoute and RateLimitPolicy, the state metrics can be joined to Istio metrics to give a meaningful result set. Here's an example that queries the number of requests per second, and includes the name of the HTTPRoute that the traffic is for.</p> <pre><code>sum(\n    rate(\n        istio_requests_total{}[5m]\n    )\n) by (destination_service_name)\n\n\n* on(destination_service_name) group_right \n    label_replace(gatewayapi_httproute_labels{}, \\\"destination_service_name\\\", \\\"$1\\\",\\\"service\\\", \\\"(.+)\\\")\n</code></pre> <p>Breaking this query down, there are 2 parts. The first part is getting the rate of requests hitting the Istio gateway, aggregated to 5m intervals:</p> <pre><code>sum(\n    rate(\n        destination_service_name{}[5m]\n    )\n) by (destination_service_name)\n</code></pre> <p>The result set here will include a label for the destination service name (i.e. the Service in Kubernetes). This label is key to looking up the HTTPRoute this traffic belongs to.</p> <p>The 2nd part of the query uses the <code>gatewayapi_httproute_labels</code> metric and the <code>label_replace</code> function. The <code>gatewayapi_httproute_labels</code> metric gives a list of all httproutes, including any labels on them. The HTTPRoute in this example has a label called 'service', set to be the same as the Istio service name. This allows us to join the 2 results set. However, because the label doesn't match exactly (<code>destination_service_name</code> and <code>service</code>), we can replace the label so that it does match. That's what the <code>label_replace</code> does.</p> <pre><code>    label_replace(gatewayapi_httproute_labels{}, \\\"destination_service_name\\\", \\\"$1\\\",\\\"service\\\", \\\"(.+)\\\")\n</code></pre> <p>The 2 parts are joined together using vector matching.</p> <pre><code>* on(destination_service_name) group_right \n</code></pre> <ul> <li><code>*</code> is the binary operator i.e. multiplication (gives join like behaviour)</li> <li><code>on()</code> specifies which labels to \"join\" the 2 results with</li> <li><code>group_right</code> enables a one to many matching.</li> </ul> <p>See the Prometheus documentation for further details on matching.</p>"},{"location":"kuadrant-operator/doc/observability/tracing/","title":"Enabling tracing with a central collector","text":""},{"location":"kuadrant-operator/doc/observability/tracing/#introduction","title":"Introduction","text":"<p>This guide outlines the steps to enable tracing in Istio and Kuadrant components (Authorino and Limitador), directing traces to a central collector for improved observability and troubleshooting. We'll also explore a typical troubleshooting flow using traces and logs.</p>"},{"location":"kuadrant-operator/doc/observability/tracing/#prerequisites","title":"Prerequisites","text":"<ul> <li>A Kubernetes cluster with Istio and Kuadrant installed.</li> <li>A trace collector (e.g., Jaeger or Tempo) configured to support OpenTelemetry (OTel).</li> </ul>"},{"location":"kuadrant-operator/doc/observability/tracing/#configuration-steps","title":"Configuration Steps","text":""},{"location":"kuadrant-operator/doc/observability/tracing/#istio-tracing-configuration","title":"Istio Tracing Configuration","text":"<p>Enable tracing in Istio by using the Telemetry API. Depending on your method for installing Istio, you will need to configure a tracing <code>extensionProvider</code> in your MeshConfig, Istio or IstioOperator resource as well. Here is an example Telemetry and Istio config to sample 100% of requests, if using the Istio Sail Operator.</p> <pre><code>apiVersion: telemetry.istio.io/v1alpha1\nkind: Telemetry\nmetadata:\n  name: mesh-default\n  namespace: istio-system\nspec:\n  tracing:\n\n  - providers:\n    - name: tempo-otlp\n    randomSamplingPercentage: 100\n---\napiVersion: operator.istio.io/v1alpha1\nkind: Istio\nmetadata:\n  name: default\nspec:\n  namespace: istio-system\n  values:\n    meshConfig:\n      defaultConfig:\n        tracing: {}\n      enableTracing: true\n      extensionProviders:\n      - name: tempo-otlp\n        opentelemetry:\n          port: 4317\n          service: tempo.tempo.svc.cluster.local\n</code></pre> <p>Important:</p> <p>The OpenTelemetry collector protocol should be explicitly set in the service port <code>name</code> or <code>appProtocol</code> fields as per the Istio documentation. For example, when using gRPC, the port <code>name</code> should begin with <code>grpc-</code> or the <code>appProtocol</code> should be <code>grpc</code>.</p>"},{"location":"kuadrant-operator/doc/observability/tracing/#kuadrant-tracing-configuration","title":"Kuadrant Tracing Configuration","text":"<p>The Authorino and Limitador components have request tracing capabilities. Here is an example configuration to enable and send traces to a central collector. Ensure the collector is the same one that Istio is sending traces so that they can be correlated later.</p> <pre><code>apiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  tracing:\n    endpoint: rpc://tempo.tempo.svc.cluster.local:4317\n    insecure: true\n---\napiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador\nspec:\n  tracing:\n    endpoint: rpc://tempo.tempo.svc.cluster.local:4317\n</code></pre> <p>Once the changes are applied, the authorino and limitador components will be redeployed tracing enabled.</p> <p>Note:</p> <p>There are plans to consolidate the tracing configuration to a single location i.e. the Kuadrant CR. This will eventually eliminate the need to configure tracing in both the Authorino and Limitador CRs.</p> <p>Important:</p> <p>Currently, trace IDs do not propagate to wasm modules in Istio/Envoy, affecting trace continuity in Limitador. This means that requests passed to limitador will not have the relavant 'parent' trace ID in its trace information. If however the trace initiation point is outside of Envoy/Istio, the 'parent' trace ID will be available to limitador and included in traces passed to the collector. This has an impact on correlating traces from limitador with traces from authorino, the gateway and any other components in the path of requests.</p>"},{"location":"kuadrant-operator/doc/observability/tracing/#troubleshooting-flow-using-traces-and-logs","title":"Troubleshooting Flow Using Traces and Logs","text":"<p>Using a tracing interface like the Jaeger UI or Grafana, you can search for trace information by the trace ID. You may get the trace ID from logs, or from a header in a sample request you want to troubleshoot. You can also search for recent traces, filtering by the service you want to focus on.</p> <p>Here is an example trace in the Grafana UI showing the total request time from the gateway (Istio), the time to check the curent rate limit count (and update it) in limitador and the time to check auth in Authorino:</p> <p></p> <p>In limitador, it is possible to enable request logging with trace IDs to get more information on requests. This requires the log level to be increased to at least debug, so the verbosity must be set to 3 or higher in the Limitador CR. For example:</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador\nspec:\n  verbosity: 3\n</code></pre> <p>A log entry will look something like this, with the <code>traceparent</code> field holding the trace ID:</p> <pre><code>\"Request received: Request { metadata: MetadataMap { headers: {\"te\": \"trailers\", \"grpc-timeout\": \"5000m\", \"content-type\": \"application/grpc\", \"traceparent\": \"00-4a2a933a23df267aed612f4694b32141-00f067aa0ba902b7-01\", \"x-envoy-internal\": \"true\", \"x-envoy-expected-rq-timeout-ms\": \"5000\"} }, message: RateLimitRequest { domain: \"default/toystore\", descriptors: [RateLimitDescriptor { entries: [Entry { key: \"limit.general_user__f5646550\", value: \"1\" }, Entry { key: \"metadata.filter_metadata.envoy\\\\.filters\\\\.http\\\\.ext_authz.identity.userid\", value: \"alice\" }], limit: None }], hits_addend: 1 }, extensions: Extensions }\"\n</code></pre> <p>If you centrally aggregate logs using something like promtail and loki, you can jump between trace information and the relevant logs for that service:</p> <p></p> <p>Using a combination of tracing and logs, you can visualise and troubleshoot reuqest timing issues and drill down to specific services. This method becomes even more powerful when combined with metrics and dashboards to get a more complete picture of your users traffic.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/","title":"RLP can target a Gateway resource","text":"<p>Previous version: https://hackmd.io/IKEYD6NrSzuGQG1nVhwbcw</p> <p>Based on: https://hackmd.io/_1k6eLCNR2eb9RoSzOZetg</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#introduction","title":"Introduction","text":"<p>The current RateLimitPolicy CRD already implements a <code>targetRef</code> with a reference to Gateway API's HTTPRoute. This doc  captures the design and some implementation details of allowing the <code>targetRef</code> to reference a Gateway API's Gateway.</p> <p>Having in place this HTTPRoute - Gateway hierarchy, we are also considering to apply Policy Attachment's defaults/overrides approach to the RateLimitPolicy CRD. But for now, it will only be about targeting the Gateway resource.</p> <p></p> <p>On designing Kuadrant's rate limiting and considering Istio/Envoy's rate limiting offering, we hit two limitations (described here). Therefore, not giving up entirely in existing Envoy's RateLimit Filter, we decided to move on and leverage the Envoy's Wasm Network Filter and implement rate limiting wasm-shim module compliant with the Envoy's Rate Limit Service (RLS). This wasm-shim module accepts a PluginConfig struct object as input configuration object.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#use-cases-targeting-a-gateway","title":"Use Cases targeting a gateway","text":"<p>A key use case is being able to provide governance over what service providers can and cannot do when exposing a service via a shared ingress gateway. As well as providing certainty that no service is exposed without my ability as a cluster administrator to protect my infrastructure from unplanned load from badly behaving clients etc.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#goals","title":"Goals","text":"<p>The goal of this document is to define:</p> <ul> <li>The schema of this <code>PluginConfig</code> struct.</li> <li>The kuadrant-operator behavior filling the <code>PluginConfig</code> struct having as input the RateLimitPolicy k8s objects</li> <li>The behavior of the wasm-shim having the <code>PluginConfig</code> struct as input.</li> </ul>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#envoys-rate-limit-service-protocol","title":"Envoy's Rate Limit Service Protocol","text":"<p>Kuadrant's rate limit relies on the Rate Limit Service (RLS) protocol, hence the gateway generates, based on a set of actions, a set of descriptors (one descriptor is a set of descriptor entries). Those descriptors are send to the external rate limit service provider. When multiple descriptors are provided, the external service provider will limit on ALL of them and return an OVER_LIMIT response if any of them are over limit.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#schema-crd-of-the-ratelimitpolicy","title":"Schema (CRD) of the RateLimitPolicy","text":"<pre><code>---\napiVersion: kuadrant.io/v1beta1\nkind: RateLimitPolicy\nmetadata:\n  name: my-rate-limit-policy\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute / Gateway\n    name: myroute / mygateway\n  rateLimits:\n\n    - rules:\n        - paths: [\"/admin/*\"]\n          methods: [\"GET\"]\n          hosts: [\"example.com\"]\n      configurations:\n        - actions:\n          - generic_key:\n              descriptor_key: admin\n              descriptor_value: \"yes\"\n      limits:\n        - conditions: [\"admin == yes\"]\n          max_value: 500\n          seconds: 30\n          variables: []\n</code></pre> <p><code>.spec.rateLimits</code> holds a list of rate limit configurations represented by the object <code>RateLimit</code>. Each <code>RateLimit</code> object represents a complete rate limit configuration. It contains three fields:</p> <ul> <li> <p><code>rules</code> (optional): Rules allow matching <code>hosts</code> and/or <code>methods</code> and/or <code>paths</code>. Matching occurs when at least one rule applies against the incoming request. If rules are not set, it is equivalent to matching all the requests.</p> </li> <li> <p><code>configurations</code> (required): Specifies a set of rate limit configurations that could be applied. The rate limit configuration object is the equivalent of the config.route.v3.RateLimit envoy object. One configuration is, in turn, a list of rate limit actions. Each action populates a descriptor entry. A vector of descriptor entries compose a descriptor. Each configuration produces, at most, one descriptor. Depending on the incoming request, one configuration may or may not produce a rate limit descriptor. These rate limiting configuration rules provide flexibility to produce multiple descriptors. For example, you may want to define one generic rate limit descriptor and another descriptor depending on some header. If the header does not exist, the second descriptor is not generated, but traffic keeps being rate limited based on the generic descriptor.</p> </li> </ul> <pre><code>configurations:\n\n  - actions:\n    - request_headers:\n        header_name: \"X-MY-CUSTOM-HEADER\"\n        descriptor_key: \"custom-header\"\n        skip_if_absent: true\n  - actions:\n    - generic_key:\n        descriptor_key: admin\n        descriptor_value: \"1\"\n</code></pre> <ul> <li><code>limits</code> (optional): configuration of the rate limiting service (Limitador). Check out limitador documentation for more information about the fields of each <code>Limit</code> object.</li> </ul> <p>Note: No <code>namespace</code>/<code>domain</code> defined. Kuadrant operator will figure out.</p> <p>Note: There is no <code>PREAUTH</code>, <code>POSTAUTH</code> stage defined. Ratelimiting filter should be placed after authorization filter to enable authenticated rate limiting. In the future, <code>stage</code> can be implemented.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#kuadrant-operators-behavior","title":"Kuadrant-operator's behavior","text":"<p>One HTTPRoute can only be targeted by one rate limit policy.</p> <p>Similarly, one Gateway can only be targeted by one rate limit policy.</p> <p>However, indirectly, one gateway will be affected by multiple rate limit policies. It is by design of the Gateway API, one gateway can be referenced by multiple HTTPRoute objects. Furthermore, one HTTPRoute can reference multiple gateways.</p> <p>The kuadrant operator will aggregate all the rate limit policies that apply for each gateway, including RLP targeting HTTPRoutes and Gateways.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#virtualhosting-ratelimitpolicies","title":"\"VirtualHosting\" RateLimitPolicies","text":"<p>Rate limit policies are scoped by the domains defined at the referenced HTTPRoute's hostnames and Gateway's Listener's Hostname.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#multiple-httproutes-with-the-same-hostname","title":"Multiple HTTPRoutes with the same hostname","text":"<p>When there are multiple HTTPRoutes with the same hostname, HTTPRoutes are all admitted and envoy merge the routing configuration in the same virtualhost. In these cases, the control plane has to \"merge\" the rate limit configuration into a single entry for the wasm filter.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#overlapping-httproutes","title":"Overlapping HTTPRoutes","text":"<p>If some RLP targets a route for <code>*.com</code> and other RLP targets another route for <code>api.com</code>, the control plane does not do any merging. A request coming for <code>api.com</code> will be rate limited with the rules from the RLP targeting the route <code>api.com</code>. Also, a request coming for <code>other.com</code> will be rate limited with the rules from the RLP targeting the route <code>*.com</code>.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#examples","title":"examples","text":"<p>RLP A -&gt; HTTPRoute A (<code>api.toystore.com</code>) -&gt; Gateway G (<code>*.com</code>)</p> <p>RLP B -&gt; HTTPRoute B (<code>other.toystore.com</code>) -&gt; Gateway G (<code>*.com</code>)</p> <p>RLP H -&gt; HTTPRoute H (<code>*.toystore.com</code>) -&gt; Gateway G (<code>*.com</code>)</p> <p>RLP G -&gt; Gateway G (<code>*.com</code>)</p> <p>Request 1 (<code>api.toystore.com</code>) -&gt; apply RLP A and RLP G</p> <p>Request 2 (<code>other.toystore.com</code>) -&gt; apply RLP B and RLP G</p> <p>Request 3 (<code>unknown.toystore.com</code>) -&gt; apply RLP H and RLP G</p> <p>Request 4 (<code>other.com</code>) -&gt; apply RLP G</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#rate-limit-domain-limitador-namespace","title":"rate limit domain / limitador namespace","text":"<p>The kuadrant operator will add <code>domain</code> attribute of the Envoy's Rate Limit Service (RLS). It will also add the <code>namespace</code> attribute of the Limitador's rate limit config. The operator will ensure that the associated actions and rate limits have a common domain/namespace.</p> <p>The value of this domain/namespace seems to be related to the virtualhost for which rate limit applies.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#schema-of-the-wasm-filter-configuration-object-the-pluginconfig","title":"Schema of the WASM filter configuration object: the <code>PluginConfig</code>","text":"<p>Currently the PluginConfig looks like this:</p> <pre><code>#  The filter\u2019s behaviour in case the rate limiting service does not respond back. When it is set to true, Envoy will not allow traffic in case of communication failure between rate limiting service and the proxy.\nfailure_mode_deny: true\nratelimitpolicies:\n  default/toystore: # rate limit policy {NAMESPACE/NAME}\n    hosts: # HTTPRoute hostnames\n\n      - '*.toystore.com'\n    rules: # route level actions\n      - operations:\n          - paths:\n              - /admin/toy\n            methods:\n              - POST\n              - DELETE\n        actions:\n          - generic_key:\n              descriptor_value: yes\n              descriptor_key: admin\n    global_actions: # virtualHost level actions\n      - generic_key:\n          descriptor_value: yes\n          descriptor_key: vhaction\n    upstream_cluster: rate-limit-cluster # Limitador address reference\n    domain: toystore-app # RLS protocol domain value\n</code></pre> <p>Proposed new design for the WASM filter configuration object (<code>PluginConfig</code> struct):</p> <pre><code>#  The filter\u2019s behaviour in case the rate limiting service does not respond back. When it is set to true, Envoy will not allow traffic in case of communication failure between rate limiting service and the proxy.\nfailure_mode_deny: true\nrate_limit_policies:\n\n  - name: toystore\n    rate_limit_domain: toystore-app\n    upstream_cluster: rate-limit-cluster\n    hostnames: [\"*.toystore.com\"]\n    gateway_actions:\n      - rules:\n          - paths: [\"/admin/toy\"]\n            methods: [\"GET\"]\n            hosts: [\"pets.toystore.com\"]\n        configurations:\n          - actions:\n            - generic_key:\n                descriptor_key: admin\n                descriptor_value: \"1\"\n</code></pre> <p>Update highlights:</p> <ul> <li>[minor] <code>rate_limit_policies</code> is a list instead of a map indexed by the name/namespace.</li> <li>[major] no distinction between \"rules\" and global actions</li> <li>[major] more aligned with RLS: multiple descriptors structured by \"rate limit configurations\" with matching rules</li> </ul>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#wasm-shim","title":"WASM-SHIM","text":"<p>WASM filter rate limit policies are not exactly the same as user managed RateLimitPolicy custom resources. The WASM filter rate limit policies is part of the  internal configuration and therefore not exposed to the end user.</p> <p>At the WASM filter level, there are no route level or gateway level rate limit policies. The rate limit policies in the wasm plugin configuration may not map 1:1 to user managed RateLimitPolicy custom resources. WASM rate limit policies have an internal logical name and a set of hostnames to activate it based on the incoming request\u2019s host header.</p> <p>The WASM filter builds a tree based data structure holding the rate limit policies. The longest (sub)domain match is used to select the policy to be applied. Only one policy is being applied per invocation.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#rate-limit-configurations","title":"rate limit configurations","text":"<p>The WASM filter configuration object contains a list of rate limit configurations to build a list of Envoy's RLS descriptors. These configurations are defined at</p> <pre><code>rate_limit_policies[*].gateway_actions[*].configurations\n</code></pre> <p>For example:</p> <pre><code>configurations:\n\n- actions:\n   - generic_key:\n        descriptor_key: admin\n        descriptor_value: \"1\"\n</code></pre> <p>How to read the policy:</p> <ul> <li> <p>Each configuration produces, at most, one descriptor. Depending on the incoming request, one configuration may or may not produce a rate limit descriptor.</p> </li> <li> <p>Each policy configuration has associated, optionally, a set of rules to match. Rules allow matching <code>hosts</code> and/or <code>methods</code> and/or <code>paths</code>. Matching occurs when at least one rule applies against the incoming request. If rules are not set, it is equivalent to matching all the requests.</p> </li> <li> <p>Each configuration object defines a list of actions. Each action may (or may not) produce a descriptor entry (descriptor list item). If an action cannot append a descriptor entry, no descriptor is generated for the configuration.</p> </li> </ul> <p>Note: The external rate limit service will be called when the <code>gateway_actions</code> object produces at least one not empty descriptor.</p>"},{"location":"kuadrant-operator/doc/proposals/rlp-target-gateway-resource/#example","title":"example","text":"<p>WASM filter rate limit policy for <code>*.toystore.com</code>. I want some rate limit descriptors configuration only for <code>api.toystore.com</code> and another set of descriptors for <code>admin.toystore.com</code>. The wasm filter config would look like this:</p> <pre><code>failure_mode_deny: true\nrate_limit_policies:\n\n  - name: toystore\n    rate_limit_domain: toystore-app\n    upstream_cluster: rate-limit-cluster\n    hostnames: [\"*.toystore.com\"]\n    gateway_actions:\n      - configurations:  # no rules. Applies to all *.toystore.com traffic\n          - actions:\n              - generic_key:\n                  descriptor_key: toystore-app\n                  descriptor_value: \"1\"\n      - rules:\n          - hosts: [\"api.toystore.com\"]\n        configurations:\n          - actions:\n              - generic_key:\n                  descriptor_key: api\n                  descriptor_value: \"1\"\n      - rules:\n          - hosts: [\"admin.toystore.com\"]\n        configurations:\n          - actions:\n              - generic_key:\n                  descriptor_key: admin\n                  descriptor_value: \"1\"\n</code></pre> <ul> <li>When a request for <code>api.toystore.com</code> hits the filter, the descriptors generated would be:</li> </ul> <p>descriptor 1 <pre><code>(\"toystore-app\", \"1\")\n</code></pre> descriptor 2 <pre><code>(\"api\", \"1\")\n</code></pre></p> <ul> <li>When a request for <code>admin.toystore.com</code> hits the filter, the descriptors generated would be:</li> </ul> <p>descriptor 1 <pre><code>(\"toystore-app\", \"1\")\n</code></pre> descriptor 2 <pre><code>(\"admin\", \"1\")\n</code></pre></p> <ul> <li>When a request for <code>other.toystore.com</code> hits the filter, the descriptors generated would be: descriptor 1 <pre><code>(\"toystore-app\", \"1\")\n</code></pre></li> </ul>"},{"location":"kuadrant-operator/doc/reference/authpolicy/","title":"The AuthPolicy Custom Resource Definition (CRD)","text":"<ul> <li>AuthPolicy</li> <li>AuthPolicySpec</li> <li>AuthScheme<ul> <li>AuthRuleCommon</li> <li>AuthenticationRule</li> <li>MetadataRule</li> <li>AuthorizationRule</li> <li>ResponseSpec</li> <li>SuccessResponseSpec<ul> <li>SuccessResponseItem</li> </ul> </li> <li>CallbackRule</li> </ul> </li> <li>NamedPattern</li> <li>AuthPolicyCommonSpec</li> <li>AuthPolicyStatus</li> <li>ConditionSpec</li> </ul>"},{"location":"kuadrant-operator/doc/reference/authpolicy/#authpolicy","title":"AuthPolicy","text":"Field Type Required Description <code>spec</code> AuthPolicySpec Yes The specification for AuthPolicy custom resource <code>status</code> AuthPolicyStatus No The status for the custom resource"},{"location":"kuadrant-operator/doc/reference/authpolicy/#authpolicyspec","title":"AuthPolicySpec","text":"Field Type Required Description <code>targetRef</code> LocalPolicyTargetReference Yes Reference to a Kubernetes resource that the policy attaches to <code>rules</code> AuthScheme No Implicit default authentication/authorization rules <code>routeSelectors</code> []RouteSelector No List of implicit default selectors of HTTPRouteRules whose matching rules activate the policy. At least one HTTPRouteRule must be selected to activate the policy. If omitted, all HTTPRouteRules of the targeted HTTPRoute activate the policy. Do not use it in policies targeting a Gateway. <code>patterns</code> MapNamedPattern&gt; No Implicit default named patterns of lists of <code>selector</code>, <code>operator</code> and <code>value</code> tuples, to be reused in <code>when</code> conditions and pattern-matching authorization rules. <code>when</code> []PatternExpressionOrRef No List of implicit default additional dynamic conditions (expressions) to activate the policy. Use it for filtering attributes that cannot be expressed in the targeted HTTPRoute's <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or when targeting a Gateway. <code>defaults</code> AuthPolicyCommonSpec No Explicit default definitions. This field is mutually exclusive with any of the implicit default definitions: <code>spec.rules</code>, <code>spec.routeSelectors</code>, <code>spec.patterns</code>, <code>spec.when</code> <code>overrides</code> AuthPolicyCommonSpec No Atomic overrides definitions. This field is mutually exclusive with any of the implicit or explicit default definitions: <code>spec.rules</code>, <code>spec.routeSelectors</code>, <code>spec.patterns</code>, <code>spec.when</code>, <code>spec.default</code>"},{"location":"kuadrant-operator/doc/reference/authpolicy/#authpolicycommonspec","title":"AuthPolicyCommonSpec","text":"Field Type Required Description <code>rules</code> AuthScheme No Authentication/authorization rules <code>routeSelectors</code> []RouteSelector No List of selectors of HTTPRouteRules whose matching rules activate the policy. At least one HTTPRouteRule must be selected to activate the policy. If omitted, all HTTPRouteRules of the targeted HTTPRoute activate the policy. Do not use it in policies targeting a Gateway. <code>patterns</code> MapNamedPattern&gt; No Named patterns of lists of <code>selector</code>, <code>operator</code> and <code>value</code> tuples, to be reused in <code>when</code> conditions and pattern-matching authorization rules. <code>when</code> []PatternExpressionOrRef No List of additional dynamic conditions (expressions) to activate the policy. Use it for filtering attributes that cannot be expressed in the targeted HTTPRoute's <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or when targeting a Gateway."},{"location":"kuadrant-operator/doc/reference/authpolicy/#authscheme","title":"AuthScheme","text":"Field Type Required Description <code>authentication</code> MapAuthenticationRule&gt; No Authentication rules. At least one config MUST evaluate to a valid identity object for the auth request to be successful. If omitted or empty, anonymous access is assumed. <code>metadata</code> MapMetadataRule&gt; No Rules for fetching auth metadata from external sources. <code>authorization</code> MapAuthorizationRule&gt; No Authorization rules. All policies MUST allow access for the auth request be successful. <code>response</code> ResponseSpec No Customizations to the response to the authorization request. Use it to set custom values for unauthenticated, unauthorized, and/or success access request. <code>callbacks</code> MapCallbackRule&gt; No Rules for post-authorization callback requests to external services. Triggered regardless of the result of the authorization request."},{"location":"kuadrant-operator/doc/reference/authpolicy/#authrulecommon","title":"AuthRuleCommon","text":"Field Type Required Description <code>routeSelectors</code> []RouteSelector No List of selectors of HTTPRouteRules whose matching rules activate the auth rule. At least one HTTPRouteRule must be selected to activate the auth rule. If omitted, the auth rule is activated at all requests where the policy is enforced. Do not use it in policies targeting a Gateway. <code>when</code> []PatternExpressionOrRef No List of additional dynamic conditions (expressions) to activate the auth rule. Use it for filtering attributes that cannot be expressed in the targeted HTTPRoute's <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or when targeting a Gateway. <code>cache</code> Caching spec No Caching options for the resolved object returned when applying this auth rule. (Default: disabled) <code>priority</code> Integer No Priority group of the auth rule. All rules in the same priority group are evaluated concurrently; consecutive priority groups are evaluated sequentially. (Default: <code>0</code>) <code>metrics</code> Boolean No Whether the auth rule emits individual observability metrics. (Default: <code>false</code>)"},{"location":"kuadrant-operator/doc/reference/authpolicy/#authenticationrule","title":"AuthenticationRule","text":"Field Type Required Description <code>apiKey</code> API Key authentication spec No Authentication based on API keys stored in Kubernetes secrets. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>. <code>kubernetesTokenReview</code> KubernetesTokenReview spec No Authentication by Kubernetes token review. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>. <code>jwt</code> JWT verification spec No Authentication based on JSON Web Tokens (JWT). Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>. <code>oauth2Introspection</code> OAuth2 Token Introscpection spec No Authentication by OAuth2 token introspection. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>. <code>x509</code> X.509 authentication spec No Authentication based on client X.509 certificates. The certificates presented by the clients must be signed by a trusted CA whose certificates are stored in Kubernetes secrets. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>. <code>plain</code> Plain identity object spec No Identity object extracted from the context. Use this method when authentication is performed beforehand by a proxy and the resulting object passed to Authorino as JSON in the auth request. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>. <code>anonymous</code> Anonymous access No Anonymous access. Use one of: <code>apiKey</code>, <code>jwt</code>, <code>oauth2Introspection</code>, <code>kubernetesTokenReview</code>, <code>x509</code>, <code>plain</code>, <code>anonymous</code>. <code>credentials</code> Auth credentials spec No Customizations to where credentials are required to be passed in the request for authentication based on this auth rule. Defaults to HTTP Authorization header with prefix \"Bearer\". <code>overrides</code> Identity extension spec No JSON overrides to set to the resolved identity object. Do not use it with identity objects of other JSON types (array, string, etc). <code>defaults</code> Identity extension spec No JSON defaults to set to the resolved identity object. Do not use it with identity objects of other JSON types (array, string, etc). (inline) AuthRuleCommon No"},{"location":"kuadrant-operator/doc/reference/authpolicy/#metadatarule","title":"MetadataRule","text":"Field Type Required Description <code>http</code> HTTP GET/GET-by-POST external metadata spec No External source of auth metadata via HTTP request. Use one of: <code>http</code>, <code>userInfo</code>, <code>uma</code>. <code>userInfo</code> OIDC UserInfo spec No OpendID Connect UserInfo linked to an OIDC authentication rule declared in this same AuthPolicy. Use one of: <code>http</code>, <code>userInfo</code>, <code>uma</code>. <code>uma</code> UMA metadata spec No User-Managed Access (UMA) source of resource data.  Use one of: <code>http</code>, <code>userInfo</code>, <code>uma</code>. (inline) AuthRuleCommon No"},{"location":"kuadrant-operator/doc/reference/authpolicy/#authorizationrule","title":"AuthorizationRule","text":"Field Type Required Description <code>patternMatching</code> Pattern-matching authorization spec No Pattern-matching authorization rules. Use one of: <code>patternMatching</code>, <code>opa</code>, <code>kubernetesSubjectAccessReview</code>, <code>spicedb</code>. <code>opa</code> OPA authorization spec No Open Policy Agent (OPA) Rego policy. Use one of: <code>patternMatching</code>, <code>opa</code>, <code>kubernetesSubjectAccessReview</code>, <code>spicedb</code>. <code>kubernetesSubjectAccessReview</code> Kubernetes SubjectAccessReview spec No Authorization by Kubernetes SubjectAccessReview. Use one of: <code>patternMatching</code>, <code>opa</code>, <code>kubernetesSubjectAccessReview</code>, <code>spicedb</code>. <code>spicedb</code> SpiceDB authorization spec No Authorization decision delegated to external Authzed/SpiceDB server. Use one of: <code>patternMatching</code>, <code>opa</code>, <code>kubernetesSubjectAccessReview</code>, <code>spicedb</code>. (inline) AuthRuleCommon No"},{"location":"kuadrant-operator/doc/reference/authpolicy/#responsespec","title":"ResponseSpec","text":"Field Type Required Description <code>unauthenticated</code> Custom denial status spec No Customizations on the denial status and other HTTP attributes when the request is unauthenticated. (Default: <code>401 Unauthorized</code>) <code>unauthorized</code> Custom denial status spec No Customizations on the denial status and other HTTP attributes when the request is unauthorized. (Default: <code>403 Forbidden</code>) <code>success</code> SuccessResponseSpec No Response items to be included in the auth response when the request is authenticated and authorized."},{"location":"kuadrant-operator/doc/reference/authpolicy/#successresponsespec","title":"SuccessResponseSpec","text":"Field Type Required Description <code>headers</code> MapSuccessResponseItem&gt; No Custom success response items wrapped as HTTP headers to be injected in the request. <code>dynamicMetadata</code> MapSuccessResponseItem&gt; No Custom success response items wrapped as Envoy Dynamic Metadata. Use it to pass data along to other proxy filters, such as the rate-limit filter."},{"location":"kuadrant-operator/doc/reference/authpolicy/#successresponseitem","title":"SuccessResponseItem","text":"Field Type Required Description <code>plain</code> Plain text response item No Plain text content. Use one of: <code>plain</code>, <code>json</code>, <code>wristband</code>. <code>json</code> JSON injection response item No Specification of a JSON object. Use one of: <code>plain</code>, <code>json</code>, <code>wristband</code>. <code>wristband</code> Festival Wristband token response item No Specification of a JSON object. Use one of: <code>plain</code>, <code>json</code>, <code>wristband</code>. <code>key</code> String No The key used to add the custom response item (name of the HTTP header or root property of the Dynamic Metadata object). Defaults to the name of the response item if omitted."},{"location":"kuadrant-operator/doc/reference/authpolicy/#callbackrule","title":"CallbackRule","text":"Field Type Required Description <code>http</code> HTTP endpoints callback spec No HTTP endpoint settings to build the callback request (webhook). (inline) AuthRuleCommon No"},{"location":"kuadrant-operator/doc/reference/authpolicy/#namedpattern","title":"NamedPattern","text":"Field Type Required Description <code>selector</code> String Yes A valid Well-known attribute whose resolved value in the data plane will be compared to <code>value</code>, using the <code>operator</code>. <code>operator</code> String Yes The binary operator to be applied to the resolved value specified by the selector. One of: <code>eq</code> (equal to), <code>neq</code> (not equal to), <code>incl</code> (includes; for arrays), <code>excl</code> (excludes; for arrays), <code>matches</code> (regex). <code>value</code> String Yes The static value to be compared to the one resolved from the selector."},{"location":"kuadrant-operator/doc/reference/authpolicy/#authpolicystatus","title":"AuthPolicyStatus","text":"Field Type Description <code>observedGeneration</code> String Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec. <code>conditions</code> []ConditionSpec List of conditions that define that status of the resource."},{"location":"kuadrant-operator/doc/reference/authpolicy/#conditionspec","title":"ConditionSpec","text":"<ul> <li>The lastTransitionTime field provides a timestamp for when the entity last transitioned from one status to another.</li> <li>The message field is a human-readable message indicating details about the transition.</li> <li>The reason field is a unique, one-word, CamelCase reason for the condition\u2019s last transition.</li> <li>The status field is a string, with possible values True, False, and Unknown.</li> <li>The type field is a string with the following possible values:</li> <li>Available: the resource has successfully configured;</li> </ul> Field Type Description <code>type</code> String Condition Type <code>status</code> String Status: True, False, Unknown <code>reason</code> String Condition state reason <code>message</code> String Condition state description <code>lastTransitionTime</code> Timestamp Last transition timestamp"},{"location":"kuadrant-operator/doc/reference/dnspolicy/","title":"The DNSPolicy Custom Resource Definition (CRD)","text":"<ul> <li>DNSPolicy</li> <li>DNSPolicySpec<ul> <li>ProviderRefs</li> <li>HealthCheckSpec</li> <li>LoadBalancingSpec</li> <li>LoadBalancingWeighted<ul> <li>CustomWeight</li> </ul> </li> <li>LoadBalancingGeo</li> </ul> </li> <li>DNSPolicyStatus<ul> <li>HealthCheckStatus</li> </ul> </li> </ul>"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#dnspolicy","title":"DNSPolicy","text":"Field Type Required Description <code>spec</code> DNSPolicySpec Yes The specification for DNSPolicy custom resource <code>status</code> DNSPolicyStatus No The status for the custom resource"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#dnspolicyspec","title":"DNSPolicySpec","text":"Field Type Required Description <code>targetRef</code> Gateway API LocalPolicyTargetReference Yes Reference to a Kubernetes resource that the policy attaches to <code>healthCheck</code> HealthCheckSpec No HealthCheck spec <code>loadBalancing</code> LoadBalancingSpec Yes(loadbalanced only) LoadBalancing Spec, required when routingStrategy is \"loadbalanced\" <code>routingStrategy</code> String (immutable) Yes Immutable! Routing Strategy to use, one of \"simple\" or \"loadbalanced\" <code>providerRefs</code> ProviderRefs Yes array of references to providers. (currently limited to max 1)"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#providerrefs","title":"ProviderRefs","text":"Field Type Required Description <code>providerRefs</code> []ProviderRef Yes max 1 reference. This is an array of providerRef that points to a local secret(s) that contains the required provider auth values"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#providerref","title":"ProviderRef","text":"Field Type Required Description <code>name</code> String Yes Name of the secret in the same namespace that contains the provider credentials"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#healthcheckspec","title":"HealthCheckSpec","text":"Field Type Required Description <code>endpoint</code> String Yes Endpoint is the path to append to the host to reach the expected health check <code>port</code> Number Yes Port to connect to the host on <code>protocol</code> String Yes Protocol to use when connecting to the host, valid values are \"HTTP\" or \"HTTPS\" <code>failureThreshold</code> Number Yes FailureThreshold is a limit of consecutive failures that must occur for a host to be considered unhealthy"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#loadbalancingspec","title":"LoadBalancingSpec","text":"Field Type Required Description <code>weighted</code> LoadBalancingWeighted Yes Weighted routing spec <code>geo</code> LoadBalancingGeo Yes Geo routing spec"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#loadbalancingweighted","title":"LoadBalancingWeighted","text":"Field Type Required Description <code>defaultWeight</code> Number Yes Default weight to apply to created records <code>custom</code> []CustomWeight No Custom weights to manipulate records weights based on label selectors"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#customweight","title":"CustomWeight","text":"Field Type Description <code>selector</code> metav1.LabelSelector Label Selector to specify resources that should have this weight applied <code>weight</code> Number Weight value to apply for matching resources"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#loadbalancinggeo","title":"LoadBalancingGeo","text":"Field Type Required Description <code>defaultGeo</code> String Yes Default geo to apply to records"},{"location":"kuadrant-operator/doc/reference/dnspolicy/#dnspolicystatus","title":"DNSPolicyStatus","text":"Field Type Description <code>observedGeneration</code> String Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec. <code>conditions</code> []Kubernetes meta/v1.Condition List of conditions that define that status of the resource. <code>healthCheck</code> HealthCheckStatus HealthCheck status. <code>recordConditions</code> [String][]Kubernetes meta/v1.Condition Status of individual DNSRecords owned by this policy."},{"location":"kuadrant-operator/doc/reference/dnspolicy/#healthcheckstatus","title":"HealthCheckStatus","text":"Field Type Description <code>conditions</code> []Kubernetes meta/v1.Condition List of conditions that define that status of the resource."},{"location":"kuadrant-operator/doc/reference/kuadrant/","title":"The Kuadrant Custom Resource Definition (CRD)","text":""},{"location":"kuadrant-operator/doc/reference/kuadrant/#kuadrant","title":"kuadrant","text":"Field Type Required Description <code>spec</code> KuadrantSpec No Blank specification <code>status</code> KuadrantStatus No The status for the custom resources."},{"location":"kuadrant-operator/doc/reference/kuadrant/#kuadrantspec","title":"KuadrantSpec","text":"<p>Currently blank specification.</p>"},{"location":"kuadrant-operator/doc/reference/kuadrant/#kuadrantstatus","title":"KuadrantStatus","text":"Field Type Description <code>observedGeneration</code> String Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec. <code>conditions</code> []ConditionSpec List of conditions that define that status of the resource."},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/","title":"The RateLimitPolicy Custom Resource Definition (CRD)","text":"<ul> <li>RateLimitPolicy</li> <li>RateLimitPolicySpec<ul> <li>RateLimitPolicyCommonSpec</li> <li>Limit<ul> <li>RateLimit</li> <li>WhenCondition</li> </ul> </li> </ul> </li> <li>RateLimitPolicyStatus<ul> <li>ConditionSpec</li> </ul> </li> </ul>"},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/#ratelimitpolicy","title":"RateLimitPolicy","text":"Field Type Required Description <code>spec</code> RateLimitPolicySpec Yes The specification for RateLimitPolicy custom resource <code>status</code> RateLimitPolicyStatus No The status for the custom resource"},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/#ratelimitpolicyspec","title":"RateLimitPolicySpec","text":"Field Type Required Description <code>targetRef</code> LocalPolicyTargetReference Yes Reference to a Kubernetes resource that the policy attaches to <code>defaults</code> RateLimitPolicyCommonSpec No Default limit definitions. This field is mutually exclusive with the <code>limits</code> field <code>overrides</code> RateLimitPolicyCommonSpec No Overrides limit definitions. This field is mutually exclusive with the <code>limits</code> field and <code>defaults</code> field. This field is only allowed for policies targeting <code>Gateway</code> in <code>targetRef.kind</code> <code>limits</code> MapLimit&gt; No Limit definitions. This field is mutually exclusive with the <code>defaults</code> field"},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/#ratelimitpolicycommonspec","title":"RateLimitPolicyCommonSpec","text":"Field Type Required Description <code>limits</code> MapLimit&gt; No Explicit Limit definitions. This field is mutually exclusive with RateLimitPolicySpec <code>limits</code> field"},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/#limit","title":"Limit","text":"Field Type Required Description <code>rates</code> []RateLimit No List of rate limits associated with the limit definition <code>counters</code> []String No List of rate limit counter qualifiers. Items must be a valid Well-known attribute. Each distinct value resolved in the data plane starts a separate counter for each rate limit. <code>routeSelectors</code> []RouteSelector No List of selectors of HTTPRouteRules whose matching rules activate the limit. At least one HTTPRouteRule must be selected to activate the limit. If omitted, all HTTPRouteRules of the targeted HTTPRoute activate the limit. Do not use it in policies targeting a Gateway. <code>when</code> []WhenCondition No List of additional dynamic conditions (expressions) to activate the limit. All expression must evaluate to true for the limit to be applied. Use it for filtering attributes that cannot be expressed in the targeted HTTPRoute's <code>spec.hostnames</code> and <code>spec.rules.matches</code> fields, or when targeting a Gateway."},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/#ratelimit","title":"RateLimit","text":"Field Type Required Description <code>limit</code> Number Yes Maximum value allowed within the given period of time (duration) <code>duration</code> Number Yes The period of time in the specified unit that the limit applies <code>unit</code> String Yes Unit of time for the duration of the limit. One-of: \"second\", \"minute\", \"hour\", \"day\"."},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/#whencondition","title":"WhenCondition","text":"Field Type Required Description <code>selector</code> String Yes A valid Well-known attribute whose resolved value in the data plane will be compared to <code>value</code>, using the <code>operator</code>. <code>operator</code> String Yes The binary operator to be applied to the resolved value specified by the selector. One-of: \"eq\" (equal to), \"neq\" (not equal to) <code>value</code> String Yes The static value to be compared to the one resolved from the selector."},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/#ratelimitpolicystatus","title":"RateLimitPolicyStatus","text":"Field Type Description <code>observedGeneration</code> String Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec. <code>conditions</code> []ConditionSpec List of conditions that define that status of the resource."},{"location":"kuadrant-operator/doc/reference/ratelimitpolicy/#conditionspec","title":"ConditionSpec","text":"<ul> <li>The lastTransitionTime field provides a timestamp for when the entity last transitioned from one status to another.</li> <li>The message field is a human-readable message indicating details about the transition.</li> <li>The reason field is a unique, one-word, CamelCase reason for the condition\u2019s last transition.</li> <li>The status field is a string, with possible values True, False, and Unknown.</li> <li>The type field is a string with the following possible values:<ul> <li>Available: the resource has successfully configured;</li> </ul> </li> </ul> Field Type Description <code>type</code> String Condition Type <code>status</code> String Status: True, False, Unknown <code>reason</code> String Condition state reason <code>message</code> String Condition state description <code>lastTransitionTime</code> Timestamp Last transition timestamp"},{"location":"kuadrant-operator/doc/reference/route-selectors/","title":"Route selectors","text":"<p>The route selectors of a policy spec or policy rule (limit definition or auth rule) allow to specify selectors of routes or parts of a route, that transitively induce a set of conditions for a policy or policy rule to be enforced. It is defined as a set of HTTP route matching rules, where these matching rules must exist, partially or identically stated within the HTTPRouteRules of the HTTPRoute that is targeted by the policy.</p>"},{"location":"kuadrant-operator/doc/reference/route-selectors/#the-routeselectors-field","title":"The <code>routeSelectors</code> field","text":"<p>The <code>routeSelectors</code> field can be found in policy specs and policy rules (limit definition or auth rule).</p> Field Type Required Description <code>routeSelectors</code> []RouteSelector No List of route selectors of HTTPRouteRules whose HTTPRouteMatches activate the policy or policy rule."},{"location":"kuadrant-operator/doc/reference/route-selectors/#routeselector","title":"RouteSelector","text":"<p>Each <code>RouteSelector</code> is an object composed of a set of HTTPRouteMatch objects (from Gateway API), and an additional <code>hostnames</code> field.</p> Field Type Required Description <code>matches</code> []HTTPRouteMatch No List of selectors of HTTPRouteRules whose matching rules activate the policy or policy rule <code>hostnames</code> []Hostname No List of hostnames of the HTTPRoute that activate the policy or policy rule"},{"location":"kuadrant-operator/doc/reference/route-selectors/#mechanics-of-the-route-selectors","title":"Mechanics of the route selectors","text":"<p>Route selectors matches and the HTTPRoute's HTTPRouteMatches are pairwise compared to select or not select HTTPRouteRules that should activate a policy rule. To decide whether the route selector selects a HTTPRouteRule or not, for each pair of route selector HTTPRouteMatch and HTTPRoute HTTPRouteMatch:</p> <ol> <li>The route selector selects the HTTPRoute's HTTPRouteRule if the HTTPRouteRule contains at least one HTTPRouteMatch that specifies fields that are literally identical to all the fields specified by at least one HTTPRouteMatch of the route selector.</li> <li>A HTTPRouteMatch within a HTTPRouteRule may include other fields that are not specified in a route selector match, and yet the route selector match selects the HTTPRouteRule if all fields of the route selector match are identically included in the HTTPRouteRule's HTTPRouteMatch; the opposite is NOT true.</li> <li>Each field <code>path</code> of a HTTPRouteMatch, as well as each field <code>method</code> of a HTTPRouteMatch, as well as each element of the fields <code>headers</code> and <code>queryParams</code> of a HTTPRouteMatch, is atomic \u2013 this is true for the HTTPRouteMatches within a HTTPRouteRule, as well as for HTTPRouteMatches of a route selector.</li> </ol> <p>Additionally, at least one hostname specified in a route selector must identically match one of the hostnames specified (or inherited, when omitted) by the targeted HTTPRoute.</p> <p>The semantics of the route selectors allows to assertively relate policy rule definitions to routing rules, with benefits for identifying the subsets of the network that are covered by a policy rule, while preventing unreachable definitions, as well as the overhead associated with the maintenance of such rules across multiple resources throughout time, according to network topology beneath. Moreover, the requirement of not having to be a full copy of the targeted HTTPRouteRule matches, but only partially identical, helps prevent repetition to some degree, as well as it enables to more easily define policy rules that scope across multiple HTTPRouteRules (by specifying less rules in the selector).</p>"},{"location":"kuadrant-operator/doc/reference/route-selectors/#golden-rules-and-corner-cases","title":"Golden rules and corner cases","text":"<p>A few rules and corner cases to keep in mind while using the RLP's <code>routeSelectors</code>:</p> <ol> <li>The golden rule \u2013 The route selectors in a policy or policy rule are not to be interpreted as the route matching rules that activate the policy or policy rule, but as selectors of the route rules that activate the policy or policy rule.</li> <li>Due to (1) above, this can lead to cases, e.g., where a route selector that states <code>matches: [{ method: POST }]</code> selects a HTTPRouteRule that defines <code>matches: [{ method: POST },  { method: GET }]</code>, effectively causing the policy or policy rule to be activated on requests to the HTTP method <code>POST</code>, but also to the HTTP method <code>GET</code>.</li> <li>The requirement for the route selector match to state patterns that are identical to the patterns stated by the HTTPRouteRule (partially or entirely) makes, e.g., a route selector such as <code>matches: { path: { type: PathPrefix, value: /foo } }</code> to select a HTTPRouteRule that defines <code>matches: { path: { type: PathPrefix, value: /foo }, method: GET }</code>, but not to select a HTTPRouteRule that only defines <code>matches: { method: GET }</code>, even though the latter includes technically all HTTP paths; nor it selects a HTTPRouteRule that only defines <code>matches: { path: { type: Exact, value: /foo } }</code>, even though all requests to the exact path <code>/foo</code> are also technically requests to <code>/foo*</code>.</li> <li>The atomicity property of fields of the route selectors makes, e.g., a route selector such as <code>matches: { path: { value: /foo } }</code> to select a HTTPRouteRule that defines <code>matches: { path: { value: /foo } }</code>, but not to select a HTTPRouteRule that only defines <code>matches: { path: { type: PathPrefix, value: /foo } }</code>. (This case may actually never happen because <code>PathPrefix</code> is the default value for <code>path.type</code> and will be set automatically by the Kubernetes API server.)</li> </ol> <p>Due to the nature of route selectors of defining pointers to HTTPRouteRules, the <code>routeSelectors</code> field is not supported in a RLP that targets a Gateway resource.</p>"},{"location":"kuadrant-operator/doc/reference/tlspolicy/","title":"The TLSPolicy Custom Resource Definition (CRD)","text":"<ul> <li>TLSPolicy</li> <li>TLSPolicySpec</li> <li>TLSPolicyStatus</li> </ul>"},{"location":"kuadrant-operator/doc/reference/tlspolicy/#tlspolicy","title":"TLSPolicy","text":"Field Type Required Description <code>spec</code> TLSPolicySpec Yes The specification for TLSPolicy custom resource <code>status</code> TLSPolicyStatus No The status for the custom resource"},{"location":"kuadrant-operator/doc/reference/tlspolicy/#tlspolicyspec","title":"TLSPolicySpec","text":"Field Type Required Description <code>targetRef</code> Gateway API LocalPolicyTargetReference Yes Reference to a Kuberentes resource that the policy attaches to <code>issuerRef</code> CertManager meta/v1.ObjectReference Yes IssuerRef is a reference to the issuer for the created certificate <code>commonName</code> String No CommonName is a common name to be used on the created certificate <code>duration</code> Kubernetes meta/v1.Duration No The requested 'duration' (i.e. lifetime) of the created certificate. <code>renewBefore</code> Kubernetes meta/v1.Duration No How long before the currently issued certificate's expiry cert-manager should renew the certificate. <code>usages</code> []CertManager v1.KeyUsage No Usages is the set of x509 usages that are requested for the certificate. Defaults to <code>digital signature</code> and <code>key encipherment</code> if not specified <code>revisionHistoryLimit</code> Number No RevisionHistoryLimit is the maximum number of CertificateRequest revisions that are maintained in the Certificate's history <code>privateKey</code> CertManager meta/v1.CertificatePrivateKey No Options to control private keys used for the Certificate <p>IssuerRef certmanmetav1.ObjectReference</p>"},{"location":"kuadrant-operator/doc/reference/tlspolicy/#tlspolicystatus","title":"TLSPolicyStatus","text":"Field Type Description <code>observedGeneration</code> String Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec. <code>conditions</code> []Kubernetes meta/v1.Condition List of conditions that define that status of the resource."},{"location":"kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/","title":"Enforcing authentication &amp; authorization with Kuadrant AuthPolicy","text":"<p>This guide walks you through the process of setting up a local Kubernetes cluster with Kuadrant where you will protect Gateway API endpoints by declaring Kuadrant AuthPolicy custom resources.</p> <p>Two AuthPolicies will be declared:</p> Use case AuthPolicy App developer 1 AuthPolicy targeting a HTTPRoute that routes traffic to a sample Toy Store application, and enforces API key authentication to all requests in this route, as well as requires API key owners to be mapped to <code>groups:admins</code> metadata to access a specific HTTPRouteRule of the route. Platform engineer use-case 1 AuthPolicy targeting the <code>istio-ingressgateway</code> Gateway that enforces a trivial \"deny-all\" policy that locks down any other HTTPRoute attached to the Gateway. <p>Topology:</p> <pre><code>                   \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                   \u2502 (AuthPolicy)  \u2502\n                   \u2502    gw-auth    \u2502\n                   \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                           \u2502\n                           \u25bc\n                \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                \u2502     (Gateway)        \u2502\n                \u2502 istio-ingressgateway \u2502\n          \u250c\u2500\u2500\u2500\u2500\u25ba\u2502                      \u2502\u25c4\u2500\u2500\u2500\u2510\n          \u2502     \u2502          *           \u2502    \u2502\n          \u2502     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518    \u2502\n          \u2502                                 \u2502\n \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510              \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n \u2502   (HTTPRoute)    \u2502              \u2502   (HTTPRoute)    \u2502\n \u2502    toystore      \u2502              \u2502      other       \u2502\n \u2502                  \u2502              \u2502                  \u2502\n \u2502 api.toystore.com \u2502              \u2502 *.other-apps.com \u2502\n \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n          \u25b2\n          \u2502\n  \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n  \u2502 (AuthPolicy)  \u2502\n  \u2502    toystore   \u2502\n  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/#requisites","title":"Requisites","text":"<ul> <li>Docker</li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/#run-the-guide-1-4","title":"Run the guide \u2460 \u2192 \u2463","text":""},{"location":"kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/#1-setup-persona-cluster-admin","title":"\u2460  Setup (Persona: Cluster admin)","text":"<p>Clone the repo:</p> <pre><code>git clone git@github.com:Kuadrant/kuadrant-operator.git &amp;&amp; cd kuadrant-operator\n</code></pre> <p>Run the following command to create a local Kubernetes cluster with Kind, install &amp; deploy Kuadrant:</p> <pre><code>make local-setup\n</code></pre> <p>Request an instance of Kuadrant in the <code>kuadrant-system</code> namespace:</p> <pre><code>kubectl -n kuadrant-system apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant\nspec: {}\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/#2-deploy-the-toy-store-sample-application-persona-app-developer","title":"\u2461 Deploy the Toy Store sample application (Persona: App developer)","text":"<pre><code>kubectl apply -f examples/toystore/toystore.yaml\n\nkubectl apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: toystore\nspec:\n  parentRefs:\n\n  - name: istio-ingressgateway\n    namespace: istio-system\n  hostnames:\n  - api.toystore.com\n  rules:\n  - matches:\n    - method: GET\n      path:\n        type: PathPrefix\n        value: \"/cars\"\n    - method: GET\n      path:\n        type: PathPrefix\n        value: \"/dolls\"\n    backendRefs:\n    - name: toystore\n      port: 80\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/admin\"\n    backendRefs:\n    - name: toystore\n      port: 80\nEOF\n</code></pre> <p>Export the gateway hostname and port:</p> <pre><code>export INGRESS_HOST=$(kubectl get gtw istio-ingressgateway -n istio-system -o jsonpath='{.status.addresses[0].value}')\nexport INGRESS_PORT=$(kubectl get gtw istio-ingressgateway -n istio-system -o jsonpath='{.spec.listeners[?(@.name==\"http\")].port}')\nexport GATEWAY_URL=$INGRESS_HOST:$INGRESS_PORT\n</code></pre> <p>Send requests to the application unprotected:</p> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/cars -i\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/dolls -i\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/admin -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/#3-protect-the-toy-store-application-persona-app-developer","title":"\u2462 Protect the Toy Store application (Persona: App developer)","text":"<p>Create the AuthPolicy to enforce the following auth rules:</p> <ul> <li>Authentication:</li> <li>All users must present a valid API key</li> <li>Authorization:</li> <li><code>/admin*</code> routes require user mapped to the <code>admins</code> group (<code>kuadrant.io/groups=admins</code> annotation added to the Kubernetes API key Secret)</li> </ul> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  rules:\n    authentication:\n      \"api-key-authn\":\n        apiKey:\n          selector: {}\n        credentials:\n          authorizationHeader:\n            prefix: APIKEY\n    authorization:\n      \"only-admins\":\n        opa:\n          rego: |\n            groups := split(object.get(input.auth.identity.metadata.annotations, \"kuadrant.io/groups\", \"\"), \",\")\n            allow { groups[_] == \"admins\" }\n        routeSelectors:\n\n        - matches:\n          - path:\n              type: PathPrefix\n              value: \"/admin\"\nEOF\n</code></pre> <p>Create the API keys:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-regular-user\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\nstringData:\n  api_key: iamaregularuser\ntype: Opaque\n---\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-admin-user\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n  annotations:\n    kuadrant.io/groups: admins\nstringData:\n  api_key: iamanadmin\ntype: Opaque\nEOF\n</code></pre> <p>Send requests to the application protected by Kuadrant:</p> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/cars -i\n# HTTP/1.1 401 Unauthorized\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' -H 'Authorization: APIKEY iamaregularuser' http://$GATEWAY_URL/cars -i\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' -H 'Authorization: APIKEY iamaregularuser' http://$GATEWAY_URL/admin -i\n# HTTP/1.1 403 Forbidden\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' -H 'Authorization: APIKEY iamanadmin' http://$GATEWAY_URL/admin -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/#4-create-a-default-deny-all-policy-at-the-level-of-the-gateway-persona-platform-engineer","title":"\u2463 Create a default \"deny-all\" policy at the level of the gateway (Persona: Platform engineer)","text":"<p>Create the policy:</p> <pre><code>kubectl -n istio-system apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: gw-auth\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: istio-ingressgateway\n  rules:\n    authorization:\n      deny-all:\n        opa:\n          rego: \"allow = false\"\n    response:\n      unauthorized:\n        headers:\n          \"content-type\":\n            value: application/json\n        body:\n          value: |\n            {\n              \"error\": \"Forbidden\",\n              \"message\": \"Access denied by default by the gateway operator. If you are the administrator of the service, create a specific auth policy for the route.\"\n            }\nEOF\n</code></pre> <p>The policy won't be effective until there is at least one accepted route not yet protected by another more specific policy attached to it.</p> <p>Create a route that will inherit the default policy attached to the gateway:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: other\nspec:\n  parentRefs:\n\n  - name: istio-ingressgateway\n    namespace: istio-system\n  hostnames:\n  - \"*.other-apps.com\"\nEOF\n</code></pre> <p>Send requests to the route protected by the default policy set at the level of the gateway:</p> <pre><code>curl -H 'Host: foo.other-apps.com' http://$GATEWAY_URL/ -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/#cleanup","title":"Cleanup","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/","title":"Authenticated Rate Limiting for Application Developers","text":"<p>This user guide walks you through an example of how to configure authenticated rate limiting for an application using Kuadrant.</p> <p>Authenticated rate limiting rate limits the traffic directed to an application based on attributes of the client user, who is authenticated by some authentication method. A few examples of authenticated rate limiting use cases are:</p> <ul> <li>User A can send up to 50rps (\"requests per second\"), while User B can send up to 100rps.</li> <li>Each user can send up to 20rpm (\"request per minute\").</li> <li>Admin users (members of the 'admin' group) can send up to 100rps, while regular users (non-admins) can send up to 20rpm and no more than 5rps.</li> </ul> <p>In this guide, we will rate limit a sample REST API called Toy Store. In reality, this API is just an echo service that echoes back to the user whatever attributes it gets in the request. The API exposes an endpoint at <code>GET http://api.toystore.com/toy</code>, to mimic an operation of reading toy records.</p> <p>We will define 2 users of the API, which can send requests to the API at different rates, based on their user IDs. The authentication method used is API key.</p> User ID Rate limit alice 5rp10s (\"5 requests every 10 seconds\") bob 2rp10s (\"2 requests every 10 seconds\")"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/#run-the-steps-1-4","title":"Run the steps \u2460 \u2192 \u2463","text":""},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/#1-setup","title":"\u2460 Setup","text":"<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using Kind, where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p> <p>Note: In production environment, these steps are usually performed by a cluster operator with administrator privileges over the Kubernetes cluster.</p> <p>Clone the project:</p> <pre><code>git clone https://github.com/Kuadrant/kuadrant-operator &amp;&amp; cd kuadrant-operator\n</code></pre> <p>Setup the environment:</p> <pre><code>make local-setup\n</code></pre> <p>Request an instance of Kuadrant:</p> <pre><code>kubectl -n kuadrant-system apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant\nspec: {}\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/#2-deploy-the-toy-store-api","title":"\u2461 Deploy the Toy Store API","text":"<p>Create the deployment:</p> <pre><code>kubectl apply -f examples/toystore/toystore.yaml\n</code></pre> <p>Create a HTTPRoute to route traffic to the service via Istio Ingress Gateway:</p> <p></p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: toystore\nspec:\n  parentRefs:\n\n  - name: istio-ingressgateway\n    namespace: istio-system\n  hostnames:\n  - api.toystore.com\n  rules:\n  - matches:\n    - path:\n        type: Exact\n        value: \"/toy\"\n      method: GET\n    backendRefs:\n    - name: toystore\n      port: 80\nEOF\n</code></pre> <p>Export the gateway hostname and port:</p> <pre><code>export INGRESS_HOST=$(kubectl get gtw istio-ingressgateway -n istio-system -o jsonpath='{.status.addresses[0].value}')\nexport INGRESS_PORT=$(kubectl get gtw istio-ingressgateway -n istio-system -o jsonpath='{.spec.listeners[?(@.name==\"http\")].port}')\nexport GATEWAY_URL=$INGRESS_HOST:$INGRESS_PORT\n</code></pre> <p>Verify the route works:</p> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 200 OK\n</code></pre> <p>Note: If the command above fails to hit the Toy Store API on your environment, try forwarding requests to the service and accessing over localhost:</p> <p><pre><code>kubectl port-forward -n istio-system service/istio-ingressgateway-istio 9080:80 &gt;/dev/null 2&gt;&amp;1 &amp;\nexport GATEWAY_URL=localhost:9080\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 200 OK\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/#3-enforce-authentication-on-requests-to-the-toy-store-api","title":"\u2462 Enforce authentication on requests to the Toy Store API","text":"<p>Create a Kuadrant <code>AuthPolicy</code> to configure the authentication:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  rules:\n    authentication:\n      \"api-key-users\":\n        apiKey:\n          selector:\n            matchLabels:\n              app: toystore\n          allNamespaces: true\n        credentials:\n          authorizationHeader:\n            prefix: APIKEY\n    response:\n      success:\n        dynamicMetadata:\n          \"identity\":\n            json:\n              properties:\n                \"userid\":\n                  selector: auth.identity.metadata.annotations.secret\\.kuadrant\\.io/user-id\nEOF\n</code></pre> <p>Verify the authentication works by sending a request to the Toy Store API without API key:</p> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: APIKEY realm=\"api-key-users\"\n# x-ext-auth-reason: \"credential not found\"\n</code></pre> <p>Create API keys for users <code>alice</code> and <code>bob</code> to authenticate:</p> <p>Note: Kuadrant stores API keys as Kubernetes Secret resources. User metadata can be stored in the annotations of the resource.</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: bob-key\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    app: toystore\n  annotations:\n    secret.kuadrant.io/user-id: bob\nstringData:\n  api_key: IAMBOB\ntype: Opaque\n---\napiVersion: v1\nkind: Secret\nmetadata:\n  name: alice-key\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    app: toystore\n  annotations:\n    secret.kuadrant.io/user-id: alice\nstringData:\n  api_key: IAMALICE\ntype: Opaque\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/#4-enforce-authenticated-rate-limiting-on-requests-to-the-toy-store-api","title":"\u2463 Enforce authenticated rate limiting on requests to the Toy Store API","text":"<p>Create a Kuadrant <code>RateLimitPolicy</code> to configure rate limiting:</p> <p></p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    \"alice-limit\":\n      rates:\n\n      - limit: 5\n        duration: 10\n        unit: second\n      when:\n      - selector: metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid\n        operator: eq\n        value: alice\n    \"bob-limit\":\n      rates:\n      - limit: 2\n        duration: 10\n        unit: second\n      when:\n      - selector: metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid\n        operator: eq\n        value: bob\nEOF\n</code></pre> <p>Note: It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p> <p>Verify the rate limiting works by sending requests as Alice and Bob.</p> <p>Up to 5 successful (<code>200 OK</code>) requests every 10 seconds allowed for Alice, then <code>429 Too Many Requests</code>:</p> <pre><code>while :; do curl --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Authorization: APIKEY IAMALICE' -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre> <p>Up to 2 successful (<code>200 OK</code>) requests every 10 seconds allowed for Bob, then <code>429 Too Many Requests</code>:</p> <pre><code>while :; do curl --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Authorization: APIKEY IAMBOB' -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/#cleanup","title":"Cleanup","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/","title":"Authenticated Rate Limiting with JWTs and Kubernetes RBAC","text":"<p>This user guide walks you through an example of how to use Kuadrant to protect an application with policies to enforce:</p> <ul> <li>authentication based OpenId Connect (OIDC) ID tokens (signed JWTs), issued by a Keycloak server;</li> <li>alternative authentication method by Kubernetes Service Account tokens;</li> <li>authorization delegated to Kubernetes RBAC system;</li> <li>rate limiting by user ID.</li> </ul> <p>In this example, we will protect a sample REST API called Toy Store. In reality, this API is just an echo service that echoes back to the user whatever attributes it gets in the request.</p> <p>The API listens to requests at the hostnames <code>*.toystore.com</code>, where it exposes the endpoints <code>GET /toy*</code>, <code>POST /admin/toy</code> and <code>DELETE /amind/toy</code>, respectively, to mimic operations of reading, creating, and deleting toy records.</p> <p>Any authenticated user/service account can send requests to the Toy Store API, by providing either a valid Keycloak-issued access token or Kubernetes token.</p> <p>Privileges to execute the requested operation (read, create or delete) will be granted according to the following RBAC rules, stored in the Kubernetes authorization system:</p> Operation Endpoint Required role Read <code>GET /toy*</code> <code>toystore-reader</code> Create <code>POST /admin/toy</code> <code>toystore-write</code> Delete <code>DELETE /admin/toy</code> <code>toystore-write</code> <p>Each user will be entitled to a maximum of 5rp10s (5 requests every 10 seconds).</p>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#requirements","title":"Requirements","text":"<ul> <li>Docker</li> <li>kubectl command-line tool</li> <li>jq</li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#run-the-guide-1-6","title":"Run the guide \u2460 \u2192 \u2465","text":""},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#1-setup-a-cluster-with-kuadrant","title":"\u2460 Setup a cluster with Kuadrant","text":"<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using Kind, where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p> <p>Note: In production environment, these steps are usually performed by a cluster operator with administrator privileges over the Kubernetes cluster.</p> <p>Clone the project:</p> <pre><code>git clone https://github.com/Kuadrant/kuadrant-operator &amp;&amp; cd kuadrant-operator\n</code></pre> <p>Setup the environment:</p> <pre><code>make local-setup\n</code></pre> <p>Request an instance of Kuadrant:</p> <pre><code>kubectl -n kuadrant-system apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant\nspec: {}\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#2-deploy-the-toy-store-api","title":"\u2461 Deploy the Toy Store API","text":"<p>Deploy the application in the <code>default</code> namespace:</p> <pre><code>kubectl apply -f examples/toystore/toystore.yaml\n</code></pre> <p>Route traffic to the application:</p> <pre><code>kubectl apply -f examples/toystore/httproute.yaml\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#api-lifecycle","title":"API lifecycle","text":""},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#try-the-api-unprotected","title":"Try the API unprotected","text":"<p>Export the gateway hostname and port:</p> <pre><code>export INGRESS_HOST=$(kubectl get gtw istio-ingressgateway -n istio-system -o jsonpath='{.status.addresses[0].value}')\nexport INGRESS_PORT=$(kubectl get gtw istio-ingressgateway -n istio-system -o jsonpath='{.spec.listeners[?(@.name==\"http\")].port}')\nexport GATEWAY_URL=$INGRESS_HOST:$INGRESS_PORT\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 200 OK\n</code></pre> <p>It should return <code>200 OK</code>.</p> <p>Note: If the command above fails to hit the Toy Store API on your environment, try forwarding requests to the service and accessing over localhost:</p> <p><pre><code>kubectl port-forward -n istio-system service/istio-ingressgateway-istio 9080:80 &gt;/dev/null 2&gt;&amp;1 &amp;\nexport GATEWAY_URL=localhost:9080\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 200 OK\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#3-deploy-keycloak","title":"\u2462 Deploy Keycloak","text":"<p>Create the namesapce:</p> <pre><code>kubectl create namespace keycloak\n</code></pre> <p>Deploy Keycloak with a bootstrap realm, users, and clients:</p> <pre><code>kubectl apply -n keycloak -f https://raw.githubusercontent.com/Kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p>Note: The Keycloak server may take a couple of minutes to be ready.</p>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#4-enforce-authentication-and-authorization-for-the-toy-store-api","title":"\u2463 Enforce authentication and authorization for the Toy Store API","text":"<p>Create a Kuadrant <code>AuthPolicy</code> to configure authentication and authorization:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: toystore-protection\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  rules:\n    authentication:\n      \"keycloak-users\":\n        jwt:\n          issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n      \"k8s-service-accounts\":\n        kubernetesTokenReview:\n          audiences:\n\n          - https://kubernetes.default.svc.cluster.local\n        overrides:\n          \"sub\":\n            selector: auth.identity.user.username\n    authorization:\n      \"k8s-rbac\":\n        kubernetesSubjectAccessReview:\n          user:\n            selector: auth.identity.sub\n    response:\n      success:\n        dynamicMetadata:\n          \"identity\":\n            json:\n              properties:\n                \"userid\":\n                  selector: auth.identity.sub\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#try-the-api-missing-authentication","title":"Try the API missing authentication","text":"<pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Bearer realm=\"keycloak-users\"\n# www-authenticate: Bearer realm=\"k8s-service-accounts\"\n# x-ext-auth-reason: {\"k8s-service-accounts\":\"credential not found\",\"keycloak-users\":\"credential not found\"}\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#try-the-api-without-permission","title":"Try the API without permission","text":"<p>Obtain an access token with the Keycloak server:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=john' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>Send a request to the API as the Keycloak-authenticated user while still missing permissions:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 403 Forbidden\n</code></pre> <p>Create a Kubernetes Service Account to represent a consumer of the API associated with the alternative source of identities <code>k8s-service-accounts</code>:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: v1\nkind: ServiceAccount\nmetadata:\n  name: client-app-1\nEOF\n</code></pre> <p>Obtain an access token for the <code>client-app-1</code> service account:</p> <pre><code>SA_TOKEN=$(kubectl create token client-app-1)\n</code></pre> <p>Send a request to the API as the service account while still missing permissions:</p> <pre><code>curl -H \"Authorization: Bearer $SA_TOKEN\" -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#5-grant-access-to-the-toy-store-api-for-user-and-service-account","title":"\u2464 Grant access to the Toy Store API for user and service account","text":"<p>Create the <code>toystore-reader</code> and <code>toystore-writer</code> roles:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRole\nmetadata:\n  name: toystore-reader\nrules:\n\n- nonResourceURLs: [\"/toy*\"]\n  verbs: [\"get\"]\n---\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRole\nmetadata:\n  name: toystore-writer\nrules:\n- nonResourceURLs: [\"/admin/toy\"]\n  verbs: [\"post\", \"delete\"]\nEOF\n</code></pre> <p>Add permissions to the user and service account:</p> User Kind Roles john User registered in Keycloak <code>toystore-reader</code>, <code>toystore-writer</code> client-app-1 Kuberentes Service Account <code>toystore-reader</code> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRoleBinding\nmetadata:\n  name: toystore-readers\nroleRef:\n  apiGroup: rbac.authorization.k8s.io\n  kind: ClusterRole\n  name: toystore-reader\nsubjects:\n\n- kind: User\n  name: $(jq -R -r 'split(\".\") | .[1] | @base64d | fromjson | .sub' &lt;&lt;&lt; \"$ACCESS_TOKEN\")\n- kind: ServiceAccount\n  name: client-app-1\n  namespace: default\n---\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRoleBinding\nmetadata:\n  name: toystore-writers\nroleRef:\n  apiGroup: rbac.authorization.k8s.io\n  kind: ClusterRole\n  name: toystore-writer\nsubjects:\n- kind: User\n  name: $(jq -R -r 'split(\".\") | .[1] | @base64d | fromjson | .sub' &lt;&lt;&lt; \"$ACCESS_TOKEN\")\nEOF\n</code></pre> Q: Can I use <code>Roles</code> and <code>RoleBindings</code> instead of <code>ClusterRoles</code> and <code>ClusterRoleBindings</code>? <p>Yes, you can.</p> <p>The example above is for non-resource URL Kubernetes roles. For using <code>Roles</code> and <code>RoleBindings</code> instead of   <code>ClusterRoles</code> and <code>ClusterRoleBindings</code>, thus more flexible resource-based permissions to protect the API,   see the spec for Kubernetes SubjectAccessReview authorization   in the Authorino docs.</p>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#try-the-api-with-permission","title":"Try the API with permission","text":"<p>Send requests to the API as the Keycloak-authenticated user:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -H 'Host: api.toystore.com' -X POST http://$GATEWAY_URL/admin/toy -i\n# HTTP/1.1 200 OK\n</code></pre> <p>Send requests to the API as the Kubernetes service account:</p> <pre><code>curl -H \"Authorization: Bearer $SA_TOKEN\" -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy -i\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H \"Authorization: Bearer $SA_TOKEN\" -H 'Host: api.toystore.com' -X POST http://$GATEWAY_URL/admin/toy -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#6-enforce-rate-limiting-on-requests-to-the-toy-store-api","title":"\u2465 Enforce rate limiting on requests to the Toy Store API","text":"<p>Create a Kuadrant <code>RateLimitPolicy</code> to configure rate limiting:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    \"per-user\":\n      rates:\n\n      - limit: 5\n        duration: 10\n        unit: second\n      counters:\n      - metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid\nEOF\n</code></pre> <p>Note: It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#try-the-api-rate-limited","title":"Try the API rate limited","text":"<p>Each user should be entitled to a maximum of 5 requests every 10 seconds.</p> <p>Note: If the tokens have expired, you may need to refresh them first.</p> <p>Send requests as the Keycloak-authenticated user:</p> <pre><code>while :; do curl --write-out '%{http_code}\\n' --silent --output /dev/null -H \"Authorization: Bearer $ACCESS_TOKEN\" -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre> <p>Send requests as the Kubernetes service account:</p> <pre><code>while :; do curl --write-out '%{http_code}\\n' --silent --output /dev/null -H \"Authorization: Bearer $SA_TOKEN\" -H 'Host: api.toystore.com' http://$GATEWAY_URL/toy | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/#cleanup","title":"Cleanup","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/","title":"Gateway DNS for Cluster Operators","text":"<p>This user guide walks you through an example of how to configure DNS for all routes attached to an ingress gateway.</p> <p></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/#requisites","title":"Requisites","text":"<ul> <li>Docker</li> <li>Rout53 Hosted Zone</li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/#setup","title":"Setup","text":"<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using Kind, where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p> <p>Clone the project:</p> <pre><code>git clone https://github.com/Kuadrant/kuadrant-operator &amp;&amp; cd kuadrant-operator\n</code></pre> <p>Setup the environment:</p> <pre><code>make local-setup\n</code></pre> <p>Create a namespace: <pre><code>kubectl create namespace my-gateways\n</code></pre></p> <p>Export a root domain and hosted zone id: <pre><code>export ROOT_DOMAIN=&lt;ROOT_DOMAIN&gt;\n</code></pre></p> <p>Note: ROOT_DOMAIN should be set to your AWS hosted zone name.</p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/#create-a-dns-provider-secret","title":"Create a dns provider secret","text":"<p>Create AWS provider secret. You should limit the permissions of this credential to only the zones you want us to access. </p> <pre><code>export AWS_ACCESS_KEY_ID=&lt;AWS_ACCESS_KEY_ID&gt; AWS_SECRET_ACCESS_KEY=&lt;AWS_SECRET_ACCESS_KEY&gt;\n\nkubectl -n my-gateways create secret generic aws-credentials \\\n  --type=kuadrant.io/aws \\\n  --from-literal=AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \\\n  --from-literal=AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/#create-an-ingress-gateway","title":"Create an ingress gateway","text":"<p>Create a gateway using your ROOT_DOMAIN as part of a listener hostname: <pre><code>kubectl -n my-gateways apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: Gateway\nmetadata:\n  name: prod-web\nspec:\n  gatewayClassName: istio\n  listeners:\n\n    - allowedRoutes:\n        namespaces:\n          from: All\n      name: api\n      hostname: \"*.$ROOT_DOMAIN\"\n      port: 80\n      protocol: HTTP\nEOF\n</code></pre></p> <p>Check gateway status: <pre><code>kubectl get gateway prod-web -n my-gateways\n</code></pre> Response: <pre><code>NAME       CLASS   ADDRESS        PROGRAMMED   AGE\nprod-web   istio   172.18.200.1   True         25s\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/#enable-dns-on-the-gateway","title":"Enable DNS on the gateway","text":"<p>Create a Kuadrant <code>DNSPolicy</code> to configure DNS: <pre><code>kubectl -n my-gateways apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: prod-web\nspec:\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  routingStrategy: simple\nEOF\n</code></pre></p> <p>Check policy status: <pre><code>kubectl get dnspolicy -o wide -n my-gateways\n</code></pre> Response: <pre><code>NAME       STATUS     TARGETREFKIND   TARGETREFNAME   AGE\nprod-web   Accepted   Gateway         prod-web        26s\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/#deploy-a-sample-api-to-test-dns","title":"Deploy a sample API to test DNS","text":"<p>Deploy the sample API: <pre><code>kubectl -n my-gateways apply -f examples/toystore/toystore.yaml\nkubectl -n my-gateways wait --for=condition=Available deployments toystore --timeout=60s\n</code></pre></p> <p>Route traffic to the API from our gateway: <pre><code>kubectl -n my-gateways apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: toystore\nspec:\n  parentRefs:\n\n  - name: prod-web\n    namespace: my-gateways\n  hostnames:\n  - \"*.$ROOT_DOMAIN\"\n  rules:\n  - backendRefs:\n    - name: toystore\n      port: 80\nEOF\n</code></pre></p> <p>Verify a DNSRecord resource is created: <pre><code>kubectl get dnsrecords -n my-gateways\nNAME           READY\nprod-web-api   True\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/#verify-dns-works-by-sending-requests","title":"Verify DNS works by sending requests","text":"<p>Verify DNS using dig: <pre><code>dig foo.$ROOT_DOMAIN +short\n</code></pre> Response: <pre><code>172.18.200.1\n</code></pre></p> <p>Verify DNS using curl:</p> <p><pre><code>curl http://api.$ROOT_DOMAIN\n</code></pre> Response: <pre><code>{\n  \"method\": \"GET\",\n  \"path\": \"/\",\n  \"query_string\": null,\n  \"body\": \"\",\n  \"headers\": {\n    \"HTTP_HOST\": \"api.$ROOT_DOMAIN\",\n    \"HTTP_USER_AGENT\": \"curl/7.85.0\",\n    \"HTTP_ACCEPT\": \"*/*\",\n    \"HTTP_X_FORWARDED_FOR\": \"10.244.0.1\",\n    \"HTTP_X_FORWARDED_PROTO\": \"http\",\n    \"HTTP_X_ENVOY_INTERNAL\": \"true\",\n    \"HTTP_X_REQUEST_ID\": \"9353dd3d-0fe5-4404-86f4-a9732a9c119c\",\n    \"HTTP_X_ENVOY_DECORATOR_OPERATION\": \"toystore.my-gateways.svc.cluster.local:80/*\",\n    \"HTTP_X_ENVOY_PEER_METADATA\": \"ChQKDkFQUF9DT05UQUlORVJTEgIaAAoaCgpDTFVTVEVSX0lEEgwaCkt1YmVybmV0ZXMKHQoMSU5TVEFOQ0VfSVBTEg0aCzEwLjI0NC4wLjIyChkKDUlTVElPX1ZFUlNJT04SCBoGMS4xNy4yCtcBCgZMQUJFTFMSzAEqyQEKIwoVaXN0aW8uaW8vZ2F0ZXdheS1uYW1lEgoaCHByb2Qtd2ViChkKDGlzdGlvLmlvL3JldhIJGgdkZWZhdWx0CjMKH3NlcnZpY2UuaXN0aW8uaW8vY2Fub25pY2FsLW5hbWUSEBoOcHJvZC13ZWItaXN0aW8KLwojc2VydmljZS5pc3Rpby5pby9jYW5vbmljYWwtcmV2aXNpb24SCBoGbGF0ZXN0CiEKF3NpZGVjYXIuaXN0aW8uaW8vaW5qZWN0EgYaBHRydWUKGgoHTUVTSF9JRBIPGg1jbHVzdGVyLmxvY2FsCigKBE5BTUUSIBoecHJvZC13ZWItaXN0aW8tYzU0NWQ4ZjY4LTdjcjg2ChoKCU5BTUVTUEFDRRINGgtteS1nYXRld2F5cwpWCgVPV05FUhJNGktrdWJlcm5ldGVzOi8vYXBpcy9hcHBzL3YxL25hbWVzcGFjZXMvbXktZ2F0ZXdheXMvZGVwbG95bWVudHMvcHJvZC13ZWItaXN0aW8KFwoRUExBVEZPUk1fTUVUQURBVEESAioACiEKDVdPUktMT0FEX05BTUUSEBoOcHJvZC13ZWItaXN0aW8=\",\n    \"HTTP_X_ENVOY_PEER_METADATA_ID\": \"router~10.244.0.22~prod-web-istio-c545d8f68-7cr86.my-gateways~my-gateways.svc.cluster.local\",\n    \"HTTP_X_ENVOY_ATTEMPT_COUNT\": \"1\",\n    \"HTTP_X_B3_TRACEID\": \"d65f580db9c6a50c471cdb534771c61a\",\n    \"HTTP_X_B3_SPANID\": \"471cdb534771c61a\",\n    \"HTTP_X_B3_SAMPLED\": \"0\",\n    \"HTTP_VERSION\": \"HTTP/1.1\"\n  },\n  \"uuid\": \"0ecb9f84-db30-4289-a3b8-e22d4021122f\"\n}\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-dns/#cleanup","title":"Cleanup","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/","title":"Gateway Rate Limiting for Cluster Operators","text":"<p>This user guide walks you through an example of how to configure rate limiting for all routes attached to an ingress gateway.</p> <p></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/#run-the-steps-1-5","title":"Run the steps \u2460 \u2192 \u2464","text":""},{"location":"kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/#1-setup","title":"\u2460 Setup","text":"<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using Kind, where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p> <p>Note: In production environment, these steps are usually performed by a cluster operator with administrator privileges over the Kubernetes cluster.</p> <p>Clone the project:</p> <pre><code>git clone https://github.com/Kuadrant/kuadrant-operator &amp;&amp; cd kuadrant-operator\n</code></pre> <p>Setup the environment:</p> <pre><code>make local-setup\n</code></pre> <p>Request an instance of Kuadrant:</p> <pre><code>kubectl -n kuadrant-system apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant\nspec: {}\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/#2-create-the-ingress-gateways","title":"\u2461 Create the ingress gateways","text":"<pre><code>kubectl -n istio-system apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: Gateway\nmetadata:\n  name: external\n  annotations:\n    kuadrant.io/namespace: kuadrant-system\n    networking.istio.io/service-type: ClusterIP\nspec:\n  gatewayClassName: istio\n  listeners:\n\n  - name: external\n    port: 80\n    protocol: HTTP\n    hostname: '*.io'\n    allowedRoutes:\n      namespaces:\n        from: All\n---\napiVersion: gateway.networking.k8s.io/v1\nkind: Gateway\nmetadata:\n  name: internal\n  annotations:\n    kuadrant.io/namespace: kuadrant-system\n    networking.istio.io/service-type: ClusterIP\nspec:\n  gatewayClassName: istio\n  listeners:\n  - name: local\n    port: 80\n    protocol: HTTP\n    hostname: '*.local'\n    allowedRoutes:\n      namespaces:\n        from: All\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/#3-enforce-rate-limiting-on-requests-incoming-through-the-external-gateway","title":"\u2462 Enforce rate limiting on requests incoming through the <code>external</code> gateway","text":"<pre><code>    \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510      \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 (Gateway) \u2502      \u2502 (Gateway) \u2502\n    \u2502  external \u2502      \u2502  internal \u2502\n    \u2502           \u2502      \u2502           \u2502\n    \u2502   *.io    \u2502      \u2502  *.local  \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518      \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n          \u25b2\n          \u2502\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 (RateLimitPolicy) \u2502\n\u2502       gw-rlp      \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre> <p>Create a Kuadrant <code>RateLimitPolicy</code> to configure rate limiting:</p> <pre><code>kubectl apply -n istio-system -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: gw-rlp\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: external\n  limits:\n    \"global\":\n      rates:\n\n      - limit: 5\n        duration: 10\n        unit: second\nEOF\n</code></pre> <p>Note: It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/#4-deploy-a-sample-api-to-test-rate-limiting-enforced-at-the-level-of-the-gateway","title":"\u2463 Deploy a sample API to test rate limiting enforced at the level of the gateway","text":"<pre><code>                           \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510      \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510      \u2502 (Gateway) \u2502      \u2502 (Gateway) \u2502\n\u2502 (RateLimitPolicy) \u2502      \u2502  external \u2502      \u2502  internal \u2502\n\u2502       gw-rlp      \u251c\u2500\u2500\u2500\u2500\u2500\u25ba\u2502           \u2502      \u2502           \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518      \u2502   *.io    \u2502      \u2502  *.local  \u2502\n                           \u2514\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2518      \u2514\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2518\n                                 \u2502                  \u2502\n                                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                                           \u2502\n                                 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                                 \u2502   (HTTPRoute)    \u2502\n                                 \u2502     toystore     \u2502\n                                 \u2502                  \u2502\n                                 \u2502 *.toystore.io    \u2502\n                                 \u2502 *.toystore.local \u2502\n                                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                                          \u2502\n                                   \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                                   \u2502   (Service)  \u2502\n                                   \u2502   toystore   \u2502\n                                   \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n</code></pre> <p>Deploy the sample API:</p> <pre><code>kubectl apply -f examples/toystore/toystore.yaml\n</code></pre> <p>Route traffic to the API from both gateways:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: toystore\nspec:\n  parentRefs:\n\n  - name: external\n    namespace: istio-system\n  - name: internal\n    namespace: istio-system\n  hostnames:\n  - \"*.toystore.io\"\n  - \"*.toystore.local\"\n  rules:\n  - backendRefs:\n    - name: toystore\n      port: 80\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/#5-verify-the-rate-limiting-works-by-sending-requests-in-a-loop","title":"\u2464 Verify the rate limiting works by sending requests in a loop","text":"<p>Expose the gateways, respectively at the port numbers <code>9081</code> and <code>9082</code> of the local host:</p> <pre><code>kubectl port-forward -n istio-system service/external-istio 9081:80 &gt;/dev/null 2&gt;&amp;1 &amp;\nkubectl port-forward -n istio-system service/internal-istio 9082:80 &gt;/dev/null 2&gt;&amp;1 &amp;\n</code></pre> <p>Up to 5 successful (<code>200 OK</code>) requests every 10 seconds through the <code>external</code> ingress gateway (<code>*.io</code>), then <code>429 Too Many Requests</code>:</p> <pre><code>while :; do curl --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Host: api.toystore.io' http://localhost:9081 | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre> <p>Unlimited successful (<code>200 OK</code>) through the <code>internal</code> ingress gateway (<code>*.local</code>):</p> <pre><code>while :; do curl --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Host: api.toystore.local' http://localhost:9082 | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/#cleanup","title":"Cleanup","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/gateway-tls/","title":"Gateway TLS for Cluster Operators","text":"<p>This user guide walks you through an example of how to configure TLS for all routes attached to an ingress gateway.</p> <p></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-tls/#requisites","title":"Requisites","text":"<ul> <li>Docker</li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/gateway-tls/#setup","title":"Setup","text":"<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using Kind, where it installs Istio, Kubernetes Gateway API, CertManager and Kuadrant itself.</p> <p>Clone the project:</p> <pre><code>git clone https://github.com/Kuadrant/kuadrant-operator &amp;&amp; cd kuadrant-operator\n</code></pre> <p>Setup the environment:</p> <pre><code>make local-setup\n</code></pre> <p>Create a namespace: <pre><code>kubectl create namespace my-gateways\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-tls/#create-an-ingress-gateway","title":"Create an ingress gateway","text":"<p>Create a gateway: <pre><code>kubectl -n my-gateways apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: Gateway\nmetadata:\n  name: prod-web\nspec:\n  gatewayClassName: istio\n  listeners:\n\n    - allowedRoutes:\n        namespaces:\n          from: All\n      name: api\n      hostname: \"*.toystore.local\"\n      port: 443\n      protocol: HTTPS\n      tls:\n        mode: Terminate\n        certificateRefs:\n          - name: toystore-local-tls\n            kind: Secret\nEOF\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-tls/#enable-tls-on-the-gateway","title":"Enable TLS on the gateway","text":"<p>The TLSPolicy requires a reference to an existing CertManager Issuer.</p> <p>Create a CertManager Issuer: <pre><code>kubectl apply -n my-gateways -f - &lt;&lt;EOF\napiVersion: cert-manager.io/v1\nkind: Issuer\nmetadata:\n  name: selfsigned-issuer\nspec:\n  selfSigned: {}\nEOF\n</code></pre></p> <p>Note: We are using a self-signed issuer here but any supported CerManager issuer or cluster issuer can be used.</p> <p><pre><code>kubectl get issuer selfsigned-issuer -n my-gateways\n</code></pre> Response: <pre><code>NAME                        READY   AGE\nselfsigned-issuer   True    18s\n</code></pre></p> <p>Create a Kuadrant <code>TLSPolicy</code> to configure TLS: <pre><code>kubectl apply -n my-gateways -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1alpha1\nkind: TLSPolicy\nmetadata:\n  name: prod-web\nspec:\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  issuerRef:\n    group: cert-manager.io\n    kind: Issuer\n    name: selfsigned-issuer\nEOF\n</code></pre></p> <p>Check policy status: <pre><code>kubectl get tlspolicy -o wide -n my-gateways\n</code></pre> Response: <pre><code>NAME       STATUS     TARGETREFKIND   TARGETREFNAME   AGE\nprod-web   Accepted   Gateway         prod-web        13s\n</code></pre></p> <p>Check a Certificate resource was created: <pre><code>kubectl get certificates -n my-gateways\n</code></pre> Response <pre><code>NAME                 READY   SECRET               AGE\ntoystore-local-tls   True    toystore-local-tls   7m30s\n</code></pre></p> <p>Check a TLS Secret resource was created: <pre><code>kubectl get secrets -n my-gateways --field-selector=\"type=kubernetes.io/tls\"\n</code></pre> Response: <pre><code>NAME                 TYPE                DATA   AGE\ntoystore-local-tls   kubernetes.io/tls   3      7m42s\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-tls/#deploy-a-sample-api-to-test-tls","title":"Deploy a sample API to test TLS","text":"<p>Deploy the sample API: <pre><code>kubectl -n my-gateways apply -f examples/toystore/toystore.yaml\nkubectl -n my-gateways wait --for=condition=Available deployments toystore --timeout=60s\n</code></pre></p> <p>Route traffic to the API from our gateway: <pre><code>kubectl -n my-gateways apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: toystore\nspec:\n  parentRefs:\n\n  - name: prod-web\n    namespace: my-gateways\n  hostnames:\n  - \"*.toystore.local\"\n  rules:\n  - backendRefs:\n    - name: toystore\n      port: 80\nEOF\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-tls/#verify-tls-works-by-sending-requests","title":"Verify TLS works by sending requests","text":"<p>Get the gateway address@ <pre><code>GWADDRESS=`kubectl get gateway/prod-web -n my-gateways -o=jsonpath='{.status.addresses[?(@.type==\"IPAddress\")].value}'`\necho $GWADDRESS\n</code></pre> Response: <pre><code>172.18.200.1\n</code></pre></p> <p>Verify we can access the service via TLS: <pre><code>curl -vkI https://api.toystore.local --resolve \"api.toystore.local:443:$GWADDRESS\"\n</code></pre> Response: <pre><code>* Added api.toystore.local:443:172.18.200.1 to DNS cache\n* Hostname api.toystore.local was found in DNS cache\n*   Trying 172.18.200.1:443...\n* Connected to api.toystore.local (172.18.200.1) port 443 (#0)\n* ALPN: offers h2\n* ALPN: offers http/1.1\n* TLSv1.0 (OUT), TLS header, Certificate Status (22):\n* TLSv1.3 (OUT), TLS handshake, Client hello (1):\n* TLSv1.2 (IN), TLS header, Certificate Status (22):\n* TLSv1.3 (IN), TLS handshake, Server hello (2):\n* TLSv1.2 (IN), TLS header, Finished (20):\n* TLSv1.2 (IN), TLS header, Supplemental data (23):\n* TLSv1.3 (IN), TLS handshake, Encrypted Extensions (8):\n* TLSv1.3 (IN), TLS handshake, Certificate (11):\n* TLSv1.3 (IN), TLS handshake, CERT verify (15):\n* TLSv1.3 (IN), TLS handshake, Finished (20):\n* TLSv1.2 (OUT), TLS header, Finished (20):\n* TLSv1.3 (OUT), TLS change cipher, Change cipher spec (1):\n* TLSv1.2 (OUT), TLS header, Supplemental data (23):\n* TLSv1.3 (OUT), TLS handshake, Finished (20):\n* SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384\n* ALPN: server accepted h2\n* Server certificate:\n*  subject: [NONE]\n*  start date: Feb 15 11:46:50 2024 GMT\n*  expire date: May 15 11:46:50 2024 GMT\n* Using HTTP2, server supports multiplexing\n* Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0\n* TLSv1.2 (OUT), TLS header, Supplemental data (23):\n* TLSv1.2 (OUT), TLS header, Supplemental data (23):\n* TLSv1.2 (OUT), TLS header, Supplemental data (23):\n* h2h3 [:method: HEAD]\n* h2h3 [:path: /]\n* h2h3 [:scheme: https]\n* h2h3 [:authority: api.toystore.local]\n* h2h3 [user-agent: curl/7.85.0]\n* h2h3 [accept: */*]\n* Using Stream ID: 1 (easy handle 0x5623e4fe5bf0)\n* TLSv1.2 (OUT), TLS header, Supplemental data (23):\n&gt; HEAD / HTTP/2\n&gt; Host: api.toystore.local\n&gt; user-agent: curl/7.85.0\n&gt; accept: */*\n&gt; \n* TLSv1.2 (IN), TLS header, Supplemental data (23):\n* TLSv1.3 (IN), TLS handshake, Newsession Ticket (4):\n* TLSv1.3 (IN), TLS handshake, Newsession Ticket (4):\n* old SSL session ID is stale, removing\n* TLSv1.2 (IN), TLS header, Supplemental data (23):\n* Connection state changed (MAX_CONCURRENT_STREAMS == 2147483647)!\n* TLSv1.2 (OUT), TLS header, Supplemental data (23):\n* TLSv1.2 (IN), TLS header, Supplemental data (23):\n&lt; HTTP/2 200 \nHTTP/2 200 \n&lt; content-type: application/json\ncontent-type: application/json\n&lt; server: istio-envoy\nserver: istio-envoy\n&lt; date: Thu, 15 Feb 2024 12:13:27 GMT\ndate: Thu, 15 Feb 2024 12:13:27 GMT\n&lt; content-length: 1658\ncontent-length: 1658\n&lt; x-envoy-upstream-service-time: 1\nx-envoy-upstream-service-time: 1\n\n&lt; \n\n* Connection #0 to host api.toystore.local left intact\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/gateway-tls/#cleanup","title":"Cleanup","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/","title":"Secure, protect, and connect APIs with Kuadrant on OpenShift","text":""},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#overview","title":"Overview","text":"<p>This guide walks you through using Kuadrant on OpenShift to secure, protect, and connect an API exposed by a Gateway that is based on Kubernetes Gateway API. You can use this walkthrough for a Gateway deployed on a single OpenShift cluster or a Gateway distributed across multiple OpenShift clusters with a shared listener hostname. This guide shows how the platform engineer and application developer user roles can each use Kuadrant to achieve their goals.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#what-kuadrant-can-do-for-you-in-a-multicluster-environment","title":"What Kuadrant can do for you in a multicluster environment","text":"<p>You can leverage Kuadrant's capabilities in single or multiple clusters. The following features are designed to work across multiple clusters as well as in a single-cluster environment.</p> <ul> <li>Multicluster ingress: Kuadrant provides multicluster ingress connectivity using DNS to bring traffic to your Gateways by using a strategy defined in a <code>DNSPolicy</code>. </li> <li>Global rate limiting: Kuadrant can enable global rate limiting use cases when configured to use a shared Redis store for counters based on limits defined by a <code>RateLimitPolicy</code>.</li> <li>Global auth: You can configure a Kuadrant <code>AuthPolicy</code> to leverage external auth providers to ensure that different clusters exposing the same API authenticate and authorize in the same way. </li> <li>Integration with federated metrics stores: Kuadrant has example dashboards and metrics for visualizing your Gateways and observing traffic hitting those Gateways across multiple clusters. </li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#user-roles","title":"User roles","text":"<ul> <li> <p>Platform engineer: This guide walks you through deploying a Gateway that provides secure communication and is protected and ready for use by application development teams to deploy an API. It then walks through using this Gateway in clusters in different geographic regions, leveraging Kuadrant to bring specific traffic to your geo-located Gateways to reduce latency and distribute load, while still being protected and secured with global rate limiting and auth. </p> </li> <li> <p>Application developer: This guide walks through how you can use the Kuadrant OpenAPI Specification (OAS) extensions and <code>kuadrantctl</code> CLI to generate an <code>HTTPRoute</code> for your API and to add specific auth and rate limiting requirements.</p> </li> </ul> <p>As an optional extra, this guide highlights how both user roles can observe and monitor these Gateways when the OpenShift user workload monitoring and observability stack is deployed. </p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#deployment-management-tooling","title":"Deployment management tooling","text":"<p>While this document uses <code>kubectl</code> commands for simplicity, working with multiple clusters is complex, and it is best to use a tool such as Argo CD to manage the deployment of resources to multiple clusters.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#prerequisites","title":"Prerequisites","text":"<p>This guide expects that you have successfully installed Kuadrant on at least one OpenShift cluster:</p> <ul> <li>You have completed the steps in Install Kuadrant on an OpenShift cluster for one or more clusters.</li> <li>For multicluster scenarios, you have installed Kuadrant on at least two different OpenShift clusters, and have a shared accessible Redis store.</li> <li>You have the <code>kubectl</code> command line installed.</li> <li>Optional: User workload monitoring is configured to remote write to a central storage system such as Thanos, as described in Install Kuadrant on an OpenShift cluster.</li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#platform-engineer-workflow","title":"Platform engineer workflow","text":"<p>NOTE: You must perform the following steps in each cluster individually, unless specifically excluded. </p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-1-set-your-environment-variables","title":"Step 1 - Set your environment variables","text":"<p>Set the following environment variables used for convenience in this guide: <pre><code>export zid=change-this-to-your-zone-id\nexport rootDomain=example.com\nexport gatewayNS=api-gateway\nexport gatewayName=external\nexport devNS=toystore\nexport AWS_ACCESS_KEY_ID=xxxx\nexport AWS_SECRET_ACCESS_KEY=xxxx\nexport AWS_REGION=us-east-1\nexport clusterIssuerName=lets-encrypt\nexport EMAIL=foo@example.com\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-2-set-up-a-dns-provider","title":"Step 2 - Set up a DNS Provider","text":"<p>The DNS provider declares a credential to access the zone(s) that Kuadrant can use to set up DNS configuration. You should ensure that this credential only has access to the zones you want managed.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#create-the-dns-provider-secret-resource","title":"Create the DNS Provider Secret resource","text":"<p>Apply the following <code>Secret</code> resource to each cluster. Alternatively, if you are adding an additional cluster, add it to the new cluster:</p> <pre><code>kubectl create ns ${gatewayNS}\n</code></pre> <p>Create the secret credentials as follows:</p> <pre><code>kubectl -n ${gatewayNS} create secret generic aws-credentials \\\n  --type=kuadrant.io/aws \\\n  --from-literal=AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \\\n  --from-literal=AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-3-add-a-tls-issuer","title":"Step 3 - Add a TLS issuer","text":"<p>To secure communication to the Gateways, you will define a TLS issuer for TLS certificates. This example uses Let's Encrypt, but you can use any issuer supported by <code>cert-manager</code>.</p> <p>The following example uses Let's Encrypt staging, which you must also apply to all clusters:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: cert-manager.io/v1\nkind: ClusterIssuer\nmetadata:\n  name: ${clusterIssuerName}\nspec:\n  acme:\n    email: ${EMAIL} \n    privateKeySecretRef:\n      name: le-secret\n    server: https://acme-staging-v02.api.letsencrypt.org/directory\n    solvers:\n\n      - dns01:\n          route53:\n            hostedZoneID: ${zid}\n            region: ${AWS_REGION}\n            accessKeyIDSecretRef:\n              key: AWS_ACCESS_KEY_ID\n              name: aws-credentials\n            secretAccessKeySecretRef:\n              key: AWS_SECRET_ACCESS_KEY\n              name: aws-credentials\nEOF\n</code></pre> <p>Then wait for the <code>ClusterIssuer</code> to become ready as follows:</p> <pre><code>kubectl wait clusterissuer/${clusterIssuerName} --for=condition=ready=true\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-4-set-up-a-gateway","title":"Step 4 - Set up a Gateway","text":"<p>For Kuadrant to balance traffic using DNS across two or more clusters, you must define a Gateway with a shared host. You will define this by using an HTTPS listener with a wildcard hostname based on the root domain. As mentioned earlier, you must apply these resources to all clusters. </p> <p>NOTE: For now, the Gateway is set to accept an <code>HTTPRoute</code> from the same namespace only. This allows you to restrict who can use the Gateway until it is ready for general use.</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: Gateway\nmetadata:\n  name: ${gatewayName}\n  namespace: ${gatewayNS}\n  labels:\n    kuadrant.io/gateway: \"true\"\nspec:\n    gatewayClassName: istio\n    listeners:\n\n    - allowedRoutes:\n        namespaces:\n          from: Same\n      hostname: \"*.${rootDomain}\"\n      name: api\n      port: 443\n      protocol: HTTPS\n      tls:\n        certificateRefs:\n        - group: \"\"\n          kind: Secret\n          name: api-${gatewayName}-tls\n        mode: Terminate\nEOF\n</code></pre> <p>Check the status of your Gateway as follows:</p> <pre><code>kubectl get gateway ${gatewayName} -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Accepted\")].message}'\nkubectl get gateway ${gatewayName} -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Programmed\")].message}'\n</code></pre> <p>Your Gateway should be accepted and programmed (valid and assigned an external address). However, if you check your listener status as follows, you will see that it is not yet programmed or ready to accept traffic due to bad TLS configuration:</p> <pre><code>kubectl get gateway ${gatewayName} -n ${gatewayNS} -o=jsonpath='{.status.listeners[0].conditions[?(@.type==\"Programmed\")].message}'\n</code></pre> <p>Kuadrant can help with this by using a TLSPolicy.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-5-secure-and-protect-the-gateway-with-auth-tls-rate-limit-and-dns-policies","title":"Step 5 - Secure and protect the Gateway with auth, TLS, rate limit, and DNS policies","text":"<p>While your Gateway is now deployed, it has no exposed endpoints and your listener is not programmed. Next, you can set up a <code>TLSPolicy</code> that leverages your CertificateIssuer to set up your listener certificates. </p> <p>You will also define an <code>AuthPolicy</code> that will set up a default <code>403</code> response for any unprotected endpoints, as well as a <code>RateLimitPolicy</code> that will set up a default artificially low global limit to further protect any endpoints exposed by this Gateway.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#set-the-auth-policy","title":"Set the Auth policy","text":"<p>Set a default, deny-all <code>AuthPolicy</code> for your Gateway as follows:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: ${gatewayName}-auth\n  namespace: ${gatewayNS}\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: ${gatewayName}\n  defaults:\n    rules:\n      authorization:\n        \"deny\":\n          opa:\n            rego: \"allow = false\"\nEOF\n</code></pre> <p>Check that your auth policy was accepted by the controller as follows:</p> <pre><code>kubectl get authpolicy ${gatewayName}-auth -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Accepted\")].message}'\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#set-the-tls-policy","title":"Set the TLS policy","text":"<p>Set the <code>TLSPolicy</code> for your Gateway as follows:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1alpha1\nkind: TLSPolicy\nmetadata:\n  name: ${gatewayName}-tls\n  namespace: ${gatewayNS}\nspec:\n  targetRef:\n    name: ${gatewayName}\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  issuerRef:\n    group: cert-manager.io\n    kind: ClusterIssuer\n    name: ${clusterIssuerName}\nEOF\n</code></pre> <p>Check that your TLS policy was accepted by the controller as follows:</p> <pre><code>kubectl get tlspolicy ${gatewayName}-tls -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Accepted\")].message}'\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#set-the-rate-limit-policy","title":"Set the rate limit policy","text":"<p>Set the default <code>RateLimitPolicy</code> for your Gateway as follows:</p> <pre><code>kubectl apply -f  - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: ${gatewayName}-rlp\n  namespace: ${gatewayNS}\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: ${gatewayName}\n  defaults:\n    limits:\n      \"low-limit\":\n        rates:\n\n        - limit: 2\n          duration: 10\n          unit: second\nEOF\n</code></pre> <p>To check your rate limits have been accepted, enter the following command:</p> <pre><code>kubectl get ratelimitpolicy ${gatewayName}-rlp -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Accepted\")].message}'\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#set-the-dns-policy","title":"Set the DNS policy","text":"<p>Set the <code>DNSPolicy</code> for your Gateway as follows:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: ${gatewayName}-dnspolicy\n  namespace: ${gatewayNS}\nspec:\n  routingStrategy: loadbalanced\n  loadBalancing:\n    geo: \n      defaultGeo: US \n    weighted:\n      defaultWeight: 120 \n  targetRef:\n    name: ${gatewayName}\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  providerRefs:\n\n  - name: aws-credentials\nEOF\n</code></pre> <p>NOTE:  The <code>DNSPolicy</code> will use the DNS Provider <code>Secret</code> that you defined earlier.</p> <p>Check that your <code>DNSPolicy</code> has been accepted as follows:</p> <pre><code>kubectl get dnspolicy ${gatewayName}-dnspolicy -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Accepted\")].message}'\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#create-an-http-route","title":"Create an HTTP route","text":"<p>Create an <code>HTTPRoute</code> for your Gateway as follows:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: test\n  namespace: ${gatewayNS}\nspec:\n  parentRefs:\n\n  - name: ${gatewayName}\n    namespace: ${gatewayNS}\n  hostnames:\n  - \"test.${rootDomain}\"\n  rules:\n  - backendRefs:\n    - name: toystore\n      port: 80\nEOF\n</code></pre> <p>Check your Gateway policies are enforced as follows:</p> <pre><code>kubectl get dnspolicy ${gatewayName}-dnspolicy -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Enforced\")].message}'\nkubectl get authpolicy ${gatewayName}-auth -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Enforced\")].message}'\nkubectl get ratelimitpolicy ${gatewayName}-rlp -n ${gatewayNS} -o=jsonpath='{.status.conditions[?(@.type==\"Enforced\")].message}'\n</code></pre> <p>Check your listener is ready as follows:</p> <pre><code>kubectl get gateway ${gatewayName} -n ${gatewayNS} -o=jsonpath='{.status.listeners[0].conditions[?(@.type==\"Programmed\")].message}'\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-6-test-connectivity-and-deny-all-auth","title":"Step 6 - Test connectivity and deny all auth","text":"<p>You can use <code>curl</code> to hit your endpoint. You should see a <code>403</code>. Because this example uses Let's Encrypt staging, you can pass the <code>-k</code> flag:</p> <pre><code>curl -k -w \"%{http_code}\" https://$(kubectl get httproute test -n ${gatewayNS} -o=jsonpath='{.spec.hostnames[0]}')\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-7-opening-up-the-gateway-for-other-namespaces","title":"Step 7 - Opening up the Gateway for other namespaces","text":"<p>Because you have configured the Gateway, secured it with Kuadrant policies, and tested it, you can now open it up for use by other teams in other namespaces:</p> <pre><code>kubectl patch gateway ${gatewayName} -n ${gatewayNS} --type='json' -p='[{\"op\": \"replace\", \"path\": \"/spec/listeners/0/allowedRoutes/namespaces/from\", \"value\":\"All\"}]'\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-8-extending-this-gateway-to-multiple-clusters-and-configuring-geo-based-routing","title":"Step 8 - Extending this Gateway to multiple clusters and configuring geo-based routing","text":"<p>To distribute this Gateway across multiple clusters, repeat this setup process for each cluster. By default, this will implement a round-robin DNS strategy to distribute traffic evenly across the different clusters. Setting up your Gateways to serve clients based on their geographic location is straightforward with your current configuration.</p> <p>Assuming that you have deployed Gateway instances across multiple clusters as per this guide, the next step involves updating the DNS controller with the geographic regions of the visible Gateways.</p> <p>For instance, if you have one cluster in North America and another in the EU, you can direct traffic to these Gateways based on their location by applying the appropriate labels:</p> <p>For your North American cluster, enter the following command:</p> <pre><code>kubectl label --overwrite gateway ${gatewayName} kuadrant.io/lb-attribute-geo-code=US -n ${gatewayNS}\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#application-developer-workflow","title":"Application developer workflow","text":"<p>This section of the walkthrough focuses on using an OpenAPI Specification (OAS) to define an API. You will use Kuadrant OAS extensions to specify the routing, authentication, and rate limiting requirements. Next, you will use the <code>kuadrantctl</code> tool to generate an <code>AuthPolicy</code>, an <code>HTTPRoute</code>, and a <code>RateLimitPolicy</code>, which you will then apply to your cluster to enforce the settings defined in your OAS.</p> <p>NOTE: While this section uses the <code>kuadrantctl</code> tool, this is not essential. You can also create and apply an <code>AuthPolicy</code>, <code>RateLimitPolicy</code>, and <code>HTTPRoute</code> by using the <code>oc</code> or <code>kubectl</code> commands.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#prerequisites_1","title":"Prerequisites","text":"<ul> <li>You have installed <code>kuadrantctl</code>. You can find a compatible binary and download it from the kuadrantctl releases page.</li> <li>You have the ability to distribute resources generated by <code>kuadrantctl</code> to multiple clusters, as though you are a platform engineer.</li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-1-deploy-the-toystore-app","title":"Step 1 - Deploy the toystore app","text":"<p>To begin, deploy a new version of the <code>toystore</code> app to a developer namespace as follows:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/Kuadrant/Kuadrant-operator/main/examples/toystore/toystore.yaml -n ${devNS}\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-2-set-up-httproute-and-backend","title":"Step 2 - Set up HTTPRoute and backend","text":"<p>Copy at least one of the following example OAS to a local location:</p> <ul> <li> <p>Sample OAS for rate limiting with API key</p> </li> <li> <p>Sample OAS for rate limiting with OIDC</p> </li> </ul> <p>Set up some new environment variables as follows:</p> <pre><code>export oasPath=examples/oas-apikey.yaml\n# Ensure you still have these environment variables setup from the start of this guide:\nexport rootDomain=example.com\nexport gatewayNS=api-gateway\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-3-use-oas-to-define-your-httproute-rules","title":"Step 3 - Use OAS to define your HTTPRoute rules","text":"<p>You can generate Kuadrant and Gateway API resources directly from OAS documents by using an <code>x-kuadrant</code> extension.</p> <p>NOTE: For a more in-depth look at the OAS extension, see the kuadrantctl documentation.</p> <p>You will use <code>kuadrantctl</code> to generate your <code>HTTPRoute</code>.</p> <p>NOTE: The sample OAS has some placeholders for namespaces and domains. You will inject valid values into these placeholders based on your previous environment variables.</p> <p>Generate the resource from your OAS as follows, (<code>envsubst</code> will replace the placeholders):</p> <pre><code>cat $oasPath | envsubst | kuadrantctl generate gatewayapi httproute --oas - | kubectl apply -f -\n</code></pre> <pre><code>kubectl get httproute toystore -n ${devNS} -o=yaml\n</code></pre> <p>You should see that this route is affected by the <code>AuthPolicy</code> and <code>RateLimitPolicy</code> defined as defaults on the Gateway in the Gateway namespace.</p> <pre><code>- lastTransitionTime: \"2024-04-26T13:37:43Z\"\n        message: Object affected by AuthPolicy demo/external\n        observedGeneration: 2\n        reason: Accepted\n        status: \"True\"\n        type: kuadrant.io/AuthPolicyAffected\n- lastTransitionTime: \"2024-04-26T14:07:28Z\"\n        message: Object affected by RateLimitPolicy demo/external\n        observedGeneration: 1\n        reason: Accepted\n        status: \"True\"\n        type: kuadrant.io/RateLimitPolicyAffected        \n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-4-test-connectivity-and-deny-all-auth","title":"Step 4 - Test connectivity and deny-all auth","text":"<p>You can use <code>curl</code> to hit an endpoint in the toystore app. Because you are using Let's Encrypt staging in this example, you can pass the <code>-k</code> flag as follows:</p> <pre><code>curl -s -k -o /dev/null -w \"%{http_code}\" \"https://$(kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.spec.hostnames[0]}')/v1/toys\"\n</code></pre> <p>You are getting a <code>403</code> because of the existing default, deny-all <code>AuthPolicy</code> applied at the Gateway. You can override this for your <code>HTTPRoute</code>.</p> <p>Choose one of the following options:</p> <ul> <li>API key auth flow</li> <li>OpenID Connect auth flow </li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-5-set-up-api-key-auth-flow","title":"Step 5 - Set up API key auth flow","text":"<p>Set up an example API key in each cluster as follows:</p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: toystore-api-key\n  namespace: ${devNS}\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    kuadrant.io/apikeys-by: api_key\nstringData:\n  api_key: secret\ntype: Opaque\nEOF\n</code></pre> <p>Next, generate an <code>AuthPolicy</code> that uses secrets in your cluster as API keys as follows:</p> <pre><code>cat $oasPath | envsubst | kuadrantctl generate kuadrant authpolicy --oas -\n</code></pre> <p>From this, you can see an <code>AuthPolicy</code> generated based on your OAS that will look for API keys in secrets labeled <code>api_key</code> and look for that key in the header <code>api_key</code>. You can now apply this to the Gateway as follows:</p> <pre><code>cat $oasPath | envsubst | kuadrantctl generate kuadrant authpolicy --oas -  | kubectl apply -f -\n</code></pre> <p>You should get a <code>200</code> from the following <code>GET</code> because it has no auth requirement:</p> <pre><code>curl -s -k -o /dev/null -w \"%{http_code}\" \"https://$(kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.spec.hostnames[0]}')/v1/toys\"\n</code></pre> <p>You should get a <code>401</code> for the following <code>POST</code> request because it does not have any auth requirements:</p> <pre><code>curl -XPOST -s -k -o /dev/null -w \"%{http_code}\" \"https://$(kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.spec.hostnames[0]}')/v1/toys\"\n</code></pre> <p>Finally, if you add your API key header, with a valid key as follows, you should get a <code>200</code> response:</p> <pre><code>curl -XPOST -H 'api_key: secret' -s -k -o /dev/null -w \"%{http_code}\" \"https://$(kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.spec.hostnames[0]}')/v1/toys\"\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#optional-step-6-set-up-openid-connect-auth-flow-skip-if-using-api-key-only","title":"Optional: Step 6 - Set up OpenID Connect auth flow (skip if using API key only)","text":"<p>This section of the walkthrough uses the <code>kuadrantctl</code> tool to create an <code>AuthPolicy</code> that integrates with an OpenID provider and a <code>RateLimitPolicy</code> that leverages JWT values for per-user rate limiting. It is important to note that OpenID requires an external provider. Therefore, you should adapt the following example to suit your specific needs and provider.</p> <p>The platform engineer workflow established default policies for authentication and rate limiting at your Gateway. The new developer-defined policies, which you will create, are intended to target your HTTPRoute and will supersede the existing policies for requests to your API endpoints, similar to your previous API key example.</p> <p>The example OAS uses Kuadrant-based extensions. These extensions enable you to define routing and service protection requirements. For more details, see OpenAPI Kuadrant extensions.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#prerequisites_2","title":"Prerequisites","text":"<ul> <li>You have installed and configured an OpenID Connect provider, such as https://www.keycloak.org/. </li> <li>You have a realm, client, and users set up. This example assumes a realm in a Keycloak instance called <code>toystore</code>.</li> <li>Copy the OAS from sample OAS for rate-limiting and OIDC to a local location.</li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#set-up-an-openid-authpolicy","title":"Set up an OpenID AuthPolicy","text":"<p>Set the following environment variables:</p> <pre><code>export openIDHost=some.keycloak.com\nexport oasPath=examples/oas-oidc.yaml\n</code></pre> <p>NOTE: The sample OAS has some placeholders for namespaces and domains. You will inject valid values into these placeholders based on your previous environment variables.</p> <p>You can use your OAS and <code>kuadrantctl</code> to generate an <code>AuthPolicy</code> to replace the default on the Gateway as follows:</p> <pre><code>cat $oasPath | envsubst | kuadrantctl generate kuadrant authpolicy --oas -\n</code></pre> <p>If you are happy with the generated resource, you can apply it to the cluster as follows:</p> <pre><code>cat $oasPath | envsubst | kuadrantctl generate kuadrant authpolicy --oas - | kubectl apply -f -\n</code></pre> <p>You should see in the status of the <code>AuthPolicy</code> that it has been accepted and enforced:</p> <pre><code>kubectl get authpolicy -n ${devNS} toystore -o=jsonpath='{.status.conditions}'\n</code></pre> <p>On your <code>HTTPRoute</code>, you should also see it now affected by this <code>AuthPolicy</code> in the toystore namespace:</p> <pre><code>kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.status.parents[0].conditions[?(@.type==\"kuadrant.io/AuthPolicyAffected\")].message}'\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#test-your-openid-authpolicy","title":"Test your OpenID AuthPolicy","text":"<p>You can test your <code>AuthPolicy</code> as follows:</p> <pre><code>export ACCESS_TOKEN=$(curl -k -H \"Content-Type: application/x-www-form-urlencoded\" \\\n        -d 'grant_type=password' \\\n        -d 'client_id=toystore' \\\n        -d 'scope=openid' \\\n        -d 'username=bob' \\\n        -d 'password=p' \"https://${openIDHost}/auth/realms/toystore/protocol/openid-connect/token\" | jq -r '.access_token')\n</code></pre> <pre><code>curl -k -XPOST --write-out '%{http_code}\\n' --silent --output /dev/null \"https://$(kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.spec.hostnames[0]}')/v1/toys\"\n</code></pre> <p>You should see a <code>401</code> response code. Make a request with a valid bearer token as follows:</p> <pre><code>curl -k -XPOST --write-out '%{http_code}\\n' --silent --output /dev/null -H \"Authorization: Bearer $ACCESS_TOKEN\" \"https://$(kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.spec.hostnames[0]}')/v1/toys\"\n</code></pre> <p>You should see a <code>200</code> response code.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#step-7-set-up-rate-limiting","title":"Step 7 - Set up rate limiting","text":"<p>Lastly, you can generate your <code>RateLimitPolicy</code> to add your rate limits, based on your OAS file. Rate limiting is simplified for this walkthrough and is based on either the bearer token or the API key value. There are more advanced examples in the How-to guides on the Kuadrant documentation site, for example: Authenticated rate limiting with JWTs and Kubernetes RBAC.</p> <p>You can continue to use this sample OAS document, which includes both authentication and a rate limit:</p> <pre><code>export oasPath=examples/oas-oidc.yaml\n</code></pre> <p>Again, you should see the rate limit policy accepted and enforced:</p> <pre><code>kubectl get ratelimitpolicy -n ${devNS} toystore -o=jsonpath='{.status.conditions}'\n</code></pre> <p>On your <code>HTTRoute</code>, you should now see it is affected by the <code>RateLimitPolicy</code> in the same namespace:</p> <pre><code>kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.status.parents[0].conditions[?(@.type==\"kuadrant.io/RateLimitPolicyAffected\")].message}'\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#test-your-ratelimitpolicy","title":"Test your RateLimitPolicy","text":"<p>You can now test your rate limiting as follows:</p> <p>NOTE: You might need to wait a minute for the new rate limits to be applied. With the following requests, you should see a number of 429 responses.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#api-key-auth","title":"API Key auth","text":"<pre><code>for i in {1..3}\ndo\nprintf \"request $i \"\ncurl -XPOST -H 'api_key:secret' -s -k -o /dev/null -w \"%{http_code}\"  \"https://$(kubectl get httproute toystore -n ${devNS} -o=jsonpath='{.spec.hostnames[0]}')/v1/toys\"\nprintf \"\\n -- \\n\"\ndone \n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#openid-connect-auth","title":"OpenID Connect auth","text":"<pre><code>export ACCESS_TOKEN=$(curl -k -H \"Content-Type: application/x-www-form-urlencoded\" \\\n        -d 'grant_type=password' \\\n        -d 'client_id=toystore' \\\n        -d 'scope=openid' \\\n        -d 'username=bob' \\\n        -d 'password=p' \"https://${openIDHost}/auth/realms/toystore/protocol/openid-connect/token\" | jq -r '.access_token')\n</code></pre> <pre><code>for i in {1..3}\ndo\ncurl -k -XPOST --write-out '%{http_code}\\n' --silent --output /dev/null -H \"Authorization: Bearer $ACCESS_TOKEN\" https://$(kubectl get httproute toystore -n ${devNS}-o=jsonpath='{.spec.hostnames[0]}')/v1/toys\ndone\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/#conclusion","title":"Conclusion","text":"<p>You have completed the secure, protect, and connect walkthrough. To learn more about Kuadrant, visit https://docs.kuadrant.io.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/","title":"Secure, protect, and connect services with Kuadrant on Kubernetes","text":""},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#prerequisites","title":"Prerequisites","text":"<ul> <li>You have completed the Single-cluster Quick Start or Multi-cluster Quick Start.</li> </ul>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#overview","title":"Overview","text":"<p>In this guide, we will cover the different policies from Kuadrant and how you can use them to secure, protect and connect an Istio-controlled gateway in a single cluster, and how you can set more refined protection on the HTTPRoutes exposed by that gateway.</p> <p>Here are the steps we will go through:</p> <p>1) Deploy a sample application</p> <p>2) Define a new Gateway</p> <p>3) Ensure TLS-based secure connectivity to the gateway with a TLSPolicy</p> <p>4) Define a default RateLimitPolicy to set some infrastructure limits on your gateway</p> <p>5) Define a default AuthPolicy to deny all access to the gateway</p> <p>6) Define a DNSPolicy to bring traffic to the gateway</p> <p>7) Override the Gateway's deny-all AuthPolicy with an endpoint-specific policy</p> <p>8) Override the Gateway rate limits with an endpoint-specific policy</p> <p>You will need to set the <code>KUBECTL_CONTEXT</code> environment variable for the kubectl context of the cluster you are targeting. If you have followed the single cluster setup, it should be something like below. Adjust the name of the cluster accordingly to match the kubernetes cluster you are targeting. You can get the current context with <code>kubectl config current-context</code></p> <pre><code>#\u00a0Typical single cluster context\nexport KUBECTL_CONTEXT=kind-kuadrant-local\n\n# Example context for additional 'multi cluster' clusters\n# export KUBECTL_CONTEXT=kind-kuadrant-local-1\n</code></pre> <p>To help with this walk through, you should also set a <code>KUADRANT_ZONE_ROOT_DOMAIN</code> environment variable to a domain you want to use. If you want to try DNSPolicy, this should also be a domain you have access to the DNS for in AWS Route53 or GCP. E.g.:</p> <pre><code>export KUADRANT_ZONE_ROOT_DOMAIN=my.domain.iown\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#deploy-the-example-app-we-will-serve-via-our-gateway","title":"\u2776 Deploy the example app we will serve via our gateway","text":"<pre><code>kubectl --context $KUBECTL_CONTEXT apply -f https://raw.githubusercontent.com/Kuadrant/kuadrant-operator/main/examples/toystore/toystore.yaml\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#define-a-new-istio-managed-gateway","title":"\u2777 Define a new Istio-managed gateway","text":"<pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: Gateway\nmetadata:\n  name: api-gateway\n  namespace: kuadrant-system\nspec:\n  gatewayClassName: istio\n  listeners:\n\n  - allowedRoutes:\n      namespaces:\n        from: All\n    name: api\n    hostname: \"*.$KUADRANT_ZONE_ROOT_DOMAIN\"\n    port: 443\n    protocol: HTTPS\n    tls:\n      mode: Terminate\n      certificateRefs:\n        - name: apps-hcpapps-tls\n          kind: Secret\nEOF\n</code></pre> <p>If you take a look at the gateway status, you will see a TLS status error similar to the following:</p> <pre><code>message: invalid certificate reference /Secret/apps-hcpapps-tls. secret kuadrant-system/apps-hcpapps-tls not found\n</code></pre> <p>This is because currently there is not a TLS secret in place. Let's fix that by creating a TLSPolicy.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#define-the-tlspolicy","title":"\u2778 Define the TLSPolicy","text":"<pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1alpha1\nkind: TLSPolicy\nmetadata:\n  name: api-gateway-tls\n  namespace: kuadrant-system\nspec:\n  targetRef:\n    name: api-gateway\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  issuerRef:\n    group: cert-manager.io\n    kind: ClusterIssuer\n    name: kuadrant-operator-glbc-ca\nEOF\n</code></pre> <p>Note: You may have to create a cluster issuer in the Kubernetes cluster, depending on if one was created during your initial cluster setup or not. Here is an example of how to create a self-signed CA as a cluster issuer.</p> <pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: cert-manager.io/v1\nkind: ClusterIssuer\nmetadata:\n  name: kuadrant-operator-glbc-ca\nspec:\n  selfSigned: {}\nEOF\n</code></pre> <p>The TLSPolicy should eventually have an <code>Accepted</code> condition.</p> <pre><code>kubectl --context $KUBECTL_CONTEXT wait tlspolicy api-gateway-tls -n kuadrant-system --for=condition=accepted\n</code></pre> <p>Now, if you look at the status of the gateway, you will see the error is gone, and the status of the policy will report the listener as now secured with a TLS certificate and the gateway as affected by the TLS policy.</p> <p>Our communication with our gateway is now secured via TLS. Note that any new listeners will also be handled by the TLSPolicy.</p> <p>Let's define a HTTPRoute and test our policy. We will re-use this later on with some of the other policies as well.</p> <pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1beta1\nkind: HTTPRoute\nmetadata:\n  name: toystore\n  labels:\n    deployment: toystore\n    service: toystore\nspec:\n  parentRefs:\n\n  - name: api-gateway\n    namespace: kuadrant-system\n  hostnames:\n  - \"api.$KUADRANT_ZONE_ROOT_DOMAIN\"\n  rules:\n  - matches:\n    - method: GET\n      path:\n        type: PathPrefix\n        value: \"/cars\"\n    - method: GET\n      path:\n        type: PathPrefix\n        value: \"/dolls\"\n    backendRefs:\n    - name: toystore\n      port: 80\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/admin\"\n    backendRefs:\n    - name: toystore\n      port: 80\nEOF\n</code></pre> <p>With this HTTPRoute in place, the service we deployed is exposed via the gateway. We should be able to access our endpoint via HTTPS:</p> <pre><code>export INGRESS_HOST=$(kubectl --context $KUBECTL_CONTEXT get gtw api-gateway -o jsonpath='{.status.addresses[0].value}' -n kuadrant-system)\n\ncurl -k --resolve api.${KUADRANT_ZONE_ROOT_DOMAIN}:443:${INGRESS_HOST} \"https://api.$KUADRANT_ZONE_ROOT_DOMAIN/cars\"\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#define-infrastructure-rate-limiting","title":"\u2779 Define Infrastructure Rate Limiting","text":"<p>We have a secure communication in place. However, there is nothing limiting users from overloading our infrastructure and service components that will sit behind this gateway. Let's add a rate limiting layer to protect our services and infrastructure.</p> <pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: infra-ratelimit\n  namespace: kuadrant-system\nspec:\n  targetRef:\n    name: api-gateway\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  limits:\n    \"global\":\n      rates:\n\n      - limit: 5\n        duration: 10\n        unit: second\nEOF\n\nkubectl --context $KUBECTL_CONTEXT wait ratelimitpolicy infra-ratelimit -n kuadrant-system --for=condition=accepted\n</code></pre> <p>Note: It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p> <p>The limit here is artificially low in order for us to show it working easily. Let's test it with our endpoint:</p> <pre><code>for i in {1..10}; do curl -k --resolve api.${KUADRANT_ZONE_ROOT_DOMAIN}:443:${INGRESS_HOST} \"https://api.$KUADRANT_ZONE_ROOT_DOMAIN/cars\" &amp;&amp; sleep 1; done\n</code></pre> <p>We should see <code>409 Too Many Requests</code>s start returning after the 5th request.</p>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#define-the-gateway-authpolicy","title":"\u277a Define the Gateway AuthPolicy","text":"<p>Communication is secured and we have some protection for our infrastructure, but we do not trust any client to access our endpoints. By default, we want to allow only authenticated access. To protect our gateway, we will add a deny-all AuthPolicy. Later, we will override this with a more specific AuthPolicy for the API.</p> <pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: deny-all\n  namespace: kuadrant-system\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: api-gateway\n  rules:\n    authorization:\n      deny-all:\n        opa:\n          rego: \"allow = false\"\n    response:\n      unauthorized:\n        headers:\n          \"content-type\":\n            value: application/json\n        body:\n          value: |\n            {\n              \"error\": \"Forbidden\",\n              \"message\": \"Access denied by default by the gateway operator. If you are the administrator of the service, create a specific auth policy for the route.\"\n            }\nEOF\n</code></pre> <p>Let's test it again. This time we expect a <code>403 Forbidden</code>.</p> <pre><code>curl -k --resolve api.${KUADRANT_ZONE_ROOT_DOMAIN}:443:${INGRESS_HOST}  \"https://api.$KUADRANT_ZONE_ROOT_DOMAIN/cars\"\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#define-the-dnspolicy","title":"\u277b Define the DNSPolicy","text":"<p>(Skip this step if you did not configure a DNS provider during the setup.)</p> <p>Now, we have our gateway protected and communications secured. We are ready to configure DNS, so it is easy for clients to connect and access the APIs we intend to expose via this gateway.</p> <p>Note: You may need to create a DNS Provider Secret resource depending on if one was created during your initial cluster setup or not. You should have an <code>aws-credentials</code> Secret already created in the <code>kuadrant-system</code> namespace. However, if it doesn't exist, you can follow these commands to create one:</p> <pre><code>export AWS_ACCESS_KEY_ID=xxxxxxx # Key ID from AWS with Route 53 access\nexport AWS_SECRET_ACCESS_KEY=xxxxxxx # Access key from AWS with Route 53 access\n\nkubectl -n kuadrant-system create secret generic aws-credentials \\\n  --type=kuadrant.io/aws \\\n  --from-literal=AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \\\n  --from-literal=AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY\n</code></pre> <p>Next, create the DNSPolicy:</p> <pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: simple-dnspolicy\n  namespace: kuadrant-system\nspec:\n  routingStrategy: simple\n  targetRef:\n    name: api-gateway\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  providerRefs:\n\n  - name: aws-credentials\nEOF\n\nkubectl --context $KUBECTL_CONTEXT wait dnspolicy simple-dnspolicy -n kuadrant-system --for=condition=enforced\n</code></pre> <p>If you want to see the DNSRecord created by the this policy, execute the following command:</p> <pre><code>kubectl --context $KUBECTL_CONTEXT get dnsrecord.kuadrant.io api-gateway-api -n kuadrant-system -o=yaml\n</code></pre> <p>So now we have a wildcard DNS record to bring traffic to our gateway.</p> <p>Let's test it again. This time we expect a <code>403</code> still as the deny-all policy is still in effect. Notice we no longer need to set the Host header directly.</p> <p>Note: If you have followed through this guide on more than 1 cluster, the DNS record for the HTTPRoute hostname will have multiple IP addresses. This means that requests will be made in a round robin pattern across clusters as your DNS provider sends different responses to lookups. You may need to send multiple requests before one hits the cluster you are currently configuring.</p> <pre><code>curl -k \"https://api.$KUADRANT_ZONE_ROOT_DOMAIN/cars\" -i\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#override-the-gateways-deny-all-authpolicy","title":"\u277c Override the Gateway's deny-all AuthPolicy","text":"<p>Next, we are going to allow authenticated access to our Toystore API. To do this, we will define an AuthPolicy that targets the HTTPRoute. Note that any new HTTPRoutes will still be affected by the gateway-level policy, but as we want users to now access this API, we need to override that policy. For simplicity, we will use API keys to authenticate the requests, though many other options are available.</p> <p>Let's define an API Key for users bob and alice.</p> <pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: bob-key\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    app: toystore\n  annotations:\n    secret.kuadrant.io/user-id: bob\nstringData:\n  api_key: IAMBOB\ntype: Opaque\n---\napiVersion: v1\nkind: Secret\nmetadata:\n  name: alice-key\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    app: toystore\n  annotations:\n    secret.kuadrant.io/user-id: alice\nstringData:\n  api_key: IAMALICE\ntype: Opaque\nEOF\n</code></pre> <p>Now, we will override the AuthPolicy to start accepting the API keys:</p> <pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  rules:\n    authentication:\n      \"api-key-users\":\n        apiKey:\n          selector:\n            matchLabels:\n              app: toystore\n        credentials:\n          authorizationHeader:\n            prefix: APIKEY\n    response:\n      success:\n        dynamicMetadata:\n          \"identity\":\n            json:\n              properties:\n                \"userid\":\n                  selector: auth.identity.metadata.annotations.secret\\.kuadrant\\.io/user-id\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/secure-protect-connect/#override-the-gateways-ratelimitpolicy","title":"\u277d Override the Gateway's RateLimitPolicy","text":"<p>The gateway limits are a good set of limits for the general case, but as the developers of this API we know that we only want to allow a certain number of requests to specific users, and a general limit for all other users.</p> <pre><code>kubectl --context $KUBECTL_CONTEXT apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    \"general-user\":\n      rates:\n\n      - limit: 1\n        duration: 3\n        unit: second\n      counters:\n      - metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid\n      when:\n      - selector: metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid\n        operator: neq\n        value: bob\n    \"bob-limit\":\n      rates:\n      - limit: 2\n        duration: 3\n        unit: second\n      when:\n      - selector: metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid\n        operator: eq\n        value: bob\nEOF\n</code></pre> <p>Note: It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p> <p>As just another example, we have given bob twice as many requests to use compared to everyone else.</p> <p>Let's test this new setup.</p> <p>By sending requests as alice:</p> <pre><code>while :; do curl -k --resolve api.${KUADRANT_ZONE_ROOT_DOMAIN}:443:${INGRESS_HOST} --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Authorization: APIKEY IAMALICE' \"https://api.$KUADRANT_ZONE_ROOT_DOMAIN/cars\" | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre> <p>By sending requests as bob:</p> <pre><code>while :; do curl -k --resolve api.${KUADRANT_ZONE_ROOT_DOMAIN}:443:${INGRESS_HOST} --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Authorization: APIKEY IAMBOB' \"https://api.$KUADRANT_ZONE_ROOT_DOMAIN/cars\" | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre> <p>Note: If you configured a DNS provider during the setup and defined the DNSPolicy as described in one of the previous chapters you can omit the <code>--resolve api.${KUADRANT_ZONE_ROOT_DOMAIN}:443:${INGRESS_HOST}</code> flag.</p> <p>Note: If you have followed through this guide on more than 1 cluster, the DNS record for the HTTPRoute hostname will have multiple IP addresses. This means that requests will be made in a round robin pattern across clusters as your DNS provider sends different responses to lookups.</p> <pre><code>while :; do curl -k --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Authorization: APIKEY IAMALICE' \"https://api.$KUADRANT_ZONE_ROOT_DOMAIN/cars\" | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre> <pre><code>while :; do curl -k --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Authorization: APIKEY IAMBOB' \"https://api.$KUADRANT_ZONE_ROOT_DOMAIN/cars\" | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/","title":"Simple Rate Limiting for Application Developers","text":"<p>This user guide walks you through an example of how to configure rate limiting for an endpoint of an application using Kuadrant.</p> <p></p> <p>In this guide, we will rate limit a sample REST API called Toy Store. In reality, this API is just an echo service that echoes back to the user whatever attributes it gets in the request. The API listens to requests at the hostname <code>api.toystore.com</code>, where it exposes the endpoints <code>GET /toys*</code> and <code>POST /toys</code>, respectively, to mimic a operations of reading and writing toy records.</p> <p>We will rate limit the <code>POST /toys</code> endpoint to a maximum of 5rp10s (\"5 requests every 10 seconds\").</p> <p></p>"},{"location":"kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/#run-the-steps-1-3","title":"Run the steps \u2460 \u2192 \u2462","text":""},{"location":"kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/#1-setup","title":"\u2460 Setup","text":"<p>This step uses tooling from the Kuadrant Operator component to create a containerized Kubernetes server locally using Kind, where it installs Istio, Kubernetes Gateway API and Kuadrant itself.</p> <p>Note: In production environment, these steps are usually performed by a cluster operator with administrator privileges over the Kubernetes cluster.</p> <p>Clone the project:</p> <pre><code>git clone https://github.com/Kuadrant/kuadrant-operator &amp;&amp; cd kuadrant-operator\n</code></pre> <p>Setup the environment:</p> <pre><code>make local-setup\n</code></pre> <p>Request an instance of Kuadrant:</p> <pre><code>kubectl -n kuadrant-system apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n  name: kuadrant\nspec: {}\nEOF\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/#2-deploy-the-toy-store-api","title":"\u2461 Deploy the Toy Store API","text":"<p>Create the deployment:</p> <pre><code>kubectl apply -f examples/toystore/toystore.yaml\n</code></pre> <p>Create a HTTPRoute to route traffic to the service via Istio Ingress Gateway:</p> <p></p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: toystore\nspec:\n  parentRefs:\n\n  - name: istio-ingressgateway\n    namespace: istio-system\n  hostnames:\n  - api.toystore.com\n  rules:\n  - matches:\n    - method: GET\n      path:\n        type: PathPrefix\n        value: \"/toys\"\n    backendRefs:\n    - name: toystore\n      port: 80\n  - matches: # it has to be a separate HTTPRouteRule so we do not rate limit other endpoints\n    - method: POST\n      path:\n        type: Exact\n        value: \"/toys\"\n    backendRefs:\n    - name: toystore\n      port: 80\nEOF\n</code></pre> <p>Export the gateway hostname and port:</p> <pre><code>export INGRESS_HOST=$(kubectl get gtw istio-ingressgateway -n istio-system -o jsonpath='{.status.addresses[0].value}')\nexport INGRESS_PORT=$(kubectl get gtw istio-ingressgateway -n istio-system -o jsonpath='{.spec.listeners[?(@.name==\"http\")].port}')\nexport GATEWAY_URL=$INGRESS_HOST:$INGRESS_PORT\n</code></pre> <p>Verify the route works:</p> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/toys -i\n# HTTP/1.1 200 OK\n</code></pre> <p>Note: If the command above fails to hit the Toy Store API on your environment, try forwarding requests to the service and accessing over localhost:</p> <p><pre><code>kubectl port-forward -n istio-system service/istio-ingressgateway-istio 9080:80 &gt;/dev/null 2&gt;&amp;1 &amp;\nexport GATEWAY_URL=localhost:9080\n</code></pre> <pre><code>curl -H 'Host: api.toystore.com' http://$GATEWAY_URL/toys -i\n# HTTP/1.1 200 OK\n</code></pre></p>"},{"location":"kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/#3-enforce-rate-limiting-on-requests-to-the-toy-store-api","title":"\u2462 Enforce rate limiting on requests to the Toy Store API","text":"<p>Create a Kuadrant <code>RateLimitPolicy</code> to configure rate limiting:</p> <p></p> <pre><code>kubectl apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    \"create-toy\":\n      rates:\n\n      - limit: 5\n        duration: 10\n        unit: second\n      routeSelectors:\n      - matches: # selects the 2nd HTTPRouteRule of the targeted route\n        - method: POST\n          path:\n            type: Exact\n            value: \"/toys\"\nEOF\n</code></pre> <p>Note: It may take a couple of minutes for the RateLimitPolicy to be applied depending on your cluster.</p> <p></p> <p>Verify the rate limiting works by sending requests in a loop.</p> <p>Up to 5 successful (<code>200 OK</code>) requests every 10 seconds to <code>POST /toys</code>, then <code>429 Too Many Requests</code>:</p> <pre><code>while :; do curl --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Host: api.toystore.com' http://$GATEWAY_URL/toys -X POST | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre> <p>Unlimited successful (<code>200 OK</code>) to <code>GET /toys</code>:</p> <pre><code>while :; do curl --write-out '%{http_code}\\n' --silent --output /dev/null -H 'Host: api.toystore.com' http://$GATEWAY_URL/toys | grep -E --color \"\\b(429)\\b|$\"; sleep 1; done\n</code></pre>"},{"location":"kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/#cleanup","title":"Cleanup","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"kuadrant-operator/examples/alerts/","title":"Index","text":""},{"location":"kuadrant-operator/examples/alerts/#slo-multi-burn-rate-multi-window-alerts","title":"SLO Multi burn rate multi window alerts","text":"<p>Kuadrant have created two example SLO alerts to help give ideas on the types of SLO alerts that could be used with the operator. We have created one alert for latency and one for availability, both are Multiwindow, Multi-Burn-Rate Alerts. The alerts show a scenario where a 28d rolling window is used and a uptime of 99.95% i.e only 0.05% error budget margin is desired. This in real world time would be downtime of around: </p> Time Frame Duration Daily: 43s Weekly: 5m 2.4s Monthly: 21m 44s Quarterly: 1h 5m 12s Yearly: 4h 20m 49s <p>These values can be changed to suit different scenarios</p>"},{"location":"kuadrant-operator/examples/alerts/#sloth","title":"Sloth","text":"<p>Sloth is a tool to aid in the creation of multi burn rate and multi window SLO alerts and was used to create both the availability and latency alerts. It follows the common standard set out by Google's SRE book. Sloth generates alerts based on specific specs given. The specs for our example alerts can be found in the example/sloth folder.</p>"},{"location":"kuadrant-operator/examples/alerts/#metrics-used-for-the-alerts","title":"Metrics used for the alerts","text":""},{"location":"kuadrant-operator/examples/alerts/#availability","title":"Availability","text":"<p>For the availability SLO alerts the Istio metric <code>istio_requests_total</code> was used as its a counter type metric meaning the values can only increase as well as it gives information on all requests handled by the Istio proxy.</p>"},{"location":"kuadrant-operator/examples/alerts/#latency","title":"Latency","text":"<p>For the availability SLO alerts the Istio metric <code>istio_request_duration_milliseconds</code> was used as its a Histogram.</p>"},{"location":"kuadrant-operator/examples/alerts/#sloth-generation","title":"Sloth generation","text":"<p>You can modify the examples Sloth specs we have and regenerate the prometheus rules using the Sloth CLI and the generate command. For more information please the Sloth website</p> <p><pre><code>sloth generate -i examples/alerts/sloth/latency.yaml --default-slo-period=28d\n</code></pre> You can also use the make target to generate the rules to.</p> <pre><code>make sloth-generate\n</code></pre>"},{"location":"kuadrant-operator/examples/alerts/#prometheus-unit-tests","title":"Prometheus unit tests","text":"<p>There are also two matching unit tests to verify and test the alerts that Sloth has generated. These can be run using the make target:</p> <pre><code>make test-alerts\n</code></pre> <p>Note: The prometheus unit tests will also run via Github actions when a change is made in the alerts file.</p>"},{"location":"authorino/","title":"Authorino","text":"<p>Kubernetes-native authorization service for tailor-made Zero Trust API security.</p> <p>A lightweight Envoy external authorization server fully manageable via Kubernetes Custom Resources. JWT authentication, API key, mTLS, pattern-matching authz, OPA, K8s SA tokens, K8s RBAC, external metadata fetching, and more, with minimum to no coding at all, no rebuilding of your applications.</p> <p>Authorino is not about inventing anything new. It's about making the best things about auth out there easy and simple to use. Authorino is multi-tenant, it's cloud-native and it's open source.</p> <p> </p>"},{"location":"authorino/#getting-started","title":"Getting started","text":"<ol> <li>Deploy with the Authorino Operator</li> <li>Setup Envoy proxy and the external authorization filter</li> <li>Apply an Authorino <code>AuthConfig</code> custom resource</li> <li>Obtain an authentication token and start sending requests</li> </ol> <p>The full Getting started page of the docs provides details for the steps above, as well as information about requirements and next steps.</p> <p>Or try out our Hello World example.</p> <p>For general information about protecting your service using Authorino, check out the docs.</p>"},{"location":"authorino/#use-cases","title":"Use-cases","text":"<p>The User guides section of the docs gathers several AuthN/AuthZ use-cases as well as the instructions to implement them using Authorino. A few examples are:</p> <ul> <li>Authentication with JWTs and OpenID Connect Discovery</li> <li>Authentication with API keys</li> <li>Authentication with Kubernetes SA tokens (TokenReview API)</li> <li>Authentication with X.509 certificates and mTLS</li> <li>Authorization with JSON pattern-matching rules (e.g. JWT claims, request attributes, etc)</li> <li>Authorization with Open Policy Agent (OPA) Rego policies</li> <li>Authorization using the Kubernetes RBAC (rules stated in K8s <code>Role</code> and <code>RoleBinding</code> resources)</li> <li>Authorization using auth metadata fetched from external sources</li> <li>OIDC authentication and RBAC with Keycloak JWTs</li> <li>Injecting auth data into the request (HTTP headers, Wristband tokens, rate-limit metadata, etc)</li> <li>Authorino for the Kubernetes control plane (aka Authorino as ValidatingWebhook service)</li> </ul>"},{"location":"authorino/#how-it-works","title":"How it works","text":"<p>Authorino enables hybrid API security, with usually no code changes required to your application, tailor-made for your own combination of authentication standards and protocols and authorization policies of choice.</p> <p>Authorino implements Envoy Proxy's external authorization gRPC protocol, and is a part of Red Hat Kuadrant architecture.</p> <p>Under the hood, Authorino is based on Kubernetes Custom Resource Definitions and the Operator pattern.</p> <p>Bootstrap and configuration:</p> <ol> <li>Deploy the service/API to be protected (\"Upstream\"), Authorino and Envoy</li> <li>Write and apply an Authorino <code>AuthConfig</code> Custom Resource associated to the public host of the service</li> </ol> <p>Request-time:</p> <p> </p> <ol> <li>A user or service account (\"Consumer\") obtains an access token to consume resources of the Upstream service, and sends a request to the Envoy ingress endpoint</li> <li>The Envoy proxy establishes fast gRPC connection with Authorino carrying data of the HTTP request (context info), which causes Authorino to lookup for an <code>AuthConfig</code> Custom Resource to enforce (pre-cached)</li> <li>Identity verification (authentication) phase - Authorino verifies the identity of the consumer, where at least one authentication method/identity provider must go through</li> <li>External metadata phase - Authorino fetches additional metadata for the authorization from external sources (optional)</li> <li>Policy enforcement (authorization) phase - Authorino takes as input a JSON composed out of context data, resolved identity object and fetched additional metadata from previous phases, and triggers the evaluation of user-defined authorization policies</li> <li>Response (metadata-out) phase \u2013 Authorino builds user-defined custom responses (dynamic JSON objects and/or Festival Wristband OIDC tokens), to be supplied back to the client and/or upstream service within added HTTP headers or as Envoy Dynamic Metadata (optional)</li> <li>Callbacks phase \u2013 Authorino sends callbacks to specified HTTP endpoints (optional)</li> <li>Authorino and Envoy settle the authorization protocol with either OK/NOK response</li> <li>If authorized, Envoy triggers other HTTP filters in the chain (if any), pre-injecting eventual dynamic metadata returned by Authorino, and ultimately redirects the request to the Upstream</li> <li>The Upstream serves the requested resource to the consumer</li> </ol> More <p>The Architecture section of the docs covers details of protecting your APIs with Envoy and Authorino, including information about topology (centralized gateway, centralized authorization service or sidecars), deployment modes (cluster-wide reconciliation vs. namespaced instances), an specification of Authorino's <code>AuthConfig</code> Custom Resource Definition (CRD) and more.</p> <p>You will also find in that section information about what happens in request-time (aka Authorino's Auth Pipeline) and how to leverage the Authorization JSON for writing policies, dynamic responses and other features of Authorino.</p>"},{"location":"authorino/#list-of-features","title":"List of features","text":"Feature Stage Identity verification &amp; authentication JOSE/JWT validation (OpenID Connect) Ready OAuth 2.0 Token Introspection (opaque tokens) Ready Kubernetes TokenReview (SA tokens) Ready OpenShift User-echo endpoint In analysis API key authentication Ready mTLS authentication Ready HMAC authentication Planned (#9) Plain (resolved beforehand and injected in the payload) Ready Anonymous access Ready Ad hoc external metadata fetching OpenID Connect User Info Ready UMA-protected resource attributes Ready HTTP GET/GET-by-POST Ready Policy enforcement/authorization JSON pattern matching (e.g. JWT claims, request attributes checking) Ready OPA/Rego policies (inline and pull from registry) Ready Kubernetes SubjectAccessReview (resource and non-resource attributes) Ready Authzed/SpiceDB Ready Keycloak Authorization Services (UMA-compliant Authorization API) In analysis Custom responses Festival Wristbands tokens (token normalization, Edge Authentication Architecture) Ready JSON injection (header injection, Envoy Dynamic Metadata) Ready Plain text value (header injection) Ready Custom response status code/messages (e.g. redirect) Ready Callbacks HTTP endpoints Ready Caching OpenID Connect and User-Managed Access configs Ready JSON Web Keys (JWKs) and JSON Web Key Sets (JWKS) Ready Access tokens Ready External metadata Ready Precompiled Rego policies Ready Policy evaluation Ready Sharding (lookup performance, multitenancy) Ready <p>For a detailed description of the features above, refer to the Features page.</p>"},{"location":"authorino/#faq","title":"FAQ","text":"Do I need to deploy Envoy? <p>Authorino is built from the ground up to work well with Envoy. It is strongly recommended that you leverage Envoy along side Authorino. That said, it is possible to use Authorino without Envoy.</p> <p>Authorino implements Envoy's external authorization gRPC protocol and therefore will accept any client request that complies.</p> <p>Authorino also provides a second interface for raw HTTP authorization, suitable for using with Kubernetes ValidatingWebhook and other integrations (e.g. other proxies).</p> <p>The only attribute of the authorization request that is strictly required is the host name. (See Host lookup for more information.) The other attributes, such as method, path, headers, etc, might as well be required, depending on each <code>AuthConfig</code>. In the case of the gRPC <code>CheckRequest</code> method, the host is supplied in <code>Attributes.Request.Http.Host</code> and alternatively in <code>Attributes.ContextExtensions[\"host\"]</code>. For raw HTTP authorization requests, the host must be supplied in <code>Host</code> HTTP header.</p> <p>Check out Kuadrant for easy-to-use Envoy and Authorino deployment &amp; configuration for API management use-cases, using Kubernetes Custom Resources.</p> Is Authorino an Identity Provider (IdP)? <p>No, Authorino is not an Identity Provider (IdP). Neither it is an auth server of any kind, such as an OAuth2 server, an OpenID Connect (OIDC) server, a Single Sign On (SSO) server.</p> <p>Authorino is not an identity broker either. It can verify access tokens from multiple trusted sources of identity and protocols, but it will not negotiate authentication flows for non-authenticated access requests. Some tricks nonetheless can be done, for example, to redirect unauthenticated users to a login page.</p> <p>For an excellent auth server that checks all the boxes above, check out Keycloak.</p> How does Authorino compare to Keycloak? <p>Keycloak is a proper auth server and identity provider (IdP). It offers a huge set of features for managing identities, identity sources with multiple user federation options, and a platform for authentication and authorization services.</p> <p>Keycloak exposes authenticators that implement protocols such as OpenID Connect. The is a one-time flow that establishes the delegation of power to a client, for a short period of time. To be consistent with Zero Trust security, you want a validator to verify the short-lived tokens in every request that tries to reach your protected service/resource. This step that will repeat everytime could save heavy looking up into big tables of tokens and leverage cached authorization policies for fast in-memory evaluation. This is where Authorino comes in.</p> <p>Authorino verifies and validates Keycloak-issued ID tokens. OpenID Connect Discovery is used to request and cache JSON Web Key Sets (JWKS), used to verify the signature of the tokens without having to contact again with the Keycloak server, or looking in a table of credentials. Moreover, user long-lived credentials are safe, rather than spread in hops across the network.</p> <p>You can also use Keycloak for storing auth-relevant resource metadata. These can be fetched by Authorino in request-time, to be combined into your authorization policies. See Keycloak Authorization Services and User-Managed Access (UMA) support, as well as Authorino UMA external metadata counter-part.</p> Why doesn't Authorino handle OAuth flows? <p>It has to do with trust. OAuth grants are supposed to be negotiated directly between whoever owns the long-lived credentials in one hand (user, service accounts), and the trustworthy auth server that receives those credentials \u2013 ideally with minimum number of hops in the middle \u2013 and exchanges them for short-lived access tokens, on the other end.</p> <p>There are use-cases for Authorino running in the edge (e.g. Edge Authentication Architecture and token normalization), but in most cases Authorino should be seen as a last-mile component that provides decoupled identity verification and authorization policy enforcement to protected services in request-time. In this sense, the OAuth grant is a pre-flight exchange that happens once and as direct and safe as possible, whereas auth enforcement is kept lightweight and efficient.</p> Where does Authorino store users and roles? <p>Authorino does not store users, roles, role bindings, access control lists, or any raw authorization data. Authorino handles policies, where even these policies can be stored elsewhere (as opposed to stated inline inside of an Authorino <code>AuthConfig</code> CR).</p> <p>Authorino evaluates policies for stateless authorization requests. Any additional context is either resolved from the provided payload or static definitions inside the policies. That includes extracting user information from a JWT or client TLS certificate, requesting user metadata from opaque authentication tokens (e.g. API keys) to the trusted sources actually storing that content, obtaining synchronous HTTP metadata from services, etc.</p> <p>In the case of authentication with API keys, as well as its derivative to model HTTP Basic Auth, user data are stored in Kubernetes <code>Secret</code>s. The secret's keys, annotations and labels are usually the structures used to organize the data that later a policy evaluated in Authorino may require. Strictly, those are not Authorino data structures.</p> Can't I just use Envoy JWT Authentication and RBAC filters? <p>Envoy's JWT Authentication works pretty much similar to Authorino's JOSE/JWT verification and validation for OpenID Connect. In both cases, the JSON Web Key Sets (JWKS) to verify the JWTs are auto-loaded and cached to be used in request-time. Moreover, you can configure for details such as where to extract the JWT from the HTTP request (header, param or cookie) and do some cool tricks regarding how dynamic metadata based on JWT claims can be injected to consecutive filters in the chain.</p> <p>However, in terms of authorization, while Envoy's implementation essentially allows to check for the list of audiences (<code>aud</code> JWT claim), Authorino opens up for a lot more options such as pattern-matching rules with operators and conditionals, built-in OPA and other methods of evaluating authorization policies.</p> <p>Authorino also allows to combine JWT authentication with other types of authentication to support different sources of identity and groups of users such as API keys, Kubernetes tokens, OAuth opaque tokens , etc.</p> <p>In summary, Envoy's JWT Authentication and Envoy RBAC filter are excellent solutions for simple use-cases where JWTs from one single issuer is the only authentication method you are planning to support and limited to no authorization rules suffice. On the other hand, if you need to integrate more identity sources, different types of authentication, authorization policies, etc, you might to consider Authorino.</p> Should I use Authorino if I already have Istio configured? <p>Istio is a great solution for managing service meshes. It delivers an excellent platform with an interesting layer of abstraction on top of Envoy proxy's virtual omnipresence within the mesh.</p> <p>There are lots of similarities, but also complementarity between Authorino and Istio and Istio Authorization in special.</p> <p>Istio provides a simple way to enable features that are, in many cases, features of Envoy, such as authorization based on JWTs, authorization based on attributes of the request, and activation of external authorization services, without having to deal with complex Envoy config files. See Kuadrant for a similar approach, nonetheless leveraging features of Istio as well.</p> <p>Authorino is an Envoy-compatible external authorization service. One can use Authorino with or without Istio.</p> <p>In particular, Istio Authorization Policies can be seen, in terms of functionality and expressiveness, as a subset of one type of authorization policies supported by Authorino, the pattern-matching authorization policies. While Istio, however, is heavily focused on specific use cases of API Management, offering a relatively limited list of supported attribute conditions, Authorino is more generic, allowing to express authorization rules for a wider spectrum of use cases \u2013 ACLs, RBAC, ABAC, etc, pretty much counting on any attribute of the Envoy payload, identity object and external metadata available.</p> <p>Authorino also provides built-in OPA authorization, several other methods of authentication and identity verification (e.g. Kubernetes token validation, API key-based authentication, OAuth token introspection, OIDC-discoverable JWT verification, etc), and features like fetching of external metadata (HTTP services, OIDC userinfo, UMA resource data), token normalization, wristband tokens and dynamic responses. These all can be used independently or combined, in a simple and straightforward Kubernetes-native fashion.</p> <p>In summary, one might value Authorino when looking for a policy enforcer that offers:</p> <ol> <li>multiple supported methods and protocols for rather hybrid authentication, encompassing future and legacy auth needs;</li> <li>broader expressiveness and more functionalities for the authorization rules;</li> <li>authentication and authorization in one single declarative manifest;</li> <li>capability to fetch auth metadata from external sources on-the-fly;</li> <li>built-in OPA module;</li> <li>easy token normalization and/or aiming for Edge Authentication Architecture (EAA).</li> </ol> <p>The good news is that, if you have Istio configured, then you have Envoy and the whole platform for wiring Authorino up if you want to. \ud83d\ude09</p> Do I have to learn OPA/Rego language to use Authorino? <p>No, you do not. However, if you are comfortable with Rego from Open Policy Agent (OPA), there are some quite interesting things you can do in Authorino, just as you would in any OPA server or OPA plugin, but leveraging Authorino's built-in OPA module instead. Authorino's OPA module is compiled as part of Authorino's code directly from the Golang packages, and imposes no extra latency to the evaluation of your authorization policies. Even the policies themselves are pre-compiled in reconciliation-time, for fast evaluation afterwards, in request-time.</p> <p>On the other hand, if you do not want to learn Rego or in any case would like to combine it with declarative and Kubernetes-native authN/authZ spec for your services, Authorino does complement OPA with at least two other methods for expressing authorization policies \u2013 i.e. pattern-matching authorization and Kubernetes SubjectAccessReview, the latter allowing to rely completely on the Kubernetes RBAC.</p> <p>You break down, mix and combine these methods and technolgies in as many authorization policies as you want, potentially applying them according to specific conditions. Authorino will trigger the evaluation of concurrent policies in parallel, aborting the context if any of the processes denies access.</p> <p>Authorino also packages well-established industry standards and protocols for identity verification (JOSE/JWT validation, OAuth token introspection, Kubernetes TokenReview) and ad-hoc request-time metadata fetching (OIDC userinfo, User-Managed Access (UMA)), and corresponding layers of caching, without which such functionalities would have to be implemented by code.</p> Can I use Authorino to protect non-REST APIs? <p>Yes, you can. In principle, the API format (REST, gRPC, GraphQL, etc) should not matter for the authN/authZ enforcer. There are a couple points to consider though.</p> <p>While REST APIs are designed in a way that, in most cases, information usually needed for the evaluation of authorization policies are available in the metadata of the HTTP request (method, path, headers), other API formats quite often will require processing of the HTTP body. By default, Envoy's external authorization HTTP filter will not forward the body of the request to Authorino; to change that, enable the <code>with_request_body</code> option in the Envoy configuration for the external authorization filter. E.g.:</p> <pre><code>with_request_body:\n  max_request_bytes: 1024\n  allow_partial_message: true\n  pack_as_bytes: true\n</code></pre> <p>Additionally, when enabling the request body passed in the payload to Authorino, parsing of the content should be of concern as well. Authorino provides easy access to attributes of the HTTP request, parsed as part of the Authorization JSON, however the body of the request is passed as string and should be parsed by the user according to each case.</p> <p>Check out Authorino OPA authorization and the Rego Encoding functions for options to parse serialized JSON, YAML and URL-encoded params. For XML transformation, an external parsing service connected via Authorino's HTTP GET/GET-by-POST external metadata might be required.</p> Can I run Authorino other than on Kubernetes? <p>As of today, no, you cannot, or at least it wouldn't suit production requirements.</p> Do I have to be admin of the cluster to install Authorino? <p>To install the Authorino Custom Resource Definition (CRD) and to define cluster roles required by the Authorino service, admin privilege to the Kubernetes cluster is required. This step happens only once per cluster and is usually equivalent to installing the Authorino Operator.</p> <p>Thereafter, deploying instances of the Authorino service and applying <code>AuthConfig</code> custom resources to a namespace depend on the permissions set by the cluster administrator \u2013 either directly by editing the bindings in the cluster's RBAC, or via options of the operator. In most cases, developers will be granted permissions to create and manage <code>AuthConfig</code>s, and sometimes to deploy their own instances of Authorino.</p> Is it OK to store AuthN/AuthZ configs as Kubernetes objects? <p>Authorino's API checks all the bullets to be aggregated to the Kubernetes cluster APIs, and therefore using Custom Resource Definition (CRD) and the Operator pattern has always been an easy design decision.</p> <p>By merging the definitions of service authN/authZ to the control plane, Authorino <code>AuthConfig</code> resources can be thought as extensions of the specs of the desired state of services regarding the data flow security. The Authorino custom controllers, built-in into the authorization service, are the agents that read from that desired state and reconcile the processes operating in the data plane.</p> <p>Authorino is declarative and seamless for developers and cluster administrators managing the state of security of the applications running in the server, used to tools such as <code>kubectl</code>, the Kubernetes UI and its dashboards. Instead of learning about yet another configuration API format, Authorino users can jump straight to applying and editing YAML or JSON structures they already know, in a way that things such as <code>spec</code>, <code>status</code>, <code>namespace</code> and <code>labels</code> have the meaning they are expected to have, and docs are as close as <code>kubectl explain</code>. Moreover, Authorino does not pile up any other redundant layers of APIs, event-processing, RBAC, transformation and validation webhooks, etc. It is Kubernetes in its best.</p> <p>In terms of scale, Authorino <code>AuthConfig</code>s should grow proportionally to the number of protected services, virtually limited by nothing but the Kubernetes API data storage, while namespace division and label selectors help adjust horizontally and keep distributed.</p> <p>In other words, there are lots of benefits of using Kubernetes custom resources and custom controllers, and unless you are planning on bursting your server with more services than it can keep record, it is totally \ud83d\udc4d to store your AuthN/AuthZ configs as cluster API objects.</p> Can I use Authorino for rate limiting? <p>You can, but you shouldn't. Check out instead Limitador, for simple and efficient global rate limiting. Combine it with Authorino and Authorino's support for Envoy Dynamic Metadata for authenticated rate limiting.</p>"},{"location":"authorino/#benchmarks","title":"Benchmarks","text":"<p>Configuration of the tests (Authorino features):</p> Performance test Identity Metadata Authorization Response <code>ReconcileAuthConfig</code> OIDC/JWT UserInfo, UMA OPA<sup>(inline Rego)</sup> - <code>AuthPipeline</code> OIDC/JWT - JSON pattern-matching<sup>(JWT claim check)</sup> - <code>APIKeyAuthn</code> API key N/A N/A N/A <code>JSONPatternMatchingAuthz</code> N/A N/A JSON pattern-matching N/A <code>OPAAuthz</code> N/A N/A OPA<sup>(inline Rego)</sup> N/A <p>Platform: linux/amd64 CPU: Intel\u00ae Xeon\u00ae Platinum 8370C 2.80GHz Cores: 1, 4, 10</p> <p>Results: <pre><code>ReconcileAuthConfig:\n\n        \u2502   sec/op    \u2502     B/op     \u2502  allocs/op  \u2502\n\n*         1.533m \u00b1 2%   264.4Ki \u00b1 0%   6.470k \u00b1 0%\n*-4       1.381m \u00b1 6%   264.5Ki \u00b1 0%   6.471k \u00b1 0%\n*-10      1.563m \u00b1 5%   270.2Ki \u00b1 0%   6.426k \u00b1 0%\ngeomean   1.491m        266.4Ki        6.456k\n\nAuthPipeline:\n\n        \u2502   sec/op    \u2502     B/op     \u2502 allocs/op  \u2502\n\n*         388.0\u00b5 \u00b1 2%   80.70Ki \u00b1 0%   894.0 \u00b1 0%\n*-4       348.4\u00b5 \u00b1 5%   80.67Ki \u00b1 2%   894.0 \u00b1 3%\n*-10      356.4\u00b5 \u00b1 2%   78.97Ki \u00b1 0%   860.0 \u00b1 0%\ngeomean   363.9\u00b5        80.11Ki        882.5\n\nAPIKeyAuthn:\n\n        \u2502   sec/op    \u2502    B/op      \u2502 allocs/op  \u2502\n\n*         3.246\u00b5 \u00b1 1%   480.0 \u00b1 0%     6.000 \u00b1 0%\n*-4       3.111\u00b5 \u00b1 0%   480.0 \u00b1 0%     6.000 \u00b1 0%\n*-10      3.091\u00b5 \u00b1 1%   480.0 \u00b1 0%     6.000 \u00b1 0%\ngeomean   3.148\u00b5        480.0          6.000\n\nOPAAuthz vs JSONPatternMatchingAuthz:\n\n        \u2502   OPAAuthz   \u2502      JSONPatternMatchingAuthz       \u2502\n        \u2502    sec/op    \u2502   sec/op     vs base                \u2502\n\n*         87.469\u00b5 \u00b1 1%   1.797\u00b5 \u00b1 1%  -97.95% (p=0.000 n=10)\n*-4       95.954\u00b5 \u00b1 3%   1.766\u00b5 \u00b1 0%  -98.16% (p=0.000 n=10)\n*-10      96.789\u00b5 \u00b1 4%   1.763\u00b5 \u00b1 0%  -98.18% (p=0.000 n=10)\ngeomean    93.31\u00b5        1.775\u00b5       -98.10%\n\n        \u2502   OPAAuthz    \u2502      JSONPatternMatchingAuthz      \u2502\n        \u2502     B/op      \u2502    B/op     vs base                \u2502\n\n*         28826.00 \u00b1 0%   64.00 \u00b1 0%  -99.78% (p=0.000 n=10)\n*-4       28844.00 \u00b1 0%   64.00 \u00b1 0%  -99.78% (p=0.000 n=10)\n*-10      28862.00 \u00b1 0%   64.00 \u00b1 0%  -99.78% (p=0.000 n=10)\ngeomean    28.17Ki        64.00       -99.78%\n\n        \u2502   OPAAuthz   \u2502      JSONPatternMatchingAuthz      \u2502\n        \u2502  allocs/op   \u2502 allocs/op   vs base                \u2502\n\n*         569.000 \u00b1 0%   2.000 \u00b1 0%  -99.65% (p=0.000 n=10)\n*-4       569.000 \u00b1 0%   2.000 \u00b1 0%  -99.65% (p=0.000 n=10)\n*-10      569.000 \u00b1 0%   2.000 \u00b1 0%  -99.65% (p=0.000 n=10)\ngeomean     569.0        2.000       -99.65%\n</code></pre></p>"},{"location":"authorino/#contributing","title":"Contributing","text":"<p>If you are interested in contributing to Authorino, please refer to the Developer's guide for info about the stack and requirements, workflow, policies and Code of Conduct.</p> <p>Join us on the #kuadrant channel in the Kubernetes Slack workspace, for live discussions about the roadmap and more.</p>"},{"location":"authorino/#license","title":"License","text":""},{"location":"authorino/docs/","title":"Documentation","text":""},{"location":"authorino/docs/#getting-started","title":"Getting started","text":""},{"location":"authorino/docs/#terminology","title":"Terminology","text":""},{"location":"authorino/docs/#architecture","title":"Architecture","text":""},{"location":"authorino/docs/#feature-description","title":"Feature description","text":""},{"location":"authorino/docs/#user-guides","title":"User guides","text":""},{"location":"authorino/docs/#developers-guide","title":"Developer\u2019s guide","text":""},{"location":"authorino/docs/architecture/","title":"Architecture","text":""},{"location":"authorino/docs/architecture/#overview","title":"Overview","text":"<p>There are a few concepts to understand Authorino's architecture. The main components are: Authorino, Envoy and the Upstream service to be protected. Envoy proxies requests to the configured virtual host upstream service, first contacting with Authorino to decide on authN/authZ.</p> <p>The topology can vary from centralized proxy and centralized authorization service, to dedicated sidecars, with the nuances in between. Read more about the topologies in the Topologies section below.</p> <p>Authorino is deployed using the Authorino Operator, from an <code>Authorino</code> Kubernetes custom resource. Then, from another kind of custom resource, the <code>AuthConfig</code> CRs, each Authorino instance reads and adds to the index the exact rules of authN/authZ to enforce for each protected host (\"index reconciliation\").</p> <p>Everything that the AuthConfig reconciler can fetch in reconciliation-time is stored in the index. This is the case of static parameters such as signing keys, authentication secrets and authorization policies from external policy registries.</p> <p><code>AuthConfig</code>s can refer to identity providers (IdP) and trusted auth servers whose access tokens will be accepted to authenticate to the protected host. Consumers obtain an authentication token (short-lived access token or long-lived API key) and send those in the requests to the protected service.</p> <p>When Authorino is triggered by Envoy via the gRPC interface, it starts evaluating the Auth Pipeline, i.e. it applies to the request the parameters to verify the identity and to enforce authorization, as found in the index for the requested host (See host lookup for details).</p> <p>Apart from static rules, these parameters can include instructions to contact online with external identity verifiers, external sources of metadata and policy decision points (PDPs).</p> <p>On every request, Authorino's \"working memory\" is called Authorization JSON, a data structure that holds information about the context (the HTTP request) and objects from each phase of the auth pipeline: i.e., authentication verification (phase i), ad-hoc metadata fetching (phase ii), authorization policy enforcement (phase iii), dynamic response (phase iv), and callbacks (phase v). The evaluators in each of these phases can both read and write from the Authorization JSON for dynamic steps and decisions of authN/authZ.</p>"},{"location":"authorino/docs/architecture/#topologies","title":"Topologies","text":"<p>Typically, upstream APIs are deployed to the same Kubernetes cluster and namespace where the Envoy proxy and Authorino is running (although not necessarily). Whatever is the case, Envoy must be proxying to the upstream API (see Envoy's HTTP route components and virtual hosts) and pointing to Authorino in the external authorization filter.</p> <p>This can be achieved with different topologies:</p> <ul> <li>Envoy can be a centralized gateway with one dedicated instance of Authorino, proxying to one or more upstream services</li> <li>Envoy can be deployed as a sidecar of each protected service, but still contacting from a centralized Authorino authorization service</li> <li>Both Envoy and Authorino deployed as sidecars of the protected service, restricting all communication between them to localhost</li> </ul> <p>Each topology above induces different measures for security.</p>"},{"location":"authorino/docs/architecture/#centralized-gateway","title":"Centralized gateway","text":"<p>Recommended in the protected services to validate the origin of the traffic. It must have been proxied by Envoy. See Authorino JSON injection for an extra validation option using a shared secret passed in HTTP header.</p>"},{"location":"authorino/docs/architecture/#centralized-authorization-service","title":"Centralized authorization service","text":"<p>Protected service should only listen on <code>localhost</code> and all traffic can be considered safe.</p>"},{"location":"authorino/docs/architecture/#sidecars","title":"Sidecars","text":"<p>Recommended <code>namespaced</code> instances of Authorino with fine-grained label selectors to avoid unnecessary caching of <code>AuthConfig</code>s.</p> <p>Apart from that, protected service should only listen on <code>localhost</code> and all traffic can be considered safe.</p>"},{"location":"authorino/docs/architecture/#cluster-wide-vs-namespaced-instances","title":"Cluster-wide vs. Namespaced instances","text":"<p>Authorino instances can run in either cluster-wide or namespaced mode.</p> <p>Namespace-scoped instances only watch resources (<code>AuthConfig</code>s and <code>Secret</code>s) created in a given namespace. This deployment mode does not require admin privileges over the Kubernetes cluster to deploy the instance of the service (given Authorino's CRDs have been installed beforehand, such as when Authorino is installed using the Authorino Operator).</p> <p>Cluster-wide deployment mode, in contraposition, deploys instances of Authorino that watch resources across the entire cluster, consolidating all resources into a multi-namespace index of auth configs. Admin privileges over the Kubernetes cluster is required to deploy Authorino in cluster-wide mode.</p> <p>Be careful to avoid superposition when combining multiple Authorino instances and instance modes in the same Kubernetes cluster. Apart from caching unnecessary auth config data in the instances depending on your routing settings, the leaders of each instance (set of replicas) may compete for updating the status of the custom resources that are reconciled. See Resource reconciliation and status update for more information.</p> <p>If necessary, use label selectors to narrow down the space of resources watched and reconciled by each Authorino instance. Check out the Sharding section below for details.</p>"},{"location":"authorino/docs/architecture/#the-authorino-authconfig-custom-resource-definition-crd","title":"The Authorino <code>AuthConfig</code> Custom Resource Definition (CRD)","text":"<p>The desired protection for a service is declaratively stated by applying an <code>AuthConfig</code> Custom Resource to the Kubernetes cluster running Authorino.</p> <p>An <code>AuthConfig</code> resource typically looks like the following:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: my-api-protection\nspec:\n    # The list of public host names of the services protected by this AuthConfig resource.\n    # Authorino uses the host name provided in the payload of external authorization request to lookup for the corresponding AuthConfig to enforce.\n  # Hostname collisions are prevented by rejecting to index a hostname already taken by another AuthConfig.\n  # Format: hostname[:port]\n  hosts:\n\n  - my-api.io:443 # north-south traffic\n  - my-api.ns.svc.cluster.local # east-west traffic\n\n  # Set of stored named patterns to be reused in conditions and pattern-matching authorization rules\n  patterns: {\"name\" \u2192 {selector, operator, value}, \u2026}\n\n  # Top-level conditions for the AuthConfig to be enforced.\n  # If omitted, the AuthConfig will be enforced at all requests.\n  # If present, all conditions must match for the AuthConfig to be enforced; otherwise, Authorino skips the AuthConfig and returns to the auth request with status OK.\n  when: [{selector, operator, value | named pattern ref}, \u2026]\n\n  # List of one or more trusted sources of identity:\n  # - Configurations to verify JSON Web Tokens (JWTs) issued by an OpenID Connect (OIDC) server\n  # - Endpoints for OAuth 2.0 token introspection\n  # - Attributes for the Kubernetes `TokenReview` API\n  # - Label selectors for API keys (stored in Kubernetes `Secret`s)\n  # - Label selectors trusted x509 issuer certificates (stored in Kubernetes `Secret`s)\n  # - Selectors for plain identity objects supplied in the payload of the authorization request\n  # - Anonymous access configs\n  authentication: {\"name\" \u2192 {\u2026}, \u2026}\n\n  # List of sources of external metadata for the authorization (optional):\n  # - Endpoints for HTTP GET or GET-by-POST requests\n  # - OIDC UserInfo endpoints (associated with an OIDC token issuer specified in the authentication configs)\n  # - User-Managed Access (UMA) resource registries\n  metadata: {\"name\" \u2192 {\u2026}, \u2026}\n\n  # List of authorization policies to be enforced (optional):\n  # - Pattern-matching rules (e.g. `context.request.http.path eq '/pets'`)\n  # - Open Policy Agent (OPA) inline or external Rego policies\n  # - Attributes for the Kubernetes `SubjectAccessReview` API\n  # \u2013 Attributes for authorization with an external SpiceDB server\n  authorization: {\"name\" \u2192 {\u2026}, \u2026}\n\n  # Customization to the response to the external authorization request (optional)\n  response:\n    # List of dynamic response elements into the request on success authoization (optional):\n    # - Plain text\n    # - JSON objects\n    # - Festival Wristbands (signed JWTs issued by Authorino)\n    success:\n      # List of HTTP headers to inject into the request post-authorization (optional):\n      headers: {\"name\" \u2192 {\u2026}, \u2026}\n\n      # List of Envoy Dynamic Metadata to inject into the request post-authorization (optional):\n      dynamicMetadata: {\"name\" \u2192 {\u2026}, \u2026}\n\n    # Custom HTTP status code, message and headers to replace the default `401 Unauthorized` response (optional)\n    unauthenticated:\n      code: 302\n      message: Redirecting to login\n      headers:\n        \"Location\":\n          value: https://my-app.io/login\n\n    # Custom HTTP status code, message and headers to replace the default `and `403 Forbidden` response (optional)\n    unauthorized: {code, message, headers, body}\n\n  # List of callback targets:\n  # - Endpoints for HTTP requests\n  callbacks: {\"name\" \u2192 {\u2026}, \u2026}\n</code></pre> <p>Check out the OAS of the <code>AuthConfig</code> CRD for a formal specification of the options for <code>authentication</code> verification, external <code>metadata</code> fetching, <code>authorization</code> policies, and dynamic <code>response</code>, as well as any other host protection capability implemented by Authorino.</p> <p>You can also read the specification from the CLI using the <code>kubectl explain</code> command. The Authorino CRD is required to have been installed in Kubernetes cluster. E.g. <code>kubectl explain authconfigs.spec.authentication.overrides</code>.</p> <p>A complete description of supported features and corresponding configuration options within an <code>AuthConfig</code> CR can be found in the Features page.</p> <p>More concrete examples of <code>AuthConfig</code>s for specific use-cases can be found in the User guides.</p>"},{"location":"authorino/docs/architecture/#resource-reconciliation-and-status-update","title":"Resource reconciliation and status update","text":"<p>The instances of the Authorino authorization service workload, following the Operator pattern, watch events related to the <code>AuthConfig</code> custom resources, to build and reconcile an in-memory index of configs. Whenever a replica receives traffic for authorization request, it looks up in the index of <code>AuthConfig</code>s and then triggers the \"Auth Pipeline\", i.e. enforces the associated auth spec onto the request.</p> <p>An instance can be a single authorization service workload or a set of replicas. All replicas watch and reconcile the same set of resources that match the <code>--auth-config-label-selector</code> and <code>--secret-label-selector</code> configuration options. (See both Cluster-wide vs. Namespaced instances and Sharding, for details about defining the reconciliation space of Authorino instances.)</p> <p>The above means that all replicas of an Authorino instance should be able to receive traffic for authorization requests.</p> <p>Among the multiple replicas of an instance, Authorino elects one replica to be leader. The leader is responsible for updating the status of reconciled <code>AuthConfig</code>s. If the leader eventually becomes unavailable, the instance will automatically elect another replica take its place as the new leader.</p> <p>The status of an <code>AuthConfig</code> tells whether the resource is \"ready\" (i.e. indexed). It also includes summary information regarding the numbers of authentication configs, metadata configs, authorization configs and response configs within the spec, as well as whether Festival Wristband tokens are being issued by the Authorino instance as by spec.</p> <p>Apart from watching events related to <code>AuthConfig</code> custom resources, Authorino also watches events related to Kubernetes <code>Secret</code>s, as part of Authorino's API key authentication feature. <code>Secret</code> resources that store API keys are linked to their corresponding <code>AuthConfig</code>s in the index. Whenever the Authorino instance detects a change in the set of API key <code>Secret</code>s linked to an <code>AuthConfig</code>s, the instance reconciles the index.</p> <p>Authorino only watches events related to <code>Secret</code>s whose <code>metadata.labels</code> match the label selector <code>--secret-label-selector</code> of the Authorino instance. The default values of the label selector for Kubernetes <code>Secret</code>s representing Authorino API keys is <code>authorino.kuadrant.io/managed-by=authorino</code>.</p>"},{"location":"authorino/docs/architecture/#the-auth-pipeline-aka-enforcing-protection-in-request-time","title":"The \"Auth Pipeline\" (aka: enforcing protection in request-time)","text":"<p>In each request to the protected API, Authorino triggers the so-called \"Auth Pipeline\", a set of configured evaluators that are organized in a 5-phase pipeline:</p> <ul> <li>(i) Authentication phase: at least one source of identity (i.e., one authentication config) must resolve the supplied credential in the request into a valid identity or Authorino will otherwise reject the request as unauthenticated (401 HTTP response status).</li> <li>(ii) Metadata phase: optional fetching of additional data from external sources, to add up to context and identity information, and used in authorization policies, dynamic responses and callback requests (phases iii to v).</li> <li>(iii) Authorization phase: all unskipped policies must evaluate to a positive result (\"authorized\"), or Authorino will otherwise reject the request as unauthorized (403 HTTP response code).</li> <li>(iv) Response phase \u2013 Authorino builds all user-defined response items (dynamic JSON objects and/or Festival Wristband OIDC tokens), which are supplied back to the external authorization client within added HTTP headers or as Envoy Dynamic Metadata</li> <li>(v) Callbacks phase \u2013 Authorino sends callbacks to specified HTTP endpoints.</li> </ul> <p>Each phase is sequential to the other, from (i) to (v), while the evaluators within each phase are triggered concurrently or as prioritized. The Authentication phase (i) is the only one required to list at least one evaluator (i.e. 1+ authentication configs); Metadata, Authorization and Response phases can have any number of evaluators (including zero, and even be omitted in this case).</p>"},{"location":"authorino/docs/architecture/#host-lookup","title":"Host lookup","text":"<p>Authorino reads the request host from <code>Attributes.Http.Host</code> of Envoy's <code>CheckRequest</code> type, and uses it as key to lookup in the index of <code>AuthConfig</code>s, matched against <code>spec.hosts</code>.</p> <p>Alternatively to <code>Attributes.Http.Host</code>, a <code>host</code> entry can be supplied in the <code>Attributes.ContextExtensions</code> map of the external authorino request. This will take precedence before the host attribute of the HTTP request.</p> <p>The <code>host</code> context extension is useful to support use cases such as of path prefix-based lookup and wildcard subdomains lookup with lookup strongly dictated by the external authorization client (e.g. Envoy), which often knows about routing and the expected <code>AuthConfig</code> to enforce beyond what Authorino can infer strictly based on the host name.</p> <p>Wildcards can also be used in the host names specified in the <code>AuthConfig</code>, resolved by Authorino. E.g. if <code>*.pets.com</code> is in <code>spec.hosts</code>, Authorino will match the concrete host names <code>dogs.pets.com</code>, <code>cats.pets.com</code>, etc. In case, of multiple possible matches, Authorino will try the longest match first (in terms of host name labels) and fall back to the closest wildcard upwards in the domain tree (if any).</p> <p>When more than one host name is specified in the <code>AuthConfig</code>, all of them can be used as key, i.e. all of them can be requested in the authorization request and will be mapped to the same config.</p> <p>Example. Host lookup with wildcards.</p> <p></p> <p>The domain tree above induces the following relation:</p> <ul> <li><code>foo.nip.io</code> \u2192 <code>authconfig-1</code> (matches <code>*.io</code>)</li> <li><code>talker-api.nip.io</code> \u2192 <code>authconfig-2</code> (matches <code>talker-api.nip.io</code>)</li> <li><code>dogs.pets.com</code> \u2192 <code>authconfig-2</code> (matches <code>*.pets.com</code>)</li> <li><code>api.acme.com</code> \u2192 <code>authconfig-3</code> (matches <code>api.acme.com</code>)</li> <li><code>www.acme.com</code> \u2192 <code>authconfig-4</code> (matches <code>*.acme.com</code>)</li> <li><code>foo.org</code> \u2192 <code>404 Not found</code></li> </ul> <p></p> <p>The host can include the port number (i.e. <code>hostname:port</code>) or it can be just the name of the host name. Authorino will first try finding in the index a config associated to <code>hostname:port</code>, as supplied in the authorization request; if the index misses an entry for <code>hostname:port</code>, Authorino will then remove the <code>:port</code> suffix and repeat the lookup using just <code>hostname</code> as key. This provides implicit support for multiple port numbers for a same host without having to list all combinations in the <code>AuthConfig</code>.</p>"},{"location":"authorino/docs/architecture/#avoiding-host-name-collision","title":"Avoiding host name collision","text":"<p>Authorino tries to prevent host name collision between <code>AuthConfig</code>s by rejecting to link in the index any <code>AuthConfig</code> and host name if the host name is already linked to a different <code>AuthConfig</code> in the index. This was intentionally designed to prevent users from superseding each other's <code>AuthConfig</code>s, partially or fully, by just picking the same host names or overlapping host names as others.</p> <p>When wildcards are involved, a host name that matches a host wildcard already linked in the index to another <code>AuthConfig</code> will be considered taken, and therefore the newest <code>AuthConfig</code> will be rejected to be linked to that host.</p> <p>This behavior can be disabled to allow <code>AuthConfig</code>s to partially supersede each others' host names (limited to strict host subsets), by supplying the <code>--allow-superseding-host-subsets</code> command-line flag when running the Authorino instance.</p>"},{"location":"authorino/docs/architecture/#the-authorization-json","title":"The Authorization JSON","text":"<p>On every Auth Pipeline, Authorino builds the Authorization JSON, a \"working-memory\" data structure composed of <code>context</code> (information about the request, as supplied by the Envoy proxy to Authorino) and <code>auth</code> (objects resolved in phases (i) to (v) of the pipeline). The evaluators of each phase can read from the Authorization JSON and implement dynamic properties and decisions based on its values.</p> <p>At phase (iii), the authorization evaluators count on an Authorization JSON payload that looks like the following:</p> <pre><code>// The authorization JSON combined along Authorino's auth pipeline for each request\n{\n  \"context\": { // the input from the proxy\n    \"origin\": {\u2026},\n    \"request\": {\n      \"http\": {\n        \"method\": \"\u2026\",\n        \"headers\": {\u2026},\n        \"path\": \"/\u2026\",\n        \"host\": \"\u2026\",\n        \u2026\n      }\n    }\n  },\n  \"auth\": {\n    \"identity\": {\n      // the identity resolved, from the supplied credentials, by one of the evaluators of phase (i)\n    },\n    \"metadata\": {\n      // each metadata object/collection resolved by the evaluators of phase (ii), by name of the evaluator\n    }\n  }\n}\n</code></pre> <p>The policies evaluated can use any data from the authorization JSON to define authorization rules.</p> <p>After phase (iii), Authorino appends to the authorization JSON the results of this phase as well, and the payload available for phase (iv) becomes:</p> <pre><code>// The authorization JSON combined along Authorino's auth pipeline for each request\n{\n  \"context\": { // the input from the proxy\n    \"origin\": {\u2026},\n    \"request\": {\n      \"http\": {\n        \"method\": \"\u2026\",\n        \"headers\": {\u2026},\n        \"path\": \"/\u2026\",\n        \"host\": \"\u2026\",\n        \u2026\n      }\n    }\n  },\n  \"auth\": {\n    \"identity\": {\n      // the identity resolved, from the supplied credentials, by one of the evaluators of phase (i)\n    },\n    \"metadata\": {\n      // each metadata object/collection resolved by the evaluators of phase (ii), by name of the evaluator\n    },\n    \"authorization\": {\n      // each authorization policy result resolved by the evaluators of phase (iii), by name of the evaluator\n    }\n  }\n}\n</code></pre> <p>Festival Wristbands and Dynamic JSON responses can include dynamic values (custom claims/properties) fetched from the authorization JSON. These can be returned to the external authorization client in added HTTP headers or as Envoy Well Known Dynamic Metadata. Check out Custom response features for details.</p> <p>For information about reading and fetching data from the Authorization JSON (syntax, functions, etc), check out JSON paths.</p>"},{"location":"authorino/docs/architecture/#raw-http-authorization-interface","title":"Raw HTTP Authorization interface","text":"<p>Besides providing the gRPC authorization interface \u2013 that implements the Envoy gRPC authorization server \u2013, Authorino also provides another interface for raw HTTP authorization. This second interface responds to <code>GET</code> and <code>POST</code> HTTP requests sent to <code>:5001/check</code>, and is suitable for other forms of integration, such as:</p> <ul> <li>using Authorino as Kubernetes ValidatingWebhook service (example);</li> <li>other HTTP proxies and API gateways;</li> <li>old versions of Envoy incompatible with the latest version of gRPC external authorization protocol (Authorino is based on v3.19.1 of Envoy external authorization API)</li> </ul> <p>In the raw HTTP interface, the host used to lookup for an <code>AuthConfig</code> must be supplied in the <code>Host</code> HTTP header of the request. Other attributes of the HTTP request are also passed in the context to evaluate the <code>AuthConfig</code>, including the body of the request.</p>"},{"location":"authorino/docs/architecture/#caching","title":"Caching","text":""},{"location":"authorino/docs/architecture/#openid-connect-and-user-managed-access-configs","title":"OpenID Connect and User-Managed Access configs","text":"<p>OpenID Connect and User-Managed Access configurations, discovered usually at reconciliation-time from well-known discovery endpoints.</p> <p>Cached individual OpenID Connect configurations discovered by Authorino can be configured to be auto-refreshed, by setting the corresponding <code>spec.authentication.jwt.ttl</code> field in the AuthConfig (given in seconds, default: <code>0</code> \u2013 i.e. no cache update).</p>"},{"location":"authorino/docs/architecture/#json-web-keys-jwks-and-json-web-key-sets-jwks","title":"JSON Web Keys (JWKs) and JSON Web Key Sets (JWKS)","text":"<p>JSON signature verification certificates linked by discovered OpenID Connect configurations, fetched usually at reconciliation-time.</p>"},{"location":"authorino/docs/architecture/#revoked-access-tokens","title":"Revoked access tokens","text":"Not implemented - In analysis (#19) <p>Caching of access tokens identified and or notified as revoked prior to expiration.</p>"},{"location":"authorino/docs/architecture/#external-metadata","title":"External metadata","text":"Not implemented - Planned (#21) <p>Caching of resource data obtained in previous requests.</p>"},{"location":"authorino/docs/architecture/#compiled-rego-policies","title":"Compiled Rego policies","text":"<p>Performed automatically by Authorino at reconciliation-time for the authorization policies based on the built-in OPA module.</p> <p>Precompiled and cached individual Rego policies originally pulled by Authorino from external registries can be configured to be auto-refreshed, by setting the corresponding <code>spec.authorization.opa.externalRegistry.ttl</code> field in the AuthConfig (given in seconds, default: <code>0</code> \u2013 i.e. no cache update).</p>"},{"location":"authorino/docs/architecture/#repeated-requests","title":"Repeated requests","text":"Not implemented - In analysis (#20) <p>For consecutive requests performed, within a given period of time, by a same user that request for a same resource, such that the result of the auth pipeline can be proven that would not change.</p>"},{"location":"authorino/docs/architecture/#sharding","title":"Sharding","text":"<p>By default, Authorino instances will watch <code>AuthConfig</code> CRs in the entire space (namespace or entire cluster; see Cluster-wide vs. Namespaced instances for details). To support combining multiple Authorino instances and instance modes in the same Kubernetes cluster, and yet avoiding superposition between the instances (i.e. multiple instances reconciling the same <code>AuthConfig</code>s), Authorino offers support for data sharding, i.e. to horizontally narrow down the space of reconciliation of an Authorino instance to a subset of that space.</p> <p>The benefits of limiting the space of reconciliation of an Authorino instance include avoiding unnecessary caching and workload in instances that do not receive corresponding traffic (according to your routing settings) and preventing leaders of multiple instances (sets of replicas) to compete on resource status updates (see Resource reconciliation and status update for details).</p> <p>Use-cases for sharding of <code>AuthConfig</code>s:</p> <ul> <li>Horizontal load balancing of traffic of authorization requests</li> <li>Supporting for managed centralized instances of Authorino to API owners who create and maintain their own <code>AuthConfig</code>s within their own user namespaces.</li> </ul> <p>Authorino's custom controllers filter the <code>AuthConfig</code>-related events to be reconciled using Kubernetes label selectors, defined for the Authorino instance via <code>--auth-config-label-selector</code> command-line flag. By default, <code>--auth-config-label-selector</code> is empty, meaning all <code>AuthConfig</code>s in the space are watched; this variable can be set to any value parseable as a valid label selector, causing Authorino to then watch only events of <code>AuthConfig</code>s whose <code>metadata.labels</code> match the selector.</p> <p>The following are all valid examples of <code>AuthConfig</code> label selector filters:</p> <pre><code>--auth-config-label-selector=\"authorino.kuadrant.io/managed-by=authorino\"\n--auth-config-label-selector=\"authorino.kuadrant.io/managed-by=authorino,other-label=other-value\"\n--auth-config-label-selector=\"authorino.kuadrant.io/managed-by in (authorino,kuadrant)\"\n--auth-config-label-selector=\"authorino.kuadrant.io/managed-by!=authorino-v0.4\"\n--auth-config-label-selector=\"!disabled\"\n</code></pre>"},{"location":"authorino/docs/architecture/#rbac","title":"RBAC","text":"<p>The table below describes the roles and role bindings defined by the Authorino service:</p> Role Kind Scope(*) Description Permissions <code>authorino-manager-role</code> <code>ClusterRole</code> C/N Role of the Authorino manager service Watch and reconcile <code>AuthConfig</code>s and <code>Secret</code>s <code>authorino-manager-k8s-auth-role</code> <code>ClusterRole</code> C/N Role for the Kubernetes auth features Create <code>TokenReview</code>s and <code>SubjectAccessReview</code>s (Kubernetes auth) <code>authorino-leader-election-role</code> <code>Role</code> N Leader election role Create/update the <code>ConfigMap</code> used to coordinate which replica of Authorino is the leader <code>authorino-authconfig-editor-role</code> <code>ClusterRole</code> - <code>AuthConfig</code> editor R/W <code>AuthConfig</code>s; Read <code>AuthConfig/status</code> <code>authorino-authconfig-viewer-role</code> <code>ClusterRole</code> - <code>AuthConfig</code> viewer Read <code>AuthConfig</code>s and <code>AuthConfig/status</code> <code>authorino-proxy-role</code> <code>ClusterRole</code> C/N Kube-rbac-proxy-role (sidecar)'s role Create <code>TokenReview</code>s and <code>SubjectAccessReview</code>s to check permissions to the <code>/metrics</code> endpoint <code>authorino-metrics-reader</code> <code>ClusterRole</code> - Metrics reader <code>GET /metrics</code> <p>(*) C - Cluster-wide | N - Authorino namespace | C/N - Cluster-wide or Authorino namespace (depending on the deployment mode).</p>"},{"location":"authorino/docs/architecture/#observability","title":"Observability","text":"<p>Please refer to the Observability user guide for info on Prometheus metrics exported by Authorino, readiness probe, logging, tracing, etc.</p>"},{"location":"authorino/docs/code_of_conduct/","title":"Code of conduct","text":""},{"location":"authorino/docs/code_of_conduct/#code-of-conduct","title":"Code of Conduct","text":"<p>Autorino follows the Kuadrant Community Code of Conduct, which is based on the CNCF Code of Conduct.</p> <p>Please refer to this page for a description of the standards and values we stand for in our relationship with the community.</p>"},{"location":"authorino/docs/contributing/","title":"Developer's Guide","text":""},{"location":"authorino/docs/contributing/#technology-stack-for-developers","title":"Technology stack for developers","text":"<p>Minimum requirements to contribute to Authorino are:</p> <ul> <li>Golang v1.21+</li> <li>Docker</li> </ul> <p>Authorino's code was originally bundled using the Operator SDK (v1.9.0).</p> <p>The following tools can be installed as part of the development workflow:</p> <ul> <li> <p>Installed with <code>go install</code> to the <code>$PROJECT_DIR/bin</code> directory:</p> <ul> <li>controller-gen: for building custom types and manifests</li> <li>Kustomize: for assembling flavoured manifests and installing/deploying</li> <li>setup-envtest: for running the tests \u2013 extra tools installed to <code>./testbin</code></li> <li>benchstat: for human-friendly test benchmark reports</li> <li>mockgen: to generate mocks for tests \u2013 e.g. <code>./bin/mockgen -source=pkg/auth/auth.go -destination=pkg/auth/mocks/mock_auth.go</code></li> <li>Kind: for deploying a containerized Kubernetes cluster for integration testing purposes</li> </ul> </li> <li> <p>Other recommended tools to have installed:</p> <ul> <li>jq</li> <li>yq</li> <li>gnu-sed</li> </ul> </li> </ul>"},{"location":"authorino/docs/contributing/#workflow","title":"Workflow","text":""},{"location":"authorino/docs/contributing/#check-the-issues","title":"Check the issues","text":"<p>Start by checking the list of issues in GitHub.</p> <p>In case you want to contribute with an idea for enhancement, a bug fix, or question, please make sure to describe the issue so we can start a conversation together and help you find the best way to get your contribution merged.</p>"},{"location":"authorino/docs/contributing/#clone-the-repo-and-setup-the-local-environment","title":"Clone the repo and setup the local environment","text":"<p>Fork/clone the repo:</p> <pre><code>git clone git@github.com:kuadrant/authorino.git &amp;&amp; cd authorino\n</code></pre> <p>Download the Golang dependencies: <pre><code>make vendor\n</code></pre></p> <p>For additional automation provided, check:</p> <pre><code>make help\n</code></pre>"},{"location":"authorino/docs/contributing/#make-your-changes","title":"Make your changes","text":"<p>Good changes...</p> <ul> <li>follow the Golang conventions</li> <li>have proper test coverage</li> <li>address corresponding updates to the docs</li> <li>help us fix wherever we failed to do the above \ud83d\ude1c</li> </ul>"},{"location":"authorino/docs/contributing/#run-the-tests","title":"Run the tests","text":"<p>To run the tests:</p> <pre><code>make test\n</code></pre>"},{"location":"authorino/docs/contributing/#try-locally","title":"Try locally","text":""},{"location":"authorino/docs/contributing/#build-deploy-and-try-authorino-in-a-local-cluster","title":"Build, deploy and try Authorino in a local cluster","text":"<p>The following command will:</p> <ul> <li>Start a local Kubernetes cluster (using Kind)</li> <li>Install cert-manager in the cluster</li> <li>Install the Authorino Operator and Authorino CRDs</li> <li>Build an image of Authorino based on the current branch</li> <li>Push the freshly built image to the cluster's registry</li> <li>Generate TLS certificates for the Authorino service</li> <li>Deploy an instance of Authorino</li> <li>Deploy the example application Talker API, a simple HTTP API that echoes back whatever it gets in the request</li> <li>Setup Envoy for proxying to the Talker API and using Authorino for external authorization</li> </ul> <pre><code>make local-setup\n</code></pre> <p>You will be prompted to edit the <code>Authorino</code> custom resource.</p> <p>The main workload composed of Authorino instance and user apps (Envoy, Talker API) will be deployed to the <code>default</code> Kubernetes namespace.</p> <p>Once the deployment is ready, you can forward the requests on port 8000 to the Envoy service</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 &amp;\n</code></pre> Pro tips <ol> <li>Change the default workload namespace by supplying the <code>NAMESPACE</code> argument to your <code>make local-setup</code> and other deployment, apps and local cluster related targets. If the namespace does not exist, it will be created.</li> <li>Switch to TLS disabled by default when deploying locally by supplying <code>TLS_ENABLED=0</code> to your <code>make local-setup</code> and <code>make deploy</code> commands. E.g. <code>make local-setup TLS_ENABLED=0</code>.</li> <li>Skip being prompted to edit the <code>Authorino</code> CR and default to an Authorino deployment with TLS enabled, debug/development log level/mode, and standard name 'authorino', by supplying <code>FF=1</code> to your <code>make local-setup</code> and <code>make deploy</code> commands. E.g. <code>make local-setup FF=1</code></li> <li>Supply <code>DEPLOY_IDPS=1</code> to <code>make local-setup</code> and <code>make user-apps</code> to deploy Keycloak and Dex to the cluster. <code>DEPLOY_KEYCLOAK</code> and <code>DEPLOY_DEX</code> are also available. Read more about additional tools for specific use cases in the section below.</li> <li>Saving the ID of the process (PID) of the port-forward command spawned in the background can be useful to later kill and restart the process. E.g. <code>kubectl port-forward deployment/envoy 8000:8000 &amp;;PID=$!</code>; then <code>kill $PID</code>.</li> </ol>"},{"location":"authorino/docs/contributing/#additional-tools-for-specific-use-cases","title":"Additional tools (for specific use-cases)","text":"Limitador <p>To deploy Limitador \u2013 pre-configured in Envoy for rate-limiting the Talker API to 5 hits per minute per <code>user_id</code> when available in the cluster workload \u2013, run:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/limitador/limitador-deploy.yaml\n</code></pre> Keycloak <p>Authorino examples include a bundle of Keycloak preloaded with the following realm setup:</p> <ul> <li>Admin console: http://localhost:8080/admin  (admin/p)</li> <li>Preloaded realm: kuadrant</li> <li>Preloaded clients:<ul> <li>demo: to which API consumers delegate access and therefore the one which access tokens are issued to</li> <li>authorino: used by Authorino to fetch additional user info with <code>client_credentials</code> grant type</li> <li>talker-api: used by Authorino to fetch UMA-protected resource data associated with the Talker API</li> </ul> </li> <li>Preloaded resources:<ul> <li><code>/hello</code></li> <li><code>/greetings/1</code> (owned by user john)</li> <li><code>/greetings/2</code> (owned by user jane)</li> <li><code>/goodbye</code></li> </ul> </li> <li>Realm roles:<ul> <li>member (default to all users)</li> <li>admin</li> </ul> </li> <li>Preloaded users:<ul> <li>john/p (member)</li> <li>jane/p (admin)</li> <li>peter/p (member, email not verified)</li> </ul> </li> </ul> <p>To deploy, run:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p>Forward local requests to the instance of Keycloak running in the cluster:</p> <pre><code>kubectl port-forward deployment/keycloak 8080:8080 &amp;\n</code></pre> Dex <p>Authorino examples include a bundle of Dex preloaded with the following setup:</p> <ul> <li>Preloaded clients:<ul> <li>demo: to which API consumers delegate access and therefore the one which access tokens are issued to (Client secret: aaf88e0e-d41d-4325-a068-57c4b0d61d8e)</li> </ul> </li> <li>Preloaded users:<ul> <li>marta@localhost/password</li> </ul> </li> </ul> <p>To deploy, run:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/dex/dex-deploy.yaml\n</code></pre> <p>Forward local requests to the instance of Dex running in the cluster:</p> <pre><code>kubectl port-forward deployment/dex 5556:5556 &amp;\n</code></pre> a12n-server <p>Authorino examples include a bundle of a12n-server and corresponding MySQL database, preloaded with the following setup:</p> <ul> <li>Admin console: http://a12n-server:8531 (admin/123456)</li> <li>Preloaded clients:<ul> <li>service-account-1: to obtain access tokens via <code>client_credentials</code> OAuth2 grant type, to consume the Talker API (Client secret: DbgXROi3uhWYCxNUq_U1ZXjGfLHOIM8X3C2bJLpeEdE); includes metadata privilege: <code>{ \"talker-api\": [\"read\"] }</code> that can be used to write authorization policies</li> <li>talker-api: to authenticate to the token introspect endpoint (Client secret: V6g-2Eq2ALB1_WHAswzoeZofJ_e86RI4tdjClDDDb4g)</li> </ul> </li> </ul> <p>To deploy, run:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/a12n-server/a12n-server-deploy.yaml\n</code></pre> <p>Forward local requests to the instance of a12n-server running in the cluster:</p> <pre><code>kubectl port-forward deployment/a12n-server 8531:8531 &amp;\n</code></pre>"},{"location":"authorino/docs/contributing/#re-build-and-rollout-latest","title":"Re-build and rollout latest","text":"<p>Re-build and rollout latest Authorino image:</p> <pre><code>make local-rollout\n</code></pre> <p>If you made changes to the CRD between iterations, re-install by running:</p> <pre><code>make install\n</code></pre>"},{"location":"authorino/docs/contributing/#clean-up","title":"Clean-up","text":"<p>The following command deletes the entire Kubernetes cluster started with Kind:</p> <pre><code>make local-cleanup\n</code></pre>"},{"location":"authorino/docs/contributing/#sign-your-commits","title":"Sign your commits","text":"<p>All commits to be accepted to Authorino's code are required to be signed. Refer to this page about signing your commits.</p>"},{"location":"authorino/docs/contributing/#logging-policy","title":"Logging policy","text":"<p>A few guidelines for adding logging messages in your code:</p> <ol> <li>Make sure you understand Authorino's Logging architecture and policy regarding log levels, log modes, tracing IDs, etc.</li> <li>Respect controller-runtime's Logging Guidelines.</li> <li>Do not add sensitive data to your <code>info</code> log messages; instead, redact all sensitive data in your log messages or use <code>debug</code> log level by mutating the logger with <code>V(1)</code> before outputting the message.</li> </ol>"},{"location":"authorino/docs/contributing/#additional-resources","title":"Additional resources","text":"<p>Here in the repo:</p> <ul> <li>Getting started</li> <li>Terminology</li> <li>Architecture</li> <li>Feature description</li> </ul> <p>Other repos:</p> <ul> <li>Authorino Operator</li> <li>Authorino examples</li> </ul>"},{"location":"authorino/docs/contributing/#reach-out","title":"Reach out","text":"<p>#kuadrant channel on kubernetes.slack.com.</p>"},{"location":"authorino/docs/features/","title":"Features","text":""},{"location":"authorino/docs/features/#overview","title":"Overview","text":"<p>We call features of Authorino the different things one can do to enforce identity verification &amp; authentication and authorization on requests to protected services. These can be a specific identity verification method based on a supported authentication protocol, or a method to fetch additional auth metadata in request-time, etc.</p> <p>Most features of Authorino relate to the different phases of the Auth Pipeline and therefore are configured in the Authorino <code>AuthConfig</code>. An identity verification/authentication feature usually refers to a functionality of Authorino such as the API key-based authentication, the validation of JWTs/OIDC ID tokens, and authentication based on Kubernetes TokenReviews. Analogously, OPA, pattern-matching and Kubernetes SubjectAccessReview are examples of authorization features of Authorino.</p> <p>At a deeper level, a feature can also be an additional functionality within a bigger feature, usually applicable to the whole class the bigger feature belongs to. For instance, the configuration of how auth credentials expected to be carried in the request, which is broadly available for any identity verification method. Other examples are: Identity extension and Priorities.</p> <p>A full specification of all features of Authorino that can be configured in an <code>AuthConfig</code> can be found in the official spec of the custom resource definition.</p> <p>You can also learn about Authorino features by using the <code>kubectl explain</code> command in a Kubernetes cluster where the Authorino CRD has been installed. E.g. <code>kubectl explain authconfigs.spec.authentication.credentials</code>.</p>"},{"location":"authorino/docs/features/#common-feature-json-paths-selector","title":"Common feature: JSON paths (<code>selector</code>)","text":"<p>The first feature of Authorino to learn about is a common functionality used in the specification of many other features. JSON paths are selectors of data from the Authorization JSON used in parts of an AuthConfig for referring to dynamic values of each authorization request.</p> <p>Usage examples of JSON paths are: dynamic URLs and request parameters when fetching metadata from external sources, dynamic authorization policy rules, and dynamic authorization response attributes (e.g. injected HTTP headers, Festival Wristband token claims, etc).</p>"},{"location":"authorino/docs/features/#syntax","title":"Syntax","text":"<p>The syntax to fetch data from the Authorization JSON with JSON paths is based on GJSON. Refer to GJSON Path Syntax page for more information.</p>"},{"location":"authorino/docs/features/#string-modifiers","title":"String modifiers","text":"<p>On top of GJSON, Authorino defines a few string modifiers.</p> <p>Examples below provided for the following Authorization JSON:</p> <pre><code>{\n  \"context\": {\n    \"request\": {\n      \"http\": {\n        \"path\": \"/pets/123\",\n        \"headers\": {\n          \"authorization\": \"Basic amFuZTpzZWNyZXQK\" // jane:secret\n          \"baggage\": \"eyJrZXkxIjoidmFsdWUxIn0=\" // {\"key1\":\"value1\"}\n        }\n      }\n    }\n  },\n  \"auth\": {\n    \"identity\": {\n      \"username\": \"jane\",\n      \"fullname\": \"Jane Smith\",\n      \"email\": \"\\u0006jane\\u0012@petcorp.com\\n\"\n    },\n  },\n}\n</code></pre> <p><code>@strip</code> Strips out any non-printable characters such as carriage return. E.g. <code>auth.identity.email.@strip</code> \u2192 <code>\"jane@petcorp.com\"</code>.</p> <p><code>@case:upper|lower</code> Changes the case of a string. E.g. <code>auth.identity.username.@case:upper</code> \u2192 <code>\"JANE\"</code>.</p> <p><code>@replace:{\"old\":string,\"new\":string}</code> Replaces a substring within a string. E.g. <code>auth.identity.username.@replace:{\"old\":\"Smith\",\"new\":\"Doe\"}</code> \u2192 <code>\"Jane Doe\"</code>.</p> <p><code>@extract:{\"sep\":string,\"pos\":int}</code> Splits a string at occurrences of a separator (default: <code>\" \"</code>) and selects the substring at the <code>pos</code>-th position (default: <code>0</code>). E.g. <code>context.request.path.@extract:{\"sep\":\"/\",\"pos\":2}</code> \u2192 <code>123</code>.</p> <p><code>@base64:encode|decode</code> base64-encodes or decodes a string value. E.g. <code>auth.identity.username.decoded.@base64:encode</code> \u2192 <code>\"amFuZQo=\"</code>.</p> <p>In combination with <code>@extract</code>, <code>@base64</code> can be used to extract the username in an HTTP Basic Authentication request. E.g. <code>context.request.headers.authorization.@extract:{\"pos\":1}|@base64:decode|@extract:{\"sep\":\":\",\"pos\":1}</code> \u2192 <code>\"jane\"</code>.</p>"},{"location":"authorino/docs/features/#interpolation","title":"Interpolation","text":"<p>JSON paths can be interpolated into strings to build template-like dynamic values. E.g. <code>\"Hello, {auth.identity.name}!\"</code>.</p>"},{"location":"authorino/docs/features/#identity-verification-authentication-features-authentication","title":"Identity verification &amp; authentication features (<code>authentication</code>)","text":""},{"location":"authorino/docs/features/#api-key-authenticationapikey","title":"API key (<code>authentication.apiKey</code>)","text":"<p>Authorino relies on Kubernetes <code>Secret</code> resources to represent API keys.</p> <p>To define an API key, create a <code>Secret</code> in the cluster containing an <code>api_key</code> entry that holds the value of the API key.</p> <p>API key secrets must be created in the same namespace of the <code>AuthConfig</code> (default) or <code>spec.authentication.apiKey.allNamespaces</code> must be set to <code>true</code> (only works with cluster-wide Authorino instances).</p> <p>API key secrets must be labeled with the labels that match the selectors specified in <code>spec.authentication.apiKey.selector</code> in the <code>AuthConfig</code>.</p> <p>Whenever an <code>AuthConfig</code> is indexed, Authorino will also index all matching API key secrets. In order for Authorino to also watch events related to API key secrets individually (e.g. new <code>Secret</code> created, updates, deletion/revocation), <code>Secret</code>s must also include a label that matches Authorino's bootstrap configuration <code>--secret-label-selector</code> (default: <code>authorino.kuadrant.io/managed-by=authorino</code>). This label may or may not be present to <code>spec.authentication.apiKey.selector</code> in the <code>AuthConfig</code> without implications for the caching of the API keys when triggered by the reconciliation of the <code>AuthConfig</code>; however, if not present, individual changes related to the API key secret (i.e. without touching the <code>AuthConfig</code>) will be ignored by the reconciler.</p> <p>Example. For the following <code>AuthConfig</code>:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: my-api-protection\n  namespace: authorino-system\nspec:\n  hosts:\n\n  - my-api.io\n  authentication:\n    \"api-key-users\":\n      apiKey:\n        selector:\n          matchLabels: # the key-value set used to select the matching `Secret`s; resources including these labels will be accepted as valid API keys to authenticate to this service\n            group: friends # some custom label\n        allNamespaces: true # only works with cluster-wide Authorino instances; otherwise, create the API key secrets in the same namespace of the AuthConfig\n</code></pre> <p>The following Kubernetes <code>Secret</code> represents a valid API key:</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: user-1-api-key-1\n  namespace: default\n  labels:\n    authorino.kuadrant.io/managed-by: authorino # so the Authorino controller reconciles events related to this secret\n    group: friends\nstringData:\n  api_key: &lt;some-randomly-generated-api-key-value&gt;\ntype: Opaque\n</code></pre> <p>The resolved identity object, added to the authorization JSON following an API key identity source evaluation, is the Kubernetes <code>Secret</code> resource (as JSON).</p>"},{"location":"authorino/docs/features/#kubernetes-tokenreview-authenticationkubernetestokenreview","title":"Kubernetes TokenReview (<code>authentication.kubernetesTokenReview</code>)","text":"<p>Authorino can verify Kubernetes-valid access tokens (using Kubernetes TokenReview API).</p> <p>These tokens can be either <code>ServiceAccount</code> tokens such as the ones issued by kubelet as part of Kubernetes Service Account Token Volume Projection, or any valid user access tokens issued to users of the Kubernetes server API.</p> <p>The list of <code>audiences</code> of the token must include the requested host and port of the protected API (default), or all audiences specified in the Authorino <code>AuthConfig</code> custom resource. For example:</p> <p>For the following <code>AuthConfig</code> CR, the Kubernetes token must include the audience <code>my-api.io</code>:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: my-api-protection\nspec:\n  hosts:\n\n  - my-api.io\n  authentication:\n    \"cluster-users\":\n      kubernetesTokenReview: {}\n</code></pre> <p>Whereas for the following <code>AuthConfig</code> CR, the Kubernetes token audiences must include foo and bar:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: my-api-protection\nspec:\n  hosts:\n\n  - my-api.io\n  authentication:\n    \"cluster-users\":\n      kubernetesTokenReview:\n        audiences:\n        - foo\n        - bar\n</code></pre> <p>The resolved identity object added to the authorization JSON following a successful Kubernetes authentication identity evaluation is the <code>status</code> field of TokenReview response (see TokenReviewStatus for reference).</p>"},{"location":"authorino/docs/features/#jwt-verification-authenticationjwt","title":"JWT verification (<code>authentication.jwt</code>)","text":"<p>In reconciliation-time, using OpenID Connect Discovery well-known endpoint, Authorino automatically discovers and caches OpenID Connect configurations and associated JSON Web Key Sets (JWKS) for all OpenID Connect issuers declared in an <code>AuthConfig</code>. Then, in request-time, Authorino verifies the JSON Web Signature (JWS) and check the time validity of signed JSON Web Tokens (JWT) supplied on each request.</p> <p>Important! Authorino does not implement OAuth2 grants nor OIDC authentication flows. As a common recommendation of good practice, obtaining and refreshing access tokens is for clients to negotiate directly with the auth servers and token issuers. Authorino will only validate those tokens using the parameters provided by the trusted issuer authorities.</p> <p></p> <p>The <code>kid</code> claim stated in the JWT header must match one of the keys cached by Authorino during OpenID Connect Discovery, therefore supporting JWK rotation.</p> <p>The decoded payload of the validated JWT is appended to the authorization JSON as the resolved identity.</p> <p>OpenID Connect configurations and linked JSON Web Key Sets can be configured to be automatically refreshed (pull again from the OpenID Connect Discovery well-known endpoints), by setting the <code>authentication.jwt.ttl</code> field (given in seconds, default: <code>0</code> \u2013 i.e. auto-refresh disabled).</p> <p>For an excellent summary of the underlying concepts and standards that relate OpenID Connect and JSON Object Signing and Encryption (JOSE), see this article by Jan Rusnacko. For official specification and RFCs, see OpenID Connect Core, OpenID Connect Discovery, JSON Web Token (JWT) (RFC7519), and JSON Object Signing and Encryption (JOSE).</p>"},{"location":"authorino/docs/features/#oauth-20-introspection-authenticationoauth2introspection","title":"OAuth 2.0 introspection (<code>authentication.oauth2Introspection</code>)","text":"<p>For bare OAuth 2.0 implementations, Authorino can perform token introspection on the access tokens supplied in the requests to protected APIs.</p> <p>Authorino does not implement any of OAuth 2.0 grants for the applications to obtain the token. However, it can verify supplied tokens with the OAuth server, including opaque tokens, as long as the server exposes the <code>token_introspect</code> endpoint (RFC 7662).</p> <p>Developers must set the token introspection endpoint in the <code>AuthConfig</code>, as well as a reference to the Kubernetes secret storing the credentials of the OAuth client to be used by Authorino when requesting the introspect.</p> <p></p> <p>The response returned by the OAuth2 server to the token introspection request is the resolved identity appended to the authorization JSON.</p>"},{"location":"authorino/docs/features/#x509-client-certificate-authentication-authenticationx509","title":"X.509 client certificate authentication (<code>authentication.x509</code>)","text":"<p>Authorino can verify X.509 certificates presented by clients for authentication on the request to the protected APIs, at application level.</p> <p>Trusted root Certificate Authorities (CA) are stored in Kubernetes Secrets labeled according to selectors specified in the AuthConfig, watched and indexed by Authorino. Make sure to create proper <code>kubernetes.io/tls</code>-typed Kubernetes Secrets, containing the public certificates of the CA stored in either a <code>tls.crt</code> or <code>ca.crt</code> entry inside the secret.</p> <p>Trusted root CA secrets must be created in the same namespace of the <code>AuthConfig</code> (default) or <code>spec.authentication.x509.allNamespaces</code> must be set to <code>true</code> (only works with cluster-wide Authorino instances).</p> <p>Client certificates must include x509 v3 extension specifying 'Client Authentication' extended key usage.</p> <p>The identity object resolved out of a client x509 certificate is equal to the subject field of the certificate, and it serializes as JSON within the Authorization JSON usually as follows:</p> <pre><code>{\n    \"auth\": {\n        \"identity\": {\n            \"CommonName\": \"aisha\",\n            \"Country\": [\"PK\"],\n            \"ExtraNames\": null,\n            \"Locality\": [\"Islamabad\"],\n            \"Names\": [\n                { \"Type\": [2, 5, 4, 3], \"Value\": \"aisha\" },\n                { \"Type\": [2, 5, 4, 6], \"Value\": \"PK\" },\n                { \"Type\": [2, 5, 4, 7], \"Value\": \"Islamabad\" },\n                { \"Type\": [2, 5, 4,10], \"Value\": \"ACME Inc.\" },\n                { \"Type\": [2, 5, 4,11], \"Value\": \"Engineering\" }\n            ],\n            \"Organization\": [\"ACME Inc.\"],\n            \"OrganizationalUnit\": [\"Engineering\"],\n            \"PostalCode\": null,\n            \"Province\": null,\n            \"SerialNumber\": \"\",\n            \"StreetAddress\": null\n        }\n  }\n}\n</code></pre>"},{"location":"authorino/docs/features/#plain-authenticationplain","title":"Plain (<code>authentication.plain</code>)","text":"<p>Authorino can read plain identity objects, based on authentication tokens provided and verified beforehand using other means (e.g. Envoy JWT Authentication filter, Kubernetes API server authentication), and injected into the payload to the external authorization service.</p> <p>The plain identity object is retrieved from the Authorization JSON based on a JSON path specified in the <code>AuthConfig</code>.</p> <p>This feature is particularly useful in cases where authentication/identity verification is handled before invoking the authorization service and its resolved value injected in the payload can be trusted. Examples of applications for this feature include:</p> <ul> <li>Authentication handled in Envoy leveraging the Envoy JWT Authentication filter (decoded JWT injected as 'metadata_context')</li> <li>Use of Authorino as Kubernetes ValidatingWebhook service (Kubernetes 'userInfo' injected in the body of the <code>AdmissionReview</code> request)</li> </ul> <p>Example of <code>AuthConfig</code> to retrieve plain identity object from the Authorization JSON.</p> <pre><code>spec:\n  authentication:\n    \"pre-validated-jwt\":\n      plain:\n        selector: context.metadata_context.filter_metadata.envoy\\.filters\\.http\\.jwt_authn|verified_jwt\n</code></pre> <p>If the specified JSON path does not exist in the Authorization JSON or the value is <code>null</code>, the identity verification will fail and, unless other identity config succeeds, Authorino will halt the Auth Pipeline with the usual <code>401 Unauthorized</code>.</p>"},{"location":"authorino/docs/features/#anonymous-access-authenticationanonymous","title":"Anonymous access (<code>authentication.anonymous</code>)","text":"<p>Literally a no-op evaluator for the identity verification phase that returns a static identity object <code>{\"anonymous\":true}</code>.</p> <p>It allows to implement <code>AuthConfigs</code> that bypasses the identity verification phase of Authorino, to such as:</p> <ul> <li>enable anonymous access to protected services (always or combined with Priorities)</li> <li>postpone authentication in the Auth Pipeline to be resolved as part of an OPA policy</li> </ul> <p>Example of <code>AuthConfig</code> spec that falls back to anonymous access when OIDC authentication fails, enforcing read-only access to the protected service in such cases:</p> <pre><code>spec:\n  authentication:\n    \"jwt\":\n      jwt:\n        issuerUrl: \"\u2026\"\n    \"anonymous\":\n      priority: 1 # expired oidc token, missing creds, etc. default to anonymous access\n      anonymous: {}\n  authorization:\n    \"read-only-access-if-authn-fails\":\n      when:\n\n        - selector: auth.identity.anonymous\n          operator: eq\n          value: \"true\"\n      patternMatching:\n        patterns:\n        - selector: context.request.http.method\n          operator: eq\n          value: GET\n</code></pre>"},{"location":"authorino/docs/features/#festival-wristband-authentication","title":"Festival Wristband authentication","text":"<p>Authorino-issued Festival Wristband tokens can be validated as any other signed JWT using Authorino's JWT verification.</p> <p>The value of the issuer must be the same issuer specified in the custom resource for the protected API originally issuing wristband. Eventually, this can be the same custom resource where the wristband is configured as a valid source of identity, but not necessarily.</p>"},{"location":"authorino/docs/features/#extra-auth-credentials-authenticationcredentials","title":"Extra: Auth credentials (<code>authentication.credentials</code>)","text":"<p>All the identity verification methods supported by Authorino can be configured regarding the location where access tokens and credentials (i.e. authentication secrets) fly within the request.</p> <p>By default, authentication secrets are expected to be supplied in the <code>Authorization</code> HTTP header, with the default <code>Bearer</code> prefix and the plain authentication secret separated by space.</p> <p>The full list of supported options is exemplified below:</p> <pre><code>spec:\n  authentication:\n    \"creds-in-the-authz-header\":\n      credentials:\n        authorizationHeader:\n          prefix: JWT\n\n    \"creds-in-a-custom-header\":\n      credentials:\n        customHeader:\n          name: X-MY-CUSTOM-HEADER\n          prefix: \"\"\n\n    \"creds-in-a-query-param\":\n      queryString:\n        name: my_param\n\n    \"creds-in-a-cookie-entry\":\n      cookie:\n        name: cookie-key\n</code></pre>"},{"location":"authorino/docs/features/#extra-identity-extension-authenticationdefaults-and-authenticationoverrides","title":"Extra: Identity extension (<code>authentication.defaults</code> and <code>authentication.overrides</code>)","text":"<p>Resolved identity objects can be extended with user-defined JSON properties. Values can be static or fetched from the Authorization JSON.</p> <p>A typical use-case for this feature is token normalization. Say you have more than one identity source listed in your <code>AuthConfig</code> but each source issues an access token with a different JSON structure \u2013 e.g. two OIDC issuers that use different names for custom JWT claims of similar meaning; when two different identity verification/authentication methods are combined, such as API keys (whose identity objects are the corresponding Kubernetes <code>Secret</code>s) and Kubernetes tokens (whose identity objects are Kubernetes UserInfo data).</p> <p>In such cases, identity extension can be used to normalize the token to always include the same set of JSON properties of interest, regardless of the source of identity that issued the original token verified by Authorino. This simplifies the writing of authorization policies and configuration of dynamic responses.</p> <p>In case of extending an existing property of the identity object (replacing), the API allows to control whether to overwrite the value or not. This is particularly useful for normalizing tokens of a same identity source that nonetheless may occasionally differ in structure, such as in the case of JWT claims that sometimes may not be present but can be safely replaced with another (e.g. <code>username</code> or <code>sub</code>).</p>"},{"location":"authorino/docs/features/#external-auth-metadata-features-metadata","title":"External auth metadata features (<code>metadata</code>)","text":""},{"location":"authorino/docs/features/#http-getget-by-post-metadatahttp","title":"HTTP GET/GET-by-POST (<code>metadata.http</code>)","text":"<p>Generic HTTP adapter that sends a request to an external service. It can be used to fetch external metadata for the authorization policies (phase ii of the Authorino Auth Pipeline), or as a web hook.</p> <p>The adapter allows issuing requests either by GET or POST methods; in both cases with URL and parameters defined by the user in the spec. Dynamic values fetched from the Authorization JSON can be used.</p> <p>POST request parameters as well as the encoding of the content can be controlled using the <code>bodyParameters</code> and <code>contentType</code> fields of the config, respectively. The Content-Type of POST requests can be either <code>application/x-www-form-urlencoded</code> (default) or <code>application/json</code>.</p> <p>Authentication of Authorino with the external metadata server can be set either via long-lived shared secret stored in a Kubernetes Secret or via OAuth2 client credentials grant. For long-lived shared secret, set the <code>sharedSecretRef</code> field. For OAuth2 client credentials grant, use the <code>oauth2</code> option.</p> <p>In both cases, the location where the secret (long-lived or OAuth2 access token) travels in the request performed to the external HTTP service can be specified in the <code>credentials</code> field. By default, the authentication secret is supplied in the <code>Authorization</code> header with the <code>Bearer</code> prefix.</p> <p>Custom headers can be set with the <code>headers</code> field. Nevertheless, headers such as <code>Content-Type</code> and <code>Authorization</code> (or eventual custom header used for carrying the authentication secret, set instead via the <code>credentials</code> option) will be superseded by the respective values defined for the fields <code>contentType</code> and <code>sharedSecretRef</code>.</p>"},{"location":"authorino/docs/features/#oidc-userinfo-metadatauserinfo","title":"OIDC UserInfo (<code>metadata.userInfo</code>)","text":"<p>Online fetching of OpenID Connect (OIDC) UserInfo data (phase ii of the Authorino Auth Pipeline), associated with an OIDC identity source configured and resolved in phase (i).</p> <p>Apart from possibly complementing information of the JWT, fetching OpenID Connect UserInfo in request-time can be particularly useful for remote checking the state of the session, as opposed to only verifying the JWT/JWS offline.</p> <p>Implementation requires a JWT verification authentication config (<code>spec.authentication.jwt</code>) in the same <code>AuthConfig</code>, so the well-known configuration of the OpenId Connect (OIDC) issuer can be reused.</p> <p>The response returned by the OIDC server to the UserInfo request is appended (as JSON) to <code>auth.metadata</code> in the authorization JSON.</p>"},{"location":"authorino/docs/features/#user-managed-access-uma-resource-registry-metadatauma","title":"User-Managed Access (UMA) resource registry (<code>metadata.uma</code>)","text":"<p>User-Managed Access (UMA) is an OAuth-based protocol for resource owners to allow other users to access their resources. Since the UMA-compliant server is expected to know about the resources, Authorino includes a client that fetches resource data from the server and adds that as metadata of the authorization payload.</p> <p>This enables the implementation of resource-level Attribute-Based Access Control (ABAC) policies. Attributes of the resource fetched in a UMA flow can be, e.g., the owner of the resource, or any business-level attributes stored in the UMA-compliant server.</p> <p>A UMA-compliant server is an external authorization server (e.g., Keycloak) where the protected resources are registered. It can be as well the upstream API itself, as long as it implements the UMA protocol, with initial authentication by <code>client_credentials</code> grant to exchange for a Protected API Token (PAT).</p> <p></p> <p>It's important to notice that Authorino does NOT manage resources in the UMA-compliant server. As shown in the flow above, Authorino's UMA client is only to fetch data about the requested resources. Authorino exchanges client credentials for a Protected API Token (PAT), then queries for resources whose URI match the path of the HTTP request (as passed to Authorino by the Envoy proxy) and fetches data of each matching resource.</p> <p>The resources data is added as metadata of the authorization payload and passed as input for the configured authorization policies. All resources returned by the UMA-compliant server in the query by URI are passed along. They are available in the PDPs (authorization payload) as <code>input.auth.metadata.custom-name =&gt; Array</code>. (See The \"Auth Pipeline\" for details.)</p>"},{"location":"authorino/docs/features/#authorization-features-authorization","title":"Authorization features (<code>authorization</code>)","text":""},{"location":"authorino/docs/features/#pattern-matching-authorization-authorizationpatternmatching","title":"Pattern-matching authorization (<code>authorization.patternMatching</code>)","text":"<p>Grant/deny access based on simple pattern-matching expressions (\"patterns\") compared against values selected from the Authorization JSON.</p> <p>Each expression is a tuple composed of:</p> <ul> <li>a <code>selector</code>, to fetch from the Authorization JSON \u2013 see Common feature: JSON paths for details about syntax;</li> <li>an <code>operator</code> \u2013 <code>eq</code> (equals), <code>neq</code> (not equal); <code>incl</code> (includes) and <code>excl</code> (excludes), for arrays; and <code>matches</code>, for regular expressions;</li> <li>a fixed comparable <code>value</code></li> </ul> <p>Rules can mix and combine literal expressions and references to expression sets (\"named patterns\") defined at the upper level of the <code>AuthConfig</code> spec. (See Common feature: Conditions)</p> <pre><code>spec:\n  authorization:\n    \"my-simple-json-pattern-matching-policy\":\n      patternMatching:\n        patterns: # All patterns must match for access to be granted\n\n        - selector: auth.identity.email_verified\n          operator: eq\n          value: \"true\"\n        - patternRef: admin\n\n  patterns:\n    admin: # a named pattern that can be reused in other sets of rules or conditions\n\n    - selector: auth.identity.roles\n      operator: incl\n      value: admin\n</code></pre>"},{"location":"authorino/docs/features/#open-policy-agent-opa-rego-policies-authorizationopa","title":"Open Policy Agent (OPA) Rego policies (<code>authorization.opa</code>)","text":"<p>You can model authorization policies in Rego language and add them as part of the protection of your APIs.</p> <p>Policies can be either declared in-line in Rego language (<code>rego</code>) or as an HTTP endpoint where Authorino will fetch the source code of the policy in reconciliation-time (<code>externalPolicy</code>).</p> <p>Policies pulled from external registries can be configured to be automatically refreshed (pulled again from the external registry), by setting the <code>authorization.opa.externalPolicy.ttl</code> field (given in seconds, default: <code>0</code> \u2013 i.e. auto-refresh disabled).</p> <p>Authorino's built-in OPA module precompiles the policies during reconciliation of the AuthConfig and caches the precompiled policies for fast evaluation in runtime, where they receive the Authorization JSON as input.</p> <p></p> <p>An optional field <code>allValues: boolean</code> makes the values of all rules declared in the Rego document to be returned in the OPA output after policy evaluation. When disabled (default), only the boolean value <code>allow</code> is returned. Values of internal rules of the Rego document can be referenced in subsequent policies/phases of the Auth Pipeline.</p>"},{"location":"authorino/docs/features/#kubernetes-subjectaccessreview-authorizationkubernetessubjectaccessreview","title":"Kubernetes SubjectAccessReview (<code>authorization.kubernetesSubjectAccessReview</code>)","text":"<p>Access control enforcement based on rules defined in the Kubernetes authorization system, i.e. <code>Role</code>, <code>ClusterRole</code>, <code>RoleBinding</code> and <code>ClusterRoleBinding</code> resources of Kubernetes RBAC.</p> <p>Authorino issues a SubjectAccessReview (SAR) inquiry that checks with the underlying Kubernetes server whether the user can access a particular resource, resource kind or generic URL.</p> <p>It supports resource attributes authorization check (parameters defined in the <code>AuthConfig</code>) and non-resource attributes authorization check (HTTP endpoint inferred from the original request).</p> <ul> <li>Resource attributes: adequate for permissions set at namespace level, defined in terms of common attributes of operations on Kubernetes resources (namespace, API group, kind, name, subresource, verb)</li> <li>Non-resource attributes: adequate for permissions set at cluster scope, defined for protected endpoints of a generic HTTP API (URL path + verb)</li> </ul> <p>Example of Kubernetes role for resource attributes authorization:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: Role\nmetadata:\n  name: pet-reader\nrules:\n\n- apiGroups: [\"pets.io\"]\n  resources: [\"pets\"]\n  verbs: [\"get\"]\n</code></pre> <p>Example of Kubernetes cluster role for non-resource attributes authorization:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRole\nmetadata:\n  name: pet-editor\nrules:\n\n- nonResourceURLs: [\"/pets/*\"]\n  verbs: [\"put\", \"delete\"]\n</code></pre> <p>Kubernetes' authorization policy configs look like the following in an Authorino <code>AuthConfig</code>:</p> <pre><code>authorization:\n  \"kubernetes-rbac\":\n    kubernetesSubjectAccessReview:\n      user: # values of the parameter can be fixed (`value`) or fetched from the Authorization JSON (`selector`)\n        selector: auth.identity.metadata.annotations.userid\n\n      groups: [] # user groups to test for.\n\n      # for resource attributes permission checks; omit it to perform a non-resource attributes SubjectAccessReview with path and method/verb assumed from the original request\n      # if included, use the resource attributes, where the values for each parameter can be fixed (`value`) or fetched from the Authorization JSON (`selector`)\n      resourceAttributes:\n        namespace:\n          value: default\n        group:\n          value: pets.io # the api group of the protected resource to be checked for permissions for the user\n        resource:\n          value: pets # the resource kind\n        name:\n          selector: context.request.http.path.@extract:{\"sep\":\"/\",\"pos\":2} # resource name \u2013 e.g., the {id} in `/pets/{id}`\n        verb:\n          selector: context.request.http.method.@case:lower # api operation \u2013 e.g., copying from the context to use the same http method of the request\n</code></pre> <p><code>user</code> and properties of <code>resourceAttributes</code> can be defined from fixed values or patterns of the Authorization JSON.</p> <p>An array of <code>groups</code> (optional) can as well be set. When defined, it will be used in the <code>SubjectAccessReview</code> request.</p>"},{"location":"authorino/docs/features/#spicedb-authorizationspicedb","title":"SpiceDB (<code>authorization.spicedb</code>)","text":"<p>Check permission requests via gRPC with an external Google Zanzibar-inspired SpiceDB server, by Authzed.</p> <p>Subject, resource and permission parameters can be set to static values or read from the Authorization JSON.</p> <pre><code>spec:\n  authorization:\n    \"spicedb\":\n      spicedb:\n        endpoint: spicedb:50051\n        insecure: true # disables TLS\n        sharedSecretRef:\n          name: spicedb\n          key: token\n        subject:\n          kind:\n            value: blog/user\n          name:\n            selector: auth.identity.sub\n        resource:\n          kind:\n            value: blog/post\n          name:\n            selector: context.request.http.path.@extract:{\"sep\":\"/\",\"pos\":2} # /posts/{id}\n        permission:\n          selector: context.request.http.method\n</code></pre>"},{"location":"authorino/docs/features/#custom-response-features-response","title":"Custom response features (<code>response</code>)","text":""},{"location":"authorino/docs/features/#custom-response-forms-successful-authorization-vs-custom-denial-status","title":"Custom response forms: successful authorization vs custom denial status","text":"<p>The response to the external authorization request can be customized in the following fashion:</p> <ul> <li>Successful authorization (<code>response.success</code>)</li> <li>Added HTTP headers (<code>response.success.headers</code>)</li> <li>Envoy Dynamic Metadata (<code>response.success.dynamicMetadata</code>)</li> <li>Custom denial status</li> <li>Unauthenticated (<code>response.unauthenticated</code>)</li> <li>Unauthorized (<code>response.unauthorized</code>)</li> </ul> <p>Successful authorization custom responses can be set based on any of the supported custom authorization methods:</p> <ul> <li>Plain text value</li> <li>JSON injection</li> <li>Festival Wristband Tokens</li> </ul>"},{"location":"authorino/docs/features/#added-http-headers","title":"Added HTTP headers","text":"<p>Set custom responses as HTTP headers injected in the request post-successful authorization by specifying one of the supported methods under <code>response.success.headers</code>.</p> <p>The name of the response config (default) or the value of the <code>key</code> option (if provided) will used as the name of the header.</p>"},{"location":"authorino/docs/features/#envoy-dynamic-metadata","title":"Envoy Dynamic Metadata","text":"<p>Authorino custom response methods can also be used to propagate Envoy Dynamic Metadata. To do so, set one of the supported methods under <code>response.success.dynamicMetadata</code>.</p> <p>The name of the response config (default) or the value of the <code>key</code> option (if provided) will used as the name of the root property of the dynamic metadata content.</p> <p>A custom response exported as Envoy Dynamic Metadata can be set in the Envoy route or virtual host configuration as input to a consecutive filter in the filter chain.</p> <p>E.g., to read metadata emitted by the authorization service with scheme <code>{ \"auth-data\": { \"api-key-ns\": string, \"api-key-name\": string } }</code>, as input in a rate limit configuration placed in the filter chain after the external authorization, the Envoy config may look like the following:</p> <pre><code># Envoy config snippet to inject `user_namespace` and `username` rate limit descriptors from metadata emitted by Authorino\nrate_limits:\n\n- actions:\n  - metadata:\n      metadata_key:\n        key: \"envoy.filters.http.ext_authz\"\n        path:\n        - key: auth-data # root of the dynamic metadata object, as declared in a custom response config of the AuthConfig (name or key)\n        - key: api-key-ns\n      descriptor_key: user_namespace\n  - metadata:\n      metadata_key:\n        key: \"envoy.filters.http.ext_authz\"\n        path:\n        - key: auth-data # root of the dynamic metadata object, as declared in a custom response config of the AuthConfig (name or key)\n        - key: api-key-name\n      descriptor_key: username\n</code></pre>"},{"location":"authorino/docs/features/#custom-denial-status-responseunauthenticated-and-responseunauthorized","title":"Custom denial status (<code>response.unauthenticated</code> and <code>response.unauthorized</code>)","text":"<p>By default, Authorino will inform Envoy to respond with <code>401 Unauthorized</code> or <code>403 Forbidden</code> respectively when the identity verification (phase i of the Auth Pipeline) or authorization (phase ii) fail. These can be customized respectively by specifying <code>spec.response.unauthanticated</code> and <code>spec.response.unauthorized</code> in the <code>AuthConfig</code>.</p>"},{"location":"authorino/docs/features/#custom-response-methods","title":"Custom response methods","text":""},{"location":"authorino/docs/features/#plain-text-responsesuccessheadersdynamicmetadataplain","title":"Plain text (<code>response.success.&lt;headers|dynamicMetadata&gt;.plain</code>)","text":"<p>Simpler, yet more generalized form, for extending the authorization response for header mutation and Envoy Dynamic Metadata, based on plain text values.</p> <p>The value can be static:</p> <pre><code>response:\n  success:\n    headers:\n      \"x-auth-service\"\n        plain:\n          value: Authorino\n</code></pre> <p>or fetched dynamically from the Authorization JSON (which includes support for interpolation):</p> <pre><code>response:\n  success:\n    headers:\n      \"x-username\":\n        plain:\n          selector: auth.identity.username\n</code></pre>"},{"location":"authorino/docs/features/#json-injection-responsesuccessheadersdynamicmetadatajson","title":"JSON injection (<code>response.success.&lt;headers|dynamicMetadata&gt;.json</code>)","text":"<p>User-defined dynamic JSON objects generated by Authorino in the response phase, from static or dynamic data of the auth pipeline, and passed back to the external authorization client within added HTTP headers or Dynamic Metadata.</p> <p>The following Authorino <code>AuthConfig</code> custom resource is an example that defines 3 dynamic JSON response items, where two items are returned to the client, stringified, in added HTTP headers, and the third as Envoy Dynamic Metadata. Envoy proxy can be configured to propagate the dynamic metadata emitted by Authorino into another filter \u2013 e.g. the rate limit filter.</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  namespace: my-namespace\n  name: my-api-protection\nspec:\n  hosts:\n\n  - my-api.io\n  authentication:\n    \"edge\":\n      apiKey:\n        selector:\n          matchLabels:\n            authorino.kuadrant.io/managed-by: authorino\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n  response:\n    success:\n      headers:\n        \"x-my-custom-header\":\n          json:\n            properties:\n              \"prop1\":\n                value: value1\n              \"prop2\":\n                selector: some.path.within.auth.json\n        \"x-ext-auth-other-json\":\n          json:\n            properties:\n              \"propX\":\n                value: valueX\n\n      dynamicMetadata:\n        \"auth-data\":\n          json:\n            properties:\n              \"api-key-ns\":\n                seletor: auth.identity.metadata.namespace\n              \"api-key-name\":\n                selector: auth.identity.metadata.name\n</code></pre>"},{"location":"authorino/docs/features/#festival-wristband-tokens-responsesuccessheadersdynamicmetadatawristband","title":"Festival Wristband tokens (<code>response.success.&lt;headers|dynamicMetadata&gt;.wristband</code>)","text":"<p>Festival Wristbands are signed OpenID Connect JSON Web Tokens (JWTs) issued by Authorino at the end of the auth pipeline and passed back to the client, typically in added HTTP response header. It is an opt-in feature that can be used to implement Edge Authentication Architecture (EAA) and enable token normalization. Authorino wristbands include minimal standard JWT claims such as <code>iss</code>, <code>iat</code>, and <code>exp</code>, and optional user-defined custom claims, whose values can be static or dynamically fetched from the authorization JSON.</p> <p>The Authorino <code>AuthConfig</code> custom resource below sets an API protection that issues a wristband after a successful authentication via API key. Apart from standard JWT claims, the wristband contains 2 custom claims: a static value <code>aud=internal</code> and a dynamic value <code>born</code> that fetches from the authorization JSON the date/time of creation of the secret that represents the API key used to authenticate.</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  namespace: my-namespace\n  name: my-api-protection\nspec:\n  hosts:\n\n  - my-api.io\n  authentication:\n    \"edge\":\n      apiKey:\n        selector:\n          matchLabels:\n            authorino.kuadrant.io/managed-by: authorino\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n  response:\n    success:\n      headers:\n        \"x-wristband\":\n          wristband:\n            issuer: https://authorino-oidc.default.svc:8083/my-namespace/my-api-protection/x-wristband\n            customClaims:\n              \"aud\":\n                value: internal\n              \"born\":\n                selector: auth.identity.metadata.creationTimestamp\n            tokenDuration: 300\n            signingKeyRefs:\n            - name: my-signing-key\n              algorithm: ES256\n            - name: my-old-signing-key\n              algorithm: RS256\n</code></pre> <p>The signing key names listed in <code>signingKeyRefs</code> must match the names of Kubernetes <code>Secret</code> resources created in the same namespace, where each secret contains a <code>key.pem</code> entry that holds the value of the private key that will be used to sign the wristbands issued, formatted as PEM. The first key in this list will be used to sign the wristbands, while the others are kept to support key rotation.</p> <p>For each protected API configured for the Festival Wristband issuing, Authorino exposes the following OpenID Connect Discovery well-known endpoints (available for requests within the cluster):</p> <ul> <li>OpenID Connect configuration:   https://authorino-oidc.default.svc:8083/{namespace}/{api-protection-name}/{response-config-name}/.well-known/openid-configuration</li> <li>JSON Web Key Set (JWKS) well-known endpoint:   https://authorino-oidc.default.svc:8083/{namespace}/{api-protection-name}/{response-config-name}/.well-known/openid-connect/certs</li> </ul>"},{"location":"authorino/docs/features/#callbacks-callbacks","title":"Callbacks (<code>callbacks</code>)","text":""},{"location":"authorino/docs/features/#http-endpoints-callbackshttp","title":"HTTP endpoints (<code>callbacks.http</code>)","text":"<p>Sends requests to specified HTTP endpoints at the end of the auth pipeline.</p> <p>The scheme of the <code>http</code> field is the same as of <code>metadata.http</code>.</p> <p>Example:</p> <pre><code>spec:\n  authentication: [\u2026]\n  authorization: [\u2026]\n\n  callbacks:\n    \"log\":\n      http:\n        url: http://logsys\n        method: POST\n        body:\n          selector: |\n              \\{\"requestId\":context.request.http.id,\"username\":\"{auth.identity.username}\",\"authorizationResult\":{auth.authorization}\\}\n    \"important-forbidden\":\n      when:\n\n      - selector: auth.authorization.important-policy\n        operator: eq\n        value: \"false\"\n      http:\n        url: \"http://monitoring/important?forbidden-user={auth.identity.username}\"\n</code></pre>"},{"location":"authorino/docs/features/#common-feature-priorities","title":"Common feature: Priorities","text":"<p>Priorities allow to set sequence of execution for blocks of concurrent evaluators within phases of the Auth Pipeline.</p> <p>Evaluators of same priority execute concurrently to each other \"in a block\". After syncing that block (i.e. after all evaluators of the block have returned), the next block of evaluator configs of consecutive priority is triggered.</p> <p>Use cases for priorities are:</p> <ol> <li>Saving expensive tasks to be triggered when there's a high chance of returning immediately after finishing executing a less expensive one \u2013 e.g.<ul> <li>an identity config that calls an external IdP to verify a token that is rarely used, compared to verifying JWTs preferred by most users of the service;</li> <li>an authorization policy that performs some quick checks first, such as verifying allowed paths, and only if it passes, moves to the evaluation of a more expensive policy.</li> </ul> </li> <li>Establishing dependencies between evaluators - e.g.<ul> <li>an external metadata request that needs to wait until a previous metadata responds first (in order to use data from the response)</li> </ul> </li> </ol> <p>Priorities can be set using the <code>priority</code> property available in all evaluator configs of all phases of the Auth Pipeline (identity, metadata, authorization and response). The lower the number, the highest the priority. By default, all evaluators have priority 0 (i.e. highest priority).</p> <p>Consider the following example to understand how priorities work:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api\n  authentication:\n    \"tier-1\":\n      priority: 0\n      apiKey:\n        selector:\n          matchLabels:\n            tier: \"1\"\n    \"tier-2\":\n      priority: 1\n      apiKey:\n        selector:\n          matchLabels:\n            tier: \"2\"\n    \"tier-3\":\n      priority: 1\n      apiKey:\n        selector:\n          matchLabels:\n            tier: \"3\"\n  metadata:\n    \"first\":\n      http:\n        url: http://talker-api:3000\n    \"second\":\n      priority: 1\n      http:\n        url: http://talker-api:3000/first_uuid={auth.metadata.first.uuid}\n  authorization:\n    \"allowed-endpoints\":\n      when:\n      - selector: context.request.http.path\n        operator: neq\n        value: /hi\n      - selector: context.request.http.path\n        operator: neq\n        value: /hello\n      - selector: context.request.http.path\n        operator: neq\n        value: /aloha\n      - selector: context.request.http.path\n        operator: neq\n        value: /ciao\n      patternMatching:\n        patterns:\n        - selector: deny\n          operator: eq\n          value: \"true\"\n    \"more-expensive-policy\": # no point in evaluating this one if it's not an allowed endpoint\n      priority: 1\n      opa:\n        rego: |\n          allow { true }\n  response:\n    success:\n      headers:\n        \"x-auth-data\":\n          json:\n            properties:\n              \"tier\":\n                selector: auth.identity.metadata.labels.tier\n              \"first-uuid\":\n                selector: auth.metadata.first.uuid\n              \"second-uuid\":\n                selector: auth.metadata.second.uuid\n              \"second-path\":\n                selector: auth.metadata.second.path\n</code></pre> <p>For the <code>AuthConfig</code> above,</p> <ul> <li> <p>Identity configs <code>tier-2</code> and <code>tier-3</code> (priority 1) will only trigger (concurrently) in case <code>tier-1</code> (priority 0) fails to validate the authentication token first. (This behavior happens without prejudice of context canceling between concurrent evaluators \u2013 i.e. evaluators that are triggered concurrently to another, such as <code>tier-2</code> and <code>tier-3</code>, continue to cancel the context of each other if any of them succeeds validating the token first.)</p> </li> <li> <p>Metadata source <code>second</code> (priority 1) uses the response of the request issued by metadata source <code>first</code> (priority 0), so it will wait for <code>first</code> to finish by triggering only in the second block.</p> </li> <li> <p>Authorization policy <code>allowed-endpoints</code> (priority 0) is considered to be a lot less expensive than <code>more-expensive-policy</code> (priority 1) and has a high chance of denying access to the protected service (if the path is not one of the allowed endpoints). By setting different priorities to these policies we ensure the more expensive policy if triggered in sequence of the less expensive one, instead of concurrently.</p> </li> </ul>"},{"location":"authorino/docs/features/#common-feature-conditions-when","title":"Common feature: Conditions (<code>when</code>)","text":"<p>Conditions, named <code>when</code> in the AuthConfig API, are logical expressions, composed of patterns and logical operator AND and OR, that can be used to condition the evaluation of a particular auth rule within an AuthConfig, as well as of the AuthConfig altogether (\"top-level conditions\").</p> <p>The patterns are evaluated against the Authorization JSON, where each pattern is a tuple composed of:</p> <ul> <li><code>selector</code>: a JSON path to fetch a value from the Authorization JSON</li> <li><code>operator</code>: one of: <code>eq</code> (equals); <code>neq</code> (not equal); <code>incl</code> (includes) and <code>excl</code> (excludes), for when the value fetched from the Authorization JSON is expected to be an array; <code>matches</code>, for regular expressions</li> <li><code>value</code>: a static string value to compare the value selected from the Authorization JSON with.</li> </ul> <p>An expression contains one or more patterns and they must either all evaluate to true (\"AND\" operator, declared by grouping the patterns within an <code>all</code> block) or at least one of the patterns must be true (\"OR\" operator, when grouped within an <code>any</code> block.) Patterns not explicitly grouped are AND'ed by default.</p> <p>To avoid repetitions when listing patterns, any set of literal <code>{ pattern, operator, value }</code> tuples can be stored at the top-level of the AuthConfig spec, indexed by name, and later referred within an expression by including a <code>patternRef</code> in the block of conditions.</p> <p>Examples of <code>when</code> conditions</p> <p>i) to skip an entire <code>AuthConfig</code> based on the context (AND operator assumed by default):</p> <pre><code>spec:\n  when: # auth enforced only on requests to POST /resources/*\n\n  - selector: context.request.http.method\n    operator: eq\n    value: POST\n  - selector: context.request.http.path\n    operator: matches\n    value: ^/resources/.*\n</code></pre> <p>ii) equivalent to the above with explicit AND operator (i.e., <code>all</code> block):</p> <pre><code>spec:\n  when: # auth enforced only on requests to POST /resources/*\n\n  - all:\n    - selector: context.request.http.method\n      operator: eq\n      value: POST\n    - selector: context.request.http.path\n      operator: matches\n      value: ^/resources/.*\n</code></pre> <p>iii) OR condition (i.e., <code>any</code> block):</p> <pre><code>spec:\n  when: # auth enforced only on requests with HTTP method equals to POST or PUT\n\n  - any:\n    - selector: context.request.http.method\n      operator: eq\n      value: POST\n    - selector: context.request.http.method\n      operator: eq\n      value: PUT\n</code></pre> <p>iv) complex expression with nested operations:</p> <pre><code>spec:\n  when: # auth enforced only on requests to POST /resources/* or PUT /resources/*\n\n  - any:\n    - all:\n      - selector: context.request.http.method\n        operator: eq\n        value: POST\n      - selector: context.request.http.path\n        operator: matches\n        value: ^/resources/.*\n    - all:\n      - selector: context.request.http.method\n        operator: eq\n        value: PUT\n      - selector: context.request.http.path\n        operator: matches\n        value: ^/resources/.*\n</code></pre> <p>v) more concise equivalent of the above (with implicit AND operator at the top level):</p> <pre><code>spec:\n  when: # auth enforced only on requests to /resources/* path with method equals to POST or PUT\n\n  - selector: context.request.http.path\n    operator: matches\n    value: ^/resources/.*\n  - any:\n    - selector: context.request.http.method\n      operator: eq\n      value: POST\n    - selector: context.request.http.method\n      operator: eq\n      value: PUT\n</code></pre> <p>vi) to skip part of an AuthConfig (i.e., a specific auth rule):</p> <pre><code>spec:\n  metadata:\n    \"metadata-source\":\n      http:\n        url: https://my-metadata-source.io\n      when: # only fetch the external metadata if the context is HTTP method other than OPTIONS\n\n      - selector: context.request.http.method\n        operator: neq\n        value: OPTIONS\n</code></pre> <p>vii) skipping part of an AuthConfig will not affect other auth rules:</p> <pre><code>spec:\n  authentication:\n    \"authn-meth-1\":\n      apiKey: {\u2026} # this auth rule only triggers for POST requests to /foo[/*]\n      when:\n\n      - selector: context.request.http.method\n        operator: eq\n        value: POST\n      - selector: context.request.http.path\n        operator: matches\n        value: ^/foo(/.*)?$\n\n    \"authn-meth-2\": # this auth rule triggerred regardless\n      jwt: {\u2026}\n</code></pre> <p>viii) concrete use-case: evaluating only the necessary identity checks based on the user's indication of the preferred authentication method (prefix of the value supplied in the HTTP <code>Authorization</code> request header):</p> <pre><code>spec:\n  authentication:\n    \"jwt\":\n      when:\n\n      - selector: context.request.http.headers.authorization\n        operator: matches\n        value: JWT .+\n      jwt: {\u2026}\n\n    \"api-key\":\n      when:\n\n      - selector: context.request.http.headers.authorization\n        operator: matches\n        value: APIKEY .+\n      apiKey: {\u2026}\n</code></pre> <p>ix) to avoid repetition while defining patterns for conditions:</p> <pre><code>spec:\n  patterns:\n    a-pet: # a named pattern that can be reused in sets of conditions\n\n    - selector: context.request.http.path\n      operator: matches\n      value: ^/pets/\\d+(/.*)$\n\n  metadata:\n    \"pets-info\":\n      when:\n\n      - patternRef: a-pet\n      http:\n        url: https://pets-info.io?petId={context.request.http.path.@extract:{\"sep\":\"/\",\"pos\":2}}\n\n  authorization:\n    \"pets-owners-only\":\n      when:\n\n      - patternRef: a-pet\n      opa:\n        rego: |\n          allow { input.metadata[\"pets-info\"].ownerid == input.auth.identity.userid }\n</code></pre> <p>x) combining literals and refs \u2013 concrete case: authentication required for selected operations:</p> <pre><code>spec:\n  patterns:\n    api-base-path:\n\n    - selector: context.request.http.path\n      operator: matches\n      value: ^/api/.*\n\n    authenticated-user:\n\n    - selector: auth.identity.anonymous\n      operator: neq\n      value: \"true\"\n\n  authentication:\n    api-users: # tries to authenticate all requests to path /api/*\n      when:\n\n      - patternRef: api-base-path\n      jwt: {\u2026}\n\n    others: # defaults to anonymous access when authentication fails or not /api/* path\n      anonymous: {}\n      priority: 1\n\n  authorization:\n    api-write-access-requires-authentication: # POST/PUT/DELETE requests to /api/* path cannot be anonymous\n      when:\n\n      - all:\n        - patternRef: api-base-path\n        - any:\n          - selector: context.request.http.method\n            operator: eq\n            value: POST\n          - selector: context.request.http.method\n            operator: eq\n            value: PUT\n          - selector: context.request.http.method\n            operator: eq\n            value: DELETE\n      opa:\n        patternMatching:\n          rules:\n          - patternRef: authenticated-user\n\n  response: # bonus: export user data if available\n    success:\n      dynamicMetadata:\n        \"user-data\":\n          when:\n\n          - patternRef: authenticated-user\n          json:\n            properties:\n              jwt-claims:\n                selector: auth.identity\n</code></pre>"},{"location":"authorino/docs/features/#common-feature-caching-cache","title":"Common feature: Caching (<code>cache</code>)","text":"<p>Objects resolved at runtime in an Auth Pipeline can be cached \"in-memory\", and avoided being evaluated again at a subsequent request, until it expires. A lookup cache key and a TTL can be set individually for any evaluator config in an AuthConfig.</p> <p>Each cache config induces a completely independent cache table (or \"cache namespace\"). Consequently, different evaluator configs can use the same cache key and there will be no collision between entries from different evaluators.</p> <p>E.g.:</p> <pre><code>spec:\n  hosts:\n\n  - my-api.io\n\n  authentication: [\u2026]\n\n  metadata:\n    \"external-metadata\":\n      http:\n        url: http://my-external-source?search={context.request.http.path}\n      cache:\n        key:\n          selector: context.request.http.path\n        ttl: 300\n\n  authorization:\n    \"complex-policy\":\n      opa:\n        externalPolicy:\n          url: http://my-policy-registry\n      cache:\n        key:\n          selector: \"{auth.identity.group}-{context.request.http.method}-{context.request.http.path}\"\n        ttl: 60\n</code></pre> <p>The example above sets caching for the 'external-metadata' metadata config and for the 'complex-policy' authorization policy. In the case of 'external-metadata', the cache key is the path of the original HTTP request being authorized by Authorino (fetched dynamically from the Authorization JSON); i.e., after obtaining a metadata object from the external source for a given contextual HTTP path one first time, whenever that same HTTP path repeats in a subsequent request, Authorino will use the cached object instead of sending a request again to the external source of metadata. After 5 minutes (300 seconds), the cache entry will expire and Authorino will fetch again from the source if requested.</p> <p>As for the 'complex-policy' authorization policy, the cache key is a string composed the 'group' the identity belongs to, the method of the HTTP request and the path of the HTTP request. Whenever these repeat, Authorino will use the result of the policy that was evaluated and cached priorly. Cache entries in this namespace expire after 60 seconds.</p> <p>Notes on evaluator caching</p> <p>Capacity - By default, each cache namespace is limited to 1 mb. Entries will be evicted following First-In-First-Out (FIFO) policy to release space. The individual capacity of cache namespaces is set at the level of the Authorino instance (via <code>--evaluator-cache-size</code> command-line flag or <code>spec.evaluatorCacheSize</code> field of the <code>Authorino</code> CR).</p> <p>Usage - Avoid caching objects whose evaluation is considered to be relatively cheap. Examples of operations associated to Authorino auth features that are usually NOT worth caching: validation of JSON Web Tokens (JWT), Kubernetes TokenReviews and SubjectAccessReviews, API key validation, simple JSON pattern-matching authorization rules, simple OPA policies. Examples of operations where caching may be desired: OAuth2 token introspection, fetching of metadata from external sources (via HTTP request), complex OPA policies.</p>"},{"location":"authorino/docs/features/#common-feature-metrics-metrics","title":"Common feature: Metrics (<code>metrics</code>)","text":"<p>By default, Authorino will only export metrics down to the level of the AuthConfig. Deeper metrics at the level of each evaluator within an AuthConfig can be activated by setting the common field <code>metrics: true</code> of the evaluator config.</p> <p>E.g.:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: my-authconfig\n  namespace: my-ns\nspec:\n  metadata:\n    \"my-external-metadata\":\n      http:\n        url: http://my-external-source?search={context.request.http.path}\n      metrics: true\n</code></pre> <p>The above will enable the metrics <code>auth_server_evaluator_duration_seconds</code> (histogram) and <code>auth_server_evaluator_total</code> (counter) with labels <code>namespace=\"my-ns\"</code>, <code>authconfig=\"my-authconfig\"</code>, <code>evaluator_type=\"METADATA_GENERIC_HTTP\"</code> and <code>evaluator_name=\"my-external-metadata\"</code>.</p> <p>The same pattern works for other types of evaluators. Find below the list of all types and corresponding label constant used in the metric:</p> Evaluator type Metric's <code>evaluator_type</code> label <code>authentication.apiKey</code> IDENTITY_APIKEY <code>authentication.kubernetesTokenReview</code> IDENTITY_KUBERNETES <code>authentication.jwt</code> IDENTITY_OIDC <code>authentication.oauth2Introspection</code> IDENTITY_OAUTH2 <code>authentication.x509</code> IDENTITY_MTLS <code>authentication.plain</code> IDENTITY_PLAIN <code>authentication.anonymous</code> IDENTITY_NOOP <code>metadata.http</code> METADATA_GENERIC_HTTP <code>metadata.userInfo</code> METADATA_USERINFO <code>metadata.uma</code> METADATA_UMA <code>authorization.patternMatching</code> AUTHORIZATION_JSON <code>authorization.opa</code> AUTHORIZATION_OPA <code>authorization.kubernetesSubjectAccessReview</code> AUTHORIZATION_KUBERNETES <code>authorization.spicedb</code> AUTHORIZATION_AUTHZED <code>response.success..plain</code> RESPONSE_PLAIN <code>response.success..json</code> RESPONSE_JSON <code>response.success..wristband</code> RESPONSE_WRISTBAND <p>Metrics at the level of the evaluators can also be enforced to an entire Authorino instance, by setting the <code>--deep-metrics-enabled</code> command-line flag. In this case, regardless of the value of the field <code>spec.(authentication|metadata|authorization|response).metrics</code> in the AuthConfigs, individual metrics for all evaluators of all AuthConfigs will be exported.</p> <p>For more information about metrics exported by Authorino, see Observability.</p>"},{"location":"authorino/docs/getting-started/","title":"Getting started","text":"<p>This page covers requirements and instructions to deploy Authorino on a Kubernetes cluster, as well as the steps to declare, apply and try out a protection layer of authentication and authorization over your service, clean-up and complete uninstallation.</p> <p>If you prefer learning with an example, check out our Hello World.</p>"},{"location":"authorino/docs/getting-started/#requirements","title":"Requirements","text":""},{"location":"authorino/docs/getting-started/#platform-requirements","title":"Platform requirements","text":"<p>These are the platform requirements to use Authorino:</p> <ul> <li> <p>Kubernetes server (recommended v1.21 or later), with permission to create Kubernetes Custom Resource Definitions (CRDs) (for bootstrapping Authorino and Authorino Operator)</p> <p> Alternative: K8s distros and platforms <p>Alternatively to upstream Kubernetes, you should be able to use any other Kubernetes distribution or Kubernetes Management Platform (KMP) with support for Kubernetes Custom Resources Definitions (CRD) and custom controllers, such as Red Hat OpenShift, IBM Cloud Kubernetes Service (IKS), Google Kubernetes Engine (GKE), Amazon Elastic Kubernetes Service (EKS) and Azure Kubernetes Service (AKS). </p> <li> <p>Envoy proxy (recommended v1.19 or later), to wire up Upstream services (i.e. the services to be protected with Authorino) and external authorization filter (Authorino) for integrations based on the reverse-proxy architecture - example</p> <p> Alternative: Non-reverse-proxy integration <p>Technically, any client that implements Envoy's external authorization gRPC protocol should be compatible with Authorino. For integrations based on the reverse-proxy architecture nevertheless, we strongly recommended that you leverage Envoy alongside Authorino. </p>"},{"location":"authorino/docs/getting-started/#feature-specific-requirements","title":"Feature-specific requirements","text":"<p>A few examples are:</p> <ul> <li> <p>For OpenID Connect, make sure you have access to an identity provider (IdP) and an authority that can issue ID tokens (JWTs). Check out Keycloak which can solve both and connect to external identity sources and user federation like LDAP.</p> </li> <li> <p>For Kubernetes authentication tokens, platform support for the TokenReview and SubjectAccessReview APIs of Kubernetes shall be required. In case you want to be able to requests access tokens for clients running outside the custer, you may also want to check out the requisites for using Kubernetes TokenRequest API (GA in v1.20).</p> </li> <li> <p>For User-Managed Access (UMA) resource data, you will need a UMA-compliant server running as well. This can be an implementation of the UMA protocol by each upstream API itself or (more typically) an external server that knows about the resources. Again, Keycloak can be a good fit here as well. Just keep in mind that, whatever resource server you choose, changing-state actions commanded in the upstream APIs or other parties will have to be reflected in the resource server. Authorino will not do that for you.</p> </li> </ul> <p>Check out the Feature specification page for more feature-specific requirements.</p>"},{"location":"authorino/docs/getting-started/#installation","title":"Installation","text":""},{"location":"authorino/docs/getting-started/#step-install-the-authorino-operator","title":"Step: Install the Authorino Operator","text":"<p>The simplest way to install the Authorino Operator is by applying the manifest bundle:</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre> <p>The above will install the latest build of the Authorino Operator and latest version of the manifests (CRDs and RBAC), which by default points as well to the latest build of Authorino, both based on the <code>main</code> branches of each component. To install a stable released version of the Operator and therefore also defaults to its latest compatible stable release of Authorino, replace <code>main</code> with another tag of a proper release of the Operator, e.g. 'v0.2.0'.</p> <p>This step will also install cert-manager in the cluster (required).</p> <p>Alternatively, you can deploy the Authorino Operator using the Operator Lifecycle Manager bundles. For instructions, check out Installing via OLM.</p>"},{"location":"authorino/docs/getting-started/#step-request-an-authorino-instance","title":"Step: Request an Authorino instance","text":"<p>Choose either cluster-wide or namespaced deployment mode and whether you want TLS termination enabled for the Authorino endpoints (gRPC authorization, raw HTTP authorization, and OIDC Festival Wristband Discovery listeners), and follow the corresponding instructions below.</p> <p>The instructions here are for centralized gateway or centralized authorization service architecture. Check out the Topologies section of the docs for alternatively running Authorino in a sidecar container.</p> Cluster-wide (with TLS) <p>Create the namespace:   <pre><code>kubectl create namespace authorino\n</code></pre></p> <p>Create the TLS certificates (requires cert-manager; skip if you already have certificates and certificate keys created and stored in Kubernetes <code>Secret</code>s in the namespace):   <pre><code>curl -sSL https://raw.githubusercontent.com/Kuadrant/authorino/main/deploy/certs.yaml | sed \"s/\\$(AUTHORINO_INSTANCE)/authorino/g;s/\\$(NAMESPACE)/authorino/g\" | kubectl -n authorino apply -f -\n</code></pre></p> <p>Deploy Authorino:   <pre><code>kubectl -n authorino apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  replicas: 1\n  clusterWide: true\n  listener:\n    tls:\n      enabled: true\n      certSecretRef:\n        name: authorino-server-cert\n  oidcServer:\n    tls:\n      enabled: true\n      certSecretRef:\n        name: authorino-oidc-server-cert\nEOF\n</code></pre></p> Cluster-wide (without TLS) <pre><code>kubectl create namespace authorino\nkubectl -n authorino apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  image: quay.io/kuadrant/authorino:latest\n  replicas: 1\n  clusterWide: true\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre> Namespaced (with TLS) <p>Create the namespace:   <pre><code>kubectl create namespace myapp\n</code></pre></p> <p>Create the TLS certificates (requires cert-manager; skip if you already have certificates and certificate keys created and stored in Kubernetes <code>Secret</code>s in the namespace):   <pre><code>curl -sSL https://raw.githubusercontent.com/Kuadrant/authorino/main/deploy/certs.yaml | sed \"s/\\$(AUTHORINO_INSTANCE)/authorino/g;s/\\$(NAMESPACE)/myapp/g\" | kubectl -n myapp apply -f -\n</code></pre></p> <p>Deploy Authorino:   <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  image: quay.io/kuadrant/authorino:latest\n  replicas: 1\n  clusterWide: false\n  listener:\n    tls:\n      enabled: true\n      certSecretRef:\n        name: authorino-server-cert\n  oidcServer:\n    tls:\n      enabled: true\n      certSecretRef:\n        name: authorino-oidc-server-cert\nEOF\n</code></pre></p> Namespaced (without TLS) <pre><code>kubectl create namespace myapp\nkubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  image: quay.io/kuadrant/authorino:latest\n  replicas: 1\n  clusterWide: false\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/getting-started/#protect-a-service","title":"Protect a service","text":"<p>The most typical integration to protect services with Authorino is by putting the service (upstream) behind a reverse-proxy or API gateway, enabled with an authorization filter that ensures all requests to the service are first checked with the authorization server (Authorino).</p> <p>To do that, make sure you have your upstream service deployed and running, usually in the same Kubernetes server where you installed Authorino. Then, setup an Envoy proxy and create an Authorino <code>AuthConfig</code> for your service.</p> <p>Authorino exposes 2 interfaces to serve the authorization requests:</p> <ul> <li>a gRPC interface that implements Envoy's External Authorization protocol;</li> <li>a raw HTTP authorization interface, suitable for using Authorino with Kubernetes ValidatingWebhook, for Envoy external authorization via HTTP, and other integrations (e.g. other proxies).</li> </ul> <p>To use Authorino as a simple satellite (sidecar) Policy Decision Point (PDP), applications can integrate directly via any of these interfaces. By integrating via a proxy or API gateway, the combination makes Authorino to perform as an external Policy Enforcement Point (PEP) completely decoupled from the application.</p>"},{"location":"authorino/docs/getting-started/#life-cycle","title":"Life cycle","text":""},{"location":"authorino/docs/getting-started/#step-setup-envoy","title":"Step: Setup Envoy","text":"<p>To configure Envoy for proxying requests targeting the upstream service and authorizing with Authorino, setup an Envoy configuration that enables Envoy's external authorization HTTP filter. Store the configuration in a <code>ConfigMap</code>.</p> <p>These are the important bits in the Envoy configuration to activate Authorino:</p> <pre><code>static_resources:\n  listeners:\n\n  - address: {\u2026} # TCP socket address and port of the proxy\n    filter_chains:\n    - filters:\n      - name: envoy.http_connection_manager\n        typed_config:\n          \"@type\": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager\n          route_config: {\u2026} # routing configs - virtual host domain and endpoint matching patterns and corresponding upstream services to redirect the traffic\n          http_filters:\n          - name: envoy.filters.http.ext_authz # the external authorization filter\n            typed_config:\n              \"@type\": type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthz\n              transport_api_version: V3\n              failure_mode_allow: false # ensures only authenticated and authorized traffic goes through\n              grpc_service:\n                envoy_grpc:\n                  cluster_name: authorino\n                timeout: 1s\n  clusters:\n  - name: authorino\n    connect_timeout: 0.25s\n    type: strict_dns\n    lb_policy: round_robin\n    http2_protocol_options: {}\n    load_assignment:\n      cluster_name: authorino\n      endpoints:\n      - lb_endpoints:\n        - endpoint:\n            address:\n              socket_address:\n                address: authorino-authorino-authorization # name of the Authorino service deployed \u2013 it can be the fully qualified name with `.&lt;namespace&gt;.svc.cluster.local` suffix (e.g. `authorino-authorino-authorization.myapp.svc.cluster.local`)\n                port_value: 50051\n    transport_socket: # in case TLS termination is enabled in Authorino; omit it otherwise\n      name: envoy.transport_sockets.tls\n      typed_config:\n        \"@type\": type.googleapis.com/envoy.extensions.transport_sockets.tls.v3.UpstreamTlsContext\n        common_tls_context:\n          validation_context:\n            trusted_ca:\n              filename: /etc/ssl/certs/authorino-ca-cert.crt\n</code></pre> <p>For a complete Envoy <code>ConfigMap</code> containing an upstream API protected with Authorino, with TLS enabled and option for rate limiting with Limitador, plus a webapp served with under the same domain of the protected API, check out this example.</p> <p>After creating the <code>ConfigMap</code> with the Envoy configuration, create an Envoy <code>Deployment</code> and <code>Service</code>. E.g.:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: envoy\n  labels:\n    app: envoy\nspec:\n  selector:\n    matchLabels:\n      app: envoy\n  template:\n    metadata:\n      labels:\n        app: envoy\n    spec:\n      containers:\n\n        - name: envoy\n          image: envoyproxy/envoy:v1.19-latest\n          command: [\"/usr/local/bin/envoy\"]\n          args:\n            - --config-path /usr/local/etc/envoy/envoy.yaml\n            - --service-cluster front-proxy\n            - --log-level info\n            - --component-log-level filter:trace,http:debug,router:debug\n          ports:\n            - name: web\n              containerPort: 8000 # matches the address of the listener in the envoy config\n          volumeMounts:\n            - name: config\n              mountPath: /usr/local/etc/envoy\n              readOnly: true\n            - name: authorino-ca-cert # in case TLS termination is enabled in Authorino; omit it otherwise\n              subPath: ca.crt\n              mountPath: /etc/ssl/certs/authorino-ca-cert.crt\n              readOnly: true\n      volumes:\n        - name: config\n          configMap:\n            name: envoy\n            items:\n              - key: envoy.yaml\n                path: envoy.yaml\n        - name: authorino-ca-cert # in case TLS termination is enabled in Authorino; omit it otherwise\n          secret:\n            defaultMode: 420\n            secretName: authorino-ca-cert\n  replicas: 1\nEOF\n</code></pre> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Service\nmetadata:\n  name: envoy\nspec:\n  selector:\n    app: envoy\n  ports:\n\n    - name: web\n      port: 8000\n      protocol: TCP\nEOF\n</code></pre>"},{"location":"authorino/docs/getting-started/#step-apply-an-authconfig","title":"Step: Apply an <code>AuthConfig</code>","text":"<p>Check out the docs for a full description of Authorino's <code>AuthConfig</code> Custom Resource Definition (CRD) and its features.</p> <p>For examples based on specific use-cases, check out the User guides.</p> <p>For authentication based on OpenID Connect (OIDC) JSON Web Tokens (JWT), plus one simple JWT claim authorization check, a typical <code>AuthConfig</code> custom resource looks like the following:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: my-api-protection\nspec:\n  hosts: # any hosts that resolve to the envoy service and envoy routing config where the external authorization filter is enabled\n\n  - my-api.io # north-south traffic through a Kubernetes `Ingress` or OpenShift `Route`\n  - my-api.myapp.svc.cluster.local # east-west traffic (between applications within the cluster)\n  authentication:\n    \"idp-users\":\n      jwt:\n        issuerUrl: https://my-idp.com/auth/realm\n  authorization:\n    \"check-claim\":\n      patternMatching:\n        patterns:\n        - selector: auth.identity.group\n          operator: eq\n          value: allowed-users\nEOF\n</code></pre> <p>After applying the <code>AuthConfig</code>, consumers of the protected service should be able to start sending requests.</p>"},{"location":"authorino/docs/getting-started/#clean-up","title":"Clean-up","text":""},{"location":"authorino/docs/getting-started/#remove-protection","title":"Remove protection","text":"<p>Delete the <code>AuthConfig</code>:</p> <pre><code>kubectl -n myapp delete authconfig/my-api-protection\n</code></pre> <p>Decommission the Authorino instance:</p> <pre><code>kubectl -n myapp delete authorino/authorino\n</code></pre>"},{"location":"authorino/docs/getting-started/#uninstall","title":"Uninstall","text":"<p>To completely remove Authorino CRDs, run from the Authorino Operator directory:</p> <pre><code>make uninstall\n</code></pre>"},{"location":"authorino/docs/getting-started/#next-steps","title":"Next steps","text":"<ol> <li>Read the docs. The Architecture page and the Features page are good starting points to learn more about how Authorino works and its functionalities.</li> <li>Check out the User guides for several examples of <code>AuthConfig</code>s based on specific use-cases</li> </ol>"},{"location":"authorino/docs/terminology/","title":"Terminology","text":"<p>Here we define some terms that are used in the project, with the goal of avoiding confusion and facilitating more accurate conversations related to <code>Authorino</code>.</p> <p>If you see terms used that are not here (or are used in place of terms here) please consider contributing a definition to this doc with a PR, or modifying the use elsewhere to align with these terms.</p>"},{"location":"authorino/docs/terminology/#terms","title":"Terms","text":"<p>Access token Type of temporary password (security token), tied to an authenticated identity, issued by an auth server as of request from either the identity subject itself or a registered auth client known by the auth server, and that delegates to a party powers to operate on behalf of that identity before a resource server; it can be formatted  as an opaque data string or as an encoded JSON Web Token (JWT).</p> <p>Application Programming Interface (API) Interface that defines interactions between multiple software applications; (in HTTP communication) set of endpoints and specification to expose resources hosted by a resource server, to be consumed by client applications; the access facade of a resource server.</p> <p>Attribute-based Access Control (ABAC) Authorization model that grants/denies access to resources based on evaluation of authorization policies which combine attributes together (from claims, from the request, from the resource, etc).</p> <p>Auth Usually employed as a short for authentication and authorization together (AuthN/AuthZ).</p> <p>Auth client Application client (software) that uses an auth server, either in the process of authenticating and/or authorizing identity subjects (including self) who want to consume resources from a resources server or auth server.</p> <p>Auth server Server where auth clients, users, roles, scopes, resources, policies and permissions can be stored and managed.</p> <p>Authentication (AuthN) Process of verifying that a given credential belongs to a claimed-to-be identity; usually resulting in the issuing of an access token.</p> <p>Authorization (AuthZ) Process of granting (or denying) access over a resource to a party based on the set of authorization rules, policies and/or permissions enforced.</p> <p>Authorization header HTTP request header frequently used to carry credentials to authenticate a user in an HTTP communication, like in requests sent to an API; alternatives usually include credentials carried in another (custom) HTTP header, query string parameter or HTTP cookie.</p> <p>Capability Usually employed to refer to a management feature of a Kubernetes-native system, based on the definition and use of Kubernetes Custom Resources (CRDs and CRs), that enables that system to one of the following \u201ccapability levels\u201d: Basic Install, Seamless Upgrades, Full Lifecycle, Deep Insights, Auto Pilot.</p> <p>Claim Attribute packed in a security token which represents a claim that one who bears the token is making about an entity, usually an identity subject.</p> <p>Client ID Unique identifier of an auth client within an auth server domain (or auth server realm).</p> <p>Client secret Password presented by auth clients together with their Client IDs while authenticating with an auth server, either when requesting access tokens to be issued or when consuming services from the auth servers in general.</p> <p>Delegation Process of granting a party (usually an auth client) with powers to act, often with limited scope, on behalf of an identity, to access resources from a resource server. See also OAuth2.</p> <p>Hash-based Message Authentication Code (HMAC) Specific type of message authentication code (MAC) that involves a cryptographic hash function and a shared secret cryptographic key; it can be used to verify the authenticity of a message and therefore as an authentication method.</p> <p>Identity Set of properties that qualifies a subject as a strong identifiable entity (usually a user), who can be authenticated by an auth server. See also Claims.</p> <p>Identity and Access Management (IAM) system Auth system that implements and/or connects with sources of identity (IdP) and offers interfaces for managing access (authorization policies and permissions). See also Auth server.</p> <p>Identity Provider (IdP) Source of identity; it can be a feature of an auth server or external source connected to an auth server.</p> <p>ID token Special type of access token; an encoded JSON Web Token (JWT) that packs claims about an identity.</p> <p>JSON Web Token (JWT) JSON Web Tokens are an open, industry standard RFC 7519 method for representing claims securely between two parties.</p> <p>JSON Web Signature (JWS) Standard for signing arbitrary data, especially JSON Web Tokens (JWT).</p> <p>JSON Web Key Set (JWKS) Set of keys containing the public keys used to verify any JSON Web Token (JWT).</p> <p>Keycloak Open source auth server to allow single sign-on with identity and access management.</p> <p>Lightweight Directory Access Protocol (LDAP) Open standard for distributed directory information services for sharing of information about users, systems, networks, services and applications.</p> <p>Mutual Transport Layer Security (mTLS) Protocol for the mutual authentication of client-server communication, i.e., the client authenticates the server and the server authenticates the client, based on the acceptance of the X.509 certificates of each party.</p> <p>OAuth 2.0 (OAuth2) Industry-standard protocol for delegation.</p> <p>OpenID Connect (OIDC) Simple identity verification (authentication) layer built on top of the OAuth2 protocol.</p> <p>Open Policy Agent (OPA) Authorization policy agent that enables the usage of declarative authorization policies written in Rego language.</p> <p>Opaque token Security token devoid of explicit meaning (e.g. random string); it requires the usage of lookup mechanism to be translated into a meaningful set claims representing an identity.</p> <p>Permission Association between a protected resource the authorization policies that must be evaluated whether access should be granted; e.g. <code>&lt;user|group|role&gt;</code> CAN DO <code>&lt;action&gt;</code> ON RESOURCE <code>&lt;X&gt;</code>.</p> <p>Policy Rule or condition (authorization policy) that must be satisfied to grant access to a resource; strongly related to the different access control mechanisms (ACMs) and strategies one can use to protect resources, e.g. attribute-based access control (ABAC), role-based access control (RBAC), context-based access control, user-based access control (UBAC).</p> <p>Policy Administration Point (PAP) Set of UIs and APIs to manage resources servers, resources, scopes, policies and permissions; it is where the auth system is configured.</p> <p>Policy Decision Point (PDP) Where the authorization requests are sent, with permissions being requested, and authorization policies are evaluated accordingly.</p> <p>Policy Enforcement Point (PEP) Where the authorization is effectively enforced, usually at the resource server or at a proxy, based on a response provided by the Policy Decision Point (PDP).</p> <p>Policy storage Where policies are stored and from where they can be fetched, perhaps to be cached.</p> <p>Red Hat SSO Auth server; downstream product created from the Keycloak Open Source project.</p> <p>Refresh token Special type of security token, often provided together with an access token in an OAuth2 flow, used to renew the duration of an access token before it expires; it requires client authentication.</p> <p>Request Party Token (RPT) JSON Web Token (JWT) digitally signed using JSON Web Signature (JWS), issued by the Keycloak auth server.</p> <p>Resource One or more endpoints of a system, API or server, that can be protected.</p> <p>Resource-level Access Control (RLAC) Authorization model that takes into consideration attributes of each specific request resource to grant/deny access to those resources (e.g. the resource's owner).</p> <p>Resource server Server that hosts protected resources.</p> <p>Role Aspect of a user\u2019s identity assigned to the user to indicate the level of access they should have to the system; essentially, roles represent collections of permissions</p> <p>Role-based Access Control (RBAC) Authorization model that grants/denies access to resources based on the roles of authenticated users (rather than on complex attributes/policy rules).</p> <p>Scope Mechanism that defines the specific operations that applications can be allowed to do or information that they can request on an identity\u2019s behalf; often presented as a parameter when access is requested as a way to communicate what access is needed, and used by auth server to respond what actual access is granted.</p> <p>Single Page Application (SPA) Web application or website that interacts with the user by dynamically rewriting the current web page with new data from the web server.</p> <p>Single Sign-on (SSO) Authentication scheme that allows a user to log in with a single ID and password to any of several related, yet independent, software systems.</p> <p>Upstream (In the context of authentication/authorization) API whose endpoints must be protected by the auth system; the unprotected service in front of which a protection layer is added (by connecting with a Policy Decision Point).</p> <p>User-based Access Control (UBAC) Authorization model that grants/denies access to resources based on claims of the identity (attributes of the user).</p> <p>User-Managed Access (UMA) OAuth2-based access management protocol, used for users of an auth server to control the authorization process, i.e. directly granting/denying access to user-owned resources to other requesting parties.</p>"},{"location":"authorino/docs/user-guides/","title":"User guides","text":"<ul> <li> <p>Hello World The basics of protecting an API with Authorino.</p> </li> <li> <p>Authentication with Kubernetes tokens (TokenReview API) Validate Kubernetes Service Account tokens to authenticate requests to your protected hosts.</p> </li> <li> <p>Authentication with API keys Issue API keys stored in Kubernetes <code>Secret</code>s for clients to authenticate with your protected hosts.</p> </li> <li> <p>Authentication with X.509 certificates and mTLS Verify client X.509 certificates against trusted root CAs.</p> </li> <li> <p>OpenID Connect Discovery and authentication with JWTs Validate JSON Web Tokens (JWT) issued and signed by an OpenID Connect server; leverage OpenID Connect Discovery to automatically fetch JSON Web Key Sets (JWKS).</p> </li> <li> <p>OAuth 2.0 token introspection (RFC 7662) Introspect OAuth 2.0 access tokens (e.g. opaque tokens) for online user data and token validation in request-time.</p> </li> <li> <p>Passing credentials (<code>Authorization</code> header, cookie headers and others) Customize where credentials are supplied in the request by each trusted source of identity.</p> </li> <li> <p>HTTP \"Basic\" Authentication (RFC 7235) Turn Authorino API key <code>Secret</code>s settings into HTTP basic auth.</p> </li> <li> <p>Anonymous access Bypass identity verification or fall back to anonymous access when credentials fail to validate</p> </li> <li> <p>Token normalization Normalize identity claims from trusted sources and reduce complexity in your policies.</p> </li> <li> <p>Edge Authentication Architecture (EAA) Exchange satellite (outer-layer) authentication tokens for \"Festival Wristbands\" accepted ubiquitously at the inside of your network. Normalize from multiple and varied sources of identity and authentication methods in the edge of your architecture; filter privacy data, limit the scope of permissions, and simplify authorization rules to your internal microservices.</p> </li> <li> <p>Fetching auth metadata from external sources Get online data from remote HTTP services to enhance authorization rules.</p> </li> <li> <p>OpenID Connect UserInfo Fetch user info for OpenID Connect ID tokens in request-time for extra metadata for your policies and online verification of token validity.</p> </li> <li> <p>Resource-level authorization with User-Managed Access (UMA) resource registry Fetch resource attributes relevant for authorization from a User-Managed Access (UMA) resource registry such as Keycloak resource server clients.</p> </li> <li> <p>Simple pattern-matching authorization policies Write simple authorization rules based on JSON patterns matched against Authorino's Authorization JSON; check contextual information of the request, validate JWT claims, cross metadata fetched from external sources, etc.</p> </li> <li> <p>OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Authorino and Keycloak Combine OpenID Connect (OIDC) authentication and Role-Based Access Control (RBAC) authorization rules leveraging Keycloak and Authorino working together.</p> </li> <li> <p>Open Policy Agent (OPA) Rego policies Leverage the power of Open Policy Agent (OPA) policies, evaluated against Authorino's Authorization JSON in a built-in runtime compiled together with Authorino; pre-cache policies defined in Rego language inline or fetched from an external policy registry.</p> </li> <li> <p>Kubernetes RBAC for service authorization (SubjectAccessReview API) Manage permissions in the Kubernetes RBAC and let Authorino to check them in request-time with the authorization system of the cluster.</p> </li> <li> <p>Authorization with Keycloak Authorization Services Use Authorino as an adapter for Keycloak Authorization Services without importing any library or rebuilding your application code.</p> </li> <li> <p>Integration with Authzed/SpiceDB Permission requests sent to a Google Zanzibar-based Authzed/SpiceDB instance, via gRPC.</p> </li> <li> <p>Injecting data in the request Inject HTTP headers with serialized JSON content.</p> </li> <li> <p>Authenticated rate limiting (with Envoy Dynamic Metadata) Provide Envoy with dynamic metadata from the external authorization process to be injected and used by consecutive filters, such as by a rate limiting service.</p> </li> <li> <p>Redirecting to a login page Customize response status code and headers on failed requests. E.g. redirect users of a web application protected with Authorino to a login page instead of a <code>401 Unauthorized</code>; mask resources on access denied behind a <code>404 Not Found</code> response instead of <code>403 Forbidden</code>.</p> </li> <li> <p>Mixing Envoy built-in filter for auth and Authorino Have JWT validation handled by Envoy beforehand and the JWT payload injected into the request to Authorino, to be used in custom authorization policies defined in a AuthConfig.</p> </li> <li> <p>Host override via context extension Induce the lookup of an AuthConfig by supplying extended host context, for use cases such as of path prefix-based lookup and wildcard subdomains lookup.</p> </li> <li> <p>Using Authorino as ValidatingWebhook service Use Authorino as a generic Kubernetes ValidatingWebhook service where the rules to validate a request to the Kubernetes API are written in an AuthConfig.</p> </li> <li> <p>Reducing the operational space: sharding, noise and multi-tenancy Have multiple instances of Authorino running in the same space (Kubernetes namespace or cluster-scoped), yet watching particular sets of resources.</p> </li> <li> <p>Caching Cache auth objects resolved at runtime for any configuration bit of an AuthConfig, for easy access in subsequent requests whenever an arbitrary cache key repeats, until the cache entry expires.</p> </li> <li> <p>Observability Prometheus metrics exported by Authorino, readiness probe, logging, tracing, etc.</p> </li> </ul>"},{"location":"authorino/docs/user-guides/anonymous-access/","title":"User guide: Anonymous access","text":"<p>Bypass identity verification or fall back to anonymous access when credentials fail to validate</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 Anonymous access</li> </ul> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/anonymous-access/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/anonymous-access/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/anonymous-access/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/anonymous-access/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/anonymous-access/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/anonymous-access/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"public\":\n      anonymous: {}\nEOF\n</code></pre> <p>The example above enables anonymous access (i.e. removes authentication), without adding any extra layer of protection to the API. This is virtually equivalent to setting a top-level condition to the <code>AuthConfig</code> that always skips the configuration, or to switching authentication/authorization off completely in the route to the API.</p> <p>For more sophisticated use cases of anonymous access with Authorino, consider combining this feature with other identity sources in the <code>AuthConfig</code> while playing with the priorities of each source, as well as combination with <code>when</code> conditions, and/or adding authorization policies that either cover authentication or address anonymous access with proper rules (e.g. enforcing read-only access).</p> <p>Check out the docs for the Anonymous access feature for an example of an <code>AuthConfig</code> that falls back to anonymous access when a priority OIDC/JWT-based authentication fails, and enforces a read-only policy in such cases.</p>"},{"location":"authorino/docs/user-guides/anonymous-access/#consume-the-api","title":"\u277b Consume the API","text":"<pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/anonymous-access/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/api-key-authentication/","title":"User guide: Authentication with API keys","text":"<p>Issue API keys stored in Kubernetes <code>Secret</code>s for clients to authenticate with your protected hosts.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 API key</li> </ul> <p>In Authorino, API keys are stored as Kubernetes <code>Secret</code>s. Each resource must contain an <code>api_key</code> entry with the value of the API key, and labeled to match the selectors specified in <code>spec.identity.apiKey.selector</code> of the <code>AuthConfig</code>.</p> <p>API key <code>Secret</code>s must also include labels that match the <code>secretLabelSelector</code> field of the Authorino instance. See Resource reconciliation and status update for details.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/api-key-authentication/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/api-key-authentication/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/api-key-authentication/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/api-key-authentication/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/api-key-authentication/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/api-key-authentication/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"friends\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: friends\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/api-key-authentication/#create-an-api-key","title":"\u277b Create an API key","text":"<pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: friends\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/api-key-authentication/#consume-the-api","title":"\u277c Consume the API","text":"<p>With a valid API key:</p> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>With missing or invalid API key:</p> <pre><code>curl -H 'Authorization: APIKEY invalid' http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: APIKEY realm=\"friends\"\n# x-ext-auth-reason: the API Key provided is invalid\n</code></pre>"},{"location":"authorino/docs/user-guides/api-key-authentication/#delete-an-api-key-revoke-access-to-the-api","title":"\u277d Delete an API key (revoke access to the API)","text":"<pre><code>kubectl delete secret/api-key-1\n</code></pre>"},{"location":"authorino/docs/user-guides/api-key-authentication/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/","title":"User guide: Authenticated rate limiting (with Envoy Dynamic Metadata)","text":"<p>Provide Envoy with dynamic metadata about the external authorization process to be injected into the rate limiting filter.</p> Authorino capabilities featured in this guide: <ul> <li>Dynamic response \u2192 Response wrappers \u2192 Envoy Dynamic Metadata</li> <li>Dynamic response \u2192 JSON injection</li> <li>Identity verification &amp; authentication \u2192 API key</li> </ul> <p>Dynamic JSON objects built out of static values and values fetched from the Authorization JSON can be wrapped to be returned to the reverse-proxy as Envoy Well Known Dynamic Metadata content. Envoy can use those to inject data returned by the external authorization service into the other filters, such as the rate limiting filter.</p> <p>Check out as well the user guides about Injecting data in the request and Authentication with API keys.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277b.</p> <p>At step \u277b, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#deploy-limitador","title":"\u2778 Deploy Limitador","text":"<p>Limitador is a lightweight rate limiting service that can be used with Envoy.</p> <p>On this bundle, we will deploy Limitador pre-configured to limit requests to the <code>talker-api</code> domain up to 5 requests per interval of 60 seconds per <code>user_id</code>. Envoy will be configured to recognize the presence of Limitador and activate it on requests to the Talker API.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/limitador/limitador-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#deploy-the-talker-api","title":"\u2779 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#setup-envoy","title":"\u277a Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#create-an-authconfig","title":"\u277b Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>An annotation <code>auth-data/username</code> will be read from the Kubernetes API Key secret and passed as dynamic metadata <code>{ \"ext_auth_data\": { \"username\": \u00abannotations.auth-data/username\u00bb } }</code>.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"friends\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: friends\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n  response:\n    success:\n      dynamicMetadata:\n        \"rate-limit\":\n          json:\n            properties:\n              \"username\":\n                selector: auth.identity.metadata.annotations.auth-data\\/username\n          key: ext_auth_data # how this bit of dynamic metadata from the ext authz service is named in the Envoy config\nEOF\n</code></pre> <p>Check out the docs for information about the common feature JSON paths for reading from the Authorization JSON.</p>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#create-the-api-keys","title":"\u277c Create the API keys","text":"<p>For user John:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: friends\n  annotations:\n    auth-data/username: john\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre> <p>For user Jane:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-2\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: friends\n  annotations:\n    auth-data/username: jane\nstringData:\n  api_key: 7BNaTmYGItSzXiwQLNHu82+x52p1XHgY\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#consume-the-api","title":"\u277d Consume the API","text":"<p>As John:</p> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre> <p>Repeat the request a few more times within the 60-second time window, until the response status is <code>429 Too Many Requests</code>.</p> <p>While the API is still limited to John, send requests as Jane:</p> <pre><code>curl -H 'Authorization: APIKEY 7BNaTmYGItSzXiwQLNHu82+x52p1XHgY' http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/api-key-1\nkubectl delete secret/api-key-2\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/limitador/limitador-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/authzed/","title":"User guide: Integration with Authzed/SpiceDB","text":"<p>Permission requests sent to a Google Zanzibar-based Authzed/SpiceDB instance, via gRPC.</p> Authorino capabilities featured in this guide: <ul> <li>Authorization \u2192 SpiceDB</li> <li>Identity verification &amp; authentication \u2192 API key</li> </ul> <p></p>"},{"location":"authorino/docs/user-guides/authzed/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277b.</p> <p>At step \u277b, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/authzed/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/authzed/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/authzed/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/authzed/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/authzed/#create-the-permission-database","title":"\u277a Create the permission database","text":"<p>Create the namespace:</p> <pre><code>kubectl create namespace spicedb\n</code></pre> <p>Create the SpiceDB instance:</p> <pre><code>kubectl -n spicedb apply -f -&lt;&lt;EOF\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: spicedb\n  labels:\n    app: spicedb\nspec:\n  selector:\n    matchLabels:\n      app: spicedb\n  template:\n    metadata:\n      labels:\n        app: spicedb\n    spec:\n      containers:\n\n      - name: spicedb\n        image: authzed/spicedb\n        args:\n        - serve\n        - \"--grpc-preshared-key\"\n        - secret\n        - \"--http-enabled\"\n        ports:\n        - containerPort: 50051\n        - containerPort: 8443\n  replicas: 1\n---\napiVersion: v1\nkind: Service\nmetadata:\n  name: spicedb\nspec:\n  selector:\n    app: spicedb\n  ports:\n    - name: grpc\n      port: 50051\n      protocol: TCP\n    - name: http\n      port: 8443\n      protocol: TCP\nEOF\n</code></pre> <p>Forward local request to the SpiceDB service inside the cluster:</p> <pre><code>kubectl -n spicedb port-forward service/spicedb 8443:8443 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre> <p>Create the permission schema:</p> <pre><code>curl -X POST http://localhost:8443/v1/schema/write \\\n  -H 'Authorization: Bearer secret' \\\n  -H 'Content-Type: application/json' \\\n  -d @- &lt;&lt; EOF\n{\n  \"schema\": \"definition blog/user {}\\ndefinition blog/post {\\n\\trelation reader: blog/user\\n\\trelation writer: blog/user\\n\\n\\tpermission read = reader + writer\\n\\tpermission write = writer\\n}\"\n}\nEOF\n</code></pre> <p>Create the relationships:</p> <ul> <li><code>blog/user:emilia</code> \u2192 <code>writer</code> of <code>blog/post:1</code></li> <li><code>blog/user:beatrice</code> \u2192 <code>reader</code> of <code>blog/post:1</code></li> </ul> <pre><code>curl -X POST http://localhost:8443/v1/relationships/write \\\n  -H 'Authorization: Bearer secret' \\\n  -H 'Content-Type: application/json' \\\n  -d @- &lt;&lt; EOF\n{\n  \"updates\": [\n    {\n      \"operation\": \"OPERATION_CREATE\",\n      \"relationship\": {\n        \"resource\": {\n          \"objectType\": \"blog/post\",\n          \"objectId\": \"1\"\n        },\n        \"relation\": \"writer\",\n        \"subject\": {\n          \"object\": {\n            \"objectType\": \"blog/user\",\n            \"objectId\": \"emilia\"\n          }\n        }\n      }\n    },\n    {\n      \"operation\": \"OPERATION_CREATE\",\n      \"relationship\": {\n        \"resource\": {\n          \"objectType\": \"blog/post\",\n          \"objectId\": \"1\"\n        },\n        \"relation\": \"reader\",\n        \"subject\": {\n          \"object\": {\n            \"objectType\": \"blog/user\",\n            \"objectId\": \"beatrice\"\n          }\n        }\n      }\n    }\n  ]\n}\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/authzed/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <p>Store the shared token for Authorino to authenticate with the SpiceDB instance in a Service:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: spicedb\n  labels:\n    app: spicedb\nstringData:\n  grpc-preshared-key: secret\nEOF\n</code></pre> <p>Create the AuthConfig:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"blog-users\":\n      apiKey:\n        selector:\n          matchLabels:\n            app: talker-api\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n  authorization:\n    \"authzed-spicedb\":\n      spicedb:\n        endpoint: spicedb.spicedb.svc.cluster.local:50051\n        insecure: true\n        sharedSecretRef:\n          name: spicedb\n          key: grpc-preshared-key\n        subject:\n          kind:\n            value: blog/user\n          name:\n            selector: auth.identity.metadata.annotations.username\n        resource:\n          kind:\n            value: blog/post\n          name:\n            selector: context.request.http.path.@extract:{\"sep\":\"/\",\"pos\":2}\n        permission:\n          selector: context.request.http.method.@replace:{\"old\":\"GET\",\"new\":\"read\"}.@replace:{\"old\":\"POST\",\"new\":\"write\"}\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/authzed/#create-the-api-keys","title":"\u277c Create the API keys","text":"<p>For Emilia (writer):</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-writer\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    app: talker-api\n  annotations:\n    username: emilia\nstringData:\n  api_key: IAMEMILIA\nEOF\n</code></pre> <p>For Beatrice (reader):</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-reader\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    app: talker-api\n  annotations:\n    username: beatrice\nstringData:\n  api_key: IAMBEATRICE\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/authzed/#consume-the-api","title":"\u277d Consume the API","text":"<p>As Emilia, send a GET request:</p> <pre><code>curl -H 'Authorization: APIKEY IAMEMILIA' \\\n     -X GET \\\n     http://talker-api.127.0.0.1.nip.io:8000/posts/1 -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As Emilia, send a POST request:</p> <pre><code>curl -H 'Authorization: APIKEY IAMEMILIA' \\\n     -X POST \\\n     http://talker-api.127.0.0.1.nip.io:8000/posts/1 -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As Beatrice, send a GET request:</p> <pre><code>curl -H 'Authorization: APIKEY IAMBEATRICE' \\\n     -X GET \\\n     http://talker-api.127.0.0.1.nip.io:8000/posts/1 -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As Beatrice, send a POST request:</p> <pre><code>curl -H 'Authorization: APIKEY IAMBEATRICE' \\\n     -X POST \\\n     http://talker-api.127.0.0.1.nip.io:8000/posts/1 -i\n# HTTP/1.1 403 Forbidden\n# x-ext-auth-reason: PERMISSIONSHIP_NO_PERMISSION;token=GhUKEzE2NzU3MDE3MjAwMDAwMDAwMDA=\n</code></pre>"},{"location":"authorino/docs/user-guides/authzed/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/api-key-1\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace spicedb\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/caching/","title":"User guide: Caching","text":"<p>Cache auth objects resolved at runtime for any configuration bit of an AuthConfig (i.e. any evaluator), of any phase (identity, metadata, authorization and dynamic response), for easy access in subsequent requests, whenever an arbitrary (user-defined) cache key repeats, until the cache entry expires.</p> <p>This is particularly useful for configuration bits whose evaluation is significantly more expensive than accessing the cache. E.g.:</p> <ul> <li>Caching of metadata fetched from external sources in general</li> <li>Caching of previously validated identity access tokens (e.g. for OAuth2 opaque tokens that involve consuming the token introspection endpoint of an external auth server)</li> <li>Caching of complex Rego policies that involve sending requests to external services</li> </ul> <p>Cases where one will NOT want to enable caching, due to relatively cheap compared to accessing and managing the cache:</p> <ul> <li>Validation of OIDC/JWT access tokens</li> <li>OPA/Rego policies that do not involve external requests</li> <li>JSON pattern-matching authorization</li> <li>Dynamic JSON responses</li> <li>Anonymous access</li> </ul> Authorino capabilities featured in this guide: <ul> <li>Common feature \u2192 Caching</li> <li>Identity verification &amp; authentication \u2192 Anonymous access</li> <li>External auth metadata \u2192 HTTP GET/GET-by-POST</li> <li>Authorization \u2192 Open Policy Agent (OPA) Rego policies</li> <li>Dynamic response \u2192 JSON injection</li> </ul> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/caching/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/caching/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/caching/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/caching/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/caching/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/caching/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>The example below enables caching for the external source of metadata, which in this case, for convenience, is the same upstream API protected by Authorino (i.e. the Talker API), though consumed directly by Authorino, without passing through the proxy. This API generates a <code>uuid</code> random hash that it injects in the JSON response. This value is different in every request processed by the API.</p> <p>The example also enables caching of returned OPA virtual documents. <code>cached-authz</code> is a trivial Rego policy that always grants access, but generates a timestamp, which Authorino will cache.</p> <p>In both cases, the path of the HTTP request is used as cache key. I.e., whenever the path repeats, Authorino reuse the values stored previously in each cache table (<code>cached-metadata</code> and <code>cached-authz</code>), respectively saving a request to the external source of metadata and the evaluation of the OPA policy. Cache entries will expire in both cases after 60 seconds they were stored in the cache.</p> <p>The cached values will be visible in the response returned by the Talker API in <code>x-authz-data</code> header injected by Authorino. This way, we can tell when an existing value in the cache was used and when a new one was generated and stored.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"anonymous\":\n      anonymous: {}\n  metadata:\n    \"cached-metadata\":\n      http:\n        url: \"http://talker-api.default.svc.cluster.local:3000/metadata/{context.request.http.path}\"\n      cache:\n        key:\n          selector: context.request.http.path\n        ttl: 60\n  authorization:\n    \"cached-authz\":\n      opa:\n        rego: |\n          now = time.now_ns()\n          allow = true\n        allValues: true\n      cache:\n        key:\n          selector: context.request.http.path\n        ttl: 60\n  response:\n    success:\n      headers:\n        \"x-authz-data\":\n          json:\n            properties:\n              \"cached-metadata\":\n                selector: auth.metadata.cached-metadata.uuid\n              \"cached-authz\":\n                selector: auth.authorization.cached-authz.now\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/caching/#consume-the-api","title":"\u277b Consume the API","text":"<ol> <li>To <code>/hello</code></li> </ol> <pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello\n# [\u2026]\n#  \"X-Authz-Data\": \"{\\\"cached-authz\\\":\\\"1649343067462380300\\\",\\\"cached-metadata\\\":\\\"92c111cd-a10f-4e86-8bf0-e0cd646c6f79\\\"}\",\n# [\u2026]\n</code></pre> <ol> <li>To a different path</li> </ol> <pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/goodbye\n# [\u2026]\n#  \"X-Authz-Data\": \"{\\\"cached-authz\\\":\\\"1649343097860450300\\\",\\\"cached-metadata\\\":\\\"37fce386-1ee8-40a7-aed1-bf8a208f283c\\\"}\",\n# [\u2026]\n</code></pre> <ol> <li>To <code>/hello</code> again before the cache entry expires (60 seconds from the first request sent to this path)</li> </ol> <pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello\n# [\u2026]\n#  \"X-Authz-Data\": \"{\\\"cached-authz\\\":\\\"1649343067462380300\\\",\\\"cached-metadata\\\":\\\"92c111cd-a10f-4e86-8bf0-e0cd646c6f79\\\"}\",  &lt;=== same cache-id as before\n# [\u2026]\n</code></pre> <ol> <li>To <code>/hello</code> again after the cache entry expires (60 seconds from the first request sent to this path)</li> </ol> <pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello\n# [\u2026]\n#  \"X-Authz-Data\": \"{\\\"cached-authz\\\":\\\"1649343135702743800\\\",\\\"cached-metadata\\\":\\\"e708a3a6-5caf-4028-ab5c-573ad9be7188\\\"}\",  &lt;=== different cache-id\n# [\u2026]\n</code></pre>"},{"location":"authorino/docs/user-guides/caching/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/","title":"User guide: Redirecting to a login page","text":"<p>Customize response status code and headers on failed requests to redirect users of a web application protected with Authorino to a login page instead of a <code>401 Unauthorized</code>.</p> Authorino capabilities featured in this guide: <ul> <li>Dynamic response \u2192 Custom denial status</li> <li>Identity verification &amp; authentication \u2192 API key</li> <li>Identity verification &amp; authentication \u2192 JWT verification</li> </ul> <p>Authorino's default response status codes, messages and headers for unauthenticated (<code>401</code>) and unauthorized (<code>403</code>) requests can be customized with static values and values fetched from the Authorization JSON.</p> <p>Check out as well the user guides about HTTP \"Basic\" Authentication (RFC 7235) and OpenID Connect Discovery and authentication with JWTs.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample web application called Matrix Quotes to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#deploy-the-matrix-quotes-web-application","title":"\u2778 Deploy the Matrix Quotes web application","text":"<p>The Matrix Quotes is a static web application that contains quotes from the film The Matrix.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/matrix-quotes/matrix-quotes-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Matrix Quotes webapp behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/matrix-quotes/envoy-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>matrix-quotes.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: matrix-quotes-protection\nspec:\n  hosts:\n\n  - matrix-quotes.127.0.0.1.nip.io\n  authentication:\n    \"browser-users\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: users\n      credentials:\n        cookie:\n          name: TOKEN\n    \"http-basic-auth\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: users\n      credentials:\n        authorizationHeader:\n          prefix: Basic\n  response:\n    unauthenticated:\n      code: 302\n      headers:\n        \"Location\":\n          selector: \"http://matrix-quotes.127.0.0.1.nip.io:8000/login.html?redirect_to={request.path}\"\nEOF\n</code></pre> <p>Check out the docs for information about the common feature JSON paths for reading from the Authorization JSON.</p>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#create-an-api-key","title":"\u277b Create an API key","text":"<pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: user-credential-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: users\nstringData:\n  api_key: am9objpw # john:p\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#consume-the-application","title":"\u277c Consume the application","text":"<p>On a web browser, navigate to http://matrix-quotes.127.0.0.1.nip.io:8000.</p> <p>Click on the cards to read quotes from characters of the movie. You should be redirected to login page.</p> <p>Log in using John's credentials:</p> <ul> <li>Username: john</li> <li>Password: p</li> </ul> <p>Click again on the cards and check that now you are able to access the inner pages.</p> <p>You can also consume a protected endpoint of the application using HTTP Basic Authentication:</p> <pre><code>curl -u john:p http://matrix-quotes.127.0.0.1.nip.io:8000/neo.html\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#optional-modify-the-authconfig-to-authenticate-with-oidc","title":"\u277d (Optional) Modify the <code>AuthConfig</code> to authenticate with OIDC","text":""},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#setup-a-keycloak-server","title":"Setup a Keycloak server","text":"<p>Deploy a Keycloak server preloaded with a realm named <code>kuadrant</code>:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p>Resolve local Keycloak domain so it can be accessed from the local host and inside the cluster with the name: (This will be needed to redirect to Keycloak's login page and at the same time validate issued tokens.)</p> <pre><code>echo '127.0.0.1 keycloak' &gt;&gt; /etc/hosts\n</code></pre> <p>Forward local requests to the instance of Keycloak running in the cluster:</p> <pre><code>kubectl port-forward deployment/keycloak 8080:8080 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre> <p>Create a client:</p> <pre><code>curl -H \"Authorization: Bearer $(curl http://keycloak:8080/realms/master/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=admin-cli' -d 'username=admin' -d 'password=p' | jq -r .access_token)\" \\\n     -H 'Content-type: application/json' \\\n     -d '{ \"name\": \"matrix-quotes\", \"clientId\": \"matrix-quotes\", \"publicClient\": true, \"redirectUris\": [\"http://matrix-quotes.127.0.0.1.nip.io:8000/auth*\"], \"enabled\": true }' \\\n     http://keycloak:8080/admin/realms/kuadrant/clients\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#reconfigure-the-matrix-quotes-app-to-use-keycloaks-login-page","title":"Reconfigure the Matrix Quotes app to use Keycloak's login page","text":"<pre><code>kubectl set env deployment/matrix-quotes KEYCLOAK_REALM=http://keycloak:8080/realms/kuadrant CLIENT_ID=matrix-quotes\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#apply-the-changes-to-the-authconfig","title":"Apply the changes to the <code>AuthConfig</code>","text":"<pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: matrix-quotes-protection\nspec:\n  hosts:\n\n  - matrix-quotes.127.0.0.1.nip.io\n  authentication:\n    \"idp-users\":\n      jwt:\n        issuerUrl: http://keycloak:8080/realms/kuadrant\n      credentials:\n        cookie:\n          name: TOKEN\n  response:\n    unauthenticated:\n      code: 302\n      headers:\n        \"Location\":\n          selector: \"http://keycloak:8080/realms/kuadrant/protocol/openid-connect/auth?client_id=matrix-quotes&amp;redirect_uri=http://matrix-quotes.127.0.0.1.nip.io:8000/auth?redirect_to={request.path}&amp;scope=openid&amp;response_type=code\"\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#consume-the-application-again","title":"Consume the application again","text":"<p>Refresh the browser window or navigate again to http://matrix-quotes.127.0.0.1.nip.io:8000.</p> <p>Click on the cards to read quotes from characters of the movie. You should be redirected to login page this time served by the Keycloak server.</p> <p>Log in as Jane (a user of the Keycloak realm):</p> <ul> <li>Username: jane</li> <li>Password: p</li> </ul> <p>Click again on the cards and check that now you are able to access the inner pages.</p>"},{"location":"authorino/docs/user-guides/deny-with-redirect-to-login/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/user-credential-1\nkubectl delete authconfig/matrix-quotes-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/matrix-quotes/matrix-quotes-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/","title":"User guide: Edge Authentication Architecture (EAA)","text":"<p>Edge Authentication Architecture (EAA) is a pattern where more than extracting authentication logics and specifics from the application codebase to a proper authN/authZ layer, this is pushed to the edge of your cloud network, without violating the Zero Trust principle nevertheless.</p> <p>The very definition of \"edge\" is subject to discussion, but the underlying idea is that clients (e.g. API clients, IoT devices, etc.) authenticate with a layer that, before moving traffic to inside the network:</p> <ul> <li>understands the complexity of all the different methods of authentication supported;</li> <li>sometimes some token normalization is involved;</li> <li>eventually enforces some preliminary authorization policies; and</li> <li>possibly filters data bits that are sensitive to privacy concerns (e.g. to comply with local legislation such as GRPD, CCPA, etc)</li> </ul> <p>As a minimum, EAA allows to simplify authentication between applications and microservices inside the network, as well as to reduce authorization to domain-specific rules and policies, rather than having to deal all the complexity to support all types of clients in every node.</p> Authorino capabilities featured in this guide: <ul> <li>Dynamic response \u2192 Festival Wristband tokens</li> <li>Identity verification &amp; authentication \u2192 Identity extension</li> <li>Identity verification &amp; authentication \u2192 API key</li> <li>Identity verification &amp; authentication \u2192 JWT verification</li> </ul> <p>Festival Wristbands are OpenID Connect ID tokens (signed JWTs) issued by Authorino by the end of the Auth Pipeline, for authorized requests. It can be configured to include claims based on static values and values fetched from the Authorization JSON.</p> <p>Check out as well the user guides about Token normalization, Authentication with API keys and OpenID Connect Discovery and authentication with JWTs.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> <li>jq, to extract parts of JSON responses</li> <li>jwt, to inspect JWTs (optional)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino and configuring 2 environments of an architecture, <code>edge</code> and <code>internal</code>.</p> <p>The first environment is a facade for handling the first layer of authentication and exchanging any valid presented authentication token for a Festival Wristband token. In the second, we will deploy a sample service called Talker API that the authorization service will ensure to receive only authenticated traffic presented with a valid Festival Wristband.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u2779.</p> <p>At steps \u2779 and \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#create-the-namespaces","title":"\u2777 Create the namespaces","text":"<p>For simplicity, this examples will set up edge and internal nodes in different namespaces of the same Kubernetes cluster. Those will share a same single cluster-wide Authorino instance. In real-life scenarios, it does not have to be like that.</p> <pre><code>kubectl create namespace authorino\nkubectl create namespace edge\nkubectl create namespace internal\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#deploy-authorino","title":"\u2778 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources cluster-wide<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl -n authorino apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  clusterWide: true\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#setup-the-edge","title":"\u2779 Setup the Edge","text":""},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#setup-envoy","title":"Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up external authorization with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl -n edge apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/eaa/envoy-edge-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>edge.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 9000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl -n edge port-forward deployment/envoy 9000:9000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#create-the-authconfig","title":"Create the <code>AuthConfig</code>","text":"<p>Create a required secret that will be used by Authorino to sign the Festival Wristband tokens:</p> <pre><code>kubectl -n edge apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: wristband-signing-key\nstringData:\n  key.pem: |\n    -----BEGIN EC PRIVATE KEY-----\n    MHcCAQEEIDHvuf81gVlWGo0hmXGTAnA/HVxGuH8vOc7/8jewcVvqoAoGCCqGSM49\n    AwEHoUQDQgAETJf5NLVKplSYp95TOfhVPqvxvEibRyjrUZwwtpDuQZxJKDysoGwn\n    cnUvHIu23SgW+Ee9lxSmZGhO4eTdQeKxMA==\n    -----END EC PRIVATE KEY-----\ntype: Opaque\nEOF\n</code></pre> <p>Create the config:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl -n edge apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: edge-auth\nspec:\n  hosts:\n\n  - edge.127.0.0.1.nip.io\n  authentication:\n    \"api-clients\":\n      apiKey:\n        selector:\n          matchLabels:\n            authorino.kuadrant.io/managed-by: authorino\n        allNamespaces: true\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n      overrides:\n        \"username\":\n          selector: auth.identity.metadata.annotations.authorino\\.kuadrant\\.io/username\n    \"idp-users\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n      defaults:\n        \"username\":\n          selector: auth.identity.preferred_username\n  response:\n    success:\n      dynamicMetadata:\n        \"wristband\":\n          wristband:\n            issuer: http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/edge/edge-auth/wristband\n            customClaims:\n              \"username\":\n                selector: auth.identity.username\n            tokenDuration: 300\n            signingKeyRefs:\n            - name: wristband-signing-key\n              algorithm: ES256\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#setup-the-internal-workload","title":"\u277a Setup the internal workload","text":""},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#deploy-the-talker-api","title":"Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl -n internal apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#setup-envoy_1","title":"Setup Envoy","text":"<p>This other bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.</p> <pre><code>kubectl -n internal apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/eaa/envoy-node-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl -n internal port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#create-the-authconfig_1","title":"Create the <code>AuthConfig</code>","text":"Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl -n internal apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"edge-authenticated\":\n      jwt:\n        issuerUrl: http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/edge/edge-auth/wristband\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#create-an-api-key","title":"\u277b Create an API key","text":"<pre><code>kubectl -n edge apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n  annotations:\n    authorino.kuadrant.io/username: alice\n    authorino.kuadrant.io/email: alice@host\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#consume-the-api","title":"\u277c Consume the API","text":""},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#using-the-api-key-to-authenticate","title":"Using the API key to authenticate","text":"<p>Authenticate at the edge:</p> <pre><code>WRISTBAND_TOKEN=$(curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' http://edge.127.0.0.1.nip.io:9000/auth -is | tr -d '\\r' | sed -En 's/^x-wristband-token: (.*)/\\1/p')\n</code></pre> <p>Consume the API:</p> <pre><code>curl -H \"Authorization: Bearer $WRISTBAND_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre> <p>Try to consume the API with authentication token that is only accepted in the edge:</p> <pre><code>curl -H \"Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Bearer realm=\"edge-authenticated\"\n# x-ext-auth-reason: credential not found\n</code></pre> <p>(Optional) Inspect the wristband token and verify that it only contains restricted info to authenticate and authorize with internal apps.</p> <pre><code>jwt decode $WRISTBAND_TOKEN\n# [...]\n#\n# Token claims\n# ------------\n# {\n#   \"exp\": 1638452051,\n#   \"iat\": 1638451751,\n#   \"iss\": \"http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/edge/edge-auth/wristband\",\n#   \"sub\": \"02cb51ea0e1c9f3c0960197a2518c8eb4f47e1b9222a968ffc8d4c8e783e4d19\",\n#   \"username\": \"alice\"\n# }\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#authenticating-with-the-keycloak-server","title":"Authenticating with the Keycloak server","text":"<p>Obtain an access token with the Keycloak server for Jane:</p> <p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster for the user Jane, whose e-mail has been verified:</p> <pre><code>ACCESS_TOKEN=$(kubectl -n edge run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p> <p>(Optional) Inspect the access token issue by Keycloak and verify and how it contains more details about the identity than required to authenticate and authorize with internal apps.</p> <pre><code>jwt decode $ACCESS_TOKEN\n# [...]\n#\n# Token claims\n# ------------\n# { [...]\n#   \"email\": \"jane@kuadrant.io\",\n#   \"email_verified\": true,\n#   \"exp\": 1638452220,\n#   \"family_name\": \"Smith\",\n#   \"given_name\": \"Jane\",\n#   \"iat\": 1638451920,\n#   \"iss\": \"http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\",\n#   \"jti\": \"699f6e49-dea4-4f29-ae2a-929a3a18c94b\",\n#   \"name\": \"Jane Smith\",\n#   \"preferred_username\": \"jane\",\n#   \"realm_access\": {\n#     \"roles\": [\n#       \"offline_access\",\n#       \"member\",\n#       \"admin\",\n#       \"uma_authorization\"\n#     ]\n#   },\n# [...]\n</code></pre> <p>As Jane, obtain a limited wristband token at the edge:</p> <pre><code>WRISTBAND_TOKEN=$(curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://edge.127.0.0.1.nip.io:9000/auth -is | tr -d '\\r' | sed -En 's/^x-wristband-token: (.*)/\\1/p')\n</code></pre> <p>Consume the API:</p> <pre><code>curl -H \"Authorization: Bearer $WRISTBAND_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete namespace edge\nkubectl delete namespace internal\nkubectl delete namespace authorino\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino and Authorino Operator manifests, run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>cluster-wide</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/","title":"User guide: Mixing Envoy built-in filter for auth and Authorino","text":"<p>Have JWT validation handled by Envoy beforehand and the JWT payload injected into the request to Authorino, to be used in custom authorization policies defined in a AuthConfig.</p> <p>In this user guide, we will set up Envoy and Authorino to protect a service called the Talker API service, with JWT authentication handled in Envoy and a more complex authorization policy enforced in Authorino.</p> <p>The policy defines a geo-fence by which only requests originated in Great Britain (country code: GB) will be accepted, unless the user is bound to a role called 'admin' in the auth server, in which case no geofence is enforced.</p> <p>All requests to the Talker API will be authenticated in Envoy. However, requests to <code>/global</code> will not trigger the external authorization.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 Plain</li> <li>External auth metadata \u2192 HTTP GET/GET-by-POST</li> <li>Authorization \u2192 Pattern-matching authorization</li> <li>Dynamic response \u2192 Custom denial status</li> </ul> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277b.</p> <p>At step \u277b, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following command deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: ConfigMap\nmetadata:\n  labels:\n    app: authorino\n  name: envoy\ndata:\n  envoy.yaml: |\n    static_resources:\n      clusters:\n\n      - name: talker-api\n        connect_timeout: 0.25s\n        type: strict_dns\n        lb_policy: round_robin\n        load_assignment:\n          cluster_name: talker-api\n          endpoints:\n          - lb_endpoints:\n            - endpoint:\n                address:\n                  socket_address:\n                    address: talker-api\n                    port_value: 3000\n      - name: keycloak\n        connect_timeout: 0.25s\n        type: logical_dns\n        lb_policy: round_robin\n        load_assignment:\n          cluster_name: keycloak\n          endpoints:\n          - lb_endpoints:\n            - endpoint:\n                address:\n                  socket_address:\n                    address: keycloak.keycloak.svc.cluster.local\n                    port_value: 8080\n      - name: authorino\n        connect_timeout: 0.25s\n        type: strict_dns\n        lb_policy: round_robin\n        http2_protocol_options: {}\n        load_assignment:\n          cluster_name: authorino\n          endpoints:\n          - lb_endpoints:\n            - endpoint:\n                address:\n                  socket_address:\n                    address: authorino-authorino-authorization\n                    port_value: 50051\n      listeners:\n      - address:\n          socket_address:\n            address: 0.0.0.0\n            port_value: 8000\n        filter_chains:\n        - filters:\n          - name: envoy.http_connection_manager\n            typed_config:\n              \"@type\": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager\n              stat_prefix: local\n              route_config:\n                name: local_route\n                virtual_hosts:\n                - name: local_service\n                  domains: ['*']\n                  routes:\n                  - match: { path_separated_prefix: /global }\n                    route: { cluster: talker-api }\n                    typed_per_filter_config:\n                      envoy.filters.http.ext_authz:\n                        \"@type\": type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute\n                        disabled: true\n                  - match: { prefix: / }\n                    route: { cluster: talker-api }\n              http_filters:\n              - name: envoy.filters.http.jwt_authn\n                typed_config:\n                  \"@type\": type.googleapis.com/envoy.extensions.filters.http.jwt_authn.v3.JwtAuthentication\n                  providers:\n                    keycloak:\n                      issuer: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n                      remote_jwks:\n                        http_uri:\n                          uri: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/certs\n                          cluster: keycloak\n                          timeout: 5s\n                        cache_duration:\n                          seconds: 300\n                      payload_in_metadata: verified_jwt\n                  rules:\n                  - match: { prefix: / }\n                    requires: { provider_name: keycloak }\n              - name: envoy.filters.http.ext_authz\n                typed_config:\n                  \"@type\": type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthz\n                  transport_api_version: V3\n                  failure_mode_allow: false\n                  metadata_context_namespaces:\n                  - envoy.filters.http.jwt_authn\n                  grpc_service:\n                    envoy_grpc:\n                      cluster_name: authorino\n                    timeout: 1s\n              - name: envoy.filters.http.router\n                typed_config:\n                  \"@type\": type.googleapis.com/envoy.extensions.filters.http.router.v3.Router\n              use_remote_address: true\n    admin:\n      access_log_path: \"/tmp/admin_access.log\"\n      address:\n        socket_address:\n          address: 0.0.0.0\n          port_value: 8001\n---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n  labels:\n    app: authorino\n    svc: envoy\n  name: envoy\nspec:\n  replicas: 1\n  selector:\n    matchLabels:\n      app: authorino\n      svc: envoy\n  template:\n    metadata:\n      labels:\n        app: authorino\n        svc: envoy\n    spec:\n      containers:\n      - args:\n        - --config-path /usr/local/etc/envoy/envoy.yaml\n        - --service-cluster front-proxy\n        - --log-level info\n        - --component-log-level filter:trace,http:debug,router:debug\n        command:\n        - /usr/local/bin/envoy\n        image: envoyproxy/envoy:v1.22-latest\n        name: envoy\n        ports:\n        - containerPort: 8000\n          name: web\n        - containerPort: 8001\n          name: admin\n        volumeMounts:\n        - mountPath: /usr/local/etc/envoy\n          name: config\n          readOnly: true\n      volumes:\n      - configMap:\n          items:\n          - key: envoy.yaml\n            path: envoy.yaml\n          name: envoy\n        name: config\n---\napiVersion: v1\nkind: Service\nmetadata:\n  labels:\n    app: authorino\n  name: envoy\nspec:\n  ports:\n  - name: web\n    port: 8000\n    protocol: TCP\n  selector:\n    app: authorino\n    svc: envoy\n---\napiVersion: networking.k8s.io/v1\nkind: Ingress\nmetadata:\n  name: ingress-wildcard-host\nspec:\n  rules:\n  - host: talker-api.127.0.0.1.nip.io\n    http:\n      paths:\n      - backend:\n          service:\n            name: envoy\n            port:\n              number: 8000\n        path: /\n        pathType: Prefix\nEOF\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#deploy-the-ip-location-service","title":"\u277a Deploy the IP Location service","text":"<p>The IP Location service is a simple service that resolves an IPv4 address into geo location info.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/Kuadrant/authorino-examples/main/ip-location/ip-location-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#create-an-authconfig","title":"\u277b Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"jwt\":\n      plain:\n        selector: context.metadata_context.filter_metadata.envoy\\.filters\\.http\\.jwt_authn|verified_jwt\n  metadata:\n    \"geoinfo\":\n      http:\n        url: 'http://ip-location.default.svc.cluster.local:3000/{context.request.http.headers.x-forwarded-for.@extract:{\"sep\":\",\"}}'\n        headers:\n          \"Accept\":\n            value: application/json\n      cache:\n        key:\n          selector: \"context.request.http.headers.x-forwarded-for.@extract:{\\\"sep\\\":\\\",\\\"}\"\n  authorization:\n    \"geofence\":\n      when:\n      - selector: auth.identity.realm_access.roles\n        operator: excl\n        value: admin\n      patternMatching:\n        patterns:\n        - selector: auth.metadata.geoinfo.country_iso_code\n          operator: eq\n          value: \"GB\"\n  response:\n    unauthorized:\n      message:\n        selector: \"The requested resource is not available in {auth.metadata.geoinfo.country_name}\"\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#obtain-a-token-and-consume-the-api","title":"\u277c Obtain a token and consume the API","text":""},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#obtain-an-access-token-and-consume-the-api-as-john-member","title":"Obtain an access token and consume the API as John (member)","text":"<p>Obtain an access token with the Keycloak server for John:</p> <p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster for the user John, a non-admin (member) user:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=john' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p> <p>As John, consume the API inside the area where the policy applies:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 79.123.45.67' \\\n     http://talker-api.127.0.0.1.nip.io:8000 -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As John, consume the API outside the area where the policy applies:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 109.69.200.56' \\\n     http://talker-api.127.0.0.1.nip.io:8000 -i\n# HTTP/1.1 403 Forbidden\n# x-ext-auth-reason: The requested resource is not available in Italy\n</code></pre> <p>As John, consume a path of the API that will cause Envoy to skip external authorization:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 109.69.200.56' \\\n     http://talker-api.127.0.0.1.nip.io:8000/global -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#obtain-an-access-token-and-consume-the-api-as-jane-admin","title":"Obtain an access token and consume the API as Jane (admin)","text":"<p>Obtain an access token with the Keycloak server for Jane, an admin user:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>As Jane, consume the API inside the area where the policy applies:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 79.123.45.67' \\\n     http://talker-api.127.0.0.1.nip.io:8000 -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As Jane, consume the API outside the area where the policy applies:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 109.69.200.56' \\\n     http://talker-api.127.0.0.1.nip.io:8000 -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As Jane, consume a path of the API that will cause Envoy to skip external authorization:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 109.69.200.56' \\\n     http://talker-api.127.0.0.1.nip.io:8000/global -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/envoy-jwt-authn-and-authorino/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete ingress/ingress-wildcard-host\nkubectl delete service/envoy\nkubectl delete deployment/envoy\nkubectl delete configmap/envoy\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/external-metadata/","title":"User guide: Fetching auth metadata from external sources","text":"<p>Get online data from remote HTTP services to enhance authorization rules.</p> Authorino capabilities featured in this guide: <ul> <li>External auth metadata \u2192 HTTP GET/GET-by-POST</li> <li>Identity verification &amp; authentication \u2192 API key</li> <li>Authorization \u2192 Open Policy Agent (OPA) Rego policies</li> </ul> <p>You can configure Authorino to fetch additional metadata from external sources in request-time, by sending either GET or POST request to an HTTP service. The service is expected to return a JSON content which is appended to the Authorization JSON, thus becoming available for usage in other configs of the Auth Pipeline, such as in authorization policies or custom responses.</p> <p>URL, parameters and headers of the request to the external source of metadata can be configured, including with dynamic values. Authentication between Authorino and the service can be set as part of these configuration options, or based on shared authentication token stored in a Kubernetes <code>Secret</code>.</p> <p>Check out as well the user guides about Authentication with API keys and Open Policy Agent (OPA) Rego policies.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/external-metadata/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/external-metadata/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/external-metadata/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/external-metadata/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/external-metadata/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/external-metadata/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>In this example, we will implement a geofence policy for the API, using OPA and metadata fetching from an external service that returns geolocalization JSON data for a given IP address. The policy establishes that only <code>GET</code> requests are allowed and the path of the request should be in the form <code>/{country-code}/*</code>, where <code>{country-code}</code> is the 2-character code of the country where the client is identified as being physically present.</p> <p>The implementation relies on the <code>X-Forwarded-For</code> HTTP header to read the client's IP address.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"friends\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: friends\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n  metadata:\n    \"geo\":\n      http:\n        url: 'http://ip-api.com/json/{context.request.http.headers.x-forwarded-for.@extract:{\"sep\":\",\"}}?fields=countryCode'\n        headers:\n          \"Accept\":\n            value: application/json\n  authorization:\n    \"geofence\":\n      opa:\n        rego: |\n          import input.context.request.http\n\n          allow {\n            http.method = \"GET\"\n            split(http.path, \"/\") = [_, requested_country, _]\n            lower(requested_country) == lower(object.get(input.auth.metadata.geo, \"countryCode\", \"\"))\n          }\nEOF\n</code></pre> <p>Check out the docs for information about the common feature JSON paths for reading from the Authorization JSON, including the description of the <code>@extract</code> string modifier.</p>"},{"location":"authorino/docs/user-guides/external-metadata/#create-an-api-key","title":"\u277b Create an API key","text":"<pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: friends\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/external-metadata/#consume-the-api","title":"\u277c Consume the API","text":"<p>From an IP address assigned to the United Kingdom of Great Britain and Northern Ireland (country code GB):</p> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' \\\n     -H 'X-Forwarded-For: 79.123.45.67' \\\n     http://talker-api.127.0.0.1.nip.io:8000/gb/hello -i\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' \\\n     -H 'X-Forwarded-For: 79.123.45.67' \\\n     http://talker-api.127.0.0.1.nip.io:8000/it/hello -i\n# HTTP/1.1 403 Forbidden\n</code></pre> <p>From an IP address assigned to Italy (country code IT):</p> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' \\\n     -H 'X-Forwarded-For: 109.112.34.56' \\\n     http://talker-api.127.0.0.1.nip.io:8000/gb/hello -i\n# HTTP/1.1 403 Forbidden\n</code></pre> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' \\\n     -H 'X-Forwarded-For: 109.112.34.56' \\\n     http://talker-api.127.0.0.1.nip.io:8000/it/hello -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/external-metadata/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/api-key-1\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/hello-world/","title":"User guide: Hello World","text":""},{"location":"authorino/docs/user-guides/hello-world/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant, you can skip step \u2778. You may already have Authorino installed and running as well. In this case, skip also step \u277a. If you even have your workload cluster configured, with sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, go straight to step \u277c.</p> <p>At step \u277c, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p>"},{"location":"authorino/docs/user-guides/hello-world/#create-the-namespace","title":"\u2776 Create the namespace","text":"<pre><code>kubectl create namespace hello-world\n# namespace/hello-world created\n</code></pre>"},{"location":"authorino/docs/user-guides/hello-world/#deploy-the-talker-api","title":"\u2777 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl -n hello-world apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n# deployment.apps/talker-api created\n# service/talker-api created\n</code></pre>"},{"location":"authorino/docs/user-guides/hello-world/#setup-envoy","title":"\u2778 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>1</sup></p> <pre><code>kubectl -n hello-world apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/hello-world/envoy-deploy.yaml\n# configmap/envoy created\n# deployment.apps/envoy created\n# service/envoy created\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl -n hello-world port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/hello-world/#consume-the-api-unprotected","title":"\u2779 Consume the API (unprotected)","text":"<pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/hello-world/#protect-the-api","title":"\u277a Protect the API","text":""},{"location":"authorino/docs/user-guides/hello-world/#install-the-authorino-operator","title":"Install the Authorino Operator","text":"<pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/hello-world/#deploy-authorino","title":"Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>2</sup> that watches for <code>AuthConfig</code> resources in the <code>hello-world</code> namespace<sup>3</sup>, with TLS disabled<sup>4</sup>.</p> <pre><code>kubectl -n hello-world apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/hello-world/authorino.yaml\n# authorino.operator.authorino.kuadrant.io/authorino created\n</code></pre>"},{"location":"authorino/docs/user-guides/hello-world/#consume-the-api-behind-envoy-and-authorino","title":"\u277b Consume the API behind Envoy and Authorino","text":"<pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 404 Not Found\n# x-ext-auth-reason: Service not found\n</code></pre> <p>Authorino does not know about the <code>talker-api.127.0.0.1.nip.io</code> host, hence the <code>404 Not Found</code>. Let's teach Authorino about this host by applying an <code>AuthConfig</code>.</p>"},{"location":"authorino/docs/user-guides/hello-world/#apply-the-authconfig","title":"\u277c Apply the <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl -n hello-world apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/hello-world/authconfig.yaml\n# authconfig.authorino.kuadrant.io/talker-api-protection created\n</code></pre>"},{"location":"authorino/docs/user-guides/hello-world/#consume-the-api-without-credentials","title":"\u277d Consume the API without credentials","text":"<pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: APIKEY realm=\"api-clients\"\n# x-ext-auth-reason: credential not found\n</code></pre>"},{"location":"authorino/docs/user-guides/hello-world/#grant-access-to-the-api-with-a-tailor-made-security-scheme","title":"Grant access to the API with a tailor-made security scheme","text":"<p>Check out other user guides for several use-cases of authentication and authorization, and the instructions to implement them using Authorino.</p> <p>A few examples of available ser guides:</p> <ul> <li>Authentication with API keys</li> <li>Authentication with JWTs and OpenID Connect Discovery</li> <li>Authentication with Kubernetes tokens (TokenReview API)</li> <li>Authorization with Open Policy Agent (OPA) Rego policies</li> <li>Authorization with simple JSON pattern-matching rules (e.g. JWT claims)</li> <li>Authorization with Kubernetes RBAC (SubjectAccessReview API)</li> <li>Fetching auth metadata from external sources</li> <li>Token normalization</li> </ul>"},{"location":"authorino/docs/user-guides/hello-world/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the namespaces created in step 1 and 5:</p> <pre><code>kubectl delete namespace hello-world\nkubectl delete namespace authorino-operator\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/host-override/","title":"Host override via context extension","text":"<p>By default, Authorino uses the host information of the HTTP request (<code>Attributes.Http.Host</code>) to lookup for an indexed AuthConfig to be enforced<sup>1</sup>. The host info be overridden by supplying a <code>host</code> entry as a (per-route) context extension (<code>Attributes.ContextExtensions</code>), which takes precedence whenever present.</p> <p>Overriding the host attribute of the HTTP request can be useful to support use cases such as of path prefix-based lookup and wildcard subdomains lookup.</p> \u26a0\ufe0f Important:         This feature may not be available to users of Authorino via Kuadrant.        <p></p> <p>In this guide:</p> <ul> <li>Example of host override for path prefix-based lookup</li> <li>Example of host override for wildcard subdomain lookup</li> </ul>"},{"location":"authorino/docs/user-guides/host-override/#example-of-host-override-for-path-prefix-based-lookup","title":"Example of host override for path prefix-based lookup","text":"<p>In this use case, 2 different APIs (i.e. Dogs API and Cats API) are served under the same base domain, and differentiated by the path prefix:</p> <ul> <li><code>pets.com/dogs</code> \u2192  Dogs API</li> <li><code>pets.com/cats</code> \u2192  Cats API</li> </ul> <p>Edit the Envoy config to extend the external authorization settings at the level of the routes, with the <code>host</code> value that will be favored by Authorino before the actual host attribute of the HTTP request:</p> <pre><code>virtual_hosts:\n\n- name: pets-api\n  domains: ['pets.com']\n  routes:\n  - match:\n      prefix: /dogs\n    route:\n      cluster: dogs-api\n    typed_per_filter_config:\n      envoy.filters.http.ext_authz:\n        \\\"@type\\\": type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute\n        check_settings:\n          context_extensions:\n            host: dogs.pets.com\n  - match:\n      prefix: /cats\n    route:\n      cluster: cats-api\n    typed_per_filter_config:\n      envoy.filters.http.ext_authz:\n        \\\"@type\\\": type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute\n        check_settings:\n          context_extensions:\n            host: cats.pets.com\n</code></pre> <p>Create the AuthConfig for the Pets API:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: dogs-api-protection\nspec:\n  hosts:\n\n  - dogs.pets.com\n\n  authentication: [...]\n</code></pre> <p>Create the AuthConfig for the Cats API:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: cats-api-protection\nspec:\n  hosts:\n\n  - cats.pets.com\n\n  authentication: [...]\n</code></pre> <p>Notice that the host subdomains <code>dogs.pets.com</code> and <code>cats.pets.com</code> are not really requested by the API consumers. Rather, users send requests to <code>pets.com/dogs</code> and <code>pets.com/cats</code>. When routing those requests, Envoy makes sure to inject the corresponding context extensions that will induce the right lookup in Authorino.</p>"},{"location":"authorino/docs/user-guides/host-override/#example-of-host-override-for-wildcard-subdomain-lookup","title":"Example of host override for wildcard subdomain lookup","text":"<p>In this use case, a single Pets API serves requests for any subdomain that matches <code>*.pets.com</code>, e.g.:</p> <ul> <li><code>dogs.pets.com</code> \u2192  Pets API</li> <li><code>cats.pets.com</code> \u2192  Pets API</li> </ul> <p>Edit the Envoy config to extend the external authorization settings at the level of the virtual host, with the <code>host</code> value that will be favored by Authorino before the actual host attribute of the HTTP request:</p> <pre><code>virtual_hosts:\n\n- name: pets-api\n  domains: ['*.pets.com']\n  typed_per_filter_config:\n    envoy.filters.http.ext_authz:\n      \\\"@type\\\": type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute\n      check_settings:\n        context_extensions:\n          host: pets.com\n  routes:\n  - match:\n      prefix: /\n    route:\n      cluster: pets-api\n</code></pre> <p>The <code>host</code> context extension used above is any key that matches one of the hosts listed in the targeted AuthConfig.</p> <p>Create the AuthConfig for the Pets API:</p> <pre><code>apiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: pets-api-protection\nspec:\n  hosts:\n\n  - pets.com\n\n  authentication: [...]\n</code></pre> <p>Notice that requests to <code>dogs.pets.com</code> and to <code>cats.pets.com</code> are all routed by Envoy to the same API, with same external authorization configuration. in all the cases, Authorino will lookup for the indexed AuthConfig associated with <code>pets.com</code>. The same is valid for a request sent, e.g., to <code>birds.pets.com</code>.</p> <ol> <li> <p>For further details about Authorino lookup of AuthConfig, check out Host lookup.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/http-basic-authentication/","title":"User guide: HTTP \"Basic\" Authentication (RFC 7235)","text":"<p>Turn Authorino API key <code>Secret</code>s settings into HTTP basic auth.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 API key</li> <li>Authorization \u2192 Pattern-matching authorization</li> </ul> <p>HTTP \"Basic\" Authentication (RFC 7235) is not recommended if you can afford other more secure methods such as OpenID Connect. To support legacy nonetheless it is sometimes necessary to implement it.</p> <p>In Authorino, HTTP \"Basic\" Authentication can be modeled leveraging the API key authentication feature (stored as Kubernetes <code>Secret</code>s with an <code>api_key</code> entry and labeled to match selectors specified in <code>spec.identity.apiKey.selector</code> of the <code>AuthConfig</code>).</p> <p>Check out as well the user guide about Authentication with API keys.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>The config uses API Key secrets to store base64-encoded <code>username:password</code> HTTP \"Basic\" authentication credentials. The config also specifies an Access Control List (ACL) by which only user <code>john</code> is authorized to consume the <code>/bye</code> endpoint of the API.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"http-basic-auth\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: users\n      credentials:\n        authorizationHeader:\n          prefix: Basic\n  authorization:\n    \"acl\":\n      when:\n      - selector: context.request.http.path\n        operator: eq\n        value: /bye\n      patternMatching:\n        patterns:\n        - selector: context.request.http.headers.authorization.@extract:{\"pos\":1}|@base64:decode|@extract:{\"sep\":\":\"}\n          operator: eq\n          value: john\nEOF\n</code></pre> <p>Check out the docs for information about the common feature JSON paths for reading from the Authorization JSON, including the description of the string modifiers <code>@extract</code> and <code>@case</code> used above. Check out as well the common feature Conditions about skipping parts of an <code>AuthConfig</code> in the auth pipeline based on context.</p>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#create-user-credentials","title":"\u277b Create user credentials","text":"<p>To create credentials for HTTP \"Basic\" Authentication, store each <code>username:password</code>, base64-encoded, in the <code>api_key</code> value of the Kubernetes <code>Secret</code> resources. E.g.:</p> <pre><code>printf \"john:ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\" | base64\n# am9objpuZHlCenJlVXpGNHpxRFFzcVNQTUhrUmhyaUVPdGNSeA==\n</code></pre> <p>Create credentials for user John:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: basic-auth-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: users\nstringData:\n  api_key: am9objpuZHlCenJlVXpGNHpxRFFzcVNQTUhrUmhyaUVPdGNSeA== # john:ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre> <p>Create credentials for user Jane:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: basic-auth-2\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: users\nstringData:\n  api_key: amFuZTpkTnNScnNhcHkwbk5Dd210NTM3ZkhGcHl4MGNCc0xFcA== # jane:dNsRrsapy0nNCwmt537fHFpyx0cBsLEp\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#consume-the-api","title":"\u277c Consume the API","text":"<p>As John (authorized in the ACL):</p> <pre><code>curl -u john:ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -u john:ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx http://talker-api.127.0.0.1.nip.io:8000/bye\n# HTTP/1.1 200 OK\n</code></pre> <p>As Jane (NOT authorized in the ACL):</p> <pre><code>curl -u jane:dNsRrsapy0nNCwmt537fHFpyx0cBsLEp http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -u jane:dNsRrsapy0nNCwmt537fHFpyx0cBsLEp http://talker-api.127.0.0.1.nip.io:8000/bye -i\n# HTTP/1.1 403 Forbidden\n</code></pre> <p>With an invalid user/password:</p> <pre><code>curl -u unknown:invalid http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Basic realm=\"http-basic-auth\"\n</code></pre>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#revoke-access-to-the-api","title":"\u277d Revoke access to the API","text":"<pre><code>kubectl delete secret/basic-auth-1\n</code></pre>"},{"location":"authorino/docs/user-guides/http-basic-authentication/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/basic-auth-1\nkubectl delete secret/basic-auth-2\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/injecting-data/","title":"User guide: Injecting data in the request","text":"<p>Inject HTTP headers with serialized JSON content.</p> Authorino capabilities featured in this guide: <ul> <li>Dynamic response \u2192 JSON injection</li> <li>Identity verification &amp; authentication \u2192 API key</li> </ul> <p>Inject serialized custom JSON objects as HTTP request headers. Values can be static or fetched from the Authorization JSON.</p> <p>Check out as well the user guide about Authentication with API keys.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/injecting-data/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/injecting-data/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/injecting-data/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/injecting-data/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/injecting-data/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/injecting-data/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>The following defines a JSON object to be injected as an added HTTP header into the request, named after the response config <code>x-ext-auth-data</code>. The object includes 3 properties:</p> <ol> <li>a static value <code>authorized: true</code>;</li> <li>a dynamic value <code>request-time</code>, from Envoy-supplied contextual data present in the Authorization JSON; and</li> <li>a greeting message <code>geeting-message</code> that interpolates a dynamic value read from an annotation of the Kubernetes <code>Secret</code> resource that represents the API key used to authenticate into a static string.</li> </ol> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"friends\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: friends\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n  response:\n    success:\n      headers:\n        \"x-ext-auth-data\":\n          json:\n            properties:\n              \"authorized\":\n                value: true\n              \"request-time\":\n                selector: context.request.time.seconds\n              \"greeting-message\":\n                selector: Hello, {auth.identity.metadata.annotations.auth-data\\/name}!\nEOF\n</code></pre> <p>Check out the docs for information about the common feature JSON paths for reading from the Authorization JSON.</p>"},{"location":"authorino/docs/user-guides/injecting-data/#create-an-api-key","title":"\u277b Create an API key","text":"<pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: friends\n  annotations:\n    auth-data/name: Rita\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/injecting-data/#consume-the-api","title":"\u277c Consume the API","text":"<pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' http://talker-api.127.0.0.1.nip.io:8000/hello\n# {\n#   \"method\": \"GET\",\n#   \"path\": \"/hello\",\n#   \"query_string\": null,\n#   \"body\": \"\",\n#   \"headers\": {\n#     \u2026\n#     \"X-Ext-Auth-Data\": \"{\\\"authorized\\\":true,\\\"greeting-message\\\":\\\"Hello, Rita!\\\",\\\"request-time\\\":1637954644}\",\n#   },\n#   \u2026\n# }\n</code></pre>"},{"location":"authorino/docs/user-guides/injecting-data/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/api-key-1\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/","title":"User guide: Simple pattern-matching authorization policies","text":"<p>Write simple authorization rules based on JSON patterns matched against Authorino's Authorization JSON; check contextual information of the request, validate JWT claims, cross metadata fetched from external sources, etc.</p> Authorino capabilities featured in this guide: <ul> <li>Authorization \u2192 Pattern-matching authorization</li> <li>Identity verification &amp; authentication \u2192 JWT verification</li> </ul> <p>Authorino provides a built-in authorization module to check simple pattern-matching rules against the Authorization JSON. This is an alternative to OPA when all you want is to check for some simple rules, without complex logics, such as match the value of a JWT claim.</p> <p>Check out as well the user guide about OpenID Connect Discovery and authentication with JWTs.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>The <code>email-verified-only</code> authorization policy ensures that users consuming the API from a given network (IP range 192.168.1/24) must have their emails verified.</p> <p>The <code>email_verified</code> claim is a property of the identity added to the JWT by the OpenID Connect issuer.</p> <p>The implementation relies on the <code>X-Forwarded-For</code> HTTP header to read the client's IP address.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"keycloak-kuadrant-realm\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n  authorization:\n    \"email-verified-only\":\n      when:\n      - selector: \"context.request.http.headers.x-forwarded-for.@extract:{\\\"sep\\\": \\\",\\\"}\"\n        operator: matches\n        value: 192\\\\.168\\\\.1\\\\.\\\\d+\n      patternMatching:\n        patterns:\n        - selector: auth.identity.email_verified\n          operator: eq\n          value: \"true\"\nEOF\n</code></pre> <p>Check out the docs for information about semantics and operators supported by the JSON pattern-matching authorization feature, as well the common feature JSON paths for reading from the Authorization JSON, including the description of the string modifier <code>@extract</code> used above. Check out as well the common feature Conditions about skipping parts of an <code>AuthConfig</code> in the auth pipeline based on context.</p>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#obtain-an-access-token-and-consume-the-api","title":"\u277b Obtain an access token and consume the API","text":""},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#obtain-an-access-token-and-consume-the-api-as-jane-email-verified","title":"Obtain an access token and consume the API as Jane (email verified)","text":"<p>Obtain an access token with the Keycloak server for Jane:</p> <p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster for the user Jane, whose e-mail has been verified:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p> <p>As Jane, consume the API outside the area where the policy applies:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 123.45.6.78' \\\n     http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>As Jane, consume the API inside the area where the policy applies:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 192.168.1.10' \\\n     http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#obtain-an-access-token-and-consume-the-api-as-peter-email-not-verified","title":"Obtain an access token and consume the API as Peter (email NOT verified)","text":"<p>Obtain an access token with the Keycloak server for Peter:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=peter' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>As Peter, consume the API outside the area where the policy applies:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 123.45.6.78' \\\n     http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>As Peter, consume the API inside the area where the policy applies:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n     -H 'X-Forwarded-For: 192.168.1.10' \\\n     http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 403 Forbidden\n# x-ext-auth-reason: Unauthorized\n</code></pre>"},{"location":"authorino/docs/user-guides/json-pattern-matching-authorization/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete namespace keycloak\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/","title":"User guide: Authorization with Keycloak Authorization Services","text":"<p>Keycloak provides a powerful set of tools (REST endpoints and administrative UIs), also known as Keycloak Authorization Services, to manage and enforce authorization, workflows for multiple access control mechanisms, including discretionary user access control and user-managed permissions.</p> <p>This user guide is an example of how to use Authorino as an adapter to Keycloak Authorization Services while still relying on the reverse-proxy integration pattern, thus not involving importing an authorization library nor rebuilding the application's code.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 JWT verification</li> <li>Authorization \u2192 Open Policy Agent (OPA) Rego policies</li> </ul> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Keycloak server</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p>Forward local requests to Keycloak running inside the cluster (if using Kind):</p> <pre><code>kubectl -n keycloak port-forward deployment/keycloak 8080:8080 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>In this example, Authorino will accept access tokens (JWTs) issued by the Keycloak server. These JWTs can be either normal Keycloak ID tokens or Requesting Party Tokens (RPT).</p> <p>RPTs include claims about the permissions of the user regarding protected resources and scopes associated with a Keycloak authorization client that the user can access.</p> <p>When the supplied access token is an RPT, Authorino will just validate whether the user's granted permissions present in the token include the requested resource ID (translated from the path) and scope (inferred from the HTTP method). If the token does not contain a <code>permissions</code> claim (i.e. it is not an RPT), Authorino will negotiate a User-Managed Access (UMA) ticket on behalf of the user and try to obtain an RPT on that UMA ticket.</p> <p>In cases of asynchronous user-managed permission control, the first request to the API using a normal Keycloak ID token is denied by Authorino. The user that owns the resource acknowledges the access request in the Keycloak UI. If access is granted, the new permissions will be reflected in subsequent RPTs obtained by Authorino on behalf of the requesting party.</p> <p>Whenever an RPT with proper permissions is obtained by Authorino, the RPT is supplied back to the API consumer, so it can be used in subsequent requests thus skipping new negotiations of UMA tickets.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"keycloak-kuadrant-realm\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n  authorization:\n    \"uma\":\n      opa:\n        rego: |\n          pat := http.send({\"url\":\"http://talker-api:523b92b6-625d-4e1e-a313-77e7a8ae4e88@keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token\",\"method\": \"post\",\"headers\":{\"Content-Type\":\"application/x-www-form-urlencoded\"},\"raw_body\":\"grant_type=client_credentials\"}).body.access_token\n          resource_id := http.send({\"url\":concat(\"\",[\"http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/authz/protection/resource_set?uri=\",input.context.request.http.path]),\"method\":\"get\",\"headers\":{\"Authorization\":concat(\" \",[\"Bearer \",pat])}}).body[0]\n          scope := lower(input.context.request.http.method)\n          access_token := trim_prefix(input.context.request.http.headers.authorization, \"Bearer \")\n\n          default rpt = \"\"\n          rpt = access_token { object.get(input.auth.identity, \"authorization\", {}).permissions }\n          else = rpt_str {\n            ticket := http.send({\"url\":\"http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/authz/protection/permission\",\"method\":\"post\",\"headers\":{\"Authorization\":concat(\" \",[\"Bearer \",pat]),\"Content-Type\":\"application/json\"},\"raw_body\":concat(\"\",[\"[{\\\"resource_id\\\":\\\"\",resource_id,\"\\\",\\\"resource_scopes\\\":[\\\"\",scope,\"\\\"]}]\"])}).body.ticket\n            rpt_str := object.get(http.send({\"url\":\"http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token\",\"method\":\"post\",\"headers\":{\"Authorization\":concat(\" \",[\"Bearer \",access_token]),\"Content-Type\":\"application/x-www-form-urlencoded\"},\"raw_body\":concat(\"\",[\"grant_type=urn:ietf:params:oauth:grant-type:uma-ticket&amp;ticket=\",ticket,\"&amp;submit_request=true\"])}).body, \"access_token\", \"\")\n          }\n\n          allow {\n            permissions := object.get(io.jwt.decode(rpt)[1], \"authorization\", { \"permissions\": [] }).permissions\n            permissions[i]\n            permissions[i].rsid = resource_id\n            permissions[i].scopes[_] = scope\n          }\n        allValues: true\n  response:\n    success:\n      headers:\n        \"x-keycloak\":\n          when:\n\n          - selector: auth.identity.authorization.permissions\n            operator: eq\n            value: \"\"\n          json:\n            properties:\n              \"rpt\":\n                selector: auth.authorization.uma.rpt\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#obtain-an-access-token-with-the-keycloak-server","title":"\u277b Obtain an access token with the Keycloak server","text":"<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster for user Jane:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#consume-the-api","title":"\u277c Consume the API","text":"<p>As Jane, try to send a <code>GET</code> request to the protected resource <code>/greetings/1</code>, owned by user John.</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/greetings/1 -i\n# HTTP/1.1 403 Forbidden\n</code></pre> <p>As John, log in to http://localhost:8080/realms/kuadrant/account in the web browser (username: <code>john</code> / password: <code>p</code>), and grant access to the resource <code>greeting-1</code> for Jane. A pending permission request by Jane shall exist in the list of John's Resources.</p> <p> </p> <p>As Jane, try to consume the protected resource <code>/greetings/1</code> again:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/greetings/1 -i\n# HTTP/1.1 200 OK\n#\n# {\u2026\n#   \"headers\": {\u2026\n#     \"X-Keycloak\": \"{\\\"rpt\\\":\\\"&lt;RPT&gt;\", \u2026\n</code></pre> <p>Copy the RPT from the response and repeat the request now using the RPT to authenticate:</p> <pre><code>curl -H \"Authorization: Bearer &lt;RPT&gt;\" http://talker-api.127.0.0.1.nip.io:8000/greetings/1 -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/keycloak-authorization-services/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/","title":"User guide: Kubernetes RBAC for service authorization (SubjectAccessReview API)","text":"<p>Manage permissions in the Kubernetes RBAC and let Authorino to check them in request-time with the authorization system of the cluster.</p> Authorino capabilities featured in this guide: <ul> <li>Authorization \u2192 Kubernetes SubjectAccessReview</li> <li>Identity verification &amp; authentication \u2192 Kubernetes TokenReview</li> </ul> <p>Authorino can delegate authorization decision to the Kubernetes authorization system, allowing permissions to be stored and managed using the Kubernetes Role-Based Access Control (RBAC) for example. The feature is based on the <code>SubjectAccessReview</code> API and can be used for <code>resourceAttributes</code> (parameters defined in the <code>AuthConfig</code>) or <code>nonResourceAttributes</code> (inferring HTTP path and verb from the original request).</p> <p>Check out as well the user guide about Authentication with Kubernetes tokens (TokenReview API).</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC) and to create <code>TokenRequest</code>s (to consume the protected service from outside the cluster)</li> <li>jq</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>The <code>AuthConfig</code> below sets all Kubernetes service accounts as trusted users of the API, and relies on the Kubernetes RBAC to enforce authorization using Kubernetes SubjectAccessReview API for non-resource endpoints:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  - envoy.default.svc.cluster.local\n  authentication:\n    \"service-accounts\":\n      kubernetesTokenReview:\n        audiences: [\"https://kubernetes.default.svc.cluster.local\"]\n  authorization:\n    \"k8s-rbac\":\n      kubernetesSubjectAccessReview:\n        user:\n          selector: auth.identity.user.username\nEOF\n</code></pre> <p>Check out the spec for the Authorino Kubernetes SubjectAccessReview authorization feature, for resource attributes permission checks where SubjectAccessReviews issued by Authorino are modeled in terms of common attributes of operations on Kubernetes resources (namespace, API group, kind, name, subresource, verb).</p>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#create-roles-associated-with-endpoints-of-the-api","title":"\u277b Create roles associated with endpoints of the API","text":"<p>Because the <code>k8s-rbac</code> policy defined in the <code>AuthConfig</code> in the previous step is for non-resource access review requests, the corresponding roles and role bindings have to be defined at cluster scope.</p> <p>Create a <code>talker-api-greeter</code> role whose users and service accounts bound to this role can consume the non-resource endpoints <code>POST /hello</code> and <code>POST /hi</code> of the API:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRole\nmetadata:\n  name: talker-api-greeter\nrules:\n\n- nonResourceURLs: [\"/hello\"]\n  verbs: [\"post\"]\n- nonResourceURLs: [\"/hi\"]\n  verbs: [\"post\"]\nEOF\n</code></pre> <p>Create a <code>talker-api-speaker</code> role whose users and service accounts bound to this role can consume the non-resource endpoints <code>POST /say/*</code> of the API:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRole\nmetadata:\n  name: talker-api-speaker\nrules:\n\n- nonResourceURLs: [\"/say/*\"]\n  verbs: [\"post\"]\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#create-the-serviceaccounts-and-permissions-to-consume-the-api","title":"\u277c Create the <code>ServiceAccount</code>s and permissions to consume the API","text":"<p>Create service accounts <code>api-consumer-1</code> and <code>api-consumer-2</code>:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: ServiceAccount\nmetadata:\n  name: api-consumer-1\nEOF\n</code></pre> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: ServiceAccount\nmetadata:\n  name: api-consumer-2\nEOF\n</code></pre> <p>Bind both service accounts to the <code>talker-api-greeter</code> role:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRoleBinding\nmetadata:\n  name: talker-api-greeter-rolebinding\nroleRef:\n  apiGroup: rbac.authorization.k8s.io\n  kind: ClusterRole\n  name: talker-api-greeter\nsubjects:\n\n- kind: ServiceAccount\n  name: api-consumer-1\n  namespace: default\n- kind: ServiceAccount\n  name: api-consumer-2\n  namespace: default\nEOF\n</code></pre> <p>Bind service account <code>api-consumer-1</code> to the <code>talker-api-speaker</code> role:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRoleBinding\nmetadata:\n  name: talker-api-speaker-rolebinding\nroleRef:\n  apiGroup: rbac.authorization.k8s.io\n  kind: ClusterRole\n  name: talker-api-speaker\nsubjects:\n\n- kind: ServiceAccount\n  name: api-consumer-1\n  namespace: default\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#consume-the-api","title":"\u277d Consume the API","text":"<p>Run a pod that consumes one of the greeting endpoints of the API from inside the cluster, as service account <code>api-consumer-1</code>, bound to the <code>talker-api-greeter</code> and <code>talker-api-speaker</code> cluster roles in the Kubernetes RBAC:</p> <pre><code>kubectl run greeter --attach --rm --restart=Never -q --image=quay.io/kuadrant/authorino-examples:api-consumer --overrides='{\n  \"apiVersion\": \"v1\",\n  \"spec\": {\n    \"containers\": [{\n      \"name\": \"api-consumer\", \"image\": \"quay.io/kuadrant/authorino-examples:api-consumer\", \"command\": [\"./run\"],\n      \"args\":[\"--endpoint=http://envoy.default.svc.cluster.local:8000/hi\",\"--method=POST\",\"--interval=0\",\"--token-path=/var/run/secrets/tokens/api-token\"],\n      \"volumeMounts\": [{\"mountPath\": \"/var/run/secrets/tokens\",\"name\": \"access-token\"}]\n    }],\n    \"serviceAccountName\": \"api-consumer-1\",\n    \"volumes\": [{\"name\": \"access-token\",\"projected\": {\"sources\": [{\"serviceAccountToken\": {\"path\": \"api-token\",\"expirationSeconds\": 7200}}]}}]\n  }\n}' -- sh\n# Sending...\n# 200\n</code></pre> <p>Run a pod that sends a <code>POST</code> request to <code>/say/blah</code> from within the cluster, as service account <code>api-consumer-1</code>:</p> <pre><code>kubectl run speaker --attach --rm --restart=Never -q --image=quay.io/kuadrant/authorino-examples:api-consumer --overrides='{\n  \"apiVersion\": \"v1\",\n  \"spec\": {\n    \"containers\": [{\n      \"name\": \"api-consumer\", \"image\": \"quay.io/kuadrant/authorino-examples:api-consumer\", \"command\": [\"./run\"],\n      \"args\":[\"--endpoint=http://envoy.default.svc.cluster.local:8000/say/blah\",\"--method=POST\",\"--interval=0\",\"--token-path=/var/run/secrets/tokens/api-token\"],\n      \"volumeMounts\": [{\"mountPath\": \"/var/run/secrets/tokens\",\"name\": \"access-token\"}]\n    }],\n    \"serviceAccountName\": \"api-consumer-1\",\n    \"volumes\": [{\"name\": \"access-token\",\"projected\": {\"sources\": [{\"serviceAccountToken\": {\"path\": \"api-token\",\"expirationSeconds\": 7200}}]}}]\n  }\n}' -- sh\n# Sending...\n# 200\n</code></pre> <p>Run a pod that sends a <code>POST</code> request to <code>/say/blah</code> from within the cluster, as service account <code>api-consumer-2</code>, bound only to the <code>talker-api-greeter</code> cluster role in the Kubernetes RBAC:</p> <pre><code>kubectl run speaker --attach --rm --restart=Never -q --image=quay.io/kuadrant/authorino-examples:api-consumer --overrides='{\n  \"apiVersion\": \"v1\",\n  \"spec\": {\n    \"containers\": [{\n      \"name\": \"api-consumer\", \"image\": \"quay.io/kuadrant/authorino-examples:api-consumer\", \"command\": [\"./run\"],\n      \"args\":[\"--endpoint=http://envoy.default.svc.cluster.local:8000/say/blah\",\"--method=POST\",\"--interval=0\",\"--token-path=/var/run/secrets/tokens/api-token\"],\n      \"volumeMounts\": [{\"mountPath\": \"/var/run/secrets/tokens\",\"name\": \"access-token\"}]\n    }],\n    \"serviceAccountName\": \"api-consumer-2\",\n    \"volumes\": [{\"name\": \"access-token\",\"projected\": {\"sources\": [{\"serviceAccountToken\": {\"path\": \"api-token\",\"expirationSeconds\": 7200}}]}}]\n  }\n}' -- sh\n# Sending...\n# 403\n</code></pre> Extra: consume the API as service account <code>api-consumer-2</code> from outside the cluster <p></p> <p>Obtain a short-lived access token for service account <code>api-consumer-2</code>, bound to the <code>talker-api-greeter</code> cluster role in the Kubernetes RBAC, using the Kubernetes TokenRequest API:</p> <pre><code>export ACCESS_TOKEN=$(echo '{ \"apiVersion\": \"authentication.k8s.io/v1\", \"kind\": \"TokenRequest\", \"spec\": { \"expirationSeconds\": 600 } }' | kubectl create --raw /api/v1/namespaces/default/serviceaccounts/api-consumer-2/token -f - | jq -r .status.token)\n</code></pre> <p>Consume the API as <code>api-consumer-2</code> from outside the cluster:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X POST http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X POST http://talker-api.127.0.0.1.nip.io:8000/say/something -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-subjectaccessreview/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete serviceaccount/api-consumer-1\nkubectl delete serviceaccount/api-consumer-2\nkubectl delete clusterrolebinding/talker-api-greeter-rolebinding\nkubectl delete clusterrolebinding/talker-api-speaker-rolebinding\nkubectl delete clusterrole/talker-api-greeter\nkubectl delete clusterrole/talker-api-speaker\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/","title":"User guide: Authentication with Kubernetes tokens (TokenReview API)","text":"<p>Validate Kubernetes Service Account tokens to authenticate requests to your protected hosts.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 Kubernetes TokenReview</li> </ul> <p>Authorino can verify Kubernetes-valid access tokens (using Kubernetes TokenReview API).</p> <p>These tokens can be either <code>ServiceAccount</code> tokens or any valid user access tokens issued to users of the Kubernetes server API.</p> <p>The <code>audiences</code> claim of the token must include the requested host and port of the protected API (default), or all audiences specified in <code>spec.identity.kubernetes.audiences</code> of the <code>AuthConfig</code>.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC) and to create <code>TokenRequest</code>s (to consume the protected service from outside the cluster)</li> <li>jq</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  - envoy.default.svc.cluster.local\n  authentication:\n    \"authorized-service-accounts\":\n      kubernetesTokenReview:\n        audiences:\n        - talker-api\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#consume-the-api-protected-by-authorino","title":"\u277b Consume the API protected by Authorino","text":""},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#create-a-serviceaccount","title":"Create a <code>ServiceAccount</code>","text":"<p>Create a Kubernetes <code>ServiceAccount</code> to identify the consumer application that will send requests to the protected API:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: ServiceAccount\nmetadata:\n  name: api-consumer-1\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#consume-the-api-from-outside-the-cluster","title":"Consume the API from outside the cluster","text":"<p>Obtain a short-lived access token for the <code>api-consumer-1</code> service account:</p> <pre><code>export ACCESS_TOKEN=$(echo '{ \"apiVersion\": \"authentication.k8s.io/v1\", \"kind\": \"TokenRequest\", \"spec\": { \"audiences\": [\"talker-api\"], \"expirationSeconds\": 600 } }' | kubectl create --raw /api/v1/namespaces/default/serviceaccounts/api-consumer-1/token -f - | jq -r .status.token)\n</code></pre> <p>Consume the API with a valid Kubernetes token:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre> <p>Consume the API with the Kubernetes token expired (10 minutes):</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Bearer realm=\"authorized-service-accounts\"\n# x-ext-auth-reason: Not authenticated\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#consume-the-api-from-inside-the-cluster","title":"Consume the API from inside the cluster","text":"<p>Deploy an application that consumes an endpoint of the Talker API, in a loop, every 10 seconds. The application uses a short-lived service account token mounted inside the container using Kubernetes Service Account Token Volume Projection to authenticate.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Pod\nmetadata:\n  name: api-consumer\nspec:\n  containers:\n\n  - name: api-consumer\n    image: quay.io/kuadrant/authorino-examples:api-consumer\n    command: [\"./run\"]\n    args:\n      - --endpoint=http://envoy.default.svc.cluster.local:8000/hello\n      - --token-path=/var/run/secrets/tokens/api-token\n      - --interval=10\n    volumeMounts:\n    - mountPath: /var/run/secrets/tokens\n      name: talker-api-access-token\n  serviceAccountName: api-consumer-1\n  volumes:\n  - name: talker-api-access-token\n    projected:\n      sources:\n      - serviceAccountToken:\n          path: api-token\n          expirationSeconds: 7200\n          audience: talker-api\nEOF\n</code></pre> <p>Check the logs of <code>api-consumer</code>:</p> <pre><code>kubectl logs -f api-consumer\n# Sending...\n# 200\n# 200\n# 200\n# 200\n# ...\n</code></pre>"},{"location":"authorino/docs/user-guides/kubernetes-tokenreview/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete pod/api-consumer\nkubectl delete serviceaccount/api-consumer-1\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/mtls-authentication/","title":"User guide: Authentication with X.509 certificates and Mutual Transport Layer Security (mTLS)","text":"<p>Verify client X.509 certificates against trusted root CAs stored in Kubernetes <code>Secret</code>s to authenticate access to APIs protected with Authorino.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 X.509 client certificate authentication</li> <li>Authorization \u2192 Pattern-matching authorization</li> </ul> <p>Authorino can verify x509 certificates presented by clients for authentication on the request to the protected APIs, at application level.</p> <p>Trusted root Certificate Authorities (CA) are stored as Kubernetes <code>kubernetes.io/tls</code> Secrets labeled according to selectors specified in the AuthConfig, watched and cached by Authorino.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/mtls-authentication/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277b.</p> <p>At step \u277b, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/mtls-authentication/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following commands will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS enabled<sup>3</sup>.</p> <p>Create the TLS certificates for the Authorino service:</p> <pre><code>curl -sSL https://raw.githubusercontent.com/Kuadrant/authorino/main/deploy/certs.yaml | sed \"s/\\$(AUTHORINO_INSTANCE)/authorino/g;s/\\$(NAMESPACE)/default/g\" | kubectl apply -f -\n</code></pre> <p>Request the Authorino instance:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      certSecretRef:\n        name: authorino-server-cert\n  oidcServer:\n    tls:\n      certSecretRef:\n        name: authorino-oidc-server-cert\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#create-a-ca","title":"\u2779 Create a CA","text":"<p>Create a CA (Certificate Authority) certificate to issue the client certificates that will be used to authenticate clients that send requests to the Talker API:</p> <pre><code>openssl req -x509 -sha512 -nodes \\\n  -days 365 \\\n  -newkey rsa:4096 \\\n  -subj \"/CN=talker-api-ca\" \\\n  -addext basicConstraints=CA:TRUE \\\n  -addext keyUsage=digitalSignature,keyCertSign \\\n  -keyout /tmp/ca.key \\\n  -out /tmp/ca.crt\n</code></pre> <p>Store the CA cert in a Kubernetes <code>Secret</code>, labeled to be discovered by Authorino and to be mounted in the file system of the Envoy container:</p> <pre><code>kubectl create secret tls talker-api-ca --cert=/tmp/ca.crt --key=/tmp/ca.key\nkubectl label secret talker-api-ca authorino.kuadrant.io/managed-by=authorino app=talker-api\n</code></pre> <p>Prepare an extension file for the client certificate signing requests:</p> <pre><code>cat &gt; /tmp/x509v3.ext &lt;&lt; EOF\nauthorityKeyIdentifier=keyid,issuer\nbasicConstraints=CA:FALSE\nkeyUsage=digitalSignature,nonRepudiation,keyEncipherment,dataEncipherment\nextendedKeyUsage=clientAuth\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#setup-envoy","title":"\u277a Setup Envoy","text":"<p>The following command deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: ConfigMap\nmetadata:\n  labels:\n    app: envoy\n  name: envoy\ndata:\n  envoy.yaml: |\n    static_resources:\n      listeners:\n\n      - address:\n          socket_address:\n            address: 0.0.0.0\n            port_value: 8443\n        filter_chains:\n        - transport_socket:\n            name: envoy.transport_sockets.tls\n            typed_config:\n              \"@type\": type.googleapis.com/envoy.extensions.transport_sockets.tls.v3.DownstreamTlsContext\n              common_tls_context:\n                tls_certificates:\n                - certificate_chain: {filename: \"/etc/ssl/certs/talker-api/tls.crt\"}\n                  private_key: {filename: \"/etc/ssl/certs/talker-api/tls.key\"}\n                validation_context:\n                  trusted_ca:\n                    filename: /etc/ssl/certs/talker-api/tls.crt\n          filters:\n          - name: envoy.http_connection_manager\n            typed_config:\n              \"@type\": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager\n              stat_prefix: local\n              route_config:\n                name: local_route\n                virtual_hosts:\n                - name: local_service\n                  domains: ['*']\n                  routes:\n                  - match: { prefix: / }\n                    route: { cluster: talker-api }\n              http_filters:\n              - name: envoy.filters.http.ext_authz\n                typed_config:\n                  \"@type\": type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthz\n                  transport_api_version: V3\n                  failure_mode_allow: false\n                  include_peer_certificate: true\n                  grpc_service:\n                    envoy_grpc: { cluster_name: authorino }\n                    timeout: 1s\n              - name: envoy.filters.http.router\n                typed_config: {}\n              use_remote_address: true\n      clusters:\n      - name: authorino\n        connect_timeout: 0.25s\n        type: strict_dns\n        lb_policy: round_robin\n        http2_protocol_options: {}\n        load_assignment:\n          cluster_name: authorino\n          endpoints:\n          - lb_endpoints:\n            - endpoint:\n                address:\n                  socket_address:\n                    address: authorino-authorino-authorization\n                    port_value: 50051\n        transport_socket:\n          name: envoy.transport_sockets.tls\n          typed_config:\n            \"@type\": type.googleapis.com/envoy.extensions.transport_sockets.tls.v3.UpstreamTlsContext\n            common_tls_context:\n              validation_context:\n                trusted_ca:\n                  filename: /etc/ssl/certs/authorino-ca-cert.crt\n      - name: talker-api\n        connect_timeout: 0.25s\n        type: strict_dns\n        lb_policy: round_robin\n        load_assignment:\n          cluster_name: talker-api\n          endpoints:\n          - lb_endpoints:\n            - endpoint:\n                address:\n                  socket_address:\n                    address: talker-api\n                    port_value: 3000\n    admin:\n      access_log_path: \"/tmp/admin_access.log\"\n      address:\n        socket_address:\n          address: 0.0.0.0\n          port_value: 8001\n---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n  labels:\n    app: envoy\n  name: envoy\nspec:\n  selector:\n    matchLabels:\n      app: envoy\n  template:\n    metadata:\n      labels:\n        app: envoy\n    spec:\n      containers:\n      - args:\n        - --config-path /usr/local/etc/envoy/envoy.yaml\n        - --service-cluster front-proxy\n        - --log-level info\n        - --component-log-level filter:trace,http:debug,router:debug\n        command:\n        - /usr/local/bin/envoy\n        image: envoyproxy/envoy:v1.19-latest\n        name: envoy\n        ports:\n        - containerPort: 8443\n          name: web\n        - containerPort: 8001\n          name: admin\n        volumeMounts:\n        - mountPath: /usr/local/etc/envoy\n          name: config\n          readOnly: true\n        - mountPath: /etc/ssl/certs/authorino-ca-cert.crt\n          name: authorino-ca-cert\n          readOnly: true\n          subPath: ca.crt\n        - mountPath: /etc/ssl/certs/talker-api\n          name: talker-api-ca\n          readOnly: true\n      volumes:\n      - configMap:\n          items:\n          - key: envoy.yaml\n            path: envoy.yaml\n          name: envoy\n        name: config\n      - name: authorino-ca-cert\n        secret:\n          defaultMode: 420\n          secretName: authorino-ca-cert\n      - name: talker-api-ca\n        secret:\n          defaultMode: 420\n          secretName: talker-api-ca\n---\napiVersion: v1\nkind: Service\nmetadata:\n  name: envoy\nspec:\n  selector:\n    app: envoy\n  ports:\n  - name: web\n    port: 8443\n    protocol: TCP\n---\napiVersion: networking.k8s.io/v1\nkind: Ingress\nmetadata:\n  name: ingress-wildcard-host\nspec:\n  rules:\n  - host: talker-api.127.0.0.1.nip.io\n    http:\n      paths:\n      - backend:\n          service:\n            name: envoy\n            port: { number: 8443 }\n        path: /\n        pathType: Prefix\nEOF\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8443 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8443:8443 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#create-the-authconfig","title":"\u277b Create the <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"mtls\":\n      x509:\n        selector:\n          matchLabels:\n            app: talker-api\n  authorization:\n    \"acme\":\n      patternMatching:\n        patterns:\n        - selector: auth.identity.Organization\n          operator: incl\n          value: ACME Inc.\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#consume-the-api","title":"\u277c Consume the API","text":"<p>With a TLS certificate signed by the trusted CA:</p> <pre><code>openssl genrsa -out /tmp/aisha.key 4096\nopenssl req -new -subj \"/CN=aisha/C=PK/L=Islamabad/O=ACME Inc./OU=Engineering\" -key /tmp/aisha.key -out /tmp/aisha.csr\nopenssl x509 -req -sha512 -days 1 -CA /tmp/ca.crt -CAkey /tmp/ca.key -CAcreateserial -extfile /tmp/x509v3.ext -in /tmp/aisha.csr -out /tmp/aisha.crt\n\ncurl -k --cert /tmp/aisha.crt --key /tmp/aisha.key https://talker-api.127.0.0.1.nip.io:8443 -i\n# HTTP/1.1 200 OK\n</code></pre> <p>With a TLS certificate signed by the trusted CA, though missing an authorized Organization:</p> <pre><code>openssl genrsa -out /tmp/john.key 4096\nopenssl req -new -subj \"/CN=john/C=UK/L=London\" -key /tmp/john.key -out /tmp/john.csr\nopenssl x509 -req -sha512 -days 1 -CA /tmp/ca.crt -CAkey /tmp/ca.key -CAcreateserial -extfile /tmp/x509v3.ext -in /tmp/john.csr -out /tmp/john.crt\n\ncurl -k --cert /tmp/john.crt --key /tmp/john.key https://talker-api.127.0.0.1.nip.io:8443 -i\n# HTTP/1.1 403 Forbidden\n# x-ext-auth-reason: Unauthorized\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#try-the-authconfig-via-raw-http-authorization-interface","title":"\u277d Try the AuthConfig via raw HTTP authorization interface","text":"<p>Expose Authorino's raw HTTP authorization to the local host:</p> <pre><code>kubectl port-forward service/authorino-authorino-authorization 5001:5001 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre> <p>With a TLS certificate signed by the trusted CA:</p> <pre><code>curl -k --cert /tmp/aisha.crt --key /tmp/aisha.key -H 'Content-Type: application/json' -d '{}' https://talker-api.127.0.0.1.nip.io:5001/check -i\n# HTTP/2 200\n</code></pre> <p>With a TLS certificate signed by an unknown authority:</p> <pre><code>openssl req -x509 -sha512 -nodes \\\n  -days 365 \\\n  -newkey rsa:4096 \\\n  -subj \"/CN=untrusted\" \\\n  -addext basicConstraints=CA:TRUE \\\n  -addext keyUsage=digitalSignature,keyCertSign \\\n  -keyout /tmp/untrusted-ca.key \\\n  -out /tmp/untrusted-ca.crt\n\nopenssl genrsa -out /tmp/niko.key 4096\nopenssl req -new -subj \"/CN=niko/C=JP/L=Osaka\" -key /tmp/niko.key -out /tmp/niko.csr\nopenssl x509 -req -sha512 -days 1 -CA /tmp/untrusted-ca.crt -CAkey /tmp/untrusted-ca.key -CAcreateserial -extfile /tmp/x509v3.ext -in /tmp/niko.csr -out /tmp/niko.crt\n\ncurl -k --cert /tmp/niko.crt --key /tmp/niko.key -H 'Content-Type: application/json' -d '{}' https://talker-api.127.0.0.1.nip.io:5001/check -i\n# HTTP/2 401\n# www-authenticate: Basic realm=\"mtls\"\n# x-ext-auth-reason: x509: certificate signed by unknown authority\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#revoke-an-entire-chain-of-certificates","title":"\u277e Revoke an entire chain of certificates","text":"<pre><code>kubectl delete secret/talker-api-ca\n</code></pre> <p>Even if the deleted root certificate is still cached and accepted at the gateway, Authorino will revoke access at application level immediately.</p> <p>Try with a previously accepted certificate:</p> <pre><code>curl -k --cert /tmp/aisha.crt --key /tmp/aisha.key https://talker-api.127.0.0.1.nip.io:8443 -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Basic realm=\"mtls\"\n# x-ext-auth-reason: x509: certificate signed by unknown authority\n</code></pre>"},{"location":"authorino/docs/user-guides/mtls-authentication/#cleanup","title":"Cleanup","text":"<pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/","title":"User guide: OAuth 2.0 token introspection (RFC 7662)","text":"<p>Introspect OAuth 2.0 access tokens (e.g. opaque tokens) for online user data and token validation in request-time.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 OAuth 2.0 introspection</li> <li>Authorization \u2192 Pattern-matching authorization</li> </ul> <p>Authorino can perform OAuth 2.0 token introspection (RFC 7662) on the access tokens supplied in the requests to protected APIs. This is particularly useful when using opaque tokens, for remote checking the token validity and resolving the identity object.</p> <p>Important! Authorino does not implement OAuth2 grants nor OIDC authentication flows. As a common recommendation of good practice, obtaining and refreshing access tokens is for clients to negotiate directly with the auth servers and token issuers. Authorino will only validate those tokens using the parameters provided by the trusted issuer authorities.</p> <p>Check out as well the user guides about OpenID Connect Discovery and authentication with JWTs and Simple pattern-matching authorization policies.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>OAuth 2.0 server that implements the token introspection endpoint (RFC 7662) (e.g. Keycloak or a12n-server)</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy a Keycloak server preloaded with the realm settings required for this guide:</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p>Deploy an a12n-server server preloaded with all settings required for this guide:</p> <pre><code>kubectl create namespace a12n-server\nkubectl -n a12n-server apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/a12n-server/a12n-server-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create the required secrets that will be used by Authorino to authenticate with Keycloak and a12n-server during the introspection request:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: oauth2-token-introspection-credentials-keycloak\nstringData:\n  clientID: talker-api\n  clientSecret: 523b92b6-625d-4e1e-a313-77e7a8ae4e88\ntype: Opaque\n---\napiVersion: v1\nkind: Secret\nmetadata:\n  name: oauth2-token-introspection-credentials-a12n-server\nstringData:\n  clientID: talker-api\n  clientSecret: V6g-2Eq2ALB1_WHAswzoeZofJ_e86RI4tdjClDDDb4g\ntype: Opaque\nEOF\n</code></pre> <p>Create the Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"keycloak\":\n      oauth2Introspection:\n        endpoint: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token/introspect\n        tokenTypeHint: requesting_party_token\n        credentialsRef:\n          name: oauth2-token-introspection-credentials-keycloak\n    \"a12n-server\":\n      oauth2Introspection:\n        endpoint: http://a12n-server.a12n-server.svc.cluster.local:8531/introspect\n        credentialsRef:\n          name: oauth2-token-introspection-credentials-a12n-server\n  authorization:\n    \"can-read\":\n      when:\n      - selector: auth.identity.privileges\n        operator: neq\n        value: \"\"\n      patternMatching:\n        patterns:\n        - selector: auth.identity.privileges.talker-api\n          operator: incl\n          value: read\nEOF\n</code></pre> <p>On every request, Authorino will try to verify the token remotely with the Keycloak server and the a12n-server server.</p> <p>For authorization, whenever the introspected token data includes a <code>privileges</code> property (returned by a12n-server), Authorino will enforce only consumers whose <code>privileges.talker-api</code> includes the <code>\"read\"</code> permission are granted access.</p> <p>Check out the docs for information about the common feature Conditions about skipping parts of an <code>AuthConfig</code> in the auth pipeline based on context.</p>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#obtain-an-access-token-and-consume-the-api","title":"\u277b Obtain an access token and consume the API","text":""},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#obtain-an-access-token-with-keycloak-and-consume-the-api","title":"Obtain an access token with Keycloak and consume the API","text":"<p>Obtain an access token with the Keycloak server for user Jane:</p> <p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster for the user Jane, whose e-mail has been verified:</p> <pre><code>export $(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r '\"ACCESS_TOKEN=\"+.access_token,\"REFRESH_TOKEN=\"+.refresh_token')\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p> <p>As user Jane, consume the API:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>Revoke the access token and try to consume the API again:</p> <pre><code>kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/logout -H \"Content-Type: application/x-www-form-urlencoded\" -d \"refresh_token=$REFRESH_TOKEN\" -d 'token_type_hint=requesting_party_token' -u demo:\n</code></pre> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Bearer realm=\"keycloak\"\n# www-authenticate: Bearer realm=\"a12n-server\"\n# x-ext-auth-reason: {\"a12n-server\":\"token is not active\",\"keycloak\":\"token is not active\"}\n</code></pre>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#obtain-an-access-token-with-a12n-server-and-consume-the-api","title":"Obtain an access token with a12n-server and consume the API","text":"<p>Forward local requests to a12n-server instance running in the cluster:</p> <pre><code>kubectl -n a12n-server port-forward deployment/a12n-server 8531:8531 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre> <p>Obtain an access token with the a12n-server server for service account <code>service-account-1</code>:</p> <pre><code>ACCESS_TOKEN=$(curl -d 'grant_type=client_credentials' -u service-account-1:FO6LgoMKA8TBDDHgSXZ5-iq1wKNwqdDkyeEGIl6gp0s \"http://localhost:8531/token\" | jq -r .access_token)\n</code></pre> <p>You can as well obtain an access token from within the cluster, in case your a12n-server is not reachable from the outside:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://a12n-server.a12n-server.svc.cluster.local:8531/token -s -d 'grant_type=client_credentials' -u service-account-1:FO6LgoMKA8TBDDHgSXZ5-iq1wKNwqdDkyeEGIl6gp0s | jq -r .access_token)\n</code></pre> <p>Verify the issued token is an opaque access token in this case:</p> <pre><code>echo $ACCESS_TOKEN\n</code></pre> <p>As <code>service-account-1</code>, consumer the API with a valid access token:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>Revoke the access token and try to consume the API again:</p> <pre><code>curl -d \"token=$ACCESS_TOKEN\" -u service-account-1:FO6LgoMKA8TBDDHgSXZ5-iq1wKNwqdDkyeEGIl6gp0s \"http://localhost:8531/revoke\" -i\n</code></pre> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Bearer realm=\"keycloak\"\n# www-authenticate: Bearer realm=\"a12n-server\"\n# x-ext-auth-reason: {\"a12n-server\":\"token is not active\",\"keycloak\":\"token is not active\"}\n</code></pre>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#consume-the-api-with-a-missing-or-invalid-access-token","title":"Consume the API with a missing or invalid access token","text":"<pre><code>curl -H \"Authorization: Bearer invalid\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Bearer realm=\"keycloak\"\n# www-authenticate: Bearer realm=\"a12n-server\"\n# x-ext-auth-reason: {\"a12n-server\":\"token is not active\",\"keycloak\":\"token is not active\"}\n</code></pre>"},{"location":"authorino/docs/user-guides/oauth2-token-introspection/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete secret/oauth2-token-introspection-credentials-keycloak\nkubectl delete secret/oauth2-token-introspection-credentials-a12n-server\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace keycloak\nkubectl delete namespace a12n-server\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/observability/","title":"Observability","text":""},{"location":"authorino/docs/user-guides/observability/#metrics","title":"Metrics","text":"<p>Authorino exports metrics at 2 endpoints:</p> /metrics Metrics of the controller-runtime about reconciliation (caching) of AuthConfigs and API key Secrets /server-metrics Metrics of the external authorization gRPC and OIDC/Festival Wristband validation built-in HTTP servers <p>The Authorino Operator creates a Kubernetes <code>Service</code> named <code>&lt;authorino-cr-name&gt;-controller-metrics</code> that exposes the endpoints on port 8080. The Authorino instance allows to modify the port number of the metrics endpoints, by setting the <code>--metrics-addr</code> command-line flag (default: <code>:8080</code>).</p> <p>Main metrics exported by endpoint<sup>1</sup>:</p> Endpoint: <code>/metrics</code> Metric name Description\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Labels Type controller_runtime_reconcile_total Total number of reconciliations per controller <code>controller=authconfig|secret</code>, <code>result=success|error|requeue</code> counter controller_runtime_reconcile_errors_total Total number of reconciliation errors per controller <code>controller=authconfig|secret</code> counter controller_runtime_reconcile_time_seconds Length of time per reconciliation per controller <code>controller=authconfig|secret</code> histogram controller_runtime_max_concurrent_reconciles Maximum number of concurrent reconciles per controller <code>controller=authconfig|secret</code> gauge workqueue_adds_total Total number of adds handled by workqueue <code>name=authconfig|secret</code> counter workqueue_depth Current depth of workqueue <code>name=authconfig|secret</code> gauge workqueue_queue_duration_seconds How long in seconds an item stays in workqueue before being requested <code>name=authconfig|secret</code> histogram workqueue_longest_running_processor_seconds How many seconds has the longest running processor for workqueue been running. <code>name=authconfig|secret</code> gauge workqueue_retries_total Total number of retries handled by workqueue <code>name=authconfig|secret</code> counter workqueue_unfinished_work_seconds How many seconds of work has been done that is in progress and hasn't been observed by work_duration. <code>name=authconfig|secret</code> gauge workqueue_work_duration_seconds How long in seconds processing an item from workqueue takes. <code>name=authconfig|secret</code> histogram rest_client_requests_total Number of HTTP requests, partitioned by status code, method, and host. <code>code=200|404</code>, <code>method=GET|PUT|POST</code> counter Endpoint: <code>/server-metrics</code> Metric name Description Labels Type auth_server_evaluator_total<sup>2</sup> Total number of evaluations of individual authconfig rule performed by the auth server. <code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code> counter auth_server_evaluator_cancelled<sup>2</sup> Number of evaluations of individual authconfig rule cancelled by the auth server. <code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code> counter auth_server_evaluator_ignored<sup>2</sup> Number of evaluations of individual authconfig rule ignored by the auth server. <code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code> counter auth_server_evaluator_denied<sup>2</sup> Number of denials from individual authconfig rule evaluated by the auth server. <code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code> counter auth_server_evaluator_duration_seconds<sup>2</sup> Response latency of individual authconfig rule evaluated by the auth server (in seconds). <code>namespace</code>, <code>authconfig</code>, <code>evaluator_type</code>, <code>evaluator_name</code> histogram auth_server_authconfig_total Total number of authconfigs enforced by the auth server, partitioned by authconfig. <code>namespace</code>, <code>authconfig</code> counter auth_server_authconfig_response_status Response status of authconfigs sent by the auth server, partitioned by authconfig. <code>namespace</code>, <code>authconfig</code>, <code>status=OK|UNAUTHENTICATED,PERMISSION_DENIED</code> counter auth_server_authconfig_duration_seconds Response latency of authconfig enforced by the auth server (in seconds). <code>namespace</code>, <code>authconfig</code> histogram auth_server_response_status Response status of authconfigs sent by the auth server. <code>status=OK|UNAUTHENTICATED,PERMISSION_DENIED|NOT_FOUND</code> counter grpc_server_handled_total Total number of RPCs completed on the server, regardless of success or failure. <code>grpc_code=OK|Aborted|Canceled|DeadlineExceeded|Internal|ResourceExhausted|Unknown</code>, <code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code> counter grpc_server_handling_seconds Response latency (seconds) of gRPC that had been application-level handled by the server. <code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code> histogram grpc_server_msg_received_total Total number of RPC stream messages received on the server. <code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code> counter grpc_server_msg_sent_total Total number of gRPC stream messages sent by the server. <code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code> counter grpc_server_started_total Total number of RPCs started on the server. <code>grpc_method=Check</code>, <code>grpc_service=envoy.service.auth.v3.Authorization</code> counter http_server_handled_total Total number of calls completed on the raw HTTP authorization server, regardless of success or failure. <code>http_code</code> counter http_server_handling_seconds Response latency (seconds) of raw HTTP authorization request that had been application-level handled by the server. histogram oidc_server_requests_total Number of get requests received on the OIDC (Festival Wristband) server. <code>namespace</code>, <code>authconfig</code>, <code>wristband</code>, <code>path=oidc-config|jwks</code> counter oidc_server_response_status Status of HTTP response sent by the OIDC (Festival Wristband) server. <code>status=200|404</code> counter <p><sup>1</sup> Both endpoints export metrics about the Go runtime, such as number of goroutines (go_goroutines) and threads (go_threads), usage of CPU, memory and GC stats.</p> <p><sup>2</sup> Opt-in metrics: <code>auth_server_evaluator_*</code> metrics require <code>authconfig.spec.(identity|metadata|authorization|response).metrics: true</code> (default: <code>false</code>). This can be enforced for the entire instance (all AuthConfigs and evaluators), by setting the <code>--deep-metrics-enabled</code> command-line flag in the Authorino deployment.</p> Example of metrics exported at the <code>/metrics</code> endpoint <pre><code># HELP controller_runtime_active_workers Number of currently used workers per controller\n# TYPE controller_runtime_active_workers gauge\ncontroller_runtime_active_workers{controller=\"authconfig\"} 0\ncontroller_runtime_active_workers{controller=\"secret\"} 0\n# HELP controller_runtime_max_concurrent_reconciles Maximum number of concurrent reconciles per controller\n# TYPE controller_runtime_max_concurrent_reconciles gauge\ncontroller_runtime_max_concurrent_reconciles{controller=\"authconfig\"} 1\ncontroller_runtime_max_concurrent_reconciles{controller=\"secret\"} 1\n# HELP controller_runtime_reconcile_errors_total Total number of reconciliation errors per controller\n# TYPE controller_runtime_reconcile_errors_total counter\ncontroller_runtime_reconcile_errors_total{controller=\"authconfig\"} 12\ncontroller_runtime_reconcile_errors_total{controller=\"secret\"} 0\n# HELP controller_runtime_reconcile_time_seconds Length of time per reconciliation per controller\n# TYPE controller_runtime_reconcile_time_seconds histogram\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.005\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.01\"} 11\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.025\"} 17\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.05\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.1\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.15\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.2\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.25\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.3\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.35\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.4\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.45\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.5\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.6\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.7\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.8\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"0.9\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"1\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"1.25\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"1.5\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"1.75\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"2\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"2.5\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"3\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"3.5\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"4\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"4.5\"} 18\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"5\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"6\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"7\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"8\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"9\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"10\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"15\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"20\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"25\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"30\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"40\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"50\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"60\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"authconfig\",le=\"+Inf\"} 19\ncontroller_runtime_reconcile_time_seconds_sum{controller=\"authconfig\"} 5.171108321999999\ncontroller_runtime_reconcile_time_seconds_count{controller=\"authconfig\"} 19\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.005\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.01\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.025\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.05\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.1\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.15\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.2\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.25\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.3\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.35\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.4\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.45\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.5\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.6\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.7\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.8\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"0.9\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"1\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"1.25\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"1.5\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"1.75\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"2\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"2.5\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"3\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"3.5\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"4\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"4.5\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"5\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"6\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"7\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"8\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"9\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"10\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"15\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"20\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"25\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"30\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"40\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"50\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"60\"} 1\ncontroller_runtime_reconcile_time_seconds_bucket{controller=\"secret\",le=\"+Inf\"} 1\ncontroller_runtime_reconcile_time_seconds_sum{controller=\"secret\"} 0.000138025\ncontroller_runtime_reconcile_time_seconds_count{controller=\"secret\"} 1\n# HELP controller_runtime_reconcile_total Total number of reconciliations per controller\n# TYPE controller_runtime_reconcile_total counter\ncontroller_runtime_reconcile_total{controller=\"authconfig\",result=\"error\"} 12\ncontroller_runtime_reconcile_total{controller=\"authconfig\",result=\"requeue\"} 0\ncontroller_runtime_reconcile_total{controller=\"authconfig\",result=\"requeue_after\"} 0\ncontroller_runtime_reconcile_total{controller=\"authconfig\",result=\"success\"} 7\ncontroller_runtime_reconcile_total{controller=\"secret\",result=\"error\"} 0\ncontroller_runtime_reconcile_total{controller=\"secret\",result=\"requeue\"} 0\ncontroller_runtime_reconcile_total{controller=\"secret\",result=\"requeue_after\"} 0\ncontroller_runtime_reconcile_total{controller=\"secret\",result=\"success\"} 1\n# HELP go_gc_cycles_automatic_gc_cycles_total Count of completed GC cycles generated by the Go runtime.\n# TYPE go_gc_cycles_automatic_gc_cycles_total counter\ngo_gc_cycles_automatic_gc_cycles_total 13\n# HELP go_gc_cycles_forced_gc_cycles_total Count of completed GC cycles forced by the application.\n# TYPE go_gc_cycles_forced_gc_cycles_total counter\ngo_gc_cycles_forced_gc_cycles_total 0\n# HELP go_gc_cycles_total_gc_cycles_total Count of all completed GC cycles.\n# TYPE go_gc_cycles_total_gc_cycles_total counter\ngo_gc_cycles_total_gc_cycles_total 13\n# HELP go_gc_duration_seconds A summary of the pause duration of garbage collection cycles.\n# TYPE go_gc_duration_seconds summary\ngo_gc_duration_seconds{quantile=\"0\"} 4.5971e-05\ngo_gc_duration_seconds{quantile=\"0.25\"} 5.69e-05\ngo_gc_duration_seconds{quantile=\"0.5\"} 0.000140699\ngo_gc_duration_seconds{quantile=\"0.75\"} 0.000313162\ngo_gc_duration_seconds{quantile=\"1\"} 0.001692423\ngo_gc_duration_seconds_sum 0.003671076\ngo_gc_duration_seconds_count 13\n# HELP go_gc_heap_allocs_by_size_bytes_total Distribution of heap allocations by approximate size. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.\n# TYPE go_gc_heap_allocs_by_size_bytes_total histogram\ngo_gc_heap_allocs_by_size_bytes_total_bucket{le=\"8.999999999999998\"} 6357\ngo_gc_heap_allocs_by_size_bytes_total_bucket{le=\"16.999999999999996\"} 45065\n[...]\ngo_gc_heap_allocs_by_size_bytes_total_bucket{le=\"32768.99999999999\"} 128306\ngo_gc_heap_allocs_by_size_bytes_total_bucket{le=\"+Inf\"} 128327\ngo_gc_heap_allocs_by_size_bytes_total_sum 1.5021512e+07\ngo_gc_heap_allocs_by_size_bytes_total_count 128327\n# HELP go_gc_heap_allocs_bytes_total Cumulative sum of memory allocated to the heap by the application.\n# TYPE go_gc_heap_allocs_bytes_total counter\ngo_gc_heap_allocs_bytes_total 1.5021512e+07\n# HELP go_gc_heap_allocs_objects_total Cumulative count of heap allocations triggered by the application. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.\n# TYPE go_gc_heap_allocs_objects_total counter\ngo_gc_heap_allocs_objects_total 128327\n# HELP go_gc_heap_frees_by_size_bytes_total Distribution of freed heap allocations by approximate size. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.\n# TYPE go_gc_heap_frees_by_size_bytes_total histogram\ngo_gc_heap_frees_by_size_bytes_total_bucket{le=\"8.999999999999998\"} 3885\ngo_gc_heap_frees_by_size_bytes_total_bucket{le=\"16.999999999999996\"} 33418\n[...]\ngo_gc_heap_frees_by_size_bytes_total_bucket{le=\"32768.99999999999\"} 96417\ngo_gc_heap_frees_by_size_bytes_total_bucket{le=\"+Inf\"} 96425\ngo_gc_heap_frees_by_size_bytes_total_sum 9.880944e+06\ngo_gc_heap_frees_by_size_bytes_total_count 96425\n# HELP go_gc_heap_frees_bytes_total Cumulative sum of heap memory freed by the garbage collector.\n# TYPE go_gc_heap_frees_bytes_total counter\ngo_gc_heap_frees_bytes_total 9.880944e+06\n# HELP go_gc_heap_frees_objects_total Cumulative count of heap allocations whose storage was freed by the garbage collector. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.\n# TYPE go_gc_heap_frees_objects_total counter\ngo_gc_heap_frees_objects_total 96425\n# HELP go_gc_heap_goal_bytes Heap size target for the end of the GC cycle.\n# TYPE go_gc_heap_goal_bytes gauge\ngo_gc_heap_goal_bytes 9.356624e+06\n# HELP go_gc_heap_objects_objects Number of objects, live or unswept, occupying heap memory.\n# TYPE go_gc_heap_objects_objects gauge\ngo_gc_heap_objects_objects 31902\n# HELP go_gc_heap_tiny_allocs_objects_total Count of small allocations that are packed together into blocks. These allocations are counted separately from other allocations because each individual allocation is not tracked by the runtime, only their block. Each block is already accounted for in allocs-by-size and frees-by-size.\n# TYPE go_gc_heap_tiny_allocs_objects_total counter\ngo_gc_heap_tiny_allocs_objects_total 11750\n# HELP go_gc_pauses_seconds_total Distribution individual GC-related stop-the-world pause latencies.\n# TYPE go_gc_pauses_seconds_total histogram\ngo_gc_pauses_seconds_total_bucket{le=\"9.999999999999999e-10\"} 0\ngo_gc_pauses_seconds_total_bucket{le=\"1.9999999999999997e-09\"} 0\n[...]\ngo_gc_pauses_seconds_total_bucket{le=\"206708.18602188796\"} 26\ngo_gc_pauses_seconds_total_bucket{le=\"+Inf\"} 26\ngo_gc_pauses_seconds_total_sum 0.003151488\ngo_gc_pauses_seconds_total_count 26\n# HELP go_goroutines Number of goroutines that currently exist.\n# TYPE go_goroutines gauge\ngo_goroutines 80\n# HELP go_info Information about the Go environment.\n# TYPE go_info gauge\ngo_info{version=\"go1.18.7\"} 1\n# HELP go_memory_classes_heap_free_bytes Memory that is completely free and eligible to be returned to the underlying system, but has not been. This metric is the runtime's estimate of free address space that is backed by physical memory.\n# TYPE go_memory_classes_heap_free_bytes gauge\ngo_memory_classes_heap_free_bytes 589824\n# HELP go_memory_classes_heap_objects_bytes Memory occupied by live objects and dead objects that have not yet been marked free by the garbage collector.\n# TYPE go_memory_classes_heap_objects_bytes gauge\ngo_memory_classes_heap_objects_bytes 5.140568e+06\n# HELP go_memory_classes_heap_released_bytes Memory that is completely free and has been returned to the underlying system. This metric is the runtime's estimate of free address space that is still mapped into the process, but is not backed by physical memory.\n# TYPE go_memory_classes_heap_released_bytes gauge\ngo_memory_classes_heap_released_bytes 4.005888e+06\n# HELP go_memory_classes_heap_stacks_bytes Memory allocated from the heap that is reserved for stack space, whether or not it is currently in-use.\n# TYPE go_memory_classes_heap_stacks_bytes gauge\ngo_memory_classes_heap_stacks_bytes 786432\n# HELP go_memory_classes_heap_unused_bytes Memory that is reserved for heap objects but is not currently used to hold heap objects.\n# TYPE go_memory_classes_heap_unused_bytes gauge\ngo_memory_classes_heap_unused_bytes 2.0602e+06\n# HELP go_memory_classes_metadata_mcache_free_bytes Memory that is reserved for runtime mcache structures, but not in-use.\n# TYPE go_memory_classes_metadata_mcache_free_bytes gauge\ngo_memory_classes_metadata_mcache_free_bytes 13984\n# HELP go_memory_classes_metadata_mcache_inuse_bytes Memory that is occupied by runtime mcache structures that are currently being used.\n# TYPE go_memory_classes_metadata_mcache_inuse_bytes gauge\ngo_memory_classes_metadata_mcache_inuse_bytes 2400\n# HELP go_memory_classes_metadata_mspan_free_bytes Memory that is reserved for runtime mspan structures, but not in-use.\n# TYPE go_memory_classes_metadata_mspan_free_bytes gauge\ngo_memory_classes_metadata_mspan_free_bytes 17104\n# HELP go_memory_classes_metadata_mspan_inuse_bytes Memory that is occupied by runtime mspan structures that are currently being used.\n# TYPE go_memory_classes_metadata_mspan_inuse_bytes gauge\ngo_memory_classes_metadata_mspan_inuse_bytes 113968\n# HELP go_memory_classes_metadata_other_bytes Memory that is reserved for or used to hold runtime metadata.\n# TYPE go_memory_classes_metadata_other_bytes gauge\ngo_memory_classes_metadata_other_bytes 5.544408e+06\n# HELP go_memory_classes_os_stacks_bytes Stack memory allocated by the underlying operating system.\n# TYPE go_memory_classes_os_stacks_bytes gauge\ngo_memory_classes_os_stacks_bytes 0\n# HELP go_memory_classes_other_bytes Memory used by execution trace buffers, structures for debugging the runtime, finalizer and profiler specials, and more.\n# TYPE go_memory_classes_other_bytes gauge\ngo_memory_classes_other_bytes 537777\n# HELP go_memory_classes_profiling_buckets_bytes Memory that is used by the stack trace hash map used for profiling.\n# TYPE go_memory_classes_profiling_buckets_bytes gauge\ngo_memory_classes_profiling_buckets_bytes 1.455487e+06\n# HELP go_memory_classes_total_bytes All memory mapped by the Go runtime into the current process as read-write. Note that this does not include memory mapped by code called via cgo or via the syscall package. Sum of all metrics in /memory/classes.\n# TYPE go_memory_classes_total_bytes gauge\ngo_memory_classes_total_bytes 2.026804e+07\n# HELP go_memstats_alloc_bytes Number of bytes allocated and still in use.\n# TYPE go_memstats_alloc_bytes gauge\ngo_memstats_alloc_bytes 5.140568e+06\n# HELP go_memstats_alloc_bytes_total Total number of bytes allocated, even if freed.\n# TYPE go_memstats_alloc_bytes_total counter\ngo_memstats_alloc_bytes_total 1.5021512e+07\n# HELP go_memstats_buck_hash_sys_bytes Number of bytes used by the profiling bucket hash table.\n# TYPE go_memstats_buck_hash_sys_bytes gauge\ngo_memstats_buck_hash_sys_bytes 1.455487e+06\n# HELP go_memstats_frees_total Total number of frees.\n# TYPE go_memstats_frees_total counter\ngo_memstats_frees_total 108175\n# HELP go_memstats_gc_cpu_fraction The fraction of this program's available CPU time used by the GC since the program started.\n# TYPE go_memstats_gc_cpu_fraction gauge\ngo_memstats_gc_cpu_fraction 0\n# HELP go_memstats_gc_sys_bytes Number of bytes used for garbage collection system metadata.\n# TYPE go_memstats_gc_sys_bytes gauge\ngo_memstats_gc_sys_bytes 5.544408e+06\n# HELP go_memstats_heap_alloc_bytes Number of heap bytes allocated and still in use.\n# TYPE go_memstats_heap_alloc_bytes gauge\ngo_memstats_heap_alloc_bytes 5.140568e+06\n# HELP go_memstats_heap_idle_bytes Number of heap bytes waiting to be used.\n# TYPE go_memstats_heap_idle_bytes gauge\ngo_memstats_heap_idle_bytes 4.595712e+06\n# HELP go_memstats_heap_inuse_bytes Number of heap bytes that are in use.\n# TYPE go_memstats_heap_inuse_bytes gauge\ngo_memstats_heap_inuse_bytes 7.200768e+06\n# HELP go_memstats_heap_objects Number of allocated objects.\n# TYPE go_memstats_heap_objects gauge\ngo_memstats_heap_objects 31902\n# HELP go_memstats_heap_released_bytes Number of heap bytes released to OS.\n# TYPE go_memstats_heap_released_bytes gauge\ngo_memstats_heap_released_bytes 4.005888e+06\n# HELP go_memstats_heap_sys_bytes Number of heap bytes obtained from system.\n# TYPE go_memstats_heap_sys_bytes gauge\ngo_memstats_heap_sys_bytes 1.179648e+07\n# HELP go_memstats_last_gc_time_seconds Number of seconds since 1970 of last garbage collection.\n# TYPE go_memstats_last_gc_time_seconds gauge\ngo_memstats_last_gc_time_seconds 1.6461572121033354e+09\n# HELP go_memstats_lookups_total Total number of pointer lookups.\n# TYPE go_memstats_lookups_total counter\ngo_memstats_lookups_total 0\n# HELP go_memstats_mallocs_total Total number of mallocs.\n# TYPE go_memstats_mallocs_total counter\ngo_memstats_mallocs_total 140077\n# HELP go_memstats_mcache_inuse_bytes Number of bytes in use by mcache structures.\n# TYPE go_memstats_mcache_inuse_bytes gauge\ngo_memstats_mcache_inuse_bytes 2400\n# HELP go_memstats_mcache_sys_bytes Number of bytes used for mcache structures obtained from system.\n# TYPE go_memstats_mcache_sys_bytes gauge\ngo_memstats_mcache_sys_bytes 16384\n# HELP go_memstats_mspan_inuse_bytes Number of bytes in use by mspan structures.\n# TYPE go_memstats_mspan_inuse_bytes gauge\ngo_memstats_mspan_inuse_bytes 113968\n# HELP go_memstats_mspan_sys_bytes Number of bytes used for mspan structures obtained from system.\n# TYPE go_memstats_mspan_sys_bytes gauge\ngo_memstats_mspan_sys_bytes 131072\n# HELP go_memstats_next_gc_bytes Number of heap bytes when next garbage collection will take place.\n# TYPE go_memstats_next_gc_bytes gauge\ngo_memstats_next_gc_bytes 9.356624e+06\n# HELP go_memstats_other_sys_bytes Number of bytes used for other system allocations.\n# TYPE go_memstats_other_sys_bytes gauge\ngo_memstats_other_sys_bytes 537777\n# HELP go_memstats_stack_inuse_bytes Number of bytes in use by the stack allocator.\n# TYPE go_memstats_stack_inuse_bytes gauge\ngo_memstats_stack_inuse_bytes 786432\n# HELP go_memstats_stack_sys_bytes Number of bytes obtained from system for stack allocator.\n# TYPE go_memstats_stack_sys_bytes gauge\ngo_memstats_stack_sys_bytes 786432\n# HELP go_memstats_sys_bytes Number of bytes obtained from system.\n# TYPE go_memstats_sys_bytes gauge\ngo_memstats_sys_bytes 2.026804e+07\n# HELP go_sched_goroutines_goroutines Count of live goroutines.\n# TYPE go_sched_goroutines_goroutines gauge\ngo_sched_goroutines_goroutines 80\n# HELP go_sched_latencies_seconds Distribution of the time goroutines have spent in the scheduler in a runnable state before actually running.\n# TYPE go_sched_latencies_seconds histogram\ngo_sched_latencies_seconds_bucket{le=\"9.999999999999999e-10\"} 244\ngo_sched_latencies_seconds_bucket{le=\"1.9999999999999997e-09\"} 244\n[...]\ngo_sched_latencies_seconds_bucket{le=\"206708.18602188796\"} 2336\ngo_sched_latencies_seconds_bucket{le=\"+Inf\"} 2336\ngo_sched_latencies_seconds_sum 0.18509832400000004\ngo_sched_latencies_seconds_count 2336\n# HELP go_threads Number of OS threads created.\n# TYPE go_threads gauge\ngo_threads 8\n# HELP process_cpu_seconds_total Total user and system CPU time spent in seconds.\n# TYPE process_cpu_seconds_total counter\nprocess_cpu_seconds_total 1.84\n# HELP process_max_fds Maximum number of open file descriptors.\n# TYPE process_max_fds gauge\nprocess_max_fds 1.048576e+06\n# HELP process_open_fds Number of open file descriptors.\n# TYPE process_open_fds gauge\nprocess_open_fds 14\n# HELP process_resident_memory_bytes Resident memory size in bytes.\n# TYPE process_resident_memory_bytes gauge\nprocess_resident_memory_bytes 4.3728896e+07\n# HELP process_start_time_seconds Start time of the process since unix epoch in seconds.\n# TYPE process_start_time_seconds gauge\nprocess_start_time_seconds 1.64615612779e+09\n# HELP process_virtual_memory_bytes Virtual memory size in bytes.\n# TYPE process_virtual_memory_bytes gauge\nprocess_virtual_memory_bytes 7.65362176e+08\n# HELP process_virtual_memory_max_bytes Maximum amount of virtual memory available in bytes.\n# TYPE process_virtual_memory_max_bytes gauge\nprocess_virtual_memory_max_bytes 1.8446744073709552e+19\n# HELP rest_client_requests_total Number of HTTP requests, partitioned by status code, method, and host.\n# TYPE rest_client_requests_total counter\nrest_client_requests_total{code=\"200\",host=\"10.96.0.1:443\",method=\"GET\"} 114\nrest_client_requests_total{code=\"200\",host=\"10.96.0.1:443\",method=\"PUT\"} 4\n# HELP workqueue_adds_total Total number of adds handled by workqueue\n# TYPE workqueue_adds_total counter\nworkqueue_adds_total{name=\"authconfig\"} 19\nworkqueue_adds_total{name=\"secret\"} 1\n# HELP workqueue_depth Current depth of workqueue\n# TYPE workqueue_depth gauge\nworkqueue_depth{name=\"authconfig\"} 0\nworkqueue_depth{name=\"secret\"} 0\n# HELP workqueue_longest_running_processor_seconds How many seconds has the longest running processor for workqueue been running.\n# TYPE workqueue_longest_running_processor_seconds gauge\nworkqueue_longest_running_processor_seconds{name=\"authconfig\"} 0\nworkqueue_longest_running_processor_seconds{name=\"secret\"} 0\n# HELP workqueue_queue_duration_seconds How long in seconds an item stays in workqueue before being requested\n# TYPE workqueue_queue_duration_seconds histogram\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"1e-08\"} 0\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"1e-07\"} 0\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"1e-06\"} 0\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"9.999999999999999e-06\"} 8\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"9.999999999999999e-05\"} 17\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"0.001\"} 17\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"0.01\"} 17\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"0.1\"} 18\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"1\"} 18\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"10\"} 19\nworkqueue_queue_duration_seconds_bucket{name=\"authconfig\",le=\"+Inf\"} 19\nworkqueue_queue_duration_seconds_sum{name=\"authconfig\"} 4.969016371\nworkqueue_queue_duration_seconds_count{name=\"authconfig\"} 19\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"1e-08\"} 0\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"1e-07\"} 0\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"1e-06\"} 0\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"9.999999999999999e-06\"} 1\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"9.999999999999999e-05\"} 1\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"0.001\"} 1\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"0.01\"} 1\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"0.1\"} 1\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"1\"} 1\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"10\"} 1\nworkqueue_queue_duration_seconds_bucket{name=\"secret\",le=\"+Inf\"} 1\nworkqueue_queue_duration_seconds_sum{name=\"secret\"} 4.67e-06\nworkqueue_queue_duration_seconds_count{name=\"secret\"} 1\n# HELP workqueue_retries_total Total number of retries handled by workqueue\n# TYPE workqueue_retries_total counter\nworkqueue_retries_total{name=\"authconfig\"} 12\nworkqueue_retries_total{name=\"secret\"} 0\n# HELP workqueue_unfinished_work_seconds How many seconds of work has been done that is in progress and hasn't been observed by work_duration. Large values indicate stuck threads. One can deduce the number of stuck threads by observing the rate at which this increases.\n# TYPE workqueue_unfinished_work_seconds gauge\nworkqueue_unfinished_work_seconds{name=\"authconfig\"} 0\nworkqueue_unfinished_work_seconds{name=\"secret\"} 0\n# HELP workqueue_work_duration_seconds How long in seconds processing an item from workqueue takes.\n# TYPE workqueue_work_duration_seconds histogram\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"1e-08\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"1e-07\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"1e-06\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"9.999999999999999e-06\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"9.999999999999999e-05\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"0.001\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"0.01\"} 11\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"0.1\"} 18\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"1\"} 18\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"10\"} 19\nworkqueue_work_duration_seconds_bucket{name=\"authconfig\",le=\"+Inf\"} 19\nworkqueue_work_duration_seconds_sum{name=\"authconfig\"} 5.171738079000001\nworkqueue_work_duration_seconds_count{name=\"authconfig\"} 19\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"1e-08\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"1e-07\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"1e-06\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"9.999999999999999e-06\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"9.999999999999999e-05\"} 0\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"0.001\"} 1\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"0.01\"} 1\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"0.1\"} 1\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"1\"} 1\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"10\"} 1\nworkqueue_work_duration_seconds_bucket{name=\"secret\",le=\"+Inf\"} 1\nworkqueue_work_duration_seconds_sum{name=\"secret\"} 0.000150956\nworkqueue_work_duration_seconds_count{name=\"secret\"} 1\n</code></pre> Example of metrics exported at the <code>/server-metrics</code> endpoint <pre><code># HELP auth_server_authconfig_duration_seconds Response latency of authconfig enforced by the auth server (in seconds).\n# TYPE auth_server_authconfig_duration_seconds histogram\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.001\"} 0\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.051000000000000004\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.101\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.15100000000000002\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.201\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.251\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.301\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.351\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.40099999999999997\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.45099999999999996\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.501\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.551\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.6010000000000001\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.6510000000000001\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.7010000000000002\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.7510000000000002\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.8010000000000003\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.8510000000000003\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.9010000000000004\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"0.9510000000000004\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"edge-auth\",namespace=\"authorino\",le=\"+Inf\"} 1\nauth_server_authconfig_duration_seconds_sum{authconfig=\"edge-auth\",namespace=\"authorino\"} 0.001701795\nauth_server_authconfig_duration_seconds_count{authconfig=\"edge-auth\",namespace=\"authorino\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.001\"} 1\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.051000000000000004\"} 4\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.101\"} 4\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.15100000000000002\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.201\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.251\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.301\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.351\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.40099999999999997\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.45099999999999996\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.501\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.551\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.6010000000000001\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.6510000000000001\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.7010000000000002\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.7510000000000002\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.8010000000000003\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.8510000000000003\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.9010000000000004\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"0.9510000000000004\"} 5\nauth_server_authconfig_duration_seconds_bucket{authconfig=\"talker-api-protection\",namespace=\"authorino\",le=\"+Inf\"} 5\nauth_server_authconfig_duration_seconds_sum{authconfig=\"talker-api-protection\",namespace=\"authorino\"} 0.26967658299999997\nauth_server_authconfig_duration_seconds_count{authconfig=\"talker-api-protection\",namespace=\"authorino\"} 5\n# HELP auth_server_authconfig_response_status Response status of authconfigs sent by the auth server, partitioned by authconfig.\n# TYPE auth_server_authconfig_response_status counter\nauth_server_authconfig_response_status{authconfig=\"edge-auth\",namespace=\"authorino\",status=\"OK\"} 1\nauth_server_authconfig_response_status{authconfig=\"talker-api-protection\",namespace=\"authorino\",status=\"OK\"} 2\nauth_server_authconfig_response_status{authconfig=\"talker-api-protection\",namespace=\"authorino\",status=\"PERMISSION_DENIED\"} 2\nauth_server_authconfig_response_status{authconfig=\"talker-api-protection\",namespace=\"authorino\",status=\"UNAUTHENTICATED\"} 1\n# HELP auth_server_authconfig_total Total number of authconfigs enforced by the auth server, partitioned by authconfig.\n# TYPE auth_server_authconfig_total counter\nauth_server_authconfig_total{authconfig=\"edge-auth\",namespace=\"authorino\"} 1\nauth_server_authconfig_total{authconfig=\"talker-api-protection\",namespace=\"authorino\"} 5\n# HELP auth_server_evaluator_duration_seconds Response latency of individual authconfig rule evaluated by the auth server (in seconds).\n# TYPE auth_server_evaluator_duration_seconds histogram\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.001\"} 0\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.051000000000000004\"} 3\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.101\"} 3\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.15100000000000002\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.201\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.251\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.301\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.351\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.40099999999999997\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.45099999999999996\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.501\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.551\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.6010000000000001\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.6510000000000001\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.7010000000000002\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.7510000000000002\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.8010000000000003\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.8510000000000003\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.9010000000000004\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"0.9510000000000004\"} 4\nauth_server_evaluator_duration_seconds_bucket{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\",le=\"+Inf\"} 4\nauth_server_evaluator_duration_seconds_sum{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\"} 0.25800055\nauth_server_evaluator_duration_seconds_count{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\"} 4\n# HELP auth_server_evaluator_total Total number of evaluations of individual authconfig rule performed by the auth server.\n# TYPE auth_server_evaluator_total counter\nauth_server_evaluator_total{authconfig=\"talker-api-protection\",evaluator_name=\"geo\",evaluator_type=\"METADATA_GENERIC_HTTP\",namespace=\"authorino\"} 4\n# HELP auth_server_response_status Response status of authconfigs sent by the auth server.\n# TYPE auth_server_response_status counter\nauth_server_response_status{status=\"NOT_FOUND\"} 1\nauth_server_response_status{status=\"OK\"} 3\nauth_server_response_status{status=\"PERMISSION_DENIED\"} 2\nauth_server_response_status{status=\"UNAUTHENTICATED\"} 1\n# HELP go_gc_cycles_automatic_gc_cycles_total Count of completed GC cycles generated by the Go runtime.\n# TYPE go_gc_cycles_automatic_gc_cycles_total counter\ngo_gc_cycles_automatic_gc_cycles_total 11\n# HELP go_gc_cycles_forced_gc_cycles_total Count of completed GC cycles forced by the application.\n# TYPE go_gc_cycles_forced_gc_cycles_total counter\ngo_gc_cycles_forced_gc_cycles_total 0\n# HELP go_gc_cycles_total_gc_cycles_total Count of all completed GC cycles.\n# TYPE go_gc_cycles_total_gc_cycles_total counter\ngo_gc_cycles_total_gc_cycles_total 11\n# HELP go_gc_duration_seconds A summary of the pause duration of garbage collection cycles.\n# TYPE go_gc_duration_seconds summary\ngo_gc_duration_seconds{quantile=\"0\"} 4.5971e-05\ngo_gc_duration_seconds{quantile=\"0.25\"} 5.69e-05\ngo_gc_duration_seconds{quantile=\"0.5\"} 0.000158594\ngo_gc_duration_seconds{quantile=\"0.75\"} 0.000324091\ngo_gc_duration_seconds{quantile=\"1\"} 0.001692423\ngo_gc_duration_seconds_sum 0.003546711\ngo_gc_duration_seconds_count 11\n# HELP go_gc_heap_allocs_by_size_bytes_total Distribution of heap allocations by approximate size. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.\n# TYPE go_gc_heap_allocs_by_size_bytes_total histogram\ngo_gc_heap_allocs_by_size_bytes_total_bucket{le=\"8.999999999999998\"} 6261\ngo_gc_heap_allocs_by_size_bytes_total_bucket{le=\"16.999999999999996\"} 42477\n[...]\ngo_gc_heap_allocs_by_size_bytes_total_bucket{le=\"32768.99999999999\"} 122133\ngo_gc_heap_allocs_by_size_bytes_total_bucket{le=\"+Inf\"} 122154\ngo_gc_heap_allocs_by_size_bytes_total_sum 1.455944e+07\ngo_gc_heap_allocs_by_size_bytes_total_count 122154\n# HELP go_gc_heap_allocs_bytes_total Cumulative sum of memory allocated to the heap by the application.\n# TYPE go_gc_heap_allocs_bytes_total counter\ngo_gc_heap_allocs_bytes_total 1.455944e+07\n# HELP go_gc_heap_allocs_objects_total Cumulative count of heap allocations triggered by the application. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.\n# TYPE go_gc_heap_allocs_objects_total counter\ngo_gc_heap_allocs_objects_total 122154\n# HELP go_gc_heap_frees_by_size_bytes_total Distribution of freed heap allocations by approximate size. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.\n# TYPE go_gc_heap_frees_by_size_bytes_total histogram\ngo_gc_heap_frees_by_size_bytes_total_bucket{le=\"8.999999999999998\"} 3789\ngo_gc_heap_frees_by_size_bytes_total_bucket{le=\"16.999999999999996\"} 31067\n[...]\ngo_gc_heap_frees_by_size_bytes_total_bucket{le=\"32768.99999999999\"} 91013\ngo_gc_heap_frees_by_size_bytes_total_bucket{le=\"+Inf\"} 91021\ngo_gc_heap_frees_by_size_bytes_total_sum 9.399936e+06\ngo_gc_heap_frees_by_size_bytes_total_count 91021\n# HELP go_gc_heap_frees_bytes_total Cumulative sum of heap memory freed by the garbage collector.\n# TYPE go_gc_heap_frees_bytes_total counter\ngo_gc_heap_frees_bytes_total 9.399936e+06\n# HELP go_gc_heap_frees_objects_total Cumulative count of heap allocations whose storage was freed by the garbage collector. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny blocks.\n# TYPE go_gc_heap_frees_objects_total counter\ngo_gc_heap_frees_objects_total 91021\n# HELP go_gc_heap_goal_bytes Heap size target for the end of the GC cycle.\n# TYPE go_gc_heap_goal_bytes gauge\ngo_gc_heap_goal_bytes 9.601744e+06\n# HELP go_gc_heap_objects_objects Number of objects, live or unswept, occupying heap memory.\n# TYPE go_gc_heap_objects_objects gauge\ngo_gc_heap_objects_objects 31133\n# HELP go_gc_heap_tiny_allocs_objects_total Count of small allocations that are packed together into blocks. These allocations are counted separately from other allocations because each individual allocation is not tracked by the runtime, only their block. Each block is already accounted for in allocs-by-size and frees-by-size.\n# TYPE go_gc_heap_tiny_allocs_objects_total counter\ngo_gc_heap_tiny_allocs_objects_total 9866\n# HELP go_gc_pauses_seconds_total Distribution individual GC-related stop-the-world pause latencies.\n# TYPE go_gc_pauses_seconds_total histogram\ngo_gc_pauses_seconds_total_bucket{le=\"9.999999999999999e-10\"} 0\ngo_gc_pauses_seconds_total_bucket{le=\"1.9999999999999997e-09\"} 0\n[...]\ngo_gc_pauses_seconds_total_bucket{le=\"206708.18602188796\"} 22\ngo_gc_pauses_seconds_total_bucket{le=\"+Inf\"} 22\ngo_gc_pauses_seconds_total_sum 0.0030393599999999996\ngo_gc_pauses_seconds_total_count 22\n# HELP go_goroutines Number of goroutines that currently exist.\n# TYPE go_goroutines gauge\ngo_goroutines 79\n# HELP go_info Information about the Go environment.\n# TYPE go_info gauge\ngo_info{version=\"go1.18.7\"} 1\n# HELP go_memory_classes_heap_free_bytes Memory that is completely free and eligible to be returned to the underlying system, but has not been. This metric is the runtime's estimate of free address space that is backed by physical memory.\n# TYPE go_memory_classes_heap_free_bytes gauge\ngo_memory_classes_heap_free_bytes 630784\n# HELP go_memory_classes_heap_objects_bytes Memory occupied by live objects and dead objects that have not yet been marked free by the garbage collector.\n# TYPE go_memory_classes_heap_objects_bytes gauge\ngo_memory_classes_heap_objects_bytes 5.159504e+06\n# HELP go_memory_classes_heap_released_bytes Memory that is completely free and has been returned to the underlying system. This metric is the runtime's estimate of free address space that is still mapped into the process, but is not backed by physical memory.\n# TYPE go_memory_classes_heap_released_bytes gauge\ngo_memory_classes_heap_released_bytes 3.858432e+06\n# HELP go_memory_classes_heap_stacks_bytes Memory allocated from the heap that is reserved for stack space, whether or not it is currently in-use.\n# TYPE go_memory_classes_heap_stacks_bytes gauge\ngo_memory_classes_heap_stacks_bytes 786432\n# HELP go_memory_classes_heap_unused_bytes Memory that is reserved for heap objects but is not currently used to hold heap objects.\n# TYPE go_memory_classes_heap_unused_bytes gauge\ngo_memory_classes_heap_unused_bytes 2.14776e+06\n# HELP go_memory_classes_metadata_mcache_free_bytes Memory that is reserved for runtime mcache structures, but not in-use.\n# TYPE go_memory_classes_metadata_mcache_free_bytes gauge\ngo_memory_classes_metadata_mcache_free_bytes 13984\n# HELP go_memory_classes_metadata_mcache_inuse_bytes Memory that is occupied by runtime mcache structures that are currently being used.\n# TYPE go_memory_classes_metadata_mcache_inuse_bytes gauge\ngo_memory_classes_metadata_mcache_inuse_bytes 2400\n# HELP go_memory_classes_metadata_mspan_free_bytes Memory that is reserved for runtime mspan structures, but not in-use.\n# TYPE go_memory_classes_metadata_mspan_free_bytes gauge\ngo_memory_classes_metadata_mspan_free_bytes 16696\n# HELP go_memory_classes_metadata_mspan_inuse_bytes Memory that is occupied by runtime mspan structures that are currently being used.\n# TYPE go_memory_classes_metadata_mspan_inuse_bytes gauge\ngo_memory_classes_metadata_mspan_inuse_bytes 114376\n# HELP go_memory_classes_metadata_other_bytes Memory that is reserved for or used to hold runtime metadata.\n# TYPE go_memory_classes_metadata_other_bytes gauge\ngo_memory_classes_metadata_other_bytes 5.544408e+06\n# HELP go_memory_classes_os_stacks_bytes Stack memory allocated by the underlying operating system.\n# TYPE go_memory_classes_os_stacks_bytes gauge\ngo_memory_classes_os_stacks_bytes 0\n# HELP go_memory_classes_other_bytes Memory used by execution trace buffers, structures for debugging the runtime, finalizer and profiler specials, and more.\n# TYPE go_memory_classes_other_bytes gauge\ngo_memory_classes_other_bytes 537777\n# HELP go_memory_classes_profiling_buckets_bytes Memory that is used by the stack trace hash map used for profiling.\n# TYPE go_memory_classes_profiling_buckets_bytes gauge\ngo_memory_classes_profiling_buckets_bytes 1.455487e+06\n# HELP go_memory_classes_total_bytes All memory mapped by the Go runtime into the current process as read-write. Note that this does not include memory mapped by code called via cgo or via the syscall package. Sum of all metrics in /memory/classes.\n# TYPE go_memory_classes_total_bytes gauge\ngo_memory_classes_total_bytes 2.026804e+07\n# HELP go_memstats_alloc_bytes Number of bytes allocated and still in use.\n# TYPE go_memstats_alloc_bytes gauge\ngo_memstats_alloc_bytes 5.159504e+06\n# HELP go_memstats_alloc_bytes_total Total number of bytes allocated, even if freed.\n# TYPE go_memstats_alloc_bytes_total counter\ngo_memstats_alloc_bytes_total 1.455944e+07\n# HELP go_memstats_buck_hash_sys_bytes Number of bytes used by the profiling bucket hash table.\n# TYPE go_memstats_buck_hash_sys_bytes gauge\ngo_memstats_buck_hash_sys_bytes 1.455487e+06\n# HELP go_memstats_frees_total Total number of frees.\n# TYPE go_memstats_frees_total counter\ngo_memstats_frees_total 100887\n# HELP go_memstats_gc_cpu_fraction The fraction of this program's available CPU time used by the GC since the program started.\n# TYPE go_memstats_gc_cpu_fraction gauge\ngo_memstats_gc_cpu_fraction 0\n# HELP go_memstats_gc_sys_bytes Number of bytes used for garbage collection system metadata.\n# TYPE go_memstats_gc_sys_bytes gauge\ngo_memstats_gc_sys_bytes 5.544408e+06\n# HELP go_memstats_heap_alloc_bytes Number of heap bytes allocated and still in use.\n# TYPE go_memstats_heap_alloc_bytes gauge\ngo_memstats_heap_alloc_bytes 5.159504e+06\n# HELP go_memstats_heap_idle_bytes Number of heap bytes waiting to be used.\n# TYPE go_memstats_heap_idle_bytes gauge\ngo_memstats_heap_idle_bytes 4.489216e+06\n# HELP go_memstats_heap_inuse_bytes Number of heap bytes that are in use.\n# TYPE go_memstats_heap_inuse_bytes gauge\ngo_memstats_heap_inuse_bytes 7.307264e+06\n# HELP go_memstats_heap_objects Number of allocated objects.\n# TYPE go_memstats_heap_objects gauge\ngo_memstats_heap_objects 31133\n# HELP go_memstats_heap_released_bytes Number of heap bytes released to OS.\n# TYPE go_memstats_heap_released_bytes gauge\ngo_memstats_heap_released_bytes 3.858432e+06\n# HELP go_memstats_heap_sys_bytes Number of heap bytes obtained from system.\n# TYPE go_memstats_heap_sys_bytes gauge\ngo_memstats_heap_sys_bytes 1.179648e+07\n# HELP go_memstats_last_gc_time_seconds Number of seconds since 1970 of last garbage collection.\n# TYPE go_memstats_last_gc_time_seconds gauge\ngo_memstats_last_gc_time_seconds 1.6461569717723043e+09\n# HELP go_memstats_lookups_total Total number of pointer lookups.\n# TYPE go_memstats_lookups_total counter\ngo_memstats_lookups_total 0\n# HELP go_memstats_mallocs_total Total number of mallocs.\n# TYPE go_memstats_mallocs_total counter\ngo_memstats_mallocs_total 132020\n# HELP go_memstats_mcache_inuse_bytes Number of bytes in use by mcache structures.\n# TYPE go_memstats_mcache_inuse_bytes gauge\ngo_memstats_mcache_inuse_bytes 2400\n# HELP go_memstats_mcache_sys_bytes Number of bytes used for mcache structures obtained from system.\n# TYPE go_memstats_mcache_sys_bytes gauge\ngo_memstats_mcache_sys_bytes 16384\n# HELP go_memstats_mspan_inuse_bytes Number of bytes in use by mspan structures.\n# TYPE go_memstats_mspan_inuse_bytes gauge\ngo_memstats_mspan_inuse_bytes 114376\n# HELP go_memstats_mspan_sys_bytes Number of bytes used for mspan structures obtained from system.\n# TYPE go_memstats_mspan_sys_bytes gauge\ngo_memstats_mspan_sys_bytes 131072\n# HELP go_memstats_next_gc_bytes Number of heap bytes when next garbage collection will take place.\n# TYPE go_memstats_next_gc_bytes gauge\ngo_memstats_next_gc_bytes 9.601744e+06\n# HELP go_memstats_other_sys_bytes Number of bytes used for other system allocations.\n# TYPE go_memstats_other_sys_bytes gauge\ngo_memstats_other_sys_bytes 537777\n# HELP go_memstats_stack_inuse_bytes Number of bytes in use by the stack allocator.\n# TYPE go_memstats_stack_inuse_bytes gauge\ngo_memstats_stack_inuse_bytes 786432\n# HELP go_memstats_stack_sys_bytes Number of bytes obtained from system for stack allocator.\n# TYPE go_memstats_stack_sys_bytes gauge\ngo_memstats_stack_sys_bytes 786432\n# HELP go_memstats_sys_bytes Number of bytes obtained from system.\n# TYPE go_memstats_sys_bytes gauge\ngo_memstats_sys_bytes 2.026804e+07\n# HELP go_sched_goroutines_goroutines Count of live goroutines.\n# TYPE go_sched_goroutines_goroutines gauge\ngo_sched_goroutines_goroutines 79\n# HELP go_sched_latencies_seconds Distribution of the time goroutines have spent in the scheduler in a runnable state before actually running.\n# TYPE go_sched_latencies_seconds histogram\ngo_sched_latencies_seconds_bucket{le=\"9.999999999999999e-10\"} 225\ngo_sched_latencies_seconds_bucket{le=\"1.9999999999999997e-09\"} 225\n[...]\ngo_sched_latencies_seconds_bucket{le=\"206708.18602188796\"} 1916\ngo_sched_latencies_seconds_bucket{le=\"+Inf\"} 1916\ngo_sched_latencies_seconds_sum 0.18081453600000003\ngo_sched_latencies_seconds_count 1916\n# HELP go_threads Number of OS threads created.\n# TYPE go_threads gauge\ngo_threads 8\n# HELP grpc_server_handled_total Total number of RPCs completed on the server, regardless of success or failure.\n# TYPE grpc_server_handled_total counter\ngrpc_server_handled_total{grpc_code=\"Aborted\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Aborted\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Aborted\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"AlreadyExists\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"AlreadyExists\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"AlreadyExists\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"Canceled\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Canceled\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Canceled\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"DataLoss\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"DataLoss\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"DataLoss\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"DeadlineExceeded\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"DeadlineExceeded\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"DeadlineExceeded\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"FailedPrecondition\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"FailedPrecondition\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"FailedPrecondition\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"Internal\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Internal\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Internal\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"InvalidArgument\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"InvalidArgument\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"InvalidArgument\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"NotFound\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"NotFound\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"NotFound\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"OK\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 7\ngrpc_server_handled_total{grpc_code=\"OK\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"OK\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"OutOfRange\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"OutOfRange\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"OutOfRange\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"PermissionDenied\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"PermissionDenied\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"PermissionDenied\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"ResourceExhausted\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"ResourceExhausted\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"ResourceExhausted\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"Unauthenticated\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Unauthenticated\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Unauthenticated\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"Unavailable\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Unavailable\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Unavailable\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"Unimplemented\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Unimplemented\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Unimplemented\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\ngrpc_server_handled_total{grpc_code=\"Unknown\",grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Unknown\",grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_handled_total{grpc_code=\"Unknown\",grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\n# HELP grpc_server_handling_seconds Histogram of response latency (seconds) of gRPC that had been application-level handled by the server.\n# TYPE grpc_server_handling_seconds histogram\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"0.005\"} 3\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"0.01\"} 3\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"0.025\"} 3\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"0.05\"} 6\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"0.1\"} 6\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"0.25\"} 7\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"0.5\"} 7\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"1\"} 7\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"2.5\"} 7\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"5\"} 7\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"10\"} 7\ngrpc_server_handling_seconds_bucket{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\",le=\"+Inf\"} 7\ngrpc_server_handling_seconds_sum{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 0.277605516\ngrpc_server_handling_seconds_count{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 7\n# HELP grpc_server_msg_received_total Total number of RPC stream messages received on the server.\n# TYPE grpc_server_msg_received_total counter\ngrpc_server_msg_received_total{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 7\ngrpc_server_msg_received_total{grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_msg_received_total{grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\n# HELP grpc_server_msg_sent_total Total number of gRPC stream messages sent by the server.\n# TYPE grpc_server_msg_sent_total counter\ngrpc_server_msg_sent_total{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 7\ngrpc_server_msg_sent_total{grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_msg_sent_total{grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\n# HELP grpc_server_started_total Total number of RPCs started on the server.\n# TYPE grpc_server_started_total counter\ngrpc_server_started_total{grpc_method=\"Check\",grpc_service=\"envoy.service.auth.v3.Authorization\",grpc_type=\"unary\"} 7\ngrpc_server_started_total{grpc_method=\"Check\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"unary\"} 0\ngrpc_server_started_total{grpc_method=\"Watch\",grpc_service=\"grpc.health.v1.Health\",grpc_type=\"server_stream\"} 0\n# HELP oidc_server_requests_total Number of get requests received on the OIDC (Festival Wristband) server.\n# TYPE oidc_server_requests_total counter\noidc_server_requests_total{authconfig=\"edge-auth\",namespace=\"authorino\",path=\"/.well-known/openid-configuration\",wristband=\"wristband\"} 1\noidc_server_requests_total{authconfig=\"edge-auth\",namespace=\"authorino\",path=\"/.well-known/openid-connect/certs\",wristband=\"wristband\"} 1\n# HELP oidc_server_response_status Status of HTTP response sent by the OIDC (Festival Wristband) server.\n# TYPE oidc_server_response_status counter\noidc_server_response_status{status=\"200\"} 2\n# HELP process_cpu_seconds_total Total user and system CPU time spent in seconds.\n# TYPE process_cpu_seconds_total counter\nprocess_cpu_seconds_total 1.42\n# HELP process_max_fds Maximum number of open file descriptors.\n# TYPE process_max_fds gauge\nprocess_max_fds 1.048576e+06\n# HELP process_open_fds Number of open file descriptors.\n# TYPE process_open_fds gauge\nprocess_open_fds 14\n# HELP process_resident_memory_bytes Resident memory size in bytes.\n# TYPE process_resident_memory_bytes gauge\nprocess_resident_memory_bytes 4.370432e+07\n# HELP process_start_time_seconds Start time of the process since unix epoch in seconds.\n# TYPE process_start_time_seconds gauge\nprocess_start_time_seconds 1.64615612779e+09\n# HELP process_virtual_memory_bytes Virtual memory size in bytes.\n# TYPE process_virtual_memory_bytes gauge\nprocess_virtual_memory_bytes 7.65362176e+08\n# HELP process_virtual_memory_max_bytes Maximum amount of virtual memory available in bytes.\n# TYPE process_virtual_memory_max_bytes gauge\nprocess_virtual_memory_max_bytes 1.8446744073709552e+19\n# HELP promhttp_metric_handler_requests_in_flight Current number of scrapes being served.\n# TYPE promhttp_metric_handler_requests_in_flight gauge\npromhttp_metric_handler_requests_in_flight 1\n# HELP promhttp_metric_handler_requests_total Total number of scrapes by HTTP status code.\n# TYPE promhttp_metric_handler_requests_total counter\npromhttp_metric_handler_requests_total{code=\"200\"} 1\npromhttp_metric_handler_requests_total{code=\"500\"} 0\npromhttp_metric_handler_requests_total{code=\"503\"} 0\n</code></pre>"},{"location":"authorino/docs/user-guides/observability/#readiness-check","title":"Readiness check","text":"<p>Authorino exposes two main endpoints for health and readiness check of the AuthConfig controller:</p> <ul> <li><code>/healthz</code>: Health probe (ping) \u2013 reports \"ok\" if the controller is healthy.</li> <li><code>/readyz</code>: Readiness probe \u2013 reports \"ok\" if the controller is ready to reconcile AuthConfig-related events.</li> </ul> <p>In general, the endpoints return either <code>200</code> (\"ok\", i.e. all checks have passed) or <code>500</code> (when one or more checks failed).</p> <p>The default binding network address is <code>:8081</code>, which can be changed by setting the command-line flag <code>--health-probe-addr</code>.</p> <p>The following additional subpath is available and its corresponding check can be aggregated into the response from the main readiness probe:</p> <ul> <li><code>/readyz/authconfigs</code>: Aggregated readiness status of the AuthConfigs \u2013 reports \"ok\" if all AuthConfigs watched by the reconciler have been marked as ready.</li> </ul> Important!The AuthConfig readiness check within the scope of the aggregated readiness probe endpoint is deactivated by default \u2013 i.e. this check is an opt-in check. Sending a request to the <code>/readyz</code> endpoint without explicitly opting-in for the AuthConfigs check, by using the <code>include</code> parameter, will result in a response message that disregards the actual status of the watched AuthConfigs, possibly an \"ok\" message. To read the aggregated status of the watched AuthConfigs, either use the specific endpoint <code>/readyz/authconfigs</code> or opt-in for the check in the aggregated endpoint by sending a request to <code>/readyz?include=authconfigs</code> <p>Apart from <code>include</code> to add the aggregated status of the AuthConfigs, the following additional query string parameters are available:</p> <ul> <li><code>verbose=true|false</code> - provides more verbose response messages;</li> <li><code>exclude=(check name)</code> \u2013 to exclude a particular readiness check (for future usage).</li> </ul>"},{"location":"authorino/docs/user-guides/observability/#logging","title":"Logging","text":"<p>Authorino provides structured log messages (\"production\") or more log messages output to stdout in a more user-friendly format (\"development\" mode) and different level of logging.</p>"},{"location":"authorino/docs/user-guides/observability/#log-levels-and-log-modes","title":"Log levels and log modes","text":"<p>Authorino outputs 3 levels of log messages: (from lowest to highest level)</p> <ol> <li><code>debug</code></li> <li><code>info</code> (default)</li> <li><code>error</code></li> </ol> <p><code>info</code> logging is restricted to high-level information of the gRPC and HTTP authorization services, limiting messages to incoming request and respective outgoing response logs, with reduced details about the corresponding objects (request payload and authorization result), and without any further detailed logs of the steps in between, except for errors.</p> <p>Only <code>debug</code> logging will include processing details of each Auth Pipeline, such as intermediary requests to validate identities with external auth servers, requests to external sources of auth metadata or authorization policies.</p> <p>To configure the desired log level, set the <code>spec.logLevel</code> field of the <code>Authorino</code> custom resource (or <code>--log-level</code> command-line flag in the Authorino deployment), to one of the supported values listed above. Default log level is <code>info</code>.</p> <p>Apart from log level, Authorino can output messages to the logs in 2 different formats:</p> <ul> <li><code>production</code> (default): each line is a parseable JSON object with properties <code>{\"level\":string, \"ts\":int, \"msg\":string, \"logger\":string, extra values...}</code></li> <li><code>development</code>: more human-readable outputs, extra stack traces and logging info, plus extra values output as JSON, in the format: <code>&lt;timestamp-iso-8601&gt;\\t&lt;log-level&gt;\\t&lt;logger&gt;\\t&lt;message&gt;\\t{extra-values-as-json}</code></li> </ul> <p>To configure the desired log mode, set the <code>spec.logMode</code> field of the <code>Authorino</code> custom resource (or <code>--log-mode</code> command-line flag in the Authorino deployment), to one of the supported values listed above. Default log level is <code>production</code>.</p> <p>Example of <code>Authorino</code> custom resource with log level <code>debug</code> and log mode <code>production</code>:</p> <pre><code>apiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  logLevel: debug\n  logMode: production\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\n</code></pre>"},{"location":"authorino/docs/user-guides/observability/#sensitive-data-output-to-the-logs","title":"Sensitive data output to the logs","text":"<p>Authorino will never output HTTP headers and query string parameters to <code>info</code> log messages, as such values usually include sensitive data (e.g. access tokens, API keys and Authorino Festival Wristbands). However, <code>debug</code> log messages may include such sensitive information and those are not redacted.</p> <p>Therefore, DO NOT USE <code>debug</code> LOG LEVEL IN PRODUCTION! Instead, use either <code>info</code> or <code>error</code>.</p>"},{"location":"authorino/docs/user-guides/observability/#log-messages-printed-by-authorino","title":"Log messages printed by Authorino","text":"<p>Some log messages printed by Authorino and corresponding extra values included:</p> logger level message extra values <code>authorino</code> <code>info</code> \"setting instance base logger\" <code>min level=info\\|debug</code>, <code>mode=production\\|development</code> <code>authorino</code> <code>info</code> \"booting up authorino\" <code>version</code> <code>authorino</code> <code>debug</code> \"setting up with options\" <code>auth-config-label-selector</code>, <code>deep-metrics-enabled</code>, <code>enable-leader-election</code>, <code>evaluator-cache-size</code>, <code>ext-auth-grpc-port</code>, <code>ext-auth-http-port</code>, <code>health-probe-addr</code>, <code>log-level</code>, <code>log-mode</code>, <code>max-http-request-body-size</code>, <code>metrics-addr</code>, <code>oidc-http-port</code>, <code>oidc-tls-cert</code>, <code>oidc-tls-cert-key</code>, <code>secret-label-selector</code>, <code>timeout</code>, <code>tls-cert</code>, <code>tls-cert-key</code>, <code>watch-namespace</code> <code>authorino</code> <code>info</code> \"attempting to acquire leader lease &lt;namespace&gt;/cb88a58a.authorino.kuadrant.io...\\n\" <code>authorino</code> <code>info</code> \"successfully acquired lease &lt;namespace&gt;/cb88a58a.authorino.kuadrant.io\\n\" <code>authorino</code> <code>info</code> \"disabling grpc auth service\" <code>authorino</code> <code>info</code> \"starting grpc auth service\" <code>port</code>, <code>tls</code> <code>authorino</code> <code>error</code> \"failed to obtain port for the grpc auth service\" <code>authorino</code> <code>error</code> \"failed to load tls cert for the grpc auth\" <code>authorino</code> <code>error</code> \"failed to start grpc auth service\" <code>authorino</code> <code>info</code> \"disabling http auth service\" <code>authorino</code> <code>info</code> \"starting http auth service\" <code>port</code>, <code>tls</code> <code>authorino</code> <code>error</code> \"failed to obtain port for the http auth service\" <code>authorino</code> <code>error</code> \"failed to start http auth service\" <code>authorino</code> <code>info</code> \"disabling http oidc service\" <code>authorino</code> <code>info</code> \"starting http oidc service\" <code>port</code>, <code>tls</code> <code>authorino</code> <code>error</code> \"failed to obtain port for the http oidc service\" <code>authorino</code> <code>error</code> \"failed to start http oidc service\" <code>authorino</code> <code>info</code> \"starting manager\" <code>authorino</code> <code>error</code> \"unable to start manager\" <code>authorino</code> <code>error</code> \"unable to create controller\" <code>controller=authconfig\\|secret\\|authconfigstatusupdate</code> <code>authorino</code> <code>error</code> \"problem running manager\" <code>authorino</code> <code>info</code> \"starting status update manager\" <code>authorino</code> <code>error</code> \"unable to start status update manager\" <code>authorino</code> <code>error</code> \"problem running status update manager\" <code>authorino.controller-runtime.metrics</code> <code>info</code> \"metrics server is starting to listen\" <code>addr</code> <code>authorino.controller-runtime.manager</code> <code>info</code> \"starting metrics server\" <code>path</code> <code>authorino.controller-runtime.manager.events</code> <code>debug</code> \"Normal\" <code>object={kind=ConfigMap, apiVersion=v1}</code>, <code>reauthorino.ason=LeaderElection</code>, <code>message=\"authorino-controller-manager-* became leader\"</code> <code>authorino.controller-runtime.manager.events</code> <code>debug</code> \"Normal\" <code>object={kind=Lease, apiVersion=coordination.k8s.io/v1}</code>, <code>reauthorino.ason=LeaderElection</code>, <code>message=\"authorino-controller-manager-* became leader\"</code> <code>authorino.controller-runtime.manager.controller.authconfig</code> <code>info</code> \"resource reconciled\" <code>authconfig</code> <code>authorino.controller-runtime.manager.controller.authconfig</code> <code>info</code> \"host already taken\" <code>authconfig</code>, <code>host</code> <code>authorino.controller-runtime.manager.controller.authconfig.statusupdater</code> <code>debug</code> \"resource status did not change\" <code>authconfig</code> <code>authorino.controller-runtime.manager.controller.authconfig.statusupdater</code> <code>debug</code> \"resource status changed\" <code>authconfig</code>, <code>authconfig/status</code> <code>authorino.controller-runtime.manager.controller.authconfig.statusupdater</code> <code>error</code> \"failed to update the resource\" <code>authconfig</code> <code>authorino.controller-runtime.manager.controller.authconfig.statusupdater</code> <code>info</code> \"resource status updated\" <code>authconfig</code> <code>authorino.controller-runtime.manager.controller.secret</code> <code>info</code> \"resource reconciled\" <code>authorino.controller-runtime.manager.controller.secret</code> <code>info</code> \"could not reconcile authconfigs using api key authorino.authentication\" <code>authorino.service.oidc</code> <code>info</code> \"request received\" <code>request id</code>, <code>url</code>, <code>realm</code>, <code>config</code>, <code>path</code> <code>authorino.service.oidc</code> <code>info</code> \"response sent\" <code>request id</code> <code>authorino.service.oidc</code> <code>error</code> \"failed to serve oidc request\" <code>authorino.service.auth</code> <code>info</code> \"incoming authorization request\" <code>request id</code>, <code>object</code> <code>authorino.service.auth</code> <code>debug</code> \"incoming authorization request\" <code>request id</code>, <code>object</code> <code>authorino.service.auth</code> <code>info</code> \"outgoing authorization response\" <code>request id</code>, <code>authorized</code>, <code>response</code>, <code>object</code> <code>authorino.service.auth</code> <code>debug</code> \"outgoing authorization response\" <code>request id</code>, <code>authorized</code>, <code>response</code>, <code>object</code> <code>authorino.service.auth</code> <code>error</code> \"failed to create dynamic metadata\" <code>request id</code>, <code>object</code> <code>authorino.service.auth.authpipeline</code> <code>debug</code> \"skipping config\" <code>request id</code>, <code>config</code>, <code>reason</code> <code>authorino.service.auth.authpipeline.identity</code> <code>debug</code> \"identity validated\" <code>request id</code>, <code>config</code>, <code>object</code> <code>authorino.service.auth.authpipeline.identity</code> <code>debug</code> \"cannot validate identity\" <code>request id</code>, <code>config</code>, <code>reason</code> <code>authorino.service.auth.authpipeline.identity</code> <code>error</code> \"failed to extend identity object\" <code>request id</code>, <code>config</code>, <code>object</code> <code>authorino.service.auth.authpipeline.identity.oidc</code> <code>error</code> \"failed to discovery openid connect configuration\" <code>endpoint</code> <code>authorino.service.auth.authpipeline.identity.oidc</code> <code>debug</code> \"auto-refresh of openid connect configuration disabled\" <code>endpoint</code>, <code>reason</code> <code>authorino.service.auth.authpipeline.identity.oidc</code> <code>debug</code> \"openid connect configuration updated\" <code>endpoint</code> <code>authorino.service.auth.authpipeline.identity.oauth2</code> <code>debug</code> \"sending token introspection request\" <code>request id</code>, <code>url</code>, <code>data</code> <code>authorino.service.auth.authpipeline.identity.kubernetesauth</code> <code>debug</code> \"calling kubernetes token review api\" <code>request id</code>, <code>tokenreview</code> <code>authorino.service.auth.authpipeline.identity.apikey</code> <code>error</code> \"Something went wrong fetching the authorized credentials\" <code>authorino.service.auth.authpipeline.metadata</code> <code>debug</code> \"fetched auth metadata\" <code>request id</code>, <code>config</code>, <code>object</code> <code>authorino.service.auth.authpipeline.metadata</code> <code>debug</code> \"cannot fetch metadata\" <code>request id</code>, <code>config</code>, <code>reason</code> <code>authorino.service.auth.authpipeline.metadata.http</code> <code>debug</code> \"sending request\" <code>request id</code>, <code>method</code>, <code>url</code>, <code>headers</code> <code>authorino.service.auth.authpipeline.metadata.userinfo</code> <code>debug</code> \"fetching user info\" <code>request id</code>, <code>endpoint</code> <code>authorino.service.auth.authpipeline.metadata.uma</code> <code>debug</code> \"requesting pat\" <code>request id</code>, <code>url</code>, <code>data</code>, <code>headers</code> <code>authorino.service.auth.authpipeline.metadata.uma</code> <code>debug</code> \"querying resources by uri\" <code>request id</code>, <code>url</code> <code>authorino.service.auth.authpipeline.metadata.uma</code> <code>debug</code> \"getting resource data\" <code>request id</code>, <code>url</code> <code>authorino.service.auth.authpipeline.authorization</code> <code>debug</code> \"evaluating for input\" <code>request id</code>, <code>input</code> <code>authorino.service.auth.authpipeline.authorization</code> <code>debug</code> \"access granted\" <code>request id</code>, <code>config</code>, <code>object</code> <code>authorino.service.auth.authpipeline.authorization</code> <code>debug</code> \"access denied\" <code>request id</code>, <code>config</code>, <code>reason</code> <code>authorino.service.auth.authpipeline.authorization.opa</code> <code>error</code> \"invalid response from policy evaluation\" <code>policy</code> <code>authorino.service.auth.authpipeline.authorization.opa</code> <code>error</code> \"failed to precompile policy\" <code>policy</code> <code>authorino.service.auth.authpipeline.authorization.opa</code> <code>error</code> \"failed to download policy from external registry\" <code>policy</code>, <code>endpoint</code> <code>authorino.service.auth.authpipeline.authorization.opa</code> <code>error</code> \"failed to refresh policy from external registry\" <code>policy</code>, <code>endpoint</code> <code>authorino.service.auth.authpipeline.authorization.opa</code> <code>debug</code> \"external policy unchanged\" <code>policy</code>, <code>endpoint</code> <code>authorino.service.auth.authpipeline.authorization.opa</code> <code>debug</code> \"auto-refresh  of external policy disabled\" <code>policy</code>, <code>endpoint</code>, <code>reason</code> <code>authorino.service.auth.authpipeline.authorization.opa</code> <code>info</code> \"policy updated from external registry\" <code>policy</code>, <code>endpoint</code> <code>authorino.service.auth.authpipeline.authorization.kubernetesauthz</code> <code>debug</code> \"calling kubernetes subject access review api\" <code>request id</code>, <code>subjectaccessreview</code> <code>authorino.service.auth.authpipeline.response</code> <code>debug</code> \"dynamic response built\" <code>request id</code>, <code>config</code>, <code>object</code> <code>authorino.service.auth.authpipeline.response</code> <code>debug</code> \"cannot build dynamic response\" <code>request id</code>, <code>config</code>, <code>reason</code> <code>authorino.service.auth.http</code> <code>debug</code> \"bad request\" <code>request id</code> <code>authorino.service.auth.http</code> <code>debug</code> \"not found\" <code>request id</code> <code>authorino.service.auth.http</code> <code>debug</code> \"request body too large\" <code>request id</code> <code>authorino.service.auth.http</code> <code>debug</code> \"service unavailable\" <code>request id</code>"},{"location":"authorino/docs/user-guides/observability/#examples","title":"Examples","text":"<p>The examples below are all with <code>--log-level=debug</code> and <code>--log-mode=production</code>.</p> Booting up the service <pre><code>{\"level\":\"info\",\"ts\":1669220526.929678,\"logger\":\"authorino\",\"msg\":\"setting instance base logger\",\"min level\":\"debug\",\"mode\":\"production\"}\n{\"level\":\"info\",\"ts\":1669220526.929718,\"logger\":\"authorino\",\"msg\":\"booting up authorino\",\"version\":\"7688cfa32317a49f0461414e741c980e9c05dba3\"}\n{\"level\":\"debug\",\"ts\":1669220526.9297278,\"logger\":\"authorino\",\"msg\":\"setting up with options\",\"auth-config-label-selector\":\"\",\"deep-metrics-enabled\":\"false\",\"enable-leader-election\":\"false\",\"evaluator-cache-size\":\"1\",\"ext-auth-grpc-port\":\"50051\",\"ext-auth-http-port\":\"5001\",\"health-probe-addr\":\":8081\",\"log-level\":\"debug\",\"log-mode\":\"production\",\"max-http-request-body-size\":\"8192\",\"metrics-addr\":\":8080\",\"oidc-http-port\":\"8083\",\"oidc-tls-cert\":\"/etc/ssl/certs/oidc.crt\",\"oidc-tls-cert-key\":\"/etc/ssl/private/oidc.key\",\"secret-label-selector\":\"authorino.kuadrant.io/managed-by=authorino\",\"timeout\":\"0\",\"tls-cert\":\"/etc/ssl/certs/tls.crt\",\"tls-cert-key\":\"/etc/ssl/private/tls.key\",\"watch-namespace\":\"default\"}\n{\"level\":\"info\",\"ts\":1669220527.9816976,\"logger\":\"authorino.controller-runtime.metrics\",\"msg\":\"Metrics server is starting to listen\",\"addr\":\":8080\"}\n{\"level\":\"info\",\"ts\":1669220527.9823213,\"logger\":\"authorino\",\"msg\":\"starting grpc auth service\",\"port\":50051,\"tls\":true}\n{\"level\":\"info\",\"ts\":1669220527.9823658,\"logger\":\"authorino\",\"msg\":\"starting http auth service\",\"port\":5001,\"tls\":true}\n{\"level\":\"info\",\"ts\":1669220527.9824295,\"logger\":\"authorino\",\"msg\":\"starting http oidc service\",\"port\":8083,\"tls\":true}\n{\"level\":\"info\",\"ts\":1669220527.9825335,\"logger\":\"authorino\",\"msg\":\"starting manager\"}\n{\"level\":\"info\",\"ts\":1669220527.982721,\"logger\":\"authorino\",\"msg\":\"Starting server\",\"path\":\"/metrics\",\"kind\":\"metrics\",\"addr\":\"[::]:8080\"}\n{\"level\":\"info\",\"ts\":1669220527.982766,\"logger\":\"authorino\",\"msg\":\"Starting server\",\"kind\":\"health probe\",\"addr\":\"[::]:8081\"}\n{\"level\":\"info\",\"ts\":1669220527.9829438,\"logger\":\"authorino.controller.secret\",\"msg\":\"Starting EventSource\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\",\"source\":\"kind source: *v1.Secret\"}\n{\"level\":\"info\",\"ts\":1669220527.9829693,\"logger\":\"authorino.controller.secret\",\"msg\":\"Starting Controller\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\"}\n{\"level\":\"info\",\"ts\":1669220527.9829714,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"Starting EventSource\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\",\"source\":\"kind source: *v1beta1.AuthConfig\"}\n{\"level\":\"info\",\"ts\":1669220527.9830208,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"Starting Controller\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\"}\n{\"level\":\"info\",\"ts\":1669220528.0834699,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"Starting workers\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\",\"worker count\":1}\n{\"level\":\"info\",\"ts\":1669220528.0836608,\"logger\":\"authorino.controller.secret\",\"msg\":\"Starting workers\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\",\"worker count\":1}\n{\"level\":\"info\",\"ts\":1669220529.041266,\"logger\":\"authorino\",\"msg\":\"starting status update manager\"}\n{\"level\":\"info\",\"ts\":1669220529.0418258,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"Starting EventSource\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\",\"source\":\"kind source: *v1beta1.AuthConfig\"}\n{\"level\":\"info\",\"ts\":1669220529.0418813,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"Starting Controller\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\"}\n{\"level\":\"info\",\"ts\":1669220529.1432905,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"Starting workers\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\",\"worker count\":1}\n</code></pre> Reconciling an AuthConfig and 2 related API key secrets <pre><code>{\"level\":\"debug\",\"ts\":1669221208.7473805,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig.statusupdater\",\"msg\":\"resource status changed\",\"authconfig\":\"default/talker-api-protection\",\"authconfig/status\":{\"conditions\":[{\"type\":\"Available\",\"status\":\"False\",\"lastTransitionTime\":\"2022-11-23T16:33:28Z\",\"reason\":\"HostsNotLinked\",\"message\":\"No hosts linked to the resource\"},{\"type\":\"Ready\",\"status\":\"False\",\"lastTransitionTime\":\"2022-11-23T16:33:28Z\",\"reason\":\"Unknown\"}],\"summary\":{\"ready\":false,\"hostsReady\":[],\"numHostsReady\":\"0/1\",\"numIdentitySources\":1,\"numMetadataSources\":0,\"numAuthorizationPolicies\":0,\"numResponseItems\":0,\"festivalWristbandEnabled\":false}}}\n{\"level\":\"info\",\"ts\":1669221208.7496614,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig\",\"msg\":\"resource reconciled\",\"authconfig\":\"default/talker-api-protection\"}\n{\"level\":\"info\",\"ts\":1669221208.7532616,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig\",\"msg\":\"resource reconciled\",\"authconfig\":\"default/talker-api-protection\"}\n{\"level\":\"debug\",\"ts\":1669221208.7535005,\"logger\":\"authorino.controller.secret\",\"msg\":\"adding k8s secret to the index\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\",\"name\":\"api-key-1\",\"namespace\":\"default\",\"authconfig\":\"default/talker-api-protection\",\"config\":\"friends\"}\n{\"level\":\"debug\",\"ts\":1669221208.7535596,\"logger\":\"authorino.controller.secret.apikey\",\"msg\":\"api key added\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\",\"name\":\"api-key-1\",\"namespace\":\"default\"}\n{\"level\":\"info\",\"ts\":1669221208.7536132,\"logger\":\"authorino.controller-runtime.manager.controller.secret\",\"msg\":\"resource reconciled\",\"secret\":\"default/api-key-1\"}\n{\"level\":\"info\",\"ts\":1669221208.753772,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig.statusupdater\",\"msg\":\"resource status updated\",\"authconfig\":\"default/talker-api-protection\"}\n{\"level\":\"debug\",\"ts\":1669221208.753835,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig.statusupdater\",\"msg\":\"resource status changed\",\"authconfig\":\"default/talker-api-protection\",\"authconfig/status\":{\"conditions\":[{\"type\":\"Available\",\"status\":\"True\",\"lastTransitionTime\":\"2022-11-23T16:33:28Z\",\"reason\":\"HostsLinked\"},{\"type\":\"Ready\",\"status\":\"True\",\"lastTransitionTime\":\"2022-11-23T16:33:28Z\",\"reason\":\"Reconciled\"}],\"summary\":{\"ready\":true,\"hostsReady\":[\"talker-api.127.0.0.1.nip.io\"],\"numHostsReady\":\"1/1\",\"numIdentitySources\":1,\"numMetadataSources\":0,\"numAuthorizationPolicies\":0,\"numResponseItems\":0,\"festivalWristbandEnabled\":false}}}\n{\"level\":\"info\",\"ts\":1669221208.7571108,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig\",\"msg\":\"resource reconciled\",\"authconfig\":\"default/talker-api-protection\"}\n{\"level\":\"info\",\"ts\":1669221208.7573664,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig.statusupdater\",\"msg\":\"resource status updated\",\"authconfig\":\"default/talker-api-protection\"}\n{\"level\":\"debug\",\"ts\":1669221208.757429,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig.statusupdater\",\"msg\":\"resource status did not change\",\"authconfig\":\"default/talker-api-protection\"}\n{\"level\":\"debug\",\"ts\":1669221208.7586699,\"logger\":\"authorino.controller.secret\",\"msg\":\"adding k8s secret to the index\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\",\"name\":\"api-key-2\",\"namespace\":\"default\",\"authconfig\":\"default/talker-api-protection\",\"config\":\"friends\"}\n{\"level\":\"debug\",\"ts\":1669221208.7586884,\"logger\":\"authorino.controller.secret.apikey\",\"msg\":\"api key added\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\",\"name\":\"api-key-2\",\"namespace\":\"default\"}\n{\"level\":\"info\",\"ts\":1669221208.7586913,\"logger\":\"authorino.controller-runtime.manager.controller.secret\",\"msg\":\"resource reconciled\",\"secret\":\"default/api-key-2\"}\n{\"level\":\"debug\",\"ts\":1669221208.7597604,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig.statusupdater\",\"msg\":\"resource status did not change\",\"authconfig\":\"default/talker-api-protection\"}\n</code></pre> Enforcing an AuthConfig with authentication based on Kubernetes tokens: <p></p> <ul> <li>identity: k8s-auth, oidc, oauth2, apikey</li> <li>metadata: http, oidc userinfo</li> <li>authorization: opa, k8s-authz</li> <li>response: wristband</li> </ul> <pre><code>{\"level\":\"info\",\"ts\":1634830460.1486168,\"logger\":\"authorino.service.auth\",\"msg\":\"incoming authorization request\",\"request id\":\"8157480586935853928\",\"object\":{\"source\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":53144}}}}},\"destination\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":8000}}}}},\"request\":{\"http\":{\"id\":\"8157480586935853928\",\"method\":\"GET\",\"path\":\"/hello\",\"host\":\"talker-api\",\"scheme\":\"http\"}}}}\n{\"level\":\"debug\",\"ts\":1634830460.1491194,\"logger\":\"authorino.service.auth\",\"msg\":\"incoming authorization request\",\"request id\":\"8157480586935853928\",\"object\":{\"source\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":53144}}}}},\"destination\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":8000}}}}},\"request\":{\"time\":{\"seconds\":1634830460,\"nanos\":147259000},\"http\":{\"id\":\"8157480586935853928\",\"method\":\"GET\",\"headers\":{\":authority\":\"talker-api\",\":method\":\"GET\",\":path\":\"/hello\",\":scheme\":\"http\",\"accept\":\"*/*\",\"authorization\":\"Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IkRsVWJZMENyVy1sZ0tFMVRMd19pcTFUWGtTYUl6T0hyWks0VHhKYnpEZUUifQ.eyJhdWQiOlsidGFsa2VyLWFwaSJdLCJleHAiOjE2MzQ4MzEwNTEsImlhdCI6MTYzNDgzMDQ1MSwiaXNzIjoiaHR0cHM6Ly9rdWJlcm5ldGVzLmRlZmF1bHQuc3ZjLmNsdXN0ZXIubG9jYWwiLCJrdWJlcm5ldGVzLmlvIjp7Im5hbWVzcGFjZSI6ImF1dGhvcmlubyIsInNlcnZpY2VhY2NvdW50Ijp7Im5hbWUiOiJhcGktY29uc3VtZXItMSIsInVpZCI6ImI0MGY1MzFjLWVjYWItNGYzMS1hNDk2LTJlYmM3MmFkZDEyMSJ9fSwibmJmIjoxNjM0ODMwNDUxLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6YXV0aG9yaW5vOmFwaS1jb25zdW1lci0xIn0.PaP0vqdl5DPfErr84KfVhPdlsGAPgsw0NkDaA9rne1zXjzcO7KPPbXhFwZC-oIjSGG1HfRMSoQeCXbQz24PSATmX8l1T52a9IFeXgP7sQmXZIDbiPfTm3X09kIIlfPKHhK_f-jQwRIpMRqNgLntlZ-xXX3P1fOBBUYR8obTPAQ6NDDaLHxw2SAmHFTQWjM_DInPDemXX0mEm7nCPKifsNxHaQH4wx4CD3LCLGbCI9FHNf2Crid8mmGJXf4wzcH1VuKkpUlsmnlUgTG2bfT2lbhSF2lBmrrhTJyYk6_aA09DwL4Bf4kvG-JtCq0Bkd_XynViIsOtOnAhgmdSPkfr-oA\",\"user-agent\":\"curl/7.65.3\",\"x-envoy-internal\":\"true\",\"x-forwarded-for\":\"10.244.0.11\",\"x-forwarded-proto\":\"http\",\"x-request-id\":\"4c5d5c97-e15b-46a3-877a-d8188e09e08f\"},\"path\":\"/hello\",\"host\":\"talker-api\",\"scheme\":\"http\",\"protocol\":\"HTTP/1.1\"}},\"context_extensions\":{\"virtual_host\":\"local_service\"},\"metadata_context\":{}}}\n{\"level\":\"debug\",\"ts\":1634830460.150506,\"logger\":\"authorino.service.auth.authpipeline.identity.kubernetesauth\",\"msg\":\"calling kubernetes token review api\",\"request id\":\"8157480586935853928\",\"tokenreview\":{\"metadata\":{\"creationTimestamp\":null},\"spec\":{\"token\":\"eyJhbGciOiJSUzI1NiIsImtpZCI6IkRsVWJZMENyVy1sZ0tFMVRMd19pcTFUWGtTYUl6T0hyWks0VHhKYnpEZUUifQ.eyJhdWQiOlsidGFsa2VyLWFwaSJdLCJleHAiOjE2MzQ4MzEwNTEsImlhdCI6MTYzNDgzMDQ1MSwiaXNzIjoiaHR0cHM6Ly9rdWJlcm5ldGVzLmRlZmF1bHQuc3ZjLmNsdXN0ZXIubG9jYWwiLCJrdWJlcm5ldGVzLmlvIjp7Im5hbWVzcGFjZSI6ImF1dGhvcmlubyIsInNlcnZpY2VhY2NvdW50Ijp7Im5hbWUiOiJhcGktY29uc3VtZXItMSIsInVpZCI6ImI0MGY1MzFjLWVjYWItNGYzMS1hNDk2LTJlYmM3MmFkZDEyMSJ9fSwibmJmIjoxNjM0ODMwNDUxLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6YXV0aG9yaW5vOmFwaS1jb25zdW1lci0xIn0.PaP0vqdl5DPfErr84KfVhPdlsGAPgsw0NkDaA9rne1zXjzcO7KPPbXhFwZC-oIjSGG1HfRMSoQeCXbQz24PSATmX8l1T52a9IFeXgP7sQmXZIDbiPfTm3X09kIIlfPKHhK_f-jQwRIpMRqNgLntlZ-xXX3P1fOBBUYR8obTPAQ6NDDaLHxw2SAmHFTQWjM_DInPDemXX0mEm7nCPKifsNxHaQH4wx4CD3LCLGbCI9FHNf2Crid8mmGJXf4wzcH1VuKkpUlsmnlUgTG2bfT2lbhSF2lBmrrhTJyYk6_aA09DwL4Bf4kvG-JtCq0Bkd_XynViIsOtOnAhgmdSPkfr-oA\",\"audiences\":[\"talker-api\"]},\"status\":{\"user\":{}}}}\n{\"level\":\"debug\",\"ts\":1634830460.1509938,\"logger\":\"authorino.service.auth.authpipeline.identity\",\"msg\":\"cannot validate identity\",\"request id\":\"8157480586935853928\",\"config\":{\"Name\":\"api-keys\",\"ExtendedProperties\":[{\"Name\":\"sub\",\"Value\":{\"Static\":null,\"Pattern\":\"auth.identity.metadata.annotations.userid\"}}],\"OAuth2\":null,\"OIDC\":null,\"MTLS\":null,\"HMAC\":null,\"APIKey\":{\"AuthCredentials\":{\"KeySelector\":\"APIKEY\",\"In\":\"authorization_header\"},\"Name\":\"api-keys\",\"LabelSelectors\":{\"audience\":\"talker-api\",\"authorino.kuadrant.io/managed-by\":\"authorino\"}},\"KubernetesAuth\":null},\"reason\":\"credential not found\"}\n{\"level\":\"debug\",\"ts\":1634830460.1517606,\"logger\":\"authorino.service.auth.authpipeline.identity.oauth2\",\"msg\":\"sending token introspection request\",\"request id\":\"8157480586935853928\",\"url\":\"http://talker-api:523b92b6-625d-4e1e-a313-77e7a8ae4e88@keycloak:8080/realms/kuadrant/protocol/openid-connect/token/introspect\",\"data\":\"token=eyJhbGciOiJSUzI1NiIsImtpZCI6IkRsVWJZMENyVy1sZ0tFMVRMd19pcTFUWGtTYUl6T0hyWks0VHhKYnpEZUUifQ.eyJhdWQiOlsidGFsa2VyLWFwaSJdLCJleHAiOjE2MzQ4MzEwNTEsImlhdCI6MTYzNDgzMDQ1MSwiaXNzIjoiaHR0cHM6Ly9rdWJlcm5ldGVzLmRlZmF1bHQuc3ZjLmNsdXN0ZXIubG9jYWwiLCJrdWJlcm5ldGVzLmlvIjp7Im5hbWVzcGFjZSI6ImF1dGhvcmlubyIsInNlcnZpY2VhY2NvdW50Ijp7Im5hbWUiOiJhcGktY29uc3VtZXItMSIsInVpZCI6ImI0MGY1MzFjLWVjYWItNGYzMS1hNDk2LTJlYmM3MmFkZDEyMSJ9fSwibmJmIjoxNjM0ODMwNDUxLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6YXV0aG9yaW5vOmFwaS1jb25zdW1lci0xIn0.PaP0vqdl5DPfErr84KfVhPdlsGAPgsw0NkDaA9rne1zXjzcO7KPPbXhFwZC-oIjSGG1HfRMSoQeCXbQz24PSATmX8l1T52a9IFeXgP7sQmXZIDbiPfTm3X09kIIlfPKHhK_f-jQwRIpMRqNgLntlZ-xXX3P1fOBBUYR8obTPAQ6NDDaLHxw2SAmHFTQWjM_DInPDemXX0mEm7nCPKifsNxHaQH4wx4CD3LCLGbCI9FHNf2Crid8mmGJXf4wzcH1VuKkpUlsmnlUgTG2bfT2lbhSF2lBmrrhTJyYk6_aA09DwL4Bf4kvG-JtCq0Bkd_XynViIsOtOnAhgmdSPkfr-oA&amp;token_type_hint=requesting_party_token\"}\n{\"level\":\"debug\",\"ts\":1634830460.1620777,\"logger\":\"authorino.service.auth.authpipeline.identity\",\"msg\":\"identity validated\",\"request id\":\"8157480586935853928\",\"config\":{\"Name\":\"k8s-service-accounts\",\"ExtendedProperties\":[],\"OAuth2\":null,\"OIDC\":null,\"MTLS\":null,\"HMAC\":null,\"APIKey\":null,\"KubernetesAuth\":{\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"}}},\"object\":{\"aud\":[\"talker-api\"],\"exp\":1634831051,\"iat\":1634830451,\"iss\":\"https://kubernetes.default.svc.cluster.local\",\"kubernetes.io\":{\"namespace\":\"authorino\",\"serviceaccount\":{\"name\":\"api-consumer-1\",\"uid\":\"b40f531c-ecab-4f31-a496-2ebc72add121\"}},\"nbf\":1634830451,\"sub\":\"system:serviceaccount:authorino:api-consumer-1\"}}\n{\"level\":\"debug\",\"ts\":1634830460.1622565,\"logger\":\"authorino.service.auth.authpipeline.metadata.uma\",\"msg\":\"requesting pat\",\"request id\":\"8157480586935853928\",\"url\":\"http://talker-api:523b92b6-625d-4e1e-a313-77e7a8ae4e88@keycloak:8080/realms/kuadrant/protocol/openid-connect/token\",\"data\":\"grant_type=client_credentials\",\"headers\":{\"Content-Type\":[\"application/x-www-form-urlencoded\"]}}\n{\"level\":\"debug\",\"ts\":1634830460.1670353,\"logger\":\"authorino.service.auth.authpipeline.metadata.http\",\"msg\":\"sending request\",\"request id\":\"8157480586935853928\",\"method\":\"GET\",\"url\":\"http://talker-api.default.svc.cluster.local:3000/metadata?encoding=text/plain&amp;original_path=/hello\",\"headers\":{\"Content-Type\":[\"text/plain\"]}}\n{\"level\":\"debug\",\"ts\":1634830460.169326,\"logger\":\"authorino.service.auth.authpipeline.metadata\",\"msg\":\"cannot fetch metadata\",\"request id\":\"8157480586935853928\",\"config\":{\"Name\":\"oidc-userinfo\",\"UserInfo\":{\"OIDC\":{\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"},\"Endpoint\":\"http://keycloak:8080/realms/kuadrant\"}},\"UMA\":null,\"GenericHTTP\":null},\"reason\":\"Missing identity for OIDC issuer http://keycloak:8080/realms/kuadrant. Skipping related UserInfo metadata.\"}\n{\"level\":\"debug\",\"ts\":1634830460.1753876,\"logger\":\"authorino.service.auth.authpipeline.metadata\",\"msg\":\"fetched auth metadata\",\"request id\":\"8157480586935853928\",\"config\":{\"Name\":\"http-metadata\",\"UserInfo\":null,\"UMA\":null,\"GenericHTTP\":{\"Endpoint\":\"http://talker-api.default.svc.cluster.local:3000/metadata?encoding=text/plain&amp;original_path={context.request.http.path}\",\"Method\":\"GET\",\"Parameters\":[],\"ContentType\":\"application/x-www-form-urlencoded\",\"SharedSecret\":\"\",\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"}}},\"object\":{\"body\":\"\",\"headers\":{\"Accept-Encoding\":\"gzip\",\"Content-Type\":\"text/plain\",\"Host\":\"talker-api.default.svc.cluster.local:3000\",\"User-Agent\":\"Go-http-client/1.1\",\"Version\":\"HTTP/1.1\"},\"method\":\"GET\",\"path\":\"/metadata\",\"query_string\":\"encoding=text/plain&amp;original_path=/hello\",\"uuid\":\"1aa6ac66-3179-4351-b1a7-7f6a761d5b61\"}}\n{\"level\":\"debug\",\"ts\":1634830460.2331996,\"logger\":\"authorino.service.auth.authpipeline.metadata.uma\",\"msg\":\"querying resources by uri\",\"request id\":\"8157480586935853928\",\"url\":\"http://keycloak:8080/realms/kuadrant/authz/protection/resource_set?uri=/hello\"}\n{\"level\":\"debug\",\"ts\":1634830460.2495668,\"logger\":\"authorino.service.auth.authpipeline.metadata.uma\",\"msg\":\"getting resource data\",\"request id\":\"8157480586935853928\",\"url\":\"http://keycloak:8080/realms/kuadrant/authz/protection/resource_set/e20d194c-274c-4845-8c02-0ca413c9bf18\"}\n{\"level\":\"debug\",\"ts\":1634830460.2927864,\"logger\":\"authorino.service.auth.authpipeline.metadata\",\"msg\":\"fetched auth metadata\",\"request id\":\"8157480586935853928\",\"config\":{\"Name\":\"uma-resource-registry\",\"UserInfo\":null,\"UMA\":{\"Endpoint\":\"http://keycloak:8080/realms/kuadrant\",\"ClientID\":\"talker-api\",\"ClientSecret\":\"523b92b6-625d-4e1e-a313-77e7a8ae4e88\"},\"GenericHTTP\":null},\"object\":[{\"_id\":\"e20d194c-274c-4845-8c02-0ca413c9bf18\",\"attributes\":{},\"displayName\":\"hello\",\"name\":\"hello\",\"owner\":{\"id\":\"57a645a5-fb67-438b-8be5-dfb971666dbc\"},\"ownerManagedAccess\":false,\"resource_scopes\":[],\"uris\":[\"/hi\",\"/hello\"]}]}\n{\"level\":\"debug\",\"ts\":1634830460.2930083,\"logger\":\"authorino.service.auth.authpipeline.authorization\",\"msg\":\"evaluating for input\",\"request id\":\"8157480586935853928\",\"input\":{\"context\":{\"source\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":53144}}}}},\"destination\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":8000}}}}},\"request\":{\"time\":{\"seconds\":1634830460,\"nanos\":147259000},\"http\":{\"id\":\"8157480586935853928\",\"method\":\"GET\",\"headers\":{\":authority\":\"talker-api\",\":method\":\"GET\",\":path\":\"/hello\",\":scheme\":\"http\",\"accept\":\"*/*\",\"authorization\":\"Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IkRsVWJZMENyVy1sZ0tFMVRMd19pcTFUWGtTYUl6T0hyWks0VHhKYnpEZUUifQ.eyJhdWQiOlsidGFsa2VyLWFwaSJdLCJleHAiOjE2MzQ4MzEwNTEsImlhdCI6MTYzNDgzMDQ1MSwiaXNzIjoiaHR0cHM6Ly9rdWJlcm5ldGVzLmRlZmF1bHQuc3ZjLmNsdXN0ZXIubG9jYWwiLCJrdWJlcm5ldGVzLmlvIjp7Im5hbWVzcGFjZSI6ImF1dGhvcmlubyIsInNlcnZpY2VhY2NvdW50Ijp7Im5hbWUiOiJhcGktY29uc3VtZXItMSIsInVpZCI6ImI0MGY1MzFjLWVjYWItNGYzMS1hNDk2LTJlYmM3MmFkZDEyMSJ9fSwibmJmIjoxNjM0ODMwNDUxLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6YXV0aG9yaW5vOmFwaS1jb25zdW1lci0xIn0.PaP0vqdl5DPfErr84KfVhPdlsGAPgsw0NkDaA9rne1zXjzcO7KPPbXhFwZC-oIjSGG1HfRMSoQeCXbQz24PSATmX8l1T52a9IFeXgP7sQmXZIDbiPfTm3X09kIIlfPKHhK_f-jQwRIpMRqNgLntlZ-xXX3P1fOBBUYR8obTPAQ6NDDaLHxw2SAmHFTQWjM_DInPDemXX0mEm7nCPKifsNxHaQH4wx4CD3LCLGbCI9FHNf2Crid8mmGJXf4wzcH1VuKkpUlsmnlUgTG2bfT2lbhSF2lBmrrhTJyYk6_aA09DwL4Bf4kvG-JtCq0Bkd_XynViIsOtOnAhgmdSPkfr-oA\",\"user-agent\":\"curl/7.65.3\",\"x-envoy-internal\":\"true\",\"x-forwarded-for\":\"10.244.0.11\",\"x-forwarded-proto\":\"http\",\"x-request-id\":\"4c5d5c97-e15b-46a3-877a-d8188e09e08f\"},\"path\":\"/hello\",\"host\":\"talker-api\",\"scheme\":\"http\",\"protocol\":\"HTTP/1.1\"}},\"context_extensions\":{\"virtual_host\":\"local_service\"},\"metadata_context\":{}},\"auth\":{\"identity\":{\"aud\":[\"talker-api\"],\"exp\":1634831051,\"iat\":1634830451,\"iss\":\"https://kubernetes.default.svc.cluster.local\",\"kubernetes.io\":{\"namespace\":\"authorino\",\"serviceaccount\":{\"name\":\"api-consumer-1\",\"uid\":\"b40f531c-ecab-4f31-a496-2ebc72add121\"}},\"nbf\":1634830451,\"sub\":\"system:serviceaccount:authorino:api-consumer-1\"},\"metadata\":{\"http-metadata\":{\"body\":\"\",\"headers\":{\"Accept-Encoding\":\"gzip\",\"Content-Type\":\"text/plain\",\"Host\":\"talker-api.default.svc.cluster.local:3000\",\"User-Agent\":\"Go-http-client/1.1\",\"Version\":\"HTTP/1.1\"},\"method\":\"GET\",\"path\":\"/metadata\",\"query_string\":\"encoding=text/plain&amp;original_path=/hello\",\"uuid\":\"1aa6ac66-3179-4351-b1a7-7f6a761d5b61\"},\"uma-resource-registry\":[{\"_id\":\"e20d194c-274c-4845-8c02-0ca413c9bf18\",\"attributes\":{},\"displayName\":\"hello\",\"name\":\"hello\",\"owner\":{\"id\":\"57a645a5-fb67-438b-8be5-dfb971666dbc\"},\"ownerManagedAccess\":false,\"resource_scopes\":[],\"uris\":[\"/hi\",\"/hello\"]}]}}}}\n{\"level\":\"debug\",\"ts\":1634830460.2955465,\"logger\":\"authorino.service.auth.authpipeline.authorization.kubernetesauthz\",\"msg\":\"calling kubernetes subject access review api\",\"request id\":\"8157480586935853928\",\"subjectaccessreview\":{\"metadata\":{\"creationTimestamp\":null},\"spec\":{\"nonResourceAttributes\":{\"path\":\"/hello\",\"verb\":\"get\"},\"user\":\"system:serviceaccount:authorino:api-consumer-1\"},\"status\":{\"allowed\":false}}}\n{\"level\":\"debug\",\"ts\":1634830460.2986183,\"logger\":\"authorino.service.auth.authpipeline.authorization\",\"msg\":\"access granted\",\"request id\":\"8157480586935853928\",\"config\":{\"Name\":\"my-policy\",\"OPA\":{\"Rego\":\"fail := input.context.request.http.headers[\\\"x-ext-auth-mock\\\"] == \\\"FAIL\\\"\\nallow { not fail }\\n\",\"OPAExternalSource\":{\"Endpoint\":\"\",\"SharedSecret\":\"\",\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"}}},\"JSON\":null,\"KubernetesAuthz\":null},\"object\":true}\n{\"level\":\"debug\",\"ts\":1634830460.3044975,\"logger\":\"authorino.service.auth.authpipeline.authorization\",\"msg\":\"access granted\",\"request id\":\"8157480586935853928\",\"config\":{\"Name\":\"kubernetes-rbac\",\"OPA\":null,\"JSON\":null,\"KubernetesAuthz\":{\"Conditions\":[],\"User\":{\"Static\":\"\",\"Pattern\":\"auth.identity.user.username\"},\"Groups\":null,\"ResourceAttributes\":null}},\"object\":true}\n{\"level\":\"debug\",\"ts\":1634830460.3052874,\"logger\":\"authorino.service.auth.authpipeline.response\",\"msg\":\"dynamic response built\",\"request id\":\"8157480586935853928\",\"config\":{\"Name\":\"wristband\",\"Wrapper\":\"httpHeader\",\"WrapperKey\":\"x-ext-auth-wristband\",\"Wristband\":{\"Issuer\":\"https://authorino-oidc.default.svc:8083/default/talker-api-protection/wristband\",\"CustomClaims\":[],\"TokenDuration\":300,\"SigningKeys\":[{\"use\":\"sig\",\"kty\":\"EC\",\"kid\":\"wristband-signing-key\",\"crv\":\"P-256\",\"alg\":\"ES256\",\"x\":\"TJf5NLVKplSYp95TOfhVPqvxvEibRyjrUZwwtpDuQZw\",\"y\":\"SSg8rKBsJ3J1LxyLtt0oFvhHvZcUpmRoTuHk3UHisTA\",\"d\":\"Me-5_zWBWVYajSGZcZMCcD8dXEa4fy85zv_yN7BxW-o\"}]},\"DynamicJSON\":null},\"object\":\"eyJhbGciOiJFUzI1NiIsImtpZCI6IndyaXN0YmFuZC1zaWduaW5nLWtleSIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MzQ4MzA3NjAsImlhdCI6MTYzNDgzMDQ2MCwiaXNzIjoiaHR0cHM6Ly9hdXRob3Jpbm8tb2lkYy5hdXRob3Jpbm8uc3ZjOjgwODMvYXV0aG9yaW5vL3RhbGtlci1hcGktcHJvdGVjdGlvbi93cmlzdGJhbmQiLCJzdWIiOiI4NDliMDk0ZDA4MzU0ZjM0MjA4ZGI3MjBmYWZmODlmNmM3NmYyOGY3MTcxOWI4NTQ3ZDk5NWNlNzAwMjU2ZGY4In0.Jn-VB5Q_0EX1ed1ji4KvhO4DlMqZeIl5H0qlukbTyYkp-Pgb4SnPGSbYWp5_uvG8xllsFAA5nuyBIXeba-dbkw\"}\n{\"level\":\"info\",\"ts\":1634830460.3054585,\"logger\":\"authorino.service.auth\",\"msg\":\"outgoing authorization response\",\"request id\":\"8157480586935853928\",\"authorized\":true,\"response\":\"OK\"}\n{\"level\":\"debug\",\"ts\":1634830460.305476,\"logger\":\"authorino.service.auth\",\"msg\":\"outgoing authorization response\",\"request id\":\"8157480586935853928\",\"authorized\":true,\"response\":\"OK\"}\n</code></pre> Enforcing an AuthConfig with authentication based on API keys <p></p> <ul> <li>identity: k8s-auth, oidc, oauth2, apikey</li> <li>metadata: http, oidc userinfo</li> <li>authorization: opa, k8s-authz</li> <li>response: wristband</li> </ul> <pre><code>{\"level\":\"info\",\"ts\":1634830413.2425854,\"logger\":\"authorino.service.auth\",\"msg\":\"incoming authorization request\",\"request id\":\"7199257136822741594\",\"object\":{\"source\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":52702}}}}},\"destination\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":8000}}}}},\"request\":{\"http\":{\"id\":\"7199257136822741594\",\"method\":\"GET\",\"path\":\"/hello\",\"host\":\"talker-api\",\"scheme\":\"http\"}}}}\n{\"level\":\"debug\",\"ts\":1634830413.2426975,\"logger\":\"authorino.service.auth\",\"msg\":\"incoming authorization request\",\"request id\":\"7199257136822741594\",\"object\":{\"source\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":52702}}}}},\"destination\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":8000}}}}},\"request\":{\"time\":{\"seconds\":1634830413,\"nanos\":240094000},\"http\":{\"id\":\"7199257136822741594\",\"method\":\"GET\",\"headers\":{\":authority\":\"talker-api\",\":method\":\"GET\",\":path\":\"/hello\",\":scheme\":\"http\",\"accept\":\"*/*\",\"authorization\":\"APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\",\"user-agent\":\"curl/7.65.3\",\"x-envoy-internal\":\"true\",\"x-forwarded-for\":\"10.244.0.11\",\"x-forwarded-proto\":\"http\",\"x-request-id\":\"d38f5e66-bd72-4733-95d1-3179315cdd60\"},\"path\":\"/hello\",\"host\":\"talker-api\",\"scheme\":\"http\",\"protocol\":\"HTTP/1.1\"}},\"context_extensions\":{\"virtual_host\":\"local_service\"},\"metadata_context\":{}}}\n{\"level\":\"debug\",\"ts\":1634830413.2428744,\"logger\":\"authorino.service.auth.authpipeline.identity\",\"msg\":\"cannot validate identity\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"k8s-service-accounts\",\"ExtendedProperties\":[],\"OAuth2\":null,\"OIDC\":null,\"MTLS\":null,\"HMAC\":null,\"APIKey\":null,\"KubernetesAuth\":{\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"}}},\"reason\":\"credential not found\"}\n{\"level\":\"debug\",\"ts\":1634830413.2434332,\"logger\":\"authorino.service.auth.authpipeline\",\"msg\":\"skipping config\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"keycloak-jwts\",\"ExtendedProperties\":[],\"OAuth2\":null,\"OIDC\":{\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"},\"Endpoint\":\"http://keycloak:8080/realms/kuadrant\"},\"MTLS\":null,\"HMAC\":null,\"APIKey\":null,\"KubernetesAuth\":null},\"reason\":\"context canceled\"}\n{\"level\":\"debug\",\"ts\":1634830413.2479305,\"logger\":\"authorino.service.auth.authpipeline.identity\",\"msg\":\"identity validated\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"api-keys\",\"ExtendedProperties\":[{\"Name\":\"sub\",\"Value\":{\"Static\":null,\"Pattern\":\"auth.identity.metadata.annotations.userid\"}}],\"OAuth2\":null,\"OIDC\":null,\"MTLS\":null,\"HMAC\":null,\"APIKey\":{\"AuthCredentials\":{\"KeySelector\":\"APIKEY\",\"In\":\"authorization_header\"},\"Name\":\"api-keys\",\"LabelSelectors\":{\"audience\":\"talker-api\",\"authorino.kuadrant.io/managed-by\":\"authorino\"}},\"KubernetesAuth\":null},\"object\":{\"apiVersion\":\"v1\",\"data\":{\"api_key\":\"bmR5QnpyZVV6RjR6cURRc3FTUE1Ia1JocmlFT3RjUng=\"},\"kind\":\"Secret\",\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"v1\\\",\\\"kind\\\":\\\"Secret\\\",\\\"metadata\\\":{\\\"annotations\\\":{\\\"userid\\\":\\\"john\\\"},\\\"labels\\\":{\\\"audience\\\":\\\"talker-api\\\",\\\"authorino.kuadrant.io/managed-by\\\":\\\"authorino\\\"},\\\"name\\\":\\\"api-key-1\\\",\\\"namespace\\\":\\\"authorino\\\"},\\\"stringData\\\":{\\\"api_key\\\":\\\"ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\\\"},\\\"type\\\":\\\"Opaque\\\"}\\n\",\"userid\":\"john\"},\"creationTimestamp\":\"2021-10-21T14:45:54Z\",\"labels\":{\"audience\":\"talker-api\",\"authorino.kuadrant.io/managed-by\":\"authorino\"},\"managedFields\":[{\"apiVersion\":\"v1\",\"fieldsType\":\"FieldsV1\",\"fieldsV1\":{\"f:data\":{\".\":{},\"f:api_key\":{}},\"f:metadata\":{\"f:annotations\":{\".\":{},\"f:kubectl.kubernetes.io/last-applied-configuration\":{},\"f:userid\":{}},\"f:labels\":{\".\":{},\"f:audience\":{},\"f:authorino.kuadrant.io/managed-by\":{}}},\"f:type\":{}},\"manager\":\"kubectl-client-side-apply\",\"operation\":\"Update\",\"time\":\"2021-10-21T14:45:54Z\"}],\"name\":\"api-key-1\",\"namespace\":\"authorino\",\"resourceVersion\":\"8979\",\"uid\":\"c369852a-7e1a-43bd-94ca-e2b3f617052e\"},\"sub\":\"john\",\"type\":\"Opaque\"}}\n{\"level\":\"debug\",\"ts\":1634830413.248768,\"logger\":\"authorino.service.auth.authpipeline.metadata.http\",\"msg\":\"sending request\",\"request id\":\"7199257136822741594\",\"method\":\"GET\",\"url\":\"http://talker-api.default.svc.cluster.local:3000/metadata?encoding=text/plain&amp;original_path=/hello\",\"headers\":{\"Content-Type\":[\"text/plain\"]}}\n{\"level\":\"debug\",\"ts\":1634830413.2496722,\"logger\":\"authorino.service.auth.authpipeline.metadata\",\"msg\":\"cannot fetch metadata\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"oidc-userinfo\",\"UserInfo\":{\"OIDC\":{\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"},\"Endpoint\":\"http://keycloak:8080/realms/kuadrant\"}},\"UMA\":null,\"GenericHTTP\":null},\"reason\":\"Missing identity for OIDC issuer http://keycloak:8080/realms/kuadrant. Skipping related UserInfo metadata.\"}\n{\"level\":\"debug\",\"ts\":1634830413.2497928,\"logger\":\"authorino.service.auth.authpipeline.metadata.uma\",\"msg\":\"requesting pat\",\"request id\":\"7199257136822741594\",\"url\":\"http://talker-api:523b92b6-625d-4e1e-a313-77e7a8ae4e88@keycloak:8080/realms/kuadrant/protocol/openid-connect/token\",\"data\":\"grant_type=client_credentials\",\"headers\":{\"Content-Type\":[\"application/x-www-form-urlencoded\"]}}\n{\"level\":\"debug\",\"ts\":1634830413.258932,\"logger\":\"authorino.service.auth.authpipeline.metadata\",\"msg\":\"fetched auth metadata\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"http-metadata\",\"UserInfo\":null,\"UMA\":null,\"GenericHTTP\":{\"Endpoint\":\"http://talker-api.default.svc.cluster.local:3000/metadata?encoding=text/plain&amp;original_path={context.request.http.path}\",\"Method\":\"GET\",\"Parameters\":[],\"ContentType\":\"application/x-www-form-urlencoded\",\"SharedSecret\":\"\",\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"}}},\"object\":{\"body\":\"\",\"headers\":{\"Accept-Encoding\":\"gzip\",\"Content-Type\":\"text/plain\",\"Host\":\"talker-api.default.svc.cluster.local:3000\",\"User-Agent\":\"Go-http-client/1.1\",\"Version\":\"HTTP/1.1\"},\"method\":\"GET\",\"path\":\"/metadata\",\"query_string\":\"encoding=text/plain&amp;original_path=/hello\",\"uuid\":\"97529f8c-587b-4121-a4db-cd90c63871fd\"}}\n{\"level\":\"debug\",\"ts\":1634830413.2945344,\"logger\":\"authorino.service.auth.authpipeline.metadata.uma\",\"msg\":\"querying resources by uri\",\"request id\":\"7199257136822741594\",\"url\":\"http://keycloak:8080/realms/kuadrant/authz/protection/resource_set?uri=/hello\"}\n{\"level\":\"debug\",\"ts\":1634830413.3123596,\"logger\":\"authorino.service.auth.authpipeline.metadata.uma\",\"msg\":\"getting resource data\",\"request id\":\"7199257136822741594\",\"url\":\"http://keycloak:8080/realms/kuadrant/authz/protection/resource_set/e20d194c-274c-4845-8c02-0ca413c9bf18\"}\n{\"level\":\"debug\",\"ts\":1634830413.3340268,\"logger\":\"authorino.service.auth.authpipeline.metadata\",\"msg\":\"fetched auth metadata\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"uma-resource-registry\",\"UserInfo\":null,\"UMA\":{\"Endpoint\":\"http://keycloak:8080/realms/kuadrant\",\"ClientID\":\"talker-api\",\"ClientSecret\":\"523b92b6-625d-4e1e-a313-77e7a8ae4e88\"},\"GenericHTTP\":null},\"object\":[{\"_id\":\"e20d194c-274c-4845-8c02-0ca413c9bf18\",\"attributes\":{},\"displayName\":\"hello\",\"name\":\"hello\",\"owner\":{\"id\":\"57a645a5-fb67-438b-8be5-dfb971666dbc\"},\"ownerManagedAccess\":false,\"resource_scopes\":[],\"uris\":[\"/hi\",\"/hello\"]}]}\n{\"level\":\"debug\",\"ts\":1634830413.3367748,\"logger\":\"authorino.service.auth.authpipeline.authorization\",\"msg\":\"evaluating for input\",\"request id\":\"7199257136822741594\",\"input\":{\"context\":{\"source\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":52702}}}}},\"destination\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":8000}}}}},\"request\":{\"time\":{\"seconds\":1634830413,\"nanos\":240094000},\"http\":{\"id\":\"7199257136822741594\",\"method\":\"GET\",\"headers\":{\":authority\":\"talker-api\",\":method\":\"GET\",\":path\":\"/hello\",\":scheme\":\"http\",\"accept\":\"*/*\",\"authorization\":\"APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\",\"user-agent\":\"curl/7.65.3\",\"x-envoy-internal\":\"true\",\"x-forwarded-for\":\"10.244.0.11\",\"x-forwarded-proto\":\"http\",\"x-request-id\":\"d38f5e66-bd72-4733-95d1-3179315cdd60\"},\"path\":\"/hello\",\"host\":\"talker-api\",\"scheme\":\"http\",\"protocol\":\"HTTP/1.1\"}},\"context_extensions\":{\"virtual_host\":\"local_service\"},\"metadata_context\":{}},\"auth\":{\"identity\":{\"apiVersion\":\"v1\",\"data\":{\"api_key\":\"bmR5QnpyZVV6RjR6cURRc3FTUE1Ia1JocmlFT3RjUng=\"},\"kind\":\"Secret\",\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"v1\\\",\\\"kind\\\":\\\"Secret\\\",\\\"metadata\\\":{\\\"annotations\\\":{\\\"userid\\\":\\\"john\\\"},\\\"labels\\\":{\\\"audience\\\":\\\"talker-api\\\",\\\"authorino.kuadrant.io/managed-by\\\":\\\"authorino\\\"},\\\"name\\\":\\\"api-key-1\\\",\\\"namespace\\\":\\\"authorino\\\"},\\\"stringData\\\":{\\\"api_key\\\":\\\"ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\\\"},\\\"type\\\":\\\"Opaque\\\"}\\n\",\"userid\":\"john\"},\"creationTimestamp\":\"2021-10-21T14:45:54Z\",\"labels\":{\"audience\":\"talker-api\",\"authorino.kuadrant.io/managed-by\":\"authorino\"},\"managedFields\":[{\"apiVersion\":\"v1\",\"fieldsType\":\"FieldsV1\",\"fieldsV1\":{\"f:data\":{\".\":{},\"f:api_key\":{}},\"f:metadata\":{\"f:annotations\":{\".\":{},\"f:kubectl.kubernetes.io/last-applied-configuration\":{},\"f:userid\":{}},\"f:labels\":{\".\":{},\"f:audience\":{},\"f:authorino.kuadrant.io/managed-by\":{}}},\"f:type\":{}},\"manager\":\"kubectl-client-side-apply\",\"operation\":\"Update\",\"time\":\"2021-10-21T14:45:54Z\"}],\"name\":\"api-key-1\",\"namespace\":\"authorino\",\"resourceVersion\":\"8979\",\"uid\":\"c369852a-7e1a-43bd-94ca-e2b3f617052e\"},\"sub\":\"john\",\"type\":\"Opaque\"},\"metadata\":{\"http-metadata\":{\"body\":\"\",\"headers\":{\"Accept-Encoding\":\"gzip\",\"Content-Type\":\"text/plain\",\"Host\":\"talker-api.default.svc.cluster.local:3000\",\"User-Agent\":\"Go-http-client/1.1\",\"Version\":\"HTTP/1.1\"},\"method\":\"GET\",\"path\":\"/metadata\",\"query_string\":\"encoding=text/plain&amp;original_path=/hello\",\"uuid\":\"97529f8c-587b-4121-a4db-cd90c63871fd\"},\"uma-resource-registry\":[{\"_id\":\"e20d194c-274c-4845-8c02-0ca413c9bf18\",\"attributes\":{},\"displayName\":\"hello\",\"name\":\"hello\",\"owner\":{\"id\":\"57a645a5-fb67-438b-8be5-dfb971666dbc\"},\"ownerManagedAccess\":false,\"resource_scopes\":[],\"uris\":[\"/hi\",\"/hello\"]}]}}}}\n{\"level\":\"debug\",\"ts\":1634830413.339894,\"logger\":\"authorino.service.auth.authpipeline.authorization\",\"msg\":\"access granted\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"my-policy\",\"OPA\":{\"Rego\":\"fail := input.context.request.http.headers[\\\"x-ext-auth-mock\\\"] == \\\"FAIL\\\"\\nallow { not fail }\\n\",\"OPAExternalSource\":{\"Endpoint\":\"\",\"SharedSecret\":\"\",\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"}}},\"JSON\":null,\"KubernetesAuthz\":null},\"object\":true}\n{\"level\":\"debug\",\"ts\":1634830413.3444238,\"logger\":\"authorino.service.auth.authpipeline.authorization.kubernetesauthz\",\"msg\":\"calling kubernetes subject access review api\",\"request id\":\"7199257136822741594\",\"subjectaccessreview\":{\"metadata\":{\"creationTimestamp\":null},\"spec\":{\"nonResourceAttributes\":{\"path\":\"/hello\",\"verb\":\"get\"},\"user\":\"john\"},\"status\":{\"allowed\":false}}}\n{\"level\":\"debug\",\"ts\":1634830413.3547812,\"logger\":\"authorino.service.auth.authpipeline.authorization\",\"msg\":\"access granted\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"kubernetes-rbac\",\"OPA\":null,\"JSON\":null,\"KubernetesAuthz\":{\"Conditions\":[],\"User\":{\"Static\":\"\",\"Pattern\":\"auth.identity.user.username\"},\"Groups\":null,\"ResourceAttributes\":null}},\"object\":true}\n{\"level\":\"debug\",\"ts\":1634830413.3558292,\"logger\":\"authorino.service.auth.authpipeline.response\",\"msg\":\"dynamic response built\",\"request id\":\"7199257136822741594\",\"config\":{\"Name\":\"wristband\",\"Wrapper\":\"httpHeader\",\"WrapperKey\":\"x-ext-auth-wristband\",\"Wristband\":{\"Issuer\":\"https://authorino-oidc.default.svc:8083/default/talker-api-protection/wristband\",\"CustomClaims\":[],\"TokenDuration\":300,\"SigningKeys\":[{\"use\":\"sig\",\"kty\":\"EC\",\"kid\":\"wristband-signing-key\",\"crv\":\"P-256\",\"alg\":\"ES256\",\"x\":\"TJf5NLVKplSYp95TOfhVPqvxvEibRyjrUZwwtpDuQZw\",\"y\":\"SSg8rKBsJ3J1LxyLtt0oFvhHvZcUpmRoTuHk3UHisTA\",\"d\":\"Me-5_zWBWVYajSGZcZMCcD8dXEa4fy85zv_yN7BxW-o\"}]},\"DynamicJSON\":null},\"object\":\"eyJhbGciOiJFUzI1NiIsImtpZCI6IndyaXN0YmFuZC1zaWduaW5nLWtleSIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MzQ4MzA3MTMsImlhdCI6MTYzNDgzMDQxMywiaXNzIjoiaHR0cHM6Ly9hdXRob3Jpbm8tb2lkYy5hdXRob3Jpbm8uc3ZjOjgwODMvYXV0aG9yaW5vL3RhbGtlci1hcGktcHJvdGVjdGlvbi93cmlzdGJhbmQiLCJzdWIiOiI5NjhiZjViZjk3MDM3NWRiNjE0ZDFhMDgzZTg2NTBhYTVhMGVhMzAyOTdiYmJjMTBlNWVlMWZmYTkxYTYwZmY4In0.7G440sWgi2TIaxrGJf5KWR9UOFpNTjwVYeaJXFLzsLhVNICoMLbYzBAEo4M3ym1jipxxTVeE7anm4qDDc7cnVQ\"}\n{\"level\":\"info\",\"ts\":1634830413.3569078,\"logger\":\"authorino.service.auth\",\"msg\":\"outgoing authorization response\",\"request id\":\"7199257136822741594\",\"authorized\":true,\"response\":\"OK\"}\n{\"level\":\"debug\",\"ts\":1634830413.3569596,\"logger\":\"authorino.service.auth\",\"msg\":\"outgoing authorization response\",\"request id\":\"7199257136822741594\",\"authorized\":true,\"response\":\"OK\"}\n</code></pre> Enforcing an AuthConfig with authentication based on API keys (invalid API key) <p></p> <ul> <li>identity: k8s-auth, oidc, oauth2, apikey</li> <li>metadata: http, oidc userinfo</li> <li>authorization: opa, k8s-authz</li> <li>response: wristband</li> </ul> <pre><code>{\"level\":\"info\",\"ts\":1634830373.2066543,\"logger\":\"authorino.service.auth\",\"msg\":\"incoming authorization request\",\"request id\":\"12947265773116138711\",\"object\":{\"source\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":52288}}}}},\"destination\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":8000}}}}},\"request\":{\"http\":{\"id\":\"12947265773116138711\",\"method\":\"GET\",\"path\":\"/hello\",\"host\":\"talker-api\",\"scheme\":\"http\"}}}}\n{\"level\":\"debug\",\"ts\":1634830373.2068064,\"logger\":\"authorino.service.auth\",\"msg\":\"incoming authorization request\",\"request id\":\"12947265773116138711\",\"object\":{\"source\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":52288}}}}},\"destination\":{\"address\":{\"Address\":{\"SocketAddress\":{\"address\":\"127.0.0.1\",\"PortSpecifier\":{\"PortValue\":8000}}}}},\"request\":{\"time\":{\"seconds\":1634830373,\"nanos\":198329000},\"http\":{\"id\":\"12947265773116138711\",\"method\":\"GET\",\"headers\":{\":authority\":\"talker-api\",\":method\":\"GET\",\":path\":\"/hello\",\":scheme\":\"http\",\"accept\":\"*/*\",\"authorization\":\"APIKEY invalid\",\"user-agent\":\"curl/7.65.3\",\"x-envoy-internal\":\"true\",\"x-forwarded-for\":\"10.244.0.11\",\"x-forwarded-proto\":\"http\",\"x-request-id\":\"9e391846-afe4-489a-8716-23a2e1c1aa77\"},\"path\":\"/hello\",\"host\":\"talker-api\",\"scheme\":\"http\",\"protocol\":\"HTTP/1.1\"}},\"context_extensions\":{\"virtual_host\":\"local_service\"},\"metadata_context\":{}}}\n{\"level\":\"debug\",\"ts\":1634830373.2070816,\"logger\":\"authorino.service.auth.authpipeline.identity\",\"msg\":\"cannot validate identity\",\"request id\":\"12947265773116138711\",\"config\":{\"Name\":\"keycloak-opaque\",\"ExtendedProperties\":[],\"OAuth2\":{\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"},\"TokenIntrospectionUrl\":\"http://keycloak:8080/realms/kuadrant/protocol/openid-connect/token/introspect\",\"TokenTypeHint\":\"requesting_party_token\",\"ClientID\":\"talker-api\",\"ClientSecret\":\"523b92b6-625d-4e1e-a313-77e7a8ae4e88\"},\"OIDC\":null,\"MTLS\":null,\"HMAC\":null,\"APIKey\":null,\"KubernetesAuth\":null},\"reason\":\"credential not found\"}\n{\"level\":\"debug\",\"ts\":1634830373.207225,\"logger\":\"authorino.service.auth.authpipeline.identity\",\"msg\":\"cannot validate identity\",\"request id\":\"12947265773116138711\",\"config\":{\"Name\":\"api-keys\",\"ExtendedProperties\":[{\"Name\":\"sub\",\"Value\":{\"Static\":null,\"Pattern\":\"auth.identity.metadata.annotations.userid\"}}],\"OAuth2\":null,\"OIDC\":null,\"MTLS\":null,\"HMAC\":null,\"APIKey\":{\"AuthCredentials\":{\"KeySelector\":\"APIKEY\",\"In\":\"authorization_header\"},\"Name\":\"api-keys\",\"LabelSelectors\":{\"audience\":\"talker-api\",\"authorino.kuadrant.io/managed-by\":\"authorino\"}},\"KubernetesAuth\":null},\"reason\":\"the API Key provided is invalid\"}\n{\"level\":\"debug\",\"ts\":1634830373.2072473,\"logger\":\"authorino.service.auth.authpipeline.identity\",\"msg\":\"cannot validate identity\",\"request id\":\"12947265773116138711\",\"config\":{\"Name\":\"k8s-service-accounts\",\"ExtendedProperties\":[],\"OAuth2\":null,\"OIDC\":null,\"MTLS\":null,\"HMAC\":null,\"APIKey\":null,\"KubernetesAuth\":{\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"}}},\"reason\":\"credential not found\"}\n{\"level\":\"debug\",\"ts\":1634830373.2072592,\"logger\":\"authorino.service.auth.authpipeline.identity\",\"msg\":\"cannot validate identity\",\"request id\":\"12947265773116138711\",\"config\":{\"Name\":\"keycloak-jwts\",\"ExtendedProperties\":[],\"OAuth2\":null,\"OIDC\":{\"AuthCredentials\":{\"KeySelector\":\"Bearer\",\"In\":\"authorization_header\"},\"Endpoint\":\"http://keycloak:8080/realms/kuadrant\"},\"MTLS\":null,\"HMAC\":null,\"APIKey\":null,\"KubernetesAuth\":null},\"reason\":\"credential not found\"}\n{\"level\":\"info\",\"ts\":1634830373.2073083,\"logger\":\"authorino.service.auth\",\"msg\":\"outgoing authorization response\",\"request id\":\"12947265773116138711\",\"authorized\":false,\"response\":\"UNAUTHENTICATED\",\"object\":{\"code\":16,\"status\":302,\"message\":\"Redirecting to login\"}}\n{\"level\":\"debug\",\"ts\":1634830373.2073889,\"logger\":\"authorino.service.auth\",\"msg\":\"outgoing authorization response\",\"request id\":\"12947265773116138711\",\"authorized\":false,\"response\":\"UNAUTHENTICATED\",\"object\":{\"code\":16,\"status\":302,\"message\":\"Redirecting to login\",\"headers\":[{\"Location\":\"https://my-app.io/login\"}]}}\n</code></pre> Deleting an AuthConfig and 2 related API key secrets <pre><code>{\"level\":\"info\",\"ts\":1669221361.5032296,\"logger\":\"authorino.controller-runtime.manager.controller.secret\",\"msg\":\"resource reconciled\",\"secret\":\"default/api-key-1\"}\n{\"level\":\"info\",\"ts\":1669221361.5057878,\"logger\":\"authorino.controller-runtime.manager.controller.secret\",\"msg\":\"resource reconciled\",\"secret\":\"default/api-key-2\"}\n</code></pre> Shutting down the service <pre><code>{\"level\":\"info\",\"ts\":1669221635.0135982,\"logger\":\"authorino\",\"msg\":\"Stopping and waiting for non leader election runnables\"}\n{\"level\":\"info\",\"ts\":1669221635.0136683,\"logger\":\"authorino\",\"msg\":\"Stopping and waiting for leader election runnables\"}\n{\"level\":\"info\",\"ts\":1669221635.0135982,\"logger\":\"authorino\",\"msg\":\"Stopping and waiting for non leader election runnables\"}\n{\"level\":\"info\",\"ts\":1669221635.0136883,\"logger\":\"authorino\",\"msg\":\"Stopping and waiting for leader election runnables\"}\n{\"level\":\"info\",\"ts\":1669221635.0137057,\"logger\":\"authorino.controller.secret\",\"msg\":\"Shutdown signal received, waiting for all workers to finish\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\"}\n{\"level\":\"info\",\"ts\":1669221635.013724,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"Shutdown signal received, waiting for all workers to finish\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\"}\n{\"level\":\"info\",\"ts\":1669221635.01375,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"All workers finished\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\"}\n{\"level\":\"info\",\"ts\":1669221635.013752,\"logger\":\"authorino.controller.secret\",\"msg\":\"All workers finished\",\"reconciler group\":\"\",\"reconciler kind\":\"Secret\"}\n{\"level\":\"info\",\"ts\":1669221635.0137632,\"logger\":\"authorino\",\"msg\":\"Stopping and waiting for caches\"}\n{\"level\":\"info\",\"ts\":1669221635.013751,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"Shutdown signal received, waiting for all workers to finish\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\"}\n{\"level\":\"info\",\"ts\":1669221635.0137684,\"logger\":\"authorino.controller.authconfig\",\"msg\":\"All workers finished\",\"reconciler group\":\"authorino.kuadrant.io\",\"reconciler kind\":\"AuthConfig\"}\n{\"level\":\"info\",\"ts\":1669221635.0137722,\"logger\":\"authorino\",\"msg\":\"Stopping and waiting for caches\"}\n{\"level\":\"info\",\"ts\":1669221635.0138857,\"logger\":\"authorino\",\"msg\":\"Stopping and waiting for webhooks\"}\n{\"level\":\"info\",\"ts\":1669221635.0138955,\"logger\":\"authorino\",\"msg\":\"Wait completed, proceeding to shutdown the manager\"}\n{\"level\":\"info\",\"ts\":1669221635.0138893,\"logger\":\"authorino\",\"msg\":\"Stopping and waiting for webhooks\"}\n{\"level\":\"info\",\"ts\":1669221635.0139785,\"logger\":\"authorino\",\"msg\":\"Wait completed, proceeding to shutdown the manager\"}\n</code></pre>"},{"location":"authorino/docs/user-guides/observability/#tracing","title":"Tracing","text":""},{"location":"authorino/docs/user-guides/observability/#request-id","title":"Request ID","text":"<p>Processes related to the authorization request are identified and linked together by a request ID. The request ID can be:</p> <ul> <li>generated outside Authorino and passed in the authorization request \u2013 this is essentially the case of requests via GRPC authorization interface initiated by the Envoy;</li> <li>generated by Authorino \u2013 requests via Raw HTTP Authorization interface.</li> </ul>"},{"location":"authorino/docs/user-guides/observability/#propagation","title":"Propagation","text":"<p>Authorino propagates trace identifiers compatible with the W3C Trace Context format https://www.w3.org/TR/trace-context/ and user-defined baggage data in the W3C Baggage format https://www.w3.org/TR/baggage.</p>"},{"location":"authorino/docs/user-guides/observability/#log-tracing","title":"Log tracing","text":"<p>Most log messages associated with an authorization request include the <code>request id</code> value. This value can be used to match incoming request and corresponding outgoing response log messages, including at deep level when more fine-grained log details are enabled (<code>debug</code> level level).</p>"},{"location":"authorino/docs/user-guides/observability/#opentelemetry-integration","title":"OpenTelemetry integration","text":"<p>Integration with an OpenTelemetry collector can be enabled by supplying the <code>--tracing-service-endpoint</code> command-line flag (e.g. <code>authorino server --tracing-service-endpoint=http://jaeger:14268/api/traces</code>).</p> <p>The additional <code>--tracing-service-tags</code> command-line flag allow to specify fixed agent-level key-value tags for the trace signals emitted by Authorino (e.g. <code>authorino server --tracing-service-endpoint=... --tracing-service-tag=key1=value1 --tracing-service-tag=key2=value2</code>).</p> <p>Traces related to authorization requests are additionally tagged with the <code>authorino.request_id</code> attribute.</p>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/","title":"User guide: OpenID Connect Discovery and authentication with JWTs","text":"<p>Validate JSON Web Tokens (JWT) issued and signed by an OpenID Connect server; leverage OpenID Connect Discovery to automatically fetch JSON Web Key Sets (JWKS).</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 JWT verification</li> </ul> <p>Authorino validates JSON Web Tokens (JWT) issued by an OpenID Connect server that implements OpenID Connect Discovery. Authorino fetches the OpenID Connect configuration and JSON Web Key Set (JWKS) from the issuer endpoint, and verifies the JSON Web Signature (JWS) and time validity of the token.</p> <p>Important! Authorino does not implement OAuth2 grants nor OIDC authentication flows. As a common recommendation of good practice, obtaining and refreshing access tokens is for clients to negotiate directly with the auth servers and token issuers. Authorino will only validate those tokens using the parameters provided by the trusted issuer authorities.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"keycloak-kuadrant-realm\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#obtain-an-access-token-with-the-keycloak-server","title":"\u277b Obtain an access token with the Keycloak server","text":"<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=john' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#consume-the-api","title":"\u277c Consume the API","text":"<p>With a valid access token:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>With missing or invalid access token:</p> <pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: Bearer realm=\"keycloak-kuadrant-realm\"\n# x-ext-auth-reason: credential not found\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-jwt-authentication/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/oidc-rbac/","title":"User guide: OpenID Connect (OIDC) and Role-Based Access Control (RBAC) with Authorino and Keycloak","text":"<p>Combine OpenID Connect (OIDC) authentication and Role-Based Access Control (RBAC) authorization rules leveraging Keycloak and Authorino working together.</p> <p>In this user guide, you will learn via example how to implement a simple Role-Based Access Control (RBAC) system to protect endpoints of an API, with roles assigned to users of an Identity Provider (Keycloak) and carried within the access tokens as JSON Web Token (JWT) claims. Users authenticate with the IdP via OAuth2/OIDC flow and get their access tokens verified and validated by Authorino on every request. Moreover, Authorino reads the role bindings of the user and enforces the proper RBAC rules based upon the context.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 JWT verification</li> <li>Authorization \u2192 Pattern-matching authorization</li> </ul> <p>Check out as well the user guides about OpenID Connect Discovery and authentication with JWTs and Simple pattern-matching authorization policies.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/oidc-rbac/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/oidc-rbac/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-rbac/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-rbac/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-rbac/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-rbac/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>In this example, the Keycloak realm defines a few users and 2 realm roles: 'member' and 'admin'. When users authenticate to the Keycloak server by any of the supported OAuth2/OIDC flows, Keycloak adds to the access token JWT a claim <code>\"realm_access\": { \"roles\": array }</code> that holds the list of roles assigned to the user. Authorino will verify the JWT on requests to the API and read from that claim to enforce the following RBAC rules:</p> Path Method Role /resources[/*] GET / POST / PUT member /resources/{id} DELETE admin /admin[/*] * admin Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <p>Apply the AuthConfig:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n\n  authentication:\n    \"keycloak-kuadrant-realm\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n\n  patterns:\n    \"member-role\":\n\n    - selector: auth.identity.realm_access.roles\n      operator: incl\n      value: member\n    \"admin-role\":\n    - selector: auth.identity.realm_access.roles\n      operator: incl\n      value: admin\n\n  authorization:\n    # RBAC rule: 'member' role required for requests to /resources[/*]\n    \"rbac-resources-api\":\n      when:\n\n      - selector: context.request.http.path\n        operator: matches\n        value: ^/resources(/.*)?$\n      patternMatching:\n        patterns:\n        - patternRef: member-role\n\n    # RBAC rule: 'admin' role required for DELETE requests to /resources/{id}\n    \"rbac-delete-resource\":\n      when:\n\n      - selector: context.request.http.path\n        operator: matches\n        value: ^/resources/\\d+$\n      - selector: context.request.http.method\n        operator: eq\n        value: DELETE\n      patternMatching:\n        patterns:\n        - patternRef: admin-role\n\n    # RBAC rule: 'admin' role required for requests to /admin[/*]\n    \"rbac-admin-api\":\n      when:\n\n      - selector: context.request.http.path\n        operator: matches\n        value: ^/admin(/.*)?$\n      patternMatching:\n        patterns:\n        - patternRef: admin-role\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-rbac/#obtain-an-access-token-and-consume-the-api","title":"\u277b Obtain an access token and consume the API","text":""},{"location":"authorino/docs/user-guides/oidc-rbac/#obtain-an-access-token-and-consume-the-api-as-john-member","title":"Obtain an access token and consume the API as John (member)","text":"<p>Obtain an access token with the Keycloak server for John:</p> <p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster for the user John, who is assigned to the 'member' role:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=john' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p> <p>As John, send a <code>GET</code> request to /resources:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/resources -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As John, send a <code>DELETE</code> request to /resources/123:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/resources/123 -i\n# HTTP/1.1 403 Forbidden\n</code></pre> <p>As John, send a <code>GET</code> request to /admin/settings:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/admin/settings -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-rbac/#obtain-an-access-token-and-consume-the-api-as-jane-memberadmin","title":"Obtain an access token and consume the API as Jane (member/admin)","text":"<p>Obtain an access token from within the cluster for the user Jane, who is assigned to the 'member' and 'admin' roles:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>As Jane, send a <code>GET</code> request to /resources:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/resources -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As Jane, send a <code>DELETE</code> request to /resources/123:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/resources/123 -i\n# HTTP/1.1 200 OK\n</code></pre> <p>As Jane, send a <code>GET</code> request to /admin/settings:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/admin/settings -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-rbac/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/oidc-user-info/","title":"User guide: OpenID Connect UserInfo","text":"<p>Fetch user info for OpenID Connect ID tokens in request-time for extra metadata for your policies and online verification of token validity.</p> Authorino capabilities featured in this guide: <ul> <li>External auth metadata \u2192 OIDC UserInfo</li> <li>Identity verification &amp; authentication \u2192 JWT verification</li> <li>Authorization \u2192 Pattern-matching authorization</li> </ul> <p>Apart from possibly complementing information of the JWT, fetching OpenID Connect UserInfo in request-time can be particularly useful for remote checking the state of the session, as opposed to only verifying the JWT/JWS offline. Implementation requires an OpenID Connect issuer (<code>spec.identity.oidc</code>) configured in the same <code>AuthConfig</code>.</p> <p>Check out as well the user guide about OpenID Connect Discovery and authentication with JWTs.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/oidc-user-info/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/oidc-user-info/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-user-info/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-user-info/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-user-info/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-user-info/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"keycloak-kuadrant-realm\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n  metadata:\n    \"userinfo\":\n      userInfo:\n        identitySource: keycloak-kuadrant-realm\n  authorization:\n    \"active-tokens-only\":\n      patternMatching:\n        patterns:\n        - selector: \"auth.metadata.userinfo.email\" # user email expected from the userinfo instead of the jwt\n          operator: neq\n          value: \"\"\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-user-info/#obtain-an-access-token-with-the-keycloak-server","title":"\u277b Obtain an access token with the Keycloak server","text":"<p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster:</p> <pre><code>export $(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r '\"ACCESS_TOKEN=\"+.access_token,\"REFRESH_TOKEN=\"+.refresh_token')\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p>"},{"location":"authorino/docs/user-guides/oidc-user-info/#consume-the-api","title":"\u277c Consume the API","text":"<p>With a valid access token:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>Revoke the access token and try to consume the API again:</p> <pre><code>kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/logout -H \"Content-Type: application/x-www-form-urlencoded\" -d \"refresh_token=$REFRESH_TOKEN\" -d 'token_type_hint=requesting_party_token' -u demo:\n</code></pre> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"authorino/docs/user-guides/oidc-user-info/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/opa-authorization/","title":"User guide: Open Policy Agent (OPA) Rego policies","text":"<p>Leverage the power of Open Policy Agent (OPA) policies, evaluated against Authorino's Authorization JSON in a built-in runtime compiled together with Authorino; pre-cache policies defined in Rego language inline or fetched from an external policy registry.</p> Authorino capabilities featured in this guide: <ul> <li>Authorization \u2192 Open Policy Agent (OPA) Rego policies</li> <li>Identity verification &amp; authentication \u2192 API key</li> </ul> <p>Authorino supports Open Policy Agent policies, either inline defined in Rego language as part of the <code>AuthConfig</code> or fetched from an external endpoint, such as an OPA Policy Registry.</p> <p>Authorino's built-in OPA module precompiles the policies in reconciliation-time and cache them for fast evaluation in request-time, where they receive the Authorization JSON as input.</p> <p>Check out as well the user guide about Authentication with API keys.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/opa-authorization/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/opa-authorization/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/opa-authorization/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/opa-authorization/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/opa-authorization/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/opa-authorization/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>In this example, we will use OPA to implement a read-only policy for requests coming from outside a trusted network (IP range 192.168.1/24).</p> <p>The implementation relies on the <code>X-Forwarded-For</code> HTTP header to read the client's IP address.<sup>5</sup></p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"friends\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: friends\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n  authorization:\n    \"read-only-outside\":\n      opa:\n        rego: |\n          ips := split(input.context.request.http.headers[\"x-forwarded-for\"], \",\")\n          trusted_network { net.cidr_contains(\"192.168.1.1/24\", ips[0]) }\n\n          allow { trusted_network }\n          allow { not trusted_network; input.context.request.http.method == \"GET\" }\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/opa-authorization/#create-the-api-key","title":"\u277b Create the API key","text":"<pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: friends\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/opa-authorization/#consume-the-api","title":"\u277c Consume the API","text":"<p>Inside the trusted network:</p> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' \\\n     -H 'X-Forwarded-For: 192.168.1.10' \\\n     http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' \\\n     -H 'X-Forwarded-For: 192.168.1.10' \\\n     -X POST \\\n     http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>Outside the trusted network:</p> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' \\\n     -H 'X-Forwarded-For: 123.45.6.78' \\\n     http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' \\\n     -H 'X-Forwarded-For: 123.45.6.78' \\\n     -X POST \\\n     http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 403 Forbidden\n# x-ext-auth-reason: Unauthorized\n</code></pre>"},{"location":"authorino/docs/user-guides/opa-authorization/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/api-key-1\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> <li> <p>You can also set <code>use_remote_address: true</code> in the Envoy route configuration, so the proxy will append its IP address instead of run in transparent mode. This setting will also ensure real remote address of the client connection passed in the <code>x-envoy-external-address</code> HTTP header, which can be used to simplify the read-only policy in remote environment.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/passing-credentials/","title":"User guide: Passing credentials (<code>Authorization</code> header, cookie headers and others)","text":"<p>Customize where credentials are supplied in the request by each trusted source of identity.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 Auth credentials</li> <li>Identity verification &amp; authentication \u2192 API key</li> </ul> <p>Authentication tokens can be supplied in the <code>Authorization</code> header, in a custom header, cookie or query string parameter.</p> <p>Check out as well the user guide about Authentication with API keys.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/passing-credentials/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/passing-credentials/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/passing-credentials/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/passing-credentials/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/passing-credentials/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/passing-credentials/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>In this example, <code>member</code> users can authenticate supplying the API key in any of 4 different ways:</p> <ul> <li>HTTP header <code>Authorization: APIKEY &lt;api-key&gt;</code></li> <li>HTTP header <code>X-API-Key: &lt;api-key&gt;</code></li> <li>Query string parameter <code>api_key=&lt;api-key&gt;</code></li> <li>Cookie <code>Cookie: APIKEY=&lt;api-key&gt;;</code></li> </ul> <p><code>admin</code> API keys are only accepted in the (default) HTTP header <code>Authorization: Bearer &lt;api-key&gt;</code>.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"members-authorization-header\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: members\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY # instead of the default prefix 'Bearer'\n    \"members-custom-header\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: members\n      credentials:\n        customHeader:\n          name: X-API-Key\n    \"members-query-string-param\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: members\n      credentials:\n        queryString:\n          name: api_key\n    \"members-cookie\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: members\n      credentials:\n        cookie:\n          name: APIKEY\n    \"admins\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: admins\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/passing-credentials/#create-the-api-keys","title":"\u277b Create the API keys","text":"<p>For a member user:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: members\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre> <p>For an admin user:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-2\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: admins\nstringData:\n  api_key: 7BNaTmYGItSzXiwQLNHu82+x52p1XHgY\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/passing-credentials/#consume-the-api","title":"\u277c Consume the API","text":"<p>As member user, passing the API key in the <code>Authorization</code> header:</p> <pre><code>curl -H 'Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>As member user, passing the API key in the custom <code>X-API-Key</code> header:</p> <pre><code>curl -H 'X-API-Key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx' http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>As member user, passing the API key in the query string parameter <code>api_key</code>:</p> <pre><code>curl \"http://talker-api.127.0.0.1.nip.io:8000/hello?api_key=ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\"\n# HTTP/1.1 200 OK\n</code></pre> <p>As member user, passing the API key in the <code>APIKEY</code> cookie header:</p> <pre><code>curl -H 'Cookie: APIKEY=ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx;foo=bar' http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>As admin user:</p> <pre><code>curl -H 'Authorization: Bearer 7BNaTmYGItSzXiwQLNHu82+x52p1XHgY' http://talker-api.127.0.0.1.nip.io:8000/hello\n# HTTP/1.1 200 OK\n</code></pre> <p>Missing the API key:</p> <pre><code>curl http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 401 Unauthorized\n# www-authenticate: APIKEY realm=\"members-authorization-header\"\n# www-authenticate: X-API-Key realm=\"members-custom-header\"\n# www-authenticate: api_key realm=\"members-query-string-param\"\n# www-authenticate: APIKEY realm=\"members-cookie\"\n# www-authenticate: Bearer realm=\"admins\"\n# x-ext-auth-reason: {\"admins\":\"credential not found\",\"members-authorization-header\":\"credential not found\",\"members-cookie\":\"credential not found\",\"members-custom-header\":\"credential not found\",\"members-query-string-param\":\"credential not found\"}\n</code></pre>"},{"location":"authorino/docs/user-guides/passing-credentials/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/api-key-1\nkubectl delete secret/api-key-2\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/","title":"User guide: Resource-level authorization with User-Managed Access (UMA) resource registry","text":"<p>Fetch resource metadata relevant for your authorization policies from Keycloak authorization clients, using User-Managed Access (UMA) protocol.</p> Authorino capabilities featured in this guide: <ul> <li>External auth metadata \u2192 User-Managed Access (UMA) resource registry</li> <li>Identity verification &amp; authentication \u2192 JWT verification</li> <li>Authorization \u2192 Open Policy Agent (OPA) Rego policies</li> </ul> <p>Check out as well the user guides about OpenID Connect Discovery and authentication with JWTs and Open Policy Agent (OPA) Rego policies.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced:</p> <p>This example of resource-level authorization leverages part of Keycloak's User-Managed Access (UMA) support. Authorino will fetch resource attributes stored in a Keycloak resource server client.</p> <p>The Keycloak server also provides the identities. The <code>sub</code> claim of the Keycloak-issued ID tokens must match the owner of the requested resource, identified by the URI of the request.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <p>Create a required secret that will be used by Authorino to initiate the authentication with the UMA registry.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: talker-api-uma-credentials\nstringData:\n  clientID: talker-api\n  clientSecret: 523b92b6-625d-4e1e-a313-77e7a8ae4e88\ntype: Opaque\nEOF\n</code></pre> <p>Create the config:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"keycloak-kuadrant-realm\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n  metadata:\n    \"resource-data\":\n      uma:\n        endpoint: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n        credentialsRef:\n          name: talker-api-uma-credentials\n  authorization:\n    \"owned-resources\":\n      opa:\n        rego: |\n          COLLECTIONS = [\"greetings\"]\n\n          http_request = input.context.request.http\n          http_method = http_request.method\n          requested_path_sections = split(trim_left(trim_right(http_request.path, \"/\"), \"/\"), \"/\")\n\n          get { http_method == \"GET\" }\n          post { http_method == \"POST\" }\n          put { http_method == \"PUT\" }\n          delete { http_method == \"DELETE\" }\n\n          valid_collection { COLLECTIONS[_] == requested_path_sections[0] }\n\n          collection_endpoint {\n            valid_collection\n            count(requested_path_sections) == 1\n          }\n\n          resource_endpoint {\n            valid_collection\n            some resource_id\n            requested_path_sections[1] = resource_id\n          }\n\n          identity_owns_the_resource {\n            identity := input.auth.identity\n            resource_attrs := object.get(input.auth.metadata, \"resource-data\", [])[0]\n            resource_owner := object.get(object.get(resource_attrs, \"owner\", {}), \"id\", \"\")\n            resource_owner == identity.sub\n          }\n\n          allow { get;    collection_endpoint }\n          allow { post;   collection_endpoint }\n          allow { get;    resource_endpoint; identity_owns_the_resource }\n          allow { put;    resource_endpoint; identity_owns_the_resource }\n          allow { delete; resource_endpoint; identity_owns_the_resource }\nEOF\n</code></pre> <p>The OPA policy <code>owned-resource</code> above enforces that all users can send GET and POST requests to <code>/greetings</code>, while only resource owners can send GET, PUT and DELETE requests to <code>/greetings/{resource-id}</code>.</p>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#obtain-access-tokens-with-the-keycloak-server-and-consume-the-api","title":"\u277b Obtain access tokens with the Keycloak server and consume the API","text":""},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#obtain-an-access-token-as-john-and-consume-the-api","title":"Obtain an access token as John and consume the API","text":"<p>Obtain an access token for user John (owner of the resource <code>/greetings/1</code> in the UMA registry):</p> <p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=john' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p> <p>As John, send requests to the API:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/greetings\n# HTTP/1.1 200 OK\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/greetings/1\n# HTTP/1.1 200 OK\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/greetings/1\n# HTTP/1.1 200 OK\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/greetings/2 -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#obtain-an-access-token-as-jane-and-consume-the-api","title":"Obtain an access token as Jane and consume the API","text":"<p>Obtain an access token for user Jane (owner of the resource <code>/greetings/2</code> in the UMA registry):</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>As Jane, send requests to the API:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/greetings\n# HTTP/1.1 200 OK\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/greetings/1 -i\n# HTTP/1.1 403 Forbidden\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/greetings/1 -i\n# HTTP/1.1 403 Forbidden\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/greetings/2\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#obtain-an-access-token-as-peter-and-consume-the-api","title":"Obtain an access token as Peter and consume the API","text":"<p>Obtain an access token for user Peter (does not own any resource in the UMA registry):</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=peter' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>As Jane, send requests to the API:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/greetings\n# HTTP/1.1 200 OK\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" http://talker-api.127.0.0.1.nip.io:8000/greetings/1 -i\n# HTTP/1.1 403 Forbidden\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/greetings/1 -i\n# HTTP/1.1 403 Forbidden\n\ncurl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/greetings/2 -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"authorino/docs/user-guides/resource-level-authorization-uma/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authconfig/talker-api-protection\nkubectl delete secret/talker-api-uma-credentials\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/sharding/","title":"User guide: Reducing the operational space","text":"<p>By default, Authorino will watch events related to all <code>AuthConfig</code> custom resources in the reconciliation space (namespace or entire cluster). Instances can be configured though to only watch a subset of the resources, thus allowing such as:</p> <ul> <li>to reduce noise and lower memory usage inside instances meant for restricted scope (e.g. Authorino deployed as a dedicated sidecar to protect only one host);</li> <li>sharding auth config data across multiple instances;</li> <li>multiple environments (e.g. staging, production) inside of a same cluster/namespace;</li> <li>providing managed instances of Authorino that all watch CRs cluster-wide, yet dedicated to organizations allowed to create and operate their own <code>AuthConfig</code>s across multiple namespaces.</li> </ul> \u26a0\ufe0f Important:         This feature may not be available to users of Authorino via Kuadrant.        Authorino capabilities featured in this guide: <ul> <li>Sharding</li> <li>Identity verification &amp; authentication \u2192 API key</li> </ul> <p>Check out as well the user guide about Authentication with API keys.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/sharding/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p></p>"},{"location":"authorino/docs/user-guides/sharding/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/sharding/#deploy-instances-of-authorino","title":"\u2777 Deploy instances of Authorino","text":"<p>Deploy an instance of Authorino dedicated to <code>AuthConfig</code>s and API key <code>Secrets</code> labeled with <code>authorino/environment=staging</code>:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino-staging\nspec:\n  clusterWide: true\n  authConfigLabelSelectors: authorino/environment=staging\n  secretLabelSelectors: authorino/environment=staging\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre> <p>Deploy an instance of Authorino dedicated to <code>AuthConfig</code>s and API key <code>Secrets</code> labeled with <code>authorino/environment=production</code>, ans NOT labeled <code>disabled</code>:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino-production\nspec:\n  clusterWide: true\n  authConfigLabelSelectors: authorino/environment=production,!disabled\n  secretLabelSelectors: authorino/environment=production,!disabled\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre> <p>The commands above will both request instances of Authorino that watch for <code>AuthConfig</code> resources cluster-wide<sup>1</sup>, with TLS disabled<sup>2</sup>.</p>"},{"location":"authorino/docs/user-guides/sharding/#create-a-namespace-for-user-resources","title":"\u2778 Create a namespace for user resources","text":"<pre><code>kubectl create namespace myapp\n</code></pre>"},{"location":"authorino/docs/user-guides/sharding/#create-authconfigs-and-api-key-secrets-for-both-instances","title":"\u2779 Create <code>AuthConfig</code>s and API key <code>Secret</code>s for both instances","text":""},{"location":"authorino/docs/user-guides/sharding/#create-resources-for-authorino-staging","title":"Create resources for <code>authorino-staging</code>","text":"<p>Create an <code>AuthConfig</code>:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: auth-config-1\n  labels:\n    authorino/environment: staging\nspec:\n  hosts:\n\n  - my-host.staging.io\n  authentication:\n    \"api-key\":\n      apiKey:\n        selector:\n          matchLabels:\n            authorino/api-key: \"true\"\n            authorino/environment: staging\nEOF\n</code></pre> <p>Create an API key <code>Secret</code>:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino/api-key: \"true\"\n    authorino/environment: staging\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre> <p>Verify in the logs that only the <code>authorino-staging</code> instance adds the resources to the index:</p> <pre><code>kubectl logs $(kubectl get pods -l authorino-resource=authorino-staging -o name)\n# {\"level\":\"info\",\"ts\":1638382989.8327162,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig\",\"msg\":\"resource reconciled\",\"authconfig\":\"myapp/auth-config-1\"}\n# {\"level\":\"info\",\"ts\":1638382989.837424,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig.statusupdater\",\"msg\":\"resource status updated\",\"authconfig/status\":\"myapp/auth-config-1\"}\n# {\"level\":\"info\",\"ts\":1638383144.9486837,\"logger\":\"authorino.controller-runtime.manager.controller.secret\",\"msg\":\"resource reconciled\",\"secret\":\"myapp/api-key-1\"}\n</code></pre>"},{"location":"authorino/docs/user-guides/sharding/#create-resources-for-authorino-production","title":"Create resources for <code>authorino-production</code>","text":"<p>Create an <code>AuthConfig</code>:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: auth-config-2\n  labels:\n    authorino/environment: production\nspec:\n  hosts:\n\n  - my-host.io\n  authentication:\n    \"api-key\":\n      apiKey:\n        selector:\n          matchLabels:\n            authorino/api-key: \"true\"\n            authorino/environment: production\nEOF\n</code></pre> <p>Create an API key <code>Secret</code>:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-2\n  labels:\n    authorino/api-key: \"true\"\n    authorino/environment: production\nstringData:\n  api_key: MUWdeBte7AbSWxl6CcvYNJ+3yEIm5CaL\ntype: Opaque\nEOF\n</code></pre> <p>Verify in the logs that only the <code>authorino-production</code> instance adds the resources to the index:</p> <pre><code>kubectl logs $(kubectl get pods -l authorino-resource=authorino-production -o name)\n# {\"level\":\"info\",\"ts\":1638383423.86086,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig.statusupdater\",\"msg\":\"resource status updated\",\"authconfig/status\":\"myapp/auth-config-2\"}\n# {\"level\":\"info\",\"ts\":1638383423.8608105,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig\",\"msg\":\"resource reconciled\",\"authconfig\":\"myapp/auth-config-2\"}\n# {\"level\":\"info\",\"ts\":1638383460.3515081,\"logger\":\"authorino.controller-runtime.manager.controller.secret\",\"msg\":\"resource reconciled\",\"secret\":\"myapp/api-key-2\"}\n</code></pre>"},{"location":"authorino/docs/user-guides/sharding/#remove-a-resource-from-scope","title":"\u277a Remove a resource from scope","text":"<pre><code>kubectl -n myapp label authconfig/auth-config-2 disabled=true\n# authconfig.authorino.kuadrant.io/auth-config-2 labeled\n</code></pre> <p>Verify in the logs that the <code>authorino-production</code> instance removes the authconfig from the index:</p> <pre><code>kubectl logs $(kubectl get pods -l authorino-resource=authorino-production -o name)\n# {\"level\":\"info\",\"ts\":1638383515.6428752,\"logger\":\"authorino.controller-runtime.manager.controller.authconfig\",\"msg\":\"resource de-indexed\",\"authconfig\":\"myapp/auth-config-2\"}\n</code></pre>"},{"location":"authorino/docs/user-guides/sharding/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete authorino/authorino-staging\nkubectl delete authorino/authorino-production\nkubectl delete namespace myapp\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p><code>cluster-wide</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/token-normalization/","title":"User guide: Token normalization","text":"<p>Broadly, the term token normalization in authentication systems usually implies the exchange of an authentication token, as provided by the user in a given format, and/or its associated identity claims, for another freshly issued token/set of claims, of a given (normalized) structure or format.</p> <p>The most typical use-case for token normalization involves accepting tokens issued by multiple trusted sources and of often varied authentication protocols, while ensuring that the eventual different data structures adopted by each of those sources are normalized, thus allowing to simplify policies and authorization checks that depend on those values. In general, however, any modification to the identity claims can be for the purpose of normalization.</p> <p>This user guide focuses on the aspect of mutation of the identity claims resolved from an authentication token, to a certain data format and/or by extending them, so that required attributes can thereafter be trusted to be present among the claims, in a desired form. For such, Authorino allows to extend resolved identity objects with custom attributes (custom claims) of either static values or with values fetched from the Authorization JSON.</p> <p>For not only normalizing the identity claims for purpose of writing simpler authorization checks and policies, but also getting Authorino to issue a new token in a normalized format, check the Festival Wristband tokens feature.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 Identity extension</li> <li>Identity verification &amp; authentication \u2192 API key</li> <li>Identity verification &amp; authentication \u2192 JWT verification</li> <li>Authorization \u2192 Pattern-matching authorization</li> </ul> <p>Check out as well the user guides about Authentication with API keys, OpenID Connect Discovery and authentication with JWTs and Simple pattern-matching authorization policies.</p> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/token-normalization/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> <li>jq, to extract parts of JSON responses</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server by executing the command below. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant and already have your workload cluster configured and sample service application deployed, as well as your Gateway API network resources applied to route traffic to your service, skip straight to step \u277a.</p> <p>At step \u277a, instead of creating an <code>AuthConfig</code> custom resource, create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/token-normalization/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources in the <code>default</code> namespace<sup>2</sup>, with TLS disabled<sup>3</sup>.</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#deploy-the-talker-api","title":"\u2778 Deploy the Talker API","text":"<p>The Talker API is a simple HTTP service that echoes back in the response whatever it gets in the request. We will use it in this guide as the sample service to be protected by Authorino.</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#setup-envoy","title":"\u2779 Setup Envoy","text":"<p>The following bundle from the Authorino examples deploys the Envoy proxy and configuration to wire up the Talker API behind the reverse-proxy, with external authorization enabled with the Authorino instance.<sup>4</sup></p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\n</code></pre> <p>The command above creates an <code>Ingress</code> with host name <code>talker-api.127.0.0.1.nip.io</code>. If you are using a local Kubernetes cluster created with Kind, forward requests from your local port 8000 to the Envoy service running inside the cluster:</p> <pre><code>kubectl port-forward deployment/envoy 8000:8000 2&gt;&amp;1 &gt;/dev/null &amp;\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#create-an-authconfig","title":"\u277a Create an <code>AuthConfig</code>","text":"<p>Create an Authorino <code>AuthConfig</code> custom resource declaring the auth rules to be enforced.</p> <p>This example implements a policy that only users bound to the <code>admin</code> role can send <code>DELETE</code> requests.</p> <p>The config trusts access tokens issued by a Keycloak realm as well as API keys labeled specifically to a selected group (<code>friends</code>). The roles of the identities handled by Keycloak are managed in Keycloak, as realm roles. Particularly, users <code>john</code> and <code>peter</code> are bound to the <code>member</code> role, while user <code>jane</code> is bound to roles <code>member</code> and <code>admin</code>. As for the users authenticating with API key, they are all bound to the <code>admin</code> role.</p> <p>Without normalizing identity claims from these two different sources, the policy would have to handle the differences of data formats with additional ifs-and-elses. Instead, the config here uses the <code>identity.extendedProperties</code> option to ensure a custom <code>roles</code> (Array) claim is always present in the identity object. In the case of Keycloak ID tokens, the value is extracted from the <code>realm_access.roles</code> claim; for API key-resolved objects, the custom claim is set to the static value <code>[\"admin\"]</code>.</p> Kuadrant users \u2013         Remember to create an <code>AuthPolicy</code> instead of an AuthConfig.         For more, see Kuadrant auth.        <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: talker-api-protection\nspec:\n  hosts:\n\n  - talker-api.127.0.0.1.nip.io\n  authentication:\n    \"keycloak-kuadrant-realm\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n      overrides:\n        \"roles\":\n          selector: auth.identity.realm_access.roles\n    \"api-key-friends\":\n      apiKey:\n        selector:\n          matchLabels:\n            group: friends\n      credentials:\n        authorizationHeader:\n          prefix: APIKEY\n      defaults:\n        \"roles\":\n          value: [\"admin\"]\n  authorization:\n    \"only-admins-can-delete\":\n      when:\n      - selector: context.request.http.method\n        operator: eq\n        value: DELETE\n      patternMatching:\n        patterns:\n        - selector: auth.identity.roles\n          operator: incl\n          value: admin\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#create-an-api-key","title":"\u277b Create an API key","text":"<pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    group: friends\nstringData:\n  api_key: ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\ntype: Opaque\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#consume-the-api","title":"\u277c Consume the API","text":""},{"location":"authorino/docs/user-guides/token-normalization/#obtain-an-access-token-and-consume-the-api-as-jane-admin","title":"Obtain an access token and consume the API as Jane (admin)","text":"<p>Obtain an access token with the Keycloak server for Jane:</p> <p>The <code>AuthConfig</code> deployed in the previous step is suitable for validating access tokens requested inside the cluster. This is because Keycloak's <code>iss</code> claim added to the JWTs matches always the host used to request the token and Authorino will later try to match this host to the host that provides the OpenID Connect configuration.</p> <p>Obtain an access token from within the cluster for the user Jane, whose e-mail has been verified:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=jane' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>If your Keycloak server is reachable from outside the cluster, feel free to obtain the token directly. Make sure the host name set in the OIDC issuer endpoint in the <code>AuthConfig</code> matches the one used to obtain the token and is as well reachable from within the cluster.</p> <p>Consume the API as Jane:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#obtain-an-access-token-and-consume-the-api-as-john-member","title":"Obtain an access token and consume the API as John (member)","text":"<p>Obtain an access token with the Keycloak server for John:</p> <pre><code>ACCESS_TOKEN=$(kubectl run token --attach --rm --restart=Never -q --image=curlimages/curl -- http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant/protocol/openid-connect/token -s -d 'grant_type=password' -d 'client_id=demo' -d 'username=john' -d 'password=p' -d 'scope=openid' | jq -r .access_token)\n</code></pre> <p>Consume the API as John:</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 403 Forbidden\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#consume-the-api-using-the-api-key-to-authenticate-admin","title":"Consume the API using the API key to authenticate (admin)","text":"<pre><code>curl -H \"Authorization: APIKEY ndyBzreUzF4zqDQsqSPMHkRhriEOtcRx\" -X DELETE http://talker-api.127.0.0.1.nip.io:8000/hello -i\n# HTTP/1.1 200 OK\n</code></pre>"},{"location":"authorino/docs/user-guides/token-normalization/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete secret/api-key-1\nkubectl delete authconfig/talker-api-protection\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/envoy/envoy-notls-deploy.yaml\nkubectl delete -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/talker-api/talker-api-deploy.yaml\nkubectl delete authorino/authorino\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>namespaced</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> <li> <p>For details and instructions to setup Envoy manually, see Protect a service &gt; Setup Envoy in the Getting Started page. If you are running your ingress gateway in Kubernetes and wants to avoid setting up and configuring your proxy manually, check out Kuadrant.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino/docs/user-guides/validating-webhook/","title":"User guide: Using Authorino as ValidatingWebhook service","text":"<p>Authorino provides an interface for raw HTTP external authorization requests. This interface can be used for integrations other than the typical Envoy gRPC protocol, such as (though not limited to) using Authorino as a generic Kubernetes ValidatingWebhook service.</p> <p>The rules to validate a request to the Kubernetes API \u2013 typically a <code>POST</code>, <code>PUT</code> or <code>DELETE</code> request targeting a particular Kubernetes resource or collection \u2013, according to which either the change will be deemed accepted or not, are written in an Authorino <code>AuthConfig</code> custom resource. Authentication and authorization are performed by the Kubernetes API server as usual, with auth features of Authorino implementing the additional validation within the scope of an <code>AdmissionReview</code> request.</p> <p>This user guide provides an example of using Authorino as a Kubernetes ValidatingWebhook service that validates requests to <code>CREATE</code> and <code>UPDATE</code> Authorino <code>AuthConfig</code> resources. In other words, we will use Authorino as a validator inside the cluster that decides what is a valid AuthConfig for any application which wants to rely on Authorino to protect itself.</p> Authorino capabilities featured in this guide: <ul> <li>Identity verification &amp; authentication \u2192 Plain</li> <li>Identity verification &amp; authentication \u2192 Kubernetes TokenReview</li> <li>Identity verification &amp; authentication \u2192 API key</li> <li>External auth metadata \u2192 HTTP GET/GET-by-POST</li> <li>Authorization \u2192 Kubernetes SubjectAccessReview</li> <li>Authorization \u2192 Open Policy Agent (OPA) Rego policies</li> <li>Dynamic response \u2192 Festival Wristband tokens</li> <li>Common feature \u2192 Conditions</li> <li>Common feature \u2192 Priorities</li> </ul> <p>For further details about Authorino features in general, check the docs.</p> <p></p>"},{"location":"authorino/docs/user-guides/validating-webhook/#requirements","title":"Requirements","text":"<ul> <li>Kubernetes server with permissions to install cluster-scoped resources (operator, CRDs and RBAC)</li> <li>Identity Provider (IdP) that implements OpenID Connect authentication and OpenID Connect Discovery (e.g. Keycloak)</li> </ul> <p>If you do not own a Kubernetes server already and just want to try out the steps in this guide, you can create a local containerized cluster by executing the command below. In this case, the main requirement is having Kind installed, with either Docker or Podman.</p> <pre><code>kind create cluster --name authorino-tutorial\n</code></pre> <p>Deploy the identity provider and authentication server. For the examples in this guide, we are going to use a Keycloak server preloaded with all required realm settings.</p> <p>The Keycloak server is only needed for trying out validating AuthConfig resources that use the authentication server.</p> <pre><code>kubectl create namespace keycloak\nkubectl -n keycloak apply -f https://raw.githubusercontent.com/kuadrant/authorino-examples/main/keycloak/keycloak-deploy.yaml\n</code></pre> <p></p> <p>The next steps walk you through installing Authorino, deploying and configuring a sample service called Talker API to be protected by the authorization service.</p> Using Kuadrant <p>If you are a user of Kuadrant you may already have Authorino installed and running. In this case, skip straight to step \u2778.</p> <p>At step \u277a, alternatively to creating an <code>AuthConfig</code> custom resource, you may create a Kuadrant <code>AuthPolicy</code> one. The schema of the AuthConfig's <code>spec</code> matches the one of the AuthPolicy's, except <code>spec.host</code>, which is not available in the Kuadrant AuthPolicy. Host names in a Kuadrant AuthPolicy are inferred automatically from the Kubernetes network object referred in <code>spec.targetRef</code> and route selectors declared in the policy.</p> <p>For more about using Kuadrant to enforce authorization, check out Kuadrant auth.</p> <p></p>"},{"location":"authorino/docs/user-guides/validating-webhook/#install-the-authorino-operator-cluster-admin-required","title":"\u2776 Install the Authorino Operator (cluster admin required)","text":"<p>The following command will install the Authorino Operator in the Kubernetes cluster. The operator manages instances of the Authorino authorization service.</p> <pre><code>curl -sL https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/utils/install.sh | bash -s\n</code></pre>"},{"location":"authorino/docs/user-guides/validating-webhook/#deploy-authorino","title":"\u2777 Deploy Authorino","text":"<p>Create the namespace:</p> <pre><code>kubectl create namespace authorino\n</code></pre> <p>Create the TLS certificates:</p> <pre><code>curl -sSL https://raw.githubusercontent.com/Kuadrant/authorino/main/deploy/certs.yaml | sed \"s/\\$(AUTHORINO_INSTANCE)/authorino/g;s/\\$(NAMESPACE)/authorino/g\" | kubectl -n authorino apply -f -\n</code></pre> <p>Create the Authorino instance:</p> <p>The following command will request an instance of Authorino as a separate service<sup>1</sup> that watches for <code>AuthConfig</code> resources cluster-wide<sup>2</sup>, with TLS enabled<sup>3</sup>.</p> <pre><code>kubectl -n authorino apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  clusterWide: true\n  listener:\n    ports:\n      grpc: 50051\n      http: 5001 # for admissionreview requests sent by the kubernetes api server\n    tls:\n      certSecretRef:\n        name: authorino-server-cert\n  oidcServer:\n    tls:\n      certSecretRef:\n        name: authorino-oidc-server-cert\nEOF\n</code></pre> <p>For convenience, the same instance of Authorino pointed as the validating webhook will also be targeted for the sample AuthConfigs created to test the validation. For using different instances of Authorino for the validating webhook and for protecting applications behind a proxy, check out the section about sharding in the docs. There is also a user guide on the topic, with concrete examples.</p>"},{"location":"authorino/docs/user-guides/validating-webhook/#create-the-authconfig-and-related-clusterrole","title":"\u2778 Create the <code>AuthConfig</code> and related <code>ClusterRole</code>","text":"<p>Create the <code>AuthConfig</code> with the auth rules to validate other AuthConfig resources applied to the cluster.</p> <p>The AuthConfig to validate other AuthConfigs will enforce the following rules:</p> <ul> <li>Authorino features that cannot be used by any application in their security schemes:</li> <li>Anonymous Access</li> <li>Plain identity object extracted from context</li> <li>Kubernetes authentication (TokenReview)</li> <li>Kubernetes authorization (SubjectAccessReview)</li> <li>Festival Wristband tokens</li> <li>Authorino features that require a RoleBinding to a specific ClusterRole in the 'authorino' namespace, to be used in a AuthConfig:</li> <li>Authorino API key authentication</li> <li>All metadata pulled from external sources must be cached for precisely 5 minutes (300 seconds)</li> </ul> <pre><code>kubectl -n authorino apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: authconfig-validator\nspec:\n  # admissionreview requests will be sent to this host name\n  hosts:\n\n  - authorino-authorino-authorization.authorino.svc\n\n  # because we're using a single authorino instance for the validating webhook and to protect the user applications,\n  # skip operations related to this one authconfig in the 'authorino' namespace\n  when:\n\n  - selector: context.request.http.body.@fromstr|request.object.metadata.namespace\n    operator: neq\n    value: authorino\n\n  # kubernetes admissionreviews carry info about the authenticated user\n  authentication:\n    \"k8s-userinfo\":\n      plain:\n        selector: context.request.http.body.@fromstr|request.userInfo\n\n  authorization:\n    \"features\":\n      opa:\n        rego: |\n          authconfig = json.unmarshal(input.context.request.http.body).request.object\n\n          forbidden { count(object.get(authconfig.spec, \"authentication\", [])) == 0 }\n          forbidden { authconfig.spec.authentication[_].anonymous }\n          forbidden { authconfig.spec.authentication[_].kubernetesTokenReview }\n          forbidden { authconfig.spec.authentication[_].plain }\n          forbidden { authconfig.spec.authorization[_].kubernetesSubjectAccessReview }\n          forbidden { authconfig.spec.response.success.headers[_].wristband }\n\n          apiKey { authconfig.spec.authentication[_].apiKey }\n\n          allow { count(authconfig.spec.authentication) &gt; 0; not forbidden }\n        allValues: true\n\n    \"apikey-authn-requires-k8s-role-binding\":\n      priority: 1\n      when:\n\n      - selector: auth.authorization.features.apiKey\n        operator: eq\n        value: \"true\"\n      kubernetesSubjectAccessReview:\n        user:\n          selector: auth.identity.username\n        resourceAttributes:\n          namespace: { value: authorino }\n          group: { value: authorino.kuadrant.io }\n          resource: { value: authconfigs-with-apikeys }\n          verb: { value: create }\n\n    \"metadata-cache-ttl\":\n      priority: 1\n      opa:\n        rego: |\n          invalid_ttl = input.auth.authorization.features.authconfig.spec.metadata[_].cache.ttl != 300\n          allow { not invalid_ttl }\nEOF\n</code></pre> <p>Define a <code>ClusterRole</code> to control the usage of protected features of Authorino:</p> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRole\nmetadata:\n  name: authorino-apikey\nrules:\n\n- apiGroups: [\"authorino.kuadrant.io\"]\n  resources: [\"authconfigs-with-apikeys\"] # not a real k8s resource\n  verbs: [\"create\"]\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/validating-webhook/#create-the-validatingwebhookconfiguration","title":"\u2779 Create the <code>ValidatingWebhookConfiguration</code>","text":"<pre><code>kubectl -n authorino apply -f -&lt;&lt;EOF\napiVersion: admissionregistration.k8s.io/v1\nkind: ValidatingWebhookConfiguration\nmetadata:\n  name: authconfig-authz\n  annotations:\n    cert-manager.io/inject-ca-from: authorino/authorino-ca-cert\nwebhooks:\n\n- name: check-authconfig.authorino.kuadrant.io\n  clientConfig:\n    service:\n      namespace: authorino\n      name: authorino-authorino-authorization\n      port: 5001\n      path: /check\n  rules:\n  - apiGroups: [\"authorino.kuadrant.io\"]\n    apiVersions: [\"v1beta2\"]\n    resources: [\"authconfigs\"]\n    operations: [\"CREATE\", \"UPDATE\"]\n    scope: Namespaced\n  sideEffects: None\n  admissionReviewVersions: [\"v1\"]\nEOF\n</code></pre>"},{"location":"authorino/docs/user-guides/validating-webhook/#try-it-out","title":"\u277a Try it out","text":"<p>Create a namespace:</p> <pre><code>kubectl create namespace myapp\n</code></pre>"},{"location":"authorino/docs/user-guides/validating-webhook/#with-a-valid-authconfig","title":"With a valid <code>AuthConfig</code>","text":"Kuadrant users \u2013         For this and other example AuthConfigs below, if you create a Kuadrant <code>AuthPolicy</code> instead, the output of the commands shall differ. The requested AuthPolicy may be initially accepted, but its state will turn ready or not ready depending on whether the corresponding AuthConfig requested by Kuadrant is accepted or rejected, according to the validating webhook rules. Check the state of the resources to confirm.         For more, see Kuadrant auth.        <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"keycloak\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\nEOF\n# authconfig.authorino.kuadrant.io/myapp-protection created\n</code></pre>"},{"location":"authorino/docs/user-guides/validating-webhook/#with-forbidden-features","title":"With forbidden features","text":"<p>Anonymous access:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\nEOF\n# Error from server: error when applying patch:\n# {\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"authorino.kuadrant.io/v1beta2\\\",\\\"kind\\\":\\\"AuthConfig\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"name\\\":\\\"myapp-protection\\\",\\\"namespace\\\":\\\"myapp\\\"},\\\"spec\\\":{\\\"hosts\\\":[\\\"myapp.io\\\"]}}\\n\"}},\"spec\":{\"authentication\":null}}\n# to:\n# Resource: \"authorino.kuadrant.io/v1beta2, Resource=authconfigs\", GroupVersionKind: \"authorino.kuadrant.io/v1beta2, Kind=AuthConfig\"\n# Name: \"myapp-protection\", Namespace: \"myapp\"\n# for: \"STDIN\": error when patching \"STDIN\": admission webhook \"check-authconfig.authorino.kuadrant.io\" denied the request: Unauthorized\n</code></pre> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"anonymous-access\":\n      anonymous: {}\nEOF\n# Error from server: error when applying patch:\n# {\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"authorino.kuadrant.io/v1beta2\\\",\\\"kind\\\":\\\"AuthConfig\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"name\\\":\\\"myapp-protection\\\",\\\"namespace\\\":\\\"myapp\\\"},\\\"spec\\\":{\\\"authentication\\\":{\\\"anonymous-access\\\":{\\\"anonymous\\\":{}}},\\\"hosts\\\":[\\\"myapp.io\\\"]}}\\n\"}},\"spec\":{\"authentication\":{\"anonymous-access\":{\"anonymous\":{}},\"keycloak\":null}}}\n# to:\n# Resource: \"authorino.kuadrant.io/v1beta2, Resource=authconfigs\", GroupVersionKind: \"authorino.kuadrant.io/v1beta2, Kind=AuthConfig\"\n# Name: \"myapp-protection\", Namespace: \"myapp\"\n# for: \"STDIN\": error when patching \"STDIN\": admission webhook \"check-authconfig.authorino.kuadrant.io\" denied the request: Unauthorized\n</code></pre> <p>Kubernetes TokenReview:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"k8s-tokenreview\":\n      kubernetesTokenReview:\n        audiences: [\"myapp\"]\nEOF\n# Error from server: error when applying patch:\n# {\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"authorino.kuadrant.io/v1beta2\\\",\\\"kind\\\":\\\"AuthConfig\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"name\\\":\\\"myapp-protection\\\",\\\"namespace\\\":\\\"myapp\\\"},\\\"spec\\\":{\\\"authentication\\\":{\\\"k8s-tokenreview\\\":{\\\"kubernetesTokenReview\\\":{\\\"audiences\\\":[\\\"myapp\\\"]}}},\\\"hosts\\\":[\\\"myapp.io\\\"]}}\\n\"}},\"spec\":{\"authentication\":{\"k8s-tokenreview\":{\"kubernetesTokenReview\":{\"audiences\":[\"myapp\"]}},\"keycloak\":null}}}\n# to:\n# Resource: \"authorino.kuadrant.io/v1beta2, Resource=authconfigs\", GroupVersionKind: \"authorino.kuadrant.io/v1beta2, Kind=AuthConfig\"\n# Name: \"myapp-protection\", Namespace: \"myapp\"\n# for: \"STDIN\": error when patching \"STDIN\": admission webhook \"check-authconfig.authorino.kuadrant.io\" denied the request: Unauthorized\n</code></pre> <p>Plain identity extracted from context:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"envoy-jwt-authn\":\n      plain:\n        selector: context.metadata_context.filter_metadata.envoy\\.filters\\.http\\.jwt_authn|verified_jwt\nEOF\n# Error from server: error when applying patch:\n# {\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"authorino.kuadrant.io/v1beta2\\\",\\\"kind\\\":\\\"AuthConfig\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"name\\\":\\\"myapp-protection\\\",\\\"namespace\\\":\\\"myapp\\\"},\\\"spec\\\":{\\\"authentication\\\":{\\\"envoy-jwt-authn\\\":{\\\"plain\\\":{\\\"selector\\\":\\\"context.metadata_context.filter_metadata.envoy\\\\\\\\.filters\\\\\\\\.http\\\\\\\\.jwt_authn|verified_jwt\\\"}}},\\\"hosts\\\":[\\\"myapp.io\\\"]}}\\n\"}},\"spec\":{\"authentication\":{\"envoy-jwt-authn\":{\"plain\":{\"selector\":\"context.metadata_context.filter_metadata.envoy\\\\.filters\\\\.http\\\\.jwt_authn|verified_jwt\"}},\"keycloak\":null}}}\n# to:\n# Resource: \"authorino.kuadrant.io/v1beta2, Resource=authconfigs\", GroupVersionKind: \"authorino.kuadrant.io/v1beta2, Kind=AuthConfig\"\n# Name: \"myapp-protection\", Namespace: \"myapp\"\n# for: \"STDIN\": error when patching \"STDIN\": admission webhook \"check-authconfig.authorino.kuadrant.io\" denied the request: Unauthorized\n</code></pre> <p>Kubernetes SubjectAccessReview:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"keycloak\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n  authorization:\n    \"k8s-subjectaccessreview\":\n      kubernetesSubjectAccessReview:\n        user:\n          selector: auth.identity.sub\nEOF\n# Error from server: error when applying patch:\n# {\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"authorino.kuadrant.io/v1beta2\\\",\\\"kind\\\":\\\"AuthConfig\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"name\\\":\\\"myapp-protection\\\",\\\"namespace\\\":\\\"myapp\\\"},\\\"spec\\\":{\\\"authentication\\\":{\\\"keycloak\\\":{\\\"jwt\\\":{\\\"issuerUrl\\\":\\\"http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\\\"}}},\\\"authorization\\\":{\\\"k8s-subjectaccessreview\\\":{\\\"kubernetesSubjectAccessReview\\\":{\\\"user\\\":{\\\"selector\\\":\\\"auth.identity.sub\\\"}}}},\\\"hosts\\\":[\\\"myapp.io\\\"]}}\\n\"}},\"spec\":{\"authorization\":{\"k8s-subjectaccessreview\":{\"kubernetesSubjectAccessReview\":{\"user\":{\"selector\":\"auth.identity.sub\"}}}}}}\n# to:\n# Resource: \"authorino.kuadrant.io/v1beta2, Resource=authconfigs\", GroupVersionKind: \"authorino.kuadrant.io/v1beta2, Kind=AuthConfig\"\n# Name: \"myapp-protection\", Namespace: \"myapp\"\n# for: \"STDIN\": error when patching \"STDIN\": admission webhook \"check-authconfig.authorino.kuadrant.io\" denied the request: Unauthorized\n</code></pre> <p>Festival Wristband tokens:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: wristband-signing-key\nstringData:\n  key.pem: |\n    -----BEGIN EC PRIVATE KEY-----\n    MHcCAQEEIDHvuf81gVlWGo0hmXGTAnA/HVxGuH8vOc7/8jewcVvqoAoGCCqGSM49\n    AwEHoUQDQgAETJf5NLVKplSYp95TOfhVPqvxvEibRyjrUZwwtpDuQZxJKDysoGwn\n    cnUvHIu23SgW+Ee9lxSmZGhO4eTdQeKxMA==\n    -----END EC PRIVATE KEY-----\ntype: Opaque\n---\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"keycloak\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n  response:\n    success:\n      headers:\n        \"wristband\":\n          wristband:\n            issuer: http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/myapp/myapp-protection/wristband\n            signingKeyRefs:\n            - algorithm: ES256\n              name: wristband-signing-key\nEOF\n# secret/wristband-signing-key created\n# Error from server: error when applying patch:\n# {\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"authorino.kuadrant.io/v1beta2\\\",\\\"kind\\\":\\\"AuthConfig\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"name\\\":\\\"myapp-protection\\\",\\\"namespace\\\":\\\"myapp\\\"},\\\"spec\\\":{\\\"authentication\\\":{\\\"keycloak\\\":{\\\"jwt\\\":{\\\"issuerUrl\\\":\\\"http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\\\"}}},\\\"hosts\\\":[\\\"myapp.io\\\"],\\\"response\\\":{\\\"success\\\":{\\\"headers\\\":{\\\"wristband\\\":{\\\"wristband\\\":{\\\"issuer\\\":\\\"http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/myapp/myapp-protection/wristband\\\",\\\"signingKeyRefs\\\":[{\\\"algorithm\\\":\\\"ES256\\\",\\\"name\\\":\\\"wristband-signing-key\\\"}]}}}}}}}\\n\"}},\"spec\":{\"response\":{\"success\":{\"headers\":{\"wristband\":{\"wristband\":{\"issuer\":\"http://authorino-authorino-oidc.authorino.svc.cluster.local:8083/myapp/myapp-protection/wristband\",\"signingKeyRefs\":[{\"algorithm\":\"ES256\",\"name\":\"wristband-signing-key\"}]}}}}}}}\n# to:\n# Resource: \"authorino.kuadrant.io/v1beta2, Resource=authconfigs\", GroupVersionKind: \"authorino.kuadrant.io/v1beta2, Kind=AuthConfig\"\n# Name: \"myapp-protection\", Namespace: \"myapp\"\n# for: \"STDIN\": error when patching \"STDIN\": admission webhook \"check-authconfig.authorino.kuadrant.io\" denied the request: Unauthorized\n</code></pre>"},{"location":"authorino/docs/user-guides/validating-webhook/#with-features-that-require-additional-permissions","title":"With features that require additional permissions","text":"<p>Before adding the required permissions:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"api-key\":\n      apiKey:\n        selector:\n          matchLabels: { app: myapp }\nEOF\n# Error from server: error when applying patch:\n# {\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"authorino.kuadrant.io/v1beta2\\\",\\\"kind\\\":\\\"AuthConfig\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"name\\\":\\\"myapp-protection\\\",\\\"namespace\\\":\\\"myapp\\\"},\\\"spec\\\":{\\\"authentication\\\":{\\\"api-key\\\":{\\\"apiKey\\\":{\\\"selector\\\":{\\\"matchLabels\\\":{\\\"app\\\":\\\"myapp\\\"}}}}},\\\"hosts\\\":[\\\"myapp.io\\\"]}}\\n\"}},\"spec\":{\"authentication\":{\"api-key\":{\"apiKey\":{\"selector\":{\"matchLabels\":{\"app\":\"myapp\"}}}},\"keycloak\":null}}}\n# to:\n# Resource: \"authorino.kuadrant.io/v1beta2, Resource=authconfigs\", GroupVersionKind: \"authorino.kuadrant.io/v1beta2, Kind=AuthConfig\"\n# Name: \"myapp-protection\", Namespace: \"myapp\"\n# for: \"STDIN\": error when patching \"STDIN\": admission webhook \"check-authconfig.authorino.kuadrant.io\" denied the request: Not authorized: unknown reason\n</code></pre> <p>Add the required permissions:</p> <pre><code>kubectl -n authorino apply -f -&lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\n  name: authorino-apikey\nroleRef:\n  apiGroup: rbac.authorization.k8s.io\n  kind: ClusterRole\n  name: authorino-apikey\nsubjects:\n\n- kind: User\n  name: kubernetes-admin\nEOF\n# rolebinding.rbac.authorization.k8s.io/authorino-apikey created\n</code></pre> <p>After adding the required permissions:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"api-key\":\n      apiKey:\n        selector:\n          matchLabels: { app: myapp }\nEOF\n# authconfig.authorino.kuadrant.io/myapp-protection configured\n</code></pre>"},{"location":"authorino/docs/user-guides/validating-webhook/#with-features-that-require-specific-property-validation","title":"With features that require specific property validation","text":"<p>Invalid:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"keycloak\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n  metadata:\n    \"external-source\":\n      http:\n        url: http://metadata.io\n      cache:\n        key: { value: global }\n        ttl: 60\nEOF\n# Error from server: error when applying patch:\n# {\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/last-applied-configuration\":\"{\\\"apiVersion\\\":\\\"authorino.kuadrant.io/v1beta2\\\",\\\"kind\\\":\\\"AuthConfig\\\",\\\"metadata\\\":{\\\"annotations\\\":{},\\\"name\\\":\\\"myapp-protection\\\",\\\"namespace\\\":\\\"myapp\\\"},\\\"spec\\\":{\\\"authentication\\\":{\\\"keycloak\\\":{\\\"jwt\\\":{\\\"issuerUrl\\\":\\\"http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\\\"}}},\\\"hosts\\\":[\\\"myapp.io\\\"],\\\"metadata\\\":{\\\"external-source\\\":{\\\"cache\\\":{\\\"key\\\":{\\\"value\\\":\\\"global\\\"},\\\"ttl\\\":60},\\\"http\\\":{\\\"url\\\":\\\"http://metadata.io\\\"}}}}}\\n\"}},\"spec\":{\"authentication\":{\"api-key\":null,\"keycloak\":{\"jwt\":{\"issuerUrl\":\"http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\"}}},\"metadata\":{\"external-source\":{\"cache\":{\"key\":{\"value\":\"global\"},\"ttl\":60},\"http\":{\"url\":\"http://metadata.io\"}}}}}\n# to:\n# Resource: \"authorino.kuadrant.io/v1beta2, Resource=authconfigs\", GroupVersionKind: \"authorino.kuadrant.io/v1beta2, Kind=AuthConfig\"\n# Name: \"myapp-protection\", Namespace: \"myapp\"\n# for: \"STDIN\": error when patching \"STDIN\": admission webhook \"check-authconfig.authorino.kuadrant.io\" denied the request: Unauthorized\n</code></pre> <p>Valid:</p> <pre><code>kubectl -n myapp apply -f -&lt;&lt;EOF\napiVersion: authorino.kuadrant.io/v1beta2\nkind: AuthConfig\nmetadata:\n  name: myapp-protection\nspec:\n  hosts:\n\n  - myapp.io\n  authentication:\n    \"keycloak\":\n      jwt:\n        issuerUrl: http://keycloak.keycloak.svc.cluster.local:8080/realms/kuadrant\n  metadata:\n    \"external-source\":\n      http:\n        url: http://metadata.io\n      cache:\n        key: { value: global }\n        ttl: 300\nEOF\n# authconfig.authorino.kuadrant.io/myapp-protection configured\n</code></pre>"},{"location":"authorino/docs/user-guides/validating-webhook/#cleanup","title":"Cleanup","text":"<p>If you have started a Kubernetes cluster locally with Kind to try this user guide, delete it by running:</p> <pre><code>kind delete cluster --name authorino-tutorial\n</code></pre> <p>Otherwise, delete the resources created in each step:</p> <pre><code>kubectl delete namespace myapp\nkubectl delete namespace authorino\nkubectl delete clusterrole authorino-apikey\nkubectl delete namespace keycloak\n</code></pre> <p>To uninstall the Authorino Operator and manifests (CRDs, RBAC, etc), run:</p> <pre><code>kubectl delete -f https://raw.githubusercontent.com/Kuadrant/authorino-operator/main/config/deploy/manifests.yaml\n</code></pre> <ol> <li> <p>In contrast to a dedicated sidecar of the protected service and other architectures. Check out Architecture &gt; Topologies for all options.\u00a0\u21a9</p> </li> <li> <p><code>cluster-wide</code> reconciliation mode. See Cluster-wide vs. Namespaced instances.\u00a0\u21a9</p> </li> <li> <p>For other variants and deployment options, check out Getting Started, as well as the <code>Authorino</code> CRD specification.\u00a0\u21a9</p> </li> </ol>"},{"location":"authorino-operator/","title":"Authorino Operator","text":"<p>A Kubernetes Operator to manage Authorino instances.</p> <p> </p>"},{"location":"authorino-operator/#installation","title":"Installation","text":"<p>The Operator can be installed by applying the manifests to the Kubernetes cluster or using Operator Lifecycle Manager (OLM)</p>"},{"location":"authorino-operator/#applying-the-manifests-to-the-cluster","title":"Applying the manifests to the cluster","text":"<ol> <li>Install the Operator manifests</li> </ol> <pre><code>make install\n</code></pre> <ol> <li>Deploy the Operator</li> </ol> <pre><code>make deploy\n</code></pre> Tip: Deploy a custom image of the Operator    To deploy an image of the Operator other than the default <code>quay.io/kuadrant/authorino-operator:latest</code>, specify by setting the <code>OPERATOR_IMAGE</code> parameter. E.g.:    <pre><code>make deploy OPERATOR_IMAGE=authorino-operator:local\n</code></pre>"},{"location":"authorino-operator/#installing-via-olm","title":"Installing via OLM","text":"<p>To install the Operator using the Operator Lifecycle Manager, you need to make the Operator CSVs available in the cluster by creating a <code>CatalogSource</code> resource.</p> <p>The bundle and catalog images of the Operator are available in Quay.io:</p> Bundle quay.io/kuadrant/authorino-operator-bundle Catalog quay.io/kuadrant/authorino-operator-catalog <ol> <li>Create the namespace for the Operator</li> </ol> <pre><code>kubectl create namespace authorino-operator\n</code></pre> <ol> <li>Create the CatalogSource resource pointing to    one of the images from in the Operator's catalog repo:</li> </ol> <pre><code>kubectl -n authorino-operator apply -f -&lt;&lt;EOF\napiVersion: operators.coreos.com/v1alpha1\nkind: CatalogSource\nmetadata:\n  name: operatorhubio-catalog\n  namespace: authorino-operator\nspec:\n  sourceType: grpc\n  image: quay.io/kuadrant/authorino-operator-catalog:latest\n  displayName: Authorino Operator\nEOF\n</code></pre>"},{"location":"authorino-operator/#deploy-authorino-operator-using-operator-sdk","title":"Deploy authorino operator using operator-sdk","text":"<ol> <li>Install operator-sdk bin    <pre><code>make operator-sdk\n</code></pre></li> <li>Run operator-sdk bundle command     <pre><code>./bin/operator-sdk run bundle quay.io/kuadrant/authorino-operator-bundle:latest\n</code></pre> Note: For s390x &amp; ppc64le , use operator-sdk to install authorino-operator </li> </ol>"},{"location":"authorino-operator/#requesting-an-authorino-instance","title":"Requesting an Authorino instance","text":"<p>Once the Operator is up and running, you can request instances of Authorino by creating <code>Authorino</code> CRs. E.g.:</p> <pre><code>kubectl -n default apply -f -&lt;&lt;EOF\napiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  listener:\n    tls:\n      enabled: false\n  oidcServer:\n    tls:\n      enabled: false\nEOF\n</code></pre>"},{"location":"authorino-operator/#the-authorino-custom-resource-definition-crd","title":"The <code>Authorino</code> Custom Resource Definition (CRD)","text":"<p>API to install, manage and configure Authorino authorization services .</p> <p>Each <code>Authorino</code> Custom Resource (CR) represents an instance of Authorino deployed to the cluster. The Authorino Operator will reconcile the state of the Kubernetes Deployment and associated resources, based on the state of the CR.</p>"},{"location":"authorino-operator/#api-specification","title":"API Specification","text":"Field Type Description Required/Default spec AuthorinoSpec Specification of the Authorino deployment. Required"},{"location":"authorino-operator/#authorinospec","title":"AuthorinoSpec","text":"Field Type Description Required/Default clusterWide Boolean Sets the Authorino instance's watching scope \u2013 cluster-wide or namespaced. Default: <code>true</code> (cluster-wide) authConfigLabelSelectors String Label selectors used by the Authorino instance to filter <code>AuthConfig</code>-related reconciliation events. Default: empty (all AuthConfigs are watched) secretLabelSelectors String Label selectors used by the Authorino instance to filter <code>Secret</code>-related reconciliation events (API key and mTLS authentication methods). Default: <code>authorino.kuadrant.io/managed-by=authorino</code> supersedingHostSubsets Boolean Enable/disable allowing AuthConfigs to supersede strict subsets of hosts already taken. Default: <code>false</code> replicas Integer Number of replicas desired for the Authorino instance. Values greater than 1 enable leader election in the Authorino service, where the leader updates the statuses of the <code>AuthConfig</code> CRs). Default: 1 evaluatorCacheSize Integer Cache size (in megabytes) of each Authorino evaluator (when enabled in an <code>AuthConfig</code>). Default: 1 image String Authorino image to be deployed (for dev/testing purpose only). Default: <code>quay.io/kuadrant/authorino:latest</code> imagePullPolicy String Sets the imagePullPolicy of the Authorino Deployment (for dev/testing purpose only). Default: k8s default logLevel String Defines the level of log you want to enable in Authorino (<code>debug</code>, <code>info</code> and <code>error</code>). Default: <code>info</code> logMode String Defines the log mode in Authorino (<code>development</code> or <code>production</code>). Default: <code>production</code> listener Listener Specification of the authorization service (gRPC interface). Required oidcServer OIDCServer Specification of the OIDC service. Required tracing Tracing Configuration of the OpenTelemetry tracing exporter. Optional metrics Metrics Configuration of the metrics server (port, level). Optional healthz Healthz Configuration of the health/readiness probe (port). Optional volumes VolumesSpec Additional volumes to be mounted in the Authorino pods. Optional"},{"location":"authorino-operator/#listener","title":"Listener","text":"<p>Configuration of the authorization server \u2013 gRPC and raw HTTP interfaces</p> Field Type Description Required/Default port Integer Port number of authorization server (gRPC interface). DEPRECATEDUse <code>ports</code> instead ports Ports Port numbers of the authorization server (gRPC and raw HTTPinterfaces). Optional tls TLS TLS configuration of the authorization server (GRPC and HTTP interfaces). Required timeout Integer Timeout of external authorization request (in milliseconds), controlled internally by the authorization server. Default: <code>0</code> (disabled)"},{"location":"authorino-operator/#oidcserver","title":"OIDCServer","text":"<p>Configuration of the OIDC Discovery server for Festival Wristband tokens.</p> Field Type Description Required/Default port Integer Port number of OIDC Discovery server for Festival Wristband tokens. Default: <code>8083</code> tls TLS TLS configuration of the OIDC Discovery server for Festival Wristband tokens Required"},{"location":"authorino-operator/#tls","title":"TLS","text":"<p>TLS configuration of server. Appears in <code>listener</code> and <code>oidcServer</code>.</p> Field Type Description Required/Default enabled Boolean Whether TLS is enabled or disabled for the server. Default: <code>true</code> certSecretRef LocalObjectReference The reference to the secret that contains the TLS certificates <code>tls.crt</code> and <code>tls.key</code>. Required when <code>enabled: true</code>"},{"location":"authorino-operator/#ports","title":"Ports","text":"<p>Port numbers of the authorization server.</p> Field Type Description Required/Default grpc Integer Port number of the gRPC interface of the authorization server. Set to 0 to disable this interface. Default: <code>50001</code> http Integer Port number of the raw HTTP interface of the authorization server. Set to 0 to disable this interface. Default: <code>5001</code>"},{"location":"authorino-operator/#tracing","title":"Tracing","text":"<p>Configuration of the OpenTelemetry tracing exporter.</p> Field Type Description Required/Default endpoint String Full endpoint of the OpenTelemetry tracing collector service (e.g. http://jaeger:14268/api/traces). Required tags Map Key-value map of fixed tags to add to all OpenTelemetry traces emitted by Authorino. Optional insecure Boolean Enable/disable insecure connection to the tracing endpoint Default: <code>false</code>"},{"location":"authorino-operator/#metrics","title":"Metrics","text":"<p>Configuration of the metrics server.</p> Field Type Description Required/Default port Integer Port number of the metrics server. Default: <code>8080</code> deep Boolean Enable/disable metrics at the level of each evaluator config (if requested in the <code>AuthConfig</code>) exported by the metrics server. Default: <code>false</code>"},{"location":"authorino-operator/#healthz","title":"Healthz","text":"<p>Configuration of the health/readiness probe (port).</p> Field Type Description Required/Default port Integer Port number of the health/readiness probe. Default: <code>8081</code>"},{"location":"authorino-operator/#volumesspec","title":"VolumesSpec","text":"<p>Additional volumes to project in the Authorino pods. Useful for validation of TLS self-signed certificates of external services known to have to be contacted by Authorino at runtime.</p> Field Type Description Required/Default items []VolumeSpec List of additional volume items to project. Optional defaultMode Integer Mode bits used to set permissions on the files. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. Optional"},{"location":"authorino-operator/#volumespec","title":"VolumeSpec","text":"Field Type Description Required/Default name String Name of the volume and volume mount within the Deployment. It must be unique in the CR. Optional mountPath String Absolute path where to mount all the items. Required configMaps []String List of of Kubernetes ConfigMap names to mount. Required exactly one of: <code>confiMaps</code>, <code>secrets</code>. secrets []String List of of Kubernetes Secret names to mount. Required exactly one of: <code>confiMaps</code>, <code>secrets</code>. items []KeyToPath Mount details for selecting specific ConfigMap or Secret entries. Optional"},{"location":"authorino-operator/#full-example","title":"Full example","text":"<pre><code>apiVersion: operator.authorino.kuadrant.io/v1beta1\nkind: Authorino\nmetadata:\n  name: authorino\nspec:\n  clusterWide: true\n  authConfigLabelSelectors: environment=production\n  secretLabelSelectors: authorino.kuadrant.io/component=authorino,environment=production\n\n  replicas: 2\n\n  evaluatorCacheSize: 2 # mb\n\n  image: quay.io/kuadrant/authorino:latest\n  imagePullPolicy: Always\n\n  logLevel: debug\n  logMode: production\n\n  listener:\n    ports:\n      grpc: 50001\n      http: 5001\n    tls:\n      enabled: true\n      certSecretRef:\n        name: authorino-server-cert # secret must contain `tls.crt` and `tls.key` entries\n\n  oidcServer:\n    port: 8083\n    tls:\n      enabled: true\n      certSecretRef:\n        name: authorino-oidc-server-cert # secret must contain `tls.crt` and `tls.key` entries\n\n  metrics:\n    port: 8080\n    deep: true\n\n  volumes:\n    items:\n\n      - name: keycloak-tls-cert\n        mountPath: /etc/ssl/certs\n        configMaps:\n          - keycloak-tls-cert\n        items: # details to mount the k8s configmap in the authorino pods\n          - key: keycloak.crt\n            path: keycloak.crt\n    defaultMode: 420\n</code></pre>"},{"location":"authorino-operator/#removal","title":"Removal","text":""},{"location":"authorino-operator/#removing-the-operator-installed-via-manifests","title":"Removing the operator installed via manifests","text":"<ol> <li>Undeploy the Operator</li> </ol> <pre><code>make undeploy\n</code></pre> <ol> <li>Remove the Operator manifests</li> </ol> <pre><code>make uninstall\n</code></pre>"},{"location":"authorino-operator/#remove-dependencies-optional","title":"Remove dependencies (Optional)","text":"<ol> <li> <p>Remove operator namespace <pre><code>make delete-namespace\n</code></pre></p> </li> <li> <p>Uninstall cert manager <pre><code>make uninstall-cert-manager\n</code></pre></p> </li> </ol>"},{"location":"authorino-operator/#license","title":"License","text":""},{"location":"limitador/","title":"Limitador","text":"<p>Limitador is a generic rate-limiter written in Rust. It can be used as a library, or as a service. The service exposes HTTP endpoints to apply and observe limits. Limitador can be used with Envoy because it also exposes a grpc service, on a different port, that implements the Envoy Rate Limit protocol (v3).</p> <ul> <li>Getting started</li> <li>How it works</li> <li>Configuration</li> <li>Development</li> <li>Testing Environment</li> <li>Kubernetes</li> <li>Contributing</li> <li>License</li> </ul> <p>Limitador is under active development, and its API has not been stabilized yet.</p>"},{"location":"limitador/#getting-started","title":"Getting started","text":"<ul> <li>Rust library</li> <li>Server</li> </ul>"},{"location":"limitador/#rust-library","title":"Rust library","text":"<p>Add this to your <code>Cargo.toml</code>: <pre><code>[dependencies]\nlimitador = { version = \"0.3.0\" }\n</code></pre></p> <p>For more information, see the <code>README</code> of the crate</p>"},{"location":"limitador/#server","title":"Server","text":"<p>Run with Docker (replace <code>latest</code> with the version you want): <pre><code>docker run --rm --net=host -it quay.io/kuadrant/limitador:v1.0.0\n</code></pre></p> <p>Run locally: <pre><code>cargo run --release --bin limitador-server -- --help\n</code></pre></p> <p>Refer to the help message on how to start up the server. More information are available in the server's <code>README.md</code></p>"},{"location":"limitador/#development","title":"Development","text":""},{"location":"limitador/#build","title":"Build","text":"<pre><code>cargo build\n</code></pre>"},{"location":"limitador/#run-the-tests","title":"Run the tests","text":"<p>Some tests need a redis deployed in <code>localhost:6379</code>. You can run it in Docker with: <pre><code>docker run --rm -p 6379:6379 -it redis\n</code></pre></p> <p>Then, run the tests:</p> <pre><code>cargo test --all-features\n</code></pre> <p>or you can run tests disabling the \"redis storage\" feature: <pre><code>cd limitador; cargo test --no-default-features\n</code></pre></p>"},{"location":"limitador/#contributing","title":"Contributing","text":"<p>Join us on the #kuadrant channel in the Kubernetes Slack workspace, for live discussions about the roadmap and more.</p>"},{"location":"limitador/#license","title":"License","text":"<p>Apache 2.0 License</p> <p></p>"},{"location":"limitador/doc/how-it-works/","title":"How it works","text":""},{"location":"limitador/doc/how-it-works/#how-it-works","title":"How it works","text":"<p>Limitador ensures that the most restrictive limit configuration will apply.</p> <p>Limitador will try to match each incoming descriptor with the same namespaced counter's conditions and variables. The namespace for the descriptors is defined by the <code>domain</code> field whereas for the rate limit configuration the <code>namespace</code> field is being used. For each matching counter, the counter is increased and the limits checked.</p> <p>One example to illustrate:</p> <p>Let's say we have 1 rate limit configuration (one counter per config):</p> <pre><code>conditions: [\"KEY_A == 'VALUE_A'\"]\nmax_value: 1\nseconds: 60\nvariables: []\nnamespace: example.org\n</code></pre> <p>Limitador receives one descriptor with two entries:</p> <pre><code>domain: example.org\ndescriptors:\n\n  - entries:\n    - KEY_A: VALUE_A\n    - OTHER_KEY: OTHER_VALUE\n</code></pre> <p>The counter's condition will match. Then, the counter will be increased and the limit checked. If the limit is exceeded, the request will be rejected with <code>429 Too Many Requests</code>, otherwise accepted.</p> <p>Note that the counter is being activated even though it does not match all the entries of the descriptor. The same rule applies for the variables field.</p> <p>Currently, the implementation of condition only allow for equal (<code>==</code>) and not equal (<code>!=</code>) operators. More operators will be implemented based off the use cases for them.</p> <p>The variables field is a list of keys. The matching rule is defined just as the existence of the list of descriptor entries with the same key values. If variables is <code>variables: [A, B, C]</code>, one descriptor matches if it has at least three entries with the same A, B, C keys.</p> <p>Few examples to illustrate.</p> <p>Having the following descriptors:</p> <pre><code>domain: example.org\ndescriptors:\n\n  - entries:\n    - KEY_A: VALUE_A\n    - OTHER_KEY: OTHER_VALUE\n</code></pre> <p>the following counters would not be activated.</p> <p><pre><code>conditions: [\"KEY_B == 'VALUE_B'\"]\nmax_value: 1\nseconds: 60\nvariables: []\nnamespace: example.org\n</code></pre> Reason: conditions key does not exist</p> <p><pre><code>conditions:\n\n  - \"KEY_A == 'VALUE_A'\"\n  - \"OTHER_KEY == 'WRONG_VALUE'\"\nmax_value: 1\nseconds: 60\nvariables: []\nnamespace: example.org\n</code></pre> Reason: not all the conditions match</p> <p><pre><code>conditions: []\nmax_value: 1\nseconds: 60\nvariables: [\"MY_VAR\"]\nnamespace: example.org\n</code></pre> Reason: the variable name does not exist</p> <p><pre><code>conditions: [\"KEY_B == 'VALUE_B'\"]\nmax_value: 1\nseconds: 60\nvariables: [\"MY_VAR\"]\nnamespace: example.org\n</code></pre> Reason: Both variables and conditions must match. In this particular case, only conditions match</p>"},{"location":"limitador/doc/topologies/","title":"Deployment topologies","text":""},{"location":"limitador/doc/topologies/#in-memory","title":"In-memory","text":""},{"location":"limitador/doc/topologies/#redis","title":"Redis","text":""},{"location":"limitador/doc/topologies/#redis-active-active-storage","title":"Redis active-active storage","text":"<p>The RedisLabs version of Redis supports active-active replication. Limitador is compatible with that deployment mode, but there are a few things to take into account regarding limit accuracy.</p>"},{"location":"limitador/doc/topologies/#considerations","title":"Considerations","text":"<p>With an active-active deployment, the data needs to be replicated between instances. An update in an instance takes a short time to be reflected in the other. That time lag depends mainly on the network speed between the Redis instances, and it affects the accuracy of the rate-limiting performed by Limitador because it can go over limits while the updates of the counters are being replicated.</p> <p>The impact of that greatly depends on the use case. With limits of a few seconds, and a low number of hits, we could easily go over limits. On the other hand, if we have defined limits with a high number of hits and a long period, the effect will be basically negligible. For example, if we define a limit of one hour, and we know that the data takes around one second to be replicated, the accuracy loss is going to be negligible.</p>"},{"location":"limitador/doc/topologies/#set-up","title":"Set up","text":"<p>In order to try active-active replication, you can follow this tutorial from RedisLabs.</p>"},{"location":"limitador/doc/topologies/#disk","title":"Disk","text":"<p>Disk storage using RocksDB. Counters are held on disk (persistent).</p>"},{"location":"limitador/doc/migrations/conditions/","title":"New condition syntax","text":"<p>With <code>limitador-server</code> version <code>1.0.0</code> (and the <code>limitador</code> crate version <code>0.3.0</code>), the syntax for <code>condition</code>s within  <code>limit</code> definitions has changed.</p>"},{"location":"limitador/doc/migrations/conditions/#changes","title":"Changes","text":""},{"location":"limitador/doc/migrations/conditions/#the-new-syntax","title":"The new syntax","text":"<p>The new syntax formalizes what part of an expression is the identifier and which is the value to test against.  Identifiers are simple string value, while string literals are to be demarcated by single quotes (<code>'</code>) or double quotes (<code>\"</code>) so that <code>foo == \" bar\"</code> now makes it explicit that the value is to be prefixed with a space character.</p> <p>A few remarks:</p> <ul> <li>Only <code>string</code> values are supported, as that's what they really are</li> <li>There is no escape character sequence supported in string literals</li> <li>A new operator has been added, <code>!=</code></li> </ul>"},{"location":"limitador/doc/migrations/conditions/#the-issue-with-the-deprecated-syntax","title":"The issue with the deprecated syntax","text":"<p>The previous syntax wouldn't differentiate between values and the identifier, so that <code>foo == bar</code> was valid. In this case <code>foo</code> was the identifier of the variable, while <code>bar</code> was the value to evaluate it against. Whitespaces before and after the operator <code>==</code> would be equally important. SO that <code>foo  ==  bar</code> would test for a <code>foo</code> variable being equal to <code>bar</code> where the trailing whitespace after the identifier, and the one prefixing the value, would have been evaluated.</p>"},{"location":"limitador/doc/migrations/conditions/#server-binary-users","title":"Server binary users","text":"<p>The server still allows for the deprecated syntax, but warns about its usage. You can easily migrate your limits file,  using the following command:</p> <pre><code>limitador-server --validate old_limits.yaml &gt; updated_limits.yaml\n</code></pre> <p>Which should output <code>Deprecated syntax for conditions corrected!</code> to <code>stderr</code> while <code>stdout</code> would be the limits using  the new syntax. It is recommended you manually verify the resulting <code>LIMITS_FILE</code>.</p>"},{"location":"limitador/doc/migrations/conditions/#crate-users","title":"Crate users","text":"<p>A feature <code>lenient_conditions</code> has been added, which lets you use the syntax used in previous version of the crate. The function <code>limitador::limit::check_deprecated_syntax_usages_and_reset()</code> lets you verify if the deprecated syntax  has been used as <code>limit::Limit</code>s are created with their condition strings using the deprecated syntax.</p>"},{"location":"limitador/doc/server/configuration/","title":"Limitador configuration","text":""},{"location":"limitador/doc/server/configuration/#command-line-configuration","title":"Command line configuration","text":"<p>The preferred way of starting and configuring the Limitador server is using the command line:</p> <pre><code>Rate Limiting Server\n\nUsage: limitador-server [OPTIONS] &lt;LIMITS_FILE&gt; [STORAGE]\n\nSTORAGES:\n  memory        Counters are held in Limitador (ephemeral)\n  disk          Counters are held on disk (persistent)\n  redis         Uses Redis to store counters\n  redis_cached  Uses Redis to store counters, with an in-memory cache\n\nArguments:\n  &lt;LIMITS_FILE&gt;  The limit file to use\n\nOptions:\n  -b, --rls-ip &lt;ip&gt;\n          The IP to listen on for RLS [default: 0.0.0.0]\n  -p, --rls-port &lt;port&gt;\n          The port to listen on for RLS [default: 8081]\n  -B, --http-ip &lt;http_ip&gt;\n          The IP to listen on for HTTP [default: 0.0.0.0]\n  -P, --http-port &lt;http_port&gt;\n          The port to listen on for HTTP [default: 8080]\n  -l, --limit-name-in-labels\n          Include the Limit Name in prometheus label\n  -v...\n          Sets the level of verbosity\n      --tracing-endpoint &lt;tracing_endpoint&gt;\n          The endpoint for the tracing service\n      --validate\n          Validates the LIMITS_FILE and exits\n  -H, --rate-limit-headers &lt;rate_limit_headers&gt;\n          Enables rate limit response headers [default: NONE] [possible values: NONE, DRAFT_VERSION_03]\n      --grpc-reflection-service\n          Enables gRPC server reflection service\n  -h, --help\n          Print help\n  -V, --version\n          Print version\n</code></pre> <p>The values used are authoritative over any environment variables independently set.</p>"},{"location":"limitador/doc/server/configuration/#limit-definitions","title":"Limit definitions","text":"<p>The <code>LIMITS_FILE</code> provided is the source of truth for all the limits that will be enforced. The file location will be monitored by the server for any changes and be hot reloaded. If the changes are invalid, they will be ignored on hot reload, or the server will fail to start.</p>"},{"location":"limitador/doc/server/configuration/#the-limits_files-format","title":"The <code>LIMITS_FILE</code>'s format","text":"<p>When starting the server, you point it to a <code>LIMITS_FILE</code>, which is expected to be a yaml file with an array of <code>limit</code> definitions, with the following format:</p> <pre><code>---\n\"$schema\": http://json-schema.org/draft-04/schema#\ntype: object\nproperties:\n  name:\n    type: string\n  namespace:\n    type: string\n  seconds:\n    type: integer\n  max_value:\n    type: integer\n  conditions:\n    type: array\n    items:\n\n      - type: string\n  variables:\n    type: array\n    items:\n      - type: string\nrequired:\n  - namespace\n  - seconds\n  - max_value\n  - conditions\n  - variables\n</code></pre> <p>Here is an example of such a limit definition:</p> <pre><code>namespace: example.org\nmax_value: 10\nseconds: 60\nconditions:\n\n  - \"req.method == 'GET'\"\nvariables:\n  - user_id\n</code></pre> <ul> <li><code>namespace</code> namespaces the limit, will generally be the domain, see here</li> <li><code>seconds</code> is the duration for which the limit applies, in seconds: e.g. <code>60</code> is a span of time of one minute</li> <li><code>max_value</code> is the actual limit, e.g. <code>100</code> would limit to 100 requests</li> <li><code>name</code> lets the user optionally name the limit</li> <li><code>variables</code> is an array of variables, which once resolved, will be used to qualify counters for the limit,    e.g. <code>api_key</code> to limit per api keys</li> <li><code>conditions</code> is an array of conditions, which once evaluated will decide whether to apply the limit or not</li> </ul>"},{"location":"limitador/doc/server/configuration/#condition-syntax","title":"<code>condition</code> syntax","text":"<p>Each <code>condition</code> is an expression producing a boolean value (<code>true</code> or <code>false</code>). All <code>conditions</code> must evaluate to <code>true</code> for the <code>limit</code> to be applied on a request.</p> <p>Expressions follow the following syntax: <code>$IDENTIFIER $OP $STRING_LITERAL</code>, where:</p> <ul> <li><code>$IDENTIFIER</code> will be used to resolve the value at evaluation time, e.g. <code>role</code></li> <li><code>$OP</code> is an operator, either <code>==</code> or <code>!=</code></li> <li><code>$STRING_LITERAL</code> is a literal string value, <code>\"</code> or <code>'</code> demarcated, e.g. <code>\"admin\"</code></li> </ul> <p>So that <code>role != \"admin\"</code> would apply the limit on request from all users, but <code>admin</code>'s.</p>"},{"location":"limitador/doc/server/configuration/#counter-storages","title":"Counter storages","text":"<p>Limitador will load all the <code>limit</code> definitions from the <code>LIMITS_FILE</code> and keep these in memory. To enforce these limits, Limitador needs to track requests in the form of counters. There would be at least one counter per limit, but that number grows when <code>variables</code> are used to qualify counters per some arbitrary values.</p>"},{"location":"limitador/doc/server/configuration/#memory","title":"<code>memory</code>","text":"<p>As the name implies, Limitador will keep all counters in memory. This yields the best results in terms of latency as well as accuracy. By default, only up to <code>1000</code> \"concurrent\" counters will be kept around, evicting the oldest entries. \"Concurrent\" in this context means counters that need to exist at the \"same time\", based of the period of the limit, as \"expired\" counters are discarded.</p> <p>This storage is ephemeral, as if the process is restarted, all the counters are lost and effectively \"reset\" all the limits as if no traffic had been rate limited, which can be fine for short-lived limits, less for longer-lived ones.</p>"},{"location":"limitador/doc/server/configuration/#redis","title":"<code>redis</code>","text":"<p>When you want persistence of your counters, such as for disaster recovery or across restarts, using <code>redis</code> will store the counters in a redis instance using the provided <code>URL</code>. Increments to individual counters is made within redis itself, providing accuracy over these, races tho can occur when multiple Limitador servers are used against a single redis and using \"stacked\" limits (i.e. over different periods). Latency is also impacted, as it results in one additional hop to talk to redis and maintain the counters.</p> <p>TLS Support</p> <p>Connect to a redis instance using the <code>rediss://</code> URL scheme.</p> <p>To enable insecure mode, append <code>#insecure</code> at the end of the URL. For example:</p> <pre><code>limitador-server &lt;LIMITS_FILE&gt; redis rediss://127.0.0.1/#insecure\"\n</code></pre> <p>Authentication</p> <p>To enable authentication, use the username and password properties of the URL scheme. For example:</p> <pre><code>limitador-server &lt;LIMITS_FILE&gt; redis redis://my-username:my-password@127.0.0.1\"\n</code></pre> <p>when the username is omitted, redis assumes <code>default</code> user. For example:</p> <pre><code>limitador-server &lt;LIMITS_FILE&gt; redis redis://:my-password@127.0.0.1\"\n</code></pre> <p>Usage</p> <pre><code>Uses Redis to store counters\n\nUsage: limitador-server &lt;LIMITS_FILE&gt; redis &lt;URL&gt;\n\nArguments:\n  &lt;URL&gt;  Redis URL to use\n\nOptions:\n  -h, --help  Print help\n</code></pre>"},{"location":"limitador/doc/server/configuration/#redis_cached","title":"<code>redis_cached</code>","text":"<p>In order to avoid some communication overhead to redis, <code>redis_cached</code> adds an in memory caching layer within the Limitador servers. This lowers the latency, but sacrifices some accuracy as it will not only cache counters, but also coalesce counters updates to redis over time. See this configuration option for more information.</p> <p>TLS Support</p> <p>Connect to a redis instance using the <code>rediss://</code> URL scheme.</p> <p>To enable insecure mode, append <code>#insecure</code> at the end of the URL. For example:</p> <pre><code>limitador-server &lt;LIMITS_FILE&gt; redis rediss://127.0.0.1/#insecure\"\n</code></pre> <p>Authentication</p> <p>To enable authentication, use the username and password properties of the URL scheme. For example:</p> <pre><code>limitador-server &lt;LIMITS_FILE&gt; redis redis://my-username:my-password@127.0.0.1\"\n</code></pre> <p>when the username is omitted, redis assumes <code>default</code> user. For example:</p> <pre><code>limitador-server &lt;LIMITS_FILE&gt; redis redis://:my-password@127.0.0.1\"\n</code></pre> <p>Usage</p> <pre><code>Uses Redis to store counters, with an in-memory cache\n\nUsage: limitador-server &lt;LIMITS_FILE&gt; redis_cached [OPTIONS] &lt;URL&gt;\n\nArguments:\n  &lt;URL&gt;  Redis URL to use\n\nOptions:\n      --batch-size &lt;batch&gt;          Size of entries to flush in as single flush [default: 100]\n      --flush-period &lt;flush&gt;        Flushing period for counters in milliseconds [default: 1000]\n      --max-cached &lt;max&gt;            Maximum amount of counters cached [default: 10000]\n      --response-timeout &lt;timeout&gt;  Timeout for Redis commands in milliseconds [default: 350]\n  -h, --help                        Print help\n</code></pre>"},{"location":"limitador/doc/server/configuration/#disk","title":"<code>disk</code>","text":"<p>Disk storage using RocksDB. Counters are held on disk (persistent).</p> <pre><code>Counters are held on disk (persistent)\n\nUsage: limitador-server &lt;LIMITS_FILE&gt; disk [OPTIONS] &lt;PATH&gt;\n\nArguments:\n  &lt;PATH&gt;  Path to counter DB\n\nOptions:\n      --optimize &lt;OPTIMIZE&gt;  Optimizes either to save disk space or higher throughput [default: throughput] [possible values: throughput, disk]\n  -h, --help                 Print help\n</code></pre> <p>For an in-depth coverage of the different topologies supported and how they affect the behavior, see the topologies' document.</p>"},{"location":"limitador/doc/server/configuration/#configuration-using-environment-variables","title":"Configuration using environment variables","text":"<p>The Limitador server has some options that can be configured with environment variables. These will override the default values the server uses. Any argument used when starting the server will prevail over the environment variables.</p>"},{"location":"limitador/doc/server/configuration/#envoy_rls_host","title":"<code>ENVOY_RLS_HOST</code>","text":"<ul> <li>Host where the Envoy RLS server listens.</li> <li>Optional. Defaults to <code>\"0.0.0.0\"</code>.</li> <li>Format: <code>string</code>.</li> </ul>"},{"location":"limitador/doc/server/configuration/#envoy_rls_port","title":"<code>ENVOY_RLS_PORT</code>","text":"<ul> <li>Port where the Envoy RLS server listens.</li> <li>Optional. Defaults to <code>8081</code>.</li> <li>Format: <code>integer</code>.</li> </ul>"},{"location":"limitador/doc/server/configuration/#http_api_host","title":"<code>HTTP_API_HOST</code>","text":"<ul> <li>Host where the HTTP server listens.</li> <li>Optional. Defaults to <code>\"0.0.0.0\"</code>.</li> <li>Format: <code>string</code>.</li> </ul>"},{"location":"limitador/doc/server/configuration/#http_api_port","title":"<code>HTTP_API_PORT</code>","text":"<ul> <li>Port where the HTTP API listens.</li> <li>Optional. Defaults to <code>8080</code>.</li> <li>Format: <code>integer</code>.</li> </ul>"},{"location":"limitador/doc/server/configuration/#limits_file","title":"<code>LIMITS_FILE</code>","text":"<ul> <li>YAML file that contains the limits to create when Limitador boots. If the limits specified already have counters associated, Limitador will not delete them. Changes to the file will be picked up by the running server.</li> <li>Required. No default</li> <li>Format: <code>string</code>, file path.</li> </ul>"},{"location":"limitador/doc/server/configuration/#limit_name_in_prometheus_labels","title":"<code>LIMIT_NAME_IN_PROMETHEUS_LABELS</code>","text":"<ul> <li>Enables using limit names as labels in Prometheus metrics. This is disabled by default because for a few limits it should be fine, but it could become a problem when defining lots of limits. See the caution note in the Prometheus docs</li> <li>Optional. Disabled by default.</li> <li>Format: <code>bool</code>, set to <code>\"1\"</code> to enable.</li> </ul>"},{"location":"limitador/doc/server/configuration/#tracing_endpoint","title":"<code>TRACING_ENDPOINT</code>","text":"<ul> <li>The endpoint of the OTLP tracing collector (scheme://host:port).</li> <li>Optional. Default to <code>\"\"</code> (tracing disabled)</li> <li>Format: <code>string</code></li> </ul>"},{"location":"limitador/doc/server/configuration/#redis_local_cache_enabled","title":"<code>REDIS_LOCAL_CACHE_ENABLED</code>","text":"<ul> <li>Enables a storage implementation that uses Redis, but also caches some data in memory. The idea is to improve throughput and latencies by caching the counters in memory to reduce the number of accesses to Redis. To achieve that, this mode sacrifices some rate-limit accuracy. This mode does two things:<ul> <li>Batches counter updates. Instead of updating the counters on every request, it updates them in memory and commits them to Redis in batches. The flushing interval can be configured with the <code>REDIS_LOCAL_CACHE_FLUSHING_PERIOD_MS</code> env. The trade-off is that when running several instances of Limitador, other instances will not become aware of the counter updates until they're committed to Redis.</li> <li>Caches counters. Instead of fetching the value of a counter every time it's needed, the value is cached for a configurable period. The trade-off is that when running several instances of Limitador, an instance will not become aware of the counter updates other instances do while the value is cached. When a counter is already at 0 (limit exceeded), it's cached until it expires in Redis. In this case, no matter what other instances do, we know that the quota will not be reestablished until the key expires in Redis, so in this case, rate-limit accuracy is not affected. When a counter has still some quota remaining the situation is different, that's why we can tune for how long it will be cached. The formula is as follows: MIN(ttl_in_redis/<code>REDIS_LOCAL_CACHE_TTL_RATIO_CACHED_COUNTERS</code>, <code>REDIS_LOCAL_CACHE_MAX_TTL_CACHED_COUNTERS_MS</code>). For example, let's image that the current TTL (time remaining until the limit resets) in Redis for a counter is 10 seconds, and we set the ratio to 2, and the max time for 30s. In this case, the counter will be cached for 5s (min(10/2, 30)). During those 5s, Limitador will not fetch the value of that counter from Redis, so it will answer faster, but it will also miss the updates done by other instances, so it can go over the limits in that 5s interval.</li> </ul> </li> <li>Optional. Disabled by default.</li> <li>Format: set to \"1\" to enable.</li> <li>Note: \"REDIS_URL\" needs to be set.</li> </ul>"},{"location":"limitador/doc/server/configuration/#redis_local_cache_flushing_period_ms","title":"<code>REDIS_LOCAL_CACHE_FLUSHING_PERIOD_MS</code>","text":"<ul> <li>Used to configure the maximum flushing period. See <code>REDIS_LOCAL_CACHE_ENABLED</code>. This env only applies when <code>\"REDIS_LOCAL_CACHE_ENABLED\" == 1</code>.</li> <li>Optional. Defaults to <code>1000</code>.</li> <li>Format: <code>integer</code>. Duration in milliseconds.</li> </ul>"},{"location":"limitador/doc/server/configuration/#redis_local_cache_batch_size","title":"<code>REDIS_LOCAL_CACHE_BATCH_SIZE</code>","text":"<ul> <li>Used to configure the maximum number of counters to update in a flush. See <code>REDIS_LOCAL_CACHE_ENABLED</code>. This env only applies when <code>\"REDIS_LOCAL_CACHE_ENABLED\" == 1</code>.</li> <li>Optional. Defaults to <code>100</code>.</li> <li>Format: <code>integer</code>. </li> </ul>"},{"location":"limitador/doc/server/configuration/#redis_url","title":"<code>REDIS_URL</code>","text":"<ul> <li>Redis URL. Required only when you want to use Redis to store the limits.</li> <li>Optional. By default, Limitador stores the limits in memory and does not require Redis.</li> <li>Format: <code>string</code>, URL in the format of <code>\"redis://127.0.0.1:6379\"</code>.</li> </ul>"},{"location":"limitador/doc/server/configuration/#rust_log","title":"<code>RUST_LOG</code>","text":"<ul> <li>Defines the log level.</li> <li>Optional. Defaults to <code>\"error\"</code>.</li> <li>Format: <code>enum</code>: <code>\"debug\"</code>, <code>\"error\"</code>, <code>\"info\"</code>, <code>\"warn\"</code>, or <code>\"trace\"</code>.</li> </ul>"},{"location":"limitador/doc/server/configuration/#rate_limit_headers","title":"<code>RATE_LIMIT_HEADERS</code>","text":"<ul> <li>Enables rate limit response headers. Only supported by the RLS server.</li> <li>Optional. Defaults to <code>\"NONE\"</code>.</li> <li>Must be one of:</li> <li><code>\"NONE\"</code> - Does not add any additional headers to the http response.</li> <li><code>\"DRAFT_VERSION_03\"</code>.  Adds response headers per https://datatracker.ietf.org/doc/id/draft-polli-ratelimit-headers-03.html</li> </ul>"},{"location":"limitador/limitador/","title":"Limitador (library)","text":"<p>An embeddable rate-limiter library supporting in-memory, Redis and disk data stores.</p> <p>For the complete documentation of the crate's API, please refer to docs.rs</p>"},{"location":"limitador/limitador/#features","title":"Features","text":"<ul> <li><code>redis_storage</code>: support for using Redis as the data storage backend.</li> <li><code>disk_storage</code>: support for using RocksDB as a local disk storage backend.</li> <li><code>lenient_conditions</code>: support for the deprecated syntax of <code>Condition</code>s</li> <li><code>default</code>: <code>redis_storage</code>.</li> </ul>"},{"location":"limitador/limitador-server/","title":"Limitador (server)","text":"<p>By default, Limitador starts the HTTP server in <code>localhost:8080</code>, and the grpc service that implements the Envoy Rate Limit protocol in <code>localhost:8081</code>. That can be configured with these ENVs: <code>ENVOY_RLS_HOST</code>, <code>ENVOY_RLS_PORT</code>, <code>HTTP_API_HOST</code>, and <code>HTTP_API_PORT</code>.</p> <p>Or using the command line arguments:</p> <pre><code>Rate Limiting Server\n\nUsage: limitador-server [OPTIONS] &lt;LIMITS_FILE&gt; [STORAGE]\n\nSTORAGES:\n  memory        Counters are held in Limitador (ephemeral)\n  disk          Counters are held on disk (persistent)\n  redis         Uses Redis to store counters\n  redis_cached  Uses Redis to store counters, with an in-memory cache\n\nArguments:\n  &lt;LIMITS_FILE&gt;  The limit file to use\n\nOptions:\n  -b, --rls-ip &lt;ip&gt;\n          The IP to listen on for RLS [default: 0.0.0.0]\n  -p, --rls-port &lt;port&gt;\n          The port to listen on for RLS [default: 8081]\n  -B, --http-ip &lt;http_ip&gt;\n          The IP to listen on for HTTP [default: 0.0.0.0]\n  -P, --http-port &lt;http_port&gt;\n          The port to listen on for HTTP [default: 8080]\n  -l, --limit-name-in-labels\n          Include the Limit Name in prometheus label\n  -v...\n          Sets the level of verbosity\n      --tracing-endpoint &lt;tracing_endpoint&gt;\n          The endpoint for the tracing service\n      --validate\n          Validates the LIMITS_FILE and exits\n  -H, --rate-limit-headers &lt;rate_limit_headers&gt;\n          Enables rate limit response headers [default: NONE] [possible values: NONE, DRAFT_VERSION_03]\n  -h, --help\n          Print help\n  -V, --version\n          Print version\n</code></pre> <p>When using environment variables, these will override the defaults. While environment variable are themselves overridden by the command line arguments provided. See the individual <code>STORAGES</code> help for more options relative to each of the storages.</p> <p>The OpenAPI spec of the HTTP service is here.</p> <p>Limitador has to be started with a YAML file that has some limits defined. There's an example file that allows 10 requests per minute and per <code>user_id</code> when the HTTP method is <code>\"GET\"</code> and 5 when it is a <code>\"POST\"</code>. You can run it with Docker (replace <code>latest</code> with the version you want): <pre><code>docker run --rm --net=host -it -v $(pwd)/examples/limits.yaml:/home/limitador/my_limits.yaml:ro quay.io/kuadrant/limitador:latest limitador-server /home/limitador/my_limits.yaml\n</code></pre></p> <p>You can also use the YAML file when running locally: <pre><code>cargo run --release --bin limitador-server ./examples/limits.yaml\n</code></pre></p> <p>If you want to use Limitador with Envoy, there's a minimal Envoy config for testing purposes here. The config forwards the \"userid\" header and the request method to Limitador. It assumes that there's an upstream API deployed on port 1323. You can use echo, for example.</p> <p>Limitador has several options that can be configured via ENV. This doc specifies them.</p>"},{"location":"limitador/limitador-server/#limits-storage","title":"Limits storage","text":"<p>Limitador can store its limits and counters in-memory, disk or in Redis. In-memory is faster, but the limits are applied per instance. When using Redis, multiple instances of Limitador can share the same limits, but it's slower.</p>"},{"location":"limitador/limitador-server/kubernetes/","title":"Kubernetes","text":"<p>The purpose of this documentation is to deploy a sample application published via AWS ELB, that will be ratelimited at infrastructure level, thanks to the use the envoyproxy sidecar container, that will be in charge of contacting to a  ratelimit service (limitador), that will allow the request (or not) if it is within the permitted  limits.</p> <p>There are mainly two recommended way of using limitador in kubernetes:</p> <ol> <li>There is an ingress based on envoyproxy that contacts with limitador ratelimit service before forwarding (or not) the request to the application</li> <li>There is an envoyproxy sidecar container living in the application pod that contacts with limitador ratelimit service before forwarding (or not) the request to the main application container in the same pod</li> </ol> <p>In this example it will be described the second scenario (where there is an application with an envoyproxy sidecar container contacting to limitador service).</p> <p>NOTE  If you don't want to manually manage the sidecar container definitions on your deployments (harcoding the container spec, loading the envoy configuration from a configmap that requires a pod restart to reload possibles configuration changes...), you can use marin3r, a light weight envoy control plane that allows you to inject envoyproxy sidecar containers and dynamically consume configs from Kubernetes custom resources.</p> <p>This is the network diagram of the deployed example:</p> <p></p>"},{"location":"limitador/limitador-server/kubernetes/#components","title":"Components","text":"<p>In order to that that ratelimit test, you need to deploy a few components. Some of them are mandatory, and a few are optional:</p>"},{"location":"limitador/limitador-server/kubernetes/#mandatory","title":"Mandatory","text":"<ul> <li>Application (a sample application deployment called <code>kuard</code>):</li> <li>App has an <code>envoyproxy</code> sidecar container with its configuration file in a configmap, composed by:<ul> <li>Cluster <code>kuard</code> points to main application container (<code>127.0.0.1:8080</code>)</li> <li>Cluster <code>kuard_ratelimit</code> points to limitador headless service (<code>limitador:8081</code>)</li> <li>Listener HTTP points to envoyproxy sidecar (<code>0.0.0.0:38080</code>)</li> <li>When envoy contacts with the ratelimit service, you can define a timeout, and if there is no response within that timeout (because ratelimit is overloaded taking more time to process the request, or because rateliit service is down), you can choose from envoy to deny the request or pass it to the application. In this case, there is set a 1s timeout, and if there is no answer in this 1 second, request is passed to the application (<code>failure_mode_deny: false</code>), so we guarantee that the maximum overhead added by a non working ratelimit service is 1 extra second to the final response time.</li> </ul> </li> <li> <p>App service published with <code>type: LoadBalancer</code>, which creates a AWS ELB. This service has an annotation to enable proxy protocol on the AWS Load balancer in order to be able to keep the real client IP at envoy level (instead of the k8s node private IP), so it can be used to ratelimit per each real client IP if desired.</p> </li> <li> <p>Ratelimit application (a deployment called <code>limitador</code>):</p> </li> <li>Limitador Configmap with limits definition (1000 rps per hostname).</li> <li> <p>Limitador headless service published on <code>limitador:8081</code>. It is important to use a headless service in order to balance correctly the traffic between limitador pods, otherwise GRPC connections are not well balanced.</p> </li> <li> <p>Redis database to persist ratelimit configuration:</p> </li> <li>Redis service</li> <li>Redis statefulset with a persistent volume</li> </ul>"},{"location":"limitador/limitador-server/kubernetes/#optional","title":"Optional","text":"<ul> <li>Centos pod:</li> <li>Used to executed <code>hey</code> tool benchmarks from the cluster, so we ensure network latency does not affect the results. Actually, to achieve better results, this pod should be on another cluster (to not share the network between client and network) and be placed on the same Region (to reduce latency). The client could be a bottle neck for the performance test.</li> <li>This centos is going to public AWS ELB to access the app, so simulating it is a normal client from the same Region</li> <li>Prometheus monitoring and grafana dashboard resources</li> </ul>"},{"location":"limitador/limitador-server/kubernetes/#k8s-deployment","title":"K8s deployment","text":"<ul> <li> <p>Deploy the redis instance that will keep the limits for different limitador pods: <pre><code>kubectl apply -f redis-service.yaml\nkubectl apply -f redis-statefulset.yaml\n</code></pre></p> </li> <li> <p>Deploy limitador application. It is important to create the configmap with limitador limits before the deployment, in order to load it from limitador pods. At the moment, if you update the limits configmap you need to restart the pods. Additionally, limitador has an API in order to load limits dynamically, but for simplicity for this test a configmap has been used: <pre><code>kubectl apply -f limitador-config-configmap.yaml\nkubectl apply -f limitador-service.yaml\nkubectl apply -f limitador-deployment.yaml\n</code></pre></p> </li> <li> <p>Deploy sample kuard application with the envoyproxy sidecar container (if you do any change on the envoy configmap, remember you need to restart app pods in order to reload the config): <pre><code>kubectl apply -f kuard-envoy-config-configmap.yaml\nkubectl apply -f kuard-service.yaml\nkubectl apply -f kuard-deployment.yaml\n</code></pre></p> </li> <li> <p>At this point you shoud see all pods running, and kuard pods should have 2 containers (the main  kuard container, and the envoyproxy sidecar container): <pre><code>\u25b6 kubectl get pods\nNAME                         READY   STATUS    RESTARTS   AGE\nkuard-f859bb896-gmzxn        2/2     Running   0          7m\nkuard-f859bb896-z95w8        2/2     Running   0          7m\nlimitador-68d494f54c-qv996   1/1     Running   0          8m\nlimitador-68d494f54c-zzmhn   1/1     Running   0          8m\nredis-0                      1/1     Running   0          9m\n</code></pre></p> </li> <li> <p>Now you should be able to access to kuard application using the load balancer DNS name: <pre><code>\u25b6 kubectl get service kuard\nNAME    TYPE           CLUSTER-IP       EXTERNAL-IP                                                              PORT(S)        AGE\nkuard   LoadBalancer   172.30.117.198   a96d5449fbc3f4cd892e15e5b36cde48-457963259.us-east-1.elb.amazonaws.com   80:31450/TCP   4m\n</code></pre></p> </li> <li> <p>If you go to the browser and paste the <code>EXTERNAL-IP</code>, your request will follow the next workflow:</p> </li> <li>The requests will go from your local machine through internet to the public AWS ELB where the app is published</li> <li>Then it will go to the <code>NodePort</code> of your k8s cluster nodes</li> <li>Once on a k8s node, it will go to kuard <code>Service</code> Virtual IP, and will arrive to an envoyproxy sidecar container inside kuard pod</li> <li>Envoyproxy sidecar container will contact with limitador headless <code>Service</code>, to authorize the requests or not:<ul> <li>If the request is authorized (within the configured limits), it will send the request to the app container (<code>0.0.0.0:8080</code>) in the same pod, and request will end up with a <code>HTTP 200</code> response</li> <li>If the request is limited (beyond the limits), request will end up with <code>HTTP 429</code> response</li> </ul> </li> </ul>"},{"location":"limitador/limitador-server/kubernetes/#monitoring","title":"Monitoring","text":"<p>Both <code>envoyproxy</code> sidecar and <code>limitador</code> applications include built-in prometheus metrics.</p>"},{"location":"limitador/limitador-server/kubernetes/#prometheus","title":"Prometheus","text":"<p>In order to scrape that metrics within a prometheus-operator deployed in the cluster, you need to create a <code>PodMonitor</code> resource for every application: <pre><code>kubectl apply -f kuard-podmonitor.yaml\nkubectl apply -f limitador-podmonitor.yaml\n</code></pre></p>"},{"location":"limitador/limitador-server/kubernetes/#grafana-dashboard","title":"Grafana dashboard","text":"<p>Then, if you have grafana deployed in the cluster, you can import a Kuadrant Limitador grafana dashboard that we have prepared, which includes:</p> <ul> <li>Kuard envoyproxy sidecar metrics (globally and per pod)</li> <li>Limitador metrics (globally and per pod)</li> <li>And for every deployed component (limitador, kuard, redis):</li> <li>Number of pods (total, available, unavaible, pod restarts...)</li> <li>CPU usage per pod</li> <li>Memory usage per pod</li> <li>Network usage per pod</li> </ul>"},{"location":"limitador/limitador-server/kubernetes/#benchmarking","title":"Benchmarking","text":"<ul> <li>In order to check that the ratelimit is working as expected, you can use any benchmarking tool, like hey</li> <li>You can use if you want a centos pod (better to create it on a different custer within the same Region): <pre><code>kubectl apply -f centos-pod.yaml\n</code></pre></li> <li>Connect to centos pod: <pre><code>kubectl exec --stdin --tty centos -- /bin/bash\n</code></pre></li> <li>And install <code>hey</code> with: <pre><code>[root@centos /]# curl -sf https://gobinaries.com/rakyll/hey | sh\n</code></pre></li> <li>Now you can execute the benchmark using the following escenario:</li> </ul> Item Value Target AWS ELB DNS Name App pods 2 Limitador pods 2 Limits 1.000 rps per hostname Hey duration 1 minute Hey Traffic -c 60 -q 20 (around 1.200 rps) <ul> <li>Theoretically:</li> <li>It should let pass 1.000 requests, and limit 200 requests per second</li> <li>It should let pass 60 * 1.000 = 60.0000 requests, and limit 60 * 200 = 12.000 requests per minute</li> <li>Each limitador pod should handle half of the traffic (500 rps OK, and 200 rps limited)</li> </ul> <pre><code>[root@centos /]# hey -z 60s -c 60 -q 20 \"http://a96d5449fbc3f4cd892e15e5b36cde48-457963259.us-east-1.elb.amazonaws.com\"\n\nSummary:\n  Total:    60.0131 secs\n  Slowest:  0.1028 secs\n  Fastest:  0.0023 secs\n  Average:  0.0075 secs\n  Requests/sec: 1199.3721\n\n  Total data:   106581650 bytes\n  Size/request: 1480 bytes\n\nResponse time histogram:\n  0.002 [1] |\n  0.012 [70626] |\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\u25a0\n  0.022 [1291]  |\u25a0\n  0.032 [0] |\n  0.043 [0] |\n  0.053 [0] |\n  0.063 [0] |\n  0.073 [0] |\n  0.083 [0] |\n  0.093 [23]    |\n  0.103 [37]    |\n\n\nLatency distribution:\n  10% in 0.0053 secs\n  25% in 0.0063 secs\n  50% in 0.0073 secs\n  75% in 0.0085 secs\n  90% in 0.0096 secs\n  95% in 0.0102 secs\n  99% in 0.0139 secs\n\nDetails (average, fastest, slowest):\n  DNS+dialup:   0.0001 secs, 0.0023 secs, 0.1028 secs\n  DNS-lookup:   0.0001 secs, 0.0000 secs, 0.0711 secs\n  req write:    0.0000 secs, 0.0000 secs, 0.0014 secs\n  resp wait:    0.0074 secs, 0.0023 secs, 0.0303 secs\n  resp read:    0.0000 secs, 0.0000 secs, 0.0049 secs\n\nStatus code distribution:\n  [200] 60046 responses\n  [429] 11932 responses\n</code></pre> <ul> <li> <p>We can see that:</p> <ul> <li>Client could send 1192.2171rps (about 1200rps)</li> <li>60046 requests (about 60000) were OK (HTTP 200)</li> <li>11932 requests (about 12000) were limited (HTTP 429)</li> <li>Average latency (since the request goes out from the client to AWS ELB, k8s node, envoyproxy container, limitador+redis, kuar app container) is 10ms</li> </ul> </li> <li> <p>In addition, if we do a longer test with 5 minutes traffic for example, you can check with the grafana dashboard how these requests are processed by envoyproxy sidecar container of kuard pods and limitador pods:</p> <ul> <li>Kuard Envoyproxy Sidecar Metrics:<ul> <li>Globally it handles around 1200rps: it permits around 1krps and limits around 200rps  </li> <li>Each envoyproxy sidecar of each kuard pod handles around half of the traffic: it permits around 500rps and limits around 100rps. The balance between pods is not 100% perfect, caused by random iptables forwarding when using a k8s service  </li> </ul> </li> <li>Limitador Metrics:<ul> <li>Globally it handles around 1200rps: it permits around 1krps and limits around 200rps  </li> <li>Each limitador pod handles around half of the traffic: it permits around 500rps and limits around 100rps. The balance between pods is perfect thanks to using a headless service with GRPC connections  </li> </ul> </li> </ul> </li> </ul>"},{"location":"limitador/limitador-server/sandbox/","title":"Sandbox","text":""},{"location":"limitador/limitador-server/sandbox/#testing-environment","title":"Testing Environment","text":""},{"location":"limitador/limitador-server/sandbox/#requirements","title":"Requirements","text":"<ul> <li>docker v24+</li> </ul>"},{"location":"limitador/limitador-server/sandbox/#setup","title":"Setup","text":"<p>Clone the project</p> <pre><code>git clone https://github.com/Kuadrant/limitador.git\ncd limitador/limitador-server/sandbox\n</code></pre> <p>Check out <code>make help</code> for all the targets.</p>"},{"location":"limitador/limitador-server/sandbox/#deployment-options","title":"Deployment options","text":"Limitador's configuration Command Info In-memory configuration <code>make deploy-in-memory</code> Counters are held in Limitador (ephemeral) Redis <code>make deploy-redis</code> Uses Redis to store counters Redis Secured <code>make deploy-redis-tls</code> Uses Redis with TLS and password protected to store counters Redis Cached <code>make deploy-redis-cached</code> Uses Redis to store counters, with an in-memory cache Redis Otel Instrumented <code>make deploy-redis-otel</code> Uses redis to store counters, instrumented with opentelemetry Disk <code>make deploy-disk</code> Uses disk to store counters Distributed <code>make deploy-distributed</code> Counters are held in Limitador (ephemeral) but replicated to other Limitador servers. <p>| Distributed 3 Node | <code>make deploy-distributed-3-node</code> | Counters are held in Limitador (ephemeral) but replicated to 3 other Limitador servers. |</p>"},{"location":"limitador/limitador-server/sandbox/#running-multi-node-distributed-deployments","title":"Running Multi Node Distributed Deployments","text":"<p>The <code>make deploy-distributed</code> target can be connected to other Limitador servers but requires you to set the <code>PEER_ID</code> and <code>PEER_URLS</code> environment variables when you run the target.</p> <p>If you have 3 servers you want to replicate between, you would run the following commands:</p> <pre><code># on server where: hostname=server1\nPEER_ID=`hostname` PEER_URLS=\"http://server2:15001 http://server3:15001\" make deploy-distributed\n</code></pre> <pre><code># on server where: hostname=server2\nPEER_ID=`hostname` PEER_URLS=\"http://server1:15001 http://server3:15001\" make deploy-distributed\n</code></pre> <pre><code># on server where: hostname=server3\nPEER_ID=`hostname` PEER_URLS=\"http://server1:15001 http://server2:15001\" make deploy-distributed\n</code></pre> <p>The <code>PEER_ID</code> just need to be unique between the servers, and the <code>PEER_URLS</code> should be a space-separated list of the other servers' URLs.</p>"},{"location":"limitador/limitador-server/sandbox/#limitadors-admin-http-endpoint","title":"Limitador's admin HTTP endpoint","text":"<p>Limits</p> <pre><code>curl -i http://127.0.0.1:18080/limits/test_namespace\n</code></pre> <p>Counters</p> <pre><code>curl -i http://127.0.0.1:18080/counters/test_namespace\n</code></pre> <p>Metrics</p> <pre><code>curl -i http://127.0.0.1:18080/metrics\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/#limitadors-grpc-ratelimitservice-endpoint","title":"Limitador's GRPC RateLimitService endpoint","text":"<p>Get <code>grpcurl</code>. You need Go SDK installed.</p> <p>Golang version &gt;= 1.18 (from fullstorydev/grpcurl)</p> <pre><code>make grpcurl\n</code></pre> <p>Inspect <code>RateLimitService</code> GRPC service</p> <pre><code>bin/grpcurl -plaintext 127.0.0.1:18081 describe envoy.service.ratelimit.v3.RateLimitService\n</code></pre> <p>Make a custom request</p> <pre><code>bin/grpcurl -plaintext -d @ 127.0.0.1:18081 envoy.service.ratelimit.v3.RateLimitService.ShouldRateLimit &lt;&lt;EOM\n{\n    \"domain\": \"test_namespace\",\n    \"hits_addend\": 1,\n    \"descriptors\": [\n        {\n            \"entries\": [\n                {\n                    \"key\": \"req.method\",\n                    \"value\": \"POST\"\n                },\n                {\n                    \"key\": \"req.path\",\n                    \"value\": \"/\"\n                }\n            ]\n        }\n    ]\n}\nEOM\n</code></pre> <p>Do repeated requests. As the limit is set to max 5 request for 60 seconds, you should see <code>OVER_LIMIT</code> response after 5 requests.</p> <pre><code>while :; do bin/grpcurl -plaintext -d @ 127.0.0.1:18081 envoy.service.ratelimit.v3.RateLimitService.ShouldRateLimit &lt;&lt;EOM; sleep 1; done\n{\n    \"domain\": \"test_namespace\",\n    \"hits_addend\": 1,\n    \"descriptors\": [\n        {\n            \"entries\": [\n                {\n                    \"key\": \"req.method\",\n                    \"value\": \"POST\"\n                },\n                {\n                    \"key\": \"req.path\",\n                    \"value\": \"/\"\n                }\n            ]\n        }\n    ]\n}\nEOM\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/#downstream-traffic","title":"Downstream traffic","text":"<p>Upstream service implemented by httpbin.org</p> <pre><code>curl -i -H \"Host: example.com\" http://127.0.0.1:18000/get\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/#load-testing-the-grpc-ratelimitservice-directly","title":"Load Testing the GRPC RateLimitService directly","text":"<p>This load test will use <code>grpcurl</code>. You need Go SDK installed.</p> <p>Run a load test a 5000 requests per second (RPS) for 10 seconds:</p> <pre><code>RPS=5000 make load-test\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/#load-testing-via-envoy-proxy","title":"Load Testing via Envoy Proxy","text":"<pre><code>cargo run --manifest-path loadtest/Cargo.toml  --package loadtest --release -- --report-file=report.htm\n</code></pre> <p>The report will be saved in <code>report.htm</code> file.</p>"},{"location":"limitador/limitador-server/sandbox/#limitador-image","title":"Limitador Image","text":"<p>By default, the sandbox will run Limitador's <code>limitador-testing:latest</code> image.</p> <p>Building <code>limitador-testing:latest</code> image</p> <p>You can easily build the limitador's image from the current workspace code base with:</p> <pre><code>make build\n</code></pre> <p>The image will be tagged with <code>limitador-testing:latest</code></p> <p>Using custom Limitador's image</p> <p>The <code>LIMITADOR_IMAGE</code> environment variable overrides the default image. For example:</p> <pre><code>make deploy-in-memory LIMITADOR_IMAGE=quay.io/kuadrant/limitador:latest\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/#clean-env","title":"Clean env","text":"<pre><code>make clean\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/redis-otel/","title":"Limitador instrumentation sandbox","text":"<p>Limitador is configured to push traces to an opentelemetry collector.</p>"},{"location":"limitador/limitador-server/sandbox/redis-otel/#run-sandbox","title":"Run sandbox","text":"<pre><code>make build\nmake deploy-redis-otel\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/redis-otel/#run-some-traffic","title":"Run some traffic","text":"<pre><code>make grpcurl\n</code></pre> <pre><code>bin/grpcurl -plaintext -d @ 127.0.0.1:18081 envoy.service.ratelimit.v3.RateLimitService.ShouldRateLimit &lt;&lt;EOM\n{\n    \"domain\": \"test_namespace\",\n    \"hits_addend\": 1,\n    \"descriptors\": [\n        {\n            \"entries\": [\n                {\n                    \"key\": \"req.method\",\n                    \"value\": \"POST\"\n                }\n            ]\n        }\n    ]\n}\nEOM\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/redis-otel/#see-the-trace-in-ui","title":"See the trace in UI","text":"<pre><code>firefox -private-window \"localhost:16686\"\n</code></pre> <p>Recommended to start looking at <code>check_and_update</code> operation.</p>"},{"location":"limitador/limitador-server/sandbox/redis-otel/#tear-down-sandbox","title":"Tear down sandbox","text":"<pre><code>make clean\n</code></pre>"},{"location":"limitador/limitador-server/sandbox/redis-tls/","title":"Index","text":""},{"location":"limitador/limitador-server/sandbox/redis-tls/#testing-redis-security","title":"Testing  redis security","text":"<p>Execute bash shell in redis pod</p> <pre><code>docker compose -p sandbox exec redis /bin/bash\n</code></pre> <p>Connect to this Redis server with redis-cli:</p> <pre><code>root@e024a29b74ba:/data# redis-cli --tls --cacert /usr/local/etc/redis/certs/ca.crt -a foobared\n</code></pre>"},{"location":"limitador-operator/","title":"Limitador Operator","text":""},{"location":"limitador-operator/#overview","title":"Overview","text":"<p>The Operator to manage Limitador deployments.</p>"},{"location":"limitador-operator/#customresourcedefinitions","title":"CustomResourceDefinitions","text":"<ul> <li>Limitador, which defines a desired Limitador deployment.</li> </ul>"},{"location":"limitador-operator/#limitador-crd","title":"Limitador CRD","text":"<p>Limitador v1alpha1 API reference</p> <p>Example:</p> <pre><code>---\napiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  listener:\n    http:\n      port: 8080\n    grpc:\n      port: 8081\n  limits:\n\n    - conditions: [\"get_toy == 'yes'\"]\n      max_value: 2\n      namespace: toystore-app\n      seconds: 30\n      variables: []\n</code></pre>"},{"location":"limitador-operator/#features","title":"Features","text":"<ul> <li>Storage Options</li> <li>Rate Limit Headers</li> <li>Logging</li> <li>Tracing</li> </ul>"},{"location":"limitador-operator/#contributing","title":"Contributing","text":"<p>The Development guide describes how to build the operator and how to test your changes before submitting a patch or opening a PR.</p> <p>Join us on the #kuadrant channel in the Kubernetes Slack workspace,  for live discussions about the roadmap and more.</p>"},{"location":"limitador-operator/#licensing","title":"Licensing","text":"<p>This software is licensed under the Apache 2.0 license.</p> <p>See the LICENSE and NOTICE files that should have been provided along with this software for details.</p> <p></p>"},{"location":"limitador-operator/doc/development/","title":"Development Guide","text":""},{"location":"limitador-operator/doc/development/#technology-stack-required-for-development","title":"Technology stack required for development","text":"<ul> <li>operator-sdk version 1.32.0</li> <li>kind version v0.22.0</li> <li>git</li> <li>go version 1.21+</li> <li>kubernetes version v1.25+</li> <li>kubectl version v1.25+</li> </ul>"},{"location":"limitador-operator/doc/development/#build","title":"Build","text":"<pre><code>make\n</code></pre>"},{"location":"limitador-operator/doc/development/#run-locally","title":"Run locally","text":"<p>You need an active session open to a kubernetes cluster.</p> <p>Optionally, run kind with <code>local-env-setup</code>.</p> <pre><code>make local-env-setup\n</code></pre> <p>Then, run the operator locally</p> <pre><code>make run\n</code></pre>"},{"location":"limitador-operator/doc/development/#deploy-the-operator-in-a-deployment-object","title":"Deploy the operator in a deployment object","text":"<pre><code>make local-setup\n</code></pre>"},{"location":"limitador-operator/doc/development/#deploy-the-operator-using-olm","title":"Deploy the operator using OLM","text":"<p>You can deploy the operator using OLM just running a few commands. No need to build any image. Kuadrant engineering team provides <code>latest</code> and released version tagged images. They are available in the Quay.io/Kuadrant image repository.</p> <p>Create kind cluster</p> <pre><code>make kind-create-cluster\n</code></pre> <p>Deploy OLM system</p> <pre><code>make install-olm\n</code></pre> <p>Deploy the operator using OLM. The <code>make deploy-catalog</code> target accepts the following variables:</p> Makefile Variable Description Default value <code>CATALOG_IMG</code> Catalog image URL <code>quay.io/kuadrant/limitador-operator-catalog:latest</code> <pre><code>make deploy-catalog [CATALOG_IMG=quay.io/kuadrant/limitador-operator-catalog:latest]\n</code></pre>"},{"location":"limitador-operator/doc/development/#build-custom-olm-catalog","title":"Build custom OLM catalog","text":"<p>If you want to deploy (using OLM) a custom limitador operator, you need to build your own catalog.</p>"},{"location":"limitador-operator/doc/development/#build-operator-bundle-image","title":"Build operator bundle image","text":"<p>The <code>make bundle</code> target accepts the following variables:</p> Makefile Variable Description Default value Notes <code>IMG</code> Operator image URL <code>quay.io/kuadrant/limitador-operator:latest</code> <code>VERSION</code> Bundle version <code>0.0.0</code> <code>RELATED_IMAGE_LIMITADOR</code> Limitador bundle URL <code>quay.io/kuadrant/limitador:latest</code> <code>LIMITADOR_VERSION</code> var could be use to build this URL providing the tag <ul> <li>Build the bundle manifests</li> </ul> <pre><code>make bundle [IMG=quay.io/kuadrant/limitador-operator:latest] \\\n            [VERSION=0.0.0] \\\n            [RELATED_IMAGE_LIMITADOR=quay.io/kuadrant/limitador:latest]\n</code></pre> <ul> <li>Build the bundle image from the manifests</li> </ul> Makefile Variable Description Default value <code>BUNDLE_IMG</code> Operator bundle image URL <code>quay.io/kuadrant/limitador-operator-bundle:latest</code> <pre><code>make bundle-build [BUNDLE_IMG=quay.io/kuadrant/limitador-operator-bundle:latest]\n</code></pre> <ul> <li>Push the bundle image to a registry</li> </ul> Makefile Variable Description Default value <code>BUNDLE_IMG</code> Operator bundle image URL <code>quay.io/kuadrant/limitador-operator-bundle:latest</code> <pre><code>make bundle-push [BUNDLE_IMG=quay.io/kuadrant/limitador-operator-bundle:latest]\n</code></pre>"},{"location":"limitador-operator/doc/development/#build-custom-catalog","title":"Build custom catalog","text":"<p>The catalog format will be File-based Catalog.</p> <p>Make sure all the required bundles are pushed to the registry. It is required by the <code>opm</code> tool.</p> <p>The <code>make catalog</code> target accepts the following variables:</p> Makefile Variable Description Default value <code>BUNDLE_IMG</code> Operator bundle image URL <code>quay.io/kuadrant/limitador-operator-bundle:latest</code> <code>REPLACES_VERSION</code> Previous operator version <code>0.0.0-alpha</code> <code>CHANNELS</code> Catalog channels <code>preview</code> <pre><code>make catalog [BUNDLE_IMG=quay.io/kuadrant/limitador-operator-bundle:latest] \\\n             [REPLACES_VERSION=0.0.0-alpha] \\\n             [CHANNELS=preview]\n</code></pre> <ul> <li>Build the catalog image from the manifests</li> </ul> Makefile Variable Description Default value <code>CATALOG_IMG</code> Operator catalog image URL <code>quay.io/kuadrant/limitador-operator-catalog:latest</code> <pre><code>make catalog-build [CATALOG_IMG=quay.io/kuadrant/limitador-operator-catalog:latest]\n</code></pre> <ul> <li>Push the catalog image to a registry</li> </ul> <pre><code>make catalog-push [CATALOG_IMG=quay.io/kuadrant/limitador-operator-bundle:latest]\n</code></pre> <p>You can try out your custom catalog image following the steps of the Deploy the operator using OLM section.</p>"},{"location":"limitador-operator/doc/development/#cleaning-up","title":"Cleaning up","text":"<pre><code>make local-cleanup\n</code></pre>"},{"location":"limitador-operator/doc/development/#run-tests","title":"Run tests","text":""},{"location":"limitador-operator/doc/development/#unittests","title":"Unittests","text":"<pre><code>make test-unit\n</code></pre> <p>Optionally, add <code>TEST_NAME</code> makefile variable to run specific test</p> <pre><code>make test-unit TEST_NAME=TestConstants\n</code></pre> <p>or even subtest</p> <pre><code>make test-unit TEST_NAME=TestLimitIndexEquals/empty_indexes_are_equal\n</code></pre>"},{"location":"limitador-operator/doc/development/#integration-tests","title":"Integration tests","text":"<p>You need an active session open to a kubernetes cluster.</p> <p>Optionally, run local cluster with kind</p> <pre><code>make local-env-setup\n</code></pre> <p>Run integration tests</p> <pre><code>make test-integration\n</code></pre>"},{"location":"limitador-operator/doc/development/#all-tests","title":"All tests","text":"<p>You need an active session open to a kubernetes cluster.</p> <p>Optionally, run local cluster with kind</p> <pre><code>make local-env-setup\n</code></pre> <p>Run all tests</p> <pre><code>make test\n</code></pre>"},{"location":"limitador-operator/doc/development/#lint-tests","title":"Lint tests","text":"<pre><code>make run-lint\n</code></pre>"},{"location":"limitador-operator/doc/development/#uninstall-limitador-crd","title":"(Un)Install Limitador CRD","text":"<p>You need an active session open to a kubernetes cluster.</p> <p>Remove CRDs</p> <pre><code>make uninstall\n</code></pre>"},{"location":"limitador-operator/doc/logging/","title":"Logging","text":"<p>The limitador operator outputs 3 levels of log messages: (from lowest to highest level)</p> <ol> <li><code>debug</code></li> <li><code>info</code> (default)</li> <li><code>error</code></li> </ol> <p><code>info</code> logging is restricted to high-level information. Actions like creating, deleting or updating kubernetes resources will be logged with reduced details about the corresponding objects, and without any further detailed logs of the steps in between, except for errors.</p> <p>Only <code>debug</code> logging will include processing details.</p> <p>To configure the desired log level, set the environment variable <code>LOG_LEVEL</code> to one of the supported values listed above. Default log level is <code>info</code>.</p> <p>Apart from log level, the controller can output messages to the logs in 2 different formats:</p> <ul> <li><code>production</code> (default): each line is a parseable JSON object with properties <code>{\"level\":string, \"ts\":int, \"msg\":string, \"logger\":string, extra values...}</code></li> <li><code>development</code>: more human-readable outputs, extra stack traces and logging info, plus extra values output as JSON, in the format: <code>&lt;timestamp-iso-8601&gt;\\t&lt;log-level&gt;\\t&lt;logger&gt;\\t&lt;message&gt;\\t{extra-values-as-json}</code></li> </ul> <p>To configure the desired log mode, set the environment variable <code>LOG_MODE</code> to one of the supported values listed above. Default log mode is <code>production</code>.</p>"},{"location":"limitador-operator/doc/rate-limit-headers/","title":"Rate Limit Headers","text":"<p>It enables RateLimit Header Fields for HTTP as specified in Rate Limit Headers Draft</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  rateLimitHeaders: DRAFT_VERSION_03\n</code></pre> <p>Current valid values are:</p> <ul> <li>DRAFT_VERSION_03 (ref:  Rate Limit Headers Draft)</li> <li>NONE</li> </ul> <p>By default, when <code>spec.rateLimitHeaders</code> is null, <code>--rate-limit-headers</code> command line arg is not included in the limitador's deployment.</p>"},{"location":"limitador-operator/doc/resource-requirements/","title":"Resource Requirements","text":"<p>The default resource requirement for Limitador deployments is specified in Limitador v1alpha1 API reference and will be applied if the resource requirement is not set in the spec.</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  listener:\n    http:\n      port: 8080\n    grpc:\n      port: 8081\n  limits:\n\n    - conditions: [\"get_toy == 'yes'\"]\n      max_value: 2\n      namespace: toystore-app\n      seconds: 30\n      variables: []  \n</code></pre> Field json/yaml field Type Required Default value Description ResourceRequirements <code>resourceRequirements</code> *corev1.ResourceRequirements No <code>{\"limits\": {\"cpu\": \"500m\",\"memory\": \"64Mi\"},\"requests\": {\"cpu\": \"250m\",\"memory\": \"32Mi\"}}</code> Limitador deployment resource requirements"},{"location":"limitador-operator/doc/resource-requirements/#example-with-resource-limits","title":"Example with resource limits","text":"<p>The resource requests and limits for the deployment can be set like the following:</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  listener:\n    http:\n      port: 8080\n    grpc:\n      port: 8081\n  limits:\n\n    - conditions: [\"get_toy == 'yes'\"]\n      max_value: 2\n      namespace: toystore-app\n      seconds: 30\n      variables: []\n  resourceRequirements:\n    limits:\n      cpu: 200m\n      memory: 400Mi\n    requests:\n      cpu: 101m  \n      memory: 201Mi    \n</code></pre> <p>To specify the deployment without resource requests or limits, set an empty struct <code>{}</code> to the field: <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  listener:\n    http:\n      port: 8080\n    grpc:\n      port: 8081\n  limits:\n\n    - conditions: [ \"get_toy == 'yes'\" ]\n      max_value: 2\n      namespace: toystore-app\n      seconds: 30\n      variables: []\n  resourceRequirements: {}\n</code></pre></p>"},{"location":"limitador-operator/doc/storage/","title":"Storage","text":"<p>Limitador limits counters are stored in a backend storage. This is In contrast to the storage of the limits themselves, which are always stored in ephemeral memory. Limitador's operator supports several storage configurations:</p> <ul> <li>In-Memory: ephemeral and cannot be shared</li> <li>Redis: Persistent (depending on the redis storage configuration) and can be shared</li> <li>Redis Cached: Persistent (depending on the redis storage configuration) and can be shared</li> <li>Disk: Persistent (depending on the underlying disk persistence capabilities) and cannot be shared</li> </ul>"},{"location":"limitador-operator/doc/storage/#in-memory","title":"In-Memory","text":"<p>Counters are held in Limitador (ephemeral)</p> <p>In-Memory is the default option defined by the Limitador's Operator.</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  storage: null\n</code></pre> <p>For any of those, one should store the URL of the Redis service, inside a K8s opaque Secret.</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: redisconfig\nstringData:\n  URL: redis://127.0.0.1/a # Redis URL of its running instance\ntype: Opaque\n</code></pre>"},{"location":"limitador-operator/doc/storage/#redis","title":"Redis","text":"<p>Uses Redis to store counters.</p> <p>Selected when <code>spec.storage.redis</code> is not <code>null</code>.</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  storage:\n    redis:\n      configSecretRef: # The secret reference storing the URL for Redis\n        name: redisconfig\n</code></pre> <p>The URL of the Redis service is provided inside a K8s opaque Secret. The secret is required to be in the same namespace as the <code>Limitador</code> CR.</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: redisconfig\nstringData:\n  URL: redis://127.0.0.1/a # Redis URL of its running instance\ntype: Opaque\n</code></pre> <p>Note: Limitador's Operator will only read the <code>URL</code> field of the secret.</p>"},{"location":"limitador-operator/doc/storage/#redis-cached","title":"Redis Cached","text":"<p>Uses Redis to store counters, with an in-memory cache.</p> <p>Selected when <code>spec.storage.redis-cached</code> is not <code>null</code>.</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  storage:\n    redis-cached:\n      configSecretRef: # The secret reference storing the URL for Redis\n        name: redisconfig\n</code></pre> <p>The URL of the Redis service is provided inside a K8s opaque Secret. The secret is required to be in the same namespace as the <code>Limitador</code> CR. <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: redisconfig\nstringData:\n  URL: redis://127.0.0.1/a # Redis URL of its running instance\ntype: Opaque\n</code></pre></p> <p>Note: Limitador's Operator will only read the <code>URL</code> field of the secret.</p> <p>Additionally, caching options can be specified in the <code>spec.storage.redis-cached.options</code> field.</p>"},{"location":"limitador-operator/doc/storage/#options","title":"Options","text":"Option Description <code>batch-size</code> Size of entries to flush in as single flush [default: 100] <code>flush-period</code> Flushing period for counters in milliseconds [default: 1000] <code>max-cached</code> Maximum amount of counters cached [default: 10000] <code>response-timeout</code> Timeout for Redis commands in milliseconds [default: 350] <p>For example:</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  storage:\n    redis-cached:\n      configSecretRef: # The secret reference storing the URL for Redis\n        name: redisconfig\n      options: # Every option is optional\n        batch-size: 50\n        max-cached: 5000\n</code></pre>"},{"location":"limitador-operator/doc/storage/#disk","title":"Disk","text":"<p>Counters are held on disk (persistent). Kubernetes Persistent Volumes will be used to store counters.</p> <p>Selected when <code>spec.storage.disk</code> is not <code>null</code>.</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  storage:\n    disk: {}\n</code></pre> <p>Additionally, disk options can be specified in the <code>spec.storage.disk.persistentVolumeClaim</code> and <code>spec.storage.disk.optimize</code> fields.</p>"},{"location":"limitador-operator/doc/storage/#persistent-volume-claim-options","title":"Persistent Volume Claim Options","text":"<p><code>spec.storage.disk.persistentVolumeClaim</code> field is an object with the following fields.</p> Field Description <code>storageClassName</code> StorageClass of the storage offered by cluster administrators [default: default storage class of the cluster] <code>resources</code> The minimum resources the volume should have. Resources will not take any effect when VolumeName is provided. This parameter is not updateable when the underlying PV is not resizable. [default: 1Gi] <code>volumeName</code> The binding reference to the existing PersistentVolume backing this claim [default: null] <p>Example:</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  storage:\n    disk:\n      persistentVolumeClaim:\n        storageClassName: \"customClass\"\n        resources:\n          requests: 2Gi\n</code></pre>"},{"location":"limitador-operator/doc/storage/#optimize","title":"Optimize","text":"<p>Defines the valid optimization option of the disk persistence type.</p> <p><code>spec.storage.disk.optimize</code> field is a <code>string</code> type with the following valid values:</p> Option Description <code>throughput</code> Optimizes for higher throughput. Default <code>disk</code> Optimizes for disk usage <p>Example:</p> <pre><code>apiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  storage:\n    disk:\n      optimize: disk\n</code></pre>"},{"location":"limitador-operator/doc/tracing/","title":"Tracing","text":"<p>Limitador offers distributed tracing enablement using the <code>.spec.tracing</code> CR configuration:</p> <pre><code>---\napiVersion: limitador.kuadrant.io/v1alpha1\nkind: Limitador\nmetadata:\n  name: limitador-sample\nspec:\n  listener:\n    http:\n      port: 8080\n    grpc:\n      port: 8081\n  limits:\n\n    - conditions: [\"get_toy == 'yes'\"]\n      max_value: 2\n      namespace: toystore-app\n      seconds: 30\n      variables: []\n  verbosity: 3\n  tracing:\n    endpoint: rpc://my-otlp-collector:4317\n</code></pre> <p>Currently limitador only supports collectors using the OpenTelemetry Protocol with TLS disabled. The <code>endpoint</code> configuration option should contain the scheme, host and port of the service. The quantity and level of the information provided by the spans is configured via the <code>verbosity</code> argument.</p> <p></p>"},{"location":"architecture/docs/design/architectural-overview-v1/","title":"Kuadrant Architectural Overview","text":""},{"location":"architecture/docs/design/architectural-overview-v1/#overview","title":"Overview","text":"<p>Kuadrant provides connectivity, security and service protection capabilities in both a single and multi-cluster environment. It exposes these capabilities in the form of Kubernetes CRDs that implement the Gateway API concept of policy attachment. These policy APIs can target specific Gateway API resources such as <code>Gateways</code> and <code>HTTPRoutes</code> to extend their capabilities and configuration. They enable platform engineers to secure, protect and connect their infrastructure and allow application developers to self service and refine policies to their specific needs in order to protect exposed endpoints.  </p>"},{"location":"architecture/docs/design/architectural-overview-v1/#key-architectural-areas","title":"Key Architectural Areas","text":"<ul> <li>Kuadrant architecture is defined and implemented with both control plane and data plane components.</li> <li>The control plane is where policies are exposed and expressed as Kubernetes APIs and reconciled by a policy controller. </li> <li>The data plane is where Kuadrant's \"policy enforcement\" components exist. These components are configured by the  control plane and integrate either directly with the Gateway provider or via external integrations.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#10000m-architecture","title":"10000m Architecture","text":""},{"location":"architecture/docs/design/architectural-overview-v1/#control-plane-components-and-responsibilities","title":"Control Plane Components and Responsibilities","text":"<p>The control plane is a set of controllers and operators that are responsible for for installation and configuration of other components such as the data plane enforcement components and configuration of the Gateway to enable the data plane components to interact with incoming requests. The control plane also owns and reconciles the policy CRD APIs into more complex and specific configuration objects that the policy enforcement components consume in order to know the rules to apply to incoming requests or the configuration to apply to external integrations such as DNS and ACME providers. </p> <p></p>"},{"location":"architecture/docs/design/architectural-overview-v1/#kuadrant-operator","title":"Kuadrant Operator","text":"<ul> <li>Installation and configuration of other control plane components</li> <li>Installation of data plane policy enforcement components via their respective control plane operators</li> <li>Configures the Gateway via WASM plugin and other APIs to leverage the data plane components for auth and rate limiting on incoming requests.</li> <li>Exposes <code>RateLimitPolicy</code> , <code>AuthPolicy</code>, <code>DNSPolicy</code> and <code>TLSPolicy</code> and reconciles these into enforceable configuration for the data plane.</li> <li>Exposes <code>Kuadrant</code> and reconciles this to configure and trigger installation of the required data plane components and other control plane components.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#limitador-operator","title":"Limitador Operator:","text":"<ul> <li>Installs and configures the Limitador data plane component based on the Limitador CR. Limits specified in the limitador CR are mountd via configmap into the limitador component.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#authorino-operator","title":"Authorino Operator:","text":"<ul> <li>Installs and configures the Authorino data plane component based on the Authorino CR.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#cert-manager","title":"Cert-Manager:","text":"<ul> <li>Manages TLS certificates for our components and for the Gateways. Consumes Certificate resources created by Kuadrant operator in response to the TLSPolicy.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#dns-operator","title":"DNS Operator","text":"<ul> <li>DNS operator consumes DNSRecord resources that are configured via the DNSPolicy api and applies them into the targeted cloud DNS provider AWS, Azure and Google DNS are our main targets</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#data-plane-components-and-responsibilities","title":"Data Plane Components and Responsibilities","text":"<p>The data plane components sit in the request flow and are responsible for enforcing configuration defined by policy and providing service protection capabilities based on configuration managed and created by the control plane.</p>"},{"location":"architecture/docs/design/architectural-overview-v1/#limitador","title":"Limitador","text":"<ul> <li>Complies with the with Envoy rate limiting API to provide rate limiting to the gateway. Consumes limits from a configmap created based on the RateLimitPolicy API.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#authorino","title":"Authorino","text":"<ul> <li>Complies with the Envoy external auth API to provide auth integration to the gateway. It provides both Authn and Authz. Consumes AuthConfigs created by the kuadrant operator based on the defined <code>AuthPolicy</code> API.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#wasm-shim","title":"WASM Shim","text":"<ul> <li>Uses the Proxy WASM ABI Spec to integrate with Envoy and provide filtering and connectivity to Limitador for request time enforcement of and rate limiting.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#single-cluster-layout","title":"Single Cluster Layout","text":"<p>In a single cluster, you have the Kuadrant control plane and data plane sitting together. It is configured to integrate with Gateways on the same cluster and configure a DNS zone via a DNS provider secret (configured alongside a DNSPolicy). Storage of rate limit counters is possible but not required as they are not being shared.</p> <p></p>"},{"location":"architecture/docs/design/architectural-overview-v1/#multi-cluster","title":"Multi-Cluster","text":"<p>In the default multi-cluster setup. Each individual cluster has Kuadrant installed. Each of these clusters are unaware of the other. They are effectively operating as single clusters. The multi-cluster aspect is created by sharing access with the DNS zone, using a shared host across the clusters and leveraging shared counter storage.  The zone is operated on independently by each of DNS operator on both clusters to form a single cohesive record set. More details on this can be found in the following RFC document: TODO add link. The rate limit counters can also be shared and used by different clusters in order to provide global rate limiting. This is achieved by connecting each instance of Limitador to a shared data store that uses the Redis protocol. There is another option available for achieving multi-cluster connectivity (see intgrations below) that requires the use of a \"hub\" cluster and integration with OCM (open cluster management).</p> <p></p> <p>Shown above is a multi-cluster multi ingress gateway topology. This might be used to support a geographically distributed system for example. However, it is also possible to leverage overlay networking tools such as Skupper that integrate at the Kubernetes service level to have a single gateway cluster that then integrates with multiple backends (on different clusters or in custom infrastructure).</p>"},{"location":"architecture/docs/design/architectural-overview-v1/#observability","title":"Observability","text":"<p>The Kuadrant architecture is intended to work with some popular monitoring tools for tracing, metrics and log aggregation. Those tools are:</p> <ul> <li>Prometheus for scraping metrics - and optionally Thanos for high availability &amp; federation</li> <li>Loki for log aggregation - via log collectors like vector</li> <li>Tempo for trace collecting</li> <li>Grafana for visualing the above</li> </ul> <p>Depending on the number of clusters in your configuration, you may decide to have a monitoring system on the same cluster as workloads, or in a separate cluster completely. Below are 2 example architectures based on the single cluster and multi cluster layouts. In the single cluster architecture, the collector components (Prometheus, Vector and Tempo) are in the same cluster as the log aggregation (Loki) and visualisation component (Grafana).</p> <p></p> <p>In the multi cluster architecture, the collectors that scrape metrics or logs (Prometheus &amp; Vector) are deployed alongside the workloads in each cluster. However, as traces are sent to a collector (Tempo) from each component, it can be centralised in a separate cluster. Thanos is used in this architecutre so that each prometheus can federate metrics back to a central location. The log collector (vector) can forward logs to a central loki instance. Finally, the visualisation component (Grafana) is centralised as well, with data sources configured for each of the 3 components on the same cluster.</p> <p></p>"},{"location":"architecture/docs/design/architectural-overview-v1/#dependencies","title":"Dependencies","text":""},{"location":"architecture/docs/design/architectural-overview-v1/#istio-required","title":"Istio: Required","text":"<ul> <li>Gateway API provider that Kuadrant integrates with via WASM and Istio APIS to provide service protection capabilities. Kuadrant configures Envoy via the Istio control plane in order to enforce the applied policies and register components such as Authorino and Limitador. </li> <li>Used by <code>RateLimitPolicy</code> and <code>AuthPolicy</code></li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#gateway-api-required","title":"Gateway API: Required","text":"<ul> <li>New standard for Ingress from the Kubernetes community</li> <li>Gateway API is the core API that Kuadrant integrates with.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview-v1/#integrations","title":"Integrations","text":""},{"location":"architecture/docs/design/architectural-overview-v1/#open-cluster-manager-optional","title":"Open Cluster Manager: Optional","text":"<ul> <li>Provides a multi-cluster control plane to enable the defining and distributing of Gateways across multiple clusters.</li> </ul> <p>While the default setup is to leverage a distributed configuration for DNS and rate limiting. There is also a component that offers experimental integration with Open Cluster Management. </p> <p>In this setup, the OCM integration controller is installed into the HUB alongside the DNS Operator and the cert-manager. This integration allows you to define gateways in the Hub and distribute them to \"spoke\" clusters. The addresses of these gateways are gathered from the spokes and aggregated back to the hub. The Kuadrant operator and DNS operator then act on this information as though it were a single cluster gateway with multiple addresses. The DNS zone in the configured DNS provider is managed centrally by one DNS operator instance.</p> <p></p>"},{"location":"architecture/docs/design/architectural-overview/","title":"Kuadrant Architectural Overview [Draft]","text":""},{"location":"architecture/docs/design/architectural-overview/#overview","title":"Overview","text":"<p>It is important to note that Kuadrant is not in itself a gateway provider. Kuadrant provides a set of valuable policy APIs that enhance Gateway API via its defined policy attachment extension point. The policy APIs are reconciled by a set of policy controllers and enforced via integration at different points to configure, enhance and secure the application connectivity provided via Gateway API and the underlying gateway provider.  These policy extensions are focused around areas such as DNS management supporting global load balancing and health checks, alongside service protection specific APIs such as rate limiting and auth. Kuadrant also integrates with Open Cluster Management as a multi-cluster control plane to enable defining and distributing Gateways across multiple clusters, providing load balancing and tls management for these distributed gateways. These integrations and features can be managed centrally in a declarative way from the Open Cluster Management Hub using Kubernetes resources.</p>"},{"location":"architecture/docs/design/architectural-overview/#key-architectural-areas","title":"Key Architectural Areas","text":"<ul> <li>The Kuadrant architecture is spread across a control plane and also a data plane. Kuadrant can work in both a single and multi-cluster context.  Currently in order for all APIs to work in a single or multi-cluster context you need to have Open Cluster Management installed.  While this may change in the future, this approach allows us to start with a single cluster and seamlessly scale as more clusters are added.</li> <li>The control plane is where policies are exposed and expressed as kubernetes APIs and reconciled by the Kuadrant policy controllers. </li> <li>The data plane is where Kuadrant's service protection components, configured by the  control plane policies, are enforced within the gateway instance as part of the request flow. </li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#1000m-architecture","title":"1000m Architecture","text":""},{"location":"architecture/docs/design/architectural-overview/#control-plane-components-and-responsibilities","title":"Control Plane Components and Responsibilities","text":"<p>A control plane component is something responsible for accepting instruction via a CRD based API and ensuring that configuration is manifested into state that can be acted on.</p>"},{"location":"architecture/docs/design/architectural-overview/#kuadrant-operator","title":"Kuadrant Operator","text":"<ul> <li>Installation of data plane service protection components via their respective operators</li> <li>Exposes <code>RateLimitPolicy</code> and <code>AuthPolicy</code> and is currently the policy controller for these APIs</li> <li>Configures the Gateway to be able to leverage the data plane service protection components</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#multi-cluster-gateway-controller","title":"Multi-Cluster Gateway Controller","text":"<ul> <li>Exposes <code>DNSPolicy</code> and <code>TLSPolicy</code></li> <li>Configures DNS providers (e.g AWS Route 53) and TLS providers</li> <li>Focused around use cases involving distributed gateways (for example across clouds or geographic regions)</li> <li>Integrates with Open Cluster Management as the multi-cluster management hub to distribute and observe gateway status based on the clusters they are deployed to. Works directly with Open Cluster Management APIs such <code>PlacementDecision</code> and <code>ManifestWork</code>.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#kuadrant-add-on-manager","title":"Kuadrant-add-on-manager","text":"<ul> <li>Sub component in the gateway controller repository</li> <li>Follows the add-on pattern from Open Cluster Management</li> <li>Responsible for configuring and installing Kuadrant into a target spoke cluster</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#limitador-operator","title":"Limitador Operator:","text":"<ul> <li>Installs and configures Limitador</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#authorino-operator","title":"Authorino Operator:","text":"<ul> <li>Installs and configures Authorino</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#data-plane-components-and-responsibilities","title":"Data Plane Components and Responsibilities","text":"<p>A data plane component sits in the request flow and is responsible for enforcing policy and providing service protection capabilities based on configuration managed and created by the control plane.</p>"},{"location":"architecture/docs/design/architectural-overview/#limitador","title":"Limitador","text":"<ul> <li>Complies with the with Envoy rate limiting API to provide rate limiting to the gateway</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#authorino","title":"Authorino","text":"<ul> <li>Complies with the Envoy external auth API to provide auth integration to the gateway</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#wasm-shim","title":"WASM Shim","text":"<ul> <li>Uses the Proxy WASM ABI Spec to integrate with Envoy and provide filtering and connectivity to Limitador for request time enforcement of and rate limiting</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#dependencies-and-integrations","title":"Dependencies and integrations","text":"<p>In order to provide its full suite of functionality, Kuadrant has several dependencies. Some of these are optional depending on the functionality needed.</p>"},{"location":"architecture/docs/design/architectural-overview/#cert-manager-required","title":"Cert-Manager: Required","text":"<ul> <li>Provides TLS integration</li> <li>Used by <code>TLSPolicy</code> and Authorino.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#open-cluster-manager-required","title":"Open Cluster Manager: Required","text":"<ul> <li>Provides a multi-cluster control plane to enable the defining and distributing of Gateways across multiple clusters.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#istio-required","title":"Istio: Required","text":"<ul> <li>Gateway API provider that Kuadrant integrates with via WASM and Istio APIS to provide service protection capabilities.</li> <li>Used by <code>RateLimitPolicy</code> and <code>AuthPolicy</code></li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#gateway-api-required","title":"Gateway API: Required","text":"<ul> <li>New standard for Ingress from the Kubernetes community</li> <li>Gateway API is the core API that Kuadrant integrates with.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#thanosprometheusgrafana-optional","title":"Thanos/Prometheus/Grafana: Optional","text":"<ul> <li>Provides observability integration</li> <li>Rather than providing any Kuadrant specific observability tooling, we instead look to leverage existing tools and technologies to provide observability capabilities for ingress. </li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#high-level-multi-cluster-architecture","title":"High Level Multi-Cluster Architecture","text":"<p>Kuadrant has a multi-cluster gateway controller that is intended to run in a Open Cluster Management provided \"Hub\" cluster. This cluster is effectively a central management cluster where policy and gateways along with all that Open Cluster Management offers can be defined and distributed to the managed \"spoke\" clusters. </p>"},{"location":"architecture/docs/design/architectural-overview/#single-cluster","title":"Single cluster","text":"<p>In a single cluster context, the overall architecture remains the same as above, the key difference is that the Hub and Spoke cluster are now a single cluster rather than multiple clusters. This is how we are initially supporting single cluster.</p>"},{"location":"architecture/docs/design/architectural-overview/#how-does-kuadrant-leverage-open-cluster-management","title":"How does Kuadrant leverage Open Cluster Management?","text":"<p>Kuadrant deploys a multi-cluster gateway controller into the Open Cluster Management hub (a control plane that manages a set of \"spoke\" clusters where workloads are executed). This controller offers its own APIs but also integrates with hub CRD based APIs (such as the placement API) along with the Gateway API CRD based APIs in order to provide multi-cluster Gateway capabilities to the hub and distribute actual gateway instances to the spokes. See the Open Cluster Management docs for further details on the hub spoke architecture.</p> <p>As part of installing Kuadrant, the Gateway API CRDs are also installed into the hub cluster and Kuadrant defines a standard Gateway API <code>GatewayClass</code> resource that the multi-cluster gateway controller is the chosen controller for. </p> <p>Once installed, an Open Cluster Management user can then (with the correct RBAC in place) define in the standard way a Gateway resource that inherits from the Kuadrant configured <code>GatewayClass</code> in the hub. There is nothing unique about this Gateway definition, the difference is what it represents and how it is used. This Gateway is used to represent a \"multi-cluster\" distributed gateway. As such there are no pods running behind this Gateway instance in the hub cluster, instead it serves as a template that the Kuadrant multi-cluster gateway controller reconciles and distributes to targeted spoke clusters.  It leverages the Open Cluster Management APIs to distribute these gateways (more info below) and aggregates the status information from each spoke cluster instance of this gateway back to this central definition, in doing this it can represent the status of the gateway across multiple clusters but also use that information to integrate with DNS providers etc.</p> <p></p>"},{"location":"architecture/docs/design/architectural-overview/#gateway-deployment-and-distribution","title":"Gateway Deployment and Distribution","text":"<p>In order for a multi-cluster gateway to be truly useful, it needs to be distributed or \"placed\" on a specific set of hub managed spoke clusters.  Open Cluster Management is responsible for a set of placement and replication APIs. Kuadrant is aware of these APIs, and so when a given gateway is chosen to be placed on a set of managed clusters, Kuadrant multi-cluster gateway controller will ensure the right resources (<code>ManifestWork</code>) are created in the correct namespaces in the hub. Open Cluster Management then is responsible for syncing these to the actual spoke cluster and reporting back the status of these resources to the Hub. A user would indicate which clusters they want a gateway placed on by using a <code>Placement</code> and then labeling the gateway using the <code>cluster.open-cluster-management.io/placement</code> label.</p> <p>In order for the Gateway to be instantiated, we need to know what underlying gateway provider is being used on the spoke clusters. Admins can then set this provider in the hub via the GatewayClass params. In the hub, Kuadrant will then apply a transformation to the gateway to ensure when synced it references this spoke gateway provider (Istio for example). </p> <p>It is the Open Cluster Management workagent that is responsible for syncing down and applying the resources into the managed spoke cluster. It is also responsible for syncing status information back to the hub. It is the multi-cluster gateway controller that is responsible for aggregating this status.</p> <p>The status information reported back to the Hub is used by the multi-cluster gateway controller to know what LB hosts / IPAddresses to use for DNSRecords that it creates and manages.</p> <p></p> <p>More info on the Open Cluster Management hub and spoke architecture can be found here</p>"},{"location":"architecture/docs/design/architectural-overview/#how-does-kuadrant-integrate-with-gateway-providers","title":"How does Kuadrant integrate with Gateway Providers?","text":"<p>Currently the Kuadrant data plane only integrates with an Istio based gateway provider:</p> <ul> <li>It registers Authorino with the <code>IstioOperator</code> as an auth provider so that Authorino can be used as an external auth provider.</li> <li>It leverages an <code>EnvoyFilter</code> to register the rate limiting service as an upstream service.</li> <li>Based on the Kuadrant <code>AuthPolicy</code>, it leverages Istio's <code>AuthorizationPolicy</code> resource to configure when a request should trigger Authorino to be called for a given host, path and method etc. </li> <li>It provides a WebAssembly (WASM) Plugin that conforms to the Proxy WASM ABI (application binary interface). This WASM Plugin is loaded into the underlying Envoy based gateway provider and configured via the Kuadrant Operator based on defined <code>RateLimitPolicy</code> resources. This binary is executed in response to a HTTP request being accepted by the gateway via the underlying Envoy instance that provides the proxy layer for the Gateway (IE Envoy). This plugin is configured with the correct upstream rate limit service name and when it sees a request, based on the provided configuration, it will trigger a call to the installed Limitador that is providing the rate limit capabilities and either allow the request to continue or trigger a response to the client with a 429 (too many requests) HTTP code.</li> </ul>"},{"location":"architecture/docs/design/architectural-overview/#data-flows","title":"Data Flows","text":"<p>There are several different data flows when using Kuadrant. </p>"},{"location":"architecture/docs/design/architectural-overview/#control-plane-configuration-and-status-reporting","title":"Control plane configuration and status reporting","text":"<p>The initial creation of these APIs (gateways, policies etc) is done by the relevant persona in the control plane just as they would any other k8s resource. We use the term cluster admin or gateway admin as the operations type persona configuring, and placing gateways.  As shown above, in a multi-cluster configuration. API definitions are pulled from the Hub and \"manifested\" into the spokes. The Status of those synced resources are reported back to the Hub. The same happens for a single cluster, the only difference being the work agent hub controllers are all installed on one cluster.</p>"},{"location":"architecture/docs/design/architectural-overview/#third-party-enforcement-and-integration","title":"Third party enforcement and Integration","text":"<p>In order to enforce the policy configuration, components in the control plane and data plane can reach out to configured 3rd parties such as cloud based DNS provider, TLS providers and Auth providers.</p>"},{"location":"architecture/docs/design/architectural-overview/#request-flow","title":"Request Flow","text":"<p>Requests coming through the gateway instance can be sent to Limitador based on configuration of the WASM plugin installed into the Envoy based gateway provider or to Authorino based configuration provided by the Istio <code>AuthorizationPolicy</code>.  Each of these components have the capability to see the request and need to in order to make the required decision. Each of these components can also prevent the request from reaching its intended backend destination based on user configuration. </p> <p></p>"},{"location":"architecture/docs/design/architectural-overview/#auth","title":"Auth","text":"<p>As all of the APIs are CRDs, auth around creating these resources is handled in the standard way IE by the kubernetes cluster and RBAC. There is no relationship by default between the Auth features provided by Authorino to application developers and the auth requirements of the cluster API server.</p> <p>For Auth between Spoke and Hub see Open Cluster Management docs</p>"},{"location":"architecture/docs/design/architectural-overview/#observability","title":"Observability","text":"<p>Kuadrant doesn't provide any specific observability components, but rather provides a reference setup using well known and established components along with some useful dashboards to help observe key things around the Gateways. The focus of this setup, is in the context of a multi-cluster setup where Open Cluster Management is installed and gateways are being defined and distributed from that hub.</p> <p></p>"},{"location":"architecture/docs/design/architectural-overview/#some-notes-on-future-direction","title":"Some notes on future direction","text":"<p>This section is here to provide some insight into architectural changes that may be seen in the near future:</p> <p>What is in this doc represents the architecture at point our MVP release. Below are some areas that we have identified that are likely to change in the coming releases. As these happen, this doc will also evolve.</p> <ul> <li>We want to separate out the ocm integration into its own controller so that policies can evolve without a coupling to any one multi-cluster management solution</li> <li>We want to separate the policies into their own controller that is capable of supporting both single (without Open Cluster Management) and multi-cluster (with Open Cluster Management enabled) contexts, so that the barrier to entry is reduced for those starting with a single cluster</li> <li>We want to allow for an on cluster DNS Provider such as CoreDNS so that we can provide an implementation that is disconnected from any cloud provider and provides more flexible DNS setups.</li> <li>We will look to reduce our integration with Istio and want to provide integration with additional gateway providers such as EnvoyGateway</li> </ul>"},{"location":"architecture/docs/design/modular_installation/","title":"Kuadrant Proposal - Modular Installation","text":"<p>Kuadrant is developing a set of loosely coupled functionalities built directly on top of Kubernetes. Kuadrant aims to allow customers to just install, use and understand those functionalities they need.</p>"},{"location":"architecture/docs/design/modular_installation/#problem-statement","title":"Problem Statement","text":"<p>Currently, the installation tool of kuadrant, the kuadrantctl CLI, installs all or nothing. Installing more than the customer needs adds unneeded complexity and operational effort. For example, if a customer is looking for rate limiting and not interested in authentication functionality, then the customer should be able to just install and run that part of Kuadrant.</p>"},{"location":"architecture/docs/design/modular_installation/#high-level-goals","title":"High Level Goals","text":"<ul> <li>Install only required components. Operate only required components.</li> </ul> <p>Reduce system complexity and operational effort to the minimum required. Components in this context make reference to deployments and running instances.</p> <ul> <li>Expose only the activated functionalities</li> </ul> <p>A user of a partial Kuadrant install should not be confronted with data in custom resources that has no meaning or is not accessible in their partial Kuadrant install. The design of the kuadrant API should have this goal into account.</p>"},{"location":"architecture/docs/design/modular_installation/#proposed-solution","title":"Proposed Solution","text":"<p>The kuadrant installation mechanism should offer modular installation to enable/disable loosely coupled pieces of kuadrant. Modular installation options should be feature oriented rather than deployment component oriented. Then, it is up to the installation tool to decide what components need to be deployed and how to configure it.</p> <p>Each feature, or part of it, is eligible to be included or excluded when installing kuadrant.</p> <p>Some profiles can be defined to group set of commonly required features. Naming the profiles allows the customer to easily express wanted installation configuration. Furthermore, profiles not only can be used to group a set of features, profiles can be used to define deployment options.</p> Name Description Minimal Minimal installation required to run an API without any protection, analytics or API management. Default deployment option AuthZ Authentication and authorization mechanisms activated RateLimit Basic rate limit (only pre-auth rate limit) features Full Full featured kuadrant installation <p>A kuadrant operator, together with a design of a kuadrant CRD is desired. Not only for kuadrant installation, but also for lifecycle management. Additionally, the kuadrantctl CLI tool can also be useful to either deploy kuadrant components and manifests or just deploy the kuadrant operator.</p> <p>The kuadrant control plane should be aware of the installed profile via env vars or command line params in the control plane running components. With that information, the control plane can decide to enable or disable CRD watching, label and annotation monitoring and ultimately reject any configuration object that relies on disabled functionality. The least a customer can expect from kuadrant is to be consistent and reject any functionality request that cannot provide.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/","title":"RateLimitPolicy API v2","text":"<ul> <li>Feature Name: <code>rlp-v2</code></li> <li>Start Date: 2023-02-02</li> <li>RFC PR: Kuadrant/architecture#12</li> <li>Issue tracking: Kuadrant/architecture#13</li> </ul>"},{"location":"architecture/rfcs/0001-rlp-v2/#summary","title":"Summary","text":"<p>Proposal of new API for the Kuadrant's <code>RateLimitPolicy</code> (RLP) CRD, for improved UX.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#motivation","title":"Motivation","text":"<p>The <code>RateLimitPolicy</code> API (v1beta1), particularly its <code>RateLimit</code> type used in <code>ratelimitpolicy.spec.rateLimits</code>, designed in part to fit the underlying implementation based on the Envoy Rate limit filter, has been proven to be complex, as well as somewhat limiting for the extension of the API for other platforms and/or for supporting use cases of not contemplated in the original design.</p> <p>Users of the <code>RateLimitPolicy</code> will immediately recognize elements of Envoy's Rate limit API in the definitions of the <code>RateLimit</code> type, with almost 1:1 correspondence between the <code>Configuration</code> type and its counterpart in the Envoy configuration. Although compatibility between those continue to be desired, leaking such implementation details to the level of the API can be avoided to provide a better abstraction for activators (\"matchers\") and payload (\"descriptors\"), stated by users in a seamless way.</p> <p>Furthermore, the <code>Limit</code> type \u2013 used as well in the RLP's <code>RateLimit</code> type \u2013 implies presently a logical relationship between its inner concepts \u2013 i.e. conditions and variables on one side, and limits themselves on the other \u2013 that otherwise could be shaped in a different manner, to provide clearer understanding of the meaning of these concepts by the user and avoid repetition. I.e., one limit definition contains multiple rate limits, and not the other way around.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#goals","title":"Goals","text":"<ol> <li>Decouple the API from the underlying implementation - i.e. provide a more generic and more user-friendly abstraction</li> <li>Prepare the API for upcoming changes in the Gateway API Policy Attachment specification</li> <li>Improve consistency of the API with respect to Kuadrant's AuthPolicy CRD - i.e. same language, similar UX</li> </ol>"},{"location":"architecture/rfcs/0001-rlp-v2/#current-wip-to-consider","title":"Current WIP to consider","text":"<ol> <li>Policy attachment update (kubernetes-sigs/gateway-api#1565)</li> <li>No merging of policies (kuadrant/architecture#10)</li> <li>A single Policy scoped to HTTPRoutes and HTTPRouteRule (kuadrant/architecture#4) - future</li> <li>Implement <code>skip_if_absent</code> for the RequestHeaders action (kuadrant/wasm-shim#29)</li> </ol>"},{"location":"architecture/rfcs/0001-rlp-v2/#highlights","title":"Highlights","text":"<ul> <li><code>spec.rateLimits[]</code> replaced with <code>spec.limits{&lt;limit-name&gt;: &lt;limit-definition&gt;}</code></li> <li><code>spec.rateLimits.limits</code> replaced with <code>spec.limits.&lt;limit-name&gt;.rates</code></li> <li><code>spec.rateLimits.limits.maxValue</code> replaced with <code>spec.limits.&lt;limit-name&gt;.rates.limit</code></li> <li><code>spec.rateLimits.limits.seconds</code> replaced with <code>spec.limits.&lt;limit-name&gt;.rates.duration</code> + <code>spec.limits.&lt;limit-name&gt;.rates.unit</code></li> <li><code>spec.rateLimits.limits.conditions</code> replaced with <code>spec.limits.&lt;limit-name&gt;.when</code>, structured field based on well-known selectors, mainly for expressing conditions not related to the HTTP route (although not exclusively)</li> <li><code>spec.rateLimits.limits.variables</code> replaced with <code>spec.limits.&lt;limit-name&gt;.counters</code>, based on well-known selectors</li> <li><code>spec.rateLimits.rules</code> replaced with <code>spec.limits.&lt;limit-name&gt;.routeSelectors</code>, for selecting (or \"sub-targeting\") HTTPRouteRules that trigger the limit</li> <li>new matcher <code>spec.limits.&lt;limit-name&gt;.routeSelectors.hostnames[]</code></li> <li><code>spec.rateLimits.configurations</code> removed \u2013 descriptor actions configuration (previously <code>spec.rateLimits.configurations.actions</code>) generated from <code>spec.limits.&lt;limit-name&gt;.when.selector</code> \u222a <code>spec.limits.&lt;limit-name&gt;.counters</code> and unique identifier of the limit (associated with <code>spec.limits.&lt;limit-name&gt;.routeSelectors</code>)</li> <li>Limitador conditions composed of \"soft\" <code>spec.limits.&lt;limit-name&gt;.when</code> conditions + a \"hard\" condition that binds the limit to its trigger HTTPRouteRules</li> </ul> <p>For detailed differences between current and new RLP API, see Comparison to current RateLimitPolicy.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#guide-level-explanation","title":"Guide-level explanation","text":""},{"location":"architecture/rfcs/0001-rlp-v2/#examples-of-rlps-based-on-the-new-api","title":"Examples of RLPs based on the new API","text":"<p>Given the following network resources:</p> <pre><code>apiVersion: gateway.networking.k8s.io/v1alpha2\nkind: Gateway\nmetadata:\n  name: istio-ingressgateway\n  namespace: istio-system\nspec:\n  gatewayClassName: istio\n  listeners:\n\n  - hostname:\n    - \"*.acme.com\"\n---\napiVersion: gateway.networking.k8s.io/v1alpha2\nkind: HTTPRoute\nmetadata:\n  name: toystore\n  namespace: toystore\nspec:\n  parentRefs:\n  - name: istio-ingressgateway\n    namespace: istio-system\n  hostnames:\n  - \"*.toystore.acme.com\"\n  rules:\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/toys\"\n      method: GET\n    - path:\n        type: PathPrefix\n        value: \"/toys\"\n      method: POST\n    backendRefs:\n    - name: toystore\n      port: 80\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/assets/\"\n    backendRefs:\n    - name: toystore\n      port: 80\n    filters:\n    - type: ResponseHeaderModifier\n      responseHeaderModifier:\n        set:\n        - name: Cache-Control\n          value: \"max-age=31536000, immutable\"\n</code></pre> <p>The following are examples of RLPs targeting the route and the gateway. Each example is independent from the other.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#example-1-minimal-example-network-resource-targeted-entirely-without-filtering-unconditional-and-unqualified-rate-limiting","title":"Example 1. Minimal example - network resource targeted entirely without filtering, unconditional and unqualified rate limiting","text":"<p>In this example, all traffic to <code>*.toystore.acme.com</code> will be limited to 5rps, regardless of any other attribute of the HTTP request (method, path, headers, etc), without any extra \"soft\" conditions (conditions non-related to the HTTP route), across all consumers of the API (unqualified rate limiting).</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore-infra-rl\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    base: # user-defined name of the limit definition - future use for handling hierarchical policy attachment\n\n    - rates: # at least one rate limit required\n      - limit: 5\n        unit: second\n</code></pre> <sub>How is this RLP implemented under the hood?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/toys*\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/toys*\"]\n    methods: [\"POST\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/assets/*\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-infra-rl/base\"\n      descriptor_value: \"1\"\n</code></pre> <pre><code>limits:\n\n- conditions:\n  - toystore/toystore-infra-rl/base == \"1\"\n  max_value: 5\n  seconds: 1\n  namespace: TDB\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#example-2-targeting-specific-route-rules-with-counter-qualifiers-multiple-rates-per-limit-definition-and-soft-conditions","title":"Example 2. Targeting specific route rules, with counter qualifiers, multiple rates per limit definition and \"soft\" conditions","text":"<p>In this example, a distinct limit will be associated (\"bound\") to each individual HTTPRouteRule of the targeted HTTPRoute, by using the <code>routeSelectors</code> field for selecting (or \"sub-targeting\") the HTTPRouteRule.</p> <p>The following limit definitions will be bound to each HTTPRouteRule:</p> <ul> <li><code>/toys*</code> \u2192 50rpm, enforced per username (counter qualifier) and only in case the user is not an admin (\"soft\" condition).</li> <li><code>/assets/*</code> \u2192 5rpm / 100rp12h</li> </ul> <p>Each set of trigger matches in the RLP will be matched to all HTTPRouteRules whose HTTPRouteMatches is a superset of the set of trigger matches in the RLP. For every HTTPRouteRule matched, the HTTPRouteRule will be bound to the corresponding limit definition that specifies that trigger. In case no HTTPRouteRule is found containing at least one HTTPRouteMatch that is identical to some set of matching rules of a particular limit definition, the limit definition is considered invalid and reported as such in the status of RLP.</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore-per-endpoint\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    toys:\n      rates:\n\n      - limit: 50\n        duration: 1\n        unit: minute\n      counters:\n      - auth.identity.username\n      routeSelectors:\n      - matches: # matches the 1st HTTPRouteRule (i.e. GET or POST to /toys*)\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n      when:\n      - selector: auth.identity.group\n        operator: neq\n        value: admin\n\n    assets:\n      rates:\n\n      - limit: 5\n        duration: 1\n        unit: minute\n      - limit: 100\n        duration: 12\n        unit: hour\n      routeSelectors:\n      - matches: # matches the 2nd HTTPRouteRule (i.e. /assets/*)\n        - path:\n            type: PathPrefix\n            value: \"/assets/\"\n</code></pre> <sub>How is this RLP implemented under the hood?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/toys*\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/toys*\"]\n    methods: [\"POST\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-per-endpoint/toys\"\n      descriptor_value: \"1\"\n  - metadata:\n      descriptor_key: \"auth.identity.group\"\n      metadata_key:\n        key: \"envoy.filters.http.ext_authz\"\n        path:\n        - segment:\n            key: \"identity\"\n        - segment:\n            key: \"group\"\n  - metadata:\n      descriptor_key: \"auth.identity.username\"\n      metadata_key:\n        key: \"envoy.filters.http.ext_authz\"\n        path:\n        - segment:\n            key: \"identity\"\n        - segment:\n            key: \"username\"\n- rules:\n  - paths: [\"/assets/*\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-per-endpoint/assets\"\n      descriptor_value: \"1\"\n</code></pre> <pre><code>limits:\n\n- conditions:\n  - toystore/toystore-per-endpoint/toys == \"1\"\n  - auth.identity.group != \"admin\"\n  variables:\n  - auth.identity.username\n  max_value: 50\n  seconds: 60\n  namespace: kuadrant\n- conditions:\n  - toystore/toystore-per-endpoint/assets == \"1\"\n  max_value: 5\n  seconds: 60\n  namespace: kuadrant\n- conditions:\n  - toystore/toystore-per-endpoint/assets == \"1\"\n  max_value: 100\n  seconds: 43200 # 12 hours\n  namespace: kuadrant\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#example-3-targeting-a-subset-of-an-httprouterule-httproutematch-missing","title":"Example 3. Targeting a subset of an HTTPRouteRule - HTTPRouteMatch missing","text":"<p>Consider a 150rps rate limit set on requests to <code>GET /toys/special</code>. Such specific application endpoint is covered by the first HTTPRouteRule in the HTTPRoute (as a subset of <code>GET</code> or <code>POST</code> to any path that starts with <code>/toys</code>). However, to avoid binding limits to HTTPRouteRules that are more permissive than the actual intended scope of the limit, the RateLimitPolicy controller requires trigger matches to find identical matching rules explicitly defined amongst the sets of HTTPRouteMatches of the HTTPRouteRules potentially targeted.</p> <p>As a consequence, by simply defining a trigger match for <code>GET /toys/special</code> in the RLP, the <code>GET|POST /toys*</code> HTTPRouteRule will NOT be bound to the limit definition. In order to ensure the limit definition is properly bound to a routing rule that strictly covers the <code>GET /toys/special</code> application endpoint, first the user has to modify the spec of the HTTPRoute by adding an explicit HTTPRouteRule for this case:</p> <pre><code>apiVersion: gateway.networking.k8s.io/v1alpha2\nkind: HTTPRoute\nmetadata:\n  name: toystore\n  namespace: toystore\nspec:\n  parentRefs:\n\n  - name: istio-ingressgateway\n    namespace: istio-system\n  hostnames:\n  - \"*.toystore.acme.com\"\n  rules:\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/toys\"\n      method: GET\n    - path:\n        type: PathPrefix\n        value: \"/toys\"\n      method: POST\n    backendRefs:\n    - name: toystore\n      port: 80\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/assets/\"\n    backendRefs:\n    - name: toystore\n      port: 80\n    filters:\n    - type: ResponseHeaderModifier\n      responseHeaderModifier:\n        set:\n        - name: Cache-Control\n          value: \"max-age=31536000, immutable\"\n  - matches: # new (more specific) HTTPRouteRule added\n    - path:\n        type: Exact\n        value: \"/toys/special\"\n      method: GET\n    backendRefs:\n    - name: toystore\n      port: 80\n</code></pre> <p>After that, the RLP can target the new HTTPRouteRule strictly:</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore-special-toys\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    specialToys:\n      rates:\n\n      - limit: 150\n        unit: second\n      routeSelectors:\n      - matches: # matches the new HTTPRouteRule (i.e. GET /toys/special)\n        - path:\n            type: Exact\n            value: \"/toys/special\"\n          method: GET\n</code></pre> <sub>How is this RLP implemented under the hood?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/toys/special\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-special-toys/specialToys\"\n      descriptor_value: \"1\"\n</code></pre> <pre><code>limits:\n\n- conditions:\n  - toystore/toystore-special-toys/specialToys == \"1\"\n  max_value: 150\n  seconds: 1\n  namespace: kuadrant\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#example-4-targeting-a-subset-of-an-httprouterule-httproutematch-found","title":"Example 4. Targeting a subset of an HTTPRouteRule - HTTPRouteMatch found","text":"<p>This example is similar to Example 3. Consider the use case of setting a 150rpm rate limit on requests to <code>GET /toys*</code>.</p> <p>The targeted application endpoint is covered by the first HTTPRouteRule in the HTTPRoute (as a subset of <code>GET</code> or <code>POST</code> to any path that starts with <code>/toys</code>). However, unlike in the previous example where, at first, no HTTPRouteRule included an explicit HTTPRouteMatch for <code>GET /toys/special</code>, in this example the HTTPRouteMatch for the targeted application endpoint <code>GET /toys*</code> does exist explicitly in one of the HTTPRouteRules, thus the RateLimitPolicy controller would find no problem to bind the limit definition to the HTTPRouteRule. That would nonetheless cause a unexpected behavior of the limit triggered not strictly for <code>GET /toys*</code>, but also for <code>POST /toys*</code>.</p> <p>To avoid extending the scope of the limit beyond desired, with no extra \"soft\" conditions, again the user must modify the spec of the HTTPRoute, so an exclusive HTTPRouteRule exists for the <code>GET /toys*</code> application endpoint:</p> <pre><code>apiVersion: gateway.networking.k8s.io/v1alpha2\nkind: HTTPRoute\nmetadata:\n  name: toystore\n  namespace: toystore\nspec:\n  parentRefs:\n\n  - name: istio-ingressgateway\n    namespace: istio-system\n  hostnames:\n  - \"*.toystore.acme.com\"\n  rules:\n  - matches: # first HTTPRouteRule split into two \u2013 one for GET /toys*, other for POST /toys*\n    - path:\n        type: PathPrefix\n        value: \"/toys\"\n      method: GET\n    backendRefs:\n    - name: toystore\n      port: 80\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/toys\"\n      method: POST\n    backendRefs:\n    - name: toystore\n      port: 80\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/assets/\"\n    backendRefs:\n    - name: toystore\n      port: 80\n    filters:\n    - type: ResponseHeaderModifier\n      responseHeaderModifier:\n        set:\n        - name: Cache-Control\n          value: \"max-age=31536000, immutable\"\n</code></pre> <p>The RLP can then target the new HTTPRouteRule strictly:</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toy-readers\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    toyReaders:\n      rates:\n\n      - limit: 150\n        unit: second\n      routeSelectors:\n      - matches: # matches the new more specific HTTPRouteRule (i.e. GET /toys*)\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n          method: GET\n</code></pre> <sub>How is this RLP implemented under the hood?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/toys*\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toy-readers/toyReaders\"\n      descriptor_value: \"1\"\n</code></pre> <pre><code>limits:\n\n- conditions:\n  - toystore/toy-readers/toyReaders == \"1\"\n  max_value: 150\n  seconds: 1\n  namespace: kuadrant\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#example-5-one-limit-triggered-by-multiple-httprouterules","title":"Example 5. One limit triggered by multiple HTTPRouteRules","text":"<p>In this example, both HTTPRouteRules, i.e. <code>GET|POST /toys*</code> and <code>/assets/*</code>, are targeted by the same limit of 50rpm per username.</p> <p>Because the HTTPRoute has no other rule, this is technically equivalent to targeting the entire HTTPRoute and therefore similar to Example 1. However, if the HTTPRoute had other rules or got other rules added afterwards, this would ensure the limit applies only to the two original route rules.</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore-per-user\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    toysOrAssetsPerUsername:\n      rates:\n\n      - limit: 50\n        duration: 1\n        unit: minute\n      counters:\n      - auth.identity.username\n      routeSelectors:\n      - matches:\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n          method: GET\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n          method: POST\n      - matches:\n        - path:\n            type: PathPrefix\n            value: \"/assets/\"\n</code></pre> <sub>How is this RLP implemented under the hood?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/toys*\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/toys*\"]\n    methods: [\"POST\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/assets/*\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-per-user/toysOrAssetsPerUsername\"\n      descriptor_value: \"1\"\n  - metadata:\n      descriptor_key: \"auth.identity.username\"\n      metadata_key:\n        key: \"envoy.filters.http.ext_authz\"\n        path:\n        - segment:\n            key: \"identity\"\n        - segment:\n            key: \"username\"\n</code></pre> <pre><code>limits:\n\n- conditions:\n  - toystore/toystore-per-user/toysOrAssetsPerUsername == \"1\"\n  variables:\n  - auth.identity.username\n  max_value: 50\n  seconds: 60\n  namespace: kuadrant\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#example-6-multiple-limit-definitions-targeting-the-same-httprouterule","title":"Example 6. Multiple limit definitions targeting the same HTTPRouteRule","text":"<p>In case multiple limit definitions target a same HTTPRouteRule, all those limit definitions will be bound to the HTTPRouteRule. No limit \"shadowing\" will be be enforced by the RLP controller. Due to how things work as of today in Limitador nonetheless (i.e. the rule of the most restrictive limit wins), in some cases, across multiple limits triggered, one limit ends up \"shadowing\" others, depending on further qualification of the counters and the actual RL values.</p> <p>E.g., the following RLP intends to set 50rps per username on <code>GET /toys*</code>, and 100rps on <code>POST /toys*</code> or <code>/assets/*</code>:</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore-per-endpoint\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    readToys:\n      rates:\n\n      - limit: 50\n        unit: second\n      counters:\n      - auth.identity.username\n      routeSelectors:\n      - matches: # matches the 1st HTTPRouteRule (i.e. GET or POST to /toys*)\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n          method: GET\n\n    postToysOrAssets:\n      rates:\n\n      - limit: 100\n        unit: second\n      routeSelectors:\n      - matches: # matches the 1st HTTPRouteRule (i.e. GET or POST to /toys*)\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n          method: POST\n      - matches: # matches the 2nd HTTPRouteRule (i.e. /assets/*)\n        - path:\n            type: PathPrefix\n            value: \"/assets/\"\n</code></pre> <sub>How is this RLP implemented under the hood?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/toys*\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/toys*\"]\n    methods: [\"POST\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-per-endpoint/readToys\"\n      descriptor_value: \"1\"\n  - metadata:\n      descriptor_key: \"auth.identity.username\"\n      metadata_key:\n        key: \"envoy.filters.http.ext_authz\"\n        path:\n        - segment:\n            key: \"identity\"\n        - segment:\n            key: \"username\"\n- rules:\n  - paths: [\"/toys*\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/toys*\"]\n    methods: [\"POST\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/assets/*\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-per-endpoint/readToys\"\n      descriptor_value: \"1\"\n  - generic_key:\n      descriptor_key: \"toystore/toystore-per-endpoint/postToysOrAssets\"\n      descriptor_value: \"1\"\n</code></pre> <pre><code>limits:\n\n- conditions: # actually applies to GET|POST /toys*\n  - toystore/toystore-per-endpoint/readToys == \"1\"\n  variables:\n  - auth.identity.username\n  max_value: 50\n  seconds: 1\n  namespace: kuadrant\n- conditions: # actually applies to GET|POST /toys* and /assets/*\n  - toystore/toystore-per-endpoint/postToysOrAssets == \"1\"\n  max_value: 100\n  seconds: 1\n  namespace: kuadrant\n</code></pre> <p>This example was only written in this way to highlight that it is possible that multiple limit definitions select a same HTTPRouteRule. To avoid over-limiting between <code>GET|POST /toys*</code> and thus ensure the originally intended limit definitions for each of these routes apply, the HTTPRouteRule should be split into two, like done in Example 4.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#example-7-limits-triggered-for-specific-hostnames","title":"Example 7. Limits triggered for specific hostnames","text":"<p>In the previous examples, the limit definitions and therefore the counters were set indistinctly for all hostnames \u2013 i.e. no matter if the request is sent to <code>games.toystore.acme.com</code> or <code>dolls.toystore.acme.com</code>, the same counters are expected to be affected. In this example on the other hand, a 1000rpd rate limit is set for requests to <code>/assets/*</code> only when the hostname matches <code>games.toystore.acme.com</code>.</p> <p>First, the user needs to edit the HTTPRoute to make the targeted hostname <code>games.toystore.acme.com</code> explicit:</p> <pre><code>apiVersion: gateway.networking.k8s.io/v1alpha2\nkind: HTTPRoute\nmetadata:\n  name: toystore\n  namespace: toystore\nspec:\n  parentRefs:\n\n  - name: istio-ingressgateway\n    namespace: istio-system\n  hostnames:\n  - \"*.toystore.acme.com\"\n  - games.toystore.acme.com # new (more specific) hostname added\n  rules:\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/toys\"\n      method: GET\n    - path:\n        type: PathPrefix\n        value: \"/toys\"\n      method: POST\n    backendRefs:\n    - name: toystore\n      port: 80\n  - matches:\n    - path:\n        type: PathPrefix\n        value: \"/assets/\"\n    backendRefs:\n    - name: toystore\n      port: 80\n    filters:\n    - type: ResponseHeaderModifier\n      responseHeaderModifier:\n        set:\n        - name: Cache-Control\n          value: \"max-age=31536000, immutable\"\n</code></pre> <p>After that, the RLP can target specifically the newly added hostname:</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore-per-hostname\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    games:\n      rates:\n\n      - limit: 1000\n        unit: day\n      routeSelectors:\n      - matches:\n        - path:\n            type: PathPrefix\n            value: \"/assets/\"\n        hostnames:\n        - games.toystore.acme.com\n</code></pre> <sub>How is this RLP implemented under the hood?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/assets/*\"]\n    hosts: [\"games.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-per-hostname/games\"\n      descriptor_value: \"1\"\n</code></pre> <pre><code>limits:\n\n- conditions:\n  - toystore/toystore-per-hostname/games == \"1\"\n  max_value: 1000\n  seconds: 86400 # 1 day\n  namespace: kuadrant\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#example-8-targeting-the-gateway","title":"Example 8. Targeting the Gateway","text":"<p>Note: Additional meaning and context may be given to this use case in the future, when discussing defaults and overrides.</p> <p>Targeting a Gateway is a shortcut to targeting all individual HTTPRoutes referencing the gateway as parent. This differs from Example 1 nonetheless because, by targeting the gateway rather than an individual HTTPRoute, the RLP applies automatically to all HTTPRoutes pointing to the gateway, including routes created before and after the creation of the RLP. Moreover, all those routes will share the same limit counters specified in the RLP.</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: gw-rl\n  namespace: istio-ingressgateway\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: Gateway\n    name: istio-ingressgateway\n  limits:\n    base:\n\n    - rates:\n      - limit: 5\n        unit: second\n</code></pre> <sub>How is this RLP implemented under the hood?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/toys*\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/toys*\"]\n    methods: [\"POST\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/assets/*\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"istio-system/gw-rl/base\"\n      descriptor_value: \"1\"\n</code></pre> <pre><code>limits:\n\n- conditions:\n  - istio-system/gw-rl/base == \"1\"\n  max_value: 5\n  seconds: 1\n  namespace: TDB\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#comparison-to-current-ratelimitpolicy","title":"Comparison to current RateLimitPolicy","text":"Current New Reason 1:1 relation between Limit (the object) and the actual Rate limit (the value) (<code>spec.rateLimits.limits</code>) Rate limit becomes a detail of Limit where each limit may define one or more rates (1:N) (<code>spec.limits.&lt;limit-name&gt;.rates</code>) <ul> <li>It allows to reuse <code>when</code> conditions and <code>counters</code> for groups of rate limits</li> </ul> Parsed <code>spec.rateLimits.limits.conditions</code> field, directly exposing the Limitador's API Structured <code>spec.limits.&lt;limit-name&gt;.when</code> condition field composed of 3 well-defined properties: <code>selector</code>, <code>operator</code> and <code>value</code> <ul> <li>Feels more K8s-native</li> <li>Consistent with github.com/kuadrant/authorino/api/v1beta1#JSONPatternExpression</li> <li>No need for a parser (only if implemented by Limitador)</li> </ul> <code>spec.rateLimits.configurations</code> as a list of \"variables assignments\" and direct exposure of Envoy's RL descriptor actions API Descriptor actions composed from selectors used in the limit definitions (<code>spec.limits.&lt;limit-name&gt;.when.selector</code> and <code>spec.limits.&lt;limit-name&gt;.counters</code>) plus a fixed identifier of the route rules (<code>spec.limits.&lt;limit-name&gt;.routeSelectors</code>) <ul> <li>Abstract the Envoy-specific concepts of \"actions\" and \"descriptors\"</li> <li>No risk of mismatching descriptors keys between \"actions\" and actual usage in the limits</li> <li>No user-defined generic descriptors (e.g. \"limited = 1\")</li> <li>Source value of the selectors defined from an implicit \"context\" data structure</li> </ul> Key-value descriptors Structured descriptors referring to a contextual well-known data structure <ul> <li>Consistent with Authorino's Authorization JSON (#context)</li> </ul> Limitador conditions independent from the route rules Artificial Limitador condition injected to bind routes and corresponding limits <ul> <li>Ensure the limit is enforced only for corresponding selected HTTPRouteRules</li> </ul> <code>translate(spec.rateLimits.rules) \u2282 httproute.spec.rules</code> <code>spec.limits.&lt;limit-name&gt;.routeSelectors.matches \u2286 httproute.spec.rules.matches</code> <ul> <li>HTTPRouteRule selector (via HTTPRouteMatch subset)</li> <li>Gateway API language</li> <li>Preparation for inherited policies and defaults &amp; overrides</li> </ul> <code>spec.rateLimits.limits.seconds</code> <code>spec.limits.&lt;limit-name&gt;.rates.duration</code> and <code>spec.limits.&lt;limit-name&gt;.rates.unit</code> <ul> <li>Support for more units beyond seconds</li> <li><code>duration: 1</code> by default</li> </ul> <code>spec.rateLimits.limits.variables</code> <code>spec.limits.&lt;limit-name&gt;.counters</code> <ul> <li>Improved (more specific) naming</li> </ul> <code>spec.rateLimits.limits.maxValue</code> <code>spec.limits.&lt;limit-name&gt;.rates.limit</code> <ul> <li>Improved (more generic) naming</li> </ul>"},{"location":"architecture/rfcs/0001-rlp-v2/#reference-level-explanation","title":"Reference-level explanation","text":"<p>By completely dropping out the <code>configurations</code> field from the RLP, composing the RL descriptor actions is now done based essentially on the selectors listed in the <code>when</code> conditions and the <code>counters</code>, plus an artificial condition used to bind the HTTPRouteRules to the corresponding limits to trigger in Limitador.</p> <p>The descriptor actions composed from the selectors in the \"soft\" <code>when</code> conditions and counter qualifiers originate from the direct references these selectors make to paths within a well-known data structure that stores information about the context (HTTP request and ext-authz filter). These selectors in \"soft\" <code>when</code> conditions and counter qualifiers are thereby called well-known selectors.</p> <p>Other descriptor actions might be composed by the RLP controller to define additional RL conditions to bind HTTPRouteRules and corresponding limits.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#well-known-selectors","title":"Well-known selectors","text":"<p>Each selector used in a <code>when</code> condition or counter qualifier is a direct reference to a path within a well-known data structure that stores information about the <code>context</code> (L4 and L7 data of the original request handled by the proxy), as well as <code>auth</code> data (dynamic metadata occasionally exported by the external authorization filter and injected by the proxy into the rate-limit filter).</p> <p>The well-known data structure for building RL descriptor actions resembles Authorino's \"Authorization JSON\", whose <code>context</code> component consists of Envoy's <code>AttributeContext</code> type of the external authorization API (marshalled as JSON). Compared to the more generic <code>RateLimitRequest</code> struct, the <code>AttributeContext</code> provides a more structured and arguibly more intuitive relation between the data sources for the RL descriptors actions and their corresponding key names through which the values are referred within the RLP, in a context of predominantly serving for HTTP applications.</p> <p>To keep compatibility with the Envoy Rate Limit API, the well-known data structure can optionally be extended with the <code>RateLimitRequest</code>, thus resulting in the following final structure.</p> <pre><code>context: # Envoy's Ext-Authz `CheckRequest.AttributeContext` type\n  source:\n    address: \u2026\n    service: \u2026\n    \u2026\n  destination:\n    address: \u2026\n    service: \u2026\n    \u2026\n  request:\n    http:\n      host: \u2026\n      path: \u2026\n      method: \u2026\n      headers: {\u2026}\n\nauth: # Dynamic metadata exported by the external authorization service\n\nratelimit: # Envoy's Rate Limit `RateLimitRequest` type\n  domain: \u2026 # generated by the Kuadrant controller\n  descriptors: {\u2026} # descriptors configured by the user directly in the proxy (not generated by the Kuadrant controller, if allowed)\n  hitsAddend: \u2026 # only in case we want to allow users to refer to this value in a policy\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#mechanics-of-generating-rl-descriptor-actions","title":"Mechanics of generating RL descriptor actions","text":"<p>From the perspective of a user who writes a RLP, the selectors used in then <code>when</code> and <code>counters</code> fields are paths to the well-known data structure (see Well-known selectors). While desiging a policy, the user intuitively pictures the well-known data structure and states each limit definition having in mind the possible values assumed by each of those paths in the data plane. For example,</p> <p>The user story:</p> <p>Each distinct user (<code>auth.identity.username</code>) can send no more than 1rps to the same HTTP path (<code>context.request.http.path</code>).</p> <p>...materializes as the following RLP:</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    dolls:\n      rates:\n\n      - limit: 1\n        unit: second\n      counters:\n      - auth.identity.username\n      - context.request.http.path\n</code></pre> <p>The following selectors are to be interpreted by the RLP controller:</p> <ul> <li><code>auth.identity.username</code></li> <li><code>context.request.http.path</code></li> </ul> <p>The RLP controller uses a map to translate each selector into its corresponding descriptor action. (Roughly described:)</p> <pre><code>context.source.address    \u2192 source_cluster(...) # TBC\ncontext.source.service    \u2192 source_cluster(...) # TBC\ncontext.destination...    \u2192 destination_cluster(...)\ncontext.destination...    \u2192 destination_cluster(...)\ncontext.request.http.&lt;X&gt;  \u2192 request_headers(header_name: \":&lt;X&gt;\")\ncontext.request...        \u2192 ...\nauth.&lt;X&gt;                  \u2192 metadata(key: \"envoy.filters.http.ext_authz\", path: &lt;X&gt;)\nratelimit.domain          \u2192 &lt;hostname&gt;\n</code></pre> <p>...to yield effectively:</p> <pre><code>rate_limits:\n\n- actions:\n  - metadata:\n      descriptor_key: \"auth.identity.username\"\n      metadata_key:\n        key: \"envoy.filters.http.ext_authz\"\n        path:\n        - segment:\n            key: \"identity\"\n        - segment:\n            key: \"username\"\n  - request_headers:\n      descriptor_key: \"context.request.http.path\"\n      header_name: \":path\"\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#artificial-limitador-condition-for-routeselectors","title":"Artificial Limitador condition for <code>routeSelectors</code>","text":"<p>For each limit definition that explicitly or implicitly defines a <code>routeSelectors</code> field, the RLP controller will generate an artificial Limitador condition that ensures that the limit applies only when the filterred rules are honoured when serving the request. This can be implemented with a 2-step procedure:</p> <ol> <li>generate an unique identifier of the limit - i.e. <code>&lt;policy-namespace&gt;/&lt;policy-name&gt;/&lt;limit-name&gt;</code></li> <li>associate a <code>generic_key</code> type descriptor action with each <code>HTTPRouteRule</code> targeted by the limit \u2013 i.e. <code>{ descriptor_key: &lt;unique identifier of the limit&gt;, descriptor_value: \"1\" }</code>.</li> </ol> <p>For example, given the following RLP:</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore-non-admin-users\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    toys:\n      routeSelectors:\n\n      - matches:\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n          method: GET\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n          method: POST\n      rates:\n      - limit: 50\n        duration: 1\n        unit: minute\n      when:\n      - selector: auth.identity.group\n        operator: neq\n        value: admin\n\n    assets:\n      routeSelectors:\n\n      - matches:\n        - path:\n            type: PathPrefix\n            value: \"/assets/\"\n      rates:\n      - limit: 5\n        duration: 1\n        unit: minute\n      when:\n      - selector: auth.identity.group\n        operator: neq\n        value: admin\n</code></pre> <p>Apart from the following descriptor action associated with both routes:</p> <pre><code>- metadata:\n    descriptor_key: \"auth.identity.group\"\n    metadata_key:\n      key: \"envoy.filters.http.ext_authz\"\n      path:\n      - segment:\n          key: \"identity\"\n      - segment:\n          key: \"group\"\n</code></pre> <p>...and its corresponding Limitador condition:</p> <pre><code>auth.identity.group != \"admin\"\n</code></pre> <p>The following additional artificial descriptor actions will be generated:</p> <pre><code># associated with route rule GET|POST /toys*\n\n- generic_key:\n    descriptor_key: \"toystore/toystore-non-admin-users/toys\"\n    descriptor_value: \"1\"\n\n# associated with route rule /assets/*\n\n- generic_key:\n    descriptor_key: \"toystore/toystore-non-admin-users/assets\"\n    descriptor_value: \"1\"\n</code></pre> <p>...and their corresponding Limitador conditions.</p> <p>In the end, the following Limitador configuration is yielded:</p> <pre><code>- conditions:\n  - toystore/toystore-non-admin-users/toys == \"1\"\n  - auth.identity.group != \"admin\"\n  max_value: 50\n  seconds: 60\n  namespace: kuadrant\n\n\n- conditions:\n  - toystore/toystore-non-admin-users/assets == \"1\"\n  - auth.identity.group != \"admin\"\n  max_value: 5\n  seconds: 60\n  namespace: kuadrant\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#support-in-wasm-shim-and-envoy-rl-api","title":"Support in wasm shim and Envoy RL API","text":"<p>This proposal tries to keep compatibility with the Envoy API for rate limit and does not introduce any new requirement that otherwise would require the use of wasm shim to be implemented.</p> <p>In the case of implementation of this proposal in the wasm shim, all types of matchers supported by the HTTPRouteMatch type of Gateway API must be also supported in the <code>rate_limit_policies.gateway_actions.rules</code> field of the wasm plugin configuration. These include matchers based on path (prefix, exact), headers, query string parameters and method.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#drawbacks","title":"Drawbacks","text":"<p>HTTPRoute editing occasionally required Need to duplicate rules that don't explicitly include a matcher wanted for the policy, so that matcher can be added as a special case for each of those rules.</p> <p>Risk of over-targeting Some HTTPRouteRules might need to be split into more specific ones so a limit definition is not bound to beyond intended (e.g. target <code>method: GET</code> when the route matches <code>method: POST|GET</code>).</p> <p>Prone to consistency issues Typos and updates to the HTTPRoute can easily cause a mismatch and invalidate a RLP.</p> <p>Two types of conditions \u2013 <code>routeSelectors</code> and <code>when</code> conditions Although with different meanings (evaluates in the gateway vs. evaluated in Limitador) and meant for expressing different types of rules (HTTPRouteRule selectors vs. \"soft\" conditions based on attributes not related to the HTTP request), users might still perceive these as two ways of expressing conditions and find difficult to understand at first that \"soft\" conditions do not accept expressions related to attributes of the HTTP request.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#rationale-and-alternatives","title":"Rationale and alternatives","text":""},{"location":"architecture/rfcs/0001-rlp-v2/#targeting-full-httprouterules","title":"Targeting full HTTPRouteRules","text":"<p>Requiring users to specify full HTTPRouteRule matches in the RLP (as opposed to any subset of HTTPRoureMatches of targeted HTTPRouteRules \u2013 current proposal) contains some of the same drawbacks of this proposal, such as HTTPRoute editing occasionally required and prone to consistency issues. If, on one hand, it eliminates the risk of over-targeting, on the other hand, it does it at the cost of requiring excessively verbose policies written by the users, to the point of sometimes expecting user to have to specify trigger matching rules that are significantly more than what's originally and strictly intended.</p> <p>E.g.:</p> <p>On a HTTPRoute that contains the following HTTPRouteRules (simplified representation):</p> <pre><code>{ header: x-canary=true } \u2192 backend-canary\n{ * } \u2192 backend-rest\n</code></pre> <p>Where the user wants to define a RLP that targets <code>{ method: POST }</code>. First, the user needs to edit the HTTPRoute and duplicate the HTTPRouteRules:</p> <pre><code>{ header: x-canary=true, method: POST } \u2192 backend-canary\n{ header: x-canary=true } \u2192 backend-canary\n{ method: POST } \u2192 backend-rest\n{ * } \u2192 backend-rest\n</code></pre> <p>Then, user needs to include the following trigger in the RLP so only full HTTPRouteRules are specified:</p> <pre><code>{ header: x-canary=true, method: POST }\n{ method: POST }\n</code></pre> <p>The first matching rule of the trigger (i.e. <code>{ header: x-canary=true, method: POST }</code>) is beoynd the original user intent of targeting simply <code>{ method: POST }</code>.</p> <p>This issue can be even more concerning in the case of targeting gateways with multiple child HTTPRoutes. All the HTTPRoutes would have to be fixed and the HTTPRouteRules that cover for all the cases in all HTTPRoutes listed in the policy targeting the gateway.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#all-limit-definitions-apply-vs-limit-shadowing","title":"All limit definitions apply vs. Limit \"shadowing\"","text":"<p>The proposed binding between limit definition and HTTPRouteRules that trigger the limits was thought so multiple limit definitions can be bound to a same HTTPRouteRule that triggers those limits in Limitador. That means that no limit definition will \"shadow\" another at the level of the RLP controller, i.e. the RLP controller will honour the intended binding according to the selectors specified in the policy.</p> <p>Due to how things work as of today in Limitador nonetheless, i.e., the rule of the most restrictive limit wins, and because all limit definitions triggered by a given shared HTTPRouteRule, it might be the case that, across multiple limits triggered, one limit ends up \"shadowing\" other limits. However, that is by implementation of Limitador and therefore beyond the scope of the API.</p> <p>An alternative to the approach of allowing all limit definitions to be bound to a same selected HTTPRouteRules would be enforcing that, amongst multiple limit definitions targeting a same HTTPRouteRule, only the first of those limits definitions is bound to the HTTPRouteRule. This alternative approach effectively would cause the first limit to \"shadow\" any other on that particular HTTPRouteRule, as by implementation of the RLP controller (i.e., at API level).</p> <p>While the first approach causes an artificial Limitador condition of the form <code>&lt;policy-ns&gt;/&lt;policy-name&gt;/&lt;limit-name&gt; == \"1\"</code>, the alternative approach (\"limit shadowing\") could be implemented by generating a descriptor of the following form instead: <code>ratelimit.binding == \"&lt;policy-ns&gt;/&lt;policy-name&gt;/&lt;limit-name&gt;\"</code>.</p> <p>The downside of allowing multiple bindings to the same HTTPRouteRule is that all limits apply in Limitador, thus making status report frequently harder. The most restritive rate limit strategy implemented by Limitador might not be obvious to users who set multiple limit definitions and will require additional information reported back to the user about the actual status of the limit definitions stated in a RLP. On the other hand, it allows enables use cases of different limit definitions that vary on the counter qualifiers, additional \"soft\" conditions, or actual rate limit values to be triggered by a same HTTPRouteRule.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#writing-soft-when-conditions-based-on-attributes-of-the-http-request","title":"Writing \"soft\" <code>when</code> conditions based on attributes of the HTTP request","text":"<p>As a first step, users will not be able to write \"soft\" <code>when</code> conditions to selective apply rate limit definitions based on attributes of the HTTP request that otherwise could be specified using the <code>routeSelectors</code> field of the RLP instead.</p> <p>On one hand, using <code>when</code> conditions for route filtering would make it easy to define limits when the HTTPRoute cannot be modified to include the special rule. On the other hand, users would miss information in the status. An HTTPRouteRule for <code>GET|POST /toys*</code>, for example, that is targeted with an additional \"soft\" <code>when</code> condition that specifies that the method must be equal to <code>GET</code> and the path exactly equal to <code>/toys/special</code> (see Example 3) would be reported as rate limited with extra details that this is in fact only for <code>GET /toys/special</code>. For small deployments, this might be considered acceptable; however it would easily explode to unmanageable number of cases for deployments with only a few limit definitions and HTTPRouteRules.</p> <p>Moreover, by not specifying a more strict HTTPRouteRule for <code>GET /toys/special</code>, the RLP controller would bind the limit definition to other rules that would cause the rate limit filter to invoke the rate limit service (Limitador) for cases other than strictly <code>GET /toys/special</code>. Even if the rate limits would still be ensured to apply in Limitador only for <code>GET /toys/special</code> (due to the presence of a hypothetical \"soft\" <code>when</code> condition), an extra no-op hop to the rate limit service would happen. This is avoided with the current imposed limitation.</p> <p>Example of \"soft\" <code>when</code> conditions for rate limit based on attributes of the HTTP request (NOT SUPPORTED):</p> <pre><code>apiVersion: kuadrant.io/v2beta1\nkind: RateLimitPolicy\nmetadata:\n  name: toystore-special-toys\n  namespace: toystore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: toystore\n  limits:\n    specialToys:\n      rates:\n\n      - limit: 150\n        unit: second\n      routeSelectors:\n      - matches: # matches the original HTTPRouteRule GET|POST /toys*\n        - path:\n            type: PathPrefix\n            value: \"/toys\"\n          method: GET\n      when:\n      - selector: context.request.http.method # cannot omit this selector or POST /toys/special would also be rate limited\n        operator: eq\n        value: GET\n      - selector: context.request.http.path\n        operator: eq\n        value: /toys/special\n</code></pre> <sub>How is this RLP would be implemented under the hood if supported?</sub> <pre><code>gateway_actions:\n\n- rules:\n  - paths: [\"/toys*\"]\n    methods: [\"GET\"]\n    hosts: [\"*.toystore.acme.com\"]\n  - paths: [\"/toys*\"]\n    methods: [\"POST\"]\n    hosts: [\"*.toystore.acme.com\"]\n  configurations:\n  - generic_key:\n      descriptor_key: \"toystore/toystore-special-toys/specialToys\"\n      descriptor_value: \"1\"\n  - request_headers:\n      descriptor_key: \"context.request.http.method\"\n      header_name: \":method\"\n  - request_headers:\n      descriptor_key: \"context.request.http.path\"\n      header_name: \":path\"\n</code></pre> <pre><code>limits:\n\n- conditions:\n  - toystore/toystore-special-toys/specialToys == \"1\"\n  - context.request.http.method == \"GET\"\n  - context.request.http.path == \"/toys/special\"\n  max_value: 150\n  seconds: 1\n  namespace: kuadrant\n</code></pre>"},{"location":"architecture/rfcs/0001-rlp-v2/#possible-variations-for-the-selectors-conditions-and-counter-qualifiers","title":"Possible variations for the selectors (conditions and counter qualifiers)","text":"<p>The main drivers behind the proposed design for the selectors (conditions and counter qualifiers), based on (i) structured condition expressions composed of fields <code>selector</code>, <code>operator</code>, and <code>value</code>, and (ii) <code>when</code> conditions and <code>counters</code> separated in two distinct fields (variation \"C\" below), are:</p> <ol> <li>consistency with the Authorino <code>AuthConfig</code> API, which also specifies <code>when</code> conditions expressed in <code>selector</code>, <code>operator</code>, and <code>value</code> fields;</li> <li>explicit user intent, without subtle distinction of meaning based on presence of optional fields.</li> </ol> <p>Nonetheless here are a few alternative variations to consider:</p> Structured condition expressions Parsed condition expressions Single field A <pre>\nselectors:\n\n  - selector: context.request.http.method\n    operator: eq\n    value: GET\n  - selector: auth.identity.username</pre> B <pre>\nselectors:\n  - context.request.http.method == \"GET\"\n  - auth.identity.username</pre> Distinct fields C <sup>\u2b50\ufe0f</sup> <pre>\nwhen:\n  - selector: context.request.http.method\n    operator: eq\n    value: GET\ncounters:\n  - auth.identity.username</pre> D <pre>\nwhen:\n  - context.request.http.method == \"GET\"\ncounters:\n  - auth.identity.username</pre> <p><sup>\u2b50\ufe0f Variation adopted for the examples and (so far) final design proposal.</sup></p>"},{"location":"architecture/rfcs/0001-rlp-v2/#prior-art","title":"Prior art","text":"<p>Most implementations currently orbiting around Gateway API (e.g. Istio, Envoy Gateway, etc) for added RL functionality seem to have been leaning more to the direct route extension pattern instead of Policy Attachment. That might be an option particularly suitable for gateway implementations (gateway providers) and for those aiming to avoid dealing with defaults and overrides.</p>"},{"location":"architecture/rfcs/0001-rlp-v2/#unresolved-questions","title":"Unresolved questions","text":"<ol> <li>In case a limit definition lists route selectors such that some can be bound to HTTPRouteRules and some cannot (see Example 6), do we bind the valid route selectors and ignore the invalid ones or the limit definition is invalid altogether and bound to no HTTPRouteRule at all? A: By allowing multiple limit definitions to target a same HTTPRouteRule, the issue here stated will become less often. For the other cases where a limit definition still fails to select an HTTPRouteRule (e.g. due to mismatching trigger matches), the limit definition is not considered invalid. Possibly the limit definitions is considered \"stale\" (or \"orphan\"), i.e., not bound to any HTTPRouteRule.</li> <li>What should we fill domain/namespace with, if no longer with the hostname? This can be useful for multi-tenancy. A: For now, the domain/namespace field of the RL configuration (Envoy and Limitador ends) will be filled with a fixed (configurable) string (e.g. \"kuadrant\"). This can change in future to better support multi-tenancy and/or other use cases where a total sharding of the limit definitions within a same instance of Kuadrant is desired.</li> <li>How do we support lists of hostnames in Limitador conditions (single counter)? Should we open an issue for a new <code>in</code> operator? A: Not needed. The hostnames must exist in the targeted object explicitly, just like any other routing rules intended to be targeted by a limit definition. By setting the explicit hostname in the targeted network object (Gateway or HTTPRoute), the also becomes a route rules available for \"hard\" trigger configuration.</li> <li>What \"soft\" condition <code>operator</code>s do we need to support (e.g. <code>eq</code>, <code>neq</code>, <code>exists</code>, <code>nexists</code>, <code>matches</code>)?</li> <li>Do we need special field to define shared counters across clusters/Limitador instances or that's to be solved at another layer (<code>Limitador</code>, <code>Kuadrant</code> CRDs, MCTC)?</li> </ol>"},{"location":"architecture/rfcs/0001-rlp-v2/#future-possibilities","title":"Future possibilities","text":"<ul> <li>Port <code>routeSelectors</code> and the semantics around it to the <code>AuthPolicy</code> API (aka \"KAP v2\").</li> <li>Defaults and overrides, either along the lines of architecture#4 or architecture#10.</li> </ul>"},{"location":"architecture/rfcs/0002-well-known-attributes/","title":"Well-known Attributes","text":"<ul> <li>Feature Name: <code>well-known-attributes</code></li> <li>Start Date: 2023-06-13</li> <li>RFC PR: Kuadrant/architecture#17</li> <li>Issue tracking: Kuadrant/architecture#53</li> </ul>"},{"location":"architecture/rfcs/0002-well-known-attributes/#summary","title":"Summary","text":"<p>Define a well-known structure for users to declare request data selectors in their RateLimitPolicies and AuthPolicies. This structure is referred to as the Kuadrant Well-known Attributes.</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#motivation","title":"Motivation","text":"<p>The well-known attributes let users write policy rules \u2013 conditions and, in general, dynamic values that refer to attributes in the data plane - in a concise and seamless way.</p> <p>Decoupled from the policy CRDs, the well-known attributes:</p> <ol> <li>define a common language for referring to values of the data plane in the Kuadrant policies;</li> <li>allow dynamically evolving the policy APIs regarding how they admit references to data plane attributes;</li> <li>encompass all common and component-specific selectors for data plane attributes;</li> <li>have a single and unified specification, although this specification may occasionally link to additional, component-specific, external docs.</li> </ol>"},{"location":"architecture/rfcs/0002-well-known-attributes/#guide-level-explanation","title":"Guide-level explanation","text":"<p>One who writes a Kuadrant policy and wants to build policy constructs such as conditions, qualifiers, variables, etc, based on dynamic values of the data plane, must refer the attributes that carry those values, using the declarative language of Kuadrant's Well-known Attributes.</p> <p>A dynamic data plane value is typically a value of an attribute of the request or an Envoy Dynamic Metadata entry. It can be a value of the outer request being handled by the API gateway or proxy that is managed by Kuadrant (\"context request\") or an attribute of the direct request to the Kuadrant component that delivers the functionality in the data plane (rate-limiting or external auth).</p> <p>A Well-known Selector is a construct of a policy API whose value contains a direct reference to a well-known attribute. The language of the well-known attributes and therefore what one would declare within a well-known selector resembles a JSON path for navigating a possibly complex JSON object.</p> <p>Example 1. Well-known selector used in a condition</p> <pre><code>apiGroup: examples.kuadrant.io\nkind: PaintPolicy\nspec:\n  rules:\n\n  - when:\n    - selector: auth.identity.group\n      operator: eq\n      value: admin\n    color: red\n</code></pre> <p>In the example, <code>auth.identity.group</code> is a well-known selector of an attribute <code>group</code>, known to be injected by the external authorization service (<code>auth</code>) to describe the group the user (<code>identity</code>) belongs to. In the data plane, whenever this value is equal to <code>admin</code>, the abstract <code>PaintPolicy</code> policy states that the traffic must be painted <code>red</code>.</p> <p>Example 2. Well-known selector used in a variable</p> <pre><code>apiGroup: examples.kuadrant.io\nkind: PaintPolicy\nspec:\n  rules:\n\n  - color: red\n    alpha:\n      dynamic: request.headers.x-color-alpha\n</code></pre> <p>In the example, <code>request.headers.x-color-alpha</code> is a selector of a well-known attribute <code>request.headers</code> that gives access to the headers of the context HTTP request. The selector retrieves the value of the <code>x-color-alpha</code> request header to dynamically fill the <code>alpha</code> property of the abstract <code>PaintPolicy</code> policy at each request.</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#reference-level-explanation","title":"Reference-level explanation","text":"<p>The Well-known Attributes are a compilation inspired by some of the Envoy attributes and Authorino's Authorization JSON and its related JSON paths.</p> <p>From the Envoy attributes, only attributes that are available before establishing connection with the upstream server qualify as a Kuadrant well-known attribute. This excludes attributes such as the response attributes and the upstream attributes.</p> <p>As for the attributes inherited from Authorino, these are either based on Envoy's <code>AttributeContext</code> type of the external auth request API or from internal types defined by Authorino to fulfill the Auth Pipeline.</p> <p>These two subsets of attributes are unified into a single set of well-known attributes. For each attribute that exists in both subsets, the name of the attribute as specified in the Envoy attributes subset prevails. Example of such is <code>request.id</code> (to refer to the ID of the request) superseding <code>context.request.http.id</code> (as the same attribute is referred in an Authorino <code>AuthConfig</code>).</p> <p></p> <p>The next sections specify the well-known attributes organized in the following groups:</p> <ul> <li>Request attributes</li> <li>Connection attributes</li> <li>Metadata and filter state attributes</li> <li>Auth attributes</li> <li>Rate-limit attributes</li> </ul>"},{"location":"architecture/rfcs/0002-well-known-attributes/#request-attributes","title":"Request attributes","text":"<p>The following attributes are related to the context HTTP request that is handled by the API gateway or proxy managed by Kuadrant.</p> <p>Attribute</p> <p>Type</p> <p>Description</p> <p>Auth</p> <p>RL</p> <p>request.id</p> <p>String</p> <p>Request ID corresponding to <code>x-request-id</code> header value</p> <p>\u2713</p> <p>\u2713</p> <p>request.time</p> <p>Timestamp</p> <p>Time of the first byte received</p> <p>\u2713</p> <p>\u2713</p> <p>request.protocol</p> <p>String</p> <p>Request protocol (\u201cHTTP/1.0\u201d, \u201cHTTP/1.1\u201d, \u201cHTTP/2\u201d, or \u201cHTTP/3\u201d)</p> <p>\u2713</p> <p>\u2713</p> <p>request.scheme</p> <p>String</p> <p>The scheme portion of the URL e.g. \u201chttp\u201d</p> <p>\u2713</p> <p>\u2713</p> <p>request.host</p> <p>String</p> <p>The host portion of the URL</p> <p>\u2713</p> <p>\u2713</p> <p>request.method</p> <p>String</p> <p>Request method e.g. \u201cGET\u201d</p> <p>\u2713</p> <p>\u2713</p> <p>request.path</p> <p>String</p> <p>The path portion of the URL</p> <p>\u2713</p> <p>\u2713</p> <p>request.url_path</p> <p>String</p> <p>The path portion of the URL without the query string</p> <p></p> <p>\u2713</p> <p>request.query</p> <p>String</p> <p>The query portion of the URL in the format of \u201cname1=value1&amp;name2=value2\u201d</p> <p>\u2713</p> <p>\u2713</p> <p>request.headers</p> <p>Map&lt;String, String&gt;</p> <p>All request headers indexed by the lower-cased header name</p> <p>\u2713</p> <p>\u2713</p> <p>request.referer</p> <p>String</p> <p>Referer request header</p> <p></p> <p>\u2713</p> <p>request.useragent</p> <p>String</p> <p>User agent request header</p> <p></p> <p>\u2713</p> <p>request.size</p> <p>Number</p> <p>The HTTP request size in bytes. If unknown, it must be -1</p> <p>\u2713</p> <p></p> <p>request.body</p> <p>String</p> <p>The HTTP request body. (Disabled by default. Requires additional proxy configuration to enabled it.)</p> <p>\u2713</p> <p></p> <p>request.raw_body</p> <p>Array&lt;Number&gt;</p> <p>The HTTP request body in bytes. This is sometimes used instead of <code>body</code> depending on the proxy configuration.</p> <p>\u2713</p> <p></p> <p>request.context_extensions</p> <p>Map&lt;String, String&gt;</p> <p>This is analogous to <code>request.headers</code>, however these contents are not sent to the upstream server. It provides an extension mechanism for sending additional information to the auth service without modifying the proto definition. It maps to the internal opaque context in the proxy filter chain. (Requires additional configuration in the proxy.)</p> <p>\u2713</p> <p></p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#connection-attributes","title":"Connection attributes","text":"<p>The following attributes are available once the downstream connection with the API gateway or proxy managed by Kuadrant is established. They apply to HTTP requests (L7) as well, but also to proxied connections limited at L3/L4.</p> <p>Attribute</p> <p>Type</p> <p>Description</p> <p>Auth</p> <p>RL</p> <p>source.address</p> <p>String</p> <p>Downstream connection remote address</p> <p>\u2713</p> <p>\u2713</p> <p>source.port</p> <p>Number</p> <p>Downstream connection remote port</p> <p>\u2713</p> <p>\u2713</p> <p>source.service</p> <p>String</p> <p>The canonical service name of the peer</p> <p>\u2713</p> <p></p> <p>source.labels</p> <p>Map&lt;String, String&gt;</p> <p>The labels associated with the peer. These could be pod labels for Kubernetes or tags for VMs. The source of the labels could be an X.509 certificate or other configuration.</p> <p>\u2713</p> <p></p> <p>source.principal</p> <p>String</p> <p>The authenticated identity of this peer. If an X.509 certificate is used to assert the identity in the proxy, this field is sourced from \u201cURI Subject Alternative Names\u201c, \u201cDNS Subject Alternate Names\u201c or \u201cSubject\u201c in that order. The format is issuer specific \u2013 e.g. SPIFFE format is <code>spiffe://trust-domain/path</code>, Google account format is <code>https://accounts.google.com/{userid}</code>.</p> <p>\u2713</p> <p></p> <p>source.certificate</p> <p>String</p> <p>The X.509 certificate used to authenticate the identify of this peer. When present, the certificate contents are encoded in URL and PEM format.</p> <p>\u2713</p> <p></p> <p>destination.address</p> <p>String</p> <p>Downstream connection local address</p> <p>\u2713</p> <p>\u2713</p> <p>destination.port</p> <p>Number</p> <p>Downstream connection local port</p> <p>\u2713</p> <p>\u2713</p> <p>destination.service</p> <p>String</p> <p>The canonical service name of the peer</p> <p>\u2713</p> <p></p> <p>destination.labels</p> <p>Map&lt;String, String&gt;</p> <p>The labels associated with the peer. These could be pod labels for Kubernetes or tags for VMs. The source of the labels could be an X.509 certificate or other configuration.</p> <p>\u2713</p> <p></p> <p>destination.principal</p> <p>String</p> <p>The authenticated identity of this peer. If an X.509 certificate is used to assert the identity in the proxy, this field is sourced from \u201cURI Subject Alternative Names\u201c, \u201cDNS Subject Alternate Names\u201c or \u201cSubject\u201c in that order. The format is issuer specific \u2013 e.g. SPIFFE format is <code>spiffe://trust-domain/path</code>, Google account format is <code>https://accounts.google.com/{userid}</code>.</p> <p>\u2713</p> <p></p> <p>destination.certificate</p> <p>String</p> <p>The X.509 certificate used to authenticate the identify of this peer. When present, the certificate contents are encoded in URL and PEM format.</p> <p>\u2713</p> <p></p> <p>connection.id</p> <p>Number</p> <p>Downstream connection ID</p> <p></p> <p>\u2713</p> <p>connection.mtls</p> <p>Boolean</p> <p>Indicates whether TLS is applied to the downstream connection and the peer ceritificate is presented</p> <p></p> <p>\u2713</p> <p>connection.requested_server_name</p> <p>String</p> <p>Requested server name in the downstream TLS connection</p> <p></p> <p>\u2713</p> <p>connection.tls_session.sni</p> <p>String</p> <p>SNI used for TLS session</p> <p>\u2713</p> <p></p> <p>connection.tls_version</p> <p>String</p> <p>TLS version of the downstream TLS connection</p> <p></p> <p>\u2713</p> <p>connection.subject_local_certificate</p> <p>String</p> <p>The subject field of the local certificate in the downstream TLS connection</p> <p></p> <p>\u2713</p> <p>connection.subject_peer_certificate</p> <p>String</p> <p>The subject field of the peer certificate in the downstream TLS connection</p> <p></p> <p>\u2713</p> <p>connection.dns_san_local_certificate</p> <p>String</p> <p>The first DNS entry in the SAN field of the local certificate in the downstream TLS connection</p> <p></p> <p>\u2713</p> <p>connection.dns_san_peer_certificate</p> <p>String</p> <p>The first DNS entry in the SAN field of the peer certificate in the downstream TLS connection</p> <p></p> <p>\u2713</p> <p>connection.uri_san_local_certificate</p> <p>String</p> <p>The first URI entry in the SAN field of the local certificate in the downstream TLS connection</p> <p></p> <p>\u2713</p> <p>connection.uri_san_peer_certificate</p> <p>String</p> <p>The first URI entry in the SAN field of the peer certificate in the downstream TLS connection</p> <p></p> <p>\u2713</p> <p>connection.sha256_peer_certificate_digest</p> String <p>SHA256 digest of the peer certificate in the downstream TLS connection if present</p> <p></p> <p>\u2713</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#metadata-and-filter-state-attributes","title":"Metadata and filter state attributes","text":"<p>The following attributes are related to the Envoy proxy filter chain. They include metadata exported by the proxy throughout the filters and information about the states of the filters themselves.</p> <p>Attribute</p> <p>Type</p> <p>Description</p> <p>Auth</p> <p>RL</p> <p>metadata</p> <p>Metadata</p> <p>Dynamic request metadata</p> <p>\u2713</p> <p>\u2713</p> <p>filter_state</p> <p>Map&lt;String, String&gt;</p> <p>Mapping from a filter state name to its serialized string value</p> <p></p> <p>\u2713</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#auth-attributes","title":"Auth attributes","text":"<p>The following attributes are exclusive of the external auth service (Authorino).</p> <p>Attribute</p> <p>Type</p> <p>Description</p> <p>Auth</p> <p>RL</p> <p>auth.identity</p> <p>Any</p> <p>Single resolved identity object, post-identity verification</p> <p>\u2713</p> <p></p> <p>auth.metadata</p> <p>Map&lt;String, Any&gt;</p> <p>External metadata fetched</p> <p>\u2713</p> <p></p> <p>auth.authorization</p> <p>Map&lt;String, Any&gt;</p> <p>Authorization results resolved by each authorization rule, access granted only</p> <p>\u2713</p> <p></p> <p>auth.response</p> <p>Map&lt;String, Any&gt;</p> <p>Response objects exported by the auth service post-access granted</p> <p>\u2713</p> <p></p> <p>auth.callbacks</p> <p>Map&lt;String, Any&gt;</p> <p>Response objects returned by the callback requests issued by the auth service</p> <p>\u2713</p> <p></p> <p>The auth service also supports modifying selected values by chaining modifiers in the path.</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#rate-limit-attributes","title":"Rate-limit attributes","text":"<p>The following attributes are exclusive of the rate-limiting service (Limitador).</p> <p>Attribute</p> <p>Type</p> <p>Description</p> <p>Auth</p> <p>RL</p> <p>ratelimit.domain</p> <p>String</p> <p>The rate limit domain. This enables the configuration to be namespaced per application (multi-tenancy).</p> <p></p> <p>\u2713</p> <p>ratelimit.hits_addend</p> <p>Number</p> <p>Specifies the number of hits a request adds to the matched limit. Fixed value: `1`. Reserved for future usage.</p> <p></p> <p>\u2713</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#drawbacks","title":"Drawbacks","text":"<p>The decoupling of the well-known attributes and the language of well-known attributes and selectors from the individual policy CRDs is what makes it somewhat flexible and common across the components (rate-limiting and auth). However, it's less structured and it introduces another syntax for users to get familiar with.</p> <p>This additional language competes with the language of the route selectors (RFC 0001), based on Gateway API's <code>HTTPRouteMatch</code> type.</p> <p>Being \"soft-coded\" in the policy specs (as opposed to a hard-coded sub-structure inside of each policy type) does not mean it's completely decoupled from implementation in the control plane and/or intermediary data plane components. Although many attributes can be supported almost as a pass-through, from being used in a selector in a policy, to a corresponding value requested by the wasm-shim to its host, that is not always the case. Some translation may be required for components not integrated via wasm-shim (e.g. Authorino), as well as for components integrated via wasm-shim (e.g. Limitador) in special cases of composite or abstraction well-known attributes (i.e. attributes not available as-is via ABI, e.g. <code>auth.identity</code> in a RLP). Either way, some validation of the values introduced by users in the selectors may be needed at some point in the control plane, thus requiring arguably a level of awaresness and coupling between the well-known selectors specification and the control plane (policy controllers) or intermediary data plane (wasm-shim) components.</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#rationale-and-alternatives","title":"Rationale and alternatives","text":"<p>As an alternative to JSON path-like selectors based on a well-known structure that induces the proposed language of well-known attributes, these same attributes could be defined as sub-types of each policy CRD. The Golang packages defining the common attributes across CRDs could be shared by the policy type definitions to reduce repetition. However, that approach would possibly involve a staggering number of new type definitions to cover all the cases for all the groups of attributes to be supported. These are constructs that not only need to be understood by the policy controllers, but also known by the user who writes a policy.</p> <p>Additionally, all attributes, including new attributes occasionally introduced by Envoy and made available to the wasm-shim via ABI, would always require translation from the user-level abstraction how it's represented in a policy, to the actual form how it's used in the wasm-shim configuration and Authorino AuthConfigs.</p> <p>Not implementing this proposal and keeping the current state of things mean little consistency between these common constructs for rules and conditions on how they are represented in each type of policy. This lack of consistency has a direct impact on the overhead faced by users to learn how to interact with Kuadrant and write different kinds of policies, as well as for the maintainers on tasks of coding for policy validation and reconciliation of data plane configurations.</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#prior-art","title":"Prior art","text":"<p>Authorino's dynamic JSON paths, related to Authorino's Authorization JSON and used in <code>when</code> conditions and inside of multiple other constructs of the AuthConfig, are an example of feature of very similar approach to the one proposed here.</p> <p>Arguably, Authorino's perceived flexibility would not have been possible with the Authorization JSON selectors. Users can write quite sophisticated policy rules (conditions, variable references, etc) by leveraging the those dynamic selectors. Because they are backed by JSON-based machinery in the code, Authorino's selectors have very little to, in some cases, none at all variation compared Open Policy Agent's Rego policy language, which is often used side by side in the same AuthConfigs.</p> <p>Authorino's Authorization JSON selectors are, in one hand, more restrict to the structure of the <code>CheckRequest</code> payload (<code>context.*</code> attributes). At the same time, they are very open in the part associated with the internal attributes built along the Auth Pipeline (i.e. <code>auth.*</code> attributes). That makes Authorino's Authorization JSON selectors more limited, compared to the Envoy attributes made available to the wasm-shim via ABI, but also harder to validate. In some cases, such as of deep references to inside objects fetched from external sources of metadata, resolved OPA objects, JWT claims, etc, it is impossible to validate for correct references.</p> <p>Another experience learned from Authorino's Authorization JSON selectors is that they depend substantially on the so-called \"modifiers\". Many use cases involving parsing and breaking down attributes that are originally available in a more complex form would not be possible without the modifiers. Examples of such cases are: extracting portions of the path and/or query string parameters (e.g. collection and resource identifiers), applying translations on HTTP verbs into corresponding operations, base64-decoding values from the context HTTP request, amongst several others.</p>"},{"location":"architecture/rfcs/0002-well-known-attributes/#unresolved-questions","title":"Unresolved questions","text":"<ol> <li> <p>How to deal with the differences regarding the availability and data types of the attributes across clients/hosts?</p> </li> <li> <p>Can we make more attributes that are currently available to only one of the components common to both?</p> </li> <li> <p>Will we need some kind of global support for modifiers (functions) in the well-known selectors or those can continue to be an Authorino-only feature?</p> </li> <li> <p>Does Authorino, which is more strict regarding the data structure that induces the selectors, need to implement this specification or could/should it keep its current selectors and a translation be performed by the AuthPolicy controller?</p> </li> </ol>"},{"location":"architecture/rfcs/0002-well-known-attributes/#future-possibilities","title":"Future possibilities","text":"<ol> <li>Extend with more well-known attributes that abstract common patterns and/or for rather opinioned use cases. Examples:</li> <li><code>auth.*</code> attributes supported in the rate limit service</li> <li><code>request.authenticated</code></li> <li><code>request.operation.(read|write)</code></li> <li><code>request.param.my-param</code></li> <li> <p><code>connection.secure</code></p> </li> <li> <p>Other Envoy attributes</p> </li> </ol> Wasm attributes <p>Attribute</p> <p>Type</p> <p>Description</p> <p>Auth</p> <p>RL</p> <p>wasm.plugin_name</p> <p>String</p> <p>Plugin name</p> <p></p> <p>\u2713</p> <p>wasm.plugin_root_id</p> <p>String</p> <p>Plugin root ID</p> <p></p> <p>\u2713</p> <p>wasm.plugin_vm_id</p> <p>String</p> <p>Plugin VM ID</p> <p></p> <p>\u2713</p> <p>wasm.node</p> <p>Node</p> <p>Local node description</p> <p></p> <p>\u2713</p> <p>wasm.cluster_name</p> <p>String</p> <p>Upstream cluster name</p> <p></p> <p>\u2713</p> <p>wasm.cluster_metadata</p> <p>Metadata</p> <p>Upstream cluster metadata</p> <p></p> <p>\u2713</p> <p>wasm.listener_direction</p> <p>Number</p> <p>Enumeration value of the listener traffic direction</p> <p></p> <p>\u2713</p> <p>wasm.listener_metadata</p> <p>Metadata</p> <p>Listener metadata</p> <p></p> <p>\u2713</p> <p>wasm.route_name</p> <p>String</p> <p>Route name</p> <p></p> <p>\u2713</p> <p>wasm.route_metadata</p> <p>Metadata</p> <p>Route metadata</p> <p></p> <p>\u2713</p> <p>wasm.upstream_host_metadata</p> <p>Metadata</p> <p>Upstream host metadata</p> <p></p> <p>\u2713</p> Proxy configuration attributes <p>Attribute</p> <p>Type</p> <p>Description</p> <p>Auth</p> <p>RL</p> <p>xds.cluster_name</p> <p>String</p> <p>Upstream cluster name</p> <p></p> <p>\u2713</p> <p>xds.cluster_metadata</p> <p>Metadata</p> <p>Upstream cluster metadata</p> <p></p> <p>\u2713</p> <p>xds.route_name</p> <p>String</p> <p>Route name</p> <p></p> <p>\u2713</p> <p>xds.route_metadata</p> <p>Metadata</p> <p>Route metadata</p> <p></p> <p>\u2713</p> <p>xds.upstream_host_metadata</p> <p>Metadata</p> <p>Upstream host metadata</p> <p></p> <p>\u2713</p> <p>xds.filter_chain_name</p> <p>String</p> <p>Listener filter chain name</p> <p></p> <p>\u2713</p> <ol> <li>Add some support for value modifiers (functions), along the lines of Authorino's JSON path modifiers and/or Envoy attributes' path expressions.</li> </ol>"},{"location":"architecture/rfcs/0003-dns-policy/","title":"RFC Template","text":"<ul> <li>Feature Name: DNSPolicy</li> <li>Start Date: 2023-07-01</li> <li>RFC PR: Kuadrant/architecture#20</li> <li>Issue tracking: Kuadrant/multicluster-gateway-controller#219</li> <li>Labels: DNS, Load Balancing, Multi-Cluster</li> </ul>"},{"location":"architecture/rfcs/0003-dns-policy/#summary","title":"Summary","text":"<p>Provide a policy for configuring how DNS should be handed for a given gateway. Provide a mechanism for enabling DNS based load balancing.</p>"},{"location":"architecture/rfcs/0003-dns-policy/#motivation","title":"Motivation","text":"<p>Gateway admins, need a way to define the DNS policy for a multi-cluster gateway in order to control how much and which traffic reaches these gateways.  Ideally we would allow them to express a strategy that they want to use without needing to get into the details of each provider and needing to create and maintain dns record structure and individual records for all the different gateways that may be within their infrastructure.</p>"},{"location":"architecture/rfcs/0003-dns-policy/#guide-level-explanation","title":"Guide-level explanation","text":"<p>Allow definition of a DNSPolicy that configures load balancing to decide how traffic should be distributed across multiple gateway instances from the central control plane.</p>"},{"location":"architecture/rfcs/0003-dns-policy/#terms","title":"Terms","text":"<ul> <li>managed listener: This is a listener with a host backed by a DNS zone managed by the multi-cluster gateway controller</li> <li>hub cluster: control plane cluster that managed 1 or more spokes</li> <li>spoke cluster: a cluster managed by the hub control plane cluster. This is where gateway are instantiated</li> </ul> <p>Provide a control plane DNSPolicy API that uses the idea of direct policy attachment from gateway API that allows a load balancing strategy to be applied to the DNS records structure for any managed listeners being served by the data plane instances of this gateway.  The DNSPolicy also covers health checks that inform the DNS response but that is not covered in this document.</p> <p>Below is a draft API for what we anticipate the DNSPolicy to look like</p> <pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nspec:\n  targetRef: # defaults to gateway gvk and current namespace\n    name: gateway-name\n  health:\n   ...\n  loadBalancing:\n    weighted:\n     defaultWeight: 10\n     custom: #optional\n\n     - value: AWS  #optional with both GEO and weighted. With GEO the custom weight is applied to gateways within a Geographic region\n       weight: 10\n     - value: GCP\n       weight: 20\n    GEO: #optional\n      defaultGeo: IE # required with GEO. Chooses a default DNS response when no particular response is defined for a request from an unknown GEO.\n</code></pre>"},{"location":"architecture/rfcs/0003-dns-policy/#available-load-balancing-strategies","title":"Available Load Balancing Strategies","text":"<p>GEO and Weighted load balancing are well understood strategies and this API effectively allow a complex requirement to be expressed relatively simply and executed by the gateway controller in the chosen DNS provider. Our default policy will execute a \"Round Robin\" weighted strategy which reflects the current default behaviour.</p> <p>With the above API we can provide weighted and GEO and weighted within a GEO. A weighted strategy with a minimum of a default weight is always required and the simplest type of policy. The multi-cluster gateway controller will set up a default policy when a gateway is discovered (shown below). This policy can be replaced or modified by the user.  A weighted strategy can be complimented with a GEO strategy IE they can be used together in order to provide a GEO and weighted (within a GEO) load balancing. By defining a GEO section, you are indicating that you want to use a GEO based strategy (how this works is covered below).</p> <pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nname: default-policy\nspec:\n  targetRef: # defaults to gateway gvk and current namespace\n    name: gateway-name\n  loadBalancing:\n    weighted: # required\n     defaultWeight: 10  #required, all records created get this weight\n  health:\n   ...   \n</code></pre> <p>In order to provide GEO based DNS and allow customisation of the weighting, we need some additional information to be provided by the gateway / cluster admin about where this gateway has been placed. For example if they want to use GEO based DNS as a strategy, we need to know what GEO identifier(s) to use for each record we create and a default GEO to use as a catch-all. Also, if the desired load balancing approach is to provide custom weighting and no longer simply use Round Robin, we will need a way to identify which records to apply that custom weighting to based on the clusters the gateway is placed on.</p> <p>To solve this we will allow two new attributes to be added to the <code>ManagedCluster</code> resource as labels:</p> <pre><code>   kuadrant.io/lb-attribute-geo-code: \"IE\"\n   kuadrant.io/lb-attribute-custom-weight: \"GCP\"\n</code></pre> <p>These two labels allow setting values in the DNSPolicy that will be reflected into DNS records for gateways placed on that cluster depending on the strategies used. (see the first DNSPolicy definition above to see how these values are used) or take a look at the examples at the bottom.</p> <p>example : <pre><code>apiVersion: cluster.open-cluster-management.io/v1\nkind: ManagedCluster\nmetadata:\n labels:\n   kuadrant.io/lb-attribute-geo-code: \"IE\"\n   kuadrant.io/lb-attribute-custom-weight: \"GCP\"\nspec:    \n</code></pre></p> <p>The attributes provide the key and value we need in order to understand how to define records for a given LB address based on the DNSPolicy targeting the gateway.</p> <p>The <code>kuadrant.io/lb-attribute-geo-code</code> attribute value is provider specific, using an invalid code will result in an error status condition in the DNSrecord resource. </p>"},{"location":"architecture/rfcs/0003-dns-policy/#dns-record-structure","title":"DNS Record Structure","text":"<p>This is an advanced topic and so is broken out into its own proposal doc DNS Record Structure</p>"},{"location":"architecture/rfcs/0003-dns-policy/#custom-weighting","title":"Custom Weighting","text":"<p>Custom weighting will use the associated <code>custom-weight</code> attribute set on the <code>ManagedCluster</code> to decide which records should get a specific weight. The value of this attribute is up to the end user.</p> <p>example:</p> <pre><code>apiVersion: cluster.open-cluster-management.io/v1\nkind: ManagedCluster\nmetadata:\n labels:\n   kuadrant.io/lb-attribute-custom-weight: \"GCP\"\n</code></pre> <p>The above is then used in the DNSPolicy to set custom weights for the records associated with the target gateway.</p> <pre><code>    - value: GCP\n      weight: 20\n</code></pre> <p>So any gateway targeted by a DNSPolicy with the above definition that is placed on a <code>ManagedCluster</code> with the <code>kuadrant.io/lb-attribute-custom-weight</code> set with a value of GCP will get an A record with a weight of 20 </p>"},{"location":"architecture/rfcs/0003-dns-policy/#status","title":"Status","text":"<p>DNSPolicy should have a ready condition that reflect that the DNSRecords have been created and configured as expected. In the case that there is an invalid policy, the status message should reflect this and indicate to the user that the old DNS has been preserved.</p> <p>We will also want to add a status condition to the gateway status indicating it is effected by this policy. Gateway API recommends the following status condition </p> <pre><code>- type: gateway.networking.k8s.io/PolicyAffected\n  status: True \n  message: \"DNSPolicy has been applied\"\n  reason: PolicyApplied\n  ...\n</code></pre> <p>https://github.com/kubernetes-sigs/gateway-api/pull/2128/files#diff-afe84021d0647e83f420f99f5d18b392abe5ec82d68f03156c7534de9f19a30aR888</p>"},{"location":"architecture/rfcs/0003-dns-policy/#example-policies","title":"Example Policies","text":""},{"location":"architecture/rfcs/0003-dns-policy/#round-robin-the-default-policy","title":"Round Robin (the default policy)","text":"<pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nname: RoundRobinPolicy\nspec:\n  targetRef: # defaults to gateway gvk and current namespace\n    name: gateway-name\n  loadBalancing:\n    weighted:\n     defaultWeight: 10\n</code></pre>"},{"location":"architecture/rfcs/0003-dns-policy/#geo-round-robin","title":"GEO (Round Robin)","text":"<pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nname: GEODNS\nspec:\n  targetRef: # defaults to gateway gvk and current namespace\n    name: gateway-name\n  loadBalancing:\n    weighted:\n     defaultWeight: 10\n    GEO:\n     defaultGeo: IE\n</code></pre>"},{"location":"architecture/rfcs/0003-dns-policy/#custom","title":"Custom","text":"<pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nname: SendMoreToAzure\nspec:\n  targetRef: # defaults to gateway gvk and current namespace\n    name: gateway-name\n  loadBalancing:\n    weighted:\n     defaultWeight: 10\n     custom:\n\n     - attribute: cloud\n       value: Azure #any record associated with a gateway on a cluster without this value gets the default\n       weight: 30\n</code></pre>"},{"location":"architecture/rfcs/0003-dns-policy/#geo-with-custom-weights","title":"GEO with Custom Weights","text":"<pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nname: GEODNSAndSendMoreToAzure\nspec:\n  targetRef: # defaults to gateway gvk and current namespace\n    name: gateway-name\n  loadBalancing:\n    weighted:\n     defaultWeight: 10\n     custom:\n\n     - attribute: cloud\n       value: Azure\n       weight: 30\n    GEO:\n      defaultGeo: IE\n</code></pre>"},{"location":"architecture/rfcs/0003-dns-policy/#reference-level-explanation","title":"Reference-level explanation","text":"<ul> <li>Add a DNSPolicy CRD that conforms to policy attachment spec</li> <li>Add a new DNSPolicy controller to MCG</li> <li>DNS logic and record management should all migrate out of the gateway controller into this new DNSPolicy controller as it is the responsibility and domain of the DNSPolicy controller to manage DNS</li> <li>remove the Hosts interface as we want do not want other controllers using this to bring DNS Logic into other areas of the code.</li> </ul>"},{"location":"architecture/rfcs/0003-dns-policy/#drawbacks","title":"Drawbacks","text":"<p>You cannot have a different load balancing strategy for each listener within a gateway. So in the following gateway definition</p> <pre><code>spec:\n    gatewayClassName: kuadrant-multi-cluster-gateway-instance-per-cluster\n    listeners:\n\n    - allowedRoutes:\n        namespaces:\n          from: All\n      hostname: myapp.hcpapps.net\n      name: api\n      port: 443\n      protocol: HTTPS\n    - allowedRoutes:\n        namespaces:\n          from: All\n      hostname: other.hcpapps.net\n      name: api\n      port: 443\n      protocol: HTTPS      \n</code></pre> <p>The DNS policy targeting this gateway will apply to both myapp.hcpapps.net and other.hcpapps.net</p> <p>However, there is still significant value even with this limitation. This limitation is something we will likely revisit in the future</p>"},{"location":"architecture/rfcs/0003-dns-policy/#background-docs","title":"Background Docs","text":"<p>DNS Provider Support</p> <p>Direct Policy Attachment </p>"},{"location":"architecture/rfcs/0003-dns-policy/#rationale-and-alternatives","title":"Rationale and alternatives","text":"<p>An alternative is to configure all of this yourself manually in a dns provider. This can be a highly complex dns configuration that it would be easy to get wrong.</p>"},{"location":"architecture/rfcs/0004-policy-status/","title":"Policy Status","text":"<ul> <li>Feature Name: <code>policy_status_states</code></li> <li>Start Date: 2023-02-03</li> <li>RFC PR: Kuadrant/architecture#0009</li> <li>Issue tracking: Kuadrant/architecture#0038</li> </ul>"},{"location":"architecture/rfcs/0004-policy-status/#summary","title":"Summary","text":"<p>This RFC proposes a new design for any Kuadrant Policy (<code>RateLimitPolicy</code>, <code>AuthPolicy</code>, etc..) status definition and transitions.</p>"},{"location":"architecture/rfcs/0004-policy-status/#motivation","title":"Motivation","text":"<p>At the time being, the <code>RateLimitPolicy</code> and <code>AuthPolicy</code> status doesn't clearly and truthfully communicate the actual state of reconciliation and healthiness with its operator managed services, i.e., the Rate Limit service (\"Limitador\") and the Auth service (\"Authorino\"), referred to as \"Kuadrant services\".</p> <p>As a consequence, misleading information is shared causing unexpected errors and flawed assumptions.</p> <p>The following are some issues reported in relation to the aforementioned problems:</p> <ul> <li>https://github.com/Kuadrant/kuadrant-operator/issues/87</li> <li>https://github.com/Kuadrant/kuadrant-operator/issues/96</li> <li>https://github.com/Kuadrant/kuadrant-operator/issues/140</li> </ul>"},{"location":"architecture/rfcs/0004-policy-status/#guide-level-explanation","title":"Guide-level explanation","text":"<p>This design for setting the status of the Kuadrant policy CRs is divided in 2 stages, where each stage could be applied/developed in order and would reflect valuable and accurate information with different degrees of acuity.</p> <p>The Policy CRD Status in the following diagrams are simplified as states, which in the Reference-level explanation will be translated to the actual Status Conditions.</p>"},{"location":"architecture/rfcs/0004-policy-status/#stage-1","title":"Stage 1","text":"<p>State of the policy CR defined by: application, validation, and reconciliation of it</p> <p>The main signalization at Stage 1 is about whether a policy CR has been <code>Accepted</code> or not.</p> <p>States rationale:</p> <ul> <li><code>Accepted</code>: This state is reached after the <code>Validation</code> and <code>Reconciliation</code> event has being successfully passed.</li> <li><code>Invalid</code>: When the <code>Validation</code> process encounters an error, this state will be set.</li> <li><code>TargetNotFound</code>: This state will be set when the <code>Reconciliation</code> process encounters an error.</li> <li><code>Conflicted</code>: This state will be set when the <code>Reconciliation</code> process encounters an error.</li> </ul> <p></p> <p>Notes:</p> <ul> <li>States from the Stage 2 could be implemented as well, but only relying on Validation and Reconciliation events.</li> </ul>"},{"location":"architecture/rfcs/0004-policy-status/#stage-2","title":"Stage 2","text":"<p>Final state of the policy CR defined by: health check with the Kuadrant services (post-reconciliation)</p> <p>The <code>Enforced</code> type is introduced to capture the difference between a policy been reconciled and it's been enforced at the service.</p> <p>States rationale:</p> <ul> <li><code>Enforced</code>: After a successful response of the <code>Service Probe</code>, this states communicates the policy is finally enforced.</li> <li><code>PartiallyEnforced</code>: This state will be set when the <code>Reconciliation</code> event encounters an overlap with other policies.</li> <li><code>Overridden</code>: This state will be set when the <code>Reconciliation</code> event invalidates the policy because another one takes precedence.</li> </ul> <p></p>"},{"location":"architecture/rfcs/0004-policy-status/#reference-level-explanation","title":"Reference-level explanation","text":"<p>In general, the new states and conditions align with GEP-713.</p> <p>Besides the proposed <code>Accepted</code> PolicyType, the <code>Enforced</code> PolicyType would be added to reflect the final state of the policy, which means that the policy is showing the synced actual state of the Kuadrant services.</p> <p>The missing <code>Failed</code> PolicyType would be implicitly represented by the <code>TargetNotFound</code> and <code>Invalid</code> PolicyTypeReason.</p>"},{"location":"architecture/rfcs/0004-policy-status/#conditions","title":"Conditions","text":"<p>All conditions are top-level.</p> Type Status Reason Message Accepted True \"Accepted\" \"KuadrantPolicy has been accepted\" False \"Conflicted\" \"KuadrantPolicy is conflicted by [policy-ns/policy-name], ...\" False \"Invalid\" \"KuadrantPolicy is invalid\" False \"TargetNotFound\" \"KuadrantPolicy target [resource-name] was not found\" Enforced True \"Enforced\" \"KuadrantPolicy has been successfully enforced\" False \"Unknown\" \"KuadrantPolicy has encountered some issues\" False \"Overridden\" \"KuadrantPolicy is overridden by [policy-ns/policy-name], ...\" <p>Messages corresponding falsey statuses are required and should reflect the error that encountered.</p> <p>It's possible to have the Failed state as a top level condition too. In this case, it might be useful to consider a third \"Unknown\" status.</p>"},{"location":"architecture/rfcs/0004-policy-status/#policy-ancestor-status","title":"Policy ancestor status","text":"<p>The Status stanza of the policy CRs must implement Gateway API's PolicyAncestorStatus struct. This will provide broader consistency and improved discoverability of effective policies.</p>"},{"location":"architecture/rfcs/0004-policy-status/#implementation-detailsrequisites","title":"Implementation details/requisites","text":"<p>Full implementation of Stage 2 states assumes reporting mechanisms in place, provided by the Kuadrant services, that allow tracing the state of the configurations applied on the services, back to the original policies, to infer the final state of the policy CRs (i.e. whether truly <code>Enforced</code> or not.)</p> <p>Without such, Stage 2 could be only partially achieved, by relying only on Reconciliation events.</p>"},{"location":"architecture/rfcs/0004-policy-status/#drawbacks","title":"Drawbacks","text":"<ul> <li>This proposal will require to change the code controllers assert the status</li> <li>Since the Status is part of the \"API\", won't be backwards compatible</li> <li>Documentation updating</li> <li>The implementation of the affected policies will create a fan-out problem, that might lead to updating many policy objects and apiserver load.</li> </ul>"},{"location":"architecture/rfcs/0004-policy-status/#rationale-and-alternatives","title":"Rationale and alternatives","text":"<p>Another option was considered (previously referred to as \"Option 1\"). While valid, this alternative would not align with GEP-713, neither it would be as flexible as the final design proposed.</p> Details of the discarded alternative     This alternative design would come in 3 stages:    **Stage 1 : State of the policy CR defined by: application and validation of it**    This first stage is a simple version where the operator only relies on itself, not checking the healthiness with the   Kuadrant services, but just validating the Spec.    ![](0004-policy-status-assets/policy_status_1.png)    States rationale:    * `Created`: The initial state. It announces that the policy has successfully being created, the operator acknowledges it.   * `Applied`: This state is reached after the `Validation` event has being successfully passed.   * `Failed`: This one would be set when the `Validation` process encounters an error. This could be either condition's failed/error   state or a top-level condition.   * `Updated`: From `Failed` or `Applied`, it could be triggered a `Spec Change` event that would move it to this state.    **Stage 2: Further reconciliation check provides a new state**    This following one, besides checking what the former stage does, it also adds the states reflecting the reconciliation   process of any needed Kubernets object, Kuadrant Services custom resources and any other 3rd party CR required.   An example would be in the case of the RLP, it would create/update the `ConfigMap` holding the `Limitador` config file.    ![](0004-policy-status-assets/policy_status_2.png)    States rationale:    * `Applied`: The __Applied__ state would not be final, and would be preceding a `Reconciliation` event.   * `Reconciled`: It communicates that the policy has successfully being reconciled, and any K8s object or required CR has been updated.   * `Failed`: This one would be reached when either of `Validation` and `Reconcilation` processes have encounter any errors.    **Stage 3: Final state of the policy CR defined by: health check with the Kuadrant services (post-reconciliation)**    The final stage would bring a greater degree of accuracy, thanks for a final process that would check the healthiness and   configuration version the Kuadrant services currently enforces.    ![](0004-policy-status-assets/policy_status_3.png)    States rationale:    * `Reconciled`: This state would precede the \"Health check\" process  graphed as `Service Probe` event.   * `Enforced`: After a successful response of the `Service Probe`, this states communicates the policy is finally enforced.   This is the final top-level condition.   * `Failed`: Now this state could also be set after encountering errors in the `Service Probe` check.        The stages before mentioned would follow the [Kubernetes guidelines](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#typical-status-properties)   regarding the Status object definition.    **Conditions**    All conditions are top-level.    | Type        | Status | Reason                      | Message                                                                     |   |-------------|--------|-----------------------------|-----------------------------------------------------------------------------|   | Progressing | True   | \"PolicyCreated\"             | \"KuadrantPolicy created\"                                                    |   |             | True   | \"PolicyUpdated\"             | \"KuadrantPolicy has been updated\"                                           |   |             | True   | \"PolicyApplied\"             | \"KuadrantPolicy has been successfully applied                               |   |             | True   | \"PolicyReconciled\"          | \"KuadrantPolicy has been successfully reconciled\"                           |   |             | False  | \"PolicyEnforced\"            | \"KuadrantPolicy has been successfully enforced\"                             |   |             | False  | \"PolicyError\"               | \"KuadrantPolicy has encountered an error\"                                   |   | Enforced    | True   | \"PolicyEnforced\"            | \"KuadrantPolicy has been successfully enforced\"                             |   |             | False  | \"PolicyPartiallyEnforced\"   | \"KuadrantPolicy has encountered some issues and has been partially applied\" |   |             | False  | \"PolicyOverridden\"          | \"KuadrantPolicy is overridden by [policy-ns/policy-name]\"                   |   | Failed      | True   | \"PolicyValidationError\"     | \"KuadrantPolicy has failed to validate\"                                     |   |             | True   | \"PolicyServiceError\"        | \"KuadrantPolicy has encountered has failed to enforce\"                      |   |             | False  | \"PolicyEnforced\"            | \"KuadrantPolicy has been successfully enforced\"                             |"},{"location":"architecture/rfcs/0004-policy-status/#prior-art","title":"Prior art","text":"<ul> <li>Kubernetes API Conventions</li> <li>Current KuadrantPolicy Status work</li> </ul>"},{"location":"architecture/rfcs/0004-policy-status/#unresolved-questions","title":"Unresolved questions","text":"<ul> <li>Is it worthy to implement a state machine or state machine design pattern to achieve this set of conditions?</li> </ul>"},{"location":"architecture/rfcs/0004-policy-status/#future-possibilities","title":"Future possibilities","text":"<p>The implementation of this proposal could be part of kuadrant/gateway-api-machinery.</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/","title":"Single Cluster DNSPolicy","text":"<ul> <li>Feature Name: <code>single-cluster-dnspolicy</code></li> <li>Start Date: 2023-10-09</li> <li>RFC PR: Kuadrant/architecture#30</li> <li>Issue tracking: </li> <li>Kuadrant/architecture#31</li> <li>Kuadrant/architecture#67</li> </ul>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#summary","title":"Summary","text":"<p>Proposal for changes to the <code>DNSPolicy</code> API to allow it to provide a simple routing strategy as an option in a single cluster context. This will remove, but not negate, the complex DNS structure we use in a multi-cluster environment and in doing so allow use of popular dns integrators such as external-dns .</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#motivation","title":"Motivation","text":"<p>The <code>DNSPolicy</code> API (v1alpha1), was implemented as part of our multi cluster gateway offering using OCM and as such the design and implementation were influenced heavily by how we want multi cluster dns to work.</p> <ul> <li>Decouple the API entirely from OCM and multi cluster specific concepts.</li> <li>Simplify the DNS record structure created for a gateway listeners host for single cluster use.</li> <li>Improve the likelihood of adoption by creating an integration path for other kubernetes dns controllers such as external-dns.</li> </ul>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#guide-level-explanation","title":"Guide-level explanation","text":"<p>The DNSPolicy can be used to target a Gateway in a single cluster context and will create dns records for each listener host in an appropriately configured external dns provider. In this context the advanced <code>loadbalancing</code> configuration is unnecessary, and the resulting DNSRecord can be created mapping individual listener hosts to a single DNS A or CNAME record by using the <code>simple</code> routing strategy in the DNSPolicy.</p> <p>Example 1. DNSPolicy using <code>simple</code> routing strategy</p> <pre><code>apiVersion: kuadrant.io/v1alpha2\nkind: DNSPolicy\nmetadata:\n  name: prod-web\n  namespace: my-gateways\nspec:\n  providerRef:\n    name: my-route53-credentials\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  routingStrategy: simple\n</code></pre> <pre><code>apiVersion: gateway.networking.k8s.io/v1beta1\nkind: Gateway\nmetadata:\n  name: prod-web\n  namespace: my-gateways\nspec:\n  gatewayClassName: istio\n  listeners:\n\n    - allowedRoutes:\n        namespaces:\n          from: All\n      name: api\n      hostname: \"myapp.mn.hcpapps.net\"\n      port: 80\n      protocol: HTTP\nstatus:\n  addresses:\n    - type: IPAddress\n      value: 172.31.200.0\n</code></pre> <p>In the example the <code>api</code> listener has a hostname <code>myapp.mn.hcpapps.net</code> that matches a hosted zone being managed by the provider referenced <code>my-route53-credentials</code> in the DNSPolicy.  As the <code>simple</code> routing strategy is set in the DNSPolicy a DNSRecord resource with the following contents will be created:</p> <pre><code>apiVersion: kuadrant.io/v1alpha2\nkind: DNSRecord\nmetadata:\n  name: prod-web-api\n  namespace: my-gateways\nspec:\n  providerRef:\n    name: my-route53-credentials\n  endpoints:\n\n    - dnsName: myapp.mn.hcpapps.net\n      recordTTL: 60\n      recordType: A\n      targets:\n        - 172.31.200.0\n</code></pre> <p>The <code>providerRef</code> is included in the DNSRecord to allow the dns record controller to load the appropriate provider configuration during reconciliation and create the DNS records in the dns provider service e.g. route 53.</p> <p>Example 2. DNSPolicy using <code>simple</code> routing strategy on multi cluster gateway</p> <pre><code>apiVersion: kuadrant.io/v1alpha2\nkind: DNSPolicy\nmetadata:\n  name: prod-web\n  namespace: my-gateways\nspec:\n  providerRef:\n    name: my-route53-credentials\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  routingStrategy: simple\n</code></pre> <pre><code>apiVersion: gateway.networking.k8s.io/v1beta1\nkind: Gateway\nmetadata:\n  name: prod-web\n  namespace: my-gateways\nspec:\n  gatewayClassName: kuadrant-multi-cluster-gateway-instance-per-cluster\n  listeners:\n\n    - allowedRoutes:\n        namespaces:\n          from: All\n      name: api\n      hostname: \"myapp.mn.hcpapps.net\"\n      port: 80\n      protocol: HTTP\nstatus:\n  addresses:\n    - type: kuadrant.io/MultiClusterIPAddress\n      value: 172.31.200.0\n    - type: kuadrant.io/MultiClusterIPAddress\n      value: 172.31.201.0\n</code></pre> <p>Similar to example 1, except here the Gateway is a multi cluster gateway that has had its status updated by the <code>Gateway</code> controller to include <code>kuadrant.io/MultiClusterIPAddress</code> type addresses. As the <code>simple</code> routing strategy is set in the DNSPolicy a DNSRecord resource with the following contents will be created:</p> <pre><code>apiVersion: kuadrant.io/v1alpha2\nkind: DNSRecord\nmetadata:\n  name: prod-web-api\n  namespace: my-gateways\nspec:\n  providerRef:\n    name: my-route53-credentials\n  endpoints:\n\n    - dnsName: myapp.mn.hcpapps.net\n      recordTTL: 60\n      recordType: A\n      targets:\n        - 172.31.200.0\n        - 172.31.201.0\n</code></pre>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#reference-level-explanation","title":"Reference-level explanation","text":""},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#api-updates","title":"API Updates","text":"<p>DNSPolicy:</p> <ul> <li>new providerRef field <code>spec.providerRef</code></li> <li>new routingStrategy field <code>spec.routingStrategy</code></li> <li>new api version <code>v1alpha2</code></li> </ul> <p>DNSRecord:</p> <ul> <li><code>spec.managedZone</code> replaced with <code>spec.providerRef</code></li> <li>new zoneID field <code>spec.zoneID</code> </li> <li>new api version <code>v1alpha2</code></li> </ul> <p>ManagedZone:</p> <ul> <li>ManagedZone API wil be removed and no longer supported as part of MGC/Kuadrant.</li> </ul>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#dnspolicyspecproviderref","title":"DNSPolicy.spec.providerRef","text":"<p>The <code>providerRef</code> field is mandatory and contains a reference to a secret containing provider credentials.</p> <pre><code>- `spec.providerRef.name` - name of the provider resource.\n</code></pre> <p>A <code>DNSPolicy</code> referencing a providerRef secret will expect that secret to exist in the same namespace. The expected contents of the secrets data is comparable to the <code>dnsProviderSecretRef</code> used by ManageZones.</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: aws-credentials\ntype: kuadrant.io/aws\ndata:\n  AWS_ACCESS_KEY_ID: \"foo\"\n  AWS_SECRET_ACCESS_KEY: \"bar\"\n  CONFIG:\n    zoneIDFilter:\n\n      - Z04114632NOABXYWH93QUl\n</code></pre> <p>The <code>CONFIG</code> section of the secrets data will be added to allow provider specific configuration to be stored alongside the providers credentials and can be used during the instantiation of the provider client, and during any provider operations. The above for example would use the <code>zoneIDFilter</code> value to limit what hosted zones this provider is allowed to update.</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#dnspolicyspecroutingstrategysimpleweightedgeo","title":"DNSPolicy.spec.routingStrategy[simple|weightedGeo]","text":"<p>The <code>routingStrategy</code> field is mandatory and dictates what kind of dns record structure the policy will create. Two routing strategy options are allowed <code>simple</code> or <code>weightedGeo</code>.</p> <p>A reconciliation of DNSPolicy processes the target gateway and creates a DNSRecord per listener that is supported by the currently configured provider(hostname matches the hosted zones accessible with the credentials and config). The routing strategy used will determine the contents of the DNSRecord resources Endpoints array.</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#simple","title":"simple","text":"<pre><code>apiVersion: kuadrant.io/v1alpha2\nkind: DNSRecord\nspec:\n  providerRef:\n    name: my-route53-credentials\n  endpoints:\n\n    - dnsName: myapp.mn.hcpapps.net\n      recordTTL: 60\n      recordType: A\n      targets:\n        - 172.31.200.0\n</code></pre> <p>Simple creates a single endpoint for an A record with multiple targets. Although intended for use in a single cluster context a simple routing strategy can still be used in a multi-cluster environment (OCM hub). In this scenario each clusters address will be added to the targets array to create a multi answer section in the dns response.</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#weightedgeo","title":"weightedGeo","text":"<pre><code>apiVersion: kuadrant.io/v1alpha2\nkind: DNSRecord\nspec:\n  providerRef:\n    name: my-route53-credentials\n  endpoints:\n\n    - dnsName: myapp.mn.hcpapps.net\n      recordTTL: 300\n      recordType: CNAME\n      targets:\n        - lb-4ej5le.myapp.mn.hcpapps.net\n    - dnsName: lb-4ej5le.myapp.mn.hcpapps.net\n      providerSpecific:\n        - name: geo-code\n          value: '*'\n      recordTTL: 300\n      recordType: CNAME\n      setIdentifier: default\n      targets:\n        - default.lb-4ej5le.myapp.mn.hcpapps.net\n    - dnsName: default.lb-4ej5le.myapp.mn.hcpapps.net\n      providerSpecific:\n        - name: weight\n          value: \"120\"\n      recordTTL: 60\n      recordType: CNAME\n      setIdentifier: lrnse3.lb-4ej5le.myapp.mn.hcpapps.net\n      targets:\n        - lrnse3.lb-4ej5le.myapp.mn.hcpapps.net\n    - dnsName: lrnse3.lb-4ej5le.myapp.mn.hcpapps.net\n      recordTTL: 60\n      recordType: A\n      targets:\n        - 172.31.200.0\n</code></pre> <p>WeightedGeo creates a more complex set of endpoints which use a combination of weighted and geo routing strategies. Although intended for use in a multi-cluster environment  (OCM hub) it will still be possible to use it in a single cluster context. In this scenario the record structure described above would be created for the single cluster.</p> <p>This is the current default for DNSPolicy in a multi-cluster environment (OCM hub) and more details about it can be found in the original DNSPolicy rfc.</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#dnsrecordspecproviderref","title":"DNSRecord.spec.providerRef","text":"<p>More details of <code>providerRef</code> found in DNSPolicy.spec.providerRef</p> <p>The DNSRecord API is updated to remove the <code>managedZone</code> reference in favour of directly referencing the <code>providerRef</code> credentials instead. The DNSRecord reconciliation will be unchanged except for loading the provider client from <code>providerRef</code> credentials.</p> <p>The DNSPolicy reconciliation will be updated to remove the requirement for a ManagedZone resource to be created before a DNSPolicy can create dns records for it, instead it will be replaced in favour of just listing available zones directly in the currently configured dns provider. If no matching zone is found, no DNSRecord will be created.</p> <p>There is a potential for a DNSRecord to be created successfully, but then a provider updated to remove access. In this case it is the responsibility of the DNSPolicy controller to report appropriate status back to the policy and target resource about the failure to process the record. More details on how status will be reported can be found in rfc-0004</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#dnsrecordspeczoneid","title":"DNSRecord.spec.zoneID","text":"<p>The <code>zoneID</code> field is mandatory and contains the provider specific id of the hosted zone that this record should be published into. </p> <p>The DNSRecord reconciliation will use this zone when creating/updating or deleting endpoints for this record set. </p> <p>The <code>zoneID</code> should not change after being selected during initial creation and as such will be marked as immutable.</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#prior-art","title":"Prior art","text":"<p>ExternalDNS</p> <ul> <li>Uses annotations on the target Gateway as opposed to a proper API.</li> <li>Requires access to the HTTP route resources.</li> <li>Supports only a single provider per external dns instance.</li> </ul>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#unresolved-questions","title":"Unresolved questions","text":"<p>When a provider is configured using a kind not supported by the <code>DNSPolicy</code> controller e.g. <code>ExternalDNS</code> we will be relying on an external controller to correctly update the status of any DNSRecord resources created by our policy. This may have a negative impact on our ability to correctly report status back to the target resource.</p> <p>When using a weightedGeo routing strategy in a single cluster context it is not expected that this will offer multi cluster capabilities without the use of OCM. Currently, it is expected that if you want to create a recordset that contains the addresses of multiple clusters you must use an OCM hub.</p>"},{"location":"architecture/rfcs/0005-single-cluster-dnspolicy/#future-possibilities","title":"Future possibilities","text":"<p>The ability to support other kubernetes dns controllers such as ExternalDNS would potentially allow us to contribute to some of these projects in the area of polices for dns management of Gateway resources in kubernetes.</p>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/","title":"Configuration of Kuadrant Sub Components","text":"<ul> <li>Feature Name: <code>sub-components-config</code></li> <li>Start Date: 2023-09-11</li> <li>RFC PR: Kuadrant/architecture#25</li> <li>Issue tracking: Kuadrant/kuadrant-operator#163</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#summary","title":"Summary","text":"<p>Enable configuration of sub components of Kuadrant from a centralized location, namely the Kuadrant CR. </p>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#motivation","title":"Motivation","text":"<p>The initial request comes from MGC to configure Redis for Limitador by the following issue #163. MGC's current work around is to update the Limitador CR after the deployment with the configuration setting for Redis Instance. This change would allow for the configuration of sub components before the Kuadrant is deployed. </p> <p>This reduces the number of CRs that users of Kuadrant are required to modify to get the installation they require. The sub components CRs (Authorino, Limitador) never have to be modified by a Kuadrant user (and should never be modified by a Kuadrant User).</p>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#guide-level-explanation","title":"Guide-level explanation","text":"<p>As the Kuadrant operator would be responsible for reconciling these configurations into the requested components, restrictions and limitations can be placed on the components which maybe allowed in a standalone installation. An example in this space is the disk storage for Limitador which is a new feature and the Kuadrant installation may not want to support it till there is a proven track record for the feature.</p> <p>For existing Kuadrant Users this may be a possible breaking changes if those users manually configure the Kuadrant sub components via their CRs. A guide can be created to help migrate the users configurations to the Kuadrant CR. This guide can be part of the release notes and/or possibly released before the release of Kuadrant.</p> <p>The deployment configuration for each component can be placed in the Kuadrant CR. These configurations are then reconciled into the CRs for each component.  Only the options below are exposed in the Kuadrant CR.  All fields in the spec are optional.</p> <pre><code>apiVersion: kuadrant.io/v1beta1\nkind: Kuadrant\nmetadata:\n    name: kuadrant-sample\nspec:\n    limitador:\n        afffinity: ...\n        listener: ...\n        pdb: ...\n        replicas: ...\n        resourceRequirements: ...\n        storage: ...\n    authorino:\n        evaluatorCacheSize: ...\n        healthz: ...\n        listener: ...\n        logLevel: ...\n        metrics: ...\n        oidcServer: ...\n        replicas: ...\n        tracing: ...\n        volumes: ...\nstatus:\n    ...\n</code></pre> <p>The Kuadrant operator will watch for changes in the Authorino and Limitador CRs, reconciling back any changes that a user may do to these configurations. How ever Kuadrant operator will not reconcile fields that are given above.  An example of this is the <code>image</code> field on the Authorino CR. This field allows a user to set the image that Authorino is deployed with. The feature is meant for dev and testing purposes.  If a user wishes to use a different image, they can. Kuadrant assumes they know what they are doing but requires the user to set the change on the component directly.</p> <p>Only the sub component operator will be responsible for actioning the configurations pasted from the Kuadrant CR to the sub components CR. This ensure no extra changes will be required in the sub operators to meet the needs of Kuadrant.</p> <p>Status errors related to the configuration of the sub components should be reported back to the Kuadrant CR. The errors messages in Kuadrant state what components are currently having issue and which resource to review for more details.</p>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#reference-level-explanation","title":"Reference-level explanation","text":"<p>All the fields in the Authorino and Limitador CRs that are configurable in the Kuadrant CR are optional and have sound defaults. Kuadrant needs to remain installable with out having to set any spec in the Kuadrant CR.</p> <p>The Kuadrant operator should only reconcile the spec that is given.  This would mean if the user states the number of replicas to be used in one of the components only the replica field for that component should be reconciled. As the other fields would be blank at this stage, blank fields would not be reconciled to the component CR. By this behaviour a few things are being achieved. Component controllers define the defaults to be used in the components. Optional fields in the component CRs never get set with blank values. Blank values in the component CR could override the defaults of the components causing unexpected behaviour. Existing Kuadrant users may already have custom fields set in the component CRs. By only reconciling the fields set in the kuadrant CR this allows time for a user to migrate their custom configuration from the component CR to the Kuadrant CR.</p>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#fields-to-reconcile","title":"Fields to reconcile","text":"<p>Fields being reconcile can be classified into different groups. These classifications are based around the tasks a user is achieve.</p> <ul> <li>Kubernetes native, setting that affect how Kubernetes handles the resource.</li> <li>Observability, configuration settings that allow insights into how the applications are operation. This can be Kubernetes native or external tooling.</li> <li>Application Settings, setting targeting the application and how it connects to external services.</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#authorino-spec","title":"Authorino Spec","text":""},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#kubernetes-native","title":"Kubernetes native","text":"<ul> <li>replicas</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#observability","title":"Observability","text":"<ul> <li>healthz</li> <li>logLevel</li> <li>metrics</li> <li>tracing</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#application-settings","title":"Application Settings","text":"<ul> <li>evaluatorCacheSize</li> <li>listener</li> <li>oidcServer</li> <li>volumes</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#limitador-spec","title":"Limitador Spec","text":""},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#kubernetes-native_1","title":"Kubernetes native","text":"<ul> <li>afffinity</li> <li>pdb</li> <li>replicas</li> <li>resourceRequirements</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#application-settings_1","title":"Application Settings","text":"<ul> <li>listener</li> <li>storage</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#fields-not-reconciled","title":"Fields not reconciled","text":"<p>There are a number of fields in both Authorino and Limitador that are not reconciled. Reasons for doing this are:</p> <p>It is better to start with a sub set of features and expand to include more at a later date. Removing feature support is far harder than adding it.</p> <p>There are four classifications the unreconciled fields fail into.</p> <ul> <li>Deprecated, fields that are deprecated and/or have plans to be removed from the spec in the future.</li> <li>Unsupported, the features would have hard coded or expected defaults in the Kuadrant operator.  Work would be required to all the custom configurations options.</li> <li>Dev/Testing focused, features that should only be used during development &amp; testing and not recommended for production. The defaults would for the fields are the production recommendations.</li> <li>Reconciled by others, this mostly affects Limitador as the deployment configuration and runtime configuration are in the same CR. In the case of Kuadrant the runtime configuration for Limitador is added via the RateLimitingPolicy CR.</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#authorino-spec_1","title":"Authorino Spec","text":""},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#unsupported","title":"Unsupported","text":"<ul> <li>clusterWide</li> <li>authConfigLabelSelectors</li> <li>secretLabelSelectors</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#devtesting-focused","title":"Dev/Testing focused","text":"<ul> <li>image</li> <li>imagePullPolicy</li> <li>logMode</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#limitador-spec_1","title":"Limitador Spec","text":""},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#unsupported_1","title":"Unsupported","text":"<ul> <li>RateLimitHeaders</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#reconciled-by-others","title":"Reconciled by others","text":"<ul> <li>Limits</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#deprecated","title":"Deprecated","text":"<ul> <li>version</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#drawbacks","title":"Drawbacks","text":"<p>As the Kuadrant CR spec will be a sub set of the features that can be configured in the sub components spec, extra maintenances will be required to ensure specs are in sync.</p> <p>New features of a component will not be accessible in Kuadrant initially. This is both a pro and a con.</p> <p>Documentation becomes harder, as the sub component should be documenting their own features but in Kuadrant the user does not configure the feature in sub component. This has the risk of confusing new users.</p>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#rationale-and-alternatives","title":"Rationale and alternatives","text":"<ul> <li>Why is this design the best in the space of possible designs?</li> <li>What other designs have been considered and what is the rationale for not choosing them?</li> <li>What is the impact of not doing this?</li> </ul> <p>One alternative that was being looked at was allowing the user to bring their own Limitador instances by stating which Limitador CR Kuadrant should use.  A major point of issue with this approach was knowing what limits the user had configured and what limits Kuadrant configured.  Sharing global counters is a valid reason to want to share Limitador instances.  How ever it this case Limitador would not be using one replica and therefore would have a back-end storage configured. It is the back-end storage that needs to be shared across instances. This can be done with adding the configuration in the Kuadrant CR.</p>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#prior-art","title":"Prior art","text":"<p>Discuss prior art, both the good and the bad, in relation to this proposal. A few examples of what this can include are:</p> <ul> <li>Does another project have a similar feature?</li> <li>What can be learned from it? What's good? What's less optimal?</li> <li>Papers: Are there any published papers or great posts that discuss this? If you have some relevant papers to refer to, this can serve as a more detailed theoretical background.</li> </ul> <p>This section is intended to encourage you as an author to think about the lessons from other tentatives - successful or not, provide readers of your RFC with a fuller picture.</p> <p>Note that while precedent set by other projects is some motivation, it does not on its own motivate an RFC.</p>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#unresolved-questions","title":"Unresolved questions","text":"<ul> <li>What parts of the design do you expect to resolve through the RFC process before this gets merged?</li> <li>What parts of the design do you expect to resolve through the implementation of this feature before stabilization?</li> <li>What related issues do you consider out of scope for this RFC that could be addressed in the future independently of the solution that comes out of this RFC?</li> </ul> <ul> <li>Is there a need to add validation on the configuration?</li> <li>If a valid configuration is add to the Kuadrant CR and this configuration is pass to the sub components CR but there is a error trying to setting up the configuration. How is this error reported back to the user?  An example of this is configuring Redis as the back-end in Limitador, this requires stating the name and namespace of a configmap. The Limitador CR will have an error if the configmap does not exist and as the user only configures the Kuadrant CR this error may go unnoticed. This is only one example but there is a need for good error reporting back to the user, where they would expect to see the error.</li> </ul>"},{"location":"architecture/rfcs/0006-kuadrant_sub_components_configurations/#future-possibilities","title":"Future possibilities","text":"<p>Think about what the natural extension and evolution of your proposal would be and how it would affect the platform and project as a whole. Try to use this section as a tool to further consider all possible interactions with the project and its components in your proposal. Also consider how this all fits into the roadmap for the project and of the relevant sub-team.</p> <p>This is also a good place to \"dump ideas\", if they are out of scope for the RFC you are writing but otherwise related.</p> <p>Note that having something written down in the future-possibilities section is not a reason to accept the current or a future RFC; such notes should be in the section on motivation or rationale in this or subsequent RFCs. The section merely provides additional information.</p> <p>The implementation stated here allows the user to state spec fields in the component CRs or the Kuadrant CR (Kuadrant CR overrides the component CRs). A future possibility would be to warn the user if they add configuration to the components CRs that would get overridden if the same spec fields are configured in the Kuadrant CR.</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/","title":"RFC - Policy Sync","text":"<ul> <li>Feature Name: <code>policy_sync_v1</code></li> <li>Start Date: 2023-10-10</li> <li>RFC PR: Kuadrant/architecture#0000</li> <li>Issue tracking: https://github.com/Kuadrant/architecture/issues/26</li> </ul>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#summary","title":"Summary","text":"<p>The ability for the Multicluster Gateway Controller to sync policies defined in the hub cluster downstream to the spoke clusters, therefore allowing all policies to be defined in the same place. These policies will be reconciled by the downstream policy controller(s).</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#nomenclature","title":"Nomenclature","text":"<ul> <li> <p>Policy: When refering to a Policy, this document is refering to a Gateway API   policy as defined in the Policy Attachment Model. The Multicluster Gateway Controller   relies on OCM as a Multicluster solution, which defines its own unrelated   set of Policies and Policy Framework. Unless explicitely mentioned, this document   refers to Policies as Gateway API Policies.</p> </li> <li> <p>Policy overriding: The concept of policy overriding is mentioned in this document. It refers to the proposed ability of the downstream Gateway implementation to prioritise downstream Policies against synced Policies in case of conflicts.</p> </li> </ul>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#motivation","title":"Motivation","text":"<p>Currently, Kuadrant's support for the Policy Attachment Model can be divided in two categories:</p> <ul> <li>Policies targeting the Multicluster Gateway, defined in the hub cluster and   reconciled by the Multicluster Gateway Controller</li> <li>Policies targeting the downstream Gateway, defined in the spoke clusters and   reconciled by the downstream Gateway controllers.</li> </ul> <p>In a realistic multicluster scenario where multiple spoke clusters are present, the management of these policies can become tedious and error-prone, as policies have to be defined in the hub cluster, as well as replicated in the multiple spoke clusters.</p> <p>As Kuadrant users:</p> <ul> <li>Gateway-admin has a set of homogeneous clusters and needs to apply per cluster rate limits across the entire set.</li> <li>Platform-admin with a set of clusters with rate limits applied needs to change rate limit for one particular cluster. </li> </ul>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#guide-level-explanation","title":"Guide-level explanation","text":"<p>The policy sync feature will allow a gateway-admin to configure, via GatewayClass parameters, a set of Policy GVRs to be synced by the Multicluster Gateway Controller.</p> <p>The <code>policiesToSync</code> field in the parameters defines those GVRs. For example, in order to configure the controller to sync AuthPolicies:</p> <pre><code>\"policiesToSync\": [\n  {\n    \"group\": \"kuadrant.io\",\n    \"version\": \"v1beta1\",\n    \"resource\": \"authpolicies\" \n  }\n]\n</code></pre> <p>The support for resources that the controller can sync is limited by the following:</p> <ul> <li>The controller ServiceAccount must have permission to watch, list, and get the   resource to be synced</li> <li>The resource must implement the Policy schema:<ul> <li>Have a <code>.spec.targetRef</code> field</li> </ul> </li> </ul> <p>When a Policy is configured to be synced in a GatewayClass, the Multicluster Gateway Controller starts watching events on the resources, and propagates changes by placing the policy in the spoke clusters, with the following mutations:</p> <ul> <li>The <code>TargetRef</code> of the policy is changed to reference the downstream Gateway</li> <li>The <code>kuadrant.io/policy-synced</code> annotation is set</li> </ul> <p>The upstream policy is annotated with a reference to the name and namespace of the downstream policies:   <pre><code>annotations:\n  \"kuadrant.io/policies-synced\": \"[{\\\"cluster\\\": \\\"...\\\", \\\"name\\\": \\\"...\\\", \\\"namespace\\\": \\\"...\\\"}]\"\n</code></pre></p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#reference-level-explanation","title":"Reference-level explanation","text":""},{"location":"architecture/rfcs/0007-policy-sync-v1/#process-overview","title":"Process overview","text":""},{"location":"architecture/rfcs/0007-policy-sync-v1/#dynamic-policy-watches","title":"Dynamic Policy watches","text":"<p>The Multicluster Gateway Controller reconciles parameters referenced by the GatewayClass of a Gateway. A new field is added to the parameters that allows the configuration of a set of GVRs of Policies to be synced.</p> <p>The GatewayClass reconciler validates that:</p> <ul> <li>The GVRs reference existing resource definitions</li> <li>The GVRs reference resources that implement the Policy schema.</li> </ul> <p>Validation failures are reported as part of the status of the GatewayClass</p> <p>The Gateway reconciler sets up dynamic watches to react to events on the configured Policies, calling the PolicySyncer component with the updated Policy as well as the associated Gateway.</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#policysyncer-component","title":"PolicySyncer component","text":"<p>The PolicySyncer component is in charge of reconciling Policy watch events to apply the necessary changes and place the Policies in the spoke clusters.</p> <p>This component is injected in the event source and called when a change is made to a hub Policy that has been configured to be synced.</p> <p>The PolicySyncer implementation uses OCM ManifestWorks to place the policies in the spoke clusters. Through the ManifestWorks, OCM allows to:</p> <ul> <li>Place the Policy in each spoke cluster</li> <li>Report the desired status back to the hub using JSON feedback rules</li> </ul>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#policy-hierarchy","title":"Policy Hierarchy","text":"<p>In order to avoid conflict with Policies created directly in the spoke clusters, a hierarchy must be defined to prioritise those Policies.</p> <p>The controller will set the <code>kuadrant.io/policy-synced</code> annotation on the policy when placing it in the spoke cluster.</p> <p>The Kuadrant operator will be aware of the presence of this annotation, and, in case of conflicts, override Policies that contain this annotation. When a policy is overriden due to conflicts, the <code>Enforced</code> status will be set to <code>False</code>, with the reason being <code>Overriden</code> and a human readable message explaining the reason why the policy was overriden. See Policy Status RFC</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#drawbacks","title":"Drawbacks","text":""},{"location":"architecture/rfcs/0007-policy-sync-v1/#third-party-policy-support","title":"Third party Policy support","text":"<p>In order for a Policy to be supported for syncing, the MGC must have permissions to watch/list/get the resource, and the implementation of the downstream Gateway controller must be aware of the <code>policy-synced</code> annotation.</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#rationale-and-alternatives","title":"Rationale and alternatives","text":""},{"location":"architecture/rfcs/0007-policy-sync-v1/#alternatives","title":"Alternatives","text":"<p>Different technology stacks are available to sync resources across clusters. However, adoption of these technologies for the purpose of the goal this RFC intends to achieve, implies adding another dependency to the current stack, with the cost of added complexity and maintainance effort.</p> <p>The MGC currently uses OCM to place Gateways across clusters. Relying on OCM for the purpose of placing Policies is the most straightforward alternative from a design and implementation point of view.</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#consequences-of-not-implementing","title":"Consequences of not implementing","text":"<p>Gateway-admins will have no centralized system for handling spoke-level policies targeting a gateway created there from the hub.</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#ocms-policy-framework-will-not-be-used-to-complete-this-objective","title":"OCMs Policy Framework will not be used to complete this objective:","text":"<p>OCMs Policy Framework is a system designed to make assertions about the state of a spoke, and potentially take actions based on that state, as such it is not a suitable replacement for manifestworks in the case of syncing resources to a spoke.</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#potential-migration-from-manifestworks-to-manifestworkreplicasets","title":"Potential migration from ManifestWorks to ManifestWorkReplicaSets","text":"<p>ManifestWorkPeplicaSets may be a future improvement that the MGC could support to simplify the placement of related resources, but beyond the scope of this RFC.</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#prior-art","title":"Prior art","text":"<p>No applicable prior art.</p>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#unresolved-questions","title":"Unresolved questions","text":""},{"location":"architecture/rfcs/0007-policy-sync-v1/#status-reporting","title":"Status reporting","text":"<p>While the controller can assume common status fields among the Policies that it syncs, there might be a scenario where certain policies use custom status fields that are not handled by the controller. In order to support this, two alternatives are identified:</p> <ol> <li> <p>Configurable rules.</p> <p>An extra field is added in the GatewayClass params that configures the policies to sync, to specify custom fields that the controller must propagate back from the spokes to the hub.</p> </li> <li> <p>Hard-coded support.</p> <p>The PolicySync component can identify the Policy type and select which extra status fields are propagated </p> </li> </ol>"},{"location":"architecture/rfcs/0007-policy-sync-v1/#future-possibilities","title":"Future possibilities","text":"<p>If OCMs Policy Framework is updated to enable syncing of resources status back to the hub, it could be an opportunity to refactor the MGC to use this framework in place of the current approach of creating ManifestWorks directly.</p> <p>This system could mutate over time to dynamically sync more CRDs than policies to spoke clusters.</p>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/","title":"Kuadrant Release Process","text":"<ul> <li>Feature Name: <code>kuadrant-release-process</code></li> <li>Start Date: 2024-01-11</li> <li>RFC PR: Kuadrant/architecture#46</li> <li>Issue tracking: Kuadrant/architecture#59</li> </ul>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#summary","title":"Summary","text":"<p>Kuadrant is a set of components whose artifacts are built and delivered independently. This RFC aims to define every aspect of the event of releasing a new version of the whole, in terms of versioning, cadence, communication, channels, handover to other teams, etc.</p>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#motivation","title":"Motivation","text":"<p>At the time being, there's no clear process nor guidelines to follow when releasing a new version of Kuadrant, which leads to confusion and lack of transparency. We are currently relying on internal communication and certain people in charge of the release process, which is not ideal.</p>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#guide-level-explanation","title":"Guide-level explanation","text":"<p>First, we need to define what releasing Kuadrant means, in a clear and transparent way that communicates to the community what's happening and what to expect. The Kuadrant suite is composed of several components, each of them with its own set of artifacts and versioning scheme. Defining the release process of the whole suite is a complex task, and it's not only about the technical details of releasing the components, but also about the communication and transparency with the community, the definition of the frequency of the releases, and when it's ready to be handover to other teams like QA. This section aims to provide guidelines for the different aspects of the release process.</p>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#components-and-versioning","title":"Components and versioning","text":"<p>The set of components that are part of the Kuadrant suite are the following:</p> <ul> <li>Authorino: Kubernetes-native authorization service for tailor-made Zero Trust API security.</li> <li>Authorino Operator: A Kubernetes Operator to manage Authorino instances.</li> <li>Limitador: A generic rate-limiter written in Rust.</li> <li>Limitador Operator: A Kubernetes Operator to manage Limitador deployments.</li> <li>Wasm Shim: A Proxy-Wasm module written in Rust, acting as a shim between Envoy and Limitador. connectivity and global load balancing.</li> <li>DNS Operator: A Kubernetes Operator to manage DNS in single and multi-cluster environments.</li> <li>Kuadrant Operator: The Operator to install and manage the lifecycle   of the Kuadrant components deployments. Example alerts and dashboards are also included as optional.</li> <li>kuadrantctl: A CLI tool for managing Kuadrant configurations and resources.</li> </ul> <p>Each of them needs to be versioned independently, and the versioning scheme should follow Semantic Versioning. At the time of cutting a release for any of them, it's important to keep in mind what section of the version to bump, given a version number MAJOR.MINOR.PATCH, increment the:</p> <ul> <li>MAJOR version when you make incompatible API changes</li> <li>MINOR version when you add functionality in a backward compatible manner</li> <li>PATCH version when you make backward compatible bug fixes</li> </ul> <p>Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.</p> <p>A more detailed explanation of the versioning scheme can be found in the Semantic Versioning website.</p> <p>By releasing a new version of Kuadrant, we mean releasing the set of components with their corresponding semantic versioning, some of them maybe freshly released, or others still using versioning from the previous one, and being the version of the Kuadrant Operator the one that defines the version of the whole suite.</p> <pre><code>Kuadrant Suite vx.y.z = Kuadrant Operator vx.y.z +  Authorino Operator va.b.c + Limitador Operator vd.e.f + DNS Operator vg.h.i + MGC Controller vj.k.l + Wasm Shim vm.n.o\n</code></pre> <p>The technical details of how to release each component are out of the scope of this RFC and could be found in the Kuadrant components CI/CD RFC.</p>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#qa-sanity-check","title":"QA Sanity Check","text":"<p>Probably the most important and currently missing step in the release process is the green flagging from the Quality Assurance (QA) team. The QA team is responsible for testing the different components of the Kuadrant suite, and they need to be aware of the new version of the suite that is going to be released, what are the changes that are included, bug fixes and new features in order they can plan their testing processes accordingly. This check is not meant to be a fully fledged assessment from the QA team when it's handover to them, it's aimed to not take more than 1-2 days, and ideally expected to be fully automated. This step will happen once the release candidate has no PRs pending to be merged, and it has been tested by the Engineering team. The QA team should work closely to the engineering throughout the process, both teams aiming for zero handover time and continuous delivery mindset, so immediate testing can be triggered on release candidates once handed over. This process should happen without the need of formal communication between the teams or any overhead in general, but by keeping constant synergy between quality and product engineering instead.</p> <p>There is an ideal time to hand over to the QA team for testing, especially since we are using GitHub for orchestration, we could briefly define it in the following steps:</p> <ol> <li>Complete Development Work: The engineering team completes their work included in the milestone.</li> <li>Create Release Candidate: The engineering team creates Release Candidate builds and manifests for all components required for the release</li> <li>Flagging/Testing: The QA team do the actual assertion/testing of the release candidate, checking for any obvious bugs or issues. Then QA reports all the bugs as GitHub issues and communicates testing status back publicly on Slack and/or email.</li> <li>Iterate: Based on the feedback from the QA team, the Engineering team makes any necessary adjustments and repeats the process until the release candidate is deemed ready for production.</li> <li>Publish Release: Once QA communicates that the testing has been successfully finished, the engineering team will publish the release both on Github and in the corresponding registries, updates documentation for the new release, and communicates it to all channels specified in Communication section.</li> </ol>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#cadence","title":"Cadence","text":"<p>Once the project is stable enough, and its adoption increases, the community will be expecting a certain degree of commitment from the maintainers, and that includes a regular release cadence. The frequency of the releases of the different components could vary depending on the particular component needs. However, the Kuadrant Operator it's been discussed in the past that it should be released every 3-4 weeks initially, including the latest released version of every component in the suite. There's another RFC that focuses on the actual frequency of each component, one could refer to the Kuadrant Release Cadence RFC.</p> <p>There are a few reasons for this:</p> <ul> <li>Delivering Unparalleled Value to Users: Regular releases can provide users with regular updates and improvements.   These updates can include new features and essential bug fixes, thus enhancing the overall value delivered to the users.</li> <li>Resource Optimization: By releasing software at regular intervals, teams can align their activities with   available resources and environments, ensuring optimal utilization. This leads to increased efficiency in the deployment   process and reduces the risk of resource wastage.</li> <li>Risk Management: Regular releases can help identify and fix issues early, reducing the risk of major failures that could   affect users.</li> <li>Feedback Cycle: Regular releases allow for quicker feedback cycles. This means that any issues or improvements   identified by users can be addressed promptly, leading to a more refined product over time.</li> <li>Synchronization: Regular releases can help synchronize work across different teams or departments, creating a more   reliable, dependable solution development and delivery process.</li> <li>Reduced Complexity: Managing a smaller number of releases can reduce complexity. For example, having many different   releases out in the field can lead to confusion and management overhead.</li> </ul> <p>By committing to a release cadence, software projects can benefit from improved efficiency, risk management, faster feedback cycles, synchronization, and reduced complexity.</p>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#repositories-and-hubs","title":"Repositories and Hubs","text":"<p>Every component in Kuadrant has its own repository, and the source code is hosted in GitHub, mentioned in the previous section. However, the images built and manifests generated are hosted in different registries, depending on the component. The following table shows the different registries used by each component:</p> Component Artifacts Registry / Hub Authorino authorino images Quay.io Authorino Operator authorino-operator images Quay.io authorino-operator-bundle images Quay.io authorino-operator-catalog images Quay.io authorino-operator manifests OperatorHub.io Limitador limitador server images Quay.io limitador crate Crates.io Limitador Operator limitador-operator images Quay.io limitador-operator-bundle images Quay.io limitador-operator-catalog images Quay.io limitador-operator manifests OperatorHub.io Wasm Shim wasm-shim images Quay.io DNS Operator dns-operator images Quay.io dns-operator-bundle images Quay.io dns-operator-catalog images Quay.io Kuadrant Operator kuadrant-operator images Quay.io kuadrant-operator-bundle images Quay.io kuadrant-operator-catalog images Quay.io kuadrant-operator manifests OperatorHub.io kuadrant-operator source (includes example dashboards and alerts) Github Releases kuadrantctl kuadrantctl CLI Github Releases"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#documentation","title":"Documentation","text":"<p>It's important to  note that keeping the documentation up to date is a responsibility of the component maintainers, and it needs to be done before releasing a new version of the component. The importance of keeping a clear and up-to-date documentation is crucial for the success of the project.</p> <p>The documentation for the Kuadrant suite is compiled and available on the Kuadrant website. One can find the source of the documentation within each component repository, in the <code>docs</code> directory. However, making this information available on the website is a manual process, and should be done by the maintainers of the project. The process of updating the documentation is simple and consists of the following steps:</p> <ol> <li>Update the documentation in the corresponding component repository.</li> <li>Follow the instruction in https://github.com/Kuadrant/docs.kuadrant.io/ to update the Docs pointers to the tag or branch of the component repository that contains the updated documentation.</li> <li>Once the changes are merged to main, the workflow that updates the website will be triggered, and the documentation will be updated.</li> <li>If for some reason it's needed to trigger the workflow manually, one can do it from the GitHub Actions tab in the docs.kuadrant.io (<code>Actions &gt; ci &gt; Run Workflow</code>).</li> </ol>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#communication","title":"Communication","text":"<p>Another important aspect of releasing a new version of the Kuadrant suite is the communication with the community and other teams within the organization. A few examples of the communication channels that need to be updated are:</p> <ul> <li>Changelog generation</li> <li>Release notes</li> <li>Github Release publication</li> <li>Slack channel in Kubernetes workspace</li> <li>Blog post, if applicable</li> <li>Social media, if applicable</li> </ul>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#rationale-and-alternatives","title":"Rationale and alternatives","text":"<p>The alternative to the proposal is to keep the current process, which is not ideal and leads to confusion and lack of transparency.</p>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#prior-art","title":"Prior art","text":"<p>There's been an organically grown process for releasing new versions of the Kuadrant suite, which is not documented and it's been changing over time. However, there are some documentation for some of the components, worth mentioning:</p> <ul> <li>Authorino release process</li> <li>Authorino Operator release process</li> <li>Limitador release process</li> <li>DNS Operator release process</li> </ul>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#unresolved-questions","title":"Unresolved questions","text":"<ul> <li>What would be Kuadrant support policy?</li> <li>How many version are we going to back-port security and bug fixes to?</li> <li>What other teams need to be involved in the release process?</li> </ul>"},{"location":"architecture/rfcs/0008-kuadrant-release-process/#future-possibilities","title":"Future possibilities","text":"<p>Once the release process is accepted and battle-tested, we could aim to automate the process as much as possible.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/","title":"Defaults &amp; Overrides","text":"<ul> <li>Feature Name: <code>defaults-and-overrides</code></li> <li>Start Date: 2024-02-15</li> <li>RFC PR: Kuadrant/architecture#58</li> <li>Issue tracking: Kuadrant/kuadrant-operator#431</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#summary","title":"Summary","text":"<p>This is a proposal for extending the Kuadrant Policy APIs to fully support use cases of Defaults &amp; Overrides (D/O) for Inherited Policies, including the base use cases of full default and full override, and more specific nuances that involve merging individual policy rules (as defaults or overrides), declaring constraints and unsetting defaults.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#motivation","title":"Motivation","text":"<p>As of Kuadrant Operator v0.6.0, Kuadrant policy resources that have hierarchical effect across the tree of network objects (Gateway, HTTPRoute), or what is known as Inherited Policies, provide only limited support for setting defaults and no support for overrides at all.</p> <p>The above is notably the case of the AuthPolicy and the RateLimitPolicy v1beta2 APIs, shipped with the aforementioned version of Kuadrant. These kinds of policies can be attached to Gateways or to HTTPRoutes, with cascading effects through the hierarchy that result in one effective policy per gateway-route combination. This effective policy is either the policy attached to the Gateway or, if present, the one attached to the HTTRoute, thus conforming with a strict case of implicit defaults set at the level of the gateway.</p> <p>Enhancing the Kuadrant Inherited Policy CRDs, so the corresponding policy instances can declare <code>defaults</code> and <code>overrides</code> stanzas, is imperative:</p> <ol> <li>to provide full support for D/O along the lines proposed by GEP-713 (to be superseded by GEP-2649<sup>1</sup>) of the Kubernetes Gateway API special group (base use cases);</li> <li>to extend D/O support to other derivative cases, learnt to be just as important for platform engineers and app developers who require more granular policy interaction on top of the base cases;</li> <li>to support more sophisticated hierarchies with other kinds of network objects and/or multiples policies targetting at the same level of the hierarchy (possibly, in the future.)</li> </ol>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#guide-level-explanation","title":"Guide-level explanation","text":""},{"location":"architecture/rfcs/0009-defaults-and-overrides/#conceptualization-and-user-story","title":"Conceptualization and User story","text":"<p>The base use cases for Defaults &amp; Overrides (D/O) are:</p> <ul> <li>Defaults (D): policies declared lower in the hierarchy supersede ones set (as \"defaults\") at a higher level, or \"more specific beats less specific\"</li> <li>Overrides (O): policies declared higher in the hierarchy (as \"overrides\") supersede ones set at the lower levels, or \"less specific beats more specific\"</li> </ul> <p>The base cases are expanded with the following additional derivative cases and concepts:</p> <ul> <li>Merged defaults (DR): \"higher\" default policy rules that are merged into more specific \"lower\" policies (as opposed to an atomic less specific set of rules that is activated only when another more specific one is absent)</li> <li>Merged overrides (OR): \"higher\" override policy rules that are merged into more specific \"lower\" policies (as opposed to an atomic less specific set of rules that is activated fully replacing another more specific one that is present)</li> <li>Constraints (C): specialization of an override that, rather than declaring concrete values, specify higher level constraints (e.g., min value, max value, enums) for lower level values, with the semantics of \"clipping\" lower level values so they are enforced, in an override fashion, to be the boundaries dictated by the constraints; typically employed for constraining numeric values and regular patterns (e.g. limited sets)</li> <li>Unsetting (U): specialization that completes a merge default use case by allowing lower level policies to disable (\"unset\") individual defaults set a higher level (as opposed to superseding those defaults with actual, more specific, policy rules with proper meaning)</li> </ul> <p>Together, these concepts relate to solve the following user stories:</p> User story Group Unique ID As a Platform Engineer, when configuring a Gateway, I want to set a default policy for all routes linked to my Gateway, that can be fully replaced with more specific ones(*). D gateway-default-policy As a Platform Engineer, when configuring a Gateway, I want to set default policy rules (parts of a policy) for all routes linked to my Gateway, that can be individually replaced and/or expanded by more specific rules(*). DR gateway-default-policy-rule As a Platform Engineer, when defining a policy that configures a Gateway, I want to set constraints (e.g. minimum/maximum value, enumerated options, etc) for more specific policy rules that are declared(*) with the purpose of replacing the defaults I set for the routes linked to my Gateway. C policy-constraints As a Platform Engineer, when configuring a Gateway, I want to set a policy for all routes linked to my Gateway, that cannot be replaced nor expanded by more specific ones(*). O gateway-override-policy As a Platform Engineer, when configuring a Gateway, I want to set policy rules (parts of a policy) for all routes linked to my Gateway, that cannot be individually replaced by more specific ones(*), but only expanded with additional more specific rules(*). OR gateway-override-policy-rule As an Application Developer, when managing an application, I want to set a policy for my application, that fully replaces any default policy that may exist for the application at the level of the Gateway, without having to know about the existence of the default policy. D route-replace-policy As an Application Developer, when managing an application, I want to expand a default set of policy rules set for my application at the level of the gateway, without having to refer to those existing rules by name. D/O route-add-policy-rule As an Application Developer, when managing an application, I want to unset an individual default rule set for my application at the level of the gateway. U route-unset-policy-rule <p><sup>(*) declared in the past or in the future, by myself or any other authorized user.</sup></p> <p>The interactive nature of setting policies at levels in the hierarchy and by different personas, make that the following additional user stories arise. These are stories here grouped under the Observability (Ob) aspect of D/O, but referred to as well in relation to the \"Discoverability Problem\" described by Gateway API.</p> User story Group Unique ID As one who has read access to Kuadrant policies, I want to view the effective policy enforced at the traffic routed to an application, considering all active defaults and overrides at different policies(*). Ob view-effective-policy As a Platform Engineer, I want to view all default policy rules that may have been replaced by more specific ones(*). Ob view-policy-rule-status As a Policy Manager, I want to view all gateways and/or routes whose traffic is subject to enforcement of a particular policy rule referred by name. Ob view-policy-rule-reach <p><sup>(*) declared in the past or in the future, by myself or any other authorized user.</sup></p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#writing-do-enabled-kuadrant-policies","title":"Writing D/O-enabled Kuadrant Policies","text":"<p>Writing a Kuadrant policy enabled for Defaults &amp; Overrides (D/O), to be attached to a network object, involves declaring the following fields at the first level of the spec:</p> <ul> <li><code>targetRef</code> (required): the reference to a hierarchical network object targeted by the policy, typed as a Gateway API <code>PolicyTargetReference</code> or <code>PolicyTargetReferenceWithSectionName</code> type</li> <li><code>defaults</code>: a block of default policy rules with further specification of a strategy (atomic set of rules or individual rules to be merged into lower policies), and optional conditions for applying the defaults down through the hierarchy</li> <li><code>overrides</code>: a block of override policy rules with further specification of a strategy (atomic set of rules or individual rules to be merged into lower policies), and optional conditions for applying the overrides down through the hierarchy</li> <li>the bare policy rules block without further qualification as a default or override set of rules \u2013 e.g. the <code>rules</code> field in a Kuadrant AuthPolicy, the <code>limits</code> field in a RateLimitPolicy.</li> </ul> <p>Between the following mutually exclusive options, either one or the other shall be used in a policy:</p> <ol> <li><code>defaults</code> and/or <code>overrides</code> blocks; or</li> <li>the bare set of policy rules (without further qualification as neither defaults nor overrides.)</li> </ol> <p>In case the bare set of policy rules is used, it is treated implicitly as a block of defaults.</p> <p>Supporting specifying the bare set of policy rules at the first level of the spec, alternatively to the <code>defaults</code> and <code>overrides</code> blocks, is a strategy that aims to provide:</p> <ol> <li>more natural usability, especially for those who write policies attached to the lowest level of the hierarchy supported; as well as</li> <li>backward compatibility for policies that did not support explicit D/O and later on have moved to doing so.</li> </ol>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#inherited-policies-that-declare-an-intent","title":"Inherited Policies that declare an intent","text":"<p>A policy that does not specify D/O fields (<code>defaults</code>, <code>overrides</code>) is a policy that declares an intent.</p> <p>One who writes a policy without specifying <code>defaults</code> or <code>overrides</code>, but only the bare set of policy rules, may feel like declaring a Direct Policy. Depending on the state of other policies indirectly affecting the same object or not, the final outcome can be the same as writing a direct policy. This is especially true when the policy that declares the intent targets an object whose kind is the lowest kind accepted by Kuadrant in the hierarchy of network resources, and there are no other policies with lower precedence.</p> <p>Nevertheless, because other policies can affect the final behavior of the target (e.g. by injecting defaults, by overriding rules, by adding more definitions beneath), policies that simply declare an intent, conceptually, are still Inherited Policies.</p> <p>Compared to the inherited policy that misses D/O blocks, these other policies affecting the behavior may be declared:</p> <ul> <li>at higher levels in the hierarchy,</li> <li>at lower levels in hierarchy, or even</li> <li>at the same level in the hierarchy but happening to have lower precedence (if such case is allowed by the kind of policy.)</li> </ul> <p>At any time, any one of these policies can be created and therefore the final behavior of a target should never be assumed to be equivalent to the intent declared by any individual policy in particular, but always collectively determined by the combination of all intents, defaults and overrides from all inherited policies affecting the target.</p> <p>From GEP-2649:</p> <p>If a Policy can be used as an Inherited Policy, it MUST be treated as an Inherited Policy, regardless of whether a specific instance of the Policy is only affecting a single object.</p> <p>An inherited policy that simply declares an intent (i.e. without specifying D/O) will be treated as a policy that implicitly declares an atomic set of defaults, whether the policy targets higher levels in the hierarchy or lower ones. In the absence of any other conflicting policy affecting the same target, the behavior equals the defaults which equal the intent.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#inherited-policies-that-modify-an-intent","title":"Inherited Policies that modify an intent","text":"<p>A policy that specifies D/O fields (<code>defaults</code>, <code>overrides</code>) is a policy explicitly declared to modify an intent.</p> <p>Without any other policy with lower precedence, there is no special meaning in choosing whether defaults or overrides in a inherited policy that targets an object whose kind is the lowest kind accepted by Kuadrant in the hierarchy of network resources. The sets of rules specified in these policies affect indistinctively the targeted objects, regardless of how they are qualified.</p> <p>However, because other policies may ocasionally be declared with lower precedence (i.e. targeting lower levels in the hierarchy or due to ordering, see Conflict Resolution), one who declares a policy to modify an intent must carefuly choose between <code>defaults</code> and/or <code>overrides</code> blocks to organize the policy rules, regardless if the targeted object is of a kind that is the lowest kind in the hierarchy of network resources accepted by Kuadrant.</p> <p>Even in the cases where no more than one policy of a kind is allowed to target a same object (1:1 relationship) and thus there should never exist two policies affecting a target from a same level of the hierarchy simultaneaously (or equivalently a policy with lower precedence than another, both at the lowest level of the hierarchy), users must assume that this constraint may change (i.e. N:1 relationship between policies of a kind and target become allowed.)</p> <p>In all cases, defaults and overrides must be used with the semantics of declaring rules that modify an intent.</p> <ul> <li>When an intent does not specify a rule for which there is a higher default declared, the default modifies the intent by setting the value specified by the default.</li> <li>For an intent that whether specifies or omits a rule for which there is a higher override declared, the override modifies the intent by setting the value specified by the override.</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#identifying-inherited-policy-kinds","title":"Identifying inherited policy kinds","text":"<p>All Custom Resource Definitions (CRDs) that define a Kuadrant inherited policy must be labeled <code>gateway.networking.k8s.io/policy: inherited</code>.</p> <p>Users can rely on the presence of that label to identify policy kinds whose instances are treated as inhertied policies.</p> <p>In some exceptional cases, there may be kinds of Kuadrant policies that do not specify <code>defaults</code> and <code>overrides</code> blocks, but that are still labeled as inherited policy kinds. Instances of these kinds of policies implicitly declare an atomic sets of defaults, similarly to described in Inherited Policies that declare an intent.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#examples-of-do-enabled-kuadrant-policy","title":"Examples of D/O-enabled Kuadrant policy","text":"<p>Example 1. Atomic defaults</p> <pre><code>kind: AuthPolicy\nmetadata:\n  name: gw-policy\nspec:\n  targetRef:\n    kind: Gateway\n  defaults:\n    rules:\n      authentication:\n        \"a\": {\u2026}\n      authorization:\n        \"b\": {\u2026}\n    strategy: atomic\n</code></pre> <p>The above is a proper Inherited Policy that sets a default atomic set of auth rules that will be set at lower objects in case those lower object do not have policies attached of their own at all.</p> <p>The following is a sligthly different example that defines auth rules that will be individually merged into lower objects, evaluated one by one if already defined at the \"lower\" (more specific) level and therefore should take precedence, or if otherwise is missing at the lower level and therefore the default should be activated.</p> <p>Example 2. Merged defaults</p> <pre><code>kind: AuthPolicy\nmetadata:\n  name: gw-policy\nspec:\n  targetRef:\n    kind: Gateway\n  defaults:\n    rules:\n      authentication:\n        \"a\": {\u2026}\n      authorization:\n        \"b\": {\u2026}\n    strategy: merge\n</code></pre> <p>Similarly, a set of <code>overrides</code> policy rules could be specified, instead or alongside with the <code>defaults</code> set of policy rules.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#atomic-vs-individually-merged-policy-rules","title":"Atomic vs. individually merged policy rules","text":"<p>There are 2 supported strategies for applying proper Inherited Policies down to the lower levels of the herarchy:</p> <ul> <li>Atomic policy rules: the bare set of policy rules in a <code>defaults</code> or <code>overrides</code> block is applied as an atomic piece; i.e., a lower object than the target of the policy, that is evaluated to be potentially affected by the policy, also has an atomic set of rules if another policy is attached to this object, therefore either the entire set of rules declared by the higher (less specific) policy is taken or the entire set of rules declared by the lower (more specific) policy is taken (depending if it's <code>defaults</code> or <code>overrides</code>), but the two sets are never merged into one.</li> <li>Merged policy rules: each individual policy rule within a <code>defaults</code> or <code>overrides</code> block is compared one to one against lower level policy rules and, when they conflict (i.e. have the same key with different values), either one or the other (more specific or less specific) is taken (depending if it's <code>defaults</code> or <code>overrides</code>), in a way that the final effective policy is a merge between the two policies.</li> </ul> <p>Each block of <code>defaults</code> and <code>overrides</code> must specify a <code>strategy</code> field whose value is set to either <code>atomic</code> or <code>merge</code>. If omitted, <code>atomic</code> is assumed.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#level-of-granularity-of-compared-policy-rules","title":"Level of granularity of compared policy rules","text":"<p>Atomic versus merge strategies, as a specification of the <code>defaults</code> and <code>overrides</code> blocks, imply that there are only two levels of granularity for comparing policies vis-a-vis.</p> <ul> <li> <p><code>atomic</code> means that the level of granularity is the entire set of policy rules within the <code>defaults</code> or <code>overrides</code> block. I.e., the policy is atomic, or, equivalently, the final effective policy will be either one indivisible (\"atomic\") set of rules (\"policy\") or the other.</p> </li> <li> <p>For the <code>merge</code> strategy, on the other hand, the granularity is of each named policy rule, where the name of the policy rule is the key and the value is an atomic object that specifies that policy rule. The final effective policy will be a merge of two policies.</p> </li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#matrix-of-do-strategies-and-effective-policy","title":"Matrix of D/O strategies and Effective Policy","text":"<p>When two policies are compared to compute a so-called Effective Policy out of their sets of policy rules and given default or override semantics, plus specified <code>atomic</code> or <code>merge</code> strategies, the following matrix applies:</p> Atomic (entire sets of rules) Merge (individual policy rules at a given granularity) Defaults More specific entire set of rules beats less specific entire set of rules \u2192 takes all the rules from the lower policy More specific individual policy rules beat less specific individual set of rules \u2192 compare one by one each pair of policy rules and take the lower one if they conflict Overrides Less specific entire set of rules beats more specific entire set of rules \u2192 takes all the rules from the higher policy Less specific individual policy rules beat more specific individual set of rules \u2192 compare one by one each pair of policy rules and take the higher one if they conflict <p>The order of the policies, from less specific (or \"higher\") to more specific (or \"lower), is determined according to the Gateway API hierarchy of network resources, based on the kind of the object targeted by the policy. The policy that sets higher in the hierarchy dictates the strategy to be applied.</p> <p>For a more detailed reference, including how to resolve conflicts in case of policies targeting objects at the same level, see GEP-713's section Hierarchy and Conflict Resolution.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#unsetting-inherited-defaults","title":"Unsetting inherited defaults","text":"<p>In some cases, it may be desirable to be able to unset, at a lower policy, a merged default that is inherited from a higher one. In fact, some inherited defaults could be harmful to an application, at the same time as they are unfeasible to remove from scope for all applications altogether, and therefore require an exception.</p> <p>Unsetting defaults via specification at lower level policies provides users who own policy rules at different levels of the hirarchy the option of not having to coordinate those exceptions \"offline\", nor having to accept the addition of special cases (conditions) at the higher level to exempt only specific lower policies from being affected by a particular default, which otherwise would configure a violation of the inheritance pattern, as well as an imposition of additional cognitive complexity for one who reads a higher policy with too many conditions.</p> <p>Instead, users should continue to be able to declare their intents through policies, and redeem an entitlement to unset unapplicable defaults, without any leakage of lower level details upwards at the higher policies.</p> <p>The option of unsetting inherited defaults is presented as part of the volition implied by the inheritance of policy rules, which are tipically specified for the more general case (e.g. at the level of a gateway, for all routes), though not necessarily applicable for all special cases beneath. If enabled, this feature helps disambiguate the concept of \"default\", which should not be understood strictly as the option to set values that protect the system in case of lack of specialisation. Rather, by its property of volition and changeability. I.e., by definition, every default policy rule is opt-out and specifies a value that is modifiable.</p> <p>In constrast, a policy rule that is neither opt-out nor modifiable better fits the definition of an override. While a policy rule that is not opt-out, nor it sets a concrete default value to be enforced in the lack of specialisation, defines a requirement.</p> <p>Finally, for the use case where users want to set defaults that cannot be unset (though still modifable), the very feature of unsetting defaults itself should be configurable, at least at the level of the system. This can be achieved with feature switches and policy validation, including backed by the cluster's RBAC if needed.</p> <p>The capability of unsetting inherited defaults from an effective policy can be identified by the presence of the <code>spec.unset</code> field in a policy. The value is a list of default named policy rules to be unset.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#conditionally-applying-do","title":"Conditionally applying D/O","text":"<p>Users should be able to specify conditions for applying their blocks of <code>defaults</code> and <code>overrides</code>. These conditions aim to support exceptional cases where the blocks cannot be simply applied downwards, but rather depend on specifics found in the lower policies, while still defined in generic terms \u2013 as opposed to conditions that leak details of individual lower policies upwards.</p> <p>Between a higher and a lower set of policy rules, the higher level dictates the conditions for its rules to be applied (either as defaults or as overrides) over the lower level, and never the other way around.</p> <p>D/O conditions are identfied by the presence of the <code>spec.defaults.when</code> or <code>spec.overrides.when</code> fields in a policy. Those should be defined using Common Expression Language (CEL), evaluated in the control plane against the lower level specification that the higher level is being applied to. I.e. <code>self</code> in the CEL expression is the lower policy.</p> <p>A concrete useful application for conditionally enforcing a block of D/O is for specifying constraints for lower values. E.g. if a lower policy tries to set a value on a numeric field that is greater (or lower) than a given threshold, apply an override that sets that field value to equal to the threshold; otherwise, use the value declared by the lower policy.</p> <p>In contrast, an example of trivially redundant application of D/O conditions would be specifying a default block of rules that is only applied when the lower level does not declare a more specific replacement. Since this is natural semantics of a default, one does not have to use conditions for that.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#examples-of-do-cases","title":"Examples of D/O cases","text":"<p>The following sets of examples generalize D/O applications for the presented user stories, regardless of details about specific personas and kinds of targeted resources. They illustrate the expected behavior for different cases involving defaults, overrides, constraints and unsetting.</p> Examples Highlighted user stories A. Default policy entirely replaced by another at lower level gateway-default-policy, route-replace-policy B. Default policy rules merged into policies at lower level gateway-default-policy-rule, route-add-policy-rule C. Override policy entirely replacing other at lower level gateway-override-policy D. Override policy rules merged into other at lower level gateway-override-policy-rule E. Override policy rules setting constraints to other at lower level policy-constraints F. Policy rule that unsets a default from higher level route-unset-policy-rule <p>In all the examples, a Gateway and a HTTPRoute objects are targeted by two policies, and an effective policy is presented highlighting the expected outcome. This poses no harm to generalizations involving same or different kinds of targeted resources, multiples policies targeting a same object, etc.</p> <p>The leftmost YAML is always the \"higher\" (less specific) policy; the one in the middle, separated from the leftmost one by a \"+\" sign, is the \"lower\" (more specific) policy; and the rightmost YAML is the expected Effective Policy.</p> <p>For a complete reference of the order of hierarchy, from least specific to most specific kinds of resources, as well as how to resolve conflicts of hierarchy in case of policies targeting objects at the same level, see Gateway API's Hierarchy definition for Policy Attachment and Conflict Resolution.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#examples-a-default-policy-entirely-replaced-by-another-at-lower-level","title":"Examples A - Default policy entirely replaced by another at lower level","text":"<p>Example A1. A default policy that is replaced entirely if another one is set at a lower level</p> <p></p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#examples-b-default-policy-rules-merged-into-policies-at-lower-level","title":"Examples B - Default policy rules merged into policies at lower level","text":"<p>Example B1. A default policy whose rules are merged into other policies at a lower level, where individual default policy rules can be overridden or unset - without conflict</p> <p></p> <p>Example B2. A default policy whose rules are merged into other policies at a lower level, where individual default policy rules can be overridden or unset - with conflict</p> <p></p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#examples-c-override-policy-entirely-replacing-other-at-lower-level","title":"Examples C - Override policy entirely replacing other at lower level","text":"<p>Example C1. An override policy that replaces any other that is set at a lower level entirely</p> <p></p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#examples-d-override-policy-rules-merged-into-other-at-lower-level","title":"Examples D - Override policy rules merged into other at lower level","text":"<p>Example D1. An override policy whose rules are merged into other policies at a lower level, overriding individual policy rules with same identification - without conflict</p> <p></p> <p>Example D2. An override policy whose rules are merged into other policies at a lower level, overriding individual policy rules with same identification - with conflict</p> <p></p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#examples-e-override-policy-rules-setting-constraints-to-other-at-lower-level","title":"Examples E - Override policy rules setting constraints to other at lower level","text":"<p>The examples in this section introduce the proposal for a new <code>when</code> field for the <code>defaults</code> and <code>overrides</code> blocks. This field dictates the conditions to be found in a lower policy that would make a higher policy or policy rule to apply, according to the corresponding <code>defaults</code> or <code>overrides</code> semantics and <code>atomic</code> or <code>merge</code> strategy.</p> <p>Combined with a simple case of override policy (see Examples C), the <code>when</code> condition field allows modeling for use cases of setting constraints for lower-level policies.</p> <p>As here proposed, the value of the <code>when</code> condition field must be a valid Common Expression Language (CEL) expression.</p> <p>Example E1. An override policy whose rules set constraints to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - lower policy is compliant with the constraint</p> <p></p> <p>Example E2. An override policy whose rules set constraints to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - lower level violates the constraint</p> <p></p> <p>Example E3. An override policy whose rules set constraints to field values of other policies at a lower level, overriding individual policy values of rules with same identification if those values violate the constraints - merge granularity problem</p> <p>The following example illustrates the possibly unintended consequences of enforcing D/O at strict levels of granularity, and the flip side of the <code>strategy</code> field offering a closed set of options (<code>atomic</code>, <code>merge</code>).</p> <p>On one hand, the API is simple and straightforward, and there are no deeper side effects to be concerned about, other than at the two levels provided (atomic sets or merged individual policy rules.) On the other hand, this design may require more offline interaction between the actors who manage conflicting policies.</p> <p></p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#examples-f-policy-rule-that-unsets-a-default-from-higher-level","title":"Examples F - Policy rule that unsets a default from higher level","text":"<p>The examples in this section introduce a new field <code>unset: []string</code> at the same level as the bare set of policy rules. The value of this field, provided as a list, dictates the default policy rules declared at a higher level to be removed (\"unset\") from the effective policy, specified by name of the policy rules.</p> <p>Example F1. A policy that unsets a default policy rule set at a higher level</p> <p></p> <p>Example F2. A policy that tries to unset an override policy rule set a higher level</p> <p></p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#status-reporting-and-policy-discoverability","title":"Status reporting and Policy discoverability","text":""},{"location":"architecture/rfcs/0009-defaults-and-overrides/#possible-statuses-of-an-inherited-policy","title":"Possible statuses of an inherited policy","text":"<p>An inherited policy can be at any of the following conditions (RFC 0004):</p> Type Status Reason Message Accepted True \"Accepted\" \"Policy has been accepted\" False \"Conflicted\" \"Policy is conflicted by &lt;policy-ns/policy-name&gt;\" False \"Invalid\" \"Policy is invalid\" False \"TargetNotFound\" \"Policy target &lt;resource-name&gt; was not found\" Enforced True \"Enforced\" \"Policy has been successfuly enforced[. The following defaults have been added by : x, y]\" True \"PartiallyEnforced\" \"Policy has been successfuly enforced. The following rules have been overridden by : a, b[; the following defaults have been added by : x, y]\" False \"Overridden\" \"Policy has been overridden by &lt;policy-ns/policy-name&gt;\" False \"Unknown\" \"Policy has encountered some issues\""},{"location":"architecture/rfcs/0009-defaults-and-overrides/#policy-discoverability-and-effective-policy","title":"Policy discoverability and Effective policy","text":"<p>A special condition must be added to every object that is targeted by a Kuadrant inherited policy if the policy's <code>Enforced</code> status condition is <code>True</code>.</p> <p>This special condition to be added to the target object is <code>kuadrant.io/xPolicyAffected</code>, where \"xPolicy\" is the kind of the inherited policy (e.g. AuthPolicy, RateLimitPolicy.)</p> <p>The possible statuses of an object regarding its sensitivity to one or more inherited policies are:</p> Type Status Reason Message xPolicyAffected False \"Unaffected\" \"The object is not affected by any xPolicy\" True \"Affected\" \"The object is affected by xPolicy &lt;policy-ns/policy-name&gt;\" True \"PartiallyAffected\" \"The following sections of the object are affected by xPolicy &lt;policy-ns/policy-name&gt;: rules.0, rules.2\" <p>The presence of the <code>PolicyAffected</code> status condition helps identify that an object is sensitive to one of more policies of a kind, and gives some specifics about the scope of that effect (entire object or selected sections.) In many cases, this should be enough for inferring the actual policy rules being enforced for that object.</p> <p>For other cases where any of the following situations hold, a more detailed view of the final Effective Policy must be provided to the user:</p> <ul> <li>If the rules of the policy cannot be inferred by the name of the policy and/or the user lacks permission to read the policy object;</li> <li>If the object is affected by more than one policy.</li> </ul> <p>To help visualize the effective policy for a given target object in that situation, at least one of the following options must be provided to the user:</p> <ol> <li>A read-only <code>EffectivePolicy</code> custom resource, defined for each kind of inherited policy, and with an instance created for each affected object, that is reconciled and updated by the policy controller.</li> <li>A HTTP endpoint of the policy controller that users can consume to read the effective policy.</li> <li>A CLI tool that offers a command that queries the cluster and returns the effective policy \u2013 either by leveraging any of the methods above or computing the effective policy \"on-the-fly\" in the same fashion as the policy controller does.</li> </ol>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#reference-level-explanation","title":"Reference-level explanation","text":""},{"location":"architecture/rfcs/0009-defaults-and-overrides/#applying-policies","title":"Applying policies","text":"<p>The following diagrams are a high level model to guide the process of applying a set of policies of a kind for a given Gateway object, where the Gateway object is considered the root of a hierarchy, and for all objects beneath, being the xRoute objects the leaves of the hierarchical tree.</p> <p>As presented, policies can target either Gateways of route objects (HTTPRoutes, GRPCRoutes), with no restriction regarding the number of policies of a kind that target a same particular object. I.e. N:1 relationship allowed. Without any loss of generality, 1:1 relationship between policies of a kind and targeted objects can be imposed if preferred as a measure to initially reduce the blast of information for the user and corresponding cognitive load.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#apply-policies-to-a-gateway-root-object-and-all-objects-beneath","title":"Apply policies to a Gateway (root object) and all objects beneath","text":"<pre><code>%%{ init: { \"theme\": \"neutral\" } }%%\nflowchart LR\n    start([For a Gateway &lt;i&gt;g&lt;/i&gt;&lt;br&gt;and policy kind &lt;i&gt;pk&lt;/i&gt;]) --&gt;\n    list-routes[List all routes&lt;br&gt;accepted by &lt;i&gt;g&lt;/i&gt; as &lt;i&gt;R&lt;/i&gt;] --&gt;\n    apply-policies-for-r\n    subgraph for-each-route[For each &lt;i&gt;r in R&lt;/i&gt;]\n        apply-policies-for-r[[Apply policies&lt;br&gt;of kind &lt;i&gt;pk&lt;/i&gt;&lt;br&gt;scoped for &lt;i&gt;r&lt;/i&gt;]] --&gt;\n        apply-policies-for-r\n    end\n    for-each-route --&gt;\n    build-virtual-route[Build a virtual route &lt;i&gt;vr&lt;/i&gt;&lt;br&gt;with all route rules not&lt;br&gt;target by any policy] --&gt;\n    apply-policies-for-vr[[Apply policies&lt;br&gt;of kind &lt;i&gt;pk&lt;/i&gt;&lt;br&gt;scoped for &lt;i&gt;vr&lt;/i&gt;]] --&gt;\n    finish(((END)))</code></pre>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#apply-policies-of-a-kind-for-an-object","title":"Apply policies of a kind for an object","text":"<pre><code>%%{ init: { \"theme\": \"neutral\" } }%%\nflowchart LR\n    apply-policies-for-o-start([Apply policies of kind &lt;i&gt;pk&lt;/i&gt;&lt;br&gt;scoped for an object &lt;i&gt;o&lt;/i&gt;]) --&gt;\n    list-policies[Make &lt;i&gt;P&lt;/i&gt; \u2190 all policies &lt;br&gt;of kind &lt;i&gt;pk&lt;/i&gt; that&lt;br&gt;affect &lt;i&gt;o&lt;/i&gt;] --&gt;\n    sort-policies[Sort &lt;i&gt;P&lt;/i&gt; from&lt;br&gt;lowest to highest] --&gt;\n    build-effective-policy[Build an effective&lt;br&gt;policy &lt;i&gt;ep&lt;/i&gt; without&lt;br&gt;any policy rules] --&gt;\n    merge-p-into-ep\n    subgraph for-each-policy[For each policy &lt;i&gt;p in P&lt;/i&gt;]\n        merge-p-into-ep[[Merge &lt;i&gt;p into &lt;i&gt;ep&lt;/i&gt;]] --&gt;\n        merge-p-into-ep\n    end\n    for-each-policy --&gt;\n    reconcile-ep[Reconcile resources&lt;br&gt;for &lt;i&gt;ep&lt;/i&gt;] --&gt;\n    apply-policies-for-o-finish(((END)))</code></pre>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#merging-two-policies-together","title":"Merging two policies together","text":"<pre><code>%%{ init: { \"theme\": \"neutral\" } }%%\nflowchart LR\n    merge-p1-into-p2-start([Merge policy &lt;i&gt;p1&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p2&lt;/i&gt;]) --&gt;\n    p1-format{Explicit&lt;br&gt;&lt;i&gt;defaults&lt;/i&gt; or &lt;i&gt;overrides&lt;/i&gt;&lt;br&gt;declared in &lt;i&gt;p1&lt;/i&gt;?}\n    p1-format -- Yes --&gt; merge-defaults-for-r[[\"Merge &lt;b&gt;defaults&lt;/b&gt; block&lt;br&gt;of policy rules&lt;br&gt;of &lt;i&gt;p1&lt;/i&gt; into &lt;i&gt;p2&lt;/i&gt;\"]] --&gt; merge-overrides-for-r[[\"Merge &lt;b&gt;overrides&lt;/b&gt; block&lt;br&gt;of policy rules&lt;br&gt;of &lt;i&gt;p1&lt;/i&gt; into &lt;i&gt;p2&lt;/i&gt;\"]] --&gt; merge-p1-into-p2-finish(((Return &lt;i&gt;p2&lt;/i&gt;)))\n    p1-format -- No --&gt; merge-bare-rules-for-r[[\"Merge ungrouped&lt;br&gt;block of policy rules&lt;br&gt;of &lt;i&gt;p1&lt;/i&gt; into &lt;i&gt;p2&lt;/i&gt;&lt;br&gt;(as &lt;b&gt;defaults&lt;/b&gt;)\"]] --&gt; merge-p1-into-p2-finish</code></pre>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#merging-a-generic-block-of-policy-rules-defaults-or-overrides-into-a-policy-with-conditions","title":"Merging a generic block of policy rules (defaults or overrides) into a policy with conditions","text":"<pre><code>%%{ init: { \"theme\": \"neutral\" } }%%\nflowchart LR\n    merge-block-of-rules-into-p-start([Merge block of&lt;br&gt;policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]) --&gt;\n    r-conditions-match{\"&lt;i&gt;B.when(p)&lt;/i&gt;\"}\n    r-conditions-match -- \"Conditions do not match\" --&gt; merge-block-of-rules-into-p-finish(((Return &lt;i&gt;p&lt;/i&gt;)))\n    r-conditions-match -- \"Conditions match\" --&gt; block-semantics{Merge &lt;i&gt;B&lt;/i&gt; as}\n    block-semantics -- \"Defaults\" --&gt; merge-default-block-into-p[[Merge default block&lt;br&gt;of policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]] --&gt; merge-block-of-rules-into-p-finish\n    block-semantics -- \"Overrides\" --&gt; merge-override-block-into-p[[Merge override block&lt;br&gt;of policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]] --&gt; merge-block-of-rules-into-p-finish</code></pre>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#merge-a-defaults-block-of-policy-rules-into-a-policy","title":"Merge a <code>defaults</code> block of policy rules into a policy","text":"<pre><code>%%{ init: { \"theme\": \"neutral\" } }%%\nflowchart LR\n    merge-default-block-into-p-start([Merge default block&lt;br&gt;of policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]) --&gt;\n    unset-unwanted-policy-rules[Remove from &lt;i&gt;B&lt;/i&gt;&lt;br&gt;all policy rules&lt;br&gt;listed in &lt;i&gt;p.unset&lt;/i&gt;] --&gt;\n    p-empty{&lt;i&gt;p.empty?&lt;/i&gt;}\n    p-empty -- \"Yes\" --&gt; full-replace-p-with-defaut-block[&lt;i&gt;p.rules \u2190 B&lt;/i&gt;] --&gt; merge-default-block-into-p-finish(((Return &lt;i&gt;p&lt;/i&gt;)))\n    p-empty -- \"No\" --&gt; default-block-strategy{&lt;i&gt;B.strategy&lt;/i&gt;}\n    default-block-strategy -- \"Atomic\" --&gt; merge-default-block-into-p-finish\n    default-block-strategy -- \"Merge\" --&gt; default-p-r-exists\n    subgraph for-each-default-policy-rule[\"For each &lt;i&gt;r in B&lt;i&gt;\"]\n        default-p-r-exists{\"&lt;i&gt;p[r.id].exists?&lt;/i&gt;\"}\n        default-p-r-exists -- \"Yes\" --&gt; default-p-r-exists\n        default-p-r-exists -- \"No\" --&gt; default-replace-pr[\"&lt;i&gt;p[r.id] \u2190 r&lt;/i&gt;\"] --&gt; default-p-r-exists\n    end\n    for-each-default-policy-rule --&gt;\n    merge-default-block-into-p-finish</code></pre>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#merge-an-overrides-block-of-policy-rules-into-a-policy","title":"Merge an <code>overrides</code> block of policy rules into a policy","text":"<pre><code>%%{ init: { \"theme\": \"neutral\" } }%%\nflowchart LR\n    merge-override-block-into-p-start([Merge override block&lt;br&gt;of policy rules &lt;i&gt;B&lt;/i&gt;&lt;br&gt;into policy &lt;i&gt;p&lt;/i&gt;]) --&gt;\n    override-block-strategy{&lt;i&gt;B.strategy&lt;/i&gt;}\n    override-block-strategy -- \"Atomic\" --&gt; full-replace-p-with-override-block[&lt;i&gt;p.rules \u2190 B&lt;/i&gt;] --&gt; merge-override-block-into-p-finish(((Return &lt;i&gt;p&lt;/i&gt;)))\n    override-block-strategy -- \"Merge\" --&gt; override-replace-pr\n    subgraph for-each-override-policy-rule[\"For each &lt;i&gt;r in B&lt;i&gt;\"]\n        override-replace-pr[\"&lt;i&gt;p[r.id] \u2190 r&lt;/i&gt;\"] --&gt; override-replace-pr\n    end\n    for-each-override-policy-rule --&gt;\n    merge-override-block-into-p-finish</code></pre>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#implementation-tiers","title":"Implementation tiers","text":"<p>This section proposes a possible path for the implementation of this RFC for Kuadrant's existing kinds of policies that are affected by D/O \u2013 notably AuthPolicy and RateLimitPolicy.</p> <p>The path is divided in 3 tiers that could be delivered in steps, additionaly to a series of enhancements &amp; refactoring.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#tier-1","title":"Tier 1","text":"<ul> <li>Atomic defaults (currently supported; missing addition of the <code>defaults</code> field to the APIs)</li> <li>Atomic overrides</li> <li>Policy status and Policy discoverability (i.e. PolicyAffected status on target objects)</li> <li>CRD labels <code>gateway.networking.k8s.io/policy: inherited | direct</code></li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#tier-2","title":"Tier 2","text":"<ul> <li>D/O <code>when</code> conditions (and support for \"constraints\")</li> <li>Merge strategy</li> <li>Reporting of effective policy</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#tier-3","title":"Tier 3","text":"<ul> <li>Unsetting (<code>unset</code>)</li> <li>Metrics for D/O policies (control plane)</li> <li>Docs: possible approaches for \"requirements\"</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#enhancements-and-refactoring","title":"Enhancements and refactoring","text":"<ul> <li>Extract generic part of D/O implementation to Kuadrant/gateway-api-machinery.</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#drawbacks","title":"Drawbacks","text":"<p>See Mutually exclusive API designs &gt; Design option: <code>strategy</code> field.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#rationale-and-alternatives","title":"Rationale and alternatives","text":""},{"location":"architecture/rfcs/0009-defaults-and-overrides/#mutually-exclusive-api-designs","title":"Mutually exclusive API designs","text":"<p>The following alternatives were considered for the design of the API spec to support D/O:</p> <ol> <li><code>strategy</code> field - RECOMMENDED</li> <li><code>granularity</code> field</li> <li><code>when</code> conditions (at any level of the spec)</li> <li>CEL functions (at any level of the spec)</li> <li>\u201cpath-keys\u201d</li> <li>JSON patch-like</li> </ol> <p>All the examples in the RFC are based on API design <code>strategy</code> field.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#design-option-strategy-field","title":"Design option: <code>strategy</code> field","text":"<p>Each block of <code>defaults</code> and <code>overrides</code> specify a field <code>strategy: atomic | merge</code>, with <code>atomic</code> assumed if the field is omitted.</p> <p>All the examples in the RFC are based on this design for the API spec.</p> <p>Some of the implications of the design are explained in the section Atomic vs. individually merged policy rules, with highlights to the support for specifying the level of atomicity of the rules in the policy based on only 2 granularities \u2013 entire set of policy rules (<code>atomic</code>) or to the level of each named policy rule (<code>merge</code>.)</p> \u2705 Pros \u274c Cons <ul> <li>Same schema as a normal policy without D/O</li> <li>Declarative</li> <li>Safe against \"unmergeable objects\" (e.g. two rules declaring different one-of options)</li> <li>Strong types</li> <li>Extensible (by adding more fields, e.g.: to support unsetting defaults)</li> <li>Easy to learn</li> </ul> <ul> <li>2 levels of granularity only \u2013 either all (\u2018atomic\u2019) or policy rule (\u2018merge\u2019)</li> <li>1 granularity declaration per D/O block \u2192 declaring both \u2018atomic\u2019 and \u2018merge\u2019 simultaneously requires 2 separate policies targeting the same object</li> </ul> <p>The design option based on the <code>strategy</code> field is the RECOMMENDED design for the implementation of Kuadrant Policies enabled for D/O. This is due to the pros above, plus the fact that this design can evolve to other, more versatile forms, such as <code>granularity</code> field, <code>when</code> conditions or CEL functions, in the future, while the opposite would be harder to achieve.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#design-option-granularity-field","title":"Design option: <code>granularity</code> field","text":"<p>Each block of <code>defaults</code> and <code>overrides</code> would specify a <code>granularity</code> field, set to a numeric integer value that describes which level of the policy spec, from the root of the set of policy rules until that number of levels down, to treat as the key, and the rest as the atomic value.</p> <p>Example:</p> <pre><code>kind: AuthPolicy\nmetadata:\n  name: gw-policy\nspec:\n  targetRef:\n    kind: Gateway\n  defaults:\n    rules:\n      authentication:\n        \"a\": {\u2026}\n      authorization:\n        \"b\": {\u2026}\n    granularity: 0 # the entire spec (\"rules\") is an atomic value\n  overrides:\n    rules:\n      metadata:\n        \"c\": {\u2026}\n      response:\n        \"d\": {\u2026}\n    granularity: 2 # each policy rule (\"c\", \"d\") is an atomic value\n</code></pre> \u2705 Pros \u274c Cons <ul> <li>Same as design option <code>strategy</code> field</li> <li>Unlimited levels of granularity (values can be pointed as atomic at any level)</li> </ul> <ul> <li>1 granularity declaration per D/O block \u2192 N levels simultaneously require N policies</li> <li>Granularity specified as a number - user needs to count the levels</li> <li>Setting a deep level of granularity can cause merging \"unmergeable objects\"</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#design-option-when-conditions-at-any-level-of-the-spec","title":"Design option: <code>when</code> conditions (at any level of the spec)","text":"<p>Inspired by the extension of the API for D/O with an additional <code>when</code> field (see Examples E), this design alternative would use the presence of this field to signal the granularity of the atomic operation of default or override.</p> <p>Example:</p> <pre><code>kind: AuthPolicy\nmetadata:\n  name: gw-policy\nspec:\n  targetRef:\n    kind: Gateway\n  defaults:\n    rules:\n      authentication:\n        \"a\": {\u2026}\n        when: CEL # level 1 - entire \"authentication\" block\n      authorization:\n        \"b\":\n          \"prop-1\": {\u2026}\n          when: CEL # level 2 - \"b\" authorization policy rule\n</code></pre> \u2705 Pros \u274c Cons <ul> <li>Same as <code>granularity</code> field</li> <li>As many granularity declarations per D/O block as complex objects in the policy</li> <li>Granularity specified \u201cin-place\u201d</li> </ul> <ul> <li>Setting a deep level of granularity can cause merging \"unmergeable objects\"</li> <li>Implementation nightmare - hard to define the API from existing types</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#design-option-cel-functions-at-any-level-of-the-spec","title":"Design option: CEL functions (at any level of the spec)","text":"<p>This design option leans on the power of Common Expression Language (CEL), extrapolating the design alternative with <code>when</code> conditions beyond declaring a CEL expression just to determine if a statically declared value should apply. Rather, it proposes the use of CEL functions that outputs the value to default to or to ovrride with, taking the conflicting \"lower\" value as input, with or without a condition as part of the CEL expression. The value of a key set to a CEL function indicates the level of granularity of the D/O operation.</p> <p>Example:</p> <pre><code>kind: AuthPolicy\nmetadata:\n  name: gw-policy\nspec:\n  targetRef:\n    kind: Gateway\n  defaults:\n    rules:\n      authentication:\n        \"a\": {\u2026} # static value\n        \"b\": \"cel:self.value &gt; 3 ? AuthenticationRule{value: 3} : self\"\n      authorization: |\n        cel:Authorization{\n          c: AuthorizationRule{prop1: \"x\"}\n        }\n</code></pre> \u2705 Pros \u274c Cons <ul> <li>Unlimited levels of granularity</li> <li>Granularity specified \u201cin-place\u201d</li> <li>Extremely powerful</li> <li>Elegant and simple implementation-wise</li> </ul> <ul> <li>Weakly typed</li> <li>Implementation completely new \u2013 cannot reuse current API types</li> <li>Requires all types to be defined as protobufs</li> <li>Without strong guardrails, users can easily shoot themselves in the foot</li> <li>Validation likely requires complex functions for parsing the CEL expressions</li> <li>Non-declarative</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#design-option-path-keys","title":"Design option: \u201cpath-keys\u201d","text":"<p>A more radical alternative considered consisted of defining <code>defaults</code> and <code>overrides</code> blocks whose schemas would not match the ones of a normal policy without D/O. Instead, these blocks would consist of simple key-value pairs, where the keys specify the paths in an affected policy where to apply the value atomically.</p> <p>Example:</p> <pre><code>kind: AuthPolicy\nmetadata:\n  name: gw-policy\nspec:\n  targetRef:\n    kind: Gateway\n  defaults:\n    \"rules.authentication\":\n      \"a\": {G}\n    \"rules.authorization.b\": {G}\n</code></pre> \u2705 Pros \u274c Cons <ul> <li>D/O as simple key-value sets (keys: where to apply, values: what to apply)</li> <li>Declarative</li> <li>Unlimited levels of granularity (values can be pointed as atomic at any level)</li> <li>Unlimited merge declarations per D/O block</li> <li>Intuitive, easy-to-learn</li> </ul> <ul> <li>Not same schema as the normal policy (without D/O) - not very GWAPI-like</li> <li>Weakly typed (i.e. <code>map[string]any)</code></li> <li>Not extensible (e.g., cannot add other fields to the API)</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#design-option-json-patch-like","title":"Design option: JSON patch-like","text":"<p>Similar to the path-keys design option, inspired by JSON patch operations, to provide more kinds of operations and extensibility.</p> <p>Example:</p> <pre><code>kind: AuthPolicy\nmetadata:\n  name: gw-policy\nspec:\n  targetRef:\n    kind: Gateway\n  defaults:\n\n  - path: rules.authentication\n    operation: add\n    value: { \"a\": {G} }\n  - path: rules.authorization.b\n    operation: remove\n  - path: |\n      rules.authentication.a.\n      value\n    operation: le\n    value: 50\n</code></pre> \u2705 Pros \u274c Cons <ul> <li>Same as \"path-keys\" field</li> <li>Extensible, all kinds of operations supported (add, remove, constraint)</li> </ul> <ul> <li>Not same schema as the normal policy (without D/O) - not very GWAPI-like</li> <li>Less declarative</li> <li>Weakly typed (i.e. <code>value: any)</code></li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#prior-art","title":"Prior art","text":"<p>Other than the primitive support only for implicit atomic defaults provided by Kuadrant for the AuthPolicy and RateLimitPolicy, other real-life implementations of D/O along the lines proposed by Gateway API are currently unknown.</p> <p>Some orientative examples provided in:</p> <ul> <li>GEP-2649 - search for \"CDNCachingPolicy\" as well as \"Merging into existing spec fields\";</li> <li><code>gwctl</code> effective policy calculation for inherited policies - see policy manager's merge test cases.</li> </ul>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#out-of-scope","title":"Out of scope","text":""},{"location":"architecture/rfcs/0009-defaults-and-overrides/#policy-requirements","title":"Policy requirements","text":"<p>A use case often described in association with D/O is the one for declaring policy requirements. These are high level policies that declare requirements to be fulfilled by more specific (lower level) policies without specifying concrete default or override values nor constraints. E.g.: \"an authentication policy must be enforced, but none is provided by default.\"</p> <p>A typical generic policy requirement user story is:</p> <p>As a Platform Engineer, when configuring a Gateway, I want to set policy requirements to be fulfilled by one who manages an application/route linked to my Gateway, so all interested parties, including myself, can be aware of applications deployed to the cluster that lack a particular policy protection being enforced.</p> <p>Policy requirements as here described are out of scope of this RFC.</p> <p>We believe policy requirement use cases can be stated and solved as an observability problem, by defining metrics and alerts that cover for missing policies or policy rules, without necessarily having to write a policy of the same kind to express such requirement to be fulfilled.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#unresolved-questions","title":"Unresolved questions","text":""},{"location":"architecture/rfcs/0009-defaults-and-overrides/#merging-policies-with-references-to-external-objects","title":"Merging policies with references to external objects","text":"<p>How to handle merges of policies from different namespaces that contain references to other objects (e.g. Secrets)?</p> <p>Often policies rules include references to other Kubernetes objects, such as Secrets, typically defined in the same namespace as the policy object. When merging policies from different namespaces, these references need to be taken into account.</p> <p>If not carried along with the derivative resources (e.g. Authorino AuthConfig objects) that are created from a merge of policies (or from the computed effective policy), composed out of definitions from different namespaces, and that depend on those references, these references to external objects can be broken.</p> <p>This is not much of a problem for atomic D/O only, as the derivative objects that depend on the references could be forced to be created in the same namespace as the policy that wins against all the others \u2013 and therefore in the same namespace of the winning referents as well. However, when merging policies, we can run into a situation where final effective policies (thus also other derivative resources) contain references to objects inherited from definitions from other namespaces.</p> <p>Possible solutions to this problem include:</p> <ol> <li>Copying the referenced objects into the namespace where the derivative resources will be created.</li> <li>Involves maintaining (watching and reconciling) those referenced objects</li> <li>May raise security concerns</li> <li>Allowing derivative resources (e.g. Authorino AuthConfigs) to reference objects across namespaces, as well as giving permissions to the components that process those references (e.g. Authorino) to read across namespaces</li> <li>May raise security concerns</li> <li>Should probably be restricted to derivative resources created by Kuadrant and not allowed to users who create the derivative resources themselves</li> </ol>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#policy-spec-resembling-more-the-target-spec","title":"Policy spec resembling more the target spec","text":"<p>Should Kuadrant's inherited policy specs resemble more the specs of the objects they target?</p> <p>The UX for one who writes a Kuadrant policy of the inherited class of policies is arguably not very different from writing any custom resource that happens to specify a <code>targetRef</code> field. Other than name and kind of target object, there is nothing much in a Kuadrant policy custom resource that provides the user with an experience almost close to be \"adding fields\" in the target object.</p> <p>With the exception of a few types reused for the route selectors, the spec of a Kuadrant policy is very different from the spec of the object that ultimately the policy augments, i.e. the spec of the route object. This remains basically unchanged after this RFC. However, another way to think on the design of those APIs is one where, in contrast, the specs of the policies partially mirror the spec of the route, so users can write policies in a more intuitive fashion, as if the definitions of the policy would look like extensions of the routes they target (directly or by targeting gateways the routes are attached to.)</p> <p>E.g.:</p> <pre><code>kind: HTTPRoute\nmetadata:\n  name: my-route\nspec:\n  rules:\n\n  - name: rule-1\n    matches:\n    - method: GET\n    backendRef: {\u2026}\n  - name: rule-2\n    backendRef: {\u2026}\n</code></pre> <p>An inherited policy that targets the HTTPRoute above could otherwise look like the following:</p> <pre><code>kind: Policy\nmetadata:\n  name: my-policy\nspec:\n  targetRef:\n    kind: HTTPRoute\n    name: my-route\n  defaults: # mirrors the spec of the httproute object\n    policySpecificDef: {\u2026} # augments the entire httproute object\n  overrides: # mirrors the spec of the httproute object\n    rules:\n\n    - name: rule-2\n      policySpecificDef: {\u2026} # augments only httprouterule rule-2 of the httproute object\n</code></pre> <p>The above already is somewhat closer to being true for the AuthPolicy API, than it is for the RateLimitPolicy one. However, that is strictly coincidental, because the AuthPolicy's spec happens to specify a <code>rules</code> field, where the equivalent at the same level in RateLimitPolicy is called <code>limits</code>.</p> <p>This alternative design could make writing policies more like defining filters in an HTTPRoute, with the difference that policies are external to the target they extend (while filters are internal.) At the same time, it could be a replacement for Kuadrant route selectors, where the context of applicability of a policy rule is given by the very structure within the spec how the policy rule is declared (resembling the one of the target), thus also would shaping context for D/O.</p> <p>One caveat of this design though is that each policy specific definition (i.e. the rule specification that extends the object at a given point defined by the very structure of the spec) is exclusive of that given point in the structure of the object. I.e., one cannot specify a single policy rule that augments N &gt; 1 specific rules of a target HTTPRoute.</p> <p>Due to its relevance to the design of the API that enables D/O, this was left as an unresolved question. To be nonetheless noticed that, as a pattern, this alternative API design extends beyond inherited policies, impacting as well the direct policy kinds DNSPolicy and TLSPolicy.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#future-possibilities","title":"Future possibilities","text":""},{"location":"architecture/rfcs/0009-defaults-and-overrides/#n1-policy-target-relationship","title":"N:1 policy-target relationship","text":"<p>Although this proposal was thought to keep options open for multiple policies of a kind targeting a same network resource, this is currently not the state of things for Kuadrant. Instead, Kuadrant enforces 1:1 relationship between policies of a kind and target resources.</p> <p>Supporting N:1 relationships could enable use cases such as of App Developers defining D/O for each other at the same level of a shared xRoute, as well as Platform Engineers setting different policy rules on the same Gateway.</p> <p>This could provide an alternative to achieving separation of concerns for complex policy kinds such as the AuthPolicy, where different users could be responsible for authentication and authorization, without necessarily depending on defining new kinds of policies.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#route-rule-name-and-targetrefsectionname","title":"Route rule <code>name</code> and <code>targetRef.sectionName</code>","text":"<p>If Gateway API's GEP-995 is accepted (i.e. kubernetes-sigs/gateway-api#2593 gets merged) and the <code>name</code> field for route rules implemented in the APIs (HTTPRoute and GRPCRoute), this could impact how Kuadrant delivers D/O. Although the semantics could remain the same, the users specify the scope for a given set of policy rules could simplify significantly.</p> <p>As of today, Kuadrant's AuthPolicy and RateLimitPolicy APIs allow users to target sections of a HTTPRoute based on route selectors, and thus all the conflict resolution involved in handling D/O must take that logics into account.</p> <p>With named route rules supported by Gateway API, either route selectors could be redefined in a simpler form where each selector consists of a list of names of rules and/or entire policies could be scoped for a section of a resource, by defining the <code>targetRef</code> field based on the <code>PolicyTargetReferenceWithSectionName</code> type.</p> <p>To be noted GEP-2649's recommendation of not defining inherited policies that allow for <code>sectionName</code> in the <code>targetRef</code>. Nonetheless, this is a general rule from the spec said to be acceptable to be broken in the spirit of offering better functionality to users, provided it can deal with the associated discoverability and complexity problems of this feature.</p>"},{"location":"architecture/rfcs/0009-defaults-and-overrides/#use-listmaptype-instead-of-maps-of-policy-rules","title":"Use listMapType instead of maps of policy rules","text":"<p>Despite having recently modified the AuthPolicy and RateLimitPolicy APIs to use maps for declaring policy rules instead of lists (RFC 0001), reverting this design in future versions of these APIs, plus treating those lists as <code>listMapType</code>, could let us leverage the API server's strategic merge type to handle merges between policy objects.</p> <p>In the Policy CRDs, the policy rule types must specify a <code>name</code> field (required). The list of rules type (i.e. <code>[]Rule</code>) must then speficy the following Kubebuilder CRD processing annotations:</p> <pre><code>// +listType=map\n// +listMapKey=name\n</code></pre> <ol> <li> <p>As the time of writing, GEP-713 (Kubernetes Gateway API, SIG-NETWORK) is under revision, expected to be split into two separate GEPs, one for Direct Policies (GEP-2648) and one for Inherited Policies (GEP-2649.) Once these new GEPs supersede GEP-713, all references to the previous GEP in this document must be updated to GEP-2649.\u00a0\u21a9</p> </li> </ol>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/","title":"Gateway API Metrics Exporter","text":"<ul> <li>Feature Name: gateway-api-metrics-exporter</li> <li>Start Date: 2024-07-26</li> <li>RFC PR: Kuadrant/architecture#101</li> <li>Issue tracking: kuadrant-operator/issues/675</li> </ul>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#summary","title":"Summary","text":"<p>A new sub-project for a prometheus exporter that exports metrics about the state of Gateway API resources in a Kubernetes cluster.</p>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#motivation","title":"Motivation","text":"<p>Allow additional stateful information about Gateway API resources to be made available via metrics. Currently a set of metrics are made available via the gateway-api-state-metrics project. However, there are limitations with what resource information can be exposed using the underlying kube-state-metrics project. Additional stateful information would include:</p> <ul> <li>Individual listener status within a Gateway</li> <li>HTTPRoute status</li> </ul> <p>For example, the individual status listener information from a Gateway:</p> <pre><code>  status:\n    listeners:\n\n    - attachedRoutes: 1\n      conditions:\n      - lastTransitionTime: \"2023-08-15T13:22:06Z\"\n        message: No errors found\n        observedGeneration: 1\n        reason: Ready\n        status: \"True\"\n        type: Ready\n      - lastTransitionTime: \"2023-08-15T13:22:06Z\"\n        message: No errors found\n        observedGeneration: 1\n        reason: ResolvedRefs\n        status: \"True\"\n        type: ResolvedRefs\n      name: api\n</code></pre> <p>and HTTPRoute parents status conditions:</p> <pre><code>  status:\n    parents:\n\n    - conditions:\n      - lastTransitionTime: \"2024-05-16T16:17:38Z\"\n        message: Object affected by AuthPolicy default/toystore\n        observedGeneration: 1\n        reason: Accepted\n        status: \"True\"\n        type: kuadrant.io/AuthPolicyAffected\n      - lastTransitionTime: \"2024-05-16T16:18:51Z\"\n        message: Object affected by RateLimitPolicy default/toystore\n        observedGeneration: 1\n        reason: Accepted\n        status: \"True\"\n        type: kuadrant.io/RateLimitPolicyAffected\n      controllerName: kuadrant.io/policy-controller\n      parentRef:\n        group: gateway.networking.k8s.io\n        kind: Gateway\n        name: api-gateway\n        namespace: kuadrant-system\n    - conditions:\n      - lastTransitionTime: \"2024-05-16T16:17:38Z\"\n        message: Object affected by AuthPolicy default/toystore\n        observedGeneration: 1\n        reason: Accepted\n        status: \"True\"\n        type: kuadrant.io/AuthPolicyAffected\n      - lastTransitionTime: \"2024-05-16T16:18:51Z\"\n        message: Object affected by RateLimitPolicy default/toystore\n        observedGeneration: 1\n        reason: Accepted\n        status: \"True\"\n        type: kuadrant.io/RateLimitPolicyAffected\n      - lastTransitionTime: \"2024-05-20T11:45:33Z\"\n        message: Route was valid\n        observedGeneration: 1\n        reason: Accepted\n        status: \"True\"\n        type: Accepted\n      - lastTransitionTime: \"2024-05-20T11:45:33Z\"\n        message: All references resolved\n        observedGeneration: 1\n        reason: ResolvedRefs\n        status: \"True\"\n        type: ResolvedRefs\n      controllerName: istio.io/gateway-controller\n      parentRef:\n        group: gateway.networking.k8s.io\n        kind: Gateway\n        name: api-gateway\n        namespace: kuadrant-system\n</code></pre>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#guide-level-explanation","title":"Guide-level explanation","text":"<p>First, implement the existing Gateway API metrics that are part of the gateway-api-state-metrics project. This will allow the new prometheus exporter to replace that project as a whole. The metrics will be backwards compatible with the gateway-api-state-metrics project, with the addition of new metrics.</p> <p>Second, implement new metrics, as per the examples below, to capture the additional status information:</p> <p><pre><code>gatewayapi_gateway_status_listeners_conditions{namespace=\"&lt;NAMESPACE&gt;\",name=\"&lt;GATEWAY&gt;\",listener_name=\"&lt;LISTENER_NAME&gt;\",type=\"&lt;ResolvedRefs|Ready|Other&gt;} 1\n</code></pre> This metric captures the status condition types of individual listeners in a Gateway. It will allow the status of individual named listeners to be queried, graphed and alerted on via metrics. The health status of listeners can then be visualised in a stat panel in Grafana, showing healthy and unhealthy listeners. This expands the debugging path beyond just the overall health of a Gateway.</p> <p><pre><code>gatewayapi_httproute_status_parents_conditions{namespace=\"&lt;NAMESPACE&gt;\",name=\"&lt;GATEWAY&gt;\",controller_name=\"&lt;CONTROLLER_NAME&gt;\",\"parent_group=\"&lt;PARENT_GROUP&gt;\",parent_kind=\"&lt;PARENT_KIND&gt;\",parent_name=\"&lt;PARENT_NAME&gt;\",parent_namespace=\"&lt;PARENT_NAMESPACE&gt;\",type=\"&lt;ResolvedRefs|Accepted|Other&gt;} 1\n</code></pre> This metric captures the condition types for each parent of a HTTPRoute. The <code>type</code> field would also record any custom types set by a controller. For example, <code>kuadrant.io/AuthPolicyAffected</code> and <code>kuadrant.io/RateLimitPolicyAffected</code>. This will allow the health of HTTPRoutes to be reported via metrics. A HTTPRoute that has an <code>type</code> of Accepted and value of 1 means the HTTPRoute is accepted by the Gateway and can be considered healthy. It will also allow policy specific information about a HTTPRoute to be represented in metrics. For example, alerting on any HTTPRoutes that don't have the <code>kuadrant.io/AuthPolicyAffected</code> type with a value of 1 i.e. HTTPRoutes without an AuthPolicy.</p> <p>Tests will be added directly to the project in a similar manner to the redis-exporter. The test environment will bring up a kind cluster, create the Gateway API CRDs, example Gateway &amp; HTTPRoute resources, then test the scrape endpoint. This will be the same as how metrics are tested for the gateway-api-state-metrics project. There is a separate test function for each resource.</p> <p>Existing example dashboards in the gateway-api-state-metrics project will be copied over to the exporter project and continue to work as before. However, initially it will just be the Gateway, GatewayClass and HTTPRoute dashboards as those will be the metrics that are implemented first.</p>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#reference-level-explanation","title":"Reference-level explanation","text":"<p>The exporter will be written in golang and follow the guidelines from https://prometheus.io/docs/instrumenting/writing_exporters/. Other exporters like the https://github.com/prometheus/node_exporter/tree/master and https://github.com/oliver006/redis_exporter will be referenced for patterns and library usage. Metrics will only be pulled from the kubernetes API when Prometheus scrapes them. That is, the exporter will not perform scrapes based on its own timers. All scrapes will be synchronous.</p> <p>The client-go library will be used for all kubernetes API calls. As the number of Gateways and HTTPRoutes could vary greatly, there is a performance consideration with these API calls if there are a lot of resources. To allow for this, a single list of all resources of a kind will used rather than 1 by 1. If in future there are issues with performance, there is an option to cache responses to expensive queries.</p> <p>A 'gateway_metrics_up` metric will be included, as per https://prometheus.io/docs/instrumenting/writing_exporters/#failed-scrapes such that the exporter can continue to respond in a standard way if there are issues with some aspects of scraping. The scrape response should include all metrics that have information available at that time of scraping.</p>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#drawbacks","title":"Drawbacks","text":"<p>This is an additional library to maintain. However, it will supersede the gateway-api-state-metrics project and dependency on kube-state-metrics.</p>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#rationale-and-alternatives","title":"Rationale and alternatives","text":"<p>In theory it should be possible to get the desired functionality from the kube-state-metrics project if the proposed change in https://github.com/kubernetes/kube-state-metrics/pull/2059 is accepted and subsequently implemented. However, that proposal has been open since May 2023. I have ruled out the possibility of helping with the implementation of this change in that project due to:</p> <ul> <li>lack of detailed knowledge of the current implementation of selectors in kube-state-metrics</li> <li>potential complexity of implementing generic CEL support in that project</li> <li>it not being core to the Kuadrant project goals, combined with the ongoing maintenance commitment after implementation. It wouldn't be fair to land the change we need without following up on maintenance after</li> </ul> <p>The proposed design is a more focused solution on the needs of the Kuadrant project from Gateway API resources in the form of metrics. There are plenty of examples of exporters out there that we can reference and follow established patterns.</p> <p>If we don't make this change, we are limited to having just the overall Gateway status available via metrics, and no HTTPRoute status information on which we can visualise and alert.</p>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#prior-art","title":"Prior art","text":"<p>The primary prior art are the kube-state-metrics project, and the gateway-api-state-metrics projects. The gateway-api-state-metrics project uses the CustomResourceStateMetrics configuration feature of kube-state-metrics to configure what fields in which resources should be made available via metrics.</p>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#unresolved-questions","title":"Unresolved questions","text":"<p>n/a</p>"},{"location":"architecture/rfcs/0010-gateway-api-metrics-exporter/#future-possibilities","title":"Future possibilities","text":"<p>Although this exporter is intended to replace the gateway-api-state-metrics project, it will likely take a phased approach to get to that point. The initial goal is to get 'like for like' functionality from a Kuadrant project point of view (Gateways, GatewayClasses and HTTPRoutes), followed by the new status functionality as detailed in this RFC. Other resources, such as TLSRoute, UDPRoute etc.. can be added later.</p>"},{"location":"architecture/rfcs/0011-policy-machinery/","title":"Policy Machinery for reconciliation","text":"<ul> <li>Feature Name: <code>policy_machinery</code></li> <li>Start Date: 2024-07-03</li> <li>RFC PR: Kuadrant/architecture#95</li> <li>Issue tracking: Kuadrant/architecture#29</li> </ul>"},{"location":"architecture/rfcs/0011-policy-machinery/#summary","title":"Summary","text":"<p>Explain how Kuadrant's Policy Machinery can be used for reconciliation.</p>"},{"location":"architecture/rfcs/0011-policy-machinery/#motivation","title":"Motivation","text":"<p>The Policy Machinery project (repo, pkg.go) offers a set of types and functions for implementing Gateway API policies \u2013 i.e.</p> <ul> <li>highly flexible representation of topologies of targetable resources;</li> <li>calculating effective policies based on custom or default merge strategies;</li> <li>tooling to watch and reconcile resources based on cluster events.</li> </ul> <p>These can be used for tailoring implemention of Kuadrant policies and Kuadrant instances. See example provided.</p> <p>Leveraging the Policy Machinery can be key to:</p> <ol> <li>Improve flow control of concurrent reconciliation events</li> <li>Simplification of the calculation of effective policies respectively to the topological routing path of the requests</li> <li>Correct implementation of Defaults &amp; Overrides' <code>merge</code> strategy (RFC 0009)</li> <li>Supporting multiple policies targeting a same resource</li> <li>Supporting targeting sections of a resource (e.g. Gateway listeners, HTTPRouteRules)</li> <li>Supporting multiple targetRefs in a policy</li> <li>Extending policies to target other kinds of resources (e.g. GatewayClass, Service, Namespace) -\u2013 future</li> </ol>"},{"location":"architecture/rfcs/0011-policy-machinery/#guide-level-explanation","title":"Guide-level explanation","text":"<p>Although essentially an implementation detail of the Kuadrant Operator, levering the Policy Machinery may introduce the following user-perceived features:</p> <ul> <li>Acknowledgement of the topological routing path of the request respectively to applicable effective policies</li> <li>New form of targeting sections of a resource with a policy</li> <li>Elevated meaning of uniquely identifiable concepts across policy resources (e.g. named policy rules)</li> <li>Possibility of multiple policies of a kind targeting a same resource</li> <li>(Window of opportunity for) introducing plural targetRefs</li> </ul>"},{"location":"architecture/rfcs/0011-policy-machinery/#user-acknowledgeable-reference-of-the-topological-routing-path-of-the-request","title":"User-acknowledgeable reference of the topological routing path of the request","text":"<p>One who specifies Kuadrant policies targeting resources at any levels of the hierarchy Gateway \u2192 Listener \u2192 HTTPRoute \u2192 HTTPRouteRule<sup>1</sup> shall expect the effect of such policies to be reported always respectively to the lowest level of the hierarchy that the kind of policy allows targeting. E.g.:</p> <ul> <li>A DNSPolicy that allows targeting a Gateway hypothetically with or without specifying a <code>sectionName</code> actually targets gateway listeners; the user wants to reason about the state of DNSPolicies regarding their effect on each listeners specified in the Gateway. In a context with 2+ DNSPolicies, simultaneously targeting both a Gateway and specific listeners, DNS records for some listener hostnames may have been reconciled according to the specification from one policy or another, occasionally no policy at all.</li> <li>A RateLimitPolicy that allows targeting a Gateway, a HTTPRoute or specific HTTPRouteRule actually targets (directly or indirectly) HTTPRouteRule objects; the user wants to reason about the state of all RateLimitPolicies with respect to each HTTPRouteRule, where some HTTPRouteRules may be protected by one RateLimitPolicy, a combination of multiple RateLimitPolicies, or occasionally no RateLimitPolicy at all.</li> </ul> <p>In the specific case of policy kinds that allow targeting HTTPRouteRules, due to complex network topologies supported by Gateway API, including in particular HTTPRoutes with multiple Gateway parents, a same HTTPRouteRule may or may not be affected by a policy, depending on which routing path in the network topology a request flows. Therefore, ultimately users will reason about policies and effective policies in terms of the paths between at least gateways and the lowest levels targeted by the policies that a request can flow. Possibly, in terms of all possible paths between Gateways and Services.</p> <p>Kuadrant shall provide users with such visibility. Leveraging Policy Machinery is an implementation detail that nonetheless makes achieving this goal easier.</p>"},{"location":"architecture/rfcs/0011-policy-machinery/#user-facing-changes-to-the-policy-apis","title":"User-facing changes to the policy APIs","text":""},{"location":"architecture/rfcs/0011-policy-machinery/#targeting-sections-of-network-resource","title":"Targeting sections of network resource","text":"<p>Leveraging Policy Machinery may also motivate some user-facing changes. In particular, replacing AuthPolicy's and RateLimitPolicy's <code>routeSelectors</code> for a <code>targetRef</code> with optional <code>sectionName</code> (made possible since kubernetes-sigs/gateway-api#2895.)</p> <p>This change would cause a policy of AuthPolicy or RateLimitPolicy kind to always be attached to its targets entirely, i.e. without having rules that attach to some sections and other rules to other sections or no section at all. This differs from current situation where a policy of those kinds can be attached to a HTTPRoute and some of the policy's rules more specifically attached to individual HTTPRouteRules only, including with multiple policy rules attached to different HTTPRouteRules of the same targeted HTTPRoute. Instead, attaching a policy must be a cohesive, unambiguous operation, that occasionally requires users to specify more fine-grained policy objects to be attached only to sections of a resource.</p>"},{"location":"architecture/rfcs/0011-policy-machinery/#identity-of-concepts-across-multiple-policy-objects","title":"Identity of concepts across multiple policy objects","text":"<p>In some cases, splitting policy objects for the purpose of targeting sections of a network resource, without breaking the semantics of having a single set of policy objects cohesively defined, also implies that definitions about a same entity or concept within a policy (e.g. a limit definition), repeated at multiple policy objects, may have a way to represent to refer to the same thing (e.g. same set of counters).</p> <p>This is the case, for example, of limit definitions in a RateLimitPolicy as well as cache configs in an AuthPolicy. To avoid creating multiple rate-limit counter namespaces (analogously, multiple authorization rule cache entries) for definitions that are effectively about the same entity, despite specified at multiple policy objects, the APIs must provide a way for users to convey one of the other intent: definitions refer to the same thing versus definitions refer to different things.<sup>2</sup></p>"},{"location":"architecture/rfcs/0011-policy-machinery/#other-user-facing-changes","title":"Other user-facing changes","text":"<p>The following possible (non-required) other user-facing changes can be enabled leveraging Policy Machinery, without marginal implementation cost:</p> <ol> <li>Plural <code>targetRefs</code>.</li> <li>Multiple policies of a kind targeting a same network resource/resource section (\"horizontal Defaults &amp; Overrides.\")</li> <li>Aesthetical difference between Direct versus Inherited policies, implied by the merge strategies implemented by each kind of policy, rather than a necessary distinction.</li> </ol>"},{"location":"architecture/rfcs/0011-policy-machinery/#reference-level-explanation","title":"Reference-level explanation","text":"<p>Usage of the Policy Machinery consists of importing two packages:</p> <ul> <li><code>machinery</code>: provides the types and abstractions to build Gateway API topologies of targetable network resources, policies and adjacent objects;</li> <li><code>controller</code>: offers tools for implementing topology-based custom controllers of reconciliation logic.</li> </ul> <p>From that on, the following steps drive leveraging the Policy Machinery in the Kuadrant Operator:</p> <ol> <li> <p>Implement the <code>machinery.Policy</code> interface for all kinds of policies.</p> <p>Example provided for the DNSPolicy, TLSPolicy, AuthPolicy and RateLimitPolicy kinds.</p> </li> <li> <p>Define wrappers that implement the <code>machinery.Object</code> interface for any kind of adjacent object whose unique identifier as a node in the topology graph cannot be based on the default <code>controller.RuntimeObject</code> type provided (if any.)</p> </li> <li> <p>Implement the linking functions for all kinds of adjacent objects and corresponding parents and children in the topology graph, including types such as <code>Kuadrant</code>, Istio's <code>WasmPlugin</code>, <code>ConfigMap</code>, etc.</p> <p>The <code>Kuadrant</code> custom resources shall be the roots of a directed acyclic graph (DAG) from which an entired topology of targetable network resources, adjacent objects and policies are connected.</p> </li> <li> <p>Start a <code>controller.Controller</code> that:</p> <ol> <li>Watches for all kinds of objects to be represented in the topology.</li> <li>Triggers a <code>controller.Workflow</code> on events related to any of the watched resources.</li> </ol> </li> <li> <p>At every reconciliation event<sup>3</sup>:</p> <ol> <li> <p>Reconcile the internal objects for setting up the environment for a Kuadrant instance (deployments, gateway controller configs, etc).</p> </li> <li> <p>For each kind of policy and applicable path in the topology graph relevant for the policy kind:</p> </li> <li> <p>Compute an effective policy and give it a unique identifier.</p> </li> <li>Perform (or delegate) the policy-specific configuration (DNS, TLS, Auth, RL) of the effective policy with the policy decision/enforcement point<sup>4</sup>.</li> <li>For policy kinds enforced at request time (data-plane policies), configure the gateway to call the policy decision point (PDP) on requests that match the attributes of the path<sup>5</sup>, passing in the payload to the PDP the identifier of the effective policy.</li> <li> <p>Update the status stanzas of all targetables in the topology whose paths were configured for an effective policy (or lack of such), with a map that allows users to inspect, for a given path, what effective policy (if any) will be enforced.        &gt; Note: If unsuitable for the status stanza of the object, the details of the effective policies may require additional tooling to be inspected by the users and the mapping must be to the unique identifier of the effective policy.</p> </li> <li> <p>Store a DOT representation of the topology graph in a ConfigMap.</p> </li> </ol> </li> </ol>"},{"location":"architecture/rfcs/0011-policy-machinery/#drawbacks","title":"Drawbacks","text":"<p>Part of the work consists on refactoring, without value perceived by the user.</p>"},{"location":"architecture/rfcs/0011-policy-machinery/#rationale-and-alternatives","title":"Rationale and alternatives","text":""},{"location":"architecture/rfcs/0011-policy-machinery/#annotations","title":"Annotations","text":"<p>Use of annnotations to track back references from targeted objects to policies. This approach has been slowly deprecated to favour the use of an in-memory directed acyclic graph (DAG) representing the relationship between network objects and policies<sup>6</sup>.</p>"},{"location":"architecture/rfcs/0011-policy-machinery/#bottom-up-reconciliation","title":"Bottom-up reconciliation","text":"<p>Bottom-up reconciliation by default, focusing on the policy resources first. This approach has been slowly refactored to using mappers (event handlers) that often multiply a lower-level event into multiple top-down ones, occasionally with the occurrence of repetitive events.</p>"},{"location":"architecture/rfcs/0011-policy-machinery/#dag-10","title":"DAG 1.0","text":"<p>Preliminary version of the topology DAG<sup>6</sup> that:</p> <ol> <li>is bootstrapped at every reconciliation event (though leveraging k8s.io/apimachinery's and sigs.k8s.io/controller-runtime's caches);</li> <li>does not include all kinds of targetables \u2013 missing object sections in particular;</li> <li>does not include internal configuration objects;</li> <li>was designed for one single kind of policy in each instance of the topology.</li> </ol>"},{"location":"architecture/rfcs/0011-policy-machinery/#effective-policy-less-reconciliation","title":"Effective policy-less reconciliation","text":"<p>Configuration of internal resources for implementing effective policy behavior:</p> <ol> <li>tailored for each specific kind of policy, without leveraging generic and resusable merge strategy functions;</li> <li>not organically integrated with the topology DAG;</li> <li>decoupled from the rather user-acknowledgeable reference of the topological routing path of the request.</li> </ol>"},{"location":"architecture/rfcs/0011-policy-machinery/#prior-art","title":"Prior art","text":""},{"location":"architecture/rfcs/0011-policy-machinery/#envoy-gateway-state-of-the-world-reconciliation","title":"Envoy Gateway state-of-the-world reconciliation","text":"<p>Envoy Gateway has implemented a custom controller for Gateway API and provider-specific resources with the following characteristics similar to the Policy Machinery <code>controller</code> package's approach:</p> <ol> <li>Based on controller-runtime</li> <li>Single <code>Reconcile</code> function that:<ol> <li>lists all watched resources from the cluster at every reconciliation event;</li> <li>rebuilds and updates a long-living watchable map of all the resources;</li> <li>trigger reconciliation logic subscribed to changes to the map \u2013 <code>goroutines</code> decoupled from controller-runtime.</li> </ol> </li> </ol>"},{"location":"architecture/rfcs/0011-policy-machinery/#unresolved-questions","title":"Unresolved questions","text":"<ul> <li>The fanout problem, especially of status reconciliation.</li> <li>~~How to avoid changes performed by the reconciliation function to loop back in the form of multiple other (no-op) reconciliation events.~~ \u21e8 issue state-modifying actions against the API server directly and safe-guard against create/update/delete events for states already reflected in the topology</li> <li>~~How to compact multiple equifinal reconciliation events waiting in the queue into a single one, thus avoiding unnecessary loops.~~ \u21e8 rely on controller-runtime event coalescing</li> <li>~~What to do in case of reconciliation failures without retry~~ \u21e8 always move the system to a final state, with proper status updating, and wait until state-of-the-world reconciliation kicks in again on the next event</li> </ul>"},{"location":"architecture/rfcs/0011-policy-machinery/#future-possibilities","title":"Future possibilities","text":"<ul> <li>Extending policies to target other kinds of resources (e.g. GatewayClass, Service, Namespace.)</li> </ul> <ol> <li> <p>Gateway listeners and HTTPRouteRules can be targeted by specifying in a policy their main Gateway and HTTPRoute objects as targets, in combination with either a <code>sectionName</code> (supported in the <code>targetRef</code> field of the policy) or via <code>routeSelectors</code> (in the policy spec proper), respectively. Not all kinds of policies support targeting all 4 kinds of targetables of the Gateway \u2192 Listener \u2192 HTTPRoute \u2192 HTTPRouteRule hierarchy; some kinds of policies may support targeting only a few of those.\u00a0\u21a9</p> </li> <li> <p>In the context of rate-limit, this problem is also referred to as the problem of the identity of a limit.\u00a0\u21a9</p> </li> <li> <p>Specific steps can be filtered by type of event.\u00a0\u21a9</p> </li> <li> <p>While the DNS operator as well as the configuration performed by the Kuadrant Operator for a TLSPolicy are closer to the enforcement of the specifications in the DNS and TLS policy objects, Authorino and Limitador are policy decision points (PDP) rather. Indistinctively, control-plane operations that configure a service based on the specification of a policy, as well as the data-plane protection services that perform at request-time along with the gateways are all part of the policy enforcement.\u00a0\u21a9</p> </li> <li> <p>The attributes of a path in the topology from a Gateway to a HTTPRouteRule object typically include a hostname and the set of HTTPRouteMatches specified in the HTTPRouteRule.\u00a0\u21a9</p> </li> <li> <p>See kuadrant-operator#530.\u00a0\u21a9\u21a9</p> </li> </ol>"},{"location":"architecture/rfcs/dns-policy-api-changes/","title":"RFC DNSPolicy v1 changes and improvements","text":"<ul> <li>Feature Name: (<code>dns_policy_api_changes</code>)</li> <li>Start Date: (2024-09-11)</li> <li>RFC PR: Kuadrant/architecture#0000</li> <li>Issue tracking: https://github.com/Kuadrant/architecture/issues/104</li> </ul>"},{"location":"architecture/rfcs/dns-policy-api-changes/#summary","title":"Summary","text":"<p>DNSPolicy is soon to go GA. There are several improvement we have identified over time that will enhance the GA of this API</p> <ul> <li> <p>Remove the need for labels on Gateways for GEO and custom weighting values</p> </li> <li> <p>Reduce the verbosity of GEO and Weighting definitions</p> </li> <li> <p>Remove the need for a strategy to be chosen as part of the policy definition.</p> </li> </ul>"},{"location":"architecture/rfcs/dns-policy-api-changes/#motivation","title":"Motivation","text":"<p>We want to simplify and improve the DNSPolicy API and remove some of the legacy structures that have hung on since its original inception, as this involves some breaking changes we want these before we create a v1 API.</p> <p>Weighting and GEO attributes:</p> <p>The loadbalancing options we provide were first designed as part of an API that was intended to work with OCM (open cluster management). This provided multiple views of gateways across multiple clusters. So in order to understand the GEO context or individual weighing needed for a given cluster, we needed that context applying separately from the DNSPolicy spec that for legacy reasons targeted a \"template\" Gateway in the hub cluster.</p> <p>Now DNSPolicy is created on the same cluster as the actual Gateway and we do not use OCM or hub clusters, the need to label individual objects and Gateways with specific annotations and labels is now redundant and makes for a more complex and awkward API interaction.</p> <p>routingStrategy:</p> <p>We have also identified that the routingStrategy option in the DNSPolicy spec is redundant. When added we expected there to be more than two strategies. This has not emerged and so it is another awkward piece of the API that is not needed.</p>"},{"location":"architecture/rfcs/dns-policy-api-changes/#guide-level-explanation","title":"Guide-level explanation","text":"<p>You will no longer need to apply labels to Gateways in order to specify the GEO or Weighting for that Gateway. The policy targets a given Gateway and you will now just specify those values in the policy spec directly.</p> <p>You will no longer need to specify what routingStrategy you want to use. Instead you will either specify a loadbalancing section (meaning it is a loadbalanced strategy) or you will leave it empty (meaning it has no loadbalancing).</p>"},{"location":"architecture/rfcs/dns-policy-api-changes/#reference-level-explanation","title":"Reference-level explanation","text":"<p>Below is an example of what is currently needed to setup GEO and Custom Weighting with the existing API</p> <p><pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: prod-web\n  namespace: ingress-gateway\nspec:\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  routingStrategy: loabalanced  \n  loadBalancing:\n    weighted:\n      defaultWeight: 120\n      custom: # &lt;--- New Custom Weights being added\n\n        - weight: 255\n          selector:\n            matchLabels:\n              kuadrant.io/lb-attribute-custom-weight: AWS # slects gateways to apply it to (when there can only be one)\n    geo: \n      defaultGeo: US #catch all geo              \n</code></pre> So here to apply a custom weighting, you have to specify the weighting under the custom section and then apply the <code>kuadrant.io/lb-attribute-custom-weight: AWS</code> label to the gateway that is already being targeted by the policy. </p> <p>To change the GEO for the targeted cluster, you need to apply a different label to the gateway: <code>kuadrant.io/lb-attribute-geo-code: EU</code> for example. </p> <p>On top of this you also have to specify that it is a load balanced DNSPolicy even though you have specified a load balancing section. </p> <p>This is an awkward and disconnected API that evolved from the legacy requirements called out above.</p> <p>Instead the new API to achieve the same goal will be:</p> <pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: prod-web\n  namespace: ingress-gateway\nspec:\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  loadBalancing:\n    weight: 100 #weight for listeners targeted \n    geo: US # geo for listeners targeted \n    defaultGEO: true # should this be consisdered the default GEO for the listener hosts\n  providerRefs:\n\n    - name: aws-credential-secret    \n</code></pre> <p>So no longer do you need to specify whether the policy is a load balanced one or not via the redundant <code>routingStrategy</code> field</p> <p>Now you simplify specify the weight you want to use for the listeners in the gateway, the geo you want to use and whether it should be used as a default GEO or not (this is used by some cloud providers as a catch-all option if a user from a none specified GEO does a DNS lookup.). Each of the fields under \"loadbalancing\" will now be required.</p> <p>From an implementation perspective, all changes will happen in the Kuadarant Operator, where it will no longer look for the attribute labels on the gateways but instead will simply use the spec of the DNSPolicy. The resulting DNSRecord will not change in structure. </p> <p>To setup a simple DNS structure (single A or CNAME record), the API would now look like:</p> <pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: prod-web\n  namespace: ingress-gateway\nspec:\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  providerRefs:\n\n    - name: aws-credential-secret    \n</code></pre> <p>Again no need for the redundant strategy field. </p>"},{"location":"architecture/rfcs/dns-policy-api-changes/#drawbacks","title":"Drawbacks","text":"<p>Introduces a breaking change to the API.</p>"},{"location":"architecture/rfcs/dns-policy-api-changes/#rationale-and-alternatives","title":"Rationale and alternatives","text":"<p>These are breaking changes and we are about to move to v1. Changes like these should land pre v1. These changes provide a much simpler and better user experience.</p>"},{"location":"architecture/rfcs/dns-policy-api-changes/#prior-art","title":"Prior art","text":"<p>NA</p>"},{"location":"architecture/rfcs/dns-policy-api-changes/#unresolved-questions","title":"Unresolved questions","text":"<p>NA</p>"},{"location":"architecture/rfcs/dns-policy-api-changes/#future-possibilities","title":"Future possibilities","text":"<p>NA</p>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/","title":"DNSRecordStructure","text":"<p>DNSRecord is our API for expressing DNS endpoints via a kube CRD based API. It is managed by the multi-cluster gateway controller based on the desired state expressed in higher level APIs such as the Gateway or a DNSPolicy. In order to provide our feature set, we need to carefully consider how we structure our records and the types of records we need. This document proposes a particular structure based on the requirements and feature set we have.</p>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#requirements","title":"Requirements","text":"<p>We want to be able to support Gateway definitions that use the following listener definitions:</p> <ul> <li>wildcard: <code>*.example.com</code> and fully qualified listener host <code>www.example.com</code> definitions with the notable exception of fully wildcarded ie <code>*</code> as we cannot provide any DNS or TLS for something with no defined hostname.</li> <li>listeners that have HTTPRoute defined on less than all the clusters where the listener is available. IE we don't want to send traffic to clusters where there is no HTTPRoute attached to the listener.</li> <li>Gateway instances that provide IPs that are deployed alongside instances on different infra that provide host names causing the addresses types on each of gateway instance to be different (IPAddress or HostAddress). </li> <li>We want to provide GEO based DNS as a feature of DNSPolicy and so our DNSRecord structure must support this.</li> <li>We want to offer default weighted and custom weighted DNS as part of DNSPolicy</li> <li>We want to allow root or apex domain to be used as listener hosts</li> </ul>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#diagram","title":"Diagram","text":"<p>https://lucid.app/lucidchart/2f95c9c9-8ddf-4609-af37-48145c02ef7f/edit?viewport_loc=-188%2C-61%2C2400%2C1183%2C0_0&amp;invitationId=inv_d5f35eb7-16a9-40ec-b568-38556de9b568</p>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#proposal","title":"Proposal","text":"<p>For each listener defined in a gateway, we will create a set of records with the following rules.</p> <p>none apex domain:</p> <p>We will have a generated lb (load balancer) dns name that we will use as a CNAME for the listener hostname. This DNS name is not intended for use within a HTTPRoute but is instead just a DNS construct. This will allow us to set up additional CNAME records for that DNS name in the future that are returned based a GEO location. These DNS records will also be CNAMES pointing to specific gateway dns names, this will allow us to setup a weighted response. So the first layer CNAME handles balancing based on geo, the second layer handles balancing based on weighting. </p> <pre><code>                                        shop.example.com\n                                        |             |\n                                      (IE)          (AUS)\n                                CNAME lb.shop..      lb.shop..\n                                    |     |         |      |\n                                 (w 100) (w 200)   (w 100) (w100)\n                                CNAME g1.lb.. g2.lb..   g3.lb..  g4.lb..\n                                A 192..   A 81..  CNAME  aws.lb   A 82..\n</code></pre> <p>When there is no geo strategy defined within the DNSPolicy, we will put everything into a default geo (IE a catch-all record) <code>default.lb-{guid}.{listenerHost}</code> but set the routing policy to GEO allowing us to add more geo based records in the future if the gateway admin decides to move to a geo strategy as their needs grow. </p> <p>To ensure this lb dns name is unique and does not clash we will use a short guid as part of the subdomain so <code>lb-{guid}.{listenerHost}.</code> this guid will be based on the gateway name and gateway namespace in the control plane.</p> <p>For a geo strategy we will add a geo record with a prefix to the lb subdomain based on the geo code. When there is no geo we will use <code>default</code> as the prefix. <code>{geo-code}.lb-{guid}.{listenerHost}</code>. Finally, for each gateway instance on a target cluster we will add a <code>{spokeClusterName}.lb-{guid}.{listenerHost}</code></p> <p>To allow for a mix of hostname and IP address types, we will always use a CNAME . So we will create a dns name for IPAddress with the following structure: <code>{guid}.lb-{guid}.{listenerHost}</code> where the first guid will be based on the cluster name where the gateway is placed.</p>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#apex-domains","title":"Apex Domains","text":"<p>An apex domain is the domain at the apex or root of a zone. These are handled differently by DNS as they often have NS and SOA records. Generally it is not possible to set up a CNAME for apex domain (although some providers allow it).</p> <p>If a listener is added to a gateway that is an apex domain, we can only add A records for that domain to keep ourselves compliant with as many providers as possible. If a listener is the apex domain, we will setup A records for that domain (favouring gateways with an IP address or resolving the IP behind a host) but there will be no special balancing/weighting done. Instead, we will expect that the owner of that will setup a HTTPRoute with a 301 permanent redirect sending users from the apex domain e.g. example.com to something like: www.example.com where the www subdomain based listener would use the rules of the none apex domains and be where advanced geo and weighted strategies are applied.</p> <ul> <li>gateway listener host name : example.com <ul> <li>example.com A 81.17.241.20</li> </ul> </li> </ul>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#geo-agnostic-everything-is-in-a-default-geo-catch-all","title":"Geo Agnostic (everything is in a default * geo catch all)","text":"<p>This is the type of DNS Record structure that would back our default DNSPolicy.</p> <ul> <li> <p>gateway listener host name : www.example.com </p> <p>DNSRecords:</p> <ul> <li>www.example.com CNAME lb-1ab1.www.example.com </li> <li>lb-1ab1.www.example.com CNAME geolocation * default.lb-1ab1.www.example.com </li> <li>default.lb-1ab1.www.example.com CNAME weighted 100 1bc1.lb-1ab1.www.example.com</li> <li>default.lb-1ab1.www.example.com CNAME weighted 100 aws.lb.com</li> <li>1bc1.lb-1ab1.www.example.com A 192.22.2.1</li> </ul> </li> </ul> <p>So in the above example working up from the bottom, we have a mix of hostname and IP based addresses for the gateway instance. We have 2 evenly weighted records that balance between the two available gateways, then next we have the geo based record that is set to a default catch all as no geo has been specified then finally we have the actual listener hostname that points at our DNS based load balancer name.</p> <p>DNSRecord Yaml</p> <pre><code>apiVersion: kuadrant.io/v1alpha1\nkind: DNSRecord\nmetadata:\n  name: {gateway-name}-{listenerName}\n  namespace: multi-cluster-gateways\nspec:\n  dnsName: www.example.com\n  managedZone:\n    name: mgc-dev-mz\n  endpoints:\n\n    - dnsName: www.example.com\n      recordTTL: 300\n      recordType: CNAME\n      targets:\n        - lb-1ab1.www.example.com\n    - dnsName: lb-1ab1.www.example.com\n      recordTTL: 300\n      recordType: CNAME\n      setIdentifier: mygateway-multicluster-gateways\n      providerSpecific:\n        - name: \"geolocation-country-code\"\n          value: \"*\"\n      targets:\n        - default.lb-1ab1.www.example.com\n    - dnsName: default.lb-1ab1.www.example.com\n      recordTTL: 300\n      recordType: CNAME\n      setIdentifier: cluster1\n      providerSpecific:\n        - name: \"weight\"\n          value: \"100\"\n      targets:\n        - 1bc1.lb-1ab1.www.example.com\n    - dnsName: default.lb-a1b2.shop.example.com\n      recordTTL: 300\n      recordType: CNAME\n      setIdentifier: cluster2\n      providerSpecific:\n        - name: \"weight\"\n          value: \"100\"\n      targets:\n        - aws.lb.com\n    - dnsName: 1bc1.lb-1ab1.www.example.com\n      recordTTL: 60\n      recordType: A\n      targets:\n        - 192.22.2.1\n</code></pre>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#geo-specific","title":"geo specific","text":"<p>Once the end user selects to use a geo strategy via the DNSPolicy, we then need to restructure our DNS to add in our geo specific records. Here the default record</p> <p>lb short code is {gw name + gw namespace} gw short code is {cluster name}</p> <ul> <li> <p>gateway listener host : shop.example.com  </p> <p>DNSRecords:</p> <ul> <li>shop.example.com CNAME lb-a1b2.shop.example.com </li> <li>lb-a1b2.shop.example.com  CNAME geolocation ireland ie.lb-a1b2.shop.example.com </li> <li>lb-a1b2.shop.example.com  geolocation australia aus.lb-a1b2.shop.example.com </li> <li>lb-a1b2.shop.example.com  geolocation default ie.lb-a1b2.shop.example.com  (set by the default geo option)</li> <li>ie.lb-a1b2.shop.example.com   CNAME weighted 100 ab1.lb-a1b2.shop.example.com </li> <li>ie.lb-a1b2.shop.example.com   CNAME weighted 100 aws.lb.com</li> <li>aus.lb-a1b2.shop.example.com  CNAME weighted 100 ab2.lb-a1b2.shop.example.com </li> <li>aus.lb-a1b2.shop.example.com  CNAME weighted 100 ab3.lb-a1b2.shop.example.com </li> <li>ab1.lb-a1b2.shop.example.com  A 192.22.2.1 192.22.2.5</li> <li>ab2.lb-a1b2.shop.example.com  A 192.22.2.3</li> <li>ab3.lb-a1b2.shop.example.com  A 192.22.2.4</li> </ul> </li> </ul> <p>In the above example we move from a default catch all to geo specific setup. Based on a DNSPolicy that specifies IE as the default geo location. We leave the <code>default</code> subdomain in place to allow for clients that may still be using that and set up geo specific subdomains that allow us to route traffic based on its origin. In this example we are load balancing across 2 geos and 4 clusters</p>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#wildcards","title":"WildCards","text":"<p>In the examples we have used fully qualified domain names, however sometimes it may be required to use a wildcard subdomain. example:</p> <ul> <li>gateway listener host : *.example.com  </li> </ul> <p>To support these we need to change the name of the DNSRecord away from the name of the listener as the k8s resource does not allow * in the name. </p> <p>To do this we will set the dns record resource name to be a combination of <code>{gateway-name}-{listenerName}</code></p> <p>to keep a record of the host this is for we will set a top level property named <code>dnsName</code>. You can see an example in the DNSRecord above.</p>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#pros","title":"Pros","text":"<p>This setup allows us a powerful set of features and flexibility</p>"},{"location":"architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/#cons","title":"Cons","text":"<p>With this CNAME based approach we are increasing the number of DNS lookups required to get to an IP which will increase the cost and add a small amount of latency. To counteract this, we will set a reasonably high TTL (at least 5 mins) for our CNAMES and (2 mins) for A records</p>"},{"location":"api-quickstart/","title":"API Quickstart","text":""},{"location":"api-quickstart/#introduction","title":"Introduction","text":"<p>This document details how to setup a local reference architecture, and design and deploy an API. This will show the following API management features in a kube native environment using Kuadrant and other open source tools:</p> <ul> <li>API design</li> <li>API security and access control</li> <li>API monitoring</li> <li>Traffic management and scalability</li> </ul> <p>The sections in this document are grouped by the persona that is typically associated with the steps in that section. The 3 personas are:</p> <ul> <li>The platform engineer, who provides and maintains a platform for application developers,</li> <li>the application developer, who designs, builds and maintains applications and APIs,</li> <li>and the api consumer, who makes API calls to the API</li> </ul>"},{"location":"api-quickstart/#pre-requisities","title":"Pre-requisities","text":"<ul> <li><code>docker</code>: https://www.docker.com/products/docker-desktop/</li> <li><code>kind</code>: https://kind.sigs.k8s.io/</li> <li><code>kubectl</code>: https://kubernetes.io/docs/reference/kubectl/</li> <li><code>kustomize</code>: https://kustomize.io/</li> <li><code>helm</code>: https://helm.sh/docs/intro/install/</li> <li><code>operator-sdk</code>: https://sdk.operatorframework.io/docs/installation/</li> <li>An AWS account with a Secret Access Key and Access Key ID. You will also need to a Route 53 zone.</li> </ul>"},{"location":"api-quickstart/#platform-engineer-platform-setup","title":"(Platform engineer) Platform Setup","text":"<p>Export the following env vars:</p> <pre><code>export KUADRANT_AWS_ACCESS_KEY_ID=&lt;key_id&gt;\nexport KUADRANT_AWS_SECRET_ACCESS_KEY=&lt;secret&gt;\nexport KUADRANT_AWS_REGION=&lt;region&gt;\nexport KUADRANT_AWS_DNS_PUBLIC_ZONE_ID=&lt;zone&gt;\nexport KUADRANT_ZONE_ROOT_DOMAIN=&lt;domain&gt;\n</code></pre> <p>Clone the api-quickstart repo and run the quickstart script:</p> <pre><code>git clone git@github.com:Kuadrant/api-quickstart.git &amp;&amp; cd api-quickstart\n./quickstart.sh\n</code></pre> <p>This will take several minutes as 3 local kind clusters are started and configured in a hub and spoke architecture. The following components will be installed on the clusters:</p> <ul> <li>Hub</li> <li>Open Cluster Management, as a 'hub' cluster</li> <li>Kuadrant Multi Cluster Gateway Controller, for managing a Gateway in multiple clusters centrally</li> <li>Gatekeeper, for constraints on Gateway Policy requirements</li> <li>Thanos, for receiving metrics centrally</li> <li>Grafana, for visualising API &amp; Gateway metrics</li> <li>Spoke x2</li> <li>Open Cluster Management, as a 'spoke' cluster</li> <li>Kuadrant Operator, for auth and rate limiting policies attached to a HTTPRoute</li> <li>Istio, with the Gateway API CRDs as the Gateway for ingress trafic</li> <li>MetalLB, for exposing the Gateway service on the local network</li> <li>Prometheus, for scraping and federating metrics to the hub</li> </ul>"},{"location":"api-quickstart/#verify-the-gateway-and-configuration","title":"Verify the Gateway and configuration","text":"<p>View the ManagedZone, Gateway and TLSPolicy. The ManagedZone and TLSPolicy should have a Ready status of true. The Gateway should have a Programmed status of True.</p> <pre><code>kubectl --context kind-api-control-plane get managedzone,tlspolicy,gateway -n multi-cluster-gateways\n</code></pre>"},{"location":"api-quickstart/#guard-rails-constraint-warnings-about-missing-policies-dns-tls","title":"Guard Rails: Constraint warnings about missing policies ( DNS, TLS)","text":"<p>Running the quick start script above will bring up Gatekeeper and the following constraints: </p> <ul> <li>Gateways must have a TLSPolicy targeting them</li> <li>Gateways must have a DNSPolicy targeting them</li> </ul> <p>To view the above constraints in kubernetes, run this command: <pre><code>kubectl --context kind-api-control-plane get constraints\n</code></pre></p> <p>Info</p> <p>Since a gateway has been created automatically, along with a <code>TLSPolicy</code>, the violation for a missing <code>DNSPolicy</code> will be active until one is created.</p>"},{"location":"api-quickstart/#grafana-dashboard-view","title":"Grafana dashboard view","text":"<p>To get a top level view of the constraints in violation, the <code>Stitch: Platform Engineer Dashboard</code> can be used. This can be accessed by at https://grafana.172.31.0.2.nip.io</p> <p>Grafana has a default username and password of <code>admin</code>. You can find the <code>Stitch: Platform Engineer Dashboard</code> dashboard in the <code>Default</code> folder.</p>"},{"location":"api-quickstart/#create-the-missing-dnspolicy","title":"Create the missing DNSPolicy","text":"<p>Create a DNSPolicy that targets the Gateway with the following command:</p> <pre><code>kubectl --context kind-api-control-plane apply -f - &lt;&lt;EOF\napiVersion: kuadrant.io/v1alpha1\nkind: DNSPolicy\nmetadata:\n  name: prod-web\n  namespace: multi-cluster-gateways\nspec:\n  targetRef:\n    name: prod-web\n    group: gateway.networking.k8s.io\n    kind: Gateway\n  loadBalancing:\n    geo:\n      defaultGeo: EU\nEOF\n</code></pre>"},{"location":"api-quickstart/#platform-overview","title":"Platform Overview","text":"<p>Since we have created all the policies that Gatekeeper had the guardrails around, you should no longer see any constraints in violation. This can be seen back in the <code>Stitch: Platform Engineer Dashboard</code> in Grafana at https://grafana.172.31.0.2.nip.io</p>"},{"location":"api-quickstart/#application-developer-app-setup","title":"(Application developer) App setup","text":""},{"location":"api-quickstart/#api-design","title":"API Design","text":"<p>Fork and/or clone the Petstore App at https://github.com/Kuadrant/api-petstore</p> <pre><code>git clone git@github.com:kuadrant/api-petstore &amp;&amp; cd api-petstore\n# Or if you forked the repository:\n# git clone git@github.com:&lt;your_github_username&gt;/api-petstore &amp;&amp; cd api-petstore\n</code></pre> <p>Then deploy it to the first workload cluster:</p> <pre><code>kustomize build ./resources/ | envsubst | kubectl --context kind-api-workload-1 apply -f-\n</code></pre> <p>This will deploy:</p> <ul> <li>A <code>petstore</code> Namespace</li> <li>A <code>Secret</code>, containing a static API key that we'll use later for auth</li> <li>A <code>Service</code> and <code>Deployment</code> for our petstore app</li> <li>A Gateway API <code>HTTPRoute</code> for our petstore app</li> </ul>"},{"location":"api-quickstart/#route-53-dns-zone","title":"Route 53 DNS Zone","text":"<p>When the DNS Policy has been created, and the previously created <code>HTTPRoute</code> has been attached, a DNS record custom resource will also be created in the cluster resulting in records being created in your AWS Route53. Navigate to Route53 and you should see some new records in the zone.</p>"},{"location":"api-quickstart/#configuring-the-region-label","title":"Configuring the region label","text":"<p>Configure the app <code>REGION</code> to be <code>eu</code>:</p> <pre><code>kubectl --context kind-api-workload-1 apply -k ./resources/eu-cluster/\n</code></pre>"},{"location":"api-quickstart/#exploring-the-open-api-specification","title":"Exploring the Open API Specification","text":"<p>The raw Open API spec can be found in the root of the repo:</p> <pre><code>cat openapi.yaml\n# ---\n# openapi: 3.0.2\n# info:\n#   title: Stitch API Petstore\n#   version: 1.0.18\n</code></pre>"},{"location":"api-quickstart/#application-developer-api-security","title":"(Application developer) API security","text":"<p>We've included a number of sample <code>x-kuadrant</code> extensions in the OAS spec already:</p> <ul> <li>At the top-level of our spec, we've defined an <code>x-kuadrant</code> extension to detail the Gateway API Gateway associated with our app:</li> </ul> <pre><code>  x-kuadrant:\n    route:\n      name: petstore\n      namespace: petstore\n      labels:\n        deployment: petstore\n        owner: cferreir\n      hostnames:\n\n      - petstore.$KUADRANT_ZONE_ROOT_DOMAIN\n      parentRefs:\n      - name: prod-web\n        namespace: kuadrant-multi-cluster-gateways\n        kind: Gateway\n</code></pre> <ul> <li>In <code>/user/login</code>, we have a Gateway API <code>backendRef</code> set and a <code>rate_limit</code> set. The rate limit policy for this endpoint restricts usage of this endpoint to 2 requests in a 10 second window:     <pre><code>x-kuadrant:\n  backendRefs:\n  - name: petstore\n    namespace: petstore\n    port: 8080\n  rate_limit:\n  rates:\n  - limit: 2\n    duration: 10\n    unit: second\n</code></pre></li> <li>In <code>/store/inventory</code>, we have also have a Gateway API <code>backendRef</code>set and a <code>rate_limit</code> set. The rate limit policy for the endpoint restricts usage of this endpoint to 10 requests in a 10 second window:     <pre><code>x-kuadrant:\n  backendRefs:\n  - name: petstore\n    namespace: petstore\n    port: 8080\n  rate_limit:\n    rates:\n    - limit: 10\n      duration: 10\n      unit: second\n</code></pre></li> <li>Finally, we have a <code>securityScheme</code> setup for apiKey auth, powered by Authorino. We'll show this in more detail a little later:   <pre><code>securitySchemes:\n  api_key:\n    type: apiKey\n    name: api_key\n    in: header\n</code></pre></li> </ul> <p>These extensions allow us to automatically generate Kuadrant Kubernetes resources, including AuthPolicies, RateLimitPolicies and Gateway API resources such as HTTPRoutes.</p>"},{"location":"api-quickstart/#kuadrantctl","title":"kuadrantctl","text":"<p><code>kuadrantctl</code> is a cli that supports the generation of various Kubernetes resources via OAS specs. Let's run some commands to generate some of these resources. If you forked the api-pestore repo, you can check them in also. Let's apply these to our running workload to implement rate limiting and auth.</p>"},{"location":"api-quickstart/#installing-kuadrantctl","title":"Installing <code>kuadrantctl</code>","text":"<p>Download <code>kuadrantctl</code> from the <code>v0.2.0</code> release artifacts:</p> <p>https://github.com/Kuadrant/kuadrantctl/releases/tag/v0.2.0</p> <p>Drop the <code>kuadrantctl</code> binary somewhere into your $PATH (e.g. <code>/usr/local/bin/</code>).</p> <p>For this next part of the tutorial, we recommend installing <code>yq</code> to pretty-print YAML resources.</p>"},{"location":"api-quickstart/#generating-kuadrant-resources-with-kuadrantctl","title":"Generating Kuadrant resources with <code>kuadrantctl</code>","text":"<p>We'll generate an <code>AuthPolicy</code> to implement API key auth, per the <code>securityScheme</code> in our OAS spec:</p> <pre><code># Generate this resource and save:\nkuadrantctl generate kuadrant authpolicy --oas openapi.yaml | yq -P | tee resources/authpolicy.yaml\n\n# Apply this resource to our cluster:\nkubectl --context kind-api-workload-1 apply -f ./resources/authpolicy.yaml\n</code></pre> <p>Next we'll generate a <code>RateLimitPolicy</code>, to protect our APIs with the limits we have setup in our OAS spec:</p> <pre><code># Generate this resource and save:\nkuadrantctl generate kuadrant ratelimitpolicy --oas openapi.yaml | yq -P | tee resources/ratelimitpolicy.yaml\n\n# Apply this resource to our cluster:\nkubectl --context kind-api-workload-1 apply -f ./resources/ratelimitpolicy.yaml\n</code></pre> <p>Lastly, we'll generate a Gateway API <code>HTTPRoute</code> to service our APIs:</p> <pre><code># Generate this resource and save:\nkuadrantctl generate gatewayapi httproute --oas openapi.yaml | yq -P | tee resources/httproute.yaml\n\n# Apply this resource to our cluster, setting the hostname in via the KUADRANT_ZONE_ROOT_DOMAIN env var:\nkustomize build ./resources/ | envsubst | kubectl --context kind-api-workload-1 apply -f-\n</code></pre>"},{"location":"api-quickstart/#check-our-applied-policies","title":"Check our applied policies","text":"<p>Navigate to your app's Swagger UI:</p> <pre><code>echo https://petstore.$KUADRANT_ZONE_ROOT_DOMAIN/docs/\n</code></pre>"},{"location":"api-quickstart/#ratelimitpolicy","title":"RateLimitPolicy","text":"<p>Let's check that our <code>RateLimitPolicy</code> for the <code>/store/inventory</code> has been applied and works correctly. Recall, our OAS spec had the following limits applied:</p> <p><pre><code>x-kuadrant:\n  ...\n  rate_limit:\n    rates:\n\n    - limit: 10\n      duration: 10\n      unit: second\n</code></pre> Navigate to the <code>/store/inventory</code> API, click <code>Try it out</code>, and <code>Execute</code>.</p> <p>You'll see a response similar to:</p> <pre><code>{\n  \"available\": 10,\n  \"pending\": 5,\n  \"sold\": 3\n}\n</code></pre> <p>This API has a rate limit applied, so if you send more than 10 requests in a 10 second window, you will see a <code>429</code> HTTP Status code from responses, and a \"Too Many Requests\" message in the response body. Click <code>Execute</code> quickly in succession to see your <code>RateLimitPolicy</code> in action.</p>"},{"location":"api-quickstart/#authpolicy","title":"AuthPolicy","text":"<p>Let's check that our <code>AuthPolicy</code> for the <code>/store/admin</code> endpoint has been applied and works correctly. Recall, our OAS spec had the following securitySchemes applied:</p> <pre><code>  securitySchemes:\n    api_key:\n      type: apiKey\n      name: api_key\n      in: header\n</code></pre> <p>Navigate to the <code>/store/admin</code> API, click <code>Try it out</code>, and <code>Execute</code>. You'll get a 401 response.</p> <p>You can set a value for the <code>api_key</code> header by clicking <code>Authorize</code> at the top of the page. Set a value of <code>secret</code>. This api key value is stored in the <code>petstore-api-key</code> Secret in the <code>petstore</code> namespace. Try the <code>/store/admin</code> endpoint again and you should get a 200 response with the following:</p> <pre><code>{\"message\":\"You are an admin!\"}\n</code></pre>"},{"location":"api-quickstart/#policy-adjustments","title":"Policy Adjustments","text":"<p>Run the Swagger UI editor to explore the OAS spec and make some tweaks:</p> <pre><code>docker run -p 8080:8080 -v $(pwd):/tmp -e SWAGGER_FILE=/tmp/openapi.yaml swaggerapi/swagger-editor\n</code></pre> <p>You should be able to access the Swagger Editor at http://localhost:8080. Our <code>/store/inventory</code> API needs some additonal rate limiting. This is one of our slowest, most expensive services, so we'd like to rate limit it further.</p> <p>In your <code>openapi.yaml</code>, navigate to the <code>/store/inventory</code> endpoint in the <code>paths</code> block. Modify the rate_limit block to further restrict the amount of requests this endpoint can serve to 2 requests per 10 seconds:</p> <pre><code>x-kuadrant:\n  ...\n  rate_limit:\n    rates:\n\n    - limit: 2\n      duration: 10\n      unit: second\n</code></pre> <p>Save your updated spec - <code>File</code> &gt; <code>Save as YAML</code> &gt; and update your existing <code>openapi.yaml</code>. You may need to copy the file from your Downloads folder to the location of the petstore repository.</p> <p>Next we'll re-generate our <code>RateLimitPolicy</code> with <code>kuadrantctl</code>:</p> <pre><code># Generate this resource and save:\nkuadrantctl generate kuadrant ratelimitpolicy --oas openapi.yaml | yq -P | tee resources/ratelimitpolicy.yaml\n\n# Apply this resource to our cluster:\nkubectl --context kind-api-workload-1 apply -f ./resources/ratelimitpolicy.yaml\n</code></pre> <p>At this stage you can optionally check in all the changes to the repo if you forked it.</p> <pre><code># Optionally add, commit &amp; push the changes to your fork\ngit add resources\ngit commit -am \"Generated AuthPolicy,RateLimitPolicy &amp; HTTPRoute\"\ngit push # You may need to set an upstream as well\n</code></pre> <p>In your app's Swagger UI:</p> <pre><code>echo https://petstore.$KUADRANT_ZONE_ROOT_DOMAIN/docs/\n</code></pre> <p>Navigate to the <code>/store/inventory</code> API one more, click <code>Try it out</code>, and <code>Execute</code>.</p> <p>You'll see the effects of our new <code>RateLimitPolicy</code> applied. If you now send more than 2 requests in a 10 second window, you'll be rate-limited.</p> <p>Note:  It may take a few minutes for the updated RateLimitPolicy to be configured with the modified rate limit.</p>"},{"location":"api-quickstart/#application-developer-scaling-the-application","title":"(Application developer) Scaling the application","text":"<p>Deploy the petstore to the 2nd cluster:</p> <pre><code>kustomize build ./resources/ | envsubst | kubectl --context kind-api-workload-2 apply -f-\nkubectl --context kind-api-workload-2 apply -f ./resources/authpolicy.yaml\nkubectl --context kind-api-workload-2 apply -f ./resources/ratelimitpolicy.yaml\n</code></pre> <p>Configure the app <code>REGION</code> to be <code>us</code>:</p> <pre><code>kubectl --context kind-api-workload-2 apply -k ./resources/us-cluster/\n</code></pre>"},{"location":"api-quickstart/#platform-engineer-scaling-the-gateway-and-traffic-management","title":"(Platform engineer) Scaling the gateway and traffic management","text":"<p>Deploy the Gateway to the 2nd cluster:</p> <pre><code>kubectl --context kind-api-control-plane patch placement http-gateway --namespace multi-cluster-gateways --type='json' -p='[{\"op\": \"replace\", \"path\": \"/spec/numberOfClusters\", \"value\":2}]'\n</code></pre> <p>Label the 1st cluster as being in the 'EU' region, and the 2nd cluster as being in the 'US' region. These labels are used by the DNSPolicy for configuring geo DNS.</p> <pre><code>kubectl --context kind-api-control-plane label managedcluster kind-api-workload-1 kuadrant.io/lb-attribute-geo-code=EU --overwrite\nkubectl --context kind-api-control-plane label managedcluster kind-api-workload-2 kuadrant.io/lb-attribute-geo-code=US --overwrite\n</code></pre>"},{"location":"api-quickstart/#api-consumer-accessing-the-api-from-multiple-regions","title":"(API consumer) Accessing the API from multiple regions","text":"<p>Info</p> <p>This section is optional. If you'd rather skip this part, you can skip forward to the \"(App developer) API traffic monitoring\" section.</p> <p></p>"},{"location":"api-quickstart/#pre-requisites","title":"Pre-requisites","text":"<ul> <li><code>python3</code> and <code>pip3</code>: these are required for this part of the walkthrough</li> </ul> <p>To demonstrate traffic management by geographical region, we'll use a tool called 'geosight'. This tool resolves hostnames from different regions, fetches a website from the resulting DNS record address and takes a screenshot. The petstore app has been configured to serve a flag image based on which region it is running in. In the 1st cluster, the EU flag is used. In the 2nd cluster, the US flag is used.</p> <p>To install 'geosight', run the following commands:</p> <pre><code>git clone git@github.com:jasonmadigan/geosight.git &amp;&amp; cd geosight\npip3 install -r requirements.txt\nplaywright install\n</code></pre> <p>Then run it using:</p> <pre><code>python3 app.py\n</code></pre> <p>Access the webapp at http://127.0.0.1:5001/. In the input box, type the address from below and click the <code>Fetch</code> button:</p> <pre><code>echo https://petstore.$KUADRANT_ZONE_ROOT_DOMAIN/server/details\n</code></pre> <p>After a moment you should see dns results for different regions, and a corresponding screenshot.</p> <p>If you want to experiment with other regions, check out the Configuration section for geosight and the Kuadrant docs for geo loadbalancing.</p>"},{"location":"api-quickstart/#app-developer-api-traffic-monitoring","title":"(App developer) API traffic monitoring","text":"<p>To view the App developer dashboard, the same Grafana will be used from the platform engineer steps above: <code>https://grafana.172.31.0.2.nip.io</code></p> <p>The most relevant for a app developer is <code>Stitch: App Developer Dashboard</code> You should see panels about API's including:</p> <ul> <li>Request and error rates</li> <li>API summaries</li> <li>API request summaries</li> <li>API duration</li> </ul> <p>All corresponding to our HTTPRoute coming from our OAS spec</p>"},{"location":"api-quickstart/#platform-engineer-apis-summary-view","title":"(Platform Engineer) APIs summary view","text":"<p>Now that the app developer has deployed their app, new metrics and data is now available in the platform engineer dashboard seen in the previous step <code>https://grafana.172.31.0.2.nip.io</code>:</p> <ul> <li>Gateways, routes and policies</li> <li>Constraints &amp; Violations (there should be no violations present)</li> <li>APIs Summary</li> </ul>"},{"location":"api-quickstart/#summary","title":"Summary","text":"<p>You now have a local environment with a reference architecture to design and deploy an API in a kube native way, using Kuadrant and other open source tools.</p>"},{"location":"api-quickstart/#cleanup","title":"Cleanup","text":"<p>To destroy the previously created <code>kind</code> clusters, run:</p> <pre><code>./cleanup.sh\n</code></pre> <p>Info</p> <p>DNS records in AWS will remain after cleanup - you can remove these from your zone manually.</p>"},{"location":"kuadrantctl/","title":"kuadrantctl","text":"<p><code>kuadrantctl</code> is a CLI tool for managing Kuadrant configurations and resources.</p>"},{"location":"kuadrantctl/#installing","title":"Installing","text":"<p><code>kuadrantctl</code> can be installed either by downloading pre-compiled binaries or by compiling from source. For most users, downloading the binary is the easiest and recommended method.</p>"},{"location":"kuadrantctl/#installing-pre-compiled-binaries","title":"Installing Pre-compiled Binaries","text":"<ol> <li>Download the latest binary for your platform from the <code>kuadrantctl</code> Releases page.</li> <li>Unpack the binary.</li> <li>Move it to a directory in your <code>$PATH</code> so that it can be executed from anywhere.</li> </ol>"},{"location":"kuadrantctl/#compiling-from-source","title":"Compiling from Source","text":"<p>If you prefer to compile from source or are contributing to the project, you can install <code>kuadrantctl</code> using  <code>make install</code>. This method requires Golang 1.21 or newer.</p> <p>It is possible to use the make target <code>install</code> to compile from source. From root of the repository, run </p> <pre><code>make install\n</code></pre> <p>This will compile <code>kuadrantctl</code> and install it in the <code>bin</code> directory at root of directory. It will also ensure the correct version of the binary is displayed . It can be ran using <code>./bin/kuadrantctl</code> .  </p>"},{"location":"kuadrantctl/#usage","title":"Usage","text":"<p>Below is a high-level overview of its commands, along with links to detailed documentation for more complex commands.</p>"},{"location":"kuadrantctl/#general-syntax","title":"General Syntax","text":"<pre><code>kuadrantctl [command] [subcommand] [flags]\n</code></pre>"},{"location":"kuadrantctl/#commands-overview","title":"Commands Overview","text":"Command Description <code>completion</code> Generate autocompletion scripts for the specified shell <code>generate</code> Commands related to Kubernetes Gateway API and Kuadrant resource generation from OpenAPI 3.x specifications <code>help</code> Help about any command <code>version</code> Print the version number of <code>kuadrantctl</code>"},{"location":"kuadrantctl/#flags","title":"Flags","text":"Flag Description <code>-h</code>, <code>--help</code> Help for <code>kuadrantctl</code> <code>-v</code>, <code>--verbose</code> Enable verbose output"},{"location":"kuadrantctl/#commands-detail","title":"Commands Detail","text":""},{"location":"kuadrantctl/#completion","title":"<code>completion</code>","text":"<p>Generate an autocompletion script for the specified shell.</p> Subcommand Description <code>bash</code> Generate script for Bash <code>fish</code> Generate script for Fish <code>powershell</code> Generate script for PowerShell <code>zsh</code> Generate script for Zsh"},{"location":"kuadrantctl/#generate","title":"<code>generate</code>","text":"<p>Commands related to Kubernetes Gateway API and Kuadrant resource generation from OpenAPI 3.x specifications.</p> Subcommand Description <code>gatewayapi</code> Generate Gateway API resources <code>kuadrant</code> Generate Kuadrant resources"},{"location":"kuadrantctl/#generate-gatewayapi","title":"<code>generate gatewayapi</code>","text":"<p>Generate Gateway API resources from an OpenAPI 3.x specification</p> Subcommand Description Flags <code>httproute</code> Generate Gateway API HTTPRoute from OpenAPI 3.0.X <code>--oas string</code> Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required). <code>-o</code> Output format: 'yaml' or 'json'. (default \"yaml\")"},{"location":"kuadrantctl/#generate-kuadrant","title":"<code>generate kuadrant</code>","text":"<p>Generate Kuadrant resources from an OpenAPI 3.x specification</p> Subcommand Description Flags <code>authpolicy</code> Generate a Kuadrant AuthPolicy from an OpenAPI 3.0.x specification <code>--oas string</code> Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required). <code>-o</code> Output format: 'yaml' or 'json'. (default \"yaml\") <code>ratelimitpolicy</code> Generate Kuadrant RateLimitPolicy from an OpenAPI 3.0.x specification <code>--oas string</code> Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required). <code>-o</code> Output format: 'yaml' or 'json'. (default \"yaml\")"},{"location":"kuadrantctl/#version","title":"<code>version</code>","text":"<p>Print the version number of <code>kuadrantctl</code>.</p> <p>No additional flags or subcommands.</p>"},{"location":"kuadrantctl/#additional-guides","title":"Additional Guides","text":""},{"location":"kuadrantctl/#generating-gateway-api-httproute-objects","title":"Generating Gateway API HTTPRoute Objects","text":"<ul> <li>Generates Gateway API HTTPRoute objects from an OpenAPI Specification (OAS) 3.x.</li> <li>Supports reading from a file, URL, or stdin.</li> <li>Example usages and more information can be found in the detailed guide.</li> </ul>"},{"location":"kuadrantctl/#generating-kuadrant-authpolicy-objects","title":"Generating Kuadrant AuthPolicy Objects","text":"<ul> <li>Generates Kuadrant AuthPolicy objects for managing API authentication.</li> <li>Supports <code>openIdConnect</code> and <code>apiKey</code> types from the OpenAPI Security Scheme Object.</li> <li>Example usages and more information can be found in the detailed guide.</li> </ul>"},{"location":"kuadrantctl/#generating-kuadrant-ratelimitpolicy-objects","title":"Generating Kuadrant RateLimitPolicy Objects","text":"<ul> <li>Generates Kuadrant RateLimitPolicy objects for managing API rate limiting.</li> <li>Supports reading from a file, URL, or stdin.</li> <li>Example usages and more information can be found in the detailed guide.</li> </ul> <p>For more detailed information about each command, including options and usage examples, use <code>kuadrantctl [command] --help</code>.</p>"},{"location":"kuadrantctl/#using-with-github-actions","title":"Using with GitHub Actions","text":"<pre><code>- name: Install kuadrantctl\n  uses: jaxxstorm/action-install-gh-release@v1.10.0\n  with: # Grab the latest version\n    repo: Kuadrant/kuadrantctl\n</code></pre>"},{"location":"kuadrantctl/#commands","title":"Commands","text":"<ul> <li>Generate Gateway API HTTPRoute objects from OpenAPI 3.X</li> <li>Generate Kuadrant RateLimitPolicy from OpenAPI 3.X</li> <li>Generate Kuadrant AuthPolicy from OpenAPI 3.X</li> </ul>"},{"location":"kuadrantctl/#contributing","title":"Contributing","text":"<p>The Development guide describes how to build the kuadrantctl CLI and how to test your changes before submitting a patch or opening a PR.</p>"},{"location":"kuadrantctl/#licensing","title":"Licensing","text":"<p>This software is licensed under the Apache 2.0 license.</p> <p>See the LICENSE and NOTICE files that should have been provided along with this software for details.</p>"},{"location":"kuadrantctl/doc/RELEASE/","title":"RELEASE","text":""},{"location":"kuadrantctl/doc/RELEASE/#release","title":"Release","text":"<p>The release process follows a streamlined approach, no release branches involved. New releases can be major, minor or patch based releases, but always incrementing digits regarding the latest release version.</p>"},{"location":"kuadrantctl/doc/RELEASE/#new-majorminorpatch-version","title":"New Major.Minor.Patch version","text":"<ol> <li>Create a new minor release branch from the HEAD of main: <pre><code>git checkout -b release-vX.Y.Z\n</code></pre></li> <li>Update version (prefixed with \"v\"): <pre><code>make prepare-release VERSION=vX.Y.Z\n</code></pre></li> <li>Verify local changes: <pre><code>make install\nbin/kuadrantctl version\n</code></pre> The output should be the new version, for example : <pre><code>kuadrantctl v0.3.0 (ff779a1-dirty)\n</code></pre></li> <li>Commit and push: <pre><code>git add .\ngit commit -m \"prepare-release: release-vX.Y.Z\"\ngit push origin release-vX.Y.Z\n</code></pre></li> <li>Create git tag: <pre><code>git tag -s -m vX.Y.Z vX.Y.Z\ngit push origin vX.Y.Z\n</code></pre></li> <li> <p>In Github, create release.</p> </li> <li> <p>Pick recently pushed git tag</p> </li> <li>Automatically generate release notes from previous released tag</li> <li> <p>Set as the latest release</p> </li> <li> <p>Verify that the build Release workflow is triggered and completes for the new tag</p> </li> </ol>"},{"location":"kuadrantctl/doc/RELEASE/#verify-new-release-is-available","title":"Verify new release is available","text":"<ol> <li>Download the latest binary for your platform from the <code>kuadrantctl</code> Latest Releases page.</li> <li>Unpack the binary.</li> <li>Move it to a directory in your <code>$PATH</code> so that it can be executed from anywhere.</li> <li>Check the version: <pre><code>kuadrantctl version\n</code></pre> The output should be the new version, for example : <pre><code>kuadrantctl v0.3.0 (eec318b2e11e7ea5add5e550ff872bde64555d8f)\n</code></pre></li> </ol>"},{"location":"kuadrantctl/doc/development/","title":"Development Guide","text":""},{"location":"kuadrantctl/doc/development/#technology-stack-required-for-development","title":"Technology stack required for development","text":"<ul> <li>git</li> <li>go version 1.21+</li> </ul>"},{"location":"kuadrantctl/doc/development/#build-the-cli","title":"Build the CLI","text":"<pre><code>$ git clone https://github.com/kuadrant/kuadrantctl.git\n$ cd kuadrantctl &amp;&amp; make install\n$ bin/kuadrantctl version\n{\"level\":\"info\",\"ts\":\"2023-11-08T23:44:57+01:00\",\"msg\":\"kuadrantctl version: latest\"}\n</code></pre>"},{"location":"kuadrantctl/doc/development/#quick-steps-to-contribute","title":"Quick steps to contribute","text":"<ul> <li>Fork the project.</li> <li>Download your fork to your PC (<code>git clone https://github.com/your_username/kuadrantctl &amp;&amp; cd kuadrantctl</code>)</li> <li>Create your feature branch (<code>git checkout -b my-new-feature</code>)</li> <li>Make changes and run tests (<code>make test</code>)</li> <li>Add them to staging (<code>git add .</code>)</li> <li>Commit your changes (<code>git commit -m 'Add some feature'</code>)</li> <li>Push to the branch (<code>git push origin my-new-feature</code>)</li> <li>Create new pull request</li> </ul>"},{"location":"kuadrantctl/doc/generate-gateway-api-httproute/","title":"Generating Gateway API HTTPRoutes","text":""},{"location":"kuadrantctl/doc/generate-gateway-api-httproute/#generate-gateway-api-httproute-object-from-openapi-3","title":"Generate Gateway API HTTPRoute object from OpenAPI 3","text":"<p>The <code>kuadrantctl generate gatewayapi httproute</code> command generates an Gateway API HTTPRoute from your OpenAPI Specification (OAS) 3.x powered with kuadrant extensions.</p>"},{"location":"kuadrantctl/doc/generate-gateway-api-httproute/#openapi-specification","title":"OpenAPI specification","text":"<p>An OpenAPI document resource can be provided to the cli by one of the following channels:</p> <ul> <li>Filename in the available path.</li> <li>URL format (supported schemes are HTTP and HTTPS). The CLI will try to download from the given address.</li> <li>Read from stdin standard input stream.</li> </ul>"},{"location":"kuadrantctl/doc/generate-gateway-api-httproute/#usage","title":"Usage","text":"<pre><code>$ kuadrantctl generate gatewayapi httproute -h\nGenerate Gateway API HTTPRoute from OpenAPI 3.0.X\n\nUsage:\n  kuadrantctl generate gatewayapi httproute [flags]\n\nFlags:\n  -h, --help          help for httproute\n  --oas string        Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required)\n  -o Output format:   'yaml' or 'json'. (default \"yaml\")\n\nGlobal Flags:\n  -v, --verbose   verbose output\n</code></pre> <p>Under the example folder there are examples of OAS 3 that can be used to generate the resources</p> <p>As an AuthPolicy and RateLimitPolicy both require a HTTPRoute to target, the user guides for generating those policies include examples of running the <code>kuadrantctl generate gatewayapi httproute</code> command.</p> <p>You can find those guides here:</p> <ul> <li>Generate Kuadrant AuthPolicy</li> <li>Generate Kuadrant RateLimitPolicy</li> </ul>"},{"location":"kuadrantctl/doc/generate-kuadrant-auth-policy/","title":"Generating Kuadrant AuthPolicies","text":""},{"location":"kuadrantctl/doc/generate-kuadrant-auth-policy/#generate-kuadrant-authpolicy-object-from-openapi-3","title":"Generate Kuadrant AuthPolicy object from OpenAPI 3","text":"<p>The <code>kuadrantctl generate kuadrant authpolicy</code> command generates an Kuadrant AuthPolicy from your OpenAPI Specification (OAS) 3.x powered with kuadrant extensions.</p>"},{"location":"kuadrantctl/doc/generate-kuadrant-auth-policy/#openapi-specification","title":"OpenAPI specification","text":"<p>An OpenAPI document resource can be provided to the cli by one of the following channels:</p> <ul> <li>Filename in the available path.</li> <li>URL format (supported schemes are HTTP and HTTPS). The CLI will try to download from the given address.</li> <li>Read from stdin standard input stream.</li> </ul> <p>OpenAPI Security Scheme Object types</p> Types Implemented <code>openIdConnect</code> YES <code>apiKey</code> YES <code>http</code> NO <code>oauth2</code> NO"},{"location":"kuadrantctl/doc/generate-kuadrant-auth-policy/#openidconnect-type-description","title":"<code>openIdConnect</code> Type Description","text":"<p>The following OAS example has one protected endpoint <code>GET /dog</code> with <code>openIdConnect</code> security scheme type.</p> <pre><code>paths:\n  /dog:\n    get:\n      operationId: \"getDog\"\n      security:\n\n        - securedDog: []\n      responses:\n        405:\n          description: \"invalid input\"\ncomponents:\n  securitySchemes:\n    securedDog:\n      type: openIdConnect\n      openIdConnectUrl: https://example.com/.well-known/openid-configuration\n</code></pre> <p>Running the command</p> <pre><code>kuadrantctl generate kuadrant authpolicy --oas ./petstore-openapi.yaml  | yq -P\n</code></pre> <p>The generated authpolicy (only relevan fields shown here):</p> <pre><code>kind: AuthPolicy\napiVersion: kuadrant.io/v1beta2\nmetadata:\n  name: petstore\n  namespace: petstore\n  creationTimestamp: null\nspec:\n  routeSelectors:\n\n    - matches:\n        - path:\n            type: Exact\n            value: /api/v1/dog\n          method: GET\n  rules:\n    authentication:\n      getDog_securedDog:\n        credentials: {}\n        jwt:\n          issuerUrl: https://example.com/.well-known/openid-configuration\n        routeSelectors:\n          - matches:\n              - path:\n                  type: Exact\n                  value: /api/v1/dog\n                method: GET\n</code></pre>"},{"location":"kuadrantctl/doc/generate-kuadrant-auth-policy/#apikey-type-description","title":"<code>apiKey</code> Type Description","text":"<p>The following OAS example has one protected endpoint <code>GET /dog</code> with <code>apiKey</code> security scheme type.</p> <pre><code>paths:\n  /dog:\n    get:\n      operationId: \"getDog\"\n      security:\n\n        - securedDog: []\n      responses:\n        405:\n          description: \"invalid input\"\ncomponents:\n  securitySchemes:\n    securedDog:\n      type: apiKey\n      name: dog_token\n      in: query\n</code></pre> <p>Running the command</p> <pre><code>kuadrantctl generate kuadrant authpolicy --oas ./petstore-openapi.yaml  | yq -P\n</code></pre> <p>The generated authpolicy (only relevan fields shown here):</p> <pre><code>kind: AuthPolicy\napiVersion: kuadrant.io/v1beta2\nmetadata:\n  name: petstore\n  namespace: petstore\n  creationTimestamp: null\nspec:\n  routeSelectors:\n\n    - matches:\n        - path:\n            type: Exact\n            value: /dog\n          method: GET\n  rules:\n    authentication:\n      getDog_securedDog:\n        credentials:\n          queryString:\n            name: dog_token\n          apiKey:\n            selector:\n              matchLabels:\n                kuadrant.io/apikeys-by: securedDog\n        routeSelectors:\n          - matches:\n              - path:\n                  type: Exact\n                  value: /dog\n                method: GET\n</code></pre> <p>In this particular example, the endpoint <code>GET /dog</code> will be protected. The token needs to be in the query string of the request included in a parameter named <code>dog_token</code>. Kuadrant will validate received tokens against tokens found in kubernetes secrets with label <code>kuadrant.io/apikeys-by: ${sec scheme name}</code>. In this particular example the label selector will be: <code>kuadrant.io/apikeys-by: securedDog</code>.</p> <p>Like the following example:</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: api-key-1\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    kuadrant.io/apikeys-by: securedDog\nstringData:\n  api_key: MYSECRETTOKENVALUE\ntype: Opaque\n</code></pre> <p>Note: Kuadrant validates tokens against api keys found in secrets. The label selector format <code>kuadrant.io/apikeys-by: ${sec scheme name}</code> is arbitrary and designed for this CLI command.</p> <p>For more information about Kuadrant auth based on api key: https://docs.kuadrant.io/latest/authorino/docs/user-guides/api-key-authentication/</p>"},{"location":"kuadrantctl/doc/generate-kuadrant-auth-policy/#usage","title":"Usage","text":"<pre><code>Generate Kuadrant AuthPolicy from OpenAPI 3.0.X\n\nUsage:\n  kuadrantctl generate kuadrant authpolicy [flags]\n\nFlags:\n  -h, --help         help for authpolicy\n  --oas string        Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required)\n  -o Output format:   'yaml' or 'json'. (default \"yaml\")\n\nGlobal Flags:\n  -v, --verbose   verbose output\n</code></pre> <p>Under the example folder there are examples of OAS 3 that can be used to generate the resources</p>"},{"location":"kuadrantctl/doc/generate-kuadrant-auth-policy/#user-guide","title":"User Guide","text":"<p>The verification steps will lead you to the process of deploying and testing the following api with endpoints protected using different security schemes:</p> Operation Security Scheme <code>GET /api/v1/cat</code> public (not auth) <code>POST /api/v1/cat</code> ApiKey in header <code>GET /api/v1/dog</code> OpenIdConnect <code>GET /api/v1/snake</code> OpenIdConnect OR ApiKey in query string <ul> <li>[Optional] Setup SSO service supporting OIDC. For this example, we will be using keycloak.</li> <li>Create a new realm <code>petstore</code></li> <li>Create a client <code>petstore</code>. In the Client Protocol field, select <code>openid-connect</code>.</li> <li>Configure client settings. Access Type to public. Direct Access Grants Enabled to ON (for this example password will be used directly to generate the token).</li> <li>Add a user to the realm<ul> <li>Click the Users menu on the left side of the window.  Click Add user.</li> <li>Type the username <code>bob</code>, set the Email Verified switch to ON, and click Save.</li> <li>On the Credentials tab, set the password <code>p</code>. Enter the password in both the fields, set the Temporary switch to OFF to avoid the password reset at the next login, and click <code>Set Password</code>.</li> </ul> </li> </ul> <p>Now, let's run local cluster to test the kuadrantctl new command to generate authpolicy.</p> <ul> <li>Clone the repo</li> </ul> <pre><code>git clone https://github.com/Kuadrant/kuadrantctl.git\ncd kuadrantctl\n</code></pre> <ul> <li>Setup a cluster, Istio and Gateway API CRDs and Kuadrant</li> </ul> <p>Use our single-cluster quick start script - this will install Kuadrant in a local <code>kind</code> cluster: https://docs.kuadrant.io/latest/getting-started-single-cluster/</p> <ul> <li>Build and install CLI in <code>bin/kuadrantctl</code> path</li> </ul> <pre><code>make install\n</code></pre> <ul> <li>Deploy petstore backend API</li> </ul> <pre><code>kubectl create namespace petstore\nkubectl apply -n petstore -f examples/petstore/petstore.yaml\n</code></pre> <ul> <li>Let's create Petstore's OpenAPI spec</li> </ul> <pre><code>cat &lt;&lt;EOF &gt;petstore-openapi.yaml\n---\nopenapi: \"3.1.0\"\ninfo:\n  title: \"Pet Store API\"\n  version: \"1.0.0\"\nx-kuadrant:\n  route:\n    name: \"petstore\"\n    namespace: \"petstore\"\n    hostnames:\n\n      - example.com\n    parentRefs:\n      - name: istio-ingressgateway\n        namespace: istio-system\nservers:\n  - url: https://example.io/api/v1\npaths:\n  /cat:\n    x-kuadrant:\n      backendRefs:\n        - name: petstore\n          port: 80\n          namespace: petstore\n    get:  # No sec requirements\n      operationId: \"getCat\"\n      responses:\n        405:\n          description: \"invalid input\"\n    post:  # API key\n      operationId: \"postCat\"\n      security:\n        - cat_api_key: []\n      responses:\n        405:\n          description: \"invalid input\"\n  /dog:\n    x-kuadrant:\n      backendRefs:\n        - name: petstore\n          port: 80\n          namespace: petstore\n    get:  # OIDC\n      operationId: \"getDog\"\n      security:\n        - oidc:\n          - read:dogs\n      responses:\n        405:\n          description: \"invalid input\"\n  /snake:\n    x-kuadrant:\n      backendRefs:\n        - name: petstore\n          port: 80\n          namespace: petstore\n    get:  # OIDC or API key\n      operationId: \"getSnake\"\n      security:\n        - oidc: [\"read:snakes\"]\n        - snakes_api_key: []\n      responses:\n        405:\n          description: \"invalid input\"\ncomponents:\n  securitySchemes:\n    cat_api_key:\n      type: apiKey\n      name: api_key\n      in: header\n    oidc:\n      type: openIdConnect\n      openIdConnectUrl: https://${KEYCLOAK_PUBLIC_DOMAIN}/auth/realms/petstore\n    snakes_api_key:\n      type: apiKey\n      name: snake_token\n      in: query\nEOF\n</code></pre> <p>Replace <code>${KEYCLOAK_PUBLIC_DOMAIN}</code> with your SSO instance domain</p> <ul> <li> <p>Create an API key only valid for <code>POST /api/v1/cat</code> endpoint <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: cat-api-key-1\n  namespace: petstore\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    kuadrant.io/apikeys-by: cat_api_key\nstringData:\n  api_key: I_LIKE_CATS\ntype: Opaque\nEOF\n</code></pre></p> <p>Note: the label's value of <code>kuadrant.io/apikeys-by: cat_api_key</code> is the name of the sec scheme of the OpenAPI spec.</p> </li> <li> <p>Create an API key only valid for <code>GET /api/v1/snake</code> endpoint</p> </li> </ul> <pre><code>kubectl apply -f -&lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: snake-api-key-1\n  namespace: petstore\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    kuadrant.io/apikeys-by: snakes_api_key\nstringData:\n  api_key: I_LIKE_SNAKES\ntype: Opaque\nEOF\n</code></pre> <p>Note: the label's value of <code>kuadrant.io/apikeys-by: snakes_api_key</code> is the name of the sec scheme of the OpenAPI spec.</p> <ul> <li>Create the HTTPRoute using the CLI</li> </ul> <pre><code>bin/kuadrantctl generate gatewayapi httproute --oas petstore-openapi.yaml | kubectl apply -n petstore -f -\n</code></pre> <ul> <li>Create Kuadrant's Auth Policy</li> </ul> <pre><code>bin/kuadrantctl generate kuadrant authpolicy --oas petstore-openapi.yaml | kubectl apply -n petstore -f -\n</code></pre> <p>Now, we are ready to test OpenAPI endpoints </p> <ul> <li><code>GET /api/v1/cat</code> -&gt; It's a public endpoint, hence should return 200 Ok</li> </ul> <pre><code>curl  -H \"Host: example.com\" -i \"http://127.0.0.1:9080/api/v1/cat\"\n</code></pre> <ul> <li><code>POST /api/v1/cat</code> -&gt; It's a protected endpoint with apikey</li> </ul> <p>Without any credentials, it should return <code>401 Unauthorized</code></p> <pre><code>curl  -H \"Host: example.com\" -X POST -i \"http://127.0.0.1:9080/api/v1/cat\"\n</code></pre> <pre><code>HTTP/1.1 401 Unauthorized\nwww-authenticate: Bearer realm=\"getDog_oidc\"\nwww-authenticate: Bearer realm=\"getSnake_oidc\"\nwww-authenticate: snake_token realm=\"getSnake_snakes_api_key\"\nwww-authenticate: api_key realm=\"postCat_cat_api_key\"\nx-ext-auth-reason: {\"postCat_cat_api_key\":\"credential not found\"}\ndate: Tue, 28 Nov 2023 22:28:44 GMT\nserver: istio-envoy\ncontent-length: 0\n</code></pre> <p>The reason headers tell that <code>credential not found</code>. Credentials satisfying <code>postCat_cat_api_key</code> authentication is needed.</p> <p>According to the OpenAPI spec, it should be a header named <code>api_key</code>. What if we try a wrong token? one token assigned to other endpoint, i.e. <code>I_LIKE_SNAKES</code> instead of the valid one <code>I_LIKE_CATS</code>. It should return <code>401 Unauthorized</code>.</p> <pre><code>curl  -H \"Host: example.com\" -H \"api_key: I_LIKE_SNAKES\" -X POST -i \"http://127.0.0.1:9080/api/v1/cat\"\n</code></pre> <pre><code>HTTP/1.1 401 Unauthorized\nwww-authenticate: Bearer realm=\"getDog_oidc\"\nwww-authenticate: Bearer realm=\"getSnake_oidc\"\nwww-authenticate: snake_token realm=\"getSnake_snakes_api_key\"\nwww-authenticate: api_key realm=\"postCat_cat_api_key\"\nx-ext-auth-reason: {\"postCat_cat_api_key\":\"the API Key provided is invalid\"}\ndate: Tue, 28 Nov 2023 22:32:55 GMT\nserver: istio-envoy\ncontent-length: 0\n</code></pre> <p>The reason headers tell that <code>the API Key provided is invalid</code>. Using valid token (from the secret <code>cat-api-key-1</code> assigned to <code>POST /api/v1/cats</code>) in the <code>api_key</code> header should return 200 Ok</p> <pre><code>curl  -H \"Host: example.com\" -H \"api_key: I_LIKE_CATS\" -X POST -i \"http://127.0.0.1:9080/api/v1/cat\"\n</code></pre> <ul> <li><code>GET /api/v1/dog</code> -&gt; It's a protected endpoint with oidc (assigned to our keycloak instance and <code>petstore</code> realm)</li> </ul> <p>without credentials, it should return <code>401 Unauthorized</code></p> <pre><code>curl -H \"Host: example.com\" -i \"http://127.0.0.1:9080/api/v1/dog\"\n</code></pre> <p>To get the authentication token, this example is using Direct Access Grants oauth2 grant type (also known as Client Credentials grant type). When configuring the Keycloak (OIDC provider) client settings, we enabled Direct Access Grants to enable this procedure. We will be authenticating as <code>bob</code> user with <code>p</code> password. We previously created <code>bob</code> user in Keycloak in the <code>petstore</code> realm.</p> <pre><code>export ACCESS_TOKEN=$(curl -k -H \"Content-Type: application/x-www-form-urlencoded\" \\\n        -d 'grant_type=password' \\\n        -d 'client_id=petstore' \\\n        -d 'scope=openid' \\\n        -d 'username=bob' \\\n        -d 'password=p' \"https://${KEYCLOAK_PUBLIC_DOMAIN}/auth/realms/petstore/protocol/openid-connect/token\" | jq -r '.access_token')\n</code></pre> <p>Replace <code>${KEYCLOAK_PUBLIC_DOMAIN}</code> with your SSO instance domain</p> <p>With the access token in place, let's try to get those puppies</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -H 'Host: example.com' http://127.0.0.1:9080/api/v1/dog -i\n</code></pre> <p>it should return 200 OK</p> <ul> <li><code>GET /api/v1/snake</code> -&gt; It's a protected endpoint with oidc (assigned to our keycloak instance and <code>petstore</code> realm) OR with apiKey</li> </ul> <p>This example is to show that multiple security requirements (with OR semantics) can be specified for an OpenAPI operation.</p> <p>Without credentials, it should return <code>401 Unauthorized</code></p> <pre><code>curl -H \"Host: example.com\" -i \"http://127.0.0.1:9080/api/v1/snake\"\n</code></pre> <p>With the access token in place, it should return 200 OK (unless the token has expired).</p> <pre><code>curl -H \"Authorization: Bearer $ACCESS_TOKEN\" -H 'Host: example.com' http://127.0.0.1:9080/api/v1/snake -i\n</code></pre> <p>With apiKey it should also work. According to the OpenAPI spec security scheme, it should be a query string named <code>snake_token</code> and the token needs to be valid token (from the secret <code>snake-api-key-1</code> assigned to <code>GET /api/v1/snake</code>)</p> <pre><code>curl -H 'Host: example.com' -i \"http://127.0.0.1:9080/api/v1/snake?snake_token=I_LIKE_SNAKES\"\n</code></pre>"},{"location":"kuadrantctl/doc/generate-kuadrant-rate-limit-policy/","title":"Generating Kuadrant RateLimitPolicies","text":""},{"location":"kuadrantctl/doc/generate-kuadrant-rate-limit-policy/#generate-kuadrant-ratelimitpolicy-object-from-openapi-3","title":"Generate Kuadrant RateLimitPolicy object from OpenAPI 3","text":"<p>The <code>kuadrantctl generate kuadrant ratelimitpolicy</code> command generates a Kuadrant RateLimitPolicy from your OpenAPI Specification (OAS) 3.x document powered with Kuadrant extensions.</p>"},{"location":"kuadrantctl/doc/generate-kuadrant-rate-limit-policy/#openapi-specification","title":"OpenAPI specification","text":"<p>An OpenAPI document resource can be provided to the Kuadrant CLI in one of the following ways:</p> <ul> <li>Filename in the available path.</li> <li>URL format (supported schemes are HTTP and HTTPS). The CLI will try to download from the given address.</li> <li>Read from <code>stdin</code> standard input stream.</li> </ul>"},{"location":"kuadrantctl/doc/generate-kuadrant-rate-limit-policy/#usage","title":"Usage","text":"<pre><code>Generate Kuadrant RateLimitPolicy from OpenAPI 3.0.x\n\nUsage:\n  kuadrantctl generate kuadrant ratelimitpolicy [flags]\n\nFlags:\n  -h, --help         help for ratelimitpolicy\n  --oas string        Path to OpenAPI spec file (in JSON or YAML format), URL, or '-' to read from standard input (required)\n  -o Output format:   'yaml' or 'json'. (default \"yaml\")\n\nGlobal Flags:\n  -v, --verbose   verbose output\n</code></pre> <p>Note: The <code>kuadrantctl/examples</code> directory in GitHub includes sample OAS 3 files that you can use to generate the resources.</p>"},{"location":"kuadrantctl/doc/generate-kuadrant-rate-limit-policy/#procedure","title":"Procedure","text":"<ol> <li> <p>Clone the Git repository as follows:  <pre><code>git clone https://github.com/Kuadrant/kuadrantctl.git\ncd kuadrantctl\n ```\n2. Set up a cluster, Istio and Gateway API CRDs, and Kuadrant as follows: \n\n\n* Use the single-cluster quick start script to install Kuadrant in a local `kind` cluster: https://docs.kuadrant.io/latest/getting-started-single-cluster/.\n\n\n3. Build and install the CLI in `bin/kuadrantctl` path as follows:\n```bash\nmake install\n</code></pre></p> </li> <li> <p>Deploy the Petstore backend API as follows: <pre><code>kubectl create namespace petstore\nkubectl apply -n petstore -f examples/petstore/petstore.yaml\n</code></pre></p> </li> <li> <p>Create the Petstore OpenAPI definition as follows:</p> </li> </ol> <pre><code>cat &lt;&lt;EOF &gt;petstore-openapi.yaml\n---\nopenapi: \"3.0.3\"\ninfo:\n  title: \"Pet Store API\"\n  version: \"1.0.0\"\nx-kuadrant:  ## Root-level Kuadrant extension\n  route:\n    name: \"petstore\"\n    namespace: \"petstore\"\n    hostnames:\n\n      - example.com\n    parentRefs:\n      - name: istio-ingressgateway\n        namespace: istio-system\nservers:\n  - url: https://example.io/v1\npaths:\n  /cat:\n    x-kuadrant:  ## Path-level Kuadrant extension\n      backendRefs:\n        - name: petstore\n          port: 80\n          namespace: petstore\n      rate_limit:\n        rates:\n          - limit: 1\n            duration: 10\n            unit: second\n        counters:\n          - request.headers.x-forwarded-for\n    get:  # Added to the route and rate limited\n      operationId: \"getCat\"\n      responses:\n        405:\n          description: \"invalid input\"\n    post:  # NOT added to the route\n      x-kuadrant: \n        disable: true\n      operationId: \"postCat\"\n      responses:\n        405:\n          description: \"invalid input\"\n  /dog:\n    get:  # Added to the route and rate limited\n      x-kuadrant:  ## Operation-level Kuadrant extension\n        backendRefs:\n          - name: petstore\n            port: 80\n            namespace: petstore\n        rate_limit:\n          rates:\n            - limit: 3\n              duration: 10\n              unit: second\n          counters:\n            - request.headers.x-forwarded-for\n      operationId: \"getDog\"\n      responses:\n        405:\n          description: \"invalid input\"\n    post:  # Added to the route and NOT rate limited\n      x-kuadrant:  ## Operation-level Kuadrant extension\n        backendRefs:\n          - name: petstore\n            port: 80\n            namespace: petstore\n      operationId: \"postDog\"\n      responses:\n        405:\n          description: \"invalid input\"\nEOF\n</code></pre> <p>Note: The <code>servers</code> base path is not included. This is work-in-progress in follow-up PRs.</p> Operation Applied configuration <code>GET /cat</code> Should return 200 OK and be rate limited (1 req / 10 seconds). <code>POST /cat</code> Not added to the HTTPRoute. Should return 404 Not Found. <code>GET /dog</code> Should return 200 OK and be rate limited (3 req / 10 seconds). <code>POST /dog</code> Should return 200 OK and NOT rate limited. <ol> <li> <p>Create the HTTPRoute by using the CLI as follows: <pre><code>bin/kuadrantctl generate gatewayapi httproute --oas petstore-openapi.yaml | kubectl apply -n petstore -f -\n</code></pre></p> </li> <li> <p>Create the rate limit policy as follows: <pre><code>bin/kuadrantctl generate kuadrant ratelimitpolicy --oas petstore-openapi.yaml | kubectl apply -n petstore -f -\n</code></pre></p> </li> <li> <p>Test the OpenAPI endpoints as follows:</p> </li> <li> <p><code>GET /cat</code> - Should return 200 OK and be rate limited (1 req / 10 seconds). <pre><code>curl --resolve example.com:9080:127.0.0.1 -v \"http://example.com:9080/cat\"\n</code></pre></p> </li> <li><code>POST /cat</code> - Not added to the HTTPRoute. Should return 404 Not Found. <pre><code>curl --resolve example.com:9080:127.0.0.1 -v -X POST \"http://example.com:9080/cat\"\n</code></pre></li> <li><code>GET /dog</code> - Should return 200 OK and be rate limited (3 req / 10 seconds).</li> </ol> <pre><code>curl --resolve example.com:9080:127.0.0.1 -v \"http://example.com:9080/dog\"\n</code></pre> <ul> <li><code>POST /dog</code> - Should return 200 OK and NOT rate limited.</li> </ul> <pre><code>curl --resolve example.com:9080:127.0.0.1 -v -X POST \"http://example.com:9080/dog\"\n</code></pre>"},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/","title":"kuadrantctl - CI/CD with Tekton and Argo CD","text":"<p>This guide demonstrates setting up a CI/CD pipeline by using Tekton to deploy Kubernetes Gateway API and Kuadrant resources generated by <code>kuadrantctl</code>, from an OpenAPI definition. In this example, these resources are applied directly to the cluster where Tekton is running.</p>"},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kuadrant, and all of its prerequisites, installed on a Kubernetes or OpenShift cluster.</li> <li>Tekton Pipelines installed on your cluster.</li> <li><code>kubectl</code> configured with access to communicate with your cluster.</li> <li>Optional: Tekton CLI <code>tkn</code> for easier interaction with Tekton resources.</li> </ul>"},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/#procedure","title":"Procedure","text":""},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/#step-1-set-up-your-namespace","title":"Step 1 - Set up your namespace","text":"<p>Create a dedicated namespace as follows:</p> <pre><code>kubectl create namespace petstore\n</code></pre>"},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/#step-2-create-a-persistent-volume-claim","title":"Step 2 - Create a Persistent Volume Claim","text":"<p>For this example, to store associated Tekton build artifacts, create a Persistent Volume Claim (PVC) in the <code>petstore</code> namespace as follows:</p> <pre><code>kubectl apply -n petstore -f - &lt;&lt;EOF\napiVersion: v1\nkind: PersistentVolumeClaim\nmetadata:\n  name: tekton-kuadrantctl-pvc\n  namespace: petstore\nspec:\n  accessModes:\n\n    - ReadWriteOnce\n  resources:\n    requests:\n      storage: 1Gi\nEOF\n</code></pre>"},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/#step-3-define-the-tekton-task","title":"Step 3 - Define the Tekton Task","text":"<p>Define the task that outlines steps to clone a repository, generate Kuadrant and Kubernetes resources by using <code>kuadrantctl</code>, and apply them directly to the cluster as follows:</p> <pre><code>kubectl apply -f - &lt;&lt;'EOF'\napiVersion: tekton.dev/v1beta1\nkind: Task\nmetadata:\n  name: run-kuadrantctl\n  namespace: petstore\nspec:\n  params:\n\n    - name: gitRepoUrl\n      description: URL of the git repository to clone\n    - name: gitRevision\n      description: Git revision to checkout (branch, tag, sha)\n  workspaces:\n    - name: source\n      description: Workspace to checkout the git repo\n    - name: kubeconfig\n      description: Workspace containing kubeconfig for Kubernetes cluster access\n  steps:\n    - name: clean-workspace\n      image: alpine:latest\n      script: |\n        sh -c 'rm -rf $(workspaces.source.path)/* $(workspaces.source.path)/.[!.]* $(workspaces.source.path)/..?*'\n    - name: clone\n      image: alpine/git:latest\n      script: |\n        git clone $(params.gitRepoUrl) $(workspaces.source.path)\n        cd $(workspaces.source.path)\n        git checkout $(params.gitRevision)\n    - name: download-kuadrantctl\n      image: curlimages/curl:latest\n      script: |\n        ARCH=$(uname -m)\n        case $ARCH in\n        x86_64) BIN_ARCH=\"amd64\";;\n        arm64) BIN_ARCH=\"arm64\";;\n        aarch64) BIN_ARCH=\"arm64\";;\n        *) echo \"Unsupported architecture: $ARCH\" &amp;&amp; exit 1 ;;\n        esac\n        cd $(workspaces.source.path)\n        curl -LO \"https://github.com/Kuadrant/kuadrantctl/releases/download/v0.2.3/kuadrantctl-v0.2.3-linux-$BIN_ARCH.tar.gz\"\n        tar -xzf kuadrantctl-v0.2.3-linux-$BIN_ARCH.tar.gz\n    - name: run-kuadrantctl\n      image: alpine:latest\n      script: |\n        cd $(workspaces.source.path)\n        mkdir -p generated-resources\n        ./kuadrantctl generate kuadrant authpolicy --oas openapi.yaml | tee generated-resources/authpolicy.yaml\n        ./kuadrantctl generate kuadrant ratelimitpolicy --oas openapi.yaml |  tee generated-resources/ratelimitpolicy.yaml\n        ./kuadrantctl generate gatewayapi httproute --oas openapi.yaml | tee generated-resources/httproute.yaml\n    - name: apply-resources\n      image: bitnami/kubectl\n      script: |\n        cd $(workspaces.source.path)\n        export KUADRANT_ZONE_ROOT_DOMAIN=example.com # domain name used in the HTTPRoute for the petstore sample app\n        for file in ./generated-resources/*.yaml; do\n          envsubst &lt; \"$file\" | kubectl apply -n petstore -f - \n        done\nEOF\n</code></pre> <p>Note: This example uses Tekton with <code>kubectl</code> to apply resources to a cluster. It is best to use a tool such as Argo CD to implement continuous delivery by using a GitOps approach. In this scenario, you would do the following:</p> <ul> <li>Use <code>kuadrantctl</code> to generate Kubernetes and Kuadrant resources as part a Tekton pipeline.</li> <li>Commit these new resources to a Git repository.</li> <li>Use ArgoCD to sync these changes from the Git repository to a Kubernetes or OpenShift cluster.</li> </ul>"},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/#step-4-create-a-kubeconfig-secret","title":"Step 4 - Create a Kubeconfig secret","text":"<p>Important: While this guide uses a <code>kubeconfig</code> secret for simplicity, do not use this in production environments. Instead, use a service account for enhanced security.</p> <p>This example uses a <code>kubeconfig</code> secret and role bindings to demonstrate how to provide access for pushing generated resources to a cluster. However, for production setups, employing a service account is best.</p> <p>To proceed, create a <code>kubeconfig</code> secret in the <code>petstore</code> namespace to provide Tekton with access to your Kubernetes cluster as follows:</p> <pre><code>kubectl create secret generic kubeconfig-secret --from-file=kubeconfig=/path/to/.kube/config -n petstore\n</code></pre> <p>Create an associated <code>ClusterRole</code> and <code>ClusterRoleBinding</code> as follows:</p> <pre><code>kubectl apply -n petstore -f - &lt;&lt;EOF\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRole\nmetadata:\n  name: kuadrant-ci-example-full-access\nrules:\n\n- apiGroups: [\"*\"]\n  resources: [\"*\"]\n  verbs: [\"*\"]\n---\napiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRoleBinding\nmetadata:\n  name: kuadrant-ci-example-full-access-binding\nsubjects:\n- kind: ServiceAccount\n  name: default\n  namespace: petstore\nroleRef:\n  kind: ClusterRole\n  name: kuadrant-ci-example-full-access\n  apiGroup: rbac.authorization.k8s.io\nEOF\n</code></pre>"},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/#step-5-trigger-the-taskrun","title":"Step 5 - Trigger the TaskRun","text":"<p>Execute the task from the <code>petstore</code> namespace, referencing the <code>kubeconfig</code> secret for cluster access as follows:</p> <p>This example runs this task with the Kuadrant Petstore app: https://github.com/kuadrant/api-petstore.</p> <pre><code>kubectl apply -n petstore -f - &lt;&lt;EOF\napiVersion: tekton.dev/v1beta1\nkind: TaskRun\nmetadata:\n  name: run-kuadrantctl-taskrun\n  namespace: petstore\nspec:\n  taskRef:\n    name: run-kuadrantctl\n  params:\n\n    - name: gitRepoUrl\n      value: \"https://github.com/kuadrant/api-petstore.git\"\n    - name: gitRevision\n      value: \"main\"\n  workspaces:\n    - name: source\n      persistentVolumeClaim:\n        claimName: tekton-kuadrantctl-pvc\n    - name: kubeconfig\n      secret:\n        secretName: kubeconfig-secret\nEOF\n</code></pre> <p>If you have <code>tkn</code> installed, you can easily view the progress of the pipe run as follows:</p> <pre><code>tkn taskrun list -n petstore\nNAME                      STARTED          DURATION   STATUS\nrun-kuadrantctl-taskrun   12 seconds ago   ---        Running(Pending)\n</code></pre> <pre><code>tkn taskrun logs -n petstore -f\n\n\n[clone] Cloning into '/workspace/source'...\n[clone] Already on 'main'\n[clone] Your branch is up to date with 'origin/main'.\n\n[download-kuadrantctl]   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current\n[download-kuadrantctl]                                  Dload  Upload   Total   Spent    Left  Speed\n  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0\n100 21.4M  100 21.4M    0     0  6601k      0  0:00:03  0:00:03 --:--:-- 8756k\n\n[run-kuadrantctl] {\"kind\":\"AuthPolicy\",\"apiVersion\":\"kuadrant.io/v1beta2\",\"metadata\":{\"name\":\"petstore\",\"namespace\":\"petstore\",\"creationTimestamp\":null,\"labels\":{\"deployment\":\"petstore\",\"owner\":\"jbloggs\"}},\"spec\":{\"targetRef\":{\"group\":\"gateway.networking.k8s.io\",\"kind\":\"HTTPRoute\",\"name\":\"petstore\",\"namespace\":\"petstore\"},\"routeSelectors\":[{\"matches\":[{\"path\":{\"type\":\"Exact\",\"value\":\"/api/v3/store/admin\"},\"method\":\"GET\"}]}],\"rules\":{\"authentication\":{\"storeAdmin_api_key\":{\"credentials\":{\"customHeader\":{\"name\":\"api_key\"}},\"apiKey\":{\"selector\":{\"matchLabels\":{\"kuadrant.io/apikeys-by\":\"api_key\"}}},\"routeSelectors\":[{\"matches\":[{\"path\":{\"type\":\"Exact\",\"value\":\"/api/v3/store/admin\"},\"method\":\"GET\"}]}]}}}},\"status\":{}}\n[run-kuadrantctl] {\"kind\":\"RateLimitPolicy\",\"apiVersion\":\"kuadrant.io/v1beta2\",\"metadata\":{\"name\":\"petstore\",\"namespace\":\"petstore\",\"creationTimestamp\":null,\"labels\":{\"deployment\":\"petstore\",\"owner\":\"jbloggs\"}},\"spec\":{\"targetRef\":{\"group\":\"gateway.networking.k8s.io\",\"kind\":\"HTTPRoute\",\"name\":\"petstore\",\"namespace\":\"petstore\"},\"limits\":{\"getInventory\":{\"routeSelectors\":[{\"matches\":[{\"path\":{\"type\":\"Exact\",\"value\":\"/api/v3/store/inventory\"},\"method\":\"GET\"}]}],\"rates\":[{\"limit\":10,\"duration\":10,\"unit\":\"second\"}]},\"loginUser\":{\"routeSelectors\":[{\"matches\":[{\"path\":{\"type\":\"Exact\",\"value\":\"/api/v3/user/login\"},\"method\":\"GET\"}]}],\"rates\":[{\"limit\":2,\"duration\":10,\"unit\":\"second\"}]}}},\"status\":{}}\n[run-kuadrantctl] {\"kind\":\"HTTPRoute\",\"apiVersion\":\"gateway.networking.k8s.io/v1beta1\",\"metadata\":{\"name\":\"petstore\",\"namespace\":\"petstore\",\"creationTimestamp\":null,\"labels\":{\"deployment\":\"petstore\",\"owner\":\"jbloggs\"}},\"spec\":{\"parentRefs\":[{\"kind\":\"Gateway\",\"namespace\":\"kuadrant-multi-cluster-gateways\",\"name\":\"prod-web\"}],\"hostnames\":[\"petstore.${KUADRANT_ZONE_ROOT_DOMAIN}\"],\"rules\":[{\"matches\":[{\"path\":{\"type\":\"Exact\",\"value\":\"/api/v3/user/login\"},\"method\":\"GET\"}],\"backendRefs\":[{\"name\":\"petstore\",\"namespace\":\"petstore\",\"port\":8080}]},{\"matches\":[{\"path\":{\"type\":\"Exact\",\"value\":\"/api/v3/store/admin\"},\"method\":\"GET\"}],\"backendRefs\":[{\"name\":\"petstore\",\"namespace\":\"petstore\",\"port\":8080}]},{\"matches\":[{\"path\":{\"type\":\"Exact\",\"value\":\"/api/v3/store/inventory\"},\"method\":\"GET\"}],\"backendRefs\":[{\"name\":\"petstore\",\"namespace\":\"petstore\",\"port\":8080}]}]},\"status\":{\"parents\":null}}\n\n[apply-resources] authpolicy.kuadrant.io/petstore created\n[apply-resources] httproute.gateway.networking.k8s.io/petstore created\n[apply-resources] ratelimitpolicy.kuadrant.io/petstore created\n</code></pre>"},{"location":"kuadrantctl/doc/kuadrantctl-ci-cd/#step-6-cleanup","title":"Step 6 - Cleanup","text":"<p>Clean up your resources as follows:</p> <ol> <li>Remove the <code>petstore</code> namespace:</li> <li><code>kubectl delete ns petstore</code></li> <li>Remove the <code>ClusterRole</code> and <code>ClusterRoleBinding</code>:</li> <li><code>kubectl delete clusterrole kuadrant-ci-example-full-access</code></li> <li><code>kubectl delete clusterrolebinding kuadrant-ci-example-full-access-binding</code></li> </ol>"},{"location":"kuadrantctl/doc/openapi-apicurio/","title":"Using Apicurio Studio with Kuadrant OAS extensions","text":"<p>You can use OpenAPI extensions to define extra functionality beyond what is covered by the standard OpenAPI specification. Extensions typically start with the <code>x-</code> prefix, for example, <code>x-codegen</code>. Kuadrant OpenAPI extensions start with the <code>x-kuadrant</code> prefix, and allow you to configure Kuadrant policy information alongside your API.</p> <p>Apicurio Studio is a UI tool for visualizing and editing OpenAPI designs and definitions, which can visualize security details and custom extensions specified in your OpenAPI definition.</p>"},{"location":"kuadrantctl/doc/openapi-apicurio/#prerequisites","title":"Prerequisites","text":"<ul> <li>You have Apicurio Studio installed and running. For more information, see the Apicurio Studio documentation. </li> </ul>"},{"location":"kuadrantctl/doc/openapi-apicurio/#procedure","title":"Procedure","text":""},{"location":"kuadrantctl/doc/openapi-apicurio/#step-1-access-your-openapi-definition-in-apicurio-studio","title":"Step 1 - Access your OpenAPI definition in Apicurio Studio","text":"<p>Open or import your OpenAPI definition in Apicurio Studio. On the Design tab, select the VENDOR-EXTENSiONS section to add an extension. Alternatively, you can use the Source tab to edit the API definition directly.</p>"},{"location":"kuadrantctl/doc/openapi-apicurio/#step-2-add-kuadrant-extensions-to-your-api-definition","title":"Step 2 - Add Kuadrant extensions to your API definition","text":"<p>The following configuration and extension points are supported by Apicurio Studio and the <code>kuadrantctl</code> CLI:</p>"},{"location":"kuadrantctl/doc/openapi-apicurio/#generate-an-http-route","title":"Generate an HTTP route","text":"<p>To generate an HTTPRoute for the API, add the following <code>x-kuadrant</code> block to your API definition in Apicurio Studio, replacing values to match your API details and the location of your Gateway:</p> <pre><code>x-kuadrant:\n    route:\n        name: petstore\n        namespace: petstore\n        hostnames:\n\n            - 'petstore.example.com'\n        parentRefs:\n            -   name: prod-web\n                namespace: kuadrant-multi-cluster-gateways\n                kind: Gateway\n</code></pre> <p>For more details, see Generate Gateway API HTTPRoute object from OpenAPI 3.</p>"},{"location":"kuadrantctl/doc/openapi-apicurio/#generate-an-authpolicy","title":"Generate an AuthPolicy","text":"<p>To generate an AuthPolicy, add a <code>securityScheme</code> to the <code>components</code> block in your API definition. The following <code>securityScheme</code> requires that an API key header is set:</p> <pre><code>    securitySchemes:\n        api_key:\n            type: apiKey\n            name: api_key\n            in: header\n</code></pre> <p>Although <code>securityScheme</code> is not an OpenAPI extension, it is used by <code>kuadrantctl</code> like the other extensions mentioned in this document.</p> <p>When added, Apicurio Studio will display the following update in the SECURITY SCHEMES section:</p> <p></p> <p>For more details, see Generate Kuadrant AuthPolicy object from OpenAPI 3.</p>"},{"location":"kuadrantctl/doc/openapi-apicurio/#generate-a-ratelimitpolicy","title":"Generate a RateLimitPolicy","text":"<p>To generate a RateLimitPolicy for the API, add the following <code>x-kuadrant</code> block to a path in your API definition, replacing values to match your API details.</p> <pre><code>paths:\n    /:\n        x-kuadrant:\n            backendRefs:\n                -\n                    name: petstore\n                    namespace: petstore\n                    port: 8080\n            rate_limit:\n                rates:\n                    -\n                        limit: 10\n                        duration: 10\n                        unit: second\n</code></pre> <p>When added, Apicurio Studio  will display the following update in the VENDOR-EXTENSiONS section for that specific path:</p> <p></p> <p>For more details, see Generate Kuadrant RateLimitPolicy object from OpenAPI 3.</p>"},{"location":"kuadrantctl/doc/openapi-apicurio/#additional-resources","title":"Additional resources","text":"<ul> <li>OpenAPI 3.0.x Kuadrant Extensions in the kuadrantctl documentation.</li> <li>Apicurio Studio - Now with OpenAPI Vendor Extensions. </li> </ul>"},{"location":"kuadrantctl/doc/openapi-kuadrant-extensions/","title":"OpenAPI 3.0.x Kuadrant extensions","text":"<p>This reference information shows examples of how to add Kuadrant extensions at the root, path, or operation level in an OpenAPI 3.0.x definition. </p>"},{"location":"kuadrantctl/doc/openapi-kuadrant-extensions/#root-level-kuadrant-extension","title":"Root-level Kuadrant extension","text":"<p>You can add a Kuadrant extension at the root level of an OpenAPI definition. The following example shows an extension added for a <code>petstore</code> app:</p> <pre><code>x-kuadrant:\n  route:  ## HTTPRoute metadata\n    name: \"petstore\"\n    namespace: \"petstore\"\n    labels:  ## map[string]string\n      deployment: petstore\n    hostnames:  ## []gateway.networking.k8s.io/v1beta1.Hostname\n\n      - example.com\n    parentRefs:  ## []gateway.networking.k8s.io/v1beta1.ParentReference\n      - name: apiGateway\n        namespace: gateways\n</code></pre>"},{"location":"kuadrantctl/doc/openapi-kuadrant-extensions/#path-level-kuadrant-extension","title":"Path-level Kuadrant extension","text":"<p>You can add a Kuadrant extension at the path level of an OpenAPI definition. This configuration at the path level is the default when there is no operation-level configuration.  The following example shows an extension added for a <code>/cat</code> path:</p> <pre><code>paths:\n  /cat:\n    x-kuadrant:  ## Path-level Kuadrant extension\n      disable: true  ## Remove from the HTTPRoute. Optional. Default: false\n      pathMatchType: Exact ## Specifies how to match against the path value. Valid values: [Exact;PathPrefix]. Optional. Default: Exact\n      backendRefs:  ## Backend references to be included in the HTTPRoute. []gateway.networking.k8s.io/v1beta1.HTTPBackendRef. Optional.\n\n        - name: petstore\n          port: 80\n          namespace: petstore\n      rate_limit:  ## Rate limit configuration. Optional.\n        rates:   ## Kuadrant API []github.com/kuadrant/kuadrant-operator/api/v1beta2.Rate\n          - limit: 1\n            duration: 10\n            unit: second\n        counters:   ## Kuadrant API []github.com/kuadrant/kuadrant-operator/api/v1beta2.CountextSelector\n          - auth.identity.username\n        when:   ## Kuadrant API []github.com/kuadrant/kuadrant-operator/api/v1beta2.WhenCondition\n          - selector: metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid\n            operator: eq\n            value: alice\n</code></pre>"},{"location":"kuadrantctl/doc/openapi-kuadrant-extensions/#operation-level-kuadrant-extension","title":"Operation-level Kuadrant extension","text":"<p>You can add a Kuadrant extension at the operation level of an OpenAPI definition. This extension uses the same schema as the path-level Kuadrant extension. The following example shows an extension added for a <code>get</code> operation:</p> <pre><code>paths:\n  /cat:\n    get:\n      x-kuadrant:  ## Operation-level Kuadrant extension\n        disable: true  ## Remove from the HTTPRoute. Optional. Default: path level \"disable\" value.\n        pathMatchType: Exact ## Specifies how to match against the path value. Valid values: [Exact;PathPrefix]. Optional. Default: Exact.\n        backendRefs:  ## Backend references to be included in the HTTPRoute. Optional.\n\n          - name: petstore\n            port: 80\n            namespace: petstore\n        rate_limit:  ## Rate limit configuration. Optional.\n          rates:   ## Kuadrant API github.com/kuadrant/kuadrant-operator/api/v1beta2.Rate\n            - limit: 1\n              duration: 10\n              unit: second\n          counters:   ## Kuadrant API github.com/kuadrant/kuadrant-operator/api/v1beta2.CountextSelector\n            - auth.identity.username\n          when:   ## Kuadrant API github.com/kuadrant/kuadrant-operator/api/v1beta2.WhenCondition\n            - selector: metadata.filter_metadata.envoy\\.filters\\.http\\.ext_authz.identity.userid\n              operator: eq\n              value: alice\n</code></pre>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/","title":"Integrating Kuadrant OAS extensions with Red Hat OpenShift Dev Spaces","text":"<p>OpenAPI extensions enhance the standard OpenAPI specification by adding custom functionality. Kuadrant OpenAPI extensions are identified by the <code>x-kuadrant</code> prefix. You can use OpenAPI extensions to integrate Kuadrant policies directly into your API definitions.</p> <p>Red Hat OpenShift Dev Spaces provides a browser-based, cloud-native IDE that supports rapid and decentralized development in container-based environments. This tutorial demonstrates how to use OpenShift Dev Spaces to modify an OpenAPI definition by incorporating Kuadrant policies, and then use the <code>kuadrantctl</code> CLI to create Kubernetes resources for both Gateway API and Kuadrant.</p>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#prerequisites","title":"Prerequisites","text":"<ul> <li> <p>You must have access to one of the following Dev Spaces instances:</p> </li> <li> <p>A self-hosted OpenShift Dev Spaces instance.</p> </li> <li>An OpenShift Dev Spaces instance provided by the Red Hat Developer Sandbox.</li> </ul>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#procedure","title":"Procedure","text":""},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#step-1-setting-up-your-workspace","title":"Step 1 - Setting up your workspace","text":"<p>Create a workspace in Dev Spaces for your project as follows:</p> <ol> <li>Fork the following repository: https://github.com/Kuadrant/blank-petstore.</li> <li>In Dev Spaces, select Create Workspace, and enter the URL of your forked repository. For example: <code>https://github.com/&lt;your-username&gt;/blank-petstore.git</code>.</li> <li>Click Create &amp; Open.</li> </ol>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#step-2-configuring-vs-code-in-dev-spaces","title":"Step 2 - Configuring VS Code in Dev Spaces","text":"<p>For this tutorial, you will perform the following tasks:</p> <ul> <li>Install <code>kuadrantctl</code> in your workspace to demonstrate Kubernetes resource generation from your modified OpenAPI definition.</li> <li>Optional: Configure Git with your username and email to enable pushing changes back to your repository.</li> </ul>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#install-the-kuadrantctl-cli","title":"Install the kuadrantctl CLI","text":"<p>To install <code>kuadrantctl</code> in your Dev Spaces workspace, enter the following command:</p> <pre><code>curl -sL \"https://github.com/kuadrant/kuadrantctl/releases/download/v0.2.3/kuadrantctl-v0.2.3-linux-amd64.tar.gz\" | tar xz -C /home/user/.local/bin\n</code></pre> <p>This command installs <code>kuadrantctl</code> in <code>/home/user/.local/bin</code>, which is included in the container's <code>$PATH</code> by default.</p>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#optional-configuring-git","title":"Optional: Configuring Git","text":"<p>If you plan to push changes back to your repository, configure your Git username and email as follows:</p> <pre><code>git config --global user.email \"foo@example.com\"\ngit config --global user.name \"Foo Example\"\n</code></pre>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#step-3-adding-kuadrant-policies-to-your-openapi-definition","title":"Step 3 - Adding Kuadrant policies to your OpenAPI definition","text":"<p>After creating your workspace, Dev Spaces will launch VS Code loaded with your forked repository. Navigate to the <code>openapi.yaml</code> file in the sample app to begin modifications.</p>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#kuadrant-policies-overview","title":"Kuadrant policies overview","text":"<p>You will enhance your API definition by applying Kuadrant policies to the following endpoints:</p> <ul> <li><code>/pet/findByStatus</code></li> <li><code>/user/login</code></li> <li><code>/store/inventory</code></li> </ul> <p>In this tutorial, you will add Kuadrant policies to your API definition as follows:</p> <ul> <li>Generate an <code>HTTPRoute</code> to expose these three routes for an existing <code>Gateway</code>.</li> <li>Add API key authentication for the <code>/user/login</code> route, using a Kuadrant <code>AuthPolicy</code> and OAS <code>securitySchemes</code>.</li> <li>Add a Kuadrant <code>RateLimitPolicy</code> to the <code>/store/inventory</code> endpoint, to limit the amount of requests this endpoint can receive.</li> </ul>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#defining-a-gateway","title":"Defining a Gateway","text":"<p>Use the <code>x-kuadrant</code> extension in the root level to specify a <code>Gateway</code>. This information will be used to generate <code>HTTPRoute</code>s at the path level. For example:</p> <pre><code>x-kuadrant:\n  route:  ## HTTPRoute metadata\n    name: \"petstore\"\n    namespace: \"petstore\"\n    labels:  ## map[string]string\n      deployment: petstore\n    hostnames:  ## []gateway.networking.k8s.io/v1beta1.Hostname\n\n      - example.com\n    parentRefs:  ## []gateway.networking.k8s.io/v1beta1.ParentReference\n      - name: apiGateway\n        namespace: gateways\n</code></pre>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#specifying-httproutes-for-each-path","title":"Specifying HTTPRoutes for each path","text":"<p>For each path, add an <code>x-kuadrant</code> extension with <code>backendRefs</code> to link your routes to your paths as follows:</p> <pre><code>  /pet/findByStatus:\n    x-kuadrant:\n      backendRefs:\n\n      - name: petstore\n        namespace: petstore\n        port: 8080\n    get:\n      # ...\n</code></pre> <pre><code>  /user/login:\n    x-kuadrant:\n      backendRefs:\n\n      - name: petstore\n        namespace: petstore\n        port: 8080\n    get:\n      # ...\n</code></pre> <pre><code>  /store/inventory:\n    x-kuadrant:\n      backendRefs:\n\n      - name: petstore\n        namespace: petstore\n        port: 8080\n    get:\n      # ...\n</code></pre> <p>Note: The <code>x-kuadrant</code> extension at the path level applies to all HTTP methods defined in the path. For method-specific policies, move the extension inside the relevant HTTP method block, for example, <code>get</code> or <code>post</code>.</p>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#implementing-authpolicy-and-security-schemes","title":"Implementing AuthPolicy and security schemes","text":"<p>To secure the <code>/user/login</code> endpoint with API key authentication, use the following configuration:</p> <pre><code>  /user/login:\n    # ...\n    get:\n      security:\n\n      - api_key: []\n</code></pre> <pre><code>components:\n  schemas:\n    # ...\n  securitySchemes:\n    api_key:\n      type: apiKey\n      name: api_key\n      in: header\n</code></pre> <p>This configuration generates an <code>AuthPolicy</code> that references an API key stored in a labeled <code>Secret</code>:</p> <p><pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: petstore-api-key\n  namespace: petstore\n  labels:\n    authorino.kuadrant.io/managed-by: authorino\n    kuadrant.io/apikeys-by: api_key\nstringData:\n  api_key: secret\ntype: Opaque\n</code></pre> For simplicity, this example uses a simple, static API key for your app.</p>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#applying-a-ratelimitpolicy-to-an-endpoint","title":"Applying a RateLimitPolicy to an endpoint","text":"<p>To enforce rate limiting on the <code>/store/inventory</code> endpoint, add the following <code>x-kuadrant</code> extension:</p> <pre><code>  /store/inventory:\n    get:\n      # ...\n      x-kuadrant:\n        backendRefs:\n          # ...\n        rate_limit:\n          rates:\n\n          - limit: 10\n            duration: 10\n            unit: second\n</code></pre> <p>This limits to 10 requests every 10 seconds for the <code>/store/inventory</code> endpoint.</p>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#step-4-generate-kubernetes-resources-by-using-kuadrantctl","title":"Step 4 - Generate Kubernetes resources by using kuadrantctl","text":"<p>With your extensions in place, you can use <code>kuadrantctl</code> to generate the follollowing Kubernetes resources:</p> <ul> <li>An <code>HTTPRoute</code> for your <code>petstore</code> app for each of your endpoints.</li> <li>An <code>AuthPolicy</code> with a simple, static API key from a secret for the <code>/user/login</code> endpoint.</li> <li>A <code>RateLimitPolicy</code> with a rate limit of 10 requests every 10 seconds for the <code>/store/inventory</code> endpoint.</li> </ul> <p>In Dev Spaces, select \u2630 &gt; Terminal &gt; New Terminal, and run the following commands:</p>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#generate-an-httproute","title":"Generate an HTTPRoute","text":"<pre><code>kuadrantctl generate gatewayapi httproute --oas openapi.yaml\n</code></pre> <p>This command outputs the following <code>HTTPRoute</code>:</p> <pre><code>kind: HTTPRoute\napiVersion: gateway.networking.k8s.io/v1beta1\nmetadata:\n  name: petstore\n  namespace: petstore\n  creationTimestamp: null\n  labels:\n    deployment: petstore\nspec:\n  parentRefs:\n\n    - namespace: gateways\n      name: apiGateway\n  hostnames:\n    - example.com\n  rules:\n    - matches:\n        - path:\n            type: Exact\n            value: /api/v3/pet/findByStatus\n          method: GET\n      backendRefs:\n        - name: petstore\n          namespace: petstore\n          port: 8080\n    - matches:\n        - path:\n            type: Exact\n            value: /api/v3/store/inventory\n          method: GET\n      backendRefs:\n        - name: petstore\n          namespace: petstore\n          port: 8080\n    - matches:\n        - path:\n            type: Exact\n            value: /api/v3/user/login\n          method: GET\n      backendRefs:\n        - name: petstore\n          namespace: petstore\n          port: 8080\nstatus:\n  parents: null\n</code></pre>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#generate-an-authpolicy","title":"Generate an AuthPolicy","text":"<pre><code>kuadrantctl generate kuadrant authpolicy --oas openapi.yaml\n</code></pre> <p>This command outputs the following <code>AuthPolicy</code>:</p> <pre><code>apiVersion: kuadrant.io/v1beta2\nkind: AuthPolicy\nmetadata:\n  name: petstore\n  namespace: petstore\n  creationTimestamp: null\n  labels:\n    deployment: petstore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: petstore\n    namespace: petstore\n  routeSelectors:\n\n    - matches:\n        - path:\n            type: Exact\n            value: /api/v3/user/login\n          method: GET\n  rules:\n    authentication:\n      GETuserlogin_api_key:\n        credentials:\n          customHeader:\n            name: api_key\n        apiKey:\n          selector:\n            matchLabels:\n              kuadrant.io/apikeys-by: api_key\n        routeSelectors:\n          - matches:\n              - path:\n                  type: Exact\n                  value: /api/v3/user/login\n                method: GET\nstatus: {}\n</code></pre>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#generate-a-ratelimitpolicy","title":"Generate a RateLimitPolicy","text":"<pre><code>kuadrantctl generate kuadrant ratelimitpolicy --oas openapi.yaml\n</code></pre> <p>This command outputs the following <code>RateLimitPolicy</code>:</p> <pre><code>apiVersion: kuadrant.io/v1beta2\nkind: RateLimitPolicy\nmetadata:\n  name: petstore\n  namespace: petstore\n  creationTimestamp: null\n  labels:\n    deployment: petstore\nspec:\n  targetRef:\n    group: gateway.networking.k8s.io\n    kind: HTTPRoute\n    name: petstore\n    namespace: petstore\n  limits:\n    GETstoreinventory:\n      routeSelectors:\n\n        - matches:\n            - path:\n                type: Exact\n                value: /api/v3/store/inventory\n              method: GET\n      rates:\n        - limit: 10\n          duration: 10\n          unit: second\nstatus: {}\n</code></pre>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#step-5-applying-resources-to-the-app","title":"Step 5 - Applying resources to the app","text":"<p>Note: By default, the <code>oc</code> and <code>kubectl</code> commands in Dev Spaces target the cluster running Dev Spaces. If you want to apply resources to another cluster, you must log in with <code>oc</code> or <code>kubectl</code> to another cluster, and pass a different <code>--context</code> to these commands to apply resources to another cluster.</p> <p>You can now apply these policies to a running app by using <code>kubectl</code> or <code>oc</code>. If Dev Spaces is running on a cluster where Kuadrant is also installed, you can apply these resources as follows:</p> <pre><code>kuadrantctl generate gatewayapi httproute --oas openapi.yaml | kubectl apply -f -\nkuadrantctl generate kuadrant authpolicy --oas openapi.yaml | kubectl apply -f -\nkuadrantctl generate kuadrant ratelimitpolicy --oas openapi.yaml | kubectl apply -f -\n</code></pre> <p>Alternatively, you can use <code>kuadrantctl</code> as part of a CI/CD pipeline. For more details, see the kuadrantctl CI/CD guide.</p> <p>If you completed the optional Git configuration step, you can enter <code>git commit</code> to commit the these changes and push them to your fork.</p>"},{"location":"kuadrantctl/doc/openapi-openshift-dev-spaces/#additional-resources","title":"Additional resources","text":"<p>For more details, see the following documentation on using <code>x-kuadrant</code> OAS extensions with <code>kuadrantctl</code>:</p> <ul> <li>OpenAPI 3.0.x Kuadrant extensions</li> <li>Generate Gateway API HTTPRoutes with <code>kuadrantctl</code></li> <li>Generate Kuadrant AuthPolicy with <code>kuadrantctl</code></li> <li>Generate Kuadrant RateLimitPolicy with <code>kuadrantctl</code></li> <li>kuadrantctl CI/CD guide</li> </ul>"},{"location":"dns-operator/","title":"DNS Operator","text":"<p>The DNS Operator is a kubernetes based controller responsible for reconciling DNS Record custom resources. It interfaces with cloud DNS providers such as AWS and Google to bring the DNS zone into the state declared in these CRDs. One of the key use cases the DNS operator solves, is allowing complex DNS routing strategies such as Geo and Weighted to be expressed allowing you to leverage DNS as the first layer of traffic management. In order to make these strategies valuable, it also works across multiple clusters allowing you to use a shared domain name balance traffic based on your requirements.</p>"},{"location":"dns-operator/#getting-started","title":"Getting Started","text":""},{"location":"dns-operator/#pre-setup","title":"Pre Setup","text":""},{"location":"dns-operator/#add-dns-provider-configuration","title":"Add DNS provider configuration","text":"<p>NOTE: You can optionally skip this step but at least one DNS Provider Secret will need to be configured with valid credentials to use the DNS Operator.</p>"},{"location":"dns-operator/#aws-provider-route53","title":"AWS Provider (Route53)","text":"<p><pre><code>make local-setup-aws-clean local-setup-aws-generate AWS_ACCESS_KEY_ID=&lt;My AWS ACCESS KEY&gt; AWS_SECRET_ACCESS_KEY=&lt;My AWS Secret Access Key&gt;\n</code></pre> More details about the AWS provider can be found here</p>"},{"location":"dns-operator/#gcp-provider","title":"GCP Provider","text":"<p><pre><code>make local-setup-gcp-clean local-setup-gcp-generate GCP_GOOGLE_CREDENTIALS='&lt;My GCP Credentials.json&gt;' GCP_PROJECT_ID=&lt;My GCP PROJECT ID&gt;\n</code></pre> More details about the GCP provider can be found here</p>"},{"location":"dns-operator/#azure-provider","title":"AZURE Provider","text":"<pre><code>make local-setup-azure-clean local-setup-azure-generate KUADRANT_AZURE_CREDENTIALS='&lt;My Azure Credentials.json&gt;'\n</code></pre> <p>Info on generating service principal credentials here</p> <p>Get your resource group ID like so: <pre><code>az group show --resource-group &lt;resource group name&gt; | jq \".id\" -r\n</code></pre></p> <p>Also give traffic manager contributor role: <pre><code>az role assignment create --role \"Traffic Manager Contributor\" --assignee $EXTERNALDNS_SP_APP_ID --scope &lt;RESOURCE_GROUP_ID&gt;\n</code></pre></p> <p>Getting the zone ID can be achieved using the below command: <pre><code>az network dns zone show --name &lt;my domain name&gt; --resource-group &lt;my resource group&gt; --query \"{id:id,domain:name}\"\n</code></pre></p>"},{"location":"dns-operator/#running-controller-locally-default","title":"Running controller locally (default)","text":"<ol> <li> <p>Create local environment(creates kind cluster) <pre><code>make local-setup\n</code></pre></p> </li> <li> <p>Run your controller (this will run in the foreground, so switch to a new terminal if you want to leave it running):</p> </li> </ol> <pre><code>make run\n</code></pre>"},{"location":"dns-operator/#running-controller-on-the-cluster","title":"Running controller on the cluster","text":"<ol> <li> <p>Create local environment(creates kind cluster) <pre><code>make local-setup DEPLOY=true\n</code></pre></p> </li> <li> <p>Verify controller deployment <pre><code>kubectl logs -f deployments/dns-operator-controller-manager -n dns-operator-system\n</code></pre></p> </li> </ol>"},{"location":"dns-operator/#running-controller-on-existing-cluster","title":"Running controller on existing cluster","text":"<p>You\u2019ll need a Kubernetes cluster to run against. You can use KIND to get a local cluster for testing, or run against a remote cluster. Note: Your controller will automatically use the current context in your kubeconfig file (i.e. whatever cluster <code>kubectl cluster-info</code> shows).</p> <ol> <li> <p>Apply Operator manifests <pre><code>kustomize build config/default | kubectl apply -f -\n</code></pre></p> </li> <li> <p>Verify controller deployment <pre><code>kubectl logs -f deployments/dns-operator-controller-manager -n dns-operator-system\n</code></pre></p> </li> </ol>"},{"location":"dns-operator/#development","title":"Development","text":""},{"location":"dns-operator/#e2e-test-suite","title":"E2E Test Suite","text":"<p>The e2e test suite can be executed against any cluster running the DNS Operator with configuration added for any supported provider.</p> <pre><code>make test-e2e TEST_DNS_ZONE_DOMAIN_NAME=&lt;My domain name&gt; TEST_DNS_PROVIDER_SECRET_NAME=&lt;My provider secret name&gt; TEST_DNS_NAMESPACES=&lt;My test namespace(s)&gt;\n</code></pre> Environment Variable Description TEST_DNS_PROVIDER_SECRET_NAME Name of the provider secret to use. If using local-setup provider secrets zones, one of [dns-provider-credentials-aws; dns-provider-credentials-gcp;dns-provider-credentials-azure] TEST_DNS_ZONE_DOMAIN_NAME The Domain name to use in the test. Must be a zone accessible with the (TEST_DNS_PROVIDER_SECRET_NAME) credentials with the same domain name TEST_DNS_NAMESPACES The namespace(s) where the provider secret(s) can be found"},{"location":"dns-operator/#modifying-the-api-definitions","title":"Modifying the API definitions","text":"<p>If you are editing the API definitions, generate the manifests such as CRs or CRDs using:</p> <pre><code>make manifests\n</code></pre> <p>NOTE: Run <code>make --help</code> for more information on all potential <code>make</code> targets</p> <p>More information can be found via the Kubebuilder Documentation</p>"},{"location":"dns-operator/#logging","title":"Logging","text":"<p>Logs are following the general guidelines: </p> <ul> <li><code>logger.Info()</code> describe a high-level state of the resource such as creation, deletion and which reconciliation path was taken.  </li> <li><code>logger.Error()</code> describe only those errors that are not returned in the result of the reconciliation. If error is occurred there should be only one error message. </li> <li><code>logger.V(1).Info()</code> debug level logs to give information about every change or event caused by the resource as well as every update of the resource.</li> </ul> <p>The <code>--zap-devel</code> argument will enable debug level logs for the output. Otherwise, all <code>V()</code> logs are ignored.</p>"},{"location":"dns-operator/#common-metadata","title":"Common metadata","text":"<p>Not exhaustive list of metadata for DNSRecord controller:</p> <ul> <li><code>level</code> - logging level. Values are: <code>info</code>,<code>debug</code> or <code>error</code></li> <li><code>ts</code> - timestamp</li> <li><code>logger</code> - logger name</li> <li><code>msg</code></li> <li><code>controller</code> and <code>controllerKind</code> - controller name, and it's kind respectively to output the log</li> <li><code>DNSRecord</code> - name and namespace of the DNS Record CR that is being reconciled</li> <li><code>reconcileID</code></li> <li><code>ownerID</code> - ID the of owner of the DNS Record </li> <li><code>txtPrefix</code>/<code>txtSuffix</code> - prefix and suffix of the TXT record in provider. </li> <li><code>zoneEndpoints</code> - endpoints that exist in the provider</li> <li><code>specEdnoinds</code> - endpoints defined in the spec</li> <li><code>statusEndpoints</code> - endpoints that were processed previously</li> </ul> <p>Note that not all the metadata values are present at each of the logs statements. </p>"},{"location":"dns-operator/#examples","title":"Examples","text":"<p>To query logs locally you can use <code>jq</code>. For example: Retrieve logs by  <pre><code>kubectl get deployments -l app.kubernetes.io/part-of=dns-operator -A\n\nNAMESPACE             NAME                              READY \ndns-operator-system   dns-operator-controller-manager   1/1   \n</code></pre> And query them. For example: <pre><code>kubectl logs -l control-plane=dns-operator-controller-manager -n dns-operator-system --tail -1 | sed '/^{/!d' | jq 'select(.controller==\"dnsrecord\" and .level==\"info\")'\n</code></pre> or  <pre><code>kubectl logs -l control-plane=dns-operator-controller-manager -n dns-operator-system --tail -1 | sed '/^{/!d' | jq 'select(.controller==\"dnsrecord\" and .DNSRecord.name==\"test\" and .reconcileID==\"2be16b6d-b90f-430e-9996-8b5ec4855d53\")' | jq '.level, .msg, .zoneEndpoints, .specEndpoints, .statusEndpoints '\n</code></pre> You could use selector in the <code>jq</code> with <code>and</code>/<code>not</code>/<code>or</code> to restrict.</p>"},{"location":"dns-operator/#license","title":"License","text":"<p>Copyright 2024.</p> <p>Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at</p> <pre><code>http://www.apache.org/licenses/LICENSE-2.0\n</code></pre> <p>Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.</p> <p></p>"},{"location":"dns-operator/docs/RELEASE/","title":"RELEASE","text":""},{"location":"dns-operator/docs/RELEASE/#release","title":"Release","text":""},{"location":"dns-operator/docs/RELEASE/#new-majorminor-version","title":"New Major.Minor version","text":"<ol> <li>Create a new minor release branch from the HEAD of main: <pre><code>git checkout -b release-0.2\n</code></pre></li> <li>Run prepare release: <pre><code>make prepare-release IMG_TAG=release-0.2 VERSION=0.2.0-dev CHANNELS=alpha REPLACES_VERSION=0.1.0\n</code></pre></li> <li>Verify local changes, commit and push: <pre><code>git add .\ngit commit -m \"prepare-release: release-0.2\"\ngit push upstream release-0.2\n</code></pre></li> <li> <p>Verify that the build image workflow is triggered and completes for the new branch</p> </li> <li> <p>Do any final testing and bug fixing against the release branch, see Verify OLM Deployment</p> </li> <li> <p>Run prepare release for final version <pre><code>make prepare-release VERSION=0.2.0 CHANNELS=stable REPLACES_VERSION=0.1.0\n</code></pre></p> </li> <li>Verify local changes, commit, push and tag: <pre><code>git add .\ngit commit -m \"prepare-release: v0.2.0\"\ngit tag v0.2.0\ngit push upstream release-0.2\ngit push upstream v0.2.0\n</code></pre></li> <li> <p>Verify that the build image workflow is triggered and completes for the new tag</p> </li> <li> <p>Verify the new version can be installed from the catalog image, see Verify OLM Deployment</p> </li> <li> <p>Release to the community operator index catalogs.</p> </li> </ol>"},{"location":"dns-operator/docs/RELEASE/#new-patch-version","title":"New Patch version","text":"<ol> <li>Checkout minor release branch: <pre><code>git checkout release-0.2\n</code></pre></li> <li>Run prepare release: <pre><code>make prepare-release VERSION=0.2.1 CHANNELS=stable REPLACES_VERSION=0.2.0\n</code></pre></li> <li>Verify local changes, commit and push: <pre><code>git add .\ngit commit -m \"prepare-release: v0.2.1\"\ngit tag v0.2.1\ngit push upstream release-0.2\ngit push upstream v0.2.1\n</code></pre></li> <li> <p>Verify that the build image workflow is triggered and completes for the new tag</p> </li> <li> <p>Verify the new version can be installed from the catalog image, see Verify OLM Deployment</p> </li> <li> <p>Release to the community operator index catalogs.</p> </li> </ol>"},{"location":"dns-operator/docs/RELEASE/#verify-olm-deployment","title":"Verify OLM Deployment","text":"<ol> <li> <p>Deploy the OLM catalog image: <pre><code>make local-setup install-olm deploy-catalog\n</code></pre></p> </li> <li> <p>Wait for deployment: <pre><code>kubectl -n dns-operator-system wait --timeout=60s --for=condition=Available deployments --all\ndeployment.apps/dns-operator-controller-manager condition met\n</code></pre></p> </li> <li> <p>Check the logs: <pre><code>kubectl -n dns-operator-system logs -f deployment/dns-operator-controller-manager\n</code></pre></p> </li> <li> <p>Check the version: <pre><code>$ kubectl -n dns-operator-system get deployment dns-operator-controller-manager --show-labels\nNAME                              READY   UP-TO-DATE   AVAILABLE   AGE     LABELS\ndns-operator-controller-manager   1/1     1            1           5m42s   app.kubernetes.io/component=manager,app.kubernetes.io/created-by=dns-operator,\napp.kubernetes.io/instance=controller-manager,app.kubernetes.io/managed-by=kustomize,app.kubernetes.io/name=deployment,app.kubernetes.io/part-of=dns-operator,\ncontrol-plane=dns-operator-controller-manager,olm.deployment-spec-hash=1jPe8AuMpSKHh51nnDs4j25ZgoUrKhF45EP0Wa,olm.managed=true,olm.owner.kind=ClusterServiceVersion,\nolm.owner.namespace=dns-operator-system,olm.owner=dns-operator.v0.2.0-dev,operators.coreos.com/dns-operator.dns-operator-system=\n</code></pre></p> </li> </ol>"},{"location":"dns-operator/docs/RELEASE/#community-operator-index-catalogs","title":"Community Operator Index Catalogs","text":"<ul> <li>Operatorhub Community Operators</li> <li>Openshift Community Operators</li> </ul>"},{"location":"dns-operator/docs/provider/","title":"Configuring a DNS Provider","text":"<p>In order to be able to interact with supported DNS providers, Kuadrant needs a credential that it can use.</p>"},{"location":"dns-operator/docs/provider/#supported-providers","title":"Supported Providers","text":"<p>Kuadrant Supports the following DNS providers currently</p> <ul> <li>AWS Route 53 (AWS)</li> <li>Google Cloud DNS (GCP)</li> </ul>"},{"location":"dns-operator/docs/provider/#aws-route-53-provider","title":"AWS Route 53 Provider","text":"<p>Kuadrant expects a <code>Secret</code> with a credential. Below is an example for AWS Route 53. It is important to set the secret type to <code>aws</code>:</p> <pre><code>kubectl create secret generic my-aws-credentials \\\n  --namespace=kuadrant-dns-system \\\n  --type=kuadrant.io/aws \\\n  --from-literal=AWS_ACCESS_KEY_ID=XXXX \\\n  --from-literal=AWS_REGION=eu-west-1 \\\n  --from-literal=AWS_SECRET_ACCESS_KEY=XXX\n</code></pre> Key Example Value Description <code>AWS_REGION</code> <code>eu-west-1</code> AWS Region <code>AWS_ACCESS_KEY_ID</code> <code>XXXX</code> AWS Access Key ID (see note on permissions below) <code>AWS_SECRET_ACCESS_KEY</code> <code>XXXX</code> AWS Secret Access Key"},{"location":"dns-operator/docs/provider/#aws-iam-permissions-required","title":"AWS IAM Permissions Required","text":"<p>We have tested using the available policy <code>AmazonRoute53FullAccess</code> however it should also be possible to restrict the credential down to a particular zone. More info can be found in the AWS docs:</p> <p>https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/access-control-managing-permissions.html</p>"},{"location":"dns-operator/docs/provider/#google-cloud-dns-provider","title":"Google Cloud DNS Provider","text":"<p>Kuadant expects a secret with a credential. Below is an example for Google DNS. It is important to set the secret type to <code>gcp</code>:</p> <pre><code>kubectl create secret generic my-test-gcp-credentials \\\n  --namespace=kuadrant-dns-system \\\n  --type=kuadrant.io/gcp \\\n  --from-literal=PROJECT_ID=xxx \\\n  --from-file=GOOGLE=$HOME/.config/gcloud/application_default_credentials.json\n</code></pre> Env Var Example Value Description <code>GOOGLE</code> <code>{\"client_id\": \"***\",\"client_secret\": \"***\",\"refresh_token\": \"***\",\"type\": \"authorized_user\"}</code> This is the JSON created from either the credential created by the <code>gcloud</code> CLI, or the JSON from the Service account <code>PROJECT_ID</code> <code>my_project_id</code> ID to the Google project"},{"location":"dns-operator/docs/provider/#google-cloud-dns-access-permissions-required","title":"Google Cloud DNS Access permissions required","text":"<p>See: </p> <p>https://cloud.google.com/dns/docs/access-control#dns.admin</p>"},{"location":"dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/","title":"List of issues","text":"<ul> <li>Re-queue validation intermittently GH-36</li> <li>Re-queue DNS Record whenever a write to the Cloud Provider occurs GH-35</li> <li>Schedule removal of finalizer from DNS Records GH-38</li> <li>Record write attempts in status for current generation GH-34</li> </ul>"},{"location":"dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/#the-idea","title":"The idea","text":"<p>We now will constantly reconcile DNS records. The reasoning is that other controllers may override/change records in the DNS provider so there is a need to requeue the DNS Record from time to time even when no local changes are introduced.</p>"},{"location":"dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/#details","title":"Details","text":"<p>There are a few new fields on the DNS Record status:</p> <ul> <li>QueuedAt is a time when the DNS record was received for the reconciliation</li> <li>QueuedFor is a time when we expect a DNS record to be reconciled again</li> <li>ValidFor indicates the duration since the last reconciliation we consider data in the record to be valid</li> <li>WriteCounter represents a number of consecutive write attempts on the same generation of the record. It is being reset to 0 when the generation changes or there are no changes to write.</li> </ul> <p>There is an option to override the <code>ValidFor</code> and <code>DefaultRequeueTime</code> with <code>valid-for</code> and <code>requeue-time</code> flags respectively.</p> <p>The <code>DefaultRequeueTime</code> is the duration between successful validation and the next reconciliation to ensure that the record is still up-to-date.</p> <p>The <code>ValidFor</code> is used to determine if we should do a full reconciliation when we get the record. If the record is still valid we will only update finalizers and validate the record itself. It will not perform anything that involves a DNS provider.</p>"},{"location":"dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/#dns-record-normal-lifecycle","title":"DNS Record normal lifecycle","text":"<p>Once we enqueue the DNS record, controller will compile a list of changes to the DNS provider and will apply it. After this, the record is enqueued with the <code>validationRequeueTime</code> and the <code>Ready</code> condition will be marked as <code>false</code> with a message <code>Awaiting Validation</code>. When the record is received again and the controller ensures there are no changes needed (the ones applied are present in the DNS Provider) it sets the <code>Ready</code> condition to <code>true</code> and enqueues it with the <code>defaultRequeueTime</code>.</p> <p>At any time when the record is requeued we also set the <code>record.Status.QueuedFor</code> field with a timestamp for when we expect to receive the record again. And on every reconciliation we set the <code>record.Status.QueuedAt</code> to be the time of the reconciliation.</p> <p>Upon deletion, the process will be similar. The controller will determine the changes needed to the DNS provider and will apply them. The record will be requeued with the <code>validationRequeueTime</code>. Once we receive it back and ensure that there are no changes needed for the DNS provider we remove the finalizer from the record.</p> <p>The <code>validationRequeueTime</code> duration is randomized +/- 50%.</p>"},{"location":"dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/#when-things-go-south","title":"When things go south","text":"<p>If the record is received prematurely - the <code>ValidFor</code> + <code>QueuedAt</code> is more than the current time - we requeue it again for the <code>ValidFor</code> duration.</p> <p>When we encounter an error during the reconciliation we will not requeue the record and will put in an appropriate error message in the log and on the record. In order for it to reconcile again there must be a change to the DNS Record CR.</p> <p>It is possible for a user to mess with the timestamps field or the <code>ValidFor</code> field. Kubernetes will not let setting an invalid value to the timestamp fields. Once the timestamp fields are set manually it will trigger reconciliation since there is a change in the record CR. The only one that could impact the controller is the <code>QueuedAt</code> field and the controller will believe that to be the last time the record was reconciled. As for the <code>ValidFor</code>: since it is a simple string it is possible to set an incorrect value. If we fail to parse it we treat the <code>ValidFor</code> as 0. This means that the controller will believe that the information in the record is expired and will probe the DNS provider for an update. If a valid value is provided controller will obey it. Eventually, the controller will naturally enqueue the record and those values will be overridden.</p> <p>In case the controller fails to retain changes in the DNS Provider: write are successful, but the validation fails again and the <code>WriteCounter</code> reaches the <code>WriteCounterLimit</code> we give up on the reconciliation. The appropriate message will be put under the <code>Ready - false</code> condition as well as in the logs of the controller. The reconciliation will resume once the generation of the DNS Record is changed.</p>"},{"location":"dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/#metrics","title":"Metrics","text":"<p>There is a metric emitted from the controller: <code>dns_provider_write_counter</code>. It reflects the <code>WriteCounter</code> field in the status of the record.</p>"},{"location":"dns-operator/docs/reference/dnsrecord/","title":"The DNSRecord Custom Resource Definition (CRD)","text":"<ul> <li>DNSRecord</li> <li>DNSRecordSpec</li> <li>DNSRecordStatus</li> </ul>"},{"location":"dns-operator/docs/reference/dnsrecord/#dnsrecord","title":"DNSRecord","text":"Field Type Required Description <code>spec</code> DNSRecordSpec Yes The specification for DNSRecord custom resource <code>status</code> DNSRecordStatus No The status for the custom resource"},{"location":"dns-operator/docs/reference/dnsrecord/#dnsrecordspec","title":"DNSRecordSpec","text":"Field Type Required Description <code>ownerID</code> String No Unique string used to identify the owner of this record. If unset an ownerID will be generated based on the record UID <code>rootHost</code> String Yes Single root host of all endpoints in a DNSRecord <code>providerRef</code> ProviderRef Yes Reference to a DNS Provider Secret <code>endpoints</code> []ExternalDNS Endpoint No Endpoints to manage in the dns provider <code>healthCheck</code> HealthCheckSpec No Health check configuration"},{"location":"dns-operator/docs/reference/dnsrecord/#providerref","title":"ProviderRef","text":"Field Type Required Description <code>name</code> String Yes Name of a dns provider secret"},{"location":"dns-operator/docs/reference/dnsrecord/#healthcheckspec","title":"HealthCheckSpec","text":"Field Type Required Description <code>endpoint</code> String Yes Endpoint is the path to append to the host to reach the expected health check <code>port</code> Number Yes Port to connect to the host on <code>protocol</code> String Yes Protocol to use when connecting to the host, valid values are \"HTTP\" or \"HTTPS\" <code>failureThreshold</code> Number Yes FailureThreshold is a limit of consecutive failures that must occur for a host to be considered unhealthy"},{"location":"dns-operator/docs/reference/dnsrecord/#dnsrecordstatus","title":"DNSRecordStatus","text":"Field Type Description <code>observedGeneration</code> String Number of the last observed generation of the resource. Use it to check if the status info is up to date with latest resource spec <code>conditions</code> []Kubernetes meta/v1.Condition List of conditions that define the status of the resource <code>queuedAt</code> Kubernetes meta/v1.Time QueuedAt is a time when DNS record was received for the reconciliation <code>queuedFor</code> Kubernetes meta/v1.Time QueuedFor is a time when we expect a DNS record to be reconciled again <code>validFor</code> String ValidFor indicates duration since the last reconciliation we consider data in the record to be valid <code>writeCounter</code> Number WriteCounter represent a number of consecutive write attempts on the same generation of the record <code>endpoints</code> []ExternalDNS Endpoint Endpoints are the last endpoints that were successfully published by the provider <code>healthCheck</code> HealthCheckStatus Health check status <code>ownerID</code> String Unique string used to identify the owner of this record"},{"location":"dns-operator/docs/reference/dnsrecord/#healthcheckstatus","title":"HealthCheckStatus","text":"Field Type Description <code>conditions</code> []Kubernetes meta/v1.Condition List of conditions that define that status of the health checks <code>probes</code> []HealthCheckStatusProbe Health check Probe status"},{"location":"dns-operator/docs/reference/dnsrecord/#healthcheckstatusprobe","title":"HealthCheckStatusProbe","text":"Field Type Description <code>id</code> String The health check id <code>ipAddress</code> String The ip address being monitored <code>host</code> String The host being monitored <code>synced</code> Boolean Synced <code>conditions</code> []Kubernetes meta/v1.Condition List of conditions that define that status of the probe"}]}
\ No newline at end of file
diff --git a/0.10.0/sitemap.xml b/0.10.0/sitemap.xml
deleted file mode 100644
index c50f8033e..000000000
--- a/0.10.0/sitemap.xml
+++ /dev/null
@@ -1,613 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/getting-started-multi-cluster/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/getting-started-single-cluster/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/auth/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/development/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/dns/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/dnshealthchecks/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/logging/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/rate-limiting/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/tls/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/install/install-kubernetes/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/install/install-openshift/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/observability/examples/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/observability/metrics/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/observability/tracing/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/proposals/rlp-target-gateway-resource/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/authpolicy/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/dnspolicy/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/kuadrant/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/ratelimitpolicy/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/route-selectors/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/reference/tlspolicy/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/gateway-dns/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/gateway-tls/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/secure-protect-connect/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/doc/user-guides/simple-rl-for-app-developers/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrant-operator/examples/alerts/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/architecture/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/code_of_conduct/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/contributing/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/features/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/getting-started/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/terminology/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/anonymous-access/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/api-key-authentication/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/authenticated-rate-limiting-envoy-dynamic-metadata/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/authzed/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/caching/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/deny-with-redirect-to-login/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/edge-authentication-architecture-festival-wristbands/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/envoy-jwt-authn-and-authorino/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/external-metadata/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/hello-world/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/host-override/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/http-basic-authentication/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/injecting-data/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/json-pattern-matching-authorization/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/keycloak-authorization-services/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/kubernetes-subjectaccessreview/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/kubernetes-tokenreview/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/mtls-authentication/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/oauth2-token-introspection/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/observability/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/oidc-jwt-authentication/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/oidc-rbac/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/oidc-user-info/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/opa-authorization/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/passing-credentials/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/resource-level-authorization-uma/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/sharding/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/token-normalization/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino/docs/user-guides/validating-webhook/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/authorino-operator/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/doc/how-it-works/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/doc/topologies/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/doc/migrations/conditions/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/doc/server/configuration/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/limitador/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/limitador-server/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/limitador-server/kubernetes/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/limitador-server/sandbox/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/limitador-server/sandbox/redis-otel/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador/limitador-server/sandbox/redis-tls/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador-operator/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador-operator/doc/development/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador-operator/doc/logging/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador-operator/doc/rate-limit-headers/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador-operator/doc/resource-requirements/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador-operator/doc/storage/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/limitador-operator/doc/tracing/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/docs/design/architectural-overview-v1/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/docs/design/architectural-overview/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/docs/design/modular_installation/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0001-rlp-v2/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0002-well-known-attributes/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0003-dns-policy/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0004-policy-status/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0005-single-cluster-dnspolicy/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0006-kuadrant_sub_components_configurations/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0007-policy-sync-v1/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0008-kuadrant-release-process/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0009-defaults-and-overrides/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0010-gateway-api-metrics-exporter/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0011-policy-machinery/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/dns-policy-api-changes/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/architecture/rfcs/0003-dns-policy-assets/DNSRecordStructure/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/api-quickstart/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/RELEASE/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/development/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/generate-gateway-api-httproute/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/generate-kuadrant-auth-policy/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/generate-kuadrant-rate-limit-policy/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/kuadrantctl-ci-cd/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/openapi-apicurio/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/openapi-kuadrant-extensions/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/kuadrantctl/doc/openapi-openshift-dev-spaces/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/dns-operator/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/dns-operator/docs/RELEASE/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/dns-operator/docs/provider/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/dns-operator/docs/RFC/distributed-dns/dnsrecord-lifecycle/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://docs.kuadrant.io/0.10.0/dns-operator/docs/reference/dnsrecord/</loc>
-         <lastmod>2024-09-26</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-</urlset>
\ No newline at end of file
diff --git a/0.10.0/sitemap.xml.gz b/0.10.0/sitemap.xml.gz
deleted file mode 100644
index 05251a82b2a6cfde40216c4bd5b5b80a71c875a5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1525
zcmV<R1q%8fiwFo(V)bSM|8r?{Wo=<_E_iKh0Nq?mZyPrdzUNmMzK<lkX&M)fgQ87N
zMGr}HHb&%Vml2n<CAnHFzrMrO!z;(`AwYp02@tdoO8UMfIWNxe_WeWSFE$jD<M8hC
zYPPt%pkUa#P`$hS^7lu0d-?wE)omAjqI@BZLwa{v=iL4}pZ9$~OD<D`ZJKec=E>A@
zlIHu1^Tq7u^6u4zyvh&kj)vE*XLDD6CCSfNHfgr*&_)b-=2*UVwU{mDxAW3!{3T4e
zVS9JIxPA?b8@PTWP4?GD%}kA<qE)1S?kqaLy`7J)?9j}QaDD_>MLEm!fs`?3ve0xs
zJ21XWnW7%pNlrXXANS!Ba7z(0tAZ*m=h)?18)i!z^4vBQvO4G?DTG`T`do_uHEVV7
zJy(?o6K$~Nh`_tXWrg6gS2s*t5Y^-T;S<)~l477t>Y2z*nZa(QPFC_VQQY9td6&0y
zdcdaj`nuzkMMF6{qnt#JXcS7NHgd}eMK(p>f*6`&bV4O^w#O|*O58<5>huJyD2i7^
zgC*CpcV?@XgV-9{DID(WWl&6y!Sc}F6_GnJq7r#Bax>{ABKDNdzUV}4K-D=bdb`Lc
zSaAewTM!p60R{`L$1E2cpde;Ck-lzv%2B*hXRrh@q95}uF6+6`>z(xJ*FFzjxqd5M
zDlNh{%^VK~fkIFHIU4&hxDTWq+n)tDg>L4UMk3Qi0x?UoC@3%-LiyZ>K9vM+f0U+b
zMy`0G`o;UvrAALNPZ)a9DjZ#44G>EUH8?Sv+Ld`JQ&bIT!<O!ObuXgCc2gE5-{B59
zx@9-*knR)EE5b53^bF}IONnZ5i<)ob#B;S(gL$kKHDboVVcT#gj*Bsrl#*y2tZ54)
z@62(~N#)eR9It@^g$;{awhh=g0}W-gm{BdwZ;C|I7`s8S7!>KRF?LH~yNg*wvMv^P
zBr}M_bvmaD*@~V_dl*}Eu%eXR20irArM$#ob&9y%+#do>CBQU<oAfyaCyX9M-v{X#
z)q<=h?-_cIUZ*gtIf*~Kp%~><Cj<E^EHQ~nJOlmj!dH=8Mcb>L5?_-D;TCh5-q2tk
zwB<oqebd`DVqqH3xIU!<B`?4krRM)*k`JVAS%%)u4T!XH)N7}dc}+nvl_vXi4nmE~
zz3W|ffD1WtYKxT9O6MdONF@Vj&C!_DKDY{(xJ08D{cypBl}<yRTRa2p-eM~2j$p(w
zE;9nXPK|y@;{#t-<eu0nU8B>aOf^QUHRiHYdx2wvUh@pu2z+r$$|UJ&Su?K{&`?m8
zG{kq&>VQ}>0c!5S<r4Imaxu&)=FDwbSaPHWapS5u2#aCa)VkfF67a=9rdWWlT-C*i
z3%y6|s^;SH2=<R#BW4X{M*jgnVX#YnP>sDT1ts82{tReLIwkTEyCSnhVd?P;*e72J
z`vUIAGytdx?WB_|U!rhuOXYt$7paUNeJqk3U`6V1PrhF9Bnxx!JjLU5RT$quKP*(1
zXg+MN&W4LZA_AoI81MH5)>98@jA_J`&{!-MS5Qh|H`mHwUqer&Ha~D50P`-HcG7E)
z&$0Na)E2?i3;Ldg{(29)B-iFn+k^l4$+kkEpxpRbB5&Z(@;-ITd&5o3p_ml+Cm{!I
z{qxIlbZvvtqvQ_o-yVBK%sfw+hN7p5rxia(<OVFQu=9CWqI<}XQbyxyaopUYWJvFK
z-T-=NIZnEy?pZQdhq=)V`L`5R$*f0(H}u8s|1|4uz?4W_xIg~-{D}-l`#HyM>Qz+o
z<i-0m>!C7c`h|)ndmSK)kNN4tpC5kv{6P<3Rh#G?KvxuK2nUTNd-;)Js}F@djuykP
zJBF4`K3=9Viq&Z&Gdc$&I?C#SUbc8EGeO>_i;ndnKMtT$7ZK95otKwL9Cz9)`vE{|
zangCw#h97?I?M^mAqqEnP5V7$QBNCjpmaUvkH62YOZym`9rnYKcO0x;5%DWBTjNO+
brIUT;c0~Sv_``?z3U~hk)yovq&s+ci*45}w

diff --git a/versions.json b/versions.json
index c5cf82518..c92caf214 100644
--- a/versions.json
+++ b/versions.json
@@ -10,10 +10,5 @@
     "aliases": [
       "latest"
     ]
-  },
-  {
-    "version": "0.10.0",
-    "title": "0.10.0",
-    "aliases": []
   }
 ]